@planu/cli 1.2.0 → 1.4.0

package/dist/engine/doc-compliance-checker.js

@@ -0,0 +1,168 @@
+// engine/doc-compliance-checker.ts — SPEC-385
+// Checks a spec against official documentation for anti-patterns and missing best practices.
+import { readFile } from 'node:fs/promises';
+import { detectTechsFromText } from './web-fetcher/stack-detector.js';
+import { fetchDocsBatch } from './web-fetcher/docs-intelligence.js';
+/**
+ * Checks if any anti-pattern from official docs appears in spec content.
+ * Returns a DocComplianceIssue for each match found.
+ */
+export function detectAntiPatterns(tech, docsResult, specContent) {
+    const issues = [];
+    const lower = specContent.toLowerCase();
+    for (const ap of docsResult.antiPatterns) {
+        // Extract key terms from the anti-pattern description (first 5 words)
+        const keyTerms = ap
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]/g, ' ')
+            .split(/\s+/)
+            .filter((w) => w.length > 3)
+            .slice(0, 5);
+        const matchCount = keyTerms.filter((term) => lower.includes(term)).length;
+        if (matchCount >= 2) {
+            issues.push({
+                tech,
+                issueType: 'anti-pattern',
+                description: ap,
+                source: docsResult.docsUrl,
+                severity: 'high',
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * Identifies best practices from official docs that are NOT covered in the spec.
+ * Returns a list of missing best practice descriptions.
+ */
+export function detectMissingBestPractices(tech, docsResult, specContent) {
+    const issues = [];
+    const lower = specContent.toLowerCase();
+    for (const bp of docsResult.bestPractices.slice(0, 5)) {
+        const keyTerms = bp
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]/g, ' ')
+            .split(/\s+/)
+            .filter((w) => w.length > 3)
+            .slice(0, 5);
+        if (keyTerms.length === 0) {
+            continue;
+        }
+        const matchCount = keyTerms.filter((term) => lower.includes(term)).length;
+        // If fewer than 1/3 of key terms appear, best practice is likely missing
+        if (matchCount < Math.max(1, Math.ceil(keyTerms.length / 3))) {
+            issues.push({
+                tech,
+                issueType: 'missing-best-practice',
+                description: `Missing: ${bp}`,
+                source: docsResult.docsUrl,
+                severity: 'medium',
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * Calculates a compliance score 0-100 based on issues found.
+ * High severity issues cost more points.
+ */
+export function calculateComplianceScore(issues, totalChecks) {
+    if (totalChecks === 0) {
+        return 100;
+    }
+    const penalty = issues.reduce((sum, issue) => {
+        return sum + (issue.severity === 'high' ? 15 : issue.severity === 'medium' ? 8 : 3);
+    }, 0);
+    return Math.max(0, Math.min(100, 100 - penalty));
+}
+/**
+ * Extracts spec title from frontmatter or first heading.
+ */
+function extractSpecTitle(specContent, fallback) {
+    const titleMatch = /^title:\s*"?([^"\n]+)"?/m.exec(specContent) ??
+        /^#\s+(?:SPEC-\d+[:\s]+)?(.+)/m.exec(specContent);
+    return titleMatch?.[1]?.trim() ?? fallback;
+}
+/**
+ * Main entry point: checks a spec file against official documentation.
+ * Reads the spec file, detects techs, fetches docs, and checks for issues.
+ */
+export async function checkDocCompliance(specPath, specId) {
+    // Read spec content
+    let specContent;
+    let specTitle;
+    try {
+        specContent = await readFile(specPath, 'utf-8');
+        specTitle = extractSpecTitle(specContent, specId);
+    }
+    catch {
+        // fallback to specId as search text
+        specContent = specId;
+        specTitle = specId;
+    }
+    // Detect technologies
+    const detected = detectTechsFromText(specContent);
+    const techs = detected
+        .filter((t) => t.confidence === 'high' || t.confidence === 'medium')
+        .map((t) => t.name)
+        .slice(0, 6);
+    if (techs.length === 0) {
+        return {
+            specId,
+            specTitle,
+            checkedAt: new Date().toISOString(),
+            techs: [],
+            issues: [],
+            bestPracticesCovered: [],
+            complianceScore: 100,
+            summary: 'No technologies detected in spec — skipping doc compliance check.',
+        };
+    }
+    // Fetch docs for detected techs
+    const docsMap = await fetchDocsBatch(techs, { timeout: 5_000, concurrency: 3 });
+    // Run checks
+    const allIssues = [];
+    const bestPracticesCovered = [];
+    let totalChecks = 0;
+    for (const [tech, docsResult] of docsMap) {
+        if (docsResult.source === 'fallback') {
+            continue;
+        }
+        const antiPatternIssues = detectAntiPatterns(tech, docsResult, specContent);
+        const missingBpIssues = detectMissingBestPractices(tech, docsResult, specContent);
+        allIssues.push(...antiPatternIssues);
+        allIssues.push(...missingBpIssues);
+        totalChecks += docsResult.antiPatterns.length + docsResult.bestPractices.slice(0, 5).length;
+        // Track covered best practices
+        const lower = specContent.toLowerCase();
+        for (const bp of docsResult.bestPractices.slice(0, 5)) {
+            const keyTerms = bp
+                .toLowerCase()
+                .replace(/[^a-z0-9\s]/g, ' ')
+                .split(/\s+/)
+                .filter((w) => w.length > 3)
+                .slice(0, 5);
+            const matchCount = keyTerms.filter((term) => lower.includes(term)).length;
+            if (matchCount >= Math.max(1, Math.ceil(keyTerms.length / 3))) {
+                bestPracticesCovered.push(`[${tech}] ${bp.slice(0, 80)}`);
+            }
+        }
+    }
+    const complianceScore = calculateComplianceScore(allIssues, totalChecks);
+    const highIssues = allIssues.filter((i) => i.severity === 'high').length;
+    const mediumIssues = allIssues.filter((i) => i.severity === 'medium').length;
+    const summary = allIssues.length === 0
+        ? `Spec is fully compliant with official docs for: ${techs.join(', ')}.`
+        : `Found ${highIssues} high + ${mediumIssues} medium issues against official docs for: ${techs.join(', ')}.`;
+    return {
+        specId,
+        specTitle,
+        checkedAt: new Date().toISOString(),
+        techs,
+        issues: allIssues,
+        bestPracticesCovered,
+        complianceScore,
+        summary,
+    };
+}
+//# sourceMappingURL=doc-compliance-checker.js.map

package/dist/engine/doc-compliance-checker.js.map

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

package/dist/engine/e2e-test-generator.d.ts

@@ -0,0 +1,19 @@
+import type { E2eTestFramework, GenerateE2eTestsResult, E2eTestStatusResult } from '../types/index.js';
+/** Generate Gherkin feature file content. */
+export declare function generateGherkin(title: string, description: string, criteria: string[]): string;
+/** Generate Playwright TypeScript test content. */
+export declare function generatePlaywright(title: string, criteria: string[]): string;
+/** Generate testRigor plain English steps. */
+export declare function generateTestRigor(title: string, criteria: string[]): string;
+/** Generate plain numbered list. */
+export declare function generatePlain(criteria: string[]): string;
+/** Get file extension for each framework. */
+export declare function getFrameworkExtension(framework: E2eTestFramework): string;
+/** Generate E2E tests from a spec. */
+export declare function generateE2eTests(specId: string, projectPath: string, framework?: E2eTestFramework, outputPath?: string): Promise<GenerateE2eTestsResult | {
+    isError: true;
+    message: string;
+}>;
+/** List existing E2E test files matching SPEC-XXX pattern. */
+export declare function getE2eTestStatus(projectPath: string): Promise<E2eTestStatusResult>;
+//# sourceMappingURL=e2e-test-generator.d.ts.map

package/dist/engine/e2e-test-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e-test-generator.d.ts","sourceRoot":"","sources":["../../src/engine/e2e-test-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EAEtB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AA8C3B,6CAA6C;AAC7C,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAa9F;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAgB5E;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAG3E;AAED,oCAAoC;AACpC,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAExD;AAED,6CAA6C;AAC7C,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAWzE;AAgCD,sCAAsC;AACtC,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,gBAA4B,EACvC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,sBAAsB,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA+DtE;AAED,8DAA8D;AAC9D,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAwCxF"}

package/dist/engine/e2e-test-generator.js

@@ -0,0 +1,210 @@
+// Planu — E2E Test Generator engine (SPEC-381)
+// Pure functions for generating E2E tests from spec acceptance criteria.
+import { readFile, readdir, mkdir, writeFile } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+/** Extract acceptance criteria from spec.md content (checkbox lines). */
+function extractAcceptanceCriteria(specContent) {
+    const lines = specContent.split('\n');
+    const criteria = [];
+    for (const line of lines) {
+        const match = /^\s*-\s*\[[ xX]?\]\s+(.+)$/.exec(line);
+        if (match?.[1]) {
+            criteria.push(match[1].trim());
+        }
+    }
+    return criteria;
+}
+/** Extract spec title from frontmatter or first H1. */
+function extractSpecTitle(specContent) {
+    const titleMatch = /^#\s+(.+)$/m.exec(specContent);
+    if (titleMatch?.[1]) {
+        return titleMatch[1].replace(/^SPEC-\d+[:\s-]+/i, '').trim();
+    }
+    const fmMatch = /^title:\s*(.+)$/m.exec(specContent);
+    return fmMatch?.[1]?.trim() ?? 'Spec';
+}
+/** Extract spec description from frontmatter or first paragraph. */
+function extractSpecDescription(specContent) {
+    const descMatch = /^description:\s*(.+)$/m.exec(specContent);
+    if (descMatch?.[1]) {
+        return descMatch[1].trim();
+    }
+    const lines = specContent.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed &&
+            !trimmed.startsWith('#') &&
+            !trimmed.startsWith('-') &&
+            !trimmed.startsWith('`')) {
+            return trimmed;
+        }
+    }
+    return '';
+}
+/** Generate Gherkin feature file content. */
+export function generateGherkin(title, description, criteria) {
+    const scenarios = criteria
+        .map((criterion) => `  Scenario: ${criterion}\n` +
+        `    Given the system is ready\n` +
+        `    When the user performs the action\n` +
+        `    Then ${criterion}`)
+        .join('\n\n');
+    const descLine = description ? `  ${description}\n\n` : '';
+    return `Feature: ${title}\n${descLine}${scenarios}\n`;
+}
+/** Generate Playwright TypeScript test content. */
+export function generatePlaywright(title, criteria) {
+    const tests = criteria
+        .map((criterion) => `  test('${criterion.replace(/'/g, "\\'")}', async ({ page }) => {\n` +
+        `    // TODO: implement test for: ${criterion}\n` +
+        `  });`)
+        .join('\n\n');
+    return (`import { test, expect } from '@playwright/test';\n\n` +
+        `test.describe('${title.replace(/'/g, "\\'")}', () => {\n` +
+        `${tests}\n` +
+        `});\n`);
+}
+/** Generate testRigor plain English steps. */
+export function generateTestRigor(title, criteria) {
+    const steps = criteria.map((criterion, i) => `${i + 1}. ${criterion}`).join('\n');
+    return `# ${title}\n\n${steps}\n`;
+}
+/** Generate plain numbered list. */
+export function generatePlain(criteria) {
+    return criteria.map((criterion, i) => `${i + 1}. Verify that ${criterion}`).join('\n') + '\n';
+}
+/** Get file extension for each framework. */
+export function getFrameworkExtension(framework) {
+    switch (framework) {
+        case 'gherkin':
+            return 'feature';
+        case 'playwright':
+            return 'spec.ts';
+        case 'testRigor':
+            return 'txt';
+        case 'plain':
+            return 'txt';
+    }
+}
+/** Derive default output path for tests. */
+function deriveDefaultOutputPath(specId, slug, framework) {
+    const ext = getFrameworkExtension(framework);
+    const fileName = `${specId}-${slug}.${ext}`;
+    return join('tests', 'e2e', fileName);
+}
+/** Extract slug from spec directory name. */
+function extractSlug(specDirName) {
+    return specDirName.replace(/^SPEC-\d+-?/i, '').toLowerCase() || 'spec';
+}
+/** Resolve spec directory from specId and projectPath. */
+async function resolveSpecDir(specId, projectPath) {
+    const specsBase = join(projectPath, 'planu', 'specs');
+    let entries;
+    try {
+        entries = await readdir(specsBase);
+    }
+    catch {
+        return null;
+    }
+    const upper = specId.toUpperCase();
+    const match = entries.find((e) => e.toUpperCase().startsWith(upper));
+    return match ? join(specsBase, match) : null;
+}
+/** Generate E2E tests from a spec. */
+export async function generateE2eTests(specId, projectPath, framework = 'gherkin', outputPath) {
+    const specDir = await resolveSpecDir(specId, projectPath);
+    if (!specDir) {
+        return { isError: true, message: `Spec ${specId} not found in ${projectPath}/planu/specs/` };
+    }
+    let specContent;
+    try {
+        specContent = await readFile(join(specDir, 'spec.md'), 'utf8');
+    }
+    catch {
+        return { isError: true, message: `Could not read spec.md for ${specId}` };
+    }
+    const criteria = extractAcceptanceCriteria(specContent);
+    const title = extractSpecTitle(specContent);
+    const description = extractSpecDescription(specContent);
+    let content;
+    switch (framework) {
+        case 'gherkin':
+            content = generateGherkin(title, description, criteria);
+            break;
+        case 'playwright':
+            content = generatePlaywright(title, criteria);
+            break;
+        case 'testRigor':
+            content = generateTestRigor(title, criteria);
+            break;
+        case 'plain':
+            content = generatePlain(criteria);
+            break;
+    }
+    const specDirName = specDir.split('/').pop() ?? specId;
+    const slug = extractSlug(specDirName);
+    const resolvedOutputPath = outputPath ?? deriveDefaultOutputPath(specId, slug, framework);
+    const absoluteOutputPath = resolvedOutputPath.startsWith('/')
+        ? resolvedOutputPath
+        : join(projectPath, resolvedOutputPath);
+    try {
+        const dir = absoluteOutputPath.substring(0, absoluteOutputPath.lastIndexOf('/'));
+        await mkdir(dir, { recursive: true });
+        await writeFile(absoluteOutputPath, content, 'utf8');
+    }
+    catch {
+        // If write fails, still return content without outputPath
+        return {
+            framework,
+            specId,
+            testCount: criteria.length,
+            content,
+            outputPath: null,
+        };
+    }
+    return {
+        framework,
+        specId,
+        testCount: criteria.length,
+        content,
+        outputPath: absoluteOutputPath,
+    };
+}
+/** List existing E2E test files matching SPEC-XXX pattern. */
+export async function getE2eTestStatus(projectPath) {
+    const e2eDir = join(projectPath, 'tests', 'e2e');
+    let files;
+    try {
+        files = await readdir(e2eDir);
+    }
+    catch {
+        return { testFiles: [], total: 0 };
+    }
+    const specPattern = /^(SPEC-\d+)/i;
+    const testFiles = [];
+    for (const file of files) {
+        const ext = extname(file);
+        const isTestFile = file.endsWith('.feature') || file.endsWith('.spec.ts') || file.endsWith('.test.ts');
+        if (!isTestFile) {
+            continue;
+        }
+        const match = specPattern.exec(file);
+        if (!match?.[1]) {
+            continue;
+        }
+        const specId = match[1].toUpperCase();
+        let framework;
+        if (file.endsWith('.feature')) {
+            framework = 'gherkin';
+        }
+        else if (ext === '.ts') {
+            framework = 'playwright';
+        }
+        else {
+            framework = 'unknown';
+        }
+        testFiles.push({ file, specId, framework });
+    }
+    return { testFiles, total: testFiles.length };
+}
+//# sourceMappingURL=e2e-test-generator.js.map

package/dist/engine/e2e-test-generator.js.map

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

package/dist/engine/ecosystem-detector.d.ts

@@ -0,0 +1,13 @@
+import type { TokenOptimizerStatus, TokenOptimizerRecommendation } from '../types/index.js';
+export declare function detectRtkHooks(projectPath: string): Promise<number>;
+export declare function detectHeadroomPackage(projectPath: string): Promise<{
+    installed: boolean;
+    version?: string;
+}>;
+export declare function detectRtkPackage(projectPath: string): Promise<{
+    installed: boolean;
+    version?: string;
+}>;
+export declare function getTokenOptimizerStatus(projectPath: string): Promise<TokenOptimizerStatus>;
+export declare function buildTokenOptimizerRecommendations(projectPath: string): Promise<TokenOptimizerRecommendation[]>;
+//# sourceMappingURL=ecosystem-detector.d.ts.map

package/dist/engine/ecosystem-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosystem-detector.d.ts","sourceRoot":"","sources":["../../src/engine/ecosystem-detector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,oBAAoB,EACpB,4BAA4B,EAG7B,MAAM,mBAAmB,CAAC;AAW3B,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUzE;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBnD;AAED,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBnD;AAED,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkBhG;AAED,wBAAsB,kCAAkC,CACtD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAyDzC"}

package/dist/engine/ecosystem-detector.js

@@ -0,0 +1,128 @@
+// Planu — Ecosystem detector engine (SPEC-374)
+// Pure functions to detect token optimization tools (RTK, Headroom)
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+async function readJsonFile(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+export async function detectRtkHooks(projectPath) {
+    const settingsPath = join(projectPath, '.claude', 'settings.json');
+    const settings = await readJsonFile(settingsPath);
+    if (!settings?.hooks?.PreToolUse) {
+        return 0;
+    }
+    return settings.hooks.PreToolUse.filter((hook) => {
+        const hooksArr = hook.hooks ?? [];
+        return hooksArr.some((h) => typeof h === 'string' && h.toLowerCase().includes('rtk'));
+    }).length;
+}
+export async function detectHeadroomPackage(projectPath) {
+    const pkgPath = join(projectPath, 'package.json');
+    const pkg = await readJsonFile(pkgPath);
+    if (!pkg) {
+        return { installed: false };
+    }
+    const allDeps = {
+        ...(pkg.devDependencies ?? {}),
+        ...(pkg.dependencies ?? {}),
+    };
+    const headroom = allDeps.headroom;
+    const headroomCli = allDeps['@headroom/cli'];
+    const version = headroom ?? headroomCli;
+    if (version !== undefined) {
+        return { installed: true, version };
+    }
+    return { installed: false };
+}
+export async function detectRtkPackage(projectPath) {
+    const pkgPath = join(projectPath, 'package.json');
+    const pkg = await readJsonFile(pkgPath);
+    if (!pkg) {
+        return { installed: false };
+    }
+    const allDeps = {
+        ...(pkg.devDependencies ?? {}),
+        ...(pkg.dependencies ?? {}),
+    };
+    const rtk = allDeps.rtk;
+    const rtkCli = allDeps['@rtk/cli'];
+    const version = rtk ?? rtkCli;
+    if (version !== undefined) {
+        return { installed: true, version };
+    }
+    return { installed: false };
+}
+export async function getTokenOptimizerStatus(projectPath) {
+    const [rtkPkg, headroomPkg, rtkHooks] = await Promise.all([
+        detectRtkPackage(projectPath),
+        detectHeadroomPackage(projectPath),
+        detectRtkHooks(projectPath),
+    ]);
+    return {
+        rtk: {
+            installed: rtkPkg.installed,
+            version: rtkPkg.version,
+            hooksConfigured: rtkHooks,
+        },
+        headroom: {
+            installed: headroomPkg.installed,
+            version: headroomPkg.version,
+        },
+    };
+}
+export async function buildTokenOptimizerRecommendations(projectPath) {
+    const status = await getTokenOptimizerStatus(projectPath);
+    const recommendations = [];
+    if (!status.rtk.installed) {
+        recommendations.push({
+            tool: 'rtk',
+            installed: false,
+            reason: 'RTK (Response Token Killer) filters verbose Claude output via PreToolUse hooks, reducing token usage by 30-60% on large codebases.',
+            installCommand: 'npm install --save-dev rtk',
+            configExample: JSON.stringify({
+                hooks: {
+                    PreToolUse: [
+                        {
+                            matcher: 'Bash',
+                            hooks: ['npx rtk filter'],
+                        },
+                    ],
+                },
+            }, null, 2),
+        });
+    }
+    else {
+        recommendations.push({
+            tool: 'rtk',
+            installed: true,
+            reason: `RTK is installed (${status.rtk.version ?? 'unknown version'}). ${status.rtk.hooksConfigured === 0
+                ? 'No PreToolUse hooks configured yet — add hooks to .claude/settings.json to activate filtering.'
+                : `${String(status.rtk.hooksConfigured)} PreToolUse hook(s) configured.`}`,
+            installCommand: 'npm install --save-dev rtk',
+        });
+    }
+    if (!status.headroom.installed) {
+        recommendations.push({
+            tool: 'headroom',
+            installed: false,
+            reason: 'Headroom monitors your context window usage in real-time and warns before you hit the limit, preventing lost work.',
+            installCommand: 'npm install --save-dev headroom',
+        });
+    }
+    else {
+        recommendations.push({
+            tool: 'headroom',
+            installed: true,
+            reason: `Headroom is installed (${status.headroom.version ?? 'unknown version'}).`,
+            installCommand: 'npm install --save-dev headroom',
+        });
+    }
+    return recommendations;
+}
+//# sourceMappingURL=ecosystem-detector.js.map

package/dist/engine/ecosystem-detector.js.map

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

package/dist/engine/memory-config-generator.d.ts

@@ -0,0 +1,8 @@
+import type { MemoryProvider, MemoryStatusResult, ClaudeJsonConfig } from '../types/index.js';
+export declare function resolveClaudeJsonPath(projectPath: string): string;
+export declare function detectMemoryProvider(config: ClaudeJsonConfig): MemoryProvider;
+export declare function getMemoryStatus(projectPath: string): Promise<MemoryStatusResult>;
+export declare function setupOpenMemory(projectPath: string): Promise<string>;
+export declare function setupMem0Cloud(projectPath: string, apiKey: string): Promise<string>;
+export declare function resetMemoryConfig(projectPath: string): Promise<string>;
+//# sourceMappingURL=memory-config-generator.d.ts.map

package/dist/engine/memory-config-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-config-generator.d.ts","sourceRoot":"","sources":["../../src/engine/memory-config-generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAEjB,MAAM,mBAAmB,CAAC;AAe3B,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAkB7E;AAED,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAWtF;AAED,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB1E;AAED,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBzF;AAED,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB5E"}