@viberaven/cli 1.5.1 → 1.5.2

package/dist/cli.js

@@ -14567,7 +14567,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "1.5.1";
+    VERSION = "1.5.2";
   }
 });
 
@@ -17266,6 +17266,131 @@ var init_runAudit = __esm({
   }
 });
 
+// src/commands/cleanPlan.ts
+function buildContextCleanupPlan(input) {
+  const items = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const file of input.files) {
+    const path = normalizePath5((0, import_node_path29.relative)(input.projectRoot, file.path) || file.path);
+    const fullPath = normalizePath5(file.path);
+    const category = categorizeCleanupFile(path, fullPath, file);
+    if (!category || seen.has(path)) {
+      continue;
+    }
+    seen.add(path);
+    items.push({
+      path,
+      category,
+      action: "review-ignore-or-exclude-manually",
+      reason: reasonForCategory(category)
+    });
+  }
+  return {
+    title: "VibeRaven context cleanup plan",
+    warning: "VibeRaven only writes this review plan. Review each item manually before changing ignore rules or excluding artifacts from agent context.",
+    items
+  };
+}
+async function collectCleanupFiles(projectRoot) {
+  const files = [];
+  await walkCleanupFiles(projectRoot, projectRoot, files, 0);
+  return files;
+}
+async function writeCleanupPlan(projectRoot, plan) {
+  const outputDir = (0, import_node_path29.join)(projectRoot, ".viberaven");
+  const outputPath = (0, import_node_path29.join)(outputDir, "context-cleanup.md");
+  await (0, import_promises23.mkdir)(outputDir, { recursive: true });
+  await (0, import_promises23.writeFile)(outputPath, renderCleanupPlan(plan), "utf8");
+  return outputPath;
+}
+function categorizeCleanupFile(relativePath, fullPath, file) {
+  if (relativePath.startsWith(".viberaven/") || fullPath.includes("/.viberaven/")) {
+    return "generated-artifact";
+  }
+  if (isCachePath(relativePath)) {
+    return "cache-directory";
+  }
+  if (relativePath.endsWith(".log") && file.sizeBytes >= LARGE_LOG_BYTES) {
+    return "large-log";
+  }
+  return void 0;
+}
+function isCachePath(path) {
+  return path === ".next/cache" || path.startsWith(".next/cache/") || path === ".turbo" || path.startsWith(".turbo/") || path === ".vite" || path.startsWith(".vite/") || path.includes("/node_modules/.cache/") || path.endsWith("/node_modules/.cache");
+}
+function reasonForCategory(category) {
+  switch (category) {
+    case "generated-artifact":
+      return "Generated VibeRaven artifact. Keep current scan outputs, but avoid loading old reports into agent context.";
+    case "large-log":
+      return "Large log file that can add token noise. Review it before changing ignore rules or excluding it from agent context.";
+    case "cache-directory":
+      return "Build cache evidence. Do not load it into agent context unless debugging build internals.";
+  }
+}
+function renderCleanupPlan(plan) {
+  const lines = ["# VibeRaven context cleanup plan", "", plan.warning, ""];
+  if (plan.items.length === 0) {
+    lines.push("No noisy generated artifacts, large logs, or cache directories were found by the conservative scanner.");
+  }
+  for (const item4 of plan.items) {
+    lines.push(`- ${item4.path}`);
+    lines.push(`  - Category: ${item4.category}`);
+    lines.push(`  - Action: ${item4.action}`);
+    lines.push(`  - Reason: ${item4.reason}`);
+  }
+  return `${lines.join("\n")}
+`;
+}
+async function walkCleanupFiles(root, dir, result, depth) {
+  if (depth > MAX_WALK_DEPTH) {
+    return;
+  }
+  let entries;
+  try {
+    entries = await (0, import_promises23.readdir)(dir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (SKIP_DIRECTORIES.has(entry.name)) {
+      continue;
+    }
+    const absolute = (0, import_node_path29.join)(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (isCachePath(normalizePath5((0, import_node_path29.relative)(root, absolute)))) {
+        result.push({ path: absolute, sizeBytes: 0, kind: "directory" });
+        continue;
+      }
+      await walkCleanupFiles(root, absolute, result, depth + 1);
+      continue;
+    }
+    if (!entry.isFile()) {
+      continue;
+    }
+    try {
+      const fileStat = await (0, import_promises23.stat)(absolute);
+      result.push({ path: absolute, sizeBytes: fileStat.size, kind: "file" });
+    } catch {
+      continue;
+    }
+  }
+}
+function normalizePath5(path) {
+  return path.replace(/\\/g, "/");
+}
+var import_promises23, import_node_path29, MAX_WALK_DEPTH, LARGE_LOG_BYTES, SKIP_DIRECTORIES;
+var init_cleanPlan = __esm({
+  "src/commands/cleanPlan.ts"() {
+    "use strict";
+    import_promises23 = require("node:fs/promises");
+    import_node_path29 = require("node:path");
+    MAX_WALK_DEPTH = 5;
+    LARGE_LOG_BYTES = 8192;
+    SKIP_DIRECTORIES = /* @__PURE__ */ new Set([".git", "node_modules"]);
+  }
+});
+
 // src/actions/render.ts
 function redact(text) {
   return redactString(text).replace(/\[REDACTED(?:_[A-Z_]+)?\]/g, "<redacted>").replace(
@@ -17368,10 +17493,10 @@ var init_render = __esm({
 
 // src/commands/actions.ts
 async function runActionsCommand(input) {
-  const actionsPath = (0, import_node_path29.join)(getProjectArtifactsDir(input.cwd), "actions.json");
+  const actionsPath = (0, import_node_path30.join)(getProjectArtifactsDir(input.cwd), "actions.json");
   let raw;
   try {
-    raw = await (0, import_promises23.readFile)(actionsPath, "utf8");
+    raw = await (0, import_promises24.readFile)(actionsPath, "utf8");
   } catch {
     process.stderr.write("No VibeRaven actions found. Run `npx -y viberaven --agent-mode` first.\n");
     return 1;
@@ -17385,12 +17510,12 @@ async function runActionsCommand(input) {
   process.stdout.write(renderActionSurface(manifest));
   return 0;
 }
-var import_promises23, import_node_path29;
+var import_promises24, import_node_path30;
 var init_actions = __esm({
   "src/commands/actions.ts"() {
     "use strict";
-    import_promises23 = require("node:fs/promises");
-    import_node_path29 = require("node:path");
+    import_promises24 = require("node:fs/promises");
+    import_node_path30 = require("node:path");
     init_render();
     init_config();
   }
@@ -17399,7 +17524,7 @@ var init_actions = __esm({
 // src/commands/verifyAction.ts
 async function currentActionExists(cwd, actionId) {
   try {
-    const raw = await (0, import_promises24.readFile)((0, import_node_path30.join)(getProjectArtifactsDir(cwd), "actions.json"), "utf8");
+    const raw = await (0, import_promises25.readFile)((0, import_node_path31.join)(getProjectArtifactsDir(cwd), "actions.json"), "utf8");
     const manifest = JSON.parse(raw);
     return manifest.actions.some((action) => action.id === actionId);
   } catch {
@@ -17443,12 +17568,12 @@ Run \`npx -y viberaven --verify\` to refresh the production gate for this action
   );
   return 0;
 }
-var import_promises24, import_node_path30;
+var import_promises25, import_node_path31;
 var init_verifyAction = __esm({
   "src/commands/verifyAction.ts"() {
     "use strict";
-    import_promises24 = require("node:fs/promises");
-    import_node_path30 = require("node:path");
+    import_promises25 = require("node:fs/promises");
+    import_node_path31 = require("node:path");
     init_registry2();
     init_config();
   }
@@ -18076,8 +18201,8 @@ function isSqlError(error) {
 }
 function displayPath(projectDir, path) {
   for (const base of [projectDir, process.cwd()]) {
-    const rel = (0, import_node_path31.relative)(base, path);
-    if (rel && !rel.startsWith("..") && !(0, import_node_path31.isAbsolute)(rel)) return rel.split("\\").join("/");
+    const rel = (0, import_node_path32.relative)(base, path);
+    if (rel && !rel.startsWith("..") && !(0, import_node_path32.isAbsolute)(rel)) return rel.split("\\").join("/");
   }
   return path;
 }
@@ -18681,26 +18806,26 @@ function verdictFor(summary) {
 }
 async function listMigrations(dir) {
   try {
-    const entries = await (0, import_promises25.readdir)(dir, { withFileTypes: true });
+    const entries = await (0, import_promises26.readdir)(dir, { withFileTypes: true });
     return entries.filter((e2) => e2.isFile() && /\.sql$/i.test(e2.name) && !e2.name.startsWith(".")).map((e2) => e2.name).sort((a, b3) => a < b3 ? -1 : a > b3 ? 1 : 0);
   } catch {
     return [];
   }
 }
 async function runRlsTest(options) {
-  const projectDir = (0, import_node_path31.resolve)(options.projectDir);
-  const matrixPath = (0, import_node_path31.resolve)(projectDir, options.matrixPath ?? DEFAULT_MATRIX_FILE);
-  const migrationsDir = (0, import_node_path31.resolve)(projectDir, options.migrationsDir ?? (0, import_node_path31.join)("supabase", "migrations"));
+  const projectDir = (0, import_node_path32.resolve)(options.projectDir);
+  const matrixPath = (0, import_node_path32.resolve)(projectDir, options.matrixPath ?? DEFAULT_MATRIX_FILE);
+  const migrationsDir = (0, import_node_path32.resolve)(projectDir, options.migrationsDir ?? (0, import_node_path32.join)("supabase", "migrations"));
   const timeouts = { ...DEFAULT_TIMEOUTS, ...options.timeouts };
-  if ((0, import_node_path31.basename)(matrixPath).toLowerCase().startsWith(".env")) {
-    throw new RlsInputError(`Refusing to read ${(0, import_node_path31.basename)(matrixPath)}: rls-test never reads .env files. Point --matrix at a viberaven.permissions.json.`);
+  if ((0, import_node_path32.basename)(matrixPath).toLowerCase().startsWith(".env")) {
+    throw new RlsInputError(`Refusing to read ${(0, import_node_path32.basename)(matrixPath)}: rls-test never reads .env files. Point --matrix at a viberaven.permissions.json.`);
   }
   const filesRead = [];
   let matrixText;
   try {
-    const info = await (0, import_promises25.stat)(matrixPath);
+    const info = await (0, import_promises26.stat)(matrixPath);
     if (!info.isFile()) throw new Error("not a file");
-    matrixText = normalise(await (0, import_promises25.readFile)(matrixPath, "utf8"));
+    matrixText = normalise(await (0, import_promises26.readFile)(matrixPath, "utf8"));
   } catch {
     throw new RlsInputError(
       `No permissions matrix at ${matrixPath}. Write one by hand (schema: schemas/permissions-matrix.schema.json in the @viberaven/cli package); rls-test never infers it from your policies.`
@@ -18711,8 +18836,8 @@ async function runRlsTest(options) {
   const names = await listMigrations(migrationsDir);
   const migrationFiles = [];
   for (const name of names) {
-    const sql = normalise(await (0, import_promises25.readFile)((0, import_node_path31.join)(migrationsDir, name), "utf8"));
-    filesRead.push(displayPath(projectDir, (0, import_node_path31.join)(migrationsDir, name)));
+    const sql = normalise(await (0, import_promises26.readFile)((0, import_node_path32.join)(migrationsDir, name), "utf8"));
+    filesRead.push(displayPath(projectDir, (0, import_node_path32.join)(migrationsDir, name)));
     migrationFiles.push({ name, sha256: sha256(sql), sql });
   }
   const migrationsHash = sha256(migrationFiles.map((f) => `${f.name}\0${f.sha256}`).join("\n"));
@@ -18912,15 +19037,15 @@ async function runTable(db, table, badRoles, roleChecks) {
     cells
   };
 }
-var import_node_child_process6, import_node_crypto2, import_promises25, import_node_net, import_node_path31, import_node_util4, NON_AUTHORITATIVE_LABEL, PGLITE_INSTALL_HINT, ENV_ALLOWLIST, PERMISSION_DENIED, RLS_REFUSAL, DEFAULT_TIMEOUTS, RlsInputError, normalise, quoteIdent2, firstLine, plural2, NUMBERS, ACTOR_SESSION, changedRows, isRlsRefusal, isPrivilegeRefusal, SELF, PROBE_EXCLUSIONS, SEED_HINTS;
+var import_node_child_process6, import_node_crypto2, import_promises26, import_node_net, import_node_path32, import_node_util4, NON_AUTHORITATIVE_LABEL, PGLITE_INSTALL_HINT, ENV_ALLOWLIST, PERMISSION_DENIED, RLS_REFUSAL, DEFAULT_TIMEOUTS, RlsInputError, normalise, quoteIdent2, firstLine, plural2, NUMBERS, ACTOR_SESSION, changedRows, isRlsRefusal, isPrivilegeRefusal, SELF, PROBE_EXCLUSIONS, SEED_HINTS;
 var init_rlsRunner = __esm({
   "src/rls/rlsRunner.ts"() {
     "use strict";
     import_node_child_process6 = require("node:child_process");
     import_node_crypto2 = require("node:crypto");
-    import_promises25 = require("node:fs/promises");
+    import_promises26 = require("node:fs/promises");
     import_node_net = __toESM(require("node:net"));
-    import_node_path31 = require("node:path");
+    import_node_path32 = require("node:path");
     import_node_util4 = require("node:util");
     init_safeGit();
     init_permissionsMatrix();
@@ -19085,131 +19210,6 @@ var init_rlsTest = __esm({
   }
 });
 
-// src/commands/cleanPlan.ts
-function buildContextCleanupPlan(input) {
-  const items = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const file of input.files) {
-    const path = normalizePath5((0, import_node_path32.relative)(input.projectRoot, file.path) || file.path);
-    const fullPath = normalizePath5(file.path);
-    const category = categorizeCleanupFile(path, fullPath, file);
-    if (!category || seen.has(path)) {
-      continue;
-    }
-    seen.add(path);
-    items.push({
-      path,
-      category,
-      action: "review-ignore-or-exclude-manually",
-      reason: reasonForCategory(category)
-    });
-  }
-  return {
-    title: "VibeRaven context cleanup plan",
-    warning: "VibeRaven only writes this review plan. Review each item manually before changing ignore rules or excluding artifacts from agent context.",
-    items
-  };
-}
-async function collectCleanupFiles(projectRoot) {
-  const files = [];
-  await walkCleanupFiles(projectRoot, projectRoot, files, 0);
-  return files;
-}
-async function writeCleanupPlan(projectRoot, plan) {
-  const outputDir = (0, import_node_path32.join)(projectRoot, ".viberaven");
-  const outputPath = (0, import_node_path32.join)(outputDir, "context-cleanup.md");
-  await (0, import_promises26.mkdir)(outputDir, { recursive: true });
-  await (0, import_promises26.writeFile)(outputPath, renderCleanupPlan(plan), "utf8");
-  return outputPath;
-}
-function categorizeCleanupFile(relativePath, fullPath, file) {
-  if (relativePath.startsWith(".viberaven/") || fullPath.includes("/.viberaven/")) {
-    return "generated-artifact";
-  }
-  if (isCachePath(relativePath)) {
-    return "cache-directory";
-  }
-  if (relativePath.endsWith(".log") && file.sizeBytes >= LARGE_LOG_BYTES) {
-    return "large-log";
-  }
-  return void 0;
-}
-function isCachePath(path) {
-  return path === ".next/cache" || path.startsWith(".next/cache/") || path === ".turbo" || path.startsWith(".turbo/") || path === ".vite" || path.startsWith(".vite/") || path.includes("/node_modules/.cache/") || path.endsWith("/node_modules/.cache");
-}
-function reasonForCategory(category) {
-  switch (category) {
-    case "generated-artifact":
-      return "Generated VibeRaven artifact. Keep current scan outputs, but avoid loading old reports into agent context.";
-    case "large-log":
-      return "Large log file that can add token noise. Review it before changing ignore rules or excluding it from agent context.";
-    case "cache-directory":
-      return "Build cache evidence. Do not load it into agent context unless debugging build internals.";
-  }
-}
-function renderCleanupPlan(plan) {
-  const lines = ["# VibeRaven context cleanup plan", "", plan.warning, ""];
-  if (plan.items.length === 0) {
-    lines.push("No noisy generated artifacts, large logs, or cache directories were found by the conservative scanner.");
-  }
-  for (const item4 of plan.items) {
-    lines.push(`- ${item4.path}`);
-    lines.push(`  - Category: ${item4.category}`);
-    lines.push(`  - Action: ${item4.action}`);
-    lines.push(`  - Reason: ${item4.reason}`);
-  }
-  return `${lines.join("\n")}
-`;
-}
-async function walkCleanupFiles(root, dir, result, depth) {
-  if (depth > MAX_WALK_DEPTH) {
-    return;
-  }
-  let entries;
-  try {
-    entries = await (0, import_promises26.readdir)(dir, { withFileTypes: true });
-  } catch {
-    return;
-  }
-  for (const entry of entries) {
-    if (SKIP_DIRECTORIES.has(entry.name)) {
-      continue;
-    }
-    const absolute = (0, import_node_path32.join)(dir, entry.name);
-    if (entry.isDirectory()) {
-      if (isCachePath(normalizePath5((0, import_node_path32.relative)(root, absolute)))) {
-        result.push({ path: absolute, sizeBytes: 0, kind: "directory" });
-        continue;
-      }
-      await walkCleanupFiles(root, absolute, result, depth + 1);
-      continue;
-    }
-    if (!entry.isFile()) {
-      continue;
-    }
-    try {
-      const fileStat = await (0, import_promises26.stat)(absolute);
-      result.push({ path: absolute, sizeBytes: fileStat.size, kind: "file" });
-    } catch {
-      continue;
-    }
-  }
-}
-function normalizePath5(path) {
-  return path.replace(/\\/g, "/");
-}
-var import_promises26, import_node_path32, MAX_WALK_DEPTH, LARGE_LOG_BYTES, SKIP_DIRECTORIES;
-var init_cleanPlan = __esm({
-  "src/commands/cleanPlan.ts"() {
-    "use strict";
-    import_promises26 = require("node:fs/promises");
-    import_node_path32 = require("node:path");
-    MAX_WALK_DEPTH = 5;
-    LARGE_LOG_BYTES = 8192;
-    SKIP_DIRECTORIES = /* @__PURE__ */ new Set([".git", "node_modules"]);
-  }
-});
-
 // src/report/providerLogos.ts
 function providerAssetUrl(key) {
   const file = PROVIDER_ASSET_FILES[key];
@@ -24219,6 +24219,9 @@ Usage:
   viberaven audit --vercel-supabase [--json] [path]
                        Local Vercel/Supabase repo evidence audit (RLS, pooler, secrets)
 
+  viberaven clean --plan [path]
+                       Write a non-destructive context cleanup review plan (.viberaven/context-cleanup.md)
+
   viberaven rls-test [--matrix viberaven.permissions.json] [--migrations dir] [--json] [path]
                        Experimental: run the Supabase migrations in a PGlite imitation and test who can
                        read, change and delete rows against your permissions matrix (non-authoritative)
@@ -24738,6 +24741,19 @@ async function main() {
         cwd: positional[0] ? (0, import_node_path38.resolve)(process.cwd(), positional[0]) : process.cwd(),
         json: Boolean(flags.json)
       });
+    case "clean": {
+      if (flags.plan !== true) {
+        console.error("Usage: viberaven clean --plan [path]");
+        return 1;
+      }
+      const cwd = positional[0] ? (0, import_node_path38.resolve)(process.cwd(), positional[0]) : process.cwd();
+      const plan = buildContextCleanupPlan({ projectRoot: cwd, files: await collectCleanupFiles(cwd) });
+      const outputPath = await writeCleanupPlan(cwd, plan);
+      console.log(`Wrote ${outputPath}
+`);
+      console.log(renderCleanupPlan(plan).trimEnd());
+      return 0;
+    }
     case "rls-test":
       return runRlsTestCommand({
         cwd: positional[0] ? (0, import_node_path38.resolve)(process.cwd(), positional[0]) : process.cwd(),
@@ -24782,6 +24798,7 @@ var init_cli = __esm({
     init_runDoctor();
     init_runValidateNpmPackage();
     init_runAudit();
+    init_cleanPlan();
     init_actions();
     init_verifyAction();
     init_preview();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viberaven/cli",
-  "version": "1.5.1",
+  "version": "1.5.2",
   "description": "Local Studio cockpit for AI-built apps: agentic chat, provider context, release review, diffs, and approval-controlled repo work.",
   "license": "MIT",
   "author": "VibeRaven",