@remnic/core 9.3.693 → 9.3.695

package/dist/{types-2NoBoRBM.d.ts → types-CeZYSC-E.d.ts}

@@ -791,6 +791,20 @@ interface CodingKnowledgeConfig {
      * check at boot, not at every call.
      */
     structuralProviderCommand: string;
+    /**
+     * Gate for the 14 codegraph parity tools (issue #1554). Off by default --
+     * tools/list, HTTP routes, and CLI help are byte-identical to pre-feature
+     * until this is true. The runtime also requires the @remnic/coding-graph
+     * package to be installed (rule 39: single gate predicate
+     * codegraphSurfaceVisible(config) && isCodingGraphInstalled()).
+     */
+    codegraphTools: boolean;
+    /**
+     * Root directory for per-project graph SQLite DBs. Empty string = derive
+     * from memoryDir (<memoryDir>/codegraph/<principal>/<projectId>.sqlite).
+     * Absolute path required when set explicitly (rule 11 -- no relative paths).
+     */
+    codegraphDbDir: string;
 }
 /**
  * Session-scoped coding context. Produced by `resolveGitContext()` in the
@@ -1331,6 +1345,14 @@ interface PluginConfig {
      * location.
      */
     judgeTrainingDir: string;
+    /** Gate mode: "off" (default, byte-identical pre-feature), "shadow" (record only), "enforce" (route to pending_review). */
+    extractionFaithfulnessGate: "off" | "shadow" | "enforce";
+    /** Override model/endpoint; empty string = default routing chain. */
+    extractionFaithfulnessModel: string;
+    /** Context window (chars) around the quote sent to the verifier. Default 400. */
+    extractionFaithfulnessContextChars: number;
+    /** Per-batch timeout in ms; timeout → tagged error, never blocks writes. Default 8000. */
+    extractionFaithfulnessTimeoutMs: number;
     hourlySummariesEnabled: boolean;
     daySummaryEnabled: boolean;
     /** Timezone override for the day summary cron (issue #1475). */
@@ -2720,6 +2742,26 @@ interface MemoryFrontmatter {
      * recorded). Readers treat absent as `"none"` for legacy memories.
      */
     provenance?: "verified" | "unverified" | "none";
+    /** Entailment verdict from the faithfulness gate (issue #1576). */
+    faithfulness?: FaithfulnessFrontmatter;
+}
+/**
+ * Faithfulness gate frontmatter (issue #1576).
+ *
+ * Serialized as a single JSON line so it round-trips through the existing
+ * YAML parser. `verdict: "unchecked"` marks a fact that entered the gate but
+ * could not be evaluated (backend failure, timeout). `verdict:
+ * "skipped_no_span"` marks a legacy fact without a verified source span.
+ * Both are distinct from the field being absent (gate was off entirely).
+ */
+interface FaithfulnessFrontmatter {
+    verdict: "entailed" | "contradicted" | "unsupported" | "unchecked" | "skipped_no_span";
+    /** Model/endpoint that produced the verdict, when known. */
+    model?: string;
+    /** One-sentence rationale from the verifier. */
+    rationale?: string;
+    /** ISO-8601 timestamp the check ran. */
+    at?: string;
 }
 /** Memory link relationship types */
 type MemoryLinkType = "follows" | "references" | "contradicts" | "supports" | "related";
@@ -2863,6 +2905,14 @@ interface ExtractedFact {
     tags: string[];
     entityRef?: string;
     source?: ExtractionPassSource;
+    /**
+     * Claim-level provenance spans backing this fact (issue #1575).
+     * Populated by the PR 2 extraction validator when `provenance.enabled`
+     * is true. Absent for legacy extractions — downstream consumers (the
+     * faithfulness gate #1576, TrustScore #1577) MUST treat absent as
+     * "no verified span" and skip gracefully.
+     */
+    sources?: ProvenanceSource[];
     promptedByQuestion?: string;
     /**
      * Whether this fact is project-scoped or globally applicable.
@@ -3372,4 +3422,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, RECALL_DISCLOSURE_LEVELS 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 WearableConversation as aA, type WearableSourceSettings as aB, type WearableNativeMemory as aC, type WearableMemoryMode as aD, type WearableSourceConnector as aE, type WearablesConfig as aF, type WearableSyncSummary as aG, type WearableSourceStatus as aH, type WearableDayTranscript as aI, type WearableCorrectionRule as aJ, type CodingContext as aK, type BootstrapOptions as aL, type BootstrapResult as aM, type ConsolidationObservation as aN, type EntityTimelineEntry as aO, type CodingModeConfig as aP, type WearableCleanupSettings as aQ, type WearableDayTranscriptMeta as aR, type BriefingConfig as aS, type BriefingOpenCommitment as aT, type BriefingWindow as aU, type CodexCompatConfig as aV, DEFAULT_RECALL_DISCLOSURE as aW, type ExtractedFact as aX, type MemoryActionEligibilitySource as aY, type MemoryObservation as aZ, type MemoryScope 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 ProvenanceConfig as aq, type ProvenanceSource as ar, type RetrievalTier as as, type SignalScanResult as at, type ConversationThread as au, type ScopeProfileLayerId as av, type ScopeProfilePromotionTarget as aw, type DreamsStatusResult as ax, type DreamsPhase as ay, type DreamsRunResult as az, type ActiveRecallPromptStyle as b, type NotionLiveConnectorConfig as b$, type WearableAuthCheck as b0, type WearableFetchOptions as b1, type WearableFetchPage as b2, type WearableNativeMemoryPage as b3, type WearableTranscriptSegment as b4, isRecallDisclosure as b5, type AgentAccessHttpConfig as b6, type AgentDefaultsConfig as b7, type AgentPersona as b8, type BehaviorLoopAdjustment as b9, type DreamsRemConfig as bA, type EngramTraceEvent as bB, type ExtractedProcedureStep as bC, type ExtractedQuestion as bD, type ExtractedReasoningTrace as bE, type ExtractedReasoningTraceStep as bF, type ExtractedRelationship as bG, type ExtractionPassSource as bH, type GitHubLiveConnectorConfig as bI, type GmailLiveConnectorConfig as bJ, type GoogleDriveLiveConnectorConfig as bK, type HeartbeatConfig as bL, type HeartbeatDetectionMode as bM, type LlmTraceCallback as bN, type LlmTraceEvent as bO, type MemoryActionOutcome as bP, type MemoryActionPolicyDecision as bQ, type MemoryActionStatus as bR, type MemoryLinkType as bS, type MemoryOsPresetName as bT, type ModelApi as bU, type ModelDefinitionConfig as bV, type ModelProviderAuthMode as bW, type NamespacePolicy as bX, type NativeKnowledgeFolderRuleConfig as bY, type NativeKnowledgeObsidianVaultConfig as bZ, type NativeKnowledgeOpenClawWorkspaceConfig as b_, type BehaviorSignalDirection as ba, type BehaviorSignalType as bb, type BriefingCalendarSourceError as bc, type BufferEntryState as bd, type CaptureMode as be, type CodexCliReasoningEffort as bf, type CodexCompactionFlushMode as bg, type CodexConnectorConfig as bh, type CodingKnowledgeConfig as bi, type CompressionGuidelineActivationState as bj, type CompressionGuidelineOptimizerSourceWindow as bk, type ConfidenceTier as bl, type ConsolidationAction as bm, type ConsolidationItem as bn, type ContinuityIncidentState as bo, type ContinuityLoopCadence as bp, type ContinuityLoopStatus as bq, type ContradictionScanConfig as br, type CronConversationRecallMode as bs, type CronRecallMode as bt, type DreamingConfig as bu, type DreamingNarrativePromptStyle as bv, type DreamsDeepSleepConfig as bw, type DreamsLightSleepConfig as bx, type DreamsPhaseStatus as by, type DreamsPhasesConfig as bz, type ActiveRecallThinking as c, type PrincipalFromSessionKeyMode as c0, type PrincipalRule as c1, type ProceduralConfig as c2, type QuestionEntry as c3, type ReasoningEffort as c4, type RecallPipelineConfig as c5, type RecallSectionConfig as c6, type RecallTraceEvent as c7, type RelevanceFeedback as c8, SPECULATIVE_TTL_DAYS as c9, type ScopeProfileAutoPromoteConfig as ca, type ScopeProfileConfig as cb, type ScopeProfileTeamProjectConfig as cc, type ScopeTeamConfig as cd, type ScoredEntity as ce, type SemanticChunkingConfigShape as cf, type SignalLevel as cg, type SlotBehaviorConfig as ch, type SlotMismatchMode as ci, type TriggerMode as cj, confidenceTier as ck, 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 TranscriptEntry as $, type ActiveRecallChatType as A, type BehaviorSignalEvent as B, type CompressionGuidelineOptimizerState as C, type MemoryProjectionCurrentState as D, type EntityStructuredSection as E, type FaithfulnessFrontmatter as F, type GatewayConfig as G, type MemorySummary as H, type ImportanceScore as I, type RecallPlanMode as J, type IdentityInjectionMode as K, type LiveConnectorsConfig as L, type MemoryCategory as M, type RecallDisclosure as N, type BriefingSections as O, type PluginConfig as P, type QmdSearchResult as Q, type RecallTierExplain as R, type BriefingFollowup as S, type TopicScore as T, type BriefingFocus as U, type CalendarSource as V, type CalendarEvent as W, type BriefingActiveThread as X, type BriefingResult as Y, type BriefingRecentEntity as Z, type BufferTurn as _, type ActiveRecallQueryMode as a, type MemoryScope as a$, type Checkpoint as a0, type HourlySummary as a1, type SessionObserverBandConfig as a2, type LifecycleState as a3, type VerificationState as a4, type PolicyClass as a5, type ImportanceLevel as a6, type SecretRef as a7, type AgentAccessAuthToken as a8, type CompressionGuidelineOptimizerEventCounts 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 CompressionGuidelineOptimizerActionSummary as aa, type CompressionGuidelineOptimizerRuleUpdate as ab, type MemoryActionType as ac, type EntityMention as ad, type EntitySchemaDefinition as ae, type EntitySchemaSectionDefinition as af, type ExtractionResult as ag, type ConsolidationResult as ah, type DaySummaryResult as ai, type MemoryIntent as aj, type QmdSearchExplain as ak, type MemoryActionEligibilityContext as al, type MemoryActionPolicyResult as am, type MemoryLifecycleEventType as an, type MemoryLifecycleStateSummary as ao, type ModelProviderConfig as ap, type NativeKnowledgeConfig as aq, type ProvenanceConfig as ar, type ProvenanceSource as as, type RetrievalTier as at, type SignalScanResult as au, type ConversationThread 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 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 FileHygieneConfig as v, type EntityRelationship as w, type EntityActivityEntry as x, type EntityFile as y, type AccessTrackingEntry 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, b6 as AgentAccessHttpConfig, b7 as AgentDefaultsConfig, b8 as AgentPersona, f as AgentPersonaModelConfig, b9 as BehaviorLoopAdjustment, e as BehaviorLoopPolicyState, ba as BehaviorSignalDirection, B as BehaviorSignalEvent, bb as BehaviorSignalType, aL as BootstrapOptions, aM as BootstrapResult, W as BriefingActiveThread, bc as BriefingCalendarSourceError, aS as BriefingConfig, S as BriefingFocus, O as BriefingFollowup, aT as BriefingOpenCommitment, Y as BriefingRecentEntity, X as BriefingResult, N as BriefingSections, aU as BriefingWindow, bd as BufferEntryState, k as BufferState, o as BufferSurpriseEvent, Z as BufferTurn, V as CalendarEvent, U as CalendarSource, be as CaptureMode, $ as Checkpoint, bf as CodexCliReasoningEffort, bg as CodexCompactionFlushMode, aV as CodexCompatConfig, bh as CodexConnectorConfig, aK as CodingContext, bi as CodingKnowledgeConfig, aP as CodingModeConfig, bj as CompressionGuidelineActivationState, a9 as CompressionGuidelineOptimizerActionSummary, a8 as CompressionGuidelineOptimizerEventCounts, aa as CompressionGuidelineOptimizerRuleUpdate, bk as CompressionGuidelineOptimizerSourceWindow, C as CompressionGuidelineOptimizerState, bl as ConfidenceTier, bm as ConsolidationAction, bn as ConsolidationItem, aN as ConsolidationObservation, ag as ConsolidationResult, s as ContinuityImprovementLoop, r as ContinuityIncidentCloseInput, p as ContinuityIncidentOpenInput, q as ContinuityIncidentRecord, bo as ContinuityIncidentState, bp as ContinuityLoopCadence, u as ContinuityLoopReviewInput, bq as ContinuityLoopStatus, t as ContinuityLoopUpsertInput, br as ContradictionScanConfig, au as ConversationThread, bs as CronConversationRecallMode, bt as CronRecallMode, aW as DEFAULT_RECALL_DISCLOSURE, ah as DaySummaryResult, bu as DreamingConfig, bv as DreamingNarrativePromptStyle, bw as DreamsDeepSleepConfig, bx as DreamsLightSleepConfig, ay as DreamsPhase, by as DreamsPhaseStatus, bz as DreamsPhasesConfig, bA as DreamsRemConfig, az as DreamsRunResult, ax as DreamsStatusResult, bB as EngramTraceEvent, w as EntityActivityEntry, x as EntityFile, ac as EntityMention, v as EntityRelationship, ad as EntitySchemaDefinition, ae as EntitySchemaSectionDefinition, E as EntityStructuredSection, aO as EntityTimelineEntry, aX as ExtractedFact, bC as ExtractedProcedureStep, bD as ExtractedQuestion, bE as ExtractedReasoningTrace, bF as ExtractedReasoningTraceStep, bG as ExtractedRelationship, bH as ExtractionPassSource, af as ExtractionResult, F as FileHygieneConfig, G as GatewayConfig, bI as GitHubLiveConnectorConfig, bJ as GmailLiveConnectorConfig, bK as GoogleDriveLiveConnectorConfig, bL as HeartbeatConfig, bM as HeartbeatDetectionMode, a0 as HourlySummary, J as IdentityInjectionMode, a5 as ImportanceLevel, I as ImportanceScore, a2 as LifecycleState, L as LiveConnectorsConfig, bN as LlmTraceCallback, bO as LlmTraceEvent, ak as MemoryActionEligibilityContext, aY as MemoryActionEligibilitySource, m as MemoryActionEvent, bP as MemoryActionOutcome, bQ as MemoryActionPolicyDecision, al as MemoryActionPolicyResult, bR 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, bS as MemoryLinkType, aZ as MemoryObservation, bT as MemoryOsPresetName, z as MemoryProjectionCurrentState, a_ as MemoryScope, h as MemoryStatus, D as MemorySummary, l as MetaState, bU as ModelApi, bV as ModelDefinitionConfig, bW as ModelProviderAuthMode, ao as ModelProviderConfig, bX as NamespacePolicy, ap as NativeKnowledgeConfig, bY as NativeKnowledgeFolderRuleConfig, bZ as NativeKnowledgeObsidianVaultConfig, b_ as NativeKnowledgeOpenClawWorkspaceConfig, b$ as NotionLiveConnectorConfig, P as PluginConfig, a4 as PolicyClass, c0 as PrincipalFromSessionKeyMode, c1 as PrincipalRule, c2 as ProceduralConfig, aq as ProvenanceConfig, ar as ProvenanceSource, aj as QmdSearchExplain, Q as QmdSearchResult, c3 as QuestionEntry, a$ as RECALL_DISCLOSURE_LEVELS, c4 as ReasoningEffort, K as RecallDisclosure, c5 as RecallPipelineConfig, H as RecallPlanMode, c6 as RecallSectionConfig, R as RecallTierExplain, c7 as RecallTraceEvent, c8 as RelevanceFeedback, as as RetrievalTier, c9 as SPECULATIVE_TTL_DAYS, ca as ScopeProfileAutoPromoteConfig, cb as ScopeProfileConfig, av as ScopeProfileLayerId, aw as ScopeProfilePromotionTarget, cc as ScopeProfileTeamProjectConfig, cd as ScopeTeamConfig, ce as ScoredEntity, a6 as SecretRef, cf as SemanticChunkingConfigShape, a1 as SessionObserverBandConfig, cg as SignalLevel, at as SignalScanResult, ch as SlotBehaviorConfig, ci as SlotMismatchMode, T as TopicScore, _ as TranscriptEntry, cj as TriggerMode, a3 as VerificationState, ck as confidenceTier, b5 as isRecallDisclosure } from './types-2NoBoRBM.js';
+export { z as AccessTrackingEntry, A as ActiveRecallChatType, d as ActiveRecallModelFallbackPolicy, b as ActiveRecallPromptStyle, a as ActiveRecallQueryMode, c as ActiveRecallThinking, a8 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, X as BriefingActiveThread, bd as BriefingCalendarSourceError, aT as BriefingConfig, U as BriefingFocus, S as BriefingFollowup, aU as BriefingOpenCommitment, Z as BriefingRecentEntity, Y as BriefingResult, O as BriefingSections, aV as BriefingWindow, be as BufferEntryState, k as BufferState, o as BufferSurpriseEvent, _ as BufferTurn, W as CalendarEvent, V as CalendarSource, bf as CaptureMode, a0 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, aa as CompressionGuidelineOptimizerActionSummary, a9 as CompressionGuidelineOptimizerEventCounts, ab as CompressionGuidelineOptimizerRuleUpdate, bl as CompressionGuidelineOptimizerSourceWindow, C as CompressionGuidelineOptimizerState, bm as ConfidenceTier, bn as ConsolidationAction, bo as ConsolidationItem, aO as ConsolidationObservation, ah as ConsolidationResult, s as ContinuityImprovementLoop, r as ContinuityIncidentCloseInput, p as ContinuityIncidentOpenInput, q as ContinuityIncidentRecord, bp as ContinuityIncidentState, bq as ContinuityLoopCadence, u as ContinuityLoopReviewInput, br as ContinuityLoopStatus, t as ContinuityLoopUpsertInput, bs as ContradictionScanConfig, av as ConversationThread, bt as CronConversationRecallMode, bu as CronRecallMode, aX as DEFAULT_RECALL_DISCLOSURE, ai 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, x as EntityActivityEntry, y as EntityFile, ad as EntityMention, w as EntityRelationship, ae as EntitySchemaDefinition, af as EntitySchemaSectionDefinition, E 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, ag as ExtractionResult, F as FaithfulnessFrontmatter, v as FileHygieneConfig, G as GatewayConfig, bJ as GitHubLiveConnectorConfig, bK as GmailLiveConnectorConfig, bL as GoogleDriveLiveConnectorConfig, bM as HeartbeatConfig, bN as HeartbeatDetectionMode, a1 as HourlySummary, K as IdentityInjectionMode, a6 as ImportanceLevel, I as ImportanceScore, a3 as LifecycleState, L as LiveConnectorsConfig, bO as LlmTraceCallback, bP as LlmTraceEvent, al as MemoryActionEligibilityContext, aZ as MemoryActionEligibilitySource, m as MemoryActionEvent, bQ as MemoryActionOutcome, bR as MemoryActionPolicyDecision, am as MemoryActionPolicyResult, bS as MemoryActionStatus, ac as MemoryActionType, M as MemoryCategory, g as MemoryFile, j as MemoryFrontmatter, aj as MemoryIntent, n as MemoryLifecycleEvent, an as MemoryLifecycleEventType, ao as MemoryLifecycleStateSummary, i as MemoryLink, bT as MemoryLinkType, a_ as MemoryObservation, bU as MemoryOsPresetName, D as MemoryProjectionCurrentState, a$ as MemoryScope, h as MemoryStatus, H as MemorySummary, l as MetaState, bV as ModelApi, bW as ModelDefinitionConfig, bX as ModelProviderAuthMode, ap as ModelProviderConfig, bY as NamespacePolicy, aq as NativeKnowledgeConfig, bZ as NativeKnowledgeFolderRuleConfig, b_ as NativeKnowledgeObsidianVaultConfig, b$ as NativeKnowledgeOpenClawWorkspaceConfig, c0 as NotionLiveConnectorConfig, P as PluginConfig, a5 as PolicyClass, c1 as PrincipalFromSessionKeyMode, c2 as PrincipalRule, c3 as ProceduralConfig, ar as ProvenanceConfig, as as ProvenanceSource, ak as QmdSearchExplain, Q as QmdSearchResult, c4 as QuestionEntry, b0 as RECALL_DISCLOSURE_LEVELS, c5 as ReasoningEffort, N as RecallDisclosure, c6 as RecallPipelineConfig, J as RecallPlanMode, c7 as RecallSectionConfig, R as RecallTierExplain, c8 as RecallTraceEvent, c9 as RelevanceFeedback, at 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, a7 as SecretRef, cg as SemanticChunkingConfigShape, a2 as SessionObserverBandConfig, ch as SignalLevel, au as SignalScanResult, ci as SlotBehaviorConfig, cj as SlotMismatchMode, T as TopicScore, $ as TranscriptEntry, ck as TriggerMode, a4 as VerificationState, cl as confidenceTier, b6 as isRecallDisclosure } from './types-CeZYSC-E.js';

package/dist/types.js

@@ -4,7 +4,7 @@ import {
   SPECULATIVE_TTL_DAYS,
   confidenceTier,
   isRecallDisclosure
-} from "./chunk-DQHZA7Y3.js";
+} from "./chunk-ZXUOAFUG.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-2NoBoRBM.js';
+import './types-CeZYSC-E.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 import './lifecycle.js';

package/dist/verified-recall.js

@@ -1,32 +1,40 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-3VVH6ZQW.js";
+} from "./chunk-Q6ZHGGNJ.js";
 import "./chunk-7FL4CNPV.js";
-import "./chunk-VFVG4NS2.js";
+import "./chunk-MOBRVKWE.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
 import "./chunk-SVOZFLIQ.js";
 import "./chunk-J6A3CX5N.js";
-import "./chunk-DQHZA7Y3.js";
+import "./chunk-ZXUOAFUG.js";
+import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-MB5RSUW6.js";
 import "./chunk-6KYMPV2O.js";
 import "./chunk-AWJ2FHCF.js";
 import "./chunk-42JKGUFJ.js";
-import "./chunk-RULE4VG5.js";
-import "./chunk-LDXUBPMO.js";
 import "./chunk-DM2T26WE.js";
+import "./chunk-LDXUBPMO.js";
 import "./chunk-FVQJYWH7.js";
+import "./chunk-5AT62NQH.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-VF4XKTX3.js";
+import "./chunk-5TYA4OCF.js";
+import "./chunk-IQVQJJL7.js";
+import "./chunk-VL7DP3OW.js";
+import "./chunk-L2EXJQJP.js";
+import "./chunk-RGMVMVMF.js";
+import "./chunk-RK6F44Y6.js";
 import "./chunk-J2HSAU72.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VS2IYZRU.js";
 import "./chunk-ZPQVJEVQ.js";
 import "./chunk-4DJQYKMN.js";
+import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-NU3CSQ4H.js";
 import "./chunk-ZBJMUXZH.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.3.693",
+  "version": "9.3.695",
   "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.693"
+    "@remnic/coding-graph": "^9.3.695"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/access-boundary.ts

@@ -36,6 +36,23 @@ export type OperationName =
   | "memory_store"
   | "coding_decision"
   | "coding_architecture"
+  // codegraph parity tools (issue #1554) -- each maps to one codegraph_*
+  // boundary operation that delegates to the surface handler in
+  // coding/codegraph-surfaces.ts. Names match the external tool suffixes.
+  | "codegraph_index"
+  | "codegraph_list_projects"
+  | "codegraph_delete_project"
+  | "codegraph_index_status"
+  | "codegraph_search_graph"
+  | "codegraph_trace_path"
+  | "codegraph_detect_changes"
+  | "codegraph_query_graph"
+  | "codegraph_get_schema"
+  | "codegraph_get_snippet"
+  | "codegraph_get_architecture"
+  | "codegraph_search_code"
+  | "codegraph_manage_adr"
+  | "codegraph_ingest_traces"
   | "coding_delta";
 
 // ---------------------------------------------------------------------------

package/src/access-http.ts

@@ -317,6 +317,7 @@ export class EngramAccessHttpServer {
       emitLegacyTools: options.emitLegacyTools,
       codingDecisionVisible: this.service.decisionRecordSurfaceVisible,
       architectureCardVisible: this.service.architectureCardSurfaceVisible,
+      codegraphVisible: this.service.codegraphSurfaceVisible,
       sessionDeltaVisible: this.service.sessionDeltaSurfaceVisible,
     });
   }
@@ -2268,6 +2269,20 @@ export class EngramAccessHttpServer {
     const codingArchitectureWrite =
       (toolName === "engram.coding_architecture" || toolName === "remnic.coding_architecture") &&
       toolArgsSubcommand === "refresh";
+    // codegraph parity tools (issue #1554): only mutating tools count as
+    // writes — index, delete_project, ingest_traces, and manage_adr
+    // (record|supersede). Read-only tools (search_graph, get_schema,
+    // list_projects, etc.) must NOT hit the write quota.
+    const CODEGRAPH_WRITE_TOOLS = new Set([
+      "engram.codegraph_index", "remnic.codegraph_index",
+      "engram.codegraph_delete_project", "remnic.codegraph_delete_project",
+      "engram.codegraph_ingest_traces", "remnic.codegraph_ingest_traces",
+    ]);
+    const isCodegraphManageAdr =
+      toolName === "engram.codegraph_manage_adr" || toolName === "remnic.codegraph_manage_adr";
+    const codegraphWrite =
+      CODEGRAPH_WRITE_TOOLS.has(toolName) ||
+      (isCodegraphManageAdr && (toolArgsSubcommand === "record" || toolArgsSubcommand === "supersede"));
     const isMcpWrite =
       request.method === "tools/call" &&
       (
@@ -2297,7 +2312,8 @@ export class EngramAccessHttpServer {
           )
         ) ||
         codingDecisionWrite ||
-        codingArchitectureWrite
+        codingArchitectureWrite ||
+        codegraphWrite
       );
     if (isMcpWrite) {
       this.ensureWriteRateLimitAvailable();
@@ -2320,8 +2336,16 @@ export class EngramAccessHttpServer {
     if (isMcpWrite && response !== null) {
       const result = (response as Record<string, unknown>).result as Record<string, unknown> | undefined;
       const isError = result?.isError === true;
-      const structured = result?.structuredContent as { dryRun?: boolean; idempotencyReplay?: boolean } | undefined;
-      if (!isError && structured && this.shouldCountWriteRateLimit(structured)) {
+      const structured = result?.structuredContent as
+        | { dryRun?: boolean; idempotencyReplay?: boolean; ok?: boolean }
+        | undefined;
+      // Rejected codegraph calls carry { ok: false } in structuredContent
+      // (confirm_required, package_missing, runtime_unavailable, ...). The
+      // MCP layer sets isError:false for these, so without this guard they
+      // would consume the write quota despite no mutation occurring
+      // (issue #1554 review thread: don't bill rejected calls as writes).
+      const isRejectedCodegraph = structured?.ok === false;
+      if (!isError && !isRejectedCodegraph && structured && this.shouldCountWriteRateLimit(structured)) {
         this.recordWriteRateLimitHit();
       }
     }

package/src/access-mcp.ts

@@ -111,6 +111,21 @@ const MCP_MIGRATED_OPERATIONS: Readonly<Record<string, OperationName>> = {
   "engram.memory_store": "memory_store",
   "engram.coding_decision": "coding_decision",
   "engram.coding_architecture": "coding_architecture",
+  // codegraph parity tools (issue #1554) — each maps to its boundary op.
+  "engram.codegraph_index": "codegraph_index",
+  "engram.codegraph_list_projects": "codegraph_list_projects",
+  "engram.codegraph_delete_project": "codegraph_delete_project",
+  "engram.codegraph_index_status": "codegraph_index_status",
+  "engram.codegraph_search_graph": "codegraph_search_graph",
+  "engram.codegraph_trace_path": "codegraph_trace_path",
+  "engram.codegraph_detect_changes": "codegraph_detect_changes",
+  "engram.codegraph_query_graph": "codegraph_query_graph",
+  "engram.codegraph_get_schema": "codegraph_get_schema",
+  "engram.codegraph_get_snippet": "codegraph_get_snippet",
+  "engram.codegraph_get_architecture": "codegraph_get_architecture",
+  "engram.codegraph_search_code": "codegraph_search_code",
+  "engram.codegraph_manage_adr": "codegraph_manage_adr",
+  "engram.codegraph_ingest_traces": "codegraph_ingest_traces",
   "engram.coding_delta": "coding_delta",
 };
 
@@ -332,6 +347,12 @@ export class EngramMcpServer {
    * (issue #1548 Track A PR 3, rule 39).
    */
   private readonly architectureCardVisible: boolean;
+  /**
+   * Whether the 14 codegraph parity tools should appear in `tools/list`
+   * (issue #1554). Config-only -- runtime availability is checked at call
+   * time. When false the tools array is byte-identical to pre-feature.
+   */
+  private readonly codegraphVisible: boolean;
   private readonly sessionDeltaVisible: boolean;
 
   constructor(
@@ -343,6 +364,7 @@ export class EngramMcpServer {
       emitLegacyTools?: boolean;
       codingDecisionVisible?: boolean;
       architectureCardVisible?: boolean;
+      codegraphVisible?: boolean;
       sessionDeltaVisible?: boolean;
     } = {},
   ) {
@@ -351,6 +373,7 @@ export class EngramMcpServer {
     this.emitLegacyTools = options.emitLegacyTools !== false;
     this.codingDecisionVisible = options.codingDecisionVisible === true;
     this.architectureCardVisible = options.architectureCardVisible === true;
+    this.codegraphVisible = options.codegraphVisible === true;
     this.sessionDeltaVisible = options.sessionDeltaVisible === true;
     this.authenticatedPrincipal =
       options.principal?.trim() ||
@@ -2037,6 +2060,70 @@ export class EngramMcpServer {
       );
       this.tools = [...this.tools, ...architectureTools];
     }
+    if (this.codegraphVisible) {
+      // The 14 codegraph parity tools (issue #1554). Each delegates to its
+      // boundary operation; the MCP dispatch injects the `tool` field from
+      // the operation name. The inputSchema is intentionally permissive —
+      // the boundary's zod schema owns validation (rule 51).
+      const codegraphToolDefs: Array<{ suffix: string; description: string; required?: string[] }> = [
+        { suffix: "index", description: "Index a repository into the code graph.", required: ["repoRoot"] },
+        { suffix: "list_projects", description: "List code graph projects for the principal." },
+        { suffix: "delete_project", description: "Delete a code graph project (requires confirm: true).", required: ["confirm"] },
+        { suffix: "index_status", description: "Get the indexing status for a project." },
+        { suffix: "search_graph", description: "Search the code graph for symbols.", required: ["query"] },
+        { suffix: "trace_path", description: "Trace call/dependency paths from a starting symbol.", required: ["start"] },
+        { suffix: "detect_changes", description: "Detect changed symbols since a git ref.", required: ["head"] },
+        { suffix: "query_graph", description: "Run a structured query against the code graph.", required: ["structuredQuery"] },
+        { suffix: "get_schema", description: "Get the code graph schema statistics." },
+        { suffix: "get_snippet", description: "Get a source code snippet for a symbol.", required: ["qualifiedName"] },
+        { suffix: "get_architecture", description: "Get the composed architecture card + graph stats." },
+        { suffix: "search_code", description: "Search the code graph for code (functions, classes, methods).", required: ["query"] },
+        { suffix: "manage_adr", description: "Manage ADRs via Track A decision records (list, get, record, supersede).", required: ["subcommand"] },
+        { suffix: "ingest_traces", description: "Ingest call-site traces to upgrade edge confidence.", required: ["traces"] },
+      ];
+      for (const def of codegraphToolDefs) {
+        const tools = withToolAliases(
+          {
+            name: `engram.codegraph_${def.suffix}`,
+            description: def.description,
+            inputSchema: {
+              type: "object",
+              properties: {
+                sessionKey: { type: "string", description: "Session identifier whose coding context scopes the operation." },
+                project: { type: "string", description: "Explicit project id (defaults to session coding context)." },
+                principal: { type: "string", description: "Authenticated principal override." },
+                query: { type: "string" },
+                limit: { type: "number" },
+                start: { type: "string" },
+                direction: { type: "string", enum: ["inbound", "outbound", "both"] },
+                depth: { type: "number" },
+                qualifiedName: { type: "string" },
+                path: { type: "string" },
+                structuredQuery: { type: "object" },
+                head: { type: "string" },
+                repoRoot: { type: "string" },
+                mode: { type: "string", enum: ["auto", "full", "incremental"] },
+                confirm: { type: "boolean" },
+                subcommand: { type: "string", enum: ["list", "get", "record", "supersede"] },
+                id: { type: "string" },
+                title: { type: "string" },
+                status: { type: "string", enum: ["proposed", "accepted", "superseded", "rejected"] },
+                context: { type: "string" },
+                decision: { type: "string" },
+                consequences: { type: "string" },
+                entityRefs: { type: "array", items: { type: "string" } },
+                supersedesId: { type: "string" },
+                traces: { type: "array", items: { type: "object" } },
+              },
+              required: def.required ?? [],
+              additionalProperties: false,
+            },
+          },
+          this.emitLegacyTools,
+        );
+        this.tools = [...this.tools, ...tools];
+      }
+    }
     if (this.sessionDeltaVisible) {
       const deltaTools = withToolAliases(
         {
@@ -2423,8 +2510,18 @@ export class EngramMcpServer {
       if (!op) {
         throw new EngramAccessInputError(`access-boundary: operation not registered: ${migrated}`);
       }
-      const envelope =
-        migrated === "memory_store" ? parseMcpRequest("memoryStore", args) : args;
+      let envelope: Record<string, unknown>;
+      if (migrated === "memory_store") {
+        envelope = parseMcpRequest("memoryStore", args);
+      } else if (migrated.startsWith("codegraph_")) {
+        // codegraph parity tools (issue #1554): the surface handler dispatches
+        // on the `tool` field. The MCP tool name encodes it (e.g.
+        // codegraph_search_graph → tool: "search_graph"); inject it so the
+        // client payload does not need to carry the internal dispatch field.
+        envelope = { ...args, tool: migrated.slice("codegraph_".length) };
+      } else {
+        envelope = args;
+      }
       // The registry erases In/Out at the Map boundary; the caller knows the
       // concrete output shape ({ result: <service response> }) so the cast is
       // the type-erasure seam, not a leap of faith.