@remnic/core 9.3.685 → 9.3.686

package/dist/{access-service-DeKrlYU_.d.ts → access-service-DmCHJ4cH.d.ts}

@@ -92,6 +92,81 @@ interface ConsoleStateSnapshot {
     errors: string[];
 }
 
+/**
+ * Decision-record surface contract + handler (issue #1548 Track A PR 2).
+ *
+ * Rule 39: one gate predicate, checked identically on every surface. Rule 22
+ * spirit: one implementation behind three thin wirings. The service holds
+ * only a thin delegate that builds a {@link DecisionSurfaceContext} and calls
+ * {@link handleCodingDecision}; the handler logic lives here so the
+ * access-service god file gains thin wiring only.
+ *
+ * No orchestrator imports (rule 11 — no shared mutable state). No circular
+ * dependency on access-service.ts: validation errors are thrown via
+ * `ctx.throwInputError`, which the service wires to EngramAccessInputError.
+ */
+
+declare const DECISION_SUBCOMMANDS: readonly ["list", "get", "record", "supersede"];
+type DecisionSubcommand = (typeof DECISION_SUBCOMMANDS)[number];
+/**
+ * Canonical surface request — one shape for all three transports. The
+ * `subcommand` field selects which operation runs; the remaining fields are
+ * optional depending on the subcommand.
+ *
+ * `sessionKey` identifies the session whose coding context scopes the
+ * operation. `namespace` overrides the coding-scoped namespace (same
+ * precedence as `memory_store` — explicit namespace wins).
+ */
+interface DecisionSurfaceRequest {
+    subcommand: DecisionSubcommand;
+    sessionKey?: string;
+    namespace?: string;
+    id?: string;
+    title?: string;
+    status?: string;
+    context?: string;
+    decision?: string;
+    consequences?: string;
+    entityRefs?: string[];
+    supersedesId?: string;
+}
+/**
+ * Surface response — a discriminated union on `subcommand`. Each surface
+ * serializes this to its transport-appropriate shape.
+ */
+type DecisionSurfaceResponse = {
+    subcommand: "list";
+    records: DecisionSurfaceRecord[];
+    count: number;
+} | {
+    subcommand: "get";
+    found: boolean;
+    record?: DecisionSurfaceRecord;
+} | {
+    subcommand: "record";
+    memoryId: string;
+    status: string;
+} | {
+    subcommand: "supersede";
+    supersededMemoryId: string;
+    replacementMemoryId: string;
+};
+/**
+ * Flattened record projection surfaced to clients. Stored as markdown +
+ * frontmatter memory files (category `"decision"`) — this shape is the
+ * read-side projection, not the storage format.
+ */
+interface DecisionSurfaceRecord {
+    id: string;
+    title: string;
+    status: string;
+    context?: string;
+    decision?: string;
+    consequences?: string;
+    entityRefs: string[];
+    supersedes?: string;
+}
+
 /**
  * Procedural memory stats surface (issue #567 PR 5/5).
  *
@@ -916,40 +991,31 @@ declare class EngramAccessService {
      * priority over `cwd` (matching `maybeAttachCodingContext`).
      */
     private resolveCodingContextFromOptions;
+    /** Shared coding-scope derivation for the read/write resolvers below —
+     *  coding context, overlay, principal, scope-profile plan for an IMPLICIT
+     *  request, IDENTICAL to recall precedence (session-first, per-call fallback)
+     *  so a scoped store is discoverable by scoped recall (#1434). Single source
+     *  of truth for the namespacesEnabled/projectScope gates (rule 22; keeps the
+     *  scattered-config-read ratchet flat). READ-ONLY: never mutates session. */
+    private resolveCodingScopeInputs;
     /**
      * Resolve the write namespace for explicit-write tools (memory_store /
      * suggestion_submit), project-scoping the write the same way recall does so a
      * memory stored with a client-injected `cwd`/`projectTag` is discoverable by
-     * project-scoped recall (#1434, rule 42).
-     *
-     * Precedence:
-     *  - An explicit `namespace` always wins and is authorized strictly via
-     *    `resolveWritableNamespace` → `canWriteNamespace`. A coding-overlay
-     *    namespace string (`<base>-project-*`) is NOT a writable target via the
-     *    explicit field — project scoping is requested with `cwd`/`projectTag`,
-     *    never by naming the derived namespace — so there is no way to bypass the
-     *    policy allow-list by guessing/forging an overlay name (Codex review).
-     *  - With NO coding overlay, the write stays on `config.defaultNamespace` —
-     *    exactly the pre-#1434 behavior, so an unqualified write is NOT silently
-     *    moved to a principal self namespace (Codex review).
-     *  - WITH a coding overlay, the base is the principal self namespace
-     *    (`defaultNamespaceForPrincipal`, write-checked) — the SAME base recall,
-     *    observe, and the orchestrator buffer-flush write path overlay onto
-     *    (rule 42 / Cursor) — so a project-scoped store lands exactly where
-     *    project-scoped recall searches. The overlay namespace is always REBUILT
-     *    from the authenticated principal's base, never accepted as a caller
-     *    string, so a caller can never reach another principal's subtree.
-     *
-     * Read-only: this NEVER mutates session coding context, so the idempotency
-     * peeks and dryRun preflights that call it stay side-effect free (Codex
-     * review). It prefers the per-call `cwd`/`projectTag` (the project explicitly
-     * identified for this write), else the session's existing context. The HTTP
-     * surface lets the peek and the write each resolve independently; the peek's
-     * namespace only gates rate-limiting (memory_store/suggestion_submit run their
-     * own idempotency check), so a benign session-context change between the two
-     * never fails a write — there is no namespace to "pin".
+     * project-scoped recall (#1434, rule 42). Shared derivation lives in
+     * {@link resolveCodingScopeInputs}; this method enforces the WRITE acl
+     * (`canWriteNamespace` / profile-layer writability). Read-only: never mutates
+     * session coding context.
      */
     private resolveCodingScopedWriteNamespace;
+    /** Read-side mirror of {@link resolveCodingScopedWriteNamespace}. Decision
+     *  `list`/`get` use this so a record written by a project-scoped session is
+     *  listable/fetchable by the SAME session without manually supplying the
+     *  overlaid namespace (review P2). Derivation is IDENTICAL to the write path
+     *  (shared via {@link resolveCodingScopeInputs}); the only difference is the
+     *  ACL — reads enforce {@link canReadNamespace}, so a read-but-not-write
+     *  principal can still list/fetch (rule 42). */
+    private resolveCodingScopedReadableNamespace;
     /**
      * Resolve ONE effective memory scope plan for a write-producing request
      * (#1495 / seed for epic #1494). The returned {@link MemoryScopePlan} is the
@@ -1121,6 +1187,16 @@ declare class EngramAccessService {
     peekSuggestionSubmitIdempotency(request: EngramAccessSuggestionSubmitRequest): Promise<EngramAccessIdempotencyStatus>;
     private validateWriteCandidate;
     memoryGet(memoryId: string, namespace?: string, principal?: string): Promise<EngramAccessMemoryResponse>;
+    /** Whether the coding_decision tool should appear in tools/list (rule 39). */
+    get decisionRecordSurfaceVisible(): boolean;
+    /**
+     * Thin delegate — handler logic in coding/decision-surfaces.ts (#1548 PR2).
+     * All three surfaces (MCP/HTTP/CLI) arrive here via the boundary operation.
+     * Namespace resolution uses the SAME path as memory_store (principal ACL +
+     * coding overlay + default fallback) so decision records land in the same
+     * storage root.
+     */
+    codingDecision(request: DecisionSurfaceRequest, authenticatedPrincipal?: string): Promise<DecisionSurfaceResponse>;
     memoryBrowse(request?: EngramAccessMemoryBrowseRequest): Promise<EngramAccessMemoryBrowseResponse>;
     memoryTimeline(memoryId: string, namespace?: string, limit?: number, principal?: string): Promise<EngramAccessTimelineResponse>;
     entityList(options?: {
@@ -1887,4 +1963,4 @@ declare class EngramAccessService {
     }): Promise<Awaited<ReturnType<WearablesService["transcriptMemories"]>>>;
 }
 
-export { type EngramAccessRecallExplainRequest as $, type EngramAccessLcmStatusResponse as A, type EngramAccessMaintenanceResponse as B, type CodingScopedWriteInput as C, type EngramAccessMemoryBrowseRequest as D, type EngramAccessMemoryResponse as E, type EngramAccessMemoryBrowseResponse as F, type EngramAccessMemoryRecord as G, type EngramAccessMemoryStoreRequest as H, type EngramAccessMemorySummary as I, type EngramAccessObserveMessage as J, type EngramAccessObserveRequest as K, type EngramAccessObserveResponse as L, type EngramAccessOfflineSyncApplyFileContentRequest as M, type EngramAccessOfflineSyncApplyFileContentResponse as N, type EngramAccessOfflineSyncApplyRequest as O, type ProcedureStatsConfigSnapshot as P, type EngramAccessOfflineSyncApplyResponse as Q, type EngramAccessOfflineSyncFileContentRequest as R, type EngramAccessOfflineSyncFileContentResponse as S, type EngramAccessOfflineSyncFilesRequest as T, type EngramAccessOfflineSyncFilesResponse as U, type EngramAccessOfflineSyncSnapshotRequest as V, type EngramAccessOfflineSyncSnapshotResponse as W, type EngramAccessOfflineSyncSnapshotStreamResponse as X, type EngramAccessQmdCollectionState as Y, type EngramAccessQmdHealthResponse as Z, type EngramAccessQualityResponse as _, type EngramAccessWriteResponse as a, type EngramAccessRecallExplainResponse as a0, type EngramAccessRecallRequest as a1, type EngramAccessReviewDispositionRequest as a2, type EngramAccessReviewDispositionResponse as a3, type EngramAccessReviewQueueResponse as a4, type EngramAccessScopeDebug as a5, type EngramAccessSetCodingContextRequest as a6, type EngramAccessSuggestionSubmitRequest as a7, type EngramAccessTimelineResponse as a8, type EngramAccessTrustZoneBrowseRequest as a9, type EngramAccessTrustZoneBrowseResponse as aa, type EngramAccessTrustZoneDemoSeedRequest as ab, type EngramAccessTrustZoneDemoSeedResponse as ac, type EngramAccessTrustZonePromoteRequest as ad, type EngramAccessTrustZonePromoteResponse as ae, type EngramAccessTrustZoneRecordSummary as af, type EngramAccessTrustZoneStatusResponse as ag, type EngramAccessWriteEnvelope as ah, type MemoryScopePlan as ai, shapeMemorySummary as aj, EngramAccessService as b, type EngramAccessRecallResponse as c, EngramAccessInputError as d, type ProcedureStatsRecent as e, type ProcedureStatsReport as f, type ProcedureStatusCounts as g, computeProcedureStats as h, formatProcedureStatsText as i, ENGRAM_ACCESS_WRITE_SCHEMA_VERSION as j, type EngramAccessActionConfidenceRequest as k, type EngramAccessActionConfidenceResponse as l, type EngramAccessBriefingRequest as m, type EngramAccessBriefingResponse as n, type EngramAccessCapsuleListResponse as o, type EngramAccessDaySummaryRequest as p, type EngramAccessEntityListResponse as q, type EngramAccessEntityResponse as r, type EngramAccessEntitySummary as s, type EngramAccessHealthResponse as t, type EngramAccessLcmCompactionFlushRequest as u, type EngramAccessLcmCompactionFlushResponse as v, type EngramAccessLcmCompactionRecordRequest as w, type EngramAccessLcmCompactionRecordResponse as x, type EngramAccessLcmSearchRequest as y, type EngramAccessLcmSearchResponse as z };
+export { type EngramAccessQmdHealthResponse as $, type EngramAccessLcmSearchResponse as A, type EngramAccessLcmStatusResponse as B, type CodingScopedWriteInput as C, type DecisionSurfaceRequest as D, type EngramAccessMemoryResponse as E, type EngramAccessMaintenanceResponse as F, type EngramAccessMemoryBrowseRequest as G, type EngramAccessMemoryBrowseResponse as H, type EngramAccessMemoryRecord as I, type EngramAccessMemoryStoreRequest as J, type EngramAccessMemorySummary as K, type EngramAccessObserveMessage as L, type EngramAccessObserveRequest as M, type EngramAccessObserveResponse as N, type EngramAccessOfflineSyncApplyFileContentRequest as O, type ProcedureStatsConfigSnapshot as P, type EngramAccessOfflineSyncApplyFileContentResponse as Q, type EngramAccessOfflineSyncApplyRequest as R, type EngramAccessOfflineSyncApplyResponse as S, type EngramAccessOfflineSyncFileContentRequest as T, type EngramAccessOfflineSyncFileContentResponse as U, type EngramAccessOfflineSyncFilesRequest as V, type EngramAccessOfflineSyncFilesResponse as W, type EngramAccessOfflineSyncSnapshotRequest as X, type EngramAccessOfflineSyncSnapshotResponse as Y, type EngramAccessOfflineSyncSnapshotStreamResponse as Z, type EngramAccessQmdCollectionState as _, type DecisionSurfaceResponse as a, type EngramAccessQualityResponse as a0, type EngramAccessRecallExplainRequest as a1, type EngramAccessRecallExplainResponse as a2, type EngramAccessRecallRequest as a3, type EngramAccessReviewDispositionRequest as a4, type EngramAccessReviewDispositionResponse as a5, type EngramAccessReviewQueueResponse as a6, type EngramAccessScopeDebug as a7, type EngramAccessSetCodingContextRequest as a8, type EngramAccessSuggestionSubmitRequest as a9, type EngramAccessTimelineResponse as aa, type EngramAccessTrustZoneBrowseRequest as ab, type EngramAccessTrustZoneBrowseResponse as ac, type EngramAccessTrustZoneDemoSeedRequest as ad, type EngramAccessTrustZoneDemoSeedResponse as ae, type EngramAccessTrustZonePromoteRequest as af, type EngramAccessTrustZonePromoteResponse as ag, type EngramAccessTrustZoneRecordSummary as ah, type EngramAccessTrustZoneStatusResponse as ai, type EngramAccessWriteEnvelope as aj, type MemoryScopePlan as ak, shapeMemorySummary as al, type EngramAccessWriteResponse as b, EngramAccessService as c, type EngramAccessRecallResponse as d, EngramAccessInputError as e, type ProcedureStatsRecent as f, type ProcedureStatsReport as g, type ProcedureStatusCounts as h, computeProcedureStats as i, formatProcedureStatsText as j, ENGRAM_ACCESS_WRITE_SCHEMA_VERSION as k, type EngramAccessActionConfidenceRequest as l, type EngramAccessActionConfidenceResponse as m, type EngramAccessBriefingRequest as n, type EngramAccessBriefingResponse as o, type EngramAccessCapsuleListResponse as p, type EngramAccessDaySummaryRequest as q, type EngramAccessEntityListResponse as r, type EngramAccessEntityResponse as s, type EngramAccessEntitySummary as t, type EngramAccessHealthResponse as u, type EngramAccessLcmCompactionFlushRequest as v, type EngramAccessLcmCompactionFlushResponse as w, type EngramAccessLcmCompactionRecordRequest as x, type EngramAccessLcmCompactionRecordResponse as y, type EngramAccessLcmSearchRequest as z };

package/dist/access-service.d.ts

@@ -1,6 +1,6 @@
 import './storage.js';
 import './types-B1VHaf2w.js';
-export { C as CodingScopedWriteInput, j as ENGRAM_ACCESS_WRITE_SCHEMA_VERSION, k as EngramAccessActionConfidenceRequest, l as EngramAccessActionConfidenceResponse, m as EngramAccessBriefingRequest, n as EngramAccessBriefingResponse, o as EngramAccessCapsuleListResponse, p as EngramAccessDaySummaryRequest, q as EngramAccessEntityListResponse, r as EngramAccessEntityResponse, s as EngramAccessEntitySummary, t as EngramAccessHealthResponse, d as EngramAccessInputError, u as EngramAccessLcmCompactionFlushRequest, v as EngramAccessLcmCompactionFlushResponse, w as EngramAccessLcmCompactionRecordRequest, x as EngramAccessLcmCompactionRecordResponse, y as EngramAccessLcmSearchRequest, z as EngramAccessLcmSearchResponse, A as EngramAccessLcmStatusResponse, B as EngramAccessMaintenanceResponse, D as EngramAccessMemoryBrowseRequest, F as EngramAccessMemoryBrowseResponse, G as EngramAccessMemoryRecord, E as EngramAccessMemoryResponse, H as EngramAccessMemoryStoreRequest, I as EngramAccessMemorySummary, J as EngramAccessObserveMessage, K as EngramAccessObserveRequest, L as EngramAccessObserveResponse, M as EngramAccessOfflineSyncApplyFileContentRequest, N as EngramAccessOfflineSyncApplyFileContentResponse, O as EngramAccessOfflineSyncApplyRequest, Q as EngramAccessOfflineSyncApplyResponse, R as EngramAccessOfflineSyncFileContentRequest, S as EngramAccessOfflineSyncFileContentResponse, T as EngramAccessOfflineSyncFilesRequest, U as EngramAccessOfflineSyncFilesResponse, V as EngramAccessOfflineSyncSnapshotRequest, W as EngramAccessOfflineSyncSnapshotResponse, X as EngramAccessOfflineSyncSnapshotStreamResponse, Y as EngramAccessQmdCollectionState, Z as EngramAccessQmdHealthResponse, _ as EngramAccessQualityResponse, $ as EngramAccessRecallExplainRequest, a0 as EngramAccessRecallExplainResponse, a1 as EngramAccessRecallRequest, c as EngramAccessRecallResponse, a2 as EngramAccessReviewDispositionRequest, a3 as EngramAccessReviewDispositionResponse, a4 as EngramAccessReviewQueueResponse, a5 as EngramAccessScopeDebug, b as EngramAccessService, a6 as EngramAccessSetCodingContextRequest, a7 as EngramAccessSuggestionSubmitRequest, a8 as EngramAccessTimelineResponse, a9 as EngramAccessTrustZoneBrowseRequest, aa as EngramAccessTrustZoneBrowseResponse, ab as EngramAccessTrustZoneDemoSeedRequest, ac as EngramAccessTrustZoneDemoSeedResponse, ad as EngramAccessTrustZonePromoteRequest, ae as EngramAccessTrustZonePromoteResponse, af as EngramAccessTrustZoneRecordSummary, ag as EngramAccessTrustZoneStatusResponse, ah as EngramAccessWriteEnvelope, a as EngramAccessWriteResponse, ai as MemoryScopePlan, aj as shapeMemorySummary } from './access-service-DeKrlYU_.js';
+export { C as CodingScopedWriteInput, k as ENGRAM_ACCESS_WRITE_SCHEMA_VERSION, l as EngramAccessActionConfidenceRequest, m as EngramAccessActionConfidenceResponse, n as EngramAccessBriefingRequest, o as EngramAccessBriefingResponse, p as EngramAccessCapsuleListResponse, q as EngramAccessDaySummaryRequest, r as EngramAccessEntityListResponse, s as EngramAccessEntityResponse, t as EngramAccessEntitySummary, u as EngramAccessHealthResponse, e as EngramAccessInputError, v as EngramAccessLcmCompactionFlushRequest, w as EngramAccessLcmCompactionFlushResponse, x as EngramAccessLcmCompactionRecordRequest, y as EngramAccessLcmCompactionRecordResponse, z as EngramAccessLcmSearchRequest, A as EngramAccessLcmSearchResponse, B as EngramAccessLcmStatusResponse, F as EngramAccessMaintenanceResponse, G as EngramAccessMemoryBrowseRequest, H as EngramAccessMemoryBrowseResponse, I as EngramAccessMemoryRecord, E as EngramAccessMemoryResponse, J as EngramAccessMemoryStoreRequest, K as EngramAccessMemorySummary, L as EngramAccessObserveMessage, M as EngramAccessObserveRequest, N as EngramAccessObserveResponse, O as EngramAccessOfflineSyncApplyFileContentRequest, Q as EngramAccessOfflineSyncApplyFileContentResponse, R as EngramAccessOfflineSyncApplyRequest, S as EngramAccessOfflineSyncApplyResponse, T as EngramAccessOfflineSyncFileContentRequest, U as EngramAccessOfflineSyncFileContentResponse, V as EngramAccessOfflineSyncFilesRequest, W as EngramAccessOfflineSyncFilesResponse, X as EngramAccessOfflineSyncSnapshotRequest, Y as EngramAccessOfflineSyncSnapshotResponse, Z as EngramAccessOfflineSyncSnapshotStreamResponse, _ as EngramAccessQmdCollectionState, $ as EngramAccessQmdHealthResponse, a0 as EngramAccessQualityResponse, a1 as EngramAccessRecallExplainRequest, a2 as EngramAccessRecallExplainResponse, a3 as EngramAccessRecallRequest, d as EngramAccessRecallResponse, a4 as EngramAccessReviewDispositionRequest, a5 as EngramAccessReviewDispositionResponse, a6 as EngramAccessReviewQueueResponse, a7 as EngramAccessScopeDebug, c as EngramAccessService, a8 as EngramAccessSetCodingContextRequest, a9 as EngramAccessSuggestionSubmitRequest, aa as EngramAccessTimelineResponse, ab as EngramAccessTrustZoneBrowseRequest, ac as EngramAccessTrustZoneBrowseResponse, ad as EngramAccessTrustZoneDemoSeedRequest, ae as EngramAccessTrustZoneDemoSeedResponse, af as EngramAccessTrustZonePromoteRequest, ag as EngramAccessTrustZonePromoteResponse, ah as EngramAccessTrustZoneRecordSummary, ai as EngramAccessTrustZoneStatusResponse, aj as EngramAccessWriteEnvelope, b as EngramAccessWriteResponse, ak as MemoryScopePlan, al as shapeMemorySummary } from './access-service-DmCHJ4cH.js';
 import './recall-explain-renderer.js';
 import './types-Dm5xxVrr.js';
 import './recall-audit-anomaly.js';

package/dist/access-service.js

@@ -3,7 +3,7 @@ import {
   EngramAccessInputError,
   EngramAccessService,
   shapeMemorySummary
-} from "./chunk-SQGPGC76.js";
+} from "./chunk-FUCUR2OZ.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import "./chunk-ARV3AUOM.js";

package/dist/access-surface-catalog.d.ts

@@ -1,6 +1,6 @@
 import { OperationName } from './access-boundary.js';
 import 'zod';
-import './access-service-DeKrlYU_.js';
+import './access-service-DmCHJ4cH.js';
 import './storage.js';
 import './page-versioning.js';
 import './consolidation-operator.js';

package/dist/access-surface-catalog.js

@@ -25,6 +25,7 @@ var MCP_TOOLS = [
   { tool: "memory_get", operation: "memory_get" },
   { tool: "memory_timeline", operation: null },
   { tool: "memory_store", operation: "memory_store" },
+  { tool: "coding_decision", operation: "coding_decision" },
   { tool: "suggestion_submit", operation: null },
   { tool: "entity_get", operation: null },
   { tool: "review_queue_list", operation: null },
@@ -113,6 +114,7 @@ var HTTP_ROUTES = [
   { method: "POST", pathname: "/engram/v1/lcm/compaction/record", operation: null },
   { method: "GET", pathname: "/engram/v1/lcm/status", operation: null },
   { method: "POST", pathname: "/engram/v1/memories", operation: "memory_store" },
+  { method: "POST", pathname: "/engram/v1/coding/decisions", operation: "coding_decision" },
   { method: "POST", pathname: "/engram/v1/suggestions", operation: null },
   { method: "GET", pathname: "/engram/v1/memories", operation: null },
   { method: "GET", pathname: "/engram/v1/memories/:id", operation: "memory_get" },

package/dist/access-surface-catalog.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/access-surface-catalog.ts"],"sourcesContent":["/**\n * Static inventory of every handler on the MCP and HTTP access surfaces, with\n * its migration status against the access boundary (issue #1525).\n *\n * The fitness test (`access-surface-catalog.test.ts`) walks this catalog,\n * checks each entry against the live registry, and counts unmigrated handlers.\n * The ratchet (`scripts/check-ratchets.mjs`) reads this file and counts\n * `operation: null` entries so the unmigrated count can only decrease.\n *\n * WHEN MIGRATING A HANDLER (follow-up PRs):\n *   1. Add the operation to `access-operations.ts` via `defineOperation`.\n *   2. Flip its entry here from `operation: null` to `operation: \"<name>\"`.\n *   3. Delete the surface-local validation the handler used to do.\n *   4. Run `node scripts/check-ratchets.mjs --update` to ratchet the count\n *      down — the improvement is recorded in `scripts/ratchet-baseline.json`.\n *\n * WHEN ADDING A NEW HANDLER:\n *   1. Add the entry here with `operation: null` (the fitness test will fail\n *      until you either migrate it or acknowledge it as unmigrated).\n *   2. Migrate it in the same PR if it carries user input — the boundary's\n *      whole point is that no new handler bypasses it.\n */\n\nimport type { OperationName } from \"./access-boundary.js\";\n\n/**\n * One row per MCP tool, keyed by the canonical SHORT name (no `engram.`/\n * `remnic.` prefix — both aliases dispatch to the same operation). The name\n * MUST match the tool's short suffix as advertised by `tools/list`.\n */\nexport interface McpToolEntry {\n  readonly tool: string;\n  readonly operation: OperationName | null;\n}\n\n/**\n * One row per HTTP route that invokes an access-service method. Routes that\n * only serve static assets, SSE streams, or admin console HTML are excluded —\n * they don't carry user-validated request envelopes into the facade.\n */\nexport interface HttpRouteEntry {\n  readonly method: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n  readonly pathname: string;\n  readonly operation: OperationName | null;\n}\n\n// Each tool below corresponds 1:1 to an `engram.*` definition in\n// `EngramMcpServer.tools` (access-mcp.ts). The fitness test asserts the live\n// `tools/list` response matches this list by short name, so a new tool cannot\n// land without either migrating it or acknowledging the unmigrated count.\nexport const MCP_TOOLS: readonly McpToolEntry[] = [\n  { tool: \"recall\", operation: null },\n  { tool: \"recall_explain\", operation: null },\n  { tool: \"set_coding_context\", operation: null },\n  { tool: \"recall_tier_explain\", operation: null },\n  { tool: \"recall_xray\", operation: null },\n  { tool: \"wearables_status\", operation: null },\n  { tool: \"wearables_sync\", operation: null },\n  { tool: \"transcript_day\", operation: null },\n  { tool: \"transcript_search\", operation: null },\n  { tool: \"transcript_memories\", operation: null },\n  { tool: \"action_confidence\", operation: null },\n  { tool: \"chatgpt_memory_inspector\", operation: null },\n  { tool: \"day_summary\", operation: null },\n  { tool: \"capsule_export\", operation: null },\n  { tool: \"capsule_import\", operation: null },\n  { tool: \"capsule_list\", operation: null },\n  { tool: \"memory_governance_run\", operation: null },\n  { tool: \"procedure_mining_run\", operation: null },\n  { tool: \"pattern_reinforcement_run\", operation: null },\n  { tool: \"procedural_stats\", operation: null },\n  { tool: \"memory_get\", operation: \"memory_get\" },\n  { tool: \"memory_timeline\", operation: null },\n  { tool: \"memory_store\", operation: \"memory_store\" },\n  { tool: \"suggestion_submit\", operation: null },\n  { tool: \"entity_get\", operation: null },\n  { tool: \"review_queue_list\", operation: null },\n  { tool: \"observe\", operation: null },\n  { tool: \"lcm_search\", operation: null },\n  { tool: \"lcm_compaction_flush\", operation: null },\n  { tool: \"lcm_compaction_record\", operation: null },\n  { tool: \"continuity_audit_generate\", operation: null },\n  { tool: \"continuity_incident_open\", operation: null },\n  { tool: \"continuity_incident_close\", operation: null },\n  { tool: \"continuity_incident_list\", operation: null },\n  { tool: \"continuity_loop_add_or_update\", operation: null },\n  { tool: \"continuity_loop_review\", operation: null },\n  { tool: \"identity_anchor_get\", operation: null },\n  { tool: \"identity_anchor_update\", operation: null },\n  { tool: \"memory_identity\", operation: null },\n  { tool: \"work_task\", operation: null },\n  { tool: \"work_project\", operation: null },\n  { tool: \"work_board\", operation: null },\n  { tool: \"shared_context_write_output\", operation: null },\n  { tool: \"shared_feedback_record\", operation: null },\n  { tool: \"shared_priorities_append\", operation: null },\n  { tool: \"shared_context_cross_signals_run\", operation: null },\n  { tool: \"shared_context_curate_daily\", operation: null },\n  { tool: \"compounding_weekly_synthesize\", operation: null },\n  { tool: \"compounding_promote_candidate\", operation: null },\n  { tool: \"compression_guidelines_optimize\", operation: null },\n  { tool: \"compression_guidelines_activate\", operation: null },\n  { tool: \"memory_search\", operation: \"memory_search\" },\n  { tool: \"memory_profile\", operation: null },\n  { tool: \"memory_entities_list\", operation: null },\n  { tool: \"memory_questions\", operation: null },\n  { tool: \"memory_last_recall\", operation: null },\n  { tool: \"memory_intent_debug\", operation: null },\n  { tool: \"memory_qmd_debug\", operation: null },\n  { tool: \"memory_graph_explain\", operation: null },\n  { tool: \"graph_snapshot\", operation: null },\n  { tool: \"memory_feedback\", operation: null },\n  { tool: \"memory_promote\", operation: null },\n  { tool: \"memory_outcome\", operation: null },\n  { tool: \"memory_action_apply\", operation: null },\n  { tool: \"context_checkpoint\", operation: null },\n  { tool: \"briefing\", operation: null },\n  { tool: \"review_list\", operation: null },\n  { tool: \"review_resolve\", operation: null },\n  { tool: \"contradiction_scan_run\", operation: null },\n  { tool: \"memory_summarize_hourly\", operation: null },\n  { tool: \"conversation_index_update\", operation: null },\n  { tool: \"profiling_report\", operation: null },\n  { tool: \"graph_edge_decay_run\", operation: null },\n  { tool: \"live_connectors_run\", operation: null },\n  { tool: \"peer_list\", operation: null },\n  { tool: \"peer_get\", operation: null },\n  { tool: \"peer_set\", operation: null },\n  { tool: \"peer_delete\", operation: null },\n  { tool: \"peer_profile_get\", operation: null },\n  { tool: \"peer_forget\", operation: null },\n  { tool: \"console_state\", operation: null },\n  { tool: \"dreams_status\", operation: null },\n  { tool: \"dreams_run\", operation: null },\n];\n\n// Each route below corresponds 1:1 to a service-invoking route branch in\n// `EngramAccessHttpServer.handle` (access-http.ts). Pathname patterns use\n// `:param` for path segments. The fitness test asserts each entry resolves\n// against the catalog so a new service route cannot land without either\n// migrating it or acknowledging the unmigrated count. Infrastructure probes\n// (health, adapters, the /mcp delegate, admin console, SSE-only endpoints)\n// carry no user request envelope and are intentionally excluded.\nexport const HTTP_ROUTES: readonly HttpRouteEntry[] = [\n  { method: \"POST\", pathname: \"/engram/v1/recall\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/coding-context\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/capsules/export\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/capsules/import\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/offline-sync/snapshot\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/offline-sync/snapshot-stream\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/offline-sync/snapshot\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/offline-sync/files\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/offline-sync/file-content\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/offline-sync/apply-file-content\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/offline-sync/apply\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/recall/explain\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/action-confidence\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/recall/tier-explain\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/recall/xray\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/wearables/status\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/wearables/sync\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/wearables/transcript\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/wearables/transcripts/search\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/wearables/memories\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/observe\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/lcm/search\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/lcm/compaction/flush\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/lcm/compaction/record\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/lcm/status\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/memories\", operation: \"memory_store\" },\n  { method: \"POST\", pathname: \"/engram/v1/suggestions\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/memories\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/memories/:id\", operation: \"memory_get\" },\n  { method: \"GET\", pathname: \"/engram/v1/memories/:id/timeline\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/entities\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/entities/:id\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/review-queue\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/maintenance\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/quality\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/trust-zones/status\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/procedural/stats\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/trust-zones/records\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/review-disposition\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/trust-zones/promote\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/trust-zones/demo-seed\", operation: null },\n  { method: \"POST\", pathname: \"/v1/citations/observed\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/review/contradictions\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/review/contradictions/:id\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/review/resolve\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/graph/snapshot\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/contradiction-scan\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/graph/events\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/console/state\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/peers\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/peers/:id/profile\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/peers/:id\", operation: null },\n  { method: \"PUT\", pathname: \"/engram/v1/peers/:id\", operation: null },\n  { method: \"DELETE\", pathname: \"/engram/v1/peers/:id\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/dreams/status\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/dreams/run\", operation: null },\n];\n\n/**\n * Total unmigrated-handler count across both surfaces. The ratchet baseline\n * tracks this number; it may only decrease. `access-surface-catalog.test.ts`\n * recomputes it from the live catalog and asserts equality, so a catalog edit\n * without a baseline bump (or, ideally, a migration) fails the gate.\n */\nexport function countUnmigratedHandlers(): number {\n  let count = 0;\n  for (const entry of MCP_TOOLS) {\n    if (entry.operation === null) count += 1;\n  }\n  for (const entry of HTTP_ROUTES) {\n    if (entry.operation === null) count += 1;\n  }\n  return count;\n}\n"],"mappings":";;;AAkDO,IAAM,YAAqC;AAAA,EAChD,EAAE,MAAM,UAAU,WAAW,KAAK;AAAA,EAClC,EAAE,MAAM,kBAAkB,WAAW,KAAK;AAAA,EAC1C,EAAE,MAAM,sBAAsB,WAAW,KAAK;AAAA,EAC9C,EAAE,MAAM,uBAAuB,WAAW,KAAK;AAAA,EAC/C,EAAE,MAAM,eAAe,WAAW,KAAK;AAAA,EACvC,EAAE,MAAM,oBAAoB,WAAW,KAAK;AAAA,EAC5C,EAAE,MAAM,kBAAkB,WAAW,KAAK;AAAA,EAC1C,EAAE,MAAM,kBAAkB,WAAW,KAAK;AAAA,EAC1C,EAAE,MAAM,qBAAqB,WAAW,KAAK;AAAA,EAC7C,EAAE,MAAM,uBAAuB,WAAW,KAAK;AAAA,EAC/C,EAAE,MAAM,qBAAqB,WAAW,KAAK;AAAA,EAC7C,EAAE,MAAM,4BAA4B,WAAW,KAAK;AAAA,EACpD,EAAE,MAAM,eAAe,WAAW,KAAK;AAAA,EACvC,EAAE,MAAM,kBAAkB,WAAW,KAAK;AAAA,EAC1C,EAAE,MAAM,kBAAkB,WAAW,KAAK;AAAA,EAC1C,EAAE,MAAM,gBAAgB,WAAW,KAAK;AAAA,EACxC,EAAE,MAAM,yBAAyB,WAAW,KAAK;AAAA,EACjD,EAAE,MAAM,wBAAwB,WAAW,KAAK;AAAA,EAChD,EAAE,MAAM,6BAA6B,WAAW,KAAK;AAAA,EACrD,EAAE,MAAM,oBAAoB,WAAW,KAAK;AAAA,EAC5C,EAAE,MAAM,cAAc,WAAW,aAAa;AAAA,EAC9C,EAAE,MAAM,mBAAmB,WAAW,KAAK;AAAA,EAC3C,EAAE,MAAM,gBAAgB,WAAW,eAAe;AAAA,EAClD,EAAE,MAAM,qBAAqB,WAAW,KAAK;AAAA,EAC7C,EAAE,MAAM,cAAc,WAAW,KAAK;AAAA,EACtC,EAAE,MAAM,qBAAqB,WAAW,KAAK;AAAA,EAC7C,EAAE,MAAM,WAAW,WAAW,KAAK;AAAA,EACnC,EAAE,MAAM,cAAc,WAAW,KAAK;AAAA,EACtC,EAAE,MAAM,wBAAwB,WAAW,KAAK;AAAA,EAChD,EAAE,MAAM,yBAAyB,WAAW,KAAK;AAAA,EACjD,EAAE,MAAM,6BAA6B,WAAW,KAAK;AAAA,EACrD,EAAE,MAAM,4BAA4B,WAAW,KAAK;AAAA,EACpD,EAAE,MAAM,6BAA6B,WAAW,KAAK;AAAA,EACrD,EAAE,MAAM,4BAA4B,WAAW,KAAK;AAAA,EACpD,EAAE,MAAM,iCAAiC,WAAW,KAAK;AAAA,EACzD,EAAE,MAAM,0BAA0B,WAAW,KAAK;AAAA,EAClD,EAAE,MAAM,uBAAuB,WAAW,KAAK;AAAA,EAC/C,EAAE,MAAM,0BAA0B,WAAW,KAAK;AAAA,EAClD,EAAE,MAAM,mBAAmB,WAAW,KAAK;AAAA,EAC3C,EAAE,MAAM,aAAa,WAAW,KAAK;AAAA,EACrC,EAAE,MAAM,gBAAgB,WAAW,KAAK;AAAA,EACxC,EAAE,MAAM,cAAc,WAAW,KAAK;AAAA,EACtC,EAAE,MAAM,+BAA+B,WAAW,KAAK;AAAA,EACvD,EAAE,MAAM,0BAA0B,WAAW,KAAK;AAAA,EAClD,EAAE,MAAM,4BAA4B,WAAW,KAAK;AAAA,EACpD,EAAE,MAAM,oCAAoC,WAAW,KAAK;AAAA,EAC5D,EAAE,MAAM,+BAA+B,WAAW,KAAK;AAAA,EACvD,EAAE,MAAM,iCAAiC,WAAW,KAAK;AAAA,EACzD,EAAE,MAAM,iCAAiC,WAAW,KAAK;AAAA,EACzD,EAAE,MAAM,mCAAmC,WAAW,KAAK;AAAA,EAC3D,EAAE,MAAM,mCAAmC,WAAW,KAAK;AAAA,EAC3D,EAAE,MAAM,iBAAiB,WAAW,gBAAgB;AAAA,EACpD,EAAE,MAAM,kBAAkB,WAAW,KAAK;AAAA,EAC1C,EAAE,MAAM,wBAAwB,WAAW,KAAK;AAAA,EAChD,EAAE,MAAM,oBAAoB,WAAW,KAAK;AAAA,EAC5C,EAAE,MAAM,sBAAsB,WAAW,KAAK;AAAA,EAC9C,EAAE,MAAM,uBAAuB,WAAW,KAAK;AAAA,EAC/C,EAAE,MAAM,oBAAoB,WAAW,KAAK;AAAA,EAC5C,EAAE,MAAM,wBAAwB,WAAW,KAAK;AAAA,EAChD,EAAE,MAAM,kBAAkB,WAAW,KAAK;AAAA,EAC1C,EAAE,MAAM,mBAAmB,WAAW,KAAK;AAAA,EAC3C,EAAE,MAAM,kBAAkB,WAAW,KAAK;AAAA,EAC1C,EAAE,MAAM,kBAAkB,WAAW,KAAK;AAAA,EAC1C,EAAE,MAAM,uBAAuB,WAAW,KAAK;AAAA,EAC/C,EAAE,MAAM,sBAAsB,WAAW,KAAK;AAAA,EAC9C,EAAE,MAAM,YAAY,WAAW,KAAK;AAAA,EACpC,EAAE,MAAM,eAAe,WAAW,KAAK;AAAA,EACvC,EAAE,MAAM,kBAAkB,WAAW,KAAK;AAAA,EAC1C,EAAE,MAAM,0BAA0B,WAAW,KAAK;AAAA,EAClD,EAAE,MAAM,2BAA2B,WAAW,KAAK;AAAA,EACnD,EAAE,MAAM,6BAA6B,WAAW,KAAK;AAAA,EACrD,EAAE,MAAM,oBAAoB,WAAW,KAAK;AAAA,EAC5C,EAAE,MAAM,wBAAwB,WAAW,KAAK;AAAA,EAChD,EAAE,MAAM,uBAAuB,WAAW,KAAK;AAAA,EAC/C,EAAE,MAAM,aAAa,WAAW,KAAK;AAAA,EACrC,EAAE,MAAM,YAAY,WAAW,KAAK;AAAA,EACpC,EAAE,MAAM,YAAY,WAAW,KAAK;AAAA,EACpC,EAAE,MAAM,eAAe,WAAW,KAAK;AAAA,EACvC,EAAE,MAAM,oBAAoB,WAAW,KAAK;AAAA,EAC5C,EAAE,MAAM,eAAe,WAAW,KAAK;AAAA,EACvC,EAAE,MAAM,iBAAiB,WAAW,KAAK;AAAA,EACzC,EAAE,MAAM,iBAAiB,WAAW,KAAK;AAAA,EACzC,EAAE,MAAM,cAAc,WAAW,KAAK;AACxC;AASO,IAAM,cAAyC;AAAA,EACpD,EAAE,QAAQ,QAAQ,UAAU,qBAAqB,WAAW,KAAK;AAAA,EACjE,EAAE,QAAQ,QAAQ,UAAU,6BAA6B,WAAW,KAAK;AAAA,EACzE,EAAE,QAAQ,QAAQ,UAAU,8BAA8B,WAAW,KAAK;AAAA,EAC1E,EAAE,QAAQ,QAAQ,UAAU,8BAA8B,WAAW,KAAK;AAAA,EAC1E,EAAE,QAAQ,OAAO,UAAU,oCAAoC,WAAW,KAAK;AAAA,EAC/E,EAAE,QAAQ,OAAO,UAAU,2CAA2C,WAAW,KAAK;AAAA,EACtF,EAAE,QAAQ,QAAQ,UAAU,oCAAoC,WAAW,KAAK;AAAA,EAChF,EAAE,QAAQ,QAAQ,UAAU,iCAAiC,WAAW,KAAK;AAAA,EAC7E,EAAE,QAAQ,QAAQ,UAAU,wCAAwC,WAAW,KAAK;AAAA,EACpF,EAAE,QAAQ,QAAQ,UAAU,8CAA8C,WAAW,KAAK;AAAA,EAC1F,EAAE,QAAQ,QAAQ,UAAU,iCAAiC,WAAW,KAAK;AAAA,EAC7E,EAAE,QAAQ,QAAQ,UAAU,6BAA6B,WAAW,KAAK;AAAA,EACzE,EAAE,QAAQ,QAAQ,UAAU,gCAAgC,WAAW,KAAK;AAAA,EAC5E,EAAE,QAAQ,OAAO,UAAU,kCAAkC,WAAW,KAAK;AAAA,EAC7E,EAAE,QAAQ,OAAO,UAAU,0BAA0B,WAAW,KAAK;AAAA,EACrE,EAAE,QAAQ,OAAO,UAAU,+BAA+B,WAAW,KAAK;AAAA,EAC1E,EAAE,QAAQ,QAAQ,UAAU,6BAA6B,WAAW,KAAK;AAAA,EACzE,EAAE,QAAQ,OAAO,UAAU,mCAAmC,WAAW,KAAK;AAAA,EAC9E,EAAE,QAAQ,OAAO,UAAU,2CAA2C,WAAW,KAAK;AAAA,EACtF,EAAE,QAAQ,OAAO,UAAU,iCAAiC,WAAW,KAAK;AAAA,EAC5E,EAAE,QAAQ,QAAQ,UAAU,sBAAsB,WAAW,KAAK;AAAA,EAClE,EAAE,QAAQ,QAAQ,UAAU,yBAAyB,WAAW,KAAK;AAAA,EACrE,EAAE,QAAQ,QAAQ,UAAU,mCAAmC,WAAW,KAAK;AAAA,EAC/E,EAAE,QAAQ,QAAQ,UAAU,oCAAoC,WAAW,KAAK;AAAA,EAChF,EAAE,QAAQ,OAAO,UAAU,yBAAyB,WAAW,KAAK;AAAA,EACpE,EAAE,QAAQ,QAAQ,UAAU,uBAAuB,WAAW,eAAe;AAAA,EAC7E,EAAE,QAAQ,QAAQ,UAAU,0BAA0B,WAAW,KAAK;AAAA,EACtE,EAAE,QAAQ,OAAO,UAAU,uBAAuB,WAAW,KAAK;AAAA,EAClE,EAAE,QAAQ,OAAO,UAAU,2BAA2B,WAAW,aAAa;AAAA,EAC9E,EAAE,QAAQ,OAAO,UAAU,oCAAoC,WAAW,KAAK;AAAA,EAC/E,EAAE,QAAQ,OAAO,UAAU,uBAAuB,WAAW,KAAK;AAAA,EAClE,EAAE,QAAQ,OAAO,UAAU,2BAA2B,WAAW,KAAK;AAAA,EACtE,EAAE,QAAQ,OAAO,UAAU,2BAA2B,WAAW,KAAK;AAAA,EACtE,EAAE,QAAQ,OAAO,UAAU,0BAA0B,WAAW,KAAK;AAAA,EACrE,EAAE,QAAQ,OAAO,UAAU,sBAAsB,WAAW,KAAK;AAAA,EACjE,EAAE,QAAQ,OAAO,UAAU,iCAAiC,WAAW,KAAK;AAAA,EAC5E,EAAE,QAAQ,OAAO,UAAU,+BAA+B,WAAW,KAAK;AAAA,EAC1E,EAAE,QAAQ,OAAO,UAAU,kCAAkC,WAAW,KAAK;AAAA,EAC7E,EAAE,QAAQ,QAAQ,UAAU,iCAAiC,WAAW,KAAK;AAAA,EAC7E,EAAE,QAAQ,QAAQ,UAAU,kCAAkC,WAAW,KAAK;AAAA,EAC9E,EAAE,QAAQ,QAAQ,UAAU,oCAAoC,WAAW,KAAK;AAAA,EAChF,EAAE,QAAQ,QAAQ,UAAU,0BAA0B,WAAW,KAAK;AAAA,EACtE,EAAE,QAAQ,OAAO,UAAU,oCAAoC,WAAW,KAAK;AAAA,EAC/E,EAAE,QAAQ,OAAO,UAAU,wCAAwC,WAAW,KAAK;AAAA,EACnF,EAAE,QAAQ,QAAQ,UAAU,6BAA6B,WAAW,KAAK;AAAA,EACzE,EAAE,QAAQ,OAAO,UAAU,6BAA6B,WAAW,KAAK;AAAA,EACxE,EAAE,QAAQ,QAAQ,UAAU,iCAAiC,WAAW,KAAK;AAAA,EAC7E,EAAE,QAAQ,OAAO,UAAU,2BAA2B,WAAW,KAAK;AAAA,EACtE,EAAE,QAAQ,OAAO,UAAU,4BAA4B,WAAW,KAAK;AAAA,EACvE,EAAE,QAAQ,OAAO,UAAU,oBAAoB,WAAW,KAAK;AAAA,EAC/D,EAAE,QAAQ,OAAO,UAAU,gCAAgC,WAAW,KAAK;AAAA,EAC3E,EAAE,QAAQ,OAAO,UAAU,wBAAwB,WAAW,KAAK;AAAA,EACnE,EAAE,QAAQ,OAAO,UAAU,wBAAwB,WAAW,KAAK;AAAA,EACnE,EAAE,QAAQ,UAAU,UAAU,wBAAwB,WAAW,KAAK;AAAA,EACtE,EAAE,QAAQ,OAAO,UAAU,4BAA4B,WAAW,KAAK;AAAA,EACvE,EAAE,QAAQ,QAAQ,UAAU,yBAAyB,WAAW,KAAK;AACvE;AAQO,SAAS,0BAAkC;AAChD,MAAI,QAAQ;AACZ,aAAW,SAAS,WAAW;AAC7B,QAAI,MAAM,cAAc,KAAM,UAAS;AAAA,EACzC;AACA,aAAW,SAAS,aAAa;AAC/B,QAAI,MAAM,cAAc,KAAM,UAAS;AAAA,EACzC;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/access-surface-catalog.ts"],"sourcesContent":["/**\n * Static inventory of every handler on the MCP and HTTP access surfaces, with\n * its migration status against the access boundary (issue #1525).\n *\n * The fitness test (`access-surface-catalog.test.ts`) walks this catalog,\n * checks each entry against the live registry, and counts unmigrated handlers.\n * The ratchet (`scripts/check-ratchets.mjs`) reads this file and counts\n * `operation: null` entries so the unmigrated count can only decrease.\n *\n * WHEN MIGRATING A HANDLER (follow-up PRs):\n *   1. Add the operation to `access-operations.ts` via `defineOperation`.\n *   2. Flip its entry here from `operation: null` to `operation: \"<name>\"`.\n *   3. Delete the surface-local validation the handler used to do.\n *   4. Run `node scripts/check-ratchets.mjs --update` to ratchet the count\n *      down — the improvement is recorded in `scripts/ratchet-baseline.json`.\n *\n * WHEN ADDING A NEW HANDLER:\n *   1. Add the entry here with `operation: null` (the fitness test will fail\n *      until you either migrate it or acknowledge it as unmigrated).\n *   2. Migrate it in the same PR if it carries user input — the boundary's\n *      whole point is that no new handler bypasses it.\n */\n\nimport type { OperationName } from \"./access-boundary.js\";\n\n/**\n * One row per MCP tool, keyed by the canonical SHORT name (no `engram.`/\n * `remnic.` prefix — both aliases dispatch to the same operation). The name\n * MUST match the tool's short suffix as advertised by `tools/list`.\n */\nexport interface McpToolEntry {\n  readonly tool: string;\n  readonly operation: OperationName | null;\n}\n\n/**\n * One row per HTTP route that invokes an access-service method. Routes that\n * only serve static assets, SSE streams, or admin console HTML are excluded —\n * they don't carry user-validated request envelopes into the facade.\n */\nexport interface HttpRouteEntry {\n  readonly method: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n  readonly pathname: string;\n  readonly operation: OperationName | null;\n}\n\n// Each tool below corresponds 1:1 to an `engram.*` definition in\n// `EngramMcpServer.tools` (access-mcp.ts). The fitness test asserts the live\n// `tools/list` response matches this list by short name, so a new tool cannot\n// land without either migrating it or acknowledging the unmigrated count.\nexport const MCP_TOOLS: readonly McpToolEntry[] = [\n  { tool: \"recall\", operation: null },\n  { tool: \"recall_explain\", operation: null },\n  { tool: \"set_coding_context\", operation: null },\n  { tool: \"recall_tier_explain\", operation: null },\n  { tool: \"recall_xray\", operation: null },\n  { tool: \"wearables_status\", operation: null },\n  { tool: \"wearables_sync\", operation: null },\n  { tool: \"transcript_day\", operation: null },\n  { tool: \"transcript_search\", operation: null },\n  { tool: \"transcript_memories\", operation: null },\n  { tool: \"action_confidence\", operation: null },\n  { tool: \"chatgpt_memory_inspector\", operation: null },\n  { tool: \"day_summary\", operation: null },\n  { tool: \"capsule_export\", operation: null },\n  { tool: \"capsule_import\", operation: null },\n  { tool: \"capsule_list\", operation: null },\n  { tool: \"memory_governance_run\", operation: null },\n  { tool: \"procedure_mining_run\", operation: null },\n  { tool: \"pattern_reinforcement_run\", operation: null },\n  { tool: \"procedural_stats\", operation: null },\n  { tool: \"memory_get\", operation: \"memory_get\" },\n  { tool: \"memory_timeline\", operation: null },\n  { tool: \"memory_store\", operation: \"memory_store\" },\n  { tool: \"coding_decision\", operation: \"coding_decision\" },\n  { tool: \"suggestion_submit\", operation: null },\n  { tool: \"entity_get\", operation: null },\n  { tool: \"review_queue_list\", operation: null },\n  { tool: \"observe\", operation: null },\n  { tool: \"lcm_search\", operation: null },\n  { tool: \"lcm_compaction_flush\", operation: null },\n  { tool: \"lcm_compaction_record\", operation: null },\n  { tool: \"continuity_audit_generate\", operation: null },\n  { tool: \"continuity_incident_open\", operation: null },\n  { tool: \"continuity_incident_close\", operation: null },\n  { tool: \"continuity_incident_list\", operation: null },\n  { tool: \"continuity_loop_add_or_update\", operation: null },\n  { tool: \"continuity_loop_review\", operation: null },\n  { tool: \"identity_anchor_get\", operation: null },\n  { tool: \"identity_anchor_update\", operation: null },\n  { tool: \"memory_identity\", operation: null },\n  { tool: \"work_task\", operation: null },\n  { tool: \"work_project\", operation: null },\n  { tool: \"work_board\", operation: null },\n  { tool: \"shared_context_write_output\", operation: null },\n  { tool: \"shared_feedback_record\", operation: null },\n  { tool: \"shared_priorities_append\", operation: null },\n  { tool: \"shared_context_cross_signals_run\", operation: null },\n  { tool: \"shared_context_curate_daily\", operation: null },\n  { tool: \"compounding_weekly_synthesize\", operation: null },\n  { tool: \"compounding_promote_candidate\", operation: null },\n  { tool: \"compression_guidelines_optimize\", operation: null },\n  { tool: \"compression_guidelines_activate\", operation: null },\n  { tool: \"memory_search\", operation: \"memory_search\" },\n  { tool: \"memory_profile\", operation: null },\n  { tool: \"memory_entities_list\", operation: null },\n  { tool: \"memory_questions\", operation: null },\n  { tool: \"memory_last_recall\", operation: null },\n  { tool: \"memory_intent_debug\", operation: null },\n  { tool: \"memory_qmd_debug\", operation: null },\n  { tool: \"memory_graph_explain\", operation: null },\n  { tool: \"graph_snapshot\", operation: null },\n  { tool: \"memory_feedback\", operation: null },\n  { tool: \"memory_promote\", operation: null },\n  { tool: \"memory_outcome\", operation: null },\n  { tool: \"memory_action_apply\", operation: null },\n  { tool: \"context_checkpoint\", operation: null },\n  { tool: \"briefing\", operation: null },\n  { tool: \"review_list\", operation: null },\n  { tool: \"review_resolve\", operation: null },\n  { tool: \"contradiction_scan_run\", operation: null },\n  { tool: \"memory_summarize_hourly\", operation: null },\n  { tool: \"conversation_index_update\", operation: null },\n  { tool: \"profiling_report\", operation: null },\n  { tool: \"graph_edge_decay_run\", operation: null },\n  { tool: \"live_connectors_run\", operation: null },\n  { tool: \"peer_list\", operation: null },\n  { tool: \"peer_get\", operation: null },\n  { tool: \"peer_set\", operation: null },\n  { tool: \"peer_delete\", operation: null },\n  { tool: \"peer_profile_get\", operation: null },\n  { tool: \"peer_forget\", operation: null },\n  { tool: \"console_state\", operation: null },\n  { tool: \"dreams_status\", operation: null },\n  { tool: \"dreams_run\", operation: null },\n];\n\n// Each route below corresponds 1:1 to a service-invoking route branch in\n// `EngramAccessHttpServer.handle` (access-http.ts). Pathname patterns use\n// `:param` for path segments. The fitness test asserts each entry resolves\n// against the catalog so a new service route cannot land without either\n// migrating it or acknowledging the unmigrated count. Infrastructure probes\n// (health, adapters, the /mcp delegate, admin console, SSE-only endpoints)\n// carry no user request envelope and are intentionally excluded.\nexport const HTTP_ROUTES: readonly HttpRouteEntry[] = [\n  { method: \"POST\", pathname: \"/engram/v1/recall\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/coding-context\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/capsules/export\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/capsules/import\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/offline-sync/snapshot\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/offline-sync/snapshot-stream\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/offline-sync/snapshot\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/offline-sync/files\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/offline-sync/file-content\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/offline-sync/apply-file-content\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/offline-sync/apply\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/recall/explain\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/action-confidence\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/recall/tier-explain\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/recall/xray\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/wearables/status\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/wearables/sync\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/wearables/transcript\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/wearables/transcripts/search\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/wearables/memories\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/observe\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/lcm/search\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/lcm/compaction/flush\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/lcm/compaction/record\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/lcm/status\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/memories\", operation: \"memory_store\" },\n  { method: \"POST\", pathname: \"/engram/v1/coding/decisions\", operation: \"coding_decision\" },\n  { method: \"POST\", pathname: \"/engram/v1/suggestions\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/memories\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/memories/:id\", operation: \"memory_get\" },\n  { method: \"GET\", pathname: \"/engram/v1/memories/:id/timeline\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/entities\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/entities/:id\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/review-queue\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/maintenance\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/quality\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/trust-zones/status\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/procedural/stats\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/trust-zones/records\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/review-disposition\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/trust-zones/promote\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/trust-zones/demo-seed\", operation: null },\n  { method: \"POST\", pathname: \"/v1/citations/observed\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/review/contradictions\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/review/contradictions/:id\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/review/resolve\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/graph/snapshot\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/contradiction-scan\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/graph/events\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/console/state\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/peers\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/peers/:id/profile\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/peers/:id\", operation: null },\n  { method: \"PUT\", pathname: \"/engram/v1/peers/:id\", operation: null },\n  { method: \"DELETE\", pathname: \"/engram/v1/peers/:id\", operation: null },\n  { method: \"GET\", pathname: \"/engram/v1/dreams/status\", operation: null },\n  { method: \"POST\", pathname: \"/engram/v1/dreams/run\", operation: null },\n];\n\n/**\n * Total unmigrated-handler count across both surfaces. The ratchet baseline\n * tracks this number; it may only decrease. `access-surface-catalog.test.ts`\n * recomputes it from the live catalog and asserts equality, so a catalog edit\n * without a baseline bump (or, ideally, a migration) fails the gate.\n */\nexport function countUnmigratedHandlers(): number {\n  let count = 0;\n  for (const entry of MCP_TOOLS) {\n    if (entry.operation === null) count += 1;\n  }\n  for (const entry of HTTP_ROUTES) {\n    if (entry.operation === null) count += 1;\n  }\n  return count;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-OFUULUSY.js → chunk-473JIN2U.js}

@@ -14,10 +14,10 @@ import {
 } from "./chunk-UDJLF3BO.js";
 import {
   getOperation
-} from "./chunk-PK6RGRSD.js";
+} from "./chunk-NN7QYW5W.js";
 import {
   EngramAccessInputError
-} from "./chunk-SQGPGC76.js";
+} from "./chunk-FUCUR2OZ.js";
 import {
   projectTagProjectId
 } from "./chunk-7MOTEVAA.js";
@@ -55,7 +55,8 @@ function withToolAliases(tool, emitLegacyTools = true) {
 var MCP_MIGRATED_OPERATIONS = {
   "engram.memory_get": "memory_get",
   "engram.memory_search": "memory_search",
-  "engram.memory_store": "memory_store"
+  "engram.memory_store": "memory_store",
+  "engram.coding_decision": "coding_decision"
 };
 function resolveChatGptInspectorRecallSessionKey(explicitSessionKey, authenticatedPrincipal) {
   if (explicitSessionKey) return explicitSessionKey;
@@ -194,6 +195,7 @@ var EngramMcpServer = class {
     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() || void 0;
     this.resources = [
       {
@@ -1768,6 +1770,46 @@ var EngramMcpServer = class {
         }
       }
     ].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];
+    }
   }
   service;
   buffer = Buffer.alloc(0);
@@ -1790,7 +1832,9 @@ var EngramMcpServer = class {
    * initialize with the same JSON-RPC id concurrently.
    */
   initSessionIds = /* @__PURE__ */ new Map();
-  /** Whether oai-mem-citation guidance is explicitly enabled via config. */
+  /**
+   * Whether oai-mem-citation guidance is explicitly enabled via config.
+   */
   citationsEnabled;
   /** Whether to auto-enable citations for Codex adapter connections. */
   citationsAutoDetect;
@@ -1800,6 +1844,13 @@ var EngramMcpServer = class {
    * set false to halve the advertised `tools/list` surface.
    */
   emitLegacyTools;
+  /**
+   * 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.
+   */
+  codingDecisionVisible;
   /** Get clientInfo for a specific MCP session. Returns undefined for non-MCP requests. */
   getClientInfo(sessionId) {
     if (sessionId) {
@@ -3103,4 +3154,4 @@ ${body}`;
 export {
   EngramMcpServer
 };
-//# sourceMappingURL=chunk-OFUULUSY.js.map
+//# sourceMappingURL=chunk-473JIN2U.js.map