docs: volition, planning, agency and cognitive research

New documents define goal, want, intention, commitment, plan, action,
capability, authority, agency and introspection operationally, state
prominently that no operational measure establishes phenomenal
consciousness or sentience, and describe the rules, thresholds, events,
inspection points and limits of each subsystem:

- docs/volition.md: want derivation, reinforcement, decay and suppression,
  conflicts, formation and its outcomes, the intention–action gap,
  reconsideration, commitments and volition metacognition;
- docs/planning.md: plans and step kinds, validation, strategies, the
  executor, observe–act–verify, replanning, budgets, operator attention,
  long-running work, restarts and duplicates;
- docs/agency.md: the fifteen authority invariants and their tests,
  scoped authority, forensic why, attribution and the agency timeline;
- docs/cognitive-research.md: operational definitions separating
  implementation property from philosophical interpretation, experiment
  protocols (global workspace, ablation, self-model, counterfactual, model
  comparison, conflict), every measure, introspection accuracy,
  metacognitive calibration and temporal self-continuity.

Updated: interpretation table, capabilities (metadata, typed operations,
scoped grants, requests), cognition, snapshots (fork authority), security
and threat model (T14, T16, new T27–T29), architecture, README, changelog,
release notes, ADR-0012 and ADR-0013, and PLAN.md §8.10 status. The
unimplemented record_procedure internal step is removed from the
vocabulary; procedural memory is recorded when a plan completes.

docs/interpretation.md

@@ -30,7 +30,12 @@ Every psychological word used in the interface, the documentation and a mind's o
 | **working memory** | the small decaying set of items in the workspace snapshot (default nine) | admission of winners, decay per cycle | workspace page | short-term memory in a person |
 | **salience** (memory) | how strongly an item presented itself when stored: a score set by the producer | fixed at write time | memory detail | importance or truth; those are separate fields |
 | **curious / curiosity** | a drive value and an affect scalar; and the `curiosity` process that turns unexplained observations, prediction errors and contradictions into investigation goals | drive baselines from personality, modulation by events, decay | mind overview (drives), goals of kind investigation | interest or desire |
-| **wants / goal** | a row in the `goals` tree with kind, status, priority and origin | operators (tasks), curiosity (investigations), reflection (maintenance); the goal monitor updates status | mind → goals | volition; goals never grant capability |
+| **goal** | a row in the `goals` tree with kind, status, priority and origin: a desired condition against which progress is measured | operators (tasks), curiosity (investigations), reflection (maintenance); the goal monitor updates status | mind → goals | a decision to act now; goals never grant capability |
+| **wants** | a row in `wants`: a motivational preference with origin, strength that halves every six hours unless reinforced, urgency, valence and optional means ([volition.md](volition.md)) | derivation after each cycle from failed predictions, contradictions, operator and stalled goals, questions, requests and due commitments; reinforcement; decay; suppression | mind → volition → wants | desire; a want is not a plan and never implies action |
+| **intends** | a row in `intentions`: a recorded decision to pursue an outcome, with source wants, goal, commitment, supporting beliefs, expected result, priority and status | deterministic formation over wants, goals, commitments, values, policy preview and capacity; recorded reconsideration | intention page, decision ledger | will; an intention to act still waits for policy and possibly an operator |
+| **committed** | a row in `commitments`: do/refrain over matched actions, optional "unless approved", weight, due, expiry, revocability | operators; due, broken, expired, conflicting and superseded checks | mind → volition → commitments | obligation as a moral fact; commitments only restrict what the mind will do |
+| **conflict** (wants) | a row in `want_conflicts` with both sides' scores and the rule that resolved it | formation when value-derived wants oppose an action, and capacity displacement | wants page, "why" pages | inner conflict felt as such |
+| **plans** | a revisable dependency graph of validated steps serving one intention ([planning.md](planning.md)) | the planner (deterministic strategies, validated model proposals) and the executor; replans are new revisions | plan page | foresight or deliberation |
 | **drives** | eight configured scalars with ranges that scale attention weights | events through the rule table; six-hour decay | mind overview, workspace effective weights | needs; the set is closed and contains no self-preservation drive |
 | **feels / mood / valence / arousal / concern / frustration** | affect-like scalars in [0, 1] or [−1, 1] | the rule table and decay; changes above 0.1 emit `emotion_changed` with reasons | mind overview, event log | experience; the scalars exist so that their influence on attention can be studied |
 | **expects / predicts** | a row in `predictions` with a stated confidence and a due time | the prediction process; resolution against later observations | mind → predictions; belief detail shows the calibrated estimate | foresight; predictions are the only place a score is tested against outcomes |
@@ -42,6 +47,12 @@ Every psychological word used in the interface, the documentation and a mind's o
 | **dreams** | the optional idle mode that replays a deterministic sample of memories, links similar ones with low confidence and proposes speculative hypotheses | the dream schedule and allowed hours; off by default | dreams page, dream detail | imagination; dreaming never executes actions or changes authority |
 | **self-model** | the mind's stored description of itself: personality traits and values plus a capability list kept equal to the effective policy | personality edits by operators; `SelfModelSync` after policy changes, emitting `self_model_updated` | personality page, `/api/v1/minds/{mind}/selfmodel` | self-awareness; a mind cannot claim tools it does not have |
 | **metacognition** | explicit checks over the mind's own beliefs (insufficient evidence, single source, overconfidence, …) that add counter-evidence or warnings | the per-cycle process and its thresholds | mind overview warnings, metacognition events | wisdom; each check is a rule with a named threshold |
-| **decides / acts** | a proposed action passing through the capability layer to ALLOW, DENY or REQUIRE_APPROVAL | policy rows, operator approvals | approvals page, policies page, audit | agency; nothing a mind believes or is told can widen what it may do |
+| **decides / acts** | a plan step or operator invocation passing through the capability layer to ALLOW, ASK (approval) or DENY, and the recorded execution | policy rows, operator approvals, scoped grants an operator made | approvals page, policies page, audit, agency timeline | agency in the moral sense; nothing a mind wants, intends, commits to or is told can widen what it may do |
+| **caused** | an outcome event reachable by recorded links from one of the mind's executions ([agency.md](agency.md)) | provenance links written when events are recorded | "why" pages, attribution API | that nothing else contributed; merely following an action is classified separately |
+| **explains itself / introspects** | a reply rendered from recorded state and scored against it as supported, partially supported, unsupported, contradicted or unknown | the introspection intents and the scorer ([cognitive-research.md](cognitive-research.md)) | research page, measurements | self-knowledge; fluent reasons without a recorded counterpart score nothing |
 
 A report such as "I believe the pump is failing, though I am uncertain" therefore expands to: a belief row exists for that proposition, its score is in a range the introspection template calls uncertain, and its primary uncertainty is named on the belief page. The sentence is a rendering of state, and the state is the thing to check.
+
+## Research measures
+
+[cognitive-research.md](cognitive-research.md) defines attention, global broadcast, introspection, self-representation, metacognition, volition, temporal self-continuity, agency attribution, uncertainty awareness, intention, commitment and cognitive conflict as measurable implementation properties, each set beside the philosophical interpretation Noema does not assert. No operational measure establishes phenomenal consciousness or sentience.