wicked-crew 0.7.1 → 0.7.3

package/dist/campaigns/plan.js

@@ -0,0 +1,201 @@
+/**
+ * Scenario → CampaignNode mapping (TH-9; DES-CAMPAIGN-001 §8).
+ *
+ * `POST /campaigns` accepts a batch of SCENARIOS (the qe-campaign vocabulary: garden's
+ * campaign-recon rungs, or any caller's batch of checks) and this module maps them onto the
+ * engine's `CampaignDef` — nodes, `on_success`/`on_terminal` edges, and one composed
+ * single-phase workflow per deterministic scenario. Pure data-in/data-out: no engine handle,
+ * no I/O, so every rule below is unit-testable without spawning a Core.
+ *
+ * ## The two scenario shapes, and where the work actually lives
+ *
+ *  - **`tool` (deterministic)** — the scenario is a spec FILE (garden's runner spec, a script,
+ *    any argv-runnable check) and the node's workflow is one Tool-executor phase running that
+ *    argv verbatim: no council, no LLM, near-zero cost. The engine's Tool path (`run_tool_cmd`)
+ *    spawns the command directly.
+ *  - **`agent` (exploratory / authoring)** — a governed agent run over a problem statement;
+ *    seats are spent only where judgment is the work (test-R9).
+ *
+ * ## The 1022-byte rule (load-bearing, enforced here)
+ *
+ * PTY worker prompts longer than 1022 bytes are SILENTLY DISCARDED by the canonical line
+ * discipline — the worker waits on input that never arrives and the unit burns its full
+ * timeout (the S8 campaign finding; memory: "PTY canonical line limit"). The mapping
+ * therefore refuses, loudly and per-token, anything that smells like a scenario BODY inlined
+ * where a FILE PATH belongs: every Tool argv token and every agent problem statement must be
+ * a single line of at most {@link MAX_INLINE_BYTES} bytes. The fix is always the same and the
+ * error says it: persist the content as a file and pass its path.
+ */
+/**
+ * Byte ceiling for a single inline string handed to a node (a Tool argv token, an agent
+ * problem). 1022 is the PTY canonical-line limit — the longest line a worker's stdin
+ * accepts before the kernel silently discards it. Tool argv does not itself traverse a PTY,
+ * but the ceiling is enforced uniformly because the failure it guards against is the same
+ * SHAPE either way: scenario bodies belong in files, and a token this long is a body.
+ */
+export const MAX_INLINE_BYTES = 1022;
+/** id rule for campaigns and scenarios: overlay-file-safe, run-id-safe (no `:` — the engine
+ *  keys node run ids `{campaign}:{node}:a{attempt}`), and short enough that the composed
+ *  workflow id (`campaign-<campaign>-<scenario>`) stays under core's 128-char id cap. */
+const SAFE_ID = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
+const MAX_CAMPAIGN_ID = 64;
+const MAX_SCENARIO_ID = 48;
+/** Composed node workflows carry this prefix — the adapter keeps them OUT of the workflow
+ *  catalog (`listWorkflows`) while still persisting them to the overlay dir so a fresh-process
+ *  `resumeCampaign` can re-dispatch pending nodes by workflow id. */
+export const CAMPAIGN_WORKFLOW_PREFIX = 'campaign-';
+/** The composed workflow id for one deterministic scenario node. */
+export function scenarioWorkflowId(campaignId, scenarioId) {
+    return `${CAMPAIGN_WORKFLOW_PREFIX}${campaignId}-${scenarioId}`;
+}
+/** Throw with the scenario + token named when an inline string breaks the single-line /
+ *  byte-ceiling rule. One spelling of the rule for both scenario shapes. */
+function assertInline(scenarioId, what, value) {
+    if (/[\r\n]/.test(value)) {
+        throw new Error(`scenario '${scenarioId}': ${what} contains a newline — scenario bodies are never ` +
+            'inlined; persist the content as a file and pass its path');
+    }
+    const bytes = Buffer.byteLength(value, 'utf8');
+    if (bytes > MAX_INLINE_BYTES) {
+        throw new Error(`scenario '${scenarioId}': ${what} is ${bytes} bytes — over the ${MAX_INLINE_BYTES}-byte ` +
+            'PTY canonical-line limit (longer input is SILENTLY DISCARDED and the unit burns its ' +
+            'timeout). Persist the content as a file and pass its path instead');
+    }
+}
+/** The single Tool-executor phase of a deterministic scenario node.
+ *
+ * `verified_evidence: false`, deliberately (contrast `core/deliver.ts`, which arms the built-in
+ * evidence floor): that floor re-derives "done" from a WORKTREE DIFF, and a scenario run —
+ * probing an API, reading state — legitimately leaves none, so arming it would deny every
+ * honest PASS. The executor's exit status is an executor CLAIM, not a verdict; grading belongs
+ * to the qe accept trio (garden TH-10) and the acceptance gate re-derives "done" from ledger
+ * rows (TH-6). `executes_code: false` for the same reason as the deliver phase: deterministic
+ * tooling, not governed agent work.
+ */
+function toolPhase(cmd) {
+    return {
+        id: 'execute',
+        kind: 'test',
+        executor: { type: 'tool', cmd },
+        gate_type: null,
+        gate: 'auto',
+        executes_code: false,
+        verified_evidence: false,
+        required_deliverables: [],
+        depends_on: [],
+        role: 'neutral',
+        skill_ref: null,
+        allowed_skills: [],
+        validator_pin: null,
+    };
+}
+/**
+ * Map a `POST /campaigns` body onto the engine's `CampaignDef` + the per-node workflows to arm.
+ *
+ * Throws a plain `Error` (the route answers 400 with the message) on: a malformed campaign or
+ * scenario id, a duplicate scenario id, a scenario with neither/both of `tool`/`agent`, an
+ * empty argv, an inline-rule break ({@link assertInline}), an unknown/self/duplicate dep, or an
+ * `agent.workflow` that is itself a composed campaign workflow. Cycles are LEFT to the engine's
+ * own launch validation — one authority for graph shape, and its reject arrives before anything
+ * persists.
+ *
+ * `defaultClis` is the parsed council roster used for every node that does not carry its own —
+ * Tool nodes never convene it (the phase bypasses the council), agent nodes do.
+ */
+export function buildCampaign(body, defaultClis) {
+    const campaignId = body.id ?? `campaign-${Date.now().toString(36)}`;
+    if (!SAFE_ID.test(campaignId) || campaignId.length > MAX_CAMPAIGN_ID) {
+        throw new Error(`campaign id '${campaignId}' must start with a letter/digit, contain only letters, ` +
+            `digits, dots, hyphens, and underscores, and be at most ${MAX_CAMPAIGN_ID} chars`);
+    }
+    if (body.scenarios.length === 0) {
+        throw new Error('a campaign needs at least one scenario');
+    }
+    const ids = new Set();
+    for (const s of body.scenarios) {
+        if (!SAFE_ID.test(s.id) || s.id.length > MAX_SCENARIO_ID) {
+            throw new Error(`scenario id '${s.id}' must start with a letter/digit, contain only letters, digits, ` +
+                `dots, hyphens, and underscores, and be at most ${MAX_SCENARIO_ID} chars`);
+        }
+        if (ids.has(s.id))
+            throw new Error(`duplicate scenario id '${s.id}'`);
+        ids.add(s.id);
+    }
+    const nodes = [];
+    const edges = [];
+    const workflows = [];
+    for (const s of body.scenarios) {
+        nodes.push(buildNode(campaignId, s, defaultClis, workflows));
+        const seenDeps = new Set();
+        for (const dep of s.deps ?? []) {
+            if (dep === s.id)
+                throw new Error(`scenario '${s.id}' depends on itself`);
+            if (!ids.has(dep)) {
+                throw new Error(`scenario '${s.id}' depends on unknown scenario '${dep}'`);
+            }
+            if (seenDeps.has(dep)) {
+                throw new Error(`scenario '${s.id}' names dep '${dep}' twice`);
+            }
+            seenDeps.add(dep);
+            edges.push({ from: dep, to: s.id, condition: s.depsCondition ?? 'on_success' });
+        }
+    }
+    return {
+        def: {
+            id: campaignId,
+            name: body.name ?? campaignId,
+            nodes,
+            edges,
+            policy: body.policy ?? 'continue_independent',
+            max_concurrency: body.maxConcurrency ?? 2,
+        },
+        workflows,
+    };
+}
+/** One scenario → one node; a `tool` scenario also appends its composed workflow. */
+function buildNode(campaignId, s, defaultClis, workflows) {
+    if ((s.tool === undefined) === (s.agent === undefined)) {
+        throw new Error(`scenario '${s.id}' must carry exactly one of 'tool' (deterministic argv) or 'agent' ` +
+            '(governed problem statement)');
+    }
+    // The node's problem is a LABEL — what the scoreboard and the run list show — never the work.
+    const label = s.title ?? s.id;
+    assertInline(s.id, 'title', label);
+    if (s.tool !== undefined) {
+        if (s.tool.cmd.length === 0) {
+            throw new Error(`scenario '${s.id}': tool.cmd is empty — nothing to execute`);
+        }
+        s.tool.cmd.forEach((token, i) => assertInline(s.id, `tool.cmd[${i}]`, token));
+        const wfId = scenarioWorkflowId(campaignId, s.id);
+        workflows.push({ id: wfId, phases: [toolPhase(s.tool.cmd)] });
+        return {
+            node_id: s.id,
+            run_spec: {
+                problem: label,
+                clis: defaultClis,
+                entity_mode: 'shared',
+                workflow_id: wfId,
+                ...(s.repoRef !== undefined ? { repo_ref: s.repoRef } : {}),
+            },
+        };
+    }
+    const agent = s.agent;
+    assertInline(s.id, 'agent.problem', agent.problem);
+    if (agent.workflow !== undefined && agent.workflow.startsWith(CAMPAIGN_WORKFLOW_PREFIX)) {
+        // A composed node workflow is private to its node — pointing a second node at one would
+        // couple two nodes through an artifact the catalog deliberately hides.
+        throw new Error(`scenario '${s.id}': agent.workflow must name a registered workflow, not a composed ` +
+            `'${CAMPAIGN_WORKFLOW_PREFIX}*' one`);
+    }
+    return {
+        node_id: s.id,
+        run_spec: {
+            problem: agent.problem,
+            clis: defaultClis,
+            entity_mode: 'shared',
+            ...(agent.workflow !== undefined ? { workflow_id: agent.workflow } : {}),
+            ...(s.repoRef !== undefined ? { repo_ref: s.repoRef } : {}),
+        },
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/campaigns/plan.js.map

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

package/dist/campaigns/routes.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The `/api/v1/campaigns` surface (crew#342 + TH-9; DES-CAMPAIGN-001 §8).
+ *
+ * Thin by design: validation is zod (strict, unknown keys named — the FINDING-031 doctrine),
+ * scenario→node mapping is `plan.ts` (pure), and the scheduler is the ENGINE's (durable,
+ * single-writer, crash-resumable) — the daemon keeps no shadow campaign state, so a restarted
+ * daemon and a second daemon over the same db answer these routes identically. Campaign
+ * progress is NOT polled from here: the 11 `campaign*` CoreEvents ride the daemon's existing
+ * allowlist-free `/ws` relay the moment the engine emits them.
+ *
+ * Error posture mirrors the chat/elicitation surfaces: a build whose engine addon lacks the
+ * campaign bindings answers 501 (`CampaignsUnsupportedError` — "upgrade the engine"), never
+ * 400 ("fix your request").
+ */
+import type { FastifyInstance, FastifyRequest } from 'fastify';
+import { type CoreAdapter } from '../core/adapter.js';
+import type { Actor } from '../core/types.js';
+import type { AuditLog } from '../api/audit.js';
+export interface CampaignRoutesDeps {
+    audit: AuditLog;
+    actorOf: (req: FastifyRequest & {
+        actor?: Actor;
+    }) => Actor;
+    /** The default council roster for agent scenarios (already parsed). */
+    roster: () => unknown[];
+}
+export declare function registerCampaignRoutes(app: FastifyInstance, adapter: CoreAdapter, deps: CampaignRoutesDeps): void;
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/campaigns/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG/D,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,KAAK,EAAsB,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAmDhD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,KAAK,KAAK,CAAC;IAC5D,uEAAuE;IACvE,MAAM,EAAE,MAAM,OAAO,EAAE,CAAC;CACzB;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,kBAAkB,GACvB,IAAI,CAyIN"}

package/dist/campaigns/routes.js

@@ -0,0 +1,177 @@
+/**
+ * The `/api/v1/campaigns` surface (crew#342 + TH-9; DES-CAMPAIGN-001 §8).
+ *
+ * Thin by design: validation is zod (strict, unknown keys named — the FINDING-031 doctrine),
+ * scenario→node mapping is `plan.ts` (pure), and the scheduler is the ENGINE's (durable,
+ * single-writer, crash-resumable) — the daemon keeps no shadow campaign state, so a restarted
+ * daemon and a second daemon over the same db answer these routes identically. Campaign
+ * progress is NOT polled from here: the 11 `campaign*` CoreEvents ride the daemon's existing
+ * allowlist-free `/ws` relay the moment the engine emits them.
+ *
+ * Error posture mirrors the chat/elicitation surfaces: a build whose engine addon lacks the
+ * campaign bindings answers 501 (`CampaignsUnsupportedError` — "upgrade the engine"), never
+ * 400 ("fix your request").
+ */
+import { z } from 'zod';
+import { CampaignsUnsupportedError } from '../core/adapter.js';
+import { API_PREFIX } from '../api/api-prefix.js';
+import { buildCampaign } from './plan.js';
+const V = API_PREFIX;
+function message(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** Same unknown-key-naming 400 body builder as api/routes.ts (restated because that module
+ *  does not export it and importing routes.ts here would be a cycle through registerRoutes). */
+function invalidBody(err, what) {
+    const unknown = err.issues.flatMap((i) => (i.code === 'unrecognized_keys' ? i.keys : []));
+    const error = unknown.length > 0
+        ? `${what}: unknown field${unknown.length > 1 ? 's' : ''} ${unknown
+            .map((k) => `\`${k}\``)
+            .join(', ')} — this endpoint does not accept ${unknown.length > 1 ? 'them' : 'it'}, and ignoring ${unknown.length > 1 ? 'them' : 'it'} would run a different request than you sent`
+        : what;
+    return { error, details: err.issues };
+}
+const ScenarioSchema = z
+    .object({
+    id: z.string().min(1),
+    title: z.string().optional(),
+    deps: z.array(z.string()).optional(),
+    depsCondition: z.enum(['on_success', 'on_terminal']).optional(),
+    tool: z.object({ cmd: z.array(z.string()).min(1) }).strict().optional(),
+    agent: z
+        .object({ problem: z.string().min(1), workflow: z.string().optional() })
+        .strict()
+        .optional(),
+    repoRef: z.string().optional(),
+})
+    .strict();
+const LaunchCampaignSchema = z
+    .object({
+    id: z.string().optional(),
+    name: z.string().max(200).optional(),
+    scenarios: z.array(ScenarioSchema).min(1),
+    policy: z.enum(['fail_fast', 'continue_independent', 'human_gate_on_failure']).optional(),
+    maxConcurrency: z.number().int().min(1).max(64).optional(),
+    clisJson: z.string().optional(),
+})
+    .strict();
+export function registerCampaignRoutes(app, adapter, deps) {
+    app.post(`${V}/campaigns`, {
+        config: {
+            manifest: {
+                requestType: 'LaunchCampaignBody',
+                responseType: '{ campaignId: string }',
+                // 400: zod reject / mapping reject (inline-byte rule, unknown dep, …) / engine def
+                // reject (cycle, empty); 409: campaign id already exists; 501: engine addon lacks
+                // the campaign bindings.
+                statusCodes: [201, 400, 409, 501],
+            },
+        },
+    }, async (req, reply) => {
+        const parsed = LaunchCampaignSchema.safeParse(req.body);
+        if (!parsed.success) {
+            return reply.code(400).send(invalidBody(parsed.error, 'Invalid request body'));
+        }
+        const body = parsed.data;
+        try {
+            const clis = body.clisJson !== undefined ? JSON.parse(body.clisJson) : deps.roster();
+            if (!Array.isArray(clis)) {
+                return reply
+                    .code(400)
+                    .send({ error: 'clisJson must be a JSON array of AgenticCli seats' });
+            }
+            const built = buildCampaign(body, clis);
+            const campaignId = await adapter.launchCampaign(built.def, built.workflows);
+            deps.audit.record('campaign.launched', deps.actorOf(req), {
+                detail: {
+                    campaignId,
+                    nodes: built.def.nodes.length,
+                    edges: built.def.edges.length,
+                    policy: built.def.policy,
+                    maxConcurrency: built.def.max_concurrency,
+                },
+            });
+            return reply.code(201).send({ campaignId });
+        }
+        catch (err) {
+            if (err instanceof CampaignsUnsupportedError) {
+                return reply.code(501).send({ error: err.message });
+            }
+            const msg = message(err);
+            // A campaign id that already exists is a state conflict on a real resource.
+            if (/already exists|already launched/i.test(msg)) {
+                return reply.code(409).send({ error: msg });
+            }
+            return reply.code(400).send({ error: msg });
+        }
+    });
+    app.get(`${V}/campaigns`, {
+        config: {
+            manifest: { responseType: '{ campaigns: Campaign[] }', statusCodes: [200, 501] },
+        },
+    }, async (_req, reply) => {
+        try {
+            return { campaigns: await adapter.campaignList() };
+        }
+        catch (err) {
+            if (err instanceof CampaignsUnsupportedError) {
+                return reply.code(501).send({ error: err.message });
+            }
+            throw err;
+        }
+    });
+    app.get(`${V}/campaigns/:id`, {
+        config: {
+            manifest: { responseType: '{ campaign: Campaign }', statusCodes: [200, 404, 501] },
+        },
+    }, async (req, reply) => {
+        const { id } = req.params;
+        try {
+            const campaign = await adapter.campaignDetail(id);
+            if (campaign === null) {
+                return reply.code(404).send({ error: `unknown campaign: ${id}` });
+            }
+            return { campaign };
+        }
+        catch (err) {
+            if (err instanceof CampaignsUnsupportedError) {
+                return reply.code(501).send({ error: err.message });
+            }
+            throw err;
+        }
+    });
+    // Resume / cancel share one wrapper: both resolve the campaign status token, both 404 on an
+    // id the engine does not know, and both are actor-audited state transitions.
+    const transition = (action, run) => {
+        app.post(`${V}/campaigns/:id/${action}`, {
+            config: {
+                manifest: {
+                    responseType: '{ campaignId: string; status: CampaignStatus }',
+                    statusCodes: [200, 404, 409, 501],
+                },
+            },
+        }, async (req, reply) => {
+            const { id } = req.params;
+            try {
+                const status = await run(id);
+                deps.audit.record(`campaign.${action === 'resume' ? 'resumed' : 'cancelled'}`, deps.actorOf(req), {
+                    detail: { campaignId: id, status },
+                });
+                return { campaignId: id, status };
+            }
+            catch (err) {
+                if (err instanceof CampaignsUnsupportedError) {
+                    return reply.code(501).send({ error: err.message });
+                }
+                const msg = message(err);
+                if (/not found|unknown campaign/i.test(msg)) {
+                    return reply.code(404).send({ error: msg });
+                }
+                return reply.code(409).send({ error: msg });
+            }
+        });
+    };
+    transition('resume', (id) => adapter.resumeCampaign(id));
+    transition('cancel', (id) => adapter.cancelCampaign(id));
+}
+//# sourceMappingURL=routes.js.map

package/dist/campaigns/routes.js.map

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

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, SteeringImportEntry, SteeringImportResult, GovernanceEvalReport, GovernanceEvalSample, ImportEvalCorpusResponse, 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,47 @@ 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.
+ */
+/**
+ * The unified steering-rule model (STEERING program) is not available in this deployment —
+ * wicked-core-ts predates the `steeringImport` binding (ships in ≥ 0.7.5, alongside the model
+ * merge). Typed for the same reason as `ChatUnsupportedError`: the routes answer 501 ("upgrade
+ * the engine") on this, never 400 ("fix your request") — and never the WORSE failure of passing
+ * a steering-field write through to an engine that would silently drop the fields.
+ */
+export declare class SteeringUnsupportedError extends Error {
+    constructor(what: string);
+}
+/**
+ * The installed engine addon predates the governance-evals surface (crew-testing; the
+ * `governanceEvals` + `governanceCorpusImport` bindings ship with wicked-core-ts 0.7.5, which is
+ * unreleased at the time this seam lands). Typed for the same reason as `SteeringUnsupportedError`:
+ * the testing routes answer 501 ("upgrade the engine") on this, never 400 ("fix your request") —
+ * and they must not crash a daemon running against the released 0.7.4 addon.
+ */
+export declare class GovernanceEvalsUnsupportedError extends Error {
+    constructor(what: string);
+}
+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;
@@ -99,6 +140,14 @@ export declare class CoreAdapter {
     private closed;
     /** Built-in workflow ids whose overlay JSON has been written this process lifetime. */
     private readonly _builtinOverlayWritten;
+    /**
+     * The estate db the Core actor was spawned over (`CoreAdapterOptions.dbPath` — the `--db`
+     * flag / `~/.wicked-crew/core.db` default). Kept because some engine bindings take the db
+     * path as an ARG rather than reading the actor's own handle (`governanceEvals` runs its evals
+     * over a read-only connection to this same store); crew resolves it here, the one place the
+     * path is already known, so no route grows a second spelling of where the store lives.
+     */
+    readonly dbPath: string;
     /** `true` when this adapter armed the event-driven exec seam (for readiness/reporting). */
     readonly engineExec: boolean;
     /** The bus db the exec seam runs over when armed (else `undefined`). */
@@ -130,6 +179,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
@@ -297,6 +372,90 @@ 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>;
+    /**
+     * Whether the installed engine addon carries the unified steering-rule model (core-ts ≥ 0.7.5).
+     *
+     * The sentinel is the `steeringImport` binding, which ships WITH the model merge — see the
+     * `GovernanceMethods` comment. Consulted by the routes before: filtering rules by
+     * `?type=` (rows on an old engine carry no `steering_type`, so an empty answer would
+     * impersonate "no rules of that type"); accepting a rule write that carries steering fields
+     * (an old engine would silently drop them — the extraWriteRoots doctrine); and folding the
+     * legacy policy write surface (410 only once the unified store exists to point at).
+     */
+    steeringSupported(): boolean;
+    /**
+     * Batch-import steering rules (frontmattered markdown docs and/or ready rule JSON) through the
+     * engine's ingest normalize/validate path — the SAME path `rules ingest --dir` runs, on the
+     * single-writer actor (the daemon must never open the store for writes itself). Fail-closed
+     * PER ENTRY: one bad entry rejects alone with its reason in that entry's result row, the rest
+     * still land. `defaultType` is the page's inferred steering type, applied to entries that
+     * omit one.
+     *
+     * Presence-gated (the campaigns doctrine): throws {@link SteeringUnsupportedError} on an addon
+     * that predates the binding, which the route maps to 501 ("upgrade the engine").
+     */
+    importSteeringRules(entries: SteeringImportEntry[], defaultType?: string): Promise<SteeringImportResult[]>;
+    /**
+     * Whether the installed engine addon carries the governance-evals surface (core-ts ≥ 0.7.5,
+     * unreleased at the time this seam lands). The sentinel is the `governanceEvals` binding —
+     * for the WHOLE evals seam, corpus import included: the two bindings ship together, and a
+     * daemon running against the released 0.7.4 addon must answer 501 on both routes, never crash.
+     */
+    governanceEvalsSupported(): boolean;
+    /**
+     * Run the governance evals: every sample of the corpus (`corpus` = an `evals:<name>` estate
+     * scope minted by {@link importGovernanceCorpus}; omitted = the engine's built-in default
+     * corpus) is pushed through the decide path and compared to what its `kind` says SHOULD have
+     * happened. Resolves the engine's serde report — snake_case field names, passed to the wire
+     * verbatim (the pinned crew/studio contract).
+     *
+     * `dbPath` rides the args because the eval run opens its own read-only connection to the
+     * steering store — the SAME store this adapter's actor writes (`this.dbPath`, the one spelling
+     * of where it lives). `knowledgeDb` is deliberately omitted: crew configures no separate
+     * knowledge db (the knowledge store is the engine's single-writer sidecar, derived from its
+     * own config exactly as the steering ingest path derives it).
+     *
+     * Presence-gated (the campaigns doctrine): throws {@link GovernanceEvalsUnsupportedError} on
+     * an addon that predates the binding, which the route maps to 501 ("upgrade the engine").
+     */
+    runGovernanceEvals(args: {
+        type?: string;
+        corpus?: string;
+    }): Promise<GovernanceEvalReport>;
+    /**
+     * Import a named eval corpus into the knowledge store under the `evals:<name>` scope (the
+     * string a later {@link runGovernanceEvals} names as `corpus`). `knowledgeDb` is omitted for
+     * the same reason as in {@link runGovernanceEvals} — the engine derives its own sidecar.
+     *
+     * Gated on the `governanceEvals` sentinel as well as the binding itself: the two ship
+     * together, and importing a corpus no engine on this host can ever run would be a trap, not
+     * a feature (the steering author-route doctrine).
+     */
+    importGovernanceCorpus(name: string, samples: GovernanceEvalSample[]): Promise<ImportEvalCorpusResponse>;
     private readonly userWorkflows;
     /** Whether {@link hydrateFromOverlay} has run this process lifetime. */
     private overlayHydrated;