@swarmvaultai/cli 0.7.21 → 0.7.22

package/README.md

@@ -250,6 +250,8 @@ Watch the inbox directory and trigger import and compile cycles when files chang
 
 When `--repo` sees non-code changes under tracked repo roots, SwarmVault records those files under `state/watch/pending-semantic-refresh.json`, marks affected compiled pages stale, and exposes the pending set through `watch status` and the local graph workspace instead of silently re-ingesting them.
 
+When `--repo` sees only code-file changes under tracked repo roots, SwarmVault takes the faster code-only path: it refreshes code pages and graph structure without re-running non-code semantic analysis for unchanged sources.
+
 ### `swarmvault watch status`
 
 Show watched repo roots, the latest watch run, and any pending semantic refresh entries for tracked non-code repo changes.
@@ -299,14 +301,20 @@ Inspect graph metadata, community membership, neighbors, provenance, and group-p
 
 List the most connected bridge-heavy nodes in the current graph.
 
-### `swarmvault graph export --html|--svg|--graphml|--cypher <output>`
+### `swarmvault graph export --html|--html-standalone|--svg|--graphml|--cypher|--json|--obsidian|--canvas <output>`
 
-Export the current graph as one of four formats:
+Export the current graph as one or more shareable formats:
 
-- `--html` for the standalone read-only graph workspace
+- `--html` for the full self-contained read-only graph workspace
+- `--html-standalone` for a lighter vis.js export with node search, legend, and sidebar inspection
 - `--svg` for a static shareable diagram
 - `--graphml` for graph-tool interoperability
 - `--cypher` for Neo4j-style import scripts
+- `--json` for a deterministic machine-readable graph package
+- `--obsidian` for an Obsidian-friendly markdown vault with one note per node plus community notes
+- `--canvas` for an Obsidian canvas grouped by community
+
+You can combine multiple flags in one run to write several exports at once.
 
 ### `swarmvault graph push neo4j`
 
@@ -331,7 +339,7 @@ Defaults:
 - namespaces every remote record by `vaultId` so multiple vaults can safely share one Neo4j database
 - upserts current graph records and does not prune stale remote data yet
 
-### `swarmvault install --agent <codex|claude|cursor|goose|pi|gemini|opencode|aider|copilot>`
+### `swarmvault install --agent <codex|claude|cursor|goose|pi|gemini|opencode|aider|copilot|trae|claw|droid>`
 
 Install agent-specific rules into the current project so an agent understands the SwarmVault workspace contract and workflow.
 
@@ -352,6 +360,9 @@ Agent target mapping:
 - `aider` writes `CONVENTIONS.md` and merges `.aider.conf.yml`
 - `copilot` writes `.github/copilot-instructions.md` plus `AGENTS.md`
 - `cursor` writes `.cursor/rules/swarmvault.mdc`
+- `trae` writes `.trae/rules/swarmvault.md`
+- `claw` writes `.claw/skills/swarmvault/SKILL.md`
+- `droid` writes `.factory/rules/swarmvault.md`
 
 Hook semantics:
 

package/dist/index.js

@@ -16,6 +16,8 @@ import {
   exploreVault,
   exportGraphFormat,
   exportGraphHtml,
+  exportObsidianCanvas,
+  exportObsidianVault,
   getGitHookStatus,
   getWatchStatus,
   guideManagedSource,
@@ -268,9 +270,9 @@ program.name("swarmvault").description("SwarmVault is a local-first knowledge co
 function readCliVersion() {
   try {
     const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
-    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "0.7.21";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "0.7.22";
   } catch {
-    return "0.7.21";
+    return "0.7.22";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -812,29 +814,49 @@ graph.command("serve").description("Serve the local graph viewer.").option("--po
     process2.exit(0);
   });
 });
-graph.command("export").description("Export the graph as HTML, SVG, GraphML, or Cypher. Combine flags to write multiple formats in one run.").option("--html <output>", "Output HTML file path").option("--svg <output>", "Output SVG file path").option("--graphml <output>", "Output GraphML file path").option("--cypher <output>", "Output Cypher file path").option("--full", "Disable overview sampling for HTML export", false).action(async (options) => {
-  const targets = [
-    options.html ? { format: "html", outputPath: options.html } : null,
-    options.svg ? { format: "svg", outputPath: options.svg } : null,
-    options.graphml ? { format: "graphml", outputPath: options.graphml } : null,
-    options.cypher ? { format: "cypher", outputPath: options.cypher } : null
-  ].filter((target) => Boolean(target));
-  if (targets.length === 0) {
-    throw new Error("Pass at least one of --html, --svg, --graphml, or --cypher.");
-  }
-  const results = [];
-  for (const target of targets) {
-    const outputPath = target.format === "html" ? await exportGraphHtml(process2.cwd(), target.outputPath, { full: options.full ?? false }) : (await exportGraphFormat(process2.cwd(), target.format, target.outputPath)).outputPath;
-    results.push({ format: target.format, outputPath });
-  }
-  if (isJson()) {
-    emitJson(results.length === 1 ? results[0] : { exports: results });
-  } else {
-    for (const result of results) {
-      log(`Exported graph ${result.format} to ${result.outputPath}`);
+graph.command("export").description(
+  "Export the graph as HTML, SVG, GraphML, Cypher, JSON, Obsidian vault, or Obsidian canvas. Combine flags to write multiple formats in one run."
+).option("--html <output>", "Output HTML file path").option("--html-standalone <output>", "Output lightweight standalone HTML file path (vis.js, no build tooling)").option("--svg <output>", "Output SVG file path").option("--graphml <output>", "Output GraphML file path").option("--cypher <output>", "Output Cypher file path").option("--json <output>", "Output JSON file path").option("--obsidian <output>", "Output Obsidian vault directory path").option("--canvas <output>", "Output Obsidian canvas file path").option("--full", "Disable overview sampling for HTML export", false).action(
+  async (options) => {
+    const targets = [
+      options.html ? { format: "html", outputPath: options.html } : null,
+      options.htmlStandalone ? { format: "html-standalone", outputPath: options.htmlStandalone } : null,
+      options.svg ? { format: "svg", outputPath: options.svg } : null,
+      options.graphml ? { format: "graphml", outputPath: options.graphml } : null,
+      options.cypher ? { format: "cypher", outputPath: options.cypher } : null,
+      options.json ? { format: "json", outputPath: options.json } : null,
+      options.obsidian ? { format: "obsidian", outputPath: options.obsidian } : null,
+      options.canvas ? { format: "canvas", outputPath: options.canvas } : null
+    ].filter((target) => Boolean(target));
+    if (targets.length === 0) {
+      throw new Error("Pass at least one of --html, --html-standalone, --svg, --graphml, --cypher, --json, --obsidian, or --canvas.");
+    }
+    const results = [];
+    for (const target of targets) {
+      if (target.format === "html") {
+        const outputPath = await exportGraphHtml(process2.cwd(), target.outputPath, { full: options.full ?? false });
+        results.push({ format: target.format, outputPath });
+      } else if (target.format === "obsidian") {
+        const result = await exportObsidianVault(process2.cwd(), target.outputPath);
+        results.push({ format: result.format, outputPath: result.outputPath, fileCount: result.fileCount });
+      } else if (target.format === "canvas") {
+        const result = await exportObsidianCanvas(process2.cwd(), target.outputPath);
+        results.push({ format: result.format, outputPath: result.outputPath });
+      } else {
+        const result = await exportGraphFormat(process2.cwd(), target.format, target.outputPath);
+        results.push({ format: result.format, outputPath: result.outputPath });
+      }
+    }
+    if (isJson()) {
+      emitJson(results.length === 1 ? results[0] : { exports: results });
+    } else {
+      for (const result of results) {
+        const suffix = result.fileCount ? ` (${result.fileCount} files)` : "";
+        log(`Exported graph ${result.format} to ${result.outputPath}${suffix}`);
+      }
     }
   }
-});
+);
 graph.command("query").description("Traverse the compiled graph deterministically from local search seeds.").argument("<question>", "Question or graph search seed").option("--dfs", "Prefer a depth-first traversal instead of breadth-first", false).option("--budget <n>", "Maximum number of graph nodes to summarize").action(async (question, options) => {
   const budget = options.budget ? parsePositiveInt(options.budget, 0) || void 0 : void 0;
   const result = await queryGraphVault(process2.cwd(), question, {
@@ -1097,7 +1119,7 @@ program.command("mcp").description("Run SwarmVault as a local MCP server over st
     process2.exit(0);
   });
 });
-program.command("install").description("Install SwarmVault instructions for an agent in the current project.").requiredOption("--agent <agent>", "codex, claude, cursor, goose, pi, gemini, opencode, aider, or copilot").option("--hook", "Also install hook/plugin guidance when the target agent supports it", false).action(
+program.command("install").description("Install SwarmVault instructions for an agent in the current project.").requiredOption("--agent <agent>", "codex, claude, cursor, goose, pi, gemini, opencode, aider, copilot, trae, claw, or droid").option("--hook", "Also install hook/plugin guidance when the target agent supports it", false).action(
   async (options) => {
     const hookCapableAgents = /* @__PURE__ */ new Set(["claude", "opencode", "gemini", "copilot"]);
     if (options.hook && !hookCapableAgents.has(options.agent)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/cli",
-  "version": "0.7.21",
+  "version": "0.7.22",
   "description": "Global CLI for SwarmVault.",
   "type": "module",
   "main": "dist/index.js",
@@ -38,7 +38,7 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@swarmvaultai/engine": "0.7.21",
+    "@swarmvaultai/engine": "0.7.22",
     "commander": "^14.0.1"
   },
   "devDependencies": {