@a16njs/plugin-a16n 0.1.0 → 0.3.0

package/README.md

@@ -1,6 +1,7 @@
 # @a16njs/plugin-a16n
 
-> a16n Intermediate Representation (IR) Plugin
+[![npm version](https://img.shields.io/npm/v/@a16njs/plugin-a16n.svg)](https://www.npmjs.com/package/@a16njs/plugin-a16n)
+[![codecov](https://codecov.io/gh/Texarkanine/a16n/graph/badge.svg?flag=plugin-a16n)](https://codecov.io/gh/Texarkanine/a16n)
 
 This plugin enables reading and writing the a16n intermediate representation to/from disk in a human-readable, git-friendly format with versioned schema support.
 
@@ -9,7 +10,6 @@ This plugin enables reading and writing the a16n intermediate representation to/
 - **Versioned Schema**: Kubernetes-style versioning (e.g., `v1beta1`) for forward compatibility
 - **Human-Readable**: Markdown files with YAML frontmatter
 - **Git-Friendly**: Text-based format optimized for version control
-- **Type-Safe**: Full TypeScript support with validated schemas
 
 ## Usage
 
@@ -103,10 +103,10 @@ Use this ID with CLI commands:
 
 - ✅ M1: IR Model Versioning & Extensions (complete)
 - ✅ M2: Plugin Package Setup (complete)
-- 🚧 M3: Frontmatter Parsing & Formatting (upcoming)
-- 🚧 M4: IR Emission (upcoming)
-- 🚧 M5: IR Discovery (upcoming)
-- 🚧 M6: CLI Integration (upcoming)
+- ✅ M3: Frontmatter Parsing & Formatting (complete)
+- ✅ M4: IR Emission (complete)
+- ✅ M5: IR Discovery (complete)
+- ✅ M6: E2E Integration Testing (complete)
 - 🚧 M7: Integration Testing & Documentation (upcoming)
 
 ## License

package/dist/discover.d.ts

@@ -0,0 +1,35 @@
+/**
+ * IR Discovery - Read intermediate representation from .a16n/ directory
+ *
+ * This module implements the discover() function for the a16n plugin,
+ * which reads IR items from the .a16n/ directory structure on disk.
+ *
+ * This is the inverse of emit():
+ * - Scans type directories in .a16n/
+ * - Parses frontmatter files via parseIRFile()
+ * - Handles AgentSkillIO verbatim format via readAgentSkillIO()
+ * - Validates versions with areVersionsCompatible()
+ * - Produces warnings for issues (unknown dirs, bad frontmatter, version mismatch)
+ *
+ * Directory structure: .a16n/<type>/<name>.md
+ * - Type directories use kebab-case matching CustomizationType enum values
+ * - AgentSkillIO uses subdirectory-per-skill with verbatim AgentSkills.io format
+ * - Other types use YAML frontmatter parsed by parseIRFile()
+ */
+import { type DiscoveryResult } from '@a16njs/models';
+/**
+ * Discover IR items from .a16n/ directory structure.
+ *
+ * Scans the .a16n/ directory in the given root, parsing each type subdirectory
+ * and returning all discovered IR items with any warnings.
+ *
+ * @param root - Project root directory containing .a16n/
+ * @returns DiscoveryResult with parsed IR items and warnings
+ *
+ * @example
+ * const result = await discover('/path/to/project');
+ * // result.items: AgentCustomization[]
+ * // result.warnings: Warning[]
+ */
+export declare function discover(root: string): Promise<DiscoveryResult>;
+//# sourceMappingURL=discover.d.ts.map

package/dist/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAGL,KAAK,eAAe,EAQrB,MAAM,gBAAgB,CAAC;AAOxB;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAkErE"}

package/dist/discover.js

@@ -0,0 +1,259 @@
+/**
+ * IR Discovery - Read intermediate representation from .a16n/ directory
+ *
+ * This module implements the discover() function for the a16n plugin,
+ * which reads IR items from the .a16n/ directory structure on disk.
+ *
+ * This is the inverse of emit():
+ * - Scans type directories in .a16n/
+ * - Parses frontmatter files via parseIRFile()
+ * - Handles AgentSkillIO verbatim format via readAgentSkillIO()
+ * - Validates versions with areVersionsCompatible()
+ * - Produces warnings for issues (unknown dirs, bad frontmatter, version mismatch)
+ *
+ * Directory structure: .a16n/<type>/<name>.md
+ * - Type directories use kebab-case matching CustomizationType enum values
+ * - AgentSkillIO uses subdirectory-per-skill with verbatim AgentSkills.io format
+ * - Other types use YAML frontmatter parsed by parseIRFile()
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { CustomizationType, WarningCode, CURRENT_IR_VERSION, areVersionsCompatible, readAgentSkillIO, createId, } from '@a16njs/models';
+import { parseIRFile } from './parse.js';
+/** Set of valid CustomizationType enum values for directory name validation */
+const VALID_TYPE_DIRS = new Set(Object.values(CustomizationType));
+/**
+ * Discover IR items from .a16n/ directory structure.
+ *
+ * Scans the .a16n/ directory in the given root, parsing each type subdirectory
+ * and returning all discovered IR items with any warnings.
+ *
+ * @param root - Project root directory containing .a16n/
+ * @returns DiscoveryResult with parsed IR items and warnings
+ *
+ * @example
+ * const result = await discover('/path/to/project');
+ * // result.items: AgentCustomization[]
+ * // result.warnings: Warning[]
+ */
+export async function discover(root) {
+    const items = [];
+    const warnings = [];
+    const a16nDir = path.join(root, '.a16n');
+    // Check if .a16n/ directory exists
+    try {
+        const stat = await fs.stat(a16nDir);
+        if (!stat.isDirectory()) {
+            return { items, warnings };
+        }
+    }
+    catch {
+        // .a16n/ does not exist
+        return { items, warnings };
+    }
+    // Read top-level entries in .a16n/
+    let entries;
+    try {
+        entries = await fs.readdir(a16nDir, { withFileTypes: true });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        warnings.push({
+            code: WarningCode.Skipped,
+            message: `Could not read .a16n/ directory: ${message}`,
+            sources: ['.a16n'],
+        });
+        return { items, warnings };
+    }
+    for (const entry of entries) {
+        // Skip non-directory entries (files directly in .a16n/)
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const dirName = entry.name;
+        // Validate against known CustomizationType values
+        if (!VALID_TYPE_DIRS.has(dirName)) {
+            warnings.push({
+                code: WarningCode.Skipped,
+                message: `Unknown type directory "${dirName}" in .a16n/ — skipping`,
+                sources: [`.a16n/${dirName}`],
+            });
+            continue;
+        }
+        const type = dirName;
+        const typeDir = path.join(a16nDir, dirName);
+        if (type === CustomizationType.AgentSkillIO) {
+            // AgentSkillIO uses readAgentSkillIO() (verbatim AgentSkills.io format)
+            const result = await discoverAgentSkillIO(typeDir);
+            items.push(...result.items);
+            warnings.push(...result.warnings);
+        }
+        else {
+            // All other types use parseIRFile() with YAML frontmatter
+            const result = await discoverStandardType(typeDir, type);
+            items.push(...result.items);
+            warnings.push(...result.warnings);
+        }
+    }
+    return { items, warnings };
+}
+/**
+ * Discover standard IR files (all types except AgentSkillIO) from a type directory.
+ *
+ * Recursively scans the type directory for .md files, parses each via parseIRFile(),
+ * validates version compatibility, and collects warnings for issues.
+ *
+ * @param typeDir - Absolute path to the type directory (e.g., /project/.a16n/global-prompt/)
+ * @param type - The CustomizationType for items in this directory
+ * @returns Items and warnings discovered from this type directory
+ */
+async function discoverStandardType(typeDir, type) {
+    const items = [];
+    const warnings = [];
+    // Find all .md files recursively (pass warnings to surface readdir errors)
+    const mdFiles = await findMdFiles(typeDir, '', warnings);
+    for (const relativeMdPath of mdFiles) {
+        const filepath = path.join(typeDir, relativeMdPath);
+        const filename = path.basename(relativeMdPath);
+        // Compute the relativePath for parseIRFile (path relative to project root's .a16n/)
+        // e.g., ".a16n/global-prompt" or ".a16n/global-prompt/shared/company"
+        const dirOfFile = path.dirname(filepath);
+        const a16nRoot = path.dirname(typeDir); // The .a16n/ directory
+        const relativeToA16n = path.relative(a16nRoot, dirOfFile).split(path.sep).join('/');
+        const relativePath = `.a16n/${relativeToA16n}`;
+        // Parse the IR file
+        const result = await parseIRFile(filepath, filename, relativePath);
+        if (result.error) {
+            warnings.push({
+                code: WarningCode.Skipped,
+                message: `Skipped "${relativeMdPath}" in ${type}: ${result.error}`,
+                sources: [`.a16n/${type}/${relativeMdPath}`],
+            });
+            continue;
+        }
+        if (!result.item) {
+            continue;
+        }
+        const item = result.item;
+        // Validate version compatibility
+        if (!areVersionsCompatible(CURRENT_IR_VERSION, item.version)) {
+            warnings.push({
+                code: WarningCode.VersionMismatch,
+                message: `Version mismatch in ".a16n/${type}/${relativeMdPath}": file has ${item.version}, reader is ${CURRENT_IR_VERSION}`,
+                sources: [`.a16n/${type}/${relativeMdPath}`],
+            });
+            // Still include the item (per design decision: items with version mismatch are still processed)
+        }
+        items.push(item);
+    }
+    return { items, warnings };
+}
+/**
+ * Discover AgentSkillIO items from the agent-skill-io type directory.
+ *
+ * Lists subdirectories in .a16n/agent-skill-io/, reads each via readAgentSkillIO(),
+ * and constructs AgentSkillIO IR items.
+ *
+ * @param agentSkillIODir - Absolute path to .a16n/agent-skill-io/
+ * @returns Items and warnings discovered from AgentSkillIO directories
+ */
+async function discoverAgentSkillIO(agentSkillIODir) {
+    const items = [];
+    const warnings = [];
+    let entries;
+    try {
+        entries = await fs.readdir(agentSkillIODir, { withFileTypes: true });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        warnings.push({
+            code: WarningCode.Skipped,
+            message: `Could not read AgentSkillIO directory: ${message}`,
+            sources: ['.a16n/agent-skill-io'],
+        });
+        return { items, warnings };
+    }
+    for (const entry of entries) {
+        // Only process directories (each is a skill)
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const skillDirName = entry.name;
+        const skillDir = path.join(agentSkillIODir, skillDirName);
+        const sourcePath = `.a16n/agent-skill-io/${skillDirName}/SKILL.md`;
+        // Read skill using shared readAgentSkillIO utility
+        const result = await readAgentSkillIO(skillDir);
+        if (!result.success) {
+            warnings.push({
+                code: WarningCode.Skipped,
+                message: `Skipped AgentSkillIO "${skillDirName}": ${result.error}`,
+                sources: [`.a16n/agent-skill-io/${skillDirName}`],
+            });
+            continue;
+        }
+        const { skill } = result;
+        // Construct AgentSkillIO IR item
+        const agentSkillIO = {
+            id: createId(CustomizationType.AgentSkillIO, sourcePath),
+            type: CustomizationType.AgentSkillIO,
+            version: CURRENT_IR_VERSION, // AgentSkills.io format has no version field
+            sourcePath,
+            content: skill.content,
+            name: skill.frontmatter.name,
+            description: skill.frontmatter.description,
+            disableModelInvocation: skill.frontmatter.disableModelInvocation,
+            resources: skill.frontmatter.resources,
+            files: skill.files,
+            metadata: {},
+        };
+        items.push(agentSkillIO);
+    }
+    return { items, warnings };
+}
+/**
+ * Recursively find all .md files in a directory.
+ * Returns paths relative to the given base directory.
+ *
+ * @param dir - Directory to scan
+ * @param relativePath - Current relative path (for recursion)
+ * @param warnings - Optional warnings array to report readdir failures
+ * @returns Array of relative paths to .md files
+ */
+async function findMdFiles(dir, relativePath = '', warnings) {
+    const results = [];
+    const targetDir = path.join(dir, relativePath);
+    try {
+        const entries = await fs.readdir(targetDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const entryRelativePath = relativePath
+                ? `${relativePath}/${entry.name}`
+                : entry.name;
+            if (entry.isFile() && entry.name.endsWith('.md')) {
+                results.push(entryRelativePath);
+            }
+            else if (entry.isDirectory()) {
+                // Recurse into subdirectories
+                const subFiles = await findMdFiles(dir, entryRelativePath, warnings);
+                results.push(...subFiles);
+            }
+        }
+    }
+    catch (err) {
+        // Surface readdir failures as warnings when a warnings accumulator is provided
+        if (warnings) {
+            const dirLabel = relativePath || path.basename(dir);
+            const typeName = path.basename(dir);
+            const relativeSource = relativePath
+                ? `.a16n/${typeName}/${relativePath}`
+                : `.a16n/${typeName}`;
+            const message = err instanceof Error ? err.message : String(err);
+            warnings.push({
+                code: WarningCode.Skipped,
+                message: `Could not read directory "${dirLabel}": ${message}`,
+                sources: [relativeSource],
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=discover.js.map

package/dist/discover.js.map

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

package/dist/emit.d.ts

@@ -0,0 +1,23 @@
+/**
+ * IR Emission - Write intermediate representation to .a16n/ directory
+ *
+ * This module implements the emit() function for the a16n plugin,
+ * which writes IR items to disk in the .a16n/ directory structure.
+ *
+ * Directory structure: .a16n/<type>/<name>.md
+ * - Type directories use kebab-case matching CustomizationType enum values
+ * - Files have YAML frontmatter with version, type, and type-specific fields
+ * - AgentSkillIO uses verbatim AgentSkills.io format (NO IR frontmatter)
+ * - relativeDir field creates subdirectories to preserve structure
+ */
+import { type AgentCustomization, type EmitResult, type EmitOptions } from '@a16njs/models';
+/**
+ * Emit IR items to .a16n/ directory structure.
+ *
+ * @param models - IR items to emit
+ * @param root - Project root directory
+ * @param options - Emission options (dryRun, etc.)
+ * @returns EmitResult with written files and warnings
+ */
+export declare function emit(models: AgentCustomization[], root: string, options?: EmitOptions): Promise<EmitResult>;
+//# sourceMappingURL=emit.d.ts.map

package/dist/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../src/emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,UAAU,EACf,KAAK,WAAW,EAQjB,MAAM,gBAAgB,CAAC;AAgBxB;;;;;;;GAOG;AACH,wBAAsB,IAAI,CACxB,MAAM,EAAE,kBAAkB,EAAE,EAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CA2CrB"}

package/dist/emit.js

@@ -0,0 +1,180 @@
+/**
+ * IR Emission - Write intermediate representation to .a16n/ directory
+ *
+ * This module implements the emit() function for the a16n plugin,
+ * which writes IR items to disk in the .a16n/ directory structure.
+ *
+ * Directory structure: .a16n/<type>/<name>.md
+ * - Type directories use kebab-case matching CustomizationType enum values
+ * - Files have YAML frontmatter with version, type, and type-specific fields
+ * - AgentSkillIO uses verbatim AgentSkills.io format (NO IR frontmatter)
+ * - relativeDir field creates subdirectories to preserve structure
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { WarningCode, isAgentSkillIO, isManualPrompt, writeAgentSkillIO, } from '@a16njs/models';
+import { formatIRFile } from './format.js';
+import { slugify } from './utils.js';
+/**
+ * Check if a path exists on the filesystem.
+ */
+async function pathExists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Emit IR items to .a16n/ directory structure.
+ *
+ * @param models - IR items to emit
+ * @param root - Project root directory
+ * @param options - Emission options (dryRun, etc.)
+ * @returns EmitResult with written files and warnings
+ */
+export async function emit(models, root, options) {
+    const written = [];
+    const warnings = [];
+    const unsupported = [];
+    const dryRun = options?.dryRun ?? false;
+    // Group items by CustomizationType
+    const byType = new Map();
+    for (const item of models) {
+        const items = byType.get(item.type) || [];
+        items.push(item);
+        byType.set(item.type, items);
+    }
+    // Process each type
+    for (const [type, items] of byType.entries()) {
+        // Base directory for this type (kebab-case matching enum value)
+        const baseDir = path.join(root, '.a16n', type);
+        for (const item of items) {
+            try {
+                if (isAgentSkillIO(item)) {
+                    // AgentSkillIO: use writeAgentSkillIO() for verbatim format
+                    await emitAgentSkillIO(item, baseDir, written, dryRun);
+                }
+                else {
+                    // All other types: use formatIRFile() for IR frontmatter
+                    await emitStandardIR(item, baseDir, written, dryRun);
+                }
+            }
+            catch (error) {
+                warnings.push({
+                    code: WarningCode.Skipped,
+                    message: `Failed to emit ${item.type} "${item.id}": ${error instanceof Error ? error.message : String(error)}`,
+                    sources: item.sourcePath ? [item.sourcePath] : [],
+                });
+            }
+        }
+    }
+    return {
+        written,
+        warnings,
+        unsupported,
+    };
+}
+/**
+ * Emit a standard IR item (all types except AgentSkillIO).
+ * Uses formatIRFile() to generate YAML frontmatter + content.
+ */
+async function emitStandardIR(item, baseDir, written, dryRun) {
+    // Determine target directory (handle relativeDir subdirectories)
+    // Validate that relativeDir doesn't escape baseDir via path traversal
+    const baseDirResolved = path.resolve(baseDir);
+    const targetDir = item.relativeDir
+        ? path.resolve(baseDirResolved, item.relativeDir)
+        : baseDirResolved;
+    const rel = path.relative(baseDirResolved, targetDir);
+    if (rel.startsWith('..') || path.isAbsolute(rel)) {
+        throw new Error(`Invalid relativeDir "${item.relativeDir}" (escapes ${baseDir})`);
+    }
+    // Extract name from ID and slugify for filename
+    // For ManualPrompt with path separators, extract basename only
+    const rawName = extractNameFromId(item.id);
+    const name = isManualPrompt(item) ? path.basename(rawName) : rawName;
+    const filename = `${slugify(name)}.md`;
+    const filePath = path.join(targetDir, filename);
+    // Format content with IR frontmatter
+    const content = formatIRFile(item);
+    // Check if file already exists before writing
+    const existed = await pathExists(filePath);
+    // Write file (unless dry-run)
+    if (!dryRun) {
+        await fs.mkdir(targetDir, { recursive: true });
+        await fs.writeFile(filePath, content, 'utf-8');
+    }
+    written.push({
+        path: filePath,
+        type: item.type,
+        itemCount: 1,
+        isNewFile: !existed,
+        sourceItems: [item],
+    });
+}
+/**
+ * Emit an AgentSkillIO item using verbatim AgentSkills.io format.
+ * Uses writeAgentSkillIO() from @a16njs/models.
+ *
+ * NOTE: AgentSkillIO uses a flat directory-per-skill layout. The spec and all
+ * current tools (Cursor, Claude Code) only support flat skill directories, so
+ * relativeDir is not used here. If the spec or tools add nested skill support
+ * in the future, relativeDir handling (with path-traversal validation) would
+ * need to be added — see emitStandardIR for the pattern.
+ */
+async function emitAgentSkillIO(item, baseDir, written, dryRun) {
+    // Use item.name for directory name — extractNameFromId mangles full source
+    // paths (e.g., ".cursor/skills/my-skill/SKILL" → "cursor-skills-my-skill-skill")
+    const skillDirName = slugify(item.name);
+    const skillDir = path.join(baseDir, skillDirName);
+    // Prepare frontmatter (AgentSkills.io format)
+    // Use original human-readable name, not the slugified directory name
+    const frontmatter = {
+        name: item.name,
+        description: item.description,
+    };
+    // Check if skill directory already exists before writing
+    const existed = await pathExists(skillDir);
+    // Write AgentSkillIO using shared utility (verbatim format)
+    if (!dryRun) {
+        await fs.mkdir(baseDir, { recursive: true });
+        await writeAgentSkillIO(skillDir, frontmatter, item.content, item.files || {});
+    }
+    written.push({
+        path: skillDir,
+        type: item.type,
+        itemCount: 1,
+        isNewFile: !existed,
+        sourceItems: [item],
+    });
+}
+/**
+ * Extract name from ID and strip file extension.
+ * ID format: <type>:<name> or <type>:hash:<hash>
+ *
+ * Example:
+ * - 'global-prompt:.cursor/rules/blogging.mdc' -> '.cursor/rules/blogging'
+ * - 'file-rule:typescript.mdc' -> 'typescript'
+ *
+ * @throws Error if ID is malformed (missing name after type prefix)
+ */
+function extractNameFromId(id) {
+    const parts = id.split(':');
+    let name = id;
+    if (parts.length >= 2) {
+        // Skip first part (type) and return rest
+        name = parts.slice(1).join(':');
+    }
+    // Strip file extension (e.g., .mdc, .md, .txt)
+    // This ensures slugified names don't include the original extension
+    const stripped = name.replace(/\.[^/.]+$/, '');
+    // Validate that we have a usable name (not empty after stripping)
+    if (!stripped) {
+        throw new Error(`Invalid ID "${id}": cannot extract a usable name after type prefix`);
+    }
+    return stripped;
+}
+//# sourceMappingURL=emit.js.map

package/dist/emit.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,14 @@
+import { type AgentCustomization } from '@a16njs/models';
+/**
+ * Format an IR item as a markdown file with YAML frontmatter.
+ *
+ * Format: ---\n{yaml}---\n\n{content}\n
+ *
+ * Includes: version, type, relativeDir (if present), type-specific fields
+ * Excludes: sourcePath (omitted from IR format), metadata (not serialized), name (filename is the identifier)
+ *
+ * @param item - The IR item to format
+ * @returns Formatted markdown string with YAML frontmatter
+ */
+export declare function formatIRFile(item: AgentCustomization): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,kBAAkB,EAYxB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAgC7D"}

package/dist/format.js

@@ -0,0 +1,45 @@
+import * as yaml from 'yaml';
+import { isFileRule, isSimpleAgentSkill, isAgentIgnore, } from '@a16njs/models';
+/**
+ * Format an IR item as a markdown file with YAML frontmatter.
+ *
+ * Format: ---\n{yaml}---\n\n{content}\n
+ *
+ * Includes: version, type, relativeDir (if present), type-specific fields
+ * Excludes: sourcePath (omitted from IR format), metadata (not serialized), name (filename is the identifier)
+ *
+ * @param item - The IR item to format
+ * @returns Formatted markdown string with YAML frontmatter
+ */
+export function formatIRFile(item) {
+    // Build frontmatter object based on type
+    const frontmatter = {
+        version: item.version,
+        type: item.type,
+    };
+    // Add relativeDir if present (check undefined, not truthy, to preserve empty strings)
+    if (item.relativeDir !== undefined) {
+        frontmatter.relativeDir = item.relativeDir;
+    }
+    // Add type-specific fields (DO NOT include name, sourcePath, or metadata)
+    if (isFileRule(item)) {
+        frontmatter.globs = item.globs;
+    }
+    else if (isSimpleAgentSkill(item)) {
+        frontmatter.description = item.description;
+    }
+    else if (isAgentIgnore(item)) {
+        frontmatter.patterns = item.patterns;
+    }
+    // ManualPrompt: DO NOT include promptName (derived from relativeDir + filename)
+    // GlobalPrompt: no extra fields
+    // Generate YAML frontmatter with clean, readable output
+    const yamlStr = yaml.stringify(frontmatter, {
+        lineWidth: 0, // Disable line wrapping
+        defaultStringType: 'PLAIN', // Use plain strings when possible
+        defaultKeyType: 'PLAIN', // Use plain keys (no quotes)
+    }).trim();
+    // Format as: ---\n{yaml}---\n\n{content}\n
+    return `---\n${yamlStr}\n---\n\n${item.content}\n`;
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EASL,UAAU,EACV,kBAAkB,EAElB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,IAAwB;IACnD,yCAAyC;IACzC,MAAM,WAAW,GAA4B;QAC3C,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;IAEF,sFAAsF;IACtF,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACnC,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAC7C,CAAC;IAED,0EAA0E;IAC1E,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,WAAW,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACjC,CAAC;SAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAC7C,CAAC;SAAM,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,WAAW,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IACvC,CAAC;IACD,gFAAgF;IAChF,gCAAgC;IAEhC,wDAAwD;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;QAC1C,SAAS,EAAE,CAAC,EAAE,wBAAwB;QACtC,iBAAiB,EAAE,OAAO,EAAE,kCAAkC;QAC9D,cAAc,EAAE,OAAO,EAAE,6BAA6B;KACvD,CAAC,CAAC,IAAI,EAAE,CAAC;IAEV,2CAA2C;IAC3C,OAAO,QAAQ,OAAO,YAAY,IAAI,CAAC,OAAO,IAAI,CAAC;AACrD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @a16njs/plugin-a16n - a16n Intermediate Representation (IR) Plugin
+ *
+ * This plugin enables reading and writing the a16n intermediate representation
+ * to/from disk in a human-readable, git-friendly format with versioned schema support.
+ *
+ * Plugin ID: 'a16n'
+ * CLI usage: --from a16n, --to a16n
+ *
+ * Directory structure: .a16n/<type>/<name>.md
+ */
+import type { A16nPlugin } from '@a16njs/models';
+export { parseIRFile, type ParseIRFileResult } from './parse.js';
+export { formatIRFile } from './format.js';
+export { extractRelativeDir, slugify, getNameWithoutExtension } from './utils.js';
+export { emit } from './emit.js';
+export { discover } from './discover.js';
+/**
+ * The a16n IR plugin.
+ *
+ * Supports reading and writing the a16n intermediate representation format.
+ * Files are stored in `.a16n/` directory with YAML frontmatter containing
+ * version and type metadata.
+ */
+declare const plugin: A16nPlugin;
+export default plugin;
+//# 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;AAEH,OAAO,KAAK,EAAE,UAAU,EAAmC,MAAM,gBAAgB,CAAC;AAMlF,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;GAMG;AACH,QAAA,MAAM,MAAM,EAAE,UA6Bb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,57 @@
+/**
+ * @a16njs/plugin-a16n - a16n Intermediate Representation (IR) Plugin
+ *
+ * This plugin enables reading and writing the a16n intermediate representation
+ * to/from disk in a human-readable, git-friendly format with versioned schema support.
+ *
+ * Plugin ID: 'a16n'
+ * CLI usage: --from a16n, --to a16n
+ *
+ * Directory structure: .a16n/<type>/<name>.md
+ */
+import { CustomizationType } from '@a16njs/models';
+import { emit as emitImpl } from './emit.js';
+import { discover as discoverImpl } from './discover.js';
+// Export utility functions and types
+export { parseIRFile } from './parse.js';
+export { formatIRFile } from './format.js';
+export { extractRelativeDir, slugify, getNameWithoutExtension } from './utils.js';
+export { emit } from './emit.js';
+export { discover } from './discover.js';
+/**
+ * The a16n IR plugin.
+ *
+ * Supports reading and writing the a16n intermediate representation format.
+ * Files are stored in `.a16n/` directory with YAML frontmatter containing
+ * version and type metadata.
+ */
+const plugin = {
+    id: 'a16n',
+    name: 'a16n Intermediate Representation',
+    supports: [
+        CustomizationType.GlobalPrompt,
+        CustomizationType.FileRule,
+        CustomizationType.SimpleAgentSkill,
+        CustomizationType.AgentSkillIO,
+        CustomizationType.AgentIgnore,
+        CustomizationType.ManualPrompt,
+    ],
+    /**
+     * Discover IR files from .a16n/ directory.
+     *
+     * @param root - Project root directory
+     * @returns Discovery result with parsed IR items
+     */
+    discover: discoverImpl,
+    /**
+     * Emit IR files to .a16n/ directory.
+     *
+     * @param models - IR items to emit
+     * @param root - Project root directory
+     * @param options - Emission options
+     * @returns Emit result with written files
+     */
+    emit: emitImpl,
+};
+export default plugin;
+//# 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;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,eAAe,CAAC;AAEzD,qCAAqC;AACrC,OAAO,EAAE,WAAW,EAA0B,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,MAAM,GAAe;IACzB,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,kCAAkC;IACxC,QAAQ,EAAE;QACR,iBAAiB,CAAC,YAAY;QAC9B,iBAAiB,CAAC,QAAQ;QAC1B,iBAAiB,CAAC,gBAAgB;QAClC,iBAAiB,CAAC,YAAY;QAC9B,iBAAiB,CAAC,WAAW;QAC7B,iBAAiB,CAAC,YAAY;KAC/B;IAED;;;;;OAKG;IACH,QAAQ,EAAE,YAAY;IAEtB;;;;;;;OAOG;IACH,IAAI,EAAE,QAAQ;CACf,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,19 @@
+import { type AgentCustomization } from '@a16njs/models';
+/**
+ * Result of parsing an IR file.
+ * Either returns a parsed item or an error message.
+ */
+export interface ParseIRFileResult {
+    item?: AgentCustomization;
+    error?: string;
+}
+/**
+ * Parse an IR file from disk.
+ *
+ * @param filepath - Absolute path to the file
+ * @param filename - Filename (used to derive name)
+ * @param relativePath - Path relative to .a16n/ directory (e.g., ".a16n/global-prompt/coding-standards.md")
+ * @returns ParseIRFileResult with either item or error
+ */
+export declare function parseIRFile(filepath: string, filename: string, relativePath: string): Promise<ParseIRFileResult>;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,kBAAkB,EAUxB,MAAM,gBAAgB,CAAC;AAExB;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiBD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC,CA2H5B"}

package/dist/parse.js

@@ -0,0 +1,122 @@
+import * as fs from 'fs/promises';
+import matter from 'gray-matter';
+import { CustomizationType, createId, parseIRVersion, } from '@a16njs/models';
+/**
+ * Parse an IR file from disk.
+ *
+ * @param filepath - Absolute path to the file
+ * @param filename - Filename (used to derive name)
+ * @param relativePath - Path relative to .a16n/ directory (e.g., ".a16n/global-prompt/coding-standards.md")
+ * @returns ParseIRFileResult with either item or error
+ */
+export async function parseIRFile(filepath, filename, relativePath) {
+    try {
+        // Read file content
+        const content = await fs.readFile(filepath, 'utf-8');
+        // Parse YAML frontmatter
+        let parsed;
+        try {
+            parsed = matter(content);
+        }
+        catch (err) {
+            return { error: `Failed to parse YAML frontmatter: ${err.message}` };
+        }
+        const frontmatter = parsed.data;
+        const body = parsed.content;
+        // Validate required fields
+        if (!frontmatter.version) {
+            return { error: 'Missing required field: version' };
+        }
+        if (!frontmatter.type) {
+            return { error: 'Missing required field: type' };
+        }
+        // Validate version format
+        const versionParsed = parseIRVersion(frontmatter.version);
+        if (!versionParsed) {
+            return { error: `Invalid version format: ${frontmatter.version}` };
+        }
+        // Validate type
+        const type = frontmatter.type;
+        if (!Object.values(CustomizationType).includes(type)) {
+            return { error: `Invalid type: ${frontmatter.type}` };
+        }
+        // Extract name from filename (without extension)
+        const nameWithoutExt = filename.replace(/\.[^.]+$/, '');
+        // Build base IR item
+        // metadata is NOT serialized to IR files (transient only), so initialize as empty
+        const baseItem = {
+            id: createId(type, relativePath),
+            type,
+            version: frontmatter.version,
+            sourcePath: relativePath,
+            content: body,
+            relativeDir: frontmatter.relativeDir,
+            metadata: {},
+        };
+        // Handle type-specific fields
+        switch (type) {
+            case CustomizationType.GlobalPrompt: {
+                const item = {
+                    ...baseItem,
+                    type: CustomizationType.GlobalPrompt,
+                };
+                return { item };
+            }
+            case CustomizationType.FileRule: {
+                if (!frontmatter.globs || !Array.isArray(frontmatter.globs)) {
+                    return { error: 'FileRule requires globs array in frontmatter' };
+                }
+                const item = {
+                    ...baseItem,
+                    type: CustomizationType.FileRule,
+                    globs: frontmatter.globs,
+                };
+                return { item };
+            }
+            case CustomizationType.SimpleAgentSkill: {
+                if (!frontmatter.description || typeof frontmatter.description !== 'string') {
+                    return { error: 'SimpleAgentSkill requires description string in frontmatter' };
+                }
+                const item = {
+                    ...baseItem,
+                    type: CustomizationType.SimpleAgentSkill,
+                    description: frontmatter.description,
+                };
+                return { item };
+            }
+            case CustomizationType.ManualPrompt: {
+                // Derive promptName from relativeDir + filename
+                const promptName = frontmatter.relativeDir
+                    ? `${frontmatter.relativeDir}/${nameWithoutExt}`
+                    : nameWithoutExt;
+                const item = {
+                    ...baseItem,
+                    type: CustomizationType.ManualPrompt,
+                    promptName,
+                };
+                return { item };
+            }
+            case CustomizationType.AgentIgnore: {
+                if (!frontmatter.patterns || !Array.isArray(frontmatter.patterns)) {
+                    return { error: 'AgentIgnore requires patterns array in frontmatter' };
+                }
+                const item = {
+                    ...baseItem,
+                    type: CustomizationType.AgentIgnore,
+                    patterns: frontmatter.patterns,
+                };
+                return { item };
+            }
+            case CustomizationType.AgentSkillIO:
+                // AgentSkillIO uses verbatim AgentSkills.io format (NO IR frontmatter)
+                // This should be handled by readAgentSkillIO from @a16njs/models
+                return { error: 'AgentSkillIO should be parsed using readAgentSkillIO()' };
+            default:
+                return { error: `Unsupported type: ${type}` };
+        }
+    }
+    catch (err) {
+        return { error: `Failed to read file: ${err.message}` };
+    }
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Extract relative directory from a full path relative to base directory.
+ *
+ * Example:
+ * - extractRelativeDir('.a16n/global-prompt/coding-standards.md', '.a16n') -> undefined
+ * - extractRelativeDir('.a16n/global-prompt/shared/company/standards.md', '.a16n/global-prompt') -> 'shared/company'
+ *
+ * @param fullPath - Full path to the file
+ * @param baseDir - Base directory to extract relative path from
+ * @returns Relative directory or undefined if file is directly in baseDir
+ */
+export declare function extractRelativeDir(fullPath: string, baseDir: string): string | undefined;
+/**
+ * Slugify a name for use as a filename.
+ * Converts to lowercase, replaces spaces and special chars with hyphens.
+ *
+ * @param name - Name to slugify
+ * @returns Slugified name safe for filesystem
+ */
+export declare function slugify(name: string): string;
+/**
+ * Get filename without extension.
+ * Uses path.parse().name to properly handle dotfiles (e.g., ".env" -> ".env").
+ *
+ * @param filename - Filename with extension
+ * @returns Filename without extension
+ */
+export declare function getNameWithoutExtension(filename: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBxF;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/utils.js

@@ -0,0 +1,51 @@
+import * as path from 'path';
+/**
+ * Extract relative directory from a full path relative to base directory.
+ *
+ * Example:
+ * - extractRelativeDir('.a16n/global-prompt/coding-standards.md', '.a16n') -> undefined
+ * - extractRelativeDir('.a16n/global-prompt/shared/company/standards.md', '.a16n/global-prompt') -> 'shared/company'
+ *
+ * @param fullPath - Full path to the file
+ * @param baseDir - Base directory to extract relative path from
+ * @returns Relative directory or undefined if file is directly in baseDir
+ */
+export function extractRelativeDir(fullPath, baseDir) {
+    const normalized = path.normalize(fullPath);
+    const normalizedBase = path.normalize(baseDir);
+    // Get the directory containing the file
+    const fileDir = path.dirname(normalized);
+    // Get relative path from base to file directory
+    const relative = path.relative(normalizedBase, fileDir);
+    // If relative path is empty or goes up directories (..), return undefined
+    if (!relative || relative === '.' || relative.startsWith('..')) {
+        return undefined;
+    }
+    // Normalize to POSIX-style forward slashes for cross-platform consistency
+    return relative.split(path.sep).join('/');
+}
+/**
+ * Slugify a name for use as a filename.
+ * Converts to lowercase, replaces spaces and special chars with hyphens.
+ *
+ * @param name - Name to slugify
+ * @returns Slugified name safe for filesystem
+ */
+export function slugify(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-') // Replace non-alphanumeric with hyphens
+        .replace(/^-+|-+$/g, '') // Trim leading/trailing hyphens
+        || 'unnamed'; // Fallback if empty
+}
+/**
+ * Get filename without extension.
+ * Uses path.parse().name to properly handle dotfiles (e.g., ".env" -> ".env").
+ *
+ * @param filename - Filename with extension
+ * @returns Filename without extension
+ */
+export function getNameWithoutExtension(filename) {
+    return path.parse(filename).name;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,OAAe;IAClE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAE/C,wCAAwC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzC,gDAAgD;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAExD,0EAA0E;IAC1E,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,0EAA0E;IAC1E,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAE,wCAAwC;SACrE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAM,gCAAgC;WAC3D,SAAS,CAAC,CAAE,oBAAoB;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a16njs/plugin-a16n",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "a16n Intermediate Representation (IR) plugin for a16n",
   "license": "AGPL-3.0",
   "author": "Texarkanine",
@@ -33,7 +33,8 @@
   ],
   "dependencies": {
     "gray-matter": "^4.0.3",
-    "@a16njs/models": "0.6.0"
+    "yaml": "^2.8.2",
+    "@a16njs/models": "0.7.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",