@remnic/core 9.69.37 → 9.69.39

package/dist/coding/export-okf-codegraph.js

@@ -15,27 +15,27 @@ import {
   listCodegraphProjects,
   parseDecisionRecord,
   resolveCodegraphDbPath
-} from "../chunk-TK4FHQRN.js";
+} from "../chunk-2J3V5QEO.js";
 import {
   buildCodingGraphInstallHint,
   isCodingGraphInstalled
 } from "../chunk-VQ7B2Q6M.js";
 import {
   StorageManager
-} from "../chunk-ZEPVWLCN.js";
-import "../chunk-UHVXE24Y.js";
+} from "../chunk-CZTPU65V.js";
 import "../chunk-46WM6JX2.js";
+import "../chunk-UHVXE24Y.js";
 import "../chunk-D5F7TKMH.js";
-import "../chunk-7RKBPXY6.js";
-import "../chunk-Q6D7EUSQ.js";
-import "../chunk-BD7JTBYP.js";
-import "../chunk-OB3XMWX5.js";
-import "../chunk-CYEPCZN5.js";
+import "../chunk-6YAIN5XJ.js";
+import "../chunk-4JVQRFZD.js";
 import "../chunk-TNSCIPBQ.js";
 import "../chunk-YQNNHLCG.js";
-import "../chunk-4O6WRBGE.js";
 import "../chunk-6KTXE6A3.js";
+import "../chunk-BD7JTBYP.js";
+import "../chunk-OB3XMWX5.js";
+import "../chunk-4O6WRBGE.js";
 import "../chunk-GUMZC2BO.js";
+import "../chunk-CYEPCZN5.js";
 import "../chunk-TFA6HPOA.js";
 import "../chunk-F4TWWUMP.js";
 import "../chunk-72A4L5JJ.js";
@@ -46,13 +46,13 @@ import {
   OKF_CODE_MODULE_TYPE,
   OKF_DECISION_RECORD_TYPE
 } from "../chunk-PCEYGOSL.js";
-import "../chunk-RN3MVLW3.js";
-import "../chunk-S2HLHAZ4.js";
+import "../chunk-IYKZJVL5.js";
 import "../chunk-SCU65EZI.js";
 import "../chunk-MRPOZBJC.js";
+import "../chunk-S2HLHAZ4.js";
 import "../chunk-DM2T26WE.js";
 import "../chunk-LDXUBPMO.js";
-import "../chunk-S2ULTQZR.js";
+import "../chunk-3N3PBBEH.js";
 import "../chunk-AAD2ZS6P.js";
 import "../chunk-SHEHQBCG.js";
 import "../chunk-3ONXXHQO.js";
@@ -70,25 +70,29 @@ import "../chunk-3CBI2ZSA.js";
 import "../chunk-JXN77SGO.js";
 import "../chunk-ZLQ37WJX.js";
 import "../chunk-IUM3VSHI.js";
+import "../chunk-GDYU6VF4.js";
+import "../chunk-BT7NVCML.js";
 import "../chunk-C64XATK7.js";
 import "../chunk-42JKGUFJ.js";
-import "../chunk-YEN4TREG.js";
+import "../chunk-LQNRVPTV.js";
 import "../chunk-I55KAVET.js";
 import "../chunk-L2EXJQJP.js";
 import "../chunk-45GF7Y3V.js";
-import "../chunk-65RENJGB.js";
+import "../chunk-CWTCMZGE.js";
+import "../chunk-E2AWJ7KQ.js";
 import "../chunk-FEHIOYML.js";
 import "../chunk-P32IDSHD.js";
-import "../chunk-353KGBKY.js";
+import "../chunk-RW4QNB4J.js";
 import "../chunk-ZIKENA2C.js";
+import "../chunk-VYCOJKSX.js";
 import "../chunk-6Q3ZTEF6.js";
-import "../chunk-RGMVMVMF.js";
+import "../chunk-PJKTFXE2.js";
 import "../chunk-W5BIQOAJ.js";
 import "../chunk-Z7L72ZHL.js";
 import "../chunk-4O4TKIXQ.js";
+import "../chunk-RGMVMVMF.js";
 import "../chunk-YCVB7X56.js";
 import "../chunk-PQVCH2AE.js";
-import "../chunk-PJKTFXE2.js";
 import "../chunk-TG3FAM2S.js";
 import "../chunk-TBXAY2SS.js";
 import "../chunk-ZA53AZND.js";
@@ -97,14 +101,8 @@ import {
   openBetterSqlite3
 } from "../chunk-RL6NEVXT.js";
 import "../chunk-C7HJ3NEI.js";
+import "../chunk-37CAEC7E.js";
 import "../chunk-7RJUVTVF.js";
-import "../chunk-PWPIERBM.js";
-import "../chunk-BJMBJZ2Y.js";
-import "../chunk-UKJAGEXH.js";
-import "../chunk-FP2373TW.js";
-import "../chunk-LSLCFCCQ.js";
-import "../chunk-BT7NVCML.js";
-import "../chunk-VYCOJKSX.js";
 import "../chunk-NB3LRY4T.js";
 import "../chunk-5FVVY2EB.js";
 import "../chunk-FFAZ2XFU.js";
@@ -113,9 +111,12 @@ import {
 } from "../chunk-JDSVLVCG.js";
 import "../chunk-5GKPFL3S.js";
 import "../chunk-JAKIDQB2.js";
-import "../chunk-P7FMDTKL.js";
 import "../chunk-VUFL7X3H.js";
 import "../chunk-JUOZ62Y7.js";
+import "../chunk-BJMBJZ2Y.js";
+import "../chunk-UKJAGEXH.js";
+import "../chunk-FP2373TW.js";
+import "../chunk-P7FMDTKL.js";
 import {
   defaultGitInvoker,
   normalizeOriginUrl,

package/dist/coding/export-okf-codegraph.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/coding/export-okf-codegraph.ts"],"sourcesContent":["/**\n * Codegraph OKF projection (issue #1950).\n *\n * Read-only projection of one project's code-graph SQLite store into an\n * OKF v0.1 knowledge bundle: the stored architecture card, decision\n * records, and one `Code Module` concept per indexed source file with its\n * symbols and outgoing edges. The store is NEVER opened for write — the\n * SQLite file is opened `readonly`, so an export cannot mutate indexing\n * state and the file's bytes are stable across runs.\n *\n * Rendering discipline mirrors architecture-card.ts (rule 38): byte-stable\n * output for an unchanged graph; every list is sorted with a total order.\n * Shared bundle mechanics come from ../okf/render.ts (one source of truth\n * with the memory exporter, issue #1948).\n */\nimport { existsSync, readdirSync, rmSync, statSync } from \"node:fs\";\nimport { mkdtemp } from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\nimport { lintOkfDir } from \"../okf/lint.js\";\nimport {\n  OKF_ARCHITECTURE_CARD_TYPE,\n  OKF_CODE_MODULE_TYPE,\n  OKF_DECISION_RECORD_TYPE,\n} from \"../okf/type-mapping.js\";\nimport {\n  OKF_EXPORT_VERSION,\n  publishBundle,\n  renderFrontmatter,\n  rejectSymlinkPath,\n  writeBundleFile,\n} from \"../okf/render.js\";\nimport { openBetterSqlite3 } from \"../runtime/better-sqlite.js\";\nimport { StorageManager, stripAttributesSuffix } from \"../storage.js\";\nimport type { PluginConfig } from \"../types.js\";\nimport { findArchitectureCardMemory, type ArchitectureSurfaceStorage } from \"./architecture-surfaces.js\";\nimport {\n  CodegraphRuntimeError,\n  codegraphSurfaceVisible,\n  listCodegraphProjects,\n  resolveCodegraphDbPath,\n} from \"./codegraph-runtime.js\";\nimport { defaultGitInvoker, normalizeOriginUrl } from \"./git-context.js\";\nimport { projectNamespaceName } from \"./coding-namespace.js\";\nimport {\n  ACTIVE_DECISION_STATUSES,\n  DECISION_STATUSES,\n  parseDecisionRecord,\n  type DecisionRecord,\n} from \"./decision-records.js\";\nimport { buildCodingGraphInstallHint, isCodingGraphInstalled } from \"./optional-coding-graph.js\";\n\n/** Default cap on rendered module concepts (`--max-module-concepts`). */\nexport const DEFAULT_OKF_CODEGRAPH_MAX_MODULE_CONCEPTS = 500;\n\n/**\n * Visible marker written into the root index when module concepts were\n * truncated (mirrors `ARCHITECTURE_CARD_TRUNCATION_MARKER` — never\n * silently incomplete).\n */\nexport const OKF_CODEGRAPH_TRUNCATION_MARKER = \"<!-- okf-codegraph-truncated -->\";\n\nexport type OkfCodegraphSymbolFilter = \"none\" | \"exported\" | \"all\";\n\nconst SYMBOL_FILTERS: readonly OkfCodegraphSymbolFilter[] = [\"none\", \"exported\", \"all\"];\n\nexport function parseOkfCodegraphSymbolFilter(raw: unknown): OkfCodegraphSymbolFilter {\n  const value = typeof raw === \"string\" ? raw.trim().toLowerCase() : \"\";\n  if (value.length === 0) return \"exported\";\n  if ((SYMBOL_FILTERS as readonly string[]).includes(value)) return value as OkfCodegraphSymbolFilter;\n  throw new Error(`invalid --symbols ${String(raw)}; allowed: ${SYMBOL_FILTERS.join(\", \")}`);\n}\n\nexport interface ExportOkfCodegraphOptions {\n  readonly config: PluginConfig;\n  readonly memoryDir: string;\n  /** Store owner; defaults to `\"default\"` like the access-service principal key. */\n  readonly principal?: string;\n  readonly projectId: string;\n  readonly outDir: string;\n  /**\n   * Working directory used to resolve git context (repo root, origin URL).\n   * Defaults to `process.cwd()`.\n   */\n  readonly cwd?: string;\n  readonly maxModuleConcepts?: number;\n  readonly symbols?: OkfCodegraphSymbolFilter;\n  /** Default ON; pass `false` for `--no-include-adrs`. */\n  readonly includeAdrs?: boolean;\n  readonly force?: boolean;\n  /**\n   * Namespace holding the project's decision records + architecture card.\n   * Defaults to the project-scope coding namespace for the project id.\n   */\n  readonly namespace?: string;\n}\n\nexport interface ExportOkfCodegraphResult {\n  readonly projectId: string;\n  readonly moduleConcepts: number;\n  readonly moduleFilesInGraph: number;\n  readonly truncated: boolean;\n  readonly decisions: number;\n  readonly architectureCard: boolean;\n}\n\ninterface GraphFileRow {\n  readonly id: number;\n  readonly path: string;\n  readonly lang: string;\n}\n\ninterface GraphNodeRow {\n  readonly name: string;\n  readonly label: string;\n  readonly file_id: number;\n  readonly span_start: number;\n  readonly span_end: number;\n  readonly is_exported: number;\n}\n\ninterface GraphEdgeRow {\n  readonly type: string;\n  readonly confidence: number;\n  readonly src_file_id: number;\n  readonly dst_file_id: number;\n  readonly dst_name: string;\n  readonly dst_path: string;\n}\n\nexport async function exportCodegraphOkfBundle(\n  opts: ExportOkfCodegraphOptions,\n): Promise<ExportOkfCodegraphResult> {\n  if (!codegraphSurfaceVisible(opts.config)) {\n    throw new CodegraphRuntimeError(\n      \"disabled\",\n      \"codegraph tools are disabled (codingKnowledge.enabled or codingKnowledge.codegraphTools is false)\",\n    );\n  }\n  if (!(await isCodingGraphInstalled())) {\n    throw new CodegraphRuntimeError(\"package_missing\", buildCodingGraphInstallHint());\n  }\n  const principal = opts.principal?.trim() || \"default\";\n  const projectId = opts.projectId.trim();\n  if (projectId.length === 0) {\n    throw new CodegraphRuntimeError(\n      \"project_required\",\n      \"codegraph export-okf requires --project (or a cwd inside the project's git repo)\",\n    );\n  }\n  rejectSymlinkPath(path.resolve(opts.outDir));\n  // Explicit option validation (config-coercion footgun): honor the given\n  // value or fail loudly — never silently default a bad input. `0` is a\n  // legitimate \"no module concepts\" cap and is honored.\n  const maxModules = opts.maxModuleConcepts ?? DEFAULT_OKF_CODEGRAPH_MAX_MODULE_CONCEPTS;\n  if (!Number.isInteger(maxModules) || maxModules < 0) {\n    throw new Error(\n      `invalid --max-module-concepts ${String(opts.maxModuleConcepts)}; must be a non-negative integer`,\n    );\n  }\n  const dbPath = resolveCodegraphDbPath({ config: opts.config, memoryDir: opts.memoryDir, principal, projectId });\n  if (!existsSync(dbPath)) {\n    const known = listCodegraphProjects({\n      config: opts.config,\n      memoryDir: opts.memoryDir,\n      principal,\n      listDir: (dir) => {\n        try {\n          return readdirSync(dir);\n        } catch {\n          return [];\n        }\n      },\n    });\n    throw new CodegraphRuntimeError(\n      \"project_not_found\",\n      `no codegraph store for project '${projectId}' (principal '${principal}'); known projects: ${\n        known.length > 0 ? known.join(\", \") : \"(none)\"\n      }`,\n    );\n  }\n\n  // Read the graph through a readonly handle — bytes on disk are never\n  // touched, and the store cache (write-mode handles) is bypassed entirely.\n  const graphIndexedAt = statSync(dbPath).mtime.toISOString();\n  const db = openBetterSqlite3(dbPath, { readonly: true, fileMustExist: true });\n  let files: GraphFileRow[];\n  let nodes: GraphNodeRow[];\n  let edges: GraphEdgeRow[];\n  try {\n    files = db.prepare(\"SELECT id, path, lang FROM files ORDER BY path ASC\").all() as GraphFileRow[];\n    nodes = db\n      .prepare(\n        `SELECT n.name, n.label, n.file_id, n.span_start, n.span_end,\n                COALESCE(na.is_exported, 0) AS is_exported\n           FROM nodes n LEFT JOIN node_attributes na ON na.node_id = n.id`,\n      )\n      .all() as GraphNodeRow[];\n    edges = db\n      .prepare(\n        `SELECT e.type, e.confidence, s.file_id AS src_file_id, d.file_id AS dst_file_id,\n                d.name AS dst_name, df.path AS dst_path\n           FROM edges e\n           JOIN nodes s ON s.id = e.src\n           JOIN nodes d ON d.id = e.dst\n           JOIN files df ON d.file_id = df.id`,\n      )\n      .all() as GraphEdgeRow[];\n  } finally {\n    db.close();\n  }\n\n  // Trust boundary: file paths come from the indexed graph. Reject anything\n  // that is not a strict repo-relative POSIX path so a hostile row cannot\n  // escape the staging directory via writeBundleFile's path.join.\n  const safeFiles = files.filter(\n    (f) => f.path.length > 0 && !f.path.startsWith(\"/\") && !f.path.split(\"/\").includes(\"..\"),\n  );\n  const fileIdToPath = new Map<number, string>(safeFiles.map((f) => [f.id, f.path]));\n  const nodesByFile = new Map<number, GraphNodeRow[]>();\n  for (const node of nodes) {\n    if (!fileIdToPath.has(node.file_id)) continue;\n    const list = nodesByFile.get(node.file_id) ?? [];\n    list.push(node);\n    nodesByFile.set(node.file_id, list);\n  }\n\n  // Deterministic truncation: most symbols first, path ascending as the\n  // tie-break (issue acceptance: cap of 1 keeps the highest-symbol file).\n  const ranked = [...safeFiles].sort((a, b) => {\n    const aCount = (nodesByFile.get(a.id) ?? []).length;\n    const bCount = (nodesByFile.get(b.id) ?? []).length;\n    if (aCount !== bCount) return bCount - aCount;\n    return a.path.localeCompare(b.path);\n  });\n  const keptFiles = ranked.slice(0, maxModules);\n  const keptPaths = new Set<string>(keptFiles.map((f) => f.path));\n  const truncated = safeFiles.length > keptFiles.length;\n\n  const symbolFilter = parseOkfCodegraphSymbolFilter(opts.symbols);\n  const git = await resolveGitHints(opts.cwd ?? process.cwd());\n  const staging = await mkdtemp(path.join(os.tmpdir(), \"remnic-okf-codegraph-\"));\nlet decisions = 0;\nlet architectureCard = false;\ntry {\n  const namespace = opts.namespace?.trim() || projectNamespaceName(projectId);\n    const namespaceDir = path.join(opts.memoryDir, \"namespaces\", namespace);\n    if (opts.includeAdrs !== false && existsSync(namespaceDir)) {\n      const storage = new StorageManager(namespaceDir);\n      const memories = await storage.readAllMemories();\n      // Architecture card — reuse the surface's classification (rule 53).\n      const card = await findArchitectureCardMemory(readOnlyCardStorage(storage, namespaceDir, namespace));\n      if (card) {\n        architectureCard = true;\n        writeBundleFile(\n          staging,\n          \"architecture.md\",\n          renderFrontmatter({\n            type: OKF_ARCHITECTURE_CARD_TYPE,\n            title: git.repoName,\n            ...(git.originUrl ? { resource: git.originUrl } : git.repoRoot ? { resource: git.repoRoot } : {}),\n            timestamp: card.frontmatter.updated ?? card.frontmatter.created,\n          }) +\n            stripAttributesSuffix(card.content.replace(/^\\uFEFF/, \"\")).trimEnd() +\n            \"\\n\",\n        );\n      }\n      const records: Array<{ record: DecisionRecord; timestamp: string }> = [];\n      for (const memory of memories) {\n        if (memory.frontmatter.category !== \"decision\") continue;\n        try {\n          const parsed = parseDecisionRecord(memory.content);\n          records.push({\n            // Production writes leave the ADR frontmatter id empty and use\n            // the memory id as the canonical identifier (decisionRecord\n            // surface path) — prefer the ADR id, fall back to the memory id.\n            record: parsed.id ? parsed : { ...parsed, id: memory.frontmatter.id },\n            timestamp: memory.frontmatter.updated ?? memory.frontmatter.created,\n          });\n        } catch {\n          // Unparseable decision bodies are skipped, mirroring the surface's\n          // safeParseDecisionRecord degradation.\n        }\n      }\n      records.sort((a, b) => a.record.title.localeCompare(b.record.title));\n      decisions = records.length;\n      for (const { record, timestamp } of records) {\n        writeBundleFile(staging, `decisions/${decisionFileStem(record)}.md`, renderDecision(record, timestamp));\n      }\n      if (records.length > 0 || architectureCard) {\n        writeBundleFile(staging, \"decisions/index.md\", renderDecisionsIndex(records));\n      }\n    }\n\n    for (const file of keptFiles) {\n      writeBundleFile(\n        staging,\n        `modules/${file.path}.md`,\n        renderModule(\n          file,\n          nodesByFile.get(file.id) ?? [],\n          edges,\n          fileIdToPath,\n          keptPaths,\n          symbolFilter,\n          git,\n          graphIndexedAt,\n        ),\n      );\n    }\n    if (keptFiles.length > 0) {\n      writeBundleFile(staging, \"modules/index.md\", renderModulesIndex(keptFiles));\n    }\n    writeBundleFile(\n      staging,\n      \"index.md\",\n      renderRootIndex(git.repoName, projectId, architectureCard, decisions, keptFiles, safeFiles, truncated),\n    );\n\n    // Self-validate with the #1946 conformance checker; non-conformant\n    // output fails the command. Reserved basenames (the bundle's own\n    // index.md files) are the documented exemption, as in the memory export.\n    const lint = lintOkfDir(staging);\n    const blocking = lint.findings.filter((f) => f.code !== \"skipped_encrypted\" && f.code !== \"reserved_basename\");\n    if (blocking.length > 0) {\n      throw new Error(`OKF codegraph export failed lint: ${blocking.map((f) => `${f.file}: ${f.message}`).join(\"; \")}`);\n    }\n    publishBundle(staging, path.resolve(opts.outDir), opts.force === true);\n  } catch (err) {\n    rmSync(staging, { recursive: true, force: true });\n    throw err;\n  }\n  return {\n    projectId,\n    moduleConcepts: keptFiles.length,\n    moduleFilesInGraph: safeFiles.length,\n    truncated,\n    decisions,\n    architectureCard,\n  };\n}\n\n/**\n * Read-only adapter over the namespace StorageManager for\n * {@link findArchitectureCardMemory} — write arms throw so a future edit\n * cannot silently turn the exporter into a mutating surface.\n */\nfunction readOnlyCardStorage(\n  storage: StorageManager,\n  dir: string,\n  namespace: string,\n): ArchitectureSurfaceStorage {\n  return {\n    dir,\n    namespace,\n    readAllMemories: () => storage.readAllMemories(),\n    updateMemory: () => {\n      throw new Error(\"codegraph export-okf is read-only\");\n    },\n    writeSealedMemory: () => {\n      throw new Error(\"codegraph export-okf is read-only\");\n    },\n  };\n}\n\ninterface GitHints {\n  readonly repoRoot: string | null;\n  readonly repoName: string;\n  readonly originUrl: string | null;\n}\n\nasync function resolveGitHints(cwd: string): Promise<GitHints> {\n  try {\n    const invoker = defaultGitInvoker();\n    const topLevel = await invoker(cwd, [\"rev-parse\", \"--show-toplevel\"]);\n    if (topLevel.exitCode !== 0) {\n      return { repoRoot: null, repoName: \"codegraph\", originUrl: null };\n    }\n    const repoRoot = topLevel.stdout.trim();\n    const origin = await invoker(repoRoot, [\"remote\", \"get-url\", \"origin\"]);\n    const originUrl = origin.exitCode === 0 ? normalizeOriginUrl(origin.stdout) : null;\n    return {\n      repoRoot: repoRoot || null,\n      repoName: (repoRoot && path.basename(repoRoot)) || \"codegraph\",\n      originUrl: originUrl && originUrl.length > 0 ? originUrl : null,\n    };\n  } catch {\n    return { repoRoot: null, repoName: \"codegraph\", originUrl: null };\n  }\n}\n\nfunction moduleResource(git: GitHints, filePath: string): string {\n  if (git.originUrl) return `${git.originUrl}/${filePath}`;\n  if (git.repoRoot) return path.join(git.repoRoot, filePath);\n  return filePath;\n}\n\nfunction confidenceTier(confidence: number): string {\n  if (confidence >= 0.9) return \"high\";\n  if (confidence >= 0.5) return \"medium\";\n  return \"low\";\n}\n\nfunction decisionFileStem(record: Pick<DecisionRecord, \"id\">): string {\n  const safe = record.id.replace(/[^A-Za-z0-9._-]+/g, \"_\");\n  return safe.length > 0 ? safe : \"decision\";\n}\n\nfunction renderModule(\n  file: GraphFileRow,\n  fileNodes: readonly GraphNodeRow[],\n  edges: readonly GraphEdgeRow[],\n  fileIdToPath: ReadonlyMap<number, string>,\n  keptPaths: ReadonlySet<string>,\n  symbolFilter: OkfCodegraphSymbolFilter,\n  git: GitHints,\n  graphIndexedAt: string,\n): string {\n  const visible =\n    symbolFilter === \"all\"\n      ? [...fileNodes]\n      : symbolFilter === \"exported\"\n        ? fileNodes.filter((n) => n.is_exported === 1)\n        : [];\n  visible.sort((a, b) => (a.name !== b.name ? a.name.localeCompare(b.name) : a.span_start - b.span_start));\n  const outEdges = edges\n    .filter((e) => e.src_file_id === file.id && fileIdToPath.get(e.src_file_id) === file.path)\n    .map((e) => ({\n      type: e.type,\n      verb: e.type.toLowerCase(),\n      dstPath: e.dst_path,\n      dstName: e.dst_name,\n      tier: confidenceTier(e.confidence),\n    }))\n    .sort((a, b) =>\n      a.type !== b.type\n        ? a.type.localeCompare(b.type)\n        : a.dstPath !== b.dstPath\n          ? a.dstPath.localeCompare(b.dstPath)\n          : a.dstName.localeCompare(b.dstName),\n    );\n  const fields: Record<string, unknown> = {\n    type: OKF_CODE_MODULE_TYPE,\n    title: file.path,\n    description: `${fileNodes.length} symbols, ${file.lang}`,\n    resource: moduleResource(git, file.path),\n    tags: [file.lang],\n    timestamp: graphIndexedAt,\n  };\n  let body = \"\";\n  if (symbolFilter !== \"none\") {\n    const rows = visible.map((n) => `| ${n.name} | ${n.label} | ${n.span_start}-${n.span_end} |`).join(\"\\n\");\n    body += `# Symbols\\n\\n| Name | Kind | Span (bytes) |\\n|---|---|---|\\n${rows}\\n\\n`;\n  }\n  if (outEdges.length > 0) {\n    const lines = outEdges.map((e) => {\n      // Broken links (target truncated out of the bundle) are legal per OKF\n      // §5.3 — the link records the relationship regardless of target presence.\n      const href = `/modules/${e.dstPath}.md`;\n      const label = e.verb === \"calls\" ? `${e.dstName}() in ${e.dstPath}` : e.dstPath;\n      const broken = keptPaths.has(e.dstPath) ? \"\" : \" (link target not exported)\";\n      return `- ${e.verb}: [${label}](${href}) (confidence: ${e.tier})${broken}`;\n    });\n    body += `# Dependencies\\n\\n${lines.join(\"\\n\")}\\n\\n`;\n  }\n  return renderFrontmatter(fields) + body.trimEnd() + \"\\n\";\n}\n\nfunction renderModulesIndex(files: readonly GraphFileRow[]): string {\n  const groups = new Map<string, GraphFileRow[]>();\n  for (const file of files) {\n    const key = file.path.includes(\"/\") ? (file.path.split(\"/\")[0] ?? \"\") : \"(root)\";\n    const list = groups.get(key) ?? [];\n    list.push(file);\n    groups.set(key, list);\n  }\n  const sections = [...groups.keys()].sort().map((key) => {\n    const lines = (groups.get(key) ?? [])\n      .sort((a, b) => a.path.localeCompare(b.path))\n      .map((f) => `* [${f.path}](/modules/${f.path}.md)`);\n    return `## ${key}\\n\\n${lines.join(\"\\n\")}`;\n  });\n  return `---\\nokf_version: \"${OKF_EXPORT_VERSION}\"\\n---\\n\\n# Code Modules\\n\\n${sections.join(\"\\n\\n\")}\\n`;\n}\n\nfunction renderDecisionsIndex(records: ReadonlyArray<{ record: DecisionRecord }>): string {\n  // ACTIVE set first — the single classification source (rule 53), never a\n  // re-derived list.\n  const orderedStatuses = [\n    ...DECISION_STATUSES.filter((s) => ACTIVE_DECISION_STATUSES.has(s)),\n    ...DECISION_STATUSES.filter((s) => !ACTIVE_DECISION_STATUSES.has(s)),\n  ];\n  const byStatus = new Map<string, { record: DecisionRecord }[]>();\n  for (const entry of records) {\n    const list = byStatus.get(entry.record.status) ?? [];\n    list.push(entry);\n    byStatus.set(entry.record.status, list);\n  }\n  const sections: string[] = [];\n  for (const status of orderedStatuses) {\n    const list = byStatus.get(status);\n    if (!list || list.length === 0) continue;\n    const lines = list\n      .map((e) => e.record)\n      .sort((a, b) => a.title.localeCompare(b.title))\n      .map((r) => `* [${r.title}](/decisions/${decisionFileStem(r)}.md)`);\n    sections.push(`## ${status[0]!.toUpperCase()}${status.slice(1)}\\n\\n${lines.join(\"\\n\")}`);\n  }\n  return `---\\nokf_version: \"${OKF_EXPORT_VERSION}\"\\n---\\n\\n# Decision Records\\n\\n${sections.join(\"\\n\\n\")}\\n`;\n}\n\nfunction renderDecision(record: DecisionRecord, timestamp: string): string {\n  const fields: Record<string, unknown> = {\n    id: record.id,\n    title: record.title,\n    status: record.status,\n    context: record.context,\n    decision: record.decision,\n    ...(record.consequences !== undefined ? { consequences: record.consequences } : {}),\n    entityRefs: record.entityRefs,\n    ...(record.supersedes !== undefined ? { supersedes: record.supersedes } : {}),\n    type: OKF_DECISION_RECORD_TYPE,\n    timestamp,\n  };\n  const lines: string[] = [];\n  if (record.context) lines.push(record.context, \"\");\n  lines.push(\"# Decision\", \"\");\n  if (record.decision) lines.push(record.decision, \"\");\n  if (record.consequences && record.consequences.length > 0) {\n    lines.push(\"# Consequences\", \"\", record.consequences, \"\");\n  }\n  if (record.supersedes !== undefined) {\n    lines.push(`- supersedes: [${record.supersedes}](/decisions/${decisionFileStem({ id: record.supersedes })}.md)`, \"\");\n  }\n  return renderFrontmatter(fields) + lines.join(\"\\n\").trimEnd() + \"\\n\";\n}\n\nfunction renderRootIndex(\n  repoName: string,\n  projectId: string,\n  architectureCard: boolean,\n  decisions: number,\n  keptFiles: readonly GraphFileRow[],\n  totalFiles: readonly GraphFileRow[],\n  truncated: boolean,\n): string {\n  const lines: string[] = [\n    `# ${repoName} Code Graph`,\n    \"\",\n    `- project: ${projectId}`,\n    architectureCard ? \"- [Architecture card](/architecture.md)\" : \"- architecture card: none stored\",\n    `- decision records: ${decisions}`,\n    `- code modules: ${keptFiles.length} of ${totalFiles.length} indexed files`,\n    \"\",\n  ];\n  if (truncated) {\n    lines.push(\n      OKF_CODEGRAPH_TRUNCATION_MARKER,\n      `Truncated to the ${keptFiles.length} files with the most symbols of ${totalFiles.length} in the graph; raise --max-module-concepts to widen.`,\n      \"\",\n    );\n  }\n  return `---\\nokf_version: \"${OKF_EXPORT_VERSION}\"\\n---\\n\\n${lines.join(\"\\n\")}\\n`;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/coding/export-okf-codegraph.ts"],"sourcesContent":["/**\n * Codegraph OKF projection (issue #1950).\n *\n * Read-only projection of one project's code-graph SQLite store into an\n * OKF v0.1 knowledge bundle: the stored architecture card, decision\n * records, and one `Code Module` concept per indexed source file with its\n * symbols and outgoing edges. The store is NEVER opened for write — the\n * SQLite file is opened `readonly`, so an export cannot mutate indexing\n * state and the file's bytes are stable across runs.\n *\n * Rendering discipline mirrors architecture-card.ts (rule 38): byte-stable\n * output for an unchanged graph; every list is sorted with a total order.\n * Shared bundle mechanics come from ../okf/render.ts (one source of truth\n * with the memory exporter, issue #1948).\n */\nimport { existsSync, readdirSync, rmSync, statSync } from \"node:fs\";\nimport { mkdtemp } from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\nimport { lintOkfDir } from \"../okf/lint.js\";\nimport {\n  OKF_ARCHITECTURE_CARD_TYPE,\n  OKF_CODE_MODULE_TYPE,\n  OKF_DECISION_RECORD_TYPE,\n} from \"../okf/type-mapping.js\";\nimport {\n  OKF_EXPORT_VERSION,\n  publishBundle,\n  renderFrontmatter,\n  rejectSymlinkPath,\n  writeBundleFile,\n} from \"../okf/render.js\";\nimport { openBetterSqlite3 } from \"../runtime/better-sqlite.js\";\nimport { StorageManager, stripAttributesSuffix } from \"../storage.js\";\nimport type { PluginConfig } from \"../types.js\";\nimport { findArchitectureCardMemory, type ArchitectureSurfaceStorage } from \"./architecture-surfaces.js\";\nimport {\n  CodegraphRuntimeError,\n  codegraphSurfaceVisible,\n  listCodegraphProjects,\n  resolveCodegraphDbPath,\n} from \"./codegraph-runtime.js\";\nimport { defaultGitInvoker, normalizeOriginUrl } from \"./git-context.js\";\nimport { projectNamespaceName } from \"./coding-namespace.js\";\nimport {\n  ACTIVE_DECISION_STATUSES,\n  DECISION_STATUSES,\n  parseDecisionRecord,\n  type DecisionRecord,\n} from \"./decision-records.js\";\nimport { buildCodingGraphInstallHint, isCodingGraphInstalled } from \"./optional-coding-graph.js\";\n\n/** Default cap on rendered module concepts (`--max-module-concepts`). */\nexport const DEFAULT_OKF_CODEGRAPH_MAX_MODULE_CONCEPTS = 500;\n\n/**\n * Visible marker written into the root index when module concepts were\n * truncated (mirrors `ARCHITECTURE_CARD_TRUNCATION_MARKER` — never\n * silently incomplete).\n */\nexport const OKF_CODEGRAPH_TRUNCATION_MARKER = \"<!-- okf-codegraph-truncated -->\";\n\nexport type OkfCodegraphSymbolFilter = \"none\" | \"exported\" | \"all\";\n\nconst SYMBOL_FILTERS: readonly OkfCodegraphSymbolFilter[] = [\"none\", \"exported\", \"all\"];\n\nexport function parseOkfCodegraphSymbolFilter(raw: unknown): OkfCodegraphSymbolFilter {\n  const value = typeof raw === \"string\" ? raw.trim().toLowerCase() : \"\";\n  if (value.length === 0) return \"exported\";\n  if ((SYMBOL_FILTERS as readonly string[]).includes(value)) return value as OkfCodegraphSymbolFilter;\n  throw new Error(`invalid --symbols ${String(raw)}; allowed: ${SYMBOL_FILTERS.join(\", \")}`);\n}\n\nexport interface ExportOkfCodegraphOptions {\n  readonly config: PluginConfig;\n  readonly memoryDir: string;\n  /** Store owner; defaults to `\"default\"` like the access-service principal key. */\n  readonly principal?: string;\n  readonly projectId: string;\n  readonly outDir: string;\n  /**\n   * Working directory used to resolve git context (repo root, origin URL).\n   * Defaults to `process.cwd()`.\n   */\n  readonly cwd?: string;\n  readonly maxModuleConcepts?: number;\n  readonly symbols?: OkfCodegraphSymbolFilter;\n  /** Default ON; pass `false` for `--no-include-adrs`. */\n  readonly includeAdrs?: boolean;\n  readonly force?: boolean;\n  /**\n   * Namespace holding the project's decision records + architecture card.\n   * Defaults to the project-scope coding namespace for the project id.\n   */\n  readonly namespace?: string;\n}\n\nexport interface ExportOkfCodegraphResult {\n  readonly projectId: string;\n  readonly moduleConcepts: number;\n  readonly moduleFilesInGraph: number;\n  readonly truncated: boolean;\n  readonly decisions: number;\n  readonly architectureCard: boolean;\n}\n\ninterface GraphFileRow {\n  readonly id: number;\n  readonly path: string;\n  readonly lang: string;\n}\n\ninterface GraphNodeRow {\n  readonly name: string;\n  readonly label: string;\n  readonly file_id: number;\n  readonly span_start: number;\n  readonly span_end: number;\n  readonly is_exported: number;\n}\n\ninterface GraphEdgeRow {\n  readonly type: string;\n  readonly confidence: number;\n  readonly src_file_id: number;\n  readonly dst_file_id: number;\n  readonly dst_name: string;\n  readonly dst_path: string;\n}\n\nexport async function exportCodegraphOkfBundle(\n  opts: ExportOkfCodegraphOptions,\n): Promise<ExportOkfCodegraphResult> {\n  if (!codegraphSurfaceVisible(opts.config)) {\n    throw new CodegraphRuntimeError(\n      \"disabled\",\n      \"codegraph tools are disabled (codingKnowledge.enabled or codingKnowledge.codegraphTools is false)\",\n    );\n  }\n  if (!(await isCodingGraphInstalled())) {\n    throw new CodegraphRuntimeError(\"package_missing\", buildCodingGraphInstallHint());\n  }\n  const principal = opts.principal?.trim() || \"default\";\n  const projectId = opts.projectId.trim();\n  if (projectId.length === 0) {\n    throw new CodegraphRuntimeError(\n      \"project_required\",\n      \"codegraph export-okf requires --project (or a cwd inside the project's git repo)\",\n    );\n  }\n  rejectSymlinkPath(path.resolve(opts.outDir));\n  // Explicit option validation (config-coercion footgun): honor the given\n  // value or fail loudly — never silently default a bad input. `0` is a\n  // legitimate \"no module concepts\" cap and is honored.\n  const maxModules = opts.maxModuleConcepts ?? DEFAULT_OKF_CODEGRAPH_MAX_MODULE_CONCEPTS;\n  if (!Number.isInteger(maxModules) || maxModules < 0) {\n    throw new Error(\n      `invalid --max-module-concepts ${String(opts.maxModuleConcepts)}; must be a non-negative integer`,\n    );\n  }\n  const dbPath = resolveCodegraphDbPath({ config: opts.config, memoryDir: opts.memoryDir, principal, projectId });\n  if (!existsSync(dbPath)) {\n    const known = listCodegraphProjects({\n      config: opts.config,\n      memoryDir: opts.memoryDir,\n      principal,\n      listDir: (dir) => {\n        try {\n          return readdirSync(dir);\n        } catch {\n          return [];\n        }\n      },\n    });\n    throw new CodegraphRuntimeError(\n      \"project_not_found\",\n      `no codegraph store for project '${projectId}' (principal '${principal}'); known projects: ${\n        known.length > 0 ? known.join(\", \") : \"(none)\"\n      }`,\n    );\n  }\n\n  // Read the graph through a readonly handle — bytes on disk are never\n  // touched, and the store cache (write-mode handles) is bypassed entirely.\n  const graphIndexedAt = statSync(dbPath).mtime.toISOString();\n  const db = openBetterSqlite3(dbPath, { readonly: true, fileMustExist: true });\n  let files: GraphFileRow[];\n  let nodes: GraphNodeRow[];\n  let edges: GraphEdgeRow[];\n  try {\n    files = db.prepare(\"SELECT id, path, lang FROM files ORDER BY path ASC\").all() as GraphFileRow[];\n    nodes = db\n      .prepare(\n        `SELECT n.name, n.label, n.file_id, n.span_start, n.span_end,\n                COALESCE(na.is_exported, 0) AS is_exported\n           FROM nodes n LEFT JOIN node_attributes na ON na.node_id = n.id`,\n      )\n      .all() as GraphNodeRow[];\n    edges = db\n      .prepare(\n        `SELECT e.type, e.confidence, s.file_id AS src_file_id, d.file_id AS dst_file_id,\n                d.name AS dst_name, df.path AS dst_path\n           FROM edges e\n           JOIN nodes s ON s.id = e.src\n           JOIN nodes d ON d.id = e.dst\n           JOIN files df ON d.file_id = df.id`,\n      )\n      .all() as GraphEdgeRow[];\n  } finally {\n    db.close();\n  }\n\n  // Trust boundary: file paths come from the indexed graph. Reject anything\n  // that is not a strict repo-relative POSIX path so a hostile row cannot\n  // escape the staging directory via writeBundleFile's path.join.\n  const safeFiles = files.filter(\n    (f) => f.path.length > 0 && !f.path.startsWith(\"/\") && !f.path.split(\"/\").includes(\"..\"),\n  );\n  const fileIdToPath = new Map<number, string>(safeFiles.map((f) => [f.id, f.path]));\n  const nodesByFile = new Map<number, GraphNodeRow[]>();\n  for (const node of nodes) {\n    if (!fileIdToPath.has(node.file_id)) continue;\n    const list = nodesByFile.get(node.file_id) ?? [];\n    list.push(node);\n    nodesByFile.set(node.file_id, list);\n  }\n\n  // Deterministic truncation: most symbols first, path ascending as the\n  // tie-break (issue acceptance: cap of 1 keeps the highest-symbol file).\n  const ranked = [...safeFiles].sort((a, b) => {\n    const aCount = (nodesByFile.get(a.id) ?? []).length;\n    const bCount = (nodesByFile.get(b.id) ?? []).length;\n    if (aCount !== bCount) return bCount - aCount;\n    return a.path.localeCompare(b.path);\n  });\n  const keptFiles = ranked.slice(0, maxModules);\n  const keptPaths = new Set<string>(keptFiles.map((f) => f.path));\n  const truncated = safeFiles.length > keptFiles.length;\n\n  const symbolFilter = parseOkfCodegraphSymbolFilter(opts.symbols);\n  const git = await resolveGitHints(opts.cwd ?? process.cwd());\n  const staging = await mkdtemp(path.join(os.tmpdir(), \"remnic-okf-codegraph-\"));\nlet decisions = 0;\nlet architectureCard = false;\ntry {\n  const namespace = opts.namespace?.trim() || projectNamespaceName(projectId);\n    const namespaceDir = path.join(opts.memoryDir, \"namespaces\", namespace);\n    if (opts.includeAdrs !== false && existsSync(namespaceDir)) {\n      const storage = new StorageManager(namespaceDir);\n      const memories = await storage.readAllMemories();\n      // Architecture card — reuse the surface's classification (rule 53).\n      const card = await findArchitectureCardMemory(readOnlyCardStorage(storage, namespaceDir, namespace));\n      if (card) {\n        architectureCard = true;\n        writeBundleFile(\n          staging,\n          \"architecture.md\",\n          renderFrontmatter({\n            type: OKF_ARCHITECTURE_CARD_TYPE,\n            title: git.repoName,\n            ...(git.originUrl ? { resource: git.originUrl } : git.repoRoot ? { resource: git.repoRoot } : {}),\n            timestamp: card.frontmatter.updated ?? card.frontmatter.created,\n          }) +\n            stripAttributesSuffix(card.content.replace(/^\\uFEFF/, \"\")).trimEnd() +\n            \"\\n\",\n        );\n      }\n      const records: Array<{ record: DecisionRecord; timestamp: string }> = [];\n      for (const memory of memories) {\n        if (memory.frontmatter.category !== \"decision\") continue;\n        try {\n          const parsed = parseDecisionRecord(memory.content);\n          records.push({\n            // Production writes leave the ADR frontmatter id empty and use\n            // the memory id as the canonical identifier (decisionRecord\n            // surface path) — prefer the ADR id, fall back to the memory id.\n            record: parsed.id ? parsed : { ...parsed, id: memory.frontmatter.id },\n            timestamp: memory.frontmatter.updated ?? memory.frontmatter.created,\n          });\n        } catch {\n          // Unparseable decision bodies are skipped, mirroring the surface's\n          // safeParseDecisionRecord degradation.\n        }\n      }\n      records.sort((a, b) => a.record.title.localeCompare(b.record.title));\n      decisions = records.length;\n      for (const { record, timestamp } of records) {\n        writeBundleFile(staging, `decisions/${decisionFileStem(record)}.md`, renderDecision(record, timestamp));\n      }\n      if (records.length > 0 || architectureCard) {\n        writeBundleFile(staging, \"decisions/index.md\", renderDecisionsIndex(records));\n      }\n    }\n\n    for (const file of keptFiles) {\n      writeBundleFile(\n        staging,\n        `modules/${file.path}.md`,\n        renderModule(\n          file,\n          nodesByFile.get(file.id) ?? [],\n          edges,\n          fileIdToPath,\n          keptPaths,\n          symbolFilter,\n          git,\n          graphIndexedAt,\n        ),\n      );\n    }\n    if (keptFiles.length > 0) {\n      writeBundleFile(staging, \"modules/index.md\", renderModulesIndex(keptFiles));\n    }\n    writeBundleFile(\n      staging,\n      \"index.md\",\n      renderRootIndex(git.repoName, projectId, architectureCard, decisions, keptFiles, safeFiles, truncated),\n    );\n\n    // Self-validate with the #1946 conformance checker; non-conformant\n    // output fails the command. Reserved basenames (the bundle's own\n    // index.md files) are the documented exemption, as in the memory export.\n    const lint = lintOkfDir(staging);\n    const blocking = lint.findings.filter((f) => f.code !== \"skipped_encrypted\" && f.code !== \"reserved_basename\");\n    if (blocking.length > 0) {\n      throw new Error(`OKF codegraph export failed lint: ${blocking.map((f) => `${f.file}: ${f.message}`).join(\"; \")}`);\n    }\n    publishBundle(staging, path.resolve(opts.outDir), opts.force === true);\n  } catch (err) {\n    rmSync(staging, { recursive: true, force: true });\n    throw err;\n  }\n  return {\n    projectId,\n    moduleConcepts: keptFiles.length,\n    moduleFilesInGraph: safeFiles.length,\n    truncated,\n    decisions,\n    architectureCard,\n  };\n}\n\n/**\n * Read-only adapter over the namespace StorageManager for\n * {@link findArchitectureCardMemory} — write arms throw so a future edit\n * cannot silently turn the exporter into a mutating surface.\n */\nfunction readOnlyCardStorage(\n  storage: StorageManager,\n  dir: string,\n  namespace: string,\n): ArchitectureSurfaceStorage {\n  return {\n    dir,\n    namespace,\n    readAllMemories: () => storage.readAllMemories(),\n    updateMemory: () => {\n      throw new Error(\"codegraph export-okf is read-only\");\n    },\n    writeSealedMemory: () => {\n      throw new Error(\"codegraph export-okf is read-only\");\n    },\n  };\n}\n\ninterface GitHints {\n  readonly repoRoot: string | null;\n  readonly repoName: string;\n  readonly originUrl: string | null;\n}\n\nasync function resolveGitHints(cwd: string): Promise<GitHints> {\n  try {\n    const invoker = defaultGitInvoker();\n    const topLevel = await invoker(cwd, [\"rev-parse\", \"--show-toplevel\"]);\n    if (topLevel.exitCode !== 0) {\n      return { repoRoot: null, repoName: \"codegraph\", originUrl: null };\n    }\n    const repoRoot = topLevel.stdout.trim();\n    const origin = await invoker(repoRoot, [\"remote\", \"get-url\", \"origin\"]);\n    const originUrl = origin.exitCode === 0 ? normalizeOriginUrl(origin.stdout) : null;\n    return {\n      repoRoot: repoRoot || null,\n      repoName: (repoRoot && path.basename(repoRoot)) || \"codegraph\",\n      originUrl: originUrl && originUrl.length > 0 ? originUrl : null,\n    };\n  } catch {\n    return { repoRoot: null, repoName: \"codegraph\", originUrl: null };\n  }\n}\n\nfunction moduleResource(git: GitHints, filePath: string): string {\n  if (git.originUrl) return `${git.originUrl}/${filePath}`;\n  if (git.repoRoot) return path.join(git.repoRoot, filePath);\n  return filePath;\n}\n\nfunction confidenceTier(confidence: number): string {\n  if (confidence >= 0.9) return \"high\";\n  if (confidence >= 0.5) return \"medium\";\n  return \"low\";\n}\n\nfunction decisionFileStem(record: Pick<DecisionRecord, \"id\">): string {\n  const safe = record.id.replace(/[^A-Za-z0-9._-]+/g, \"_\");\n  return safe.length > 0 ? safe : \"decision\";\n}\n\nfunction renderModule(\n  file: GraphFileRow,\n  fileNodes: readonly GraphNodeRow[],\n  edges: readonly GraphEdgeRow[],\n  fileIdToPath: ReadonlyMap<number, string>,\n  keptPaths: ReadonlySet<string>,\n  symbolFilter: OkfCodegraphSymbolFilter,\n  git: GitHints,\n  graphIndexedAt: string,\n): string {\n  const visible =\n    symbolFilter === \"all\"\n      ? [...fileNodes]\n      : symbolFilter === \"exported\"\n        ? fileNodes.filter((n) => n.is_exported === 1)\n        : [];\n  visible.sort((a, b) => (a.name !== b.name ? a.name.localeCompare(b.name) : a.span_start - b.span_start));\n  const outEdges = edges\n    .filter((e) => e.src_file_id === file.id && fileIdToPath.get(e.src_file_id) === file.path)\n    .map((e) => ({\n      type: e.type,\n      verb: e.type.toLowerCase(),\n      dstPath: e.dst_path,\n      dstName: e.dst_name,\n      tier: confidenceTier(e.confidence),\n    }))\n    .sort((a, b) =>\n      a.type !== b.type\n        ? a.type.localeCompare(b.type)\n        : a.dstPath !== b.dstPath\n          ? a.dstPath.localeCompare(b.dstPath)\n          : a.dstName.localeCompare(b.dstName),\n    );\n  const fields: Record<string, unknown> = {\n    type: OKF_CODE_MODULE_TYPE,\n    title: file.path,\n    description: `${fileNodes.length} symbols, ${file.lang}`,\n    resource: moduleResource(git, file.path),\n    tags: [file.lang],\n    timestamp: graphIndexedAt,\n  };\n  let body = \"\";\n  if (symbolFilter !== \"none\") {\n    const rows = visible.map((n) => `| ${n.name} | ${n.label} | ${n.span_start}-${n.span_end} |`).join(\"\\n\");\n    body += `# Symbols\\n\\n| Name | Kind | Span (bytes) |\\n|---|---|---|\\n${rows}\\n\\n`;\n  }\n  if (outEdges.length > 0) {\n    const lines = outEdges.map((e) => {\n      // Broken links (target truncated out of the bundle) are legal per OKF\n      // §5.3 — the link records the relationship regardless of target presence.\n      const href = `/modules/${e.dstPath}.md`;\n      const label = e.verb === \"calls\" ? `${e.dstName}() in ${e.dstPath}` : e.dstPath;\n      const broken = keptPaths.has(e.dstPath) ? \"\" : \" (link target not exported)\";\n      return `- ${e.verb}: [${label}](${href}) (confidence: ${e.tier})${broken}`;\n    });\n    body += `# Dependencies\\n\\n${lines.join(\"\\n\")}\\n\\n`;\n  }\n  return renderFrontmatter(fields) + body.trimEnd() + \"\\n\";\n}\n\nfunction renderModulesIndex(files: readonly GraphFileRow[]): string {\n  const groups = new Map<string, GraphFileRow[]>();\n  for (const file of files) {\n    const key = file.path.includes(\"/\") ? (file.path.split(\"/\")[0] ?? \"\") : \"(root)\";\n    const list = groups.get(key) ?? [];\n    list.push(file);\n    groups.set(key, list);\n  }\n  const sections = [...groups.keys()].sort().map((key) => {\n    const lines = (groups.get(key) ?? [])\n      .sort((a, b) => a.path.localeCompare(b.path))\n      .map((f) => `* [${f.path}](/modules/${f.path}.md)`);\n    return `## ${key}\\n\\n${lines.join(\"\\n\")}`;\n  });\n  return `---\\nokf_version: \"${OKF_EXPORT_VERSION}\"\\n---\\n\\n# Code Modules\\n\\n${sections.join(\"\\n\\n\")}\\n`;\n}\n\nfunction renderDecisionsIndex(records: ReadonlyArray<{ record: DecisionRecord }>): string {\n  // ACTIVE set first — the single classification source (rule 53), never a\n  // re-derived list.\n  const orderedStatuses = [\n    ...DECISION_STATUSES.filter((s) => ACTIVE_DECISION_STATUSES.has(s)),\n    ...DECISION_STATUSES.filter((s) => !ACTIVE_DECISION_STATUSES.has(s)),\n  ];\n  const byStatus = new Map<string, { record: DecisionRecord }[]>();\n  for (const entry of records) {\n    const list = byStatus.get(entry.record.status) ?? [];\n    list.push(entry);\n    byStatus.set(entry.record.status, list);\n  }\n  const sections: string[] = [];\n  for (const status of orderedStatuses) {\n    const list = byStatus.get(status);\n    if (!list || list.length === 0) continue;\n    const lines = list\n      .map((e) => e.record)\n      .sort((a, b) => a.title.localeCompare(b.title))\n      .map((r) => `* [${r.title}](/decisions/${decisionFileStem(r)}.md)`);\n    sections.push(`## ${status[0]!.toUpperCase()}${status.slice(1)}\\n\\n${lines.join(\"\\n\")}`);\n  }\n  return `---\\nokf_version: \"${OKF_EXPORT_VERSION}\"\\n---\\n\\n# Decision Records\\n\\n${sections.join(\"\\n\\n\")}\\n`;\n}\n\nfunction renderDecision(record: DecisionRecord, timestamp: string): string {\n  const fields: Record<string, unknown> = {\n    id: record.id,\n    title: record.title,\n    status: record.status,\n    context: record.context,\n    decision: record.decision,\n    ...(record.consequences !== undefined ? { consequences: record.consequences } : {}),\n    entityRefs: record.entityRefs,\n    ...(record.supersedes !== undefined ? { supersedes: record.supersedes } : {}),\n    type: OKF_DECISION_RECORD_TYPE,\n    timestamp,\n  };\n  const lines: string[] = [];\n  if (record.context) lines.push(record.context, \"\");\n  lines.push(\"# Decision\", \"\");\n  if (record.decision) lines.push(record.decision, \"\");\n  if (record.consequences && record.consequences.length > 0) {\n    lines.push(\"# Consequences\", \"\", record.consequences, \"\");\n  }\n  if (record.supersedes !== undefined) {\n    lines.push(`- supersedes: [${record.supersedes}](/decisions/${decisionFileStem({ id: record.supersedes })}.md)`, \"\");\n  }\n  return renderFrontmatter(fields) + lines.join(\"\\n\").trimEnd() + \"\\n\";\n}\n\nfunction renderRootIndex(\n  repoName: string,\n  projectId: string,\n  architectureCard: boolean,\n  decisions: number,\n  keptFiles: readonly GraphFileRow[],\n  totalFiles: readonly GraphFileRow[],\n  truncated: boolean,\n): string {\n  const lines: string[] = [\n    `# ${repoName} Code Graph`,\n    \"\",\n    `- project: ${projectId}`,\n    architectureCard ? \"- [Architecture card](/architecture.md)\" : \"- architecture card: none stored\",\n    `- decision records: ${decisions}`,\n    `- code modules: ${keptFiles.length} of ${totalFiles.length} indexed files`,\n    \"\",\n  ];\n  if (truncated) {\n    lines.push(\n      OKF_CODEGRAPH_TRUNCATION_MARKER,\n      `Truncated to the ${keptFiles.length} files with the most symbols of ${totalFiles.length} in the graph; raise --max-module-concepts to widen.`,\n      \"\",\n    );\n  }\n  return `---\\nokf_version: \"${OKF_EXPORT_VERSION}\"\\n---\\n\\n${lines.join(\"\\n\")}\\n`;\n}\n"],"mappings":"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","names":[]}

package/dist/coding/pre-action-gate.d.ts

@@ -1,5 +1,5 @@
 import '../causal-trajectory.js';
-export { cA as NormalizedActionIntent, cB as PRE_ACTION_FINGERPRINT_VERSION, cC as PRE_ACTION_GATE_DEFAULT_TIMEOUT_MS, cD as PRE_ACTION_WARNING_VERSION, cE as PreActionFailureGate, cF as PreActionGateDependencies, cG as PreActionGateRequest, cH as PreActionGateResult, cI as PreActionGateStatus, d0 as normalizeActionIntent, da as sanitizePayloadString } from '../types-48sPkWB0.js';
+export { cA as NormalizedActionIntent, cB as PRE_ACTION_FINGERPRINT_VERSION, cC as PRE_ACTION_GATE_DEFAULT_TIMEOUT_MS, cD as PRE_ACTION_WARNING_VERSION, cE as PreActionFailureGate, cF as PreActionGateDependencies, cG as PreActionGateRequest, cH as PreActionGateResult, cI as PreActionGateStatus, d0 as normalizeActionIntent, da as sanitizePayloadString } from '../types-Cyr32ABj.js';
 import '../objective-state.js';
 import '../message-parts/index.js';
 import '../bounded-jsonl-state.js';
@@ -8,6 +8,7 @@ import '../external-wiki-config.js';
 import '../recall-state-view.js';
 import '../contradiction-config.js';
 import '../graph-path-scoring-config.js';
+import '../background-generation-config.js';
 import '../deep-recall-config.js';
 import '../active-context-config.js';
 import '../local-llm-config.js';

package/dist/coding/pre-action-gate.js

@@ -5,8 +5,8 @@ import {
   PreActionFailureGate,
   normalizeActionIntent,
   sanitizePayloadString
-} from "../chunk-BICNRVEC.js";
-import "../chunk-LMMQKZK3.js";
+} from "../chunk-IWO6QXWJ.js";
+import "../chunk-L63GFNKL.js";
 import "../chunk-YCVB7X56.js";
 import "../chunk-A2IYSXDQ.js";
 import "../chunk-B6O2YLUR.js";

package/dist/compat/codex-cli-fallback.d.ts

@@ -1 +1 @@
-export { CodexCliFallbackConfig, CodexCliFallbackMessage, CodexCliFallbackOptions, CodexCliFallbackRequest, CodexCliFallbackResult, CodexCliFallbackRunner, __codexCliFallbackTestHooks, callCodexCliFallback, isCodexCliFallbackRunnerRegistered, normalizeCodexCliTimeoutMs, setCodexCliFallbackRunnerForProcess } from '../cli-fallback.js';
+export { CodexCliFallbackConfig, CodexCliFallbackMessage, CodexCliFallbackOptions, CodexCliFallbackRequest, CodexCliFallbackResult, CodexCliFallbackRunner, __codexCliFallbackTestHooks, callCodexCliFallback, getCodexCliFallbackRunnerForProcess, isCodexCliFallbackRunnerRegistered, normalizeCodexCliTimeoutMs, setCodexCliFallbackRunnerForProcess } from '../cli-fallback.js';

package/dist/compat/codex-cli-fallback.js

@@ -1,10 +1,11 @@
 import {
   __codexCliFallbackTestHooks,
   callCodexCliFallback,
+  getCodexCliFallbackRunnerForProcess,
   isCodexCliFallbackRunnerRegistered,
   normalizeCodexCliTimeoutMs,
   setCodexCliFallbackRunnerForProcess
-} from "../chunk-65RENJGB.js";
+} from "../chunk-E2AWJ7KQ.js";
 import "../chunk-PZ5AY32C.js";
 
 // src/compat/codex-cli-fallback.ts
@@ -19,6 +20,7 @@ process.emitWarning(
 export {
   __codexCliFallbackTestHooks,
   callCodexCliFallback,
+  getCodexCliFallbackRunnerForProcess,
   isCodexCliFallbackRunnerRegistered,
   normalizeCodexCliTimeoutMs,
   setCodexCliFallbackRunnerForProcess

package/dist/compat/codex-cli-fallback.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/compat/codex-cli-fallback.ts"],"sourcesContent":["/**\n * Deprecated alias subpath `@remnic/core/codex-cli-fallback`.\n *\n * PR #1638 renamed `src/codex-cli-fallback.ts` -> `src/cli-fallback.ts` to\n * graduate the host-prefixed name per CLAUDE.md rule 31 (generic @remnic/core\n * modules must not carry a host prefix). This thin re-export keeps the old\n * subpath resolving during the compat window so external consumers importing\n * `@remnic/core/codex-cli-fallback` do not hit ERR_PACKAGE_PATH_NOT_EXPORTED.\n * It forwards every export to the canonical module -- no logic is duplicated.\n *\n * Removal timeline: v10.0.0 (see issue #1643).\n * Import from `@remnic/core/cli-fallback` instead.\n */\nexport * from \"../cli-fallback.js\";\n\nprocess.emitWarning(\n  \"@remnic/core/codex-cli-fallback is a deprecated alias; import from @remnic/core/cli-fallback instead. Removed in v10.0.0 (issue #1643).\",\n  {\n    type: \"DeprecationWarning\",\n    code: \"REMNIC_DEP_CORE_SUBPATH_CODEX_CLI_FALLBACK\",\n    detail: \"PR #1638 renamed codex-cli-fallback.ts to cli-fallback.ts.\",\n  },\n);\n"],"mappings":";;;;;;;;;;AAeA,QAAQ;AAAA,EACN;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,MAAM;AAAA,IACN,QAAQ;AAAA,EACV;AACF;","names":[]}
+{"version":3,"sources":["../../src/compat/codex-cli-fallback.ts"],"sourcesContent":["/**\n * Deprecated alias subpath `@remnic/core/codex-cli-fallback`.\n *\n * PR #1638 renamed `src/codex-cli-fallback.ts` -> `src/cli-fallback.ts` to\n * graduate the host-prefixed name per CLAUDE.md rule 31 (generic @remnic/core\n * modules must not carry a host prefix). This thin re-export keeps the old\n * subpath resolving during the compat window so external consumers importing\n * `@remnic/core/codex-cli-fallback` do not hit ERR_PACKAGE_PATH_NOT_EXPORTED.\n * It forwards every export to the canonical module -- no logic is duplicated.\n *\n * Removal timeline: v10.0.0 (see issue #1643).\n * Import from `@remnic/core/cli-fallback` instead.\n */\nexport * from \"../cli-fallback.js\";\n\nprocess.emitWarning(\n  \"@remnic/core/codex-cli-fallback is a deprecated alias; import from @remnic/core/cli-fallback instead. Removed in v10.0.0 (issue #1643).\",\n  {\n    type: \"DeprecationWarning\",\n    code: \"REMNIC_DEP_CORE_SUBPATH_CODEX_CLI_FALLBACK\",\n    detail: \"PR #1638 renamed codex-cli-fallback.ts to cli-fallback.ts.\",\n  },\n);\n"],"mappings":";;;;;;;;;;;AAeA,QAAQ;AAAA,EACN;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,MAAM;AAAA,IACN,QAAQ;AAAA,EACV;AACF;","names":[]}

package/dist/compounding/engine.d.ts

@@ -1,5 +1,5 @@
-import { S as StorageManager } from '../storage-Cbll3-Tk.js';
-import { P as PluginConfig } from '../types-48sPkWB0.js';
+import { S as StorageManager } from '../storage-wvX01lht.js';
+import { P as PluginConfig } from '../types-Cyr32ABj.js';
 import { SharedFeedbackEntry } from '../shared-context/manager.js';
 import { QmdConfigProjection } from '../capabilities.js';
 import '../corpus-read-cancellation.js';
@@ -25,6 +25,7 @@ import '../external-wiki-config.js';
 import '../recall-state-view.js';
 import '../contradiction-config.js';
 import '../graph-path-scoring-config.js';
+import '../background-generation-config.js';
 import '../deep-recall-config.js';
 import '../causal-trajectory.js';
 import '../objective-state.js';

package/dist/compounding/engine.js

@@ -1,37 +1,37 @@
 import {
   CompoundingEngine,
   defaultTierMigrationCycleBudget
-} from "../chunk-GDDSXVWR.js";
+} from "../chunk-X4TD4O2F.js";
 import "../chunk-CARRTDKC.js";
-import "../chunk-YM7YN37H.js";
+import "../chunk-6ET2VII7.js";
 import "../chunk-CC37E3QM.js";
-import "../chunk-ZEPVWLCN.js";
-import "../chunk-UHVXE24Y.js";
+import "../chunk-CZTPU65V.js";
 import "../chunk-46WM6JX2.js";
+import "../chunk-UHVXE24Y.js";
 import "../chunk-D5F7TKMH.js";
-import "../chunk-7RKBPXY6.js";
-import "../chunk-Q6D7EUSQ.js";
-import "../chunk-BD7JTBYP.js";
-import "../chunk-OB3XMWX5.js";
-import "../chunk-CYEPCZN5.js";
+import "../chunk-6YAIN5XJ.js";
+import "../chunk-4JVQRFZD.js";
 import "../chunk-TNSCIPBQ.js";
 import "../chunk-YQNNHLCG.js";
-import "../chunk-4O6WRBGE.js";
 import "../chunk-6KTXE6A3.js";
+import "../chunk-BD7JTBYP.js";
+import "../chunk-OB3XMWX5.js";
+import "../chunk-4O6WRBGE.js";
 import "../chunk-GUMZC2BO.js";
+import "../chunk-CYEPCZN5.js";
 import "../chunk-TFA6HPOA.js";
 import "../chunk-F4TWWUMP.js";
 import "../chunk-72A4L5JJ.js";
 import "../chunk-A7Q43EUZ.js";
 import "../chunk-S2V7RUCL.js";
 import "../chunk-PCEYGOSL.js";
-import "../chunk-RN3MVLW3.js";
-import "../chunk-S2HLHAZ4.js";
+import "../chunk-IYKZJVL5.js";
 import "../chunk-SCU65EZI.js";
 import "../chunk-MRPOZBJC.js";
+import "../chunk-S2HLHAZ4.js";
 import "../chunk-DM2T26WE.js";
 import "../chunk-LDXUBPMO.js";
-import "../chunk-S2ULTQZR.js";
+import "../chunk-3N3PBBEH.js";
 import "../chunk-AAD2ZS6P.js";
 import "../chunk-SHEHQBCG.js";
 import "../chunk-3ONXXHQO.js";
@@ -49,46 +49,47 @@ import "../chunk-3CBI2ZSA.js";
 import "../chunk-JXN77SGO.js";
 import "../chunk-ZLQ37WJX.js";
 import "../chunk-IUM3VSHI.js";
+import "../chunk-GDYU6VF4.js";
+import "../chunk-BT7NVCML.js";
 import "../chunk-C64XATK7.js";
 import "../chunk-42JKGUFJ.js";
-import "../chunk-YEN4TREG.js";
+import "../chunk-LQNRVPTV.js";
 import "../chunk-I55KAVET.js";
 import "../chunk-L2EXJQJP.js";
 import "../chunk-45GF7Y3V.js";
-import "../chunk-65RENJGB.js";
-import "../chunk-353KGBKY.js";
+import "../chunk-CWTCMZGE.js";
+import "../chunk-E2AWJ7KQ.js";
+import "../chunk-RW4QNB4J.js";
 import "../chunk-ZIKENA2C.js";
+import "../chunk-VYCOJKSX.js";
 import "../chunk-6Q3ZTEF6.js";
-import "../chunk-RGMVMVMF.js";
+import "../chunk-PJKTFXE2.js";
 import "../chunk-W5BIQOAJ.js";
 import "../chunk-Z7L72ZHL.js";
 import "../chunk-4O4TKIXQ.js";
+import "../chunk-RGMVMVMF.js";
 import "../chunk-YCVB7X56.js";
 import "../chunk-PQVCH2AE.js";
-import "../chunk-PJKTFXE2.js";
 import "../chunk-TG3FAM2S.js";
 import "../chunk-TBXAY2SS.js";
 import "../chunk-ZA53AZND.js";
 import "../chunk-AL3UYZ5N.js";
 import "../chunk-RL6NEVXT.js";
 import "../chunk-C7HJ3NEI.js";
+import "../chunk-37CAEC7E.js";
 import "../chunk-7RJUVTVF.js";
-import "../chunk-PWPIERBM.js";
-import "../chunk-BJMBJZ2Y.js";
-import "../chunk-UKJAGEXH.js";
-import "../chunk-FP2373TW.js";
-import "../chunk-LSLCFCCQ.js";
-import "../chunk-BT7NVCML.js";
-import "../chunk-VYCOJKSX.js";
 import "../chunk-NB3LRY4T.js";
 import "../chunk-5FVVY2EB.js";
 import "../chunk-FFAZ2XFU.js";
 import "../chunk-JDSVLVCG.js";
 import "../chunk-5GKPFL3S.js";
 import "../chunk-JAKIDQB2.js";
-import "../chunk-P7FMDTKL.js";
 import "../chunk-VUFL7X3H.js";
 import "../chunk-JUOZ62Y7.js";
+import "../chunk-BJMBJZ2Y.js";
+import "../chunk-UKJAGEXH.js";
+import "../chunk-FP2373TW.js";
+import "../chunk-P7FMDTKL.js";
 import "../chunk-ZEFVK7XC.js";
 import "../chunk-6KH5NLQS.js";
 import "../chunk-P2QRMMVQ.js";

package/dist/compounding/preference-consolidator.d.ts

@@ -1,4 +1,4 @@
-import { u as MemoryCategory, M as MemoryFile } from '../types-48sPkWB0.js';
+import { u as MemoryCategory, M as MemoryFile } from '../types-Cyr32ABj.js';
 import { LcmEngine } from '../lcm/engine.js';
 import '../message-parts/index.js';
 import '../bounded-jsonl-state.js';
@@ -7,6 +7,7 @@ import '../external-wiki-config.js';
 import '../recall-state-view.js';
 import '../contradiction-config.js';
 import '../graph-path-scoring-config.js';
+import '../background-generation-config.js';
 import '../deep-recall-config.js';
 import '../causal-trajectory.js';
 import '../objective-state.js';

package/dist/compression-optimizer.d.ts

@@ -1,4 +1,4 @@
-import { ai as CompressionGuidelineOptimizerEventCounts, aj as CompressionGuidelineOptimizerActionSummary, ak as CompressionGuidelineOptimizerRuleUpdate, al as MemoryActionType, am as MemoryActionEvent, an as CompressionGuidelineOptimizerState } from './types-48sPkWB0.js';
+import { ai as CompressionGuidelineOptimizerEventCounts, aj as CompressionGuidelineOptimizerActionSummary, ak as CompressionGuidelineOptimizerRuleUpdate, al as MemoryActionType, am as MemoryActionEvent, an as CompressionGuidelineOptimizerState } from './types-Cyr32ABj.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -6,6 +6,7 @@ import './external-wiki-config.js';
 import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
+import './background-generation-config.js';
 import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';

package/dist/config.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig } from './types-48sPkWB0.js';
+import { P as PluginConfig } from './types-Cyr32ABj.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -6,6 +6,7 @@ import './external-wiki-config.js';
 import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
+import './background-generation-config.js';
 import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';

package/dist/config.js

@@ -4,15 +4,16 @@ import {
   isOpenaiApiKeyDisabled,
   parseConfig,
   resolveEnvVars
-} from "./chunk-D2DIYEFW.js";
+} from "./chunk-FWWWUPOE.js";
 import "./chunk-ZKOPY4WW.js";
 import "./chunk-62OKGIJA.js";
 import "./chunk-5HYUUFMQ.js";
 import "./chunk-I3H5LFOI.js";
-import "./chunk-BICNRVEC.js";
-import "./chunk-WIKO4SCR.js";
+import "./chunk-IWO6QXWJ.js";
+import "./chunk-H3TKENU4.js";
 import "./chunk-Z5LAYHGJ.js";
 import "./chunk-6ZMAMSHS.js";
+import "./chunk-6H2G7RFT.js";
 import "./chunk-6ZN34ISG.js";
 import "./chunk-H4WG3UQZ.js";
 import "./chunk-OEBLZZKK.js";
@@ -24,43 +25,45 @@ import "./chunk-FC67T4E6.js";
 import "./chunk-PIG4WJFQ.js";
 import "./chunk-C6FQJ52H.js";
 import "./chunk-KFZY2OFH.js";
+import "./chunk-YFTNZMGR.js";
 import "./chunk-B32WYRXX.js";
 import "./chunk-QLK3SL7Q.js";
 import "./chunk-FEHIOYML.js";
 import "./chunk-P32IDSHD.js";
-import "./chunk-255PC37A.js";
+import "./chunk-YDVAM7S4.js";
 import "./chunk-WNIUPHWV.js";
 import "./chunk-IJ6WHMFB.js";
 import "./chunk-3SG4FGDV.js";
 import "./chunk-JV3C2MNQ.js";
 import "./chunk-ADXCCZL2.js";
+import "./chunk-353C5UNV.js";
 import "./chunk-236PXYG7.js";
 import "./chunk-ZCUTSMR2.js";
 import "./chunk-QDW3E4RD.js";
-import "./chunk-LMMQKZK3.js";
-import "./chunk-353KGBKY.js";
+import "./chunk-L63GFNKL.js";
+import "./chunk-RW4QNB4J.js";
 import "./chunk-ZIKENA2C.js";
-import "./chunk-353C5UNV.js";
+import "./chunk-VYCOJKSX.js";
 import "./chunk-6Q3ZTEF6.js";
+import "./chunk-PJKTFXE2.js";
+import "./chunk-C5C7IJ4Q.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-PQVCH2AE.js";
-import "./chunk-PJKTFXE2.js";
 import "./chunk-6MINUTGJ.js";
 import "./chunk-7RJUVTVF.js";
-import "./chunk-VYCOJKSX.js";
-import "./chunk-WQZZDN5M.js";
-import "./chunk-UI3NYK34.js";
-import "./chunk-GCGJW34D.js";
-import "./chunk-AREGMX2J.js";
-import "./chunk-3BTFBQLO.js";
-import "./chunk-LQWOFU6L.js";
 import "./chunk-NB3LRY4T.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-FFAZ2XFU.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
+import "./chunk-WQZZDN5M.js";
+import "./chunk-UI3NYK34.js";
+import "./chunk-GCGJW34D.js";
+import "./chunk-AREGMX2J.js";
+import "./chunk-3BTFBQLO.js";
+import "./chunk-LQWOFU6L.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";

package/dist/connectors/codex-materialize-runner.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig, M as MemoryFile } from '../types-48sPkWB0.js';
+import { P as PluginConfig, M as MemoryFile } from '../types-Cyr32ABj.js';
 import { RolloutSummaryInput, MaterializeResult } from './codex-materialize.js';
 import '../message-parts/index.js';
 import '../bounded-jsonl-state.js';
@@ -7,6 +7,7 @@ import '../external-wiki-config.js';
 import '../recall-state-view.js';
 import '../contradiction-config.js';
 import '../graph-path-scoring-config.js';
+import '../background-generation-config.js';
 import '../deep-recall-config.js';
 import '../causal-trajectory.js';
 import '../objective-state.js';