@staff0rd/assist 0.84.0 → 0.85.1

package/dist/commands/voice/python/CLAUDE.md

@@ -0,0 +1,10 @@
+Never use `pip install` directly. All Python dependency management uses `uv`.
+
+**The venv MUST live in `~/.assist/voice/.venv`, NEVER in this directory or anywhere in the repo.**
+
+Every `uv` command that touches this project MUST set `UV_PROJECT_ENVIRONMENT` to point to the home dir venv. This includes `uv sync`, `uv run`, and any other uv command. There must be no `.venv/`, `__pycache__/`, `*.egg-info/`, or any other generated artifacts in this directory.
+
+- Dependencies are declared in `pyproject.toml`
+- Bootstrap uses `uv sync --project <dir> --no-install-project` with `UV_PROJECT_ENVIRONMENT=~/.assist/voice/.venv`
+- To add a dependency: edit `pyproject.toml`, then run `UV_PROJECT_ENVIRONMENT=~/.assist/voice/.venv uv lock --project src/commands/voice/python`
+- No build system — this is a virtual project, not an installable package

package/dist/commands/voice/python/voice_daemon.py

@@ -185,20 +185,62 @@ class VoiceDaemon:
         return process_name in self._submit_windows
 
     def _update_typed_text(self, new_text: str) -> None:
-        """Diff old typed text vs new, backspace + type the difference."""
+        """Diff old typed text vs new at word level, minimising deletions.
+
+        Only deletes back to the first word that changed; appends everything
+        after the common word prefix.  This avoids the jarring full-delete
+        that character-level diffing causes when earlier words shift slightly.
+        """
         old = self._typed_text
-        # Find common prefix
-        common = 0
-        for a, b in zip(old, new_text):
+        if old == new_text:
+            return
+
+        old_words = old.split()
+        new_words = new_text.split()
+
+        # Find the longest common word prefix
+        common_words = 0
+        for a, b in zip(old_words, new_words):
             if a == b:
-                common += 1
+                common_words += 1
             else:
                 break
-        # Backspace what's wrong, type new suffix
-        to_delete = len(old) - common
-        to_type = new_text[common:]
+
+        # Character position where the common word prefix ends (including
+        # the trailing space after the last common word, if any).
+        if common_words == 0:
+            keep_chars = 0
+        else:
+            # Rejoin the common words and add one space (the separator before
+            # the next word that was already typed).
+            keep = " ".join(old_words[:common_words])
+            # Only count the trailing space if there were more old words after
+            # the common prefix (meaning that space is already on screen).
+            if common_words < len(old_words):
+                keep_chars = len(keep) + 1  # +1 for the space
+            else:
+                keep_chars = len(keep)
+
+        to_delete = len(old) - keep_chars
         if to_delete > 0:
             keyboard.backspace(to_delete)
+
+        # Build the new suffix to type from the first divergent word onward
+        if common_words == 0:
+            to_type = new_text
+        else:
+            suffix = " ".join(new_words[common_words:])
+            if suffix:
+                # Need a space separator if we kept text and are appending
+                if keep_chars > 0 and common_words < len(old_words):
+                    to_type = suffix
+                elif keep_chars > 0:
+                    to_type = " " + suffix
+                else:
+                    to_type = suffix
+            else:
+                to_type = ""
+
         if to_type:
             keyboard.type_text(to_type)
         self._typed_text = new_text

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.84.0",
+  version: "0.85.1",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -459,6 +459,7 @@ var expectedScripts = {
   "verify:duplicate-code": "jscpd --format 'typescript,tsx' --exitCode 1 --ignore '**/*.test.*' -r consoleFull src",
   "verify:test": "vitest run --reporter=dot --silent",
   "verify:hardcoded-colors": "assist verify hardcoded-colors",
+  "verify:no-venv": "assist verify no-venv",
   "verify:maintainability": "assist complexity maintainability ./src --threshold 60"
 };
 
@@ -1348,7 +1349,7 @@ function lint() {
 }
 
 // src/commands/new/registerNew/newCli/index.ts
-import { execSync as execSync9 } from "child_process";
+import { execSync as execSync10 } from "child_process";
 import { basename as basename2, resolve } from "path";
 
 // src/commands/verify/hardcodedColors.ts
@@ -1439,6 +1440,38 @@ function list() {
   }
 }
 
+// src/commands/verify/noVenv.ts
+import { execSync as execSync6 } from "child_process";
+function noVenv() {
+  try {
+    const output = execSync6(
+      "find . -type d -name venv -not -path '*/node_modules/*'",
+      {
+        encoding: "utf-8"
+      }
+    ).trim();
+    if (output.length === 0) {
+      console.log("No venv folders found.");
+      process.exit(0);
+    }
+    const folders = output.split("\n");
+    console.log("venv folders found:\n");
+    for (const folder of folders) {
+      console.log(`  ${folder}`);
+    }
+    console.log(`
+Total: ${folders.length} venv folder(s)`);
+    console.log(
+      "\nRemove venv folders and use a project-level virtual environment manager instead."
+    );
+    console.log("Add 'venv/' to .gitignore if needed.");
+    process.exit(1);
+  } catch {
+    console.log("No venv folders found.");
+    process.exit(0);
+  }
+}
+
 // src/commands/verify/run/createTimerCallback/printTaskStatuses.ts
 function formatDuration(ms) {
   if (ms < 1e3) {
@@ -1485,9 +1518,9 @@ function initTaskStatuses(scripts) {
 import { minimatch as minimatch2 } from "minimatch";
 
 // src/commands/verify/run/getChangedFiles.ts
-import { execSync as execSync6 } from "child_process";
+import { execSync as execSync7 } from "child_process";
 function getChangedFiles() {
-  const output = execSync6("git diff --name-only HEAD", {
+  const output = execSync7("git diff --name-only HEAD", {
     encoding: "utf-8"
   }).trim();
   if (output === "") return [];
@@ -1601,25 +1634,25 @@ async function run(options2 = {}) {
 }
 
 // src/commands/new/registerNew/initGit.ts
-import { execSync as execSync7 } from "child_process";
+import { execSync as execSync8 } from "child_process";
 import { writeFileSync as writeFileSync6 } from "fs";
 function initGit() {
   console.log("Initializing git repository...");
-  execSync7("git init", { stdio: "inherit" });
+  execSync8("git init", { stdio: "inherit" });
   writeFileSync6(".gitignore", "dist\nnode_modules\n");
 }
 
 // src/commands/new/registerNew/newCli/initPackageJson.ts
-import { execSync as execSync8 } from "child_process";
+import { execSync as execSync9 } from "child_process";
 function initPackageJson(name) {
   console.log("Initializing package.json...");
-  execSync8("npm init -y", { stdio: "inherit" });
+  execSync9("npm init -y", { stdio: "inherit" });
   console.log("Configuring package.json...");
-  execSync8("npm pkg delete main", { stdio: "inherit" });
-  execSync8("npm pkg set type=module", { stdio: "inherit" });
-  execSync8(`npm pkg set bin.${name}=./dist/index.js`, { stdio: "inherit" });
-  execSync8("npm pkg set scripts.build=tsup", { stdio: "inherit" });
-  execSync8('npm pkg set scripts.start="node dist/index.js"', {
+  execSync9("npm pkg delete main", { stdio: "inherit" });
+  execSync9("npm pkg set type=module", { stdio: "inherit" });
+  execSync9(`npm pkg set bin.${name}=./dist/index.js`, { stdio: "inherit" });
+  execSync9("npm pkg set scripts.build=tsup", { stdio: "inherit" });
+  execSync9('npm pkg set scripts.start="node dist/index.js"', {
     stdio: "inherit"
   });
 }
@@ -1684,8 +1717,8 @@ async function newCli() {
   initGit();
   initPackageJson(name);
   console.log("Installing dependencies...");
-  execSync9("npm install commander", { stdio: "inherit" });
-  execSync9("npm install -D tsup typescript @types/node", {
+  execSync10("npm install commander", { stdio: "inherit" });
+  execSync10("npm install -D tsup typescript @types/node", {
     stdio: "inherit"
   });
   writeCliTemplate(name);
@@ -1694,11 +1727,11 @@ async function newCli() {
 }
 
 // src/commands/new/registerNew/newProject.ts
-import { execSync as execSync11 } from "child_process";
+import { execSync as execSync12 } from "child_process";
 import { existsSync as existsSync10, readFileSync as readFileSync8, writeFileSync as writeFileSync9 } from "fs";
 
 // src/commands/deploy/init/index.ts
-import { execSync as execSync10 } from "child_process";
+import { execSync as execSync11 } from "child_process";
 import chalk21 from "chalk";
 import enquirer3 from "enquirer";
 
@@ -1751,7 +1784,7 @@ Created ${WORKFLOW_PATH}`));
 // src/commands/deploy/init/index.ts
 async function ensureNetlifyCli() {
   try {
-    execSync10("netlify sites:create --disable-linking", { stdio: "inherit" });
+    execSync11("netlify sites:create --disable-linking", { stdio: "inherit" });
   } catch (error) {
     if (!(error instanceof Error) || !error.message.includes("command not found"))
       throw error;
@@ -1766,9 +1799,9 @@ async function ensureNetlifyCli() {
       process.exit(1);
     }
     console.log(chalk21.dim("\nInstalling netlify-cli...\n"));
-    execSync10("npm install -g netlify-cli", { stdio: "inherit" });
+    execSync11("npm install -g netlify-cli", { stdio: "inherit" });
     console.log();
-    execSync10("netlify sites:create --disable-linking", { stdio: "inherit" });
+    execSync11("netlify sites:create --disable-linking", { stdio: "inherit" });
   }
 }
 function printSetupInstructions() {
@@ -1811,7 +1844,7 @@ async function init5() {
 // src/commands/new/registerNew/newProject.ts
 async function newProject() {
   console.log("Initializing Vite with react-ts template...");
-  execSync11("npm create vite@latest . -- --template react-ts", {
+  execSync12("npm create vite@latest . -- --template react-ts", {
     stdio: "inherit"
   });
   initGit();
@@ -2964,11 +2997,11 @@ function registerDeploy(program2) {
 }
 
 // src/commands/devlog/list/index.ts
-import { execSync as execSync13 } from "child_process";
+import { execSync as execSync14 } from "child_process";
 import { basename as basename3 } from "path";
 
 // src/commands/devlog/shared.ts
-import { execSync as execSync12 } from "child_process";
+import { execSync as execSync13 } from "child_process";
 import chalk37 from "chalk";
 
 // src/commands/devlog/loadDevlogEntries.ts
@@ -3012,7 +3045,7 @@ function loadDevlogEntries(repoName) {
 // src/commands/devlog/shared.ts
 function getCommitFiles(hash) {
   try {
-    const output = execSync12(`git show --name-only --format="" ${hash}`, {
+    const output = execSync13(`git show --name-only --format="" ${hash}`, {
       encoding: "utf-8"
     });
     return output.trim().split("\n").filter(Boolean);
@@ -3083,7 +3116,7 @@ function list3(options2) {
   const devlogEntries = loadDevlogEntries(repoName);
   const reverseFlag = options2.reverse ? "--reverse " : "";
   const limitFlag = options2.reverse ? "" : "-n 500 ";
-  const output = execSync13(
+  const output = execSync14(
     `git log ${reverseFlag}${limitFlag}--pretty=format:'%ad|%h|%s' --date=short`,
     { encoding: "utf-8" }
   );
@@ -3109,11 +3142,11 @@ function list3(options2) {
 }
 
 // src/commands/devlog/getLastVersionInfo.ts
-import { execSync as execSync14 } from "child_process";
+import { execSync as execSync15 } from "child_process";
 import semver from "semver";
 function getVersionAtCommit(hash) {
   try {
-    const content = execSync14(`git show ${hash}:package.json`, {
+    const content = execSync15(`git show ${hash}:package.json`, {
       encoding: "utf-8"
     });
     const pkg = JSON.parse(content);
@@ -3128,7 +3161,7 @@ function stripToMinor(version2) {
 }
 function getLastVersionInfoFromGit() {
   try {
-    const output = execSync14(
+    const output = execSync15(
       "git log -1 --pretty=format:'%ad|%h' --date=short",
       {
         encoding: "utf-8"
@@ -3171,7 +3204,7 @@ function bumpVersion(version2, type) {
 }
 
 // src/commands/devlog/next/displayNextEntry/index.ts
-import { execSync as execSync15 } from "child_process";
+import { execSync as execSync16 } from "child_process";
 import chalk40 from "chalk";
 
 // src/commands/devlog/next/displayNextEntry/displayVersion.ts
@@ -3205,7 +3238,7 @@ function findTargetDate(commitsByDate, skipDays) {
   return Array.from(commitsByDate.keys()).filter((d) => !skipDays.has(d)).sort()[0];
 }
 function fetchCommitsByDate(ignore2, lastDate) {
-  const output = execSync15(
+  const output = execSync16(
     "git log --pretty=format:'%ad|%h|%s' --date=short -n 500",
     { encoding: "utf-8" }
   );
@@ -3336,7 +3369,7 @@ import { tmpdir as tmpdir2 } from "os";
 import { join as join12 } from "path";
 
 // src/commands/prs/shared.ts
-import { execSync as execSync16 } from "child_process";
+import { execSync as execSync17 } from "child_process";
 function isGhNotInstalled(error) {
   if (error instanceof Error) {
     const msg = error.message.toLowerCase();
@@ -3352,14 +3385,14 @@ function isNotFound(error) {
 }
 function getRepoInfo() {
   const repoInfo = JSON.parse(
-    execSync16("gh repo view --json owner,name", { encoding: "utf-8" })
+    execSync17("gh repo view --json owner,name", { encoding: "utf-8" })
   );
   return { org: repoInfo.owner.login, repo: repoInfo.name };
 }
 function getCurrentPrNumber() {
   try {
     const prInfo = JSON.parse(
-      execSync16("gh pr view --json number", { encoding: "utf-8" })
+      execSync17("gh pr view --json number", { encoding: "utf-8" })
     );
     return prInfo.number;
   } catch (error) {
@@ -3373,7 +3406,7 @@ function getCurrentPrNumber() {
 function getCurrentPrNodeId() {
   try {
     const prInfo = JSON.parse(
-      execSync16("gh pr view --json id", { encoding: "utf-8" })
+      execSync17("gh pr view --json id", { encoding: "utf-8" })
     );
     return prInfo.id;
   } catch (error) {
@@ -3444,10 +3477,10 @@ function comment(path31, line, body) {
 }
 
 // src/commands/prs/fixed.ts
-import { execSync as execSync18 } from "child_process";
+import { execSync as execSync19 } from "child_process";
 
 // src/commands/prs/resolveCommentWithReply.ts
-import { execSync as execSync17 } from "child_process";
+import { execSync as execSync18 } from "child_process";
 import { unlinkSync as unlinkSync5, writeFileSync as writeFileSync14 } from "fs";
 import { tmpdir as tmpdir3 } from "os";
 import { join as join14 } from "path";
@@ -3477,7 +3510,7 @@ function deleteCommentsCache(prNumber) {
 
 // src/commands/prs/resolveCommentWithReply.ts
 function replyToComment(org, repo, prNumber, commentId, message) {
-  execSync17(
+  execSync18(
     `gh api repos/${org}/${repo}/pulls/${prNumber}/comments -f body="${message.replace(/"/g, '\\"')}" -F in_reply_to=${commentId}`,
     { stdio: "inherit" }
   );
@@ -3487,7 +3520,7 @@ function resolveThread(threadId) {
   const queryFile = join14(tmpdir3(), `gh-mutation-${Date.now()}.graphql`);
   writeFileSync14(queryFile, mutation);
   try {
-    execSync17(
+    execSync18(
       `gh api graphql -F query=@${queryFile} -f threadId="${threadId}"`,
       { stdio: "inherit" }
     );
@@ -3539,7 +3572,7 @@ function resolveCommentWithReply(commentId, message) {
 // src/commands/prs/fixed.ts
 function verifySha(sha) {
   try {
-    return execSync18(`git rev-parse --verify ${sha}`, {
+    return execSync19(`git rev-parse --verify ${sha}`, {
       encoding: "utf-8"
     }).trim();
   } catch {
@@ -3575,7 +3608,7 @@ function isClaudeCode2() {
 }
 
 // src/commands/prs/fetchThreadIds.ts
-import { execSync as execSync19 } from "child_process";
+import { execSync as execSync20 } from "child_process";
 import { unlinkSync as unlinkSync6, writeFileSync as writeFileSync15 } from "fs";
 import { tmpdir as tmpdir4 } from "os";
 import { join as join15 } from "path";
@@ -3584,7 +3617,7 @@ function fetchThreadIds(org, repo, prNumber) {
   const queryFile = join15(tmpdir4(), `gh-query-${Date.now()}.graphql`);
   writeFileSync15(queryFile, THREAD_QUERY);
   try {
-    const result = execSync19(
+    const result = execSync20(
       `gh api graphql -F query=@${queryFile} -F owner="${org}" -F repo="${repo}" -F prNumber=${prNumber}`,
       { encoding: "utf-8" }
     );
@@ -3606,9 +3639,9 @@ function fetchThreadIds(org, repo, prNumber) {
 }
 
 // src/commands/prs/listComments/fetchReviewComments.ts
-import { execSync as execSync20 } from "child_process";
+import { execSync as execSync21 } from "child_process";
 function fetchJson(endpoint) {
-  const result = execSync20(`gh api ${endpoint}`, { encoding: "utf-8" });
+  const result = execSync21(`gh api ${endpoint}`, { encoding: "utf-8" });
   if (!result.trim()) return [];
   return JSON.parse(result);
 }
@@ -3734,7 +3767,7 @@ async function listComments() {
 }
 
 // src/commands/prs/prs/index.ts
-import { execSync as execSync21 } from "child_process";
+import { execSync as execSync22 } from "child_process";
 
 // src/commands/prs/prs/displayPaginated/index.ts
 import enquirer5 from "enquirer";
@@ -3840,7 +3873,7 @@ async function displayPaginated(pullRequests) {
 async function prs(options2) {
   const state = options2.open ? "open" : options2.closed ? "closed" : "all";
   try {
-    const result = execSync21(
+    const result = execSync22(
       `gh pr list --state ${state} --json number,title,url,author,createdAt,mergedAt,closedAt,state,changedFiles --limit 100`,
       { encoding: "utf-8" }
     );
@@ -3863,7 +3896,7 @@ async function prs(options2) {
 }
 
 // src/commands/prs/wontfix.ts
-import { execSync as execSync22 } from "child_process";
+import { execSync as execSync23 } from "child_process";
 function validateReason(reason) {
   const lowerReason = reason.toLowerCase();
   if (lowerReason.includes("claude") || lowerReason.includes("opus")) {
@@ -3880,7 +3913,7 @@ function validateShaReferences(reason) {
   const invalidShas = [];
   for (const sha of shas) {
     try {
-      execSync22(`git cat-file -t ${sha}`, { stdio: "pipe" });
+      execSync23(`git cat-file -t ${sha}`, { stdio: "pipe" });
     } catch {
       invalidShas.push(sha);
     }
@@ -3984,7 +4017,7 @@ Refactor check failed:
 }
 
 // src/commands/refactor/check/getViolations/index.ts
-import { execSync as execSync23 } from "child_process";
+import { execSync as execSync24 } from "child_process";
 import fs15 from "fs";
 import { minimatch as minimatch4 } from "minimatch";
 
@@ -4034,7 +4067,7 @@ function getGitFiles(options2) {
   }
   const files = /* @__PURE__ */ new Set();
   if (options2.staged || options2.modified) {
-    const staged = execSync23("git diff --cached --name-only", {
+    const staged = execSync24("git diff --cached --name-only", {
       encoding: "utf-8"
     });
     for (const file of staged.trim().split("\n").filter(Boolean)) {
@@ -4042,7 +4075,7 @@ function getGitFiles(options2) {
     }
   }
   if (options2.unstaged || options2.modified) {
-    const unstaged = execSync23("git diff --name-only", { encoding: "utf-8" });
+    const unstaged = execSync24("git diff --name-only", { encoding: "utf-8" });
     for (const file of unstaged.trim().split("\n").filter(Boolean)) {
       files.add(file);
     }
@@ -5320,6 +5353,7 @@ function registerVerify(program2) {
   verifyCommand.command("list").description("List configured verify commands").action(list);
   verifyCommand.command("init").description("Add verify scripts to a project").action(init2);
   verifyCommand.command("hardcoded-colors").description("Check for hardcoded hex colors in src/").action(hardcodedColors);
+  verifyCommand.command("no-venv").description("Check that no venv folders exist in the repo").action(noVenv);
 }
 
 // src/commands/voice/devices.ts
@@ -5393,7 +5427,7 @@ import { mkdirSync as mkdirSync8 } from "fs";
 import { join as join26 } from "path";
 
 // src/commands/voice/checkLockFile.ts
-import { execSync as execSync24 } from "child_process";
+import { execSync as execSync25 } from "child_process";
 import { existsSync as existsSync24, mkdirSync as mkdirSync7, readFileSync as readFileSync18, writeFileSync as writeFileSync18 } from "fs";
 import { join as join25 } from "path";
 function isProcessAlive(pid) {
@@ -5422,7 +5456,7 @@ function bootstrapVenv() {
   if (existsSync24(getVenvPython())) return;
   console.log("Setting up Python environment...");
   const pythonDir = getPythonDir();
-  execSync24(`uv sync --project "${pythonDir}" --no-install-project`, {
+  execSync25(`uv sync --project "${pythonDir}" --no-install-project`, {
     stdio: "inherit",
     env: { ...process.env, UV_PROJECT_ENVIRONMENT: voicePaths.venv }
   });
@@ -5586,11 +5620,11 @@ import { randomBytes } from "crypto";
 import chalk51 from "chalk";
 
 // src/lib/openBrowser.ts
-import { execSync as execSync25 } from "child_process";
+import { execSync as execSync26 } from "child_process";
 function tryExec(commands) {
   for (const cmd of commands) {
     try {
-      execSync25(cmd);
+      execSync26(cmd);
       return true;
     } catch {
     }
@@ -6043,7 +6077,7 @@ function syncCommands(claudeDir, targetBase) {
 }
 
 // src/commands/update.ts
-import { execSync as execSync26 } from "child_process";
+import { execSync as execSync27 } from "child_process";
 import * as path30 from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
 var __filename3 = fileURLToPath6(import.meta.url);
@@ -6053,7 +6087,7 @@ function getInstallDir() {
 }
 function isGitRepo(dir) {
   try {
-    execSync26("git rev-parse --is-inside-work-tree", {
+    execSync27("git rev-parse --is-inside-work-tree", {
       cwd: dir,
       stdio: "pipe"
     });
@@ -6064,7 +6098,7 @@ function isGitRepo(dir) {
 }
 function isGlobalNpmInstall(dir) {
   try {
-    const globalPrefix = execSync26("npm prefix -g", { stdio: "pipe" }).toString().trim();
+    const globalPrefix = execSync27("npm prefix -g", { stdio: "pipe" }).toString().trim();
     return path30.resolve(dir).toLowerCase().startsWith(path30.resolve(globalPrefix).toLowerCase());
   } catch {
     return false;
@@ -6075,16 +6109,16 @@ async function update() {
   console.log(`Assist is installed at: ${installDir}`);
   if (isGitRepo(installDir)) {
     console.log("Detected git repo installation, pulling latest...");
-    execSync26("git pull", { cwd: installDir, stdio: "inherit" });
+    execSync27("git pull", { cwd: installDir, stdio: "inherit" });
     console.log("Building...");
-    execSync26("npm run build", { cwd: installDir, stdio: "inherit" });
+    execSync27("npm run build", { cwd: installDir, stdio: "inherit" });
     console.log("Syncing commands...");
-    execSync26("assist sync", { stdio: "inherit" });
+    execSync27("assist sync", { stdio: "inherit" });
   } else if (isGlobalNpmInstall(installDir)) {
     console.log("Detected global npm installation, updating...");
-    execSync26("npm i -g @staff0rd/assist@latest", { stdio: "inherit" });
+    execSync27("npm i -g @staff0rd/assist@latest", { stdio: "inherit" });
     console.log("Syncing commands...");
-    execSync26("assist sync", { stdio: "inherit" });
+    execSync27("assist sync", { stdio: "inherit" });
   } else {
     console.error(
       "Could not determine installation method. Expected a git repo or global npm install."

package/package.json

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