@swarmvaultai/cli 1.2.0 → 1.4.0

package/README.md

@@ -40,6 +40,8 @@ swarmvault add https://arxiv.org/abs/2401.12345
 swarmvault compile --max-tokens 120000
 swarmvault diff
 swarmvault graph share --post
+swarmvault graph share --svg ./share-card.svg
+swarmvault graph share --bundle ./share-kit
 swarmvault benchmark
 swarmvault query "What keeps recurring?" --commit
 swarmvault query "Turn this into slides" --format slides
@@ -86,7 +88,7 @@ Quick-start a scratch vault from a local directory in one command.
 - initializes the current directory as a SwarmVault workspace
 - ingests the supplied directory as local sources
 - compiles the vault immediately
-- writes `wiki/graph/share-card.md` and prints the path
+- writes `wiki/graph/share-card.md`, `wiki/graph/share-card.svg`, and `wiki/graph/share-kit/`, then prints the paths
 - starts `graph serve` unless you pass `--no-serve`
 - respects `--port` when you want a specific viewer port
 
@@ -99,7 +101,7 @@ Create a temporary sample vault with bundled sources, compile it immediately, an
 - writes the demo vault under the system temp directory
 - requires no API keys or extra setup
 - is the fastest way to inspect the full init + ingest + compile + graph workflow on a clean machine
-- writes `wiki/graph/share-card.md` inside the demo vault
+- writes `wiki/graph/share-card.md`, `wiki/graph/share-card.svg`, and `wiki/graph/share-kit/` inside the demo vault
 - respects `--port` when you want a specific viewer port
 
 ### `swarmvault diff`
@@ -210,7 +212,7 @@ Compile the current manifests into:
 - generated markdown in `wiki/`
 - structured graph data in `state/graph.json`
 - local search data in `state/search.sqlite`
-- a share card at `wiki/graph/share-card.md`
+- share cards at `wiki/graph/share-card.md` and `wiki/graph/share-card.svg`, plus a portable share kit at `wiki/graph/share-kit/`
 
 The compiler also reads `swarmvault.schema.md` and records a `schema_hash` plus lifecycle metadata such as `status`, `created_at`, `updated_at`, `compiled_from`, and `managed_by` in generated pages so schema edits can mark pages stale without losing lifecycle state.
 
@@ -370,13 +372,15 @@ Inspect graph metadata, community membership, neighbors, provenance, and group-p
 
 List the most connected bridge-heavy nodes in the current graph.
 
-### `swarmvault graph share [--post]`
+### `swarmvault graph share [--post] [--svg [path]] [--bundle [dir]]`
 
 Print a shareable summary of the compiled graph.
 
 - default output is the same markdown shape written to `wiki/graph/share-card.md`
 - `--post` prints only the concise social-post text
-- `--json` emits the structured share artifact for automation
+- `--svg [path]` writes the 1200x630 visual share card, defaulting to `wiki/graph/share-card.svg`
+- `--bundle [dir]` writes `share-card.md`, `share-post.txt`, `share-card.svg`, `share-preview.html`, and `share-artifact.json`, defaulting to `wiki/graph/share-kit`
+- `--json` emits the structured share artifact for automation; with `--svg`, it also includes `svgPath`; with `--bundle`, it includes `bundlePath` and named output paths
 - useful immediately after `swarmvault scan`, `swarmvault demo`, or a normal compile
 
 ### `swarmvault graph blast <target> [--depth <n>]`

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { readFileSync } from "fs";
-import { readFile as readFile2 } from "fs/promises";
+import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
 import path2 from "path";
 import process2 from "process";
 import { createInterface } from "readline/promises";
@@ -60,7 +60,9 @@ import {
   rejectApproval,
   reloadManagedSources,
   removeWatchedRoot,
+  renderGraphShareBundleFiles,
   renderGraphShareMarkdown,
+  renderGraphShareSvg,
   resumeSourceSession,
   reviewManagedSource,
   reviewSourceScope,
@@ -291,9 +293,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 : "1.2.0";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "1.4.0";
   } catch {
-    return "1.2.0";
+    return "1.4.0";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -347,6 +349,20 @@ function log(message) {
 `);
   }
 }
+async function writeShareBundle(bundlePath, files) {
+  await mkdir2(bundlePath, { recursive: true });
+  const bundleFiles = {
+    markdownPath: path2.join(bundlePath, "share-card.md"),
+    postPath: path2.join(bundlePath, "share-post.txt"),
+    svgPath: path2.join(bundlePath, "share-card.svg"),
+    previewHtmlPath: path2.join(bundlePath, "share-preview.html"),
+    artifactJsonPath: path2.join(bundlePath, "share-artifact.json")
+  };
+  for (const file of files) {
+    await writeFile2(path2.join(bundlePath, file.relativePath), file.content, "utf8");
+  }
+  return bundleFiles;
+}
 function emitNotice(message) {
   process2.stderr.write(`[swarmvault] ${message}
 `);
@@ -975,7 +991,11 @@ graph.command("export").description(
     }
   }
 );
-graph.command("share").description("Print a shareable summary of the compiled graph.").option("--post", "Print only the short social post text", false).action(async (options) => {
+graph.command("share").description("Print a shareable summary of the compiled graph.").option("--post", "Print only the short social post text", false).option("--svg [path]", "Write the visual SVG share card, defaulting to wiki/graph/share-card.svg").option("--bundle [dir]", "Write the portable share kit bundle, defaulting to wiki/graph/share-kit").action(async (options) => {
+  const outputModeCount = [options.post, options.svg, options.bundle].filter(Boolean).length;
+  if (outputModeCount > 1) {
+    throw new Error("Choose one graph share output mode: --post, --svg, or --bundle.");
+  }
   const { paths } = await loadVaultConfig(process2.cwd());
   const raw = await readFile2(paths.graphPath, "utf-8");
   const graph2 = JSON.parse(raw);
@@ -985,6 +1005,27 @@ graph.command("share").description("Print a shareable summary of the compiled gr
     report,
     vaultName: path2.basename(paths.rootDir)
   });
+  if (options.svg) {
+    const svgPath = typeof options.svg === "string" ? path2.resolve(process2.cwd(), options.svg) : path2.join(paths.wikiDir, "graph", "share-card.svg");
+    await mkdir2(path2.dirname(svgPath), { recursive: true });
+    await writeFile2(svgPath, renderGraphShareSvg(artifact), "utf8");
+    if (isJson()) {
+      emitJson({ ...artifact, svgPath });
+      return;
+    }
+    log(`Wrote SVG share card to ${svgPath}`);
+    return;
+  }
+  if (options.bundle) {
+    const bundlePath = typeof options.bundle === "string" ? path2.resolve(process2.cwd(), options.bundle) : path2.join(paths.wikiDir, "graph", "share-kit");
+    const bundleFiles = await writeShareBundle(bundlePath, renderGraphShareBundleFiles(artifact));
+    if (isJson()) {
+      emitJson({ ...artifact, bundlePath, bundleFiles });
+      return;
+    }
+    log(`Wrote share kit to ${bundlePath}`);
+    return;
+  }
   if (isJson()) {
     emitJson(artifact);
     return;
@@ -1449,7 +1490,7 @@ program.command("install").description("Install SwarmVault instructions for an a
   }
 );
 program.command("demo").description("Try SwarmVault with a bundled sample vault \u2014 zero config, zero API keys.").option("--port <port>", "Port for the graph viewer").option("--no-serve", "Skip launching the graph viewer after compile").action(async (options) => {
-  const { mkdtemp, writeFile: writeFile2, mkdir: mkdir2 } = await import("fs/promises");
+  const { mkdtemp, writeFile: writeFile3, mkdir: mkdir3 } = await import("fs/promises");
   const { tmpdir } = await import("os");
   const path3 = await import("path");
   const demoDir = await mkdtemp(path3.join(tmpdir(), "swarmvault-demo-"));
@@ -1457,8 +1498,8 @@ program.command("demo").description("Try SwarmVault with a bundled sample vault
     log(`Creating demo vault in ${demoDir}`);
   }
   const rawDir = path3.join(demoDir, "raw", "sources");
-  await mkdir2(rawDir, { recursive: true });
-  await writeFile2(
+  await mkdir3(rawDir, { recursive: true });
+  await writeFile3(
     path3.join(rawDir, "llm-wiki-pattern.md"),
     [
       "# The LLM Wiki Pattern",
@@ -1487,7 +1528,7 @@ program.command("demo").description("Try SwarmVault with a bundled sample vault
       ""
     ].join("\n")
   );
-  await writeFile2(
+  await writeFile3(
     path3.join(rawDir, "knowledge-graphs.md"),
     [
       "# Knowledge Graphs for AI",
@@ -1520,7 +1561,7 @@ program.command("demo").description("Try SwarmVault with a bundled sample vault
       ""
     ].join("\n")
   );
-  await writeFile2(
+  await writeFile3(
     path3.join(rawDir, "local-first-tools.md"),
     [
       "# Local-First AI Tools",
@@ -1552,6 +1593,8 @@ program.command("demo").description("Try SwarmVault with a bundled sample vault
   await compileVault(demoDir, {});
   const { paths } = await loadVaultConfig(demoDir);
   const shareCardPath = path3.join(demoDir, "wiki", "graph", "share-card.md");
+  const shareCardSvgPath = path3.join(demoDir, "wiki", "graph", "share-card.svg");
+  const shareKitPath = path3.join(demoDir, "wiki", "graph", "share-kit");
   let graphStats = "";
   try {
     const raw = await readFile2(paths.graphPath, "utf-8");
@@ -1570,12 +1613,22 @@ program.command("demo").description("Try SwarmVault with a bundled sample vault
     log("");
     log(`Vault location: ${demoDir}`);
     log(`Share card: ${shareCardPath}`);
+    log(`Visual card: ${shareCardSvgPath}`);
+    log(`Share kit: ${shareKitPath}`);
   }
   if (options.serve !== false) {
     const port = options.port ? parsePositiveInt(options.port, 0) || void 0 : void 0;
     const server = await startGraphServer(demoDir, port, { full: false });
     if (isJson()) {
-      emitJson({ demoDir, graphStats: graphStats.trim(), shareCardPath, port: server.port, url: `http://localhost:${server.port}` });
+      emitJson({
+        demoDir,
+        graphStats: graphStats.trim(),
+        shareCardPath,
+        shareCardSvgPath,
+        shareKitPath,
+        port: server.port,
+        url: `http://localhost:${server.port}`
+      });
     } else {
       log(`Graph viewer running at http://localhost:${server.port}`);
       log("");
@@ -1593,7 +1646,7 @@ program.command("demo").description("Try SwarmVault with a bundled sample vault
       process2.exit(0);
     });
   } else if (isJson()) {
-    emitJson({ demoDir, graphStats: graphStats.trim(), shareCardPath });
+    emitJson({ demoDir, graphStats: graphStats.trim(), shareCardPath, shareCardSvgPath, shareKitPath });
   } else {
     log("");
     log("Try next:");
@@ -1727,16 +1780,28 @@ program.command("scan").description("Quick-start: initialize, ingest, compile, a
   }
   const compiled = await compileVault(rootDir, {});
   const shareCardPath = path2.join(rootDir, "wiki", "graph", "share-card.md");
+  const shareCardSvgPath = path2.join(rootDir, "wiki", "graph", "share-card.svg");
+  const shareKitPath = path2.join(rootDir, "wiki", "graph", "share-kit");
   if (!isJson()) {
     log(`Compiled ${compiled.sourceCount} source(s), ${compiled.pageCount} page(s).`);
     log(`Share card: ${shareCardPath}`);
+    log(`Visual card: ${shareCardSvgPath}`);
+    log(`Share kit: ${shareKitPath}`);
     log("Post text: swarmvault graph share --post");
   }
   if (options.serve !== false) {
     const port = options.port ? parsePositiveInt(options.port, 0) || void 0 : void 0;
     const server = await startGraphServer(rootDir, port, { full: false });
     if (isJson()) {
-      emitJson({ ...result, compiled, shareCardPath, port: server.port, url: `http://localhost:${server.port}` });
+      emitJson({
+        ...result,
+        compiled,
+        shareCardPath,
+        shareCardSvgPath,
+        shareKitPath,
+        port: server.port,
+        url: `http://localhost:${server.port}`
+      });
     } else {
       log(`Graph viewer running at http://localhost:${server.port}`);
     }
@@ -1748,7 +1813,7 @@ program.command("scan").description("Quick-start: initialize, ingest, compile, a
       process2.exit(0);
     });
   } else if (isJson()) {
-    emitJson({ ...result, compiled, shareCardPath });
+    emitJson({ ...result, compiled, shareCardPath, shareCardSvgPath, shareKitPath });
   }
 });
 function enableStructuredJsonOnSubcommands(command) {

package/package.json

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