wicked-crew 0.7.47 → 0.7.49

package/dist/decisions/consider.js

@@ -0,0 +1,207 @@
+/**
+ * "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, RULE_UNKNOWN_LABEL, extractRuleCitations } from '../api/chat-citations.js';
+import { coreUnitId } from '../api/evidence.js';
+import { resolveUnit } from '../api/unit-output.js';
+import { RULE_CONSIDERED, decisionFact } from './events.js';
+import { orderBySeverity, rulesPreface } from './rules-text.js';
+export { RULE_CITED_LABEL, extractRuleCitations, rulesPreface };
+/**
+ * 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 async function readInForce(adapter, projectId, log) {
+    try {
+        if (typeof adapter.projectRulesSupported === 'function' && adapter.projectRulesSupported() && typeof adapter.considerRules === 'function') {
+            const c = await adapter.considerRules({ projects: projectId !== null ? [projectId] : [] });
+            return { rules: c.in_force, setAside: c.set_aside, source: 'considerRules' };
+        }
+        if (typeof adapter.listConformanceRules === 'function') {
+            const all = await adapter.listConformanceRules();
+            return {
+                rules: all.filter((r) => r.retired !== true && r.targets?.project === undefined),
+                setAside: all.filter((r) => r.retired === true).map((r) => ({ id: r.id, statement: r.statement, reason: 'retired' })),
+                source: 'global-only',
+            };
+        }
+    }
+    catch (err) {
+        log?.(`[decisions] could not read the in-force rules: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return { rules: [], setAside: [], source: 'unavailable' };
+}
+export class ConsiderationService {
+    deps;
+    /** chat → the rule ids its seats have been told about (the statement at open, then every preface). */
+    seen = new Map();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    log(msg) {
+        this.deps.log?.(msg);
+    }
+    async inForceFor(projectId) {
+        return readInForce(this.deps.adapter, projectId, (m) => this.log(m));
+    }
+    /** The in-force ids, or `null` when no engine read was possible (a citation then stays unchecked). */
+    async inForceIds(projectId) {
+        const read = await this.inForceFor(projectId);
+        return read.source === 'unavailable' ? null : new Set(read.rules.map((r) => r.id));
+    }
+    // ── How seats learn the rules ──────────────────────────────────────────────────────────────
+    /** The chat opened with these rules in its statement. */
+    noteChatOpen(chat, rules) {
+        this.seen.set(chat, new Set(rules.map((r) => r.id)));
+    }
+    /**
+     * 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").
+     */
+    async prefaceForSend(chat, opts = {}) {
+        const rules = opts.inForce ?? (await this.inForceFor(this.deps.projectOf(chat) ?? null)).rules;
+        const seen = this.seen.get(chat);
+        if (seen === undefined) {
+            this.seen.set(chat, new Set(rules.map((r) => r.id)));
+            return null;
+        }
+        const fresh = rules.filter((r) => !seen.has(r.id));
+        for (const r of rules)
+            seen.add(r.id);
+        return fresh.length > 0 ? rulesPreface(fresh) : null;
+    }
+    chatClosed(chat) {
+        this.seen.delete(chat);
+    }
+    // ── The Consideration ──────────────────────────────────────────────────────────────────────
+    notConfirmed(projectId) {
+        const ledger = this.deps.ledger;
+        if (ledger === undefined)
+            return [];
+        const views = ledger.list({ state: 'offered', ...(projectId !== null ? { project: projectId } : {}) });
+        return views
+            .filter((v) => v.project_id === projectId)
+            .map((v) => ({ id: v.proposal_id ?? v.id, statement: v.derived.statement ?? v.origin.words, reason: 'not_confirmed' }));
+    }
+    async build(subject, key, projectId, texts) {
+        const read = await this.inForceFor(projectId);
+        const inForce = new Set(read.rules.map((r) => r.id));
+        const considered = orderBySeverity(read.rules).map((r) => ({
+            id: r.id,
+            statement: r.statement,
+            severity: r.severity,
+            ...(r.steering_type !== undefined ? { steering_type: r.steering_type } : {}),
+            ...(r.targets?.project !== undefined ? { project: r.targets.project } : {}),
+        }));
+        const cited = [];
+        const seenCite = new Set();
+        for (const { by, text } of texts) {
+            for (const id of extractRuleCitations(text)) {
+                const k = `${by}\u0000${id}`;
+                if (seenCite.has(k))
+                    continue;
+                seenCite.add(k);
+                cited.push(inForce.has(id)
+                    ? { id, by, status: 'unchecked', label: RULE_CITED_LABEL }
+                    : { id, by, status: 'unverified', label: RULE_UNKNOWN_LABEL });
+            }
+        }
+        return {
+            subject,
+            key,
+            project_id: projectId,
+            considered,
+            set_aside: [...read.setAside, ...this.notConfirmed(projectId)],
+            cited,
+            source: read.source,
+        };
+    }
+    /** The Consideration of one chat turn, or `null` when the transcript holds no such turn. */
+    async forChatTurn(chat, turnId) {
+        const transcripts = this.deps.transcripts;
+        if (transcripts === undefined)
+            return null;
+        const records = transcripts.read(chat);
+        if (!records.some((r) => r.turnId === turnId && r.kind === 'user'))
+            return null;
+        const texts = records.flatMap((r) => (r.turnId === turnId && r.kind === 'seat' ? [{ by: r.cliKey, text: r.text }] : []));
+        return this.build({ kind: 'chat', chat_id: chat, turn_id: turnId }, `considered:${chat}:${turnId}`, this.deps.projectOf(chat) ?? null, texts);
+    }
+    /** The Consideration of one unit attempt (`unitKey` as `resolveUnit` accepts it), or `null`. */
+    async forUnit(runId, unitKey, attempt = 0) {
+        const { adapter } = this.deps;
+        if (typeof adapter.sessionsDetail !== 'function')
+            return null;
+        const run = (await adapter.sessionsDetail()).find((v) => v.session.id === runId);
+        if (run === undefined)
+            return null;
+        const unit = resolveUnit(run, unitKey);
+        if (unit === null)
+            return null;
+        const text = typeof adapter.workOutput === 'function' ? ((await adapter.workOutput(coreUnitId(runId, unit))) ?? '') : '';
+        return this.build({ kind: 'unit', run_id: runId, ord: unit.ord, attempt }, `considered:${runId}:${unit.ord}:${attempt}`, this.deps.projectOf(runId) ?? null, [{ by: unit.id, text }]);
+    }
+    // ── The fact (post-commit, counts only) ───────────────────────────────────────────────────
+    async emit(c) {
+        const emit = this.deps.emit;
+        if (emit === null || emit === undefined)
+            return;
+        const counts = {
+            project_id: c.project_id,
+            considered_count: c.considered.length,
+            set_aside_count: c.set_aside.length,
+            cited_count: c.cited.length,
+        };
+        const subject = c.subject.kind === 'chat'
+            ? { chat_id: c.subject.chat_id, turn_id: c.subject.turn_id }
+            : { run_id: c.subject.run_id, ord: c.subject.ord, attempt: c.subject.attempt };
+        const f = decisionFact(RULE_CONSIDERED, { ...subject, ...counts }, c.key);
+        try {
+            await emit(f.type, f.payload, f.key);
+        }
+        catch (err) {
+            this.log(`[decisions] emit ${RULE_CONSIDERED} failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** A chat turn's replies all landed: compute and emit. Never throws. */
+    async onChatTurn(chat, turnId) {
+        try {
+            const c = await this.forChatTurn(chat, turnId);
+            if (c !== null)
+                await this.emit(c);
+        }
+        catch (err) {
+            this.log(`[decisions] considered for chat ${chat} turn ${turnId} failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** A unit attempt's output was captured: compute and emit. Never throws. */
+    async onUnitCaptured(runId, ord, attempt) {
+        try {
+            const c = await this.forUnit(runId, String(ord), attempt);
+            if (c !== null)
+                await this.emit(c);
+        }
+        catch (err) {
+            this.log(`[decisions] considered for run ${runId} unit ${ord} failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+//# sourceMappingURL=consider.js.map

package/dist/decisions/consider.js.map

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

package/dist/decisions/events.d.ts

@@ -11,6 +11,8 @@ 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>;
 }

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

@@ -1 +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;AAE/D,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"}
+{"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

@@ -11,6 +11,8 @@ 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 = {};

package/dist/decisions/events.js.map

@@ -1 +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;AAM/D,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"}
+{"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

@@ -1,8 +1,9 @@
 /**
- * Where operator words enter the ledger (DES-decision-capture §4.3.1 / §4.3.2, DC-S4a).
+ * 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. Only a `human` actor is
+ * {@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
@@ -10,19 +11,41 @@
  */
 import type { Actor } from '../core/types.js';
 import { type DecisionService } from './land.js';
-import type { DecisionHost, DecisionRecord } from './types.js';
+import type { DecisionHost, DecisionModelLabels, DecisionRecord, DecisionType } from './types.js';
 export interface HostWords {
-    host: Extract<DecisionHost, 'gate' | 'elicitation' | 'inject'>;
+    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;
-    runId: string;
+    /** 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

@@ -1 +1 @@
-{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/decisions/ingest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAC,CAAC;IAC/D,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,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA4E/G"}
+{"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

@@ -1,8 +1,9 @@
 /**
- * Where operator words enter the ledger (DES-decision-capture §4.3.1 / §4.3.2, DC-S4a).
+ * 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. Only a `human` actor is
+ * {@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
@@ -22,6 +23,7 @@ export async function ingestDecision(service, input) {
     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);
@@ -33,8 +35,10 @@ export async function ingestDecision(service, input) {
             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,
@@ -45,22 +49,26 @@ export async function ingestDecision(service, input) {
             origin: {
                 actor: { id: input.actor.id, kind: 'human', trust: input.actor.trust },
                 auth_mode: authMode,
-                run_id: input.runId,
+                ...(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: null,
+                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: d.statement,
+                statement,
                 polarity: d.polarity,
                 key: d.key,
                 scope: d.scope,
@@ -85,7 +93,7 @@ export async function ingestDecision(service, input) {
         return record;
     }
     catch (err) {
-        log?.(`[decisions] recording ${input.host} words for run ${input.runId} failed: ${err instanceof Error ? err.message : String(err)}`);
+        log?.(`[decisions] recording ${input.host} words for ${where} failed: ${err instanceof Error ? err.message : String(err)}`);
         return null;
     }
 }

package/dist/decisions/ingest.js.map

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

@@ -0,0 +1,31 @@
+/**
+ * The two Content-Security-Policies of the editor plugin contract (DES-artifact-editor-plugins §8.2,
+ * EP-C1). Spelled once, pinned by test — a header is only as good as its exact text.
+ *
+ *  - {@link bundleHeaders}: on the bundle response. `sandbox allow-scripts` sandboxes the bundle even
+ *    when opened top-level; `default-src 'none'` + `connect-src 'none'` is the line that protects the
+ *    local no-auth daemon (no fetch, XHR, WebSocket, EventSource or beacon); `form-action 'none'`,
+ *    `base-uri 'none'`, no workers, no manifest. `script-src 'unsafe-inline'` is acceptable only
+ *    because the bundle is ONE hashed file and nothing else can load. An editor holding
+ *    `network.media` (first-party `wicked-page`: agent-authored pages use web images) gets
+ *    `img-src … https:` and `font-src … https:` — a GET-only channel, never `connect-src`.
+ *    `navigate-to` / `prefetch-src` are deliberately absent: no browser enforces them (review B1).
+ *  - {@link shellCsp}: on studio's own shell document. A sandboxed frame may navigate ITSELF, and
+ *    once it does the bundle's policy is gone — so the shell limits what any frame may point at:
+ *    crew's own editors route, crew's interactive proxy (today's Document mode), `blob:` and
+ *    `data:`. The origin is written per response because a path cannot follow `'self'`.
+ */
+import type { EditorRecord } from './registry.js';
+export declare const BUNDLE_CSP_BASE: string;
+/** Exactly the §8.2 header set for one editor's bundle. */
+export declare function bundleHeaders(record: Pick<EditorRecord, 'manifest' | 'firstParty'>): Record<string, string>;
+/** The shell's `frame-src` policy for the request's own origin (`scheme://host[:port]`). */
+export declare function shellCsp(origin: string): string;
+/** `scheme://host` of a request, from what the client sent (a hosted skin may sit behind a proxy). */
+export declare function requestOrigin(req: {
+    protocol?: string | undefined;
+    headers: {
+        host?: string | undefined;
+    };
+}): string;
+//# sourceMappingURL=csp.d.ts.map

package/dist/editors/csp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csp.d.ts","sourceRoot":"","sources":["../../src/editors/csp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,eAAO,MAAM,eAAe,QAIc,CAAC;AAE3C,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,YAAY,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAY3G;AAED,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,sGAAsG;AACtG,wBAAgB,aAAa,CAAC,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,CAIpH"}

package/dist/editors/csp.js

@@ -0,0 +1,46 @@
+/**
+ * The two Content-Security-Policies of the editor plugin contract (DES-artifact-editor-plugins §8.2,
+ * EP-C1). Spelled once, pinned by test — a header is only as good as its exact text.
+ *
+ *  - {@link bundleHeaders}: on the bundle response. `sandbox allow-scripts` sandboxes the bundle even
+ *    when opened top-level; `default-src 'none'` + `connect-src 'none'` is the line that protects the
+ *    local no-auth daemon (no fetch, XHR, WebSocket, EventSource or beacon); `form-action 'none'`,
+ *    `base-uri 'none'`, no workers, no manifest. `script-src 'unsafe-inline'` is acceptable only
+ *    because the bundle is ONE hashed file and nothing else can load. An editor holding
+ *    `network.media` (first-party `wicked-page`: agent-authored pages use web images) gets
+ *    `img-src … https:` and `font-src … https:` — a GET-only channel, never `connect-src`.
+ *    `navigate-to` / `prefetch-src` are deliberately absent: no browser enforces them (review B1).
+ *  - {@link shellCsp}: on studio's own shell document. A sandboxed frame may navigate ITSELF, and
+ *    once it does the bundle's policy is gone — so the shell limits what any frame may point at:
+ *    crew's own editors route, crew's interactive proxy (today's Document mode), `blob:` and
+ *    `data:`. The origin is written per response because a path cannot follow `'self'`.
+ */
+export const BUNDLE_CSP_BASE = "sandbox allow-scripts; default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; " +
+    "img-src data: blob:{MEDIA}; media-src blob:; font-src data:{MEDIA}; frame-src blob: data: about:; " +
+    "child-src blob: data: about:; connect-src 'none'; form-action 'none'; base-uri 'none'; " +
+    "worker-src 'none'; manifest-src 'none'";
+/** Exactly the §8.2 header set for one editor's bundle. */
+export function bundleHeaders(record) {
+    // `network.media` widens only for a first-party editor: a third-party one would have to ASK
+    // (§6.1), and no third-party editor can be installed before EP-C8.
+    const media = record.firstParty && record.manifest.permissions.some((p) => p.id === 'network.media') ? ' https:' : '';
+    return {
+        'Content-Security-Policy': BUNDLE_CSP_BASE.replaceAll('{MEDIA}', media),
+        'Cross-Origin-Resource-Policy': 'same-origin',
+        'X-Content-Type-Options': 'nosniff',
+        'X-DNS-Prefetch-Control': 'off',
+        'Referrer-Policy': 'no-referrer',
+        'Cache-Control': 'no-store',
+    };
+}
+/** The shell's `frame-src` policy for the request's own origin (`scheme://host[:port]`). */
+export function shellCsp(origin) {
+    return `frame-src ${origin}/api/v1/editors/ ${origin}/api/v1/projects/ blob: data:`;
+}
+/** `scheme://host` of a request, from what the client sent (a hosted skin may sit behind a proxy). */
+export function requestOrigin(req) {
+    const proto = req.protocol === 'https' ? 'https' : 'http';
+    const host = typeof req.headers.host === 'string' && req.headers.host !== '' ? req.headers.host : 'localhost';
+    return `${proto}://${host}`;
+}
+//# sourceMappingURL=csp.js.map

package/dist/editors/csp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csp.js","sourceRoot":"","sources":["../../src/editors/csp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,CAAC,MAAM,eAAe,GAC1B,oGAAoG;IACpG,oGAAoG;IACpG,yFAAyF;IACzF,wCAAwC,CAAC;AAE3C,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,MAAqD;IACjF,4FAA4F;IAC5F,mEAAmE;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACtH,OAAO;QACL,yBAAyB,EAAE,eAAe,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC;QACvE,8BAA8B,EAAE,aAAa;QAC7C,wBAAwB,EAAE,SAAS;QACnC,wBAAwB,EAAE,KAAK;QAC/B,iBAAiB,EAAE,aAAa;QAChC,eAAe,EAAE,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,OAAO,aAAa,MAAM,oBAAoB,MAAM,+BAA+B,CAAC;AACtF,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,aAAa,CAAC,GAA8E;IAC1G,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1D,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;IAC9G,OAAO,GAAG,KAAK,MAAM,IAAI,EAAE,CAAC;AAC9B,CAAC"}

package/dist/editors/pack-install.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A pack install, as far as it goes before EP-C8 (DES-artifact-editor-plugins §5.2, §9.2; EP-C1).
+ *
+ * Install is human-only (§6.4) and runs garden's fail-closed gate FIRST: `pack check --json` on the
+ * pack root (schema, every editor's entry inside the pack, its hash, its size, nothing loaded from
+ * outside). Then crew reads the spec-2 manifest and lists what the operator would be asked to
+ * approve — the editors, the blocks and the pack's skills (§3.2 "Add these") — and REFUSES with 501
+ * `third_party_editors_not_available`: an unverified editor must pass the install-time conformance
+ * run (cases 1-12 against the bundle, headless Chrome) before it may be installed, and that run is
+ * EP-C8. Nothing is written. The refusal carries the check verdict and the approval list, so the
+ * operator sees exactly what will be asked once installs open.
+ */
+import type { InstallEditorRefusal, PackCheckResult } from '../core/types.js';
+export type PackCheckRunner = (packRoot: string) => Promise<PackCheckResult>;
+/**
+ * Garden's gate, run as a child: `python3 <garden>/scripts/pack/check.py <pack> --json --garden-root <garden>`
+ * (`python` when `python3` is not on PATH). A missing garden or an unparseable verdict is a FAILED
+ * check with the reason — never a pass.
+ */
+export declare function gardenPackCheck(gardenRoot: string | null): PackCheckRunner;
+export declare class PackInstallError extends Error {
+    readonly status: 400 | 404 | 422;
+    readonly check?: PackCheckResult | undefined;
+    constructor(status: 400 | 404 | 422, message: string, check?: PackCheckResult | undefined);
+}
+/** What `POST /editors` reads of a pack before refusing: the approval list (§3.2). */
+export declare function previewPackInstall(packRootRaw: string, check: PackCheckRunner): Promise<InstallEditorRefusal>;
+//# sourceMappingURL=pack-install.d.ts.map

package/dist/editors/pack-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-install.d.ts","sourceRoot":"","sources":["../../src/editors/pack-install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG9E,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAiB7E;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,eAAe,CAiC1E;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IAEvC,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG;IAEhC,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe;gBAFvB,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,EAChC,OAAO,EAAE,MAAM,EACN,KAAK,CAAC,EAAE,eAAe,YAAA;CAKnC;AAED,sFAAsF;AACtF,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAgEnH"}