@swarmvaultai/cli 0.7.30 → 0.7.31

package/dist/index.js

@@ -42,6 +42,7 @@ import {
   listSchedules,
   loadVaultConfig,
   pathGraphVault,
+  previewCandidatePromotions,
   promoteCandidate,
   pushGraphNeo4j,
   queryGraphVault,
@@ -52,6 +53,7 @@ import {
   resumeSourceSession,
   reviewManagedSource,
   reviewSourceScope,
+  runAutoPromotion,
   runSchedule,
   runWatchCycle,
   serveSchedules,
@@ -276,9 +278,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.7.30";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "0.7.31";
   } catch {
-    return "0.7.30";
+    return "0.7.31";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -435,7 +437,7 @@ program.command("init").description("Initialize a SwarmVault workspace in the cu
     log("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("--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").action(
   async (input, options) => {
     const guideAnswers = readGuideAnswersFile(options.answersFile);
     const vaultConfig = await loadVaultConfig(process2.cwd()).catch(() => null);
@@ -456,7 +458,8 @@ program.command("ingest").description("Ingest a local file path, directory path,
       exclude: options.exclude,
       maxFiles,
       gitignore: options.gitignore,
-      extractClasses
+      extractClasses,
+      resume: options.resume
     };
     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)
@@ -494,9 +497,18 @@ program.command("ingest").description("Ingest a local file path, directory path,
           completedGuide2 ? { ingest: directoryResult, guide: completedGuide2 } : review3 ? { ingest: directoryResult, review: review3 } : directoryResult
         );
       } else {
+        const failedCount = directoryResult.failed?.length ?? 0;
         log(
-          `Imported ${directoryResult.imported.length} file(s), updated ${directoryResult.updated.length}, skipped ${directoryResult.skipped.length}.`
+          `Imported ${directoryResult.imported.length} file(s), updated ${directoryResult.updated.length}, skipped ${directoryResult.skipped.length}, failed ${failedCount}.`
         );
+        if (failedCount && directoryResult.runId) {
+          log(`Run id: ${directoryResult.runId}`);
+          log(`Retry with: swarmvault ingest ${input} --resume ${directoryResult.runId}`);
+          for (const failure of (directoryResult.failed ?? []).slice(0, 5)) {
+            log(`  failed ${failure.stage}: ${failure.path}: ${failure.error}`);
+          }
+          if (failedCount > 5) log(`  ... ${failedCount - 5} more`);
+        }
         if (review3) {
           log(`Staged source review at ${review3.reviewPath}.`);
         }
@@ -849,8 +861,9 @@ graph.command("serve").description("Serve the local graph viewer.").option("--po
 });
 graph.command("export").description(
   "Export the graph as HTML, report, SVG, GraphML, Cypher, JSON, Obsidian vault, or Obsidian canvas. Combine flags to write multiple formats in one run."
-).option("--html <output>", "Output HTML file path").option("--html-standalone <output>", "Output lightweight standalone HTML file path (vis.js, no build tooling)").option("--report <output>", "Output self-contained HTML report (graph stats, key nodes, communities)").option("--svg <output>", "Output SVG file path").option("--graphml <output>", "Output GraphML file path").option("--cypher <output>", "Output Cypher file path").option("--json <output>", "Output JSON file path").option("--obsidian <output>", "Output Obsidian vault directory path").option("--canvas <output>", "Output Obsidian canvas file path").option("--full", "Disable overview sampling for HTML export", false).action(
+).option("--html <output>", "Output HTML file path").option("--html-standalone <output>", "Output lightweight standalone HTML file path (vis.js, no build tooling)").option("--report <output>", "Output self-contained HTML report (graph stats, key nodes, communities)").option("--svg <output>", "Output SVG file path").option("--graphml <output>", "Output GraphML file path").option("--cypher <output>", "Output Cypher file path").option("--json <output>", "Output JSON file path").option("--obsidian <output>", "Output Obsidian vault directory path").option("--canvas <output>", "Output Obsidian canvas file path").option("--full", "Include the full graph in HTML export (default; queries traverse complete graph)", true).option("--overview", "Use overview sampling for HTML export (smaller file, queries limited to sampled nodes)", false).action(
   async (options) => {
+    const useFullGraph = options.overview ? false : options.full ?? true;
     const targets = [
       options.html ? { format: "html", outputPath: options.html } : null,
       options.htmlStandalone ? { format: "html-standalone", outputPath: options.htmlStandalone } : null,
@@ -870,7 +883,7 @@ graph.command("export").description(
     const results = [];
     for (const target of targets) {
       if (target.format === "html") {
-        const outputPath = await exportGraphHtml(process2.cwd(), target.outputPath, { full: options.full ?? false });
+        const outputPath = await exportGraphHtml(process2.cwd(), target.outputPath, { full: useFullGraph });
         results.push({ format: target.format, outputPath });
       } else if (target.format === "report") {
         const result = await exportGraphReportHtml(process2.cwd(), target.outputPath);
@@ -1032,6 +1045,35 @@ candidate.command("archive").description("Archive a candidate by removing it fro
     log(`Archived ${result.pageId}`);
   }
 });
+candidate.command("auto-promote").description("Apply configured auto-promotion rules to staged candidates. Requires candidate.autoPromote.enabled in config.").option("--dry-run", "Score candidates without moving files", false).action(async (options) => {
+  const result = await runAutoPromotion(process2.cwd(), { dryRun: options.dryRun ?? false });
+  if (isJson()) {
+    emitJson(result);
+    return;
+  }
+  log(
+    `${result.dryRun ? "Dry-run" : "Promoted"} ${result.promotedPageIds.length} of ${result.decisions.length} candidates. Session: ${result.sessionPath ?? "none"}`
+  );
+  for (const decision of result.decisions) {
+    const mark = decision.promote ? result.promotedPageIds.includes(decision.pageId) ? "+" : "~" : "-";
+    log(`  ${mark} ${decision.pageId} score=${decision.score.toFixed(2)} ${decision.reasons.join("; ")}`);
+  }
+});
+candidate.command("preview-scores").description("Show promotion scores for staged candidates without promoting.").action(async () => {
+  const decisions = await previewCandidatePromotions(process2.cwd());
+  if (isJson()) {
+    emitJson(decisions);
+    return;
+  }
+  if (!decisions.length) {
+    log("No candidates to score.");
+    return;
+  }
+  for (const decision of decisions) {
+    const verdict = decision.promote ? "promote" : "skip";
+    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) => {
   const debounceMs = parsePositiveInt(options.debounce, 900);
   if (options.once) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/cli",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "description": "Global CLI for SwarmVault.",
   "type": "module",
   "main": "dist/index.js",
@@ -44,7 +44,7 @@
     "prepublishOnly": "node ../../scripts/check-release-sync.mjs && node ../../scripts/check-published-manifests.mjs"
   },
   "dependencies": {
-    "@swarmvaultai/engine": "0.7.30",
+    "@swarmvaultai/engine": "0.7.31",
     "commander": "^14.0.1"
   },
   "devDependencies": {