@remnic/core 9.3.683 → 9.3.684

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, 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';
+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-Dm5xxVrr.js';

package/dist/types.js

@@ -4,7 +4,7 @@ import {
   SPECULATIVE_TTL_DAYS,
   confidenceTier,
   isRecallDisclosure
-} from "./chunk-FMSDA2D3.js";
+} from "./chunk-NGFEWFNK.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-D3pm4NhH.js';
+import './types-Dm5xxVrr.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-I75DF4FZ.js";
+} from "./chunk-XEA4Z7JU.js";
 import "./chunk-HQ6NIBL6.js";
-import "./chunk-TY5NT3T3.js";
+import "./chunk-53FDU4CE.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
 import "./chunk-J6A3CX5N.js";
-import "./chunk-FMSDA2D3.js";
+import "./chunk-NGFEWFNK.js";
 import "./chunk-MB5RSUW6.js";
 import "./chunk-6KYMPV2O.js";
 import "./chunk-AWJ2FHCF.js";
@@ -24,7 +24,9 @@ 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-JUC24CTX.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-ZBJMUXZH.js";
 import "./chunk-PZ5AY32C.js";

package/package.json

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

package/src/config.test.ts

@@ -1920,3 +1920,115 @@ test("parseConfig schema-default-detection round-4 contract (round 8: runtimeSet
     );
   });
 });
+
+// ---------------------------------------------------------------------------
+// Issue #1575 PR 1 — provenance config block: defaults + coercion.
+//
+// The characterization test pins the documented defaults table from the issue
+// so a future edit to the parsing defaults is caught here rather than in a
+// downstream extraction test. Env-var reads are isolated so the REMNIC_/
+// ENGRAM_ override path is exercised deterministically.
+// ---------------------------------------------------------------------------
+
+test("parseConfig provenance defaults deep-equal the documented table (issue #1575)", () => {
+  const prevEnabled = process.env.REMNIC_PROVENANCE_ENABLED;
+  const prevEngram = process.env.ENGRAM_PROVENANCE_ENABLED;
+  delete process.env.REMNIC_PROVENANCE_ENABLED;
+  delete process.env.ENGRAM_PROVENANCE_ENABLED;
+  try {
+    const result = parseConfig({ openaiApiKey: "sk-test" });
+    assert.deepEqual(result.provenance, {
+      enabled: true,
+      maxQuoteChars: 300,
+      requireSpans: false,
+    });
+  } finally {
+    if (prevEnabled !== undefined) process.env.REMNIC_PROVENANCE_ENABLED = prevEnabled;
+    if (prevEngram !== undefined) process.env.ENGRAM_PROVENANCE_ENABLED = prevEngram;
+  }
+});
+
+test("parseConfig provenance.enabled coerces boolean-like strings and rejects garbage (issue #1575)", () => {
+  for (const v of [true, "true", "1", "yes", "on"] as const) {
+    const result = parseConfig({ provenance: { enabled: v } });
+    assert.equal(result.provenance.enabled, true, `enabled ${JSON.stringify(v)} -> true`);
+  }
+  for (const v of [false, "false", "0", "no", "off"] as const) {
+    const result = parseConfig({ provenance: { enabled: v } });
+    assert.equal(result.provenance.enabled, false, `enabled ${JSON.stringify(v)} -> false`);
+  }
+  assert.throws(
+    () => parseConfig({ provenance: { enabled: "definitely" } }),
+    /provenance\.enabled/,
+  );
+});
+
+test("parseConfig provenance.maxQuoteChars rejects present-but-invalid (issue #1575)", () => {
+  assert.equal(parseConfig({ provenance: { maxQuoteChars: 500 } }).provenance.maxQuoteChars, 500);
+  // String coercion (CLI --config style).
+  assert.equal(parseConfig({ provenance: { maxQuoteChars: "150" } }).provenance.maxQuoteChars, 150);
+  // Omitted key uses the documented default.
+  assert.equal(parseConfig({}).provenance.maxQuoteChars, 300);
+  // Present-but-invalid values are rejected loudly (review thread 3 / AGENTS.md input-validation).
+  for (const v of [0, -5, "garbage", 3.7, Infinity, null] as unknown[]) {
+    assert.throws(
+      () => parseConfig({ provenance: { maxQuoteChars: v } }),
+      /provenance\.maxQuoteChars must be a positive integer/,
+    );
+  }
+});
+
+test("parseConfig provenance.requireSpans defaults false and coerces (issue #1575)", () => {
+  assert.equal(parseConfig({}).provenance.requireSpans, false);
+  assert.equal(parseConfig({ provenance: { requireSpans: true } }).provenance.requireSpans, true);
+  assert.equal(parseConfig({ provenance: { requireSpans: "true" } }).provenance.requireSpans, true);
+  assert.equal(parseConfig({ provenance: { requireSpans: "no" } }).provenance.requireSpans, false);
+  // Present-but-invalid values are rejected loudly (review thread 2 / AGENTS.md input-validation).
+  assert.throws(
+    () => parseConfig({ provenance: { requireSpans: "treu" } }),
+    /provenance\.requireSpans must be a boolean/,
+  );
+});
+
+test("parseConfig provenance non-object shape rejects loudly (issue #1575)", () => {
+  for (const v of [false, null, "true", 0, []] as unknown[]) {
+    assert.throws(
+      () => parseConfig({ provenance: v } as Record<string, unknown>),
+      /provenance must be an object/,
+    );
+  }
+});
+
+test("parseConfig provenance.enabled honors REMNIC_/ENGRAM_ env fallback (issue #1575)", () => {
+  const prevR = process.env.REMNIC_PROVENANCE_ENABLED;
+  const prevE = process.env.ENGRAM_PROVENANCE_ENABLED;
+  delete process.env.REMNIC_PROVENANCE_ENABLED;
+  delete process.env.ENGRAM_PROVENANCE_ENABLED;
+  try {
+    process.env.ENGRAM_PROVENANCE_ENABLED = "off";
+    assert.equal(parseConfig({}).provenance.enabled, false, "ENGRAM_ fallback flips to false");
+    delete process.env.ENGRAM_PROVENANCE_ENABLED;
+    process.env.REMNIC_PROVENANCE_ENABLED = "yes";
+    assert.equal(parseConfig({}).provenance.enabled, true, "REMNIC_ takes precedence");
+    process.env.ENGRAM_PROVENANCE_ENABLED = "off";
+    assert.equal(
+      parseConfig({}).provenance.enabled,
+      true,
+      "REMNIC_ wins over ENGRAM_ when both set",
+    );
+    delete process.env.REMNIC_PROVENANCE_ENABLED;
+    delete process.env.ENGRAM_PROVENANCE_ENABLED;
+    // Explicit config wins over env.
+    process.env.REMNIC_PROVENANCE_ENABLED = "off";
+    assert.equal(
+      parseConfig({ provenance: { enabled: true } }).provenance.enabled,
+      true,
+      "explicit config beats env",
+    );
+  } finally {
+    if (prevR !== undefined) process.env.REMNIC_PROVENANCE_ENABLED = prevR;
+    else delete process.env.REMNIC_PROVENANCE_ENABLED;
+    if (prevE !== undefined) process.env.ENGRAM_PROVENANCE_ENABLED = prevE;
+    else delete process.env.ENGRAM_PROVENANCE_ENABLED;
+  }
+});

package/src/config.ts

@@ -45,6 +45,7 @@ import {
   resolveNamespaceCatalogEnabled,
 } from "./emit-legacy-tools.js";
 import { parseWearablesConfig } from "./wearables/config.js";
+import { parseProvenanceConfig } from "./provenance.js";
 import { parseCodingKnowledgeConfig } from "./coding/coding-knowledge-config.js";
 const DEFAULT_MEMORY_DIR = path.join(
   resolveHomeDir(),
@@ -1471,18 +1472,16 @@ export function parseConfig(
     recallMaxProcedures,
   };
 
-  // Wearable transcript ingestion (Limitless / Bee / Omi). Parsing is
-  // delegated to the wearables module; it follows the same loud-reject
-  // conventions as the `procedural` block above.
+  // Wearable transcript ingestion (Limitless / Bee / Omi) — delegated to the wearables module.
   const wearables = parseWearablesConfig(cfg.wearables);
 
+  const provenance = parseProvenanceConfig(cfg.provenance);
   // Coding-agent project/branch scoping (issue #569)
   const rawCodingMode =
     cfg.codingMode && typeof cfg.codingMode === "object" && !Array.isArray(cfg.codingMode)
       ? (cfg.codingMode as Record<string, unknown>)
       : {};
-  // Default: projectScope=true (enabled), branchScope=false (opt-in).
-  // `coerceBool` treats "false"/"0"/"no"/"off" as false (CLAUDE.md #36).
+  // Default: projectScope=true, branchScope=false (opt-in; CLAUDE.md #36).
   const codingProjectScopeRaw = coerceBool(rawCodingMode.projectScope);
   const codingBranchScopeRaw = coerceBool(rawCodingMode.branchScope);
   const codingGlobalFallbackRaw = coerceBool(rawCodingMode.globalFallback);
@@ -2431,6 +2430,7 @@ export function parseConfig(
     dreamsPhases,
     procedural,
     wearables,
+    provenance,
     // At-rest encryption (issue #690 PR 3/4)
     // coerceBool handles CLI string inputs: `--config secureStoreEnabled=true`
     // arrives as the string "true" which `=== true` would reject (CLAUDE.md #36).