# PFES Document Map

This map defines the role of each current-status document so that facts are not
duplicated or allowed to drift.

## Current-State Documents

| Document | Authority and purpose | Update rule |
|---|---|---|
| `README.md` | Entry point, authority rule, and concise operational summary | Update every PFES release |
| `HANDOFF.md` | Five-minute continuation brief for the next engineer or agent | Keep concise; current facts only |
| `PFES_CURRENT_STATE.json` | Machine-readable canonical current state | Update whenever a gate, scope decision, or priority changes |
| `NEXT_WORK_PLAN.md` | Ranked, actionable near-term work with acceptance criteria | Remove completed work; history belongs in the changelog |
| `ROADMAP.md` | Medium- and long-horizon project phases | Do not use for detailed task tracking |
| `Appendices/Appendix_D_Current_Engineering_State.md` | Detailed human-readable current technical state | Current state only; historical progression belongs in migration records |
| `Appendices/Appendix_F_Current_Backlog.md` | Broader active backlog across project domains | Do not retain completed or superseded tasks |
| `Migration/MIGRATION_TRACKER.md` | Status of source-group migration into PFES | Track source review, trust, target chapters, and retention |
| `Migration/PFES_SOURCE_COVERAGE_MATRIX.md` | Human-readable source coverage and migration gaps | Update whenever a source group or coverage state changes |
| `Migration/PFES_SOURCE_COVERAGE_MATRIX.json` | Canonical machine-readable source coverage | Validate against its schema on every update |
| `Migration/PFES_CURRENT_KNOWLEDGE_AUDIT.md` | Human-readable audit against recent project handoffs | Update when a new broad handoff audit is performed |
| `Migration/PFES_CURRENT_KNOWLEDGE_AUDIT.json` | Canonical machine-readable audit findings | Use as the migration queue for current knowledge |
| `Migration/Historical_HTML_Corpus/HISTORICAL_HTML_CORPUS_INVENTORY.md` | Human-readable historical HTML inventory | Update when corpus contents change |
| `Migration/Historical_HTML_Corpus/HISTORICAL_HTML_CORPUS_INVENTORY.json` | Canonical item/path/hash inventory | Validate against its schema on every corpus update |
| `Migration/Historical_HTML_Corpus/HISTORICAL_HTML_LINEAGE_AND_REVIEW_BATCHES.json` | Candidate revision families and review order | Update when claim review resolves lineage |
| `CHANGELOG.md` | Historical PFES revision record | Append-only except factual correction |
| `manifest.json` | File inventory and integrity hashes | Regenerate for every complete snapshot |

| `Migration/Project_Incubation/PROJECT_REGISTER.json` | Canonical project lifecycle and repository state register | Update whenever a project is admitted, promoted, archived, or changes repository state |
| `Migration/Project_Incubation/PROJECT_ADMISSION_TEMPLATE.md` | Reusable human admission checklist | Copy and complete for each proposed project |
| `Operational_Contracts/PROJECT_INCUBATION_AND_REPOSITORY_ADMISSION_CONTRACT.json` | Binding lifecycle and repository-admission rules | Version only through reviewed PFES change |

## Durable Rules and Methods

- `Volume_I_Constitution/` — project authority, principles, scope, and rules.
- `Volume_II_Engineering_Manual/` — reusable engineering methodology.
- `Volume_III_Technical_Reference/` — formats, schemas, status models, and
  technical definitions.
- `Engineering_Laws/` — concise durable laws.
- `Engineering_Discoveries/` — promoted discoveries that apply beyond one
  experiment.

## Historical and Evidentiary Material

- `Migration/Batch_*/` preserves source-specific reports, corrections,
  validation records, and evidence.
- Historical build failures remain in migration reports and the changelog,
  not in current-state documents.
- Evidence is not deleted merely because its conclusion has been promoted.

## Reading Paths

### Continue the current task

1. `HANDOFF.md`
2. `NEXT_WORK_PLAN.md`
3. `PFES_CURRENT_STATE.json`
4. Relevant Batch 002 evidence


### Continue an incubating project

1. `Migration/Project_Incubation/PROJECT_REGISTER.json`
2. The project's `AGENT_HANDOFF.md`
3. The project's `PROJECT_RECORD.json`
4. The external source package identified by `ARTIFACT_INTAKE.json`
5. `PFES-ENG-045` before requesting a repository

### Understand the project from first principles

1. Volume I
2. Engineering Laws
3. PFES-ENG-000
4. Relevant Volume II chapters
5. Volume III references

### Audit a claim

1. Find its current statement in Appendix D or the relevant chapter.
2. Check its status in `PFES_CURRENT_STATE.json`.
3. Follow the evidence pointer into `Migration/`.
4. Compare against the source-authority hierarchy.

| `Migration/Historical_HTML_Corpus/Claim_Review/HISTORICAL_HTML_CLAIM_REGISTER.json` | Canonical historical claim/status register | Append and validate after each batch |
| `Migration/Historical_HTML_Corpus/Claim_Review/BATCH_01_BASELINE_AUTHORITY_REVIEW.md` | Completed Batch-01 review | Preserve as historical review record |
| `Migration/Historical_HTML_Corpus/Claim_Review/BATCH_02_DONOR_RECIPIENT_STRATEGY_REVIEW.md` | Human review of donor/recipient/conversion/finalization documents | Preserve as completed Batch-02 record |
| `Migration/Historical_HTML_Corpus/Claim_Review/FUTURE_EVIDENCE_REGISTER.json` | Primary evidence known to exist but not yet evaluated | Update when evidence is supplied or resolved |

| `Migration/Historical_HTML_Corpus/Claim_Review/BATCH_03_COMMAND_AUTH_SECURITY_REVIEW.md` | Human review of command/auth/crypto/identity/security documents | Preserve as completed Batch-03 record |
| `Migration/Historical_HTML_Corpus/Claim_Review/CLAIM_STATUS_REVISIONS_v0.12.7.json` | Historical claim status changes caused by new evidence | Preserve and append new revision records |

| `Migration/Historical_HTML_Corpus/Claim_Review/BATCH_04_MEMORY_EXECUTION_CONTROL_REVIEW.md` | Human review of memory/ISA/dispatch/DMA/ATAPI/reset/cache/bridge documents | Preserve as completed Batch-04 record |
| `Migration/Historical_HTML_Corpus/Claim_Review/CLAIM_STATUS_REVISIONS_v0.12.8.json` | Claim corrections caused by Batch-04 primary evidence | Preserve as historical status-change record |

| `Migration/Historical_HTML_Corpus/Claim_Review/BATCH_01_BASELINE_AUTHORITY_REVIEW.md` | Human review of baseline/audit/summary documents | Preserve as completed Batch-01 record |
| `Migration/Historical_HTML_Corpus/Claim_Review/BATCH_05_SERVO_TRAY_HARDWARE_REVIEW.md` | Human review of servo/tray/GPIO/SFR/hardware documents | Preserve as completed Batch-05 record |
| `Migration/Historical_HTML_Corpus/Claim_Review/Evidence/TSOP48/TSOP48_EVIDENCE_INTAKE.json` | Exact TSOP48 evidence identity, provenance, and preliminary comparison | Use as Batch-06 primary evidence intake |

| `Migration/Historical_HTML_Corpus/Claim_Review/BATCH_06_FLASH_UPDATE_REVIEW.md` | Completed flash/updater theory review | Preserve as Batch-06 record |
| `Migration/Historical_HTML_Corpus/Claim_Review/Evidence/TSOP48/GCC4241N_TSOP_TRANSFORM_ANALYSIS.json` | Exact A100/A101 transform and failed-flash analysis | Canonical TSOP transform evidence |
| `Migration/Historical_HTML_Corpus/Claim_Review/Evidence/Current_Project/CD_READY_SEMANTICS_CORRECTION.md` | Corrected Xbox SMC ready-signal semantics | Supersedes authorization-dependent wording |

| `Migration/Historical_HTML_Corpus/Claim_Review/BATCH_07_GCC4244N_RESEARCH_REVIEW.md` | GCC-4244N historical research review | Preserve as completed Batch-07 record |
| `Migration/Historical_HTML_Corpus/Claim_Review/Evidence/TSOP48/Drive1_Failed_Flash/GCC4241N_DRIVE1_FAILED_FLASH_ANALYSIS.json` | Supplemental failed-flash binary analysis | Preserve with raw evidence |

| `Migration/Historical_HTML_Corpus/Claim_Review/BATCH_08_CCI_MEDIA_FORMAT_REVIEW.md` | Completed CCI historical claim review | Preserve |
| `Migration/Historical_HTML_Corpus/Claim_Review/Evidence/CCI/Forza_Motorsport_GLO/CCI_SAMPLE_ANALYSIS.json` | Machine-readable CCI header/index/sample analysis | Preserve and extend with complete matched sample |
| `Migration/Historical_HTML_Corpus/Claim_Review/Evidence/CCI/Forza_Motorsport_GLO/DEFAULT_XBE_TBN_ANALYSIS.json` | Machine-readable Repackinator sidecar analysis | Preserve |

| `Migration/Historical_HTML_Corpus/Claim_Review/BATCH_09_VENDOR_UPDATE_PAGES_REVIEW.md` | Completed vendor updater-page claim review | Preserve |
| `Migration/Historical_HTML_Corpus/Claim_Review/Evidence/Vendor_Update_Pages/VENDOR_UPDATE_PAGES_ANALYSIS.json` | Machine-readable vendor-page lineage, filenames, links, and authority boundaries | Preserve |
| `Migration/Historical_HTML_Corpus/PFES-MIG-001B_COMPLETION_REPORT.md` | Completion record for the full historical HTML claim-review program | Preserve |
| `Migration/Historical_HTML_Corpus/HISTORICAL_HTML_CLAIM_REVIEW_COMPLETION.json` | Machine-readable historical review completion state | Preserve |

## Analyzer Knowledge Migration

| Document | Authority and purpose | Update rule |
|---|---|---|
| `Volume_III_Technical_Reference/PFES-TR-006_Analyzer_Pipeline_and_Evidence_Contract.md` | Canonical analyzer authority boundaries and indirect-dispatch rule | Update only when stage semantics change |
| `Migration/Analyzer_Knowledge/ANALYZER_STAGE_CONTRACTS.json` | Machine-readable Stage1–post5B contracts | Validate on every analyzer migration update |
| `Migration/Analyzer_Knowledge/ANALYZER_SOURCE_REGISTER.json` | Preserved source hashes, producers, CLI flags and lineage | Append exact source snapshots; do not overwrite history |
| `Migration/Analyzer_Knowledge/ANALYZER_FINDINGS_REGISTER.json` | Durable current analyzer findings and negative knowledge | Revise with explicit evidence and status history |
| `Migration/Analyzer_Knowledge/ANALYZER_OUTPUT_CORPUS_REGISTER.json` | Known-good generated-output paths and semantics | Register new full-run lineage and archive hashes |
| `Operational_Contracts/ANALYZER_OPERATING_CONTRACT.json` | Stable filenames, rerun policy, safety and provenance constraints | Binding unless user explicitly overrides |
| `Migration/Analyzer_Knowledge/PFES-MIG-002_COMPLETION_REPORT.md` | Completion record | Preserve |

## Emulator Knowledge Migration

| Document | Authority and purpose | Update rule |
|---|---|---|
| `Volume_III_Technical_Reference/PFES-TR-007_Emulator_Architecture_Baselines_and_Proof_Boundaries.md` | Canonical emulator baseline and proof-boundary reference | Update only with explicit new evidence |
| `Migration/Emulator_Knowledge/EMULATOR_BASELINE_REGISTER.json` | Machine-readable v206/v258 and rejected-lineage register | Preserve prior baseline history |
| `Migration/Emulator_Knowledge/EMULATOR_COMPONENT_REGISTER.json` | v258 component/source map | Add new snapshots; do not silently replace |
| `Migration/Emulator_Knowledge/EMULATOR_FINDINGS_REGISTER.json` | Durable emulator findings, open questions, and negative knowledge | Revise with status history |
| `Migration/Emulator_Knowledge/EMULATOR_PROOF_BOUNDARY_REGISTER.json` | Closed/open proof classes | Never merge bridge, seeded, firmware, and hardware proof |
| `Migration/Emulator_Knowledge/EMULATOR_PROFILE_OWNERSHIP_CONTRACT.json` | Device/media/session/proof/test authority split | Binding architecture decision |
| `Operational_Contracts/EMULATOR_OPERATING_CONTRACT.json` | Runtime, test, logging, package, and Windows rules | Binding unless user explicitly overrides |
| `Migration/Emulator_Knowledge/PFES-MIG-003_COMPLETION_REPORT.md` | Completion record | Preserve |

## Knowledge Normalization

| Document | Role |
|---|---|
| `Migration/Knowledge_Normalization/UNIFIED_KNOWLEDGE_NODE_REGISTER.json` | All 590 historical, analyzer, and emulator nodes |
| `Migration/Knowledge_Normalization/KNOWLEDGE_CROSS_REFERENCE_REGISTER.json` | Typed node/evidence/destination edges |
| `Migration/Knowledge_Normalization/CLAIM_NORMALIZATION_REGISTER.json` | Per-claim preservation and current-link status |
| `Migration/Knowledge_Normalization/EVIDENCE_ARTIFACT_INDEX.json` | Complete preserved evidence index |
| `Operational_Contracts/KNOWLEDGE_NORMALIZATION_CONTRACT.json` | Binding normalization rules |
| `Volume_III_Technical_Reference/PFES-TR-008_Knowledge_Graph_Authority_and_Cross_References.md` | Human technical reference |
| `Migration/Knowledge_Normalization/PFES-MAINT-003_COMPLETION_REPORT.md` | Maintenance completion record |


## Repository Bootstrap and Storage

| Document | Authority and purpose |
|---|---|
| `Volume_III_Technical_Reference/PFES-TR-009_Repository_Artifact_and_Storage_Architecture.md` | Canonical repository and artifact architecture |
| `Operational_Contracts/REPOSITORY_OPERATING_CONTRACT.json` | Binding Git, storage, provenance, and interim-backup rules |
| `Migration/Repository_Bootstrap/REPOSITORY_SERVER_BASELINE.json` | Current HP ProLiant server constraints |
| `Migration/Repository_Bootstrap/REPOSITORY_BOUNDARY_REGISTER.json` | Repository/external-store boundaries |
| `Migration/Repository_Bootstrap/ARTIFACT_STORAGE_CLASS_REGISTER.json` | A0–A4 lifecycle classes and PFART identity |
| `Migration/Repository_Bootstrap/PFES_SNAPSHOT_IMPORT_REGISTER.json` | Hash-registered accepted PFES import sequence |
| `Migration/Repository_Bootstrap/PFES-REPO-001_COMPLETION_REPORT.md` | Repository-readiness completion record |
| `Migration/Repository_Bootstrap/PFES-REPO-002_COMPLETION_REPORT.md` | Interim-volume, scope-correction, and implementation-authority completion record |
| `Migration/Repository_Bootstrap/XBOX_DVD_TOOLS_AUTHORITY_REGISTER.json` | Machine-readable implementation/PFES authority split |
| `Migration/Repository_Bootstrap/REPOSITORY_EXECUTION_EVIDENCE_REGISTER.json` | Exact audit, candidate, and promotion evidence hashes |
| `Migration/Repository_Bootstrap/REPOSITORY_BOOTSTRAP_NEGATIVE_KNOWLEDGE.md` | Preserved failure lineage and durable procedure rules |
| `Repository_Bootstrap_Kit/` | Non-destructive preflight, layout, validation, and history-import tools |

## PFES 0.15.2 additions

| Document | Authority and purpose |
|---|---|
| `Migration/Repository_Bootstrap/PFES-REPO-005_INSTALLATION_REPORT.md` | Installed PFES history and validation result |
| `Migration/Repository_Bootstrap/PFES_GIT_AUTHORITY_GATE.md` | Exact transition conditions |
| `Migration/Hardware_Investigation/PFES-HW-DH40N-001_HP_DH40N_CONTROLLER_IDENTIFICATION.md` | Safe controller-identification plan |


## PFES Git authority

| Path | Role |
|---|---|
| `Migration/Repository_Bootstrap/PFES_GIT_AUTHORITY_ACCEPTANCE.json` | Machine-readable authority decision |
| `Migration/Repository_Bootstrap/PFES_V0152_APPEND_REPORT_REVIEW.json` | Independent gate-evidence review |
| `Migration/Repository_Bootstrap/PFES-REPO-005_COMPLETION_REPORT.md` | Completed history-import and authority transition |


## PFES-REPO-006 Repository Authority Records

| Document | Authority and purpose | Update rule |
|---|---|---|
| `Migration/Repository_Bootstrap/PFES-REPO-006_COMPLETION_REPORT.md` | Closure report for emulator repository separation | Preserve |
| `Migration/Repository_Bootstrap/PFES-REPO-006_VALIDATION.json` | Machine-readable closure validation | Preserve |
| `Migration/Repository_Bootstrap/MN103S_EMULATOR_INSTALLATION_REPORT_REVIEW.json` | Independent review of staged-install evidence | Preserve |
| `Migration/Repository_Bootstrap/MN103S_EMULATOR_GIT_AUTHORITY_ACCEPTANCE.json` | Authority decision and scope boundary | Update only through a later explicit authority transition |
| `Migration/Repository_Bootstrap/MN103S_EMULATOR_AUTHORITY_REGISTER.json` | Current emulator authority identity | Update with reviewed canonical releases |
