npm - rhachet - Versions diffs - 1.9.0 → 1.10.1 - Mend

rhachet 1.9.0 → 1.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (22) hide show

package/dist/.test/example.use.repo/example.echoRegistry.js CHANGED Viewed

@@ -95,6 +95,7 @@ const echoRole = objects_1.Role.build({
     readme: 'knows how to echo input back to the user.',
     traits: [],
     skills: [echoSkill, writeSkill],
+    briefs: null,
 });
 exports.EXAMPLE_REGISTRY = new objects_1.RoleRegistry({
     slug: 'echo',

package/dist/.test/example.use.repo/example.echoRegistry.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"example.echoRegistry.js","sourceRoot":"","sources":["../../../src/.test/example.use.repo/example.echoRegistry.ts"],"names":[],"mappings":"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~~CAChC~~,CAAC,CAAC;AAEU,QAAA,gBAAgB,GAAG,IAAI,sBAAY,CAAC;IAC/C,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,0CAA0C;IAClD,KAAK,EAAE,CAAC,QAAQ,CAAC;CAClB,CAAC,CAAC"}
1	+ {"version":3,"file":"example.echoRegistry.js","sourceRoot":"","sources":["../../../src/.test/example.use.repo/example.echoRegistry.ts"],"names":[],"mappings":"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"}

package/dist/contract/cli/invoke.js CHANGED Viewed

@@ -9,6 +9,7 @@ const assureUniqueRoles_1 = require("../../logic/invoke/assureUniqueRoles");
 const getInvokeHooksByOpts_1 = require("../../logic/invoke/getInvokeHooksByOpts");
 const getRegistriesByOpts_1 = require("../../logic/invoke/getRegistriesByOpts");
 const invokeAsk_1 = require("./invokeAsk");
+const invokeBriefs_1 = require("./invokeBriefs");
 const invokeChoose_1 = require("./invokeChoose");
 const invokeList_1 = require("./invokeList");
 const invokeReadme_1 = require("./invokeReadme");
@@ -52,6 +53,7 @@ const invoke = async (input) => {
         .option('-c, --config <path>', 'where to find the rhachet.use.ts config'); // tell commander that we expect the config input and not to complain about it
     (0, invokeReadme_1.invokeReadme)({ program, registries });
     (0, invokeList_1.invokeList)({ program, registries });
+    (0, invokeBriefs_1.invokeBriefs)({ program, registries });
     (0, invokeChoose_1.invokeChoose)({ program });
     (0, invokeAsk_1.invokeAsk)({ program, config: { path: configPath }, registries, hooks });
     // invoke it

package/dist/contract/cli/invoke.js.map CHANGED Viewed

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

package/dist/contract/cli/invokeBriefs.d.ts ADDED Viewed

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

package/dist/contract/cli/invokeBriefs.js ADDED Viewed

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeBriefs = void 0;
+const invokeBriefsBoot_1 = require("./invokeBriefsBoot");
+const invokeBriefsLink_1 = require("./invokeBriefsLink");
+/**
+ * .what = adds the "briefs" command to the CLI with subcommands
+ * .why = manages role briefs (link from node_modules, boot/print context)
+ * .how = registers "link" and "boot" subcommands under "briefs"
+ */
+const invokeBriefs = ({ program, registries, }) => {
+    const briefsCommand = program
+        .command('briefs')
+        .description('manage role briefs (link, boot)');
+    (0, invokeBriefsLink_1.invokeBriefsLink)({ command: briefsCommand, registries });
+    (0, invokeBriefsBoot_1.invokeBriefsBoot)({ command: briefsCommand });
+};
+exports.invokeBriefs = invokeBriefs;
+//# sourceMappingURL=invokeBriefs.js.map

package/dist/contract/cli/invokeBriefs.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"invokeBriefs.js","sourceRoot":"","sources":["../../../src/contract/cli/invokeBriefs.ts"],"names":[],"mappings":";;;AAGA,yDAAsD;AACtD,yDAAsD;AAEtD;;;;GAIG;AACI,MAAM,YAAY,GAAG,CAAC,EAC3B,OAAO,EACP,UAAU,GAIX,EAAQ,EAAE;IACT,MAAM,aAAa,GAAG,OAAO;SAC1B,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,iCAAiC,CAAC,CAAC;IAElD,IAAA,mCAAgB,EAAC,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC;IACzD,IAAA,mCAAgB,EAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;AAC/C,CAAC,CAAC;AAbW,QAAA,YAAY,gBAavB"}

package/dist/contract/cli/invokeBriefsBoot.d.ts ADDED Viewed

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

package/dist/contract/cli/invokeBriefsBoot.integration.test.d.ts ADDED Viewed

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

package/dist/contract/cli/invokeBriefsBoot.integration.test.js ADDED Viewed

@@ -0,0 +1,149 @@
+"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 invokeBriefsBoot_1 = require("./invokeBriefsBoot");
+describe('invokeBriefsBoot (integration)', () => {
+    (0, test_fns_1.given)('a CLI program with invokeBriefsBoot registered', () => {
+        const testDir = (0, node_path_1.resolve)(__dirname, './.temp/invokeBriefsBoot');
+        const originalCwd = process.cwd();
+        beforeAll(() => {
+            // Create test directory structure
+            (0, node_fs_1.mkdirSync)(testDir, { recursive: true });
+            process.chdir(testDir);
+        });
+        afterAll(() => {
+            process.chdir(originalCwd);
+        });
+        const briefsCommand = new commander_1.Command('briefs');
+        const logSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
+        beforeEach(() => {
+            logSpy.mockClear();
+        });
+        (0, invokeBriefsBoot_1.invokeBriefsBoot)({ command: briefsCommand });
+        (0, test_fns_1.when)('invoked with "boot --role mechanic" after creating briefs', () => {
+            beforeAll(() => {
+                // Clean up first to ensure fresh state
+                const cleanBriefsDir = (0, node_path_1.resolve)(testDir, '.briefs');
+                if ((0, node_fs_1.existsSync)(cleanBriefsDir)) {
+                    (0, node_fs_1.rmSync)(cleanBriefsDir, { recursive: true, force: true });
+                }
+                // Setup: Create mock brief files
+                const briefsDir = (0, node_path_1.resolve)(testDir, '.briefs/mechanic');
+                (0, node_fs_1.mkdirSync)(briefsDir, { recursive: true });
+                // Create mock node_modules structure for symlinks
+                const mockRoleDir = (0, node_path_1.resolve)(testDir, 'node_modules/rhachet-roles-ehmpathy/dist/logic/roles/mechanic/.briefs');
+                (0, node_fs_1.mkdirSync)(mockRoleDir, { recursive: true });
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(mockRoleDir, 'brief1.md'), '# Brief 1\nThis is test brief 1');
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(mockRoleDir, 'brief2.md'), '# Brief 2\nThis is test brief 2');
+                // Create symlinks
+                (0, node_fs_1.symlinkSync)('../../node_modules/rhachet-roles-ehmpathy/dist/logic/roles/mechanic/.briefs/brief1.md', (0, node_path_1.resolve)(briefsDir, 'brief1.md'));
+                (0, node_fs_1.symlinkSync)('../../node_modules/rhachet-roles-ehmpathy/dist/logic/roles/mechanic/.briefs/brief2.md', (0, node_path_1.resolve)(briefsDir, 'brief2.md'));
+            });
+            (0, test_fns_1.then)('it should print all brief files with stats', async () => {
+                // Execute boot command
+                await briefsCommand.parseAsync(['boot', '--role', 'mechanic'], {
+                    from: 'user',
+                });
+                // Check that stats were printed
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('began:stats'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('files = 2'));
+                // Check that file contents were printed
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('began:.briefs/mechanic/brief1.md'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('This is test brief 1'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('began:.briefs/mechanic/brief2.md'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('This is test brief 2'));
+                // Snapshot the full console output
+                const allLogOutput = logSpy.mock.calls
+                    .map((call) => call[0])
+                    .join('\n');
+                expect(allLogOutput).toMatchSnapshot();
+            });
+        });
+        (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)(() => briefsCommand.parseAsync(['boot'], { from: 'user' }));
+                expect(error?.message).toContain('--role is required');
+            });
+        });
+        (0, test_fns_1.when)('invoked with "boot --role mechanic" before creating briefs', () => {
+            beforeAll(() => {
+                // Clean up to ensure no briefs directory exists
+                const briefsDir = (0, node_path_1.resolve)(testDir, '.briefs');
+                if ((0, node_fs_1.existsSync)(briefsDir)) {
+                    (0, node_fs_1.rmSync)(briefsDir, { recursive: true, force: true });
+                }
+            });
+            (0, test_fns_1.then)('it should throw an error about missing briefs directory', async () => {
+                const error = await (0, test_fns_1.getError)(() => briefsCommand.parseAsync(['boot', '--role', 'mechanic'], {
+                    from: 'user',
+                }));
+                expect(error?.message).toContain('Briefs directory not found');
+                expect(error?.message).toContain('briefs link');
+            });
+        });
+        (0, test_fns_1.when)('invoked with "boot --role mechanic" with empty briefs directory', () => {
+            beforeAll(() => {
+                // Clean up first, then create empty briefs directory
+                const cleanBriefsDir = (0, node_path_1.resolve)(testDir, '.briefs');
+                if ((0, node_fs_1.existsSync)(cleanBriefsDir)) {
+                    (0, node_fs_1.rmSync)(cleanBriefsDir, { recursive: true, force: true });
+                }
+                // Setup: Create empty briefs directory
+                const briefsDir = (0, node_path_1.resolve)(testDir, '.briefs/mechanic');
+                (0, node_fs_1.mkdirSync)(briefsDir, { recursive: true });
+            });
+            (0, test_fns_1.then)('it should warn about no briefs found', async () => {
+                await briefsCommand.parseAsync(['boot', '--role', 'mechanic'], {
+                    from: 'user',
+                });
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('No briefs found'));
+            });
+        });
+        (0, test_fns_1.when)('invoked with "boot --role mechanic" with symlinked directory containing files', () => {
+            beforeAll(() => {
+                // Clean up first to ensure fresh state
+                const cleanBriefsDir = (0, node_path_1.resolve)(testDir, '.briefs');
+                if ((0, node_fs_1.existsSync)(cleanBriefsDir)) {
+                    (0, node_fs_1.rmSync)(cleanBriefsDir, { recursive: true, force: true });
+                }
+                // Setup: Create briefs directory
+                const briefsDir = (0, node_path_1.resolve)(testDir, '.briefs/mechanic');
+                (0, node_fs_1.mkdirSync)(briefsDir, { recursive: true });
+                // Create a source directory with files and subdirectories
+                const sourceDir = (0, node_path_1.resolve)(testDir, 'test-briefs/subdir');
+                (0, node_fs_1.mkdirSync)(sourceDir, { recursive: true });
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(sourceDir, 'nested1.md'), '# Nested Brief 1\nThis is nested brief 1');
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(sourceDir, 'nested2.md'), '# Nested Brief 2\nThis is nested brief 2');
+                // Create a subdirectory within the source directory
+                const nestedSubdir = (0, node_path_1.resolve)(sourceDir, 'deeper');
+                (0, node_fs_1.mkdirSync)(nestedSubdir, { recursive: true });
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(nestedSubdir, 'deep1.md'), '# Deep Brief 1\nThis is deep brief 1');
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(nestedSubdir, 'deep2.md'), '# Deep Brief 2\nThis is deep brief 2');
+                // Create a symlink to the directory
+                (0, node_fs_1.symlinkSync)('../../test-briefs/subdir', (0, node_path_1.resolve)(briefsDir, 'linked-dir'));
+            });
+            (0, test_fns_1.then)('it should print all files including those in symlinked directories', async () => {
+                // Execute boot command
+                await briefsCommand.parseAsync(['boot', '--role', 'mechanic'], {
+                    from: 'user',
+                });
+                // Check that stats show 4 files (2 in linked-dir, 2 in linked-dir/deeper)
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('files = 4'));
+                // Check that nested file contents were printed
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('began:.briefs/mechanic/linked-dir/nested1.md'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('This is nested brief 1'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('began:.briefs/mechanic/linked-dir/nested2.md'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('This is nested brief 2'));
+                // Check that deeply nested file contents were printed
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('began:.briefs/mechanic/linked-dir/deeper/deep1.md'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('This is deep brief 1'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('began:.briefs/mechanic/linked-dir/deeper/deep2.md'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('This is deep brief 2'));
+            });
+        });
+    });
+});
+//# sourceMappingURL=invokeBriefsBoot.integration.test.js.map

package/dist/contract/cli/invokeBriefsBoot.integration.test.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/contract/cli/invokeBriefsBoot.js ADDED Viewed

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeBriefsBoot = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+/**
+ * .what = adds the "briefs boot" subcommand to the CLI
+ * .why = outputs all brief files with stats for context loading
+ * .how = reads all files in .briefs/<role> and prints them with formatting and statistics
+ */
+const invokeBriefsBoot = ({ command }) => {
+    command
+        .command('boot')
+        .description('boot context from role briefs (print all brief files)')
+        .option('--role <slug>', 'the role to boot briefs for')
+        .action(async (opts) => {
+        if (!opts.role)
+            helpful_errors_1.BadRequestError.throw('--role is required (e.g., --role mechanic)');
+        const role = opts.role;
+        const briefsDir = (0, node_path_1.resolve)(process.cwd(), '.briefs', role);
+        const gitRoot = await (0, rhachet_artifact_git_1.getGitRepoRoot)({ from: briefsDir });
+        // Check if briefs directory exists
+        if (!(0, node_fs_1.existsSync)(briefsDir)) {
+            helpful_errors_1.BadRequestError.throw(`Briefs directory not found: ${briefsDir}\nRun "rhachet briefs link --role ${role}" first`);
+        }
+        // Recursively read all files, including those in symlinked directories
+        const getAllFiles = (dir) => {
+            const entries = (0, node_fs_1.readdirSync)(dir);
+            const files = [];
+            for (const entry of entries) {
+                const fullPath = (0, node_path_1.resolve)(dir, entry);
+                const stats = (0, node_fs_1.statSync)(fullPath); // statSync follows symlinks
+                if (stats.isDirectory()) {
+                    // Recursively traverse directories (including symlinked ones)
+                    files.push(...getAllFiles(fullPath));
+                }
+                else if (stats.isFile()) {
+                    files.push(fullPath);
+                }
+            }
+            return files;
+        };
+        const files = getAllFiles(briefsDir).sort();
+        if (files.length === 0) {
+            console.log(``);
+            console.log(`⚠️  No briefs found in ${briefsDir}`);
+            console.log(``);
+            return;
+        }
+        // Count total characters and approximate tokens
+        let totalChars = 0;
+        for (const filepath of files) {
+            const content = (0, node_fs_1.readFileSync)(filepath, 'utf-8');
+            totalChars += content.length;
+        }
+        const approxTokens = Math.ceil(totalChars / 4);
+        const costPerMillionTokens = 3; // $3 per million tokens
+        const approxCost = (approxTokens / 1_000_000) * costPerMillionTokens;
+        const costFormatted = approxCost < 0.01
+            ? `< $0.01`
+            : `$${approxCost.toFixed(2).replace(/\.?0+$/, '')}`;
+        // Print stats helper
+        const printStats = () => {
+            console.log('#####################################################');
+            console.log('#####################################################');
+            console.log('#####################################################');
+            console.log('## began:stats');
+            console.log('#####################################################');
+            console.log('');
+            console.log('  quant');
+            console.log(`    ├── files = ${files.length}`);
+            console.log(`    ├── chars = ${totalChars}`);
+            console.log(`    └── tokens ≈ ${approxTokens} (${costFormatted} at $3/mil)`);
+            console.log('');
+            console.log('  treestruct');
+            const treeOutput = (0, node_child_process_1.execSync)(`tree -l ${briefsDir}`, {
+                encoding: 'utf-8',
+            })
+                .split('\n')
+                .map((line) => line.replace(/ -> .*$/, ''))
+                .map((line) => line.replace(gitRoot, '@gitroot'))
+                .filter((line) => !line.match(/^\s*\d+\s+director(y|ies),/))
+                .filter((line) => line.trim() !== '')
+                .map((line) => `    ${line}`)
+                .join('\n');
+            console.log(treeOutput);
+            console.log('');
+            console.log('  quant');
+            console.log(`    ├── files = ${files.length}`);
+            console.log(`    ├── chars = ${totalChars}`);
+            console.log(`    └── tokens ≈ ${approxTokens} (${costFormatted} at $3/mil)`);
+            console.log('');
+            console.log('#####################################################');
+            console.log('## ended:stats');
+            console.log('#####################################################');
+            console.log('#####################################################');
+            console.log('#####################################################');
+            console.log('');
+        };
+        // Print stats header
+        printStats();
+        // Print each file
+        for (const filepath of files) {
+            const content = (0, node_fs_1.readFileSync)(filepath, 'utf-8');
+            const relativePath = `.briefs/${role}/${(0, node_path_1.relative)(briefsDir, filepath)}`;
+            console.log('#####################################################');
+            console.log('#####################################################');
+            console.log('#####################################################');
+            console.log(`## began:${relativePath}`);
+            console.log('#####################################################');
+            console.log('');
+            // Print content with indentation
+            const indentedContent = content
+                .split('\n')
+                .map((line) => `  ${line}`)
+                .join('\n');
+            console.log(indentedContent);
+            console.log('');
+            console.log('#####################################################');
+            console.log(`## ended:${relativePath}`);
+            console.log('#####################################################');
+            console.log('#####################################################');
+            console.log('#####################################################');
+            console.log('');
+        }
+        // Print stats footer
+        printStats();
+    });
+};
+exports.invokeBriefsBoot = invokeBriefsBoot;
+//# sourceMappingURL=invokeBriefsBoot.js.map

package/dist/contract/cli/invokeBriefsBoot.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/contract/cli/invokeBriefsLink.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import { RoleRegistry } from '../sdk';
+/**
+ * .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
+ */
+export declare const invokeBriefsLink: ({ command, registries, }: {
+    command: Command;
+    registries: RoleRegistry[];
+}) => void;

package/dist/contract/cli/invokeBriefsLink.integration.test.d.ts ADDED Viewed

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

package/dist/contract/cli/invokeBriefsLink.integration.test.js ADDED Viewed

@@ -0,0 +1,85 @@
+"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 Role_1 = require("../../domain/objects/Role");
+const RoleRegistry_1 = require("../../domain/objects/RoleRegistry");
+const invokeBriefsLink_1 = require("./invokeBriefsLink");
+describe('invokeBriefsLink (integration)', () => {
+    (0, test_fns_1.given)('a CLI program with invokeBriefsLink registered', () => {
+        const testDir = (0, node_path_1.resolve)(__dirname, './.temp/invokeBriefsLink');
+        const originalCwd = process.cwd();
+        beforeAll(() => {
+            // Create test directory structure
+            (0, node_fs_1.mkdirSync)(testDir, { recursive: true });
+            process.chdir(testDir);
+            // Create mock briefs directory
+            const briefsDir = (0, node_path_1.resolve)(testDir, 'test-briefs');
+            (0, node_fs_1.mkdirSync)(briefsDir, { recursive: true });
+            // Create mock brief files
+            (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(briefsDir, 'brief1.md'), '# Brief 1\nThis is test brief 1');
+            (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(briefsDir, 'brief2.md'), '# Brief 2\nThis is test brief 2');
+        });
+        afterAll(() => {
+            process.chdir(originalCwd);
+        });
+        // Create mock registries with a role that has briefs configured
+        const mockRole = new Role_1.Role({
+            slug: 'mechanic',
+            name: 'Mechanic',
+            purpose: 'Test mechanic role',
+            readme: 'Test readme',
+            traits: [],
+            skills: [],
+            briefs: { dir: 'test-briefs' },
+        });
+        const mockRegistry = new RoleRegistry_1.RoleRegistry({
+            slug: 'test-registry',
+            readme: 'Test readme',
+            roles: [mockRole],
+        });
+        const briefsCommand = new commander_1.Command('briefs');
+        const logSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
+        beforeEach(() => {
+            logSpy.mockClear();
+            // Clean up any existing .briefs directory
+            const briefsDir = (0, node_path_1.resolve)(testDir, '.briefs');
+            if ((0, node_fs_1.existsSync)(briefsDir)) {
+                (0, node_fs_1.rmSync)(briefsDir, { recursive: true, force: true });
+            }
+        });
+        (0, invokeBriefsLink_1.invokeBriefsLink)({ command: briefsCommand, registries: [mockRegistry] });
+        (0, test_fns_1.when)('invoked with "link --role mechanic"', () => {
+            (0, test_fns_1.then)('it should create symlinks to briefs', async () => {
+                await briefsCommand.parseAsync(['link', '--role', 'mechanic'], {
+                    from: 'user',
+                });
+                // Check that .briefs/mechanic directory was created
+                expect((0, node_fs_1.existsSync)((0, node_path_1.resolve)(testDir, '.briefs/mechanic'))).toBe(true);
+                // Check that symlinks were created
+                expect((0, node_fs_1.existsSync)((0, node_path_1.resolve)(testDir, '.briefs/mechanic/brief1.md'))).toBe(true);
+                expect((0, node_fs_1.existsSync)((0, node_path_1.resolve)(testDir, '.briefs/mechanic/brief2.md'))).toBe(true);
+                // Check log output
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('Linking briefs for role "mechanic"'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('Linked 2 brief(s)'));
+            });
+        });
+        (0, test_fns_1.when)('invoked with "link" without --role', () => {
+            (0, test_fns_1.then)('it should throw an error requiring --role', async () => {
+                const error = await (0, test_fns_1.getError)(() => briefsCommand.parseAsync(['link'], { from: 'user' }));
+                expect(error?.message).toContain('--role is required');
+            });
+        });
+        (0, test_fns_1.when)('invoked with "link --role nonexistent"', () => {
+            (0, test_fns_1.then)('it should throw an error about role not found', async () => {
+                const error = await (0, test_fns_1.getError)(() => briefsCommand.parseAsync(['link', '--role', 'nonexistent'], {
+                    from: 'user',
+                }));
+                expect(error?.message).toContain('no role named "nonexistent"');
+            });
+        });
+    });
+});
+//# sourceMappingURL=invokeBriefsLink.integration.test.js.map

package/dist/contract/cli/invokeBriefsLink.integration.test.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/contract/cli/invokeBriefsLink.js ADDED Viewed

@@ -0,0 +1,78 @@
+"use strict";
+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");
+/**
+ * .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
+ */
+const invokeBriefsLink = ({ command, registries, }) => {
+    command
+        .command('link')
+        .description('create symlinks to role briefs in .briefs/<role>/')
+        .option('--role <slug>', 'the role to link briefs for')
+        .action((opts) => {
+        if (!opts.role)
+            helpful_errors_1.BadRequestError.throw('--role is required (e.g., --role mechanic)');
+        // 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) {
+            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(``);
+        console.log(`✓ Linked ${files.length} brief(s) to ${briefsDir}`);
+        console.log(``);
+    });
+};
+exports.invokeBriefsLink = invokeBriefsLink;
+//# sourceMappingURL=invokeBriefsLink.js.map

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

@@ -0,0 +1 @@

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

package/dist/domain/objects/Role.d.ts CHANGED Viewed

@@ -41,6 +41,14 @@ export interface Role {
      * .why = declares what the role can do
      */
     skills: RoleSkill<any>[];
+    /**
+     * .what = the briefs curated for this role
+     * .why = declares the library of knowledge this role can and should leverage
+     *   - enables reuse of the briefs, independent from the skills
+     */
+    briefs: null | {
+        dir: string;
+    };
 }
 export declare class Role extends DomainEntity<Role> implements Role {
     static unique: readonly ["slug"];

package/dist/domain/objects/Role.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Role.js","sourceRoot":"","sources":["../../../src/domain/objects/Role.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;~~AAmD9C~~,MAAa,IAAK,SAAQ,6BAAkB;;AAA5C,oBAEC;AADe,WAAM,GAAG,CAAC,MAAM,CAAU,CAAC"}
1	+ {"version":3,"file":"Role.js","sourceRoot":"","sources":["../../../src/domain/objects/Role.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AA0D9C,MAAa,IAAK,SAAQ,6BAAkB;;AAA5C,oBAEC;AADe,WAAM,GAAG,CAAC,MAAM,CAAU,CAAC"}

package/package.json CHANGED Viewed

@@ -2,7 +2,7 @@
   "name": "rhachet",
   "author": "ehmpathy",
   "description": "A framework for reliable, thorough thought. Weave threads of thought via stitches.",
-  "version": "1.9.0",
+  "version": "1.10.1",
   "repository": "ehmpathy/rhachet",
   "homepage": "https://github.com/ehmpathy/rhachet",
   "keywords": [
@@ -64,7 +64,6 @@
     "rhachet-artifact": "1.0.0",
     "rhachet-artifact-git": "1.1.0",
     "serde-fns": "1.3.1",
-    "test-fns": "1.5.0",
     "tsx": "4.20.5",
     "type-fns": "1.19.0",
     "uuid-fns": "1.0.1"
@@ -90,6 +89,7 @@
     "husky": "8.0.3",
     "jest": "29.3.1",
     "prettier": "2.8.1",
+    "test-fns": "1.7.0",
     "ts-jest": "29.1.3",
     "ts-node": "10.9.2",
     "typescript": "5.4.5"