rhachet-roles-ehmpathy 1.7.0 → 1.8.0

package/dist/contract/commands/codegenBriefOptions.js

@@ -50,7 +50,7 @@ export type BriefOption${input.role} = typeof options[number];
 // npx tsx src/contract/commands/codegenBriefOptions.ts
 if (require.main === module) {
     void command({ role: 'Ecologist' });
-    // void command({ role: 'Architect' });
+    void command({ role: 'Architect' });
     void command({ role: 'Designer' });
     void command({ role: 'Mechanic' });
     void command({ role: 'Bhrain' });

package/dist/contract/commands/codegenBriefOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"codegenBriefOptions.js","sourceRoot":"","sources":["../../../src/contract/commands/codegenBriefOptions.ts"],"names":[],"mappings":";;;;;AAAA,qDAAiD;AACjD,0DAA6B;AAC7B,4CAAoB;AACpB,gDAAwB;AACxB,+DAAsD;AAEtD,MAAM,OAAO,GAAG,IAAA,sBAAS,EACvB;IACE,IAAI,EAAE,cAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC/B,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,SAAS,GAAG,QAAQ;IACzB,GAAG,EAAE,OAAO;CACb,EACD,KAAK,EAAE,KAEN,EAAE,EAAE;IACH,kDAAkD;IAClD,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CACzB,CAAC,MAAM,IAAA,qCAAc,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACzC,oBAAoB,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CACzD,CAAC;IACF,MAAM,QAAQ,GAAG;QACf,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,cAAc;QAC5C,GAAG,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,4FAA4F;KACxI,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,IAAA,mBAAI,EAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5D,6BAA6B;IAC7B,MAAM,IAAI,GAAG,SAAS;SACnB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,cAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SACtD,GAAG,CACF,CAAC,IAAI,EAAE,EAAE,CAAC,cAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAC7D,CAAC;IACJ,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7D,MAAM,YAAY,GAAG;;0DAEiC,KAAK,CAAC,IAAI;;;oCAGhC,cAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;;;;EAI3D,YAAY;;;yBAGW,KAAK,CAAC,IAAI;CAClC,CAAC;IAEE,qBAAqB;IACrB,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAC1B,SAAS,EACT,SAAS,KAAK,CAAC,IAAI,0BAA0B,CAC9C,CAAC;IACF,YAAE,CAAC,aAAa,CAAC,UAAU,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;IACtC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AACtC,CAAC,CACF,CAAC;AAEF,uDAAuD;AACvD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACpC,uCAAuC;IACvC,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACnC,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACnC,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"codegenBriefOptions.js","sourceRoot":"","sources":["../../../src/contract/commands/codegenBriefOptions.ts"],"names":[],"mappings":";;;;;AAAA,qDAAiD;AACjD,0DAA6B;AAC7B,4CAAoB;AACpB,gDAAwB;AACxB,+DAAsD;AAEtD,MAAM,OAAO,GAAG,IAAA,sBAAS,EACvB;IACE,IAAI,EAAE,cAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC/B,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,SAAS,GAAG,QAAQ;IACzB,GAAG,EAAE,OAAO;CACb,EACD,KAAK,EAAE,KAEN,EAAE,EAAE;IACH,kDAAkD;IAClD,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CACzB,CAAC,MAAM,IAAA,qCAAc,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACzC,oBAAoB,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CACzD,CAAC;IACF,MAAM,QAAQ,GAAG;QACf,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,cAAc;QAC5C,GAAG,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,4FAA4F;KACxI,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,IAAA,mBAAI,EAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5D,6BAA6B;IAC7B,MAAM,IAAI,GAAG,SAAS;SACnB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,cAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SACtD,GAAG,CACF,CAAC,IAAI,EAAE,EAAE,CAAC,cAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAC7D,CAAC;IACJ,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7D,MAAM,YAAY,GAAG;;0DAEiC,KAAK,CAAC,IAAI;;;oCAGhC,cAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;;;;EAI3D,YAAY;;;yBAGW,KAAK,CAAC,IAAI;CAClC,CAAC;IAEE,qBAAqB;IACrB,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAC1B,SAAS,EACT,SAAS,KAAK,CAAC,IAAI,0BAA0B,CAC9C,CAAC;IACF,YAAE,CAAC,aAAa,CAAC,UAAU,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;IACtC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AACtC,CAAC,CACF,CAAC;AAEF,uDAAuD;AACvD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACpC,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACpC,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACnC,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACnC,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/dist/logic/roles/architect/.briefs/criteria.given_when_then.[seed].[idea].md

@@ -0,0 +1,35 @@
+[idea] = nest then's within sothat? when many thens support the same sothat?
+
+  when([t4] bastion IAM instance profile is provisioned via terraform)
+    sothat(SSM sessions can be established to bastion)
+      then(instance profile includes AmazonSSMManagedInstanceCore policy)
+      then(instance profile allows ssm:StartSession action)
+    sothat(auto-pause can detect when bastion is idle)
+      then(instance profile allows ec2:StopInstances for self-stop)
+      then(instance profile allows ec2:DescribeInstances to check instance state)
+      then(instance profile allows ssm:DescribeSessions to detect active sessions)
+      then(instance profile allows ssm:GetConnectionStatus to verify session state)
+
+
+i.e.,
+
+
+given(scene)
+  when(cause)
+    sothat(benefit)
+      then(effect.1)
+      then(effect.2)
+
+
+---
+
+
+e.g.,
+
+given(its dinner time)
+  when(dinner is served)
+    sothat(we can eat with cleanly)
+      then(we should have cutlery appropriate to the dish)
+      then(we should have plates appropriate to the dish)
+      then(we should have napkins to clean with)
+

package/dist/logic/roles/architect/.briefs/criteria.given_when_then.[seed].md

@@ -0,0 +1,20 @@
+criteria is best written in behavior-driven-development format
+
+e.g.,
+
+given(scene)
+  when([t0] nochange)
+    then(assert initial condition)
+    ...
+  when([t1] cause)
+    then(effect)
+      sothat(benefit) # optional
+    ...
+  when([t2] cause)
+    then(effect)
+      sothat(benefit) # optional
+    ...
+
+
+dont forget that given and when can nest inside eachother; but then() goes at the root
+

package/dist/logic/roles/architect/.briefs/criteria.practices/prefer.env_access.prep_over_dev.md

@@ -0,0 +1,12 @@
+prep = prepare; pre-prod; is 4 char long
+
+dev = developer
+
+
+prep & prod are better symmetric terms for env.access than dev & prod, fundamentally
+
+
+- prep = prepare; preparation; pre-production
+- prod = produce; production
+
+

package/dist/logic/roles/architect/getArchitectRole.d.ts

@@ -0,0 +1,2 @@
+import { Role } from 'rhachet';
+export declare const ROLE_ARCHITECT: import("domain-objects/dist/manipulation/immute/withImmute").WithImmute<Role>;

package/dist/logic/roles/architect/getArchitectRole.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_ARCHITECT = void 0;
+const rhachet_1 = require("rhachet");
+exports.ROLE_ARCHITECT = rhachet_1.Role.build({
+    slug: 'architect',
+    name: 'Architect',
+    purpose: 'design system',
+    readme: `
+## 🏛️ Architect
+
+- **scale**: system-level, cross-cutting concerns
+- **focus**: patterns, principles, maintainability
+- **maximizes**: long-term scalability and coherence
+
+Used to design system architecture and establish patterns that ensure maintainability.
+  `.trim(),
+    traits: [],
+    skills: {
+        dirs: [],
+        refs: [],
+    },
+    briefs: {
+        dirs: [{ uri: __dirname + '/.briefs' }],
+    },
+});
+//# sourceMappingURL=getArchitectRole.js.map

package/dist/logic/roles/architect/getArchitectRole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getArchitectRole.js","sourceRoot":"","sources":["../../../../src/logic/roles/architect/getArchitectRole.ts"],"names":[],"mappings":";;;AAAA,qCAA+B;AAElB,QAAA,cAAc,GAAG,cAAI,CAAC,KAAK,CAAC;IACvC,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,eAAe;IACxB,MAAM,EAAE;;;;;;;;GAQP,CAAC,IAAI,EAAE;IACR,MAAM,EAAE,EAAE;IACV,MAAM,EAAE;QACN,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,EAAE;KACT;IACD,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,UAAU,EAAE,CAAC;KACxC;CACF,CAAC,CAAC"}

package/dist/logic/roles/bhrain/getBhrainRole.js

@@ -32,19 +32,24 @@ thought tactics; intent = be composed into other roles
             brief: (0, getMechanicBrief_1.getMechanicBrief)('style.words.lowercase.md'),
         }),
     ],
-    skills: [
-        // khue primitives
-        stepDiverge_skill_1.SKILL_DIVERGE,
-        stepCluster_skill_1.SKILL_CLUSTER,
-        stepTriage_skill_1.SKILL_TRIAGE,
-        stepInstantiate_skill_1.SKILL_INSTANTIATE,
-        // know primitives
-        stepArticulate_skill_1.SKILL_ARTICULATE,
-        stepDemonstrate_skill_1.SKILL_DEMONSTRATE,
-        stepCatalogize_skill_1.SKILL_CATALOGIZE,
-        // goal primitives
-        // SKILL_INTERPRET; ask -> Focus[Goal]
-    ],
-    briefs: { dir: __dirname + '/.briefs' },
+    skills: {
+        dirs: [],
+        refs: [
+            // khue primitives
+            stepDiverge_skill_1.SKILL_DIVERGE,
+            stepCluster_skill_1.SKILL_CLUSTER,
+            stepTriage_skill_1.SKILL_TRIAGE,
+            stepInstantiate_skill_1.SKILL_INSTANTIATE,
+            // know primitives
+            stepArticulate_skill_1.SKILL_ARTICULATE,
+            stepDemonstrate_skill_1.SKILL_DEMONSTRATE,
+            stepCatalogize_skill_1.SKILL_CATALOGIZE,
+            // goal primitives
+            // SKILL_INTERPRET; ask -> Focus[Goal]
+        ],
+    },
+    briefs: {
+        dirs: [{ uri: __dirname + '/.briefs' }],
+    },
 });
 //# sourceMappingURL=getBhrainRole.js.map

package/dist/logic/roles/bhrain/getBhrainRole.js.map

@@ -1 +1 @@
-{"version":3,"file":"getBhrainRole.js","sourceRoot":"","sources":["../../../../src/logic/roles/bhrain/getBhrainRole.ts"],"names":[],"mappings":";;;AAAA,qCAA0C;AAE1C,mEAAgE;AAChE,kFAA2E;AAC3E,kFAA2E;AAC3E,qFAA8E;AAC9E,qDAAkD;AAClD,wEAAiE;AACjE,wEAAiE;AACjE,oFAA6E;AAC7E,qEAA8D;AAEjD,QAAA,WAAW,GAAG,cAAI,CAAC,KAAK,CAAC;IACpC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE;;;;GAIP,CAAC,IAAI,EAAE;IACR,MAAM,EAAE;QACN,mBAAS,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,iDAAiD;YACzD,KAAK,EAAE,IAAA,+BAAc,EAAC,cAAc,CAAC;SACtC,CAAC;QACF,mBAAS,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,8CAA8C;YACtD,KAAK,EAAE,IAAA,mCAAgB,EAAC,0BAA0B,CAAC;SACpD,CAAC;KACH;IACD,MAAM,EAAE;QACN,kBAAkB;QAClB,iCAAa;QACb,iCAAa;QACb,+BAAY;QACZ,yCAAiB;QAEjB,kBAAkB;QAClB,uCAAgB;QAChB,yCAAiB;QACjB,uCAAgB;QAEhB,kBAAkB;QAClB,sCAAsC;KACvC;IACD,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,GAAG,UAAU,EAAE;CACxC,CAAC,CAAC"}
+{"version":3,"file":"getBhrainRole.js","sourceRoot":"","sources":["../../../../src/logic/roles/bhrain/getBhrainRole.ts"],"names":[],"mappings":";;;AAAA,qCAA0C;AAE1C,mEAAgE;AAChE,kFAA2E;AAC3E,kFAA2E;AAC3E,qFAA8E;AAC9E,qDAAkD;AAClD,wEAAiE;AACjE,wEAAiE;AACjE,oFAA6E;AAC7E,qEAA8D;AAEjD,QAAA,WAAW,GAAG,cAAI,CAAC,KAAK,CAAC;IACpC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE;;;;GAIP,CAAC,IAAI,EAAE;IACR,MAAM,EAAE;QACN,mBAAS,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,iDAAiD;YACzD,KAAK,EAAE,IAAA,+BAAc,EAAC,cAAc,CAAC;SACtC,CAAC;QACF,mBAAS,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,8CAA8C;YACtD,KAAK,EAAE,IAAA,mCAAgB,EAAC,0BAA0B,CAAC;SACpD,CAAC;KACH;IACD,MAAM,EAAE;QACN,IAAI,EAAE,EAAE;QACR,IAAI,EAAE;YACJ,kBAAkB;YAClB,iCAAa;YACb,iCAAa;YACb,+BAAY;YACZ,yCAAiB;YAEjB,kBAAkB;YAClB,uCAAgB;YAChB,yCAAiB;YACjB,uCAAgB;YAEhB,kBAAkB;YAClB,sCAAsC;SACvC;KACF;IACD,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,UAAU,EAAE,CAAC;KACxC;CACF,CAAC,CAAC"}

package/dist/logic/roles/ecologist/getEcologistRole.js

@@ -19,12 +19,17 @@ Used to understand the physics, incentives, and causal flows beneath the system.
 
   `.trim(),
     traits: [],
-    skills: [
-    // SKILL_ENVISION_JOURNEY,
-    // SKILL_STUDY_DOMAIN,
-    // SKILL_DOMAIN_TERM_COLLECT_USECASES,
-    // SKILL_DOMAIN_TERM_DISTILL,
-    ],
-    briefs: { dir: __dirname + '/.briefs' },
+    skills: {
+        dirs: [],
+        refs: [
+        // SKILL_ENVISION_JOURNEY,
+        // SKILL_STUDY_DOMAIN,
+        // SKILL_DOMAIN_TERM_COLLECT_USECASES,
+        // SKILL_DOMAIN_TERM_DISTILL,
+        ],
+    },
+    briefs: {
+        dirs: [{ uri: __dirname + '/.briefs' }],
+    },
 });
 //# sourceMappingURL=getEcologistRole.js.map

package/dist/logic/roles/ecologist/getEcologistRole.js.map

@@ -1 +1 @@
-{"version":3,"file":"getEcologistRole.js","sourceRoot":"","sources":["../../../../src/logic/roles/ecologist/getEcologistRole.ts"],"names":[],"mappings":";;;AAAA,qCAA+B;AAE/B,kEAAkE;AAErD,QAAA,cAAc,GAAG,cAAI,CAAC,KAAK,CAAC;IACvC,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE;;;;;;;;;;GAUP,CAAC,IAAI,EAAE;IACR,MAAM,EAAE,EAAE;IACV,MAAM,EAAE;IACN,0BAA0B;IAC1B,sBAAsB;IACtB,sCAAsC;IACtC,6BAA6B;KAC9B;IACD,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,GAAG,UAAU,EAAE;CACxC,CAAC,CAAC"}
+{"version":3,"file":"getEcologistRole.js","sourceRoot":"","sources":["../../../../src/logic/roles/ecologist/getEcologistRole.ts"],"names":[],"mappings":";;;AAAA,qCAA+B;AAE/B,kEAAkE;AAErD,QAAA,cAAc,GAAG,cAAI,CAAC,KAAK,CAAC;IACvC,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE;;;;;;;;;;GAUP,CAAC,IAAI,EAAE;IACR,MAAM,EAAE,EAAE;IACV,MAAM,EAAE;QACN,IAAI,EAAE,EAAE;QACR,IAAI,EAAE;QACJ,0BAA0B;QAC1B,sBAAsB;QACtB,sCAAsC;QACtC,6BAA6B;SAC9B;KACF;IACD,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,UAAU,EAAE,CAAC;KACxC;CACF,CAAC,CAAC"}

package/dist/logic/roles/getRoleRegistry.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRoleRegistry = void 0;
 const rhachet_1 = require("rhachet");
+const getArchitectRole_1 = require("./architect/getArchitectRole");
 const getBhrainRole_1 = require("./bhrain/getBhrainRole");
 // import { ROLE_ECOLOGIST } from './ecologist/getEcologistRole';
 const getRoleRegistry_readme_1 = require("./getRoleRegistry.readme");
@@ -19,6 +20,7 @@ const getRoleRegistry = () => new rhachet_1.RoleRegistry({
     roles: [
         getBhrainRole_1.ROLE_BHRAIN, // todo: lift bhrain role into own repo
         // ROLE_ECOLOGIST,
+        getArchitectRole_1.ROLE_ARCHITECT,
         getMechanicRole_1.ROLE_MECHANIC,
         getCommanderRole_1.ROLE_COMMANDER,
     ],

package/dist/logic/roles/getRoleRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"getRoleRegistry.js","sourceRoot":"","sources":["../../../src/logic/roles/getRoleRegistry.ts"],"names":[],"mappings":";;;AAAA,qCAAuC;AAEvC,0DAAqD;AACrD,iEAAiE;AACjE,qEAAoE;AACpE,gEAA2D;AAC3D,4EAAuE;AAEvE;;;;;GAKG;AACI,MAAM,eAAe,GAAG,GAAiB,EAAE,CAChD,IAAI,sBAAY,CAAC;IACf,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,iDAAwB;IAChC,KAAK,EAAE;QACL,2BAAW,EAAE,uCAAuC;QACpD,kBAAkB;QAClB,+BAAa;QAEb,iCAAc;KACf;CACF,CAAC,CAAC;AAXQ,QAAA,eAAe,mBAWvB"}
+{"version":3,"file":"getRoleRegistry.js","sourceRoot":"","sources":["../../../src/logic/roles/getRoleRegistry.ts"],"names":[],"mappings":";;;AAAA,qCAAuC;AAEvC,mEAA8D;AAC9D,0DAAqD;AACrD,iEAAiE;AACjE,qEAAoE;AACpE,gEAA2D;AAC3D,4EAAuE;AAEvE;;;;;GAKG;AACI,MAAM,eAAe,GAAG,GAAiB,EAAE,CAChD,IAAI,sBAAY,CAAC;IACf,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,iDAAwB;IAChC,KAAK,EAAE;QACL,2BAAW,EAAE,uCAAuC;QACpD,kBAAkB;QAClB,iCAAc;QACd,+BAAa;QAEb,iCAAc;KACf;CACF,CAAC,CAAC;AAZQ,QAAA,eAAe,mBAYvB"}

package/dist/logic/roles/mechanic/.briefs/criteria.practices/never.term.script.md

@@ -0,0 +1,7 @@
+never use the term `script`
+
+it's overloaded
+
+choose what exactly its purpose is
+
+- adhoc usage? => `command`

package/dist/logic/roles/mechanic/.briefs/criteria.practices/prefer.emojis.chill_nature.md

@@ -0,0 +1,24 @@
+prefer the inclusion of emojis in comments and logs, to make things easier to grok
+
+prefer chill, nature based emojis, to give a zen vibe
+
+---
+
+careful not to do emojis - and try and reuse emojis based on similarities
+
+ideally, no more than 5-7 different emojis would be present at a time, and typically, only for imporant callouts
+
+---
+
+otherwise, use neutral and chill unicode characters for bulletpoints and etc
+
+
+---
+
+e.g.,
+
+⛈️ = error
+🔭 = lookup
+✨ = success
+🌿 = output
+🌊 = outcome

package/dist/logic/roles/mechanic/.briefs/criteria.practices/prefer.jq.over_alt.[demo].md

@@ -0,0 +1,29 @@
+# given
+
+you are in a .shell env
+
+# what
+
+prefer `jq` over escape to other languages, like python
+
+# demo
+
+### bad practice
+
+```sh
+  local instance_id
+  instance_id=$(echo "$instance_json" | python3 -c "
+import sys, json
+data = json.load(sys.stdin)
+if data and data != 'None':
+  print(data.get('InstanceId', ''))
+" 2>/dev/null)
+```
+
+
+### best practice
+
+```sh
+  local instance_id
+  instance_id=$(echo "$instance_json" | jq -r '.InstanceId // empty' 2>/dev/null)
+```

package/dist/logic/roles/mechanic/.briefs/criteria.practices/prefer.terraform.[criteria].md

@@ -0,0 +1,4 @@
+given('a command which modifies infrastructure')
+  when('it does not leverage terraform')
+    then('flag it as a BLOCKER')
+      sothat('we manage all infrastructure via terraform')

package/dist/logic/roles/mechanic/.briefs/criteria.practices/prefer.terraform.[seed].md

@@ -0,0 +1,17 @@
+.what = use terraform rather than adhoc .shell commands to manage infra
+
+.why =
+  - terraform is declarative
+    - enables you to declare desires and compare reality
+    - simpler to review for issues, since you see the final product explicitly in code
+    - simpler to review for issues, since you see divergence with reality
+    - enables drift detection
+    - more
+
+---
+
+if your goal is to change infra (add resources, del resources, set resources) => use terraform
+
+---
+
+note = code.actors make it very easy to sync terraform state && go from wish => critera => done

package/dist/logic/roles/mechanic/.briefs/criteria.practices/require.dependency.pinned_versions.md

@@ -0,0 +1,3 @@
+always pin versions of dependencies to exact versions
+
+this eliminates surprise changes when our dependencies dont respect semver notation and have an surprise backwards-incompat change

package/dist/logic/roles/mechanic/.briefs/criteria.practices/require.idempotency.md

@@ -0,0 +1,33 @@
+idempotency is a must
+
+we must always assume that retries will occur
+- user will forget if they ran it or not
+- code will compose dependent flows that may need to repeat operations safely
+- apps will face network errors and retry requests
+
+idempotency means that the same request duplicated will succeed as if it only ran once
+
+---
+
+the main methods of doing so are via
+
+- findsert = find or insert
+  - const before = dao.findByRef()
+  - if (before && nonDiff) return before
+  - if (before && hasDiff) BadRequestError.throw('can not findsert; entity already exists but with different attributes')
+  - const after = dao.upsert()
+  - return after
+
+- upsert = update or insert
+  - this is a standard operation often handled at the database layer
+  - simply always overwrite, idempotently
+
+---
+
+why are these the two main modes?
+
+because otherwise the only other option is to throw an error on duplicate requests
+
+there are fundamentally no other ways to support idempotency
+- if it doesn't exist, great -> insert
+- if it does exist, decide -> update (upsert) or retain (findsert)

package/dist/logic/roles/mechanic/getMechanicRole.js

@@ -18,7 +18,12 @@ exports.ROLE_MECHANIC = rhachet_1.Role.build({
 Used to write and revise the actual logic that runs the system.
   `.trim(),
     traits: [],
-    skills: [loopWrite_skill_1.SKILL_WRITE, getSkillCodePropose_1.SKILL_CODE_PROPOSE],
-    briefs: { dir: __dirname + '/.briefs' },
+    skills: {
+        dirs: [],
+        refs: [loopWrite_skill_1.SKILL_WRITE, getSkillCodePropose_1.SKILL_CODE_PROPOSE],
+    },
+    briefs: {
+        dirs: [{ uri: __dirname + '/.briefs' }],
+    },
 });
 //# sourceMappingURL=getMechanicRole.js.map

package/dist/logic/roles/mechanic/getMechanicRole.js.map

@@ -1 +1 @@
-{"version":3,"file":"getMechanicRole.js","sourceRoot":"","sources":["../../../../src/logic/roles/mechanic/getMechanicRole.ts"],"names":[],"mappings":";;;AAAA,qCAA+B;AAE/B,sEAAkE;AAClE,6DAAsD;AAEzC,QAAA,aAAa,GAAG,cAAI,CAAC,KAAK,CAAC;IACtC,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE;;;;;;;;GAQP,CAAC,IAAI,EAAE;IACR,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,CAAC,6BAAW,EAAE,wCAAkB,CAAC;IACzC,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,GAAG,UAAU,EAAE;CACxC,CAAC,CAAC"}
+{"version":3,"file":"getMechanicRole.js","sourceRoot":"","sources":["../../../../src/logic/roles/mechanic/getMechanicRole.ts"],"names":[],"mappings":";;;AAAA,qCAA+B;AAE/B,sEAAkE;AAClE,6DAAsD;AAEzC,QAAA,aAAa,GAAG,cAAI,CAAC,KAAK,CAAC;IACtC,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE;;;;;;;;GAQP,CAAC,IAAI,EAAE;IACR,MAAM,EAAE,EAAE;IACV,MAAM,EAAE;QACN,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,CAAC,6BAAW,EAAE,wCAAkB,CAAC;KACxC;IACD,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,UAAU,EAAE,CAAC;KACxC;CACF,CAAC,CAAC"}

package/dist/logic/roles/terminal.commander/getCommanderRole.js

@@ -30,7 +30,12 @@ a helpful terminal commander, at your service
             brief: (0, getMechanicBrief_1.getMechanicBrief)('style.words.lowercase.md'),
         }),
     ],
-    skills: [stepPlanCommand_skill_1.SKILL_COMMAND_PLAN, stepExecCommand_skill_1.SKILL_COMMAND_EXEC],
-    briefs: { dir: __dirname + '/.briefs' },
+    skills: {
+        dirs: [],
+        refs: [stepPlanCommand_skill_1.SKILL_COMMAND_PLAN, stepExecCommand_skill_1.SKILL_COMMAND_EXEC],
+    },
+    briefs: {
+        dirs: [{ uri: __dirname + '/.briefs' }],
+    },
 });
 //# sourceMappingURL=getCommanderRole.js.map

package/dist/logic/roles/terminal.commander/getCommanderRole.js.map

@@ -1 +1 @@
-{"version":3,"file":"getCommanderRole.js","sourceRoot":"","sources":["../../../../src/logic/roles/terminal.commander/getCommanderRole.ts"],"names":[],"mappings":";;;AAAA,qCAA0C;AAE1C,6DAA0D;AAC1D,mEAAgE;AAChE,gFAA0E;AAC1E,gFAA0E;AAE7D,QAAA,cAAc,GAAG,cAAI,CAAC,KAAK,CAAC;IACvC,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,sBAAsB;IAC/B,MAAM,EAAE;;;;;;;GAOP,CAAC,IAAI,EAAE;IACR,MAAM,EAAE;QACN,mBAAS,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,iDAAiD;YACzD,KAAK,EAAE,IAAA,+BAAc,EAAC,cAAc,CAAC;SACtC,CAAC;QACF,mBAAS,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,8CAA8C;YACtD,KAAK,EAAE,IAAA,mCAAgB,EAAC,0BAA0B,CAAC;SACpD,CAAC;KACH;IACD,MAAM,EAAE,CAAC,0CAAkB,EAAE,0CAAkB,CAAC;IAChD,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,GAAG,UAAU,EAAE;CACxC,CAAC,CAAC"}
+{"version":3,"file":"getCommanderRole.js","sourceRoot":"","sources":["../../../../src/logic/roles/terminal.commander/getCommanderRole.ts"],"names":[],"mappings":";;;AAAA,qCAA0C;AAE1C,6DAA0D;AAC1D,mEAAgE;AAChE,gFAA0E;AAC1E,gFAA0E;AAE7D,QAAA,cAAc,GAAG,cAAI,CAAC,KAAK,CAAC;IACvC,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,sBAAsB;IAC/B,MAAM,EAAE;;;;;;;GAOP,CAAC,IAAI,EAAE;IACR,MAAM,EAAE;QACN,mBAAS,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,iDAAiD;YACzD,KAAK,EAAE,IAAA,+BAAc,EAAC,cAAc,CAAC;SACtC,CAAC;QACF,mBAAS,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,8CAA8C;YACtD,KAAK,EAAE,IAAA,mCAAgB,EAAC,0BAA0B,CAAC;SACpD,CAAC;KACH;IACD,MAAM,EAAE;QACN,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,CAAC,0CAAkB,EAAE,0CAAkB,CAAC;KAC/C;IACD,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,UAAU,EAAE,CAAC;KACxC;CACF,CAAC,CAAC"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet-roles-ehmpathy",
   "author": "ehmpathy",
   "description": "empathetic software construction roles and skills, via rhachet",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "repository": "ehmpathy/rhachet-roles-ehmpathy",
   "homepage": "https://github.com/ehmpathy/rhachet-roles-ehmpathy",
   "keywords": [
@@ -57,7 +57,7 @@
     "helpful-errors": "1.3.8",
     "inquirer": "12.7.0",
     "openai": "5.8.2",
-    "rhachet": "1.10.0",
+    "rhachet": "1.11.0",
     "rhachet-artifact": "1.0.0",
     "rhachet-artifact-git": "1.1.0",
     "serde-fns": "1.2.0",