@remnic/core 9.3.669 → 9.3.671

package/dist/semantic-rule-verifier.d.ts

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

package/dist/semantic-rule-verifier.js

@@ -1,13 +1,13 @@
 import {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
-} from "./chunk-XMWF6AU3.js";
-import "./chunk-WKMCC4NQ.js";
+} from "./chunk-LVTTO3VC.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/dist/session-observer-bands.d.ts

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

package/dist/session-observer-state.d.ts

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

package/dist/shared-context/manager.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { P as PluginConfig } from '../types-D96bCB3C.js';
+import { P as PluginConfig } from '../types-D3pm4NhH.js';
 import '../types-ByK7T3L6.js';
 import '../index-DJ9QWMw-.js';
 

package/dist/signal.d.ts

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

package/dist/storage.d.ts

@@ -1,6 +1,6 @@
 import { VersioningConfig } from './page-versioning.js';
 import { ConsolidationOperator } from './consolidation-operator.js';
-import { P as PluginConfig, h as MemoryStatus, M as MemoryCategory, I as ImportanceScore, i as MemoryLink, j as MemoryFrontmatter, g as MemoryFile, E as EntityStructuredSection, k as BufferState, l as MetaState, m as MemoryActionEvent, n as MemoryLifecycleEvent, o as BufferSurpriseEvent, B as BehaviorSignalEvent, C as CompressionGuidelineOptimizerState, p as ContinuityIncidentOpenInput, q as ContinuityIncidentRecord, r as ContinuityIncidentCloseInput, s as ContinuityImprovementLoop, t as ContinuityLoopUpsertInput, u as ContinuityLoopReviewInput, F as FileHygieneConfig, v as EntityRelationship, w as EntityActivityEntry, x as EntityFile, y as AccessTrackingEntry, z as MemoryProjectionCurrentState, D as MemorySummary, T as TopicScore } from './types-D96bCB3C.js';
+import { P as PluginConfig, h as MemoryStatus, M as MemoryCategory, I as ImportanceScore, i as MemoryLink, j as MemoryFrontmatter, g as MemoryFile, E as EntityStructuredSection, k as BufferState, l as MetaState, m as MemoryActionEvent, n as MemoryLifecycleEvent, o as BufferSurpriseEvent, B as BehaviorSignalEvent, C as CompressionGuidelineOptimizerState, p as ContinuityIncidentOpenInput, q as ContinuityIncidentRecord, r as ContinuityIncidentCloseInput, s as ContinuityImprovementLoop, t as ContinuityLoopUpsertInput, u as ContinuityLoopReviewInput, F as FileHygieneConfig, v as EntityRelationship, w as EntityActivityEntry, x as EntityFile, y as AccessTrackingEntry, z as MemoryProjectionCurrentState, D as MemorySummary, T as TopicScore } from './types-D3pm4NhH.js';
 import { ProjectedMemoryBrowseOptions, ProjectedMemoryBrowsePage, readProjectedGovernanceRecord } from './memory-projection-store.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';

package/dist/storage.js

@@ -9,12 +9,12 @@ import {
   parseEntityFile,
   serializeEntityFile,
   stripAttributesSuffix
-} from "./chunk-WKMCC4NQ.js";
+} from "./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/dist/summarizer.d.ts

@@ -1,5 +1,5 @@
 import { ModelRegistry } from './model-registry.js';
-import { P as PluginConfig, G as GatewayConfig, _ as TranscriptEntry, a0 as HourlySummary } from './types-D96bCB3C.js';
+import { P as PluginConfig, G as GatewayConfig, _ as TranscriptEntry, a0 as HourlySummary } from './types-D3pm4NhH.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 { 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.669",
+  "version": "9.3.671",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",

package/src/coding/coding-knowledge-config.ts

@@ -0,0 +1,111 @@
+/**
+ * Track A (issue #1548 PR 1) — parse the `codingKnowledge` config block.
+ *
+ * Lives in `coding/` (not in `config.ts`) so adding a feature config block
+ * does not grow the watchlisted `config.ts` past its ratchet baseline. The
+ * function is a pure helper: it reads from the raw `cfg.codingKnowledge`
+ * sub-object, applies defaults from `CODING_KNOWLEDGE_DEFAULTS`, validates
+ * the structural-provider enum, and returns the populated
+ * `CodingKnowledgeConfig`.
+ *
+ * Parse rules (CLAUDE.md gotcha 36, rule 30, rule 48):
+ *  - booleans are coerced at the parse boundary so CLI strings like
+ *    `--config codingKnowledge.enabled=false` arrive as `false`, not truthy.
+ *  - unknown structural-provider values are rejected listing the valid
+ *    options (rule 51 — silent defaulting is a contract lie).
+ *  - `structuralProvider` defaults to `"none"` (rule 48 — least-privileged:
+ *    spawning subprocesses is an explicit operator choice).
+ *
+ * Env overrides follow the REMNIC_* + ENGRAM_* fallback already used elsewhere
+ * in `config.ts` (#1427 family). Each individual switch is `codingKnowledge.*` —
+ * the existing `ENGRAM_*` env vars from earlier releases do not pair them up.
+ */
+
+import type { CodingKnowledgeConfig } from "../types.js";
+import { coerceBool } from "../connectors/coerce.js";
+
+export const CODING_KNOWLEDGE_DEFAULTS = Object.freeze({
+  enabled: false,
+  decisionRecords: true,
+  architectureCard: true,
+  sessionDelta: true,
+  architectureCardLlmSummary: false,
+  structuralProvider: "none",
+  structuralProviderCommand: "",
+} satisfies Record<keyof CodingKnowledgeConfig, boolean | string>);
+
+const VALID_STRUCTURAL_PROVIDERS = ["none", "subprocess", "native"] as const;
+type StructuralProvider = CodingKnowledgeConfig["structuralProvider"];
+
+/**
+ * Parse the `codingKnowledge` sub-object into a fully-populated
+ * `CodingKnowledgeConfig`. Returns the documented defaults when the
+ * sub-object is missing, null, not an object, or has unknown shape.
+ *
+ * Throws when an explicit `structuralProvider` value is not one of the
+ * declared enum values (rule 51 — listing valid options in the error).
+ */
+export function parseCodingKnowledgeConfig(raw: unknown): CodingKnowledgeConfig {
+  const record =
+    raw && typeof raw === "object" && !Array.isArray(raw)
+      ? (raw as Record<string, unknown>)
+      : {};
+
+  const structuralProvider = readStructuralProvider(record.structuralProvider);
+  return {
+    enabled: readStrictBool(record.enabled, "enabled", /* default */ false),
+    decisionRecords: readStrictBool(record.decisionRecords, "decisionRecords", /* default */ true),
+    architectureCard: readStrictBool(record.architectureCard, "architectureCard", /* default */ true),
+    sessionDelta: readStrictBool(record.sessionDelta, "sessionDelta", /* default */ true),
+    architectureCardLlmSummary: readStrictBool(record.architectureCardLlmSummary, "architectureCardLlmSummary", /* default */ false),
+    structuralProvider,
+    structuralProviderCommand:
+      typeof record.structuralProviderCommand === "string"
+        ? record.structuralProviderCommand.trim()
+        : "",
+  };
+}
+
+const STRICT_BOOL_ACCEPTED = "true/false/1/0/yes/no/on/off";
+
+/**
+ * Strict boolean parse for feature-gate config values.
+ *  - `undefined` falls back to `defaultValue` (the key was simply not
+ *    supplied).
+ *  - `true`/`false` (native) and the boolean-like strings listed in
+ *    `STRICT_BOOL_ACCEPTED` are honored (rule 36 — CLI string parity).
+ *  - Any other shape, including misspelled strings like `"flase"`,
+ *    numbers outside `{0, 1}`, objects, arrays — is REJECTED with an
+ *    error listing the valid inputs (rule 51). Silent defaulting on
+ *    malformed operator input is a contract lie.
+ */
+export function readStrictBool(
+  value: unknown,
+  keyName: string,
+  defaultValue: boolean,
+): boolean {
+  if (value === undefined) return defaultValue;
+  const coerced = coerceBool(value);
+  if (coerced === undefined) {
+    throw new Error(
+      `codingKnowledge.${keyName} must be a boolean or one of ${STRICT_BOOL_ACCEPTED}; ` +
+        `got ${JSON.stringify(value)}.`,
+    );
+  }
+  return coerced;
+}
+
+function readStructuralProvider(raw: unknown): StructuralProvider {
+  if (raw === undefined) return "none";
+  if (typeof raw !== "string") {
+    throw new Error(
+      `codingKnowledge.structuralProvider must be a string (` +
+        `${VALID_STRUCTURAL_PROVIDERS.join(", ")}); got ${JSON.stringify(raw)}.`,
+    );
+  }
+  if (raw === "none" || raw === "subprocess" || raw === "native") return raw;
+  throw new Error(
+    `codingKnowledge.structuralProvider must be one of ` +
+      `${VALID_STRUCTURAL_PROVIDERS.join(", ")}; got ${JSON.stringify(raw)}.`,
+  );
+}