docs(cf11g): restore ecosystem context graph prerequisite

Merged
TH
3mo ago
+942-3

Summary

Reconcile the canonical commandF roadmap after historical CF-11 was used for the multi-version package-graph foundation correction.

This PR preserves completed CF-11 history and introduces CF-11G as the missing ecosystem Context Graph slice required before CF-12 commandf impact.

Decision

CF-11  = canonical multi-version package graph foundation correction (history unchanged)
CF-11G = ecosystem Context Graph + commandf context
CF-12  = commandf impact, depends on CF-11G

Spec Kit sequence 012 is the next available planning-package number only; it does not renumber downstream product slices.

Scope

Documentation / planning only:

  • reconcile docs/COMMAND_F_MASTER_ARCHITECTURE_V2.md;
  • add specs/012-cf-11g-ecosystem-context-graph/spec.md;
  • add plan.md;
  • add dependency-ordered tasks.md;
  • add explicit consistency analysis.

Key implementation contract planned

CF-11G will ship:

commandf context --lock commandf.lock --cache .commandf/cache --format json

The plan requires:

  • lock schema v2 with exact resolver-recorded parent→child package edges;
  • backward read compatibility for existing schema-v1 locks;
  • fail-closed Context Graph refusal on v1 instead of reconstructing ambiguous edges;
  • deterministic package/artifact/reference relations;
  • explicit resolved / external / ambiguous canonical target states;
  • bounded StructureDefinition, ValueSet, and CodeSystem V1 reference extractors;
  • explicit unsupported-resource coverage metadata;
  • offline verified-cache graph construction;
  • no graph database, vector search, AI authority, CF-06 pin change, or CF-10 corpus mutation.

Roadmap independence

The external HL7 maintainer/upstream path is not a dependency of this planning or implementation slice. CF-06 production semantics remain unchanged.

Verification boundary

This PR contains no Rust, Cargo, fixture, workflow, lockfile, or runtime behavior changes.

Implementation starts only from the Spec/Plan/Tasks contract after exact-head planning review and will follow the task order in stacked independently reviewable PRs.

Closes #19 when this roadmap/spec reconciliation becomes canonical.

Summary by cubic

Restores the missing Context Graph prerequisite by introducing CF-11G and updating the Master Architecture so CF-12 commandf impact depends on it. Historical CF-11 remains the multi-version package-graph foundation; this PR is planning-only and changes no runtime behavior.

  • Updates docs/COMMAND_F_MASTER_ARCHITECTURE_V2.md to add CF-11G and adjust downstream dependencies (CF-12, CF-16).
  • Adds specs/012-cf-11g-ecosystem-context-graph/{spec.md,plan.md,tasks.md,consistency.md}.
  • Defines commandf context JSON output and a lock schema v2 requirement with backward read-compatibility for schema v1.
  • Documents offline, cache-verified graph construction and explicit resolved/external/ambiguous target states.
  • No Rust/Cargo, fixtures, workflows, lockfiles, or runtime behavior changes in this PR.

Summary by CodeRabbit

  • Documentation
    • Added the CF-11G roadmap entry and clarified sequencing relationships with related initiatives.
    • Documented the planned Ecosystem Context Graph, including package and artifact relationships, dependency provenance, deterministic output, and offline operation.
    • Defined the planned commandf context command, supported FHIR canonical-reference extraction, cache verification, bounded inputs, and fail-closed behavior for incomplete lock data.
    • Added implementation tasks, testing requirements, regression gates, acceptance criteria, and migration guidance.