{
  "kind": "ILLUSTRATIVE_COMPLETED_READING_RECORD",
  "title": "Completed reading example: discovery accepted, normalization denied",
  "scope": "The plan, review dispositions and owner handoff are illustrative. The three fact objects are copied exactly from already-public source/result files. This record performs no Helper command, target validation, registration, provider call or new customer execution. The same historical request_id appears in both result excerpts; do not reuse it or attempt to replay the excerpts.",
  "case_id": "helper-preparation",
  "plan": {
    "goal": "Explain what the source document declares, what local discovery accepted and why the retained normalization result cannot advance to registration or execution.",
    "inputs": [
      "Published status-document.json",
      "Published status-discovery.result-excerpt.json",
      "Published status-normalize.result-excerpt.json",
      "Worked examples field/check/acceptance reference"
    ],
    "owner": "Illustrative document-author/reviewer role. A real person, time and approval are not assigned in this teaching record.",
    "note": "The source describes input service:string and output service:string plus healthy:boolean. It is not an actual status.read request/reply or a complete R2 envelope. No new syntax or product check is claimed."
  },
  "retained_facts": [
    {
      "id": "RF-01",
      "title": "Source document: declared status.read shapes",
      "source_url": "/docs/downloads/status-document.json",
      "value": {
        "document_kind": "CUSTOM_API",
        "protocol_revision": "1",
        "operations": {
          "status.read": {
            "input_schema": {
              "type": "object",
              "properties": {
                "service": {
                  "type": "string"
                }
              },
              "required": [
                "service"
              ]
            },
            "output_schema": {
              "type": "object",
              "properties": {
                "service": {
                  "type": "string"
                },
                "healthy": {
                  "type": "boolean"
                }
              },
              "required": [
                "service",
                "healthy"
              ]
            }
          }
        }
      }
    },
    {
      "id": "RF-02",
      "title": "Retained local DISCOVER result",
      "source_url": "/docs/downloads/status-discovery.result-excerpt.json",
      "value": {
        "operation": "DISCOVER",
        "request_id": "example-status-discover-001",
        "status": "PASSED",
        "reason": "NONE",
        "lifecycle_stage": "DISCOVERED"
      }
    },
    {
      "id": "RF-03",
      "title": "Retained local NORMALIZE result",
      "source_url": "/docs/downloads/status-normalize.result-excerpt.json",
      "value": {
        "operation": "NORMALIZE",
        "request_id": "example-status-discover-001",
        "status": "DENIED",
        "reason": "CONTRACT_INCOMPATIBLE",
        "lifecycle_stage": null
      }
    }
  ],
  "steps": [
    {
      "title": "Identify the source and its scope",
      "observation": "RF-01 declares CUSTOM_API, protocol_revision \"1\" and status.read with primitive input/output properties and required lists. These are schema declarations, not a called service or observed healthy value.",
      "evidence_refs": [
        "RF-01"
      ],
      "disposition": "MET",
      "next_action": "Illustrative review: retain the declared shapes and obtain exact target references separately; do not paste contract-reference keys into this source."
    },
    {
      "title": "Read the discovery result",
      "observation": "RF-02 records operation DISCOVER, status PASSED, reason NONE and lifecycle_stage DISCOVERED. The public reference limits this to local source discovery using an internal envelope; exact binary build identity is unproven.",
      "evidence_refs": [
        "RF-02"
      ],
      "disposition": "MET",
      "next_action": "Read normalization before describing the integration result. Do not turn source acceptance into target compatibility, registration or execution proof."
    },
    {
      "title": "Preserve the normalization denial",
      "observation": "RF-03 records operation NORMALIZE, status DENIED, reason CONTRACT_INCOMPATIBLE and lifecycle_stage null. Its request_id is the same historical value as RF-02: example-status-discover-001. Neither excerpt establishes a successful normalized target.",
      "evidence_refs": [
        "RF-02",
        "RF-03"
      ],
      "disposition": "BLOCKED",
      "next_action": "Keep the denial attached to the original record. Ask the supplier/interface owner for the exact supported target and complete request package; do not invent a replacement target or rerun the historical request ID."
    },
    {
      "title": "Separate product facts from the review conclusion",
      "observation": "Illustrative review conclusion: the reading goal is met because the source and the first blocked stage are understood. Product normalization remains DENIED. Registration, connected execution, human acceptance and customer readiness have not been established by these excerpts.",
      "evidence_refs": [
        "RF-01",
        "RF-02",
        "RF-03"
      ],
      "disposition": "MET",
      "next_action": "Keep manual worksheet labels separate from literal product status. Leave new-run identifiers, timestamps, costs and approval fields empty."
    },
    {
      "title": "Close the reading and prepare the owner handoff",
      "observation": "The illustrative record retains the public source and two result references. This reading route created no product service or cloud resource and changed no customer configuration. No stored/effective runtime state or billing was observed.",
      "evidence_refs": [
        "RF-01",
        "RF-02",
        "RF-03"
      ],
      "disposition": "MET",
      "next_action": "Retain review notes under the chosen document-retention policy. Hand off the supported target/package question; no support message or product command is sent by this example."
    }
  ],
  "closeout": {
    "record_state": "COMPLETED_ILLUSTRATIVE_READING_RECORD",
    "product_state": "Last retained stage: NORMALIZE / DENIED / CONTRACT_INCOMPATIBLE / lifecycle_stage null. DISCOVER / PASSED / DISCOVERED is the earlier bounded source result.",
    "remaining": [
      "Exact historical local binary build identity is unproven.",
      "A complete approved customer request envelope, supported target/adapter revisions and installation route are not supplied by these downloads.",
      "Target normalization, registration and connected execution remain unproven by this record.",
      "No new product acceptance, runtime effect, duration or cost observation is available."
    ],
    "next_owner": "Supplier/interface owner for the standard package; document owner for retained notes.",
    "next_action": "Request the versioned standard deliverable with exact target references and a supported installation/preparation route. Keep the two original result excerpts with that question.",
    "resume_when": "Only a separately authorized product preparation may resume after the matching complete package, supported target and required access are supplied. The completed reading itself needs no further product action.",
    "reviewer": null,
    "reviewed_at": null
  }
}