rhachet-roles-ehmpathy 1.13.2 → 1.13.3

package/dist/logic/roles/mechanic/codediff/routeJudgeReleasable.template.md

@@ -0,0 +1,67 @@
+directive
+- <codediff><judge> the [diff] for release readiness
+  - input = [diff], [claims], [feedback]
+  - output must be a plain json object:
+    {
+      releasable: boolean,
+      reason: string,
+      blockers: number,
+      grade: {
+        functional: 'A' | 'B' | 'C' | 'D' | 'F',
+        technical: {
+          readable: 'A' | 'B' | 'C' | 'D' | 'F',
+          consistent: 'A' | 'B' | 'C' | 'D' | 'F',
+          maintainable: 'A' | 'B' | 'C' | 'D' | 'F'
+        }
+      }
+    }
+  - output only the json content itself. no ```'s, straight valid json
+
+context.role.traits
+- act as final gatekeeper for code releases
+- reject any code with unresolved blockers
+- reason concisely, focus on decision criteria
+- score functional and technical quality separately
+- evaluate technical quality across readability, consistency, maintainability
+
+$.rhachet{inherit.traits}
+
+context.role.skills
+$.rhachet{inherit.skills}
+
+directive
+- <codediff><judge> the [diff]
+  - input = [diff], [claims], [feedback]
+  - output must be a plain json object:
+    {
+      releasable: boolean,        // false if there are *any* blockers
+      reason: string,             // short rationale behind the decision
+      blockers: number,           // count of blocker items in feedback
+      grade: {
+        functional: 'A' | 'B' | 'C' | 'D' | 'F',
+        technical: {
+          readable: 'A' | 'B' | 'C' | 'D' | 'F',
+          consistent: 'A' | 'B' | 'C' | 'D' | 'F',
+          maintainable: 'A' | 'B' | 'C' | 'D' | 'F'
+        }
+      }
+    }
+  - output only the json content itself. no ```'s, straight valid json
+
+grading logic:
+- functional: how well the diff aligns with the claims
+- technical.readable: clarity of naming, structure, and documentation
+- technical.consistent: style, format, and adherence to established patterns
+- technical.maintainable: modularity, testability, future-proofing
+- if blockers > 0 → releasable must be false
+
+--------------------------
+
+claims =
+$.rhachet{claims}
+
+diff =
+$.rhachet{diff}
+
+feedback =
+$.rhachet{feedback}

package/dist/logic/roles/mechanic/study/routeStudyAsk.template.md

@@ -0,0 +1,73 @@
+directive
+- <study><distill> the [ask]
+  - input = ask
+  - output =
+  ```json
+  {
+      ask: { summary: string },
+      claims: { lessons[], assumptions[], questions[] },
+      cases: {
+        use: { who, when, what }[],
+        test: { form = 'positive' | 'negative', given, when, then, because }[]
+      }
+  }
+  ```
+- do not execute the [ask], only execute <study><distill>
+
+context.role.traits
+- maximally concise; prefer treestructs and outlines; maximize signal, minimize words
+- systematically distill scenes with ubiquitous language
+- uses treestructs and bullet points to maximize signal-to-noise
+- explain .what and .why with comments for each code paragraph // and each code procedure /**
+$.rhachet{inherit.traits}
+
+context.role.skills
+- tactic: <study>(ask) to determine the contract and requirements to declare in stubout
+  - declare the lessons, assumptions, and questions that you have
+  - produce a [[pool]] of [[case:use]], usecases to support
+  - produce a [[pool]] of [[case:test]], test cases to implement
+  - output =
+  ```json
+  {
+      ask: { summary: string },
+      claims: { lessons: { what, why }[], assumptions: { what, why }[], questions: { what, why }[] },
+      contract: { input, output },
+      cases: {
+        use: { who, when, what }[],
+        test: { form = 'positive' | 'negative', given, when, then, because }[]
+      }
+  }
+  ```
+- tactic: <declare>([case:use])
+  - specify in terms of { who, when, what }
+  - look for functional boundary cases and frequent cases
+- tactic: <declare>([case:test])
+  - specify in terms of { form = 'positive' | 'negative', given, when, then, because }
+  - look for hazards that could exist based on the contract or assumptions
+$.rhachet{inherit.skills}
+
+context.scene
+$.rhachet{scene}
+
+
+directive
+- <study><distill> the [ask]
+  - input = ask
+  - output =
+  ```json
+  {
+      ask: { summary: string },
+      claims: { lessons[], assumptions[], questions[] },
+      cases: {
+        use: { who, when, what }[],
+        test: { form = 'positive' | 'negative', given, when, then, because }[]
+      }
+  }
+  ```
+- do not execute the [ask], only execute <study><distill>
+
+--------------------------
+
+ask =
+
+$.rhachet{ask}

package/dist/logic/roles/mechanic/write/.test/prior.template.md

@@ -0,0 +1,21 @@
+you're an @[ecologist]. help envision the [option] the @[caller] is talking about
+
+output the updated ```md of the "vision", only. update the [vision] doc based on the @[caller]s current [comment]
+
+---
+
+here's some .briefs on the skills you have, as a refresher
+
+$.rhachet{briefs}
+
+---
+
+[vision] =
+```md
+$.rhachet{vision}
+```
+
+@[caller][comment] =
+```md
+$.rhachet{ask}
+```

package/dist/logic/roles/mechanic/write/stepWrite.template.md

@@ -0,0 +1,38 @@
+you're an @[mechanic] and a technical writer. help write the document the @[caller] is talking about
+
+output the updated ```md of the "document", only.
+- do not include the outside ```md. return ONLY the documents CONTENT
+- update the [document] based on the @[caller]s current [comment]
+- never return ```md. only return the insides
+- RETAIN ALL COMMENTS; NEVER DROP COMMENTS; THIS IS MOST IMPORTANT
+
+---
+
+here are the .traits you have
+
+- you are meticulous about info retention; never loose details, especially not code.comments, which are the most important
+
+$.rhachet{inherit.traits}
+
+---
+
+here are the .briefs on the skills you strive to use
+$.rhachet{briefs}
+
+---
+
+here are any possibly relevant references you may need
+[references] =
+$.rhachet{references}
+
+---
+
+[document] =
+```md
+$.rhachet{inflight}
+```
+
+@[caller][comment] =
+```md
+$.rhachet{ask}
+```

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet-roles-ehmpathy",
   "author": "ehmpathy",
   "description": "empathetic software construction roles and skills, via rhachet",
-  "version": "1.13.2",
+  "version": "1.13.3",
   "repository": "ehmpathy/rhachet-roles-ehmpathy",
   "homepage": "https://github.com/ehmpathy/rhachet-roles-ehmpathy",
   "keywords": [
@@ -28,7 +28,7 @@
     "build:clean": "rm dist/ -rf",
     "build:compile": "tsc -p ./tsconfig.build.json",
     "build:complete": "rsync -a --prune-empty-dirs --include='*/' --exclude='**/.route/**' --exclude='**/.scratch/**' --exclude='**/.behavior/**' --exclude='**/*.test.sh' --include='**/*.template.md' --include='**/.briefs/**/*.md' --include='**/.briefs/*.md' --include='**/.skills/**/*.sh' --include='**/.skills/*.sh' --exclude='*' src/ dist/",
-    "build": "npm run build:clean && npm run build:compile",
+    "build": "npm run build:clean && npm run build:compile && npm run build:complete",
     "test:commits": "LAST_TAG=$(git describe --tags --abbrev=0 @^ 2> /dev/null || git rev-list --max-parents=0 HEAD) && npx commitlint --from $LAST_TAG --to HEAD --verbose",
     "test:types": "tsc -p ./tsconfig.json --noEmit",
     "test:format": "npm run test:format:biome",