rhachet-roles-ehmpathy 1.0.0 → 1.1.0

package/dist/logic/roles/bhrain/.briefs/tactic.<think>[idea]/primitive/<zoomout>[breadth]<broaden>[concept].md

@@ -0,0 +1,71 @@
+# 🔭 .brief: `<zoomout>[breadth]<broaden>[concept]`
+
+## .what
+**`<broaden>`** increases the **semantic breadth** of focus around a concept — by including **more neighbor concepts** that live at the same abstraction depth.
+
+It performs a **`focal.breadth++`** operation:
+- adds **neighbors** from multiple semantic dimensions
+- does **not increase detail** (`acuity`) or **abstraction layers** (`depth`)
+- instead, it **extends lateral context**
+
+> Imagine widening your field of view across the current concept layer.
+
+---
+
+## 📐 how it behaves
+
+From a chosen **anchor concept**, `<broaden>` gathers peer concepts across various **semantic dimensions**:
+- **categorical** — same type or class
+- **functional** — similar roles or effects
+- **relational** — co-occurring or co-referenced
+- **modal** — alternative forms or scenarios
+- **emotional** — parallel affective responses
+- **contextual** — common settings or frames
+
+---
+
+## 🎯 examples: `<broaden>[concept]` with multiple dimensions
+
+### 🍌 concept: `"banana"`
+
+- **categorical**: [concept:"apple"], [concept:"pear"], [concept:"mango"]
+- **functional**: [concept:"fruit snack"], [concept:"smoothie ingredient"]
+- **relational**: [concept:"monkey"], [concept:"grocery shelf"]
+- **modal**: [concept:"peeled banana"], [concept:"mashed banana"]
+- **emotional**: [concept:"comfort food"], [concept:"sweet treat"]
+
+---
+
+### 🧰 concept: `"toolbox"`
+
+- **categorical**: [concept:"tool chest"], [concept:"belt pouch"], [concept:"tackle box"]
+- **functional**: [concept:"storage container"], [concept:"portable kit"]
+- **relational**: [concept:"workshop"], [concept:"repair job"]
+- **modal**: [concept:"plastic toolbox"], [concept:"modular drawer system"]
+- **chronical**: [concept:"daily use tools"], [concept:"emergency tools"]
+
+---
+
+### 🔋 concept: `"battery"`
+
+- **categorical**: [concept:"fuel cell"], [concept:"capacitor"], [concept:"power bank"]
+- **functional**: [concept:"energy storage"], [concept:"power delivery"]
+- **relational**: [concept:"charger"], [concept:"device"]
+- **modal**: [concept:"dead battery"], [concept:"rechargeable battery"]
+- **contextual**: [concept:"electric car"], [concept:"remote control"]
+
+---
+
+### 🛠️ concept: `"fixing a leak"`
+
+- **categorical**: [concept:"repair task"], [concept:"home maintenance"]
+- **functional**: [concept:"tightening bolt"], [concept:"replacing seal"]
+- **relational**: [concept:"plumber"], [concept:"water damage"]
+- **modal**: [concept:"quick patch"], [concept:"complete pipe replacement"]
+- **chronical**: [concept:"emergency fix"], [concept:"scheduled repair"]
+
+---
+
+## 🧭 grammar
+```txt
+[anchor:concept] → <broaden> → [neighbor:concept[] by dimension]

package/dist/logic/roles/bhrain/.briefs/tactic.<think>[idea]/primitive/<zoomout>[depth]<elaborate>[concept].md

@@ -0,0 +1,74 @@
+# 🌱 .brief: `<zoomout>[depth]<elaborate>[concept]`
+
+## .what
+**`<elaborate>`** moves **outward** from a conceptual anchor, revealing **examples**, **variants**, or **subtypes** that reside further along the same semantic path.
+
+It performs a **`focal.depth++`** operation:
+- **deepening outward**, not inward
+- expands your view **away from the universal abstraction core**, into more **concrete**, **specialized**, or **differentiated** expressions of the concept
+
+> You remain centered on a concept, but shine your focus beam deeper **toward the semantic periphery** — revealing what it **contains**, **produces**, or **becomes**.
+
+---
+
+## 🧭 direction
+This is **radial motion outward**:
+- relative depth increases from your current anchor
+- each outward step increases specificity
+- **rootward** compression reverses into **leafward** elaboration
+
+---
+
+## 🌳 how it works
+
+`<elaborate>` explores **example concepts** that are:
+- more **specific**
+- more **constrained**
+- more **contextually bound**
+- more **instantiated**
+
+> These are not “parts” (decomposition), but **subtypes**, **refinements**, or **real-world cases** of the anchor concept.
+
+---
+
+## 🎯 examples: `<elaborate>[concept]` in multiple directions
+
+### 🍌 concept: `"banana"`
+
+- **biological**: `"banana"` → `"cavendish banana"` → `"dwarf cavendish banana"`
+- **functional**: `"banana"` → `"banana used in smoothies"` → `"banana in green detox smoothie"`
+- **modal**: `"banana"` → `"overripe banana"` → `"banana for baking"`
+
+---
+
+### 🧰 concept: `"toolbox"`
+
+- **categorical**: `"toolbox"` → `"carpenter's toolbox"` → `"wooden hinged toolbox with compartments"`
+- **functional**: `"toolbox"` → `"emergency repair kit"` → `"bike roadside repair set"`
+- **chronical**: `"toolbox"` → `"toolbox from 1980s"` → `"Soviet-era electrician’s box"`
+
+---
+
+### 🔋 concept: `"battery"`
+
+- **categorical**: `"battery"` → `"LiFePO₄ battery"` → `"cold-rated LiFePO₄ battery with BMS"`
+- **form-factor**: `"battery"` → `"18650-format battery"` → `"protected 18650 cell"`
+- **application**: `"battery"` → `"drone battery"` → `"quadcopter LiPo battery"`
+
+---
+
+### 🧼 concept: `"soap"`
+
+- **use case**: `"soap"` → `"hand soap"` → `"antibacterial foam soap"`
+- **form factor**: `"soap"` → `"bar soap"` → `"triple-milled French bar soap"`
+- **ingredient**: `"soap"` → `"olive oil soap"` → `"castile soap"`
+
+---
+
+## 🧠 cognitive role
+
+- builds **semantic richness** from a known node
+- enables **example generation**, **training instance creation**, **specialization**
+- helps refine concepts into more usable forms
+
+→ Use `<elaborate>` when you want to **see what your concept contains** or **how it expresses concretely** across contexts.

package/dist/logic/roles/bhrain/.briefs/terms.motive.intent.goal.md

@@ -0,0 +1,46 @@
+🔥 [motive] — an internal pressure or desire
+.what = the underlying reason the actor wants anything at all
+
+.form = emotional, value-driven, often implicit
+
+.examples:
+[motive] = avoid failure
+[motive] = gain respect
+[motive] = feel in control
+
+---
+
+🎯 [intent] — a chosen next action
+.what = a specific thing the actor plans to do next
+
+.form = short-term, actionable, verb-shaped
+
+.examples:
+[intent] = schedule a call
+[intent] = submit proposal
+[intent] = clean the garage
+
+---
+
+🥅 [goal] — a desired future state
+.what = a future outcome the actor wants to reach
+
+.form = long-term, state-shaped, noun/condition
+
+.examples:
+[goal] = get more customers
+[goal] = have a clean house
+[goal] = win the bid
+
+---
+
+🧠 mental model
+[motive] = source of pressure
+[goal] = destination
+[intent] = chosen step toward it
+
+- `[motive]` fuels the journey
+- `[goal]` gives it direction
+- `[intent]` initiates motion
+
+> every `[intent]` serves a `[goal]`, and every `[goal]` is backed by a `[motive]` — but these are not always visible on the surface.

package/dist/logic/roles/bhrain/.briefs/trait.ocd.md

@@ -0,0 +1,5 @@
+.ocd = obsessed with structure, precision, and clarity.
+- strives for maximum signal and minimal noise.
+- compulsively organizes, deduplicates, and compresses information.
+- intolerant of vagueness, drift, or redundant phrasing.
+- ensures consistent grammar, formatting, and taxonomy.

package/dist/logic/roles/bhrain/getBhrainBrief.Options.codegen.d.ts

@@ -0,0 +1,10 @@
+/**
+ * .what = the options for the briefs available to role Bhrain
+ * .note = codegened via:
+ * ```sh
+ *  npx tsx src/contract/commands/codegenBriefOptions.ts
+ * ```
+ */
+declare const options: readonly ["distilisys.grammar.compressed.md", "terms.motive.intent.goal.md", "trait.ocd.md"];
+export type BriefOptionBhrain = typeof options[number];
+export {};

package/dist/logic/roles/bhrain/getBhrainBrief.Options.codegen.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * .what = the options for the briefs available to role Bhrain
+ * .note = codegened via:
+ * ```sh
+ *  npx tsx src/contract/commands/codegenBriefOptions.ts
+ * ```
+ */
+const options = [
+    'distilisys.grammar.compressed.md',
+    'terms.motive.intent.goal.md',
+    'trait.ocd.md',
+];
+//# sourceMappingURL=getBhrainBrief.Options.codegen.js.map

package/dist/logic/roles/bhrain/getBhrainBrief.Options.codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBhrainBrief.Options.codegen.js","sourceRoot":"","sources":["../../../../src/logic/roles/bhrain/getBhrainBrief.Options.codegen.ts"],"names":[],"mappings":";;AAAA;;;;;;GAMG;AACH,MAAM,OAAO,GAAG;IACd,kCAAkC;IAClC,6BAA6B;IAC7B,cAAc;CACN,CAAC"}

package/dist/logic/roles/bhrain/getBhrainBrief.d.ts

@@ -0,0 +1,13 @@
+import { Artifact } from 'rhachet-artifact';
+import { GitFile } from 'rhachet-artifact-git';
+import { BriefOptionBhrain } from './getBhrainBrief.Options.codegen';
+/**
+ * .what = loads an artifact:brief distilled for the mechanic to reference, from the `.briefs` directory
+ * .why = enables reusable knowledge downloads for mechanic contexts (e.g., matrix-movie style)
+ */
+export declare const getBhrainBrief: (key: BriefOptionBhrain) => Artifact<typeof GitFile>;
+/**
+ * .what = loads multiple artifact:brief distilled for the mechanic to reference, from the `.briefs` directory
+ * .why = enables reusable knowledge downloads for mechanic contexts (e.g., matrix-movie style)
+ */
+export declare const getBhrainBriefs: (keys: BriefOptionBhrain[]) => Artifact<typeof GitFile>[];

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBhrainBriefs = exports.getBhrainBrief = void 0;
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+/**
+ * .what = loads an artifact:brief distilled for the mechanic to reference, from the `.briefs` directory
+ * .why = enables reusable knowledge downloads for mechanic contexts (e.g., matrix-movie style)
+ */
+const getBhrainBrief = (key) => {
+    return (0, rhachet_artifact_git_1.genArtifactGitFile)({
+        uri: `${__dirname}/.briefs/${key}`,
+    });
+};
+exports.getBhrainBrief = getBhrainBrief;
+/**
+ * .what = loads multiple artifact:brief distilled for the mechanic to reference, from the `.briefs` directory
+ * .why = enables reusable knowledge downloads for mechanic contexts (e.g., matrix-movie style)
+ */
+const getBhrainBriefs = (keys) => keys.map(exports.getBhrainBrief);
+exports.getBhrainBriefs = getBhrainBriefs;
+//# sourceMappingURL=getBhrainBrief.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getBhrainBrief.js","sourceRoot":"","sources":["../../../../src/logic/roles/bhrain/getBhrainBrief.ts"],"names":[],"mappings":";;;AACA,+DAAmE;AAInE;;;GAGG;AACI,MAAM,cAAc,GAAG,CAC5B,GAAsB,EACI,EAAE;IAC5B,OAAO,IAAA,yCAAkB,EAAC;QACxB,GAAG,EAAE,GAAG,SAAS,YAAY,GAAG,EAAE;KACnC,CAAC,CAAC;AACL,CAAC,CAAC;AANW,QAAA,cAAc,kBAMzB;AAEF;;;GAGG;AACI,MAAM,eAAe,GAAG,CAC7B,IAAyB,EACG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAc,CAAC,CAAC;AAF7C,QAAA,eAAe,mBAE8B"}

package/dist/logic/roles/bhrain/getBhrainRole.d.ts

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

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_BHRAIN = void 0;
+const rhachet_1 = require("rhachet");
+const getBhrainBrief_1 = require("./getBhrainBrief");
+// import { SKILL_INTERPRET } from './primitive.strategic.atomic/interpret/stepInterpret.skill';
+exports.ROLE_BHRAIN = rhachet_1.Role.build({
+    slug: 'bhrain',
+    name: 'Bhrain',
+    purpose: 'think',
+    readme: `
+## 🧠 Bhrain
+
+thought tactics; intent = be composed into other roles
+  `.trim(),
+    traits: [
+        rhachet_1.RoleTrait.build({
+            slug: 'ocd',
+            readme: 'obsesses over structure, precision, and clarity',
+            brief: (0, getBhrainBrief_1.getBhrainBrief)('trait.ocd.md'),
+        }),
+    ],
+    skills: [
+    //SKILL_INTERPRET
+    ],
+});
+//# sourceMappingURL=getBhrainRole.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getBhrainRole.js","sourceRoot":"","sources":["../../../../src/logic/roles/bhrain/getBhrainRole.ts"],"names":[],"mappings":";;;AAAA,qCAA0C;AAE1C,qDAAkD;AAElD,gGAAgG;AAEnF,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;KACH;IACD,MAAM,EAAE;IACN,iBAAiB;KAClB;CACF,CAAC,CAAC"}

package/dist/logic/roles/bhrain/primitive.idealogic.atomic/cluster/stepCluster.d.ts

@@ -0,0 +1,51 @@
+import { GStitcher, Threads, RoleContext } from 'rhachet';
+import { Artifact } from 'rhachet-artifact';
+import { GitFile } from 'rhachet-artifact-git';
+import { ContextOpenAI } from '../../../../../data/sdk/sdkOpenAi';
+type StitcherDesired = GStitcher<Threads<{
+    caller: RoleContext<'caller', {
+        art: {
+            motive: Artifact<typeof GitFile> | null;
+            feedback: Artifact<typeof GitFile>;
+        };
+    }>;
+    thinker: RoleContext<'thinker', {
+        art: {
+            inflight: Artifact<typeof GitFile>;
+            'upstream.collection': Artifact<typeof GitFile>;
+        };
+        purpose: string;
+        grammar: string;
+    }>;
+}>, ContextOpenAI & GStitcher['context'], {
+    content: string;
+}>;
+export declare const stepCluster: import("rhachet").Stitcher<StitcherDesired>;
+export declare const loopCluster: import("rhachet").Stitcher<GStitcher<Threads<{
+    caller: RoleContext<"caller", {
+        art: {
+            motive: Artifact<typeof GitFile> | null;
+            feedback: Artifact<typeof GitFile>;
+        };
+    } & {
+        ask: string;
+        art: {
+            feedback: Artifact<typeof GitFile, string>;
+        };
+    }>;
+    thinker: RoleContext<"thinker", {
+        art: {
+            inflight: Artifact<typeof GitFile>;
+            'upstream.collection': Artifact<typeof GitFile>;
+        };
+        purpose: string;
+        grammar: string;
+    } & {
+        art: {
+            inflight: Artifact<typeof GitFile, string>;
+        };
+    }>;
+}>, ContextOpenAI & import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    feedback: GitFile | null;
+}>>;
+export {};

package/dist/logic/roles/bhrain/primitive.idealogic.atomic/cluster/stepCluster.integration.test.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const uni_time_1 = require("@ehmpathy/uni-time");
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const test_fns_1 = require("test-fns");
+const genContextLogTrail_1 = require("../../../../../.test/genContextLogTrail");
+const genContextStitchTrail_1 = require("../../../../../.test/genContextStitchTrail");
+const getContextOpenAI_1 = require("../../../../../.test/getContextOpenAI");
+const getBhrainBrief_1 = require("../../getBhrainBrief");
+const stepCluster_1 = require("./stepCluster");
+jest.setTimeout((0, uni_time_1.toMilliseconds)({ minutes: 5 }));
+describe('stepCluster', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+        ...(0, getContextOpenAI_1.getContextOpenAI)(),
+    };
+    const route = stepCluster_1.stepCluster;
+    const purpose = `
+cluster the usecases from the upstream.collection
+
+
+    `.trim();
+    const grammar = `
+  structure:
+  @[actor]<mechanism> -> [resource] -> {drive:<<effect>>[motive]}
+
+  standards:
+  - all <verb>s should be declared as <mechanism>s
+  - all [noun]s should be declared as [resource]s
+  - all <mechanism>s should be prefixed with their root operation
+    - <get> for reads
+    - <set> for dobj mutations
+    - <rec> for event emissions
+  - use <mechanism>[resource] syntax for brevity, when applicable
+  - scope [resources] within [domain]s when needed for specificity
+    - [domain][resource]
+  - leverage [resources] .attributes when needed
+    - [resource].attribute
+  `;
+    (0, test_fns_1.given)('we want to explore the home service domain', () => {
+        const inflightArtifact = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname +
+                '/.temp/stepCluster/homeservice.schedule.usecases.usecases.md',
+        }, { versions: true });
+        const feedbackArtifact = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname +
+                '/.temp/stepCluster/homeservice.schedule.usecases.feedback.md',
+        }, { versions: true });
+        const motiveArtifact = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname +
+                '/.temp/stepCluster/homeservice.schedule.usecases.motive.md',
+        }, { versions: true });
+        const upstreamArtifact = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname +
+                '/.test/homeservice.schedule.usecases.upstream.collection.json',
+        }, { access: 'readonly' });
+        beforeEach(async () => {
+            await inflightArtifact.del();
+            await feedbackArtifact.del();
+            await motiveArtifact.set({
+                content: 'gather usecases for a product vision',
+            });
+        });
+        (0, test_fns_1.when)('executed', () => {
+            const threads = (0, test_fns_1.usePrep)(async () => ({
+                caller: await (0, rhachet_1.enrollThread)({
+                    role: 'caller',
+                    stash: {
+                        art: {
+                            motive: motiveArtifact,
+                            feedback: feedbackArtifact,
+                        },
+                    },
+                }),
+                thinker: await (0, rhachet_1.enrollThread)({
+                    role: 'thinker',
+                    stash: {
+                        art: {
+                            inflight: inflightArtifact,
+                            'upstream.collection': upstreamArtifact,
+                        },
+                        purpose,
+                        grammar,
+                    },
+                    inherit: {
+                        traits: (0, getBhrainBrief_1.getBhrainBriefs)(['trait.ocd.md']),
+                    },
+                }),
+            }));
+            (0, test_fns_1.then)('upserts the artifact', async () => {
+                const result = await (0, rhachet_1.enweaveOneStitcher)({ stitcher: route, threads }, context);
+                console.log(JSON.stringify(result.stitch, null, 2));
+                console.log(inflightArtifact);
+                const { content } = await inflightArtifact.get().expect('isPresent');
+                expect(content).toContain('pro');
+            });
+        });
+    });
+});
+//# sourceMappingURL=stepCluster.integration.test.js.map

package/dist/logic/roles/bhrain/primitive.idealogic.atomic/cluster/stepCluster.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepCluster.integration.test.js","sourceRoot":"","sources":["../../../../../../src/logic/roles/bhrain/primitive.idealogic.atomic/cluster/stepCluster.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/logic/roles/bhrain/primitive.idealogic.atomic/cluster/stepCluster.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loopCluster = exports.stepCluster = void 0;
+const rhachet_1 = require("rhachet");
+const sdkOpenAi_1 = require("../../../../../data/sdk/sdkOpenAi");
+const genLoopFeedback_1 = require("../../../../artifact/genLoopFeedback");
+const genStepArtSet_1 = require("../../../../artifact/genStepArtSet");
+const getEcologistBrief_1 = require("../../../ecologist/getEcologistBrief");
+const getMechanicBrief_1 = require("../../../mechanic/getMechanicBrief");
+const template = (0, rhachet_1.genTemplate)({
+    ref: { uri: __filename.replace('.ts', '.template.md') },
+    getVariables: async ({ threads }) => ({
+        ...(await (0, rhachet_1.getTemplateVarsFromRoleInherit)({ thread: threads.thinker })),
+        motive: (await threads.caller.context.stash.art.motive?.get())?.content || '',
+        feedback: (await threads.caller.context.stash.art.feedback.get())?.content || '',
+        purpose: threads.thinker.context.stash.purpose,
+        grammar: threads.thinker.context.stash.grammar,
+        inflight: (await threads.thinker.context.stash.art.inflight.get())?.content || '',
+        upstream: (await threads.thinker.context.stash.art['upstream.collection'].get())
+            ?.content || '',
+        briefs: await (0, rhachet_1.getTemplateValFromArtifacts)({
+            artifacts: [
+                ...(0, getMechanicBrief_1.getMechanicBriefs)([
+                    'architecture/ubiqlang.md',
+                    'style.names.treestruct.md',
+                ]),
+                ...(0, getEcologistBrief_1.getEcologistBriefs)([
+                    'distilisys/sys101.distilisys.grammar.md',
+                    'distilisys/sys201.actor.motive._.summary.md',
+                    'distilisys/sys201.actor.motive.p5.motive.grammar.md',
+                    'ecology/eco001.overview.md',
+                    'economy/econ001.overview.md',
+                ]),
+            ],
+        }),
+    }),
+});
+const stepImagine = (0, rhachet_1.genStepImagineViaTemplate)({
+    slug: '[thinker]<cluster>',
+    stitchee: 'thinker',
+    readme: '',
+    template,
+    imagine: sdkOpenAi_1.sdkOpenAi.imagine,
+});
+const stepPersist = (0, genStepArtSet_1.genStepArtSet)({
+    stitchee: 'thinker',
+    artee: 'inflight',
+});
+exports.stepCluster = (0, rhachet_1.asStitcherFlat)((0, rhachet_1.genStitchRoute)({
+    slug: '@[thinker]<cluster>',
+    readme: '@[thinker]<cluster> -> [[idea]]',
+    sequence: [stepImagine, stepPersist],
+}));
+exports.loopCluster = (0, genLoopFeedback_1.genLoopFeedback)({
+    stitchee: 'thinker',
+    artee: 'inflight',
+    repeatee: exports.stepCluster,
+});
+//# sourceMappingURL=stepCluster.js.map

package/dist/logic/roles/bhrain/primitive.idealogic.atomic/cluster/stepCluster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepCluster.js","sourceRoot":"","sources":["../../../../../../src/logic/roles/bhrain/primitive.idealogic.atomic/cluster/stepCluster.ts"],"names":[],"mappings":";;;AAAA,qCAUiB;AAIjB,iEAA6E;AAC7E,0EAAuE;AACvE,sEAAmE;AACnE,4EAA0E;AAC1E,yEAAuE;AA6BvE,MAAM,QAAQ,GAAG,IAAA,qBAAW,EAA6B;IACvD,GAAG,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE;IACvD,YAAY,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,CAAC,MAAM,IAAA,wCAA8B,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,MAAM,EACJ,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;QACvE,QAAQ,EACN,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;QACxE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO;QAC9C,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO;QAC9C,QAAQ,EACN,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;QACzE,QAAQ,EACN,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,GAAG,EAAE,CAAC;YACpE,EAAE,OAAO,IAAI,EAAE;QACnB,MAAM,EAAE,MAAM,IAAA,qCAA2B,EAAC;YACxC,SAAS,EAAE;gBACT,GAAG,IAAA,oCAAiB,EAAC;oBACnB,0BAA0B;oBAC1B,2BAA2B;iBAC5B,CAAC;gBACF,GAAG,IAAA,sCAAkB,EAAC;oBACpB,yCAAyC;oBACzC,6CAA6C;oBAC7C,qDAAqD;oBACrD,4BAA4B;oBAC5B,6BAA6B;iBAC9B,CAAC;aACH;SACF,CAAC;KACH,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,mCAAyB,EAAkB;IAC7D,IAAI,EAAE,oBAAoB;IAC1B,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,EAAE;IACV,QAAQ;IACR,OAAO,EAAE,qBAAS,CAAC,OAAO;CAC3B,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,6BAAa,EAAC;IAChC,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,UAAU;CAClB,CAAC,CAAC;AAEU,QAAA,WAAW,GAAG,IAAA,wBAAc,EACvC,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,qBAAqB;IAC3B,MAAM,EAAE,iCAAiC;IACzC,QAAQ,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;CACrC,CAAC,CACH,CAAC;AAEW,QAAA,WAAW,GAAG,IAAA,iCAAe,EAAC;IACzC,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE,mBAAW;CACtB,CAAC,CAAC"}

package/dist/logic/roles/bhrain/primitive.idealogic.atomic/cluster/stepCluster.template.md

@@ -0,0 +1,127 @@
+you are a **@[thinker]** — a thinker skilled at performing the `<cluster>` operation on idea [branch]es in response to motive.
+
+your task is to:
+1. **<cluster>** the items in `[upstream.collection]` into meaningful groups based on similarity of mechanism, framing, or outcome
+2. **reflect on and respond to** any provided `[feedback]` to improve clarity, structure, or framing
+3. **overwrite the existing `[inflight]`**, which represents the current (possibly flawed or outdated) state of the clustering
+
+---
+
+Use the following as your frame of reference:
+
+- **@[caller][motive]** — the pressure or desire driving this clustering task
+- **@[thinker][purpose]** — defines the scope or lens you should use to cluster
+- **@[thinker][grammar]** — defines how each [branch] is structured
+- **[upstream.collection]** — the raw input [branch]es you must organize
+- **[inflight]** — the latest [cluster]s, which you'll upsert over
+- **[feedback]** — caller response to a prior attempt, which should guide your revisions
+
+---
+
+📦 output format
+
+return the contents of a `.json` file:
+
+`\`\`\`json
+[
+  {
+    "cluster": {
+      emoji: string, // optional icon to quickly convey the vibe
+      title: string, // short, intuitive label for the cluster
+      description: string, // 1-2 sentence summary of the unifying purpose
+      rationale: string, // why these ideas belong together
+      criteria: string[], // concrete traits shared across all members
+    },
+    "branches": [
+      {
+        "slug": "...",
+        "title": "...",
+        "summary": "...",
+        "rationale": "...",
+        "grammar": "..."
+      }
+    ]
+  }
+]
+\`\`\`
+
+---
+
+🧠 mental model
+- a *branch* = a single unit of structured thought
+- a *cluster* = a group of branches with shared structure, mechanism, or intention
+- *feedback* = signal from the caller to adjust clarity, grouping, or naming
+- *inflight* = the current clustering state — assume it is imperfect and must be **fully replaced**
+
+---
+
+🧬 you strive for:
+- cleanly themed and well-separated clusters
+- zero duplication across or within clusters
+- strict grammar fidelity
+- responsive adaptation to feedback
+- full overwrite of `[inflight]` with improved clustering
+
+---
+
+## 🧬 your traits
+
+you compulsively exhibit these traits in every move you make:
+
+$.rhachet{inherit.traits}
+
+---
+
+## 🛠️ your skills
+
+these are the capabilities you draw from:
+
+$.rhachet{briefs}
+
+---
+
+📜 contract — grammar compliance is non-negotiable
+
+@[thinker][grammar] =
+$.rhachet{grammar}
+
+---
+
+## ✅ reminders
+
+- do not invent new branches — only cluster from `[upstream.collection]`
+- produce clean, labeled, non-overlapping clusters
+- feedback is mandatory to reflect
+- completely overwrite the `[inflight]` state with your new clustering
+- output must be a clean JSON array — no prose, no markdown
+
+---
+
+@[thinker][purpose] =
+$.rhachet{purpose}
+
+---
+
+@[caller][motive] =
+$.rhachet{motive}
+
+---
+
+[upstream.collection] =
+`\`\`\`json
+$.rhachet{upstream}
+\`\`\`
+
+---
+
+[inflight] =
+`\`\`\`json
+$.rhachet{inflight}
+\`\`\`
+
+---
+
+[feedback] =
+`\`\`\`md
+$.rhachet{feedback}
+\`\`\`