wicked-crew 0.7.40 → 0.7.46

package/dist/core/linked-issues.js

@@ -0,0 +1,123 @@
+/**
+ * Launch-time resolution of the issues a run's intent links (crew#627).
+ *
+ * A governed worker cannot read GitHub: its environment carries no `gh` login (the daemon's own is
+ * deliberately not inherited, and the engine's fence refuses `gh api` and the token variables), so
+ * `gh issue view <n>` exits 4 and the worker guesses, or reads the public page through WebFetch
+ * (nothing on a private repository, no comments beyond the page). The daemon CAN read them, under
+ * its own identity, before the run starts. So at launch every `#N` / `owner/repo#N` / issue URL the
+ * intent names is read with `gh issue view --json` and its title, state, body and comments are
+ * appended to the problem the engine plans from, inside one marked block. What could not be read
+ * is said in that block and in the launch answer, never skipped silently.
+ *
+ * The block is fenced by {@link LINKED_ISSUES_OPEN} / {@link LINKED_ISSUES_CLOSE} so the deliver
+ * text can take it back out ({@link stripLinkedIssues}): a PR body names the intent, not the issue
+ * text the daemon attached to it.
+ */
+import { issueRefs } from './deliver-text.js';
+import { defaultGhExec } from './deliver.js';
+export const LINKED_ISSUES_OPEN = '<!-- wicked-crew:linked-issues -->';
+export const LINKED_ISSUES_CLOSE = '<!-- /wicked-crew:linked-issues -->';
+/** At most this many issues are read per launch; the rest are named as not read. */
+export const MAX_LINKED_ISSUES = 5;
+/** Per-issue `gh` bound — the launch answer waits on these, in parallel. */
+export const LINKED_ISSUE_TIMEOUT_MS = 5_000;
+const BODY_CAP = 6_000;
+const COMMENT_CAP = 1_500;
+const MAX_COMMENTS = 10;
+function capped(text, max) {
+    const t = text.replace(/\r\n?/g, '\n').trim();
+    return t.length <= max ? t : `${t.slice(0, max).trimEnd()}\n_(cut at ${max} characters)_`;
+}
+/** `#N` → `[N]`; `owner/repo#N` → `[N, '-R', owner/repo]`; an owner-less `repo#N` → null. */
+function ghTarget(ref) {
+    const m = /^(?:([\w.-]+\/[\w.-]+))?#(\d+)$/.exec(ref);
+    if (m === null)
+        return null;
+    return m[1] === undefined ? [m[2]] : [m[2], '-R', m[1]];
+}
+async function readOne(ref, cwd, exec) {
+    const target = ghTarget(ref);
+    const fail = (error) => ({
+        issue: { ref, resolved: false, error },
+        text: `### ${ref}: could not be read (${error})`,
+    });
+    if (target === null)
+        return fail('no owner/repo to read it from');
+    if (target.length === 1 && cwd === undefined)
+        return fail('the run has no repository to read it from');
+    let out;
+    try {
+        out = await exec(['issue', 'view', ...target, '--json', 'title,state,body,url,comments'], {
+            cwd: cwd ?? process.cwd(),
+            timeoutMs: LINKED_ISSUE_TIMEOUT_MS,
+        });
+    }
+    catch (err) {
+        return fail(`gh: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (out.code !== 0) {
+        const why = (out.stderr || out.stdout).trim().split('\n').slice(-1)[0]?.slice(0, 200) ?? '';
+        return fail(`gh ${out.code === null ? 'timed out or could not be spawned' : `exit ${out.code}`}${why !== '' ? `: ${why}` : ''}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(out.stdout);
+    }
+    catch {
+        return fail('gh did not answer the JSON asked for');
+    }
+    const title = typeof parsed.title === 'string' ? parsed.title.replace(/\s+/g, ' ').trim() : '';
+    if (title === '')
+        return fail('gh answered no title');
+    const state = typeof parsed.state === 'string' ? ` (${parsed.state})` : '';
+    const body = typeof parsed.body === 'string' && parsed.body.trim() !== '' ? capped(parsed.body, BODY_CAP) : '_(no description)_';
+    const lines = [`### ${ref}: ${title}${state}`, '', body];
+    const comments = Array.isArray(parsed.comments) ? parsed.comments : [];
+    if (comments.length > 0) {
+        lines.push('', `Comments (${comments.length}${comments.length > MAX_COMMENTS ? `, the last ${MAX_COMMENTS} shown` : ''}):`);
+        for (const c of comments.slice(-MAX_COMMENTS)) {
+            const who = typeof c?.author?.login === 'string' ? c.author.login : 'unknown';
+            const text = typeof c?.body === 'string' ? capped(c.body, COMMENT_CAP) : '';
+            lines.push('', `- ${who}: ${text.replace(/\n/g, '\n  ')}`);
+        }
+    }
+    return { issue: { ref, resolved: true, title }, text: lines.join('\n') };
+}
+/**
+ * Read every issue `problem` names (at most {@link MAX_LINKED_ISSUES}) through `gh`, in `repoRoot`
+ * for a same-repository `#N`. Never throws: an unreadable issue is a `resolved: false` entry.
+ */
+export async function resolveLinkedIssues(problem, repoRoot, repoRef, exec = defaultGhExec) {
+    const { fixes, refs } = issueRefs(stripLinkedIssues(problem), repoRef ?? null);
+    const all = [...fixes, ...refs];
+    if (all.length === 0)
+        return { issues: [], block: null };
+    const read = await Promise.all(all.slice(0, MAX_LINKED_ISSUES).map((ref) => readOne(ref, repoRoot, exec)));
+    const skipped = all.slice(MAX_LINKED_ISSUES).map((ref) => ({
+        ref,
+        resolved: false,
+        error: `not read: a launch reads at most ${MAX_LINKED_ISSUES} issues`,
+    }));
+    const sections = read.map((r) => r.text);
+    if (skipped.length > 0)
+        sections.push(`Not read (a launch reads at most ${MAX_LINKED_ISSUES} issues): ${skipped.map((s) => s.ref).join(', ')}`);
+    const block = [
+        LINKED_ISSUES_OPEN,
+        '## Linked issues (read by the daemon at launch)',
+        '',
+        sections.join('\n\n'),
+        LINKED_ISSUES_CLOSE,
+    ].join('\n');
+    return { issues: [...read.map((r) => r.issue), ...skipped], block };
+}
+/** `problem` with the daemon's linked-issues block (if any) taken back out. */
+export function stripLinkedIssues(problem) {
+    const at = problem.indexOf(LINKED_ISSUES_OPEN);
+    if (at === -1)
+        return problem;
+    const end = problem.indexOf(LINKED_ISSUES_CLOSE, at);
+    const tail = end === -1 ? '' : problem.slice(end + LINKED_ISSUES_CLOSE.length);
+    return `${problem.slice(0, at)}${tail}`.trimEnd();
+}
+//# sourceMappingURL=linked-issues.js.map

package/dist/core/linked-issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-issues.js","sourceRoot":"","sources":["../../src/core/linked-issues.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAe,MAAM,cAAc,CAAC;AAE1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,oCAAoC,CAAC;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAG,qCAAqC,CAAC;AAEzE,oFAAoF;AACpF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,4EAA4E;AAC5E,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAC7C,MAAM,QAAQ,GAAG,KAAK,CAAC;AACvB,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,YAAY,GAAG,EAAE,CAAC;AA2BxB,SAAS,MAAM,CAAC,IAAY,EAAE,GAAW;IACvC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,OAAO,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,CAAC;AAC5F,CAAC;AAED,6FAA6F;AAC7F,SAAS,QAAQ,CAAC,GAAW;IAC3B,MAAM,CAAC,GAAG,iCAAiC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,GAAuB,EAAE,IAAY;IACvE,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,CAAC,KAAa,EAAwC,EAAE,CAAC,CAAC;QACrE,KAAK,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE;QACtC,IAAI,EAAE,OAAO,GAAG,wBAAwB,KAAK,GAAG;KACjD,CAAC,CAAC;IACH,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAClE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACvG,IAAI,GAA4D,CAAC;IACjE,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,+BAA+B,CAAC,EAAE;YACxF,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;YACzB,SAAS,EAAE,uBAAuB;SACnC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;QAC5F,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnI,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAY,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/F,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC;IACjI,MAAM,KAAK,GAAG,CAAC,OAAO,GAAG,KAAK,KAAK,GAAG,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,cAAc,YAAY,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC5H,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9E,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAe,EACf,QAA4B,EAC5B,OAA2B,EAC3B,OAAe,aAAa;IAE5B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IAChC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3G,MAAM,OAAO,GAAkB,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACxE,GAAG;QACH,QAAQ,EAAE,KAAK;QACf,KAAK,EAAE,oCAAoC,iBAAiB,SAAS;KACtE,CAAC,CAAC,CAAC;IACJ,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,oCAAoC,iBAAiB,aAAa,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChJ,MAAM,KAAK,GAAG;QACZ,kBAAkB;QAClB,iDAAiD;QACjD,EAAE;QACF,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QACrB,mBAAmB;KACpB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC;AACtE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/C,IAAI,EAAE,KAAK,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC/E,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;AACpD,CAAC"}

package/dist/core/run-identity.d.ts

@@ -0,0 +1,100 @@
+/**
+ * "What is this run?" — the ONE resolver (seam X2), read from the engine's own record.
+ *
+ * The engine stores a synthetic `workflow_id` on every run it launches (`wf-<run>`), so the name a
+ * run was launched under is not on the session's `workflow_id`. Crew used to recover it by matching
+ * the run's unit sequence against its mirrors of the built-in defs — which stops matching the moment
+ * the engine's floor adds a step to a preset run, never matched a user plan (`<run>:plan-<rev>`),
+ * and cannot survive the mirrors being deleted. This module replaces that guess with what the
+ * engine RECORDED:
+ *
+ *   1. `AgentSession.team_plan` (wicked-core `TeamPlanState`, DES-TEAMING-002 §8.4) — present on a
+ *      run launched from a plan or a preset. `team_plan.preset` names the preset; absent, the run
+ *      is a USER PLAN.
+ *   2. The launch's `sessionStarted` frame in the engine's durable run event log (`workflowId`):
+ *      the preset name, the registered def id, the per-run plan def (`<run>:plan-<rev>`) or `null`
+ *      for a free-text run. The adapter reads it once per run and memoizes it (`launched` below);
+ *      this is the only record of a NON-team run's def, because the session keeps only `wf-<run>`.
+ *   3. A session whose `workflow_id` is not synthetic already names its def.
+ *
+ * Each unit's catalog id (`WorkUnit.catalog`, stamped by the engine on a catalog-composed plan) is
+ * carried as-is. Nothing here reads unit ids or phase sequences.
+ *
+ * SYSTEM classification lives here too, in ONE list keyed by preset/workflow name: the runs studio
+ * keeps off its delivery surfaces (chat, onboarding, the interactive seams, …). The served run
+ * carries it as `run_identity.system`, and `listWorkflows()` stamps the defs' `is_system` from the
+ * same list, so the two can no longer disagree.
+ */
+import type { RunIdentity, SessionView, WorkflowDef } from './types.js';
+/**
+ * The machine-owned workflows and presets — keyed by NAME, so a preset and the def it replaces
+ * classify alike (`chat` and `onboarding` are engine built-in presets since DES-TEAMING-002
+ * M3/M4). Studio hides these from its delivery surfaces and its work-mode selector;
+ * `GET /workflows` serves `is_system: true` for exactly these ids, and `GET /presets` serves
+ * `system: true` for a preset of one of these names.
+ */
+export declare const SYSTEM_WORKFLOWS: ReadonlySet<string>;
+/** Whether a preset/workflow name is a system one ({@link SYSTEM_WORKFLOWS}). */
+export declare function isSystemWorkflow(name: string | null | undefined): boolean;
+/**
+ * A def with its `is_system` flag set from {@link SYSTEM_WORKFLOWS} — the ONE source of the flag.
+ * Returns the same object when it already agrees (a registered def's own `is_system` is not a
+ * second source: it is overwritten either way).
+ */
+export declare function withSystemFlag<T extends WorkflowDef>(def: T): T;
+/**
+ * A preset with its `system` flag set from {@link SYSTEM_WORKFLOWS} — the preset's half of the one
+ * classification (DES-TEAMING-002 §11.3: delivery classification reads the preset's system flag
+ * where it read the def's `is_system`).
+ */
+export declare function withPresetSystemFlag<T extends {
+    name: string;
+}>(preset: T): T & {
+    system: boolean;
+};
+/**
+ * The run a per-run plan def id belongs to — `<run>:plan-<rev>`, `rev` a positive decimal
+ * (wicked-core `plan::per_run_def_run_id`, the same reserved shape). `null` for any other id.
+ */
+export declare function perRunPlanRunId(defId: string): string | null;
+/** The engine's synthetic instance id — a session that carries it does not name its def. */
+export declare function isSyntheticWorkflowId(workflowId: string): boolean;
+/** What the resolver answers: the wire identity plus each unit's catalog id, in `ord` order. */
+export interface ResolvedRun extends RunIdentity {
+    /** `WorkUnit.catalog` per unit, ordered by `ord` — `null` for a unit not planned from the catalog. */
+    catalog: Array<string | null>;
+}
+/**
+ * Resolve a run from its record.
+ *
+ * `launched` is the launch's `sessionStarted.workflowId` from the engine's event log: `undefined`
+ * when it is not known (no log binding, a run predating the log, or a caller that has none),
+ * `null` when the launch named nothing (a free-text run). Pure.
+ */
+export declare function resolveRunIdentity(view: SessionView, launched?: string | null): ResolvedRun;
+/** The wire half of a resolution (`AgentSession.run_identity`): the identity without the catalog. */
+export declare function wireIdentity(resolved: ResolvedRun): RunIdentity;
+/**
+ * The identity of a served run view: the one the adapter attached (`session.run_identity`, which
+ * the event-log read informed), else resolved from the record alone. Every caller asking "what is
+ * this run?" goes through here.
+ */
+export declare function runIdentityOf(view: SessionView): ResolvedRun;
+/** The run's preset or workflow NAME (`null` for a user plan, a free-text run, or an unknown one). */
+export declare function runNameOf(view: SessionView): string | null;
+/**
+ * The registered def carrying the run's name, for callers that read def fields (acceptance,
+ * delivery candidacy, the deliver text). `null` when the run has no name or the registry holds no
+ * def under it. A lookup BY NAME — never by phase sequence.
+ */
+export declare function runWorkflowDef(view: SessionView, workflows: WorkflowDef[]): WorkflowDef | null;
+/**
+ * The catalog ids whose entry declares `verified_evidence`, from `Core.catalog()`'s entries —
+ * `null` when the catalog does not carry the flag (an older engine), so no caller mistakes "not
+ * said" for "none".
+ */
+export declare function verifiedEvidenceCatalog(entries: ReadonlyArray<{
+    id: string;
+    verified_evidence?: boolean;
+}>): ReadonlySet<string> | null;
+//# sourceMappingURL=run-identity.d.ts.map

package/dist/core/run-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-identity.d.ts","sourceRoot":"","sources":["../../src/core/run-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGxE;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAY/C,CAAC;AAEH,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAO/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAEnG;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5D;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,gGAAgG;AAChG,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,sGAAsG;IACtG,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC/B;AAgBD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,CAK3F;AA2BD,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAK5D;AAED,sGAAsG;AACtG,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,WAAW,GAAG,IAAI,CAI9F;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAGvI"}

package/dist/core/run-identity.js

@@ -0,0 +1,178 @@
+/**
+ * "What is this run?" — the ONE resolver (seam X2), read from the engine's own record.
+ *
+ * The engine stores a synthetic `workflow_id` on every run it launches (`wf-<run>`), so the name a
+ * run was launched under is not on the session's `workflow_id`. Crew used to recover it by matching
+ * the run's unit sequence against its mirrors of the built-in defs — which stops matching the moment
+ * the engine's floor adds a step to a preset run, never matched a user plan (`<run>:plan-<rev>`),
+ * and cannot survive the mirrors being deleted. This module replaces that guess with what the
+ * engine RECORDED:
+ *
+ *   1. `AgentSession.team_plan` (wicked-core `TeamPlanState`, DES-TEAMING-002 §8.4) — present on a
+ *      run launched from a plan or a preset. `team_plan.preset` names the preset; absent, the run
+ *      is a USER PLAN.
+ *   2. The launch's `sessionStarted` frame in the engine's durable run event log (`workflowId`):
+ *      the preset name, the registered def id, the per-run plan def (`<run>:plan-<rev>`) or `null`
+ *      for a free-text run. The adapter reads it once per run and memoizes it (`launched` below);
+ *      this is the only record of a NON-team run's def, because the session keeps only `wf-<run>`.
+ *   3. A session whose `workflow_id` is not synthetic already names its def.
+ *
+ * Each unit's catalog id (`WorkUnit.catalog`, stamped by the engine on a catalog-composed plan) is
+ * carried as-is. Nothing here reads unit ids or phase sequences.
+ *
+ * SYSTEM classification lives here too, in ONE list keyed by preset/workflow name: the runs studio
+ * keeps off its delivery surfaces (chat, onboarding, the interactive seams, …). The served run
+ * carries it as `run_identity.system`, and `listWorkflows()` stamps the defs' `is_system` from the
+ * same list, so the two can no longer disagree.
+ */
+import { baseWorkflowId } from './deliver-text.js';
+/**
+ * The machine-owned workflows and presets — keyed by NAME, so a preset and the def it replaces
+ * classify alike (`chat` and `onboarding` are engine built-in presets since DES-TEAMING-002
+ * M3/M4). Studio hides these from its delivery surfaces and its work-mode selector;
+ * `GET /workflows` serves `is_system: true` for exactly these ids, and `GET /presets` serves
+ * `system: true` for a preset of one of these names.
+ */
+export const SYSTEM_WORKFLOWS = new Set([
+    'chat',
+    'onboarding',
+    'capture-learnings',
+    'steering-author',
+    // The Demo experience's preset (api/demo.ts, studio#373): launched from Demo mode with its demo
+    // root, never from a general preset picker; it delivers nothing.
+    'demo',
+    // The interactive document seams (`interactive/*-events.ts`).
+    'interactive-chat',
+    'interactive-draft',
+    'interactive-edit',
+]);
+/** Whether a preset/workflow name is a system one ({@link SYSTEM_WORKFLOWS}). */
+export function isSystemWorkflow(name) {
+    return typeof name === 'string' && SYSTEM_WORKFLOWS.has(name);
+}
+/**
+ * A def with its `is_system` flag set from {@link SYSTEM_WORKFLOWS} — the ONE source of the flag.
+ * Returns the same object when it already agrees (a registered def's own `is_system` is not a
+ * second source: it is overwritten either way).
+ */
+export function withSystemFlag(def) {
+    const system = SYSTEM_WORKFLOWS.has(def.id);
+    if (system)
+        return def.is_system === true ? def : { ...def, is_system: true };
+    if (!('is_system' in def))
+        return def;
+    const rest = { ...def };
+    delete rest.is_system;
+    return rest;
+}
+/**
+ * A preset with its `system` flag set from {@link SYSTEM_WORKFLOWS} — the preset's half of the one
+ * classification (DES-TEAMING-002 §11.3: delivery classification reads the preset's system flag
+ * where it read the def's `is_system`).
+ */
+export function withPresetSystemFlag(preset) {
+    return { ...preset, system: isSystemWorkflow(preset.name) };
+}
+/**
+ * The run a per-run plan def id belongs to — `<run>:plan-<rev>`, `rev` a positive decimal
+ * (wicked-core `plan::per_run_def_run_id`, the same reserved shape). `null` for any other id.
+ */
+export function perRunPlanRunId(defId) {
+    const at = defId.lastIndexOf(':plan-');
+    if (at <= 0)
+        return null;
+    const rev = defId.slice(at + ':plan-'.length);
+    return /^[1-9]\d*$/.test(rev) ? defId.slice(0, at) : null;
+}
+/** The engine's synthetic instance id — a session that carries it does not name its def. */
+export function isSyntheticWorkflowId(workflowId) {
+    return workflowId.startsWith('wf-');
+}
+function teamPlanOf(view) {
+    const plan = view.session.team_plan;
+    return plan !== null && typeof plan === 'object' ? plan : null;
+}
+function identity(kind, name) {
+    return { kind, name, user_plan: kind === 'user_plan', system: isSystemWorkflow(name) };
+}
+/**
+ * Resolve a run from its record.
+ *
+ * `launched` is the launch's `sessionStarted.workflowId` from the engine's event log: `undefined`
+ * when it is not known (no log binding, a run predating the log, or a caller that has none),
+ * `null` when the launch named nothing (a free-text run). Pure.
+ */
+export function resolveRunIdentity(view, launched) {
+    const catalog = [...(view.units ?? [])]
+        .sort((a, b) => a.ord - b.ord)
+        .map((u) => (typeof u.catalog === 'string' && u.catalog !== '' ? u.catalog : null));
+    return { ...identityOf(view, launched), catalog };
+}
+function identityOf(view, launched) {
+    const s = view.session;
+    const plan = teamPlanOf(view);
+    if (plan !== null) {
+        return typeof plan.preset === 'string' && plan.preset !== ''
+            ? identity('preset', plan.preset)
+            : identity('user_plan', null);
+    }
+    const recorded = typeof s.workflow_id === 'string' ? s.workflow_id : '';
+    if (recorded !== '' && perRunPlanRunId(recorded) !== null)
+        return identity('user_plan', null);
+    if (recorded !== '' && !isSyntheticWorkflowId(recorded)) {
+        return identity('workflow', baseWorkflowId(recorded, s.id));
+    }
+    if (launched === undefined)
+        return identity('unknown', null);
+    if (launched === null || launched === '')
+        return identity('free_text', null);
+    if (perRunPlanRunId(launched) !== null)
+        return identity('user_plan', null);
+    // A preset launch whose plan state is not written yet (the planning stub) names its preset here
+    // too; its units, once planned, carry catalog ids. Either way the NAME is what callers read.
+    const catalogPlanned = (view.units ?? []).some((u) => typeof u.catalog === 'string' || u.team_run === true);
+    // A crew-composed per-run def (`<base>-deliver-<run>`, `<base>-verified-<run>`) reads as its base.
+    return identity(catalogPlanned ? 'preset' : 'workflow', baseWorkflowId(launched, s.id));
+}
+/** The wire half of a resolution (`AgentSession.run_identity`): the identity without the catalog. */
+export function wireIdentity(resolved) {
+    return { kind: resolved.kind, name: resolved.name, user_plan: resolved.user_plan, system: resolved.system };
+}
+/**
+ * The identity of a served run view: the one the adapter attached (`session.run_identity`, which
+ * the event-log read informed), else resolved from the record alone. Every caller asking "what is
+ * this run?" goes through here.
+ */
+export function runIdentityOf(view) {
+    const attached = view.session.run_identity;
+    const resolved = resolveRunIdentity(view);
+    if (attached === undefined || attached === null)
+        return resolved;
+    return { ...attached, catalog: resolved.catalog };
+}
+/** The run's preset or workflow NAME (`null` for a user plan, a free-text run, or an unknown one). */
+export function runNameOf(view) {
+    return runIdentityOf(view).name;
+}
+/**
+ * The registered def carrying the run's name, for callers that read def fields (acceptance,
+ * delivery candidacy, the deliver text). `null` when the run has no name or the registry holds no
+ * def under it. A lookup BY NAME — never by phase sequence.
+ */
+export function runWorkflowDef(view, workflows) {
+    const name = runNameOf(view);
+    if (name === null)
+        return null;
+    return workflows.find((w) => w.id === name) ?? null;
+}
+/**
+ * The catalog ids whose entry declares `verified_evidence`, from `Core.catalog()`'s entries —
+ * `null` when the catalog does not carry the flag (an older engine), so no caller mistakes "not
+ * said" for "none".
+ */
+export function verifiedEvidenceCatalog(entries) {
+    if (entries.length === 0 || entries.some((e) => typeof e.verified_evidence !== 'boolean'))
+        return null;
+    return new Set(entries.filter((e) => e.verified_evidence === true).map((e) => e.id));
+}
+//# sourceMappingURL=run-identity.js.map

package/dist/core/run-identity.js.map

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

package/dist/core/shutdown.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The daemon's shutdown sequence with a DEADLINE (crew#471).
+ *
+ * `wicked-crew serve` answered SIGTERM by reaping its bridge children and closing the engine
+ * subscription, then exiting. While the engine's actor was busy planning a large launch those
+ * steps never finished, so the daemon ignored `pkill` and needed SIGKILL. The steps still run
+ * first, best-effort; when they have not finished within the deadline the process exits anyway.
+ */
+/** How long the graceful half of a shutdown may take before the process exits regardless. */
+export declare const SHUTDOWN_DEADLINE_MS = 5000;
+/**
+ * Run `steps`, then `exit(0)`, and `exit(0)` at `deadlineMs` if the steps are still running.
+ * A step that throws never blocks the exit. `exit` is called exactly once.
+ */
+export declare function shutdownWithDeadline(steps: () => Promise<void>, exit: (code: number) => void, deadlineMs?: number, warn?: (message: string) => void): void;
+//# sourceMappingURL=shutdown.d.ts.map

package/dist/core/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6FAA6F;AAC7F,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC1B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC5B,UAAU,GAAE,MAA6B,EACzC,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAA6B,GACvD,IAAI,CAqBN"}

package/dist/core/shutdown.js

@@ -0,0 +1,39 @@
+/**
+ * The daemon's shutdown sequence with a DEADLINE (crew#471).
+ *
+ * `wicked-crew serve` answered SIGTERM by reaping its bridge children and closing the engine
+ * subscription, then exiting. While the engine's actor was busy planning a large launch those
+ * steps never finished, so the daemon ignored `pkill` and needed SIGKILL. The steps still run
+ * first, best-effort; when they have not finished within the deadline the process exits anyway.
+ */
+/** How long the graceful half of a shutdown may take before the process exits regardless. */
+export const SHUTDOWN_DEADLINE_MS = 5_000;
+/**
+ * Run `steps`, then `exit(0)`, and `exit(0)` at `deadlineMs` if the steps are still running.
+ * A step that throws never blocks the exit. `exit` is called exactly once.
+ */
+export function shutdownWithDeadline(steps, exit, deadlineMs = SHUTDOWN_DEADLINE_MS, warn = (m) => console.warn(m)) {
+    let exited = false;
+    const done = () => {
+        if (exited)
+            return;
+        exited = true;
+        exit(0);
+    };
+    const timer = setTimeout(() => {
+        warn(`[daemon] shutdown steps still running after ${deadlineMs} ms — exiting anyway (crew#471)`);
+        done();
+    }, deadlineMs);
+    timer.unref?.();
+    void (async () => {
+        try {
+            await steps();
+        }
+        catch {
+            /* best-effort: a failed step never blocks the exit */
+        }
+        clearTimeout(timer);
+        done();
+    })();
+}
+//# sourceMappingURL=shutdown.js.map

package/dist/core/shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.js","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6FAA6F;AAC7F,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAA0B,EAC1B,IAA4B,EAC5B,aAAqB,oBAAoB,EACzC,OAAkC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAExD,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,GAAG,IAAI,CAAC;QACd,IAAI,CAAC,CAAC,CAAC,CAAC;IACV,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,IAAI,CAAC,+CAA+C,UAAU,iCAAiC,CAAC,CAAC;QACjG,IAAI,EAAE,CAAC;IACT,CAAC,EAAE,UAAU,CAAC,CAAC;IACf,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAChB,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACH,MAAM,KAAK,EAAE,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;QACxD,CAAC;QACD,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,IAAI,EAAE,CAAC;IACT,CAAC,CAAC,EAAE,CAAC;AACP,CAAC"}

package/dist/core/types.d.ts

@@ -19,7 +19,13 @@
  * FINALIZING core-ts `subscribe` seam to a single file (DES-STUDIO-001 §5.2).
  */
 export type * from 'wicked-crew-api-types';
-import type { SystemSettings } from 'wicked-crew-api-types';
+import type { RunTeamResponse, RunTeamUnit, SystemSettings } from 'wicked-crew-api-types';
+/** `Core.runTeam`'s JSON (DES-TEAMING-002 P1): the persisted half of `GET /runs/:id/team`, before
+ *  crew joins the bus rows and the folded ledger onto it. */
+export type RunTeamView = Omit<RunTeamResponse, 'units' | 'rows' | 'teamed' | 'transport'> & {
+    transport: NonNullable<RunTeamResponse['transport']>;
+    units: Array<Omit<RunTeamUnit, 'rows' | 'ledger'>>;
+};
 import { type BaseSkillPolicy } from '../skills/base-skill.js';
 /** The run id of the onboarding run started when a repo was registered. */
 export interface RepoOnboardRef {
@@ -71,6 +77,14 @@ export interface LaunchRunInput {
     };
     /** Workflow def id to drive (e.g. `domain-extraction`). Omit ⇒ free-text planning. */
     workflow?: string;
+    /**
+     * A USER-COMPOSED plan (DES-TEAMING-002 §8.4, seam T3; `LaunchRunBody.plan`), handed to the
+     * engine as `LaunchOptions.planJson`. The engine owns every fact about it (`plan.proposed`, the
+     * score, the floor, the approval matrix); crew only forwards the command. Mutually exclusive
+     * with `workflow`. The adapter fails CLOSED on an addon without `Core.supportsPlanLaunch` — napi
+     * ignores an undeclared field, so an older engine would run the launch unplanned and ungated.
+     */
+    plan?: import('wicked-crew-api-types').LaunchPlan;
     /**
      * Project to file this run into (DES-PROJECT-001 §2.2). The engine attaches the `crew.run`
      * membership atomically with the launch record; unknown/archived ⇒ the launch fails with no

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,mBAAmB,uBAAuB,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEvF,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8FAA8F;AAC9F,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC;IACf;;;;;;;;;;;;;;OAcG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,+FAA+F;AAC/F,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qCAAqC,KAAK,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,EAAG,UAAmB,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,oCAAoC,IAAI,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD;;;;;;;;;OASG;IACH,CAAC,GAAG,EAAE,UAAU,MAAM,EAAE,GAAG,OAAO,CAAC;IACnC;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,eAAO,MAAM,gBAAgB,EAAE,kBAiB9B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,mBAAmB,uBAAuB,CAAC;AAE3C,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE1F;6DAC6D;AAC7D,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC,GAAG;IAC3F,SAAS,EAAE,WAAW,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;IACrD,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;CACpD,CAAC;AAEF,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEvF,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8FAA8F;AAC9F,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,OAAO,uBAAuB,EAAE,UAAU,CAAC;IAClD;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC;IACf;;;;;;;;;;;;;;OAcG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,+FAA+F;AAC/F,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qCAAqC,KAAK,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,EAAG,UAAmB,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,oCAAoC,IAAI,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD;;;;;;;;;OASG;IACH,CAAC,GAAG,EAAE,UAAU,MAAM,EAAE,GAAG,OAAO,CAAC;IACnC;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,eAAO,MAAM,gBAAgB,EAAE,kBAqB9B,CAAC"}

package/dist/core/types.js

@@ -64,5 +64,9 @@ export const DEFAULT_SETTINGS = {
     // shim, signalled only by a /health warning). `baseSkillRef: ''` is the one OFF switch.
     baseSkillRef: DEFAULT_BASE_SKILL_REF,
     baseSkillPolicy: 'require',
+    // crew#549 — the deliver identity is UNSET by default: no login is baked into crew, and an
+    // operator who configures none keeps today's behaviour (the phase pushes as whatever login gh
+    // holds, and refuses when gh and git's credential disagree with each other).
+    deliverIdentityLogin: '',
 };
 //# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,EAAE,sBAAsB,EAAwB,MAAM,yBAAyB,CAAC;AAuHvF,+FAA+F;AAC/F,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,EAAE,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,UAAmB,CAAC;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC;AAkCtD,MAAM,CAAC,MAAM,gBAAgB,GAAuB;IAClD,cAAc,EAAE,GAAG;IACnB,kBAAkB,EAAE,4BAA4B;IAChD,8FAA8F;IAC9F,+FAA+F;IAC/F,0BAA0B,EAAE,qCAAqC;IACjE,6FAA6F;IAC7F,gFAAgF;IAChF,8DAA8D;IAC9D,cAAc,EAAE,IAAI;IACpB,+FAA+F;IAC/F,8FAA8F;IAC9F,6FAA6F;IAC7F,6FAA6F;IAC7F,wFAAwF;IACxF,YAAY,EAAE,sBAAsB;IACpC,eAAe,EAAE,SAAS;CAC3B,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAaH,OAAO,EAAE,sBAAsB,EAAwB,MAAM,yBAAyB,CAAC;AA+HvF,+FAA+F;AAC/F,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,EAAE,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,UAAmB,CAAC;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC;AAkCtD,MAAM,CAAC,MAAM,gBAAgB,GAAuB;IAClD,cAAc,EAAE,GAAG;IACnB,kBAAkB,EAAE,4BAA4B;IAChD,8FAA8F;IAC9F,+FAA+F;IAC/F,0BAA0B,EAAE,qCAAqC;IACjE,6FAA6F;IAC7F,gFAAgF;IAChF,8DAA8D;IAC9D,cAAc,EAAE,IAAI;IACpB,+FAA+F;IAC/F,8FAA8F;IAC9F,6FAA6F;IAC7F,6FAA6F;IAC7F,wFAAwF;IACxF,YAAY,EAAE,sBAAsB;IACpC,eAAe,EAAE,SAAS;IAC1B,2FAA2F;IAC3F,8FAA8F;IAC9F,6EAA6E;IAC7E,oBAAoB,EAAE,EAAE;CACzB,CAAC"}