wicked-crew 0.7.46 → 0.7.48

package/dist/decisions/events.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Decision capture's bus facts (DES-decision-capture §4.6, DC-S4a). Post-commit only; domain
+ * column `wicked-crew` (the project bus's emit). Payloads carry ids and counts, NEVER words — the
+ * engine's rule — so the operator's words stay in the 0600 ledger. Idempotency keys are
+ * type-inclusive and occurrence-unique. (`wicked.crew.rule.considered` is DC-S7's.)
+ */
+export declare const DECISION_DETECTED = "wicked.crew.decision.detected";
+export declare const DECISION_OFFERED = "wicked.crew.decision.offered";
+export declare const DECISION_REMEMBERED = "wicked.crew.decision.remembered";
+export declare const DECISION_UNDONE = "wicked.crew.decision.undone";
+export declare const DECISION_DISMISSED = "wicked.crew.decision.dismissed";
+export declare const DECISION_RESTATED = "wicked.crew.decision.restated";
+export declare const DECISION_WIDENED = "wicked.crew.decision.widened";
+/** DC-S7 (§4.6): counts and ids only — `considered:<chat>:<turn>` / `considered:<run>:<ord>:<attempt>`. */
+export declare const RULE_CONSIDERED = "wicked.crew.rule.considered";
+export interface DecisionBusEmit {
+    (type: string, payload: Record<string, unknown>, idempotencyKey: string): Promise<boolean>;
+}
+/** The fact for one decision event — the payload is ids/enums/counts only (a test pins no words). */
+export declare function decisionFact(type: string, payload: Record<string, string | number | boolean | null | undefined>, key: string): {
+    type: string;
+    payload: Record<string, string | number | boolean | null>;
+    key: string;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/decisions/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/decisions/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,iBAAiB,kCAAkC,CAAC;AACjE,eAAO,MAAM,gBAAgB,iCAAiC,CAAC;AAC/D,eAAO,MAAM,mBAAmB,oCAAoC,CAAC;AACrE,eAAO,MAAM,eAAe,gCAAgC,CAAC;AAC7D,eAAO,MAAM,kBAAkB,mCAAmC,CAAC;AACnE,eAAO,MAAM,iBAAiB,kCAAkC,CAAC;AACjE,eAAO,MAAM,gBAAgB,iCAAiC,CAAC;AAC/D,2GAA2G;AAC3G,eAAO,MAAM,eAAe,gCAAgC,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5F;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EACrE,GAAG,EAAE,MAAM,GACV;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAI1F"}

package/dist/decisions/events.js

@@ -0,0 +1,24 @@
+/**
+ * Decision capture's bus facts (DES-decision-capture §4.6, DC-S4a). Post-commit only; domain
+ * column `wicked-crew` (the project bus's emit). Payloads carry ids and counts, NEVER words — the
+ * engine's rule — so the operator's words stay in the 0600 ledger. Idempotency keys are
+ * type-inclusive and occurrence-unique. (`wicked.crew.rule.considered` is DC-S7's.)
+ */
+export const DECISION_DETECTED = 'wicked.crew.decision.detected';
+export const DECISION_OFFERED = 'wicked.crew.decision.offered';
+export const DECISION_REMEMBERED = 'wicked.crew.decision.remembered';
+export const DECISION_UNDONE = 'wicked.crew.decision.undone';
+export const DECISION_DISMISSED = 'wicked.crew.decision.dismissed';
+export const DECISION_RESTATED = 'wicked.crew.decision.restated';
+export const DECISION_WIDENED = 'wicked.crew.decision.widened';
+/** DC-S7 (§4.6): counts and ids only — `considered:<chat>:<turn>` / `considered:<run>:<ord>:<attempt>`. */
+export const RULE_CONSIDERED = 'wicked.crew.rule.considered';
+/** The fact for one decision event — the payload is ids/enums/counts only (a test pins no words). */
+export function decisionFact(type, payload, key) {
+    const clean = {};
+    for (const [k, v] of Object.entries(payload))
+        if (v !== undefined)
+            clean[k] = v;
+    return { type, payload: clean, key };
+}
+//# sourceMappingURL=events.js.map

package/dist/decisions/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/decisions/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,+BAA+B,CAAC;AACjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AAC/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,iCAAiC,CAAC;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,6BAA6B,CAAC;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,gCAAgC,CAAC;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAG,+BAA+B,CAAC;AACjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AAC/D,2GAA2G;AAC3G,MAAM,CAAC,MAAM,eAAe,GAAG,6BAA6B,CAAC;AAM7D,qGAAqG;AACrG,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,OAAqE,EACrE,GAAW;IAEX,MAAM,KAAK,GAAqD,EAAE,CAAC;IACnE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,IAAI,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAChF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AACvC,CAAC"}

package/dist/decisions/ingest.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Where operator words enter the ledger (DES-decision-capture §4.3.1 / §4.3.2 / §4.3.3, DC-S4a + S4b).
+ *
+ * The structured hosts — a gate note, an elicitation answer, a run inject — call
+ * {@link ingestDecision} POST-COMMIT, after their action succeeded; the studio chat recorder
+ * (`chat-recorder.ts`) calls it at the end of a turn with the model's labels. Only a `human` actor is
+ * recorded: an agent's words are never a decision source (operator decision 4). `auth_mode` is the
+ * daemon's resolved auth and decides auto eligibility (§4.4). Derivation is deterministic; under
+ * `WICKED_DECISIONS=on` the record's route is then acted on (auto → `remember()`, offer → the review
+ * queue). Never throws into the host route: a failure is logged and the host's answer stands.
+ */
+import type { Actor } from '../core/types.js';
+import { type DecisionService } from './land.js';
+import type { DecisionHost, DecisionModelLabels, DecisionRecord, DecisionType } from './types.js';
+export interface HostWords {
+    host: Extract<DecisionHost, 'gate' | 'elicitation' | 'inject' | 'studio-chat'>;
+    actor: Actor;
+    /** The operator's verbatim free text ('' when the decision was a bare choice). */
+    words: string;
+    /** A bare approve/reject, or a picked elicitation option, when there were no words. */
+    choice?: string;
+    projectId: string | null;
+    /** The structured hosts: the run the words steered. */
+    runId?: string;
+    ord?: number;
+    gateId?: string;
+    elicitationId?: string;
+    /** The chat host: the chat and the turn whose operator message carried the words. */
+    chatId?: string;
+    turnId?: string;
+    /** The chat host: the recorder seat's labels for this span, and the other seats' votes. */
+    labels?: DecisionModelLabels;
+    votes?: Array<{
+        cli_key: string;
+        type: DecisionType;
+        codify: boolean;
+    }>;
+    /** The chat host, DOC-4: the proposal a go-ahead approved (the previous turn, the recorder seat). */
+    proposal?: {
+        turn_id: string;
+        cli_key: string;
+        excerpt: string;
+    } | null;
+    /**
+     * DOC-4: the decision text written from the approved proposal (+ amendment). It replaces the
+     * derived statement — a bare approval has no template of its own — while ORIGIN keeps the words.
+     */
+    statement?: string;
+}
+export declare function ingestDecision(service: DecisionService, input: HostWords): Promise<DecisionRecord | null>;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/decisions/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/decisions/ingest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAElG,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,aAAa,CAAC,CAAC;IAC/E,KAAK,EAAE,KAAK,CAAC;IACb,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACxE,qGAAqG;IACrG,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAmF/G"}

package/dist/decisions/ingest.js

@@ -0,0 +1,100 @@
+/**
+ * Where operator words enter the ledger (DES-decision-capture §4.3.1 / §4.3.2 / §4.3.3, DC-S4a + S4b).
+ *
+ * The structured hosts — a gate note, an elicitation answer, a run inject — call
+ * {@link ingestDecision} POST-COMMIT, after their action succeeded; the studio chat recorder
+ * (`chat-recorder.ts`) calls it at the end of a turn with the model's labels. Only a `human` actor is
+ * recorded: an agent's words are never a decision source (operator decision 4). `auth_mode` is the
+ * daemon's resolved auth and decides auto eligibility (§4.4). Derivation is deterministic; under
+ * `WICKED_DECISIONS=on` the record's route is then acted on (auto → `remember()`, offer → the review
+ * queue). Never throws into the host route: a failure is logged and the host's answer stands.
+ */
+import { createHash } from 'node:crypto';
+import { deriveDecision } from './derive.js';
+import { DECISION_DETECTED } from './events.js';
+import { newDecisionId } from './land.js';
+export async function ingestDecision(service, input) {
+    const { ledger, authMode, log } = service.deps;
+    if (service.mode === 'off')
+        return null;
+    // §4.3.1: only human words are recorded — an agent token writes nothing at all.
+    if (input.actor.kind !== 'human')
+        return null;
+    const words = input.words.trim();
+    if (words === '' && input.choice === undefined)
+        return null;
+    const where = input.runId !== undefined ? `run ${input.runId}` : `chat ${input.chatId ?? '?'}`;
+    try {
+        const now = service.deps.now?.() ?? Date.now();
+        const inForce = words === '' ? [] : await service.inForce(input.projectId);
+        const d = deriveDecision({
+            words,
+            actorKind: 'human',
+            authMode,
+            wordsSource: 'typed',
+            projectId: input.projectId,
+            inForce,
+            recurrence: (key) => ledger.recurrence(key),
+            ...(input.labels !== undefined ? { labels: input.labels } : {}),
+            now,
+        });
+        const statement = input.statement !== undefined && input.statement.trim() !== '' ? input.statement.trim() : d.statement;
+        const record = {
+            op: 'record',
+            v: 1,
+            id: newDecisionId(now),
+            at: now,
+            project_id: input.projectId,
+            host: input.host,
+            origin: {
+                actor: { id: input.actor.id, kind: 'human', trust: input.actor.trust },
+                auth_mode: authMode,
+                ...(input.chatId !== undefined ? { chat_id: input.chatId } : {}),
+                ...(input.turnId !== undefined ? { turn_id: input.turnId } : {}),
+                ...(input.runId !== undefined ? { run_id: input.runId } : {}),
+                ...(input.ord !== undefined ? { ord: input.ord } : {}),
+                ...(input.gateId !== undefined ? { gate_id: input.gateId } : {}),
+                ...(input.elicitationId !== undefined ? { elicitation_id: input.elicitationId } : {}),
+                words: d.words,
+                ...(input.choice !== undefined ? { choice: input.choice } : {}),
+                message_sha256: createHash('sha256').update(input.words).digest('hex'),
+                proposal: input.proposal ?? null,
+                words_source: 'typed',
+                redacted: d.redacted,
+            },
+            labels: {
+                ...(input.labels !== undefined ? { model: input.labels } : {}),
+                ...(input.votes !== undefined && input.votes.length > 0 ? { votes: input.votes } : {}),
+                deterministic: { template: d.template, exclusions: d.exclusions, dgc: d.dgc, recurrence: d.recurrence },
+            },
+            derived: {
+                statement,
+                polarity: d.polarity,
+                key: d.key,
+                scope: d.scope,
+                steering_type: d.steering_type,
+            },
+            route: d.route,
+            ...(d.rule_ref !== undefined ? { rule_ref: d.rule_ref } : {}),
+        };
+        ledger.appendRecord(record);
+        const emit = service.deps.emit;
+        if (emit !== null && emit !== undefined) {
+            await emit(DECISION_DETECTED, {
+                decision_id: record.id,
+                project_id: record.project_id,
+                host: record.host,
+                type: input.choice !== undefined && words === '' ? 'choice' : (d.template ?? 'none'),
+                route: record.route,
+                template: d.template,
+            }, `detected:${record.id}`).catch((err) => log?.(`[decisions] emit detected failed: ${err instanceof Error ? err.message : String(err)}`));
+        }
+        await service.act(record);
+        return record;
+    }
+    catch (err) {
+        log?.(`[decisions] recording ${input.host} words for ${where} failed: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+//# sourceMappingURL=ingest.js.map

package/dist/decisions/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../src/decisions/ingest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAwB,MAAM,WAAW,CAAC;AA+BhE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAwB,EAAE,KAAgB;IAC7E,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAC/C,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACxC,gFAAgF;IAChF,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;IAC/F,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC3E,MAAM,CAAC,GAAG,cAAc,CAAC;YACvB,KAAK;YACL,SAAS,EAAE,OAAO;YAClB,QAAQ;YACR,WAAW,EAAE,OAAO;YACpB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO;YACP,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;YAC3C,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG;SACJ,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxH,MAAM,MAAM,GAAmB;YAC7B,EAAE,EAAE,QAAQ;YACZ,CAAC,EAAE,CAAC;YACJ,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC;YACtB,EAAE,EAAE,GAAG;YACP,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE;gBACN,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE;gBACtE,SAAS,EAAE,QAAQ;gBACnB,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtD,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrF,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/D,cAAc,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBACtE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;gBAChC,YAAY,EAAE,OAAO;gBACrB,QAAQ,EAAE,CAAC,CAAC,QAAQ;aACrB;YACD,MAAM,EAAE;gBACN,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9D,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtF,aAAa,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE;aACxG;YACD,OAAO,EAAE;gBACP,SAAS;gBACT,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,aAAa,EAAE,CAAC,CAAC,aAAa;aAC/B;YACD,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC;QACF,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/B,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,IAAI,CACR,iBAAiB,EACjB;gBACE,WAAW,EAAE,MAAM,CAAC,EAAE;gBACtB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC;gBACpF,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ,EAAE,CAAC,CAAC,QAAQ;aACrB,EACD,YAAY,MAAM,CAAC,EAAE,EAAE,CACxB,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,qCAAqC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5H,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,EAAE,CAAC,yBAAyB,KAAK,CAAC,IAAI,cAAc,KAAK,YAAY,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5H,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/decisions/land.d.ts

@@ -0,0 +1,100 @@
+/**
+ * The ONE landing path for decisions (DES-decision-capture §4.5, DC-S4a): `remember()` and its
+ * siblings `undo` / `dismiss` / `widen` / `same`, plus the act-on-route step `ingest` hands over.
+ *
+ * Every landing — auto, the chip, Needs You, and `POST /proposals/:id/approve` of a proposal this
+ * ledger filed — goes through `remember()`, and the human check lives INSIDE it (actor kind
+ * `human` ∧ trust ≥ operator), so no route branch can skip it. Words, actor and ORIGIN come from
+ * the ledger, never from a proposal payload (which carries only the decision id).
+ */
+import type { CoreAdapter } from '../core/adapter.js';
+import type { Actor, DecisionChangedFrame, SteeringType } from '../core/types.js';
+import { type AuthMode } from '../api/auth.js';
+import type { AuditLog } from '../api/audit.js';
+import type { InForceRule } from './derive.js';
+import { type DecisionBusEmit } from './events.js';
+import type { DecisionLedger } from './ledger.js';
+import type { DecisionDismissReason, DecisionRecord, DecisionsMode } from './types.js';
+/** A refusal with its HTTP status (403 human check, 404 unknown, 409 wrong state, 502 upstream). */
+export declare class DecisionError extends Error {
+    readonly status: 400 | 403 | 404 | 409 | 501 | 502;
+    constructor(status: 400 | 403 | 404 | 409 | 501 | 502, message: string);
+}
+export interface DecisionDeps {
+    ledger: DecisionLedger;
+    mode: DecisionsMode;
+    authMode: AuthMode;
+    estateTool: (tool: string, args: Record<string, unknown>) => Promise<unknown>;
+    adapter: Pick<CoreAdapter, 'projectRulesSupported' | 'upsertConformanceRule' | 'readConformanceRule' | 'retireConformanceRule' | 'listConformanceRules'> & Partial<Pick<CoreAdapter, 'considerRules'>>;
+    audit: AuditLog;
+    emit?: DecisionBusEmit | null;
+    broadcast?: (frame: DecisionChangedFrame) => void;
+    log?: (msg: string) => void;
+    now?: () => number;
+}
+export interface RememberEdits {
+    statement?: string;
+    scope?: 'project' | 'everywhere';
+    steering_type?: SteeringType;
+}
+/** `dec_` + a uuid v7-shaped id: a 48-bit ms timestamp prefix so ids sort by time. */
+export declare function newDecisionId(now?: number): string;
+export declare class DecisionService {
+    readonly deps: DecisionDeps;
+    constructor(deps: DecisionDeps);
+    get mode(): DecisionsMode;
+    private readonly inFlight;
+    /** Per-decision serialization: two concurrent writes on one decision never both land (codex). */
+    private readonly locks;
+    private locked;
+    /** Run host-side work off the request path (`void`), tracked so tests and shutdown can await it. */
+    track(work: Promise<unknown>): void;
+    /** Resolves once every tracked host recording has settled. */
+    idle(): Promise<void>;
+    private now;
+    private log;
+    private requireHuman;
+    private requireRecord;
+    private viewOf;
+    private fact;
+    private changed;
+    private outcome;
+    /** The in-force rules for a project (this project's and the global ones). Fail-soft: `[]` + a log. */
+    inForce(projectId: string | null): Promise<InForceRule[]>;
+    /** Act on a record's route. Never throws: a failure is a `landing_failed` outcome + a log. */
+    act(record: DecisionRecord): Promise<void>;
+    /** Re-drive records whose route asks for an action but which have no outcome (a restart mid-landing). */
+    redrive(): Promise<number>;
+    /** The review-queue proposal already filed for a decision (idempotent re-drive), or `null`. */
+    private proposalFor;
+    private submitProposal;
+    /** File the decision into the review queue (the chip + its Needs You row are the same object). */
+    offer(record: DecisionRecord): Promise<string>;
+    private offerLocked;
+    remember(id: string, actor: Actor, opts: {
+        how: 'auto' | 'chip' | 'needs-you';
+        edits?: RememberEdits;
+    }): Promise<{
+        rule_id: string;
+        proposal_id: string;
+        project?: string;
+    }>;
+    private rememberLocked;
+    private isApproved;
+    /** Approve a proposal; one already approved (a re-drive after a crash) is not an error. */
+    private approve;
+    undo(id: string, actor: Actor): Promise<void>;
+    private undoLocked;
+    dismiss(id: string, actor: Actor, reason: DecisionDismissReason): Promise<void>;
+    private dismissLocked;
+    /** B7 "Same as your rule '…'? · Same · New rule" — resolves a `maybe-restated` decision. */
+    same(id: string, actor: Actor, same: boolean): Promise<{
+        rule_id?: string;
+    }>;
+    private sameLocked;
+    /** B8: one project-less successor that supersedes the same rule in every project. */
+    widen(id: string, actor: Actor): Promise<{
+        rule_id: string;
+    }>;
+}
+//# sourceMappingURL=land.d.ts.map

package/dist/decisions/land.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"land.d.ts","sourceRoot":"","sources":["../../src/decisions/land.ts"],"names":[],"mappings":"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"}