wicked-crew 0.1.0 → 0.1.1

package/dist/core/adapter.d.ts

@@ -0,0 +1,66 @@
+import type { CoreEvent, LaunchRunInput, RepoEntry, SessionView } from './types.js';
+/** A parsed-CoreEvent listener. */
+export type CoreEventListener = (event: CoreEvent) => void;
+export interface CoreAdapterOptions {
+    /** Estate db path the core actor writes to (single writer). */
+    dbPath: string;
+    /** `true` → deterministic offline stub engine (tests); `false` → production engine. */
+    stub?: boolean;
+}
+/**
+ * The single isolation boundary over wicked-core-ts. It holds the ONE `Core`
+ * handle, makes the ONE `subscribe()` call for the whole process, parses each
+ * CoreEvent, and re-emits it to registered in-daemon listeners. Every REST
+ * endpoint and the WS fan-out funnel through this stable API — so when the
+ * in-flight core-ts subscribe/teardown signature lands, only this file changes.
+ */
+export declare class CoreAdapter {
+    private readonly core;
+    private readonly subscription;
+    private readonly listeners;
+    private closed;
+    constructor(opts: CoreAdapterOptions);
+    /** Register a CoreEvent listener. Returns an unsubscribe function. */
+    onEvent(listener: CoreEventListener): () => void;
+    /** The production council roster (static), parsed to seats. */
+    static roster(): unknown[];
+    /** Liveness probe → `"ok"` (also proves the event pump). */
+    ping(): Promise<string>;
+    /** Launch an interactive, resumable run → the run id. */
+    launchRun(input: LaunchRunInput): Promise<string>;
+    /** Resume a run from its persisted cursor → the status token. */
+    resumeRun(runId: string): Promise<string>;
+    /** Resolve a human gate: approve (optional amend) or reject → the status token. */
+    confirmGate(runId: string, approve: boolean, amend?: string): Promise<string>;
+    /** Cancel a run → the status token. */
+    cancelRun(runId: string): Promise<string>;
+    /** Run ids on the store. */
+    sessions(): Promise<string[]>;
+    /** Every run + its ordered units. */
+    sessionsDetail(): Promise<SessionView[]>;
+    /** A unit's captured transcript (string, or `null`). */
+    workOutput(unitId: string): Promise<string | null>;
+    /** Register a git repo → the persisted `RepoEntry`. */
+    registerRepo(name: string, rootPath: string): Promise<RepoEntry>;
+    /** List every registered repo. */
+    listRepos(): Promise<RepoEntry[]>;
+    /**
+     * Open a PTY terminal session in `cwd` running `cmd` (or the login shell when
+     * omitted), sized `cols`x`rows`. `governed:true` keeps tool-calls routed through
+     * the gate-hook (the default); `governed:false` is the loud, opt-in **ungoverned
+     * operator shell** (DES-TERMINAL-001 §7). Resolves the new terminal id.
+     */
+    openTerminal(cwd: string, cmd: string[] | undefined, cols: number, rows: number, governed: boolean): Promise<string>;
+    /** Write raw input bytes (keystrokes) to a terminal → `"ok"`. Rejects on an unknown id. */
+    writeTerminal(id: string, bytes: Buffer): Promise<string>;
+    /** Resize a terminal's PTY to `cols`x`rows` → `"ok"`. Rejects on an unknown id. */
+    resizeTerminal(id: string, cols: number, rows: number): Promise<string>;
+    /** Close a terminal (kill child, join reader) → `"ok"` after a `terminalExited` event. */
+    closeTerminal(id: string): Promise<string>;
+    /**
+     * Tear down the single subscription (stop delivery, release the pump thread +
+     * callback) so the process can exit cleanly. Idempotent.
+     */
+    close(): void;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/core/adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAiBpF,mCAAmC;AACnC,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,EAAE,kBAAkB;IAuBpC,sEAAsE;IACtE,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAOhD,+DAA+D;IAC/D,MAAM,CAAC,MAAM,IAAI,OAAO,EAAE;IAI1B,4DAA4D;IAC5D,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvB,yDAAyD;IACzD,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAYjD,iEAAiE;IACjE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzC,mFAAmF;IACnF,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7E,uCAAuC;IACvC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzC,4BAA4B;IACtB,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAInC,qCAAqC;IAC/B,cAAc,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI9C,wDAAwD;IAClD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIxD,uDAAuD;IACjD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAItE,kCAAkC;IAC5B,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAUvC;;;;;OAKG;IACH,YAAY,CACV,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EAAE,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,CAAC;IAIlB,2FAA2F;IAC3F,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzD,mFAAmF;IACnF,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvE,0FAA0F;IAC1F,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1C;;;OAGG;IACH,KAAK,IAAI,IAAI;CAMd"}

package/dist/core/adapter.js

@@ -0,0 +1,145 @@
+import { createRequire } from 'node:module';
+// The native addon is a CommonJS cdylib (`index.node`); load it with a CJS
+// require even though this daemon is ESM. This module is the ONLY place that
+// touches wicked-core-ts (DES-STUDIO-001 §5.2/§5.3), so the FINALIZING
+// `subscribe` seam has a blast radius of exactly one file.
+const require = createRequire(import.meta.url);
+const { Core } = require('wicked-core-ts');
+/**
+ * The single isolation boundary over wicked-core-ts. It holds the ONE `Core`
+ * handle, makes the ONE `subscribe()` call for the whole process, parses each
+ * CoreEvent, and re-emits it to registered in-daemon listeners. Every REST
+ * endpoint and the WS fan-out funnel through this stable API — so when the
+ * in-flight core-ts subscribe/teardown signature lands, only this file changes.
+ */
+export class CoreAdapter {
+    core;
+    subscription;
+    listeners = new Set();
+    closed = false;
+    constructor(opts) {
+        this.core = opts.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.
+        this.subscription = this.core.subscribe((err, json) => {
+            if (err)
+                return;
+            let event;
+            try {
+                event = JSON.parse(json);
+            }
+            catch {
+                return; // malformed frame — drop it rather than crash the pump
+            }
+            for (const listener of this.listeners) {
+                try {
+                    listener(event);
+                }
+                catch {
+                    /* isolate a faulty listener */
+                }
+            }
+        });
+    }
+    /** Register a CoreEvent listener. Returns an unsubscribe function. */
+    onEvent(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /** The production council roster (static), parsed to seats. */
+    static roster() {
+        return JSON.parse(Core.registryRoster());
+    }
+    /** Liveness probe → `"ok"` (also proves the event pump). */
+    ping() {
+        return this.core.ping();
+    }
+    /** Launch an interactive, resumable run → the run id. */
+    launchRun(input) {
+        const opts = {
+            problem: input.problem,
+            sessionId: input.sessionId,
+            clisJson: input.clisJson,
+        };
+        if (input.entityMode !== undefined)
+            opts.entityMode = input.entityMode;
+        if (input.humanConfirm !== undefined)
+            opts.humanConfirm = input.humanConfirm;
+        if (input.repoRef !== undefined)
+            opts.repoRef = input.repoRef;
+        return this.core.launchRun(opts);
+    }
+    /** Resume a run from its persisted cursor → the status token. */
+    resumeRun(runId) {
+        return this.core.resumeRun(runId);
+    }
+    /** Resolve a human gate: approve (optional amend) or reject → the status token. */
+    confirmGate(runId, approve, amend) {
+        return this.core.confirmGate(runId, approve, amend);
+    }
+    /** Cancel a run → the status token. */
+    cancelRun(runId) {
+        return this.core.cancelRun(runId);
+    }
+    /** Run ids on the store. */
+    async sessions() {
+        return JSON.parse(await this.core.sessions());
+    }
+    /** Every run + its ordered units. */
+    async sessionsDetail() {
+        return JSON.parse(await this.core.sessionsDetail());
+    }
+    /** A unit's captured transcript (string, or `null`). */
+    async workOutput(unitId) {
+        return JSON.parse(await this.core.workOutput(unitId));
+    }
+    /** Register a git repo → the persisted `RepoEntry`. */
+    async registerRepo(name, rootPath) {
+        return JSON.parse(await this.core.registerRepo(name, rootPath));
+    }
+    /** List every registered repo. */
+    async listRepos() {
+        return JSON.parse(await this.core.listRepos());
+    }
+    // ── PTY terminal sessions (DES-TERMINAL-001 §6) ────────────────────────────
+    // Thin wrappers over the four core-ts terminal methods. Output does NOT return
+    // here — it arrives as `terminalOutput` CoreEvents on the single subscription
+    // (routed to the owning browser socket by the WS layer, keyed on the id these
+    // resolve). Callers must already be attached via onEvent to catch the bytes.
+    /**
+     * Open a PTY terminal session in `cwd` running `cmd` (or the login shell when
+     * omitted), sized `cols`x`rows`. `governed:true` keeps tool-calls routed through
+     * the gate-hook (the default); `governed:false` is the loud, opt-in **ungoverned
+     * operator shell** (DES-TERMINAL-001 §7). Resolves the new terminal id.
+     */
+    openTerminal(cwd, cmd, cols, rows, governed) {
+        return this.core.openTerminal(cwd, cmd ?? null, cols, rows, governed);
+    }
+    /** Write raw input bytes (keystrokes) to a terminal → `"ok"`. Rejects on an unknown id. */
+    writeTerminal(id, bytes) {
+        return this.core.writeTerminal(id, bytes);
+    }
+    /** Resize a terminal's PTY to `cols`x`rows` → `"ok"`. Rejects on an unknown id. */
+    resizeTerminal(id, cols, rows) {
+        return this.core.resizeTerminal(id, cols, rows);
+    }
+    /** Close a terminal (kill child, join reader) → `"ok"` after a `terminalExited` event. */
+    closeTerminal(id) {
+        return this.core.closeTerminal(id);
+    }
+    /**
+     * Tear down the single subscription (stop delivery, release the pump thread +
+     * callback) so the process can exit cleanly. Idempotent.
+     */
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.listeners.clear();
+        this.subscription.close();
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/core/adapter.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Boundary types for the wicked-core-ts JSON surface.
+ *
+ * core-ts returns every complex result as a JSON string, which the adapter
+ * `JSON.parse`s. These interfaces mirror the serde representation of
+ * wicked-core's domain types (wicked-core/src/domain.rs, repo.rs, scope.rs) so
+ * the daemon never falls back to `any` at the core boundary. They are permissive
+ * about forward-additive fields — a newer core that adds fields still parses.
+ *
+ * ONLY `core/adapter.ts` imports from the native addon itself; the rest of the
+ * daemon speaks these daemon-owned shapes, which is what quarantines the
+ * FINALIZING core-ts `subscribe` seam to a single file (DES-STUDIO-001 §5.2).
+ */
+/** Run-level lifecycle status (`SessionStatus`, snake_case serde token). */
+export type SessionStatus = 'planning' | 'distributing' | 'executing' | 'awaiting_human' | 'completed' | 'cancelled' | 'failed';
+/** Per-unit lifecycle status (`UnitStatus`). */
+export type UnitStatus = 'pending' | 'distributed' | 'done' | 'rejected';
+/** The methodology stage badge on a unit (`StageKind`). */
+export type StageKind = 'recon' | 'build' | 'review' | 'test';
+/** Collection-scope mode (`EntityMode`). */
+export type EntityMode = 'shared' | 'isolated';
+/** Human-confirm gate policy. serde: `None`→"none", `All`→"all", `Before(n)`→{ before: n }. */
+export type HumanConfirm = 'none' | 'all' | {
+    before: number;
+};
+/** Why a CLI was assigned to a unit (`RoutingInfo`, internally tagged on `method`). */
+export type RoutingInfo = {
+    method: 'council';
+    winner: string;
+    agreement_pct: number;
+    returned: number;
+    dissent: number;
+} | {
+    method: 'degraded';
+    reason: string;
+} | {
+    method: 'evaluator_distinct';
+    winner: string;
+    was: string;
+};
+/** A run (`AgentSession`). */
+export interface AgentSession {
+    id: string;
+    workflow_id: string;
+    problem: string;
+    entity_mode: EntityMode;
+    collection_scope: string | null;
+    clis: string[];
+    status: SessionStatus;
+    human_confirm: HumanConfirm;
+    unit_ix: number;
+    attempt: number;
+    workdir: string | null;
+    repo_ref: string | null;
+}
+/** An ordered unit of work within a run (`WorkUnit`). */
+export interface WorkUnit {
+    id: string;
+    session_id: string;
+    ord: number;
+    description: string;
+    stage: StageKind;
+    assigned_cli: string | null;
+    assigned_invocation: string | null;
+    council_task_ref: string | null;
+    routing: RoutingInfo | null;
+    denial_reason: string | null;
+    phase_ref: string | null;
+    conformance_ref: string | null;
+    phase_status: string | null;
+    collection_scope: string | null;
+    status: UnitStatus;
+}
+/** A run plus its ordered units — the read a UI builds its project list from (`SessionView`). */
+export interface SessionView {
+    session: AgentSession;
+    units: WorkUnit[];
+}
+/** A registered git repository (`RepoEntry`). */
+export interface RepoEntry {
+    id: string;
+    name: string;
+    root_path: string;
+    default_branch: string;
+    registered_at: number;
+}
+/** The daemon's launch-run input (mapped by the adapter onto the addon's `LaunchOptions`). */
+export interface LaunchRunInput {
+    /** Free-text problem, decomposed into ordered work units. */
+    problem: string;
+    /** Stable run id. */
+    sessionId: string;
+    /** JSON array of `AgenticCli` seats — the council roster. */
+    clisJson: string;
+    /** `shared` (default) | `isolated`. */
+    entityMode?: string;
+    /** Human-confirm gate policy: `none` (default) | `all` | `before:<ord>`. */
+    humanConfirm?: string;
+    /** Id of a registered repo to run within. Omit for a repo-less run. */
+    repoRef?: string;
+}
+/**
+ * A CoreEvent frame as delivered by the live stream — a tagged-JSON object
+ * discriminated on `type` (wicked-core-ts `event_to_json`). Known optional
+ * fields are declared for the frames the daemon inspects; the index signature
+ * keeps the shape additive-safe so new variants pass through untouched.
+ */
+export interface CoreEvent {
+    type: string;
+    session?: string;
+    ord?: number;
+    prompt?: string;
+    chunk?: string;
+    allow?: boolean;
+    cli?: string;
+    description?: string;
+    problem?: string;
+    message?: string;
+    /** PTY terminal frames (`terminalOpened`/`terminalOutput`/`terminalExited`): the terminal id. */
+    id?: string;
+    /** `terminalOutput`: monotonic per-terminal sequence number. */
+    seq?: number;
+    /** `terminalOutput`: raw PTY bytes, base64-encoded (decode → send to the owning socket). */
+    bytesB64?: string;
+    /** `terminalOpened`: the working directory the PTY was opened in. */
+    cwd?: string;
+    [k: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,cAAc,GACd,WAAW,GACX,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,QAAQ,CAAC;AAEb,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,UAAU,CAAC;AAEzE,2DAA2D;AAC3D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9D,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/C,+FAA+F;AAC/F,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,uFAAuF;AACvF,MAAM,MAAM,WAAW,GACnB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC/F;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,UAAU,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,EAAE,YAAY,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,yDAAyD;AACzD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,iGAAiG;AACjG,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,iDAAiD;AACjD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;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,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iGAAiG;IACjG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB"}

package/dist/core/types.js

@@ -0,0 +1,15 @@
+/**
+ * Boundary types for the wicked-core-ts JSON surface.
+ *
+ * core-ts returns every complex result as a JSON string, which the adapter
+ * `JSON.parse`s. These interfaces mirror the serde representation of
+ * wicked-core's domain types (wicked-core/src/domain.rs, repo.rs, scope.rs) so
+ * the daemon never falls back to `any` at the core boundary. They are permissive
+ * about forward-additive fields — a newer core that adds fields still parses.
+ *
+ * ONLY `core/adapter.ts` imports from the native addon itself; the rest of the
+ * daemon speaks these daemon-owned shapes, which is what quarantines the
+ * FINALIZING core-ts `subscribe` seam to a single file (DES-STUDIO-001 §5.2).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/events/bus.d.ts

@@ -0,0 +1,10 @@
+import { WebSocket } from 'ws';
+import type { CoreEvent } from '../core/types.js';
+export declare function registerClient(ws: WebSocket): void;
+/** Fan one CoreEvent frame out to every connected client, verbatim. */
+export declare function broadcast(event: CoreEvent): void;
+/** Current live client count (diagnostics / tests). */
+export declare function clientCount(): number;
+/** Close every client socket and clear the set (graceful shutdown). */
+export declare function closeAllClients(): void;
+//# sourceMappingURL=bus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/events/bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAUlD,wBAAgB,cAAc,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAOlD;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAchD;AAED,uDAAuD;AACvD,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,uEAAuE;AACvE,wBAAgB,eAAe,IAAI,IAAI,CAStC"}

package/dist/events/bus.js

@@ -0,0 +1,48 @@
+import { WebSocket } from 'ws';
+// The daemon's WS fan-out surface. The adapter's single CoreEvent subscription
+// pushes every parsed frame through `broadcast()` to all connected browser
+// sockets, verbatim (the tagged-JSON `{ type, ...fields }` shape — additive-safe;
+// DES-STUDIO-001 §2.1). No `{ type, payload, ts }` envelope: the studio switches
+// directly on the CoreEvent discriminant.
+const clients = new Set();
+export function registerClient(ws) {
+    clients.add(ws);
+    ws.on('close', () => clients.delete(ws));
+    ws.on('error', () => {
+        clients.delete(ws);
+        ws.terminate();
+    });
+}
+/** Fan one CoreEvent frame out to every connected client, verbatim. */
+export function broadcast(event) {
+    const msg = JSON.stringify(event);
+    for (const client of clients) {
+        if (client.readyState !== WebSocket.OPEN) {
+            clients.delete(client);
+            continue;
+        }
+        client.send(msg, (err) => {
+            if (err) {
+                clients.delete(client);
+                client.terminate();
+            }
+        });
+    }
+}
+/** Current live client count (diagnostics / tests). */
+export function clientCount() {
+    return clients.size;
+}
+/** Close every client socket and clear the set (graceful shutdown). */
+export function closeAllClients() {
+    for (const client of clients) {
+        try {
+            client.close();
+        }
+        catch {
+            /* already closing */
+        }
+    }
+    clients.clear();
+}
+//# sourceMappingURL=bus.js.map

package/dist/events/bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.js","sourceRoot":"","sources":["../../src/events/bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAG/B,+EAA+E;AAC/E,2EAA2E;AAC3E,kFAAkF;AAClF,iFAAiF;AACjF,0CAA0C;AAE1C,MAAM,OAAO,GAAmB,IAAI,GAAG,EAAE,CAAC;AAE1C,MAAM,UAAU,cAAc,CAAC,EAAa;IAC1C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QAClB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnB,EAAE,CAAC,SAAS,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,SAAS,CAAC,KAAgB;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAClC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACzC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE;YAC/B,IAAI,GAAG,EAAE,CAAC;gBACR,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACvB,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,IAAI,CAAC;AACtB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe;IAC7B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/dist/events/terminals.d.ts

@@ -0,0 +1,42 @@
+import type { FastifyInstance } from 'fastify';
+import { WebSocket } from 'ws';
+import type { CoreAdapter } from '../core/adapter.js';
+import type { CoreEvent } from '../core/types.js';
+/**
+ * Per-terminal WS fan-out (DES-TERMINAL-001 §6). The daemon's single CoreEvent
+ * subscription is the source of truth; this hub routes the `terminalOutput` /
+ * `terminalExited` frames for a given terminal id to the ONE browser socket that
+ * opened it, keyed by id (a `Map<id, socket>`). Raw PTY output arrives
+ * base64-encoded (`bytesB64`); we decode and send it as a BINARY frame so
+ * xterm.js writes the exact bytes — control sequences and multi-byte UTF-8
+ * survive a text-frame round-trip.
+ */
+export declare class TerminalHub {
+    private readonly sockets;
+    /**
+     * ids whose `terminalExited` we've already routed — so the WS close handler
+     * skips a redundant `closeTerminal` (the engine already reaped that child).
+     */
+    private readonly exited;
+    /** Bind a browser socket to a terminal id (later `terminalOutput` fans out to it). */
+    register(id: string, socket: WebSocket): void;
+    /** True once a `terminalExited` frame has been routed for this id. */
+    hasExited(id: string): boolean;
+    /** Drop the socket + exit bookkeeping for a terminal id. */
+    unregister(id: string): void;
+    /** Live terminal-socket count (diagnostics / tests). */
+    size(): number;
+    /**
+     * Route one CoreEvent frame to the terminal socket it belongs to. Called for
+     * EVERY core event; non-terminal frames and frames for an unknown id are no-ops.
+     */
+    route(event: CoreEvent): void;
+}
+/**
+ * The per-terminal WS channel: `GET /ws/terminals/:id`. Binds the browser socket
+ * to the terminal id in the hub (so `terminalOutput` for that id fans out to it),
+ * forwards every inbound browser frame to the PTY as raw stdin bytes, and closes
+ * the terminal when the socket drops (unless the PTY already exited on its own).
+ */
+export declare function registerTerminalWs(app: FastifyInstance, adapter: CoreAdapter, hub: TerminalHub): void;
+//# sourceMappingURL=terminals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminals.d.ts","sourceRoot":"","sources":["../../src/events/terminals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAgB,MAAM,IAAI,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,sFAAsF;IACtF,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI;IAI7C,sEAAsE;IACtE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI9B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK5B,wDAAwD;IACxD,IAAI,IAAI,MAAM;IAId;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;CAiB9B;AASD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,WAAW,GACf,IAAI,CAgCN"}

package/dist/events/terminals.js

@@ -0,0 +1,106 @@
+import { WebSocket } from 'ws';
+/**
+ * Per-terminal WS fan-out (DES-TERMINAL-001 §6). The daemon's single CoreEvent
+ * subscription is the source of truth; this hub routes the `terminalOutput` /
+ * `terminalExited` frames for a given terminal id to the ONE browser socket that
+ * opened it, keyed by id (a `Map<id, socket>`). Raw PTY output arrives
+ * base64-encoded (`bytesB64`); we decode and send it as a BINARY frame so
+ * xterm.js writes the exact bytes — control sequences and multi-byte UTF-8
+ * survive a text-frame round-trip.
+ */
+export class TerminalHub {
+    sockets = new Map();
+    /**
+     * ids whose `terminalExited` we've already routed — so the WS close handler
+     * skips a redundant `closeTerminal` (the engine already reaped that child).
+     */
+    exited = new Set();
+    /** Bind a browser socket to a terminal id (later `terminalOutput` fans out to it). */
+    register(id, socket) {
+        this.sockets.set(id, socket);
+    }
+    /** True once a `terminalExited` frame has been routed for this id. */
+    hasExited(id) {
+        return this.exited.has(id);
+    }
+    /** Drop the socket + exit bookkeeping for a terminal id. */
+    unregister(id) {
+        this.sockets.delete(id);
+        this.exited.delete(id);
+    }
+    /** Live terminal-socket count (diagnostics / tests). */
+    size() {
+        return this.sockets.size;
+    }
+    /**
+     * Route one CoreEvent frame to the terminal socket it belongs to. Called for
+     * EVERY core event; non-terminal frames and frames for an unknown id are no-ops.
+     */
+    route(event) {
+        const id = typeof event.id === 'string' ? event.id : undefined;
+        if (id === undefined)
+            return;
+        const socket = this.sockets.get(id);
+        if (!socket)
+            return;
+        if (event.type === 'terminalOutput') {
+            if (typeof event.bytesB64 === 'string' && socket.readyState === WebSocket.OPEN) {
+                socket.send(Buffer.from(event.bytesB64, 'base64'));
+            }
+        }
+        else if (event.type === 'terminalExited') {
+            // The child is gone. Mark it (so the socket-close handler skips a redundant
+            // closeTerminal), then close the browser socket so xterm stops cleanly.
+            this.exited.add(id);
+            if (socket.readyState === WebSocket.OPEN)
+                socket.close();
+        }
+    }
+}
+/** Normalise a ws frame (Buffer | ArrayBuffer | Buffer[]) to a single Buffer. */
+function toBuffer(data) {
+    if (Buffer.isBuffer(data))
+        return data;
+    if (Array.isArray(data))
+        return Buffer.concat(data);
+    return Buffer.from(data);
+}
+/**
+ * The per-terminal WS channel: `GET /ws/terminals/:id`. Binds the browser socket
+ * to the terminal id in the hub (so `terminalOutput` for that id fans out to it),
+ * forwards every inbound browser frame to the PTY as raw stdin bytes, and closes
+ * the terminal when the socket drops (unless the PTY already exited on its own).
+ */
+export function registerTerminalWs(app, adapter, hub) {
+    app.get('/ws/terminals/:id', { websocket: true }, (socket, req) => {
+        const { id } = req.params;
+        const ws = socket;
+        hub.register(id, ws);
+        // Browser keystrokes (xterm.onData → ws.send): text or binary, both are raw
+        // input bytes for the PTY. Failures (unknown/closed id) are swallowed — the
+        // exit/close path tears the socket down.
+        ws.on('message', (data) => {
+            void adapter.writeTerminal(id, toBuffer(data)).catch(() => {
+                /* terminal gone */
+            });
+        });
+        let torn = false;
+        const teardown = () => {
+            if (torn)
+                return;
+            torn = true;
+            const alreadyExited = hub.hasExited(id);
+            hub.unregister(id);
+            // Socket dropped by the browser (unmount) → close the PTY. Skip when the PTY
+            // already exited (engine reaped it; a second closeTerminal would reject).
+            if (!alreadyExited) {
+                void adapter.closeTerminal(id).catch(() => {
+                    /* already closed / unknown id */
+                });
+            }
+        };
+        ws.on('close', teardown);
+        ws.on('error', teardown);
+    });
+}
+//# sourceMappingURL=terminals.js.map

package/dist/events/terminals.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-crew",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "wicked-crew daemon — thin REST+WS bridge to the wicked-core engine via wicked-core-ts",
   "repository": {
     "type": "git",