@remnic/core 1.1.31 → 9.3.516

package/dist/chunk-EAZGEEG2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp-memory-inspector-app.ts"],"sourcesContent":["import type { EngramAccessRecallResponse } from \"./access-service.js\";\nimport type { ActionConfidenceRequest } from \"./access-schema.js\";\nimport type { RecallXrayResult, RecallXraySnapshot } from \"./recall-xray.js\";\nimport type { ActionConfidenceResult } from \"./action-confidence.js\";\nimport type { RetrievedMemoryProvenance } from \"./memory-provenance.js\";\n\nexport const REMNIC_CHATGPT_MEMORY_INSPECTOR_TOOL =\n  \"engram.chatgpt_memory_inspector\" as const;\nexport const REMNIC_CHATGPT_MEMORY_INSPECTOR_CANONICAL_TOOL =\n  \"remnic.chatgpt_memory_inspector\" as const;\nexport const REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_URI =\n  \"ui://remnic/memory-inspector.v1.html\" as const;\nexport const REMNIC_CHATGPT_MEMORY_INSPECTOR_MIME_TYPE =\n  \"text/html;profile=mcp-app\" as const;\n\nexport interface RemnicChatGptMemoryInspectorInput {\n  query: string;\n  sessionKey?: string;\n  namespace?: string;\n  currentContextScopes?: string[];\n}\n\nexport interface RemnicChatGptMemoryCard {\n  id: string;\n  path?: string;\n  category?: string;\n  status?: string;\n  preview?: string;\n  servedBy?: string;\n  score?: number;\n  source?: string;\n  scope?: string;\n  retrievalReason?: string;\n  confidence?: number;\n  stale?: boolean;\n  corrected?: boolean;\n  safeToUse?: boolean;\n  safety?: string;\n  safetyReasons: string[];\n  userContextScopes: string[];\n}\n\nexport interface RemnicChatGptMemoryInspectorResult {\n  app: {\n    name: \"Remnic Memory Inspector\";\n    resourceUri: typeof REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_URI;\n    archetype: \"vanilla-widget\";\n  };\n  query: string;\n  sessionKey?: string;\n  namespace: string;\n  safeRecallPreview: string;\n  memoryCount: number;\n  memoryIds: string[];\n  memories: RemnicChatGptMemoryCard[];\n  actionConfidence: ActionConfidenceResult;\n  affordances: Array<{\n    id: \"why\" | \"correct\" | \"forget\" | \"scope\";\n    label: string;\n    followUpPrompt: string;\n  }>;\n  guidance: {\n    correctionTool: \"remnic.suggestion_submit\";\n    forgetTool: \"remnic.memory_action_apply\";\n    scopeTool: \"remnic.memory_action_apply\";\n    note: string;\n  };\n}\n\nexport function buildChatGptMemoryInspectorActionRequest(\n  input: RemnicChatGptMemoryInspectorInput,\n  recall: EngramAccessRecallResponse,\n  xray: RecallXraySnapshot | null,\n): ActionConfidenceRequest {\n  const provenances = xray === null\n    ? recall.results.map(missingRecallProvenance)\n    : xray.results.map((result) => result.provenance ?? missingProvenance(result));\n  const hasUnsafeOrMissingProvenance = provenances.some(\n    (provenance) => provenance.safeToUse === false || provenance.safety === \"blocked\",\n  ) || provenances.length < recall.count;\n\n  const request: ActionConfidenceRequest = {\n    intendedAction: `Use Remnic memory to answer: ${input.query}`,\n    risk: \"medium\",\n    contextReadiness:\n      recall.count > 0 && !hasUnsafeOrMissingProvenance ? \"sufficient\" : \"partial\",\n    retrievedMemories: provenances.map((provenance) => ({\n      source: provenance.source,\n      created: provenance.created,\n      updated: provenance.updated,\n      scope: provenance.scope,\n      userContextScopes: provenance.userContextScopes,\n      retrievalReason: provenance.retrievalReason,\n      confidence: provenance.confidence,\n      stale: provenance.stale,\n      corrected: provenance.corrected,\n      correctionState: provenance.correctionState,\n      safeToUse: provenance.safeToUse,\n      safety: provenance.safety,\n      safetyReasons: provenance.safetyReasons,\n    })),\n  };\n  const confidence = provenances.length > 0\n    ? average(provenances.map((provenance) => provenance.confidence ?? 0.5))\n    : undefined;\n  if (confidence !== undefined) request.confidence = confidence;\n  if (input.currentContextScopes !== undefined) {\n    request.currentContextScopes = input.currentContextScopes;\n  }\n  return request;\n}\n\nexport function buildChatGptMemoryInspectorResult(\n  input: RemnicChatGptMemoryInspectorInput,\n  recall: EngramAccessRecallResponse,\n  xray: RecallXraySnapshot | null,\n  actionConfidence: ActionConfidenceResult,\n): RemnicChatGptMemoryInspectorResult {\n  const xrayUnavailable = xray === null;\n  const xrayById = new Map<string, RecallXrayResult>();\n  const xrayByPath = new Map<string, RecallXrayResult>();\n  for (const result of xray?.results ?? []) {\n    xrayById.set(result.memoryId, result);\n    xrayByPath.set(result.path, result);\n  }\n  const matchXrayResult = (summary: EngramAccessRecallResponse[\"results\"][number]) =>\n    (summary.path ? xrayByPath.get(summary.path) : undefined)\n    ?? xrayById.get(summary.id);\n  const matchedXrayResults = recall.results.map(matchXrayResult);\n\n  const memories = recall.results.slice(0, 8).map((summary) => {\n    const xrayResult = matchXrayResult(summary);\n    const provenance = xrayResult?.provenance;\n    const unverified = !xrayUnavailable && provenance === undefined;\n    const blocked = provenance?.safety === \"blocked\";\n    const preview = xrayUnavailable\n      ? \"Preview withheld: X-ray provenance was unavailable for this recall.\"\n      : unverified\n        ? \"Preview withheld: X-ray provenance was missing for this memory.\"\n      : blocked\n        ? \"Preview withheld: this memory is blocked in the current context.\"\n        : summary.preview;\n    return {\n      id: summary.id,\n      path: summary.path,\n      category: summary.category,\n      status: summary.status,\n      preview,\n      servedBy: xrayResult?.servedBy,\n      score: xrayResult?.scoreDecomposition.final,\n      source: provenance?.source,\n      scope: provenance?.scope,\n      retrievalReason: provenance?.retrievalReason,\n      confidence: provenance?.confidence,\n      stale: provenance?.stale,\n      corrected: provenance?.corrected,\n      safeToUse: provenance?.safeToUse ?? (unverified ? false : undefined),\n      safety: provenance?.safety ?? (unverified ? \"blocked\" : undefined),\n      safetyReasons: provenance?.safetyReasons\n        ?? (unverified ? [\"X-ray provenance was missing for this memory.\"] : []),\n      userContextScopes: provenance?.userContextScopes ?? [],\n    };\n  });\n  const blockedCount = matchedXrayResults\n    .filter((result) => result?.provenance?.safety === \"blocked\")\n    .length;\n  const missingProvenanceCount = xrayUnavailable\n    ? 0\n    : matchedXrayResults\n      .filter((result) => result?.provenance === undefined)\n    .length;\n  const safeRecallPreview = xrayUnavailable\n    ? \"Recall preview withheld: X-ray provenance was unavailable, so memory safety could not be verified.\"\n    : blockedCount > 0 || missingProvenanceCount > 0\n      ? formatUnsafeRecallPreview(blockedCount, missingProvenanceCount)\n      : truncate(recall.context, 1_500);\n\n  const primaryMemoryId = memories[0]?.id ?? \"<memory-id>\";\n  return {\n    app: {\n      name: \"Remnic Memory Inspector\",\n      resourceUri: REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_URI,\n      archetype: \"vanilla-widget\",\n    },\n    query: recall.query || input.query,\n    ...(input.sessionKey ? { sessionKey: input.sessionKey } : {}),\n    namespace: recall.namespace,\n    safeRecallPreview,\n    memoryCount: recall.count,\n    memoryIds: recall.memoryIds,\n    memories,\n    actionConfidence,\n    affordances: [\n      {\n        id: \"why\",\n        label: \"Why retrieved\",\n        followUpPrompt:\n          `Explain why Remnic retrieved memory ${primaryMemoryId} for \"${input.query}\" using its provenance, score, safety, and retrieval reason.`,\n      },\n      {\n        id: \"correct\",\n        label: \"Correct\",\n        followUpPrompt:\n          `Help me correct memory ${primaryMemoryId}. Draft a replacement or correction and use remnic.suggestion_submit with dryRun first.`,\n      },\n      {\n        id: \"forget\",\n        label: \"Forget\",\n        followUpPrompt:\n          `Help me forget or quarantine memory ${primaryMemoryId}. Ask me to confirm before using any destructive or persistent Remnic action.`,\n      },\n      {\n        id: \"scope\",\n        label: \"Scope\",\n        followUpPrompt:\n          `Help me scope memory ${primaryMemoryId} so it is only used in the right context. Prefer a dry-run Remnic action before any persistent change.`,\n      },\n    ],\n    guidance: {\n      correctionTool: \"remnic.suggestion_submit\",\n      forgetTool: \"remnic.memory_action_apply\",\n      scopeTool: \"remnic.memory_action_apply\",\n      note:\n        \"The demo only proposes correction, forget, and scoping flows. The widget sends follow-up prompts; persistent changes still require an explicit tool call and user confirmation.\",\n    },\n  };\n}\n\nexport const REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_HTML = `\n<div id=\"root\" class=\"remnic-app\">Loading Remnic memory inspector...</div>\n<style>\n  :root {\n    color-scheme: light dark;\n    --bg: #f8faf8;\n    --panel: #ffffff;\n    --text: #17201b;\n    --muted: #56635b;\n    --line: #d8e0da;\n    --accent: #2f7d57;\n    --warn: #9a5b14;\n    --bad: #9c2b2b;\n  }\n  @media (prefers-color-scheme: dark) {\n    :root {\n      --bg: #101512;\n      --panel: #18201b;\n      --text: #edf4ef;\n      --muted: #a8b6ad;\n      --line: #304036;\n      --accent: #75c79a;\n      --warn: #e0ad63;\n      --bad: #f08a8a;\n    }\n  }\n  body { margin: 0; background: var(--bg); color: var(--text); font: 14px/1.45 system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif; }\n  .remnic-app { padding: 14px; display: grid; gap: 12px; }\n  .header, .section, .memory { background: var(--panel); border: 1px solid var(--line); border-radius: 8px; padding: 12px; }\n  .title { font-size: 16px; font-weight: 650; margin: 0; }\n  .muted { color: var(--muted); }\n  .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 8px; }\n  .pill { display: inline-flex; align-items: center; gap: 4px; border: 1px solid var(--line); border-radius: 999px; padding: 2px 8px; margin: 2px 4px 2px 0; color: var(--muted); }\n  .safe { color: var(--accent); }\n  .review { color: var(--warn); }\n  .blocked { color: var(--bad); }\n  .memory { display: grid; gap: 8px; }\n  .memory-title { display: flex; justify-content: space-between; gap: 12px; align-items: baseline; font-weight: 650; }\n  .preview { white-space: pre-wrap; overflow-wrap: anywhere; }\n  .actions { display: flex; flex-wrap: wrap; gap: 8px; }\n  button { border: 1px solid var(--line); background: transparent; color: var(--text); border-radius: 6px; padding: 6px 9px; font: inherit; cursor: pointer; }\n  button:hover { border-color: var(--accent); }\n  pre { white-space: pre-wrap; overflow-wrap: anywhere; margin: 0; color: var(--muted); }\n</style>\n<script>\n  const root = document.getElementById(\"root\");\n\n  function escapeHtml(value) {\n    return String(value ?? \"\").replace(/[&<>\"']/g, (char) => ({\n      \"&\": \"&amp;\",\n      \"<\": \"&lt;\",\n      \">\": \"&gt;\",\n      '\"': \"&quot;\",\n      \"'\": \"&#39;\",\n    }[char]));\n  }\n\n  function statusClass(value) {\n    if (value === \"blocked\" || value === false) return \"blocked\";\n    if (value === \"requires-review\") return \"review\";\n    return \"safe\";\n  }\n\n  function followUp(prompt) {\n    if (window.openai?.sendFollowUpMessage) {\n      window.openai.sendFollowUpMessage({ prompt, scrollToBottom: true });\n      return;\n    }\n    window.parent.postMessage({\n      jsonrpc: \"2.0\",\n      method: \"ui/message\",\n      params: {\n        role: \"user\",\n        content: [{ type: \"text\", text: prompt }],\n      },\n    }, \"*\");\n  }\n\n  function actionButtons(actions) {\n    return (actions ?? []).map((action) =>\n      '<button type=\"button\" data-prompt=\"' + escapeHtml(action.followUpPrompt) + '\">' +\n      escapeHtml(action.label) +\n      '</button>'\n    ).join(\"\");\n  }\n\n  function render(payload) {\n    const data = payload?.structuredContent ?? payload ?? window.openai?.toolOutput ?? {};\n    const confidence = data.actionConfidence ?? {};\n    const memories = Array.isArray(data.memories) ? data.memories : [];\n    root.innerHTML = [\n      '<section class=\"header\">',\n        '<p class=\"title\">Remnic Memory Inspector</p>',\n        '<div class=\"muted\">' + escapeHtml(data.query ?? \"No query\") + '</div>',\n        '<div class=\"grid\">',\n          '<div><strong>Namespace</strong><br><span class=\"muted\">' + escapeHtml(data.namespace ?? \"default\") + '</span></div>',\n          '<div><strong>Decision</strong><br><span class=\"' + statusClass(confidence.decision) + '\">' + escapeHtml(confidence.decision ?? \"unknown\") + '</span></div>',\n          '<div><strong>Memories</strong><br><span class=\"muted\">' + escapeHtml(data.memoryCount ?? memories.length) + '</span></div>',\n        '</div>',\n      '</section>',\n      '<section class=\"section\">',\n        '<strong>Safe recall preview</strong>',\n        '<pre>' + escapeHtml(data.safeRecallPreview ?? \"\") + '</pre>',\n      '</section>',\n      '<section class=\"section actions\">',\n        actionButtons(data.affordances),\n      '</section>',\n      memories.map((memory) => [\n        '<article class=\"memory\">',\n          '<div class=\"memory-title\"><span>' + escapeHtml(memory.id) + '</span><span class=\"' + statusClass(memory.safety) + '\">' + escapeHtml(memory.safety ?? \"safe\") + '</span></div>',\n          '<div class=\"preview\">' + escapeHtml(memory.preview ?? \"\") + '</div>',\n          '<div>',\n            '<span class=\"pill\">source ' + escapeHtml(memory.source ?? \"unknown\") + '</span>',\n            '<span class=\"pill\">scope ' + escapeHtml(memory.scope ?? \"unknown\") + '</span>',\n            '<span class=\"pill\">reason ' + escapeHtml(memory.retrievalReason ?? memory.servedBy ?? \"unknown\") + '</span>',\n            '<span class=\"pill\">confidence ' + escapeHtml(memory.confidence ?? \"n/a\") + '</span>',\n          '</div>',\n          '<div class=\"muted\">' + escapeHtml((memory.safetyReasons ?? []).join(\"; \")) + '</div>',\n        '</article>',\n      ].join(\"\")).join(\"\"),\n    ].join(\"\");\n\n    root.querySelectorAll(\"button[data-prompt]\").forEach((button) => {\n      button.addEventListener(\"click\", () => followUp(button.getAttribute(\"data-prompt\") ?? \"\"));\n    });\n  }\n\n  render(window.openai?.toolOutput);\n\n  window.addEventListener(\"message\", (event) => {\n    if (event.source !== window.parent) return;\n    const message = event.data;\n    if (!message || message.jsonrpc !== \"2.0\") return;\n    if (message.method === \"ui/notifications/tool-result\") {\n      render(message.params);\n    }\n  }, { passive: true });\n\n  window.addEventListener(\"openai:set_globals\", (event) => {\n    render(event.detail?.globals?.toolOutput ?? window.openai?.toolOutput);\n  }, { passive: true });\n</script>\n`.trim();\n\nfunction average(values: number[]): number | undefined {\n  if (values.length === 0) return undefined;\n  return values.reduce((sum, value) => sum + value, 0) / values.length;\n}\n\nfunction missingProvenance(result: RecallXrayResult): RetrievedMemoryProvenance {\n  return {\n    source: \"unknown\",\n    scope: \"unknown\",\n    userContextScopes: [],\n    retrievalReason: `X-ray provenance missing for ${result.memoryId || result.path}`,\n    confidence: 0,\n    stale: false,\n    corrected: false,\n    correctionState: \"none\",\n    safeToUse: false,\n    safety: \"blocked\",\n    safetyReasons: [\"X-ray provenance was missing for this memory.\"],\n  };\n}\n\nfunction missingRecallProvenance(\n  summary: EngramAccessRecallResponse[\"results\"][number],\n): RetrievedMemoryProvenance {\n  return {\n    source: \"unknown\",\n    scope: \"unknown\",\n    userContextScopes: [],\n    retrievalReason: `X-ray provenance unavailable for ${summary.id || summary.path}`,\n    confidence: 0,\n    stale: false,\n    corrected: false,\n    correctionState: \"none\",\n    safeToUse: false,\n    safety: \"blocked\",\n    safetyReasons: [\"X-ray provenance was unavailable for this recall.\"],\n  };\n}\n\nfunction formatUnsafeRecallPreview(\n  blockedCount: number,\n  missingProvenanceCount: number,\n): string {\n  const reasons: string[] = [];\n  if (blockedCount > 0) {\n    reasons.push(`${blockedCount} retrieved ${memoryNoun(blockedCount)} ${isAre(blockedCount)} blocked`);\n  }\n  if (missingProvenanceCount > 0) {\n    reasons.push(\n      `${missingProvenanceCount} retrieved ${memoryNoun(missingProvenanceCount)} ${isAre(missingProvenanceCount)} missing X-ray provenance`,\n    );\n  }\n  return `Recall preview withheld: ${joinReasons(reasons)} in the current context.`;\n}\n\nfunction memoryNoun(count: number): string {\n  return count === 1 ? \"memory\" : \"memories\";\n}\n\nfunction isAre(count: number): string {\n  return count === 1 ? \"is\" : \"are\";\n}\n\nfunction joinReasons(reasons: string[]): string {\n  if (reasons.length <= 1) return reasons[0] ?? \"memory safety could not be verified\";\n  return `${reasons.slice(0, -1).join(\", \")} and ${reasons[reasons.length - 1]}`;\n}\n\nfunction truncate(value: string, maxChars: number): string {\n  if (value.length <= maxChars) return value;\n  return `${value.slice(0, Math.max(0, maxChars - 3))}...`;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-TPB3I2AC.js → chunk-ECZU5BJH.js}

@@ -61,10 +61,25 @@ ${summary}
 `;
 }
 function parseIsoDate(iso) {
-  return iso.slice(0, 10);
+  return parseTmtInstant(iso)?.date ?? "";
 }
 function parseIsoHour(iso) {
-  return iso.slice(11, 13);
+  return parseTmtInstant(iso)?.hour ?? "";
+}
+function parseTmtInstant(iso) {
+  if (typeof iso !== "string") return null;
+  const value = iso.trim();
+  if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?(?:Z|[+-]\d{2}:\d{2})$/.test(value)) {
+    return null;
+  }
+  const dateValue = new Date(value);
+  if (!Number.isFinite(dateValue.getTime())) return null;
+  const utc = dateValue.toISOString();
+  return {
+    date: utc.slice(0, 10),
+    hour: utc.slice(11, 13),
+    dateValue
+  };
 }
 function isoWeekKey(date) {
   const d = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));
@@ -102,8 +117,9 @@ var TmtBuilder = class {
   async buildHourNodes(memories, summarize) {
     const byHour = /* @__PURE__ */ new Map();
     for (const m of memories) {
-      const date = parseIsoDate(m.created);
-      const hour = parseIsoHour(m.created);
+      const instant = parseTmtInstant(m.created);
+      if (!instant) continue;
+      const { date, hour } = instant;
       const key = `${date}::${hour}`;
       if (!byHour.has(key)) byHour.set(key, []);
       byHour.get(key).push(m);
@@ -117,7 +133,7 @@ var TmtBuilder = class {
         try {
           const existing = await readFile(nodePath, "utf8");
           const countMatch = existing.match(/memoryCount: (\d+)/);
-          if (!countMatch || parseInt(countMatch[1], 10) < entries.length) {
+          if (!countMatch || parseInt(countMatch[1], 10) !== entries.length) {
             shouldBuild = true;
           }
         } catch {
@@ -148,7 +164,9 @@ var TmtBuilder = class {
   async buildDayNodes(memories, summarize) {
     const byDate = /* @__PURE__ */ new Map();
     for (const m of memories) {
-      const date = parseIsoDate(m.created);
+      const instant = parseTmtInstant(m.created);
+      if (!instant) continue;
+      const { date } = instant;
       if (!byDate.has(date)) byDate.set(date, []);
       byDate.get(date).push(m);
     }
@@ -159,7 +177,7 @@ var TmtBuilder = class {
         try {
           const existing = await readFile(nodePath, "utf8");
           const countMatch = existing.match(/memoryCount: (\d+)/);
-          if (!countMatch || parseInt(countMatch[1], 10) < entries.length) {
+          if (!countMatch || parseInt(countMatch[1], 10) !== entries.length) {
             shouldBuild = true;
           }
         } catch {
@@ -171,6 +189,7 @@ var TmtBuilder = class {
       const hourToEntries = /* @__PURE__ */ new Map();
       for (const e of entries) {
         const h = parseIsoHour(e.created);
+        if (!h) continue;
         if (!hourToEntries.has(h)) hourToEntries.set(h, []);
         hourToEntries.get(h).push(e);
       }
@@ -219,7 +238,9 @@ var TmtBuilder = class {
   async buildWeekNodes(memories, summarize) {
     const weekToEntries = /* @__PURE__ */ new Map();
     for (const m of memories) {
-      const week = isoWeekKey(new Date(m.created));
+      const instant = parseTmtInstant(m.created);
+      if (!instant) continue;
+      const week = isoWeekKey(instant.dateValue);
       if (!weekToEntries.has(week)) weekToEntries.set(week, []);
       weekToEntries.get(week).push(m);
     }
@@ -230,7 +251,7 @@ var TmtBuilder = class {
         try {
           const existing = await readFile(nodePath, "utf8");
           const countMatch = existing.match(/memoryCount: (\d+)/);
-          if (!countMatch || parseInt(countMatch[1], 10) < entries.length) {
+          if (!countMatch || parseInt(countMatch[1], 10) !== entries.length) {
             shouldBuild = true;
           }
         } catch {
@@ -400,4 +421,4 @@ export {
   isoWeekKey,
   TmtBuilder
 };
-//# sourceMappingURL=chunk-TPB3I2AC.js.map
+//# sourceMappingURL=chunk-ECZU5BJH.js.map

package/dist/chunk-ECZU5BJH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tmt.ts"],"sourcesContent":["/**\n * Temporal Memory Tree (TiMem-inspired, v8.2)\n *\n * Builds a hierarchy of summarised memory nodes:\n *   hour-HH.md → day.md → week-YYYY-WW.md → persona.md\n *\n * Stored under `<baseDir>/tmt/`.\n * All writes are fail-open: errors are caught and logged, never thrown.\n */\n\nimport * as fs from \"fs\";\nimport * as path from \"path\";\nimport { mkdir, readFile, writeFile, readdir } from \"node:fs/promises\";\n\nexport const TMT_DIR = \"tmt\";\n\nexport type TmtLevel = \"hour\" | \"day\" | \"week\" | \"persona\";\n\nexport interface TmtNodeFrontmatter {\n  level: TmtLevel;\n  periodStart: string; // ISO date-time\n  periodEnd: string;   // ISO date-time\n  memoryCount: number;\n  sourceIds: string[];\n  builtAt: string;     // ISO date-time\n}\n\nexport interface TmtConfig {\n  temporalMemoryTreeEnabled: boolean;\n  tmtHourlyMinMemories: number;   // default 3\n  tmtSummaryMaxTokens: number;    // default 300\n}\n\nexport interface MemoryEntry {\n  path: string;\n  id: string;\n  created: string; // ISO date-time\n  content: string;\n}\n\nconst TMT_LEVEL_INPUT_LIMITS: Record<TmtLevel, { totalChars: number; itemChars: number; maxItems: number }> = {\n  hour: { totalChars: 48_000, itemChars: 2_000, maxItems: 64 },\n  day: { totalChars: 64_000, itemChars: 1_800, maxItems: 96 },\n  week: { totalChars: 72_000, itemChars: 1_600, maxItems: 120 },\n  persona: { totalChars: 80_000, itemChars: 1_600, maxItems: 120 },\n};\n\nexport function capTmtSummaryInputs(inputs: string[], level: TmtLevel): string[] {\n  const { totalChars, itemChars, maxItems } = TMT_LEVEL_INPUT_LIMITS[level];\n  if (inputs.length === 0) return [];\n\n  const capped: string[] = [];\n  let usedChars = 0;\n\n  for (const raw of inputs) {\n    if (capped.length >= maxItems || usedChars >= totalChars) break;\n    const trimmed = raw.trim();\n    if (!trimmed) continue;\n\n    const next = trimmed.length > itemChars ? `${trimmed.slice(0, itemChars - 1)}…` : trimmed;\n    const separator = capped.length === 0 ? 0 : 2;\n    if (usedChars + separator + next.length > totalChars) break;\n    capped.push(next);\n    usedChars += separator + next.length;\n  }\n\n  if (capped.length > 0) return capped;\n  const fallback = inputs[0]?.trim() ?? \"\";\n  if (!fallback) return [];\n  return [fallback.length > itemChars ? `${fallback.slice(0, itemChars - 1)}…` : fallback];\n}\n\n// ── Path helpers ────────────────────────────────────────────────────────────\n\nexport function tmtDir(baseDir: string): string {\n  return path.join(baseDir, TMT_DIR);\n}\n\nexport function hourNodePath(baseDir: string, date: string, hour: string): string {\n  return path.join(tmtDir(baseDir), date, `hour-${hour}.md`);\n}\n\nexport function dayNodePath(baseDir: string, date: string): string {\n  return path.join(tmtDir(baseDir), date, \"day.md\");\n}\n\nexport function weekNodePath(baseDir: string, weekKey: string): string {\n  return path.join(tmtDir(baseDir), `week-${weekKey}.md`);\n}\n\nexport function personaNodePath(baseDir: string): string {\n  return path.join(tmtDir(baseDir), \"persona.md\");\n}\n\n// ── Frontmatter helpers ─────────────────────────────────────────────────────\n\nexport function serialiseTmtNode(fm: TmtNodeFrontmatter, summary: string): string {\n  const yaml = [\n    \"---\",\n    `level: ${fm.level}`,\n    `periodStart: \"${fm.periodStart}\"`,\n    `periodEnd: \"${fm.periodEnd}\"`,\n    `memoryCount: ${fm.memoryCount}`,\n    `sourceIds: [${fm.sourceIds.map((id) => `\"${id}\"`).join(\", \")}]`,\n    `builtAt: \"${fm.builtAt}\"`,\n    \"---\",\n  ].join(\"\\n\");\n  return `${yaml}\\n\\n${summary}\\n`;\n}\n\nexport function parseIsoDate(iso: string): string {\n  return parseTmtInstant(iso)?.date ?? \"\";\n}\n\nexport function parseIsoHour(iso: string): string {\n  return parseTmtInstant(iso)?.hour ?? \"\";\n}\n\nfunction parseTmtInstant(iso: string): { date: string; hour: string; dateValue: Date } | null {\n  if (typeof iso !== \"string\") return null;\n  const value = iso.trim();\n  if (\n    !/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,9})?(?:Z|[+-]\\d{2}:\\d{2})$/.test(value)\n  ) {\n    return null;\n  }\n  const dateValue = new Date(value);\n  if (!Number.isFinite(dateValue.getTime())) return null;\n  const utc = dateValue.toISOString();\n  return {\n    date: utc.slice(0, 10),\n    hour: utc.slice(11, 13),\n    dateValue,\n  };\n}\n\n// Returns ISO week key: YYYY-WW\nexport function isoWeekKey(date: Date): string {\n  const d = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));\n  const dayNum = d.getUTCDay() || 7;\n  d.setUTCDate(d.getUTCDate() + 4 - dayNum);\n  const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));\n  const weekNo = Math.ceil((((d.getTime() - yearStart.getTime()) / 86400000) + 1) / 7);\n  return `${d.getUTCFullYear()}-${String(weekNo).padStart(2, \"0\")}`;\n}\n\n// ── TmtBuilder ──────────────────────────────────────────────────────────────\n\nexport type SummarizeFn = (memories: string[], level: TmtLevel) => Promise<string>;\n\nexport class TmtBuilder {\n  constructor(\n    private readonly baseDir: string,\n    private readonly cfg: TmtConfig,\n  ) {}\n\n  /**\n   * Called after each consolidation pass.\n   * Groups memories by hour, builds any missing hour nodes,\n   * then rolls up to day → week → persona if needed.\n   * All errors are caught and logged; never throws.\n   */\n  async maybeRebuildNodes(\n    memories: MemoryEntry[],\n    summarize: SummarizeFn,\n  ): Promise<void> {\n    if (!this.cfg.temporalMemoryTreeEnabled || memories.length === 0) return;\n    try {\n      await mkdir(tmtDir(this.baseDir), { recursive: true });\n      await this.buildHourNodes(memories, summarize);\n      await this.buildDayNodes(memories, summarize);\n      await this.buildWeekNodes(memories, summarize);\n      await this.buildPersonaNode(summarize);\n    } catch (err) {\n      console.warn(`[engram] tmt: rebuild failed (ignored): ${err}`);\n    }\n  }\n\n  private async buildHourNodes(memories: MemoryEntry[], summarize: SummarizeFn): Promise<void> {\n    // Group by date+hour\n    const byHour = new Map<string, MemoryEntry[]>();\n    for (const m of memories) {\n      const instant = parseTmtInstant(m.created);\n      if (!instant) continue;\n      const { date, hour } = instant;\n      const key = `${date}::${hour}`;\n      if (!byHour.has(key)) byHour.set(key, []);\n      byHour.get(key)!.push(m);\n    }\n\n    for (const [key, entries] of byHour) {\n      if (entries.length < this.cfg.tmtHourlyMinMemories) continue;\n      const [date, hour] = key.split(\"::\");\n      const nodePath = hourNodePath(this.baseDir, date, hour);\n\n      // Rebuild if missing or if more memories arrived for this hour\n      let shouldBuild = !fs.existsSync(nodePath);\n      if (!shouldBuild) {\n        try {\n          const existing = await readFile(nodePath, \"utf8\");\n          const countMatch = existing.match(/memoryCount: (\\d+)/);\n          if (!countMatch || parseInt(countMatch[1], 10) !== entries.length) {\n            shouldBuild = true; // active memory set changed — rebuild\n          }\n        } catch { shouldBuild = true; }\n      }\n      if (!shouldBuild) continue;\n\n      let summary: string;\n      try {\n        summary = await summarize(capTmtSummaryInputs(entries.map((e) => e.content), \"hour\"), \"hour\");\n      } catch (err) {\n        console.warn(`[engram] tmt: hour node summarize failed for ${key} (ignored): ${err}`);\n        continue;\n      }\n      const sortedCreated = entries.map((e) => e.created).sort();\n      const fm: TmtNodeFrontmatter = {\n        level: \"hour\",\n        periodStart: sortedCreated[0],\n        periodEnd: sortedCreated[sortedCreated.length - 1],\n        memoryCount: entries.length,\n        sourceIds: entries.map((e) => e.id),\n        builtAt: new Date().toISOString(),\n      };\n      await mkdir(path.dirname(nodePath), { recursive: true });\n      await writeFile(nodePath, serialiseTmtNode(fm, summary), \"utf8\");\n    }\n  }\n\n  private async buildDayNodes(memories: MemoryEntry[], summarize: SummarizeFn): Promise<void> {\n    // Group by date\n    const byDate = new Map<string, MemoryEntry[]>();\n    for (const m of memories) {\n      const instant = parseTmtInstant(m.created);\n      if (!instant) continue;\n      const { date } = instant;\n      if (!byDate.has(date)) byDate.set(date, []);\n      byDate.get(date)!.push(m);\n    }\n\n    for (const [date, entries] of byDate) {\n      const nodePath = dayNodePath(this.baseDir, date);\n      // Rebuild day node if it doesn't exist or if memory count changed\n      let shouldBuild = !fs.existsSync(nodePath);\n      if (!shouldBuild) {\n        try {\n          const existing = await readFile(nodePath, \"utf8\");\n          const countMatch = existing.match(/memoryCount: (\\d+)/);\n          if (!countMatch || parseInt(countMatch[1], 10) !== entries.length) {\n            shouldBuild = true; // active memory set changed — rebuild\n          }\n        } catch { shouldBuild = true; }\n      }\n      if (!shouldBuild) continue;\n\n      // Per-hour: use hour node summary if available, raw content otherwise\n      const inputs: string[] = [];\n      const hourToEntries = new Map<string, MemoryEntry[]>();\n      for (const e of entries) {\n        const h = parseIsoHour(e.created);\n        if (!h) continue;\n        if (!hourToEntries.has(h)) hourToEntries.set(h, []);\n        hourToEntries.get(h)!.push(e);\n      }\n      for (const [h, hourEntries] of hourToEntries) {\n        const hPath = hourNodePath(this.baseDir, date, h);\n        if (fs.existsSync(hPath)) {\n          try {\n            const hContent = await readFile(hPath, \"utf8\");\n            const hSummary = hContent.replace(/^---[\\s\\S]*?---\\n\\n?/, \"\").trim();\n            if (hSummary) { inputs.push(hSummary); continue; }\n          } catch { /* fall through to raw content */ }\n        }\n        inputs.push(...hourEntries.map((e) => e.content));\n      }\n      if (inputs.length === 0) inputs.push(...entries.map((e) => e.content));\n\n      let summary: string;\n      try {\n        summary = await summarize(capTmtSummaryInputs(inputs, \"day\"), \"day\");\n      } catch (err) {\n        console.warn(`[engram] tmt: day node summarize failed for ${date} (ignored): ${err}`);\n        continue;\n      }\n      const sortedCreated = entries.map((e) => e.created).sort();\n      const fm: TmtNodeFrontmatter = {\n        level: \"day\",\n        periodStart: sortedCreated[0],\n        periodEnd: sortedCreated[sortedCreated.length - 1],\n        memoryCount: entries.length,\n        sourceIds: entries.map((e) => e.id),\n        builtAt: new Date().toISOString(),\n      };\n      await mkdir(path.dirname(nodePath), { recursive: true });\n      await writeFile(nodePath, serialiseTmtNode(fm, summary), \"utf8\");\n    }\n  }\n\n  /**\n   * Build or update week-level nodes from the day nodes already on disk.\n   * Groups memories by ISO week; for each week that has a day node but no\n   * (or stale) week node, reads day node summaries and builds a week node.\n   * Fail-open: errors per week are caught and skipped.\n   */\n  private async buildWeekNodes(memories: MemoryEntry[], summarize: SummarizeFn): Promise<void> {\n    // Determine which ISO weeks appear in this memory batch\n    const weekToEntries = new Map<string, MemoryEntry[]>();\n    for (const m of memories) {\n      const instant = parseTmtInstant(m.created);\n      if (!instant) continue;\n      const week = isoWeekKey(instant.dateValue);\n      if (!weekToEntries.has(week)) weekToEntries.set(week, []);\n      weekToEntries.get(week)!.push(m);\n    }\n\n    for (const [week, entries] of weekToEntries) {\n      const nodePath = weekNodePath(this.baseDir, week);\n\n      // Rebuild if missing or if memory count grew\n      let shouldBuild = !fs.existsSync(nodePath);\n      if (!shouldBuild) {\n        try {\n          const existing = await readFile(nodePath, \"utf8\");\n          const countMatch = existing.match(/memoryCount: (\\d+)/);\n          if (!countMatch || parseInt(countMatch[1], 10) !== entries.length) {\n            shouldBuild = true;\n          }\n        } catch { shouldBuild = true; }\n      }\n      if (!shouldBuild) continue;\n\n      try {\n        // Collect day-node summaries for days that fall in this week\n        const dir = tmtDir(this.baseDir);\n        let allDirs: string[] = [];\n        try { allDirs = await readdir(dir); } catch { continue; }\n        const dateDirs = allDirs.filter((d) => /^\\d{4}-\\d{2}-\\d{2}$/.test(d));\n\n        const daySummaries: string[] = [];\n        for (const dateDir of dateDirs) {\n          const w = isoWeekKey(new Date(dateDir + \"T00:00:00Z\"));\n          if (w !== week) continue;\n          const dayPath = dayNodePath(this.baseDir, dateDir);\n          if (fs.existsSync(dayPath)) {\n            try {\n              const content = await readFile(dayPath, \"utf8\");\n              const summary = content.replace(/^---[\\s\\S]*?---\\n\\n?/, \"\").trim();\n              if (summary) daySummaries.push(summary);\n            } catch { /* skip */ }\n          }\n        }\n\n        // Fall back to raw memory content if no day summaries available\n        const inputs = daySummaries.length > 0 ? daySummaries : entries.map((e) => e.content);\n        const summary = await summarize(capTmtSummaryInputs(inputs, \"week\"), \"week\");\n        const sortedCreated = entries.map((e) => e.created).sort();\n        const fm: TmtNodeFrontmatter = {\n          level: \"week\",\n          periodStart: sortedCreated[0],\n          periodEnd: sortedCreated[sortedCreated.length - 1],\n          memoryCount: entries.length,\n          sourceIds: entries.map((e) => e.id),\n          builtAt: new Date().toISOString(),\n        };\n        await mkdir(path.dirname(nodePath), { recursive: true });\n        await writeFile(nodePath, serialiseTmtNode(fm, summary), \"utf8\");\n      } catch (err) {\n        console.warn(`[engram] tmt: week node build failed for ${week} (ignored): ${err}`);\n      }\n    }\n  }\n\n  /**\n   * Build or update the persona node from the most recent week-level summaries.\n   * Reads up to 4 recent week nodes and synthesizes a persona-level narrative.\n   * Fail-open: skips silently if no week nodes exist or summarize fails.\n   */\n  private async buildPersonaNode(summarize: SummarizeFn): Promise<void> {\n    try {\n      const dir = tmtDir(this.baseDir);\n      let allFiles: string[] = [];\n      try { allFiles = await readdir(dir); } catch { return; }\n\n      const weekFiles = allFiles\n        .filter((f) => /^week-\\d{4}-\\d{2}\\.md$/.test(f))\n        .sort()\n        .reverse()\n        .slice(0, 4); // Use at most 4 recent weeks\n\n      if (weekFiles.length === 0) return;\n\n      const weekSummaries: string[] = [];\n      let totalCount = 0;\n      let earliestStart: string | undefined;\n      let latestEnd: string | undefined;\n      for (const f of weekFiles) {\n        try {\n          const content = await readFile(path.join(dir, f), \"utf8\");\n          const summary = content.replace(/^---[\\s\\S]*?---\\n\\n?/, \"\").trim();\n          if (summary) weekSummaries.push(summary);\n          const countMatch = content.match(/memoryCount: (\\d+)/);\n          if (countMatch) totalCount += parseInt(countMatch[1], 10);\n          const startMatch = content.match(/periodStart: \"([^\"]+)\"/);\n          const endMatch = content.match(/periodEnd: \"([^\"]+)\"/);\n          if (startMatch) {\n            if (!earliestStart || startMatch[1] < earliestStart) earliestStart = startMatch[1];\n          }\n          if (endMatch) {\n            if (!latestEnd || endMatch[1] > latestEnd) latestEnd = endMatch[1];\n          }\n        } catch { /* skip */ }\n      }\n\n      if (weekSummaries.length === 0) return;\n\n      const nodePath = personaNodePath(this.baseDir);\n\n      // Skip rebuild if persona node already reflects current week data\n      let shouldBuild = !fs.existsSync(nodePath);\n      if (!shouldBuild) {\n        try {\n          const existing = await readFile(nodePath, \"utf8\");\n          const countMatch = existing.match(/memoryCount: (\\d+)/);\n          if (!countMatch || parseInt(countMatch[1], 10) !== totalCount) {\n            shouldBuild = true;\n          }\n        } catch { shouldBuild = true; }\n      }\n      if (!shouldBuild) return;\n\n      const summary = await summarize(capTmtSummaryInputs(weekSummaries, \"persona\"), \"persona\");\n\n      const now = new Date().toISOString();\n      const fm: TmtNodeFrontmatter = {\n        level: \"persona\",\n        periodStart: earliestStart ?? now,\n        periodEnd: latestEnd ?? now,\n        memoryCount: totalCount,\n        sourceIds: [],\n        builtAt: now,\n      };\n      await writeFile(nodePath, serialiseTmtNode(fm, summary), \"utf8\");\n    } catch (err) {\n      console.warn(`[engram] tmt: persona node build failed (ignored): ${err}`);\n    }\n  }\n\n  /**\n   * Return the summary text of the most relevant TMT node for a given prompt.\n   * Preference: day node for today > most recent day node.\n   * Returns null if no nodes exist or feature is disabled.\n   */\n  async getMostRelevantNode(): Promise<{ level: TmtLevel; summary: string } | null> {\n    if (!this.cfg.temporalMemoryTreeEnabled) return null;\n    try {\n      const dir = tmtDir(this.baseDir);\n      if (!fs.existsSync(dir)) return null;\n\n      // Try today's day node first\n      const today = new Date().toISOString().slice(0, 10);\n      const todayDay = dayNodePath(this.baseDir, today);\n      if (fs.existsSync(todayDay)) {\n        const content = await readFile(todayDay, \"utf8\");\n        const summary = content.replace(/^---[\\s\\S]*?---\\n\\n?/, \"\").trim();\n        if (summary) return { level: \"day\", summary };\n      }\n\n      // Find most recent date directory\n      let entries: string[] = [];\n      try { entries = await readdir(dir); } catch { return null; }\n      const dateDirs = entries.filter((e) => /^\\d{4}-\\d{2}-\\d{2}$/.test(e)).sort().reverse();\n\n      for (const dateDir of dateDirs) {\n        const dayPath = dayNodePath(this.baseDir, dateDir);\n        if (fs.existsSync(dayPath)) {\n          const content = await readFile(dayPath, \"utf8\");\n          const summary = content.replace(/^---[\\s\\S]*?---\\n\\n?/, \"\").trim();\n          if (summary) return { level: \"day\", summary };\n        }\n      }\n      return null;\n    } catch {\n      return null;\n    }\n  }\n}\n"],"mappings":"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","names":["summary"]}

package/dist/chunk-EDQVAMQI.js

@@ -0,0 +1,308 @@
+import {
+  launchProcessSync
+} from "./chunk-NNVTUXEB.js";
+import {
+  expandTildePath
+} from "./chunk-EYIEWJNI.js";
+
+// src/coding/git-context.ts
+import path from "path";
+var DEFAULT_GIT_TIMEOUT_MS = 2e3;
+function defaultGitInvoker() {
+  return (cwd, args) => {
+    const result = launchProcessSync("git", args, {
+      cwd,
+      encoding: "utf-8",
+      timeout: DEFAULT_GIT_TIMEOUT_MS,
+      shell: false
+    });
+    if (result.error) {
+      return { stdout: "", exitCode: 127 };
+    }
+    return {
+      stdout: typeof result.stdout === "string" ? result.stdout : "",
+      exitCode: typeof result.status === "number" ? result.status : 1
+    };
+  };
+}
+function stableHash(input) {
+  let hash = 2166136261;
+  for (let i = 0; i < input.length; i++) {
+    hash ^= input.charCodeAt(i);
+    hash = Math.imul(hash, 16777619) >>> 0;
+  }
+  return hash.toString(16).padStart(8, "0");
+}
+function normalizeOriginUrl(rawUrl) {
+  let url = rawUrl.trim();
+  if (!url) return "";
+  if (/\.git$/i.test(url)) url = url.slice(0, -4);
+  if (/^[A-Za-z]:[\\/]/.test(url)) {
+    return url.toLowerCase();
+  }
+  const protoMatch = /^[a-z][a-z0-9+.-]*:\/\/(?:[^@/]+@)?(\[[^\]]+\]|[^/:]*)(?::(\d+))?(\/.*)?$/i.exec(url);
+  if (protoMatch) {
+    let host = protoMatch[1] ?? "";
+    const wasBracketed = host.startsWith("[") && host.endsWith("]");
+    if (wasBracketed) host = host.slice(1, -1);
+    const port = protoMatch[2];
+    const repoPath = (protoMatch[3] ?? "").replace(/^\/+/, "");
+    const hostPort = port ? wasBracketed ? `[${host}]:${port}` : `${host}:${port}` : host;
+    const prefix = hostPort.length > 0 ? hostPort : "localhost";
+    return `${prefix}/${repoPath}`.toLowerCase();
+  }
+  const scpMatch = /^(?:([^@\s/]+)@)?(\[[^\]]+\]|[^:@\s/]+):(.+)$/.exec(url);
+  if (scpMatch) {
+    let host = scpMatch[2] ?? "";
+    if (host.startsWith("[") && host.endsWith("]")) host = host.slice(1, -1);
+    const repoPath = scpMatch[3] ?? "";
+    if (repoPath.startsWith("//")) {
+      return url.toLowerCase();
+    }
+    return `${host}/${repoPath.replace(/^\/+/, "")}`.toLowerCase();
+  }
+  return url.toLowerCase();
+}
+async function resolveGitContext(cwd, options = {}) {
+  try {
+    if (typeof cwd !== "string" || cwd.length === 0) return null;
+    const expanded = expandTildePath(cwd);
+    if (!path.isAbsolute(expanded)) return null;
+    const invoker = options.invoker ?? defaultGitInvoker();
+    const topLevel = invoker(expanded, ["rev-parse", "--show-toplevel"]);
+    if (topLevel.exitCode !== 0) return null;
+    const rootPath = topLevel.stdout.trim();
+    if (!rootPath) return null;
+    const branchResult = invoker(rootPath, ["rev-parse", "--abbrev-ref", "HEAD"]);
+    let branch = null;
+    if (branchResult.exitCode === 0) {
+      const raw = branchResult.stdout.trim();
+      branch = raw && raw !== "HEAD" ? raw : null;
+    } else {
+      const unbornRef = invoker(rootPath, ["symbolic-ref", "--quiet", "HEAD"]);
+      if (unbornRef.exitCode === 0) {
+        const raw = unbornRef.stdout.trim();
+        const prefix = "refs/heads/";
+        if (raw.startsWith(prefix)) {
+          const candidate = raw.slice(prefix.length);
+          if (candidate) branch = candidate;
+        }
+      }
+    }
+    const originResult = invoker(rootPath, ["remote", "get-url", "origin"]);
+    let projectId;
+    if (originResult.exitCode === 0) {
+      const normalized = normalizeOriginUrl(originResult.stdout);
+      projectId = normalized ? `origin:${stableHash(normalized)}` : `root:${stableHash(rootPath)}`;
+    } else {
+      projectId = `root:${stableHash(rootPath)}`;
+    }
+    const headRef = invoker(rootPath, ["symbolic-ref", "--quiet", "refs/remotes/origin/HEAD"]);
+    let defaultBranch = null;
+    if (headRef.exitCode === 0) {
+      const raw = headRef.stdout.trim();
+      const prefix = "refs/remotes/origin/";
+      if (raw.startsWith(prefix)) {
+        const candidate = raw.slice(prefix.length);
+        if (candidate) defaultBranch = candidate;
+      }
+    }
+    return {
+      projectId,
+      branch,
+      rootPath,
+      defaultBranch
+    };
+  } catch {
+    return null;
+  }
+}
+
+// src/coding/coding-namespace.ts
+function sanitizeFragment(input) {
+  if (typeof input !== "string") return "";
+  const trimmed = input.trim().toLowerCase();
+  let out = "";
+  let prevIsDash = true;
+  for (let i = 0; i < trimmed.length; i += 1) {
+    const c = trimmed[i];
+    const cc = trimmed.charCodeAt(i);
+    const isSafe = cc >= 48 && cc <= 57 || cc >= 97 && cc <= 122 || cc === 46 || cc === 95;
+    if (isSafe) {
+      out += c;
+      prevIsDash = false;
+    } else if (!prevIsDash) {
+      out += "-";
+      prevIsDash = true;
+    }
+  }
+  if (out.endsWith("-")) out = out.slice(0, -1);
+  return out;
+}
+var MAX_NAMESPACE_LEN = 64;
+var HASH_SUFFIX_LEN = 9;
+function capLength(value) {
+  if (value.length <= MAX_NAMESPACE_LEN) return value;
+  const hash = stableHash(value);
+  let end = MAX_NAMESPACE_LEN - HASH_SUFFIX_LEN;
+  while (end > 0 && value.charCodeAt(end - 1) === 45) end -= 1;
+  return `${value.slice(0, end)}-${hash}`;
+}
+function projectNamespaceName(projectId) {
+  const frag = sanitizeFragment(projectId);
+  return capLength(`project-${frag || "unknown"}`);
+}
+function projectTagProjectId(projectTag) {
+  const trimmed = projectTag.trim();
+  const frag = sanitizeFragment(trimmed);
+  const disambig = trimmed.length > 0 && frag !== trimmed;
+  const suffix = disambig ? `-${stableHash(trimmed)}` : "";
+  return `tag:${frag || "unknown"}${suffix}`;
+}
+function sanitizeBaseFragment(input) {
+  if (typeof input !== "string") return "";
+  const trimmed = input.trim();
+  let out = "";
+  let prevIsDash = true;
+  for (let i = 0; i < trimmed.length; i += 1) {
+    const c = trimmed[i];
+    const cc = trimmed.charCodeAt(i);
+    const isSafe = cc >= 48 && cc <= 57 || cc >= 65 && cc <= 90 || cc >= 97 && cc <= 122 || cc === 46 || cc === 95;
+    if (isSafe) {
+      out += c;
+      prevIsDash = false;
+    } else if (!prevIsDash) {
+      out += "-";
+      prevIsDash = true;
+    }
+  }
+  if (out.endsWith("-")) out = out.slice(0, -1);
+  return out;
+}
+function combineNamespaces(base, overlay) {
+  const baseFrag = sanitizeBaseFragment(base);
+  const overlayFrag = sanitizeFragment(overlay);
+  if (!baseFrag) return capLength(overlayFrag || "unknown");
+  if (!overlayFrag) return capLength(baseFrag);
+  return capLength(`${baseFrag}-${overlayFrag}`);
+}
+function branchNamespaceName(projectId, branch) {
+  const projectFrag = sanitizeFragment(projectId);
+  const trimmedBranch = branch.trim();
+  const branchFrag = sanitizeFragment(trimmedBranch);
+  const disambig = trimmedBranch.length > 0 && branchFrag !== trimmedBranch;
+  const base = `project-${projectFrag || "unknown"}-branch-${branchFrag || "unknown"}`;
+  const suffixed = disambig ? `${base}-${stableHash(trimmedBranch)}` : base;
+  return capLength(suffixed);
+}
+function resolveCodingNamespaceOverlay(codingContext, config, defaultNamespace) {
+  if (!codingContext) return null;
+  if (!config.projectScope) return null;
+  const projectId = typeof codingContext.projectId === "string" ? codingContext.projectId.trim() : "";
+  if (!projectId) return null;
+  const projectNs = projectNamespaceName(projectId);
+  const includeRoot = config.globalFallback === true;
+  if (config.branchScope && typeof codingContext.branch === "string" && codingContext.branch.length > 0) {
+    const branchNs = branchNamespaceName(projectId, codingContext.branch);
+    const fallbacks = [projectNs];
+    if (includeRoot) fallbacks.push("");
+    return {
+      namespace: branchNs,
+      readFallbacks: fallbacks,
+      scope: "branch"
+    };
+  }
+  return {
+    namespace: projectNs,
+    readFallbacks: includeRoot ? [""] : [],
+    scope: "project"
+  };
+}
+function describeCodingScope(codingContext, config, defaultNamespace) {
+  const projectId = codingContext?.projectId ?? null;
+  const branch = codingContext?.branch ?? null;
+  if (!codingContext) {
+    return {
+      scope: "none",
+      projectId: null,
+      branch: null,
+      effectiveNamespace: null,
+      readFallbacks: [],
+      disabledReason: "no-context"
+    };
+  }
+  if (!config.projectScope) {
+    return {
+      scope: "none",
+      projectId,
+      branch,
+      effectiveNamespace: null,
+      readFallbacks: [],
+      disabledReason: "disabled"
+    };
+  }
+  const trimmedId = typeof projectId === "string" ? projectId.trim() : "";
+  if (!trimmedId) {
+    return {
+      scope: "none",
+      projectId,
+      branch,
+      effectiveNamespace: null,
+      readFallbacks: [],
+      disabledReason: "empty-project"
+    };
+  }
+  const overlay = resolveCodingNamespaceOverlay(codingContext, config, defaultNamespace);
+  if (!overlay) {
+    return {
+      scope: "none",
+      projectId,
+      branch,
+      effectiveNamespace: null,
+      readFallbacks: [],
+      disabledReason: "disabled"
+    };
+  }
+  return {
+    scope: overlay.scope,
+    projectId,
+    branch,
+    effectiveNamespace: overlay.namespace,
+    readFallbacks: overlay.readFallbacks,
+    disabledReason: null
+  };
+}
+
+// src/procedural/reinforcement-core.ts
+function clusterByKey(items, keyFn) {
+  const clusters = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const key = keyFn(item);
+    if (typeof key !== "string") {
+      throw new TypeError(
+        `clusterByKey: keyFn must return a string, got ${key === null ? "null" : typeof key}`
+      );
+    }
+    const existing = clusters.get(key);
+    if (existing) {
+      existing.push(item);
+    } else {
+      clusters.set(key, [item]);
+    }
+  }
+  return clusters;
+}
+
+export {
+  clusterByKey,
+  stableHash,
+  normalizeOriginUrl,
+  resolveGitContext,
+  projectNamespaceName,
+  projectTagProjectId,
+  combineNamespaces,
+  branchNamespaceName,
+  resolveCodingNamespaceOverlay,
+  describeCodingScope
+};
+//# sourceMappingURL=chunk-EDQVAMQI.js.map

package/dist/chunk-EDQVAMQI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/coding/git-context.ts","../src/coding/coding-namespace.ts","../src/procedural/reinforcement-core.ts"],"sourcesContent":["/**\n * GitContextResolver — pure module for detecting the git project + branch\n * a session is operating in.\n *\n * Introduced by issue #569 (coding-agent project/branch-scoped namespaces).\n *\n * This module is deliberately pure:\n *   - no orchestrator references\n *   - no config side-effects\n *   - no namespace wiring\n *\n * Downstream slices (PR 2+ of #569) wire `resolveGitContext` into the\n * `NamespaceResolver` / `Orchestrator` so that memories are scoped to a\n * detected project / branch without leaking across repos.\n *\n * CLAUDE.md rule 17 (expand `~`): the `rootPath` returned here is always an\n * absolute, tilde-expanded path. Callers must not re-expand.\n *\n * CLAUDE.md rule 51 (reject invalid input): `cwd` must be an absolute path\n * and must exist. `resolveGitContext` returns `null` — rather than throwing —\n * when the directory is not inside a git worktree, because being outside a\n * repo is a normal runtime state (e.g. agent opened in a scratch dir).\n */\nimport path from \"node:path\";\n\nimport { expandTildePath } from \"../utils/path.js\";\nimport { launchProcessSync } from \"../runtime/child-process.js\";\n\n// Re-export so existing callers / tests that imported `expandTildePath` from\n// this module keep working. CLAUDE.md #17 requires consistent `~` expansion\n// across every user-facing path input; the canonical implementation now\n// lives in `utils/path.ts`.\nexport { expandTildePath };\n\n// ──────────────────────────────────────────────────────────────────────────\n// Public types\n// ──────────────────────────────────────────────────────────────────────────\n\nexport interface GitContext {\n  /**\n   * Stable identifier for the project. Derived from `git remote get-url origin`\n   * when an origin remote is configured, otherwise from the repo root path.\n   *\n   * Formatted as `origin:<hex>` or `root:<hex>` so that the source is visible\n   * to operators (see `remnic doctor`, issue #569 acceptance criteria).\n   */\n  projectId: string;\n  /**\n   * Current branch, e.g. `main`, `feat/foo`. `null` only in detached-HEAD\n   * state (e.g. rebase in progress). Callers should treat `null` as \"no\n   * branch-scope overlay applies\" without erroring.\n   */\n  branch: string | null;\n  /**\n   * Absolute path to the repository root (the directory containing `.git`).\n   * Tilde-expanded per CLAUDE.md #17.\n   */\n  rootPath: string;\n  /**\n   * Best-effort default branch (usually `main` or `master`). Derived from the\n   * `refs/remotes/origin/HEAD` symbolic ref. `null` when not available (e.g.\n   * fresh clone without a default branch symref, or no origin remote).\n   */\n  defaultBranch: string | null;\n}\n\n/**\n * Injectable git-invocation surface. Only the commands `resolveGitContext`\n * actually needs are exposed. Tests inject a mock implementation to avoid\n * spawning a real git process.\n */\nexport interface GitInvoker {\n  /**\n   * Run `git <args>` with `cwd` as the working directory. Must return\n   * `{ stdout, exitCode }` with `stdout` trimmed by the caller as needed.\n   * Implementations should NOT throw for non-zero exit codes — they should\n   * return the exit code so the resolver can decide how to recover.\n   */\n  (cwd: string, args: string[]): { stdout: string; exitCode: number };\n}\n\n// ──────────────────────────────────────────────────────────────────────────\n// Default git invoker — spawns real `git` via the shared child-process helper\n// ──────────────────────────────────────────────────────────────────────────\n\nconst DEFAULT_GIT_TIMEOUT_MS = 2_000;\n\nexport function defaultGitInvoker(): GitInvoker {\n  return (cwd: string, args: string[]) => {\n    const result = launchProcessSync(\"git\", args, {\n      cwd,\n      encoding: \"utf-8\",\n      timeout: DEFAULT_GIT_TIMEOUT_MS,\n      shell: false,\n    });\n    if (result.error) {\n      // Spawn failure (git not on PATH, timeout, etc.). Surface as non-zero.\n      return { stdout: \"\", exitCode: 127 };\n    }\n    return {\n      stdout: typeof result.stdout === \"string\" ? result.stdout : \"\",\n      exitCode: typeof result.status === \"number\" ? result.status : 1,\n    };\n  };\n}\n\n// ──────────────────────────────────────────────────────────────────────────\n// Stable hashing\n// ──────────────────────────────────────────────────────────────────────────\n\n/**\n * Non-cryptographic stable hash. Used only to derive a deterministic\n * `projectId` from either the origin URL or the root path. The hash does not\n * need to be collision-resistant against adversarial input — it is purely a\n * namespace discriminator.\n *\n * Uses FNV-1a 32-bit so we don't pull in `node:crypto` for a simple bucket\n * key. Output is lowercase hex, zero-padded to 8 characters.\n */\nexport function stableHash(input: string): string {\n  let hash = 0x811c9dc5;\n  for (let i = 0; i < input.length; i++) {\n    hash ^= input.charCodeAt(i);\n    hash = Math.imul(hash, 0x01000193) >>> 0;\n  }\n  return hash.toString(16).padStart(8, \"0\");\n}\n\n// ──────────────────────────────────────────────────────────────────────────\n// Origin URL normalization\n// ──────────────────────────────────────────────────────────────────────────\n\n/**\n * Normalize a git remote URL so that equivalent SSH / HTTPS forms of the\n * same repo produce the same `projectId`. Handles:\n *   - `git@github.com:foo/bar.git`  → `github.com/foo/bar`\n *   - `https://github.com/foo/bar`  → `github.com/foo/bar`\n *   - `https://github.com/foo/bar.git` → `github.com/foo/bar`\n *   - `ssh://git@github.com/foo/bar` → `github.com/foo/bar`\n *   - `ssh://git@github.com:2222/foo/bar` → `github.com/foo/bar` (port stripped)\n *\n * Case-insensitive (remote hostnames and most repo paths on major forges are\n * case-insensitive in practice).\n */\nexport function normalizeOriginUrl(rawUrl: string): string {\n  let url = rawUrl.trim();\n  if (!url) return \"\";\n\n  // Strip trailing `.git` case-insensitively — the whole result is\n  // lowercased at the end, so `.GIT` / `.Git` must be treated the same as\n  // `.git`. Previously the `.endsWith(\".git\")` check let `.GIT` leak\n  // through and appear in the output.\n  if (/\\.git$/i.test(url)) url = url.slice(0, -4);\n\n  // Windows drive-letter local path (e.g. `C:/repos/app`): detect here\n  // so the scp matcher below can accept single-character SSH host aliases\n  // (`h:foo/bar` from `.ssh/config`). A drive letter is exactly one ASCII\n  // letter followed by `:/` or `:\\`; SSH aliases never have a slash\n  // immediately after the colon.\n  if (/^[A-Za-z]:[\\\\/]/.test(url)) {\n    return url.toLowerCase();\n  }\n\n  // Protocol-prefixed: ssh://, https://, http://, git://, file://\n  // Must be tried FIRST so that scp-style detection below doesn't\n  // incorrectly swallow an ssh:// URL that happens to contain `:port/`.\n  //\n  // Matches:\n  //   1: host — bracketed IPv6 `[2001:db8::1]`, plain host with no `:` / `/`,\n  //      OR empty (for `file:///path` which has no host component).\n  //   2: port (optional) — preserved in the output so two repos on the same\n  //      host under different ports get distinct project namespaces.\n  //      Losing the port risked false-coalescing separate repos on custom\n  //      SSH mesh setups.\n  //   3: path (optional)\n  const protoMatch =\n    /^[a-z][a-z0-9+.-]*:\\/\\/(?:[^@/]+@)?(\\[[^\\]]+\\]|[^/:]*)(?::(\\d+))?(\\/.*)?$/i.exec(url);\n  if (protoMatch) {\n    let host = protoMatch[1] ?? \"\";\n    // Detect IPv6 via the bracketed input form BEFORE stripping brackets,\n    // so that when we later re-attach a port we can preserve the\n    // `[host]:port` boundary. Without the brackets, `host:2222` is\n    // ambiguous with a longer bare IPv6 address like `2001:db8::1:2222`.\n    const wasBracketed =\n      host.startsWith(\"[\") && host.endsWith(\"]\");\n    if (wasBracketed) host = host.slice(1, -1);\n    const port = protoMatch[2];\n    const repoPath = (protoMatch[3] ?? \"\").replace(/^\\/+/, \"\");\n    const hostPort = port\n      ? wasBracketed\n        ? `[${host}]:${port}`\n        : `${host}:${port}`\n      : host;\n    // For protocols without a host component (file:///path), fall back to\n    // a stable prefix so distinct local paths don't collapse to \"/path\".\n    const prefix = hostPort.length > 0 ? hostPort : \"localhost\";\n    return `${prefix}/${repoPath}`.toLowerCase();\n  }\n\n  // scp-like syntax: [user@]host:path. Protocol-prefixed URLs (`scheme://`)\n  // are handled above, so the scp branch below guards against them: a\n  // matched `host` of `scheme` followed by a path starting with `//` is\n  // a protocol URL that fell through and must NOT be parsed here.\n  // `user@` is optional — git also accepts userless scp forms like\n  // `host:org/repo`. Valid scp paths may start with digits (e.g.\n  // `git@host:123/repo.git`), so no numeric guard is needed: port-bearing\n  // URLs have the `://` prefix and match the protocol branch above before\n  // reaching here.\n  //\n  // Windows drive letters were filtered above, so single-character SSH\n  // host aliases (`h:foo/bar`) are accepted here.\n  //\n  // Bracketed IPv6 (`[2001:db8::1]`) is supported: the host alternative\n  // matches the bracketed literal up to `]` without splitting on internal\n  // `:`. Brackets are stripped in the normalised form so the scp and\n  // `ssh://` forms of the same IPv6 remote produce identical projectIds.\n  const scpMatch =\n    /^(?:([^@\\s/]+)@)?(\\[[^\\]]+\\]|[^:@\\s/]+):(.+)$/.exec(url);\n  if (scpMatch) {\n    let host = scpMatch[2] ?? \"\";\n    if (host.startsWith(\"[\") && host.endsWith(\"]\")) host = host.slice(1, -1);\n    const repoPath = scpMatch[3] ?? \"\";\n    // Reject protocol-like leftovers (e.g. `file:///path` where the scp\n    // regex greedily matched `file` as host and `///path` as path).\n    if (repoPath.startsWith(\"//\")) {\n      return url.toLowerCase();\n    }\n    return `${host}/${repoPath.replace(/^\\/+/, \"\")}`.toLowerCase();\n  }\n\n  // Fallback: use raw lowercased\n  return url.toLowerCase();\n}\n\n// ──────────────────────────────────────────────────────────────────────────\n// Resolver\n// ──────────────────────────────────────────────────────────────────────────\n\nexport interface ResolveGitContextOptions {\n  /** Inject a git invoker (tests). Defaults to spawning real `git`. */\n  invoker?: GitInvoker;\n}\n\n/**\n * Detect the git project + branch for `cwd`.\n *\n * Returns `null` when:\n *   - `cwd` is not an absolute path (invalid input, CLAUDE.md #51)\n *   - `cwd` is not inside a git worktree\n *   - `git` is not available on PATH\n *\n * Never throws.\n */\nexport async function resolveGitContext(\n  cwd: string,\n  options: ResolveGitContextOptions = {},\n): Promise<GitContext | null> {\n  // Wrap the whole body so the documented \"Never throws\" contract is\n  // enforced. Possible throw sites include:\n  //   - `expandTildePath` → `resolveHomeDir()` → `os.homedir()` when HOME\n  //     is unset (e.g. minimal containers)\n  //   - a custom `options.invoker` that raises instead of returning a\n  //     non-zero exitCode\n  //   - any future helper added to this chain\n  // All of those map to \"not in a repo\" / `null`.\n  try {\n    // Validate input: must be a non-empty string.\n    if (typeof cwd !== \"string\" || cwd.length === 0) return null;\n\n    // Expand `~` per CLAUDE.md #17, then require absolute path.\n    const expanded = expandTildePath(cwd);\n    if (!path.isAbsolute(expanded)) return null;\n\n    const invoker = options.invoker ?? defaultGitInvoker();\n\n    // 1. Locate the repo root.\n    const topLevel = invoker(expanded, [\"rev-parse\", \"--show-toplevel\"]);\n    if (topLevel.exitCode !== 0) return null;\n    const rootPath = topLevel.stdout.trim();\n    if (!rootPath) return null;\n\n    // 2. Current branch. `--abbrev-ref HEAD` returns `HEAD` in detached\n    //    state, which we normalize to `null`. On a fresh `git init` the\n    //    HEAD ref is unborn and `--abbrev-ref HEAD` fails, but\n    //    `symbolic-ref HEAD` still returns the target branch. Fall back\n    //    so newly-initialized repos get a sensible branch name.\n    const branchResult = invoker(rootPath, [\"rev-parse\", \"--abbrev-ref\", \"HEAD\"]);\n    let branch: string | null = null;\n    if (branchResult.exitCode === 0) {\n      const raw = branchResult.stdout.trim();\n      branch = raw && raw !== \"HEAD\" ? raw : null;\n    } else {\n      const unbornRef = invoker(rootPath, [\"symbolic-ref\", \"--quiet\", \"HEAD\"]);\n      if (unbornRef.exitCode === 0) {\n        const raw = unbornRef.stdout.trim();\n        const prefix = \"refs/heads/\";\n        if (raw.startsWith(prefix)) {\n          const candidate = raw.slice(prefix.length);\n          if (candidate) branch = candidate;\n        }\n      }\n    }\n\n    // 3. Origin URL — optional. Used to derive a stable `projectId`.\n    const originResult = invoker(rootPath, [\"remote\", \"get-url\", \"origin\"]);\n    let projectId: string;\n    if (originResult.exitCode === 0) {\n      const normalized = normalizeOriginUrl(originResult.stdout);\n      projectId = normalized ? `origin:${stableHash(normalized)}` : `root:${stableHash(rootPath)}`;\n    } else {\n      projectId = `root:${stableHash(rootPath)}`;\n    }\n\n    // 4. Default branch — best effort.\n    const headRef = invoker(rootPath, [\"symbolic-ref\", \"--quiet\", \"refs/remotes/origin/HEAD\"]);\n    let defaultBranch: string | null = null;\n    if (headRef.exitCode === 0) {\n      const raw = headRef.stdout.trim();\n      const prefix = \"refs/remotes/origin/\";\n      if (raw.startsWith(prefix)) {\n        const candidate = raw.slice(prefix.length);\n        if (candidate) defaultBranch = candidate;\n      }\n    }\n\n    return {\n      projectId,\n      branch,\n      rootPath,\n      defaultBranch,\n    };\n  } catch {\n    // Never throws — any unexpected error falls back to \"not in a repo\".\n    return null;\n  }\n}\n","/**\n * Coding-agent namespace overlay (issue #569 PR 2 + PR 3).\n *\n * Given a `CodingContext` (from `resolveGitContext`) and a `CodingModeConfig`,\n * returns the namespace that recall + write paths should use — or `null` when\n * no overlay should apply (coding mode disabled, no context supplied, or\n * feature flags off).\n *\n * PR 2 ships the project overlay. PR 3 will add the branch overlay; the\n * function here already handles both flags so the schema / types / plumbing\n * don't have to change a second time when branch-scope lands.\n *\n * Pure function — no orchestrator, no config side-effects. Callers keep rule\n * 42 (read + write through same namespace layer) by consulting the same\n * function on both paths.\n */\n\nimport type { CodingContext, CodingModeConfig } from \"../types.js\";\nimport { stableHash } from \"./git-context.js\";\n\nexport interface CodingNamespaceOverlay {\n  /**\n   * Effective namespace to use for this session's memory operations. When\n   * `branchScope` is on, takes the form `project:<id>/branch:<b>`; otherwise\n   * `project:<id>`.\n   */\n  namespace: string;\n  /**\n   * Read fallbacks — additional namespaces a caller should include in recall\n   * so that, for example, a branch-scoped session still sees project-level\n   * memories that were written before the branch scope was enabled.\n   *\n   * Writes MUST go to `namespace` only; these are read-side only.\n   *\n   * Introduced to carry PR 3's branch→project fallback; PR 2 returns an empty\n   * array here.\n   */\n  readFallbacks: string[];\n  /**\n   * `\"project\"` when only project scope applies, `\"branch\"` when branch scope\n   * is also layered on. Used for diagnostics (`remnic doctor`) and logging.\n   */\n  scope: \"project\" | \"branch\";\n}\n\n// ──────────────────────────────────────────────────────────────────────────\n// Sanitization\n// ──────────────────────────────────────────────────────────────────────────\n\n/**\n * Normalize a projectId / branch fragment so the resulting namespace passes\n * the router's `isSafeRouteNamespace` check (`[A-Za-z0-9._-]{1,64}`).\n *\n * Namespaces are used as filesystem directory names and must not contain\n * path separators (`/`, `\\`) or colons — so both `:` and `/` collapse to `-`.\n * The project-id format `origin:<8hex>` and branch names like `feat/x` both\n * flow through this helper before hitting the storage layer.\n *\n * NOT a security boundary — projectIds come from `resolveGitContext` (known\n * hex), and branch names come from local git. This defends against corrupt\n * input only.\n */\n/**\n * Single-pass sanitization — each input character is visited exactly once.\n * Rewriting as an explicit loop (instead of chained `replace()` calls with\n * greedy quantifiers) closes the polynomial-backtracking surface that\n * CodeQL flagged on patterns like `-+` and `^-+|-+$`.\n */\nfunction sanitizeFragment(input: string): string {\n  if (typeof input !== \"string\") return \"\";\n  const trimmed = input.trim().toLowerCase();\n  let out = \"\";\n  let prevIsDash = true; // suppress leading dashes\n  for (let i = 0; i < trimmed.length; i += 1) {\n    const c = trimmed[i]!;\n    const cc = trimmed.charCodeAt(i);\n    const isSafe =\n      (cc >= 48 && cc <= 57) /* 0-9 */ ||\n      (cc >= 97 && cc <= 122) /* a-z */ ||\n      cc === 46 /* . */ ||\n      cc === 95 /* _ */;\n    if (isSafe) {\n      out += c;\n      prevIsDash = false;\n    } else if (!prevIsDash) {\n      out += \"-\";\n      prevIsDash = true;\n    }\n  }\n  // Strip a single trailing dash introduced by the final run of unsafe chars.\n  if (out.endsWith(\"-\")) out = out.slice(0, -1);\n  return out;\n}\n\n/**\n * Cap to the router's per-namespace upper bound.\n *\n * Raw truncation alone would collapse distinct long inputs that differ near\n * the end (e.g. two `feat/...` branches with different suffixes) into the\n * same namespace — silently mixing recall/write state across branches or\n * projects. When truncation is needed, we append a short deterministic\n * hash suffix (`-<8hex>`) derived from the FULL pre-truncated value so\n * collisions only happen under true hash collisions, not simple prefix\n * overlap.\n *\n * The tail is trimmed to leave room for the separator and 8-char hash and\n * any trailing `-` introduced by the slice is stripped so the final\n * character before `-<hash>` is always alphanumeric or `.`/`_`.\n */\nconst MAX_NAMESPACE_LEN = 64;\nconst HASH_SUFFIX_LEN = 9; // \"-\" + 8 hex chars\n\nfunction capLength(value: string): string {\n  if (value.length <= MAX_NAMESPACE_LEN) return value;\n  // Reuse the FNV-1a 32-bit hash from git-context — one canonical\n  // implementation, one set of edge-case fixes. Uses Math.imul for\n  // correct 32-bit wrap-around, which plain `*` would not guarantee\n  // for the largest intermediate products.\n  const hash = stableHash(value);\n  // Trim trailing '-' with a linear, non-backtracking loop. A regex\n  // like `-+$` is linear too, but an explicit loop keeps CodeQL happy\n  // about polynomial backtracking warnings when several `\\-+` patterns\n  // appear in the same module.\n  let end = MAX_NAMESPACE_LEN - HASH_SUFFIX_LEN;\n  while (end > 0 && value.charCodeAt(end - 1) === 45 /* '-' */) end -= 1;\n  return `${value.slice(0, end)}-${hash}`;\n}\n\n/**\n * Produce the project-scope namespace name. Exported for tests and for\n * `remnic doctor` to render. Guaranteed to satisfy `isSafeRouteNamespace`:\n * no `/`, no `:`, lowercase only, length-capped to 64 chars.\n */\nexport function projectNamespaceName(projectId: string): string {\n  const frag = sanitizeFragment(projectId);\n  return capLength(`project-${frag || \"unknown\"}`);\n}\n\nexport function projectTagProjectId(projectTag: string): string {\n  const trimmed = projectTag.trim();\n  const frag = sanitizeFragment(trimmed);\n  const disambig = trimmed.length > 0 && frag !== trimmed;\n  const suffix = disambig ? `-${stableHash(trimmed)}` : \"\";\n  return `tag:${frag || \"unknown\"}${suffix}`;\n}\n\n/**\n * Preserve case when sanitizing a principal-derived base namespace. The\n * router's `isSafeRouteNamespace` check accepts `[A-Za-z0-9._-]{1,64}`, so\n * upper-case characters in the principal name are safe and MUST be kept to\n * avoid colliding two otherwise-distinct principals (e.g. `Alice` vs\n * `alice`) into the same combined namespace.\n *\n * Otherwise identical to `sanitizeFragment`: single-pass, linear, no\n * polynomial-backtracking quantifiers, unsafe chars collapse to `-` with\n * leading/trailing dashes suppressed.\n */\nfunction sanitizeBaseFragment(input: string): string {\n  if (typeof input !== \"string\") return \"\";\n  const trimmed = input.trim();\n  let out = \"\";\n  let prevIsDash = true;\n  for (let i = 0; i < trimmed.length; i += 1) {\n    const c = trimmed[i]!;\n    const cc = trimmed.charCodeAt(i);\n    const isSafe =\n      (cc >= 48 && cc <= 57) /* 0-9 */ ||\n      (cc >= 65 && cc <= 90) /* A-Z */ ||\n      (cc >= 97 && cc <= 122) /* a-z */ ||\n      cc === 46 /* . */ ||\n      cc === 95 /* _ */;\n    if (isSafe) {\n      out += c;\n      prevIsDash = false;\n    } else if (!prevIsDash) {\n      out += \"-\";\n      prevIsDash = true;\n    }\n  }\n  if (out.endsWith(\"-\")) out = out.slice(0, -1);\n  return out;\n}\n\n/**\n * Combine a principal-derived base namespace (e.g. `default`, `alice`) with a\n * coding-agent overlay namespace (e.g. `project-origin-abcd1234`). The result\n * is a single safe-route token that preserves principal isolation (CLAUDE.md\n * rule 42: read + write must resolve through the same namespace layer — and\n * here, through the same principal-scoped prefix) while layering project or\n * project/branch scope on top.\n *\n * Multiple principals working in the same repo thus get distinct namespaces:\n *\n *   alice + project-origin-ab12  →  alice-project-origin-ab12\n *   bob   + project-origin-ab12  →  bob-project-origin-ab12\n *   Alice + project-origin-ab12  →  Alice-project-origin-ab12 (distinct)\n *\n * The base fragment preserves case so `Alice` and `alice` remain distinct;\n * the overlay fragment is still lowercase-sanitized because it derives from\n * deterministic, pre-lowercased git hashes.\n *\n * Output is re-capped through `capLength` so a very long base + overlay\n * combination still fits inside `isSafeRouteNamespace` (≤ 64 chars). The\n * deterministic hash suffix on truncation keeps distinct inputs distinct.\n */\nexport function combineNamespaces(base: string, overlay: string): string {\n  const baseFrag = sanitizeBaseFragment(base);\n  const overlayFrag = sanitizeFragment(overlay);\n  if (!baseFrag) return capLength(overlayFrag || \"unknown\");\n  if (!overlayFrag) return capLength(baseFrag);\n  return capLength(`${baseFrag}-${overlayFrag}`);\n}\n\n/**\n * Produce the branch-scope namespace name. Format:\n * `project-<id>-branch-<name>[-<hash>]`. Uses `-` as the structural separator\n * rather than `/` or `:` so the result is a single safe route-namespace\n * token that can be used directly as a filesystem directory.\n *\n * Two failure modes must not collapse distinct branches to one namespace:\n *\n *   1. Sanitization is lossy (`feat/x` and `feat-x` both sanitize to\n *      `feat-x`; `Feature` and `feature` both sanitize to `feature`). When\n *      sanitization rewrote any character, we append a short hash of the\n *      RAW branch so distinct inputs stay distinct.\n *   2. Truncation is applied when the total exceeds 64 chars. In that\n *      mode `capLength` appends its own hash of the full pre-truncated\n *      value.\n *\n * Long branches that also sanitize may receive both kinds of hashes — that\n * is acceptable: the router only requires the result be unique and\n * deterministic, and the two hashes derive from different domains so they\n * don't conflict.\n */\nexport function branchNamespaceName(projectId: string, branch: string): string {\n  const projectFrag = sanitizeFragment(projectId);\n  const trimmedBranch = branch.trim();\n  const branchFrag = sanitizeFragment(trimmedBranch);\n  // Lossy-sanitization disambiguator: append hash of the raw (trimmed)\n  // branch when sanitization actually changed the string. Preserves\n  // distinctness across `feat/x` vs `feat-x` and `Feature` vs `feature`.\n  // The comparison uses the raw trimmed value (NOT `.toLowerCase()`) so\n  // case-only variants are treated as lossy and receive their own hash.\n  // Empty / already-safe-lowercase inputs get no hash so the common case\n  // stays readable.\n  const disambig = trimmedBranch.length > 0 && branchFrag !== trimmedBranch;\n  const base = `project-${projectFrag || \"unknown\"}-branch-${branchFrag || \"unknown\"}`;\n  const suffixed = disambig ? `${base}-${stableHash(trimmedBranch)}` : base;\n  return capLength(suffixed);\n}\n\n// ──────────────────────────────────────────────────────────────────────────\n// Overlay resolver\n// ──────────────────────────────────────────────────────────────────────────\n\n/**\n * Compute the namespace overlay for a session.\n *\n * Returns `null` when no overlay applies — callers should then use their\n * existing `defaultNamespaceForPrincipal(...)` result unchanged. This keeps\n * CLAUDE.md #30 (escape hatch): setting `codingMode.projectScope: false`\n * exactly restores pre-#569 behaviour at every call site.\n *\n * @param codingContext — git context from the connector\n * @param config — coding mode flags (projectScope, branchScope, globalFallback)\n * @param defaultNamespace — retained for call-site compatibility; no longer\n *   used. The global fallback is expressed as an empty-string sentinel in\n *   `readFallbacks`, which `combineNamespaces(principal, \"\")` resolves to the\n *   principal's own namespace at the call site.\n */\nexport function resolveCodingNamespaceOverlay(\n  codingContext: CodingContext | null | undefined,\n  config: Pick<CodingModeConfig, \"projectScope\" | \"branchScope\" | \"globalFallback\">,\n  defaultNamespace?: string,\n): CodingNamespaceOverlay | null {\n  // No context supplied (session isn't in a git repo, or connector didn't\n  // attach one) → no overlay.\n  if (!codingContext) return null;\n\n  // Project scope disabled → no overlay at all. Branch scope depends on\n  // project scope being on; there is no branch-only mode.\n  if (!config.projectScope) return null;\n\n  // Require a non-empty projectId — defensive.\n  const projectId = typeof codingContext.projectId === \"string\" ? codingContext.projectId.trim() : \"\";\n  if (!projectId) return null;\n\n  const projectNs = projectNamespaceName(projectId);\n\n  // Root/global namespace fallback: when `globalFallback` is true, include\n  // the principal's self namespace in readFallbacks so cross-project knowledge\n  // remains visible. CLAUDE.md #30: the gate is `globalFallback` — set to\n  // false for strict project isolation.\n  //\n  // The fallback value is \"\" (empty string), NOT the defaultNamespace name.\n  // The orchestrator passes each fallback through combineNamespaces(principal, fallback),\n  // and combineNamespaces(base, \"\") returns base unchanged — yielding the\n  // principal's own namespace. Using the actual namespace name (e.g., \"default\")\n  // would produce \"default-default\" after combination, missing the target.\n  const includeRoot = config.globalFallback === true;\n\n  // Branch-scope layering (PR 3):\n  //   - only when config.branchScope is explicitly true\n  //   - only when we actually have a branch (null in detached HEAD)\n  //   - project namespace becomes a read fallback so project-level memories\n  //     remain visible from any branch (deliberate asymmetry — branch writes\n  //     don't leak up, but project reads leak down).\n  //   - when globalFallback is on, the root namespace is also appended so\n  //     globally useful memories surface in every branch.\n  if (config.branchScope && typeof codingContext.branch === \"string\" && codingContext.branch.length > 0) {\n    const branchNs = branchNamespaceName(projectId, codingContext.branch);\n    const fallbacks = [projectNs];\n    if (includeRoot) fallbacks.push(\"\");\n    return {\n      namespace: branchNs,\n      readFallbacks: fallbacks,\n      scope: \"branch\",\n    };\n  }\n\n  return {\n    namespace: projectNs,\n    readFallbacks: includeRoot ? [\"\"] : [],\n    scope: \"project\",\n  };\n}\n\n// ──────────────────────────────────────────────────────────────────────────\n// Diagnostics (issue #569 PR 3 + PR 8)\n// ──────────────────────────────────────────────────────────────────────────\n\nexport interface CodingScopeDescription {\n  /** \"none\" when no overlay is active; otherwise the resolved scope level. */\n  scope: \"none\" | \"project\" | \"branch\";\n  /** Project id (raw, not sanitized) when a context is attached. */\n  projectId: string | null;\n  /** Branch name (raw, not sanitized) when available. */\n  branch: string | null;\n  /** Effective namespace writes route to. `null` when no overlay applies. */\n  effectiveNamespace: string | null;\n  /** Read fallbacks included in recall (non-empty only when branch-scope is on). */\n  readFallbacks: string[];\n  /**\n   * Why no overlay applies, when `scope === \"none\"`. One of:\n   *   - `\"no-context\"`  — connector didn't attach a CodingContext\n   *   - `\"disabled\"`   — codingMode.projectScope is false\n   *   - `\"empty-project\"` — codingContext.projectId was empty/whitespace\n   */\n  disabledReason: \"no-context\" | \"disabled\" | \"empty-project\" | null;\n}\n\n/**\n * Human-readable description of the coding-agent scope that currently applies\n * for a session. Consumed by `remnic doctor` (PR 8) and by logs to surface\n * why recall routes where it does.\n *\n * Pure — callers pass the coding context + config they already have.\n */\nexport function describeCodingScope(\n  codingContext: CodingContext | null | undefined,\n  config: Pick<CodingModeConfig, \"projectScope\" | \"branchScope\" | \"globalFallback\">,\n  defaultNamespace?: string,\n): CodingScopeDescription {\n  const projectId = codingContext?.projectId ?? null;\n  const branch = codingContext?.branch ?? null;\n\n  if (!codingContext) {\n    return {\n      scope: \"none\",\n      projectId: null,\n      branch: null,\n      effectiveNamespace: null,\n      readFallbacks: [],\n      disabledReason: \"no-context\",\n    };\n  }\n  if (!config.projectScope) {\n    return {\n      scope: \"none\",\n      projectId,\n      branch,\n      effectiveNamespace: null,\n      readFallbacks: [],\n      disabledReason: \"disabled\",\n    };\n  }\n  const trimmedId = typeof projectId === \"string\" ? projectId.trim() : \"\";\n  if (!trimmedId) {\n    return {\n      scope: \"none\",\n      projectId,\n      branch,\n      effectiveNamespace: null,\n      readFallbacks: [],\n      disabledReason: \"empty-project\",\n    };\n  }\n\n  const overlay = resolveCodingNamespaceOverlay(codingContext, config, defaultNamespace);\n  // Unreachable in practice given the guards above, but keep the return\n  // shape consistent if the resolver grows new null branches later.\n  if (!overlay) {\n    return {\n      scope: \"none\",\n      projectId,\n      branch,\n      effectiveNamespace: null,\n      readFallbacks: [],\n      disabledReason: \"disabled\",\n    };\n  }\n  return {\n    scope: overlay.scope,\n    projectId,\n    branch,\n    effectiveNamespace: overlay.namespace,\n    readFallbacks: overlay.readFallbacks,\n    disabledReason: null,\n  };\n}\n","/**\n * Generic reinforcement-core primitives extracted from `procedure-miner.ts`\n * (issue #687 PR 1/4). Procedure-specific scoring (success rate, step\n * normalization) intentionally stays in the miner — this module only\n * exposes category-agnostic clustering and cluster summarization helpers\n * so future PRs can run reinforcement across non-procedural categories.\n *\n * Pure refactor — no behavior change.\n */\n\n/**\n * Group `items` into clusters keyed by `keyFn(item)`.\n *\n * - Preserves the original input order within each cluster's array.\n * - The returned `Map` insertion order matches first-seen key order, so\n *   downstream iteration is deterministic for a given input.\n * - Throws `TypeError` if `keyFn` returns a non-string (e.g. `undefined`,\n *   `null`, or a number). Callers must produce a stable string key.\n */\nexport function clusterByKey<T>(items: readonly T[], keyFn: (item: T) => string): Map<string, T[]> {\n  const clusters = new Map<string, T[]>();\n  for (const item of items) {\n    const key = keyFn(item);\n    if (typeof key !== \"string\") {\n      throw new TypeError(\n        `clusterByKey: keyFn must return a string, got ${key === null ? \"null\" : typeof key}`,\n      );\n    }\n    const existing = clusters.get(key);\n    if (existing) {\n      existing.push(item);\n    } else {\n      clusters.set(key, [item]);\n    }\n  }\n  return clusters;\n}\n\nexport interface ClusterSummary {\n  /** Number of items in the cluster. */\n  count: number;\n  /** Earliest timestamp seen in the cluster (string min via `localeCompare`). */\n  firstSeen: string;\n  /** Latest timestamp seen in the cluster (string max via `localeCompare`). */\n  lastSeen: string;\n}\n\n/**\n * Summarize a cluster by counting items and tracking earliest/latest\n * timestamps. Timestamp comparison uses `String#localeCompare`, which is\n * correct for ISO-8601 strings (lexicographic order matches chronological\n * order).\n *\n * - Throws `RangeError` on empty clusters — `firstSeen`/`lastSeen` are not\n *   meaningful without at least one item.\n * - When all timestamps are equal, `firstSeen === lastSeen`.\n */\nexport function summarizeCluster<T>(\n  cluster: readonly T[],\n  extractTimestamp: (item: T) => string,\n): ClusterSummary {\n  if (cluster.length === 0) {\n    throw new RangeError(\"summarizeCluster: cluster must contain at least one item\");\n  }\n  let firstSeen = extractTimestamp(cluster[0]);\n  let lastSeen = firstSeen;\n  for (let i = 1; i < cluster.length; i += 1) {\n    const ts = extractTimestamp(cluster[i]);\n    if (ts.localeCompare(firstSeen) < 0) firstSeen = ts;\n    if (ts.localeCompare(lastSeen) > 0) lastSeen = ts;\n  }\n  return { count: cluster.length, firstSeen, lastSeen };\n}\n"],"mappings":"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","names":[]}