clawvault 3.0.0 → 3.2.0

package/dist/index.js

@@ -1,27 +1,52 @@
-import {
-  setupCommand
-} from "./chunk-DEFFDRVP.js";
-import {
-  rebuildCommand,
-  registerRebuildCommand
-} from "./chunk-VGLOTGAS.js";
 import {
   registerReplayCommand,
   replayCommand
-} from "./chunk-JY6FYXIT.js";
+} from "./chunk-STCQGCEQ.js";
 import {
   buildSessionRecap,
   formatSessionRecapMarkdown,
   sessionRecapCommand
 } from "./chunk-ZKGY7WTT.js";
+import {
+  setupCommand
+} from "./chunk-BUEW6IIK.js";
+import {
+  registerSyncBdCommand,
+  syncBdCommand
+} from "./chunk-SS4B7P7V.js";
+import {
+  migrateObservations,
+  migrateObservationsCommand,
+  registerMigrateObservationsCommand
+} from "./chunk-2JQ3O2YL.js";
+import {
+  EmbeddingCache,
+  cosineSimilarity,
+  embed,
+  embedBatch,
+  hybridSearch,
+  reciprocalRankFusion,
+  semanticSearch
+} from "./chunk-U4O6C46S.js";
+import {
+  rebuildCommand,
+  registerRebuildCommand
+} from "./chunk-QSHD36LH.js";
 import {
   doctor
-} from "./chunk-YKTA5JOJ.js";
+} from "./chunk-GAOWA7GR.js";
+import "./chunk-7YZWHM36.js";
 import "./chunk-7ZRP733D.js";
+import {
+  checkOpenClawCompatibility,
+  compatCommand,
+  compatibilityExitCode
+} from "./chunk-X3SPPUFG.js";
+import "./chunk-J7ZWCI2C.js";
 import {
   graphCommand,
   graphSummary
-} from "./chunk-OZ7RIXTO.js";
+} from "./chunk-QSRRMEYM.js";
 import {
   buildKanbanLanes,
   extractCardSlug,
@@ -31,19 +56,10 @@ import {
   kanbanCommand,
   parseKanbanMarkdown,
   syncKanbanBoard
-} from "./chunk-GUKMRGM7.js";
-import "./chunk-4VQTUVH7.js";
-import "./chunk-J7ZWCI2C.js";
-import {
-  migrateObservations,
-  migrateObservationsCommand,
-  registerMigrateObservationsCommand
-} from "./chunk-C7OK5WKP.js";
+} from "./chunk-4OXMU5S2.js";
 import {
-  registerCliCommands,
-  registerReweaveCommand,
-  reweaveCommand
-} from "./chunk-GAJV4IGR.js";
+  registerCliCommands
+} from "./chunk-33VSQP4J.js";
 import {
   registerTailscaleCommands,
   registerTailscaleDiscoverCommand,
@@ -54,7 +70,7 @@ import {
   tailscaleServeCommand,
   tailscaleStatusCommand,
   tailscaleSyncCommand
-} from "./chunk-THRJVD4L.js";
+} from "./chunk-Y6VJKXGL.js";
 import {
   CLAWVAULT_SERVE_PATH,
   DEFAULT_SERVE_PORT,
@@ -77,32 +93,53 @@ import {
   syncWithPeer
 } from "./chunk-TIGW564L.js";
 import "./chunk-IVRIKYFE.js";
+import "./chunk-GGA32J2R.js";
+import "./chunk-VSL7KY3M.js";
+import "./chunk-QVEERJSP.js";
+import "./chunk-4BQTQMJP.js";
+import "./chunk-MM6QGW3P.js";
+import "./chunk-WMGIIABP.js";
 import {
   SessionWatcher,
   observeCommand,
   registerObserveCommand
-} from "./chunk-F2JEUD4J.js";
+} from "./chunk-23YDQ3QU.js";
 import {
   parseSessionFile
-} from "./chunk-P5EPF6MB.js";
+} from "./chunk-MW5C6ZQA.js";
 import {
   reflectCommand,
   registerReflectCommand
-} from "./chunk-SJSFRIYS.js";
+} from "./chunk-SLXOR3CC.js";
 import {
   runReflection
-} from "./chunk-H34S76MB.js";
+} from "./chunk-ESVS6K2B.js";
+import {
+  buildContext,
+  contextCommand,
+  formatContextMarkdown,
+  inferContextProfile,
+  normalizeContextProfileInput,
+  registerContextCommand,
+  resolveContextProfile
+} from "./chunk-ZN54U2OZ.js";
 import {
   getObserverStaleness,
   getScaledObservationThresholdBytes,
   observeActiveSessions,
   parseSessionSourceLabel
-} from "./chunk-LNJA2UGL.js";
+} from "./chunk-ESFLMDRB.js";
+import "./chunk-HRLWZGMA.js";
 import {
   Compressor,
   Observer,
-  Reflector
-} from "./chunk-3NSBOUT3.js";
+  Reflector,
+  createDefaultAdapter,
+  createFactExtractionAdapter,
+  createGeminiFlashAdapter,
+  createLlmFunction,
+  resolveFactExtractionMode
+} from "./chunk-77Q5CSPJ.js";
 import {
   archiveProject,
   createProject,
@@ -111,12 +148,41 @@ import {
   listProjects,
   readProject,
   updateProject
-} from "./chunk-62YTUT6J.js";
-import "./chunk-HRLWZGMA.js";
+} from "./chunk-4PY655YM.js";
+import {
+  ClawVault,
+  createVault,
+  findVault
+} from "./chunk-CLJTREDS.js";
+import {
+  FactStore,
+  extractFactsLlm,
+  extractFactsRuleBased,
+  factId,
+  normalizeEntity
+} from "./chunk-BSJ6RIT7.js";
+import "./chunk-FHFUXL6G.js";
 import {
   embedCommand,
   registerEmbedCommand
-} from "./chunk-7R7O6STJ.js";
+} from "./chunk-PBACDKKP.js";
+import {
+  loadVaultQmdConfig,
+  removeQmdCollection
+} from "./chunk-6FH3IULF.js";
+import {
+  QMD_INSTALL_COMMAND,
+  QMD_INSTALL_URL,
+  QmdConfigurationError,
+  QmdUnavailableError,
+  SearchEngine,
+  extractTags,
+  extractWikiLinks,
+  getQmdErrorDetails,
+  hasQmd,
+  qmdEmbed,
+  qmdUpdate
+} from "./chunk-EK6S23ZB.js";
 import {
   buildInjectionResult,
   deterministicInjectMatches,
@@ -124,11 +190,7 @@ import {
   injectCommand,
   registerInjectCommand,
   runPromptInjection
-} from "./chunk-U55BGUAU.js";
-import {
-  requestLlmCompletion,
-  resolveLlmProvider
-} from "./chunk-E7MFQB6D.js";
+} from "./chunk-W4SPAEE7.js";
 import {
   SUPPORTED_CONFIG_KEYS,
   addRouteRule,
@@ -141,12 +203,21 @@ import {
   resetConfig,
   setConfigValue,
   testRouteRule
-} from "./chunk-ITPEXLHA.js";
-import "./chunk-PAH27GSN.js";
+} from "./chunk-URXDAUVH.js";
+import {
+  requestLlmCompletion,
+  resolveLlmProvider
+} from "./chunk-NCKFNBHJ.js";
+import {
+  DEFAULT_CATEGORIES,
+  DEFAULT_CONFIG,
+  MEMORY_TYPES,
+  TYPE_TO_CATEGORY
+} from "./chunk-2CDEETQN.js";
 import {
   archiveCommand,
   registerArchiveCommand
-} from "./chunk-VR5NE7PZ.js";
+} from "./chunk-2RAZ4ZFE.js";
 import {
   archiveObservations
 } from "./chunk-MQUJNOHK.js";
@@ -154,7 +225,14 @@ import {
   findNearestVaultPath,
   getVaultPath,
   resolveVaultPath
-} from "./chunk-MXSSG3QU.js";
+} from "./chunk-GNJL4YGR.js";
+import {
+  MEMORY_GRAPH_SCHEMA_VERSION,
+  buildOrUpdateMemoryGraphIndex,
+  getMemoryGraph,
+  loadMemoryGraphIndex
+} from "./chunk-33DOSHTA.js";
+import "./chunk-Z2XBWN7A.js";
 import {
   appendTransition,
   buildTransitionEvent,
@@ -167,77 +245,259 @@ import {
   queryTransitions,
   readAllTransitions,
   updateTask
-} from "./chunk-N2AXRYLC.js";
-import "./chunk-LYHGEHXG.js";
+} from "./chunk-QWQ3TIKS.js";
+import "./chunk-MFAWT5O5.js";
 import {
   buildTemplateVariables,
   renderTemplate
 } from "./chunk-7766SIJP.js";
-import {
-  checkOpenClawCompatibility,
-  compatCommand,
-  compatibilityExitCode
-} from "./chunk-3D6BCTP6.js";
-import {
-  buildContext,
-  contextCommand,
-  formatContextMarkdown,
-  inferContextProfile,
-  normalizeContextProfileInput,
-  registerContextCommand,
-  resolveContextProfile
-} from "./chunk-ZVVFWOLW.js";
-import {
-  ClawVault,
-  createVault,
-  findVault
-} from "./chunk-WGRQ6HDV.js";
-import {
-  QMD_INSTALL_COMMAND,
-  QMD_INSTALL_URL,
-  QmdUnavailableError,
-  SearchEngine,
-  bm25RankChunks,
-  classifyQuestion,
-  entitySimilarity,
-  extractDates,
-  extractEntities,
-  extractPreferences,
-  extractTags,
-  extractWikiLinks,
-  filterSuperseded,
-  getSupersessionInfo,
-  hasQmd,
-  isKnowledgeUpdate,
-  isSuperseded,
-  qmdEmbed,
-  qmdUpdate,
-  reweave,
-  sentenceChunk,
-  stripSupersededObservations
-} from "./chunk-K234IDRJ.js";
-import {
-  DEFAULT_CATEGORIES,
-  DEFAULT_CONFIG,
-  MEMORY_TYPES,
-  TYPE_TO_CATEGORY
-} from "./chunk-2CDEETQN.js";
-import {
-  MEMORY_GRAPH_SCHEMA_VERSION,
-  buildOrUpdateMemoryGraphIndex,
-  getMemoryGraph,
-  loadMemoryGraphIndex
-} from "./chunk-ZZA73MFY.js";
-import "./chunk-QK3UCXWL.js";
-import "./chunk-Z2XBWN7A.js";
-import "./chunk-3RG5ZIWI.js";
+import "./chunk-2ZDO52B4.js";
 
 // src/index.ts
+import * as fs2 from "fs";
+
+// src/commands/migrate.ts
 import * as fs from "fs";
+import * as path from "path";
+import { execFileSync } from "child_process";
+function addQmdCollection(name, rootPath) {
+  execFileSync("qmd", ["collection", "add", name, rootPath], { stdio: "ignore", shell: process.platform === "win32" });
+}
+function updateVaultConfig(vaultPath, updates) {
+  const configPath = path.join(vaultPath, ".clawvault.json");
+  let config = {};
+  if (fs.existsSync(configPath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    } catch {
+      config = {};
+    }
+  }
+  if (updates.qmdCollection !== void 0) {
+    config.qmdCollection = updates.qmdCollection;
+  }
+  if (updates.qmdRoot !== void 0) {
+    config.qmdRoot = updates.qmdRoot;
+  }
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+}
+function fixStaleCollectionName(issue, dryRun) {
+  const details = issue.details;
+  const action = {
+    type: "stale_collection_name",
+    description: `Rename collection "${details.oldName}" to "${details.newName}"`,
+    success: false
+  };
+  if (dryRun) {
+    action.success = true;
+    action.description += " (dry run)";
+    return action;
+  }
+  try {
+    removeQmdCollection(details.oldName);
+    addQmdCollection(details.newName, details.root);
+    action.success = true;
+  } catch (err) {
+    action.error = err?.message || "Failed to rename collection";
+  }
+  return action;
+}
+function fixMissingQmdCollection(issue, dryRun) {
+  const details = issue.details;
+  const action = {
+    type: "missing_qmd_collection",
+    description: `Create qmd collection "${details.collectionName}" at "${details.expectedRoot}"`,
+    success: false
+  };
+  if (dryRun) {
+    action.success = true;
+    action.description += " (dry run)";
+    return action;
+  }
+  try {
+    addQmdCollection(details.collectionName, details.expectedRoot);
+    action.success = true;
+  } catch (err) {
+    action.error = err?.message || "Failed to create collection";
+  }
+  return action;
+}
+function fixWrongVaultPath(issue, dryRun) {
+  const details = issue.details;
+  const action = {
+    type: "wrong_vault_path",
+    description: `Update collection "${details.collectionName}" path from "${details.currentRoot}" to "${details.expectedRoot}"`,
+    success: false
+  };
+  if (dryRun) {
+    action.success = true;
+    action.description += " (dry run)";
+    return action;
+  }
+  try {
+    removeQmdCollection(details.collectionName);
+    addQmdCollection(details.collectionName, details.expectedRoot);
+    action.success = true;
+  } catch (err) {
+    action.error = err?.message || "Failed to update collection path";
+  }
+  return action;
+}
+function fixOrphanedCollection(issue, dryRun) {
+  const details = issue.details;
+  const action = {
+    type: "orphaned_collection",
+    description: `Remove orphaned collection "${details.collectionName}"`,
+    success: false
+  };
+  if (dryRun) {
+    action.success = true;
+    action.description += " (dry run)";
+    return action;
+  }
+  try {
+    removeQmdCollection(details.collectionName);
+    action.success = true;
+  } catch (err) {
+    action.error = err?.message || "Failed to remove orphaned collection";
+  }
+  return action;
+}
+function fixMissingQmdConfig(issue, vaultPath, dryRun) {
+  const vaultConfig = loadVaultQmdConfig(vaultPath);
+  const action = {
+    type: "missing_qmd_config",
+    description: `Add qmdCollection="${vaultConfig.qmdCollection}" and qmdRoot="${vaultConfig.qmdRoot}" to .clawvault.json`,
+    success: false
+  };
+  if (dryRun) {
+    action.success = true;
+    action.description += " (dry run)";
+    return action;
+  }
+  try {
+    updateVaultConfig(vaultPath, {
+      qmdCollection: vaultConfig.qmdCollection,
+      qmdRoot: vaultConfig.qmdRoot
+    });
+    action.success = true;
+  } catch (err) {
+    action.error = err?.message || "Failed to update vault config";
+  }
+  return action;
+}
+function fixIssue(issue, vaultPath, dryRun) {
+  if (!issue.autoFixable) {
+    return null;
+  }
+  switch (issue.type) {
+    case "stale_collection_name":
+      return fixStaleCollectionName(issue, dryRun);
+    case "missing_qmd_collection":
+      return fixMissingQmdCollection(issue, dryRun);
+    case "wrong_vault_path":
+      return fixWrongVaultPath(issue, dryRun);
+    case "orphaned_collection":
+      return fixOrphanedCollection(issue, dryRun);
+    case "missing_qmd_config":
+      return fixMissingQmdConfig(issue, vaultPath, dryRun);
+    default:
+      return null;
+  }
+}
+async function migrate(options = {}) {
+  const vaultPath = resolveVaultPath({ explicitPath: options.vaultPath });
+  const dryRun = options.dryRun ?? false;
+  if (!hasQmd()) {
+    return {
+      vaultPath,
+      issuesFound: 1,
+      issuesFixed: 0,
+      actions: [{
+        type: "missing_qmd_collection",
+        description: "qmd is not installed",
+        success: false,
+        error: `Install qmd first: ${QMD_INSTALL_COMMAND}
+More info: ${QMD_INSTALL_URL}`
+      }],
+      dryRun
+    };
+  }
+  const report = await doctor(vaultPath);
+  const issues = report.migrationIssues;
+  const actions = [];
+  for (const issue of issues) {
+    const action = fixIssue(issue, vaultPath, dryRun);
+    if (action) {
+      actions.push(action);
+    }
+  }
+  const issuesFixed = actions.filter((a) => a.success).length;
+  return {
+    vaultPath,
+    issuesFound: issues.length,
+    issuesFixed,
+    actions,
+    dryRun
+  };
+}
+function formatMigrateResult(result) {
+  const lines = [];
+  lines.push("ClawVault Migration Report");
+  lines.push("-".repeat(30));
+  lines.push(`Vault: ${result.vaultPath}`);
+  lines.push(`Mode: ${result.dryRun ? "Dry Run" : "Live"}`);
+  lines.push("");
+  if (result.issuesFound === 0) {
+    lines.push("\u2713 No migration issues found. Your vault is up to date.");
+    return lines.join("\n");
+  }
+  lines.push(`Found ${result.issuesFound} issue(s)`);
+  lines.push("");
+  for (const action of result.actions) {
+    const prefix = action.success ? "\u2713" : "\u2717";
+    lines.push(`${prefix} ${action.description}`);
+    if (action.error) {
+      lines.push(`  Error: ${action.error}`);
+    }
+  }
+  lines.push("");
+  if (result.dryRun) {
+    lines.push(`Would fix ${result.issuesFixed}/${result.issuesFound} issue(s).`);
+    lines.push("Run without --dry-run to apply changes.");
+  } else {
+    lines.push(`Fixed ${result.issuesFixed}/${result.issuesFound} issue(s).`);
+    if (result.issuesFixed < result.issuesFound) {
+      lines.push("Some issues require manual intervention.");
+    }
+  }
+  return lines.join("\n");
+}
+async function migrateCommand(options = {}) {
+  const result = await migrate(options);
+  if (options.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(formatMigrateResult(result));
+  }
+  return result;
+}
+function registerMigrateCommand(program) {
+  program.command("migrate").description("Auto-fix common v2\u2192v3 migration issues (stale collections, missing qmd config, wrong paths)").option("-v, --vault <path>", "Vault path").option("--dry-run", "Preview changes without applying them").option("--force", "Force migration even if no issues detected").option("--json", "Output results as JSON").action(async (rawOptions) => {
+    await migrateCommand({
+      vaultPath: rawOptions.vault,
+      dryRun: rawOptions.dryRun,
+      force: rawOptions.force,
+      json: rawOptions.json
+    });
+  });
+}
+
+// src/index.ts
 function readPackageVersion() {
   try {
     const pkgUrl = new URL("../package.json", import.meta.url);
-    const pkg = JSON.parse(fs.readFileSync(pkgUrl, "utf-8"));
+    const pkg = JSON.parse(fs2.readFileSync(pkgUrl, "utf-8"));
     return pkg.version ?? "0.0.0";
   } catch {
     return "0.0.0";
@@ -254,11 +514,14 @@ export {
   DEFAULT_CATEGORIES,
   DEFAULT_CONFIG,
   DEFAULT_SERVE_PORT,
+  EmbeddingCache,
+  FactStore,
   MEMORY_GRAPH_SCHEMA_VERSION,
   MEMORY_TYPES,
   Observer,
   QMD_INSTALL_COMMAND,
   QMD_INSTALL_URL,
+  QmdConfigurationError,
   QmdUnavailableError,
   Reflector,
   SUPPORTED_CONFIG_KEYS,
@@ -271,7 +534,6 @@ export {
   archiveCommand,
   archiveObservations,
   archiveProject,
-  bm25RankChunks,
   buildContext,
   buildInjectionResult,
   buildKanbanLanes,
@@ -281,30 +543,34 @@ export {
   buildTransitionEvent,
   checkOpenClawCompatibility,
   checkPeerClawVault,
-  classifyQuestion,
   compareManifests,
   compatCommand,
   compatibilityExitCode,
   completeTask,
   configureTailscaleServe,
   contextCommand,
+  cosineSimilarity,
   countBlockedTransitions,
+  createDefaultAdapter,
+  createFactExtractionAdapter,
+  createGeminiFlashAdapter,
+  createLlmFunction,
   createProject,
   createVault,
   deterministicInjectMatches,
   discoverClawVaultPeers,
   doctor,
+  embed,
+  embedBatch,
   embedCommand,
-  entitySimilarity,
   extractCardSlug,
-  extractDates,
-  extractEntities,
-  extractPreferences,
+  extractFactsLlm,
+  extractFactsRuleBased,
   extractTags,
   extractWikiLinks,
+  factId,
   fetchRemoteFile,
   fetchRemoteManifest,
-  filterSuperseded,
   findNearestVaultPath,
   findPeer,
   findVault,
@@ -321,8 +587,8 @@ export {
   getOnlinePeers,
   getProjectActivity,
   getProjectTasks,
+  getQmdErrorDetails,
   getScaledObservationThresholdBytes,
-  getSupersessionInfo,
   getTailscaleStatus,
   getTailscaleVersion,
   getVaultPath,
@@ -330,13 +596,12 @@ export {
   graphSummary,
   hasQmd,
   hasTailscale,
+  hybridSearch,
   importKanbanBoard,
   indexInjectableItems,
   inferContextProfile,
   injectCommand,
-  isKnowledgeUpdate,
   isRegression,
-  isSuperseded,
   kanbanCommand,
   listConfig,
   listDependentTasks,
@@ -345,9 +610,12 @@ export {
   listSubtasks,
   loadMemoryGraphIndex,
   matchRouteRule,
+  migrate,
+  migrateCommand,
   migrateObservations,
   migrateObservationsCommand,
   normalizeContextProfileInput,
+  normalizeEntity,
   observeActiveSessions,
   observeCommand,
   parseKanbanMarkdown,
@@ -360,6 +628,7 @@ export {
   readAllTransitions,
   readProject,
   rebuildCommand,
+  reciprocalRankFusion,
   reflectCommand,
   registerArchiveCommand,
   registerCliCommands,
@@ -367,12 +636,13 @@ export {
   registerContextCommand,
   registerEmbedCommand,
   registerInjectCommand,
+  registerMigrateCommand,
   registerMigrateObservationsCommand,
   registerObserveCommand,
   registerRebuildCommand,
   registerReflectCommand,
   registerReplayCommand,
-  registerReweaveCommand,
+  registerSyncBdCommand,
   registerTailscaleCommands,
   registerTailscaleDiscoverCommand,
   registerTailscaleServeCommand,
@@ -384,20 +654,19 @@ export {
   requestLlmCompletion,
   resetConfig,
   resolveContextProfile,
+  resolveFactExtractionMode,
   resolveLlmProvider,
   resolvePeerIP,
   resolveVaultPath,
-  reweave,
-  reweaveCommand,
   runPromptInjection,
   runReflection,
-  sentenceChunk,
+  semanticSearch,
   serveVault,
   sessionRecapCommand,
   setConfigValue,
   setupCommand,
   stopTailscaleServe,
-  stripSupersededObservations,
+  syncBdCommand,
   syncKanbanBoard,
   syncWithPeer,
   tailscaleDiscoverCommand,