@openrig/cli 0.1.12 → 0.3.0

package/daemon/dist/domain/workflow/starter-spec-loader.js

@@ -0,0 +1,140 @@
+// Built-in workflow-spec loader.
+//
+// Walks a built-in starter directory at daemon startup and seeds each
+// spec file into PL-004 Phase D's WorkflowSpecCache. Idempotent: on
+// repeated startup (or when an operator has authored a competing spec
+// at a workspace path), the loader SKIPS specs that are already cached
+// for the same (name, version) — the workspace-surface reconciliation
+// contract from Phase D requires that operator edits win at next read,
+// so the loader must not clobber them.
+//
+// Why skip-if-present rather than always-readThrough:
+//   WorkflowSpecCache.readThrough(absPath) UPDATES the cached row's
+//   source_path to whatever the caller passes. If we called readThrough
+//   on the built-in path every startup, an operator-authored row at a
+//   workspace path would have its source_path overwritten back to the
+//   built-in path — silently undoing the operator's override. The
+//   skip-if-present check preserves the override.
+//
+// Resolution: operators who want to refresh the built-in row from the
+// shipped file (e.g., after deleting a workspace override) can call
+// `cache.readThrough(builtinAbsPath)` directly via a future explicit
+// refresh path; v0 does not surface that path, since the typical case
+// (cold daemon, no override) is handled by the loader on first start.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { WorkflowSpecError, parseWorkflowSpec, } from "../workflow-spec-cache.js";
+const SPEC_FILE_EXTENSIONS = new Set([".yaml", ".yml"]);
+/**
+ * Walks the builtinDir and seeds each spec file into the cache, skipping
+ * those that are already cached for the same (name, version). Idempotent
+ * on repeated calls. Returns a structured result for diagnostic logging
+ * (which the daemon can log at INFO; tests assert on the shape).
+ *
+ * If the builtinDir doesn't exist, returns an empty result (no error) —
+ * a daemon shipped without bundled starter specs is a valid configuration.
+ */
+export function loadStarterWorkflowSpecs(opts) {
+    const result = { loaded: [], skipped: [], errors: [] };
+    let entries;
+    try {
+        entries = fs.readdirSync(opts.builtinDir, { withFileTypes: true });
+    }
+    catch {
+        // Directory absent — no starter specs bundled. This is a valid
+        // configuration; not an error.
+        return result;
+    }
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        const ext = path.extname(entry.name).toLowerCase();
+        if (!SPEC_FILE_EXTENSIONS.has(ext))
+            continue;
+        const absPath = path.join(opts.builtinDir, entry.name);
+        let raw;
+        try {
+            raw = fs.readFileSync(absPath, "utf-8");
+        }
+        catch (err) {
+            result.errors.push({
+                sourcePath: absPath,
+                code: "spec_read_failed",
+                message: err instanceof Error ? err.message : String(err),
+            });
+            continue;
+        }
+        let parsedName;
+        let parsedVersion;
+        try {
+            const parsed = parseWorkflowSpec(raw, absPath);
+            parsedName = parsed.id;
+            parsedVersion = parsed.version;
+        }
+        catch (err) {
+            if (err instanceof WorkflowSpecError) {
+                result.errors.push({ sourcePath: absPath, code: err.code, message: err.message });
+            }
+            else {
+                result.errors.push({
+                    sourcePath: absPath,
+                    code: "spec_parse_failed",
+                    message: err instanceof Error ? err.message : String(err),
+                });
+            }
+            continue;
+        }
+        // Workspace-surface reconciliation: if an entry already exists for
+        // this (name, version), DO NOT seed — operator override (or a prior
+        // startup's seed) wins.
+        const existing = opts.cache.getByNameVersion(parsedName, parsedVersion);
+        if (existing) {
+            result.skipped.push({
+                name: parsedName,
+                version: parsedVersion,
+                sourcePathInCache: existing.sourcePath,
+            });
+            continue;
+        }
+        // Seed via readThrough so the cache's normal insert path runs (hash
+        // computation, cached_at timestamp, JSON serialization of roles +
+        // steps). readThrough re-reads + re-parses the file; that's a small
+        // duplicate-work cost per spec at startup, acceptable for v0.
+        try {
+            const row = opts.cache.readThrough(absPath);
+            result.loaded.push({ name: row.name, version: row.version, sourcePath: row.sourcePath });
+        }
+        catch (err) {
+            if (err instanceof WorkflowSpecError) {
+                result.errors.push({ sourcePath: absPath, code: err.code, message: err.message });
+            }
+            else {
+                result.errors.push({
+                    sourcePath: absPath,
+                    code: "spec_seed_failed",
+                    message: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Resolves the default built-in starter directory relative to this
+ * loader file's location on disk. Works in both dev (running from
+ * `src/`) and prod (running from `dist/`) — the build step copies the
+ * workflow spec files to `dist/builtins/workflow-specs/` when bundled
+ * specs are present, so the resolved path works in both layouts.
+ *
+ * Layout: this file is at `<pkg>/{src|dist}/domain/workflow/`. The
+ * built-in dir is at `<pkg>/{src|dist}/builtins/workflow-specs/`. Two
+ * levels up from this file's dirname is the package's src/ or dist/
+ * root.
+ */
+export function defaultBuiltinSpecsDir() {
+    const here = path.dirname(new URL(import.meta.url).pathname);
+    // here = .../{src|dist}/domain/workflow
+    // package src/dist root = .../{src|dist}
+    return path.resolve(here, "..", "..", "builtins", "workflow-specs");
+}
+//# sourceMappingURL=starter-spec-loader.js.map

package/daemon/dist/domain/workflow/starter-spec-loader.js.map

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

package/daemon/dist/domain/workflow-instance-store.d.ts

@@ -0,0 +1,46 @@
+import type Database from "better-sqlite3";
+import type { WorkflowInstance, WorkflowInstanceStatus } from "./workflow-types.js";
+export interface CreateWorkflowInstanceInput {
+    workflowName: string;
+    workflowVersion: string;
+    createdBySession: string;
+    initialFrontier?: string[];
+    /** R2: durable current-step binding set at instantiate time. */
+    currentStepId?: string;
+}
+export declare class WorkflowInstanceError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, details?: Record<string, unknown> | undefined);
+}
+export declare class WorkflowInstanceStore {
+    private readonly db;
+    private readonly now;
+    constructor(db: Database.Database, now?: () => Date);
+    create(input: CreateWorkflowInstanceInput): WorkflowInstance;
+    getById(instanceId: string): WorkflowInstance | null;
+    getByIdOrThrow(instanceId: string): WorkflowInstance;
+    listByStatus(status: WorkflowInstanceStatus): WorkflowInstance[];
+    listAll(): WorkflowInstance[];
+    /**
+     * Update frontier + status atomically. Caller is responsible for
+     * wrapping in a transaction when this needs to compose with other
+     * mutations (e.g., workflow-projector folds this into the
+     * close + create + frontier-update transaction).
+     */
+    updateFrontier(instanceId: string, nextFrontier: string[], nextStatus: WorkflowInstanceStatus, opts?: {
+        bumpHopCount?: boolean;
+        lastContinuationDecision?: Record<string, unknown> | null;
+        fallbackSynthesis?: string | null;
+        completedAt?: string | null;
+        /**
+         * R2: explicit next current_step_id. When provided, OVERWRITES
+         * the column (including to NULL by passing the empty string for
+         * "clear"). When omitted, current_step_id is preserved (the
+         * frontier packet is reused, e.g., on waiting). To clear pass
+         * the symbol "clear-current-step" (typed as the literal below).
+         */
+        currentStepId?: string | "preserve" | "clear";
+    }): void;
+}
+//# sourceMappingURL=workflow-instance-store.d.ts.map

package/daemon/dist/domain/workflow-instance-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-instance-store.d.ts","sourceRoot":"","sources":["../../src/domain/workflow-instance-store.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAiB7B,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,GAAE,MAAM,IAAuB;IAGrD,MAAM,CAAC,KAAK,EAAE,2BAA2B,GAAG,gBAAgB;IAuB5D,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAOpD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB;IAYpD,YAAY,CAAC,MAAM,EAAE,sBAAsB,GAAG,gBAAgB,EAAE;IAShE,OAAO,IAAI,gBAAgB,EAAE;IAO7B;;;;;OAKG;IACH,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EAAE,EACtB,UAAU,EAAE,sBAAsB,EAClC,IAAI,GAAE;QACJ,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,wBAAwB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QAC1D,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B;;;;;;WAMG;QACH,aAAa,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;KAC1C,GACL,IAAI;CAyCR"}

package/daemon/dist/domain/workflow-instance-store.js

@@ -0,0 +1,116 @@
+// PL-004 Phase D: workflow instance store.
+//
+// Owns CRUD on workflow_instances. Frontier tracking uses
+// current_frontier_json (serialized JSON array of qitem_ids). Survives
+// daemon restart without filesystem reconciliation: list/getById query
+// SQLite directly.
+import { ulid } from "ulid";
+export class WorkflowInstanceError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "WorkflowInstanceError";
+    }
+}
+export class WorkflowInstanceStore {
+    db;
+    now;
+    constructor(db, now = () => new Date()) {
+        this.db = db;
+        this.now = now;
+    }
+    create(input) {
+        const instanceId = ulid();
+        const createdAt = this.now().toISOString();
+        const frontier = input.initialFrontier ?? [];
+        this.db
+            .prepare(`INSERT INTO workflow_instances (
+           instance_id, workflow_name, workflow_version, created_by_session,
+           created_at, status, current_frontier_json, current_step_id, hop_count
+         ) VALUES (?, ?, ?, ?, ?, 'active', ?, ?, 0)`)
+            .run(instanceId, input.workflowName, input.workflowVersion, input.createdBySession, createdAt, JSON.stringify(frontier), input.currentStepId ?? null);
+        return this.getByIdOrThrow(instanceId);
+    }
+    getById(instanceId) {
+        const row = this.db
+            .prepare(`SELECT * FROM workflow_instances WHERE instance_id = ?`)
+            .get(instanceId);
+        return row ? rowToInstance(row) : null;
+    }
+    getByIdOrThrow(instanceId) {
+        const inst = this.getById(instanceId);
+        if (!inst) {
+            throw new WorkflowInstanceError("instance_not_found", `workflow instance ${instanceId} not found`, { instanceId });
+        }
+        return inst;
+    }
+    listByStatus(status) {
+        const rows = this.db
+            .prepare(`SELECT * FROM workflow_instances WHERE status = ? ORDER BY created_at ASC`)
+            .all(status);
+        return rows.map(rowToInstance);
+    }
+    listAll() {
+        const rows = this.db
+            .prepare(`SELECT * FROM workflow_instances ORDER BY created_at ASC`)
+            .all();
+        return rows.map(rowToInstance);
+    }
+    /**
+     * Update frontier + status atomically. Caller is responsible for
+     * wrapping in a transaction when this needs to compose with other
+     * mutations (e.g., workflow-projector folds this into the
+     * close + create + frontier-update transaction).
+     */
+    updateFrontier(instanceId, nextFrontier, nextStatus, opts = {}) {
+        const setHop = opts.bumpHopCount ? "hop_count = hop_count + 1, " : "";
+        let currentStepClause = "";
+        let currentStepValue;
+        if (opts.currentStepId === "preserve" || opts.currentStepId === undefined) {
+            currentStepClause = "";
+            currentStepValue = undefined;
+        }
+        else if (opts.currentStepId === "clear") {
+            currentStepClause = "current_step_id = NULL, ";
+        }
+        else {
+            currentStepClause = "current_step_id = ?, ";
+            currentStepValue = opts.currentStepId;
+        }
+        const sql = `UPDATE workflow_instances SET
+           ${setHop}${currentStepClause}status = ?, current_frontier_json = ?,
+           last_continuation_decision_json = COALESCE(?, last_continuation_decision_json),
+           fallback_synthesis = COALESCE(?, fallback_synthesis),
+           completed_at = COALESCE(?, completed_at)
+         WHERE instance_id = ?`;
+        const stmt = this.db.prepare(sql);
+        if (currentStepValue !== undefined) {
+            stmt.run(currentStepValue, nextStatus, JSON.stringify(nextFrontier), opts.lastContinuationDecision ? JSON.stringify(opts.lastContinuationDecision) : null, opts.fallbackSynthesis ?? null, opts.completedAt ?? null, instanceId);
+        }
+        else {
+            stmt.run(nextStatus, JSON.stringify(nextFrontier), opts.lastContinuationDecision ? JSON.stringify(opts.lastContinuationDecision) : null, opts.fallbackSynthesis ?? null, opts.completedAt ?? null, instanceId);
+        }
+    }
+}
+function rowToInstance(row) {
+    return {
+        instanceId: row.instance_id,
+        workflowName: row.workflow_name,
+        workflowVersion: row.workflow_version,
+        createdBySession: row.created_by_session,
+        createdAt: row.created_at,
+        status: row.status,
+        currentFrontier: JSON.parse(row.current_frontier_json),
+        currentStepId: row.current_step_id,
+        hopCount: row.hop_count,
+        fallbackSynthesis: row.fallback_synthesis,
+        lastContinuationDecision: row.last_continuation_decision_json
+            ? JSON.parse(row.last_continuation_decision_json)
+            : null,
+        completedAt: row.completed_at,
+    };
+}
+//# sourceMappingURL=workflow-instance-store.js.map

package/daemon/dist/domain/workflow-instance-store.js.map

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

package/daemon/dist/domain/workflow-projector.d.ts

@@ -0,0 +1,64 @@
+import type Database from "better-sqlite3";
+import type { EventBus } from "./event-bus.js";
+import type { QueueRepository } from "./queue-repository.js";
+import type { WorkflowInstanceStore } from "./workflow-instance-store.js";
+import type { WorkflowSpecCache } from "./workflow-spec-cache.js";
+import type { WorkflowStepTrailLog } from "./workflow-step-trail-log.js";
+import type { WorkflowExitKind, WorkflowInstance } from "./workflow-types.js";
+export declare class WorkflowProjectorError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, details?: Record<string, unknown> | undefined);
+}
+export interface ProjectStepInput {
+    instanceId: string;
+    /** The qitem being closed (must be in instance.currentFrontier). */
+    currentPacketId: string;
+    /** What kind of exit closes this packet. */
+    exit: WorkflowExitKind;
+    /** Free-form closure result text (POC: --result). */
+    resultNote?: string;
+    /** For waiting exits: the blocker reference (qitem id, gate name). */
+    blockedOn?: string;
+    /** Operator-supplied evidence for the closure record (audit). */
+    closureEvidence?: Record<string, unknown>;
+    /** Session that closed the packet (owner-as-author). */
+    actorSession: string;
+    /**
+     * Optional explicit override for the next-step destination session.
+     * When omitted, the projector resolves from the next step's
+     * actor_role + role.preferred_targets[]. Required when no
+     * preferred_targets are declared OR none are operator-resolvable.
+     */
+    nextOwnerSession?: string;
+}
+export interface ProjectStepResult {
+    instance: WorkflowInstance;
+    closurePriorPacketId: string;
+    closureReason: WorkflowExitKind;
+    /** null on terminal closures (waiting / done / failed / no-successor). */
+    nextQitemId: string | null;
+    /** null on terminal closures. */
+    nextOwnerSession: string | null;
+    /** null on terminal closures. */
+    nextStepId: string | null;
+    /** Composite fired events (step_closed + optional next_qitem_projected + optional completed). */
+    emittedEventTypes: string[];
+}
+export declare class WorkflowProjector {
+    private readonly db;
+    private readonly eventBus;
+    private readonly queueRepo;
+    private readonly instanceStore;
+    private readonly trailLog;
+    private readonly specCache;
+    private readonly now;
+    constructor(db: Database.Database, eventBus: EventBus, queueRepo: QueueRepository, instanceStore: WorkflowInstanceStore, trailLog: WorkflowStepTrailLog, specCache: WorkflowSpecCache, now?: () => Date);
+    /**
+     * Close the current packet AND create/project the next-step packet
+     * IN THE SAME TRANSACTION. The load-bearing transactional-scribe
+     * call site.
+     */
+    project(input: ProjectStepInput): Promise<ProjectStepResult>;
+}
+//# sourceMappingURL=workflow-projector.d.ts.map

package/daemon/dist/domain/workflow-projector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-projector.d.ts","sourceRoot":"","sources":["../../src/domain/workflow-projector.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAGjB,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,eAAe,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,IAAI,EAAE,gBAAgB,CAAC;IACvB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,gBAAgB,CAAC;IAChC,0EAA0E;IAC1E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iCAAiC;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iGAAiG;IACjG,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBANH,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,eAAe,EAC1B,aAAa,EAAE,qBAAqB,EACpC,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,EAAE,iBAAiB,EAC5B,GAAG,GAAE,MAAM,IAAuB;IAGrD;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAuSnE"}