@a16njs/models 0.5.0 → 0.7.0

package/README.md

@@ -1,6 +1,7 @@
 # @a16njs/models
 
 [![npm version](https://img.shields.io/npm/v/@a16njs/models.svg)](https://www.npmjs.com/package/@a16njs/models)
+[![codecov](https://codecov.io/gh/Texarkanine/a16n/graph/badge.svg?flag=models)](https://codecov.io/gh/Texarkanine/a16n)
 
 Type definitions and plugin interface for a16n.
 

package/dist/agentskills-io.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Shared utilities for parsing and writing AgentSkills.io format.
+ * This module handles the verbatim AgentSkills.io format WITHOUT IR frontmatter.
+ */
+/**
+ * Parsed frontmatter from an AgentSkills.io SKILL.md file.
+ * This is the VERBATIM AgentSkills.io format, NOT the IR format.
+ */
+export interface ParsedSkillFrontmatter {
+    /** Skill name (required) */
+    name: string;
+    /** Skill description for activation matching (required) */
+    description: string;
+    /** Resource file paths relative to skill directory (optional) */
+    resources?: string[];
+    /** If true, only invoked via /name (optional) */
+    disableModelInvocation?: boolean;
+}
+/**
+ * A parsed AgentSkills.io skill with content and frontmatter.
+ */
+export interface ParsedSkill {
+    /** Parsed frontmatter */
+    frontmatter: ParsedSkillFrontmatter;
+    /** Skill content after frontmatter */
+    content: string;
+}
+/**
+ * Parse the frontmatter from an AgentSkills.io SKILL.md file.
+ *
+ * This parses the VERBATIM AgentSkills.io format:
+ * - name (required)
+ * - description (required)
+ * - resources (optional)
+ * - disable-model-invocation (optional)
+ *
+ * It does NOT parse IR-specific fields (version, type, relativeDir).
+ *
+ * @param fileContent - The complete SKILL.md file content
+ * @returns Parsed skill or error message
+ *
+ * @example
+ * const content = `---
+ * name: deploy
+ * description: Deploy the application
+ * resources:
+ *   - checklist.md
+ * ---
+ *
+ * Deploy instructions...`;
+ *
+ * parseSkillFrontmatter(content)
+ * // { frontmatter: { name: 'deploy', description: '...', resources: ['checklist.md'] }, content: 'Deploy instructions...' }
+ */
+export declare function parseSkillFrontmatter(fileContent: string): {
+    success: true;
+    skill: ParsedSkill;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Read resource files from a skill directory.
+ *
+ * @param skillDir - Absolute path to the skill directory
+ * @param resources - Array of resource file paths (relative to skillDir)
+ * @returns Map of relative path to file content
+ *
+ * @example
+ * readSkillFiles('/path/to/skill', ['checklist.md', 'config.json'])
+ * // { 'checklist.md': '...', 'config.json': '...' }
+ */
+export declare function readSkillFiles(skillDir: string, resources: string[]): Promise<Record<string, string>>;
+/**
+ * Write an AgentSkillIO to disk in verbatim AgentSkills.io format.
+ *
+ * This writes the VERBATIM AgentSkills.io format:
+ * - SKILL.md with name, description, resources, disable-model-invocation
+ * - Resource files in the skill directory
+ *
+ * It does NOT write IR-specific fields (version, type, relativeDir).
+ *
+ * @param outputDir - Directory to write the skill (e.g., .a16n/agent-skill-io/<name>)
+ * @param frontmatter - Skill frontmatter (AgentSkills.io format)
+ * @param content - Skill content
+ * @param files - Resource files to write (key: relative path, value: content)
+ * @returns Array of written file paths
+ *
+ * @example
+ * await writeAgentSkillIO(
+ *   '.a16n/agent-skill-io/deploy',
+ *   { name: 'deploy', description: 'Deploy app', resources: ['checklist.md'] },
+ *   'Deploy instructions...',
+ *   { 'checklist.md': 'Checklist content...' }
+ * )
+ */
+export declare function writeAgentSkillIO(outputDir: string, frontmatter: ParsedSkillFrontmatter, content: string, files: Record<string, string>): Promise<string[]>;
+/**
+ * Read an AgentSkillIO from disk in verbatim AgentSkills.io format.
+ *
+ * This reads the VERBATIM AgentSkills.io format from:
+ * - SKILL.md with name, description, resources, disable-model-invocation
+ * - Resource files in the skill directory
+ *
+ * It does NOT expect IR-specific fields (version, type, relativeDir).
+ *
+ * @param skillDir - Directory containing the skill (e.g., .a16n/agent-skill-io/<name>)
+ * @returns Parsed skill with frontmatter, content, and resource files
+ *
+ * @example
+ * await readAgentSkillIO('.a16n/agent-skill-io/deploy')
+ * // {
+ * //   frontmatter: { name: 'deploy', description: '...', resources: ['checklist.md'] },
+ * //   content: 'Deploy instructions...',
+ * //   files: { 'checklist.md': 'Checklist content...' }
+ * // }
+ */
+export declare function readAgentSkillIO(skillDir: string): Promise<{
+    success: true;
+    skill: ParsedSkill & {
+        files: Record<string, string>;
+    };
+} | {
+    success: false;
+    error: string;
+}>;
+//# sourceMappingURL=agentskills-io.d.ts.map

package/dist/agentskills-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentskills-io.d.ts","sourceRoot":"","sources":["../src/agentskills-io.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,iDAAiD;IACjD,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,WAAW,EAAE,sBAAsB,CAAC;IACpC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAwC3E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAuBjC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,sBAAsB,EACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CA4CnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CACN;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,WAAW,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;CAAE,GACzE;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CACpC,CAgCA"}

package/dist/agentskills-io.js

@@ -0,0 +1,213 @@
+/**
+ * Shared utilities for parsing and writing AgentSkills.io format.
+ * This module handles the verbatim AgentSkills.io format WITHOUT IR frontmatter.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import matter from 'gray-matter';
+/**
+ * Parse the frontmatter from an AgentSkills.io SKILL.md file.
+ *
+ * This parses the VERBATIM AgentSkills.io format:
+ * - name (required)
+ * - description (required)
+ * - resources (optional)
+ * - disable-model-invocation (optional)
+ *
+ * It does NOT parse IR-specific fields (version, type, relativeDir).
+ *
+ * @param fileContent - The complete SKILL.md file content
+ * @returns Parsed skill or error message
+ *
+ * @example
+ * const content = `---
+ * name: deploy
+ * description: Deploy the application
+ * resources:
+ *   - checklist.md
+ * ---
+ *
+ * Deploy instructions...`;
+ *
+ * parseSkillFrontmatter(content)
+ * // { frontmatter: { name: 'deploy', description: '...', resources: ['checklist.md'] }, content: 'Deploy instructions...' }
+ */
+export function parseSkillFrontmatter(fileContent) {
+    try {
+        const parsed = matter(fileContent);
+        const data = parsed.data;
+        // Validate required fields
+        if (typeof data.name !== 'string') {
+            return { success: false, error: 'Missing required field: name' };
+        }
+        if (typeof data.description !== 'string') {
+            return { success: false, error: 'Missing required field: description' };
+        }
+        // Parse optional fields
+        const frontmatter = {
+            name: data.name,
+            description: data.description,
+        };
+        if (Array.isArray(data.resources)) {
+            frontmatter.resources = data.resources;
+        }
+        if (typeof data['disable-model-invocation'] === 'boolean') {
+            frontmatter.disableModelInvocation = data['disable-model-invocation'];
+        }
+        return {
+            success: true,
+            skill: {
+                frontmatter,
+                content: parsed.content.trim(),
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Failed to parse frontmatter',
+        };
+    }
+}
+/**
+ * Read resource files from a skill directory.
+ *
+ * @param skillDir - Absolute path to the skill directory
+ * @param resources - Array of resource file paths (relative to skillDir)
+ * @returns Map of relative path to file content
+ *
+ * @example
+ * readSkillFiles('/path/to/skill', ['checklist.md', 'config.json'])
+ * // { 'checklist.md': '...', 'config.json': '...' }
+ */
+export async function readSkillFiles(skillDir, resources) {
+    const files = {};
+    const resolvedSkillDir = path.resolve(skillDir);
+    for (const resource of resources) {
+        const resourcePath = path.join(skillDir, resource);
+        const resolvedResource = path.resolve(resourcePath);
+        // Validate path stays within skillDir to prevent path traversal
+        if (!resolvedResource.startsWith(resolvedSkillDir + path.sep) && resolvedResource !== resolvedSkillDir) {
+            continue; // Skip paths that escape the skill directory
+        }
+        try {
+            const content = await fs.readFile(resourcePath, 'utf-8');
+            files[resource] = content;
+        }
+        catch (error) {
+            // Skip missing files gracefully
+            continue;
+        }
+    }
+    return files;
+}
+/**
+ * Write an AgentSkillIO to disk in verbatim AgentSkills.io format.
+ *
+ * This writes the VERBATIM AgentSkills.io format:
+ * - SKILL.md with name, description, resources, disable-model-invocation
+ * - Resource files in the skill directory
+ *
+ * It does NOT write IR-specific fields (version, type, relativeDir).
+ *
+ * @param outputDir - Directory to write the skill (e.g., .a16n/agent-skill-io/<name>)
+ * @param frontmatter - Skill frontmatter (AgentSkills.io format)
+ * @param content - Skill content
+ * @param files - Resource files to write (key: relative path, value: content)
+ * @returns Array of written file paths
+ *
+ * @example
+ * await writeAgentSkillIO(
+ *   '.a16n/agent-skill-io/deploy',
+ *   { name: 'deploy', description: 'Deploy app', resources: ['checklist.md'] },
+ *   'Deploy instructions...',
+ *   { 'checklist.md': 'Checklist content...' }
+ * )
+ */
+export async function writeAgentSkillIO(outputDir, frontmatter, content, files) {
+    const written = [];
+    // Create output directory
+    await fs.mkdir(outputDir, { recursive: true });
+    // Build YAML frontmatter (AgentSkills.io format, NO IR fields)
+    const yamlData = {
+        name: frontmatter.name,
+        description: frontmatter.description,
+    };
+    if (frontmatter.resources) {
+        yamlData.resources = frontmatter.resources;
+    }
+    if (frontmatter.disableModelInvocation) {
+        yamlData['disable-model-invocation'] = frontmatter.disableModelInvocation;
+    }
+    // Write SKILL.md with gray-matter
+    const skillContent = matter.stringify(content, yamlData);
+    const skillPath = path.join(outputDir, 'SKILL.md');
+    await fs.writeFile(skillPath, skillContent, 'utf-8');
+    written.push(skillPath);
+    // Write resource files
+    const resolvedOutputDir = path.resolve(outputDir);
+    for (const [relativePath, fileContent] of Object.entries(files)) {
+        const filePath = path.join(outputDir, relativePath);
+        const resolvedFilePath = path.resolve(filePath);
+        // Validate path stays within outputDir to prevent path traversal
+        if (!resolvedFilePath.startsWith(resolvedOutputDir + path.sep) && resolvedFilePath !== resolvedOutputDir) {
+            throw new Error(`Invalid resource path: ${relativePath} escapes output directory`);
+        }
+        const fileDir = path.dirname(filePath);
+        await fs.mkdir(fileDir, { recursive: true });
+        await fs.writeFile(filePath, fileContent, 'utf-8');
+        written.push(filePath);
+    }
+    return written;
+}
+/**
+ * Read an AgentSkillIO from disk in verbatim AgentSkills.io format.
+ *
+ * This reads the VERBATIM AgentSkills.io format from:
+ * - SKILL.md with name, description, resources, disable-model-invocation
+ * - Resource files in the skill directory
+ *
+ * It does NOT expect IR-specific fields (version, type, relativeDir).
+ *
+ * @param skillDir - Directory containing the skill (e.g., .a16n/agent-skill-io/<name>)
+ * @returns Parsed skill with frontmatter, content, and resource files
+ *
+ * @example
+ * await readAgentSkillIO('.a16n/agent-skill-io/deploy')
+ * // {
+ * //   frontmatter: { name: 'deploy', description: '...', resources: ['checklist.md'] },
+ * //   content: 'Deploy instructions...',
+ * //   files: { 'checklist.md': 'Checklist content...' }
+ * // }
+ */
+export async function readAgentSkillIO(skillDir) {
+    try {
+        // Read SKILL.md
+        const skillPath = path.join(skillDir, 'SKILL.md');
+        const skillContent = await fs.readFile(skillPath, 'utf-8');
+        // Parse frontmatter
+        const parseResult = parseSkillFrontmatter(skillContent);
+        if (!parseResult.success) {
+            return parseResult;
+        }
+        // Read resource files
+        const resources = parseResult.skill.frontmatter.resources || [];
+        const files = await readSkillFiles(skillDir, resources);
+        return {
+            success: true,
+            skill: {
+                ...parseResult.skill,
+                files,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error
+                ? `Failed to read SKILL.md: ${error.message}`
+                : 'Failed to read SKILL.md',
+        };
+    }
+}
+//# sourceMappingURL=agentskills-io.js.map

package/dist/agentskills-io.js.map

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

package/dist/index.d.ts

@@ -4,4 +4,6 @@ export { type A16nPlugin, type DiscoveryResult, type EmitResult, type EmitOption
 export { WarningCode, type Warning } from './warnings.js';
 export { isGlobalPrompt, isSimpleAgentSkill, isAgentSkill, // Deprecated alias for isSimpleAgentSkill
 isAgentSkillIO, isFileRule, isAgentIgnore, isManualPrompt, getUniqueFilename, createId, } from './helpers.js';
+export { type IRVersion, type ParsedIRVersion, CURRENT_IR_VERSION, parseIRVersion, areVersionsCompatible, getCurrentVersion, } from './version.js';
+export { type ParsedSkillFrontmatter, type ParsedSkill, parseSkillFrontmatter, readSkillFiles, writeAgentSkillIO, readAgentSkillIO, } from './agentskills-io.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAAE,wCAAwC;AACzD,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,YAAY,EAAE,0CAA0C;AACxD,cAAc,EACd,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,QAAQ,GACT,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAAE,wCAAwC;AACzD,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,YAAY,EAAE,0CAA0C;AACxD,cAAc,EACd,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,QAAQ,GACT,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -6,4 +6,8 @@ export { WarningCode } from './warnings.js';
 // Helpers
 export { isGlobalPrompt, isSimpleAgentSkill, isAgentSkill, // Deprecated alias for isSimpleAgentSkill
 isAgentSkillIO, isFileRule, isAgentIgnore, isManualPrompt, getUniqueFilename, createId, } from './helpers.js';
+// Version utilities
+export { CURRENT_IR_VERSION, parseIRVersion, areVersionsCompatible, getCurrentVersion, } from './version.js';
+// AgentSkills.io utilities
+export { parseSkillFrontmatter, readSkillFiles, writeAgentSkillIO, readAgentSkillIO, } from './agentskills-io.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,QAAQ;AACR,OAAO,EACL,iBAAiB,GASlB,MAAM,YAAY,CAAC;AAWpB,WAAW;AACX,OAAO,EAAE,WAAW,EAAgB,MAAM,eAAe,CAAC;AAE1D,UAAU;AACV,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,YAAY,EAAE,0CAA0C;AACxD,cAAc,EACd,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,QAAQ,GACT,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,QAAQ;AACR,OAAO,EACL,iBAAiB,GASlB,MAAM,YAAY,CAAC;AAWpB,WAAW;AACX,OAAO,EAAE,WAAW,EAAgB,MAAM,eAAe,CAAC;AAE1D,UAAU;AACV,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,YAAY,EAAE,0CAA0C;AACxD,cAAc,EACd,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,QAAQ,GACT,MAAM,cAAc,CAAC;AAEtB,oBAAoB;AACpB,OAAO,EAGL,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,2BAA2B;AAC3B,OAAO,EAGL,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/types.d.ts

@@ -19,17 +19,26 @@ export declare enum CustomizationType {
 /**
  * Base interface for all agent customization items.
  * Every customization discovered or emitted extends this interface.
+ *
+ * BREAKING CHANGES (Phase 9):
+ * - `version` is now required (was not present)
+ * - `sourcePath` is now optional (was required)
+ * - `relativeDir` added as optional field for directory structure preservation
  */
 export interface AgentCustomization {
     /** Unique identifier for this item */
     id: string;
     /** The type of customization */
     type: CustomizationType;
-    /** Original file path where this was discovered */
-    sourcePath: string;
+    /** IR version (required, e.g., 'v1beta1') */
+    version: string;
+    /** Original file path where this was discovered (optional, omitted in IR format) */
+    sourcePath?: string;
+    /** Relative directory path for preserving directory structure (optional) */
+    relativeDir?: string;
     /** The actual prompt/rule content */
     content: string;
-    /** Tool-specific extras that don't fit the standard model */
+    /** Tool-specific extras that don't fit the standard model (transient, not serialized in IR) */
     metadata: Record<string, unknown>;
 }
 /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,iBAAiB;IAC3B,4DAA4D;IAC5D,YAAY,kBAAkB;IAC9B,mFAAmF;IACnF,gBAAgB,uBAAuB;IACvC,sFAAsF;IACtF,YAAY,mBAAmB;IAC/B,sCAAsC;IACtC,QAAQ,cAAc;IACtB,mDAAmD;IACnD,WAAW,iBAAiB;IAC5B,wFAAwF;IACxF,YAAY,kBAAkB;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,IAAI,EAAE,iBAAiB,CAAC;IACxB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,IAAI,EAAE,iBAAiB,CAAC,YAAY,CAAC;CACtC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,IAAI,EAAE,iBAAiB,CAAC,gBAAgB,CAAC;IACzC,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,gBAAgB,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,IAAI,EAAE,iBAAiB,CAAC,YAAY,CAAC;IAErC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IAEb,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IAEpB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,gDAAgD;IAChD,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,QAAS,SAAQ,kBAAkB;IAClD,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC;IACjC,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,kBAAkB;IACrD,IAAI,EAAE,iBAAiB,CAAC,WAAW,CAAC;IACpC,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,IAAI,EAAE,iBAAiB,CAAC,YAAY,CAAC;IACrC,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,iBAAiB;IAC3B,4DAA4D;IAC5D,YAAY,kBAAkB;IAC9B,mFAAmF;IACnF,gBAAgB,uBAAuB;IACvC,sFAAsF;IACtF,YAAY,mBAAmB;IAC/B,sCAAsC;IACtC,QAAQ,cAAc;IACtB,mDAAmD;IACnD,WAAW,iBAAiB;IAC5B,wFAAwF;IACxF,YAAY,kBAAkB;CAC/B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,IAAI,EAAE,iBAAiB,CAAC;IACxB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,+FAA+F;IAC/F,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,IAAI,EAAE,iBAAiB,CAAC,YAAY,CAAC;CACtC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,IAAI,EAAE,iBAAiB,CAAC,gBAAgB,CAAC;IACzC,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,gBAAgB,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,IAAI,EAAE,iBAAiB,CAAC,YAAY,CAAC;IAErC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IAEb,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IAEpB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,gDAAgD;IAChD,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,QAAS,SAAQ,kBAAkB;IAClD,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC;IACjC,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,kBAAkB;IACrD,IAAI,EAAE,iBAAiB,CAAC,WAAW,CAAC;IACpC,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,IAAI,EAAE,iBAAiB,CAAC,YAAY,CAAC;IACrC,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/version.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Kubernetes-style IR version format.
+ * Format: v{major}{stability}{revision}
+ * Examples: v1beta1, v2alpha3, v1stable1, v11 (stable)
+ *
+ * Requirements:
+ * - Must start with 'v'
+ * - Must have a major version number
+ * - May have stability identifier (alpha, beta, stable, or empty for stable)
+ * - Must end with a revision number (trailing number required)
+ *
+ * Valid: v1beta1, v2alpha3, v10stable5, v11
+ * Invalid: v1, v2beta, vbeta1, 1beta1
+ */
+export type IRVersion = string & {
+    readonly __brand: 'IRVersion';
+};
+/**
+ * Parsed components of an IR version.
+ */
+export interface ParsedIRVersion {
+    /** Major version number (e.g., 1, 2, 10) */
+    major: number;
+    /** Stability identifier (alpha, beta, stable, or empty string for stable) */
+    stability: string;
+    /** Revision number (e.g., 1, 2, 3) */
+    revision: number;
+}
+/**
+ * The current IR version used by this version of a16n.
+ */
+export declare const CURRENT_IR_VERSION: IRVersion;
+/**
+ * Parse an IR version string into its components.
+ *
+ * @param version - The version string to parse (e.g., 'v1beta1')
+ * @returns Parsed version components or null if invalid
+ *
+ * @example
+ * parseIRVersion('v1beta1') // { major: 1, stability: 'beta', revision: 1 }
+ * parseIRVersion('v2alpha3') // { major: 2, stability: 'alpha', revision: 3 }
+ * parseIRVersion('v11') // { major: 1, stability: '', revision: 1 }
+ * parseIRVersion('v1') // null (missing trailing revision number)
+ */
+export declare function parseIRVersion(version: string): ParsedIRVersion | null;
+/**
+ * Check if two IR versions are compatible.
+ *
+ * Compatibility rules (forward compatibility guarantee):
+ * 1. Major versions must match
+ * 2. Stability must match (alpha != beta != stable)
+ * 3. Reader revision >= file revision (newer reader can read older files)
+ *
+ * @param readerVersion - The version of the reader (current a16n version)
+ * @param fileVersion - The version found in the IR file
+ * @returns true if compatible, false otherwise
+ *
+ * @example
+ * areVersionsCompatible('v1beta2', 'v1beta1') // true (reader newer)
+ * areVersionsCompatible('v1beta1', 'v1beta2') // false (file too new)
+ * areVersionsCompatible('v2beta1', 'v1beta1') // false (major mismatch)
+ * areVersionsCompatible('v1stable1', 'v1beta1') // false (stability mismatch)
+ */
+export declare function areVersionsCompatible(readerVersion: string, fileVersion: string): boolean;
+/**
+ * Get the current IR version.
+ *
+ * @returns The current IR version constant
+ */
+export declare function getCurrentVersion(): IRVersion;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAkC,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAatE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAyBT;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C"}

package/dist/version.js

@@ -0,0 +1,76 @@
+/**
+ * The current IR version used by this version of a16n.
+ */
+export const CURRENT_IR_VERSION = 'v1beta1';
+/**
+ * Parse an IR version string into its components.
+ *
+ * @param version - The version string to parse (e.g., 'v1beta1')
+ * @returns Parsed version components or null if invalid
+ *
+ * @example
+ * parseIRVersion('v1beta1') // { major: 1, stability: 'beta', revision: 1 }
+ * parseIRVersion('v2alpha3') // { major: 2, stability: 'alpha', revision: 3 }
+ * parseIRVersion('v11') // { major: 1, stability: '', revision: 1 }
+ * parseIRVersion('v1') // null (missing trailing revision number)
+ */
+export function parseIRVersion(version) {
+    const regex = /^v(\d+)([a-z]*)(\d+)$/;
+    const match = regex.exec(version);
+    if (!match) {
+        return null;
+    }
+    return {
+        major: parseInt(match[1], 10),
+        stability: match[2] || '',
+        revision: parseInt(match[3], 10),
+    };
+}
+/**
+ * Check if two IR versions are compatible.
+ *
+ * Compatibility rules (forward compatibility guarantee):
+ * 1. Major versions must match
+ * 2. Stability must match (alpha != beta != stable)
+ * 3. Reader revision >= file revision (newer reader can read older files)
+ *
+ * @param readerVersion - The version of the reader (current a16n version)
+ * @param fileVersion - The version found in the IR file
+ * @returns true if compatible, false otherwise
+ *
+ * @example
+ * areVersionsCompatible('v1beta2', 'v1beta1') // true (reader newer)
+ * areVersionsCompatible('v1beta1', 'v1beta2') // false (file too new)
+ * areVersionsCompatible('v2beta1', 'v1beta1') // false (major mismatch)
+ * areVersionsCompatible('v1stable1', 'v1beta1') // false (stability mismatch)
+ */
+export function areVersionsCompatible(readerVersion, fileVersion) {
+    const reader = parseIRVersion(readerVersion);
+    const file = parseIRVersion(fileVersion);
+    // Invalid versions are incompatible
+    if (!reader || !file) {
+        return false;
+    }
+    // Normalize empty stability to 'stable'
+    const readerStability = reader.stability === '' ? 'stable' : reader.stability;
+    const fileStability = file.stability === '' ? 'stable' : file.stability;
+    // Major versions must match
+    if (reader.major !== file.major) {
+        return false;
+    }
+    // Stability must match
+    if (readerStability !== fileStability) {
+        return false;
+    }
+    // Reader revision must be >= file revision (forward compatibility)
+    return reader.revision >= file.revision;
+}
+/**
+ * Get the current IR version.
+ *
+ * @returns The current IR version constant
+ */
+export function getCurrentVersion() {
+    return CURRENT_IR_VERSION;
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AA4BA;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAc,SAAsB,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,KAAK,GAAG,uBAAuB,CAAC;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAElC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;QAC9B,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QACzB,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,qBAAqB,CACnC,aAAqB,EACrB,WAAmB;IAEnB,MAAM,MAAM,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAEzC,oCAAoC;IACpC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,wCAAwC;IACxC,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;IAC9E,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IAExE,4BAA4B;IAC5B,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uBAAuB;IACvB,IAAI,eAAe,KAAK,aAAa,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,mEAAmE;IACnE,OAAO,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/warnings.d.ts

@@ -15,7 +15,9 @@ export declare enum WarningCode {
     /** Git-ignored source with tracked output (or vice versa) */
     BoundaryCrossing = "boundary-crossing",
     /** Sources have conflicting git status (some ignored, some tracked) */
-    GitStatusConflict = "git-status-conflict"
+    GitStatusConflict = "git-status-conflict",
+    /** IR file version is incompatible with current reader version */
+    VersionMismatch = "version-mismatch"
 }
 /**
  * A warning about something that happened during conversion.

package/dist/warnings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"warnings.d.ts","sourceRoot":"","sources":["../src/warnings.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,WAAW;IACrB,kDAAkD;IAClD,MAAM,WAAW;IACjB,yCAAyC;IACzC,YAAY,iBAAiB;IAC7B,4CAA4C;IAC5C,OAAO,YAAY;IACnB,iCAAiC;IACjC,WAAW,gBAAgB;IAC3B,0CAA0C;IAC1C,WAAW,iBAAiB;IAC5B,6DAA6D;IAC7D,gBAAgB,sBAAsB;IACtC,uEAAuE;IACvE,iBAAiB,wBAAwB;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,0BAA0B;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}
+{"version":3,"file":"warnings.d.ts","sourceRoot":"","sources":["../src/warnings.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,WAAW;IACrB,kDAAkD;IAClD,MAAM,WAAW;IACjB,yCAAyC;IACzC,YAAY,iBAAiB;IAC7B,4CAA4C;IAC5C,OAAO,YAAY;IACnB,iCAAiC;IACjC,WAAW,gBAAgB;IAC3B,0CAA0C;IAC1C,WAAW,iBAAiB;IAC5B,6DAA6D;IAC7D,gBAAgB,sBAAsB;IACtC,uEAAuE;IACvE,iBAAiB,wBAAwB;IACzC,kEAAkE;IAClE,eAAe,qBAAqB;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,0BAA0B;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/dist/warnings.js

@@ -17,5 +17,7 @@ export var WarningCode;
     WarningCode["BoundaryCrossing"] = "boundary-crossing";
     /** Sources have conflicting git status (some ignored, some tracked) */
     WarningCode["GitStatusConflict"] = "git-status-conflict";
+    /** IR file version is incompatible with current reader version */
+    WarningCode["VersionMismatch"] = "version-mismatch";
 })(WarningCode || (WarningCode = {}));
 //# sourceMappingURL=warnings.js.map

package/dist/warnings.js.map

@@ -1 +1 @@
-{"version":3,"file":"warnings.js","sourceRoot":"","sources":["../src/warnings.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,WAeX;AAfD,WAAY,WAAW;IACrB,kDAAkD;IAClD,gCAAiB,CAAA;IACjB,yCAAyC;IACzC,4CAA6B,CAAA;IAC7B,4CAA4C;IAC5C,kCAAmB,CAAA;IACnB,iCAAiC;IACjC,0CAA2B,CAAA;IAC3B,0CAA0C;IAC1C,2CAA4B,CAAA;IAC5B,6DAA6D;IAC7D,qDAAsC,CAAA;IACtC,uEAAuE;IACvE,wDAAyC,CAAA;AAC3C,CAAC,EAfW,WAAW,KAAX,WAAW,QAetB"}
+{"version":3,"file":"warnings.js","sourceRoot":"","sources":["../src/warnings.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,WAiBX;AAjBD,WAAY,WAAW;IACrB,kDAAkD;IAClD,gCAAiB,CAAA;IACjB,yCAAyC;IACzC,4CAA6B,CAAA;IAC7B,4CAA4C;IAC5C,kCAAmB,CAAA;IACnB,iCAAiC;IACjC,0CAA2B,CAAA;IAC3B,0CAA0C;IAC1C,2CAA4B,CAAA;IAC5B,6DAA6D;IAC7D,qDAAsC,CAAA;IACtC,uEAAuE;IACvE,wDAAyC,CAAA;IACzC,kEAAkE;IAClE,mDAAoC,CAAA;AACtC,CAAC,EAjBW,WAAW,KAAX,WAAW,QAiBtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a16njs/models",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Type definitions and plugin interface for a16n",
   "license": "AGPL-3.0",
   "author": "Texarkanine",
@@ -9,7 +9,7 @@
     "url": "git+https://github.com/Texarkanine/a16n.git",
     "directory": "packages/models"
   },
-  "homepage": "https://github.com/Texarkanine/a16n#readme",
+  "homepage": "https://texarkanine.github.io/a16n/models",
   "bugs": {
     "url": "https://github.com/Texarkanine/a16n/issues"
   },
@@ -32,14 +32,19 @@
     "dist"
   ],
   "devDependencies": {
+    "@types/node": "^20.0.0",
     "typescript": "^5.4.0",
     "vitest": "^2.0.0"
   },
+  "dependencies": {
+    "gray-matter": "^4.0.3"
+  },
   "scripts": {
     "build": "tsc",
     "clean": "rimraf dist *.tsbuildinfo",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   }
 }