@jokerized/getresearchdone 0.4.1

package/dist/lib/phase-complete-llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-complete-llm.d.ts","sourceRoot":"","sources":["../../lib/phase-complete-llm.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAqK7C,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf;IACD,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CAC7C,CAiBA;AAuHD;;;;;;;;GAQG;AACH,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,OAAO,EAAE,KAAK,GAAG;IAAE,WAAW,CAAC,EAAE,aAAa,EAAE,CAAA;CAAE,GACjD,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA6BrC"}

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

@@ -0,0 +1,331 @@
+'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._verifyFallbackOutput = _verifyFallbackOutput;
+exports.attemptLlmFallbackCompletion = attemptLlmFallbackCompletion;
+/**
+ * GRD Phase/Complete/LLM -- Opt-in LLM fallback for mechanical phase
+ * completion failures.
+ *
+ * When _phaseCompleteCore throws or returns gate_failed, and the user
+ * has opted in via config.phase_complete_llm_fallback = true, this
+ * module asks Claude (via the scheduler) to perform the phase finalize
+ * by editing ROADMAP.md and STATE.md directly.
+ *
+ * Verification is shallow: after the subprocess exits, we re-read
+ * ROADMAP.md and check for `- [x] Phase N`. If ticked, the fallback
+ * is considered successful. Otherwise returns null.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const promises_1 = require("timers/promises");
+const { incrementCounter } = require('./metrics');
+const FALLBACK_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes max
+const PROMPT_MAX_CONTEXT_BYTES = 100_000; // 100KB ceiling
+function _readFileTruncated(filePath, maxBytes) {
+    try {
+        const buf = fs.readFileSync(filePath);
+        if (buf.length > maxBytes) {
+            return (buf.subarray(0, maxBytes).toString('utf-8') +
+                `\n\n[... truncated, original ${buf.length} bytes]\n`);
+        }
+        return buf.toString('utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+function _listPhaseDirContents(phaseDir) {
+    try {
+        return fs.readdirSync(phaseDir).sort();
+    }
+    catch {
+        return [];
+    }
+}
+function _describeFailure(failure) {
+    if (failure instanceof Error)
+        return `Exception: ${failure.message}`;
+    if ('gate_errors' in failure && failure.gate_errors) {
+        return `Gate failures: ${failure.gate_errors.map((g) => g.message).join('; ')}`;
+    }
+    return 'Unknown mechanical failure';
+}
+function _buildPrompt(phaseNum, roadmapContent, stateContent, phaseDirFiles, failureDescription) {
+    return [
+        `You are finalizing GRD Phase ${phaseNum} after the mechanical regex-based`,
+        `completion failed. Your job is to update .planning/ROADMAP.md and`,
+        `.planning/STATE.md directly using your file-editing tools.`,
+        '',
+        `Failure reason: ${failureDescription}`,
+        '',
+        `Phase directory contents:`,
+        phaseDirFiles.length > 0
+            ? phaseDirFiles.map((f) => `  - ${f}`).join('\n')
+            : '  (empty or missing)',
+        '',
+        `## Current .planning/ROADMAP.md`,
+        '',
+        '```markdown',
+        roadmapContent || '[MISSING]',
+        '```',
+        '',
+        `## Current .planning/STATE.md`,
+        '',
+        '```markdown',
+        stateContent || '[MISSING]',
+        '```',
+        '',
+        `## Your task`,
+        '',
+        `1. Update ROADMAP.md so that the Phase ${phaseNum} entry is marked as`,
+        `   completed. The exact format varies by project, but the canonical`,
+        `   pattern is to change \`- [ ] Phase ${phaseNum}: ...\` into`,
+        `   \`- [x] Phase ${phaseNum}: ... (completed ${new Date().toISOString().split('T')[0]})\`.`,
+        `   If the roadmap has a progress table or status column, update that`,
+        `   row to indicate Complete with today's date.`,
+        '',
+        `2. Update STATE.md so that Current Phase advances past ${phaseNum}`,
+        `   if there is a next phase, or to "Milestone complete" if ${phaseNum}`,
+        `   was the last phase. Update Last Activity to today's date and`,
+        `   Last Activity Description to reflect the completion.`,
+        '',
+        `3. Do NOT modify any other files.`,
+        '',
+        `4. Do NOT run any subcommands beyond file editing (no git, no npm,`,
+        `   no grd commands). Just edit the two files.`,
+        '',
+        `Start now. Use your file-editing tools.`,
+    ].join('\n');
+}
+function _verifyRoadmapTicked(cwd, phaseNum) {
+    const roadmapPath = path.join(cwd, '.planning', 'ROADMAP.md');
+    try {
+        const content = fs.readFileSync(roadmapPath, 'utf-8');
+        const pattern = new RegExp(`-\\s*\\[x\\]\\s*Phase\\s+${phaseNum.replace('.', '\\.')}[\\s:]`, 'i');
+        return pattern.test(content);
+    }
+    catch {
+        return false;
+    }
+}
+function _verifyStateAdvanced(cwd, phaseNum) {
+    const statePath = path.join(cwd, '.planning', 'STATE.md');
+    let content;
+    try {
+        content = fs.readFileSync(statePath, 'utf-8');
+    }
+    catch {
+        // Missing STATE.md is a verification failure — the LLM fallback
+        // should NEVER delete it. If it did, downstream state-dependent
+        // commands will break.
+        return false;
+    }
+    // Find the Current Phase line
+    const match = content.match(/\*\*Current Phase:\*\*\s*([^\n]*)/);
+    if (!match)
+        return true; // no Current Phase field — skip check
+    const currentPhase = match[1].trim().toLowerCase();
+    // Acceptable post-completion values:
+    //   - A different phase number (not phaseNum)
+    //   - Contains "complete" (e.g., "Milestone complete")
+    if (currentPhase.includes('complete'))
+        return true;
+    // Normalize: check if currentPhase starts with or equals phaseNum
+    // (handles "3", "03", "3:", "Phase 3", etc.)
+    const phasePattern = new RegExp(`^(phase\\s+)?0*${phaseNum.replace('.', '\\.')}(\\b|:|$)`, 'i');
+    return !phasePattern.test(currentPhase);
+}
+function _verifyProgressTableRow(cwd, phaseNum) {
+    const roadmapPath = path.join(cwd, '.planning', 'ROADMAP.md');
+    let content;
+    try {
+        content = fs.readFileSync(roadmapPath, 'utf-8');
+    }
+    catch {
+        return true; // missing — can't verify, assume ok
+    }
+    // Find a progress table row like `| 3 | ... | In Progress | ... |`.
+    // If no table is detected for this phase, skip the check (return true).
+    // If found, verify the Status column shows "Complete".
+    const rowPattern = new RegExp(`\\|\\s*0*${phaseNum.replace('.', '\\.')}\\s*\\|([^|]*\\|){1,4}\\s*Complete\\s*\\|`, 'i');
+    const rowPatternIncomplete = new RegExp(`\\|\\s*0*${phaseNum.replace('.', '\\.')}\\s*\\|[^\\n]*`, 'i');
+    const incompleteMatch = content.match(rowPatternIncomplete);
+    if (!incompleteMatch)
+        return true; // no row for this phase, skip
+    // We have a row — does it say Complete?
+    return rowPattern.test(content);
+}
+function _verifyFallbackOutput(cwd, phaseNum) {
+    const roadmapTicked = _verifyRoadmapTicked(cwd, phaseNum);
+    const stateAdvanced = _verifyStateAdvanced(cwd, phaseNum);
+    const progressRow = _verifyProgressTableRow(cwd, phaseNum);
+    const checks = [
+        { name: 'roadmap-ticked', passed: roadmapTicked },
+        { name: 'state-advanced', passed: stateAdvanced },
+        { name: 'progress-row', passed: progressRow },
+    ];
+    // Require roadmap-ticked AND state-advanced. progress-row is advisory
+    // (returns true for skipped). So `passed: true` for the advisory check
+    // doesn't distinguish between "passed" and "skipped", but that's OK —
+    // we're using it as a heuristic, not a hard gate.
+    const ok = roadmapTicked && stateAdvanced;
+    return { ok, checks };
+}
+function _buildSyntheticResult(cwd, phaseNum) {
+    const today = new Date().toISOString().split('T')[0];
+    const { _resolvePhaseSuccession } = require('./phase-complete');
+    const succession = _resolvePhaseSuccession(cwd, phaseNum);
+    return {
+        completed_phase: phaseNum,
+        phase_name: succession.phaseName,
+        plans_executed: succession.plansExecuted,
+        next_phase: succession.nextPhaseNum,
+        next_phase_name: succession.nextPhaseName,
+        is_last_phase: succession.isLastPhase,
+        date: today,
+        roadmap_updated: true,
+        state_updated: true,
+        llm_fallback: true,
+    };
+}
+/**
+ * Single attempt at LLM fallback phase completion. Builds the prompt,
+ * spawns the subprocess, and verifies the roadmap checkbox.
+ *
+ * @param cwd - project working directory
+ * @param phaseNum - phase number string (e.g., '3')
+ * @param scheduler - scheduler instance to use for spawning
+ * @param failure - the original mechanical failure description
+ * @param attemptIndex - zero-based attempt index (used for log prefix)
+ * @returns synthetic PhaseCompleteResult on success, null on any failure
+ */
+async function _attemptOnce(cwd, phaseNum, scheduler, failure, attemptIndex) {
+    const roadmapPath = path.join(cwd, '.planning', 'ROADMAP.md');
+    const statePath = path.join(cwd, '.planning', 'STATE.md');
+    const roadmap = _readFileTruncated(roadmapPath, PROMPT_MAX_CONTEXT_BYTES);
+    const state = _readFileTruncated(statePath, PROMPT_MAX_CONTEXT_BYTES);
+    let phaseDirFiles = [];
+    try {
+        const { phasesDir } = require('./paths');
+        const basePhasesDir = phasesDir(cwd);
+        const entries = fs.readdirSync(basePhasesDir);
+        const match = entries.find((e) => e.startsWith(`${phaseNum}-`));
+        if (match) {
+            phaseDirFiles = _listPhaseDirContents(path.join(basePhasesDir, match));
+        }
+    }
+    catch {
+        // ignore
+    }
+    const failureDescription = _describeFailure(failure);
+    const prompt = _buildPrompt(phaseNum, roadmap, state, phaseDirFiles, failureDescription);
+    const logPrefix = attemptIndex > 0
+        ? `[phase-complete-llm] (attempt ${attemptIndex + 1}) `
+        : `[phase-complete-llm] `;
+    process.stderr.write(`${logPrefix}attempting LLM fallback for phase ${phaseNum} ` +
+        `(reason: ${failureDescription.slice(0, 200)})\n`);
+    try {
+        const result = await scheduler.spawn(prompt, {
+            cwd,
+            timeout: FALLBACK_TIMEOUT_MS,
+            captureOutput: false,
+        });
+        if (result.exitCode !== 0) {
+            process.stderr.write(`${logPrefix}fallback subprocess exited with code ${result.exitCode}\n`);
+            return null;
+        }
+    }
+    catch (e) {
+        process.stderr.write(`${logPrefix}fallback subprocess threw: ${e.message}\n`);
+        return null;
+    }
+    // Invalidate cached reads so verification sees fresh post-LLM content
+    const { clearRoadmapCache, clearStateCache } = require('./phase-io');
+    clearRoadmapCache(path.join(cwd, '.planning', 'ROADMAP.md'));
+    clearStateCache(path.join(cwd, '.planning', 'STATE.md'));
+    const verification = _verifyFallbackOutput(cwd, phaseNum);
+    if (!verification.ok) {
+        const failed = verification.checks
+            .filter((c) => !c.passed)
+            .map((c) => c.name)
+            .join(', ');
+        process.stderr.write(`${logPrefix}verification failed — checks: ${failed}\n`);
+        return null;
+    }
+    process.stderr.write(`${logPrefix}fallback succeeded for phase ${phaseNum}\n`);
+    incrementCounter('phase_complete_llm_fallback.successes_total');
+    return _buildSyntheticResult(cwd, phaseNum);
+}
+/**
+ * Attempts to recover from a mechanical phase-completion failure by
+ * asking Claude to perform the ROADMAP.md and STATE.md edits directly.
+ * Returns a synthetic PhaseCompleteResult on success, null on any
+ * failure or when the scheduler is null.
+ *
+ * Retries up to `phase_complete_llm_fallback_retries` times (default 0)
+ * with exponential backoff: 2^attempt seconds between retries (2s, 4s, …).
+ */
+async function attemptLlmFallbackCompletion(cwd, phaseNum, scheduler, failure) {
+    if (!scheduler)
+        return null;
+    incrementCounter('phase_complete_llm_fallback.attempts_total');
+    // Read retry count from config
+    let maxRetries = 0;
+    try {
+        const { loadConfig } = require('./utils');
+        const config = loadConfig(cwd);
+        maxRetries = Math.max(0, config.phase_complete_llm_fallback_retries ?? 0);
+    }
+    catch {
+        // Use default of 0
+    }
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        const result = await _attemptOnce(cwd, phaseNum, scheduler, failure, attempt);
+        if (result !== null)
+            return result;
+        if (attempt < maxRetries) {
+            const backoffMs = Math.pow(2, attempt) * 1000;
+            process.stderr.write(`[phase-complete-llm] retrying after ${backoffMs / 1000}s (attempt ${attempt + 2}/${maxRetries + 1})\n`);
+            await (0, promises_1.setTimeout)(backoffMs);
+        }
+    }
+    return null;
+}
+module.exports = {
+    attemptLlmFallbackCompletion,
+    _verifyFallbackOutput,
+};
+//# sourceMappingURL=phase-complete-llm.js.map

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

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

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

@@ -0,0 +1,46 @@
+import type { PhaseCompleteOptions, PhaseCompleteResult } from './types';
+import type { Scheduler } from './scheduler';
+/**
+ * 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
+ */
+export declare function _resolvePhaseSuccession(cwd: string, phaseNum: string): {
+    phaseName: string;
+    plansExecuted: string;
+    nextPhaseNum: string | null;
+    nextPhaseName: string | null;
+    isLastPhase: boolean;
+};
+/**
+ * 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)
+ */
+export declare function _phaseCompleteCore(cwd: string, phaseNum: string, options?: PhaseCompleteOptions): PhaseCompleteResult;
+/**
+ * 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
+ */
+export declare function completePhaseAfterPostPipeline(cwd: string, phaseNum: string, scheduler?: Scheduler | null): Promise<PhaseCompleteResult | null>;
+//# sourceMappingURL=phase-complete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"phase-complete.d.ts","sourceRoot":"","sources":["../../lib/phase-complete.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAKV,oBAAoB,EACpB,mBAAmB,EAGpB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAoD7C;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;CACtB,CA+BA;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,mBAAmB,CAuJrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,8BAA8B,CAClD,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAC3B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAuCrC"}