agentcache 0.3.1 → 0.3.3

package/README.md

@@ -32,38 +32,38 @@ No `init`. No `setup`. No config. No second command. The install itself:
 ## How It Works
 
 ```
-┌──────────────────────────────────────────────────────────────────────┐
-│                           Your Machine                                │
-│                                                                       │
-│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐            │
-│  │  Claude  │  │  Cursor  │  │   Roo    │  │  Codex   │  ...        │
-│  │   Code   │  │          │  │   Code   │  │          │            │
-│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────┬─────┘            │
-│       │              │              │              │                   │
-│       └──────────────┴──────────────┴──────────────┘                   │
+┌────────────────────────────────────────────────────────────────────────┐
+│                           Your Machine                                 │
+│                                                                        │
+│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐                │
+│  │  Claude  │  │  Cursor  │  │   Roo    │  │  Codex   │  ...           │
+│  │   Code   │  │          │  │   Code   │  │          │                │
+│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────┬─────┘                │
+│       │             │             │             │                      │
+│       └─────────────┴─────────────┴─────────────┘                      │
 │                              │                                         │
 │                    MCP Protocol (stdio)                                │
 │                              │                                         │
-│                 ┌────────────┴────────────┐    ┌────────────────────┐ │
-│                 │  AgentCache MCP Server   │    │  agentcache        │ │
-│                 │   (agentcache serve)     │    │  compile-all       │ │
-│                 │                          │    │  (standalone CLI)  │ │
-│                 │  spawns compile-all ─────┼───▶│                    │ │
-│                 │  when pending > 20       │    │  Uses: claude,     │ │
-│                 └────────────┬────────────┘    │  codex, gemini,    │ │
+│                 ┌────────────┴────────────┐     ┌────────────────────┐ │
+│                 │  AgentCache MCP Server  │     │  agentcache        │ │
+│                 │   (agentcache serve)    │     │  compile-all       │ │
+│                 │                         │     │  (standalone CLI)  │ │
+│                 │  spawns compile-all ────┼────▶│                    │ │
+│                 │  when pending > 20      │     │  Uses: claude,     │ │
+│                 └────────────┬────────────┘     │  codex, gemini,    │ │
 │                              │                  │  ollama, API keys  │ │
 │                              │                  └─────────┬──────────┘ │
 │                              │                            │            │
 │                    ┌─────────┴────────────────────────────┘            │
-│                    │                                                    │
-│                    ▼                                                    │
-│           ┌───────────────────┐                                        │
-│           │ ~/.agentcache/     │                                        │
-│           │  agentcache.db     │                                        │
-│           │  compile-all.lock  │                                        │
-│           │  (SQLite + WAL)    │                                        │
-│           └───────────────────┘                                        │
-└──────────────────────────────────────────────────────────────────────┘
+│                    │                                                   │
+│                    ▼                                                   │
+│           ┌────────────────────┐                                       │
+│           │ ~/.agentcache/     │                                       │
+│           │  agentcache.db     │                                       │
+│           │  compile-all.lock  │                                       │
+│           │  (SQLite + WAL)    │                                       │
+│           └────────────────────┘                                       │
+└────────────────────────────────────────────────────────────────────────┘
 ```
 
 ### The Cycle
@@ -185,13 +185,58 @@ All IDEs are fully auto-approved at install time — no manual steps required.
 
 "via compile-all" means `agentcache compile-all` discovers and processes these transcripts in batch, independent of any active MCP session.
 
+## Skill Output (Agent Skills Spec)
+
+Compiled knowledge is automatically projected to SKILL.md files — the [Agent Skills open standard](https://agentskills.io) supported by 38+ tools (Claude Code, Cursor, Codex, Gemini CLI, Copilot, Roo Code, and more).
+
+```
+~/.agentcache/skills/developer-knowledge/SKILL.md    # Global: rules + lessons
+<repo>/.agentcache/skills/project-knowledge/SKILL.md  # Project: decisions + context
+```
+
+**Global skill** (`~/.agentcache/skills/`) — your developer identity. Rules and lessons learned across all projects. Auto-discovered by any Agent Skills-compatible tool without MCP.
+
+**Project skill** (`<repo>/.agentcache/skills/`) — project-specific decisions, context, and rules. Git-trackable. Team members get it on clone. **This is team knowledge sharing without a sync server — just git.**
+
+Skills auto-refresh on every compilation. Each file stays under 5,000 tokens (Agent Skills budget limit). High-confidence items appear first.
+
+Example output:
+```markdown
+---
+name: project-knowledge
+description: "Project-specific decisions, rules, context, and lessons — compiled automatically from coding sessions by AgentCache"
+---
+
+## Rules
+
+Follow these without exception:
+
+- Always use path aliases in imports
+- Never commit .env files [ENFORCED]
+
+## Decisions
+
+Architectural choices in effect — do not contradict:
+
+- Using Drizzle ORM over Prisma for raw SQL escape hatches
+- PostgreSQL for all persistent state, Redis for ephemeral cache only
+
+## Current Context
+
+Active project state (may be temporal):
+
+- Migrating from REST to GraphQL, both coexist until Q3
+```
+
 ## Data Storage
 
-All data lives in `~/.agentcache/agentcache.db` (SQLite with WAL mode for concurrent access).
+All data lives in `~/.agentcache/` (SQLite with WAL mode for concurrent access).
 
 ```
 ~/.agentcache/
-└── agentcache.db    # All knowledge, observations, sessions, pending queue
+├── agentcache.db                          # Knowledge, observations, sessions, pending queue
+├── compile-all.lock                       # Prevents concurrent compilation
+└── skills/developer-knowledge/SKILL.md    # Global skill (auto-generated)
 ```
 
 No data leaves your machine. No network calls. No telemetry. No accounts.
@@ -218,6 +263,10 @@ Extract → Normalize → Canonicalize → Cluster → Detect Contradictions →
 - **In-session** — the agent in your IDE processes extraction prompts via MCP tools (no separate LLM calls needed)
 - **Batch (`compile-all`)** — runs independently using any available LLM CLI or API, processes the full backlog without depending on active sessions
 
+**Two output formats:**
+- **MCP injection** — structured context served to agents at session start via `inject_context`
+- **SKILL.md files** — Agent Skills spec-compliant files auto-discovered by 38+ tools without MCP
+
 ## Project Identity
 
 Projects are identified by a hash of their full filesystem path, not just the folder name. This means:

package/dist/{chunk-R4SJESNM.js → chunk-OXHITHDC.js}

@@ -1,7 +1,7 @@
 import {
   getDataDir,
   getGitContext
-} from "./chunk-WHP4Z32Z.js";
+} from "./chunk-S4GSIEKL.js";
 
 // src/knowledge/passes/3-canonicalizer.ts
 import { createHash } from "crypto";

package/dist/{chunk-TE6DBLJ5.js → chunk-QVQJPJGX.js}

@@ -1,7 +1,7 @@
 import {
   getClaudeTranscriptsDir,
   getContinueSessionsDir
-} from "./chunk-WHP4Z32Z.js";
+} from "./chunk-S4GSIEKL.js";
 import {
   __export
 } from "./chunk-KFQGP6VL.js";

package/dist/{chunk-WHP4Z32Z.js → chunk-S4GSIEKL.js}

@@ -8,12 +8,14 @@ import { createHash } from "crypto";
 import { execSync } from "child_process";
 function run(cmd, cwd) {
   try {
-    return execSync(cmd, { cwd, encoding: "utf-8", timeout: 5e3 }).trim();
+    return execSync(cmd, { cwd, encoding: "utf-8", timeout: 5e3, stdio: ["pipe", "pipe", "pipe"] }).trim();
   } catch {
     return "";
   }
 }
 function getGitContext(projectRoot) {
+  const empty = { branch: "", commit: "", recentCommits: [], modifiedFiles: [] };
+  if (!run("git rev-parse --git-dir", projectRoot)) return empty;
   const branch = run("git rev-parse --abbrev-ref HEAD", projectRoot);
   const commit = run("git rev-parse --short HEAD", projectRoot);
   const recentCommits = run("git log --oneline -10", projectRoot).split("\n").filter(Boolean);

package/dist/{chunk-RXBTPJVW.js → chunk-VFE4SDMO.js}

@@ -1,6 +1,6 @@
 import {
   getDataDir
-} from "./chunk-WHP4Z32Z.js";
+} from "./chunk-S4GSIEKL.js";
 
 // src/utils/background-compile.ts
 import { spawn } from "child_process";

package/dist/{chunk-MMSMDJ4O.js → chunk-ZVDODLZ7.js}

@@ -128,6 +128,9 @@ var SqliteKnowledgeRepository = class {
     if (!row) return null;
     return this.mapSession(row);
   }
+  updateSessionTranscriptPath(sessionId, transcriptPath) {
+    this.db.prepare("UPDATE sessions SET transcript_path = ? WHERE id = ?").run(transcriptPath, sessionId);
+  }
   getCompiledTranscriptPaths(project) {
     const rows = this.db.prepare("SELECT transcript_path FROM sessions WHERE project = ? AND transcript_path != ''").all(project);
     return rows.map((r) => r.transcript_path);

package/dist/cli.js

@@ -5,7 +5,7 @@ import { Command } from "commander";
 var program = new Command();
 program.name("agentcache").description("Engineering Knowledge Compiler \u2014 universal, zero-config").version("0.3.1");
 program.command("setup").description("Detect IDEs and register AgentCache (runs automatically on install)").action(async () => {
-  const { runSetup } = await import("./setup-5APZETPV.js");
+  const { runSetup } = await import("./setup-TVNRAAK3.js");
   await runSetup();
 });
 program.command("serve").description("Start AgentCache MCP server (spawned by IDEs automatically)").action(async () => {
@@ -13,7 +13,7 @@ program.command("serve").description("Start AgentCache MCP server (spawned by ID
   await startMcpServer();
 });
 program.command("compile-session").description("Stop hook: queue transcript for compilation").action(async () => {
-  const { handleStop } = await import("./stop-6SROS34Q.js");
+  const { handleStop } = await import("./stop-HFZZ2LFA.js");
   let payload;
   try {
     let data = "";
@@ -28,11 +28,11 @@ program.command("compile-session").description("Stop hook: queue transcript for
   await handleStop(payload);
 });
 program.command("discover").description("SessionStart hook: discover uncompiled transcripts").action(async () => {
-  const { handleSessionStart } = await import("./session-start-YSRUGD5N.js");
+  const { handleSessionStart } = await import("./session-start-SUR6FXRD.js");
   await handleSessionStart();
 });
 program.command("enforce").description("PreToolUse hook: policy enforcement").action(async () => {
-  const { handlePreToolUse } = await import("./pre-tool-use-OWWS54XG.js");
+  const { handlePreToolUse } = await import("./pre-tool-use-UBJFRHCW.js");
   let data = "";
   for await (const chunk of process.stdin) {
     data += chunk;
@@ -46,16 +46,16 @@ program.command("enforce").description("PreToolUse hook: policy enforcement").ac
   }
 });
 program.command("compile-all").description("Batch-compile all unprocessed transcripts using an available LLM CLI").action(async () => {
-  const { runCompileAll } = await import("./compile-all-DOQ5XU5K.js");
+  const { runCompileAll } = await import("./compile-all-XQBGUI3F.js");
   await runCompileAll();
 });
 program.command("status").description("Show AgentCache knowledge stats").action(async () => {
-  const { getDbPath, isInitialized, findProjectRoot, getProjectId, getProjectDisplayName } = await import("./paths-LOLEIMI5.js");
+  const { getDbPath, isInitialized, findProjectRoot, getProjectId, getProjectDisplayName } = await import("./paths-ULP2T4HZ.js");
   if (!isInitialized()) {
     console.log("AgentCache not initialized. Run: agentcache setup");
     return;
   }
-  const { SqliteKnowledgeRepository } = await import("./sqlite-AUND6HGQ.js");
+  const { SqliteKnowledgeRepository } = await import("./sqlite-MP6SRBBQ.js");
   const repo = new SqliteKnowledgeRepository(getDbPath());
   const projectRoot = findProjectRoot();
   const project = getProjectId(projectRoot);

package/dist/{compile-all-DOQ5XU5K.js → compile-all-XQBGUI3F.js}

@@ -2,11 +2,11 @@ import {
   processClustering,
   processExtraction,
   startCompile
-} from "./chunk-R4SJESNM.js";
+} from "./chunk-OXHITHDC.js";
 import {
   acquireLock,
   releaseLock
-} from "./chunk-RXBTPJVW.js";
+} from "./chunk-VFE4SDMO.js";
 import {
   findAllClaudeTranscripts,
   findAllCodexTranscripts,
@@ -14,15 +14,15 @@ import {
   findAllRooCodeTranscripts,
   getGooseDbPath,
   parseTranscript
-} from "./chunk-TE6DBLJ5.js";
+} from "./chunk-QVQJPJGX.js";
 import {
   getDbPath,
   getProjectId,
   isInitialized
-} from "./chunk-WHP4Z32Z.js";
+} from "./chunk-S4GSIEKL.js";
 import {
   SqliteKnowledgeRepository
-} from "./chunk-MMSMDJ4O.js";
+} from "./chunk-ZVDODLZ7.js";
 import {
   __esm,
   __export,
@@ -317,16 +317,18 @@ function processOneTranscript(repo, path, project, projectRoot, backend) {
   const events = parseTranscript(path);
   if (events.length < 3) return { created: 0, reinforced: 0, skipped: true };
   const sessionId = `sess_${randomUUID().slice(0, 8)}`;
-  const state = startCompile(events, sessionId, project, projectRoot, repo, path);
+  const state = startCompile(events, sessionId, project, projectRoot, repo);
   const extractionResponse = backend.invoke(state.prompt);
   if (!extractionResponse) return { created: 0, reinforced: 0, skipped: true };
   const extractResult = processExtraction(repo, extractionResponse, sessionId, project, projectRoot);
   if (extractResult.status === "complete") {
+    repo.updateSessionTranscriptPath(sessionId, path);
     return { created: 0, reinforced: 0, skipped: false };
   }
   const clusterResponse = backend.invoke(extractResult.clusteringPrompt);
   if (!clusterResponse) return { created: 0, reinforced: 0, skipped: true };
   const clusterResult = processClustering(repo, clusterResponse, sessionId, project, projectRoot);
+  repo.updateSessionTranscriptPath(sessionId, path);
   const diag = clusterResult.diagnostics;
   const createdMatch = diag.match(/(\d+) new knowledge/);
   const reinforcedMatch = diag.match(/(\d+) reinforced/);

package/dist/mcp.js

@@ -6,29 +6,91 @@ import {
   processClustering,
   processExtraction,
   startCompile
-} from "./chunk-R4SJESNM.js";
+} from "./chunk-OXHITHDC.js";
 import {
   spawnCompileAll
-} from "./chunk-RXBTPJVW.js";
+} from "./chunk-VFE4SDMO.js";
 import {
   parseTranscript
-} from "./chunk-TE6DBLJ5.js";
+} from "./chunk-QVQJPJGX.js";
 import {
   findProjectRoot,
+  getDataDir,
   getDbPath,
   getProjectId,
   isInitialized
-} from "./chunk-WHP4Z32Z.js";
+} from "./chunk-S4GSIEKL.js";
 import {
   SqliteKnowledgeRepository
-} from "./chunk-MMSMDJ4O.js";
+} from "./chunk-ZVDODLZ7.js";
 import "./chunk-KFQGP6VL.js";
 
 // src/mcp.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, RootsListChangedNotificationSchema } from "@modelcontextprotocol/sdk/types.js";
-import { existsSync } from "fs";
+
+// src/utils/auto-update.ts
+import { execSync, spawn } from "child_process";
+import { readFileSync, writeFileSync, existsSync } from "fs";
+import { join } from "path";
+var CHECK_INTERVAL_MS = 4 * 60 * 60 * 1e3;
+function getLastCheckPath() {
+  return join(getDataDir(), "last-update-check.json");
+}
+function shouldCheck() {
+  const path = getLastCheckPath();
+  if (!existsSync(path)) return true;
+  try {
+    const data = JSON.parse(readFileSync(path, "utf-8"));
+    return Date.now() - data.checkedAt > CHECK_INTERVAL_MS;
+  } catch {
+    return true;
+  }
+}
+function markChecked() {
+  writeFileSync(getLastCheckPath(), JSON.stringify({ checkedAt: Date.now() }), "utf-8");
+}
+function getCurrentVersion() {
+  const pkgPath = new URL("../../package.json", import.meta.url);
+  const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+  return pkg.version;
+}
+function getLatestVersion() {
+  try {
+    return execSync("npm view agentcache version", {
+      encoding: "utf-8",
+      timeout: 1e4,
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+  } catch {
+    return null;
+  }
+}
+function isNewer(latest, current) {
+  const l = latest.split(".").map(Number);
+  const c = current.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((l[i] || 0) > (c[i] || 0)) return true;
+    if ((l[i] || 0) < (c[i] || 0)) return false;
+  }
+  return false;
+}
+function checkForUpdates() {
+  if (!shouldCheck()) return;
+  markChecked();
+  const current = getCurrentVersion();
+  const latest = getLatestVersion();
+  if (!latest || !isNewer(latest, current)) return;
+  const child = spawn("npm", ["install", "-g", "agentcache@latest"], {
+    detached: true,
+    stdio: "ignore"
+  });
+  child.unref();
+}
+
+// src/mcp.ts
+import { existsSync as existsSync2 } from "fs";
 import { randomUUID } from "crypto";
 function defaultScope(type) {
   return type === "rule" || type === "lesson" ? "global" : "project";
@@ -62,6 +124,7 @@ async function startMcpServer() {
   );
   server.oninitialized = async () => {
     await resolveRoots(server);
+    checkForUpdates();
   };
   server.setNotificationHandler(RootsListChangedNotificationSchema, async () => {
     await resolveRoots(server);
@@ -281,7 +344,7 @@ ${pendingCount} sessions pending compilation (background compiler already runnin
           if (!entry) {
             return { content: [{ type: "text", text: JSON.stringify({ message: "No pending sessions to compile." }) }] };
           }
-          if (!existsSync(entry.transcriptPath)) {
+          if (!existsSync2(entry.transcriptPath)) {
             return { content: [{ type: "text", text: JSON.stringify({ message: `Transcript not found: ${entry.transcriptPath}, skipped.` }) }] };
           }
           const events = parseTranscript(entry.transcriptPath);

package/dist/{paths-LOLEIMI5.js → paths-ULP2T4HZ.js}

@@ -8,7 +8,7 @@ import {
   getProjectId,
   isInitialized,
   migrateFromLegacy
-} from "./chunk-WHP4Z32Z.js";
+} from "./chunk-S4GSIEKL.js";
 import "./chunk-KFQGP6VL.js";
 export {
   findProjectRoot,

package/dist/postinstall.js

@@ -1,6 +1,6 @@
 import {
   spawnCompileAll
-} from "./chunk-RXBTPJVW.js";
+} from "./chunk-VFE4SDMO.js";
 import {
   detectInstalledIdes,
   registerClaudeHooks,
@@ -10,10 +10,10 @@ import {
   getDataDir,
   getDbPath,
   migrateFromLegacy
-} from "./chunk-WHP4Z32Z.js";
+} from "./chunk-S4GSIEKL.js";
 import {
   SqliteKnowledgeRepository
-} from "./chunk-MMSMDJ4O.js";
+} from "./chunk-ZVDODLZ7.js";
 import "./chunk-KFQGP6VL.js";
 
 // src/postinstall.ts

package/dist/{pre-tool-use-OWWS54XG.js → pre-tool-use-UBJFRHCW.js}

@@ -6,10 +6,10 @@ import {
   getDbPath,
   getProjectId,
   isInitialized
-} from "./chunk-WHP4Z32Z.js";
+} from "./chunk-S4GSIEKL.js";
 import {
   SqliteKnowledgeRepository
-} from "./chunk-MMSMDJ4O.js";
+} from "./chunk-ZVDODLZ7.js";
 import "./chunk-KFQGP6VL.js";
 
 // src/hooks/pre-tool-use.ts

package/dist/{session-start-YSRUGD5N.js → session-start-SUR6FXRD.js}

@@ -3,15 +3,15 @@ import {
   findAllCodexTranscripts,
   findAllContinueTranscripts,
   findAllRooCodeTranscripts
-} from "./chunk-TE6DBLJ5.js";
+} from "./chunk-QVQJPJGX.js";
 import {
   getDbPath,
   getProjectId,
   isInitialized
-} from "./chunk-WHP4Z32Z.js";
+} from "./chunk-S4GSIEKL.js";
 import {
   SqliteKnowledgeRepository
-} from "./chunk-MMSMDJ4O.js";
+} from "./chunk-ZVDODLZ7.js";
 import "./chunk-KFQGP6VL.js";
 
 // src/hooks/session-start.ts

package/dist/{setup-5APZETPV.js → setup-TVNRAAK3.js}

@@ -7,10 +7,10 @@ import {
   getDataDir,
   getDbPath,
   migrateFromLegacy
-} from "./chunk-WHP4Z32Z.js";
+} from "./chunk-S4GSIEKL.js";
 import {
   SqliteKnowledgeRepository
-} from "./chunk-MMSMDJ4O.js";
+} from "./chunk-ZVDODLZ7.js";
 import "./chunk-KFQGP6VL.js";
 
 // src/setup.ts

package/dist/{sqlite-AUND6HGQ.js → sqlite-MP6SRBBQ.js}

@@ -1,6 +1,6 @@
 import {
   SqliteKnowledgeRepository
-} from "./chunk-MMSMDJ4O.js";
+} from "./chunk-ZVDODLZ7.js";
 import "./chunk-KFQGP6VL.js";
 export {
   SqliteKnowledgeRepository

package/dist/{stop-6SROS34Q.js → stop-HFZZ2LFA.js}

@@ -1,15 +1,15 @@
 import {
   findLatestTranscript
-} from "./chunk-TE6DBLJ5.js";
+} from "./chunk-QVQJPJGX.js";
 import {
   findProjectRoot,
   getDbPath,
   getProjectId,
   isInitialized
-} from "./chunk-WHP4Z32Z.js";
+} from "./chunk-S4GSIEKL.js";
 import {
   SqliteKnowledgeRepository
-} from "./chunk-MMSMDJ4O.js";
+} from "./chunk-ZVDODLZ7.js";
 import "./chunk-KFQGP6VL.js";
 
 // src/hooks/stop.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentcache",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Knowledge cache for AI agents — learns how you work, remembers across sessions, works everywhere",
   "type": "module",
   "license": "MIT",