aiwcli 0.12.7 → 0.13.0

package/dist/commands/init/index.d.ts

@@ -29,6 +29,13 @@ export default class Init extends BaseCommand {
      * @returns Template description
      */
     private getTemplateDescription;
+    /**
+     * Perform minimal installation (_shared folder only, no template method).
+     *
+     * @param targetDir - Target directory for installation
+     * @param hasGit - Whether git repository exists
+     */
+    private performMinimalInstall;
     /**
      * Perform post-installation actions.
      *
@@ -70,6 +77,14 @@ export default class Init extends BaseCommand {
      * @returns Wizard configuration result
      */
     private runInteractiveWizard;
+    /**
+     * Install the global resolve-run.ts script to ~/.aiwcli/bin/.
+     *
+     * This resolver allows hook and status line commands to find the project root
+     * regardless of cwd drift (e.g., after `cd` in a Bash tool call).
+     * Always overwrites to ensure the latest version is installed.
+     */
+    private installGlobalResolver;
     /**
      * Track method installation in settings.json
      *

package/dist/commands/init/index.js

@@ -1,7 +1,11 @@
 import { promises as fs } from 'node:fs';
+import { homedir } from 'node:os';
 import { basename, dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { checkbox, confirm, input, select } from '@inquirer/prompts';
+import checkbox from '@inquirer/checkbox';
+import confirm from '@inquirer/confirm';
+import input from '@inquirer/input';
+import select from '@inquirer/select';
 import { Flags } from '@oclif/core';
 import BaseCommand from '../../lib/base-command.js';
 import { AIW_GITIGNORE_ENTRIES, updateGitignore } from '../../lib/gitignore-manager.js';
@@ -83,43 +87,7 @@ export default class Init extends BaseCommand {
             const config = await this.resolveInstallationConfig(flags, targetDir, availableTemplates);
             // If config is null, perform minimal install (shared folder only)
             if (!config) {
-                this.logInfo('Performing minimal installation (_shared folder only)...');
-                this.log('');
-                // Create .aiwcli container and install _shared
-                const resolver = new IdePathResolver(targetDir);
-                const containerDir = resolver.getAiwcliContainer();
-                await fs.mkdir(containerDir, { recursive: true });
-                const sharedDestPath = resolver.getSharedFolder();
-                const sharedExists = await pathExists(sharedDestPath);
-                if (sharedExists) {
-                    this.logInfo('✓ _shared folder already exists - skipping');
-                }
-                else {
-                    const currentFilePath = fileURLToPath(import.meta.url);
-                    const currentDir = dirname(currentFilePath);
-                    const templatesRoot = join(dirname(dirname(currentDir)), 'templates');
-                    const sharedSrcPath = join(templatesRoot, '_shared');
-                    if (!(await pathExists(sharedSrcPath))) {
-                        this.error(`Shared folder not found at ${sharedSrcPath}. This indicates a corrupted installation.`, {
-                            exit: EXIT_CODES.ENVIRONMENT_ERROR,
-                        });
-                    }
-                    await this.copyDirectory(sharedSrcPath, sharedDestPath, true);
-                    this.logSuccess('✓ Installed _shared folder');
-                }
-                // Reconstruct settings from _shared template
-                await reconstructIdeSettings(targetDir, [], ['claude']);
-                // Update .gitignore if git repository exists
-                if (hasGit) {
-                    await updateGitignore(targetDir, [...AIW_GITIGNORE_ENTRIES]);
-                    this.logSuccess('✓ .gitignore updated');
-                }
-                this.log('');
-                this.logSuccess('✓ Minimal installation completed successfully');
-                this.log('');
-                this.logInfo('Next steps:');
-                this.logInfo('  aiw init --method <template>    Install a full template method (cc-native)');
-                this.logInfo('  aiw init --interactive          Run interactive setup wizard');
+                await this.performMinimalInstall(targetDir, hasGit);
                 return;
             }
             const { method, ides, username, projectName } = config;
@@ -183,6 +151,8 @@ export default class Init extends BaseCommand {
             if (result.installedFolders.length > 0) {
                 this.logSuccess(`✓ Installed: ${result.installedFolders.join(', ')}`);
             }
+            // Install global resolver for cwd-drift-proof hook/status line commands
+            await this.installGlobalResolver();
             // Perform post-installation actions (settings tracking, hook merging, gitignore updates)
             await this.performPostInstallActions({
                 targetDir,
@@ -263,6 +233,53 @@ export default class Init extends BaseCommand {
         };
         return descriptions[template] || 'Custom template';
     }
+    /**
+     * Perform minimal installation (_shared folder only, no template method).
+     *
+     * @param targetDir - Target directory for installation
+     * @param hasGit - Whether git repository exists
+     */
+    async performMinimalInstall(targetDir, hasGit) {
+        this.logInfo('Performing minimal installation (_shared folder only)...');
+        this.log('');
+        // Create .aiwcli container and install _shared
+        const resolver = new IdePathResolver(targetDir);
+        const containerDir = resolver.getAiwcliContainer();
+        await fs.mkdir(containerDir, { recursive: true });
+        const sharedDestPath = resolver.getSharedFolder();
+        const sharedExists = await pathExists(sharedDestPath);
+        if (sharedExists) {
+            this.logInfo('✓ _shared folder already exists - skipping');
+        }
+        else {
+            const currentFilePath = fileURLToPath(import.meta.url);
+            const currentDir = dirname(currentFilePath);
+            const templatesRoot = join(dirname(dirname(currentDir)), 'templates');
+            const sharedSrcPath = join(templatesRoot, '_shared');
+            if (!(await pathExists(sharedSrcPath))) {
+                this.error(`Shared folder not found at ${sharedSrcPath}. This indicates a corrupted installation.`, {
+                    exit: EXIT_CODES.ENVIRONMENT_ERROR,
+                });
+            }
+            await this.copyDirectory(sharedSrcPath, sharedDestPath, true);
+            this.logSuccess('✓ Installed _shared folder');
+        }
+        // Install global resolver for cwd-drift-proof hook/status line commands
+        await this.installGlobalResolver();
+        // Reconstruct settings from _shared template
+        await reconstructIdeSettings(targetDir, [], ['claude']);
+        // Update .gitignore if git repository exists
+        if (hasGit) {
+            await updateGitignore(targetDir, [...AIW_GITIGNORE_ENTRIES]);
+            this.logSuccess('✓ .gitignore updated');
+        }
+        this.log('');
+        this.logSuccess('✓ Minimal installation completed successfully');
+        this.log('');
+        this.logInfo('Next steps:');
+        this.logInfo('  aiw init --method <template>    Install a full template method (cc-native)');
+        this.logInfo('  aiw init --interactive          Run interactive setup wizard');
+    }
     /**
      * Perform post-installation actions.
      *
@@ -415,6 +432,30 @@ export default class Init extends BaseCommand {
             confirmed,
         };
     }
+    /**
+     * Install the global resolve-run.ts script to ~/.aiwcli/bin/.
+     *
+     * This resolver allows hook and status line commands to find the project root
+     * regardless of cwd drift (e.g., after `cd` in a Bash tool call).
+     * Always overwrites to ensure the latest version is installed.
+     */
+    async installGlobalResolver() {
+        try {
+            const currentFilePath = fileURLToPath(import.meta.url);
+            const currentDir = dirname(currentFilePath);
+            const templatesRoot = join(dirname(dirname(currentDir)), 'templates');
+            const resolverSrc = join(templatesRoot, '_shared', 'scripts', 'resolve-run.ts');
+            const globalBinDir = join(homedir(), '.aiwcli', 'bin');
+            const resolverDest = join(globalBinDir, 'resolve-run.ts');
+            await fs.mkdir(globalBinDir, { recursive: true });
+            await fs.copyFile(resolverSrc, resolverDest);
+            this.logSuccess('✓ Global resolver installed (~/.aiwcli/bin/resolve-run.ts)');
+        }
+        catch (error) {
+            const err = error;
+            this.warn(`Failed to install global resolver: ${err.message}`);
+        }
+    }
     /**
      * Track method installation in settings.json
      *

package/dist/lib/gitignore-manager.js

@@ -35,21 +35,20 @@ export async function pruneGitignoreStaleEntries(targetDir) {
                 aiwSectionLines.push(line);
                 continue;
             }
-            if (inAiwSection) {
-                // AIW section ends at empty line or another comment header
-                if (line === '' || (line.startsWith('#') && line !== AIW_GITIGNORE_HEADER)) {
-                    inAiwSection = false;
-                    const { lines: filtered, pruned: sectionPruned } = await pruneSection(aiwSectionLines, targetDir); // eslint-disable-line no-await-in-loop
-                    if (sectionPruned)
-                        pruned = true;
-                    newLines.push(...filtered, line);
-                }
-                else {
-                    aiwSectionLines.push(line);
-                }
+            if (!inAiwSection) {
+                newLines.push(line);
+                continue;
+            }
+            // AIW section ends at empty line or another comment header
+            if (line === '' || (line.startsWith('#') && line !== AIW_GITIGNORE_HEADER)) {
+                inAiwSection = false;
+                const { lines: filtered, pruned: sectionPruned } = await pruneSection(aiwSectionLines, targetDir); // eslint-disable-line no-await-in-loop
+                if (sectionPruned)
+                    pruned = true;
+                newLines.push(...filtered, line);
             }
             else {
-                newLines.push(line);
+                aiwSectionLines.push(line);
             }
         }
         // Handle case where AIW section is at end of file

package/dist/lib/settings-hierarchy.d.ts

@@ -1,4 +1,16 @@
-import type { ClaudeSettings } from './claude-settings-types.js';
+import type { ClaudeSettings, SettingsLocation } from './claude-settings-types.js';
+/**
+ * Discover Claude settings files in the hierarchy
+ *
+ * Settings hierarchy (in order of precedence):
+ * 1. Local Project Settings: `.claude/settings.local.json` (gitignored)
+ * 2. Project Settings: `.claude/settings.json` (shared with team)
+ * 3. User Settings: `~/.claude/settings.json` (global)
+ *
+ * @param projectDir - Project directory path
+ * @returns Array of settings locations in order of precedence
+ */
+export declare function discoverSettingsFiles(projectDir: string): Promise<SettingsLocation[]>;
 /**
  * Read Claude settings from file
  *

package/dist/lib/settings-hierarchy.js

@@ -14,7 +14,7 @@ import { pathExists } from './paths.js';
  * @param projectDir - Project directory path
  * @returns Array of settings locations in order of precedence
  */
-async function discoverSettingsFiles(projectDir) {
+export async function discoverSettingsFiles(projectDir) {
     const locations = [];
     // User settings (global)
     const userSettingsPath = join(homedir(), '.claude', 'settings.json');

package/dist/lib/template-linter.d.ts

@@ -35,6 +35,10 @@ export declare function lintFileContent(content: string, filePath: string, rules
  * Lint all markdown files for a specific template method
  */
 export declare function lintTemplateMethod(templatesDir: string, method: string): LintViolation[];
+/**
+ * Lint all template methods in a templates directory
+ */
+export declare function lintAllTemplates(templatesDir: string): Map<string, LintViolation[]>;
 /**
  * Format violations for display
  */

package/dist/lib/template-linter.js

@@ -144,7 +144,7 @@ export function lintTemplateMethod(templatesDir, method) {
 /**
  * Lint all template methods in a templates directory
  */
-function lintAllTemplates(templatesDir) {
+export function lintAllTemplates(templatesDir) {
     const results = new Map();
     const methods = ['cc-native'];
     for (const method of methods) {

package/dist/lib/tty-detection.d.ts

@@ -55,6 +55,7 @@ export declare function isQuietMode(flags?: {
  * Spinners only make sense in interactive terminals.
  * Automatically disabled in CI environments and quiet mode.
  * @param flags - Optional flags object with quiet mode
+ * @param flags.quiet - Quiet mode flag
  * @param proc - Optional process-like object for testing (defaults to global process)
  */
 export declare function shouldShowSpinners(flags?: {

package/dist/lib/tty-detection.js

@@ -67,6 +67,7 @@ export function isQuietMode(flags) {
  * Spinners only make sense in interactive terminals.
  * Automatically disabled in CI environments and quiet mode.
  * @param flags - Optional flags object with quiet mode
+ * @param flags.quiet - Quiet mode flag
  * @param proc - Optional process-like object for testing (defaults to global process)
  */
 export function shouldShowSpinners(flags, proc = process) {

package/dist/templates/CLAUDE.md

@@ -203,3 +203,30 @@ Load and execute `_{method}/workflows/{name}.md`.
 - Hardcoded paths without method namespace
 - Putting hook scripts directly in IDE directories (`.claude/hooks/`)
 - Creating `_shared/` directories inside method templates (e.g., `cc-native/_shared/`). All shared code lives in `packages/cli/src/templates/_shared/`. Method templates reference shared code via imports at runtime, not by copying.
+
+---
+
+## System Co-location Pattern
+
+Cohesive subsystems are organized as self-contained folders, following the handoff system model. Each system folder lives at the `_shared/` or `_cc-native/` level and contains:
+
+```
+{system-name}/
+├── CLAUDE.md       ← Spec: lifecycle, API reference, design decisions, gotchas
+├── lib/            ← TypeScript implementation (imported by hooks and other systems)
+├── agents/         ← Agent spec .md files used by this system (if any)
+├── scripts/        ← Standalone entry points invoked independently (if any)
+└── workflows/      ← User-facing procedural workflow docs (if any)
+```
+
+**Existing systems following this pattern:**
+- `_shared/skills/handoff-system/` — handoff creation and restoration
+- `_cc-native/plan-review/` — multi-agent plan review pipeline
+- `_cc-native/artifacts/` — review artifact generation and tracking
+- `_cc-native/lib-ts/rlm/` — retrieval-augmented learning memory
+
+**Hooks are NOT co-located with their owning system.**
+Claude Code hooks are path-referenced in `.claude/settings.json` at install time.
+Moving a hook file requires settings.json updates — high blast-radius, fragile.
+Hooks live in `_shared/hooks-ts/` or `_cc-native/hooks/`. Each system's CLAUDE.md
+lists the hooks that invoke it under a "Hooks" section.

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

@@ -1,11 +1,11 @@
 {
   "statusLine": {
     "type": "command",
-    "command": "bun .aiwcli/_shared/scripts/status_line.ts"
+    "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/scripts/status_line.ts"
   },
   "fileSuggestion": {
     "type": "command",
-    "command": "bun .aiwcli/_shared/hooks-ts/file-suggestion.ts"
+    "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/file-suggestion.ts"
   },
   "hooks": {
     "UserPromptSubmit": [
@@ -13,7 +13,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_shared/hooks-ts/user_prompt_submit.ts",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/user_prompt_submit.ts",
             "timeout": 5000
           }
         ]
@@ -25,7 +25,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_shared/hooks-ts/context_monitor.ts",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/context_monitor.ts",
             "timeout": 5000
           }
         ]
@@ -35,7 +35,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_shared/hooks-ts/task_create_capture.ts",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/task_create_capture.ts",
             "timeout": 3000
           }
         ]
@@ -45,7 +45,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_shared/hooks-ts/task_update_capture.ts",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/task_update_capture.ts",
             "timeout": 3000
           }
         ]
@@ -55,7 +55,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_shared/hooks-ts/archive_plan.ts",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/archive_plan.ts",
             "timeout": 5000
           }
         ]

package/dist/templates/_shared/.claude/{commands/handoff.md → skills/handoff/SKILL.md}

@@ -1,11 +1,12 @@
 ---
 name: handoff
-description: Create handoff document
+description: Create handoff document to preserve session context for future sessions
+user-invocable: true
 ---
 
-# Handoff Workflow
+# Handoff
 
-Generate a comprehensive handoff document for the next session. See `.aiwcli/_shared/handoff-system/workflows/handoff.md` for complete process documentation.
+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`
 

package/dist/templates/_shared/.claude/{commands/handoff-resume.md → skills/handoff-resume/SKILL.md}

@@ -1,11 +1,12 @@
 ---
 name: handoff-resume
-description: Resume handoff
+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/handoff-system/workflows/handoff-resume.md` for complete process documentation.
+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`
 

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

@@ -0,0 +1,43 @@
+---
+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/handoff.md

@@ -150,7 +150,7 @@ If a plan document path was provided in `$ARGUMENTS`:
 Instead of writing the file directly, pipe your handoff content to the save script:
 
 ```bash
-bun .aiwcli/_shared/handoff-system/scripts/save_handoff.ts "{context_id}" <<'EOF'
+bun .aiwcli/_shared/skills/handoff-system/scripts/save_handoff.ts "{context_id}" <<'EOF'
 {Your complete handoff markdown content from Step 3}
 EOF
 ```