scai 0.1.178 → 1.0.0

package/dist/utils/runtimeLogger.js

@@ -0,0 +1,252 @@
+/**
+ * Writes shared runtime records to the human log and structured ndjson log.
+ *
+ * Why this file exists:
+ * - `runtime.log` is the human log renderer for local runs
+ * - `runtime.ndjson` is the machine log sink with canonical structured records
+ * - old and new runtimes should write through one backend during migration
+ * - human log header shaping should stay here so console formatting stays separate
+ */
+import fs from "fs";
+import { Chalk } from "chalk";
+import { log } from "../utils/log.js";
+import { RUNTIME_LOG_PATH, RUNTIME_NDJSON_PATH, SCAI_HOME } from "../constants.js";
+import { formatHumanTimestamp, formatLocalIso, nowLocalIso } from "./time.js";
+const runtimeLogChalk = new Chalk({ level: 3 });
+/**
+ * Formats one human-only run-start section so new ask runs are easy to spot in `runtime.log`.
+ * Example: `agent`, `Explain agentLoop.ts` -> yellow `== Simple Agent Run ==` plus the query.
+ */
+function formatRunStartSection(runtime, query) {
+    const title = getRunTitle(runtime);
+    const section = runtimeLogChalk.hex("#FF9500").bold(`== ${title} ==`);
+    const queryLine = runtimeLogChalk.hex("#FFD166")(`Query: ${query.trim()}`);
+    return `\n${section}\n${queryLine}\n`;
+}
+function getRunTitle(runtime) {
+    return runtime === "agent"
+        ? "Simple Agent Run"
+        : runtime === "main"
+            ? "Main Agent Run"
+            : "Shared Run";
+}
+function ensureHomeDir() {
+    if (!fs.existsSync(SCAI_HOME)) {
+        fs.mkdirSync(SCAI_HOME, { recursive: true });
+    }
+}
+function stringifyPayload(payload) {
+    if (payload === undefined) {
+        return "";
+    }
+    if (typeof payload === "string") {
+        return payload.trim();
+    }
+    return JSON.stringify(payload, null, 2);
+}
+/**
+ * Colors one human runtime header token while keeping the bracketed shape stable.
+ * Example: `step:started step=step-003 action=read-file` -> cyan.
+ */
+function colorHumanHeaderTag(kind, text) {
+    switch (kind) {
+        case "llm":
+            return runtimeLogChalk.blue(text);
+        case "step":
+            return runtimeLogChalk.cyan(text);
+        case "tool":
+            return runtimeLogChalk.green(text);
+        case "error":
+            return runtimeLogChalk.red(text);
+        case "task":
+            return runtimeLogChalk.yellow(text);
+        case "user-message":
+            return runtimeLogChalk.magenta(text);
+        case "legacy":
+            return runtimeLogChalk.gray(text);
+    }
+}
+/**
+ * Extracts step transition parts from a `[STATE]` user message.
+ * Example: `[STATE] step step-004 running -> done | action=read-file | 38.7s`
+ * becomes `{ stepId: "step-004", from: "running", to: "done", action: "read-file", durationText: "38.7s" }`.
+ */
+function parseUserMessageStateHeader(summary) {
+    const stateMatch = summary?.match(/^\[STATE\] step (\S+) (\S+) -> (\S+) \| action=(\S+?)(?: \| (.+))?$/);
+    if (!stateMatch) {
+        return undefined;
+    }
+    return {
+        stepId: stateMatch[1],
+        from: stateMatch[2],
+        to: stateMatch[3],
+        action: stateMatch[4],
+        durationText: stateMatch[5]?.trim() || undefined,
+    };
+}
+/**
+ * Extracts header metadata from structured payloads and user-facing messages.
+ * Example: a step payload with `action=read-file` becomes `action=read-file` in the header.
+ */
+function extractHeaderMetadata(record) {
+    const objectPayload = typeof record.payload === "object" && record.payload !== null
+        ? record.payload
+        : undefined;
+    const nestedPayload = typeof objectPayload?.payload === "object" && objectPayload.payload !== null
+        ? objectPayload.payload
+        : undefined;
+    const readString = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+    const normalizeAgentLabel = (value) => value?.replace(/^agent\./, "");
+    const summary = readString(record.summary);
+    const stepId = readString(record.stepId) ?? readString(objectPayload?.stepId);
+    const payloadAction = readString(objectPayload?.action) ?? readString(nestedPayload?.action);
+    const payloadLabel = readString(objectPayload?.label) ?? readString(nestedPayload?.label);
+    if (record.kind === "user-message") {
+        const stateDetails = parseUserMessageStateHeader(summary);
+        if (stateDetails) {
+            return {
+                stepId: stateDetails.stepId,
+                from: stateDetails.from,
+                to: stateDetails.to,
+                action: stateDetails.action,
+                summaryOverride: stateDetails.durationText
+                    ? `[STATE] ${stateDetails.durationText}`
+                    : "[STATE]",
+            };
+        }
+        const llmMatch = summary?.match(/^\[LLM\] ([^|]+?) finished\b/);
+        if (llmMatch) {
+            return {
+                label: llmMatch[1]?.trim(),
+            };
+        }
+        return {};
+    }
+    if (record.kind === "llm") {
+        const label = normalizeAgentLabel(payloadLabel) ?? normalizeAgentLabel(summary);
+        return {
+            stepId,
+            ...(label ? { label } : {}),
+            suppressSummary: Boolean(label && summary),
+        };
+    }
+    if (record.kind === "tool") {
+        const action = payloadAction ?? summary;
+        return {
+            stepId,
+            ...(action ? { action } : {}),
+            suppressSummary: Boolean(action),
+        };
+    }
+    if (record.kind === "step") {
+        const action = payloadAction;
+        const genericStepSummary = summary === "step-created"
+            || summary === "step-started"
+            || summary === "step-succeeded"
+            || summary === "step-failed";
+        const actionInputSummary = Boolean(action && summary === `${action} input`);
+        return {
+            stepId,
+            ...(action ? { action } : {}),
+            suppressSummary: genericStepSummary || actionInputSummary,
+        };
+    }
+    if (record.kind === "error") {
+        return {
+            stepId,
+            ...(payloadAction ? { action: payloadAction } : {}),
+        };
+    }
+    return { stepId };
+}
+/**
+ * Groups runtime phase and scan keys into one colored token for fast scanning.
+ * Example: `tool`, `output`, `step-002`, `triage-file` -> `tool:output step=step-002 action=triage-file`.
+ */
+function formatHumanHeaderTag(record) {
+    const metadata = extractHeaderMetadata(record);
+    const isStateUserMessage = record.kind === "user-message"
+        && Boolean(metadata.from && metadata.to && metadata.stepId && metadata.action);
+    const parts = isStateUserMessage
+        ? [
+            `${record.kind}:${record.phase}`,
+            `${metadata.stepId} ${metadata.from} -> ${metadata.to}`,
+            `| action=${metadata.action}`,
+        ]
+        : [
+            `${record.kind}:${record.phase}`,
+            metadata.stepId ? `step=${metadata.stepId}` : "",
+            metadata.action ? `action=${metadata.action}` : "",
+            metadata.label ? `label=${metadata.label}` : "",
+        ].filter(Boolean);
+    return colorHumanHeaderTag(record.kind, parts.join(" "));
+}
+function formatHumanRecord(record) {
+    const timestamp = formatHumanTimestamp(record.at ?? nowLocalIso());
+    const runtime = record.runtime ?? "shared";
+    const metadata = extractHeaderMetadata(record);
+    const ids = [
+        record.sessionId ? `session=${record.sessionId}` : "",
+        record.taskId !== undefined ? `task=${record.taskId}` : "",
+    ].filter(Boolean).join(" ");
+    const status = record.status ? ` status=${record.status}` : "";
+    const visibleSummary = metadata.summaryOverride ?? record.summary;
+    const summary = metadata.suppressSummary || !visibleSummary ? "" : ` ${visibleSummary}`;
+    const payload = stringifyPayload(record.payload);
+    const header = `[${timestamp}] [${runtime}] [${formatHumanHeaderTag(record)}]${status}${ids ? ` ${ids}` : ""}${summary}`;
+    return payload ? `${header}\n${payload}\n` : `${header}\n`;
+}
+export function appendHumanRuntimeEntry(entry) {
+    try {
+        ensureHomeDir();
+        fs.appendFileSync(RUNTIME_LOG_PATH, entry.endsWith("\n") ? entry : `${entry}\n`, "utf-8");
+    }
+    catch (err) {
+        log("❌ Failed to append runtime log entry:", err);
+    }
+}
+export function appendRunStartSection(runtime, query) {
+    appendHumanRuntimeEntry(formatRunStartSection(runtime, query));
+}
+export function logRunStart(runtime, query) {
+    appendRunStartSection(runtime, query);
+    return logRuntimeRecord({
+        runtime,
+        kind: "task",
+        phase: "created",
+        status: "active",
+        summary: "run started",
+        payload: {
+            boundary: "start",
+            title: getRunTitle(runtime),
+            query: query.trim(),
+        },
+    });
+}
+export function logRuntimeRecord(record) {
+    const normalized = {
+        ...record,
+        at: formatLocalIso(record.at ?? nowLocalIso()),
+        runtime: record.runtime ?? "shared",
+    };
+    try {
+        ensureHomeDir();
+        appendHumanRuntimeEntry(formatHumanRecord(normalized));
+        fs.appendFileSync(RUNTIME_NDJSON_PATH, `${JSON.stringify(normalized)}\n`, "utf-8");
+    }
+    catch (err) {
+        log("❌ Failed to write runtime log record:", err);
+    }
+    return normalized;
+}
+export function clearRuntimeLogs() {
+    try {
+        ensureHomeDir();
+        fs.writeFileSync(RUNTIME_LOG_PATH, "", { flag: "w" });
+        fs.writeFileSync(RUNTIME_NDJSON_PATH, "", { flag: "w" });
+    }
+    catch (err) {
+        log("❌ Failed to clear runtime logs:", err);
+    }
+}
+//# sourceMappingURL=runtimeLogger.js.map

package/dist/utils/runtimeLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeLogger.js","sourceRoot":"","sources":["../../src/utils/runtimeLogger.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Writes shared runtime records to the human log and structured ndjson log.\n *\n * Why this file exists:\n * - `runtime.log` is the human log renderer for local runs\n * - `runtime.ndjson` is the machine log sink with canonical structured records\n * - old and new runtimes should write through one backend during migration\n * - human log header shaping should stay here so console formatting stays separate\n */\nimport fs from \"fs\";\nimport { Chalk } from \"chalk\";\nimport { log } from \"../utils/log.js\";\nimport { RUNTIME_LOG_PATH, RUNTIME_NDJSON_PATH, SCAI_HOME } from \"../constants.js\";\nimport { formatHumanTimestamp, formatLocalIso, nowLocalIso } from \"./time.js\";\n\nexport type RuntimeLogKind = \"task\" | \"step\" | \"llm\" | \"tool\" | \"error\" | \"user-message\" | \"legacy\";\nexport type RuntimeLogPhase =\n  | \"input\"\n  | \"output\"\n  | \"created\"\n  | \"started\"\n  | \"finished\"\n  | \"succeeded\"\n  | \"failed\"\n  | \"finalized\"\n  | \"requested\"\n  | \"shown\";\nexport type RuntimeLogStatus = \"ok\" | \"error\" | \"active\" | \"done\" | \"blocked\" | \"failed\" | \"skipped\";\nexport type RuntimeLifecycleStatus = RuntimeLogStatus | \"pending\" | \"running\" | \"waiting\";\n\nexport type RuntimeLogRecord = {\n  at?: string;\n  runtime?: \"main\" | \"agent\" | \"shared\";\n  sessionId?: string;\n  taskId?: string | number;\n  stepId?: string;\n  kind: RuntimeLogKind;\n  phase: RuntimeLogPhase;\n  status?: RuntimeLifecycleStatus;\n  summary: string;\n  payload?: unknown;\n};\n\nconst runtimeLogChalk = new Chalk({ level: 3 });\n\n/**\n * Formats one human-only run-start section so new ask runs are easy to spot in `runtime.log`.\n * Example: `agent`, `Explain agentLoop.ts` -> yellow `== Simple Agent Run ==` plus the query.\n */\nfunction formatRunStartSection(runtime: RuntimeLogRecord[\"runtime\"], query: string): string {\n  const title = getRunTitle(runtime);\n  const section = runtimeLogChalk.hex(\"#FF9500\").bold(`== ${title} ==`);\n  const queryLine = runtimeLogChalk.hex(\"#FFD166\")(`Query: ${query.trim()}`);\n  return `\\n${section}\\n${queryLine}\\n`;\n}\n\nfunction getRunTitle(runtime: RuntimeLogRecord[\"runtime\"]): string {\n  return runtime === \"agent\"\n    ? \"Simple Agent Run\"\n    : runtime === \"main\"\n      ? \"Main Agent Run\"\n      : \"Shared Run\";\n}\n\nfunction ensureHomeDir(): void {\n  if (!fs.existsSync(SCAI_HOME)) {\n    fs.mkdirSync(SCAI_HOME, { recursive: true });\n  }\n}\n\nfunction stringifyPayload(payload: unknown): string {\n  if (payload === undefined) {\n    return \"\";\n  }\n  if (typeof payload === \"string\") {\n    return payload.trim();\n  }\n  return JSON.stringify(payload, null, 2);\n}\n\n/**\n * Colors one human runtime header token while keeping the bracketed shape stable.\n * Example: `step:started step=step-003 action=read-file` -> cyan.\n */\nfunction colorHumanHeaderTag(kind: RuntimeLogKind, text: string): string {\n  switch (kind) {\n    case \"llm\":\n      return runtimeLogChalk.blue(text);\n    case \"step\":\n      return runtimeLogChalk.cyan(text);\n    case \"tool\":\n      return runtimeLogChalk.green(text);\n    case \"error\":\n      return runtimeLogChalk.red(text);\n    case \"task\":\n      return runtimeLogChalk.yellow(text);\n    case \"user-message\":\n      return runtimeLogChalk.magenta(text);\n    case \"legacy\":\n      return runtimeLogChalk.gray(text);\n  }\n}\n\ntype StateHeaderMatch = {\n  stepId: string;\n  from: string;\n  to: string;\n  action: string;\n  durationText?: string;\n};\n\n/**\n * Extracts step transition parts from a `[STATE]` user message.\n * Example: `[STATE] step step-004 running -> done | action=read-file | 38.7s`\n * becomes `{ stepId: \"step-004\", from: \"running\", to: \"done\", action: \"read-file\", durationText: \"38.7s\" }`.\n */\nfunction parseUserMessageStateHeader(summary: string | undefined): StateHeaderMatch | undefined {\n  const stateMatch = summary?.match(\n    /^\\[STATE\\] step (\\S+) (\\S+) -> (\\S+) \\| action=(\\S+?)(?: \\| (.+))?$/\n  );\n  if (!stateMatch) {\n    return undefined;\n  }\n  return {\n    stepId: stateMatch[1],\n    from: stateMatch[2],\n    to: stateMatch[3],\n    action: stateMatch[4],\n    durationText: stateMatch[5]?.trim() || undefined,\n  };\n}\n\n/**\n * Extracts header metadata from structured payloads and user-facing messages.\n * Example: a step payload with `action=read-file` becomes `action=read-file` in the header.\n */\nfunction extractHeaderMetadata(record: RuntimeLogRecord): {\n  stepId?: string;\n  action?: string;\n  label?: string;\n  from?: string;\n  to?: string;\n  summaryOverride?: string;\n  suppressSummary?: boolean;\n} {\n  const objectPayload = typeof record.payload === \"object\" && record.payload !== null\n    ? record.payload as Record<string, unknown>\n    : undefined;\n  const nestedPayload = typeof objectPayload?.payload === \"object\" && objectPayload.payload !== null\n    ? objectPayload.payload as Record<string, unknown>\n    : undefined;\n  const readString = (value: unknown): string | undefined =>\n    typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n  const normalizeAgentLabel = (value: string | undefined): string | undefined =>\n    value?.replace(/^agent\\./, \"\");\n  const summary = readString(record.summary);\n  const stepId = readString(record.stepId) ?? readString(objectPayload?.stepId);\n  const payloadAction = readString(objectPayload?.action) ?? readString(nestedPayload?.action);\n  const payloadLabel = readString(objectPayload?.label) ?? readString(nestedPayload?.label);\n\n  if (record.kind === \"user-message\") {\n    const stateDetails = parseUserMessageStateHeader(summary);\n    if (stateDetails) {\n      return {\n        stepId: stateDetails.stepId,\n        from: stateDetails.from,\n        to: stateDetails.to,\n        action: stateDetails.action,\n        summaryOverride: stateDetails.durationText\n          ? `[STATE] ${stateDetails.durationText}`\n          : \"[STATE]\",\n      };\n    }\n    const llmMatch = summary?.match(/^\\[LLM\\] ([^|]+?) finished\\b/);\n    if (llmMatch) {\n      return {\n        label: llmMatch[1]?.trim(),\n      };\n    }\n    return {};\n  }\n\n  if (record.kind === \"llm\") {\n    const label = normalizeAgentLabel(payloadLabel) ?? normalizeAgentLabel(summary);\n    return {\n      stepId,\n      ...(label ? { label } : {}),\n      suppressSummary: Boolean(label && summary),\n    };\n  }\n\n  if (record.kind === \"tool\") {\n    const action = payloadAction ?? summary;\n    return {\n      stepId,\n      ...(action ? { action } : {}),\n      suppressSummary: Boolean(action),\n    };\n  }\n\n  if (record.kind === \"step\") {\n    const action = payloadAction;\n    const genericStepSummary = summary === \"step-created\"\n      || summary === \"step-started\"\n      || summary === \"step-succeeded\"\n      || summary === \"step-failed\";\n    const actionInputSummary = Boolean(action && summary === `${action} input`);\n    return {\n      stepId,\n      ...(action ? { action } : {}),\n      suppressSummary: genericStepSummary || actionInputSummary,\n    };\n  }\n\n  if (record.kind === \"error\") {\n    return {\n      stepId,\n      ...(payloadAction ? { action: payloadAction } : {}),\n    };\n  }\n\n  return { stepId };\n}\n\n/**\n * Groups runtime phase and scan keys into one colored token for fast scanning.\n * Example: `tool`, `output`, `step-002`, `triage-file` -> `tool:output step=step-002 action=triage-file`.\n */\nfunction formatHumanHeaderTag(record: RuntimeLogRecord): string {\n  const metadata = extractHeaderMetadata(record);\n  const isStateUserMessage = record.kind === \"user-message\"\n    && Boolean(metadata.from && metadata.to && metadata.stepId && metadata.action);\n  const parts = isStateUserMessage\n    ? [\n      `${record.kind}:${record.phase}`,\n      `${metadata.stepId} ${metadata.from} -> ${metadata.to}`,\n      `| action=${metadata.action}`,\n    ]\n    : [\n      `${record.kind}:${record.phase}`,\n      metadata.stepId ? `step=${metadata.stepId}` : \"\",\n      metadata.action ? `action=${metadata.action}` : \"\",\n      metadata.label ? `label=${metadata.label}` : \"\",\n    ].filter(Boolean);\n  return colorHumanHeaderTag(record.kind, parts.join(\" \"));\n}\n\nfunction formatHumanRecord(record: RuntimeLogRecord): string {\n  const timestamp = formatHumanTimestamp(record.at ?? nowLocalIso());\n  const runtime = record.runtime ?? \"shared\";\n  const metadata = extractHeaderMetadata(record);\n  const ids = [\n    record.sessionId ? `session=${record.sessionId}` : \"\",\n    record.taskId !== undefined ? `task=${record.taskId}` : \"\",\n  ].filter(Boolean).join(\" \");\n  const status = record.status ? ` status=${record.status}` : \"\";\n  const visibleSummary = metadata.summaryOverride ?? record.summary;\n  const summary = metadata.suppressSummary || !visibleSummary ? \"\" : ` ${visibleSummary}`;\n  const payload = stringifyPayload(record.payload);\n  const header = `[${timestamp}] [${runtime}] [${formatHumanHeaderTag(record)}]${status}${ids ? ` ${ids}` : \"\"}${summary}`;\n  return payload ? `${header}\\n${payload}\\n` : `${header}\\n`;\n}\n\nexport function appendHumanRuntimeEntry(entry: string): void {\n  try {\n    ensureHomeDir();\n    fs.appendFileSync(RUNTIME_LOG_PATH, entry.endsWith(\"\\n\") ? entry : `${entry}\\n`, \"utf-8\");\n  } catch (err) {\n    log(\"❌ Failed to append runtime log entry:\", err);\n  }\n}\n\nexport function appendRunStartSection(runtime: RuntimeLogRecord[\"runtime\"], query: string): void {\n  appendHumanRuntimeEntry(formatRunStartSection(runtime, query));\n}\n\nexport function logRunStart(runtime: RuntimeLogRecord[\"runtime\"], query: string): RuntimeLogRecord {\n  appendRunStartSection(runtime, query);\n  return logRuntimeRecord({\n    runtime,\n    kind: \"task\",\n    phase: \"created\",\n    status: \"active\",\n    summary: \"run started\",\n    payload: {\n      boundary: \"start\",\n      title: getRunTitle(runtime),\n      query: query.trim(),\n    },\n  });\n}\n\nexport function logRuntimeRecord(record: RuntimeLogRecord): RuntimeLogRecord {\n  const normalized: RuntimeLogRecord = {\n    ...record,\n    at: formatLocalIso(record.at ?? nowLocalIso()),\n    runtime: record.runtime ?? \"shared\",\n  };\n  try {\n    ensureHomeDir();\n    appendHumanRuntimeEntry(formatHumanRecord(normalized));\n    fs.appendFileSync(RUNTIME_NDJSON_PATH, `${JSON.stringify(normalized)}\\n`, \"utf-8\");\n  } catch (err) {\n    log(\"❌ Failed to write runtime log record:\", err);\n  }\n  return normalized;\n}\n\nexport function clearRuntimeLogs(): void {\n  try {\n    ensureHomeDir();\n    fs.writeFileSync(RUNTIME_LOG_PATH, \"\", { flag: \"w\" });\n    fs.writeFileSync(RUNTIME_NDJSON_PATH, \"\", { flag: \"w\" });\n  } catch (err) {\n    log(\"❌ Failed to clear runtime logs:\", err);\n  }\n}\n"]}

package/dist/utils/sanitizeQuery.js

@@ -37,3 +37,4 @@ export function sanitizeQueryForFts(input) {
         .map(token => (token.startsWith('"') ? token : token + '*'));
     return tokens.length > 0 ? tokens.join(' OR ') : '*';
 }
+//# sourceMappingURL=sanitizeQuery.js.map

package/dist/utils/sanitizeQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeQuery.js","sourceRoot":"","sources":["../../src/utils/sanitizeQuery.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,uCAAuC;AACvC,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG;SACP,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAW,gBAAgB;SAC/C,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAU,4BAA4B;SAC3D,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,0BAA0B;SAC3D,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAW,yCAAyC;SACxE,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAQ,2BAA2B;SAC1D,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAa,2BAA2B;SAC1D,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAQ,qCAAqC;SACpE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAW,sBAAsB;SACrD,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC;SACxB,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,qBAAqB;SACvF,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,wBAAwB;IAEjD,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;IAC3C,CAAC;IAED,MAAM,MAAM,GAAG,KAAK;SACjB,KAAK,CAAC,KAAK,CAAC;SACZ,GAAG,CAAC,KAAK,CAAC,EAAE;QACX,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;QAC1C,CAAC;QACD,OAAO,KAAK;aACT,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;aAC7B,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;SACD,MAAM,CAAC,KAAK,CAAC,EAAE,CACd,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAC5C;SACA,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC;IAE/D,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACvD,CAAC","sourcesContent":["// src/utils/sanitizeQuery.ts\r\nimport { STOP_WORDS } from '../fileRules/stopWords.js';\r\n\r\n// Stage 1: normalize junk out of query\r\nexport function basicCleanup(raw: string): string {\r\n  return raw\r\n    .replace(/[\"']/g, '')           // remove quotes\r\n    .replace(/[()]/g, ' ')          // replace parens with space\r\n    .replace(/\\bOR\\b|\\bAND\\b/gi, ' ') // strip boolean operators\r\n    .replace(/\\w+:/g, '')           // remove field prefixes like path:, ext:\r\n    .replace(/[<>=*]/g, ' ')        // remove invalid operators\r\n    .replace(/\\\\/g, '')             // remove stray backslashes\r\n    .replace(/<[^>]+>/g, '')        // strip placeholders like <endpoint>\r\n    .replace(/\\s+/g, ' ')           // collapse whitespace\r\n    .trim();\r\n}\r\n\r\n// Stage 2: tokenize & prepare for FTS5\r\nexport function sanitizeQueryForFts(input: string): string {\r\n  input = basicCleanup(input)\r\n    .toLowerCase()\r\n    .replace(/\\(([^)]+)\\)/g, (_, inner) => inner.replace(/[|]/g, ' ')) // expand grouped ORs\r\n    .replace(/[|]/g, ' '); // handle standalone ORs\r\n\r\n  if (/^[\\w\\-./]+$/.test(input) && !/\\s/.test(input)) {\r\n    return `\"${input.replace(/\"/g, '\"\"')}\"*`;\r\n  }\r\n\r\n  const tokens = input\r\n    .split(/\\s+/)\r\n    .map(token => {\r\n      if (/[\\w]+\\.[a-z0-9]+$/.test(token)) {\r\n        return `\"${token.replace(/\"/g, '\"\"')}\"`;\r\n      }\r\n      return token\r\n        .replace(/[^a-z0-9_*\"]/gi, '')\r\n        .replace(/'/g, \"''\");\r\n    })\r\n    .filter(token =>\r\n      token.length > 2 &&\r\n      !STOP_WORDS.has(token.replace(/[*\"]/g, ''))\r\n    )\r\n    .map(token => (token.startsWith('\"') ? token : token + '*'));\r\n\r\n  return tokens.length > 0 ? tokens.join(' OR ') : '*';\r\n}\r\n\r\n"]}

package/dist/utils/sharedUtils.js

@@ -6,3 +6,4 @@ export function getUniqueId(name, filePath, startLine, startColumn, content) {
     const hash = crypto.createHash('md5').update(content).digest('hex').slice(0, 6);
     return `${name}@${normalizedPath}:${startLine}:${startColumn}:${hash}`;
 }
+//# sourceMappingURL=sharedUtils.js.map

package/dist/utils/sharedUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharedUtils.js","sourceRoot":"","sources":["../../src/utils/sharedUtils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CACvB,IAAY,EACZ,QAAgB,EAChB,SAAiB,EACjB,WAAmB,EACnB,OAAe;IAEf,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChF,OAAO,GAAG,IAAI,IAAI,cAAc,IAAI,SAAS,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;AAC3E,CAAC","sourcesContent":["import path from 'path';\nimport crypto from 'crypto';\n\n// put this helper at top-level (or import from shared utils)\nexport function getUniqueId(\n    name: string,\n    filePath: string,\n    startLine: number,\n    startColumn: number,\n    content: string\n) {\n    const normalizedPath = path.normalize(filePath).replace(/\\\\/g, '/');\n    const hash = crypto.createHash('md5').update(content).digest('hex').slice(0, 6);\n    return `${name}@${normalizedPath}:${startLine}:${startColumn}:${hash}`;\n}"]}

package/dist/utils/sleep.js

@@ -1,3 +1,4 @@
 export function sleep(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }
+//# sourceMappingURL=sleep.js.map

package/dist/utils/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK,CAAC,EAAU;IAC5B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["export function sleep(ms: number) {\n    return new Promise(resolve => setTimeout(resolve, ms));\n}"]}

package/dist/utils/splitCodeIntoChunk.js

@@ -139,3 +139,4 @@ hardLimitMultiplier = 1.35 // ⬅️ allows structural completion (~3000)
 export function countTokens(text) {
     return encode(text).length;
 }
+//# sourceMappingURL=splitCodeIntoChunk.js.map

package/dist/utils/splitCodeIntoChunk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitCodeIntoChunk.js","sourceRoot":"","sources":["../../src/utils/splitCodeIntoChunk.ts"],"names":[],"mappings":"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","sourcesContent":["import { encode } from \"gpt-3-encoder\";\r\n\r\n/**\r\n * Split code into semantically safer chunks.\r\n *\r\n * Strategy:\r\n * - Aim for `softLimit` tokens\r\n * - Allow overflow up to `hardLimit` to finish structural blocks\r\n * - Never split inside functions, try-chains, comments, or open delimiters\r\n */\r\nexport function splitCodeIntoChunks(\r\n  text: string,\r\n  softLimit: number = 2200,          // ⬅️ increased from 1000\r\n  hardLimitMultiplier: number = 1.35 // ⬅️ allows structural completion (~3000)\r\n): string[] {\r\n  const hardLimit = Math.floor(softLimit * hardLimitMultiplier);\r\n\r\n  const lines = text.split(\"\\n\");\r\n  const chunks: string[] = [];\r\n\r\n  let currentChunkLines: string[] = [];\r\n  let currentTokens = 0;\r\n\r\n  // ───────────── State tracking ─────────────\r\n  let inMultiComment = false;\r\n\r\n  let inFunction = false;\r\n  let functionBraceDepth = 0;\r\n  let justClosedFunction = false;\r\n\r\n  let inTryBlock = false;\r\n  let inTryChain = false;\r\n  let tryChainHasHandler = false;\r\n  let tryBraceDepth = 0;\r\n  let justClosedTryBlock = false;\r\n\r\n  let globalBraceDepth = 0;\r\n  let parenDepth = 0;\r\n  let bracketDepth = 0;\r\n\r\n  for (const line of lines) {\r\n    const trimmed = line.trim();\r\n\r\n    justClosedFunction = false;\r\n    justClosedTryBlock = false;\r\n\r\n    // ---------- multi-line comments ----------\r\n    if (trimmed.includes(\"/*\") && !trimmed.includes(\"*/\")) inMultiComment = true;\r\n    if (trimmed.includes(\"*/\")) inMultiComment = false;\r\n\r\n    // ---------- function / class start ----------\r\n    const isFunctionStart =\r\n      trimmed.startsWith(\"function \") ||\r\n      trimmed.startsWith(\"async function \") ||\r\n      trimmed.startsWith(\"class \") ||\r\n      /^\\w+\\s*=\\s*\\(.*\\)\\s*=>\\s*{/.test(trimmed);\r\n\r\n    if (!inFunction && isFunctionStart) {\r\n      inFunction = true;\r\n      functionBraceDepth = 0;\r\n    }\r\n\r\n    // ---------- try / catch / finally ----------\r\n    if (!inTryChain && trimmed.startsWith(\"try\")) {\r\n      inTryChain = true;\r\n      inTryBlock = true;\r\n      tryBraceDepth = 0;\r\n    }\r\n\r\n    if (\r\n      inTryChain &&\r\n      (trimmed.startsWith(\"catch\") || trimmed.startsWith(\"finally\"))\r\n    ) {\r\n      inTryBlock = true;\r\n      tryChainHasHandler = true;\r\n    }\r\n\r\n    // ---------- depth tracking ----------\r\n    for (const char of line) {\r\n      switch (char) {\r\n        case \"{\":\r\n          globalBraceDepth++;\r\n          if (inFunction) functionBraceDepth++;\r\n          if (inTryChain) tryBraceDepth++;\r\n          break;\r\n\r\n        case \"}\":\r\n          globalBraceDepth = Math.max(0, globalBraceDepth - 1);\r\n\r\n          if (inFunction) {\r\n            functionBraceDepth = Math.max(0, functionBraceDepth - 1);\r\n            if (functionBraceDepth === 0) justClosedFunction = true;\r\n          }\r\n\r\n          if (inTryChain) {\r\n            tryBraceDepth = Math.max(0, tryBraceDepth - 1);\r\n            if (tryBraceDepth === 0) justClosedTryBlock = true;\r\n          }\r\n          break;\r\n\r\n        case \"(\":\r\n          parenDepth++;\r\n          break;\r\n\r\n        case \")\":\r\n          parenDepth = Math.max(0, parenDepth - 1);\r\n          break;\r\n\r\n        case \"[\":\r\n          bracketDepth++;\r\n          break;\r\n\r\n        case \"]\":\r\n          bracketDepth = Math.max(0, bracketDepth - 1);\r\n          break;\r\n      }\r\n    }\r\n\r\n    if (justClosedFunction) inFunction = false;\r\n\r\n    if (justClosedTryBlock) {\r\n      inTryBlock = false;\r\n      if (tryChainHasHandler) {\r\n        inTryChain = false;\r\n        tryChainHasHandler = false;\r\n      }\r\n    }\r\n\r\n    // ---------- add line ----------\r\n    currentChunkLines.push(line);\r\n    currentTokens += encode(line + \"\\n\").length;\r\n\r\n    // ---------- split decision ----------\r\n    const softLimitReached = currentTokens >= softLimit;\r\n    const hardLimitReached = currentTokens >= hardLimit;\r\n\r\n    /**\r\n     * Safe split means:\r\n     * - no open comments\r\n     * - not inside function or try-chain\r\n     * - no dangling delimiters\r\n     * - not immediately after a structural close\r\n     */\r\n    const safeToSplit =\r\n      !inMultiComment &&\r\n      !inFunction &&\r\n      !inTryChain &&\r\n      !justClosedFunction &&\r\n      !justClosedTryBlock &&\r\n      functionBraceDepth === 0 &&\r\n      parenDepth === 0 &&\r\n      bracketDepth === 0;\r\n\r\n    // Prefer soft limit + safety, but enforce hard limit regardless\r\n    if ((softLimitReached && safeToSplit) || hardLimitReached) {\r\n      chunks.push(currentChunkLines.join(\"\\n\"));\r\n      currentChunkLines = [];\r\n      currentTokens = 0;\r\n    }\r\n  }\r\n\r\n  if (currentChunkLines.length > 0) {\r\n    chunks.push(currentChunkLines.join(\"\\n\"));\r\n  }\r\n\r\n  return chunks;\r\n}\r\n\r\nexport function countTokens(text: string): number {\r\n  return encode(text).length;\r\n}\r\n"]}

package/dist/utils/time.js

@@ -0,0 +1,66 @@
+/**
+ * Formats local machine timestamps for logs and short runtime timing helpers.
+ *
+ * Why this file exists:
+ * - log-facing time should stay consistent across runtime logs, debug logs, and traces
+ * - local time with offset is easier to compare with the operator's machine clock
+ * - one helper avoids mixed UTC and local rendering across modules
+ */
+function pad(value, width = 2) {
+    return String(value).padStart(width, "0");
+}
+function formatOffset(date) {
+    const offsetMinutes = -date.getTimezoneOffset();
+    const sign = offsetMinutes >= 0 ? "+" : "-";
+    const absoluteOffset = Math.abs(offsetMinutes);
+    const hours = Math.floor(absoluteOffset / 60);
+    const minutes = absoluteOffset % 60;
+    return `${sign}${pad(hours)}:${pad(minutes)}`;
+}
+function formatLocalDateParts(date) {
+    return {
+        datePart: `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`,
+        timePart: `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}.${pad(date.getMilliseconds(), 3)}`,
+        offsetPart: formatOffset(date),
+    };
+}
+/**
+ * Returns one local ISO-like timestamp with the machine offset.
+ * Example: `2026-05-01T12:15:00.123+02:00`.
+ */
+export function nowLocalIso() {
+    return formatLocalIso(new Date());
+}
+/**
+ * Formats a parseable timestamp into local ISO-like time with offset.
+ * Example: `2026-05-01T10:15:00.123Z` -> `2026-05-01T12:15:00.123+02:00`.
+ */
+export function formatLocalIso(timestamp) {
+    const date = timestamp instanceof Date ? timestamp : new Date(timestamp);
+    if (Number.isNaN(date.getTime())) {
+        return String(timestamp);
+    }
+    const { datePart, timePart, offsetPart } = formatLocalDateParts(date);
+    return `${datePart}T${timePart}${offsetPart}`;
+}
+/**
+ * Formats one parseable timestamp for human log headers.
+ * Example: `2026-05-01T10:15:00.123Z` -> `2026-05-01 12:15:00 +02:00`.
+ */
+export function formatHumanTimestamp(timestamp) {
+    const date = timestamp instanceof Date ? timestamp : new Date(timestamp);
+    if (Number.isNaN(date.getTime())) {
+        return String(timestamp);
+    }
+    const { datePart, timePart, offsetPart } = formatLocalDateParts(date);
+    return `${datePart} ${timePart.slice(0, 8)} ${offsetPart}`;
+}
+/**
+ * Creates a small wall-clock timer for one logical operation.
+ * Example: `const stop = startTimer(); ... stop() -> 42`.
+ */
+export function startTimer() {
+    const startedAt = Date.now();
+    return () => Date.now() - startedAt;
+}
+//# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Formats local machine timestamps for logs and short runtime timing helpers.\n *\n * Why this file exists:\n * - log-facing time should stay consistent across runtime logs, debug logs, and traces\n * - local time with offset is easier to compare with the operator's machine clock\n * - one helper avoids mixed UTC and local rendering across modules\n */\n\nfunction pad(value: number, width = 2): string {\n  return String(value).padStart(width, \"0\");\n}\n\nfunction formatOffset(date: Date): string {\n  const offsetMinutes = -date.getTimezoneOffset();\n  const sign = offsetMinutes >= 0 ? \"+\" : \"-\";\n  const absoluteOffset = Math.abs(offsetMinutes);\n  const hours = Math.floor(absoluteOffset / 60);\n  const minutes = absoluteOffset % 60;\n  return `${sign}${pad(hours)}:${pad(minutes)}`;\n}\n\nfunction formatLocalDateParts(date: Date): {\n  datePart: string;\n  timePart: string;\n  offsetPart: string;\n} {\n  return {\n    datePart: `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`,\n    timePart: `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}.${pad(date.getMilliseconds(), 3)}`,\n    offsetPart: formatOffset(date),\n  };\n}\n\n/**\n * Returns one local ISO-like timestamp with the machine offset.\n * Example: `2026-05-01T12:15:00.123+02:00`.\n */\nexport function nowLocalIso(): string {\n  return formatLocalIso(new Date());\n}\n\n/**\n * Formats a parseable timestamp into local ISO-like time with offset.\n * Example: `2026-05-01T10:15:00.123Z` -> `2026-05-01T12:15:00.123+02:00`.\n */\nexport function formatLocalIso(timestamp: string | Date): string {\n  const date = timestamp instanceof Date ? timestamp : new Date(timestamp);\n  if (Number.isNaN(date.getTime())) {\n    return String(timestamp);\n  }\n\n  const { datePart, timePart, offsetPart } = formatLocalDateParts(date);\n  return `${datePart}T${timePart}${offsetPart}`;\n}\n\n/**\n * Formats one parseable timestamp for human log headers.\n * Example: `2026-05-01T10:15:00.123Z` -> `2026-05-01 12:15:00 +02:00`.\n */\nexport function formatHumanTimestamp(timestamp: string | Date): string {\n  const date = timestamp instanceof Date ? timestamp : new Date(timestamp);\n  if (Number.isNaN(date.getTime())) {\n    return String(timestamp);\n  }\n\n  const { datePart, timePart, offsetPart } = formatLocalDateParts(date);\n  return `${datePart} ${timePart.slice(0, 8)} ${offsetPart}`;\n}\n\n/**\n * Creates a small wall-clock timer for one logical operation.\n * Example: `const stop = startTimer(); ... stop() -> 42`.\n */\nexport function startTimer(): () => number {\n  const startedAt = Date.now();\n  return () => Date.now() - startedAt;\n}\n"]}

package/dist/utils/verifyFocusPreference.js

@@ -0,0 +1,107 @@
+/**
+ * Computes shared file-preference signals for verify-heavy repo-wide queries.
+ *
+ * Why this exists:
+ * - retrieval, verify focus refinement, and final grounding all need the same preference policy
+ * - verify-focused questions should favor real verify pipeline files over broad docs or preload-only files
+ * - callers combine this preference with their own local evidence instead of persisting one global score
+ */
+import path from "path";
+import { extractFileReferences } from "./extractFileReferences.js";
+const VERIFY_FOCUS_QUERY_TERMS = [
+    "selectedfiles",
+    "candidatefiles",
+    "verify",
+    "wave",
+    "waves",
+    "budget",
+    "maxwaves",
+    "groundingbudget",
+    "readiness",
+    "focus",
+    "trace",
+];
+const VERIFY_FOCUS_STRONG_TERMS = [
+    "selectedfiles",
+    "candidatefiles",
+    "verify",
+    "budget",
+    "groundingbudget",
+];
+const VERIFY_FOCUS_PREFERRED_HINTS = [
+    { hint: "getgroundingwavebudget", score: 1.35 },
+    { hint: "mainagentverify", score: 1.2 },
+    { hint: "filecheckstep", score: 1.1 },
+    { hint: "readinessgatestep", score: 1.05 },
+    { hint: "selectrelevantsourcesstep", score: 1.0 },
+    { hint: "executionpolicyresolver", score: 0.9 },
+];
+const VERIFY_FOCUS_DEBOOST_HINTS = [
+    { hint: "analysisplangenstep", score: -0.45 },
+    { hint: "structuralpreloadstep", score: -0.5 },
+    { hint: "/readme.md", score: -0.35 },
+    { hint: "/agents.md", score: -0.35 },
+    { hint: "/changelog.md", score: -0.35 },
+];
+const VERIFY_FOCUS_TEXT_SIGNALS = [
+    { term: "selectedfiles", score: 0.4 },
+    { term: "candidatefiles", score: 0.4 },
+    { term: "groundingbudget", score: 0.45 },
+    { term: "maxwaves", score: 0.35 },
+    { term: "budget", score: 0.2 },
+    { term: "readiness", score: 0.2 },
+    { term: "verify", score: 0.2 },
+];
+/**
+ * Detects real verify-flow questions and avoids boosting unrelated trace queries.
+ * Example: "Trace selectedFiles across verify waves" => true.
+ * Example: "Trace SQLite queries in db/client.ts" => false.
+ */
+export function isVerifyFocusQueryText(query) {
+    const queryLower = query.toLowerCase();
+    const matchedTerms = VERIFY_FOCUS_QUERY_TERMS.filter(term => queryLower.includes(term));
+    if (matchedTerms.length < 2)
+        return false;
+    const strongMatchCount = VERIFY_FOCUS_STRONG_TERMS.filter(term => queryLower.includes(term)).length;
+    return strongMatchCount > 0;
+}
+/**
+ * Returns a reusable verify-focus preference score for one file.
+ * Example: `mainAgentVerify.ts` with selectedFiles evidence scores above `README.md`.
+ */
+export function getVerifyFocusFilePreference(args) {
+    if (!isVerifyFocusQueryText(args.query)) {
+        return { applies: false, score: 0, reasons: [] };
+    }
+    const explicitRefs = args.explicitRefs ?? extractFileReferences(args.query, { lowercase: true });
+    const explicitBasenames = new Set(explicitRefs.map(ref => path.basename(ref)));
+    const fileLower = args.filePath.toLowerCase();
+    const basename = path.basename(fileLower);
+    const searchableText = `${args.evidenceText ?? ""} ${args.contentText ?? ""}`.toLowerCase();
+    let score = 0;
+    const reasons = [];
+    for (const { hint, score: hintScore } of VERIFY_FOCUS_PREFERRED_HINTS) {
+        if (basename.includes(hint) || fileLower.includes(hint)) {
+            score += hintScore;
+            reasons.push(`prefer:${hint}`);
+        }
+    }
+    for (const { hint, score: hintScore } of VERIFY_FOCUS_DEBOOST_HINTS) {
+        if ((basename.includes(hint) || fileLower.includes(hint)) && !explicitBasenames.has(basename)) {
+            score += hintScore;
+            reasons.push(`deboost:${hint}`);
+        }
+    }
+    for (const { term, score: termScore } of VERIFY_FOCUS_TEXT_SIGNALS) {
+        if (fileLower.includes(term)) {
+            score += termScore;
+            reasons.push(`path-signal:${term}`);
+        }
+        if (searchableText.includes(term)) {
+            score += termScore;
+            reasons.push(`text-signal:${term}`);
+        }
+    }
+    return { applies: true, score, reasons };
+}
+//# sourceMappingURL=verifyFocusPreference.js.map

package/dist/utils/verifyFocusPreference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyFocusPreference.js","sourceRoot":"","sources":["../../src/utils/verifyFocusPreference.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Computes shared file-preference signals for verify-heavy repo-wide queries.\n *\n * Why this exists:\n * - retrieval, verify focus refinement, and final grounding all need the same preference policy\n * - verify-focused questions should favor real verify pipeline files over broad docs or preload-only files\n * - callers combine this preference with their own local evidence instead of persisting one global score\n */\nimport path from \"path\";\nimport { extractFileReferences } from \"./extractFileReferences.js\";\n\nconst VERIFY_FOCUS_QUERY_TERMS = [\n    \"selectedfiles\",\n    \"candidatefiles\",\n    \"verify\",\n    \"wave\",\n    \"waves\",\n    \"budget\",\n    \"maxwaves\",\n    \"groundingbudget\",\n    \"readiness\",\n    \"focus\",\n    \"trace\",\n];\n\nconst VERIFY_FOCUS_STRONG_TERMS = [\n    \"selectedfiles\",\n    \"candidatefiles\",\n    \"verify\",\n    \"budget\",\n    \"groundingbudget\",\n];\n\nconst VERIFY_FOCUS_PREFERRED_HINTS: Array<{ hint: string; score: number }> = [\n    { hint: \"getgroundingwavebudget\", score: 1.35 },\n    { hint: \"mainagentverify\", score: 1.2 },\n    { hint: \"filecheckstep\", score: 1.1 },\n    { hint: \"readinessgatestep\", score: 1.05 },\n    { hint: \"selectrelevantsourcesstep\", score: 1.0 },\n    { hint: \"executionpolicyresolver\", score: 0.9 },\n];\n\nconst VERIFY_FOCUS_DEBOOST_HINTS: Array<{ hint: string; score: number }> = [\n    { hint: \"analysisplangenstep\", score: -0.45 },\n    { hint: \"structuralpreloadstep\", score: -0.5 },\n    { hint: \"/readme.md\", score: -0.35 },\n    { hint: \"/agents.md\", score: -0.35 },\n    { hint: \"/changelog.md\", score: -0.35 },\n];\n\nconst VERIFY_FOCUS_TEXT_SIGNALS: Array<{ term: string; score: number }> = [\n    { term: \"selectedfiles\", score: 0.4 },\n    { term: \"candidatefiles\", score: 0.4 },\n    { term: \"groundingbudget\", score: 0.45 },\n    { term: \"maxwaves\", score: 0.35 },\n    { term: \"budget\", score: 0.2 },\n    { term: \"readiness\", score: 0.2 },\n    { term: \"verify\", score: 0.2 },\n];\n\nexport type VerifyFocusPreference = {\n    applies: boolean;\n    score: number;\n    reasons: string[];\n};\n\n/**\n * Detects real verify-flow questions and avoids boosting unrelated trace queries.\n * Example: \"Trace selectedFiles across verify waves\" => true.\n * Example: \"Trace SQLite queries in db/client.ts\" => false.\n */\nexport function isVerifyFocusQueryText(query: string): boolean {\n    const queryLower = query.toLowerCase();\n    const matchedTerms = VERIFY_FOCUS_QUERY_TERMS.filter(term => queryLower.includes(term));\n    if (matchedTerms.length < 2) return false;\n\n    const strongMatchCount = VERIFY_FOCUS_STRONG_TERMS.filter(term => queryLower.includes(term)).length;\n    return strongMatchCount > 0;\n}\n\n/**\n * Returns a reusable verify-focus preference score for one file.\n * Example: `mainAgentVerify.ts` with selectedFiles evidence scores above `README.md`.\n */\nexport function getVerifyFocusFilePreference(args: {\n    query: string;\n    filePath: string;\n    evidenceText?: string;\n    contentText?: string;\n    explicitRefs?: string[];\n}): VerifyFocusPreference {\n    if (!isVerifyFocusQueryText(args.query)) {\n        return { applies: false, score: 0, reasons: [] };\n    }\n\n    const explicitRefs = args.explicitRefs ?? extractFileReferences(args.query, { lowercase: true });\n    const explicitBasenames = new Set(explicitRefs.map(ref => path.basename(ref)));\n    const fileLower = args.filePath.toLowerCase();\n    const basename = path.basename(fileLower);\n    const searchableText = `${args.evidenceText ?? \"\"} ${args.contentText ?? \"\"}`.toLowerCase();\n    let score = 0;\n    const reasons: string[] = [];\n\n    for (const { hint, score: hintScore } of VERIFY_FOCUS_PREFERRED_HINTS) {\n        if (basename.includes(hint) || fileLower.includes(hint)) {\n            score += hintScore;\n            reasons.push(`prefer:${hint}`);\n        }\n    }\n\n    for (const { hint, score: hintScore } of VERIFY_FOCUS_DEBOOST_HINTS) {\n        if ((basename.includes(hint) || fileLower.includes(hint)) && !explicitBasenames.has(basename)) {\n            score += hintScore;\n            reasons.push(`deboost:${hint}`);\n        }\n    }\n\n    for (const { term, score: termScore } of VERIFY_FOCUS_TEXT_SIGNALS) {\n        if (fileLower.includes(term)) {\n            score += termScore;\n            reasons.push(`path-signal:${term}`);\n        }\n        if (searchableText.includes(term)) {\n            score += termScore;\n            reasons.push(`text-signal:${term}`);\n        }\n    }\n\n    return { applies: true, score, reasons };\n}\n"]}

package/dist/utils/vscode.js

@@ -47,3 +47,4 @@ export async function openDiffInVSCode(filePath, diffContent) {
         console.error("❌ Error while preparing diff for VS Code:", err);
     }
 }
+//# sourceMappingURL=vscode.js.map

package/dist/utils/vscode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vscode.js","sourceRoot":"","sources":["../../src/utils/vscode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,QAAgB,EAChB,WAAmB;IAEnB,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QAEpE,uBAAuB;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,UAAU,CAAC,CAAC;QAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,UAAU,CAAC,CAAC;QAE9D,0CAA0C;QAC1C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACjC,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACjC,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,wCAAwC;gBACxC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;QACL,CAAC;QAED,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7D,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAE7D,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,MAAM,YAAY,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,MAAM,YAAY,IAAI,CAAC,CAAC;QAEpC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE;YAChE,KAAK,EAAE,SAAS;SACnB,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,OAAO,CAAC,KAAK,CACT,wFAAwF,CAC3F,CAAC;QACN,CAAC,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;IACpE,CAAC;AACL,CAAC","sourcesContent":["import fs from \"fs\";\nimport os from \"os\";\nimport path from \"path\";\nimport { spawn } from \"child_process\";\n\n/**\n * Opens a visual diff in VS Code between the original and modified versions.\n *\n * @param filePath - The path or name of the file being diffed.\n * @param diffContent - The unified diff text for that file.\n */\nexport async function openDiffInVSCode(\n    filePath: string,\n    diffContent: string\n): Promise<void> {\n    try {\n        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), \"scai-diff-\"));\n\n        // Temporary file paths\n        const baseName = path.basename(filePath);\n        const originalPath = path.join(tmpDir, `${baseName}_OLD.tmp`);\n        const modifiedPath = path.join(tmpDir, `${baseName}_NEW.tmp`);\n\n        // Extract file versions from unified diff\n        const oldLines: string[] = [];\n        const newLines: string[] = [];\n\n        for (const line of diffContent.split(\"\\n\")) {\n            if (line.startsWith(\"+\") && !line.startsWith(\"+++\")) {\n                newLines.push(line.slice(1));\n            } else if (line.startsWith(\"-\") && !line.startsWith(\"---\")) {\n                oldLines.push(line.slice(1));\n            } else if (!line.startsWith(\"@@\")) {\n                // context lines appear in both versions\n                oldLines.push(line);\n                newLines.push(line);\n            }\n        }\n\n        fs.writeFileSync(originalPath, oldLines.join(\"\\n\"), \"utf-8\");\n        fs.writeFileSync(modifiedPath, newLines.join(\"\\n\"), \"utf-8\");\n\n        console.log(`\\n🔍 Opening VS Code diff:`);\n        console.log(`   ${originalPath}`);\n        console.log(`⇄  ${modifiedPath}\\n`);\n\n        const child = spawn(\"code\", [\"--diff\", originalPath, modifiedPath], {\n            stdio: \"inherit\",\n        });\n\n        child.on(\"error\", () => {\n            console.error(\n                \"❌ Failed to open diff in VS Code. Ensure the 'code' CLI is installed and in your PATH.\"\n            );\n        });\n    } catch (err) {\n        console.error(\"❌ Error while preparing diff for VS Code:\", err);\n    }\n}\n"]}

package/dist/workflow/workflowResolver.js

@@ -12,3 +12,4 @@ export function resolveModules(goals) {
     const modules = resolveModulesByNames(trimmed);
     return modules;
 }
+//# sourceMappingURL=workflowResolver.js.map

package/dist/workflow/workflowResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowResolver.js","sourceRoot":"","sources":["../../src/workflow/workflowResolver.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAe;IAC1C,2CAA2C;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC;AACnB,CAAC","sourcesContent":["// src/agents/WorkflowResolver.ts\r\nimport { resolveModulesByNames } from \"../pipeline/registry/moduleRegistry.js\";\r\n\r\n/**\r\n * Simple resolver function to compute module order (honours before/after relationships).\r\n * This replaces the previous Workflow class used only to resolve modules.\r\n *\r\n * Returns an array of PromptModuleMeta (the existing shape your registry returns).\r\n */\r\nexport function resolveModules(goals: string[]) {\r\n    // Trim and validate names here (defensive)\r\n    const trimmed = goals.map((g) => (typeof g === \"string\" ? g.trim() : g));\r\n    const modules = resolveModulesByNames(trimmed);\r\n    return modules;\r\n}\r\n"]}

package/dist/workflow/workflowRunner.js

@@ -101,3 +101,4 @@ export async function runWorkflow(opts) {
         throw err;
     }
 }
+//# sourceMappingURL=workflowRunner.js.map

package/dist/workflow/workflowRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowRunner.js","sourceRoot":"","sources":["../../src/workflow/workflowRunner.ts"],"names":[],"mappings":"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","sourcesContent":["// File: src/workflow/workflowRunner.ts\r\nimport fs from \"fs/promises\";\r\nimport chalk from \"chalk\";\r\nimport { normalizePath } from \"../utils/contentUtils.js\";\r\nimport type { Module, ModuleIO } from \"../types.js\";\r\n\r\n/**\r\n * runWorkflow - orchestrates running a modular I/O pipeline.\r\n *\r\n * Each module conforms to the `ModuleIO` interface:\r\n *   input:  { query, content? }\r\n *   output: { data?, mode?, newFilepath? }\r\n *\r\n * Options:\r\n *  - modules: ordered modules to run (Module[])\r\n *  - filepath: optional file path to read/write\r\n *  - inputContent: optional string for stdin content\r\n *\r\n * Behaviours:\r\n *  - Sequentially runs each module on the full file content\r\n *  - Supports output modes: overwrite, append, newFile, skip\r\n *  - Stream mode (no filepath): prints final output to stdout\r\n */\r\nexport async function runWorkflow(opts: {\r\n  modules: Module[];\r\n  goals?: string[];\r\n  filepath?: string;\r\n  inputContent?: string;\r\n}) {\r\n  const { modules } = opts;\r\n  let filepath = opts.filepath;\r\n  let fileContent = \"\";\r\n\r\n  try {\r\n    if (filepath) {\r\n      filepath = normalizePath(filepath);\r\n      await fs.access(filepath);\r\n      fileContent = await fs.readFile(filepath, \"utf-8\");\r\n    } else {\r\n      fileContent = opts.inputContent ?? \"\";\r\n    }\r\n\r\n    for (const mod of modules) {\r\n      console.log(chalk.cyan(`\\n⚙️ Running module: ${mod.name}`));\r\n\r\n      const io: ModuleIO = {\r\n        query: `Process ${filepath ?? \"<stdin>\"} with ${mod.name}`,\r\n        content: fileContent,\r\n      };\r\n\r\n      const result = await mod.run(io);\r\n\r\n      if (!result || !result.data || !String(result.data).trim()) {\r\n        throw new Error(`⚠️ Empty result from module ${mod.name}`);\r\n      }\r\n\r\n      const output =\r\n        typeof result.data === \"string\"\r\n          ? result.data\r\n          : JSON.stringify(result.data, null, 2);\r\n\r\n      const mode =\r\n        (result as any).mode ??\r\n        \"overwrite\"; // default mode if not specified by module\r\n      const newFilepath = (result as any).newFilepath;\r\n\r\n      //\r\n      // === Handle stdout vs file modes ===\r\n      //\r\n      if (!filepath) {\r\n        // stdin mode: print directly to stdout\r\n        process.stdout.write(output);\r\n        fileContent = output;\r\n        continue;\r\n      }\r\n\r\n      //\r\n      // === File-backed mode handling (honor mode semantics) ===\r\n      //\r\n      switch (mode) {\r\n        case \"overwrite\":\r\n          await fs.writeFile(filepath, output, \"utf-8\");\r\n          console.log(chalk.green(`✅ Overwritten: ${filepath}`));\r\n          fileContent = output;\r\n          break;\r\n\r\n        case \"append\":\r\n          await fs.appendFile(filepath, output, \"utf-8\");\r\n          console.log(chalk.green(`✅ Appended: ${filepath}`));\r\n          fileContent += output;\r\n          break;\r\n\r\n        case \"newFile\":\r\n          if (!newFilepath)\r\n            throw new Error(`newFile mode requires a newFilepath`);\r\n          const resolvedNew = normalizePath(newFilepath);\r\n          await fs.writeFile(resolvedNew, output, \"utf-8\");\r\n          console.log(chalk.green(`✅ New file created: ${resolvedNew}`));\r\n          filepath = resolvedNew;\r\n          fileContent = output;\r\n          break;\r\n\r\n        case \"skip\":\r\n          console.log(chalk.gray(`⏭️ Skipped writing for module ${mod.name}`));\r\n          fileContent = output;\r\n          break;\r\n\r\n        default:\r\n          console.log(\r\n            chalk.yellow(`⚠️ Unknown mode (${String(mode)}). Treating as overwrite.`)\r\n          );\r\n          await fs.writeFile(filepath, output, \"utf-8\");\r\n          fileContent = output;\r\n          break;\r\n      }\r\n    }\r\n\r\n    // Final stdout flush if running without filepath\r\n    if (!opts.filepath) {\r\n      process.stdout.write(\"\\n\");\r\n    }\r\n  } catch (err: any) {\r\n    console.error(chalk.red(\"❌ Error in workflow run:\"), err?.message ?? err);\r\n    throw err;\r\n  }\r\n}"]}