CIE-Unified

2026-03-31_task01_branch_a_round1_scaffold.md

  1# Task 01: Branch A Round 1 Scaffold
  2
  3## Title
  4
  5Task 01: scaffold + observability
  6
  7## Direct Prompt
  8
  9Establish the repo-native Branch A workflow, create the planning/task docs, implement the smallest runnable Python scaffold for Task 01, add minimal smoke tests, and record execution notes after validation.
 10
 11## Suggested Branch Name
 12
 13`branch-a/task01-round1-scaffold`
 14
 15## Goal
 16
 17Create a small, inspectable, graph-native runtime baseline for Branch A that satisfies the locked interface and observability requirements without trying to implement the full CIE theory in round 1.
 18
 19## Background
 20
 21This round must follow the locked conceptual and engineering constraints in:
 22
 23- `/Users/george/code/CIE-Unified/README.md`
 24- `/Users/george/code/CIE-Unified/LOCKED_IMPLEMENTATION_SPEC.md`
 25
 26The runtime must stay graph-native, keep `(phi, mu, J)` as the canonical state, include real output-to-input feedback, and include real decay/forgetting behavior.
 27
 28## Involved Repo
 29
 30- `/Users/george/code/CIE-Unified`
 31
 32## Scope
 33
 34- create Branch A repo-native planning/task docs
 35- add minimal packaging and ignore rules
 36- implement a stdlib-only runtime scaffold
 37- expose the locked runtime interface
 38- add smoke tests with `unittest`
 39- record validation notes after execution
 40
 41## Allowed Modifications
 42
 43- `/Users/george/code/CIE-Unified/plans/2026-03-31_branch_a_plan.md`
 44- `/Users/george/code/CIE-Unified/tasks/2026-03-31_task01_branch_a_round1_scaffold.md`
 45- `/Users/george/code/CIE-Unified/pyproject.toml`
 46- `/Users/george/code/CIE-Unified/.gitignore`
 47- `/Users/george/code/CIE-Unified/cie/__init__.py`
 48- `/Users/george/code/CIE-Unified/cie/state.py`
 49- `/Users/george/code/CIE-Unified/cie/graph.py`
 50- `/Users/george/code/CIE-Unified/cie/runtime.py`
 51- `/Users/george/code/CIE-Unified/tests/__init__.py`
 52- `/Users/george/code/CIE-Unified/tests/test_smoke.py`
 53
 54## Avoid Modifying
 55
 56- `/Users/george/code/CIE-Unified/README.md`
 57- `/Users/george/code/CIE-Unified/LOCKED_IMPLEMENTATION_SPEC.md`
 58
 59## Must Complete
 60
 61- create the plan doc and task doc in-repo
 62- implement the minimal Branch A runtime scaffold
 63- add smoke tests for the locked interface and key round-1 behaviors
 64- run the recommended validation command
 65- update this document with execution notes and results
 66
 67## Acceptance Criteria
 68
 691. A runtime package exists.
 702. The canonical runtime state is centered on `(phi, mu, J)`.
 713. `CIERuntime` exposes:
 72   - `ingest(input, context=None, anchors=None)`
 73   - `step(n=1)`
 74   - `emit()`
 75   - `commit_feedback(feedback)`
 76   - `snapshot_state()`
 77   - `reset_session()`
 784. `snapshot_state()` returns all locked required keys:
 79   - `phi_summary`
 80   - `mu_summary`
 81   - `J_summary`
 82   - `active_region`
 83   - `bound_ability_core`
 84   - `anchor_pull`
 85   - `drift_score`
 86   - `free_capacity`
 87   - `experience_regions`
 88   - `skill_belt_candidates`
 89   - `sedimentation_trace`
 90   - `merge_events`
 91   - `decay_events`
 92   - `output_mode`
 93   - `feedback_effect`
 945. `ingest()` + `step()` causes observable state change.
 956. `emit()` participates in a real output-to-input feedback placeholder.
 967. Real decay/forgetting behavior exists.
 978. Smoke tests pass.
 98
 99## Evaluation Requirements
100
101- use only the Python standard library in the runtime
102- keep the implementation small and inspectable
103- avoid fake ontology via latent vectors
104- avoid `exact_text_map`
105- avoid MoE-style hidden substitution
106- prefer observable state summaries over opaque internals
107
108## Recommended Validation Command
109
110`python3 -m unittest discover -s tests -v`
111
112## Delivery Requirements
113
114- keep Branch A aligned with the locked docs
115- commit on `branch-a/task01-round1-scaffold`
116- push the branch to `origin`
117- include an execution record with branch/base/backup/validation/results/limitations
118
119## Execution Record
120
121- actual branch name: `branch-a/task01-round1-scaffold`
122- base commit: `4c794d418f4c3332006035490bcce1370bb7f0ab`
123- backup path used for dirty-worktree handling: `/Users/george/code/_codex_backups/CIE-Unified/20260331-161757`
124- files changed:
125  - `/Users/george/code/CIE-Unified/.gitignore`
126  - `/Users/george/code/CIE-Unified/pyproject.toml`
127  - `/Users/george/code/CIE-Unified/plans/2026-03-31_branch_a_plan.md`
128  - `/Users/george/code/CIE-Unified/tasks/2026-03-31_task01_branch_a_round1_scaffold.md`
129  - `/Users/george/code/CIE-Unified/cie/__init__.py`
130  - `/Users/george/code/CIE-Unified/cie/graph.py`
131  - `/Users/george/code/CIE-Unified/cie/state.py`
132  - `/Users/george/code/CIE-Unified/cie/runtime.py`
133  - `/Users/george/code/CIE-Unified/tests/__init__.py`
134  - `/Users/george/code/CIE-Unified/tests/test_smoke.py`
135- validation command run: `python3 -m unittest discover -s tests -v`
136- concise test result summary: `Ran 6 smoke tests; all passed.`
137- known limitations deferred to Task 02:
138  - homing and decay are real but intentionally heuristic and lightweight
139  - emit feedback is structural placeholder feedback, not yet richer semantic feedback
140  - task switching, stronger degraded-output behavior, and more expressive dynamics remain for the next round
141
142## Task 02 Continuation Note
143
144- Task 02 branched from commit `3e972559b9ea28fdad8c8eccd8d206afd669836f`.
145- Continuation branch: `branch-a/task02-dynamics-feedback`