@remnic/core 9.3.700 → 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-CJI4xdqV.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-CJI4xdqV.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-Cte3ol0W.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-DN1PzThs.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--yVN9yEV.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.