@clawmasons/mason 0.1.1 → 0.1.2

package/dist/cli/commands/build.js

@@ -0,0 +1,107 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { discoverRoles, adaptRoleToResolvedAgent, getAppShortName, } from "@clawmasons/shared";
+import { generateRoleDockerBuildDir } from "../../materializer/docker-generator.js";
+import { ensureProxyDependencies, synthesizeRolePackages, } from "../../materializer/proxy-dependencies.js";
+import { inferAgentType, resolveAgentType } from "./run-agent.js";
+import { ensureGitignoreEntry } from "../../runtime/gitignore.js";
+/**
+ * Build Docker artifacts for a single role.
+ */
+function buildRole(role, agentType, projectDir) {
+    const roleName = getAppShortName(role.metadata.name);
+    const result = generateRoleDockerBuildDir({
+        role,
+        agentType,
+        projectDir,
+        agentName: roleName,
+    });
+    return { roleName, buildDir: result.buildDir };
+}
+/**
+ * Run the build for one or all roles in the workspace.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @param roleName - Optional role name to build (builds all if omitted)
+ * @param agentTypeOverride - Optional agent type override (e.g., "mcp-agent")
+ */
+export async function runBuild(projectDir, roleName, agentTypeOverride) {
+    // 1. Discover roles
+    const roles = await discoverRoles(projectDir);
+    if (roles.length === 0) {
+        console.error("\n  No roles found in workspace.\n");
+        process.exit(1);
+        return;
+    }
+    // 2. Filter to requested role(s)
+    let targetRoles = roles;
+    if (roleName) {
+        const match = roles.find((r) => getAppShortName(r.metadata.name) === roleName || r.metadata.name === roleName);
+        if (!match) {
+            const available = roles.map((r) => getAppShortName(r.metadata.name)).join(", ");
+            console.error(`\n  Role "${roleName}" not found. Available: ${available}\n`);
+            process.exit(1);
+            return;
+        }
+        targetRoles = [match];
+    }
+    // 3. Validate roles via adapter round-trip
+    for (const role of targetRoles) {
+        const agentType = agentTypeOverride ?? inferAgentType(role);
+        try {
+            adaptRoleToResolvedAgent(role, agentType);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`\n  Validation failed for "${getAppShortName(role.metadata.name)}": ${msg}\n`);
+            process.exit(1);
+            return;
+        }
+    }
+    // 4. Ensure .mason/.gitignore
+    const masonDir = path.join(projectDir, ".mason");
+    fs.mkdirSync(masonDir, { recursive: true });
+    const gitignorePath = path.join(masonDir, ".gitignore");
+    if (!fs.existsSync(gitignorePath) || !fs.readFileSync(gitignorePath, "utf-8").includes("docker/")) {
+        fs.appendFileSync(gitignorePath, "docker/\nsessions/\n");
+    }
+    ensureGitignoreEntry(projectDir, ".mason");
+    // 5. Build Docker artifacts for each role
+    console.log(`\n  Building ${targetRoles.length} role(s)...\n`);
+    for (const role of targetRoles) {
+        const agentType = agentTypeOverride ?? inferAgentType(role);
+        const { roleName: name } = buildRole(role, agentType, projectDir);
+        console.log(`  ✓ ${name} (${agentType}) → .mason/docker/${name}/`);
+    }
+    // 6. Populate shared proxy dependencies (node_modules + package.json)
+    const dockerDir = path.join(projectDir, ".mason", "docker");
+    ensureProxyDependencies(dockerDir, projectDir);
+    // 7. Synthesize inline app/role packages for roles with mcp_servers
+    for (const role of targetRoles) {
+        synthesizeRolePackages(role, dockerDir);
+    }
+    console.log(`\n  Build complete.\n`);
+}
+/**
+ * Register the `build` subcommand under `chapter`.
+ */
+export function registerBuildCommand(program) {
+    program
+        .command("build")
+        .description("Build Docker artifacts for roles in the workspace")
+        .argument("[role]", "Role name to build (builds all if omitted)")
+        .option("--agent-type <type>", "Override agent type (e.g., mcp-agent, claude-code-agent)")
+        .action(async (role, options) => {
+        let agentType;
+        if (options.agentType) {
+            agentType = resolveAgentType(options.agentType);
+            if (!agentType) {
+                console.error(`\n  Unknown agent type "${options.agentType}".\n`);
+                process.exit(1);
+                return;
+            }
+        }
+        await runBuild(process.cwd(), role, agentType);
+    });
+}
+//# sourceMappingURL=build.js.map

package/dist/cli/commands/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/cli/commands/build.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,eAAe,GAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE;;GAEG;AACH,SAAS,SAAS,CAChB,IAAU,EACV,SAAiB,EACjB,UAAkB;IAElB,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAErD,MAAM,MAAM,GAAG,0BAA0B,CAAC;QACxC,IAAI;QACJ,SAAS;QACT,UAAU;QACV,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;IAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,UAAkB,EAClB,QAAiB,EACjB,iBAA0B;IAE1B,oBAAoB;IACpB,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,iCAAiC;IACjC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CACtB,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,CACrF,CAAC;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChF,OAAO,CAAC,KAAK,CAAC,aAAa,QAAQ,2BAA2B,SAAS,IAAI,CAAC,CAAC;YAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QACD,WAAW,GAAG,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,2CAA2C;IAC3C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,iBAAiB,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC;YACH,wBAAwB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,KAAK,CAAC,8BAA8B,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;YAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjD,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACxD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAClG,EAAE,CAAC,cAAc,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC;IAC3D,CAAC;IACD,oBAAoB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE3C,0CAA0C;IAC1C,OAAO,CAAC,GAAG,CAAC,gBAAgB,WAAW,CAAC,MAAM,eAAe,CAAC,CAAC;IAE/D,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,iBAAiB,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,KAAK,SAAS,qBAAqB,IAAI,GAAG,CAAC,CAAC;IACrE,CAAC;IAED,sEAAsE;IACtE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC5D,uBAAuB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAE/C,oEAAoE;IACpE,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,sBAAsB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,mDAAmD,CAAC;SAChE,QAAQ,CAAC,QAAQ,EAAE,4CAA4C,CAAC;SAChE,MAAM,CAAC,qBAAqB,EAAE,0DAA0D,CAAC;SACzF,MAAM,CAAC,KAAK,EAAE,IAAwB,EAAE,OAA+B,EAAE,EAAE;QAC1E,IAAI,SAA6B,CAAC;QAClC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,OAAO,CAAC,SAAS,MAAM,CAAC,CAAC;gBAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,OAAO;YACT,CAAC;QACH,CAAC;QACD,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/docker-utils.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Check that `docker compose` (v2) is available on the system.
+ * Throws if not found.
+ */
+export declare function checkDockerCompose(): void;
+/**
+ * Validate that the .env file exists and all variables have non-empty values.
+ * Returns the list of variable names that are missing values.
+ */
+export declare function validateEnvFile(agentDir: string): string[];
+/**
+ * Execute a docker compose command, streaming output to the terminal.
+ * Returns the exit code.
+ */
+export declare function execDockerCompose(args: string[]): Promise<number>;
+//# sourceMappingURL=docker-utils.d.ts.map

package/dist/cli/commands/docker-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-utils.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/docker-utils.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAQzC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CA6B1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAMjE"}

package/dist/cli/commands/docker-utils.js

@@ -0,0 +1,54 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { execSync, spawn } from "node:child_process";
+/**
+ * Check that `docker compose` (v2) is available on the system.
+ * Throws if not found.
+ */
+export function checkDockerCompose() {
+    try {
+        execSync("docker compose version", { stdio: "ignore" });
+    }
+    catch {
+        throw new Error("Docker Compose v2 is required but not found. Install Docker Desktop or the compose plugin.");
+    }
+}
+/**
+ * Validate that the .env file exists and all variables have non-empty values.
+ * Returns the list of variable names that are missing values.
+ */
+export function validateEnvFile(agentDir) {
+    const envPath = path.join(agentDir, ".env");
+    if (!fs.existsSync(envPath)) {
+        throw new Error(`No .env file found at ${envPath}. Create a .env file with the required credentials.`);
+    }
+    const content = fs.readFileSync(envPath, "utf-8");
+    const missing = [];
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        // Skip comments and empty lines
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eqIndex = trimmed.indexOf("=");
+        if (eqIndex === -1)
+            continue;
+        const key = trimmed.slice(0, eqIndex).trim();
+        const value = trimmed.slice(eqIndex + 1).trim();
+        if (!value) {
+            missing.push(key);
+        }
+    }
+    return missing;
+}
+/**
+ * Execute a docker compose command, streaming output to the terminal.
+ * Returns the exit code.
+ */
+export function execDockerCompose(args) {
+    return new Promise((resolve) => {
+        const child = spawn("docker", args, { stdio: "inherit" });
+        child.on("close", (code) => resolve(code ?? 0));
+        child.on("error", () => resolve(1));
+    });
+}
+//# sourceMappingURL=docker-utils.js.map

package/dist/cli/commands/docker-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-utils.js","sourceRoot":"","sources":["../../../src/cli/commands/docker-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,QAAQ,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,yBAAyB,OAAO,qDAAqD,CACtF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,gCAAgC;QAChC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAElD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,OAAO,KAAK,CAAC,CAAC;YAAE,SAAS;QAE7B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEhD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC1D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAChD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/commands/index.d.ts

@@ -0,0 +1,11 @@
+import { Command } from "commander";
+/**
+ * Register all chapter workspace subcommands under the `chapter` subcommand group,
+ * and register top-level commands (`run`, `package`).
+ *
+ * Also installs shorthand detection: if the first positional argument is a known
+ * agent type or config-declared agent name (e.g., `mason claude --role x`), it is
+ * treated as `mason run claude --role x`.
+ */
+export declare function registerCommands(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAqB,MAAM,WAAW,CAAC;AAUvD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuBvD"}

package/dist/cli/commands/index.js

@@ -0,0 +1,89 @@
+import { registerBuildCommand } from "./build.js";
+import { registerListCommand } from "./list.js";
+import { registerPackageCommand } from "./package.js";
+import { registerPermissionsCommand } from "./permissions.js";
+import { registerProxyCommand } from "./proxy.js";
+import { registerRunCommand, registerConfigureCommand, isKnownAgentType } from "./run-agent.js";
+import { registerValidateCommand } from "./validate.js";
+import { readConfigAgentNames } from "@clawmasons/agent-sdk";
+/**
+ * Register all chapter workspace subcommands under the `chapter` subcommand group,
+ * and register top-level commands (`run`, `package`).
+ *
+ * Also installs shorthand detection: if the first positional argument is a known
+ * agent type or config-declared agent name (e.g., `mason claude --role x`), it is
+ * treated as `mason run claude --role x`.
+ */
+export function registerCommands(program) {
+    // Top-level commands
+    registerRunCommand(program);
+    registerConfigureCommand(program);
+    registerPackageCommand(program);
+    // `chapter` subcommand group
+    const chapter = program
+        .command("chapter")
+        .description("Chapter workspace management commands");
+    registerListCommand(chapter);
+    registerValidateCommand(chapter);
+    registerPermissionsCommand(chapter);
+    registerBuildCommand(chapter);
+    registerProxyCommand(chapter);
+    // Read config-declared agent names synchronously so shorthand detection
+    // can recognise them before program.parse() fires.
+    const configAgentNames = new Set(readConfigAgentNames(process.cwd()));
+    // Shorthand detection: rewrite `mason <agent> ...` to `mason run <agent> ...`
+    installAgentTypeShorthand(program, configAgentNames);
+}
+/**
+ * Install a pre-parse hook that detects when the first argument is a known
+ * agent type or config-declared agent name (e.g., `mason claude --role x`) and
+ * rewrites it to `mason run claude --role x`.
+ */
+function installAgentTypeShorthand(program, configAgentNames) {
+    // Collect the names of all registered commands (including subcommands)
+    const getKnownCommandNames = () => {
+        const names = new Set();
+        for (const cmd of program.commands) {
+            names.add(cmd.name());
+            for (const alias of cmd.aliases()) {
+                names.add(alias);
+            }
+        }
+        return names;
+    };
+    const isShorthandTarget = (arg) => isKnownAgentType(arg) || configAgentNames.has(arg);
+    // Hook into the pre-parse phase by overriding parse/parseAsync.
+    const originalParseAsync = program.parseAsync.bind(program);
+    program.parseAsync = async (argv, parseOptions) => {
+        const args = argv ? [...argv] : [...process.argv];
+        const fromMode = parseOptions?.from ?? "node";
+        const userArgStart = fromMode === "user" ? 0 : 2;
+        if (args.length > userArgStart) {
+            const firstArg = args[userArgStart];
+            if (firstArg && !firstArg.startsWith("-")) {
+                const knownCommands = getKnownCommandNames();
+                if (!knownCommands.has(firstArg) && isShorthandTarget(firstArg)) {
+                    args.splice(userArgStart, 0, "run");
+                }
+            }
+        }
+        return originalParseAsync(args, parseOptions);
+    };
+    const originalParse = program.parse.bind(program);
+    program.parse = (argv, parseOptions) => {
+        const args = argv ? [...argv] : [...process.argv];
+        const fromMode = parseOptions?.from ?? "node";
+        const userArgStart = fromMode === "user" ? 0 : 2;
+        if (args.length > userArgStart) {
+            const firstArg = args[userArgStart];
+            if (firstArg && !firstArg.startsWith("-")) {
+                const knownCommands = getKnownCommandNames();
+                if (!knownCommands.has(firstArg) && isShorthandTarget(firstArg)) {
+                    args.splice(userArgStart, 0, "run");
+                }
+            }
+        }
+        return originalParse(args, parseOptions);
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/index.js.map

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

package/dist/cli/commands/list.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from "commander";
+interface ListOptions {
+    json?: boolean;
+}
+export declare function registerListCommand(program: Command): void;
+export declare function runList(rootDir: string, options: ListOptions): Promise<void>;
+export {};
+//# sourceMappingURL=list.d.ts.map

package/dist/cli/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQ1D;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/cli/commands/list.js

@@ -0,0 +1,60 @@
+import { discoverRoles } from "@clawmasons/shared";
+export function registerListCommand(program) {
+    program
+        .command("list")
+        .description("List available roles (local and installed packages)")
+        .option("--json", "Output as JSON")
+        .action(async (options) => {
+        await runList(process.cwd(), options);
+    });
+}
+export async function runList(rootDir, options) {
+    try {
+        // Discover all roles (local + packaged)
+        const roles = await discoverRoles(rootDir);
+        if (roles.length === 0) {
+            console.error("No roles found.");
+            process.exit(1);
+            return;
+        }
+        if (options.json) {
+            console.log(JSON.stringify(roles, null, 2));
+            return;
+        }
+        // Print role listing
+        console.log("\nAvailable roles:\n");
+        for (const role of roles) {
+            printRole(role);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`\nList failed: ${message}\n`);
+        process.exit(1);
+    }
+}
+function printRole(role) {
+    const source = role.source.type === "local"
+        ? `local, ${role.source.path ?? "unknown"}`
+        : `package, ${role.source.packageName ?? "unknown"}`;
+    const version = role.metadata.version ?? "0.0.0";
+    console.log(`  ${role.metadata.name}@${version} (${source})`);
+    if (role.metadata.description) {
+        console.log(`    ${role.metadata.description}`);
+    }
+    const children = [];
+    if (role.tasks.length > 0) {
+        children.push(`tasks: ${role.tasks.map((t) => t.name).join(", ")}`);
+    }
+    if (role.apps.length > 0) {
+        children.push(`apps: ${role.apps.map((a) => a.name).join(", ")}`);
+    }
+    if (role.skills.length > 0) {
+        children.push(`skills: ${role.skills.map((s) => s.name).join(", ")}`);
+    }
+    for (const child of children) {
+        console.log(`    ${child}`);
+    }
+    console.log("");
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/commands/list.js.map

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

package/dist/cli/commands/package.d.ts

@@ -0,0 +1,15 @@
+/**
+ * mason package — Build and pack a role from .mason/roles/<name>/ into a
+ * distributable npm .tgz package.
+ *
+ * Steps:
+ * 1. Load ROLE.md from .mason/roles/<name>/ROLE.md
+ * 2. Validate all task/skill refs can be resolved from role.sources
+ * 3. Assemble build directory at .mason/roles/<name>/build/
+ * 4. Generate/merge package.json in build dir
+ * 5. Run npm install, npm run build (if script exists), npm pack
+ */
+import type { Command } from "commander";
+export declare function registerPackageCommand(program: Command): void;
+export declare function runPackage(projectDir: string, roleName: string): Promise<void>;
+//# sourceMappingURL=package.d.ts.map

package/dist/cli/commands/package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/package.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQ7D;AAMD,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAoFf"}

package/dist/cli/commands/package.js

@@ -0,0 +1,241 @@
+/**
+ * mason package — Build and pack a role from .mason/roles/<name>/ into a
+ * distributable npm .tgz package.
+ *
+ * Steps:
+ * 1. Load ROLE.md from .mason/roles/<name>/ROLE.md
+ * 2. Validate all task/skill refs can be resolved from role.sources
+ * 3. Assemble build directory at .mason/roles/<name>/build/
+ * 4. Generate/merge package.json in build dir
+ * 5. Run npm install, npm run build (if script exists), npm pack
+ */
+import { mkdir, writeFile, readFile, copyFile, cp, stat, readdir, } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join, resolve as pathResolve, basename, extname } from "node:path";
+import { spawnSync } from "node:child_process";
+import { resolveRole, RoleDiscoveryError } from "@clawmasons/shared";
+import { getDialectByDirectory } from "@clawmasons/shared";
+// ---------------------------------------------------------------------------
+// CLI registration
+// ---------------------------------------------------------------------------
+export function registerPackageCommand(program) {
+    program
+        .command("package")
+        .description("Build and pack a role from .mason/roles/<name>/ into an npm package")
+        .requiredOption("--role <name>", "Role name to package")
+        .action(async (options) => {
+        await runPackage(process.cwd(), options.role);
+    });
+}
+// ---------------------------------------------------------------------------
+// Main orchestrator
+// ---------------------------------------------------------------------------
+export async function runPackage(projectDir, roleName) {
+    try {
+        // 1. Load role from .mason/roles/<name>/ROLE.md
+        console.log(`\n  Loading role "${roleName}"...`);
+        let role;
+        try {
+            role = await resolveRole(roleName, projectDir);
+        }
+        catch (err) {
+            if (err instanceof RoleDiscoveryError) {
+                const expectedPath = join(projectDir, ".mason", "roles", roleName, "ROLE.md");
+                throw new Error(`Role "${roleName}" not found. Expected ROLE.md at: ${expectedPath}`);
+            }
+            throw err;
+        }
+        if (role.source.type !== "local") {
+            throw new Error(`Role "${roleName}" is an installed package, not a local role. ` +
+                `mason package only works with local roles in .mason/roles/.`);
+        }
+        // 2. Resolve all task/skill refs from sources
+        console.log("  Resolving sources...");
+        const { resolvedTasks, resolvedSkills, errors } = await resolveAllRefs(role, projectDir);
+        if (errors.length > 0) {
+            console.error("\n  Unresolved references:");
+            for (const e of errors) {
+                console.error(`    ✘ ${e}`);
+            }
+            throw new Error(`${errors.length} reference(s) could not be resolved. Fix them before packaging.`);
+        }
+        // 3. Assemble build directory
+        const buildDir = join(projectDir, ".mason", "roles", roleName, "build");
+        console.log(`  Assembling build directory: ${buildDir}`);
+        await assembleBuild(role, buildDir, resolvedTasks, resolvedSkills);
+        // 4. Generate/merge package.json
+        await writePackageJson(role, roleName, projectDir, buildDir);
+        // 5. npm lifecycle
+        console.log("  Running npm install...");
+        runNpm(["install"], buildDir);
+        const pkg = JSON.parse(await readFile(join(buildDir, "package.json"), "utf-8"));
+        if (pkg.scripts?.build) {
+            console.log("  Running npm run build...");
+            runNpm(["run", "build"], buildDir);
+        }
+        console.log("  Running npm pack...");
+        runNpm(["pack"], buildDir);
+        // Report result
+        const tgzFiles = (await readdir(buildDir)).filter((f) => f.endsWith(".tgz"));
+        if (tgzFiles.length > 0) {
+            console.log(`\n✔ Packed: ${join(buildDir, tgzFiles[0] ?? "")}\n`);
+        }
+        else {
+            console.log(`\n✔ Package created in ${buildDir}\n`);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`\n✘ Package failed: ${message}\n`);
+        process.exit(1);
+    }
+}
+async function resolveAllRefs(role, projectDir) {
+    const resolvedTasks = [];
+    const resolvedSkills = [];
+    const errors = [];
+    const sources = role.sources ?? [];
+    for (const task of role.tasks ?? []) {
+        const resolved = await resolveRef(task, "task", sources, projectDir);
+        if (resolved) {
+            resolvedTasks.push(resolved);
+        }
+        else {
+            errors.push(`task "${task.name}" not found in sources: ${sources.join(", ") || "(none)"}`);
+        }
+    }
+    for (const skill of role.skills ?? []) {
+        const resolved = await resolveRef(skill, "skill", sources, projectDir);
+        if (resolved) {
+            resolvedSkills.push(resolved);
+        }
+        else {
+            errors.push(`skill "${skill.name}" not found in sources: ${sources.join(", ") || "(none)"}`);
+        }
+    }
+    return { resolvedTasks, resolvedSkills, errors };
+}
+async function resolveRef(ref, type, sources, projectDir) {
+    const name = ref.name;
+    // If ref has an explicit absolute path, use it directly
+    if (ref.ref && (ref.ref.startsWith("/") || existsSync(ref.ref))) {
+        const srcPath = pathResolve(projectDir, ref.ref);
+        const dest = type === "task"
+            ? `tasks/${basename(srcPath)}`
+            : `skills/${basename(srcPath)}`;
+        return { name, sourcePath: srcPath, destRelPath: dest };
+    }
+    // Otherwise scan sources directories
+    for (const sourceEntry of sources) {
+        const sourceDir = join(projectDir, sourceEntry.replace(/\/$/, ""));
+        // Determine which subdirectory to search based on dialect (if any)
+        const dirName = basename(sourceDir); // e.g., ".claude" → but sourceEntry is ".claude/"
+        const rawDirName = sourceEntry.replace(/^\./, "").replace(/\/$/, ""); // "claude"
+        const dialect = getDialectByDirectory(rawDirName);
+        let searchSubdir;
+        if (type === "task") {
+            // Use dialect-specific task subdir, or "tasks" as generic fallback
+            searchSubdir = dialect ? dialect.fieldMapping.tasks : "tasks";
+        }
+        else {
+            // Skills are always in "skills/" subdirectory
+            searchSubdir = "skills";
+        }
+        const searchDir = join(sourceDir, searchSubdir);
+        const found = await findFileOrDir(searchDir, name);
+        if (found) {
+            const ext = extname(found);
+            const destName = ext ? `${name}${ext}` : name;
+            const dest = type === "task" ? `tasks/${destName}` : `skills/${destName}`;
+            return { name, sourcePath: found, destRelPath: dest };
+        }
+    }
+    return undefined;
+}
+/**
+ * Find a file or directory matching <name> (with or without extension) in dir.
+ * Returns the absolute path if found, undefined otherwise.
+ */
+async function findFileOrDir(dir, name) {
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return undefined;
+    }
+    // Exact match (directory or extensionless file)
+    if (entries.includes(name)) {
+        return join(dir, name);
+    }
+    // Match with any extension (e.g., name.md)
+    const withExt = entries.find((e) => e.startsWith(name + "."));
+    if (withExt) {
+        return join(dir, withExt);
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Build directory assembly
+// ---------------------------------------------------------------------------
+async function assembleBuild(role, buildDir, resolvedTasks, resolvedSkills) {
+    await mkdir(buildDir, { recursive: true });
+    // Copy ROLE.md
+    if (role.source.path) {
+        const srcRoleMd = join(role.source.path, "ROLE.md");
+        await copyFile(srcRoleMd, join(buildDir, "ROLE.md"));
+    }
+    // Copy task files
+    for (const t of resolvedTasks) {
+        const destPath = join(buildDir, t.destRelPath);
+        await mkdir(join(destPath, ".."), { recursive: true });
+        await copyPath(t.sourcePath, destPath);
+    }
+    // Copy skill files
+    for (const s of resolvedSkills) {
+        const destPath = join(buildDir, s.destRelPath);
+        await mkdir(join(destPath, ".."), { recursive: true });
+        await copyPath(s.sourcePath, destPath);
+    }
+}
+async function copyPath(src, dest) {
+    const s = await stat(src);
+    if (s.isDirectory()) {
+        await cp(src, dest, { recursive: true });
+    }
+    else {
+        await copyFile(src, dest);
+    }
+}
+// ---------------------------------------------------------------------------
+// package.json generation / merge
+// ---------------------------------------------------------------------------
+async function writePackageJson(role, roleName, projectDir, buildDir) {
+    const userPkgPath = join(projectDir, ".mason", "roles", roleName, "package.json");
+    let base = {
+        name: role.metadata.scope
+            ? `@${role.metadata.scope.replace(/\./g, "-")}/${roleName}`
+            : roleName,
+        version: role.metadata.version ?? "1.0.0",
+        description: role.metadata.description,
+    };
+    // Merge user-supplied package.json if it exists
+    if (existsSync(userPkgPath)) {
+        const userPkg = JSON.parse(await readFile(userPkgPath, "utf-8"));
+        base = { ...base, ...userPkg };
+    }
+    // Generated fields always win
+    base.chapter = { type: "role" };
+    base.files = ["ROLE.md", "tasks/", "skills/"];
+    await writeFile(join(buildDir, "package.json"), JSON.stringify(base, null, 2) + "\n");
+}
+// ---------------------------------------------------------------------------
+// npm helpers
+// ---------------------------------------------------------------------------
+function runNpm(args, cwd) {
+    const result = spawnSync("npm", args, { cwd, stdio: "inherit" });
+    if (result.status !== 0) {
+        throw new Error(`npm ${args.join(" ")} failed with exit code ${result.status ?? "unknown"}`);
+    }
+}
+//# sourceMappingURL=package.js.map