@remnic/core 9.65.3 → 9.65.5

package/dist/chunk-236PXYG7.js

@@ -0,0 +1,232 @@
+import {
+  isValidSkillSlug
+} from "./chunk-ZCUTSMR2.js";
+import {
+  parseProcedureStepsFromBody
+} from "./chunk-QDW3E4RD.js";
+import {
+  coerceBool,
+  coerceNumber
+} from "./chunk-PQVCH2AE.js";
+import {
+  stripAttributesSuffix
+} from "./chunk-JDSVLVCG.js";
+
+// src/procedural/skill-projection.ts
+var SKILL_MEMORY_ID_KEY = "x-remnic-memory-id";
+var SKILL_UPDATED_KEY = "x-remnic-updated";
+var SKILL_SOURCE_KEY = "x-remnic-source";
+var SKILL_FILE_NAME = "SKILL.md";
+var SKILL_IMPORT_SOURCE = "skill-import";
+var PROJECTABLE_STATUSES = { active: true };
+var DEFAULT_SKILL_PROJECTION_MAX_SKILLS = 20;
+var MAX_SKILL_PROJECTION_MAX_SKILLS = 500;
+var MAX_SLUG_LENGTH = 64;
+var MAX_DESCRIPTION_LENGTH = 300;
+function parseSkillProjectionConfig(raw) {
+  if (raw !== void 0 && (raw === null || typeof raw !== "object" || Array.isArray(raw))) {
+    throw new Error(
+      `procedural.skillProjection must be an object (got ${JSON.stringify(raw)}). Omit the key to keep skill projection disabled (issue #2369).`
+    );
+  }
+  const block = raw && typeof raw === "object" ? raw : {};
+  let enabled = false;
+  if (block.enabled !== void 0) {
+    const coerced = coerceBool(block.enabled);
+    if (coerced === void 0) {
+      throw new Error(
+        `procedural.skillProjection.enabled must be a boolean or one of "true"/"false"/"1"/"0"/"yes"/"no"/"on"/"off" (got ${JSON.stringify(block.enabled)}).`
+      );
+    }
+    enabled = coerced;
+  }
+  let maxSkills = DEFAULT_SKILL_PROJECTION_MAX_SKILLS;
+  if (block.maxSkills !== void 0) {
+    const coerced = coerceNumber(block.maxSkills);
+    if (coerced === void 0 || !Number.isFinite(coerced)) {
+      throw new Error(
+        `procedural.skillProjection.maxSkills must be a finite number (got ${JSON.stringify(block.maxSkills)}).`
+      );
+    }
+    if (!Number.isInteger(coerced)) {
+      throw new Error(
+        `procedural.skillProjection.maxSkills must be an integer (got ${JSON.stringify(block.maxSkills)}).`
+      );
+    }
+    if (coerced < 0 || coerced > MAX_SKILL_PROJECTION_MAX_SKILLS) {
+      throw new Error(
+        `procedural.skillProjection.maxSkills must be between 0 and ${MAX_SKILL_PROJECTION_MAX_SKILLS} (got ${JSON.stringify(block.maxSkills)}). 0 disables projection.`
+      );
+    }
+    maxSkills = coerced;
+  }
+  return { enabled, maxSkills };
+}
+function sanitizeSkillSlug(input) {
+  const base = input.toLowerCase().replace(/[^a-z0-9]+/g, "-").slice(0, MAX_SLUG_LENGTH);
+  const trimmed = trimDashes(base);
+  return trimmed.length > 0 && isValidSkillSlug(trimmed) ? trimmed : "procedure";
+}
+function trimDashes(value) {
+  let start = 0;
+  let end = value.length;
+  while (start < end && value[start] === "-") start += 1;
+  while (end > start && value[end - 1] === "-") end -= 1;
+  return value.slice(start, end);
+}
+function withSuffix(base, suffix) {
+  const room = MAX_SLUG_LENGTH - suffix.length;
+  const head = trimDashes(base.slice(0, Math.max(1, room)));
+  const candidate = `${head.length > 0 ? head : "procedure"}${suffix}`;
+  return isValidSkillSlug(candidate) ? candidate : `procedure${suffix}`;
+}
+function allocateSlug(base, used, reserved) {
+  let candidate = reserved.has(base) ? withSuffix(`user-${base}`, "") : base;
+  if (!isValidSkillSlug(candidate)) candidate = "procedure";
+  if (!used.has(candidate) && !reserved.has(candidate)) {
+    used.add(candidate);
+    return candidate;
+  }
+  for (let n = 2; n < 1e4; n++) {
+    const next = withSuffix(candidate, `-${n}`);
+    if (!used.has(next) && !reserved.has(next)) {
+      used.add(next);
+      return next;
+    }
+  }
+  throw new Error(`skill-projection: could not allocate a unique slug for ${base}`);
+}
+function procedureTitleFromBody(body) {
+  for (const line of body.replace(/\r\n/g, "\n").split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0) continue;
+    if (/^##\s+Step\s+\d+/i.test(trimmed)) break;
+    return trimmed.replace(/^#{1,6}\s*/, "").trim();
+  }
+  return "";
+}
+function compareProcedures(a, b) {
+  const aTs = Date.parse(a.frontmatter.updated ?? "");
+  const bTs = Date.parse(b.frontmatter.updated ?? "");
+  const aVal = Number.isFinite(aTs) ? aTs : 0;
+  const bVal = Number.isFinite(bTs) ? bTs : 0;
+  if (aVal !== bVal) return bVal - aVal;
+  const aId = a.frontmatter.id ?? "";
+  const bId = b.frontmatter.id ?? "";
+  if (aId < bId) return -1;
+  if (aId > bId) return 1;
+  return 0;
+}
+function projectProceduresToSkills(memories, options = {}) {
+  const maxSkills = typeof options.maxSkills === "number" && Number.isInteger(options.maxSkills) && options.maxSkills >= 0 ? Math.min(MAX_SKILL_PROJECTION_MAX_SKILLS, options.maxSkills) : DEFAULT_SKILL_PROJECTION_MAX_SKILLS;
+  if (maxSkills === 0) return [];
+  const reserved = new Set((options.reservedSlugs ?? []).map((s) => s.trim().toLowerCase()));
+  const candidates = memories.filter(
+    (m) => m.frontmatter.category === "procedure" && PROJECTABLE_STATUSES[m.frontmatter.status ?? "active"] === true && typeof m.content === "string" && m.content.trim().length > 0
+  ).sort(compareProcedures).slice(0, maxSkills);
+  const used = /* @__PURE__ */ new Set();
+  const bundles = [];
+  for (const memory of candidates) {
+    const body = stripAttributesSuffix(memory.content.replace(/\r\n/g, "\n")).trim();
+    const title = procedureTitleFromBody(body) || memory.frontmatter.id;
+    const slug = allocateSlug(sanitizeSkillSlug(title), used, reserved);
+    bundles.push({
+      slug,
+      frontmatter: {
+        name: slug,
+        description: title.slice(0, MAX_DESCRIPTION_LENGTH)
+      },
+      body: `${body}
+`,
+      provenance: {
+        memoryId: memory.frontmatter.id,
+        updated: memory.frontmatter.updated,
+        ...memory.frontmatter.source ? { source: memory.frontmatter.source } : {}
+      }
+    });
+  }
+  return bundles;
+}
+function renderSkillBundle(bundle) {
+  const lines = [
+    "---",
+    `name: ${yamlScalar(bundle.frontmatter.name)}`,
+    `description: ${yamlScalar(bundle.frontmatter.description)}`,
+    `${SKILL_MEMORY_ID_KEY}: ${yamlScalar(bundle.provenance.memoryId)}`,
+    `${SKILL_UPDATED_KEY}: ${yamlScalar(bundle.provenance.updated)}`
+  ];
+  if (bundle.provenance.source) {
+    lines.push(`${SKILL_SOURCE_KEY}: ${yamlScalar(bundle.provenance.source)}`);
+  }
+  lines.push("---", "");
+  return `${lines.join("\n")}
+${bundle.body.trimEnd()}
+`;
+}
+function yamlScalar(value) {
+  return JSON.stringify(value.replace(/\r?\n/g, " ").trim());
+}
+function parseSkillBundle(text, slug) {
+  const lines = text.replace(/\r\n/g, "\n").split("\n");
+  let frontmatter = {};
+  let bodyLines = lines;
+  if (lines[0]?.trim() === "---") {
+    const close = lines.findIndex((line, idx) => idx > 0 && line.trim() === "---");
+    if (close !== -1) {
+      frontmatter = parseFlatFrontmatter(lines.slice(1, close).join("\n"));
+      bodyLines = lines.slice(close + 1);
+    }
+  }
+  const body = bodyLines.join("\n").trim();
+  if (body.length === 0) return null;
+  return {
+    slug,
+    name: frontmatter.name,
+    description: frontmatter.description,
+    body,
+    steps: parseProcedureStepsFromBody(body),
+    provenance: {
+      memoryId: frontmatter[SKILL_MEMORY_ID_KEY],
+      updated: frontmatter[SKILL_UPDATED_KEY],
+      source: frontmatter[SKILL_SOURCE_KEY]
+    }
+  };
+}
+function parseFlatFrontmatter(block) {
+  const out = {};
+  for (const line of block.split("\n")) {
+    if (/^\s/.test(line) || line.trim().startsWith("#")) continue;
+    const colon = line.indexOf(":");
+    if (colon <= 0) continue;
+    const key = line.slice(0, colon).trim();
+    const raw = line.slice(colon + 1).trim();
+    if (key.length === 0 || raw.length === 0) continue;
+    out[key] = unquoteScalar(raw);
+  }
+  return out;
+}
+function unquoteScalar(raw) {
+  if (raw.startsWith('"') && raw.endsWith('"') && raw.length >= 2) {
+    try {
+      const parsed = JSON.parse(raw);
+      if (typeof parsed === "string") return parsed;
+    } catch {
+    }
+    return raw.slice(1, -1);
+  }
+  if (raw.startsWith("'") && raw.endsWith("'") && raw.length >= 2) {
+    return raw.slice(1, -1);
+  }
+  return raw;
+}
+
+export {
+  SKILL_FILE_NAME,
+  SKILL_IMPORT_SOURCE,
+  parseSkillProjectionConfig,
+  sanitizeSkillSlug,
+  projectProceduresToSkills,
+  renderSkillBundle,
+  parseSkillBundle
+};
+//# sourceMappingURL=chunk-236PXYG7.js.map

package/dist/chunk-236PXYG7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/procedural/skill-projection.ts"],"sourcesContent":["/**\n * skill-projection.ts — project active `procedure` memories into portable\n * `skills/<slug>/SKILL.md` bundles, and parse hand-authored bundles back into\n * procedure candidates (issue #2369).\n *\n * Pure module: no filesystem, no host coupling. The Codex materializer, the\n * `remnic export skills` CLI, and `remnic import skills` all consume these\n * functions so one slug + format contract serves every surface.\n *\n * Import is INERT by construction: this module only ever returns text and\n * parsed steps. It never resolves, loads, or executes a bundle resource.\n */\n\nimport { coerceBool, coerceNumber } from \"../connectors/coerce.js\";\nimport { isValidSkillSlug } from \"../skills-registry.js\";\nimport { stripAttributesSuffix } from \"../structured-attributes.js\";\nimport type { MemoryFile, MemoryStatus } from \"../types.js\";\nimport { parseProcedureStepsFromBody, type ProcedureStep } from \"./procedure-types.js\";\n\n/** Provenance frontmatter keys. Namespaced so hosts treat them as opaque. */\nexport const SKILL_MEMORY_ID_KEY = \"x-remnic-memory-id\";\nexport const SKILL_UPDATED_KEY = \"x-remnic-updated\";\nexport const SKILL_SOURCE_KEY = \"x-remnic-source\";\n\n/** File name every bundle directory must contain. */\nexport const SKILL_FILE_NAME = \"SKILL.md\";\n\n/** Source tag written on imported procedure memories. */\nexport const SKILL_IMPORT_SOURCE = \"skill-import\";\n\n/**\n * The ONLY statuses that may be projected (Review Prevention Checklist §41 —\n * define the active set, never an exclusion list). `pending_review`,\n * `rejected`, `quarantined`, `superseded`, `archived`, and `forgotten` are\n * withheld because a projected skill is loaded by a host with no further gate.\n */\nconst PROJECTABLE_STATUSES: Partial<Record<MemoryStatus, true>> = { active: true };\n\n/** Default projection cap. `0` disables projection entirely. */\nexport const DEFAULT_SKILL_PROJECTION_MAX_SKILLS = 20;\n\n/** Hard ceiling so a misconfigured cap cannot flood a host skills directory. */\nconst MAX_SKILL_PROJECTION_MAX_SKILLS = 500;\n\nconst MAX_SLUG_LENGTH = 64;\nconst MAX_DESCRIPTION_LENGTH = 300;\n\nexport interface SkillBundleProvenance {\n  /** Remnic memory id this bundle was projected from. */\n  memoryId: string;\n  /** `frontmatter.updated` of the source memory. */\n  updated: string;\n  /** `frontmatter.source` of the source memory, when present. */\n  source?: string;\n}\n\nexport interface SkillBundle {\n  slug: string;\n  frontmatter: { name: string; description: string };\n  /** Markdown body: the stored procedure body (title line + `## Step N`). */\n  body: string;\n  provenance: SkillBundleProvenance;\n}\n\nexport interface ProjectProceduresOptions {\n  /** Cap on projected bundles. `0` projects nothing. Default 20. */\n  maxSkills?: number;\n  /** Slugs a projected bundle must not take (e.g. `BUILTIN_SKILLS` slugs). */\n  reservedSlugs?: readonly string[];\n}\n\nexport interface SkillProjectionConfig {\n  enabled: boolean;\n  maxSkills: number;\n}\n\n/**\n * Parse the `procedural.skillProjection` config block. Mirrors\n * `parseProceduralMaintenanceConfig`: string forms (`\"false\"`, `\"0\"`) coerce,\n * unrecognized values throw rather than silently defaulting.\n */\nexport function parseSkillProjectionConfig(raw: unknown): SkillProjectionConfig {\n  if (raw !== undefined && (raw === null || typeof raw !== \"object\" || Array.isArray(raw))) {\n    throw new Error(\n      `procedural.skillProjection must be an object (got ${JSON.stringify(raw)}). Omit the key to keep skill projection disabled (issue #2369).`,\n    );\n  }\n  const block = raw && typeof raw === \"object\" ? (raw as Record<string, unknown>) : {};\n\n  let enabled = false;\n  if (block.enabled !== undefined) {\n    const coerced = coerceBool(block.enabled);\n    if (coerced === undefined) {\n      throw new Error(\n        `procedural.skillProjection.enabled must be a boolean or one of \"true\"/\"false\"/\"1\"/\"0\"/\"yes\"/\"no\"/\"on\"/\"off\" (got ${JSON.stringify(block.enabled)}).`,\n      );\n    }\n    enabled = coerced;\n  }\n\n  let maxSkills = DEFAULT_SKILL_PROJECTION_MAX_SKILLS;\n  if (block.maxSkills !== undefined) {\n    const coerced = coerceNumber(block.maxSkills);\n    if (coerced === undefined || !Number.isFinite(coerced)) {\n      throw new Error(\n        `procedural.skillProjection.maxSkills must be a finite number (got ${JSON.stringify(block.maxSkills)}).`,\n      );\n    }\n    if (!Number.isInteger(coerced)) {\n      throw new Error(\n        `procedural.skillProjection.maxSkills must be an integer (got ${JSON.stringify(block.maxSkills)}).`,\n      );\n    }\n    if (coerced < 0 || coerced > MAX_SKILL_PROJECTION_MAX_SKILLS) {\n      throw new Error(\n        `procedural.skillProjection.maxSkills must be between 0 and ${MAX_SKILL_PROJECTION_MAX_SKILLS} (got ${JSON.stringify(block.maxSkills)}). 0 disables projection.`,\n      );\n    }\n    // `0` is a documented disable value (§33) — never clamp it up.\n    maxSkills = coerced;\n  }\n\n  return { enabled, maxSkills };\n}\n\n/**\n * Sanitize arbitrary text into a slug `isValidSkillSlug` accepts.\n * Deterministic: the same title always yields the same slug.\n */\nexport function sanitizeSkillSlug(input: string): string {\n  const base = input\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .slice(0, MAX_SLUG_LENGTH);\n  const trimmed = trimDashes(base);\n  return trimmed.length > 0 && isValidSkillSlug(trimmed) ? trimmed : \"procedure\";\n}\n\nfunction trimDashes(value: string): string {\n  let start = 0;\n  let end = value.length;\n  while (start < end && value[start] === \"-\") start += 1;\n  while (end > start && value[end - 1] === \"-\") end -= 1;\n  return value.slice(start, end);\n}\n\n/** Append a suffix while keeping the slug valid and within the length cap. */\nfunction withSuffix(base: string, suffix: string): string {\n  const room = MAX_SLUG_LENGTH - suffix.length;\n  const head = trimDashes(base.slice(0, Math.max(1, room)));\n  const candidate = `${head.length > 0 ? head : \"procedure\"}${suffix}`;\n  return isValidSkillSlug(candidate) ? candidate : `procedure${suffix}`;\n}\n\n/**\n * Reserve a slug: prefix reserved (built-in) collisions with `user-`, then\n * disambiguate duplicates with a stable `-2`, `-3`, … tiebreak so a batch with\n * repeated titles never writes two bundles to one directory (§37).\n */\nfunction allocateSlug(base: string, used: Set<string>, reserved: ReadonlySet<string>): string {\n  let candidate = reserved.has(base) ? withSuffix(`user-${base}`, \"\") : base;\n  if (!isValidSkillSlug(candidate)) candidate = \"procedure\";\n  if (!used.has(candidate) && !reserved.has(candidate)) {\n    used.add(candidate);\n    return candidate;\n  }\n  for (let n = 2; n < 10_000; n++) {\n    const next = withSuffix(candidate, `-${n}`);\n    if (!used.has(next) && !reserved.has(next)) {\n      used.add(next);\n      return next;\n    }\n  }\n  // Unreachable in practice (10k distinct suffixes per base slug).\n  throw new Error(`skill-projection: could not allocate a unique slug for ${base}`);\n}\n\n/** First non-empty line of the body, with a leading markdown heading stripped. */\nexport function procedureTitleFromBody(body: string): string {\n  for (const line of body.replace(/\\r\\n/g, \"\\n\").split(\"\\n\")) {\n    const trimmed = line.trim();\n    if (trimmed.length === 0) continue;\n    if (/^##\\s+Step\\s+\\d+/i.test(trimmed)) break;\n    return trimmed.replace(/^#{1,6}\\s*/, \"\").trim();\n  }\n  return \"\";\n}\n\n/** Total comparator: newest first, `id` as the stable tiebreak (§12). */\nfunction compareProcedures(a: MemoryFile, b: MemoryFile): number {\n  const aTs = Date.parse(a.frontmatter.updated ?? \"\");\n  const bTs = Date.parse(b.frontmatter.updated ?? \"\");\n  const aVal = Number.isFinite(aTs) ? aTs : 0;\n  const bVal = Number.isFinite(bTs) ? bTs : 0;\n  if (aVal !== bVal) return bVal - aVal;\n  const aId = a.frontmatter.id ?? \"\";\n  const bId = b.frontmatter.id ?? \"\";\n  if (aId < bId) return -1;\n  if (aId > bId) return 1;\n  return 0;\n}\n\n/**\n * Project procedure memories into skill bundles. Filters to `active`\n * procedures, orders deterministically, caps at `maxSkills`, and assigns\n * collision-free slugs.\n */\nexport function projectProceduresToSkills(\n  memories: readonly MemoryFile[],\n  options: ProjectProceduresOptions = {},\n): SkillBundle[] {\n  const maxSkills =\n    typeof options.maxSkills === \"number\" && Number.isInteger(options.maxSkills) && options.maxSkills >= 0\n      ? Math.min(MAX_SKILL_PROJECTION_MAX_SKILLS, options.maxSkills)\n      : DEFAULT_SKILL_PROJECTION_MAX_SKILLS;\n  if (maxSkills === 0) return [];\n\n  const reserved = new Set((options.reservedSlugs ?? []).map((s) => s.trim().toLowerCase()));\n  const candidates = memories\n    .filter(\n      (m) =>\n        m.frontmatter.category === \"procedure\" &&\n        PROJECTABLE_STATUSES[(m.frontmatter.status ?? \"active\") as MemoryStatus] === true &&\n        typeof m.content === \"string\" &&\n        m.content.trim().length > 0,\n    )\n    .sort(compareProcedures)\n    .slice(0, maxSkills);\n\n  const used = new Set<string>();\n  const bundles: SkillBundle[] = [];\n  for (const memory of candidates) {\n    // Drop the machine \"[Attributes: ...]\" footer writeMemory appends: a human\n    // skill body must not carry it, and leaving it in would let the footer be\n    // absorbed into the final step's intent on re-parse.\n    const body = stripAttributesSuffix(memory.content.replace(/\\r\\n/g, \"\\n\")).trim();\n    const title = procedureTitleFromBody(body) || memory.frontmatter.id;\n    const slug = allocateSlug(sanitizeSkillSlug(title), used, reserved);\n    bundles.push({\n      slug,\n      frontmatter: {\n        name: slug,\n        description: title.slice(0, MAX_DESCRIPTION_LENGTH),\n      },\n      body: `${body}\\n`,\n      provenance: {\n        memoryId: memory.frontmatter.id,\n        updated: memory.frontmatter.updated,\n        ...(memory.frontmatter.source ? { source: memory.frontmatter.source } : {}),\n      },\n    });\n  }\n  return bundles;\n}\n\n/**\n * Render one bundle as SKILL.md text. Scalars are emitted as YAML\n * double-quoted strings so a title containing `:` or `#` cannot corrupt the\n * frontmatter block.\n */\nexport function renderSkillBundle(bundle: SkillBundle): string {\n  const lines = [\n    \"---\",\n    `name: ${yamlScalar(bundle.frontmatter.name)}`,\n    `description: ${yamlScalar(bundle.frontmatter.description)}`,\n    `${SKILL_MEMORY_ID_KEY}: ${yamlScalar(bundle.provenance.memoryId)}`,\n    `${SKILL_UPDATED_KEY}: ${yamlScalar(bundle.provenance.updated)}`,\n  ];\n  if (bundle.provenance.source) {\n    lines.push(`${SKILL_SOURCE_KEY}: ${yamlScalar(bundle.provenance.source)}`);\n  }\n  lines.push(\"---\", \"\");\n  return `${lines.join(\"\\n\")}\\n${bundle.body.trimEnd()}\\n`;\n}\n\nfunction yamlScalar(value: string): string {\n  return JSON.stringify(value.replace(/\\r?\\n/g, \" \").trim());\n}\n\nexport interface ParsedSkillBundle {\n  /** Directory name the bundle was read from (already sanitized by the caller). */\n  slug: string;\n  name?: string;\n  description?: string;\n  /** Markdown body with the frontmatter block removed. */\n  body: string;\n  /** Parsed `## Step N` sections, or `null` for a step-less body. */\n  steps: ProcedureStep[] | null;\n  provenance: { memoryId?: string; updated?: string; source?: string };\n}\n\n/**\n * Parse SKILL.md text. Frontmatter is optional; unknown keys are ignored.\n * Returns `null` when there is no body to import.\n */\nexport function parseSkillBundle(text: string, slug: string): ParsedSkillBundle | null {\n  const lines = text.replace(/\\r\\n/g, \"\\n\").split(\"\\n\");\n  // Line scan rather than a lazy `[\\s\\S]*?` fence regex (issue #2439).\n  let frontmatter: Record<string, string> = {};\n  let bodyLines = lines;\n  if (lines[0]?.trim() === \"---\") {\n    const close = lines.findIndex((line, idx) => idx > 0 && line.trim() === \"---\");\n    if (close !== -1) {\n      frontmatter = parseFlatFrontmatter(lines.slice(1, close).join(\"\\n\"));\n      bodyLines = lines.slice(close + 1);\n    }\n  }\n  const body = bodyLines.join(\"\\n\").trim();\n  if (body.length === 0) return null;\n  return {\n    slug,\n    name: frontmatter.name,\n    description: frontmatter.description,\n    body,\n    steps: parseProcedureStepsFromBody(body),\n    provenance: {\n      memoryId: frontmatter[SKILL_MEMORY_ID_KEY],\n      updated: frontmatter[SKILL_UPDATED_KEY],\n      source: frontmatter[SKILL_SOURCE_KEY],\n    },\n  };\n}\n\n/**\n * Minimal flat `key: value` frontmatter reader. Nested blocks and sequences\n * (e.g. `allowed-tools:`) are skipped — the import path only consumes scalars.\n */\nfunction parseFlatFrontmatter(block: string): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const line of block.split(\"\\n\")) {\n    if (/^\\s/.test(line) || line.trim().startsWith(\"#\")) continue;\n    const colon = line.indexOf(\":\");\n    if (colon <= 0) continue;\n    const key = line.slice(0, colon).trim();\n    const raw = line.slice(colon + 1).trim();\n    if (key.length === 0 || raw.length === 0) continue;\n    out[key] = unquoteScalar(raw);\n  }\n  return out;\n}\n\nfunction unquoteScalar(raw: string): string {\n  if (raw.startsWith('\"') && raw.endsWith('\"') && raw.length >= 2) {\n    try {\n      const parsed = JSON.parse(raw) as unknown;\n      if (typeof parsed === \"string\") return parsed;\n    } catch {\n      // fall through to the literal slice below\n    }\n    return raw.slice(1, -1);\n  }\n  if (raw.startsWith(\"'\") && raw.endsWith(\"'\") && raw.length >= 2) {\n    return raw.slice(1, -1);\n  }\n  return raw;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-YF6UHWOV.js → chunk-2EPOGPKO.js}

@@ -33,10 +33,10 @@ import {
   defineOperation,
   parseNamespacePreflightWriteOp,
   resolveAuthorizedNamespaceWritablePreflight
-} from "./chunk-WN5FSGLE.js";
+} from "./chunk-CV3GNPOE.js";
 import {
   validateBriefingFormat
-} from "./chunk-AYYGRVRP.js";
+} from "./chunk-IURMJBGP.js";
 import {
   enforceNamespaceAllowList,
   tokenCapabilityStore
@@ -538,4 +538,4 @@ defineOperation({ name: "graph_events", description: "SSE graph events.", schema
 defineOperation({ name: "chat_message", description: "Chat message.", schema: strictSchema({ message: S.str, chatSessionId: S.str }), handler: async (_i, _ctx) => ({ result: { ok: true } }) });
 defineOperation({ name: "chat_events", description: "SSE chat events.", schema: strictSchema({}), handler: async (_i, _ctx) => ({ result: { stream: "sse" } }) });
 defineOperation({ name: "adapters_status", description: "Adapter registry metadata (issue #1850 round 5). Marker op: the HTTP transport builds the response from its own adapterRegistry, but the op still must be registered so it appears in listRegisteredOperations and enforceTokenOp can gate it for scoped tokens.", schema: strictSchema({}), handler: async (_i, _ctx) => ({ result: { ok: true } }) });
-//# sourceMappingURL=chunk-YF6UHWOV.js.map
+//# sourceMappingURL=chunk-2EPOGPKO.js.map

package/dist/{chunk-IQSC3V2E.js → chunk-2IXQSGCU.js}

@@ -2,7 +2,7 @@ import {
   WHO_KNOWS_DEFAULT_LIMIT,
   WHO_KNOWS_MAX_LIMIT,
   validateWhoKnowsInput
-} from "./chunk-NZWEEALH.js";
+} from "./chunk-KFIOPZ25.js";
 
 // src/who-knows-cli.ts
 function extractWhoKnowsRawArgs(rest) {
@@ -74,4 +74,4 @@ export {
   renderWhoKnowsText,
   renderWhoKnows
 };
-//# sourceMappingURL=chunk-IQSC3V2E.js.map
+//# sourceMappingURL=chunk-2IXQSGCU.js.map

package/dist/{chunk-GUXS322H.js → chunk-2MVTAIL3.js}

@@ -1,6 +1,6 @@
 import {
   resolveCorpusNamespaceRoots
-} from "./chunk-P4DHENRE.js";
+} from "./chunk-WDXD6ITO.js";
 import {
   capabilityAllowsNamespace
 } from "./chunk-MZWSOLMT.js";
@@ -200,4 +200,4 @@ async function readAggregateExtractionWatermark(options) {
 export {
   readAggregateExtractionWatermark
 };
-//# sourceMappingURL=chunk-GUXS322H.js.map
+//# sourceMappingURL=chunk-2MVTAIL3.js.map

package/dist/{chunk-TDKSCV62.js → chunk-3NH3VP3U.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-KJTKLXTH.js";
 import {
   StorageManager
-} from "./chunk-PAYGC3BD.js";
+} from "./chunk-THVI4Y7X.js";
 import {
   copyExistingFileToBackup,
   writeFileAtomically
@@ -260,4 +260,4 @@ export {
   backupExistingLedger,
   rebuildMemoryLifecycleLedger
 };
-//# sourceMappingURL=chunk-TDKSCV62.js.map
+//# sourceMappingURL=chunk-3NH3VP3U.js.map

package/dist/{chunk-6TAX66IA.js → chunk-4JSF7UUP.js}

@@ -1,7 +1,7 @@
 import {
   SUPPORT_PASSPORT_DRAFT_MAX_CONTENT_CHARACTERS,
   SUPPORT_PASSPORT_DRAFT_MAX_MEMORIES
-} from "./chunk-WN5FSGLE.js";
+} from "./chunk-CV3GNPOE.js";
 import {
   SUPPORT_PASSPORT_SOURCE_MEMORY_ID_MAX_LENGTH
 } from "./chunk-XDL5CYZN.js";
@@ -343,4 +343,4 @@ export {
   parseSupportPassportModelJob,
   SupportPassportModelBridge
 };
-//# sourceMappingURL=chunk-6TAX66IA.js.map
+//# sourceMappingURL=chunk-4JSF7UUP.js.map

package/dist/{chunk-URHCUXKI.js → chunk-AXGFOFNY.js}

@@ -11,7 +11,7 @@ import {
 } from "./chunk-NOB2T2FC.js";
 import {
   parseConfig
-} from "./chunk-76PL4XLG.js";
+} from "./chunk-DPNXADEI.js";
 import {
   resolveObjectiveStateStoreDir,
   validateObjectiveStateSnapshot
@@ -268,4 +268,4 @@ export {
   recordResumeBundle,
   getResumeBundleStatus
 };
-//# sourceMappingURL=chunk-URHCUXKI.js.map
+//# sourceMappingURL=chunk-AXGFOFNY.js.map

package/dist/{chunk-BKYPJUQL.js → chunk-BA2GLSIP.js}

@@ -12,16 +12,16 @@ import {
 } from "./chunk-3HSRWJTC.js";
 import {
   handleSupportPassportOwnerHttp
-} from "./chunk-EV3YFLCB.js";
+} from "./chunk-BW4GAF57.js";
 import {
   buildSupportPassportPublicRequestHandler
-} from "./chunk-BQUEAVNW.js";
+} from "./chunk-NH6LC57D.js";
 import {
   nonEmptyQueryParam,
   optionalNamespaceKindQueryParam,
   optionalQueryString,
   positiveIntQueryParam
-} from "./chunk-D27J626P.js";
+} from "./chunk-BK5G2MHO.js";
 import {
   EngramMcpServer,
   MCP_SUPPORTED_PROTOCOL_VERSIONS,
@@ -31,10 +31,10 @@ import {
   processChatMessage,
   sessionBelongsToPrincipal,
   subscribeChatTranscript
-} from "./chunk-VA5KMSAE.js";
+} from "./chunk-KTPXXVDQ.js";
 import {
   RelayMissionStoreError
-} from "./chunk-TYUS5TLG.js";
+} from "./chunk-N56GVOWR.js";
 import {
   executeResolution,
   isValidResolutionVerb
@@ -61,15 +61,15 @@ import {
   authorizationProbeNamespaces,
   authorizationProbeRequiresPrincipalNamespace,
   probeOperationAuthorization
-} from "./chunk-GN55KU2P.js";
+} from "./chunk-IIRCHGWD.js";
 import {
   CorrectionContractError,
   getOperation,
   resolveQueryNamespaceWritablePreflight
-} from "./chunk-WN5FSGLE.js";
+} from "./chunk-CV3GNPOE.js";
 import {
   handleWhoKnowsHttpQuery
-} from "./chunk-NZWEEALH.js";
+} from "./chunk-KFIOPZ25.js";
 import {
   isTrustZoneName
 } from "./chunk-5QZR2RA3.js";
@@ -78,7 +78,7 @@ import {
 } from "./chunk-DEUNUKTD.js";
 import {
   isRecallDisclosure
-} from "./chunk-NXKJHSDN.js";
+} from "./chunk-LBFFNDFM.js";
 import {
   OFFLINE_SYNC_APPLY_MAX_BODY_BYTES,
   OFFLINE_SYNC_FILE_CONTENT_MAX_CHUNK_BYTES,
@@ -3494,4 +3494,4 @@ export {
   resolveDefaultAdminConsolePublicDir,
   EngramAccessHttpServer
 };
-//# sourceMappingURL=chunk-BKYPJUQL.js.map
+//# sourceMappingURL=chunk-BA2GLSIP.js.map

package/dist/{chunk-D27J626P.js → chunk-BK5G2MHO.js}

@@ -1,6 +1,6 @@
 import {
   isNamespaceKind
-} from "./chunk-MRTUN665.js";
+} from "./chunk-DUEDOYZD.js";
 import {
   EngramAccessInputError
 } from "./chunk-2Z24E5W2.js";
@@ -40,4 +40,4 @@ export {
   positiveIntQueryParam,
   optionalNamespaceKindQueryParam
 };
-//# sourceMappingURL=chunk-D27J626P.js.map
+//# sourceMappingURL=chunk-BK5G2MHO.js.map

package/dist/{chunk-EV3YFLCB.js → chunk-BW4GAF57.js}

@@ -2,7 +2,7 @@ import {
   SupportPassportError,
   SupportPassportOwnerCreateGrantRequestSchema,
   getOperation
-} from "./chunk-WN5FSGLE.js";
+} from "./chunk-CV3GNPOE.js";
 
 // src/support-passport/access-http.ts
 var OWNER_ROOT = "/engram/v1/support-passport";
@@ -137,4 +137,4 @@ export {
   SUPPORT_PASSPORT_OWNER_HTTP_ROUTES,
   handleSupportPassportOwnerHttp
 };
-//# sourceMappingURL=chunk-EV3YFLCB.js.map
+//# sourceMappingURL=chunk-BW4GAF57.js.map

package/dist/{chunk-DHTQP334.js → chunk-CQBIN77D.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-PAYGC3BD.js";
+} from "./chunk-THVI4Y7X.js";
 import {
   keyring_exports,
   secureStoreDir
@@ -412,4 +412,4 @@ export {
   resolveNamespaceStorageRoot,
   NamespaceStorageRouter
 };
-//# sourceMappingURL=chunk-DHTQP334.js.map
+//# sourceMappingURL=chunk-CQBIN77D.js.map