aiwcli 0.9.6 → 0.9.8

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

@@ -45,10 +45,6 @@ export default class Init extends BaseCommand {
      * @param templatePath - Template source path
      */
     private mergeWindsurfTemplateHooks;
-    /**
-     * Check if a path exists
-     */
-    private pathExists;
     /**
      * Perform post-installation actions.
      *
@@ -90,10 +86,6 @@ export default class Init extends BaseCommand {
      * @returns Wizard configuration result
      */
     private runInteractiveWizard;
-    /**
-     * Check if a file should be excluded from copying
-     */
-    private shouldExcludeFile;
     /**
      * Track method installation in settings.json
      *

package/dist/commands/init/index.js

@@ -8,8 +8,9 @@ import { detectUsername } from '../../lib/user-utils.js';
 import { updateGitignore } from '../../lib/gitignore-manager.js';
 import { mergeClaudeSettings } from '../../lib/hooks-merger.js';
 import { IdePathResolver } from '../../lib/ide-path-resolver.js';
+import { pathExists } from '../../lib/paths.js';
 import { getTargetSettingsFile, readClaudeSettings, writeClaudeSettings } from '../../lib/settings-hierarchy.js';
-import { checkTemplateStatus, installTemplate } from '../../lib/template-installer.js';
+import { checkTemplateStatus, installTemplate, shouldExclude } from '../../lib/template-installer.js';
 import { getAvailableTemplates, getTemplatePath } from '../../lib/template-resolver.js';
 import { getTargetHooksFile, readWindsurfHooks, writeWindsurfHooks } from '../../lib/windsurf-hooks-hierarchy.js';
 import { mergeWindsurfHooks } from '../../lib/windsurf-hooks-merger.js';
@@ -91,13 +92,13 @@ export default class Init extends BaseCommand {
                 const containerDir = resolver.getAiwcliContainer();
                 await fs.mkdir(containerDir, { recursive: true });
                 const sharedDestPath = resolver.getSharedFolder();
-                const sharedExists = await this.pathExists(sharedDestPath);
+                const sharedExists = await pathExists(sharedDestPath);
                 if (!sharedExists) {
                     const currentFilePath = fileURLToPath(import.meta.url);
                     const currentDir = dirname(currentFilePath);
                     const templatesRoot = join(dirname(dirname(currentDir)), 'templates');
                     const sharedSrcPath = join(templatesRoot, '_shared');
-                    if (!(await this.pathExists(sharedSrcPath))) {
+                    if (!(await pathExists(sharedSrcPath))) {
                         this.error(`Shared folder not found at ${sharedSrcPath}. This indicates a corrupted installation.`, {
                             exit: EXIT_CODES.ENVIRONMENT_ERROR,
                         });
@@ -235,7 +236,7 @@ export default class Init extends BaseCommand {
         const operations = entries
             .filter((entry) => {
             // Standard exclusions (test files, cache, etc.)
-            if (this.shouldExcludeFile(entry.name)) {
+            if (shouldExclude(entry.name)) {
                 return false;
             }
             // Exclude IDE config folders if requested (used for _shared folder)
@@ -352,18 +353,6 @@ export default class Init extends BaseCommand {
             // Don't fail the entire installation if hook merging fails
         }
     }
-    /**
-     * Check if a path exists
-     */
-    async pathExists(path) {
-        try {
-            await fs.access(path);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
     /**
      * Perform post-installation actions.
      *
@@ -511,25 +500,6 @@ export default class Init extends BaseCommand {
             confirmed,
         };
     }
-    /**
-     * Check if a file should be excluded from copying
-     */
-    shouldExcludeFile(name) {
-        const excludedPatterns = [
-            '_output',
-            '__pycache__',
-            '.pytest_cache',
-            'conftest.py',
-            /^test_.*\.py$/,
-            /.*\.pyc$/,
-        ];
-        return excludedPatterns.some((pattern) => {
-            if (typeof pattern === 'string') {
-                return name === pattern;
-            }
-            return pattern.test(name);
-        });
-    }
     /**
      * Track method installation in settings.json
      *

package/dist/lib/index.d.ts

@@ -3,11 +3,10 @@
  * Re-exports all library modules from this barrel file.
  */
 export { type AiwcliConfig, getAiwDir, loadConfig, validateAiwDir, } from './config.js';
-export { debug, debugConfig, debugSpawn, debugVersion, isDebugEnabled, setDebugEnabled } from './debug.js';
-export { getAiwConfig, getAiwDir as getAiwDirFromEnv, isUsingLegacyEnvVars, loadEnvWithCompatibility, } from './env-compat.js';
-export { AiwError, ConfigNotFoundError, EnvironmentError, formatErrorMessage, InvalidUsageError, ProcessSpawnError, } from './errors.js';
+export { debug, debugSpawn, debugVersion, isDebugEnabled, setDebugEnabled } from './debug.js';
+export { AiwError, ConfigNotFoundError, EnvironmentError, InvalidUsageError, ProcessSpawnError, } from './errors.js';
 export { mergeArraysWithDedup, mergeConfigByEventType } from './generic-merge.js';
 export { branchExists, createWorktree, deleteBranch, deleteWorktreeFolder, getAllWorktrees, getCurrentBranch, getMainBranch, getWorktreePath, type GitCommandOptions, hasMergeRequest, hasUnpushedCommits, type WorktreeInfo, } from './git/index.js';
-export { expandPath, findWorkspaceRoot, getHomePath, getWorkspacePath, isWorkspace, normalizePath, pathExists, resolvePath, toUnixPath, toWindowsPath, } from './paths.js';
+export { findWorkspaceRoot, isWorkspace, pathExists, resolvePath, } from './paths.js';
 export { spawnProcess, type SpawnProcessOptions } from './spawn.js';
 export { escapeShellArg, launchTerminal, type TerminalLaunchOptions, type TerminalLaunchResult, } from './terminal.js';

package/dist/lib/index.js

@@ -5,17 +5,15 @@
 // Configuration resolution
 export { getAiwDir, loadConfig, validateAiwDir, } from './config.js';
 // Debug logging
-export { debug, debugConfig, debugSpawn, debugVersion, isDebugEnabled, setDebugEnabled } from './debug.js';
-// Environment variable compatibility
-export { getAiwConfig, getAiwDir as getAiwDirFromEnv, isUsingLegacyEnvVars, loadEnvWithCompatibility, } from './env-compat.js';
+export { debug, debugSpawn, debugVersion, isDebugEnabled, setDebugEnabled } from './debug.js';
 // Custom error classes and utilities
-export { AiwError, ConfigNotFoundError, EnvironmentError, formatErrorMessage, InvalidUsageError, ProcessSpawnError, } from './errors.js';
+export { AiwError, ConfigNotFoundError, EnvironmentError, InvalidUsageError, ProcessSpawnError, } from './errors.js';
 // Generic merge utilities
 export { mergeArraysWithDedup, mergeConfigByEventType } from './generic-merge.js';
 // Git utilities
 export { branchExists, createWorktree, deleteBranch, deleteWorktreeFolder, getAllWorktrees, getCurrentBranch, getMainBranch, getWorktreePath, hasMergeRequest, hasUnpushedCommits, } from './git/index.js';
 // Cross-platform path utilities
-export { expandPath, findWorkspaceRoot, getHomePath, getWorkspacePath, isWorkspace, normalizePath, pathExists, resolvePath, toUnixPath, toWindowsPath, } from './paths.js';
+export { findWorkspaceRoot, isWorkspace, pathExists, resolvePath, } from './paths.js';
 // Process spawning utilities
 export { spawnProcess } from './spawn.js';
 // Cross-platform terminal launching

package/dist/lib/settings-hierarchy.js

@@ -2,6 +2,7 @@ import { promises as fs } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { IdePathResolver } from './ide-path-resolver.js';
+import { pathExists } from './paths.js';
 /**
  * Discover Claude settings files in the hierarchy
  *
@@ -20,36 +21,24 @@ export async function discoverSettingsFiles(projectDir) {
     locations.push({
         type: 'user',
         path: userSettingsPath,
-        exists: await fileExists(userSettingsPath),
+        exists: await pathExists(userSettingsPath),
     });
     // Project settings (shared)
     const projectSettingsPath = join(projectDir, '.claude', 'settings.json');
     locations.push({
         type: 'project',
         path: projectSettingsPath,
-        exists: await fileExists(projectSettingsPath),
+        exists: await pathExists(projectSettingsPath),
     });
     // Local project settings (gitignored)
     const localSettingsPath = join(projectDir, '.claude', 'settings.local.json');
     locations.push({
         type: 'local',
         path: localSettingsPath,
-        exists: await fileExists(localSettingsPath),
+        exists: await pathExists(localSettingsPath),
     });
     return locations;
 }
-/**
- * Check if file exists
- */
-async function fileExists(path) {
-    try {
-        await fs.access(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 /**
  * Read Claude settings from file
  *
@@ -81,7 +70,7 @@ export async function writeClaudeSettings(path, settings) {
     const dir = join(path, '..');
     await fs.mkdir(dir, { recursive: true });
     // Backup existing file if it exists
-    if (await fileExists(path)) {
+    if (await pathExists(path)) {
         const backupPath = `${path}.backup`;
         await fs.copyFile(path, backupPath);
     }

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

@@ -67,6 +67,15 @@ export interface InstallationResult {
  * @returns Status of template items
  */
 export declare function checkTemplateStatus(templatePath: string, targetDir: string, ides: string[], templateName: string): Promise<TemplateInstallationStatus>;
+/**
+ * Patterns to exclude when copying template directories.
+ * These are development/test artifacts that shouldn't be packaged.
+ */
+export declare const EXCLUDED_PATTERNS: (string | RegExp)[];
+/**
+ * Check if a filename should be excluded from copying
+ */
+export declare function shouldExclude(name: string): boolean;
 /**
  * Copy directory recursively with proper error handling.
  * Excludes test files, cache directories, and output folders.

package/dist/lib/template-installer.js

@@ -1,6 +1,7 @@
 import { promises as fs } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { IdePathResolver } from './ide-path-resolver.js';
+import { pathExists } from './paths.js';
 import { mergeTemplateContent } from './template-merger.js';
 /**
  * Deep merge two settings objects, combining hook arrays.
@@ -93,18 +94,6 @@ async function mergeSharedSettingsFromSource(targetDir, sourceSettingsPath) {
         return false;
     }
 }
-/**
- * Check if a path exists
- */
-async function pathExists(path) {
-    try {
-        await fs.access(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 /**
  * Check template installation status for a method.
  * Returns which items exist and which are missing.
@@ -178,7 +167,7 @@ export async function checkTemplateStatus(templatePath, targetDir, ides, templat
  * Patterns to exclude when copying template directories.
  * These are development/test artifacts that shouldn't be packaged.
  */
-const EXCLUDED_PATTERNS = [
+export const EXCLUDED_PATTERNS = [
     '_output',
     '__pycache__',
     '.pytest_cache',
@@ -189,7 +178,7 @@ const EXCLUDED_PATTERNS = [
 /**
  * Check if a filename should be excluded from copying
  */
-function shouldExclude(name) {
+export function shouldExclude(name) {
     return EXCLUDED_PATTERNS.some((pattern) => {
         if (typeof pattern === 'string') {
             return name === pattern;

package/dist/lib/template-merger.js

@@ -1,22 +1,11 @@
 import { promises as fs } from 'node:fs';
 import { join } from 'node:path';
+import { pathExists } from './paths.js';
 /**
  * Content folder types that should be recursively merged rather than skipped.
  * These are the canonical folder names used in templates for organizing content.
  */
 export const CONTENT_FOLDER_TYPES = ['agents', 'commands', 'workflows', 'tasks'];
-/**
- * Check if a path exists
- */
-async function pathExists(path) {
-    try {
-        await fs.access(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 /**
  * Recursively find folders matching the method name within a directory tree.
  * This finds folders like `.claude/commands/bmad/` when methodName is 'bmad'.

package/dist/lib/windsurf-hooks-hierarchy.js

@@ -1,17 +1,6 @@
 import { promises as fs } from 'node:fs';
 import { join } from 'node:path';
-/**
- * Check if file exists
- */
-async function fileExists(path) {
-    try {
-        await fs.access(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
+import { pathExists } from './paths.js';
 /**
  * Read Windsurf hooks from file
  *
@@ -43,7 +32,7 @@ export async function writeWindsurfHooks(path, hooks) {
     const dir = join(path, '..');
     await fs.mkdir(dir, { recursive: true });
     // Backup existing file if it exists
-    if (await fileExists(path)) {
+    if (await pathExists(path)) {
         const backupPath = `${path}.backup`;
         await fs.copyFile(path, backupPath);
     }

package/dist/templates/CLAUDE.md

@@ -17,24 +17,53 @@ Include `_output/{method}/` in template `.gitignore`.
 
 ## Directory Structure
 
+Each template installs into `.aiwcli/` (method files) and `.{ide}/` (IDE integration). The `_shared/` template provides cross-method infrastructure used by all methods.
+
 ```
-packages/cli/src/templates/{method}/
-├── _{method}/              # Method-specific shared files
-│   ├── templates/*.md.template
-│   └── workflows/*.md      # Canonical workflow definitions
-├── .{ide}/{ide-folder}/{method}/*.md  # IDE command stubs
-├── .gitignore              # Output ignore rules
-├── {METHOD}-README.md      # User documentation
-├── TEMPLATE-SCHEMA.md      # Schema reference
-└── MIGRATION.md            # Breaking changes
+packages/cli/src/templates/
+├── _shared/                          # Cross-method infrastructure (installed by all methods)
+│   ├── hooks/                        # Shared hook scripts (context, tasks, sessions)
+│   └── lib/                          # Shared Python libraries
+│       ├── base/                     #   Core: atomic_write, constants, inference, utils
+│       ├── context/                  #   Context management, event sourcing, discovery
+│       ├── handoff/                  #   Session handoff document generation
+│       └── templates/                #   Output formatters, plan context templates
+│
+├── cc-native/                        # CC-Native method template
+│   ├── _cc-native/                   #   Method-specific hooks, lib, agents, workflows, scripts
+│   ├── _shared/                      #   Copy of shared infrastructure (installed together)
+│   ├── .claude/                      #   Claude Code: settings.json, commands/, agents/
+│   ├── .windsurf/                    #   Windsurf: workflows/
+│   └── .gitignore
+│
+├── gsd/                              # GSD method template
+│   ├── .aiwcli/_gsd/                 #   Templates, workflows, hooks, config, docs
+│   ├── .claude/                      #   Claude Code: settings.json, commands/, agents/
+│   ├── .windsurf/                    #   Windsurf: workflows/
+│   ├── GSD-README.md
+│   ├── TEMPLATE-SCHEMA.md
+│   └── MIGRATION.md
+│
+├── bmad/                             # BMAD method template
+│   ├── .aiwcli/_bmad/               #   Agents, workflows, teams, testarch, config
+│   ├── .claude/                      #   Claude Code: settings.json, commands/
+│   └── ...
+│
+├── planning-with-files/              # Planning-with-Files method template
+│   ├── .claude/                      #   Claude Code: settings.json, skills/
+│   ├── .windsurf/                    #   Windsurf: workflows/, scripts/
+│   └── ...
+│
+└── CLAUDE.md                         # This file
 ```
 
 ### Tier Details
 
 | Tier | Location | Purpose |
 |------|----------|---------|
-| General | `_{method}/` | IDE-agnostic templates and canonical workflows |
-| IDE | `.{ide}/{folder}/{method}/` | Lightweight stubs that load canonical workflows |
+| Shared | `_shared/` | Cross-method hooks and libraries (context management, task sync, sessions) |
+| Method | `_{method}/` or `.aiwcli/_{method}/` | Method-specific templates, workflows, hooks, config |
+| IDE | `.{ide}/` | IDE-specific command stubs, settings, workflow definitions |
 | Config | `.{ide}/settings.json` | Hooks, model prefs, method settings (merged on install) |
 
 ---
@@ -57,7 +86,7 @@ When multiple templates install, settings.json files merge:
 
 ## Hooks
 
-**Location:** `.claude/hooks/{method}-{hook-name}.{ext}`
+**Location:** Hooks live in `.aiwcli/_shared/hooks/` (cross-method) and `.aiwcli/_{method}/hooks/` (method-specific). They are configured in `.{ide}/settings.json`, not placed in IDE directories.
 
 **Configuration:**
 ```json
@@ -65,14 +94,14 @@ When multiple templates install, settings.json files merge:
   "hooks": {
     "PostToolUse": [{
       "matcher": "Write",
-      "hooks": [{ "type": "command", "command": "python .claude/hooks/gsd-plan-review.py", "timeout": 300000 }]
+      "hooks": [{ "type": "command", "command": "python .aiwcli/_cc-native/hooks/cc-native-plan-review.py", "timeout": 300000 }]
     }]
   }
 }
 ```
 
 **Requirements:**
-- Prefix with method name (e.g., `gsd-plan-review.py`)
+- Prefix method-specific hooks with method name (e.g., `cc-native-plan-review.py`)
 - Use relative paths from project root
 - Write outputs to `_output/{method}/`
 - Specify timeouts
@@ -119,8 +148,8 @@ Load and execute `_{method}/workflows/{name}.md`.
 | Reference Type | Pattern |
 |----------------|---------|
 | Templates | `_{method}/templates/FILE.md.template` |
-| Workflows (Claude) | `/gsd:other-workflow` |
-| Workflows (Windsurf) | `other-workflow` from GSD workflows |
+| Workflows (Claude) | `/gsd:workflow-name` (maps to `.claude/commands/gsd/workflow-name.md`) |
+| Workflows (Windsurf) | `workflow-name` from method workflows |
 | Outputs | `_output/{method}/{subdir}/FILE.md` |
 
 ---
@@ -143,8 +172,8 @@ Load and execute `_{method}/workflows/{name}.md`.
 
 **New Template:**
 - [ ] Create `_{method}/` with `templates/` and `workflows/`
-- [ ] Create `.claude/commands/{method}/` stubs
-- [ ] Create `.windsurf/workflows/{method}/` stubs
+- [ ] Create `.claude/commands/{method}/` stubs (Claude Code)
+- [ ] Create `.windsurf/workflows/{method}/` stubs (Windsurf)
 - [ ] Add `.gitignore` with `_output/{method}/`
 - [ ] Create `{METHOD}-README.md`, `TEMPLATE-SCHEMA.md`, `MIGRATION.md`
 - [ ] Configure method-namespaced settings in `.claude/settings.json`
@@ -165,6 +194,7 @@ Load and execute `_{method}/workflows/{name}.md`.
 - Keep canonical workflows in `_{method}/workflows/`
 - Use relative paths from project root
 - Document changes in TEMPLATE-SCHEMA.md
+- Place hooks in `.aiwcli/` directories, wire them in `.{ide}/settings.json`
 
 **Avoid:**
 - Outputs in project root
@@ -172,3 +202,4 @@ Load and execute `_{method}/workflows/{name}.md`.
 - Hooks without method prefix
 - Full workflows in IDE command files
 - Hardcoded paths without method namespace
+- Putting hook scripts directly in IDE directories (`.claude/hooks/`)