agentic-forge 0.0.0 → 0.7.1

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,46 @@ 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"
 
-# Print path to bundled skills directory
+# 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 workflow skills directory
 agentic-forge skills-dir
 
+# Print path to interactive authoring skills directory
+agentic-forge authoring-dir
+
+# Show release notes
+agentic-forge release-notes --latest
+
 # Check current version
 agentic-forge version
 
@@ -121,8 +134,10 @@ agentic-forge update
 ```text
 src/
   agents/              # Bundled agent definitions (explorer, reviewer)
-  claude/.claude/      # Skills loaded via --add-dir
-    skills/            # 13 bundled skills
+  authoring/.claude/   # Interactive authoring skills (workflow-builder)
+    skills/            # Skills for users to create and manage workflows
+  claude/.claude/      # Workflow execution skills loaded via --add-dir
+    skills/            # Bundled skills used by workflows
   commands/            # CLI command implementations
   prompts/             # System prompt templates
   steps/               # Workflow step handlers
@@ -131,6 +146,31 @@ src/
 tests/                 # Vitest test suite
 ```
 
+### Skills directories
+
+Agentic Forge separates skills into two directories:
+
+- **Workflow skills** (`skills-dir`) — Skills used by the workflow engine during execution. Loaded automatically when running workflows.
+- **Authoring skills** (`authoring-dir`) — Interactive skills for users to create and manage workflows. Add them to your Claude Code session manually:
+
+```bash
+claude --add-dir $(agentic-forge authoring-dir)
+```
+
+#### Using the workflow-builder skill
+
+Once the authoring skills are loaded, use the `/af-workflow-builder` slash command to create, update, explain, validate, or debug workflows:
+
+```text
+/af-workflow-builder create a workflow that plans and reviews a feature
+/af-workflow-builder validate my-workflow.yaml
+/af-workflow-builder explain how ralph-loop works
+/af-workflow-builder update my-workflow.yaml to add a parallel step
+/af-workflow-builder debug why my conditional always takes the else branch
+```
+
+The skill has full knowledge of the workflow schema, all step types, and bundled skills.
+
 ## Contributing
 
 - **Bug reports and suggestions** - [Open an issue](https://github.com/e-stpierre/agentic-forge/issues) on GitHub

package/{src/claude → dist/authoring}/.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
 
@@ -114,7 +114,7 @@ Priority: step `model` > `settings.model` > config default > `sonnet`
 
 | Symptom                                | Likely Cause                                   | Fix                                                              |
 | -------------------------------------- | ---------------------------------------------- | ---------------------------------------------------------------- |
-| "Missing required variable"            | Variable not passed via `--var`                | Add `--var "name=value"` to CLI or set `default`                 |
+| "Missing required variable"            | Variable not passed via CLI                    | Add `name=value` arg, `--var "name=value"`, or set `default`     |
 | Conditional always takes else          | Condition expression evaluates to falsy        | Check Jinja2 expression syntax and variable names                |
 | Ralph loop never completes             | Completion JSON not output or promise mismatch | Verify `completion-promise` matches the `promise` field in JSON  |
 | Template variable shows as `{{ ... }}` | Undefined variable in lenient mode             | Define the variable or enable `strict-mode: true` to catch early |

package/{src/claude → dist/authoring}/.claude/skills/workflow-builder/references/REFERENCE.md

@@ -57,7 +57,7 @@ settings:
 
 ## Variables
 
-Define input parameters for the workflow. Passed via `--var "name=value"` on the CLI.
+Define input parameters for the workflow. Passed as bare `key=value` args or via `--var "name=value"` on the CLI. Missing required variables are prompted interactively when running in a TTY (disable with `--no-interactive`).
 
 | Key           | Required | Type   | Default    | Description                           |
 | ------------- | -------- | ------ | ---------- | ------------------------------------- |
@@ -398,8 +398,8 @@ outputs:
 ## CLI Commands
 
 ```bash
-# Run a workflow
-agentic-forge run <workflow-name-or-path> --var "key=value" [--from-step <name>] [--terminal-output base|all]
+# Run a workflow (bare key=value args or --var flag)
+agentic-forge run <workflow> key=value [key=value ...] [--var "key=value"] [--from-step <name>] [--no-interactive] [--terminal-output base|all]
 
 # Resume a paused/failed workflow
 agentic-forge resume <workflow-id>
@@ -422,6 +422,12 @@ agentic-forge workflows [-v]
 # Copy bundled workflows to local project
 agentic-forge init [--force] [--list]
 
+# Print path to bundled workflow skills directory
+agentic-forge skills-dir
+
+# Print path to interactive authoring skills directory
+agentic-forge authoring-dir
+
 # Configuration
 agentic-forge config get <key>
 agentic-forge config set <key> <value>

package/{src/claude → dist/authoring}/.claude/skills/workflow-builder/references/workflow-example.yaml

@@ -354,24 +354,31 @@ outputs:
 
 # ==================== USAGE EXAMPLES ====================
 #
-# Run with required variable:
+# Run with bare key=value args (preferred):
+#   agentic-forge run workflow-example.yaml task="Add user authentication"
+#
+# Run with --var flag (equivalent):
 #   agentic-forge run workflow-example.yaml --var "task=Add user authentication"
 #
-# Run with custom variables:
+# Run with multiple variables:
 #   agentic-forge run workflow-example.yaml \
-#     --var "task=Fix login bug" \
-#     --var "plan_type=bug" \
-#     --var "create_pr=true" \
-#     --var "max_iterations=15"
+#     task="Fix login bug" \
+#     plan_type=bug \
+#     create_pr=true \
+#     max_iterations=15
 #
 # Run with verbose output:
 #   agentic-forge run workflow-example.yaml \
-#     --var "task=Implement feature" \
+#     task="Implement feature" \
 #     --terminal-output all
 #
+# Disable interactive prompts (for CI/scripts):
+#   agentic-forge run workflow-example.yaml --no-interactive \
+#     task="Implement feature"
+#
 # Resume from specific step:
 #   agentic-forge run workflow-example.yaml \
-#     --var "task=Implement feature" \
+#     task="Implement feature" \
 #     --from-step review-implementation
 #
 # Provide human input:

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":"AAAA,mDAAmD;AAEnD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,sBAAsB;AAEtB,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,QAAiB;IACtE,MAAM,IAAI,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;AAC3E,CAAC;AAED,4BAA4B;AAE5B,MAAM,UAAU,gBAAgB,CAC/B,UAAkB,EAClB,IAAY,EACZ,OAAe,EACf,QAAgB,EAChB,KAAK,GAAG,EAAE,EACV,MAAM,GAAG,EAAE,EACX,QAAiB;IAEjB,MAAM,cAAc,GAAG,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpC,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAErE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,MAAM,WAAW,GAA4B;QAC5C,aAAa,EAAE,YAAY;QAC3B,IAAI;QACJ,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,UAAU;QACvB,MAAM,EAAE,aAAa;KACrB,CAAC;IAEF,MAAM,UAAU,GAAa;QAC5B,KAAK;QACL,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE;QAChD,KAAK;QACL,EAAE;QACF,YAAY;QACZ,EAAE;QACF,OAAO;QACP,EAAE;QACF,aAAa;QACb,EAAE;QACF,QAAQ;QACR,EAAE;KACF,CAAC;IAEF,IAAI,KAAK,EAAE,CAAC;QACX,UAAU,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACZ,UAAU,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEpC,cAAc,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAE/C,OAAO,YAAY,CAAC;AACrB,CAAC;AAED,2BAA2B;AAE3B,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,QAAiB;IACpE,MAAM,cAAc,GAAG,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE/D,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACtD,MAAM,WAAW,GAA8B,EAAE,CAAC;IAElD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEnC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEvC,IAAI,CAAC,cAAc,EAAE,CAAC;YACrB,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACV,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE7D,IAAI,CAAC;YACJ,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAmC,CAAC;YAChF,IAAI,WAAW,IAAI,eAAe,IAAI,WAAW,EAAE,CAAC;gBACnD,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;gBAC3B,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC/B,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,qBAAqB;QACtB,CAAC;QAED,CAAC,IAAI,CAAC,CAAC;IACR,CAAC;IAED,OAAO,WAAW,CAAC;AACpB,CAAC;AAED,gCAAgC;AAEhC,MAAM,UAAU,mBAAmB,CAClC,UAAkB,EAClB,QAAiB;IAEjB,MAAM,WAAW,GAAG,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC1D,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5E,CAAC"}

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/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,173 @@
+#!/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 { CliExitError, cmdAuthoringDir, 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")
+    .description("Run a workflow with optional key=value variables (prompts for missing required vars)")
+    .argument("[workflow]", "workflow name or path to YAML file")
+    .argument("[vars...]", "workflow variables as key=value pairs")
+    .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("--no-interactive", "disable interactive prompts for missing variables")
+    .option("--terminal-output <mode>", "terminal output granularity (base or all)")
+    .action(async (workflow, vars, opts) => {
+    await cmdRun({
+        workflow,
+        listWorkflows: optBool(opts.list),
+        vars: optStringArray(opts.var),
+        bareVars: optStringArray(vars),
+        fromStep: optString(opts.fromStep),
+        interactive: opts.interactive !== false,
+        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();
+});
+// authoring-dir command
+program
+    .command("authoring-dir")
+    .description("Print path to interactive authoring skills directory")
+    .action(() => {
+    cmdAuthoringDir();
+});
+// 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.parseAsync().catch((err) => {
+    if (err instanceof CliExitError) {
+        process.stderr.write(`${err.message}\n`);
+        process.exit(err.exitCode);
+    }
+    throw err;
+});
+//# 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/authoring-dir.d.ts

@@ -0,0 +1,2 @@
+/** Authoring-dir command handler. */
+export declare function cmdAuthoringDir(): void;

package/dist/commands/authoring-dir.js

@@ -0,0 +1,9 @@
+/** Authoring-dir command handler. */
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export function cmdAuthoringDir() {
+    const authoringDir = path.resolve(path.join(__dirname, "..", "authoring"));
+    process.stdout.write(`${authoringDir}\n`);
+}
+//# sourceMappingURL=authoring-dir.js.map

package/dist/commands/authoring-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-dir.js","sourceRoot":"","sources":["../../src/commands/authoring-dir.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,UAAU,eAAe;IAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;IAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,IAAI,CAAC,CAAC;AAC3C,CAAC"}

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;