@staff0rd/assist 0.36.1 → 0.38.0

package/claude/CLAUDE.md

@@ -0,0 +1,3 @@
+After any code change, run `/verify` to ensure all checks pass.
+
+The tool is invoked using the `assist` command and is installed globally.

package/dist/index.js

@@ -7,7 +7,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.36.1",
+  version: "0.38.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -560,27 +560,28 @@ async function maintainability(pattern2 = "**/*.ts", options = {}) {
       }
     });
     const results = [];
-    let hasViolation = false;
+    const { threshold } = options;
     for (const [file, metrics] of fileMetrics) {
       if (metrics.functions.length === 0) continue;
       const avgMaintainability = metrics.functions.reduce((a, b) => a + b, 0) / metrics.functions.length;
       const minMaintainability = Math.min(...metrics.functions);
       results.push({ file, avgMaintainability, minMaintainability });
-      if (options.threshold !== void 0 && minMaintainability < options.threshold) {
-        hasViolation = true;
-      }
     }
     results.sort((a, b) => a.minMaintainability - b.minMaintainability);
-    for (const { file, avgMaintainability, minMaintainability } of results) {
-      const exceedsThreshold = options.threshold !== void 0 && minMaintainability < options.threshold;
-      const color = exceedsThreshold ? chalk5.red : chalk5.white;
-      console.log(
-        `${color(file)} \u2192 avg: ${chalk5.cyan(avgMaintainability.toFixed(1))}, min: ${chalk5.yellow(minMaintainability.toFixed(1))}`
-      );
+    const filtered = threshold !== void 0 ? results.filter((r) => r.minMaintainability < threshold) : results;
+    if (threshold !== void 0 && filtered.length === 0) {
+      console.log(chalk5.green("All files pass maintainability threshold"));
+    } else {
+      for (const { file, avgMaintainability, minMaintainability } of filtered) {
+        const color = threshold !== void 0 ? chalk5.red : chalk5.white;
+        console.log(
+          `${color(file)} \u2192 avg: ${chalk5.cyan(avgMaintainability.toFixed(1))}, min: ${chalk5.yellow(minMaintainability.toFixed(1))}`
+        );
+      }
     }
     console.log(chalk5.dim(`
 Analyzed ${results.length} files`));
-    if (hasViolation) {
+    if (filtered.length > 0 && threshold !== void 0) {
       process.exit(1);
     }
   });
@@ -621,8 +622,8 @@ Total: ${total} lines across ${files.length} files`)
 // src/commands/config/index.ts
 import chalk7 from "chalk";
 import { stringify as stringifyYaml2 } from "yaml";
-function getNestedValue(obj, path18) {
-  const keys = path18.split(".");
+function getNestedValue(obj, path19) {
+  const keys = path19.split(".");
   let current = obj;
   for (const key of keys) {
     if (current === null || current === void 0 || typeof current !== "object") {
@@ -632,8 +633,8 @@ function getNestedValue(obj, path18) {
   }
   return current;
 }
-function setNestedValue(obj, path18, value) {
-  const keys = path18.split(".");
+function setNestedValue(obj, path19, value) {
+  const keys = path19.split(".");
   const result = { ...obj };
   let current = result;
   for (let i = 0; i < keys.length - 1; i++) {
@@ -660,8 +661,8 @@ function configSet(key, value) {
   const result = assistConfigSchema.safeParse(updated);
   if (!result.success) {
     for (const issue of result.error.issues) {
-      const path18 = issue.path.length > 0 ? issue.path.join(".") : key;
-      console.error(chalk7.red(`${path18}: ${issue.message}`));
+      const path19 = issue.path.length > 0 ? issue.path.join(".") : key;
+      console.error(chalk7.red(`${path19}: ${issue.message}`));
     }
     process.exit(1);
   }
@@ -2949,31 +2950,61 @@ async function statusLine() {
 }
 
 // src/commands/sync.ts
-import * as fs17 from "fs";
+import * as fs18 from "fs";
 import * as os from "os";
-import * as path16 from "path";
+import * as path17 from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 
-// src/commands/sync/syncSettings.ts
+// src/commands/sync/syncClaudeMd.ts
 import * as fs16 from "fs";
 import * as path15 from "path";
 import chalk35 from "chalk";
-async function syncSettings(claudeDir, targetBase) {
-  const source = path15.join(claudeDir, "settings.json");
-  const target = path15.join(targetBase, "settings.json");
+async function syncClaudeMd(claudeDir, targetBase) {
+  const source = path15.join(claudeDir, "CLAUDE.md");
+  const target = path15.join(targetBase, "CLAUDE.md");
   const sourceContent = fs16.readFileSync(source, "utf-8");
-  const normalizedSource = JSON.stringify(JSON.parse(sourceContent), null, 2);
   if (fs16.existsSync(target)) {
     const targetContent = fs16.readFileSync(target, "utf-8");
+    if (sourceContent !== targetContent) {
+      console.log(
+        chalk35.yellow("\n\u26A0\uFE0F  Warning: CLAUDE.md differs from existing file")
+      );
+      console.log();
+      printDiff(targetContent, sourceContent);
+      const confirm = await promptConfirm(
+        chalk35.red("Overwrite existing CLAUDE.md?"),
+        false
+      );
+      if (!confirm) {
+        console.log("Skipped CLAUDE.md");
+        return;
+      }
+    }
+  }
+  fs16.copyFileSync(source, target);
+  console.log("Copied CLAUDE.md to ~/.claude/CLAUDE.md");
+}
+
+// src/commands/sync/syncSettings.ts
+import * as fs17 from "fs";
+import * as path16 from "path";
+import chalk36 from "chalk";
+async function syncSettings(claudeDir, targetBase) {
+  const source = path16.join(claudeDir, "settings.json");
+  const target = path16.join(targetBase, "settings.json");
+  const sourceContent = fs17.readFileSync(source, "utf-8");
+  const normalizedSource = JSON.stringify(JSON.parse(sourceContent), null, 2);
+  if (fs17.existsSync(target)) {
+    const targetContent = fs17.readFileSync(target, "utf-8");
     const normalizedTarget = JSON.stringify(JSON.parse(targetContent), null, 2);
     if (normalizedSource !== normalizedTarget) {
       console.log(
-        chalk35.yellow("\n\u26A0\uFE0F  Warning: settings.json differs from existing file")
+        chalk36.yellow("\n\u26A0\uFE0F  Warning: settings.json differs from existing file")
       );
       console.log();
       printDiff(targetContent, sourceContent);
       const confirm = await promptConfirm(
-        chalk35.red("Overwrite existing settings.json?"),
+        chalk36.red("Overwrite existing settings.json?"),
         false
       );
       if (!confirm) {
@@ -2982,34 +3013,35 @@ async function syncSettings(claudeDir, targetBase) {
       }
     }
   }
-  fs16.copyFileSync(source, target);
+  fs17.copyFileSync(source, target);
   console.log("Copied settings.json to ~/.claude/settings.json");
 }
 
 // src/commands/sync.ts
 var __filename2 = fileURLToPath3(import.meta.url);
-var __dirname4 = path16.dirname(__filename2);
+var __dirname4 = path17.dirname(__filename2);
 async function sync() {
-  const claudeDir = path16.join(__dirname4, "..", "claude");
-  const targetBase = path16.join(os.homedir(), ".claude");
+  const claudeDir = path17.join(__dirname4, "..", "claude");
+  const targetBase = path17.join(os.homedir(), ".claude");
   syncCommands(claudeDir, targetBase);
   await syncSettings(claudeDir, targetBase);
+  await syncClaudeMd(claudeDir, targetBase);
 }
 function syncCommands(claudeDir, targetBase) {
-  const sourceDir = path16.join(claudeDir, "commands");
-  const targetDir = path16.join(targetBase, "commands");
-  fs17.mkdirSync(targetDir, { recursive: true });
-  const files = fs17.readdirSync(sourceDir);
+  const sourceDir = path17.join(claudeDir, "commands");
+  const targetDir = path17.join(targetBase, "commands");
+  fs18.mkdirSync(targetDir, { recursive: true });
+  const files = fs18.readdirSync(sourceDir);
   for (const file of files) {
-    fs17.copyFileSync(path16.join(sourceDir, file), path16.join(targetDir, file));
+    fs18.copyFileSync(path17.join(sourceDir, file), path17.join(targetDir, file));
     console.log(`Copied ${file} to ${targetDir}`);
   }
   console.log(`Synced ${files.length} command(s) to ~/.claude/commands`);
 }
 
 // src/commands/transcript/shared.ts
-import { existsSync as existsSync14, readdirSync as readdirSync3, statSync } from "fs";
-import { basename as basename3, join as join13, relative } from "path";
+import { existsSync as existsSync15, readdirSync as readdirSync3, statSync } from "fs";
+import { basename as basename3, join as join14, relative } from "path";
 import * as readline2 from "readline";
 var DATE_PREFIX_REGEX = /^\d{4}-\d{2}-\d{2}/;
 function getDatePrefix(daysOffset = 0) {
@@ -3024,13 +3056,13 @@ function isValidDatePrefix(filename) {
   return DATE_PREFIX_REGEX.test(filename);
 }
 function findFilesRecursive(dir, baseDir, extension, createEntry) {
-  if (!existsSync14(dir)) {
+  if (!existsSync15(dir)) {
     return [];
   }
   const results = [];
   const entries = readdirSync3(dir);
   for (const entry of entries) {
-    const fullPath = join13(dir, entry);
+    const fullPath = join14(dir, entry);
     const stat = statSync(fullPath);
     if (stat.isDirectory()) {
       results.push(
@@ -3120,8 +3152,8 @@ async function configure() {
 }
 
 // src/commands/transcript/format.ts
-import { existsSync as existsSync15, mkdirSync as mkdirSync5, readFileSync as readFileSync13, writeFileSync as writeFileSync11 } from "fs";
-import { basename as basename4, dirname as dirname11, join as join15 } from "path";
+import { existsSync as existsSync16, mkdirSync as mkdirSync5, readFileSync as readFileSync14, writeFileSync as writeFileSync11 } from "fs";
+import { basename as basename4, dirname as dirname11, join as join16 } from "path";
 
 // src/commands/transcript/parseVtt.ts
 function parseTimestamp(ts2) {
@@ -3283,7 +3315,7 @@ function formatChatLog(messages) {
 
 // src/commands/transcript/promptForDateFix.ts
 import { renameSync } from "fs";
-import { join as join14 } from "path";
+import { join as join15 } from "path";
 async function promptForDateFix(vttFile, vttDir) {
   const rl = createReadlineInterface();
   console.log(
@@ -3324,8 +3356,8 @@ Error: File "${vttFile}" does not start with YYYY-MM-DD format.`
     rl.close();
     if (newPrefix) {
       const newFilename = `${newPrefix}.${vttFile}`;
-      const oldPath = join14(vttDir, vttFile);
-      const newPath = join14(vttDir, newFilename);
+      const oldPath = join15(vttDir, vttFile);
+      const newPath = join15(vttDir, newFilename);
       renameSync(oldPath, newPath);
       console.log(`Renamed to: ${newFilename}`);
       return newFilename;
@@ -3340,7 +3372,7 @@ Error: File "${vttFile}" does not start with YYYY-MM-DD format.`
 // src/commands/transcript/format.ts
 function processFile(inputPath, outputPath) {
   console.log(`Reading: ${inputPath}`);
-  const content = readFileSync13(inputPath, "utf-8");
+  const content = readFileSync14(inputPath, "utf-8");
   const cues = parseVtt(content);
   console.log(`Parsed ${cues.length} cues`);
   const dedupedCues = deduplicateCues(cues);
@@ -3357,11 +3389,11 @@ function processFile(inputPath, outputPath) {
 }
 async function format() {
   const { vttDir, transcriptsDir } = getTranscriptConfig();
-  if (!existsSync15(vttDir)) {
+  if (!existsSync16(vttDir)) {
     console.error(`VTT directory not found: ${vttDir}`);
     process.exit(1);
   }
-  if (!existsSync15(transcriptsDir)) {
+  if (!existsSync16(transcriptsDir)) {
     mkdirSync5(transcriptsDir, { recursive: true });
     console.log(`Created output directory: ${transcriptsDir}`);
   }
@@ -3378,12 +3410,12 @@ async function format() {
       const vttFileDir = dirname11(vttFile.absolutePath);
       const newFilename = await promptForDateFix(vttFile.filename, vttFileDir);
       if (newFilename) {
-        const newRelativePath = join15(
+        const newRelativePath = join16(
           dirname11(vttFile.relativePath),
           newFilename
         );
         vttFiles[i] = {
-          absolutePath: join15(vttFileDir, newFilename),
+          absolutePath: join16(vttFileDir, newFilename),
           relativePath: newRelativePath,
           filename: newFilename
         };
@@ -3400,14 +3432,14 @@ async function format() {
     baseName = baseName.replace(/\s*Transcription\s*/g, " ").trim();
     const mdFile = `${baseName}.md`;
     const relativeDir = dirname11(vttFile.relativePath);
-    const outputDir = relativeDir === "." ? transcriptsDir : join15(transcriptsDir, relativeDir);
-    const outputPath = join15(outputDir, mdFile);
-    if (!existsSync15(outputDir)) {
+    const outputDir = relativeDir === "." ? transcriptsDir : join16(transcriptsDir, relativeDir);
+    const outputPath = join16(outputDir, mdFile);
+    if (!existsSync16(outputDir)) {
       mkdirSync5(outputDir, { recursive: true });
       console.log(`Created output directory: ${outputDir}`);
     }
-    if (existsSync15(outputPath)) {
-      console.log(`Skipping (already exists): ${join15(relativeDir, mdFile)}`);
+    if (existsSync16(outputPath)) {
+      console.log(`Skipping (already exists): ${join16(relativeDir, mdFile)}`);
       skipped++;
       continue;
     }
@@ -3420,18 +3452,18 @@ Summary: ${processed} processed, ${skipped} skipped`);
 
 // src/commands/transcript/summarise.ts
 import {
-  existsSync as existsSync16,
+  existsSync as existsSync17,
   mkdirSync as mkdirSync6,
-  readFileSync as readFileSync14,
+  readFileSync as readFileSync15,
   renameSync as renameSync2,
   rmSync
 } from "fs";
-import { basename as basename5, dirname as dirname12, join as join16, relative as relative2 } from "path";
-import chalk36 from "chalk";
-var STAGING_DIR = join16(process.cwd(), ".assist", "transcript");
+import { basename as basename5, dirname as dirname12, join as join17, relative as relative2 } from "path";
+import chalk37 from "chalk";
+var STAGING_DIR = join17(process.cwd(), ".assist", "transcript");
 var FULL_TRANSCRIPT_REGEX = /^\[Full Transcript\]\(([^)]+)\)/;
 function processStagedFile() {
-  if (!existsSync16(STAGING_DIR)) {
+  if (!existsSync17(STAGING_DIR)) {
     return false;
   }
   const stagedFiles = findMdFilesRecursive(STAGING_DIR);
@@ -3440,12 +3472,12 @@ function processStagedFile() {
   }
   const { transcriptsDir, summaryDir } = getTranscriptConfig();
   const stagedFile = stagedFiles[0];
-  const content = readFileSync14(stagedFile.absolutePath, "utf-8");
+  const content = readFileSync15(stagedFile.absolutePath, "utf-8");
   const firstLine = content.split("\n")[0];
   const match = firstLine.match(FULL_TRANSCRIPT_REGEX);
   if (!match) {
     console.error(
-      chalk36.red(
+      chalk37.red(
         `Staged file ${stagedFile.filename} missing [Full Transcript](<path>) link on first line.`
       )
     );
@@ -3454,7 +3486,7 @@ function processStagedFile() {
   const contentAfterLink = content.slice(firstLine.length).trim();
   if (!contentAfterLink) {
     console.error(
-      chalk36.red(
+      chalk37.red(
         `Staged file ${stagedFile.filename} has no summary content after the transcript link.`
       )
     );
@@ -3467,16 +3499,16 @@ function processStagedFile() {
   );
   if (!matchingTranscript) {
     console.error(
-      chalk36.red(
+      chalk37.red(
         `No transcript found matching staged file: ${stagedFile.filename}`
       )
     );
     process.exit(1);
   }
   const relativePath = matchingTranscript.relativePath;
-  const destPath = join16(summaryDir, relativePath);
+  const destPath = join17(summaryDir, relativePath);
   const destDir = dirname12(destPath);
-  if (!existsSync16(destDir)) {
+  if (!existsSync17(destDir)) {
     mkdirSync6(destDir, { recursive: true });
   }
   renameSync2(stagedFile.absolutePath, destPath);
@@ -3489,7 +3521,7 @@ function processStagedFile() {
 function summarise() {
   processStagedFile();
   const { transcriptsDir, summaryDir } = getTranscriptConfig();
-  if (!existsSync16(transcriptsDir)) {
+  if (!existsSync17(transcriptsDir)) {
     console.log("No transcripts directory found.");
     return;
   }
@@ -3503,14 +3535,14 @@ function summarise() {
     summaryFiles.map((f) => {
       const relDir = dirname12(f.relativePath);
       const baseName = basename5(f.filename, ".md");
-      return relDir === "." ? baseName : join16(relDir, baseName);
+      return relDir === "." ? baseName : join17(relDir, baseName);
     })
   );
   const missing = [];
   for (const transcript of transcriptFiles) {
     const transcriptBaseName = getTranscriptBaseName(transcript.filename);
     const relDir = dirname12(transcript.relativePath);
-    const fullKey = relDir === "." ? transcriptBaseName : join16(relDir, transcriptBaseName);
+    const fullKey = relDir === "." ? transcriptBaseName : join17(relDir, transcriptBaseName);
     if (!summaryRelativePaths.has(fullKey)) {
       missing.push(transcript);
     }
@@ -3521,8 +3553,8 @@ function summarise() {
   }
   const next2 = missing[0];
   const outputFilename = `${getTranscriptBaseName(next2.filename)}.md`;
-  const outputPath = join16(STAGING_DIR, outputFilename);
-  const summaryFileDir = join16(summaryDir, dirname12(next2.relativePath));
+  const outputPath = join17(STAGING_DIR, outputFilename);
+  const summaryFileDir = join17(summaryDir, dirname12(next2.relativePath));
   const relativeTranscriptPath = encodeURI(
     relative2(summaryFileDir, next2.absolutePath).replace(/\\/g, "/")
   );
@@ -3573,7 +3605,7 @@ Total: ${lines.length} hardcoded color(s)`);
 
 // src/commands/verify/run.ts
 import { spawn as spawn4 } from "child_process";
-import * as path17 from "path";
+import * as path18 from "path";
 function formatDuration(ms) {
   if (ms < 1e3) {
     return `${ms}ms`;
@@ -3603,7 +3635,7 @@ async function run2(options = {}) {
     return;
   }
   const { packageJsonPath, verifyScripts } = result;
-  const packageDir = path17.dirname(packageJsonPath);
+  const packageDir = path18.dirname(packageJsonPath);
   console.log(`Running ${verifyScripts.length} verify script(s) in parallel:`);
   for (const script of verifyScripts) {
     console.log(`  - ${script}`);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@staff0rd/assist",
-	"version": "0.36.1",
+	"version": "0.38.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {