@n-dx/core 0.1.0

package/packages/web/dist/server/routes-workflow.js

@@ -0,0 +1,498 @@
+/**
+ * Workflow optimization API routes — analyze run history to generate
+ * optimization suggestions with impact previews and tracking.
+ *
+ * All endpoints are under /api/hench/workflow/.
+ *
+ * GET    /api/hench/workflow/analysis          — full workflow analysis with suggestions
+ * POST   /api/hench/workflow/suggestions/:id   — record decision (accept/reject/defer)
+ * POST   /api/hench/workflow/apply             — apply config changes from a suggestion
+ * GET    /api/hench/workflow/history            — suggestion decision history + stats
+ */
+import { readFileSync, readdirSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { jsonResponse, errorResponse, readBody } from "./types.js";
+const WORKFLOW_PREFIX = "/api/hench/workflow/";
+// ── Data loading helpers ─────────────────────────────────────────────
+function loadRuns(projectDir) {
+    const runsDir = join(projectDir, ".hench", "runs");
+    let files;
+    try {
+        files = readdirSync(runsDir);
+    }
+    catch {
+        return [];
+    }
+    const runs = [];
+    for (const file of files.filter((f) => f.endsWith(".json"))) {
+        try {
+            const raw = readFileSync(join(runsDir, file), "utf-8");
+            const data = JSON.parse(raw);
+            if (data.id && data.startedAt) {
+                runs.push(data);
+            }
+        }
+        catch {
+            // skip invalid files
+        }
+    }
+    return runs.sort((a, b) => b.startedAt.localeCompare(a.startedAt));
+}
+function loadConfig(projectDir) {
+    try {
+        const raw = readFileSync(join(projectDir, ".hench", "config.json"), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function loadSuggestionHistory(projectDir) {
+    const path = join(projectDir, ".hench", "suggestions.json");
+    try {
+        if (!existsSync(path))
+            return { records: [] };
+        const raw = readFileSync(path, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (parsed && Array.isArray(parsed.records))
+            return parsed;
+        return { records: [] };
+    }
+    catch {
+        return { records: [] };
+    }
+}
+function saveSuggestionHistory(projectDir, history) {
+    writeFileSync(join(projectDir, ".hench", "suggestions.json"), JSON.stringify(history, null, 2) + "\n", "utf-8");
+}
+// ── Analysis engine (self-contained — no imports from hench) ─────────
+const FAILURE_STATUSES = new Set(["failed", "timeout", "budget_exceeded"]);
+function totalTokens(run) {
+    return (run.tokenUsage.input ?? 0) + (run.tokenUsage.output ?? 0);
+}
+function median(values) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 0
+        ? (sorted[mid - 1] + sorted[mid]) / 2
+        : sorted[mid];
+}
+function computeStats(runs, config) {
+    if (runs.length === 0) {
+        return {
+            successRate: 0, avgTurns: 0, avgTokensPerRun: 0, avgDurationMs: 0,
+            failuresByStatus: {}, troubleTaskIds: [], turnLimitHits: 0, budgetExceededCount: 0,
+        };
+    }
+    const completedCount = runs.filter((r) => r.status === "completed").length;
+    const finishedRuns = runs.filter((r) => r.status !== "running");
+    const successRate = finishedRuns.length > 0 ? completedCount / finishedRuns.length : 0;
+    const avgTurns = runs.reduce((sum, r) => sum + r.turns, 0) / runs.length;
+    const avgTokensPerRun = runs.map(totalTokens).reduce((a, b) => a + b, 0) / runs.length;
+    const durations = runs
+        .filter((r) => r.finishedAt)
+        .map((r) => new Date(r.finishedAt).getTime() - new Date(r.startedAt).getTime())
+        .filter((d) => d > 0);
+    const avgDurationMs = durations.length > 0 ? durations.reduce((a, b) => a + b, 0) / durations.length : 0;
+    const failuresByStatus = {};
+    const taskFailures = new Map();
+    for (const run of runs) {
+        if (FAILURE_STATUSES.has(run.status)) {
+            failuresByStatus[run.status] = (failuresByStatus[run.status] ?? 0) + 1;
+            taskFailures.set(run.taskId, (taskFailures.get(run.taskId) ?? 0) + 1);
+        }
+    }
+    const troubleTaskIds = [...taskFailures.entries()]
+        .filter(([, count]) => count >= 2)
+        .sort((a, b) => b[1] - a[1])
+        .map(([id]) => id);
+    const maxTurns = config?.maxTurns ?? 50;
+    const turnLimitHits = runs.filter((r) => r.turns >= maxTurns).length;
+    const budgetExceededCount = runs.filter((r) => r.status === "budget_exceeded").length;
+    return {
+        successRate, avgTurns, avgTokensPerRun, avgDurationMs,
+        failuresByStatus, troubleTaskIds, turnLimitHits, budgetExceededCount,
+    };
+}
+let idCounter = 0;
+function nextId(category) {
+    return `${category}-${++idCounter}`;
+}
+function generateSuggestions(runs, stats, config) {
+    idCounter = 0;
+    const suggestions = [];
+    // ── Token efficiency ──
+    if (stats.avgTokensPerRun > 100000 && stats.successRate < 0.5) {
+        suggestions.push({
+            id: nextId("token-efficiency"),
+            category: "token-efficiency",
+            priority: "high",
+            title: "High token consumption with low success rate",
+            description: "Runs are consuming significant tokens but failing frequently. Consider reducing token budget to fail faster on hard tasks.",
+            rationale: `Average ${Math.round(stats.avgTokensPerRun).toLocaleString()} tokens/run with only ${Math.round(stats.successRate * 100)}% success rate.`,
+            impact: "Reduces wasted tokens on tasks that are unlikely to succeed.",
+            configChanges: (config?.tokenBudget ?? 0) === 0
+                ? { tokenBudget: Math.round(stats.avgTokensPerRun * 0.7) }
+                : undefined,
+            autoApplicable: (config?.tokenBudget ?? 0) === 0,
+        });
+    }
+    const completedRuns = runs.filter((r) => r.status === "completed");
+    if (completedRuns.length >= 3 && (config?.tokenBudget ?? 0) === 0) {
+        const completedTokens = completedRuns.map(totalTokens);
+        const medianTokens = median(completedTokens);
+        if (medianTokens > 0) {
+            const suggestedBudget = Math.round(medianTokens * 2);
+            suggestions.push({
+                id: nextId("token-efficiency"),
+                category: "token-efficiency",
+                priority: "low",
+                title: "Set a token budget based on historical usage",
+                description: `Successful runs use a median of ${medianTokens.toLocaleString()} tokens. A budget would cap runaway costs.`,
+                rationale: `${completedRuns.length} completed runs analyzed. Median: ${medianTokens.toLocaleString()} tokens.`,
+                impact: `Budget of ${suggestedBudget.toLocaleString()} (2x median) protects against unbounded runs.`,
+                configChanges: { tokenBudget: suggestedBudget },
+                autoApplicable: true,
+            });
+        }
+    }
+    // ── Failure prevention ──
+    if ((stats.failuresByStatus["timeout"] ?? 0) >= 2) {
+        const cnt = stats.failuresByStatus["timeout"];
+        suggestions.push({
+            id: nextId("failure-prevention"),
+            category: "failure-prevention",
+            priority: "high",
+            title: "Recurring timeout failures",
+            description: `${cnt} runs have timed out. Tasks may be too large or the turn limit too low.`,
+            rationale: `${cnt} timeout failures out of ${runs.length} total runs.`,
+            impact: "Increasing max turns or splitting tasks may improve completion rate.",
+            configChanges: { maxTurns: 80 },
+            autoApplicable: true,
+        });
+    }
+    if ((stats.failuresByStatus["failed"] ?? 0) >= 3) {
+        const cnt = stats.failuresByStatus["failed"];
+        suggestions.push({
+            id: nextId("failure-prevention"),
+            category: "failure-prevention",
+            priority: "medium",
+            title: "Frequent task failures",
+            description: `${cnt} runs have failed. Reviewing error patterns may reveal systemic issues.`,
+            rationale: `${cnt} failures across ${runs.length} runs (${Math.round((cnt / runs.length) * 100)}% failure rate).`,
+            impact: "Identifying root causes can prevent repeated failed attempts.",
+            affectedTaskIds: stats.troubleTaskIds.slice(0, 5),
+            autoApplicable: false,
+        });
+    }
+    for (const taskId of stats.troubleTaskIds.slice(0, 3)) {
+        const taskRuns = runs.filter((r) => r.taskId === taskId);
+        const taskFailures = taskRuns.filter((r) => FAILURE_STATUSES.has(r.status));
+        const taskErrors = taskRuns.filter((r) => r.error).map((r) => r.error).slice(0, 3);
+        if (taskFailures.length >= 3) {
+            suggestions.push({
+                id: nextId("failure-prevention"),
+                category: "failure-prevention",
+                priority: "high",
+                title: `Task "${taskRuns[0]?.taskTitle ?? taskId}" is stuck`,
+                description: `This task has failed ${taskFailures.length} times out of ${taskRuns.length} attempts.${taskErrors.length > 0 ? ` Recent errors: ${taskErrors[0]?.slice(0, 100)}` : ""}`,
+                rationale: `${taskFailures.length} failures suggest the task may need manual review or scope reduction.`,
+                impact: "Prevents further wasted runs on a blocked task.",
+                affectedTaskIds: [taskId],
+                autoApplicable: false,
+            });
+        }
+    }
+    // ── Turn optimization ──
+    const maxTurns = config?.maxTurns ?? 50;
+    if (stats.turnLimitHits >= 2 && runs.length >= 3) {
+        const hitRate = stats.turnLimitHits / runs.length;
+        if (hitRate > 0.3) {
+            suggestions.push({
+                id: nextId("turn-optimization"),
+                category: "turn-optimization",
+                priority: "high",
+                title: "Turn limit reached frequently",
+                description: `${stats.turnLimitHits} of ${runs.length} runs (${Math.round(hitRate * 100)}%) hit the ${maxTurns}-turn limit.`,
+                rationale: `Turn limit hit rate is ${Math.round(hitRate * 100)}%.`,
+                impact: `Increasing maxTurns to ${Math.min(maxTurns * 2, 100)} gives tasks more room to finish.`,
+                configChanges: { maxTurns: Math.min(maxTurns * 2, 100) },
+                autoApplicable: true,
+            });
+        }
+    }
+    if (completedRuns.length >= 5) {
+        const turnUsages = completedRuns.map((r) => r.turns);
+        const medianTurns = median(turnUsages);
+        const p90Turns = [...turnUsages].sort((a, b) => a - b)[Math.floor(turnUsages.length * 0.9)];
+        if (p90Turns !== undefined && p90Turns < maxTurns * 0.5 && maxTurns > 20) {
+            suggestions.push({
+                id: nextId("turn-optimization"),
+                category: "turn-optimization",
+                priority: "low",
+                title: "Turn limit is much higher than needed",
+                description: `Successful runs use a median of ${medianTurns} turns, but the limit is ${maxTurns}.`,
+                rationale: `P90 turn usage is ${p90Turns}, well below the ${maxTurns} limit.`,
+                impact: `Setting maxTurns to ${Math.max(Math.round(p90Turns * 1.5), 20)} covers 90% of successful runs.`,
+                configChanges: { maxTurns: Math.max(Math.round(p90Turns * 1.5), 20) },
+                autoApplicable: true,
+            });
+        }
+    }
+    // ── Config tuning ──
+    const transientErrors = runs.filter((r) => r.status === "error_transient");
+    const maxRetries = config?.retry?.maxRetries ?? 3;
+    if (transientErrors.length >= 3 && maxRetries < 5) {
+        suggestions.push({
+            id: nextId("config-tuning"),
+            category: "config-tuning",
+            priority: "medium",
+            title: "Increase retry count for transient errors",
+            description: `${transientErrors.length} runs ended with transient errors. Higher retry count may recover more.`,
+            rationale: `Current max retries: ${maxRetries}. ${transientErrors.length} transient errors suggest API instability.`,
+            impact: "More retries can recover from temporary API issues without manual intervention.",
+            configChanges: { "retry.maxRetries": 5 },
+            autoApplicable: true,
+        });
+    }
+    // ── Task health ──
+    const taskRunCounts = new Map();
+    for (const run of runs) {
+        const entry = taskRunCounts.get(run.taskId) ?? { count: 0, title: run.taskTitle };
+        entry.count++;
+        taskRunCounts.set(run.taskId, entry);
+    }
+    for (const [taskId, info] of [...taskRunCounts.entries()]
+        .filter(([, i]) => i.count >= 5)
+        .sort((a, b) => b[1].count - a[1].count)
+        .slice(0, 3)) {
+        suggestions.push({
+            id: nextId("task-health"),
+            category: "task-health",
+            priority: "medium",
+            title: `Task "${info.title}" has been run ${info.count} times`,
+            description: `This task has been attempted ${info.count} times. It may need to be broken into smaller subtasks.`,
+            rationale: `${info.count} runs for a single task indicates scope or complexity issues.`,
+            impact: "Splitting or clarifying the task will improve success rate.",
+            affectedTaskIds: [taskId],
+            autoApplicable: false,
+        });
+    }
+    // Sort by priority
+    const priorityOrder = { high: 0, medium: 1, low: 2 };
+    suggestions.sort((a, b) => (priorityOrder[a.priority] ?? 2) - (priorityOrder[b.priority] ?? 2));
+    return suggestions;
+}
+function analyzeWorkflow(runs, config) {
+    if (runs.length === 0) {
+        return { totalRuns: 0, timeRange: null, stats: computeStats([]), suggestions: [] };
+    }
+    const stats = computeStats(runs, config);
+    const sorted = [...runs].sort((a, b) => a.startedAt.localeCompare(b.startedAt));
+    const timeRange = {
+        earliest: sorted[0].startedAt,
+        latest: sorted[sorted.length - 1].startedAt,
+    };
+    return {
+        totalRuns: runs.length,
+        timeRange,
+        stats,
+        suggestions: generateSuggestions(runs, stats, config),
+    };
+}
+// ── Config mutation helpers ──────────────────────────────────────────
+function setNestedValue(obj, path, value) {
+    const parts = path.split(".");
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (!(parts[i] in current) || typeof current[parts[i]] !== "object" || current[parts[i]] === null) {
+            current[parts[i]] = {};
+        }
+        current = current[parts[i]];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+function getNestedValue(obj, path) {
+    const parts = path.split(".");
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined || typeof current !== "object")
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+// ── Route handler ────────────────────────────────────────────────────
+/** Handle workflow optimization API requests. Returns true if handled. */
+export function handleWorkflowRoute(req, res, ctx) {
+    const url = req.url || "/";
+    const method = req.method || "GET";
+    if (!url.startsWith(WORKFLOW_PREFIX))
+        return false;
+    const fullPath = url.slice(WORKFLOW_PREFIX.length);
+    const qIdx = fullPath.indexOf("?");
+    const path = qIdx === -1 ? fullPath : fullPath.slice(0, qIdx);
+    // GET /api/hench/workflow/analysis — full analysis with suggestions
+    if (path === "analysis" && method === "GET") {
+        const runs = loadRuns(ctx.projectDir);
+        const config = loadConfig(ctx.projectDir);
+        const analysis = analyzeWorkflow(runs, config);
+        const history = loadSuggestionHistory(ctx.projectDir);
+        // Compute decision stats
+        const historyStats = {
+            total: history.records.length,
+            accepted: history.records.filter((r) => r.decision === "accepted").length,
+            rejected: history.records.filter((r) => r.decision === "rejected").length,
+            deferred: history.records.filter((r) => r.decision === "deferred").length,
+        };
+        jsonResponse(res, 200, { ...analysis, decisionHistory: historyStats });
+        return true;
+    }
+    // POST /api/hench/workflow/suggestions/:id — record decision on a suggestion
+    const decisionMatch = path.match(/^suggestions\/([a-z0-9-]+)$/);
+    if (decisionMatch && method === "POST") {
+        return handleSuggestionDecision(req, res, ctx, decisionMatch[1]);
+    }
+    // POST /api/hench/workflow/apply — apply config changes from a suggestion
+    if (path === "apply" && method === "POST") {
+        return handleApplySuggestion(req, res, ctx);
+    }
+    // GET /api/hench/workflow/history — decision history and stats
+    if (path === "history" && method === "GET") {
+        const history = loadSuggestionHistory(ctx.projectDir);
+        const total = history.records.length;
+        const accepted = history.records.filter((r) => r.decision === "accepted").length;
+        const rejected = history.records.filter((r) => r.decision === "rejected").length;
+        const deferred = history.records.filter((r) => r.decision === "deferred").length;
+        const byCategory = {};
+        for (const record of history.records) {
+            const cat = byCategory[record.category] ?? { accepted: 0, rejected: 0, deferred: 0 };
+            cat[record.decision] = (cat[record.decision] ?? 0) + 1;
+            byCategory[record.category] = cat;
+        }
+        jsonResponse(res, 200, {
+            records: history.records,
+            stats: {
+                total,
+                accepted,
+                rejected,
+                deferred,
+                acceptanceRate: total > 0 ? accepted / total : 0,
+                byCategory,
+            },
+        });
+        return true;
+    }
+    return false;
+}
+async function handleSuggestionDecision(req, res, ctx, suggestionId) {
+    let body;
+    try {
+        const raw = await readBody(req);
+        body = JSON.parse(raw);
+    }
+    catch {
+        errorResponse(res, 400, "Invalid JSON in request body");
+        return true;
+    }
+    const decision = body.decision;
+    if (!decision || !["accepted", "rejected", "deferred"].includes(decision)) {
+        errorResponse(res, 400, "Decision must be 'accepted', 'rejected', or 'deferred'");
+        return true;
+    }
+    const title = body.title || suggestionId;
+    const category = body.category || "unknown";
+    const record = {
+        suggestionId,
+        title,
+        category,
+        decision: decision,
+        decidedAt: new Date().toISOString(),
+        appliedChanges: body.appliedChanges,
+    };
+    const history = loadSuggestionHistory(ctx.projectDir);
+    history.records.push(record);
+    try {
+        saveSuggestionHistory(ctx.projectDir, history);
+    }
+    catch (err) {
+        errorResponse(res, 500, `Failed to save decision: ${err instanceof Error ? err.message : String(err)}`);
+        return true;
+    }
+    jsonResponse(res, 200, { ok: true, record });
+    return true;
+}
+async function handleApplySuggestion(req, res, ctx) {
+    let body;
+    try {
+        const raw = await readBody(req);
+        body = JSON.parse(raw);
+    }
+    catch {
+        errorResponse(res, 400, "Invalid JSON in request body");
+        return true;
+    }
+    const changes = body.changes;
+    if (!changes || typeof changes !== "object" || Object.keys(changes).length === 0) {
+        errorResponse(res, 400, "Request must include a 'changes' object with config path/value pairs");
+        return true;
+    }
+    // Preview mode: show what would change without applying
+    const preview = body.preview === true;
+    const configPath = join(ctx.projectDir, ".hench", "config.json");
+    let config;
+    try {
+        config = JSON.parse(readFileSync(configPath, "utf-8"));
+    }
+    catch {
+        errorResponse(res, 404, "Hench configuration not found. Run 'hench init' first.");
+        return true;
+    }
+    // Build the preview diff
+    const diff = [];
+    for (const [key, newValue] of Object.entries(changes)) {
+        const oldValue = getNestedValue(config, key);
+        diff.push({ path: key, oldValue, newValue });
+    }
+    if (preview) {
+        jsonResponse(res, 200, { preview: true, diff });
+        return true;
+    }
+    // Apply changes
+    for (const [key, value] of Object.entries(changes)) {
+        setNestedValue(config, key, value);
+    }
+    try {
+        writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+    }
+    catch (err) {
+        errorResponse(res, 500, `Failed to write config: ${err instanceof Error ? err.message : String(err)}`);
+        return true;
+    }
+    // Record the acceptance
+    const suggestionId = body.suggestionId;
+    const title = body.title || "Applied suggestion";
+    const category = body.category || "unknown";
+    if (suggestionId) {
+        const history = loadSuggestionHistory(ctx.projectDir);
+        history.records.push({
+            suggestionId,
+            title,
+            category,
+            decision: "accepted",
+            decidedAt: new Date().toISOString(),
+            appliedChanges: changes,
+        });
+        try {
+            saveSuggestionHistory(ctx.projectDir, history);
+        }
+        catch {
+            // Non-fatal — config was already written
+        }
+    }
+    jsonResponse(res, 200, { ok: true, diff, config });
+    return true;
+}
+//# sourceMappingURL=routes-workflow.js.map

package/packages/web/dist/server/routes-workflow.js.map

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

package/packages/web/dist/server/search-index.d.ts

@@ -0,0 +1,111 @@
+/**
+ * In-memory search index for PRD items.
+ *
+ * Builds an inverted index from PRD item titles, descriptions, acceptance
+ * criteria, and tags. Supports fuzzy/partial matching, exact phrase matching
+ * with quotes, multi-word AND/OR queries, and relevance-weighted scoring
+ * (title matches rank higher than descriptions).
+ *
+ * The index is lazy — built on first search — and auto-invalidated when the
+ * PRD file changes (checked via mtime on each search request).
+ *
+ * @module web/server/search-index
+ */
+/** A single indexed item with pre-extracted text fields. */
+export interface IndexedItem {
+    id: string;
+    title: string;
+    description: string;
+    level: string;
+    status: string;
+    tags: string[];
+    /** All text from acceptance criteria joined. */
+    acceptanceCriteria: string;
+    /** Parent chain titles for breadcrumb display. */
+    parentChain: string[];
+}
+/** A search result returned by the index. */
+export interface SearchResult {
+    id: string;
+    title: string;
+    description: string | null;
+    level: string;
+    status: string;
+    parentChain: string[];
+    /** Relevance score — higher is better. */
+    score: number;
+    /** Which fields matched the query. */
+    matchedFields: string[];
+}
+/** Parsed representation of a user query. */
+export interface ParsedQuery {
+    /** Exact phrases extracted from quoted segments. */
+    phrases: string[];
+    /** Individual terms after removing quoted segments. */
+    terms: string[];
+    /** Whether OR logic is requested (default is AND). */
+    isOr: boolean;
+}
+/**
+ * Parse a raw query string into structured components.
+ *
+ * Supports:
+ * - `"exact phrase"` — quoted segments for exact phrase matching
+ * - `word1 word2` — AND logic (all words must match) by default
+ * - `word1 OR word2` — OR logic when "OR" appears between terms
+ * - Case insensitive
+ */
+export declare function parseQuery(raw: string): ParsedQuery;
+export declare class SearchIndex {
+    /** Inverted index: term → list of (itemId, field, position). */
+    private invertedIndex;
+    /** Full indexed items keyed by ID. */
+    private items;
+    /** Lowercased full-text per field per item for phrase matching. */
+    private fieldText;
+    /** File mtime when the index was last built (for staleness check). */
+    private builtAtMtime;
+    /** Path to prd.json (set once). */
+    private prdPath;
+    /** Rex directory path for centralized PRD loading. */
+    private rexDir;
+    constructor(rexDir: string);
+    /**
+     * Search the index with the given raw query string.
+     *
+     * Automatically rebuilds the index if the PRD file has changed since the
+     * last build. Returns results sorted by relevance score descending.
+     */
+    search(query: string, limit?: number): SearchResult[];
+    /**
+     * Force a rebuild of the index from the current PRD file.
+     * Returns the number of items indexed.
+     */
+    rebuild(): number;
+    /** Invalidate the cached index, forcing a rebuild on next search. */
+    invalidate(): void;
+    /** Number of items currently in the index. */
+    get size(): number;
+    /** Number of unique terms in the inverted index. */
+    get termCount(): number;
+    /** Ensure the index is fresh by checking PRD file mtime. */
+    private ensureFresh;
+    /** Get the PRD file modification time (0 if file doesn't exist). */
+    private getPrdMtime;
+    /** Load the PRD document from disk. */
+    private loadPRD;
+    /** Index a single PRD item. */
+    private indexItem;
+    /** Add tokens to the inverted index for a specific item and field. */
+    private addTokens;
+    /**
+     * Find all items that match a term, supporting prefix/partial matching.
+     * Returns deduplicated hits (one per item-field combination).
+     */
+    private findTermMatches;
+    /**
+     * Count how many distinct query parts (terms + phrases) matched for an item.
+     * Used for AND logic filtering.
+     */
+    private countMatchedParts;
+}