@remnic/core 9.3.670 → 9.3.672

package/dist/summary-snapshot.d.ts

@@ -1,4 +1,4 @@
-import { a0 as HourlySummary } from './types-D96bCB3C.js';
+import { a0 as HourlySummary } from './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/temporal-supersession.d.ts

@@ -1,4 +1,4 @@
-import { j as MemoryFrontmatter } from './types-D96bCB3C.js';
+import { j as MemoryFrontmatter } from './types-D3pm4NhH.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 { j as MemoryFrontmatter } from './types-D96bCB3C.js';
+import { j as MemoryFrontmatter } from './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/threading.d.ts

@@ -1,4 +1,4 @@
-import { Z as BufferTurn, as as ConversationThread } from './types-D96bCB3C.js';
+import { Z as BufferTurn, as as ConversationThread } from './types-D3pm4NhH.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-D96bCB3C.js';
+import { g as MemoryFile } from './types-D3pm4NhH.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-D96bCB3C.js';
+import { g as MemoryFile } from './types-D3pm4NhH.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, T as TopicScore } from './types-D96bCB3C.js';
+import { g as MemoryFile, T as TopicScore } from './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/transcript.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig, _ as TranscriptEntry, $ as Checkpoint } from './types-D96bCB3C.js';
+import { P as PluginConfig, _ as TranscriptEntry, $ as Checkpoint } from './types-D3pm4NhH.js';
 import { SessionIntegrityReport } from './session-integrity.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.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;
@@ -815,13 +815,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;
@@ -854,13 +854,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-D96bCB3C.d.ts → types-D3pm4NhH.d.ts}

@@ -742,6 +742,34 @@ interface CodingModeConfig {
      */
     globalFallback: boolean;
 }
+interface CodingKnowledgeConfig {
+    /** Master gate. Off = byte-for-byte pre-feature behaviour on every path. */
+    enabled: boolean;
+    /** Decision-record surfaces + briefing titles (effective only under the master gate). */
+    decisionRecords: boolean;
+    /** Architecture-card build/refresh + briefing injection. */
+    architectureCard: boolean;
+    /** Last-seen-head persistence + delta briefing line. */
+    sessionDelta: boolean;
+    /** Opt-in LLM summary pass (costs tokens — default off, per rule 48). */
+    architectureCardLlmSummary: boolean;
+    /**
+     * Structural-context provider selection.
+     *  - `"none"` (default): no provider consulted — review-context runs
+     *    file-path-only boosting, identical to pre-feature behaviour.
+     *  - `"subprocess"`: shells out to `structuralProviderCommand` via
+     *    `execFile` (argv-array, never shell-string — rule 10).
+     *  - `"native"`: the `@remnic/coding-graph` engine, when installed.
+     */
+    structuralProvider: "none" | "subprocess" | "native";
+    /**
+     * Absolute path to the subprocess binary when `structuralProvider =
+     * "subprocess"`. Empty string = no command configured (consumer must
+     * reject the empty case at the wiring site). Rule 24: `statSync` file
+     * check at boot, not at every call.
+     */
+    structuralProviderCommand: string;
+}
 /**
  * Session-scoped coding context. Produced by `resolveGitContext()` in the
  * connector layer and attached to a session so that recall + write paths can
@@ -1207,6 +1235,7 @@ interface PluginConfig {
     /** Encrypt new writes when the secure-store is unlocked. Default true. */
     secureStoreEncryptOnWrite: boolean;
     codingMode: CodingModeConfig;
+    codingKnowledge: CodingKnowledgeConfig;
     heartbeat: HeartbeatConfig;
     slotBehavior: SlotBehaviorConfig;
     codexCompat: CodexCompatConfig;
@@ -3245,4 +3274,4 @@ interface HourlySummary {
     generatedAt: string;
 }
 
-export { type Checkpoint as $, type ActiveRecallChatType as A, type BehaviorSignalEvent as B, type CompressionGuidelineOptimizerState as C, type MemorySummary as D, type EntityStructuredSection as E, type FileHygieneConfig as F, type GatewayConfig as G, type RecallPlanMode as H, type ImportanceScore as I, type IdentityInjectionMode as J, type RecallDisclosure as K, type LiveConnectorsConfig as L, type MemoryCategory as M, type BriefingSections as N, type BriefingFollowup as O, type PluginConfig as P, type QmdSearchResult as Q, type RecallTierExplain as R, type BriefingFocus as S, type TopicScore as T, type CalendarSource as U, type CalendarEvent as V, type BriefingActiveThread as W, type BriefingResult as X, type BriefingRecentEntity as Y, type BufferTurn as Z, type TranscriptEntry as _, type ActiveRecallQueryMode as a, type WearableFetchOptions as a$, type HourlySummary as a0, type SessionObserverBandConfig as a1, type LifecycleState as a2, type VerificationState as a3, type PolicyClass as a4, type ImportanceLevel as a5, type SecretRef as a6, type AgentAccessAuthToken as a7, type CompressionGuidelineOptimizerEventCounts as a8, type CompressionGuidelineOptimizerActionSummary as a9, type WearableNativeMemory as aA, type WearableMemoryMode as aB, type WearableSourceConnector as aC, type WearablesConfig as aD, type WearableSyncSummary as aE, type WearableSourceStatus as aF, type WearableDayTranscript as aG, type WearableCorrectionRule as aH, type CodingContext as aI, type BootstrapOptions as aJ, type BootstrapResult as aK, type ConsolidationObservation as aL, type EntityTimelineEntry as aM, type CodingModeConfig as aN, type WearableCleanupSettings as aO, type WearableDayTranscriptMeta as aP, type BriefingConfig as aQ, type BriefingOpenCommitment as aR, type BriefingWindow as aS, type CodexCompatConfig as aT, DEFAULT_RECALL_DISCLOSURE as aU, type ExtractedFact as aV, type MemoryActionEligibilitySource as aW, type MemoryObservation as aX, type MemoryScope as aY, RECALL_DISCLOSURE_LEVELS as aZ, type WearableAuthCheck as a_, type CompressionGuidelineOptimizerRuleUpdate as aa, type MemoryActionType as ab, type EntityMention as ac, type EntitySchemaDefinition as ad, type EntitySchemaSectionDefinition as ae, type ExtractionResult as af, type ConsolidationResult as ag, type DaySummaryResult as ah, type MemoryIntent as ai, type QmdSearchExplain as aj, type MemoryActionEligibilityContext as ak, type MemoryActionPolicyResult as al, type MemoryLifecycleEventType as am, type MemoryLifecycleStateSummary as an, type ModelProviderConfig as ao, type NativeKnowledgeConfig as ap, type RetrievalTier as aq, type SignalScanResult as ar, type ConversationThread as as, type ScopeProfileLayerId as at, type ScopeProfilePromotionTarget as au, type DreamsStatusResult as av, type DreamsPhase as aw, type DreamsRunResult as ax, type WearableConversation as ay, type WearableSourceSettings as az, type ActiveRecallPromptStyle as b, type ProceduralConfig as b$, type WearableFetchPage as b0, type WearableNativeMemoryPage as b1, type WearableTranscriptSegment as b2, isRecallDisclosure as b3, type AgentAccessHttpConfig as b4, type AgentDefaultsConfig as b5, type AgentPersona as b6, type BehaviorLoopAdjustment as b7, type BehaviorSignalDirection as b8, type BehaviorSignalType as b9, type ExtractedQuestion as bA, type ExtractedReasoningTrace as bB, type ExtractedReasoningTraceStep as bC, type ExtractedRelationship as bD, type ExtractionPassSource as bE, type GitHubLiveConnectorConfig as bF, type GmailLiveConnectorConfig as bG, type GoogleDriveLiveConnectorConfig as bH, type HeartbeatConfig as bI, type HeartbeatDetectionMode as bJ, type LlmTraceCallback as bK, type LlmTraceEvent as bL, type MemoryActionOutcome as bM, type MemoryActionPolicyDecision as bN, type MemoryActionStatus as bO, type MemoryLinkType as bP, type MemoryOsPresetName as bQ, type ModelApi as bR, type ModelDefinitionConfig as bS, type ModelProviderAuthMode as bT, type NamespacePolicy as bU, type NativeKnowledgeFolderRuleConfig as bV, type NativeKnowledgeObsidianVaultConfig as bW, type NativeKnowledgeOpenClawWorkspaceConfig as bX, type NotionLiveConnectorConfig as bY, type PrincipalFromSessionKeyMode as bZ, type PrincipalRule as b_, type BriefingCalendarSourceError as ba, type BufferEntryState as bb, type CaptureMode as bc, type CodexCliReasoningEffort as bd, type CodexCompactionFlushMode as be, type CodexConnectorConfig as bf, type CompressionGuidelineActivationState as bg, type CompressionGuidelineOptimizerSourceWindow as bh, type ConfidenceTier as bi, type ConsolidationAction as bj, type ConsolidationItem as bk, type ContinuityIncidentState as bl, type ContinuityLoopCadence as bm, type ContinuityLoopStatus as bn, type ContradictionScanConfig as bo, type CronConversationRecallMode as bp, type CronRecallMode as bq, type DreamingConfig as br, type DreamingNarrativePromptStyle as bs, type DreamsDeepSleepConfig as bt, type DreamsLightSleepConfig as bu, type DreamsPhaseStatus as bv, type DreamsPhasesConfig as bw, type DreamsRemConfig as bx, type EngramTraceEvent as by, type ExtractedProcedureStep as bz, type ActiveRecallThinking as c, type QuestionEntry as c0, type ReasoningEffort as c1, type RecallPipelineConfig as c2, type RecallSectionConfig as c3, type RecallTraceEvent as c4, type RelevanceFeedback as c5, SPECULATIVE_TTL_DAYS as c6, type ScopeProfileAutoPromoteConfig as c7, type ScopeProfileConfig as c8, type ScopeProfileTeamProjectConfig as c9, type ScopeTeamConfig as ca, type ScoredEntity as cb, type SemanticChunkingConfigShape as cc, type SignalLevel as cd, type SlotBehaviorConfig as ce, type SlotMismatchMode as cf, type TriggerMode as cg, confidenceTier as ch, type ActiveRecallModelFallbackPolicy as d, type BehaviorLoopPolicyState as e, type AgentPersonaModelConfig as f, type MemoryFile as g, type MemoryStatus as h, type MemoryLink as i, type MemoryFrontmatter as j, type BufferState as k, type MetaState as l, type MemoryActionEvent as m, type MemoryLifecycleEvent as n, type BufferSurpriseEvent as o, type ContinuityIncidentOpenInput as p, type ContinuityIncidentRecord as q, type ContinuityIncidentCloseInput as r, type ContinuityImprovementLoop as s, type ContinuityLoopUpsertInput as t, type ContinuityLoopReviewInput as u, type EntityRelationship as v, type EntityActivityEntry as w, type EntityFile as x, type AccessTrackingEntry as y, type MemoryProjectionCurrentState as z };
+export { type Checkpoint as $, type ActiveRecallChatType as A, type BehaviorSignalEvent as B, type CompressionGuidelineOptimizerState as C, type MemorySummary as D, type EntityStructuredSection as E, type FileHygieneConfig as F, type GatewayConfig as G, type RecallPlanMode as H, type ImportanceScore as I, type IdentityInjectionMode as J, type RecallDisclosure as K, type LiveConnectorsConfig as L, type MemoryCategory as M, type BriefingSections as N, type BriefingFollowup as O, type PluginConfig as P, type QmdSearchResult as Q, type RecallTierExplain as R, type BriefingFocus as S, type TopicScore as T, type CalendarSource as U, type CalendarEvent as V, type BriefingActiveThread as W, type BriefingResult as X, type BriefingRecentEntity as Y, type BufferTurn as Z, type TranscriptEntry as _, type ActiveRecallQueryMode as a, type WearableFetchOptions as a$, type HourlySummary as a0, type SessionObserverBandConfig as a1, type LifecycleState as a2, type VerificationState as a3, type PolicyClass as a4, type ImportanceLevel as a5, type SecretRef as a6, type AgentAccessAuthToken as a7, type CompressionGuidelineOptimizerEventCounts as a8, type CompressionGuidelineOptimizerActionSummary as a9, type WearableNativeMemory as aA, type WearableMemoryMode as aB, type WearableSourceConnector as aC, type WearablesConfig as aD, type WearableSyncSummary as aE, type WearableSourceStatus as aF, type WearableDayTranscript as aG, type WearableCorrectionRule as aH, type CodingContext as aI, type BootstrapOptions as aJ, type BootstrapResult as aK, type ConsolidationObservation as aL, type EntityTimelineEntry as aM, type CodingModeConfig as aN, type WearableCleanupSettings as aO, type WearableDayTranscriptMeta as aP, type BriefingConfig as aQ, type BriefingOpenCommitment as aR, type BriefingWindow as aS, type CodexCompatConfig as aT, DEFAULT_RECALL_DISCLOSURE as aU, type ExtractedFact as aV, type MemoryActionEligibilitySource as aW, type MemoryObservation as aX, type MemoryScope as aY, RECALL_DISCLOSURE_LEVELS as aZ, type WearableAuthCheck as a_, type CompressionGuidelineOptimizerRuleUpdate as aa, type MemoryActionType as ab, type EntityMention as ac, type EntitySchemaDefinition as ad, type EntitySchemaSectionDefinition as ae, type ExtractionResult as af, type ConsolidationResult as ag, type DaySummaryResult as ah, type MemoryIntent as ai, type QmdSearchExplain as aj, type MemoryActionEligibilityContext as ak, type MemoryActionPolicyResult as al, type MemoryLifecycleEventType as am, type MemoryLifecycleStateSummary as an, type ModelProviderConfig as ao, type NativeKnowledgeConfig as ap, type RetrievalTier as aq, type SignalScanResult as ar, type ConversationThread as as, type ScopeProfileLayerId as at, type ScopeProfilePromotionTarget as au, type DreamsStatusResult as av, type DreamsPhase as aw, type DreamsRunResult as ax, type WearableConversation as ay, type WearableSourceSettings as az, type ActiveRecallPromptStyle as b, type PrincipalRule as b$, type WearableFetchPage as b0, type WearableNativeMemoryPage as b1, type WearableTranscriptSegment as b2, isRecallDisclosure as b3, type AgentAccessHttpConfig as b4, type AgentDefaultsConfig as b5, type AgentPersona as b6, type BehaviorLoopAdjustment as b7, type BehaviorSignalDirection as b8, type BehaviorSignalType as b9, type ExtractedProcedureStep as bA, type ExtractedQuestion as bB, type ExtractedReasoningTrace as bC, type ExtractedReasoningTraceStep as bD, type ExtractedRelationship as bE, type ExtractionPassSource as bF, type GitHubLiveConnectorConfig as bG, type GmailLiveConnectorConfig as bH, type GoogleDriveLiveConnectorConfig as bI, type HeartbeatConfig as bJ, type HeartbeatDetectionMode as bK, type LlmTraceCallback as bL, type LlmTraceEvent as bM, type MemoryActionOutcome as bN, type MemoryActionPolicyDecision as bO, type MemoryActionStatus as bP, type MemoryLinkType as bQ, type MemoryOsPresetName as bR, type ModelApi as bS, type ModelDefinitionConfig as bT, type ModelProviderAuthMode as bU, type NamespacePolicy as bV, type NativeKnowledgeFolderRuleConfig as bW, type NativeKnowledgeObsidianVaultConfig as bX, type NativeKnowledgeOpenClawWorkspaceConfig as bY, type NotionLiveConnectorConfig as bZ, type PrincipalFromSessionKeyMode as b_, type BriefingCalendarSourceError as ba, type BufferEntryState as bb, type CaptureMode as bc, type CodexCliReasoningEffort as bd, type CodexCompactionFlushMode as be, type CodexConnectorConfig as bf, type CodingKnowledgeConfig as bg, type CompressionGuidelineActivationState as bh, type CompressionGuidelineOptimizerSourceWindow as bi, type ConfidenceTier as bj, type ConsolidationAction as bk, type ConsolidationItem as bl, type ContinuityIncidentState as bm, type ContinuityLoopCadence as bn, type ContinuityLoopStatus as bo, type ContradictionScanConfig as bp, type CronConversationRecallMode as bq, type CronRecallMode as br, type DreamingConfig as bs, type DreamingNarrativePromptStyle as bt, type DreamsDeepSleepConfig as bu, type DreamsLightSleepConfig as bv, type DreamsPhaseStatus as bw, type DreamsPhasesConfig as bx, type DreamsRemConfig as by, type EngramTraceEvent as bz, type ActiveRecallThinking as c, type ProceduralConfig as c0, type QuestionEntry as c1, type ReasoningEffort as c2, type RecallPipelineConfig as c3, type RecallSectionConfig as c4, type RecallTraceEvent as c5, type RelevanceFeedback as c6, SPECULATIVE_TTL_DAYS as c7, type ScopeProfileAutoPromoteConfig as c8, type ScopeProfileConfig as c9, type ScopeProfileTeamProjectConfig as ca, type ScopeTeamConfig as cb, type ScoredEntity as cc, type SemanticChunkingConfigShape as cd, type SignalLevel as ce, type SlotBehaviorConfig as cf, type SlotMismatchMode as cg, type TriggerMode as ch, confidenceTier as ci, type ActiveRecallModelFallbackPolicy as d, type BehaviorLoopPolicyState as e, type AgentPersonaModelConfig as f, type MemoryFile as g, type MemoryStatus as h, type MemoryLink as i, type MemoryFrontmatter as j, type BufferState as k, type MetaState as l, type MemoryActionEvent as m, type MemoryLifecycleEvent as n, type BufferSurpriseEvent as o, type ContinuityIncidentOpenInput as p, type ContinuityIncidentRecord as q, type ContinuityIncidentCloseInput as r, type ContinuityImprovementLoop as s, type ContinuityLoopUpsertInput as t, type ContinuityLoopReviewInput as u, type EntityRelationship as v, type EntityActivityEntry as w, type EntityFile as x, type AccessTrackingEntry as y, type MemoryProjectionCurrentState as z };

package/dist/types.d.ts

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

package/dist/types.js

@@ -4,7 +4,7 @@ import {
   SPECULATIVE_TTL_DAYS,
   confidenceTier,
   isRecallDisclosure
-} from "./chunk-AZBV4RRY.js";
+} from "./chunk-FMSDA2D3.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-D96bCB3C.js';
+import './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 import './lifecycle.js';

package/dist/verified-recall.js

@@ -1,14 +1,14 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-2TCHDANJ.js";
+} from "./chunk-NXBXM7Q6.js";
 import "./chunk-HQ6NIBL6.js";
-import "./chunk-WKMCC4NQ.js";
+import "./chunk-EUM7CZFM.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
 import "./chunk-J6A3CX5N.js";
-import "./chunk-AZBV4RRY.js";
+import "./chunk-FMSDA2D3.js";
 import "./chunk-AWJ2FHCF.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-RULE4VG5.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.3.670",
+  "version": "9.3.672",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -441,6 +441,16 @@
       "remnic-source": "./src/codex-thread-key.ts",
       "import": "./dist/codex-thread-key.js"
     },
+    "./coding/optional-coding-graph": {
+      "types": "./dist/coding/optional-coding-graph.d.ts",
+      "remnic-source": "./src/coding/optional-coding-graph.ts",
+      "import": "./dist/coding/optional-coding-graph.js"
+    },
+    "./coding/optional-coding-graph.js": {
+      "types": "./dist/coding/optional-coding-graph.d.ts",
+      "remnic-source": "./src/coding/optional-coding-graph.ts",
+      "import": "./dist/coding/optional-coding-graph.js"
+    },
     "./commitment-ledger": {
       "types": "./dist/commitment-ledger.d.ts",
       "remnic-source": "./src/commitment-ledger.ts",
@@ -2905,6 +2915,14 @@
     "agent",
     "core"
   ],
+  "peerDependencies": {
+    "@remnic/coding-graph": "^9.3.672"
+  },
+  "peerDependenciesMeta": {
+    "@remnic/coding-graph": {
+      "optional": true
+    }
+  },
   "scripts": {
     "build": "node ./scripts/build-with-heap.mjs",
     "check-types": "tsc --noEmit",

package/src/coding/coding-graph-types.ts

@@ -0,0 +1,180 @@
+// Engine contract types for the optional @remnic/coding-graph package.
+//
+// These types are owned by @remnic/core so the base install compiles even
+// when @remnic/coding-graph is not present (it is an optional peer dep —
+// installed only on host machines that opt in to codebase-graph features).
+//
+// @remnic/coding-graph imports these types and implements them; it does
+// not redefine them. This breaks the type-source-direction cycle that
+// would otherwise require core to import coding-graph at compile time
+// (core's tsup DTS phase emits declarations against the package's
+// compiled output, which would fail when the optional package is not
+// installed in CI's base install).
+//
+// Dependency direction:
+//
+//     @remnic/core  ──── owns ───►  CodingGraphEngine (this file)
+//         ▲
+//         │ peer + devDep (workspace)
+//         │
+//     @remnic/coding-graph (implements against these types)
+//
+// Per #1551 PR1 — these are the full contract surface. PR2 fills the
+// extractors; PR3+ lands the walker, determinism, and grammarDir
+// behaviour behind the same `parseFile()` entry point.
+
+// ---------------------------------------------------------------------------
+// Version constant — surfaced through the engine instance so consumers can
+// advertise what they expect. Bumped in lockstep with the package version
+// during active development.
+// ---------------------------------------------------------------------------
+export const CODING_GRAPH_ENGINE_VERSION = "0.1.0-pr1" as const;
+
+// ---------------------------------------------------------------------------
+// Tier-1 language list — declared here so consumers can drive their own
+// tools against the engine without touching the optional package. Order is
+// stable; per-language configuration is the engine's concern.
+// ---------------------------------------------------------------------------
+export const TIER_1_LANGUAGES = [
+  "typescript",
+  "tsx",
+  "javascript",
+  "python",
+  "go",
+  "rust",
+  "java",
+  "c",
+  "cpp",
+  "csharp",
+  "ruby",
+  "php",
+  "kotlin",
+  "swift",
+  "bash",
+] as const;
+
+export type CodingGraphLanguage = (typeof TIER_1_LANGUAGES)[number];
+
+// ---------------------------------------------------------------------------
+// Tagged error code — the load-bearing signal for programmatic detection of
+// placeholder / install / load failure states. New codes must be added here
+// so consumers see them via TypeScript.
+// ---------------------------------------------------------------------------
+export type CodingGraphErrorCode =
+  | "not_implemented"
+  | "module_load_failed";
+
+// ---------------------------------------------------------------------------
+// Engine interface — the contract coding-graph implements against.
+// ---------------------------------------------------------------------------
+export interface CodingGraphEngine {
+  /** Engine version reported at construction time. */
+  readonly engineVersion: string;
+  /** Tier-1 languages this build supports (PR2 narrows by grammar availability). */
+  readonly supportedLanguages: readonly CodingGraphLanguage[];
+  /**
+   * Parse a single source file and emit its FileIR.
+   *
+   * PR1 throws `CodingGraphError("not_implemented", …)`. PR2 will return
+   * `ParseResult`; failure paths come back as
+   * `{ ok: false, code: "parse_failed", path, message }` (rule 44) rather
+   * than partial / silent IR.
+   */
+  parseFile(input: ParseFileInput): Promise<ParseResult>;
+  /** Engine lifecycle — release any cached parsers/grammars. */
+  dispose(): Promise<void>;
+}
+
+// ---------------------------------------------------------------------------
+// Parse input/output
+// ---------------------------------------------------------------------------
+export interface ParseFileInput {
+  /** Repository-relative path (forward slashes; no leading `./`). */
+  readonly path: string;
+  /** Raw file bytes; hashing happens inside the engine (rule 23). */
+  readonly content: Uint8Array;
+  /**
+   * Optional override. When omitted the engine sniffs the language from
+   * `path` extensions against its built-in tier-1 list (PR2).
+   */
+  readonly language?: CodingGraphLanguage;
+}
+
+export type ParseResult =
+  | { readonly ok: true; readonly ir: FileIR }
+  | {
+      readonly ok: false;
+      readonly code: "parse_failed";
+      readonly path: string;
+      readonly message: string;
+    };
+
+// ---------------------------------------------------------------------------
+// FileIR — the seam between the parser (optional package) and the graph
+// store (sibling issue #1552). Field types are the minimal viable set per
+// the issue's design section.
+// ---------------------------------------------------------------------------
+export interface FileIR {
+  readonly path: string;
+  readonly language: CodingGraphLanguage;
+  /** SHA-256 of the raw bytes; rule 23 — every consumer hashes the same form. */
+  readonly contentHash: string;
+  readonly symbols: readonly SymbolIR[];
+  readonly imports: readonly ImportIR[];
+  readonly exports: readonly ExportIR[];
+  readonly callSites: readonly CallSiteIR[];
+  readonly routes: readonly RouteIR[];
+}
+
+export interface SymbolIR {
+  readonly kind:
+    | "function"
+    | "class"
+    | "method"
+    | "interface"
+    | "enum"
+    | "type"
+    | "module";
+  readonly name: string;
+  readonly qualifiedName: string;
+  /** Half-open byte span `[startByte, endByte)`. Rule 35. */
+  readonly span: { readonly startByte: number; readonly endByte: number };
+  readonly parentQualifiedName?: string;
+}
+
+export interface ImportIR {
+  /** Raw module specifier as written in source. */
+  readonly module: string;
+  readonly importedNames: readonly string[];
+  readonly span: { readonly startByte: number; readonly endByte: number };
+}
+
+export interface ExportIR {
+  readonly name: string;
+  readonly span: { readonly startByte: number; readonly endByte: number };
+}
+
+export interface CallSiteIR {
+  readonly calleeNameCandidates: readonly string[];
+  readonly span: { readonly startByte: number; readonly endByte: number };
+}
+
+export interface RouteIR {
+  /** HTTP verb in upper-case, or framework-native verb (e.g. "ANY"). */
+  readonly verb: string;
+  readonly pathTemplate: string;
+  readonly handlerQualifiedName: string;
+  readonly span: { readonly startByte: number; readonly endByte: number };
+}
+
+// ---------------------------------------------------------------------------
+// Factory options
+// ---------------------------------------------------------------------------
+/**
+ * Reserved for PR2. Declared now so the public surface is stable; the
+ * options object is intentionally empty in PR1.
+ */
+export interface CreateCodingGraphEngineOptions {
+  /** Reserved for PR2: extra grammar directory supplied by the operator. */
+  readonly grammarDir?: never;
+}