popeye-cli 1.8.0 → 1.9.1

package/dist/workflow/audit-reporter.js

@@ -0,0 +1,301 @@
+/**
+ * Report generation for the audit system.
+ *
+ * Builds summary + full reports, writes markdown and JSON artifacts
+ * to the project's .popeye/ directory.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+// ---------------------------------------------------------------------------
+// Summary report
+// ---------------------------------------------------------------------------
+/**
+ * Build a summary report from the scan result and project state.
+ *
+ * @param scan - The project scan result.
+ * @param state - Current project state.
+ * @param aiOverview - Optional AI-generated overview text.
+ * @returns A structured summary report.
+ */
+export function buildSummaryReport(scan, state, aiOverview) {
+    const depCount = scan.dependencies.reduce((sum, d) => {
+        const deps = d.dependencies ? Object.keys(d.dependencies).length : 0;
+        const devDeps = d.devDependencies ? Object.keys(d.devDependencies).length : 0;
+        return sum + deps + devDeps;
+    }, 0);
+    return {
+        projectName: state.name,
+        language: scan.language,
+        totalSourceFiles: scan.totalSourceFiles,
+        totalTestFiles: scan.totalTestFiles,
+        totalLinesOfCode: scan.totalLinesOfCode,
+        totalLinesOfTests: scan.totalLinesOfTests,
+        componentCount: scan.components.length,
+        detectedComposition: [...scan.detectedComposition],
+        entryPointCount: scan.entryPoints.length,
+        routeCount: scan.routeFiles.length,
+        dependencyCount: depCount,
+        hasDocker: scan.configFiles.includes('docker-compose.yml')
+            || scan.configFiles.includes('docker-compose.yaml')
+            || scan.configFiles.includes('Dockerfile'),
+        hasEnvExample: !!scan.envExampleContent,
+        hasCiConfig: scan.configFiles.some((f) => f.includes('.github') || f.includes('Jenkinsfile') || f.includes('.gitlab-ci')),
+        aiOverview,
+    };
+}
+// ---------------------------------------------------------------------------
+// Audit report
+// ---------------------------------------------------------------------------
+/**
+ * Derive the overall recommendation from finding counts and score.
+ *
+ * @param criticalCount - Number of critical findings.
+ * @param majorCount - Number of major findings.
+ * @param overallScore - The overall audit score (0-100).
+ * @param strict - Whether strict mode is enabled.
+ * @returns The recommendation string.
+ */
+function deriveRecommendation(criticalCount, majorCount, overallScore, strict) {
+    if (criticalCount >= 3 || overallScore < 50)
+        return 'major-rework';
+    if (criticalCount === 0 && (strict ? majorCount === 0 : majorCount <= 2))
+        return 'pass';
+    return 'fix-and-recheck';
+}
+/**
+ * Build the full audit report from all analysis results.
+ *
+ * @param summary - The summary report.
+ * @param findings - All audit findings.
+ * @param scores - Overall and category scores.
+ * @param searchMeta - Serena search tracking metadata.
+ * @param options - Audit options (for strict mode, etc.).
+ * @param auditRunId - Unique run identifier.
+ * @returns The complete audit report.
+ */
+export function buildAuditReport(summary, findings, scores, searchMeta, options, auditRunId) {
+    const criticalCount = findings.filter((f) => f.severity === 'critical').length;
+    const majorCount = findings.filter((f) => f.severity === 'major').length;
+    const minorCount = findings.filter((f) => f.severity === 'minor').length;
+    const infoCount = findings.filter((f) => f.severity === 'info').length;
+    // Determine passed checks — categories with no findings
+    const categoriesWithFindings = new Set(findings.map((f) => f.category));
+    const allCategories = [
+        'feature-completeness', 'integration-wiring', 'test-coverage',
+        'config-deployment', 'dependency-sanity', 'consistency', 'security', 'documentation',
+    ];
+    const passedChecks = allCategories
+        .filter((c) => !categoriesWithFindings.has(c))
+        .map((c) => `${c}: no issues found`);
+    return {
+        projectName: summary.projectName,
+        language: summary.language,
+        auditedAt: new Date().toISOString(),
+        auditRunId,
+        summary,
+        findings,
+        overallScore: scores.overallScore,
+        categoryScores: scores.categoryScores,
+        criticalCount,
+        majorCount,
+        minorCount,
+        infoCount,
+        passedChecks,
+        searchMetadata: searchMeta,
+        recommendation: deriveRecommendation(criticalCount, majorCount, scores.overallScore, options.strict),
+    };
+}
+// ---------------------------------------------------------------------------
+// Markdown rendering
+// ---------------------------------------------------------------------------
+/**
+ * Render the audit report as a markdown string.
+ *
+ * @param report - The audit report.
+ * @returns Markdown string.
+ */
+function renderAuditMarkdown(report) {
+    const lines = [];
+    lines.push(`# Audit Report: ${report.projectName}`);
+    lines.push('');
+    lines.push(`**Language:** ${report.language}`);
+    lines.push(`**Audited:** ${report.auditedAt}`);
+    lines.push(`**Run ID:** ${report.auditRunId}`);
+    lines.push(`**Overall Score:** ${report.overallScore}/100`);
+    lines.push(`**Recommendation:** ${report.recommendation}`);
+    lines.push('');
+    // Summary
+    lines.push('## Summary');
+    lines.push('');
+    lines.push(`| Metric | Value |`);
+    lines.push(`| --- | --- |`);
+    lines.push(`| Source files | ${report.summary.totalSourceFiles} |`);
+    lines.push(`| Test files | ${report.summary.totalTestFiles} |`);
+    lines.push(`| Lines of code | ${report.summary.totalLinesOfCode} |`);
+    lines.push(`| Lines of tests | ${report.summary.totalLinesOfTests} |`);
+    lines.push(`| Components | ${report.summary.componentCount} |`);
+    lines.push(`| Entry points | ${report.summary.entryPointCount} |`);
+    lines.push(`| Routes | ${report.summary.routeCount} |`);
+    lines.push(`| Dependencies | ${report.summary.dependencyCount} |`);
+    lines.push('');
+    // Category scores
+    lines.push('## Category Scores');
+    lines.push('');
+    for (const [cat, score] of Object.entries(report.categoryScores)) {
+        lines.push(`- **${cat}:** ${score}/100`);
+    }
+    lines.push('');
+    // Findings
+    lines.push(`## Findings (${report.findings.length} total)`);
+    lines.push('');
+    lines.push(`- Critical: ${report.criticalCount}`);
+    lines.push(`- Major: ${report.majorCount}`);
+    lines.push(`- Minor: ${report.minorCount}`);
+    lines.push(`- Info: ${report.infoCount}`);
+    lines.push('');
+    // Group findings by severity
+    const severityOrder = ['critical', 'major', 'minor', 'info'];
+    for (const sev of severityOrder) {
+        const sevFindings = report.findings.filter((f) => f.severity === sev);
+        if (sevFindings.length === 0)
+            continue;
+        lines.push(`### ${sev.charAt(0).toUpperCase() + sev.slice(1)}`);
+        lines.push('');
+        for (const f of sevFindings) {
+            lines.push(`#### ${f.id}: ${f.title}`);
+            lines.push('');
+            lines.push(f.description);
+            if (f.evidence.length > 0) {
+                lines.push('');
+                lines.push('**Evidence:**');
+                for (const e of f.evidence) {
+                    const loc = e.line ? `${e.file}:${e.line}` : e.file;
+                    lines.push(`- \`${loc}\`${e.description ? ` - ${e.description}` : ''}`);
+                }
+            }
+            lines.push('');
+            lines.push(`**Recommendation:** ${f.recommendation}`);
+            lines.push(`**Auto-fixable:** ${f.autoFixable ? 'Yes' : 'No'}`);
+            lines.push('');
+        }
+    }
+    // Passed checks
+    if (report.passedChecks.length > 0) {
+        lines.push('## Passed Checks');
+        lines.push('');
+        for (const check of report.passedChecks) {
+            lines.push(`- ${check}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Render the recovery plan as a markdown string.
+ *
+ * @param recovery - The recovery plan.
+ * @returns Markdown string.
+ */
+function renderRecoveryMarkdown(recovery) {
+    const lines = [];
+    lines.push('# Recovery Plan');
+    lines.push('');
+    lines.push(`**Generated:** ${recovery.generatedAt}`);
+    lines.push(`**Audit Score:** ${recovery.auditScore}/100`);
+    lines.push(`**Run ID:** ${recovery.auditRunId}`);
+    lines.push(`**Total Findings:** ${recovery.totalFindings}`);
+    lines.push(`**Critical Findings:** ${recovery.criticalFindings}`);
+    lines.push(`**Estimated Effort:** ${recovery.estimatedEffort}`);
+    lines.push('');
+    for (const milestone of recovery.milestones) {
+        lines.push(`## ${milestone.name}`);
+        lines.push('');
+        lines.push(milestone.description);
+        lines.push('');
+        for (const task of milestone.tasks) {
+            lines.push(`### ${task.name} (target: ${task.appTarget})`);
+            lines.push('');
+            lines.push(task.description);
+            lines.push('');
+            lines.push('**Finding IDs:** ' + task.findingIds.join(', '));
+            lines.push('');
+            lines.push('**Acceptance Criteria:**');
+            for (const ac of task.acceptanceCriteria) {
+                lines.push(`- [ ] ${ac}`);
+            }
+            if (task.testPlan) {
+                lines.push('');
+                lines.push(`**Test Plan:** ${task.testPlan}`);
+            }
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// File writers
+// ---------------------------------------------------------------------------
+/**
+ * Ensure .popeye directory exists.
+ *
+ * @param projectDir - Project root directory.
+ * @returns Path to .popeye directory.
+ */
+async function ensurePopeyeDir(projectDir) {
+    const dir = path.join(projectDir, '.popeye');
+    await fs.mkdir(dir, { recursive: true });
+    return dir;
+}
+/**
+ * Write the audit report as markdown.
+ *
+ * @param projectDir - Project root directory.
+ * @param report - The audit report.
+ * @returns Path to the written file.
+ */
+export async function writeAuditMarkdown(projectDir, report) {
+    const dir = await ensurePopeyeDir(projectDir);
+    const filePath = path.join(dir, 'popeye.audit.md');
+    await fs.writeFile(filePath, renderAuditMarkdown(report), 'utf-8');
+    return filePath;
+}
+/**
+ * Write the audit report as JSON.
+ *
+ * @param projectDir - Project root directory.
+ * @param report - The audit report.
+ * @returns Path to the written file.
+ */
+export async function writeAuditJson(projectDir, report) {
+    const dir = await ensurePopeyeDir(projectDir);
+    const filePath = path.join(dir, 'popeye.audit.json');
+    await fs.writeFile(filePath, JSON.stringify(report, null, 2), 'utf-8');
+    return filePath;
+}
+/**
+ * Write the recovery plan as markdown.
+ *
+ * @param projectDir - Project root directory.
+ * @param recovery - The recovery plan.
+ * @returns Path to the written file.
+ */
+export async function writeRecoveryMarkdown(projectDir, recovery) {
+    const dir = await ensurePopeyeDir(projectDir);
+    const filePath = path.join(dir, 'popeye.recovery.md');
+    await fs.writeFile(filePath, renderRecoveryMarkdown(recovery), 'utf-8');
+    return filePath;
+}
+/**
+ * Write the recovery plan as JSON.
+ *
+ * @param projectDir - Project root directory.
+ * @param recovery - The recovery plan.
+ * @returns Path to the written file.
+ */
+export async function writeRecoveryJson(projectDir, recovery) {
+    const dir = await ensurePopeyeDir(projectDir);
+    const filePath = path.join(dir, 'popeye.recovery.json');
+    await fs.writeFile(filePath, JSON.stringify(recovery, null, 2), 'utf-8');
+    return filePath;
+}
+//# sourceMappingURL=audit-reporter.js.map

package/dist/workflow/audit-reporter.js.map

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

package/dist/workflow/audit-scanner.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Deterministic project scanner for the audit system.
+ *
+ * Scans the filesystem to detect workspace composition, per-component structure,
+ * dependency manifests, route files, LOC, and FE<->BE wiring mismatches.
+ * Reads docs in priority order: CLAUDE.md -> README.md -> other docs.
+ */
+import type { ComponentKind, ComponentScan, DependencyManifest, FileEntry, FileExcerpt, ProjectScanResult, WiringMatrix } from '../types/audit.js';
+/**
+ * Detect workspace composition from the filesystem.
+ *
+ * Examines directory structure for signals of frontend, backend, website,
+ * shared, and infra components. Does NOT trust state.language — derives
+ * composition purely from filesystem evidence.
+ *
+ * @param projectDir - Project root directory.
+ * @returns Array of detected ComponentKind values.
+ */
+export declare function detectWorkspaceComposition(projectDir: string): Promise<ComponentKind[]>;
+/**
+ * Scan a single component directory for files, routes, entry points, and deps.
+ *
+ * @param componentDir - Absolute path to component root.
+ * @param kind - Component kind.
+ * @param language - Language hint (e.g., 'typescript', 'python').
+ * @returns ComponentScan result.
+ */
+export declare function scanComponent(componentDir: string, kind: ComponentKind, language: 'typescript' | 'python' | 'mixed', projectDir?: string): Promise<ComponentScan>;
+/**
+ * Parse all dependency manifests found in the project.
+ *
+ * @param projectDir - Project root directory.
+ * @param language - Project language.
+ * @returns Array of dependency manifests.
+ */
+export declare function parseDependencies(projectDir: string, _language: string): Promise<DependencyManifest[]>;
+/**
+ * Find all route-like files in the project.
+ *
+ * @param projectDir - Project root directory.
+ * @param language - Project language.
+ * @returns Array of relative paths to route files.
+ */
+export declare function findRouteFiles(projectDir: string, _language: string): Promise<string[]>;
+/**
+ * Read project documentation in priority order: CLAUDE.md -> README.md -> docs.
+ *
+ * @param projectDir - Project root directory.
+ * @returns Priority doc contents and docs index.
+ */
+export declare function readPriorityDocs(projectDir: string): Promise<{
+    claudeMd?: string;
+    readme?: string;
+    docsIndex: string[];
+    keyFiles: FileExcerpt[];
+}>;
+/**
+ * Build a wiring matrix from the project, checking FE<->BE env keys,
+ * CORS origins, and API prefixes for mismatches.
+ *
+ * @param projectDir - Project root directory.
+ * @param components - Already-scanned component list.
+ * @returns WiringMatrix with detected mismatches.
+ */
+export declare function buildWiringMatrix(projectDir: string, components: ComponentScan[]): Promise<WiringMatrix>;
+/**
+ * Count lines of code and test code in the given file lists.
+ *
+ * @param sourceFiles - Array of source file entries.
+ * @param testFiles - Array of test file entries.
+ * @param projectDir - Project root for resolving paths.
+ * @returns Total lines of code and test code.
+ */
+export declare function countLines(sourceFiles: FileEntry[], testFiles: FileEntry[], projectDir: string): Promise<{
+    code: number;
+    tests: number;
+}>;
+/**
+ * Scan the entire project and produce a structured ProjectScanResult.
+ *
+ * @param projectDir - Project root directory.
+ * @param language - Language from state.json.
+ * @param onProgress - Optional progress callback.
+ * @returns ProjectScanResult with all scan data.
+ */
+export declare function scanProject(projectDir: string, language: string, onProgress?: (message: string) => void): Promise<ProjectScanResult>;
+//# sourceMappingURL=audit-scanner.d.ts.map

package/dist/workflow/audit-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-scanner.d.ts","sourceRoot":"","sources":["../../src/workflow/audit-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,YAAY,EAEb,MAAM,mBAAmB,CAAC;AAyJ3B;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,EAAE,CAAC,CAoE1B;AA6CD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,YAAY,GAAG,QAAQ,GAAG,OAAO,EAC3C,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC,CAqExB;AAgDD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAgB/B;AAMD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBnB;AAMD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB,CAAC,CAkDD;AAMD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,aAAa,EAAE,GAC1B,OAAO,CAAC,YAAY,CAAC,CAuFvB;AAMD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,SAAS,EAAE,EACxB,SAAS,EAAE,SAAS,EAAE,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAe1C;AAkCD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACrC,OAAO,CAAC,iBAAiB,CAAC,CAoI5B"}