rhachet 1.1.0 → 1.3.0

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/objects/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,iDAA+B;AAC/B,gDAA8B;AAC9B,6CAA2B;AAC3B,iDAA+B;AAC/B,gDAA8B;AAC9B,mDAAiC;AACjC,+CAA6B;AAC7B,gDAA8B;AAC9B,2CAAyB;AACzB,4CAA0B;AAC1B,2BAA2B;AAC3B,4BAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/objects/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,iDAA+B;AAC/B,gDAA8B;AAC9B,6CAA2B;AAC3B,iDAA+B;AAC/B,gDAA8B;AAC9B,mDAAiC;AACjC,+CAA6B;AAC7B,gDAA8B;AAC9B,2CAAyB;AACzB,4CAA0B;AAC1B,2BAA2B;AAC3B,4BAA4B;AAE5B,yCAAuB;AACvB,gDAA8B;AAC9B,iDAA+B;AAC/B,8CAA4B;AAC5B,uDAAqC;AACrC,8CAA4B;AAE5B,6CAA2B"}

package/dist/logic/invoke/assureFindRole.d.ts

@@ -0,0 +1,10 @@
+import { Role } from '../../domain/objects/Role';
+import { RoleRegistry } from '../../domain/objects/RoleRegistry';
+/**
+ * .what = finds the first matching role across registries
+ * .why = ensures there is exactly one role match; fails if ambiguous or missing
+ */
+export declare const assureFindRole: ({ registries, slug, }: {
+    registries: RoleRegistry[];
+    slug: string;
+}) => Role;

package/dist/logic/invoke/assureFindRole.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assureFindRole = void 0;
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * .what = finds the first matching role across registries
+ * .why = ensures there is exactly one role match; fails if ambiguous or missing
+ */
+const assureFindRole = ({ registries, slug, }) => {
+    const matches = registries
+        .flatMap((r) => r.roles)
+        .filter((r) => r.slug === slug);
+    if (matches.length === 0)
+        helpful_errors_1.BadRequestError.throw(`no role named "${slug}" found in any registry`, {
+            slug,
+        });
+    if (matches.length > 1)
+        helpful_errors_1.BadRequestError.throw(`multiple roles named "${slug}" found across registries`, { slug });
+    return matches[0];
+};
+exports.assureFindRole = assureFindRole;
+//# sourceMappingURL=assureFindRole.js.map

package/dist/logic/invoke/assureFindRole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assureFindRole.js","sourceRoot":"","sources":["../../../src/logic/invoke/assureFindRole.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAKjD;;;GAGG;AACI,MAAM,cAAc,GAAG,CAAC,EAC7B,UAAU,EACV,IAAI,GAIL,EAAQ,EAAE;IACT,MAAM,OAAO,GAAG,UAAU;SACvB,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;SACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAClC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QACtB,gCAAe,CAAC,KAAK,CAAC,kBAAkB,IAAI,yBAAyB,EAAE;YACrE,IAAI;SACL,CAAC,CAAC;IACL,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QACpB,gCAAe,CAAC,KAAK,CACnB,yBAAyB,IAAI,2BAA2B,EACxD,EAAE,IAAI,EAAE,CACT,CAAC;IACJ,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC;AACrB,CAAC,CAAC;AApBW,QAAA,cAAc,kBAoBzB"}

package/dist/logic/invoke/assureUniqueRoles.d.ts

@@ -0,0 +1,5 @@
+import { RoleRegistry } from '../../domain/objects';
+/**
+ * .what = ensure we fail fast upon duplicate role.slugs across registries
+ */
+export declare const assureUniqueRoles: (registries: RoleRegistry[]) => void;

package/dist/logic/invoke/assureUniqueRoles.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assureUniqueRoles = void 0;
+/**
+ * .what = ensure we fail fast upon duplicate role.slugs across registries
+ */
+const assureUniqueRoles = (registries) => {
+    const seen = new Map(); // slug → registry.slug
+    for (const registry of registries) {
+        for (const role of registry.roles) {
+            if (seen.has(role.slug)) {
+                throw new Error(`❌ duplicate role.slug "${role.slug}" found in registries: "${seen.get(role.slug)}" and "${registry.slug}"`);
+            }
+            seen.set(role.slug, registry.slug);
+        }
+    }
+};
+exports.assureUniqueRoles = assureUniqueRoles;
+//# sourceMappingURL=assureUniqueRoles.js.map

package/dist/logic/invoke/assureUniqueRoles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assureUniqueRoles.js","sourceRoot":"","sources":["../../../src/logic/invoke/assureUniqueRoles.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACI,MAAM,iBAAiB,GAAG,CAAC,UAA0B,EAAQ,EAAE;IACpE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,uBAAuB;IAC/D,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CACb,0BACE,IAAI,CAAC,IACP,2BAA2B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAC5C,QAAQ,CAAC,IACX,GAAG,CACJ,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAhBW,QAAA,iBAAiB,qBAgB5B"}

package/dist/logic/invoke/getSkillContext.d.ts

@@ -0,0 +1,17 @@
+import { PickOne } from 'type-fns';
+import { RoleSkillContextGetter } from '../../domain/objects/RoleSkillArgGetter';
+/**
+ * .what = hydrates skill context using either passin or lookup mode
+ * .why =
+ *   - supports flexible skill execution via CLI, tests, or runtime composition
+ *   - ensures all required env inputs are present and valid
+ */
+export declare const getSkillContext: <TOutput extends import("simple-log-methods").ContextLogTrail & import("../stitch/withStitchTrail").ContextStitchTrail, TVars extends Record<string, any>>(input: {
+    getter: RoleSkillContextGetter<TOutput, TVars>;
+    from: PickOne<{
+        passin: TVars;
+        lookup: {
+            env: Record<string, string | undefined>;
+        };
+    }>;
+}) => Promise<TOutput>;

package/dist/logic/invoke/getSkillContext.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSkillContext = void 0;
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * .what = hydrates skill context using either passin or lookup mode
+ * .why =
+ *   - supports flexible skill execution via CLI, tests, or runtime composition
+ *   - ensures all required env inputs are present and valid
+ */
+const getSkillContext = async (input) => {
+    const { getter, from } = input;
+    // support passin mode: directly provided context vars
+    if ('passin' in from) {
+        if (!getter.assess(from.passin)) {
+            helpful_errors_1.BadRequestError.throw('from.passin was assessed to have incorrect shape', {
+                from,
+            });
+        }
+        return await getter.instantiate(from.passin);
+    }
+    // support lookup mode: pull from env vars
+    if ('lookup' in from) {
+        const env = from.lookup.env;
+        const collected = {};
+        for (const [key, spec] of Object.entries(getter.lookup)) {
+            const val = env[spec.envar];
+            if (val === undefined) {
+                helpful_errors_1.BadRequestError.throw(`missing required env var ${spec.envar}`, {
+                    key,
+                    spec,
+                });
+            }
+            collected[key] = val;
+        }
+        if (!getter.assess(collected))
+            helpful_errors_1.UnexpectedCodePathError.throw('from.lookup -> collected was assessed to have incorrect shape. this should not be possible', { from: { env: true }, collected: Object.keys(collected) });
+        return await getter.instantiate(collected);
+    }
+    // 🛑 should be unreachable (guard for future extension)
+    throw new helpful_errors_1.UnexpectedCodePathError('unsupported context.from', { input });
+};
+exports.getSkillContext = getSkillContext;
+//# sourceMappingURL=getSkillContext.js.map

package/dist/logic/invoke/getSkillContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSkillContext.js","sourceRoot":"","sources":["../../../src/logic/invoke/getSkillContext.ts"],"names":[],"mappings":";;;AAAA,mDAA0E;AAM1E;;;;;GAKG;AACI,MAAM,eAAe,GAAG,KAAK,EAGlC,KAMD,EAAoB,EAAE;IACrB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAE/B,sDAAsD;IACtD,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,gCAAe,CAAC,KAAK,CACnB,kDAAkD,EAClD;gBACE,IAAI;aACL,CACF,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,0CAA0C;IAC1C,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;QAC5B,MAAM,SAAS,GAA2B,EAAE,CAAC;QAE7C,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,gCAAe,CAAC,KAAK,CAAC,4BAA4B,IAAI,CAAC,KAAK,EAAE,EAAE;oBAC9D,GAAG;oBACH,IAAI;iBACL,CAAC,CAAC;YACL,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;YAC3B,wCAAuB,CAAC,KAAK,CAC3B,4FAA4F,EAC5F,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAC3D,CAAC;QAEJ,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,wDAAwD;IACxD,MAAM,IAAI,wCAAuB,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3E,CAAC,CAAC;AApDW,QAAA,eAAe,mBAoD1B"}

package/dist/logic/invoke/getSkillContext.test.d.ts

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

package/dist/logic/invoke/getSkillContext.test.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const helpful_errors_1 = require("helpful-errors");
+const test_fns_1 = require("test-fns");
+const objects_1 = require("../../domain/objects");
+const getSkillContext_1 = require("./getSkillContext");
+const getterExample = objects_1.RoleSkillContextGetter.build({
+    lookup: {
+        openaiApiKey: {
+            source: 'process.env',
+            desc: 'your OpenAI key',
+            envar: 'OPENAI_API_KEY',
+            type: 'string',
+        },
+    },
+    assess: (input) => typeof input?.openaiApiKey === 'string',
+    instantiate: (input) => ({
+        key: input.openaiApiKey,
+    }),
+});
+describe('getSkillContext', () => {
+    (0, test_fns_1.given)('a valid context getter requiring OPENAI_API_KEY', () => {
+        const getter = getterExample.clone();
+        (0, test_fns_1.when)('called with passin: { openaiApiKey: "sk-abc" }', () => {
+            (0, test_fns_1.then)('it should return the expected context', async () => {
+                const result = await (0, getSkillContext_1.getSkillContext)({
+                    getter,
+                    from: { passin: { openaiApiKey: 'sk-abc' } },
+                });
+                expect(result).toEqual({ key: 'sk-abc' });
+            });
+        });
+        (0, test_fns_1.when)('called with passin: { wrongKey: "oops" }', () => {
+            (0, test_fns_1.then)('it should throw BadRequestError', async () => {
+                const error = await (0, test_fns_1.getError)(async () => (0, getSkillContext_1.getSkillContext)({
+                    getter,
+                    from: { passin: { wrongKey: 'oops' } },
+                }));
+                expect(error).toBeInstanceOf(helpful_errors_1.BadRequestError);
+            });
+        });
+        (0, test_fns_1.when)('called with env: { OPENAI_API_KEY: "sk-env" }', () => {
+            (0, test_fns_1.then)('it should return the expected context', async () => {
+                const result = await (0, getSkillContext_1.getSkillContext)({
+                    getter,
+                    from: { lookup: { env: { OPENAI_API_KEY: 'sk-env' } } },
+                });
+                expect(result).toEqual({ key: 'sk-env' });
+            });
+        });
+        (0, test_fns_1.when)('called with env: {} (missing key)', () => {
+            (0, test_fns_1.then)('it should throw BadRequestError', async () => {
+                const error = await (0, test_fns_1.getError)(async () => (0, getSkillContext_1.getSkillContext)({
+                    getter,
+                    from: { lookup: { env: {} } },
+                }));
+                expect(error).toBeInstanceOf(helpful_errors_1.BadRequestError);
+            });
+        });
+    });
+    (0, test_fns_1.given)('a rejecting getter that fails all assess checks', () => {
+        const getter = getterExample.clone({
+            assess: (() => false),
+        });
+        (0, test_fns_1.when)('called with env: { OPENAI_API_KEY: "sk-reject" }', () => {
+            (0, test_fns_1.then)('it should throw UnexpectedCodePathError', async () => {
+                const error = await (0, test_fns_1.getError)(async () => (0, getSkillContext_1.getSkillContext)({
+                    getter,
+                    from: { lookup: { env: { OPENAI_API_KEY: 'sk-reject' } } },
+                }));
+                expect(error).toBeInstanceOf(helpful_errors_1.UnexpectedCodePathError);
+            });
+        });
+        (0, test_fns_1.when)('called with passin: { openaiApiKey: "sk-reject" }', () => {
+            (0, test_fns_1.then)('it should throw BadRequestError', async () => {
+                const error = await (0, test_fns_1.getError)(async () => (0, getSkillContext_1.getSkillContext)({
+                    getter,
+                    from: { passin: { openaiApiKey: 'sk-reject' } },
+                }));
+                expect(error).toBeInstanceOf(helpful_errors_1.BadRequestError);
+            });
+        });
+    });
+});
+//# sourceMappingURL=getSkillContext.test.js.map

package/dist/logic/invoke/getSkillContext.test.js.map

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

package/dist/logic/invoke/getSkillThread.test.d.ts

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

package/dist/logic/invoke/getSkillThread.test.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const helpful_errors_1 = require("helpful-errors");
+const test_fns_1 = require("test-fns");
+const RoleSkillArgGetter_1 = require("../../domain/objects/RoleSkillArgGetter");
+const genThread_1 = require("../thread/genThread");
+const getSkillThreads_1 = require("./getSkillThreads");
+const getterExample = RoleSkillArgGetter_1.RoleSkillThreadsGetter.build({
+    lookup: {
+        target: {
+            source: 'process.argv',
+            desc: 'target file or dir',
+            char: 't',
+            type: 'string',
+        },
+    },
+    assess: (input) => typeof input?.target === 'string' && typeof input?.ask === 'string',
+    instantiate: (input) => ({
+        caller: (0, genThread_1.genThread)({ role: 'caller', target: input.target }),
+    }),
+});
+describe('getSkillThreads', () => {
+    (0, test_fns_1.given)('a valid threads getter for { target, ask }', () => {
+        const getter = getterExample.clone();
+        (0, test_fns_1.when)('called with passin: { target: "src/index.ts", ask: "describe" }', () => {
+            (0, test_fns_1.then)('it should return the expected caller thread', async () => {
+                const result = await (0, getSkillThreads_1.getSkillThreads)({
+                    getter,
+                    from: { passin: { target: 'src/index.ts', ask: 'describe' } },
+                });
+                expect(result).toEqual({
+                    caller: (0, genThread_1.genThread)({ role: 'caller', target: 'src/index.ts' }),
+                });
+            });
+        });
+        (0, test_fns_1.when)('called with passin: { bad: true }', () => {
+            (0, test_fns_1.then)('it should throw BadRequestError', async () => {
+                const error = await (0, test_fns_1.getError)(() => (0, getSkillThreads_1.getSkillThreads)({
+                    getter,
+                    from: { passin: { bad: true } },
+                }));
+                expect(error).toBeInstanceOf(helpful_errors_1.BadRequestError);
+            });
+        });
+        (0, test_fns_1.when)('called with argv: { target: "src/main.ts", ask: "go now" }', () => {
+            (0, test_fns_1.then)('it should return the expected caller thread', async () => {
+                const result = await (0, getSkillThreads_1.getSkillThreads)({
+                    getter,
+                    from: { lookup: { argv: { target: 'src/main.ts', ask: 'go now' } } },
+                });
+                expect(result).toEqual({
+                    caller: (0, genThread_1.genThread)({ role: 'caller', target: 'src/main.ts' }),
+                });
+            });
+        });
+        (0, test_fns_1.when)('called with argv: { t: "src/main.ts", ask: "run this" }', () => {
+            (0, test_fns_1.then)('it should return the expected caller thread', async () => {
+                const result = await (0, getSkillThreads_1.getSkillThreads)({
+                    getter,
+                    from: { lookup: { argv: { t: 'src/main.ts', ask: 'run this' } } },
+                });
+                expect(result).toEqual({
+                    caller: (0, genThread_1.genThread)({ role: 'caller', target: 'src/main.ts' }),
+                });
+            });
+        });
+        (0, test_fns_1.when)('called with argv: { ask: "missing target" }', () => {
+            (0, test_fns_1.then)('it should throw BadRequestError for missing target', async () => {
+                const error = await (0, test_fns_1.getError)(() => (0, getSkillThreads_1.getSkillThreads)({
+                    getter,
+                    from: { lookup: { argv: { ask: 'missing target' } } },
+                }));
+                expect(error).toBeInstanceOf(helpful_errors_1.BadRequestError);
+            });
+        });
+        (0, test_fns_1.when)('called with argv: { target: "src/x.ts" } (missing ask)', () => {
+            (0, test_fns_1.then)('it should throw BadRequestError for missing ask', async () => {
+                const error = await (0, test_fns_1.getError)(() => (0, getSkillThreads_1.getSkillThreads)({
+                    getter,
+                    from: { lookup: { argv: { target: 'src/x.ts' } } },
+                }));
+                expect(error).toBeInstanceOf(helpful_errors_1.BadRequestError);
+                expect(error.message).toMatch(/missing.*ask/i);
+            });
+        });
+    });
+    (0, test_fns_1.given)('a rejecting getter that fails all assess checks', () => {
+        const getter = getterExample.clone({
+            assess: (() => false),
+        });
+        (0, test_fns_1.when)('called with argv: { target: "src/any.ts", ask: "still fails" }', () => {
+            (0, test_fns_1.then)('it should throw UnexpectedCodePathError', async () => {
+                const error = await (0, test_fns_1.getError)(() => (0, getSkillThreads_1.getSkillThreads)({
+                    getter,
+                    from: {
+                        lookup: {
+                            argv: { target: 'src/any.ts', ask: 'still fails' },
+                        },
+                    },
+                }));
+                expect(error).toBeInstanceOf(helpful_errors_1.UnexpectedCodePathError);
+            });
+        });
+        (0, test_fns_1.when)('called with passin: { target: "src/any.ts", ask: "bad input" }', () => {
+            (0, test_fns_1.then)('it should throw BadRequestError', async () => {
+                const error = await (0, test_fns_1.getError)(() => (0, getSkillThreads_1.getSkillThreads)({
+                    getter,
+                    from: { passin: { target: 'src/any.ts', ask: 'bad input' } },
+                }));
+                expect(error).toBeInstanceOf(helpful_errors_1.BadRequestError);
+            });
+        });
+    });
+});
+//# sourceMappingURL=getSkillThread.test.js.map

package/dist/logic/invoke/getSkillThread.test.js.map

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

package/dist/logic/invoke/getSkillThreads.d.ts

@@ -0,0 +1,16 @@
+import { PickOne } from 'type-fns';
+import { Threads } from '../../domain/objects';
+import { RoleSkillThreadsGetter } from '../../domain/objects/RoleSkillArgGetter';
+/**
+ * .what = hydrates skill threads using either passin or lookup mode
+ * .why = enables flexible runtime use from CLI or direct invocation
+ */
+export declare const getSkillThreads: <TOutput extends Threads<any>, TVars extends Record<string, any>>(input: {
+    getter: RoleSkillThreadsGetter<TOutput, TVars>;
+    from: PickOne<{
+        passin: TVars;
+        lookup: {
+            argv: Record<string, string>;
+        };
+    }>;
+}) => Promise<TOutput>;

package/dist/logic/invoke/getSkillThreads.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSkillThreads = void 0;
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * .what = hydrates skill threads using either passin or lookup mode
+ * .why = enables flexible runtime use from CLI or direct invocation
+ */
+const getSkillThreads = async (input) => {
+    const { getter, from } = input;
+    // support passin mode
+    if ('passin' in from) {
+        if (!getter.assess(from.passin))
+            helpful_errors_1.BadRequestError.throw('from.passin was assessed to have incorrect shape', { from });
+        return await getter.instantiate(from.passin);
+    }
+    // support lookup mode
+    if ('lookup' in from) {
+        const argv = from.lookup.argv;
+        // verify that ask was provided; its always required by default
+        const ask = argv.ask;
+        if (!ask)
+            helpful_errors_1.BadRequestError.throw('missing required argument: --ask', { argv });
+        // instantiate the collected input set
+        const collected = { ask };
+        // grab all the requested ones
+        for (const [key, spec] of Object.entries(getter.lookup)) {
+            const val = argv[key] ?? (spec.char ? argv[spec.char] : undefined);
+            if (val === undefined) {
+                helpful_errors_1.BadRequestError.throw(`missing required arg --${key} (-${spec.char})`, {
+                    key,
+                    spec,
+                });
+            }
+            collected[key] = val;
+        }
+        // verify they look right
+        if (!getter.assess(collected))
+            helpful_errors_1.UnexpectedCodePathError.throw('from.lookup -> collected was assessed to have incorrect shape. this should not be possible', { from, collected });
+        // instantiate
+        return await getter.instantiate(collected);
+    }
+    throw new helpful_errors_1.UnexpectedCodePathError('unsupported lookup.from', { input });
+};
+exports.getSkillThreads = getSkillThreads;
+//# sourceMappingURL=getSkillThreads.js.map

package/dist/logic/invoke/getSkillThreads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSkillThreads.js","sourceRoot":"","sources":["../../../src/logic/invoke/getSkillThreads.ts"],"names":[],"mappings":";;;AAAA,mDAA0E;AAM1E;;;GAGG;AACI,MAAM,eAAe,GAAG,KAAK,EAGlC,KAMD,EAAoB,EAAE;IACrB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAE/B,sBAAsB;IACtB,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;YAC7B,gCAAe,CAAC,KAAK,CACnB,kDAAkD,EAClD,EAAE,IAAI,EAAE,CACT,CAAC;QACJ,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,sBAAsB;IACtB,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QAE9B,+DAA+D;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,IAAI,CAAC,GAAG;YACN,gCAAe,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtE,sCAAsC;QACtC,MAAM,SAAS,GAA2B,EAAE,GAAG,EAAE,CAAC;QAElD,8BAA8B;QAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACnE,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,gCAAe,CAAC,KAAK,CAAC,0BAA0B,GAAG,MAAM,IAAI,CAAC,IAAI,GAAG,EAAE;oBACrE,GAAG;oBACH,IAAI;iBACL,CAAC,CAAC;YACL,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QACvB,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;YAC3B,wCAAuB,CAAC,KAAK,CAC3B,4FAA4F,EAC5F,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,CAAC;QAEJ,cAAc;QACd,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,IAAI,wCAAuB,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1E,CAAC,CAAC;AA1DW,QAAA,eAAe,mBA0D1B"}

package/dist/logic/role/addRoleTraits.d.ts

@@ -0,0 +1,18 @@
+import { Artifact } from 'rhachet-artifact';
+import { GitFile } from 'rhachet-artifact-git';
+import { PickAny } from 'type-fns';
+import { Thread } from '../../domain/objects';
+import { RoleContext, RoleContextTrait } from '../../domain/objects/RoleContext';
+/**
+ * .what = injects new RoleTrait(s) into a thread's context
+ * .why = enables dynamic role adaptation from inline traits or artifact sources
+ */
+export declare const addRoleTraits: <TThread extends Thread<{
+    inherit: RoleContext<any, any>['inherit'];
+}>>({ thread, from, }: {
+    thread: TThread;
+    from: PickAny<{
+        traits: RoleContextTrait[];
+        artifacts: Artifact<typeof GitFile>[];
+    }>;
+}) => Promise<TThread>;

package/dist/logic/role/addRoleTraits.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addRoleTraits = void 0;
+/**
+ * .what = injects new RoleTrait(s) into a thread's context
+ * .why = enables dynamic role adaptation from inline traits or artifact sources
+ */
+const addRoleTraits = async ({ thread, from, }) => {
+    const parsed = [];
+    if ('traits' in from && from.traits) {
+        parsed.push(...from.traits);
+    }
+    if ('artifacts' in from && from.artifacts) {
+        for (const artifact of from.artifacts) {
+            const file = await artifact.get();
+            if (!file)
+                throw new Error(`trait file not found: ${artifact.ref.uri}`);
+            parsed.push({ content: file.content });
+        }
+    }
+    return {
+        ...thread,
+        context: {
+            ...thread.context,
+            inherit: {
+                ...thread.context.inherit,
+                traits: [...(thread.context.inherit.traits ?? []), ...parsed],
+            },
+        },
+    };
+};
+exports.addRoleTraits = addRoleTraits;
+//# sourceMappingURL=addRoleTraits.js.map

package/dist/logic/role/addRoleTraits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addRoleTraits.js","sourceRoot":"","sources":["../../../src/logic/role/addRoleTraits.ts"],"names":[],"mappings":";;;AAUA;;;GAGG;AACI,MAAM,aAAa,GAAG,KAAK,EAEhC,EACA,MAAM,EACN,IAAI,GAOL,EAAoB,EAAE;IACrB,MAAM,MAAM,GAAuB,EAAE,CAAC;IAEtC,IAAI,QAAQ,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,WAAW,IAAI,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1C,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;YACxE,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,OAAO,EAAE;YACP,GAAG,MAAM,CAAC,OAAO;YACjB,OAAO,EAAE;gBACP,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO;gBACzB,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC;aAC9D;SACF;KACF,CAAC;AACJ,CAAC,CAAC;AApCW,QAAA,aAAa,iBAoCxB"}

package/dist/logic/role/addRoleTraits.test.d.ts

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

package/dist/logic/role/addRoleTraits.test.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const as_procedure_1 = require("as-procedure");
+const helpful_errors_1 = require("helpful-errors");
+const test_fns_1 = require("test-fns");
+const addRoleTraits_1 = require("./addRoleTraits");
+const makeFakeArtifact = (content) => ({
+    ref: { uri: `/fake/${Math.random()}` },
+    get: (0, as_procedure_1.withExpectOutput)(async () => ({
+        uri: '/fake/file.md',
+        hash: 'hash123',
+        content,
+    })),
+    set: () => helpful_errors_1.UnexpectedCodePathError.throw('todo'),
+    del: () => helpful_errors_1.UnexpectedCodePathError.throw('todo'),
+});
+describe('addRoleTraits', () => {
+    (0, test_fns_1.given)('a thread with empty traits', () => {
+        const thread = {
+            context: { inherit: { traits: [], skills: [] } },
+            stitches: [],
+        };
+        (0, test_fns_1.when)('adding traits from direct RoleTrait content', () => {
+            const traits = [
+                { content: 'treat consistency as top priority' },
+                { content: 'prefer ubiquitous language' },
+            ];
+            (0, test_fns_1.then)('should append those traits to the context', async () => {
+                const updated = await (0, addRoleTraits_1.addRoleTraits)({ thread, from: { traits } });
+                expect(updated.context.inherit.traits).toEqual(traits);
+            });
+        });
+        (0, test_fns_1.when)('adding traits from GitFile artifacts', () => {
+            const artifacts = [
+                makeFakeArtifact('treat consistency as top priority'),
+                makeFakeArtifact('prefer given/when/then structure'),
+            ];
+            (0, test_fns_1.then)('should extract and append traits from files', async () => {
+                const updated = await (0, addRoleTraits_1.addRoleTraits)({ thread, from: { artifacts } });
+                expect(updated.context.inherit.traits).toEqual([
+                    { content: 'treat consistency as top priority' },
+                    { content: 'prefer given/when/then structure' },
+                ]);
+            });
+        });
+        (0, test_fns_1.when)('adding traits from both RoleTrait and Artifact', () => {
+            const traits = [{ content: 'always test behavior' }];
+            const artifacts = [makeFakeArtifact('capture domain terms')];
+            (0, test_fns_1.then)('should merge both sources into context.inherit.traits', async () => {
+                const updated = await (0, addRoleTraits_1.addRoleTraits)({
+                    thread,
+                    from: { traits, artifacts },
+                });
+                expect(updated.context.inherit.traits).toEqual([
+                    { content: 'always test behavior' },
+                    { content: 'capture domain terms' },
+                ]);
+            });
+        });
+    });
+    (0, test_fns_1.given)('a thread with pre-existing traits', () => {
+        const thread = {
+            context: {
+                inherit: {
+                    traits: [{ content: 'existing trait' }],
+                    skills: [],
+                },
+            },
+            stitches: [],
+        };
+        (0, test_fns_1.when)('adding new traits via artifact', () => {
+            const artifacts = [makeFakeArtifact('new trait added')];
+            (0, test_fns_1.then)('should preserve existing traits and append new ones', async () => {
+                const updated = await (0, addRoleTraits_1.addRoleTraits)({ thread, from: { artifacts } });
+                expect(updated.context.inherit.traits).toEqual([
+                    { content: 'existing trait' },
+                    { content: 'new trait added' },
+                ]);
+            });
+        });
+    });
+    (0, test_fns_1.given)('an invalid input with neither traits nor artifacts', () => {
+        const thread = {
+            context: { inherit: { traits: [], skills: [] } },
+            stitches: [],
+        };
+        (0, test_fns_1.then)('should fail at type level', async () => {
+            // @ts-expect-error — atleast one key in from is required
+            await (0, addRoleTraits_1.addRoleTraits)({ thread, from: {} });
+        });
+    });
+});
+//# sourceMappingURL=addRoleTraits.test.js.map

package/dist/logic/role/addRoleTraits.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addRoleTraits.test.js","sourceRoot":"","sources":["../../../src/logic/role/addRoleTraits.test.ts"],"names":[],"mappings":";;AAAA,+CAAgD;AAChD,mDAAyD;AAGzD,uCAA6C;AAG7C,mDAAgD;AAEhD,MAAM,gBAAgB,GAAG,CAAC,OAAe,EAA4B,EAAE,CAAC,CAAC;IACvE,GAAG,EAAE,EAAE,GAAG,EAAE,SAAS,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE;IACtC,GAAG,EAAE,IAAA,+BAAgB,EAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACjC,GAAG,EAAE,eAAe;QACpB,IAAI,EAAE,SAAS;QACf,OAAO;KACR,CAAC,CAAC;IACH,GAAG,EAAE,GAAG,EAAE,CAAC,wCAAuB,CAAC,KAAK,CAAC,MAAM,CAAC;IAChD,GAAG,EAAE,GAAG,EAAE,CAAC,wCAAuB,CAAC,KAAK,CAAC,MAAM,CAAC;CACjD,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAA,gBAAK,EAAC,4BAA4B,EAAE,GAAG,EAAE;QACvC,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE;YAChD,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,IAAA,eAAI,EAAC,6CAA6C,EAAE,GAAG,EAAE;YACvD,MAAM,MAAM,GAAuB;gBACjC,EAAE,OAAO,EAAE,mCAAmC,EAAE;gBAChD,EAAE,OAAO,EAAE,4BAA4B,EAAE;aAC1C,CAAC;YAEF,IAAA,eAAI,EAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;gBAC3D,MAAM,OAAO,GAAG,MAAM,IAAA,6BAAa,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBAClE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACzD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,sCAAsC,EAAE,GAAG,EAAE;YAChD,MAAM,SAAS,GAAG;gBAChB,gBAAgB,CAAC,mCAAmC,CAAC;gBACrD,gBAAgB,CAAC,kCAAkC,CAAC;aACrD,CAAC;YAEF,IAAA,eAAI,EAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;gBAC7D,MAAM,OAAO,GAAG,MAAM,IAAA,6BAAa,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;gBACrE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBAC7C,EAAE,OAAO,EAAE,mCAAmC,EAAE;oBAChD,EAAE,OAAO,EAAE,kCAAkC,EAAE;iBAChD,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,gDAAgD,EAAE,GAAG,EAAE;YAC1D,MAAM,MAAM,GAAuB,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC;YACzE,MAAM,SAAS,GAAG,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,CAAC,CAAC;YAE7D,IAAA,eAAI,EACF,uDAAuD,EACvD,KAAK,IAAI,EAAE;gBACT,MAAM,OAAO,GAAG,MAAM,IAAA,6BAAa,EAAC;oBAClC,MAAM;oBACN,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;iBAC5B,CAAC,CAAC;gBACH,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBAC7C,EAAE,OAAO,EAAE,sBAAsB,EAAE;oBACnC,EAAE,OAAO,EAAE,sBAAsB,EAAE;iBACpC,CAAC,CAAC;YACL,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,gBAAK,EAAC,mCAAmC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG;YACb,OAAO,EAAE;gBACP,OAAO,EAAE;oBACP,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;oBACvC,MAAM,EAAE,EAAE;iBACX;aACF;YACD,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,IAAA,eAAI,EAAC,gCAAgC,EAAE,GAAG,EAAE;YAC1C,MAAM,SAAS,GAAG,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC;YAExD,IAAA,eAAI,EAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;gBACrE,MAAM,OAAO,GAAG,MAAM,IAAA,6BAAa,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;gBACrE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBAC7C,EAAE,OAAO,EAAE,gBAAgB,EAAE;oBAC7B,EAAE,OAAO,EAAE,iBAAiB,EAAE;iBAC/B,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,gBAAK,EAAC,oDAAoD,EAAE,GAAG,EAAE;QAC/D,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE;YAChD,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,IAAA,eAAI,EAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;YAC3C,yDAAyD;YACzD,MAAM,IAAA,6BAAa,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/logic/role/enrollThread.d.ts

@@ -0,0 +1,16 @@
+import { Artifact } from 'rhachet-artifact';
+import { GitFile } from 'rhachet-artifact-git';
+import { Thread } from '../../domain/objects';
+import { RoleContext } from '../../domain/objects/RoleContext';
+/**
+ * .what = creates a thread for a given role, with optional inherited traits and skills
+ * .why  = eliminates boilerplate around thread setup, including `as const`, trait/skill injection, and context composition
+ */
+export declare const enrollThread: <TRole extends string, TStash extends Record<string, any>>({ role, inherit, stash, }: {
+    role: TRole;
+    inherit?: {
+        traits?: Artifact<typeof GitFile>[];
+        skills?: Artifact<typeof GitFile>[];
+    };
+    stash?: TStash;
+}) => Promise<Thread<RoleContext<TRole, TStash>>>;

package/dist/logic/role/enrollThread.integration.test.d.ts

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