{
  "schemaVersion": "1.0.0",
  "updatedAt": "2026-08-31T07:45:00Z",
  "status": "implemented_tested_and_public",
  "pattern": {
    "name": "The artifact is the API",
    "summary": "Every stage receives a bounded, serializable evidence object and returns a schema-validated artifact. Later stages consume those artifacts explicitly; no specialist inherits hidden chat history.",
    "currentImplementation": "Deterministic Python orchestrates calculation and release authority. GLM-5.3 supplies bounded specialist judgment through OpenRouter."
  },
  "model": {
    "configuredSlug": "z-ai/glm-5.3",
    "displayName": "GLM-5.3",
    "router": "OpenRouter",
    "temperature": 0,
    "responseFormat": "strict JSON Schema",
    "maximumOutputTokensPerAttempt": 3000,
    "retryPolicy": "One retry after a rejected or failed attempt; both attempts leave transport receipts.",
    "identityAuthority": "The local transport overwrites model, role, and timestamp after schema validation. Promotion then requires every review model to match the run manifest exactly."
  },
  "executionGraph": [
    {
      "order": 1,
      "stage": "registration_and_compute",
      "owner": "deterministic_python",
      "inputs": [
        "versioned series registration",
        "hashed source data",
        "fixed seed",
        "versioned analysis code"
      ],
      "outputs": [
        "research-memo.json",
        "provenance.json",
        "analysis.json",
        "article.md",
        "figures",
        "artifact inventory",
        "mechanical checks"
      ],
      "authority": "Owns the question, estimand, official numbers, charts, and source record."
    },
    {
      "order": 2,
      "stage": "four_specialist_reviews",
      "owner": "glm_5_3_via_openrouter",
      "inputs": [
        "locked research memo",
        "provenance",
        "analysis",
        "article candidate",
        "artifact inventory",
        "mechanical checks"
      ],
      "outputs": [
        "researcher ReviewArtifact",
        "statistician ReviewArtifact",
        "adversarial_reviewer ReviewArtifact",
        "citation_checker ReviewArtifact"
      ],
      "authority": "May pass, request revision, or block within a named specialty. May not change the official calculation or registration.",
      "actualExecution": "Sequential calls with fresh two-message request envelopes; shared evidence creates correlation and role separation is not independent peer review."
    },
    {
      "order": 3,
      "stage": "editor_review",
      "owner": "glm_5_3_via_openrouter",
      "inputs": [
        "the complete stage-2 evidence",
        "four specialist ReviewArtifacts",
        "computed blocking-finding count"
      ],
      "outputs": [
        "editor ReviewArtifact"
      ],
      "authority": "May recommend pass, revise, or block. May not waive a mechanical failure or invent replacement evidence."
    },
    {
      "order": 4,
      "stage": "publication_decision",
      "owner": "deterministic_python",
      "inputs": [
        "mechanical checks",
        "five ReviewArtifacts"
      ],
      "outputs": [
        "publication-decision.json",
        "manifest.json"
      ],
      "authority": "Passes only when every check is true, every specialist decision passes, and no blocking finding survives."
    },
    {
      "order": 5,
      "stage": "promotion",
      "owner": "deterministic_python_plus_human_release_authority",
      "inputs": [
        "publication-ready run directory",
        "hash inventory",
        "configured model map",
        "review model identities",
        "article and figure contracts"
      ],
      "outputs": [
        "versioned public article record",
        "public run ledger entry"
      ],
      "authority": "Re-verifies the bundle and may refuse promotion. A model cannot publish itself or bypass external-release consent."
    }
  ],
  "handoffRules": {
    "hiddenConversationStateBetweenSpecialists": false,
    "editorReceivesPriorSpecialistArtifactsExplicitly": true,
    "evidenceTreatedAsUntrustedData": true,
    "outputShapeValidatedBeforeAcceptance": true,
    "schemaValidityProvesTruth": false,
    "failedAttemptsRecorded": true,
    "roleModelAndTimeSelfReportedByModel": false,
    "publicationRequiresAllMechanicalChecks": true,
    "publicationRequiresFivePassingRoles": true,
    "deterministicOrOfflineReviewersAcceptedByOnlinePromotion": false,
    "reviewModelsMustMatchManifest": true,
    "modelMayWaiveReleaseConsent": false
  },
  "roles": [
    {
      "role": "researcher",
      "label": "Researcher specialist",
      "purpose": "Audit the executed study against the locked registration and required artifacts.",
      "sourcePath": "research/prompts/researcher.md",
      "publicHref": "/methods/prompts/researcher.md",
      "sha256": "999d5b5c83f44ffc53df3cbe3ea311cc7f04b1d6b4edb1fe1d1fac8fa3f0b1b7",
      "outputSchema": "ReviewArtifact"
    },
    {
      "role": "statistician",
      "label": "Statistician specialist",
      "purpose": "Attack leakage, target construction, uncertainty, attrition, and estimand scope.",
      "sourcePath": "research/prompts/statistician.md",
      "publicHref": "/methods/prompts/statistician.md",
      "sha256": "9f5cb460e63bc2b8338f39a4ad636248903cdfead8f98426a3f2d2a8c982d9e7",
      "outputSchema": "ReviewArtifact"
    },
    {
      "role": "adversarial_reviewer",
      "label": "Adversarial specialist",
      "purpose": "Try to falsify the central claim and identify likely reader misuse.",
      "sourcePath": "research/prompts/adversarial-reviewer.md",
      "publicHref": "/methods/prompts/adversarial-reviewer.md",
      "sha256": "41792861e1ced198461bf1f5687bbf90c4a0d9bae20f5faa30b15c685b03ad7e",
      "outputSchema": "ReviewArtifact"
    },
    {
      "role": "citation_checker",
      "label": "Citation and provenance specialist",
      "purpose": "Trace claims, artifacts, sources, licenses, and rights language.",
      "sourcePath": "research/prompts/citation-checker.md",
      "publicHref": "/methods/prompts/citation-checker.md",
      "sha256": "9ed9ecd6fd01d7ba978b390cf64d964501e660df27761b255ecafda21541c9d1",
      "outputSchema": "ReviewArtifact"
    },
    {
      "role": "editor",
      "label": "Editor specialist",
      "purpose": "Integrate the four specialist records without waiving mechanical failures.",
      "sourcePath": "research/prompts/editor-publisher.md",
      "publicHref": "/methods/prompts/editor-publisher.md",
      "sha256": "845ec62b3c963bf286fd37defaa169a21c848fc13b89f8aa02ff82b61da3d41d",
      "outputSchema": "ReviewArtifact"
    }
  ],
  "schemas": [
    {
      "name": "OpenRouterCallRecord",
      "sourcePath": "research/schemas/OpenRouterCallRecord.schema.json",
      "publicHref": "/methods/schemas/OpenRouterCallRecord.schema.json",
      "sha256": "98cea42fdf89599e5c04fecfc3164c209c237ba7a29180f9a73cc7324d42de65"
    },
    {
      "name": "PublicationDecision",
      "sourcePath": "research/schemas/PublicationDecision.schema.json",
      "publicHref": "/methods/schemas/PublicationDecision.schema.json",
      "sha256": "1b14d17ddab6d04886443a12f60d94b5baafa541a0856f97a17fa245cfd5f1f4"
    },
    {
      "name": "ResearchMemo",
      "sourcePath": "research/schemas/ResearchMemo.schema.json",
      "publicHref": "/methods/schemas/ResearchMemo.schema.json",
      "sha256": "950a60c1f111f4df0288aca6594c1bde6660462f6c0a3d0dff7de07fc4a7ee17"
    },
    {
      "name": "ReviewArtifact",
      "sourcePath": "research/schemas/ReviewArtifact.schema.json",
      "publicHref": "/methods/schemas/ReviewArtifact.schema.json",
      "sha256": "21bd048ad91b7e8c2278ec14253db7fa9d47ddd7cb570e07df947b661c24a333"
    }
  ],
  "discoveredDefect": {
    "id": "GATE-002",
    "discoveredAt": "2026-08-31T07:45:00Z",
    "status": "fixed_before_next_promotion",
    "affectedPath": "touchdown-regression promotion",
    "rootCause": "Two series duplicated the online-model check. The rookie path rejected every deterministic/* model, while the touchdown path rejected only the exact string deterministic/offline.",
    "potentialImpact": "A fully passing touchdown bundle whose review artifacts used another deterministic/* label could have satisfied the old model-origin check. All other article, hash, role, finding, and mechanical checks still applied.",
    "observedMisrepresentation": false,
    "publicRunAudit": {
      "onlineRunId": "2026-08-31T011519Z-touchdown-regression-v1",
      "configuredModels": {
        "adversarial_reviewer": "z-ai/glm-5.3",
        "citation_checker": "z-ai/glm-5.3",
        "editor": "z-ai/glm-5.3",
        "researcher": "z-ai/glm-5.3",
        "statistician": "z-ai/glm-5.3"
      },
      "reviewModels": {
        "researcher": "z-ai/glm-5.3",
        "statistician": "z-ai/glm-5.3",
        "adversarial_reviewer": "z-ai/glm-5.3",
        "citation_checker": "z-ai/glm-5.3",
        "editor": "z-ai/glm-5.3"
      },
      "allFiveAreGlm53": true,
      "legacyDeterministicSnapshots": 2,
      "disclosure": "2 earlier deterministic snapshots remain public and are explicitly labeled deterministic/offline; they predate and do not claim the current GLM-5.3 online-review contract."
    },
    "remediation": [
      "Both series now call one shared model-origin verifier.",
      "Every deterministic/* prefix is rejected.",
      "The five review model identities must equal the five-role model map frozen in the manifest.",
      "Regression tests cover multiple deterministic labels and review-to-manifest drift for both series."
    ]
  },
  "limitations": [
    "All five online specialists currently use one model family, so their judgments are correlated.",
    "Temperature zero improves repeatability but does not make GLM-5.3 deterministic or correct.",
    "Strict JSON Schema validates structure, not factual accuracy or reasoning quality.",
    "The four first-pass specialist calls are sequential today; this is auditable but not latency-optimal.",
    "The Python orchestrator chooses from registered series; it is not currently a free-form LLM planner.",
    "The editor role recommends a disposition. Deterministic code and human release authority control publication."
  ],
  "sourceIntegrity": [
    {
      "path": "research/src/fourth_down_labs/models.py",
      "sha256": "5aa316d7184f60b12bacb7b9bc153a978684593f132ec33afc6a40be06530c74"
    },
    {
      "path": "research/src/fourth_down_labs/openrouter.py",
      "sha256": "db6ecd6324c34ee808ad79080cc0d9cabdc03b0ddeef0fbc10133993898343ac"
    },
    {
      "path": "research/src/fourth_down_labs/pipeline.py",
      "sha256": "5700ded737e963149073896307245bf6bf57d45682864fa4663b7e0d0c8df3f2"
    },
    {
      "path": "research/src/fourth_down_labs/promotion.py",
      "sha256": "d317892bb13b86cb1f6f093046a39e91a808e2081d2b37bebb2910b5a66424e7"
    },
    {
      "path": "research/tests/test_agent_controls.py",
      "sha256": "c1340fba85cd920fb2ff7f4b96a1e7199f7e9fd418d74d629fd2c641550e18e8"
    },
    {
      "path": "research/tests/test_promotion.py",
      "sha256": "9d6a97c623782a1635a66f450a576974c91435732184206f60e4637254d7f4bc"
    },
    {
      "path": "research/tests/test_rookie_promotion.py",
      "sha256": "5d2166a29c82be84570927858d5c41808661898518ce1bfc56bffd9cce930a80"
    }
  ],
  "publicEvidence": {
    "promptsRoot": "/methods/prompts/",
    "schemasRoot": "/methods/schemas/",
    "aiOperationsLedger": "/ai-operations-ledger.json",
    "agentEvaluations": "/agent-evaluations.json",
    "exactEconomics": "/agent-economics.json",
    "preservedOnlineManifest": "/research-artifacts/2026-08-31T011519Z-touchdown-regression-v1/manifest.json"
  },
  "dataBoundary": {
    "newModelCallMadeForThisContract": false,
    "unpublishedResearchSentForThisContract": false,
    "credentialsIncluded": false,
    "statement": "This artifact is generated deterministically from committed orchestration code, public prompts and schemas, regression tests, and already-preserved public run evidence."
  }
}