wicked-crew 0.7.47 → 0.7.48

package/dist/decisions/chat-recorder.js

@@ -0,0 +1,367 @@
+/**
+ * The studio chat recorder (DES-decision-capture §4.3.3, DC-S4b; DOC-4: the pair framing).
+ *
+ * A chat seat is asked (the scope statement's `## Decisions` section, `chat-scope.ts`) to end every
+ * reply with a fenced `wicked-decisions` JSON block labelling the OPERATOR'S words of the turn it is
+ * answering. This module is the whole host:
+ *
+ *  - {@link splitDecisionsBlock} / {@link DecisionFenceFilter}: the block never reaches a reader. The
+ *    `chatReply` text is cut before persist and broadcast (`ChatTranscriptStore.rewriteEvent`), and the
+ *    streamed `chatDelta` frames hold back a tail that could still become the fence, then drop
+ *    everything from the fence on until the turn's reply (review S4 / N8).
+ *  - {@link ChatDecisionRecorder}: the recorder is chosen deterministically from the turn's audience
+ *    (the first `claude` seat, else the first seat in roster order — review N3); its items become
+ *    records when their quote is found, whitespace-normalised, in the SAME turn's operator message
+ *    (the model may label words, never invent them); every other seat's items are `labels.votes`.
+ *  - It fails OPEN with no regex fallback: a missing or malformed block leaves the turn
+ *    "unclassified" (a counter on `/diagnostics`) and the operator's words are STILL recorded, so the
+ *    deterministic derivation (`derive.ts`) runs with no model at all. The model only adds offers.
+ *  - DOC-4: an item that `approves_proposal` carries `decision_text` written from the seat's approved
+ *    proposal; that text becomes the record's statement and the record names the proposal (the
+ *    previous turn, the recorder seat). A bare "lets do it" therefore yields a decision whose text is
+ *    the proposal's, never auto (`derive.ts` refuses auto for an approval).
+ *
+ * Words enter the ledger only through `ingestDecision` (§4.3.1): the actor is the one who SENT the
+ * message (`noteSend`, from the route), so an agent token's chat message records nothing.
+ */
+import { z } from 'zod';
+import { chatTurnStaleAfterMs } from '../api/chat-turns.js';
+import { ingestDecision } from './ingest.js';
+/** The opening fence, exactly as the codebook (`skills/mem/refs/decision-report.md`) spells it. */
+export const DECISIONS_FENCE = '```wicked-decisions';
+const STEERING_TYPES = [
+    'architecture',
+    'development',
+    'security',
+    'testing',
+    'operations',
+    'compliance',
+    'design-ux',
+];
+const ItemSchema = z.object({
+    quote: z.string().min(1).max(4000),
+    decision_text: z.string().max(600).nullish(),
+    type: z.enum(['rule', 'correction', 'scope', 'exception', 'choice', 'confirmation']),
+    codify: z.boolean().default(false),
+    ambiguous: z.boolean().default(false),
+    steering_type: z.enum(STEERING_TYPES).default('development'),
+    approves_proposal: z.boolean().default(false),
+    same_as: z.string().nullable().default(null),
+});
+const BlockSchema = z.object({ items: z.array(z.unknown()) });
+/**
+ * Parse a block body. `null` when the JSON is malformed or the body is not `{items: [...]}`; an item
+ * that fails its own shape is dropped and counted, the rest survive.
+ */
+export function parseDecisionsBlock(body) {
+    let raw;
+    try {
+        raw = JSON.parse(body);
+    }
+    catch {
+        return null;
+    }
+    const block = BlockSchema.safeParse(raw);
+    if (!block.success)
+        return null;
+    const items = [];
+    let dropped = 0;
+    for (const candidate of block.data.items) {
+        const item = ItemSchema.safeParse(candidate);
+        if (!item.success) {
+            dropped += 1;
+            continue;
+        }
+        const d = item.data;
+        items.push({
+            quote: d.quote,
+            ...(typeof d.decision_text === 'string' && d.decision_text.trim() !== '' ? { decision_text: d.decision_text.trim() } : {}),
+            type: d.type,
+            codify: d.codify,
+            ambiguous: d.ambiguous,
+            steering_type: d.steering_type,
+            approves_proposal: d.approves_proposal,
+            same_as: d.same_as,
+        });
+    }
+    return { items, dropped };
+}
+function trimEnd(text) {
+    return text.replace(/\s+$/u, '');
+}
+/**
+ * Cut the LAST fenced `wicked-decisions` block out of a reply. The opening fence must be a line of
+ * its own (leading indentation allowed — a list item or a quoted block is still a block; a mention of
+ * the fence inside a sentence is prose, codex r1). An opening fence with no closing fence — a reply
+ * cut off mid-block — is removed from its line on and reported `truncated`; nothing of a block ever
+ * reaches a reader.
+ */
+export function splitDecisionsBlock(text) {
+    const openings = [...text.matchAll(/(^|\n)[ \t]*```wicked-decisions[ \t]*(?=\r?\n|$)/gu)];
+    const opening = openings[openings.length - 1];
+    if (opening === undefined || opening.index === undefined)
+        return { text, block: null, truncated: false };
+    const lineStart = opening.index + opening[1].length;
+    const afterOpen = text.indexOf('\n', lineStart);
+    if (afterOpen === -1)
+        return { text: trimEnd(text.slice(0, lineStart)), block: null, truncated: true };
+    const close = /\n[ \t]*```/u.exec(text.slice(afterOpen));
+    if (close === null)
+        return { text: trimEnd(text.slice(0, lineStart)), block: null, truncated: true };
+    const closeAt = afterOpen + close.index;
+    const body = text.slice(afterOpen + 1, closeAt).trim();
+    const rest = text.slice(closeAt + close[0].length).replace(/^[ \t]*\r?\n?/u, '');
+    return { text: trimEnd(text.slice(0, lineStart) + rest), block: body, truncated: false };
+}
+/**
+ * The `chatDelta` filter: per (chat, seat), hold back the longest tail that is still a prefix of the
+ * fence (so a fence split across frames is caught), and from the fence on drop every character
+ * until {@link reset} (the turn's `chatReply`, which carries the clean full text anyway).
+ */
+export class DecisionFenceFilter {
+    state = new Map();
+    static key(chat, cliKey) {
+        return `${chat}\u0000${cliKey}`;
+    }
+    delta(chat, cliKey, text) {
+        const key = DecisionFenceFilter.key(chat, cliKey);
+        const s = this.state.get(key) ?? { held: '', dropping: false };
+        if (s.dropping) {
+            this.state.set(key, s);
+            return '';
+        }
+        const buf = s.held + text;
+        const at = buf.indexOf(DECISIONS_FENCE);
+        if (at !== -1) {
+            this.state.set(key, { held: '', dropping: true });
+            return buf.slice(0, at);
+        }
+        let hold = 0;
+        for (let n = Math.min(buf.length, DECISIONS_FENCE.length - 1); n > 0; n -= 1) {
+            if (DECISIONS_FENCE.startsWith(buf.slice(buf.length - n))) {
+                hold = n;
+                break;
+            }
+        }
+        if (hold === 0) {
+            this.state.delete(key);
+            return buf;
+        }
+        this.state.set(key, { held: buf.slice(buf.length - hold), dropping: false });
+        return buf.slice(0, buf.length - hold);
+    }
+    reset(chat, cliKey) {
+        this.state.delete(DecisionFenceFilter.key(chat, cliKey));
+    }
+}
+/** Whitespace-normalised: the only normalisation quote matching applies. */
+function norm(text) {
+    return text.replace(/\s+/gu, ' ').trim();
+}
+/** The recorder of a turn: the first `claude` seat of its audience, else the first seat (review N3). */
+export function pickRecorder(seats) {
+    return seats.find((s) => s === 'claude' || s.startsWith('claude')) ?? seats[0];
+}
+export class ChatDecisionRecorder {
+    deps;
+    turns = new Map();
+    lastTurn = new Map();
+    counters = new Map();
+    unclassified = 0;
+    recorded = 0;
+    now;
+    staleAfterMs;
+    inFlight = new Set();
+    constructor(deps) {
+        this.deps = deps;
+        this.now = deps.now ?? Date.now;
+        this.staleAfterMs = deps.staleAfterMs ?? chatTurnStaleAfterMs();
+    }
+    static key(chat, turnId) {
+        return `${chat}\u0000${turnId}`;
+    }
+    log(msg) {
+        this.deps.log?.(msg);
+    }
+    counter(cliKey) {
+        let c = this.counters.get(cliKey);
+        if (c === undefined) {
+            c = { replies: 0, blocks: 0, malformed: 0 };
+            this.counters.set(cliKey, c);
+        }
+        return c;
+    }
+    /** The route recorded a send: who said it (the actor), to whom (the audience the engine reached). */
+    noteSend(chat, turnId, actor, text, seats) {
+        // codex r1: a send sweeps too, so a chat whose seat went quiet does not keep its stale turns
+        // until some reply happens to arrive. Tracked, never awaited on the route.
+        this.track(this.sweep());
+        const prev = this.lastTurn.get(chat);
+        this.turns.set(ChatDecisionRecorder.key(chat, turnId), {
+            chat,
+            turnId,
+            at: this.now(),
+            actor,
+            text,
+            seats: [...new Set(seats)],
+            replies: new Map(),
+            ...(prev !== undefined ? { prevTurnId: prev } : {}),
+        });
+        this.lastTurn.set(chat, turnId);
+    }
+    /** A seat ended its part of a turn. Resolves once any recording it triggered has settled. */
+    async onReply(input) {
+        let parsed = null;
+        if (input.kind !== 'failed') {
+            const c = this.counter(input.cliKey);
+            c.replies += 1;
+            if (input.block !== null) {
+                parsed = parseDecisionsBlock(input.block);
+                if (parsed === null)
+                    c.malformed += 1;
+                else
+                    c.blocks += 1;
+            }
+        }
+        await this.sweep();
+        if (input.turnId === undefined)
+            return;
+        const turn = this.turns.get(ChatDecisionRecorder.key(input.chat, input.turnId));
+        if (turn === undefined)
+            return; // a turn this daemon never saw sent (a restart): nothing to record
+        turn.replies.set(input.cliKey, parsed);
+        if (turn.seats.every((s) => turn.replies.has(s)))
+            await this.finalize(turn);
+    }
+    /** The chat is gone: whatever its open turns gathered is recorded now. */
+    async closed(chat) {
+        for (const turn of [...this.turns.values()]) {
+            if (turn.chat === chat)
+                await this.finalize(turn);
+        }
+        this.lastTurn.delete(chat);
+    }
+    track(work) {
+        const tracked = work
+            .catch((err) => this.log(`[decisions] chat recorder: ${err instanceof Error ? err.message : String(err)}`))
+            .finally(() => this.inFlight.delete(tracked));
+        this.inFlight.add(tracked);
+    }
+    /** Resolves once every recording in flight has settled (tests, shutdown). */
+    async idle() {
+        while (this.inFlight.size > 0)
+            await Promise.all([...this.inFlight]);
+    }
+    diagnostics() {
+        const recorder = {};
+        for (const [k, v] of this.counters)
+            recorder[k] = { ...v };
+        return { mode: this.deps.service.mode, recorder, unclassified_turns: this.unclassified, recorded_turns: this.recorded };
+    }
+    async sweep() {
+        const now = this.now();
+        for (const turn of [...this.turns.values()]) {
+            if (now - turn.at >= this.staleAfterMs)
+                await this.finalize(turn);
+        }
+    }
+    async finalize(turn) {
+        this.turns.delete(ChatDecisionRecorder.key(turn.chat, turn.turnId));
+        const work = this.record(turn).catch((err) => this.log(`[decisions] chat ${turn.chat} turn ${turn.turnId}: ${err instanceof Error ? err.message : String(err)}`));
+        this.track(work);
+        await work;
+    }
+    async record(turn) {
+        // DC-S7: what the seats considered and cited this turn — whoever sent the message.
+        if (this.deps.onTurnRecorded !== undefined) {
+            await this.deps.onTurnRecorded(turn.chat, turn.turnId).catch((err) => this.log(`[decisions] considered for chat ${turn.chat} turn ${turn.turnId}: ${err instanceof Error ? err.message : String(err)}`));
+        }
+        // §4.3.1: an agent's words are not a decision source. The block was still stripped and counted.
+        if (turn.actor.kind !== 'human')
+            return;
+        const recorder = pickRecorder(turn.seats);
+        const own = recorder !== undefined ? (turn.replies.get(recorder) ?? null) : null;
+        if (own === null)
+            this.unclassified += 1;
+        const projectId = this.deps.projectOf(turn.chat) ?? null;
+        const haystack = norm(turn.text);
+        const records = [];
+        if (own !== null && recorder !== undefined) {
+            for (const item of own.items) {
+                const quote = norm(item.quote);
+                if (quote === '' || !haystack.includes(quote)) {
+                    this.log(`[decisions] chat ${turn.chat} turn ${turn.turnId}: ${recorder} quote not found in the operator's message; dropped`);
+                    continue;
+                }
+                const labels = {
+                    is_decision: true,
+                    type: item.type,
+                    codify: item.codify,
+                    ambiguous: item.ambiguous,
+                    steering_type: item.steering_type,
+                    same_as: item.same_as,
+                    approves_proposal: item.approves_proposal,
+                    recorder,
+                };
+                const votes = [];
+                for (const [cliKey, other] of turn.replies) {
+                    if (cliKey === recorder || other === null)
+                        continue;
+                    const vote = other.items.find((o) => norm(o.quote) === quote);
+                    if (vote !== undefined)
+                        votes.push({ cli_key: cliKey, type: vote.type, codify: vote.codify });
+                }
+                const approved = item.approves_proposal && item.decision_text !== undefined;
+                const record = await ingestDecision(this.deps.service, {
+                    host: 'studio-chat',
+                    actor: turn.actor,
+                    words: quote,
+                    projectId,
+                    chatId: turn.chat,
+                    turnId: turn.turnId,
+                    labels,
+                    votes,
+                    proposal: approved && turn.prevTurnId !== undefined
+                        ? { turn_id: turn.prevTurnId, cli_key: recorder, excerpt: item.decision_text.slice(0, 300) }
+                        : null,
+                    ...(approved ? { statement: item.decision_text } : {}),
+                });
+                if (record !== null)
+                    records.push(record);
+            }
+        }
+        if (records.length === 0) {
+            // No usable block, or no quote that matched: the words are recorded as typed, and the
+            // deterministic derivation alone decides the route (§4.3.3 fails open, no regex fallback).
+            const record = await ingestDecision(this.deps.service, {
+                host: 'studio-chat',
+                actor: turn.actor,
+                words: turn.text,
+                projectId,
+                chatId: turn.chat,
+                turnId: turn.turnId,
+            });
+            if (record !== null)
+                records.push(record);
+        }
+        if (records.length === 0)
+            return; // WICKED_DECISIONS=off, or nothing to record
+        this.recorded += 1;
+        const items = [];
+        for (const r of records) {
+            const view = this.deps.service.deps.ledger.view(r.id);
+            if (view !== null)
+                items.push(view);
+        }
+        const frame = {
+            type: 'chatDecisions',
+            chat: turn.chat,
+            turn_id: turn.turnId,
+            items,
+            ...(projectId !== null ? { project_id: projectId } : {}),
+        };
+        this.deps.broadcast(frame);
+        this.deps.transcripts.recordDecisions({ chat: turn.chat, turnId: turn.turnId, items });
+    }
+}
+//# sourceMappingURL=chat-recorder.js.map

package/dist/decisions/chat-recorder.js.map

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

package/dist/decisions/consider.d.ts

@@ -0,0 +1,102 @@
+/**
+ * "Considered · set aside · cited (unchecked)" (DES-decision-capture §4.7, DC-S7).
+ *
+ *  - **Considered** = the engine's `considerRules({projects:[project]}).in_force` for the turn's or
+ *    unit's project (project rules + global ones). On an engine without the binding, the global
+ *    rules alone, and the Consideration says so (`source: 'global-only'`).
+ *  - **Set aside** = the engine's `set_aside` (out of scope / replaced / retired) plus crew's own
+ *    pending candidates for that project — decisions `offered` but not yet confirmed.
+ *  - **Cited (unchecked)** = every `[rule:<id>]` the persisted reply or step wrote. An id in the
+ *    in-force set is "cited by the step — unchecked"; any other id is unverified. It is NEVER
+ *    summed into a "followed" count (B4): advisory rules never decide, so nothing here can know
+ *    whether a rule was followed — DES-rule-check supplies that verdict.
+ *
+ * The same object answers `GET /chats/:id/turns/:turnId/considered` and
+ * `GET /runs/:id/units/:unitKey/considered?attempt=`, and one `wicked.crew.rule.considered` fact
+ * (counts and ids, never words) is emitted when a turn or a unit attempt lands — keyed per turn
+ * and per (run, ord, attempt), so a re-dispatch is its own record (review N5).
+ */
+import { RULE_CITED_LABEL, extractRuleCitations } from '../api/chat-citations.js';
+import type { ChatTranscriptStore } from '../api/chat-transcripts.js';
+import type { ConformanceRule, Consideration, SessionView } from '../core/types.js';
+import { type DecisionBusEmit } from './events.js';
+import type { DecisionLedger } from './ledger.js';
+import { rulesPreface } from './rules-text.js';
+export { RULE_CITED_LABEL, extractRuleCitations, rulesPreface };
+/** What the service needs from the engine; every method optional so a partial stub never throws. */
+export interface ConsiderAdapter {
+    projectRulesSupported?(): boolean;
+    listConformanceRules?(): Promise<ConformanceRule[]>;
+    considerRules?(query: {
+        projects?: string[];
+        steering_type?: string;
+    }): Promise<{
+        in_force: ConformanceRule[];
+        set_aside: Array<{
+            id: string;
+            statement: string;
+            reason: 'out_of_scope' | 'replaced' | 'retired';
+        }>;
+    }>;
+    sessionsDetail?(): Promise<SessionView[]>;
+    workOutput?(unitId: string): Promise<string | null>;
+}
+export interface InForceRead {
+    rules: ConformanceRule[];
+    setAside: Array<{
+        id: string;
+        statement: string;
+        reason: 'out_of_scope' | 'replaced' | 'retired';
+    }>;
+    source: Consideration['source'];
+}
+/**
+ * The in-force rules for a project. `considerRules` when the engine has it; else the global,
+ * non-retired rules; else (no engine read at all) nothing, said as `unavailable`. Never throws.
+ */
+export declare function readInForce(adapter: ConsiderAdapter, projectId: string | null, log?: (m: string) => void): Promise<InForceRead>;
+export interface ConsiderationDeps {
+    adapter: ConsiderAdapter;
+    /** Crew's own pending candidates (`offered`) become `not_confirmed` set-asides. Absent = none. */
+    ledger?: DecisionLedger;
+    /** The chat turn's persisted replies. Absent = no chat considerations. */
+    transcripts?: ChatTranscriptStore;
+    projectOf: (id: string) => string | undefined;
+    emit?: DecisionBusEmit | null;
+    log?: (msg: string) => void;
+}
+export declare class ConsiderationService {
+    private readonly deps;
+    /** chat → the rule ids its seats have been told about (the statement at open, then every preface). */
+    private readonly seen;
+    constructor(deps: ConsiderationDeps);
+    private log;
+    inForceFor(projectId: string | null): Promise<InForceRead>;
+    /** The in-force ids, or `null` when no engine read was possible (a citation then stays unchecked). */
+    inForceIds(projectId: string | null): Promise<ReadonlySet<string> | null>;
+    /** The chat opened with these rules in its statement. */
+    noteChatOpen(chat: string, rules: ReadonlyArray<ConformanceRule>): void;
+    /**
+     * The preface the next send carries, or `null`: the rules in force now that the seats have not
+     * been told about. A chat this daemon did not open (a restart) is SEEDED on its first send —
+     * nothing is known about what its seats were told, so the current set stands in for the open
+     * statement and that send carries no preface; a rule that lands after the seed is new to the
+     * seats and IS prefaced on the send after (codex r1, wording fixed: "seeded, then prefaced").
+     */
+    prefaceForSend(chat: string, opts?: {
+        inForce?: ReadonlyArray<ConformanceRule>;
+    }): Promise<string | null>;
+    chatClosed(chat: string): void;
+    private notConfirmed;
+    private build;
+    /** The Consideration of one chat turn, or `null` when the transcript holds no such turn. */
+    forChatTurn(chat: string, turnId: string): Promise<Consideration | null>;
+    /** The Consideration of one unit attempt (`unitKey` as `resolveUnit` accepts it), or `null`. */
+    forUnit(runId: string, unitKey: string, attempt?: number): Promise<Consideration | null>;
+    private emit;
+    /** A chat turn's replies all landed: compute and emit. Never throws. */
+    onChatTurn(chat: string, turnId: string): Promise<void>;
+    /** A unit attempt's output was captured: compute and emit. Never throws. */
+    onUnitCaptured(runId: string, ord: number, attempt: number): Promise<void>;
+}
+//# sourceMappingURL=consider.d.ts.map

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

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