@ghostwater/soulforge 0.1.0

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./db/database.js";
+export * from "./workflow/types.js";
+export * from "./workflow/parser.js";
+export * from "./workflow/template.js";
+export * from "./executors/types.js";
+export * from "./executors/registry.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}

package/dist/lib/logger.d.ts

@@ -0,0 +1,7 @@
+export declare const logger: {
+    info: (msg: string, meta?: Record<string, any>) => void;
+    warn: (msg: string, meta?: Record<string, any>) => void;
+    error: (msg: string, meta?: Record<string, any>) => void;
+    debug: (msg: string, meta?: Record<string, any>) => void;
+};
+export declare function readRecentLogs(lines?: number): string[];

package/dist/lib/logger.js

@@ -0,0 +1,56 @@
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+const LOG_DIR = path.join(os.homedir(), ".soulforge");
+const LOG_PATH = path.join(LOG_DIR, "daemon.log");
+const MAX_LOG_SIZE = 5 * 1024 * 1024; // 5MB
+function ensureLogDir() {
+    fs.mkdirSync(LOG_DIR, { recursive: true });
+}
+function rotateIfNeeded() {
+    try {
+        const stat = fs.statSync(LOG_PATH);
+        if (stat.size > MAX_LOG_SIZE) {
+            const backup = LOG_PATH + ".1";
+            try {
+                fs.unlinkSync(backup);
+            }
+            catch { }
+            fs.renameSync(LOG_PATH, backup);
+        }
+    }
+    catch {
+        // File doesn't exist yet
+    }
+}
+function formatEntry(level, message, meta) {
+    const ts = new Date().toISOString();
+    const metaStr = meta ? " " + JSON.stringify(meta) : "";
+    return `[${ts}] ${level.toUpperCase()} ${message}${metaStr}\n`;
+}
+function write(level, message, meta) {
+    ensureLogDir();
+    rotateIfNeeded();
+    const entry = formatEntry(level, message, meta);
+    fs.appendFileSync(LOG_PATH, entry);
+    if (level === "error") {
+        process.stderr.write(entry);
+    }
+}
+export const logger = {
+    info: (msg, meta) => write("info", msg, meta),
+    warn: (msg, meta) => write("warn", msg, meta),
+    error: (msg, meta) => write("error", msg, meta),
+    debug: (msg, meta) => write("debug", msg, meta),
+};
+export function readRecentLogs(lines = 50) {
+    try {
+        const content = fs.readFileSync(LOG_PATH, "utf-8");
+        const allLines = content.split("\n").filter((l) => l.trim());
+        return allLines.slice(-lines);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

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

package/dist/lib/worktree.d.ts

@@ -0,0 +1,30 @@
+export interface WorktreeResult {
+    worktreePath: string;
+    branch: string;
+}
+export interface GitRepoInfo {
+    type: 'bare' | 'standard' | 'worktree' | 'not-git';
+    repoRoot: string | null;
+}
+/**
+ * Validate whether a path is a git repository and determine its type.
+ * - 'bare': Uses bare+worktree layout (.bare/ exists in parent)
+ * - 'standard': Regular .git directory
+ * - 'worktree': Inside an existing worktree
+ * - 'not-git': Not a git repository
+ */
+export declare function validateGitRepo(repoPath: string): GitRepoInfo;
+/**
+ * Check if a branch already exists in the repository.
+ */
+export declare function branchExists(repoPath: string, branchName: string): boolean;
+/**
+ * Create a worktree for the given repository with a new branch.
+ *
+ * @param repoInfo - Validated git repo info from validateGitRepo()
+ * @param repoPath - Original path provided by user
+ * @param branch - Branch name to create
+ * @returns WorktreeResult with the path to the created worktree
+ */
+export declare function createWorktree(repoPath: string, branch: string, repoInfo?: GitRepoInfo): WorktreeResult;
+export declare function removeWorktree(repoPath: string, worktreePath: string): void;

package/dist/lib/worktree.js

@@ -0,0 +1,131 @@
+import { execSync } from 'node:child_process';
+import path from 'node:path';
+import fs from 'node:fs';
+/**
+ * Validate whether a path is a git repository and determine its type.
+ * - 'bare': Uses bare+worktree layout (.bare/ exists in parent)
+ * - 'standard': Regular .git directory
+ * - 'worktree': Inside an existing worktree
+ * - 'not-git': Not a git repository
+ */
+export function validateGitRepo(repoPath) {
+    const resolvedPath = path.resolve(repoPath);
+    // Check if .bare/ exists in parent (bare+worktree layout)
+    const parentDir = path.dirname(resolvedPath);
+    const bareDir = path.join(parentDir, '.bare');
+    if (fs.existsSync(bareDir) && fs.statSync(bareDir).isDirectory()) {
+        return { type: 'bare', repoRoot: parentDir };
+    }
+    // Check if we're inside a worktree by looking for .git file (not directory)
+    const gitPath = path.join(resolvedPath, '.git');
+    if (fs.existsSync(gitPath)) {
+        const stat = fs.statSync(gitPath);
+        if (stat.isFile()) {
+            // .git is a file, meaning this is a worktree - resolve to parent repo
+            try {
+                const superproject = execSync('git rev-parse --show-superproject-working-tree', {
+                    cwd: resolvedPath,
+                    encoding: 'utf-8',
+                }).trim();
+                if (superproject) {
+                    // Recursively validate the parent repo
+                    return validateGitRepo(superproject);
+                }
+            }
+            catch {
+                // Fall through to standard check
+            }
+            return { type: 'worktree', repoRoot: resolvedPath };
+        }
+        else if (stat.isDirectory()) {
+            return { type: 'standard', repoRoot: resolvedPath };
+        }
+    }
+    // Check if we're somewhere inside a git repo
+    try {
+        const gitRoot = execSync('git rev-parse --show-toplevel', {
+            cwd: resolvedPath,
+            encoding: 'utf-8',
+        }).trim();
+        if (gitRoot) {
+            // Check if this git root has a bare parent
+            const gitRootParent = path.dirname(gitRoot);
+            const gitRootBareDir = path.join(gitRootParent, '.bare');
+            if (fs.existsSync(gitRootBareDir) && fs.statSync(gitRootBareDir).isDirectory()) {
+                return { type: 'bare', repoRoot: gitRootParent };
+            }
+            return { type: 'standard', repoRoot: gitRoot };
+        }
+    }
+    catch {
+        // Not a git repo
+    }
+    return { type: 'not-git', repoRoot: null };
+}
+/**
+ * Check if a branch already exists in the repository.
+ */
+export function branchExists(repoPath, branchName) {
+    try {
+        const result = execSync(`git branch --list "${branchName}"`, {
+            cwd: repoPath,
+            encoding: 'utf-8',
+        }).trim();
+        return result.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create a worktree for the given repository with a new branch.
+ *
+ * @param repoInfo - Validated git repo info from validateGitRepo()
+ * @param repoPath - Original path provided by user
+ * @param branch - Branch name to create
+ * @returns WorktreeResult with the path to the created worktree
+ */
+export function createWorktree(repoPath, branch, repoInfo) {
+    // If no repoInfo provided, validate the repo
+    const info = repoInfo ?? validateGitRepo(repoPath);
+    if (info.type === 'not-git') {
+        throw new Error(`Cannot create worktree: ${repoPath} is not a git repository. Use --workdir instead.`);
+    }
+    const repoRoot = info.repoRoot;
+    // Check if branch already exists
+    if (branchExists(repoRoot, branch)) {
+        throw new Error(`Branch '${branch}' already exists. Use --branch to specify a different name, or --workdir to work in an existing directory.`);
+    }
+    // Determine worktree placement based on repo type
+    let worktreesDir;
+    let gitDir;
+    let workingDir;
+    if (info.type === 'bare') {
+        // Bare layout: worktrees go in <parent>/worktrees/
+        worktreesDir = path.join(repoRoot, 'worktrees');
+        gitDir = path.join(repoRoot, '.bare');
+        workingDir = repoRoot;
+    }
+    else {
+        // Standard or worktree: worktrees go in <repo>/worktrees/
+        worktreesDir = path.join(repoRoot, 'worktrees');
+        gitDir = path.join(repoRoot, '.git');
+        workingDir = repoRoot;
+    }
+    const worktreePath = path.join(worktreesDir, branch.replace(/\//g, '-'));
+    fs.mkdirSync(worktreesDir, { recursive: true });
+    // Get current HEAD to branch from
+    const head = execSync('git rev-parse HEAD', { cwd: workingDir }).toString().trim();
+    // Create worktree with new branch
+    execSync(`git worktree add "${worktreePath}" -b "${branch}" ${head}`, { cwd: workingDir, env: { ...process.env, GIT_DIR: gitDir } });
+    return { worktreePath, branch };
+}
+export function removeWorktree(repoPath, worktreePath) {
+    try {
+        execSync(`git worktree remove "${worktreePath}" --force`, { cwd: repoPath });
+    }
+    catch {
+        // Best effort cleanup
+    }
+}
+//# sourceMappingURL=worktree.js.map

package/dist/lib/worktree.js.map

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

package/dist/workflow/parser.d.ts

@@ -0,0 +1,2 @@
+import type { WorkflowSpec } from "./types.js";
+export declare function loadWorkflowSpec(workflowPath: string): Promise<WorkflowSpec>;

package/dist/workflow/parser.js

@@ -0,0 +1,95 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import YAML from "yaml";
+export async function loadWorkflowSpec(workflowPath) {
+    // workflowPath can be a directory (containing workflow.yml) or a file
+    let filePath;
+    const stat = await fs.stat(workflowPath);
+    if (stat.isDirectory()) {
+        filePath = path.join(workflowPath, "workflow.yml");
+    }
+    else {
+        filePath = workflowPath;
+    }
+    const raw = await fs.readFile(filePath, "utf-8");
+    const parsed = YAML.parse(raw);
+    if (!parsed?.id) {
+        throw new Error(`workflow.yml missing 'id' in ${filePath}`);
+    }
+    if (!Array.isArray(parsed.steps) || parsed.steps.length === 0) {
+        throw new Error(`workflow.yml missing 'steps' in ${filePath}`);
+    }
+    // Parse loop configs from raw YAML
+    for (const step of parsed.steps) {
+        const rawStep = step;
+        if (rawStep.type)
+            step.type = rawStep.type;
+        if (rawStep.loop)
+            step.loop = parseLoopConfig(rawStep.loop);
+    }
+    // Apply defaults
+    if (parsed.defaults) {
+        for (const step of parsed.steps) {
+            if (!step.executor && parsed.defaults.executor)
+                step.executor = parsed.defaults.executor;
+            if (!step.model && parsed.defaults.model)
+                step.model = parsed.defaults.model;
+            if (!step.timeout && parsed.defaults.timeout)
+                step.timeout = parsed.defaults.timeout;
+            if (step.max_retries === undefined && parsed.defaults.max_retries !== undefined) {
+                step.max_retries = parsed.defaults.max_retries;
+            }
+            if (!step.workdir && parsed.defaults.workdir)
+                step.workdir = parsed.defaults.workdir;
+        }
+    }
+    // Default executor to openclaw for backward compat
+    for (const step of parsed.steps) {
+        if (!step.executor)
+            step.executor = "openclaw";
+    }
+    validateSteps(parsed.steps);
+    return parsed;
+}
+function parseLoopConfig(raw) {
+    return {
+        over: raw.over,
+        completion: raw.completion,
+        freshSession: raw.fresh_session ?? raw.freshSession,
+        verifyEach: raw.verify_each ?? raw.verifyEach,
+        verifyStep: raw.verify_step ?? raw.verifyStep,
+    };
+}
+function validateSteps(steps) {
+    const ids = new Set();
+    for (const step of steps) {
+        if (!step.id?.trim()) {
+            throw new Error("Step missing 'id'");
+        }
+        if (ids.has(step.id)) {
+            throw new Error(`Duplicate step id "${step.id}"`);
+        }
+        ids.add(step.id);
+        if (!step.input?.trim() && step.executor !== "self") {
+            throw new Error(`Step "${step.id}" missing 'input'`);
+        }
+        // Validate loop config
+        if (step.type === "loop") {
+            if (!step.loop) {
+                throw new Error(`Step "${step.id}" has type=loop but no loop config`);
+            }
+            if (step.loop.over !== "stories") {
+                throw new Error(`Step "${step.id}" loop.over must be "stories"`);
+            }
+            if (step.loop.verifyEach && step.loop.verifyStep && !ids.has(step.loop.verifyStep)) {
+                // verifyStep might come later in the steps array — defer this check
+                // Actually it usually comes after, so we just skip validation here
+            }
+        }
+        // openclaw executor requires agent
+        if (step.executor === "openclaw" && !step.agent) {
+            throw new Error(`Step "${step.id}" uses openclaw executor but has no 'agent'`);
+        }
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/workflow/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/workflow/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,YAAoB;IACzD,sEAAsE;IACtE,IAAI,QAAgB,CAAC;IACrB,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACvB,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,YAAY,CAAC;IAC1B,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IAE/C,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,mCAAmC;IACnC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,IAAW,CAAC;QAC5B,IAAI,OAAO,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC3C,IAAI,OAAO,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,iBAAiB;IACjB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ;gBAAE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACzF,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK;gBAAE,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC7E,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO;gBAAE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrF,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBAChF,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;YACjD,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO;gBAAE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QACvF,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC;IACjD,CAAC;IAED,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,GAAQ;IAC/B,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,YAAY,EAAE,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,YAAY;QACnD,UAAU,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,UAAU;QAC7C,UAAU,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,UAAU;KAC9C,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAqB;IAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACpD,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEjB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,EAAE,mBAAmB,CAAC,CAAC;QACvD,CAAC;QAED,uBAAuB;QACvB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,EAAE,oCAAoC,CAAC,CAAC;YACxE,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,EAAE,+BAA+B,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBACnF,oEAAoE;gBACpE,mEAAmE;YACrE,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,IAAI,IAAI,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,EAAE,6CAA6C,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/workflow/template.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resolve {{key}} placeholders in a template against a context object.
+ * Case-insensitive key lookup.
+ */
+export declare function resolveTemplate(template: string, context: Record<string, string>): string;
+/**
+ * Extract KEY: value pairs from output text.
+ * Keys must be uppercase with optional underscores.
+ */
+export declare function extractContext(output: string): Record<string, string>;
+/**
+ * Parse STORIES_JSON from step output.
+ */
+export declare function parseStoriesJson(output: string): any[] | null;

package/dist/workflow/template.js

@@ -0,0 +1,71 @@
+/**
+ * Resolve {{key}} placeholders in a template against a context object.
+ * Case-insensitive key lookup.
+ */
+export function resolveTemplate(template, context) {
+    return template.replace(/\{\{(\w+(?:\.\w+)*)\}\}/g, (_match, key) => {
+        if (key in context)
+            return context[key];
+        const lower = key.toLowerCase();
+        if (lower in context)
+            return context[lower];
+        // Try uppercase
+        const upper = key.toUpperCase();
+        if (upper in context)
+            return context[upper];
+        return `[missing: ${key}]`;
+    });
+}
+/**
+ * Extract KEY: value pairs from output text.
+ * Keys must be uppercase with optional underscores.
+ */
+export function extractContext(output) {
+    const context = {};
+    for (const line of output.split("\n")) {
+        const match = line.match(/^([A-Z][A-Z0-9_]+):\s*(.+)$/);
+        if (match && !match[1].startsWith("STORIES_JSON")) {
+            context[match[1].toLowerCase()] = match[2].trim();
+        }
+    }
+    return context;
+}
+/**
+ * Parse STORIES_JSON from step output.
+ */
+export function parseStoriesJson(output) {
+    const lines = output.split("\n");
+    const startIdx = lines.findIndex((l) => l.startsWith("STORIES_JSON:"));
+    if (startIdx === -1)
+        return null;
+    const firstLine = lines[startIdx].slice("STORIES_JSON:".length).trim();
+    const jsonLines = [firstLine];
+    for (let i = startIdx + 1; i < lines.length; i++) {
+        if (/^[A-Z_]+:\s/.test(lines[i]))
+            break;
+        jsonLines.push(lines[i]);
+    }
+    const jsonText = jsonLines.join("\n").trim();
+    const stories = JSON.parse(jsonText);
+    if (!Array.isArray(stories)) {
+        throw new Error("STORIES_JSON must be an array");
+    }
+    if (stories.length > 30) {
+        throw new Error(`STORIES_JSON has ${stories.length} stories, max is 30`);
+    }
+    // Validate each story
+    const seenIds = new Set();
+    for (let i = 0; i < stories.length; i++) {
+        const s = stories[i];
+        const ac = s.acceptanceCriteria ?? s.acceptance_criteria;
+        if (!s.id || !s.title || !s.description || !Array.isArray(ac) || ac.length === 0) {
+            throw new Error(`Story at index ${i} missing required fields (id, title, description, acceptanceCriteria)`);
+        }
+        if (seenIds.has(s.id)) {
+            throw new Error(`Duplicate story id "${s.id}"`);
+        }
+        seenIds.add(s.id);
+    }
+    return stories;
+}
+//# sourceMappingURL=template.js.map

package/dist/workflow/template.js.map

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

package/dist/workflow/types.d.ts

@@ -0,0 +1,65 @@
+export type ExecutorType = "openclaw" | "claude-code" | "codex" | "self";
+export type LoopConfig = {
+    over: "stories";
+    completion: "all_done";
+    freshSession?: boolean;
+    verifyEach?: boolean;
+    verifyStep?: string;
+};
+export type StepFailure = {
+    retry_step?: string;
+    max_retries?: number;
+    escalate_to?: string;
+    on_exhausted?: {
+        escalate_to?: string;
+    };
+};
+export type WorkflowStep = {
+    id: string;
+    executor?: ExecutorType;
+    agent?: string;
+    model?: string;
+    workdir?: string;
+    type?: "single" | "loop";
+    loop?: LoopConfig;
+    input: string;
+    expects?: string;
+    timeout?: number;
+    max_retries?: number;
+    on_fail?: StepFailure;
+};
+export type AgentRole = "analysis" | "coding" | "verification" | "testing" | "pr" | "scanning";
+export type WorkflowAgent = {
+    id: string;
+    name?: string;
+    description?: string;
+    role?: AgentRole;
+    workspace: {
+        baseDir: string;
+        files: Record<string, string>;
+        skills?: string[];
+    };
+};
+export type WorkflowDefaults = {
+    executor?: ExecutorType;
+    model?: string;
+    timeout?: number;
+    max_retries?: number;
+    workdir?: string;
+};
+export type WorkflowSpec = {
+    id: string;
+    name?: string;
+    version?: number;
+    description?: string;
+    defaults?: WorkflowDefaults;
+    context?: Record<string, string>;
+    agents?: WorkflowAgent[];
+    steps: WorkflowStep[];
+};
+export interface CallbackConfig {
+    url: string;
+    method?: string;
+    headers?: Record<string, string>;
+    bodyTemplate?: Record<string, any>;
+}

package/dist/workflow/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/workflow/types.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@ghostwater/soulforge",
+  "version": "0.1.0",
+  "description": "Pluggable executor workflow engine for AI coding agents. Dispatch workflow steps to Claude Code, Codex CLI, or human review checkpoints.",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "bin": {
+    "soulforge": "dist/cli/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/cli/cli.js",
+    "dev": "tsc -p tsconfig.json --watch",
+    "start": "node dist/cli/cli.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "workflow",
+    "ai",
+    "coding-agent",
+    "claude-code",
+    "codex",
+    "executor",
+    "daemon",
+    "cli"
+  ],
+  "author": "Ghostwater Studio",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ghostwater-ai/soulforge.git"
+  },
+  "homepage": "https://github.com/ghostwater-ai/soulforge",
+  "files": [
+    "dist",
+    "workflows",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "yaml": "^2.4.5",
+    "typescript": "^5.9.3",
+    "@types/node": "^22.0.0"
+  }
+}