wicked-crew 0.7.0 → 0.7.2

package/dist/core/adapter.d.ts

@@ -1,4 +1,4 @@
-import type { CoreEvent, LaunchRunInput, RepoEntry, RepoOnboardRef, SessionView, RecordedEvent, GovernancePolicy, ConformanceRule, GovernanceClaim, CoverageReport, GraphKind, WorkflowDef, CrewSystemSettings, Project, ProjectMember, InteractionRequest } from './types.js';
+import type { CoreEvent, LaunchRunInput, RepoEntry, RepoOnboardRef, SessionView, RecordedEvent, GovernancePolicy, ConformanceRule, GovernanceScoreboard, GovernanceClaim, CoverageReport, GraphKind, WorkflowDef, CrewSystemSettings, Project, ProjectMember, InteractionRequest, Campaign, CampaignDef } from './types.js';
 /** Where the daemon persists system settings. Exported so tests write fixtures to the ONE
  *  spelling of this path (the tests/ tree is audited against spelling core paths itself). */
 export declare function settingsFilePath(): string;
@@ -45,6 +45,27 @@ export declare class ProjectsUnsupportedError extends Error {
 export declare class ElicitationUnsupportedError extends Error {
     constructor(message: string);
 }
+/**
+ * The campaign surface (DES-CAMPAIGN-001 / TH-9) is not available in this deployment — the
+ * installed wicked-core-ts predates the campaign bindings. Typed for the same reason as
+ * `ChatUnsupportedError`: the routes answer 501 ("upgrade the engine") on this, never 400
+ * ("fix your request"). Gated on METHOD PRESENCE rather than a version floor because the
+ * bindings ship in the next core-ts release whose number is the release train's to pick —
+ * a presence check is true on whatever version actually carries them.
+ */
+export declare class CampaignsUnsupportedError extends Error {
+    constructor(what: string);
+}
+/**
+ * The wiki scoreboard (AW-23 / wiki-mgmt) is not available in this deployment — the installed
+ * wicked-core-ts predates the `governanceScoreboard` binding (ships in ≥ 0.7.4). Typed for the
+ * same reason as `ChatUnsupportedError`: the route answers 501 ("upgrade the engine") on this,
+ * never 400 ("fix your request"). Gated on METHOD PRESENCE, the campaigns doctrine — true on
+ * whatever release actually carries the binding.
+ */
+export declare class GovernanceScoreboardUnsupportedError extends Error {
+    constructor(what: string);
+}
 /** One live chat on the enumerate surface — see {@link CoreAdapter.chatList}. */
 export interface ChatSummary {
     chatId: string;
@@ -103,6 +124,18 @@ export declare class CoreAdapter {
     readonly engineExec: boolean;
     /** The bus db the exec seam runs over when armed (else `undefined`). */
     readonly busDbPath: string | undefined;
+    /**
+     * `true` when this adapter drives the DETERMINISTIC OFFLINE engine (`Core.spawnStub`) rather
+     * than the production one — i.e. the `StubDispatcher` (every seat votes for the first roster
+     * option, no subprocess) plus the `StubStepRunner` (fixed text, no CLI).
+     *
+     * Exposed, not private, because a stub engine is not a quieter production engine — it is a
+     * FABRICATOR. Every phase resolves Ok in under a millisecond, so a run narrates its whole
+     * governed lifecycle, gate approvals included, with no work behind any of it. Anything that
+     * lets this daemon answer OTHER products' traffic has to be able to ask (see
+     * `api/server.ts`, crew#309).
+     */
+    readonly stub: boolean;
     constructor(opts: CoreAdapterOptions);
     /** Register a CoreEvent listener. Returns an unsubscribe function. */
     onEvent(listener: CoreEventListener): () => void;
@@ -118,6 +151,32 @@ export declare class CoreAdapter {
     confirmGate(runId: string, approve: boolean, amend?: string): Promise<string>;
     /** Cancel a run → the status token. */
     cancelRun(runId: string): Promise<string>;
+    /** Whether the installed engine addon carries the campaign bindings. */
+    campaignsSupported(): boolean;
+    /** Guard: the campaign binding surface, or a typed 501-shaped refusal naming the action. */
+    private _campaigns;
+    /** Validate + launch a campaign DAG → the campaign id. `def` is the ENGINE wire shape
+     *  (snake_case) — `campaigns/plan.ts` is the one producer of it in this daemon.
+     *
+     *  `workflows` are the composed per-node Tool workflows the def's run_specs reference; they
+     *  are armed FIRST (hot-register + overlay persist) so the engine can resolve them both now
+     *  and after a restart — a campaign is durable, so its node workflows must be too. Unlike a
+     *  deliver-composed def they are NOT purely ephemeral (`_armPerRunWorkflow`), and unlike a
+     *  user workflow they never enter `userWorkflows` or the catalog (the hydration filter in
+     *  `readOverlayWorkflows` skips the `campaign-` prefix). */
+    launchCampaign(def: CampaignDef, workflows?: WorkflowDef[]): Promise<string>;
+    /** Arm one composed campaign-node workflow: validate-then-persist (the FINDING-002 ordering —
+     *  core's parser is the authority and runs BEFORE the overlay write), overlay file for
+     *  restart durability, no `userWorkflows` entry. */
+    private _armCampaignWorkflow;
+    /** Resume a campaign from its persisted state → the campaign status token. */
+    resumeCampaign(id: string): Promise<string>;
+    /** Cancel a campaign (in-flight node Runs cancelled, the rest marked) → the status token. */
+    cancelCampaign(id: string): Promise<string>;
+    /** A campaign's full persisted state (DAG + node statuses + run ids), or `null` when unknown. */
+    campaignDetail(id: string): Promise<Campaign | null>;
+    /** Every campaign on the store. */
+    campaignList(): Promise<Campaign[]>;
     /**
      * Archive (or unarchive) a TERMINAL run (crew#265) — write-off, not delete. Resolves `true`
      * when the session existed, `false` for an unknown id (→ 404); REJECTS when the run is
@@ -285,6 +344,30 @@ export declare class CoreAdapter {
     retireConformanceRule(id: string): Promise<boolean>;
     /** Recall conformance rules matching a facet query (read-only, does not block actor). */
     recallRulesPreview(query: Record<string, string | string[] | undefined>): Promise<ConformanceRule[]>;
+    /** Whether the installed engine addon carries the AW-23 scoreboard binding (core-ts ≥ 0.7.4). */
+    wikiScoreboardSupported(): boolean;
+    /**
+     * The wiki population/connection scoreboard (AW-23 / arch-R23) — typed %, resolving %,
+     * enforcement evidence, and an in-band honesty marker for what cannot be measured. Read-only
+     * on the engine side (`open_store_ro`), so it never blocks the single-writer actor.
+     *
+     * `docsRoot` is the same docs root `rules ingest --dir` used; omitted, the typing half reports
+     * `available: false` with the reason — an honest in-band answer, not an error.
+     *
+     * Presence-gated (the campaigns doctrine): throws {@link GovernanceScoreboardUnsupportedError}
+     * on an addon that predates the binding, which the route maps to 501 ("upgrade the engine").
+     */
+    governanceScoreboard(docsRoot?: string): Promise<GovernanceScoreboard>;
+    /**
+     * How many `RuleSet` rows (doctrine domain parents, AW-13) the store holds — or `null` when
+     * this engine build cannot count them (no `listRuleSets` binding yet).
+     *
+     * `null` rather than `0` on purpose (the `runEvents` doctrine): "no rulesets" is a real answer
+     * about an unseeded store, and "I cannot count" must never impersonate it — the wiki meta's
+     * empty state would otherwise report a seeded store as empty and point the operator at a
+     * runbook they already ran.
+     */
+    countRuleSets(): Promise<number | null>;
     private readonly userWorkflows;
     /** Whether {@link hydrateFromOverlay} has run this process lifetime. */
     private overlayHydrated;

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

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

package/dist/core/adapter.js

@@ -8,6 +8,7 @@ import { randomUUID } from 'node:crypto';
 import { DEFAULT_SETTINGS } from './types.js';
 import { execCapped } from './exec.js';
 import { composeDeliverWorkflow, DELIVER_PHASE_ID } from './deliver.js';
+import { CAMPAIGN_WORKFLOW_PREFIX } from '../campaigns/plan.js';
 import { composeDeliverableFloor } from './deliverable-floor.js';
 /** Resolved path under the user's home directory. */
 function wickedDir(...parts) {
@@ -50,6 +51,15 @@ function workflowOverlayDir() {
 export function settingsFilePath() {
     return join(homedir(), '.config', 'wicked-core', 'settings.json');
 }
+/**
+ * Per-key ceiling on a `studio.*` settings value, as the UTF-8 byte length of its JSON form.
+ *
+ * The same 512KiB limit `PUT /settings` enforces (`STUDIO_SETTINGS_MAX_BYTES`, api/routes.ts) —
+ * restated rather than imported because routes.ts imports THIS module, so a shared constant here
+ * would close an import cycle. The two spellings must stay in step; the read-path test restates
+ * the number a third time so a change to either side breaks a test rather than a deployment.
+ */
+const STUDIO_SETTINGS_MAX_BYTES = 512 * 1024;
 /** Read user-registered workflow overlays from `dir` (the same dir `registerWorkflow` writes to).
  *
  * Skips: files whose id matches a built-in (those are `_writeBuiltinOverlay` artifacts written FOR
@@ -73,6 +83,11 @@ export function readOverlayWorkflows(dir, builtinIds) {
         const id = file.slice(0, -'.json'.length);
         if (builtinIds.has(id))
             continue; // a built-in overlay, not a user workflow
+        // A composed campaign-node workflow (TH-9): persisted here so the Rust actor reloads it at
+        // startup (a fresh-process resumeCampaign re-dispatches pending nodes by workflow id), but
+        // it is one node's private plumbing, not a user workflow — keep it out of the catalog.
+        if (id.startsWith(CAMPAIGN_WORKFLOW_PREFIX))
+            continue;
         try {
             const def = JSON.parse(readFileSync(join(dir, file), 'utf8'));
             if (def && typeof def.id === 'string' && Array.isArray(def.phases))
@@ -384,6 +399,35 @@ export class ElicitationUnsupportedError extends Error {
         this.name = 'ElicitationUnsupportedError';
     }
 }
+/**
+ * The campaign surface (DES-CAMPAIGN-001 / TH-9) is not available in this deployment — the
+ * installed wicked-core-ts predates the campaign bindings. Typed for the same reason as
+ * `ChatUnsupportedError`: the routes answer 501 ("upgrade the engine") on this, never 400
+ * ("fix your request"). Gated on METHOD PRESENCE rather than a version floor because the
+ * bindings ship in the next core-ts release whose number is the release train's to pick —
+ * a presence check is true on whatever version actually carries them.
+ */
+export class CampaignsUnsupportedError extends Error {
+    constructor(what) {
+        super(`${what} is not supported by this wicked-core build (the installed wicked-core-ts has ` +
+            'no campaign bindings — upgrade it to a release carrying launchCampaign)');
+        this.name = 'CampaignsUnsupportedError';
+    }
+}
+/**
+ * The wiki scoreboard (AW-23 / wiki-mgmt) is not available in this deployment — the installed
+ * wicked-core-ts predates the `governanceScoreboard` binding (ships in ≥ 0.7.4). Typed for the
+ * same reason as `ChatUnsupportedError`: the route answers 501 ("upgrade the engine") on this,
+ * never 400 ("fix your request"). Gated on METHOD PRESENCE, the campaigns doctrine — true on
+ * whatever release actually carries the binding.
+ */
+export class GovernanceScoreboardUnsupportedError extends Error {
+    constructor(what) {
+        super(`${what} is not supported by this wicked-core build (the installed wicked-core-ts has ` +
+            'no governanceScoreboard binding — upgrade it to a release carrying it, >= 0.7.4)');
+        this.name = 'GovernanceScoreboardUnsupportedError';
+    }
+}
 /** The engine's own way of reporting a build that cannot do chat, raised at call time. */
 const ENGINE_CHAT_UNSUPPORTED = /chat unsupported/i;
 /**
@@ -476,6 +520,18 @@ export class CoreAdapter {
     engineExec;
     /** The bus db the exec seam runs over when armed (else `undefined`). */
     busDbPath;
+    /**
+     * `true` when this adapter drives the DETERMINISTIC OFFLINE engine (`Core.spawnStub`) rather
+     * than the production one — i.e. the `StubDispatcher` (every seat votes for the first roster
+     * option, no subprocess) plus the `StubStepRunner` (fixed text, no CLI).
+     *
+     * Exposed, not private, because a stub engine is not a quieter production engine — it is a
+     * FABRICATOR. Every phase resolves Ok in under a millisecond, so a run narrates its whole
+     * governed lifecycle, gate approvals included, with no work behind any of it. Anything that
+     * lets this daemon answer OTHER products' traffic has to be able to ask (see
+     * `api/server.ts`, crew#309).
+     */
+    stub;
     constructor(opts) {
         // Arm the EVENT-DRIVEN execution-mediation seam BEFORE spawning the Core: the Rust actor reads
         // `WICKED_BUS_EXEC` + `WICKED_BUS_DB` from the process env at spawn time (wicked-core actor::run),
@@ -505,7 +561,8 @@ export class CoreAdapter {
             if (wcExe)
                 process.env['WICKED_CORE_EXE'] = wcExe;
         }
-        this.core = opts.stub ? Core.spawnStub(opts.dbPath) : Core.spawn(opts.dbPath);
+        this.stub = opts.stub === true;
+        this.core = this.stub ? Core.spawnStub(opts.dbPath) : Core.spawn(opts.dbPath);
         // The ONE subscribe() for the process. Error-first callback (index.d.ts:56):
         // one JSON string per CoreEvent, in emission order. A throw in a listener is
         // isolated so one bad consumer can never stall the pump or the others.
@@ -623,11 +680,19 @@ export class CoreAdapter {
             if (composed !== null && requireDeliverables.length > 0) {
                 // THE DELIVERABLE FLOOR (crew#311): "done" is re-derived from the artifact. The
                 // launcher declared what this run must produce, so a deterministic Tool phase appended
-                // here re-verifies that those files EXIST and carry bytes, and fails the run naming
-                // what was expected and what was found when they do not. Composed BEFORE the deliver
-                // phase below so the floor sits ahead of it: a run that produced nothing must fail
-                // rather than open a pull request over an empty branch.
-                composed = composeDeliverableFloor(composed, input.sessionId, requireDeliverables);
+                // here re-verifies that those files EXIST, carry bytes, and were written by THIS RUN,
+                // and fails the run naming what was expected and what was found when they do not.
+                // Composed BEFORE the deliver phase below so the floor sits ahead of it: a run that
+                // produced nothing must fail rather than open a pull request over an empty branch.
+                //
+                // The timestamp is taken HERE, at composition — the last moment before `core.launchRun`
+                // below — and passed explicitly rather than left to the default, because the whole
+                // freshness claim rests on it: nothing this run produces can predate this line, so an
+                // artifact whose mtime does is a PRIOR run's leftover (crew#320). The interactive seams
+                // copy their deliverable to `outPath` and never remove it, and their run dirs are keyed
+                // by document id, so a re-run over the same key finds the previous file already there;
+                // without this the floor would pass on it and "done" would be asserted by a leftover.
+                composed = composeDeliverableFloor(composed, input.sessionId, requireDeliverables, Date.now());
             }
             if (composed !== null && input.deliver === 'pr') {
                 // First-class delivery (crew#293): compose a PER-RUN def — the selected workflow's
@@ -704,6 +769,77 @@ export class CoreAdapter {
     cancelRun(runId) {
         return this.core.cancelRun(runId);
     }
+    // ── Campaigns (DES-CAMPAIGN-001 / crew#342 + TH-9) ─────────────────────────
+    // The engine is the campaign store — durable, single-writer, crash-resumable (its Campaign
+    // rows persist beside AgentSessions on the same estate substrate). Crew keeps NO shadow copy:
+    // every read below asks the engine, so a daemon restart or a second daemon over the same db
+    // sees the same campaigns. `launchCampaign` is gated on METHOD PRESENCE (not a version floor)
+    // because the bindings ship in whatever core-ts release the train cuts next.
+    /** Whether the installed engine addon carries the campaign bindings. */
+    campaignsSupported() {
+        return typeof this.core.launchCampaign === 'function';
+    }
+    /** Guard: the campaign binding surface, or a typed 501-shaped refusal naming the action. */
+    _campaigns(what) {
+        if (typeof this.core.launchCampaign !== 'function' ||
+            typeof this.core.resumeCampaign !== 'function' ||
+            typeof this.core.cancelCampaign !== 'function' ||
+            typeof this.core.campaignDetail !== 'function' ||
+            typeof this.core.campaignList !== 'function') {
+            throw new CampaignsUnsupportedError(what);
+        }
+        return this.core;
+    }
+    /** Validate + launch a campaign DAG → the campaign id. `def` is the ENGINE wire shape
+     *  (snake_case) — `campaigns/plan.ts` is the one producer of it in this daemon.
+     *
+     *  `workflows` are the composed per-node Tool workflows the def's run_specs reference; they
+     *  are armed FIRST (hot-register + overlay persist) so the engine can resolve them both now
+     *  and after a restart — a campaign is durable, so its node workflows must be too. Unlike a
+     *  deliver-composed def they are NOT purely ephemeral (`_armPerRunWorkflow`), and unlike a
+     *  user workflow they never enter `userWorkflows` or the catalog (the hydration filter in
+     *  `readOverlayWorkflows` skips the `campaign-` prefix). */
+    async launchCampaign(def, workflows = []) {
+        const surface = this._campaigns('Launching a campaign');
+        for (const wf of workflows) {
+            await this._armCampaignWorkflow(wf);
+        }
+        return surface.launchCampaign(JSON.stringify(def));
+    }
+    /** Arm one composed campaign-node workflow: validate-then-persist (the FINDING-002 ordering —
+     *  core's parser is the authority and runs BEFORE the overlay write), overlay file for
+     *  restart durability, no `userWorkflows` entry. */
+    async _armCampaignWorkflow(def) {
+        const core = this.core;
+        const register = core['registerWorkflow'];
+        if (typeof register !== 'function') {
+            // Unreachable on any addon that carries launchCampaign (registerWorkflow predates it by
+            // several releases), but the guard keeps the failure loud if that ever un-holds.
+            throw new CampaignsUnsupportedError('Arming a campaign node workflow');
+        }
+        await register.call(this.core, JSON.stringify(def));
+        const dir = workflowOverlayDir();
+        await mkdir(dir, { recursive: true });
+        await writeFile(join(dir, `${def.id}.json`), JSON.stringify(def, null, 2), 'utf8');
+    }
+    /** Resume a campaign from its persisted state → the campaign status token. */
+    resumeCampaign(id) {
+        return this._campaigns('Resuming a campaign').resumeCampaign(id);
+    }
+    /** Cancel a campaign (in-flight node Runs cancelled, the rest marked) → the status token. */
+    cancelCampaign(id) {
+        return this._campaigns('Cancelling a campaign').cancelCampaign(id);
+    }
+    /** A campaign's full persisted state (DAG + node statuses + run ids), or `null` when unknown. */
+    async campaignDetail(id) {
+        const raw = await this._campaigns('Reading a campaign').campaignDetail(id);
+        return parseEngineJson(raw, 'campaignDetail');
+    }
+    /** Every campaign on the store. */
+    async campaignList() {
+        const raw = await this._campaigns('Listing campaigns').campaignList();
+        return parseEngineJson(raw, 'campaignList');
+    }
     /**
      * Archive (or unarchive) a TERMINAL run (crew#265) — write-off, not delete. Resolves `true`
      * when the session existed, `false` for an unknown id (→ 404); REJECTS when the run is
@@ -1162,6 +1298,45 @@ export class CoreAdapter {
         const json = await this.core.recallRulesPreview(JSON.stringify(cleanQuery));
         return JSON.parse(json);
     }
+    // ── Governance wiki management (wiki-mgmt) ─────────────────────────────────
+    /** Whether the installed engine addon carries the AW-23 scoreboard binding (core-ts ≥ 0.7.4). */
+    wikiScoreboardSupported() {
+        return typeof this.core.governanceScoreboard === 'function';
+    }
+    /**
+     * The wiki population/connection scoreboard (AW-23 / arch-R23) — typed %, resolving %,
+     * enforcement evidence, and an in-band honesty marker for what cannot be measured. Read-only
+     * on the engine side (`open_store_ro`), so it never blocks the single-writer actor.
+     *
+     * `docsRoot` is the same docs root `rules ingest --dir` used; omitted, the typing half reports
+     * `available: false` with the reason — an honest in-band answer, not an error.
+     *
+     * Presence-gated (the campaigns doctrine): throws {@link GovernanceScoreboardUnsupportedError}
+     * on an addon that predates the binding, which the route maps to 501 ("upgrade the engine").
+     */
+    async governanceScoreboard(docsRoot) {
+        const fn = this.core.governanceScoreboard;
+        if (typeof fn !== 'function') {
+            throw new GovernanceScoreboardUnsupportedError('Reading the governance wiki scoreboard');
+        }
+        return parseEngineJson(await fn.call(this.core, docsRoot ?? null), 'governanceScoreboard');
+    }
+    /**
+     * How many `RuleSet` rows (doctrine domain parents, AW-13) the store holds — or `null` when
+     * this engine build cannot count them (no `listRuleSets` binding yet).
+     *
+     * `null` rather than `0` on purpose (the `runEvents` doctrine): "no rulesets" is a real answer
+     * about an unseeded store, and "I cannot count" must never impersonate it — the wiki meta's
+     * empty state would otherwise report a seeded store as empty and point the operator at a
+     * runbook they already ran.
+     */
+    async countRuleSets() {
+        const fn = this.core.listRuleSets;
+        if (typeof fn !== 'function')
+            return null;
+        const rows = parseEngineJson(await fn.call(this.core), 'listRuleSets');
+        return Array.isArray(rows) ? rows.length : null;
+    }
     // ── Workflow viewer + builder (crew#44) ────────────────────────────────────
     // Built-ins are static TypeScript mirrors of workflow.rs. User-registered
     // workflows are added to `userWorkflows` and persisted to disk; the Rust actor
@@ -1389,6 +1564,29 @@ export class CoreAdapter {
                 if (typeof r !== 'string' || (r !== '' && !isAbsolute(r)))
                     delete parsed.worker_config_root;
             }
+            // Skin-owned `studio.*` blobs (crew#325): the same per-key cap the PUT /settings route
+            // enforces. The write cap alone cannot hold it — `updateSettings` reads through here, so a
+            // value hand-edited past the cap is served in full AND carried forward by a later patch that
+            // never names it, which makes the ceiling un-lowerable. Dropped LOUDLY: the daemon cannot
+            // interpret these values, so an operator whose theme "reset itself" has nothing to go on
+            // unless the drop names the key and the limit (silence is what made #323 invisible).
+            // Namespace prefix, not the route's stricter key regex — the cap is about bytes in
+            // settings.json, and a hand-edited `studio.Foo` the route would never have admitted costs
+            // exactly as much to store and to propagate.
+            const bag = parsed;
+            for (const key of Object.keys(bag)) {
+                if (!key.startsWith('studio.'))
+                    continue;
+                const bytes = Buffer.byteLength(JSON.stringify(bag[key]), 'utf8');
+                if (bytes > STUDIO_SETTINGS_MAX_BYTES) {
+                    delete bag[key];
+                    console.warn(`[settings] dropped ${key} from ${settingsFilePath()}: ${bytes} bytes of JSON, over ` +
+                        `the ${STUDIO_SETTINGS_MAX_BYTES}-byte per-key cap on studio.* settings. PUT ` +
+                        `/settings refuses a write this size, so this value was hand-edited in or predates ` +
+                        `the cap; it is dropped on read rather than served and rewritten forward. Shrink it ` +
+                        `in the file to get it back — nothing else in settings.json is affected (crew#325).`);
+                }
+            }
             return { ...DEFAULT_SETTINGS, ...parsed };
         }
         catch {