@selvakumaresra/specship 0.1.0

package/dist/workflows/runners/approval.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ApprovalNode runner — emits a "paused" result.
+ *
+ * The runner doesn't block here; it returns an ApprovalContext that the
+ * executor persists into `workflow_runs.metadata` and transitions the run
+ * to `status='paused'`. The next caller of `approve(runId)` then
+ * `resume(workflow, runId)` continues execution from the gate.
+ *
+ * This matches Archon's approval flow (manage_run.approve transitions
+ * state; resume drives the next step).
+ */
+import { DagNode } from '../schemas/workflow';
+import { NodeRunner, NodeRunResult, RunnerContext } from './types';
+export declare class ApprovalRunner implements NodeRunner {
+    readonly kind: "approval";
+    run(rawNode: DagNode, _ctx: RunnerContext): Promise<NodeRunResult>;
+}
+//# sourceMappingURL=approval.d.ts.map

package/dist/workflows/runners/approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../../src/workflows/runners/approval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAgB,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGnE,qBAAa,cAAe,YAAW,UAAU;IAC/C,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAG9B,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAgBzE"}

package/dist/workflows/runners/approval.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * ApprovalNode runner — emits a "paused" result.
+ *
+ * The runner doesn't block here; it returns an ApprovalContext that the
+ * executor persists into `workflow_runs.metadata` and transitions the run
+ * to `status='paused'`. The next caller of `approve(runId)` then
+ * `resume(workflow, runId)` continues execution from the gate.
+ *
+ * This matches Archon's approval flow (manage_run.approve transitions
+ * state; resume drives the next step).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApprovalRunner = void 0;
+class ApprovalRunner {
+    kind = 'approval';
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async run(rawNode, _ctx) {
+        if (rawNode.kind !== 'approval') {
+            return { status: 'failed', error: `ApprovalRunner received ${rawNode.kind} node` };
+        }
+        const node = rawNode;
+        const approval = {
+            type: 'approval',
+            nodeId: node.id,
+            message: node.message,
+            captureResponse: node.capture_response,
+            onReject: node.on_reject,
+        };
+        return { status: 'paused', approval };
+    }
+}
+exports.ApprovalRunner = ApprovalRunner;
+//# sourceMappingURL=approval.js.map

package/dist/workflows/runners/approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../../src/workflows/runners/approval.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAMH,MAAa,cAAc;IAChB,IAAI,GAAG,UAAmB,CAAC;IAEpC,6DAA6D;IAC7D,KAAK,CAAC,GAAG,CAAC,OAAgB,EAAE,IAAmB;QAC7C,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,2BAA2B,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC;QACrF,CAAC;QACD,MAAM,IAAI,GAAG,OAAuB,CAAC;QAErC,MAAM,QAAQ,GAAoB;YAChC,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,eAAe,EAAE,IAAI,CAAC,gBAAgB;YACtC,QAAQ,EAAE,IAAI,CAAC,SAAS;SACzB,CAAC;QAEF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACxC,CAAC;CACF;AApBD,wCAoBC"}

package/dist/workflows/runners/bash.d.ts

@@ -0,0 +1,13 @@
+/**
+ * BashNode runner — executes a shell command and captures stdout/stderr.
+ *
+ * Default shell: `/bin/bash -c` on POSIX, `cmd.exe /c` on Windows.
+ * Non-zero exit code → node failure.
+ */
+import { DagNode } from '../schemas/workflow';
+import { NodeRunner, NodeRunResult, RunnerContext } from './types';
+export declare class BashRunner implements NodeRunner {
+    readonly kind: "bash";
+    run(rawNode: DagNode, ctx: RunnerContext): Promise<NodeRunResult>;
+}
+//# sourceMappingURL=bash.d.ts.map

package/dist/workflows/runners/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/workflows/runners/bash.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,OAAO,EAAY,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAInE,qBAAa,UAAW,YAAW,UAAU;IAC3C,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAE1B,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAgGxE"}

package/dist/workflows/runners/bash.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * BashNode runner — executes a shell command and captures stdout/stderr.
+ *
+ * Default shell: `/bin/bash -c` on POSIX, `cmd.exe /c` on Windows.
+ * Non-zero exit code → node failure.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BashRunner = void 0;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const DEFAULT_TIMEOUT_MS = 60_000;
+class BashRunner {
+    kind = 'bash';
+    async run(rawNode, ctx) {
+        if (rawNode.kind !== 'bash') {
+            return { status: 'failed', error: `BashRunner received ${rawNode.kind} node` };
+        }
+        const node = rawNode;
+        const cwd = node.cwd ?? ctx.cwd;
+        const timeout = node.timeout ?? DEFAULT_TIMEOUT_MS;
+        const env = { ...process.env, ...(node.env ?? {}) };
+        const isWindows = process.platform === 'win32';
+        const shell = isWindows ? 'cmd.exe' : '/bin/bash';
+        const shellArgs = isWindows ? ['/c', node.bash] : ['-c', node.bash];
+        const logPath = path.join(ctx.logsDir, `${ctx.runId}-${node.id}.bash.log`);
+        return new Promise((resolve) => {
+            let child;
+            try {
+                child = (0, child_process_1.spawn)(shell, shellArgs, {
+                    cwd,
+                    env,
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                    windowsHide: true,
+                });
+            }
+            catch (err) {
+                resolve({
+                    status: 'failed',
+                    error: `failed to spawn shell: ${err instanceof Error ? err.message : String(err)}`,
+                });
+                return;
+            }
+            let stdout = '';
+            let stderr = '';
+            const logStream = (() => {
+                try {
+                    return fs.createWriteStream(logPath, { flags: 'a' });
+                }
+                catch {
+                    return null;
+                }
+            })();
+            logStream?.write(`# bash node ${node.id} started at ${new Date().toISOString()}\n`);
+            logStream?.write(`# cwd: ${cwd}\n`);
+            logStream?.write(`# command: ${node.bash}\n\n`);
+            child.stdout?.on('data', (chunk) => {
+                const s = chunk.toString();
+                stdout += s;
+                logStream?.write(s);
+            });
+            child.stderr?.on('data', (chunk) => {
+                const s = chunk.toString();
+                stderr += s;
+                logStream?.write(`[stderr] ${s}`);
+            });
+            const killer = setTimeout(() => {
+                try {
+                    child.kill('SIGTERM');
+                }
+                catch { /* ignore */ }
+            }, timeout);
+            child.on('error', (err) => {
+                clearTimeout(killer);
+                logStream?.end();
+                resolve({
+                    status: 'failed',
+                    error: `spawn error: ${err.message}`,
+                });
+            });
+            child.on('close', (code, signal) => {
+                clearTimeout(killer);
+                logStream?.end();
+                if (code === 0) {
+                    resolve({
+                        status: 'completed',
+                        output: { text: stdout },
+                    });
+                    return;
+                }
+                if (signal === 'SIGTERM') {
+                    resolve({
+                        status: 'failed',
+                        error: `bash node timed out after ${timeout}ms`,
+                        transient: true,
+                    });
+                    return;
+                }
+                const errMsg = (stderr || stdout || '').slice(0, 4000);
+                resolve({
+                    status: 'failed',
+                    error: `bash exited with code ${code}: ${errMsg}`,
+                });
+            });
+        });
+    }
+}
+exports.BashRunner = BashRunner;
+//# sourceMappingURL=bash.js.map

package/dist/workflows/runners/bash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../../src/workflows/runners/bash.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,iDAAsC;AACtC,uCAAyB;AACzB,2CAA6B;AAI7B,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,MAAa,UAAU;IACZ,IAAI,GAAG,MAAe,CAAC;IAEhC,KAAK,CAAC,GAAG,CAAC,OAAgB,EAAE,GAAkB;QAC5C,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,uBAAuB,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC;QACjF,CAAC;QACD,MAAM,IAAI,GAAG,OAAmB,CAAC;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,kBAAkB,CAAC;QACnD,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;QAEpD,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;QAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;QAClD,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;QAE3E,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;YAC5C,IAAI,KAAK,CAAC;YACV,IAAI,CAAC;gBACH,KAAK,GAAG,IAAA,qBAAK,EAAC,KAAK,EAAE,SAAS,EAAE;oBAC9B,GAAG;oBACH,GAAG;oBACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;oBACjC,WAAW,EAAE,IAAI;iBAClB,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC;oBACN,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,0BAA0B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;iBACpF,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE;gBACtB,IAAI,CAAC;oBACH,OAAO,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;gBACvD,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;YACL,SAAS,EAAE,KAAK,CAAC,eAAe,IAAI,CAAC,EAAE,eAAe,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YACpF,SAAS,EAAE,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;YACpC,SAAS,EAAE,KAAK,CAAC,cAAc,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC;YAEhD,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACzC,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC3B,MAAM,IAAI,CAAC,CAAC;gBACZ,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACzC,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC3B,MAAM,IAAI,CAAC,CAAC;gBACZ,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC7B,IAAI,CAAC;oBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YACvD,CAAC,EAAE,OAAO,CAAC,CAAC;YAEZ,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,YAAY,CAAC,MAAM,CAAC,CAAC;gBACrB,SAAS,EAAE,GAAG,EAAE,CAAC;gBACjB,OAAO,CAAC;oBACN,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,gBAAgB,GAAG,CAAC,OAAO,EAAE;iBACrC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;gBACjC,YAAY,CAAC,MAAM,CAAC,CAAC;gBACrB,SAAS,EAAE,GAAG,EAAE,CAAC;gBAEjB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,CAAC;wBACN,MAAM,EAAE,WAAW;wBACnB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;qBACzB,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,OAAO,CAAC;wBACN,MAAM,EAAE,QAAQ;wBAChB,KAAK,EAAE,6BAA6B,OAAO,IAAI;wBAC/C,SAAS,EAAE,IAAI;qBAChB,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBACD,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACvD,OAAO,CAAC;oBACN,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,yBAAyB,IAAI,KAAK,MAAM,EAAE;iBAClD,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAnGD,gCAmGC"}

package/dist/workflows/runners/cancel.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CancelNode runner — terminates the workflow with the given reason.
+ */
+import { DagNode } from '../schemas/workflow';
+import { NodeRunner, NodeRunResult, RunnerContext } from './types';
+export declare class CancelRunner implements NodeRunner {
+    readonly kind: "cancel";
+    run(rawNode: DagNode, _ctx: RunnerContext): Promise<NodeRunResult>;
+}
+//# sourceMappingURL=cancel.d.ts.map

package/dist/workflows/runners/cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../../src/workflows/runners/cancel.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAc,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEnE,qBAAa,YAAa,YAAW,UAAU;IAC7C,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAG5B,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAOzE"}

package/dist/workflows/runners/cancel.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * CancelNode runner — terminates the workflow with the given reason.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelRunner = void 0;
+class CancelRunner {
+    kind = 'cancel';
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async run(rawNode, _ctx) {
+        if (rawNode.kind !== 'cancel') {
+            return { status: 'failed', error: `CancelRunner received ${rawNode.kind} node` };
+        }
+        const node = rawNode;
+        return { status: 'cancelled', reason: node.cancel };
+    }
+}
+exports.CancelRunner = CancelRunner;
+//# sourceMappingURL=cancel.js.map

package/dist/workflows/runners/cancel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.js","sourceRoot":"","sources":["../../../src/workflows/runners/cancel.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH,MAAa,YAAY;IACd,IAAI,GAAG,QAAiB,CAAC;IAElC,6DAA6D;IAC7D,KAAK,CAAC,GAAG,CAAC,OAAgB,EAAE,IAAmB;QAC7C,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,yBAAyB,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC;QACnF,CAAC;QACD,MAAM,IAAI,GAAG,OAAqB,CAAC;QACnC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACtD,CAAC;CACF;AAXD,oCAWC"}

package/dist/workflows/runners/prompt.d.ts

@@ -0,0 +1,28 @@
+/**
+ * PromptNode runner — invokes Claude Code in headless mode.
+ *
+ * Why shell out instead of embedding the Claude Agent SDK:
+ *   - This fork is Claude-Code-only; users have `claude` on PATH already.
+ *   - The SDK pulls in real auth complexity + ~MB of deps. The CLI's
+ *     headless `--print` mode is purpose-built for non-interactive use.
+ *   - Per-node `allowed_tools` / `denied_tools` / `model` map cleanly to
+ *     CLI flags.
+ *
+ * Limitations (acceptable for v1):
+ *   - Per-node MCP server config (`nodeConfig.mcp`) is NOT plumbed yet —
+ *     prompt nodes inherit whatever MCP servers the host Claude Code session
+ *     has configured. v2 candidate.
+ *   - Per-node hooks (PreToolUse / PostToolUse) likewise inherit host-level
+ *     hooks. v2 will write a per-run settings file.
+ *   - Skills / agents passed via flags will need verification on Claude Code
+ *     versions that support them.
+ *
+ * Verbose tool output streams to `<logsDir>/<runId>-<nodeId>.jsonl`.
+ */
+import { DagNode } from '../schemas/workflow';
+import { NodeRunner, NodeRunResult, RunnerContext } from './types';
+export declare class PromptRunner implements NodeRunner {
+    readonly kind: "prompt";
+    run(rawNode: DagNode, ctx: RunnerContext): Promise<NodeRunResult>;
+}
+//# sourceMappingURL=prompt.d.ts.map

package/dist/workflows/runners/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/workflows/runners/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,OAAO,EAAE,OAAO,EAAc,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAWnE,qBAAa,YAAa,YAAW,UAAU;IAC7C,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAE5B,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAyIxE"}

package/dist/workflows/runners/prompt.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * PromptNode runner — invokes Claude Code in headless mode.
+ *
+ * Why shell out instead of embedding the Claude Agent SDK:
+ *   - This fork is Claude-Code-only; users have `claude` on PATH already.
+ *   - The SDK pulls in real auth complexity + ~MB of deps. The CLI's
+ *     headless `--print` mode is purpose-built for non-interactive use.
+ *   - Per-node `allowed_tools` / `denied_tools` / `model` map cleanly to
+ *     CLI flags.
+ *
+ * Limitations (acceptable for v1):
+ *   - Per-node MCP server config (`nodeConfig.mcp`) is NOT plumbed yet —
+ *     prompt nodes inherit whatever MCP servers the host Claude Code session
+ *     has configured. v2 candidate.
+ *   - Per-node hooks (PreToolUse / PostToolUse) likewise inherit host-level
+ *     hooks. v2 will write a per-run settings file.
+ *   - Skills / agents passed via flags will need verification on Claude Code
+ *     versions that support them.
+ *
+ * Verbose tool output streams to `<logsDir>/<runId>-<nodeId>.jsonl`.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptRunner = void 0;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const TRANSIENT_PATTERNS = [
+    /rate.?limit/i,
+    /timeout/i,
+    /network/i,
+    /connection.?reset/i,
+    /econn/i,
+    /etimedout/i,
+];
+class PromptRunner {
+    kind = 'prompt';
+    async run(rawNode, ctx) {
+        if (rawNode.kind !== 'prompt') {
+            return { status: 'failed', error: `PromptRunner received ${rawNode.kind} node` };
+        }
+        const node = rawNode;
+        const claudeBin = process.env.SPECSHIP_CLAUDE_BIN ?? 'claude';
+        const args = [];
+        args.push('--print');
+        // Output as JSON so we can parse the response cleanly.
+        args.push('--output-format', 'json');
+        if (node.model)
+            args.push('--model', node.model);
+        if (node.allowed_tools && node.allowed_tools.length > 0) {
+            args.push('--allowed-tools', node.allowed_tools.join(','));
+        }
+        if (node.denied_tools && node.denied_tools.length > 0) {
+            args.push('--disallowed-tools', node.denied_tools.join(','));
+        }
+        if (node.systemPromptAppend) {
+            args.push('--append-system-prompt', node.systemPromptAppend);
+        }
+        // Verbose output streaming.
+        const logPath = path.join(ctx.logsDir, `${ctx.runId}-${node.id}.jsonl`);
+        return new Promise((resolve) => {
+            let child;
+            try {
+                child = (0, child_process_1.spawn)(claudeBin, args, {
+                    cwd: ctx.cwd,
+                    env: process.env,
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                    windowsHide: true,
+                });
+            }
+            catch (err) {
+                resolve({
+                    status: 'failed',
+                    error: `failed to spawn ${claudeBin}: ${err instanceof Error ? err.message : String(err)}`,
+                });
+                return;
+            }
+            let stdout = '';
+            let stderr = '';
+            let logStream = null;
+            try {
+                logStream = fs.createWriteStream(logPath, { flags: 'a' });
+                logStream.write(`${JSON.stringify({ event: 'spawn', cwd: ctx.cwd, args, ts: Date.now() })}\n`);
+            }
+            catch {
+                logStream = null;
+            }
+            child.stdout?.on('data', (chunk) => {
+                stdout += chunk.toString();
+                logStream?.write(`${JSON.stringify({ event: 'stdout', chunk: chunk.toString(), ts: Date.now() })}\n`);
+            });
+            child.stderr?.on('data', (chunk) => {
+                stderr += chunk.toString();
+                logStream?.write(`${JSON.stringify({ event: 'stderr', chunk: chunk.toString(), ts: Date.now() })}\n`);
+            });
+            const timeoutMs = node.idle_timeout ?? 0;
+            const killer = timeoutMs > 0
+                ? setTimeout(() => {
+                    try {
+                        child.kill('SIGTERM');
+                    }
+                    catch { /* ignore */ }
+                }, timeoutMs)
+                : null;
+            child.on('error', (err) => {
+                if (killer)
+                    clearTimeout(killer);
+                logStream?.end();
+                resolve({
+                    status: 'failed',
+                    error: `spawn error: ${err.message}`,
+                    transient: isTransient(err.message),
+                });
+            });
+            child.on('close', (code) => {
+                if (killer)
+                    clearTimeout(killer);
+                logStream?.end();
+                if (code !== 0) {
+                    const errMsg = (stderr || stdout || '').slice(0, 4000);
+                    resolve({
+                        status: 'failed',
+                        error: `claude exited with code ${code}: ${errMsg}`,
+                        transient: isTransient(errMsg),
+                    });
+                    return;
+                }
+                // Try to parse Claude's JSON output. If it's plain text, treat the
+                // whole stdout as the response.
+                let text = stdout;
+                let structured;
+                try {
+                    const parsed = JSON.parse(stdout);
+                    if (parsed && typeof parsed === 'object') {
+                        structured = parsed;
+                        // Common shapes: { result, ... } or { content: [...] }
+                        if (typeof structured.result === 'string') {
+                            text = structured.result;
+                        }
+                        else if (Array.isArray(structured.content)) {
+                            text = structured.content
+                                .map((c) => c.text ?? '')
+                                .join('');
+                        }
+                        else {
+                            text = stdout;
+                        }
+                    }
+                }
+                catch {
+                    // Not JSON — keep raw stdout as text.
+                }
+                resolve({
+                    status: 'completed',
+                    output: { text, structured },
+                });
+            });
+            // Send the prompt on stdin.
+            try {
+                child.stdin?.write(node.prompt);
+                child.stdin?.end();
+            }
+            catch (err) {
+                if (killer)
+                    clearTimeout(killer);
+                logStream?.end();
+                resolve({
+                    status: 'failed',
+                    error: `stdin write failed: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+        });
+    }
+}
+exports.PromptRunner = PromptRunner;
+function isTransient(msg) {
+    return TRANSIENT_PATTERNS.some((p) => p.test(msg));
+}
+//# sourceMappingURL=prompt.js.map

package/dist/workflows/runners/prompt.js.map

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

package/dist/workflows/runners/script.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ScriptNode runner — executes a TypeScript/Python script via `bun` or `uv`.
+ *
+ * The script source is written to a temp file under
+ * `<artifactsDir>/scripts/<nodeId>.{ts,py}` and invoked by the chosen runtime.
+ * Optional `deps` are installed first (`bun install <pkg>` / `uv add <pkg>`).
+ *
+ * The runtime binary is resolved from `SPECSHIP_BUN_BIN` / `SPECSHIP_UV_BIN`
+ * env vars if set, else `bun` / `uv` on PATH.
+ */
+import { DagNode } from '../schemas/workflow';
+import { NodeRunner, NodeRunResult, RunnerContext } from './types';
+export declare class ScriptRunner implements NodeRunner {
+    readonly kind: "script";
+    run(rawNode: DagNode, ctx: RunnerContext): Promise<NodeRunResult>;
+}
+//# sourceMappingURL=script.d.ts.map

package/dist/workflows/runners/script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../../src/workflows/runners/script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,OAAO,EAAc,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAInE,qBAAa,YAAa,YAAW,UAAU;IAC7C,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAE5B,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAqGxE"}