rhachet 1.3.4 → 1.4.0

package/dist/contract/cli/invokeAsk.js

@@ -30,7 +30,10 @@ const invokeAsk = ({ program, registries, }) => {
             });
         // register the dynamic inputs
         for (const [key, meta] of Object.entries(skill.threads.lookup)) {
-            thisCommand.option(`-${meta.char}, --${key} <${meta.type}>`, meta.desc);
+            const isOptional = meta.type.startsWith('?');
+            const typeParsed = isOptional ? meta.type.slice(1) : meta.type;
+            const typeLabel = isOptional ? `[${typeParsed}]` : `<${typeParsed}>`;
+            thisCommand.option(`-${meta.char}, --${key} ${typeLabel}`, meta.desc);
         }
         // re-parse with updated option definitions
         thisCommand.parseOptions(thisCommand.parent?.args ?? []);
@@ -68,7 +71,14 @@ const invokeAsk = ({ program, registries, }) => {
             from: { lookup: { env } },
         });
         // execute the weave
-        console.log(`🫡 on it! began ${role.slug}.${skill.slug}`, { ask });
+        console.log('');
+        console.log('');
+        console.log('🎙️  heard');
+        console.log('');
+        console.log(argvWithAsk.ask);
+        console.log('');
+        console.log('🫡  on it!');
+        console.log('');
         await (0, sdk_1.enweaveOneStitcher)({
             stitcher: skill.route,
             threads,

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

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

package/dist/contract/sdk.d.ts

@@ -14,3 +14,4 @@ export { genStepImagineViaTemplate } from '../logic/template/genStepImagineViaTe
 export { ContextStitchTrail } from '../logic/stitch/withStitchTrail';
 export { getStitch } from '../logic/thread/getStitch';
 export { enrollThread } from '../logic/role/enrollThread';
+export { genRoleSkill } from '../logic/role/genRoleSkill';

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.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;
+exports.genRoleSkill = 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; } });
@@ -44,4 +44,6 @@ 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; } });
+var genRoleSkill_1 = require("../logic/role/genRoleSkill");
+Object.defineProperty(exports, "genRoleSkill", { enumerable: true, get: function () { return genRoleSkill_1.genRoleSkill; } });
 //# 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,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"}
+{"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;AAErB,2DAA0D;AAAjD,4GAAA,YAAY,OAAA"}

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

@@ -35,7 +35,7 @@ export interface Role {
      * .what = the traits inherent to the role
      * .why = declares how the role goes about things
      */
-    traits: RoleTrait<any>[];
+    traits: RoleTrait[];
     /**
      * .what = the skills known by the role
      * .why = declares what the role can do

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

@@ -28,7 +28,7 @@ export interface RoleContextSkill {
  * .what = the context that each role carries with it
  * .why = provides each role with a set of traits (inherent truths) and skills (learned abilities) to influence how they approach decisions, actions, and interpretations
  */
-export interface RoleContext<TRole extends ThreadRole, TStash extends Record<string, any> | undefined> extends ThreadContextRole<TRole> {
+export interface RoleContext<TRole extends ThreadRole, TStash extends Record<string, any> | undefined = Record<string, any> | undefined> extends ThreadContextRole<TRole> {
     role: TRole;
     /**
      * .what = the persistent traits and skills that define how this role behaves

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

@@ -2,6 +2,7 @@ import { DomainLiteral } from 'domain-objects';
 import { Empty } from 'type-fns';
 import { GStitcher } from './Stitcher';
 import { Threads } from './Threads';
+type WithOptionPrefix<T extends string> = T | `?${T}`;
 /**
  * .what = a generic specification for how to collect, verify, and instantiate skill arguments
  * .why =
@@ -17,41 +18,45 @@ export interface RoleSkillArgGetter<TOutput, TVariables extends Record<string, a
     /**
      * .what = declares how to collect required inputs (from CLI, env, etc)
      */
-    lookup: Record<string, {
-        /**
-         * .what = where to get lookup from
-         */
-        source: 'process.env';
-        /**
-         * .what = a description of the input
-         */
-        desc: string;
-        /**
-         * .what = what envar key to dereference
-         */
-        envar: string;
-        /**
-         * .what = what type to expect
-         */
-        type: 'string';
-    } | {
-        /**
-         * .what = where to get lookup from
-         */
-        source: 'process.argv';
-        /**
-         * .what = a description of the input
-         */
-        desc: string;
-        /**
-         * .what = what shorthand char alias to use, if from process.argv
-         */
-        char?: string;
-        /**
-         * .what = what type to expect
-         */
-        type: 'string';
-    }>;
+    lookup: {
+        [K in keyof Omit<TVariables, 'ask'>]: {
+            /**
+             * .what = where to get lookup from
+             */
+            source: 'process.env';
+            /**
+             * .what = a description of the input
+             */
+            desc: string;
+            /**
+             * .what = what envar key to dereference
+             */
+            envar: string;
+            /**
+             * .what = what type to expect
+             * .note = prefix with `?` to designate as optional
+             */
+            type: WithOptionPrefix<'string'>;
+        } | {
+            /**
+             * .what = where to get lookup from
+             */
+            source: 'process.argv';
+            /**
+             * .what = a description of the input
+             */
+            desc: string;
+            /**
+             * .what = what shorthand char alias to use, if from process.argv
+             */
+            char?: string;
+            /**
+             * .what = what type to expect
+             * .note = prefix with `?` to designate as optional
+             */
+            type: WithOptionPrefix<'string'>;
+        };
+    };
     /**
      * .what = assures the input from lookup or passin was correctly declared
      */
@@ -76,24 +81,27 @@ export interface RoleSkillThreadsGetter<TOutput extends Threads<any>, TVariables
      * .what = how to lookup the required inputs for thread instantiation
      * .example = { target: { char: t, desc: "the target file or dir to upsert against", shape: "string" } }
      */
-    lookup: Record<string, {
-        /**
-         * .what = where to get lookup from
-         */
-        source: 'process.argv';
-        /**
-         * .what = a description of the input
-         */
-        desc: string;
-        /**
-         * .what = what shorthand single char alias to use
-         */
-        char?: string;
-        /**
-         * .what = what type to expect
-         */
-        type: 'string';
-    }> & {
+    lookup: {
+        [K in keyof Omit<TVariables, 'ask'>]: {
+            /**
+             * .what = where to get lookup from
+             */
+            source: 'process.argv';
+            /**
+             * .what = a description of the input
+             */
+            desc: string;
+            /**
+             * .what = what shorthand single char alias to use
+             */
+            char?: string;
+            /**
+             * .what = what type to expect
+             * .note = prefix with `?` to designate as optional
+             */
+            type: WithOptionPrefix<'string'>;
+        };
+    } & {
         ask?: Empty;
     };
 }
@@ -114,24 +122,28 @@ export interface RoleSkillContextGetter<TOutput extends GStitcher['context'], TV
      * .what = how to lookup the required inputs for context instantiation
      * .example = { openaiApiKey: { envar: "PREP_OPENAI_KEY" } }
      */
-    lookup: Record<string, {
-        /**
-         * .what = where to get lookup from
-         */
-        source: 'process.env';
-        /**
-         * .what = a description of the input
-         */
-        desc: string;
-        /**
-         * .what = what envar key to dereference
-         */
-        envar: string;
-        /**
-         * .what = what type to expect
-         */
-        type: 'string';
-    }>;
+    lookup: {
+        [K in keyof TVariables]: {
+            /**
+             * .what = where to get lookup from
+             */
+            source: 'process.env';
+            /**
+             * .what = a description of the input
+             */
+            desc: string;
+            /**
+             * .what = what envar key to dereference
+             */
+            envar: string;
+            /**
+             * .what = what type to expect
+             * .note = prefix with `?` to designate as optional
+             */
+            type: WithOptionPrefix<'string'>;
+        };
+    };
 }
 export declare class RoleSkillContextGetter<TOutput extends GStitcher['context'], TVariables extends Record<string, string>> extends DomainLiteral<RoleSkillContextGetter<TOutput, TVariables>> implements RoleSkillContextGetter<TOutput, TVariables> {
 }
+export {};

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

@@ -1 +1 @@
-{"version":3,"file":"RoleSkillArgGetter.js","sourceRoot":"","sources":["../../../src/domain/objects/RoleSkillArgGetter.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AA8H/C,MAAa,sBAIX,SAAQ,8BAA0D;CACT;AAL3D,wDAK2D;AA6C3D,MAAa,sBAIX,SAAQ,8BAA0D;CACT;AAL3D,wDAK2D"}
+{"version":3,"file":"RoleSkillArgGetter.js","sourceRoot":"","sources":["../../../src/domain/objects/RoleSkillArgGetter.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAkI/C,MAAa,sBAIX,SAAQ,8BAA0D;CACT;AAL3D,wDAK2D;AA6C3D,MAAa,sBAIX,SAAQ,8BAA0D;CACT;AAL3D,wDAK2D"}

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

@@ -1,6 +1,6 @@
 import { DomainEntity } from 'domain-objects';
-import { Serializable } from 'serde-fns';
-import { Template } from './Template';
+import { Artifact } from 'rhachet-artifact';
+import { GitFile } from 'rhachet-artifact-git';
 /**
  * .what = a trait is a reusable behavioral modifier for a role
  *   - it's adopted as an inherent truth of any actor which assumes the role
@@ -13,7 +13,7 @@ import { Template } from './Template';
  *   - treat consistency as top priority
  *   - prefer given/when/then test suites
  */
-export interface RoleTrait<TVariables extends Serializable> {
+export interface RoleTrait {
     /**
      * .what = short identifier for this trait
      * .example = "asksQuestions"
@@ -27,8 +27,8 @@ export interface RoleTrait<TVariables extends Serializable> {
     /**
      * .what = the brief that houses this trait's declaration
      */
-    brief: Template<TVariables>;
+    brief: Artifact<typeof GitFile>;
 }
-export declare class RoleTrait<TVariables extends Serializable> extends DomainEntity<RoleTrait<TVariables>> implements RoleTrait<TVariables> {
+export declare class RoleTrait extends DomainEntity<RoleTrait> implements RoleTrait {
     static unique: readonly ["slug"];
 }

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

@@ -1 +1 @@
-{"version":3,"file":"RoleTrait.js","sourceRoot":"","sources":["../../../src/domain/objects/RoleTrait.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AAmC9C,MAAa,SACX,SAAQ,6BAAmC;;AAD7C,8BAKC;AADe,gBAAM,GAAG,CAAC,MAAM,CAAU,CAAC"}
+{"version":3,"file":"RoleTrait.js","sourceRoot":"","sources":["../../../src/domain/objects/RoleTrait.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AAkC9C,MAAa,SAAU,SAAQ,6BAAuB;;AAAtD,8BAEC;AADe,gBAAM,GAAG,CAAC,MAAM,CAAU,CAAC"}

package/dist/logic/invoke/getSkillThreads.js

@@ -26,17 +26,17 @@ const getSkillThreads = async (input) => {
         // 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) {
+            if (val !== undefined)
+                collected[key] = val;
+            if (val === undefined && !spec.type.startsWith('?'))
                 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 });
+            helpful_errors_1.UnexpectedCodePathError.throw('getter.assess=false; did you forget to update your .assess function in the skill declaration?', { from, collected });
         // instantiate
         return await getter.instantiate(collected);
     }

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

@@ -1 +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"}
+{"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;gBAAE,SAAS,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YAC5C,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBACjD,gCAAe,CAAC,KAAK,CAAC,0BAA0B,GAAG,MAAM,IAAI,CAAC,IAAI,GAAG,EAAE;oBACrE,GAAG;oBACH,IAAI;iBACL,CAAC,CAAC;QACP,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;YAC3B,wCAAuB,CAAC,KAAK,CAC3B,+FAA+F,EAC/F,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;AAzDW,QAAA,eAAe,mBAyD1B"}

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

@@ -0,0 +1,12 @@
+import { GStitcher, Stitcher, RoleSkillThreadsGetter, RoleSkillContextGetter, RoleSkill } from '../../domain/objects';
+/**
+ * .what = factory for role skills
+ * .why = ensures narrow type coupling between getter inputs
+ */
+export declare const genRoleSkill: <TStitcher extends GStitcher<any, any, any>, TThreadsVars extends Record<string, string>, TContextVars extends Record<string, string>>(input: {
+    slug: string;
+    readme: string;
+    route: Stitcher<TStitcher>;
+    threads: RoleSkillThreadsGetter<TStitcher['threads'], TThreadsVars>;
+    context: RoleSkillContextGetter<TStitcher['context'], TContextVars>;
+}) => RoleSkill<TStitcher>;

package/dist/logic/role/genRoleSkill.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genRoleSkill = void 0;
+const objects_1 = require("../../domain/objects");
+/**
+ * .what = factory for role skills
+ * .why = ensures narrow type coupling between getter inputs
+ */
+const genRoleSkill = (input) => {
+    return objects_1.RoleSkill.build({
+        slug: input.slug,
+        readme: input.readme,
+        route: input.route,
+        threads: input.threads,
+        context: input.context,
+    });
+};
+exports.genRoleSkill = genRoleSkill;
+//# sourceMappingURL=genRoleSkill.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"genRoleSkill.js","sourceRoot":"","sources":["../../../src/logic/role/genRoleSkill.ts"],"names":[],"mappings":";;;AAAA,kDAM8B;AAE9B;;;GAGG;AACI,MAAM,YAAY,GAAG,CAI1B,KAMD,EAAwB,EAAE;IACzB,OAAO,mBAAS,CAAC,KAAK,CAAC;QACrB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAY;QACzB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;AACL,CAAC,CAAC;AAlBW,QAAA,YAAY,gBAkBvB"}

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

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

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

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_fns_1 = require("test-fns");
+const objects_1 = require("../../domain/objects");
+const enrollThread_1 = require("./enrollThread");
+const genRoleSkill_1 = require("./genRoleSkill");
+describe('genRoleSkill', () => {
+    (0, test_fns_1.given)('a valid set of lookup, assess, and instantiate handlers', () => {
+        const skill = (0, genRoleSkill_1.genRoleSkill)({
+            slug: 'demo',
+            readme: 'demo readme',
+            route: {},
+            threads: {
+                lookup: {
+                    foo: {
+                        source: 'process.argv',
+                        desc: 'some arg',
+                        char: 'f',
+                        type: 'string',
+                    },
+                },
+                assess: (input) => typeof input.foo === 'string',
+                instantiate: async (input) => {
+                    return {
+                        caller: await (0, enrollThread_1.enrollThread)({
+                            role: 'caller',
+                            stash: { foo: input.foo },
+                        }),
+                    };
+                },
+            },
+            context: {
+                lookup: {
+                    bar: {
+                        source: 'process.env',
+                        desc: 'some env var',
+                        envar: 'DEMO_ENV',
+                        type: 'string',
+                    },
+                },
+                assess: (input) => typeof input.bar === 'string',
+                instantiate: (input) => {
+                    return {
+                        demoCtx: input.bar,
+                    };
+                },
+            },
+        });
+        (0, test_fns_1.when)('the skill is instantiated', () => {
+            (0, test_fns_1.then)('it should produce a valid RoleSkill object', () => {
+                expect(skill).toBeInstanceOf(objects_1.RoleSkill);
+                expect(skill.slug).toBe('demo');
+                expect(skill.readme).toContain('demo readme');
+            });
+            (0, test_fns_1.then)('its thread assess should validate correct input', () => {
+                const valid = { foo: 'hello' };
+                const invalid = { foo: 123 };
+                expect(skill.threads.assess(valid)).toBe(true);
+                expect(skill.threads.assess(invalid)).toBe(false);
+            });
+            (0, test_fns_1.then)('its context assess should validate correct input', () => {
+                const valid = { bar: 'world' };
+                const invalid = { bar: false };
+                expect(skill.context.assess(valid)).toBe(true);
+                expect(skill.context.assess(invalid)).toBe(false);
+            });
+            (0, test_fns_1.then)('its thread instantiation should return the correct output', async () => {
+                const result = await skill.threads.instantiate({ foo: 'hi' });
+                expect(result.caller).toBeDefined();
+                expect(result.caller.context.stash.foo).toBe('hi');
+            });
+            (0, test_fns_1.then)('its context instantiation should return the correct output', async () => {
+                const ctx = await skill.context.instantiate({ bar: 'baz' });
+                expect(ctx.log);
+            });
+        });
+    });
+});
+//# sourceMappingURL=genRoleSkill.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"genRoleSkill.test.js","sourceRoot":"","sources":["../../../src/logic/role/genRoleSkill.test.ts"],"names":[],"mappings":";;AAAA,uCAA6C;AAE7C,kDAM8B;AAC9B,iDAA8C;AAC9C,iDAA8C;AAE9C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAA,gBAAK,EAAC,yDAAyD,EAAE,GAAG,EAAE;QACpE,MAAM,KAAK,GAAG,IAAA,2BAAY,EAAC;YACzB,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,aAAa;YACrB,KAAK,EAAE,EAEN;YACD,OAAO,EAAE;gBACP,MAAM,EAAE;oBACN,GAAG,EAAE;wBACH,MAAM,EAAE,cAAc;wBACtB,IAAI,EAAE,UAAU;wBAChB,IAAI,EAAE,GAAG;wBACT,IAAI,EAAE,QAAQ;qBACf;iBACF;gBACD,MAAM,EAAE,CAAC,KAAU,EAA4B,EAAE,CAC/C,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;gBAC/B,WAAW,EAAE,KAAK,EAAE,KAAsB,EAAE,EAAE;oBAC5C,OAAO;wBACL,MAAM,EAAE,MAAM,IAAA,2BAAY,EAAC;4BACzB,IAAI,EAAE,QAAQ;4BACd,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE;yBAC1B,CAAC;qBACH,CAAC;gBACJ,CAAC;aACF;YACD,OAAO,EAAE;gBACP,MAAM,EAAE;oBACN,GAAG,EAAE;wBACH,MAAM,EAAE,aAAa;wBACrB,IAAI,EAAE,cAAc;wBACpB,KAAK,EAAE,UAAU;wBACjB,IAAI,EAAE,QAAQ;qBACf;iBACF;gBACD,MAAM,EAAE,CAAC,KAAU,EAA4B,EAAE,CAC/C,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;gBAC/B,WAAW,EAAE,CAAC,KAAsB,EAAE,EAAE;oBACtC,OAAO;wBACL,OAAO,EAAE,KAAK,CAAC,GAAG;qBACY,CAAC;gBACnC,CAAC;aACF;SACF,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,2BAA2B,EAAE,GAAG,EAAE;YACrC,IAAA,eAAI,EAAC,4CAA4C,EAAE,GAAG,EAAE;gBACtD,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,mBAAS,CAAC,CAAC;gBACxC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAChC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;YAEH,IAAA,eAAI,EAAC,iDAAiD,EAAE,GAAG,EAAE;gBAC3D,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;gBAC7B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC/C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpD,CAAC,CAAC,CAAC;YAEH,IAAA,eAAI,EAAC,kDAAkD,EAAE,GAAG,EAAE;gBAC5D,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;gBAC/B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC/C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpD,CAAC,CAAC,CAAC;YAEH,IAAA,eAAI,EACF,2DAA2D,EAC3D,KAAK,IAAI,EAAE;gBACT,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;gBACpC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrD,CAAC,CACF,CAAC;YAEF,IAAA,eAAI,EACF,4DAA4D,EAC5D,KAAK,IAAI,EAAE;gBACT,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC5D,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/logic/stitch/invokeImagineStitcher.js

@@ -1,11 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.invokeImagineStitcher = void 0;
+const uni_time_1 = require("@ehmpathy/uni-time");
 /**
  * .what = invokes the imagine stitcher by invocation of stitcher mechanisms
  */
 const invokeImagineStitcher = async (input, context) => {
     const { stitcher, threads } = input;
+    // todo: generalize logs
+    const beganAt = (0, uni_time_1.asUniDateTime)(new Date());
+    console.log(`🧠 imagine.began:${input.stitcher.slug}`, { beganAt });
     // enprompt the thread
     const prompt = await stitcher.enprompt({ threads });
     // invoke the imagination
@@ -16,6 +20,15 @@ const invokeImagineStitcher = async (input, context) => {
         promptIn: prompt,
         promptOut: imagined,
     });
+    // todo: generalize logs
+    const endedAt = (0, uni_time_1.asUniDateTime)(new Date());
+    const duration = (0, uni_time_1.getDuration)({
+        of: { range: { since: beganAt, until: endedAt } },
+    });
+    console.log(`🧠 imagine.ended:${input.stitcher.slug}`, {
+        endedAt,
+        duration,
+    });
     // expose the stitch
     return stitch;
 };

package/dist/logic/stitch/invokeImagineStitcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"invokeImagineStitcher.js","sourceRoot":"","sources":["../../../src/logic/stitch/invokeImagineStitcher.ts"],"names":[],"mappings":";;;AAIA;;GAEG;AACI,MAAM,qBAAqB,GAAG,KAAK,EACxC,KAGC,EACD,OAA6B,EACmC,EAAE;IAClE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAEpC,sBAAsB;IACtB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAEpD,yBAAyB;IACzB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzD,8BAA8B;IAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAC/B,OAAO;QACP,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;IAEH,oBAAoB;IACpB,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAxBW,QAAA,qBAAqB,yBAwBhC"}
+{"version":3,"file":"invokeImagineStitcher.js","sourceRoot":"","sources":["../../../src/logic/stitch/invokeImagineStitcher.ts"],"names":[],"mappings":";;;AAAA,iDAAgE;AAMhE;;GAEG;AACI,MAAM,qBAAqB,GAAG,KAAK,EACxC,KAGC,EACD,OAA6B,EACmC,EAAE;IAClE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAEpC,wBAAwB;IACxB,MAAM,OAAO,GAAG,IAAA,wBAAa,EAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAEpE,sBAAsB;IACtB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAEpD,yBAAyB;IACzB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzD,8BAA8B;IAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAC/B,OAAO;QACP,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;IAEH,wBAAwB;IACxB,MAAM,OAAO,GAAG,IAAA,wBAAa,EAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAA,sBAAW,EAAC;QAC3B,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;KAClD,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE;QACrD,OAAO;QACP,QAAQ;KACT,CAAC,CAAC;IAEH,oBAAoB;IACpB,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAtCW,QAAA,qBAAqB,yBAsChC"}

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.3.4",
+  "version": "1.4.0",
   "repository": "ehmpathy/rhachet",
   "homepage": "https://github.com/ehmpathy/rhachet",
   "keywords": [
@@ -59,7 +59,7 @@
     "helpful-errors": "1.3.8",
     "openai": "5.8.2",
     "rhachet-artifact": "1.0.0",
-    "rhachet-artifact-git": "1.0.1",
+    "rhachet-artifact-git": "1.0.2",
     "serde-fns": "1.3.0",
     "test-fns": "1.5.0",
     "type-fns": "1.19.0",