---
phase: 69-docs-acceptance-and-regression-closure
plan: 01
type: execute
wave: 1
depends_on:
  - 68-source-fidelity-ranking-and-runtime-read-surfaces
files_modified:
  - README.md
  - research/knowledge-hub/README.md
  - research/knowledge-hub/runtime/README.md
  - research/knowledge-hub/runtime/AITP_TEST_RUNBOOK.md
  - research/knowledge-hub/source-layer/README.md
  - research/knowledge-hub/runtime/scripts/run_source_catalog_acceptance.py
  - research/knowledge-hub/tests/test_source_catalog_contracts.py
autonomous: true
requirements:
  - REQ-VERIFY-01
must_haves:
  truths:
    - docs parity must match the real source-catalog command family
    - acceptance must run through production CLI on an isolated kernel root
    - milestone closure is invalid without full regression green
---

<objective>
Close `v1.46` with docs parity, non-mocked acceptance, and final regression
evidence.
</objective>

<execution_context>
@D:/BaiduSyncdisk/Theoretical-Physics/.codex-home/get-shit-done/workflows/execute-plan.md
@D:/BaiduSyncdisk/Theoretical-Physics/.codex-home/get-shit-done/templates/summary.md
</execution_context>

<context>
@.planning/phases/69-docs-acceptance-and-regression-closure/69-CONTEXT.md
@.planning/REQUIREMENTS.md
@research/knowledge-hub/runtime/scripts/run_source_catalog_acceptance.py
@research/knowledge-hub/tests/test_source_catalog_contracts.py
</context>

<tasks>

<task type="auto">
  <name>Task 1: Add failing docs and acceptance contract tests</name>
  <files>research/knowledge-hub/tests/test_source_catalog_contracts.py</files>
  <read_first>research/knowledge-hub/tests/test_source_catalog_contracts.py</read_first>
  <action>Add red contract checks for source-catalog docs parity and acceptance-script coverage.</action>
  <verify>python -m pytest research/knowledge-hub/tests/test_source_catalog_contracts.py -q</verify>
  <acceptance_criteria>
    - tests fail before implementation
    - failures prove docs or acceptance are still incomplete
  </acceptance_criteria>
  <done>A red contract exists for Phase `69`.</done>
</task>

<task type="auto">
  <name>Task 2: Update docs and bounded acceptance coverage</name>
  <files>README.md, research/knowledge-hub/README.md, research/knowledge-hub/runtime/README.md, research/knowledge-hub/runtime/AITP_TEST_RUNBOOK.md, research/knowledge-hub/source-layer/README.md, research/knowledge-hub/runtime/scripts/run_source_catalog_acceptance.py</files>
  <read_first>research/knowledge-hub/runtime/scripts/run_source_catalog_acceptance.py, research/knowledge-hub/source-layer/README.md</read_first>
  <action>Make the source-catalog command family discoverable in docs and add a dedicated isolated acceptance script for the Layer 0 reuse surface.</action>
  <verify>python -m pytest research/knowledge-hub/tests/test_source_catalog_contracts.py -q</verify>
  <acceptance_criteria>
    - docs mention the source-catalog command family
    - acceptance verifies catalog, traversal, family, and runtime fidelity outputs
    - the non-mocked acceptance still uses an isolated temp kernel root
  </acceptance_criteria>
  <done>Docs parity and acceptance close over the matured Layer 0 source-reuse surface.</done>
</task>

<task type="auto">
  <name>Task 3: Run acceptance and final regression</name>
  <files>research/knowledge-hub/runtime/scripts/run_source_catalog_acceptance.py, research/knowledge-hub/tests/</files>
  <read_first>.planning/REQUIREMENTS.md</read_first>
  <action>Run the upgraded acceptance script and the full knowledge-hub suite, then archive the milestone with final traceability docs.</action>
  <verify>python -m pytest research/knowledge-hub/tests -q</verify>
  <acceptance_criteria>
    - acceptance exits 0
    - docs contracts exit 0
    - full suite exits 0
  </acceptance_criteria>
  <done>Milestone `v1.46` is ready to archive.</done>
</task>

</tasks>
