@galileodev/meta 0.1.0

package/dist/builder/builder.d.ts

@@ -0,0 +1,10 @@
+import type { RenderedPrompt } from './types.js';
+import type { TemplateRegistry } from './registry.js';
+export declare class PromptBuilder {
+    private readonly registry;
+    constructor(registry: TemplateRegistry);
+    build(stage: string, slots: Record<string, unknown>): Promise<RenderedPrompt>;
+    private validateRequiredSlots;
+    private fillSlots;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/builder/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/builder/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAEjD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAwBnF,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,SAAS;CAalB"}

package/dist/builder/builder.js

@@ -0,0 +1,45 @@
+import { countTokens } from './tokenizer.js';
+export class PromptBuilder {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    async build(stage, slots) {
+        const template = await this.registry.getActive(stage);
+        if (!template) {
+            throw new Error(`No active template for stage '${stage}'. Register a template first.`);
+        }
+        this.validateRequiredSlots(template, slots);
+        const sortedSections = [...template.sections].sort((a, b) => a.order - b.order);
+        const renderedSections = sortedSections.map((section) => this.fillSlots(section.content, slots));
+        const text = renderedSections.join('\n\n');
+        const tokenEstimate = countTokens(text);
+        return {
+            text,
+            template,
+            constraints: template.constraints,
+            tokenEstimate,
+        };
+    }
+    validateRequiredSlots(template, slots) {
+        for (const slot of template.slots) {
+            if (slot.required && !(slot.name in slots)) {
+                throw new Error(`Required slot '${slot.name}' is missing for template '${template.id}'.`);
+            }
+        }
+    }
+    fillSlots(content, slots) {
+        return content.replace(/\{\{(\w+)\}\}/g, (_match, slotName) => {
+            const value = slots[slotName];
+            if (value === undefined || value === null)
+                return '';
+            if (typeof value === 'string')
+                return value;
+            if (Array.isArray(value)) {
+                return value.map((item) => typeof item === 'string' ? item : JSON.stringify(item)).join('\n');
+            }
+            return String(value);
+        });
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/builder/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/builder/builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;IAAG,CAAC;IAE3D,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,KAA8B;QACvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,+BAA+B,CAAC,CAAC;QACzF,CAAC;QAED,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAE5C,MAAM,cAAc,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAChF,MAAM,gBAAgB,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACtD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CACvC,CAAC;QAEF,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAExC,OAAO;YACL,IAAI;YACJ,QAAQ;YACR,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,aAAa;SACd,CAAC;IACJ,CAAC;IAEO,qBAAqB,CAAC,QAAwB,EAAE,KAA8B;QACpF,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,IAAI,8BAA8B,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,OAAe,EAAE,KAA8B;QAC/D,OAAO,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,QAAgB,EAAE,EAAE;YACpE,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,EAAE,CAAC;YACrD,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACxB,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CACvD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;YACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/builder/defaults.d.ts

@@ -0,0 +1,6 @@
+import type { PromptTemplate } from './types.js';
+export declare const DEFAULT_GENERATOR_TEMPLATE: PromptTemplate;
+export declare const DEFAULT_REFLECTOR_TEMPLATE: PromptTemplate;
+export declare const DEFAULT_CURATOR_TEMPLATE: PromptTemplate;
+export declare const ALL_DEFAULT_TEMPLATES: PromptTemplate[];
+//# sourceMappingURL=defaults.d.ts.map

package/dist/builder/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/builder/defaults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,0BAA0B,EAAE,cA2BxC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,cA8BxC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,cA4BtC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,cAAc,EAIjD,CAAC"}

package/dist/builder/defaults.js

@@ -0,0 +1,94 @@
+export const DEFAULT_GENERATOR_TEMPLATE = {
+    id: 'generator-default-v1',
+    stage: 'generator',
+    version: 1,
+    slots: [
+        { name: 'instruction', type: 'string', required: true, description: 'Task instruction from the developer' },
+        { name: 'playbookContext', type: 'entries', required: false, description: 'Active playbook entries' },
+    ],
+    sections: [
+        {
+            id: 'role',
+            content: 'You are the Generator in an ACE (Agentic Context Engineering) pipeline.\nYour role is to produce explicit reasoning trajectories and code artifacts.',
+            order: 1,
+        },
+        { id: 'context', content: '## Playbook Context\n{{playbookContext}}', order: 2 },
+        { id: 'task', content: '## Task\n{{instruction}}', order: 3 },
+        {
+            id: 'format',
+            content: 'Respond with trajectories (step-by-step reasoning) and artifacts (code/config files).',
+            order: 4,
+        },
+    ],
+    constraints: [
+        { id: 'gen-format', type: 'output-format', description: 'Must return JSON with trajectories and artifacts arrays', check: 'zod:GenerationResponseSchema' },
+    ],
+    outputSchema: 'GenerationResponseSchema',
+    metadata: { createdAt: '2026-04-03T00:00:00.000Z', tokenEstimate: 200 },
+};
+export const DEFAULT_REFLECTOR_TEMPLATE = {
+    id: 'reflector-default-v1',
+    stage: 'reflector',
+    version: 1,
+    slots: [
+        { name: 'trajectories', type: 'string', required: true, description: 'Generator reasoning traces' },
+        { name: 'artifacts', type: 'artifacts', required: true, description: 'Generated code artifacts' },
+        { name: 'groundTruth', type: 'string', required: false, description: 'Test results or error logs' },
+    ],
+    sections: [
+        {
+            id: 'role',
+            content: 'You are the Reflector in an ACE (Agentic Context Engineering) pipeline.\nYour role is to analyze a generation result and extract factual and heuristic lessons.',
+            order: 1,
+        },
+        { id: 'trajectories', content: '## Generation Trajectories\n{{trajectories}}', order: 2 },
+        { id: 'artifacts', content: '## Generated Artifacts\n{{artifacts}}', order: 3 },
+        { id: 'groundTruth', content: '## Ground Truth\n{{groundTruth}}', order: 4 },
+        {
+            id: 'format',
+            content: 'Extract lessons: what worked (success), what failed (failure), and general heuristics.\nRate your confidence in each lesson from 0 to 1.',
+            order: 5,
+        },
+    ],
+    constraints: [
+        { id: 'ref-format', type: 'output-format', description: 'Must return JSON with lessons array', check: 'zod:ReflectionResponseSchema' },
+        { id: 'ref-consistency', type: 'consistency', description: 'Lessons must not contradict each other', check: 'llm-judge' },
+    ],
+    outputSchema: 'ReflectionResponseSchema',
+    metadata: { createdAt: '2026-04-03T00:00:00.000Z', tokenEstimate: 300 },
+};
+export const DEFAULT_CURATOR_TEMPLATE = {
+    id: 'curator-default-v1',
+    stage: 'curator',
+    version: 1,
+    slots: [
+        { name: 'lessons', type: 'lessons', required: true, description: 'Lessons from the Reflector' },
+        { name: 'currentEntries', type: 'entries', required: false, description: 'Current playbook entries' },
+    ],
+    sections: [
+        {
+            id: 'role',
+            content: 'You are the Curator in an ACE (Agentic Context Engineering) pipeline.\nYour role is to score lessons for utility and harmfulness, then produce compact delta updates.',
+            order: 1,
+        },
+        { id: 'lessons', content: '## Lessons from Reflector\n{{lessons}}', order: 2 },
+        { id: 'currentEntries', content: '## Current Playbook Entries\n{{currentEntries}}', order: 3 },
+        {
+            id: 'format',
+            content: 'For each lesson, produce a concise delta entry with utility score [0,1] and harmfulness score [0,1].\nMerge similar insights. Drop low-value or harmful ones.',
+            order: 4,
+        },
+    ],
+    constraints: [
+        { id: 'cur-format', type: 'output-format', description: 'Must return JSON with scoredEntries array', check: 'zod:CurationResponseSchema' },
+        { id: 'cur-scores', type: 'content-rule', description: 'Utility and harmfulness scores must be in [0, 1]', check: 'range:0:1' },
+    ],
+    outputSchema: 'CurationResponseSchema',
+    metadata: { createdAt: '2026-04-03T00:00:00.000Z', tokenEstimate: 250 },
+};
+export const ALL_DEFAULT_TEMPLATES = [
+    DEFAULT_GENERATOR_TEMPLATE,
+    DEFAULT_REFLECTOR_TEMPLATE,
+    DEFAULT_CURATOR_TEMPLATE,
+];
+//# sourceMappingURL=defaults.js.map

package/dist/builder/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/builder/defaults.ts"],"names":[],"mappings":"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"}

package/dist/builder/registry.d.ts

@@ -0,0 +1,16 @@
+import { type PromptTemplate } from './types.js';
+export declare class TemplateRegistry {
+    private readonly dir;
+    private readonly templatesPath;
+    private readonly activePath;
+    constructor(dir: string);
+    get(id: string): Promise<PromptTemplate | null>;
+    getAll(): Promise<PromptTemplate[]>;
+    save(template: PromptTemplate): Promise<void>;
+    getActive(stage: string): Promise<PromptTemplate | null>;
+    setActive(stage: string, templateId: string): Promise<void>;
+    private readActiveMap;
+    private writeActiveMapAtomic;
+    private ensureDir;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/builder/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/builder/registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEvE,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHhC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAEP,GAAG,EAAE,MAAM;IAKlC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK/C,MAAM,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IASnC,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7C,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAOxD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAMnD,aAAa;YAQb,oBAAoB;YAOpB,SAAS;CAKxB"}

package/dist/builder/registry.js

@@ -0,0 +1,61 @@
+import { readFile, writeFile, appendFile, rename, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { PromptTemplateSchema } from './types.js';
+export class TemplateRegistry {
+    dir;
+    templatesPath;
+    activePath;
+    constructor(dir) {
+        this.dir = dir;
+        this.templatesPath = join(dir, 'templates.jsonl');
+        this.activePath = join(dir, 'templates-active.json');
+    }
+    async get(id) {
+        const all = await this.getAll();
+        return all.find((t) => t.id === id) ?? null;
+    }
+    async getAll() {
+        if (!existsSync(this.templatesPath)) {
+            return [];
+        }
+        const raw = await readFile(this.templatesPath, 'utf-8');
+        const lines = raw.trim().split('\n').filter(Boolean);
+        return lines.map((line) => PromptTemplateSchema.parse(JSON.parse(line)));
+    }
+    async save(template) {
+        await this.ensureDir();
+        await appendFile(this.templatesPath, JSON.stringify(template) + '\n', 'utf-8');
+    }
+    async getActive(stage) {
+        const activeMap = await this.readActiveMap();
+        const id = activeMap[stage];
+        if (!id)
+            return null;
+        return this.get(id);
+    }
+    async setActive(stage, templateId) {
+        const activeMap = await this.readActiveMap();
+        activeMap[stage] = templateId;
+        await this.writeActiveMapAtomic(activeMap);
+    }
+    async readActiveMap() {
+        if (!existsSync(this.activePath)) {
+            return {};
+        }
+        const raw = await readFile(this.activePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    async writeActiveMapAtomic(map) {
+        await this.ensureDir();
+        const tmpPath = this.activePath + '.tmp';
+        await writeFile(tmpPath, JSON.stringify(map, null, 2), 'utf-8');
+        await rename(tmpPath, this.activePath);
+    }
+    async ensureDir() {
+        if (!existsSync(this.dir)) {
+            await mkdir(this.dir, { recursive: true });
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/builder/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/builder/registry.ts"],"names":[],"mappings":"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"}

package/dist/builder/tokenizer.d.ts

@@ -0,0 +1,2 @@
+export declare function countTokens(text: string): number;
+//# sourceMappingURL=tokenizer.d.ts.map

package/dist/builder/tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../src/builder/tokenizer.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD"}

package/dist/builder/tokenizer.js

@@ -0,0 +1,8 @@
+import { encodingForModel } from 'js-tiktoken';
+const encoder = encodingForModel('gpt-4o');
+export function countTokens(text) {
+    if (text.length === 0)
+        return 0;
+    return encoder.encode(text).length;
+}
+//# sourceMappingURL=tokenizer.js.map

package/dist/builder/tokenizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.js","sourceRoot":"","sources":["../../src/builder/tokenizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AAE3C,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AACrC,CAAC"}

package/dist/builder/types.d.ts

@@ -0,0 +1,175 @@
+import { z } from 'zod';
+export declare const SlotDefinitionSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<["string", "entries", "artifacts", "lessons"]>;
+    required: z.ZodBoolean;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    type: "string" | "entries" | "artifacts" | "lessons";
+    required: boolean;
+    description: string;
+}, {
+    name: string;
+    type: "string" | "entries" | "artifacts" | "lessons";
+    required: boolean;
+    description: string;
+}>;
+export type SlotDefinition = z.infer<typeof SlotDefinitionSchema>;
+export declare const TemplateSectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    content: z.ZodString;
+    order: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    content: string;
+    order: number;
+}, {
+    id: string;
+    content: string;
+    order: number;
+}>;
+export type TemplateSection = z.infer<typeof TemplateSectionSchema>;
+export declare const ConstraintSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<["output-format", "content-rule", "language", "consistency"]>;
+    description: z.ZodString;
+    check: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "output-format" | "content-rule" | "language" | "consistency";
+    description: string;
+    id: string;
+    check: string;
+}, {
+    type: "output-format" | "content-rule" | "language" | "consistency";
+    description: string;
+    id: string;
+    check: string;
+}>;
+export type Constraint = z.infer<typeof ConstraintSchema>;
+export declare const PromptTemplateSchema: z.ZodObject<{
+    id: z.ZodString;
+    stage: z.ZodEnum<["generator", "reflector", "curator"]>;
+    version: z.ZodNumber;
+    slots: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<["string", "entries", "artifacts", "lessons"]>;
+        required: z.ZodBoolean;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        type: "string" | "entries" | "artifacts" | "lessons";
+        required: boolean;
+        description: string;
+    }, {
+        name: string;
+        type: "string" | "entries" | "artifacts" | "lessons";
+        required: boolean;
+        description: string;
+    }>, "many">;
+    sections: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        content: z.ZodString;
+        order: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        content: string;
+        order: number;
+    }, {
+        id: string;
+        content: string;
+        order: number;
+    }>, "many">;
+    constraints: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<["output-format", "content-rule", "language", "consistency"]>;
+        description: z.ZodString;
+        check: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "output-format" | "content-rule" | "language" | "consistency";
+        description: string;
+        id: string;
+        check: string;
+    }, {
+        type: "output-format" | "content-rule" | "language" | "consistency";
+        description: string;
+        id: string;
+        check: string;
+    }>, "many">;
+    outputSchema: z.ZodString;
+    metadata: z.ZodObject<{
+        createdAt: z.ZodString;
+        tokenEstimate: z.ZodNumber;
+        parentId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        createdAt: string;
+        tokenEstimate: number;
+        parentId?: string | undefined;
+    }, {
+        createdAt: string;
+        tokenEstimate: number;
+        parentId?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    stage: "generator" | "reflector" | "curator";
+    version: number;
+    slots: {
+        name: string;
+        type: "string" | "entries" | "artifacts" | "lessons";
+        required: boolean;
+        description: string;
+    }[];
+    sections: {
+        id: string;
+        content: string;
+        order: number;
+    }[];
+    constraints: {
+        type: "output-format" | "content-rule" | "language" | "consistency";
+        description: string;
+        id: string;
+        check: string;
+    }[];
+    outputSchema: string;
+    metadata: {
+        createdAt: string;
+        tokenEstimate: number;
+        parentId?: string | undefined;
+    };
+}, {
+    id: string;
+    stage: "generator" | "reflector" | "curator";
+    version: number;
+    slots: {
+        name: string;
+        type: "string" | "entries" | "artifacts" | "lessons";
+        required: boolean;
+        description: string;
+    }[];
+    sections: {
+        id: string;
+        content: string;
+        order: number;
+    }[];
+    constraints: {
+        type: "output-format" | "content-rule" | "language" | "consistency";
+        description: string;
+        id: string;
+        check: string;
+    }[];
+    outputSchema: string;
+    metadata: {
+        createdAt: string;
+        tokenEstimate: number;
+        parentId?: string | undefined;
+    };
+}>;
+export type PromptTemplate = z.infer<typeof PromptTemplateSchema>;
+export interface RenderedPrompt {
+    text: string;
+    template: PromptTemplate;
+    constraints: Constraint[];
+    tokenEstimate: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/builder/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/builder/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAIhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/builder/types.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+export const SlotDefinitionSchema = z.object({
+    name: z.string().min(1),
+    type: z.enum(['string', 'entries', 'artifacts', 'lessons']),
+    required: z.boolean(),
+    description: z.string(),
+});
+export const TemplateSectionSchema = z.object({
+    id: z.string().min(1),
+    content: z.string(),
+    order: z.number(),
+});
+export const ConstraintSchema = z.object({
+    id: z.string().min(1),
+    type: z.enum(['output-format', 'content-rule', 'language', 'consistency']),
+    description: z.string(),
+    check: z.string(),
+});
+export const PromptTemplateSchema = z.object({
+    id: z.string().min(1),
+    stage: z.enum(['generator', 'reflector', 'curator']),
+    version: z.number().int().positive(),
+    slots: z.array(SlotDefinitionSchema),
+    sections: z.array(TemplateSectionSchema),
+    constraints: z.array(ConstraintSchema),
+    outputSchema: z.string(),
+    metadata: z.object({
+        createdAt: z.string().datetime(),
+        tokenEstimate: z.number().nonnegative(),
+        parentId: z.string().optional(),
+    }),
+});
+//# sourceMappingURL=types.js.map

package/dist/builder/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/builder/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAC3D,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IAC1E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACpC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;IACpC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IACtC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;QACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAChC,CAAC;CACH,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { PromptBuilder } from './builder/builder.js';
+export { TemplateRegistry } from './builder/registry.js';
+export { countTokens } from './builder/tokenizer.js';
+export { DEFAULT_GENERATOR_TEMPLATE, DEFAULT_REFLECTOR_TEMPLATE, DEFAULT_CURATOR_TEMPLATE, ALL_DEFAULT_TEMPLATES, } from './builder/defaults.js';
+export type { PromptTemplate, SlotDefinition, TemplateSection, Constraint, RenderedPrompt, } from './builder/types.js';
+export { PromptTemplateSchema, SlotDefinitionSchema, TemplateSectionSchema, ConstraintSchema, } from './builder/types.js';
+export { ConsistencyValidator } from './validator/validator.js';
+export { checkLanguageConstraint, checkRangeConstraint } from './validator/rules.js';
+export type { ValidationResult, ConstraintViolation, ValidationOptions, } from './validator/types.js';
+export { RatchetOptimizer } from './optimizer/optimizer.js';
+export { runExperiment } from './optimizer/experiment.js';
+export { computeScore, computeEfficiency } from './optimizer/evaluator.js';
+export type { ExperimentConfig, ExperimentResult, MetricDefinition, } from './optimizer/types.js';
+export { validateMetric } from './optimizer/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,UAAU,EACV,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACrF,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// packages/meta/src/index.ts
+export { PromptBuilder } from './builder/builder.js';
+export { TemplateRegistry } from './builder/registry.js';
+export { countTokens } from './builder/tokenizer.js';
+export { DEFAULT_GENERATOR_TEMPLATE, DEFAULT_REFLECTOR_TEMPLATE, DEFAULT_CURATOR_TEMPLATE, ALL_DEFAULT_TEMPLATES, } from './builder/defaults.js';
+export { PromptTemplateSchema, SlotDefinitionSchema, TemplateSectionSchema, ConstraintSchema, } from './builder/types.js';
+export { ConsistencyValidator } from './validator/validator.js';
+export { checkLanguageConstraint, checkRangeConstraint } from './validator/rules.js';
+export { RatchetOptimizer } from './optimizer/optimizer.js';
+export { runExperiment } from './optimizer/experiment.js';
+export { computeScore, computeEfficiency } from './optimizer/evaluator.js';
+export { validateMetric } from './optimizer/types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAOrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAM3E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/optimizer/evaluator.d.ts

@@ -0,0 +1,4 @@
+import type { MetricDefinition } from './types.js';
+export declare function computeScore(accuracy: number, efficiency: number, metric: MetricDefinition, accuracyThreshold: number): number;
+export declare function computeEfficiency(tokensUsed: number, baseline: number): number;
+//# sourceMappingURL=evaluator.d.ts.map

package/dist/optimizer/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/optimizer/evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,gBAAgB,EACxB,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAKR;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI9E"}

package/dist/optimizer/evaluator.js

@@ -0,0 +1,14 @@
+export function computeScore(accuracy, efficiency, metric, accuracyThreshold) {
+    if (accuracy < accuracyThreshold) {
+        return 0;
+    }
+    return metric.accuracy.weight * accuracy + metric.efficiency.weight * efficiency;
+}
+export function computeEfficiency(tokensUsed, baseline) {
+    if (baseline <= 0)
+        return 0;
+    if (tokensUsed >= baseline)
+        return 0;
+    return Math.min(1, (baseline - tokensUsed) / baseline);
+}
+//# sourceMappingURL=evaluator.js.map

package/dist/optimizer/evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../src/optimizer/evaluator.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,UAAkB,EAClB,MAAwB,EACxB,iBAAyB;IAEzB,IAAI,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QACjC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,UAAU,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,QAAgB;IACpE,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5B,IAAI,UAAU,IAAI,QAAQ;QAAE,OAAO,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG,QAAQ,CAAC,CAAC;AACzD,CAAC"}

package/dist/optimizer/experiment.d.ts

@@ -0,0 +1,18 @@
+import type { LLMProvider } from '@galileodev/core';
+import type { PromptTemplate } from '../builder/types.js';
+import type { MetricDefinition, ExperimentResult } from './types.js';
+interface ExperimentInput {
+    baseTemplate: PromptTemplate;
+    testInputs: Array<Record<string, unknown>>;
+    llm: LLMProvider;
+    metric: MetricDefinition;
+    directive: string;
+    accuracyThreshold: number;
+    concurrency: number;
+    failureHistory?: string[];
+}
+export declare function runExperiment(input: ExperimentInput): Promise<ExperimentResult & {
+    variant: PromptTemplate;
+}>;
+export {};
+//# sourceMappingURL=experiment.d.ts.map

package/dist/optimizer/experiment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experiment.d.ts","sourceRoot":"","sources":["../../src/optimizer/experiment.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAcrE,UAAU,eAAe;IACvB,YAAY,EAAE,cAAc,CAAC;IAC7B,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C,GAAG,EAAE,WAAW,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,GAAG;IAAE,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC,CA8CnH"}

package/dist/optimizer/experiment.js

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+import { ulid } from 'ulid';
+import { countTokens } from '../builder/tokenizer.js';
+import { computeScore, computeEfficiency } from './evaluator.js';
+const VariantResponseSchema = z.object({
+    sections: z.array(z.object({
+        id: z.string(),
+        content: z.string(),
+        order: z.number(),
+    })),
+});
+export async function runExperiment(input) {
+    const { baseTemplate, testInputs, llm, metric, directive, accuracyThreshold, concurrency, failureHistory } = input;
+    // 1. Generate variant
+    const variantPrompt = buildVariantPrompt(baseTemplate, directive, failureHistory);
+    const variantResponse = await llm.structured(variantPrompt, VariantResponseSchema);
+    const variantId = `${baseTemplate.stage}-v${baseTemplate.version + 1}-${ulid()}`;
+    const variant = {
+        ...baseTemplate,
+        id: variantId,
+        version: baseTemplate.version + 1,
+        sections: variantResponse.sections,
+        metadata: {
+            ...baseTemplate.metadata,
+            createdAt: new Date().toISOString(),
+            parentId: baseTemplate.id,
+            tokenEstimate: countTokens(variantResponse.sections.map((s) => s.content).join('\n')),
+        },
+    };
+    // 2. Evaluate both templates against test inputs
+    const [baseAccuracy, variantAccuracy] = await Promise.all([
+        evaluateTemplate(baseTemplate, testInputs, llm, concurrency),
+        evaluateTemplate(variant, testInputs, llm, concurrency),
+    ]);
+    // 3. Compute scores
+    const variantTokens = variant.metadata.tokenEstimate;
+    const efficiency = computeEfficiency(variantTokens, metric.efficiency.baseline);
+    const score = computeScore(variantAccuracy, efficiency, metric, accuracyThreshold);
+    const tokensUsed = countTokens(variantPrompt) + variantTokens;
+    return {
+        templateId: variantId,
+        parentId: baseTemplate.id,
+        score,
+        accuracy: variantAccuracy,
+        efficiency,
+        tokensUsed,
+        reverted: false,
+        variant,
+        // suppress unused warning for baseAccuracy — kept for future use
+        ...(baseAccuracy !== undefined ? {} : {}),
+    };
+}
+async function evaluateTemplate(template, testInputs, llm, concurrency) {
+    let passed = 0;
+    const chunks = chunkArray(testInputs, concurrency);
+    for (const chunk of chunks) {
+        const results = await Promise.all(chunk.map(async (input) => {
+            try {
+                const text = template.sections
+                    .sort((a, b) => a.order - b.order)
+                    .map((s) => {
+                    let content = s.content;
+                    for (const [key, value] of Object.entries(input)) {
+                        content = content.replaceAll(`{{${key}}}`, String(value));
+                    }
+                    return content;
+                })
+                    .join('\n\n');
+                await llm.structured(text, z.any());
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }));
+        passed += results.filter(Boolean).length;
+    }
+    return testInputs.length > 0 ? passed / testInputs.length : 0;
+}
+function buildVariantPrompt(template, directive, failureHistory) {
+    const parts = [
+        `You are optimizing a prompt template for the "${template.stage}" stage.`,
+        '',
+        '## Current Template Sections',
+        ...template.sections.map((s) => `### ${s.id} (order: ${s.order})\n${s.content}`),
+        '',
+        '## Optimization Directive',
+        directive,
+        '',
+        'Generate improved sections. Keep all {{slot}} placeholders. Respond with a JSON object containing a "sections" array.',
+    ];
+    if (failureHistory && failureHistory.length > 0) {
+        parts.push('', '## Previous Failed Attempts (avoid these approaches)', ...failureHistory);
+    }
+    return parts.join('\n');
+}
+function chunkArray(arr, size) {
+    const chunks = [];
+    for (let i = 0; i < arr.length; i += size) {
+        chunks.push(arr.slice(i, i + size));
+    }
+    return chunks;
+}
+//# sourceMappingURL=experiment.js.map

package/dist/optimizer/experiment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"experiment.js","sourceRoot":"","sources":["../../src/optimizer/experiment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEjE,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KAClB,CAAC,CACH;CACF,CAAC,CAAC;AAaH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAsB;IACxD,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IAEnH,sBAAsB;IACtB,MAAM,aAAa,GAAG,kBAAkB,CAAC,YAAY,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;IAClF,MAAM,eAAe,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAAC;IAEnF,MAAM,SAAS,GAAG,GAAG,YAAY,CAAC,KAAK,KAAK,YAAY,CAAC,OAAO,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;IACjF,MAAM,OAAO,GAAmB;QAC9B,GAAG,YAAY;QACf,EAAE,EAAE,SAAS;QACb,OAAO,EAAE,YAAY,CAAC,OAAO,GAAG,CAAC;QACjC,QAAQ,EAAE,eAAe,CAAC,QAAQ;QAClC,QAAQ,EAAE;YACR,GAAG,YAAY,CAAC,QAAQ;YACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,YAAY,CAAC,EAAE;YACzB,aAAa,EAAE,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACtF;KACF,CAAC;IAEF,iDAAiD;IACjD,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxD,gBAAgB,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,CAAC;QAC5D,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,CAAC;KACxD,CAAC,CAAC;IAEH,oBAAoB;IACpB,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IACrD,MAAM,UAAU,GAAG,iBAAiB,CAAC,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,YAAY,CAAC,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAEnF,MAAM,UAAU,GAAG,WAAW,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;IAE9D,OAAO;QACL,UAAU,EAAE,SAAS;QACrB,QAAQ,EAAE,YAAY,CAAC,EAAE;QACzB,KAAK;QACL,QAAQ,EAAE,eAAe;QACzB,UAAU;QACV,UAAU;QACV,QAAQ,EAAE,KAAK;QACf,OAAO;QACP,iEAAiE;QACjE,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,QAAwB,EACxB,UAA0C,EAC1C,GAAgB,EAChB,WAAmB;IAEnB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAEnD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACxB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ;qBAC3B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;qBACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACT,IAAI,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;oBACxB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;wBACjD,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC5D,CAAC;oBACD,OAAO,OAAO,CAAC;gBACjB,CAAC,CAAC;qBACD,IAAI,CAAC,MAAM,CAAC,CAAC;gBAChB,MAAM,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;gBACpC,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QACF,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAC3C,CAAC;IAED,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,kBAAkB,CACzB,QAAwB,EACxB,SAAiB,EACjB,cAAyB;IAEzB,MAAM,KAAK,GAAG;QACZ,iDAAiD,QAAQ,CAAC,KAAK,UAAU;QACzE,EAAE;QACF,8BAA8B;QAC9B,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;QAChF,EAAE;QACF,2BAA2B;QAC3B,SAAS;QACT,EAAE;QACF,uHAAuH;KACxH,CAAC;IAEF,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CACR,EAAE,EACF,sDAAsD,EACtD,GAAG,cAAc,CAClB,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU,CAAI,GAAQ,EAAE,IAAY;IAC3C,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/optimizer/optimizer.d.ts

@@ -0,0 +1,13 @@
+import { type LLMProvider } from '@galileodev/core';
+import type { ExperimentConfig, ExperimentResult } from './types.js';
+import type { TemplateRegistry } from '../builder/registry.js';
+export declare class RatchetOptimizer {
+    private readonly registry;
+    private readonly llm;
+    private readonly dir;
+    private readonly experimentsPath;
+    constructor(registry: TemplateRegistry, llm: LLMProvider, dir: string);
+    run(config: ExperimentConfig, testInputs: Array<Record<string, unknown>>): Promise<ExperimentResult[]>;
+    private logExperiment;
+}
+//# sourceMappingURL=optimizer.d.ts.map

package/dist/optimizer/optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimizer.d.ts","sourceRoot":"","sources":["../../src/optimizer/optimizer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAGtB,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,MAAM;IAKxB,GAAG,CACP,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACzC,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAiEhB,aAAa;CAO5B"}

package/dist/optimizer/optimizer.js

@@ -0,0 +1,82 @@
+import { appendFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { TokenBudget } from '@galileodev/core';
+import { validateMetric } from './types.js';
+import { runExperiment } from './experiment.js';
+export class RatchetOptimizer {
+    registry;
+    llm;
+    dir;
+    experimentsPath;
+    constructor(registry, llm, dir) {
+        this.registry = registry;
+        this.llm = llm;
+        this.dir = dir;
+        this.experimentsPath = join(dir, 'experiments.jsonl');
+    }
+    async run(config, testInputs) {
+        if (testInputs.length < 3) {
+            throw new Error('Not enough historical data to optimize. Run a few pipeline cycles first (need at least 3 inputs).');
+        }
+        const baseTemplate = await this.registry.getActive(config.targetStage);
+        if (!baseTemplate) {
+            throw new Error(`No active template for stage '${config.targetStage}'.`);
+        }
+        const budget = new TokenBudget(config.tokenBudget);
+        validateMetric(config.metric);
+        if (!Number.isFinite(config.accuracyThreshold) || config.accuracyThreshold < 0 || config.accuracyThreshold > 1) {
+            throw new Error('accuracyThreshold must be a finite number in [0, 1].');
+        }
+        if (!Number.isInteger(config.concurrency) || config.concurrency < 1) {
+            throw new Error('concurrency must be an integer >= 1.');
+        }
+        const results = [];
+        let currentBest = baseTemplate;
+        let bestScore = 0;
+        const failureHistory = [];
+        for (let i = 0; i < config.maxExperiments; i++) {
+            if (budget.exhausted())
+                break;
+            const result = await runExperiment({
+                baseTemplate: currentBest,
+                testInputs,
+                llm: this.llm,
+                metric: config.metric,
+                directive: config.directive,
+                accuracyThreshold: config.accuracyThreshold,
+                concurrency: config.concurrency,
+                failureHistory: failureHistory.slice(-3),
+            });
+            try {
+                budget.consume(result.tokensUsed);
+            }
+            catch {
+                // Budget exceeded — stop after this experiment
+                results.push({ ...result, reverted: true });
+                await this.logExperiment(result);
+                break;
+            }
+            if (result.score > bestScore) {
+                bestScore = result.score;
+                await this.registry.save(result.variant);
+                await this.registry.setActive(config.targetStage, result.variant.id);
+                currentBest = result.variant;
+                results.push({ ...result, reverted: false });
+            }
+            else {
+                failureHistory.push(`Attempt ${i + 1}: score=${result.score}, accuracy=${result.accuracy}, efficiency=${result.efficiency}`);
+                results.push({ ...result, reverted: true });
+            }
+            await this.logExperiment(result);
+        }
+        return results;
+    }
+    async logExperiment(result) {
+        const line = JSON.stringify({
+            ...result,
+            timestamp: new Date().toISOString(),
+        });
+        await appendFile(this.experimentsPath, line + '\n', 'utf-8');
+    }
+}
+//# sourceMappingURL=optimizer.js.map

package/dist/optimizer/optimizer.js.map

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

package/dist/optimizer/types.d.ts

@@ -0,0 +1,31 @@
+export interface MetricDefinition {
+    accuracy: {
+        weight: number;
+        evaluator: 'json-parse-rate' | 'constraint-pass-rate' | 'custom';
+    };
+    efficiency: {
+        weight: number;
+        baseline: number;
+    };
+}
+export interface ExperimentConfig {
+    targetStage: string;
+    tokenBudget: number;
+    maxExperiments: number;
+    metric: MetricDefinition;
+    directive: string;
+    accuracyThreshold: number;
+    concurrency: number;
+}
+export interface ExperimentResult {
+    templateId: string;
+    parentId: string;
+    score: number;
+    accuracy: number;
+    efficiency: number;
+    tokensUsed: number;
+    commitSha?: string;
+    reverted: boolean;
+}
+export declare function validateMetric(metric: MetricDefinition): void;
+//# sourceMappingURL=types.d.ts.map

package/dist/optimizer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/optimizer/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,iBAAiB,GAAG,sBAAsB,GAAG,QAAQ,CAAC;KAClE,CAAC;IACF,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAc7D"}

package/dist/optimizer/types.js

@@ -0,0 +1,16 @@
+export function validateMetric(metric) {
+    if (!Number.isFinite(metric.accuracy.weight) || metric.accuracy.weight < 0) {
+        throw new Error('accuracy.weight must be a finite non-negative number.');
+    }
+    if (!Number.isFinite(metric.efficiency.weight) || metric.efficiency.weight < 0) {
+        throw new Error('efficiency.weight must be a finite non-negative number.');
+    }
+    const sum = metric.accuracy.weight + metric.efficiency.weight;
+    if (Math.abs(sum - 1.0) > 1e-6) {
+        throw new Error(`Metric weights must sum to 1.0 (got ${sum}).`);
+    }
+    if (!Number.isFinite(metric.efficiency.baseline) || metric.efficiency.baseline <= 0) {
+        throw new Error('efficiency.baseline must be a finite positive number.');
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/optimizer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/optimizer/types.ts"],"names":[],"mappings":"AAgCA,MAAM,UAAU,cAAc,CAAC,MAAwB;IACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;IAC9D,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,IAAI,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC"}

package/dist/validator/rules.d.ts

@@ -0,0 +1,4 @@
+import type { ConstraintViolation } from './types.js';
+export declare function checkLanguageConstraint(response: unknown, check: string): ConstraintViolation | null;
+export declare function checkRangeConstraint(response: unknown, check: string): ConstraintViolation | null;
+//# sourceMappingURL=rules.d.ts.map

package/dist/validator/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/validator/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAOtD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,MAAM,GACZ,mBAAmB,GAAG,IAAI,CAmB5B;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,MAAM,GACZ,mBAAmB,GAAG,IAAI,CAwB5B"}

package/dist/validator/rules.js

@@ -0,0 +1,44 @@
+export function checkLanguageConstraint(response, check) {
+    const regexStr = check.replace('regex:', '');
+    const regex = new RegExp(regexStr);
+    const resp = response;
+    const artifacts = resp?.artifacts;
+    if (!artifacts || !Array.isArray(artifacts))
+        return null;
+    for (const artifact of artifacts) {
+        if (!regex.test(artifact.path)) {
+            return {
+                constraintId: '',
+                description: `Artifact path does not match pattern ${regexStr}`,
+                severity: 'error',
+                evidence: `Path '${artifact.path}' does not match ${regexStr}`,
+            };
+        }
+    }
+    return null;
+}
+export function checkRangeConstraint(response, check) {
+    const parts = check.replace('range:', '').split(':');
+    const min = parseFloat(parts[0]);
+    const max = parseFloat(parts[1]);
+    const resp = response;
+    const entries = resp?.scoredEntries;
+    if (!entries || !Array.isArray(entries))
+        return null;
+    for (const entry of entries) {
+        for (const [key, value] of Object.entries(entry)) {
+            if (typeof value === 'number' && (key === 'utility' || key === 'harmfulness')) {
+                if (value < min || value > max) {
+                    return {
+                        constraintId: '',
+                        description: `Value out of range [${min}, ${max}]`,
+                        severity: 'error',
+                        evidence: `${key} = ${value} is outside [${min}, ${max}]`,
+                    };
+                }
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=rules.js.map

package/dist/validator/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/validator/rules.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,uBAAuB,CACrC,QAAiB,EACjB,KAAa;IAEb,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEnC,MAAM,IAAI,GAAG,QAAmC,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,EAAE,SAAuC,CAAC;IAChE,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,OAAO;gBACL,YAAY,EAAE,EAAE;gBAChB,WAAW,EAAE,wCAAwC,QAAQ,EAAE;gBAC/D,QAAQ,EAAE,OAAO;gBACjB,QAAQ,EAAE,SAAS,QAAQ,CAAC,IAAI,oBAAoB,QAAQ,EAAE;aAC/D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,QAAiB,EACjB,KAAa;IAEb,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjC,MAAM,IAAI,GAAG,QAAmC,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,EAAE,aAA2D,CAAC;IAClF,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAErD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,aAAa,CAAC,EAAE,CAAC;gBAC9E,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;oBAC/B,OAAO;wBACL,YAAY,EAAE,EAAE;wBAChB,WAAW,EAAE,uBAAuB,GAAG,KAAK,GAAG,GAAG;wBAClD,QAAQ,EAAE,OAAO;wBACjB,QAAQ,EAAE,GAAG,GAAG,MAAM,KAAK,gBAAgB,GAAG,KAAK,GAAG,GAAG;qBAC1D,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/validator/types.d.ts

@@ -0,0 +1,16 @@
+export interface ValidationResult {
+    valid: boolean;
+    violations: ConstraintViolation[];
+    checkedConstraints: number;
+}
+export interface ConstraintViolation {
+    constraintId: string;
+    description: string;
+    severity: 'error' | 'warning';
+    evidence: string;
+}
+export interface ValidationOptions {
+    maxRetries?: number;
+    llmJudge?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/validator/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/validator/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/validator/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/validator/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/validator/types.ts"],"names":[],"mappings":""}

package/dist/validator/validator.d.ts

@@ -0,0 +1,11 @@
+import type { LLMProvider } from '@galileodev/core';
+import type { RenderedPrompt } from '../builder/types.js';
+import type { ValidationResult, ValidationOptions } from './types.js';
+export declare class ConsistencyValidator {
+    private readonly llm?;
+    constructor(llm?: LLMProvider | undefined);
+    validate(response: unknown, rendered: RenderedPrompt, options?: ValidationOptions): Promise<ValidationResult>;
+    private checkConstraint;
+    private llmJudge;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/validator/validator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAuB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAQ3F,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAJ,GAAG,CAAC,EAAE,WAAW,YAAA;IAExC,QAAQ,CACZ,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC;YAuBd,eAAe;YA+Bf,QAAQ;CA8BvB"}

package/dist/validator/validator.js

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+import { checkLanguageConstraint, checkRangeConstraint } from './rules.js';
+const LLMJudgeResponseSchema = z.object({
+    valid: z.boolean(),
+    evidence: z.string(),
+});
+export class ConsistencyValidator {
+    llm;
+    constructor(llm) {
+        this.llm = llm;
+    }
+    async validate(response, rendered, options = {}) {
+        const violations = [];
+        let checked = 0;
+        for (const constraint of rendered.constraints) {
+            const violation = await this.checkConstraint(constraint, response, options);
+            if (violation) {
+                violations.push({ ...violation, constraintId: constraint.id });
+                checked++;
+            }
+            else if (violation === null) {
+                checked++;
+            }
+            // undefined means skipped (not checked)
+        }
+        const errors = violations.filter((v) => v.severity === 'error');
+        return {
+            valid: errors.length === 0,
+            violations,
+            checkedConstraints: checked,
+        };
+    }
+    async checkConstraint(constraint, response, options) {
+        switch (constraint.type) {
+            case 'language': {
+                const result = checkLanguageConstraint(response, constraint.check);
+                return result ? { ...result, constraintId: constraint.id, description: constraint.description } : null;
+            }
+            case 'content-rule': {
+                if (constraint.check.startsWith('range:')) {
+                    const result = checkRangeConstraint(response, constraint.check);
+                    return result ? { ...result, constraintId: constraint.id, description: constraint.description } : null;
+                }
+                if (constraint.check === 'llm-judge') {
+                    return this.llmJudge(constraint, response, options);
+                }
+                return null;
+            }
+            case 'consistency': {
+                return this.llmJudge(constraint, response, options);
+            }
+            case 'output-format': {
+                return null; // Handled by Zod in structured() already
+            }
+            default:
+                return undefined;
+        }
+    }
+    async llmJudge(constraint, response, options) {
+        if (options.llmJudge === false || !this.llm) {
+            return undefined;
+        }
+        const prompt = [
+            `Check if this output satisfies the constraint: "${constraint.description}"`,
+            '',
+            '## Output to check',
+            JSON.stringify(response, null, 2),
+            '',
+            'Respond with {"valid": true/false, "evidence": "explanation"}',
+        ].join('\n');
+        const result = await this.llm.structured(prompt, LLMJudgeResponseSchema);
+        if (!result.valid) {
+            return {
+                constraintId: constraint.id,
+                description: constraint.description,
+                severity: 'error',
+                evidence: result.evidence,
+            };
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/validator/validator.js.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@galileodev/meta",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@galileodev/core": "*",
+    "zod": "^3.24.0",
+    "ulid": "^2.3.0",
+    "js-tiktoken": "^1.0.18"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0"
+  }
+}