@planu/cli 1.3.0 → 1.5.0

package/dist/engine/compliance-test-generator/test-formatter.js

@@ -0,0 +1,33 @@
+// engine/compliance-test-generator/test-formatter.ts — SPEC-390: Formats mapped tests to output formats
+export function formatAsJest(test) {
+    return (`describe('${test.control.id} — ${test.control.title}', () => {\n` +
+        `  it('should satisfy: ${test.criterion.slice(0, 80)}', async () => {\n` +
+        `    // Control: ${test.control.description}\n` +
+        `    // Rationale: ${test.rationale}\n` +
+        `    // TODO: implement assertion for this compliance requirement\n` +
+        `    expect(true).toBe(true); // placeholder\n` +
+        `  });\n` +
+        `});\n`);
+}
+export function formatAsGherkin(test) {
+    return (`Feature: ${test.control.id} — ${test.control.title}\n` +
+        `  Scenario: ${test.criterion.slice(0, 80)}\n` +
+        `    Given the system is running\n` +
+        `    When ${test.criterion.slice(0, 60).toLowerCase()}\n` +
+        `    Then the ${test.control.title.toLowerCase()} control is satisfied\n\n`);
+}
+export function formatAsMarkdown(test) {
+    return (`- [ ] **[${test.control.id}]** ${test.criterion}\n` +
+        `  - Control: ${test.control.title}\n` +
+        `  - Rationale: ${test.rationale}\n`);
+}
+export function formatTest(test, format) {
+    if (format === 'jest') {
+        return formatAsJest(test);
+    }
+    if (format === 'gherkin') {
+        return formatAsGherkin(test);
+    }
+    return formatAsMarkdown(test);
+}
+//# sourceMappingURL=test-formatter.js.map

package/dist/engine/compliance-test-generator/test-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-formatter.js","sourceRoot":"","sources":["../../../src/engine/compliance-test-generator/test-formatter.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAIxG,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,OAAO,CACL,aAAa,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,cAAc;QAClE,yBAAyB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB;QACxE,mBAAmB,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI;QAC/C,qBAAqB,IAAI,CAAC,SAAS,IAAI;QACvC,oEAAoE;QACpE,+CAA+C;QAC/C,SAAS;QACT,OAAO,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,OAAO,CACL,YAAY,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI;QACvD,eAAe,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI;QAC9C,mCAAmC;QACnC,YAAY,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI;QACzD,gBAAgB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,2BAA2B,CAC5E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAgB;IAC/C,OAAO,CACL,YAAY,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,IAAI,CAAC,SAAS,IAAI;QACpD,gBAAgB,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI;QACtC,kBAAkB,IAAI,CAAC,SAAS,IAAI,CACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAgB,EAAE,MAAwB;IACnE,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/dist/engine/cost-guardrails.d.ts

@@ -0,0 +1,11 @@
+import type { SpecBudget, SpecBudgetStatus } from '../types/cost-guardrails.js';
+/**
+ * Compute the current budget status for a spec.
+ * Recommends a model tier based on usage percentage to control costs.
+ */
+export declare function computeBudgetStatus(budget: SpecBudget): SpecBudgetStatus;
+/**
+ * Format a budget status into a human-readable summary message.
+ */
+export declare function formatBudgetMessage(status: SpecBudgetStatus): string;
+//# sourceMappingURL=cost-guardrails.d.ts.map

package/dist/engine/cost-guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-guardrails.d.ts","sourceRoot":"","sources":["../../src/engine/cost-guardrails.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGhF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,CAqBxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAUpE"}

package/dist/engine/cost-guardrails.js

@@ -0,0 +1,39 @@
+// engine/cost-guardrails.ts — Cost Guardrails computation logic (SPEC-393)
+/**
+ * Compute the current budget status for a spec.
+ * Recommends a model tier based on usage percentage to control costs.
+ */
+export function computeBudgetStatus(budget) {
+    const remaining = budget.maxUsdCents - budget.usedUsdCents;
+    const usagePercent = budget.maxUsdCents > 0 ? Math.round((budget.usedUsdCents / budget.maxUsdCents) * 100) : 0;
+    const warningTriggered = usagePercent >= budget.warningThreshold;
+    const exhausted = budget.usedUsdCents >= budget.maxUsdCents;
+    // Auto-downgrade model based on remaining budget
+    const recommendedModel = exhausted || usagePercent >= 80 ? 'haiku' : usagePercent >= 60 ? 'sonnet' : 'opus';
+    return {
+        specId: budget.specId,
+        maxUsdCents: budget.maxUsdCents,
+        usedUsdCents: budget.usedUsdCents,
+        remainingUsdCents: Math.max(0, remaining),
+        usagePercent,
+        warningTriggered,
+        recommendedModel,
+        exhausted,
+    };
+}
+/**
+ * Format a budget status into a human-readable summary message.
+ */
+export function formatBudgetMessage(status) {
+    const dollars = (status.usedUsdCents / 100).toFixed(2);
+    const max = (status.maxUsdCents / 100).toFixed(2);
+    let msg = `Budget: $${dollars} / $${max} (${status.usagePercent}%)`;
+    if (status.exhausted) {
+        msg += ' EXHAUSTED — using haiku';
+    }
+    else if (status.warningTriggered) {
+        msg += ` Warning — downgraded to ${status.recommendedModel}`;
+    }
+    return msg;
+}
+//# sourceMappingURL=cost-guardrails.js.map

package/dist/engine/cost-guardrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-guardrails.js","sourceRoot":"","sources":["../../src/engine/cost-guardrails.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAK3E;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkB;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC;IAC3D,MAAM,YAAY,GAChB,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,MAAM,gBAAgB,GAAG,YAAY,IAAI,MAAM,CAAC,gBAAgB,CAAC;IACjE,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,WAAW,CAAC;IAE5D,iDAAiD;IACjD,MAAM,gBAAgB,GACpB,SAAS,IAAI,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAErF,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC;QACzC,YAAY;QACZ,gBAAgB;QAChB,gBAAgB;QAChB,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAwB;IAC1D,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClD,IAAI,GAAG,GAAG,YAAY,OAAO,OAAO,GAAG,KAAK,MAAM,CAAC,YAAY,IAAI,CAAC;IACpE,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,GAAG,IAAI,0BAA0B,CAAC;IACpC,CAAC;SAAM,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACnC,GAAG,IAAI,4BAA4B,MAAM,CAAC,gBAAgB,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/engine/doc-compliance-checker.d.ts

@@ -0,0 +1,23 @@
+import type { DocComplianceReport, DocComplianceIssue, StructuredDocsResult } from '../types/index.js';
+export type { DocComplianceReport, DocComplianceIssue };
+/**
+ * Checks if any anti-pattern from official docs appears in spec content.
+ * Returns a DocComplianceIssue for each match found.
+ */
+export declare function detectAntiPatterns(tech: string, docsResult: StructuredDocsResult, specContent: string): DocComplianceIssue[];
+/**
+ * Identifies best practices from official docs that are NOT covered in the spec.
+ * Returns a list of missing best practice descriptions.
+ */
+export declare function detectMissingBestPractices(tech: string, docsResult: StructuredDocsResult, specContent: string): DocComplianceIssue[];
+/**
+ * Calculates a compliance score 0-100 based on issues found.
+ * High severity issues cost more points.
+ */
+export declare function calculateComplianceScore(issues: DocComplianceIssue[], totalChecks: number): number;
+/**
+ * Main entry point: checks a spec file against official documentation.
+ * Reads the spec file, detects techs, fetches docs, and checks for issues.
+ */
+export declare function checkDocCompliance(specPath: string, specId: string): Promise<DocComplianceReport>;
+//# sourceMappingURL=doc-compliance-checker.d.ts.map

package/dist/engine/doc-compliance-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-compliance-checker.d.ts","sourceRoot":"","sources":["../../src/engine/doc-compliance-checker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAK3B,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;AAExD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,oBAAoB,EAChC,WAAW,EAAE,MAAM,GAClB,kBAAkB,EAAE,CA0BtB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,oBAAoB,EAChC,WAAW,EAAE,MAAM,GAClB,kBAAkB,EAAE,CA6BtB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,EAAE,EAC5B,WAAW,EAAE,MAAM,GAClB,MAAM,CAQR;AAYD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,CAwF9B"}

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/dogfood-analyzer.d.ts

@@ -0,0 +1,6 @@
+import type { DogfoodReport } from '../types/dogfood.js';
+export declare const KEY_SDD_TOOLS: string[];
+export declare function getRecentCommitMessages(projectPath: string, sinceDays: number): string[];
+export declare function detectToolUsageFromMessages(messages: string[]): string[];
+export declare function buildDogfoodReport(usedTools: string[], period: string, messages: string[]): DogfoodReport;
+//# sourceMappingURL=dogfood-analyzer.d.ts.map

package/dist/engine/dogfood-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dogfood-analyzer.d.ts","sourceRoot":"","sources":["../../src/engine/dogfood-analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzE,eAAO,MAAM,aAAa,UAWzB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAYxF;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CASxE;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAAE,GACjB,aAAa,CAuBf"}

package/dist/engine/dogfood-analyzer.js

@@ -0,0 +1,59 @@
+// dogfood-analyzer.ts — Analyzes git history for Planu tool usage (SPEC-394)
+import { execSync } from 'node:child_process';
+export const KEY_SDD_TOOLS = [
+    'create_spec',
+    'validate',
+    'challenge_spec',
+    'check_readiness',
+    'update_status',
+    'estimate',
+    'suggest_criteria',
+    'inject_criteria',
+    'doc_compliance_report',
+    'generate_skill',
+];
+export function getRecentCommitMessages(projectPath, sinceDays) {
+    try {
+        const since = new Date(Date.now() - sinceDays * 86400000).toISOString().split('T')[0];
+        const output = execSync(`git log --since="${since}" --pretty=format:"%s %b" --no-merges`, {
+            cwd: projectPath,
+            encoding: 'utf-8',
+            timeout: 5000,
+        });
+        return output.split('\n').filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+export function detectToolUsageFromMessages(messages) {
+    const used = new Set();
+    const combined = messages.join(' ').toLowerCase();
+    for (const tool of KEY_SDD_TOOLS) {
+        if (combined.includes(tool.replace(/_/g, '_')) || combined.includes(tool.replace(/_/g, '-'))) {
+            used.add(tool);
+        }
+    }
+    return [...used];
+}
+export function buildDogfoodReport(usedTools, period, messages) {
+    const missingTools = KEY_SDD_TOOLS.filter((t) => !usedTools.includes(t));
+    const dogfoodScore = Math.round((usedTools.length / KEY_SDD_TOOLS.length) * 100);
+    const combined = messages.join(' ').toLowerCase();
+    const metrics = {
+        specCreated: (combined.match(/create_spec|feat.*spec-\d+/g) ?? []).length,
+        specValidated: (combined.match(/validate|validation/g) ?? []).length,
+        specChallenged: (combined.match(/challenge_spec|challenge/g) ?? []).length,
+        readinessChecked: (combined.match(/check_readiness|readiness/g) ?? []).length,
+        statusUpdated: (combined.match(/update_status|status.*done|status.*impl/g) ?? []).length,
+        totalToolUses: usedTools.length,
+        coveragePercent: dogfoodScore,
+    };
+    const recommendation = dogfoodScore >= 80
+        ? 'Excellent dogfooding! Keep using Planu throughout development.'
+        : dogfoodScore >= 50
+            ? `Good progress. Missing: ${missingTools.slice(0, 3).join(', ')}`
+            : `Improve SDD adoption. Start with: ${missingTools.slice(0, 3).join(', ')}`;
+    return { period, metrics, usedTools, missingTools, recommendation, dogfoodScore };
+}
+//# sourceMappingURL=dogfood-analyzer.js.map

package/dist/engine/dogfood-analyzer.js.map

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

package/dist/engine/drift-watcher/criteria-checker.d.ts

@@ -0,0 +1,16 @@
+import type { DriftAlert } from '../../types/drift-watcher.js';
+/**
+ * Parse spec.md lines starting with "- [ ]" or "- [x]" as criteria.
+ * Returns the criterion text stripped of the checkbox prefix.
+ */
+export declare function extractCriteriaFromSpec(specPath: string): Promise<string[]>;
+/**
+ * Check if a file's content contains key terms from the criterion.
+ * Returns true if any key term is found in the file.
+ */
+export declare function checkCriterionInFile(criterion: string, filePath: string): Promise<boolean>;
+/**
+ * Build a DriftAlert for a criterion that may no longer be satisfied.
+ */
+export declare function buildDriftAlert(specId: string, criterion: string, filePath: string): DriftAlert;
+//# sourceMappingURL=criteria-checker.d.ts.map

package/dist/engine/drift-watcher/criteria-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria-checker.d.ts","sourceRoot":"","sources":["../../../src/engine/drift-watcher/criteria-checker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAK/D;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBjF;AAYD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAShG;AAiBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAU/F"}

package/dist/engine/drift-watcher/criteria-checker.js

@@ -0,0 +1,81 @@
+// engine/drift-watcher/criteria-checker.ts — SPEC-388: criterion checks on file change
+import { readFile } from 'node:fs/promises';
+const HIGH_SEVERITY_KEYWORDS = ['auth', 'security', 'permission', 'access', 'token', 'password'];
+const MEDIUM_SEVERITY_KEYWORDS = ['validate', 'error', 'fail', 'reject', 'limit', 'timeout'];
+/**
+ * Parse spec.md lines starting with "- [ ]" or "- [x]" as criteria.
+ * Returns the criterion text stripped of the checkbox prefix.
+ */
+export async function extractCriteriaFromSpec(specPath) {
+    try {
+        const content = await readFile(specPath, 'utf-8');
+        const lines = content.split('\n');
+        const criteria = [];
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('- [ ]') || trimmed.startsWith('- [x]')) {
+                const text = trimmed.replace(/^- \[[ x]\]\s*/, '').trim();
+                if (text.length > 0) {
+                    criteria.push(text);
+                }
+            }
+        }
+        return criteria;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Extract key terms from a criterion (words >=4 chars, lowercased).
+ */
+function extractKeyTerms(criterion) {
+    return criterion
+        .toLowerCase()
+        .split(/\W+/)
+        .filter((w) => w.length >= 4);
+}
+/**
+ * Check if a file's content contains key terms from the criterion.
+ * Returns true if any key term is found in the file.
+ */
+export async function checkCriterionInFile(criterion, filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const lower = content.toLowerCase();
+        const terms = extractKeyTerms(criterion);
+        return terms.some((term) => lower.includes(term));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Determine severity based on criterion keywords.
+ * auth/security keywords = high, validate/error = medium, otherwise low.
+ */
+function determineSeverity(criterion) {
+    const lower = criterion.toLowerCase();
+    if (HIGH_SEVERITY_KEYWORDS.some((kw) => lower.includes(kw))) {
+        return 'high';
+    }
+    if (MEDIUM_SEVERITY_KEYWORDS.some((kw) => lower.includes(kw))) {
+        return 'medium';
+    }
+    return 'low';
+}
+/**
+ * Build a DriftAlert for a criterion that may no longer be satisfied.
+ */
+export function buildDriftAlert(specId, criterion, filePath) {
+    const severity = determineSeverity(criterion);
+    return {
+        specId,
+        criterionText: criterion,
+        affectedFile: filePath,
+        detectedAt: new Date().toISOString(),
+        severity,
+        suggestedFix: `Review ${filePath} to ensure it still satisfies: "${criterion}"`,
+    };
+}
+//# sourceMappingURL=criteria-checker.js.map

package/dist/engine/drift-watcher/criteria-checker.js.map

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

package/dist/engine/drift-watcher/file-watcher.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Watch a directory recursively for file changes.
+ * Calls onChange with the relative filename whenever a file changes.
+ * Silently skips directories that don't exist or can't be watched.
+ * Closes the watcher when the provided AbortSignal is aborted.
+ */
+export declare function watchDirectory(dirPath: string, onChange: (filename: string) => void, signal: AbortSignal): void;
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/engine/drift-watcher/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../../src/engine/drift-watcher/file-watcher.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EACpC,MAAM,EAAE,WAAW,GAClB,IAAI,CAiBN"}

package/dist/engine/drift-watcher/file-watcher.js

@@ -0,0 +1,24 @@
+// engine/drift-watcher/file-watcher.ts — SPEC-388: FSEvents wrapper using node:fs watch
+import { watch } from 'node:fs';
+/**
+ * Watch a directory recursively for file changes.
+ * Calls onChange with the relative filename whenever a file changes.
+ * Silently skips directories that don't exist or can't be watched.
+ * Closes the watcher when the provided AbortSignal is aborted.
+ */
+export function watchDirectory(dirPath, onChange, signal) {
+    try {
+        const watcher = watch(dirPath, { recursive: true }, (_event, filename) => {
+            if (filename) {
+                onChange(filename);
+            }
+        });
+        signal.addEventListener('abort', () => {
+            watcher.close();
+        }, { once: true });
+    }
+    catch {
+        // Directory doesn't exist or not watchable — silently skip
+    }
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/engine/drift-watcher/file-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.js","sourceRoot":"","sources":["../../../src/engine/drift-watcher/file-watcher.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,QAAoC,EACpC,MAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;YACvE,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,GAAG,EAAE;YACH,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;IAC7D,CAAC;AACH,CAAC"}

package/dist/engine/drift-watcher/index.d.ts

@@ -0,0 +1,19 @@
+import type { DriftWatcherConfig, WatcherState } from '../../types/drift-watcher.js';
+/**
+ * Start watching a spec's associated paths for drift.
+ * Returns the initial WatcherState.
+ */
+export declare function startWatcher(config: DriftWatcherConfig): WatcherState;
+/**
+ * Stop a running watcher. Returns true if it was running, false if not found.
+ */
+export declare function stopWatcher(specId: string): boolean;
+/**
+ * Get the current state of a watcher. Returns null if not running.
+ */
+export declare function getWatcherState(specId: string): WatcherState | null;
+/**
+ * List all active watcher states.
+ */
+export declare function listActiveWatchers(): WatcherState[];
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/drift-watcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/drift-watcher/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAgB,MAAM,8BAA8B,CAAC;AAuBnG;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CA8BrE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAUnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,EAAE,CAEnD"}

package/dist/engine/drift-watcher/index.js

@@ -0,0 +1,70 @@
+import { watchDirectory } from './file-watcher.js';
+import { extractCriteriaFromSpec, buildDriftAlert } from './criteria-checker.js';
+// In-memory registry — does not persist across server restarts
+const activeWatchers = new Map();
+async function runCriteriaCheck(config, filename) {
+    const entry = activeWatchers.get(config.specId);
+    if (!entry) {
+        return;
+    }
+    const filePath = filename;
+    const criteria = await extractCriteriaFromSpec(config.specPath);
+    for (const criterion of criteria) {
+        const alert = buildDriftAlert(config.specId, criterion, filePath);
+        entry.state.alertCount++;
+        entry.state.lastAlert = alert;
+    }
+}
+/**
+ * Start watching a spec's associated paths for drift.
+ * Returns the initial WatcherState.
+ */
+export function startWatcher(config) {
+    const existing = activeWatchers.get(config.specId);
+    if (existing) {
+        return existing.state;
+    }
+    const controller = new AbortController();
+    const state = {
+        specId: config.specId,
+        projectPath: config.projectPath,
+        active: true,
+        startedAt: new Date().toISOString(),
+        alertCount: 0,
+    };
+    activeWatchers.set(config.specId, { state, controller });
+    for (const watchedPath of config.watchedPaths) {
+        watchDirectory(watchedPath, (filename) => {
+            runCriteriaCheck(config, filename).catch(() => {
+                // Silently ignore errors during criteria check
+            });
+        }, controller.signal);
+    }
+    return state;
+}
+/**
+ * Stop a running watcher. Returns true if it was running, false if not found.
+ */
+export function stopWatcher(specId) {
+    const entry = activeWatchers.get(specId);
+    if (!entry) {
+        return false;
+    }
+    entry.controller.abort();
+    entry.state.active = false;
+    activeWatchers.delete(specId);
+    return true;
+}
+/**
+ * Get the current state of a watcher. Returns null if not running.
+ */
+export function getWatcherState(specId) {
+    return activeWatchers.get(specId)?.state ?? null;
+}
+/**
+ * List all active watcher states.
+ */
+export function listActiveWatchers() {
+    return [...activeWatchers.values()].map((e) => e.state);
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/drift-watcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/drift-watcher/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEjF,+DAA+D;AAC/D,MAAM,cAAc,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEvD,KAAK,UAAU,gBAAgB,CAAC,MAA0B,EAAE,QAAgB;IAC1E,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC1B,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEhE,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAClE,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACzB,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;IAChC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC,KAAK,CAAC;IACxB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAiB;QAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,UAAU,EAAE,CAAC;KACd,CAAC;IAEF,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAEzD,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QAC9C,cAAc,CACZ,WAAW,EACX,CAAC,QAAQ,EAAE,EAAE;YACX,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBAC5C,+CAA+C;YACjD,CAAC,CAAC,CAAC;QACL,CAAC,EACD,UAAU,CAAC,MAAM,CAClB,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IACzB,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;IAC3B,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC"}