kodelyth-ecc 1.2.0 → 1.2.2

package/README.md

@@ -19,30 +19,42 @@ Works with **Claude Code**, **Google Antigravity**, **Cursor**, **Codex CLI**, a
 
 ## Install
 
-### Option 1 — npx (Node.js, any platform)
+### Option 1 — npx from npm (Node.js 18+, any platform)
 
-Requires Node.js 18+. No `git` needed — npx downloads directly from GitHub.
+The simplest install. Node.js is the only requirement.
 
 ```bash
-npx github:sifxprime/kodelyth-ecc
+npx kodelyth-ecc
 ```
 
 Install for a specific platform:
 
 ```bash
-npx github:sifxprime/kodelyth-ecc --target windsurf-project    # Windsurf (project)
-npx github:sifxprime/kodelyth-ecc --target windsurf-home       # Windsurf (global)
-npx github:sifxprime/kodelyth-ecc --target antigravity         # Google Antigravity
-npx github:sifxprime/kodelyth-ecc --target cursor-project      # Cursor IDE
-npx github:sifxprime/kodelyth-ecc --target codex-home          # Codex CLI
-npx github:sifxprime/kodelyth-ecc --target opencode            # OpenCode
+npx kodelyth-ecc --target windsurf-project    # Windsurf (project)
+npx kodelyth-ecc --target windsurf-home       # Windsurf (global)
+npx kodelyth-ecc --target antigravity         # Google Antigravity
+npx kodelyth-ecc --target cursor-project      # Cursor IDE
+npx kodelyth-ecc --target codex-home          # Codex CLI
+npx kodelyth-ecc --target opencode            # OpenCode
 ```
 
 > Node.js not installed? Download it from [nodejs.org](https://nodejs.org) — LTS version recommended.
 
 ---
 
-### Option 2 — curl (macOS / Linux)
+### Option 2 — npx from GitHub (always latest commit)
+
+Use this if you want the very latest unreleased version directly from the main branch.
+
+```bash
+npx github:sifxprime/kodelyth-ecc
+```
+
+Same `--target` flags apply.
+
+---
+
+### Option 3 — curl (macOS / Linux)
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/sifxprime/kodelyth-ecc/main/install.sh | bash
@@ -56,7 +68,7 @@ curl -fsSL https://raw.githubusercontent.com/sifxprime/kodelyth-ecc/main/install
 
 ---
 
-### Option 3 — clone and run (all platforms)
+### Option 4 — clone and run (all platforms)
 
 ```bash
 git clone https://github.com/sifxprime/kodelyth-ecc.git
@@ -67,8 +79,10 @@ cd kodelyth-ecc
 ./install.sh --target windsurf-project  # Windsurf
 ./install.sh --target antigravity       # Google Antigravity
 
-# Windows
+# Windows (PowerShell)
 .\install.ps1
+.\install.ps1 -Target windsurf-project
+.\install.ps1 -Target codex-home
 ```
 
 ---
@@ -138,7 +152,7 @@ PORT=3456                     # Dashboard port (default: 3456)
 | Skills | **185** | Domain knowledge — patterns, testing, security, DevOps |
 | Commands | **79** | Slash command workflows (`/tdd`, `/plan`, `/code-review`, etc.) |
 | Hooks | **15+** | Automated lifecycle triggers — quality gates, session memory, cost tracking |
-| Rules | **12** | Language-specific coding standards |
+| Rules | **15** | Language-specific coding standards |
 
 ---
 

package/VERSION

@@ -1 +1 @@
-1.2.0
+1.2.2

package/dashboard/lib/aggregator.js

@@ -68,6 +68,7 @@ export async function aggregateAll() {
     sessions:  allSessions.slice(0, 100),
     costs:     dailyCosts,
     platforms: platformStats,
+    windsurf:  { quotaData: windsurf.quotaData || null },
     updatedAt: new Date().toISOString(),
   };
 }

package/dashboard/lib/readers/windsurf-reader.js

@@ -1,126 +1,146 @@
 // Kodelyth Lens — Windsurf Reader
-// Reads Windsurf (Codeium) session logs
+// Reads Windsurf (Codeium) real quota data from state.vscdb SQLite databases
 // Part of Kodelyth ECC — github.com/sifxprime/kodelyth-ecc
 
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
+import fs                        from 'node:fs';
+import path                      from 'node:path';
+import os                        from 'node:os';
+import { execSync }              from 'node:child_process';
 import { detectAgentsInMessages } from '../agent-tracker.js';
 
 const HOME = os.homedir();
 
-export async function readWindsurfData(dataDir) {
-  const candidates = [
-    dataDir,
+// ── SQLite helpers (same pattern as codex-reader) ──────────────────────────────
+
+function sqlite3Available() {
+  try { execSync('sqlite3 --version', { stdio: 'pipe', timeout: 3000 }); return true; }
+  catch { return false; }
+}
+
+function querySqliteJson(dbPath, sql) {
+  try {
+    const raw = execSync(
+      `sqlite3 -json "${dbPath}" "${sql.replace(/"/g, '\\"')}"`,
+      { stdio: 'pipe', timeout: 5000, encoding: 'utf-8' }
+    ).trim();
+    return raw ? JSON.parse(raw) : [];
+  } catch { return []; }
+}
+
+function readDbKey(dbPath, key) {
+  const rows = querySqliteJson(dbPath, `SELECT value FROM ItemTable WHERE key='${key}'`);
+  if (!rows.length || !rows[0].value) return null;
+  try { return JSON.parse(rows[0].value); } catch { return rows[0].value; }
+}
+
+// ── Find Windsurf data directory ───────────────────────────────────────────────
+
+function findWindsurfDir(override) {
+  return [
+    override,
     process.env.WINDSURF_DIR,
     path.join(HOME, 'Library', 'Application Support', 'Windsurf'),
     path.join(HOME, 'AppData', 'Roaming', 'Windsurf'),
     path.join(HOME, '.codeium', 'windsurf'),
-    path.join(HOME, '.windsurf'),
-  ].filter(Boolean);
-
-  const windsurfDir = candidates.find(d => d && fs.existsSync(d));
-  if (!windsurfDir) return { sessions: [], available: false };
-
-  const sessions = [];
-
-  // Windsurf stores session data similar to VS Code extension
-  const storageDir = path.join(windsurfDir, 'User', 'workspaceStorage');
-  if (fs.existsSync(storageDir)) {
-    const wsDirs = fs.readdirSync(storageDir, { withFileTypes: true })
-      .filter(d => d.isDirectory())
-      .map(d => path.join(storageDir, d.name));
+  ].filter(Boolean).find(d => fs.existsSync(d)) || null;
+}
 
-    for (const ws of wsDirs) {
-      const session = parseWindsurfWorkspace(ws);
-      if (session) sessions.push(session);
-    }
-  }
+// ── Main reader ────────────────────────────────────────────────────────────────
 
-  // Check for Cascade conversation files
-  const cascadeDir = path.join(windsurfDir, 'cascade');
-  if (fs.existsSync(cascadeDir)) {
-    const jsonFiles = fs.readdirSync(cascadeDir).filter(f => f.endsWith('.json'));
-    for (const file of jsonFiles) {
-      try {
-        const session = parseCascadeFile(path.join(cascadeDir, file));
-        if (session) sessions.push(session);
-      } catch { /* skip */ }
+export async function readWindsurfData(dataDir) {
+  const windsurfDir = findWindsurfDir(dataDir);
+  if (!windsurfDir) return { sessions: [], available: false, quotaData: null };
+
+  const hasSqlite = sqlite3Available();
+  let quotaData   = null;
+
+  // ── 1. Read real quota / plan info from global state.vscdb ─────────────────
+  const globalDb = path.join(windsurfDir, 'User', 'globalStorage', 'state.vscdb');
+  if (hasSqlite && fs.existsSync(globalDb)) {
+    const plan = readDbKey(globalDb, 'windsurf.settings.cachedPlanInfo');
+    if (plan?.usage) {
+      const daily  = plan.quotaUsage?.dailyRemainingPercent  ?? 100;
+      const weekly = plan.quotaUsage?.weeklyRemainingPercent ?? 100;
+      quotaData = {
+        planName:              plan.planName || 'Unknown',
+        usedMessages:          plan.usage.usedMessages    || 0,
+        totalMessages:         plan.usage.messages        || 0,
+        usedFlowActions:       plan.usage.usedFlowActions || 0,
+        totalFlowActions:      plan.usage.flowActions     || 0,
+        dailyUsedPercent:      Math.round(100 - daily),
+        weeklyUsedPercent:     Math.round(100 - weekly),
+        dailyRemainingPercent: Math.round(daily),
+        weeklyRemainingPercent:Math.round(weekly),
+        startDate: plan.startTimestamp ? new Date(plan.startTimestamp).toISOString().slice(0, 10) : null,
+        endDate:   plan.endTimestamp   ? new Date(plan.endTimestamp).toISOString().slice(0, 10)   : null,
+      };
     }
   }
 
-  sessions.sort((a, b) => (b.timestamp || '').localeCompare(a.timestamp || ''));
-  return { sessions, available: sessions.length > 0 };
-}
+  // ── 2. Read workspace sessions from workspaceStorage SQLite DBs ─────────────
+  const sessions       = [];
+  const wsStorageDir   = path.join(windsurfDir, 'User', 'workspaceStorage');
 
-function parseWindsurfWorkspace(wsDir) {
-  const files = fs.readdirSync(wsDir).filter(f =>
-    f.includes('cascade') || f.includes('chat') || f.includes('conversation')
-  );
-  if (!files.length) return null;
-
-  const messages = [];
-  let firstTs = null;
-
-  for (const file of files) {
-    try {
-      const data = JSON.parse(fs.readFileSync(path.join(wsDir, file), 'utf-8'));
-      const turns = data.turns || data.messages || data.conversations || [];
-      for (const turn of turns) {
-        const ts = turn.timestamp || turn.createdAt || null;
-        if (ts && !firstTs) firstTs = ts;
-        const role = turn.type === 'human' ? 'user' : (turn.type === 'ai' ? 'assistant' : (turn.role || 'user'));
-        messages.push({ role, content: turn.text || turn.content || '', timestamp: ts });
+  if (hasSqlite && fs.existsSync(wsStorageDir)) {
+    const wsDirs = fs.readdirSync(wsStorageDir, { withFileTypes: true })
+      .filter(d => d.isDirectory())
+      .map(d => path.join(wsStorageDir, d.name));
+
+    for (const wsDir of wsDirs) {
+      const db = path.join(wsDir, 'state.vscdb');
+      if (!fs.existsSync(db)) continue;
+
+      // Determine timestamp: readDateBaseline2 → epoch dirname → skip
+      const baseline = readDbKey(db, 'agentSessions.readDateBaseline2');
+      const dirName  = path.basename(wsDir);
+      let ts = null;
+      if (baseline && !isNaN(parseInt(baseline, 10))) {
+        ts = new Date(parseInt(baseline, 10)).toISOString();
+      } else if (/^\d{13}$/.test(dirName)) {
+        ts = new Date(parseInt(dirName, 10)).toISOString();
+      }
+      if (!ts) continue;
+
+      // Resolve project name from workspace.json
+      let projectName = dirName;
+      const wsJson = path.join(wsDir, 'workspace.json');
+      if (fs.existsSync(wsJson)) {
+        try {
+          const wd = JSON.parse(fs.readFileSync(wsJson, 'utf-8'));
+          const uri = wd.folder || wd.workspace?.folders?.[0]?.uri || '';
+          if (uri) projectName = path.basename(decodeURIComponent(uri).replace(/\/$/, ''));
+        } catch { /* skip */ }
       }
-    } catch { /* skip */ }
-  }
 
-  if (!messages.length) return null;
-  const ts     = firstTs || new Date().toISOString();
-  const agents = detectAgentsInMessages(messages);
-
-  return {
-    id:           path.basename(wsDir),
-    platform:     'windsurf',
-    project:      path.basename(wsDir),
-    date:         ts.slice(0, 10),
-    lastDate:     ts.slice(0, 10),
-    timestamp:    ts,
-    lastActivity: ts,
-    tokens:       { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
-    cost:         0,
-    cacheSaved:   0,
-    messageCount: messages.length,
-    agents,
-    agentCalls:   agents.length,
-  };
-}
+      // Check for any agent usage in this workspace
+      const agentCache = readDbKey(db, 'agentSessions.state.cache') || [];
+      const messages   = Array.isArray(agentCache)
+        ? agentCache.flatMap(s => (s.messages || []).map(m => ({
+            role:    m.role || 'user',
+            content: m.content || m.text || '',
+          })))
+        : [];
+      const agents = detectAgentsInMessages(messages);
+
+      sessions.push({
+        id:           dirName,
+        platform:     'windsurf',
+        project:      projectName,
+        date:         ts.slice(0, 10),
+        lastDate:     ts.slice(0, 10),
+        timestamp:    ts,
+        lastActivity: ts,
+        tokens:       { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+        cost:         null,       // Windsurf is quota-based, not per-token
+        cacheSaved:   0,
+        messageCount: messages.length,
+        agents,
+        agentCalls:   agents.length,
+        cloudAI:      true,
+      });
+    }
+  }
 
-function parseCascadeFile(filePath) {
-  const data = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-  const messages = (data.messages || data.turns || []).map(m => ({
-    role:      m.role || (m.type === 'human' ? 'user' : 'assistant'),
-    content:   m.content || m.text || '',
-    timestamp: m.timestamp || null,
-  }));
-
-  if (!messages.length) return null;
-  const ts     = messages[0].timestamp || new Date().toISOString();
-  const agents = detectAgentsInMessages(messages);
-
-  return {
-    id:           path.basename(filePath, '.json'),
-    platform:     'windsurf',
-    project:      path.basename(filePath, '.json'),
-    date:         ts.slice(0, 10),
-    lastDate:     ts.slice(0, 10),
-    timestamp:    ts,
-    lastActivity: ts,
-    tokens:       { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
-    cost:         0,
-    cacheSaved:   0,
-    messageCount: messages.length,
-    agents,
-    agentCalls:   agents.length,
-  };
+  sessions.sort((a, b) => (b.timestamp || '').localeCompare(a.timestamp || ''));
+  return { sessions, available: true, quotaData };
 }

package/dashboard/public/index.html

@@ -727,6 +727,17 @@
     </div>
   </div>
 
+  <!-- Windsurf Quota Panel (hidden until data loads) -->
+  <div class="card" id="windsurfQuota" style="display:none;margin-bottom:0">
+    <div class="card-header" style="padding-bottom:8px">
+      <div class="card-title">
+        <div class="card-title-icon" style="background:#cffafe">🏄</div>
+        Windsurf Quota Usage
+      </div>
+    </div>
+    <div class="card-body"></div>
+  </div>
+
   <!-- Cost chart + Recent sessions -->
   <div class="two-col">
     <div class="card">
@@ -824,11 +835,12 @@ async function refreshData(force = false) {
 function renderAll(d) {
   renderStats(d.stats);
   renderAgents(d.agents);
-  renderPlatforms(d.platforms);
+  renderPlatforms(d.platforms, d.windsurf);
   renderCostChart(d.costs);
   renderToday(d.stats);
   renderSessions(d.sessions);
   renderSavings(d.stats);
+  renderWindsurfQuota(d.windsurf?.quotaData);
 
   // Dynamic subtitle — list installed platform names
   if (d.platforms) {
@@ -915,12 +927,11 @@ function renderAgents(agents) {
   }).join('');
 }
 
-// Cloud AI platforms — store conversations server-side
-// Antigravity stores AI sessions server-side — only platform with no local conversation logs
-const CLOUD_AI_PLATFORMS = new Set(['antigravity']);
+// Cloud AI platforms — store conversations server-side (no local token data)
+const CLOUD_AI_PLATFORMS = new Set(['antigravity', 'windsurf']);
 
 // ── Platforms ─────────────────────────────────────────────────────────────────
-function renderPlatforms(platforms) {
+function renderPlatforms(platforms, windsurfData) {
   const grid = document.getElementById('platformGrid');
   if (!platforms) { grid.innerHTML = '<div class="empty"><div class="empty-icon">❌</div></div>'; return; }
 
@@ -946,10 +957,39 @@ function renderPlatforms(platforms) {
       statusClass = 'status-inactive'; statusText = '○ Installed';
     }
 
-    const cloudBadge = cloudAI && present
-      ? `<div class="cloud-badge">☁ Cloud AI sessions</div>` : '';
-    const sessDisplay = cloudAI ? (p.sessions > 0 ? fmtNum(p.sessions) + ' proj' : '—') : fmtNum(p.sessions);
-    const sessLabel   = cloudAI ? 'ECC projects' : 'sessions';
+    let cloudBadge = '';
+    let sessDisplay, sessLabel;
+    if (key === 'windsurf' && present) {
+      const q = windsurfData?.quotaData;
+      if (q) {
+        const msgPct = q.totalMessages > 0 ? Math.round((q.usedMessages / q.totalMessages) * 100) : q.dailyUsedPercent;
+        sessDisplay = `${q.usedMessages.toLocaleString()} / ${q.totalMessages.toLocaleString()}`;
+        sessLabel   = 'messages used';
+        cloudBadge  = `
+          <div style="margin-top:8px;font-size:11px;color:var(--muted)">
+            <div style="display:flex;justify-content:space-between;margin-bottom:3px">
+              <span>${q.planName} plan</span><span>${q.dailyUsedPercent}% daily used</span>
+            </div>
+            <div style="background:#e2e8f0;border-radius:4px;height:4px;overflow:hidden">
+              <div style="background:${meta.color};height:4px;width:${Math.min(q.dailyUsedPercent,100)}%;transition:width .3s"></div>
+            </div>
+            <div style="display:flex;justify-content:space-between;margin-top:4px">
+              <span>Flow: ${q.usedFlowActions} / ${q.totalFlowActions}</span><span>${q.weeklyUsedPercent}% weekly</span>
+            </div>
+          </div>`;
+      } else {
+        sessDisplay = p.sessions > 0 ? fmtNum(p.sessions) + ' proj' : '—';
+        sessLabel   = 'ECC projects';
+        cloudBadge  = `<div class="cloud-badge">☁ Quota data loading…</div>`;
+      }
+    } else if (cloudAI && present) {
+      sessDisplay = p.sessions > 0 ? fmtNum(p.sessions) + ' proj' : '—';
+      sessLabel   = 'ECC projects';
+      cloudBadge  = `<div class="cloud-badge">☁ Cloud AI sessions</div>`;
+    } else {
+      sessDisplay = fmtNum(p.sessions);
+      sessLabel   = 'sessions';
+    }
 
     return `
     <div class="platform-card ${active || (cloudAI && present) ? 'active' : ''}" style="color:${meta.color}">
@@ -957,7 +997,7 @@ function renderPlatforms(platforms) {
         <span class="platform-dot-lg" style="background:${meta.color}"></span>
         ${meta.label}
       </div>
-      <div class="platform-sessions" style="color:${(active || (cloudAI && present)) ? meta.color : 'var(--muted)'}">${sessDisplay}</div>
+      <div class="platform-sessions" style="color:${(active || (cloudAI && present)) ? meta.color : 'var(--muted)'};font-size:${key==='windsurf'&&windsurfData?.quotaData?'14px':'22px'}">${sessDisplay}</div>
       <div class="platform-label">${sessLabel}</div>
       <div class="platform-status ${statusClass}">${statusText}</div>
       ${cloudBadge}
@@ -965,6 +1005,40 @@ function renderPlatforms(platforms) {
   }).join('');
 }
 
+// ── Windsurf Quota Panel ─────────────────────────────────────────────────────
+function renderWindsurfQuota(q) {
+  const el = document.getElementById('windsurfQuota');
+  if (!el) return;
+  if (!q) { el.style.display = 'none'; return; }
+  el.style.display = 'block';
+  el.querySelector('.card-body').innerHTML = `
+    <div style="display:flex;gap:24px;flex-wrap:wrap;align-items:center">
+      <div>
+        <div style="font-size:11px;color:var(--muted);text-transform:uppercase;letter-spacing:.5px">Windsurf ${q.planName}</div>
+        <div style="font-size:22px;font-weight:800;color:#06b6d4;font-variant-numeric:tabular-nums">${q.usedMessages.toLocaleString()} <span style="font-size:14px;font-weight:400;color:var(--muted)">/ ${q.totalMessages.toLocaleString()} msgs</span></div>
+      </div>
+      <div style="flex:1;min-width:160px">
+        <div style="display:flex;justify-content:space-between;font-size:11px;color:var(--muted);margin-bottom:4px">
+          <span>Daily quota</span><span>${q.dailyUsedPercent}% used</span>
+        </div>
+        <div style="background:#e2e8f0;border-radius:6px;height:8px;overflow:hidden">
+          <div style="background:#06b6d4;height:8px;width:${Math.min(q.dailyUsedPercent,100)}%;border-radius:6px;transition:width .4s"></div>
+        </div>
+        <div style="display:flex;justify-content:space-between;font-size:11px;color:var(--muted);margin-top:6px">
+          <span>Weekly quota</span><span>${q.weeklyUsedPercent}% used</span>
+        </div>
+        <div style="background:#e2e8f0;border-radius:6px;height:8px;overflow:hidden;margin-top:4px">
+          <div style="background:#0e7490;height:8px;width:${Math.min(q.weeklyUsedPercent,100)}%;border-radius:6px;transition:width .4s"></div>
+        </div>
+      </div>
+      <div style="text-align:right">
+        <div style="font-size:11px;color:var(--muted)">Flow Actions</div>
+        <div style="font-size:16px;font-weight:700;color:#06b6d4">${q.usedFlowActions.toLocaleString()} <span style="font-size:12px;color:var(--muted)">/ ${q.totalFlowActions.toLocaleString()}</span></div>
+        ${q.endDate ? `<div style="font-size:10px;color:var(--muted);margin-top:2px">Resets ${q.endDate}</div>` : ''}
+      </div>
+    </div>`;
+}
+
 // ── Cost chart ────────────────────────────────────────────────────────────────
 function renderCostChart(dailyCosts) {
   const svg = document.getElementById('costChart');
@@ -1060,8 +1134,8 @@ function renderSessions(sessions) {
       <td style="max-width:220px">
         <div style="display:flex;flex-wrap:wrap;gap:4px">${agents}${moreAgents}</div>
       </td>
-      <td class="td-mono">${fmtTokens(s.tokens?.total || 0)}</td>
-      <td class="td-mono">${s.cost > 0 ? '$' + s.cost.toFixed(4) : '—'}</td>
+      <td class="td-mono">${s.cost === null ? '<span style="color:#94a3b8">quota</span>' : fmtTokens(s.tokens?.total || 0)}</td>
+      <td class="td-mono">${s.cost === null ? '<span style="color:#94a3b8">—</span>' : s.cost > 0 ? '$' + s.cost.toFixed(4) : '—'}</td>
       <td style="white-space:nowrap;color:var(--muted)">${fmtDate(s.date)}</td>
     </tr>`;
   }).join('');

package/install.ps1

@@ -1,11 +1,14 @@
 # =============================================================================
 # Kodelyth ECC — Windows PowerShell Installer
-# Supports: Claude Code, Antigravity, Cursor, Codex, OpenCode
+# Supports: Claude Code, Antigravity, Cursor, Codex, Windsurf, OpenCode
 # Usage:
-#   .\install.ps1                              # Claude Code (default)
-#   .\install.ps1 -Target antigravity          # Google Antigravity
-#   .\install.ps1 -Target cursor-project       # Cursor IDE
-#   .\install.ps1 -Target codex-home           # OpenAI Codex CLI
+#   .\install.ps1                                   # Claude Code (default)
+#   .\install.ps1 -Target windsurf-project          # Windsurf (project)
+#   .\install.ps1 -Target windsurf-home             # Windsurf (global)
+#   .\install.ps1 -Target antigravity               # Google Antigravity
+#   .\install.ps1 -Target cursor-project            # Cursor IDE
+#   .\install.ps1 -Target codex-home                # OpenAI Codex CLI
+#   .\install.ps1 -Target opencode                  # OpenCode
 # =============================================================================
 
 param(
@@ -18,7 +21,7 @@ $ErrorActionPreference = "Stop"
 # ── Banner ────────────────────────────────────────────────────────────────────
 Write-Host ""
 Write-Host "  Kodelyth ECC — Production-grade AI coding agent toolkit" -ForegroundColor Cyan
-Write-Host "  50 agents · 183 skills · 79 commands · 15+ hooks" -ForegroundColor Gray
+Write-Host "  53 agents · 185 skills · 79 commands · 18+ hooks" -ForegroundColor Gray
 Write-Host ""
 
 $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
@@ -35,6 +38,22 @@ switch ($Target) {
         $HooksDest    = "$Dest\hooks"
         $RulesDest    = "$Dest\rules"
     }
+    "windsurf-project" {
+        $Dest         = "$(Get-Location)\.windsurf"
+        $AgentsDest   = "$Dest\agents"
+        $SkillsDest   = "$Dest\skills"
+        $CommandsDest = ""
+        $HooksDest    = ""
+        $RulesDest    = "$Dest\rules"
+    }
+    "windsurf-home" {
+        $Dest         = "$HomeDir\.codeium\windsurf"
+        $AgentsDest   = "$Dest\agents"
+        $SkillsDest   = "$Dest\skills"
+        $CommandsDest = ""
+        $HooksDest    = ""
+        $RulesDest    = "$Dest\rules"
+    }
     "antigravity" {
         $Dest         = "$(Get-Location)\.agent"
         $AgentsDest   = "$Dest\skills"
@@ -59,9 +78,17 @@ switch ($Target) {
         $HooksDest    = ""
         $RulesDest    = "$Dest\rules"
     }
+    "opencode" {
+        $Dest         = "$(Get-Location)\.opencode"
+        $AgentsDest   = ""
+        $SkillsDest   = ""
+        $CommandsDest = ""
+        $HooksDest    = ""
+        $RulesDest    = "$Dest\rules"
+    }
     default {
         Write-Host "Unknown target: $Target" -ForegroundColor Red
-        Write-Host "Valid targets: claude-home, antigravity, cursor-project, codex-home"
+        Write-Host "Valid targets: claude-home, windsurf-project, windsurf-home, antigravity, cursor-project, codex-home, opencode"
         exit 1
     }
 }
@@ -104,8 +131,8 @@ Write-Host "Installing components..." -ForegroundColor Bold
 
 switch ($Target) {
     "claude-home" {
-        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents   (50)"
-        Install-Dir  "$ScriptDir\skills"   $SkillsDest   "Skills   (183)"
+        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents   (53)"
+        Install-Dir  "$ScriptDir\skills"   $SkillsDest   "Skills   (185)"
         Install-Dir  "$ScriptDir\commands" $CommandsDest "Commands (79)"
 
         # Hooks
@@ -134,21 +161,38 @@ switch ($Target) {
         Copy-Item "$ScriptDir\SOUL.md"   "$Dest\SOUL.md"   -Force -ErrorAction SilentlyContinue
         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-Flat "$ScriptDir\rules"    $RulesDest  "Rules"
+
+        # Generate .windsurfrules from all common rules
+        $WindsurfRulesFile = if ($Target -eq "windsurf-project") { "$(Get-Location)\.windsurfrules" } else { "$HomeDir\.windsurfrules" }
+        $CommonRulesDir = "$ScriptDir\rules\common"
+        if (Test-Path $CommonRulesDir) {
+            $Combined = Get-ChildItem -Path $CommonRulesDir -Filter "*.md" | Sort-Object Name | ForEach-Object { Get-Content $_.FullName }
+            $Combined | Out-File -FilePath $WindsurfRulesFile -Encoding UTF8
+            Write-Host "  [OK] .windsurfrules generated -> $WindsurfRulesFile" -ForegroundColor Green
+        }
+    }
     "antigravity" {
-        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents -> skills (50)"
+        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents -> skills (53)"
         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 (183)"
+        Install-Flat "$ScriptDir\rules"    $RulesDest  "Rules"
+        Install-Dir  "$ScriptDir\skills"   $SkillsDest "Skills (185)"
     }
     "codex-home" {
-        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents   (50)"
-        Install-Dir  "$ScriptDir\skills"   $SkillsDest   "Skills   (183)"
+        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents   (53)"
+        Install-Dir  "$ScriptDir\skills"   $SkillsDest   "Skills   (185)"
         Install-Dir  "$ScriptDir\commands" $CommandsDest "Commands (79)"
         Install-Flat "$ScriptDir\rules"    $RulesDest    "Rules"
     }
+    "opencode" {
+        Install-Flat "$ScriptDir\rules"    $RulesDest    "Rules"
+    }
 }
 
 # ── Write install state ───────────────────────────────────────────────────────

package/package.json

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