rhachet-roles-ehmpathy 1.8.0 → 1.9.0

package/dist/logic/roles/mechanic/.briefs/patterns/code.test.howto/best-practice/whento.snapshots.[lesson].md

@@ -0,0 +1,23 @@
+use snapshots whenever output artifacts are created
+
+why?
+- makes it easier to review in prs what is actually being produced
+  - e.g., visual spotcheck, make sure it looks good
+  - especially important when the output is userfacing (e.g., codegen, comms, etc)
+
+- makes it easier to detect exactly what the impact of a change is
+  - most of the time its intended and the snapshot can just be updated
+  - sometimes though, the snapshot diff exposes critical differences that are blockers or nitpicks that need to be addressed
+
+
+---
+
+critical:
+
+use both
+- a snapshot
+- AND
+- explicit assertions before the snapshot
+
+snapshot is for observability in code reviews and aesthetic verification
+assertions are for functional verification

package/dist/logic/roles/mechanic/.briefs/patterns/lang.terms/.readme.md

@@ -0,0 +1 @@
+practices on which terms to use to promote a ubiquitous language go here

package/dist/logic/roles/mechanic/.briefs/patterns/lang.terms/domain=practices.terms=forbid_prefer_desire_require.md

@@ -0,0 +1,13 @@
+these are the terms we use to describe how to use practices
+
+forbid = search to ensure this was not done
+- it's a bad practice
+- it's a BLOCKER if detected
+
+prefer = search for opportunities to do this
+- it's a best practice, but not mandatory
+- it's a NITPICK if detected
+
+require = search for opportunities to do this
+- it's a best practice, and is mandatory
+- it's a BLOCKER if detected

package/dist/logic/roles/mechanic/.briefs/patterns/lang.terms/domain=software.terms=prodcode_vs_testcode.md

@@ -0,0 +1,7 @@
+prodcode = the product's code
+- the code that produces the behavior users experience
+- the code that gets shipped to production
+
+testcode = the builder's code
+- the code that verifies the behaviors users experience
+- the code that runs at build time to protect production

package/dist/logic/roles/mechanic/.briefs/patterns/lang.tones/.readme.md

@@ -0,0 +1,3 @@
+briefs on what tones to use in writing goes here
+
+tones impact how things are thought about, so they are important to curate

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

@@ -19,7 +19,7 @@ Used to write and revise the actual logic that runs the system.
   `.trim(),
     traits: [],
     skills: {
-        dirs: [],
+        dirs: [{ uri: __dirname + '/.skills' }],
         refs: [loopWrite_skill_1.SKILL_WRITE, getSkillCodePropose_1.SKILL_CODE_PROPOSE],
     },
     briefs: {

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;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"}
+{"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,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,UAAU,EAAE,CAAC;QACvC,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/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet-roles-ehmpathy",
   "author": "ehmpathy",
   "description": "empathetic software construction roles and skills, via rhachet",
-  "version": "1.8.0",
+  "version": "1.9.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.11.0",
+    "rhachet": "1.12.1",
     "rhachet-artifact": "1.0.0",
     "rhachet-artifact-git": "1.1.0",
     "serde-fns": "1.2.0",

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

@@ -1,35 +0,0 @@
-[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

@@ -1,20 +0,0 @@
-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
-