@jaybeeuu/agent-cortex 1.20.0

package/extensions/skill-stats/index.ts

@@ -0,0 +1,222 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import path from "node:path";
+
+// Re-export public API for tests and consumers
+export { type ProjectCounts, type SkillStats, type UsageStore, type RawEvent, loadStore, saveStore, ageOutStore } from "./store.js";
+export { recordUsage } from "./record.js";
+export { type SkillRecord, globalSkillDirs, scanSkills, extractSkillName, discoverProjectSkills, resolveSkillFromPath } from "./discover.js";
+export { formatTable } from "./format.js";
+
+import { loadStore, saveStore } from "./store.js";
+import { recordUsage } from "./record.js";
+import { resolveSkillFromPath, globalSkillDirs, scanSkills, discoverProjectSkills } from "./discover.js";
+import { formatTable } from "./format.js";
+
+// ── Extension entry point ─────────────────────────────────────────────────────
+
+export default function (pi: ExtensionAPI) {
+  // ── Lazy skill map, refreshed on startup and reload ─────────────────────
+  let knownSkills = new Map<string, import("./discover.js").SkillRecord>();
+
+  function refreshSkills(cwd: string): void {
+    knownSkills = new Map();
+    for (const d of globalSkillDirs()) scanSkills(d, knownSkills);
+    discoverProjectSkills(cwd, knownSkills);
+  }
+
+  refreshSkills(process.cwd());
+
+  // ── 1. Track skills loaded into system prompt ─────────────────────────
+  pi.on("before_agent_start", async (event, ctx) => {
+    const skills = event.systemPromptOptions?.skills;
+    if (!skills?.length) return;
+
+    const store = loadStore();
+    const project = ctx.cwd;
+    for (const skill of skills) {
+      const name = typeof skill === "string" ? skill : skill.name;
+      if (name) recordUsage(store, name, "loaded", project);
+    }
+    saveStore(store);
+  });
+
+  // ── 2. Track /skill:name invocations ──────────────────────────────────
+  pi.on("input", async (event, ctx) => {
+    const m = event.text.match(/^\/skill:(\S+)/);
+    if (!m) return;
+
+    const store = loadStore();
+    recordUsage(store, m[1], "invoked", ctx.cwd);
+    saveStore(store);
+  });
+
+  // ── 3. Track SKILL.md reads by the LLM ────────────────────────────────
+  pi.on("tool_call", async (event, ctx) => {
+    if (event.toolName !== "read") return;
+
+    const input = event.input as { path?: string } | undefined;
+    const filePath = input?.path;
+    if (!filePath) return;
+
+    const skillName = resolveSkillFromPath(filePath, knownSkills);
+    if (!skillName) return;
+
+    const store = loadStore();
+    recordUsage(store, skillName, "read", ctx.cwd);
+    saveStore(store);
+  });
+
+  // ── 4. Track turns ────────────────────────────────────────────────────
+  // Only count unique turns (not reloads). We use a simple in-memory flag
+  // per reload cycle; a `/reload` resets the flag, avoiding double-counts.
+  let countedTurnThisCycle = false;
+
+  pi.on("turn_end", async (_event, _ctx) => {
+    if (countedTurnThisCycle) return;
+    countedTurnThisCycle = true;
+
+    const store = loadStore();
+    store.totalTurns++;
+    saveStore(store);
+  });
+
+  // Reset the flag after reload so the next turn is counted
+  pi.on("session_start", async () => {
+    countedTurnThisCycle = false;
+  });
+
+  // ── 5. /skill-stats command ───────────────────────────────────────────
+  pi.registerCommand("skill-stats", {
+    description:
+      "Show skill usage stats. Filter by project: /skill-stats --project <path>",
+    handler: async (args, ctx) => {
+      const store = loadStore();
+
+      let projectFilter: string | null = null;
+      if (args) {
+        const m = args.match(/--project\s+(\S+)/);
+        if (m) projectFilter = path.resolve(ctx.cwd, m[1]);
+      }
+
+      const skillNames = Object.keys(store.skills).sort();
+      if (skillNames.length === 0) {
+        ctx.ui.notify("No skill usage recorded yet.", "info");
+        return;
+      }
+
+      // Build rows — each row is [skill, loaded, invoked, read, total, lastUsed]
+      const rows: string[][] = [];
+      for (const name of skillNames) {
+        const s = store.skills[name];
+
+        let loaded: number, invoked: number, read: number, lastUsed: string;
+        if (projectFilter) {
+          const p = s.byProject[projectFilter];
+          if (!p) continue;
+          loaded = p.loadedCount;
+          invoked = p.invokedCount;
+          read = p.readCount;
+          lastUsed = p.lastUsed ? new Date(p.lastUsed).toLocaleDateString() : "-";
+        } else {
+          loaded = s.loadedCount;
+          invoked = s.invokedCount;
+          read = s.readCount;
+          lastUsed = s.lastUsed ? new Date(s.lastUsed).toLocaleDateString() : "-";
+        }
+
+        const total = loaded + invoked + read;
+        if (total === 0) continue; // hide zero-usage rows in filtered view
+
+        rows.push([
+          name,
+          String(loaded),
+          String(invoked),
+          String(read),
+          String(total),
+          lastUsed,
+        ]);
+      }
+
+      rows.sort((a, b) => Number(b[4]) - Number(a[4]));
+
+      // ── Assemble output ──────────────────────────────────────────
+      const lines: string[] = [];
+
+      if (projectFilter) {
+        lines.push(`Skill usage for project: ${projectFilter}`);
+        lines.push("");
+      }
+
+      lines.push(`Total skills tracked: ${rows.length}`);
+      lines.push(`Total agent turns recorded: ${store.totalTurns}`);
+      lines.push("");
+
+      if (rows.length > 0) {
+        const top = rows.slice(0, 3);
+        lines.push("Top 3:");
+        lines.push(...top.map((r, i) => `  ${i + 1}. ${r[0]} (${r[4]} total)`));
+      }
+
+      if (rows.length > 3) {
+        lines.push("");
+        const bottom = rows.slice(-3);
+        lines.push("Bottom 3:");
+        lines.push(...bottom.map((r, i) => `  ${i + 1}. ${r[0]} (${r[4]} total)`));
+      }
+
+      lines.push("");
+      lines.push(formatTable(
+        ["Skill", "Loaded", "Invoked", "Read", "Total", "Last Used"],
+        rows,
+      ));
+      lines.push("");
+
+      // Show all projects if not filtering
+      if (!projectFilter) {
+        const allProjects = new Set<string>();
+        for (const name of skillNames) {
+          for (const proj of Object.keys(store.skills[name].byProject)) {
+            allProjects.add(proj);
+          }
+        }
+        if (allProjects.size > 1) {
+          lines.push(`Projects with activity (${allProjects.size}):`);
+          for (const proj of [...allProjects].sort()) {
+            lines.push(`  ${proj}`);
+          }
+          lines.push("");
+          lines.push("Filter: /skill-stats --project <path>");
+        }
+      }
+
+      const output = lines.join("\n");
+      ctx.ui.notify(
+        `Skill stats: ${rows.length} skills. Top: ${rows[0]?.[0] ?? "-"}.`,
+        "info",
+      );
+      console.log(output);
+    },
+  });
+
+  // ── 6. /skill-usage-reset command ─────────────────────────────────────
+  pi.registerCommand("skill-usage-reset", {
+    description: "Delete all recorded skill usage data",
+    handler: async (_args, ctx) => {
+      if (!ctx.hasUI) return;
+      const ok = await ctx.ui.confirm(
+        "Reset all skill stats?",
+        "This deletes ALL recorded usage data across all projects.",
+      );
+      if (!ok) return;
+
+      saveStore({
+        version: 1,
+        skills: {},
+        totalTurns: 0,
+        lastUpdated: new Date().toISOString(),
+        recentEvents: [],
+      });
+      ctx.ui.notify("Skill usage statistics reset.", "info");
+    },
+  });
+}

package/extensions/skill-stats/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@agent-cortex/skill-stats",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "node --test --import tsx/esm index.test.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.78.1",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.78.1"
+  }
+}

package/extensions/skill-stats/pnpm-lock.yaml

@@ -0,0 +1,329 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    devDependencies:
+      '@types/node':
+        specifier: ^22.0.0
+        version: 22.19.20
+      tsx:
+        specifier: ^4.0.0
+        version: 4.22.4
+      typescript:
+        specifier: ^5.0.0
+        version: 5.9.3
+
+packages:
+
+  '@esbuild/aix-ppc64@0.28.0':
+    resolution: {integrity: sha512-lhRUCeuOyJQURhTxl4WkpFTjIsbDayJHih5kZC1giwE+MhIzAb7mEsQMqMf18rHLsrb5qI1tafG20mLxEWcWlA==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [aix]
+
+  '@esbuild/android-arm64@0.28.0':
+    resolution: {integrity: sha512-+WzIXQOSaGs33tLEgYPYe/yQHf0WTU0X42Jca3y8NWMbUVhp7rUnw+vAsRC/QiDrdD31IszMrZy+qwPOPjd+rw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [android]
+
+  '@esbuild/android-arm@0.28.0':
+    resolution: {integrity: sha512-wqh0ByljabXLKHeWXYLqoJ5jKC4XBaw6Hk08OfMrCRd2nP2ZQ5eleDZC41XHyCNgktBGYMbqnrJKq/K/lzPMSQ==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [android]
+
+  '@esbuild/android-x64@0.28.0':
+    resolution: {integrity: sha512-+VJggoaKhk2VNNqVL7f6S189UzShHC/mR9EE8rDdSkdpN0KflSwWY/gWjDrNxxisg8Fp1ZCD9jLMo4m0OUfeUA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [android]
+
+  '@esbuild/darwin-arm64@0.28.0':
+    resolution: {integrity: sha512-0T+A9WZm+bZ84nZBtk1ckYsOvyA3x7e2Acj1KdVfV4/2tdG4fzUp91YHx+GArWLtwqp77pBXVCPn2We7Letr0Q==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@esbuild/darwin-x64@0.28.0':
+    resolution: {integrity: sha512-fyzLm/DLDl/84OCfp2f/XQ4flmORsjU7VKt8HLjvIXChJoFFOIL6pLJPH4Yhd1n1gGFF9mPwtlN5Wf82DZs+LQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [darwin]
+
+  '@esbuild/freebsd-arm64@0.28.0':
+    resolution: {integrity: sha512-l9GeW5UZBT9k9brBYI+0WDffcRxgHQD8ShN2Ur4xWq/NFzUKm3k5lsH4PdaRgb2w7mI9u61nr2gI2mLI27Nh3Q==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [freebsd]
+
+  '@esbuild/freebsd-x64@0.28.0':
+    resolution: {integrity: sha512-BXoQai/A0wPO6Es3yFJ7APCiKGc1tdAEOgeTNy3SsB491S3aHn4S4r3e976eUnPdU+NbdtmBuLncYir2tMU9Nw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@esbuild/linux-arm64@0.28.0':
+    resolution: {integrity: sha512-RVyzfb3FWsGA55n6WY0MEIEPURL1FcbhFE6BffZEMEekfCzCIMtB5yyDcFnVbTnwk+CLAgTujmV/Lgvih56W+A==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [linux]
+
+  '@esbuild/linux-arm@0.28.0':
+    resolution: {integrity: sha512-CjaaREJagqJp7iTaNQjjidaNbCKYcd4IDkzbwwxtSvjI7NZm79qiHc8HqciMddQ6CKvJT6aBd8lO9kN/ZudLlw==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [linux]
+
+  '@esbuild/linux-ia32@0.28.0':
+    resolution: {integrity: sha512-KBnSTt1kxl9x70q+ydterVdl+Cn0H18ngRMRCEQfrbqdUuntQQ0LoMZv47uB97NljZFzY6HcfqEZ2SAyIUTQBQ==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [linux]
+
+  '@esbuild/linux-loong64@0.28.0':
+    resolution: {integrity: sha512-zpSlUce1mnxzgBADvxKXX5sl8aYQHo2ezvMNI8I0lbblJtp8V4odlm3Yzlj7gPyt3T8ReksE6bK+pT3WD+aJRg==}
+    engines: {node: '>=18'}
+    cpu: [loong64]
+    os: [linux]
+
+  '@esbuild/linux-mips64el@0.28.0':
+    resolution: {integrity: sha512-2jIfP6mmjkdmeTlsX/9vmdmhBmKADrWqN7zcdtHIeNSCH1SqIoNI63cYsjQR8J+wGa4Y5izRcSHSm8K3QWmk3w==}
+    engines: {node: '>=18'}
+    cpu: [mips64el]
+    os: [linux]
+
+  '@esbuild/linux-ppc64@0.28.0':
+    resolution: {integrity: sha512-bc0FE9wWeC0WBm49IQMPSPILRocGTQt3j5KPCA8os6VprfuJ7KD+5PzESSrJ6GmPIPJK965ZJHTUlSA6GNYEhg==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [linux]
+
+  '@esbuild/linux-riscv64@0.28.0':
+    resolution: {integrity: sha512-SQPZOwoTTT/HXFXQJG/vBX8sOFagGqvZyXcgLA3NhIqcBv1BJU1d46c0rGcrij2B56Z2rNiSLaZOYW5cUk7yLQ==}
+    engines: {node: '>=18'}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@esbuild/linux-s390x@0.28.0':
+    resolution: {integrity: sha512-SCfR0HN8CEEjnYnySJTd2cw0k9OHB/YFzt5zgJEwa+wL/T/raGWYMBqwDNAC6dqFKmJYZoQBRfHjgwLHGSrn3Q==}
+    engines: {node: '>=18'}
+    cpu: [s390x]
+    os: [linux]
+
+  '@esbuild/linux-x64@0.28.0':
+    resolution: {integrity: sha512-us0dSb9iFxIi8srnpl931Nvs65it/Jd2a2K3qs7fz2WfGPHqzfzZTfec7oxZJRNPXPnNYZtanmRc4AL/JwVzHQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [linux]
+
+  '@esbuild/netbsd-arm64@0.28.0':
+    resolution: {integrity: sha512-CR/RYotgtCKwtftMwJlUU7xCVNg3lMYZ0RzTmAHSfLCXw3NtZtNpswLEj/Kkf6kEL3Gw+BpOekRX0BYCtklhUw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [netbsd]
+
+  '@esbuild/netbsd-x64@0.28.0':
+    resolution: {integrity: sha512-nU1yhmYutL+fQ71Kxnhg8uEOdC0pwEW9entHykTgEbna2pw2dkbFSMeqjjyHZoCmt8SBkOSvV+yNmm94aUrrqw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [netbsd]
+
+  '@esbuild/openbsd-arm64@0.28.0':
+    resolution: {integrity: sha512-cXb5vApOsRsxsEl4mcZ1XY3D4DzcoMxR/nnc4IyqYs0rTI8ZKmW6kyyg+11Z8yvgMfAEldKzP7AdP64HnSC/6g==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openbsd]
+
+  '@esbuild/openbsd-x64@0.28.0':
+    resolution: {integrity: sha512-8wZM2qqtv9UP3mzy7HiGYNH/zjTA355mpeuA+859TyR+e+Tc08IHYpLJuMsfpDJwoLo1ikIJI8jC3GFjnRClzA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [openbsd]
+
+  '@esbuild/openharmony-arm64@0.28.0':
+    resolution: {integrity: sha512-FLGfyizszcef5C3YtoyQDACyg95+dndv79i2EekILBofh5wpCa1KuBqOWKrEHZg3zrL3t5ouE5jgr94vA+Wb2w==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@esbuild/sunos-x64@0.28.0':
+    resolution: {integrity: sha512-1ZgjUoEdHZZl/YlV76TSCz9Hqj9h9YmMGAgAPYd+q4SicWNX3G5GCyx9uhQWSLcbvPW8Ni7lj4gDa1T40akdlw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [sunos]
+
+  '@esbuild/win32-arm64@0.28.0':
+    resolution: {integrity: sha512-Q9StnDmQ/enxnpxCCLSg0oo4+34B9TdXpuyPeTedN/6+iXBJ4J+zwfQI28u/Jl40nOYAxGoNi7mFP40RUtkmUA==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [win32]
+
+  '@esbuild/win32-ia32@0.28.0':
+    resolution: {integrity: sha512-zF3ag/gfiCe6U2iczcRzSYJKH1DCI+ByzSENHlM2FcDbEeo5Zd2C86Aq0tKUYAJJ1obRP84ymxIAksZUcdztHA==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [win32]
+
+  '@esbuild/win32-x64@0.28.0':
+    resolution: {integrity: sha512-pEl1bO9mfAmIC+tW5btTmrKaujg3zGtUmWNdCw/xs70FBjwAL3o9OEKNHvNmnyylD6ubxUERiEhdsL0xBQ9efw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [win32]
+
+  '@types/node@22.19.20':
+    resolution: {integrity: sha512-6tELRwSDYWW9EdZhbeZmYGZ1/7Djkt+Ah3/ScEYT9cDord7UJzasR/4D3VONg9tQI5CDp+/CZC1AXj2pCFOvpw==}
+
+  esbuild@0.28.0:
+    resolution: {integrity: sha512-sNR9MHpXSUV/XB4zmsFKN+QgVG82Cc7+/aaxJ8Adi8hyOac+EXptIp45QBPaVyX3N70664wRbTcLTOemCAnyqw==}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  fsevents@2.3.3:
+    resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
+    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+    os: [darwin]
+
+  tsx@4.22.4:
+    resolution: {integrity: sha512-X8EX+XV4QR5xCsrgxaED954zTDfY8KqlDtskKEL0cHhyS/P8b4IFOvGDQpsC9Q1XnLq915wEfwwY/zzskCtmhg==}
+    engines: {node: '>=18.0.0'}
+    hasBin: true
+
+  typescript@5.9.3:
+    resolution: {integrity: sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==}
+    engines: {node: '>=14.17'}
+    hasBin: true
+
+  undici-types@6.21.0:
+    resolution: {integrity: sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==}
+
+snapshots:
+
+  '@esbuild/aix-ppc64@0.28.0':
+    optional: true
+
+  '@esbuild/android-arm64@0.28.0':
+    optional: true
+
+  '@esbuild/android-arm@0.28.0':
+    optional: true
+
+  '@esbuild/android-x64@0.28.0':
+    optional: true
+
+  '@esbuild/darwin-arm64@0.28.0':
+    optional: true
+
+  '@esbuild/darwin-x64@0.28.0':
+    optional: true
+
+  '@esbuild/freebsd-arm64@0.28.0':
+    optional: true
+
+  '@esbuild/freebsd-x64@0.28.0':
+    optional: true
+
+  '@esbuild/linux-arm64@0.28.0':
+    optional: true
+
+  '@esbuild/linux-arm@0.28.0':
+    optional: true
+
+  '@esbuild/linux-ia32@0.28.0':
+    optional: true
+
+  '@esbuild/linux-loong64@0.28.0':
+    optional: true
+
+  '@esbuild/linux-mips64el@0.28.0':
+    optional: true
+
+  '@esbuild/linux-ppc64@0.28.0':
+    optional: true
+
+  '@esbuild/linux-riscv64@0.28.0':
+    optional: true
+
+  '@esbuild/linux-s390x@0.28.0':
+    optional: true
+
+  '@esbuild/linux-x64@0.28.0':
+    optional: true
+
+  '@esbuild/netbsd-arm64@0.28.0':
+    optional: true
+
+  '@esbuild/netbsd-x64@0.28.0':
+    optional: true
+
+  '@esbuild/openbsd-arm64@0.28.0':
+    optional: true
+
+  '@esbuild/openbsd-x64@0.28.0':
+    optional: true
+
+  '@esbuild/openharmony-arm64@0.28.0':
+    optional: true
+
+  '@esbuild/sunos-x64@0.28.0':
+    optional: true
+
+  '@esbuild/win32-arm64@0.28.0':
+    optional: true
+
+  '@esbuild/win32-ia32@0.28.0':
+    optional: true
+
+  '@esbuild/win32-x64@0.28.0':
+    optional: true
+
+  '@types/node@22.19.20':
+    dependencies:
+      undici-types: 6.21.0
+
+  esbuild@0.28.0:
+    optionalDependencies:
+      '@esbuild/aix-ppc64': 0.28.0
+      '@esbuild/android-arm': 0.28.0
+      '@esbuild/android-arm64': 0.28.0
+      '@esbuild/android-x64': 0.28.0
+      '@esbuild/darwin-arm64': 0.28.0
+      '@esbuild/darwin-x64': 0.28.0
+      '@esbuild/freebsd-arm64': 0.28.0
+      '@esbuild/freebsd-x64': 0.28.0
+      '@esbuild/linux-arm': 0.28.0
+      '@esbuild/linux-arm64': 0.28.0
+      '@esbuild/linux-ia32': 0.28.0
+      '@esbuild/linux-loong64': 0.28.0
+      '@esbuild/linux-mips64el': 0.28.0
+      '@esbuild/linux-ppc64': 0.28.0
+      '@esbuild/linux-riscv64': 0.28.0
+      '@esbuild/linux-s390x': 0.28.0
+      '@esbuild/linux-x64': 0.28.0
+      '@esbuild/netbsd-arm64': 0.28.0
+      '@esbuild/netbsd-x64': 0.28.0
+      '@esbuild/openbsd-arm64': 0.28.0
+      '@esbuild/openbsd-x64': 0.28.0
+      '@esbuild/openharmony-arm64': 0.28.0
+      '@esbuild/sunos-x64': 0.28.0
+      '@esbuild/win32-arm64': 0.28.0
+      '@esbuild/win32-ia32': 0.28.0
+      '@esbuild/win32-x64': 0.28.0
+
+  fsevents@2.3.3:
+    optional: true
+
+  tsx@4.22.4:
+    dependencies:
+      esbuild: 0.28.0
+    optionalDependencies:
+      fsevents: 2.3.3
+
+  typescript@5.9.3: {}
+
+  undici-types@6.21.0: {}

package/extensions/skill-stats/record.ts

@@ -0,0 +1,48 @@
+import type { UsageStore, RawEvent } from "./store.js";
+
+// ── Event recording ──────────────────────────────────────────────────────────
+
+export function recordUsage(
+  store: UsageStore,
+  skillName: string,
+  source: RawEvent["source"],
+  project: string,
+): void {
+  let skill = store.skills[skillName];
+  if (!skill) {
+    skill = {
+      loadedCount: 0,
+      invokedCount: 0,
+      readCount: 0,
+      lastUsed: null,
+      byProject: {},
+    };
+    store.skills[skillName] = skill;
+  }
+
+  const now = new Date().toISOString();
+
+  // Global counters
+  switch (source) {
+    case "loaded": skill.loadedCount++; break;
+    case "invoked": skill.invokedCount++; break;
+    case "read": skill.readCount++; break;
+  }
+  skill.lastUsed = now;
+
+  // Per-project counters
+  let proj = skill.byProject[project];
+  if (!proj) {
+    proj = { loadedCount: 0, invokedCount: 0, readCount: 0, lastUsed: null };
+    skill.byProject[project] = proj;
+  }
+  switch (source) {
+    case "loaded": proj.loadedCount++; break;
+    case "invoked": proj.invokedCount++; break;
+    case "read": proj.readCount++; break;
+  }
+  proj.lastUsed = now;
+
+  // Event log
+  store.recentEvents.push({ timestamp: now, skill: skillName, source, project });
+}