rhachet-roles-bhrain 0.1.0

package/dist/roles/thinker/skills/khue.triage/stepTriage.skill.d.ts

@@ -0,0 +1,29 @@
+export declare const SKILL_TRIAGE: import("rhachet").RoleSkill<import("rhachet").GStitcher<import("rhachet").Threads<{
+    caller: import("rhachet").RoleContext<"caller", {
+        art: {
+            feedback: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+            'foci.goal.concept': import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+            'foci.goal.context': import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+            'foci.input.concept': import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+        refs: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>[];
+    } & {
+        ask: string;
+        art: {
+            feedback: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    }>;
+    thinker: import("rhachet").RoleContext<"thinker", {
+        art: {
+            'focus.concept': import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+            'focus.context': import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+        briefs: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>[];
+    } & {
+        art: {
+            "focus.concept": import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    }>;
+}>, import("../../../../access/sdk/sdkOpenAi").ContextOpenAI & import("as-procedure").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    feedback: import("rhachet-artifact-git").GitFile | null;
+}>>;

package/dist/roles/thinker/skills/khue.triage/stepTriage.skill.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_TRIAGE = void 0;
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const genContextLogTrail_1 = require("../../../../.test/genContextLogTrail");
+const genContextStitchTrail_1 = require("../../../../.test/genContextStitchTrail");
+const getContextOpenAI_1 = require("../../../../.test/getContextOpenAI");
+const stepTriage_1 = require("./stepTriage");
+exports.SKILL_TRIAGE = (0, rhachet_1.genRoleSkill)({
+    slug: 'triage',
+    route: stepTriage_1.loopTriage,
+    threads: {
+        lookup: {
+            output: {
+                source: 'process.argv',
+                char: 'o',
+                desc: 'the output file to write against',
+                type: 'string',
+            },
+            input: {
+                source: 'process.argv',
+                char: 'i',
+                desc: 'the input file to seed from',
+                type: 'string',
+            },
+            goal: {
+                source: 'process.argv',
+                char: 'g',
+                desc: 'the goal of the request',
+                type: '?string',
+            },
+            references: {
+                source: 'process.argv',
+                char: 'f',
+                desc: 'reference files to to use, if any; delimit with commas',
+                type: '?string',
+            },
+            briefs: {
+                source: 'process.argv',
+                char: 'b',
+                desc: 'brief files to to use, if any; delimit with commas',
+                type: '?string',
+            },
+        },
+        assess: (input) => typeof input.output === 'string',
+        instantiate: async (input) => {
+            // declare where all the artifacts will be found
+            const obsDir = (0, rhachet_artifact_git_1.getArtifactObsDir)({ uri: input.output });
+            const artifacts = {
+                goal: {
+                    concept: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.goal.concept.md' }, { versions: true }),
+                    context: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.goal.context.md' }, { versions: true }),
+                },
+                feedback: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.feedback.md' }, { versions: true }),
+                'focus.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.focus.context.md' }, { versions: true }),
+                'focus.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.output }, { versions: true }),
+                input: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.input }, { versions: true }),
+                references: input.references
+                    ?.split(',')
+                    .filter((uri) => !!uri)
+                    .map((reference) => (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: reference }, { access: 'readonly' })) ?? [],
+                briefs: input.briefs
+                    ?.split(',')
+                    .filter((uri) => !!uri)
+                    .map((brief) => (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: brief }, { access: 'readonly' })) ?? [],
+            };
+            // detect the goal of the caller
+            const goalConcept = await (async () => {
+                // if goal explicitly defined, use it
+                if (input.goal)
+                    return ((await (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.goal }, { access: 'readonly' }).get())?.content ?? input.ask);
+                // otherwise, assume its the ask
+                return input.ask;
+            })();
+            await artifacts.goal.concept.set({ content: goalConcept });
+            return {
+                caller: await (0, rhachet_1.enrollThread)({
+                    role: 'caller',
+                    stash: {
+                        ask: '',
+                        art: {
+                            'foci.goal.concept': artifacts.goal.concept,
+                            'foci.goal.context': artifacts.goal.context,
+                            'foci.input.concept': artifacts.input,
+                            feedback: artifacts.feedback,
+                        },
+                        refs: artifacts.references,
+                    },
+                }),
+                thinker: await (0, rhachet_1.enrollThread)({
+                    role: 'thinker',
+                    stash: {
+                        art: {
+                            'focus.context': artifacts['focus.context'],
+                            'focus.concept': artifacts['focus.concept'],
+                        },
+                        briefs: [
+                            ...artifacts.briefs,
+                            ...stepTriage_1.BRIEFS_FOR_TRIAGE, // flow the triage briefs down so that <ponder> has them in context too; this approach does cause duplicate briefs for triage, but thats no biggie
+                        ],
+                    },
+                }),
+            };
+        },
+    },
+    context: {
+        lookup: {
+            apiKeyOpenai: {
+                source: 'process.env',
+                envar: 'PREP_OPENAI_KEY',
+                desc: 'the openai key to use',
+                type: 'string',
+            },
+        },
+        assess: (input) => typeof input.apiKeyOpenai === 'string',
+        instantiate: () => {
+            return {
+                ...(0, getContextOpenAI_1.getContextOpenAI)(),
+                ...(0, genContextLogTrail_1.genContextLogTrail)(),
+                ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+            };
+        },
+    },
+    readme: '',
+});
+//# sourceMappingURL=stepTriage.skill.js.map

package/dist/roles/thinker/skills/khue.triage/stepTriage.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepTriage.skill.js","sourceRoot":"","sources":["../../../../../src/roles/thinker/skills/khue.triage/stepTriage.skill.ts"],"names":[],"mappings":"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"}

package/dist/roles/thinker/skills/khue.triage/stepTriage.template.md

@@ -0,0 +1,128 @@
+# 🗣️ prompt: `<triage>` — prioritize and sort concepts by guiding questions
+
+You are a **@[thinker]** performing the **prioritization tactic** `<triage>`.
+
+---
+
+## 📜 contract
+For `<triage>` to work as intended:
+
+input = [seed][concepts]
+- a **list of concepts** (tasks, ideas, issues, or elements) to be triaged
+- the list may be long, unordered, and heterogeneous
+
+output = [prioritized][concepts]
+- the same concepts, but **sorted and grouped by priority grades derived from context**
+- **every placed concept must include a concise rationale** explaining *why* it belongs in that grade, referencing the guiding questions/criteria
+- if the input is not a list, simply output:
+  `"BadRequestError: input must be a list of concepts"`
+
+**why this contract exists:**
+- triage is a **question-driven process**; prioritization only makes sense relative to guiding criteria
+- a **context-dependent grading scale** keeps results faithful to domain constraints
+- attaching a **rationale** to each placement makes decisions transparent, reviewable, and improvable
+
+---
+
+## ⚙️ method
+1. **anchor to the seed concepts**
+   - parse and restate the full set of concepts needing triage
+   - confirm the scope of assessment (what kinds of concepts are included)
+
+2. **establish criteria (via guiding questions)**
+   - identify the **key questions** that define the triage dimensions
+   - e.g., “which are most urgent?”, “which yield the highest impact?”, “which are prerequisites?”, “which are low-effort/high-gain?”
+
+3. **derive a grading scale from context**
+   - synthesize **grade names** from the criteria and environment (examples: `critical`, `urgent`, `near_term`, `strategic`, `defer`, etc.)
+   - prefer **3–5 distinct grades** that are mutually exclusive and collectively exhaustive for the current context
+   - order grades from highest to lowest priority
+
+4. **evaluate and sort with rationale**
+   - for each concept:
+     - place it under exactly one grade
+     - provide a **rationale**: a crisp, criteria-referenced explanation (impact, urgency, dependency, risk, effort, alignment)
+
+5. **review and refine**
+   - merge duplicates, clarify ambiguous items
+   - verify no concept is added/removed relative to the input
+   - ensure rationales are specific (avoid generic statements)
+
+---
+
+## 📐 output format
+- Return **only** a JSON object of the shape:
+
+\`\`\`json
+{
+  "$grade": [
+    { "item": "<exact input concept>", "rationale": "<why this grade, tied to criteria>" }
+  ]
+}
+\`\`\`
+
+- **`$grade` keys** must be **derived from the context and guiding questions** (not hard-coded).
+- **Every array entry** must be an object with **`item`** and **`rationale`**.
+- **Only use items from the input list**; do **not** invent new concepts.
+- Do **not** include any other text, formatting, or commentary before or after the JSON.
+
+---
+
+## 📚 briefs
+here are the .briefs you've studied for this skill and actively strive to leverage
+
+$.rhachet{skill.briefs}
+
+---
+
+## 📥 inputs
+the following inputs define the semantic frame for `<triage>`:
+
+---
+
+## 📎 references
+here are possibly relevant references you may need
+
+$.rhachet{references}
+
+---
+
+### 🧘 @[focus.context]
+> the context in focus available for leverage
+
+\`\`\`md
+$.rhachet{focus.context}
+\`\`\`
+
+---
+
+### 🫐 @[focus.concept]
+> the **inflight document of output** — the seed concepts being refined by `<triage>`
+> if this is empty, treat it as **no concepts** and start from scratch
+
+\`\`\`md
+$.rhachet{focus.concept}
+\`\`\`
+
+---
+
+### 🎯 @[guide.goal]
+\`\`\`md
+$.rhachet{guide.goal}
+\`\`\`
+
+---
+
+### 💬 @[guide.feedback]
+\`\`\`md
+$.rhachet{guide.feedback}
+\`\`\`
+
+---
+
+### 🌱 [seed][concepts]
+\`\`\`md
+$.rhachet{seed.concepts}
+\`\`\`
+
+**note: if [seed][concepts] is not a list, simply return "BadRequestError: input must be a list of concepts"**

package/license.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 ehmpathy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "rhachet-roles-bhrain",
+  "author": "ehmpathy",
+  "description": "reliable thought concept navigation roles, briefs, and skills, via rhachet",
+  "version": "0.1.0",
+  "repository": "ehmpathy/rhachet-roles-bhrain",
+  "homepage": "https://github.com/ehmpathy/rhachet-roles-bhrain",
+  "keywords": [
+    "rhachet",
+    "roles"
+  ],
+  "bugs": "https://github.com/ehmpathy/rhachet-roles-bhrain/issues",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "engines": {
+    "node": ">=8.0.0"
+  },
+  "files": [
+    "/dist"
+  ],
+  "dependencies": {
+    "@ehmpathy/as-command": "1.0.3",
+    "@ehmpathy/uni-time": "1.8.1",
+    "as-procedure": "1.1.7",
+    "domain-objects": "0.31.7",
+    "fast-glob": "3.3.3",
+    "helpful-errors": "1.5.3",
+    "inquirer": "12.7.0",
+    "openai": "5.8.2",
+    "rhachet": "1.13.11",
+    "rhachet-artifact": "1.0.0",
+    "rhachet-artifact-git": "1.1.0",
+    "serde-fns": "1.2.0",
+    "simple-in-memory-cache": "0.4.0",
+    "type-fns": "1.21.0",
+    "with-simple-caching": "0.14.2",
+    "wrapper-fns": "1.1.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.8",
+    "@commitlint/cli": "19.5.0",
+    "@commitlint/config-conventional": "19.5.0",
+    "@swc/core": "1.15.3",
+    "@swc/jest": "0.2.39",
+    "@tsconfig/node20": "20.1.5",
+    "@tsconfig/strictest": "2.0.5",
+    "@types/jest": "30.0.0",
+    "@types/node": "22.15.21",
+    "cz-conventional-changelog": "3.3.0",
+    "declapract": "0.13.4",
+    "declapract-typescript-ehmpathy": "0.47.2",
+    "declastruct": "1.7.3",
+    "declastruct-github": "1.3.0",
+    "depcheck": "1.4.3",
+    "esbuild-register": "3.6.0",
+    "husky": "8.0.3",
+    "jest": "30.2.0",
+    "rhachet": "1.13.11",
+    "rhachet-roles-ehmpathy": "1.15.12",
+    "test-fns": "1.6.0",
+    "tsc-alias": "1.8.10",
+    "tsx": "4.20.6",
+    "typescript": "5.4.5",
+    "uuid-fns": "1.0.2",
+    "yalc": "1.0.0-pre.53"
+  },
+  "config": {
+    "commitizen": {
+      "path": "./node_modules/cz-conventional-changelog"
+    }
+  },
+  "scripts": {
+    "build:ts": "tsc -p ./tsconfig.build.json",
+    "commit:with-cli": "npx cz",
+    "fix:format:biome": "biome check --write",
+    "fix:format": "npm run fix:format:biome",
+    "fix:lint": "biome check --write",
+    "fix": "npm run fix:format && npm run fix:lint",
+    "build:clean": "rm dist/ -rf",
+    "build:compile": "tsc -p ./tsconfig.build.json && tsc-alias -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' --include='**/skills/**/*.jsonc' --include='**/skills/*.jsonc' --exclude='*' src/ dist/",
+    "build": "npm run build:clean && npm run build:compile && npm run build:complete --if-present",
+    "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",
+    "test:lint:deps": "npx depcheck -c ./.depcheckrc.yml",
+    "test:integration:hold": "jest -c ./jest.integration.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main')",
+    "test:lint:biome": "biome check --diagnostic-level=error",
+    "test:lint:biome:all": "biome check",
+    "test:lint": "npm run test:lint:biome && npm run test:lint:deps",
+    "test:unit": "jest -c ./jest.unit.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main') $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "test:integration": "echo 'todo: release'",
+    "test:acceptance:locally": "npm run build && LOCALLY=true jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "test": "npm run test:commits && npm run test:types && npm run test:format && npm run test:lint && npm run test:unit && npm run test:integration && npm run test:acceptance:locally",
+    "test:acceptance": "npm run build && jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "prepush": "npm run test && npm run build",
+    "prepublish": "npm run build",
+    "preversion": "npm run prepush",
+    "postversion": "git push origin HEAD --tags --no-verify",
+    "prepare:husky": "husky install && chmod ug+x .husky/*",
+    "test:format:biome": "biome format",
+    "prepare:rhachet": "rhachet init && rhachet roles link --role mechanic && .agent/repo=ehmpathy/role=mechanic/skills/.skills/init.claude.sh"
+  }
+}

package/readme.md

@@ -0,0 +1,91 @@
+# rhachet-roles-bhrain
+
+![test](https://github.com/ehmpathy/rhachet-roles-bhrain/workflows/test/badge.svg)
+![publish](https://github.com/ehmpathy/rhachet-roles-bhrain/workflows/publish/badge.svg)
+
+reliable thought concept navigation roles, briefs, and skills, via [rhachet](https://github.com/ehmpathy/rhachet)
+
+# purpose
+
+# install
+
+```sh
+npm install rhachet-roles-bhrain
+```
+
+# use
+
+## `readme --registry`
+```sh
+npx rhachet readme --registry bhrain
+```
+
+produces
+
+```md
+# 🧠 bhrain role registry
+
+This registry defines the roles used to navigate though concept space.
+
+---
+
+## 🪐 Thinker
+
+Used to navigate through concept space. See src/roles/thinker/briefs/cognition for details.
+
+---
+
+## 📚 Librarian
+
+Used to curate knowledge and context. see src/roles/thinker/briefs/librarian.context and src/roles/thinker/briefs/librarian.tactics for details.
+```
+
+## `ask -r thinker -s instantiate`
+
+```sh
+npx rhachet ask -r thinker -s instantiate \
+  --attempts 3 \
+  --fresh yes \
+  --output 'src/jokes.v1.md' \
+  --ask "
+     whats your best joke about seaturtles?
+  "
+```
+
+
+## `ask -r thinker -s catalogize`
+
+```sh
+npx rhachet ask -r thinker -s catalogize \
+  --attempts 3 \
+  --fresh yes \
+  --output 'src/jokes.v1.md' \
+  --ask "
+    what are the different types of sea turtles?
+  "
+```
+
+
+## `ask -r thinker -s articulate`
+
+```sh
+npx rhachet ask -r thinker -s articulate \
+  --attempts 3 \
+  --fresh yes \
+  --output 'src/jokes.v1.md' \
+  --ask "
+    what is a sea turtle?
+  "
+```
+
+## `ask -r thinker -s demonstrate`
+
+```sh
+npx rhachet ask -r thinker -s articulate \
+  --attempts 3 \
+  --fresh yes \
+  --output 'src/jokes.v1.md' \
+  --ask "
+    how to identify a sea turtle?
+  "
+```