scai 0.1.178 → 1.0.0

package/dist/utils/dialogState.js

@@ -0,0 +1,201 @@
+function normalizeOptionId(value) {
+    return value.trim().toLowerCase().replace(/\s+/g, "-");
+}
+function buildDialogPromptFromIntent(intent) {
+    if (intent.promptHint?.trim())
+        return intent.promptHint.trim();
+    return intent.reason.trim() || "I need your input before continuing.";
+}
+export function createTaskDialogFromIntent(context, intent) {
+    return {
+        status: "awaiting-user",
+        kind: intent.kind,
+        prompt: buildDialogPromptFromIntent(intent),
+        options: intent.suggestedOptions?.length
+            ? intent.suggestedOptions
+            : ["continue", "revise", "cancel"],
+        relatedQuestionId: intent.relatedQuestionId,
+        relatedStepId: intent.relatedStepId,
+        createdAt: new Date().toISOString(),
+    };
+}
+export function createPlanFollowUpDialog(context) {
+    const objective = context.analysis?.intent?.normalizedQuery ??
+        context.task?.initialQuery ??
+        context.initContext?.userQuery ??
+        "current task";
+    return {
+        status: "awaiting-user",
+        kind: "plan-followup",
+        prompt: `I saved a plan for: ${objective}`,
+        options: ["execute", "revise", "add-info", "cancel"],
+        createdAt: new Date().toISOString(),
+    };
+}
+export function parseDialogResponse(dialog, rawResponse) {
+    const response = rawResponse.trim();
+    if (!response)
+        return { response: "" };
+    const lines = response
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const firstLine = lines[0] ?? response;
+    const separatorMatch = firstLine.match(/^([^:|-]+)\s*[:|-]\s*(.+)$/);
+    const knownOptions = new Map((dialog.options ?? []).map((option) => [normalizeOptionId(option), option]));
+    if (separatorMatch) {
+        const option = knownOptions.get(normalizeOptionId(separatorMatch[1] ?? ""));
+        if (option) {
+            const tail = [separatorMatch[2], ...lines.slice(1)].filter(Boolean).join(" ").trim();
+            return {
+                selectedOption: option,
+                comment: tail || undefined,
+                response,
+            };
+        }
+    }
+    const exactOption = knownOptions.get(normalizeOptionId(firstLine));
+    if (exactOption) {
+        const tail = lines.slice(1).join(" ").trim();
+        return {
+            selectedOption: exactOption,
+            comment: tail || undefined,
+            response,
+        };
+    }
+    const firstToken = normalizeOptionId(firstLine.split(/\s+/)[0] ?? "");
+    const tokenOption = knownOptions.get(firstToken);
+    if (tokenOption) {
+        const remainder = firstLine.slice(firstLine.split(/\s+/)[0]?.length ?? 0).trim();
+        const tail = [remainder, ...lines.slice(1)].filter(Boolean).join(" ").trim();
+        return {
+            selectedOption: tokenOption,
+            comment: tail || undefined,
+            response,
+        };
+    }
+    return {
+        response,
+        comment: response,
+    };
+}
+function pushUniqueNextAction(context, label) {
+    var _a;
+    context.analysis || (context.analysis = {});
+    (_a = context.analysis).rollingPlan || (_a.rollingPlan = {
+        mode: "rolling",
+        summary: "Rolling plan updated from dialog feedback.",
+        subgoals: [],
+        nextActions: [],
+        lastUpdatedAt: new Date().toISOString(),
+    });
+    const nextActions = context.analysis.rollingPlan.nextActions ?? [];
+    if (!nextActions.includes(label)) {
+        context.analysis.rollingPlan.nextActions = [label, ...nextActions].slice(0, 6);
+    }
+    context.analysis.rollingPlan.lastUpdatedAt = new Date().toISOString();
+}
+function applyDialogComment(context, comment) {
+    var _a;
+    const normalized = comment?.trim();
+    if (!normalized)
+        return;
+    context.analysis || (context.analysis = {});
+    (_a = context.analysis).rollingPlan || (_a.rollingPlan = {
+        mode: "rolling",
+        summary: "Rolling plan updated from dialog feedback.",
+        subgoals: [],
+        nextActions: [],
+        lastUpdatedAt: new Date().toISOString(),
+    });
+    context.analysis.rollingPlan.summary =
+        `${context.analysis.rollingPlan.summary} User note: ${normalized}`.trim();
+    pushUniqueNextAction(context, `Apply user note: ${normalized}`);
+}
+function clearAwaitingDialog(context, parsed) {
+    if (!context.task.dialogState)
+        return;
+    context.task.dialogState = {
+        ...context.task.dialogState,
+        status: "answered",
+        selectedOption: parsed.selectedOption,
+        comment: parsed.comment,
+        response: parsed.response,
+        answeredAt: new Date().toISOString(),
+    };
+}
+export function applyDialogResponseFromFollowUp(context) {
+    var _a;
+    const dialog = context.task?.dialogState;
+    const rawResponse = context.initContext?.followUpQuery?.trim();
+    if (!dialog || dialog.status !== "awaiting-user" || !rawResponse)
+        return false;
+    const parsed = parseDialogResponse(dialog, rawResponse);
+    const canonicalTaskQuery = context.initContext?.canonicalTaskQuery?.trim() ||
+        context.task?.initialQuery?.trim() ||
+        context.initContext?.userQuery?.trim() ||
+        "";
+    clearAwaitingDialog(context, parsed);
+    applyDialogComment(context, parsed.comment);
+    context.analysis || (context.analysis = {});
+    context.analysis.dialogIntent = undefined;
+    if (context.initContext) {
+        context.initContext.followUpQuery = undefined;
+    }
+    if (dialog.kind === "plan-followup") {
+        (_a = context.analysis).planMode || (_a.planMode = {
+            enabled: true,
+            source: "explicit",
+            executionMode: "plan-only",
+            rationale: "User explicitly asked for planning mode.",
+        });
+        if (parsed.selectedOption === "execute") {
+            context.analysis.planMode.executionMode = "execute";
+            context.task.status = "active";
+            context.task.reason = undefined;
+            if (context.initContext) {
+                context.initContext.userQuery = canonicalTaskQuery;
+            }
+            pushUniqueNextAction(context, "Execute the saved plan.");
+            return true;
+        }
+        if (parsed.selectedOption === "cancel") {
+            context.analysis.planMode.executionMode = "plan-only";
+            context.task.status = "deferred";
+            context.task.reason = "User canceled after reviewing the saved plan.";
+            pushUniqueNextAction(context, "Wait for a new user query before executing.");
+            return true;
+        }
+        context.analysis.planMode.executionMode = "plan-only";
+        context.task.status = "active";
+        if (context.initContext && canonicalTaskQuery) {
+            const commentSuffix = parsed.comment?.trim() ? `\n\nUser note: ${parsed.comment.trim()}` : "";
+            context.initContext.userQuery = `${canonicalTaskQuery}${commentSuffix}`.trim();
+        }
+        if (parsed.selectedOption === "revise") {
+            pushUniqueNextAction(context, "Revise the saved plan with the latest user note.");
+        }
+        else if (parsed.selectedOption === "add-info") {
+            pushUniqueNextAction(context, "Extend the saved plan with the extra user detail.");
+        }
+        return true;
+    }
+    if (parsed.selectedOption === "cancel") {
+        context.task.status = "paused";
+        context.task.reason = "Waiting after user canceled the current dialog.";
+        return true;
+    }
+    context.task.status = "active";
+    context.task.reason = undefined;
+    if (context.initContext && canonicalTaskQuery) {
+        const commentSuffix = parsed.comment?.trim() ? `\n\nUser note: ${parsed.comment.trim()}` : "";
+        context.initContext.userQuery = parsed.selectedOption === "continue"
+            ? canonicalTaskQuery
+            : `${canonicalTaskQuery}${commentSuffix}`.trim();
+    }
+    if (parsed.selectedOption) {
+        pushUniqueNextAction(context, `Continue with user choice: ${parsed.selectedOption}.`);
+    }
+    return true;
+}
+//# sourceMappingURL=dialogState.js.map

package/dist/utils/dialogState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogState.js","sourceRoot":"","sources":["../../src/utils/dialogState.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Builds and applies the task-level dialog state for collaborative runs.\n *\n * Why this file exists:\n * - all user interaction should flow through one task-scoped dialog model\n * - shell input, outer-loop pauses, and plan follow-up should share one parser\n * - comments should refine the rolling plan without inventing a second feedback store\n */\nimport type {\n  DialogIntent,\n  DialogOption,\n  DialogState,\n  StructuredContext,\n} from \"../types.js\";\n\nexport interface ParsedDialogResponse {\n  selectedOption?: DialogOption;\n  comment?: string;\n  response: string;\n}\n\nfunction normalizeOptionId(value: string): string {\n  return value.trim().toLowerCase().replace(/\\s+/g, \"-\");\n}\n\nfunction buildDialogPromptFromIntent(intent: DialogIntent): string {\n  if (intent.promptHint?.trim()) return intent.promptHint.trim();\n  return intent.reason.trim() || \"I need your input before continuing.\";\n}\n\nexport function createTaskDialogFromIntent(\n  context: StructuredContext,\n  intent: DialogIntent\n): DialogState {\n  return {\n    status: \"awaiting-user\",\n    kind: intent.kind,\n    prompt: buildDialogPromptFromIntent(intent),\n    options: intent.suggestedOptions?.length\n      ? intent.suggestedOptions\n      : [\"continue\", \"revise\", \"cancel\"],\n    relatedQuestionId: intent.relatedQuestionId,\n    relatedStepId: intent.relatedStepId,\n    createdAt: new Date().toISOString(),\n  };\n}\n\nexport function createPlanFollowUpDialog(context: StructuredContext): DialogState {\n  const objective =\n    context.analysis?.intent?.normalizedQuery ??\n    context.task?.initialQuery ??\n    context.initContext?.userQuery ??\n    \"current task\";\n  return {\n    status: \"awaiting-user\",\n    kind: \"plan-followup\",\n    prompt: `I saved a plan for: ${objective}`,\n    options: [\"execute\", \"revise\", \"add-info\", \"cancel\"],\n    createdAt: new Date().toISOString(),\n  };\n}\n\nexport function parseDialogResponse(\n  dialog: DialogState,\n  rawResponse: string\n): ParsedDialogResponse {\n  const response = rawResponse.trim();\n  if (!response) return { response: \"\" };\n\n  const lines = response\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter(Boolean);\n  const firstLine = lines[0] ?? response;\n  const separatorMatch = firstLine.match(/^([^:|-]+)\\s*[:|-]\\s*(.+)$/);\n  const knownOptions = new Map(\n    (dialog.options ?? []).map((option) => [normalizeOptionId(option), option])\n  );\n\n  if (separatorMatch) {\n    const option = knownOptions.get(normalizeOptionId(separatorMatch[1] ?? \"\"));\n    if (option) {\n      const tail = [separatorMatch[2], ...lines.slice(1)].filter(Boolean).join(\" \").trim();\n      return {\n        selectedOption: option,\n        comment: tail || undefined,\n        response,\n      };\n    }\n  }\n\n  const exactOption = knownOptions.get(normalizeOptionId(firstLine));\n  if (exactOption) {\n    const tail = lines.slice(1).join(\" \").trim();\n    return {\n      selectedOption: exactOption,\n      comment: tail || undefined,\n      response,\n    };\n  }\n\n  const firstToken = normalizeOptionId(firstLine.split(/\\s+/)[0] ?? \"\");\n  const tokenOption = knownOptions.get(firstToken);\n  if (tokenOption) {\n    const remainder = firstLine.slice(firstLine.split(/\\s+/)[0]?.length ?? 0).trim();\n    const tail = [remainder, ...lines.slice(1)].filter(Boolean).join(\" \").trim();\n    return {\n      selectedOption: tokenOption,\n      comment: tail || undefined,\n      response,\n    };\n  }\n\n  return {\n    response,\n    comment: response,\n  };\n}\n\nfunction pushUniqueNextAction(context: StructuredContext, label: string): void {\n  context.analysis ||= {};\n  context.analysis.rollingPlan ||= {\n    mode: \"rolling\",\n    summary: \"Rolling plan updated from dialog feedback.\",\n    subgoals: [],\n    nextActions: [],\n    lastUpdatedAt: new Date().toISOString(),\n  };\n  const nextActions = context.analysis.rollingPlan.nextActions ?? [];\n  if (!nextActions.includes(label)) {\n    context.analysis.rollingPlan.nextActions = [label, ...nextActions].slice(0, 6);\n  }\n  context.analysis.rollingPlan.lastUpdatedAt = new Date().toISOString();\n}\n\nfunction applyDialogComment(context: StructuredContext, comment?: string): void {\n  const normalized = comment?.trim();\n  if (!normalized) return;\n  context.analysis ||= {};\n  context.analysis.rollingPlan ||= {\n    mode: \"rolling\",\n    summary: \"Rolling plan updated from dialog feedback.\",\n    subgoals: [],\n    nextActions: [],\n    lastUpdatedAt: new Date().toISOString(),\n  };\n  context.analysis.rollingPlan.summary =\n    `${context.analysis.rollingPlan.summary} User note: ${normalized}`.trim();\n  pushUniqueNextAction(context, `Apply user note: ${normalized}`);\n}\n\nfunction clearAwaitingDialog(context: StructuredContext, parsed: ParsedDialogResponse): void {\n  if (!context.task.dialogState) return;\n  context.task.dialogState = {\n    ...context.task.dialogState,\n    status: \"answered\",\n    selectedOption: parsed.selectedOption,\n    comment: parsed.comment,\n    response: parsed.response,\n    answeredAt: new Date().toISOString(),\n  };\n}\n\nexport function applyDialogResponseFromFollowUp(context: StructuredContext): boolean {\n  const dialog = context.task?.dialogState;\n  const rawResponse = context.initContext?.followUpQuery?.trim();\n  if (!dialog || dialog.status !== \"awaiting-user\" || !rawResponse) return false;\n\n  const parsed = parseDialogResponse(dialog, rawResponse);\n  const canonicalTaskQuery =\n    context.initContext?.canonicalTaskQuery?.trim() ||\n    context.task?.initialQuery?.trim() ||\n    context.initContext?.userQuery?.trim() ||\n    \"\";\n  clearAwaitingDialog(context, parsed);\n  applyDialogComment(context, parsed.comment);\n  context.analysis ||= {};\n  context.analysis.dialogIntent = undefined;\n  if (context.initContext) {\n    context.initContext.followUpQuery = undefined;\n  }\n\n  if (dialog.kind === \"plan-followup\") {\n    context.analysis.planMode ||= {\n      enabled: true,\n      source: \"explicit\",\n      executionMode: \"plan-only\",\n      rationale: \"User explicitly asked for planning mode.\",\n    };\n\n    if (parsed.selectedOption === \"execute\") {\n      context.analysis.planMode.executionMode = \"execute\";\n      context.task.status = \"active\";\n      context.task.reason = undefined;\n      if (context.initContext) {\n        context.initContext.userQuery = canonicalTaskQuery;\n      }\n      pushUniqueNextAction(context, \"Execute the saved plan.\");\n      return true;\n    }\n\n    if (parsed.selectedOption === \"cancel\") {\n      context.analysis.planMode.executionMode = \"plan-only\";\n      context.task.status = \"deferred\";\n      context.task.reason = \"User canceled after reviewing the saved plan.\";\n      pushUniqueNextAction(context, \"Wait for a new user query before executing.\");\n      return true;\n    }\n\n    context.analysis.planMode.executionMode = \"plan-only\";\n    context.task.status = \"active\";\n    if (context.initContext && canonicalTaskQuery) {\n      const commentSuffix = parsed.comment?.trim() ? `\\n\\nUser note: ${parsed.comment.trim()}` : \"\";\n      context.initContext.userQuery = `${canonicalTaskQuery}${commentSuffix}`.trim();\n    }\n    if (parsed.selectedOption === \"revise\") {\n      pushUniqueNextAction(context, \"Revise the saved plan with the latest user note.\");\n    } else if (parsed.selectedOption === \"add-info\") {\n      pushUniqueNextAction(context, \"Extend the saved plan with the extra user detail.\");\n    }\n    return true;\n  }\n\n  if (parsed.selectedOption === \"cancel\") {\n    context.task.status = \"paused\";\n    context.task.reason = \"Waiting after user canceled the current dialog.\";\n    return true;\n  }\n\n  context.task.status = \"active\";\n  context.task.reason = undefined;\n  if (context.initContext && canonicalTaskQuery) {\n    const commentSuffix = parsed.comment?.trim() ? `\\n\\nUser note: ${parsed.comment.trim()}` : \"\";\n    context.initContext.userQuery = parsed.selectedOption === \"continue\"\n      ? canonicalTaskQuery\n      : `${canonicalTaskQuery}${commentSuffix}`.trim();\n  }\n  if (parsed.selectedOption) {\n    pushUniqueNextAction(context, `Continue with user choice: ${parsed.selectedOption}.`);\n  }\n  return true;\n}\n"]}

package/dist/utils/editor.js

@@ -14,3 +14,4 @@ export async function openTextEditor(initialContent, filename) {
         .join('\n')
         .trim();
 }
+//# sourceMappingURL=editor.js.map

package/dist/utils/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sourceRoot":"","sources":["../../src/utils/editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,cAAsB,EAAE,QAAgB;IAC3E,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;IACrD,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;IAEvD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACvF,SAAS,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAEvD,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC5D,OAAO,aAAa;SACjB,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SAC5C,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAC;AACZ,CAAC","sourcesContent":["import os from 'os';\r\nimport fs from 'fs';\r\nimport path from 'path';\r\nimport { spawnSync } from 'child_process';\r\n\r\nexport async function openTextEditor(initialContent: string, filename: string): Promise<string> {\r\n  const tmpFilePath = path.join(os.tmpdir(), filename);\r\n  fs.writeFileSync(tmpFilePath, initialContent, 'utf-8');\r\n\r\n  const editor = process.env.EDITOR || (process.platform === 'win32' ? 'notepad' : 'vi');\r\n  spawnSync(editor, [tmpFilePath], { stdio: 'inherit' });\r\n\r\n  const editedContent = fs.readFileSync(tmpFilePath, 'utf-8');\r\n  return editedContent\r\n    .split('\\n')\r\n    .filter(line => !line.trim().startsWith('#'))\r\n    .join('\\n')\r\n    .trim();\r\n}\r\n"]}

package/dist/utils/executionEvidence.js

@@ -0,0 +1,50 @@
+/**
+ * Classifies which completed task steps count as execution-grade grounding.
+ *
+ * Why this file exists:
+ * - progress gating and final grounding both need the same answer
+ * - read-only steps like search, semantic analysis, and final answer must not count as executed evidence
+ * - older saved steps may still use generic names like `work`, so this helper keeps that compatibility narrow
+ *
+ * Examples:
+ * - `codeTransform` -> true
+ * - `semanticAnalysis` -> false
+ * - `research-impact-map` -> false
+ * - legacy `work` step on a real file -> true
+ */
+import { getActionSpec } from "../agents/actionRegistry.js";
+const READ_ONLY_STEP_NAMES = new Set([
+    "fileSearch",
+    "semanticAnalysis",
+    "finalAnswer",
+    "run-search",
+    "run-verify",
+    "seed-research",
+    "seed-plan",
+]);
+/**
+ * Returns true only for completed, non-research steps that represent execution-grade work.
+ * Example: `{ status: "completed", action: "codeTransform", filePath: "/repo/a.ts" }` -> true.
+ */
+export function isExecutionGroundedStep(step) {
+    if (!step || step.status !== "completed") {
+        return false;
+    }
+    const filePath = String(step.filePath ?? "").trim();
+    if (!filePath || filePath.startsWith("__research__/")) {
+        return false;
+    }
+    const actionId = String(step.actionId ?? step.action ?? "").trim();
+    if (!actionId) {
+        return true;
+    }
+    if (actionId.startsWith("research-") || READ_ONLY_STEP_NAMES.has(actionId)) {
+        return false;
+    }
+    const spec = getActionSpec(actionId);
+    if (!spec) {
+        return actionId === "work";
+    }
+    return spec.phase === "transform" || spec.safety === "repo-write" || spec.safety === "shell";
+}
+//# sourceMappingURL=executionEvidence.js.map

package/dist/utils/executionEvidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionEvidence.js","sourceRoot":"","sources":["../../src/utils/executionEvidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAS5D,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,YAAY;IACZ,kBAAkB;IAClB,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,eAAe;IACf,WAAW;CACZ,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAA0B;IAChE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACtD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,QAAQ,KAAK,MAAM,CAAC;IAC7B,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC;AAC/F,CAAC","sourcesContent":["/**\n * Classifies which completed task steps count as execution-grade grounding.\n *\n * Why this file exists:\n * - progress gating and final grounding both need the same answer\n * - read-only steps like search, semantic analysis, and final answer must not count as executed evidence\n * - older saved steps may still use generic names like `work`, so this helper keeps that compatibility narrow\n *\n * Examples:\n * - `codeTransform` -> true\n * - `semanticAnalysis` -> false\n * - `research-impact-map` -> false\n * - legacy `work` step on a real file -> true\n */\nimport { getActionSpec } from \"../agents/actionRegistry.js\";\n\ntype StepLike = {\n  filePath?: string;\n  action?: string;\n  actionId?: string;\n  status?: string;\n};\n\nconst READ_ONLY_STEP_NAMES = new Set([\n  \"fileSearch\",\n  \"semanticAnalysis\",\n  \"finalAnswer\",\n  \"run-search\",\n  \"run-verify\",\n  \"seed-research\",\n  \"seed-plan\",\n]);\n\n/**\n * Returns true only for completed, non-research steps that represent execution-grade work.\n * Example: `{ status: \"completed\", action: \"codeTransform\", filePath: \"/repo/a.ts\" }` -> true.\n */\nexport function isExecutionGroundedStep(step: StepLike | undefined): boolean {\n  if (!step || step.status !== \"completed\") {\n    return false;\n  }\n\n  const filePath = String(step.filePath ?? \"\").trim();\n  if (!filePath || filePath.startsWith(\"__research__/\")) {\n    return false;\n  }\n\n  const actionId = String(step.actionId ?? step.action ?? \"\").trim();\n  if (!actionId) {\n    return true;\n  }\n  if (actionId.startsWith(\"research-\") || READ_ONLY_STEP_NAMES.has(actionId)) {\n    return false;\n  }\n\n  const spec = getActionSpec(actionId);\n  if (!spec) {\n    return actionId === \"work\";\n  }\n\n  return spec.phase === \"transform\" || spec.safety === \"repo-write\" || spec.safety === \"shell\";\n}\n"]}

package/dist/utils/extractFileReferences.js

@@ -1,13 +1,147 @@
+/**
+ * Extracts explicit repo refs from a user query.
+ *
+ * Why this exists:
+ * - users often name files and folders without full paths or extensions
+ * - search needs one shared ref extractor so intent and mode selection stay aligned
+ * - this should stay conservative about member expressions like `task.id`
+ *
+ * Examples:
+ * - `check agents/guards` -> `["agents/guards"]`
+ * - `what do the three files in the guards folder do` -> `["guards"]`
+ * - `Explain EvalReportCmd` -> `["EvalReportCmd"]`
+ * - `task.id` -> `[]`
+ */
+import path from "path";
+import { isExplicitRefCandidate, normalizeQueryToken, } from "../fileRules/queryTokenRules.js";
 export function extractFileReferences(query, options) {
     const text = String(query ?? "");
-    const fileRegex = /(?:[A-Za-z0-9_.\-]+\/)*[A-Za-z0-9_.\-]+\.[A-Za-z0-9_]{1,10}/g;
-    const matches = text.match(fileRegex) ?? [];
     const out = new Set();
-    for (const token of matches) {
-        const cleaned = token.trim();
-        if (!cleaned)
+    addMatches(out, extractPathLikeRefs(text), options);
+    addMatches(out, extractFolderCueRefs(text), options);
+    addMatches(out, extractVerbScopedRefs(text), options);
+    return filterShadowedRefs(Array.from(out));
+}
+function addMatches(out, refs, options) {
+    for (const ref of refs) {
+        const cleaned = normalizeQueryToken(ref);
+        if (!cleaned || !shouldKeepExplicitRef(cleaned))
             continue;
         out.add(options?.lowercase ? cleaned.toLowerCase() : cleaned);
     }
-    return Array.from(out);
 }
+function extractFolderCueRefs(query) {
+    const matches = [];
+    const patterns = [
+        /\b(?:in|inside|under|from|check|inspect|open|show|list|trace|explain)\s+([A-Za-z0-9_.\-/]+)\s+(?:folder|directory)\b/gi,
+        /\bfiles?\s+in\s+([A-Za-z0-9_.\-/]+)\b/gi,
+        /\bthe\s+([A-Za-z0-9_.\-/]+)\s+(?:folder|directory)\b/gi,
+    ];
+    for (const pattern of patterns) {
+        let match = null;
+        while ((match = pattern.exec(query)) !== null) {
+            matches.push(String(match[1] ?? ""));
+        }
+    }
+    return matches;
+}
+function extractPathLikeRefs(query) {
+    const matches = [];
+    const patterns = [
+        /(?:^|\s)((?:\/|\.{1,2}\/|[A-Za-z]:[\\/])[A-Za-z0-9_.\-\/]+)/g,
+        /\b([A-Za-z0-9_.-]+\/[A-Za-z0-9_.\-\/]+)\b/g,
+        /\b([A-Za-z0-9_-]+\.[A-Za-z0-9_]{1,10})\b/g,
+        /\b([A-Z][A-Za-z0-9_-]{2,})\b/g,
+    ];
+    for (const pattern of patterns) {
+        let match = null;
+        while ((match = pattern.exec(query)) !== null) {
+            matches.push(match[1] ?? match[0] ?? "");
+        }
+    }
+    return matches;
+}
+function extractVerbScopedRefs(query) {
+    const matches = [];
+    // Accept short natural-language fillers before the real target token.
+    // Example: "check the readme" -> "readme", "show me the install file" -> "install".
+    const pattern = /\b(?:check|inspect|open|show|trace|explain|read|summarize|review)\s+(?:me\s+)?(?:the\s+|a\s+|an\s+)?([A-Za-z0-9_.\-/]+)(?:\s+(?:file|doc|docs))?(?:\b|$)/gi;
+    let match = null;
+    while ((match = pattern.exec(query)) !== null) {
+        const candidate = String(match[1] ?? "");
+        if (candidate && !isCommonVerbLeadToken(candidate)) {
+            matches.push(candidate);
+        }
+    }
+    return matches;
+}
+function filterShadowedRefs(refs) {
+    const slashRefs = refs.filter(ref => ref.includes("/"));
+    return refs.filter(ref => {
+        if (ref.includes("/")) {
+            return !slashRefs.some((otherRef) => otherRef !== ref && pathRefShadowsPathRef(otherRef, ref));
+        }
+        return !slashRefs.some((pathRef) => pathRefShadowsBareRef(pathRef, ref));
+    });
+}
+/**
+ * Treats one bare token as shadowed when it already appears inside a slash path.
+ * Example: "/tmp/scai-agent-loop-ABC/file.ts" shadows "ABC".
+ */
+function pathRefShadowsBareRef(pathRef, ref) {
+    if (pathRef.endsWith(`/${ref}`) || pathRef.startsWith(`${ref}/`) || pathRef.includes(`/${ref}/`)) {
+        return true;
+    }
+    return pathRef.split("/").some((segment) => {
+        const stem = segment.replace(/\.[^.]+$/, "");
+        return stem === ref || stem.endsWith(`-${ref}`) || stem.startsWith(`${ref}-`);
+    });
+}
+/**
+ * Treats one slash path as shadowed when a stronger absolute path already contains it.
+ * Example: "/Users/me/repo/src/file.ts" shadows "Users/me/repo/src/file.ts".
+ */
+function pathRefShadowsPathRef(pathRef, ref) {
+    if (!path.isAbsolute(pathRef) || path.isAbsolute(ref)) {
+        return false;
+    }
+    const normalizedPathRef = pathRef.replace(/\\/g, "/").replace(/\/+$/, "");
+    const normalizedRef = ref.replace(/\\/g, "/").replace(/\/+$/, "");
+    return normalizedPathRef === `/${normalizedRef}`;
+}
+function shouldKeepExplicitRef(ref) {
+    if (!ref.includes("/") && isCommonVerbLeadToken(ref))
+        return false;
+    return isExplicitRefCandidate(ref);
+}
+function isCommonVerbLeadToken(ref) {
+    return [
+        "trace",
+        "explain",
+        "show",
+        "where",
+        "when",
+        "why",
+        "which",
+        "who",
+        "how",
+        "is",
+        "are",
+        "do",
+        "does",
+        "can",
+        "should",
+        "could",
+        "would",
+        "check",
+        "inspect",
+        "open",
+        "read",
+        "summarize",
+        "review",
+        "please",
+        "tell",
+        "what",
+    ].includes(ref.toLowerCase());
+}
+//# sourceMappingURL=extractFileReferences.js.map

package/dist/utils/extractFileReferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractFileReferences.js","sourceRoot":"","sources":["../../src/utils/extractFileReferences.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Extracts explicit repo refs from a user query.\n *\n * Why this exists:\n * - users often name files and folders without full paths or extensions\n * - search needs one shared ref extractor so intent and mode selection stay aligned\n * - this should stay conservative about member expressions like `task.id`\n *\n * Examples:\n * - `check agents/guards` -> `[\"agents/guards\"]`\n * - `what do the three files in the guards folder do` -> `[\"guards\"]`\n * - `Explain EvalReportCmd` -> `[\"EvalReportCmd\"]`\n * - `task.id` -> `[]`\n */\nimport path from \"path\";\nimport {\n  isExplicitRefCandidate,\n  normalizeQueryToken,\n} from \"../fileRules/queryTokenRules.js\";\n\nexport function extractFileReferences(\n  query: string,\n  options?: { lowercase?: boolean }\n): string[] {\n  const text = String(query ?? \"\");\n  const out = new Set<string>();\n\n  addMatches(out, extractPathLikeRefs(text), options);\n  addMatches(out, extractFolderCueRefs(text), options);\n  addMatches(out, extractVerbScopedRefs(text), options);\n\n  return filterShadowedRefs(Array.from(out));\n}\n\nfunction addMatches(out: Set<string>, refs: string[], options?: { lowercase?: boolean }): void {\n  for (const ref of refs) {\n    const cleaned = normalizeQueryToken(ref);\n    if (!cleaned || !shouldKeepExplicitRef(cleaned)) continue;\n    out.add(options?.lowercase ? cleaned.toLowerCase() : cleaned);\n  }\n}\n\nfunction extractFolderCueRefs(query: string): string[] {\n  const matches: string[] = [];\n  const patterns = [\n    /\\b(?:in|inside|under|from|check|inspect|open|show|list|trace|explain)\\s+([A-Za-z0-9_.\\-/]+)\\s+(?:folder|directory)\\b/gi,\n    /\\bfiles?\\s+in\\s+([A-Za-z0-9_.\\-/]+)\\b/gi,\n    /\\bthe\\s+([A-Za-z0-9_.\\-/]+)\\s+(?:folder|directory)\\b/gi,\n  ];\n\n  for (const pattern of patterns) {\n    let match: RegExpExecArray | null = null;\n    while ((match = pattern.exec(query)) !== null) {\n      matches.push(String(match[1] ?? \"\"));\n    }\n  }\n\n  return matches;\n}\n\nfunction extractPathLikeRefs(query: string): string[] {\n  const matches: string[] = [];\n  const patterns = [\n    /(?:^|\\s)((?:\\/|\\.{1,2}\\/|[A-Za-z]:[\\\\/])[A-Za-z0-9_.\\-\\/]+)/g,\n    /\\b([A-Za-z0-9_.-]+\\/[A-Za-z0-9_.\\-\\/]+)\\b/g,\n    /\\b([A-Za-z0-9_-]+\\.[A-Za-z0-9_]{1,10})\\b/g,\n    /\\b([A-Z][A-Za-z0-9_-]{2,})\\b/g,\n  ];\n\n  for (const pattern of patterns) {\n    let match: RegExpExecArray | null = null;\n    while ((match = pattern.exec(query)) !== null) {\n      matches.push(match[1] ?? match[0] ?? \"\");\n    }\n  }\n\n  return matches;\n}\n\nfunction extractVerbScopedRefs(query: string): string[] {\n  const matches: string[] = [];\n  // Accept short natural-language fillers before the real target token.\n  // Example: \"check the readme\" -> \"readme\", \"show me the install file\" -> \"install\".\n  const pattern = /\\b(?:check|inspect|open|show|trace|explain|read|summarize|review)\\s+(?:me\\s+)?(?:the\\s+|a\\s+|an\\s+)?([A-Za-z0-9_.\\-/]+)(?:\\s+(?:file|doc|docs))?(?:\\b|$)/gi;\n  let match: RegExpExecArray | null = null;\n  while ((match = pattern.exec(query)) !== null) {\n    const candidate = String(match[1] ?? \"\");\n    if (candidate && !isCommonVerbLeadToken(candidate)) {\n      matches.push(candidate);\n    }\n  }\n  return matches;\n}\n\nfunction filterShadowedRefs(refs: string[]): string[] {\n  const slashRefs = refs.filter(ref => ref.includes(\"/\"));\n  return refs.filter(ref => {\n    if (ref.includes(\"/\")) {\n      return !slashRefs.some((otherRef) => otherRef !== ref && pathRefShadowsPathRef(otherRef, ref));\n    }\n    return !slashRefs.some((pathRef) => pathRefShadowsBareRef(pathRef, ref));\n  });\n}\n\n/**\n * Treats one bare token as shadowed when it already appears inside a slash path.\n * Example: \"/tmp/scai-agent-loop-ABC/file.ts\" shadows \"ABC\".\n */\nfunction pathRefShadowsBareRef(pathRef: string, ref: string): boolean {\n  if (pathRef.endsWith(`/${ref}`) || pathRef.startsWith(`${ref}/`) || pathRef.includes(`/${ref}/`)) {\n    return true;\n  }\n\n  return pathRef.split(\"/\").some((segment) => {\n    const stem = segment.replace(/\\.[^.]+$/, \"\");\n    return stem === ref || stem.endsWith(`-${ref}`) || stem.startsWith(`${ref}-`);\n  });\n}\n\n/**\n * Treats one slash path as shadowed when a stronger absolute path already contains it.\n * Example: \"/Users/me/repo/src/file.ts\" shadows \"Users/me/repo/src/file.ts\".\n */\nfunction pathRefShadowsPathRef(pathRef: string, ref: string): boolean {\n  if (!path.isAbsolute(pathRef) || path.isAbsolute(ref)) {\n    return false;\n  }\n\n  const normalizedPathRef = pathRef.replace(/\\\\/g, \"/\").replace(/\\/+$/, \"\");\n  const normalizedRef = ref.replace(/\\\\/g, \"/\").replace(/\\/+$/, \"\");\n  return normalizedPathRef === `/${normalizedRef}`;\n}\n\nfunction shouldKeepExplicitRef(ref: string): boolean {\n  if (!ref.includes(\"/\") && isCommonVerbLeadToken(ref)) return false;\n  return isExplicitRefCandidate(ref);\n}\n\nfunction isCommonVerbLeadToken(ref: string): boolean {\n  return [\n    \"trace\",\n    \"explain\",\n    \"show\",\n    \"where\",\n    \"when\",\n    \"why\",\n    \"which\",\n    \"who\",\n    \"how\",\n    \"is\",\n    \"are\",\n    \"do\",\n    \"does\",\n    \"can\",\n    \"should\",\n    \"could\",\n    \"would\",\n    \"check\",\n    \"inspect\",\n    \"open\",\n    \"read\",\n    \"summarize\",\n    \"review\",\n    \"please\",\n    \"tell\",\n    \"what\",\n  ].includes(ref.toLowerCase());\n}\n"]}

package/dist/utils/fileEvidenceCache.js

@@ -0,0 +1,50 @@
+/**
+ * Computes small cache fingerprints for simple-agent reads and semantic analysis.
+ *
+ * Why this file exists:
+ * - stop re-reading and re-analyzing the same file content in the same task flow
+ * - keep cache checks tied to both file bytes and the active query
+ * - let callers reuse prior evidence only when the cached result still matches
+ */
+import { createHash } from "crypto";
+function computeFingerprint(value) {
+    const text = String(value ?? "");
+    if (!text.trim()) {
+        return undefined;
+    }
+    return createHash("sha1").update(text).digest("hex").slice(0, 12);
+}
+export function computeContentFingerprint(code) {
+    return computeFingerprint(code);
+}
+export function computeQueryFingerprint(query) {
+    return computeFingerprint(String(query ?? "").trim());
+}
+export function hasFreshReadResult(args) {
+    const { result, file, query, expectedFacts, mode } = args;
+    if (!result || !file?.code?.trim()) {
+        return false;
+    }
+    const cachedFacts = new Set(result.requestedFacts ?? result.facts.map((fact) => fact.key));
+    return result.mode === mode &&
+        result.contentFingerprint === computeContentFingerprint(file.code) &&
+        result.queryFingerprint === computeQueryFingerprint(query) &&
+        expectedFacts.every((fact) => cachedFacts.has(fact));
+}
+export function hasFreshSemanticAnalysis(args) {
+    const { analysis, file, query } = args;
+    if (!analysis?.semanticAnalyzed || !file?.code?.trim()) {
+        return false;
+    }
+    return analysis.contentFingerprint === computeContentFingerprint(file.code) &&
+        analysis.queryFingerprint === computeQueryFingerprint(query);
+}
+export function hasFreshAgentReadEvidence(args) {
+    const { evidence, code, query } = args;
+    if (!evidence || !String(code ?? "").trim()) {
+        return false;
+    }
+    return evidence.contentFingerprint === computeContentFingerprint(code) &&
+        evidence.queryFingerprint === computeQueryFingerprint(query);
+}
+//# sourceMappingURL=fileEvidenceCache.js.map

package/dist/utils/fileEvidenceCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileEvidenceCache.js","sourceRoot":"","sources":["../../src/utils/fileEvidenceCache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAIpC,SAAS,kBAAkB,CAAC,KAAyB;IACjD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAwB;IAC9D,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAyB;IAC7D,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAMlC;IACG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAC1D,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3F,OAAO,MAAM,CAAC,IAAI,KAAK,IAAI;QACvB,MAAM,CAAC,kBAAkB,KAAK,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC;QAClE,MAAM,CAAC,gBAAgB,KAAK,uBAAuB,CAAC,KAAK,CAAC;QAC1D,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAIxC;IACG,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACvC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACjB,CAAC;IAEH,OAAO,QAAQ,CAAC,kBAAkB,KAAK,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC;QACzE,QAAQ,CAAC,gBAAgB,KAAK,uBAAuB,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAIzC;IACC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACvC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,QAAQ,CAAC,kBAAkB,KAAK,yBAAyB,CAAC,IAAI,CAAC;QACpE,QAAQ,CAAC,gBAAgB,KAAK,uBAAuB,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC","sourcesContent":["/**\n * Computes small cache fingerprints for simple-agent reads and semantic analysis.\n *\n * Why this file exists:\n * - stop re-reading and re-analyzing the same file content in the same task flow\n * - keep cache checks tied to both file bytes and the active query\n * - let callers reuse prior evidence only when the cached result still matches\n */\nimport { createHash } from \"crypto\";\nimport type { FileAnalysis, ReadFileResult, StructuredFileCapsule } from \"../types.js\";\nimport type { AgentReadEvidence } from \"../agent/types.js\";\n\nfunction computeFingerprint(value: string | undefined): string | undefined {\n    const text = String(value ?? \"\");\n    if (!text.trim()) {\n        return undefined;\n    }\n    return createHash(\"sha1\").update(text).digest(\"hex\").slice(0, 12);\n}\n\nexport function computeContentFingerprint(code: string | undefined): string | undefined {\n    return computeFingerprint(code);\n}\n\nexport function computeQueryFingerprint(query: string | undefined): string | undefined {\n    return computeFingerprint(String(query ?? \"\").trim());\n}\n\nexport function hasFreshReadResult(args: {\n    result: ReadFileResult | undefined;\n    file: StructuredFileCapsule | undefined;\n    query: string;\n    expectedFacts: string[];\n    mode: string;\n}): boolean {\n    const { result, file, query, expectedFacts, mode } = args;\n    if (!result || !file?.code?.trim()) {\n        return false;\n    }\n\n    const cachedFacts = new Set(result.requestedFacts ?? result.facts.map((fact) => fact.key));\n    return result.mode === mode &&\n        result.contentFingerprint === computeContentFingerprint(file.code) &&\n        result.queryFingerprint === computeQueryFingerprint(query) &&\n        expectedFacts.every((fact) => cachedFacts.has(fact));\n}\n\nexport function hasFreshSemanticAnalysis(args: {\n  analysis: FileAnalysis | undefined;\n  file: StructuredFileCapsule | undefined;\n  query: string;\n}): boolean {\n    const { analysis, file, query } = args;\n    if (!analysis?.semanticAnalyzed || !file?.code?.trim()) {\n        return false;\n    }\n\n  return analysis.contentFingerprint === computeContentFingerprint(file.code) &&\n    analysis.queryFingerprint === computeQueryFingerprint(query);\n}\n\nexport function hasFreshAgentReadEvidence(args: {\n  evidence: AgentReadEvidence | undefined;\n  code: string | undefined;\n  query: string;\n}): boolean {\n  const { evidence, code, query } = args;\n  if (!evidence || !String(code ?? \"\").trim()) {\n    return false;\n  }\n\n  return evidence.contentFingerprint === computeContentFingerprint(code) &&\n    evidence.queryFingerprint === computeQueryFingerprint(query);\n}\n"]}

package/dist/utils/fileTree.js

@@ -62,3 +62,4 @@ export function generateFileTree(dir, depth, highlightPath, prefix = '') {
     });
     return output;
 }
+//# sourceMappingURL=fileTree.js.map

package/dist/utils/fileTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileTree.js","sourceRoot":"","sources":["../../src/utils/fileTree.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'fs';\r\nimport path from 'path';\r\nimport { getIndexDir } from '../constants.js';\r\nimport { IGNORED_FOLDER_GLOBS } from '../fileRules/ignoredPaths.js';\r\n\r\n/** Utility to check if a file/folder should be ignored */\r\n/** Utility to check if a file/folder should be ignored */\r\nfunction isIgnored(fullPath: string): boolean {\r\n  const normalizedPath = fullPath.replace(/\\\\/g, '/');\r\n\r\n  return IGNORED_FOLDER_GLOBS.some(pattern => {\r\n    // remove leading/trailing **\r\n    const cleanPattern = pattern.replace(/^\\*\\*\\/?/, '').replace(/\\/\\*\\*$/, '');\r\n    return normalizedPath.includes(cleanPattern);\r\n  });\r\n}\r\n\r\n\r\n/**\r\n * Generate a reduced file tree centered around the focus path, including nearby sibling folders.\r\n */\r\nexport function generateFocusedFileTree(\r\n  focusPath: string,\r\n  maxDepth: number = 2,\r\n  siblingWindow: number = 2\r\n): string {\r\n  const absoluteFocus = path.resolve(focusPath);\r\n  const fileOrDir = fs.statSync(absoluteFocus);\r\n  const targetDir = fileOrDir.isDirectory() ? absoluteFocus : path.dirname(absoluteFocus);\r\n\r\n  const parentDir = path.dirname(targetDir);\r\n  const indexDir = getIndexDir();\r\n\r\n  const siblings = fs\r\n    .readdirSync(parentDir, { withFileTypes: true })\r\n    .filter(entry => entry.isDirectory() && !isIgnored(path.join(parentDir, entry.name)))\r\n    .sort((a, b) => a.name.localeCompare(b.name));\r\n\r\n  const focusIndex = siblings.findIndex(\r\n    entry => path.resolve(path.join(parentDir, entry.name)) === path.resolve(targetDir)\r\n  );\r\n\r\n  const start = Math.max(0, focusIndex - siblingWindow);\r\n  const end = Math.min(siblings.length, focusIndex + siblingWindow + 1);\r\n  const nearbySiblings = siblings.slice(start, end);\r\n\r\n  const relativeTitle = path.relative(indexDir, parentDir).replace(/\\\\/g, '/') || '.';\r\n  let output = `📂 ${relativeTitle}\\n`;\r\n\r\n  nearbySiblings.forEach(entry => {\r\n    const siblingPath = path.join(parentDir, entry.name);\r\n    const isFocusDir = path.resolve(siblingPath) === path.resolve(targetDir);\r\n    const tree = generateFileTree(\r\n      siblingPath,\r\n      maxDepth - 1,\r\n      isFocusDir ? absoluteFocus : undefined,\r\n      '│   '\r\n    );\r\n    output += `${isFocusDir ? '➡️ ' : ''}${entry.name}/\\n${tree}`;\r\n  });\r\n\r\n  return output;\r\n}\r\n\r\nexport function generateFileTree(\r\n  dir: string,\r\n  depth: number,\r\n  highlightPath?: string,\r\n  prefix = ''\r\n): string {\r\n  if (depth < 0) return '';\r\n\r\n  let output = '';\r\n  const entries = fs.readdirSync(dir, { withFileTypes: true })\r\n    .filter(entry => !isIgnored(path.join(dir, entry.name)));\r\n\r\n  const sorted = entries.sort((a, b) => Number(b.isDirectory()) - Number(a.isDirectory()));\r\n\r\n  sorted.forEach((entry, index) => {\r\n    const isLast = index === sorted.length - 1;\r\n    const connector = isLast ? '└── ' : '├── ';\r\n    const fullPath = path.join(dir, entry.name);\r\n    const isHighlighted = highlightPath && path.resolve(fullPath) === path.resolve(highlightPath);\r\n\r\n    if (entry.isDirectory()) {\r\n      output += `${prefix}${connector}${entry.name}/\\n`;\r\n      output += generateFileTree(fullPath, depth - 1, highlightPath, prefix + (isLast ? '    ' : '│   '));\r\n    } else {\r\n      const name = isHighlighted ? `➡️ ${entry.name}` : entry.name;\r\n      output += `${prefix}${connector}${name}\\n`;\r\n    }\r\n  });\r\n\r\n  return output;\r\n}\r\n"]}

package/dist/utils/loadRelevantFolderCapsules.js

@@ -2,17 +2,46 @@
 import { getDbForRepo } from '../db/client.js';
 import path from 'path';
 import fs from 'fs';
-export function loadRelevantFolderCapsules(paths) {
+import { normalizePath } from './contentUtils.js';
+export function loadRelevantFolderCapsules(paths, options) {
     const db = getDbForRepo();
     const capsules = [];
+    const repoRootPath = options?.repoRootPath ? normalizePath(options.repoRootPath) : undefined;
+    const executionPath = options?.executionPath ? normalizePath(options.executionPath) : undefined;
+    const toCanonical = (inputPath) => {
+        const normalized = normalizePath(inputPath);
+        if (!repoRootPath || !executionPath || repoRootPath === executionPath)
+            return normalized;
+        const relative = path.relative(executionPath, normalized);
+        if (!relative || relative.startsWith(".."))
+            return normalized;
+        return normalizePath(path.join(repoRootPath, relative));
+    };
+    const toExecution = (inputPath) => {
+        const normalized = normalizePath(inputPath);
+        if (!repoRootPath || !executionPath || repoRootPath === executionPath)
+            return normalized;
+        const relative = path.relative(repoRootPath, normalized);
+        if (!relative || relative.startsWith(".."))
+            return normalized;
+        return normalizePath(path.join(executionPath, relative));
+    };
+    const canonicalPaths = paths.map(toCanonical);
     // 1️⃣ Query DB first
-    const placeholders = paths.map(() => '?').join(',');
-    const stmt = db.prepare(`SELECT capsule_json FROM folder_capsules WHERE path IN (${placeholders})`);
-    const dbRows = stmt.all(...paths);
+    const dbRows = canonicalPaths.length
+        ? db.prepare(`SELECT capsule_json FROM folder_capsules WHERE path IN (${canonicalPaths.map(() => '?').join(',')})`).all(...canonicalPaths)
+        : [];
     for (const row of dbRows) {
         try {
             const c = JSON.parse(row.capsule_json);
-            capsules.push(c);
+            capsules.push({
+                ...c,
+                path: toExecution(c.path),
+                keyFiles: (c.keyFiles ?? []).map(keyFile => ({
+                    ...keyFile,
+                    path: toExecution(keyFile.path),
+                })),
+            });
         }
         catch {
             // skip malformed JSON
@@ -62,3 +91,4 @@ export function loadRelevantFolderCapsules(paths) {
     }
     return capsules;
 }
+//# sourceMappingURL=loadRelevantFolderCapsules.js.map