rhachet 1.10.1 → 1.12.1

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

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

package/dist/contract/cli/invokeRolesBoot.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeRolesBoot = 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 = extracts documentation from a skill file without showing implementation
+ * .why = agents should understand what skills do, not how they do it
+ * .how = reads file and extracts only comments/documentation at the top
+ */
+const extractSkillDocumentation = (filepath) => {
+    const content = (0, node_fs_1.readFileSync)(filepath, 'utf-8');
+    const lines = content.split('\n');
+    const docLines = [];
+    // Extract shebang and leading comments/documentation
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Include shebang
+        if (trimmed.startsWith('#!')) {
+            docLines.push(line);
+            continue;
+        }
+        // Include comment lines (shell, python, etc)
+        if (trimmed.startsWith('#') ||
+            trimmed.startsWith('//') ||
+            trimmed.startsWith('*')) {
+            docLines.push(line);
+            continue;
+        }
+        // Stop at first non-comment, non-blank line
+        if (trimmed !== '') {
+            break;
+        }
+        // Include blank lines between comments
+        docLines.push(line);
+    }
+    // If we got some documentation, add a note about implementation being hidden
+    if (docLines.length > 0) {
+        docLines.push('');
+        docLines.push('# [implementation hidden - use skill to execute]');
+    }
+    else {
+        docLines.push('# [no documentation found]');
+        docLines.push('# [implementation hidden - use skill to execute]');
+    }
+    return docLines.join('\n');
+};
+/**
+ * .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
+ */
+const invokeRolesBoot = ({ command }) => {
+    command
+        .command('boot')
+        .description('boot context from role resources (briefs and skills)')
+        .option('--repo <slug>', 'the repository slug for the role')
+        .option('--role <slug>', 'the role to boot resources for')
+        .action(async (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;
+        const roleSlug = opts.role;
+        const roleDir = (0, node_path_1.resolve)(process.cwd(), '.agent', `repo=${repoSlug}`, `role=${roleSlug}`);
+        const gitRoot = await (0, rhachet_artifact_git_1.getGitRepoRoot)({ from: roleDir });
+        // Check if role directory exists
+        if (!(0, node_fs_1.existsSync)(roleDir)) {
+            helpful_errors_1.BadRequestError.throw(`Role directory not found: ${roleDir}\nRun "rhachet roles link --repo ${repoSlug} --role ${roleSlug}" 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 allFiles = getAllFiles(roleDir).sort();
+        if (allFiles.length === 0) {
+            console.log(``);
+            console.log(`⚠️  No resources found in ${roleDir}`);
+            console.log(``);
+            return;
+        }
+        // Separate files by type
+        const briefsDir = (0, node_path_1.resolve)(roleDir, 'briefs');
+        const skillsDir = (0, node_path_1.resolve)(roleDir, 'skills');
+        const briefFiles = allFiles.filter((f) => f.startsWith(briefsDir));
+        const skillFiles = allFiles.filter((f) => f.startsWith(skillsDir));
+        const otherFiles = allFiles.filter((f) => !f.startsWith(briefsDir) && !f.startsWith(skillsDir));
+        // Count total characters and approximate tokens
+        let totalChars = 0;
+        for (const filepath of allFiles) {
+            const isSkill = filepath.startsWith(skillsDir);
+            if (isSkill) {
+                // For skills, only count documentation
+                const doc = extractSkillDocumentation(filepath);
+                totalChars += doc.length;
+            }
+            else {
+                // For other files, count full content
+                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 = ${allFiles.length}`);
+            console.log(`    │   ├── briefs = ${briefFiles.length}`);
+            console.log(`    │   ├── skills = ${skillFiles.length}`);
+            console.log(`    │   └── other = ${otherFiles.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 ${roleDir}`, {
+                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 = ${allFiles.length}`);
+            console.log(`    │   ├── briefs = ${briefFiles.length}`);
+            console.log(`    │   ├── skills = ${skillFiles.length}`);
+            console.log(`    │   └── other = ${otherFiles.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 allFiles) {
+            const relativePath = `.agent/repo=${repoSlug}/role=${roleSlug}/${(0, node_path_1.relative)(roleDir, filepath)}`;
+            const isSkill = filepath.startsWith(skillsDir);
+            console.log('#####################################################');
+            console.log('#####################################################');
+            console.log('#####################################################');
+            console.log(`## began:${relativePath}`);
+            console.log('#####################################################');
+            console.log('');
+            // Get content based on file type
+            const content = isSkill
+                ? extractSkillDocumentation(filepath)
+                : (0, node_fs_1.readFileSync)(filepath, 'utf-8');
+            // 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.invokeRolesBoot = invokeRolesBoot;
+//# sourceMappingURL=invokeRolesBoot.js.map

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

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

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

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import { RoleRegistry } from '../sdk';
+/**
+ * .what = adds the "roles link" subcommand to the CLI
+ * .why = creates .agent/ directory structure and links role resources
+ * .how = findserts standard readmes and symlinks briefs and skills
+ */
+export declare const invokeRolesLink: ({ command, registries, }: {
+    command: Command;
+    registries: RoleRegistry[];
+}) => void;

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

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

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

@@ -0,0 +1,117 @@
+"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 invokeRolesLink_1 = require("./invokeRolesLink");
+describe('invokeRolesLink (integration)', () => {
+    (0, test_fns_1.given)('a CLI program with invokeRolesLink registered', () => {
+        const testDir = (0, node_path_1.resolve)(__dirname, './.temp/invokeRolesLink');
+        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');
+            // Create mock skills directory
+            const skillsDir = (0, node_path_1.resolve)(testDir, 'test-skills');
+            (0, node_fs_1.mkdirSync)(skillsDir, { recursive: true });
+            // Create mock skill files
+            (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(skillsDir, 'skill1.sh'), '#!/bin/bash\n# Skill 1\necho "test skill 1"');
+            (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(skillsDir, 'skill2.sh'), '#!/bin/bash\n# Skill 2\necho "test skill 2"');
+        });
+        afterAll(() => {
+            process.chdir(originalCwd);
+        });
+        // Create mock registries with a role that has briefs and skills configured
+        const mockRole = new Role_1.Role({
+            slug: 'mechanic',
+            name: 'Mechanic',
+            purpose: 'Test mechanic role',
+            readme: '# Mechanic Role\n\nThis is the mechanic role readme.',
+            traits: [],
+            skills: {
+                dirs: [{ uri: 'test-skills' }],
+                refs: [],
+            },
+            briefs: { dirs: [{ uri: 'test-briefs' }] },
+        });
+        const mockRegistry = new RoleRegistry_1.RoleRegistry({
+            slug: 'test-registry',
+            readme: 'Test readme',
+            roles: [mockRole],
+        });
+        const rolesCommand = new commander_1.Command('roles');
+        const logSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
+        beforeEach(() => {
+            logSpy.mockClear();
+            // Clean up any existing .agent directory
+            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, invokeRolesLink_1.invokeRolesLink)({ command: rolesCommand, registries: [mockRegistry] });
+        (0, test_fns_1.when)('invoked with "link --repo test --role mechanic"', () => {
+            (0, test_fns_1.then)('it should create .agent directory structure and link briefs and skills', async () => {
+                await rolesCommand.parseAsync(['link', '--repo', 'test', '--role', 'mechanic'], {
+                    from: 'user',
+                });
+                // Check that .agent directory structure was created
+                expect((0, node_fs_1.existsSync)((0, node_path_1.resolve)(testDir, '.agent/readme.md'))).toBe(true);
+                expect((0, node_fs_1.existsSync)((0, node_path_1.resolve)(testDir, '.agent/repo=.this/readme.md'))).toBe(true);
+                expect((0, node_fs_1.existsSync)((0, node_path_1.resolve)(testDir, '.agent/repo=test/role=mechanic/readme.md'))).toBe(true);
+                // Check that role readme was created
+                const roleReadmeContent = require('fs').readFileSync((0, node_path_1.resolve)(testDir, '.agent/repo=test/role=mechanic/readme.md'), 'utf-8');
+                expect(roleReadmeContent).toContain('Mechanic Role');
+                // Check that briefs directory symlink was created
+                expect((0, node_fs_1.existsSync)((0, node_path_1.resolve)(testDir, '.agent/repo=test/role=mechanic/briefs/test-briefs'))).toBe(true);
+                // Check that files are accessible through the symlinked briefs directory
+                expect((0, node_fs_1.existsSync)((0, node_path_1.resolve)(testDir, '.agent/repo=test/role=mechanic/briefs/test-briefs/brief1.md'))).toBe(true);
+                expect((0, node_fs_1.existsSync)((0, node_path_1.resolve)(testDir, '.agent/repo=test/role=mechanic/briefs/test-briefs/brief2.md'))).toBe(true);
+                // Check that skills directory symlink was created
+                expect((0, node_fs_1.existsSync)((0, node_path_1.resolve)(testDir, '.agent/repo=test/role=mechanic/skills/test-skills'))).toBe(true);
+                // Check that files are accessible through the symlinked skills directory
+                expect((0, node_fs_1.existsSync)((0, node_path_1.resolve)(testDir, '.agent/repo=test/role=mechanic/skills/test-skills/skill1.sh'))).toBe(true);
+                expect((0, node_fs_1.existsSync)((0, node_path_1.resolve)(testDir, '.agent/repo=test/role=mechanic/skills/test-skills/skill2.sh'))).toBe(true);
+                // Check log output
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('Linked role "mechanic"'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('2 brief(s) linked'));
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('2 skill(s) linked'));
+            });
+        });
+        (0, test_fns_1.when)('invoked with "link" 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(['link', '--role', 'mechanic'], {
+                    from: 'user',
+                }));
+                expect(error?.message).toContain('--repo is required');
+            });
+        });
+        (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)(() => rolesCommand.parseAsync(['link', '--repo', 'test'], {
+                    from: 'user',
+                }));
+                expect(error?.message).toContain('--role is required');
+            });
+        });
+        (0, test_fns_1.when)('invoked with "link --repo test --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)(() => rolesCommand.parseAsync(['link', '--repo', 'test', '--role', 'nonexistent'], {
+                    from: 'user',
+                }));
+                expect(error?.message).toContain('no role named "nonexistent"');
+            });
+        });
+    });
+});
+//# sourceMappingURL=invokeRolesLink.integration.test.js.map

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

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

package/dist/contract/cli/invokeRolesLink.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeRolesLink = 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 getAgentReadmeTemplates_1 = require("../../logic/invoke/getAgentReadmeTemplates");
+const findsertFile_1 = require("../../logic/invoke/link/findsertFile");
+const symlinkResourceDirectories_1 = require("../../logic/invoke/link/symlinkResourceDirectories");
+/**
+ * .what = adds the "roles link" subcommand to the CLI
+ * .why = creates .agent/ directory structure and links role resources
+ * .how = findserts standard readmes and symlinks briefs and skills
+ */
+const invokeRolesLink = ({ command, registries, }) => {
+    command
+        .command('link')
+        .description('link role resources into .agent/ directory structure')
+        .option('--repo <slug>', 'the repository slug for the role')
+        .option('--role <slug>', 'the role to link resources 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;
+        const role = (0, assureFindRole_1.assureFindRole)({ registries, slug: opts.role });
+        console.log(``);
+        console.log(`🔗 Linking role "${role.slug}" from repo "${repoSlug}"...`);
+        console.log(``);
+        // Create .agent directory structure
+        const agentDir = (0, node_path_1.resolve)(process.cwd(), '.agent');
+        const repoThisDir = (0, node_path_1.resolve)(agentDir, 'repo=.this');
+        const repoRoleDir = (0, node_path_1.resolve)(agentDir, `repo=${repoSlug}`, `role=${role.slug}`);
+        (0, node_fs_1.mkdirSync)(agentDir, { recursive: true });
+        (0, node_fs_1.mkdirSync)(repoThisDir, { recursive: true });
+        (0, node_fs_1.mkdirSync)(repoRoleDir, { recursive: true });
+        // Findsert .agent/readme.md
+        (0, findsertFile_1.findsertFile)({
+            path: (0, node_path_1.resolve)(agentDir, 'readme.md'),
+            template: (0, getAgentReadmeTemplates_1.getAgentRootReadmeTemplate)(),
+        });
+        // Findsert .agent/repo=.this/readme.md
+        (0, findsertFile_1.findsertFile)({
+            path: (0, node_path_1.resolve)(repoThisDir, 'readme.md'),
+            template: (0, getAgentReadmeTemplates_1.getAgentRepoThisReadmeTemplate)(),
+        });
+        // Upsert .agent/repo=$repo/role=$role/readme.md
+        if (role.readme) {
+            const roleReadmePath = (0, node_path_1.resolve)(repoRoleDir, 'readme.md');
+            const relativeRoleReadmePath = (0, node_path_1.relative)(process.cwd(), roleReadmePath);
+            (0, node_fs_1.writeFileSync)(roleReadmePath, role.readme, 'utf8');
+            console.log(`  + ${relativeRoleReadmePath} (upserted)`);
+        }
+        // Link briefs if configured
+        const briefsCount = (0, symlinkResourceDirectories_1.symlinkResourceDirectories)({
+            sourceDirs: role.briefs.dirs,
+            targetDir: (0, node_path_1.resolve)(repoRoleDir, 'briefs'),
+            resourceName: 'briefs',
+        });
+        // Link skills if configured
+        const skillsCount = (0, symlinkResourceDirectories_1.symlinkResourceDirectories)({
+            sourceDirs: role.skills.dirs,
+            targetDir: (0, node_path_1.resolve)(repoRoleDir, 'skills'),
+            resourceName: 'skills',
+        });
+        console.log(``);
+        console.log(`🔗 Linked role "${role.slug}" from repo "${repoSlug}"`);
+        if (briefsCount > 0)
+            console.log(`  - ${briefsCount} brief(s) linked`);
+        if (skillsCount > 0)
+            console.log(`  - ${skillsCount} skill(s) linked`);
+        console.log(``);
+    });
+};
+exports.invokeRolesLink = invokeRolesLink;
+//# sourceMappingURL=invokeRolesLink.js.map

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

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

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

@@ -39,15 +39,25 @@ export interface Role {
     /**
      * .what = the skills known by the role
      * .why = declares what the role can do
+     * .how =
+     *   - dirs: directory-based skills (e.g., .sh scripts) for linking/booting
+     *   - refs: programmatic RoleSkill references for execution
      */
-    skills: RoleSkill<any>[];
+    skills: {
+        dirs: {
+            uri: string;
+        }[];
+        refs: 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;
+    briefs: {
+        dirs: {
+            uri: string;
+        }[];
     };
 }
 export declare class Role extends DomainEntity<Role> implements Role {

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

@@ -1 +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"}
+{"version":3,"file":"Role.js","sourceRoot":"","sources":["../../../src/domain/objects/Role.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AAgE9C,MAAa,IAAK,SAAQ,6BAAkB;;AAA5C,oBAEC;AADe,WAAM,GAAG,CAAC,MAAM,CAAU,CAAC"}

package/dist/logic/init/discoverRolePackages.d.ts

@@ -0,0 +1,8 @@
+/**
+ * .what = discovers rhachet role packages from package.json
+ * .why = enables auto-initialization of rhachet.use.ts config
+ * .how = scans dependencies + devDependencies for packages matching `rhachet-roles-*`
+ */
+export declare const discoverRolePackages: (input: {
+    from: string;
+}) => Promise<string[]>;

package/dist/logic/init/discoverRolePackages.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverRolePackages = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+/**
+ * .what = discovers rhachet role packages from package.json
+ * .why = enables auto-initialization of rhachet.use.ts config
+ * .how = scans dependencies + devDependencies for packages matching `rhachet-roles-*`
+ */
+const discoverRolePackages = async (input) => {
+    const root = await (0, rhachet_artifact_git_1.getGitRepoRoot)({ from: input.from });
+    const pkgPath = (0, node_path_1.resolve)(root, 'package.json');
+    const pkg = JSON.parse((0, node_fs_1.readFileSync)(pkgPath, 'utf8'));
+    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+    return Object.keys(allDeps).filter((name) => name.startsWith('rhachet-roles-'));
+};
+exports.discoverRolePackages = discoverRolePackages;
+//# sourceMappingURL=discoverRolePackages.js.map

package/dist/logic/init/discoverRolePackages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discoverRolePackages.js","sourceRoot":"","sources":["../../../src/logic/init/discoverRolePackages.ts"],"names":[],"mappings":";;;AAAA,qCAAuC;AACvC,yCAAoC;AACpC,+DAAsD;AAEtD;;;;GAIG;AACI,MAAM,oBAAoB,GAAG,KAAK,EAAE,KAE1C,EAAqB,EAAE;IACtB,MAAM,IAAI,GAAG,MAAM,IAAA,qCAAc,EAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAA,mBAAO,EAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;IAChE,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC1C,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAClC,CAAC;AACJ,CAAC,CAAC;AAVW,QAAA,oBAAoB,wBAU/B"}

package/dist/logic/init/generateRhachetConfig.d.ts

@@ -0,0 +1,8 @@
+/**
+ * .what = generates rhachet.use.ts config file content
+ * .why = enables auto-initialization from discovered role packages
+ * .how = creates aliased imports and exports for registries and hooks
+ */
+export declare const generateRhachetConfig: (input: {
+    packages: string[];
+}) => string;

package/dist/logic/init/generateRhachetConfig.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateRhachetConfig = void 0;
+/**
+ * .what = converts a package name suffix to PascalCase
+ * .why = generates valid TypeScript identifier suffixes for aliased imports
+ */
+const toPascalCase = (str) => str
+    .split('-')
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join('');
+/**
+ * .what = generates rhachet.use.ts config file content
+ * .why = enables auto-initialization from discovered role packages
+ * .how = creates aliased imports and exports for registries and hooks
+ */
+const generateRhachetConfig = (input) => {
+    // Always use aliased imports for consistency
+    const imports = input.packages
+        .map((pkg) => {
+        const suffix = toPascalCase(pkg.replace('rhachet-roles-', ''));
+        return `import { getRoleRegistry as getRoleRegistry${suffix}, getInvokeHooks as getInvokeHooks${suffix} } from '${pkg}';`;
+    })
+        .join('\n');
+    const registries = input.packages
+        .map((pkg) => `getRoleRegistry${toPascalCase(pkg.replace('rhachet-roles-', ''))}()`)
+        .join(', ');
+    const hooks = input.packages
+        .map((pkg) => `getInvokeHooks${toPascalCase(pkg.replace('rhachet-roles-', ''))}()`)
+        .join(', ');
+    return `import { InvokeHooks, RoleRegistry } from 'rhachet';
+
+${imports}
+
+export const getRoleRegistries = (): RoleRegistry[] => [${registries}];
+export const getInvokeHooks = (): InvokeHooks[] => [${hooks}];
+`;
+};
+exports.generateRhachetConfig = generateRhachetConfig;
+//# sourceMappingURL=generateRhachetConfig.js.map

package/dist/logic/init/generateRhachetConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateRhachetConfig.js","sourceRoot":"","sources":["../../../src/logic/init/generateRhachetConfig.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAM,YAAY,GAAG,CAAC,GAAW,EAAU,EAAE,CAC3C,GAAG;KACA,KAAK,CAAC,GAAG,CAAC;KACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KAC3D,IAAI,CAAC,EAAE,CAAC,CAAC;AAEd;;;;GAIG;AACI,MAAM,qBAAqB,GAAG,CAAC,KAErC,EAAU,EAAE;IACX,6CAA6C;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ;SAC3B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/D,OAAO,8CAA8C,MAAM,qCAAqC,MAAM,YAAY,GAAG,IAAI,CAAC;IAC5H,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ;SAC9B,GAAG,CACF,CAAC,GAAG,EAAE,EAAE,CACN,kBAAkB,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,IAAI,CACxE;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ;SACzB,GAAG,CACF,CAAC,GAAG,EAAE,EAAE,CACN,iBAAiB,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,IAAI,CACvE;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;EAEP,OAAO;;0DAEiD,UAAU;sDACd,KAAK;CAC1D,CAAC;AACF,CAAC,CAAC;AAhCW,QAAA,qBAAqB,yBAgChC"}

package/dist/logic/init/generateRhachetConfig.test.d.ts

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