@swarmvaultai/cli 0.1.16 → 0.1.18

package/README.md

@@ -25,6 +25,7 @@ cd my-vault
 swarmvault init --obsidian
 sed -n '1,120p' swarmvault.schema.md
 swarmvault ingest ./notes.md
+swarmvault ingest ./repo
 swarmvault compile
 swarmvault query "What keeps recurring?"
 swarmvault query "Turn this into slides" --format slides
@@ -55,7 +56,22 @@ The schema file is the vault-specific instruction layer. Edit it to define namin
 
 ### `swarmvault ingest <path-or-url>`
 
-Ingest a local file path or URL into immutable source storage and write a manifest to `state/manifests/`.
+Ingest a local file path, directory path, or URL into immutable source storage and write manifests to `state/manifests/`.
+
+- local directories recurse by default
+- directory ingest respects `.gitignore` unless you pass `--no-gitignore`
+- repo-aware directory ingest records `repoRelativePath` and later compile writes `state/code-index.json`
+- URL ingest still localizes remote image references by default
+
+Useful flags:
+
+- `--repo-root <path>`
+- `--include <glob...>`
+- `--exclude <glob...>`
+- `--max-files <n>`
+- `--no-gitignore`
+- `--no-include-assets`
+- `--max-asset-size <bytes>`
 
 ### `swarmvault inbox import [dir]`
 
@@ -71,6 +87,8 @@ Compile the current manifests into:
 
 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.
 
+For ingested code trees, compile also writes `state/code-index.json` so local imports and module aliases can resolve across the repo-aware code graph.
+
 New concept and entity pages are staged into `wiki/candidates/` first. A later matching compile promotes them into `wiki/concepts/` or `wiki/entities/`.
 
 With `--approve`, compile writes a staged review bundle into `state/approvals/` without applying active wiki changes.
@@ -96,7 +114,7 @@ Inspect and resolve staged concept and entity candidates.
 
 Targets can be page ids or relative paths under `wiki/candidates/`.
 
-### `swarmvault query "<question>" [--no-save] [--format markdown|report|slides]`
+### `swarmvault query "<question>" [--no-save] [--format markdown|report|slides|chart|image]`
 
 Query the compiled vault. The query layer also reads `swarmvault.schema.md`, so answers follow the vault’s own structure and grounding rules.
 
@@ -111,7 +129,7 @@ Saved outputs also carry related page, node, and source metadata so SwarmVault c
 
 Human-authored pages in `wiki/insights/` are also indexed into search and query context, but SwarmVault does not rewrite them after initialization.
 
-### `swarmvault explore "<question>" [--steps <n>]`
+### `swarmvault explore "<question>" [--steps <n>] [--format markdown|report|slides|chart|image]`
 
 Run a save-first multi-step research loop.
 
@@ -165,7 +183,7 @@ Start the local graph workspace backed by `state/graph.json`, `/api/search`, and
 
 Export the graph workspace as a standalone HTML file with embedded graph and page data for offline sharing.
 
-### `swarmvault install --agent <codex|claude|cursor|goose|pi|gemini>`
+### `swarmvault install --agent <codex|claude|cursor|goose|pi|gemini|opencode>`
 
 Install agent-specific rules into the current project so an agent understands the SwarmVault workspace contract and workflow.
 

package/dist/index.js

@@ -10,6 +10,7 @@ import {
   exploreVault,
   exportGraphHtml,
   importInbox,
+  ingestDirectory,
   ingestInput,
   initVault,
   installAgent,
@@ -35,9 +36,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.16";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "0.1.18";
   } catch {
-    return "0.1.16";
+    return "0.1.18";
   }
 }
 function isJson() {
@@ -64,18 +65,40 @@ program.command("init").description("Initialize a SwarmVault workspace in the cu
     log("Initialized SwarmVault workspace.");
   }
 });
-program.command("ingest").description("Ingest a local file path or URL into the raw SwarmVault workspace.").argument("<input>", "Local file path or URL").option("--include-assets", "Download remote image assets when ingesting URLs", true).option("--no-include-assets", "Skip downloading remote image assets when ingesting URLs").option("--max-asset-size <bytes>", "Maximum number of bytes to fetch for a single remote image asset").action(async (input, options) => {
-  const maxAssetSize = typeof options.maxAssetSize === "string" && options.maxAssetSize.trim() ? Number.parseInt(options.maxAssetSize, 10) : void 0;
-  const manifest = await ingestInput(process.cwd(), input, {
-    includeAssets: options.includeAssets,
-    maxAssetSize: Number.isFinite(maxAssetSize) ? maxAssetSize : void 0
-  });
-  if (isJson()) {
-    emitJson(manifest);
-  } else {
-    log(manifest.sourceId);
+program.command("ingest").description("Ingest a local file path, directory path, or URL into the raw SwarmVault workspace.").argument("<input>", "Local file path, directory path, or URL").option("--include-assets", "Download remote image assets when ingesting URLs", true).option("--no-include-assets", "Skip downloading remote image assets when ingesting URLs").option("--max-asset-size <bytes>", "Maximum number of bytes to fetch for a single remote image asset").option("--repo-root <path>", "Override the detected repo root when ingesting a directory").option("--include <glob...>", "Only ingest files matching one or more glob patterns").option("--exclude <glob...>", "Skip files matching one or more glob patterns").option("--max-files <n>", "Maximum number of files to ingest from a directory").option("--no-gitignore", "Ignore .gitignore rules when ingesting a directory").action(
+  async (input, options) => {
+    const maxAssetSize = typeof options.maxAssetSize === "string" && options.maxAssetSize.trim() ? Number.parseInt(options.maxAssetSize, 10) : void 0;
+    const maxFiles = typeof options.maxFiles === "string" && options.maxFiles.trim() ? Number.parseInt(options.maxFiles, 10) : void 0;
+    const commonOptions = {
+      includeAssets: options.includeAssets,
+      maxAssetSize: Number.isFinite(maxAssetSize) ? maxAssetSize : void 0,
+      repoRoot: options.repoRoot,
+      include: options.include,
+      exclude: options.exclude,
+      maxFiles: Number.isFinite(maxFiles) ? maxFiles : void 0,
+      gitignore: options.gitignore
+    };
+    const directoryResult = !/^https?:\/\//i.test(input) ? await import("fs/promises").then(
+      (fs) => fs.stat(input).then((stat) => stat.isDirectory() ? ingestDirectory(process.cwd(), input, commonOptions) : null).catch(() => null)
+    ) : null;
+    if (directoryResult) {
+      if (isJson()) {
+        emitJson(directoryResult);
+      } else {
+        log(
+          `Imported ${directoryResult.imported.length} file(s), updated ${directoryResult.updated.length}, skipped ${directoryResult.skipped.length}.`
+        );
+      }
+      return;
+    }
+    const manifest = await ingestInput(process.cwd(), input, commonOptions);
+    if (isJson()) {
+      emitJson(manifest);
+    } else {
+      log(manifest.sourceId);
+    }
   }
-});
+);
 var inbox = program.command("inbox").description("Inbox and capture workflows.");
 inbox.command("import").description("Import supported files from the configured inbox directory.").argument("[dir]", "Optional inbox directory override").action(async (dir) => {
   const result = await importInbox(process.cwd(), dir);
@@ -314,7 +337,7 @@ program.command("mcp").description("Run SwarmVault as a local MCP server over st
     process.exit(0);
   });
 });
-program.command("install").description("Install SwarmVault instructions for an agent in the current project.").requiredOption("--agent <agent>", "codex, claude, cursor, goose, pi, or gemini").action(async (options) => {
+program.command("install").description("Install SwarmVault instructions for an agent in the current project.").requiredOption("--agent <agent>", "codex, claude, cursor, goose, pi, gemini, or opencode").action(async (options) => {
   const target = await installAgent(process.cwd(), options.agent);
   if (isJson()) {
     emitJson({ agent: options.agent, target });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/cli",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Global CLI for SwarmVault.",
   "type": "module",
   "main": "dist/index.js",
@@ -39,7 +39,7 @@
   },
   "dependencies": {
     "commander": "^14.0.1",
-    "@swarmvaultai/engine": "0.1.16"
+    "@swarmvaultai/engine": "0.1.18"
   },
   "devDependencies": {
     "@types/node": "^24.6.0",