@swarmvaultai/cli 0.9.0 → 0.11.0

package/dist/index.js

@@ -9,11 +9,14 @@ import {
   acceptApproval,
   addInput,
   addManagedSource,
+  addWatchedRoot,
   archiveCandidate,
   autoCommitWikiChanges,
   benchmarkVault,
   blastRadiusVault,
   compileVault,
+  consolidateVault,
+  createSupersessionEdge,
   deleteManagedSource,
   explainGraphVault,
   exploreVault,
@@ -40,6 +43,7 @@ import {
   listManagedSourceRecords,
   listManifests,
   listSchedules,
+  listWatchedRoots,
   loadVaultConfig,
   pathGraphVault,
   previewCandidatePromotions,
@@ -50,6 +54,7 @@ import {
   readApproval,
   rejectApproval,
   reloadManagedSources,
+  removeWatchedRoot,
   resumeSourceSession,
   reviewManagedSource,
   reviewSourceScope,
@@ -278,9 +283,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.9.0";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "0.11.0";
   } catch {
-    return "0.9.0";
+    return "0.11.0";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -288,6 +293,9 @@ function parsePositiveInt(value, fallback) {
   const parsed = Number.parseInt(value, 10);
   return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
 }
+function collectRepeated(value, previous) {
+  return [...previous, value];
+}
 function sourceScopeFromManifests(input, manifests) {
   if (!manifests.length) {
     return null;
@@ -306,6 +314,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)}
 `);
@@ -446,7 +466,7 @@ program.command("init").description("Initialize a SwarmVault workspace in the cu
     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);
@@ -468,7 +488,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)
@@ -528,6 +549,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 });
@@ -567,6 +592,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 });
@@ -574,10 +603,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);
@@ -734,14 +764,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);
@@ -758,23 +802,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
@@ -793,13 +840,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);
@@ -969,6 +1018,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());
@@ -1083,14 +1140,16 @@ candidate.command("preview-scores").description("Show promotion scores for stage
     log(`${verdict} ${decision.pageId} score=${decision.score.toFixed(2)} ${decision.reasons.join("; ")}`);
   }
 });
-var watch = program.command("watch").description("Watch the inbox directory and optionally tracked repos, or run one refresh cycle immediately.").option("--lint", "Run lint after each compile cycle", false).option("--repo", "Also refresh tracked repo sources and watch their repo roots", false).option("--once", "Run one import/refresh cycle immediately instead of starting a watcher", false).option("--code-only", "Only re-extract code sources (AST-only, no LLM re-analysis)", false).option("--debounce <ms>", "Debounce window in milliseconds", "900").action(async (options) => {
+var watch = program.command("watch").description("Watch the inbox directory and optionally tracked repos, or run one refresh cycle immediately.").option("--lint", "Run lint after each compile cycle", false).option("--repo", "Also refresh tracked repo sources and watch their repo roots", false).option("--once", "Run one import/refresh cycle immediately instead of starting a watcher", false).option("--code-only", "Only re-extract code sources (AST-only, no LLM re-analysis)", false).option("--debounce <ms>", "Debounce window in milliseconds", "900").option("--root <path>", "Watch this repo root instead of config/auto-discovery (repeat for multiple)", collectRepeated, []).action(async (options) => {
   const debounceMs = parsePositiveInt(options.debounce, 900);
+  const overrideRoots = options.root && options.root.length > 0 ? options.root : void 0;
   if (options.once) {
     const result = await runWatchCycle(process2.cwd(), {
       lint: options.lint ?? false,
       repo: options.repo ?? false,
       codeOnly: options.codeOnly ?? false,
-      debounceMs
+      debounceMs,
+      overrideRoots
     });
     if (isJson()) {
       emitJson(result);
@@ -1106,7 +1165,8 @@ var watch = program.command("watch").description("Watch the inbox directory and
     lint: options.lint ?? false,
     repo: options.repo ?? false,
     codeOnly: options.codeOnly ?? false,
-    debounceMs
+    debounceMs,
+    overrideRoots
   });
   if (isJson()) {
     emitJson({ status: "watching", inboxDir: paths.inboxDir, repo: options.repo ?? false });
@@ -1121,6 +1181,36 @@ var watch = program.command("watch").description("Watch the inbox directory and
     process2.exit(0);
   });
 });
+watch.command("list-roots").description("Print the effective watched repo roots resolved from config and auto-discovery.").action(async () => {
+  const roots = await listWatchedRoots(process2.cwd());
+  if (isJson()) {
+    emitJson({ roots });
+    return;
+  }
+  if (roots.length === 0) {
+    log("No watched repo roots.");
+    return;
+  }
+  for (const entry of roots) {
+    log(entry);
+  }
+});
+watch.command("add-root <path>").description("Persist a repo root into swarmvault.config.json watch.repoRoots.").action(async (pathValue) => {
+  const resolved = await addWatchedRoot(process2.cwd(), pathValue);
+  if (isJson()) {
+    emitJson({ added: resolved });
+    return;
+  }
+  log(`Watching ${resolved}`);
+});
+watch.command("remove-root <path>").description("Remove a repo root from swarmvault.config.json watch.repoRoots.").action(async (pathValue) => {
+  const removed = await removeWatchedRoot(process2.cwd(), pathValue);
+  if (isJson()) {
+    emitJson({ removed });
+    return;
+  }
+  log(removed ? `Removed ${pathValue}` : `${pathValue} was not in watch.repoRoots.`);
+});
 async function showWatchStatus() {
   const result = await getWatchStatus(process2.cwd());
   if (isJson()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/cli",
-  "version": "0.9.0",
+  "version": "0.11.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.9.0",
+    "@swarmvaultai/engine": "0.11.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.