@remnic/core 9.3.684 → 9.3.686

package/dist/temporal-supersession.js

@@ -6,9 +6,9 @@ import {
   shouldFilterSupersededFromRecall,
   shouldSupersedeExisting,
   supersessionKeysForFact
-} from "./chunk-YTWNKQ2G.js";
+} from "./chunk-3FC6LW6T.js";
 import "./chunk-MDYG7VI7.js";
-import "./chunk-2ODBA7MQ.js";
+import "./chunk-NU3CSQ4H.js";
 import "./chunk-PZ5AY32C.js";
 export {
   applyTemporalSupersession,

package/dist/threading.js

@@ -1,8 +1,8 @@
 import {
   ThreadingManager
-} from "./chunk-W4RVMTHR.js";
+} from "./chunk-QRDOSYOR.js";
 import "./chunk-FF4KLI5W.js";
-import "./chunk-2ODBA7MQ.js";
+import "./chunk-NU3CSQ4H.js";
 import "./chunk-PZ5AY32C.js";
 export {
   ThreadingManager

package/dist/transcript.js

@@ -1,11 +1,11 @@
 import {
   TranscriptManager,
   utcDayRange
-} from "./chunk-AGRPGAKR.js";
+} from "./chunk-PONNZ54D.js";
 import "./chunk-S4DDLTPX.js";
 import "./chunk-KFY3SGN7.js";
 import "./chunk-FF4KLI5W.js";
-import "./chunk-2ODBA7MQ.js";
+import "./chunk-NU3CSQ4H.js";
 import "./chunk-PZ5AY32C.js";
 export {
   TranscriptManager,

package/dist/transfer/types.d.ts

@@ -108,6 +108,10 @@ declare const ExportBundleV1Schema: z.ZodObject<{
         path: string;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
+    records: {
+        content: string;
+        path: string;
+    }[];
     manifest: {
         schemaVersion: 1;
         createdAt: string;
@@ -120,11 +124,11 @@ declare const ExportBundleV1Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
     };
+}, {
     records: {
         content: string;
         path: string;
     }[];
-}, {
     manifest: {
         schemaVersion: 1;
         createdAt: string;
@@ -137,10 +141,6 @@ declare const ExportBundleV1Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
     };
-    records: {
-        content: string;
-        path: string;
-    }[];
 }>;
 type ExportBundleV1 = z.infer<typeof ExportBundleV1Schema>;
 /**
@@ -313,13 +313,13 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         peerProfiles: boolean;
     }>;
 }, "strip", z.ZodTypeAny, {
+    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
-    schemaVersion: string;
     id: string;
     description: string;
     version: string;
@@ -334,13 +334,13 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         directAnswerEnabled: boolean;
     };
 }, {
+    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
-    schemaVersion: string;
     id: string;
     description: string;
     version: string;
@@ -464,13 +464,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             peerProfiles: boolean;
         }>;
     }, "strip", z.ZodTypeAny, {
+        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -485,13 +485,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             directAnswerEnabled: boolean;
         };
     }, {
+        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -518,13 +518,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
     pluginVersion: string;
     includesTranscripts: boolean;
     capsule: {
+        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -551,13 +551,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
     pluginVersion: string;
     includesTranscripts: boolean;
     capsule: {
+        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -683,13 +683,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 peerProfiles: boolean;
             }>;
         }, "strip", z.ZodTypeAny, {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -704,13 +704,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 directAnswerEnabled: boolean;
             };
         }, {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -737,13 +737,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -770,13 +770,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -803,6 +803,10 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         path: string;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
+    records: {
+        content: string;
+        path: string;
+    }[];
     manifest: {
         schemaVersion: 2;
         createdAt: string;
@@ -815,13 +819,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -837,11 +841,11 @@ declare const ExportBundleV2Schema: z.ZodObject<{
             };
         };
     };
+}, {
     records: {
         content: string;
         path: string;
     }[];
-}, {
     manifest: {
         schemaVersion: 2;
         createdAt: string;
@@ -854,13 +858,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -876,10 +880,6 @@ declare const ExportBundleV2Schema: z.ZodObject<{
             } | null | undefined;
         };
     };
-    records: {
-        content: string;
-        path: string;
-    }[];
 }>;
 type ExportBundleV2 = z.infer<typeof ExportBundleV2Schema>;
 type AnyExportManifest = ExportManifestV1 | ExportManifestV2;

package/dist/verified-recall.js

@@ -1,9 +1,9 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-XEA4Z7JU.js";
-import "./chunk-HQ6NIBL6.js";
-import "./chunk-53FDU4CE.js";
+} from "./chunk-4FE2K57M.js";
+import "./chunk-7FL4CNPV.js";
+import "./chunk-BLIWOONZ.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
@@ -27,7 +27,7 @@ import "./chunk-VS2IYZRU.js";
 import "./chunk-ZPQVJEVQ.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-JUC24CTX.js";
-import "./chunk-2ODBA7MQ.js";
+import "./chunk-NU3CSQ4H.js";
 import "./chunk-ZBJMUXZH.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.3.684",
+  "version": "9.3.686",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -2931,7 +2931,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.3.684"
+    "@remnic/coding-graph": "^9.3.686"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/access-boundary.ts

@@ -33,7 +33,8 @@ import { expandTildePath } from "./utils/path.js";
 export type OperationName =
   | "memory_get"
   | "memory_search"
-  | "memory_store";
+  | "memory_store"
+  | "coding_decision";
 
 // ---------------------------------------------------------------------------
 // Operation context — what every handler receives

package/src/access-cli.ts

@@ -11,10 +11,11 @@ import { getOperation } from "./access-boundary.js";
 // Importing access-operations registers the pilot boundary operations as a
 // side effect; the store command dispatches through the registry (issue #1525).
 import "./access-operations.js";
+import { projectTagProjectId } from "./coding/coding-namespace.js";
 
 const OPENCLAW_REMNIC_PLUGIN_IDS = ["openclaw-remnic", "openclaw-engram"] as const;
 
-type CommandName = "browse" | "store";
+type CommandName = "browse" | "store" | "decision";
 
 type ParsedArgs = {
   command: CommandName;
@@ -133,9 +134,9 @@ function writeCliOutput(text: string = ""): void {
 
 function usage(): string {
   return [
-    "Usage:",
     "  engram-access browse [options]",
     "  engram-access store [options]",
+    "  engram-access decision [options]",
     "",
     "Browse options:",
     "  --namespace <name>",
@@ -160,6 +161,21 @@ function usage(): string {
     "  --source-reason <text>",
     "  --idempotency-key <key>",
     "  --dry-run",
+    "",
+    "Decision options:",
+    "  --subcommand <list|get|record|supersede>",
+    "  --namespace <name>",
+    "  --session-key <key>",
+    "  --principal <principal>",
+    "  --id <id> (get/supersede)",
+    "  --title <title> (record/supersede)",
+    "  --status <proposed|accepted|superseded|rejected> (record)",
+    "  --context <text> (record/supersede)",
+    "  --decision <text> (record/supersede)",
+    "  --consequences <text> (record/supersede)",
+    "  --entity-ref <ref> (repeatable)",
+    "  --project-tag <tag> (attach coding context for this invocation)",
+    "  --supersedes-id <id> (alias for --id on supersede)",
   ].join("\n");
 }
 
@@ -194,8 +210,25 @@ const COMMAND_SPECS: Record<CommandName, CommandSpec> = {
     ]),
     flagOptions: new Set(["dry-run"]),
   },
+  decision: {
+    valueOptions: new Set([
+      "subcommand",
+      "namespace",
+      "session-key",
+      "principal",
+      "id",
+      "title",
+      "status",
+      "context",
+      "decision",
+      "consequences",
+      "entity-ref",
+      "project-tag",
+      "supersedes-id",
+    ]),
+    flagOptions: new Set(),
+  },
 };
-
 const BROWSE_SORT_VALUES = Object.freeze([
   "updated_desc",
   "updated_asc",
@@ -207,7 +240,7 @@ type BrowseSort = (typeof BROWSE_SORT_VALUES)[number];
 
 function parseArgs(argv: string[]): ParsedArgs {
   const [commandRaw, ...rest] = argv;
-  if (commandRaw !== "browse" && commandRaw !== "store") {
+  if (commandRaw !== "browse" && commandRaw !== "store" && commandRaw !== "decision") {
     throw new UsageError("unsupported-command");
   }
   const spec = COMMAND_SPECS[commandRaw];
@@ -466,6 +499,59 @@ function expandOptionalPath(value: string | undefined): string | undefined {
   return value === undefined ? undefined : expandTildePath(value);
 }
 
+/**
+ * Decision-record surface (issue #1548 Track A PR 2). Dispatches through the
+ * same `coding_decision` operation as the MCP tool and HTTP route — one
+ * validation boundary, three transports.
+ */
+async function runDecision(args: ParsedArgs, preferredId?: string): Promise<void> {
+  const subcommand = requireOption(args, "subcommand");
+  const { config, service } = buildRuntime(preferredId);
+  // The CLI creates a fresh Orchestrator per invocation, so the session
+  // coding-context map is empty. If --project-tag + --session-key are
+  // provided, attach a coding context BEFORE dispatching so the gate
+  // passes and project-scoped writes resolve to the right namespace
+  // (review P2).
+  const projectTag = getLastOption(args, "project-tag");
+  const sessionKey = getLastOption(args, "session-key");
+  if (projectTag && projectTag.trim().length > 0 && sessionKey && sessionKey.trim().length > 0) {
+    const projectId = projectTagProjectId(projectTag.trim());
+    service.setCodingContext({
+      sessionKey,
+      codingContext: {
+        projectId,
+        branch: null,
+        rootPath: projectId,
+        defaultBranch: null,
+      },
+    });
+  }
+  const op = getOperation("coding_decision");
+  if (!op) {
+    throw new Error("access-boundary: operation not registered: coding_decision");
+  }
+  const output = (await op.run(
+    {
+      subcommand,
+      namespace: getLastOption(args, "namespace"),
+      sessionKey,
+      id: getLastOption(args, "id"),
+      supersedesId: getLastOption(args, "supersedes-id"),
+      title: getLastOption(args, "title"),
+      status: getLastOption(args, "status"),
+      context: getLastOption(args, "context"),
+      decision: getLastOption(args, "decision"),
+      consequences: getLastOption(args, "consequences"),
+      entityRefs: getAllOptions(args, "entity-ref"),
+    },
+    {
+      service,
+      authenticatedPrincipal: getLastOption(args, "principal") ?? config.agentAccessHttp.principal,
+    },
+  )) as { result: unknown };
+  console.log(JSON.stringify(output.result, null, 2));
+}
+
 export async function main(
   argv: string[] = process.argv.slice(2),
   options: AccessCliOptions = {},
@@ -475,6 +561,10 @@ export async function main(
     await runBrowse(args, options.preferredId);
     return;
   }
+  if (args.command === "decision") {
+    await runDecision(args, options.preferredId);
+    return;
+  }
   await runStore(args, options.preferredId);
 }
 

package/src/access-http.ts

@@ -315,6 +315,7 @@ export class EngramAccessHttpServer {
       citationsEnabled: options.citationsEnabled,
       citationsAutoDetect: options.citationsAutoDetect,
       emitLegacyTools: options.emitLegacyTools,
+      codingDecisionVisible: this.service.decisionRecordSurfaceVisible,
     });
   }
 
@@ -1331,6 +1332,35 @@ export class EngramAccessHttpServer {
       return;
     }
 
+    if (req.method === "POST" && pathname === "/engram/v1/coding/decisions") {
+      // Migrated through the access boundary (issue #1525/#1548): the
+      // registry entry owns schema validation and service dispatch. HTTP
+      // resolves the request principal; the boundary re-validates the
+      // cleaned envelope. record/supersede persist decision memories, so they
+      // are gated by the same 30/min write quota as /engram/v1/memories,
+      // suggestions, and observe; list/get are pure reads and stay uncounted
+      // (review P2: apply write quotas to decision writes).
+      const body = await this.readJsonBody(req);
+      const isWriteSubcommand =
+        body.subcommand === "record" || body.subcommand === "supersede";
+      if (isWriteSubcommand) {
+        this.ensureWriteRateLimitAvailable();
+      }
+      const op = getOperation("coding_decision");
+      if (!op) {
+        throw new EngramAccessInputError("access-boundary: operation not registered: coding_decision");
+      }
+      const output = (await op.run(body, {
+        service: this.service,
+        authenticatedPrincipal: this.resolveRequestPrincipal(req),
+      })) as { result: unknown };
+      if (isWriteSubcommand) {
+        this.recordWriteRateLimitHit();
+      }
+      this.respondJson(res, 200, output.result);
+      return;
+    }
+
     if (req.method === "POST" && pathname === "/engram/v1/suggestions") {
       const body = await this.readValidatedBody(req, "suggestionSubmit");
       const request = {
@@ -1707,7 +1737,7 @@ export class EngramAccessHttpServer {
         // extraction write path. Record it so QMD maintenance / writtenSince
         // don't miss the write. Best-effort and failure-tolerant.
         onMergedMemoryWritten: (namespace, storageDir) => {
-          this.service.recordCatalogWrite(namespace, storageDir);
+          // #1522: catalog touch handled at the storage chokepoint.
         },
       });
       this.respondJson(res, 200, result);
@@ -2183,6 +2213,13 @@ export class EngramAccessHttpServer {
       typeof toolArgs === "object" &&
       !Array.isArray(toolArgs) &&
       (toolArgs as { dryRun?: unknown }).dryRun === true;
+    const codingDecisionWrite =
+      (toolName === "engram.coding_decision" || toolName === "remnic.coding_decision") &&
+      toolArgs !== null &&
+      typeof toolArgs === "object" &&
+      !Array.isArray(toolArgs) &&
+      ((toolArgs as { subcommand?: unknown }).subcommand === "record" ||
+        (toolArgs as { subcommand?: unknown }).subcommand === "supersede");
     const isMcpWrite =
       request.method === "tools/call" &&
       (
@@ -2210,7 +2247,8 @@ export class EngramAccessHttpServer {
             toolName === "engram.memory_action_apply" ||
             toolName === "remnic.memory_action_apply"
           )
-        )
+        ) ||
+        codingDecisionWrite
       );
     if (isMcpWrite) {
       this.ensureWriteRateLimitAvailable();

package/src/access-mcp.ts

@@ -109,6 +109,7 @@ const MCP_MIGRATED_OPERATIONS: Readonly<Record<string, OperationName>> = {
   "engram.memory_get": "memory_get",
   "engram.memory_search": "memory_search",
   "engram.memory_store": "memory_store",
+  "engram.coding_decision": "coding_decision",
 };
 
 function resolveChatGptInspectorRecallSessionKey(
@@ -304,7 +305,9 @@ export class EngramMcpServer {
    */
   private initSessionIds = new Map<string, string>();
 
-  /** Whether oai-mem-citation guidance is explicitly enabled via config. */
+  /**
+   * Whether oai-mem-citation guidance is explicitly enabled via config.
+   */
   private readonly citationsEnabled: boolean;
   /** Whether to auto-enable citations for Codex adapter connections. */
   private readonly citationsAutoDetect: boolean;
@@ -314,6 +317,13 @@ export class EngramMcpServer {
    * set false to halve the advertised `tools/list` surface.
    */
   private readonly emitLegacyTools: boolean;
+  /**
+   * Whether the `coding_decision` tool should appear in `tools/list`. Gated on
+   * `codingKnowledge.enabled && codingKnowledge.decisionRecords` (issue #1548
+   * Track A PR 2, rule 39). When false the tools array is byte-identical to
+   * pre-feature.
+   */
+  private readonly codingDecisionVisible: boolean;
 
   constructor(
     private readonly service: EngramAccessService,
@@ -322,11 +332,13 @@ export class EngramMcpServer {
       citationsEnabled?: boolean;
       citationsAutoDetect?: boolean;
       emitLegacyTools?: boolean;
+      codingDecisionVisible?: boolean;
     } = {},
   ) {
     this.citationsEnabled = options.citationsEnabled === true;
     this.citationsAutoDetect = options.citationsAutoDetect !== false;
     this.emitLegacyTools = options.emitLegacyTools !== false;
+    this.codingDecisionVisible = options.codingDecisionVisible === true;
     this.authenticatedPrincipal =
       options.principal?.trim() ||
       readEnvVar("OPENCLAW_ENGRAM_ACCESS_PRINCIPAL")?.trim() ||
@@ -1946,6 +1958,47 @@ export class EngramMcpServer {
         },
       },
     ].flatMap((tool) => withToolAliases(tool, this.emitLegacyTools));
+    if (this.codingDecisionVisible) {
+      const codingDecisionTools = withToolAliases(
+        {
+          name: "engram.coding_decision",
+          description:
+            "List, get, record, or supersede decision records in the session's coding namespace (issue #1548 Track A). Subcommands: list, get, record, supersede.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              subcommand: {
+                type: "string",
+                enum: ["list", "get", "record", "supersede"],
+                description: "Which decision-record operation to run.",
+              },
+              sessionKey: { type: "string", description: "Session identifier whose coding context scopes the operation." },
+              namespace: { type: "string", description: "Optional explicit namespace (overrides coding-context overlay)." },
+              id: { type: "string", description: "Decision record id (required for get and supersede)." },
+              title: { type: "string", description: "Decision title (required for record and supersede)." },
+              status: {
+                type: "string",
+                enum: ["proposed", "accepted", "superseded", "rejected"],
+                description: "Decision status (record only; defaults to proposed).",
+              },
+              context: { type: "string", description: "Context/background for the decision." },
+              decision: { type: "string", description: "The decision itself (required for record and supersede)." },
+              consequences: { type: "string", description: "Consequences of the decision." },
+              entityRefs: {
+                type: "array",
+                items: { type: "string" },
+                description: "Entity references the decision relates to.",
+              },
+              supersedesId: { type: "string", description: "Id of the record this decision supersedes (supersede only)." },
+            },
+            required: ["subcommand"],
+            additionalProperties: false,
+          },
+        },
+        this.emitLegacyTools,
+      );
+      this.tools = [...this.tools, ...codingDecisionTools];
+    }
   }
 
   /** Get clientInfo for a specific MCP session. Returns undefined for non-MCP requests. */
@@ -3231,7 +3284,7 @@ export class EngramMcpServer {
           // extraction write path. Record it so QMD maintenance / writtenSince
           // don't miss the write. Best-effort and failure-tolerant.
           onMergedMemoryWritten: (namespace, storageDir) => {
-            this.service.recordCatalogWrite(namespace, storageDir);
+            // #1522: catalog touch handled at the storage chokepoint.
           },
         });
       }