@swarmvaultai/cli 0.7.2 → 0.7.22

package/README.md

@@ -70,7 +70,7 @@ Create a workspace with:
 
 The schema file is the vault-specific instruction layer. Edit it to define naming rules, categories, grounding expectations, and exclusions before a serious compile.
 
-`--profile` accepts `default`, `personal-research`, or a comma-separated preset list such as `reader,timeline`. For fully custom vault behavior, edit the `profile` block in `swarmvault.config.json`; that deterministic profile layer works alongside the human-written `swarmvault.schema.md`. The `personal-research` starter profile also sets `profile.guidedIngestDefault: true`, so guided ingest/source flows are on by default until you override them with `--no-guide`.
+`--profile` accepts `default`, `personal-research`, or a comma-separated preset list such as `reader,timeline`. For fully custom vault behavior, edit the `profile` block in `swarmvault.config.json`; that deterministic profile layer works alongside the human-written `swarmvault.schema.md`. The `personal-research` starter profile also sets `profile.guidedIngestDefault: true` and `profile.deepLintDefault: true`, so guided ingest/source and lint flows are on by default until you override them with `--no-guide` or `--no-deep`.
 
 ### `swarmvault source add|list|reload|review|guide|session|delete`
 
@@ -225,7 +225,7 @@ Each step:
 
 The command also writes a hub page linking the root question, saved step pages, and generated follow-up questions.
 
-### `swarmvault lint [--deep] [--web] [--conflicts]`
+### `swarmvault lint [--deep] [--no-deep] [--web] [--conflicts]`
 
 Run anti-drift and vault health checks such as stale pages, missing graph artifacts, contradiction findings, and other structural issues.
 
@@ -238,7 +238,9 @@ Run anti-drift and vault health checks such as stale pages, missing graph artifa
 - `candidate_page`
 - `follow_up_question`
 
-`--web` can only be used with `--deep`. It enriches deep-lint findings with external evidence snippets and URLs from a configured web-search provider.
+Set `profile.deepLintDefault: true` when deep lint should be the default for `swarmvault lint`, and use `--no-deep` when one run should stay structural only.
+
+`--web` can only be used when deep lint is enabled, either explicitly with `--deep` or through `profile.deepLintDefault`. It enriches deep-lint findings with external evidence snippets and URLs from a configured web-search provider.
 
 `--conflicts` filters the results down to contradiction-focused findings so you can audit conflicting claims without the rest of the lint output.
 
@@ -248,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.
@@ -297,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`
 
@@ -329,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.
 
@@ -350,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.2";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "0.7.22";
   } catch {
-    return "0.7.2";
+    return "0.7.22";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -738,9 +740,11 @@ program.command("benchmark").description("Measure graph-guided context reduction
     }
   }
 });
-program.command("lint").description("Run anti-drift and wiki-health checks.").option("--deep", "Run LLM-powered advisory lint", false).option("--web", "Augment deep lint with configured web search", false).option("--conflicts", "Filter to contradiction findings only", false).action(async (options) => {
+program.command("lint").description("Run anti-drift and wiki-health checks.").option("--deep", "Run LLM-powered advisory lint (default: from config)").option("--no-deep", "Skip deep lint even if enabled in config").option("--web", "Augment deep lint with configured web search", false).option("--conflicts", "Filter to contradiction findings only", false).action(async (options) => {
+  const lintConfig = await loadVaultConfig(process2.cwd()).catch(() => null);
+  const deepEnabled = options.deep ?? lintConfig?.config.profile.deepLintDefault ?? false;
   const findings = await lintVault(process2.cwd(), {
-    deep: options.deep ?? false,
+    deep: deepEnabled,
     web: options.web ?? false,
     conflicts: options.conflicts ?? false
   });
@@ -810,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, {
@@ -1095,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.2",
+  "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.2",
+    "@swarmvaultai/engine": "0.7.22",
     "commander": "^14.0.1"
   },
   "devDependencies": {