@staff0rd/assist 0.262.0 → 0.263.0

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.262.0",
+  version: "0.263.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -204,6 +204,10 @@ var assistConfigSchema = z2.strictObject({
   hardcodedColors: z2.strictObject({
     ignore: z2.array(z2.string()).default([])
   }).optional(),
+  commentPolicy: z2.strictObject({
+    ignore: z2.array(z2.string()).default([]),
+    markers: z2.array(z2.string()).default(["HACK:", "why:"])
+  }).optional(),
   restructure: z2.strictObject({
     ignore: z2.array(z2.string()).default([])
   }).optional(),
@@ -1815,24 +1819,166 @@ function lint(options2 = {}) {
 }
 
 // src/commands/new/registerNew/newCli/index.ts
-import { execSync as execSync11 } from "child_process";
+import { execSync as execSync12 } from "child_process";
 import { basename, resolve as resolve5 } from "path";
 
-// src/commands/verify/hardcodedColors.ts
+// src/commands/verify/commentPolicy/findAddedComments.ts
 import { execSync as execSync6 } from "child_process";
+import fs10 from "fs";
 import { minimatch } from "minimatch";
+import { Project as Project2 } from "ts-morph";
+
+// src/commands/verify/commentPolicy/collectComments.ts
+function collectComments(sourceFile) {
+  const seen = /* @__PURE__ */ new Set();
+  const comments3 = [];
+  const collect3 = (node) => {
+    for (const range of [
+      ...node.getLeadingCommentRanges(),
+      ...node.getTrailingCommentRanges()
+    ]) {
+      const pos = range.getPos();
+      if (seen.has(pos)) continue;
+      seen.add(pos);
+      comments3.push({ pos, text: range.getText() });
+    }
+  };
+  collect3(sourceFile);
+  sourceFile.forEachDescendant(collect3);
+  return comments3;
+}
+
+// src/commands/verify/commentPolicy/isCommentExempt.ts
+var MACHINE_DIRECTIVES = [
+  "biome-ignore",
+  "@ts-expect-error",
+  "@ts-ignore",
+  "@ts-nocheck",
+  "eslint-disable",
+  "eslint-enable",
+  "prettier-ignore",
+  "istanbul ignore",
+  "v8 ignore",
+  "c8 ignore"
+];
+function isCommentExempt(text2, markers) {
+  const lower = text2.toLowerCase();
+  if (MACHINE_DIRECTIVES.some((d) => lower.includes(d))) return true;
+  return markers.some((m) => lower.includes(m.toLowerCase()));
+}
+
+// src/commands/verify/commentPolicy/parseDiffAddedLines.ts
+var FILE_HEADER = /^\+\+\+ (?:b\/)?(.+)$/;
+var HUNK_HEADER = /^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@/;
+function parseDiffAddedLines(diff2) {
+  const added = /* @__PURE__ */ new Map();
+  let currentFile = null;
+  let newLine = 0;
+  for (const line of diff2.split("\n")) {
+    const fileMatch = line.match(FILE_HEADER);
+    if (fileMatch) {
+      const file = fileMatch[1];
+      currentFile = file === "/dev/null" ? null : file;
+      continue;
+    }
+    const hunkMatch = line.match(HUNK_HEADER);
+    if (hunkMatch) {
+      newLine = Number(hunkMatch[1]);
+      continue;
+    }
+    if (currentFile === null) continue;
+    if (line.startsWith("+")) {
+      let set = added.get(currentFile);
+      if (!set) {
+        set = /* @__PURE__ */ new Set();
+        added.set(currentFile, set);
+      }
+      set.add(newLine);
+      newLine++;
+    } else if (line.startsWith("-")) {
+    } else {
+      newLine++;
+    }
+  }
+  return added;
+}
+
+// src/commands/verify/commentPolicy/findAddedComments.ts
+var SOURCE_EXTENSIONS = [".ts", ".tsx", ".cts", ".mts", ".js", ".jsx"];
+function toSingleLine(text2) {
+  return text2.replace(/\s+/g, " ").trim();
+}
+function shouldScan(file, ignoreGlobs) {
+  if (!SOURCE_EXTENSIONS.some((ext) => file.endsWith(ext))) return false;
+  if (ignoreGlobs.some((glob) => minimatch(file, glob))) return false;
+  return fs10.existsSync(file);
+}
+function findAddedComments(options2) {
+  const diff2 = execSync6("git diff HEAD", {
+    encoding: "utf-8",
+    maxBuffer: 64 * 1024 * 1024
+  });
+  const addedLines = parseDiffAddedLines(diff2);
+  const project = new Project2({
+    skipAddingFilesFromTsConfig: true,
+    compilerOptions: { allowJs: true }
+  });
+  const findings = [];
+  for (const [file, lines] of addedLines) {
+    if (!shouldScan(file, options2.ignoreGlobs)) continue;
+    const sourceFile = project.addSourceFileAtPath(file);
+    for (const { pos, text: text2 } of collectComments(sourceFile)) {
+      const { line } = sourceFile.getLineAndColumnAtPos(pos);
+      if (!lines.has(line)) continue;
+      if (isCommentExempt(text2, options2.markers)) continue;
+      findings.push({ file, line, text: toSingleLine(text2) });
+    }
+  }
+  findings.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line);
+  return findings;
+}
+
+// src/commands/verify/commentPolicy/index.ts
+var DEFAULT_MARKERS = ["HACK:", "why:"];
+function commentPolicy() {
+  const config = loadConfig().commentPolicy;
+  const markers = config?.markers ?? DEFAULT_MARKERS;
+  const ignoreGlobs = config?.ignore ?? [];
+  const findings = findAddedComments({ markers, ignoreGlobs });
+  if (findings.length === 0) {
+    console.log("No undocumented comments on changed lines.");
+    process.exit(0);
+  }
+  console.log("Comments added on changed lines:\n");
+  for (const { file, line, text: text2 } of findings) {
+    console.log(`${file}:${line} \u2192 ${text2}`);
+  }
+  console.log(`
+Total: ${findings.length} comment(s)`);
+  console.log(
+    "\nDon't comment standard logic or syntax \u2014 only unintuitive complexity or a hack."
+  );
+  console.log(
+    `Remove each comment, or justify it inline with a ${markers.map((m) => `'${m}'`).join(" or ")} marker.`
+  );
+  process.exit(1);
+}
+
+// src/commands/verify/hardcodedColors.ts
+import { execSync as execSync7 } from "child_process";
+import { minimatch as minimatch2 } from "minimatch";
 var pattern = "0x[0-9a-fA-F]{6}|#[0-9a-fA-F]{3,6}";
 function hardcodedColors() {
   const ignoreGlobs = loadConfig().hardcodedColors?.ignore ?? [];
   try {
-    const output = execSync6(`grep -rEnH '${pattern}' src/`, {
+    const output = execSync7(`grep -rEnH '${pattern}' src/`, {
       encoding: "utf-8"
     });
     const lines = output.trim().split("\n").filter((line) => {
       const match = line.match(/^(.+?):\d+:/);
       if (!match) return true;
       const file = match[1];
-      return !ignoreGlobs.some((glob) => minimatch(file, glob));
+      return !ignoreGlobs.some((glob) => minimatch2(file, glob));
     });
     if (lines.length === 0) {
       console.log("No hardcoded colors found.");
@@ -2001,10 +2147,10 @@ function list() {
 }
 
 // src/commands/verify/noVenv.ts
-import { execSync as execSync7 } from "child_process";
+import { execSync as execSync8 } from "child_process";
 function noVenv() {
   try {
-    const output = execSync7(
+    const output = execSync8(
       "find . -type d -name venv -not -path '*/node_modules/*'",
       {
         encoding: "utf-8"
@@ -2033,12 +2179,12 @@ Total: ${folders.length} venv folder(s)`);
 }
 
 // src/commands/verify/run/filterByChangedFiles.ts
-import { minimatch as minimatch2 } from "minimatch";
+import { minimatch as minimatch3 } from "minimatch";
 
 // src/commands/verify/run/getChangedFiles.ts
-import { execSync as execSync8 } from "child_process";
+import { execSync as execSync9 } from "child_process";
 function getChangedFiles() {
-  const output = execSync8("git diff --name-only HEAD", {
+  const output = execSync9("git diff --name-only HEAD", {
     encoding: "utf-8"
   }).trim();
   if (output === "") return [];
@@ -2054,7 +2200,7 @@ function filterByChangedFiles(entries) {
     const { filter } = entry;
     if (!filter) return true;
     if (changedFiles.length === 0) return false;
-    return changedFiles.some((file) => minimatch2(file, filter));
+    return changedFiles.some((file) => minimatch3(file, filter));
   });
 }
 
@@ -2209,25 +2355,25 @@ async function run(options2 = {}) {
 }
 
 // src/commands/new/registerNew/initGit.ts
-import { execSync as execSync9 } from "child_process";
+import { execSync as execSync10 } from "child_process";
 import { writeFileSync as writeFileSync7 } from "fs";
 function initGit() {
   console.log("Initializing git repository...");
-  execSync9("git init", { stdio: "inherit" });
+  execSync10("git init", { stdio: "inherit" });
   writeFileSync7(".gitignore", "dist\nnode_modules\n");
 }
 
 // src/commands/new/registerNew/newCli/initPackageJson.ts
-import { execSync as execSync10 } from "child_process";
+import { execSync as execSync11 } from "child_process";
 function initPackageJson(name) {
   console.log("Initializing package.json...");
-  execSync10("npm init -y", { stdio: "inherit" });
+  execSync11("npm init -y", { stdio: "inherit" });
   console.log("Configuring package.json...");
-  execSync10("npm pkg delete main", { stdio: "inherit" });
-  execSync10("npm pkg set type=module", { stdio: "inherit" });
-  execSync10(`npm pkg set bin.${name}=./dist/index.js`, { stdio: "inherit" });
-  execSync10("npm pkg set scripts.build=tsup", { stdio: "inherit" });
-  execSync10('npm pkg set scripts.start="node dist/index.js"', {
+  execSync11("npm pkg delete main", { stdio: "inherit" });
+  execSync11("npm pkg set type=module", { stdio: "inherit" });
+  execSync11(`npm pkg set bin.${name}=./dist/index.js`, { stdio: "inherit" });
+  execSync11("npm pkg set scripts.build=tsup", { stdio: "inherit" });
+  execSync11('npm pkg set scripts.start="node dist/index.js"', {
     stdio: "inherit"
   });
 }
@@ -2292,8 +2438,8 @@ async function newCli() {
   initGit();
   initPackageJson(name);
   console.log("Installing dependencies...");
-  execSync11("npm install commander", { stdio: "inherit" });
-  execSync11("npm install -D tsup typescript @types/node", {
+  execSync12("npm install commander", { stdio: "inherit" });
+  execSync12("npm install -D tsup typescript @types/node", {
     stdio: "inherit"
   });
   writeCliTemplate(name);
@@ -2302,11 +2448,11 @@ async function newCli() {
 }
 
 // src/commands/new/registerNew/newProject.ts
-import { execSync as execSync13 } from "child_process";
+import { execSync as execSync14 } from "child_process";
 import { existsSync as existsSync12, readFileSync as readFileSync8, writeFileSync as writeFileSync10 } from "fs";
 
 // src/commands/deploy/init/index.ts
-import { execSync as execSync12 } from "child_process";
+import { execSync as execSync13 } from "child_process";
 import chalk24 from "chalk";
 import enquirer3 from "enquirer";
 
@@ -2359,7 +2505,7 @@ Created ${WORKFLOW_PATH}`));
 // src/commands/deploy/init/index.ts
 async function ensureNetlifyCli() {
   try {
-    execSync12("netlify sites:create --disable-linking", { stdio: "inherit" });
+    execSync13("netlify sites:create --disable-linking", { stdio: "inherit" });
   } catch (error) {
     if (!(error instanceof Error) || !error.message.includes("command not found"))
       throw error;
@@ -2374,9 +2520,9 @@ async function ensureNetlifyCli() {
       process.exit(1);
     }
     console.log(chalk24.dim("\nInstalling netlify-cli...\n"));
-    execSync12("npm install -g netlify-cli", { stdio: "inherit" });
+    execSync13("npm install -g netlify-cli", { stdio: "inherit" });
     console.log();
-    execSync12("netlify sites:create --disable-linking", { stdio: "inherit" });
+    execSync13("netlify sites:create --disable-linking", { stdio: "inherit" });
   }
 }
 function printSetupInstructions() {
@@ -2419,7 +2565,7 @@ async function init5() {
 // src/commands/new/registerNew/newProject.ts
 async function newProject() {
   console.log("Initializing Vite with react-ts template...");
-  execSync13("npm create vite@latest . -- --template react-ts", {
+  execSync14("npm create vite@latest . -- --template react-ts", {
     stdio: "inherit"
   });
   initGit();
@@ -2493,7 +2639,7 @@ function detectPlatform() {
 
 // src/commands/notify/showNotification/showWindowsNotificationFromWsl.ts
 import { spawn as spawn2 } from "child_process";
-import fs10 from "fs";
+import fs11 from "fs";
 import { createRequire } from "module";
 import path17 from "path";
 var require2 = createRequire(import.meta.url);
@@ -2505,7 +2651,7 @@ function showWindowsNotificationFromWsl(options2) {
   const { title, message, sound } = options2;
   const snoreToastPath = getSnoreToastPath();
   try {
-    fs10.chmodSync(snoreToastPath, 493);
+    fs11.chmodSync(snoreToastPath, 493);
   } catch {
   }
   const args = ["-t", title, "-m", message];
@@ -2611,11 +2757,11 @@ function activityChart(data, range) {
 }
 
 // src/commands/activity/fetchCommitsPerDay.ts
-import { execSync as execSync14 } from "child_process";
+import { execSync as execSync15 } from "child_process";
 function fetchContributions(from, to) {
   const query = `{ viewer { contributionsCollection(from: "${from}T00:00:00Z", to: "${to}T23:59:59Z") { contributionCalendar { weeks { contributionDays { date contributionCount } } } } } }`;
   const jq = ".data.viewer.contributionsCollection.contributionCalendar.weeks[].contributionDays[]";
-  const raw = execSync14(`gh api graphql -f query='${query}' --jq '${jq}'`, {
+  const raw = execSync15(`gh api graphql -f query='${query}' --jq '${jq}'`, {
     encoding: "utf-8"
   }).trim();
   if (!raw) return [];
@@ -2681,13 +2827,13 @@ import chalk36 from "chalk";
 import enquirer5 from "enquirer";
 
 // src/shared/pullIfConfigured.ts
-import { execSync as execSync15 } from "child_process";
+import { execSync as execSync16 } from "child_process";
 import chalk25 from "chalk";
 function pullIfConfigured() {
   const config = loadConfig();
   if (!config.commit?.pull) return;
   try {
-    execSync15("git pull --ff-only", { stdio: "inherit" });
+    execSync16("git pull --ff-only", { stdio: "inherit" });
   } catch {
     console.error(chalk25.red("git pull --ff-only failed; aborting."));
     process.exit(1);
@@ -2898,11 +3044,11 @@ function backupLocalBacklogFiles(dir) {
 }
 
 // src/commands/backlog/gitPullBacklog.ts
-import { execSync as execSync16 } from "child_process";
+import { execSync as execSync17 } from "child_process";
 import chalk29 from "chalk";
 function gitPullBacklog(dir) {
   try {
-    execSync16("git pull --ff-only", {
+    execSync17("git pull --ff-only", {
       cwd: dir,
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -3255,7 +3401,7 @@ function findBacklogUp(startDir) {
 }
 
 // src/commands/backlog/getCurrentOrigin.ts
-import { execSync as execSync17 } from "child_process";
+import { execSync as execSync18 } from "child_process";
 function stripLeadingSlashes(path53) {
   return path53.replace(/^\/+/, "");
 }
@@ -3277,7 +3423,7 @@ function normalizeOrigin(raw) {
 }
 function tryGit(cwd, args) {
   try {
-    const out = execSync17(`git ${args}`, {
+    const out = execSync18(`git ${args}`, {
       cwd,
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
@@ -4074,7 +4220,7 @@ function printComments(item) {
 import { WebSocketServer } from "ws";
 
 // src/shared/getInstallDir.ts
-import { execSync as execSync18 } from "child_process";
+import { execSync as execSync19 } from "child_process";
 import { dirname as dirname15, resolve as resolve6 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var __filename2 = fileURLToPath3(import.meta.url);
@@ -4084,7 +4230,7 @@ function getInstallDir() {
 }
 function isGitRepo(dir) {
   try {
-    const result = execSync18("git rev-parse --show-toplevel", {
+    const result = execSync19("git rev-parse --show-toplevel", {
       cwd: dir,
       stdio: "pipe"
     }).toString().trim();
@@ -4598,7 +4744,7 @@ function getHtml() {
 }
 
 // src/commands/prs/getPreferredRemoteRepo.ts
-import { execSync as execSync19 } from "child_process";
+import { execSync as execSync20 } from "child_process";
 var GITHUB_URL_PATTERN = /(?:git@github\.com:|https:\/\/github\.com\/)([^/]+)\/([^/]+?)(?:\.git)?\/?$/;
 function parseGitHubUrl(url) {
   const match = url.match(GITHUB_URL_PATTERN);
@@ -4607,7 +4753,7 @@ function parseGitHubUrl(url) {
 }
 function tryGetRemoteUrl(remote, cwd) {
   try {
-    return execSync19(`git remote get-url ${remote}`, {
+    return execSync20(`git remote get-url ${remote}`, {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"],
       cwd
@@ -4618,7 +4764,7 @@ function tryGetRemoteUrl(remote, cwd) {
 }
 function getCurrentBranchRemote(cwd) {
   try {
-    const ref = execSync19(
+    const ref = execSync20(
       "git rev-parse --abbrev-ref --symbolic-full-name @{u}",
       { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"], cwd }
     ).trim();
@@ -4630,7 +4776,7 @@ function getCurrentBranchRemote(cwd) {
 }
 function listRemotes(cwd) {
   try {
-    return execSync19("git remote", {
+    return execSync20("git remote", {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"],
       cwd
@@ -6950,7 +7096,7 @@ import { homedir as homedir8 } from "os";
 import { join as join21 } from "path";
 
 // src/shared/checkCliAvailable.ts
-import { execSync as execSync20 } from "child_process";
+import { execSync as execSync21 } from "child_process";
 function checkCliAvailable(cli) {
   const binary = cli.split(/\s+/)[0];
   const opts = {
@@ -6958,11 +7104,11 @@ function checkCliAvailable(cli) {
     stdio: ["ignore", "pipe", "pipe"]
   };
   try {
-    execSync20(`command -v ${binary}`, opts);
+    execSync21(`command -v ${binary}`, opts);
     return true;
   } catch {
     try {
-      execSync20(`where ${binary}`, opts);
+      execSync21(`where ${binary}`, opts);
       return true;
     } catch {
       return false;
@@ -7379,27 +7525,27 @@ import chalk85 from "chalk";
 import chalk80 from "chalk";
 
 // src/commands/complexity/shared/index.ts
-import fs12 from "fs";
+import fs13 from "fs";
 import path19 from "path";
 import chalk79 from "chalk";
 import ts5 from "typescript";
 
 // src/commands/complexity/findSourceFiles.ts
-import fs11 from "fs";
+import fs12 from "fs";
 import path18 from "path";
-import { minimatch as minimatch3 } from "minimatch";
+import { minimatch as minimatch4 } from "minimatch";
 function applyIgnoreGlobs(files) {
   const { complexity } = loadConfig();
   return files.filter(
-    (f) => !complexity.ignore.some((glob) => minimatch3(f, glob))
+    (f) => !complexity.ignore.some((glob) => minimatch4(f, glob))
   );
 }
 function walk(dir, results) {
-  if (!fs11.existsSync(dir)) {
+  if (!fs12.existsSync(dir)) {
     return;
   }
   const extensions = [".ts", ".tsx"];
-  const entries = fs11.readdirSync(dir, { withFileTypes: true });
+  const entries = fs12.readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
     const fullPath = path18.join(dir, entry.name);
     if (entry.isDirectory()) {
@@ -7415,17 +7561,17 @@ function findSourceFiles2(pattern2, baseDir = ".") {
   const results = [];
   if (pattern2.includes("*")) {
     walk(baseDir, results);
-    return applyIgnoreGlobs(results.filter((f) => minimatch3(f, pattern2)));
+    return applyIgnoreGlobs(results.filter((f) => minimatch4(f, pattern2)));
   }
-  if (fs11.existsSync(pattern2) && fs11.statSync(pattern2).isFile()) {
+  if (fs12.existsSync(pattern2) && fs12.statSync(pattern2).isFile()) {
     return [pattern2];
   }
-  if (fs11.existsSync(pattern2) && fs11.statSync(pattern2).isDirectory()) {
+  if (fs12.existsSync(pattern2) && fs12.statSync(pattern2).isDirectory()) {
     walk(pattern2, results);
     return applyIgnoreGlobs(results);
   }
   walk(baseDir, results);
-  return applyIgnoreGlobs(results.filter((f) => minimatch3(f, pattern2)));
+  return applyIgnoreGlobs(results.filter((f) => minimatch4(f, pattern2)));
 }
 
 // src/commands/complexity/shared/getNodeName.ts
@@ -7615,7 +7761,7 @@ function countSloc(content) {
 
 // src/commands/complexity/shared/index.ts
 function createSourceFromFile(filePath) {
-  const content = fs12.readFileSync(filePath, "utf-8");
+  const content = fs13.readFileSync(filePath, "utf-8");
   return ts5.createSourceFile(
     path19.basename(filePath),
     content,
@@ -7709,7 +7855,7 @@ Analyzed ${results.length} functions across ${files.length} files`
 }
 
 // src/commands/complexity/maintainability/index.ts
-import fs13 from "fs";
+import fs14 from "fs";
 
 // src/commands/complexity/maintainability/displayMaintainabilityResults.ts
 import chalk82 from "chalk";
@@ -7758,7 +7904,7 @@ function calculateMaintainabilityIndex(halsteadVolume, cyclomaticComplexity, slo
 function collectFileMetrics(files) {
   const fileMetrics = /* @__PURE__ */ new Map();
   for (const file of files) {
-    const content = fs13.readFileSync(file, "utf-8");
+    const content = fs14.readFileSync(file, "utf-8");
     fileMetrics.set(file, { sloc: countSloc(content), functions: [] });
   }
   forEachFunction(files, (file, _name, node) => {
@@ -7797,14 +7943,14 @@ async function maintainability(pattern2 = "**/*.ts", options2 = {}) {
 }
 
 // src/commands/complexity/sloc.ts
-import fs14 from "fs";
+import fs15 from "fs";
 import chalk84 from "chalk";
 async function sloc(pattern2 = "**/*.ts", options2 = {}) {
   withSourceFiles(pattern2, (files) => {
     const results = [];
     let hasViolation = false;
     for (const file of files) {
-      const content = fs14.readFileSync(file, "utf-8");
+      const content = fs15.readFileSync(file, "utf-8");
       const lines = countSloc(content);
       results.push({ file, lines });
       if (options2.threshold !== void 0 && lines > options2.threshold) {
@@ -8082,7 +8228,7 @@ function loadBlogSkipDays(repoName) {
 }
 
 // src/commands/devlog/shared.ts
-import { execSync as execSync21 } from "child_process";
+import { execSync as execSync22 } from "child_process";
 import chalk89 from "chalk";
 
 // src/shared/getRepoName.ts
@@ -8174,7 +8320,7 @@ function loadAllDevlogLatestDates() {
 // src/commands/devlog/shared.ts
 function getCommitFiles(hash) {
   try {
-    const output = execSync21(`git show --name-only --format="" ${hash}`, {
+    const output = execSync22(`git show --name-only --format="" ${hash}`, {
       encoding: "utf-8"
     });
     return output.trim().split("\n").filter(Boolean);
@@ -8270,11 +8416,11 @@ function list3(options2) {
 }
 
 // src/commands/devlog/getLastVersionInfo.ts
-import { execFileSync as execFileSync2, execSync as execSync22 } from "child_process";
+import { execFileSync as execFileSync2, execSync as execSync23 } from "child_process";
 import semver from "semver";
 function getVersionAtCommit(hash) {
   try {
-    const content = execSync22(`git show ${hash}:package.json`, {
+    const content = execSync23(`git show ${hash}:package.json`, {
       encoding: "utf-8"
     });
     const pkg = JSON.parse(content);
@@ -8447,7 +8593,7 @@ function next2(options2) {
 }
 
 // src/commands/devlog/repos/index.ts
-import { execSync as execSync23 } from "child_process";
+import { execSync as execSync24 } from "child_process";
 
 // src/commands/devlog/repos/printReposTable.ts
 import chalk93 from "chalk";
@@ -8482,7 +8628,7 @@ function getStatus(lastPush, lastDevlog) {
   return lastDevlog < lastPush ? "outdated" : "ok";
 }
 function fetchRepos(days, all) {
-  const json = execSync23(
+  const json = execSync24(
     "gh repo list staff0rd --json name,pushedAt,isArchived --limit 200",
     { encoding: "utf-8" }
   );
@@ -8842,7 +8988,7 @@ async function deps(csprojPath, options2) {
 }
 
 // src/commands/dotnet/getChangedCsFiles.ts
-import { execSync as execSync24 } from "child_process";
+import { execSync as execSync25 } from "child_process";
 var SCOPE_ALL = "all";
 var SCOPE_BASE = "base:";
 var SCOPE_COMMIT = "commit:";
@@ -8866,7 +9012,7 @@ function getChangedCsFiles(scope) {
   } else {
     cmd = "git diff --name-only HEAD";
   }
-  const output = execSync24(cmd, { encoding: "utf-8" }).trim();
+  const output = execSync25(cmd, { encoding: "utf-8" }).trim();
   if (output === "") return [];
   return output.split("\n").filter((f) => f.toLowerCase().endsWith(".cs"));
 }
@@ -9064,14 +9210,14 @@ function parseInspectReport(json) {
 }
 
 // src/commands/dotnet/runInspectCode.ts
-import { execSync as execSync25 } from "child_process";
+import { execSync as execSync26 } from "child_process";
 import { existsSync as existsSync29, readFileSync as readFileSync24, unlinkSync as unlinkSync6 } from "fs";
 import { tmpdir as tmpdir3 } from "os";
 import path25 from "path";
 import chalk103 from "chalk";
 function assertJbInstalled() {
   try {
-    execSync25("jb inspectcode --version", { stdio: "pipe" });
+    execSync26("jb inspectcode --version", { stdio: "pipe" });
   } catch {
     console.error(chalk103.red("jb is not installed. Install with:"));
     console.error(
@@ -9085,7 +9231,7 @@ function runInspectCode(slnPath, include, swea) {
   const includeFlag = include ? ` --include="${include}"` : "";
   const sweaFlag = swea ? " --swea" : "";
   try {
-    execSync25(
+    execSync26(
       `jb inspectcode "${slnPath}" -o="${reportPath}"${includeFlag}${sweaFlag} --verbosity=OFF`,
       { stdio: "pipe" }
     );
@@ -9106,7 +9252,7 @@ function runInspectCode(slnPath, include, swea) {
 }
 
 // src/commands/dotnet/runRoslynInspect.ts
-import { execSync as execSync26 } from "child_process";
+import { execSync as execSync27 } from "child_process";
 import chalk104 from "chalk";
 function resolveMsbuildPath() {
   const { run: run4 } = loadConfig();
@@ -9117,7 +9263,7 @@ function resolveMsbuildPath() {
 function assertMsbuildInstalled() {
   const msbuild = resolveMsbuildPath();
   try {
-    execSync26(`"${msbuild}" -version`, { stdio: "pipe" });
+    execSync27(`"${msbuild}" -version`, { stdio: "pipe" });
   } catch {
     console.error(chalk104.red(`msbuild not found at: ${msbuild}`));
     console.error(
@@ -9143,7 +9289,7 @@ function runRoslynInspect(slnPath) {
   const msbuild = resolveMsbuildPath();
   let output;
   try {
-    output = execSync26(
+    output = execSync27(
       `"${msbuild}" "${slnPath}" -t:Build -v:minimal -maxcpucount -p:EnforceCodeStyleInBuild=true -p:RunAnalyzersDuringBuild=true 2>&1`,
       { encoding: "utf-8", stdio: "pipe", maxBuffer: 50 * 1024 * 1024 }
     );
@@ -9502,7 +9648,7 @@ function resolveLoadOptions(options2) {
 import { execFileSync as execFileSync4 } from "child_process";
 
 // src/commands/sessions/summarise/iterateUserEntries.ts
-import * as fs15 from "fs";
+import * as fs16 from "fs";
 
 // src/commands/sessions/summarise/parseUserLine.ts
 function parseUserLine(line) {
@@ -9533,7 +9679,7 @@ function parseUserLine(line) {
 function* iterateUserEntries(filePath) {
   let content;
   try {
-    content = fs15.readFileSync(filePath, "utf8");
+    content = fs16.readFileSync(filePath, "utf8");
   } catch {
     return;
   }
@@ -9705,12 +9851,12 @@ function adfToText(doc) {
 }
 
 // src/commands/jira/fetchIssue.ts
-import { execSync as execSync27 } from "child_process";
+import { execSync as execSync28 } from "child_process";
 import chalk108 from "chalk";
 function fetchIssue(issueKey, fields) {
   let result;
   try {
-    result = execSync27(
+    result = execSync28(
       `acli jira workitem view ${issueKey} -f ${fields} --json`,
       { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }
     );
@@ -9756,7 +9902,7 @@ function acceptanceCriteria(issueKey) {
 }
 
 // src/commands/jira/jiraAuth.ts
-import { execSync as execSync28 } from "child_process";
+import { execSync as execSync29 } from "child_process";
 
 // src/shared/loadJson.ts
 import { existsSync as existsSync32, mkdirSync as mkdirSync10, readFileSync as readFileSync27, writeFileSync as writeFileSync20 } from "fs";
@@ -9820,7 +9966,7 @@ async function jiraAuth() {
       console.error("All fields are required.");
       process.exit(1);
     }
-    execSync28(`acli jira auth login --site ${site} --email "${email}" --token`, {
+    execSync29(`acli jira auth login --site ${site} --email "${email}" --token`, {
       encoding: "utf-8",
       input: token,
       stdio: ["pipe", "inherit", "inherit"]
@@ -10302,7 +10448,7 @@ function registerPrompts(program2) {
 }
 
 // src/commands/prs/shared.ts
-import { execSync as execSync29 } from "child_process";
+import { execSync as execSync30 } from "child_process";
 function isGhNotInstalled(error) {
   if (error instanceof Error) {
     const msg = error.message.toLowerCase();
@@ -10320,12 +10466,12 @@ function getRepoInfo() {
   const preferred = getPreferredRemoteRepo();
   if (preferred) return preferred;
   const repoInfo = JSON.parse(
-    execSync29("gh repo view --json owner,name", { encoding: "utf-8" })
+    execSync30("gh repo view --json owner,name", { encoding: "utf-8" })
   );
   return { org: repoInfo.owner.login, repo: repoInfo.name };
 }
 function getCurrentBranch() {
-  return execSync29("git rev-parse --abbrev-ref HEAD", {
+  return execSync30("git rev-parse --abbrev-ref HEAD", {
     encoding: "utf-8"
   }).trim();
 }
@@ -10333,7 +10479,7 @@ function viewCurrentPr(fields) {
   const { org, repo } = getRepoInfo();
   const branch = getCurrentBranch();
   return JSON.parse(
-    execSync29(`gh pr view ${branch} --json ${fields} -R ${org}/${repo}`, {
+    execSync30(`gh pr view ${branch} --json ${fields} -R ${org}/${repo}`, {
       encoding: "utf-8"
     })
   );
@@ -10415,7 +10561,7 @@ function comment2(path53, line, body, startLine) {
 }
 
 // src/commands/prs/create.ts
-import { execSync as execSync30 } from "child_process";
+import { execSync as execSync31 } from "child_process";
 
 // src/commands/prs/buildCreateArgs.ts
 function buildCreateArgs(title, body, options2) {
@@ -10470,17 +10616,17 @@ function create(options2) {
   validatePrContent(options2.title, options2.body);
   const args = buildCreateArgs(options2.title, options2.body, options2);
   try {
-    execSync30(args.join(" "), { stdio: "inherit" });
+    execSync31(args.join(" "), { stdio: "inherit" });
   } catch (_error) {
     process.exit(1);
   }
 }
 
 // src/commands/prs/fixed.ts
-import { execSync as execSync32 } from "child_process";
+import { execSync as execSync33 } from "child_process";
 
 // src/commands/prs/resolveCommentWithReply.ts
-import { execSync as execSync31 } from "child_process";
+import { execSync as execSync32 } from "child_process";
 import { unlinkSync as unlinkSync9, writeFileSync as writeFileSync22 } from "fs";
 import { tmpdir as tmpdir5 } from "os";
 import { join as join33 } from "path";
@@ -10510,7 +10656,7 @@ function deleteCommentsCache(prNumber) {
 
 // src/commands/prs/resolveCommentWithReply.ts
 function replyToComment(org, repo, prNumber, commentId, message) {
-  execSync31(
+  execSync32(
     `gh api repos/${org}/${repo}/pulls/${prNumber}/comments -f body="${message.replace(/"/g, '\\"')}" -F in_reply_to=${commentId}`,
     { stdio: ["inherit", "pipe", "inherit"] }
   );
@@ -10520,7 +10666,7 @@ function resolveThread(threadId) {
   const queryFile = join33(tmpdir5(), `gh-mutation-${Date.now()}.graphql`);
   writeFileSync22(queryFile, mutation);
   try {
-    execSync31(
+    execSync32(
       `gh api graphql -F query=@${queryFile} -f threadId="${threadId}"`,
       { stdio: ["inherit", "pipe", "inherit"] }
     );
@@ -10572,7 +10718,7 @@ function resolveCommentWithReply(commentId, message) {
 // src/commands/prs/fixed.ts
 function verifySha(sha) {
   try {
-    return execSync32(`git rev-parse --verify ${sha}`, {
+    return execSync33(`git rev-parse --verify ${sha}`, {
       encoding: "utf-8"
     }).trim();
   } catch {
@@ -10586,7 +10732,7 @@ function fixed(commentId, sha) {
     const { org, repo } = getRepoInfo();
     const repoUrl = `https://github.com/${org}/${repo}`;
     const message = `Fixed in [${fullSha}](${repoUrl}/commit/${fullSha})`;
-    execSync32("git push", { stdio: "inherit" });
+    execSync33("git push", { stdio: "inherit" });
     resolveCommentWithReply(commentId, message);
   } catch (error) {
     if (isGhNotInstalled(error)) {
@@ -10604,7 +10750,7 @@ import { join as join35 } from "path";
 import { stringify } from "yaml";
 
 // src/commands/prs/fetchThreadIds.ts
-import { execSync as execSync33 } from "child_process";
+import { execSync as execSync34 } from "child_process";
 import { unlinkSync as unlinkSync10, writeFileSync as writeFileSync23 } from "fs";
 import { tmpdir as tmpdir6 } from "os";
 import { join as join34 } from "path";
@@ -10613,7 +10759,7 @@ function fetchThreadIds(org, repo, prNumber) {
   const queryFile = join34(tmpdir6(), `gh-query-${Date.now()}.graphql`);
   writeFileSync23(queryFile, THREAD_QUERY);
   try {
-    const result = execSync33(
+    const result = execSync34(
       `gh api graphql -F query=@${queryFile} -F owner="${org}" -F repo="${repo}" -F prNumber=${prNumber}`,
       { encoding: "utf-8" }
     );
@@ -10635,9 +10781,9 @@ function fetchThreadIds(org, repo, prNumber) {
 }
 
 // src/commands/prs/listComments/fetchReviewComments.ts
-import { execSync as execSync34 } from "child_process";
+import { execSync as execSync35 } from "child_process";
 function fetchJson(endpoint) {
-  const result = execSync34(`gh api --paginate ${endpoint}`, {
+  const result = execSync35(`gh api --paginate ${endpoint}`, {
     encoding: "utf-8"
   });
   if (!result.trim()) return [];
@@ -10776,7 +10922,7 @@ async function listComments() {
 }
 
 // src/commands/prs/prs/index.ts
-import { execSync as execSync35 } from "child_process";
+import { execSync as execSync36 } from "child_process";
 
 // src/commands/prs/prs/displayPaginated/index.ts
 import enquirer9 from "enquirer";
@@ -10883,7 +11029,7 @@ async function prs(options2) {
   const state = options2.open ? "open" : options2.closed ? "closed" : "all";
   try {
     const { org, repo } = getRepoInfo();
-    const result = execSync35(
+    const result = execSync36(
       `gh pr list --state ${state} --json number,title,url,author,createdAt,mergedAt,closedAt,state,changedFiles --limit 100 -R ${org}/${repo}`,
       { encoding: "utf-8" }
     );
@@ -10906,7 +11052,7 @@ async function prs(options2) {
 }
 
 // src/commands/prs/wontfix.ts
-import { execSync as execSync36 } from "child_process";
+import { execSync as execSync37 } from "child_process";
 function validateReason(reason) {
   const lowerReason = reason.toLowerCase();
   if (lowerReason.includes("claude") || lowerReason.includes("opus")) {
@@ -10923,7 +11069,7 @@ function validateShaReferences(reason) {
   const invalidShas = [];
   for (const sha of shas) {
     try {
-      execSync36(`git cat-file -t ${sha}`, { stdio: "pipe" });
+      execSync37(`git cat-file -t ${sha}`, { stdio: "pipe" });
     } catch {
       invalidShas.push(sha);
     }
@@ -11058,10 +11204,10 @@ import chalk122 from "chalk";
 import Enquirer2 from "enquirer";
 
 // src/commands/ravendb/searchItems.ts
-import { execSync as execSync37 } from "child_process";
+import { execSync as execSync38 } from "child_process";
 import chalk121 from "chalk";
 function opExec(args) {
-  return execSync37(`op ${args}`, {
+  return execSync38(`op ${args}`, {
     encoding: "utf-8",
     stdio: ["pipe", "pipe", "pipe"]
   }).trim();
@@ -11213,7 +11359,7 @@ ${errorText}`
 }
 
 // src/commands/ravendb/resolveOpSecret.ts
-import { execSync as execSync38 } from "child_process";
+import { execSync as execSync39 } from "child_process";
 import chalk126 from "chalk";
 function resolveOpSecret(reference) {
   if (!reference.startsWith("op://")) {
@@ -11221,7 +11367,7 @@ function resolveOpSecret(reference) {
     process.exit(1);
   }
   try {
-    return execSync38(`op read "${reference}"`, {
+    return execSync39(`op read "${reference}"`, {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     }).trim();
@@ -11470,18 +11616,18 @@ Refactor check failed:
 }
 
 // src/commands/refactor/check/getViolations/index.ts
-import { execSync as execSync39 } from "child_process";
-import fs17 from "fs";
-import { minimatch as minimatch4 } from "minimatch";
+import { execSync as execSync40 } from "child_process";
+import fs18 from "fs";
+import { minimatch as minimatch5 } from "minimatch";
 
 // src/commands/refactor/check/getViolations/getIgnoredFiles.ts
-import fs16 from "fs";
+import fs17 from "fs";
 var REFACTOR_YML_PATH = "refactor.yml";
 function parseRefactorYml() {
-  if (!fs16.existsSync(REFACTOR_YML_PATH)) {
+  if (!fs17.existsSync(REFACTOR_YML_PATH)) {
     return [];
   }
-  const content = fs16.readFileSync(REFACTOR_YML_PATH, "utf-8");
+  const content = fs17.readFileSync(REFACTOR_YML_PATH, "utf-8");
   const entries = [];
   const lines = content.split("\n");
   let currentEntry = {};
@@ -11511,7 +11657,7 @@ function getIgnoredFiles() {
 
 // src/commands/refactor/check/getViolations/index.ts
 function countLines(filePath) {
-  const content = fs17.readFileSync(filePath, "utf-8");
+  const content = fs18.readFileSync(filePath, "utf-8");
   return content.split("\n").length;
 }
 function getGitFiles(options2) {
@@ -11520,7 +11666,7 @@ function getGitFiles(options2) {
   }
   const files = /* @__PURE__ */ new Set();
   if (options2.staged || options2.modified) {
-    const staged = execSync39("git diff --cached --name-only", {
+    const staged = execSync40("git diff --cached --name-only", {
       encoding: "utf-8"
     });
     for (const file of staged.trim().split("\n").filter(Boolean)) {
@@ -11528,7 +11674,7 @@ function getGitFiles(options2) {
     }
   }
   if (options2.unstaged || options2.modified) {
-    const unstaged = execSync39("git diff --name-only", { encoding: "utf-8" });
+    const unstaged = execSync40("git diff --name-only", { encoding: "utf-8" });
     for (const file of unstaged.trim().split("\n").filter(Boolean)) {
       files.add(file);
     }
@@ -11540,7 +11686,7 @@ function getViolations(pattern2, options2 = {}, maxLines = DEFAULT_MAX_LINES) {
   const ignoredFiles = getIgnoredFiles();
   const gitFiles = getGitFiles(options2);
   if (pattern2) {
-    sourceFiles = sourceFiles.filter((f) => minimatch4(f, pattern2));
+    sourceFiles = sourceFiles.filter((f) => minimatch5(f, pattern2));
   }
   if (gitFiles) {
     sourceFiles = sourceFiles.filter((f) => gitFiles.has(f));
@@ -12242,15 +12388,15 @@ function displayPlan(functionName, relDest, plan2, cwd) {
 // src/commands/refactor/extract/loadProjectFile.ts
 import path32 from "path";
 import chalk134 from "chalk";
-import { Project as Project3 } from "ts-morph";
+import { Project as Project4 } from "ts-morph";
 
 // src/commands/refactor/extract/findTsConfig.ts
-import fs18 from "fs";
+import fs19 from "fs";
 import path31 from "path";
-import { Project as Project2 } from "ts-morph";
+import { Project as Project3 } from "ts-morph";
 function findTsConfig(sourcePath) {
   const rootConfig = path31.resolve("tsconfig.json");
-  if (!fs18.existsSync(rootConfig)) return rootConfig;
+  if (!fs19.existsSync(rootConfig)) return rootConfig;
   const tried = /* @__PURE__ */ new Set();
   const candidates = [rootConfig, ...readReferences(rootConfig)];
   for (const candidate of candidates) {
@@ -12258,7 +12404,7 @@ function findTsConfig(sourcePath) {
     tried.add(candidate);
     if (projectIncludes(candidate, sourcePath)) return candidate;
   }
-  const siblings = fs18.readdirSync(path31.dirname(rootConfig)).filter((f) => /^tsconfig.*\.json$/.test(f)).map((f) => path31.resolve(path31.dirname(rootConfig), f));
+  const siblings = fs19.readdirSync(path31.dirname(rootConfig)).filter((f) => /^tsconfig.*\.json$/.test(f)).map((f) => path31.resolve(path31.dirname(rootConfig), f));
   for (const sibling of siblings) {
     if (tried.has(sibling)) continue;
     tried.add(sibling);
@@ -12267,8 +12413,8 @@ function findTsConfig(sourcePath) {
   return rootConfig;
 }
 function readReferences(configPath) {
-  if (!fs18.existsSync(configPath)) return [];
-  const raw = fs18.readFileSync(configPath, "utf-8");
+  if (!fs19.existsSync(configPath)) return [];
+  const raw = fs19.readFileSync(configPath, "utf-8");
   const stripped = raw.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "");
   let parsed;
   try {
@@ -12280,12 +12426,12 @@ function readReferences(configPath) {
   const cwd = path31.dirname(configPath);
   return parsed.references.map((ref) => {
     const refPath = path31.resolve(cwd, ref.path);
-    return fs18.statSync(refPath, { throwIfNoEntry: false })?.isDirectory() ? path31.join(refPath, "tsconfig.json") : refPath;
-  }).filter((p) => fs18.existsSync(p));
+    return fs19.statSync(refPath, { throwIfNoEntry: false })?.isDirectory() ? path31.join(refPath, "tsconfig.json") : refPath;
+  }).filter((p) => fs19.existsSync(p));
 }
 function projectIncludes(configPath, sourcePath) {
   try {
-    const project = new Project2({ tsConfigFilePath: configPath });
+    const project = new Project3({ tsConfigFilePath: configPath });
     return !!project.getSourceFile(sourcePath);
   } catch {
     return false;
@@ -12296,7 +12442,7 @@ function projectIncludes(configPath, sourcePath) {
 function loadProjectFile(file) {
   const sourcePath = path32.resolve(file);
   const tsConfigPath = findTsConfig(sourcePath);
-  const project = new Project3({
+  const project = new Project4({
     tsConfigFilePath: tsConfigPath
   });
   const sourceFile = project.getSourceFile(sourcePath);
@@ -12331,25 +12477,25 @@ async function extract(file, functionName, destination, options2 = {}) {
 }
 
 // src/commands/refactor/ignore.ts
-import fs19 from "fs";
+import fs20 from "fs";
 import chalk136 from "chalk";
 var REFACTOR_YML_PATH2 = "refactor.yml";
 function ignore(file) {
-  if (!fs19.existsSync(file)) {
+  if (!fs20.existsSync(file)) {
     console.error(chalk136.red(`Error: File does not exist: ${file}`));
     process.exit(1);
   }
-  const content = fs19.readFileSync(file, "utf-8");
+  const content = fs20.readFileSync(file, "utf-8");
   const lineCount = content.split("\n").length;
   const maxLines = lineCount + 10;
   const entry = `- file: ${file}
   maxLines: ${maxLines}
 `;
-  if (fs19.existsSync(REFACTOR_YML_PATH2)) {
-    const existing = fs19.readFileSync(REFACTOR_YML_PATH2, "utf-8");
-    fs19.writeFileSync(REFACTOR_YML_PATH2, existing + entry);
+  if (fs20.existsSync(REFACTOR_YML_PATH2)) {
+    const existing = fs20.readFileSync(REFACTOR_YML_PATH2, "utf-8");
+    fs20.writeFileSync(REFACTOR_YML_PATH2, existing + entry);
   } else {
-    fs19.writeFileSync(REFACTOR_YML_PATH2, entry);
+    fs20.writeFileSync(REFACTOR_YML_PATH2, entry);
   }
   console.log(
     chalk136.green(
@@ -12597,7 +12743,7 @@ function clusterFiles(graph) {
 import path39 from "path";
 
 // src/commands/refactor/restructure/computeRewrites/applyRewrites.ts
-import fs20 from "fs";
+import fs21 from "fs";
 function getOrCreateList(map, key) {
   const list4 = map.get(key) ?? [];
   if (!map.has(key)) map.set(key, list4);
@@ -12616,7 +12762,7 @@ function rewriteSpecifier(content, oldSpecifier, newSpecifier) {
   return content.replace(pattern2, `$1${newSpecifier}$2`);
 }
 function applyFileRewrites(file, fileRewrites) {
-  let content = fs20.readFileSync(file, "utf-8");
+  let content = fs21.readFileSync(file, "utf-8");
   for (const { oldSpecifier, newSpecifier } of fileRewrites) {
     content = rewriteSpecifier(content, oldSpecifier, newSpecifier);
   }
@@ -12744,27 +12890,27 @@ Summary: ${plan2.moves.length} file(s) moved, ${plan2.rewrites.length} imports r
 }
 
 // src/commands/refactor/restructure/executePlan.ts
-import fs21 from "fs";
+import fs22 from "fs";
 import path41 from "path";
 import chalk140 from "chalk";
 function executePlan(plan2) {
   const updatedContents = applyRewrites(plan2.rewrites);
   for (const [file, content] of updatedContents) {
-    fs21.writeFileSync(file, content, "utf-8");
+    fs22.writeFileSync(file, content, "utf-8");
     console.log(
       chalk140.cyan(`  Rewrote imports in ${path41.relative(process.cwd(), file)}`)
     );
   }
   for (const dir of plan2.newDirectories) {
-    fs21.mkdirSync(dir, { recursive: true });
+    fs22.mkdirSync(dir, { recursive: true });
     console.log(chalk140.green(`  Created ${path41.relative(process.cwd(), dir)}/`));
   }
   for (const move of plan2.moves) {
     const targetDir = path41.dirname(move.to);
-    if (!fs21.existsSync(targetDir)) {
-      fs21.mkdirSync(targetDir, { recursive: true });
+    if (!fs22.existsSync(targetDir)) {
+      fs22.mkdirSync(targetDir, { recursive: true });
     }
-    fs21.renameSync(move.from, move.to);
+    fs22.renameSync(move.from, move.to);
     console.log(
       chalk140.white(
         `  Moved ${path41.relative(process.cwd(), move.from)} \u2192 ${path41.relative(process.cwd(), move.to)}`
@@ -12776,10 +12922,10 @@ function executePlan(plan2) {
 function removeEmptyDirectories(dirs) {
   const unique = [...new Set(dirs)];
   for (const dir of unique) {
-    if (!fs21.existsSync(dir)) continue;
-    const entries = fs21.readdirSync(dir);
+    if (!fs22.existsSync(dir)) continue;
+    const entries = fs22.readdirSync(dir);
     if (entries.length === 0) {
-      fs21.rmdirSync(dir);
+      fs22.rmdirSync(dir);
       console.log(
         chalk140.dim(
           `  Removed empty directory ${path41.relative(process.cwd(), dir)}`
@@ -12793,18 +12939,18 @@ function removeEmptyDirectories(dirs) {
 import path43 from "path";
 
 // src/commands/refactor/restructure/planFileMoves/shared.ts
-import fs22 from "fs";
+import fs23 from "fs";
 function emptyResult() {
   return { moves: [], directories: [], warnings: [] };
 }
 function checkDirConflict(result, label2, dir) {
-  if (!fs22.existsSync(dir)) return false;
+  if (!fs23.existsSync(dir)) return false;
   result.warnings.push(`Skipping ${label2}: directory ${dir} already exists`);
   return true;
 }
 
 // src/commands/refactor/restructure/planFileMoves/planDirectoryMoves.ts
-import fs23 from "fs";
+import fs24 from "fs";
 import path42 from "path";
 function collectEntry(results, dir, entry) {
   const full = path42.join(dir, entry.name);
@@ -12812,9 +12958,9 @@ function collectEntry(results, dir, entry) {
   results.push(...items2);
 }
 function listFilesRecursive(dir) {
-  if (!fs23.existsSync(dir)) return [];
+  if (!fs24.existsSync(dir)) return [];
   const results = [];
-  for (const entry of fs23.readdirSync(dir, { withFileTypes: true })) {
+  for (const entry of fs24.readdirSync(dir, { withFileTypes: true })) {
     collectEntry(results, dir, entry);
   }
   return results;
@@ -13093,9 +13239,9 @@ function ensureReviewsIgnored(repoRoot) {
 }
 
 // src/commands/review/fetchExistingComments.ts
-import { execSync as execSync40 } from "child_process";
+import { execSync as execSync41 } from "child_process";
 function fetchRawComments(org, repo, prNumber) {
-  const out = execSync40(
+  const out = execSync41(
     `gh api --paginate repos/${org}/${repo}/pulls/${prNumber}/comments`,
     { encoding: "utf-8", maxBuffer: 64 * 1024 * 1024 }
   );
@@ -13126,14 +13272,14 @@ function fetchExistingComments() {
 }
 
 // src/commands/review/gatherContext.ts
-import { execSync as execSync43 } from "child_process";
+import { execSync as execSync44 } from "child_process";
 
 // src/commands/review/fetchPrDiff.ts
-import { execSync as execSync41 } from "child_process";
+import { execSync as execSync42 } from "child_process";
 function fetchPrDiff(prNumber, baseSha, headSha) {
   const { org, repo } = getRepoInfo();
   try {
-    return execSync41(`gh pr diff ${prNumber} -R ${org}/${repo}`, {
+    return execSync42(`gh pr diff ${prNumber} -R ${org}/${repo}`, {
       encoding: "utf-8",
       maxBuffer: 256 * 1024 * 1024,
       stdio: ["ignore", "pipe", "pipe"]
@@ -13148,19 +13294,19 @@ function isDiffTooLarge(error) {
 }
 function fetchDiffViaGit(baseSha, headSha) {
   try {
-    execSync41(`git fetch origin ${baseSha} ${headSha}`, { stdio: "ignore" });
+    execSync42(`git fetch origin ${baseSha} ${headSha}`, { stdio: "ignore" });
   } catch {
   }
-  return execSync41(`git diff ${baseSha}...${headSha}`, {
+  return execSync42(`git diff ${baseSha}...${headSha}`, {
     encoding: "utf-8",
     maxBuffer: 256 * 1024 * 1024
   });
 }
 
 // src/commands/review/fetchPrDiffInfo.ts
-import { execSync as execSync42 } from "child_process";
+import { execSync as execSync43 } from "child_process";
 function getCurrentBranch2() {
-  return execSync42("git rev-parse --abbrev-ref HEAD", {
+  return execSync43("git rev-parse --abbrev-ref HEAD", {
     encoding: "utf-8"
   }).trim();
 }
@@ -13170,7 +13316,7 @@ function fetchPrDiffInfo() {
   const fields = "number,baseRefName,baseRefOid,headRefName,headRefOid";
   let raw;
   try {
-    raw = execSync42(`gh pr view ${branch} --json ${fields} -R ${org}/${repo}`, {
+    raw = execSync43(`gh pr view ${branch} --json ${fields} -R ${org}/${repo}`, {
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "pipe"]
     });
@@ -13194,7 +13340,7 @@ function fetchPrDiffInfo() {
 }
 function fetchPrChangedFiles(prNumber) {
   const { org, repo } = getRepoInfo();
-  const out = execSync42(
+  const out = execSync43(
     `gh api repos/${org}/${repo}/pulls/${prNumber}/files --paginate --jq ".[].filename"`,
     {
       encoding: "utf-8",
@@ -13206,11 +13352,11 @@ function fetchPrChangedFiles(prNumber) {
 
 // src/commands/review/gatherContext.ts
 function gatherContext() {
-  const branch = execSync43("git rev-parse --abbrev-ref HEAD", {
+  const branch = execSync44("git rev-parse --abbrev-ref HEAD", {
     encoding: "utf-8"
   }).trim();
-  const sha = execSync43("git rev-parse HEAD", { encoding: "utf-8" }).trim();
-  const shortSha = execSync43("git rev-parse --short=7 HEAD", {
+  const sha = execSync44("git rev-parse HEAD", { encoding: "utf-8" }).trim();
+  const shortSha = execSync44("git rev-parse --short=7 HEAD", {
     encoding: "utf-8"
   }).trim();
   const prInfo = fetchPrDiffInfo();
@@ -15887,6 +16033,7 @@ function registerVerify(program2) {
     "Write scripts to package.json instead of assist.yml"
   ).action(init2);
   verifyCommand.command("hardcoded-colors").description("Check for hardcoded hex colors in src/").action(hardcodedColors);
+  verifyCommand.command("comment-policy").description("Check for undocumented comments added on changed lines").action(commentPolicy);
   verifyCommand.command("no-venv").description("Check that no venv folders exist in the repo").action(noVenv);
 }
 
@@ -15961,7 +16108,7 @@ import { mkdirSync as mkdirSync17 } from "fs";
 import { join as join47 } from "path";
 
 // src/commands/voice/checkLockFile.ts
-import { execSync as execSync44 } from "child_process";
+import { execSync as execSync45 } from "child_process";
 import { existsSync as existsSync45, mkdirSync as mkdirSync16, readFileSync as readFileSync36, writeFileSync as writeFileSync29 } from "fs";
 import { join as join46 } from "path";
 function isProcessAlive2(pid) {
@@ -15990,7 +16137,7 @@ function bootstrapVenv() {
   if (existsSync45(getVenvPython())) return;
   console.log("Setting up Python environment...");
   const pythonDir = getPythonDir();
-  execSync44(
+  execSync45(
     `uv sync --project "${pythonDir}" --extra runtime --no-install-project`,
     {
       stdio: "inherit",
@@ -16157,11 +16304,11 @@ import { randomBytes } from "crypto";
 import chalk156 from "chalk";
 
 // src/lib/openBrowser.ts
-import { execSync as execSync45 } from "child_process";
+import { execSync as execSync46 } from "child_process";
 function tryExec(commands) {
   for (const cmd of commands) {
     try {
-      execSync45(cmd);
+      execSync46(cmd);
       return true;
     } catch {
     }
@@ -16511,11 +16658,11 @@ function resolveParams(params, cliArgs) {
 }
 
 // src/commands/run/runPreCommands.ts
-import { execSync as execSync46 } from "child_process";
+import { execSync as execSync47 } from "child_process";
 function runPreCommands(pre, cwd) {
   for (const cmd of pre) {
     try {
-      execSync46(cmd, { stdio: "inherit", cwd });
+      execSync47(cmd, { stdio: "inherit", cwd });
     } catch (err) {
       const code = err && typeof err === "object" && "status" in err ? err.status : 1;
       process.exit(code);
@@ -16799,7 +16946,7 @@ function registerRun(program2) {
 }
 
 // src/commands/screenshot/index.ts
-import { execSync as execSync47 } from "child_process";
+import { execSync as execSync48 } from "child_process";
 import { existsSync as existsSync50, mkdirSync as mkdirSync20, unlinkSync as unlinkSync16, writeFileSync as writeFileSync32 } from "fs";
 import { tmpdir as tmpdir7 } from "os";
 import { join as join53, resolve as resolve13 } from "path";
@@ -16942,7 +17089,7 @@ function runPowerShellScript(processName, outputPath) {
   const scriptPath = join53(tmpdir7(), `assist-screenshot-${Date.now()}.ps1`);
   writeFileSync32(scriptPath, captureWindowPs1, "utf-8");
   try {
-    execSync47(
+    execSync48(
       `powershell -NoProfile -ExecutionPolicy Bypass -File "${scriptPath}" -ProcessName "${processName}" -OutputPath "${outputPath}"`,
       { stdio: ["ignore", "pipe", "pipe"], encoding: "utf-8" }
     );
@@ -17137,12 +17284,12 @@ function daemonLog(message) {
 }
 
 // src/commands/sessions/shared/discoverSessions.ts
-import * as fs25 from "fs";
+import * as fs26 from "fs";
 import * as os from "os";
 import * as path46 from "path";
 
 // src/commands/sessions/shared/parseSessionFile.ts
-import * as fs24 from "fs";
+import * as fs25 from "fs";
 import * as path45 from "path";
 
 // src/commands/sessions/shared/extractSessionMeta.ts
@@ -17182,13 +17329,13 @@ function extractName(entry) {
 async function parseSessionFile(filePath) {
   let handle;
   try {
-    handle = await fs24.promises.open(filePath, "r");
+    handle = await fs25.promises.open(filePath, "r");
     const buf = Buffer.alloc(16384);
     const { bytesRead } = await handle.read(buf, 0, buf.length, 0);
     const lines = buf.toString("utf8", 0, bytesRead).split("\n").filter(Boolean);
     const meta = extractSessionMeta(lines);
     if (!meta.sessionId) return null;
-    const timestamp = meta.timestamp || (await fs24.promises.stat(filePath)).mtime.toISOString();
+    const timestamp = meta.timestamp || (await fs25.promises.stat(filePath)).mtime.toISOString();
     const project = meta.cwd ? path45.basename(meta.cwd) : dirNameToProject(filePath);
     return {
       sessionId: meta.sessionId,
@@ -17214,7 +17361,7 @@ async function discoverSessionJsonlPaths() {
   const projectsDir = path46.join(os.homedir(), ".claude", "projects");
   let projectDirs;
   try {
-    projectDirs = await fs25.promises.readdir(projectsDir);
+    projectDirs = await fs26.promises.readdir(projectsDir);
   } catch {
     return [];
   }
@@ -17224,7 +17371,7 @@ async function discoverSessionJsonlPaths() {
       const dirPath = path46.join(projectsDir, dirName);
       let entries;
       try {
-        entries = await fs25.promises.readdir(dirPath);
+        entries = await fs26.promises.readdir(dirPath);
       } catch {
         return;
       }
@@ -17663,7 +17810,7 @@ function shutdownSessions(sessions) {
 }
 
 // src/commands/sessions/daemon/discoverClaudeSessionId.ts
-import * as fs26 from "fs";
+import * as fs27 from "fs";
 import * as path48 from "path";
 var POLL_MS = 3e3;
 async function discoverClaudeSessionId(options2) {
@@ -17687,7 +17834,7 @@ async function findNewSessionId(options2) {
 }
 async function isCreatedSince(filePath, sinceMs) {
   try {
-    const stat = await fs26.promises.stat(filePath);
+    const stat = await fs27.promises.stat(filePath);
     return (stat.birthtimeMs || stat.mtimeMs) >= sinceMs;
   } catch {
     return false;
@@ -18064,17 +18211,17 @@ function registerDaemon(program2) {
 }
 
 // src/commands/sessions/summarise/index.ts
-import * as fs29 from "fs";
+import * as fs30 from "fs";
 import chalk158 from "chalk";
 
 // src/commands/sessions/summarise/shared.ts
-import * as fs27 from "fs";
+import * as fs28 from "fs";
 function writeSummary(jsonlPath2, summary) {
-  fs27.writeFileSync(summaryPathFor(jsonlPath2), `${summary.trim()}
+  fs28.writeFileSync(summaryPathFor(jsonlPath2), `${summary.trim()}
 `, "utf8");
 }
 function hasSummary(jsonlPath2) {
-  return fs27.existsSync(summaryPathFor(jsonlPath2));
+  return fs28.existsSync(summaryPathFor(jsonlPath2));
 }
 function summaryPathFor(jsonlPath2) {
   return jsonlPath2.replace(/\.jsonl$/, ".summary");
@@ -18084,17 +18231,17 @@ function summaryPathFor(jsonlPath2) {
 import { execFileSync as execFileSync10 } from "child_process";
 
 // src/commands/sessions/summarise/iterateUserMessages.ts
-import * as fs28 from "fs";
+import * as fs29 from "fs";
 function* iterateUserMessages(filePath, maxBytes = 65536) {
   let content;
   try {
-    const fd = fs28.openSync(filePath, "r");
+    const fd = fs29.openSync(filePath, "r");
     try {
       const buf = Buffer.alloc(maxBytes);
-      const bytesRead = fs28.readSync(fd, buf, 0, buf.length, 0);
+      const bytesRead = fs29.readSync(fd, buf, 0, buf.length, 0);
       content = buf.toString("utf8", 0, bytesRead);
     } finally {
-      fs28.closeSync(fd);
+      fs29.closeSync(fd);
     }
   } catch {
     return;
@@ -18214,7 +18361,7 @@ function selectCandidates(files, options2) {
   const candidates = options2.force ? files : files.filter((f) => !hasSummary(f));
   candidates.sort((a, b) => {
     try {
-      return fs29.statSync(b).mtimeMs - fs29.statSync(a).mtimeMs;
+      return fs30.statSync(b).mtimeMs - fs30.statSync(a).mtimeMs;
     } catch {
       return 0;
     }
@@ -18328,21 +18475,21 @@ async function statusLine() {
 }
 
 // src/commands/sync.ts
-import * as fs32 from "fs";
+import * as fs33 from "fs";
 import * as os2 from "os";
 import * as path51 from "path";
 import { fileURLToPath as fileURLToPath7 } from "url";
 
 // src/commands/sync/syncClaudeMd.ts
-import * as fs30 from "fs";
+import * as fs31 from "fs";
 import * as path49 from "path";
 import chalk161 from "chalk";
 async function syncClaudeMd(claudeDir, targetBase, options2) {
   const source = path49.join(claudeDir, "CLAUDE.md");
   const target = path49.join(targetBase, "CLAUDE.md");
-  const sourceContent = fs30.readFileSync(source, "utf-8");
-  if (fs30.existsSync(target)) {
-    const targetContent = fs30.readFileSync(target, "utf-8");
+  const sourceContent = fs31.readFileSync(source, "utf-8");
+  if (fs31.existsSync(target)) {
+    const targetContent = fs31.readFileSync(target, "utf-8");
     if (sourceContent !== targetContent) {
       console.log(
         chalk161.yellow("\n\u26A0\uFE0F  Warning: CLAUDE.md differs from existing file")
@@ -18359,21 +18506,21 @@ async function syncClaudeMd(claudeDir, targetBase, options2) {
       }
     }
   }
-  fs30.copyFileSync(source, target);
+  fs31.copyFileSync(source, target);
   console.log("Copied CLAUDE.md to ~/.claude/CLAUDE.md");
 }
 
 // src/commands/sync/syncSettings.ts
-import * as fs31 from "fs";
+import * as fs32 from "fs";
 import * as path50 from "path";
 import chalk162 from "chalk";
 async function syncSettings(claudeDir, targetBase, options2) {
   const source = path50.join(claudeDir, "settings.json");
   const target = path50.join(targetBase, "settings.json");
-  const sourceContent = fs31.readFileSync(source, "utf-8");
+  const sourceContent = fs32.readFileSync(source, "utf-8");
   const mergedContent = JSON.stringify(JSON.parse(sourceContent), null, "	");
-  if (fs31.existsSync(target)) {
-    const targetContent = fs31.readFileSync(target, "utf-8");
+  if (fs32.existsSync(target)) {
+    const targetContent = fs32.readFileSync(target, "utf-8");
     const normalizedTarget = JSON.stringify(
       JSON.parse(targetContent),
       null,
@@ -18399,7 +18546,7 @@ async function syncSettings(claudeDir, targetBase, options2) {
       }
     }
   }
-  fs31.writeFileSync(target, mergedContent);
+  fs32.writeFileSync(target, mergedContent);
   console.log("Copied settings.json to ~/.claude/settings.json");
 }
 
@@ -18418,17 +18565,17 @@ async function sync(options2) {
 function syncCommands(claudeDir, targetBase) {
   const sourceDir = path51.join(claudeDir, "commands");
   const targetDir = path51.join(targetBase, "commands");
-  fs32.mkdirSync(targetDir, { recursive: true });
-  const files = fs32.readdirSync(sourceDir);
+  fs33.mkdirSync(targetDir, { recursive: true });
+  const files = fs33.readdirSync(sourceDir);
   for (const file of files) {
-    fs32.copyFileSync(path51.join(sourceDir, file), path51.join(targetDir, file));
+    fs33.copyFileSync(path51.join(sourceDir, file), path51.join(targetDir, file));
     console.log(`Copied ${file} to ${targetDir}`);
   }
   console.log(`Synced ${files.length} command(s) to ~/.claude/commands`);
 }
 
 // src/commands/update.ts
-import { execSync as execSync48 } from "child_process";
+import { execSync as execSync49 } from "child_process";
 import * as path52 from "path";
 function isGlobalNpmInstall(dir) {
   try {
@@ -18436,7 +18583,7 @@ function isGlobalNpmInstall(dir) {
     if (resolved.split(path52.sep).includes("node_modules")) {
       return true;
     }
-    const globalPrefix = execSync48("npm prefix -g", { stdio: "pipe" }).toString().trim();
+    const globalPrefix = execSync49("npm prefix -g", { stdio: "pipe" }).toString().trim();
     return resolved.toLowerCase().startsWith(path52.resolve(globalPrefix).toLowerCase());
   } catch {
     return false;
@@ -18447,18 +18594,18 @@ async function update2() {
   console.log(`Assist is installed at: ${installDir}`);
   if (isGitRepo(installDir)) {
     console.log("Detected git repo installation, pulling latest...");
-    execSync48("git pull", { cwd: installDir, stdio: "inherit" });
+    execSync49("git pull", { cwd: installDir, stdio: "inherit" });
     console.log("Installing dependencies...");
-    execSync48("npm i", { cwd: installDir, stdio: "inherit" });
+    execSync49("npm i", { cwd: installDir, stdio: "inherit" });
     console.log("Building...");
-    execSync48("npm run build", { cwd: installDir, stdio: "inherit" });
+    execSync49("npm run build", { cwd: installDir, stdio: "inherit" });
     console.log("Syncing commands...");
-    execSync48("assist sync", { stdio: "inherit" });
+    execSync49("assist sync", { stdio: "inherit" });
   } else if (isGlobalNpmInstall(installDir)) {
     console.log("Detected global npm installation, updating...");
-    execSync48("npm i -g @staff0rd/assist@latest", { stdio: "inherit" });
+    execSync49("npm i -g @staff0rd/assist@latest", { stdio: "inherit" });
     console.log("Syncing commands...");
-    execSync48("assist sync", { stdio: "inherit" });
+    execSync49("assist sync", { stdio: "inherit" });
   } else {
     console.error(
       "Could not determine installation method. Expected a git repo or global npm install."