kodelyth-ecc 2.23.0 → 2.23.1

package/CHANGELOG.md

@@ -2,6 +2,51 @@
 
 All notable changes to Kodelyth ECC are documented here.
 
+## v2.23.1 — the shop window said the wrong numbers (October 2026)
+
+No change to the toolkit. This exists because npm metadata only refreshes when
+you publish, and three public-facing surfaces had gone stale.
+
+Measured before changing anything: **9,233 npm downloads in the last 30 days
+against 11 GitHub stars** — roughly 840:1, where a healthy project runs 50:1 to
+200:1. Discovery is not the constraint; thousands install this and nothing
+converts them.
+
+### Corrected
+
+| Surface | Said | Actual |
+|---|---|---|
+| `package.json` description | 194 skills, 97 commands | 196, 103 |
+| GitHub repo description | 102 commands, 22+ hooks | 103, **44** |
+| README badges | **373 tests**, Skills-194 | **647 tests**, 196 |
+
+Wrong numbers in the first thing anyone sees read as abandoned. Both
+descriptions now also name Windows, which became a real differentiator in 2.23.0
+and went unmentioned.
+
+### Asked, once
+
+The end of a successful install is the highest-intent moment there is, and an
+all-green `doctor` is the other. Both were silent. Both now print a single line.
+
+It is gated hard, because an ask that repeats is an annoyance:
+
+- shown **once per machine**, via a marker beside the other ECC state
+- never after a failed install
+- never when `doctor` reports a warning or a failure
+- wrapped so it can never break an install
+
+Someone wiring up four IDEs is asked once, not four times.
+
+### Keywords
+
+Strong on the long tail (`devil-mode`, `bm25`, `intent-routing`), missing the
+broad terms people actually type. Added `claude`, `agent`, `agents`, `ai`,
+`subagents`, `prompt-engineering`, `ai-assistant`, `code-review`, `windows`.
+41 to 50.
+
+**647 tests passing.**
+
 ## v2.23.0 — Windows has no manual step left (October 2026)
 
 2.22.0 made the Windows install work but left two components needing a manual

package/README.md

@@ -13,7 +13,7 @@
 [![npm downloads](https://img.shields.io/npm/dm/kodelyth-ecc.svg)](https://www.npmjs.com/package/kodelyth-ecc)
 [![GitHub Stars](https://img.shields.io/github/stars/sifxprime/kodelyth-ecc?style=social)](https://github.com/sifxprime/kodelyth-ecc/stargazers)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-![Tests](https://img.shields.io/badge/tests-373%20passing-brightgreen)
+![Tests](https://img.shields.io/badge/tests-647%20passing-brightgreen)
 ![Claude Code](https://img.shields.io/badge/Claude%20Code-Ready-8A2BE2)
 ![Windsurf](https://img.shields.io/badge/Windsurf-Ready-06b6d4)
 ![Antigravity](https://img.shields.io/badge/Antigravity-Ready-00ADD8)
@@ -21,7 +21,7 @@
 ![Codex](https://img.shields.io/badge/Codex-Ready-10b981)
 ![Agents](https://img.shields.io/badge/Agents-70-brightgreen)
 ![Devil Mode](https://img.shields.io/badge/Devil%20Mode-new-red)
-![Skills](https://img.shields.io/badge/Skills-194-brightgreen)
+![Skills](https://img.shields.io/badge/Skills-196-brightgreen)
 ![Memory](https://img.shields.io/badge/Local%20Memory-on-blueviolet)
 ![Auto Recall](https://img.shields.io/badge/Auto%20Chat%20Recall-on-blueviolet)
 ![Parallel Agents](https://img.shields.io/badge/Parallel%20Agents-new-red)

package/VERSION

@@ -1 +1 @@
-2.23.0
+2.23.1

package/bin/kodelyth-ecc.js

@@ -724,7 +724,13 @@ if (args[0] === 'doctor') {
   w('─'.repeat(60));
   const s = report.summary;
   w(`${s.pass} pass · ${s.warn} warn · ${s.fail} fail  (of ${s.total} checks)`);
-  if (s.fail === 0 && s.warn === 0) w('\x1b[32mEverything is wired and working.\x1b[0m');
+  if (s.fail === 0 && s.warn === 0) {
+    w('\x1b[32mEverything is wired and working.\x1b[0m');
+    // An all-green doctor is the other honest moment to ask. Shares the install
+    // marker, so nobody is asked twice on the same machine, and it stays silent
+    // when anything is warning or failing — that is not the time.
+    maybeAskForAStar(0);
+  }
   else if (s.fail === 0) w('\x1b[33mWorking, with optional features not yet enabled (warnings above).\x1b[0m');
   else w('\x1b[31mSome subsystems are broken — see fixes above.\x1b[0m');
   w('');
@@ -1817,6 +1823,33 @@ if (args.includes('--version') || args.includes('-v')) {
 // Every block below already guards itself and reports a reason when it cannot
 // proceed, which is what makes sharing it safe: on Windows the parts that work
 // now run, and the parts that cannot say so instead of vanishing.
+/**
+ * One quiet line at the end of a successful install.
+ *
+ * This is the highest-intent moment there is — someone has just watched the
+ * whole thing land and work — and it was going unused. It is deliberately shown
+ * ONCE per machine, not on every target install: somebody wiring up four IDEs
+ * should not be asked four times. The marker lives beside the other ECC state.
+ *
+ * Never shown on a failed install, and never blocks or prompts.
+ */
+function maybeAskForAStar(status) {
+  if (status !== 0) return;
+  try {
+    const dir = path.join(os.homedir(), '.kodelythecc');
+    const marker = path.join(dir, 'star-asked');
+    if (fs.existsSync(marker)) return;
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(marker, new Date().toISOString() + '\n');
+
+    process.stdout.write('\n');
+    process.stdout.write('  If ECC saved you time today, a star helps others find it:\n');
+    process.stdout.write('  https://github.com/sifxprime/kodelyth-ecc\n\n');
+  } catch {
+    // A star request is never worth failing an install over.
+  }
+}
+
 function runPostInstall(status, args) {
   // Post-install: auto-register ECC's own MCP server in Claude Code + Desktop.
   if (status === 0 && !args.includes('--no-mcp-register')) {
@@ -1983,6 +2016,7 @@ if (isWin) {
     process.exit(1);
   }
   runPostInstall(result.status, args);
+  maybeAskForAStar(result.status);
   process.exit(result.status ?? 1);
 } else {
   try { require(path.join(ROOT, 'scripts', 'migrate-legacy.js')).main(); } catch {}
@@ -1995,5 +2029,6 @@ if (isWin) {
   const result = spawnSync('bash', [sh, ...args], { stdio: 'inherit', shell: false });
 
   runPostInstall(result.status, args);
+  maybeAskForAStar(result.status);
   process.exit(result.status ?? 1);
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kodelyth-ecc",
-  "version": "2.23.0",
-  "description": "Production-grade AI coding toolkit — 70 agents (incl. devil-mode adversarial crew), 194 skills, 97 commands, parallel multi-agent commands, semantic intent routing, self-learning memory, and a built-in MCP server (16 tools / 6 prompts / 377 resources) that bridges to Claude Desktop, LangGraph, AutoGen, CrewAI, and OpenAI Agents SDK. Works with Claude Code, Windsurf, Cursor, Codex, Antigravity, OpenCode, Cline, RooCode, Aider, Kimi, and Gemini CLI.",
+  "version": "2.23.1",
+  "description": "Production-grade AI coding toolkit — 70 agents (incl. devil-mode adversarial crew), 196 skills, 103 commands, parallel multi-agent commands, semantic intent routing, self-learning memory, and a built-in MCP server (16 tools / 6 prompts / 377 resources) that bridges to Claude Desktop, LangGraph, AutoGen, CrewAI, and OpenAI Agents SDK. Works on macOS, Linux and Windows with Claude Code, Windsurf, Cursor, Codex, Antigravity, OpenCode, Cline, RooCode, Aider, Kimi, and Gemini CLI.",
   "author": "Kodelyth <github.com/sifxprime>",
   "license": "MIT",
   "repository": {
@@ -54,7 +54,16 @@
     "local-memory",
     "hooks",
     "slash-commands",
-    "productivity"
+    "productivity",
+    "claude",
+    "agent",
+    "agents",
+    "ai",
+    "subagents",
+    "prompt-engineering",
+    "ai-assistant",
+    "code-review",
+    "windows"
   ],
   "bin": {
     "kodelyth-ecc": "bin/kodelyth-ecc.js",