agentic-forge 0.0.0 → 0.7.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025-2026 Étienne St-Pierre
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025-2026 Étienne St-Pierre
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -45,24 +45,6 @@ pnpm install && pnpm build
 npm install -g .
 ```
 
-### Using Skills in Interactive Claude Sessions
-
-Agentic Forge bundles 13 skills that extend Claude Code with slash commands like `/sdlc-plan`, `/analyze`, `/git-commit`, and more. To make them available in interactive sessions:
-
-**Option 1: Pass `--add-dir` when launching Claude**
-
-```bash
-claude --add-dir $(agentic-forge skills-dir)
-```
-
-**Option 2: Add to `~/.claude/settings.json` permanently**
-
-```json
-{
-  "additionalDirectories": ["<output of agentic-forge skills-dir>"]
-}
-```
-
 ## Workflows
 
 ### plan-build-review (Full SDLC)
@@ -100,15 +82,43 @@ agentic-forge run analyze-codebase --var "autofix=true"
 ### All Commands
 
 ```bash
-# List available workflows
-agentic-forge workflows
-
 # Run a workflow with variables
 agentic-forge run <workflow> --var "key=value"
 
+# Resume a paused or failed workflow
+agentic-forge resume <workflow_id>
+
+# Check workflow status
+agentic-forge status <workflow_id>
+
+# Cancel a running workflow
+agentic-forge cancel <workflow_id>
+
+# List all workflow runs (optionally filter by status)
+agentic-forge list --status running
+
+# Provide input to a paused workflow waiting for human response
+agentic-forge input <workflow_id> "response text"
+
+# Copy bundled workflow templates to your project
+agentic-forge init
+
+# List available workflows with descriptions
+agentic-forge workflows
+
+# Get or set configuration
+agentic-forge config get <key>
+agentic-forge config set <key> <value>
+
+# Interactive configuration setup
+agentic-forge configure
+
 # Print path to bundled skills directory
 agentic-forge skills-dir
 
+# Show release notes
+agentic-forge release-notes --latest
+
 # Check current version
 agentic-forge version
 

package/dist/checkpoints/manager.d.ts

@@ -0,0 +1,5 @@
+/** Checkpoint management for workflow sessions. */
+export declare function getCheckpointPath(workflowId: string, repoRoot?: string): string;
+export declare function createCheckpoint(workflowId: string, step: string, context: string, progress: string, notes?: string, issues?: string, repoRoot?: string): string;
+export declare function readCheckpoints(workflowId: string, repoRoot?: string): Record<string, unknown>[];
+export declare function getLatestCheckpoint(workflowId: string, repoRoot?: string): Record<string, unknown> | null;

package/dist/checkpoints/manager.js

@@ -0,0 +1,87 @@
+/** Checkpoint management for workflow sessions. */
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import path from "node:path";
+import yaml from "js-yaml";
+// --- Path helper ---
+export function getCheckpointPath(workflowId, repoRoot) {
+    const root = repoRoot ?? process.cwd();
+    return path.join(root, "agentic", "outputs", workflowId, "checkpoint.md");
+}
+// --- Create checkpoint ---
+export function createCheckpoint(workflowId, step, context, progress, notes = "", issues = "", repoRoot) {
+    const checkpointPath = getCheckpointPath(workflowId, repoRoot);
+    const dir = path.dirname(checkpointPath);
+    mkdirSync(dir, { recursive: true });
+    const existing = readCheckpoints(workflowId, repoRoot);
+    const checkpointNum = existing.length + 1;
+    const checkpointId = `chk-${String(checkpointNum).padStart(3, "0")}`;
+    const timestamp = new Date().toISOString();
+    const frontmatter = {
+        checkpoint_id: checkpointId,
+        step,
+        created: timestamp,
+        workflow_id: workflowId,
+        status: "in_progress",
+    };
+    const entryLines = [
+        "---",
+        yaml.dump(frontmatter, { flowLevel: -1 }).trim(),
+        "---",
+        "",
+        "## Context",
+        "",
+        context,
+        "",
+        "## Progress",
+        "",
+        progress,
+        "",
+    ];
+    if (notes) {
+        entryLines.push("## Notes for Next Session", "", notes, "");
+    }
+    if (issues) {
+        entryLines.push("## Issues Discovered", "", issues, "");
+    }
+    entryLines.push("---\n");
+    const entry = entryLines.join("\n");
+    appendFileSync(checkpointPath, entry, "utf-8");
+    return checkpointId;
+}
+// --- Read checkpoints ---
+export function readCheckpoints(workflowId, repoRoot) {
+    const checkpointPath = getCheckpointPath(workflowId, repoRoot);
+    if (!existsSync(checkpointPath)) {
+        return [];
+    }
+    const content = readFileSync(checkpointPath, "utf-8");
+    const checkpoints = [];
+    const parts = content.split("---");
+    let i = 1;
+    while (i < parts.length - 1) {
+        const frontmatterStr = parts[i].trim();
+        if (!frontmatterStr) {
+            i += 1;
+            continue;
+        }
+        const body = i + 1 < parts.length ? parts[i + 1].trim() : "";
+        try {
+            const frontmatter = yaml.load(frontmatterStr);
+            if (frontmatter && "checkpoint_id" in frontmatter) {
+                frontmatter.content = body;
+                checkpoints.push(frontmatter);
+            }
+        }
+        catch {
+            // Invalid YAML, skip
+        }
+        i += 2;
+    }
+    return checkpoints;
+}
+// --- Get latest checkpoint ---
+export function getLatestCheckpoint(workflowId, repoRoot) {
+    const checkpoints = readCheckpoints(workflowId, repoRoot);
+    return checkpoints.length > 0 ? checkpoints[checkpoints.length - 1] : null;
+}
+//# sourceMappingURL=manager.js.map

package/dist/checkpoints/manager.js.map

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

package/{src → dist}/claude/.claude/skills/analyze/SKILL.md

@@ -24,7 +24,7 @@ Analyze codebase for issues across multiple domains: bugs, technical debt, docum
 
 ### Values
 
-\$ARGUMENTS
+Arguments: $ARGUMENTS
 
 ## Additional Resources
 

package/{src → dist}/claude/.claude/skills/create-checkpoint/SKILL.md

@@ -21,7 +21,7 @@ Record progress and provide context for future sessions or other agents. Use thi
 
 ### Values
 
-\$ARGUMENTS
+Arguments: $ARGUMENTS
 
 ## Core Principles
 

package/{src → dist}/claude/.claude/skills/create-log/SKILL.md

@@ -21,7 +21,7 @@ Add a structured log entry to the workflow's NDJSON log file. Use this skill for
 
 ### Values
 
-\$ARGUMENTS
+Arguments: $ARGUMENTS
 
 ## Core Principles
 

package/{src → dist}/claude/.claude/skills/fix-analyze/SKILL.md

@@ -20,7 +20,7 @@ Iteratively fix issues identified in an analysis document. This skill reads the
 
 ### Values
 
-\$ARGUMENTS
+Arguments: $ARGUMENTS
 
 ## Core Principles
 

package/{src → dist}/claude/.claude/skills/git-branch/SKILL.md

@@ -20,7 +20,7 @@ Create and checkout a new git branch following the naming convention: `<category
 
 ### Values
 
-\$ARGUMENTS
+Arguments: $ARGUMENTS
 
 ## Core Principles
 

package/{src → dist}/claude/.claude/skills/git-commit/SKILL.md

@@ -20,7 +20,7 @@ Create a well-structured commit with a concise title and optional bullet-point d
 
 ### Values
 
-\$ARGUMENTS
+Arguments: $ARGUMENTS
 
 ## Core Principles
 

package/{src → dist}/claude/.claude/skills/git-pr/SKILL.md

@@ -21,7 +21,7 @@ Create a pull request using the GitHub CLI with a descriptive title and appropri
 
 ### Values
 
-\$ARGUMENTS
+Arguments: $ARGUMENTS
 
 ## Core Principles
 

package/{src → dist}/claude/.claude/skills/sdlc-plan/SKILL.md

@@ -22,7 +22,7 @@ Create a structured implementation plan for the given task. This skill analyzes
 
 ### Values
 
-\$ARGUMENTS
+Arguments: $ARGUMENTS
 
 ## Additional Resources
 

package/{src → dist}/claude/.claude/skills/sdlc-review/SKILL.md

@@ -21,7 +21,7 @@ Review the implementation against quality standards and optionally against a pla
 
 ### Values
 
-\$ARGUMENTS
+Arguments: $ARGUMENTS
 
 ## Core Principles
 

package/{src → dist}/claude/.claude/skills/workflow-builder/SKILL.md

@@ -19,7 +19,7 @@ Create, update, explain, validate, and debug agentic-forge YAML workflows. This
 
 ### Values
 
-\$ARGUMENTS
+Arguments: $ARGUMENTS
 
 ## Additional Resources
 

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+/** CLI entry point for agentic-forge command. */
+export {};

package/dist/cli.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+/** CLI entry point for agentic-forge command. */
+import { Command } from "commander";
+function optString(val) {
+    return typeof val === "string" ? val : undefined;
+}
+function optBool(val) {
+    return typeof val === "boolean" ? val : undefined;
+}
+function optStringArray(val) {
+    return Array.isArray(val) && val.every((v) => typeof v === "string") ? val : undefined;
+}
+import { cmdCancel, cmdConfig, cmdConfigure, cmdInit, cmdInput, cmdList, cmdReleaseNotes, cmdResume, cmdRun, cmdSkillsDir, cmdStatus, cmdUpdate, cmdVersion, cmdWorkflows, getVersion, } from "./commands/index.js";
+const program = new Command()
+    .name("agentic-forge")
+    .version(getVersion())
+    .description("Agentic workflow orchestration for Claude Code");
+// run command
+program
+    .command("run")
+    .argument("[workflow]", "workflow name or path to YAML file")
+    .option("--list", "list all available workflows")
+    .option("--var <key=value...>", "set workflow variable (can be used multiple times)")
+    .option("--from-step <step>", "resume from a specific step")
+    .option("--terminal-output <mode>", "terminal output granularity (base or all)")
+    .action(async (workflow, opts) => {
+    await cmdRun({
+        workflow,
+        listWorkflows: optBool(opts.list),
+        vars: optStringArray(opts.var),
+        fromStep: optString(opts.fromStep),
+        terminalOutput: optString(opts.terminalOutput),
+    });
+});
+// resume command
+program
+    .command("resume")
+    .argument("<workflow_id>", "workflow ID to resume")
+    .option("--terminal-output <mode>", "terminal output granularity (base or all)")
+    .action(async (workflowId, opts) => {
+    await cmdResume({
+        workflowId,
+        terminalOutput: optString(opts.terminalOutput),
+    });
+});
+// status command
+program
+    .command("status")
+    .argument("<workflow_id>", "workflow ID")
+    .action((workflowId) => {
+    cmdStatus(workflowId);
+});
+// cancel command
+program
+    .command("cancel")
+    .argument("<workflow_id>", "workflow ID to cancel")
+    .action((workflowId) => {
+    cmdCancel(workflowId);
+});
+// list command
+program
+    .command("list")
+    .option("--status <status>", "filter by status (running, completed, failed, paused)")
+    .action((opts) => {
+    cmdList(optString(opts.status));
+});
+// input command
+program
+    .command("input")
+    .argument("<workflow_id>", "workflow ID")
+    .argument("<response>", "response to provide")
+    .action((workflowId, response) => {
+    cmdInput(workflowId, response);
+});
+// configure command
+program
+    .command("configure")
+    .description("Configure plugin settings")
+    .action(() => {
+    cmdConfigure();
+});
+// init command
+program
+    .command("init")
+    .description("Copy bundled workflow templates to local project")
+    .option("--force", "overwrite existing workflow files")
+    .option("--list", "list available bundled workflows without copying")
+    .action((opts) => {
+    cmdInit({
+        force: optBool(opts.force),
+        listOnly: optBool(opts.list),
+    });
+});
+// config command with subcommands
+const configCmd = program.command("config").description("Get or set configuration");
+configCmd
+    .command("get")
+    .argument("<key>", "configuration key (dot notation)")
+    .action((key) => {
+    cmdConfig("get", key);
+});
+configCmd
+    .command("set")
+    .argument("<key>", "configuration key (dot notation)")
+    .argument("<value>", "value to set")
+    .action((key, value) => {
+    cmdConfig("set", key, value);
+});
+// version command
+program
+    .command("version")
+    .description("Show version information")
+    .action(() => {
+    cmdVersion();
+});
+// release-notes command
+program
+    .command("release-notes")
+    .argument("[version]", "show release notes for a specific version")
+    .option("--latest", "show only the most recent version's release notes")
+    .action((specificVersion, opts) => {
+    cmdReleaseNotes({
+        specificVersion,
+        latest: optBool(opts.latest),
+    });
+});
+// skills-dir command
+program
+    .command("skills-dir")
+    .description("Print path to bundled skills directory")
+    .action(() => {
+    cmdSkillsDir();
+});
+// update command
+program
+    .command("update")
+    .description("Update agentic-forge to the latest version")
+    .option("--check", "check for updates without installing")
+    .action((opts) => {
+    cmdUpdate({
+        check: optBool(opts.check),
+    });
+});
+// workflows command
+program
+    .command("workflows")
+    .description("List available workflows with descriptions")
+    .option("-v, --verbose", "show workflow variables and full descriptions")
+    .action((opts) => {
+    cmdWorkflows({
+        verbose: optBool(opts.verbose),
+    });
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/config-cmd.d.ts

@@ -0,0 +1,2 @@
+/** Config command handler. */
+export declare function cmdConfig(configCommand: string, key: string, value?: string): void;

package/dist/commands/config-cmd.js

@@ -0,0 +1,30 @@
+/** Config command handler. */
+import { getConfigValue, setConfigValue } from "../config.js";
+export function cmdConfig(configCommand, key, value) {
+    if (configCommand === "get") {
+        const result = getConfigValue(key);
+        if (result === null) {
+            process.stderr.write(`Key not found: ${key}\n`);
+            process.exit(1);
+        }
+        if (typeof result === "object" && result !== null) {
+            process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        }
+        else {
+            process.stdout.write(`${result}\n`);
+        }
+    }
+    else if (configCommand === "set") {
+        if (value === undefined) {
+            process.stderr.write("Usage: agentic-forge config set <key> <value>\n");
+            process.exit(1);
+        }
+        setConfigValue(key, value);
+        process.stdout.write(`Set ${key} = ${value}\n`);
+    }
+    else {
+        process.stderr.write("Usage: agentic-forge config get|set <key> [value]\n");
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=config-cmd.js.map

package/dist/commands/config-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-cmd.js","sourceRoot":"","sources":["../../src/commands/config-cmd.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,UAAU,SAAS,CAAC,aAAqB,EAAE,GAAW,EAAE,KAAc;IAC3E,IAAI,aAAa,KAAK,KAAK,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC;QACrC,CAAC;IACF,CAAC;SAAM,IAAI,aAAa,KAAK,KAAK,EAAE,CAAC;QACpC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;QACD,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;AACF,CAAC"}

package/{src/commands/index.ts → dist/commands/index.d.ts}

@@ -1,14 +1,5 @@
 /** Command handler exports. */
-
-export {
-	cmdRun,
-	discoverWorkflow,
-	listAvailableWorkflows,
-	resolveWorkflowPath,
-	getBundledWorkflowsDir,
-	getUserWorkflowsDir,
-	getProjectWorkflowsDir,
-} from "./run.js";
+export { cmdRun, discoverWorkflow, listAvailableWorkflows, resolveWorkflowPath, getBundledWorkflowsDir, getUserWorkflowsDir, getProjectWorkflowsDir, } from "./run.js";
 export { cmdResume } from "./resume.js";
 export { cmdStatus, cmdCancel, cmdList } from "./status.js";
 export { cmdInit, cmdConfigure } from "./init.js";

package/dist/commands/index.js

@@ -0,0 +1,13 @@
+/** Command handler exports. */
+export { cmdRun, discoverWorkflow, listAvailableWorkflows, resolveWorkflowPath, getBundledWorkflowsDir, getUserWorkflowsDir, getProjectWorkflowsDir, } from "./run.js";
+export { cmdResume } from "./resume.js";
+export { cmdStatus, cmdCancel, cmdList } from "./status.js";
+export { cmdInit, cmdConfigure } from "./init.js";
+export { cmdConfig } from "./config-cmd.js";
+export { cmdVersion, getVersion } from "./version.js";
+export { cmdUpdate } from "./update.js";
+export { cmdReleaseNotes } from "./release-notes.js";
+export { cmdSkillsDir } from "./skills-dir.js";
+export { cmdWorkflows } from "./workflows.js";
+export { cmdInput } from "./shortcuts.js";
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,EACN,MAAM,EACN,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,6 @@
+/** Init and configure command handlers. */
+export declare function cmdInit(options: {
+    force?: boolean;
+    listOnly?: boolean;
+}): void;
+export declare function cmdConfigure(): void;

package/dist/commands/init.js

@@ -0,0 +1,83 @@
+/** Init and configure command handlers. */
+import { copyFileSync, existsSync, mkdirSync, readdirSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { getDefaultConfig, loadConfig } from "../config.js";
+import { getBundledWorkflowsDir } from "./run.js";
+export function cmdInit(options) {
+    const bundledDir = getBundledWorkflowsDir();
+    if (!existsSync(bundledDir)) {
+        process.stderr.write("Error: Bundled workflows directory not found.\n");
+        process.exit(1);
+    }
+    const bundledWorkflows = readdirSync(bundledDir)
+        .filter((f) => f.endsWith(".yaml"))
+        .sort();
+    if (bundledWorkflows.length === 0) {
+        process.stderr.write("No bundled workflows found.\n");
+        process.exit(1);
+    }
+    // List only mode
+    if (options.listOnly) {
+        process.stdout.write("Available bundled workflows:\n\n");
+        for (const wf of bundledWorkflows) {
+            process.stdout.write(`  ${wf}\n`);
+        }
+        process.stdout.write("\nUse 'agentic-forge init' to copy these to agentic/workflows/\n");
+        return;
+    }
+    // Copy workflows to local directory
+    const targetDir = path.join(process.cwd(), "agentic", "workflows");
+    mkdirSync(targetDir, { recursive: true });
+    const copied = [];
+    const skipped = [];
+    for (const wf of bundledWorkflows) {
+        const targetPath = path.join(targetDir, wf);
+        if (existsSync(targetPath) && !options.force) {
+            skipped.push(wf);
+        }
+        else {
+            copyFileSync(path.join(bundledDir, wf), targetPath);
+            copied.push(wf);
+        }
+    }
+    if (copied.length > 0) {
+        process.stdout.write(`Copied ${copied.length} workflow(s) to ${targetDir}/\n`);
+        for (const name of copied) {
+            process.stdout.write(`  + ${name}\n`);
+        }
+    }
+    if (skipped.length > 0) {
+        process.stdout.write(`\nSkipped ${skipped.length} existing workflow(s):\n`);
+        for (const name of skipped) {
+            process.stdout.write(`  - ${name}\n`);
+        }
+        process.stdout.write("\nUse --force to overwrite existing files.\n");
+    }
+    // Create config.json next to workflows
+    initConfig(path.join(process.cwd(), "agentic"), options.force ?? false);
+    if (copied.length > 0) {
+        process.stdout.write("\nYou can now run workflows with:\n");
+        process.stdout.write("  agentic-forge run agentic/workflows/<workflow>.yaml\n");
+    }
+}
+function initConfig(agenticDir, force) {
+    const configPath = path.join(agenticDir, "config.json");
+    if (existsSync(configPath) && !force) {
+        process.stdout.write(`\nConfig already exists: ${configPath}\n`);
+        return;
+    }
+    mkdirSync(agenticDir, { recursive: true });
+    const config = getDefaultConfig();
+    writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
+    process.stdout.write(`\nCreated config: ${configPath}\n`);
+}
+export function cmdConfigure() {
+    const config = loadConfig();
+    process.stdout.write("Agentic Workflows Configuration\n");
+    process.stdout.write(`${"=".repeat(40)}\n`);
+    process.stdout.write("\nCurrent settings:\n");
+    process.stdout.write(`${JSON.stringify(config, null, 2)}\n`);
+    process.stdout.write("\nUse 'agentic-forge config set <key> <value>' to modify settings.\n");
+    process.stdout.write("Example: agentic-forge config set defaults.maxRetry 5\n");
+}
+//# sourceMappingURL=init.js.map