kodelyth-ecc 1.5.9 → 1.7.0

package/hooks/safety/token-budget.js

@@ -0,0 +1,229 @@
+#!/usr/bin/env node
+// =============================================================================
+// Kodelyth ECC — Token Budget Enforcer
+//
+// A safety hook that tracks per-session token usage and blocks new turns once
+// a configurable budget is exceeded. Wires into:
+//
+//   - Stop          (after each AI response — accumulate usage, write state)
+//   - SessionStart  (before each new turn — block if budget already exhausted)
+//
+// Token estimation:
+//   Hooks don't get authoritative token counts from the platform, so we use
+//   a 4-chars-per-token heuristic over the visible transcript path supplied
+//   in the Stop payload (transcript_path). On UserPromptSubmit we also count
+//   the user message; on PostToolUse we count the tool response.
+//
+// Modes (env var KODELYTH_TOKEN_BUDGET):
+//   off        — never run (default if unset)
+//   warn       — exit 0; write usage to stderr; never block
+//   <number>   — hard budget in tokens (e.g. 200000). Warns at WARN_AT_PCT.
+//                Blocks SessionStart once usage >= budget.
+//
+// Optional knobs:
+//   KODELYTH_TOKEN_BUDGET_DIR=/custom/path   default ~/.kodelyth/safety
+//   KODELYTH_TOKEN_BUDGET_WARN=0.7           warn threshold (0-1, default 0.7)
+//   KODELYTH_TOKEN_BUDGET_RESET=1            wipe usage and exit (admin op)
+//
+// Always exits 0 on internal errors so the hook never blocks accidentally.
+// =============================================================================
+
+'use strict';
+
+const fs   = require('fs');
+const os   = require('os');
+const path = require('path');
+
+const RAW_BUDGET = String(process.env.KODELYTH_TOKEN_BUDGET || 'off').toLowerCase();
+const WARN_PCT   = Math.max(0, Math.min(1, Number(process.env.KODELYTH_TOKEN_BUDGET_WARN) || 0.7));
+const RESET      = !!process.env.KODELYTH_TOKEN_BUDGET_RESET;
+
+const STATE_DIR = process.env.KODELYTH_TOKEN_BUDGET_DIR
+  || path.join(os.homedir(), '.kodelyth', 'safety');
+
+function safeExit(code) {
+  try { process.stdout.write(''); } catch {}
+  process.exit(code);
+}
+
+function readStdinSync() {
+  try {
+    const chunks = [];
+    const tmp = Buffer.alloc(64 * 1024);
+    while (true) {
+      let n;
+      try { n = fs.readSync(0, tmp, 0, tmp.length, null); }
+      catch { break; }
+      if (!n) break;
+      chunks.push(Buffer.from(tmp.subarray(0, n)));
+    }
+    return Buffer.concat(chunks).toString('utf8');
+  } catch {
+    return '';
+  }
+}
+
+function loadState(sessionId) {
+  try {
+    const file = path.join(STATE_DIR, `budget-${sessionId}.json`);
+    if (!fs.existsSync(file)) return { tokens: 0, turns: 0 };
+    return JSON.parse(fs.readFileSync(file, 'utf8'));
+  } catch {
+    return { tokens: 0, turns: 0 };
+  }
+}
+
+function saveState(sessionId, state) {
+  try {
+    fs.mkdirSync(STATE_DIR, { recursive: true });
+    const file = path.join(STATE_DIR, `budget-${sessionId}.json`);
+    fs.writeFileSync(file, JSON.stringify(state, null, 2));
+  } catch { /* never block on persistence */ }
+}
+
+function resetState(sessionId) {
+  try {
+    const file = path.join(STATE_DIR, `budget-${sessionId}.json`);
+    if (fs.existsSync(file)) fs.unlinkSync(file);
+  } catch {}
+}
+
+// ── Token estimation ─────────────────────────────────────────────────────────
+// Rough heuristic — 1 token ≈ 4 characters. Good enough for budget guards.
+function estimateTokensFromChars(s) {
+  if (typeof s !== 'string' || !s) return 0;
+  return Math.ceil(s.length / 4);
+}
+
+function estimateTokensFromTranscript(transcriptPath) {
+  if (!transcriptPath || typeof transcriptPath !== 'string') return 0;
+  try {
+    if (!fs.existsSync(transcriptPath)) return 0;
+    const stat = fs.statSync(transcriptPath);
+    // Each transcript line is JSON with `text` fields. We approximate by
+    // file size (proxy for transcript length); rough but stable.
+    return Math.ceil(stat.size / 4);
+  } catch {
+    return 0;
+  }
+}
+
+function parseBudget() {
+  if (RAW_BUDGET === 'off') return { mode: 'off', limit: 0 };
+  if (RAW_BUDGET === 'warn') return { mode: 'warn', limit: 0 };
+  const n = Number(RAW_BUDGET);
+  if (Number.isFinite(n) && n > 0) return { mode: 'block', limit: Math.floor(n) };
+  return { mode: 'off', limit: 0 };
+}
+
+// ── Main ─────────────────────────────────────────────────────────────────────
+function main() {
+  const cfg = parseBudget();
+  if (cfg.mode === 'off') return safeExit(0);
+
+  let raw = '';
+  try { raw = readStdinSync(); } catch { return safeExit(0); }
+
+  let payload = null;
+  try { payload = raw ? JSON.parse(raw) : null; } catch { payload = null; }
+
+  // Echo stdin so chained hooks still see it.
+  if (raw) process.stdout.write(raw);
+  if (!payload) return safeExit(0);
+
+  const sessionId =
+    payload.session_id ||
+    payload.sessionId  ||
+    process.env.CLAUDE_SESSION_ID ||
+    'default';
+
+  if (RESET) {
+    resetState(sessionId);
+    process.stderr.write(`[Kodelyth Safety] token-budget reset for session ${sessionId}\n`);
+    return safeExit(0);
+  }
+
+  const event = payload.hook_event_name || '';
+
+  // ── SessionStart: pre-check, block if already over ─────────────────────────
+  if (/SessionStart/i.test(event)) {
+    const state = loadState(sessionId);
+    if (cfg.mode === 'block' && state.tokens >= cfg.limit) {
+      process.stderr.write(
+        `\n[Kodelyth Safety] BLOCKED — session token budget exhausted.\n` +
+        `  session=${sessionId}\n` +
+        `  used=${state.tokens.toLocaleString()} tokens\n` +
+        `  budget=${cfg.limit.toLocaleString()} tokens\n` +
+        `  • Reset with KODELYTH_TOKEN_BUDGET_RESET=1.\n` +
+        `  • Raise budget via KODELYTH_TOKEN_BUDGET=<larger number>.\n` +
+        `  • Disable entirely via KODELYTH_TOKEN_BUDGET=off.\n\n`
+      );
+      return safeExit(2);
+    }
+    if (cfg.mode === 'warn' || cfg.mode === 'block') {
+      process.stderr.write(
+        `[Kodelyth Safety] token-budget — session=${sessionId} ` +
+        `used=${state.tokens.toLocaleString()} ` +
+        (cfg.mode === 'block' ? `budget=${cfg.limit.toLocaleString()}` : '(warn-only)') +
+        `\n`
+      );
+    }
+    return safeExit(0);
+  }
+
+  // ── Stop: accumulate usage from transcript path ────────────────────────────
+  if (/Stop/i.test(event) || event === 'PostToolUse' || event === 'UserPromptSubmit' || event === '') {
+    const state = loadState(sessionId);
+    let added = 0;
+    if (typeof payload.prompt === 'string')        added += estimateTokensFromChars(payload.prompt);
+    if (typeof payload.user_message === 'string')  added += estimateTokensFromChars(payload.user_message);
+    if (typeof payload.message === 'string')       added += estimateTokensFromChars(payload.message);
+    if (payload.transcript_path)                   added  = Math.max(added, estimateTokensFromTranscript(payload.transcript_path));
+    if (payload.tool_response) {
+      try { added += estimateTokensFromChars(JSON.stringify(payload.tool_response)); } catch {}
+    }
+    if (added > 0) {
+      state.tokens = (state.tokens || 0) + added;
+      state.turns  = (state.turns  || 0) + 1;
+      state.last_updated = new Date().toISOString();
+      saveState(sessionId, state);
+    }
+
+    if (cfg.mode === 'block') {
+      const pct = state.tokens / cfg.limit;
+      if (pct >= 1) {
+        process.stderr.write(
+          `\n[Kodelyth Safety] token-budget EXCEEDED — ` +
+          `used=${state.tokens.toLocaleString()} budget=${cfg.limit.toLocaleString()}. ` +
+          `Next SessionStart will be blocked. Use KODELYTH_TOKEN_BUDGET_RESET=1 to clear.\n`
+        );
+      } else if (pct >= WARN_PCT) {
+        process.stderr.write(
+          `[Kodelyth Safety] token-budget at ${(pct * 100).toFixed(0)}% — ` +
+          `used=${state.tokens.toLocaleString()} budget=${cfg.limit.toLocaleString()}\n`
+        );
+      }
+    } else {
+      process.stderr.write(
+        `[Kodelyth Safety] token-budget (warn) — session=${sessionId} ` +
+        `used=${state.tokens.toLocaleString()} added=${added.toLocaleString()}\n`
+      );
+    }
+  }
+
+  return safeExit(0);
+}
+
+if (require.main === module) {
+  try { main(); } catch { safeExit(0); }
+}
+
+module.exports = {
+  // Exposed for tests
+  estimateTokensFromChars,
+  estimateTokensFromTranscript,
+  parseBudget,
+  loadState,
+  saveState,
+  resetState,
+};

package/install.ps1

@@ -13,15 +13,42 @@
 
 param(
     [string]$Target = "claude-home",
+    [string]$Bundle = "",
     [string[]]$Languages = @()
 )
 
 $ErrorActionPreference = "Stop"
 
+# ── Bundle handling (audience-tailored cheat sheets) ─────────────────────────
+if ($Bundle) {
+    switch ($Bundle.ToLower()) {
+        { $_ -in "indie-hacker","indie" } {
+            $Bundle = "indie-hacker"
+            $Languages += @("typescript","python")
+            Write-Host "Bundle: Indie Hacker -> ship-fast workflow + TS/Python" -ForegroundColor Cyan
+        }
+        { $_ -in "red-team","redteam","security" } {
+            $Bundle = "red-team"
+            $Languages += @("typescript","python")
+            Write-Host "Bundle: Red Team -> adversarial mindset + devil-mode crew" -ForegroundColor Cyan
+        }
+        { $_ -in "enterprise","compliance" } {
+            $Bundle = "enterprise"
+            $Languages += @("typescript","java","python")
+            Write-Host "Bundle: Enterprise -> compliance + audit + supply chain" -ForegroundColor Cyan
+        }
+        default {
+            Write-Host "Unknown bundle: $Bundle" -ForegroundColor Red
+            Write-Host "Available bundles: indie-hacker, red-team, enterprise"
+            exit 1
+        }
+    }
+}
+
 # ── Banner ────────────────────────────────────────────────────────────────────
 Write-Host ""
 Write-Host "  Kodelyth ECC — Production-grade AI coding agent toolkit" -ForegroundColor Cyan
-Write-Host "  62 agents · 188 skills · 90 commands · 20+ hooks · intent routing · local memory" -ForegroundColor Gray
+Write-Host "  70 agents (8 devil-mode) · 194 skills · 97 commands · 22+ hooks · intent routing · local memory" -ForegroundColor Gray
 Write-Host ""
 
 $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
@@ -86,9 +113,57 @@ switch ($Target) {
         $HooksDest    = ""
         $RulesDest    = "$Dest\rules"
     }
+    "cline" {
+        $Dest         = "$(Get-Location)\.clinerules"
+        $AgentsDest   = ""
+        $SkillsDest   = ""
+        $CommandsDest = ""
+        $HooksDest    = ""
+        $RulesDest    = $Dest
+    }
+    "roocode" {
+        $Dest         = "$(Get-Location)\.roo"
+        $AgentsDest   = "$Dest\agents"
+        $SkillsDest   = "$Dest\skills"
+        $CommandsDest = "$Dest\commands"
+        $HooksDest    = ""
+        $RulesDest    = "$Dest\rules"
+    }
+    "aider" {
+        $Dest         = "$(Get-Location)\.aider-ecc"
+        $AgentsDest   = "$Dest\agents"
+        $SkillsDest   = "$Dest\skills"
+        $CommandsDest = "$Dest\commands"
+        $HooksDest    = ""
+        $RulesDest    = "$Dest\rules"
+    }
+    "kimi" {
+        $Dest         = "$(Get-Location)\.kimi"
+        $AgentsDest   = "$Dest\agents"
+        $SkillsDest   = "$Dest\skills"
+        $CommandsDest = "$Dest\commands"
+        $HooksDest    = ""
+        $RulesDest    = "$Dest\rules"
+    }
+    "gemini-project" {
+        $Dest         = "$(Get-Location)\.gemini"
+        $AgentsDest   = "$Dest\agents"
+        $SkillsDest   = "$Dest\skills"
+        $CommandsDest = ""
+        $HooksDest    = ""
+        $RulesDest    = "$Dest\rules"
+    }
+    "gemini-home" {
+        $Dest         = "$HomeDir\.gemini"
+        $AgentsDest   = "$Dest\agents"
+        $SkillsDest   = "$Dest\skills"
+        $CommandsDest = ""
+        $HooksDest    = ""
+        $RulesDest    = "$Dest\rules"
+    }
     default {
         Write-Host "Unknown target: $Target" -ForegroundColor Red
-        Write-Host "Valid targets: claude-home, windsurf-project, windsurf-home, antigravity, cursor-project, codex-home, opencode"
+        Write-Host "Valid targets: claude-home, windsurf-project, windsurf-home, antigravity, cursor-project, codex-home, opencode, cline, roocode, aider, kimi, gemini-project, gemini-home"
         exit 1
     }
 }
@@ -198,6 +273,80 @@ switch ($Target) {
     "opencode" {
         Install-Flat "$ScriptDir\rules"    $RulesDest    "Rules"
     }
+    "cline" {
+        Install-Flat "$ScriptDir\rules"    $RulesDest    "Rules"
+        Install-Flat "$ScriptDir\agents"   $RulesDest    "Agents (flattened)"
+        Install-Flat "$ScriptDir\commands" $RulesDest    "Commands (flattened)"
+    }
+    "roocode" {
+        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents   ($AgentCount)"
+        Install-Dir  "$ScriptDir\skills"   $SkillsDest   "Skills   ($SkillCount)"
+        Install-Dir  "$ScriptDir\commands" $CommandsDest "Commands ($CmdCount)"
+        Install-Flat "$ScriptDir\rules"    $RulesDest    "Rules"
+    }
+    "aider" {
+        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents   ($AgentCount)"
+        Install-Dir  "$ScriptDir\skills"   $SkillsDest   "Skills   ($SkillCount)"
+        Install-Dir  "$ScriptDir\commands" $CommandsDest "Commands ($CmdCount)"
+        Install-Flat "$ScriptDir\rules"    $RulesDest    "Rules"
+        $ConventionsFile = "$(Get-Location)\CONVENTIONS.md"
+        if (-not (Test-Path $ConventionsFile)) {
+            $aiderText = @'
+# Project Conventions (Aider)
+
+This project uses **Kodelyth ECC** for AI agent guidance.
+
+Aider auto-loads this file. To bring full ECC context, run Aider with:
+
+    aider --read .aider-ecc/rules/agent-intent-routing.md
+    aider --read .aider-ecc/rules/coding-standards.md
+    aider --read .aider-ecc/agents/debug-detective.md
+
+Full catalog: `.aider-ecc/agents/`, `.aider-ecc/skills/`, `.aider-ecc/commands/`, `.aider-ecc/rules/`.
+
+Powered by Kodelyth ECC — github.com/sifxprime/kodelyth-ecc
+'@
+            $aiderText | Out-File -FilePath $ConventionsFile -Encoding UTF8
+            Write-Host "  [OK] CONVENTIONS.md -> $ConventionsFile" -ForegroundColor Green
+        } else {
+            Write-Host "  [skip] CONVENTIONS.md exists — not overwriting" -ForegroundColor Yellow
+        }
+    }
+    "kimi" {
+        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents   ($AgentCount)"
+        Install-Dir  "$ScriptDir\skills"   $SkillsDest   "Skills   ($SkillCount)"
+        Install-Dir  "$ScriptDir\commands" $CommandsDest "Commands ($CmdCount)"
+        Install-Flat "$ScriptDir\rules"    $RulesDest    "Rules"
+    }
+    { $_ -in "gemini-project","gemini-home" } {
+        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents   ($AgentCount)"
+        Install-Dir  "$ScriptDir\skills"   $SkillsDest   "Skills   ($SkillCount)"
+        Install-Flat "$ScriptDir\rules"    $RulesDest    "Rules"
+        $GeminiFile = "$Dest\GEMINI.md"
+        if (-not (Test-Path $GeminiFile)) {
+            $geminiText = @'
+# Kodelyth ECC — Gemini CLI context
+
+This project uses Kodelyth ECC — 70 specialist agents, 194 skills, 97 commands, intent routing, and self-learning memory.
+
+The full toolkit is installed under this directory:
+
+- agents/ — specialist subagents (debug-detective, security-reviewer, devil-mode crew)
+- skills/ — domain knowledge files
+- rules/ — always-on coding standards + intent routing rule
+
+For more: github.com/sifxprime/kodelyth-ecc
+'@
+            $geminiText | Out-File -FilePath $GeminiFile -Encoding UTF8
+            Write-Host "  [OK] GEMINI.md -> $GeminiFile" -ForegroundColor Green
+        }
+    }
+}
+
+# ── Install bundle cheat sheet (if -Bundle was set) ───────────────────────────
+if ($Bundle -and (Test-Path "$ScriptDir\bundles\$Bundle.md")) {
+    Copy-Item -Path "$ScriptDir\bundles\$Bundle.md" -Destination "$Dest\BUNDLE.md" -Force
+    Write-Host "  [OK] Bundle cheat sheet ($Bundle) -> $Dest\BUNDLE.md" -ForegroundColor Green
 }
 
 # ── Write install state ───────────────────────────────────────────────────────
@@ -207,12 +356,35 @@ $State = @{
     installed_by = "kodelyth-ecc"
     version      = $Version.Trim()
     target       = $Target
+    bundle       = $Bundle
     installed_at = (Get-Date -Format "yyyy-MM-ddTHH:mm:ssZ")
     languages    = $Languages
 } | ConvertTo-Json
 $State | Out-File -FilePath $StateFile -Encoding UTF8
 Write-Host "  [OK] Install state -> $StateFile" -ForegroundColor Green
 
+# ── Bundle-specific reminder ──────────────────────────────────────────────────
+if ($Bundle) {
+    Write-Host ""
+    switch ($Bundle) {
+        "indie-hacker" {
+            Write-Host "  Bundle: Indie Hacker is active." -ForegroundColor Cyan
+            Write-Host "  Lead with: /project-launch (new) | /tdd | /devil-mode --pre-public (before going public)"
+            Write-Host "  Read: $Dest\BUNDLE.md for the full ship-fast playbook."
+        }
+        "red-team" {
+            Write-Host "  Bundle: Red Team is active." -ForegroundColor Red
+            Write-Host "  Lead with: /devil-mode (4-agent sweep) | /devil-mode --all (full 8-agent crew)"
+            Write-Host "  Read: $Dest\BUNDLE.md for the adversarial workflow playbook."
+        }
+        "enterprise" {
+            Write-Host "  Bundle: Enterprise is active." -ForegroundColor Cyan
+            Write-Host "  Lead with: /team-review (per-PR) | /pre-release (per-tag) | /devil-mode --pre-launch"
+            Write-Host "  Read: $Dest\BUNDLE.md for the compliance + audit playbook."
+        }
+    }
+}
+
 # ── Done ──────────────────────────────────────────────────────────────────────
 Write-Host ""
 Write-Host "Kodelyth ECC installed successfully!" -ForegroundColor Green
@@ -248,6 +420,31 @@ switch ($Target) {
         Write-Host "  1. Open the project in OpenCode"
         Write-Host "  2. Rules in .opencode/rules/ are now loaded"
     }
+    "cline" {
+        Write-Host "  1. Open the project in VS Code with Cline"
+        Write-Host "  2. .clinerules/ auto-loaded by Cline"
+        Write-Host "  3. Ask: 'use debug-detective' or 'devil mode the codebase'"
+    }
+    "roocode" {
+        Write-Host "  1. Open the project in VS Code with Roo Code"
+        Write-Host "  2. Rules + agents auto-loaded from .roo/"
+        Write-Host "  3. Ask: 'use kodelyth-advisor'"
+    }
+    "aider" {
+        Write-Host "  1. CONVENTIONS.md created at project root"
+        Write-Host "  2. Run: aider --read .aider-ecc/rules/agent-intent-routing.md"
+        Write-Host "  3. Then describe your problem in plain words"
+    }
+    "kimi" {
+        Write-Host "  1. Open the project with Kimi CLI"
+        Write-Host "  2. Agents/skills/rules in .kimi/"
+        Write-Host "  3. Ask: 'use kodelyth-advisor'"
+    }
+    { $_ -in "gemini-project","gemini-home" } {
+        Write-Host "  1. Run Gemini CLI"
+        Write-Host "  2. GEMINI.md auto-loaded from $Dest"
+        Write-Host "  3. Ask: 'use debug-detective'"
+    }
     default {
         Write-Host "  1. Restart your AI coding agent"
         Write-Host "  2. Agents, skills, and rules are now active"