agentic-forge 0.7.0 → 0.8.0

package/README.md

@@ -35,111 +35,51 @@ Agentic Forge is a TypeScript/Node.js package that provides YAML-based workflow
 ### Installation
 
 ```bash
-# Install globally with npm
 npm install -g agentic-forge
-
-# Or install from source
-git clone https://github.com/e-stpierre/agentic-forge.git
-cd agentic-forge
-pnpm install && pnpm build
-npm install -g .
 ```
 
-## Workflows
-
-### plan-build-review (Full SDLC)
+### Run Your First Workflow
 
-Plan -> Create Branch -> Implement (iterative) -> Review -> Fix Issues -> Create PR
+No setup required. Run the demo workflow to verify your installation:
 
 ```bash
-agentic-forge run plan-build-review --var "task=Add dark mode support"
+af run demo
 ```
 
-### one-shot (Single Task)
-
-Create Branch -> Execute Task -> Review -> Create PR
+Run a real workflow:
 
 ```bash
-agentic-forge run one-shot --var "task=Add user authentication"
+af run plan-build-review --var "task=Add dark mode support" --slug "dark-mode"
 ```
 
-### ralph-loop (Iterative Execution)
+The `--slug` flag names the output directory (e.g., `dark-mode/` instead of a generated timestamp ID), making it easy to find results later.
 
-Generic iterative loop where each iteration runs in a fresh session.
+### Project Setup
+
+Initialize a local `agentic/` directory to customize workflows and config for your project:
 
 ```bash
-agentic-forge run ralph-loop --var "task=Follow the improvement plan" --var "max_iterations=20"
+af init --local
 ```
 
-### analyze-codebase (Parallel Analysis)
+### Workflow Builder
 
-Run 5 parallel analysis types (bug, debt, doc, security, style) with optional autofix.
+Load authoring skills into Claude Code to create and manage workflows interactively:
 
 ```bash
-agentic-forge run analyze-codebase --var "autofix=true"
+claude --add-dir $(af authoring-dir)
 ```
 
-### All Commands
-
-```bash
-# 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
+Then use `/af-workflow-builder` to create, validate, explain, or debug workflows.
 
-# Provide input to a paused workflow waiting for human response
-agentic-forge input <workflow_id> "response text"
+## Documentation
 
-# 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
-
-# Update to latest version
-agentic-forge update
-```
-
-## Repository Structure
-
-```text
-src/
-  agents/              # Bundled agent definitions (explorer, reviewer)
-  claude/.claude/      # Skills loaded via --add-dir
-    skills/            # 13 bundled skills
-  commands/            # CLI command implementations
-  prompts/             # System prompt templates
-  steps/               # Workflow step handlers
-  workflows/           # 7 bundled YAML workflow definitions
-  *.ts                 # Core TypeScript modules
-tests/                 # Vitest test suite
-```
+| Document                                                                                         | Description                                                                |
+| ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
+| [Getting Started](https://github.com/e-stpierre/agentic-forge/blob/main/docs/getting-started.md) | Installation, quick tour, initialization, and creating your first workflow |
+| [CLI Reference](https://github.com/e-stpierre/agentic-forge/blob/main/docs/cli.md)               | Complete list of commands with all arguments and options                   |
+| [Workflows](https://github.com/e-stpierre/agentic-forge/blob/main/docs/workflows.md)             | Bundled workflows, their use cases, variables, and examples                |
+| [Configuration](https://github.com/e-stpierre/agentic-forge/blob/main/docs/configuration.md)     | All configuration options, defaults, and layering behavior                 |
 
 ## Contributing
 

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

@@ -76,7 +76,7 @@ Arguments: $ARGUMENTS
 
 1. Read the workflow YAML and any error output
 2. Check for common issues (undefined variables, incorrect conditions, missing fields)
-3. Check `agentic/outputs/<workflow-id>/progress.json` if available
+3. Check `agentic-forge status <workflow-id>` or look in the output directory for `progress.json`
 4. Suggest specific fixes
 
 ### Step Type Selection Guide
@@ -114,8 +114,8 @@ 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`                 |
-| Conditional always takes else          | Condition expression evaluates to falsy        | Check Jinja2 expression syntax and variable names                |
+| "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 Nunjucks 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 |
 | Step timeout                           | Task exceeds `timeout-minutes`                 | Increase step or workflow `timeout-minutes`                      |

package/dist/{claude → 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                           |
 | ------------- | -------- | ------ | ---------- | ------------------------------------- |
@@ -204,15 +204,15 @@ Execute nested steps concurrently. Supports git worktrees for isolation.
 
 ### conditional
 
-Branch execution based on a Jinja2 condition expression.
+Branch execution based on a Nunjucks condition expression.
 
 **Specific properties:**
 
-| Key         | Type   | Required | Description                                |
-| ----------- | ------ | -------- | ------------------------------------------ |
-| `condition` | string | Yes      | Jinja2 expression evaluating to true/false |
-| `then`      | list   | Yes      | Steps to execute if condition is true      |
-| `else`      | list   | No       | Steps to execute if condition is false     |
+| Key         | Type   | Required | Description                                  |
+| ----------- | ------ | -------- | -------------------------------------------- |
+| `condition` | string | Yes      | Nunjucks expression evaluating to true/false |
+| `then`      | list   | Yes      | Steps to execute if condition is true        |
+| `else`      | list   | No       | Steps to execute if condition is false       |
 
 **Condition evaluation supports:**
 
@@ -252,7 +252,7 @@ Iterative prompt execution with completion detection. Each iteration runs in a f
 **How it works:**
 
 1. Each iteration runs in a fresh Claude session (no context accumulation)
-2. State persists in `agentic/outputs/{workflow-id}/ralph-{step-name}.md`
+2. State persists in `{output_dir}/ralph-{step-name}.md`
 3. Loop exits when Claude outputs completion JSON or max iterations reached
 4. Additional template variables: `{{ iteration }}` (current), `{{ max_iterations }}` (max)
 
@@ -274,7 +274,7 @@ The `completion-promise` setting must match the `promise` value in Claude's JSON
 - name: implement-milestones
   type: ralph-loop
   prompt: |
-    Read the plan at agentic/outputs/{{ workflow_id }}/plan.md.
+    Read the plan at {{ output_dir }}/plan.md.
     Implement the next incomplete milestone.
 
     When ALL milestones are complete, output:
@@ -307,7 +307,7 @@ Human provides input via: `agentic-forge input <workflow-id> "response"`
 - name: get-approval
   type: wait-for-human
   message: |
-    Review the implementation at agentic/outputs/{{ workflow_id }}/plan.md.
+    Review the implementation at {{ output_dir }}/plan.md.
     Respond with "approved" to continue or provide feedback.
   polling-interval: 30
   on-timeout: abort
@@ -316,7 +316,7 @@ Human provides input via: `agentic-forge input <workflow-id> "response"`
 
 ## Templating
 
-Workflows use Jinja2 for dynamic content in prompts, conditions, and output paths.
+Workflows use Nunjucks for dynamic content in prompts, conditions, and output paths.
 
 ### Built-in Variables
 
@@ -329,7 +329,7 @@ Workflows use Jinja2 for dynamic content in prompts, conditions, and output path
 | `{{ iteration }}`              | Current ralph-loop iteration (1-based) |
 | `{{ max_iterations }}`         | Max iterations for ralph-loop          |
 
-### Jinja2 Filters
+### Nunjucks Filters
 
 | Filter             | Example                                         | Description         |
 | ------------------ | ----------------------------------------------- | ------------------- |
@@ -371,7 +371,7 @@ Generate files when the workflow completes or fails.
 | Key        | Required | Type   | Default       | Description                           |
 | ---------- | -------- | ------ | ------------- | ------------------------------------- |
 | `name`     | Yes      | string | -             | Output identifier                     |
-| `template` | Yes      | string | -             | Jinja2 template file path             |
+| `template` | Yes      | string | -             | Nunjucks template file path           |
 | `path`     | Yes      | string | -             | Output file path (supports templates) |
 | `when`     | No       | string | `"completed"` | "completed" or "failed"               |
 
@@ -381,25 +381,27 @@ Template resolution order:
 2. `agentic/templates/`
 3. Bundled plugin templates
 
+Step prompt template variables: `{{ workflow_id }}`, `{{ output_dir }}` (absolute path to the workflow output directory), `{{ variables.* }}`, `{{ outputs.* }}`
+
 Template context variables: `workflow`, `variables`, `outputs`, `progress`, `steps`, `analysis_steps`, `fix_steps`, `files_changed`, `branches`, `pull_requests`, `inputs`
 
 ```yaml
 outputs:
   - name: report
     template: report.md.j2
-    path: agentic/outputs/{{ workflow_id }}/report.md
+    path: report.md
     when: completed
   - name: error-log
     template: error.md.j2
-    path: agentic/outputs/{{ workflow_id }}/error.md
+    path: error.md
     when: failed
 ```
 
 ## 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 +424,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/dist/{claude → authoring}/.claude/skills/workflow-builder/references/workflow-example.yaml

@@ -15,7 +15,7 @@ description: |
   - Git integration with worktrees
   - Error handling and retries
   - Checkpoints and progress tracking
-  - Variable templating with Jinja2
+  - Variable templating with Nunjucks
   - Output generation
 
 # Optional: Workflow-level settings
@@ -142,7 +142,7 @@ steps:
   # to avoid conflicts with skills from other plugins or built-in commands.
   - name: generate-plan
     type: prompt
-    prompt: /sdlc-plan --type {{ variables.plan_type }} --output_dir "agentic/outputs/{{ workflow_id }}" {{ variables.task }}
+    prompt: /sdlc-plan --type {{ variables.plan_type }} --output_dir "{{ output_dir }}" {{ variables.task }}
     checkpoint: true
     timeout-minutes: 20
 
@@ -213,7 +213,7 @@ steps:
     prompt: |
       ## Ralph Loop Iteration
 
-      Read the implementation plan at agentic/outputs/{{ workflow_id }}/plan.md
+      Read the implementation plan at {{ output_dir }}/plan.md
 
       Implement the NEXT INCOMPLETE milestone:
       1. Read the plan and identify the next incomplete milestone
@@ -229,7 +229,7 @@ steps:
 
       Do NOT output the completion JSON until every milestone is genuinely finished.
 
-      Current iteration state is tracked in agentic/outputs/{{ workflow_id }}/ralph-implement-incrementally.md
+      Current iteration state is tracked in {{ output_dir }}/ralph-implement-incrementally.md
 
     # Maximum iterations before stopping (can use variable)
     max-iterations: "{{ variables.max_iterations }}"
@@ -249,15 +249,15 @@ steps:
   # ==================== REVIEW STEP ====================
   - name: review-implementation
     type: prompt
-    prompt: /sdlc-review "agentic/outputs/{{ workflow_id }}/plan.md" minor
+    prompt: /sdlc-review "{{ output_dir }}/plan.md" minor
     checkpoint: true
 
   # ==================== CONDITIONAL STEP ====================
-  # Execute steps based on Jinja2 condition
+  # Execute steps based on Nunjucks condition
   - name: fix-validation-issues
     type: conditional
 
-    # Jinja2 expression that evaluates to true/false
+    # Nunjucks expression that evaluates to true/false
     # This checks if there are any issues with severity >= fix_severity
     condition: "{{ outputs.review_implementation.issues | selectattr('severity', 'ge', variables.fix_severity) | list | length > 0 }}"
 
@@ -295,7 +295,7 @@ steps:
       Please review the implementation and validation results.
 
       Review the following:
-      - Implementation plan: agentic/outputs/{{ workflow_id }}/plan.md
+      - Implementation plan: {{ output_dir }}/plan.md
       - Review results: outputs.review_implementation
 
       Respond with:
@@ -333,45 +333,52 @@ steps:
       - Review results: {{ outputs.review_implementation | tojson }}
       - PR created: {{ outputs.create_pull_request is defined }}
 
-      Save the summary to agentic/outputs/{{ workflow_id }}/summary.md
+      Save the summary to {{ output_dir }}/summary.md
 
 # Optional: Output artifacts
 outputs:
   # Generated when workflow completes successfully
   - name: implementation-report
-    # Jinja2 template file (resolved from workflow dir, agentic/templates/, or bundled templates)
+    # Nunjucks template file (resolved from workflow dir, agentic/templates/, or bundled templates)
     template: implementation-report.md.j2
     # Output file path (relative to workflow directory)
-    path: agentic/outputs/{{ workflow_id }}/report.md
+    path: "{{ output_dir }}/report.md"
     # When to generate: completed or failed
     when: completed
 
   # Generated when workflow fails
   - name: error-report
     template: error-report.md.j2
-    path: agentic/outputs/{{ workflow_id }}/error.md
+    path: "{{ output_dir }}/error.md"
     when: failed
 
 # ==================== 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:
@@ -408,13 +415,13 @@ outputs:
 #
 # ==================== BUILT-IN VARIABLES ====================
 #
-# Available in all Jinja2 templates:
+# Available in all Nunjucks templates:
 #   - {{ workflow_id }}              - Unique workflow execution ID
 #   - {{ workflow_name }}            - Workflow name from YAML
 #   - {{ variables.name }}           - User-defined variables
 #   - {{ outputs.step_name.field }}  - Step outputs
 #
-# ==================== JINJA2 FILTERS ====================
+# ==================== NUNJUCKS FILTERS ====================
 #
 # Common filters for templating:
 #   - {{ list | length }}            - Get list length

package/dist/checkpoints/manager.d.ts

@@ -1,5 +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;
+export declare function getCheckpointPath(workflowId: string, outputDir: string): string;
+export declare function createCheckpoint(workflowId: string, step: string, context: string, progress: string, outputDir: string, notes?: string, issues?: string): string;
+export declare function readCheckpoints(workflowId: string, outputDir: string): Record<string, unknown>[];
+export declare function getLatestCheckpoint(workflowId: string, outputDir: string): Record<string, unknown> | null;

package/dist/checkpoints/manager.js

@@ -3,16 +3,15 @@ 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");
+export function getCheckpointPath(workflowId, outputDir) {
+    return path.join(outputDir, "checkpoint.md");
 }
 // --- Create checkpoint ---
-export function createCheckpoint(workflowId, step, context, progress, notes = "", issues = "", repoRoot) {
-    const checkpointPath = getCheckpointPath(workflowId, repoRoot);
+export function createCheckpoint(workflowId, step, context, progress, outputDir, notes = "", issues = "") {
+    const checkpointPath = getCheckpointPath(workflowId, outputDir);
     const dir = path.dirname(checkpointPath);
     mkdirSync(dir, { recursive: true });
-    const existing = readCheckpoints(workflowId, repoRoot);
+    const existing = readCheckpoints(workflowId, outputDir);
     const checkpointNum = existing.length + 1;
     const checkpointId = `chk-${String(checkpointNum).padStart(3, "0")}`;
     const timestamp = new Date().toISOString();
@@ -49,8 +48,8 @@ export function createCheckpoint(workflowId, step, context, progress, notes = ""
     return checkpointId;
 }
 // --- Read checkpoints ---
-export function readCheckpoints(workflowId, repoRoot) {
-    const checkpointPath = getCheckpointPath(workflowId, repoRoot);
+export function readCheckpoints(workflowId, outputDir) {
+    const checkpointPath = getCheckpointPath(workflowId, outputDir);
     if (!existsSync(checkpointPath)) {
         return [];
     }
@@ -80,8 +79,8 @@ export function readCheckpoints(workflowId, repoRoot) {
     return checkpoints;
 }
 // --- Get latest checkpoint ---
-export function getLatestCheckpoint(workflowId, repoRoot) {
-    const checkpoints = readCheckpoints(workflowId, repoRoot);
+export function getLatestCheckpoint(workflowId, outputDir) {
+    const checkpoints = readCheckpoints(workflowId, outputDir);
     return checkpoints.length > 0 ? checkpoints[checkpoints.length - 1] : null;
 }
 //# sourceMappingURL=manager.js.map

package/dist/checkpoints/manager.js.map

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

package/dist/claude/.claude/skills/orchestrate/SKILL.md

@@ -21,7 +21,7 @@ You are the workflow orchestrator. Your job is to evaluate the current workflow
 
 ### Condition Evaluation
 
-For conditional steps, evaluate the Jinja2 condition using the available context:
+For conditional steps, evaluate the Nunjucks condition using the available context:
 
 - `outputs.{step_name}` - Previous step outputs
 - `variables.{var_name}` - Workflow variables
@@ -85,7 +85,7 @@ For conditional steps, evaluate the Jinja2 condition using the available context
 
 3. **Determine Next Action**
    - Based on step dependencies and conditions
-   - Evaluate any Jinja2 conditions
+   - Evaluate any Nunjucks conditions
    - Identify the appropriate action type
 
 4. **Return JSON Decision**

package/dist/cli.js

@@ -10,7 +10,7 @@ function optBool(val) {
 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";
+import { CliExitError, cmdAuthoringDir, cmdCancel, cmdConfig, cmdConfigure, cmdInit, cmdInput, cmdList, cmdPaths, cmdReleaseNotes, cmdResume, cmdRun, cmdSkillsDir, cmdStatus, cmdUpdate, cmdVersion, cmdWorkflows, getVersion, } from "./commands/index.js";
 const program = new Command()
     .name("agentic-forge")
     .version(getVersion())
@@ -18,18 +18,25 @@ const program = new Command()
 // 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, opts) => {
+    .option("--slug <slug>", "custom slug appended to the workflow run ID")
+    .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),
+        slug: optString(opts.slug),
     });
 });
 // resume command
@@ -82,13 +89,23 @@ program
 // init command
 program
     .command("init")
-    .description("Copy bundled workflow templates to local project")
-    .option("--force", "overwrite existing workflow files")
+    .description("Initialize agentic-forge directory (global by default, or --local for project)")
+    .option("--force", "overwrite existing workflow files and config")
     .option("--list", "list available bundled workflows without copying")
+    .option("--local", "initialize project-local directory (cwd/agentic/)")
+    .option("--global", "initialize global user directory (default)")
+    .option("--config-only", "only create config, skip workflow copy")
+    .option("--workflows-only", "only copy workflows, skip config creation")
+    .option("--workflow <name>", "copy only the named bundled workflow")
     .action((opts) => {
     cmdInit({
         force: optBool(opts.force),
         listOnly: optBool(opts.list),
+        local: optBool(opts.local),
+        global: optBool(opts.global),
+        configOnly: optBool(opts.configOnly),
+        workflowsOnly: optBool(opts.workflowsOnly),
+        workflow: optString(opts.workflow),
     });
 });
 // config command with subcommands
@@ -103,8 +120,15 @@ configCmd
     .command("set")
     .argument("<key>", "configuration key (dot notation)")
     .argument("<value>", "value to set")
-    .action((key, value) => {
-    cmdConfig("set", key, value);
+    .option("--global", "write to global config")
+    .option("--local", "write to local project config")
+    .action((key, value, opts) => {
+    const scope = opts.global
+        ? "global"
+        : opts.local
+            ? "local"
+            : undefined;
+    cmdConfig("set", key, value, scope);
 });
 // version command
 program
@@ -124,6 +148,13 @@ program
         latest: optBool(opts.latest),
     });
 });
+// paths command
+program
+    .command("paths")
+    .description("Show resolved path configuration (global, local, and bundled directories)")
+    .action(() => {
+    cmdPaths();
+});
 // skills-dir command
 program
     .command("skills-dir")
@@ -131,6 +162,13 @@ program
     .action(() => {
     cmdSkillsDir();
 });
+// authoring-dir command
+program
+    .command("authoring-dir")
+    .description("Print path to interactive authoring skills directory")
+    .action(() => {
+    cmdAuthoringDir();
+});
 // update command
 program
     .command("update")
@@ -151,5 +189,11 @@ program
         verbose: optBool(opts.verbose),
     });
 });
-program.parse();
+program.parseAsync().catch((err) => {
+    if (err instanceof CliExitError) {
+        process.stderr.write(`${err.message}\n`);
+        process.exit(err.exitCode);
+    }
+    throw err;
+});
 //# sourceMappingURL=cli.js.map