@holdyourvoice/hyv 2.9.26 → 2.9.27

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable CLI changes. Also mirrored to [holdyourvoice.com/changelog](https://holdyourvoice.com/changelog) for user-facing releases.
 
+## [2.9.27] — 2026-07-15
+
+### Fixed
+- **MCP scan hang** — `hyv_scan`, `hyv_fix`, `hyv_check`, `hyv_score`, `hyv_diff`, and `hyv_validate` no longer block on account profile sync; they use local `~/.hyv` cache immediately (matching `hyv scan` CLI) and hydrate profiles in the background
+
 ## [2.9.26] — 2026-07-09
 
 ### Improved

package/README.md

@@ -96,7 +96,7 @@ hyv doctor --fix-agents
 | tool | description |
 |------|-------------|
 | `hyv_welcome` / `hyv_demo` | onboarding + live free scan demo |
-| `hyv_scan` | fast local scan (free, offline) |
+| `hyv_scan` | fast local scan (free, offline; uses `~/.hyv` cache, no network wait) |
 | `hyv_analyze` | hybrid local + server analysis (paid when online) |
 | `hyv_clean` | scan → fix → validate → rewrite prompt |
 | `hyv_fix` / `hyv_check` / `hyv_score` / `hyv_diff` | local utilities |
@@ -209,6 +209,10 @@ HYV_API_URL=https://staging.holdyourvoice.com hyv init
 - [blog](https://holdyourvoice.com/blog)
 - [community](https://holdyourvoice.com/community)
 
+## documentation ownership
+
+Changes under `cli/` update this README, the more-specific owner README when applicable, and the root repository README. Package-relative paths, bin names, published files, and postinstall behavior are contracts; validate them with `npm run validate:publish` before merging.
+
 ## license
 
 UNLICENSED — [holdyourvoice.com](https://holdyourvoice.com)

package/agents/README.md

@@ -0,0 +1,20 @@
+# `cli/agents/`
+
+## Purpose
+
+`cli/agents/` contains agent resources included in the published CLI package.
+
+## Contracts
+
+The directory is included by the `files` list in `cli/package.json`. Changes must preserve package inclusion and postinstall discovery behavior.
+
+## Validation
+
+```bash
+cd cli
+npm run validate:publish
+```
+
+## Documentation ownership
+
+Changes update this README, `cli/README.md`, and the root `README.md`.

package/assets/README.md

@@ -0,0 +1,20 @@
+# `cli/assets/`
+
+## Purpose
+
+`cli/assets/` contains assets included in the published CLI package.
+
+## Contracts
+
+The directory is included by the `files` list in `cli/package.json`. Keep package paths and postinstall consumers intact.
+
+## Validation
+
+```bash
+cd cli
+npm run validate:publish
+```
+
+## Documentation ownership
+
+Changes update this README, `cli/README.md`, and the root `README.md`.

package/dist/index.js

@@ -16662,7 +16662,9 @@ function buildRewritePrompt(options) {
   const template = loadPromptTemplate();
   const prompt = template.replace("{profile_block}", profileBlock).replace("{constraints_block}", constraints || "(none)").replace("{tier_one_lines}", tierOneLines).replace("{other_lines}", otherLines).replace("{draft_name}", draftPath).replace("{numbered_draft}", numberedDraft);
   return {
-    prompt,
+    prompt: skipScan ? `${prompt}
+
+none found by deterministic scan` : prompt,
     profileUsed,
     issuesFound: issues.length
   };
@@ -17938,6 +17940,7 @@ var MCP_SERVER_ARGS = ["mcp", "--stdio"];
 // src/lib/cli-entry.ts
 function resolveCliEntry() {
   const candidates = [
+    typeof __filename !== "undefined" ? path17.resolve(__filename) : "",
     path17.resolve(process.argv[1] || ""),
     path17.resolve(__dirname, "index.js"),
     path17.resolve(__dirname, "..", "dist", "index.js")
@@ -17949,7 +17952,7 @@ function mcpServerCommand() {
   if (entry) {
     return { command: process.execPath, args: [entry, ...MCP_SERVER_ARGS] };
   }
-  return { command: "hyv", args: [...MCP_SERVER_ARGS] };
+  throw new Error("could not resolve hyv CLI entry \u2014 reinstall @holdyourvoice/hyv or run via node dist/index.js");
 }
 function mcpServerSnippet() {
   const { command, args: args2 } = mcpServerCommand();
@@ -19827,6 +19830,10 @@ async function resolveProfile(slug) {
   }
   return profile;
 }
+async function loadLocalProfileForTool(slug) {
+  void ensureMcpProfilesHydrated();
+  return loadProfileForCommand(slug);
+}
 function jsonRpcOk(id, result) {
   return JSON.stringify({ jsonrpc: "2.0", id, result });
 }
@@ -19884,7 +19891,7 @@ async function toolScan(args2) {
     return "Error: no text or file provided";
   try {
     let scanText2 = text;
-    const profile = await resolveProfile(args2.profile);
+    const profile = await loadLocalProfileForTool(args2.profile);
     if (filePath) {
       try {
         scanText2 = readScanFile(filePath);
@@ -19932,7 +19939,7 @@ async function toolValidate(args2) {
   if (!text.trim())
     return "Error: no text provided";
   try {
-    const profile = await resolveProfile(profileSlug);
+    const profile = await loadLocalProfileForTool(profileSlug);
     if (!profile)
       return "Error: no voice profile available. Run hyv init or use hyv scan for free generic checks.";
     const result = validateRewrite(text, text, profile);
@@ -19955,7 +19962,7 @@ async function toolFix(args2) {
   if (!text.trim())
     return "Error: no text provided";
   try {
-    const profile = await resolveProfile(args2.profile);
+    const profile = await loadLocalProfileForTool(args2.profile);
     const result = runPipeline(text, profile, true);
     if (result.changes.length === 0)
       return "No auto-fixable issues found.";
@@ -19974,7 +19981,7 @@ async function toolCheck(args2) {
   if (!text.trim())
     return "Error: no text provided";
   try {
-    const profile = await resolveProfile(args2.profile);
+    const profile = await loadLocalProfileForTool(args2.profile);
     const result = runPipeline(text, profile, false);
     if (result.stats.totalSignals === 0)
       return `Clean \u2014 score: ${result.score}/100. No AI patterns found.`;
@@ -19992,7 +19999,7 @@ async function toolScore(args2) {
   if (!text.trim())
     return "Error: no text provided";
   try {
-    const profile = await resolveProfile(args2.profile);
+    const profile = await loadLocalProfileForTool(args2.profile);
     const result = runPipeline(text, profile, false);
     return result.score.toString();
   } catch (err) {
@@ -20004,7 +20011,7 @@ async function toolDiff(args2) {
   if (!text.trim())
     return "Error: no text provided";
   try {
-    const profile = await resolveProfile(args2.profile);
+    const profile = await loadLocalProfileForTool(args2.profile);
     const result = runPipeline(text, profile, true);
     if (result.changes.length === 0)
       return "No auto-fixable changes available.";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holdyourvoice/hyv",
-  "version": "2.9.26",
+  "version": "2.9.27",
   "description": "Free local AI writing scan for cursor & claude. MCP server, 220+ pattern detection, voice profiles. npx @holdyourvoice/hyv welcome",
   "main": "dist/index.js",
   "bin": {

package/scripts/README.md

@@ -0,0 +1,21 @@
+# `cli/scripts/`
+
+## Purpose
+
+`cli/scripts/` contains package install, publish validation, smoke-test, and supporting CLI scripts.
+
+## Contracts
+
+Scripts are referenced by `cli/package.json` and the npm package `files` list. Package-relative paths must remain valid when the package is published.
+
+## Validation
+
+```bash
+cd cli
+npm run validate:publish
+npm run test:smoke
+```
+
+## Documentation ownership
+
+Changes under this folder update this README, `cli/README.md`, and the root `README.md`.

package/skills/README.md

@@ -0,0 +1,20 @@
+# `cli/skills/`
+
+## Purpose
+
+`cli/skills/` contains skills included in the published CLI package.
+
+## Contracts
+
+The directory is included by the `files` list in `cli/package.json`. Changes must preserve package inclusion and any postinstall or agent configuration paths that reference these files.
+
+## Validation
+
+```bash
+cd cli
+npm run validate:publish
+```
+
+## Documentation ownership
+
+Changes update this README, `cli/README.md`, and the root `README.md`.