@remnic/core 9.3.701 → 9.3.702

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export { PluginEntryResolverOptions, resolvePluginEntry } from './plugin-entry-resolver.js';
 export { isOpenaiApiKeyDisabled, parseConfig, resolveEnvVars } from './config.js';
 export { MigrationOptions, MigrationResult, RollbackResult, migrateFromEngram, rollbackFromEngramMigration } from './migrate/from-engram.js';
-import { S as SpeakerRegistry, W as WearablesService } from './orchestrator-BzMCZlKn.js';
-export { D as DEFAULT_SELF_NAME, O as Orchestrator, R as ResolvedSpeaker, a as SpeakerOverride, b as WEARABLE_SOURCE_PREFIX, c as WearableDayTranscriptView, d as WearableMemoryGenDeps, e as WearableMemoryGenResult, f as WearableMemorySearchResult, g as WearableMemoryWriter, h as WearableSearchBackend, i as WearableStorageIo, j as WearableSyncDeps, k as WearableSyncOptions, l as WearableTranscriptSearchResult, m as WearablesServiceDeps, n as buildExtractionTurns, o as dateInTimezone, p as defaultTimezone, q as defaultWorkspaceDir, r as distinctSpeakerLabels, s as emptySpeakerRegistry, t as generateWearableMemories, u as importNativeMemories, v as loadSpeakerRegistry, w as locateTranscriptPath, x as memoryStatusForMode, y as resolveSpeaker, z as resolveSyncDates, A as sanitizeSessionKeyForFilename, B as saveSpeakerRegistry, C as speakerRegistryKey, E as speakersFilePath, F as syncWearableSource, H as wearableDayTag, J as wearableSourceLabel, K as writeDailyDigestMemory } from './orchestrator-BzMCZlKn.js';
+import { S as SpeakerRegistry, W as WearablesService } from './orchestrator-C9CDWAm6.js';
+export { D as DEFAULT_SELF_NAME, O as Orchestrator, R as ResolvedSpeaker, a as SpeakerOverride, b as WEARABLE_SOURCE_PREFIX, c as WearableDayTranscriptView, d as WearableMemoryGenDeps, e as WearableMemoryGenResult, f as WearableMemorySearchResult, g as WearableMemoryWriter, h as WearableSearchBackend, i as WearableStorageIo, j as WearableSyncDeps, k as WearableSyncOptions, l as WearableTranscriptSearchResult, m as WearablesServiceDeps, n as buildExtractionTurns, o as dateInTimezone, p as defaultTimezone, q as defaultWorkspaceDir, r as distinctSpeakerLabels, s as emptySpeakerRegistry, t as generateWearableMemories, u as importNativeMemories, v as loadSpeakerRegistry, w as locateTranscriptPath, x as memoryStatusForMode, y as resolveSpeaker, z as resolveSyncDates, A as sanitizeSessionKeyForFilename, B as saveSpeakerRegistry, C as speakerRegistryKey, E as speakersFilePath, F as syncWearableSource, H as wearableDayTag, J as wearableSourceLabel, K as writeDailyDigestMemory } from './orchestrator-C9CDWAm6.js';
 export { normalizeProjectionPreview, normalizeProjectionTags } from './memory-projection-format.js';
 export { ModelCapabilities, ModelRegistry } from './model-registry.js';
 export { ACTIVE_STATUSES, ContradictionFilter, ContradictionJudgeBatchResult, ContradictionJudgeInput, ContradictionJudgeResult, ContradictionListResult, ContradictionVerdict, ResolutionResult, ResolutionVerb, ScanDependencies, ScanResult, computePairId, executeResolution, isCoolingDown, isValidResolutionVerb, judgeContradictionPairs, listPairs, readPair, resolvePair, runContradictionScan, writePair, writePairs } from './contradiction/index.js';
@@ -20,11 +20,11 @@ export { CodexCliFallbackConfig, CodexCliFallbackMessage, CodexCliFallbackOption
 export { BufferSurpriseProbe, SmartBuffer, TriggerDecision } from './buffer.js';
 export { ComputeSurpriseOptions, DEFAULT_SURPRISE_K, RecentMemoryLike, computeSurprise } from './buffer-surprise.js';
 export { BufferSurpriseDistribution, BufferSurpriseReader, BufferSurpriseReportOptions, reportBufferSurpriseDistribution } from './buffer-surprise-report.js';
-import { aL as CodingContext, aQ as CodingModeConfig, P as PluginConfig, M as MemoryCategory, aR as WearableCleanupSettings, aC as WearableSourceSettings, aG as WearablesConfig, aF as WearableSourceConnector, aB as WearableConversation, aK as WearableCorrectionRule, aS as WearableDayTranscriptMeta, aJ as WearableDayTranscript } from './types-PuiPZ9iE.js';
-export { J as AgentAccessAuthToken, r as BriefingActiveThread, aT as BriefingConfig, p as BriefingFocus, o as BriefingFollowup, aU as BriefingOpenCommitment, t as BriefingRecentEntity, s as BriefingResult, n as BriefingSections, aV as BriefingWindow, z as BufferSurpriseEvent, q as CalendarEvent, C as CalendarSource, aW as CodexCompatConfig, aO as ConsolidationObservation, a6 as ContinuityImprovementLoop, aX as DEFAULT_RECALL_DISCLOSURE, E as EntityFile, $ as EntityStructuredSection, aY as ExtractedFact, G as GatewayConfig, ac as MemoryActionEligibilityContext, aZ as MemoryActionEligibilitySource, U as MemoryActionType, g as MemoryFile, k as MemoryFrontmatter, a_ as MemoryObservation, a$ as MemoryScope, b0 as RECALL_DISCLOSURE_LEVELS, j as RecallDisclosure, D as SecretRef, b1 as WearableAuthCheck, b2 as WearableFetchOptions, b3 as WearableFetchPage, aE as WearableMemoryMode, aD as WearableNativeMemory, b4 as WearableNativeMemoryPage, aI as WearableSourceStatus, aH as WearableSyncSummary, b5 as WearableTranscriptSegment, b6 as isRecallDisclosure } from './types-PuiPZ9iE.js';
+import { aG as CodingContext, aR as CodingModeConfig, P as PluginConfig, M as MemoryCategory, aS as WearableCleanupSettings, ax as WearableSourceSettings, aB as WearablesConfig, aA as WearableSourceConnector, aw as WearableConversation, aF as WearableCorrectionRule, aT as WearableDayTranscriptMeta, aE as WearableDayTranscript } from './types-MWKPZnM0.js';
+export { J as AgentAccessAuthToken, r as BriefingActiveThread, aU as BriefingConfig, p as BriefingFocus, o as BriefingFollowup, aV as BriefingOpenCommitment, t as BriefingRecentEntity, s as BriefingResult, n as BriefingSections, aW as BriefingWindow, z as BufferSurpriseEvent, q as CalendarEvent, C as CalendarSource, aX as CodexCompatConfig, aJ as ConsolidationObservation, a6 as ContinuityImprovementLoop, aY as DEFAULT_RECALL_DISCLOSURE, E as EntityFile, $ as EntityStructuredSection, aZ as ExtractedFact, G as GatewayConfig, ac as MemoryActionEligibilityContext, a_ as MemoryActionEligibilitySource, U as MemoryActionType, g as MemoryFile, k as MemoryFrontmatter, a$ as MemoryObservation, b0 as MemoryScope, b1 as RECALL_DISCLOSURE_LEVELS, j as RecallDisclosure, D as SecretRef, b2 as WearableAuthCheck, b3 as WearableFetchOptions, b4 as WearableFetchPage, az as WearableMemoryMode, ay as WearableNativeMemory, b5 as WearableNativeMemoryPage, aD as WearableSourceStatus, aC as WearableSyncSummary, b6 as WearableTranscriptSegment, b7 as isRecallDisclosure } from './types-MWKPZnM0.js';
 export { JudgeBatchResult, JudgeCandidate, JudgeVerdict, JudgeVerdictKind, clearVerdictCache, createVerdictCache, getVerdictKind, isDurableVerdict, isValidCachedVerdict, judgeFactDurability, normalizeCachedVerdict, verdictCacheSize } from './extraction-judge.js';
 export { hasBroadGraphIntent, inferIntentFromText, intentCompatibilityScore, isTaskInitiationIntent, planRecallMode } from './intent.js';
-export { i as EngramAccessInputError, g as EngramAccessService, P as ProcedureStatsConfigSnapshot, j as ProcedureStatsRecent, k as ProcedureStatsReport, l as ProcedureStatusCounts, m as computeProcedureStats, n as formatProcedureStatsText } from './access-service-CGVWK6lZ.js';
+export { i as EngramAccessInputError, g as EngramAccessService, P as ProcedureStatsConfigSnapshot, j as ProcedureStatsRecent, k as ProcedureStatsReport, l as ProcedureStatusCounts, m as computeProcedureStats, n as formatProcedureStatsText } from './access-service-COCzhgEL.js';
 export { FILTER_LABELS as DIRECT_ANSWER_FILTER_LABELS, DirectAnswerCandidate, DirectAnswerConfig, DirectAnswerInput, DirectAnswerReason, DirectAnswerResult, isDirectAnswerEligible } from './direct-answer.js';
 export { MemoryTier, TierRoutingPolicy, TierTransitionDecision, computeTierValueScore, decideTierTransition } from './tier-routing.js';
 export { ApplyReasoningTraceBoostOptions, BoostableResult, DEFAULT_REASONING_TRACE_BOOST, applyReasoningTraceBoost, isReasoningTracePath, looksLikeProblemSolvingQuery } from './reasoning-trace-recall.js';
@@ -38,7 +38,7 @@ export { OramaBackend } from './search/orama-backend.js';
 export { MeilisearchBackend } from './search/meilisearch-backend.js';
 export { buildEntityRecallSection } from './entity-retrieval.js';
 export { resolvePrincipal } from './namespaces/principal.js';
-export { N as NamespaceCatalog, b as NamespaceCatalogFilter, c as NamespaceCatalogRebuildResult, d as NamespaceCatalogSkippedRoot, e as NamespaceDiscoverySource, a as NamespaceKind, f as NamespaceRecord, g as NamespaceTouchMetadata } from './catalog-DBIghceA.js';
+export { N as NamespaceCatalog, c as NamespaceCatalogFilter, d as NamespaceCatalogRebuildResult, e as NamespaceCatalogSkippedRoot, f as NamespaceDiscoverySource, a as NamespaceKind, b as NamespaceRecord, g as NamespaceTouchMetadata } from './catalog-DxCzhjE6.js';
 export { SESSION_CHANNEL_TYPE, SessionIdentity, SessionStoragePaths, legacyParserReadbackDir, parseSessionIdentity, sessionStoragePaths } from './session-identity.js';
 export { storagePathHash } from './storage-paths.js';
 export { TrustZoneName, TrustZoneRecord, TrustZoneRecordKind, TrustZoneSourceClass, isTrustZoneName } from './trust-zones.js';
@@ -60,10 +60,10 @@ export { CODEX_THREAD_KEY_PREFIX } from './thread-key.js';
 export { PageVersion, VersionHistory, VersionTrigger, VersioningConfig, VersioningLogger, createVersion, diffVersions, getVersion, listVersions, revertToVersion } from './page-versioning.js';
 export { CitationBlock, CitationEntry, CitationMetadata, buildCitationGuidance, formatOaiMemCitation, parseOaiMemCitation, sanitizeNoteForCitation } from './citations.js';
 export { initLogger, log } from './logger.js';
-export { b as SemanticDedupDecision, a as SemanticDedupHit, S as SemanticDedupLookup, c as SemanticDedupOptions, d as decideSemanticDedup } from './semantic-DJR8_DMQ.js';
+export { b as SemanticDedupDecision, S as SemanticDedupHit, a as SemanticDedupLookup, c as SemanticDedupOptions, d as decideSemanticDedup } from './semantic-SLAa_prH.js';
 export { OFFLINE_SYNC_APPLY_MAX_BODY_BYTES, OFFLINE_SYNC_CHANGESET_FORMAT, OFFLINE_SYNC_FILE_CONTENT_MAX_CHUNK_BYTES, OFFLINE_SYNC_FILE_CONTENT_TRANSFER_CHUNK_BYTES, OFFLINE_SYNC_SNAPSHOT_BASE_MAX_BODY_BYTES, OFFLINE_SYNC_SNAPSHOT_FORMAT, OFFLINE_SYNC_STATE_VERSION, OfflineSyncApplyChangesetResult, OfflineSyncApplyFileContentChunkResult, OfflineSyncApplySnapshotResult, OfflineSyncChange, OfflineSyncChangeset, OfflineSyncConflict, OfflineSyncFileContentChunk, OfflineSyncFileDigest, OfflineSyncFileRecord, OfflineSyncFileState, OfflineSyncFileTarget, OfflineSyncFileWriteTarget, OfflineSyncSnapshot, OfflineSyncState, applyOfflineSyncChangeset, applyOfflineSyncFileContentChunk, applyOfflineSyncSnapshot, buildOfflineSyncChangeset, buildOfflineSyncChangesetFromSnapshot, buildOfflineSyncSnapshot, buildOfflineSyncSnapshotForPaths, buildOfflineSyncSnapshotFromBase, defaultOfflineSyncStatePath, fileStatesFromSnapshot, iterateOfflineSyncSnapshotFileRecords, normalizeOfflineSyncChangeset, normalizeOfflineSyncSnapshot, offlineSyncStateFromSnapshot, readOfflineSyncFileContentChunk, readOfflineSyncState, shouldPreferIncomingOfflineRuntimeFile, summarizeOfflineSyncChangeset, summarizeOfflineSyncPendingChanges, summarizeOfflineSyncPendingFiles, writeOfflineSyncState } from './offline-sync.js';
-import { D as DiscoveredExtension } from './semantic-consolidation-BtUfv-AL.js';
-export { E as ExtensionSchema, R as REMNIC_EXTENSIONS_TOTAL_TOKEN_LIMIT, b as buildExtensionsBlockForConsolidation, d as discoverMemoryExtensions, r as resolveExtensionsRoot } from './semantic-consolidation-BtUfv-AL.js';
+import { D as DiscoveredExtension } from './semantic-consolidation-DgFXyALl.js';
+export { E as ExtensionSchema, R as REMNIC_EXTENSIONS_TOTAL_TOKEN_LIMIT, b as buildExtensionsBlockForConsolidation, d as discoverMemoryExtensions, r as resolveExtensionsRoot } from './semantic-consolidation-DgFXyALl.js';
 export { ConnectorCapability, ConnectorInstance, ConnectorManifest, ConnectorRegistry, DoctorCheck, DoctorResult, InstallOptions, InstallResult, MARKETPLACE_MANIFEST_FILENAME, MARKETPLACE_SCHEMA_VERSION, MarketplaceConfig, MarketplaceEntry, MarketplaceInstallResult, MarketplaceInstallType, MarketplaceLogger, MarketplaceManifest, MarketplaceValidation, RemoveResult, checkMarketplaceManifest, coerceInstallExtension, doctorConnector, generateMarketplaceManifest, getConnectorToken, installConnector, installFromMarketplace, listConnectors, loadRegistry, removeConnector, saveRegistry, validateMarketplaceManifest, writeMarketplaceManifest } from './connectors/index.js';
 import { L as LiveConnector, S as SyncIncrementalResult } from './framework-CNDn2164.js';
 export { c as CONNECTOR_ID_PATTERN, C as ConnectorConfig, b as ConnectorCursor, a as ConnectorDocument, d as ConnectorDocumentSource, e as SyncIncrementalArgs, i as isValidConnectorId, p as persistableConnectorConfig, r as redactConnectorConfigSecrets } from './framework-CNDn2164.js';
@@ -79,7 +79,7 @@ export { EnrichmentAuditEntry, EnrichmentCandidate, EnrichmentCostTier, Enrichme
 export { d as BulkImportError, B as BulkImportOptions, b as BulkImportResult, a as BulkImportSource, e as BulkImportSourceAdapter, f as ImportSourceRole, I as ImportTurn, g as ImportTurnValidationIssue, i as isImportRole, p as parseIsoTimestamp, v as validateImportTurn } from './types-ByK7T3L6.js';
 export { clearBulkImportSources, getBulkImportSource, listBulkImportSources, registerBulkImportSource } from './bulk-import/index.js';
 export { a as ProcessBatchContext, P as ProcessBatchFn, b as ProcessBatchResult, f as formatBatchTranscript, r as resolveBulkImportContext, c as runBulkImportPipeline, v as validateBatchSize } from './pipeline-BSTuml0d.js';
-export { B as BulkImportCliCommandOptions, p as parseStrictCliDate, r as runBulkImportCliCommand } from './cli-D3XeenwN.js';
+export { B as BulkImportCliCommandOptions, p as parseStrictCliDate, r as runBulkImportCliCommand } from './cli-BM4xQPp4.js';
 export { DEFAULT_IMPORT_BATCH_SIZE, ImportProgress, ImportedMemory, ImporterAdapter, ImporterParseOptions, ImporterTransformOptions, ImporterWriteResult, ImporterWriteTarget, RunImportOptions, RunImporterResult, defaultWriteMemoriesToOrchestrator, importedMemoryToTurn, runImporter, validateImportBatchSize, validateImportRateLimit } from './importers/index.js';
 export { FallbackLlmClient, FallbackLlmOptions, FallbackLlmResponse, FallbackLlmRuntimeContext } from './fallback-llm.js';
 export { ComputeMemoryWorthInput, MemoryWorthResult, computeMemoryWorth } from './memory-worth.js';
@@ -172,6 +172,119 @@ import './utility-learner.js';
 import './resume-bundles.js';
 import './semantic-rule-promotion.js';
 
+/**
+ * Coding-agent namespace overlay (issue #569 PR 2 + PR 3).
+ *
+ * Given a `CodingContext` (from `resolveGitContext`) and a `CodingModeConfig`,
+ * returns the namespace that recall + write paths should use — or `null` when
+ * no overlay should apply (coding mode disabled, no context supplied, or
+ * feature flags off).
+ *
+ * PR 2 ships the project overlay. PR 3 will add the branch overlay; the
+ * function here already handles both flags so the schema / types / plumbing
+ * don't have to change a second time when branch-scope lands.
+ *
+ * Pure function — no orchestrator, no config side-effects. Callers keep rule
+ * 42 (read + write through same namespace layer) by consulting the same
+ * function on both paths.
+ */
+
+interface CodingNamespaceOverlay {
+    /**
+     * Effective namespace to use for this session's memory operations. When
+     * `branchScope` is on, takes the form `project:<id>/branch:<b>`; otherwise
+     * `project:<id>`.
+     */
+    namespace: string;
+    /**
+     * Read fallbacks — additional namespaces a caller should include in recall
+     * so that, for example, a branch-scoped session still sees project-level
+     * memories that were written before the branch scope was enabled.
+     *
+     * Writes MUST go to `namespace` only; these are read-side only.
+     *
+     * Introduced to carry PR 3's branch→project fallback; PR 2 returns an empty
+     * array here.
+     */
+    readFallbacks: string[];
+    /**
+     * `"project"` when only project scope applies, `"branch"` when branch scope
+     * is also layered on. Used for diagnostics (`remnic doctor`) and logging.
+     */
+    scope: "project" | "branch";
+}
+/**
+ * Produce the project-scope namespace name. Exported for tests and for
+ * `remnic doctor` to render. Guaranteed to satisfy `isSafeRouteNamespace`:
+ * no `/`, no `:`, lowercase only, length-capped to 64 chars.
+ */
+declare function projectNamespaceName(projectId: string): string;
+/**
+ * Produce the branch-scope namespace name. Format:
+ * `project-<id>-branch-<name>[-<hash>]`. Uses `-` as the structural separator
+ * rather than `/` or `:` so the result is a single safe route-namespace
+ * token that can be used directly as a filesystem directory.
+ *
+ * Two failure modes must not collapse distinct branches to one namespace:
+ *
+ *   1. Sanitization is lossy (`feat/x` and `feat-x` both sanitize to
+ *      `feat-x`; `Feature` and `feature` both sanitize to `feature`). When
+ *      sanitization rewrote any character, we append a short hash of the
+ *      RAW branch so distinct inputs stay distinct.
+ *   2. Truncation is applied when the total exceeds 64 chars. In that
+ *      mode `capLength` appends its own hash of the full pre-truncated
+ *      value.
+ *
+ * Long branches that also sanitize may receive both kinds of hashes — that
+ * is acceptable: the router only requires the result be unique and
+ * deterministic, and the two hashes derive from different domains so they
+ * don't conflict.
+ */
+declare function branchNamespaceName(projectId: string, branch: string): string;
+/**
+ * Compute the namespace overlay for a session.
+ *
+ * Returns `null` when no overlay applies — callers should then use their
+ * existing `defaultNamespaceForPrincipal(...)` result unchanged. This keeps
+ * CLAUDE.md #30 (escape hatch): setting `codingMode.projectScope: false`
+ * exactly restores pre-#569 behaviour at every call site.
+ *
+ * @param codingContext — git context from the connector
+ * @param config — coding mode flags (projectScope, branchScope, globalFallback)
+ * @param defaultNamespace — retained for call-site compatibility; no longer
+ *   used. The global fallback is expressed as an empty-string sentinel in
+ *   `readFallbacks`, which `combineNamespaces(principal, "")` resolves to the
+ *   principal's own namespace at the call site.
+ */
+declare function resolveCodingNamespaceOverlay(codingContext: CodingContext | null | undefined, config: Pick<CodingModeConfig, "projectScope" | "branchScope" | "globalFallback">, defaultNamespace?: string): CodingNamespaceOverlay | null;
+interface CodingScopeDescription {
+    /** "none" when no overlay is active; otherwise the resolved scope level. */
+    scope: "none" | "project" | "branch";
+    /** Project id (raw, not sanitized) when a context is attached. */
+    projectId: string | null;
+    /** Branch name (raw, not sanitized) when available. */
+    branch: string | null;
+    /** Effective namespace writes route to. `null` when no overlay applies. */
+    effectiveNamespace: string | null;
+    /** Read fallbacks included in recall (non-empty only when branch-scope is on). */
+    readFallbacks: string[];
+    /**
+     * Why no overlay applies, when `scope === "none"`. One of:
+     *   - `"no-context"`  — connector didn't attach a CodingContext
+     *   - `"disabled"`   — codingMode.projectScope is false
+     *   - `"empty-project"` — codingContext.projectId was empty/whitespace
+     */
+    disabledReason: "no-context" | "disabled" | "empty-project" | null;
+}
+/**
+ * Human-readable description of the coding-agent scope that currently applies
+ * for a session. Consumed by `remnic doctor` (PR 8) and by logs to surface
+ * why recall routes where it does.
+ *
+ * Pure — callers pass the coding context + config they already have.
+ */
+declare function describeCodingScope(codingContext: CodingContext | null | undefined, config: Pick<CodingModeConfig, "projectScope" | "branchScope" | "globalFallback">, defaultNamespace?: string): CodingScopeDescription;
+
 /**
  * @remnic/core — Live Connectors Registry (issue #683 PR 1/N)
  *
@@ -532,119 +645,6 @@ declare function renderExtensionsBlock(extensions: DiscoveredExtension[]): strin
  */
 declare function renderExtensionsFooter(extensions: DiscoveredExtension[]): string;
 
-/**
- * Coding-agent namespace overlay (issue #569 PR 2 + PR 3).
- *
- * Given a `CodingContext` (from `resolveGitContext`) and a `CodingModeConfig`,
- * returns the namespace that recall + write paths should use — or `null` when
- * no overlay should apply (coding mode disabled, no context supplied, or
- * feature flags off).
- *
- * PR 2 ships the project overlay. PR 3 will add the branch overlay; the
- * function here already handles both flags so the schema / types / plumbing
- * don't have to change a second time when branch-scope lands.
- *
- * Pure function — no orchestrator, no config side-effects. Callers keep rule
- * 42 (read + write through same namespace layer) by consulting the same
- * function on both paths.
- */
-
-interface CodingNamespaceOverlay {
-    /**
-     * Effective namespace to use for this session's memory operations. When
-     * `branchScope` is on, takes the form `project:<id>/branch:<b>`; otherwise
-     * `project:<id>`.
-     */
-    namespace: string;
-    /**
-     * Read fallbacks — additional namespaces a caller should include in recall
-     * so that, for example, a branch-scoped session still sees project-level
-     * memories that were written before the branch scope was enabled.
-     *
-     * Writes MUST go to `namespace` only; these are read-side only.
-     *
-     * Introduced to carry PR 3's branch→project fallback; PR 2 returns an empty
-     * array here.
-     */
-    readFallbacks: string[];
-    /**
-     * `"project"` when only project scope applies, `"branch"` when branch scope
-     * is also layered on. Used for diagnostics (`remnic doctor`) and logging.
-     */
-    scope: "project" | "branch";
-}
-/**
- * Produce the project-scope namespace name. Exported for tests and for
- * `remnic doctor` to render. Guaranteed to satisfy `isSafeRouteNamespace`:
- * no `/`, no `:`, lowercase only, length-capped to 64 chars.
- */
-declare function projectNamespaceName(projectId: string): string;
-/**
- * Produce the branch-scope namespace name. Format:
- * `project-<id>-branch-<name>[-<hash>]`. Uses `-` as the structural separator
- * rather than `/` or `:` so the result is a single safe route-namespace
- * token that can be used directly as a filesystem directory.
- *
- * Two failure modes must not collapse distinct branches to one namespace:
- *
- *   1. Sanitization is lossy (`feat/x` and `feat-x` both sanitize to
- *      `feat-x`; `Feature` and `feature` both sanitize to `feature`). When
- *      sanitization rewrote any character, we append a short hash of the
- *      RAW branch so distinct inputs stay distinct.
- *   2. Truncation is applied when the total exceeds 64 chars. In that
- *      mode `capLength` appends its own hash of the full pre-truncated
- *      value.
- *
- * Long branches that also sanitize may receive both kinds of hashes — that
- * is acceptable: the router only requires the result be unique and
- * deterministic, and the two hashes derive from different domains so they
- * don't conflict.
- */
-declare function branchNamespaceName(projectId: string, branch: string): string;
-/**
- * Compute the namespace overlay for a session.
- *
- * Returns `null` when no overlay applies — callers should then use their
- * existing `defaultNamespaceForPrincipal(...)` result unchanged. This keeps
- * CLAUDE.md #30 (escape hatch): setting `codingMode.projectScope: false`
- * exactly restores pre-#569 behaviour at every call site.
- *
- * @param codingContext — git context from the connector
- * @param config — coding mode flags (projectScope, branchScope, globalFallback)
- * @param defaultNamespace — retained for call-site compatibility; no longer
- *   used. The global fallback is expressed as an empty-string sentinel in
- *   `readFallbacks`, which `combineNamespaces(principal, "")` resolves to the
- *   principal's own namespace at the call site.
- */
-declare function resolveCodingNamespaceOverlay(codingContext: CodingContext | null | undefined, config: Pick<CodingModeConfig, "projectScope" | "branchScope" | "globalFallback">, defaultNamespace?: string): CodingNamespaceOverlay | null;
-interface CodingScopeDescription {
-    /** "none" when no overlay is active; otherwise the resolved scope level. */
-    scope: "none" | "project" | "branch";
-    /** Project id (raw, not sanitized) when a context is attached. */
-    projectId: string | null;
-    /** Branch name (raw, not sanitized) when available. */
-    branch: string | null;
-    /** Effective namespace writes route to. `null` when no overlay applies. */
-    effectiveNamespace: string | null;
-    /** Read fallbacks included in recall (non-empty only when branch-scope is on). */
-    readFallbacks: string[];
-    /**
-     * Why no overlay applies, when `scope === "none"`. One of:
-     *   - `"no-context"`  — connector didn't attach a CodingContext
-     *   - `"disabled"`   — codingMode.projectScope is false
-     *   - `"empty-project"` — codingContext.projectId was empty/whitespace
-     */
-    disabledReason: "no-context" | "disabled" | "empty-project" | null;
-}
-/**
- * Human-readable description of the coding-agent scope that currently applies
- * for a session. Consumed by `remnic doctor` (PR 8) and by logs to surface
- * why recall routes where it does.
- *
- * Pure — callers pass the coding context + config they already have.
- */
-declare function describeCodingScope(codingContext: CodingContext | null | undefined, config: Pick<CodingModeConfig, "projectScope" | "branchScope" | "globalFallback">, defaultNamespace?: string): CodingScopeDescription;
-
 /**
  * Strict UTC-only parser — accepts `YYYY-MM-DDTHH:MM:SS[.sss]Z`.
  * Returns milliseconds since epoch, or `null` if invalid.

package/dist/index.js

@@ -43,7 +43,7 @@ import {
   saveRegistry,
   validateMarketplaceManifest,
   writeMarketplaceManifest
-} from "./chunk-ED35D32I.js";
+} from "./chunk-LQ4J7ELC.js";
 import "./chunk-V5OCT34X.js";
 import {
   executeResolution,
@@ -94,7 +94,7 @@ import {
   registerTrainingExportAdapter,
   runBulkImportCliCommand,
   runWearablesCliCommand
-} from "./chunk-HXHKLVAS.js";
+} from "./chunk-ZCEI242W.js";
 import "./chunk-MC4FJXPA.js";
 import "./chunk-LQHDIS7L.js";
 import "./chunk-7F7Z6MOS.js";
@@ -113,8 +113,8 @@ import "./chunk-HOJZMQ4J.js";
 import "./chunk-EEC4PCG5.js";
 import "./chunk-PYIFUBRK.js";
 import "./chunk-D6RIFG4O.js";
-import "./chunk-6W2D6FGG.js";
-import "./chunk-27LQPUMZ.js";
+import "./chunk-TGAHHCB6.js";
+import "./chunk-EOOVJK2U.js";
 import "./chunk-KJTKLXTH.js";
 import "./chunk-LZZNTPLR.js";
 import "./chunk-JCK7V6SN.js";
@@ -135,23 +135,22 @@ import {
   validateImportTurn
 } from "./chunk-OUELRE5E.js";
 import "./chunk-GQL52GQ5.js";
-import "./chunk-IQ7WCZRW.js";
-import "./chunk-IYOPIG3E.js";
+import "./chunk-IX72AAMZ.js";
 import {
   clearAuthTokenSecretCache,
   isAgentAccessSecretRef,
   resolveAgentAccessAuthToken
 } from "./chunk-TGQ2NTWH.js";
-import "./chunk-T5QAZIBO.js";
+import "./chunk-MOXFPLD6.js";
 import {
   parseXrayBudgetFlag,
   parseXrayCliOptions
-} from "./chunk-IJEZMWKA.js";
+} from "./chunk-SFOAQQDJ.js";
 import {
   parseStrictCliDate
 } from "./chunk-3T74IZB3.js";
-import "./chunk-ZYNMX6IU.js";
-import "./chunk-DEDQXIDL.js";
+import "./chunk-NUIJEGVD.js";
+import "./chunk-JTKFZMZ7.js";
 import "./chunk-HL4DB7TO.js";
 import "./chunk-7XH7VJN4.js";
 import "./chunk-YNDLCWXS.js";
@@ -168,8 +167,7 @@ import {
 import {
   getMemoryForActiveMemory,
   recallForActiveMemory
-} from "./chunk-NINRTFSV.js";
-import "./chunk-6MKAMLQL.js";
+} from "./chunk-SINGJCUR.js";
 import {
   DEFAULT_TAXONOMY,
   Orchestrator,
@@ -191,7 +189,7 @@ import {
   saveTaxonomy,
   validateSlug,
   validateTaxonomy
-} from "./chunk-4HIAWLA2.js";
+} from "./chunk-XGMCUY5P.js";
 import {
   WEARABLE_SOURCE_PREFIX,
   buildExtractionTurns,
@@ -219,7 +217,7 @@ import {
   migrateFromEngram,
   rollbackFromEngramMigration
 } from "./chunk-7HYPN2GC.js";
-import "./chunk-ZT7B64BE.js";
+import "./chunk-6TAETM63.js";
 import "./chunk-666A3MOW.js";
 import "./chunk-HHLLAQGZ.js";
 import "./chunk-X5J3JZR3.js";
@@ -235,7 +233,7 @@ import "./chunk-UWK5OXUJ.js";
 import "./chunk-O7GOFAM3.js";
 import "./chunk-MDJURR27.js";
 import "./chunk-7N4KAIGN.js";
-import "./chunk-MNU5G4TK.js";
+import "./chunk-Z7XEIAV4.js";
 import "./chunk-UFS7OXGL.js";
 import "./chunk-TECVW3JP.js";
 import "./chunk-UHGBNIOS.js";
@@ -254,12 +252,12 @@ import "./chunk-3FAMU5TX.js";
 import {
   buildTargetedFactRecallSection,
   shouldRecallTargetedFactEvidence
-} from "./chunk-R5DB26G6.js";
+} from "./chunk-4SBW47WK.js";
 import "./chunk-DKTSR7EK.js";
 import {
   buildResponseGuidanceRecallSection,
   shouldRecallResponseGuidance
-} from "./chunk-EC2AYKRX.js";
+} from "./chunk-L6W77GWW.js";
 import "./chunk-L24JROPR.js";
 import "./chunk-MGN7VHWQ.js";
 import "./chunk-5IZL4DCV.js";
@@ -299,9 +297,9 @@ import {
 import "./chunk-YAZNBMNF.js";
 import {
   ExtractionEngine
-} from "./chunk-FN2SM5SN.js";
+} from "./chunk-ABCGDW3A.js";
 import "./chunk-4RA3C3EV.js";
-import "./chunk-ROZJACKP.js";
+import "./chunk-KKK7YTYN.js";
 import "./chunk-54V4BZWP.js";
 import {
   ModelRegistry
@@ -322,7 +320,7 @@ import {
   collectStructuredPlanCues,
   collectTemporalLexicalCues,
   normalizeTurnExpansionEnd
-} from "./chunk-YXLT4EMM.js";
+} from "./chunk-4463LUIE.js";
 import "./chunk-YVVQUAOO.js";
 import "./chunk-XHYGJVXL.js";
 import {
@@ -345,11 +343,12 @@ import {
 import "./chunk-ZA2S2VLL.js";
 import {
   buildEntityRecallSection
-} from "./chunk-7TAQEPLE.js";
+} from "./chunk-AMNLZ6SF.js";
 import {
   buildEventOrderRecallSection,
   shouldRecallEventOrderEvidence
-} from "./chunk-UU6MVCJ6.js";
+} from "./chunk-FIOYURII.js";
+import "./chunk-LUPVCGYK.js";
 import {
   buildEvidencePack
 } from "./chunk-PYPOFEMK.js";
@@ -360,26 +359,20 @@ import {
 import "./chunk-VEWZZM3H.js";
 import "./chunk-2PRQG7PV.js";
 import "./chunk-WIWPSQYU.js";
-import "./chunk-XTIRCSIH.js";
+import "./chunk-MXEWQKM7.js";
 import "./chunk-2F6NP3NT.js";
 import "./chunk-TERNBNJB.js";
 import "./chunk-QRDOSYOR.js";
-import "./chunk-QP37KL5H.js";
+import "./chunk-EYJD6KIO.js";
 import "./chunk-ZRWB5D4H.js";
-import "./chunk-PONNZ54D.js";
-import {
-  SESSION_CHANNEL_TYPE,
-  legacyParserReadbackDir,
-  parseSessionIdentity,
-  sessionStoragePaths
-} from "./chunk-S4DDLTPX.js";
+import "./chunk-GY3SKOS4.js";
 import "./chunk-SFQ6QNL7.js";
 import "./chunk-33JBK2XP.js";
-import "./chunk-WFEZUGU5.js";
+import "./chunk-EZR35XHX.js";
 import {
   NamespaceCatalog
-} from "./chunk-JKOKX3PS.js";
-import "./chunk-ODTWHSY2.js";
+} from "./chunk-JMA4RYRN.js";
+import "./chunk-64XXOQRW.js";
 import "./chunk-KFY3SGN7.js";
 import {
   resolvePluginEntry
@@ -429,11 +422,11 @@ import {
 import "./chunk-PBH4JUAB.js";
 import {
   buildExtensionsBlockForConsolidation
-} from "./chunk-JO3E5VGS.js";
+} from "./chunk-FVI5B7DE.js";
 import {
   runCodexMaterialize,
   runPostConsolidationMaterialize
-} from "./chunk-ISLJ5WIM.js";
+} from "./chunk-QIMFOCSH.js";
 import {
   MATERIALIZE_VERSION,
   SENTINEL_FILE,
@@ -469,7 +462,7 @@ import {
   parseConfig,
   parseWearablesConfig,
   resolveEnvVars
-} from "./chunk-K4DWSPMW.js";
+} from "./chunk-WRGPE6AW.js";
 import {
   REDACTION_PLACEHOLDER,
   applyCorrections,
@@ -489,7 +482,7 @@ import "./chunk-LBJBNWS2.js";
 import "./chunk-OADWQ5CR.js";
 import {
   EngramAccessHttpServer
-} from "./chunk-KF4TXW7Z.js";
+} from "./chunk-5VXVXJH6.js";
 import "./chunk-SEDEKFYQ.js";
 import "./chunk-JBPKEARU.js";
 import "./chunk-TMSXWOBZ.js";
@@ -503,7 +496,7 @@ import {
 } from "./chunk-7WV3F5DQ.js";
 import {
   EngramMcpServer
-} from "./chunk-OLOYQZFB.js";
+} from "./chunk-KC6TCAWV.js";
 import {
   REMNIC_CHATGPT_MEMORY_INSPECTOR_CANONICAL_TOOL,
   REMNIC_CHATGPT_MEMORY_INSPECTOR_MIME_TYPE,
@@ -519,7 +512,7 @@ import {
   parseOaiMemCitation,
   sanitizeNoteForCitation
 } from "./chunk-D24OXEPB.js";
-import "./chunk-KS7WQ4BZ.js";
+import "./chunk-CZJ6QSKG.js";
 import {
   formatZodError,
   memoryStoreRequestSchema,
@@ -528,13 +521,13 @@ import {
   suggestionSubmitRequestSchema,
   validateRequest
 } from "./chunk-Q4O3ET6F.js";
-import "./chunk-YO4MBK3I.js";
+import "./chunk-QGJAGC2J.js";
 import {
   EngramAccessInputError,
   EngramAccessService,
   computeProcedureStats,
   formatProcedureStatsText
-} from "./chunk-FUCJAZ25.js";
+} from "./chunk-OXEAMU42.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import {
@@ -545,6 +538,7 @@ import {
   CODING_GRAPH_ENGINE_VERSION,
   TIER_1_LANGUAGES
 } from "./chunk-ERA5RSMZ.js";
+import "./chunk-IQ7WCZRW.js";
 import {
   RECALL_XRAY_FORMATS,
   parseXrayFormat,
@@ -552,7 +546,7 @@ import {
   renderXrayJson,
   renderXrayMarkdown,
   renderXrayText
-} from "./chunk-D75JXBV4.js";
+} from "./chunk-WN4GHSDH.js";
 import "./chunk-SOBJ6NEY.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-H7XKCNR6.js";
@@ -564,15 +558,21 @@ import {
   resolveCodingNamespaceOverlay,
   resolveGitContext,
   stableHash
-} from "./chunk-HRUULBBV.js";
+} from "./chunk-SHRRWOVY.js";
 import "./chunk-RS25QOKZ.js";
 import {
   isTrustZoneName
 } from "./chunk-JGSKJHF7.js";
+import {
+  SESSION_CHANNEL_TYPE,
+  legacyParserReadbackDir,
+  parseSessionIdentity,
+  sessionStoragePaths
+} from "./chunk-S4DDLTPX.js";
 import {
   storagePathHash
 } from "./chunk-FF4KLI5W.js";
-import "./chunk-SDPDU2PM.js";
+import "./chunk-YTMDF6S7.js";
 import "./chunk-BMFZLLNI.js";
 import {
   isLcmMessagePartKind,
@@ -585,7 +585,7 @@ import {
   partsFromRenderedText
 } from "./chunk-CI7RKSRE.js";
 import "./chunk-6HMYUWXR.js";
-import "./chunk-TFVVONWD.js";
+import "./chunk-MBUM2Y3L.js";
 import "./chunk-VPAFWWCL.js";
 import "./chunk-QQW2LIEA.js";
 import "./chunk-SANZHXY2.js";
@@ -619,7 +619,7 @@ import "./chunk-YOI3ELXF.js";
 import "./chunk-EI6V5UXY.js";
 import "./chunk-PNLCEFE4.js";
 import "./chunk-O75CRYGF.js";
-import "./chunk-U33LWTQQ.js";
+import "./chunk-HV57RHMD.js";
 import {
   buildProcedureMarkdownBody,
   parseProcedureStepsFromBody
@@ -651,12 +651,12 @@ import {
   renderBriefingMarkdown,
   resolveBriefingSaveDir,
   validateBriefingFormat
-} from "./chunk-HF4N43Q7.js";
+} from "./chunk-6VVP6NK7.js";
 import {
   StorageManager,
   parseEntityFile,
   serializeEntityFile
-} from "./chunk-SFMRLXIV.js";
+} from "./chunk-GFIARMA7.js";
 import "./chunk-3JJWNZTT.js";
 import {
   DEFAULT_SELF_NAME,
@@ -696,7 +696,7 @@ import {
   DEFAULT_RECALL_DISCLOSURE,
   RECALL_DISCLOSURE_LEVELS,
   isRecallDisclosure
-} from "./chunk-IKNQAGBV.js";
+} from "./chunk-IX3UQT4H.js";
 import {
   normalizeProjectionPreview,
   normalizeProjectionTags
@@ -708,7 +708,6 @@ import "./chunk-42JKGUFJ.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-DM2T26WE.js";
-import "./chunk-FVQJYWH7.js";
 import "./chunk-FEB7W5JG.js";
 import "./chunk-G7D6GZ5J.js";
 import {
@@ -817,7 +816,8 @@ import {
 import "./chunk-U3PN77QT.js";
 import {
   coerceInstallExtension
-} from "./chunk-ZPQVJEVQ.js";
+} from "./chunk-SK2CR6MW.js";
+import "./chunk-FVQJYWH7.js";
 import "./chunk-4DJQYKMN.js";
 import {
   expandTildePath
@@ -830,6 +830,7 @@ import {
   initLogger,
   log
 } from "./chunk-NU3CSQ4H.js";
+import "./chunk-6MKAMLQL.js";
 import "./chunk-TBBDFYXW.js";
 import "./chunk-ZBJMUXZH.js";
 import "./chunk-PVGDJXVK.js";