Expand description
BP-7 (catalog §4a “Goals (persistent objective across turns)”, cc’s
/goal, cx’s /goal + goals_1.sqlite): the session’s standing
objective.
Not the plan. update_plan (the todos module’s tool) holds a
steps/status array for the CURRENT stretch of work and is deliberately
ephemeral. A goal is the condition the whole session is working toward:
one sentence, set once, restated to the model on every request until it
is changed or cleared, and persisted beside the session so it survives a
resume. Design §2 module 7 homes goals with todos for exactly this
reason — same module, different lifetime.
Where it lands. <session>.goal.json, a single typed record in the
sidecar family next to <session>.git.json (also a single record, not a
log) — never inside the provider-visible transcript, so translating a
session to another harness never has to invent a message for it.
Structs§
- Goal
Record - The session’s persistent objective.