rhachet 1.16.0 → 1.17.0

package/dist/contract/sdk.d.ts

@@ -3,6 +3,7 @@ export * from '../domain.objects';
 export { genContextStitchTrail } from '../domain.operations/context/genContextStitchTrail';
 export { enrollThread } from '../domain.operations/role/enrollThread';
 export { genRoleSkill } from '../domain.operations/role/genRoleSkill';
+export { getRoleBriefs } from '../domain.operations/role/getRoleBriefs';
 export type { ContextStitchTrail } from '../domain.operations/stitch/withStitchTrail';
 export { genStepImagineViaTemplate } from '../domain.operations/template/genStepImagineViaTemplate';
 export { genTemplate } from '../domain.operations/template/genTemplate';

package/dist/contract/sdk.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.enweaveOneStitcher = exports.genStitchRoute = exports.genStitchFanout = exports.genStitchCycle = exports.genStitchChoice = exports.asStitcherFlat = exports.asStitcher = exports.getStitch = exports.useTemplate = exports.getTemplateVarsFromRoleInherit = exports.getTemplateValFromArtifacts = exports.getTemplatePathByCallerPath = exports.genTemplate = exports.genStepImagineViaTemplate = exports.genRoleSkill = exports.enrollThread = exports.genContextStitchTrail = exports.withImmute = void 0;
+exports.enweaveOneStitcher = exports.genStitchRoute = exports.genStitchFanout = exports.genStitchCycle = exports.genStitchChoice = exports.asStitcherFlat = exports.asStitcher = exports.getStitch = exports.useTemplate = exports.getTemplateVarsFromRoleInherit = exports.getTemplateValFromArtifacts = exports.getTemplatePathByCallerPath = exports.genTemplate = exports.genStepImagineViaTemplate = exports.getRoleBriefs = exports.genRoleSkill = exports.enrollThread = exports.genContextStitchTrail = exports.withImmute = void 0;
 var domain_objects_1 = require("domain-objects");
 Object.defineProperty(exports, "withImmute", { enumerable: true, get: function () { return domain_objects_1.withImmute; } });
 __exportStar(require("../domain.objects"), exports);
@@ -24,6 +24,8 @@ var enrollThread_1 = require("../domain.operations/role/enrollThread");
 Object.defineProperty(exports, "enrollThread", { enumerable: true, get: function () { return enrollThread_1.enrollThread; } });
 var genRoleSkill_1 = require("../domain.operations/role/genRoleSkill");
 Object.defineProperty(exports, "genRoleSkill", { enumerable: true, get: function () { return genRoleSkill_1.genRoleSkill; } });
+var getRoleBriefs_1 = require("../domain.operations/role/getRoleBriefs");
+Object.defineProperty(exports, "getRoleBriefs", { enumerable: true, get: function () { return getRoleBriefs_1.getRoleBriefs; } });
 var genStepImagineViaTemplate_1 = require("../domain.operations/template/genStepImagineViaTemplate");
 Object.defineProperty(exports, "genStepImagineViaTemplate", { enumerable: true, get: function () { return genStepImagineViaTemplate_1.genStepImagineViaTemplate; } });
 var genTemplate_1 = require("../domain.operations/template/genTemplate");

package/dist/contract/sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/contract/sdk.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAA4C;AAAnC,4GAAA,UAAU,OAAA;AAEnB,sDAAoC;AACpC,8FAA6F;AAApF,8HAAA,qBAAqB,OAAA;AAC9B,yEAAwE;AAA/D,4GAAA,YAAY,OAAA;AACrB,yEAAwE;AAA/D,4GAAA,YAAY,OAAA;AAErB,uGAAsG;AAA7F,sIAAA,yBAAyB,OAAA;AAClC,2EAA0E;AAAjE,0GAAA,WAAW,OAAA;AACpB,2GAA0G;AAAjG,0IAAA,2BAA2B,OAAA;AACpC,2GAA0G;AAAjG,0IAAA,2BAA2B,OAAA;AACpC,iHAAgH;AAAvG,gJAAA,8BAA8B,OAAA;AACvC,2EAA0E;AAAjE,0GAAA,WAAW,OAAA;AACpB,qEAAoE;AAA3D,sGAAA,SAAS,OAAA;AAClB,8EAA6E;AAApE,wGAAA,UAAU,OAAA;AACnB,sFAAqF;AAA5E,gHAAA,cAAc,OAAA;AACvB,wFAAuF;AAA9E,kHAAA,eAAe,OAAA;AACxB,sFAAqF;AAA5E,gHAAA,cAAc,OAAA;AACvB,wFAAuF;AAA9E,kHAAA,eAAe,OAAA;AACxB,sFAAqF;AAA5E,gHAAA,cAAc,OAAA;AACvB,sFAAqF;AAA5E,wHAAA,kBAAkB,OAAA"}
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/contract/sdk.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAA4C;AAAnC,4GAAA,UAAU,OAAA;AAEnB,sDAAoC;AACpC,8FAA6F;AAApF,8HAAA,qBAAqB,OAAA;AAC9B,yEAAwE;AAA/D,4GAAA,YAAY,OAAA;AACrB,yEAAwE;AAA/D,4GAAA,YAAY,OAAA;AACrB,2EAA0E;AAAjE,8GAAA,aAAa,OAAA;AAEtB,uGAAsG;AAA7F,sIAAA,yBAAyB,OAAA;AAClC,2EAA0E;AAAjE,0GAAA,WAAW,OAAA;AACpB,2GAA0G;AAAjG,0IAAA,2BAA2B,OAAA;AACpC,2GAA0G;AAAjG,0IAAA,2BAA2B,OAAA;AACpC,iHAAgH;AAAvG,gJAAA,8BAA8B,OAAA;AACvC,2EAA0E;AAAjE,0GAAA,WAAW,OAAA;AACpB,qEAAoE;AAA3D,sGAAA,SAAS,OAAA;AAClB,8EAA6E;AAApE,wGAAA,UAAU,OAAA;AACnB,sFAAqF;AAA5E,gHAAA,cAAc,OAAA;AACvB,wFAAuF;AAA9E,kHAAA,eAAe,OAAA;AACxB,sFAAqF;AAA5E,gHAAA,cAAc,OAAA;AACvB,wFAAuF;AAA9E,kHAAA,eAAe,OAAA;AACxB,sFAAqF;AAA5E,gHAAA,cAAc,OAAA;AACvB,sFAAqF;AAA5E,wHAAA,kBAAkB,OAAA"}

package/dist/domain.operations/role/getRoleBriefs.d.ts

@@ -0,0 +1,24 @@
+import type { Artifact } from 'rhachet-artifact';
+import { type GitFile } from 'rhachet-artifact-git';
+/**
+ * .what = finds and returns briefs from a linked role directory as lazy-loadable artifacts
+ * .why = enables role composition by allowing procedures to programmatically access briefs
+ *
+ * .note = this procedure looks into `.agent/*` directories for linked roles.
+ *         if you just wrote a brief in the repo the role is defined in,
+ *         you must run `npm run build && npx rhachet roles link` before it can be used.
+ */
+export declare const getRoleBriefs: (input: {
+    by: {
+        role: {
+            name: string;
+        };
+        repo?: {
+            name: string;
+        };
+        briefs: {
+            name?: string[];
+            glob?: string;
+        };
+    };
+}) => Promise<Artifact<typeof GitFile>[]>;

package/dist/domain.operations/role/getRoleBriefs.js

@@ -0,0 +1,95 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRoleBriefs = void 0;
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const helpful_errors_1 = require("helpful-errors");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * .what = finds and returns briefs from a linked role directory as lazy-loadable artifacts
+ * .why = enables role composition by allowing procedures to programmatically access briefs
+ *
+ * .note = this procedure looks into `.agent/*` directories for linked roles.
+ *         if you just wrote a brief in the repo the role is defined in,
+ *         you must run `npm run build && npx rhachet roles link` before it can be used.
+ */
+const getRoleBriefs = async (input) => {
+    // resolve agent directory
+    const dirAgent = (0, node_path_1.resolve)(process.cwd(), '.agent');
+    if (!(0, node_fs_1.existsSync)(dirAgent))
+        throw new helpful_errors_1.BadRequestError('no .agent directory found. did you forget to `npx rhachet roles link`?');
+    // scan for repo directories
+    const dirsRepo = (0, node_fs_1.readdirSync)(dirAgent)
+        .filter((d) => d.startsWith('repo='))
+        .map((d) => ({ slug: d.replace('repo=', ''), path: (0, node_path_1.resolve)(dirAgent, d) }));
+    const rolesMatching = [];
+    for (const dirRepo of dirsRepo) {
+        // filter by repo if specified
+        if (input.by.repo?.name && dirRepo.slug !== input.by.repo.name)
+            continue;
+        // scan for role directories matching the requested name
+        const dirsRole = (0, node_fs_1.readdirSync)(dirRepo.path)
+            .filter((d) => d.startsWith('role='))
+            .filter((d) => d.replace('role=', '') === input.by.role.name);
+        // collect matching roles
+        for (const dirRole of dirsRole) {
+            const pathRole = (0, node_path_1.resolve)(dirRepo.path, dirRole);
+            rolesMatching.push({
+                slugRepo: dirRepo.slug,
+                slugRole: input.by.role.name,
+                pathRole,
+                pathBriefs: (0, node_path_1.resolve)(pathRole, 'briefs'),
+            });
+        }
+    }
+    // reject if no matching role found
+    if (rolesMatching.length === 0)
+        throw new helpful_errors_1.BadRequestError(`role "${input.by.role.name}" not found in .agent/ directory. did you forget to \`npx rhachet roles link --role ${input.by.role.name}\`?`);
+    // reject if multiple roles match without disambiguation
+    if (rolesMatching.length > 1) {
+        const locations = rolesMatching
+            .map((r) => `  - repo=${r.slugRepo}`)
+            .join('\n');
+        throw new helpful_errors_1.BadRequestError(`multiple roles found with name "${input.by.role.name}":\n${locations}\n\nuse by.repo.name to disambiguate`);
+    }
+    // extract the single matching role
+    const roleLinked = rolesMatching[0];
+    // reject if briefs directory doesn't exist
+    if (!(0, node_fs_1.existsSync)(roleLinked.pathBriefs))
+        throw new helpful_errors_1.BadRequestError(`briefs directory not found for role "${roleLinked.slugRole}" in repo="${roleLinked.slugRepo}". ` +
+            `did you forget to \`npx rhachet roles link --role ${roleLinked.slugRole}\`? ` +
+            `(if you just wrote a brief, run: npm run build && npx rhachet roles link)`);
+    // match briefs by name or glob
+    const pathsBrief = [];
+    if (input.by.briefs.name?.length) {
+        // exact name matching
+        for (const name of input.by.briefs.name) {
+            const pathsMatching = await (0, fast_glob_1.default)(`**/${name}*`, {
+                cwd: roleLinked.pathBriefs,
+                absolute: true,
+                onlyFiles: true,
+            });
+            if (pathsMatching.length === 0)
+                throw new helpful_errors_1.BadRequestError(`brief "${name}" not found in role "${roleLinked.slugRole}" (repo="${roleLinked.slugRepo}")`);
+            pathsBrief.push(...pathsMatching);
+        }
+    }
+    else if (input.by.briefs.glob) {
+        // glob pattern matching
+        const pathsMatching = await (0, fast_glob_1.default)(input.by.briefs.glob, {
+            cwd: roleLinked.pathBriefs,
+            absolute: true,
+            onlyFiles: true,
+        });
+        pathsBrief.push(...pathsMatching);
+    }
+    // dedupe and create artifacts
+    const pathsUnique = [...new Set(pathsBrief)];
+    return pathsUnique.map((uri) => (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri }));
+};
+exports.getRoleBriefs = getRoleBriefs;
+//# sourceMappingURL=getRoleBriefs.js.map

package/dist/domain.operations/role/getRoleBriefs.js.map

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

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet",
   "author": "ehmpathy",
   "description": "A framework for reliable, thorough thought. Weave threads of thought via stitches.",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "repository": "ehmpathy/rhachet",
   "homepage": "https://github.com/ehmpathy/rhachet",
   "keywords": [
@@ -92,7 +92,7 @@
     "rhachet": "1.15.2",
     "rhachet-roles-bhrain": "0.5.5",
     "rhachet-roles-bhuild": "0.4.2",
-    "rhachet-roles-ehmpathy": "1.15.12",
+    "rhachet-roles-ehmpathy": "1.15.21",
     "test-fns": "1.7.0",
     "tsc-alias": "1.8.10",
     "tsx": "~4.20.6",