rhachet 1.10.1 → 1.12.1

package/dist/contract/cli/invokeBriefsLink.js

@@ -2,75 +2,43 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.invokeBriefsLink = void 0;
 const helpful_errors_1 = require("helpful-errors");
-const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const assureFindRole_1 = require("../../logic/invoke/assureFindRole");
+const symlinkResourceDirectories_1 = require("../../logic/invoke/link/symlinkResourceDirectories");
 /**
  * .what = adds the "briefs link" subcommand to the CLI
  * .why = creates symlinks to role briefs from node_modules for easy access
- * .how = creates .briefs/<role> directory and symlinks brief files from the role's package
+ * .how = creates .agent/repo=$repo/role=$role/briefs directory and symlinks brief files
  */
 const invokeBriefsLink = ({ command, registries, }) => {
     command
         .command('link')
-        .description('create symlinks to role briefs in .briefs/<role>/')
+        .description('create symlinks to role briefs in .agent/ structure')
+        .option('--repo <slug>', 'the repository slug for the role')
         .option('--role <slug>', 'the role to link briefs for')
         .action((opts) => {
+        if (!opts.repo)
+            helpful_errors_1.BadRequestError.throw('--repo is required (e.g., --repo ehmpathy)');
         if (!opts.role)
             helpful_errors_1.BadRequestError.throw('--role is required (e.g., --role mechanic)');
+        const repoSlug = opts.repo;
         // Find the role from registries
         const role = (0, assureFindRole_1.assureFindRole)({ registries, slug: opts.role });
         // Check if role has briefs configured
-        if (!role.briefs || !role.briefs.dir) {
+        if (role.briefs.dirs.length === 0) {
             helpful_errors_1.BadRequestError.throw(`Role "${role.slug}" does not have briefs configured`);
         }
-        // Create .briefs/<role> directory
-        const briefsDir = (0, node_path_1.resolve)(process.cwd(), '.briefs', role.slug);
-        (0, node_fs_1.mkdirSync)(briefsDir, { recursive: true });
-        // Path to the role's briefs directory
-        const sourceDir = (0, node_path_1.resolve)(process.cwd(), role.briefs.dir);
-        // Check if source directory exists
-        if (!(0, node_fs_1.existsSync)(sourceDir)) {
-            helpful_errors_1.BadRequestError.throw(`Source directory not found: ${sourceDir}\nMake sure role "${role.slug}" briefs directory is accessible`);
-        }
-        // Read all files in the source directory
-        const files = (0, node_fs_1.readdirSync)(sourceDir);
-        if (files.length === 0) {
-            console.log(``);
-            console.log(`⚠️  No briefs found for role "${role.slug}"`);
-            console.log(``);
-            return;
-        }
-        // Create symlinks for each file
         console.log(``);
-        console.log(`📎 Linking briefs for role "${role.slug}"...`);
-        for (const file of files) {
-            const sourcePath = (0, node_path_1.resolve)(sourceDir, file);
-            const targetPath = (0, node_path_1.resolve)(briefsDir, (0, node_path_1.basename)(file));
-            // Remove existing symlink if it exists
-            if ((0, node_fs_1.existsSync)(targetPath)) {
-                console.log(`  ↻ ${file} (updating)`);
-            }
-            else {
-                console.log(`  + ${file}`);
-            }
-            // Create relative symlink from target directory to source file
-            const relativeSource = (0, node_path_1.relative)(briefsDir, sourcePath);
-            try {
-                (0, node_fs_1.symlinkSync)(relativeSource, targetPath);
-            }
-            catch (error) {
-                if (error.code === 'EEXIST') {
-                    // If file exists and is not a symlink, warn user
-                    console.log(`  ⚠️  ${file} already exists (skipping)`);
-                }
-                else {
-                    throw error;
-                }
-            }
-        }
+        console.log(`📎 Linking briefs for role "${role.slug}" from repo "${repoSlug}"...`);
+        // Create .agent/repo=$repo/role=$role/briefs directory and link briefs
+        const briefsDir = (0, node_path_1.resolve)(process.cwd(), '.agent', `repo=${repoSlug}`, `role=${role.slug}`, 'briefs');
+        const totalFiles = (0, symlinkResourceDirectories_1.symlinkResourceDirectories)({
+            sourceDirs: role.briefs.dirs,
+            targetDir: briefsDir,
+            resourceName: 'briefs',
+        });
         console.log(``);
-        console.log(`✓ Linked ${files.length} brief(s) to ${briefsDir}`);
+        console.log(`🔗 Linked ${totalFiles} brief(s) to ${briefsDir}`);
         console.log(``);
     });
 };

package/dist/contract/cli/invokeBriefsLink.js.map

@@ -1 +1 @@
-{"version":3,"file":"invokeBriefsLink.js","sourceRoot":"","sources":["../../../src/contract/cli/invokeBriefsLink.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"invokeBriefsLink.js","sourceRoot":"","sources":["../../../src/contract/cli/invokeBriefsLink.ts"],"names":[],"mappings":";;;AACA,mDAAiD;AACjD,yCAAoC;AAEpC,sEAAmE;AACnE,mGAAgG;AAGhG;;;;GAIG;AACI,MAAM,gBAAgB,GAAG,CAAC,EAC/B,OAAO,EACP,UAAU,GAIX,EAAQ,EAAE;IACT,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CAAC,eAAe,EAAE,kCAAkC,CAAC;SAC3D,MAAM,CAAC,eAAe,EAAE,6BAA6B,CAAC;SACtD,MAAM,CAAC,CAAC,IAAsC,EAAE,EAAE;QACjD,IAAI,CAAC,IAAI,CAAC,IAAI;YACZ,gCAAe,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,CAAC,IAAI;YACZ,gCAAe,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAEtE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;QAE3B,gCAAgC;QAChC,MAAM,IAAI,GAAG,IAAA,+BAAc,EAAC,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAE7D,sCAAsC;QACtC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,gCAAe,CAAC,KAAK,CACnB,SAAS,IAAI,CAAC,IAAI,mCAAmC,CACtD,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CACT,+BAA+B,IAAI,CAAC,IAAI,gBAAgB,QAAQ,MAAM,CACvE,CAAC;QAEF,uEAAuE;QACvE,MAAM,SAAS,GAAG,IAAA,mBAAO,EACvB,OAAO,CAAC,GAAG,EAAE,EACb,QAAQ,EACR,QAAQ,QAAQ,EAAE,EAClB,QAAQ,IAAI,CAAC,IAAI,EAAE,EACnB,QAAQ,CACT,CAAC;QAEF,MAAM,UAAU,GAAG,IAAA,uDAA0B,EAAC;YAC5C,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YAC5B,SAAS,EAAE,SAAS;YACpB,YAAY,EAAE,QAAQ;SACvB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,aAAa,UAAU,gBAAgB,SAAS,EAAE,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAtDW,QAAA,gBAAgB,oBAsD3B"}

package/dist/contract/cli/invokeInit.d.ts

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+/**
+ * .what = adds the "init" command to the CLI
+ * .why = enables auto-generation of rhachet.use.ts config from discovered role packages
+ * .how = discovers rhachet-roles-* packages and generates config file
+ */
+export declare const invokeInit: ({ program }: {
+    program: Command;
+}) => void;

package/dist/contract/cli/invokeInit.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/contract/cli/invokeInit.integration.test.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const commander_1 = require("commander");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const test_fns_1 = require("test-fns");
+const invokeInit_1 = require("./invokeInit");
+describe('invokeInit (integration)', () => {
+    (0, test_fns_1.given)('a CLI program with invokeInit registered', () => {
+        const testDir = (0, node_path_1.resolve)(__dirname, './.temp/invokeInit');
+        const originalCwd = process.cwd();
+        beforeAll(() => {
+            // Create test directory structure
+            (0, node_fs_1.mkdirSync)(testDir, { recursive: true });
+            // Initialize as a git repo for getGitRepoRoot to work
+            try {
+                (0, child_process_1.execSync)('git init', { cwd: testDir, stdio: 'pipe' });
+            }
+            catch {
+                // already a git repo
+            }
+        });
+        afterAll(() => {
+            process.chdir(originalCwd);
+        });
+        const program = new commander_1.Command('rhachet');
+        const logSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
+        beforeEach(() => {
+            logSpy.mockClear();
+            process.chdir(testDir);
+            // Clean up any existing rhachet.use.ts
+            const configPath = (0, node_path_1.resolve)(testDir, 'rhachet.use.ts');
+            if ((0, node_fs_1.existsSync)(configPath)) {
+                (0, node_fs_1.rmSync)(configPath);
+            }
+        });
+        (0, invokeInit_1.invokeInit)({ program });
+        (0, test_fns_1.when)('invoked with package.json containing rhachet-roles-* packages', () => {
+            beforeEach(() => {
+                // Create package.json with rhachet-roles packages
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(testDir, 'package.json'), JSON.stringify({
+                    name: 'test-project',
+                    dependencies: {
+                        'rhachet-roles-ehmpathy': '1.0.0',
+                    },
+                }));
+            });
+            (0, test_fns_1.then)('it should create rhachet.use.ts with discovered packages', async () => {
+                await program.parseAsync(['init'], { from: 'user' });
+                const configPath = (0, node_path_1.resolve)(testDir, 'rhachet.use.ts');
+                expect((0, node_fs_1.existsSync)(configPath)).toBe(true);
+                const content = (0, node_fs_1.readFileSync)(configPath, 'utf8');
+                expect(content).toContain('getRoleRegistryEhmpathy');
+                expect(content).toContain('getInvokeHooksEhmpathy');
+                expect(content).toContain("from 'rhachet-roles-ehmpathy'");
+                // Check log output
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('rhachet-roles-ehmpathy'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('Done'));
+            });
+        });
+        (0, test_fns_1.when)('invoked with multiple rhachet-roles-* packages', () => {
+            beforeEach(() => {
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(testDir, 'package.json'), JSON.stringify({
+                    name: 'test-project',
+                    dependencies: {
+                        'rhachet-roles-ehmpathy': '1.0.0',
+                    },
+                    devDependencies: {
+                        'rhachet-roles-other': '1.0.0',
+                    },
+                }));
+            });
+            (0, test_fns_1.then)('it should include all packages in config', async () => {
+                await program.parseAsync(['init'], { from: 'user' });
+                const configPath = (0, node_path_1.resolve)(testDir, 'rhachet.use.ts');
+                const content = (0, node_fs_1.readFileSync)(configPath, 'utf8');
+                expect(content).toContain('getRoleRegistryEhmpathy');
+                expect(content).toContain('getRoleRegistryOther');
+                expect(content).toContain('getInvokeHooksEhmpathy(), getInvokeHooksOther()');
+            });
+        });
+        (0, test_fns_1.when)('invoked with no rhachet-roles-* packages', () => {
+            beforeEach(() => {
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(testDir, 'package.json'), JSON.stringify({
+                    name: 'test-project',
+                    dependencies: {
+                        lodash: '4.0.0',
+                    },
+                }));
+            });
+            (0, test_fns_1.then)('it should warn and not create config', async () => {
+                await program.parseAsync(['init'], { from: 'user' });
+                const configPath = (0, node_path_1.resolve)(testDir, 'rhachet.use.ts');
+                expect((0, node_fs_1.existsSync)(configPath)).toBe(false);
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('No rhachet-roles-* packages found'));
+            });
+        });
+        (0, test_fns_1.when)('rhachet.use.ts already exists', () => {
+            beforeEach(() => {
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(testDir, 'package.json'), JSON.stringify({
+                    name: 'test-project',
+                    dependencies: {
+                        'rhachet-roles-ehmpathy': '1.0.0',
+                    },
+                }));
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(testDir, 'rhachet.use.ts'), '// existing config');
+            });
+            (0, test_fns_1.then)('it should throw an error without --force', async () => {
+                const error = await (0, test_fns_1.getError)(() => program.parseAsync(['init'], { from: 'user' }));
+                expect(error?.message).toContain('already exists');
+                expect(error?.message).toContain('--force');
+            });
+            (0, test_fns_1.then)('it should overwrite with --force', async () => {
+                await program.parseAsync(['init', '--force'], { from: 'user' });
+                const configPath = (0, node_path_1.resolve)(testDir, 'rhachet.use.ts');
+                const content = (0, node_fs_1.readFileSync)(configPath, 'utf8');
+                expect(content).toContain('getRoleRegistryEhmpathy');
+            });
+        });
+    });
+});
+//# sourceMappingURL=invokeInit.integration.test.js.map

package/dist/contract/cli/invokeInit.integration.test.js.map

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

package/dist/contract/cli/invokeInit.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeInit = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const discoverRolePackages_1 = require("../../logic/init/discoverRolePackages");
+const generateRhachetConfig_1 = require("../../logic/init/generateRhachetConfig");
+/**
+ * .what = adds the "init" command to the CLI
+ * .why = enables auto-generation of rhachet.use.ts config from discovered role packages
+ * .how = discovers rhachet-roles-* packages and generates config file
+ */
+const invokeInit = ({ program }) => {
+    program
+        .command('init')
+        .description('initialize rhachet.use.ts config from discovered role packages')
+        .option('--force', 'overwrite existing rhachet.use.ts')
+        .action(async (opts) => {
+        const cwd = process.cwd();
+        const root = await (0, rhachet_artifact_git_1.getGitRepoRoot)({ from: cwd });
+        const configPath = (0, node_path_1.resolve)(root, 'rhachet.use.ts');
+        const relativeConfigPath = (0, node_path_1.relative)(cwd, configPath);
+        // Check if config already exists
+        if ((0, node_fs_1.existsSync)(configPath) && !opts.force) {
+            helpful_errors_1.BadRequestError.throw(`rhachet.use.ts already exists. Use --force to overwrite.`);
+        }
+        console.log(``);
+        console.log(`🔭 Search for rhachet role packages...`);
+        // Discover role packages
+        const packages = await (0, discoverRolePackages_1.discoverRolePackages)({ from: cwd });
+        if (packages.length === 0) {
+            console.log(`  - [none found]`);
+            console.log(``);
+            console.log(`⚠️  No rhachet-roles-* packages found in package.json dependencies.`);
+            console.log(`   Install a role package first, e.g.: npm install rhachet-roles-ehmpathy`);
+            console.log(``);
+            return;
+        }
+        for (const pkg of packages) {
+            console.log(`  - [found] ${pkg}`);
+        }
+        console.log(``);
+        console.log(`✨ Create rhachet.use.ts...`);
+        // Generate and write config
+        const content = (0, generateRhachetConfig_1.generateRhachetConfig)({ packages });
+        (0, node_fs_1.writeFileSync)(configPath, content, 'utf8');
+        console.log(`  + [created] ${relativeConfigPath}`);
+        console.log(``);
+        console.log(`🌊 Done, rhachet config with ${packages.length} role package(s), ready for use`);
+        console.log(``);
+        console.log(`Run 'npx rhachet list' to see available roles.`);
+    });
+};
+exports.invokeInit = invokeInit;
+//# sourceMappingURL=invokeInit.js.map

package/dist/contract/cli/invokeInit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invokeInit.js","sourceRoot":"","sources":["../../../src/contract/cli/invokeInit.ts"],"names":[],"mappings":";;;AACA,mDAAiD;AACjD,qCAAoD;AACpD,yCAA8C;AAC9C,+DAAsD;AAEtD,gFAA6E;AAC7E,kFAA+E;AAE/E;;;;GAIG;AACI,MAAM,UAAU,GAAG,CAAC,EAAE,OAAO,EAAwB,EAAQ,EAAE;IACpE,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CACV,gEAAgE,CACjE;SACA,MAAM,CAAC,SAAS,EAAE,mCAAmC,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,IAAyB,EAAE,EAAE;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,MAAM,IAAA,qCAAc,EAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAA,mBAAO,EAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QACnD,MAAM,kBAAkB,GAAG,IAAA,oBAAQ,EAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAErD,iCAAiC;QACjC,IAAI,IAAA,oBAAU,EAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1C,gCAAe,CAAC,KAAK,CACnB,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QAEtD,yBAAyB;QACzB,MAAM,QAAQ,GAAG,MAAM,IAAA,2CAAoB,EAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAE3D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CACT,qEAAqE,CACtE,CAAC;YACF,OAAO,CAAC,GAAG,CACT,2EAA2E,CAC5E,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAE1C,4BAA4B;QAC5B,MAAM,OAAO,GAAG,IAAA,6CAAqB,EAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpD,IAAA,uBAAa,EAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,iBAAiB,kBAAkB,EAAE,CAAC,CAAC;QAEnD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CACT,gCAAgC,QAAQ,CAAC,MAAM,iCAAiC,CACjF,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AA1DW,QAAA,UAAU,cA0DrB"}

package/dist/contract/cli/invokeList.js

@@ -20,7 +20,7 @@ const invokeList = ({ program, registries, }) => {
                 helpful_errors_1.BadRequestError.throw(`no role named "${opts.role}"`);
             console.log(``);
             console.log(`📖 ${role.slug}.skills =`);
-            for (const skill of role.skills)
+            for (const skill of role.skills.refs)
                 console.log(`  - ${role.slug}.${skill.slug}`);
             console.log(``);
             return;

package/dist/contract/cli/invokeList.js.map

@@ -1 +1 @@
-{"version":3,"file":"invokeList.js","sourceRoot":"","sources":["../../../src/contract/cli/invokeList.ts"],"names":[],"mappings":";;;AACA,mDAAiD;AAEjD,sEAAmE;AAGnE;;;GAGG;AACI,MAAM,UAAU,GAAG,CAAC,EACzB,OAAO,EACP,UAAU,GAIX,EAAQ,EAAE;IACT,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,mBAAmB,EAAE,gCAAgC,CAAC;SAC7D,MAAM,CAAC,eAAe,EAAE,iDAAiD,CAAC;SAC1E,MAAM,CAAC,CAAC,IAA0C,EAAE,EAAE;QACrD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,IAAA,+BAAc,EAAC,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7D,IAAI,CAAC,IAAI;gBAAE,gCAAe,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YAEjE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,WAAW,CAAC,CAAC;YACxC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;gBAC7B,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClE,IAAI,CAAC,QAAQ;gBACX,gCAAe,CAAC,KAAK,CAAC,sBAAsB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YAEhE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,UAAU,CAAC,CAAC;YAC3C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK;gBAC/B,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,IAAI,eAAe,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC/C,QAAQ,CAAC,KAAK,CAAC,GAAG,CAChB,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,eAAe,IAAI,CAAC,OAAO,EAAE,CACrE,CACF,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAhDW,QAAA,UAAU,cAgDrB"}
+{"version":3,"file":"invokeList.js","sourceRoot":"","sources":["../../../src/contract/cli/invokeList.ts"],"names":[],"mappings":";;;AACA,mDAAiD;AAEjD,sEAAmE;AAGnE;;;GAGG;AACI,MAAM,UAAU,GAAG,CAAC,EACzB,OAAO,EACP,UAAU,GAIX,EAAQ,EAAE;IACT,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,mBAAmB,EAAE,gCAAgC,CAAC;SAC7D,MAAM,CAAC,eAAe,EAAE,iDAAiD,CAAC;SAC1E,MAAM,CAAC,CAAC,IAA0C,EAAE,EAAE;QACrD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,IAAA,+BAAc,EAAC,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7D,IAAI,CAAC,IAAI;gBAAE,gCAAe,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YAEjE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,WAAW,CAAC,CAAC;YACxC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI;gBAClC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClE,IAAI,CAAC,QAAQ;gBACX,gCAAe,CAAC,KAAK,CAAC,sBAAsB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YAEhE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,UAAU,CAAC,CAAC;YAC3C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK;gBAC/B,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,IAAI,eAAe,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC/C,QAAQ,CAAC,KAAK,CAAC,GAAG,CAChB,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,eAAe,IAAI,CAAC,OAAO,EAAE,CACrE,CACF,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAhDW,QAAA,UAAU,cAgDrB"}

package/dist/contract/cli/invokeReadme.integration.test.js

@@ -32,7 +32,7 @@ describe('invokeReadme (integration)', () => {
             (0, test_fns_1.then)('it should print the skill readme', async () => {
                 await program.parseAsync(['readme', '--role', 'echoer', '--skill', 'echo'], { from: 'user' });
                 expect(logSpy).toHaveBeenCalledWith('📜 echoer.echo.readme');
-                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining(example_echoRegistry_1.EXAMPLE_REGISTRY.roles[0].skills[0].readme.split('\n')[0]));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining(example_echoRegistry_1.EXAMPLE_REGISTRY.roles[0].skills.refs[0].readme.split('\n')[0]));
             });
         });
         (0, test_fns_1.when)('invoked with an unknown role', () => {

package/dist/contract/cli/invokeReadme.integration.test.js.map

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

package/dist/contract/cli/invokeReadme.js

@@ -38,9 +38,9 @@ const invokeReadme = ({ program, registries, }) => {
         if (!opts.skill)
             return printReadme(`${role.slug}`, role.readme);
         // resolve skill
-        const skill = role.skills.find((s) => s.slug === opts.skill);
+        const skill = role.skills.refs.find((s) => s.slug === opts.skill);
         if (!skill)
-            helpful_errors_1.BadRequestError.throw(`no skill "${opts.skill}" in role "${opts.role}"`, { skills: role.skills.map((thisSkill) => thisSkill.slug) });
+            helpful_errors_1.BadRequestError.throw(`no skill "${opts.skill}" in role "${opts.role}"`, { skills: role.skills.refs.map((thisSkill) => thisSkill.slug) });
         // skill-level readme
         return printReadme(`${role.slug}.${skill.slug}`, skill.readme);
     });

package/dist/contract/cli/invokeReadme.js.map

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

package/dist/contract/cli/invokeRoles.d.ts

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import { RoleRegistry } from '../sdk';
+/**
+ * .what = adds the "roles" command to the CLI with subcommands
+ * .why = manages role resources (briefs and skills) in .agent/ directory structure
+ * .how = registers "link" and "boot" subcommands under "roles"
+ */
+export declare const invokeRoles: ({ program, registries, }: {
+    program: Command;
+    registries: RoleRegistry[];
+}) => void;

package/dist/contract/cli/invokeRoles.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeRoles = void 0;
+const invokeRolesBoot_1 = require("./invokeRolesBoot");
+const invokeRolesLink_1 = require("./invokeRolesLink");
+/**
+ * .what = adds the "roles" command to the CLI with subcommands
+ * .why = manages role resources (briefs and skills) in .agent/ directory structure
+ * .how = registers "link" and "boot" subcommands under "roles"
+ */
+const invokeRoles = ({ program, registries, }) => {
+    const rolesCommand = program
+        .command('roles')
+        .description('manage role resources (link, boot)');
+    (0, invokeRolesLink_1.invokeRolesLink)({ command: rolesCommand, registries });
+    (0, invokeRolesBoot_1.invokeRolesBoot)({ command: rolesCommand });
+};
+exports.invokeRoles = invokeRoles;
+//# sourceMappingURL=invokeRoles.js.map

package/dist/contract/cli/invokeRoles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invokeRoles.js","sourceRoot":"","sources":["../../../src/contract/cli/invokeRoles.ts"],"names":[],"mappings":";;;AAGA,uDAAoD;AACpD,uDAAoD;AAEpD;;;;GAIG;AACI,MAAM,WAAW,GAAG,CAAC,EAC1B,OAAO,EACP,UAAU,GAIX,EAAQ,EAAE;IACT,MAAM,YAAY,GAAG,OAAO;SACzB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,oCAAoC,CAAC,CAAC;IAErD,IAAA,iCAAe,EAAC,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC;IACvD,IAAA,iCAAe,EAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;AAC7C,CAAC,CAAC;AAbW,QAAA,WAAW,eAatB"}

package/dist/contract/cli/invokeRolesBoot.d.ts

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+/**
+ * .what = adds the "roles boot" subcommand to the CLI
+ * .why = outputs role resources (briefs and skills) with stats for context loading
+ * .how = reads all files in .agent/repo=$repo/role=$role and prints them with formatting
+ */
+export declare const invokeRolesBoot: ({ command }: {
+    command: Command;
+}) => void;

package/dist/contract/cli/invokeRolesBoot.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/contract/cli/invokeRolesBoot.integration.test.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const test_fns_1 = require("test-fns");
+const invokeRolesBoot_1 = require("./invokeRolesBoot");
+describe('invokeRolesBoot (integration)', () => {
+    (0, test_fns_1.given)('a CLI program with invokeRolesBoot registered', () => {
+        const testDir = (0, node_path_1.resolve)(__dirname, './.temp/invokeRolesBoot');
+        const originalCwd = process.cwd();
+        beforeAll(() => {
+            // Create test directory structure
+            (0, node_fs_1.mkdirSync)(testDir, { recursive: true });
+            process.chdir(testDir);
+            // Initialize a git repo (required by invokeRolesBoot for getGitRepoRoot)
+            const { execSync } = require('node:child_process');
+            try {
+                execSync('git init', { cwd: testDir, stdio: 'ignore' });
+                execSync('git config user.email "test@example.com"', {
+                    cwd: testDir,
+                    stdio: 'ignore',
+                });
+                execSync('git config user.name "Test User"', {
+                    cwd: testDir,
+                    stdio: 'ignore',
+                });
+            }
+            catch {
+                // Ignore errors if git is not available
+            }
+        });
+        afterAll(() => {
+            process.chdir(originalCwd);
+        });
+        const rolesCommand = new commander_1.Command('roles');
+        const logSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
+        beforeEach(() => {
+            logSpy.mockClear();
+        });
+        (0, invokeRolesBoot_1.invokeRolesBoot)({ command: rolesCommand });
+        (0, test_fns_1.when)('invoked with "boot --repo test --role mechanic" after creating briefs and skills', () => {
+            beforeAll(() => {
+                // Clean up first to ensure fresh state
+                const cleanAgentDir = (0, node_path_1.resolve)(testDir, '.agent');
+                if ((0, node_fs_1.existsSync)(cleanAgentDir)) {
+                    (0, node_fs_1.rmSync)(cleanAgentDir, { recursive: true, force: true });
+                }
+                // Setup: Create mock role directory structure
+                const roleDir = (0, node_path_1.resolve)(testDir, '.agent/repo=test/role=mechanic');
+                const briefsDir = (0, node_path_1.resolve)(roleDir, 'briefs');
+                const skillsDir = (0, node_path_1.resolve)(roleDir, 'skills');
+                (0, node_fs_1.mkdirSync)(briefsDir, { recursive: true });
+                (0, node_fs_1.mkdirSync)(skillsDir, { recursive: true });
+                // Create mock briefs source directory and files
+                const mockBriefsSourceDir = (0, node_path_1.resolve)(testDir, 'node_modules/rhachet-roles-test/dist/logic/roles/mechanic/.briefs');
+                (0, node_fs_1.mkdirSync)(mockBriefsSourceDir, { recursive: true });
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(mockBriefsSourceDir, 'brief1.md'), '# Brief 1\nThis is test brief 1');
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(mockBriefsSourceDir, 'brief2.md'), '# Brief 2\nThis is test brief 2');
+                // Create mock skills source directory and files
+                const mockSkillsSourceDir = (0, node_path_1.resolve)(testDir, 'node_modules/rhachet-roles-test/dist/logic/roles/mechanic/.skills');
+                (0, node_fs_1.mkdirSync)(mockSkillsSourceDir, { recursive: true });
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(mockSkillsSourceDir, 'skill1.sh'), '#!/bin/bash\n# Skill 1 - Test skill\n# This skill does something useful\necho "test skill 1"');
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(mockSkillsSourceDir, 'skill2.sh'), '#!/bin/bash\n# Skill 2 - Another test skill\necho "test skill 2"');
+                // Create symlinks to the directories (following new directory-linking behavior)
+                // Path is relative from briefsDir back to testDir, then to node_modules
+                (0, node_fs_1.symlinkSync)('../../../../node_modules/rhachet-roles-test/dist/logic/roles/mechanic/.briefs', (0, node_path_1.resolve)(briefsDir, '.briefs'));
+                // Path is relative from skillsDir back to testDir, then to node_modules
+                (0, node_fs_1.symlinkSync)('../../../../node_modules/rhachet-roles-test/dist/logic/roles/mechanic/.skills', (0, node_path_1.resolve)(skillsDir, '.skills'));
+                // Create a readme file in the role directory
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(roleDir, 'readme.md'), '# Mechanic Role\n\nThis is the mechanic role readme.');
+            });
+            (0, test_fns_1.then)('it should print all briefs and skills with stats', async () => {
+                // Execute boot command
+                await rolesCommand.parseAsync(['boot', '--repo', 'test', '--role', 'mechanic'], {
+                    from: 'user',
+                });
+                // Check that stats were printed
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('began:stats'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('files = 5'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('briefs = 2'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('skills = 2'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('other = 1'));
+                // Check that brief file contents were printed
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('began:.agent/repo=test/role=mechanic/briefs/.briefs/brief1.md'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('This is test brief 1'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('began:.agent/repo=test/role=mechanic/briefs/.briefs/brief2.md'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('This is test brief 2'));
+                // Check that skill documentation was extracted (not full implementation)
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('began:.agent/repo=test/role=mechanic/skills/.skills/skill1.sh'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('Skill 1 - Test skill'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('[implementation hidden - use skill to execute]'));
+                // Check that implementation is NOT printed for skills
+                expect(logSpy).not.toHaveBeenCalledWith(expect.stringContaining('echo "test skill 1"'));
+                // Check that readme was printed
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('began:.agent/repo=test/role=mechanic/readme.md'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('Mechanic Role'));
+            });
+        });
+        (0, test_fns_1.when)('invoked with "boot" without --repo', () => {
+            (0, test_fns_1.then)('it should throw an error requiring --repo', async () => {
+                const error = await (0, test_fns_1.getError)(() => rolesCommand.parseAsync(['boot', '--role', 'mechanic'], {
+                    from: 'user',
+                }));
+                expect(error?.message).toContain('--repo is required');
+            });
+        });
+        (0, test_fns_1.when)('invoked with "boot" without --role', () => {
+            (0, test_fns_1.then)('it should throw an error requiring --role', async () => {
+                const error = await (0, test_fns_1.getError)(() => rolesCommand.parseAsync(['boot', '--repo', 'test'], {
+                    from: 'user',
+                }));
+                expect(error?.message).toContain('--role is required');
+            });
+        });
+        (0, test_fns_1.when)('invoked with "boot --repo test --role mechanic" before creating role directory', () => {
+            beforeAll(() => {
+                // Clean up to ensure no role directory exists
+                const agentDir = (0, node_path_1.resolve)(testDir, '.agent');
+                if ((0, node_fs_1.existsSync)(agentDir)) {
+                    (0, node_fs_1.rmSync)(agentDir, { recursive: true, force: true });
+                }
+            });
+            (0, test_fns_1.then)('it should throw an error about missing role directory', async () => {
+                const error = await (0, test_fns_1.getError)(() => rolesCommand.parseAsync(['boot', '--repo', 'test', '--role', 'mechanic'], {
+                    from: 'user',
+                }));
+                expect(error?.message).toContain('Role directory not found');
+                expect(error?.message).toContain('roles link');
+            });
+        });
+        (0, test_fns_1.when)('invoked with "boot --repo test --role mechanic" with empty role directory', () => {
+            beforeAll(() => {
+                // Clean up first, then create empty role directory
+                const cleanAgentDir = (0, node_path_1.resolve)(testDir, '.agent');
+                if ((0, node_fs_1.existsSync)(cleanAgentDir)) {
+                    (0, node_fs_1.rmSync)(cleanAgentDir, { recursive: true, force: true });
+                }
+                // Setup: Create empty role directory
+                const roleDir = (0, node_path_1.resolve)(testDir, '.agent/repo=test/role=mechanic');
+                (0, node_fs_1.mkdirSync)(roleDir, { recursive: true });
+            });
+            (0, test_fns_1.then)('it should warn about no resources found', async () => {
+                await rolesCommand.parseAsync(['boot', '--repo', 'test', '--role', 'mechanic'], {
+                    from: 'user',
+                });
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('No resources found'));
+            });
+        });
+    });
+});
+//# sourceMappingURL=invokeRolesBoot.integration.test.js.map