@jokerized/getresearchdone 0.4.1

package/dist/lib/phase-complete.js

@@ -0,0 +1,278 @@
+'use strict';
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._resolvePhaseSuccession = _resolvePhaseSuccession;
+exports._phaseCompleteCore = _phaseCompleteCore;
+exports.completePhaseAfterPostPipeline = completePhaseAfterPostPipeline;
+/**
+ * GRD Phase/Complete -- Core phase-completion logic.
+ *
+ * Extracted from lib/phase.ts as part of Spec 3 of the
+ * gsd-2-selective-adoption milestone. This module owns the "finalize a
+ * phase" side-effects: preflight gate check, ROADMAP.md checkbox +
+ * progress-table rewrite, STATE.md field rewrite, quality analysis,
+ * cleanup plan generation, and next-phase discovery.
+ *
+ * Two exports:
+ *   - _phaseCompleteCore: the existing core, used by cmdPhaseComplete
+ *     and cmdPhaseBatchComplete in lib/phase.ts.
+ *   - completePhaseAfterPostPipeline: new autopilot-safe wrapper that
+ *     catches all errors and returns null on failure instead of
+ *     throwing. Used by lib/autopilot.ts after the post-pipeline step.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const { runPreflightGates } = require('./gates');
+const { findPhaseInternal } = require('./utils');
+const { phasesDir: getPhasesDirPath } = require('./paths');
+const { readRoadmapFile, writeRoadmapFile, readStateFile, writeStateFile, clearRoadmapCache, clearStateCache, } = require('./phase-io');
+const { runQualityAnalysis, generateCleanupPlan } = require('./cleanup');
+const { loadConfig } = require('./utils');
+const { attemptLlmFallbackCompletion } = require('./phase-complete-llm');
+/**
+ * Resolves the phase succession context: plan counts, next phase, and last-phase
+ * flag. Shared by _phaseCompleteCore and the LLM fallback's _buildSyntheticResult
+ * so both produce consistent result fields.
+ *
+ * @param cwd - Project working directory
+ * @param phaseNum - Phase number being completed
+ */
+function _resolvePhaseSuccession(cwd, phaseNum) {
+    const phaseInfo = findPhaseInternal(cwd, phaseNum);
+    const phaseName = phaseInfo?.phase_name ?? '(unknown)';
+    const planCount = phaseInfo?.plans?.length ?? 0;
+    const summaryCount = phaseInfo?.summaries?.length ?? 0;
+    const plansExecuted = `${summaryCount}/${planCount}`;
+    const basePhasesDir = getPhasesDirPath(cwd);
+    let nextPhaseNum = null;
+    let nextPhaseName = null;
+    let isLastPhase = true;
+    try {
+        const entries = fs.readdirSync(basePhasesDir, { withFileTypes: true });
+        const dirs = entries
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name)
+            .sort();
+        const currentFloat = parseFloat(phaseNum);
+        for (const dir of dirs) {
+            const m = dir.match(/^(\d+(?:\.\d+)?)-?(.*)/);
+            if (m && parseFloat(m[1]) > currentFloat) {
+                nextPhaseNum = m[1];
+                nextPhaseName = m[2] || null;
+                isLastPhase = false;
+                break;
+            }
+        }
+    }
+    catch {
+        // phases dir missing — leave isLastPhase = true
+    }
+    return { phaseName, plansExecuted, nextPhaseNum, nextPhaseName, isLastPhase };
+}
+/**
+ * Core logic for phase completion -- shared by cmdPhaseComplete and
+ * cmdPhaseBatchComplete. Moved from lib/phase.ts in Spec 3 without
+ * behavior changes.
+ *
+ * @param cwd - Project working directory
+ * @param phaseNum - Phase number to mark complete
+ * @param options - Completion options (dryRun, force, skip_cleanup)
+ */
+function _phaseCompleteCore(cwd, phaseNum, options) {
+    const dryRun = (options && options.dryRun) || false;
+    // Dry-run: return preview without modifying anything
+    if (dryRun) {
+        const phaseInfo = findPhaseInternal(cwd, phaseNum);
+        return {
+            dry_run: true,
+            would_complete_phase: phaseNum,
+            phase_found: !!phaseInfo,
+        };
+    }
+    // Spec 3B cleanup: invalidate caches in case a prior LLM fallback
+    // in the same process wrote these files directly.
+    clearRoadmapCache(path.join(cwd, '.planning', 'ROADMAP.md'));
+    clearStateCache(path.join(cwd, '.planning', 'STATE.md'));
+    // Pre-flight gate checks
+    const gates = runPreflightGates(cwd, 'phase-complete', {
+        phase: phaseNum,
+    });
+    if (!gates.passed) {
+        return {
+            gate_failed: true,
+            gate_errors: gates.errors,
+            gate_warnings: gates.warnings,
+        };
+    }
+    const roadmapPath = path.join(cwd, '.planning', 'ROADMAP.md');
+    const statePath = path.join(cwd, '.planning', 'STATE.md');
+    const today = new Date().toISOString().split('T')[0];
+    // Verify phase info
+    const phaseInfo = findPhaseInternal(cwd, phaseNum);
+    if (!phaseInfo) {
+        throw new Error(`Phase ${phaseNum} not found`);
+    }
+    const planCount = phaseInfo.plans.length;
+    const summaryCount = phaseInfo.summaries.length;
+    // Update ROADMAP.md: mark phase complete
+    if (fs.existsSync(roadmapPath)) {
+        let roadmapContent = readRoadmapFile(roadmapPath);
+        // Checkbox: - [ ] Phase N: -> - [x] Phase N: (...completed DATE)
+        const checkboxPattern = new RegExp(`(-\\s*\\[)[ ](\\]\\s*.*Phase\\s+${phaseNum.replace(/\./g, '\\.')}[:\\s][^\\n]*)`, 'i');
+        roadmapContent = roadmapContent.replace(checkboxPattern, `$1x$2 (completed ${today})`);
+        // Progress table: update Status to Complete, add date
+        const phaseEscaped = phaseNum.replace(/\./g, '\\.');
+        const tablePattern = new RegExp(`(\\|\\s*${phaseEscaped}\\.?\\s[^|]*\\|[^|]*\\|)\\s*[^|]*(\\|)\\s*[^|]*(\\|)`, 'i');
+        roadmapContent = roadmapContent.replace(tablePattern, `$1 Complete    $2 ${today} $3`);
+        // Update plan count in phase section
+        const planCountPattern = new RegExp(`(#{2,}\\s*Phase\\s+${phaseEscaped}[\\s\\S]*?\\*\\*Plans:\\*\\*\\s*)[^\\n]+`, 'i');
+        roadmapContent = roadmapContent.replace(planCountPattern, `$1${summaryCount}/${planCount} plans complete`);
+        writeRoadmapFile(roadmapPath, roadmapContent);
+    }
+    // Find next phase using shared helper
+    const { nextPhaseNum, nextPhaseName, isLastPhase } = _resolvePhaseSuccession(cwd, phaseNum);
+    // Update STATE.md
+    if (fs.existsSync(statePath)) {
+        let stateContent = readStateFile(statePath);
+        // Update Current Phase
+        stateContent = stateContent.replace(/(\*\*Current Phase:\*\*\s*).*/, `$1${nextPhaseNum || phaseNum}`);
+        // Update Current Phase Name
+        if (nextPhaseName) {
+            stateContent = stateContent.replace(/(\*\*Current Phase Name:\*\*\s*).*/, `$1${nextPhaseName.replace(/-/g, ' ')}`);
+        }
+        // Update Status
+        stateContent = stateContent.replace(/(\*\*Status:\*\*\s*).*/, `$1${isLastPhase ? 'Milestone complete' : 'Ready to plan'}`);
+        // Update Current Plan
+        stateContent = stateContent.replace(/(\*\*Current Plan:\*\*\s*).*/, `$1Not started`);
+        // Update Last Activity
+        stateContent = stateContent.replace(/(\*\*Last Activity:\*\*\s*).*/, `$1${today}`);
+        // Update Last Activity Description
+        stateContent = stateContent.replace(/(\*\*Last Activity Description:\*\*\s*).*/, `$1Phase ${phaseNum} complete${nextPhaseNum ? `, transitioned to Phase ${nextPhaseNum}` : ''}`);
+        writeStateFile(statePath, stateContent);
+    }
+    // Run quality analysis if enabled
+    let qualityReport = null;
+    try {
+        const qaResult = runQualityAnalysis(cwd, phaseNum);
+        if (!qaResult.skipped) {
+            qualityReport = qaResult;
+        }
+    }
+    catch {
+        // Quality analysis is non-blocking; swallow errors
+    }
+    // Generate cleanup plan if quality issues exceed threshold
+    let cleanupPlanResult = null;
+    if (qualityReport && !qualityReport.skipped) {
+        try {
+            cleanupPlanResult = generateCleanupPlan(cwd, phaseNum, qualityReport);
+        }
+        catch {
+            // Cleanup plan generation is non-blocking
+        }
+    }
+    return {
+        completed_phase: phaseNum,
+        phase_name: phaseInfo.phase_name,
+        plans_executed: `${summaryCount}/${planCount}`,
+        next_phase: nextPhaseNum,
+        next_phase_name: nextPhaseName,
+        is_last_phase: isLastPhase,
+        date: today,
+        roadmap_updated: fs.existsSync(roadmapPath),
+        state_updated: fs.existsSync(statePath),
+        ...(qualityReport ? { quality_report: qualityReport } : {}),
+        ...(cleanupPlanResult ? { cleanup_plan_generated: cleanupPlanResult } : {}),
+    };
+}
+/**
+ * Autopilot-safe wrapper around _phaseCompleteCore. Runs the existing
+ * phase-complete gates and core logic, catches any error, logs it to
+ * stderr, and returns null on failure instead of throwing.
+ *
+ * Autopilot calls this after a successful post-pipeline step; a
+ * completion failure is logged as a status marker but does not crash
+ * the autopilot run.
+ *
+ * When the mechanical path fails and config.phase_complete_llm_fallback
+ * is true, delegates to attemptLlmFallbackCompletion (Spec 3B).
+ *
+ * @param cwd - project root
+ * @param phaseNum - phase number string (e.g., '03' or '3')
+ * @param scheduler - optional scheduler for LLM fallback (Spec 3B)
+ * @returns PhaseCompleteResult on success, null on any failure
+ */
+async function completePhaseAfterPostPipeline(cwd, phaseNum, scheduler) {
+    let mechanicalFailure;
+    try {
+        const result = _phaseCompleteCore(cwd, phaseNum);
+        if (result.gate_failed) {
+            mechanicalFailure = { gate_errors: result.gate_errors };
+            const msgs = (result.gate_errors || []).map((g) => g.message).join('; ');
+            process.stderr.write(`[autopilot] phase-finalize: gates failed for phase ${phaseNum}: ${msgs}\n`);
+        }
+        else if (result.dry_run) {
+            return null;
+        }
+        else {
+            return result;
+        }
+    }
+    catch (e) {
+        mechanicalFailure = e;
+        process.stderr.write(`[autopilot] phase-finalize: error completing phase ${phaseNum}: ${e.message}\n`);
+    }
+    // Mechanical failed — try LLM fallback if opted in
+    if (!mechanicalFailure)
+        return null;
+    let fallbackEnabled = false;
+    try {
+        const config = loadConfig(cwd);
+        fallbackEnabled = config.phase_complete_llm_fallback === true;
+    }
+    catch {
+        // loadConfig failure — proceed without fallback
+    }
+    if (fallbackEnabled && scheduler) {
+        return await attemptLlmFallbackCompletion(cwd, phaseNum, scheduler, mechanicalFailure);
+    }
+    return null;
+}
+module.exports = {
+    _phaseCompleteCore,
+    _resolvePhaseSuccession,
+    completePhaseAfterPostPipeline,
+};
+//# sourceMappingURL=phase-complete.js.map

package/dist/lib/phase-complete.js.map

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

package/dist/lib/phase-io.d.ts

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

package/dist/lib/phase-io.d.ts.map

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

package/dist/lib/phase-io.js

@@ -0,0 +1,126 @@
+'use strict';
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * GRD Phase/IO -- Shared file I/O helpers for ROADMAP.md and STATE.md.
+ *
+ * Extracted from lib/phase.ts and lib/phase-complete.ts as a post-Spec-3
+ * cleanup. Both modules now import from here instead of duplicating the
+ * implementation. A single shared write-through cache lives in this
+ * module so reads and writes are consistent across both callers.
+ */
+const fs = __importStar(require("fs"));
+// ─── File Caches ──────────────────────────────────────────────────────────────
+// Module-level cache with write-through for roadmap file reads.
+// Prevents redundant disk reads across phase operations; writes update the cache.
+const _roadmapFileCache = new Map();
+/**
+ * Read ROADMAP.md from disk (or from write-through cache on repeated reads).
+ * @param roadmapPath - Absolute path to the ROADMAP.md file
+ * @returns File contents as a UTF-8 string
+ */
+function readRoadmapFile(roadmapPath) {
+    if (!_roadmapFileCache.has(roadmapPath)) {
+        _roadmapFileCache.set(roadmapPath, fs.readFileSync(roadmapPath, 'utf-8'));
+    }
+    return _roadmapFileCache.get(roadmapPath);
+}
+/**
+ * Write ROADMAP.md to disk and update the write-through cache.
+ * @param roadmapPath - Absolute path to the ROADMAP.md file
+ * @param content - New file contents to write
+ */
+function writeRoadmapFile(roadmapPath, content) {
+    fs.writeFileSync(roadmapPath, content, 'utf-8');
+    _roadmapFileCache.set(roadmapPath, content);
+}
+// Module-level cache with write-through for state file reads.
+// Prevents redundant disk reads across phase operations; writes update the cache.
+const _stateFileCache = new Map();
+/**
+ * Read STATE.md from disk (or from write-through cache on repeated reads).
+ * @param statePath - Absolute path to the STATE.md file
+ * @returns File contents as a UTF-8 string
+ */
+function readStateFile(statePath) {
+    if (!_stateFileCache.has(statePath)) {
+        _stateFileCache.set(statePath, fs.readFileSync(statePath, 'utf-8'));
+    }
+    return _stateFileCache.get(statePath);
+}
+/**
+ * Write STATE.md to disk and update the write-through cache.
+ * @param statePath - Absolute path to the STATE.md file
+ * @param content - New file contents to write
+ */
+function writeStateFile(statePath, content) {
+    fs.writeFileSync(statePath, content, 'utf-8');
+    _stateFileCache.set(statePath, content);
+}
+/**
+ * Invalidates the cached content for a specific ROADMAP.md path, or
+ * the entire cache if no path is given. Used by phase-complete-llm
+ * after LLM fallback writes, and by _phaseCompleteCore at the start
+ * of a run to guarantee a fresh read.
+ */
+function clearRoadmapCache(filePath) {
+    if (filePath === undefined) {
+        _roadmapFileCache.clear();
+    }
+    else {
+        _roadmapFileCache.delete(filePath);
+    }
+}
+/**
+ * Invalidates the cached content for a specific STATE.md path, or
+ * the entire cache if no path is given.
+ */
+function clearStateCache(filePath) {
+    if (filePath === undefined) {
+        _stateFileCache.clear();
+    }
+    else {
+        _stateFileCache.delete(filePath);
+    }
+}
+module.exports = {
+    readRoadmapFile,
+    writeRoadmapFile,
+    readStateFile,
+    writeStateFile,
+    clearRoadmapCache,
+    clearStateCache,
+};
+//# sourceMappingURL=phase-io.js.map

package/dist/lib/phase-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-io.js","sourceRoot":"","sources":["../../lib/phase-io.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEb;;;;;;;GAOG;AAEH,uCAAyB;AAEzB,iFAAiF;AAEjF,gEAAgE;AAChE,kFAAkF;AAClF,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEpD;;;;GAIG;AACH,SAAS,eAAe,CAAC,WAAmB;IAC1C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QACxC,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAW,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAW,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,WAAmB,EAAE,OAAe;IAC5D,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,8DAA8D;AAC9D,kFAAkF;AAClF,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;AAElD;;;;GAIG;AACH,SAAS,aAAa,CAAC,SAAiB;IACtC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAW,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,eAAe,CAAC,GAAG,CAAC,SAAS,CAAW,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,SAAiB,EAAE,OAAe;IACxD,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,QAAiB;IAC1C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,iBAAiB,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;SAAM,CAAC;QACN,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,QAAiB;IACxC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,eAAe,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,OAAO,GAAG;IACf,eAAe;IACf,gBAAgB;IAChB,aAAa;IACb,cAAc;IACd,iBAAiB;IACjB,eAAe;CAChB,CAAC"}

package/dist/lib/phase.d.ts

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

package/dist/lib/phase.d.ts.map

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