claudeye 1.0.2 → 1.0.3-beta.1

package/README.md

@@ -31,6 +31,7 @@
   - [`createApp()`](#createapp)
   - [`app.condition(fn)`](#appconditionfn)
   - [`app.queueCondition(fn, options?)`](#appqueueconditionfn-options)
+  - [`app.cacheInvalidation(fn)`](#appcacheinvalidationfn)
   - [`app.eval(name, fn, options?)`](#appevalname-fn-options)
   - [`app.enrich(name, fn, options?)`](#appenrichname-fn-options)
   - [`app.action(name, fn, options?)`](#appactionname-fn-options)
@@ -121,6 +122,7 @@ Works with [Claude Code](https://docs.anthropic.com/en/docs/claude-code) session
 - **Custom evals** - grade sessions with pass/fail results and 0-1 scores
 - **Per-eval recompute** - re-run a single eval without reprocessing all others
 - **Conditional evals** - gate evals globally or per-item, with session/subagent scope control
+- **Cache invalidation hook** - register a custom function via `app.cacheInvalidation()` to invalidate stale cached results based on age, score, or any custom logic
 
 ### Utilize
 
@@ -358,6 +360,36 @@ Both can be set simultaneously. `app.queueCondition()` acts as a pre-filter for
 
 ---
 
+### `app.cacheInvalidation(fn)`
+
+Register a cache invalidation hook that runs before serving any cached eval or enrichment result. If the hook returns `true`, the cached entry is discarded and the item re-runs. Only affects evals and enrichments — actions, alerts, and conditions pass through unchanged.
+
+```ts
+app.cacheInvalidation((ctx) => boolean | Promise<boolean>);
+```
+
+The `ctx` object includes `itemName`, `itemKind` (`"evals"` or `"enrichments"`), `cachedAt` (ISO timestamp), `cachedValue` (the full cached result), `projectName`, `sessionId`, `contentHash`, and `itemCodeHash`.
+
+```js
+// Invalidate cache entries older than 24 hours
+app.cacheInvalidation(({ cachedAt }) => {
+  const age = Date.now() - new Date(cachedAt).getTime();
+  return age > 24 * 60 * 60 * 1000;
+});
+
+// Re-run a specific eval when cached score is 0
+app.cacheInvalidation((ctx) => {
+  if (ctx.itemKind === 'evals' && ctx.itemName === 'no-hallucination') {
+    return ctx.cachedValue.score === 0;
+  }
+  return false;
+});
+```
+
+See [API Reference](docs/api-reference.md#appcacheinvalidationfn) for full documentation.
+
+---
+
 ### `app.eval(name, fn, options?)`
 
 Register an eval function. Evals grade sessions with a pass/fail result and an optional 0-1 score.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudeye",
-  "version": "1.0.2",
+  "version": "1.0.3-beta.1",
   "description": "Watchtower for Claude Code & Agents SDK — replay sessions, run custom evals, debug agent traces locally",
   "bin": {
     "claudeye": "./bin/claudeye.mjs"
@@ -48,10 +48,10 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@claudeye/linux-x64": "1.0.2",
-    "@claudeye/linux-arm64": "1.0.2",
-    "@claudeye/darwin-x64": "1.0.2",
-    "@claudeye/darwin-arm64": "1.0.2",
-    "@claudeye/win32-x64": "1.0.2"
+    "@claudeye/linux-x64": "1.0.3-beta.1",
+    "@claudeye/linux-arm64": "1.0.3-beta.1",
+    "@claudeye/darwin-x64": "1.0.3-beta.1",
+    "@claudeye/darwin-arm64": "1.0.3-beta.1",
+    "@claudeye/win32-x64": "1.0.3-beta.1"
   }
 }