clawvault 1.11.2 → 2.0.0

package/dist/index.js

@@ -1,3 +1,12 @@
+import {
+  buildTemplateVariables,
+  renderTemplate
+} from "./chunk-7766SIJP.js";
+import {
+  SessionWatcher,
+  observeCommand,
+  registerObserveCommand
+} from "./chunk-GZOBCUVO.js";
 import {
   buildSessionRecap,
   formatSessionRecapMarkdown,
@@ -8,20 +17,30 @@ import {
   setupCommand
 } from "./chunk-PIJGYMQZ.js";
 import {
-  buildTemplateVariables,
-  renderTemplate
-} from "./chunk-7766SIJP.js";
+  Compressor,
+  Observer,
+  Reflector,
+  parseSessionFile
+} from "./chunk-KOF3HYSL.js";
 import {
   buildContext,
   contextCommand,
   formatContextMarkdown,
-  registerContextCommand
-} from "./chunk-UBRYOIII.js";
+  inferContextProfile,
+  normalizeContextProfileInput,
+  registerContextCommand,
+  resolveContextProfile
+} from "./chunk-TBVI4N53.js";
+import {
+  checkOpenClawCompatibility,
+  compatCommand,
+  compatibilityExitCode
+} from "./chunk-PAYUH64O.js";
 import {
   ClawVault,
   createVault,
   findVault
-} from "./chunk-3HFB7EMU.js";
+} from "./chunk-QFBKWDYR.js";
 import {
   DEFAULT_CATEGORIES,
   DEFAULT_CONFIG,
@@ -38,16 +57,20 @@ import {
   qmdUpdate
 } from "./chunk-MIIXBNO3.js";
 import {
-  SessionWatcher,
-  observeCommand,
-  registerObserveCommand
-} from "./chunk-GZOBCUVO.js";
+  graphCommand,
+  graphSummary
+} from "./chunk-TXO34J3O.js";
 import {
-  Compressor,
-  Observer,
-  Reflector,
-  parseSessionFile
-} from "./chunk-KOF3HYSL.js";
+  MEMORY_GRAPH_SCHEMA_VERSION,
+  buildOrUpdateMemoryGraphIndex,
+  getMemoryGraph,
+  loadMemoryGraphIndex
+} from "./chunk-O5V7SD5C.js";
+import {
+  findNearestVaultPath,
+  getVaultPath,
+  resolveVaultPath
+} from "./chunk-MXSSG3QU.js";
 
 // src/index.ts
 import * as fs from "fs";
@@ -71,6 +94,7 @@ export {
   Compressor,
   DEFAULT_CATEGORIES,
   DEFAULT_CONFIG,
+  MEMORY_GRAPH_SCHEMA_VERSION,
   MEMORY_TYPES,
   Observer,
   QMD_INSTALL_COMMAND,
@@ -82,16 +106,28 @@ export {
   TYPE_TO_CATEGORY,
   VERSION,
   buildContext,
+  buildOrUpdateMemoryGraphIndex,
   buildSessionRecap,
   buildTemplateVariables,
+  checkOpenClawCompatibility,
+  compatCommand,
+  compatibilityExitCode,
   contextCommand,
   createVault,
   extractTags,
   extractWikiLinks,
+  findNearestVaultPath,
   findVault,
   formatContextMarkdown,
   formatSessionRecapMarkdown,
+  getMemoryGraph,
+  getVaultPath,
+  graphCommand,
+  graphSummary,
   hasQmd,
+  inferContextProfile,
+  loadMemoryGraphIndex,
+  normalizeContextProfileInput,
   observeCommand,
   parseSessionFile,
   qmdEmbed,
@@ -100,6 +136,8 @@ export {
   registerContextCommand,
   registerObserveCommand,
   renderTemplate,
+  resolveContextProfile,
+  resolveVaultPath,
   sessionRecapCommand,
   setupCommand
 };

package/dist/lib/config.d.ts

@@ -2,5 +2,10 @@
  * Get the vault path from CLAWVAULT_PATH env var or throw
  */
 declare function getVaultPath(): string;
+declare function findNearestVaultPath(startPath?: string): string | null;
+declare function resolveVaultPath(options?: {
+    explicitPath?: string;
+    cwd?: string;
+}): string;
 
-export { getVaultPath };
+export { findNearestVaultPath, getVaultPath, resolveVaultPath };

package/dist/lib/config.js

@@ -1,6 +1,10 @@
 import {
-  getVaultPath
-} from "../chunk-4KDZZW4X.js";
+  findNearestVaultPath,
+  getVaultPath,
+  resolveVaultPath
+} from "../chunk-MXSSG3QU.js";
 export {
-  getVaultPath
+  findNearestVaultPath,
+  getVaultPath,
+  resolveVaultPath
 };

package/hooks/clawvault/HOOK.md

@@ -47,7 +47,8 @@ openclaw hooks enable clawvault
 ### Session Start
 
 1. Extracts the initial user prompt (`context.initialPrompt` or first user message)
-2. Runs `clawvault context "<prompt>" --format json -v <vaultPath>`
+2. Runs `clawvault context "<prompt>" --format json --profile auto -v <vaultPath>`
+   - Delegates profile selection to the shared context intent policy (`incident`, `planning`, `handoff`, or `default`)
 3. Injects up to 4 relevant context bullets into session messages
 
 Injection format:
@@ -58,6 +59,10 @@ Injection format:
 - <title> (<age>): <snippet>
 ```
 
+### Event Compatibility
+
+The hook accepts canonical OpenClaw events (`gateway:startup`, `command:new`, `session:start`) and tolerates alias payload shapes (`event`, `eventName`, `name`, `hook`, `trigger`) to remain robust across runtime wrappers.
+
 ## No Configuration Needed
 
 Just enable the hook. It auto-detects vault path via:

package/hooks/clawvault/handler.js

@@ -18,6 +18,7 @@ const MAX_CONTEXT_PROMPT_LENGTH = 500;
 const MAX_CONTEXT_SNIPPET_LENGTH = 220;
 const MAX_RECAP_RESULTS = 6;
 const MAX_RECAP_SNIPPET_LENGTH = 220;
+const EVENT_NAME_SEPARATOR_RE = /[.:/]/g;
 
 // Sanitize string for safe display (prevent prompt injection via control chars)
 function sanitizeForDisplay(str) {
@@ -228,6 +229,45 @@ function injectSystemMessage(event, message) {
   return true;
 }
 
+function normalizeEventToken(value) {
+  if (typeof value !== 'string') return '';
+  return value
+    .trim()
+    .toLowerCase()
+    .replace(/\s+/g, '')
+    .replace(EVENT_NAME_SEPARATOR_RE, ':');
+}
+
+function eventMatches(event, type, action) {
+  const normalizedExpected = `${normalizeEventToken(type)}:${normalizeEventToken(action)}`;
+  const normalizedType = normalizeEventToken(event?.type);
+  const normalizedAction = normalizeEventToken(event?.action);
+
+  if (normalizedType && normalizedAction) {
+    if (`${normalizedType}:${normalizedAction}` === normalizedExpected) {
+      return true;
+    }
+  }
+
+  const aliases = [
+    event?.event,
+    event?.name,
+    event?.hook,
+    event?.trigger,
+    event?.eventName
+  ];
+
+  for (const alias of aliases) {
+    const normalizedAlias = normalizeEventToken(alias);
+    if (!normalizedAlias) continue;
+    if (normalizedAlias === normalizedExpected) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
 // Validate vault path - must be absolute and exist
 function validateVaultPath(vaultPath) {
   if (!vaultPath || typeof vaultPath !== 'string') return null;
@@ -435,6 +475,7 @@ async function handleSessionStart(event) {
       'context',
       prompt,
       '--format', 'json',
+      '--profile', 'auto',
       '-v', vaultPath
     ]);
 
@@ -462,17 +503,17 @@ async function handleSessionStart(event) {
 // Main handler - route events
 const handler = async (event) => {
   try {
-    if (event.type === 'gateway' && event.action === 'startup') {
+    if (eventMatches(event, 'gateway', 'startup')) {
       await handleStartup(event);
       return;
     }
 
-    if (event.type === 'command' && event.action === 'new') {
+    if (eventMatches(event, 'command', 'new')) {
       await handleNew(event);
       return;
     }
 
-    if (event.type === 'session' && event.action === 'start') {
+    if (eventMatches(event, 'session', 'start')) {
       await handleSessionStart(event);
       return;
     }

package/hooks/clawvault/handler.test.js

@@ -0,0 +1,161 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+
+const { execFileSyncMock } = vi.hoisted(() => ({
+  execFileSyncMock: vi.fn()
+}));
+
+vi.mock('child_process', () => ({
+  execFileSync: execFileSyncMock
+}));
+
+function makeVaultFixture() {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'clawvault-hook-'));
+  fs.writeFileSync(path.join(root, '.clawvault.json'), JSON.stringify({ name: 'test' }), 'utf-8');
+  return root;
+}
+
+async function loadHandler() {
+  vi.resetModules();
+  const mod = await import('./handler.js');
+  return mod.default;
+}
+
+afterEach(() => {
+  vi.clearAllMocks();
+  delete process.env.CLAWVAULT_PATH;
+});
+
+describe('clawvault hook handler', () => {
+  it('injects recovery warning on gateway startup when death detected', async () => {
+    const vaultPath = makeVaultFixture();
+    process.env.CLAWVAULT_PATH = vaultPath;
+
+    execFileSyncMock.mockImplementation((_command, args) => {
+      if (args[0] === 'recover') {
+        return '⚠️ CONTEXT DEATH DETECTED\nWorking on: ship memory graph';
+      }
+      return '';
+    });
+
+    const handler = await loadHandler();
+    const event = {
+      type: 'gateway',
+      action: 'startup',
+      messages: [{ role: 'user', content: 'hello' }]
+    };
+
+    await handler(event);
+
+    expect(execFileSyncMock).toHaveBeenCalledWith(
+      'clawvault',
+      expect.arrayContaining(['recover', '--clear', '-v', vaultPath]),
+      expect.objectContaining({ shell: false })
+    );
+    const injected = event.messages.find((message) => message.role === 'system');
+    expect(injected?.content).toContain('Context death detected');
+    expect(injected?.content).toContain('ship memory graph');
+
+    fs.rmSync(vaultPath, { recursive: true, force: true });
+  });
+
+  it('supports alias event names for command:new', async () => {
+    const vaultPath = makeVaultFixture();
+    process.env.CLAWVAULT_PATH = vaultPath;
+    execFileSyncMock.mockReturnValue('');
+
+    const handler = await loadHandler();
+    await handler({
+      event: 'command:new',
+      sessionKey: 'agent:clawdious:main',
+      context: { commandSource: 'cli' }
+    });
+
+    expect(execFileSyncMock).toHaveBeenCalledWith(
+      'clawvault',
+      expect.arrayContaining(['checkpoint', '--working-on']),
+      expect.objectContaining({ shell: false })
+    );
+
+    fs.rmSync(vaultPath, { recursive: true, force: true });
+  });
+
+  it('injects recap and memory context on session start alias event', async () => {
+    const vaultPath = makeVaultFixture();
+    process.env.CLAWVAULT_PATH = vaultPath;
+
+    execFileSyncMock.mockImplementation((_command, args) => {
+      if (args[0] === 'session-recap') {
+        return JSON.stringify({
+          messages: [
+            { role: 'user', text: 'Need a migration plan.' },
+            { role: 'assistant', text: 'Suggested phased rollout.' }
+          ]
+        });
+      }
+      if (args[0] === 'context') {
+        return JSON.stringify({
+          context: [
+            {
+              title: 'Use Postgres',
+              age: '1 day ago',
+              snippet: 'Selected Postgres for durability.'
+            }
+          ]
+        });
+      }
+      return '';
+    });
+
+    const handler = await loadHandler();
+    const event = {
+      eventName: 'session:start',
+      sessionKey: 'agent:clawdious:main',
+      context: { initialPrompt: 'Need migration plan' },
+      messages: [{ role: 'user', content: 'Need migration plan' }]
+    };
+
+    await handler(event);
+
+    const contextCall = execFileSyncMock.mock.calls.find((call) => call[1]?.[0] === 'context');
+    expect(contextCall?.[1]).toEqual(expect.arrayContaining(['--profile', 'auto']));
+
+    const injected = event.messages.find((message) => message.role === 'system');
+    expect(injected?.content).toContain('Session context restored');
+    expect(injected?.content).toContain('Recent conversation');
+    expect(injected?.content).toContain('Relevant memories');
+    expect(injected?.content).toContain('Use Postgres');
+
+    fs.rmSync(vaultPath, { recursive: true, force: true });
+  });
+
+  it('delegates profile selection to context auto mode for urgent prompts', async () => {
+    const vaultPath = makeVaultFixture();
+    process.env.CLAWVAULT_PATH = vaultPath;
+
+    execFileSyncMock.mockImplementation((_command, args) => {
+      if (args[0] === 'session-recap') {
+        return JSON.stringify({ messages: [] });
+      }
+      if (args[0] === 'context') {
+        return JSON.stringify({ context: [] });
+      }
+      return '';
+    });
+
+    const handler = await loadHandler();
+    await handler({
+      eventName: 'session:start',
+      sessionKey: 'agent:clawdious:main',
+      context: { initialPrompt: 'URGENT outage: rollback failed in production' },
+      messages: [{ role: 'user', content: 'URGENT outage: rollback failed in production' }]
+    });
+
+    const contextCall = execFileSyncMock.mock.calls.find((call) => call[1]?.[0] === 'context');
+    expect(contextCall?.[1]).toEqual(expect.arrayContaining(['--profile', 'auto']));
+
+    fs.rmSync(vaultPath, { recursive: true, force: true });
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawvault",
-  "version": "1.11.2",
+  "version": "2.0.0",
   "description": "ClawVault™ - 🐘 An elephant never forgets. Structured memory for OpenClaw agents. Context death resilience, Obsidian-compatible markdown, local semantic search.",
   "type": "module",
   "main": "dist/index.cjs",
@@ -29,11 +29,42 @@
     ]
   },
   "scripts": {
-    "build": "tsup src/index.ts src/commands/entities.ts src/commands/link.ts src/commands/checkpoint.ts src/commands/recover.ts src/commands/status.ts src/commands/template.ts src/commands/setup.ts src/commands/context.ts src/commands/observe.ts src/commands/session-recap.ts src/commands/wake.ts src/commands/sleep.ts src/commands/doctor.ts src/commands/shell-init.ts src/commands/repair-session.ts src/lib/entity-index.ts src/lib/auto-linker.ts src/lib/config.ts src/lib/template-engine.ts src/lib/session-utils.ts src/lib/session-repair.ts --format esm --dts --clean",
+    "build": "tsup src/index.ts src/commands/entities.ts src/commands/link.ts src/commands/checkpoint.ts src/commands/recover.ts src/commands/status.ts src/commands/template.ts src/commands/setup.ts src/commands/context.ts src/commands/observe.ts src/commands/session-recap.ts src/commands/wake.ts src/commands/sleep.ts src/commands/doctor.ts src/commands/compat.ts src/commands/graph.ts src/commands/shell-init.ts src/commands/repair-session.ts src/lib/entity-index.ts src/lib/auto-linker.ts src/lib/config.ts src/lib/template-engine.ts src/lib/session-utils.ts src/lib/session-repair.ts --format esm --dts --clean",
     "dev": "tsup src/index.ts src/commands/*.ts src/lib/*.ts --format esm --dts --watch",
     "lint": "eslint src",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
+    "test:compat-fixtures": "npm run build && node scripts/check-compat-fixtures.mjs",
+    "test:compat-fixtures:fast": "node scripts/check-compat-fixtures.mjs",
+    "test:compat-fixtures:fast:report": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-fixtures:fast",
+    "test:compat-contract": "npm run build && COMPAT_VALIDATE_ONLY=1 node scripts/check-compat-fixtures.mjs",
+    "test:compat-contract:fast": "COMPAT_VALIDATE_ONLY=1 node scripts/check-compat-fixtures.mjs",
+    "test:compat-summary:verify": "node scripts/validate-compat-summary.mjs",
+    "test:compat-report-schemas:verify": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} node scripts/validate-compat-report-schemas.mjs",
+    "test:compat-report-schemas:verify:report": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} node scripts/validate-compat-report-schemas.mjs --out ${COMPAT_REPORT_DIR:-.compat-reports}/report-schema-validator-result.json",
+    "test:compat-report-schemas:verify:schema": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} node scripts/validate-json-schema.mjs --schema schemas/compat-report-schema-validator-output.schema.json --data ${COMPAT_REPORT_DIR:-.compat-reports}/report-schema-validator-result.json",
+    "test:compat-artifact-bundle:verify": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} node scripts/validate-compat-artifact-bundle.mjs",
+    "test:compat-artifact-bundle:verify:report": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} node scripts/validate-compat-artifact-bundle.mjs --out ${COMPAT_REPORT_DIR:-.compat-reports}/artifact-bundle-validator-result.json",
+    "test:compat-artifact-bundle:verify:schema": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} node scripts/validate-json-schema.mjs --schema schemas/compat-artifact-bundle-validator-output.schema.json --data ${COMPAT_REPORT_DIR:-.compat-reports}/artifact-bundle-validator-result.json",
+    "test:compat-artifact-bundle:manifest:schema": "node scripts/validate-json-schema.mjs --schema schemas/compat-artifact-bundle.manifest.schema.json --data schemas/compat-artifact-bundle.manifest.json",
+    "test:compat-artifact-bundle:manifest:verify": "node scripts/validate-compat-artifact-bundle-manifest.mjs",
+    "test:compat-artifact-bundle:manifest:verify:report": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} node scripts/validate-compat-artifact-bundle-manifest.mjs --out ${COMPAT_REPORT_DIR:-.compat-reports}/artifact-bundle-manifest-validator-result.json",
+    "test:compat-artifact-bundle:manifest:verify:schema": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} node scripts/validate-json-schema.mjs --schema schemas/compat-artifact-bundle-manifest-validator-output.schema.json --data ${COMPAT_REPORT_DIR:-.compat-reports}/artifact-bundle-manifest-validator-result.json",
+    "test:compat-artifact-alignment:fast": "vitest run scripts/lib/compat-artifact-bundle-manifest-contract-alignment.test.js scripts/lib/compat-artifact-bundle-manifest-schema-alignment.test.js scripts/lib/compat-artifact-bundle-output-schema-alignment.test.js",
+    "test:compat-artifact-cli-drift:fast": "vitest run scripts/validate-compat-artifact-bundle-manifest.test.js scripts/validate-compat-artifact-bundle.test.js",
+    "test:compat-script-stack-contract:fast": "vitest run scripts/lib/compat-contract-assertion-test-utils.test.js scripts/lib/compat-contract-test-utils.test.js scripts/lib/compat-npm-script-contracts.test.js scripts/lib/compat-npm-script-graph-utils.test.js scripts/lib/compat-npm-script-stack-contract.test.js scripts/lib/compat-readme-contract.test.js scripts/lib/compat-ci-workflow-test-utils.test.js scripts/lib/compat-ci-workflow-contracts.test.js scripts/lib/compat-ci-workflow-contract.test.js",
+    "test:compat-validator-stack:fast": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-validator-result:verify:report && COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-validator-result:schema && COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-schema-validator-result:verify && COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-validator-result:verify:schema",
+    "test:compat-artifact-stack:fast": "npm run test:compat-artifact-alignment:fast && npm run test:compat-artifact-cli-drift:fast && npm run test:compat-artifact-bundle:manifest:schema && COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-artifact-bundle:manifest:verify:report && COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-artifact-bundle:manifest:verify:schema && COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-artifact-bundle:verify:report && COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-artifact-bundle:verify:schema",
+    "test:compat-report-stack:fast": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-report-schemas:verify:report && COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-report-schemas:verify:schema && COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-validator-stack:fast && COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-artifact-stack:fast",
+    "test:compat-validator-result:verify": "node scripts/validate-compat-validator-result.mjs --require-ok",
+    "test:compat-validator-result:verify:report": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} node scripts/validate-compat-validator-result.mjs --require-ok --out ${COMPAT_REPORT_DIR:-.compat-reports}/validator-result-verifier-result.json",
+    "test:compat-validator-result:verify:schema": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} node scripts/validate-json-schema.mjs --schema schemas/compat-validator-result-verifier-output.schema.json --data ${COMPAT_REPORT_DIR:-.compat-reports}/validator-result-verifier-result.json",
+    "test:compat-validator-result:schema": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} node scripts/validate-json-schema.mjs --schema schemas/compat-summary-validator-output.schema.json --data ${COMPAT_REPORT_DIR:-.compat-reports}/validator-result.json --out ${COMPAT_REPORT_DIR:-.compat-reports}/schema-validator-result.json",
+    "test:compat-schema-validator-result:verify": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} node scripts/validate-json-schema.mjs --schema schemas/json-schema-validator-output.schema.json --data ${COMPAT_REPORT_DIR:-.compat-reports}/schema-validator-result.json",
+    "test:compat-summary": "COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-fixtures && COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} node scripts/validate-compat-summary.mjs --out ${COMPAT_REPORT_DIR:-.compat-reports}/validator-result.json",
+    "test:compat-summary:fast": "npm run test:compat-script-stack-contract:fast && COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-fixtures:fast && COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} node scripts/validate-compat-summary.mjs --out ${COMPAT_REPORT_DIR:-.compat-reports}/validator-result.json && COMPAT_REPORT_DIR=${COMPAT_REPORT_DIR:-.compat-reports} npm run test:compat-report-stack:fast",
+    "test:compat-smoke": "npm run test:compat-contract:fast && COMPAT_CASES=healthy npm run test:compat-fixtures:fast",
+    "ci": "npm run test:compat-script-stack-contract:fast && npm run typecheck && npm test && npm run build && npm run test:compat-contract:fast && npm run test:compat-summary:fast",
     "seo:generate": "node generate-seo-assets.mjs",
     "prepublishOnly": "npm run build"
   },
@@ -83,6 +114,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.11.0",
+    "ajv": "^8.17.1",
     "puppeteer": "^24.37.2",
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",