aiwcli 0.15.5 → 0.17.0

package/dist/lib/base-command.d.ts

@@ -1,114 +0,0 @@
-import { Command } from '@oclif/core';
-import { type Ora } from 'ora';
-/**
- * Base command class that all AI Workflow CLI commands should extend.
- * Provides global --debug flag support for verbose logging.
- *
- * @example Basic command with debug support
- * import {debug} from '../lib/debug.js'
- *
- * export default class MyCommand extends BaseCommand {
- *   static override flags = {
- *     ...BaseCommand.baseFlags,
- *     // command-specific flags
- *   }
- *
- *   async run() {
- *     // debug mode is already enabled if --debug flag was passed
- *     // version info is automatically logged when debug enabled
- *     debug('My debug message')
- *   }
- * }
- *
- * @example Command with spinner progress feedback
- * import {ux} from '@oclif/core'
- *
- * export default class LongCommand extends BaseCommand {
- *   async run() {
- *     // Check if output is piped (suppress spinners for piped output)
- *     const isPiped = !process.stdout.isTTY
- *
- *     if (!isPiped) {
- *       // Show spinner for long operations in interactive terminal
- *       ux.action.start('Processing')
- *       await longRunningOperation()
- *       ux.action.stop()
- *     } else {
- *       // Piped output - suppress spinner
- *       await longRunningOperation()
- *     }
- *   }
- * }
- *
- * @example Spinner with status updates
- * import {ux} from '@oclif/core'
- *
- * export default class MultiStepCommand extends BaseCommand {
- *   async run() {
- *     if (process.stdout.isTTY) {
- *       ux.action.start('Installing packages')
- *       await installPackages()
- *
- *       // Update spinner status
- *       ux.action.status = 'Configuring'
- *       await configure()
- *
- *       ux.action.stop('Done!')
- *     } else {
- *       await installPackages()
- *       await configure()
- *     }
- *   }
- * }
- */
-export default abstract class BaseCommand extends Command {
-    /**
-     * Global flags inherited by all AI Workflow CLI commands.
-     * All command classes should spread these flags into their own flag definitions:
-     * `static override flags = { ...BaseCommand.baseFlags, /* command-specific flags *\/ }`
-     *
-     * @see Command Development Guide in README.md for usage patterns
-     */
-    static baseFlags: {
-        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        help: import("@oclif/core/interfaces").BooleanFlag<void>;
-        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    init(): Promise<void>;
-    /**
-     * Check if quiet mode is enabled.
-     * Returns true if --quiet/-q flag was passed.
-     */
-    protected isQuiet(): boolean;
-    /**
-     * Log debug message (stdout, dim in TTY).
-     * Debug output is independent of quiet mode.
-     */
-    protected logDebug(message: string): void;
-    /**
-     * Log error message (stderr, red in TTY).
-     * Errors are NEVER suppressed, even in quiet mode.
-     */
-    protected logError(message: string): void;
-    /**
-     * Log informational message (stdout, no color).
-     * Suppressed in quiet mode.
-     */
-    protected logInfo(message: string): void;
-    /**
-     * Log success message (stdout, green in TTY).
-     * Suppressed in quiet mode.
-     */
-    protected logSuccess(message: string): void;
-    /**
-     * Log warning message (stdout, yellow in TTY).
-     * Suppressed in quiet mode.
-     */
-    protected logWarning(message: string): void;
-    abstract run(): Promise<void>;
-    /**
-     * Create a TTY-aware spinner for long-running operations.
-     * Automatically disabled when output is piped, in CI environments, or in quiet mode.
-     */
-    protected spinner(text: string): Ora;
-}

package/dist/lib/base-command.js

@@ -1,153 +0,0 @@
-import { Command, Flags } from '@oclif/core';
-import { debugVersion, setDebugEnabled } from '../lib/debug.js';
-import { logDebug, logError, logInfo, logSuccess, logWarning } from '../lib/output.js';
-import { isQuietMode, setQuietMode } from '../lib/quiet.js';
-import { createSpinner } from '../lib/spinner.js';
-/**
- * Base command class that all AI Workflow CLI commands should extend.
- * Provides global --debug flag support for verbose logging.
- *
- * @example Basic command with debug support
- * import {debug} from '../lib/debug.js'
- *
- * export default class MyCommand extends BaseCommand {
- *   static override flags = {
- *     ...BaseCommand.baseFlags,
- *     // command-specific flags
- *   }
- *
- *   async run() {
- *     // debug mode is already enabled if --debug flag was passed
- *     // version info is automatically logged when debug enabled
- *     debug('My debug message')
- *   }
- * }
- *
- * @example Command with spinner progress feedback
- * import {ux} from '@oclif/core'
- *
- * export default class LongCommand extends BaseCommand {
- *   async run() {
- *     // Check if output is piped (suppress spinners for piped output)
- *     const isPiped = !process.stdout.isTTY
- *
- *     if (!isPiped) {
- *       // Show spinner for long operations in interactive terminal
- *       ux.action.start('Processing')
- *       await longRunningOperation()
- *       ux.action.stop()
- *     } else {
- *       // Piped output - suppress spinner
- *       await longRunningOperation()
- *     }
- *   }
- * }
- *
- * @example Spinner with status updates
- * import {ux} from '@oclif/core'
- *
- * export default class MultiStepCommand extends BaseCommand {
- *   async run() {
- *     if (process.stdout.isTTY) {
- *       ux.action.start('Installing packages')
- *       await installPackages()
- *
- *       // Update spinner status
- *       ux.action.status = 'Configuring'
- *       await configure()
- *
- *       ux.action.stop('Done!')
- *     } else {
- *       await installPackages()
- *       await configure()
- *     }
- *   }
- * }
- */
-export default class BaseCommand extends Command {
-    /**
-     * Global flags inherited by all AI Workflow CLI commands.
-     * All command classes should spread these flags into their own flag definitions:
-     * `static override flags = { ...BaseCommand.baseFlags, /* command-specific flags *\/ }`
-     *
-     * @see Command Development Guide in README.md for usage patterns
-     */
-    static baseFlags = {
-        debug: Flags.boolean({
-            char: 'd',
-            description: 'Enable verbose debug logging',
-            default: false,
-        }),
-        help: Flags.help({
-            char: 'h',
-            description: 'Show help for command',
-        }),
-        quiet: Flags.boolean({
-            char: 'q',
-            description: 'Suppress informational output (errors still shown)',
-            default: false,
-        }),
-    };
-    async init() {
-        await super.init();
-        const { flags } = await this.parse(this.constructor);
-        const debugEnabled = flags.debug ?? false;
-        const quietEnabled = flags.quiet ?? false;
-        setDebugEnabled(debugEnabled);
-        setQuietMode(quietEnabled);
-        // Automatically show version info in debug mode (AC4, FR24)
-        if (debugEnabled) {
-            debugVersion();
-        }
-    }
-    /**
-     * Check if quiet mode is enabled.
-     * Returns true if --quiet/-q flag was passed.
-     */
-    isQuiet() {
-        // Access via module-level state (set in init())
-        return isQuietMode();
-    }
-    /**
-     * Log debug message (stdout, dim in TTY).
-     * Debug output is independent of quiet mode.
-     */
-    logDebug(message) {
-        logDebug(message);
-    }
-    /**
-     * Log error message (stderr, red in TTY).
-     * Errors are NEVER suppressed, even in quiet mode.
-     */
-    logError(message) {
-        logError(message);
-    }
-    /**
-     * Log informational message (stdout, no color).
-     * Suppressed in quiet mode.
-     */
-    logInfo(message) {
-        logInfo(message, this.isQuiet());
-    }
-    /**
-     * Log success message (stdout, green in TTY).
-     * Suppressed in quiet mode.
-     */
-    logSuccess(message) {
-        logSuccess(message, this.isQuiet());
-    }
-    /**
-     * Log warning message (stdout, yellow in TTY).
-     * Suppressed in quiet mode.
-     */
-    logWarning(message) {
-        logWarning(message, this.isQuiet());
-    }
-    /**
-     * Create a TTY-aware spinner for long-running operations.
-     * Automatically disabled when output is piped, in CI environments, or in quiet mode.
-     */
-    spinner(text) {
-        return createSpinner(text, { quiet: isQuietMode() });
-    }
-}

package/dist/lib/env-compat.d.ts

@@ -1,18 +0,0 @@
-/**
- * Environment Variable Layer
- *
- * Provides environment variable resolution for AIW CLI.
- *
- * Environment variables:
- * - AIW_DIR: Main installation directory
- * - AIW_CONFIG: Configuration file path
- */
-/**
- * Load environment variables.
- * Call this early in application bootstrap.
- */
-export declare function loadEnvWithCompatibility(): void;
-/**
- * Get AIW_DIR environment variable
- */
-export declare function getAiwDir(): string | undefined;

package/dist/lib/env-compat.js

@@ -1,23 +0,0 @@
-/**
- * Environment Variable Layer
- *
- * Provides environment variable resolution for AIW CLI.
- *
- * Environment variables:
- * - AIW_DIR: Main installation directory
- * - AIW_CONFIG: Configuration file path
- */
-/**
- * Load environment variables.
- * Call this early in application bootstrap.
- */
-export function loadEnvWithCompatibility() {
-    // DA (Assistant name) - Keep for backward compatibility, no warning
-    // This is commonly used and doesn't need migration
-}
-/**
- * Get AIW_DIR environment variable
- */
-export function getAiwDir() {
-    return process.env['AIW_DIR'];
-}

package/dist/lib/stdin.d.ts

@@ -1,48 +0,0 @@
-/**
- * stdin Detection and Reading Utilities
- *
- * Provides utilities for detecting and reading piped input from stdin.
- * Used by commands that need to accept piped data from other commands.
- *
- * @example Basic stdin detection
- * ```typescript
- * if (hasStdin()) {
- *   const input = await readStdin()
- *   // Process piped input
- * } else {
- *   // Interactive mode - prompt user
- * }
- * ```
- */
-/**
- * Check if stdin has piped data available.
- * Returns true when data is piped into the command, false in interactive terminals.
- *
- * @returns True if stdin is piped (not a TTY), false if interactive terminal
- *
- * @example
- * ```typescript
- * // echo "data" | pai process
- * hasStdin() // Returns true
- *
- * // pai process (no pipe)
- * hasStdin() // Returns false
- * ```
- */
-export declare function hasStdin(): boolean;
-/**
- * Read all data from stdin.
- * Reads piped input data and returns as UTF-8 string.
- * Returns empty string if no stdin available.
- *
- * @returns Promise resolving to stdin content as string, or empty string if no stdin
- *
- * @example
- * ```typescript
- * const input = await readStdin()
- * if (input) {
- *   console.log(`Received: ${input}`)
- * }
- * ```
- */
-export declare function readStdin(): Promise<string>;

package/dist/lib/stdin.js

@@ -1,60 +0,0 @@
-/**
- * stdin Detection and Reading Utilities
- *
- * Provides utilities for detecting and reading piped input from stdin.
- * Used by commands that need to accept piped data from other commands.
- *
- * @example Basic stdin detection
- * ```typescript
- * if (hasStdin()) {
- *   const input = await readStdin()
- *   // Process piped input
- * } else {
- *   // Interactive mode - prompt user
- * }
- * ```
- */
-import { stdin } from 'node:process';
-/**
- * Check if stdin has piped data available.
- * Returns true when data is piped into the command, false in interactive terminals.
- *
- * @returns True if stdin is piped (not a TTY), false if interactive terminal
- *
- * @example
- * ```typescript
- * // echo "data" | pai process
- * hasStdin() // Returns true
- *
- * // pai process (no pipe)
- * hasStdin() // Returns false
- * ```
- */
-export function hasStdin() {
-    return stdin.isTTY !== true;
-}
-/**
- * Read all data from stdin.
- * Reads piped input data and returns as UTF-8 string.
- * Returns empty string if no stdin available.
- *
- * @returns Promise resolving to stdin content as string, or empty string if no stdin
- *
- * @example
- * ```typescript
- * const input = await readStdin()
- * if (input) {
- *   console.log(`Received: ${input}`)
- * }
- * ```
- */
-export async function readStdin() {
-    if (!hasStdin()) {
-        return '';
-    }
-    const chunks = [];
-    for await (const chunk of stdin) {
-        chunks.push(chunk);
-    }
-    return Buffer.concat(chunks).toString('utf8');
-}

package/dist/templates/_shared/.claude/settings.json

@@ -1,120 +0,0 @@
-{
-  "statusLine": {
-    "type": "command",
-    "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/scripts/status_line.ts"
-  },
-  "fileSuggestion": {
-    "type": "command",
-    "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/file-suggestion.ts"
-  },
-  "hooks": {
-    "UserPromptSubmit": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/user_prompt_submit.ts",
-            "timeout": 10000
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/context_monitor.ts",
-            "timeout": 5000
-          }
-        ]
-      },
-      {
-        "matcher": "TaskCreate",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/task_create_capture.ts",
-            "timeout": 3000
-          }
-        ]
-      },
-      {
-        "matcher": "TaskUpdate",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/task_update_capture.ts",
-            "timeout": 3000
-          }
-        ]
-      },
-      {
-        "matcher": "ExitPlanMode",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/archive_plan.ts",
-            "timeout": 5000
-          }
-        ]
-      },
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/lint_after_edit.ts",
-            "timeout": 10000
-          }
-        ]
-      }
-    ],
-    "SessionStart": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/session_start.ts",
-            "timeout": 5000
-          }
-        ]
-      }
-    ],
-    "SessionEnd": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/session_end.ts",
-            "timeout": 5000
-          }
-        ]
-      }
-    ],
-    "PreCompact": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/pre_compact.ts",
-            "timeout": 5000
-          }
-        ]
-      }
-    ],
-    "PermissionRequest": [
-      {
-        "matcher": "ExitPlanMode",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/archive_plan.ts",
-            "timeout": 5000
-          }
-        ]
-      }
-    ]
-  }
-}

package/dist/templates/_shared/.claude/skills/codex/SKILL.md

@@ -1,35 +0,0 @@
----
-name: codex
-description: Delegate implementation to Codex sub-agents. USE WHEN codex OR send to codex OR codex implement OR hand off to codex OR launch codex OR codex plan OR run codex.
-user-invocable: true
----
-
-Read `.aiwcli/_shared/skills/codex/SKILL.md` for delegation patterns and examples.
-
-## Role
-
-You are the orchestrator. Codex instances are your implementation sub-agents. Decide what to delegate, how to split work, and review results when summaries arrive.
-
-## Command
-
-```
-bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/skills/codex/scripts/launch-codex.ts [flags] <mode>
-```
-
-The script blocks until Codex exits and prints a summary — run with Bash `run_in_background: true` so you stay unblocked.
-
-**Modes:** `plan` | `--file <path>` | `<inline text...>`
-
-**Key flags:**
-- `--context <id>` — Project orientation. Pass when implementing a plan.
-- `--prompt <text>` — Scope the agent's work to a specific plan section or task.
-- `--model <name>` — `spark`, `codex`, `gpt`, or tier: `fast`, `standard`, `smart`.
-- `--no-watch` — Fire-and-forget (skip waiting for summary).
-
-## Delegation Decision
-
-**One-shot:** Plan is small or tightly coupled → launch one Codex with `plan` mode. Wait for the summary, then review.
-
-**Parallel:** Plan has independent sections → launch multiple Codex instances, each scoped with `--prompt` to its section. All share the same `--context`. Review when summaries arrive, check for conflicts.
-
-**Ad-hoc:** No plan, just a task → pass inline text (e.g., `"Fix the failing test in auth.ts"`).

package/dist/templates/_shared/.claude/skills/handoff/SKILL.md

@@ -1,13 +0,0 @@
----
-name: handoff
-description: Create handoff document to preserve session context for future sessions
-user-invocable: true
----
-
-# Handoff
-
-Generate a comprehensive handoff document for the next session. See `.aiwcli/_shared/skills/handoff-system/workflows/handoff.md` for complete process documentation.
-
-**Quick trigger:** `/handoff` or `/handoff path/to/PLAN.md`
-
-The workflow guides you through gathering session context, generating structured sections, and saving via the handoff system.

package/dist/templates/_shared/.claude/skills/handoff-resume/SKILL.md

@@ -1,13 +0,0 @@
----
-name: handoff-resume
-description: Restore context from a handoff document and create ISC tasks to continue work
-user-invocable: true
----
-
-# Resume Handoff
-
-Restore context from a handoff document and create ISC tasks. See `.aiwcli/_shared/skills/handoff-system/workflows/handoff-resume.md` for complete process documentation.
-
-**Quick trigger:** `/handoff-resume` or `/handoff-resume path/to/handoff`
-
-The workflow uses the resume script to load handoff sections and convert pending items to tasks.

package/dist/templates/_shared/.claude/skills/meta-plan/SKILL.md

@@ -1,43 +0,0 @@
----
-name: meta-plan
-description: Structured problem-solving workflow that chains thinking categories to produce comprehensive plans. USE WHEN complex problem OR large solution space OR high ambiguity OR multiple approaches OR choosing solution is harder than implementing OR need comprehensive plan OR meta-plan OR dissect problem OR chain thinking.
-user-invocable: true
----
-
-# MetaPlan
-
-Structured problem-solving workflow that chains thinking categories (decomposition, divergent ideation, convergent analysis, adversarial challenge, trade-off evaluation, expert synthesis, integration) to produce comprehensive plans for complex problems where choosing the right approach is harder than implementing it.
-
-## Workflow Routing
-
-When a workflow is matched, **read its file and follow the steps within it.**
-
-| Workflow | Trigger | File |
-|----------|---------|------|
-| **MetaPlan** | "meta-plan", "chain thinking", "dissect problem", "comprehensive plan for complex problem" | `.aiwcli/_shared/skills/meta-plan/workflows/meta-plan.md` |
-
-## Examples
-
-**Example 1: Complex architecture decision**
-```
-User: "I need to add real-time updates to our app — not sure if we should use WebSockets, SSE, or polling"
--> Invokes MetaPlan workflow
--> Decomposes requirements, generates 3+ approaches, evaluates trade-offs, stress-tests leading option
--> Produces structured plan with recommended approach, risk assessment, and actionable next steps
-```
-
-**Example 2: Unfamiliar domain problem**
-```
-User: "/meta-plan — We need to implement end-to-end encryption for our messaging feature"
--> Invokes MetaPlan workflow
--> Runs expert synthesis first (domain research), then divergent ideation, convergent analysis
--> Produces plan grounded in domain best practices with approaches compared
-```
-
-**Example 3: Multi-stakeholder trade-off**
-```
-User: "Help me figure out the right approach for migrating our monolith to microservices"
--> Invokes MetaPlan workflow
--> Decision tree selects: Decomposition → Expert Synthesis → Trade-off → Adversarial → Integration
--> Produces plan with explicit trade-offs, irreversible decisions flagged, and switching conditions
-```

package/dist/templates/_shared/.codex/workflows/codex.md

@@ -1,11 +0,0 @@
-# Codex Workflow
-
-Use Codex CLI handoff instructions from `.aiwcli/_shared/skills/codex/SKILL.md`.
-
-## Command
-
-`bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/skills/codex/scripts/launch-codex.ts [flags] <mode>`
-
-**Modes:** `plan` | `--file <path>` | `<inline text...>`
-
-**Common flags:** `--model <name>`, `--sandbox <mode>`, `--context <id>`, `--prompt <text>`, `--no-yolo`, `--capture`