@agentfile/core 0.1.0

package/dist/generator.d.ts

@@ -0,0 +1,12 @@
+import type { Contract, GenerateResult } from './schema.js';
+export interface GenerateOptions {
+    root: string;
+    agents: string[];
+    dryRun?: boolean;
+}
+export interface ValidateOptions {
+    contractPath: string;
+}
+export declare function validateContract(options: ValidateOptions): Contract;
+export declare function generate(options: GenerateOptions): GenerateResult;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAY,cAAc,EAAe,MAAM,aAAa,CAAA;AAIlF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAK,MAAM,CAAA;IACf,MAAM,EAAG,MAAM,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAA;CACrB;AAqCD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAEnE;AAID,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAyDjE"}

package/dist/generator.js

@@ -0,0 +1,87 @@
+/// <reference types="node" />
+import { writeFileSync, mkdirSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { loadContract, loadOverride, resolveAgent, resolveAgentSelection } from './loader.js';
+import { renderTemplate, renderSkillMdc } from './renderer.js';
+// ─── Helpers ───────────────────────────────────────────────────────────────
+function writeFile(path, content, dryRun) {
+    if (dryRun)
+        return;
+    const dir = dirname(path);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(path, content, 'utf-8');
+}
+// Cursor generates one .mdc file per skill in addition to its main file
+function generateCursorSkillFiles(root, contract, dryRun) {
+    if (!contract.skills.length)
+        return [];
+    return contract.skills.map(skill => {
+        const output = `.cursor/rules/skills/${skill.name}.mdc`;
+        const content = renderSkillMdc(skill);
+        try {
+            writeFile(join(root, output), content, dryRun);
+            return { status: 'ok', agent: `cursor:skill:${skill.name}`, output, content };
+        }
+        catch (err) {
+            return {
+                status: 'error',
+                agent: `cursor:skill:${skill.name}`,
+                error: err instanceof Error ? err : new Error(String(err))
+            };
+        }
+    });
+}
+// ─── Validate ──────────────────────────────────────────────────────────────
+export function validateContract(options) {
+    return loadContract(options.contractPath);
+}
+// ─── Generate ──────────────────────────────────────────────────────────────
+export function generate(options) {
+    const { root, agents: requestedAgents, dryRun = false } = options;
+    const contractPath = join(root, 'ai', 'contract.yaml');
+    const agentsDir = join(root, 'ai', 'agents');
+    const overridePath = join(root, 'ai.override.yaml');
+    const contract = loadContract(contractPath);
+    const override = loadOverride(overridePath);
+    const selection = resolveAgentSelection(requestedAgents, agentsDir);
+    const results = [];
+    // Report unknown agents as skipped
+    for (const unknown of selection.unknown) {
+        results.push({
+            status: 'skipped',
+            agent: unknown,
+            reason: `No agent folder found at ai/agents/${unknown}`
+        });
+    }
+    // Generate each resolved agent
+    for (const agentName of selection.resolved) {
+        const agentDir = join(agentsDir, agentName);
+        try {
+            const resolved = resolveAgent(agentsDir, agentName);
+            // Determine skills rendering format per agent
+            const skillsFormat = agentName === 'copilot' ? 'copilot' :
+                agentName === 'agents-md' ? 'agents-md' :
+                    'markdown';
+            const content = renderTemplate(resolved.template, { contract, override }, skillsFormat);
+            const output = resolved.config.output;
+            writeFile(join(root, output), content, dryRun);
+            results.push({ status: 'ok', agent: agentName, output, content });
+            // Cursor: also generate per-skill .mdc files
+            if (agentName === 'cursor') {
+                const skillResults = generateCursorSkillFiles(root, contract, dryRun);
+                results.push(...skillResults);
+            }
+        }
+        catch (err) {
+            results.push({
+                status: 'error',
+                agent: agentName,
+                error: err instanceof Error ? err : new Error(String(err))
+            });
+        }
+    }
+    const success = results.every(r => r.status !== 'error');
+    return { results, success };
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @agentfile/core
+ *
+ * Core engine for agentfile — schema validation, loading, rendering, and generation.
+ * This package is framework-agnostic and has no CLI concerns.
+ *
+ * Primary entry points:
+ *   generate()         — full generation pass
+ *   validateContract() — schema validation only
+ *   renderTemplate()   — pure template rendering
+ */
+export { generate, validateContract } from './generator.js';
+export type { GenerateOptions, ValidateOptions } from './generator.js';
+export { renderTemplate, renderSkillMarkdown, renderSkillMdc, renderSkillCopilot } from './renderer.js';
+export type { RenderContext, SkillsFormat } from './renderer.js';
+export { loadContract, loadOverride, loadAgentConfig, loadAgentTemplate, resolveAgent, discoverAgents, resolveAgentSelection, ValidationError } from './loader.js';
+export type { Skill, Contract, AgentConfig, Override, ResolvedAgent, AgentResult, GenerateResult, AgentSelection } from './schema.js';
+export { ContractSchema, AgentConfigSchema, OverrideSchema, SkillSchema } from './schema.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":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAc,gBAAgB,CAAA;AACnE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGtE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvG,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAQ,eAAe,CAAA;AAGlE,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,eAAe,EAChB,MAAkD,aAAa,CAAA;AAGhE,YAAY,EACV,KAAK,EACL,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACf,MAAkD,aAAa,CAAA;AAGhE,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,WAAW,EACZ,MAAkD,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @agentfile/core
+ *
+ * Core engine for agentfile — schema validation, loading, rendering, and generation.
+ * This package is framework-agnostic and has no CLI concerns.
+ *
+ * Primary entry points:
+ *   generate()         — full generation pass
+ *   validateContract() — schema validation only
+ *   renderTemplate()   — pure template rendering
+ */
+// ─── Generation API ────────────────────────────────────────────────────────
+export { generate, validateContract } from './generator.js';
+// ─── Rendering API ─────────────────────────────────────────────────────────
+export { renderTemplate, renderSkillMarkdown, renderSkillMdc, renderSkillCopilot } from './renderer.js';
+// ─── Loading API ───────────────────────────────────────────────────────────
+export { loadContract, loadOverride, loadAgentConfig, loadAgentTemplate, resolveAgent, discoverAgents, resolveAgentSelection, ValidationError } from './loader.js';
+// ─── Schemas (for consumers that want to validate custom inputs) ────────────
+export { ContractSchema, AgentConfigSchema, OverrideSchema, SkillSchema } from './schema.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;;;;;;;;;;GAUG;AAEH,8EAA8E;AAC9E,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAc,gBAAgB,CAAA;AAGnE,8EAA8E;AAC9E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAGvG,8EAA8E;AAC9E,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,eAAe,EAChB,MAAkD,aAAa,CAAA;AAchE,+EAA+E;AAC/E,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,WAAW,EACZ,MAAkD,aAAa,CAAA"}

package/dist/loader.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { type Contract, type AgentConfig, type Override, type ResolvedAgent, type AgentSelection } from './schema.js';
+export declare class ValidationError extends Error {
+    readonly file: string;
+    readonly issues: string[];
+    constructor(file: string, issues: string[]);
+}
+export declare function parseYaml<S extends z.ZodTypeAny>(path: string, schema: S): z.output<S>;
+export declare function loadContract(contractPath: string): Contract;
+export declare function loadAgentConfig(agentDir: string): AgentConfig;
+export declare function loadAgentTemplate(agentDir: string): string;
+export declare function resolveAgent(agentsDir: string, agentName: string): ResolvedAgent;
+export declare function discoverAgents(agentsDir: string): string[];
+export declare function loadOverride(overridePath: string): Override | null;
+export declare function resolveAgentSelection(requested: string[], agentsDir: string): AgentSelection;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAA;AAIpB,qBAAa,eAAgB,SAAQ,KAAK;aACZ,IAAI,EAAE,MAAM;aAAkB,MAAM,EAAE,MAAM,EAAE;gBAA9C,IAAI,EAAE,MAAM,EAAkB,MAAM,EAAE,MAAM,EAAE;CAI3E;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAwBtF;AAID,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,CAE3D;AAID,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAE7D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAKhF;AAID,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAM1D;AAID,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAGlE;AAID,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,EAAG,MAAM,GACjB,cAAc,CAKhB"}

package/dist/loader.js

@@ -0,0 +1,82 @@
+/// <reference types="node" />
+import { readFileSync, existsSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { parse } from 'yaml';
+import { ContractSchema, AgentConfigSchema, OverrideSchema } from './schema.js';
+// ─── YAML Loader ───────────────────────────────────────────────────────────
+export class ValidationError extends Error {
+    file;
+    issues;
+    constructor(file, issues) {
+        super(`Validation failed in ${file}:\n${issues.map(i => `  • ${i}`).join('\n')}`);
+        this.file = file;
+        this.issues = issues;
+        this.name = 'ValidationError';
+    }
+}
+export function parseYaml(path, schema) {
+    if (!existsSync(path)) {
+        throw new Error(`Required file not found: ${path}`);
+    }
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf-8');
+    }
+    catch {
+        throw new Error(`Could not read file: ${path}`);
+    }
+    const parsed = parse(raw);
+    const result = schema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues.map(i => {
+            const path = i.path.length ? `${i.path.join('.')}: ` : '';
+            return `${path}${i.message}`;
+        });
+        throw new ValidationError(path, issues);
+    }
+    return result.data;
+}
+// ─── Contract Loader ───────────────────────────────────────────────────────
+export function loadContract(contractPath) {
+    return parseYaml(contractPath, ContractSchema);
+}
+// ─── Agent Loaders ─────────────────────────────────────────────────────────
+export function loadAgentConfig(agentDir) {
+    return parseYaml(join(agentDir, 'config.yaml'), AgentConfigSchema);
+}
+export function loadAgentTemplate(agentDir) {
+    const templatePath = join(agentDir, 'template.md');
+    if (!existsSync(templatePath)) {
+        throw new Error(`Template not found: ${templatePath}`);
+    }
+    return readFileSync(templatePath, 'utf-8');
+}
+export function resolveAgent(agentsDir, agentName) {
+    const agentDir = join(agentsDir, agentName);
+    const config = loadAgentConfig(agentDir);
+    const template = loadAgentTemplate(agentDir);
+    return { name: agentName, config, template };
+}
+// ─── Agent Discovery ───────────────────────────────────────────────────────
+export function discoverAgents(agentsDir) {
+    if (!existsSync(agentsDir))
+        return [];
+    return readdirSync(agentsDir, { withFileTypes: true })
+        .filter(d => d.isDirectory())
+        .map(d => d.name)
+        .sort();
+}
+// ─── Override Loader ───────────────────────────────────────────────────────
+export function loadOverride(overridePath) {
+    if (!existsSync(overridePath))
+        return null;
+    return parseYaml(overridePath, OverrideSchema);
+}
+// ─── Agent Selection ───────────────────────────────────────────────────────
+export function resolveAgentSelection(requested, agentsDir) {
+    const available = discoverAgents(agentsDir);
+    const unknown = requested.filter(a => !available.includes(a));
+    const resolved = requested.filter(a => available.includes(a));
+    return { requested, available, resolved, unknown };
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/renderer.d.ts

@@ -0,0 +1,15 @@
+import type { Contract, Override, Skill } from './schema.js';
+export interface RenderContext {
+    contract: Contract;
+    override: Override | null;
+}
+export declare function renderSkillMarkdown(skill: Skill): string;
+export declare function renderSkillMdc(skill: Skill): string;
+export declare function renderSkillCopilot(skill: Skill): string;
+export type SkillsFormat = 'markdown' | 'copilot' | 'agents-md';
+/**
+ * Renders a template string using a RenderContext.
+ * skillsFormat controls how skills are rendered for a given agent.
+ */
+export declare function renderTemplate(template: string, ctx: RenderContext, skillsFormat?: SkillsFormat): string;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAI5D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;CAC1B;AAoBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAgCxD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAqCnD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAIvD;AAqBD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAA;AA2B/D;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,aAAa,EAClB,YAAY,GAAE,YAAyB,GACtC,MAAM,CASR"}

package/dist/renderer.js

@@ -0,0 +1,129 @@
+// ─── Helpers ───────────────────────────────────────────────────────────────
+function renderList(items) {
+    return items.length
+        ? items.map(item => `- ${item}`).join('\n')
+        : '_None defined._';
+}
+function renderOverrideBlocks(override) {
+    if (!override?.blocks?.length)
+        return '';
+    return override.blocks
+        .map(block => `\n## ${block.section}\n\n${block.content.trim()}`)
+        .join('\n');
+}
+// ─── Skill Renderers ───────────────────────────────────────────────────────
+// Each format is a pure function: Skill → string
+export function renderSkillMarkdown(skill) {
+    const lines = [];
+    lines.push(`### ${skill.name}`);
+    lines.push(`${skill.description}\n`);
+    if (skill.context.length) {
+        lines.push('**Context**');
+        skill.context.forEach(c => lines.push(`- ${c}`));
+        lines.push('');
+    }
+    lines.push('**Steps**');
+    skill.steps.forEach((s, i) => lines.push(`${i + 1}. ${s}`));
+    lines.push('');
+    if (skill.expected_output) {
+        lines.push('**Expected output**');
+        lines.push(skill.expected_output.trim());
+        lines.push('');
+    }
+    if (skill.examples.length) {
+        lines.push('**Examples**');
+        skill.examples.forEach(ex => {
+            lines.push(`- Input: \`${ex.input}\``);
+            lines.push(`  Output: ${ex.output.trim()}`);
+        });
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function renderSkillMdc(skill) {
+    const lines = [];
+    lines.push('---');
+    lines.push(`description: ${skill.description}`);
+    lines.push('alwaysApply: false');
+    lines.push('---');
+    lines.push('');
+    lines.push(`# ${skill.name}`);
+    lines.push('');
+    if (skill.context.length) {
+        lines.push('## Context');
+        skill.context.forEach(c => lines.push(`- ${c}`));
+        lines.push('');
+    }
+    lines.push('## Steps');
+    skill.steps.forEach((s, i) => lines.push(`${i + 1}. ${s}`));
+    lines.push('');
+    if (skill.expected_output) {
+        lines.push('## Expected output');
+        lines.push(skill.expected_output.trim());
+        lines.push('');
+    }
+    if (skill.examples.length) {
+        lines.push('## Examples');
+        skill.examples.forEach(ex => {
+            lines.push(`**Input:** ${ex.input}`);
+            lines.push(`**Output:** ${ex.output.trim()}`);
+            lines.push('');
+        });
+    }
+    return lines.join('\n').trim() + '\n';
+}
+export function renderSkillCopilot(skill) {
+    const steps = skill.steps.join('; ');
+    const context = skill.context.length ? ` Context: ${skill.context.join(', ')}.` : '';
+    return `- **${skill.name}**: ${skill.description}.${context} Steps: ${steps}.`;
+}
+// ─── Skills Block Renderers ────────────────────────────────────────────────
+function renderSkillsMarkdown(skills) {
+    if (!skills.length)
+        return '';
+    return '\n## Skills\n\n' + skills.map(renderSkillMarkdown).join('\n');
+}
+function renderSkillsCopilot(skills) {
+    if (!skills.length)
+        return '';
+    return '\n## Available Workflows\n\n' + skills.map(renderSkillCopilot).join('\n');
+}
+function renderSkillsAgentsMd(skills) {
+    if (!skills.length)
+        return '';
+    return '\n## Skills\n\n' + skills.map(renderSkillMarkdown).join('\n');
+}
+function buildTokenMap(ctx, skillsFormat) {
+    const { project, rules, skills } = ctx.contract;
+    const renderSkills = () => {
+        switch (skillsFormat) {
+            case 'copilot': return renderSkillsCopilot(skills);
+            case 'agents-md': return renderSkillsAgentsMd(skills);
+            default: return renderSkillsMarkdown(skills);
+        }
+    };
+    return {
+        'project.name': project.name,
+        'project.stack.join(\', \')': project.stack.join(', '),
+        'rules.coding': renderList(rules.coding),
+        'rules.architecture': renderList(rules.architecture),
+        'rules.testing': renderList(rules.testing),
+        'rules.naming': renderList(rules.naming),
+        'skills': renderSkills(),
+        'override': renderOverrideBlocks(ctx.override)
+    };
+}
+// ─── Renderer ─────────────────────────────────────────────────────────────
+/**
+ * Renders a template string using a RenderContext.
+ * skillsFormat controls how skills are rendered for a given agent.
+ */
+export function renderTemplate(template, ctx, skillsFormat = 'markdown') {
+    const tokens = buildTokenMap(ctx, skillsFormat);
+    let output = template;
+    for (const [token, value] of Object.entries(tokens)) {
+        output = output.replaceAll(`\${${token}}`, value);
+    }
+    return output.trim() + '\n';
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,229 @@
+import { z } from 'zod';
+export declare const SkillExampleSchema: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    input: string;
+    output: string;
+}, {
+    input: string;
+    output: string;
+}>;
+export declare const SkillSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    context: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    steps: z.ZodArray<z.ZodString, "many">;
+    expected_output: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    examples: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        input: z.ZodString;
+        output: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        input: string;
+        output: string;
+    }, {
+        input: string;
+        output: string;
+    }>, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    context: string[];
+    steps: string[];
+    expected_output: string;
+    examples: {
+        input: string;
+        output: string;
+    }[];
+}, {
+    name: string;
+    description: string;
+    steps: string[];
+    context?: string[] | undefined;
+    expected_output?: string | undefined;
+    examples?: {
+        input: string;
+        output: string;
+    }[] | undefined;
+}>;
+export declare const ContractSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    project: z.ZodObject<{
+        name: z.ZodString;
+        stack: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        stack: string[];
+    }, {
+        name: string;
+        stack: string[];
+    }>;
+    rules: z.ZodDefault<z.ZodObject<{
+        coding: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        architecture: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        testing: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        naming: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        coding: string[];
+        architecture: string[];
+        testing: string[];
+        naming: string[];
+    }, {
+        coding?: string[] | undefined;
+        architecture?: string[] | undefined;
+        testing?: string[] | undefined;
+        naming?: string[] | undefined;
+    }>>;
+    skills: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        context: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        steps: z.ZodArray<z.ZodString, "many">;
+        expected_output: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        examples: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            input: z.ZodString;
+            output: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            input: string;
+            output: string;
+        }, {
+            input: string;
+            output: string;
+        }>, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description: string;
+        context: string[];
+        steps: string[];
+        expected_output: string;
+        examples: {
+            input: string;
+            output: string;
+        }[];
+    }, {
+        name: string;
+        description: string;
+        steps: string[];
+        context?: string[] | undefined;
+        expected_output?: string | undefined;
+        examples?: {
+            input: string;
+            output: string;
+        }[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    project: {
+        name: string;
+        stack: string[];
+    };
+    rules: {
+        coding: string[];
+        architecture: string[];
+        testing: string[];
+        naming: string[];
+    };
+    skills: {
+        name: string;
+        description: string;
+        context: string[];
+        steps: string[];
+        expected_output: string;
+        examples: {
+            input: string;
+            output: string;
+        }[];
+    }[];
+}, {
+    version: 1;
+    project: {
+        name: string;
+        stack: string[];
+    };
+    skills: {
+        name: string;
+        description: string;
+        steps: string[];
+        context?: string[] | undefined;
+        expected_output?: string | undefined;
+        examples?: {
+            input: string;
+            output: string;
+        }[] | undefined;
+    }[];
+    rules?: {
+        coding?: string[] | undefined;
+        architecture?: string[] | undefined;
+        testing?: string[] | undefined;
+        naming?: string[] | undefined;
+    } | undefined;
+}>;
+export declare const AgentConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    output: z.ZodString;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    output: string;
+    name: string;
+    description: string;
+}, {
+    output: string;
+    name: string;
+    description: string;
+}>;
+export declare const OverrideSchema: z.ZodObject<{
+    blocks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        section: z.ZodString;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        section: string;
+        content: string;
+    }, {
+        section: string;
+        content: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    blocks: {
+        section: string;
+        content: string;
+    }[];
+}, {
+    blocks?: {
+        section: string;
+        content: string;
+    }[] | undefined;
+}>;
+export type Skill = z.output<typeof SkillSchema>;
+export type Contract = z.output<typeof ContractSchema>;
+export type AgentConfig = z.output<typeof AgentConfigSchema>;
+export type Override = z.output<typeof OverrideSchema>;
+export interface AgentSelection {
+    requested: string[];
+    available: string[];
+    resolved: string[];
+    unknown: string[];
+}
+export interface ResolvedAgent {
+    name: string;
+    config: AgentConfig;
+    template: string;
+}
+export type AgentResult = {
+    status: 'ok';
+    agent: string;
+    output: string;
+    content: string;
+} | {
+    status: 'skipped';
+    agent: string;
+    reason: string;
+} | {
+    status: 'error';
+    agent: string;
+    error: Error;
+};
+export interface GenerateResult {
+    results: AgentResult[];
+    success: boolean;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAA;AAEF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOtB,CAAA;AAIF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAezB,CAAA;AAIF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAA;AAIF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;EAOzB,CAAA;AAIF,MAAM,MAAM,KAAK,GAAS,CAAC,CAAC,MAAM,CAAC,OAAO,WAAW,CAAC,CAAA;AACtD,MAAM,MAAM,QAAQ,GAAM,CAAC,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAA;AACzD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAC5D,MAAM,MAAM,QAAQ,GAAM,CAAC,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAA;AAIzD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,EAAG,MAAM,EAAE,CAAA;IACnB,OAAO,EAAI,MAAM,EAAE,CAAA;CACpB;AAID,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAM,MAAM,CAAA;IAChB,MAAM,EAAI,WAAW,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAID,MAAM,MAAM,WAAW,GACnB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAM,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA;AAEtD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAG,WAAW,EAAE,CAAA;IACvB,OAAO,EAAG,OAAO,CAAA;CAClB"}

package/dist/schema.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+// ─── Skill ─────────────────────────────────────────────────────────────────
+export const SkillExampleSchema = z.object({
+    input: z.string(),
+    output: z.string()
+});
+export const SkillSchema = z.object({
+    name: z.string().min(1),
+    description: z.string().min(1),
+    context: z.array(z.string()).optional().default([]),
+    steps: z.array(z.string()).min(1, 'A skill must have at least one step'),
+    expected_output: z.string().optional().default(''),
+    examples: z.array(SkillExampleSchema).optional().default([])
+});
+// ─── Contract ──────────────────────────────────────────────────────────────
+export const ContractSchema = z.object({
+    version: z.literal(1, {
+        errorMap: () => ({ message: 'Unsupported contract version. Only version 1 is supported.' })
+    }),
+    project: z.object({
+        name: z.string().min(1, 'project.name must not be empty'),
+        stack: z.array(z.string()).min(1, 'project.stack must contain at least one entry')
+    }),
+    rules: z.object({
+        coding: z.array(z.string()).optional().default([]),
+        architecture: z.array(z.string()).optional().default([]),
+        testing: z.array(z.string()).optional().default([]),
+        naming: z.array(z.string()).optional().default([])
+    }).default({}),
+    skills: z.array(SkillSchema).min(1, 'contract must define at least one skill')
+});
+// ─── Agent Config ──────────────────────────────────────────────────────────
+export const AgentConfigSchema = z.object({
+    name: z.string().min(1),
+    output: z.string().min(1, 'output path must not be empty'),
+    description: z.string()
+});
+// ─── Override ──────────────────────────────────────────────────────────────
+export const OverrideSchema = z.object({
+    blocks: z.array(z.object({
+        section: z.string().min(1),
+        content: z.string()
+    })).default([])
+});
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@agentfile/core",
+  "version": "0.1.0",
+  "description": "Core engine for agentfile — schema validation, loading, rendering, and generation",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types":  "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build":     "tsc",
+    "typecheck": "tsc --noEmit",
+    "test":      "vitest run"
+  },
+  "keywords": ["ai", "agents", "rules", "claude", "copilot", "cursor", "agentfile"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url":  "https://github.com/dennishavermans/agentfile"
+  },
+  "homepage": "https://github.com/dennishavermans/agentfile#readme",
+  "bugs": {
+    "url": "https://github.com/dennishavermans/agentfile/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@types/node": "^20.0.0",
+    "yaml":        "^2.3.4",
+    "zod":         "^3.22.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "vitest":     "^4.1.0"
+  }
+}