@remnic/core 9.66.10 → 9.66.11

package/dist/chunk-M2BY5IZL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/okf/lint.ts","../src/okf/render.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\n\nimport { MAGIC_BYTES } from \"../secure-store/secure-fs.js\";\nimport { OKF_RESERVED_BASENAMES } from \"./type-mapping.js\";\n\nexport interface OkfLintFinding {\n  file: string;\n  code: \"missing_frontmatter\" | \"missing_type\" | \"empty_type\" | \"reserved_basename\" | \"skipped_encrypted\";\n  message: string;\n}\n\nexport interface OkfLintResult {\n  ok: boolean;\n  scanned: number;\n  findings: OkfLintFinding[];\n}\n\nfunction isEncryptedBlob(raw: string): boolean {\n  // secure-store writes a binary envelope starting with MAGIC_BYTES at offset\n  // 0 — match that fixed position, never a substring anywhere in the file.\n  return raw.startsWith(MAGIC_BYTES.toString(\"ascii\"));\n}\n\nfunction hasFrontmatter(raw: string): boolean {\n  return raw.startsWith(\"---\\n\") || raw.startsWith(\"---\\r\\n\");\n}\n\nfunction readType(raw: string): string | undefined {\n  const close = raw.indexOf(\"\\n---\", 4);\n  if (close === -1) return undefined;\n  const block = raw.slice(4, close);\n  const match = /^type:[ \\t]*(.*)$/m.exec(block);\n  if (!match) return undefined;\n  const value = match[1]!.trim().replace(/^[\"']|[\"']$/g, \"\");\n  return value;\n}\n\nfunction walkMarkdown(root: string, out: string[]): void {\n  let entries: fs.Dirent[];\n  try {\n    entries = fs.readdirSync(root, { withFileTypes: true });\n  } catch {\n    return;\n  }\n  for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {\n    if (entry.name === \"state\" || entry.name === \".git\") continue;\n    const full = path.join(root, entry.name);\n    let stat: fs.Stats;\n    try {\n      stat = fs.lstatSync(full);\n    } catch {\n      continue;\n    }\n    if (stat.isSymbolicLink()) continue;\n    if (stat.isDirectory()) {\n      walkMarkdown(full, out);\n      continue;\n    }\n    if (stat.isFile() && entry.name.endsWith(\".md\")) out.push(full);\n  }\n}\n\nexport function lintOkfDir(memoryDir: string): OkfLintResult {\n  const files: string[] = [];\n  walkMarkdown(memoryDir, files);\n  const findings: OkfLintFinding[] = [];\n  for (const file of files) {\n    const rel = path.relative(memoryDir, file);\n    const base = path.basename(file);\n    if (OKF_RESERVED_BASENAMES[base] === true) {\n      findings.push({\n        file: rel,\n        code: \"reserved_basename\",\n        message: `${base} is reserved by OKF §6/§7`,\n      });\n      continue;\n    }\n    let raw: string;\n    try {\n      raw = fs.readFileSync(file, \"utf8\");\n    } catch {\n      continue;\n    }\n    if (isEncryptedBlob(raw)) {\n      findings.push({\n        file: rel,\n        code: \"skipped_encrypted\",\n        message: \"skipped (encrypted)\",\n      });\n      continue;\n    }\n    if (!hasFrontmatter(raw)) {\n      findings.push({\n        file: rel,\n        code: \"missing_frontmatter\",\n        message: \"missing YAML frontmatter\",\n      });\n      continue;\n    }\n    const type = readType(raw);\n    if (type === undefined) {\n      findings.push({ file: rel, code: \"missing_type\", message: \"missing type\" });\n    } else if (type.length === 0) {\n      findings.push({ file: rel, code: \"empty_type\", message: \"empty type\" });\n    }\n  }\n  const actionable = findings.filter((f) => f.code !== \"skipped_encrypted\");\n  return { ok: actionable.length === 0, scanned: files.length, findings };\n}\n","/**\n * Shared OKF bundle-rendering helpers (issues #1948 + #1950).\n *\n * One source of truth for the mechanics every OKF bundle exporter uses:\n * deterministic frontmatter rendering, staging-directory file writes, the\n * symlink-guarded atomic publish, and the bundle version stamp. The memory\n * exporter (transfer/export-okf.ts) and the codegraph exporter\n * (coding/export-okf-codegraph.ts) both consume this module so their\n * bundles are byte-compatible in convention (rule 38 — deterministic\n * rendering discipline; rule 9 — stable seam over shared mechanics).\n */\nimport { lstatSync, mkdirSync, readdirSync, renameSync, rmSync, writeFileSync } from \"node:fs\";\nimport path from \"node:path\";\n\n/** OKF spec version emitted in every bundle root index. */\nexport const OKF_EXPORT_VERSION = \"0.1\";\n\n/**\n * Render a YAML frontmatter block from a flat field map.\n *\n * Key order: the canonical OKF keys first (`type`, `title`, `description`,\n * `tags`, `timestamp`), everything else alphabetical — one deterministic\n * layout so identical inputs always render byte-identical files. A key set\n * to `undefined` is omitted; callers must not pass a key twice.\n */\nexport function renderFrontmatter(fields: Record<string, unknown>): string {\n  const keys = Object.keys(fields).sort((a, b) => {\n    const order = [\"type\", \"title\", \"description\", \"tags\", \"timestamp\"];\n    const ai = order.indexOf(a);\n    const bi = order.indexOf(b);\n    if (ai >= 0 || bi >= 0) return (ai < 0 ? 99 : ai) - (bi < 0 ? 99 : bi);\n    return a.localeCompare(b);\n  });\n  const lines = keys.flatMap((key) => yamlLine(key, fields[key]));\n  return `---\\n${lines.join(\"\\n\")}\\n---\\n\\n`;\n}\n\nfunction yamlLine(key: string, value: unknown): string[] {\n  if (value === undefined) return [];\n  if (Array.isArray(value)) {\n    if (value.length === 0) return [`${key}: []`];\n    if (value.every((item) => typeof item !== \"object\" || item === null)) {\n      return [`${key}:`, ...value.map((item) => `  - ${yamlScalar(item)}`)];\n    }\n    return [`${key}: ${JSON.stringify(value)}`];\n  }\n  if (typeof value === \"object\" && value !== null) return [`${key}: ${JSON.stringify(value)}`];\n  return [`${key}: ${yamlScalar(value)}`];\n}\n\nfunction yamlScalar(value: unknown): string {\n  if (typeof value === \"string\") {\n    if (value === \"\" || /[:#\\n]/.test(value) || value !== value.trim()) return JSON.stringify(value);\n    return value;\n  }\n  return String(value);\n}\n\n/**\n * Write one file into a bundle staging tree. `rel` is a POSIX-style\n * bundle-relative path; parent directories are created as needed.\n */\nexport function writeBundleFile(root: string, rel: string, content: string): void {\n  const dest = path.join(root, ...rel.split(\"/\"));\n  mkdirSync(path.dirname(dest), { recursive: true });\n  writeFileSync(dest, content, \"utf8\");\n}\n\n/**\n * Publish a staged bundle: refuse a non-empty target without `--force`,\n * swap via rename so the target is never observed half-written, and keep a\n * restorable backup when replacing an existing tree.\n */\nexport function publishBundle(staging: string, outDir: string, force: boolean): void {\n  let exists = false;\n  try {\n    const stat = lstatSync(outDir);\n    if (stat.isSymbolicLink()) throw new Error(`--out must not be a symlink: ${outDir}`);\n    exists = true;\n    const entries = readdirSync(outDir).filter((name) => name !== \".\" && name !== \"..\");\n    if (entries.length > 0 && !force) {\n      rmSync(staging, { recursive: true, force: true });\n      throw new Error(`--out ${outDir} is not empty; pass --force to replace it`);\n    }\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n  }\n  mkdirSync(path.dirname(outDir), { recursive: true });\n  if (exists && force) {\n    const backup = `${outDir}.okf-prev`;\n    try {\n      renameSync(outDir, backup);\n    } catch {\n      rmSync(staging, { recursive: true, force: true });\n      throw new Error(`cannot replace --out ${outDir}`);\n    }\n    try {\n      renameSync(staging, outDir);\n      rmSync(backup, { recursive: true, force: true });\n    } catch (err) {\n      try {\n        renameSync(backup, outDir);\n      } catch {\n        // Keep backup if restore fails.\n      }\n      throw err;\n    }\n    return;\n  }\n  renameSync(staging, outDir);\n}\n\n/**\n * Reject a --out path with a symlink anywhere in its component chain\n * (pattern 42 + hermes-shim precedent): a symlinked component could aim\n * the atomic rename outside the operator's chosen directory.\n */\nexport function rejectSymlinkPath(target: string): void {\n  let current = path.resolve(target);\n  while (true) {\n    try {\n      if (lstatSync(current).isSymbolicLink()) {\n        throw new Error(`--out path component is a symlink: ${current}`);\n      }\n    } catch (err) {\n      if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n    }\n    const parent = path.dirname(current);\n    if (parent === current) break;\n    current = parent;\n  }\n}\n\n"],"mappings":"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","names":["path"]}

package/dist/chunk-YYDOUOYM.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/transfer/export-okf.ts"],"sourcesContent":["import { rmSync } from \"node:fs\";\nimport { mkdtemp } from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\nimport { parseOaiMemCitation } from \"../citations.js\";\nimport { inferMemoryStatus } from \"../memory-lifecycle-ledger-utils.js\";\nimport { normalizeProjectionPreview } from \"../memory-projection-format.js\";\nimport { lintOkfDir } from \"../okf/lint.js\";\nimport { okfTypeForMemory, OKF_PROFILE_TYPE } from \"../okf/type-mapping.js\";\nimport {\n  OKF_EXPORT_VERSION,\n  publishBundle,\n  renderFrontmatter,\n  rejectSymlinkPath,\n  writeBundleFile,\n} from \"../okf/render.js\";\n// Re-exported for the existing `@remnic/core/export-okf` consumers and tests\n// (one public surface; the value itself now lives in okf/render.ts).\nexport { OKF_EXPORT_VERSION };\nimport { StorageManager } from \"../storage.js\";\nimport type { MemoryFile, MemoryLink, MemoryStatus } from \"../types.js\";\n\n// Shared bundle mechanics (frontmatter, publish, symlink guard, file write)\n// live in ../okf/render.ts — one source of truth for every OKF exporter.\nexport const OKF_LOG_TRUNCATION_MARKER = \"<!-- okf-log-truncated -->\";\nexport const DEFAULT_OKF_LOG_MAX_ENTRIES = 500;\n\nconst MEMORY_STATUSES: readonly MemoryStatus[] = [\n  \"active\",\n  \"pending_review\",\n  \"rejected\",\n  \"quarantined\",\n  \"superseded\",\n  \"archived\",\n  \"forgotten\",\n];\n\nexport interface ExportOkfOptions {\n  memoryDir: string;\n  outDir: string;\n  includeStatus?: readonly string[];\n  includeCategories?: readonly string[];\n  excludeTags?: readonly string[];\n  includeProfile?: boolean;\n  includeWearables?: boolean;\n  includeLog?: boolean;\n  logMaxEntries?: number;\n  force?: boolean;\n}\n\nexport interface ExportOkfResult {\n  exported: number;\n  excluded: number;\n  byCategory: Record<string, number>;\n  plaintextWarning: boolean;\n}\n\nexport function parseIncludeStatus(raw: unknown): MemoryStatus[] {\n  const values = splitCsv(raw);\n  if (values.length === 0) return [\"active\"];\n  const allowed = new Set<string>(MEMORY_STATUSES);\n  for (const value of values) {\n    if (!allowed.has(value)) {\n      throw new Error(`invalid --include-status ${value}; allowed: ${MEMORY_STATUSES.join(\", \")}`);\n    }\n  }\n  return values as MemoryStatus[];\n}\n\nexport async function exportOkfBundle(opts: ExportOkfOptions): Promise<ExportOkfResult> {\n  const outDir = path.resolve(opts.outDir);\n  rejectSymlinkPath(outDir);\n  const includeStatus = new Set(parseIncludeStatus(opts.includeStatus));\n  const includeCategories = opts.includeCategories?.length ? new Set(opts.includeCategories) : null;\n  const excludeTags = new Set(opts.excludeTags ?? []);\n  const storage = new StorageManager(opts.memoryDir);\n  const memories = await storage.readAllMemories();\n  const included: MemoryFile[] = [];\n  let excluded = 0;\n  for (const memory of memories) {\n    const rel = toRel(memory.path, opts.memoryDir);\n    if (!opts.includeWearables && rel.startsWith(\"wearables/\")) {\n      excluded += 1;\n      continue;\n    }\n    const status = inferMemoryStatus(memory.frontmatter, memory.path);\n    if (!includeStatus.has(status)) {\n      excluded += 1;\n      continue;\n    }\n    if (includeCategories && !includeCategories.has(memory.frontmatter.category)) {\n      excluded += 1;\n      continue;\n    }\n    if ((memory.frontmatter.tags ?? []).some((tag) => excludeTags.has(tag))) {\n      excluded += 1;\n      continue;\n    }\n    included.push(memory);\n  }\n  included.sort((a, b) => toRel(a.path, opts.memoryDir).localeCompare(toRel(b.path, opts.memoryDir)));\n\n  const staging = await mkdtemp(path.join(os.tmpdir(), \"remnic-okf-export-\"));\n  const byCategory: Record<string, number> = {};\n  const idToRel = new Map<string, string>();\n  for (const memory of included) {\n    const rel = toRel(memory.path, opts.memoryDir);\n    idToRel.set(memory.frontmatter.id, rel);\n  }\n  for (const memory of included) {\n    const rel = toRel(memory.path, opts.memoryDir);\n    const rendered = renderMemory(memory, rel, idToRel);\n    writeBundleFile(staging, rel, rendered);\n    const category = memory.frontmatter.category;\n    byCategory[category] = (byCategory[category] ?? 0) + 1;\n  }\n\n  if (opts.includeProfile) {\n    try {\n      const profile = await storage.readProfile();\n      if (profile) {\n        writeBundleFile(\n          staging,\n          \"profile.md\",\n          renderFrontmatter({\n            type: OKF_PROFILE_TYPE,\n            title: \"User Profile\",\n            timestamp: new Date(0).toISOString(),\n          }) + profile.replace(/^\\uFEFF/, \"\"),\n        );\n      }\n    } catch {\n      // Profile is optional even when requested.\n    }\n  }\n\n  if (opts.includeLog) {\n    const events = await storage.readAllMemoryLifecycleEvents();\n    writeBundleFile(staging, \"log.md\", renderLog(events, idToRel, opts.logMaxEntries ?? DEFAULT_OKF_LOG_MAX_ENTRIES));\n  }\n\n  writeIndexes(staging, included, opts.memoryDir);\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    rmSync(staging, { recursive: true, force: true });\n    throw new Error(`OKF export failed lint: ${blocking.map((f) => `${f.file}: ${f.message}`).join(\"; \")}`);\n  }\n\n  publishBundle(staging, outDir, opts.force === true);\n  return {\n    exported: included.length,\n    excluded,\n    byCategory,\n    plaintextWarning: true,\n  };\n}\n\n\nfunction renderMemory(memory: MemoryFile, rel: string, idToRel: Map<string, string>): string {\n  const fm = memory.frontmatter;\n  const title = firstHeading(memory.content) ?? `${humanize(fm.category)} ${fm.created.slice(0, 10)}`;\n  const type = fm.type ?? okfTypeForMemory(fm);\n  const fields: Record<string, unknown> = {\n    ...fm,\n    type,\n    title,\n    description: normalizeProjectionPreview(memory.content),\n    tags: fm.tags ?? [],\n    timestamp: fm.updated,\n  };\n  if (fm.artifactType) fields.resource = rel;\n  let body = memory.content.trim();\n  const citation = parseOaiMemCitation(body);\n  if (citation) {\n    const start = body.indexOf(\"<oai-mem-citation>\");\n    const end = body.indexOf(\"</oai-mem-citation>\");\n    if (start >= 0 && end > start) {\n      body = `${body.slice(0, start).trimEnd()}\\n\\n${body.slice(end + \"</oai-mem-citation>\".length).trimStart()}`.trim();\n    }\n    const lines = citation.entries.map((entry, index) => `${index + 1}. [${entry.path}](${entry.path})`);\n    body = `${body}\\n\\n# Citations\\n\\n${lines.join(\"\\n\")}\\n`;\n  }\n  const links = fm.links ?? [];\n  if (links.length > 0) {\n    body += `\\n# Related\\n\\n${links.map((link) => renderRelated(link, idToRel)).join(\"\\n\")}\\n`;\n  }\n  return renderFrontmatter(fields) + body + (body.endsWith(\"\\n\") ? \"\" : \"\\n\");\n}\n\nfunction renderRelated(link: MemoryLink, idToRel: Map<string, string>): string {\n  const target = idToRel.get(link.targetId) ?? link.targetId;\n  const href = target.startsWith(\"/\") ? target : `/${target}`;\n  return `- ${link.linkType}: [${link.targetId}](${href})`;\n}\n\nfunction writeIndexes(root: string, memories: MemoryFile[], memoryDir: string): void {\n  const groups = new Map<string, MemoryFile[]>();\n  for (const memory of memories) {\n    const rel = toRel(memory.path, memoryDir);\n    const dir = path.posix.dirname(rel);\n    const key = dir === \".\" ? \"\" : dir.split(\"/\")[0] ?? \"\";\n    const list = groups.get(key) ?? [];\n    list.push(memory);\n    groups.set(key, list);\n  }\n  const sections = [...groups.keys()].sort().map((key) => {\n    const heading = key === \"\" ? \"Root\" : humanize(key);\n    const lines = (groups.get(key) ?? [])\n      .sort((a, b) => toRel(a.path, memoryDir).localeCompare(toRel(b.path, memoryDir)))\n      .map((memory) => {\n        const rel = toRel(memory.path, memoryDir);\n        const title = firstHeading(memory.content) ?? memory.frontmatter.id;\n        const description = normalizeProjectionPreview(memory.content);\n        return `* [${title}](/${rel}) - ${description}`;\n      });\n    return `## ${heading}\\n\\n${lines.join(\"\\n\")}`;\n  });\n  writeBundleFile(root, \"index.md\", `---\\nokf_version: \"${OKF_EXPORT_VERSION}\"\\n---\\n\\n${sections.join(\"\\n\\n\")}\\n`);\n}\n\nfunction renderLog(\n  events: Array<{ timestamp?: string; type?: string; action?: string; memoryId?: string }>,\n  idToRel: Map<string, string>,\n  maxEntries: number,\n): string {\n  const sorted = [...events].sort((a, b) => String(b.timestamp ?? \"\").localeCompare(String(a.timestamp ?? \"\")));\n  const truncated = sorted.length > maxEntries;\n  const kept = sorted.slice(0, maxEntries);\n  const byDay = new Map<string, typeof kept>();\n  for (const event of kept) {\n    const day = String(event.timestamp ?? \"\").slice(0, 10) || \"unknown\";\n    const list = byDay.get(day) ?? [];\n    list.push(event);\n    byDay.set(day, list);\n  }\n  const days = [...byDay.keys()].sort((a, b) => b.localeCompare(a));\n  const parts = [\"# Log\", \"\"];\n  for (const day of days) {\n    parts.push(`## ${day}`, \"\");\n    for (const event of byDay.get(day) ?? []) {\n      const action = boldAction(event.type ?? event.action ?? \"Update\");\n      const id = event.memoryId;\n      const rel = id ? idToRel.get(id) : undefined;\n      const target = rel ? `[${id}](/${rel})` : id ?? \"\";\n      parts.push(`- **${action}** ${target}`.trimEnd());\n    }\n    parts.push(\"\");\n  }\n  if (truncated) parts.push(OKF_LOG_TRUNCATION_MARKER, \"\");\n  return `${parts.join(\"\\n\")}\\n`;\n}\n\nfunction boldAction(raw: string): string {\n  const lower = raw.toLowerCase();\n  if (lower.includes(\"create\") || lower.includes(\"add\")) return \"Creation\";\n  if (lower.includes(\"deprecat\") || lower.includes(\"delete\") || lower.includes(\"archiv\")) return \"Deprecation\";\n  return \"Update\";\n}\n\n\nfunction firstHeading(content: string): string | undefined {\n  for (const line of content.split(\"\\n\")) {\n    const match = /^#\\s+(.+)$/.exec(line.trim());\n    if (match) return match[1]!.trim();\n  }\n  return undefined;\n}\n\nfunction humanize(value: string): string {\n  return value.replace(/[_-]/g, \" \").replace(/\\b\\w/g, (ch) => ch.toUpperCase());\n}\n\n\n\nfunction splitCsv(raw: unknown): string[] {\n  if (raw === undefined || raw === null || raw === \"\") return [];\n  const parts = Array.isArray(raw) ? raw.map(String) : String(raw).split(\",\");\n  return parts.map((part) => part.trim()).filter((part) => part.length > 0);\n}\n\nfunction toRel(abs: string, root: string): string {\n  return path.relative(path.resolve(root), path.resolve(abs)).split(path.sep).join(\"/\");\n}\n\n"],"mappings":"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","names":[]}

package/dist/chunk-ZPZLGN4Y.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/connectors/codex-materialize-runner.ts","../src/namespaces/path.ts"],"sourcesContent":["/**\n * codex-materialize-runner.ts — Thin I/O bridge for the Codex materializer.\n *\n * The pure rendering logic lives in {@link ./codex-materialize.js}. This file\n * is the place callers (consolidation hooks, CLI, session-end hook) go when\n * they want the whole \"load memories from storage → render → write\" flow.\n *\n * Kept deliberately small so #378 never has to reach into orchestrator.ts /\n * importance.ts — the two files Wave 1 agents are editing concurrently.\n */\n\nimport { existsSync } from \"node:fs\";\n\nimport { log } from \"../logger.js\";\nimport { resolveNamespaceChildRoot } from \"../namespaces/path.js\";\nimport { isSafeRouteNamespace } from \"../routing/engine.js\";\nimport { projectProceduresToSkills } from \"../procedural/skill-projection.js\";\nimport { BUILTIN_SKILLS } from \"../skills-registry.js\";\nimport { StorageManager } from \"../storage.js\";\nimport { excludeSupportPassportPrivateMemories } from \"../support-passport/card-projection.js\";\nimport type { PluginConfig, MemoryFile } from \"../types.js\";\nimport {\n  hasCodexMaterializeSentinel,\n  materializeForNamespace,\n  type MaterializeResult,\n  type RolloutSummaryInput,\n} from \"./codex-materialize.js\";\n\n/** Options accepted by the shared post-consolidation materialize helper. */\nexport interface PostConsolidationMaterializeOptions {\n  config: PluginConfig;\n  namespace?: string;\n  memories?: MemoryFile[];\n  memoryDir?: string;\n  codexHome?: string;\n  rolloutSummaries?: RolloutSummaryInput[];\n  now?: Date;\n}\n\n/** Options accepted by the runner. */\nexport interface RunMaterializeOptions {\n  /** Remnic config — we only read the `codexMaterialize*` fields. */\n  config: PluginConfig;\n  /** Namespace to materialize. Overrides the config's `codexMaterializeNamespace`. */\n  namespace?: string;\n  /** Override the memory directory (defaults to `config.memoryDir`). */\n  memoryDir?: string;\n  /** Override `<codex_home>` (useful for tests). */\n  codexHome?: string;\n  /** Optional pre-loaded memories (bypasses disk read — used in tests). */\n  memories?: MemoryFile[];\n  /** Optional rollout summaries supplied by the caller. */\n  rolloutSummaries?: RolloutSummaryInput[];\n  /** Current time injection for deterministic runs. */\n  now?: Date;\n  /** Reason string — logged for observability. */\n  reason?: \"consolidation\" | \"session_end\" | \"manual\" | \"cli\";\n}\n\n/**\n * Run the Codex materialization end-to-end. Returns `null` when the feature\n * is disabled in config or when the user hasn't opted in via the sentinel.\n * Never throws for \"expected\" skips; only throws on schema validation or I/O\n * errors that callers actually need to surface.\n */\nexport async function runCodexMaterialize(\n  options: RunMaterializeOptions,\n): Promise<MaterializeResult | null> {\n  const cfg = options.config;\n  if (!cfg.codexMaterializeMemories) {\n    log.debug(`[codex-materialize] skipped — codexMaterializeMemories=false`);\n    return null;\n  }\n\n  // Per-trigger gate: session-end runs must honor codexMaterializeOnSessionEnd.\n  // The Codex Stop hook (remnic-codex-hook.cjs, session-end event) passes\n  // reason=\"session_end\"; when the user has turned off the session-end trigger\n  // we short-circuit here without touching disk.\n  if (options.reason === \"session_end\" && cfg.codexMaterializeOnSessionEnd === false) {\n    log.debug(\n      `[codex-materialize] skipped — session-end disabled via codexMaterializeOnSessionEnd=false`,\n    );\n    return null;\n  }\n\n  const namespace = resolveNamespace(options.namespace, cfg);\n  const memoryDir = options.memoryDir ?? cfg.memoryDir;\n  const codexHome = options.codexHome ?? cfg.codex?.codexHome ?? undefined;\n  if (!memoryDir) {\n    log.warn(`[codex-materialize] skipped — no memoryDir available`);\n    return null;\n  }\n\n  let memories: MemoryFile[];\n  if (options.memories) {\n    memories = options.memories;\n  } else {\n    if (!hasCodexMaterializeSentinel(codexHome)) {\n      return materializeForNamespace(namespace, {\n        memories: [],\n        codexHome,\n        maxSummaryTokens: cfg.codexMaterializeMaxSummaryTokens,\n        rolloutRetentionDays: cfg.codexMaterializeRolloutRetentionDays,\n        rolloutSummaries: options.rolloutSummaries,\n        now: options.now,\n      });\n    }\n    const nsDir = resolveNamespaceDir(memoryDir, namespace, cfg);\n    const storage = new StorageManager(nsDir);\n    memories = await storage.readAllMemories();\n  }\n  memories = excludeSupportPassportPrivateMemories(memories);\n\n  // Skill projection (issue #2369). Gated on `procedural.enabled` AND\n  // `procedural.skillProjection.enabled`; `maxSkills: 0` disables it too.\n  // Passing `undefined` leaves `skills/` untouched, so a disabled gate never\n  // deletes a folder the user curated.\n  const skillProjection = cfg.procedural?.skillProjection;\n  const skills =\n    cfg.procedural?.enabled === true && skillProjection?.enabled === true\n      ? projectProceduresToSkills(memories, {\n          maxSkills: skillProjection.maxSkills,\n          reservedSlugs: BUILTIN_SKILLS.map((skill) => skill.slug),\n        })\n      : undefined;\n\n  // Intentionally NOT catching here: per the JSDoc contract above,\n  // schema-validation and I/O errors from `materializeForNamespace` must\n  // surface to callers so they can exit non-zero (CLI) or log + recover\n  // (consolidation post-hook, which has its own narrower try/catch).\n  // Catching everything would make a broken MEMORY.md render look like a\n  // successful skip, and invisible failures are strictly worse than loud\n  // ones for a feature that writes to `~/.codex/memories`.\n  const result = materializeForNamespace(namespace, {\n    memories,\n    codexHome,\n    maxSummaryTokens: cfg.codexMaterializeMaxSummaryTokens,\n    rolloutRetentionDays: cfg.codexMaterializeRolloutRetentionDays,\n    rolloutSummaries: options.rolloutSummaries,\n    skills,\n    now: options.now,\n  });\n  if (options.reason) {\n    log.debug(\n      `[codex-materialize] ran reason=${options.reason} wrote=${result.wrote} files=${result.filesWritten.length}`,\n    );\n  }\n  return result;\n}\n\n/**\n * Shared helper for post-consolidation materialize hooks.\n *\n * `materializeAfterSemanticConsolidation` and `materializeAfterCausalConsolidation`\n * used to be two nearly-identical copies of this logic; keeping the actual\n * body here means any future guard/logging change happens in one place.\n *\n * The only per-caller knob is `logPrefix`, which is used to tag the\n * non-fatal warning emitted when the materializer throws.\n */\nexport async function runPostConsolidationMaterialize(\n  logPrefix: string,\n  options: PostConsolidationMaterializeOptions,\n): Promise<MaterializeResult | null> {\n  if (!options.config.codexMaterializeMemories) return null;\n  if (!options.config.codexMaterializeOnConsolidation) return null;\n  try {\n    return await runCodexMaterialize({\n      config: options.config,\n      namespace: options.namespace,\n      memories: options.memories,\n      memoryDir: options.memoryDir,\n      codexHome: options.codexHome,\n      rolloutSummaries: options.rolloutSummaries,\n      now: options.now,\n      reason: \"consolidation\",\n    });\n  } catch (error) {\n    log.warn(\n      `${logPrefix} Codex materialize post-hook failed (non-fatal): ${\n        error instanceof Error ? error.message : String(error)\n      }`,\n    );\n    return null;\n  }\n}\n\nfunction resolveNamespace(override: string | undefined, cfg: PluginConfig): string {\n  const requested = (override ?? cfg.codexMaterializeNamespace ?? \"auto\").trim();\n  const defaultNamespace = (cfg.defaultNamespace ?? \"\").trim();\n  const namespace =\n    requested.length === 0 || requested === \"auto\"\n      ? (defaultNamespace.length > 0 ? defaultNamespace : \"default\")\n      : requested;\n  if (!isSafeRouteNamespace(namespace)) {\n    throw new Error(`invalid materialize namespace: ${namespace}`);\n  }\n  return namespace;\n}\n\n/**\n * Resolve the on-disk storage root for a namespace, matching\n * `NamespaceStorageRouter` in `packages/remnic-core/src/namespaces/storage.ts`.\n *\n * Contract:\n *  - When namespaces are disabled, every namespace maps to `memoryDir` itself.\n *  - When namespaces are enabled, non-default namespaces always live under\n *    `memoryDir/namespaces/<namespace>`.\n *  - The default namespace prefers `memoryDir/namespaces/<defaultNamespace>`\n *    when that directory already exists (migrated install); otherwise it\n *    falls back to the legacy `memoryDir` root so materialization does not\n *    silently switch directories out from under an existing install.\n */\nfunction resolveNamespaceDir(\n  memoryDir: string,\n  namespace: string,\n  cfg: PluginConfig,\n): string {\n  if (!cfg.namespacesEnabled) return memoryDir;\n\n  const configuredDefaultNamespace = (cfg.defaultNamespace ?? \"\").trim();\n  const defaultNamespace =\n    configuredDefaultNamespace.length > 0 ? configuredDefaultNamespace : \"default\";\n  const ns = (namespace || defaultNamespace).trim();\n  if (!isSafeRouteNamespace(ns)) {\n    throw new Error(`invalid materialize namespace: ${ns}`);\n  }\n  const namespacedRoot = resolveNamespaceChildRoot(memoryDir, ns, \"materialize namespace path\");\n\n  if (ns === defaultNamespace) {\n    return existsSync(namespacedRoot) ? namespacedRoot : memoryDir;\n  }\n  return namespacedRoot;\n}\n","import path from \"node:path\";\n\nexport function assertNamespacePathInsideRoot(\n  root: string,\n  candidate: string,\n  namespace: string,\n  label = \"namespace path\",\n): void {\n  const relative = path.relative(root, candidate);\n  if (relative === \"\" || (!relative.startsWith(\"..\") && !path.isAbsolute(relative))) {\n    return;\n  }\n  throw new Error(`invalid ${label}: ${namespace}`);\n}\n\nexport function resolveNamespaceChildRoot(\n  memoryDir: string,\n  namespace: string,\n  label = \"namespace path\",\n): string {\n  const namespaceRoot = path.resolve(memoryDir, \"namespaces\");\n  const candidate = path.resolve(namespaceRoot, namespace);\n  assertNamespacePathInsideRoot(namespaceRoot, candidate, namespace, label);\n  return candidate;\n}\n"],"mappings":"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","names":[]}