wicked-crew 0.7.46 → 0.7.48

package/dist/decisions/ledger.js

@@ -0,0 +1,246 @@
+/**
+ * The decision ledger AT REST (DES-decision-capture §4.2.1, DC-S4a).
+ *
+ * One append-only JSONL file per project at `<state home>/decisions/<projectId|_unscoped>.jsonl`:
+ * the directory 0700, each file 0600 — the posture of the chat transcripts (`chat-transcripts.ts`).
+ * The words live HERE and nowhere else crew writes (never the bus, logs or `/diagnostics`).
+ * Registered in `tests/fixtures/state-home-subtrees.json` as `decisions` (crew half) — the core half,
+ * the worker Read fence, shipped with wicked-core-ts 0.7.35 — so a worker cannot read the operator's
+ * words through the file system.
+ *
+ * Reads fold `record` + `outcome` lines into a {@link DecisionView}; the in-memory index is built
+ * once at first use and kept current by `append`.
+ */
+import { appendFileSync, chmodSync, existsSync, mkdirSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { crewStateHome } from '../projects/state-home.js';
+/** The state-home entry (`<state home>/decisions/`) — the name the fixture registers. */
+export const DECISIONS_DIRNAME = 'decisions';
+const UNSCOPED = '_unscoped';
+/** A project id admitted as a file name — anything else is filed under a hashed-safe spelling. */
+const SAFE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+export function defaultDecisionsDir() {
+    return join(crewStateHome(), 'decisions');
+}
+export class DecisionLedger {
+    dir;
+    loaded = false;
+    byId = new Map();
+    /** decision key → ids, in record order (recurrence + widen). */
+    byKey = new Map();
+    /** estate proposal id → decision id (B12: answering either one resolves both). */
+    byProposal = new Map();
+    constructor(dir = defaultDecisionsDir()) {
+        this.dir = dir;
+    }
+    fileFor(projectId) {
+        const name = projectId === null ? UNSCOPED : SAFE_NAME.test(projectId) ? projectId : `p_${Buffer.from(projectId).toString('hex').slice(0, 120)}`;
+        return join(this.dir, `${name}.jsonl`);
+    }
+    load() {
+        if (this.loaded)
+            return;
+        this.loaded = true;
+        if (!existsSync(this.dir))
+            return;
+        for (const entry of readdirSync(this.dir).sort()) {
+            if (!entry.endsWith('.jsonl'))
+                continue;
+            const file = join(this.dir, entry);
+            const text = readFileSync(file, 'utf8');
+            // A torn last line (a crash mid-append) is terminated, so the next append starts a fresh
+            // line instead of being glued onto it and lost on the next load (codex on DC-S4a).
+            if (text !== '' && !text.endsWith('\n'))
+                appendFileSync(file, '\n', { mode: 0o600 });
+            for (const line of text.split('\n')) {
+                if (line.trim() === '')
+                    continue;
+                try {
+                    this.index(JSON.parse(line));
+                }
+                catch {
+                    // A torn last line (crash mid-append) is skipped; every complete line still folds.
+                }
+            }
+        }
+    }
+    index(line) {
+        if (line.op === 'record') {
+            if (this.byId.has(line.id))
+                return;
+            this.byId.set(line.id, { record: line, outcomes: [] });
+            if (line.derived.key !== null) {
+                const ids = this.byKey.get(line.derived.key) ?? [];
+                ids.push(line.id);
+                this.byKey.set(line.derived.key, ids);
+            }
+            return;
+        }
+        const folded = this.byId.get(line.id);
+        if (folded === undefined)
+            return;
+        folded.outcomes.push(line);
+        if (line.proposal_id !== undefined)
+            this.byProposal.set(line.proposal_id, line.id);
+    }
+    write(projectId, line) {
+        mkdirSync(this.dir, { recursive: true, mode: 0o700 });
+        chmodSync(this.dir, 0o700);
+        const file = this.fileFor(projectId);
+        appendFileSync(file, `${JSON.stringify(line)}\n`, { mode: 0o600 });
+        chmodSync(file, 0o600);
+    }
+    appendRecord(record) {
+        this.load();
+        this.write(record.project_id, record);
+        this.index(record);
+    }
+    appendOutcome(outcome) {
+        this.load();
+        const folded = this.byId.get(outcome.id);
+        if (folded === undefined)
+            throw new Error(`decision ${outcome.id} is not in the ledger`);
+        this.write(folded.record.project_id, outcome);
+        this.index(outcome);
+    }
+    record(id) {
+        this.load();
+        return this.byId.get(id)?.record ?? null;
+    }
+    outcomes(id) {
+        this.load();
+        return [...(this.byId.get(id)?.outcomes ?? [])];
+    }
+    /** The decision a review-queue proposal was filed for, or `null` (an ordinary proposal). */
+    decisionForProposal(proposalId) {
+        this.load();
+        return this.byProposal.get(proposalId) ?? null;
+    }
+    /** Prior records with this key: how often, since when, and in which projects. */
+    recurrence(key) {
+        this.load();
+        const ids = this.byKey.get(key);
+        if (ids === undefined || ids.length === 0)
+            return null;
+        const records = ids.map((i) => this.byId.get(i)?.record).filter((r) => r !== undefined);
+        const projects = [...new Set(records.map((r) => r.project_id).filter((p) => p !== null))].sort();
+        return { count: records.length, first_at: Math.min(...records.map((r) => r.at)), projects };
+    }
+    /** Remembered, not undone decisions with this key, newest outcome last. */
+    rememberedWithKey(key) {
+        this.load();
+        const out = [];
+        for (const id of this.byKey.get(key) ?? []) {
+            const view = this.view(id);
+            const folded = this.byId.get(id);
+            if (view === null || folded === undefined)
+                continue;
+            if (view.state === 'remembered' && view.rule_id !== undefined)
+                out.push({ record: folded.record, rule_id: view.rule_id });
+        }
+        return out;
+    }
+    /** Records whose route asks for an action but carry no outcome yet (the restart re-drive). */
+    pending() {
+        this.load();
+        return [...this.byId.values()]
+            .filter((f) => f.outcomes.length === 0 && f.record.route !== 'ledger')
+            .map((f) => f.record);
+    }
+    view(id) {
+        this.load();
+        const folded = this.byId.get(id);
+        if (folded === undefined)
+            return null;
+        return foldView(folded, this);
+    }
+    list(filter = {}) {
+        this.load();
+        const out = [];
+        for (const folded of this.byId.values()) {
+            const r = folded.record;
+            if (filter.project !== undefined && r.project_id !== filter.project)
+                continue;
+            if (filter.chat !== undefined && r.origin.chat_id !== filter.chat)
+                continue;
+            if (filter.run !== undefined && r.origin.run_id !== filter.run)
+                continue;
+            if (filter.since !== undefined && r.at < filter.since)
+                continue;
+            const view = foldView(folded, this);
+            if (filter.state !== undefined && view.state !== filter.state)
+                continue;
+            out.push(view);
+        }
+        return out.sort((a, b) => b.at - a.at || (a.id < b.id ? 1 : -1));
+    }
+}
+function foldView(folded, ledger) {
+    const r = folded.record;
+    const view = {
+        id: r.id,
+        at: r.at,
+        project_id: r.project_id,
+        host: r.host,
+        origin: {
+            actor: r.origin.actor,
+            auth_mode: r.origin.auth_mode,
+            ...(r.origin.run_id !== undefined ? { run_id: r.origin.run_id } : {}),
+            ...(r.origin.ord !== undefined ? { ord: r.origin.ord } : {}),
+            ...(r.origin.gate_id !== undefined ? { gate_id: r.origin.gate_id } : {}),
+            ...(r.origin.elicitation_id !== undefined ? { elicitation_id: r.origin.elicitation_id } : {}),
+            ...(r.origin.chat_id !== undefined ? { chat_id: r.origin.chat_id } : {}),
+            ...(r.origin.turn_id !== undefined ? { turn_id: r.origin.turn_id } : {}),
+            words: r.origin.words,
+            ...(r.origin.choice !== undefined ? { choice: r.origin.choice } : {}),
+            words_source: r.origin.words_source,
+            redacted: r.origin.redacted,
+        },
+        derived: {
+            statement: r.derived.statement,
+            polarity: r.derived.polarity,
+            key: r.derived.key,
+            scope: r.derived.scope,
+            steering_type: r.derived.steering_type,
+            template: r.labels.deterministic.template,
+            exclusions: r.labels.deterministic.exclusions,
+        },
+        route: r.route,
+        state: 'recorded',
+        ...(r.route === 'conflict' && r.rule_ref !== undefined ? { conflicts_rule_id: r.rule_ref } : {}),
+        ...((r.route === 'restated' || r.route === 'maybe-restated') && r.rule_ref !== undefined ? { restates_rule_id: r.rule_ref } : {}),
+    };
+    for (const o of folded.outcomes) {
+        view.state = o.state;
+        if (o.how !== undefined)
+            view.how = o.how;
+        if (o.proposal_id !== undefined)
+            view.proposal_id = o.proposal_id;
+        if (o.rule_id !== undefined)
+            view.rule_id = o.rule_id;
+        if (o.restates_rule_id !== undefined)
+            view.restates_rule_id = o.restates_rule_id;
+        if (o.edits !== undefined) {
+            const edits = { ...(view.edits ?? {}) };
+            if (o.edits.statement !== undefined)
+                edits.statement = o.edits.statement;
+            if (o.edits.scope !== undefined)
+                edits.scope = o.edits.scope;
+            if (o.edits.steering_type !== undefined)
+                edits.steering_type = o.edits.steering_type;
+            view.edits = edits;
+        }
+        if (o.state === 'landing_failed' && o.error !== undefined)
+            view.error = o.error;
+        else
+            delete view.error;
+    }
+    // B8: the same key decided in ≥ 2 projects → offer "Make it apply everywhere".
+    if (r.derived.key !== null && r.project_id !== null && view.state !== 'widened') {
+        const projects = ledger.recurrence(r.derived.key)?.projects ?? [];
+        if (projects.length >= 2)
+            view.widen = { projects };
+    }
+    return view;
+}
+//# sourceMappingURL=ledger.js.map

package/dist/decisions/ledger.js.map

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

package/dist/decisions/routes.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `/decisions` (DES-decision-capture §4.6, DC-S4a; api-types 0.80.0). Every route is operator+,
+ * including the GET (the words are the operator's, review N11), and every write additionally passes
+ * the human check inside `remember()` & co. No endpoint takes words for a new decision: words
+ * enter only through the operator routes (gate, elicitation, inject; chat in DC-S4b).
+ */
+import type { FastifyInstance } from 'fastify';
+import { type DecisionService } from './land.js';
+export declare function registerDecisionRoutes(app: FastifyInstance, service: DecisionService): void;
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/decisions/routes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAM7E,OAAO,EAAiB,KAAK,eAAe,EAAsB,MAAM,WAAW,CAAC;AAkBpF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CA8H3F"}

package/dist/decisions/routes.js

@@ -0,0 +1,141 @@
+/**
+ * `/decisions` (DES-decision-capture §4.6, DC-S4a; api-types 0.80.0). Every route is operator+,
+ * including the GET (the words are the operator's, review N11), and every write additionally passes
+ * the human check inside `remember()` & co. No endpoint takes words for a new decision: words
+ * enter only through the operator routes (gate, elicitation, inject; chat in DC-S4b).
+ */
+import { z } from 'zod';
+import { LOCAL_ACTOR, trustAtLeast } from '../api/auth.js';
+import { API_PREFIX } from '../api/api-prefix.js';
+import { DecisionError } from './land.js';
+const V = API_PREFIX;
+const STEERING = z.enum(['architecture', 'development', 'security', 'testing', 'operations', 'compliance', 'design-ux']);
+const RememberSchema = z
+    .object({
+    scope: z.enum(['project', 'everywhere']).optional(),
+    steering_type: STEERING.optional(),
+    statement: z.string().trim().min(1).max(500).optional(),
+})
+    .strict();
+const DismissSchema = z
+    .object({ reason: z.enum(['not-a-rule', 'one-off', 'wrong-type', 'wrong-scope', 'not-the-same', 'undone']) })
+    .strict();
+const SameSchema = z.object({ same: z.boolean() }).strict();
+const STATES = new Set(['recorded', 'offered', 'remembered', 'undone', 'dismissed', 'restated', 'widened', 'landing_failed']);
+export function registerDecisionRoutes(app, service) {
+    const actorOf = (req) => req.actor ?? LOCAL_ACTOR;
+    const refuse = (reply, err) => {
+        if (err instanceof DecisionError)
+            return reply.code(err.status).send({ error: err.message });
+        return reply.code(500).send({ error: err instanceof Error ? err.message : String(err) });
+    };
+    const operatorOnly = (req, reply) => {
+        const actor = actorOf(req);
+        if (trustAtLeast(actor, 'operator'))
+            return true;
+        void reply.code(403).send({ error: `Insufficient trust: decisions require 'operator' (you are '${actor.trust}')` });
+        return false;
+    };
+    const idOf = (req) => req.params.id.trim();
+    app.get(`${V}/decisions`, { config: { manifest: { responseType: 'ListDecisionsResponse', statusCodes: [200, 400, 403] } } }, async (req, reply) => {
+        if (!operatorOnly(req, reply))
+            return reply;
+        const q = req.query;
+        const one = (k) => {
+            const v = q[k];
+            const s = Array.isArray(v) ? v[0] : v;
+            return typeof s === 'string' && s.trim() !== '' ? s.trim() : undefined;
+        };
+        const state = one('state');
+        if (state !== undefined && !STATES.has(state)) {
+            return reply.code(400).send({ error: `\`state\` must be one of ${[...STATES].join('|')}` });
+        }
+        const sinceRaw = one('since');
+        const since = sinceRaw !== undefined ? Number(sinceRaw) : undefined;
+        if (since !== undefined && !Number.isFinite(since)) {
+            return reply.code(400).send({ error: '`since` must be epoch milliseconds' });
+        }
+        const filter = {};
+        const project = one('project');
+        const chat = one('chat');
+        const run = one('run');
+        if (project !== undefined)
+            filter.project = project;
+        if (chat !== undefined)
+            filter.chat = chat;
+        if (run !== undefined)
+            filter.run = run;
+        if (state !== undefined)
+            filter.state = state;
+        if (since !== undefined)
+            filter.since = since;
+        const body = {
+            decisions: service.deps.ledger.list(filter),
+            mode: service.mode,
+        };
+        return body;
+    });
+    app.post(`${V}/decisions/:id/remember`, {
+        config: {
+            manifest: { requestType: 'RememberDecisionBody', responseType: 'RememberDecisionResponse', statusCodes: [200, 400, 403, 404, 409, 502] },
+        },
+    }, async (req, reply) => {
+        const parsed = RememberSchema.safeParse(req.body ?? {});
+        if (!parsed.success)
+            return reply.code(400).send({ error: parsed.error.issues.map((i) => i.message).join('; ') });
+        try {
+            const edits = {};
+            if (parsed.data.statement !== undefined)
+                edits.statement = parsed.data.statement;
+            if (parsed.data.scope !== undefined)
+                edits.scope = parsed.data.scope;
+            if (parsed.data.steering_type !== undefined)
+                edits.steering_type = parsed.data.steering_type;
+            return await service.remember(idOf(req), actorOf(req), { how: 'chip', edits });
+        }
+        catch (err) {
+            return refuse(reply, err);
+        }
+    });
+    app.post(`${V}/decisions/:id/undo`, { config: { manifest: { responseType: '{ ok: true }', statusCodes: [200, 403, 404, 409, 502] } } }, async (req, reply) => {
+        try {
+            await service.undo(idOf(req), actorOf(req));
+            return { ok: true };
+        }
+        catch (err) {
+            return refuse(reply, err);
+        }
+    });
+    app.post(`${V}/decisions/:id/dismiss`, { config: { manifest: { requestType: 'DismissDecisionBody', responseType: '{ ok: true }', statusCodes: [200, 400, 403, 404, 409, 502] } } }, async (req, reply) => {
+        const parsed = DismissSchema.safeParse(req.body ?? {});
+        if (!parsed.success)
+            return reply.code(400).send({ error: parsed.error.issues.map((i) => i.message).join('; ') });
+        try {
+            await service.dismiss(idOf(req), actorOf(req), parsed.data.reason);
+            return { ok: true };
+        }
+        catch (err) {
+            return refuse(reply, err);
+        }
+    });
+    app.post(`${V}/decisions/:id/widen`, { config: { manifest: { responseType: '{ rule_id: string }', statusCodes: [200, 403, 404, 409, 502] } } }, async (req, reply) => {
+        try {
+            return await service.widen(idOf(req), actorOf(req));
+        }
+        catch (err) {
+            return refuse(reply, err);
+        }
+    });
+    app.post(`${V}/decisions/:id/same`, { config: { manifest: { requestType: 'SameDecisionBody', responseType: '{ rule_id?: string }', statusCodes: [200, 400, 403, 404, 409, 502] } } }, async (req, reply) => {
+        const parsed = SameSchema.safeParse(req.body ?? {});
+        if (!parsed.success)
+            return reply.code(400).send({ error: parsed.error.issues.map((i) => i.message).join('; ') });
+        try {
+            return await service.same(idOf(req), actorOf(req), parsed.data.same);
+        }
+        catch (err) {
+            return refuse(reply, err);
+        }
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/decisions/routes.js.map

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

package/dist/decisions/rules-text.d.ts

@@ -0,0 +1,21 @@
+/**
+ * How seats learn the rules (DES-decision-capture §4.7, DC-S7) — the text halves, pure.
+ *
+ *  - The chat scope statement lists the chat project's in-force rules as `[rule:<id>] statement`
+ *    lines, severity-ordered and capped at {@link RULES_STATEMENT_CAP}.
+ *  - A rule remembered mid-chat reaches the seats as a crew-authored `wicked-context` preface on
+ *    the next send, disclosed to the operator as a `system` transcript record.
+ *
+ * Both tell the seat to cite a rule it follows as `[rule:<id>]`, and both say what crew does with
+ * that: shows it as cited — unchecked. Nothing here (and nothing anywhere in crew) turns a citation into
+ * a compliance verdict; that belongs to DES-rule-check (B4).
+ */
+import type { ConformanceRule } from '../core/types.js';
+export declare const RULES_STATEMENT_CAP = 20;
+/** Severity first (critical → info), then id — a stable order a seat and an operator both read. */
+export declare function orderBySeverity<T extends Pick<ConformanceRule, 'id' | 'severity'>>(rules: ReadonlyArray<T>): T[];
+/** The `## Rules in force` section of the scope statement (no trailing blank line). */
+export declare function rulesStatementLines(rules: ReadonlyArray<ConformanceRule>): string[];
+/** The preface a send carries when rules landed since the seats last heard from crew. */
+export declare function rulesPreface(rules: ReadonlyArray<ConformanceRule>): string;
+//# sourceMappingURL=rules-text.d.ts.map

package/dist/decisions/rules-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-text.d.ts","sourceRoot":"","sources":["../../src/decisions/rules-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAItC,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,CAAC,SAAS,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,UAAU,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAEhH;AAMD,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,MAAM,EAAE,CAgBnF;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,MAAM,CAQ1E"}

package/dist/decisions/rules-text.js

@@ -0,0 +1,50 @@
+/**
+ * How seats learn the rules (DES-decision-capture §4.7, DC-S7) — the text halves, pure.
+ *
+ *  - The chat scope statement lists the chat project's in-force rules as `[rule:<id>] statement`
+ *    lines, severity-ordered and capped at {@link RULES_STATEMENT_CAP}.
+ *  - A rule remembered mid-chat reaches the seats as a crew-authored `wicked-context` preface on
+ *    the next send, disclosed to the operator as a `system` transcript record.
+ *
+ * Both tell the seat to cite a rule it follows as `[rule:<id>]`, and both say what crew does with
+ * that: shows it as cited — unchecked. Nothing here (and nothing anywhere in crew) turns a citation into
+ * a compliance verdict; that belongs to DES-rule-check (B4).
+ */
+export const RULES_STATEMENT_CAP = 20;
+const SEVERITY_RANK = { critical: 0, error: 1, warn: 2, info: 3 };
+/** Severity first (critical → info), then id — a stable order a seat and an operator both read. */
+export function orderBySeverity(rules) {
+    return [...rules].sort((a, b) => (SEVERITY_RANK[a.severity] ?? 9) - (SEVERITY_RANK[b.severity] ?? 9) || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+}
+function oneLine(statement) {
+    return statement.replace(/\s+/gu, ' ').trim();
+}
+/** The `## Rules in force` section of the scope statement (no trailing blank line). */
+export function rulesStatementLines(rules) {
+    const ordered = orderBySeverity(rules);
+    const shown = ordered.slice(0, RULES_STATEMENT_CAP);
+    const lines = [
+        '## Rules in force',
+        '',
+        "These steering rules apply here. Where you follow one, cite it as `[rule:<id>]`; crew shows it",
+        'as cited — unchecked (a citation, never a verdict).',
+        '',
+        ...shown.map((r) => `- [rule:${r.id}] ${oneLine(r.statement)}`),
+    ];
+    if (ordered.length > shown.length) {
+        const more = ordered.length - shown.length;
+        lines.push(`- … and ${more} more rule${more === 1 ? '' : 's'} (ask for them if a step turns on one).`);
+    }
+    return lines;
+}
+/** The preface a send carries when rules landed since the seats last heard from crew. */
+export function rulesPreface(rules) {
+    const ordered = orderBySeverity(rules);
+    return [
+        '<wicked-context>',
+        `Rule${ordered.length === 1 ? '' : 's'} remembered since your last message (cite as [rule:<id>] where you follow one):`,
+        ...ordered.map((r) => `- [rule:${r.id}] ${oneLine(r.statement)}`),
+        '</wicked-context>',
+    ].join('\n');
+}
+//# sourceMappingURL=rules-text.js.map

package/dist/decisions/rules-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-text.js","sourceRoot":"","sources":["../../src/decisions/rules-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,MAAM,aAAa,GAAgD,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAE/G,mGAAmG;AACnG,MAAM,UAAU,eAAe,CAAqD,KAAuB;IACzG,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpJ,CAAC;AAED,SAAS,OAAO,CAAC,SAAiB;IAChC,OAAO,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAChD,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,mBAAmB,CAAC,KAAqC;IACvE,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG;QACZ,mBAAmB;QACnB,EAAE;QACF,gGAAgG;QAChG,qDAAqD;QACrD,EAAE;QACF,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;KAChE,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,aAAa,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,yCAAyC,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,YAAY,CAAC,KAAqC;IAChE,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO;QACL,kBAAkB;QAClB,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,iFAAiF;QACvH,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;QACjE,mBAAmB;KACpB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/decisions/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Decision capture — the ledger's shapes (DES-decision-capture §4.2.1, DC-S4a).
+ *
+ * The ledger is the ONLY source of ORIGIN: the operator's verbatim words, who typed them (a human
+ * actor — an agent's words are never recorded), and the auth mode that decides auto eligibility.
+ * One append-only JSONL file per project; a line is a `record` or an `outcome`, and a read folds
+ * them into a {@link DecisionView} (api-types 0.80.0).
+ */
+import type { DecisionDismissReason, DecisionHost, DecisionRoute, DecisionState, DecisionTemplateId, DecisionType, SteeringType, TrustLevel } from 'wicked-crew-api-types';
+export type { DecisionView } from 'wicked-crew-api-types';
+export type { DecisionDismissReason, DecisionHost, DecisionRoute, DecisionState, DecisionTemplateId, DecisionType, };
+/** The model's labels for one quoted span (the studio chat recorder, DC-S4b). Optional here. */
+export interface DecisionModelLabels {
+    is_decision: boolean;
+    type: DecisionType;
+    codify: boolean;
+    ambiguous: boolean;
+    steering_type: SteeringType;
+    same_as?: string | null;
+    approves_proposal?: boolean;
+    recorder: string;
+    model_id?: string;
+}
+export interface DecisionRecord {
+    op: 'record';
+    v: 1;
+    id: string;
+    at: number;
+    project_id: string | null;
+    host: DecisionHost;
+    origin: {
+        actor: {
+            id: string;
+            kind: 'human';
+            trust: TrustLevel;
+        };
+        auth_mode: 'off' | 'required';
+        chat_id?: string;
+        turn_id?: string;
+        run_id?: string;
+        ord?: number;
+        attempt?: number;
+        gate_id?: string;
+        elicitation_id?: string;
+        words: string;
+        choice?: string;
+        message_sha256: string;
+        proposal?: {
+            turn_id: string;
+            cli_key: string;
+            excerpt: string;
+        } | null;
+        words_source: 'typed' | 'operator-files' | 'cli-transcript';
+        redacted: boolean;
+    };
+    labels: {
+        model?: DecisionModelLabels;
+        votes?: Array<{
+            cli_key: string;
+            type: DecisionType;
+            codify: boolean;
+        }>;
+        deterministic: {
+            template: DecisionTemplateId | null;
+            exclusions: string[];
+            dgc: {
+                durable: boolean;
+                general: boolean;
+                checkable: boolean;
+            };
+            recurrence: {
+                count: number;
+                first_at: number;
+                projects: string[];
+            };
+        };
+    };
+    derived: {
+        statement: string | null;
+        polarity: 'do' | 'dont' | null;
+        key: string | null;
+        scope: 'project' | 'everywhere';
+        steering_type: SteeringType;
+    };
+    route: DecisionRoute;
+    /** The in-force rule a `restated` / `maybe-restated` decision restates, or a `conflict` contradicts. */
+    rule_ref?: string;
+}
+export interface DecisionOutcome {
+    op: 'outcome';
+    id: string;
+    at: number;
+    state: Exclude<DecisionState, 'recorded'>;
+    how?: 'auto' | 'chip' | 'needs-you';
+    by: {
+        id: string;
+        kind: 'human' | 'system';
+    };
+    proposal_id?: string;
+    rule_id?: string;
+    restates_rule_id?: string;
+    edits?: {
+        statement?: string;
+        scope?: 'project' | 'everywhere';
+        type?: DecisionType;
+        steering_type?: SteeringType;
+    };
+    reason?: DecisionDismissReason;
+    /** `landing_failed` only: the loud reason (never words). */
+    error?: string;
+}
+export type DecisionLine = DecisionRecord | DecisionOutcome;
+/** `WICKED_DECISIONS` (§5.6): one switch, not a fallback. */
+export type DecisionsMode = 'off' | 'ledger' | 'on';
+/**
+ * Resolve the switch. Default `ledger`: record and label, no chips and no auto — the live-precision
+ * mode §8 runs before `on` (the corpus gate). An unknown value is `ledger`, never `on`.
+ */
+export declare function resolveDecisionsMode(env?: NodeJS.ProcessEnv): DecisionsMode;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/decisions/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,UAAU,EACX,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,YAAY,GACb,CAAC;AAEF,gGAAgG;AAChG,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,YAAY,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,QAAQ,CAAC;IACb,CAAC,EAAE,CAAC,CAAC;IACL,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE;QACN,KAAK,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,UAAU,CAAA;SAAE,CAAC;QACxD,SAAS,EAAE,KAAK,GAAG,UAAU,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;QACxE,YAAY,EAAE,OAAO,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;QAC5D,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,MAAM,EAAE;QACN,KAAK,CAAC,EAAE,mBAAmB,CAAC;QAC5B,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,YAAY,CAAC;YAAC,MAAM,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACxE,aAAa,EAAE;YACb,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;YACpC,UAAU,EAAE,MAAM,EAAE,CAAC;YACrB,GAAG,EAAE;gBAAE,OAAO,EAAE,OAAO,CAAC;gBAAC,OAAO,EAAE,OAAO,CAAC;gBAAC,SAAS,EAAE,OAAO,CAAA;aAAE,CAAC;YAChE,UAAU,EAAE;gBAAE,KAAK,EAAE,MAAM,CAAC;gBAAC,QAAQ,EAAE,MAAM,CAAC;gBAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC;SACrE,CAAC;KACH,CAAC;IACF,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;QAC/B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,EAAE,SAAS,GAAG,YAAY,CAAC;QAChC,aAAa,EAAE,YAAY,CAAC;KAC7B,CAAC;IACF,KAAK,EAAE,aAAa,CAAC;IACrB,wGAAwG;IACxG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,SAAS,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAC1C,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IACpC,EAAE,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAA;KAAE,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;QAAC,IAAI,CAAC,EAAE,YAAY,CAAC;QAAC,aAAa,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;IACpH,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,eAAe,CAAC;AAE5D,6DAA6D;AAC7D,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,aAAa,CAIxF"}