@remnic/core 9.65.1 → 9.65.3

package/dist/chunk-RIAM7DND.js

@@ -0,0 +1,167 @@
+import {
+  ContentHashIndex
+} from "./chunk-JOEJG4SD.js";
+import {
+  sanitizeMemoryContent
+} from "./chunk-5GKPFL3S.js";
+
+// src/memory-subject.ts
+var SUBJECT_VALUES = ["user", "agent"];
+var SUBJECT_GUARD_MODES = ["off", "warn", "enforce"];
+var SUBJECT_GUARD_OVERRIDE_FLAG = "--allow-user-subject";
+function isMemorySubject(value) {
+  return value === "user" || value === "agent";
+}
+function isSubjectGuardMode(value) {
+  return value === "off" || value === "warn" || value === "enforce";
+}
+var SUBJECT_CATEGORY_DEFAULTS = {
+  preference: "user",
+  relationship: "user",
+  moment: "user",
+  commitment: "user",
+  procedure: "agent",
+  principle: "agent",
+  skill: "agent"
+};
+function subjectDefaultForCategory(category) {
+  return SUBJECT_CATEGORY_DEFAULTS[category] ?? "user";
+}
+function resolveWriteSubject(category, extractorValue) {
+  return isMemorySubject(extractorValue) ? extractorValue : subjectDefaultForCategory(category);
+}
+function isSharedPromotionTarget(target) {
+  return target === "teamProject" || target === "serverShared";
+}
+function evaluateSubjectGuard(params) {
+  const effectiveSubject = params.subject ?? "user";
+  const base = { effectiveSubject, override: SUBJECT_GUARD_OVERRIDE_FLAG };
+  if (params.mode === "off" || !params.sharedTarget || effectiveSubject === "agent") {
+    return { action: "allow", reason: "", ...base };
+  }
+  if (params.allowUserSubject === true) {
+    return { action: "allow", reason: "user-subject promotion override accepted", ...base };
+  }
+  return {
+    action: params.mode === "enforce" ? "reject" : "warn",
+    reason: `subject=${effectiveSubject} memory targets a shared layer (team/server); user-subject memories model one person and must not be shared; override with ${SUBJECT_GUARD_OVERRIDE_FLAG} (allowUserSubject: true) if intended`,
+    ...base
+  };
+}
+var PROMOTION_CANDIDATES_DEFAULT_MIN_ACCESS = 3;
+function promotionCandidateKey(content) {
+  return ContentHashIndex.normalizeContent(sanitizeMemoryContent(content).text);
+}
+function computePromotionCandidates(options) {
+  if (!Number.isFinite(options.minAccessCount) || options.minAccessCount < 0) {
+    throw new Error(
+      `computePromotionCandidates: minAccessCount must be a non-negative number (got ${String(options.minAccessCount)})`
+    );
+  }
+  const targetKeys = new Set(
+    options.targetMemories.map((m) => promotionCandidateKey(m.content ?? ""))
+  );
+  const out = [];
+  for (const memory of options.memories) {
+    const fm = memory.frontmatter;
+    if (fm.subject !== "agent") continue;
+    if ((fm.status ?? "active") !== "active") continue;
+    const reinforcementCount = fm.reinforcement_count ?? 0;
+    const mwSuccess = fm.mw_success ?? 0;
+    const mwFail = fm.mw_fail ?? 0;
+    const accessCount = fm.accessCount ?? 0;
+    let reuseSignal;
+    if (reinforcementCount > 0) reuseSignal = "reinforcement";
+    else if (mwSuccess > mwFail) reuseSignal = "memory_worth";
+    else if (accessCount >= options.minAccessCount) reuseSignal = "access_count";
+    if (reuseSignal === void 0) continue;
+    if (targetKeys.has(promotionCandidateKey(memory.content ?? ""))) continue;
+    out.push({
+      id: fm.id,
+      path: memory.path,
+      category: fm.category,
+      content: memory.content ?? "",
+      accessCount,
+      reinforcementCount,
+      mwSuccess,
+      mwFail,
+      reuseSignal
+    });
+    if (options.limit !== void 0 && out.length >= options.limit) break;
+  }
+  return out;
+}
+var PROMOTION_CANDIDATES_MCP_TOOLS = [
+  {
+    // Registered as `engram.promotion_candidates`; `withToolAliases` emits
+    // the canonical `remnic.promotion_candidates` alias (dual-naming).
+    name: "engram.promotion_candidates",
+    description: "List agent-subject memories in the caller's namespace that are active, show a reuse signal (reinforcement_count > 0, mw_success > mw_fail, or accessCount >= threshold), and have no equivalent in the promotion target layer (default: the shared namespace). Read-only report; promotion itself uses the existing promotion commands (issue #2372).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        namespace: {
+          type: "string",
+          description: "Optional source namespace. Enforced against the caller's principal the same way recall is."
+        },
+        targetNamespace: {
+          type: "string",
+          description: "Promotion target layer checked for existing equivalents. Default: the shared namespace."
+        },
+        limit: {
+          type: "integer",
+          minimum: 1,
+          maximum: 100,
+          description: "Maximum candidates to return (default 20, max 100)."
+        }
+      },
+      additionalProperties: false
+    }
+  }
+];
+async function backfillMemorySubjects(options) {
+  const memories = await options.storage.readAllMemories();
+  const report = {
+    mode: options.mode,
+    scanned: memories.length,
+    stamped: 0,
+    alreadyStamped: 0,
+    stamps: []
+  };
+  for (const memory of memories) {
+    if (memory.frontmatter.subject !== void 0) {
+      report.alreadyStamped++;
+      continue;
+    }
+    const subject = subjectDefaultForCategory(memory.frontmatter.category);
+    report.stamps.push({
+      id: memory.frontmatter.id,
+      category: memory.frontmatter.category,
+      subject,
+      path: memory.path
+    });
+    if (options.mode === "apply") {
+      await options.storage.writeMemoryFrontmatter(memory, { subject });
+    }
+    report.stamped++;
+  }
+  return report;
+}
+
+export {
+  SUBJECT_VALUES,
+  SUBJECT_GUARD_MODES,
+  SUBJECT_GUARD_OVERRIDE_FLAG,
+  isMemorySubject,
+  isSubjectGuardMode,
+  subjectDefaultForCategory,
+  resolveWriteSubject,
+  isSharedPromotionTarget,
+  evaluateSubjectGuard,
+  PROMOTION_CANDIDATES_DEFAULT_MIN_ACCESS,
+  promotionCandidateKey,
+  computePromotionCandidates,
+  PROMOTION_CANDIDATES_MCP_TOOLS,
+  backfillMemorySubjects
+};
+//# sourceMappingURL=chunk-RIAM7DND.js.map

package/dist/chunk-RIAM7DND.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/memory-subject.ts"],"sourcesContent":["/**\n * Memory subject: user-centric vs agent-centric classification (issue #2372).\n *\n * Scope says WHERE a memory lives; subject says WHOM it is about — and that\n * is what determines where it may safely go. `user` memories model one\n * person (preferences, relationships, biography, moments, commitments);\n * `agent` memories model how to operate (procedures, principles,\n * tool-usage lessons, debugging strategies, environment facts with no\n * personal content).\n *\n * This module owns, in one place:\n *  - the deterministic write-time classification (category defaults with an\n *    optional extractor override),\n *  - the promotion guard shared by EVERY promotion surface (spaces promote\n *    AND scope-profile promotion targets — AGENTS.md §27 uniform gating),\n *  - read-only promotion-candidate surfacing (reuse-signaled agent-subject\n *    memories with no equivalent in the target layer), and\n *  - the deterministic backfill pass (shadow/apply, no LLM).\n */\n\nimport { ContentHashIndex } from \"./storage/content-hash-index.js\";\nimport { sanitizeMemoryContent } from \"./sanitize.js\";\nimport type { McpTool } from \"./access-mcp.js\";\nimport type { MemoryCategory, MemoryFile, MemorySubject, SubjectGuardMode } from \"./types.js\";\n\nexport const SUBJECT_VALUES = [\"user\", \"agent\"] as const;\nexport const SUBJECT_GUARD_MODES = [\"off\", \"warn\", \"enforce\"] as const;\n\n/** The CLI / per-call override that permits a user-subject promotion. */\nexport const SUBJECT_GUARD_OVERRIDE_FLAG = \"--allow-user-subject\";\n\nexport function isMemorySubject(value: unknown): value is MemorySubject {\n  return value === \"user\" || value === \"agent\";\n}\n\nexport function isSubjectGuardMode(value: unknown): value is SubjectGuardMode {\n  return value === \"off\" || value === \"warn\" || value === \"enforce\";\n}\n\n// ---------------------------------------------------------------------------\n// Write-time classification\n// ---------------------------------------------------------------------------\n\n/**\n * Deterministic category defaults (issue #2372 §1):\n *   user — preference, relationship, moment, commitment\n *   agent — procedure, principle, skill\n * Every other category has no default; the resolver falls back to `\"user\"`,\n * the most-restrictive value (Review Prevention Checklist §36 — an unsafe\n * enum default is never the convenient one).\n */\nconst SUBJECT_CATEGORY_DEFAULTS: Partial<Record<MemoryCategory, MemorySubject>> = {\n  preference: \"user\",\n  relationship: \"user\",\n  moment: \"user\",\n  commitment: \"user\",\n  procedure: \"agent\",\n  principle: \"agent\",\n  skill: \"agent\",\n};\n\nexport function subjectDefaultForCategory(category: MemoryCategory): MemorySubject {\n  return SUBJECT_CATEGORY_DEFAULTS[category] ?? \"user\";\n}\n\n/**\n * Resolve the write-time subject: the extractor's single-token value when it\n * emitted a valid one, else the category default. Never reclassifies on read.\n */\nexport function resolveWriteSubject(\n  category: MemoryCategory,\n  extractorValue: unknown,\n): MemorySubject {\n  return isMemorySubject(extractorValue) ? extractorValue : subjectDefaultForCategory(category);\n}\n\n// ---------------------------------------------------------------------------\n// Promotion guard (uniform across every promotion surface — §27)\n// ---------------------------------------------------------------------------\n\n/** Scope-profile promotion targets that are shared layers. */\nexport function isSharedPromotionTarget(target: string): boolean {\n  return target === \"teamProject\" || target === \"serverShared\";\n}\n\nexport interface SubjectGuardDecision {\n  action: \"allow\" | \"warn\" | \"reject\";\n  /** Effective subject — an absent subject resolves to \"user\" (fail closed, §36). */\n  effectiveSubject: MemorySubject;\n  /** Structured reason; empty string when action === \"allow\". */\n  reason: string;\n  /** The override that permits this promotion when action is reject/warn. */\n  override: typeof SUBJECT_GUARD_OVERRIDE_FLAG;\n}\n\n/**\n * Evaluate one promotion against the subject guard. Shared by the spaces\n * promotion workflow and the scope-profile promotion targets so the two\n * surfaces cannot drift (issue #2372 acceptance 2, AGENTS.md §27).\n *\n *  - mode \"off\", non-shared targets, agent-subject memories, and explicit\n *    `allowUserSubject` overrides all allow.\n *  - a `user`-subject memory (or a memory with NO subject — fail closed)\n *    promoted to a shared layer warns under \"warn\" and rejects under\n *    \"enforce\", with the override named in the reason (§39: never a silent\n *    accept).\n */\nexport function evaluateSubjectGuard(params: {\n  subject: MemorySubject | undefined;\n  sharedTarget: boolean;\n  mode: SubjectGuardMode;\n  allowUserSubject?: boolean;\n}): SubjectGuardDecision {\n  const effectiveSubject = params.subject ?? \"user\";\n  const base = { effectiveSubject, override: SUBJECT_GUARD_OVERRIDE_FLAG } as const;\n  if (params.mode === \"off\" || !params.sharedTarget || effectiveSubject === \"agent\") {\n    return { action: \"allow\", reason: \"\", ...base };\n  }\n  if (params.allowUserSubject === true) {\n    return { action: \"allow\", reason: \"user-subject promotion override accepted\", ...base };\n  }\n  return {\n    action: params.mode === \"enforce\" ? \"reject\" : \"warn\",\n    reason:\n      `subject=${effectiveSubject} memory targets a shared layer (team/server); ` +\n      `user-subject memories model one person and must not be shared; ` +\n      `override with ${SUBJECT_GUARD_OVERRIDE_FLAG} (allowUserSubject: true) if intended`,\n    ...base,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Promotion candidates (read-only surfacing — no auto-promotion)\n// ---------------------------------------------------------------------------\n\nexport type PromotionReuseSignal = \"reinforcement\" | \"memory_worth\" | \"access_count\";\n\nexport interface PromotionCandidate {\n  id: string;\n  path: string;\n  category: MemoryCategory;\n  content: string;\n  accessCount: number;\n  reinforcementCount: number;\n  mwSuccess: number;\n  mwFail: number;\n  reuseSignal: PromotionReuseSignal;\n}\n\n/** Default reuse-signal threshold for `accessCount` (config `promotionCandidates.minAccessCount`). */\nexport const PROMOTION_CANDIDATES_DEFAULT_MIN_ACCESS = 3;\n\n/** Canonical content form for target-equivalence checks (same normalize pipeline as dedup). */\nexport function promotionCandidateKey(content: string): string {\n  return ContentHashIndex.normalizeContent(sanitizeMemoryContent(content).text);\n}\n\n/**\n * List `subject: \"agent\"` memories that (a) are active, (b) show a reuse\n * signal (`reinforcement_count > 0` OR `mw_success > mw_fail` OR\n * `accessCount >= minAccessCount`), and (c) have no equivalent already in\n * the promotion target layer (content-hash check via the dedup normalizer).\n * Pure over the two memory lists; callers resolve namespaces.\n */\nexport function computePromotionCandidates(options: {\n  memories: MemoryFile[];\n  targetMemories: MemoryFile[];\n  minAccessCount: number;\n  limit?: number;\n}): PromotionCandidate[] {\n  if (!Number.isFinite(options.minAccessCount) || options.minAccessCount < 0) {\n    throw new Error(\n      `computePromotionCandidates: minAccessCount must be a non-negative number (got ${String(options.minAccessCount)})`,\n    );\n  }\n  const targetKeys = new Set(\n    options.targetMemories.map((m) => promotionCandidateKey(m.content ?? \"\")),\n  );\n  const out: PromotionCandidate[] = [];\n  for (const memory of options.memories) {\n    const fm = memory.frontmatter;\n    if (fm.subject !== \"agent\") continue;\n    if ((fm.status ?? \"active\") !== \"active\") continue;\n    const reinforcementCount = fm.reinforcement_count ?? 0;\n    const mwSuccess = fm.mw_success ?? 0;\n    const mwFail = fm.mw_fail ?? 0;\n    const accessCount = fm.accessCount ?? 0;\n    let reuseSignal: PromotionReuseSignal | undefined;\n    if (reinforcementCount > 0) reuseSignal = \"reinforcement\";\n    else if (mwSuccess > mwFail) reuseSignal = \"memory_worth\";\n    else if (accessCount >= options.minAccessCount) reuseSignal = \"access_count\";\n    if (reuseSignal === undefined) continue;\n    if (targetKeys.has(promotionCandidateKey(memory.content ?? \"\"))) continue;\n    out.push({\n      id: fm.id,\n      path: memory.path,\n      category: fm.category,\n      content: memory.content ?? \"\",\n\n      accessCount,\n      reinforcementCount,\n      mwSuccess,\n      mwFail,\n      reuseSignal,\n    });\n    if (options.limit !== undefined && out.length >= options.limit) break;\n  }\n  return out;\n}\n\nexport interface PromotionCandidatesResult {\n  namespace: string;\n  targetNamespace: string;\n  minAccessCount: number;\n  candidates: PromotionCandidate[];\n}\n\nexport const PROMOTION_CANDIDATES_MCP_TOOLS: McpTool[] = [\n  {\n    // Registered as `engram.promotion_candidates`; `withToolAliases` emits\n    // the canonical `remnic.promotion_candidates` alias (dual-naming).\n    name: \"engram.promotion_candidates\",\n    description:\n      \"List agent-subject memories in the caller's namespace that are active, show a reuse signal (reinforcement_count > 0, mw_success > mw_fail, or accessCount >= threshold), and have no equivalent in the promotion target layer (default: the shared namespace). Read-only report; promotion itself uses the existing promotion commands (issue #2372).\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        namespace: {\n          type: \"string\",\n          description:\n            \"Optional source namespace. Enforced against the caller's principal the same way recall is.\",\n        },\n        targetNamespace: {\n          type: \"string\",\n          description: \"Promotion target layer checked for existing equivalents. Default: the shared namespace.\",\n        },\n        limit: {\n          type: \"integer\",\n          minimum: 1,\n          maximum: 100,\n          description: \"Maximum candidates to return (default 20, max 100).\",\n        },\n      },\n      additionalProperties: false,\n    },\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Backfill (governance shadow/apply — deterministic rules only, no LLM)\n// ---------------------------------------------------------------------------\n\n/**\n * Storage surface the backfill needs (mirrors pattern-reinforcement's\n * structural interface so tests can pass an in-memory stub).\n * `writeMemoryFrontmatter` invalidates caches and syncs the fact-hash index\n * (§25/§31), so a stamped memory is immediately discoverable.\n */\nexport interface SubjectBackfillStorage {\n  readAllMemories(): Promise<MemoryFile[]>;\n  writeMemoryFrontmatter(memory: MemoryFile, patch: Partial<MemoryFile[\"frontmatter\"]>): Promise<boolean>;\n}\n\nexport interface SubjectBackfillReport {\n  mode: \"shadow\" | \"apply\";\n  scanned: number;\n  stamped: number;\n  alreadyStamped: number;\n  stamps: Array<{\n    id: string;\n    category: MemoryCategory;\n    subject: MemorySubject;\n    path: string;\n  }>;\n}\n\n/**\n * Stamp `subject` on memories that have none, using ONLY the deterministic\n * category defaults (never an LLM, never reclassifying an existing subject —\n * issue #2372 §1.3). `shadow` reports the intended stamps without writing;\n * `apply` writes through `writeMemoryFrontmatter`, which invalidates the\n * memory caches and re-syncs the fact-hash index.\n */\nexport async function backfillMemorySubjects(options: {\n  storage: SubjectBackfillStorage;\n  mode: \"shadow\" | \"apply\";\n}): Promise<SubjectBackfillReport> {\n  const memories = await options.storage.readAllMemories();\n  const report: SubjectBackfillReport = {\n    mode: options.mode,\n    scanned: memories.length,\n    stamped: 0,\n    alreadyStamped: 0,\n    stamps: [],\n  };\n  for (const memory of memories) {\n    if (memory.frontmatter.subject !== undefined) {\n      report.alreadyStamped++;\n      continue;\n    }\n    const subject = subjectDefaultForCategory(memory.frontmatter.category);\n    report.stamps.push({\n      id: memory.frontmatter.id,\n      category: memory.frontmatter.category,\n      subject,\n      path: memory.path,\n    });\n    if (options.mode === \"apply\") {\n      await options.storage.writeMemoryFrontmatter(memory, { subject });\n    }\n    report.stamped++;\n  }\n  return report;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-VZVP2W4O.js → chunk-RK4WXUI2.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-5JMAGU26.js";
 import {
   runPostConsolidationMaterialize
-} from "./chunk-6L27N6YI.js";
+} from "./chunk-S7Q5CM7E.js";
 import {
   isSemanticConsolidationLlmOperator
 } from "./chunk-G7D6GZ5J.js";
@@ -220,4 +220,4 @@ export {
   buildExtensionsBlockForConsolidation,
   materializeAfterSemanticConsolidation
 };
-//# sourceMappingURL=chunk-VZVP2W4O.js.map
+//# sourceMappingURL=chunk-RK4WXUI2.js.map

package/dist/{chunk-JBPKEARU.js → chunk-RKNJBZ55.js}

@@ -1,6 +1,3 @@
-import {
-  ReplitAdapter
-} from "./chunk-TMSXWOBZ.js";
 import {
   ClaudeCodeAdapter
 } from "./chunk-J64TK33U.js";
@@ -10,6 +7,9 @@ import {
 import {
   HermesAdapter
 } from "./chunk-42NQ7AVG.js";
+import {
+  ReplitAdapter
+} from "./chunk-TMSXWOBZ.js";
 
 // src/adapters/registry.ts
 var AdapterRegistry = class {
@@ -53,4 +53,4 @@ var AdapterRegistry = class {
 export {
   AdapterRegistry
 };
-//# sourceMappingURL=chunk-JBPKEARU.js.map
+//# sourceMappingURL=chunk-RKNJBZ55.js.map

package/dist/{chunk-6L27N6YI.js → chunk-S7Q5CM7E.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-RDFF2NAU.js";
 import {
   StorageManager
-} from "./chunk-DEFI2QBT.js";
+} from "./chunk-PAYGC3BD.js";
 import {
   excludeSupportPassportPrivateMemories
 } from "./chunk-XDL5CYZN.js";
@@ -138,4 +138,4 @@ export {
   runCodexMaterialize,
   runPostConsolidationMaterialize
 };
-//# sourceMappingURL=chunk-6L27N6YI.js.map
+//# sourceMappingURL=chunk-S7Q5CM7E.js.map

package/dist/{chunk-CTQRPANJ.js → chunk-SVSRPG6M.js}

@@ -10,7 +10,7 @@ import {
 } from "./chunk-5TBO7CDR.js";
 import {
   deriveSourceConnector
-} from "./chunk-S2VBSTTA.js";
+} from "./chunk-THG4GYIE.js";
 import {
   resolvePipelineProcessingCapabilities
 } from "./chunk-JUOZ62Y7.js";
@@ -108,4 +108,4 @@ export {
   renderExtractionConversation,
   applyGroundingWithConnector
 };
-//# sourceMappingURL=chunk-CTQRPANJ.js.map
+//# sourceMappingURL=chunk-SVSRPG6M.js.map

package/dist/{chunk-GXWDWOWP.js → chunk-TDKSCV62.js}

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

package/dist/{chunk-S2VBSTTA.js → chunk-THG4GYIE.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-OD4FM2U7.js";
 import {
   parseQmdExplain
-} from "./chunk-CEH2AFXG.js";
+} from "./chunk-C24UZSFW.js";
 import {
   classifyOrigin
 } from "./chunk-6Q3ZTEF6.js";
@@ -1708,4 +1708,4 @@ export {
   ExtractionDeadlineError,
   ExtractionRunCoordinator
 };
-//# sourceMappingURL=chunk-S2VBSTTA.js.map
+//# sourceMappingURL=chunk-THG4GYIE.js.map

package/dist/{chunk-IXRC7EQG.js → chunk-TR7DGXGI.js}

@@ -13,7 +13,7 @@ import {
 } from "./chunk-2AD5SXO4.js";
 import {
   ExtractionDeadlineError
-} from "./chunk-S2VBSTTA.js";
+} from "./chunk-THG4GYIE.js";
 import {
   resolvePrincipal
 } from "./chunk-MRV7VSQK.js";
@@ -798,4 +798,4 @@ var SmartBuffer = class {
 export {
   SmartBuffer
 };
-//# sourceMappingURL=chunk-IXRC7EQG.js.map
+//# sourceMappingURL=chunk-TR7DGXGI.js.map

package/dist/{chunk-63FHSH7E.js → chunk-TYUS5TLG.js}

@@ -1,16 +1,16 @@
 import {
   externalWikiSearchOperation
-} from "./chunk-KPBLJCCV.js";
+} from "./chunk-PDVQ5JU3.js";
 import {
   memoryStoreRequestSchema
-} from "./chunk-5HK3CJAR.js";
+} from "./chunk-W675UJCZ.js";
 import {
   CorrectionContractError,
   DECISION_SUBCOMMANDS,
   DELTA_SUBCOMMANDS,
   defineOperation,
   isCodegraphToolName
-} from "./chunk-3PXVYJMC.js";
+} from "./chunk-WN5FSGLE.js";
 import {
   serializeMutations,
   withHeldFileLock
@@ -1818,4 +1818,4 @@ export {
   codegraphIngestTracesOperation,
   REGISTERED_OPERATIONS
 };
-//# sourceMappingURL=chunk-63FHSH7E.js.map
+//# sourceMappingURL=chunk-TYUS5TLG.js.map

package/dist/{chunk-7PWWGYGO.js → chunk-URHCUXKI.js}

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

package/dist/{chunk-Z54TXZ2F.js → chunk-VA5KMSAE.js}

@@ -1,6 +1,6 @@
 import {
   MCP_READ_ONLY_TOOL_SUFFIXES
-} from "./chunk-MSTNSVXI.js";
+} from "./chunk-LDBFXD4F.js";
 import {
   EXTERNAL_WIKI_MCP_TOOLS
 } from "./chunk-A5KNZSNA.js";
@@ -15,20 +15,24 @@ import {
 } from "./chunk-T4WDJPEZ.js";
 import {
   validateRequest
-} from "./chunk-5HK3CJAR.js";
+} from "./chunk-W675UJCZ.js";
 import {
+  MCP_ADMIN_OPS_MIGRATED_OPERATIONS,
   MCP_ADMIN_OPS_TOOLS,
   MCP_GIT_CONTEXT_SCHEMA_PROPS_IGNORED
-} from "./chunk-56BSXSHC.js";
+} from "./chunk-AB3A7EFH.js";
 import {
   applyToolOutputSchemas
-} from "./chunk-GEULB2VI.js";
+} from "./chunk-FC7TIRFS.js";
 import {
   getOperation
-} from "./chunk-3PXVYJMC.js";
+} from "./chunk-WN5FSGLE.js";
 import {
   WHO_KNOWS_MCP_TOOLS
-} from "./chunk-R3AAOKR2.js";
+} from "./chunk-NZWEEALH.js";
+import {
+  PROMOTION_CANDIDATES_MCP_TOOLS
+} from "./chunk-RIAM7DND.js";
 import {
   SUPPORT_PASSPORT_SOURCE_MEMORY_ID_MAX_LENGTH
 } from "./chunk-XDL5CYZN.js";
@@ -1590,6 +1594,7 @@ var MCP_MIGRATED_OPERATIONS = {
   "engram.recall_tier_explain": "recall_tier_explain",
   "engram.recall_xray": "recall_xray",
   "engram.who_knows": "who_knows",
+  "engram.promotion_candidates": "promotion_candidates",
   "engram.wearables_status": "wearables_status",
   "engram.wearables_sync": "wearables_sync",
   "engram.transcript_day": "transcript_day",
@@ -1609,6 +1614,7 @@ var MCP_MIGRATED_OPERATIONS = {
   "engram.procedure_mining_run": "procedure_mining_run",
   "engram.pattern_reinforcement_run": "pattern_reinforcement_run",
   "engram.procedural_stats": "procedural_stats",
+  "engram.procedure_library_maintenance": "procedure_library_maintenance",
   "engram.memory_timeline": "memory_timeline",
   "engram.suggestion_submit": "suggestion_submit",
   "engram.entity_get": "entity_get",
@@ -1671,6 +1677,7 @@ var MCP_MIGRATED_OPERATIONS = {
   "engram.dreams_status": "dreams_status",
   "engram.dreams_run": "dreams_run",
   ...SUPPORT_PASSPORT_MCP_MIGRATED_OPERATIONS,
+  ...MCP_ADMIN_OPS_MIGRATED_OPERATIONS,
   "engram.memory_chat": "chat_message"
 };
 var STRICT_MCP_SCHEMA_KEYS = {
@@ -1963,6 +1970,7 @@ var EngramMcpServer = class {
       ...WEARABLES_MCP_TOOLS,
       ...MEETINGS_MCP_TOOLS,
       ...WHO_KNOWS_MCP_TOOLS,
+      ...PROMOTION_CANDIDATES_MCP_TOOLS,
       ...service.supportPassportEnabled ? SUPPORT_PASSPORT_MCP_TOOLS : [],
       {
         name: "engram.action_confidence",
@@ -3953,6 +3961,7 @@ export {
   sessionBelongsToPrincipal,
   processChatMessage,
   MCP_SUPPORTED_PROTOCOL_VERSIONS,
+  MCP_MIGRATED_OPERATIONS,
   EngramMcpServer
 };
-//# sourceMappingURL=chunk-Z54TXZ2F.js.map
+//# sourceMappingURL=chunk-VA5KMSAE.js.map