kodelyth-ecc 2.1.1 → 2.1.2

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 All notable changes to Kodelyth ECC are documented here.
 
+## v2.1.2 — Install-flow fixes caught by live user testing (July 2026)
+
+Ran the actual `npx kodelyth-ecc --target claude-code` flow as a user would, end-to-end. Three real bugs surfaced and got fixed.
+
+### Fixed
+
+- **`--target claude-code` was rejected** with "Unknown target." install.sh only knew `claude-home`, but every doc, README, and CHANGELOG example uses `claude-code`. install.sh now accepts both (`claude-home|claude-code)` case)
+- **Post-install RTK block silently skipped** on the (correct) `--target claude-code` because `TARGET_MAP` was keyed on `claude-home`. Added `normalizeTarget()` and both the RTK and terse post-install blocks now normalise the target before lookup. `gemini-cli` → `gemini-home`, `cursor` → `cursor-project` also normalised
+- **install.sh `/dev/tty` read failed on piped/CI shells** even though the guard tested `-e /dev/tty`. Guard now also tests `-r /dev/tty` and honours `KODELYTH_NONINTERACTIVE=1` env (Windows PowerShell path already set this)
+- **install.sh footer showed stale `v1.8.1`** from a leftover VERSION file. Bumped to current
+
+### Verified end-to-end on this Mac
+
+```
+$ npm i -g kodelyth-ecc && kodelyth-ecc --target claude-code
+  ...
+━ RTK token savings ─────────────────────────────
+  ✓ RTK 0.42.4 — wired for claude-home
+  ✓ Restart your AI tool to activate. 60-90% token savings on shell commands.
+
+━ Terse mode ────────────────────────────────────
+  ✓ /terse and /terse-compress installed for claude-home
+  · Activate any time: type /terse in your AI tool (dormant until you do)
+```
+
+Files land at `~/.claude/skills/terse-mode/SKILL.md` and `~/.claude/commands/terse.md`. Discoverable by the AI on next session.
+
+### Added
+
+- `scripts/rtk/index.js` — `normalizeTarget(target)` exported. Accepts `claude-code`, `gemini-cli`, `cursor` and returns the canonical install.sh target names. `roocode` and `kimi` also added to `TARGET_MAP`
+
 ## v2.0.0 — Terse mode: output-token compressor + memory compressor (July 2026)
 
 RTK saves input tokens. Terse mode now saves output tokens. Together — on a typical coding session — ECC cuts ~55-65% of total token cost while keeping code, commands, and errors byte-exact.

package/VERSION

@@ -1 +1 @@
-1.8.1
+2.1.2

package/bin/kodelyth-ecc.js

@@ -351,30 +351,39 @@ if (args[0] === 'terse') {
   }
 }
 
+// Normalise alias → canonical target (matches scripts/rtk/index.js).
+function _canon(target) {
+  if (target === 'claude-code') return 'claude-home';
+  if (target === 'gemini-cli')  return 'gemini-home';
+  if (target === 'cursor')      return 'cursor-project';
+  return target;
+}
 function getTargetSkillsDir(target) {
   const home = os.homedir();
-  switch (target) {
-    case 'claude-code':      return path.join(home, '.claude', 'skills');
-    case 'cursor':
+  switch (_canon(target)) {
+    case 'claude-home':      return path.join(home, '.claude', 'skills');
     case 'cursor-project':   return path.join(home, '.cursor', 'skills');
-    case 'windsurf-home':    return path.join(home, '.codeium', 'windsurf', 'skills');
+    case 'windsurf-home':
+    case 'windsurf-project': return path.join(home, '.codeium', 'windsurf', 'skills');
     case 'antigravity':      return path.join(home, '.antigravity', 'skills');
     case 'codex-home':       return path.join(home, '.codex', 'skills');
-    case 'gemini-cli':       return path.join(home, '.gemini', 'skills');
+    case 'gemini-home':      return path.join(home, '.gemini', 'skills');
+    case 'gemini-project':   return path.join(process.cwd(), '.gemini', 'skills');
     case 'opencode':         return path.join(home, '.config', 'opencode', 'skills');
     default: return null;
   }
 }
 function getTargetCommandsDir(target) {
   const home = os.homedir();
-  switch (target) {
-    case 'claude-code':      return path.join(home, '.claude', 'commands');
-    case 'cursor':
+  switch (_canon(target)) {
+    case 'claude-home':      return path.join(home, '.claude', 'commands');
     case 'cursor-project':   return path.join(home, '.cursor', 'commands');
-    case 'windsurf-home':    return path.join(home, '.codeium', 'windsurf', 'commands');
+    case 'windsurf-home':
+    case 'windsurf-project': return path.join(home, '.codeium', 'windsurf', 'commands');
     case 'antigravity':      return path.join(home, '.antigravity', 'commands');
     case 'codex-home':       return path.join(home, '.codex', 'commands');
-    case 'gemini-cli':       return path.join(home, '.gemini', 'commands');
+    case 'gemini-home':      return path.join(home, '.gemini', 'commands');
+    case 'gemini-project':   return path.join(process.cwd(), '.gemini', 'commands');
     case 'opencode':         return path.join(home, '.config', 'opencode', 'commands');
     default: return null;
   }
@@ -1232,7 +1241,8 @@ if (isWin) {
     try {
       const rtk = require(path.join(ROOT, 'scripts', 'rtk', 'index.js'));
       const targetIdx = args.indexOf('--target');
-      const target = targetIdx >= 0 && args[targetIdx + 1] ? args[targetIdx + 1] : 'claude-code';
+      const rawTarget = targetIdx >= 0 && args[targetIdx + 1] ? args[targetIdx + 1] : 'claude-code';
+      const target = rtk.normalizeTarget(rawTarget);
       if (rtk.TARGET_MAP[target]) {
         const w = (m) => process.stdout.write(m + '\n');
         w('');
@@ -1261,7 +1271,8 @@ if (isWin) {
     try {
       const rtk2 = require(path.join(ROOT, 'scripts', 'rtk', 'index.js'));
       const targetIdx = args.indexOf('--target');
-      const target = targetIdx >= 0 && args[targetIdx + 1] ? args[targetIdx + 1] : 'claude-code';
+      const rawTarget = targetIdx >= 0 && args[targetIdx + 1] ? args[targetIdx + 1] : 'claude-code';
+      const target = rtk2.normalizeTarget(rawTarget);
       const skillsDir = getTargetSkillsDir(target);
       const cmdsDir   = getTargetCommandsDir(target);
       if (skillsDir && cmdsDir) {

package/install.sh

@@ -233,7 +233,7 @@ HOME_DIR="$HOME"
 WINDSURFRULES_DEST=""  # only set for windsurf targets
 
 case "$TARGET" in
-  claude-home)
+  claude-home|claude-code)
     DEST="$HOME_DIR/.claude"
     AGENTS_DEST="$DEST/agents"
     SKILLS_DEST="$DEST/skills"
@@ -361,7 +361,7 @@ case "$TARGET" in
     ;;
   *)
     echo -e "${RED}Unknown target: $TARGET${RESET}"
-    echo "Valid targets: claude-home, antigravity, cursor-project, windsurf-project, windsurf-home, codex-home, opencode, cline, roocode, aider, kimi, gemini-project, gemini-home"
+    echo "Valid targets: claude-home (aka claude-code), antigravity, cursor-project, windsurf-project, windsurf-home, codex-home, opencode, cline, roocode, aider, kimi, gemini-project, gemini-home"
     exit 1
     ;;
 esac
@@ -375,8 +375,12 @@ fi
 echo ""
 
 # ── Confirm ───────────────────────────────────────────────────────────────────
-if [[ -e /dev/tty ]]; then
-  read -r -p "$(echo -e "${YELLOW}Proceed with install? [Y/n] ${RESET}")" CONFIRM </dev/tty
+# Honour KODELYTH_NONINTERACTIVE=1 for CI, npx pipes, and Windows powershell path.
+if [[ "${KODELYTH_NONINTERACTIVE:-}" == "1" ]]; then
+  CONFIRM="Y"
+  echo -e "${CYAN}  Non-interactive mode (KODELYTH_NONINTERACTIVE=1) — proceeding.${RESET}"
+elif [[ -e /dev/tty ]] && [[ -r /dev/tty ]]; then
+  read -r -p "$(echo -e "${YELLOW}Proceed with install? [Y/n] ${RESET}")" CONFIRM </dev/tty || CONFIRM="Y"
   CONFIRM="${CONFIRM:-Y}"
 else
   CONFIRM="Y"
@@ -476,7 +480,7 @@ echo -e "${BOLD}Installing components...${RESET}"
 echo ""
 
 case "$TARGET" in
-  claude-home)
+  claude-home|claude-code)
     install_dir  "$SCRIPT_DIR/agents"         "$AGENTS_DEST"            "Agents   ($AGENT_COUNT)"
     install_dir  "$SCRIPT_DIR/skills"         "$SKILLS_DEST"            "Skills   ($SKILL_COUNT)"
     install_dir  "$SCRIPT_DIR/commands"       "$COMMANDS_DEST"          "Commands ($CMD_COUNT)"
@@ -685,7 +689,7 @@ echo -e "${GREEN}${BOLD}  ARMED AND OPERATIONAL.${RESET}"
 echo ""
 
 case "$TARGET" in
-  claude-home)
+  claude-home|claude-code)
     echo -e "${BOLD}  Claude Code — what to do now:${RESET}"
     echo ""
     echo "  Open any project in Claude Code, then:"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kodelyth-ecc",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "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.",
   "author": "Kodelyth <github.com/sifxprime>",
   "license": "MIT",

package/scripts/rtk/index.js

@@ -18,9 +18,10 @@ const fs   = require('fs');
 
 // ── ECC install target → RTK agent flag ──────────────────────────────────────
 // Reference: `rtk init --help` and RTK README "Supported AI Tools" table.
+// Keyed by canonical install.sh target names (claude-home, gemini-home, ...).
+// Common aliases (claude-code, gemini-cli) are normalised in normalizeTarget().
 const TARGET_MAP = {
-  'claude-code':      ['init', '-g'],
-  'cursor':           ['init', '-g', '--agent', 'cursor'],
+  'claude-home':      ['init', '-g'],
   'cursor-project':   ['init',       '--agent', 'cursor'],
   'windsurf-home':    ['init', '-g', '--agent', 'windsurf'],
   'windsurf-project': ['init',       '--agent', 'windsurf'],
@@ -28,22 +29,32 @@ const TARGET_MAP = {
   'codex-home':       ['init', '-g', '--codex'],
   'opencode':         ['init', '-g', '--opencode'],
   'cline':            ['init',       '--agent', 'cline'],
-  'gemini-cli':       ['init', '-g', '--gemini'],
+  'gemini-home':      ['init', '-g', '--gemini'],
+  'roocode':          ['init',       '--agent', 'cline'],   // roocode is cline-compatible per RTK
+  'kimi':             ['init', '-g'],                        // treat like claude-code hook
 };
 
+// Normalise well-known aliases → canonical target names used by install.sh.
+function normalizeTarget(t) {
+  if (t === 'claude-code') return 'claude-home';
+  if (t === 'gemini-cli')  return 'gemini-home';
+  if (t === 'cursor')      return 'cursor-project';
+  return t;
+}
+
 // ── Detect which IDEs ECC has already been installed for on this machine ─────
 // Returns list of ECC install-target strings that have visible ECC artifacts.
 function detectInstalledTargets() {
   const home = os.homedir();
   const targets = [];
   const checks = [
-    { target: 'claude-code',      dir: path.join(home, '.claude', 'agents') },
-    { target: 'cursor',           dir: path.join(home, '.cursor', 'rules') },
+    { target: 'claude-home',      dir: path.join(home, '.claude', 'agents') },
+    { target: 'cursor-project',   dir: path.join(home, '.cursor', 'rules') },
     { target: 'windsurf-home',    dir: path.join(home, '.codeium', 'windsurf', 'memories') },
     { target: 'antigravity',      dir: path.join(home, '.antigravity') },
     { target: 'codex-home',       dir: path.join(home, '.codex') },
     { target: 'opencode',         dir: path.join(home, '.config', 'opencode') },
-    { target: 'gemini-cli',       dir: path.join(home, '.gemini') },
+    { target: 'gemini-home',      dir: path.join(home, '.gemini') },
   ];
   for (const { target, dir } of checks) {
     try {
@@ -116,15 +127,16 @@ function enableFor(target, { log = () => {} } = {}) {
   if (!isInstalled()) {
     return { enabled: false, skipped: true, reason: 'rtk binary not on PATH' };
   }
-  const rtkArgs = TARGET_MAP[target];
+  const canonical = normalizeTarget(target);
+  const rtkArgs = TARGET_MAP[canonical];
   if (!rtkArgs) {
     return { enabled: false, skipped: true, reason: `no RTK mapping for target "${target}"` };
   }
 
-  log(`[rtk] wiring RTK into ${target} …`);
+  log(`[rtk] wiring RTK into ${canonical} …`);
   // --auto-patch is only accepted by the default Claude Code hook flow.
   // Other agent flags (--codex, --gemini, --opencode, --agent X) reject it.
-  const finalArgs = target === 'claude-code' ? [...rtkArgs, '--auto-patch'] : rtkArgs;
+  const finalArgs = canonical === 'claude-home' ? [...rtkArgs, '--auto-patch'] : rtkArgs;
   const r = spawnSync('rtk', finalArgs, { encoding: 'utf8' });
   const output = (r.stdout || '') + (r.stderr || '');
   if (r.status !== 0) {
@@ -175,6 +187,7 @@ function savings({ days = 30 } = {}) {
 
 module.exports = {
   TARGET_MAP,
+  normalizeTarget,
   detectInstalledTargets,
   isInstalled,
   getVersion,