popeye-cli 1.8.0 → 1.9.1

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

@@ -0,0 +1,61 @@
+/**
+ * Recovery system for the audit feature.
+ *
+ * Evidence-based trigger logic, finding-to-milestone conversion,
+ * and safe state injection for recovery execution.
+ */
+import type { Milestone, ProjectState } from '../types/workflow.js';
+import type { ProjectAuditReport, RecoveryPlan } from '../types/audit.js';
+/**
+ * Determine if recovery should be triggered based on evidence in the report.
+ *
+ * Trigger conditions (any one suffices):
+ * - criticalCount > 0
+ * - strict mode AND majorCount > 0
+ * - overallScore < threshold AND at least one finding is autoFixable
+ *   or belongs to an actionable category
+ *
+ * Does NOT trigger on info-only or purely cosmetic issues.
+ *
+ * @param report - The audit report.
+ * @param strict - Whether strict mode is active.
+ * @returns True if recovery should be triggered.
+ */
+export declare function shouldTriggerRecovery(report: ProjectAuditReport, strict: boolean): boolean;
+/**
+ * Generate a recovery plan from audit report findings.
+ *
+ * Groups findings into milestones by severity:
+ * - Critical -> [RECOVERY] Critical Fixes
+ * - Major -> [RECOVERY] Major Improvements (grouped by category)
+ * - Minor + autoFixable -> [RECOVERY] Polish
+ *
+ * @param report - The audit report.
+ * @returns A structured recovery plan.
+ */
+export declare function generateRecoveryPlan(report: ProjectAuditReport): RecoveryPlan;
+/**
+ * Convert a recovery plan into milestone objects compatible with addMilestones().
+ *
+ * Each recovery milestone becomes an Omit<Milestone, 'id'> with tasks
+ * that have the standard Task shape.
+ *
+ * @param recovery - The recovery plan.
+ * @param language - Project language (for task context).
+ * @returns Array of milestone objects ready for addMilestones().
+ */
+export declare function recoveryToMilestones(recovery: RecoveryPlan, _language: string): Omit<Milestone, 'id'>[];
+/**
+ * Inject recovery milestones into the project state.
+ *
+ * This APPENDS recovery milestones — it never clobbers existing milestones.
+ * Milestone names are prefixed with [RECOVERY] for visibility.
+ * Sets audit tracking fields and switches phase to 'execution'.
+ *
+ * @param projectDir - Project root directory.
+ * @param milestones - Recovery milestones (without IDs).
+ * @param auditRunId - The audit run identifier for lineage.
+ * @returns Updated project state.
+ */
+export declare function injectRecoveryIntoState(projectDir: string, milestones: Omit<Milestone, 'id'>[], auditRunId: string): Promise<ProjectState>;
+//# sourceMappingURL=audit-recovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit-recovery.d.ts","sourceRoot":"","sources":["../../src/workflow/audit-recovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAQ,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAGV,kBAAkB,EAElB,YAAY,EAEb,MAAM,mBAAmB,CAAC;AAkB3B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,OAAO,GACd,OAAO,CAYT;AAkDD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAiE7E;AAMD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,MAAM,GAChB,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAYzB;AAiCD;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,EACnC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC,CAavB"}

package/dist/workflow/audit-recovery.js

@@ -0,0 +1,242 @@
+/**
+ * Recovery system for the audit feature.
+ *
+ * Evidence-based trigger logic, finding-to-milestone conversion,
+ * and safe state injection for recovery execution.
+ */
+import { addMilestones, updateState } from '../state/index.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const RECOVERY_PREFIX = '[RECOVERY]';
+const ACTIONABLE_CATEGORIES = new Set([
+    'integration-wiring',
+    'test-coverage',
+    'config-deployment',
+]);
+const DEFAULT_SCORE_THRESHOLD = 70;
+// ---------------------------------------------------------------------------
+// Trigger logic
+// ---------------------------------------------------------------------------
+/**
+ * Determine if recovery should be triggered based on evidence in the report.
+ *
+ * Trigger conditions (any one suffices):
+ * - criticalCount > 0
+ * - strict mode AND majorCount > 0
+ * - overallScore < threshold AND at least one finding is autoFixable
+ *   or belongs to an actionable category
+ *
+ * Does NOT trigger on info-only or purely cosmetic issues.
+ *
+ * @param report - The audit report.
+ * @param strict - Whether strict mode is active.
+ * @returns True if recovery should be triggered.
+ */
+export function shouldTriggerRecovery(report, strict) {
+    if (report.criticalCount > 0)
+        return true;
+    if (strict && report.majorCount > 0)
+        return true;
+    if (report.overallScore < DEFAULT_SCORE_THRESHOLD) {
+        const hasActionable = report.findings.some((f) => f.autoFixable || ACTIONABLE_CATEGORIES.has(f.category));
+        if (hasActionable)
+            return true;
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Recovery plan generation
+// ---------------------------------------------------------------------------
+/**
+ * Infer the target component from a finding's evidence file paths.
+ *
+ * @param finding - An audit finding.
+ * @returns The most likely component kind.
+ */
+function inferAppTarget(finding) {
+    const paths = finding.evidence.map((e) => e.file);
+    for (const p of paths) {
+        if (p.includes('frontend') || p.includes('web') || p.includes('client'))
+            return 'frontend';
+        if (p.includes('backend') || p.includes('api') || p.includes('server'))
+            return 'backend';
+        if (p.includes('website') || p.includes('landing'))
+            return 'website';
+        if (p.includes('infra') || p.includes('docker') || p.includes('deploy'))
+            return 'infra';
+    }
+    // Reason: Fall back based on category
+    if (finding.category === 'integration-wiring')
+        return 'backend';
+    if (finding.category === 'test-coverage')
+        return 'shared';
+    if (finding.category === 'config-deployment')
+        return 'infra';
+    return 'shared';
+}
+/**
+ * Convert a finding into a recovery task.
+ *
+ * @param finding - An audit finding.
+ * @returns A recovery task.
+ */
+function findingToRecoveryTask(finding) {
+    return {
+        name: finding.title,
+        description: `${finding.description}\n\nRecommendation: ${finding.recommendation}`,
+        findingIds: [finding.id],
+        acceptanceCriteria: [
+            finding.recommendation,
+            `Verify finding ${finding.id} is resolved`,
+        ],
+        testPlan: finding.category === 'test-coverage'
+            ? 'Add missing tests and verify they pass'
+            : undefined,
+        appTarget: inferAppTarget(finding),
+    };
+}
+/**
+ * Generate a recovery plan from audit report findings.
+ *
+ * Groups findings into milestones by severity:
+ * - Critical -> [RECOVERY] Critical Fixes
+ * - Major -> [RECOVERY] Major Improvements (grouped by category)
+ * - Minor + autoFixable -> [RECOVERY] Polish
+ *
+ * @param report - The audit report.
+ * @returns A structured recovery plan.
+ */
+export function generateRecoveryPlan(report) {
+    const milestones = [];
+    // Critical findings -> separate milestone
+    const criticalFindings = report.findings.filter((f) => f.severity === 'critical');
+    if (criticalFindings.length > 0) {
+        milestones.push({
+            name: `${RECOVERY_PREFIX} Critical Fixes`,
+            description: 'Address all critical audit findings that block production readiness.',
+            tasks: criticalFindings.map(findingToRecoveryTask),
+        });
+    }
+    // Major findings -> grouped by category
+    const majorFindings = report.findings.filter((f) => f.severity === 'major');
+    if (majorFindings.length > 0) {
+        // Group by category
+        const byCategory = new Map();
+        for (const f of majorFindings) {
+            const existing = byCategory.get(f.category) ?? [];
+            existing.push(f);
+            byCategory.set(f.category, existing);
+        }
+        const majorTasks = [];
+        for (const [, findings] of byCategory) {
+            majorTasks.push(...findings.map(findingToRecoveryTask));
+        }
+        milestones.push({
+            name: `${RECOVERY_PREFIX} Major Improvements`,
+            description: 'Address major audit findings that significantly affect quality.',
+            tasks: majorTasks,
+        });
+    }
+    // Minor + autoFixable -> polish milestone
+    const polishFindings = report.findings.filter((f) => f.severity === 'minor' && f.autoFixable);
+    if (polishFindings.length > 0) {
+        milestones.push({
+            name: `${RECOVERY_PREFIX} Polish`,
+            description: 'Address minor auto-fixable findings for polish.',
+            tasks: polishFindings.map(findingToRecoveryTask),
+        });
+    }
+    // Estimate effort based on finding count and severity
+    const effortHours = criticalFindings.length * 2 + majorFindings.length * 1 + polishFindings.length * 0.5;
+    const estimatedEffort = effortHours <= 2
+        ? '1-2 hours'
+        : effortHours <= 8
+            ? `${Math.ceil(effortHours / 2)}-${Math.ceil(effortHours)} hours`
+            : `${Math.ceil(effortHours / 8)} days`;
+    return {
+        generatedAt: new Date().toISOString(),
+        auditScore: report.overallScore,
+        auditRunId: report.auditRunId,
+        totalFindings: report.findings.length,
+        criticalFindings: report.criticalCount,
+        milestones,
+        estimatedEffort,
+    };
+}
+// ---------------------------------------------------------------------------
+// Recovery -> milestone conversion
+// ---------------------------------------------------------------------------
+/**
+ * Convert a recovery plan into milestone objects compatible with addMilestones().
+ *
+ * Each recovery milestone becomes an Omit<Milestone, 'id'> with tasks
+ * that have the standard Task shape.
+ *
+ * @param recovery - The recovery plan.
+ * @param language - Project language (for task context).
+ * @returns Array of milestone objects ready for addMilestones().
+ */
+export function recoveryToMilestones(recovery, _language) {
+    return recovery.milestones.map((rm) => ({
+        name: rm.name,
+        description: rm.description,
+        status: 'pending',
+        tasks: rm.tasks.map((rt) => ({
+            id: '', // Reason: addMilestones() auto-assigns IDs
+            name: rt.name,
+            description: buildTaskDescription(rt),
+            status: 'pending',
+        })),
+    }));
+}
+/**
+ * Build a detailed task description for execution.
+ *
+ * @param task - Recovery task.
+ * @param language - Project language.
+ * @returns Formatted description string.
+ */
+function buildTaskDescription(task) {
+    const parts = [task.description];
+    parts.push(`\nTarget component: ${task.appTarget}`);
+    parts.push(`Related findings: ${task.findingIds.join(', ')}`);
+    if (task.acceptanceCriteria.length > 0) {
+        parts.push('\nAcceptance criteria:');
+        for (const ac of task.acceptanceCriteria) {
+            parts.push(`- ${ac}`);
+        }
+    }
+    if (task.testPlan) {
+        parts.push(`\nTest plan: ${task.testPlan}`);
+    }
+    return parts.join('\n');
+}
+// ---------------------------------------------------------------------------
+// State injection
+// ---------------------------------------------------------------------------
+/**
+ * Inject recovery milestones into the project state.
+ *
+ * This APPENDS recovery milestones — it never clobbers existing milestones.
+ * Milestone names are prefixed with [RECOVERY] for visibility.
+ * Sets audit tracking fields and switches phase to 'execution'.
+ *
+ * @param projectDir - Project root directory.
+ * @param milestones - Recovery milestones (without IDs).
+ * @param auditRunId - The audit run identifier for lineage.
+ * @returns Updated project state.
+ */
+export async function injectRecoveryIntoState(projectDir, milestones, auditRunId) {
+    // Reason: addMilestones appends to existing milestones, no clobbering
+    await addMilestones(projectDir, milestones);
+    const updatedState = await updateState(projectDir, {
+        phase: 'execution',
+        status: 'in-progress',
+        auditRecoveryInProgress: true,
+        auditRunId,
+        auditLastRunAt: new Date().toISOString(),
+    });
+    return updatedState;
+}
+//# sourceMappingURL=audit-recovery.js.map

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * Report generation for the audit system.
+ *
+ * Builds summary + full reports, writes markdown and JSON artifacts
+ * to the project's .popeye/ directory.
+ */
+import type { ProjectState } from '../types/workflow.js';
+import type { AuditCategory, AuditFinding, AuditModeOptions, ProjectAuditReport, ProjectScanResult, ProjectSummaryReport, RecoveryPlan, SearchMetadata } from '../types/audit.js';
+/**
+ * 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 declare function buildSummaryReport(scan: ProjectScanResult, state: ProjectState, aiOverview?: string): ProjectSummaryReport;
+/**
+ * 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 declare function buildAuditReport(summary: ProjectSummaryReport, findings: AuditFinding[], scores: {
+    overallScore: number;
+    categoryScores: Record<AuditCategory, number>;
+}, searchMeta: SearchMetadata, options: Pick<AuditModeOptions, 'strict'>, auditRunId: string): ProjectAuditReport;
+/**
+ * Write the audit report as markdown.
+ *
+ * @param projectDir - Project root directory.
+ * @param report - The audit report.
+ * @returns Path to the written file.
+ */
+export declare function writeAuditMarkdown(projectDir: string, report: ProjectAuditReport): Promise<string>;
+/**
+ * Write the audit report as JSON.
+ *
+ * @param projectDir - Project root directory.
+ * @param report - The audit report.
+ * @returns Path to the written file.
+ */
+export declare function writeAuditJson(projectDir: string, report: ProjectAuditReport): Promise<string>;
+/**
+ * Write the recovery plan as markdown.
+ *
+ * @param projectDir - Project root directory.
+ * @param recovery - The recovery plan.
+ * @returns Path to the written file.
+ */
+export declare function writeRecoveryMarkdown(projectDir: string, recovery: RecoveryPlan): Promise<string>;
+/**
+ * Write the recovery plan as JSON.
+ *
+ * @param projectDir - Project root directory.
+ * @param recovery - The recovery plan.
+ * @returns Path to the written file.
+ */
+export declare function writeRecoveryJson(projectDir: string, recovery: RecoveryPlan): Promise<string>;
+//# sourceMappingURL=audit-reporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit-reporter.d.ts","sourceRoot":"","sources":["../../src/workflow/audit-reporter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAEhB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACf,MAAM,mBAAmB,CAAC;AAM3B;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,YAAY,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,oBAAoB,CA4BtB;AA0BD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;CAAE,EAC/E,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EACzC,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAmCpB;AA8JD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC,CAKjB"}