@swarmvaultai/cli 0.1.0

package/README.md

@@ -0,0 +1,21 @@
+# @swarmvaultai/cli
+
+SwarmVault CLI for local-first knowledge vault workflows.
+
+## Install
+
+```bash
+npm install -g @swarmvaultai/cli
+```
+
+## Commands
+
+```bash
+swarmvault init
+swarmvault ingest <path-or-url>
+swarmvault compile
+swarmvault query "What changed?" --save
+swarmvault lint
+swarmvault graph serve
+swarmvault install --agent codex
+```

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import process from "process";
+import {
+  compileVault,
+  ingestInput,
+  initVault,
+  installAgent,
+  lintVault,
+  queryVault,
+  startGraphServer
+} from "@swarmvaultai/engine";
+var program = new Command();
+program.name("swarmvault").description("SwarmVault is a local-first LLM wiki compiler with graph outputs and pluggable providers.").version("0.1.0");
+program.command("init").description("Initialize a SwarmVault workspace in the current directory.").action(async () => {
+  await initVault(process.cwd());
+  process.stdout.write("Initialized SwarmVault workspace.\n");
+});
+program.command("ingest").description("Ingest a local file path or URL into the raw SwarmVault workspace.").argument("<input>", "Local file path or URL").action(async (input) => {
+  const manifest = await ingestInput(process.cwd(), input);
+  process.stdout.write(`${manifest.sourceId}
+`);
+});
+program.command("compile").description("Compile manifests into wiki pages, graph JSON, and search index.").action(async () => {
+  const result = await compileVault(process.cwd());
+  process.stdout.write(
+    `Compiled ${result.sourceCount} source(s), ${result.pageCount} page(s). Changed: ${result.changedPages.length}.
+`
+  );
+});
+program.command("query").description("Query the compiled SwarmVault wiki.").argument("<question>", "Question to ask SwarmVault").option("--save", "Persist the answer to wiki/outputs", false).action(async (question, options) => {
+  const result = await queryVault(process.cwd(), question, options.save ?? false);
+  process.stdout.write(`${result.answer}
+`);
+  if (result.savedTo) {
+    process.stdout.write(`Saved to ${result.savedTo}
+`);
+  }
+});
+program.command("lint").description("Run anti-drift and wiki-health checks.").action(async () => {
+  const findings = await lintVault(process.cwd());
+  if (!findings.length) {
+    process.stdout.write("No findings.\n");
+    return;
+  }
+  for (const finding of findings) {
+    process.stdout.write(
+      `[${finding.severity}] ${finding.code}: ${finding.message}${finding.pagePath ? ` (${finding.pagePath})` : ""}
+`
+    );
+  }
+});
+var graph = program.command("graph").description("Graph-related commands.");
+graph.command("serve").description("Serve the local graph viewer.").option("--port <port>", "Port override").action(async (options) => {
+  const port = options.port ? Number.parseInt(options.port, 10) : void 0;
+  const server = await startGraphServer(process.cwd(), port);
+  process.stdout.write(`Graph viewer running at http://localhost:${server.port}
+`);
+  process.on("SIGINT", async () => {
+    await server.close();
+    process.exit(0);
+  });
+});
+program.command("install").description("Install SwarmVault instructions for an agent in the current project.").requiredOption("--agent <agent>", "codex, claude, or cursor").action(async (options) => {
+  const target = await installAgent(process.cwd(), options.agent);
+  process.stdout.write(`Installed rules into ${target}
+`);
+});
+program.parseAsync(process.argv).catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`${message}
+`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@swarmvaultai/cli",
+  "version": "0.1.0",
+  "description": "Global CLI for SwarmVault.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "swarmvault": "dist/index.js",
+    "vault": "dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "dependencies": {
+    "commander": "^14.0.1",
+    "@swarmvaultai/engine": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "tsup": "^8.5.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "test": "node -e \"process.exit(0)\"",
+    "lint": "tsc --noEmit"
+  }
+}