rhachet 1.2.0 → 1.3.2

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

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

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

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const test_fns_1 = require("test-fns");
+const example_echoRegistry_1 = require("./.test/example.echoRegistry");
+const invokeReadme_1 = require("./invokeReadme");
+describe('invokeReadme (integration)', () => {
+    (0, test_fns_1.given)('a CLI program with invokeReadme registered using EXAMPLE_REGISTRY', () => {
+        const program = new commander_1.Command();
+        const logSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
+        beforeEach(() => logSpy.mockClear());
+        (0, invokeReadme_1.invokeReadme)({ program, registries: [example_echoRegistry_1.EXAMPLE_REGISTRY] });
+        (0, test_fns_1.when)('invoked with only --registry', () => {
+            (0, test_fns_1.then)('it should print the registry readme', async () => {
+                await program.parseAsync(['readme', '--registry', 'echo'], {
+                    from: 'user',
+                });
+                expect(logSpy).toHaveBeenCalledWith('📜 echo.readme');
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining(example_echoRegistry_1.EXAMPLE_REGISTRY.readme.split('\n')[0]));
+            });
+        });
+        (0, test_fns_1.when)('invoked with --role only', () => {
+            (0, test_fns_1.then)('it should print the role readme', async () => {
+                await program.parseAsync(['readme', '--role', 'echoer'], {
+                    from: 'user',
+                });
+                expect(logSpy).toHaveBeenCalledWith('📜 echoer.readme');
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining(example_echoRegistry_1.EXAMPLE_REGISTRY.roles[0].readme.split('\n')[0]));
+            });
+        });
+        (0, test_fns_1.when)('invoked with --role and --skill', () => {
+            (0, test_fns_1.then)('it should print the skill readme', async () => {
+                await program.parseAsync(['readme', '--role', 'echoer', '--skill', 'echo'], { from: 'user' });
+                expect(logSpy).toHaveBeenCalledWith('📜 echoer.echo.readme');
+                expect(logSpy).toHaveBeenCalledWith(expect.stringContaining(example_echoRegistry_1.EXAMPLE_REGISTRY.roles[0].skills[0].readme.split('\n')[0]));
+            });
+        });
+        (0, test_fns_1.when)('invoked with an unknown role', () => {
+            (0, test_fns_1.then)('it should throw a missing role error', async () => {
+                const error = await (0, test_fns_1.getError)(() => program.parseAsync(['readme', '--role', 'notreal'], {
+                    from: 'user',
+                }));
+                expect(error?.message).toContain(`no role named "notreal" found in any registry`);
+            });
+        });
+        (0, test_fns_1.when)('invoked with an unknown skill', () => {
+            (0, test_fns_1.then)('it should throw a missing skill error', async () => {
+                const error = await (0, test_fns_1.getError)(() => program.parseAsync(['readme', '--role', 'echoer', '--skill', 'notreal'], { from: 'user' }));
+                expect(error?.message).toContain('no skill "notreal" in role "echoer"');
+            });
+        });
+        (0, test_fns_1.when)('invoked with an unknown registry', () => {
+            (0, test_fns_1.then)('it should throw a missing registry error', async () => {
+                const error = await (0, test_fns_1.getError)(() => program.parseAsync(['readme', '--registry', 'notreal'], {
+                    from: 'user',
+                }));
+                expect(error?.message).toContain('no registry matches given options');
+            });
+        });
+    });
+});
+//# sourceMappingURL=invokeReadme.integration.test.js.map

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

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

package/dist/contract/cli/invokeReadme.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.indentLines = exports.invokeReadme = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const assureFindRole_1 = require("../../logic/invoke/assureFindRole");
+/**
+ * .what = main entrypoint for `readme` CLI command
+ * .why = allows devs to introspect registry, role, or skill documentation from the CLI
+ */
+const invokeReadme = ({ program, registries, }) => {
+    program
+        .command('readme')
+        .description('print documentation for the registry, a role, or a skill')
+        .option('--registry <slug>', 'which registry to inspect')
+        .option('--role <slug>', 'which role to inspect')
+        .option('--skill <slug>', 'which skill to inspect')
+        .action((opts) => {
+        // no inputs provided
+        if (!opts.registry && !opts.role)
+            helpful_errors_1.BadRequestError.throw('must provide --registry or --role');
+        // resolve registry
+        const registry = opts.registry
+            ? registries.find((r) => r.slug === opts.registry)
+            : null;
+        if (!opts.role) {
+            if (!registry)
+                helpful_errors_1.BadRequestError.throw(`no registry matches given options`);
+            // registry level readme
+            return printReadme(`${registry.slug}`, registry.readme);
+        }
+        // resolve role
+        const role = (0, assureFindRole_1.assureFindRole)({ registries, slug: opts.role });
+        if (!role)
+            helpful_errors_1.BadRequestError.throw(`no role named "${opts.role}" in configured registries`, {
+                registries: registries.map((thisRegistry) => thisRegistry.slug),
+            });
+        // role-level readme
+        if (!opts.skill)
+            return printReadme(`${role.slug}`, role.readme);
+        // resolve skill
+        const skill = role.skills.find((s) => s.slug === opts.skill);
+        if (!skill)
+            helpful_errors_1.BadRequestError.throw(`no skill "${opts.skill}" in role "${opts.role}"`, { skills: role.skills.map((thisSkill) => thisSkill.slug) });
+        // skill-level readme
+        return printReadme(`${role.slug}.${skill.slug}`, skill.readme);
+    });
+};
+exports.invokeReadme = invokeReadme;
+/**
+ * .what = logs a formatted markdown readme block with label
+ * .why = standardizes output for registry/role/skill readmes in CLI
+ */
+const printReadme = (slug, markdown) => {
+    console.log('');
+    console.log(`📜 ${slug}.readme`);
+    console.log('');
+    console.log((0, exports.indentLines)(markdown));
+    console.log('');
+};
+/**
+ * .what = indents each line of a string by a fixed number of spaces
+ * .why = ensures markdown blocks are consistently readable in nested output
+ */
+const indentLines = (text, spaces = 4) => {
+    const prefix = ' '.repeat(spaces);
+    return text
+        .split('\n')
+        .map((line) => `${prefix}${line}`)
+        .join('\n');
+};
+exports.indentLines = indentLines;
+//# sourceMappingURL=invokeReadme.js.map

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

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

package/dist/contract/sdk.d.ts

@@ -1,3 +1,4 @@
+export * from '../domain/objects';
 export { genStitchChoice } from '../logic/weave/compose/genStitchChoice';
 export { genStitchCycle } from '../logic/weave/compose/genStitchCycle';
 export { genStitchFanout } from '../logic/weave/compose/genStitchFanout';
@@ -5,4 +6,11 @@ export { genStitchRoute } from '../logic/weave/compose/genStitchRoute';
 export { enweaveOneStitcher } from '../logic/weave/enweaveOneStitcher';
 export { asStitcher } from '../logic/weave/compose/asStitcher';
 export { asStitcherFlat } from '../logic/weave/compose/asStitcherFlat';
-export * from '../domain/objects';
+export { genTemplate } from '../logic/template/genTemplate';
+export { getTemplateValFromArtifacts } from '../logic/template/getTemplateValFromArtifacts';
+export { getTemplateVarsFromRoleInherit } from '../logic/template/getTemplateVarsFromInheritance';
+export { useTemplate } from '../logic/template/useTemplate';
+export { genStepImagineViaTemplate } from '../logic/template/genStepImagineViaTemplate';
+export { ContextStitchTrail } from '../logic/stitch/withStitchTrail';
+export { getStitch } from '../logic/thread/getStitch';
+export { enrollThread } from '../logic/role/enrollThread';

package/dist/contract/sdk.js

@@ -14,7 +14,8 @@ 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.asStitcherFlat = exports.asStitcher = exports.enweaveOneStitcher = exports.genStitchRoute = exports.genStitchFanout = exports.genStitchCycle = exports.genStitchChoice = void 0;
+exports.enrollThread = exports.getStitch = exports.genStepImagineViaTemplate = exports.useTemplate = exports.getTemplateVarsFromRoleInherit = exports.getTemplateValFromArtifacts = exports.genTemplate = exports.asStitcherFlat = exports.asStitcher = exports.enweaveOneStitcher = exports.genStitchRoute = exports.genStitchFanout = exports.genStitchCycle = exports.genStitchChoice = void 0;
+__exportStar(require("../domain/objects"), exports);
 var genStitchChoice_1 = require("../logic/weave/compose/genStitchChoice");
 Object.defineProperty(exports, "genStitchChoice", { enumerable: true, get: function () { return genStitchChoice_1.genStitchChoice; } });
 var genStitchCycle_1 = require("../logic/weave/compose/genStitchCycle");
@@ -29,5 +30,18 @@ var asStitcher_1 = require("../logic/weave/compose/asStitcher");
 Object.defineProperty(exports, "asStitcher", { enumerable: true, get: function () { return asStitcher_1.asStitcher; } });
 var asStitcherFlat_1 = require("../logic/weave/compose/asStitcherFlat");
 Object.defineProperty(exports, "asStitcherFlat", { enumerable: true, get: function () { return asStitcherFlat_1.asStitcherFlat; } });
-__exportStar(require("../domain/objects"), exports);
+var genTemplate_1 = require("../logic/template/genTemplate");
+Object.defineProperty(exports, "genTemplate", { enumerable: true, get: function () { return genTemplate_1.genTemplate; } });
+var getTemplateValFromArtifacts_1 = require("../logic/template/getTemplateValFromArtifacts");
+Object.defineProperty(exports, "getTemplateValFromArtifacts", { enumerable: true, get: function () { return getTemplateValFromArtifacts_1.getTemplateValFromArtifacts; } });
+var getTemplateVarsFromInheritance_1 = require("../logic/template/getTemplateVarsFromInheritance");
+Object.defineProperty(exports, "getTemplateVarsFromRoleInherit", { enumerable: true, get: function () { return getTemplateVarsFromInheritance_1.getTemplateVarsFromRoleInherit; } });
+var useTemplate_1 = require("../logic/template/useTemplate");
+Object.defineProperty(exports, "useTemplate", { enumerable: true, get: function () { return useTemplate_1.useTemplate; } });
+var genStepImagineViaTemplate_1 = require("../logic/template/genStepImagineViaTemplate");
+Object.defineProperty(exports, "genStepImagineViaTemplate", { enumerable: true, get: function () { return genStepImagineViaTemplate_1.genStepImagineViaTemplate; } });
+var getStitch_1 = require("../logic/thread/getStitch");
+Object.defineProperty(exports, "getStitch", { enumerable: true, get: function () { return getStitch_1.getStitch; } });
+var enrollThread_1 = require("../logic/role/enrollThread");
+Object.defineProperty(exports, "enrollThread", { enumerable: true, get: function () { return enrollThread_1.enrollThread; } });
 //# sourceMappingURL=sdk.js.map

package/dist/contract/sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/contract/sdk.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,0EAAyE;AAAhE,kHAAA,eAAe,OAAA;AACxB,wEAAuE;AAA9D,gHAAA,cAAc,OAAA;AACvB,0EAAyE;AAAhE,kHAAA,eAAe,OAAA;AACxB,wEAAuE;AAA9D,gHAAA,cAAc,OAAA;AAEvB,wEAAuE;AAA9D,wHAAA,kBAAkB,OAAA;AAE3B,gEAA+D;AAAtD,wGAAA,UAAU,OAAA;AACnB,wEAAuE;AAA9D,gHAAA,cAAc,OAAA;AAEvB,oDAAkC"}
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/contract/sdk.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oDAAkC;AAElC,0EAAyE;AAAhE,kHAAA,eAAe,OAAA;AACxB,wEAAuE;AAA9D,gHAAA,cAAc,OAAA;AACvB,0EAAyE;AAAhE,kHAAA,eAAe,OAAA;AACxB,wEAAuE;AAA9D,gHAAA,cAAc,OAAA;AAEvB,wEAAuE;AAA9D,wHAAA,kBAAkB,OAAA;AAE3B,gEAA+D;AAAtD,wGAAA,UAAU,OAAA;AACnB,wEAAuE;AAA9D,gHAAA,cAAc,OAAA;AAEvB,6DAA4D;AAAnD,0GAAA,WAAW,OAAA;AACpB,6FAA4F;AAAnF,0IAAA,2BAA2B,OAAA;AACpC,mGAAkG;AAAzF,gJAAA,8BAA8B,OAAA;AACvC,6DAA4D;AAAnD,0GAAA,WAAW,OAAA;AACpB,yFAAwF;AAA/E,sIAAA,yBAAyB,OAAA;AAGlC,uDAAsD;AAA7C,sGAAA,SAAS,OAAA;AAClB,2DAA0D;AAAjD,4GAAA,YAAY,OAAA"}

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

@@ -9,3 +9,10 @@ export * from './StitchStep';
 export * from './StitchTrail';
 export * from './Thread';
 export * from './Threads';
+export * from './Role';
+export * from './RoleContext';
+export * from './RoleRegistry';
+export * from './RoleSkill';
+export * from './RoleSkillArgGetter';
+export * from './RoleTrait';
+export * from './Template';

package/dist/domain/objects/index.js

@@ -27,4 +27,11 @@ __exportStar(require("./Thread"), exports);
 __exportStar(require("./Threads"), exports);
 // export * from './Weave';
 // export * from './Weaver';
+__exportStar(require("./Role"), exports);
+__exportStar(require("./RoleContext"), exports);
+__exportStar(require("./RoleRegistry"), exports);
+__exportStar(require("./RoleSkill"), exports);
+__exportStar(require("./RoleSkillArgGetter"), exports);
+__exportStar(require("./RoleTrait"), exports);
+__exportStar(require("./Template"), exports);
 //# sourceMappingURL=index.js.map

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("../..").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>;