@planu/cli 0.30.1 → 0.31.0

package/dist/engine/github/review-analyzer.js

@@ -0,0 +1,146 @@
+// engine/github/review-analyzer.ts — Analyze PR diffs for review findings.
+// Security patterns to detect in diffs
+const SECURITY_PATTERNS = [
+    {
+        pattern: /eval\s*\(/,
+        message: 'Use of eval() detected',
+        suggestion: 'Avoid eval(); use safer alternatives like JSON.parse()',
+    },
+    {
+        pattern: /innerHTML\s*=/,
+        message: 'Direct innerHTML assignment',
+        suggestion: 'Use textContent or a sanitization library',
+    },
+    {
+        pattern: /password\s*[:=]\s*['"][^'"]+['"]/,
+        message: 'Hardcoded password detected',
+        suggestion: 'Use environment variables for secrets',
+    },
+    {
+        pattern: /(?:api[_-]?key|secret|token)\s*[:=]\s*['"][^'"]+['"]/,
+        message: 'Hardcoded secret/token detected',
+        suggestion: 'Use environment variables for secrets',
+    },
+    {
+        pattern: /disable.*ssl|verify\s*=\s*false/i,
+        message: 'SSL verification disabled',
+        suggestion: 'Enable SSL verification in production',
+    },
+    {
+        pattern: /exec\s*\(.*\$/,
+        message: 'Shell command with variable interpolation',
+        suggestion: 'Sanitize inputs before shell execution',
+    },
+];
+// Performance patterns to detect in diffs
+const PERFORMANCE_PATTERNS = [
+    {
+        pattern: /\.forEach\s*\(.*\.forEach/,
+        message: 'Nested forEach detected (O(n^2))',
+        suggestion: 'Consider using a Map or Set for lookups',
+    },
+    {
+        pattern: /JSON\.parse\(JSON\.stringify/,
+        message: 'Deep clone via JSON roundtrip',
+        suggestion: 'Use structuredClone() or a dedicated deep-clone utility',
+    },
+    {
+        pattern: /new RegExp\(/,
+        message: 'RegExp created in a loop or hot path',
+        suggestion: 'Pre-compile RegExp outside the loop',
+    },
+];
+/**
+ * Parse a unified diff to extract file-level stats.
+ */
+export function parseDiffStats(diff) {
+    const files = [];
+    let additions = 0;
+    let deletions = 0;
+    for (const line of diff.split('\n')) {
+        if (line.startsWith('diff --git')) {
+            const match = /b\/(.+)$/.exec(line);
+            if (match?.[1]) {
+                files.push(match[1]);
+            }
+        }
+        else if (line.startsWith('+') && !line.startsWith('+++')) {
+            additions++;
+        }
+        else if (line.startsWith('-') && !line.startsWith('---')) {
+            deletions++;
+        }
+    }
+    return { filesChanged: files.length, additions, deletions, files };
+}
+/**
+ * Analyze a diff for review findings based on review type.
+ */
+export function analyzeDiff(diff, reviewType) {
+    const findings = [];
+    const lines = diff.split('\n');
+    let currentFile = '';
+    let lineNumber = 0;
+    for (const line of lines) {
+        if (line.startsWith('diff --git')) {
+            const match = /b\/(.+)$/.exec(line);
+            currentFile = match?.[1] ?? '';
+            lineNumber = 0;
+            continue;
+        }
+        const hunkMatch = /^@@\s+-\d+(?:,\d+)?\s+\+(\d+)/.exec(line);
+        if (hunkMatch?.[1]) {
+            lineNumber = Number(hunkMatch[1]);
+            continue;
+        }
+        if (line.startsWith('+') && !line.startsWith('+++')) {
+            const patterns = getPatterns(reviewType);
+            for (const { pattern, message, suggestion } of patterns) {
+                if (pattern.test(line)) {
+                    findings.push({
+                        file: currentFile,
+                        line: lineNumber,
+                        severity: reviewType === 'security' ? 'critical' : 'warning',
+                        category: reviewType,
+                        message,
+                        suggestion,
+                    });
+                }
+            }
+            lineNumber++;
+        }
+        else if (!line.startsWith('-')) {
+            lineNumber++;
+        }
+    }
+    return findings;
+}
+function getPatterns(reviewType) {
+    switch (reviewType) {
+        case 'security':
+            return SECURITY_PATTERNS;
+        case 'performance':
+            return PERFORMANCE_PATTERNS;
+        case 'detailed':
+            return [...SECURITY_PATTERNS, ...PERFORMANCE_PATTERNS];
+        case 'summary':
+        default:
+            return [];
+    }
+}
+/**
+ * Generate a summary finding for the overall diff.
+ */
+export function generateSummaryFinding(filesChanged, additions, deletions) {
+    const complexity = additions + deletions > 500 ? 'warning' : 'info';
+    return {
+        file: '(overall)',
+        severity: complexity,
+        category: 'summary',
+        message: `${String(filesChanged)} files changed, +${String(additions)} -${String(deletions)} lines`,
+        suggestion: additions + deletions > 500
+            ? 'Consider splitting this PR into smaller, focused changes'
+            : 'PR size looks manageable',
+    };
+}
+//# sourceMappingURL=review-analyzer.js.map

package/dist/engine/github/review-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-analyzer.js","sourceRoot":"","sources":["../../../src/engine/github/review-analyzer.ts"],"names":[],"mappings":"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"}

package/dist/engine/github/spec-linker.d.ts

@@ -0,0 +1,18 @@
+import type { GitPlatformClient, PRStatusResult, SpecPRLink } from '../../types/github.js';
+/**
+ * Extract spec IDs from a string (title, body, branch name).
+ */
+export declare function extractSpecIds(text: string): string[];
+/**
+ * Find PRs linked to a given spec ID by checking branch names and titles.
+ */
+export declare function findLinkedPRs(client: GitPlatformClient, specId: string): Promise<PRStatusResult[]>;
+/**
+ * Given a PR, identify which spec(s) it is implementing.
+ */
+export declare function identifySpecsFromPR(pr: PRStatusResult): string[];
+/**
+ * Build a SpecPRLink from a spec ID and associated PRs/issues.
+ */
+export declare function buildSpecLink(specId: string, prs: PRStatusResult[], issueNumbers?: number[]): SpecPRLink;
+//# sourceMappingURL=spec-linker.d.ts.map

package/dist/engine/github/spec-linker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-linker.d.ts","sourceRoot":"","sources":["../../../src/engine/github/spec-linker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAI3F;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAUrD;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,EAAE,CAAC,CAc3B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,EAAE,CAKhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,cAAc,EAAE,EACrB,YAAY,GAAE,MAAM,EAAO,GAC1B,UAAU,CAOZ"}

package/dist/engine/github/spec-linker.js

@@ -0,0 +1,54 @@
+// engine/github/spec-linker.ts — Link specs to PRs and issues automatically.
+const SPEC_PATTERN = /SPEC-(\d+)/gi;
+/**
+ * Extract spec IDs from a string (title, body, branch name).
+ */
+export function extractSpecIds(text) {
+    const matches = text.matchAll(SPEC_PATTERN);
+    const ids = new Set();
+    for (const match of matches) {
+        const num = match[1];
+        if (num) {
+            ids.add(`SPEC-${num}`);
+        }
+    }
+    return [...ids];
+}
+/**
+ * Find PRs linked to a given spec ID by checking branch names and titles.
+ */
+export async function findLinkedPRs(client, specId) {
+    const allPRs = await client.getPRStatus();
+    const specNum = specId.replace(/^SPEC-/i, '');
+    const pattern = new RegExp(`SPEC-${specNum}`, 'i');
+    return allPRs.filter((pr) => {
+        if (pattern.test(pr.branch)) {
+            return true;
+        }
+        if (pattern.test(pr.title)) {
+            return true;
+        }
+        return false;
+    });
+}
+/**
+ * Given a PR, identify which spec(s) it is implementing.
+ */
+export function identifySpecsFromPR(pr) {
+    const fromBranch = extractSpecIds(pr.branch);
+    const fromTitle = extractSpecIds(pr.title);
+    const combined = new Set([...fromBranch, ...fromTitle]);
+    return [...combined];
+}
+/**
+ * Build a SpecPRLink from a spec ID and associated PRs/issues.
+ */
+export function buildSpecLink(specId, prs, issueNumbers = []) {
+    return {
+        specId,
+        prNumbers: prs.map((pr) => pr.number),
+        issueNumbers,
+        lastUpdated: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=spec-linker.js.map

package/dist/engine/github/spec-linker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-linker.js","sourceRoot":"","sources":["../../../src/engine/github/spec-linker.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAI7E,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,GAAG,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAyB,EACzB,MAAc;IAEd,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,QAAQ,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;IAEnD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;QAC1B,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAkB;IACpD,MAAM,UAAU,GAAG,cAAc,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,GAAqB,EACrB,eAAyB,EAAE;IAE3B,OAAO;QACL,MAAM;QACN,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC;QACrC,YAAY;QACZ,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;AACJ,CAAC"}

package/dist/engine/ide-config/core.d.ts

@@ -0,0 +1,14 @@
+import type { GenerateIdeConfigInput, GenerateIdeConfigResult, IdeRegistry } from '../../types/index.js';
+/**
+ * Load the IDE registry from the bundled JSON file.
+ */
+export declare function loadIdeRegistry(): IdeRegistry;
+/**
+ * Merge planu config into an existing JSON config file without overwriting other entries.
+ */
+export declare function mergeJsonConfig(existingContent: string, newContent: string, wrapperKey: string): string;
+/**
+ * Main entry point: generate IDE config for one or all detected IDEs.
+ */
+export declare function handleGenerateIdeConfig(input: GenerateIdeConfigInput): GenerateIdeConfigResult;
+//# sourceMappingURL=core.d.ts.map

package/dist/engine/ide-config/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/engine/ide-config/core.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,sBAAsB,EACtB,uBAAuB,EAEvB,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAM9B;;GAEG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAI7C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,MAAM,CAUR;AAiED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,sBAAsB,GAAG,uBAAuB,CA2B9F"}

package/dist/engine/ide-config/core.js

@@ -0,0 +1,103 @@
+// engine/ide-config/core.ts — Orchestrator for IDE config generation (SPEC-080 AC-10)
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { generateIdeConfig } from './generators.js';
+import { detectAllIdes, getDetectedIdes } from './detector.js';
+import { validateConfig } from './validator.js';
+import { detectPlatform, expandHome } from './path-resolver.js';
+/**
+ * Load the IDE registry from the bundled JSON file.
+ */
+export function loadIdeRegistry() {
+    const registryPath = new URL('../../config/ide-registry.json', import.meta.url);
+    const raw = readFileSync(registryPath, 'utf-8');
+    return JSON.parse(raw);
+}
+/**
+ * Merge planu config into an existing JSON config file without overwriting other entries.
+ */
+export function mergeJsonConfig(existingContent, newContent, wrapperKey) {
+    const existing = JSON.parse(existingContent);
+    const incoming = JSON.parse(newContent);
+    /* v8 ignore next 2 */
+    const existingServers = existing[wrapperKey] ?? {};
+    const incomingServers = incoming[wrapperKey] ?? {};
+    existing[wrapperKey] = { ...existingServers, ...incomingServers };
+    return JSON.stringify(existing, null, 2);
+}
+/**
+ * Write config to disk, merging if the file already exists.
+ */
+function writeConfig(filePath, content, ide) {
+    const resolvedPath = expandHome(filePath);
+    const dir = dirname(resolvedPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    if (existsSync(resolvedPath) && ide.configFormat === 'json') {
+        try {
+            const existing = readFileSync(resolvedPath, 'utf-8');
+            const merged = mergeJsonConfig(existing, content, ide.wrapperKey);
+            writeFileSync(resolvedPath, merged, 'utf-8');
+            return { finalContent: merged, merged: true };
+        }
+        catch {
+            // If existing file is malformed, overwrite
+            writeFileSync(resolvedPath, content, 'utf-8');
+            return { finalContent: content, merged: false };
+        }
+    }
+    writeFileSync(resolvedPath, content, 'utf-8');
+    return { finalContent: content, merged: false };
+}
+/**
+ * Process a single IDE: generate config, optionally write, validate.
+ */
+function processIde(ide, input, platform) {
+    const projectPath = resolve(input.projectPath);
+    const generated = generateIdeConfig(ide, input.scope, platform, projectPath);
+    const validationErrors = input.dryRun ? [] : validateConfig(generated, ide);
+    let finalContent = generated.content;
+    let merged = false;
+    if (!input.dryRun) {
+        const result = writeConfig(generated.filePath, generated.content, ide);
+        finalContent = result.finalContent;
+        merged = result.merged;
+    }
+    return {
+        ide: ide.id,
+        filePath: generated.filePath,
+        content: finalContent,
+        merged,
+        instructions: generated.instructions,
+        validationErrors,
+    };
+}
+/**
+ * Main entry point: generate IDE config for one or all detected IDEs.
+ */
+export function handleGenerateIdeConfig(input) {
+    const registry = loadIdeRegistry();
+    const platform = detectPlatform();
+    const projectPath = resolve(input.projectPath);
+    // Detect all IDEs
+    const allDetections = detectAllIdes(registry.ides, platform, projectPath);
+    const detectedIdes = getDetectedIdes(allDetections);
+    // Determine which IDEs to generate for
+    let targetIdes;
+    if (input.ide === 'auto') {
+        const detectedIds = new Set(detectedIdes.map((d) => d.ide));
+        targetIdes = registry.ides.filter((ide) => detectedIds.has(ide.id));
+    }
+    else {
+        const found = registry.ides.find((ide) => ide.id === input.ide);
+        targetIdes = found ? [found] : [];
+    }
+    const results = targetIdes.map((ide) => processIde(ide, input, platform));
+    return {
+        results,
+        detectedIdes,
+        dryRun: input.dryRun,
+    };
+}
+//# sourceMappingURL=core.js.map

package/dist/engine/ide-config/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/engine/ide-config/core.ts"],"names":[],"mappings":"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"}

package/dist/engine/ide-config/detector.d.ts

@@ -0,0 +1,18 @@
+import type { IdeDefinition, IdeDetectionResult, IdePlatform } from '../../types/index.js';
+/**
+ * Check if a binary is available in PATH.
+ */
+export declare function isBinaryInPath(binary: string): boolean;
+/**
+ * Detect a single IDE.
+ */
+export declare function detectIde(ide: IdeDefinition, platform: IdePlatform, projectPath: string): IdeDetectionResult;
+/**
+ * Detect all IDEs from the registry.
+ */
+export declare function detectAllIdes(ides: readonly IdeDefinition[], platform: IdePlatform, projectPath: string): IdeDetectionResult[];
+/**
+ * Filter to only detected IDEs, sorted by confidence (project > config > installed).
+ */
+export declare function getDetectedIdes(results: readonly IdeDetectionResult[]): IdeDetectionResult[];
+//# sourceMappingURL=detector.d.ts.map

package/dist/engine/ide-config/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/engine/ide-config/detector.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAElB,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAStD;AAuBD;;GAEG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,WAAW,EACrB,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAsCpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,aAAa,EAAE,EAC9B,QAAQ,EAAE,WAAW,EACrB,WAAW,EAAE,MAAM,GAClB,kBAAkB,EAAE,CAEtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAS5F"}

package/dist/engine/ide-config/detector.js

@@ -0,0 +1,97 @@
+// engine/ide-config/detector.ts — Auto-detect installed IDEs (SPEC-080 AC-09)
+import { existsSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+/**
+ * Check if a binary is available in PATH.
+ */
+export function isBinaryInPath(binary) {
+    try {
+        /* v8 ignore next 1 */
+        const cmd = process.platform === 'win32' ? `where ${binary}` : `which ${binary}`;
+        execSync(cmd, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if any config directories exist in the user's home.
+ */
+function hasConfigDirs(ide, platform) {
+    const home = homedir();
+    const dirs = ide.configDirs[platform];
+    return dirs.some((dir) => existsSync(join(home, dir)));
+}
+/**
+ * Check if IDE config files/dirs exist in the project.
+ */
+function hasProjectConfig(ide, projectPath, platform) {
+    const configPath = ide.configPath[platform];
+    if (configPath.startsWith('~/')) {
+        return false; // global-only IDE
+    }
+    /* v8 ignore next 1 */
+    return existsSync(join(projectPath, configPath.split('/')[0] ?? ''));
+}
+/**
+ * Detect a single IDE.
+ */
+export function detectIde(ide, platform, projectPath) {
+    // Check project-level config first (highest confidence)
+    if (hasProjectConfig(ide, projectPath, platform)) {
+        return {
+            ide: ide.id,
+            detected: true,
+            confidence: 'project_detected',
+            details: `${ide.name} project configuration found`,
+        };
+    }
+    // Check if config directories exist in home
+    if (hasConfigDirs(ide, platform)) {
+        return {
+            ide: ide.id,
+            detected: true,
+            confidence: 'config_found',
+            details: `${ide.name} configuration directory found`,
+        };
+    }
+    // Check if binary is in PATH
+    const binaryFound = ide.binaryNames.some((bin) => isBinaryInPath(bin));
+    if (binaryFound) {
+        return {
+            ide: ide.id,
+            detected: true,
+            confidence: 'installed',
+            details: `${ide.name} binary found in PATH`,
+        };
+    }
+    return {
+        ide: ide.id,
+        detected: false,
+        confidence: 'installed',
+        details: `${ide.name} not detected`,
+    };
+}
+/**
+ * Detect all IDEs from the registry.
+ */
+export function detectAllIdes(ides, platform, projectPath) {
+    return ides.map((ide) => detectIde(ide, platform, projectPath));
+}
+/**
+ * Filter to only detected IDEs, sorted by confidence (project > config > installed).
+ */
+export function getDetectedIdes(results) {
+    const confidenceOrder = {
+        project_detected: 0,
+        config_found: 1,
+        installed: 2,
+    };
+    return results
+        .filter((r) => r.detected)
+        .sort((a, b) => confidenceOrder[a.confidence] - confidenceOrder[b.confidence]);
+}
+//# sourceMappingURL=detector.js.map

package/dist/engine/ide-config/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../../src/engine/ide-config/detector.ts"],"names":[],"mappings":"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"}

package/dist/engine/ide-config/generators.d.ts

@@ -0,0 +1,6 @@
+import type { IdeDefinition, IdeConfigScope, IdePlatform, GeneratedIdeConfig } from '../../types/index.js';
+/**
+ * Generate config for a specific IDE.
+ */
+export declare function generateIdeConfig(ide: IdeDefinition, scope: IdeConfigScope, platform: IdePlatform, projectPath: string): GeneratedIdeConfig;
+//# sourceMappingURL=generators.d.ts.map

package/dist/engine/ide-config/generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../../src/engine/ide-config/generators.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,aAAa,EACb,cAAc,EACd,WAAW,EACX,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAkM9B;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,WAAW,EACrB,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAGpB"}

package/dist/engine/ide-config/generators.js

@@ -0,0 +1,146 @@
+// engine/ide-config/generators.ts — Per-IDE config generators (SPEC-080 AC-02..AC-08)
+import { resolveConfigPath, buildServerEntry } from './path-resolver.js';
+/**
+ * Generate JSON-based config for IDEs that use a standard mcpServers/servers wrapper.
+ */
+function generateJsonConfig(ide, scope, platform, projectPath) {
+    const filePath = resolveConfigPath(ide, scope, platform, projectPath);
+    const entry = buildServerEntry(platform);
+    const wrapper = {
+        [ide.wrapperKey]: {
+            planu: entry,
+        },
+    };
+    return {
+        filePath,
+        content: JSON.stringify(wrapper, null, 2),
+        instructions: `Config generated for ${ide.name}. File: ${filePath}`,
+    };
+}
+/**
+ * Generate VS Code specific config (AC-02).
+ * VS Code 1.102+ uses { "servers": { ... } } with a "type" field.
+ */
+function generateVscodeConfig(ide, scope, platform, projectPath) {
+    const filePath = resolveConfigPath(ide, scope, platform, projectPath);
+    const entry = buildServerEntry(platform);
+    const config = {
+        servers: {
+            planu: entry,
+        },
+    };
+    return {
+        filePath,
+        content: JSON.stringify(config, null, 2),
+        instructions: `VS Code MCP config generated at ${filePath}. ` +
+            `Requires VS Code 1.102+ with GitHub Copilot extension. ` +
+            `Restart VS Code after adding the configuration.`,
+    };
+}
+/**
+ * Generate JetBrains specific config (AC-05).
+ */
+function generateJetbrainsConfig(ide, scope, platform, projectPath) {
+    const base = generateJsonConfig(ide, scope, platform, projectPath);
+    return {
+        ...base,
+        instructions: `JetBrains MCP config generated at ${base.filePath}. ` +
+            `Enable MCP in Settings > Tools > AI Assistant > Model Context Protocol. ` +
+            `Requires JetBrains IDE 2025.1+ with AI Assistant plugin.`,
+    };
+}
+/**
+ * Generate Claude Desktop config (AC-06).
+ */
+function generateClaudeDesktopConfig(ide, _scope, platform, _projectPath) {
+    // Claude Desktop always uses global config
+    const base = generateJsonConfig(ide, 'global', platform, '');
+    return {
+        ...base,
+        instructions: `Claude Desktop config generated at ${base.filePath}. ` +
+            `Restart Claude Desktop to activate the MCP server.`,
+    };
+}
+/**
+ * Generate Claude Code config (AC-07).
+ */
+function generateClaudeCodeConfig(ide, scope, platform, projectPath) {
+    const base = generateJsonConfig(ide, scope, platform, projectPath);
+    const cliCommand = `claude mcp add planu -- npx -y @anthropic/planu-mcp-server`;
+    return {
+        ...base,
+        instructions: `Claude Code config generated at ${base.filePath}. ` + `Alternatively, run: ${cliCommand}`,
+    };
+}
+/**
+ * Generate Neovim Lua config (AC-08).
+ */
+function generateNeovimConfig(ide, scope, platform, projectPath) {
+    const filePath = resolveConfigPath(ide, scope, platform, projectPath);
+    const npx = platform === 'win32' ? 'npx.cmd' : 'npx';
+    const luaContent = [
+        '-- Planu MCP Server configuration for Neovim',
+        '-- Compatible with: avante.nvim, codecompanion.nvim, mcphub.nvim',
+        '',
+        '-- For mcphub.nvim (recommended):',
+        '-- Add to your mcphub setup:',
+        'return {',
+        '  planu = {',
+        `    command = "${npx}",`,
+        '    args = { "-y", "@anthropic/planu-mcp-server" },',
+        '  },',
+        '}',
+        '',
+        '-- For avante.nvim:',
+        '-- Add to your avante.nvim config in the mcp_servers table:',
+        '-- require("avante").setup({',
+        '--   mcp_servers = {',
+        '--     planu = {',
+        `--       command = "${npx}",`,
+        '--       args = { "-y", "@anthropic/planu-mcp-server" },',
+        '--     },',
+        '--   },',
+        '-- })',
+        '',
+        '-- For codecompanion.nvim:',
+        '-- Add to your codecompanion.nvim config:',
+        '-- require("codecompanion").setup({',
+        '--   adapters = {',
+        '--     mcp = {',
+        '--       servers = {',
+        '--         planu = {',
+        `--           command = "${npx}",`,
+        '--           args = { "-y", "@anthropic/planu-mcp-server" },',
+        '--         },',
+        '--       },',
+        '--     },',
+        '--   },',
+        '-- })',
+    ].join('\n');
+    return {
+        filePath,
+        content: luaContent,
+        instructions: `Neovim MCP config generated at ${filePath}. ` +
+            `Integrate with your preferred MCP plugin (mcphub.nvim, avante.nvim, or codecompanion.nvim). ` +
+            `See comments in the generated file for integration instructions.`,
+    };
+}
+/** Map of IDE-specific generators */
+const IDE_GENERATORS = {
+    vscode: generateVscodeConfig,
+    cursor: generateJsonConfig,
+    windsurf: generateJsonConfig,
+    jetbrains: generateJetbrainsConfig,
+    'claude-desktop': generateClaudeDesktopConfig,
+    'claude-code': generateClaudeCodeConfig,
+    neovim: generateNeovimConfig,
+    chatgpt: generateJsonConfig,
+};
+/**
+ * Generate config for a specific IDE.
+ */
+export function generateIdeConfig(ide, scope, platform, projectPath) {
+    const generator = IDE_GENERATORS[ide.id];
+    return generator(ide, scope, platform, projectPath);
+}
+//# sourceMappingURL=generators.js.map

package/dist/engine/ide-config/generators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.js","sourceRoot":"","sources":["../../../src/engine/ide-config/generators.ts"],"names":[],"mappings":"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"}