@jokerized/getresearchdone 0.4.1

package/dist/lib/wireup/report.js

@@ -0,0 +1,201 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = require('fs');
+const path = require('path');
+const { currentMilestone, } = require('../paths');
+// ─── Path Helper ─────────────────────────────────────────────────────────────
+/**
+ * Resolve the absolute path to WIREUP-REPORT.md for the current milestone.
+ *
+ * @param cwd - Absolute path to the project root.
+ * @returns Absolute path: {cwd}/.planning/milestones/{milestone}/wireup/WIREUP-REPORT.md
+ */
+function formatReportPath(cwd) {
+    const milestone = currentMilestone(cwd);
+    return path.join(cwd, '.planning', 'milestones', milestone, 'wireup', 'WIREUP-REPORT.md');
+}
+// ─── Iteration History Extraction ─────────────────────────────────────────────
+/**
+ * Extract existing iteration history table rows from a WIREUP-REPORT.md file.
+ *
+ * Finds the `## Iteration History` section and returns all data rows
+ * (excluding the header row and separator row). Returns an empty string
+ * when the section is absent or contains no data rows.
+ *
+ * @param existingContent - Raw content of an existing WIREUP-REPORT.md file.
+ * @returns Table data rows (each separated by '\n'), or '' if none found.
+ */
+function extractIterationHistory(existingContent) {
+    // Find the ## Iteration History section
+    const sectionMatch = existingContent.match(/## Iteration History\s*\n([\s\S]*?)(?:\n## |\n*$)/);
+    if (!sectionMatch)
+        return '';
+    const sectionContent = sectionMatch[1];
+    // Split into lines and extract data rows (skip header and separator lines)
+    const lines = sectionContent.split('\n');
+    const dataRows = lines.filter((line) => {
+        const trimmed = line.trim();
+        // Keep rows that start with '|' but are NOT header or separator rows
+        if (!trimmed.startsWith('|'))
+            return false;
+        // Skip separator rows (contain only dashes, pipes, spaces)
+        if (/^\|[\s\-|]+\|$/.test(trimmed))
+            return false;
+        // Skip the header row (contains column names like 'Iteration')
+        if (trimmed.includes('| Iteration |') || trimmed.includes('|Iteration|'))
+            return false;
+        return true;
+    });
+    return dataRows.join('\n');
+}
+// ─── Report Generation ───────────────────────────────────────────────────────
+/**
+ * Generate and write WIREUP-REPORT.md for a wireup iteration.
+ *
+ * The report file is written to:
+ *   {cwd}/.planning/milestones/{milestone}/wireup/WIREUP-REPORT.md
+ *
+ * If the file already exists, the main report sections (Summary through Remaining
+ * Unwired Features) are overwritten with fresh data, but the ## Iteration History
+ * section is preserved and the new iteration's row is appended.
+ *
+ * @param cwd  - Absolute path to the project root.
+ * @param data - Report data for the current iteration.
+ * @returns The absolute path where WIREUP-REPORT.md was written.
+ */
+function generateWireupReport(cwd, data) {
+    const reportPath = formatReportPath(cwd);
+    // Ensure the wireup directory exists
+    const wireupDir = path.dirname(reportPath);
+    fs.mkdirSync(wireupDir, { recursive: true });
+    // Read existing report (if any) to preserve iteration history
+    let existingHistory = '';
+    try {
+        const existingContent = fs.readFileSync(reportPath, 'utf-8');
+        existingHistory = extractIterationHistory(existingContent);
+    }
+    catch {
+        // File does not exist yet — start with empty history
+    }
+    // ─── Build new iteration history row ──────────────────────────────────────
+    const dateStr = data.timestamp.slice(0, 10); // YYYY-MM-DD
+    const newHistoryRow = `| ${data.iteration} | ${dateStr} | ${data.scenarios.total} | ${data.scenarios.passed} | ${data.scenarios.failed} | ${data.scenarios.skipped} | ${data.issues_found.length} | ${data.fixes.verified + data.fixes.failed} | ${data.fixes.verified} |`;
+    const historyRows = existingHistory
+        ? existingHistory + '\n' + newHistoryRow
+        : newHistoryRow;
+    // ─── Build Issues Found table ──────────────────────────────────────────────
+    let issuesTable;
+    if (data.issues_found.length === 0) {
+        issuesTable = '_No issues detected._';
+    }
+    else {
+        const rows = data.issues_found
+            .map((issue, idx) => {
+            const fixAttempt = data.fixes.applied.find((f) => f.issue.scenario_id === issue.scenario_id && f.issue.issue_type === issue.issue_type);
+            const fixStatus = fixAttempt ? fixAttempt.fix_status : 'skipped';
+            return `| ${idx + 1} | ${issue.issue_type} | ${issue.source_file} | ${issue.target_file} | ${issue.confidence} | ${fixStatus} |`;
+        })
+            .join('\n');
+        issuesTable =
+            `| # | Type | Source | Target | Confidence | Fix Status |\n` +
+                `|---|------|--------|--------|------------|------------|\n` +
+                rows;
+    }
+    // ─── Build Fixes Applied table ────────────────────────────────────────────
+    let fixesTable;
+    if (data.fixes.applied.length === 0) {
+        fixesTable = '_No fixes attempted._';
+    }
+    else {
+        const rows = data.fixes.applied
+            .map((fix, idx) => {
+            const rerunStr = fix.rerun_passed === true ? 'Yes' : fix.rerun_passed === false ? 'No' : 'N/A';
+            const description = fix.fix_description ?? fix.error ?? '—';
+            return `| ${idx + 1} | ${fix.issue.issue_type} | ${description} | ${fix.fix_status} | ${rerunStr} |`;
+        })
+            .join('\n');
+        fixesTable =
+            `| # | Issue Type | Description | Status | Re-run Passed |\n` +
+                `|---|------------|-------------|--------|---------------|\n` +
+                rows;
+    }
+    // ─── Build Manual Review section ──────────────────────────────────────────
+    let manualReviewSection;
+    if (data.manual_review.length === 0) {
+        manualReviewSection = '_All detected issues are high-confidence and were auto-fixed._';
+    }
+    else {
+        manualReviewSection = data.manual_review
+            .map((issue) => {
+            return (`### ${issue.issue_type}: ${issue.source_file} -> ${issue.target_file}\n` +
+                `**Confidence:** ${issue.confidence}\n` +
+                `**Suggested Fix:** ${issue.suggested_fix}`);
+        })
+            .join('\n\n');
+    }
+    // ─── Build Remaining Unwired Features list ────────────────────────────────
+    let remainingSection;
+    if (data.remaining_unwired.length === 0) {
+        remainingSection = '_All tested features are now wired._';
+    }
+    else {
+        remainingSection = data.remaining_unwired.map((f) => `- ${f}`).join('\n');
+    }
+    // ─── Assemble full report ─────────────────────────────────────────────────
+    const report = `# Wireup Report\n` +
+        `\n` +
+        `**Milestone:** ${data.milestone}\n` +
+        `**Iteration:** ${data.iteration}\n` +
+        `**Generated:** ${data.timestamp}\n` +
+        `\n` +
+        `## Summary\n` +
+        `\n` +
+        `| Metric | Count |\n` +
+        `|--------|-------|\n` +
+        `| Features Tested | ${data.features_tested} |\n` +
+        `| Scenarios Run | ${data.scenarios.total} |\n` +
+        `| Scenarios Passed | ${data.scenarios.passed} |\n` +
+        `| Scenarios Failed | ${data.scenarios.failed} |\n` +
+        `| Scenarios Skipped | ${data.scenarios.skipped} |\n` +
+        `| Issues Found | ${data.issues_found.length} |\n` +
+        `| Fixes Applied | ${data.fixes.verified + data.fixes.failed} |\n` +
+        `| Fixes Verified | ${data.fixes.verified} |\n` +
+        `| Fixes Failed | ${data.fixes.failed} |\n` +
+        `| Remaining Unwired | ${data.remaining_unwired.length} |\n` +
+        `\n` +
+        `## Issues Found\n` +
+        `\n` +
+        issuesTable +
+        `\n` +
+        `\n` +
+        `## Fixes Applied\n` +
+        `\n` +
+        fixesTable +
+        `\n` +
+        `\n` +
+        `## Requires Manual Review\n` +
+        `\n` +
+        manualReviewSection +
+        `\n` +
+        `\n` +
+        `## Remaining Unwired Features\n` +
+        `\n` +
+        remainingSection +
+        `\n` +
+        `\n` +
+        `## Iteration History\n` +
+        `\n` +
+        `| Iteration | Date | Scenarios | Passed | Failed | Skipped | Issues | Fixes | Verified |\n` +
+        `|-----------|------|-----------|--------|--------|---------|--------|-------|----------|\n` +
+        historyRows +
+        `\n`;
+    fs.writeFileSync(reportPath, report, 'utf-8');
+    return reportPath;
+}
+// ─── Exports ─────────────────────────────────────────────────────────────────
+module.exports = {
+    generateWireupReport,
+    formatReportPath,
+    extractIterationHistory,
+};
+//# sourceMappingURL=report.js.map

package/dist/lib/wireup/report.js.map

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

package/dist/lib/wireup/scenarios.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scenarios.d.ts.map

package/dist/lib/wireup/scenarios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarios.d.ts","sourceRoot":"","sources":["../../../lib/wireup/scenarios.ts"],"names":[],"mappings":""}