@orquentra/codebuddy 2.14.0 → 2.15.0

package/dist/{chunk-ESZXCZIN.js → chunk-6YI2D5F5.js}

@@ -1,9 +1,12 @@
 import {
   redactLlmKeys
-} from "./chunk-SFMIMLXR.js";
+} from "./chunk-WHKXUXHE.js";
 import {
   writeAtomic
 } from "./chunk-CG5B3LYG.js";
+import {
+  localChatJson
+} from "./chunk-BTTQWSDS.js";
 
 // src/llm/budget.ts
 import { mkdir, readFile } from "fs/promises";
@@ -64,6 +67,7 @@ async function storeResponse(root, key, value) {
 var DEFAULT_COOLDOWN_SECONDS = 60;
 async function chatJson(config, request) {
   const started = Date.now();
+  if (config.local) return localCall(config.local, request);
   try {
     return await call(config, request, started);
   } catch (error) {
@@ -121,7 +125,9 @@ async function call(config, request, started) {
         ],
         temperature: 0,
         max_tokens: request.maxTokens,
-        response_format: { type: "json_object" }
+        response_format: { type: "json_object" },
+        // Qwen3 reasons by default on some hosts; cards and reranks need none.
+        ...config.provider === "groq" && /^qwen\//.test(config.model) ? { reasoning_effort: "none" } : {}
       }),
       signal: AbortSignal.timeout(request.deadlineMs)
     });
@@ -176,7 +182,28 @@ async function call(config, request, started) {
     cached: false
   };
 }
-function parseJsonContent(content) {
+async function localCall(spec, request) {
+  const started = Date.now();
+  const cacheKey = request.cacheKey && `local:${spec.id}:${request.cacheKey}`;
+  if (cacheKey) {
+    const parsed = request.schema.safeParse(await cachedResponse(request.repositoryRoot, cacheKey));
+    if (parsed.success) {
+      return {
+        ok: true,
+        value: parsed.data,
+        model: spec.id,
+        latencyMs: Date.now() - started,
+        tokens: 0,
+        cached: true
+      };
+    }
+  }
+  const result = await localChatJson(spec, request);
+  if (result.ok && cacheKey) await storeResponse(request.repositoryRoot, cacheKey, result.value);
+  return result;
+}
+function parseJsonContent(raw) {
+  const content = raw.replace(/<think>[\s\S]*?<\/think>/g, "");
   const fenced = content.match(/```(?:json)?\s*([\s\S]*?)```/i)?.[1];
   try {
     return JSON.parse((fenced ?? content).trim());
@@ -188,7 +215,8 @@ function estimateTokens(request, content) {
   return Math.ceil((request.system.length + request.user.length + content.length) / 4);
 }
 function redact(config, text) {
-  return redactLlmKeys(text).split(config.apiKey).join("[REDACTED]");
+  const redacted = redactLlmKeys(text);
+  return config.apiKey ? redacted.split(config.apiKey).join("[REDACTED]") : redacted;
 }
 
 export {
@@ -196,4 +224,4 @@ export {
   coolingDown,
   chatJson
 };
-//# sourceMappingURL=chunk-ESZXCZIN.js.map
+//# sourceMappingURL=chunk-6YI2D5F5.js.map

package/dist/chunk-6YI2D5F5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/llm/budget.ts","../src/llm/client.ts"],"sourcesContent":["import { mkdir, readFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { writeAtomic } from \"../core/markdown-store-fs.js\";\n\n/**\n * Free-tier hygiene for the LLM layer, all in `.codebuddy/cache/` (gitignored,\n * rebuildable): a per-day token ledger per provider:model, a cooldown after\n * 429s, and a response cache. Background work stops at 70% of the daily\n * budget so prompt-time calls keep a reserved 30%.\n *\n * ponytail: read-modify-write JSON without a lock; two hook processes can lose\n * one update. Fine for a soft budget; add the staging lock if it ever matters.\n */\nconst BACKGROUND_SHARE = 0.7;\nconst CACHE_LIMIT = 2_000;\n\nconst file = (root: string, name: string) => join(root, \".codebuddy\", \"cache\", name);\n\nasync function readJson<T>(path: string, fallback: T): Promise<T> {\n  try {\n    return JSON.parse(await readFile(path, \"utf8\")) as T;\n  } catch {\n    return fallback;\n  }\n}\n\nasync function writeJson(path: string, value: unknown): Promise<void> {\n  await mkdir(join(path, \"..\"), { recursive: true });\n  await writeAtomic(path, `${JSON.stringify(value)}\\n`);\n}\n\ntype Ledger = { day: string; used: Record<string, number> };\nconst utcDay = (now: Date) => now.toISOString().slice(0, 10);\n\nexport async function usageToday(root: string, now = new Date()): Promise<Record<string, number>> {\n  const ledger = await readJson<Ledger>(file(root, \"llm-usage.json\"), { day: \"\", used: {} });\n  return ledger.day === utcDay(now) ? ledger.used : {};\n}\n\nexport async function recordUsage(\n  root: string,\n  key: string,\n  tokens: number,\n  now = new Date(),\n): Promise<void> {\n  const used = await usageToday(root, now);\n  used[key] = (used[key] ?? 0) + tokens;\n  await writeJson(file(root, \"llm-usage.json\"), { day: utcDay(now), used });\n}\n\n/** Whether `estimate` more tokens fit today's share for this purpose. */\nexport async function reserveBudget(\n  root: string,\n  key: string,\n  purpose: \"prompt\" | \"background\",\n  estimate: number,\n  dailyBudget: number,\n  now = new Date(),\n): Promise<boolean> {\n  const limit = purpose === \"background\" ? dailyBudget * BACKGROUND_SHARE : dailyBudget;\n  return ((await usageToday(root, now))[key] ?? 0) + estimate <= limit;\n}\n\n/** Milliseconds of cooldown left for this provider:model (0 = none). */\nexport async function coolingDown(root: string, key: string, now = new Date()): Promise<number> {\n  const until = (await readJson<Record<string, number>>(file(root, \"llm-cooldown.json\"), {}))[key];\n  return until ? Math.max(0, until - now.getTime()) : 0;\n}\n\nexport async function startCooldown(\n  root: string,\n  key: string,\n  seconds: number,\n  now = new Date(),\n): Promise<void> {\n  const path = file(root, \"llm-cooldown.json\");\n  const cooldowns = await readJson<Record<string, number>>(path, {});\n  cooldowns[key] = now.getTime() + seconds * 1_000;\n  await writeJson(path, cooldowns);\n}\n\nexport async function cachedResponse(root: string, key: string): Promise<unknown | undefined> {\n  return (await readJson<Record<string, unknown>>(file(root, \"llm-responses.json\"), {}))[key];\n}\n\n/** Insertion-ordered; the oldest entries go once the cache holds CACHE_LIMIT. */\nexport async function storeResponse(root: string, key: string, value: unknown): Promise<void> {\n  const path = file(root, \"llm-responses.json\");\n  const cache = await readJson<Record<string, unknown>>(path, {});\n  delete cache[key];\n  cache[key] = value;\n  const keys = Object.keys(cache);\n  for (const old of keys.slice(0, Math.max(0, keys.length - CACHE_LIMIT))) delete cache[old];\n  await writeJson(path, cache);\n}\n","import type { z } from \"zod\";\nimport {\n  cachedResponse,\n  coolingDown,\n  recordUsage,\n  reserveBudget,\n  startCooldown,\n  storeResponse,\n} from \"./budget.js\";\nimport { type EnabledLlmConfig, redactLlmKeys } from \"./config.js\";\nimport { type LocalModelSpec, localChatJson } from \"./local.js\";\n\n/** Seconds to back off after a 429 without a usable retry-after header. */\nconst DEFAULT_COOLDOWN_SECONDS = 60;\n\n/**\n * One OpenAI-compatible chat call that must answer with JSON (Groq and\n * OpenRouter share the API). It never throws: every failure is a reason the\n * caller turns into today's deterministic behaviour plus an explain line.\n */\nexport type LlmFailure =\n  | \"disabled\"\n  | \"timeout\"\n  | \"rate-limited\"\n  | \"cooldown\"\n  | \"budget\"\n  | \"http\"\n  | \"invalid\";\n\nexport type LlmResult<T> =\n  | { ok: true; value: T; model: string; latencyMs: number; tokens: number; cached: boolean }\n  | { ok: false; reason: LlmFailure; detail: string; latencyMs: number };\n\nexport type ChatJsonRequest<T> = {\n  system: string;\n  user: string;\n  schema: z.ZodType<T>;\n  maxTokens: number;\n  deadlineMs: number;\n  /** Prompt-path calls get the reserved budget share; background work stops earlier. */\n  purpose: \"prompt\" | \"background\";\n  /**\n   * Local backend only: a JSON schema for the generation grammar (with\n   * `maxItems`/`maxLength` bounds) instead of one derived from `schema`.\n   */\n  jsonSchema?: object;\n  /** Cache identity (inputs + prompt version); omitted = never cached. */\n  cacheKey?: string;\n  repositoryRoot: string;\n};\n\nexport async function chatJson<T>(\n  config: EnabledLlmConfig,\n  request: ChatJsonRequest<T>,\n): Promise<LlmResult<T>> {\n  const started = Date.now();\n  if (config.local) return localCall(config.local, request);\n  try {\n    return await call(config, request, started);\n  } catch (error) {\n    // Structural guarantee: an unexpected body shape is an invalid answer, not a crash.\n    return {\n      ok: false,\n      reason: \"invalid\",\n      detail: redact(config, String((error as Error)?.message ?? error)).slice(0, 300),\n      latencyMs: Date.now() - started,\n    };\n  }\n}\n\nasync function call<T>(\n  config: EnabledLlmConfig,\n  request: ChatJsonRequest<T>,\n  started: number,\n): Promise<LlmResult<T>> {\n  const fail = (reason: LlmFailure, detail: string): LlmResult<T> => ({\n    ok: false,\n    reason,\n    detail: redact(config, detail).slice(0, 300),\n    latencyMs: Date.now() - started,\n  });\n  const root = request.repositoryRoot;\n  const ledgerKey = `${config.provider}:${config.model}`;\n  const cooling = await coolingDown(root, ledgerKey);\n  if (cooling > 0) return fail(\"cooldown\", `rate limited; retry in ${Math.ceil(cooling / 1000)} s`);\n  const cacheKey = request.cacheKey && `${ledgerKey}:${request.cacheKey}`;\n  if (cacheKey) {\n    const parsed = request.schema.safeParse(await cachedResponse(root, cacheKey));\n    if (parsed.success) {\n      return {\n        ok: true,\n        value: parsed.data,\n        model: config.model,\n        latencyMs: Date.now() - started,\n        tokens: 0,\n        cached: true,\n      };\n    }\n  }\n  const estimate = estimateTokens(request, \"\") + request.maxTokens;\n  if (!(await reserveBudget(root, ledgerKey, request.purpose, estimate, config.dailyTokenBudget))) {\n    return fail(\"budget\", `daily ${request.purpose} budget for ${ledgerKey} is spent`);\n  }\n  let response: Response;\n  try {\n    response = await fetch(`${config.baseUrl}/chat/completions`, {\n      method: \"POST\",\n      headers: {\n        authorization: `Bearer ${config.apiKey}`,\n        \"content-type\": \"application/json\",\n        ...(config.provider === \"openrouter\" ? { \"x-title\": \"CodeBuddy\" } : {}),\n      },\n      body: JSON.stringify({\n        model: config.model,\n        messages: [\n          { role: \"system\", content: request.system },\n          { role: \"user\", content: request.user },\n        ],\n        temperature: 0,\n        max_tokens: request.maxTokens,\n        response_format: { type: \"json_object\" },\n        // Qwen3 reasons by default on some hosts; cards and reranks need none.\n        ...(config.provider === \"groq\" && /^qwen\\//.test(config.model)\n          ? { reasoning_effort: \"none\" }\n          : {}),\n      }),\n      signal: AbortSignal.timeout(request.deadlineMs),\n    });\n  } catch (error) {\n    const name = (error as Error)?.name;\n    if (name === \"TimeoutError\" || name === \"AbortError\") {\n      return fail(\"timeout\", `no answer within ${request.deadlineMs} ms`);\n    }\n    return fail(\"http\", (error as Error)?.message ?? String(error));\n  }\n  let body: string;\n  try {\n    body = await response.text();\n  } catch (error) {\n    const name = (error as Error)?.name;\n    return fail(\n      name === \"TimeoutError\" || name === \"AbortError\" ? \"timeout\" : \"http\",\n      String(error),\n    );\n  }\n  if (response.status === 429) {\n    const retryAfter = Number(response.headers.get(\"retry-after\"));\n    await startCooldown(\n      root,\n      ledgerKey,\n      Number.isFinite(retryAfter) && retryAfter > 0 ? retryAfter : DEFAULT_COOLDOWN_SECONDS,\n    );\n    return fail(\"rate-limited\", body);\n  }\n  if (!response.ok) return fail(\"http\", `HTTP ${response.status}: ${body}`);\n\n  let completion: {\n    model?: unknown;\n    choices?: Array<{ message?: { content?: unknown } }>;\n    usage?: { total_tokens?: unknown };\n  } | null;\n  try {\n    completion = JSON.parse(body);\n  } catch {\n    return fail(\"invalid\", \"response is not JSON\");\n  }\n  const raw = completion?.choices?.[0]?.message?.content;\n  if (typeof raw !== \"string\") return fail(\"invalid\", \"answer has no text content\");\n  const content = raw;\n  const reported = completion?.usage?.total_tokens;\n  const tokens =\n    typeof reported === \"number\" && Number.isFinite(reported)\n      ? reported\n      : estimateTokens(request, content);\n  await recordUsage(root, ledgerKey, tokens);\n  const parsed = request.schema.safeParse(parseJsonContent(content));\n  if (!parsed.success) return fail(\"invalid\", `output failed validation: ${content.slice(0, 120)}`);\n  if (cacheKey) await storeResponse(root, cacheKey, parsed.data);\n  return {\n    ok: true,\n    value: parsed.data,\n    model: typeof completion?.model === \"string\" ? completion.model : config.model,\n    latencyMs: Date.now() - started,\n    tokens,\n    cached: false,\n  };\n}\n\n/** Local generation: same response cache, no budget ledger or cooldown (no cost, no quota). */\nasync function localCall<T>(\n  spec: LocalModelSpec,\n  request: ChatJsonRequest<T>,\n): Promise<LlmResult<T>> {\n  const started = Date.now();\n  const cacheKey = request.cacheKey && `local:${spec.id}:${request.cacheKey}`;\n  if (cacheKey) {\n    const parsed = request.schema.safeParse(await cachedResponse(request.repositoryRoot, cacheKey));\n    if (parsed.success) {\n      return {\n        ok: true,\n        value: parsed.data,\n        model: spec.id,\n        latencyMs: Date.now() - started,\n        tokens: 0,\n        cached: true,\n      };\n    }\n  }\n  const result = await localChatJson(spec, request);\n  if (result.ok && cacheKey) await storeResponse(request.repositoryRoot, cacheKey, result.value);\n  return result;\n}\n\n/** Free models often wrap JSON in a ```json fence despite json_object mode. */\nfunction parseJsonContent(raw: string): unknown {\n  // A Qwen3 host may still prepend an (empty) reasoning block.\n  const content = raw.replace(/<think>[\\s\\S]*?<\\/think>/g, \"\");\n  const fenced = content.match(/```(?:json)?\\s*([\\s\\S]*?)```/i)?.[1];\n  try {\n    return JSON.parse((fenced ?? content).trim());\n  } catch {\n    return undefined;\n  }\n}\n\nfunction estimateTokens(request: { system: string; user: string }, content: string): number {\n  return Math.ceil((request.system.length + request.user.length + content.length) / 4);\n}\n\nfunction redact(config: EnabledLlmConfig, text: string): string {\n  const redacted = redactLlmKeys(text);\n  return config.apiKey ? redacted.split(config.apiKey).join(\"[REDACTED]\") : redacted;\n}\n"],"mappings":"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","names":["parsed"]}

package/dist/{chunk-4DKYKDHI.js → chunk-7IPSDDO5.js}

@@ -1,7 +1,9 @@
 import {
-  countTokens,
+  countTokens
+} from "./chunk-57642NGU.js";
+import {
   generateEntityId
-} from "./chunk-CAEPHLHC.js";
+} from "./chunk-EMWGLKPR.js";
 import {
   writeAtomic
 } from "./chunk-CG5B3LYG.js";
@@ -331,4 +333,4 @@ export {
   coveringTestCandidates,
   detectTestCommand
 };
-//# sourceMappingURL=chunk-4DKYKDHI.js.map
+//# sourceMappingURL=chunk-7IPSDDO5.js.map

package/dist/{chunk-4DKYKDHI.js.map → chunk-7IPSDDO5.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/savings/tokens.ts","../src/context/session-ledger.ts","../src/context/tests.ts"],"sourcesContent":["import { countTokens } from \"../planner/budget.js\";\n\n/**\n * The one place token counts are computed. Strings use the same deterministic\n * cl100k tokenizer as planner budgets; objects are measured by their JSON\n * serialization, which matches how they travel over MCP.\n */\n\nexport function estimateTokens(value: unknown): number {\n  if (value === undefined || value === null) return 0;\n  const text = typeof value === \"string\" ? value : JSON.stringify(value);\n  if (!text) return 0;\n  return countTokens(text);\n}\n","import { createHash } from \"node:crypto\";\nimport { mkdir, readdir, readFile, rm, stat } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\nimport { generateEntityId } from \"../core/ids.js\";\nimport { writeAtomic } from \"../core/markdown-store-fs.js\";\nimport { estimateTokens } from \"../savings/tokens.js\";\n\nconst VERSION = 2;\nconst MAX_CAPSULES = 128;\nconst MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000;\nconst MAX_PENDING = 8;\nconst PENDING_MAX_AGE_MS = 24 * 60 * 60 * 1000;\nconst STALE_LOCK_MS = 60_000;\n/** Acknowledged versions kept per section, so switching back to a task reuses them. */\nconst MAX_ACKNOWLEDGED_PER_KEY = 8;\n\ntype LedgerRecord = { hash: string; lastSentAt: string };\n/** A delivery sent to a client that has not yet confirmed receipt. */\ntype PendingDelivery = { createdAt: string; records: Record<string, string> };\n/** One acknowledged version of an `exchange` section: content hash and when it was sent. */\ntype AcknowledgedVersion = { hash: string; sentAt: string };\ntype LedgerFile = {\n  version: 2;\n  updatedAt: string;\n  /** `deliver`/`markSent` capsules (hooks): one current hash per key. */\n  records: Record<string, LedgerRecord>;\n  pending?: Record<string, PendingDelivery>;\n  /** `exchange` sections (MCP): every recently acknowledged version, newest first. */\n  acknowledged?: Record<string, AcknowledgedVersion[]>;\n};\n\nexport type ContextCapsule = { key: string; text: string };\nexport type CapsuleDelivery = {\n  /** Full text of new or changed capsules, in input order. */\n  lines: string[];\n  /** Keys of capsules already sent this session and not resent. */\n  unchanged: string[];\n  full: number;\n  referenced: number;\n  sentTokens: number;\n  avoidedTokens: number;\n};\n\nexport type SectionHash = { key: string; hash: string };\nexport type AcknowledgedExchange = {\n  deliveryId: string;\n  /** Keys whose content the client confirmed receiving and that have not changed. */\n  unchanged: string[];\n  ack: \"none\" | \"accepted\" | \"unknown\";\n};\n\nexport class SessionCapsuleLedger {\n  private readonly directory: string;\n\n  constructor(repositoryRoot = process.cwd()) {\n    this.directory = join(resolve(repositoryRoot), \".codebuddy\", \"cache\", \"session\");\n  }\n\n  async deliver(\n    sessionId: string,\n    capsules: ContextCapsule[],\n    now = new Date(),\n  ): Promise<CapsuleDelivery> {\n    await mkdir(this.directory, { recursive: true, mode: 0o700 });\n    const release = await this.acquire(sessionId);\n    try {\n      const path = this.path(sessionId);\n      const ledger = await this.read(path, now);\n      const lines: string[] = [];\n      const unchanged: string[] = [];\n      let full = 0;\n      let referenced = 0;\n      let sentTokens = 0;\n      let avoidedTokens = 0;\n\n      for (const capsule of capsules) {\n        const hash = digest(capsule.text);\n        const existing = ledger.records[capsule.key];\n        if (existing?.hash === hash) {\n          unchanged.push(capsule.key);\n          referenced++;\n          avoidedTokens += estimateTokens(capsule.text);\n        } else {\n          lines.push(capsule.text);\n          full++;\n          sentTokens += estimateTokens(capsule.text);\n        }\n        ledger.records[capsule.key] = { hash, lastSentAt: now.toISOString() };\n      }\n\n      await this.write(path, ledger, now);\n      return { lines, unchanged, full, referenced, sentTokens, avoidedTokens };\n    } finally {\n      await release();\n    }\n  }\n\n  /** Keys of capsules whose current text was already recorded as sent this session. */\n  async seen(\n    sessionId: string,\n    capsules: ContextCapsule[],\n    now = new Date(),\n  ): Promise<Set<string>> {\n    const ledger = await this.read(this.path(sessionId), now);\n    return new Set(\n      capsules\n        .filter((capsule) => ledger.records[capsule.key]?.hash === digest(capsule.text))\n        .map((capsule) => capsule.key),\n    );\n  }\n\n  /** Whether anything was delivered in this session yet (a later prompt is a follow-up). */\n  async delivered(sessionId: string, now = new Date()): Promise<boolean> {\n    const ledger = await this.read(this.path(sessionId), now);\n    return Object.keys(ledger.records).length > 0;\n  }\n\n  /**\n   * Record capsules as delivered. Call only after their text actually reached\n   * the client, so capsules that were clipped or failed to write stay unseen\n   * and are delivered by a later prompt.\n   */\n  async markSent(sessionId: string, capsules: ContextCapsule[], now = new Date()): Promise<void> {\n    if (capsules.length === 0) return;\n    await mkdir(this.directory, { recursive: true, mode: 0o700 });\n    const release = await this.acquire(sessionId);\n    try {\n      const path = this.path(sessionId);\n      const ledger = await this.read(path, now);\n      for (const capsule of capsules) {\n        ledger.records[capsule.key] = { hash: digest(capsule.text), lastSentAt: now.toISOString() };\n      }\n      await this.write(path, ledger, now);\n    } finally {\n      await release();\n    }\n  }\n\n  /**\n   * Acknowledged delivery for clients that can lose context (MCP). Unlike\n   * `deliver`, sending marks nothing as seen: the sent hashes are held as a\n   * pending delivery until the client echoes its `deliveryId` back as `ack` on\n   * a later call. Only acknowledged, unchanged sections sent within `ttlMs` are\n   * reported unchanged, so a dropped response or a compacted client context\n   * fails safe to a full resend.\n   *\n   * A section keeps its last few acknowledged versions (by content hash), not\n   * just the latest, so returning to an earlier task in the same session does\n   * not resend what the client already holds. `full` means the client lost its\n   * context: every acknowledged version and unconfirmed delivery is forgotten.\n   */\n  async exchange(\n    sessionId: string,\n    sections: SectionHash[],\n    options: {\n      ack?: string;\n      ttlMs: number;\n      /** The client lost its context: nothing acknowledged before this call counts. */\n      full?: boolean;\n      now?: Date;\n      /** Finalize the response before recording hashes of the actual sent sections. */\n      prepare?: (exchange: AcknowledgedExchange) => SectionHash[];\n    },\n  ): Promise<AcknowledgedExchange> {\n    const now = options.now ?? new Date();\n    await mkdir(this.directory, { recursive: true, mode: 0o700 });\n    const release = await this.acquire(sessionId);\n    try {\n      const path = this.path(sessionId);\n      const ledger = await this.read(path, now);\n      let pending = ledger.pending ?? {};\n      let acknowledged = ledger.acknowledged ?? {};\n\n      let ack: AcknowledgedExchange[\"ack\"] = \"none\";\n      if (options.ack !== undefined) {\n        const confirmed = pending[options.ack];\n        if (confirmed) {\n          for (const [key, hash] of Object.entries(confirmed.records)) {\n            acknowledged[key] = [\n              { hash, sentAt: confirmed.createdAt },\n              ...(acknowledged[key] ?? []).filter((version) => version.hash !== hash),\n            ]\n              .sort((left, right) => right.sentAt.localeCompare(left.sentAt))\n              .slice(0, MAX_ACKNOWLEDGED_PER_KEY);\n          }\n          delete pending[options.ack];\n          ack = \"accepted\";\n        } else {\n          ack = \"unknown\";\n        }\n      }\n      if (options.full) {\n        acknowledged = {};\n        pending = {};\n      }\n\n      const unchanged: string[] = [];\n      const sent: Record<string, string> = {};\n      for (const section of sections) {\n        const held = acknowledged[section.key]?.some((version) => {\n          const age = now.getTime() - Date.parse(version.sentAt);\n          return version.hash === section.hash && age >= 0 && age <= options.ttlMs;\n        });\n        if (held) {\n          unchanged.push(section.key);\n        } else {\n          sent[section.key] = section.hash;\n        }\n      }\n\n      const deliveryId = generateEntityId(\"dlv\", now.getTime());\n      const exchange = { deliveryId, unchanged, ack };\n      const delivered = options.prepare?.(exchange);\n      pending[deliveryId] = {\n        createdAt: now.toISOString(),\n        records: delivered\n          ? Object.fromEntries(delivered.map(({ key, hash }) => [key, hash]))\n          : sent,\n      };\n      ledger.pending = Object.fromEntries(\n        Object.entries(pending)\n          .filter(([, item]) => now.getTime() - Date.parse(item.createdAt) <= PENDING_MAX_AGE_MS)\n          .sort((left, right) => right[1].createdAt.localeCompare(left[1].createdAt))\n          .slice(0, MAX_PENDING),\n      );\n      ledger.acknowledged = Object.fromEntries(\n        Object.entries(acknowledged)\n          .map(([key, versions]): [string, AcknowledgedVersion[]] => [\n            key,\n            versions.filter((version) => now.getTime() - Date.parse(version.sentAt) <= MAX_AGE_MS),\n          ])\n          .filter(([, versions]) => versions.length > 0)\n          .slice(0, MAX_CAPSULES),\n      );\n      await this.write(path, ledger, now);\n      return { deliveryId, unchanged, ack };\n    } finally {\n      await release();\n    }\n  }\n\n  /** Forget everything sent in a session, e.g. after the client compacted its context. */\n  async reset(sessionId: string): Promise<void> {\n    await mkdir(this.directory, { recursive: true, mode: 0o700 });\n    const release = await this.acquire(sessionId);\n    try {\n      await rm(this.path(sessionId), { force: true });\n    } finally {\n      await release();\n    }\n  }\n\n  /** Remove expired disposable state; locked sessions are left for the next pass. */\n  async pruneExpired(now = new Date()): Promise<number> {\n    let removed = 0;\n    for (const entry of await readdir(this.directory).catch(() => [])) {\n      if (!entry.endsWith(\".json\")) continue;\n      const path = join(this.directory, entry);\n      try {\n        await stat(`${path}.lock`);\n        continue;\n      } catch {\n        // No active lock.\n      }\n      try {\n        const metadata = await stat(path);\n        if (now.getTime() - metadata.mtimeMs > MAX_AGE_MS) {\n          await rm(path, { force: true });\n          removed++;\n        }\n      } catch {\n        // Another cleanup may have removed it already.\n      }\n    }\n    return removed;\n  }\n\n  private async write(path: string, ledger: LedgerFile, now: Date): Promise<void> {\n    ledger.updatedAt = now.toISOString();\n    ledger.records = Object.fromEntries(\n      Object.entries(ledger.records)\n        .sort((left, right) => right[1].lastSentAt.localeCompare(left[1].lastSentAt))\n        .slice(0, MAX_CAPSULES),\n    );\n    await writeAtomic(path, `${JSON.stringify(ledger, null, 2)}\\n`);\n  }\n\n  private async read(path: string, now: Date): Promise<LedgerFile> {\n    try {\n      const parsed = JSON.parse(await readFile(path, \"utf8\")) as LedgerFile;\n      if (parsed.version !== VERSION || typeof parsed.records !== \"object\") return empty(now);\n      const records = Object.fromEntries(\n        Object.entries(parsed.records).filter(([, record]) => {\n          const age = now.getTime() - Date.parse(record.lastSentAt);\n          return Number.isFinite(age) && age <= MAX_AGE_MS;\n        }),\n      );\n      const pending =\n        parsed.pending && typeof parsed.pending === \"object\" ? parsed.pending : undefined;\n      const acknowledged =\n        parsed.acknowledged && typeof parsed.acknowledged === \"object\"\n          ? Object.fromEntries(\n              Object.entries(parsed.acknowledged).filter(([, versions]) => Array.isArray(versions)),\n            )\n          : undefined;\n      return {\n        version: VERSION,\n        updatedAt: parsed.updatedAt,\n        records,\n        ...(pending ? { pending } : {}),\n        ...(acknowledged ? { acknowledged } : {}),\n      };\n    } catch {\n      return empty(now);\n    }\n  }\n\n  private path(sessionId: string): string {\n    // The full identity participates in the key. Legacy sanitized filenames\n    // are intentionally ignored, so a fresh session cannot inherit collisions.\n    return join(this.directory, `${digest(sessionId)}.json`);\n  }\n\n  private async acquire(sessionId: string): Promise<() => Promise<void>> {\n    const lock = `${this.path(sessionId)}.lock`;\n    for (let attempt = 0; ; attempt++) {\n      try {\n        await mkdir(lock);\n        return async () => rm(lock, { recursive: true, force: true });\n      } catch (error) {\n        if ((error as NodeJS.ErrnoException).code !== \"EEXIST\" || attempt >= 200) throw error;\n        try {\n          const age = Date.now() - (await stat(lock)).mtimeMs;\n          if (age > STALE_LOCK_MS) {\n            await rm(lock, { recursive: true, force: true });\n            continue;\n          }\n        } catch {\n          // The owner may have released the lock between checks.\n        }\n        await new Promise((resolveWait) => setTimeout(resolveWait, 10));\n      }\n    }\n  }\n}\n\nfunction empty(now: Date): LedgerFile {\n  return { version: VERSION, updatedAt: now.toISOString(), records: {} };\n}\n\nfunction digest(text: string): string {\n  return createHash(\"sha256\").update(text).digest(\"hex\");\n}\n","import { access, readFile } from \"node:fs/promises\";\nimport { basename, dirname, extname, join } from \"node:path\";\n\n/**\n * Which test covers a file and how this repo runs its tests, from naming\n * conventions and project markers only. Agents otherwise spend turns finding\n * both; a wrong guess costs one failed command, so first match wins.\n */\nexport function findCoveringTest(path: string, paths: ReadonlySet<string>): string | null {\n  return coveringTestCandidates(path).find((candidate) => paths.has(candidate)) ?? null;\n}\n\n/** Conventional covering-test paths for `path`, most specific first. */\nexport function coveringTestCandidates(path: string): string[] {\n  const ext = extname(path);\n  const stem = basename(path, ext);\n  const dir = dirname(path);\n  const join2 = (...parts: string[]) => parts.filter((part) => part && part !== \".\").join(\"/\");\n  // `src/a/x.ts` mirrors to `test/a/x.test.ts`: drop a leading source root.\n  const mirrored = dir.replace(/^(src|lib|app)(\\/|$)/, \"\");\n  return ext === \".py\"\n    ? [\n        join2(dir, `test_${stem}.py`),\n        join2(dir, `${stem}_test.py`),\n        join2(dir, \"tests\", `test_${stem}.py`),\n        // `src/pkg/sub/x.py` → `tests/pkg/sub/test_x.py`, `tests/sub/test_x.py`, `tests/test_x.py`.\n        join2(\"tests\", mirrored, `test_${stem}.py`),\n        join2(\"tests\", mirrored.replace(/^[^/]+\\/?/, \"\"), `test_${stem}.py`),\n        join2(\"tests\", `test_${stem}.py`),\n      ]\n    : ext === \".go\"\n      ? [join2(dir, `${stem}_test.go`)]\n      : [\n          join2(dir, `${stem}.test${ext}`),\n          join2(dir, `${stem}.spec${ext}`),\n          join2(dir, \"__tests__\", `${stem}.test${ext}`),\n          join2(dir, \"__tests__\", `${stem}${ext}`),\n          join2(\"test\", mirrored, `${stem}.test${ext}`),\n          join2(\"tests\", mirrored, `${stem}.test${ext}`),\n        ];\n}\n\nconst NPM_PLACEHOLDER = /no test specified/;\n\nexport async function detectTestCommand(repositoryRoot: string): Promise<string | null> {\n  const exists = (file: string) =>\n    access(join(repositoryRoot, file)).then(\n      () => true,\n      () => false,\n    );\n  try {\n    const pkg = JSON.parse(await readFile(join(repositoryRoot, \"package.json\"), \"utf8\")) as {\n      scripts?: Record<string, unknown>;\n      packageManager?: unknown;\n    };\n    const script = pkg.scripts?.test;\n    if (typeof script === \"string\" && script.trim() && !NPM_PLACEHOLDER.test(script)) {\n      const declared =\n        typeof pkg.packageManager === \"string\" ? pkg.packageManager.split(/[\\s@]/, 1)[0] : \"\";\n      // `bun test` is Bun's own runner, not the package's test script.\n      if (declared === \"bun\") return \"bun run test\";\n      if (declared && [\"npm\", \"pnpm\", \"yarn\"].includes(declared)) return `${declared} test`;\n      if (await exists(\"pnpm-lock.yaml\")) return \"pnpm test\";\n      if (await exists(\"yarn.lock\")) return \"yarn test\";\n      if ((await exists(\"bun.lockb\")) || (await exists(\"bun.lock\"))) return \"bun run test\";\n      return \"npm test\";\n    }\n  } catch {\n    // No or unreadable package.json: try other ecosystems.\n  }\n  for (const marker of [\"pyproject.toml\", \"pytest.ini\", \"setup.cfg\"]) {\n    if (await exists(marker)) return \"pytest\";\n  }\n  if (await exists(\"go.mod\")) return \"go test ./...\";\n  if (await exists(\"Cargo.toml\")) return \"cargo test\";\n  return null;\n}\n"],"mappings":"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","names":["readFile","join","join2"]}
+{"version":3,"sources":["../src/savings/tokens.ts","../src/context/session-ledger.ts","../src/context/tests.ts"],"sourcesContent":["import { countTokens } from \"../planner/budget.js\";\n\n/**\n * The one place token counts are computed. Strings use the same deterministic\n * cl100k tokenizer as planner budgets; objects are measured by their JSON\n * serialization, which matches how they travel over MCP.\n */\n\nexport function estimateTokens(value: unknown): number {\n  if (value === undefined || value === null) return 0;\n  const text = typeof value === \"string\" ? value : JSON.stringify(value);\n  if (!text) return 0;\n  return countTokens(text);\n}\n","import { createHash } from \"node:crypto\";\nimport { mkdir, readdir, readFile, rm, stat } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\nimport { generateEntityId } from \"../core/ids.js\";\nimport { writeAtomic } from \"../core/markdown-store-fs.js\";\nimport { estimateTokens } from \"../savings/tokens.js\";\n\nconst VERSION = 2;\nconst MAX_CAPSULES = 128;\nconst MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000;\nconst MAX_PENDING = 8;\nconst PENDING_MAX_AGE_MS = 24 * 60 * 60 * 1000;\nconst STALE_LOCK_MS = 60_000;\n/** Acknowledged versions kept per section, so switching back to a task reuses them. */\nconst MAX_ACKNOWLEDGED_PER_KEY = 8;\n\ntype LedgerRecord = { hash: string; lastSentAt: string };\n/** A delivery sent to a client that has not yet confirmed receipt. */\ntype PendingDelivery = { createdAt: string; records: Record<string, string> };\n/** One acknowledged version of an `exchange` section: content hash and when it was sent. */\ntype AcknowledgedVersion = { hash: string; sentAt: string };\ntype LedgerFile = {\n  version: 2;\n  updatedAt: string;\n  /** `deliver`/`markSent` capsules (hooks): one current hash per key. */\n  records: Record<string, LedgerRecord>;\n  pending?: Record<string, PendingDelivery>;\n  /** `exchange` sections (MCP): every recently acknowledged version, newest first. */\n  acknowledged?: Record<string, AcknowledgedVersion[]>;\n};\n\nexport type ContextCapsule = { key: string; text: string };\nexport type CapsuleDelivery = {\n  /** Full text of new or changed capsules, in input order. */\n  lines: string[];\n  /** Keys of capsules already sent this session and not resent. */\n  unchanged: string[];\n  full: number;\n  referenced: number;\n  sentTokens: number;\n  avoidedTokens: number;\n};\n\nexport type SectionHash = { key: string; hash: string };\nexport type AcknowledgedExchange = {\n  deliveryId: string;\n  /** Keys whose content the client confirmed receiving and that have not changed. */\n  unchanged: string[];\n  ack: \"none\" | \"accepted\" | \"unknown\";\n};\n\nexport class SessionCapsuleLedger {\n  private readonly directory: string;\n\n  constructor(repositoryRoot = process.cwd()) {\n    this.directory = join(resolve(repositoryRoot), \".codebuddy\", \"cache\", \"session\");\n  }\n\n  async deliver(\n    sessionId: string,\n    capsules: ContextCapsule[],\n    now = new Date(),\n  ): Promise<CapsuleDelivery> {\n    await mkdir(this.directory, { recursive: true, mode: 0o700 });\n    const release = await this.acquire(sessionId);\n    try {\n      const path = this.path(sessionId);\n      const ledger = await this.read(path, now);\n      const lines: string[] = [];\n      const unchanged: string[] = [];\n      let full = 0;\n      let referenced = 0;\n      let sentTokens = 0;\n      let avoidedTokens = 0;\n\n      for (const capsule of capsules) {\n        const hash = digest(capsule.text);\n        const existing = ledger.records[capsule.key];\n        if (existing?.hash === hash) {\n          unchanged.push(capsule.key);\n          referenced++;\n          avoidedTokens += estimateTokens(capsule.text);\n        } else {\n          lines.push(capsule.text);\n          full++;\n          sentTokens += estimateTokens(capsule.text);\n        }\n        ledger.records[capsule.key] = { hash, lastSentAt: now.toISOString() };\n      }\n\n      await this.write(path, ledger, now);\n      return { lines, unchanged, full, referenced, sentTokens, avoidedTokens };\n    } finally {\n      await release();\n    }\n  }\n\n  /** Keys of capsules whose current text was already recorded as sent this session. */\n  async seen(\n    sessionId: string,\n    capsules: ContextCapsule[],\n    now = new Date(),\n  ): Promise<Set<string>> {\n    const ledger = await this.read(this.path(sessionId), now);\n    return new Set(\n      capsules\n        .filter((capsule) => ledger.records[capsule.key]?.hash === digest(capsule.text))\n        .map((capsule) => capsule.key),\n    );\n  }\n\n  /** Whether anything was delivered in this session yet (a later prompt is a follow-up). */\n  async delivered(sessionId: string, now = new Date()): Promise<boolean> {\n    const ledger = await this.read(this.path(sessionId), now);\n    return Object.keys(ledger.records).length > 0;\n  }\n\n  /**\n   * Record capsules as delivered. Call only after their text actually reached\n   * the client, so capsules that were clipped or failed to write stay unseen\n   * and are delivered by a later prompt.\n   */\n  async markSent(sessionId: string, capsules: ContextCapsule[], now = new Date()): Promise<void> {\n    if (capsules.length === 0) return;\n    await mkdir(this.directory, { recursive: true, mode: 0o700 });\n    const release = await this.acquire(sessionId);\n    try {\n      const path = this.path(sessionId);\n      const ledger = await this.read(path, now);\n      for (const capsule of capsules) {\n        ledger.records[capsule.key] = { hash: digest(capsule.text), lastSentAt: now.toISOString() };\n      }\n      await this.write(path, ledger, now);\n    } finally {\n      await release();\n    }\n  }\n\n  /**\n   * Acknowledged delivery for clients that can lose context (MCP). Unlike\n   * `deliver`, sending marks nothing as seen: the sent hashes are held as a\n   * pending delivery until the client echoes its `deliveryId` back as `ack` on\n   * a later call. Only acknowledged, unchanged sections sent within `ttlMs` are\n   * reported unchanged, so a dropped response or a compacted client context\n   * fails safe to a full resend.\n   *\n   * A section keeps its last few acknowledged versions (by content hash), not\n   * just the latest, so returning to an earlier task in the same session does\n   * not resend what the client already holds. `full` means the client lost its\n   * context: every acknowledged version and unconfirmed delivery is forgotten.\n   */\n  async exchange(\n    sessionId: string,\n    sections: SectionHash[],\n    options: {\n      ack?: string;\n      ttlMs: number;\n      /** The client lost its context: nothing acknowledged before this call counts. */\n      full?: boolean;\n      now?: Date;\n      /** Finalize the response before recording hashes of the actual sent sections. */\n      prepare?: (exchange: AcknowledgedExchange) => SectionHash[];\n    },\n  ): Promise<AcknowledgedExchange> {\n    const now = options.now ?? new Date();\n    await mkdir(this.directory, { recursive: true, mode: 0o700 });\n    const release = await this.acquire(sessionId);\n    try {\n      const path = this.path(sessionId);\n      const ledger = await this.read(path, now);\n      let pending = ledger.pending ?? {};\n      let acknowledged = ledger.acknowledged ?? {};\n\n      let ack: AcknowledgedExchange[\"ack\"] = \"none\";\n      if (options.ack !== undefined) {\n        const confirmed = pending[options.ack];\n        if (confirmed) {\n          for (const [key, hash] of Object.entries(confirmed.records)) {\n            acknowledged[key] = [\n              { hash, sentAt: confirmed.createdAt },\n              ...(acknowledged[key] ?? []).filter((version) => version.hash !== hash),\n            ]\n              .sort((left, right) => right.sentAt.localeCompare(left.sentAt))\n              .slice(0, MAX_ACKNOWLEDGED_PER_KEY);\n          }\n          delete pending[options.ack];\n          ack = \"accepted\";\n        } else {\n          ack = \"unknown\";\n        }\n      }\n      if (options.full) {\n        acknowledged = {};\n        pending = {};\n      }\n\n      const unchanged: string[] = [];\n      const sent: Record<string, string> = {};\n      for (const section of sections) {\n        const held = acknowledged[section.key]?.some((version) => {\n          const age = now.getTime() - Date.parse(version.sentAt);\n          return version.hash === section.hash && age >= 0 && age <= options.ttlMs;\n        });\n        if (held) {\n          unchanged.push(section.key);\n        } else {\n          sent[section.key] = section.hash;\n        }\n      }\n\n      const deliveryId = generateEntityId(\"dlv\", now.getTime());\n      const exchange = { deliveryId, unchanged, ack };\n      const delivered = options.prepare?.(exchange);\n      pending[deliveryId] = {\n        createdAt: now.toISOString(),\n        records: delivered\n          ? Object.fromEntries(delivered.map(({ key, hash }) => [key, hash]))\n          : sent,\n      };\n      ledger.pending = Object.fromEntries(\n        Object.entries(pending)\n          .filter(([, item]) => now.getTime() - Date.parse(item.createdAt) <= PENDING_MAX_AGE_MS)\n          .sort((left, right) => right[1].createdAt.localeCompare(left[1].createdAt))\n          .slice(0, MAX_PENDING),\n      );\n      ledger.acknowledged = Object.fromEntries(\n        Object.entries(acknowledged)\n          .map(([key, versions]): [string, AcknowledgedVersion[]] => [\n            key,\n            versions.filter((version) => now.getTime() - Date.parse(version.sentAt) <= MAX_AGE_MS),\n          ])\n          .filter(([, versions]) => versions.length > 0)\n          .slice(0, MAX_CAPSULES),\n      );\n      await this.write(path, ledger, now);\n      return { deliveryId, unchanged, ack };\n    } finally {\n      await release();\n    }\n  }\n\n  /** Forget everything sent in a session, e.g. after the client compacted its context. */\n  async reset(sessionId: string): Promise<void> {\n    await mkdir(this.directory, { recursive: true, mode: 0o700 });\n    const release = await this.acquire(sessionId);\n    try {\n      await rm(this.path(sessionId), { force: true });\n    } finally {\n      await release();\n    }\n  }\n\n  /** Remove expired disposable state; locked sessions are left for the next pass. */\n  async pruneExpired(now = new Date()): Promise<number> {\n    let removed = 0;\n    for (const entry of await readdir(this.directory).catch(() => [])) {\n      if (!entry.endsWith(\".json\")) continue;\n      const path = join(this.directory, entry);\n      try {\n        await stat(`${path}.lock`);\n        continue;\n      } catch {\n        // No active lock.\n      }\n      try {\n        const metadata = await stat(path);\n        if (now.getTime() - metadata.mtimeMs > MAX_AGE_MS) {\n          await rm(path, { force: true });\n          removed++;\n        }\n      } catch {\n        // Another cleanup may have removed it already.\n      }\n    }\n    return removed;\n  }\n\n  private async write(path: string, ledger: LedgerFile, now: Date): Promise<void> {\n    ledger.updatedAt = now.toISOString();\n    ledger.records = Object.fromEntries(\n      Object.entries(ledger.records)\n        .sort((left, right) => right[1].lastSentAt.localeCompare(left[1].lastSentAt))\n        .slice(0, MAX_CAPSULES),\n    );\n    await writeAtomic(path, `${JSON.stringify(ledger, null, 2)}\\n`);\n  }\n\n  private async read(path: string, now: Date): Promise<LedgerFile> {\n    try {\n      const parsed = JSON.parse(await readFile(path, \"utf8\")) as LedgerFile;\n      if (parsed.version !== VERSION || typeof parsed.records !== \"object\") return empty(now);\n      const records = Object.fromEntries(\n        Object.entries(parsed.records).filter(([, record]) => {\n          const age = now.getTime() - Date.parse(record.lastSentAt);\n          return Number.isFinite(age) && age <= MAX_AGE_MS;\n        }),\n      );\n      const pending =\n        parsed.pending && typeof parsed.pending === \"object\" ? parsed.pending : undefined;\n      const acknowledged =\n        parsed.acknowledged && typeof parsed.acknowledged === \"object\"\n          ? Object.fromEntries(\n              Object.entries(parsed.acknowledged).filter(([, versions]) => Array.isArray(versions)),\n            )\n          : undefined;\n      return {\n        version: VERSION,\n        updatedAt: parsed.updatedAt,\n        records,\n        ...(pending ? { pending } : {}),\n        ...(acknowledged ? { acknowledged } : {}),\n      };\n    } catch {\n      return empty(now);\n    }\n  }\n\n  private path(sessionId: string): string {\n    // The full identity participates in the key. Legacy sanitized filenames\n    // are intentionally ignored, so a fresh session cannot inherit collisions.\n    return join(this.directory, `${digest(sessionId)}.json`);\n  }\n\n  private async acquire(sessionId: string): Promise<() => Promise<void>> {\n    const lock = `${this.path(sessionId)}.lock`;\n    for (let attempt = 0; ; attempt++) {\n      try {\n        await mkdir(lock);\n        return async () => rm(lock, { recursive: true, force: true });\n      } catch (error) {\n        if ((error as NodeJS.ErrnoException).code !== \"EEXIST\" || attempt >= 200) throw error;\n        try {\n          const age = Date.now() - (await stat(lock)).mtimeMs;\n          if (age > STALE_LOCK_MS) {\n            await rm(lock, { recursive: true, force: true });\n            continue;\n          }\n        } catch {\n          // The owner may have released the lock between checks.\n        }\n        await new Promise((resolveWait) => setTimeout(resolveWait, 10));\n      }\n    }\n  }\n}\n\nfunction empty(now: Date): LedgerFile {\n  return { version: VERSION, updatedAt: now.toISOString(), records: {} };\n}\n\nfunction digest(text: string): string {\n  return createHash(\"sha256\").update(text).digest(\"hex\");\n}\n","import { access, readFile } from \"node:fs/promises\";\nimport { basename, dirname, extname, join } from \"node:path\";\n\n/**\n * Which test covers a file and how this repo runs its tests, from naming\n * conventions and project markers only. Agents otherwise spend turns finding\n * both; a wrong guess costs one failed command, so first match wins.\n */\nexport function findCoveringTest(path: string, paths: ReadonlySet<string>): string | null {\n  return coveringTestCandidates(path).find((candidate) => paths.has(candidate)) ?? null;\n}\n\n/** Conventional covering-test paths for `path`, most specific first. */\nexport function coveringTestCandidates(path: string): string[] {\n  const ext = extname(path);\n  const stem = basename(path, ext);\n  const dir = dirname(path);\n  const join2 = (...parts: string[]) => parts.filter((part) => part && part !== \".\").join(\"/\");\n  // `src/a/x.ts` mirrors to `test/a/x.test.ts`: drop a leading source root.\n  const mirrored = dir.replace(/^(src|lib|app)(\\/|$)/, \"\");\n  return ext === \".py\"\n    ? [\n        join2(dir, `test_${stem}.py`),\n        join2(dir, `${stem}_test.py`),\n        join2(dir, \"tests\", `test_${stem}.py`),\n        // `src/pkg/sub/x.py` → `tests/pkg/sub/test_x.py`, `tests/sub/test_x.py`, `tests/test_x.py`.\n        join2(\"tests\", mirrored, `test_${stem}.py`),\n        join2(\"tests\", mirrored.replace(/^[^/]+\\/?/, \"\"), `test_${stem}.py`),\n        join2(\"tests\", `test_${stem}.py`),\n      ]\n    : ext === \".go\"\n      ? [join2(dir, `${stem}_test.go`)]\n      : [\n          join2(dir, `${stem}.test${ext}`),\n          join2(dir, `${stem}.spec${ext}`),\n          join2(dir, \"__tests__\", `${stem}.test${ext}`),\n          join2(dir, \"__tests__\", `${stem}${ext}`),\n          join2(\"test\", mirrored, `${stem}.test${ext}`),\n          join2(\"tests\", mirrored, `${stem}.test${ext}`),\n        ];\n}\n\nconst NPM_PLACEHOLDER = /no test specified/;\n\nexport async function detectTestCommand(repositoryRoot: string): Promise<string | null> {\n  const exists = (file: string) =>\n    access(join(repositoryRoot, file)).then(\n      () => true,\n      () => false,\n    );\n  try {\n    const pkg = JSON.parse(await readFile(join(repositoryRoot, \"package.json\"), \"utf8\")) as {\n      scripts?: Record<string, unknown>;\n      packageManager?: unknown;\n    };\n    const script = pkg.scripts?.test;\n    if (typeof script === \"string\" && script.trim() && !NPM_PLACEHOLDER.test(script)) {\n      const declared =\n        typeof pkg.packageManager === \"string\" ? pkg.packageManager.split(/[\\s@]/, 1)[0] : \"\";\n      // `bun test` is Bun's own runner, not the package's test script.\n      if (declared === \"bun\") return \"bun run test\";\n      if (declared && [\"npm\", \"pnpm\", \"yarn\"].includes(declared)) return `${declared} test`;\n      if (await exists(\"pnpm-lock.yaml\")) return \"pnpm test\";\n      if (await exists(\"yarn.lock\")) return \"yarn test\";\n      if ((await exists(\"bun.lockb\")) || (await exists(\"bun.lock\"))) return \"bun run test\";\n      return \"npm test\";\n    }\n  } catch {\n    // No or unreadable package.json: try other ecosystems.\n  }\n  for (const marker of [\"pyproject.toml\", \"pytest.ini\", \"setup.cfg\"]) {\n    if (await exists(marker)) return \"pytest\";\n  }\n  if (await exists(\"go.mod\")) return \"go test ./...\";\n  if (await exists(\"Cargo.toml\")) return \"cargo test\";\n  return null;\n}\n"],"mappings":"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","names":["readFile","join","join2"]}

package/dist/chunk-BTTQWSDS.js

@@ -0,0 +1,372 @@
+import {
+  modelCacheDir
+} from "./chunk-3QGW53GD.js";
+
+// src/llm/local.ts
+import { createHash } from "crypto";
+import { createWriteStream } from "fs";
+import { mkdir, rename, rm, stat, statfs, utimes, writeFile } from "fs/promises";
+import { availableParallelism, freemem, totalmem } from "os";
+import { dirname, join } from "path";
+import { Readable } from "stream";
+import { pipeline } from "stream/promises";
+import { z } from "zod";
+var GB = 1024 ** 3;
+var LOCAL_MODELS = {
+  default: {
+    size: "default",
+    id: "qwen3-0.6b-q4_k_m",
+    repo: "unsloth/Qwen3-0.6B-GGUF",
+    revision: "50968a4468ef4233ed78cd7c3de230dd1d61a56b",
+    file: "Qwen3-0.6B-Q4_K_M.gguf",
+    bytes: 396705472,
+    sha256: "ac2d97712095a558e31573f62f466a3f9d93990898b0ec79d7c974c1780d524a",
+    ramBytes: 1 * GB,
+    noThink: true
+  },
+  better: {
+    size: "better",
+    id: "qwen3-1.7b-q4_k_m",
+    repo: "unsloth/Qwen3-1.7B-GGUF",
+    revision: "d7f544eead698dbd1f15126ef60b45a1e1933222",
+    file: "Qwen3-1.7B-Q4_K_M.gguf",
+    bytes: 1107409472,
+    sha256: "b139949c5bd74937ad8ed8c8cf3d9ffb1e99c866c823204dc42c0d91fa181897",
+    ramBytes: 2.2 * GB,
+    noThink: true
+  }
+};
+var LLAMA_RUNTIME = "node-llama-cpp@3.22.3";
+function localModelPath(spec) {
+  return join(modelCacheDir(), "gguf", spec.file);
+}
+async function installedLocalModel(preferred) {
+  if (process.env.CODEBUDDY_LOCAL_LLM === "0") return null;
+  const order = [...preferred ? [preferred] : [], "default", "better"];
+  for (const size of new Set(order)) {
+    const spec = LOCAL_MODELS[size];
+    const info = await stat(localModelPath(spec)).catch(() => null);
+    if (info?.isFile() && info.size === spec.bytes) return spec;
+  }
+  return null;
+}
+async function localRuntimeAvailable() {
+  try {
+    await importRuntime();
+    return true;
+  } catch {
+    return false;
+  }
+}
+function machineCanCard() {
+  if (totalmem() < 4 * GB) {
+    return { ok: false, reason: `${formatBytes(totalmem())} RAM (setup installs it from 4 GB)` };
+  }
+  if (availableParallelism() < 2) return { ok: false, reason: "a single CPU core" };
+  return { ok: true };
+}
+async function checkLocalModelResources(spec) {
+  const directory = modelCacheDir();
+  await mkdir(directory, { recursive: true });
+  const fs = await statfs(directory).catch(() => null);
+  if (fs && fs.bavail * fs.bsize < spec.bytes * 1.1) {
+    return {
+      ok: false,
+      reason: `needs ${formatBytes(spec.bytes * 1.1)} free in ${directory}, ${formatBytes(fs.bavail * fs.bsize)} available`
+    };
+  }
+  if (totalmem() < spec.ramBytes * 2) {
+    return {
+      ok: false,
+      reason: `needs about ${formatBytes(spec.ramBytes)} of RAM while loaded; this machine has ${formatBytes(totalmem())} in total`
+    };
+  }
+  return { ok: true };
+}
+async function downloadLocalModel(spec, onProgress, fetchImpl = fetch) {
+  const target = localModelPath(spec);
+  await mkdir(dirname(target), { recursive: true });
+  const partial = `${target}.partial`;
+  const url = `https://huggingface.co/${spec.repo}/resolve/${spec.revision}/${spec.file}`;
+  const response = await fetchImpl(url);
+  if (!response.ok || !response.body) {
+    throw new Error(`download failed: HTTP ${response.status} for ${url}`);
+  }
+  const hash = createHash("sha256");
+  let received = 0;
+  const source = Readable.fromWeb(response.body);
+  source.on("data", (chunk) => {
+    hash.update(chunk);
+    received += chunk.length;
+    onProgress?.(received, spec.bytes);
+  });
+  try {
+    await pipeline(source, createWriteStream(partial));
+    const digest = hash.digest("hex");
+    if (received !== spec.bytes || digest !== spec.sha256) {
+      throw new Error(
+        `checksum mismatch for ${spec.file} (got ${received} bytes, sha256 ${digest.slice(0, 12)}\u2026); not installed`
+      );
+    }
+    await rename(partial, target);
+  } finally {
+    await rm(partial, { force: true });
+  }
+  return target;
+}
+async function removeLocalModels() {
+  const removed = [];
+  for (const spec of Object.values(LOCAL_MODELS)) {
+    const path = localModelPath(spec);
+    if (await stat(path).catch(() => null)) {
+      await rm(path, { force: true });
+      removed.push(spec.id);
+    }
+  }
+  return removed;
+}
+var loading = null;
+var loaded = null;
+var queue = Promise.resolve();
+var grammars = /* @__PURE__ */ new Map();
+async function importRuntime() {
+  const specifier = process.env.CODEBUDDY_LLAMA_RUNTIME ?? "node-llama-cpp";
+  return await import(specifier);
+}
+var CONTEXT_TOKENS = 4096;
+function generationThreads() {
+  const configured = Number(process.env.CODEBUDDY_LLM_THREADS);
+  if (Number.isInteger(configured) && configured > 0) return configured;
+  return Math.max(1, availableParallelism() - 1);
+}
+async function load(spec) {
+  if (loaded?.spec.id === spec.id) return loaded;
+  if (!loading) {
+    loading = (async () => {
+      const runtime = await importRuntime();
+      const llama = await runtime.getLlama({ gpu: "auto" });
+      const model = await llama.loadModel({ modelPath: localModelPath(spec) });
+      const context = await model.createContext({
+        contextSize: CONTEXT_TOKENS,
+        threads: generationThreads()
+      });
+      loaded = { spec, llama, model, context, sequence: context.getSequence(), runtime };
+      return loaded;
+    })().finally(() => {
+      loading = null;
+    });
+  }
+  return loading;
+}
+var IDLE_UNLOAD_MS = 6e4;
+var idleTimer = null;
+var running = 0;
+function scheduleUnload() {
+  if (idleTimer) clearTimeout(idleTimer);
+  idleTimer = setTimeout(() => void unloadLocalModel(), IDLE_UNLOAD_MS);
+  idleTimer.unref();
+}
+async function unloadLocalModel() {
+  if (idleTimer) clearTimeout(idleTimer);
+  idleTimer = null;
+  const current = loaded;
+  if (!current || running > 0) return;
+  loaded = null;
+  grammars.clear();
+  await current.context.dispose().catch(() => {
+  });
+  await current.model.dispose().catch(() => {
+  });
+}
+function isLocalModelWarm() {
+  return loaded !== null;
+}
+async function warmLocalModel(spec) {
+  try {
+    await load(spec);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function localChatJson(spec, request) {
+  const started = Date.now();
+  const fail = (reason, detail) => ({
+    ok: false,
+    reason,
+    detail: detail.slice(0, 300),
+    latencyMs: Date.now() - started
+  });
+  let model;
+  try {
+    model = await withDeadline(load(spec), request.deadlineMs);
+  } catch (error) {
+    return error.name === "TimeoutError" ? fail("timeout", "model still loading") : fail("disabled", `local model unavailable: ${error.message}`);
+  }
+  const run = async () => {
+    running++;
+    try {
+      return await generate();
+    } finally {
+      running--;
+      scheduleUnload();
+    }
+  };
+  const generate = async () => {
+    if (!loaded) model = await load(spec);
+    const remaining = request.deadlineMs - (Date.now() - started);
+    if (remaining <= 0) return fail("timeout", `no answer within ${request.deadlineMs} ms`);
+    const grammar = await grammarFor(model.llama, request.jsonSchema ?? request.schema);
+    const session = new model.runtime.LlamaChatSession({
+      contextSequence: model.sequence,
+      autoDisposeSequence: false,
+      systemPrompt: request.system
+    });
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), remaining);
+    try {
+      const text = await session.prompt(`${spec.noThink ? "/no_think\n" : ""}${request.user}`, {
+        grammar,
+        maxTokens: request.maxTokens,
+        temperature: 0,
+        ...spec.noThink ? { budgets: { thoughtTokens: 0 } } : {},
+        signal: controller.signal,
+        stopOnAbortSignal: true
+      });
+      if (controller.signal.aborted) {
+        return fail("timeout", `no answer within ${request.deadlineMs} ms`);
+      }
+      let value;
+      try {
+        value = JSON.parse(text);
+      } catch {
+        return fail("invalid", `output is not JSON: ${text.slice(0, 120)}`);
+      }
+      const parsed = request.schema.safeParse(value);
+      if (!parsed.success)
+        return fail("invalid", `output failed validation: ${text.slice(0, 120)}`);
+      return {
+        ok: true,
+        value: parsed.data,
+        model: spec.id,
+        latencyMs: Date.now() - started,
+        tokens: Math.ceil((request.system.length + request.user.length + text.length) / 4),
+        cached: false
+      };
+    } catch (error) {
+      return controller.signal.aborted ? fail("timeout", `no answer within ${request.deadlineMs} ms`) : fail("invalid", String(error?.message ?? error));
+    } finally {
+      clearTimeout(timer);
+      session.dispose({ disposeSequence: false });
+    }
+  };
+  const result = queue.then(run, run);
+  queue = result.catch(() => void 0);
+  return result;
+}
+async function grammarFor(llama, schema) {
+  let grammar = grammars.get(schema);
+  if (!grammar) {
+    grammar = (async () => {
+      try {
+        const json = schema instanceof z.ZodType ? z.toJSONSchema(schema, { io: "input", unrepresentable: "any" }) : schema;
+        return await llama.createGrammarForJsonSchema(stripSchemaMeta(json));
+      } catch {
+        return llama.getGrammarFor("json");
+      }
+    })();
+    grammars.set(schema, grammar);
+  }
+  return grammar;
+}
+function stripSchemaMeta(value) {
+  if (Array.isArray(value)) return value.map(stripSchemaMeta);
+  if (!value || typeof value !== "object") return value;
+  const out = {};
+  for (const [key, child] of Object.entries(value)) {
+    if (key === "$schema" || key === "default" || key === "additionalProperties") continue;
+    out[key] = stripSchemaMeta(child);
+  }
+  return out;
+}
+function withDeadline(promise, ms) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(
+      () => reject(Object.assign(new Error("deadline"), { name: "TimeoutError" })),
+      ms
+    );
+    promise.then(
+      (value) => {
+        clearTimeout(timer);
+        resolve(value);
+      },
+      (error) => {
+        clearTimeout(timer);
+        reject(error);
+      }
+    );
+  });
+}
+var FOREGROUND_WINDOW_MS = 2e3;
+var FOREGROUND_MAX_WAIT_MS = 15e3;
+function foregroundPath(root) {
+  return join(root, ".codebuddy", "cache", "foreground");
+}
+async function markForeground(root) {
+  const path = foregroundPath(root);
+  const now = /* @__PURE__ */ new Date();
+  try {
+    await utimes(path, now, now);
+  } catch {
+    await mkdir(dirname(path), { recursive: true }).catch(() => {
+    });
+    await writeFile(path, "").catch(() => {
+    });
+  }
+}
+async function waitForForeground(root, signal) {
+  const until = Date.now() + FOREGROUND_MAX_WAIT_MS;
+  while (Date.now() < until && !signal?.aborted) {
+    const info = await stat(foregroundPath(root)).catch(() => null);
+    if (!info || Date.now() - info.mtimeMs > FOREGROUND_WINDOW_MS) return;
+    await new Promise((resolve) => setTimeout(resolve, 250));
+  }
+}
+async function localModelStatus(preferred) {
+  const installed = await installedLocalModel(preferred);
+  return {
+    runtime: await localRuntimeAvailable(),
+    installed,
+    path: installed ? localModelPath(installed) : null
+  };
+}
+function formatBytes(bytes) {
+  return bytes >= GB ? `${(bytes / GB).toFixed(1)} GB` : `${Math.round(bytes / 1024 ** 2)} MB`;
+}
+function freeMemory() {
+  return freemem();
+}
+
+export {
+  LOCAL_MODELS,
+  LLAMA_RUNTIME,
+  localModelPath,
+  installedLocalModel,
+  localRuntimeAvailable,
+  machineCanCard,
+  checkLocalModelResources,
+  downloadLocalModel,
+  removeLocalModels,
+  generationThreads,
+  IDLE_UNLOAD_MS,
+  unloadLocalModel,
+  isLocalModelWarm,
+  warmLocalModel,
+  localChatJson,
+  markForeground,
+  waitForForeground,
+  localModelStatus,
+  formatBytes,
+  freeMemory
+};
+//# sourceMappingURL=chunk-BTTQWSDS.js.map