@selvakumaresra/specship 0.1.0

package/dist/workflows/runners/script.js

@@ -0,0 +1,155 @@
+"use strict";
+/**
+ * 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.
+ */
+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.ScriptRunner = void 0;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const DEFAULT_TIMEOUT_MS = 120_000;
+class ScriptRunner {
+    kind = 'script';
+    async run(rawNode, ctx) {
+        if (rawNode.kind !== 'script') {
+            return { status: 'failed', error: `ScriptRunner 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 bin = node.runtime === 'bun'
+            ? process.env.SPECSHIP_BUN_BIN ?? 'bun'
+            : process.env.SPECSHIP_UV_BIN ?? 'uv';
+        // Sanity-check the runtime exists before writing the script.
+        const which = (0, child_process_1.spawnSync)(bin, ['--version'], { encoding: 'utf-8', windowsHide: true });
+        if (which.status !== 0) {
+            return {
+                status: 'failed',
+                error: `${node.runtime} runtime not available (${bin} --version exited ${which.status})`,
+            };
+        }
+        // Write the script.
+        const ext = node.runtime === 'bun' ? 'ts' : 'py';
+        const scriptDir = path.join(ctx.artifactsDir, '..', 'scripts');
+        try {
+            fs.mkdirSync(scriptDir, { recursive: true });
+        }
+        catch { /* ignore */ }
+        const scriptPath = path.join(scriptDir, `${sanitizeFilename(node.id)}.${ext}`);
+        try {
+            fs.writeFileSync(scriptPath, node.script);
+        }
+        catch (err) {
+            return {
+                status: 'failed',
+                error: `failed to write script: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        // Install deps if declared.
+        if (node.deps && node.deps.length > 0) {
+            const installArgs = node.runtime === 'bun'
+                ? ['install', '--cwd', cwd, ...node.deps]
+                : ['add', ...node.deps];
+            const install = (0, child_process_1.spawnSync)(bin, installArgs, {
+                cwd,
+                env,
+                encoding: 'utf-8',
+                windowsHide: true,
+            });
+            if (install.status !== 0) {
+                return {
+                    status: 'failed',
+                    error: `dependency install failed: ${install.stderr?.slice(0, 2000) ?? 'unknown'}`,
+                };
+            }
+        }
+        const runArgs = node.runtime === 'bun' ? ['run', scriptPath] : ['run', scriptPath];
+        return new Promise((resolve) => {
+            const child = (0, child_process_1.spawn)(bin, runArgs, {
+                cwd,
+                env,
+                stdio: ['ignore', 'pipe', 'pipe'],
+                windowsHide: true,
+            });
+            let stdout = '';
+            let stderr = '';
+            child.stdout?.on('data', (c) => { stdout += c.toString(); });
+            child.stderr?.on('data', (c) => { stderr += c.toString(); });
+            const killer = setTimeout(() => {
+                try {
+                    child.kill('SIGTERM');
+                }
+                catch { /* ignore */ }
+            }, timeout);
+            child.on('error', (err) => {
+                clearTimeout(killer);
+                resolve({ status: 'failed', error: `spawn error: ${err.message}` });
+            });
+            child.on('close', (code, signal) => {
+                clearTimeout(killer);
+                if (code === 0) {
+                    resolve({ status: 'completed', output: { text: stdout } });
+                    return;
+                }
+                if (signal === 'SIGTERM') {
+                    resolve({
+                        status: 'failed',
+                        error: `script node timed out after ${timeout}ms`,
+                        transient: true,
+                    });
+                    return;
+                }
+                resolve({
+                    status: 'failed',
+                    error: `script exited with code ${code}: ${(stderr || stdout).slice(0, 4000)}`,
+                });
+            });
+        });
+    }
+}
+exports.ScriptRunner = ScriptRunner;
+function sanitizeFilename(s) {
+    return s.replace(/[^a-zA-Z0-9._-]/g, '-').substring(0, 80);
+}
+//# sourceMappingURL=script.js.map

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

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

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

@@ -0,0 +1,51 @@
+/**
+ * Node runner interface — one implementation per DagNode kind.
+ *
+ * Runners are pure functions over a RunnerContext + the typed node.
+ * They produce a NodeRunResult discriminated on outcome:
+ *   - 'completed' → success; emit `output` for downstream substitution
+ *   - 'failed'    → error message + (optional) `transient` flag for retry
+ *   - 'paused'    → approval gate; executor stops here, persists state
+ *   - 'cancelled' → CancelNode fired; executor terminates the whole run
+ */
+import { DagNode } from '../schemas/workflow';
+import { ApprovalContext } from '../../types';
+import { NodeOutput } from '../condition-evaluator';
+export interface RunnerContext {
+    /** Working directory for shell/script nodes (worktree path when isolated). */
+    cwd: string;
+    /** Directory for artifact files (`<runRoot>/nodes/<id>.md`, etc.). */
+    artifactsDir: string;
+    /** Logs directory for verbose JSONL output. */
+    logsDir: string;
+    /** Workflow run ID (used as the per-node log filename prefix). */
+    runId: string;
+    /** Inputs and variables for `$INPUT.X` / `$VAR` substitution. */
+    inputs?: Record<string, string>;
+    variables?: Record<string, string>;
+    /** Outputs of completed upstream nodes (for `$nodeId.output` substitution). */
+    outputs: Map<string, NodeOutput>;
+    /** Verbose logging flag. */
+    verbose?: boolean;
+}
+export type NodeRunResult = {
+    status: 'completed';
+    output: NodeOutput;
+} | {
+    status: 'failed';
+    error: string;
+    transient?: boolean;
+} | {
+    status: 'paused';
+    approval: ApprovalContext;
+} | {
+    status: 'cancelled';
+    reason: string;
+};
+export interface NodeRunner {
+    /** The node kinds this runner handles (one per file in practice). */
+    readonly kind: DagNode['kind'];
+    /** Execute the node and return a result. Should not throw — wrap errors in `{ status: 'failed' }`. */
+    run(node: DagNode, ctx: RunnerContext): Promise<NodeRunResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/workflows/runners/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,+EAA+E;IAC/E,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAC3C;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACxD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,sGAAsG;IACtG,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAChE"}

package/dist/workflows/runners/types.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Node runner interface — one implementation per DagNode kind.
+ *
+ * Runners are pure functions over a RunnerContext + the typed node.
+ * They produce a NodeRunResult discriminated on outcome:
+ *   - 'completed' → success; emit `output` for downstream substitution
+ *   - 'failed'    → error message + (optional) `transient` flag for retry
+ *   - 'paused'    → approval gate; executor stops here, persists state
+ *   - 'cancelled' → CancelNode fired; executor terminates the whole run
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

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

package/dist/workflows/schemas/workflow.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Workflow YAML schema (v1 subset).
+ *
+ * Adopted (with deliberate trimming) from Archon's
+ * `packages/workflows/src/schemas/workflow.ts:114-119` and
+ * `packages/workflows/src/schemas/dag-node.ts:212-356`. We:
+ *   - Keep 5 of 6 DAG node kinds (drop `command`, drop `loop`).
+ *   - Adopt `depends_on`, `trigger_rule`, `when`, `retry`, `allowed_tools`,
+ *     `denied_tools`, `hooks`, `mcp`, `skills`, `agents`, `output_type`,
+ *     `persist_session`, `always_run`, `idle_timeout`.
+ *   - Skip provider abstraction — Claude Code only.
+ *   - Skip Zod — hand-rolled type guards surface clearer errors at validation.
+ *
+ * Workflow files live under `<project>/.specship/workflows/` or
+ * `~/.specship/workflows/`, with bundled defaults in
+ * `src/workflows/defaults/` (compile-time embedded — see discovery.ts).
+ */
+import { WorkflowNodeKind } from '../../types';
+/** When all upstream `depends_on` nodes succeed (default), or other rules. */
+export type TriggerRule = 'all_success' | 'one_success' | 'none_failed_min_one_success' | 'all_done';
+export interface RetryConfig {
+    /** 1..5 (number of retries after the initial attempt). */
+    max_attempts: number;
+    /** Delay between retries in ms (default 3000). Doubled each retry. */
+    delay_ms?: number;
+    /** 'transient' = only retry transient errors (rate-limit, timeout, network); 'all' = retry on any failure. */
+    on_error?: 'transient' | 'all';
+}
+/** Capability gate: workflow refuses to run if any required capability is missing. */
+export type WorkflowCapability = 'specship' | 'git' | 'tests';
+/** Fields common to every DAG node kind. */
+export interface BaseNode {
+    /** Unique node ID within the workflow (referenced by `depends_on` and `$nodeId.output`). */
+    id: string;
+    /** Node kind discriminator. */
+    kind: WorkflowNodeKind;
+    /** Other node IDs whose completion gates this one. */
+    depends_on?: string[];
+    /** Gating semantics: how `depends_on` results combine. Default: `all_success`. */
+    trigger_rule?: TriggerRule;
+    /** Boolean condition expression. Skips the node when false. Uses `$nodeId.output` substitution. */
+    when?: string;
+    /** Per-node retry config. Default: 2 retries on transient errors. */
+    retry?: RetryConfig;
+    /**
+     * Optional semantic tag for this node's output (e.g. 'plan', 'diff',
+     * 'test_results', 'link_summary'). Drives artifact filename + UI surfacing.
+     */
+    output_type?: string;
+    /** Run even when an upstream is failed (used for cleanup nodes). */
+    always_run?: boolean;
+    /** Persist the provider session ID across runs so a re-run resumes context. */
+    persist_session?: boolean;
+    /** Hard cap on idle wall-clock time before the node is failed (ms). */
+    idle_timeout?: number;
+}
+/** Invoke the coding agent (Claude Code SDK) with a prompt. */
+export interface PromptNode extends BaseNode {
+    kind: 'prompt';
+    prompt: string;
+    /** Restrict the agent to a specific set of tools (allowlist). */
+    allowed_tools?: string[];
+    /** Block specific tools (denylist). Applied after allowlist. */
+    denied_tools?: string[];
+    /** Model override (defaults to the workflow's `model` or Claude Code default). */
+    model?: string;
+    /** Per-node MCP server config (in addition to globally configured servers). */
+    mcp?: Record<string, unknown>;
+    /** Skills to make available to this prompt. */
+    skills?: string[];
+    /** Sub-agents this prompt can summon via the Task tool. */
+    agents?: string[];
+    /** Hook callbacks (PreToolUse, PostToolUse, etc.) — passed through to the SDK. */
+    hooks?: Record<string, unknown>;
+    /** Append to the system prompt for THIS node only. */
+    systemPromptAppend?: string;
+}
+/** Run a bash command. Exit 0 = success; non-zero = node failure. */
+export interface BashNode extends BaseNode {
+    kind: 'bash';
+    bash: string;
+    /** Timeout in ms (default 60_000). */
+    timeout?: number;
+    /** Working directory override (default = run's isolation env or cwd). */
+    cwd?: string;
+    /** Extra env vars merged into the child process. */
+    env?: Record<string, string>;
+}
+/** Run a TypeScript/Python script via `bun run` or `uv run`. */
+export interface ScriptNode extends BaseNode {
+    kind: 'script';
+    script: string;
+    runtime: 'bun' | 'uv';
+    /** Optional dependencies installed via the chosen runtime's package manager. */
+    deps?: string[];
+    timeout?: number;
+    cwd?: string;
+    env?: Record<string, string>;
+}
+/** Pause the workflow for human review. Resume via `manage_run.approve`. */
+export interface ApprovalNode extends BaseNode {
+    kind: 'approval';
+    /** Message shown to the user when the workflow pauses. */
+    message: string;
+    /** If true, the user's reply text becomes `$nodeId.output`. */
+    capture_response?: boolean;
+    /** Optional on-reject retry config. */
+    on_reject?: {
+        prompt: string;
+        max_attempts?: number;
+    };
+}
+/** Terminate the workflow with a reason. */
+export interface CancelNode extends BaseNode {
+    kind: 'cancel';
+    /** Reason for cancellation. */
+    cancel: string;
+}
+/** Union of all DAG node types. */
+export type DagNode = PromptNode | BashNode | ScriptNode | ApprovalNode | CancelNode;
+export interface WorkflowDefinition {
+    /** Workflow name (filename stem by convention). */
+    name: string;
+    /** Human-readable description. */
+    description?: string;
+    /** Free-form tags. */
+    tags?: string[];
+    /** Required capabilities; the executor fails fast if any is unavailable. */
+    requires?: WorkflowCapability[];
+    /** Default model for prompt nodes. */
+    model?: string;
+    /** Default systemPromptAppend for every prompt node. */
+    systemPromptAppend?: string;
+    /** Worktree isolation policy. Default: { enabled: false }. */
+    worktree?: {
+        enabled: boolean;
+        /** Override the base branch (defaults to the current branch of repoRoot). */
+        base_branch?: string;
+    };
+    /** Inputs the workflow accepts at start time (e.g., SPEC_ID, LINK_ID). */
+    inputs?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+        default?: string;
+    }>;
+    /** The DAG. Each node has a unique `id`. */
+    nodes: DagNode[];
+}
+export interface ValidationError {
+    /** Dotted path into the workflow object (e.g., `nodes[2].depends_on`). */
+    path: string;
+    message: string;
+}
+export interface ValidationResult {
+    ok: boolean;
+    workflow?: WorkflowDefinition;
+    errors: ValidationError[];
+}
+/**
+ * Validate a parsed YAML object as a `WorkflowDefinition`. Returns errors
+ * collected from the full tree — does not short-circuit so the author sees
+ * all issues at once.
+ */
+export declare function validateWorkflow(input: unknown): ValidationResult;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflows/schemas/workflow.d.ts.map

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