@adhd/agent-engine-compiler 2.1.0

package/drizzle/meta/_journal.json

@@ -0,0 +1,5 @@
+{
+  "version": "7",
+  "dialect": "sqlite",
+  "entries": []
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@adhd/agent-engine-compiler",
+  "version": "2.1.0",
+  "description": "Registry-family store for agent-compiler: drizzle-backed SQLite tables sharing the one registry database.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "drizzle"
+  ],
+  "bin": {
+    "agent-compiler": "./src/cli/compile.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    }
+  },
+  "scripts": {
+    "build": "nx build agent-compiler",
+    "typecheck": "tsc -p tsconfig.lib.json --noEmit",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate"
+  },
+  "dependencies": {
+    "better-sqlite3": "12.10.0",
+    "drizzle-orm": "0.45.2",
+    "@adhd/agent-store-prompts": "^2.1.0",
+    "@adhd/agent-store-tools": "^2.1.0",
+    "@adhd/agent-core-provider": "^2.1.0",
+    "@adhd/agent-core-policy": "^2.1.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@vitest/coverage-v8": "^1.0.4",
+    "drizzle-kit": "^0.31.10",
+    "tslib": "^2.6.0",
+    "typescript": "^5.5.0",
+    "vite": "~5.0.13",
+    "vite-plugin-dts": "~3.8.3",
+    "vitest": "^1.6.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PseudoSky/adhd.git",
+    "directory": "packages/agent/agent-engine-compiler"
+  },
+  "homepage": "https://github.com/PseudoSky/adhd/tree/main/packages/agent/agent-engine-compiler#readme",
+  "bugs": {
+    "url": "https://github.com/PseudoSky/adhd/issues"
+  },
+  "module": "./src/index.js",
+  "main": "./src/index.js"
+}

package/src/cache/composed-prompt-cache.d.ts

@@ -0,0 +1,60 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+import type { ComposedPrompt } from '@adhd/agent-store-prompts';
+import type { ComponentVersionMap } from '../resolve/composition.js';
+/**
+ * Compute the combined `context_hash` for the `registry_composed_prompts` cache.
+ *
+ * Decision D (decisions.md): `context_hash = SHA-256(sortedJSON(context) + " " +
+ * sortedJSON(componentVersions) + " " + platform)`.
+ *
+ * The `registryContextHash` (from @adhd/agent-registry) handles sorted-key JSON
+ * canonicalization of the context part.  We apply the same sorted-key approach to
+ * `componentVersions` and append the `platform` string as a third field so that any
+ * of the three inputs changing produces a distinct hash.
+ *
+ * A ` ` (space) field separator is used between parts — plain JSON can never contain
+ * an unescaped space at the top level, so the three blobs cannot collide by
+ * concatenation.
+ *
+ * @param context           - Runtime context key/value map (e.g. `{ticket_type:"security"}`).
+ * @param componentVersions - Resolved component-version map from `resolveComposition`.
+ * @param platform          - Target platform id (e.g. `claude_code`, `claude_api`).
+ * @returns 64-character lowercase hex SHA-256 string.
+ */
+export declare function computeContextHash(context: Record<string, string>, componentVersions: ComponentVersionMap, platform: string): string;
+/**
+ * Look up a `registry_composed_prompts` row by `(agentSlug, platform, context_hash)`.
+ *
+ * The `context_hash` encodes `(context, componentVersions, platform)` per Decision D.
+ * Returns the cached row (with its `id`) on a HIT, or `null` on a MISS.
+ *
+ * A cache hit means `compileAgent` can return the persisted `{id, content}` WITHOUT
+ * re-running the resolve layers (the assembly step is bypassed).  This is the
+ * `[dod.4]` negative-control guarantee: removing this SELECT before assembly causes
+ * a duplicate row on every compile.
+ *
+ * @param db                - Shared Drizzle handle (all four table prefixes).
+ * @param agentSlug         - Agent to look up.
+ * @param platform          - Target platform id.
+ * @param context           - Runtime context key/value map.
+ * @param componentVersions - Resolved component-version map from `resolveComposition`.
+ * @returns The cached `ComposedPrompt` row on a HIT, or `null` on a MISS.
+ */
+export declare function lookup(db: BetterSQLite3Database<any>, agentSlug: string, platform: string, context: Record<string, string>, componentVersions: ComponentVersionMap): ComposedPrompt | null;
+/**
+ * Write a new `registry_composed_prompts` row for `(agentSlug, platform, context_hash)`.
+ *
+ * Called on a cache MISS: after assembly is complete, persists the composed prompt
+ * so subsequent compiles can hit the cache.  Returns the inserted row, including the
+ * generated `id` (the [def:composed-output].id audit/cache handle).
+ *
+ * @param db                - Shared Drizzle handle (all four table prefixes).
+ * @param agentSlug         - Agent the row belongs to.
+ * @param platform          - Target platform id (folded into the hash).
+ * @param context           - Runtime context key/value map used for assembly.
+ * @param componentVersions - Resolved component-version map (audit trail).
+ * @param content           - The assembled platform artifact (markdown, JSON, etc.).
+ * @returns The inserted `ComposedPrompt` row with its generated `id`.
+ */
+export declare function write(db: BetterSQLite3Database<any>, agentSlug: string, platform: string, context: Record<string, string>, componentVersions: ComponentVersionMap, content: string): ComposedPrompt;
+//# sourceMappingURL=composed-prompt-cache.d.ts.map

package/src/cache/composed-prompt-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composed-prompt-cache.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/cache/composed-prompt-cache.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAMxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAMrE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,iBAAiB,EAAE,mBAAmB,EACtC,QAAQ,EAAE,MAAM,GACf,MAAM,CAiBR;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAEpB,EAAE,EAAE,qBAAqB,CAAC,GAAG,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,iBAAiB,EAAE,mBAAmB,GACrC,cAAc,GAAG,IAAI,CAIvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAEnB,EAAE,EAAE,qBAAqB,CAAC,GAAG,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,iBAAiB,EAAE,mBAAmB,EACtC,OAAO,EAAE,MAAM,GACd,cAAc,CAShB"}

package/src/cache/composed-prompt-cache.js

@@ -0,0 +1,120 @@
+// ──────────────────────────────────────────────
+// composed-prompt-cache — cache lookup + write for the composed_prompts table.
+//
+// Implements Decision D (decisions.md [def:context-hash]):
+//   context_hash = SHA-256( sortedJSON(context) + " " + sortedJSON(componentVersions) + " " + platform )
+//
+// The three-part key encodes:
+//   1. The runtime context (any key/value change → different hash → cache miss).
+//   2. The resolved component-version set (an unpinned component advancing to a
+//      new latest → different componentVersions → miss).
+//   3. The target platform (different platform → different content shape → miss).
+//
+// The "context part" reuses @adhd/agent-registry's exported `contextHash` helper
+// for consistent sorted-key JSON canonicalization — do NOT reimplement
+// ([ref:store-read], decisions.md Decision D note).
+//
+// The composed_prompts table comes from @adhd/agent-registry (plan 1,
+// `registry_composed_prompts`).  We use the existing table via the shared DB
+// handle passed by `compileAgent` ([inv:one-db-handle]).  No duplicate table
+// is created here.
+//
+// [def:context-hash]    — the combined cache key algorithm (decisions.md Decision D)
+// [inv:one-db-handle]   — shared Drizzle handle, all four table prefixes
+// [inv:reopen-proves-cache] — persistence proven by CLOSE+REOPEN (test invariant)
+// ──────────────────────────────────────────────
+import { createHash } from 'node:crypto';
+import { ComposedPromptStore, contextHash as registryContextHash, } from '@adhd/agent-store-prompts';
+// ──────────────────────────────────────────────
+// Combined cache-key hash
+// ──────────────────────────────────────────────
+/**
+ * Compute the combined `context_hash` for the `registry_composed_prompts` cache.
+ *
+ * Decision D (decisions.md): `context_hash = SHA-256(sortedJSON(context) + " " +
+ * sortedJSON(componentVersions) + " " + platform)`.
+ *
+ * The `registryContextHash` (from @adhd/agent-registry) handles sorted-key JSON
+ * canonicalization of the context part.  We apply the same sorted-key approach to
+ * `componentVersions` and append the `platform` string as a third field so that any
+ * of the three inputs changing produces a distinct hash.
+ *
+ * A ` ` (space) field separator is used between parts — plain JSON can never contain
+ * an unescaped space at the top level, so the three blobs cannot collide by
+ * concatenation.
+ *
+ * @param context           - Runtime context key/value map (e.g. `{ticket_type:"security"}`).
+ * @param componentVersions - Resolved component-version map from `resolveComposition`.
+ * @param platform          - Target platform id (e.g. `claude_code`, `claude_api`).
+ * @returns 64-character lowercase hex SHA-256 string.
+ */
+export function computeContextHash(context, componentVersions, platform) {
+    // Part 1: sorted-key JSON of context (reuse the upstream helper for parity).
+    const contextPart = registryContextHash(context);
+    // Part 2: sorted-key JSON of componentVersions (apply the same canonicalization).
+    const sortedVersions = Object.fromEntries(Object.keys(componentVersions)
+        .sort()
+        .map((k) => [k, componentVersions[k]]));
+    const versionPart = JSON.stringify(sortedVersions);
+    // Combined: context_hash(context) + " " + sortedJSON(componentVersions) + " " + platform
+    // Field separator is a bare space — JSON strings never contain unescaped spaces
+    // at the outermost level, so the three segments cannot collide.
+    const combined = `${contextPart} ${versionPart} ${platform}`;
+    return createHash('sha256').update(combined, 'utf8').digest('hex');
+}
+// ──────────────────────────────────────────────
+// Cache operations
+// ──────────────────────────────────────────────
+/**
+ * Look up a `registry_composed_prompts` row by `(agentSlug, platform, context_hash)`.
+ *
+ * The `context_hash` encodes `(context, componentVersions, platform)` per Decision D.
+ * Returns the cached row (with its `id`) on a HIT, or `null` on a MISS.
+ *
+ * A cache hit means `compileAgent` can return the persisted `{id, content}` WITHOUT
+ * re-running the resolve layers (the assembly step is bypassed).  This is the
+ * `[dod.4]` negative-control guarantee: removing this SELECT before assembly causes
+ * a duplicate row on every compile.
+ *
+ * @param db                - Shared Drizzle handle (all four table prefixes).
+ * @param agentSlug         - Agent to look up.
+ * @param platform          - Target platform id.
+ * @param context           - Runtime context key/value map.
+ * @param componentVersions - Resolved component-version map from `resolveComposition`.
+ * @returns The cached `ComposedPrompt` row on a HIT, or `null` on a MISS.
+ */
+export function lookup(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+db, agentSlug, platform, context, componentVersions) {
+    const hash = computeContextHash(context, componentVersions, platform);
+    const store = new ComposedPromptStore(db);
+    return store.lookup(agentSlug, hash);
+}
+/**
+ * Write a new `registry_composed_prompts` row for `(agentSlug, platform, context_hash)`.
+ *
+ * Called on a cache MISS: after assembly is complete, persists the composed prompt
+ * so subsequent compiles can hit the cache.  Returns the inserted row, including the
+ * generated `id` (the [def:composed-output].id audit/cache handle).
+ *
+ * @param db                - Shared Drizzle handle (all four table prefixes).
+ * @param agentSlug         - Agent the row belongs to.
+ * @param platform          - Target platform id (folded into the hash).
+ * @param context           - Runtime context key/value map used for assembly.
+ * @param componentVersions - Resolved component-version map (audit trail).
+ * @param content           - The assembled platform artifact (markdown, JSON, etc.).
+ * @returns The inserted `ComposedPrompt` row with its generated `id`.
+ */
+export function write(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+db, agentSlug, platform, context, componentVersions, content) {
+    const hash = computeContextHash(context, componentVersions, platform);
+    const store = new ComposedPromptStore(db);
+    return store.write({
+        agentSlug,
+        contextHash: hash,
+        content,
+        componentVersions,
+    });
+}
+//# sourceMappingURL=composed-prompt-cache.js.map

package/src/cache/composed-prompt-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composed-prompt-cache.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/cache/composed-prompt-cache.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,+EAA+E;AAC/E,EAAE;AACF,2DAA2D;AAC3D,yGAAyG;AACzG,EAAE;AACF,8BAA8B;AAC9B,iFAAiF;AACjF,gFAAgF;AAChF,yDAAyD;AACzD,kFAAkF;AAClF,EAAE;AACF,iFAAiF;AACjF,uEAAuE;AACvE,oDAAoD;AACpD,EAAE;AACF,sEAAsE;AACtE,6EAA6E;AAC7E,6EAA6E;AAC7E,mBAAmB;AACnB,EAAE;AACF,qFAAqF;AACrF,yEAAyE;AACzE,kFAAkF;AAClF,iDAAiD;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EACL,mBAAmB,EACnB,WAAW,IAAI,mBAAmB,GACnC,MAAM,2BAA2B,CAAC;AAInC,iDAAiD;AACjD,0BAA0B;AAC1B,iDAAiD;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAA+B,EAC/B,iBAAsC,EACtC,QAAgB;IAEhB,6EAA6E;IAC7E,MAAM,WAAW,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAEjD,kFAAkF;IAClF,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CACvC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC;SAC3B,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAU,CAAC,CAClD,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAEnD,yFAAyF;IACzF,gFAAgF;IAChF,gEAAgE;IAChE,MAAM,QAAQ,GAAG,GAAG,WAAW,IAAI,WAAW,IAAI,QAAQ,EAAE,CAAC;IAC7D,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC;AAED,iDAAiD;AACjD,mBAAmB;AACnB,iDAAiD;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,MAAM;AACpB,8DAA8D;AAC9D,EAA8B,EAC9B,SAAiB,EACjB,QAAgB,EAChB,OAA+B,EAC/B,iBAAsC;IAEtC,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,IAAI,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,KAAK;AACnB,8DAA8D;AAC9D,EAA8B,EAC9B,SAAiB,EACjB,QAAgB,EAChB,OAA+B,EAC/B,iBAAsC,EACtC,OAAe;IAEf,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,IAAI,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,KAAK,CAAC;QACjB,SAAS;QACT,WAAW,EAAE,IAAI;QACjB,OAAO;QACP,iBAAiB;KAClB,CAAC,CAAC;AACL,CAAC"}

package/src/cli/compile.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=compile.d.ts.map

package/src/cli/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/cli/compile.ts"],"names":[],"mappings":""}

package/src/cli/compile.js

@@ -0,0 +1,294 @@
+#!/usr/bin/env node
+// ──────────────────────────────────────────────
+// cli/compile.ts — argv parser + dispatcher for the agent-compiler bin.
+//
+// Usage:
+//   node cli/compile.js compile <slug> [options]
+//
+// Options:
+//   --platform <p>      Target platform (default: claude_code).
+//                       Must match a row in tool_platforms.
+//   --context '<json>'  Runtime context key/value object (JSON string).
+//   --format json       Emit JSON instead of platform default.
+//   --out-dir <d>       Write <slug>.md (or <slug>.json) under <d>
+//                       instead of printing to stdout.
+//   --all               Compile every agent in the registry (use with
+//                       --category to limit scope).
+//   --category <c>      Filter to agents in this taxonomy category slug.
+//   --db <path>         Path to the SQLite registry file. Defaults to
+//                       AGENT_REGISTRY_DB env var, then ~/.agent-registry/registry.db.
+//
+// Exit codes:
+//   0  — success
+//   1  — unknown slug / unknown platform / bad argument / I/O error
+//
+// [ref:cli-bin] — mirrors agent-mcp's bin entry in package.json;
+//   parses compile <slug> ... and writes content to stdout or --out-dir.
+// [inv:platform-node] — no browser imports; pure Node + SQLite.
+// [inv:one-db-handle] — opens ONE better-sqlite3 handle for the shared DB.
+// ──────────────────────────────────────────────
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import process from 'node:process';
+import { fileURLToPath } from 'node:url';
+import Database from 'better-sqlite3';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+import { migrate } from 'drizzle-orm/better-sqlite3/migrator';
+import { AgentStore } from '@adhd/agent-store-prompts';
+import { compileAgent } from '../compile.js';
+// ── Migration folders ─────────────────────────────────────────────────────
+//
+// Resolved relative to this compiled file's __dirname at runtime so the bin
+// works from the dist layout without referencing source paths.
+//
+// dist/packages/agent/agent-engine-compiler/src/cli/compile.js
+//   → ../../               = dist/packages/agent/agent-engine-compiler/
+//   → ../../../            = dist/packages/agent/
+//   → ../../../<pkg>/drizzle = dist/packages/agent/<pkg>/drizzle
+//
+// Timestamp order (ascending) matters so Drizzle's journal bookkeeping
+// doesn't skip a migration set:
+//   provider (1750*)  →  registry (1782193*)  →  tool-registry (1782250*)
+//     →  policy (1782256*)  →  compiler (18*)
+//
+// This mirrors the migration order in compile-agent.test.ts.
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const AI_DIST = path.resolve(__dirname, '../../../');
+const PROVIDER_MIGRATIONS = path.join(AI_DIST, 'agent-core-provider/drizzle');
+const REGISTRY_MIGRATIONS = path.join(AI_DIST, 'agent-store-prompts/drizzle');
+const TOOL_REGISTRY_MIGRATIONS = path.join(AI_DIST, 'agent-store-tools/drizzle');
+const POLICY_MIGRATIONS = path.join(AI_DIST, 'agent-core-policy/drizzle');
+const COMPILER_MIGRATIONS = path.join(AI_DIST, 'agent-engine-compiler/drizzle');
+// ──────────────────────────────────────────────
+// argv parser
+// ──────────────────────────────────────────────
+/**
+ * Parse process.argv into a CliArgs object.
+ * Exits 1 with a usage message on any parse error.
+ */
+function parseArgs(argv) {
+    // argv: [ node, compile.js, 'compile', <slug?>, ...flags ]
+    const args = argv.slice(2); // strip node + script path
+    if (args[0] !== 'compile') {
+        die(`Expected sub-command 'compile', got: ${args[0] ?? '(nothing)'}`);
+    }
+    let slug = null;
+    let platform = 'claude_code';
+    let context = {};
+    let formatJson = false;
+    let outDir = null;
+    let all = false;
+    let category = null;
+    let dbPath = process.env['AGENT_REGISTRY_DB'] ??
+        path.join(os.homedir(), '.agent-registry', 'registry.db');
+    const flags = args.slice(1); // everything after 'compile'
+    let i = 0;
+    while (i < flags.length) {
+        const tok = flags[i];
+        if (tok === '--platform') {
+            platform = requireNext(flags, i, '--platform');
+            i += 2;
+        }
+        else if (tok === '--context') {
+            const raw = requireNext(flags, i, '--context');
+            try {
+                // Parse as unknown first, then cast to CompositionContext (Record<string, string>).
+                // The runtime contract is that --context values are string-keyed, string-valued.
+                context = JSON.parse(raw);
+            }
+            catch {
+                die(`--context must be valid JSON; got: ${raw}`);
+            }
+            i += 2;
+        }
+        else if (tok === '--format') {
+            const fmt = requireNext(flags, i, '--format');
+            if (fmt !== 'json') {
+                die(`--format only supports 'json'; got: '${fmt}'`);
+            }
+            formatJson = true;
+            i += 2;
+        }
+        else if (tok === '--out-dir') {
+            outDir = requireNext(flags, i, '--out-dir');
+            i += 2;
+        }
+        else if (tok === '--all') {
+            all = true;
+            i++;
+        }
+        else if (tok === '--category') {
+            category = requireNext(flags, i, '--category');
+            i += 2;
+        }
+        else if (tok === '--db') {
+            dbPath = requireNext(flags, i, '--db');
+            i += 2;
+        }
+        else if (tok != null && !tok.startsWith('-')) {
+            // Positional slug — only accepted once.
+            if (slug !== null) {
+                die(`Unexpected extra positional argument: '${tok}'`);
+            }
+            slug = tok;
+            i++;
+        }
+        else {
+            die(`Unknown flag: '${tok}'`);
+        }
+    }
+    if (!all && slug === null) {
+        die('Provide a slug (compile <slug>) or use --all [--category <c>]');
+    }
+    if (all && slug !== null) {
+        die('--all and a positional slug are mutually exclusive');
+    }
+    return { slug, platform, context, formatJson, outDir, all, category, dbPath };
+}
+function requireNext(flags, i, flag) {
+    const val = flags[i + 1];
+    if (val == null || val.startsWith('-')) {
+        die(`${flag} requires a value`);
+    }
+    return val;
+}
+// ──────────────────────────────────────────────
+// DB open helper
+// ──────────────────────────────────────────────
+/**
+ * Open the shared SQLite registry file and apply migrations so the schema is
+ * always current ([inv:one-db-handle]).
+ *
+ * Runs all five migration sets in ascending timestamp order so Drizzle's
+ * journal does not skip any set.
+ */
+function openDb(dbPath) {
+    if (!fs.existsSync(dbPath)) {
+        const parent = path.dirname(dbPath);
+        if (!fs.existsSync(parent)) {
+            fs.mkdirSync(parent, { recursive: true });
+        }
+    }
+    const conn = new Database(dbPath);
+    conn.pragma('journal_mode = WAL');
+    conn.pragma('foreign_keys = OFF');
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const db = drizzle(conn, { schema: {} });
+    // Migrate in ascending timestamp order — same pattern as the test suite.
+    for (const folder of [
+        PROVIDER_MIGRATIONS,
+        REGISTRY_MIGRATIONS,
+        TOOL_REGISTRY_MIGRATIONS,
+        POLICY_MIGRATIONS,
+        COMPILER_MIGRATIONS,
+    ]) {
+        if (fs.existsSync(folder)) {
+            migrate(db, { migrationsFolder: folder });
+        }
+        else {
+            process.stderr.write(`agent-compiler: warning: migration folder not found: ${folder}\n`);
+        }
+    }
+    conn.pragma('foreign_keys = ON');
+    return { conn, db };
+}
+// ──────────────────────────────────────────────
+// Compile a single agent → string artifact
+// ──────────────────────────────────────────────
+function compileSingle(slug, args, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+db) {
+    let result;
+    try {
+        result = compileAgent({
+            agentSlug: slug,
+            platform: args.platform,
+            context: args.context,
+            db,
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        // Distinguish AGENT_NOT_FOUND / PLATFORM_NOT_FOUND from other errors.
+        if (msg.includes('not found') || msg.includes('NOT_FOUND')) {
+            die(`Error: ${msg}`);
+        }
+        die(`Compilation failed for '${slug}' on platform '${args.platform}': ${msg}`);
+    }
+    // --format json overrides the platform's default header format.
+    if (args.formatJson) {
+        // If content is already JSON (json_object platforms), return as-is.
+        try {
+            JSON.parse(result.content);
+            return result.content; // already valid JSON
+        }
+        catch {
+            // Wrap markdown in a JSON envelope.
+            return JSON.stringify({
+                systemPrompt: result.content,
+                tools: result.tools,
+                componentVersions: result.componentVersions,
+            }, null, 2);
+        }
+    }
+    return result.content;
+}
+// ──────────────────────────────────────────────
+// Output helper
+// ──────────────────────────────────────────────
+/**
+ * Write content either to stdout or to <outDir>/<slug>.<ext>.
+ */
+function writeOutput(slug, content, args) {
+    if (args.outDir === null) {
+        process.stdout.write(content);
+        return;
+    }
+    fs.mkdirSync(args.outDir, { recursive: true });
+    const ext = args.formatJson ? 'json' : 'md';
+    const dest = path.join(args.outDir, `${slug}.${ext}`);
+    fs.writeFileSync(dest, content, 'utf8');
+}
+// ──────────────────────────────────────────────
+// Fatal error helper
+// ──────────────────────────────────────────────
+function die(msg) {
+    process.stderr.write(`agent-compiler: ${msg}\n`);
+    process.exit(1);
+}
+// ──────────────────────────────────────────────
+// Main
+// ──────────────────────────────────────────────
+function main() {
+    const args = parseArgs(process.argv);
+    const { conn, db } = openDb(args.dbPath);
+    try {
+        if (args.all) {
+            // Compile every agent in the registry, optionally filtered by category.
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const agentStore = new AgentStore(db);
+            const agents = agentStore.list(args.category ? { category: args.category } : {});
+            if (agents.length === 0) {
+                const scope = args.category ? ` in category '${args.category}'` : '';
+                process.stderr.write(`agent-compiler: no agents found${scope}\n`);
+                // Exit 0 — empty category is not an error.
+            }
+            for (const agent of agents) {
+                const content = compileSingle(agent.slug, args, db);
+                writeOutput(agent.slug, content, args);
+            }
+        }
+        else {
+            // Single-slug path.
+            // slug is guaranteed non-null here by parseArgs.
+            const content = compileSingle(args.slug, args, db);
+            writeOutput(args.slug, content, args);
+        }
+    }
+    finally {
+        conn.close();
+    }
+}
+main();
+//# sourceMappingURL=compile.js.map

package/src/cli/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/cli/compile.ts"],"names":[],"mappings":"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"}

package/src/compile.d.ts

@@ -0,0 +1,61 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+import type { CompositionContext } from '@adhd/agent-store-prompts';
+import type { ComponentVersionMap } from './resolve/composition.js';
+import type { StructuredTool } from './emit/json.js';
+/** Input to compileAgent ([def:compile-input]). */
+export interface CompileInput {
+    /** Slug of the agent to compile. */
+    agentSlug: string;
+    /** Target platform id (e.g. 'claude_code', 'claude_api'). */
+    platform: string;
+    /** Runtime context key/value map for context-conditioned components. */
+    context?: CompositionContext;
+    /** Shared registry Drizzle handle (all four table prefixes — [inv:one-db-handle]). */
+    db: BetterSQLite3Database<any>;
+}
+/** Return value of compileAgent ([def:composed-output]). */
+export interface CompiledAgent {
+    /**
+     * `composed_prompts` row id (audit/cache handle).
+     * The inserted `registry_composed_prompts` row id (on MISS, written by the
+     * cache layer) or the existing row id (on HIT, served from the cache).
+     * Wired by the composed-prompt-caching state ([def:composed-output]).
+     */
+    id: number;
+    /** Flat platform artifact (markdown for claude_code, JSON string for claude_api/openai). */
+    content: string;
+    /**
+     * Resolved platform-shaped tools.
+     * For claude_code: string[] of aliases (e.g. ['Read','Grep','WebSearch']).
+     * For claude_api: StructuredTool[] (EmittedTool[]) shaped for the API.
+     * For none-format: [] (platform does not support tool selection).
+     */
+    tools: string[] | StructuredTool[];
+    /**
+     * Map of componentSlug → resolvedVersion for cache-key computation
+     * ([def:context-hash]).
+     */
+    componentVersions: ComponentVersionMap;
+}
+/**
+ * Compile an agent to a flat, platform-shaped artifact.
+ *
+ * Orchestrates the four resolve layers:
+ *   1. body + componentVersions — CompositionStore.resolveComposition (junction order)
+ *   2. tools                    — resolveTools (platform aliases)
+ *   3. model                    — resolveModel (platform binding or canonical fallback)
+ *   4. constraints              — resolvePolicyConstraints (direct + inherited)
+ *
+ * Then dispatches on the platform's `header_format` column to the matching
+ * emit function.  The `id` field is null until `composed-prompt-caching`
+ * wires the cache write ([def:composed-output]).
+ *
+ * @param input - Agent slug, target platform, runtime context, shared DB handle.
+ * @returns Compiled platform artifact plus metadata.
+ *
+ * @throws {AgentError}       AGENT_NOT_FOUND — agentSlug not in registry_agents.
+ * @throws {CompositionError} REQUIRED_COMPONENT_EXCLUDED — a required component
+ *   was excluded by the runtime context.
+ */
+export declare function compileAgent(input: CompileInput): CompiledAgent;
+//# sourceMappingURL=compile.d.ts.map

package/src/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../../../packages/agent/agent-engine-compiler/src/compile.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAUpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAUrD,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,sFAAsF;IAEtF,EAAE,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC;CAChC;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,KAAK,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IACnC;;;OAGG;IACH,iBAAiB,EAAE,mBAAmB,CAAC;CACxC;AA6DD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CA6N/D"}