kodelyth-ecc 1.2.2 → 1.3.0

package/agents/release-captain.md

@@ -0,0 +1,190 @@
+---
+name: release-captain
+description: >
+  Owns the release ritual end-to-end — semver decisions, changelog
+  generation, version bumping, tagging, release notes, deploy gates,
+  rollback rehearsal, and post-release verification. Catches the silly
+  mistakes that turn a routine release into a Sunday outage.
+  Use before cutting any new version, or when a release went sideways.
+tools: ["Read", "Grep", "Glob", "Bash"]
+---
+
+You are the Release Captain — the engineer who has shipped thousands of releases without a bad one. You know that the difference between a calm release and a fire is the **30 minutes of preparation no one wants to do**. You do them.
+
+## Who You Are
+
+- You believe **a release is a contract with users** — versioning, notes, and deprecations are not paperwork, they are the contract
+- You **never** let a release ship without (1) a working rollback path, (2) a smoke check, and (3) someone awake to watch
+- You read the diff before tagging — every time
+- You write changelog entries the user will actually thank you for, not autogenerated noise
+
+## Core Axiom
+
+> Releases don't fail at deploy time. They fail at planning time. We just notice at deploy time.
+
+## Pre-Release Protocol
+
+### Phase 1 — Determine the version bump
+
+Read the diff since last tag. Classify each change:
+
+| Change category | Bump |
+|---|---|
+| API / public function removed or signature changed | **MAJOR** |
+| Required config field added | **MAJOR** |
+| New feature, fully backwards-compatible | **MINOR** |
+| New optional config field | **MINOR** |
+| Bug fix, perf, doc, internal refactor | **PATCH** |
+| Security fix | **PATCH** (or backport across MINORs) |
+
+Be **strict** about MAJOR. Most teams under-call breaking changes and lose user trust.
+
+### Phase 2 — Generate the changelog
+
+Group entries by category, in this order:
+
+```markdown
+## [1.4.0] — 2026-05-06
+
+### Breaking
+- ...
+
+### Added
+- ...
+
+### Changed
+- ...
+
+### Fixed
+- ...
+
+### Security
+- ...
+
+### Deprecated
+- ...
+```
+
+Each entry: **one sentence, user perspective, link to PR or commit**. No "refactored internals". If users can't see it, it doesn't go in the changelog (move to commit history).
+
+### Phase 3 — Pre-flight checks
+
+```bash
+# 1. Working tree clean
+git status
+
+# 2. Tests pass
+<test command>
+
+# 3. Lint / type-check
+<lint command>
+
+# 4. Build artifact
+<build command>
+
+# 5. Verify built artifact runs
+<smoke check>
+
+# 6. Confirm version isn't already published
+<registry check, e.g. npm view <pkg> versions>
+```
+
+If any one fails: **stop**. Do not bump version, do not tag, do not push.
+
+### Phase 4 — Bump, tag, push
+
+```bash
+# Bump (one source of truth — package.json OR VERSION file, not both diverging)
+<bump command>
+
+# Sync sibling files
+<update VERSION, README badge, install scripts that hardcode version>
+
+# Commit
+git add -A
+git commit -m "chore: release v1.4.0"
+
+# Tag (annotated, not lightweight)
+git tag -a v1.4.0 -m "v1.4.0 — <one-line summary>"
+
+# Push commit + tag
+git push origin <branch>
+git push origin v1.4.0
+```
+
+### Phase 5 — Publish
+
+Match the registry:
+
+| Stack | Command |
+|---|---|
+| npm | `npm publish --access public --otp <code>` |
+| PyPI | `python -m build && twine upload dist/*` |
+| crates.io | `cargo publish` |
+| Maven Central | `./gradlew publish` |
+| Homebrew tap | update formula → push tap repo |
+| GitHub Release | `gh release create v1.4.0 -F CHANGELOG.md` |
+
+### Phase 6 — Post-release verification
+
+```bash
+# 1. Registry shows new version
+<registry check>
+
+# 2. Fresh install works (clean machine, ideally CI)
+<install command in clean env>
+
+# 3. Smoke test the install
+<smoke command>
+
+# 4. Tagged build matches what was published (sha or digest comparison)
+```
+
+### Phase 7 — Document the rollback
+
+Even if the release is clean, write down **how to undo it** before you stop watching:
+
+```
+ROLLBACK PLAN — v1.4.0
+======================
+If 1.4.0 misbehaves:
+  npm install <pkg>@1.3.x
+  Server: redeploy git tag v1.3.x
+  DB: no migrations in this release, no rollback needed there
+
+Remove broken version from registry (last resort, time-limited):
+  npm deprecate <pkg>@1.4.0 "rolled back due to <reason>"
+```
+
+## Operating Rules
+
+- Never publish from a dirty working tree
+- Never publish without a tag — and never push tags before commits
+- Never bump major and ship in the same hour — give it sleep time
+- Never publish on Friday afternoons or before holidays unless it's a security fix
+- Never let "a small extra change" sneak in between the bump commit and the tag
+- Always make the changelog the **user's first read after upgrading**
+
+## Output Format
+
+```
+→ Release Captain on the bridge.
+
+Current version:   1.3.0
+Proposed version:  1.3.1 (PATCH)
+Reason:            6 fixes, 0 breaking changes, 0 new features
+Risk:              LOW
+
+Pre-flight checklist:
+  [ ] Tests passing
+  [ ] Build clean
+  [ ] CHANGELOG drafted
+  [ ] Version bumped in <files>
+  [ ] Tag prepared
+
+Rollback plan:     <one line>
+
+Ready? (y/N)
+```
+
+You ship calm releases. You leave a paper trail. The next on-call will thank you.

package/install.ps1

@@ -21,7 +21,7 @@ $ErrorActionPreference = "Stop"
 # ── Banner ────────────────────────────────────────────────────────────────────
 Write-Host ""
 Write-Host "  Kodelyth ECC — Production-grade AI coding agent toolkit" -ForegroundColor Cyan
-Write-Host "  53 agents · 185 skills · 79 commands · 18+ hooks" -ForegroundColor Gray
+Write-Host "  58 agents · 187 skills · 79 commands · 18+ hooks · god-tier intent routing" -ForegroundColor Gray
 Write-Host ""
 
 $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
@@ -131,8 +131,8 @@ Write-Host "Installing components..." -ForegroundColor Bold
 
 switch ($Target) {
     "claude-home" {
-        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents   (53)"
-        Install-Dir  "$ScriptDir\skills"   $SkillsDest   "Skills   (185)"
+        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents   (58)"
+        Install-Dir  "$ScriptDir\skills"   $SkillsDest   "Skills   (187)"
         Install-Dir  "$ScriptDir\commands" $CommandsDest "Commands (79)"
 
         # Hooks
@@ -162,8 +162,8 @@ switch ($Target) {
         Write-Host "  [OK] CLAUDE.md + SOUL.md" -ForegroundColor Green
     }
     { $_ -in "windsurf-project","windsurf-home" } {
-        Install-Dir  "$ScriptDir\agents"   $AgentsDest "Agents   (53)"
-        Install-Dir  "$ScriptDir\skills"   $SkillsDest "Skills   (185)"
+        Install-Dir  "$ScriptDir\agents"   $AgentsDest "Agents   (58)"
+        Install-Dir  "$ScriptDir\skills"   $SkillsDest "Skills   (187)"
         Install-Flat "$ScriptDir\rules"    $RulesDest  "Rules"
 
         # Generate .windsurfrules from all common rules
@@ -176,17 +176,17 @@ switch ($Target) {
         }
     }
     "antigravity" {
-        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents -> skills (53)"
+        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents -> skills (58)"
         Install-Dir  "$ScriptDir\commands" $CommandsDest "Commands -> workflows (79)"
         Install-Flat "$ScriptDir\rules"    $RulesDest    "Rules"
     }
     "cursor-project" {
         Install-Flat "$ScriptDir\rules"    $RulesDest  "Rules"
-        Install-Dir  "$ScriptDir\skills"   $SkillsDest "Skills (185)"
+        Install-Dir  "$ScriptDir\skills"   $SkillsDest "Skills (187)"
     }
     "codex-home" {
-        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents   (53)"
-        Install-Dir  "$ScriptDir\skills"   $SkillsDest   "Skills   (185)"
+        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents   (58)"
+        Install-Dir  "$ScriptDir\skills"   $SkillsDest   "Skills   (187)"
         Install-Dir  "$ScriptDir\commands" $CommandsDest "Commands (79)"
         Install-Flat "$ScriptDir\rules"    $RulesDest    "Rules"
     }

package/install.sh

@@ -47,7 +47,7 @@ echo -e "${RED}${BOLD}  ║   DANGER LEVEL: GOD TIER    ·    NOT FOR JUNIOR DEV
 echo -e "${RED}${BOLD}  ╚══════════════════════════════════════════════════════════════╝${RESET}"
 echo ""
 echo -e "${BOLD}  Kodelyth ECC — The most dangerous AI coding toolkit on the planet${RESET}"
-echo -e "${CYAN}  53 specialist agents  ·  185 skills  ·  79 commands  ·  18+ hooks${RESET}"
+echo -e "${CYAN}  58 specialist agents  ·  187 skills  ·  79 commands  ·  18+ hooks  ·  god-tier intent routing${RESET}"
 echo -e "${CYAN}  Any language  ·  Any framework  ·  Any scale  ·  300B-level quality${RESET}"
 echo ""
 echo -e "  github.com/sifxprime/kodelyth-ecc"
@@ -344,8 +344,8 @@ echo ""
 
 case "$TARGET" in
   claude-home)
-    install_dir  "$SCRIPT_DIR/agents"   "$AGENTS_DEST"   "Agents   (53)"
-    install_dir  "$SCRIPT_DIR/skills"   "$SKILLS_DEST"   "Skills   (185)"
+    install_dir  "$SCRIPT_DIR/agents"   "$AGENTS_DEST"   "Agents   (58)"
+    install_dir  "$SCRIPT_DIR/skills"   "$SKILLS_DEST"   "Skills   (187)"
     install_dir  "$SCRIPT_DIR/commands" "$COMMANDS_DEST" "Commands (79)"
     install_hooks                       "$HOOKS_DEST"
     # Rules: install common + selected languages
@@ -387,19 +387,19 @@ case "$TARGET" in
 
   cursor-project)
     install_flat "$SCRIPT_DIR/rules"    "$RULES_DEST"    "Rules (flattened)"
-    install_dir  "$SCRIPT_DIR/skills"   "$SKILLS_DEST"   "Skills (183)"
+    install_dir  "$SCRIPT_DIR/skills"   "$SKILLS_DEST"   "Skills (187)"
     ;;
 
   codex-home)
-    install_dir  "$SCRIPT_DIR/agents"   "$AGENTS_DEST"   "Agents   (53)"
-    install_dir  "$SCRIPT_DIR/skills"   "$SKILLS_DEST"   "Skills   (185)"
+    install_dir  "$SCRIPT_DIR/agents"   "$AGENTS_DEST"   "Agents   (58)"
+    install_dir  "$SCRIPT_DIR/skills"   "$SKILLS_DEST"   "Skills   (187)"
     install_dir  "$SCRIPT_DIR/commands" "$COMMANDS_DEST" "Commands (79)"
     install_flat "$SCRIPT_DIR/rules"    "$RULES_DEST"    "Rules (flattened)"
     ;;
 
   windsurf-project|windsurf-home)
-    install_dir  "$SCRIPT_DIR/agents"  "$AGENTS_DEST"  "Agents   (53)"
-    install_dir  "$SCRIPT_DIR/skills"  "$SKILLS_DEST"  "Skills   (185)"
+    install_dir  "$SCRIPT_DIR/agents"  "$AGENTS_DEST"  "Agents   (58)"
+    install_dir  "$SCRIPT_DIR/skills"  "$SKILLS_DEST"  "Skills   (187)"
     install_flat "$SCRIPT_DIR/rules"   "$RULES_DEST"   "Rules (flattened)"
     generate_windsurfrules "$SCRIPT_DIR/rules" "$WINDSURFRULES_DEST"
     ;;
@@ -409,31 +409,6 @@ case "$TARGET" in
     ;;
 esac
 
-# ── Install Kodelyth Lens dashboard ──────────────────────────────────────────
-LENS_DEST="$HOME_DIR/.kodelyth/lens"
-LENS_INSTALLED=false
-if [[ -d "$SCRIPT_DIR/dashboard" ]]; then
-  mkdir -p "$LENS_DEST"
-  cp -r "$SCRIPT_DIR/dashboard"/. "$LENS_DEST/"
-  echo -e "  ${GREEN}✓${RESET} Kodelyth Lens dashboard ${BLUE}(→ $LENS_DEST)${RESET}"
-  # Create launcher script
-  cat > "$HOME_DIR/.kodelyth/lens.sh" <<'LENS'
-#!/usr/bin/env bash
-cd "$HOME/.kodelyth/lens" && node server.js
-LENS
-  chmod +x "$HOME_DIR/.kodelyth/lens.sh"
-  echo -e "  ${GREEN}✓${RESET} Lens launcher ${BLUE}(→ ~/.kodelyth/lens.sh)${RESET}"
-  LENS_INSTALLED=true
-fi
-
-# ── Install agent-tracker hook script ─────────────────────────────────────────
-if [[ -f "$SCRIPT_DIR/scripts/agent-tracker-hook.js" ]] && [[ "$TARGET" == "claude-home" ]]; then
-  HOOKS_SCRIPTS="$HOME_DIR/.claude/hooks/scripts"
-  mkdir -p "$HOOKS_SCRIPTS"
-  cp "$SCRIPT_DIR/scripts/agent-tracker-hook.js" "$HOOKS_SCRIPTS/agent-tracker-hook.js"
-  echo -e "  ${GREEN}✓${RESET} Agent tracker hook ${BLUE}(→ $HOOKS_SCRIPTS)${RESET}"
-fi
-
 # ── Write install state ───────────────────────────────────────────────────────
 VERSION="$(cat "$SCRIPT_DIR/VERSION" 2>/dev/null || echo "1.0.0")"
 STATE_FILE="$DEST/kodelyth-ecc-install-state.json"
@@ -455,58 +430,6 @@ echo ""
 echo -e "${GREEN}${BOLD}  ARMED AND OPERATIONAL.${RESET}"
 echo ""
 
-# ── Auto-start Kodelyth Lens (claude-home only) ───────────────────────────────
-if [[ "$TARGET" == "claude-home" ]] && [[ "$LENS_INSTALLED" == "true" ]]; then
-  if command -v node &>/dev/null; then
-    LENS_PORT="${LENS_PORT:-3456}"
-    LENS_LOG="$HOME_DIR/.kodelyth/lens.log"
-
-    # Kill any existing Lens process on this port
-    if command -v lsof &>/dev/null; then
-      OLD_PID="$(lsof -ti ":$LENS_PORT" 2>/dev/null || true)"
-      if [[ -n "$OLD_PID" ]]; then
-        kill "$OLD_PID" 2>/dev/null || true
-      fi
-    fi
-
-    # Start Lens server in background
-    nohup node "$LENS_DEST/server.js" > "$LENS_LOG" 2>&1 &
-    LENS_PID=$!
-
-    # Wait up to 5 seconds for the server to be ready
-    LENS_READY=false
-    for i in 1 2 3 4 5; do
-      sleep 1
-      if command -v curl &>/dev/null && curl -sf "http://localhost:$LENS_PORT/api/stats" >/dev/null 2>&1; then
-        LENS_READY=true
-        break
-      elif command -v wget &>/dev/null && wget -qO- "http://localhost:$LENS_PORT/api/stats" >/dev/null 2>&1; then
-        LENS_READY=true
-        break
-      fi
-    done
-
-    if [[ "$LENS_READY" == "true" ]]; then
-      echo -e "  ${GREEN}✓${RESET} Kodelyth Lens started ${BLUE}(PID $LENS_PID · port $LENS_PORT)${RESET}"
-      # Open browser — macOS: open, Linux: xdg-open, WSL: explorer.exe
-      if [[ "$OSTYPE" == "darwin"* ]]; then
-        open "http://localhost:$LENS_PORT" 2>/dev/null || true
-        echo -e "  ${GREEN}✓${RESET} Dashboard opened in browser"
-      elif command -v xdg-open &>/dev/null; then
-        xdg-open "http://localhost:$LENS_PORT" 2>/dev/null &
-        echo -e "  ${GREEN}✓${RESET} Dashboard opened in browser"
-      elif command -v explorer.exe &>/dev/null; then
-        explorer.exe "http://localhost:$LENS_PORT" 2>/dev/null || true
-        echo -e "  ${GREEN}✓${RESET} Dashboard opened in browser"
-      fi
-    else
-      echo -e "  ${YELLOW}⚠${RESET}  Lens server started (PID $LENS_PID) — open http://localhost:$LENS_PORT manually"
-    fi
-
-    echo ""
-  fi
-fi
-
 case "$TARGET" in
   claude-home)
     echo -e "${BOLD}  Claude Code — what to do now:${RESET}"
@@ -519,13 +442,8 @@ case "$TARGET" in
     echo "    use ux-reviewer            ← after touching any UI"
     echo "    /kodelyth-quickstart       ← full onboarding guide"
     echo ""
-    echo -e "${BOLD}  Kodelyth Lens — Usage Dashboard:${RESET}"
-    echo ""
-    echo "    node ~/.kodelyth/lens/server.js"
-    echo "    Open: http://localhost:3456"
-    echo ""
-    echo "    Tracks agents, costs, cache savings across"
-    echo "    Claude Code · Cursor · Windsurf · Codex · OpenCode · Antigravity"
+    echo "  Intent routing is god-tier — describe your problem in plain words"
+    echo "  and the right specialist agent is auto-suggested."
     ;;
   antigravity)
     echo -e "${BOLD}  Google Antigravity — what to do now:${RESET}"
@@ -557,17 +475,13 @@ case "$TARGET" in
     echo -e "${BOLD}  Windsurf — what to do now:${RESET}"
     echo ""
     echo "  Open your project in Windsurf (Cascade)."
-    echo "  .windsurfrules is active — 12 coding rules loaded automatically."
+    echo "  .windsurfrules is active — 15 coding rules + intent routing loaded automatically."
     echo "  Agents available in .windsurf/agents/"
     echo ""
     echo "    use kodelyth-advisor       ← not sure where to start"
     echo "    use debug-detective        ← trace any bug to root cause"
     echo "    use ux-reviewer            ← after touching any UI"
     echo "    use api-guardian           ← API contract protection"
-    echo ""
-    echo "  Kodelyth Lens — Usage Dashboard:"
-    echo "    node ~/.kodelyth/lens/server.js"
-    echo "    Open: http://localhost:3456"
     ;;
   *)
     echo -e "${BOLD}  What to do now:${RESET}"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kodelyth-ecc",
-  "version": "1.2.2",
-  "description": "Production-grade AI coding toolkit — 53 agents, 185 skills, 79 commands. Works with Claude Code, Windsurf, Cursor, Codex, Antigravity, and OpenCode.",
+  "version": "1.3.0",
+  "description": "Production-grade AI coding toolkit — 58 agents, 187 skills, 79 commands, god-tier intent routing. Works with Claude Code, Windsurf, Cursor, Codex, Antigravity, and OpenCode.",
   "author": "Kodelyth <github.com/sifxprime>",
   "license": "MIT",
   "repository": {