@swarmvaultai/cli 0.8.0 → 0.10.0

package/dist/index.js

@@ -14,6 +14,8 @@ import {
   benchmarkVault,
   blastRadiusVault,
   compileVault,
+  consolidateVault,
+  createSupersessionEdge,
   deleteManagedSource,
   explainGraphVault,
   exploreVault,
@@ -278,9 +280,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 : "0.8.0";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "0.10.0";
   } catch {
-    return "0.8.0";
+    return "0.10.0";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -306,6 +308,18 @@ function slugForCli(value) {
 function isJson() {
   return activeCommand?.opts().json === true || program.opts().json === true;
 }
+function summarizeRedactions(redactions) {
+  if (!redactions || redactions.length === 0) {
+    return void 0;
+  }
+  const totalMatches = redactions.reduce((total, entry) => total + entry.matches.reduce((sum, match) => sum + match.count, 0), 0);
+  if (totalMatches === 0) {
+    return void 0;
+  }
+  const secretsLabel = totalMatches === 1 ? "secret" : "secrets";
+  const sourceLabel = redactions.length === 1 ? "source" : "sources";
+  return `Redacted ${totalMatches} ${secretsLabel} across ${redactions.length} ${sourceLabel} (run --no-redact to disable).`;
+}
 function emitJson(data) {
   process2.stdout.write(`${JSON.stringify(data)}
 `);
@@ -424,20 +438,29 @@ program.hook("postAction", async (_thisCommand, actionCommand) => {
 program.command("init").description("Initialize a SwarmVault workspace in the current directory.").option("--obsidian", "Generate a minimal .obsidian workspace alongside the vault", false).option(
   "--profile <profile>",
   "Starter workspace profile or comma-separated preset list (for example: personal-research or reader,timeline)"
+).option(
+  "--lite",
+  "Minimal LLM-Wiki starter (raw/, wiki/, wiki/index.md, wiki/log.md, swarmvault.schema.md) without config, state, or agent installs",
+  false
 ).action(async (options) => {
-  await initVault(process2.cwd(), { obsidian: options.obsidian ?? false, profile: options.profile });
+  await initVault(process2.cwd(), {
+    obsidian: options.obsidian ?? false,
+    profile: options.profile,
+    lite: options.lite ?? false
+  });
   if (isJson()) {
     emitJson({
       status: "initialized",
       rootDir: process2.cwd(),
       obsidian: options.obsidian ?? false,
-      profile: options.profile ?? "default"
+      profile: options.profile ?? "default",
+      lite: options.lite ?? false
     });
   } else {
-    log("Initialized SwarmVault workspace.");
+    log(options.lite ? "Initialized SwarmVault lite workspace." : "Initialized SwarmVault workspace.");
   }
 });
-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("--review", "Stage a source review artifact after ingest and compile", false).option("--guide", "Stage a guided source integration bundle after ingest and compile (default: from config)").option("--no-guide", "Skip guided mode even if enabled in config").option("--answers-file <path>", "JSON file with guided-session answers keyed by question id or listed in prompt order").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("--include-third-party", "Also ingest repo files classified as third-party", false).option("--include-resources", "Also ingest repo files classified as resources", false).option("--include-generated", "Also ingest repo files classified as generated output", false).option("--no-gitignore", "Ignore .gitignore rules when ingesting a directory").option("--resume <run-id>", "Re-run only the failed files from a prior ingest run id").option("--commit", "Auto-commit wiki and state changes after ingest").action(
+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("--review", "Stage a source review artifact after ingest and compile", false).option("--guide", "Stage a guided source integration bundle after ingest and compile (default: from config)").option("--no-guide", "Skip guided mode even if enabled in config").option("--answers-file <path>", "JSON file with guided-session answers keyed by question id or listed in prompt order").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("--include-third-party", "Also ingest repo files classified as third-party", false).option("--include-resources", "Also ingest repo files classified as resources", false).option("--include-generated", "Also ingest repo files classified as generated output", false).option("--no-gitignore", "Ignore .gitignore rules when ingesting a directory").option("--resume <run-id>", "Re-run only the failed files from a prior ingest run id").option("--commit", "Auto-commit wiki and state changes after ingest").option("--no-redact", "Skip PII/secret redaction for this run (overrides config)").action(
   async (input, options) => {
     const guideAnswers = readGuideAnswersFile(options.answersFile);
     const vaultConfig = await loadVaultConfig(process2.cwd()).catch(() => null);
@@ -459,7 +482,8 @@ program.command("ingest").description("Ingest a local file path, directory path,
       maxFiles,
       gitignore: options.gitignore,
       extractClasses,
-      resume: options.resume
+      resume: options.resume,
+      redact: options.redact
     };
     const directoryResult = !/^https?:\/\//i.test(input) ? await import("fs/promises").then(
       (fs) => fs.stat(input).then((stat) => stat.isDirectory() ? ingestDirectory(process2.cwd(), input, commonOptions) : null).catch(() => null)
@@ -519,6 +543,10 @@ program.command("ingest").description("Ingest a local file path, directory path,
         } else if (completedGuide2?.guidePath) {
           log(`Staged guided session at ${completedGuide2.guidePath}.`);
         }
+        const redactionLine = summarizeRedactions(directoryResult.redactions);
+        if (redactionLine) {
+          log(redactionLine);
+        }
       }
       if (options.commit) {
         const msg = await autoCommitWikiChanges(process2.cwd(), "ingest", input, { force: true });
@@ -558,6 +586,10 @@ program.command("ingest").description("Ingest a local file path, directory path,
       } else if (completedGuide?.guidePath) {
         log(`Staged guided session at ${completedGuide.guidePath}.`);
       }
+      const redactionLine = summarizeRedactions(ingest.redactions);
+      if (redactionLine) {
+        log(redactionLine);
+      }
     }
     if (options.commit) {
       const msg = await autoCommitWikiChanges(process2.cwd(), "ingest", input, { force: true });
@@ -565,10 +597,11 @@ program.command("ingest").description("Ingest a local file path, directory path,
     }
   }
 );
-program.command("add").description("Capture supported URLs into normalized markdown before ingesting them.").argument("<input>", "Supported URL or bare arXiv id").option("--author <name>", "Human author or curator for this capture").option("--contributor <name>", "Additional contributor metadata for this capture").action(async (input, options) => {
+program.command("add").description("Capture supported URLs into normalized markdown before ingesting them.").argument("<input>", "Supported URL or bare arXiv id").option("--author <name>", "Human author or curator for this capture").option("--contributor <name>", "Additional contributor metadata for this capture").option("--no-redact", "Skip PII/secret redaction for this capture (overrides config)").action(async (input, options) => {
   const result = await addInput(process2.cwd(), input, {
     author: options.author,
-    contributor: options.contributor
+    contributor: options.contributor,
+    redact: options.redact
   });
   if (isJson()) {
     emitJson(result);
@@ -725,14 +758,28 @@ program.command("compile").description("Compile manifests into wiki pages, graph
   }
   await maybeEmitHeuristicNotice(["compile"]);
 });
-program.command("query").description("Query the compiled SwarmVault wiki.").argument("<question>", "Question to ask SwarmVault").option("--no-save", "Do not persist the answer to wiki/outputs").option("--commit", "Auto-commit wiki changes after query").addOption(
+program.command("consolidate").description("Roll working-tier insights up into episodic, semantic, and procedural tiers.").option("--dry-run", "Return decisions without writing any files", false).action(async (options) => {
+  const result = await consolidateVault(process2.cwd(), { dryRun: options.dryRun ?? false });
+  if (isJson()) {
+    emitJson(result);
+    return;
+  }
+  log(
+    `${options.dryRun ? "Would consolidate" : "Consolidated"} ${result.newPages.length} new tier page(s); ${result.promoted.length} promotion(s).`
+  );
+  for (const decision of result.decisions) {
+    log(decision);
+  }
+});
+program.command("query").description("Query the compiled SwarmVault wiki.").argument("<question>", "Question to ask SwarmVault").option("--no-save", "Do not persist the answer to wiki/outputs").option("--commit", "Auto-commit wiki changes after query").option("--gap-fill", "Pull external web-search evidence when the local wiki has gaps (requires webSearch.tasks.queryProvider).").addOption(
   new Option("--format <format>", "Output format").choices(["markdown", "report", "slides", "chart", "image"]).default("markdown")
 ).action(
   async (question, options) => {
     const result = await queryVault(process2.cwd(), {
       question,
       save: options.save ?? true,
-      format: options.format
+      format: options.format,
+      gapFill: options.gapFill ?? false
     });
     if (isJson()) {
       emitJson(result);
@@ -749,23 +796,26 @@ program.command("query").description("Query the compiled SwarmVault wiki.").argu
     await maybeEmitHeuristicNotice(["query"]);
   }
 );
-program.command("explore").description("Run a save-first multi-step exploration loop against the vault.").argument("<question>", "Root question to explore").option("--steps <n>", "Maximum number of exploration steps", "3").addOption(
+program.command("explore").description("Run a save-first multi-step exploration loop against the vault.").argument("<question>", "Root question to explore").option("--steps <n>", "Maximum number of exploration steps", "3").option("--gap-fill", "Pull external web-search evidence when the local wiki has gaps (requires webSearch.tasks.exploreProvider).").addOption(
   new Option("--format <format>", "Output format for step pages").choices(["markdown", "report", "slides", "chart", "image"]).default("markdown")
-).action(async (question, options) => {
-  const stepCount = parsePositiveInt(options.steps, 3);
-  const result = await exploreVault(process2.cwd(), {
-    question,
-    steps: stepCount,
-    format: options.format
-  });
-  if (isJson()) {
-    emitJson(result);
-  } else {
-    log(`Exploration hub saved to ${result.hubPath}`);
-    log(`Completed ${result.stepCount} step(s).`);
+).action(
+  async (question, options) => {
+    const stepCount = parsePositiveInt(options.steps, 3);
+    const result = await exploreVault(process2.cwd(), {
+      question,
+      steps: stepCount,
+      format: options.format,
+      gapFill: options.gapFill ?? false
+    });
+    if (isJson()) {
+      emitJson(result);
+    } else {
+      log(`Exploration hub saved to ${result.hubPath}`);
+      log(`Completed ${result.stepCount} step(s).`);
+    }
+    await maybeEmitHeuristicNotice(["explore"]);
   }
-  await maybeEmitHeuristicNotice(["explore"]);
-});
+);
 program.command("benchmark").description("Measure graph-guided context reduction against a naive full-corpus read.").option("--question <text...>", "Optional custom benchmark question(s)").action(async (options) => {
   const result = await benchmarkVault(process2.cwd(), {
     questions: options.question
@@ -784,13 +834,15 @@ program.command("benchmark").description("Measure graph-guided context reduction
     }
   }
 });
-program.command("lint").description("Run anti-drift and wiki-health checks.").option("--deep", "Run LLM-powered advisory lint (default: from config)").option("--no-deep", "Skip deep lint even if enabled in config").option("--web", "Augment deep lint with configured web search", false).option("--conflicts", "Filter to contradiction findings only", false).action(async (options) => {
+program.command("lint").description("Run anti-drift and wiki-health checks.").option("--deep", "Run LLM-powered advisory lint (default: from config)").option("--no-deep", "Skip deep lint even if enabled in config").option("--web", "Augment deep lint with configured web search", false).option("--conflicts", "Filter to contradiction findings only", false).option("--decay", "Filter to decay-related findings only", false).option("--tiers", "Filter to consolidation-tier findings only", false).action(async (options) => {
   const lintConfig = await loadVaultConfig(process2.cwd()).catch(() => null);
-  const deepEnabled = options.deep ?? lintConfig?.config.profile.deepLintDefault ?? false;
+  const deepEnabled = options.decay || options.tiers ? false : options.deep ?? lintConfig?.config.profile.deepLintDefault ?? false;
   const findings = await lintVault(process2.cwd(), {
     deep: deepEnabled,
     web: options.web ?? false,
-    conflicts: options.conflicts ?? false
+    conflicts: options.conflicts ?? false,
+    decay: options.decay ?? false,
+    tiers: options.tiers ?? false
   });
   if (isJson()) {
     emitJson(findings);
@@ -960,6 +1012,14 @@ graph.command("blast").description("Show the blast radius of changing a file or
     log(`  ${"  ".repeat(mod.depth - 1)}${mod.label} (depth ${mod.depth})`);
   }
 });
+graph.command("supersession").description("Record that one page has been replaced by another (writes a superseded_by edge).").argument("<pageId>", "Page id or path of the older page").argument("<replacedById>", "Page id or path of the replacement page").action(async (pageId, replacedById) => {
+  const result = await createSupersessionEdge(process2.cwd(), pageId, replacedById);
+  if (isJson()) {
+    emitJson(result);
+    return;
+  }
+  log(`Superseded ${result.oldPageId} by ${result.newPageId} (edge ${result.edgeId}).`);
+});
 var review = program.command("review").description("Review staged compile approval bundles.");
 review.command("list").description("List staged approval bundles and their resolution status.").action(async () => {
   const approvals = await listApprovals(process2.cwd());
@@ -1214,7 +1274,10 @@ program.command("mcp").description("Run SwarmVault as a local MCP server over st
     process2.exit(0);
   });
 });
-program.command("install").description("Install SwarmVault instructions for an agent in the current project.").requiredOption("--agent <agent>", "codex, claude, cursor, goose, pi, gemini, opencode, aider, copilot, trae, claw, or droid").option("--hook", "Also install hook/plugin guidance when the target agent supports it", false).action(
+program.command("install").description("Install SwarmVault instructions for an agent in the current project.").requiredOption(
+  "--agent <agent>",
+  "codex, claude, cursor, goose, pi, gemini, opencode, aider, copilot, trae, claw, droid, kiro, hermes, antigravity, or vscode"
+).option("--hook", "Also install hook/plugin guidance when the target agent supports it", false).action(
   async (options) => {
     const hookCapableAgents = /* @__PURE__ */ new Set(["claude", "opencode", "gemini", "copilot"]);
     if (options.hook && !hookCapableAgents.has(options.agent)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/cli",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Global CLI for SwarmVault.",
   "type": "module",
   "main": "dist/index.js",
@@ -37,18 +37,19 @@
   "engines": {
     "node": ">=24.0.0"
   },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "node ../../scripts/check-release-sync.mjs && node ../../scripts/check-published-manifests.mjs"
+  },
   "dependencies": {
-    "@swarmvaultai/engine": "0.8.0",
+    "@swarmvaultai/engine": "0.10.0",
     "commander": "^14.0.1"
   },
   "devDependencies": {
     "@types/node": "^24.6.0",
     "tsup": "^8.5.0",
     "vitest": "^3.2.4"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts --format esm --dts",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 SwarmVault
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.