specweave 0.22.14 → 0.23.0

package/CLAUDE.md

@@ -615,6 +615,53 @@ ls .specweave/docs/internal/architecture/adr/*.md | \
 # (Extracts unique numbers only, finds max, adds 1)
 ```
 
+### 13. Archiving Logic Anti-Patterns (CRITICAL!)
+
+**NEVER use string search or substring matching for structured data matching**
+
+#### Anti-Pattern #1: String Search for Frontmatter Fields
+
+```typescript
+// ❌ WRONG: Matches ANYWHERE in file (false positives!)
+const content = await fs.readFile('spec.md', 'utf-8');
+if (content.includes('FS-039')) {
+  // This matches:
+  // - feature_id: FS-039 ✓ (correct)
+  // - "See FS-039 for details" ✗ (FALSE POSITIVE!)
+  // - [Related](FS-039) ✗ (FALSE POSITIVE!)
+}
+
+// ✅ CORRECT: Parse frontmatter explicitly
+const featureIdMatch = content.match(/^feature_id:\s*["']?([^"'\n]+)["']?$/m);
+if (featureIdMatch && featureIdMatch[1].trim() === 'FS-039') {
+  // Only matches actual frontmatter field
+}
+```
+
+#### Anti-Pattern #2: Substring Matching for IDs
+
+```typescript
+// ❌ WRONG: Substring matching (false positives!)
+const isArchived = archivedList.some(item => item.includes(searchId));
+// "0039-ultra-smart-v2".includes("0039-ultra-smart") → TRUE (WRONG!)
+
+// ✅ CORRECT: Exact equality
+const isArchived = archivedList.some(item => item === searchId);
+```
+
+**Why This Matters**:
+- **Incident 2025-11-20**: String search caused 11 features to be incorrectly archived
+- Features that merely REFERENCED another feature appeared to BELONG to it
+- Substring matching confused similar IDs as identical
+
+**Prevention**:
+1. Always parse structured data (YAML frontmatter, JSON) explicitly
+2. Use exact equality (`===`) for ID matching, never `.includes()`
+3. Add comprehensive logging to show matching decisions
+4. Test with edge cases: references, links, partial matches
+
+**See Also**: `.specweave/increments/0047-us-task-linkage/reports/CRITICAL-ARCHIVING-BUGS-FIX.md`
+
 ---
 
 ## Project Structure
@@ -636,6 +683,123 @@ plugins/                # Claude Code components (skills, agents, commands, hook
 
 ---
 
+## Plugin Hook Registration (CRITICAL!)
+
+**When**: Adding or modifying hooks that respond to Claude Code tool events
+
+**Hook Schema Rules** (v0.22.14+):
+1. ✅ **ONLY use valid Claude Code hook events** (e.g., PostToolUse, PreToolUse, SessionStart)
+2. ❌ **NEVER use custom hook names** (e.g., "TodoWrite") as hook events
+3. ✅ **Use matchers** to filter which tool calls trigger the hook
+
+### Valid Claude Code Hook Events
+
+Claude Code supports **only these 10 hook events**:
+- `PostToolUse` - After a tool completes (use this for TodoWrite, Write, Edit, etc.)
+- `PreToolUse` - Before a tool executes
+- `PermissionRequest` - When permission dialogs appear
+- `Notification` - When notifications are sent
+- `UserPromptSubmit` - When users submit prompts
+- `Stop` - When the main agent finishes
+- `SubagentStop` - When subagents finish
+- `PreCompact` - Before compaction operations
+- `SessionStart` - At session initialization
+- `SessionEnd` - When sessions terminate
+
+### Correct Hook Registration Format
+
+**File**: `plugins/*/. claude-plugin/plugin.json`
+
+```json
+{
+  "name": "specweave",
+  "version": "0.22.14",
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "TodoWrite",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-task-completion.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+**Schema Breakdown**:
+| Field | Type | Purpose |
+|-------|------|---------|
+| `PostToolUse` | array | Hook event (one of 10 valid events above) |
+| `matcher` | string | Tool name pattern (e.g., "TodoWrite", "Write\|Edit") |
+| `type` | string | Always "command" for shell scripts |
+| `command` | string | Script path (use `${CLAUDE_PLUGIN_ROOT}` for plugin directory) |
+| `timeout` | number | Seconds before timeout (default: 30) |
+
+### Common Mistakes (v0.22.13 Bug)
+
+❌ **WRONG** (Invalid hook event):
+```json
+{
+  "hooks": {
+    "TodoWrite": {
+      "post": "./hooks/post-task-completion.sh"
+    }
+  }
+}
+```
+**Error**: `"TodoWrite"` is not a valid Claude Code hook event
+
+✅ **CORRECT** (Use PostToolUse with matcher):
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "TodoWrite",
+        "hooks": [{"type": "command", "command": "..."}]
+      }
+    ]
+  }
+}
+```
+
+### Testing Hook Registration
+
+```bash
+# 1. Update plugin.json with correct schema
+vim plugins/specweave/.claude-plugin/plugin.json
+
+# 2. Commit and push
+git add plugins/specweave/.claude-plugin/plugin.json
+git commit -m "fix: correct hook registration schema"
+git push origin develop
+
+# 3. Wait 5-10 seconds for marketplace auto-update
+
+# 4. Force refresh marketplace (if needed)
+cd ~/.claude/plugins/marketplaces
+rm -rf specweave
+git clone https://github.com/YOUR_USERNAME/specweave.git
+
+# 5. Restart Claude Code
+
+# 6. Verify no plugin loading errors
+# Should NOT see: "hooks: Invalid input" error
+```
+
+### Documentation References
+
+- **Claude Code Plugin Hooks**: https://code.claude.com/docs/en/hooks.md
+- **Hooks Reference**: https://code.claude.com/docs/en/hooks-reference.md
+- **Fix History**: See CHANGELOG.md v0.22.14 for the hook schema bug fix
+
+---
+
 ## Development Workflow
 
 ### Core Commands
@@ -695,10 +859,23 @@ claude plugin marketplace update specweave
 
 ```bash
 npm run rebuild    # Clean + build (use this during development)
-npm run build      # Compile TypeScript
+npm run build      # Compile TypeScript + copy hook dependencies
 npm run clean      # Remove dist/
 ```
 
+**Build Architecture**:
+1. `tsc` compiles `src/**/*.ts` → `dist/src/**/*.js`
+2. `copy:locales` copies translation files
+3. `copy:plugins` compiles plugin TypeScript with esbuild
+4. `copy:hook-deps` **NEW**: Copies hook dependencies to vendor/
+
+**Hook Dependencies** (NEW in v0.22.15):
+- Problem: Hooks imported from `../../../../dist/src/...` (failed in marketplace)
+- Solution: Copy compiled files to `plugins/*/lib/vendor/`
+- Hooks now import from `../vendor/...` (self-contained)
+- Script: `scripts/copy-hook-dependencies.js`
+- Auto-detect deps: `scripts/find-hook-dependencies.js`
+
 **Critical**: Always import with `.js` extensions:
 ```typescript
 // ✅ CORRECT

package/dist/src/cli/commands/import-external.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CLI Command: /specweave:import-external
+ *
+ * Import external work items from GitHub, JIRA, or Azure DevOps
+ */
+export interface ImportExternalArgs {
+    /** Time range filter */
+    since?: 'last' | '1m' | '3m' | '6m' | 'all' | string;
+    /** Import from GitHub only */
+    githubOnly?: boolean;
+    /** Import from JIRA only */
+    jiraOnly?: boolean;
+    /** Import from Azure DevOps only */
+    adoOnly?: boolean;
+    /** Dry run mode (preview only) */
+    dryRun?: boolean;
+}
+/**
+ * Import external work items
+ */
+export declare function importExternal(projectRoot: string, args: ImportExternalArgs): Promise<void>;
+//# sourceMappingURL=import-external.d.ts.map

package/dist/src/cli/commands/import-external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-external.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/import-external.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;IAErD,8BAA8B;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAiHD;;GAEG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4LjG"}

package/dist/src/cli/commands/import-external.js

@@ -0,0 +1,282 @@
+/**
+ * CLI Command: /specweave:import-external
+ *
+ * Import external work items from GitHub, JIRA, or Azure DevOps
+ */
+import inquirer from 'inquirer';
+import ora from 'ora';
+import chalk from 'chalk';
+import { ImportCoordinator } from '../../importers/import-coordinator.js';
+import { ItemConverter } from '../../importers/item-converter.js';
+import { getLastImportTimestamp } from '../../sync/sync-metadata.js';
+import { RateLimiter } from '../../importers/rate-limiter.js';
+import { shouldConfirmLargeImport } from '../../importers/rate-limiter.js';
+import path from 'path';
+import fs from 'fs-extra';
+/**
+ * Detect configured external tools from environment
+ */
+function detectConfiguredTools() {
+    const config = {};
+    // GitHub detection
+    const githubToken = process.env.GITHUB_TOKEN;
+    if (githubToken) {
+        // Try to parse git remote
+        const gitConfigPath = path.join(process.cwd(), '.git', 'config');
+        if (fs.existsSync(gitConfigPath)) {
+            const gitConfig = fs.readFileSync(gitConfigPath, 'utf-8');
+            const remoteMatch = gitConfig.match(/url\s*=\s*(?:https?:\/\/github\.com\/|git@github\.com:)([^/]+)\/([^.\n]+)/);
+            if (remoteMatch) {
+                config.github = {
+                    owner: remoteMatch[1],
+                    repo: remoteMatch[2],
+                    token: githubToken,
+                };
+            }
+        }
+    }
+    // JIRA detection
+    const jiraHost = process.env.JIRA_HOST;
+    const jiraEmail = process.env.JIRA_EMAIL;
+    const jiraApiToken = process.env.JIRA_API_TOKEN;
+    if (jiraHost) {
+        config.jira = {
+            host: jiraHost,
+            email: jiraEmail,
+            apiToken: jiraApiToken,
+        };
+    }
+    // Azure DevOps detection
+    const adoOrgUrl = process.env.ADO_ORG_URL;
+    const adoProject = process.env.ADO_PROJECT;
+    const adoPat = process.env.ADO_PAT;
+    if (adoOrgUrl && adoProject) {
+        config.ado = {
+            orgUrl: adoOrgUrl,
+            project: adoProject,
+            pat: adoPat,
+        };
+    }
+    return config;
+}
+/**
+ * Parse time range filter to import config
+ */
+function parseTimeRange(since, platform, projectRoot) {
+    if (since === 'all') {
+        return undefined; // No time filter
+    }
+    if (since === 'last') {
+        // Use last import timestamp from sync metadata
+        const lastImport = getLastImportTimestamp(projectRoot, platform);
+        if (!lastImport) {
+            // No previous import, default to 1 month
+            return 1;
+        }
+        // Calculate months since last import
+        const lastImportDate = new Date(lastImport);
+        const now = new Date();
+        const monthsSince = (now.getTime() - lastImportDate.getTime()) / (1000 * 60 * 60 * 24 * 30);
+        return Math.ceil(monthsSince);
+    }
+    // Parse relative time ranges (1m, 3m, 6m)
+    const monthMatch = since.match(/^(\d+)m$/);
+    if (monthMatch) {
+        return parseInt(monthMatch[1], 10);
+    }
+    // Parse absolute date (ISO format: YYYY-MM-DD)
+    const dateMatch = since.match(/^\d{4}-\d{2}-\d{2}$/);
+    if (dateMatch) {
+        const targetDate = new Date(since);
+        const now = new Date();
+        const monthsSince = (now.getTime() - targetDate.getTime()) / (1000 * 60 * 60 * 24 * 30);
+        return Math.ceil(monthsSince);
+    }
+    // Default: 1 month
+    return 1;
+}
+/**
+ * Get platform emoji
+ */
+function getPlatformEmoji(platform) {
+    switch (platform) {
+        case 'github':
+            return '🔗';
+        case 'jira':
+            return '🎫';
+        case 'ado':
+            return '📋';
+    }
+}
+/**
+ * Import external work items
+ */
+export async function importExternal(projectRoot, args) {
+    console.log(chalk.bold('\n📥 Import External Work Items\n'));
+    try {
+        // Detect configured tools
+        const configuredTools = detectConfiguredTools();
+        // Apply platform filters
+        const config = {};
+        if (args.githubOnly) {
+            if (configuredTools.github) {
+                config.github = configuredTools.github;
+            }
+        }
+        else if (args.jiraOnly) {
+            if (configuredTools.jira) {
+                config.jira = configuredTools.jira;
+            }
+        }
+        else if (args.adoOnly) {
+            if (configuredTools.ado) {
+                config.ado = configuredTools.ado;
+            }
+        }
+        else {
+            // All platforms
+            Object.assign(config, configuredTools);
+        }
+        // Validate at least one platform configured
+        if (!config.github && !config.jira && !config.ado) {
+            throw new Error('No external platforms configured.\n\n' +
+                '💡 Ensure one of these is set:\n' +
+                '   - GitHub: GITHUB_TOKEN + .git/config remote\n' +
+                '   - JIRA: JIRA_HOST + JIRA_EMAIL + JIRA_API_TOKEN\n' +
+                '   - Azure DevOps: ADO_ORG_URL + ADO_PROJECT + ADO_PAT');
+        }
+        // Determine time range (default: since last import)
+        const since = args.since || 'last';
+        // Configure import coordinator
+        const importConfig = {
+            timeRangeMonths: parseTimeRange(since, 'github', projectRoot),
+        };
+        const coordinatorConfig = {
+            ...config,
+            importConfig,
+            projectRoot,
+            enableSyncMetadata: !args.dryRun, // Only update sync metadata if not dry run
+            enableRateLimiting: true,
+            onProgress: (platform, count, total) => {
+                // Progress callback handled by spinner
+            },
+            onRateLimitWarning: (platform, rateLimitInfo) => {
+                const rateLimiter = new RateLimiter();
+                console.log(chalk.yellow(`\n${rateLimiter.formatWarning(rateLimitInfo)}\n`));
+            },
+            onRateLimitPause: (platform, seconds) => {
+                const rateLimiter = new RateLimiter();
+                console.log(chalk.yellow(`\n${rateLimiter.formatPauseMessage(platform, seconds)}\n`));
+            },
+        };
+        // Create import coordinator
+        const coordinator = new ImportCoordinator(coordinatorConfig);
+        const platforms = coordinator.getConfiguredPlatforms();
+        // Show configuration summary
+        if (!args.dryRun) {
+            console.log(chalk.dim('📋 Import Configuration:\n'));
+            console.log(chalk.dim(`  Platforms: ${platforms.map(p => p.toUpperCase()).join(', ')}`));
+            console.log(chalk.dim(`  Time range: ${since}`));
+            console.log(chalk.dim(`  Dry run: ${args.dryRun ? 'Yes' : 'No'}\n`));
+        }
+        // Import from all platforms
+        const allItems = [];
+        const platformCounts = {};
+        const platformSpinners = {};
+        for (const platform of platforms) {
+            const spinner = ora({
+                text: `Importing from ${platform.toUpperCase()}...`,
+                color: 'cyan',
+            }).start();
+            platformSpinners[platform] = spinner;
+            try {
+                const result = await coordinator.importFrom(platform);
+                allItems.push(...result.items);
+                platformCounts[platform] = result.items.length;
+                spinner.succeed(`${getPlatformEmoji(platform)} Imported from ${platform.toUpperCase()}: ${result.items.length} items`);
+                if (result.errors.length > 0) {
+                    console.log(chalk.yellow(`  ⚠️  Warnings: ${result.errors.join(', ')}`));
+                }
+            }
+            catch (error) {
+                spinner.fail(`Failed to import from ${platform.toUpperCase()}: ${error.message}`);
+            }
+        }
+        // Check for large imports (> 100 items)
+        if (!args.dryRun && shouldConfirmLargeImport(allItems.length)) {
+            console.log(chalk.yellow(`\n⚠️  Found ${allItems.length} items to import:`));
+            for (const platform of platforms) {
+                console.log(chalk.yellow(`   - ${platform.toUpperCase()}: ${platformCounts[platform]} items`));
+            }
+            console.log(chalk.yellow('\n   This may take 5-10 minutes and use significant API quota.\n'));
+            const { confirm } = await inquirer.prompt([
+                {
+                    type: 'confirm',
+                    name: 'confirm',
+                    message: 'Continue?',
+                    default: true,
+                },
+            ]);
+            if (!confirm) {
+                console.log(chalk.red('\n❌ Import cancelled\n'));
+                return;
+            }
+        }
+        // Convert items to living docs (or preview in dry-run mode)
+        const specsDir = path.join(projectRoot, '.specweave', 'docs', 'internal', 'specs');
+        let convertedCount = 0;
+        let skippedCount = 0;
+        if (args.dryRun) {
+            console.log(chalk.cyan('\n🔍 Dry run - no files will be created\n'));
+        }
+        else {
+            const converter = new ItemConverter({
+                specsDir,
+                projectRoot,
+                enableFeatureAllocation: true,
+                enableDuplicateDetection: true,
+                onDuplicateSkipped: (externalId, existingUsId) => {
+                    console.log(chalk.dim(`  ⏭️  Skipped duplicate: ${externalId} (already imported as ${existingUsId})`));
+                },
+            });
+            const conversionSpinner = ora('Converting items to living docs...').start();
+            try {
+                const converted = await converter.convertItems(allItems);
+                convertedCount = converted.length;
+                skippedCount = allItems.length - convertedCount;
+                conversionSpinner.succeed(`Converted ${convertedCount} items to living docs`);
+            }
+            catch (error) {
+                conversionSpinner.fail(`Conversion failed: ${error.message}`);
+                throw error;
+            }
+        }
+        // Display summary report
+        console.log(chalk.bold('\n📊 Import Summary:\n'));
+        if (args.dryRun) {
+            console.log(chalk.cyan('   Preview:'));
+            for (const platform of platforms) {
+                console.log(`   ${getPlatformEmoji(platform)} ${platform.toUpperCase()}: ${platformCounts[platform]} items`);
+            }
+            console.log(`   Total: ${allItems.length} items`);
+            console.log(chalk.dim('\n   ⚠️  Remove --dry-run to perform actual import\n'));
+        }
+        else {
+            console.log(`   Total imported: ${chalk.green(convertedCount)} items`);
+            for (const platform of platforms) {
+                console.log(`   ${getPlatformEmoji(platform)} ${platform.toUpperCase()}: ${platformCounts[platform]} items`);
+            }
+            if (skippedCount > 0) {
+                console.log(chalk.dim(`\n   Duplicates skipped: ${skippedCount} items`));
+            }
+            console.log(chalk.green('\n✅ Import complete!'));
+            console.log(chalk.dim(`   Living docs updated: ${specsDir}`));
+            console.log(chalk.dim(`   Sync metadata updated: ${path.join(projectRoot, '.specweave', 'sync-metadata.json')}\n`));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red(`\n❌ Import failed: ${error.message}\n`));
+        throw error;
+    }
+}
+//# sourceMappingURL=import-external.js.map

package/dist/src/cli/commands/import-external.js.map

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

package/dist/src/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAc9D,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA8ID,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAwyCf"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAgB9D,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA8ID,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAwyCf"}

package/dist/src/cli/commands/init.js

@@ -19,6 +19,8 @@ import { ItemConverter } from '../../importers/item-converter.js';
 import { loadImportConfig } from '../../config/import-config.js';
 const __dirname = getDirname(import.meta.url);
 import { readEnvFile, parseEnvFile } from '../../utils/env-file.js';
+import { selectRepositories } from '../helpers/github-repo-selector.js';
+import { Octokit } from '@octokit/rest';
 /**
  * Detect if we're in the SpecWeave framework repository itself
  * (development mode vs. user project mode)
@@ -1518,6 +1520,50 @@ async function promptAndRunExternalImport(targetDir, isCI) {
             platforms: []
         };
     }
+    // US-011: Multi-Repo Selection for GitHub (if GitHub detected and token available)
+    let repoSelectionConfig = null;
+    if (githubRemote && process.env.GITHUB_TOKEN) {
+        const { useMultiRepo } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'useMultiRepo',
+                message: 'Do you want to import from multiple repositories?',
+                default: false
+            }
+        ]);
+        if (useMultiRepo) {
+            try {
+                const octokit = new Octokit({ auth: process.env.GITHUB_TOKEN });
+                repoSelectionConfig = await selectRepositories(octokit, process.env.GITHUB_TOKEN);
+                if (repoSelectionConfig) {
+                    // Save to config.json for future imports
+                    const configPath = path.join(targetDir, '.specweave', 'config.json');
+                    let config = {};
+                    if (fs.existsSync(configPath)) {
+                        config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+                    }
+                    if (!config.github) {
+                        config.github = {};
+                    }
+                    config.github.repositories = repoSelectionConfig.repositories;
+                    config.github.selectionStrategy = repoSelectionConfig.selectionStrategy;
+                    if (repoSelectionConfig.pattern) {
+                        config.github.pattern = repoSelectionConfig.pattern;
+                    }
+                    if (repoSelectionConfig.organizationName) {
+                        config.github.organizationName = repoSelectionConfig.organizationName;
+                    }
+                    fs.ensureDirSync(path.dirname(configPath));
+                    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+                    console.log(chalk.green(`✅ Repository selection saved to config.json\n`));
+                }
+            }
+            catch (error) {
+                console.error(chalk.yellow(`⚠️  Failed to select repositories: ${error instanceof Error ? error.message : String(error)}`));
+                console.log(chalk.gray('Continuing with single repository import...\n'));
+            }
+        }
+    }
     // Map config timeRangeMonths to closest prompt option
     let defaultTimeRange = 3; // Default to 3 months
     if (importConfig.timeRangeMonths === 1)