@clawmasons/shared 0.1.0

package/dist/role/package-reader.js

@@ -0,0 +1,223 @@
+/**
+ * Package Reader — reads an NPM role package and produces a Role object.
+ *
+ * Steps:
+ * 1. Read package.json and verify chapter.type === "role"
+ * 2. Read the bundled ROLE.md from the package directory
+ * 3. Parse frontmatter and body (reuses parseFrontmatter from parser.ts)
+ * 4. Normalize fields using dialect mapping if chapter.dialect is specified,
+ *    otherwise use generic ROLE_TYPES field names directly
+ * 5. Resolve all paths relative to the package directory
+ * 6. Set source.type = 'package' and source.packageName
+ * 7. Validate through roleSchema
+ */
+import { readFile } from "node:fs/promises";
+import { join, basename, resolve } from "node:path";
+import { roleSchema } from "../schemas/role-types.js";
+import { parseFrontmatter } from "./parser.js";
+import { scanBundledResources } from "./resource-scanner.js";
+import { getDialect } from "./dialect-registry.js";
+/**
+ * Error thrown when a role NPM package cannot be read.
+ */
+export class PackageReadError extends Error {
+    packagePath;
+    constructor(message, packagePath) {
+        super(`${message} (at ${packagePath})`);
+        this.packagePath = packagePath;
+        this.name = "PackageReadError";
+    }
+}
+/**
+ * Generic field mapping — packaged roles use ROLE_TYPES generic names directly.
+ */
+const GENERIC_FIELD_MAPPING = {
+    name: "generic",
+    directory: "",
+    fieldMapping: {
+        tasks: "tasks",
+        apps: "apps",
+        skills: "skills",
+    },
+};
+/**
+ * Read an NPM role package and produce a validated Role object.
+ *
+ * @param packagePath - Absolute path to the package directory (e.g., node_modules/@acme/role-create-prd)
+ * @returns Validated Role with source.type = 'package'
+ * @throws PackageReadError if the package is missing required files or has wrong chapter.type
+ */
+export async function readPackagedRole(packagePath) {
+    // 1. Read and validate package.json
+    const pkgJson = await readPackageJson(packagePath);
+    if (!pkgJson.chapter || pkgJson.chapter.type !== "role") {
+        throw new PackageReadError(`Package "${pkgJson.name}" does not have chapter.type = "role" (got: ${pkgJson.chapter?.type ?? "undefined"})`, packagePath);
+    }
+    // 2. Read ROLE.md
+    const roleMdPath = join(packagePath, "ROLE.md");
+    let roleMdContent;
+    try {
+        roleMdContent = await readFile(roleMdPath, "utf-8");
+    }
+    catch {
+        throw new PackageReadError(`Package "${pkgJson.name}" is missing ROLE.md`, packagePath);
+    }
+    // 3. Parse frontmatter and body
+    const { frontmatter, body } = parseFrontmatter(roleMdContent, roleMdPath);
+    // 4. Determine field mapping
+    const dialect = resolveDialect(pkgJson, packagePath);
+    // 5. Extract metadata
+    const roleName = frontmatter.name ?? pkgJson.name;
+    const metadata = {
+        name: roleName,
+        description: frontmatter.description,
+        version: frontmatter.version ?? pkgJson.version,
+        scope: frontmatter.scope,
+    };
+    if (!metadata.description) {
+        throw new PackageReadError(`Package "${pkgJson.name}" ROLE.md is missing required field: description`, packagePath);
+    }
+    // 6. Normalize fields using dialect mapping
+    const tasks = normalizeField(frontmatter, dialect.fieldMapping.tasks);
+    const apps = normalizeApps(frontmatter, dialect.fieldMapping.apps);
+    const skills = normalizeSkills(frontmatter, dialect.fieldMapping.skills, packagePath);
+    // 7. Container requirements (pass-through)
+    const container = frontmatter.container ?? {};
+    // 8. Governance (assembled from top-level fields)
+    const governance = {};
+    if (frontmatter.risk !== undefined)
+        governance.risk = frontmatter.risk;
+    if (frontmatter.credentials !== undefined)
+        governance.credentials = frontmatter.credentials;
+    if (frontmatter.constraints !== undefined)
+        governance.constraints = frontmatter.constraints;
+    // 9. Scan bundled resources
+    const resources = await scanBundledResources(packagePath);
+    // 10. Build and validate
+    const roleData = {
+        metadata,
+        instructions: body,
+        type: frontmatter.type,
+        tasks,
+        apps,
+        skills,
+        container,
+        governance,
+        resources,
+        source: {
+            type: "package",
+            packageName: pkgJson.name,
+        },
+    };
+    return roleSchema.parse(roleData);
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Read and parse package.json from a package directory.
+ */
+async function readPackageJson(packagePath) {
+    const pkgJsonPath = join(packagePath, "package.json");
+    let raw;
+    try {
+        raw = await readFile(pkgJsonPath, "utf-8");
+    }
+    catch {
+        throw new PackageReadError("Missing package.json", packagePath);
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed.name) {
+            throw new PackageReadError("package.json is missing required field: name", packagePath);
+        }
+        return parsed;
+    }
+    catch (err) {
+        if (err instanceof PackageReadError)
+            throw err;
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new PackageReadError(`Invalid package.json: ${msg}`, packagePath);
+    }
+}
+/**
+ * Resolve the dialect to use for field normalization.
+ * If chapter.dialect is specified, use that dialect's mapping.
+ * Otherwise, use generic ROLE_TYPES field names.
+ */
+function resolveDialect(pkgJson, packagePath) {
+    const dialectName = pkgJson.chapter?.dialect;
+    if (!dialectName)
+        return GENERIC_FIELD_MAPPING;
+    const dialect = getDialect(dialectName);
+    if (!dialect) {
+        throw new PackageReadError(`Unknown dialect "${dialectName}" specified in chapter.dialect`, packagePath);
+    }
+    return dialect;
+}
+/**
+ * Normalize a simple list field (tasks).
+ */
+function normalizeField(frontmatter, fieldName) {
+    const raw = frontmatter[fieldName];
+    if (!raw)
+        return [];
+    if (!Array.isArray(raw)) {
+        return [{ name: String(raw) }];
+    }
+    return raw.map((item) => {
+        if (typeof item === "string") {
+            return { name: item };
+        }
+        if (typeof item === "object" && item !== null && "name" in item) {
+            return item;
+        }
+        return { name: String(item) };
+    });
+}
+/**
+ * Normalize apps field.
+ */
+function normalizeApps(frontmatter, fieldName) {
+    const raw = frontmatter[fieldName];
+    if (!raw)
+        return [];
+    if (!Array.isArray(raw))
+        return [];
+    return raw.map((item) => {
+        if (typeof item === "object" && item !== null) {
+            return item;
+        }
+        return { name: String(item) };
+    });
+}
+/**
+ * Normalize skills field with path resolution relative to package directory.
+ */
+function normalizeSkills(frontmatter, fieldName, packageDir) {
+    const raw = frontmatter[fieldName];
+    if (!raw)
+        return [];
+    if (!Array.isArray(raw))
+        return [];
+    return raw.map((item) => {
+        if (typeof item === "string") {
+            // Local path reference — resolve relative to package directory
+            if (item.startsWith("./") || item.startsWith("../")) {
+                const resolvedPath = resolve(packageDir, item);
+                const name = basename(resolvedPath);
+                return { name, ref: resolvedPath };
+            }
+            // Package reference — extract short name
+            const name = item.startsWith("@")
+                ? item.split("/").pop() ?? item
+                : item;
+            return { name, ref: item };
+        }
+        if (typeof item === "object" && item !== null && "name" in item) {
+            return item;
+        }
+        return { name: String(item) };
+    });
+}
+//# sourceMappingURL=package-reader.js.map

package/dist/role/package-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-reader.js","sourceRoot":"","sources":["../../src/role/package-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAqB,MAAM,uBAAuB,CAAC;AAEtE;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGvB;IAFlB,YACE,OAAe,EACC,WAAmB;QAEnC,KAAK,CAAC,GAAG,OAAO,QAAQ,WAAW,GAAG,CAAC,CAAC;QAFxB,gBAAW,GAAX,WAAW,CAAQ;QAGnC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAcD;;GAEG;AACH,MAAM,qBAAqB,GAAiB;IAC1C,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,EAAE;IACb,YAAY,EAAE;QACZ,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,QAAQ;KACjB;CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB;IACxD,oCAAoC;IACpC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;IAEnD,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACxD,MAAM,IAAI,gBAAgB,CACxB,YAAY,OAAO,CAAC,IAAI,+CAA+C,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,WAAW,GAAG,EAC9G,WAAW,CACZ,CAAC;IACJ,CAAC;IAED,kBAAkB;IAClB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAChD,IAAI,aAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,aAAa,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,gBAAgB,CACxB,YAAY,OAAO,CAAC,IAAI,sBAAsB,EAC9C,WAAW,CACZ,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAE1E,6BAA6B;IAC7B,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAErD,sBAAsB;IACtB,MAAM,QAAQ,GACX,WAAW,CAAC,IAA2B,IAAI,OAAO,CAAC,IAAI,CAAC;IAC3D,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,WAAW,CAAC,WAAiC;QAC1D,OAAO,EACJ,WAAW,CAAC,OAA8B,IAAI,OAAO,CAAC,OAAO;QAChE,KAAK,EAAE,WAAW,CAAC,KAA2B;KAC/C,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,IAAI,gBAAgB,CACxB,YAAY,OAAO,CAAC,IAAI,kDAAkD,EAC1E,WAAW,CACZ,CAAC;IACJ,CAAC;IAED,4CAA4C;IAC5C,MAAM,KAAK,GAAG,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,eAAe,CAC5B,WAAW,EACX,OAAO,CAAC,YAAY,CAAC,MAAM,EAC3B,WAAW,CACZ,CAAC;IAEF,2CAA2C;IAC3C,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,IAAI,EAAE,CAAC;IAE9C,kDAAkD;IAClD,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,IAAI,WAAW,CAAC,IAAI,KAAK,SAAS;QAAE,UAAU,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;IACvE,IAAI,WAAW,CAAC,WAAW,KAAK,SAAS;QACvC,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC;IACnD,IAAI,WAAW,CAAC,WAAW,KAAK,SAAS;QACvC,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC;IAEnD,4BAA4B;IAC5B,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAE1D,yBAAyB;IACzB,MAAM,QAAQ,GAAG;QACf,QAAQ;QACR,YAAY,EAAE,IAAI;QAClB,IAAI,EAAE,WAAW,CAAC,IAA0B;QAC5C,KAAK;QACL,IAAI;QACJ,MAAM;QACN,SAAS;QACT,UAAU;QACV,SAAS;QACT,MAAM,EAAE;YACN,IAAI,EAAE,SAAkB;YACxB,WAAW,EAAE,OAAO,CAAC,IAAI;SAC1B;KACF,CAAC;IAEF,OAAO,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;GAEG;AACH,KAAK,UAAU,eAAe,CAAC,WAAmB;IAChD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACtD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,gBAAgB,CACxB,sBAAsB,EACtB,WAAW,CACZ,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,gBAAgB,CACxB,8CAA8C,EAC9C,WAAW,CACZ,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,gBAAgB;YAAE,MAAM,GAAG,CAAC;QAC/C,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,gBAAgB,CACxB,yBAAyB,GAAG,EAAE,EAC9B,WAAW,CACZ,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CACrB,OAAoB,EACpB,WAAmB;IAEnB,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC;IAC7C,IAAI,CAAC,WAAW;QAAE,OAAO,qBAAqB,CAAC;IAE/C,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,gBAAgB,CACxB,oBAAoB,WAAW,gCAAgC,EAC/D,WAAW,CACZ,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CACrB,WAAoC,EACpC,SAAiB;IAEjB,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEpB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAa,EAAE,EAAE;QAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YAChE,OAAO,IAA+B,CAAC;QACzC,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,WAAoC,EACpC,SAAiB;IAEjB,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAa,EAAE,EAAE;QAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO,IAA+B,CAAC;QACzC,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CACtB,WAAoC,EACpC,SAAiB,EACjB,UAAkB;IAElB,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAa,EAAE,EAAE;QAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,+DAA+D;YAC/D,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpD,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;gBACpC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;YACrC,CAAC;YACD,yCAAyC;YACzC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAC/B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI;gBAC/B,CAAC,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QAC7B,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YAChE,OAAO,IAA+B,CAAC;QACzC,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/role/parser.d.ts

@@ -0,0 +1,45 @@
+/**
+ * ROLE.md Parser — reads a local ROLE.md file and produces a Role object.
+ *
+ * Steps:
+ * 1. Detect the agent dialect from the parent directory structure
+ * 2. Parse YAML frontmatter and extract markdown body as instructions
+ * 3. Normalize agent-specific field names to generic ROLE_TYPES names
+ * 4. Resolve bundled resource paths
+ * 5. Resolve dependency references
+ * 6. Validate through roleSchema
+ */
+import type { Role } from "../types/role.js";
+import { type DialectEntry } from "./dialect-registry.js";
+/**
+ * Parse error thrown when ROLE.md is malformed.
+ */
+export declare class RoleParseError extends Error {
+    readonly rolePath: string;
+    constructor(message: string, rolePath: string);
+}
+/**
+ * Read a local ROLE.md file and produce a validated Role object.
+ *
+ * @param rolePath - Absolute path to the ROLE.md file
+ * @returns Validated Role
+ * @throws RoleParseError if the file is malformed or dialect cannot be detected
+ */
+export declare function readMaterializedRole(rolePath: string): Promise<Role>;
+interface ParsedFrontmatter {
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+/**
+ * Parse YAML frontmatter delimited by `---` markers.
+ */
+export declare function parseFrontmatter(content: string, rolePath: string): ParsedFrontmatter;
+/**
+ * Detect the agent dialect from the role's directory structure.
+ *
+ * Expected pattern: `<project>/.<agent>/roles/<role-name>/`
+ * We walk up from the role directory looking for a known agent directory.
+ */
+export declare function detectDialect(roleDir: string, rolePath: string): DialectEntry;
+export {};
+//# sourceMappingURL=parser.d.ts.map

package/dist/role/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/role/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAG/B;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;aACM,QAAQ,EAAE,MAAM;gBAAjD,OAAO,EAAE,MAAM,EAAkB,QAAQ,EAAE,MAAM;CAI9D;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkE1E;AAMD,UAAU,iBAAiB;IACzB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAyCrF;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAiC7E"}

package/dist/role/parser.js

@@ -0,0 +1,241 @@
+/**
+ * ROLE.md Parser — reads a local ROLE.md file and produces a Role object.
+ *
+ * Steps:
+ * 1. Detect the agent dialect from the parent directory structure
+ * 2. Parse YAML frontmatter and extract markdown body as instructions
+ * 3. Normalize agent-specific field names to generic ROLE_TYPES names
+ * 4. Resolve bundled resource paths
+ * 5. Resolve dependency references
+ * 6. Validate through roleSchema
+ */
+import { readFile } from "node:fs/promises";
+import { dirname, basename, resolve } from "node:path";
+import { load as yamlLoad } from "js-yaml";
+import { roleSchema } from "../schemas/role-types.js";
+import { getDialectByDirectory, getKnownDirectories, } from "./dialect-registry.js";
+import { scanBundledResources } from "./resource-scanner.js";
+/**
+ * Parse error thrown when ROLE.md is malformed.
+ */
+export class RoleParseError extends Error {
+    rolePath;
+    constructor(message, rolePath) {
+        super(`${message} (at ${rolePath})`);
+        this.rolePath = rolePath;
+        this.name = "RoleParseError";
+    }
+}
+/**
+ * Read a local ROLE.md file and produce a validated Role object.
+ *
+ * @param rolePath - Absolute path to the ROLE.md file
+ * @returns Validated Role
+ * @throws RoleParseError if the file is malformed or dialect cannot be detected
+ */
+export async function readMaterializedRole(rolePath) {
+    // Read the file
+    const content = await readFile(rolePath, "utf-8");
+    // Parse frontmatter and body
+    const { frontmatter, body } = parseFrontmatter(content, rolePath);
+    // Detect dialect from directory structure
+    const roleDir = dirname(rolePath);
+    const dialect = detectDialect(roleDir, rolePath);
+    // Extract metadata
+    const roleName = frontmatter.name ?? basename(roleDir);
+    const metadata = {
+        name: roleName,
+        description: frontmatter.description,
+        version: frontmatter.version,
+        scope: frontmatter.scope,
+    };
+    if (!metadata.description) {
+        throw new RoleParseError("Missing required field: description", rolePath);
+    }
+    // Normalize fields using dialect mapping
+    const tasks = normalizeTasks(frontmatter, dialect);
+    const apps = normalizeApps(frontmatter, dialect);
+    const skills = normalizeSkills(frontmatter, dialect, roleDir);
+    // Container requirements (pass-through, no normalization needed)
+    const container = frontmatter.container ?? {};
+    // Governance (assembled from top-level fields)
+    const governance = {};
+    if (frontmatter.risk !== undefined)
+        governance.risk = frontmatter.risk;
+    if (frontmatter.credentials !== undefined)
+        governance.credentials = frontmatter.credentials;
+    if (frontmatter.constraints !== undefined)
+        governance.constraints = frontmatter.constraints;
+    // Scan bundled resources
+    const resources = await scanBundledResources(roleDir);
+    // Extract sources (canonical mason field)
+    const sources = Array.isArray(frontmatter.sources)
+        ? frontmatter.sources
+        : [];
+    // Build the role object and validate through Zod
+    const roleData = {
+        metadata,
+        instructions: body,
+        type: frontmatter.type,
+        tasks,
+        apps,
+        skills,
+        sources,
+        container,
+        governance,
+        resources,
+        source: {
+            type: "local",
+            agentDialect: dialect.name,
+            path: roleDir,
+        },
+    };
+    return roleSchema.parse(roleData);
+}
+/**
+ * Parse YAML frontmatter delimited by `---` markers.
+ */
+export function parseFrontmatter(content, rolePath) {
+    const trimmed = content.trimStart();
+    if (!trimmed.startsWith("---")) {
+        throw new RoleParseError("ROLE.md must start with YAML frontmatter (---)", rolePath);
+    }
+    // Find the closing ---
+    const endIndex = trimmed.indexOf("\n---", 3);
+    if (endIndex === -1) {
+        throw new RoleParseError("ROLE.md frontmatter is not closed (missing closing ---)", rolePath);
+    }
+    const yamlStr = trimmed.substring(3, endIndex).trim();
+    const body = trimmed.substring(endIndex + 4).trim(); // skip \n---
+    let frontmatter;
+    try {
+        frontmatter = yamlLoad(yamlStr);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new RoleParseError(`Invalid YAML in frontmatter: ${msg}`, rolePath);
+    }
+    if (typeof frontmatter !== "object" || frontmatter === null || Array.isArray(frontmatter)) {
+        throw new RoleParseError("Frontmatter must be a YAML mapping (key-value pairs)", rolePath);
+    }
+    return {
+        frontmatter: frontmatter,
+        body,
+    };
+}
+// ---------------------------------------------------------------------------
+// Dialect detection
+// ---------------------------------------------------------------------------
+/**
+ * Detect the agent dialect from the role's directory structure.
+ *
+ * Expected pattern: `<project>/.<agent>/roles/<role-name>/`
+ * We walk up from the role directory looking for a known agent directory.
+ */
+export function detectDialect(roleDir, rolePath) {
+    // roleDir = /path/to/project/.claude/roles/my-role
+    // We expect the parent of "roles" to be the agent directory
+    const rolesParent = dirname(roleDir); // .../roles
+    const agentDir = dirname(rolesParent); // .../.claude
+    // Check that we're inside a "roles" directory
+    if (basename(rolesParent) !== "roles") {
+        throw new RoleParseError(`ROLE.md must be inside a roles/ directory (expected <project>/.<agent>/roles/<role-name>/ROLE.md)`, rolePath);
+    }
+    // Get the agent directory name (e.g., ".claude" → "claude")
+    const agentDirName = basename(agentDir);
+    if (!agentDirName.startsWith(".")) {
+        throw new RoleParseError(`Agent directory must start with a dot (got "${agentDirName}")`, rolePath);
+    }
+    const directoryKey = agentDirName.substring(1); // strip the dot
+    const dialect = getDialectByDirectory(directoryKey);
+    if (!dialect) {
+        throw new RoleParseError(`Unknown agent dialect for directory "${agentDirName}". Known directories: ${getKnownDirsForError()}`, rolePath);
+    }
+    return dialect;
+}
+function getKnownDirsForError() {
+    return getKnownDirectories()
+        .map((d) => `.${d}/`)
+        .join(", ");
+}
+// ---------------------------------------------------------------------------
+// Field normalization
+// ---------------------------------------------------------------------------
+/**
+ * Normalize the dialect-specific tasks field.
+ * Claude: commands, Codex: instructions, Aider: conventions
+ * Returns raw objects — Zod validates and applies defaults.
+ */
+function normalizeTasks(frontmatter, dialect) {
+    const fieldName = dialect.fieldMapping.tasks;
+    const raw = frontmatter[fieldName];
+    if (!raw)
+        return [];
+    if (!Array.isArray(raw)) {
+        return [{ name: String(raw) }];
+    }
+    return raw.map((item) => {
+        if (typeof item === "string") {
+            return { name: item };
+        }
+        if (typeof item === "object" && item !== null && "name" in item) {
+            return item;
+        }
+        return { name: String(item) };
+    });
+}
+/**
+ * Normalize the dialect-specific apps field.
+ * All dialects currently use mcp_servers.
+ * Returns raw objects — Zod validates and applies defaults.
+ */
+function normalizeApps(frontmatter, dialect) {
+    const fieldName = dialect.fieldMapping.apps;
+    const raw = frontmatter[fieldName];
+    if (!raw)
+        return [];
+    if (!Array.isArray(raw))
+        return [];
+    return raw.map((item) => {
+        if (typeof item === "object" && item !== null) {
+            return item;
+        }
+        // String shorthand — just a server name
+        return { name: String(item) };
+    });
+}
+/**
+ * Normalize the dialect-specific skills field.
+ * All dialects currently use "skills".
+ * Returns raw objects — Zod validates and applies defaults.
+ */
+function normalizeSkills(frontmatter, dialect, roleDir) {
+    const fieldName = dialect.fieldMapping.skills;
+    const raw = frontmatter[fieldName];
+    if (!raw)
+        return [];
+    if (!Array.isArray(raw))
+        return [];
+    // Find the project root (parent of the agent directory)
+    const projectRoot = resolve(roleDir, "..", "..", "..");
+    return raw.map((item) => {
+        if (typeof item === "string") {
+            // Local path reference — resolve relative to project root
+            if (item.startsWith("./") || item.startsWith("../")) {
+                const resolvedPath = resolve(projectRoot, item);
+                const name = basename(resolvedPath);
+                return { name, ref: resolvedPath };
+            }
+            // Package reference — extract short name
+            const name = item.startsWith("@")
+                ? item.split("/").pop() ?? item
+                : item;
+            return { name, ref: item };
+        }
+        if (typeof item === "object" && item !== null && "name" in item) {
+            return item;
+        }
+        return { name: String(item) };
+    });
+}
+//# sourceMappingURL=parser.js.map

package/dist/role/parser.js.map

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

package/dist/role/resource-scanner.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Resource Scanner — discover bundled resources in a role directory.
+ *
+ * Recursively walks the role directory and returns ResourceFile entries for
+ * all files except ROLE.md itself. Only paths are stored — file content is
+ * never loaded into memory (per PRD §5.1).
+ */
+import type { ResourceFile } from "../types/role.js";
+/**
+ * Recursively scan a role directory for bundled resources.
+ *
+ * @param roleDir - Absolute path to the role directory (contains ROLE.md)
+ * @returns Array of ResourceFile entries with relative and absolute paths
+ */
+export declare function scanBundledResources(roleDir: string): Promise<ResourceFile[]>;
+//# sourceMappingURL=resource-scanner.d.ts.map

package/dist/role/resource-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-scanner.d.ts","sourceRoot":"","sources":["../../src/role/resource-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAInF"}

package/dist/role/resource-scanner.js

@@ -0,0 +1,43 @@
+/**
+ * Resource Scanner — discover bundled resources in a role directory.
+ *
+ * Recursively walks the role directory and returns ResourceFile entries for
+ * all files except ROLE.md itself. Only paths are stored — file content is
+ * never loaded into memory (per PRD §5.1).
+ */
+import { readdir, stat } from "node:fs/promises";
+import { join, relative } from "node:path";
+/**
+ * Recursively scan a role directory for bundled resources.
+ *
+ * @param roleDir - Absolute path to the role directory (contains ROLE.md)
+ * @returns Array of ResourceFile entries with relative and absolute paths
+ */
+export async function scanBundledResources(roleDir) {
+    const resources = [];
+    await walkDirectory(roleDir, roleDir, resources);
+    return resources;
+}
+async function walkDirectory(baseDir, currentDir, results) {
+    const entries = await readdir(currentDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const absolutePath = join(currentDir, entry.name);
+        const relativePath = relative(baseDir, absolutePath);
+        if (entry.isDirectory()) {
+            await walkDirectory(baseDir, absolutePath, results);
+        }
+        else if (entry.isFile()) {
+            // Skip ROLE.md itself
+            if (entry.name === "ROLE.md" && currentDir === baseDir) {
+                continue;
+            }
+            const fileStat = await stat(absolutePath);
+            results.push({
+                relativePath,
+                absolutePath,
+                permissions: fileStat.mode,
+            });
+        }
+    }
+}
+//# sourceMappingURL=resource-scanner.js.map

package/dist/role/resource-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-scanner.js","sourceRoot":"","sources":["../../src/role/resource-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG3C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAe;IACxD,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,MAAM,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,OAAe,EACf,UAAkB,EAClB,OAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAErD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QACtD,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,sBAAsB;YACtB,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;gBACvD,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC;gBACX,YAAY;gBACZ,YAAY;gBACZ,WAAW,EAAE,QAAQ,CAAC,IAAI;aAC3B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/schemas/index.d.ts

@@ -0,0 +1,7 @@
+export { appChapterFieldSchema, type AppChapterField } from "./app.js";
+export { skillChapterFieldSchema, type SkillChapterField } from "./skill.js";
+export { taskChapterFieldSchema, type TaskChapterField } from "./task.js";
+export { roleChapterFieldSchema, type RoleChapterField } from "./role.js";
+export { parseChapterField, type ChapterField } from "./chapter-field.js";
+export { toolPermissionsSchema, roleMetadataSchema, taskRefSchema, skillRefSchema, appConfigSchema, mountConfigSchema, containerRequirementsSchema, governanceConfigSchema, resourceFileSchema, roleSourceSchema, roleSchema, } from "./role-types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,GACX,MAAM,iBAAiB,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,8 @@
+export { appChapterFieldSchema } from "./app.js";
+export { skillChapterFieldSchema } from "./skill.js";
+export { taskChapterFieldSchema } from "./task.js";
+export { roleChapterFieldSchema } from "./role.js";
+export { parseChapterField } from "./chapter-field.js";
+// ROLE_TYPES schemas
+export { toolPermissionsSchema, roleMetadataSchema, taskRefSchema, skillRefSchema, appConfigSchema, mountConfigSchema, containerRequirementsSchema, governanceConfigSchema, resourceFileSchema, roleSourceSchema, roleSchema, } from "./role-types.js";
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAwB,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAA0B,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAyB,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAyB,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAqB,MAAM,oBAAoB,CAAC;AAE1E,qBAAqB;AACrB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,GACX,MAAM,iBAAiB,CAAC"}