@remnic/core 9.3.732 → 9.3.734

package/src/namespaces/scope-profiles.ts

@@ -1,3 +1,4 @@
+import { resolveNamespaceCapabilities } from "../capabilities.js";
 import { createHash } from "node:crypto";
 
 import { combineNamespaces, type CodingNamespaceOverlay } from "../coding/coding-namespace.js";
@@ -326,7 +327,7 @@ export function resolveScopeProfilePlan(
   options: ResolveScopeProfilePlanOptions,
 ): ResolvedScopeProfilePlan | null {
   const active = activeScopeProfile(options.config);
-  if (!active || !options.config.namespacesEnabled) return null;
+  if (!active || !resolveNamespaceCapabilities(options.config).namespaces) return null;
 
   const baseNamespace = scopeProfileSelfNamespace(options.principal, options.config);
   const layerIds = Array.from(

package/src/namespaces/search.ts

@@ -1,3 +1,4 @@
+import { resolveNamespaceCapabilities } from "../capabilities.js";
 import path from "node:path";
 import type { PluginConfig, QmdSearchResult } from "../types.js";
 import type {
@@ -350,7 +351,7 @@ export class NamespaceSearchRouter {
     const useLegacyDefaultCollection =
       key === this.config.defaultNamespace && storage.dir === this.config.memoryDir;
     const filtersNestedNamespaces =
-      this.config.namespacesEnabled === true && useLegacyDefaultCollection;
+      resolveNamespaceCapabilities(this.config).namespaces === true && useLegacyDefaultCollection;
     const rootHostEmbeddingScope =
       (this.config as NamespaceScopedSearchConfig).hostEmbeddingProviderScope ??
       this.config.memoryDir;

package/src/namespaces/storage.ts

@@ -1,3 +1,4 @@
+import { resolveNamespaceCapabilities } from "../capabilities.js";
 import path from "node:path";
 import { access, lstat, readdir } from "node:fs/promises";
 import { isSafeRouteNamespace } from "../routing/engine.js";
@@ -139,7 +140,7 @@ export interface NamespaceStorageRouterHooks {
  * the default migrate into that tokenized/legacy-named dir.
  */
 export async function resolveDefaultNamespaceRoot(config: PluginConfig): Promise<string> {
-  if (!config.namespacesEnabled) {
+  if (!resolveNamespaceCapabilities(config).namespaces) {
     return config.memoryDir;
   }
 
@@ -183,7 +184,7 @@ export async function resolveNamespaceStorageRoot(
   config: PluginConfig,
   namespace: string,
 ): Promise<string> {
-  if (!config.namespacesEnabled) return config.memoryDir;
+  if (!resolveNamespaceCapabilities(config).namespaces) return config.memoryDir;
   // Compare on NORMALIZED identity so a whitespace-padded configured default name
   // still routes to the default root rather than a tokenized non-default dir
   // (NH-FH). The catalog keys records by the same normalized identity.
@@ -257,7 +258,7 @@ export class NamespaceStorageRouter {
 
   private async namespaceRoot(namespace: string): Promise<string> {
     // NOTE: only used after defaultNamespaceRoot() resolution.
-    if (!this.config.namespacesEnabled) return this.config.memoryDir;
+    if (!resolveNamespaceCapabilities(this.config).namespaces) return this.config.memoryDir;
     if (normalizeNamespaceIdentity(namespace) === this.defaultNamespaceIdentity) {
       return this.defaultNsRootResolved ?? this.config.memoryDir;
     }

package/src/operator-toolkit.ts

@@ -28,6 +28,7 @@ import {
   resolveAccessSetupCapabilities,
   resolveCapabilities,
   resolveGraphConstructionCapabilities,
+  resolveQmdCapabilities,
 } from "./capabilities.js";
 import {
   analyzeSessionIntegrity,
@@ -742,7 +743,7 @@ export async function runOperatorSetup(options: OperatorSetupOptions): Promise<O
   await mkdir(options.orchestrator.config.workspaceDir, { recursive: true });
 
   const qmdAvailable = await options.orchestrator.qmd.probe();
-  const collectionState = options.orchestrator.config.qmdEnabled
+  const collectionState = resolveQmdCapabilities(options.orchestrator.config).qmd
     ? await options.orchestrator.qmd.ensureCollection(
         options.orchestrator.config.memoryDir,
         options.orchestrator.config.qmdCollection,
@@ -813,7 +814,7 @@ export async function runOperatorSetup(options: OperatorSetupOptions): Promise<O
     workspaceDir: options.orchestrator.config.workspaceDir,
     directories,
     qmd: {
-      enabled: options.orchestrator.config.qmdEnabled,
+      enabled: resolveQmdCapabilities(options.orchestrator.config).qmd,
       available: qmdAvailable,
       collectionState,
       debugStatus: options.orchestrator.qmd.debugStatus(),
@@ -949,12 +950,12 @@ async function buildOperatorConfigReviewReport(input: {
     }));
   }
 
-  if (config.qmdEnabled && config.qmdDaemonEnabled === false) {
+  if (resolveQmdCapabilities(config).qmd && resolveQmdCapabilities(config).qmdDaemon === false) {
     findings.push(buildConfigReviewFinding({
       key: "qmd_daemon",
       status: "recommend",
       setting: "qmdDaemonEnabled",
-      currentValue: config.qmdDaemonEnabled,
+      currentValue: resolveQmdCapabilities(config).qmdDaemon,
       defaultValue: true,
       recommendedValue: true,
       summary: "Enable the QMD daemon path when QMD powers recall.",
@@ -991,12 +992,12 @@ async function buildOperatorConfigReviewReport(input: {
     }));
   }
 
-  if (searchBackend === "qmd" && config.qmdEnabled === false) {
+  if (searchBackend === "qmd" && resolveQmdCapabilities(config).qmd === false) {
     findings.push(buildConfigReviewFinding({
       key: "qmd_search_backend_disabled",
       status: "problem",
       setting: "qmdEnabled",
-      currentValue: config.qmdEnabled,
+      currentValue: resolveQmdCapabilities(config).qmd,
       defaultValue: true,
       recommendedValue: true,
       summary: "QMD search is selected but QMD is disabled.",
@@ -1005,12 +1006,12 @@ async function buildOperatorConfigReviewReport(input: {
     }));
   }
 
-  if (config.qmdColdTierEnabled === true && config.qmdEnabled === false) {
+  if (resolveQmdCapabilities(config).qmdColdTier === true && resolveQmdCapabilities(config).qmd === false) {
     findings.push(buildConfigReviewFinding({
       key: "qmd_cold_tier_requires_qmd",
       status: "problem",
       setting: "qmdEnabled",
-      currentValue: config.qmdEnabled,
+      currentValue: resolveQmdCapabilities(config).qmd,
       defaultValue: true,
       recommendedValue: true,
       summary: "Cold-tier QMD recall is enabled while QMD itself is disabled.",
@@ -1019,12 +1020,12 @@ async function buildOperatorConfigReviewReport(input: {
     }));
   }
 
-  if (config.qmdTierMigrationEnabled && config.qmdColdTierEnabled !== true) {
+  if (resolveQmdCapabilities(config).qmdTierMigration && resolveQmdCapabilities(config).qmdColdTier !== true) {
     findings.push(buildConfigReviewFinding({
       key: "qmd_tier_migration_requires_cold_tier",
       status: "problem",
       setting: "qmdColdTierEnabled",
-      currentValue: config.qmdColdTierEnabled,
+      currentValue: resolveQmdCapabilities(config).qmdColdTier,
       defaultValue: false,
       recommendedValue: true,
       summary: "Hot/cold tier migration is enabled without the cold tier itself.",
@@ -1033,12 +1034,12 @@ async function buildOperatorConfigReviewReport(input: {
     }));
   }
 
-  if (resolveIndexingCapabilities(config).conversationIndex && config.conversationIndexBackend === "qmd" && config.qmdEnabled === false) {
+  if (resolveIndexingCapabilities(config).conversationIndex && config.conversationIndexBackend === "qmd" && resolveQmdCapabilities(config).qmd === false) {
     findings.push(buildConfigReviewFinding({
       key: "conversation_index_qmd_requires_qmd",
       status: "problem",
       setting: "qmdEnabled",
-      currentValue: config.qmdEnabled,
+      currentValue: resolveQmdCapabilities(config).qmd,
       defaultValue: true,
       recommendedValue: true,
       summary: "The conversation index is configured for QMD while QMD is disabled.",
@@ -1063,8 +1064,8 @@ async function buildOperatorConfigReviewReport(input: {
     profile: {
       memoryOsPreset: config.memoryOsPreset,
       searchBackend,
-      qmdEnabled: config.qmdEnabled,
-      qmdDaemonEnabled: config.qmdDaemonEnabled,
+      qmdEnabled: resolveQmdCapabilities(config).qmd,
+      qmdDaemonEnabled: resolveQmdCapabilities(config).qmdDaemon,
       nativeKnowledgeEnabled: config.nativeKnowledge?.enabled === true,
       fileHygieneEnabled: config.fileHygiene?.enabled === true,
       conversationIndexEnabled: resolveIndexingCapabilities(config).conversationIndex,
@@ -1145,12 +1146,12 @@ export async function runOperatorDoctor(options: OperatorDoctorOptions): Promise
   });
 
   const qmdAvailable = await options.orchestrator.qmd.probe();
-  const collectionState = config.qmdEnabled
+  const collectionState = resolveQmdCapabilities(config).qmd
     ? await options.orchestrator.qmd.ensureCollection(config.memoryDir, config.qmdCollection)
     : "skipped";
   checks.push({
     key: "qmd",
-    status: !config.qmdEnabled
+    status: !resolveQmdCapabilities(config).qmd
       ? "warn"
       : !qmdAvailable
       ? "error"
@@ -1159,12 +1160,12 @@ export async function runOperatorDoctor(options: OperatorDoctorOptions): Promise
       : collectionState === "missing"
       ? "error"
       : "warn",
-    summary: !config.qmdEnabled
+    summary: !resolveQmdCapabilities(config).qmd
       ? "QMD is disabled in config."
       : qmdAvailable
       ? `QMD is reachable (${collectionState}).`
       : "QMD is not currently reachable.",
-    remediation: !config.qmdEnabled
+    remediation: !resolveQmdCapabilities(config).qmd
       ? "Enable `qmdEnabled` if you expect hybrid search."
       : !qmdAvailable
       ? "Ensure the `qmd` binary is installed and on PATH, or set `qmdPath`."

package/src/orchestration/maintenance.ts

@@ -19,6 +19,10 @@
  * `orchestrator.requestQmdMaintenance` etc. continue to work.
  */
 
+import {
+  resolveNamespaceCapabilities,
+  resolveQmdCapabilities,
+} from "../capabilities.js";
 import { existsSync } from "node:fs";
 import path from "node:path";
 
@@ -403,7 +407,7 @@ export class MaintenanceScheduler {
   /** Internal: queue a debounced QMD maintenance pass. */
   private requestQmdMaintenance(): void {
     if (!this.deps.getQmd().isAvailable()) return;
-    if (!this.deps.config.qmdMaintenanceEnabled) return;
+    if (!resolveQmdCapabilities(this.deps.config).qmdMaintenance) return;
 
     this.qmdMaintenancePending = true;
     if (this.qmdMaintenanceTimer) return;
@@ -437,7 +441,7 @@ export class MaintenanceScheduler {
     this.qmdMaintenancePending = false;
 
     try {
-      if (this.deps.config.namespacesEnabled) {
+      if (resolveNamespaceCapabilities(this.deps.config).namespaces) {
         // Include cataloged dynamic namespaces, not just the configured set
         // (NGnei), but run through the namespace-aware maintenance planner so
         // each namespace is budgeted, lock-protected, and status-recorded
@@ -446,7 +450,7 @@ export class MaintenanceScheduler {
         const now = Date.now();
         const lastEmbedAtByNamespace = this.lastQmdEmbedAtMsByNamespace;
         const dueEmbedNamespaces = (namespaces: string[]): string[] => {
-          if (!this.deps.config.qmdAutoEmbedEnabled) return [];
+          if (!resolveQmdCapabilities(this.deps.config).qmdAutoEmbed) return [];
           return namespaces.filter(
             (namespace) =>
               now - (lastEmbedAtByNamespace.get(namespace) ?? 0) >=
@@ -514,7 +518,7 @@ export class MaintenanceScheduler {
         await this.deps.getQmd().update();
         const now = Date.now();
         if (
-          this.deps.config.qmdAutoEmbedEnabled &&
+          resolveQmdCapabilities(this.deps.config).qmdAutoEmbed &&
           now - this.lastQmdEmbedAtMs >= this.deps.config.qmdEmbedMinIntervalMs
         ) {
           await this.deps.getQmd().embed();