CIE-Unified

2026-03-31_task03_branch_a_sedimentation.md

  1# Task 03: Branch A Sedimentation Path
  2
  3## Title
  4
  5Task 03: sedimentation path + skill belt candidates + merge/decay events
  6
  7## Direct Prompt
  8
  9Continue Branch A from commit `9823c2395c565908965b137e343bcbc1883ae3c5`, keep the implementation independent from other branches, turn sedimentation from heuristic placeholders into explicit runtime structures and events, make `memory -> experience -> skill_belt -> ability_core` visible in state, and record execution results in-repo.
 10
 11## Suggested Branch Name
 12
 13`branch-a/task03-sedimentation`
 14
 15## Goal
 16
 17Implement the smallest inspectable Branch A sedimentation model that keeps the runtime graph-native, makes stage progression explicit, exposes skill-belt candidacy and ability-core merges as real events, and lets decay/inactivity demote developing structures.
 18
 19## Background
 20
 21This round continues to 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
 26Those documents remain locked and define the Branch A requirements for graph-native runtime state, the fixed sedimentation path, decay, homing, and comparable observability.
 27
 28## Involved Repo
 29
 30- `/Users/george/code/CIE-Unified`
 31
 32## Scope
 33
 34- update the Branch A plan/task docs for round 3
 35- replace sedimentation stage placeholders with explicit runtime sedimentation profiles
 36- make `memory -> experience -> skill_belt -> ability_core` progression visible and evented
 37- derive `skill_belt_candidates` from repeated activation, stability, and recurrence
 38- record merge events when skill-belt structures promote into ability-core-level structures
 39- make decay/inactivity interact with sedimentation state through explicit demotion behavior
 40- strengthen snapshot observability while keeping the runtime small and stdlib-only
 41- extend tests for traces, candidates, merges, and decay interaction
 42
 43## Allowed Modifications
 44
 45- `/Users/george/code/CIE-Unified/plans/2026-03-31_branch_a_plan.md`
 46- `/Users/george/code/CIE-Unified/tasks/2026-03-31_task02_branch_a_dynamics_feedback.md`
 47- `/Users/george/code/CIE-Unified/tasks/2026-03-31_task03_branch_a_sedimentation.md`
 48- `/Users/george/code/CIE-Unified/cie/__init__.py`
 49- `/Users/george/code/CIE-Unified/cie/graph.py`
 50- `/Users/george/code/CIE-Unified/cie/state.py`
 51- `/Users/george/code/CIE-Unified/cie/runtime.py`
 52- `/Users/george/code/CIE-Unified/tests/__init__.py`
 53- `/Users/george/code/CIE-Unified/tests/test_smoke.py`
 54- `/Users/george/code/CIE-Unified/tests/test_dynamics.py`
 55- `/Users/george/code/CIE-Unified/tests/test_sedimentation.py`
 56
 57## Avoid Modifying
 58
 59- `/Users/george/code/CIE-Unified/README.md`
 60- `/Users/george/code/CIE-Unified/LOCKED_IMPLEMENTATION_SPEC.md`
 61
 62## Must Complete
 63
 64- mark Task 02 complete and Task 03 complete in the Branch A plan
 65- create this Task 03 prompt document in-repo
 66- implement explicit sedimentation runtime state and stage transitions
 67- make `skill_belt_candidates`, `merge_events`, and `decay_events` materially meaningful
 68- keep `snapshot_state()` aligned with the locked observable fields
 69- validate with the recommended unittest command
 70- record execution details and deferred limitations here
 71
 72## Acceptance Criteria
 73
 741. runtime has explicit, inspectable sedimentation-stage representation aligned to `memory -> experience -> skill_belt -> ability_core`
 752. `sedimentation_trace` records stage transitions as real runtime events, not comments/placeholders only
 763. repeated activation can promote structures toward `skill_belt_candidates`
 774. stable/repeated skill-belt structures can generate `merge_events` into ability-core level structures
 785. decay/inactivity can generate `decay_events` that interact with sedimentation state
 796. `snapshot_state` keeps required locked fields and makes them more meaningful
 807. tests pass
 81
 82## Evaluation Requirements
 83
 84- use only the Python standard library in runtime code
 85- keep the implementation minimal, explicit, and inspectable
 86- stay graph-native with `(phi, mu, J)` as the canonical state
 87- avoid `exact_text_map`
 88- avoid MoE-style substitution
 89- avoid latent-vector ontology as the real runtime state
 90- keep observability stronger than hidden heuristics
 91
 92## Recommended Validation Command
 93
 94`python3 -m unittest discover -s tests -v`
 95
 96## Delivery Requirements
 97
 98- commit on `branch-a/task03-sedimentation`
 99- push the branch to `origin`
100- keep the implementation independent from `branch-b` and other later branches
101- include execution record details for branch/base/backup/files/validation/results/limitations
102
103## Execution Record
104
105- actual branch name: `branch-a/task03-sedimentation`
106- base commit: `9823c2395c565908965b137e343bcbc1883ae3c5`
107- backup path used for dirty-worktree handling: `none`
108- files changed:
109  - `/Users/george/code/CIE-Unified/plans/2026-03-31_branch_a_plan.md`
110  - `/Users/george/code/CIE-Unified/tasks/2026-03-31_task02_branch_a_dynamics_feedback.md`
111  - `/Users/george/code/CIE-Unified/tasks/2026-03-31_task03_branch_a_sedimentation.md`
112  - `/Users/george/code/CIE-Unified/cie/state.py`
113  - `/Users/george/code/CIE-Unified/cie/runtime.py`
114  - `/Users/george/code/CIE-Unified/tests/test_smoke.py`
115  - `/Users/george/code/CIE-Unified/tests/test_dynamics.py`
116  - `/Users/george/code/CIE-Unified/tests/test_sedimentation.py`
117- validation command run: `python3 -m unittest discover -s tests -v`
118- concise test result summary: `Ran 14 tests; all passed.`
119- remaining limitations deferred to Task 04:
120  - unified validation/reporting against the locked comparison format is still pending
121  - sedimentation merge logic is explicit and inspectable, but still heuristic and node/region centric rather than richer loop-level structure analysis
122  - snapshot observability is ready for Task 04, but the final cross-branch report/export layer is not yet implemented
123
124Task 04 for Branch A was then branched independently from commit `164c06af63812c69cab32d8f8a6c770b96f38ef6` on `branch-a/task04-validation-reporting` to add unified validation/reporting and review-ready exports.