cairn-ai 0.2.4 → 0.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -39,10 +39,27 @@ Describe the observable result.
39
39
  - Role-specific adjustment:
40
40
  - User-visible response and artifact locale: OS locale unless the user asks for another language.
41
41
 
42
+ ## Reasoning Effort Profile
43
+
44
+ - Model: inherited from the host/user default; never override it.
45
+ - Light Path: planning=`medium`, implementation=`medium`, verification=`medium`.
46
+ - Heavy Path: planning/review=`high`, implementation=`high`, final verification/review=`xhigh`.
47
+ - Host boundary: pass a requested value only when dispatching a new task/worker and the host exposes a reasoning-effort option or host-native equivalent. Unsupported host/value means `Effective reasoning effort: inherited`; do not alter model/global config.
48
+ - Route-change gate: synchronize the plan artifact, repository goal task roadmap through `goal replan`, native UI plan, and reasoning effort profile before edits resume. Completed task profiles are preserved as audit history; incomplete task profiles are recalculated for the new path.
49
+ - Every module task records:
50
+ - Requested reasoning effort:
51
+ - Effective reasoning effort: `inherited` until a new dispatch confirms an accepted override.
52
+
42
53
  ## Complexity Triage
43
54
 
44
55
  - Selected path: Light Path or Heavy Path.
45
56
  - Selection rationale:
57
+ - Checkpoint ledger:
58
+ - Request checkpoint: provisional route, request/`MEMORY.md` evidence, uncertainty, and newly found Heavy Path signals.
59
+ - Planning checkpoint: post-exploration route, affected-surface/test evidence, and newly found Heavy Path signals.
60
+ - Code checkpoint: `pending` until exact files/callers/tests are inspected; record the final route immediately before the first edit.
61
+ - Route-change synchronization: before editing, evidence may change either route. Update the plan artifact, replace the incomplete repository goal task roadmap with `goal replan`, and update the native UI plan to the same stable task order, reviews, assignments, and required evidence before mutation.
62
+ - Late promotion: after editing begins, a new Heavy Path signal promotes Light Path to Heavy Path. Stop further edits, mark affected evidence stale, synchronize all three roadmaps, run newly required review, and repeat the code checkpoint before resuming.
46
63
  - Heavy Path signals checked:
47
64
  - New directory/module/layer:
48
65
  - New domain model/service/abstraction:
@@ -97,6 +114,8 @@ Describe the observable result.
97
114
 
98
115
  - Task ID: `triage-plan`
99
116
  - Initial status: `active`
117
+ - Requested reasoning effort:
118
+ - Effective reasoning effort:
100
119
  - Contract: execute the investigation scope and Heavy Path criteria declared by the initial plan, then update this file and the Codex UI plan to the decision-complete implementation revision.
101
120
  - Required evidence records:
102
121
  - `planArtifact`: command, exit code 0, timestamp, goal ID, task ID, and plan ID.
@@ -106,6 +125,8 @@ Describe the observable result.
106
125
 
107
126
  - Task ID: `task-1`
108
127
  - Initial status: `pending` or `active`
128
+ - Requested reasoning effort:
129
+ - Effective reasoning effort:
109
130
  - Contract:
110
131
  - Sub-tasks, if needed:
111
132
  - Files: