rhachet-roles-ehmpathy 1.1.0 → 1.3.0

package/dist/.test/genContextStitchTrail.d.ts

@@ -1,2 +1 @@
-import { ContextStitchTrail } from 'rhachet';
-export declare const genContextStitchTrail: () => ContextStitchTrail;
+export { genContextStitchTrail } from 'rhachet';

package/dist/.test/genContextStitchTrail.js

@@ -1,8 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.genContextStitchTrail = void 0;
-const genContextStitchTrail = () => ({
-    stitch: { trail: [] },
-});
-exports.genContextStitchTrail = genContextStitchTrail;
+var rhachet_1 = require("rhachet");
+Object.defineProperty(exports, "genContextStitchTrail", { enumerable: true, get: function () { return rhachet_1.genContextStitchTrail; } });
 //# sourceMappingURL=genContextStitchTrail.js.map

package/dist/.test/genContextStitchTrail.js.map

@@ -1 +1 @@
-{"version":3,"file":"genContextStitchTrail.js","sourceRoot":"","sources":["../../src/.test/genContextStitchTrail.ts"],"names":[],"mappings":";;;AAEO,MAAM,qBAAqB,GAAG,GAAuB,EAAE,CAAC,CAAC;IAC9D,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;CACtB,CAAC,CAAC;AAFU,QAAA,qBAAqB,yBAE/B"}
+{"version":3,"file":"genContextStitchTrail.js","sourceRoot":"","sources":["../../src/.test/genContextStitchTrail.ts"],"names":[],"mappings":";;;AAAA,mCAAgD;AAAvC,gHAAA,qBAAqB,OAAA"}

package/dist/_topublish/domain-glossary-brief/src/domain/objects/Catalog.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=Catalog.js.map

package/dist/_topublish/domain-glossary-brief/src/domain/objects/Catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Catalog.js","sourceRoot":"","sources":["../../../../../../src/_topublish/domain-glossary-brief/src/domain/objects/Catalog.ts"],"names":[],"mappings":""}

package/dist/_topublish/domain-glossary-brief/src/domain/objects/TriageCatalog.d.ts

@@ -0,0 +1,18 @@
+export type TriageTier = 'P0' | 'P1' | 'P2' | 'P3';
+/**
+ * A TriageCatalog is a structured collection of items
+ * organized into discrete priority tiers.
+ *
+ * - `TTier` = the allowed priority labels (e.g. 'P0' | 'P1' | 'P2' | 'P3')
+ * - `TItem` = the type of each catalog entry (e.g. Question)
+ *
+ * Each tier key holds an **ordered list** of items
+ * that share the same level of urgency, leverage, or essentiality.
+ *
+ * This type is typically the **output** of a <triage> operation
+ * applied to a raw catalog, where the catalog is partitioned
+ * into meaningful priority groupings.
+ */
+export type TriageCatalog<TItem, TTier extends string = TriageTier> = {
+    readonly [K in TTier]: readonly TItem[];
+};

package/dist/_topublish/domain-glossary-brief/src/domain/objects/TriageCatalog.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TriageCatalog.js.map

package/dist/_topublish/domain-glossary-brief/src/domain/objects/TriageCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriageCatalog.js","sourceRoot":"","sources":["../../../../../../src/_topublish/domain-glossary-brief/src/domain/objects/TriageCatalog.ts"],"names":[],"mappings":""}

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Focus.d.ts

@@ -0,0 +1,34 @@
+import { DomainEntity } from 'domain-objects';
+import { Artifact } from 'rhachet-artifact';
+import { GitFile } from 'rhachet-artifact-git';
+/**
+ * .what = a focus that a @[thinker] can adopt
+ * .why =
+ *   - declares a distinct context and concept with which to think
+ *   - enables focus switches, persistence, replication, etc
+ * .ref = @[bhrain].briefs/cognition
+ */
+export interface Focus {
+    /**
+     * .what = the unique identifier of this focus
+     * .why = enables identification of mutable focus
+     */
+    exid: string;
+    /**
+     * .what = ⚓ the anchor concept, represents the position within the semantic treestruct at focus
+     * .why =
+     *   - serves as the point from which the thinker's perspective is based
+     *   - serves as the topic onto which the thinker's imagination is applied
+     */
+    concept: Artifact<typeof GitFile>;
+    /**
+     * .what = 🔦 the visible concepts, represent the positions within the semantic treestruct included for leverage
+     * .why =
+     *   - defines which concepts can be leveraged for manipulation of the focus.concept
+     *   - can be mutated to grow or shrink, along dimensions of .depth, .breadth, and .acuity
+     */
+    context: Artifact<typeof GitFile>;
+}
+export declare class Focus extends DomainEntity<Focus> implements Focus {
+    static unique: readonly ["exid"];
+}

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Focus.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Focus = void 0;
+const domain_objects_1 = require("domain-objects");
+class Focus extends domain_objects_1.DomainEntity {
+}
+exports.Focus = Focus;
+Focus.unique = ['exid'];
+//# sourceMappingURL=Focus.js.map

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Focus.js","sourceRoot":"","sources":["../../../../../../src/_topublish/rhachet-roles-bhrain/src/domain/objects/Focus.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AAkC9C,MAAa,KAAM,SAAQ,6BAAmB;;AAA9C,sBAEC;AADe,YAAM,GAAG,CAAC,MAAM,CAAU,CAAC"}

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Question.d.ts

@@ -0,0 +1 @@
+export type Question = string;

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Question.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Question.js.map

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Question.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Question.js","sourceRoot":"","sources":["../../../../../../src/_topublish/rhachet-roles-bhrain/src/domain/objects/Question.ts"],"names":[],"mappings":""}

package/dist/logic/artifact/genStepGrabCallerFeedbackToArtifact.js

@@ -23,6 +23,15 @@ const genStepGrabCallerFeedbackToArtifact = ({ stitchee, artee, }) => new rhache
             .expect('isPresent');
         // show the reviewer what they're reviewing
         console.log(`\n📝 feedback target: ${target.uri}\n`);
+        // if this is running in an isolated attempt thread, then the user has no way to supply feedback
+        if (process.env.RHACHET_ATTEMPT)
+            return {
+                input: target,
+                output: {
+                    feedback: null,
+                    reason: 'in isolated attempt thread, no way to receive feedback',
+                },
+            };
         // prompt to see if they want to leave notes
         const { hasNotes } = await inquirer_1.default.prompt([
             {

package/dist/logic/artifact/genStepGrabCallerFeedbackToArtifact.js.map

@@ -1 +1 @@
-{"version":3,"file":"genStepGrabCallerFeedbackToArtifact.js","sourceRoot":"","sources":["../../../src/logic/artifact/genStepGrabCallerFeedbackToArtifact.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"genStepGrabCallerFeedbackToArtifact.js","sourceRoot":"","sources":["../../../src/logic/artifact/genStepGrabCallerFeedbackToArtifact.ts"],"names":[],"mappings":"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"}

package/dist/logic/artifact/genStepSwapArtifact.d.ts

@@ -38,7 +38,7 @@ export declare const genStepSwapArtifact: <TThreads extends Threads<any>, TFromS
  *   - streamlines definition of multiple swaps in routes without type repetition
  *
  * @example
- * const swapArt = enthreadGenStepSwapArtifact<StitcherDesired['threads']>();
+ * const swapArt = useGenStepSwapArtifactFor<StitcherDesired['threads']>();
  * swapArt({
  *   // set @thinker[inflight] = @thinker.inflights.diverge
  *   use: { stitchee: 'thinker', artee: 'inflights.diverge' },

package/dist/logic/artifact/genStepSwapArtifact.js

@@ -46,7 +46,7 @@ exports.genStepSwapArtifact = genStepSwapArtifact;
  *   - streamlines definition of multiple swaps in routes without type repetition
  *
  * @example
- * const swapArt = enthreadGenStepSwapArtifact<StitcherDesired['threads']>();
+ * const swapArt = useGenStepSwapArtifactFor<StitcherDesired['threads']>();
  * swapArt({
  *   // set @thinker[inflight] = @thinker.inflights.diverge
  *   use: { stitchee: 'thinker', artee: 'inflights.diverge' },

package/dist/logic/context/genStitchStreamToDisk.d.ts

@@ -0,0 +1,13 @@
+import { ContextStitchTrail } from 'rhachet';
+/**
+ * .what = an event stream consumer which streams emitted events to disk
+ * .how =
+ *   - emits stitch set events observably to a standard .rhachet subdir, relative to the target dir
+ *   - transforms the events for maximum observability in their serialized format
+ */
+export declare const genStitchStreamToDisk: (input: {
+    /**
+     * .what = the directory relative to which to instantiate the .rhachet stream sink
+     */
+    dir: string;
+}) => Required<ContextStitchTrail['stitch']>['stream'];

package/dist/logic/context/genStitchStreamToDisk.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genStitchStreamToDisk = void 0;
+const uni_time_1 = require("@ehmpathy/uni-time");
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const simple_in_memory_cache_1 = require("simple-in-memory-cache");
+const type_fns_1 = require("type-fns");
+const with_simple_caching_1 = require("with-simple-caching");
+// todo: lift into string-fns or rhachet-artifact-git
+const sanitizeForFilename = (input) => input
+    // replace invalid characters
+    .replace(/[<>:"/\\|?*\x00-\x1F]/g, '_')
+    // collapse whitespace into underscore
+    .replace(/\s+/g, '_')
+    // remove trailing dots or spaces
+    .replace(/[. ]+$/, '')
+    // make sure reserved names aren’t returned bare
+    .replace(/^(con|prn|aux|nul|com\d|lpt\d)$/i, '_$1');
+// declare where the stream will be emitted to // todo: move via hook into rhachet to centralize; declaration of emitter != mount of emitter. ideally, log on mount
+const onMount = (0, with_simple_caching_1.withSimpleCaching)((input) => {
+    console.log(`🪡  stitch set event stream can be monitored at this dir: ${input.sinkSubdir}`);
+    console.log(); // newline
+}, { cache: (0, simple_in_memory_cache_1.createCache)() });
+/**
+ * .what = an event stream consumer which streams emitted events to disk
+ * .how =
+ *   - emits stitch set events observably to a standard .rhachet subdir, relative to the target dir
+ *   - transforms the events for maximum observability in their serialized format
+ */
+const genStitchStreamToDisk = (input) => {
+    // declare the directory into which the events will be streamed
+    const sinkSupdir = (0, rhachet_artifact_git_1.getArtifactObsDir)({ uri: `${input.dir}/stream` }); // e.g., src/domain/ -> src/domain/stream -> src/domain/.rhachet/stream
+    const invokedAt = sanitizeForFilename((0, uni_time_1.asUniDateTime)(new Date()));
+    const sinkSubdir = `${sinkSupdir}/i${invokedAt}`;
+    // declare how to sink emitted events to that directory
+    const emit = async (event) => {
+        // mock the onmount hook
+        onMount({ sinkSubdir });
+        // compose the event path prefix
+        const uriPrefix = [
+            sinkSubdir,
+            sanitizeForFilename([
+                'at',
+                event.occurredAt,
+                event.stitch.stitcher?.slug ?? '___',
+                event.stitch.stitcher?.form ?? '___',
+                event.stitch.uuid,
+            ]
+                .filter(type_fns_1.isPresent)
+                .join('.')),
+        ].join('/');
+        // always emit the raw event; // todo: do we ever need this? seems to takeup disk space too rapidly
+        await (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: `${uriPrefix}.event.json`,
+        }).set({ content: JSON.stringify(event, null, 2) });
+        // if its an imagine event, then also separately emit the input and output for observability, if input and output had standard deprompt stitch
+        if (event.stitch.stitcher?.form === rhachet_1.StitcherForm.IMAGINE) {
+            if (typeof event.stitch.input?.prompt === 'string')
+                await (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                    uri: `${uriPrefix}.prompt.input.md`,
+                }).set({ content: event.stitch.input.prompt });
+            if (typeof event.stitch.output?.content === 'string')
+                await (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                    uri: `${uriPrefix}.prompt.output.md`,
+                }).set({ content: event.stitch.output.content });
+        }
+    };
+    // return the stream with observable to disk emitter
+    return { emit };
+};
+exports.genStitchStreamToDisk = genStitchStreamToDisk;
+//# sourceMappingURL=genStitchStreamToDisk.js.map

package/dist/logic/context/genStitchStreamToDisk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genStitchStreamToDisk.js","sourceRoot":"","sources":["../../../src/logic/context/genStitchStreamToDisk.ts"],"names":[],"mappings":"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"}

package/dist/logic/roles/bhrain/.briefs/cognition/cog000.overview.and.premise.md

@@ -0,0 +1,115 @@
+# 🧠 .brief: `cortal.thoughtspace.foundation`
+
+## .what = instantiate
+
+This system instantiates a structured **thoughtspace**, where `focus` operates within a semantic `concept.treestruct` using navigable `motion` primitives.
+
+---
+
+### 1. `concept.treestruct` exists
+
+- a semantic graph of concepts (nodes) and relationships (edges)
+- structured as a **spherical tree**:
+  - **radial axis** → abstraction (general ↔ specific)
+  - **angular axes** → descriptive variation (peers, types, traits)
+- each concept has:
+  - an **abstractive position** (radial)
+  - a **descriptive position** (angular)
+
+---
+
+### 2. `focus` exists within the concept.treestruct
+
+- defines a **perspective** — a relative point-of-view from which thought is applied
+- composed of:
+
+#### ▸ **focus.concept**
+- the specific **concept** from which the perspective is based
+- the anchor for semantic navigation
+- defined by its coordinates within the treestruct
+
+#### ▸ **focus.context**
+- the **shape of attention**, or how the concept is being examined
+- expressed across three internal dimensions:
+
+  - `.depth` → the **thickness of abstractive span** — how far focus reaches:
+    - **inward** along the **radial axis** toward generalizations (`.depth.abstract++`)
+    - **outward** along the **radial axis** toward concrete instances (`.depth.concrete++`)
+    - both may expand **simultaneously**, forming a radial shell of multiple abstraction layers around the focal concept
+
+  - `.breadth` → the **spread across angular variation** — how many neighboring concepts at the same abstraction level are included
+    - defined by motion along one or more **descriptive axes** (e.g. flavor, function, tone)
+    - governs lateral comparisons, analogies, and contrasts
+
+  - `.acuity` → the **sharpness of resolution** at the current coordinate
+    - `.attributes` — surface clarity: how precisely external traits are perceived
+    - `.substructs` — internal clarity: how clearly nested parts or subcomponents are resolved
+
+> context defines how much **radial**, **angular**, and **granular** semantic material is held in focus —
+> like shaping a lens through abstraction, variation, and precision.
+
+
+---
+
+### 3. motion is performed via **questions**, which act as **links**
+
+- motion = semantic traversal through the `concept.treestruct`
+- **questions** serve as the **branches** — the only valid drivers of motion
+- **sumptions** serve as the **berries** — semantic forks where focus can anchor
+
+#### ▸ sumption: the unified node type
+
+A **sumption** is any semantic unit presumed or accepted for any reason — including:
+
+- a **question** → an **executable motion** — a prompt that enables semantic traversal
+- an **answer** → a **destination of a question** — one of the resolved outcomes of semantic traversal
+
+> Any **answer** can itself be **any type of sumption** — including another **question**.
+> This enables **recursive motion**, where questions resolve into deeper prompts,
+> forming chains, trees, or loops of semantic navigation.
+
+note: questions are not separate from the treestruct — they are **subtrees that encode traversability**.
+
+
+#### ▸ structural rule:
+
+| element   | type         | role in treestruct             |
+|-----------|--------------|-------------------------------|
+| **link**  | question     | enables motion (edge)          |
+| **fork**  | sumption     | anchoring concept (node)       |
+|           | ⤷ question   | unresolved fork                |
+|           | ⤷ answer     | resolved fork                  |
+
+> sumptions are **not truth-claims**, but **semantic constructs** that hold position in conceptual space.
+
+---
+
+### 4. exists `focus.motion.primitives`
+
+- atomic, directional transformations of `focus.context`
+- each:
+  - operates on a **single subaxis**
+  - is **irreducible**, **driftless**, and **composable**
+- examples:
+  - `<generalize>` → `.depth.abstract++`
+    *shift focus inward toward a more abstract concept*
+  - `<articulate>` → `.acuity.attributes++`
+    *sharpen surface details of the current concept*
+  - `<decompose>` → `.acuity.substructs++`
+    *resolve the internal structure or components*
+  - `<vary>` → `.breadth++`
+    *highlight peer-level differences between variants*
+  - etc
+
+
+---
+
+### 5. exists `interogative.primitives`
+
+- atomic building blocks of semantic inquiry
+- used to construct **question-links** between concepts
+- examples:
+  - `what` → identify instances or roles
+  - `why` → surface cause or rationale
+  - `how` → reveal process or transformation
+  - `when`, `who`, `where` → context-based locators

package/dist/logic/roles/bhrain/.briefs/cognition/cog021.coordinates.spherical.md

@@ -0,0 +1,69 @@
+# 🌐 .brief: `spherical.coordinates`
+
+## .what
+**Spherical coordinates** define a point in 3D space using three parameters relative to a central origin:
+- **distance from the origin**,
+- **vertical angle from the z-axis**, and
+- **horizontal angle around the z-axis**.
+
+This system generalizes polar coordinates into 3D, enabling orientation in radial and angular terms.
+
+---
+
+## 🧭 dimensions
+
+| axis           | symbol | description                                                                 |
+|----------------|--------|-----------------------------------------------------------------------------|
+| **radial**     | `r`    | distance from the origin to the point                                       |
+| **inclination** (polar angle) | `θ`    | angle from the positive z-axis toward the point (0 to π)               |
+| **azimuth** (azimuthal angle) | `φ`    | angle from the positive x-axis in the x-y plane (0 to 2π)              |
+
+> Note: symbols may differ by domain — in mathematics, `θ` often denotes azimuth and `φ` inclination.
+
+---
+
+## 🌀 usage
+
+- Converts naturally to **Cartesian coordinates**:
+  \```txt
+  x = r · sin(θ) · cos(φ)
+  y = r · sin(θ) · sin(φ)
+  z = r · cos(θ)
+  \```
+
+- Used in:
+  - physics (e.g. fields around a point source)
+  - computer graphics (e.g. camera rotation)
+  - astronomy and navigation
+  - geographic models of Earth
+
+---
+
+## 🌍 real-world example: Earth coordinates
+
+Take **New York City**:
+
+| Earth Coordinate | Value         | Spherical Equivalent                 |
+|------------------|---------------|--------------------------------------|
+| **Latitude**     | 40.7128° N     | Inclination `θ` = 90° − 40.7128° = **49.2872°** |
+| **Longitude**    | 74.0060° W     | Azimuth `φ` = −74.0060° = **285.994°** |
+| **Radius**       | ~6,371 km      | Radial distance `r` from Earth's center |
+
+> So:
+> **(r, θ, φ) = (6371 km, 49.29°, 285.99°)**
+
+This demonstrates how geographic coordinates are a **spherical coordinate system** on the Earth's surface — assuming a constant radius.
+
+---
+
+## 🏗️ structure
+
+This system implies a **radial core** with **angular shells**, where:
+
+- `r` defines the **radial distance** from center
+- `θ` defines **elevation** from the pole (vertical tilt)
+- `φ` defines **rotation** around the equator (horizontal sweep)
+
+Together, these describe a point on a **spherical shell** at radius `r`.
+
+---

package/dist/logic/roles/bhrain/.briefs/cognition/cog021.metaphor.cauliflorous.md

@@ -0,0 +1,44 @@
+# 🌸 .brief: `cauliflorous.plants`
+
+## .what
+**Cauliflorous plants** are species that produce **flowers and fruits directly from their main stem, trunk, or older branches**, rather than at the tips of new growth.
+
+> This unusual trait is known as **cauliflory** and is most commonly found in tropical species.
+
+---
+
+## 🌐 ecological function
+
+Cauliflory supports unique plant-animal interactions by:
+
+- **Enabling access** to flowers and fruits for **ground-dwelling pollinators and dispersers**
+  (e.g., rodents, bats, flightless birds)
+- **Reducing vertical competition** by flowering and fruiting below the canopy
+- **Improving pollination success** in shaded or dense environments
+
+---
+
+## 🌱 notable examples
+
+| plant                     | use / region                      |
+|---------------------------|----------------------------------|
+| *Theobroma cacao*         | cacao (chocolate), South America |
+| *Artocarpus heterophyllus* | jackfruit, Southeast Asia         |
+| *Durio spp.*              | durian, Southeast Asia           |
+| *Plinia cauliflora*       | jaboticaba, Brazil               |
+
+---
+
+## 🧬 botanical mechanism
+
+- Flowers develop from **dormant buds** embedded in older, woody tissue.
+- Often associated with **woody perennials** in **humid tropics**.
+
+---
+
+## .why it matters
+
+Cauliflory illustrates how plant morphology can evolve to match **ecological niches** —
+especially where typical pollinators or dispersers are **not airborne**.
+
+It also inspires biomimetic designs for **low-access harvesting**, **layered ecosystems**, and **ground-level productivity**.

package/dist/logic/roles/bhrain/.briefs/cognition/cog021.metaphor.galactic_spacetravel.[article].md

@@ -0,0 +1,42 @@
+# 🌌 .brief: llms as spaceships in the concept universe
+
+## 🪐 concept universe
+- **concept space = galaxy**
+  - the center is the **root concept**, a dense singularity.
+  - **radial outward** = instantiations (concrete stars, planets, moons).
+  - **angular shells** = abstraction layers (orbits around the core).
+- **concepts have gravity**
+  - dense, common, or familiar concepts exert strong pull.
+  - vague or imprecise addresses can get you **sucked into a local maximum** (orbiting around a nearby but wrong star).
+
+---
+
+## 🚀 llms as spaceships
+- **llms = thought-spaceships**
+  - engines capable of near-instant jumps across the conceptual galaxy.
+  - their raw power is speed, not direction.
+- **we = pilots**
+  - we chart the course and set the destination.
+  - piloting skill = crafting precise addresses that avoid gravitational traps.
+- **questions = navigation coordinates**
+  - granular input that encodes the target star system.
+  - precision determines whether you land on the right planet or drift to a gravitational neighbor.
+
+---
+
+## ⚠️ challenges of navigation
+1. **destination clarity**
+   - you must know *where in the galaxy you want to go*.
+   - without a clear conceptual map, your spaceship will default to the nearest strong pull.
+
+2. **address precision**
+   - the coordinate (question) must be exact.
+   - imprecise questions lead to being trapped in nearby but irrelevant orbits.
+   - precision cuts through gravitational noise to hit the right star.
+
+---
+
+## 🎯 pilot’s insight
+- **llms provide propulsion; humans provide navigation.**
+- the art is not in moving (llms do that instantly) but in **deciding where to go** and **formulating coordinates to arrive there.**
+- mastery = galactic cartography (understanding the shape of the universe) + piloting discipline (asking precise, gravitationally-aware questions).

package/dist/logic/roles/bhrain/.briefs/cognition/cog021.metaphor.galactic_spacetravel.[lesson].md

@@ -0,0 +1,60 @@
+# 🌌 .brief.lesson: piloting llms as spaceships in the concept universe
+
+## 💡 concept
+to use llms well, imagine them as **spaceships** traveling at lightspeed through a **conceptual galaxy**.
+the galaxy contains infinite **concepts** arranged in spheres of abstraction. each concept exerts **gravity**, pulling you in if your navigation is imprecise.
+your role as pilot is to chart the destination and give the ship accurate coordinates (questions).
+
+---
+
+## 📚 materials
+- **map of the galaxy** → the mental model of concept space (root at center, abstractions in shells, instantiations outward).
+- **spaceship (llm)** → fast, powerful engine but directionless without guidance.
+- **pilot’s controls (questions/prompts)** → the interface for steering.
+- **gravity awareness** → recognition that common or vague concepts will suck you into nearby orbits unless coordinates are exact.
+
+---
+
+## 🛠️ practice steps
+1. **orient the galaxy**
+   - sketch your concept in its root form.
+   - note layers of abstraction (outer shells) and concrete instances (radial outward).
+
+2. **define the destination**
+   - decide: are you heading to the core (abstract) or to an outer planet (specific case)?
+   - example: "justice" (core abstraction) vs. "traffic law fine in california" (outer instantiation).
+
+3. **set coordinates (formulate question)**
+   - express the question with the right precision.
+   - avoid vague inputs that leave gravity to decide the landing.
+
+4. **observe gravitational drift**
+   - check if the answer pulled you toward a nearby, high-gravity concept.
+   - if so, refine the coordinates.
+
+5. **refine and relaunch**
+   - adjust the wording of the question to escape local maxima.
+   - iterate until you land on the intended star system.
+
+---
+
+## 🎯 examples
+- **vague address** → "tell me about painting"
+  - gravity pulls to broad art history.
+
+- **precise coordinates** → "explain preparation steps for interior wall painting in a rental apartment"
+  - lands directly on the desired planet.
+
+- **mislanding correction**
+  - q: "how to fix leaks?" → sucked into plumbing.
+  - refine: "how to fix leaks in asphalt driveway sealant" → lands on the right surface.
+
+---
+
+## 🧭 pilot’s takeaway
+- **llms are engines** → they can take you anywhere, instantly.
+- **questions are star coordinates** → your precision determines the arrival point.
+- **concepts exert gravity** → imprecision will trap you in strong but wrong orbits.
+- **piloting skill = clarity + precision** → knowing where you want to go and addressing it sharply.
+
+---

package/dist/logic/roles/bhrain/.briefs/cognition/cog021.structs.catalog.md

@@ -0,0 +1,51 @@
+# 🗂️ .brief: `catalog`
+
+## .what
+A **catalog** is a **structured concept collection**, where each item is
+paired with **descriptive information** to support **recognition**, **selection**, or **retrieval**.
+
+It serves as a **semantic surface** over a deeper collection —
+organized for **browsing**, **filtering**, and **comparative reasoning**.
+
+While an **inventory** tracks availability or logistics,
+a catalog emphasizes **clarity, presentation, and user-centered discovery**.
+
+---
+
+## 🧭 key traits
+
+| trait             | meaning                                                                 |
+|-------------------|-------------------------------------------------------------------------|
+| **enumerated**     | each concept is explicitly listed, not abstracted away                 |
+| **descriptive**    | highlights distinguishing features (e.g. label, image, type, metadata) |
+| **browsable**      | optimized for lateral focus and scanning across entries                |
+| **non-exhaustive** | curated based on salience, criteria, or constraints                    |
+| **ordered**        | often sorted semantically or pragmatically (e.g. relevance, recency)   |
+
+---
+
+## 🧩 comparison
+
+| structure    | emphasizes                 | typical use                        |
+|--------------|----------------------------|------------------------------------|
+| `index`      | position or reference       | lookup or navigation               |
+| `inventory`  | quantity and availability   | logistics, restocking, tracking    |
+| `catalog`    | structure and presentation  | curation, exploration, shopping    |
+
+---
+
+## 📦 examples
+
+- a **product catalog** listing items by type, brand, and price
+- a **library catalog** with subject tags, authors, and summaries
+- a **course catalog** organizing classes with time, credits, and prerequisites
+
+---
+
+## 🧠 role in semantic systems
+
+In a `concept.treestruct`, a catalog acts as a **flattened radial slice**
+at a given `focal.depth` — exposing **breadth peers** for comparison or selection.
+
+It is often used in tandem with primitives like `<compare>`, `<cluster>`, or `<instantiate>`
+to surface patterns or choose options from a structured field.