rhachet-roles-ehmpathy 1.7.0 → 1.9.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].v3.md

@@ -0,0 +1,87 @@
+use this brief to help you declare acceptance test criteria for .behavior
+
+in BDD given/when/then format
+
+================================
+
+recall:
+- acceptance.criteria should only test BEHAVIOR; never internals
+- acceptance.criteria should treat the system as a black box
+  - it doesn't care how it gets done and has no visibility into it
+  - it only cares that the usecases are satisfied for the given scenes
+  - it only engages with the system at the CONTRACT LAYER
+    - src/contract/endpoints (a.k.a. src/contract/handlers)
+    - src/contract/commands
+
+
+distinguish the criteria into
+
+BLOCKER = required; will not satisfy requireemnts without it
+and
+NITPICK = nicetohave, but not a show stoppeer
+
+
+================================
+
+here's some examples of what i mean
+
+
+[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.,
+
+usecase(purpose)
+  given(scene)
+    when(cause)
+      sothat(benefit)
+        then(effect.1)
+        then(effect.2)
+
+
+---
+
+
+e.g.,
+
+usecase(eat dinner)
+  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)
+
+
+
+
+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/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/architecture/directional-dependencies.md

@@ -5,7 +5,7 @@ enforce strict top-down dependency flow across layered system boundaries — low
 
 .scope
 - applies to all folders and modules within `src/`
-- required for `contract/`, `logic/`, `data/`, and `domain/` folders
+- required for `contract/`, `access/`, `domain.objects/`, `domain.operations/`
 - governs imports, module references, and stitched flow boundaries
 
 .why
@@ -15,59 +15,68 @@ enforce strict top-down dependency flow across layered system boundaries — low
 - aligns with `arch:bounded-contexts` and enables predictable top-down orchestration
 
 .structure
-```
+\`\`\`
 src/
-  contract/        // topmost — public interfaces, local commands
-    endpoints/     // exposed APIs
-    commands/      // internal entrypoints (e.g. CLI, scripts)
-  logic/           // application procedures, stitched flows
-  data/            // infrastructure layer (daos, sdks, services)
-    daos/          // persistence logic — may reference domain objects
-    sdks/          // external clients — may reference domain types
-  domain/          // lowest — domain models, business rules
-    objects/       // canonical domain declarations
-```
+  contract/            // topmost — public interfaces, local commands
+    api/               // public invocable api endpoints, deployed and exposed by the project; e.g., via `aws-lambda`
+    cmd/               // private internal use entrypoints, supported by the project; e.g., via `as-command`
+    sdk/               // public software development kit exports, supported by the project; e.g., `export ...`
+    cli/               // public command line interface contracts, supported by the project; e.g., via `commander`
+
+  access/              // infrastructure layer (daos, sdks, svcs)
+    daos/              // private persistence logic — may reference domain objects
+    sdks/              // remote third party contracts, from any alt org — may declare their own domain.objects
+    svcs/              // remote first party contracts, from our own org — may declare their own domain.objects
+
+  domain.objects/      // canonical domain declarations
+  domain.operations/   // domain behavior + business rules
+
+  infra/               // infrastructure specific adapters
+\`\`\`
 
 .how
 - each layer may depend **only on the layers below it**
-  - `contract/` may depend on `logic/`, `data/`, `domain/`
-  - `logic/` may depend on `data/`, `domain/`
-  - `data/` may depend on `domain/`
-  - `domain/` must not depend on anything outside its own layer
-- stitched flows live in `logic/` or `contract/commands/` and orchestrate downstream only
-- never import upward across layers (e.g. `domain/` importing `data/`)
-- shared types must follow same directional rules
+  - `contract/` may depend on `domain.objects/` and `domain.operations/`
+  - `access/` may depend on `domain.objects/` and `domain.operations/`
+  - `domain.operations/` may depend on `domain.objects/` or `infra/`
+  - `domain.objects/` must not depend on anything outside its own layer
+  - `infra/` must not depend on anything outside its own layer
+
+- stitched flows live in `domain.operations/` or `contract/commands/` and orchestrate downstream only
+- never import upward across layers (e.g., `domain.objects/` importing `access/`)
+- shared types must follow the same directional rules
 
 .enforcement
-- imports that violate top-down boundary = BLOCKER
-- circular dependencies between layers = BLOCKER
-- logic in `domain/` must never reach into `data/`, `logic/`, or `contract/`
-- logic in `data/` may use `domain/`, but must stay decoupled from business rules
+- imports that violate top-down boundary = **BLOCKER**
+- circular dependencies between layers = **BLOCKER**
+- logic in `domain.objects/` must never reach into `access/`, `contract/`, or `domain.operations/`
+- logic in `domain.operations/` must not reference infrastructure concerns; they can can only leverage `infra/` adapters
+- logic in `access/` may use domain layers but must remain free of domain knowledge and business rules
+- logic in `infra/` must remain free of domain knowledge and business rules
 
 .examples
 
 ✅ positive
-```ts
+\`\`\`ts
 // contract/endpoints/sendInvoice.ts
-import { generateInvoice } from '@/logic/generateInvoice';
+import { generateInvoice } from '@/domain.operations/generateInvoice';
+import { invoiceDao } from '@/access/daos/invoiceDao';
 
-// logic/submitJob.ts
-import { Job } from '@/domain/objects/Job';
-import { jobDao } from '@/data/daos/jobDao';
+// access/daos/jobDao.ts
+import { Job } from '@/domain.objects/Job';
 
-// data/daos/jobDao.ts
-import { Job } from '@/domain/objects/Job';
-```
+// domain.operations/calculateTotal.ts
+import { LineItem } from '@/domain.objects/LineItem';
+\`\`\`
 
 ❌ negative
-```ts
-// domain/Customer.ts
-import { customerDao } from '@/data/daos/customerDao'; // ⛔ illegal upward import
-
-// domain/Invoice.ts
-import { calculateTotal } from '@/logic/calculateTotal'; // ⛔ direction violation
+\`\`\`ts
+// domain.objects/Customer.ts
+import { customerDao } from '@/access/daos/customerDao'; // ⛔ illegal upward import
 
-// data/sdkWrapper.ts
-import { dispatchFlow } from '@/logic/' // ⛔ bottom-up reference
-```
+// domain.operations/InvoiceOps.ts
+import { runFlow } from '@/contract/commands'; // ⛔ direction violation
 
+// access/svcs/sdkWrapper.ts
+import { dispatchFlow } from '@/contract/'; // ⛔ bottom-up reference
+\`\`\`

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/.briefs/criteria.practices/require.knowledge.externalized.md

@@ -0,0 +1,17 @@
+if using a tool dependency that is not already fully understood with internalized knowledge
+
+first, it is mandatory to externalize knowledge about that tool
+
+for example
+- what is it
+- when was it released
+- how much does it cost
+- how to use it
+
+- what are advantages and devantages? boons and banes?
+
+---
+
+research this always via a websearch first
+
+and always cite your sources

package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.contract.inputs.nameargs/bad-practice/forbid.positional-args.md

@@ -0,0 +1,43 @@
+positional args are
+- hard to read
+- easy to break
+
+never use positional args if we can avoid them
+
+
+even in bash!
+
+
+---
+
+e.g., which one's easier to understand?
+
+
+```sh
+  # final attempt with fail_on_error=true (exits on hard failures, warns on timeout)
+  _try_start_port_forwarding "$instance_id" "$rds_endpoint" 60 true
+```
+
+
+vs
+
+```sh
+
+  # final attempt with fail_on_error=true (exits on hard failures, warns on timeout)
+  _try_start_port_forwarding \
+    instance_id="$instance_id" \
+    rds_endpoint="$rds_endpoint" \
+    timeout=60 \
+    fail_on_error=true
+```
+
+
+---
+
+
+
+  - Self-documenting: You can see what each parameter is at the call site
+  - Order-independent: Arguments can be passed in any order
+  - Easier to maintain: Adding new optional parameters won't break existing calls
+  - Validation: Each function validates required parameters
+  - Usage examples: Included in function headers

package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.contract.inputs.nameargs/best-practice/require.namedargs.md

@@ -0,0 +1,6 @@
+always used named arguments on inputs
+
+they make it clear when reading what the arguments are used for
+
+they also make it possible to reorder arguments without breaking the contract (great for refactors, deprecations, renames, etc)
+