@adhd/agent-engine-compiler 2.1.0

package/src/emit/markdown.d.ts

@@ -0,0 +1,35 @@
+import type { ResolvedTool } from '../resolve/tools.js';
+import type { Constraint } from '../resolve/policy.js';
+/** Inputs to the yaml_frontmatter emitter. */
+export interface YamlFrontmatterInput {
+    /** Agent slug — the `name:` frontmatter field. */
+    agentSlug: string;
+    /** Agent description — the `description:` frontmatter field. */
+    description: string;
+    /** Resolved platform tool aliases (e.g. ['Read', 'Grep', 'WebSearch']). */
+    tools: ResolvedTool[];
+    /** Resolved platform model alias (e.g. 'opus'), or '' when absent. */
+    model: string;
+    /**
+     * Body sections in junction order (ascending position), each being the
+     * raw content of one resolved component.  Joined with '\n\n' between
+     * sections per Decision B.1.
+     */
+    bodySections: string[];
+    /** Effective policy constraints (direct + inherited). */
+    constraints: Constraint[];
+}
+/**
+ * Emit a claude_code `yaml_frontmatter` platform artifact.
+ *
+ * Returns a string that STARTS with `---` (the opening YAML fence), followed
+ * by the frozen field set, the closing fence, a blank line, then the composed
+ * markdown body (sections joined with '\n\n') with an appended `## Policies`
+ * block when policy constraints exist.
+ *
+ * @param input - Resolved compiler inputs; all fields already platform-shaped.
+ * @returns Flat markdown string ready to write to a `.md` file or emit to
+ *          stdout as the claude_code system prompt.
+ */
+export declare function emitYamlFrontmatter(input: YamlFrontmatterInput): string;
+//# sourceMappingURL=markdown.d.ts.map

package/src/emit/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/emit/markdown.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,8CAA8C;AAC9C,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yDAAyD;IACzD,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAkDvE"}

package/src/emit/markdown.js

@@ -0,0 +1,90 @@
+// ──────────────────────────────────────────────
+// yaml_frontmatter emitter (claude_code / header_format = 'yaml_frontmatter')
+//
+// Renders the YAML frontmatter block then the composed markdown body.
+//
+// Field set and ordering are FROZEN per Decision B.1 (decisions.md):
+//
+//   ---
+//   name: <agent.slug>
+//   description: <agent.description>
+//   tools: <comma-joined resolved platform aliases, in agent_tools grant order>
+//   model: <resolved platform model alias>
+//   ---
+//
+//   <body: resolveComposition sections joined in junction order, "\n\n" between>
+//
+// Rules:
+//   - `tools:` — comma-joined platformAlias values from resolveTools (never
+//     canonical names); OMITTED entirely when the resolved list is empty
+//     (Decision B.1: "no tools: line").
+//   - `model:` — OMITTED when resolveModel returns '' (no model_hint).
+//   - Policy constraints — rendered as a `## Policies` section APPENDED to the
+//     body (claude_code frontmatter has no policy field); the text is the
+//     resolved Constraint.text (template description).  When there are no
+//     constraints, no section is added.
+//   - `description:` — sourced from the agent row's description; rendered as an
+//     empty string if the agent has no description (never omitted — Claude Code
+//     surfaces this field in the picker UI).
+//
+// [inv:platform-shaped-observable] — the consumer-visible observable is the
+// frontmatter `tools:` line equalling the resolved aliases; a canonical-name
+// leak makes the frontmatter.tools assertion go red.
+//
+// [def:junction-order] — sections emitted in the returned array order
+// (ascending position), never re-sorted here.
+// ──────────────────────────────────────────────
+/**
+ * Emit a claude_code `yaml_frontmatter` platform artifact.
+ *
+ * Returns a string that STARTS with `---` (the opening YAML fence), followed
+ * by the frozen field set, the closing fence, a blank line, then the composed
+ * markdown body (sections joined with '\n\n') with an appended `## Policies`
+ * block when policy constraints exist.
+ *
+ * @param input - Resolved compiler inputs; all fields already platform-shaped.
+ * @returns Flat markdown string ready to write to a `.md` file or emit to
+ *          stdout as the claude_code system prompt.
+ */
+export function emitYamlFrontmatter(input) {
+    const { agentSlug, description, tools, model, bodySections, constraints } = input;
+    // ── Frontmatter fields ────────────────────────────────────────────────────
+    const lines = ['---'];
+    lines.push(`name: ${agentSlug}`);
+    lines.push(`description: ${description}`);
+    // tools: — only emitted when there is at least one resolved alias.
+    // Decision B.1: "An agent with no grants emits no tools: line (NOT tools: empty)".
+    if (tools.length > 0) {
+        const aliasLine = tools.map((t) => t.platformAlias).join(', ');
+        lines.push(`tools: ${aliasLine}`);
+    }
+    // model: — omitted when model resolves to '' (no model_hint or no binding).
+    if (model) {
+        lines.push(`model: ${model}`);
+    }
+    lines.push('---');
+    // ── Body ──────────────────────────────────────────────────────────────────
+    // Sections joined with '\n\n' per Decision B.1.
+    // bodySections contains already-rendered component content in junction order
+    // — the compiler must NOT re-sort or re-filter here.
+    const bodyParts = [...bodySections];
+    // ── Policy block ──────────────────────────────────────────────────────────
+    // Constraints fold into the BODY (not frontmatter) for claude_code.
+    // Rendered as '## Policies' followed by bullet items.
+    // [def:policy-constraint], Decision B.1: "policy constraint block appended to the body"
+    if (constraints.length > 0) {
+        const policyLines = ['## Policies', ''];
+        for (const c of constraints) {
+            const prefix = c.inheritedFrom
+                ? `(inherited from ${c.inheritedFrom}) `
+                : '';
+            policyLines.push(`- ${prefix}${c.text}`);
+        }
+        bodyParts.push(policyLines.join('\n'));
+    }
+    // Join sections with '\n\n' (Decision B.1).
+    const body = bodyParts.join('\n\n');
+    // Final artifact: frontmatter block + blank line + body.
+    return lines.join('\n') + '\n\n' + body + '\n';
+}
+//# sourceMappingURL=markdown.js.map

package/src/emit/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/emit/markdown.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,8EAA8E;AAC9E,EAAE;AACF,sEAAsE;AACtE,EAAE;AACF,qEAAqE;AACrE,EAAE;AACF,QAAQ;AACR,uBAAuB;AACvB,qCAAqC;AACrC,gFAAgF;AAChF,2CAA2C;AAC3C,QAAQ;AACR,EAAE;AACF,iFAAiF;AACjF,EAAE;AACF,SAAS;AACT,4EAA4E;AAC5E,yEAAyE;AACzE,wCAAwC;AACxC,uEAAuE;AACvE,+EAA+E;AAC/E,0EAA0E;AAC1E,0EAA0E;AAC1E,wCAAwC;AACxC,gFAAgF;AAChF,gFAAgF;AAChF,6CAA6C;AAC7C,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,qDAAqD;AACrD,EAAE;AACF,sEAAsE;AACtE,8CAA8C;AAC9C,iDAAiD;AAyBjD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAA2B;IAC7D,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,GACvE,KAAK,CAAC;IAER,6EAA6E;IAC7E,MAAM,KAAK,GAAa,CAAC,KAAK,CAAC,CAAC;IAEhC,KAAK,CAAC,IAAI,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,gBAAgB,WAAW,EAAE,CAAC,CAAC;IAE1C,mEAAmE;IACnE,mFAAmF;IACnF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,UAAU,SAAS,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,4EAA4E;IAC5E,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAElB,6EAA6E;IAC7E,gDAAgD;IAChD,6EAA6E;IAC7E,qDAAqD;IACrD,MAAM,SAAS,GAAa,CAAC,GAAG,YAAY,CAAC,CAAC;IAE9C,6EAA6E;IAC7E,oEAAoE;IACpE,sDAAsD;IACtD,wFAAwF;IACxF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,CAAC,CAAC,aAAa;gBAC5B,CAAC,CAAC,mBAAmB,CAAC,CAAC,aAAa,IAAI;gBACxC,CAAC,CAAC,EAAE,CAAC;YACP,WAAW,CAAC,IAAI,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,4CAA4C;IAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEpC,yDAAyD;IACzD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AACjD,CAAC"}

package/src/index.d.ts

@@ -0,0 +1,20 @@
+export { sqlite, db } from './db/client.js';
+export { runMigrations } from './db/migrate.js';
+export { runMigrationsOn, MIGRATIONS_FOLDER } from './db/migrate-runner.js';
+export * from './db/schema.js';
+export { resolveBody } from './resolve/composition.js';
+export type { ResolvedBody, ComponentVersionMap, } from './resolve/composition.js';
+export { resolveTools } from './resolve/tools.js';
+export type { ResolvedTool } from './resolve/tools.js';
+export { resolveModel } from './resolve/model.js';
+export { resolvePolicyConstraints } from './resolve/policy.js';
+export type { Constraint } from './resolve/policy.js';
+export { emitYamlFrontmatter } from './emit/markdown.js';
+export type { YamlFrontmatterInput } from './emit/markdown.js';
+export { emitJsonObject } from './emit/json.js';
+export type { JsonObjectInput, StructuredTool } from './emit/json.js';
+export { compileAgent } from './compile.js';
+export type { CompileInput, CompiledAgent } from './compile.js';
+export { lookup as cacheComposedPromptLookup, write as cacheComposedPromptWrite, computeContextHash, } from './cache/composed-prompt-cache.js';
+export { seedFixtureAgent } from './seed/fixtures.js';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/agent/agent-engine-compiler/src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EACV,YAAY,EACZ,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGhE,OAAO,EACL,MAAM,IAAI,yBAAyB,EACnC,KAAK,IAAI,wBAAwB,EACjC,kBAAkB,GACnB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/src/index.js

@@ -0,0 +1,23 @@
+// @adhd/agent-engine-compiler — public barrel.
+// Export each new store + schema table here as it is added (mirror the shipped
+// registry packages: every state that adds a table also extends this barrel).
+export { sqlite, db } from './db/client.js';
+export { runMigrations } from './db/migrate.js';
+export { runMigrationsOn, MIGRATIONS_FOLDER } from './db/migrate-runner.js';
+export * from './db/schema.js';
+// composition-resolve state: body assembly from agent-registry junction order
+export { resolveBody } from './resolve/composition.js';
+// tool-header-emit state: platform tool alias resolution from tool_platform_bindings
+export { resolveTools } from './resolve/tools.js';
+// model-and-policy-emit state: model alias + policy constraint resolution
+export { resolveModel } from './resolve/model.js';
+export { resolvePolicyConstraints } from './resolve/policy.js';
+// platform-markdown-emit state: emit functions + top-level compileAgent orchestrator
+export { emitYamlFrontmatter } from './emit/markdown.js';
+export { emitJsonObject } from './emit/json.js';
+export { compileAgent } from './compile.js';
+// composed-prompt-caching state: cache lookup + write for registry_composed_prompts
+export { lookup as cacheComposedPromptLookup, write as cacheComposedPromptWrite, computeContextHash, } from './cache/composed-prompt-cache.js';
+// compile-fixtures-e2e state: real-row fixture seeder for e2e tests
+export { seedFixtureAgent } from './seed/fixtures.js';
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/agent/agent-engine-compiler/src/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,+EAA+E;AAC/E,8EAA8E;AAE9E,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,cAAc,gBAAgB,CAAC;AAE/B,8EAA8E;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAMvD,qFAAqF;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,0EAA0E;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,qFAAqF;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,oFAAoF;AACpF,OAAO,EACL,MAAM,IAAI,yBAAyB,EACnC,KAAK,IAAI,wBAAwB,EACjC,kBAAkB,GACnB,MAAM,kCAAkC,CAAC;AAE1C,oEAAoE;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/src/resolve/composition.d.ts

@@ -0,0 +1,28 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+import { type CompositionContext } from '@adhd/agent-store-prompts';
+/** Map of component slug to its resolved version number, used to key the cache. */
+export type ComponentVersionMap = Record<string, number>;
+/** Return value of resolveBody. */
+export interface ResolvedBody {
+    /** Component content sections concatenated in ascending junction position order. */
+    body: string;
+    /** Map of componentSlug → resolvedVersion for cache-key computation. */
+    componentVersions: ComponentVersionMap;
+}
+/**
+ * Assemble the flat prompt body for an agent + runtime context.
+ *
+ * Delegates ordering, version-pin resolution, and context-condition filtering
+ * entirely to {@link CompositionStore.resolveComposition} — this function does
+ * NOT re-implement `ORDER BY position` or the context predicate evaluator.
+ *
+ * @param db         - The shared registry Drizzle handle (all four prefixes).
+ * @param agentSlug  - Slug of the agent to compile.
+ * @param context    - Runtime context key/value map for context-conditioned components.
+ * @returns Flat ordered body string and per-component version map.
+ *
+ * @throws {CompositionError} AGENT_NOT_FOUND | COMPONENT_VERSION_NOT_FOUND |
+ *   REQUIRED_COMPONENT_EXCLUDED — propagated unchanged from CompositionStore.
+ */
+export declare function resolveBody(db: BetterSQLite3Database<any>, agentSlug: string, context?: CompositionContext): ResolvedBody;
+//# sourceMappingURL=composition.d.ts.map

package/src/resolve/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/resolve/composition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AAqBnC,mFAAmF;AACnF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEzD,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,iBAAiB,EAAE,mBAAmB,CAAC;CACxC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAEzB,EAAE,EAAE,qBAAqB,CAAC,GAAG,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,kBAAuB,GAC/B,YAAY,CAiBd"}

package/src/resolve/composition.js

@@ -0,0 +1,33 @@
+import { CompositionStore, } from '@adhd/agent-store-prompts';
+/**
+ * Assemble the flat prompt body for an agent + runtime context.
+ *
+ * Delegates ordering, version-pin resolution, and context-condition filtering
+ * entirely to {@link CompositionStore.resolveComposition} — this function does
+ * NOT re-implement `ORDER BY position` or the context predicate evaluator.
+ *
+ * @param db         - The shared registry Drizzle handle (all four prefixes).
+ * @param agentSlug  - Slug of the agent to compile.
+ * @param context    - Runtime context key/value map for context-conditioned components.
+ * @returns Flat ordered body string and per-component version map.
+ *
+ * @throws {CompositionError} AGENT_NOT_FOUND | COMPONENT_VERSION_NOT_FOUND |
+ *   REQUIRED_COMPONENT_EXCLUDED — propagated unchanged from CompositionStore.
+ */
+export function resolveBody(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+db, agentSlug, context = {}) {
+    // Single delegated call — ordering + version-pin + context filtering happen
+    // here and nowhere else ([inv:context-precedence-consumed]).
+    const store = new CompositionStore(db);
+    const resolved = store.resolveComposition(agentSlug, context);
+    const componentVersions = {};
+    const sections = [];
+    for (const rc of resolved) {
+        sections.push(rc.component.content);
+        componentVersions[rc.componentSlug] = rc.resolvedVersion;
+    }
+    const body = sections.join('\n');
+    return { body, componentVersions };
+}
+//# sourceMappingURL=composition.js.map

package/src/resolve/composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/resolve/composition.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gBAAgB,GAEjB,MAAM,2BAA2B,CAAC;AAgCnC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW;AACzB,8DAA8D;AAC9D,EAA8B,EAC9B,SAAiB,EACjB,UAA8B,EAAE;IAEhC,4EAA4E;IAC5E,6DAA6D;IAC7D,MAAM,KAAK,GAAG,IAAI,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAE9D,MAAM,iBAAiB,GAAwB,EAAE,CAAC;IAClD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpC,iBAAiB,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC;IAC3D,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjC,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;AACrC,CAAC"}

package/src/resolve/model.d.ts

@@ -0,0 +1,22 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+/**
+ * Resolve an agent's `model_hint` to the platform-specific model string.
+ *
+ * Algorithm:
+ *   1. `AgentStore.read(agentSlug)` — fetch the agent row (includes `model_hint`).
+ *   2. If `model_hint` is null/empty → return `''` (caller omits `model:` line).
+ *   3. `ModelStore.resolveModelId(modelHint, platform)` — reuse the provider's
+ *      binding lookup; the platform filter is applied in ModelStore, not here.
+ *   4. If no binding row exists → fall back to the canonical id and mark the decision
+ *      (see fallback note below).
+ *
+ * The platform filter is the [dod.2] negative-control invariant: if ModelStore were
+ * called without the platform argument, both platforms would resolve to the same id.
+ *
+ * @param db         - The shared registry Drizzle handle (all table prefixes).
+ * @param agentSlug  - Slug of the agent whose model to resolve.
+ * @param platform   - Target platform id (e.g. 'claude_code', 'claude_api').
+ * @returns Platform-specific model string, or '' if the agent has no model_hint.
+ */
+export declare function resolveModel(db: BetterSQLite3Database<any>, agentSlug: string, platform: string): string;
+//# sourceMappingURL=model.d.ts.map

package/src/resolve/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/resolve/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAwBxE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAE1B,EAAE,EAAE,qBAAqB,CAAC,GAAG,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,MAAM,CA8BR"}

package/src/resolve/model.js

@@ -0,0 +1,69 @@
+import { AgentStore } from '@adhd/agent-store-prompts';
+import { ModelStore, ModelStoreError } from '@adhd/agent-core-provider';
+// ──────────────────────────────────────────────
+// resolveModel — resolve an agent's model_hint to a platform-specific model id.
+//
+// Reads the agent's `model_hint` from `registry_agents` via AgentStore.read, then
+// calls ModelStore.resolveModelId(modelHint, platform) to look up the binding row
+// in `provider_model_platform_bindings` for the target platform.
+//
+// Reuses ModelStore.resolveModelId ([ref:store-read]); does NOT re-implement the
+// SQL join or the platform filter.  The platform filter (`WHERE platform = ?`) lives
+// exclusively in ModelStore — removing it collapses both platforms to the first
+// binding row, which is the [dod.2] negative-control scenario.
+//
+// Fallback: if the agent has a model_hint but no binding exists for the (hint,
+// platform) pair, the canonical model id (the model_hint itself) is returned and the
+// decision is recorded in decisions.md.  If the agent has no model_hint, an empty
+// string is returned (callers must handle the "no model" case — Decision B of
+// decisions.md says the `model:` frontmatter line is OMITTED when model_hint is null).
+// ──────────────────────────────────────────────
+/**
+ * Resolve an agent's `model_hint` to the platform-specific model string.
+ *
+ * Algorithm:
+ *   1. `AgentStore.read(agentSlug)` — fetch the agent row (includes `model_hint`).
+ *   2. If `model_hint` is null/empty → return `''` (caller omits `model:` line).
+ *   3. `ModelStore.resolveModelId(modelHint, platform)` — reuse the provider's
+ *      binding lookup; the platform filter is applied in ModelStore, not here.
+ *   4. If no binding row exists → fall back to the canonical id and mark the decision
+ *      (see fallback note below).
+ *
+ * The platform filter is the [dod.2] negative-control invariant: if ModelStore were
+ * called without the platform argument, both platforms would resolve to the same id.
+ *
+ * @param db         - The shared registry Drizzle handle (all table prefixes).
+ * @param agentSlug  - Slug of the agent whose model to resolve.
+ * @param platform   - Target platform id (e.g. 'claude_code', 'claude_api').
+ * @returns Platform-specific model string, or '' if the agent has no model_hint.
+ */
+export function resolveModel(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+db, agentSlug, platform) {
+    // Step 1: fetch agent to get model_hint.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const agentStore = new AgentStore(db);
+    const agent = agentStore.read(agentSlug);
+    const modelHint = agent.modelHint;
+    // Step 2: no model_hint — caller omits the model: frontmatter line (Decision B).
+    if (!modelHint) {
+        return '';
+    }
+    // Step 3: resolve via ModelStore — the platform filter lives here, not in resolveModel.
+    const modelStore = new ModelStore(db);
+    try {
+        return modelStore.resolveModelId(modelHint, platform);
+    }
+    catch (err) {
+        if (err instanceof ModelStoreError &&
+            err.code === 'MODEL_BINDING_NOT_FOUND') {
+            // Step 4: no binding for (modelHint, platform) — fall back to canonical id.
+            // Decision: fallback recorded in docs/plan/agent-compiler/decisions.md.
+            // The caller still gets a usable (if un-aliased) string; the compile does not
+            // fail for a missing binding.
+            return modelHint;
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=model.js.map

package/src/resolve/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/resolve/model.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAExE,iDAAiD;AACjD,gFAAgF;AAChF,EAAE;AACF,kFAAkF;AAClF,kFAAkF;AAClF,iEAAiE;AACjE,EAAE;AACF,iFAAiF;AACjF,qFAAqF;AACrF,gFAAgF;AAChF,+DAA+D;AAC/D,EAAE;AACF,+EAA+E;AAC/E,qFAAqF;AACrF,kFAAkF;AAClF,8EAA8E;AAC9E,uFAAuF;AACvF,iDAAiD;AAEjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY;AAC1B,8DAA8D;AAC9D,EAA8B,EAC9B,SAAiB,EACjB,QAAgB;IAEhB,yCAAyC;IACzC,8DAA8D;IAC9D,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,EAAS,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEzC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAElC,iFAAiF;IACjF,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,wFAAwF;IACxF,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IACE,GAAG,YAAY,eAAe;YAC9B,GAAG,CAAC,IAAI,KAAK,yBAAyB,EACtC,CAAC;YACD,4EAA4E;YAC5E,wEAAwE;YACxE,8EAA8E;YAC9E,8BAA8B;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/src/resolve/policy.d.ts

@@ -0,0 +1,34 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+/** A resolved policy constraint ready for header/body rendering. */
+export interface Constraint {
+    /** The policy template slug (e.g. 'no-credentials'). */
+    policySlug: string;
+    /** The human-readable constraint text rendered into the compiled output. */
+    text: string;
+    /** True when this constraint is mandatory (cannot be overridden). */
+    isMandatory: boolean;
+    /**
+     * Category slug this constraint was inherited from, or null for direct-attach.
+     * Surfaces the provenance of inherited constraints in compiled output.
+     */
+    inheritedFrom: string | null;
+}
+/**
+ * Resolve all effective policy constraints for an agent (direct + inherited).
+ *
+ * Delegates the full 3-query merge (direct rows + category memberships + category
+ * policies) to {@link AgentPolicyStore.resolveForAgent} — this function does NOT
+ * re-implement the inheritance join.  The [dod.3] negative-control is:
+ * "return empty constraints when no agent_policy rows exist" — the constraint block
+ * is keyed exclusively on the agent_policy table.
+ *
+ * Each resolved row is joined to its template via {@link PolicyTemplateStore.read}
+ * and rendered as a {@link Constraint}.  The constraint text = the template's
+ * `description`, which is the human-readable summary the compiler emits.
+ *
+ * @param db         - The shared registry Drizzle handle (all table prefixes).
+ * @param agentSlug  - Slug of the agent whose policy constraints to resolve.
+ * @returns Ordered list of constraints (direct first, then inherited by category).
+ */
+export declare function resolvePolicyConstraints(db: BetterSQLite3Database<any>, agentSlug: string): Constraint[];
+//# sourceMappingURL=policy.d.ts.map

package/src/resolve/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/resolve/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAwBxE,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CAEtC,EAAE,EAAE,qBAAqB,CAAC,GAAG,CAAC,EAC9B,SAAS,EAAE,MAAM,GAChB,UAAU,EAAE,CA2Bd"}

package/src/resolve/policy.js

@@ -0,0 +1,44 @@
+import { AgentPolicyStore, PolicyTemplateStore } from '@adhd/agent-core-policy';
+/**
+ * Resolve all effective policy constraints for an agent (direct + inherited).
+ *
+ * Delegates the full 3-query merge (direct rows + category memberships + category
+ * policies) to {@link AgentPolicyStore.resolveForAgent} — this function does NOT
+ * re-implement the inheritance join.  The [dod.3] negative-control is:
+ * "return empty constraints when no agent_policy rows exist" — the constraint block
+ * is keyed exclusively on the agent_policy table.
+ *
+ * Each resolved row is joined to its template via {@link PolicyTemplateStore.read}
+ * and rendered as a {@link Constraint}.  The constraint text = the template's
+ * `description`, which is the human-readable summary the compiler emits.
+ *
+ * @param db         - The shared registry Drizzle handle (all table prefixes).
+ * @param agentSlug  - Slug of the agent whose policy constraints to resolve.
+ * @returns Ordered list of constraints (direct first, then inherited by category).
+ */
+export function resolvePolicyConstraints(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+db, agentSlug) {
+    // Step 1: full effective policy set — direct + inherited.
+    // resolveForAgent is the SINGLE place the 3-query merge lives ([ref:store-read]).
+    const agentPolicyStore = new AgentPolicyStore(db);
+    const rows = agentPolicyStore.resolveForAgent(agentSlug);
+    // Step 2: for each row, read the policy template and render the constraint text.
+    const templateStore = new PolicyTemplateStore(db);
+    const constraints = [];
+    for (const row of rows) {
+        const template = templateStore.read(row.policySlug);
+        // Constraint text = the template's description.
+        // This is the consumer-visible text the compiler renders into the header/body
+        // ([def:policy-constraint], [inv:platform-shaped-observable]).
+        const text = template.description;
+        constraints.push({
+            policySlug: row.policySlug,
+            text,
+            isMandatory: row.isMandatory,
+            inheritedFrom: row.inheritedFrom,
+        });
+    }
+    return constraints;
+}
+//# sourceMappingURL=policy.js.map

package/src/resolve/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/resolve/policy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAqChF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,wBAAwB;AACtC,8DAA8D;AAC9D,EAA8B,EAC9B,SAAiB;IAEjB,0DAA0D;IAC1D,kFAAkF;IAClF,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,gBAAgB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAEzD,iFAAiF;IACjF,MAAM,aAAa,GAAG,IAAI,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAClD,MAAM,WAAW,GAAiB,EAAE,CAAC;IAErC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAEpD,gDAAgD;QAChD,8EAA8E;QAC9E,+DAA+D;QAC/D,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC;QAElC,WAAW,CAAC,IAAI,CAAC;YACf,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,IAAI;YACJ,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,aAAa,EAAE,GAAG,CAAC,aAAa;SACjC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/src/resolve/tools.d.ts

@@ -0,0 +1,33 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+/** A resolved platform alias for one canonical tool grant. */
+export interface ResolvedTool {
+    /** Canonical tool name (e.g. 'file_read', 'shell_exec'). */
+    canonicalName: string;
+    /** Platform-specific alias (e.g. 'Read' on claude_code, 'read_file' on claude_api). */
+    platformAlias: string;
+    /** Availability on this platform: 'available' | 'restricted' | 'requires_permission'. */
+    availability: string;
+}
+/**
+ * Resolve an agent's tool grants to ordered, de-duplicated platform aliases.
+ *
+ * Algorithm:
+ *   1. `AgentToolStore.listForAgent(agentSlug)` — fetch all `tool_*` grants.
+ *   2. `BindingStore.listForPlatform(platform)` — one platform-keyed query;
+ *      index `idx_bindings_platform` makes this O(1) vs. the catalog size.
+ *   3. For each grant, look up its binding row in the result set.
+ *      - No row → skip (tool has no binding for this platform).
+ *      - `availability = 'unavailable'` → drop (e.g. `human_input` on `claude_api`).
+ *      - Otherwise → emit `platformToolName` as the resolved alias.
+ *
+ * The platform filter is applied to BOTH the listForPlatform call AND the
+ * Map lookup so the result is always platform-shaped, never canonical-named.
+ * This is the invariant the [dod.1] negative-control tests.
+ *
+ * @param db         - The shared registry Drizzle handle (all table prefixes).
+ * @param agentSlug  - Slug of the agent whose tool grants to resolve.
+ * @param platform   - Target platform id (e.g. 'claude_code', 'claude_api').
+ * @returns Ordered, de-duplicated `ResolvedTool[]` ready for header emission.
+ */
+export declare function resolveTools(db: BetterSQLite3Database<any>, agentSlug: string, platform: string): ResolvedTool[];
+//# sourceMappingURL=tools.d.ts.map

package/src/resolve/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/resolve/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAgCxE,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,aAAa,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,aAAa,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAE1B,EAAE,EAAE,qBAAqB,CAAC,GAAG,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,YAAY,EAAE,CAiDhB"}

package/src/resolve/tools.js

@@ -0,0 +1,62 @@
+import { AgentToolStore, BindingStore, } from '@adhd/agent-store-tools';
+/**
+ * Resolve an agent's tool grants to ordered, de-duplicated platform aliases.
+ *
+ * Algorithm:
+ *   1. `AgentToolStore.listForAgent(agentSlug)` — fetch all `tool_*` grants.
+ *   2. `BindingStore.listForPlatform(platform)` — one platform-keyed query;
+ *      index `idx_bindings_platform` makes this O(1) vs. the catalog size.
+ *   3. For each grant, look up its binding row in the result set.
+ *      - No row → skip (tool has no binding for this platform).
+ *      - `availability = 'unavailable'` → drop (e.g. `human_input` on `claude_api`).
+ *      - Otherwise → emit `platformToolName` as the resolved alias.
+ *
+ * The platform filter is applied to BOTH the listForPlatform call AND the
+ * Map lookup so the result is always platform-shaped, never canonical-named.
+ * This is the invariant the [dod.1] negative-control tests.
+ *
+ * @param db         - The shared registry Drizzle handle (all table prefixes).
+ * @param agentSlug  - Slug of the agent whose tool grants to resolve.
+ * @param platform   - Target platform id (e.g. 'claude_code', 'claude_api').
+ * @returns Ordered, de-duplicated `ResolvedTool[]` ready for header emission.
+ */
+export function resolveTools(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+db, agentSlug, platform) {
+    const agentToolStore = new AgentToolStore(db);
+    const bindingStore = new BindingStore(db);
+    // Step 1: all grants for this agent (tool_* prefix, logical agent_slug key).
+    const grants = agentToolStore.listForAgent(agentSlug);
+    // Step 2: one platform-keyed query — reuses BindingStore ([ref:store-read]).
+    // Index idx_bindings_platform keeps this O(catalog-size), not O(grants).
+    const platformBindings = bindingStore.listForPlatform(platform);
+    // Build a Map<canonicalToolName, binding> for O(1) grant lookups.
+    // Platform is already baked in — the Map only holds bindings for THIS platform.
+    const bindingByTool = new Map(platformBindings.map((b) => [b.toolName, b]));
+    // Step 3: walk grants in their stored order; de-duplicate by canonical name.
+    const seen = new Set();
+    const results = [];
+    for (const grant of grants) {
+        if (seen.has(grant.toolName)) {
+            continue; // de-duplicate (should not occur with a well-formed DB, but defensive)
+        }
+        seen.add(grant.toolName);
+        const binding = bindingByTool.get(grant.toolName);
+        if (!binding) {
+            // No binding row for this tool on this platform — skip silently.
+            continue;
+        }
+        if (binding.availability === 'unavailable') {
+            // Explicitly unavailable on this platform (e.g. human_input on claude_api).
+            // [def:tools-header]: drop these — do not emit.
+            continue;
+        }
+        results.push({
+            canonicalName: grant.toolName,
+            platformAlias: binding.platformToolName,
+            availability: binding.availability,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=tools.js.map

package/src/resolve/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/resolve/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,cAAc,EACd,YAAY,GAEb,MAAM,yBAAyB,CAAC;AAoCjC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,YAAY;AAC1B,8DAA8D;AAC9D,EAA8B,EAC9B,SAAiB,EACjB,QAAgB;IAEhB,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC,CAAC;IAC9C,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;IAE1C,6EAA6E;IAC7E,MAAM,MAAM,GAAG,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAEtD,6EAA6E;IAC7E,yEAAyE;IACzE,MAAM,gBAAgB,GACpB,YAAY,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IAEzC,kEAAkE;IAClE,gFAAgF;IAChF,MAAM,aAAa,GAAG,IAAI,GAAG,CAC3B,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAC7C,CAAC;IAEF,6EAA6E;IAC7E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,SAAS,CAAC,uEAAuE;QACnF,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEzB,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAElD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,iEAAiE;YACjE,SAAS;QACX,CAAC;QAED,IAAI,OAAO,CAAC,YAAY,KAAK,aAAa,EAAE,CAAC;YAC3C,4EAA4E;YAC5E,gDAAgD;YAChD,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,aAAa,EAAE,KAAK,CAAC,QAAQ;YAC7B,aAAa,EAAE,OAAO,CAAC,gBAAgB;YACvC,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/src/seed/fixtures.d.ts

@@ -0,0 +1,52 @@
+/**
+ * fixtures.ts — real-row fixture seeder for agent-compiler e2e tests.
+ *
+ * Exports `seedFixtureAgent(db)` which seeds the `api-design-reviewer` fixture
+ * agent (modelled after SEED_DATA.md §14 `code-reviewer`) into a shared SQLite
+ * DB handle that already has all four package migrations applied.
+ *
+ * Seed coverage:
+ *   - registry prefix : taxonomy category, agent, components, junction rows
+ *   - tool prefix     : agent tool grants (file_read, file_grep, web_search)
+ *   - provider prefix : model_hint = claude_sonnet_4_6 (seeded by seedProvider)
+ *   - policy prefix   : no-credentials policy template + direct attachment
+ *
+ * The two `success_criteria` junction rows are conditioned:
+ *   position=4 → code-review-criteria   (no context condition — general/review)
+ *   position=5 → security-audit-criteria (context_condition={ticket_type:"security"})
+ *
+ * This mirrors the exact pattern from SEED_DATA.md §14 (code-reviewer, positions
+ * 5+6) and USAGE.md "Context-Conditional Composition".
+ *
+ * [inv:one-db-handle]    — caller passes ONE shared DB handle, all four prefixes.
+ * [inv:real-rows-not-mocks] — this function seeds real rows; no mocks needed.
+ */
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+/** Slug of the seeded fixture agent. */
+export declare const FIXTURE_AGENT_SLUG = "api-design-reviewer-e2e";
+export declare const FIXTURE_CATEGORY_SLUG = "e2e-api-specialists";
+export declare const COMP_ROLE = "generic-reviewer-role";
+export declare const COMP_IDENTITY = "reviewer-identity";
+export declare const COMP_RULE = "default-skeptic";
+export declare const COMP_REVIEW_CRITERIA = "code-review-criteria";
+export declare const COMP_SECURITY_CRITERIA = "security-audit-criteria";
+export declare const TOOL_FILE_READ = "file_read";
+export declare const TOOL_FILE_GREP = "file_grep";
+export declare const TOOL_WEB_SEARCH = "web_search";
+/**
+ * Seed the `api-design-reviewer-e2e` fixture agent into `db`.
+ *
+ * Prerequisites (caller must have already run against `db`):
+ *   - All four package migrations applied.
+ *   - seedRegistry(db)      — for components (generic-reviewer-role etc.)
+ *   - seedToolRegistry(db)  — for tool catalog + platform bindings
+ *   - seedProvider(db)      — for model_platform_bindings (claude_sonnet_4_6)
+ *   - seedPolicy(db)        — for policy_policy_types + no-credentials template
+ *
+ * Idempotence: NOT idempotent — call once per test DB.  Tests create a fresh
+ * temp file per suite so re-seed is never needed.
+ *
+ * @param db - The shared Drizzle handle (all four table prefixes).
+ */
+export declare function seedFixtureAgent(db: BetterSQLite3Database<any>): void;
+//# sourceMappingURL=fixtures.d.ts.map

package/src/seed/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-compiler/src/seed/fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAYxE,wCAAwC;AACxC,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAC5D,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AAI3D,eAAO,MAAM,SAAS,0BAA0B,CAAC;AACjD,eAAO,MAAM,aAAa,sBAAsB,CAAC;AACjD,eAAO,MAAM,SAAS,oBAAoB,CAAC;AAC3C,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAGhE,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,eAAe,eAAe,CAAC;AAI5C;;;;;;;;;;;;;;GAcG;AAEH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,qBAAqB,CAAC,GAAG,CAAC,GAAG,IAAI,CAsGrE"}