@swarmvaultai/cli 0.2.2 → 0.4.0

package/dist/index.js

@@ -19,7 +19,7 @@ import {
   getWatchStatus,
   importInbox,
   ingestDirectory,
-  ingestInput,
+  ingestInputDetailed,
   initVault,
   installAgent,
   installGitHooks,
@@ -28,6 +28,7 @@ import {
   listCandidates,
   listGodNodes,
   listManagedSourceRecords,
+  listManifests,
   listSchedules,
   loadVaultConfig,
   pathGraphVault,
@@ -38,6 +39,8 @@ import {
   readApproval,
   rejectApproval,
   reloadManagedSources,
+  reviewManagedSource,
+  reviewSourceScope,
   runSchedule,
   runWatchCycle,
   serveSchedules,
@@ -221,9 +224,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.2.2";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "0.4.0";
   } catch {
-    return "0.2.2";
+    return "0.4.0";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -281,7 +284,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("--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").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("--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").action(
   async (input, options) => {
     const maxAssetSize = typeof options.maxAssetSize === "string" && options.maxAssetSize.trim() ? parsePositiveInt(options.maxAssetSize, 0) || void 0 : void 0;
     const maxFiles = typeof options.maxFiles === "string" && options.maxFiles.trim() ? parsePositiveInt(options.maxFiles, 0) || void 0 : void 0;
@@ -305,20 +308,59 @@ program.command("ingest").description("Ingest a local file path, directory path,
       (fs) => fs.stat(input).then((stat) => stat.isDirectory() ? ingestDirectory(process2.cwd(), input, commonOptions) : null).catch(() => null)
     ) : null;
     if (directoryResult) {
+      const review3 = options.review && (directoryResult.imported.length || directoryResult.updated.length) ? await (async () => {
+        await compileVault(process2.cwd(), {});
+        const pathModule = await import("path");
+        const absoluteInput = pathModule.resolve(process2.cwd(), input);
+        const sourceIds = (await listManifests(process2.cwd())).filter((manifest) => {
+          if (!manifest.originalPath) {
+            return false;
+          }
+          const relative = pathModule.relative(absoluteInput, pathModule.resolve(manifest.originalPath));
+          return relative === "" || !relative.startsWith("..") && !pathModule.isAbsolute(relative);
+        }).map((manifest) => manifest.sourceId);
+        return sourceIds.length ? await reviewSourceScope(process2.cwd(), {
+          id: `directory-${absoluteInput.split(pathModule.sep).pop() ?? "source"}`,
+          title: absoluteInput.split(pathModule.sep).pop() ?? absoluteInput,
+          sourceIds
+        }) : void 0;
+      })() : void 0;
       if (isJson()) {
-        emitJson(directoryResult);
+        emitJson(review3 ? { ingest: directoryResult, review: review3 } : directoryResult);
       } else {
         log(
           `Imported ${directoryResult.imported.length} file(s), updated ${directoryResult.updated.length}, skipped ${directoryResult.skipped.length}.`
         );
+        if (review3) {
+          log(`Staged source review at ${review3.reviewPath}.`);
+        }
       }
       return;
     }
-    const manifest = await ingestInput(process2.cwd(), input, commonOptions);
+    const ingest = await ingestInputDetailed(process2.cwd(), input, commonOptions);
+    const review2 = options.review && (ingest.created.length || ingest.updated.length || ingest.unchanged.length) ? await (async () => {
+      await compileVault(process2.cwd(), {});
+      const scopeSourceIds = [...ingest.created, ...ingest.updated, ...ingest.unchanged].map((manifest) => manifest.sourceId);
+      return await reviewSourceScope(process2.cwd(), {
+        id: ingest.created[0]?.sourceGroupId ?? ingest.updated[0]?.sourceGroupId ?? ingest.unchanged[0]?.sourceGroupId ?? scopeSourceIds[0],
+        title: [...ingest.created, ...ingest.updated, ...ingest.unchanged][0]?.sourceGroupTitle ?? [...ingest.created, ...ingest.updated, ...ingest.unchanged][0]?.title ?? input,
+        sourceIds: scopeSourceIds
+      });
+    })() : void 0;
     if (isJson()) {
-      emitJson(manifest);
+      emitJson(review2 ? { ingest, review: review2 } : ingest);
     } else {
-      log(manifest.sourceId);
+      const primary = [...ingest.created, ...ingest.updated, ...ingest.unchanged][0];
+      if (ingest.created.length + ingest.updated.length + ingest.removed.length <= 1 && primary) {
+        log(primary.sourceId);
+      } else {
+        log(
+          `Created ${ingest.created.length}, updated ${ingest.updated.length}, unchanged ${ingest.unchanged.length}, removed ${ingest.removed.length}.`
+        );
+      }
+      if (review2) {
+        log(`Staged source review at ${review2.reviewPath}.`);
+      }
     }
   }
 );
@@ -333,22 +375,25 @@ program.command("add").description("Capture supported URLs into normalized markd
     log(`${result.captureType}${result.fallback ? " (fallback)" : ""}: ${result.manifest.sourceId}`);
   }
 });
-var source = program.command("source").description("Manage recurring directory, public repo, and docs sources.");
-source.command("add").description("Register and sync a managed source from a directory, public GitHub repo root URL, or docs hub URL.").argument("<input>", "Directory path, public GitHub repo root URL, or docs hub URL").option("--no-compile", "Register and sync without compiling the vault").option("--no-brief", "Skip source brief generation after sync").option("--max-pages <n>", "Maximum number of pages to crawl for docs sources").option("--max-depth <n>", "Maximum crawl depth for docs sources").action(async (input, options) => {
-  const result = await addManagedSource(process2.cwd(), input, {
-    compile: options.compile,
-    brief: options.brief,
-    maxPages: options.maxPages ? parsePositiveInt(options.maxPages, 0) || void 0 : void 0,
-    maxDepth: options.maxDepth ? parsePositiveInt(options.maxDepth, 0) || void 0 : void 0
-  });
-  if (isJson()) {
-    emitJson(result);
-  } else {
-    log(
-      `Registered ${result.source.kind} source ${result.source.id}. Status: ${result.source.status}.${result.compile ? ` Compiled ${result.compile.sourceCount} source(s).` : ""}${result.briefGenerated ? ` Brief: ${result.source.briefPath}` : ""}`
-    );
+var source = program.command("source").description("Manage recurring local files, directories, public repos, and docs sources.");
+source.command("add").description("Register and sync a managed source from a local file, directory, public GitHub repo root URL, or docs hub URL.").argument("<input>", "Local file path, directory path, public GitHub repo root URL, or docs hub URL").option("--no-compile", "Register and sync without compiling the vault").option("--no-brief", "Skip source brief generation after sync").option("--review", "Stage a source review artifact after sync and compile", false).option("--max-pages <n>", "Maximum number of pages to crawl for docs sources").option("--max-depth <n>", "Maximum crawl depth for docs sources").action(
+  async (input, options) => {
+    const result = await addManagedSource(process2.cwd(), input, {
+      compile: options.compile,
+      brief: options.brief,
+      review: options.review,
+      maxPages: options.maxPages ? parsePositiveInt(options.maxPages, 0) || void 0 : void 0,
+      maxDepth: options.maxDepth ? parsePositiveInt(options.maxDepth, 0) || void 0 : void 0
+    });
+    if (isJson()) {
+      emitJson(result);
+    } else {
+      log(
+        `Registered ${result.source.kind} source ${result.source.id}. Status: ${result.source.status}.${result.compile ? ` Compiled ${result.compile.sourceCount} source(s).` : ""}${result.briefGenerated ? ` Brief: ${result.source.briefPath}` : ""}${result.review ? ` Review: ${result.review.reviewPath}` : ""}`
+      );
+    }
   }
-});
+);
 source.command("list").description("List managed sources registered in this vault.").action(async () => {
   const sources = await listManagedSourceRecords(process2.cwd());
   if (isJson()) {
@@ -388,6 +433,14 @@ source.command("delete").description("Unregister a managed source and remove its
     log(`Deleted managed source ${result.removed.id}. Canonical vault content was left in place.`);
   }
 });
+source.command("review").description("Stage a source review artifact for a managed source id or raw source id.").argument("<id>", "Managed source id or raw source id").action(async (id) => {
+  const result = await reviewManagedSource(process2.cwd(), id);
+  if (isJson()) {
+    emitJson(result);
+  } else {
+    log(`Staged source review at ${result.reviewPath}.`);
+  }
+});
 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(process2.cwd(), dir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/cli",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "Global CLI for SwarmVault.",
   "type": "module",
   "main": "dist/index.js",
@@ -38,7 +38,7 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@swarmvaultai/engine": "0.2.2",
+    "@swarmvaultai/engine": "0.4.0",
     "commander": "^14.0.1"
   },
   "devDependencies": {