@remnic/core 9.3.701 → 9.3.703

package/dist/storage.js

@@ -8,7 +8,7 @@ import {
   normalizeEntityName,
   parseEntityFile,
   serializeEntityFile
-} from "./chunk-SFMRLXIV.js";
+} from "./chunk-GFIARMA7.js";
 import "./chunk-3JJWNZTT.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
@@ -20,7 +20,7 @@ import {
 } from "./chunk-SVOZFLIQ.js";
 import "./chunk-LTJAMRGI.js";
 import "./chunk-J6A3CX5N.js";
-import "./chunk-IKNQAGBV.js";
+import "./chunk-IX3UQT4H.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-MB5RSUW6.js";
 import "./chunk-6KYMPV2O.js";
@@ -29,7 +29,6 @@ import "./chunk-42JKGUFJ.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-DM2T26WE.js";
-import "./chunk-FVQJYWH7.js";
 import "./chunk-FEB7W5JG.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-VF4XKTX3.js";
@@ -43,11 +42,13 @@ import "./chunk-J2HSAU72.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VS2IYZRU.js";
-import "./chunk-ZPQVJEVQ.js";
+import "./chunk-SK2CR6MW.js";
+import "./chunk-FVQJYWH7.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-NU3CSQ4H.js";
+import "./chunk-6MKAMLQL.js";
 import "./chunk-PZ5AY32C.js";
 export {
   ContentHashIndex,

package/dist/summarizer.d.ts

@@ -1,5 +1,5 @@
 import { ModelRegistry } from './model-registry.js';
-import { P as PluginConfig, G as GatewayConfig, T as TranscriptEntry, H as HourlySummary } from './types-PuiPZ9iE.js';
+import { P as PluginConfig, G as GatewayConfig, T as TranscriptEntry, H as HourlySummary } from './types-MWKPZnM0.js';
 import { TranscriptManager } from './transcript.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';

package/dist/summary-snapshot.d.ts

@@ -1,4 +1,4 @@
-import { H as HourlySummary } from './types-PuiPZ9iE.js';
+import { H as HourlySummary } from './types-MWKPZnM0.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/targeted-fact-recall.js

@@ -1,8 +1,9 @@
 import {
   buildTargetedFactRecallSection,
   shouldRecallTargetedFactEvidence
-} from "./chunk-R5DB26G6.js";
+} from "./chunk-4SBW47WK.js";
 import "./chunk-YVVQUAOO.js";
+import "./chunk-LUPVCGYK.js";
 import "./chunk-PYPOFEMK.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/temporal-supersession.d.ts

@@ -1,4 +1,4 @@
-import { k as MemoryFrontmatter } from './types-PuiPZ9iE.js';
+import { k as MemoryFrontmatter } from './types-MWKPZnM0.js';
 import { StorageManager } from './storage.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';

package/dist/temporal-validity.d.ts

@@ -1,4 +1,4 @@
-import { k as MemoryFrontmatter } from './types-PuiPZ9iE.js';
+import { k as MemoryFrontmatter } from './types-MWKPZnM0.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/threading.d.ts

@@ -1,4 +1,4 @@
-import { u as BufferTurn, am as ConversationThread } from './types-PuiPZ9iE.js';
+import { u as BufferTurn, am as ConversationThread } from './types-MWKPZnM0.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/tier-migration.d.ts

@@ -1,4 +1,4 @@
-import { g as MemoryFile } from './types-PuiPZ9iE.js';
+import { g as MemoryFile } from './types-MWKPZnM0.js';
 import { StorageManager } from './storage.js';
 import { MemoryTier } from './tier-routing.js';
 import { SearchBackend } from './search/port.js';

package/dist/tier-routing.d.ts

@@ -1,4 +1,4 @@
-import { g as MemoryFile } from './types-PuiPZ9iE.js';
+import { g as MemoryFile } from './types-MWKPZnM0.js';
 import { LifecycleSignals } from './lifecycle.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';

package/dist/topics.d.ts

@@ -1,4 +1,4 @@
-import { g as MemoryFile, an as TopicScore } from './types-PuiPZ9iE.js';
+import { g as MemoryFile, an as TopicScore } from './types-MWKPZnM0.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/transcript.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig, T as TranscriptEntry, v as Checkpoint } from './types-PuiPZ9iE.js';
+import { P as PluginConfig, T as TranscriptEntry, v as Checkpoint } from './types-MWKPZnM0.js';
 import { SessionIntegrityReport } from './session-integrity.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';

package/dist/transcript.js

@@ -1,9 +1,9 @@
 import {
   TranscriptManager,
   utcDayRange
-} from "./chunk-PONNZ54D.js";
-import "./chunk-S4DDLTPX.js";
+} from "./chunk-GY3SKOS4.js";
 import "./chunk-KFY3SGN7.js";
+import "./chunk-S4DDLTPX.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-NU3CSQ4H.js";
 import "./chunk-PZ5AY32C.js";

package/dist/transfer/types.d.ts

@@ -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;
@@ -819,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;
@@ -858,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;

package/dist/{types-PuiPZ9iE.d.ts → types-MWKPZnM0.d.ts}

@@ -2946,6 +2946,30 @@ interface ExtractedFact {
      * "no verified span" and skip gracefully.
      */
     sources?: ProvenanceSource[];
+    /**
+     * Coarse provenance strength tag (issue #1575 PR 2). Set by the extraction
+     * validator: "verified" when the quote was located in source turns,
+     * "unverified" when the quote survived but no offsets were recoverable.
+     * Absent when `provenance.enabled` is false or no quote was provided —
+     * readers treat absent as "none" (rule 34 spirit).
+     */
+    provenance?: "verified" | "unverified" | "none";
+    /**
+     * Transient LLM-provided supporting quote (issue #1575 PR 2). Consumed by
+     * the post-parse validator to build `sources`, then stripped before the
+     * fact reaches persistence. NEVER included in content-hash dedup (rule 23 /
+     * checklist §13). Absent on facts that have already passed the validator.
+     */
+    quote?: string;
+    /**
+     * Transient requireSpans signal (issue #1575 PR 2). Set by the provenance
+     * validator (`ProvenanceBuildResult.requireSpansPending`) when
+     * `provenance.requireSpans` is enabled and the quote could not be located
+     * in any source turn. Read by the persist path to route the fact to
+     * `pending_review` instead of `active`. Stripped before persistence —
+     * it never reaches frontmatter (chatgpt-codex-connector thread 4xB).
+     */
+    requireSpansPending?: boolean;
     promptedByQuestion?: string;
     /**
      * Whether this fact is project-scoped or globally applicable.
@@ -3455,4 +3479,4 @@ interface HourlySummary {
     generatedAt: string;
 }
 
-export { type EntityStructuredSection as $, type ActiveRecallChatType as A, type BehaviorSignalEvent as B, type CalendarSource as C, type SecretRef as D, type EntityFile as E, type FaithfulnessFrontmatter as F, type GatewayConfig as G, type HourlySummary as H, type IdentityInjectionMode as I, type AgentAccessAuthToken as J, type CompressionGuidelineOptimizerEventCounts as K, type LiveConnectorsConfig as L, type MemoryCategory as M, type CompressionGuidelineOptimizerActionSummary as N, type CompressionGuidelineOptimizerRuleUpdate as O, type PluginConfig as P, type QmdSearchResult as Q, type RecallTierExplain as R, type SessionObserverBandConfig as S, type TranscriptEntry as T, type MemoryActionType as U, type VerificationState as V, type MemoryActionEvent as W, type CompressionGuidelineOptimizerState as X, type EntityMention as Y, type EntitySchemaDefinition as Z, type EntitySchemaSectionDefinition as _, type ActiveRecallQueryMode as a, type MemoryScope as a$, type ExtractionResult as a0, type ConsolidationResult as a1, type DaySummaryResult as a2, type ContinuityIncidentRecord as a3, type ContinuityIncidentCloseInput as a4, type ContinuityIncidentOpenInput as a5, type ContinuityImprovementLoop as a6, type ContinuityLoopReviewInput as a7, type ContinuityLoopUpsertInput as a8, type ImportanceScore as a9, type DreamsRunResult as aA, type WearableConversation as aB, type WearableSourceSettings as aC, type WearableNativeMemory as aD, type WearableMemoryMode as aE, type WearableSourceConnector as aF, type WearablesConfig as aG, type WearableSyncSummary as aH, type WearableSourceStatus as aI, type WearableDayTranscript as aJ, type WearableCorrectionRule as aK, type CodingContext as aL, type BootstrapOptions as aM, type BootstrapResult as aN, type ConsolidationObservation as aO, type EntityTimelineEntry as aP, type CodingModeConfig as aQ, type WearableCleanupSettings as aR, type WearableDayTranscriptMeta as aS, type BriefingConfig as aT, type BriefingOpenCommitment as aU, type BriefingWindow as aV, type CodexCompatConfig as aW, DEFAULT_RECALL_DISCLOSURE as aX, type ExtractedFact as aY, type MemoryActionEligibilitySource as aZ, type MemoryObservation as a_, type MemoryIntent as aa, type QmdSearchExplain as ab, type MemoryActionEligibilityContext as ac, type MemoryActionPolicyResult as ad, type MemoryLifecycleEventType as ae, type MemoryLifecycleStateSummary as af, type ModelProviderConfig as ag, type NativeKnowledgeConfig as ah, type ProvenanceConfig as ai, type ProvenanceSource as aj, type RetrievalTier as ak, type SignalScanResult as al, type ConversationThread as am, type TopicScore as an, type MemoryLink as ao, type BufferState as ap, type MetaState as aq, type FileHygieneConfig as ar, type EntityRelationship as as, type EntityActivityEntry as at, type AccessTrackingEntry as au, type MemorySummary as av, type ScopeProfileLayerId as aw, type ScopeProfilePromotionTarget as ax, type DreamsStatusResult as ay, type DreamsPhase as az, type ActiveRecallPromptStyle as b, type NativeKnowledgeOpenClawWorkspaceConfig as b$, RECALL_DISCLOSURE_LEVELS as b0, type WearableAuthCheck as b1, type WearableFetchOptions as b2, type WearableFetchPage as b3, type WearableNativeMemoryPage as b4, type WearableTranscriptSegment as b5, isRecallDisclosure as b6, type AgentAccessHttpConfig as b7, type AgentDefaultsConfig as b8, type AgentPersona as b9, type DreamsPhasesConfig as bA, type DreamsRemConfig as bB, type EngramTraceEvent as bC, type ExtractedProcedureStep as bD, type ExtractedQuestion as bE, type ExtractedReasoningTrace as bF, type ExtractedReasoningTraceStep as bG, type ExtractedRelationship as bH, type ExtractionPassSource as bI, type GitHubLiveConnectorConfig as bJ, type GmailLiveConnectorConfig as bK, type GoogleDriveLiveConnectorConfig as bL, type HeartbeatConfig as bM, type HeartbeatDetectionMode as bN, type LlmTraceCallback as bO, type LlmTraceEvent as bP, type MemoryActionOutcome as bQ, type MemoryActionPolicyDecision as bR, type MemoryActionStatus as bS, type MemoryLinkType as bT, type MemoryOsPresetName as bU, type ModelApi as bV, type ModelDefinitionConfig as bW, type ModelProviderAuthMode as bX, type NamespacePolicy as bY, type NativeKnowledgeFolderRuleConfig as bZ, type NativeKnowledgeObsidianVaultConfig as b_, type BehaviorLoopAdjustment as ba, type BehaviorSignalDirection as bb, type BehaviorSignalType as bc, type BriefingCalendarSourceError as bd, type BufferEntryState as be, type CaptureMode as bf, type CodexCliReasoningEffort as bg, type CodexCompactionFlushMode as bh, type CodexConnectorConfig as bi, type CodingKnowledgeConfig as bj, type CompressionGuidelineActivationState as bk, type CompressionGuidelineOptimizerSourceWindow as bl, type ConfidenceTier as bm, type ConsolidationAction as bn, type ConsolidationItem as bo, type ContinuityIncidentState as bp, type ContinuityLoopCadence as bq, type ContinuityLoopStatus as br, type ContradictionScanConfig as bs, type CronConversationRecallMode as bt, type CronRecallMode as bu, type DreamingConfig as bv, type DreamingNarrativePromptStyle as bw, type DreamsDeepSleepConfig as bx, type DreamsLightSleepConfig as by, type DreamsPhaseStatus as bz, type ActiveRecallThinking as c, type NotionLiveConnectorConfig as c0, type PrincipalFromSessionKeyMode as c1, type PrincipalRule as c2, type ProceduralConfig as c3, type QuestionEntry as c4, type ReasoningEffort as c5, type RecallPipelineConfig as c6, type RecallSectionConfig as c7, type RecallTraceEvent as c8, type RelevanceFeedback as c9, SPECULATIVE_TTL_DAYS as ca, type ScopeProfileAutoPromoteConfig as cb, type ScopeProfileConfig as cc, type ScopeProfileTeamProjectConfig as cd, type ScopeTeamConfig as ce, type ScoredEntity as cf, type SemanticChunkingConfigShape as cg, type SignalLevel as ch, type SlotBehaviorConfig as ci, type SlotMismatchMode as cj, type TriggerMode as ck, confidenceTier as cl, type ActiveRecallModelFallbackPolicy as d, type BehaviorLoopPolicyState as e, type AgentPersonaModelConfig as f, type MemoryFile as g, type MemoryStatus as h, type RecallPlanMode as i, type RecallDisclosure as j, type MemoryFrontmatter as k, type MemoryProjectionCurrentState as l, type MemoryLifecycleEvent as m, type BriefingSections as n, type BriefingFollowup as o, type BriefingFocus as p, type CalendarEvent as q, type BriefingActiveThread as r, type BriefingResult as s, type BriefingRecentEntity as t, type BufferTurn as u, type Checkpoint as v, type LifecycleState as w, type PolicyClass as x, type ImportanceLevel as y, type BufferSurpriseEvent as z };
+export { type EntityStructuredSection as $, type ActiveRecallChatType as A, type BehaviorSignalEvent as B, type CalendarSource as C, type SecretRef as D, type EntityFile as E, type FaithfulnessFrontmatter as F, type GatewayConfig as G, type HourlySummary as H, type IdentityInjectionMode as I, type AgentAccessAuthToken as J, type CompressionGuidelineOptimizerEventCounts as K, type LiveConnectorsConfig as L, type MemoryCategory as M, type CompressionGuidelineOptimizerActionSummary as N, type CompressionGuidelineOptimizerRuleUpdate as O, type PluginConfig as P, type QmdSearchResult as Q, type RecallTierExplain as R, type SessionObserverBandConfig as S, type TranscriptEntry as T, type MemoryActionType as U, type VerificationState as V, type MemoryActionEvent as W, type CompressionGuidelineOptimizerState as X, type EntityMention as Y, type EntitySchemaDefinition as Z, type EntitySchemaSectionDefinition as _, type ActiveRecallQueryMode as a, type MemoryObservation as a$, type ExtractionResult as a0, type ConsolidationResult as a1, type DaySummaryResult as a2, type ContinuityIncidentRecord as a3, type ContinuityIncidentCloseInput as a4, type ContinuityIncidentOpenInput as a5, type ContinuityImprovementLoop as a6, type ContinuityLoopReviewInput as a7, type ContinuityLoopUpsertInput as a8, type ImportanceScore as a9, type WearableSourceConnector as aA, type WearablesConfig as aB, type WearableSyncSummary as aC, type WearableSourceStatus as aD, type WearableDayTranscript as aE, type WearableCorrectionRule as aF, type CodingContext as aG, type BootstrapOptions as aH, type BootstrapResult as aI, type ConsolidationObservation as aJ, type EntityTimelineEntry as aK, type ScopeProfileLayerId as aL, type ScopeProfilePromotionTarget as aM, type ScopeProfileConfig as aN, type DreamsStatusResult as aO, type DreamsPhase as aP, type DreamsRunResult as aQ, type CodingModeConfig as aR, type WearableCleanupSettings as aS, type WearableDayTranscriptMeta as aT, type BriefingConfig as aU, type BriefingOpenCommitment as aV, type BriefingWindow as aW, type CodexCompatConfig as aX, DEFAULT_RECALL_DISCLOSURE as aY, type ExtractedFact as aZ, type MemoryActionEligibilitySource as a_, type MemoryIntent as aa, type QmdSearchExplain as ab, type MemoryActionEligibilityContext as ac, type MemoryActionPolicyResult as ad, type MemoryLifecycleEventType as ae, type MemoryLifecycleStateSummary as af, type ModelProviderConfig as ag, type NativeKnowledgeConfig as ah, type ProvenanceSource as ai, type ProvenanceConfig as aj, type RetrievalTier as ak, type SignalScanResult as al, type ConversationThread as am, type TopicScore as an, type MemoryLink as ao, type BufferState as ap, type MetaState as aq, type FileHygieneConfig as ar, type EntityRelationship as as, type EntityActivityEntry as at, type AccessTrackingEntry as au, type MemorySummary as av, type WearableConversation as aw, type WearableSourceSettings as ax, type WearableNativeMemory as ay, type WearableMemoryMode as az, type ActiveRecallPromptStyle as b, type NativeKnowledgeObsidianVaultConfig as b$, type MemoryScope as b0, RECALL_DISCLOSURE_LEVELS as b1, type WearableAuthCheck as b2, type WearableFetchOptions as b3, type WearableFetchPage as b4, type WearableNativeMemoryPage as b5, type WearableTranscriptSegment as b6, isRecallDisclosure as b7, type AgentAccessHttpConfig as b8, type AgentDefaultsConfig as b9, type DreamsPhaseStatus as bA, type DreamsPhasesConfig as bB, type DreamsRemConfig as bC, type EngramTraceEvent as bD, type ExtractedProcedureStep as bE, type ExtractedQuestion as bF, type ExtractedReasoningTrace as bG, type ExtractedReasoningTraceStep as bH, type ExtractedRelationship as bI, type ExtractionPassSource as bJ, type GitHubLiveConnectorConfig as bK, type GmailLiveConnectorConfig as bL, type GoogleDriveLiveConnectorConfig as bM, type HeartbeatConfig as bN, type HeartbeatDetectionMode as bO, type LlmTraceCallback as bP, type LlmTraceEvent as bQ, type MemoryActionOutcome as bR, type MemoryActionPolicyDecision as bS, type MemoryActionStatus as bT, type MemoryLinkType as bU, type MemoryOsPresetName as bV, type ModelApi as bW, type ModelDefinitionConfig as bX, type ModelProviderAuthMode as bY, type NamespacePolicy as bZ, type NativeKnowledgeFolderRuleConfig as b_, type AgentPersona as ba, type BehaviorLoopAdjustment as bb, type BehaviorSignalDirection as bc, type BehaviorSignalType as bd, type BriefingCalendarSourceError as be, type BufferEntryState as bf, type CaptureMode as bg, type CodexCliReasoningEffort as bh, type CodexCompactionFlushMode as bi, type CodexConnectorConfig as bj, type CodingKnowledgeConfig as bk, type CompressionGuidelineActivationState as bl, type CompressionGuidelineOptimizerSourceWindow as bm, type ConfidenceTier as bn, type ConsolidationAction as bo, type ConsolidationItem as bp, type ContinuityIncidentState as bq, type ContinuityLoopCadence as br, type ContinuityLoopStatus as bs, type ContradictionScanConfig as bt, type CronConversationRecallMode as bu, type CronRecallMode as bv, type DreamingConfig as bw, type DreamingNarrativePromptStyle as bx, type DreamsDeepSleepConfig as by, type DreamsLightSleepConfig as bz, type ActiveRecallThinking as c, type NativeKnowledgeOpenClawWorkspaceConfig as c0, type NotionLiveConnectorConfig as c1, type PrincipalFromSessionKeyMode as c2, type PrincipalRule as c3, type ProceduralConfig as c4, type QuestionEntry as c5, type ReasoningEffort as c6, type RecallPipelineConfig as c7, type RecallSectionConfig as c8, type RecallTraceEvent as c9, type RelevanceFeedback as ca, SPECULATIVE_TTL_DAYS as cb, type ScopeProfileAutoPromoteConfig as cc, type ScopeProfileTeamProjectConfig as cd, type ScopeTeamConfig as ce, type ScoredEntity as cf, type SemanticChunkingConfigShape as cg, type SignalLevel as ch, type SlotBehaviorConfig as ci, type SlotMismatchMode as cj, type TriggerMode as ck, confidenceTier as cl, type ActiveRecallModelFallbackPolicy as d, type BehaviorLoopPolicyState as e, type AgentPersonaModelConfig as f, type MemoryFile as g, type MemoryStatus as h, type RecallPlanMode as i, type RecallDisclosure as j, type MemoryFrontmatter as k, type MemoryProjectionCurrentState as l, type MemoryLifecycleEvent as m, type BriefingSections as n, type BriefingFollowup as o, type BriefingFocus as p, type CalendarEvent as q, type BriefingActiveThread as r, type BriefingResult as s, type BriefingRecentEntity as t, type BufferTurn as u, type Checkpoint as v, type LifecycleState as w, type PolicyClass as x, type ImportanceLevel as y, type BufferSurpriseEvent as z };

package/dist/types.d.ts

@@ -1,3 +1,3 @@
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
-export { au as AccessTrackingEntry, A as ActiveRecallChatType, d as ActiveRecallModelFallbackPolicy, b as ActiveRecallPromptStyle, a as ActiveRecallQueryMode, c as ActiveRecallThinking, J as AgentAccessAuthToken, b7 as AgentAccessHttpConfig, b8 as AgentDefaultsConfig, b9 as AgentPersona, f as AgentPersonaModelConfig, ba as BehaviorLoopAdjustment, e as BehaviorLoopPolicyState, bb as BehaviorSignalDirection, B as BehaviorSignalEvent, bc as BehaviorSignalType, aM as BootstrapOptions, aN as BootstrapResult, r as BriefingActiveThread, bd as BriefingCalendarSourceError, aT as BriefingConfig, p as BriefingFocus, o as BriefingFollowup, aU as BriefingOpenCommitment, t as BriefingRecentEntity, s as BriefingResult, n as BriefingSections, aV as BriefingWindow, be as BufferEntryState, ap as BufferState, z as BufferSurpriseEvent, u as BufferTurn, q as CalendarEvent, C as CalendarSource, bf as CaptureMode, v as Checkpoint, bg as CodexCliReasoningEffort, bh as CodexCompactionFlushMode, aW as CodexCompatConfig, bi as CodexConnectorConfig, aL as CodingContext, bj as CodingKnowledgeConfig, aQ as CodingModeConfig, bk as CompressionGuidelineActivationState, N as CompressionGuidelineOptimizerActionSummary, K as CompressionGuidelineOptimizerEventCounts, O as CompressionGuidelineOptimizerRuleUpdate, bl as CompressionGuidelineOptimizerSourceWindow, X as CompressionGuidelineOptimizerState, bm as ConfidenceTier, bn as ConsolidationAction, bo as ConsolidationItem, aO as ConsolidationObservation, a1 as ConsolidationResult, a6 as ContinuityImprovementLoop, a4 as ContinuityIncidentCloseInput, a5 as ContinuityIncidentOpenInput, a3 as ContinuityIncidentRecord, bp as ContinuityIncidentState, bq as ContinuityLoopCadence, a7 as ContinuityLoopReviewInput, br as ContinuityLoopStatus, a8 as ContinuityLoopUpsertInput, bs as ContradictionScanConfig, am as ConversationThread, bt as CronConversationRecallMode, bu as CronRecallMode, aX as DEFAULT_RECALL_DISCLOSURE, a2 as DaySummaryResult, bv as DreamingConfig, bw as DreamingNarrativePromptStyle, bx as DreamsDeepSleepConfig, by as DreamsLightSleepConfig, az as DreamsPhase, bz as DreamsPhaseStatus, bA as DreamsPhasesConfig, bB as DreamsRemConfig, aA as DreamsRunResult, ay as DreamsStatusResult, bC as EngramTraceEvent, at as EntityActivityEntry, E as EntityFile, Y as EntityMention, as as EntityRelationship, Z as EntitySchemaDefinition, _ as EntitySchemaSectionDefinition, $ as EntityStructuredSection, aP as EntityTimelineEntry, aY as ExtractedFact, bD as ExtractedProcedureStep, bE as ExtractedQuestion, bF as ExtractedReasoningTrace, bG as ExtractedReasoningTraceStep, bH as ExtractedRelationship, bI as ExtractionPassSource, a0 as ExtractionResult, F as FaithfulnessFrontmatter, ar as FileHygieneConfig, G as GatewayConfig, bJ as GitHubLiveConnectorConfig, bK as GmailLiveConnectorConfig, bL as GoogleDriveLiveConnectorConfig, bM as HeartbeatConfig, bN as HeartbeatDetectionMode, H as HourlySummary, I as IdentityInjectionMode, y as ImportanceLevel, a9 as ImportanceScore, w as LifecycleState, L as LiveConnectorsConfig, bO as LlmTraceCallback, bP as LlmTraceEvent, ac as MemoryActionEligibilityContext, aZ as MemoryActionEligibilitySource, W as MemoryActionEvent, bQ as MemoryActionOutcome, bR as MemoryActionPolicyDecision, ad as MemoryActionPolicyResult, bS as MemoryActionStatus, U as MemoryActionType, M as MemoryCategory, g as MemoryFile, k as MemoryFrontmatter, aa as MemoryIntent, m as MemoryLifecycleEvent, ae as MemoryLifecycleEventType, af as MemoryLifecycleStateSummary, ao as MemoryLink, bT as MemoryLinkType, a_ as MemoryObservation, bU as MemoryOsPresetName, l as MemoryProjectionCurrentState, a$ as MemoryScope, h as MemoryStatus, av as MemorySummary, aq as MetaState, bV as ModelApi, bW as ModelDefinitionConfig, bX as ModelProviderAuthMode, ag as ModelProviderConfig, bY as NamespacePolicy, ah as NativeKnowledgeConfig, bZ as NativeKnowledgeFolderRuleConfig, b_ as NativeKnowledgeObsidianVaultConfig, b$ as NativeKnowledgeOpenClawWorkspaceConfig, c0 as NotionLiveConnectorConfig, P as PluginConfig, x as PolicyClass, c1 as PrincipalFromSessionKeyMode, c2 as PrincipalRule, c3 as ProceduralConfig, ai as ProvenanceConfig, aj as ProvenanceSource, ab as QmdSearchExplain, Q as QmdSearchResult, c4 as QuestionEntry, b0 as RECALL_DISCLOSURE_LEVELS, c5 as ReasoningEffort, j as RecallDisclosure, c6 as RecallPipelineConfig, i as RecallPlanMode, c7 as RecallSectionConfig, R as RecallTierExplain, c8 as RecallTraceEvent, c9 as RelevanceFeedback, ak as RetrievalTier, ca as SPECULATIVE_TTL_DAYS, cb as ScopeProfileAutoPromoteConfig, cc as ScopeProfileConfig, aw as ScopeProfileLayerId, ax as ScopeProfilePromotionTarget, cd as ScopeProfileTeamProjectConfig, ce as ScopeTeamConfig, cf as ScoredEntity, D as SecretRef, cg as SemanticChunkingConfigShape, S as SessionObserverBandConfig, ch as SignalLevel, al as SignalScanResult, ci as SlotBehaviorConfig, cj as SlotMismatchMode, an as TopicScore, T as TranscriptEntry, ck as TriggerMode, V as VerificationState, cl as confidenceTier, b6 as isRecallDisclosure } from './types-PuiPZ9iE.js';
+export { au as AccessTrackingEntry, A as ActiveRecallChatType, d as ActiveRecallModelFallbackPolicy, b as ActiveRecallPromptStyle, a as ActiveRecallQueryMode, c as ActiveRecallThinking, J as AgentAccessAuthToken, b8 as AgentAccessHttpConfig, b9 as AgentDefaultsConfig, ba as AgentPersona, f as AgentPersonaModelConfig, bb as BehaviorLoopAdjustment, e as BehaviorLoopPolicyState, bc as BehaviorSignalDirection, B as BehaviorSignalEvent, bd as BehaviorSignalType, aH as BootstrapOptions, aI as BootstrapResult, r as BriefingActiveThread, be as BriefingCalendarSourceError, aU as BriefingConfig, p as BriefingFocus, o as BriefingFollowup, aV as BriefingOpenCommitment, t as BriefingRecentEntity, s as BriefingResult, n as BriefingSections, aW as BriefingWindow, bf as BufferEntryState, ap as BufferState, z as BufferSurpriseEvent, u as BufferTurn, q as CalendarEvent, C as CalendarSource, bg as CaptureMode, v as Checkpoint, bh as CodexCliReasoningEffort, bi as CodexCompactionFlushMode, aX as CodexCompatConfig, bj as CodexConnectorConfig, aG as CodingContext, bk as CodingKnowledgeConfig, aR as CodingModeConfig, bl as CompressionGuidelineActivationState, N as CompressionGuidelineOptimizerActionSummary, K as CompressionGuidelineOptimizerEventCounts, O as CompressionGuidelineOptimizerRuleUpdate, bm as CompressionGuidelineOptimizerSourceWindow, X as CompressionGuidelineOptimizerState, bn as ConfidenceTier, bo as ConsolidationAction, bp as ConsolidationItem, aJ as ConsolidationObservation, a1 as ConsolidationResult, a6 as ContinuityImprovementLoop, a4 as ContinuityIncidentCloseInput, a5 as ContinuityIncidentOpenInput, a3 as ContinuityIncidentRecord, bq as ContinuityIncidentState, br as ContinuityLoopCadence, a7 as ContinuityLoopReviewInput, bs as ContinuityLoopStatus, a8 as ContinuityLoopUpsertInput, bt as ContradictionScanConfig, am as ConversationThread, bu as CronConversationRecallMode, bv as CronRecallMode, aY as DEFAULT_RECALL_DISCLOSURE, a2 as DaySummaryResult, bw as DreamingConfig, bx as DreamingNarrativePromptStyle, by as DreamsDeepSleepConfig, bz as DreamsLightSleepConfig, aP as DreamsPhase, bA as DreamsPhaseStatus, bB as DreamsPhasesConfig, bC as DreamsRemConfig, aQ as DreamsRunResult, aO as DreamsStatusResult, bD as EngramTraceEvent, at as EntityActivityEntry, E as EntityFile, Y as EntityMention, as as EntityRelationship, Z as EntitySchemaDefinition, _ as EntitySchemaSectionDefinition, $ as EntityStructuredSection, aK as EntityTimelineEntry, aZ as ExtractedFact, bE as ExtractedProcedureStep, bF as ExtractedQuestion, bG as ExtractedReasoningTrace, bH as ExtractedReasoningTraceStep, bI as ExtractedRelationship, bJ as ExtractionPassSource, a0 as ExtractionResult, F as FaithfulnessFrontmatter, ar as FileHygieneConfig, G as GatewayConfig, bK as GitHubLiveConnectorConfig, bL as GmailLiveConnectorConfig, bM as GoogleDriveLiveConnectorConfig, bN as HeartbeatConfig, bO as HeartbeatDetectionMode, H as HourlySummary, I as IdentityInjectionMode, y as ImportanceLevel, a9 as ImportanceScore, w as LifecycleState, L as LiveConnectorsConfig, bP as LlmTraceCallback, bQ as LlmTraceEvent, ac as MemoryActionEligibilityContext, a_ as MemoryActionEligibilitySource, W as MemoryActionEvent, bR as MemoryActionOutcome, bS as MemoryActionPolicyDecision, ad as MemoryActionPolicyResult, bT as MemoryActionStatus, U as MemoryActionType, M as MemoryCategory, g as MemoryFile, k as MemoryFrontmatter, aa as MemoryIntent, m as MemoryLifecycleEvent, ae as MemoryLifecycleEventType, af as MemoryLifecycleStateSummary, ao as MemoryLink, bU as MemoryLinkType, a$ as MemoryObservation, bV as MemoryOsPresetName, l as MemoryProjectionCurrentState, b0 as MemoryScope, h as MemoryStatus, av as MemorySummary, aq as MetaState, bW as ModelApi, bX as ModelDefinitionConfig, bY as ModelProviderAuthMode, ag as ModelProviderConfig, bZ as NamespacePolicy, ah as NativeKnowledgeConfig, b_ as NativeKnowledgeFolderRuleConfig, b$ as NativeKnowledgeObsidianVaultConfig, c0 as NativeKnowledgeOpenClawWorkspaceConfig, c1 as NotionLiveConnectorConfig, P as PluginConfig, x as PolicyClass, c2 as PrincipalFromSessionKeyMode, c3 as PrincipalRule, c4 as ProceduralConfig, aj as ProvenanceConfig, ai as ProvenanceSource, ab as QmdSearchExplain, Q as QmdSearchResult, c5 as QuestionEntry, b1 as RECALL_DISCLOSURE_LEVELS, c6 as ReasoningEffort, j as RecallDisclosure, c7 as RecallPipelineConfig, i as RecallPlanMode, c8 as RecallSectionConfig, R as RecallTierExplain, c9 as RecallTraceEvent, ca as RelevanceFeedback, ak as RetrievalTier, cb as SPECULATIVE_TTL_DAYS, cc as ScopeProfileAutoPromoteConfig, aN as ScopeProfileConfig, aL as ScopeProfileLayerId, aM as ScopeProfilePromotionTarget, cd as ScopeProfileTeamProjectConfig, ce as ScopeTeamConfig, cf as ScoredEntity, D as SecretRef, cg as SemanticChunkingConfigShape, S as SessionObserverBandConfig, ch as SignalLevel, al as SignalScanResult, ci as SlotBehaviorConfig, cj as SlotMismatchMode, an as TopicScore, T as TranscriptEntry, ck as TriggerMode, V as VerificationState, cl as confidenceTier, b7 as isRecallDisclosure } from './types-MWKPZnM0.js';

package/dist/types.js

@@ -4,7 +4,7 @@ import {
   SPECULATIVE_TTL_DAYS,
   confidenceTier,
   isRecallDisclosure
-} from "./chunk-IKNQAGBV.js";
+} from "./chunk-IX3UQT4H.js";
 import "./chunk-PZ5AY32C.js";
 export {
   DEFAULT_RECALL_DISCLOSURE,

package/dist/utility-runtime.d.ts

@@ -1,5 +1,5 @@
 import { TierRoutingPolicy } from './tier-routing.js';
-import './types-PuiPZ9iE.js';
+import './types-MWKPZnM0.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 import './lifecycle.js';

package/dist/verified-recall.js

@@ -1,9 +1,9 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-XTIRCSIH.js";
+} from "./chunk-MXEWQKM7.js";
 import "./chunk-7FL4CNPV.js";
-import "./chunk-SFMRLXIV.js";
+import "./chunk-GFIARMA7.js";
 import "./chunk-3JJWNZTT.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
@@ -13,7 +13,7 @@ import "./chunk-IREVVFTM.js";
 import "./chunk-SVOZFLIQ.js";
 import "./chunk-LTJAMRGI.js";
 import "./chunk-J6A3CX5N.js";
-import "./chunk-IKNQAGBV.js";
+import "./chunk-IX3UQT4H.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-MB5RSUW6.js";
 import "./chunk-6KYMPV2O.js";
@@ -22,7 +22,6 @@ import "./chunk-42JKGUFJ.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-DM2T26WE.js";
-import "./chunk-FVQJYWH7.js";
 import "./chunk-FEB7W5JG.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-VF4XKTX3.js";
@@ -36,11 +35,13 @@ import "./chunk-J2HSAU72.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VS2IYZRU.js";
-import "./chunk-ZPQVJEVQ.js";
+import "./chunk-SK2CR6MW.js";
+import "./chunk-FVQJYWH7.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-NU3CSQ4H.js";
+import "./chunk-6MKAMLQL.js";
 import "./chunk-ZBJMUXZH.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/package.json

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

package/src/access-http.ts

@@ -2114,6 +2114,168 @@ export class EngramAccessHttpServer {
       return;
     }
 
+    // ── Admin console surfaces (issue #1502) ──────────────────────────────
+    //
+    // All five routes live under /engram/v1/admin/* which the access-surface
+    // catalog treats as infrastructure (no boundary migration required; the
+    // static-completeness fitness test excludes this prefix). They still
+    // require bearer auth (enforced above) and delegate to core APIs via the
+    // pure admin-surfaces module — the dashboard never re-resolves scope or
+    // re-lists namespaces.
+    if (pathname.startsWith("/engram/v1/admin/scope/inspect")) {
+      if (req.method !== "GET" && req.method !== "POST") {
+        this.respondJson(res, 405, { error: "method_not_allowed", code: "method_not_allowed" });
+        return;
+      }
+      const principal = this.resolveRequestPrincipal(req);
+      let sessionKey: string | undefined;
+      let namespaceOverride: string | undefined;
+      let operation: string | undefined;
+      if (req.method === "GET") {
+        sessionKey = parsed.searchParams.get("session") ?? undefined;
+        namespaceOverride = parsed.searchParams.get("namespace") ?? undefined;
+        operation = parsed.searchParams.get("operation") ?? undefined;
+      } else {
+        const body = await this.readJsonBody(req) as Record<string, unknown>;
+        sessionKey = typeof body.sessionKey === "string" ? body.sessionKey : undefined;
+        namespaceOverride = typeof body.namespace === "string" ? body.namespace : undefined;
+        operation = typeof body.operation === "string" ? body.operation : undefined;
+      }
+      const inspection = await this.service.adminInspectScope({
+        sessionKey: sessionKey && sessionKey.length > 0 ? sessionKey : undefined,
+        namespace: namespaceOverride && namespaceOverride.length > 0 ? namespaceOverride : undefined,
+        principalOverride: principal,
+        operation: operation as "recall" | "observe" | "memory_store" | "maintenance" | "dashboard" | undefined,
+      });
+      this.respondJson(res, 200, inspection);
+      return;
+    }
+
+    if (pathname === "/engram/v1/admin/namespaces") {
+      if (req.method !== "GET") {
+        this.respondJson(res, 405, { error: "method_not_allowed", code: "method_not_allowed" });
+        return;
+      }
+      const kind = parsed.searchParams.get("kind");
+      const principal = parsed.searchParams.get("principal");
+      const projectId = parsed.searchParams.get("projectId");
+      const discoveredBy = parsed.searchParams.get("discoveredBy");
+      const result = await this.service.adminListNamespaces({
+        ...(kind ? { kind: kind as "default" | "self" | "shared" | "project" | "branch" | "team-project" | "explicit" | "legacy" } : {}),
+        ...(principal && principal.length > 0 ? { principal } : {}),
+        ...(projectId && projectId.length > 0 ? { projectId } : {}),
+        ...(discoveredBy
+          ? { discoveredBy: discoveredBy as "config" | "write" | "read" | "scan" | "migration" }
+          : {}),
+      });
+      this.respondJson(res, 200, result);
+      return;
+    }
+
+    if (pathname === "/engram/v1/admin/maintenance-health") {
+      if (req.method !== "GET") {
+        this.respondJson(res, 405, { error: "method_not_allowed", code: "method_not_allowed" });
+        return;
+      }
+      const report = await this.service.adminMaintenanceHealth();
+      this.respondJson(res, 200, report);
+      return;
+    }
+
+    if (pathname === "/engram/v1/admin/transcript-audit") {
+      if (req.method !== "GET") {
+        this.respondJson(res, 405, { error: "method_not_allowed", code: "method_not_allowed" });
+        return;
+      }
+      const report = await this.service.adminTranscriptAudit();
+      this.respondJson(res, 200, report);
+      return;
+    }
+
+    if (pathname === "/engram/v1/admin/promote") {
+      if (req.method !== "POST") {
+        this.respondJson(res, 405, { error: "method_not_allowed", code: "method_not_allowed" });
+        return;
+      }
+      const body = await this.readJsonBody(req) as Record<string, unknown>;
+      if (typeof body.sourceMemoryId !== "string" || body.sourceMemoryId.trim().length === 0) {
+        this.respondJson(res, 400, {
+          error: "invalid_request",
+          code: "invalid_request",
+          message: "sourceMemoryId is required",
+        });
+        return;
+      }
+      if (typeof body.reason !== "string" || body.reason.trim().length === 0) {
+        this.respondJson(res, 400, {
+          error: "invalid_request",
+          code: "invalid_request",
+          message: "reason is required for promotion",
+        });
+        return;
+      }
+      if (!Array.isArray(body.targets) || body.targets.length === 0) {
+        this.respondJson(res, 400, {
+          error: "invalid_request",
+          code: "invalid_request",
+          message: "targets must be a non-empty array",
+        });
+        return;
+      }
+      const VALID_TARGETS = ["teamProject", "serverShared", "userProject", "userGlobal", "explicit"];
+      const targets = [];
+      for (const entry of body.targets) {
+        if (typeof entry !== "object" || entry === null || typeof entry.kind !== "string") {
+          this.respondJson(res, 400, {
+            error: "invalid_request",
+            code: "invalid_request",
+            message: "each target must be an object with a 'kind' string",
+          });
+          return;
+        }
+        if (!VALID_TARGETS.includes(entry.kind)) {
+          this.respondJson(res, 400, {
+            error: "invalid_request",
+            code: "invalid_request",
+            message: `target.kind must be one of: ${VALID_TARGETS.join(", ")}`,
+          });
+          return;
+        }
+        targets.push({
+          kind: entry.kind as "teamProject" | "serverShared" | "userProject" | "userGlobal" | "explicit",
+          namespace: typeof entry.namespace === "string" ? entry.namespace : undefined,
+        });
+      }
+      try {
+        // Rate-limit the promotion write, matching every other write route
+        // (observe, trust-zone promotion, etc.). The check throws on limit
+        // exceeded; the hit is recorded after the write succeeds.
+        this.ensureWriteRateLimitAvailable();
+        const result = await this.service.adminPromoteMemory({
+          sourceMemoryId: body.sourceMemoryId,
+          namespace: typeof body.namespace === "string" ? body.namespace : undefined,
+          principal: this.resolveRequestPrincipal(req),
+          sessionKey: typeof body.sessionKey === "string" ? body.sessionKey : undefined,
+          targets,
+          reason: body.reason,
+        });
+        // actor is derived from the authenticated principal inside adminPromoteMemory;
+        this.recordWriteRateLimitHit();
+        this.respondJson(res, 200, result);
+      } catch (err) {
+        if (err instanceof EngramAccessInputError) {
+          this.respondJson(res, 400, {
+            error: "invalid_request",
+            code: "invalid_request",
+            message: err.message,
+          });
+          return;
+        }
+        throw err;
+      }
+      return;
+    }
+
     this.respondJson(res, 404, { error: "not_found", code: "not_found" });
   }