@swarmvaultai/cli 0.1.29 → 0.1.31

package/README.md

@@ -41,6 +41,7 @@ swarmvault hook install
 swarmvault graph serve
 swarmvault graph export --html ./exports/graph.html
 swarmvault graph export --cypher ./exports/graph.cypher
+swarmvault graph push neo4j --dry-run
 ```
 
 ## Commands
@@ -134,7 +135,8 @@ Measure graph-guided context reduction against a naive full-corpus read.
 Inspect and resolve staged approval bundles created by `swarmvault compile --approve`.
 
 - `review list` shows pending, accepted, and rejected entry counts per bundle
-- `review show <approvalId>` shows each staged entry plus its current and staged content
+- `review show <approvalId>` shows each staged entry plus its current and staged content, including a section-level change summary when available
+- `review show <approvalId> --diff` adds a unified diff between current and staged content
 - `review accept <approvalId> [targets...]` applies pending entries to the live wiki
 - `review reject <approvalId> [targets...]` marks pending entries as rejected without mutating active wiki paths
 
@@ -178,13 +180,14 @@ 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]`
+### `swarmvault lint [--deep] [--web] [--conflicts]`
 
-Run anti-drift and vault health checks such as stale pages, missing graph artifacts, and other structural issues.
+Run anti-drift and vault health checks such as stale pages, missing graph artifacts, contradiction findings, and other structural issues.
 
 `--deep` adds an LLM-powered advisory pass that can report:
 
 - `coverage_gap`
+- `contradiction`
 - `contradiction_candidate`
 - `missing_citation`
 - `candidate_page`
@@ -192,6 +195,8 @@ Run anti-drift and vault health checks such as stale pages, missing graph artifa
 
 `--web` can only be used with `--deep`. 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.
+
 ### `swarmvault watch [--lint] [--repo] [--once] [--debounce <ms>]`
 
 Watch the inbox directory and trigger import and compile cycles when files change. With `--repo`, each cycle also refreshes tracked repo roots that were previously ingested through directory ingest. With `--once`, SwarmVault runs one refresh cycle immediately instead of starting a long-running watcher. With `--lint`, each cycle also runs linting. Each cycle writes a canonical session artifact to `state/sessions/`, and compatibility run metadata is still appended to `state/jobs.ndjson`.
@@ -256,6 +261,29 @@ Export the current graph as one of four formats:
 - `--graphml` for graph-tool interoperability
 - `--cypher` for Neo4j-style import scripts
 
+### `swarmvault graph push neo4j`
+
+Push the compiled graph directly into Neo4j over Bolt/Aura instead of writing an intermediate file.
+
+Useful flags:
+
+- `--uri <bolt-uri>`
+- `--username <user>`
+- `--password-env <env-var>`
+- `--database <name>`
+- `--vault-id <id>`
+- `--include-third-party`
+- `--include-resources`
+- `--include-generated`
+- `--dry-run`
+
+Defaults:
+
+- reads `graphSinks.neo4j` from `swarmvault.config.json` when present
+- includes only `first_party` graph material unless you opt into more source classes
+- 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>`
 
 Install agent-specific rules into the current project so an agent understands the SwarmVault workspace contract and workflow.

package/dist/index.js

@@ -29,6 +29,7 @@ import {
   loadVaultConfig,
   pathGraphVault,
   promoteCandidate,
+  pushGraphNeo4j,
   queryGraphVault,
   queryVault,
   readApproval,
@@ -216,9 +217,9 @@ program.name("swarmvault").description("SwarmVault is a local-first LLM wiki com
 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.1.29";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "0.1.31";
   } catch {
-    return "0.1.29";
+    return "0.1.31";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -396,10 +397,11 @@ program.command("benchmark").description("Measure graph-guided context reduction
     log(`Reduction ratio: ${(result.reductionRatio * 100).toFixed(1)}%`);
   }
 });
-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).action(async (options) => {
+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) => {
   const findings = await lintVault(process2.cwd(), {
     deep: options.deep ?? false,
-    web: options.web ?? false
+    web: options.web ?? false,
+    conflicts: options.conflicts ?? false
   });
   if (isJson()) {
     emitJson(findings);
@@ -414,6 +416,43 @@ program.command("lint").description("Run anti-drift and wiki-health checks.").op
   }
 });
 var graph = program.command("graph").description("Graph-related commands.");
+var graphPush = graph.command("push").description("Push the compiled graph into external sinks.");
+graphPush.command("neo4j").description("Push the compiled graph directly into Neo4j over Bolt/Aura.").option("--uri <bolt-uri>", "Neo4j Bolt or Aura URI").option("--username <user>", "Neo4j username").option("--password-env <env-var>", "Environment variable containing the Neo4j password").option("--database <name>", "Neo4j database name").option("--vault-id <id>", "Stable vault identifier used for shared-database namespacing").option("--batch-size <n>", "Maximum rows to write per Neo4j transaction batch").option("--include-third-party", "Also push third-party repo material", false).option("--include-resources", "Also push resource-like content", false).option("--include-generated", "Also push generated output", false).option("--dry-run", "Show what would be pushed without writing to Neo4j", false).action(
+  async (options) => {
+    const batchSize = typeof options.batchSize === "string" && options.batchSize.trim() ? parsePositiveInt(options.batchSize, 0) || void 0 : void 0;
+    const includeClasses = [
+      "first_party",
+      ...options.includeThirdParty ? ["third_party"] : [],
+      ...options.includeResources ? ["resource"] : [],
+      ...options.includeGenerated ? ["generated"] : []
+    ];
+    const result = await pushGraphNeo4j(process2.cwd(), {
+      uri: options.uri,
+      username: options.username,
+      passwordEnv: options.passwordEnv,
+      database: options.database,
+      vaultId: options.vaultId,
+      batchSize,
+      includeClasses,
+      dryRun: options.dryRun ?? false
+    });
+    if (isJson()) {
+      emitJson(result);
+    } else {
+      log(
+        `${result.dryRun ? "Planned" : "Pushed"} ${result.counts.nodes} nodes, ${result.counts.relationships} relationships, ${result.counts.hyperedges} hyperedges, and ${result.counts.groupMembers} group-member links to ${result.uri}/${result.database} as ${result.vaultId}.`
+      );
+      if (result.skipped.nodes || result.skipped.relationships || result.skipped.hyperedges) {
+        log(
+          `Skipped ${result.skipped.nodes} node(s), ${result.skipped.relationships} relationship(s), and ${result.skipped.hyperedges} hyperedge(s) outside the selected source classes.`
+        );
+      }
+      for (const warning of result.warnings) {
+        log(`Warning: ${warning}`);
+      }
+    }
+  }
+);
 graph.command("serve").description("Serve the local graph viewer.").option("--port <port>", "Port override").action(async (options) => {
   const port = options.port ? parsePositiveInt(options.port, 0) || void 0 : void 0;
   const server = await startGraphServer(process2.cwd(), port);
@@ -504,8 +543,8 @@ review.command("list").description("List staged approval bundles and their resol
     );
   }
 });
-review.command("show").description("Show the entries inside a staged approval bundle.").argument("<approvalId>", "Approval bundle identifier").action(async (approvalId) => {
-  const approval = await readApproval(process2.cwd(), approvalId);
+review.command("show").description("Show the entries inside a staged approval bundle.").argument("<approvalId>", "Approval bundle identifier").option("--diff", "Show unified diff for each entry", false).action(async (approvalId, options) => {
+  const approval = await readApproval(process2.cwd(), approvalId, { diff: options.diff });
   if (isJson()) {
     emitJson(approval);
     return;
@@ -513,6 +552,12 @@ review.command("show").description("Show the entries inside a staged approval bu
   log(`${approval.approvalId} pending=${approval.pendingCount} accepted=${approval.acceptedCount} rejected=${approval.rejectedCount}`);
   for (const entry of approval.entries) {
     log(`- ${entry.status} ${entry.changeType} ${entry.pageId} ${entry.nextPath ?? entry.previousPath ?? ""}`.trim());
+    if (entry.changeSummary) log(`  Summary: ${entry.changeSummary}`);
+    if (entry.diff) {
+      log("");
+      log(entry.diff);
+      log("");
+    }
   }
 });
 review.command("accept").description("Accept all pending entries, or selected entries, from a staged approval bundle.").argument("<approvalId>", "Approval bundle identifier").argument("[targets...]", "Optional page ids or paths to accept").action(async (approvalId, targets) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/cli",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "description": "Global CLI for SwarmVault.",
   "type": "module",
   "main": "dist/index.js",
@@ -43,7 +43,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@swarmvaultai/engine": "0.1.29",
+    "@swarmvaultai/engine": "0.1.31",
     "commander": "^14.0.1"
   },
   "devDependencies": {