aiwcli 0.11.1 → 0.12.1

package/dist/commands/clear.d.ts

@@ -65,4 +65,12 @@ export default class ClearCommand extends BaseCommand {
      * Settings reconstruction handles hooks/permissions; this only strips the methods object.
      */
     private removeMethodEntries;
+    /**
+     * Remove shared IDE content (e.g., command files from _shared template).
+     *
+     * When all templates are removed, files installed from _shared/.claude/ and
+     * _shared/.windsurf/ should also be removed. Walks the shared template source
+     * and deletes matching files from the target, then prunes empty directories.
+     */
+    private removeSharedIdeContent;
 }

package/dist/commands/clear.js

@@ -5,6 +5,7 @@ import { Flags } from '@oclif/core';
 import BaseCommand from '../lib/base-command.js';
 import { computeGitignoreRemovals, pruneGitignoreStaleEntries, removeGitignoreEntries } from '../lib/gitignore-manager.js';
 import { pathExists } from '../lib/paths.js';
+import { getSharedTemplatePath } from '../lib/template-resolver.js';
 import { reconstructIdeSettings } from '../lib/template-settings-reconstructor.js';
 import { EXIT_CODES } from '../types/exit-codes.js';
 /**
@@ -187,6 +188,53 @@ async function shouldDeleteIdeFolder(targetDir, ideFolder) {
 async function removeDirectory(dir) {
     await fs.rm(dir, { force: true, recursive: true });
 }
+/**
+ * Recursively remove files from targetDir that match files in sourceDir.
+ * Only removes files that exist in the source template — user-created files are preserved.
+ * Prunes empty directories after file removal.
+ *
+ * @param sourceDir - Template source directory to match against
+ * @param targetDir - Target directory to remove matching files from
+ */
+async function removeMatchingFiles(sourceDir, targetDir) {
+    let entries;
+    try {
+        entries = await fs.readdir(sourceDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const sourcePath = join(sourceDir, entry.name);
+        const targetPath = join(targetDir, entry.name);
+        if (entry.isDirectory()) {
+            // Recurse into subdirectories
+            await removeMatchingFiles(sourcePath, targetPath); // eslint-disable-line no-await-in-loop
+        }
+        else if (entry.isFile()) {
+            // Skip settings files — handled by reconstruction
+            if (entry.name === 'settings.json' || entry.name === 'hooks.json')
+                continue;
+            // Remove matching file from target
+            try {
+                await fs.rm(targetPath, { force: true }); // eslint-disable-line no-await-in-loop
+            }
+            catch {
+                // File doesn't exist or can't be removed
+            }
+        }
+    }
+    // Prune target directory if now empty
+    try {
+        const remaining = await fs.readdir(targetDir);
+        if (remaining.length === 0) {
+            await fs.rmdir(targetDir);
+        }
+    }
+    catch {
+        // Directory doesn't exist or can't be accessed
+    }
+}
 /**
  * Clear workflow folders, output folders, IDE method folders, and update configurations.
  */
@@ -497,6 +545,25 @@ export default class ClearCommand extends BaseCommand {
                     }
                 }
             }
+            // Remove shared IDE content when no templates remain
+            if (methodsToRemove.length > 0) {
+                const allMethodsAfterRemove = await getInstalledMethodNames(targetDir);
+                const remainingAfterRemove = [...allMethodsAfterRemove].filter(m => !methodsToRemove.includes(m));
+                if (remainingAfterRemove.length === 0) {
+                    await this.removeSharedIdeContent(targetDir);
+                }
+            }
+            // Clean up backup files created during reconstruction
+            const backupCleanups = Object.values(IDE_FOLDERS).map(async (ide) => {
+                const backupPath = join(targetDir, ide.root, `${ide.settingsFile}.backup`);
+                try {
+                    await fs.rm(backupPath, { force: true });
+                }
+                catch {
+                    // Backup doesn't exist or can't be removed
+                }
+            });
+            await Promise.all(backupCleanups);
             // Check if IDE folders should be fully deleted (empty settings + empty subfolders)
             let removedClaudeDir = false;
             let removedWindsurfDir = false;
@@ -920,4 +987,23 @@ export default class ClearCommand extends BaseCommand {
         });
         await Promise.all(ops);
     }
+    /**
+     * Remove shared IDE content (e.g., command files from _shared template).
+     *
+     * When all templates are removed, files installed from _shared/.claude/ and
+     * _shared/.windsurf/ should also be removed. Walks the shared template source
+     * and deletes matching files from the target, then prunes empty directories.
+     */
+    async removeSharedIdeContent(targetDir) {
+        const sharedTemplatePath = getSharedTemplatePath();
+        for (const ide of Object.values(IDE_FOLDERS)) {
+            const sharedIdeFolder = join(sharedTemplatePath, ide.root);
+            if (!(await pathExists(sharedIdeFolder)))
+                continue; // eslint-disable-line no-await-in-loop
+            const targetIdeFolder = join(targetDir, ide.root);
+            if (!(await pathExists(targetIdeFolder)))
+                continue; // eslint-disable-line no-await-in-loop
+            await removeMatchingFiles(sharedIdeFolder, targetIdeFolder); // eslint-disable-line no-await-in-loop
+        }
+    }
 }

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

@@ -1,38 +1,13 @@
 /**
  * BMAD installation configuration
  */
-export interface BmadInstallConfig {
+interface BmadInstallConfig {
     projectName: string;
     targetDir: string;
     username: string;
 }
-/**
- * Generate core module configuration YAML
- */
-export declare function generateCoreConfig(username: string): string;
-/**
- * Generate BMM module configuration YAML
- */
-export declare function generateBmmConfig(projectName: string, username: string): string;
-/**
- * Generate installation manifest YAML
- */
-export declare function generateManifest(): string;
 /**
  * Install BMAD structure in target directory
  */
 export declare function installBmad(config: BmadInstallConfig): Promise<void>;
-/**
- * Generate BMAD configuration files in the target directory.
- * Used as a post-install hook after template installation.
- *
- * @param targetDir - Directory where BMAD was installed
- * @param username - Username for configuration
- * @param projectName - Project name for configuration
- */
-export declare function generateBmadConfigs(targetDir: string, username: string, projectName: string): Promise<void>;
-/**
- * Detect username from git config or environment variables.
- * Priority: git config user.name > USER env > USERNAME env > fallback to "User"
- */
-export declare function detectUsername(): Promise<string>;
+export {};

package/dist/lib/bmad-installer.js

@@ -1,4 +1,3 @@
-import { execSync } from 'node:child_process';
 import { promises as fs } from 'node:fs';
 import { join } from 'node:path';
 import { copyDir } from './template-installer.js';
@@ -10,7 +9,7 @@ const BMAD_VERSION = '6.0.0-alpha.22';
 /**
  * Generate core module configuration YAML
  */
-export function generateCoreConfig(username) {
+function generateCoreConfig(username) {
     const now = new Date().toISOString();
     return `# CORE Module Configuration
 # Generated by AI Workflow CLI
@@ -26,7 +25,7 @@ output_folder: "{project-root}/_bmad-output"
 /**
  * Generate BMM module configuration YAML
  */
-export function generateBmmConfig(projectName, username) {
+function generateBmmConfig(projectName, username) {
     const now = new Date().toISOString();
     return `# BMM Module Configuration
 # Generated by AI Workflow CLI
@@ -51,7 +50,7 @@ output_folder: "{project-root}/_bmad-output"
 /**
  * Generate installation manifest YAML
  */
-export function generateManifest() {
+function generateManifest() {
     const now = new Date().toISOString();
     return `installation:
   version: ${BMAD_VERSION}
@@ -104,42 +103,3 @@ export async function installBmad(config) {
     await fs.writeFile(join(targetBmmPath, 'config.yaml'), generateBmmConfig(projectName, username), 'utf8');
     await fs.writeFile(join(targetConfigPath, 'manifest.yaml'), generateManifest(), 'utf8');
 }
-/**
- * Generate BMAD configuration files in the target directory.
- * Used as a post-install hook after template installation.
- *
- * @param targetDir - Directory where BMAD was installed
- * @param username - Username for configuration
- * @param projectName - Project name for configuration
- */
-export async function generateBmadConfigs(targetDir, username, projectName) {
-    const bmadPath = join(targetDir, '_bmad');
-    const coreConfigPath = join(bmadPath, 'core', 'config.yaml');
-    const bmmConfigPath = join(bmadPath, 'bmm', 'config.yaml');
-    const manifestPath = join(bmadPath, '_config', 'manifest.yaml');
-    await fs.writeFile(coreConfigPath, generateCoreConfig(username), 'utf8');
-    await fs.writeFile(bmmConfigPath, generateBmmConfig(projectName, username), 'utf8');
-    await fs.writeFile(manifestPath, generateManifest(), 'utf8');
-}
-/**
- * Detect username from git config or environment variables.
- * Priority: git config user.name > USER env > USERNAME env > fallback to "User"
- */
-export async function detectUsername() {
-    // Try git config first
-    try {
-        const gitUser = execSync('git config user.name', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] });
-        const username = gitUser.trim();
-        if (username)
-            return username;
-    }
-    catch {
-        // Git command failed or not configured, continue to env vars
-    }
-    // Try environment variables
-    const envUser = process.env['USER'] ?? process.env['USERNAME'];
-    if (envUser)
-        return envUser;
-    // Fallback
-    return 'User';
-}

package/dist/lib/claude-settings-types.d.ts

@@ -55,7 +55,7 @@ export type EnvConfig = Record<string, string>;
 /**
  * Method installation tracking metadata
  */
-export interface MethodTracking {
+interface MethodTracking {
     /** IDEs configured for this method */
     ides?: string[];
     /** ISO timestamp when method was installed */
@@ -102,3 +102,4 @@ export interface SettingsLocation {
     /** Type of settings file */
     type: SettingsFileType;
 }
+export {};

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

@@ -16,11 +16,3 @@ export declare function loadEnvWithCompatibility(): void;
  * Get AIW_DIR environment variable
  */
 export declare function getAiwDir(): string | undefined;
-/**
- * Get AIW_CONFIG environment variable
- */
-export declare function getAiwConfig(): string | undefined;
-/**
- * Check if using legacy environment variables
- */
-export declare function isUsingLegacyEnvVars(): boolean;

package/dist/lib/env-compat.js

@@ -21,15 +21,3 @@ export function loadEnvWithCompatibility() {
 export function getAiwDir() {
     return process.env['AIW_DIR'];
 }
-/**
- * Get AIW_CONFIG environment variable
- */
-export function getAiwConfig() {
-    return process.env['AIW_CONFIG'];
-}
-/**
- * Check if using legacy environment variables
- */
-export function isUsingLegacyEnvVars() {
-    return false;
-}

package/dist/lib/git/index.d.ts

@@ -7,5 +7,4 @@
  */
 export { branchExists, deleteBranch, getCurrentBranch, getMainBranch } from './branch.js';
 export { hasMergeRequest, hasUnpushedCommits } from './safety-checks.js';
-export type { GitCommandOptions, WorktreeInfo } from './types.js';
 export { createWorktree, deleteWorktreeFolder, getAllWorktrees, getWorktreePath } from './worktree.js';

package/dist/lib/gitignore-manager.d.ts

@@ -1,7 +1,5 @@
 /** Standard gitignore entries managed by AIW */
 export declare const AIW_GITIGNORE_ENTRIES: string[];
-/** Entries that should NEVER be removed from gitignore, even on clear */
-export declare const AIW_PERMANENT_ENTRIES: string[];
 /**
  * Prune stale entries from the AIW Installation section in .gitignore.
  * Checks each entry against disk existence and removes entries whose paths don't exist.

package/dist/lib/gitignore-manager.js

@@ -8,7 +8,7 @@ const AIW_GITIGNORE_HEADER = '# AIW Installation';
 /** Standard gitignore entries managed by AIW */
 export const AIW_GITIGNORE_ENTRIES = ['.aiwcli', '_output', '.claude', '.windsurf'];
 /** Entries that should NEVER be removed from gitignore, even on clear */
-export const AIW_PERMANENT_ENTRIES = ['_output'];
+const AIW_PERMANENT_ENTRIES = ['_output'];
 /**
  * Prune stale entries from the AIW Installation section in .gitignore.
  * Checks each entry against disk existence and removes entries whose paths don't exist.

package/dist/lib/hooks-merger.d.ts

@@ -1,18 +1,4 @@
-import type { ClaudeSettings, HooksConfig } from './claude-settings-types.js';
-/**
- * Merge hooks configurations from template into existing
- *
- * Strategy:
- * - For each event type in template hooks
- * - Concatenate with existing hooks for that event
- * - Deduplicate based on matcher configuration
- * - Maintain order: existing hooks first, then template hooks
- *
- * @param existing - Existing hooks configuration (will not be modified)
- * @param template - Template hooks configuration to merge
- * @returns New merged hooks configuration
- */
-export declare function mergeHooks(existing: HooksConfig | undefined, template: HooksConfig | undefined): HooksConfig;
+import type { ClaudeSettings } from './claude-settings-types.js';
 /**
  * Merge complete Claude settings configurations
  *

package/dist/lib/hooks-merger.js

@@ -31,7 +31,7 @@ function areHookMatchersEqual(a, b) {
  * @param template - Template hooks configuration to merge
  * @returns New merged hooks configuration
  */
-export function mergeHooks(existing, template) {
+function mergeHooks(existing, template) {
     return mergeConfigByEventType(existing, template, (existingMatchers, templateMatchers) => mergeArraysWithDedup(existingMatchers, templateMatchers, areHookMatchersEqual));
 }
 /**

package/dist/lib/index.d.ts

@@ -3,10 +3,6 @@
  * Re-exports all library modules from this barrel file.
  */
 export { type AiwcliConfig, getAiwDir, loadConfig, validateAiwDir, } from './config.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 { findWorkspaceRoot, isWorkspace, pathExists, resolvePath, } from './paths.js';
-export { spawnProcess, type SpawnProcessOptions } from './spawn.js';
-export { escapeShellArg, launchTerminal, type TerminalLaunchOptions, type TerminalLaunchResult, } from './terminal.js';
+export { debug, isDebugEnabled, setDebugEnabled } from './debug.js';
+export { AiwError, ConfigNotFoundError, EnvironmentError, } from './errors.js';
+export { isWorkspace, resolvePath, } from './paths.js';

package/dist/lib/index.js

@@ -5,16 +5,8 @@
 // Configuration resolution
 export { getAiwDir, loadConfig, validateAiwDir, } from './config.js';
 // Debug logging
-export { debug, debugSpawn, debugVersion, isDebugEnabled, setDebugEnabled } from './debug.js';
+export { debug, isDebugEnabled, setDebugEnabled } from './debug.js';
 // Custom error classes and utilities
-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';
+export { AiwError, ConfigNotFoundError, EnvironmentError, } from './errors.js';
 // Cross-platform path utilities
-export { findWorkspaceRoot, isWorkspace, pathExists, resolvePath, } from './paths.js';
-// Process spawning utilities
-export { spawnProcess } from './spawn.js';
-// Cross-platform terminal launching
-export { escapeShellArg, launchTerminal, } from './terminal.js';
+export { isWorkspace, resolvePath, } from './paths.js';

package/dist/lib/output.d.ts

@@ -10,7 +10,7 @@ import { type ProcessLike } from './tty-detection.js';
  * Dependencies for output functions.
  * Allows tests to inject mock values without mutating global state.
  */
-export interface OutputDependencies {
+interface OutputDependencies {
     proc?: ProcessLike;
 }
 /**
@@ -49,3 +49,4 @@ export declare function logWarning(message: string, quiet?: boolean, deps?: Outp
  * @param deps - Optional dependencies for testing
  */
 export declare function logDebug(message: string, deps?: OutputDependencies): void;
+export {};

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

@@ -1,16 +1,4 @@
-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[]>;
+import type { ClaudeSettings } from './claude-settings-types.js';
 /**
  * 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
  */
-export async function discoverSettingsFiles(projectDir) {
+async function discoverSettingsFiles(projectDir) {
     const locations = [];
     // User settings (global)
     const userSettingsPath = join(homedir(), '.claude', 'settings.json');

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

@@ -1,7 +1,7 @@
 /**
  * Configuration for template installation
  */
-export interface TemplateInstallConfig {
+interface TemplateInstallConfig {
     /** List of IDE names to install (e.g., ['claude', 'windsurf']) */
     ides: string[];
     /** Project name for configuration generation */
@@ -18,7 +18,7 @@ export interface TemplateInstallConfig {
 /**
  * Status of a single template item (file or folder)
  */
-export interface TemplateItemStatus {
+interface TemplateItemStatus {
     /** Whether the item exists in target directory */
     exists: boolean;
     /** Whether the item is a directory */
@@ -29,7 +29,7 @@ export interface TemplateItemStatus {
 /**
  * Result of checking template installation status
  */
-export interface TemplateInstallationStatus {
+interface TemplateInstallationStatus {
     /** Items that already exist in target directory */
     existing: TemplateItemStatus[];
     /** Items that are missing from target directory */
@@ -42,7 +42,7 @@ export interface TemplateInstallationStatus {
 /**
  * Result of template installation
  */
-export interface InstallationResult {
+interface InstallationResult {
     /** List of folder names that were installed (for gitignore) */
     installedFolders: string[];
     /** Whether shared settings were merged into IDE settings */
@@ -61,11 +61,6 @@ 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
  */
@@ -94,3 +89,4 @@ export declare function copyDir(src: string, dest: string, excludeIdeFolders?: b
  * @throws Error if template doesn't exist or requested IDE folder not found
  */
 export declare function installTemplate(config: TemplateInstallConfig): Promise<InstallationResult>;
+export {};

package/dist/lib/template-installer.js

@@ -75,24 +75,14 @@ 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.
  */
-export const EXCLUDED_PATTERNS = [
+const EXCLUDED_PATTERNS = new Set([
     '_output',
-    '__pycache__',
-    '.pytest_cache',
-    'conftest.py',
-    /^test_.*\.py$/,
-    /.*\.pyc$/,
-];
+]);
 /**
  * Check if a filename should be excluded from copying
  */
 export function shouldExclude(name) {
-    return EXCLUDED_PATTERNS.some((pattern) => {
-        if (typeof pattern === 'string') {
-            return name === pattern;
-        }
-        return pattern.test(name);
-    });
+    return EXCLUDED_PATTERNS.has(name);
 }
 /**
  * Copy directory recursively with proper error handling.

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

@@ -7,14 +7,14 @@
  * - Proper template references (_{method}/templates/)
  * - Correct workflow references (/method:workflow)
  */
-export interface LintViolation {
+interface LintViolation {
     file: string;
     line: number;
     match: string;
     message: string;
     rule: string;
 }
-export interface LintRule {
+interface LintRule {
     description: string;
     /** Message template - use {match} for the matched text */
     message: string;
@@ -31,19 +31,12 @@ export declare function getRulesForMethod(method: string): LintRule[];
  * Lint a single file's content
  */
 export declare function lintFileContent(content: string, filePath: string, rules: LintRule[]): LintViolation[];
-/**
- * Get all markdown files in a template method directory
- */
-export declare function getTemplateMarkdownFiles(templatesDir: string, method: string): string[];
 /**
  * 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
  */
 export declare function formatViolations(violations: LintViolation[], basePath?: string): string;
+export {};

package/dist/lib/template-linter.js

@@ -97,7 +97,7 @@ export function lintFileContent(content, filePath, rules) {
 /**
  * Get all markdown files in a template method directory
  */
-export function getTemplateMarkdownFiles(templatesDir, method) {
+function getTemplateMarkdownFiles(templatesDir, method) {
     const methodDir = path.join(templatesDir, method);
     const files = [];
     if (!existsSync(methodDir)) {
@@ -144,7 +144,7 @@ export function lintTemplateMethod(templatesDir, method) {
 /**
  * Lint all template methods in a templates directory
  */
-export function lintAllTemplates(templatesDir) {
+function lintAllTemplates(templatesDir) {
     const results = new Map();
     const methods = ['cc-native'];
     for (const method of methods) {

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

@@ -17,4 +17,10 @@ export declare function getTemplatePath(templateName: string): Promise<string>;
  * @returns Array of template names (e.g., ['bmad', 'gsr'])
  * @throws Error if templates directory cannot be read (indicates corrupted installation)
  */
+/**
+ * Get the absolute path to the _shared template directory.
+ *
+ * @returns Absolute path to the _shared template
+ */
+export declare function getSharedTemplatePath(): string;
 export declare function getAvailableTemplates(): Promise<string[]>;

package/dist/lib/template-resolver.js

@@ -43,6 +43,16 @@ export async function getTemplatePath(templateName) {
  * @returns Array of template names (e.g., ['bmad', 'gsr'])
  * @throws Error if templates directory cannot be read (indicates corrupted installation)
  */
+/**
+ * Get the absolute path to the _shared template directory.
+ *
+ * @returns Absolute path to the _shared template
+ */
+export function getSharedTemplatePath() {
+    const currentFilePath = fileURLToPath(import.meta.url);
+    const currentDir = dirname(currentFilePath);
+    return join(currentDir, '..', 'templates', '_shared');
+}
 export async function getAvailableTemplates() {
     const currentFileUrl = import.meta.url;
     const currentFilePath = fileURLToPath(currentFileUrl);

package/dist/lib/template-settings-reconstructor.d.ts

@@ -19,7 +19,7 @@
  *
  * The function:
  * 1. Starts with empty settings
- * 2. Merges _shared template settings (always included)
+ * 2. Merges _shared template settings (when active templates exist)
  * 3. For each active template, merges its template-source settings
  * 4. Writes the result to the IDE settings file
  *