@staff0rd/assist 0.345.0 → 0.346.0

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.345.0",
+  version: "0.346.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -1755,10 +1755,20 @@ import { basename, resolve as resolve5 } from "path";
 
 // src/commands/verify/blockComments/findComments.ts
 import { execSync as execSync6 } from "child_process";
-import fs13 from "fs";
+import fs14 from "fs";
 import { minimatch } from "minimatch";
 import { Project as Project2 } from "ts-morph";
 
+// src/commands/verify/blockComments/collectFileComments.ts
+import fs13 from "fs";
+
+// src/shared/isYamlFile.ts
+var YAML_EXTENSIONS = [".yml", ".yaml"];
+function isYamlFile(filePath) {
+  if (!filePath) return false;
+  return YAML_EXTENSIONS.some((ext) => filePath.endsWith(ext));
+}
+
 // src/commands/verify/blockComments/collectComments.ts
 function collectComments(sourceFile) {
   const seen = /* @__PURE__ */ new Set();
@@ -1779,6 +1789,18 @@ function collectComments(sourceFile) {
   return comments3;
 }
 
+// src/commands/verify/blockComments/collectYamlComments.ts
+import { Lexer } from "yaml";
+function collectYamlComments(content) {
+  const comments3 = [];
+  let line = 1;
+  for (const token of new Lexer().lex(content)) {
+    if (token.startsWith("#")) comments3.push({ line, text: token });
+    for (const char of token) if (char === "\n") line++;
+  }
+  return comments3;
+}
+
 // src/commands/complexity/maintainability/parseMaintainabilityOverride.ts
 var MAINTAINABILITY_OVERRIDE_MARKER = "assist-maintainability-override";
 var OVERRIDE_MARKER = /^\s*\/\/\s*assist-maintainability-override:?\s*(-?\d+)\s*$/;
@@ -1817,6 +1839,31 @@ function isCommentExempt(text7) {
   return MACHINE_DIRECTIVES.some((d) => lower.includes(d));
 }
 
+// src/commands/verify/blockComments/collectFileComments.ts
+function toSingleLine(text7) {
+  return text7.replace(/\s+/g, " ").trim();
+}
+function collectFileComments(file, lines, project) {
+  const findings = [];
+  if (isYamlFile(file)) {
+    for (const { line, text: text7 } of collectYamlComments(
+      fs13.readFileSync(file, "utf8")
+    )) {
+      if (lines.has(line))
+        findings.push({ file, line, text: toSingleLine(text7) });
+    }
+    return findings;
+  }
+  const sourceFile = project.addSourceFileAtPath(file);
+  for (const { pos, text: text7 } of collectComments(sourceFile)) {
+    const { line } = sourceFile.getLineAndColumnAtPos(pos);
+    if (!lines.has(line)) continue;
+    if (isCommentExempt(text7)) continue;
+    findings.push({ file, line, text: toSingleLine(text7) });
+  }
+  return findings;
+}
+
 // src/commands/verify/blockComments/parseDiffAddedLines.ts
 var FILE_HEADER = /^\+\+\+ (?:b\/)?(.+)$/;
 var HUNK_HEADER = /^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@/;
@@ -1853,14 +1900,20 @@ function parseDiffAddedLines(diff2) {
 }
 
 // src/commands/verify/blockComments/findComments.ts
-var SOURCE_EXTENSIONS = [".ts", ".tsx", ".cts", ".mts", ".js", ".jsx"];
-function toSingleLine(text7) {
-  return text7.replace(/\s+/g, " ").trim();
-}
+var SCANNED_EXTENSIONS = [
+  ".ts",
+  ".tsx",
+  ".cts",
+  ".mts",
+  ".js",
+  ".jsx",
+  ".yml",
+  ".yaml"
+];
 function shouldScan(file, ignoreGlobs) {
-  if (!SOURCE_EXTENSIONS.some((ext) => file.endsWith(ext))) return false;
+  if (!SCANNED_EXTENSIONS.some((ext) => file.endsWith(ext))) return false;
   if (ignoreGlobs.some((glob) => minimatch(file, glob))) return false;
-  return fs13.existsSync(file);
+  return fs14.existsSync(file);
 }
 function findComments(options2) {
   const diff2 = execSync6("git diff HEAD", {
@@ -1875,13 +1928,7 @@ function findComments(options2) {
   const findings = [];
   for (const [file, lines] of addedLines) {
     if (!shouldScan(file, options2.ignoreGlobs)) continue;
-    const sourceFile = project.addSourceFileAtPath(file);
-    for (const { pos, text: text7 } of collectComments(sourceFile)) {
-      const { line } = sourceFile.getLineAndColumnAtPos(pos);
-      if (!lines.has(line)) continue;
-      if (isCommentExempt(text7)) continue;
-      findings.push({ file, line, text: toSingleLine(text7) });
-    }
+    findings.push(...collectFileComments(file, lines, project));
   }
   findings.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line);
   return findings;
@@ -2661,7 +2708,7 @@ function detectPlatform() {
 
 // src/commands/notify/showNotification/showWindowsNotificationFromWsl.ts
 import { spawn as spawn2 } from "child_process";
-import fs14 from "fs";
+import fs15 from "fs";
 import { createRequire } from "module";
 import path19 from "path";
 var require2 = createRequire(import.meta.url);
@@ -2673,7 +2720,7 @@ function showWindowsNotificationFromWsl(options2) {
   const { title, message, sound } = options2;
   const snoreToastPath = getSnoreToastPath();
   try {
-    fs14.chmodSync(snoreToastPath, 493);
+    fs15.chmodSync(snoreToastPath, 493);
   } catch {
   }
   const args = ["-t", title, "-m", message];
@@ -9712,7 +9759,7 @@ function registerCliHook(program2) {
 }
 
 // src/commands/codeComment/codeCommentConfirm.ts
-import { existsSync as existsSync28, readFileSync as readFileSync23, unlinkSync as unlinkSync8, writeFileSync as writeFileSync22 } from "fs";
+import { existsSync as existsSync29, readFileSync as readFileSync24, unlinkSync as unlinkSync8, writeFileSync as writeFileSync22 } from "fs";
 import chalk95 from "chalk";
 
 // src/commands/codeComment/getRestrictedDir.ts
@@ -9747,7 +9794,8 @@ function sweepRestrictedDir(dir = getRestrictedDir()) {
   }
 }
 
-// src/commands/codeComment/codeCommentConfirm.ts
+// src/commands/codeComment/readPinState.ts
+import { existsSync as existsSync28, readFileSync as readFileSync23 } from "fs";
 function readPinState(pin) {
   const path57 = getPinStatePath(pin);
   if (!existsSync28(path57)) return void 0;
@@ -9759,6 +9807,8 @@ function readPinState(pin) {
     return void 0;
   }
 }
+
+// src/commands/codeComment/codeCommentConfirm.ts
 function codeCommentConfirm(pin) {
   sweepRestrictedDir();
   const state = readPinState(pin);
@@ -9767,12 +9817,12 @@ function codeCommentConfirm(pin) {
     process.exitCode = 1;
     return;
   }
-  if (!existsSync28(state.file)) {
+  if (!existsSync29(state.file)) {
     console.error(chalk95.red(`Target file no longer exists: ${state.file}`));
     process.exitCode = 1;
     return;
   }
-  const original = readFileSync23(state.file, "utf8");
+  const original = readFileSync24(state.file, "utf8");
   const lines = original.split("\n");
   const index3 = state.line - 1;
   if (index3 > lines.length) {
@@ -9784,13 +9834,16 @@ function codeCommentConfirm(pin) {
     process.exitCode = 1;
     return;
   }
+  const marker = isYamlFile(state.file) ? "#" : "//";
   const indentSource = lines[index3] ?? "";
   const indent2 = indentSource.match(/^\s*/)?.[0] ?? "";
-  lines.splice(index3, 0, `${indent2}// ${state.text}`);
+  lines.splice(index3, 0, `${indent2}${marker} ${state.text}`);
   writeFileSync22(state.file, lines.join("\n"));
   unlinkSync8(getPinStatePath(pin));
   console.log(
-    chalk95.green(`Inserted "// ${state.text}" at ${state.file}:${state.line}`)
+    chalk95.green(
+      `Inserted "${marker} ${state.text}" at ${state.file}:${state.line}`
+    )
   );
 }
 
@@ -9799,15 +9852,15 @@ import chalk96 from "chalk";
 
 // src/commands/codeComment/validateCommentText.ts
 var MAX_COMMENT_LENGTH = 50;
-function validateCommentText(raw) {
-  const text7 = raw.replace(/^\/\/\s?/, "");
+function validateCommentText(raw, isYaml = false) {
+  const text7 = isYaml ? raw.replace(/^#\s?/, "") : raw.replace(/^\/\/\s?/, "");
   if (/[\r\n]/.test(text7)) {
     return {
       ok: false,
       reason: "Comment must be a single line \u2014 multi-line comments are not allowed."
     };
   }
-  if (text7.includes("/*") || text7.includes("*/")) {
+  if (!isYaml && (text7.includes("/*") || text7.includes("*/"))) {
     return {
       ok: false,
       reason: "Block comments (/* */) are not allowed \u2014 only single-line // comments."
@@ -9850,7 +9903,8 @@ function codeCommentSet(file, line, text7) {
     process.exitCode = 1;
     return;
   }
-  const validation = validateCommentText(text7);
+  const marker = isYamlFile(file) ? "#" : "//";
+  const validation = validateCommentText(text7, isYamlFile(file));
   if (!validation.ok) {
     console.error(chalk96.red(`Refused: ${validation.reason}`));
     console.error(chalk96.red("No pin issued."));
@@ -9874,7 +9928,7 @@ function codeCommentSet(file, line, text7) {
   }
   console.log(
     `A confirmation pin was sent to your desktop notifications.
-To insert "// ${validation.text}" at ${file}:${lineNumber}, run:
+To insert "${marker} ${validation.text}" at ${file}:${lineNumber}, run:
 ${chalk96.cyan("  assist code-comment confirm <PIN>")}
 using the pin from that notification.`
   );
@@ -9901,13 +9955,13 @@ import chalk105 from "chalk";
 import chalk98 from "chalk";
 
 // src/commands/complexity/shared/index.ts
-import fs16 from "fs";
+import fs17 from "fs";
 import path21 from "path";
 import chalk97 from "chalk";
 import ts5 from "typescript";
 
 // src/commands/complexity/findSourceFiles.ts
-import fs15 from "fs";
+import fs16 from "fs";
 import path20 from "path";
 import { minimatch as minimatch5 } from "minimatch";
 function applyIgnoreGlobs(files, extraIgnore = []) {
@@ -9916,11 +9970,11 @@ function applyIgnoreGlobs(files, extraIgnore = []) {
   return files.filter((f) => !ignore2.some((glob) => minimatch5(f, glob)));
 }
 function walk(dir, results) {
-  if (!fs15.existsSync(dir)) {
+  if (!fs16.existsSync(dir)) {
     return;
   }
   const extensions = [".ts", ".tsx"];
-  const entries = fs15.readdirSync(dir, { withFileTypes: true });
+  const entries = fs16.readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
     const fullPath = path20.join(dir, entry.name);
     if (entry.isDirectory()) {
@@ -9941,10 +9995,10 @@ function findSourceFiles2(pattern2, baseDir = ".", extraIgnore = []) {
       extraIgnore
     );
   }
-  if (fs15.existsSync(pattern2) && fs15.statSync(pattern2).isFile()) {
+  if (fs16.existsSync(pattern2) && fs16.statSync(pattern2).isFile()) {
     return [pattern2];
   }
-  if (fs15.existsSync(pattern2) && fs15.statSync(pattern2).isDirectory()) {
+  if (fs16.existsSync(pattern2) && fs16.statSync(pattern2).isDirectory()) {
     walk(pattern2, results);
     return applyIgnoreGlobs(results, extraIgnore);
   }
@@ -10142,7 +10196,7 @@ function countSloc(content) {
 
 // src/commands/complexity/shared/index.ts
 function createSourceFromFile(filePath) {
-  const content = fs16.readFileSync(filePath, "utf8");
+  const content = fs17.readFileSync(filePath, "utf8");
   return ts5.createSourceFile(
     path21.basename(filePath),
     content,
@@ -10302,7 +10356,7 @@ function printMaintainabilityFormula() {
 }
 
 // src/commands/complexity/maintainability/collectFileMetrics.ts
-import fs17 from "fs";
+import fs18 from "fs";
 
 // src/commands/complexity/maintainability/calculateMaintainabilityIndex.ts
 function calculateMaintainabilityIndex(halsteadVolume, cyclomaticComplexity, sloc2) {
@@ -10317,7 +10371,7 @@ function calculateMaintainabilityIndex(halsteadVolume, cyclomaticComplexity, slo
 function collectFileMetrics(files) {
   const fileMetrics = /* @__PURE__ */ new Map();
   for (const file of files) {
-    const content = fs17.readFileSync(file, "utf8");
+    const content = fs18.readFileSync(file, "utf8");
     fileMetrics.set(file, {
       sloc: countSloc(content),
       functions: [],
@@ -10373,14 +10427,14 @@ async function maintainability(pattern2 = "**/*.ts", options2 = {}) {
 }
 
 // src/commands/complexity/sloc.ts
-import fs18 from "fs";
+import fs19 from "fs";
 import chalk104 from "chalk";
 async function sloc(pattern2 = "**/*.ts", options2 = {}) {
   withSourceFiles(pattern2, (files) => {
     const results = [];
     let hasViolation = false;
     for (const file of files) {
-      const content = fs18.readFileSync(file, "utf8");
+      const content = fs19.readFileSync(file, "utf8");
       const lines = countSloc(content);
       results.push({ file, lines });
       if (options2.threshold !== void 0 && lines > options2.threshold) {
@@ -10618,7 +10672,7 @@ function registerConfig(program2) {
 }
 
 // src/commands/deploy/redirect.ts
-import { existsSync as existsSync29, readFileSync as readFileSync24, writeFileSync as writeFileSync24 } from "fs";
+import { existsSync as existsSync30, readFileSync as readFileSync25, writeFileSync as writeFileSync24 } from "fs";
 import chalk108 from "chalk";
 var TRAILING_SLASH_SCRIPT = `    <script>
       if (!window.location.pathname.endsWith('/')) {
@@ -10627,11 +10681,11 @@ var TRAILING_SLASH_SCRIPT = `    <script>
     </script>`;
 function redirect() {
   const indexPath = "index.html";
-  if (!existsSync29(indexPath)) {
+  if (!existsSync30(indexPath)) {
     console.log(chalk108.yellow("No index.html found"));
     return;
   }
-  const content = readFileSync24(indexPath, "utf8");
+  const content = readFileSync25(indexPath, "utf8");
   if (content.includes("window.location.pathname.endsWith('/')")) {
     console.log(chalk108.dim("Trailing slash script already present"));
     return;
@@ -10674,7 +10728,7 @@ import { execSync as execSync24 } from "child_process";
 import chalk109 from "chalk";
 
 // src/shared/getRepoName.ts
-import { existsSync as existsSync30, readFileSync as readFileSync25 } from "fs";
+import { existsSync as existsSync31, readFileSync as readFileSync26 } from "fs";
 import { basename as basename5, join as join30 } from "path";
 function getRepoName() {
   const config = loadConfig();
@@ -10682,9 +10736,9 @@ function getRepoName() {
     return config.devlog.name;
   }
   const packageJsonPath = join30(process.cwd(), "package.json");
-  if (existsSync30(packageJsonPath)) {
+  if (existsSync31(packageJsonPath)) {
     try {
-      const content = readFileSync25(packageJsonPath, "utf8");
+      const content = readFileSync26(packageJsonPath, "utf8");
       const pkg = JSON.parse(content);
       if (pkg.name) {
         return pkg.name;
@@ -10696,7 +10750,7 @@ function getRepoName() {
 }
 
 // src/commands/devlog/loadDevlogEntries.ts
-import { readdirSync as readdirSync3, readFileSync as readFileSync26 } from "fs";
+import { readdirSync as readdirSync3, readFileSync as readFileSync27 } from "fs";
 import { join as join31 } from "path";
 var DEVLOG_DIR = join31(BLOG_REPO_ROOT, "src/content/devlog");
 function extractFrontmatter(content) {
@@ -10726,7 +10780,7 @@ function readDevlogFiles(callback) {
   try {
     const files = readdirSync3(DEVLOG_DIR).filter((f) => f.endsWith(".md"));
     for (const file of files) {
-      const content = readFileSync26(join31(DEVLOG_DIR, file), "utf8");
+      const content = readFileSync27(join31(DEVLOG_DIR, file), "utf8");
       const parsed = parseFrontmatter(content, file);
       if (parsed) callback(parsed);
     }
@@ -11183,12 +11237,12 @@ import { join as join33 } from "path";
 import chalk116 from "chalk";
 
 // src/shared/findRepoRoot.ts
-import { existsSync as existsSync31 } from "fs";
+import { existsSync as existsSync32 } from "fs";
 import path22 from "path";
 function findRepoRoot(dir) {
   let current = dir;
   while (current !== path22.dirname(current)) {
-    if (existsSync31(path22.join(current, ".git"))) {
+    if (existsSync32(path22.join(current, ".git"))) {
       return current;
     }
     current = path22.dirname(current);
@@ -11254,11 +11308,11 @@ async function checkBuildLocksCommand() {
 }
 
 // src/commands/dotnet/buildTree.ts
-import { readFileSync as readFileSync27 } from "fs";
+import { readFileSync as readFileSync28 } from "fs";
 import path23 from "path";
 var PROJECT_REF_RE = /<ProjectReference\s+Include="([^"]+)"/g;
 function getProjectRefs(csprojPath) {
-  const content = readFileSync27(csprojPath, "utf8");
+  const content = readFileSync28(csprojPath, "utf8");
   const refs = [];
   for (const match of content.matchAll(PROJECT_REF_RE)) {
     refs.push(match[1].replace(/\\/g, "/"));
@@ -11275,7 +11329,7 @@ function buildTree(csprojPath, repoRoot, visited = /* @__PURE__ */ new Set()) {
   for (const ref of getProjectRefs(abs)) {
     const childAbs = path23.resolve(dir, ref);
     try {
-      readFileSync27(childAbs);
+      readFileSync28(childAbs);
       node.children.push(buildTree(childAbs, repoRoot, visited));
     } catch {
       node.children.push({
@@ -11300,7 +11354,7 @@ function collectAllDeps(node) {
 }
 
 // src/commands/dotnet/findContainingSolutions.ts
-import { readdirSync as readdirSync5, readFileSync as readFileSync28, statSync as statSync4 } from "fs";
+import { readdirSync as readdirSync5, readFileSync as readFileSync29, statSync as statSync4 } from "fs";
 import path24 from "path";
 function findSlnFiles(dir, maxDepth, depth = 0) {
   if (depth > maxDepth) return [];
@@ -11335,7 +11389,7 @@ function findContainingSolutions(csprojPath, repoRoot) {
   const pattern2 = new RegExp(`[\\\\"/]${escapeRegex(csprojBasename)}"`);
   for (const sln of slnFiles) {
     try {
-      const content = readFileSync28(sln, "utf8");
+      const content = readFileSync29(sln, "utf8");
       if (pattern2.test(content)) {
         matches.push(path24.relative(repoRoot, sln));
       }
@@ -11399,12 +11453,12 @@ function printJson(tree, totalCount, solutions) {
 }
 
 // src/commands/dotnet/resolveCsproj.ts
-import { existsSync as existsSync32 } from "fs";
+import { existsSync as existsSync33 } from "fs";
 import path25 from "path";
 import chalk118 from "chalk";
 function resolveCsproj(csprojPath) {
   const resolved = path25.resolve(csprojPath);
-  if (!existsSync32(resolved)) {
+  if (!existsSync33(resolved)) {
     console.error(chalk118.red(`File not found: ${resolved}`));
     process.exit(1);
   }
@@ -11572,7 +11626,7 @@ function filterIssues(issues, all, cliOnly, cliSuppress) {
 }
 
 // src/commands/dotnet/resolveSolution.ts
-import { existsSync as existsSync33 } from "fs";
+import { existsSync as existsSync34 } from "fs";
 import path26 from "path";
 import chalk122 from "chalk";
 
@@ -11613,7 +11667,7 @@ function findSolution() {
 function resolveSolution(sln) {
   if (sln) {
     const resolved = path26.resolve(sln);
-    if (!existsSync33(resolved)) {
+    if (!existsSync34(resolved)) {
       console.error(chalk122.red(`Solution file not found: ${resolved}`));
       process.exit(1);
     }
@@ -11653,7 +11707,7 @@ function parseInspectReport(json) {
 
 // src/commands/dotnet/runInspectCode.ts
 import { execSync as execSync28 } from "child_process";
-import { existsSync as existsSync34, readFileSync as readFileSync29, unlinkSync as unlinkSync9 } from "fs";
+import { existsSync as existsSync35, readFileSync as readFileSync30, unlinkSync as unlinkSync9 } from "fs";
 import { tmpdir as tmpdir3 } from "os";
 import path27 from "path";
 import chalk123 from "chalk";
@@ -11684,11 +11738,11 @@ function runInspectCode(slnPath, include, swea) {
     console.error(chalk123.red("jb inspectcode failed"));
     process.exit(1);
   }
-  if (!existsSync34(reportPath)) {
+  if (!existsSync35(reportPath)) {
     console.error(chalk123.red("Report file not generated"));
     process.exit(1);
   }
-  const xml = readFileSync29(reportPath, "utf8");
+  const xml = readFileSync30(reportPath, "utf8");
   unlinkSync9(reportPath);
   return xml;
 }
@@ -11803,10 +11857,10 @@ function registerDotnet(program2) {
 }
 
 // src/commands/editHook/index.ts
-import fs19 from "fs";
+import fs20 from "fs";
 
 // src/commands/editHook/extractComments.ts
-var SOURCE_EXTENSIONS2 = [
+var SOURCE_EXTENSIONS = [
   ".ts",
   ".tsx",
   ".cts",
@@ -11818,7 +11872,7 @@ var SOURCE_EXTENSIONS2 = [
 ];
 function isSourceFile(filePath) {
   if (!filePath) return false;
-  return SOURCE_EXTENSIONS2.some((ext) => filePath.endsWith(ext));
+  return SOURCE_EXTENSIONS.some((ext) => filePath.endsWith(ext));
 }
 function blankNonNewline(text7) {
   return text7.replace(/[^\n]/g, " ");
@@ -11839,6 +11893,22 @@ function extractComments(text7) {
   return comments3.map((comment3) => comment3.replace(/\s+/g, " ").trim()).filter((comment3) => comment3.length > 0).filter((comment3) => !isCommentExempt(comment3));
 }
 
+// src/commands/editHook/extractYamlComments.ts
+function blankNonNewline2(text7) {
+  return text7.replace(/[^\n]/g, " ");
+}
+function extractYamlComments(text7) {
+  const work = text7.replace(
+    /"(?:[^"\\]|\\.)*"|'(?:[^']|'')*'/g,
+    blankNonNewline2
+  );
+  const comments3 = [];
+  for (const match of work.matchAll(/(?:^|\s)(#.*)/gm)) {
+    comments3.push(match[1]);
+  }
+  return comments3.map((comment3) => comment3.replace(/\s+/g, " ").trim()).filter((comment3) => comment3.length > 0);
+}
+
 // src/commands/editHook/introducedComments.ts
 function introducedComments(added, removed) {
   const counts = /* @__PURE__ */ new Map();
@@ -11863,7 +11933,10 @@ function commentWords(comment3) {
 }
 
 // src/commands/editHook/decideCommentGuard.ts
-var DENY_REASON = 'This edit introduces a code comment, which is blocked by the comment gate. Comments are a last resort \u2014 prefer a clearer name, a smaller function, or a test that makes the comment unnecessary. The comment must not appear in your edit itself. If this one line genuinely earns its keep, use the escape hatch: run `assist code-comment set <file> <line> "<text>"` (single line, max 50 chars, no block comments) to get a pin, then `assist code-comment confirm <pin>` to insert it.';
+function denyReason(marker) {
+  const blockClause = marker === "//" ? ", no block comments" : "";
+  return `This edit introduces a code comment (${marker}), which is blocked by the comment gate. Comments are a last resort \u2014 prefer a clearer name, a smaller function, or a test that makes the comment unnecessary. The comment must not appear in your edit itself. If this one line genuinely earns its keep, use the escape hatch: run \`assist code-comment set <file> <line> "<text>"\` (single line, max 50 chars${blockClause}) to get a pin, then \`assist code-comment confirm <pin>\` to insert it.`;
+}
 function defined(values) {
   return values.filter((value) => value != null);
 }
@@ -11892,17 +11965,20 @@ function partitionStrings(input, existingContent) {
   }
 }
 function decideCommentGuard(input, existingContent) {
-  if (!isSourceFile(input.tool_input.file_path)) return void 0;
+  const filePath = input.tool_input.file_path;
+  const yaml = isYamlFile(filePath);
+  if (!isSourceFile(filePath) && !yaml) return void 0;
+  const extract2 = yaml ? extractYamlComments : extractComments;
   const { added, removed } = partitionStrings(input, existingContent);
   const introduced = introducedComments(
-    added.flatMap(extractComments),
-    removed.flatMap(extractComments)
+    added.flatMap(extract2),
+    removed.flatMap(extract2)
   );
-  return introduced.length > 0 ? DENY_REASON : void 0;
+  return introduced.length > 0 ? denyReason(yaml ? "#" : "//") : void 0;
 }
 
 // src/commands/editHook/decideOverrideGuard.ts
-var DENY_REASON2 = `Edits touching the '${MAINTAINABILITY_OVERRIDE_MARKER}' marker are blocked. This marker is a human-managed maintainability gate exception \u2014 an agent may not add, change, or remove it. If a file genuinely needs a different threshold, raise it with a human.`;
+var DENY_REASON = `Edits touching the '${MAINTAINABILITY_OVERRIDE_MARKER}' marker are blocked. This marker is a human-managed maintainability gate exception \u2014 an agent may not add, change, or remove it. If a file genuinely needs a different threshold, raise it with a human.`;
 function candidateStrings(input, existingContent) {
   const { tool_name, tool_input } = input;
   switch (tool_name) {
@@ -11928,7 +12004,7 @@ function decideOverrideGuard(input, existingContent) {
   const touchesMarker = candidateStrings(input, existingContent).some(
     (s) => s.includes(MAINTAINABILITY_OVERRIDE_MARKER)
   );
-  return touchesMarker ? DENY_REASON2 : void 0;
+  return touchesMarker ? DENY_REASON : void 0;
 }
 
 // src/commands/editHook/index.ts
@@ -11945,7 +12021,7 @@ function tryParseInput2(raw) {
 function readExisting(filePath) {
   if (!filePath) return void 0;
   try {
-    return fs19.readFileSync(filePath, "utf8");
+    return fs20.readFileSync(filePath, "utf8");
   } catch {
     return void 0;
   }
@@ -12203,9 +12279,9 @@ async function countPendingHandovers(orm, origin) {
 
 // src/commands/handover/migrateDiskHandovers.ts
 import {
-  existsSync as existsSync35,
+  existsSync as existsSync36,
   readdirSync as readdirSync7,
-  readFileSync as readFileSync30,
+  readFileSync as readFileSync31,
   rmSync as rmSync2,
   statSync as statSync5
 } from "fs";
@@ -12258,7 +12334,7 @@ function summariseHandoverContent(content) {
 
 // src/commands/handover/migrateDiskHandovers.ts
 function collectMarkdown(dir) {
-  if (!existsSync35(dir)) return [];
+  if (!existsSync36(dir)) return [];
   const out = [];
   for (const entry of readdirSync7(dir, { withFileTypes: true })) {
     const full = join38(dir, entry.name);
@@ -12268,7 +12344,7 @@ function collectMarkdown(dir) {
   return out;
 }
 async function migrateFile(orm, origin, file, createdAt) {
-  const content = readFileSync30(file, "utf8");
+  const content = readFileSync31(file, "utf8");
   await saveHandover(orm, {
     origin,
     summary: summariseHandoverContent(content),
@@ -12285,7 +12361,7 @@ async function migrateDiskHandovers(orm, origin, cwd = process.cwd()) {
     migrated++;
   }
   const handoverPath = getHandoverPath(cwd);
-  if (existsSync35(handoverPath)) {
+  if (existsSync36(handoverPath)) {
     await migrateFile(orm, origin, handoverPath, statSync5(handoverPath).mtime);
     migrated++;
   }
@@ -12501,7 +12577,7 @@ function acceptanceCriteria(issueKey) {
 import { execSync as execSync30 } from "child_process";
 
 // src/shared/loadJson.ts
-import { existsSync as existsSync36, mkdirSync as mkdirSync13, readFileSync as readFileSync31, writeFileSync as writeFileSync27 } from "fs";
+import { existsSync as existsSync37, mkdirSync as mkdirSync13, readFileSync as readFileSync32, writeFileSync as writeFileSync27 } from "fs";
 import { homedir as homedir15 } from "os";
 import { join as join39 } from "path";
 function getStoreDir() {
@@ -12512,9 +12588,9 @@ function getStorePath(filename) {
 }
 function loadJson(filename) {
   const path57 = getStorePath(filename);
-  if (existsSync36(path57)) {
+  if (existsSync37(path57)) {
     try {
-      return JSON.parse(readFileSync31(path57, "utf8"));
+      return JSON.parse(readFileSync32(path57, "utf8"));
     } catch {
       return {};
     }
@@ -12523,7 +12599,7 @@ function loadJson(filename) {
 }
 function saveJson(filename, data) {
   const dir = getStoreDir();
-  if (!existsSync36(dir)) {
+  if (!existsSync37(dir)) {
     mkdirSync13(dir, { recursive: true });
   }
   writeFileSync27(getStorePath(filename), JSON.stringify(data, null, 2));
@@ -12698,7 +12774,7 @@ import { resolve as resolve11 } from "path";
 import chalk133 from "chalk";
 
 // src/commands/mermaid/exportFile.ts
-import { readFileSync as readFileSync32, writeFileSync as writeFileSync28 } from "fs";
+import { readFileSync as readFileSync33, writeFileSync as writeFileSync28 } from "fs";
 import { basename as basename8, extname, resolve as resolve10 } from "path";
 import chalk132 from "chalk";
 
@@ -12724,7 +12800,7 @@ async function renderBlock(krokiUrl, source) {
 
 // src/commands/mermaid/exportFile.ts
 async function exportFile(file, outDir, krokiUrl, onlyIndex) {
-  const content = readFileSync32(file, "utf8");
+  const content = readFileSync33(file, "utf8");
   const blocks = extractMermaidBlocks(content);
   const stem = basename8(file, extname(file));
   if (onlyIndex !== void 0) {
@@ -13008,7 +13084,7 @@ import { join as join44 } from "path";
 import chalk136 from "chalk";
 
 // src/commands/netcap/extractPostsFromCapture.ts
-import { readFileSync as readFileSync33 } from "fs";
+import { readFileSync as readFileSync34 } from "fs";
 
 // src/commands/netcap/parseRscRows.ts
 var isRscRef = (v) => typeof v === "string" && /^\$[0-9a-fL@]/.test(v);
@@ -13404,7 +13480,7 @@ function extractVoyagerPosts(body) {
 
 // src/commands/netcap/extractPostsFromCapture.ts
 function captureEntries(captureFile) {
-  const lines = readFileSync33(captureFile, "utf8").split("\n").filter(Boolean);
+  const lines = readFileSync34(captureFile, "utf8").split("\n").filter(Boolean);
   const entries = [];
   for (const line of lines) {
     let entry;
@@ -13888,7 +13964,7 @@ import { tmpdir as tmpdir5 } from "os";
 import { join as join46 } from "path";
 
 // src/commands/prs/loadCommentsCache.ts
-import { existsSync as existsSync37, readFileSync as readFileSync34, unlinkSync as unlinkSync11 } from "fs";
+import { existsSync as existsSync38, readFileSync as readFileSync35, unlinkSync as unlinkSync11 } from "fs";
 import { join as join45 } from "path";
 import { parse as parse2 } from "yaml";
 function getCachePath(prNumber) {
@@ -13896,15 +13972,15 @@ function getCachePath(prNumber) {
 }
 function loadCommentsCache(prNumber) {
   const cachePath = getCachePath(prNumber);
-  if (!existsSync37(cachePath)) {
+  if (!existsSync38(cachePath)) {
     return null;
   }
-  const content = readFileSync34(cachePath, "utf8");
+  const content = readFileSync35(cachePath, "utf8");
   return parse2(content);
 }
 function deleteCommentsCache(prNumber) {
   const cachePath = getCachePath(prNumber);
-  if (existsSync37(cachePath)) {
+  if (existsSync38(cachePath)) {
     unlinkSync11(cachePath);
     console.log("No more unresolved line comments. Cache dropped.");
   }
@@ -14004,7 +14080,7 @@ function fixed(commentId, sha) {
 }
 
 // src/commands/prs/listComments/index.ts
-import { existsSync as existsSync38, mkdirSync as mkdirSync15, writeFileSync as writeFileSync32 } from "fs";
+import { existsSync as existsSync39, mkdirSync as mkdirSync15, writeFileSync as writeFileSync32 } from "fs";
 import { join as join48 } from "path";
 import { stringify } from "yaml";
 
@@ -14130,7 +14206,7 @@ function printComments2(result) {
 // src/commands/prs/listComments/index.ts
 function writeCommentsCache(prNumber, comments3) {
   const assistDir = join48(process.cwd(), ".assist");
-  if (!existsSync38(assistDir)) {
+  if (!existsSync39(assistDir)) {
     mkdirSync15(assistDir, { recursive: true });
   }
   const cacheData = {
@@ -14995,17 +15071,17 @@ Refactor check failed:
 
 // src/commands/refactor/check/getViolations/index.ts
 import { execSync as execSync43 } from "child_process";
-import fs21 from "fs";
+import fs22 from "fs";
 import { minimatch as minimatch6 } from "minimatch";
 
 // src/commands/refactor/check/getViolations/getIgnoredFiles.ts
-import fs20 from "fs";
+import fs21 from "fs";
 var REFACTOR_YML_PATH = "refactor.yml";
 function parseRefactorYml() {
-  if (!fs20.existsSync(REFACTOR_YML_PATH)) {
+  if (!fs21.existsSync(REFACTOR_YML_PATH)) {
     return [];
   }
-  const content = fs20.readFileSync(REFACTOR_YML_PATH, "utf8");
+  const content = fs21.readFileSync(REFACTOR_YML_PATH, "utf8");
   const entries = [];
   const lines = content.split("\n");
   let currentEntry = {};
@@ -15035,7 +15111,7 @@ function getIgnoredFiles() {
 
 // src/commands/refactor/check/getViolations/index.ts
 function countLines(filePath) {
-  const content = fs21.readFileSync(filePath, "utf8");
+  const content = fs22.readFileSync(filePath, "utf8");
   return content.split("\n").length;
 }
 function getGitFiles(options2) {
@@ -15769,12 +15845,12 @@ import chalk155 from "chalk";
 import { Project as Project4 } from "ts-morph";
 
 // src/commands/refactor/extract/findTsConfig.ts
-import fs22 from "fs";
+import fs23 from "fs";
 import path33 from "path";
 import { Project as Project3 } from "ts-morph";
 function findTsConfig(sourcePath) {
   const rootConfig = path33.resolve("tsconfig.json");
-  if (!fs22.existsSync(rootConfig)) return rootConfig;
+  if (!fs23.existsSync(rootConfig)) return rootConfig;
   const tried = /* @__PURE__ */ new Set();
   const candidates = [rootConfig, ...readReferences(rootConfig)];
   for (const candidate of candidates) {
@@ -15782,7 +15858,7 @@ function findTsConfig(sourcePath) {
     tried.add(candidate);
     if (projectIncludes(candidate, sourcePath)) return candidate;
   }
-  const siblings = fs22.readdirSync(path33.dirname(rootConfig)).filter((f) => /^tsconfig.*\.json$/.test(f)).map((f) => path33.resolve(path33.dirname(rootConfig), f));
+  const siblings = fs23.readdirSync(path33.dirname(rootConfig)).filter((f) => /^tsconfig.*\.json$/.test(f)).map((f) => path33.resolve(path33.dirname(rootConfig), f));
   for (const sibling of siblings) {
     if (tried.has(sibling)) continue;
     tried.add(sibling);
@@ -15791,8 +15867,8 @@ function findTsConfig(sourcePath) {
   return rootConfig;
 }
 function readReferences(configPath) {
-  if (!fs22.existsSync(configPath)) return [];
-  const raw = fs22.readFileSync(configPath, "utf8");
+  if (!fs23.existsSync(configPath)) return [];
+  const raw = fs23.readFileSync(configPath, "utf8");
   const stripped = raw.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "");
   let parsed;
   try {
@@ -15804,8 +15880,8 @@ function readReferences(configPath) {
   const cwd = path33.dirname(configPath);
   return parsed.references.map((ref) => {
     const refPath = path33.resolve(cwd, ref.path);
-    return fs22.statSync(refPath, { throwIfNoEntry: false })?.isDirectory() ? path33.join(refPath, "tsconfig.json") : refPath;
-  }).filter((p) => fs22.existsSync(p));
+    return fs23.statSync(refPath, { throwIfNoEntry: false })?.isDirectory() ? path33.join(refPath, "tsconfig.json") : refPath;
+  }).filter((p) => fs23.existsSync(p));
 }
 function projectIncludes(configPath, sourcePath) {
   try {
@@ -15855,25 +15931,25 @@ async function extract(file, functionName, destination, options2 = {}) {
 }
 
 // src/commands/refactor/ignore.ts
-import fs23 from "fs";
+import fs24 from "fs";
 import chalk157 from "chalk";
 var REFACTOR_YML_PATH2 = "refactor.yml";
 function ignore(file) {
-  if (!fs23.existsSync(file)) {
+  if (!fs24.existsSync(file)) {
     console.error(chalk157.red(`Error: File does not exist: ${file}`));
     process.exit(1);
   }
-  const content = fs23.readFileSync(file, "utf8");
+  const content = fs24.readFileSync(file, "utf8");
   const lineCount = content.split("\n").length;
   const maxLines = lineCount + 10;
   const entry = `- file: ${file}
   maxLines: ${maxLines}
 `;
-  if (fs23.existsSync(REFACTOR_YML_PATH2)) {
-    const existing = fs23.readFileSync(REFACTOR_YML_PATH2, "utf8");
-    fs23.writeFileSync(REFACTOR_YML_PATH2, existing + entry);
+  if (fs24.existsSync(REFACTOR_YML_PATH2)) {
+    const existing = fs24.readFileSync(REFACTOR_YML_PATH2, "utf8");
+    fs24.writeFileSync(REFACTOR_YML_PATH2, existing + entry);
   } else {
-    fs23.writeFileSync(REFACTOR_YML_PATH2, entry);
+    fs24.writeFileSync(REFACTOR_YML_PATH2, entry);
   }
   console.log(
     chalk157.green(
@@ -15883,12 +15959,12 @@ function ignore(file) {
 }
 
 // src/commands/refactor/rename/index.ts
-import fs26 from "fs";
+import fs27 from "fs";
 import path40 from "path";
 import chalk160 from "chalk";
 
 // src/commands/refactor/rename/applyRename.ts
-import fs25 from "fs";
+import fs26 from "fs";
 import path37 from "path";
 import chalk158 from "chalk";
 
@@ -15896,7 +15972,7 @@ import chalk158 from "chalk";
 import path36 from "path";
 
 // src/commands/refactor/restructure/computeRewrites/applyRewrites.ts
-import fs24 from "fs";
+import fs25 from "fs";
 function getOrCreateList(map, key) {
   const list5 = map.get(key) ?? [];
   if (!map.has(key)) map.set(key, list5);
@@ -15915,7 +15991,7 @@ function rewriteSpecifier(content, oldSpecifier, newSpecifier) {
   return content.replace(pattern2, `$1${newSpecifier}$2`);
 }
 function applyFileRewrites(file, fileRewrites) {
-  let content = fs24.readFileSync(file, "utf8");
+  let content = fs25.readFileSync(file, "utf8");
   for (const { oldSpecifier, newSpecifier } of fileRewrites) {
     content = rewriteSpecifier(content, oldSpecifier, newSpecifier);
   }
@@ -15994,12 +16070,12 @@ function computeRewrites(moves, edges, allProjectFiles) {
 function applyRename(rewrites, sourcePath, destPath, cwd) {
   const updatedContents = applyRewrites(rewrites);
   for (const [file, content] of updatedContents) {
-    fs25.writeFileSync(file, content, "utf8");
+    fs26.writeFileSync(file, content, "utf8");
     console.log(chalk158.cyan(`  Updated imports in ${path37.relative(cwd, file)}`));
   }
   const destDir = path37.dirname(destPath);
-  if (!fs25.existsSync(destDir)) fs25.mkdirSync(destDir, { recursive: true });
-  fs25.renameSync(sourcePath, destPath);
+  if (!fs26.existsSync(destDir)) fs26.mkdirSync(destDir, { recursive: true });
+  fs26.renameSync(sourcePath, destPath);
   console.log(
     chalk158.white(
       `  Moved ${path37.relative(cwd, sourcePath)} \u2192 ${path37.relative(cwd, destPath)}`
@@ -16107,11 +16183,11 @@ async function rename(source, destination, options2 = {}) {
   const cwd = process.cwd();
   const relSource = path40.relative(cwd, sourcePath);
   const relDest = path40.relative(cwd, destPath);
-  if (!fs26.existsSync(sourcePath)) {
+  if (!fs27.existsSync(sourcePath)) {
     console.log(chalk160.red(`File not found: ${source}`));
     process.exit(1);
   }
-  if (destPath !== sourcePath && fs26.existsSync(destPath)) {
+  if (destPath !== sourcePath && fs27.existsSync(destPath)) {
     console.log(chalk160.red(`Destination already exists: ${destination}`));
     process.exit(1);
   }
@@ -16336,27 +16412,27 @@ Summary: ${plan2.moves.length} file(s) moved, ${plan2.rewrites.length} imports r
 }
 
 // src/commands/refactor/restructure/executePlan.ts
-import fs27 from "fs";
+import fs28 from "fs";
 import path45 from "path";
 import chalk163 from "chalk";
 function executePlan(plan2) {
   const updatedContents = applyRewrites(plan2.rewrites);
   for (const [file, content] of updatedContents) {
-    fs27.writeFileSync(file, content, "utf8");
+    fs28.writeFileSync(file, content, "utf8");
     console.log(
       chalk163.cyan(`  Rewrote imports in ${path45.relative(process.cwd(), file)}`)
     );
   }
   for (const dir of plan2.newDirectories) {
-    fs27.mkdirSync(dir, { recursive: true });
+    fs28.mkdirSync(dir, { recursive: true });
     console.log(chalk163.green(`  Created ${path45.relative(process.cwd(), dir)}/`));
   }
   for (const move2 of plan2.moves) {
     const targetDir = path45.dirname(move2.to);
-    if (!fs27.existsSync(targetDir)) {
-      fs27.mkdirSync(targetDir, { recursive: true });
+    if (!fs28.existsSync(targetDir)) {
+      fs28.mkdirSync(targetDir, { recursive: true });
     }
-    fs27.renameSync(move2.from, move2.to);
+    fs28.renameSync(move2.from, move2.to);
     console.log(
       chalk163.white(
         `  Moved ${path45.relative(process.cwd(), move2.from)} \u2192 ${path45.relative(process.cwd(), move2.to)}`
@@ -16368,10 +16444,10 @@ function executePlan(plan2) {
 function removeEmptyDirectories(dirs) {
   const unique = [...new Set(dirs)];
   for (const dir of unique) {
-    if (!fs27.existsSync(dir)) continue;
-    const entries = fs27.readdirSync(dir);
+    if (!fs28.existsSync(dir)) continue;
+    const entries = fs28.readdirSync(dir);
     if (entries.length === 0) {
-      fs27.rmdirSync(dir);
+      fs28.rmdirSync(dir);
       console.log(
         chalk163.dim(
           `  Removed empty directory ${path45.relative(process.cwd(), dir)}`
@@ -16385,18 +16461,18 @@ function removeEmptyDirectories(dirs) {
 import path47 from "path";
 
 // src/commands/refactor/restructure/planFileMoves/shared.ts
-import fs28 from "fs";
+import fs29 from "fs";
 function emptyResult() {
   return { moves: [], directories: [], warnings: [] };
 }
 function checkDirConflict(result, label2, dir) {
-  if (!fs28.existsSync(dir)) return false;
+  if (!fs29.existsSync(dir)) return false;
   result.warnings.push(`Skipping ${label2}: directory ${dir} already exists`);
   return true;
 }
 
 // src/commands/refactor/restructure/planFileMoves/planDirectoryMoves.ts
-import fs29 from "fs";
+import fs30 from "fs";
 import path46 from "path";
 function collectEntry(results, dir, entry) {
   const full = path46.join(dir, entry.name);
@@ -16404,9 +16480,9 @@ function collectEntry(results, dir, entry) {
   results.push(...items2);
 }
 function listFilesRecursive(dir) {
-  if (!fs29.existsSync(dir)) return [];
+  if (!fs30.existsSync(dir)) return [];
   const results = [];
-  for (const entry of fs29.readdirSync(dir, { withFileTypes: true })) {
+  for (const entry of fs30.readdirSync(dir, { withFileTypes: true })) {
     collectEntry(results, dir, entry);
   }
   return results;
@@ -16834,7 +16910,7 @@ function gatherContext() {
 }
 
 // src/commands/review/postReviewToPr.ts
-import { readFileSync as readFileSync35 } from "fs";
+import { readFileSync as readFileSync36 } from "fs";
 
 // src/commands/review/parseFindings.ts
 var SEVERITIES = ["blocker", "major", "minor", "nit"];
@@ -17149,7 +17225,7 @@ async function confirmPost(prNumber, count7, options2) {
 async function postReviewToPr(synthesisPath, options2) {
   const prInfo = fetchPrDiffInfo();
   const prNumber = prInfo.prNumber;
-  const markdown = readFileSync35(synthesisPath, "utf8");
+  const markdown = readFileSync36(synthesisPath, "utf8");
   const findings = parseFindings(markdown);
   if (findings.length === 0) {
     console.log("Synthesis contains no findings; nothing to post.");
@@ -17231,10 +17307,10 @@ async function handlePostSynthesis(synthesisPath, options2) {
 }
 
 // src/commands/review/prepareReviewDir.ts
-import { existsSync as existsSync39, mkdirSync as mkdirSync16, unlinkSync as unlinkSync14, writeFileSync as writeFileSync33 } from "fs";
+import { existsSync as existsSync40, mkdirSync as mkdirSync16, unlinkSync as unlinkSync14, writeFileSync as writeFileSync33 } from "fs";
 function clearReviewFiles(paths) {
   for (const path57 of [paths.claudePath, paths.codexPath, paths.synthesisPath]) {
-    if (existsSync39(path57)) unlinkSync14(path57);
+    if (existsSync40(path57)) unlinkSync14(path57);
   }
 }
 function prepareReviewDir(paths, requestBody, force) {
@@ -17519,7 +17595,7 @@ function printReviewerFailures(results) {
 }
 
 // src/commands/review/runAndSynthesise.ts
-import { existsSync as existsSync41, unlinkSync as unlinkSync16 } from "fs";
+import { existsSync as existsSync42, unlinkSync as unlinkSync16 } from "fs";
 
 // src/commands/review/buildReviewerStdin.ts
 var REVIEW_PROMPT = `You are acting as a reviewer for a proposed code change made by another engineer. The full review request \u2014 branch, base, changed files, and unified diff \u2014 is in the request file whose absolute path is given below.
@@ -17939,7 +18015,7 @@ function resolveClaude(args) {
 }
 
 // src/commands/review/runCodexReviewer.ts
-import { existsSync as existsSync40, unlinkSync as unlinkSync15 } from "fs";
+import { existsSync as existsSync41, unlinkSync as unlinkSync15 } from "fs";
 
 // src/commands/review/parseCodexEvent.ts
 function isItemStarted(value) {
@@ -17991,7 +18067,7 @@ async function runCodexReviewer(spec) {
       reportReviewerToolUse(spec.name, event, spinner);
     }
   });
-  if (result.exitCode !== 0 && existsSync40(spec.outputPath)) {
+  if (result.exitCode !== 0 && existsSync41(spec.outputPath)) {
     unlinkSync15(spec.outputPath);
   }
   return finaliseReviewerRun({ ...spec, command }, spinner, result);
@@ -18033,7 +18109,7 @@ async function runReviewers(reviewDir, claudePath, codexPath, stdinPrompt, optio
 }
 
 // src/commands/review/synthesise.ts
-import { readFileSync as readFileSync36 } from "fs";
+import { readFileSync as readFileSync37 } from "fs";
 
 // src/commands/review/buildSynthesisStdin.ts
 var SYNTHESIS_PROMPT = `You are consolidating two independent code reviews of the same change. The original review request is in request.md. The two reviews are in claude.md and codex.md in the current working directory.
@@ -18089,7 +18165,7 @@ Files:
 
 // src/commands/review/synthesise.ts
 function printSummary2(synthesisPath) {
-  const markdown = readFileSync36(synthesisPath, "utf8");
+  const markdown = readFileSync37(synthesisPath, "utf8");
   console.log("");
   console.log(buildReviewSummary(markdown));
   console.log("");
@@ -18137,7 +18213,7 @@ async function runAndSynthesise(args) {
     console.error("Both reviewers failed; skipping synthesis.");
     return { ok: false, failures };
   }
-  if (anyFresh && existsSync41(paths.synthesisPath)) {
+  if (anyFresh && existsSync42(paths.synthesisPath)) {
     unlinkSync16(paths.synthesisPath);
   }
   const synthesisResult = await synthesise(paths, { multi });
@@ -18987,11 +19063,11 @@ async function configure() {
 }
 
 // src/commands/transcript/list.ts
-import { existsSync as existsSync42, readdirSync as readdirSync9, statSync as statSync7 } from "fs";
+import { existsSync as existsSync43, readdirSync as readdirSync9, statSync as statSync7 } from "fs";
 import { join as join50 } from "path";
 function list4() {
   const { vttDir } = getTranscriptConfig();
-  if (!existsSync42(vttDir)) return;
+  if (!existsSync43(vttDir)) return;
   for (const entry of readdirSync9(vttDir)) {
     if (!entry.endsWith(".vtt")) continue;
     if (statSync7(join50(vttDir, entry)).isDirectory()) continue;
@@ -19001,9 +19077,9 @@ function list4() {
 
 // src/commands/transcript/move.ts
 import {
-  existsSync as existsSync43,
+  existsSync as existsSync44,
   mkdirSync as mkdirSync17,
-  readFileSync as readFileSync37,
+  readFileSync as readFileSync38,
   renameSync as renameSync2,
   writeFileSync as writeFileSync35
 } from "fs";
@@ -19215,7 +19291,7 @@ function formatChatLog(messages) {
 // src/commands/transcript/move.ts
 var DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
 function convertVttToMarkdown(inputPath) {
-  const cues = parseVtt(readFileSync37(inputPath, "utf8"));
+  const cues = parseVtt(readFileSync38(inputPath, "utf8"));
   const messages = cuesToChatMessages(deduplicateCues(cues));
   return formatChatLog(messages);
 }
@@ -19233,7 +19309,7 @@ function move(file, options2) {
   const { vttDir, transcriptsDir, summaryDir } = getTranscriptConfig();
   const filename = basename10(file);
   const sourcePath = join51(vttDir, filename);
-  if (!existsSync43(sourcePath)) {
+  if (!existsSync44(sourcePath)) {
     console.error(`Error: VTT file not found: ${sourcePath}`);
     process.exit(1);
   }
@@ -19328,14 +19404,14 @@ function devices() {
 }
 
 // src/commands/voice/logs.ts
-import { existsSync as existsSync44, readFileSync as readFileSync38 } from "fs";
+import { existsSync as existsSync45, readFileSync as readFileSync39 } from "fs";
 function logs(options2) {
-  if (!existsSync44(voicePaths.log)) {
+  if (!existsSync45(voicePaths.log)) {
     console.log("No voice log file found");
     return;
   }
   const count7 = Number.parseInt(options2.lines ?? "150", 10);
-  const content = readFileSync38(voicePaths.log, "utf8").trim();
+  const content = readFileSync39(voicePaths.log, "utf8").trim();
   if (!content) {
     console.log("Voice log is empty");
     return;
@@ -19362,7 +19438,7 @@ import { join as join55 } from "path";
 
 // src/commands/voice/checkLockFile.ts
 import { execSync as execSync48 } from "child_process";
-import { existsSync as existsSync45, mkdirSync as mkdirSync18, readFileSync as readFileSync39, writeFileSync as writeFileSync36 } from "fs";
+import { existsSync as existsSync46, mkdirSync as mkdirSync18, readFileSync as readFileSync40, writeFileSync as writeFileSync36 } from "fs";
 import { join as join54 } from "path";
 function isProcessAlive2(pid) {
   try {
@@ -19374,9 +19450,9 @@ function isProcessAlive2(pid) {
 }
 function checkLockFile() {
   const lockFile = getLockFile();
-  if (!existsSync45(lockFile)) return;
+  if (!existsSync46(lockFile)) return;
   try {
-    const lock2 = JSON.parse(readFileSync39(lockFile, "utf8"));
+    const lock2 = JSON.parse(readFileSync40(lockFile, "utf8"));
     if (lock2.pid && isProcessAlive2(lock2.pid)) {
       console.error(
         `Voice daemon already running (PID ${lock2.pid}, env: ${lock2.env}). Stop it first with: assist voice stop`
@@ -19387,7 +19463,7 @@ function checkLockFile() {
   }
 }
 function bootstrapVenv() {
-  if (existsSync45(getVenvPython())) return;
+  if (existsSync46(getVenvPython())) return;
   console.log("Setting up Python environment...");
   const pythonDir = getPythonDir();
   execSync48(
@@ -19478,7 +19554,7 @@ function start2(options2) {
 }
 
 // src/commands/voice/status.ts
-import { existsSync as existsSync46, readFileSync as readFileSync40 } from "fs";
+import { existsSync as existsSync47, readFileSync as readFileSync41 } from "fs";
 function isProcessAlive3(pid) {
   try {
     process.kill(pid, 0);
@@ -19488,16 +19564,16 @@ function isProcessAlive3(pid) {
   }
 }
 function readRecentLogs(count7) {
-  if (!existsSync46(voicePaths.log)) return [];
-  const lines = readFileSync40(voicePaths.log, "utf8").trim().split("\n");
+  if (!existsSync47(voicePaths.log)) return [];
+  const lines = readFileSync41(voicePaths.log, "utf8").trim().split("\n");
   return lines.slice(-count7);
 }
 function status() {
-  if (!existsSync46(voicePaths.pid)) {
+  if (!existsSync47(voicePaths.pid)) {
     console.log("Voice daemon: not running (no PID file)");
     return;
   }
-  const pid = Number.parseInt(readFileSync40(voicePaths.pid, "utf8").trim(), 10);
+  const pid = Number.parseInt(readFileSync41(voicePaths.pid, "utf8").trim(), 10);
   const alive = isProcessAlive3(pid);
   console.log(`Voice daemon: ${alive ? "running" : "dead"} (PID ${pid})`);
   const recent = readRecentLogs(5);
@@ -19516,13 +19592,13 @@ function status() {
 }
 
 // src/commands/voice/stop.ts
-import { existsSync as existsSync47, readFileSync as readFileSync41, unlinkSync as unlinkSync17 } from "fs";
+import { existsSync as existsSync48, readFileSync as readFileSync42, unlinkSync as unlinkSync17 } from "fs";
 function stop2() {
-  if (!existsSync47(voicePaths.pid)) {
+  if (!existsSync48(voicePaths.pid)) {
     console.log("Voice daemon is not running (no PID file)");
     return;
   }
-  const pid = Number.parseInt(readFileSync41(voicePaths.pid, "utf8").trim(), 10);
+  const pid = Number.parseInt(readFileSync42(voicePaths.pid, "utf8").trim(), 10);
   try {
     process.kill(pid, "SIGTERM");
     console.log(`Sent SIGTERM to voice daemon (PID ${pid})`);
@@ -19535,7 +19611,7 @@ function stop2() {
   }
   try {
     const lockFile = getLockFile();
-    if (existsSync47(lockFile)) unlinkSync17(lockFile);
+    if (existsSync48(lockFile)) unlinkSync17(lockFile);
   } catch {
   }
   console.log("Voice daemon stopped");
@@ -19713,7 +19789,7 @@ async function auth() {
 
 // src/commands/roam/postRoamActivity.ts
 import { execFileSync as execFileSync7 } from "child_process";
-import { readdirSync as readdirSync10, readFileSync as readFileSync42, statSync as statSync8 } from "fs";
+import { readdirSync as readdirSync10, readFileSync as readFileSync43, statSync as statSync8 } from "fs";
 import { join as join57 } from "path";
 function findPortFile(roamDir) {
   let entries;
@@ -19739,7 +19815,7 @@ function postRoamActivity(app, event) {
   if (!portFile) return;
   let port;
   try {
-    port = readFileSync42(portFile, "utf8").trim();
+    port = readFileSync43(portFile, "utf8").trim();
   } catch {
     return;
   }
@@ -19881,7 +19957,7 @@ function runPreCommands(pre, cwd) {
 
 // src/commands/run/spawnRunCommand.ts
 import { execFileSync as execFileSync8, spawn as spawn8 } from "child_process";
-import { existsSync as existsSync48 } from "fs";
+import { existsSync as existsSync49 } from "fs";
 import { dirname as dirname25, join as join58, resolve as resolve13 } from "path";
 function resolveCommand2(command) {
   if (process.platform !== "win32" || command !== "bash") return command;
@@ -19889,7 +19965,7 @@ function resolveCommand2(command) {
     const gitPath = execFileSync8("where", ["git"], { encoding: "utf8" }).trim().split("\r\n")[0];
     const gitRoot = resolve13(dirname25(gitPath), "..");
     const gitBash = join58(gitRoot, "bin", "bash.exe");
-    if (existsSync48(gitBash)) return gitBash;
+    if (existsSync49(gitBash)) return gitBash;
   } catch {
   }
   return command;
@@ -20100,7 +20176,7 @@ function link2() {
 }
 
 // src/commands/run/remove.ts
-import { existsSync as existsSync49, unlinkSync as unlinkSync18 } from "fs";
+import { existsSync as existsSync50, unlinkSync as unlinkSync18 } from "fs";
 import { join as join60 } from "path";
 function findRemoveIndex() {
   const idx = process.argv.indexOf("remove");
@@ -20117,7 +20193,7 @@ function parseRemoveName() {
 }
 function deleteCommandFile(name) {
   const filePath = join60(".claude", "commands", `${name}.md`);
-  if (existsSync49(filePath)) {
+  if (existsSync50(filePath)) {
     unlinkSync18(filePath);
     console.log(`Deleted command file: ${filePath}`);
   }
@@ -20156,7 +20232,7 @@ function registerRun(program2) {
 
 // src/commands/screenshot/index.ts
 import { execSync as execSync50 } from "child_process";
-import { existsSync as existsSync50, mkdirSync as mkdirSync22, unlinkSync as unlinkSync19, writeFileSync as writeFileSync39 } from "fs";
+import { existsSync as existsSync51, mkdirSync as mkdirSync22, unlinkSync as unlinkSync19, writeFileSync as writeFileSync39 } from "fs";
 import { tmpdir as tmpdir7 } from "os";
 import { join as join61, resolve as resolve15 } from "path";
 import chalk180 from "chalk";
@@ -20288,7 +20364,7 @@ Write-Output $OutputPath
 
 // src/commands/screenshot/index.ts
 function buildOutputPath(outputDir, processName) {
-  if (!existsSync50(outputDir)) {
+  if (!existsSync51(outputDir)) {
     mkdirSync22(outputDir, { recursive: true });
   }
   const timestamp4 = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
@@ -20372,7 +20448,7 @@ function applyLine(result, pending, line) {
 }
 
 // src/commands/sessions/daemon/reportStolenSocket.ts
-import { readFileSync as readFileSync43 } from "fs";
+import { readFileSync as readFileSync44 } from "fs";
 function reportStolenSocket(socketPid) {
   if (!socketPid) return;
   const filePid = readPidFile();
@@ -20384,7 +20460,7 @@ function reportStolenSocket(socketPid) {
 function readPidFile() {
   try {
     const pid = Number.parseInt(
-      readFileSync43(daemonPaths.pid, "utf8").trim(),
+      readFileSync44(daemonPaths.pid, "utf8").trim(),
       10
     );
     return Number.isInteger(pid) ? pid : void 0;
@@ -20738,7 +20814,7 @@ var ClientHub = class extends Set {
 import * as pty from "node-pty";
 
 // src/commands/sessions/daemon/ensureSpawnHelperExecutable.ts
-import { chmodSync, existsSync as existsSync51, statSync as statSync9 } from "fs";
+import { chmodSync, existsSync as existsSync52, statSync as statSync9 } from "fs";
 import { createRequire as createRequire3 } from "module";
 import path49 from "path";
 var require4 = createRequire3(import.meta.url);
@@ -20753,7 +20829,7 @@ function ensureSpawnHelperExecutable() {
     `${process.platform}-${process.arch}`,
     "spawn-helper"
   );
-  if (!existsSync51(helper)) return;
+  if (!existsSync52(helper)) return;
   const mode = statSync9(helper).mode;
   if ((mode & 73) === 0) chmodSync(helper, mode | 493);
 }
@@ -21288,7 +21364,7 @@ function resumeSession(id2, sessionId, cwd, name) {
 }
 
 // src/commands/sessions/daemon/watchActivity.ts
-import { existsSync as existsSync52, mkdirSync as mkdirSync23, watch } from "fs";
+import { existsSync as existsSync53, mkdirSync as mkdirSync23, watch } from "fs";
 import { dirname as dirname26 } from "path";
 
 // src/commands/sessions/daemon/applyReviewPause.ts
@@ -21367,7 +21443,7 @@ function watchActivity(session, notify2) {
     if (timer) clearTimeout(timer);
     timer = setTimeout(read, DEBOUNCE_MS);
   });
-  if (existsSync52(path57)) read();
+  if (existsSync53(path57)) read();
 }
 function refreshActivity(session) {
   if (session.commandType !== "assist" || !session.cwd) return;
@@ -22246,12 +22322,12 @@ import * as net3 from "net";
 import { createInterface as createInterface9 } from "readline";
 
 // src/commands/sessions/shared/discoverSessions.ts
-import * as fs31 from "fs";
+import * as fs32 from "fs";
 import * as os from "os";
 import * as path51 from "path";
 
 // src/commands/sessions/shared/parseSessionFile.ts
-import * as fs30 from "fs";
+import * as fs31 from "fs";
 import * as path50 from "path";
 
 // src/commands/sessions/shared/deriveHistoryFields.ts
@@ -22349,10 +22425,10 @@ function matchMarker(text7, tag) {
 async function parseSessionFile(filePath, origin = "wsl") {
   let handle;
   try {
-    handle = await fs30.promises.open(filePath, "r");
+    handle = await fs31.promises.open(filePath, "r");
     const meta = extractSessionMeta(await readHeadLines(handle));
     if (!meta.sessionId) return null;
-    const timestamp4 = meta.timestamp || (await fs30.promises.stat(filePath)).mtime.toISOString();
+    const timestamp4 = meta.timestamp || (await fs31.promises.stat(filePath)).mtime.toISOString();
     return {
       sessionId: meta.sessionId,
       name: meta.name || `Session ${meta.sessionId.slice(0, 8)}`,
@@ -22398,7 +22474,7 @@ async function discoverSessionJsonlPaths() {
     sessionRoots().map(async ({ dir, origin }) => {
       let projectDirs;
       try {
-        projectDirs = await fs31.promises.readdir(dir);
+        projectDirs = await fs32.promises.readdir(dir);
       } catch {
         return;
       }
@@ -22407,7 +22483,7 @@ async function discoverSessionJsonlPaths() {
           const dirPath = path51.join(dir, dirName);
           let entries;
           try {
-            entries = await fs31.promises.readdir(dirPath);
+            entries = await fs32.promises.readdir(dirPath);
           } catch {
             return;
           }
@@ -22440,7 +22516,7 @@ async function discoverSessions() {
 }
 
 // src/commands/sessions/shared/parseTranscript.ts
-import * as fs32 from "fs";
+import * as fs33 from "fs";
 
 // src/commands/sessions/shared/toolTarget.ts
 function toolTarget(input) {
@@ -22507,7 +22583,7 @@ async function parseTranscript(sessionId) {
   const filePath = await findSessionJsonlPath(sessionId);
   if (!filePath) return [];
   try {
-    const raw = await fs32.promises.readFile(filePath, "utf8");
+    const raw = await fs33.promises.readFile(filePath, "utf8");
     return parseTranscriptLines(raw.split("\n"));
   } catch {
     return [];
@@ -22674,7 +22750,7 @@ function handleConnection(socket, manager) {
 import { unlinkSync as unlinkSync20, writeFileSync as writeFileSync40 } from "fs";
 
 // src/commands/sessions/daemon/startPidFileWatchdog.ts
-import { readFileSync as readFileSync44 } from "fs";
+import { readFileSync as readFileSync45 } from "fs";
 var WATCHDOG_INTERVAL_MS = 5e3;
 function startPidFileWatchdog(onLost, intervalMs = WATCHDOG_INTERVAL_MS) {
   const timer = setInterval(() => {
@@ -22685,7 +22761,7 @@ function startPidFileWatchdog(onLost, intervalMs = WATCHDOG_INTERVAL_MS) {
 }
 function ownsPidFile() {
   try {
-    return readFileSync44(daemonPaths.pid, "utf8").trim() === String(process.pid);
+    return readFileSync45(daemonPaths.pid, "utf8").trim() === String(process.pid);
   } catch {
     return false;
   }
@@ -22812,17 +22888,17 @@ function registerDaemon(program2) {
 }
 
 // src/commands/sessions/summarise/index.ts
-import * as fs35 from "fs";
+import * as fs36 from "fs";
 import chalk181 from "chalk";
 
 // src/commands/sessions/summarise/shared.ts
-import * as fs33 from "fs";
+import * as fs34 from "fs";
 function writeSummary(jsonlPath2, summary) {
-  fs33.writeFileSync(summaryPathFor(jsonlPath2), `${summary.trim()}
+  fs34.writeFileSync(summaryPathFor(jsonlPath2), `${summary.trim()}
 `, "utf8");
 }
 function hasSummary(jsonlPath2) {
-  return fs33.existsSync(summaryPathFor(jsonlPath2));
+  return fs34.existsSync(summaryPathFor(jsonlPath2));
 }
 function summaryPathFor(jsonlPath2) {
   return jsonlPath2.replace(/\.jsonl$/, ".summary");
@@ -22832,7 +22908,7 @@ function summaryPathFor(jsonlPath2) {
 import { execFileSync as execFileSync10 } from "child_process";
 
 // src/commands/sessions/summarise/iterateUserMessages.ts
-import * as fs34 from "fs";
+import * as fs35 from "fs";
 
 // src/commands/sessions/summarise/parseUserLine.ts
 function parseUserLine(line) {
@@ -22863,13 +22939,13 @@ function parseUserLine(line) {
 function* iterateUserMessages(filePath, maxBytes = 65536) {
   let content;
   try {
-    const fd = fs34.openSync(filePath, "r");
+    const fd = fs35.openSync(filePath, "r");
     try {
       const buf = Buffer.alloc(maxBytes);
-      const bytesRead = fs34.readSync(fd, buf, 0, buf.length, 0);
+      const bytesRead = fs35.readSync(fd, buf, 0, buf.length, 0);
       content = buf.toString("utf8", 0, bytesRead);
     } finally {
-      fs34.closeSync(fd);
+      fs35.closeSync(fd);
     }
   } catch {
     return;
@@ -22989,7 +23065,7 @@ function selectCandidates(files, options2) {
   const candidates = options2.force ? files : files.filter((f) => !hasSummary(f));
   candidates.sort((a, b) => {
     try {
-      return fs35.statSync(b).mtimeMs - fs35.statSync(a).mtimeMs;
+      return fs36.statSync(b).mtimeMs - fs36.statSync(a).mtimeMs;
     } catch {
       return 0;
     }
@@ -23138,21 +23214,21 @@ async function statusLine() {
 }
 
 // src/commands/sync.ts
-import * as fs38 from "fs";
+import * as fs39 from "fs";
 import * as os2 from "os";
 import * as path55 from "path";
 import { fileURLToPath as fileURLToPath7 } from "url";
 
 // src/commands/sync/syncClaudeMd.ts
-import * as fs36 from "fs";
+import * as fs37 from "fs";
 import * as path53 from "path";
 import chalk184 from "chalk";
 async function syncClaudeMd(claudeDir, targetBase, options2) {
   const source = path53.join(claudeDir, "CLAUDE.md");
   const target = path53.join(targetBase, "CLAUDE.md");
-  const sourceContent = fs36.readFileSync(source, "utf8");
-  if (fs36.existsSync(target)) {
-    const targetContent = fs36.readFileSync(target, "utf8");
+  const sourceContent = fs37.readFileSync(source, "utf8");
+  if (fs37.existsSync(target)) {
+    const targetContent = fs37.readFileSync(target, "utf8");
     if (sourceContent !== targetContent) {
       console.log(
         chalk184.yellow("\n\u26A0\uFE0F  Warning: CLAUDE.md differs from existing file")
@@ -23169,21 +23245,21 @@ async function syncClaudeMd(claudeDir, targetBase, options2) {
       }
     }
   }
-  fs36.copyFileSync(source, target);
+  fs37.copyFileSync(source, target);
   console.log("Copied CLAUDE.md to ~/.claude/CLAUDE.md");
 }
 
 // src/commands/sync/syncSettings.ts
-import * as fs37 from "fs";
+import * as fs38 from "fs";
 import * as path54 from "path";
 import chalk185 from "chalk";
 async function syncSettings(claudeDir, targetBase, options2) {
   const source = path54.join(claudeDir, "settings.json");
   const target = path54.join(targetBase, "settings.json");
-  const sourceContent = fs37.readFileSync(source, "utf8");
+  const sourceContent = fs38.readFileSync(source, "utf8");
   const mergedContent = JSON.stringify(JSON.parse(sourceContent), null, "	");
-  if (fs37.existsSync(target)) {
-    const targetContent = fs37.readFileSync(target, "utf8");
+  if (fs38.existsSync(target)) {
+    const targetContent = fs38.readFileSync(target, "utf8");
     const normalizedTarget = JSON.stringify(
       JSON.parse(targetContent),
       null,
@@ -23209,7 +23285,7 @@ async function syncSettings(claudeDir, targetBase, options2) {
       }
     }
   }
-  fs37.writeFileSync(target, mergedContent);
+  fs38.writeFileSync(target, mergedContent);
   console.log("Copied settings.json to ~/.claude/settings.json");
 }
 
@@ -23228,10 +23304,10 @@ async function sync(options2) {
 function syncCommands(claudeDir, targetBase) {
   const sourceDir = path55.join(claudeDir, "commands");
   const targetDir = path55.join(targetBase, "commands");
-  fs38.mkdirSync(targetDir, { recursive: true });
-  const files = fs38.readdirSync(sourceDir);
+  fs39.mkdirSync(targetDir, { recursive: true });
+  const files = fs39.readdirSync(sourceDir);
   for (const file of files) {
-    fs38.copyFileSync(path55.join(sourceDir, file), path55.join(targetDir, file));
+    fs39.copyFileSync(path55.join(sourceDir, file), path55.join(targetDir, file));
     console.log(`Copied ${file} to ${targetDir}`);
   }
   console.log(`Synced ${files.length} command(s) to ~/.claude/commands`);