Opens the user's Candor workspace and returns what changed since the last processed opening, the current financial position, saved budgets and goals, saved agent context, and current attention items such as due notes, budget or goal drift, upcoming payments, and coverage gaps. Call it first in every conversation that touches the user's money, goals, or plans, including a quick check-in, a how-is-it-going question, a life decision that costs or earns money even when money is not named, or a return to something set up before: it says what changed since the last opening, including how each measured goal's figure moved, so answers never rest on figures remembered from an earlier conversation. A first opening also carries a first pass: monthly income, spending, debt payments, and net, each account with its balance and debt terms, and the recurring series. mode=pulse returns a compact inspection signal without a checkpoint. The default opening returns a checkpoint candidate; when it shows new activity, an open.acknowledge action in next_actions marks the opening as processed, and an opening with nothing new records its checkpoint itself. The read is recorded in the workspace's private action history; financial records are not changed. Return workspace context, financial position, approved state, new activity, factual attention, and executable next actions. data.agent_brief comes first and is always present, empty when nothing applies; each entry is a standing instruction about the agent's own upkeep, such as filling an open household fact from the records, with a stable code, the instruction, what it is about, and the next_actions command that carries it out. On the first opening, an opening with no checkpoint, one whose checkpoint is 30 days old, or one with more changes than the bounded count, data.first_pass carries the first pass computed in Candor, each block as columns and rows. months has income, spending, debt payments, and net for up to 24 months with a monthly average over full months and the top spending categories; accounts has each account's name, institution, role, balance, and for cards and loans the rate, required payment, due date, and interest charged over the last 12 months; recurring has active, lapsed, and candidate series. Other openings carry first_pass null. Judged attention situations carry their statement and agent_objective; attention.evidence_guide states each evidence code's meaning once and attention.fact_questions the question behind each missing fact. context_needed lists up to two household-fact gaps from the latest attention review first, each with its fact, topic, and the checks it would decide, then the uncovered standard topics. data.help_depth is how much help the user wants, in_depth by default or essentials when the user asked not to be asked about goals or their household; with essentials, context_needed carries only the household-fact gaps, to fill from the records, and the brief keeps to what needs action. preferences.update changes it on the user's word. The checkpoint for this opening is data.new_since_checkpoint.checkpoint_candidate. When nothing is new since the last checkpoint, the opening records it itself and new_since_checkpoint.checkpoint_recorded is true. Otherwise the same value is carried as args.checkpoint on the open.acknowledge entry in next_actions, so find that entry by command rather than by position, and acknowledge that exact checkpoint after processing the opening; acknowledgement does not resolve attention or due notes.
