npm - clawvault - Versions diffs - 3.2.1 → 3.4.0 - Mend

clawvault 3.2.1 → 3.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (161) hide show

package/README.md +56 -16
package/bin/clawvault.js +0 -2
package/bin/command-registration.test.js +15 -2
package/bin/help-contract.test.js +16 -0
package/bin/register-core-commands.js +88 -0
package/bin/register-core-commands.test.js +80 -0
package/bin/register-maintenance-commands.js +84 -7
package/bin/register-query-commands.js +45 -28
package/bin/register-query-commands.test.js +15 -0
package/bin/test-helpers/cli-command-fixtures.js +1 -0
package/dist/chunk-2PKBIKDH.js +130 -0
package/dist/{chunk-U67V476Y.js → chunk-2ZDO52B4.js} +18 -1
package/dist/{chunk-ZZA73MFY.js → chunk-33DOSHTA.js} +176 -36
package/dist/chunk-35JCYSRR.js +158 -0
package/dist/{chunk-AZYOKJYC.js → chunk-4PY655YM.js} +13 -1
package/dist/{chunk-2JQ3O2YL.js → chunk-5EFSWZO6.js} +3 -3
package/dist/{chunk-Y3TIJEBP.js → chunk-7SWP5FKU.js} +34 -613
package/dist/{chunk-4VQTUVH7.js → chunk-7YZWHM36.js} +52 -26
package/dist/{chunk-URXDAUVH.js → chunk-AXSJIFOJ.js} +174 -1
package/dist/{chunk-4ITRXIVT.js → chunk-BLQXXX7Q.js} +6 -6
package/dist/chunk-CSHO3PJB.js +684 -0
package/dist/chunk-D5U3Q4N5.js +872 -0
package/dist/chunk-DCF4KMFD.js +158 -0
package/dist/{chunk-S5OJEGFG.js → chunk-DOIUYIXV.js} +2 -2
package/dist/{chunk-YXQCA6B7.js → chunk-DVOUSOR3.js} +112 -7
package/dist/{chunk-YDWHS4LJ.js → chunk-ECGJYWNA.js} +205 -33
package/dist/{chunk-QMHPQYUV.js → chunk-EL6UBSX5.js} +7 -6
package/dist/chunk-FZ5I2NF7.js +352 -0
package/dist/{chunk-WJVWINEM.js → chunk-GFCHWMGD.js} +55 -6
package/dist/{chunk-GNJL4YGR.js → chunk-GJO3CFUN.js} +30 -6
package/dist/chunk-H3JZIB5O.js +322 -0
package/dist/chunk-HEHO7SMV.js +51 -0
package/dist/{chunk-UCQAOZHW.js → chunk-HGDDW24U.js} +3 -3
package/dist/chunk-J3YUXVID.js +907 -0
package/dist/{chunk-Y6VJKXGL.js → chunk-KCYWJDDW.js} +1 -1
package/dist/{chunk-P5EPF6MB.js → chunk-MW5C6ZQA.js} +110 -13
package/dist/chunk-NSXYM6EZ.js +255 -0
package/dist/{chunk-YNIPYN4F.js → chunk-OFOCU2V4.js} +6 -5
package/dist/{chunk-42MXU7A6.js → chunk-P62WHA27.js} +58 -47
package/dist/chunk-PTWPPVC7.js +972 -0
package/dist/{chunk-FAKNOB7Y.js → chunk-QFWERBDP.js} +2 -2
package/dist/chunk-QYQAGBTM.js +2097 -0
package/dist/chunk-RL2L6I6K.js +223 -0
package/dist/{chunk-IIOU45CK.js → chunk-S7N7HI5E.js} +2 -2
package/dist/{chunk-ECRZL5XR.js → chunk-T7E764W3.js} +23 -7
package/dist/{chunk-MNPUYCHQ.js → chunk-TWMI3SNN.js} +6 -5
package/dist/{chunk-2RAZ4ZFE.js → chunk-VBILES4B.js} +1 -1
package/dist/{chunk-PI4WMLMG.js → chunk-VXAGOLDP.js} +1 -1
package/dist/{chunk-SS4B7P7V.js → chunk-YIDV4VV2.js} +1 -1
package/dist/chunk-YTRZNA64.js +37 -0
package/dist/chunk-ZKWPCBYT.js +600 -0
package/dist/cli/index.js +28 -21
package/dist/commands/archive.js +3 -3
package/dist/commands/backlog.js +1 -1
package/dist/commands/benchmark.d.ts +12 -0
package/dist/commands/benchmark.js +12 -0
package/dist/commands/blocked.js +1 -1
package/dist/commands/canvas.js +2 -2
package/dist/commands/checkpoint.js +1 -1
package/dist/commands/compat.js +1 -1
package/dist/commands/context.js +8 -7
package/dist/commands/doctor.d.ts +8 -3
package/dist/commands/doctor.js +8 -22
package/dist/commands/embed.js +6 -5
package/dist/commands/entities.d.ts +8 -1
package/dist/commands/entities.js +46 -3
package/dist/commands/graph.js +4 -4
package/dist/commands/inbox.d.ts +23 -0
package/dist/commands/inbox.js +11 -0
package/dist/commands/inject.d.ts +1 -1
package/dist/commands/inject.js +5 -5
package/dist/commands/kanban.js +1 -1
package/dist/commands/link.js +5 -5
package/dist/commands/maintain.d.ts +32 -0
package/dist/commands/maintain.js +13 -0
package/dist/commands/migrate-observations.js +3 -3
package/dist/commands/observe.js +11 -10
package/dist/commands/project.js +2 -2
package/dist/commands/rebuild-embeddings.js +48 -17
package/dist/commands/rebuild.js +9 -8
package/dist/commands/recall.d.ts +14 -0
package/dist/commands/recall.js +15 -0
package/dist/commands/recover.js +1 -1
package/dist/commands/reflect.js +6 -6
package/dist/commands/repair-session.js +1 -1
package/dist/commands/replay.js +10 -9
package/dist/commands/session-recap.js +1 -1
package/dist/commands/setup.js +4 -3
package/dist/commands/shell-init.js +1 -1
package/dist/commands/sleep.d.ts +1 -1
package/dist/commands/sleep.js +20 -18
package/dist/commands/status.js +40 -26
package/dist/commands/sync-bd.js +3 -3
package/dist/commands/tailscale.js +3 -3
package/dist/commands/task.js +1 -1
package/dist/commands/template.js +1 -1
package/dist/commands/wake.d.ts +1 -1
package/dist/commands/wake.js +10 -9
package/dist/index.d.ts +233 -16
package/dist/index.js +325 -111
package/dist/{inject-DYUrDqQO.d.ts → inject-DEb_jpLi.d.ts} +3 -1
package/dist/lib/auto-linker.js +2 -2
package/dist/lib/canvas-layout.js +1 -1
package/dist/lib/config.js +2 -2
package/dist/lib/entity-index.js +1 -1
package/dist/lib/project-utils.js +2 -2
package/dist/lib/session-repair.js +1 -1
package/dist/lib/session-utils.js +1 -1
package/dist/lib/tailscale.js +1 -1
package/dist/lib/task-utils.js +1 -1
package/dist/lib/template-engine.js +1 -1
package/dist/lib/webdav.js +1 -1
package/dist/onnxruntime_binding-5QEF3SUC.node +0 -0
package/dist/onnxruntime_binding-BKPKNEGC.node +0 -0
package/dist/onnxruntime_binding-FMOXGIUT.node +0 -0
package/dist/onnxruntime_binding-OI2KMXC5.node +0 -0
package/dist/onnxruntime_binding-UX44MLAZ.node +0 -0
package/dist/onnxruntime_binding-Y2W7N7WY.node +0 -0
package/dist/openclaw-plugin--gqA2BZw.d.ts +267 -0
package/dist/openclaw-plugin.d.ts +4 -0
package/dist/openclaw-plugin.js +20 -0
package/dist/transformers.node-A2ZRORSQ.js +46775 -0
package/dist/types-CbL-wIKi.d.ts +36 -0
package/dist/{types-BbWJoC1c.d.ts → types-DslKvCaj.d.ts} +51 -1
package/hooks/clawvault/HOOK.md +25 -8
package/hooks/clawvault/handler.js +215 -78
package/hooks/clawvault/handler.test.js +109 -43
package/hooks/clawvault/integrity.js +112 -0
package/hooks/clawvault/integrity.test.js +32 -0
package/hooks/clawvault/openclaw.plugin.json +133 -15
package/openclaw.plugin.json +161 -194
package/package.json +8 -5
package/bin/register-workgraph-commands.js +0 -451
package/dist/chunk-5PJ4STIC.js +0 -465
package/dist/chunk-ERNE2FZ5.js +0 -189
package/dist/chunk-HR4KN6S2.js +0 -152
package/dist/chunk-IJBFGPCS.js +0 -33
package/dist/chunk-K7PNYS45.js +0 -93
package/dist/chunk-NTOPJI7W.js +0 -207
package/dist/chunk-PG56HX5T.js +0 -154
package/dist/chunk-QPDDIHXE.js +0 -501
package/dist/chunk-WIOLLGAD.js +0 -190
package/dist/chunk-WMGIIABP.js +0 -15
package/dist/ledger-B7g7jhqG.d.ts +0 -44
package/dist/plugin/index.d.ts +0 -352
package/dist/plugin/index.js +0 -4264
package/dist/registry-BR4326o0.d.ts +0 -30
package/dist/store-CA-6sKCJ.d.ts +0 -34
package/dist/thread-B9LhXNU0.d.ts +0 -41
package/dist/workgraph/index.d.ts +0 -5
package/dist/workgraph/index.js +0 -23
package/dist/workgraph/ledger.d.ts +0 -2
package/dist/workgraph/ledger.js +0 -25
package/dist/workgraph/registry.d.ts +0 -2
package/dist/workgraph/registry.js +0 -19
package/dist/workgraph/store.d.ts +0 -2
package/dist/workgraph/store.js +0 -25
package/dist/workgraph/thread.d.ts +0 -2
package/dist/workgraph/thread.js +0 -25
package/dist/workgraph/types.d.ts +0 -54
package/dist/workgraph/types.js +0 -7

package/dist/chunk-DCF4KMFD.js ADDED Viewed

@@ -0,0 +1,158 @@
+import {
+  registerTailscaleCommands
+} from "./chunk-KCYWJDDW.js";
+import {
+  registerReflectCommand
+} from "./chunk-DOIUYIXV.js";
+import {
+  registerInjectCommand
+} from "./chunk-OFOCU2V4.js";
+import {
+  registerMaintainCommand
+} from "./chunk-D5U3Q4N5.js";
+import {
+  registerObserveCommand
+} from "./chunk-BLQXXX7Q.js";
+import {
+  registerContextCommand
+} from "./chunk-GFCHWMGD.js";
+import {
+  registerEmbedCommand
+} from "./chunk-T7E764W3.js";
+import {
+  registerInboxCommand
+} from "./chunk-HEHO7SMV.js";
+import {
+  ClawVault
+} from "./chunk-ECGJYWNA.js";
+import {
+  resolveVaultPath
+} from "./chunk-GJO3CFUN.js";
+import {
+  registerBenchmarkCommand
+} from "./chunk-ZKWPCBYT.js";
+// src/commands/patch.ts
+function normalizeSectionHeading(heading) {
+  const trimmed = heading.trim();
+  if (!trimmed) {
+    throw new Error("Section heading cannot be empty.");
+  }
+  if (trimmed.startsWith("#")) {
+    return trimmed;
+  }
+  return `## ${trimmed}`;
+}
+function buildSectionAppendText(heading, content) {
+  const headingLine = normalizeSectionHeading(heading);
+  return `
+${headingLine}
+${content}`;
+}
+function isSectionNotFoundError(error) {
+  return error instanceof Error && error.message.startsWith("Section not found:");
+}
+function resolvePatchOptions(idOrPath, options) {
+  const appendSelected = typeof options.append === "string";
+  const replaceSelected = typeof options.replace === "string" || typeof options.with === "string";
+  const sectionSelected = typeof options.section === "string" || typeof options.content === "string";
+  const selectedModeCount = [appendSelected, replaceSelected, sectionSelected].filter(Boolean).length;
+  if (selectedModeCount !== 1) {
+    throw new Error(
+      "Select exactly one patch mode: --append, --replace with --with, or --section with --content."
+    );
+  }
+  if (appendSelected) {
+    return {
+      idOrPath,
+      mode: "append",
+      append: options.append
+    };
+  }
+  if (replaceSelected) {
+    if (typeof options.replace !== "string" || typeof options.with !== "string") {
+      throw new Error("Replace mode requires both --replace and --with.");
+    }
+    return {
+      idOrPath,
+      mode: "replace",
+      replace: options.replace,
+      with: options.with
+    };
+  }
+  if (typeof options.section !== "string" || typeof options.content !== "string") {
+    throw new Error("Section mode requires both --section and --content.");
+  }
+  return {
+    idOrPath,
+    mode: "content",
+    section: options.section,
+    content: options.content
+  };
+}
+async function runSectionUpsert(vault, idOrPath, section, content) {
+  try {
+    return await vault.patch({
+      idOrPath,
+      mode: "content",
+      section,
+      content
+    });
+  } catch (error) {
+    if (!isSectionNotFoundError(error)) {
+      throw error;
+    }
+    return vault.patch({
+      idOrPath,
+      mode: "append",
+      append: buildSectionAppendText(section, content)
+    });
+  }
+}
+async function patchCommand(idOrPath, options) {
+  const patchOptions = resolvePatchOptions(idOrPath, options);
+  const vaultPath = resolveVaultPath({ explicitPath: options.vaultPath });
+  const vault = new ClawVault(vaultPath);
+  await vault.load();
+  if (patchOptions.mode === "content") {
+    return runSectionUpsert(
+      vault,
+      patchOptions.idOrPath,
+      patchOptions.section,
+      patchOptions.content
+    );
+  }
+  return vault.patch(patchOptions);
+}
+function registerPatchCommand(program) {
+  program.command("patch <path>").description("Patch an existing memory document").option("--append <content>", "Append text to the end of a document").option("--replace <old>", "Text to find for replacement").option("--with <new>", "Replacement text used with --replace").option("--section <heading>", "Markdown heading to upsert").option("--content <body>", "Section body content used with --section").option("-v, --vault <path>", "Vault path").action(async (pathArg, rawOptions) => {
+    const doc = await patchCommand(pathArg, {
+      vaultPath: rawOptions.vault,
+      append: rawOptions.append,
+      replace: rawOptions.replace,
+      with: rawOptions.with,
+      section: rawOptions.section,
+      content: rawOptions.content
+    });
+    console.log(`Patched: ${doc.id}`);
+  });
+}
+// src/cli/index.ts
+function registerCliCommands(program) {
+  registerBenchmarkCommand(program);
+  registerContextCommand(program);
+  registerInjectCommand(program);
+  registerObserveCommand(program);
+  registerReflectCommand(program);
+  registerEmbedCommand(program);
+  registerInboxCommand(program);
+  registerMaintainCommand(program);
+  registerPatchCommand(program);
+  registerTailscaleCommands(program);
+  return program;
+}
+export {
+  registerCliCommands
+};

package/dist/{chunk-S5OJEGFG.js → chunk-DOIUYIXV.js} RENAMED Viewed

@@ -1,9 +1,9 @@
 import {
   runReflection
-} from "./chunk-MNPUYCHQ.js";
+} from "./chunk-TWMI3SNN.js";
 import {
   resolveVaultPath
-} from "./chunk-GNJL4YGR.js";
+} from "./chunk-GJO3CFUN.js";
 // src/commands/reflect.ts
 function parsePositiveInteger(raw, label) {

package/dist/{chunk-YXQCA6B7.js → chunk-DVOUSOR3.js} RENAMED Viewed

@@ -10,10 +10,43 @@ var DEFAULT_MODELS = {
   openclaw: "gpt-4o-mini"
 };
 var XAI_BASE_URL = "https://api.x.ai/v1";
+var VAULT_CONFIG_FILE = ".clawvault.json";
+var LLM_MODEL_TIERS = ["background", "default", "complex"];
+function resolveOpenClawHome() {
+  return process.env.OPENCLAW_HOME?.trim() || path.join(os.homedir(), ".openclaw");
+}
+function resolveOpenClawGatewayProvider() {
+  try {
+    const configPath = path.join(resolveOpenClawHome(), "openclaw.json");
+    if (!fs.existsSync(configPath)) {
+      return null;
+    }
+    const raw = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    const enabled = raw.gateway?.http?.endpoints?.chatCompletions?.enabled === true;
+    const apiKey = raw.gateway?.auth?.token?.trim();
+    const port = raw.gateway?.port;
+    if (!enabled || !apiKey || typeof port !== "number" || !Number.isFinite(port) || port <= 0) {
+      return null;
+    }
+    const defaultModel = raw.agents?.defaults?.model?.trim() || DEFAULT_MODELS.openclaw;
+    const host = raw.gateway?.bind === "loopback" ? "127.0.0.1" : "127.0.0.1";
+    return {
+      baseUrl: `http://${host}:${port}/v1`,
+      apiKey,
+      api: "openai-completions",
+      defaultModel
+    };
+  } catch {
+    return null;
+  }
+}
 function resolveOpenClawProvider() {
+  const gatewayProvider = resolveOpenClawGatewayProvider();
+  if (gatewayProvider) {
+    return gatewayProvider;
+  }
   try {
-    const openclawHome = process.env.OPENCLAW_HOME?.trim() || path.join(os.homedir(), ".openclaw");
-    const modelsPath = path.join(openclawHome, "agents", "main", "agent", "models.json");
+    const modelsPath = path.join(resolveOpenClawHome(), "agents", "main", "agent", "models.json");
     if (!fs.existsSync(modelsPath)) {
       return null;
     }
@@ -57,6 +90,78 @@ function resolveLlmProvider() {
   }
   return null;
 }
+function resolveNearestVaultPath(startPath) {
+  let current = path.resolve(startPath);
+  while (true) {
+    if (fs.existsSync(path.join(current, VAULT_CONFIG_FILE))) {
+      return current;
+    }
+    const parent = path.dirname(current);
+    if (parent === current) {
+      return null;
+    }
+    current = parent;
+  }
+}
+function resolveVaultPathForModelConfig() {
+  const configuredVaultPath = process.env.CLAWVAULT_PATH?.trim();
+  if (configuredVaultPath) {
+    return path.resolve(configuredVaultPath);
+  }
+  return resolveNearestVaultPath(process.cwd());
+}
+function readTieredModelConfig() {
+  const vaultPath = resolveVaultPathForModelConfig();
+  if (!vaultPath) {
+    return null;
+  }
+  const configPath = path.join(vaultPath, VAULT_CONFIG_FILE);
+  if (!fs.existsSync(configPath)) {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return null;
+    }
+    const models = parsed.models;
+    if (!models || typeof models !== "object" || Array.isArray(models)) {
+      return null;
+    }
+    const normalized = {};
+    for (const tier of LLM_MODEL_TIERS) {
+      const candidate = models[tier];
+      if (typeof candidate === "string" && candidate.trim()) {
+        normalized[tier] = candidate.trim();
+      }
+    }
+    return Object.keys(normalized).length > 0 ? normalized : null;
+  } catch {
+    return null;
+  }
+}
+function resolveTieredModel(tier) {
+  const tieredConfig = readTieredModelConfig();
+  if (!tieredConfig) {
+    return null;
+  }
+  return tieredConfig[tier] ?? tieredConfig.default ?? null;
+}
+function resolveRequestModel(options, fallbackModel) {
+  if (typeof options.model === "string" && options.model.trim()) {
+    return options.model.trim();
+  }
+  const tier = options.tier ?? "default";
+  const configuredTierModel = resolveTieredModel(tier);
+  if (configuredTierModel) {
+    return configuredTierModel;
+  }
+  const envModel = process.env.CLAWVAULT_MODEL?.trim();
+  if (envModel) {
+    return envModel;
+  }
+  return fallbackModel;
+}
 async function requestLlmCompletion(options) {
   const provider = options.provider ?? resolveLlmProvider();
   if (!provider) {
@@ -90,7 +195,7 @@ async function callAnthropic(options, provider) {
       "anthropic-version": "2023-06-01"
     },
     body: JSON.stringify({
-      model: options.model ?? DEFAULT_MODELS[provider],
+      model: resolveRequestModel(options, DEFAULT_MODELS[provider]),
       temperature: options.temperature ?? 0.1,
       max_tokens: options.maxTokens ?? 1200,
       messages: [{ role: "user", content: options.prompt }]
@@ -120,7 +225,7 @@ async function callOpenAI(options, provider) {
       authorization: `Bearer ${apiKey}`
     },
     body: JSON.stringify({
-      model: options.model ?? DEFAULT_MODELS[provider],
+      model: resolveRequestModel(options, DEFAULT_MODELS[provider]),
       temperature: options.temperature ?? 0.1,
       max_tokens: options.maxTokens ?? 1200,
       messages
@@ -150,7 +255,7 @@ async function callXAI(options, provider) {
       authorization: `Bearer ${apiKey}`
     },
     body: JSON.stringify({
-      model: options.model ?? DEFAULT_MODELS[provider],
+      model: resolveRequestModel(options, DEFAULT_MODELS[provider]),
       temperature: options.temperature ?? 0.1,
       max_tokens: options.maxTokens ?? 1200,
       messages
@@ -168,7 +273,7 @@ async function callGemini(options, provider) {
     return "";
   }
   const fetchImpl = options.fetchImpl ?? fetch;
-  const model = options.model ?? DEFAULT_MODELS[provider];
+  const model = resolveRequestModel(options, DEFAULT_MODELS[provider]);
   const response = await fetchImpl(
     `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent`,
     {
@@ -207,7 +312,7 @@ async function callOpenClaw(options) {
       authorization: `Bearer ${config.apiKey}`
     },
     body: JSON.stringify({
-      model: options.model ?? config.defaultModel,
+      model: resolveRequestModel(options, config.defaultModel),
       temperature: options.temperature ?? 0.1,
       max_tokens: options.maxTokens ?? 1200,
       messages

package/dist/{chunk-YDWHS4LJ.js → chunk-ECGJYWNA.js} RENAMED Viewed

@@ -1,22 +1,22 @@
 import {
-  loadVaultQmdConfig
-} from "./chunk-WIOLLGAD.js";
+  DEFAULT_CATEGORIES,
+  TYPE_TO_CATEGORY
+} from "./chunk-2CDEETQN.js";
+import {
+  loadVaultQmdConfig,
+  recoverQmdEmbeddingIfNeeded
+} from "./chunk-FZ5I2NF7.js";
 import {
-  QmdUnavailableError,
   SearchEngine,
   extractTags,
   extractWikiLinks,
   hasQmd,
   qmdEmbed,
   qmdUpdate
-} from "./chunk-5PJ4STIC.js";
-import {
-  DEFAULT_CATEGORIES,
-  TYPE_TO_CATEGORY
-} from "./chunk-2CDEETQN.js";
+} from "./chunk-PTWPPVC7.js";
 import {
   buildOrUpdateMemoryGraphIndex
-} from "./chunk-ZZA73MFY.js";
+} from "./chunk-33DOSHTA.js";
 // src/lib/vault.ts
 import * as fs from "fs";
@@ -31,17 +31,19 @@ var ClawVault = class {
   search;
   initialized = false;
   constructor(vaultPath) {
-    if (!hasQmd()) {
-      const error = new QmdUnavailableError("NOT_INSTALLED");
-      console.error(error.toUserMessage());
-      throw error;
+    if (typeof vaultPath !== "string" || !vaultPath.trim()) {
+      throw new Error(`Invalid vault path: expected a non-empty string, received ${typeof vaultPath}`);
     }
     this.config = {
       path: path.resolve(vaultPath),
       name: path.basename(vaultPath),
       categories: DEFAULT_CATEGORIES,
       qmdCollection: void 0,
-      qmdRoot: void 0
+      qmdRoot: void 0,
+      search: {
+        backend: "in-process",
+        qmdFallback: true
+      }
     };
     this.search = new SearchEngine();
     this.applyQmdConfig();
@@ -50,11 +52,6 @@ var ClawVault = class {
    * Initialize a new vault
    */
   async init(options = {}, initFlags) {
-    if (!hasQmd()) {
-      const error = new QmdUnavailableError("NOT_INSTALLED");
-      console.error(error.toUserMessage());
-      throw error;
-    }
     const vaultPath = this.config.path;
     const flags = initFlags || {};
     this.config = { ...this.config, ...options };
@@ -95,7 +92,8 @@ var ClawVault = class {
       categories: this.config.categories,
       documentCount: 0,
       qmdCollection: this.getQmdCollection(),
-      qmdRoot: this.getQmdRoot()
+      qmdRoot: this.getQmdRoot(),
+      search: this.config.search ?? { backend: "in-process", qmdFallback: true }
     };
     fs.writeFileSync(configPath, JSON.stringify(meta, null, 2));
     if (!flags.skipBases && this.config.categories.includes("tasks")) {
@@ -206,27 +204,41 @@ var ClawVault = class {
    * Load an existing vault
    */
   async load() {
-    if (!hasQmd()) {
-      const error = new QmdUnavailableError("NOT_INSTALLED");
-      console.error(error.toUserMessage());
-      throw error;
-    }
     const vaultPath = this.config.path;
     const configPath = path.join(vaultPath, CONFIG_FILE);
     if (!fs.existsSync(configPath)) {
       throw new Error(`Not a ClawVault: ${vaultPath} (missing ${CONFIG_FILE})`);
     }
     const meta = JSON.parse(fs.readFileSync(configPath, "utf-8"));
-    this.config.name = meta.name;
-    this.config.categories = meta.categories;
-    this.config.qmdCollection = meta.qmdCollection;
-    this.config.qmdRoot = meta.qmdRoot;
+    this.config.name = typeof meta.name === "string" ? meta.name : this.config.name;
+    this.config.categories = Array.isArray(meta.categories) ? meta.categories : this.config.categories;
+    this.config.qmdCollection = typeof meta.qmdCollection === "string" ? meta.qmdCollection : void 0;
+    this.config.qmdRoot = typeof meta.qmdRoot === "string" ? meta.qmdRoot : void 0;
+    this.config.search = meta.search && typeof meta.search === "object" && !Array.isArray(meta.search) ? meta.search : this.config.search;
     if (!meta.qmdCollection || !meta.qmdRoot) {
       meta.qmdCollection = meta.qmdCollection || meta.name;
       meta.qmdRoot = meta.qmdRoot || this.config.path;
       fs.writeFileSync(configPath, JSON.stringify(meta, null, 2));
     }
     this.applyQmdConfig(meta);
+    if (hasQmd()) {
+      try {
+        const recovery = recoverQmdEmbeddingIfNeeded({
+          vaultPath: this.config.path,
+          collection: this.getQmdCollection(),
+          rootPath: this.getQmdRoot(),
+          mode: "marker-only",
+          onLog: (message) => console.warn(`[clawvault] ${message}`)
+        });
+        if (recovery.recovered) {
+          console.warn(`[clawvault] qmd embedding recovery finished for "${this.getQmdCollection()}".`);
+        }
+      } catch (err) {
+        console.warn(
+          `[clawvault] qmd embedding recovery failed: ${err?.message || "unknown error"}`
+        );
+      }
+    }
     await this.reindex();
     this.initialized = true;
   }
@@ -322,6 +334,28 @@ var ClawVault = class {
     }
     return doc;
   }
+  /**
+   * Patch an existing document and incrementally refresh index state for that file only.
+   */
+  async patch(options) {
+    const relativePath = this.resolveDocumentRelativePath(options.idOrPath);
+    const absolutePath = path.join(this.config.path, relativePath);
+    if (!fs.existsSync(absolutePath)) {
+      throw new Error(`Document not found: ${options.idOrPath}`);
+    }
+    const raw = fs.readFileSync(absolutePath, "utf-8");
+    const { frontmatter, body } = this.splitFrontmatter(raw);
+    const updatedBody = this.applyPatchToBody(body, options);
+    if (updatedBody === body) {
+      throw new Error("Patch made no changes to the document body.");
+    }
+    fs.writeFileSync(absolutePath, `${frontmatter}${updatedBody}`);
+    const doc = await this.reindexDocument(relativePath);
+    if (!doc) {
+      throw new Error(`Failed to reload patched document: ${options.idOrPath}`);
+    }
+    return doc;
+  }
   /**
    * Quick store to inbox
    */
@@ -334,19 +368,19 @@ var ClawVault = class {
     });
   }
   /**
-   * Search the vault (BM25 via qmd)
+   * Search the vault (in-process hybrid by default, qmd fallback optional)
    */
   async find(query, options = {}) {
     return this.search.search(query, options);
   }
   /**
-   * Semantic/vector search (via qmd vsearch)
+   * Semantic/vector search (hosted embeddings, qmd fallback optional)
    */
   async vsearch(query, options = {}) {
     return this.search.vsearch(query, options);
   }
   /**
-   * Combined search with query expansion (via qmd query)
+   * Combined search entrypoint (currently aliases hybrid search)
    */
   async query(query, options = {}) {
     return this.search.query(query, options);
@@ -723,6 +757,142 @@ var ClawVault = class {
     }
     return fallback || (/* @__PURE__ */ new Date()).toISOString();
   }
+  async reindexDocument(relativePath) {
+    const doc = await this.loadDocument(relativePath);
+    if (!doc) return null;
+    this.search.addDocument(doc);
+    await this.saveIndex();
+    await this.syncMemoryGraphIndex();
+    return doc;
+  }
+  resolveDocumentRelativePath(idOrPath) {
+    if (typeof idOrPath !== "string" || !idOrPath.trim()) {
+      throw new Error("idOrPath is required");
+    }
+    const trimmed = idOrPath.trim().replace(/^[\\/]+/, "");
+    const withExtension = trimmed.endsWith(".md") ? trimmed : `${trimmed}.md`;
+    const normalized = path.normalize(withExtension);
+    const resolved = path.resolve(this.config.path, normalized);
+    const relative2 = path.relative(this.config.path, resolved);
+    if (relative2.startsWith("..") || path.isAbsolute(relative2)) {
+      throw new Error(`Document path escapes vault: ${idOrPath}`);
+    }
+    return relative2;
+  }
+  splitFrontmatter(raw) {
+    const match = raw.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/);
+    if (!match) {
+      return { frontmatter: "", body: raw };
+    }
+    const frontmatter = match[0];
+    return {
+      frontmatter,
+      body: raw.slice(frontmatter.length)
+    };
+  }
+  applyPatchToBody(body, options) {
+    if (options.mode === "append") {
+      if (typeof options.append !== "string" || options.append.length === 0) {
+        throw new Error("Append mode requires non-empty append text.");
+      }
+      if (options.section) {
+        return this.patchMarkdownSection(
+          body,
+          options.section,
+          (sectionBody) => this.appendText(sectionBody, options.append)
+        );
+      }
+      return this.appendText(body, options.append);
+    }
+    if (options.mode === "replace") {
+      if (typeof options.replace !== "string" || options.replace.length === 0) {
+        throw new Error("Replace mode requires non-empty --replace text.");
+      }
+      if (typeof options.with !== "string") {
+        throw new Error("Replace mode requires --with text.");
+      }
+      if (options.section) {
+        return this.patchMarkdownSection(
+          body,
+          options.section,
+          (sectionBody) => this.replaceAllOccurrences(sectionBody, options.replace, options.with, `section "${options.section}"`)
+        );
+      }
+      return this.replaceAllOccurrences(body, options.replace, options.with, "document");
+    }
+    if (options.mode === "content") {
+      if (typeof options.content !== "string") {
+        throw new Error("Content mode requires --content text.");
+      }
+      if (options.section) {
+        return this.patchMarkdownSection(body, options.section, () => options.content);
+      }
+      return options.content;
+    }
+    throw new Error(`Unsupported patch mode: ${String(options.mode)}`);
+  }
+  appendText(existing, addition) {
+    if (addition.length === 0) return existing;
+    if (existing.length === 0) return addition;
+    return existing.endsWith("\n") ? `${existing}${addition}` : `${existing}
+${addition}`;
+  }
+  replaceAllOccurrences(input, searchText, replacement, scopeLabel) {
+    if (!input.includes(searchText)) {
+      throw new Error(`No matches found for "${searchText}" in ${scopeLabel}.`);
+    }
+    return input.split(searchText).join(replacement);
+  }
+  patchMarkdownSection(markdown, sectionName, applySectionPatch) {
+    const lines = markdown.split(/\r?\n/);
+    const normalize2 = (value) => value.replace(/^#+\s*/, "").trim().toLowerCase();
+    const targetName = normalize2(sectionName);
+    let sectionStart = -1;
+    let sectionLevel = 0;
+    for (let i = 0; i < lines.length; i += 1) {
+      const line = lines[i];
+      const match = line.match(/^(#{1,6})\s+(.*?)\s*$/);
+      if (!match) continue;
+      const [, marks, heading] = match;
+      if (normalize2(heading) === targetName) {
+        sectionStart = i;
+        sectionLevel = marks.length;
+        break;
+      }
+    }
+    if (sectionStart < 0) {
+      throw new Error(`Section not found: ${sectionName}`);
+    }
+    let sectionEnd = lines.length;
+    for (let i = sectionStart + 1; i < lines.length; i += 1) {
+      const match = lines[i].match(/^(#{1,6})\s+(.*?)\s*$/);
+      if (!match) continue;
+      if (match[1].length <= sectionLevel) {
+        sectionEnd = i;
+        break;
+      }
+    }
+    const existingSectionBody = lines.slice(sectionStart + 1, sectionEnd).join("\n");
+    const updatedSectionBody = applySectionPatch(existingSectionBody);
+    const rebuiltSection = updatedSectionBody.length > 0 ? `${lines[sectionStart]}
+${updatedSectionBody}` : lines[sectionStart];
+    const head = lines.slice(0, sectionStart).join("\n");
+    const tail = lines.slice(sectionEnd).join("\n");
+    if (head.length > 0 && tail.length > 0) {
+      return `${head}
+${rebuiltSection}
+${tail}`;
+    }
+    if (head.length > 0) {
+      return `${head}
+${rebuiltSection}`;
+    }
+    if (tail.length > 0) {
+      return `${rebuiltSection}
+${tail}`;
+    }
+    return rebuiltSection;
+  }
   /**
    * Extract the date portion (YYYY-MM-DD) from an ISO date string or Date object.
    * Provides safe handling for various date formats.
@@ -739,15 +909,17 @@ var ClawVault = class {
     const explicitRoot = meta?.qmdRoot || this.config.qmdRoot || this.config.path;
     const qmdConfig = loadVaultQmdConfig(this.config.path);
     const collection = explicitCollection || qmdConfig.qmdCollection || this.config.name;
-    const root = explicitRoot || qmdConfig.qmdRoot;
+    const root = (typeof explicitRoot === "string" ? explicitRoot : void 0) || qmdConfig.qmdRoot || this.config.path;
     if (qmdConfig.autoDetected) {
       console.warn(`[clawvault] Auto-detected qmd collection: ${collection}`);
     }
     this.config.qmdCollection = collection;
     this.config.qmdRoot = root;
+    this.config.search = meta?.search && typeof meta.search === "object" && !Array.isArray(meta.search) ? meta.search : this.config.search ?? { backend: "in-process", qmdFallback: true };
     this.search.setVaultPath(this.config.path);
     this.search.setCollection(collection);
     this.search.setCollectionRoot(root);
+    this.search.setSearchConfig(this.config.search);
   }
   slugify(text) {
     return text.toLowerCase().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").trim();