@a16njs/plugin-a16n 0.2.0 → 0.4.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
 
@@ -97,22 +97,6 @@ Use this ID with CLI commands:
 - `--from a16n`: Read from `.a16n/` directory
 - `--to a16n`: Write to `.a16n/` directory
 
-## Development Status
-
-**Current Version**: 0.1.0 (Phase 9 in progress)
-
-- ✅ 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)
-- 🚧 M7: Integration Testing & Documentation (upcoming)
-
-## License
-
-AGPL-3.0
-
 ## Links
 
 - [Homepage](https://texarkanine.github.io/a16n/plugin-a16n)

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/index.d.ts

@@ -14,6 +14,7 @@ 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.
  *

package/dist/index.d.ts.map

@@ -1 +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;AAKlF,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;AAEjC;;;;;;GAMG;AACH,QAAA,MAAM,MAAM,EAAE,UAmCb,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"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

@@ -11,11 +11,13 @@
  */
 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.
  *
@@ -40,13 +42,7 @@ const plugin = {
      * @param root - Project root directory
      * @returns Discovery result with parsed IR items
      */
-    async discover(root) {
-        // TODO: Implement in Milestone 5
-        return {
-            items: [],
-            warnings: [],
-        };
-    },
+    discover: discoverImpl,
     /**
      * Emit IR files to .a16n/ directory.
      *

package/dist/index.js.map

@@ -1 +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;AAE7C,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;AAEjC;;;;;;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,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,iCAAiC;QACjC,OAAO;YACL,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,EAAE,QAAQ;CACf,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"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/package.json

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