@swarmvaultai/cli 0.1.30 → 0.1.31

package/README.md

@@ -135,7 +135,8 @@ Measure graph-guided context reduction against a naive full-corpus read.
 Inspect and resolve staged approval bundles created by `swarmvault compile --approve`.
 
 - `review list` shows pending, accepted, and rejected entry counts per bundle
-- `review show <approvalId>` shows each staged entry plus its current and staged content
+- `review show <approvalId>` shows each staged entry plus its current and staged content, including a section-level change summary when available
+- `review show <approvalId> --diff` adds a unified diff between current and staged content
 - `review accept <approvalId> [targets...]` applies pending entries to the live wiki
 - `review reject <approvalId> [targets...]` marks pending entries as rejected without mutating active wiki paths
 
@@ -179,13 +180,14 @@ Each step:
 
 The command also writes a hub page linking the root question, saved step pages, and generated follow-up questions.
 
-### `swarmvault lint [--deep] [--web]`
+### `swarmvault lint [--deep] [--web] [--conflicts]`
 
-Run anti-drift and vault health checks such as stale pages, missing graph artifacts, and other structural issues.
+Run anti-drift and vault health checks such as stale pages, missing graph artifacts, contradiction findings, and other structural issues.
 
 `--deep` adds an LLM-powered advisory pass that can report:
 
 - `coverage_gap`
+- `contradiction`
 - `contradiction_candidate`
 - `missing_citation`
 - `candidate_page`
@@ -193,6 +195,8 @@ Run anti-drift and vault health checks such as stale pages, missing graph artifa
 
 `--web` can only be used with `--deep`. It enriches deep-lint findings with external evidence snippets and URLs from a configured web-search provider.
 
+`--conflicts` filters the results down to contradiction-focused findings so you can audit conflicting claims without the rest of the lint output.
+
 ### `swarmvault watch [--lint] [--repo] [--once] [--debounce <ms>]`
 
 Watch the inbox directory and trigger import and compile cycles when files change. With `--repo`, each cycle also refreshes tracked repo roots that were previously ingested through directory ingest. With `--once`, SwarmVault runs one refresh cycle immediately instead of starting a long-running watcher. With `--lint`, each cycle also runs linting. Each cycle writes a canonical session artifact to `state/sessions/`, and compatibility run metadata is still appended to `state/jobs.ndjson`.

package/dist/index.js

@@ -217,9 +217,9 @@ program.name("swarmvault").description("SwarmVault is a local-first LLM wiki com
 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.1.30";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "0.1.31";
   } catch {
-    return "0.1.30";
+    return "0.1.31";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -397,10 +397,11 @@ program.command("benchmark").description("Measure graph-guided context reduction
     log(`Reduction ratio: ${(result.reductionRatio * 100).toFixed(1)}%`);
   }
 });
-program.command("lint").description("Run anti-drift and wiki-health checks.").option("--deep", "Run LLM-powered advisory lint", false).option("--web", "Augment deep lint with configured web search", false).action(async (options) => {
+program.command("lint").description("Run anti-drift and wiki-health checks.").option("--deep", "Run LLM-powered advisory lint", false).option("--web", "Augment deep lint with configured web search", false).option("--conflicts", "Filter to contradiction findings only", false).action(async (options) => {
   const findings = await lintVault(process2.cwd(), {
     deep: options.deep ?? false,
-    web: options.web ?? false
+    web: options.web ?? false,
+    conflicts: options.conflicts ?? false
   });
   if (isJson()) {
     emitJson(findings);
@@ -542,8 +543,8 @@ review.command("list").description("List staged approval bundles and their resol
     );
   }
 });
-review.command("show").description("Show the entries inside a staged approval bundle.").argument("<approvalId>", "Approval bundle identifier").action(async (approvalId) => {
-  const approval = await readApproval(process2.cwd(), approvalId);
+review.command("show").description("Show the entries inside a staged approval bundle.").argument("<approvalId>", "Approval bundle identifier").option("--diff", "Show unified diff for each entry", false).action(async (approvalId, options) => {
+  const approval = await readApproval(process2.cwd(), approvalId, { diff: options.diff });
   if (isJson()) {
     emitJson(approval);
     return;
@@ -551,6 +552,12 @@ review.command("show").description("Show the entries inside a staged approval bu
   log(`${approval.approvalId} pending=${approval.pendingCount} accepted=${approval.acceptedCount} rejected=${approval.rejectedCount}`);
   for (const entry of approval.entries) {
     log(`- ${entry.status} ${entry.changeType} ${entry.pageId} ${entry.nextPath ?? entry.previousPath ?? ""}`.trim());
+    if (entry.changeSummary) log(`  Summary: ${entry.changeSummary}`);
+    if (entry.diff) {
+      log("");
+      log(entry.diff);
+      log("");
+    }
   }
 });
 review.command("accept").description("Accept all pending entries, or selected entries, from a staged approval bundle.").argument("<approvalId>", "Approval bundle identifier").argument("[targets...]", "Optional page ids or paths to accept").action(async (approvalId, targets) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/cli",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "Global CLI for SwarmVault.",
   "type": "module",
   "main": "dist/index.js",
@@ -43,7 +43,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@swarmvaultai/engine": "0.1.30",
+    "@swarmvaultai/engine": "0.1.31",
     "commander": "^14.0.1"
   },
   "devDependencies": {