Shay
|
54e6bfc0d0
|
docs: reorganize docs landscape
Implements the 4-phase documentation reorganization master plan.
- Consolidation: Merged brief/, handoff/, planning/, and decisions/ into briefs/, handoffs/, plans/, and adr/ respectively (101 ADRs relocated)
- Root Cleanup: Relocated HANDOFF-gpt55-*.md and key top-level docs (runtime_contracts.md, etc.) to canonical folders. Added superseded alerts.
- Indices & Navigation: Created docs/README.md navigation document, docs/sessions/README.md index, docs/adr/README.md index
- Note: Also includes prior commit adding ADR-0200+ corpus hygiene governance (ADR-0225, dependency map, backfilled cross-references)
|
2026-06-30 16:59:36 -07:00 |
|
Shay
|
980213ed62
|
feat(binding-graph): Phase 1 data model (ADR-0132) (#171)
Frozen dataclasses + deterministic allocator + invariants for the
Semantic-Symbolic Binding Graph proposed in PR #170. Pure data layer:
no parser, no solver, no adapter, no runtime wiring. Phases 2-5
deferred to follow-up PRs.
- generate/binding_graph/model.py: SourceSpanLink, SymbolBinding,
BoundFact, BoundEquation, BoundUnknown, BoundConstraint, and the
top-level SemanticSymbolicBindingGraph container. All
@dataclass(frozen=True, slots=True). Refusal-first construction via
typed BindingGraphError. Cross-collection referential integrity
enforced at __post_init__.
- generate/binding_graph/allocation.py: pure deterministic
allocate_symbols() — same input order yields byte-equal output.
- generate/binding_graph/__init__.py: public API surface.
- tests/test_binding_graph_model.py: 69 tests covering frozen
invariants, slots enforcement, refusal paths, allocation
determinism, canonical-string round-trip, cross-collection
integrity.
- docs/decisions/ADR-0132-binding-graph-data-model.md: ratifies
Phase 1 only; explicit Phase 2-5 deferred section citing #170.
|
2026-05-23 10:29:59 -07:00 |
|