gsd-pi 2.33.1-dev.29a8268 → 2.33.1-dev.9bafd68

package/dist/resources/extensions/gsd/{cache.ts → cache.js}

@@ -8,12 +8,10 @@
 // After any file write that changes .gsd/ contents, all three must be
 // invalidated together to prevent stale reads. This module provides a
 // single function that clears all three atomically.
-
 import { invalidateStateCache } from './state.js';
 import { clearPathCache } from './paths.js';
 import { clearParseCache } from './files.js';
 import { clearArtifacts } from './gsd-db.js';
-
 /**
  * Invalidate all GSD runtime caches in one call.
  *
@@ -21,9 +19,9 @@ import { clearArtifacts } from './gsd-db.js';
  * or any operation that changes .gsd/ contents on disk. Forgetting to clear
  * any single cache causes stale reads (see #431, #793).
  */
-export function invalidateAllCaches(): void {
-  invalidateStateCache();
-  clearPathCache();
-  clearParseCache();
-  clearArtifacts();
+export function invalidateAllCaches() {
+    invalidateStateCache();
+    clearPathCache();
+    clearParseCache();
+    clearArtifacts();
 }

package/dist/resources/extensions/gsd/captures.js

@@ -0,0 +1,348 @@
+/**
+ * GSD Captures — Fire-and-forget thought capture with triage classification
+ *
+ * Append-only capture file at `.gsd/CAPTURES.md`. Each capture is an H3 section
+ * with bold metadata fields, parseable by the same patterns used in files.ts.
+ *
+ * Worktree-aware: captures always resolve to the original project root's
+ * `.gsd/CAPTURES.md`, not the worktree's local `.gsd/`.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { randomUUID } from "node:crypto";
+import { gsdRoot } from "./paths.js";
+import { resolveProjectRoot } from "./worktree.js";
+// ─── Constants ────────────────────────────────────────────────────────────────
+const CAPTURES_FILENAME = "CAPTURES.md";
+const VALID_CLASSIFICATIONS = [
+    "quick-task", "inject", "defer", "replan", "note",
+];
+// ─── Path Resolution ──────────────────────────────────────────────────────────
+/**
+ * Resolve the path to CAPTURES.md, aware of worktree context.
+ *
+ * In worktree-isolated mode, basePath is `.gsd/worktrees/<MID>/`.
+ * Captures must resolve to the *original* project root's `.gsd/CAPTURES.md`,
+ * not the worktree-local `.gsd/`. This ensures all captures go to one file
+ * regardless of which worktree the agent is running in.
+ *
+ * Detection: if basePath contains `/.gsd/worktrees/`, walk up to the
+ * directory that contains `.gsd/worktrees/` — that's the project root.
+ */
+export function resolveCapturesPath(basePath) {
+    const projectRoot = resolveProjectRoot(resolve(basePath));
+    return join(gsdRoot(projectRoot), CAPTURES_FILENAME);
+}
+// ─── File I/O ─────────────────────────────────────────────────────────────────
+/**
+ * Append a new capture entry to CAPTURES.md.
+ * Creates `.gsd/` and the file if they don't exist.
+ * Returns the generated capture ID.
+ */
+export function appendCapture(basePath, text) {
+    const filePath = resolveCapturesPath(basePath);
+    const dir = join(filePath, "..");
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const id = `CAP-${randomUUID().slice(0, 8)}`;
+    const timestamp = new Date().toISOString();
+    const entry = [
+        `### ${id}`,
+        `**Text:** ${text}`,
+        `**Captured:** ${timestamp}`,
+        `**Status:** pending`,
+        "",
+    ].join("\n");
+    if (existsSync(filePath)) {
+        const existing = readFileSync(filePath, "utf-8");
+        writeFileSync(filePath, existing.trimEnd() + "\n\n" + entry, "utf-8");
+    }
+    else {
+        const header = `# Captures\n\n`;
+        writeFileSync(filePath, header + entry, "utf-8");
+    }
+    return id;
+}
+/**
+ * Parse all capture entries from CAPTURES.md.
+ * Returns entries in file order (oldest first).
+ */
+export function loadAllCaptures(basePath) {
+    const filePath = resolveCapturesPath(basePath);
+    if (!existsSync(filePath))
+        return [];
+    const content = readFileSync(filePath, "utf-8");
+    return parseCapturesContent(content);
+}
+/**
+ * Load only pending (unresolved) captures.
+ */
+export function loadPendingCaptures(basePath) {
+    return loadAllCaptures(basePath).filter(c => c.status === "pending");
+}
+/**
+ * Fast check for pending captures without full parse.
+ * Reads the file and scans for `**Status:** pending` via regex.
+ * Returns false if the file doesn't exist.
+ */
+export function hasPendingCaptures(basePath) {
+    const filePath = resolveCapturesPath(basePath);
+    if (!existsSync(filePath))
+        return false;
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        return /\*\*Status:\*\*\s*pending/i.test(content);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Count pending captures without full parse — single file read.
+ * Uses regex to count `**Status:** pending` occurrences.
+ * Returns 0 if file doesn't exist or on error.
+ */
+export function countPendingCaptures(basePath) {
+    const filePath = resolveCapturesPath(basePath);
+    if (!existsSync(filePath))
+        return 0;
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        const matches = content.match(/\*\*Status:\*\*\s*pending/gi);
+        return matches ? matches.length : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Mark a capture as resolved with classification and rationale.
+ * Rewrites the entry in place, preserving other entries.
+ */
+export function markCaptureResolved(basePath, captureId, classification, resolution, rationale) {
+    const filePath = resolveCapturesPath(basePath);
+    if (!existsSync(filePath))
+        return;
+    const content = readFileSync(filePath, "utf-8");
+    const resolvedAt = new Date().toISOString();
+    // Find the section for this capture ID and rewrite its fields
+    const sectionRegex = new RegExp(`(### ${escapeRegex(captureId)}\\n(?:(?!### ).)*?)(?=### |$)`, "s");
+    const match = sectionRegex.exec(content);
+    if (!match)
+        return;
+    let section = match[1];
+    // Update Status field
+    section = section.replace(/\*\*Status:\*\*\s*.+/, `**Status:** resolved`);
+    // Append classification, resolution, rationale, and timestamp if not present
+    const newFields = [
+        `**Classification:** ${classification}`,
+        `**Resolution:** ${resolution}`,
+        `**Rationale:** ${rationale}`,
+        `**Resolved:** ${resolvedAt}`,
+    ];
+    // Remove any existing classification/resolution/rationale/resolved fields
+    // (in case of re-triage)
+    section = section.replace(/\*\*Classification:\*\*\s*.+\n?/g, "");
+    section = section.replace(/\*\*Resolution:\*\*\s*.+\n?/g, "");
+    section = section.replace(/\*\*Rationale:\*\*\s*.+\n?/g, "");
+    section = section.replace(/\*\*Resolved:\*\*\s*.+\n?/g, "");
+    // Add new fields after Status line
+    section = section.trimEnd() + "\n" + newFields.join("\n") + "\n";
+    const updated = content.replace(sectionRegex, section);
+    writeFileSync(filePath, updated, "utf-8");
+}
+/**
+ * Mark a resolved capture as executed — its resolution action was carried out.
+ * Appends `**Executed:** <timestamp>` to the capture's section in CAPTURES.md.
+ */
+export function markCaptureExecuted(basePath, captureId) {
+    const filePath = resolveCapturesPath(basePath);
+    if (!existsSync(filePath))
+        return;
+    const content = readFileSync(filePath, "utf-8");
+    const executedAt = new Date().toISOString();
+    const sectionRegex = new RegExp(`(### ${escapeRegex(captureId)}\\n(?:(?!### ).)*?)(?=### |$)`, "s");
+    const match = sectionRegex.exec(content);
+    if (!match)
+        return;
+    let section = match[1];
+    // Remove any existing Executed field (in case of re-execution)
+    section = section.replace(/\*\*Executed:\*\*\s*.+\n?/g, "");
+    // Append Executed timestamp
+    section = section.trimEnd() + "\n" + `**Executed:** ${executedAt}` + "\n";
+    const updated = content.replace(sectionRegex, section);
+    writeFileSync(filePath, updated, "utf-8");
+}
+/**
+ * Load resolved captures that have actionable classifications (inject, replan,
+ * quick-task) but have NOT yet been executed.
+ * These are captures whose resolutions need to be carried out.
+ */
+export function loadActionableCaptures(basePath) {
+    return loadAllCaptures(basePath).filter(c => c.status === "resolved" &&
+        !c.executed &&
+        (c.classification === "inject" ||
+            c.classification === "replan" ||
+            c.classification === "quick-task"));
+}
+// ─── Parser ───────────────────────────────────────────────────────────────────
+/**
+ * Parse CAPTURES.md content into CaptureEntry array.
+ */
+function parseCapturesContent(content) {
+    const entries = [];
+    // Split on H3 headings
+    const sections = content.split(/^### /m).slice(1); // skip content before first H3
+    for (const section of sections) {
+        const lines = section.split("\n");
+        const id = lines[0]?.trim();
+        if (!id)
+            continue;
+        const body = lines.slice(1).join("\n");
+        const text = extractBoldField(body, "Text");
+        const timestamp = extractBoldField(body, "Captured");
+        const statusRaw = extractBoldField(body, "Status");
+        const classification = extractBoldField(body, "Classification");
+        const resolution = extractBoldField(body, "Resolution");
+        const rationale = extractBoldField(body, "Rationale");
+        const resolvedAt = extractBoldField(body, "Resolved");
+        const executedAt = extractBoldField(body, "Executed");
+        if (!text || !timestamp)
+            continue;
+        const status = (statusRaw === "resolved" || statusRaw === "triaged")
+            ? statusRaw
+            : "pending";
+        entries.push({
+            id,
+            text,
+            timestamp,
+            status,
+            ...(classification && VALID_CLASSIFICATIONS.includes(classification) ? { classification } : {}),
+            ...(resolution ? { resolution } : {}),
+            ...(rationale ? { rationale } : {}),
+            ...(resolvedAt ? { resolvedAt } : {}),
+            ...(executedAt ? { executed: true } : {}),
+        });
+    }
+    return entries;
+}
+/**
+ * Extract value from a bold-prefixed line like "**Key:** Value".
+ * Local copy of the pattern from files.ts to keep this module self-contained.
+ */
+function extractBoldField(text, key) {
+    const regex = new RegExp(`^\\*\\*${escapeRegex(key)}:\\*\\*\\s*(.+)$`, "m");
+    const match = regex.exec(text);
+    return match ? match[1].trim() : null;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+// ─── Triage Output Parser ─────────────────────────────────────────────────────
+/**
+ * Parse LLM triage output into TriageResult array.
+ *
+ * Handles:
+ * - Clean JSON array
+ * - JSON wrapped in fenced code block (```json ... ```)
+ * - JSON with leading/trailing prose
+ * - Single object (not array) — wraps in array
+ * - Malformed JSON — returns empty array (caller should fall back to note)
+ * - Partial results — valid entries are kept, invalid skipped
+ */
+export function parseTriageOutput(llmResponse) {
+    if (!llmResponse || !llmResponse.trim())
+        return [];
+    // Try to extract JSON from fenced code blocks first
+    const fenced = llmResponse.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
+    const jsonStr = fenced ? fenced[1] : extractJsonSubstring(llmResponse);
+    if (!jsonStr)
+        return [];
+    try {
+        const parsed = JSON.parse(jsonStr);
+        const arr = Array.isArray(parsed) ? parsed : [parsed];
+        return arr
+            .filter(isValidTriageResult)
+            .map(normalizeTriageResult);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Try to find a JSON array or object substring in prose text.
+ * Looks for the first [ or { and finds its matching bracket.
+ */
+function extractJsonSubstring(text) {
+    // Find first [ or {
+    const arrStart = text.indexOf("[");
+    const objStart = text.indexOf("{");
+    let start;
+    let openChar;
+    let closeChar;
+    if (arrStart === -1 && objStart === -1)
+        return null;
+    if (arrStart === -1) {
+        start = objStart;
+        openChar = "{";
+        closeChar = "}";
+    }
+    else if (objStart === -1) {
+        start = arrStart;
+        openChar = "[";
+        closeChar = "]";
+    }
+    else {
+        start = Math.min(arrStart, objStart);
+        openChar = start === arrStart ? "[" : "{";
+        closeChar = start === arrStart ? "]" : "}";
+    }
+    // Find matching bracket
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    for (let i = start; i < text.length; i++) {
+        const ch = text[i];
+        if (escape) {
+            escape = false;
+            continue;
+        }
+        if (ch === "\\") {
+            escape = true;
+            continue;
+        }
+        if (ch === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (ch === openChar)
+            depth++;
+        if (ch === closeChar)
+            depth--;
+        if (depth === 0) {
+            return text.slice(start, i + 1);
+        }
+    }
+    return null;
+}
+function isValidTriageResult(obj) {
+    if (!obj || typeof obj !== "object")
+        return false;
+    const o = obj;
+    return (typeof o.captureId === "string" &&
+        typeof o.classification === "string" &&
+        VALID_CLASSIFICATIONS.includes(o.classification) &&
+        typeof o.rationale === "string");
+}
+function normalizeTriageResult(obj) {
+    return {
+        captureId: obj.captureId,
+        classification: obj.classification,
+        rationale: obj.rationale,
+        ...(Array.isArray(obj.affectedFiles) ? { affectedFiles: obj.affectedFiles } : {}),
+        ...(typeof obj.targetSlice === "string" ? { targetSlice: obj.targetSlice } : {}),
+    };
+}