scai 0.1.178 → 1.0.0

package/dist/utils/loadRelevantFolderCapsules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadRelevantFolderCapsules.js","sourceRoot":"","sources":["../../src/utils/loadRelevantFolderCapsules.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,UAAU,0BAA0B,CACxC,KAAe,EACf,OAA2D;IAE3D,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;IAC1B,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7F,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChG,MAAM,WAAW,GAAG,CAAC,SAAiB,EAAE,EAAE;QACxC,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,IAAI,CAAC,aAAa,IAAI,YAAY,KAAK,aAAa;YAAE,OAAO,UAAU,CAAC;QACzF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAC1D,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,UAAU,CAAC;QAC9D,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,CAAC,SAAiB,EAAE,EAAE;QACxC,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,IAAI,CAAC,aAAa,IAAI,YAAY,KAAK,aAAa;YAAE,OAAO,UAAU,CAAC;QACzF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACzD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,UAAU,CAAC;QAC9D,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC;IACF,MAAM,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAE9C,qBAAqB;IACrB,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM;QAClC,CAAC,CAAC,EAAE,CAAC,OAAO,CACR,2DAA2D,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CACtG,CAAC,GAAG,CAAC,GAAG,cAAc,CAA+B;QACxD,CAAC,CAAC,EAAE,CAAC;IAEP,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAkB,CAAC;YACxD,QAAQ,CAAC,IAAI,CAAC;gBACZ,GAAG,CAAC;gBACJ,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;gBACzB,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;oBAC3C,GAAG,OAAO;oBACV,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;iBAChC,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,SAAS;QAEhC,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACrD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACvB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEpB,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC;YAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM;YAC1B,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE;YAC1C,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,KAAK;iBACZ,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,mCAAmC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;iBACxD,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;YACtE,YAAY,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;YAC7C,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,8BAA8B;IAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,GAAG;YACT,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;YACnC,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,EAAE;YACZ,YAAY,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;YAC7C,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["// src/utils/loadRelevantFolderCapsules.ts\nimport { getDbForRepo } from '../db/client.js';\nimport path from 'path';\nimport type { FolderCapsule } from '../types.js';\nimport fs from 'fs';\nimport { normalizePath } from './contentUtils.js';\n\nexport function loadRelevantFolderCapsules(\n  paths: string[],\n  options?: { repoRootPath?: string; executionPath?: string }\n): FolderCapsule[] {\n  const db = getDbForRepo();\n  const capsules: FolderCapsule[] = [];\n  const repoRootPath = options?.repoRootPath ? normalizePath(options.repoRootPath) : undefined;\n  const executionPath = options?.executionPath ? normalizePath(options.executionPath) : undefined;\n  const toCanonical = (inputPath: string) => {\n    const normalized = normalizePath(inputPath);\n    if (!repoRootPath || !executionPath || repoRootPath === executionPath) return normalized;\n    const relative = path.relative(executionPath, normalized);\n    if (!relative || relative.startsWith(\"..\")) return normalized;\n    return normalizePath(path.join(repoRootPath, relative));\n  };\n  const toExecution = (inputPath: string) => {\n    const normalized = normalizePath(inputPath);\n    if (!repoRootPath || !executionPath || repoRootPath === executionPath) return normalized;\n    const relative = path.relative(repoRootPath, normalized);\n    if (!relative || relative.startsWith(\"..\")) return normalized;\n    return normalizePath(path.join(executionPath, relative));\n  };\n  const canonicalPaths = paths.map(toCanonical);\n\n  // 1️⃣ Query DB first\n  const dbRows = canonicalPaths.length\n    ? db.prepare(\n        `SELECT capsule_json FROM folder_capsules WHERE path IN (${canonicalPaths.map(() => '?').join(',')})`\n      ).all(...canonicalPaths) as { capsule_json: string }[]\n    : [];\n\n  for (const row of dbRows) {\n    try {\n      const c = JSON.parse(row.capsule_json) as FolderCapsule;\n      capsules.push({\n        ...c,\n        path: toExecution(c.path),\n        keyFiles: (c.keyFiles ?? []).map(keyFile => ({\n          ...keyFile,\n          path: toExecution(keyFile.path),\n        })),\n      });\n    } catch {\n      // skip malformed JSON\n    }\n  }\n\n  // 2️⃣ Generate ephemeral capsules for missing paths\n  const existingPaths = new Set(capsules.map(c => c.path));\n  for (const p of paths) {\n    if (existingPaths.has(p)) continue;\n    if (!fs.existsSync(p)) continue;\n\n    const files = fs.readdirSync(p, { withFileTypes: true })\n      .filter(f => f.isFile())\n      .map(f => f.name);\n\n    const byType: Record<string, number> = {};\n    for (const f of files) {\n      const ext = path.extname(f).replace('.', '') || 'unknown';\n      byType[ext] = (byType[ext] || 0) + 1;\n    }\n\n    capsules.push({\n      path: p,\n      depth: p.split('/').length,\n      stats: { fileCount: files.length, byType },\n      roles: [],\n      concerns: [],\n      keyFiles: files\n        .filter(f => /index|main|cli|app|server|config/i.test(f))\n        .slice(0, 5)\n        .map(f => ({ path: path.join(p, f), reason: 'heuristic key file' })),\n      dependencies: { importsFrom: [], usedBy: [] },\n      confidence: 0.35,\n    });\n  }\n\n  // 3️⃣ Always add root capsule\n  if (!capsules.some(c => c.path === '/')) {\n    capsules.push({\n      path: '/',\n      depth: 1,\n      stats: { fileCount: 0, byType: {} },\n      roles: [],\n      concerns: [],\n      keyFiles: [],\n      dependencies: { importsFrom: [], usedBy: [] },\n      confidence: 0.5,\n    });\n  }\n\n  return capsules;\n}\n"]}

package/dist/utils/log.js

@@ -1,9 +1,17 @@
+/**
+ * Prints or appends small debug log lines with local machine timestamps.
+ *
+ * Why this file exists:
+ * - fallback diagnostics should use the same local-time policy as runtime logs
+ * - background and foreground debug output should stay consistent
+ */
 import { LOG_PATH } from "../constants.js";
 import fs from 'fs';
+import { nowLocalIso } from "./time.js";
 export const DEBUG = false;
 export const SUMMARY_LENGTH = 120;
 export function log(...args) {
-    const timestamp = new Date().toISOString();
+    const timestamp = nowLocalIso();
     const message = args.map(arg => typeof arg === 'string' ? arg : JSON.stringify(arg, null, 2)).join(' ');
     const isBackground = process.env.BACKGROUND_MODE === 'true';
     if (isBackground) {
@@ -15,3 +23,4 @@ export function log(...args) {
         console.log(`[${timestamp}] ${message}`);
     }
 }
+//# sourceMappingURL=log.js.map

package/dist/utils/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/utils/log.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC;AAC3B,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,MAAM,UAAU,GAAG,CAAC,GAAG,IAAe;IACpC,MAAM,SAAS,GAAG,WAAW,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAC7B,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAC7D,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEZ,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM,CAAC;IAE5D,IAAI,YAAY,EAAE,CAAC;QACjB,0CAA0C;QAC1C,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,SAAS,KAAK,OAAO,IAAI,CAAC,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,gCAAgC;QAChC,OAAO,CAAC,GAAG,CAAC,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC","sourcesContent":["/**\n * Prints or appends small debug log lines with local machine timestamps.\n *\n * Why this file exists:\n * - fallback diagnostics should use the same local-time policy as runtime logs\n * - background and foreground debug output should stay consistent\n */\nimport { LOG_PATH } from \"../constants.js\";\nimport fs from 'fs';\nimport { nowLocalIso } from \"./time.js\";\n\r\nexport const DEBUG = false;\nexport const SUMMARY_LENGTH = 120;\n\nexport function log(...args: unknown[]) {\n  const timestamp = nowLocalIso();\n  const message = args.map(arg =>\r\n    typeof arg === 'string' ? arg : JSON.stringify(arg, null, 2)\r\n  ).join(' ');\r\n\r\n  const isBackground = process.env.BACKGROUND_MODE === 'true';\r\n\r\n  if (isBackground) {\r\n    // If running in background, log to a file\r\n    fs.appendFileSync(LOG_PATH, `[${timestamp}] ${message}\\n`);\r\n  } else {\r\n    // Otherwise, log to the console\r\n    console.log(`[${timestamp}] ${message}`);\r\n  }\r\n}\r\n"]}

package/dist/utils/normalizeData.js

@@ -21,3 +21,4 @@ export function normalizeData(data) {
     }
     return {};
 }
+//# sourceMappingURL=normalizeData.js.map

package/dist/utils/normalizeData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeData.js","sourceRoot":"","sources":["../../src/utils/normalizeData.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,MAAM,UAAU,aAAa,CAAU,IAAiC;IACpE,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,EAAO,CAAC;IAEjC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAS,CAAC;IAE/C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACL,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;IACL,CAAC;IAED,OAAO,EAAO,CAAC;AACnB,CAAC","sourcesContent":["/**\n * normalizeData ensures that ModuleIO.data is always returned as a usable object.\n *\n * Modules may output either a JSON string or a structured object. This helper\n * converts JSON strings into objects, passes objects through unchanged, and\n * provides a safe fallback for null/undefined. It centralizes the parsing logic\n * so individual modules don’t need to guess the data format.\n */\n\n\nexport function normalizeData<T = any>(data: string | object | undefined): T {\n    if (data == null) return {} as T;\n\n    if (typeof data === \"object\") return data as T;\n\n    if (typeof data === \"string\") {\n        try {\n            return JSON.parse(data) as T;\n        } catch {\n            throw new Error(\"Invalid JSON string in ModuleIO.data\");\n        }\n    }\n\n    return {} as T;\n}\n"]}

package/dist/utils/ollamaModelStatus.js

@@ -0,0 +1,28 @@
+/**
+ * Checks local Ollama model availability without changing runtime state.
+ *
+ * Why this file exists:
+ * - setup validation and status output both need one model-installed check
+ * - the check should stay read-only and free of console formatting
+ * - Ollama list parsing should not drift across commands
+ */
+import { execFileSync } from "child_process";
+/**
+ * Returns true when `ollama list` contains the requested model name.
+ * Example: "qwen3-coder:30b" -> true when Ollama lists that exact model.
+ */
+export function isModelInstalled(model) {
+    try {
+        const output = execFileSync("ollama", ["list"], { encoding: "utf-8" });
+        const normalizedModel = model.trim().toLowerCase();
+        return output
+            .split("\n")
+            .map((line) => line.trim().toLowerCase())
+            .filter(Boolean)
+            .some((line) => line === normalizedModel || line.startsWith(`${normalizedModel} `));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=ollamaModelStatus.js.map

package/dist/utils/ollamaModelStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollamaModelStatus.js","sourceRoot":"","sources":["../../src/utils/ollamaModelStatus.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAEnD,OAAO,MAAM;aACV,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;aACxC,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CACH,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,eAAe,GAAG,CAAC,CACrE,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC","sourcesContent":["/**\n * Checks local Ollama model availability without changing runtime state.\n *\n * Why this file exists:\n * - setup validation and status output both need one model-installed check\n * - the check should stay read-only and free of console formatting\n * - Ollama list parsing should not drift across commands\n */\nimport { execFileSync } from \"child_process\";\n\n/**\n * Returns true when `ollama list` contains the requested model name.\n * Example: \"qwen3-coder:30b\" -> true when Ollama lists that exact model.\n */\nexport function isModelInstalled(model: string): boolean {\n  try {\n    const output = execFileSync(\"ollama\", [\"list\"], { encoding: \"utf-8\" });\n    const normalizedModel = model.trim().toLowerCase();\n\n    return output\n      .split(\"\\n\")\n      .map((line) => line.trim().toLowerCase())\n      .filter(Boolean)\n      .some(\n        (line) =>\n          line === normalizedModel || line.startsWith(`${normalizedModel} `)\n      );\n  } catch {\n    return false;\n  }\n}\n"]}

package/dist/utils/ollamaService.js

@@ -0,0 +1,294 @@
+/**
+ * Wraps low-level Ollama service endpoints and local server lifecycle helpers.
+ *
+ * Why this file exists:
+ * - Ollama URLs should be shared instead of repeated across commands
+ * - health, status, and restart behavior should stay in one service boundary
+ * - model gateway code should depend on a small stable API
+ */
+import { execFileSync, spawn } from 'node:child_process';
+import { platform as getPlatform } from 'node:os';
+export const OLLAMA_BASE_URL = 'http://127.0.0.1:11434/';
+export const OLLAMA_CHAT_URL = `${OLLAMA_BASE_URL}api/chat`;
+export const OLLAMA_GENERATE_URL = `${OLLAMA_BASE_URL}api/generate`;
+export const OLLAMA_HEALTH_TIMEOUT_MS = 1500;
+export const OLLAMA_READY_TIMEOUT_MS = 30000;
+const DEFAULT_FETCH = (...args) => fetch(...args);
+export async function probeOllamaHealth(opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? OLLAMA_HEALTH_TIMEOUT_MS;
+    const fetchImpl = opts.fetchImpl ?? DEFAULT_FETCH;
+    try {
+        const res = await fetchImpl(OLLAMA_BASE_URL, {
+            method: 'GET',
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (res.ok) {
+            return { ok: true, status: 'healthy', detail: 'Ollama responded to the health probe.' };
+        }
+        return {
+            ok: false,
+            status: 'error',
+            detail: `Ollama returned HTTP ${res.status} to the health probe.`,
+        };
+    }
+    catch (err) {
+        if (err?.name === 'TimeoutError' || err?.name === 'AbortError') {
+            return { ok: false, status: 'timeout', detail: 'Ollama did not answer the health probe in time.' };
+        }
+        return { ok: false, status: 'unreachable', detail: 'Ollama could not be reached on port 11434.' };
+    }
+}
+export async function waitForOllamaReady(opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? OLLAMA_READY_TIMEOUT_MS;
+    const fetchImpl = opts.fetchImpl ?? DEFAULT_FETCH;
+    const sleepImpl = opts.sleepImpl ?? sleep;
+    const start = Date.now();
+    let lastHealth = {
+        ok: false,
+        status: 'unreachable',
+        detail: 'Ollama could not be reached on port 11434.',
+    };
+    while (Date.now() - start < timeoutMs) {
+        lastHealth = await probeOllamaHealth({ fetchImpl });
+        if (lastHealth.ok) {
+            return lastHealth;
+        }
+        await sleepImpl(300);
+    }
+    return lastHealth.status === 'timeout'
+        ? lastHealth
+        : { ok: false, status: 'timeout', detail: `Ollama did not become ready within ${timeoutMs}ms.` };
+}
+export async function fetchOllamaVersion(fetchImpl = DEFAULT_FETCH) {
+    try {
+        const res = await fetchImpl(`${OLLAMA_BASE_URL}api/version`, {
+            signal: AbortSignal.timeout(OLLAMA_HEALTH_TIMEOUT_MS),
+        });
+        if (!res.ok)
+            return undefined;
+        const json = await res.json();
+        return typeof json.version === 'string' ? json.version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function getRunningModels(fetchImpl = DEFAULT_FETCH) {
+    try {
+        const res = await fetchImpl(`${OLLAMA_BASE_URL}api/ps`, {
+            signal: AbortSignal.timeout(OLLAMA_HEALTH_TIMEOUT_MS),
+        });
+        if (!res.ok)
+            return [];
+        const json = await res.json();
+        return Array.isArray(json.models) ? json.models : [];
+    }
+    catch {
+        return [];
+    }
+}
+export async function unloadOllamaModelIfRunning(model, fetchImpl = DEFAULT_FETCH) {
+    const normalizedModel = model.trim().toLowerCase();
+    if (!normalizedModel) {
+        return { ok: true, unloaded: false, skipped: true, detail: 'No model name was provided.' };
+    }
+    const runningModels = await getRunningModels(fetchImpl);
+    const matchingModel = runningModels.find((entry) => entry.name.trim().toLowerCase() === normalizedModel);
+    if (!matchingModel) {
+        return {
+            ok: true,
+            unloaded: false,
+            skipped: true,
+            detail: `Model '${model}' is not loaded in Ollama.`,
+        };
+    }
+    try {
+        const response = await fetchImpl(OLLAMA_GENERATE_URL, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model: matchingModel.name,
+                keep_alive: 0,
+            }),
+            signal: AbortSignal.timeout(OLLAMA_HEALTH_TIMEOUT_MS),
+        });
+        if (!response.ok) {
+            return {
+                ok: false,
+                unloaded: false,
+                skipped: false,
+                detail: `Ollama returned HTTP ${response.status} while unloading '${matchingModel.name}'.`,
+            };
+        }
+        return {
+            ok: true,
+            unloaded: true,
+            skipped: false,
+            detail: `Model '${matchingModel.name}' was unloaded from Ollama.`,
+        };
+    }
+    catch (err) {
+        if (err?.name === 'TimeoutError' || err?.name === 'AbortError') {
+            return {
+                ok: false,
+                unloaded: false,
+                skipped: false,
+                detail: `Timed out while unloading '${matchingModel.name}'.`,
+            };
+        }
+        return {
+            ok: false,
+            unloaded: false,
+            skipped: false,
+            detail: `Failed to unload '${matchingModel.name}' from Ollama.`,
+        };
+    }
+}
+export async function getOllamaStatusSnapshot(fetchImpl = DEFAULT_FETCH) {
+    const health = await probeOllamaHealth({ fetchImpl });
+    if (!health.ok) {
+        return { health, runningModels: [] };
+    }
+    const [version, runningModels] = await Promise.all([
+        fetchOllamaVersion(fetchImpl),
+        getRunningModels(fetchImpl),
+    ]);
+    return { health, version, runningModels };
+}
+export async function startOllamaServer() {
+    const candidates = getOllamaStartCandidates();
+    let lastError;
+    for (const candidate of candidates) {
+        const result = await spawnDetached(candidate.command, candidate.args);
+        if (result.ok) {
+            return { ok: true, command: [candidate.command, ...candidate.args].join(' '), reason: 'spawned' };
+        }
+        lastError = result.error;
+        if (result.reason !== 'not_found') {
+            return { ok: false, command: [candidate.command, ...candidate.args].join(' '), reason: 'error', error: result.error };
+        }
+    }
+    return { ok: false, reason: 'not_found', error: lastError };
+}
+export async function stopOllamaServer() {
+    const platform = getPlatform();
+    if (platform === 'win32') {
+        try {
+            execFileSync('taskkill', ['/IM', 'ollama.exe', '/F'], { stdio: 'ignore' });
+        }
+        catch {
+            return;
+        }
+        return;
+    }
+    const patterns = [
+        'ollama serve',
+        '/Applications/Ollama.app/Contents/Resources/ollama',
+    ];
+    for (const pattern of patterns) {
+        try {
+            execFileSync('pkill', ['-f', pattern], { stdio: 'ignore' });
+        }
+        catch {
+            continue;
+        }
+    }
+}
+export async function restartOllamaServer(opts = {}) {
+    await stopOllamaServer();
+    const sleepImpl = opts.sleepImpl ?? sleep;
+    await sleepImpl(500);
+    const startResult = await startOllamaServer();
+    if (!startResult.ok) {
+        return {
+            restarted: false,
+            ready: false,
+            health: { ok: false, status: 'unreachable', detail: 'SCAI could not start the Ollama server.' },
+            startResult,
+        };
+    }
+    const health = await waitForOllamaReady({ fetchImpl: opts.fetchImpl, sleepImpl });
+    return {
+        restarted: true,
+        ready: health.ok,
+        health,
+        startResult,
+    };
+}
+export function formatOllamaStatusMessage(snapshot) {
+    const lines = [];
+    if (!snapshot.health.ok) {
+        lines.push(`❌ Ollama unhealthy: ${snapshot.health.detail}`);
+        lines.push('   Run `scai model restart` to restart the Ollama server.');
+        return lines;
+    }
+    const loadedCount = snapshot.runningModels.length;
+    if (loadedCount > 0) {
+        lines.push(`✅ Ollama ready (${loadedCount} model${loadedCount === 1 ? '' : 's'} loaded)`);
+    }
+    else {
+        lines.push('✅ Ollama ready (service up, no models loaded yet)');
+    }
+    if (snapshot.version) {
+        lines.push(`🦙 Ollama version: ${snapshot.version}`);
+    }
+    if (loadedCount > 0) {
+        lines.push('🔥 Running models:');
+        for (const model of snapshot.runningModels) {
+            const sizeGB = (model.size / 1024 ** 3).toFixed(1);
+            lines.push(`  • ${model.name}` +
+                ` | ${model.details?.parameter_size ?? '??'} params` +
+                ` | q=${model.details?.quantization_level ?? '?'}` +
+                ` | ~${sizeGB} GB in RAM`);
+        }
+    }
+    return lines;
+}
+async function spawnDetached(command, args) {
+    return await new Promise((resolve) => {
+        try {
+            const child = spawn(command, args, {
+                detached: true,
+                stdio: 'ignore',
+                windowsHide: true,
+            });
+            let settled = false;
+            const finish = (result) => {
+                if (settled)
+                    return;
+                settled = true;
+                resolve(result);
+            };
+            child.once('error', (err) => {
+                finish({
+                    ok: false,
+                    reason: err?.code === 'ENOENT' ? 'not_found' : 'error',
+                    error: err,
+                });
+            });
+            child.unref();
+            setTimeout(() => finish({ ok: true, reason: 'spawned' }), 200);
+        }
+        catch (err) {
+            resolve({
+                ok: false,
+                reason: err?.code === 'ENOENT' ? 'not_found' : 'error',
+                error: err,
+            });
+        }
+    });
+}
+function getOllamaStartCandidates() {
+    const candidates = [{ command: 'ollama', args: ['serve'] }];
+    if (getPlatform() === 'darwin') {
+        candidates.push({
+            command: '/Applications/Ollama.app/Contents/Resources/ollama',
+            args: ['serve'],
+        });
+    }
+    return candidates;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=ollamaService.js.map

package/dist/utils/ollamaService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollamaService.js","sourceRoot":"","sources":["../../src/utils/ollamaService.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Wraps low-level Ollama service endpoints and local server lifecycle helpers.\n *\n * Why this file exists:\n * - Ollama URLs should be shared instead of repeated across commands\n * - health, status, and restart behavior should stay in one service boundary\n * - model gateway code should depend on a small stable API\n */\nimport { execFileSync, spawn } from 'node:child_process';\nimport { platform as getPlatform } from 'node:os';\n\nexport const OLLAMA_BASE_URL = 'http://127.0.0.1:11434/';\nexport const OLLAMA_CHAT_URL = `${OLLAMA_BASE_URL}api/chat`;\nexport const OLLAMA_GENERATE_URL = `${OLLAMA_BASE_URL}api/generate`;\nexport const OLLAMA_HEALTH_TIMEOUT_MS = 1500;\nexport const OLLAMA_READY_TIMEOUT_MS = 30000;\n\nexport type OllamaHealthStatus = 'healthy' | 'unreachable' | 'timeout' | 'error';\n\nexport type OllamaHealthResult = {\n  ok: boolean;\n  status: OllamaHealthStatus;\n  detail: string;\n};\n\nexport type OllamaModel = {\n  name: string;\n  size: number;\n  modified_at: string;\n  details?: {\n    format?: string;\n    family?: string;\n    parameter_size?: string;\n    quantization_level?: string;\n  };\n};\n\nexport type OllamaStatusSnapshot = {\n  health: OllamaHealthResult;\n  version?: string;\n  runningModels: OllamaModel[];\n};\n\nexport type OllamaStartResult = {\n  ok: boolean;\n  command?: string;\n  reason: 'spawned' | 'not_found' | 'error';\n  error?: unknown;\n};\n\nexport type OllamaUnloadResult =\n  | { ok: true; unloaded: true; skipped: false; detail: string }\n  | { ok: true; unloaded: false; skipped: true; detail: string }\n  | { ok: false; unloaded: false; skipped: false; detail: string };\n\ntype FetchLike = typeof fetch;\n\nconst DEFAULT_FETCH: FetchLike = (...args) => fetch(...args);\n\nexport async function probeOllamaHealth(\n  opts: { timeoutMs?: number; fetchImpl?: FetchLike } = {}\n): Promise<OllamaHealthResult> {\n  const timeoutMs = opts.timeoutMs ?? OLLAMA_HEALTH_TIMEOUT_MS;\n  const fetchImpl = opts.fetchImpl ?? DEFAULT_FETCH;\n\n  try {\n    const res = await fetchImpl(OLLAMA_BASE_URL, {\n      method: 'GET',\n      signal: AbortSignal.timeout(timeoutMs),\n    });\n\n    if (res.ok) {\n      return { ok: true, status: 'healthy', detail: 'Ollama responded to the health probe.' };\n    }\n\n    return {\n      ok: false,\n      status: 'error',\n      detail: `Ollama returned HTTP ${res.status} to the health probe.`,\n    };\n  } catch (err: any) {\n    if (err?.name === 'TimeoutError' || err?.name === 'AbortError') {\n      return { ok: false, status: 'timeout', detail: 'Ollama did not answer the health probe in time.' };\n    }\n\n    return { ok: false, status: 'unreachable', detail: 'Ollama could not be reached on port 11434.' };\n  }\n}\n\nexport async function waitForOllamaReady(\n  opts: { timeoutMs?: number; fetchImpl?: FetchLike; sleepImpl?: (ms: number) => Promise<void> } = {}\n): Promise<OllamaHealthResult> {\n  const timeoutMs = opts.timeoutMs ?? OLLAMA_READY_TIMEOUT_MS;\n  const fetchImpl = opts.fetchImpl ?? DEFAULT_FETCH;\n  const sleepImpl = opts.sleepImpl ?? sleep;\n  const start = Date.now();\n  let lastHealth: OllamaHealthResult = {\n    ok: false,\n    status: 'unreachable',\n    detail: 'Ollama could not be reached on port 11434.',\n  };\n\n  while (Date.now() - start < timeoutMs) {\n    lastHealth = await probeOllamaHealth({ fetchImpl });\n    if (lastHealth.ok) {\n      return lastHealth;\n    }\n    await sleepImpl(300);\n  }\n\n  return lastHealth.status === 'timeout'\n    ? lastHealth\n    : { ok: false, status: 'timeout', detail: `Ollama did not become ready within ${timeoutMs}ms.` };\n}\n\nexport async function fetchOllamaVersion(fetchImpl: FetchLike = DEFAULT_FETCH): Promise<string | undefined> {\n  try {\n    const res = await fetchImpl(`${OLLAMA_BASE_URL}api/version`, {\n      signal: AbortSignal.timeout(OLLAMA_HEALTH_TIMEOUT_MS),\n    });\n    if (!res.ok) return undefined;\n    const json = await res.json();\n    return typeof json.version === 'string' ? json.version : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport async function getRunningModels(fetchImpl: FetchLike = DEFAULT_FETCH): Promise<OllamaModel[]> {\n  try {\n    const res = await fetchImpl(`${OLLAMA_BASE_URL}api/ps`, {\n      signal: AbortSignal.timeout(OLLAMA_HEALTH_TIMEOUT_MS),\n    });\n    if (!res.ok) return [];\n    const json = await res.json();\n    return Array.isArray(json.models) ? (json.models as OllamaModel[]) : [];\n  } catch {\n    return [];\n  }\n}\n\nexport async function unloadOllamaModelIfRunning(\n  model: string,\n  fetchImpl: FetchLike = DEFAULT_FETCH\n): Promise<OllamaUnloadResult> {\n  const normalizedModel = model.trim().toLowerCase();\n  if (!normalizedModel) {\n    return { ok: true, unloaded: false, skipped: true, detail: 'No model name was provided.' };\n  }\n\n  const runningModels = await getRunningModels(fetchImpl);\n  const matchingModel = runningModels.find(\n    (entry) => entry.name.trim().toLowerCase() === normalizedModel\n  );\n\n  if (!matchingModel) {\n    return {\n      ok: true,\n      unloaded: false,\n      skipped: true,\n      detail: `Model '${model}' is not loaded in Ollama.`,\n    };\n  }\n\n  try {\n    const response = await fetchImpl(OLLAMA_GENERATE_URL, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({\n        model: matchingModel.name,\n        keep_alive: 0,\n      }),\n      signal: AbortSignal.timeout(OLLAMA_HEALTH_TIMEOUT_MS),\n    });\n\n    if (!response.ok) {\n      return {\n        ok: false,\n        unloaded: false,\n        skipped: false,\n        detail: `Ollama returned HTTP ${response.status} while unloading '${matchingModel.name}'.`,\n      };\n    }\n\n    return {\n      ok: true,\n      unloaded: true,\n      skipped: false,\n      detail: `Model '${matchingModel.name}' was unloaded from Ollama.`,\n    };\n  } catch (err: any) {\n    if (err?.name === 'TimeoutError' || err?.name === 'AbortError') {\n      return {\n        ok: false,\n        unloaded: false,\n        skipped: false,\n        detail: `Timed out while unloading '${matchingModel.name}'.`,\n      };\n    }\n\n    return {\n      ok: false,\n      unloaded: false,\n      skipped: false,\n      detail: `Failed to unload '${matchingModel.name}' from Ollama.`,\n    };\n  }\n}\n\nexport async function getOllamaStatusSnapshot(fetchImpl: FetchLike = DEFAULT_FETCH): Promise<OllamaStatusSnapshot> {\n  const health = await probeOllamaHealth({ fetchImpl });\n  if (!health.ok) {\n    return { health, runningModels: [] };\n  }\n\n  const [version, runningModels] = await Promise.all([\n    fetchOllamaVersion(fetchImpl),\n    getRunningModels(fetchImpl),\n  ]);\n\n  return { health, version, runningModels };\n}\n\nexport async function startOllamaServer(): Promise<OllamaStartResult> {\n  const candidates = getOllamaStartCandidates();\n  let lastError: unknown;\n\n  for (const candidate of candidates) {\n    const result = await spawnDetached(candidate.command, candidate.args);\n    if (result.ok) {\n      return { ok: true, command: [candidate.command, ...candidate.args].join(' '), reason: 'spawned' };\n    }\n    lastError = result.error;\n    if (result.reason !== 'not_found') {\n      return { ok: false, command: [candidate.command, ...candidate.args].join(' '), reason: 'error', error: result.error };\n    }\n  }\n\n  return { ok: false, reason: 'not_found', error: lastError };\n}\n\nexport async function stopOllamaServer(): Promise<void> {\n  const platform = getPlatform();\n\n  if (platform === 'win32') {\n    try {\n      execFileSync('taskkill', ['/IM', 'ollama.exe', '/F'], { stdio: 'ignore' });\n    } catch {\n      return;\n    }\n    return;\n  }\n\n  const patterns = [\n    'ollama serve',\n    '/Applications/Ollama.app/Contents/Resources/ollama',\n  ];\n\n  for (const pattern of patterns) {\n    try {\n      execFileSync('pkill', ['-f', pattern], { stdio: 'ignore' });\n    } catch {\n      continue;\n    }\n  }\n}\n\nexport async function restartOllamaServer(\n  opts: { fetchImpl?: FetchLike; sleepImpl?: (ms: number) => Promise<void> } = {}\n): Promise<{ restarted: boolean; ready: boolean; health: OllamaHealthResult; startResult: OllamaStartResult }> {\n  await stopOllamaServer();\n  const sleepImpl = opts.sleepImpl ?? sleep;\n  await sleepImpl(500);\n\n  const startResult = await startOllamaServer();\n  if (!startResult.ok) {\n    return {\n      restarted: false,\n      ready: false,\n      health: { ok: false, status: 'unreachable', detail: 'SCAI could not start the Ollama server.' },\n      startResult,\n    };\n  }\n\n  const health = await waitForOllamaReady({ fetchImpl: opts.fetchImpl, sleepImpl });\n  return {\n    restarted: true,\n    ready: health.ok,\n    health,\n    startResult,\n  };\n}\n\nexport function formatOllamaStatusMessage(snapshot: OllamaStatusSnapshot): string[] {\n  const lines: string[] = [];\n\n  if (!snapshot.health.ok) {\n    lines.push(`❌ Ollama unhealthy: ${snapshot.health.detail}`);\n    lines.push('   Run `scai model restart` to restart the Ollama server.');\n    return lines;\n  }\n\n  const loadedCount = snapshot.runningModels.length;\n  if (loadedCount > 0) {\n    lines.push(`✅ Ollama ready (${loadedCount} model${loadedCount === 1 ? '' : 's'} loaded)`);\n  } else {\n    lines.push('✅ Ollama ready (service up, no models loaded yet)');\n  }\n\n  if (snapshot.version) {\n    lines.push(`🦙 Ollama version: ${snapshot.version}`);\n  }\n\n  if (loadedCount > 0) {\n    lines.push('🔥 Running models:');\n    for (const model of snapshot.runningModels) {\n      const sizeGB = (model.size / 1024 ** 3).toFixed(1);\n      lines.push(\n        `  • ${model.name}` +\n        ` | ${model.details?.parameter_size ?? '??'} params` +\n        ` | q=${model.details?.quantization_level ?? '?'}` +\n        ` | ~${sizeGB} GB in RAM`\n      );\n    }\n  }\n\n  return lines;\n}\n\nasync function spawnDetached(\n  command: string,\n  args: string[]\n): Promise<{ ok: boolean; reason: 'spawned' | 'not_found' | 'error'; error?: unknown }> {\n  return await new Promise((resolve) => {\n    try {\n      const child = spawn(command, args, {\n        detached: true,\n        stdio: 'ignore',\n        windowsHide: true,\n      });\n\n      let settled = false;\n      const finish = (result: { ok: boolean; reason: 'spawned' | 'not_found' | 'error'; error?: unknown }) => {\n        if (settled) return;\n        settled = true;\n        resolve(result);\n      };\n\n      child.once('error', (err: any) => {\n        finish({\n          ok: false,\n          reason: err?.code === 'ENOENT' ? 'not_found' : 'error',\n          error: err,\n        });\n      });\n\n      child.unref();\n      setTimeout(() => finish({ ok: true, reason: 'spawned' }), 200);\n    } catch (err: any) {\n      resolve({\n        ok: false,\n        reason: err?.code === 'ENOENT' ? 'not_found' : 'error',\n        error: err,\n      });\n    }\n  });\n}\n\nfunction getOllamaStartCandidates(): Array<{ command: string; args: string[] }> {\n  const candidates = [{ command: 'ollama', args: ['serve'] }];\n  if (getPlatform() === 'darwin') {\n    candidates.push({\n      command: '/Applications/Ollama.app/Contents/Resources/ollama',\n      args: ['serve'],\n    });\n  }\n  return candidates;\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"]}

package/dist/utils/outputFormatter.js

@@ -51,3 +51,4 @@ export function parseAndStyleSuggestions(text, options = {}) {
         .map((line, idx) => ({ No: (idx + 1).toString(), Suggestion: line }));
     return styleRows(rows, options);
 }
+//# sourceMappingURL=outputFormatter.js.map

package/dist/utils/outputFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputFormatter.js","sourceRoot":"","sources":["../../src/utils/outputFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,IAA8B,EAC9B,UAAyC,EAAE;IAE3C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE1C,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IACnD,MAAM,EAAE,gBAAgB,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAE7C,OAAO,SAAS,CAAC,IAAI,EAAE;QACrB,cAAc,EAAE,IAAI;QACpB,YAAY,EAAE,aAAa;QAC3B,MAAM,EAAE,MAAM,CAAC,WAAW,CACxB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;YAChC,GAAG;YACH,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE;SAC1E,CAAC,CACH;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,UAAyC,EAAE;IAE3C,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IACnD,MAAM,EAAE,gBAAgB,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAAC;IAE9D,6BAA6B;IAC7B,MAAM,OAAO,GAAG,IAAI;SACjB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;YAAE,OAAO,IAAI,CAAC;QAEzC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC;YACjD,KAAK,IAAI,QAAQ,CAAC;QACpB,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAY,EACZ,UAAyC,EAAE;IAE3C,+DAA+D;IAC/D,MAAM,IAAI,GAAG,IAAI;SACd,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAExE,OAAO,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC","sourcesContent":["import columnify from \"columnify\";\r\n\r\n/**\r\n * Format structured rows for terminal output.\r\n */\r\nexport function styleRows(\r\n  rows: Record<string, string>[],\r\n  options: { maxWidthFraction?: number } = {}\r\n): string {\r\n  if (!rows || rows.length === 0) return \"\";\r\n\r\n  const terminalWidth = process.stdout.columns || 80;\r\n  const { maxWidthFraction = 2 / 3 } = options;\r\n\r\n  return columnify(rows, {\r\n    columnSplitter: \"  \",\r\n    maxLineWidth: terminalWidth,\r\n    config: Object.fromEntries(\r\n      Object.keys(rows[0]).map((key) => [\r\n        key,\r\n        { maxWidth: Math.floor(terminalWidth * maxWidthFraction), align: \"left\" },\r\n      ])\r\n    ),\r\n  });\r\n}\r\n\r\n/**\r\n * Format a plain string for terminal output (wraps lines to terminal width).\r\n */\r\nexport function styleText(\r\n  text: string,\r\n  options: { maxWidthFraction?: number } = {}\r\n): string {\r\n  const terminalWidth = process.stdout.columns || 80;\r\n  const { maxWidthFraction = 2 / 3 } = options;\r\n  const maxWidth = Math.floor(terminalWidth * maxWidthFraction);\r\n\r\n  // Wrap each line to maxWidth\r\n  const wrapped = text\r\n    .split(\"\\n\")\r\n    .map((line) => {\r\n      if (line.length <= maxWidth) return line;\r\n\r\n      const chunks: string[] = [];\r\n      let start = 0;\r\n      while (start < line.length) {\r\n        chunks.push(line.slice(start, start + maxWidth));\r\n        start += maxWidth;\r\n      }\r\n      return chunks.join(\"\\n\");\r\n    })\r\n    .join(\"\\n\");\r\n\r\n  return wrapped;\r\n}\r\n\r\n/**\r\n * Parse numbered suggestions or key-value text into rows for columnify.\r\n */\r\nexport function parseAndStyleSuggestions(\r\n  text: string,\r\n  options: { maxWidthFraction?: number } = {}\r\n): string {\r\n  // Simple parser: each line becomes { No: n, Suggestion: line }\r\n  const rows = text\r\n    .trim()\r\n    .split(\"\\n\")\r\n    .map((line, idx) => ({ No: (idx + 1).toString(), Suggestion: line }));\r\n\r\n  return styleRows(rows, options);\r\n}\r\n"]}

package/dist/utils/parseTaggedContent.js

@@ -25,3 +25,4 @@ export function extractTaggedContent(rawText, tag) {
 function escapeRegex(s) {
     return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
+//# sourceMappingURL=parseTaggedContent.js.map

package/dist/utils/parseTaggedContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseTaggedContent.js","sourceRoot":"","sources":["../../src/utils/parseTaggedContent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAChC,OAAe,EACf,GAAW;IAEX,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAEjC,MAAM,QAAQ,GAAG,IAAI,MAAM,CACvB,IAAI,OAAO,oBAAoB,OAAO,GAAG,EACzC,IAAI,CACP,CAAC;IACF,MAAM,UAAU,GAAG,6BAA6B,CAAC;IAEjD,MAAM,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,YAAY,GAAG,uBAAuB,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,IAAI,GAAG,4BAA4B,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAE7C,OAAO;QACH,OAAO;QACP,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;KAClD,CAAC;AACN,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC1B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC","sourcesContent":["/**\n * Strict helper to extract tagged content.\n * - Requires the tag to be present\n * - Throws on missing or empty content\n * - No markdown fallback\n */\nexport function extractTaggedContent(\n    rawText: string,\n    tag: string\n): { content: string; notes: string | null } {\n    const safeTag = escapeRegex(tag);\n\n    const tagRegex = new RegExp(\n        `<${safeTag}>([\\\\s\\\\S]*?)<\\\\/${safeTag}>`,\n        'gi'\n    );\n    const notesRegex = /<NOTES>([\\s\\S]*?)<\\/NOTES>/i;\n\n    const matches = [...rawText.matchAll(tagRegex)];\n    if (!matches.length) {\n        throw new Error(`Missing <${tag}> tag in LLM response`);\n    }\n\n    const content = matches[matches.length - 1][1].trim();\n    if (!content) {\n        throw new Error(`<${tag}> tag is present but empty`);\n    }\n\n    const notesMatch = rawText.match(notesRegex);\n\n    return {\n        content,\n        notes: notesMatch ? notesMatch[1].trim() : null\n    };\n}\n\nfunction escapeRegex(s: string) {\n    return s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n"]}

package/dist/utils/planActions.js

@@ -1,46 +1,27 @@
-// src/utils/planActions.ts
-export const PLAN_ACTIONS = [
-    // =====================================================
-    // INFORMATION ACQUISITION PHASE
-    // Purpose: gather raw information, no interpretation
-    // =====================================================
-    {
-        action: "fileSearch",
-        groups: ["info"],
-        description: "Search the repository for files matching a query, filename, extension, or pattern. " +
-            "Use when the user references files or concepts not already present in context."
-    },
-    // =====================================================
-    // ANALYSIS PHASE
-    // Purpose: interpret, reason, derive constraints
-    // =====================================================
-    {
-        action: "semanticAnalysis",
-        groups: ["analysis"],
-        description: "Perform semantic reasoning over selected source files. " +
-            "Identifies intent, responsibilities, side effects, risks, and cross-file relationships. " +
-            "Does not modify code and should only operate on already-selected relevant files."
-    },
-    // =====================================================
-    // TRANSFORM PHASE
-    // Purpose: produce concrete changes or artifacts
-    // =====================================================
-    {
-        action: "codeTransform",
-        groups: ["transform"],
-        description: "Generate concrete code changes according to the execution plan and selected source files. " +
-            "This produces structured patches or full file rewrites, but does NOT write anything to disk. " +
-            "It should only be planned when actual code modifications are required, never for analysis purposes. " +
-            "Must complete successfully before any 'writeFile' steps are executed."
-    },
-    // =====================================================
-    // FINALIZE PHASE
-    // Purpose: commit results and respond to the user
-    // =====================================================
-    {
-        action: "finalAnswer",
-        groups: ["finalize"],
-        description: "Produce the final user-facing response, explanation, or report. " +
-            "Summarizes actions taken and results produced."
-    },
-];
+import { getActionRegistry } from "../agents/actionRegistry.js";
+/**
+ * Refactor note:
+ * - Temporary planner bridge derived from ActionRegistry.
+ * - Why it exists: keep legacy planner prompts stable during typed-action migration.
+ */
+const phaseToGroup = {
+    info: "info",
+    analysis: "analysis",
+    transform: "transform",
+    finalize: "finalize",
+    research: "analysis",
+    system: "transform",
+};
+/**
+ * Migration bridge:
+ * planners still read PLAN_ACTIONS while runtime authority is ActionRegistry.
+ */
+export const PLAN_ACTIONS = Object.values(getActionRegistry()).map((spec) => ({
+    // Example bridge row:
+    // { action: "semanticAnalysis", actionId: "semanticAnalysis", groups:["analysis"] }.
+    action: spec.id,
+    actionId: spec.id,
+    groups: [phaseToGroup[spec.phase] ?? "analysis"],
+    description: `${spec.phase} action (${spec.executorKind}, ${spec.safety})`,
+}));
+//# sourceMappingURL=planActions.js.map

package/dist/utils/planActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planActions.js","sourceRoot":"","sources":["../../src/utils/planActions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE;;;;GAIG;AACH,MAAM,YAAY,GAA2B;IAC3C,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5E,sBAAsB;IACtB,qFAAqF;IACrF,MAAM,EAAE,IAAI,CAAC,EAAE;IACf,QAAQ,EAAE,IAAI,CAAC,EAAE;IACjB,MAAM,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC;IAChD,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,MAAM,GAAG;CAC3E,CAAC,CAAC,CAAC","sourcesContent":["import { getActionRegistry } from \"../agents/actionRegistry.js\";\n\n/**\n * Refactor note:\n * - Temporary planner bridge derived from ActionRegistry.\n * - Why it exists: keep legacy planner prompts stable during typed-action migration.\n */\nconst phaseToGroup: Record<string, string> = {\n  info: \"info\",\n  analysis: \"analysis\",\n  transform: \"transform\",\n  finalize: \"finalize\",\n  research: \"analysis\",\n  system: \"transform\",\n};\n\n/**\n * Migration bridge:\n * planners still read PLAN_ACTIONS while runtime authority is ActionRegistry.\n */\nexport const PLAN_ACTIONS = Object.values(getActionRegistry()).map((spec) => ({\n  // Example bridge row:\n  // { action: \"semanticAnalysis\", actionId: \"semanticAnalysis\", groups:[\"analysis\"] }.\n  action: spec.id,\n  actionId: spec.id,\n  groups: [phaseToGroup[spec.phase] ?? \"analysis\"],\n  description: `${spec.phase} action (${spec.executorKind}, ${spec.safety})`,\n}));\n"]}

package/dist/utils/promptBuilderHelper.js

@@ -65,3 +65,4 @@ function serializeContext(ctx) {
     }
     return out.join("\n");
 }
+//# sourceMappingURL=promptBuilderHelper.js.map

package/dist/utils/promptBuilderHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptBuilderHelper.js","sourceRoot":"","sources":["../../src/utils/promptBuilderHelper.ts"],"names":[],"mappings":"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","sourcesContent":["import chalk from \"chalk\";\nimport { BuildContextualPromptArgs, StructuredContext } from \"../types.js\";\nimport { buildLightContext } from \"./buildContextualPrompt.js\";\n\n/**\n * Responsible only for building the contextual prompt text (no file writes).\n */\nexport async function buildContext(\n    args: BuildContextualPromptArgs\n): Promise<string> {\n    console.log(chalk.blueBright(\"\\n📦 Building contextual prompt...\"));\n\n    // ↳ Now returns a StructuredContext object\n    const ctx: StructuredContext = await buildLightContext(args);\n\n    // Serialize to prompt string\n    const promptContent = serializeContext(ctx);\n\n    console.log(chalk.greenBright(\"✅ Prompt built successfully.\"));\n    console.log(\n        chalk.cyan(\n            `[PromptBuilder] Token estimate: ~${Math.round(promptContent.length / 4)} tokens`\n        )\n    );\n\n    return promptContent;\n}\n\n\nfunction serializeContext(ctx: StructuredContext): string {\n    const out: string[] = [];\n\n    out.push(`# User Query\\n${ctx.initContext?.userQuery}\\n`);\n\n    if (ctx.initContext?.projectSummary) {\n        out.push(`# Project Summary\\n${ctx.initContext?.projectSummary}\\n`);\n    }\n\n    if (ctx.initContext?.moduleSummaries?.length) {\n        out.push(`# Module Summaries`);\n        for (const m of ctx.initContext?.moduleSummaries) {\n            out.push(`- **${m.path}**: ${m.summary}`);\n        }\n        out.push(\"\");\n    }\n\n    if (ctx.workingFiles?.length) {\n        out.push(`# Working Files`);\n        for (const f of ctx.workingFiles) {\n            out.push(`\\n## ${f.path}`);\n            if (f.summary) out.push(`Summary: ${f.summary}`);\n            if (f.code) out.push(`\\nCode (truncated):\\n${f.code.slice(0, 1000)}`);\n        }\n    }\n\n    if (ctx.analysis?.focus?.selectedFiles?.length) {\n        out.push(`# Focused Files (semantic analysis)`);\n        for (const path of ctx.analysis.focus.selectedFiles) {\n            out.push(`- ${path}`);\n        }\n        if (ctx.analysis.focus.rationale) {\n            out.push(`Rationale: ${ctx.analysis.focus.rationale}`);\n        }\n    }\n\n    if (ctx.analysis?.understanding) {\n        out.push(`# Semantic Understanding`);\n        if (ctx.analysis.understanding.problemStatement)\n            out.push(`Problem: ${ctx.analysis.understanding.problemStatement}`);\n        if (ctx.analysis.understanding.assumptions?.length)\n            out.push(`Assumptions: ${ctx.analysis.understanding.assumptions.join(\", \")}`);\n        if (ctx.analysis.understanding.risks?.length)\n            out.push(`Risks: ${ctx.analysis.understanding.risks.join(\", \")}`);\n    }\n\n    if (ctx.initContext?.repoTree) {\n        out.push(`# Repo Tree\\n${ctx.initContext?.repoTree}\\n`);\n    }\n\n    if (ctx.initContext?.kgSample?.length) {\n        out.push(`# Knowledge Graph Sample`);\n        for (const e of ctx.initContext?.kgSample) {\n            out.push(`- ${e.source} -> (${e.relation}) -> ${e.target}`);\n        }\n    }\n\n    return out.join(\"\\n\");\n}\n"]}

package/dist/utils/promptLogHelper.js

@@ -1,6 +1,18 @@
+/**
+ * Keeps legacy prompt and input/output helpers working during the runtime-log migration.
+ */
 import fs from "fs";
 import { log } from "../utils/log.js";
-import { SCAI_HOME, PROMPT_LOG_PATH, RUN_LOG_PATH } from "../constants.js";
+import { SCAI_HOME, PROMPT_LOG_PATH } from "../constants.js";
+import { clearRuntimeLogs, logRuntimeRecord } from "./runtimeLogger.js";
+/**
+ * Keeps the old prompt and input/output logging helpers working during migration.
+ *
+ * Why this file exists:
+ * - many legacy call sites still use `logInputOutput(...)`
+ * - Stage 1 moves the shared file names and backend first
+ * - Stage 2 can migrate callers away from this compatibility layer
+ */
 /**
  * Ensures SCAI_HOME exists before writing logs.
  */
@@ -31,18 +43,22 @@ export function logPrompt(prompt) {
 }
 /**
  * Appends module input/output data to a separate log file.
- * Automatically stringifies objects.
+ * Writes one shared runtime record so migration callers do not duplicate
+ * both the old banner block and the new structured record in `runtime.log`.
  */
 export function logInputOutput(stepName, type, content) {
     try {
-        ensureHomeDir();
-        const contentStr = typeof content === "string" ? content.trim() : JSON.stringify(content, null, 2);
-        const entry = formatHeader(`${type.toUpperCase()} | ${stepName}`) +
-            contentStr +
-            "\n" +
-            "=".repeat(68) +
-            "\n";
-        fs.appendFileSync(RUN_LOG_PATH, entry, "utf-8");
+        logRuntimeRecord({
+            runtime: "shared",
+            kind: "legacy",
+            phase: type,
+            summary: `${stepName} ${type}`,
+            payload: {
+                stepName,
+                type,
+                content,
+            },
+        });
     }
     catch (err) {
         log(`❌ Failed to append ${type} for ${stepName}:`, err);
@@ -54,10 +70,10 @@ export function logInputOutput(stepName, type, content) {
  */
 export function clearRunLog() {
     try {
-        ensureHomeDir();
-        fs.writeFileSync(RUN_LOG_PATH, "", { flag: "w" });
+        clearRuntimeLogs();
     }
     catch (err) {
-        log(`❌ Failed to clear run log at ${RUN_LOG_PATH}:`, err);
+        log(`❌ Failed to clear runtime logs:`, err);
     }
 }
+//# sourceMappingURL=promptLogHelper.js.map