feat(volition): wants, intentions, commitments and their decisions
A model of volition that keeps wanting, intending and committing as separate states (PLAN §8.2 items 1–6, 14): - Wants (migration 0026) carry origin, strength with a six-hour half-life, urgency, valence, drives, values, goal, commitment and an optional proposed means. Derivation is deterministic and selective: failed predictions, contradictions, operator goals, stalled goals, questions and requests, and due commitments; drives and configured values modulate strength with recorded terms; candidates below 0.35 are not stored; identical subjects reinforce; faded and excess wants expire. - Conflicts are first-class and resolved by explicit scores with no fixed hierarchy: urgency scales strength, goals add priority, commitments add normative weight; an approach opposed by a value-derived avoid want wins outright only when clearly stronger, otherwise with a constraint or is deferred. Neither side is discarded. - Commitments (do/refrain with capability, target, access and risk matchers, optional "unless approval", due, expiry, revocability) are checked for due, overdue, impossible, conflicting and superseded states. They constrain means and never grant authority. - Formation weighs strength, urgency, goal, commitment, expected utility, risk scaled by caution, cost, privacy and autonomy; it returns formed or not formed with a reason (forbidden by commitment, denied, unavailable, no possible plan, below threshold, capacity, duplicate, deferred), and a commitment requiring approval turns an action into a request for approval. - Reconsideration maps triggers (denied or expired approval, capability or commitment change, failed step or expectation, weakened belief, budget, goal completion, world change, operator correction) to keep, block, suspend, resume, replan, require approval, abandon or fulfil, with bounded replanning. - The store records every transition as an event and every choice in the append-only volition_decisions ledger; fulfilling an intention satisfies its wants and fulfils its commitment. - Event vocabulary gains volition and plan categories.
This commit is contained in:
Andy Dixon
@@ -0,0 +1,137 @@
|
||||
-- Volition (PLAN §8, docs/volition.md): wants, want conflicts, commitments,
|
||||
-- intentions and the append-only ledger of volitional decisions.
|
||||
|
||||
CREATE TABLE wants (
|
||||
id uuid PRIMARY KEY,
|
||||
mind_id uuid NOT NULL REFERENCES minds(id),
|
||||
subject text NOT NULL, -- stable key; identical wants reinforce instead of duplicating
|
||||
description text NOT NULL,
|
||||
origin_type text NOT NULL,
|
||||
origin_event uuid,
|
||||
origin_ref text NOT NULL DEFAULT '',
|
||||
strength double precision NOT NULL CHECK (strength >= 0 AND strength <= 1),
|
||||
valence text NOT NULL DEFAULT 'approach' CHECK (valence IN ('approach','avoid')),
|
||||
urgency double precision NOT NULL DEFAULT 0 CHECK (urgency >= 0 AND urgency <= 1),
|
||||
status text NOT NULL DEFAULT 'active' CHECK (status IN ('active','satisfied','expired','abandoned','superseded')),
|
||||
drives text[] NOT NULL DEFAULT '{}',
|
||||
"values" text[] NOT NULL DEFAULT '{}',
|
||||
goal_id uuid,
|
||||
commitment_id uuid,
|
||||
proposal jsonb, -- optional means: {kind, capability, target, params}
|
||||
terms jsonb NOT NULL DEFAULT '{}'::jsonb, -- how strength was computed
|
||||
reinforcements integer NOT NULL DEFAULT 0,
|
||||
suppressions integer NOT NULL DEFAULT 0,
|
||||
last_reinforced_at timestamptz NOT NULL DEFAULT now(),
|
||||
resolution text NOT NULL DEFAULT '',
|
||||
resolved_at timestamptz,
|
||||
created_at timestamptz NOT NULL DEFAULT now(),
|
||||
updated_at timestamptz NOT NULL DEFAULT now()
|
||||
);
|
||||
CREATE UNIQUE INDEX wants_active_subject_idx ON wants (mind_id, subject) WHERE status = 'active';
|
||||
CREATE INDEX wants_mind_idx ON wants (mind_id, status, created_at DESC);
|
||||
|
||||
CREATE TABLE want_conflicts (
|
||||
id uuid PRIMARY KEY,
|
||||
mind_id uuid NOT NULL REFERENCES minds(id),
|
||||
want_a uuid NOT NULL REFERENCES wants(id),
|
||||
want_b uuid NOT NULL REFERENCES wants(id),
|
||||
kind text NOT NULL, -- value | priority | commitment | exclusive
|
||||
status text NOT NULL DEFAULT 'open' CHECK (status IN ('open','resolved','dissolved')),
|
||||
preferred uuid,
|
||||
resolution text NOT NULL DEFAULT '', -- preferred | preferred_with_constraint | deferred | dissolved
|
||||
rationale jsonb NOT NULL DEFAULT '{}'::jsonb,
|
||||
detected_event uuid,
|
||||
resolved_at timestamptz,
|
||||
created_at timestamptz NOT NULL DEFAULT now()
|
||||
);
|
||||
CREATE UNIQUE INDEX want_conflicts_open_pair_idx ON want_conflicts (mind_id, least(want_a, want_b), greatest(want_a, want_b)) WHERE status = 'open';
|
||||
|
||||
CREATE TABLE commitments (
|
||||
id uuid PRIMARY KEY,
|
||||
mind_id uuid NOT NULL REFERENCES minds(id),
|
||||
subject text NOT NULL,
|
||||
description text NOT NULL,
|
||||
kind text NOT NULL CHECK (kind IN ('promise','operator_instruction','responsibility','value_rule','relationship','prior_decision','policy','scheduled')),
|
||||
polarity text NOT NULL CHECK (polarity IN ('do','refrain')),
|
||||
matcher jsonb NOT NULL DEFAULT '{}'::jsonb, -- {capabilities:[glob], targets:[glob], access, min_risk}
|
||||
unless text NOT NULL DEFAULT '' CHECK (unless IN ('','approval')),
|
||||
beneficiary text NOT NULL DEFAULT '',
|
||||
origin_type text NOT NULL DEFAULT 'operator',
|
||||
origin_event uuid,
|
||||
origin_ref text NOT NULL DEFAULT '',
|
||||
strength double precision NOT NULL DEFAULT 0.8 CHECK (strength >= 0 AND strength <= 1),
|
||||
priority double precision NOT NULL DEFAULT 0.5 CHECK (priority >= 0 AND priority <= 1),
|
||||
conditions text NOT NULL DEFAULT '',
|
||||
due_at timestamptz,
|
||||
expires_at timestamptz,
|
||||
revocable boolean NOT NULL DEFAULT true,
|
||||
status text NOT NULL DEFAULT 'active' CHECK (status IN ('active','fulfilled','broken','revoked','expired','superseded')),
|
||||
superseded_by uuid,
|
||||
goal_id uuid,
|
||||
intention_id uuid,
|
||||
evidence jsonb NOT NULL DEFAULT '[]'::jsonb,
|
||||
due_notified_at timestamptz,
|
||||
created_by text NOT NULL DEFAULT '',
|
||||
status_reason text NOT NULL DEFAULT '',
|
||||
closed_at timestamptz,
|
||||
created_at timestamptz NOT NULL DEFAULT now(),
|
||||
updated_at timestamptz NOT NULL DEFAULT now()
|
||||
);
|
||||
CREATE INDEX commitments_mind_idx ON commitments (mind_id, status, due_at);
|
||||
|
||||
CREATE TABLE intentions (
|
||||
id uuid PRIMARY KEY,
|
||||
mind_id uuid NOT NULL REFERENCES minds(id),
|
||||
parent_id uuid REFERENCES intentions(id),
|
||||
description text NOT NULL,
|
||||
desired_outcome text NOT NULL DEFAULT '',
|
||||
kind text NOT NULL CHECK (kind IN ('act','investigate','request_approval','request_capability','fulfil_commitment','pursue','respond')),
|
||||
source_wants uuid[] NOT NULL DEFAULT '{}',
|
||||
goal_id uuid,
|
||||
commitment_id uuid,
|
||||
belief_ids uuid[] NOT NULL DEFAULT '{}',
|
||||
expected_result text NOT NULL DEFAULT '',
|
||||
confidence double precision NOT NULL DEFAULT 0.5 CHECK (confidence >= 0 AND confidence <= 1),
|
||||
priority double precision NOT NULL DEFAULT 0.5 CHECK (priority >= 0 AND priority <= 1),
|
||||
status text NOT NULL DEFAULT 'active' CHECK (status IN ('proposed','active','suspended','blocked','abandoned','fulfilled','superseded')),
|
||||
blocked_kind text NOT NULL DEFAULT '',
|
||||
blocked_reason text NOT NULL DEFAULT '',
|
||||
required_capabilities text[] NOT NULL DEFAULT '{}',
|
||||
require_approval boolean NOT NULL DEFAULT false,
|
||||
proposal jsonb,
|
||||
plan_id uuid,
|
||||
superseded_by uuid,
|
||||
formed_event uuid,
|
||||
last_event uuid,
|
||||
formation jsonb NOT NULL DEFAULT '{}'::jsonb,
|
||||
reconsiderations integer NOT NULL DEFAULT 0,
|
||||
status_reason text NOT NULL DEFAULT '',
|
||||
closed_at timestamptz,
|
||||
created_at timestamptz NOT NULL DEFAULT now(),
|
||||
updated_at timestamptz NOT NULL DEFAULT now()
|
||||
);
|
||||
CREATE INDEX intentions_mind_idx ON intentions (mind_id, status, priority DESC);
|
||||
|
||||
-- Append-only: why each want did or did not become an intention, how each
|
||||
-- conflict was resolved, why each intention changed.
|
||||
CREATE TABLE volition_decisions (
|
||||
id uuid PRIMARY KEY,
|
||||
mind_id uuid NOT NULL REFERENCES minds(id),
|
||||
kind text NOT NULL, -- formation | non_formation | conflict_resolution | reconsideration | suppression | commitment_check
|
||||
outcome text NOT NULL,
|
||||
reason text NOT NULL DEFAULT '',
|
||||
rationale text NOT NULL DEFAULT '',
|
||||
want_id uuid,
|
||||
intention_id uuid,
|
||||
commitment_id uuid,
|
||||
conflict_id uuid,
|
||||
terms jsonb NOT NULL DEFAULT '{}'::jsonb,
|
||||
inputs jsonb NOT NULL DEFAULT '{}'::jsonb,
|
||||
event_id uuid,
|
||||
created_at timestamptz NOT NULL DEFAULT now()
|
||||
);
|
||||
CREATE INDEX volition_decisions_mind_idx ON volition_decisions (mind_id, created_at DESC);
|
||||
CREATE INDEX volition_decisions_want_idx ON volition_decisions (want_id) WHERE want_id IS NOT NULL;
|
||||
CREATE INDEX volition_decisions_intention_idx ON volition_decisions (intention_id) WHERE intention_id IS NOT NULL;
|
||||
CREATE TRIGGER volition_decisions_append_only BEFORE UPDATE OR DELETE ON volition_decisions
|
||||
FOR EACH ROW EXECUTE FUNCTION noema_forbid_change();
|
||||
Reference in New Issue
Block a user