mover-os 4.7.6 → 4.7.7

package/install.js

@@ -3299,16 +3299,41 @@ function installHooksForClaude(bundleDir, vaultPath) {
           }
         }
       }
+      // v4.7.7: set skillListingBudgetFraction so Mover OS users don't see
+      // skill descriptions truncated by Claude Code's default 1% budget.
+      // Per Claude Code's own /doctor output, Mover's ~63 skills need 2.5%
+      // of context; 0.03 (3%) gives that exact size + small headroom for
+      // user-added skills, without doubling the cost like 0.05 would.
+      //
+      // TRADEOFF: each session uses ~4,000 more system-prompt tokens than
+      // Claude Code's default 1%. That marginally accelerates autocompaction
+      // (~2% sooner) and rate-limit ticker. The benefit (full skill
+      // descriptions available, no truncation message) outweighs the cost
+      // for users who installed Mover OS specifically for the skill packs.
+      //
+      // Only set if not already configured — respect explicit user choice.
+      // To opt out: manually set "skillListingBudgetFraction": 0.01 in your
+      // ~/.claude/settings.json after install.
+      if (existing.skillListingBudgetFraction === undefined) {
+        existing.skillListingBudgetFraction = 0.03;
+      }
       fs.writeFileSync(settingsPath, JSON.stringify(existing, null, 2), "utf8");
     } catch {
       // Corrupt settings — backup before overwrite
       const backupPath = settingsPath + ".bak";
       try { fs.copyFileSync(settingsPath, backupPath); } catch {}
       ln(`  ${yellow("!")} Settings file corrupt — backed up to settings.json.bak, writing fresh`);
-      fs.writeFileSync(settingsPath, generateClaudeSettings(), "utf8");
+      // Fresh write also sets the budget — combine generated hooks with the
+      // skill budget setting so a fresh install doesn't trigger truncation.
+      const fresh = JSON.parse(generateClaudeSettings());
+      fresh.skillListingBudgetFraction = 0.03;
+      fs.writeFileSync(settingsPath, JSON.stringify(fresh, null, 2), "utf8");
     }
   } else {
-    fs.writeFileSync(settingsPath, generateClaudeSettings(), "utf8");
+    // Fresh install — write hooks AND the skill listing budget together.
+    const fresh = JSON.parse(generateClaudeSettings());
+    fresh.skillListingBudgetFraction = 0.03;
+    fs.writeFileSync(settingsPath, JSON.stringify(fresh, null, 2), "utf8");
   }
 
   return count;
@@ -4200,6 +4225,54 @@ async function cmdDoctor(opts) {
     statusLine(allOk ? "ok" : "warn", `  ${reg.name}`, checks.join(", "));
   }
 
+  // ── Claude Code skill listing budget (v4.7.7) ────────────────────────
+  // Claude Code 2.1.x truncates skill descriptions when the total exceeds
+  // skillListingBudgetFraction (default 0.01 = 1% of context, ~2K tokens).
+  // Users with 50+ skills installed see the "X descriptions dropped" message.
+  // This is a Claude Code feature, not a Mover OS bug — but Mover users hit
+  // it because we ship many skills. Help the user diagnose + tune.
+  barLn();
+  barLn(dim("  Claude Code:"));
+  const claudeSkillsDir = path.join(home, ".claude", "skills");
+  if (fs.existsSync(claudeSkillsDir)) {
+    const skillCount = fs.readdirSync(claudeSkillsDir).filter(n => !n.startsWith(".")).length;
+    statusLine(
+      skillCount > 70 ? "warn" : "ok",
+      "  Skill count",
+      `${skillCount} in ~/.claude/skills/`
+    );
+    if (skillCount > 50) {
+      // Try to read settings.json to report current value.
+      let currentFraction = null;
+      try {
+        const s = JSON.parse(fs.readFileSync(path.join(home, ".claude", "settings.json"), "utf8"));
+        if (typeof s.skillListingBudgetFraction === "number") currentFraction = s.skillListingBudgetFraction;
+      } catch {}
+      const fracDisplay = currentFraction === null ? "unset (Claude Code default 0.01)" : String(currentFraction);
+      barLn(dim(`    Skill listing budget: ${fracDisplay}`));
+      if (currentFraction === null || currentFraction < 0.025) {
+        barLn(dim(`    With ${skillCount} skills, Claude Code's default 1% budget truncates`));
+        barLn(dim(`    less-used skill descriptions ("X descriptions dropped" message).`));
+        barLn(dim(`    'moveros install' sets skillListingBudgetFraction: 0.03 (3%) to fit`));
+        barLn(dim(`    Mover's manifest. Trade: ~4K extra tokens per session, all skills`));
+        barLn(dim(`    visible. To opt back to 1% default: edit ~/.claude/settings.json.`));
+      } else {
+        barLn(dim(`    Budget covers ~${Math.floor(currentFraction * 100 * 25)} skills before truncation. Run /skills`));
+        barLn(dim(`    in Claude Code to disable specific skills.`));
+      }
+    }
+  }
+  // CLAUDE.md size check — Claude Code flags > 40K as "Large CLAUDE.md".
+  const claudeMd = path.join(home, ".claude", "CLAUDE.md");
+  if (fs.existsSync(claudeMd)) {
+    const claudeMdSize = fs.statSync(claudeMd).size;
+    statusLine(
+      claudeMdSize > 40000 ? "warn" : "ok",
+      "  CLAUDE.md size",
+      `${claudeMdSize.toLocaleString()} chars` + (claudeMdSize > 40000 ? " (Claude Code flags >40K)" : "")
+    );
+  }
+
   // Engine Git
   barLn();
   const engineGit = fs.existsSync(path.join(engineDir, ".git"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mover-os",
-  "version": "4.7.6",
+  "version": "4.7.7",
   "description": "Your AI co-founder. Remembers your goals, pushes back when you drift. Works with 15 AI agents.",
   "bin": {
     "moveros": "install.js"