@swarmvaultai/cli 0.1.29 → 0.1.30

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
@@ -256,6 +257,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.30";
   } catch {
-    return "0.1.29";
+    return "0.1.30";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -414,6 +415,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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/cli",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "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.30",
     "commander": "^14.0.1"
   },
   "devDependencies": {