rhachet-roles-bhrain 0.1.0

package/dist/roles/thinker/briefs/cognition/cog201.cortal.focus.p1.examples.cont.md

@@ -0,0 +1,82 @@
+## 🧪 focus scenarios
+
+### 🐶 learning [concept:"dog"]
+*sharp, narrow, shallow*
+
+- `focal.depth = thin`
+  - only the layer around [concept:"dog"], skipping [concept:"mammal"] or [concept:"siberian husky"]
+- `focal.breadth = thin`
+  - ignores peer species like [concept:"cat"], [concept:"bunny"]
+- `focal.acuity = high`
+  - highlights traits like `bark.style`, `fur.type`, `tail.shape`
+
+→ **outcome:**
+- forms a **crisp prototype** of “dog”
+- strong within-category recognition
+- **low abstraction and poor generalization**
+
+---
+
+### 🪛 designing [concept:"mechanical screwdriver"]
+*precision tool design*
+
+- `focal.depth = thin`
+  - fixed on [concept:"mechanical screwdriver"], no abstraction to [concept:"manual tool"]
+- `focal.breadth = thin`
+  - excludes variants like [concept:"ratchet wrench"], [concept:"power driver"]
+- `focal.acuity = high`
+  - detailed on `bit.torque`, `handle.texture`, `shaft.flex`
+
+→ **outcome:**
+- **high-fidelity artifact design**
+- narrow path, no alternative exploration
+
+---
+
+### 🔥 evaluating [concept:"firefighting gear"]
+*functional system fit*
+
+- `focal.depth = thick`
+  - spans abstraction: from [concept:"protective gear"] to [concept:"helmet variants"]
+- `focal.breadth = thick`
+  - compares across roles, risks, and conditions
+- `focal.acuity = low`
+  - simplifies features to functional needs: `resist.heat`, `enable.vision`
+
+→ **outcome:**
+- operationally sound choices
+- **low sensitivity to fine material detail**
+- strong for procurement, weak for innovation
+
+---
+
+### 🧰 diagnosing [concept:"pipe leak"]
+*targeted troubleshooting*
+
+- `focal.depth = thick`
+  - includes specific joint types and system-level context
+- `focal.breadth = thin`
+  - focuses narrowly on the faulty branch
+- `focal.acuity = high`
+  - resolves `thread.condition`, `seal.gap`, `metal fatigue`
+
+→ **outcome:**
+- **precise intervention**
+- excellent for **fault isolation**
+- limited systemic awareness
+
+---
+
+### 🧱 training [concept:"bricklaying workflow"]
+*procedural skill building*
+
+- `focal.depth = thick`
+  - spans from [concept:"tool use"] to bond patterns
+- `focal.breadth = thin`
+  - restricts to one technique set
+- `focal.acuity = high`
+  - attention on `joint.spacing`, `mortar.timing`, `course.level`
+
+→ **outcome:**
+- builds **repeatable skill** and **craft quality**
+- may not transfer to novel tasks or materials

package/dist/roles/thinker/briefs/cognition/cog201.cortal.focus.p2.acuity.md

@@ -0,0 +1,134 @@
+# 🔬 .brief: `cortal.focal.acuity`
+
+## .what
+**cortal.focal.acuity** governs the **semantic resolution** of each concept in focus —
+how **granular**, **precisely attributed**, and **internally resolved** the concept representation is.
+
+It determines how much **inner detail** your focus resolves per concept node within the spherical `concept.treestruct`.
+
+---
+
+## 🧠 how it works
+
+Acuity controls resolution across **two semantic layers**:
+
+- `.attributes` — surface traits, labels, and descriptive features
+- `.substructs` — internal parts, components, or embedded structures
+
+Both can be modulated independently or jointly depending on the task.
+
+#### acuity scale:
+
+- `acuity++` → high resolution
+  - many dimensions resolved: features, internals, edge cases
+  - e.g. for [concept:"hammer"]:
+    - `.attributes`: `head.mass`, `handle.material`, `grip.type`
+    - `.substructs`: `core.fusion`, `shock.channeling.structure`
+
+- `acuity--` → low resolution
+  - coarse, holistic representations
+  - e.g. just “thing you hit with”
+
+Acuity operates **independently** of:
+- `focal.depth`: how many layers of abstraction are included
+- `focal.breadth`: how many peer concepts are viewed
+
+---
+
+## 🔦 metaphor: optical focus
+
+- high acuity = **sharp lens**
+  - captures semantic edges, traits, and inner systems
+  - like increasing megapixels on a single node
+
+- low acuity = **blurry filter**
+  - sees general shape, label, or purpose
+  - useful for rapid categorization or zoomed-out navigation
+
+---
+
+## 📐 composition tradeoff
+
+\```
+focal.depth × focal.acuity² ∝ focal.breadth²
+\```
+
+Because acuity is squared, it's **computationally expensive** —
+high acuity demands either larger breadth or shallower depth to avoid overload.
+
+---
+
+## 🧪 examples
+
+### 🐶 [concept:"dog"]
+
+- `acuity--`: “a furry animal that barks”
+- `acuity++`:
+  - `.attributes`: `breed.type`, `coat.pattern`, `jaw.structure`
+  - `.substructs`: `muscle.groups`, `nervous.pathways`, `behavior.protocols`
+
+---
+
+### 🔋 [concept:"battery"]
+
+- `acuity--`: “thing that stores energy”
+- `acuity++`:
+  - `.attributes`: `form.factor`, `charge.curve`, `voltage.stability`
+  - `.substructs`: `anode.stack`, `electrolyte.channel`, `thermal.fuse.logic`
+
+---
+
+### 🪚 [concept:"handsaw"]
+
+- `acuity--`: “tool for cutting”
+- `acuity++`:
+  - `.attributes`: `tooth.pitch`, `blade.length`, `grip.material`
+  - `.substructs`: `core.flex.strata`, `fastener.joints`, `multi-bevel.edge`
+
+---
+
+## 🎯 why acuity matters
+
+High acuity enables:
+
+- **precise design and modeling**
+- **deep diagnosis and troubleshooting**
+- **attribute-based comparison or distinction**
+
+Low acuity supports:
+
+- **rapid categorization**
+- **abstract reasoning and compression**
+- **broad or shallow semantic navigation**
+
+---
+
+## 🔁 dynamic behavior
+
+Acuity is often **modulated during traversal**:
+
+- zoom in = `acuity++` to analyze traits and internals
+- zoom out = `acuity--` to generalize or jump layers
+
+It can also **vary per node**:
+- some neighbors are sharp and detailed
+- others remain fuzzy or holistically interpreted
+
+---
+
+## ⚠️ caution: over-acuity
+
+Overfocusing can lead to:
+
+- irrelevant micromanagement
+- detail overload
+- failure to generalize
+
+Use acuity **intentionally** — zoom in with purpose, zoom out with perspective.
+
+---
+
+## 🧰 use it for:
+
+- **design**, **diagnosis**, **teaching**, **analysis**
+- any task that requires distinguishing between **subtle traits** or **complex internal structures**

package/dist/roles/thinker/briefs/cognition/cog201.cortal.focus.p2.breadth.md

@@ -0,0 +1,151 @@
+# 🌐 .brief: `focal.breadth`
+
+## 🌐 what is `focal.breadth`?
+
+`focal.breadth` measures how **wide your attention spans** across the **semantic space**
+at a given level of abstraction. it governs how many **descriptive dimensions** are activated
+as you explore the meaning of a concept.
+
+it traverses **angularly along the descriptive axis** of the `concept.treestruct`
+(see: `concept.treestruct.axis.descriptive`).
+
+---
+
+## 🧠 how it works
+
+- **angular motion** — moves around the same abstraction layer
+- enables **comparison**, **reframing**, and **semantic expansion**
+- does **not** change abstraction level — only which **kind** of variation is in view
+
+`focal.breadth` is always measured **relative to the current focal anchor** —
+it defines how many **descriptive neighbors** are included around a given concept.
+
+---
+
+## 🧩 descriptive subaxes
+
+each direction of breadth corresponds to a **semantic axis of description**:
+these are the **orthogonal ways** a concept can differ from its peers.
+
+| subaxis          | description type             | example motion                           |
+|------------------|-------------------------------|-------------------------------------------|
+| **categorical**  | kind or class                 | `"dog"` ⟶ `"cat"`                         |
+| **temporal**     | sequence or state             | `"childhood"` ⟶ `"adulthood"`             |
+| **functional**   | purpose or behavior           | `"email"` ⟶ `"letter"`                    |
+| **potential**    | possibility or constraint     | `"can fly"` ⟶ `"must fly"`                |
+| **emotional**    | affective tone                | `"fear"` ⟶ `"curiosity"`                  |
+| **causal**       | influence or mechanism        | `"match"` ⟶ `"fire"`                      |
+| **subjective**   | point of view or role         | `"observer"` ⟶ `"actor"`                  |
+
+> ✅ `focal.breadth` controls **how many of these axes you're exploring at once**
+
+---
+
+## ➕ genuine breadth operations
+
+| operation     | effect                                          |
+|---------------|-------------------------------------------------|
+| `breadth++`   | widen focus to include **more angular neighbors**
+| `breadth--`   | narrow the span of included peers
+
+---
+
+## 🧠 traversal patterns
+
+These are **semantic maneuvers** that occur while navigating along a descriptive axis.
+They shape the **direction or structure** of traversal — not its total width.
+
+| pattern       | effect                                               |
+|----------------|------------------------------------------------------|
+| `compare`      | place multiple descriptive peers **side-by-side**
+| `contrast`     | emphasize one or more **salient differences**
+| `rotate`       | shift to a **different descriptive axis** (e.g. category ⟶ time)
+| `invert`       | flip a **semantic polarity** (e.g. agent ⟷ patient, fear ⟷ desire)
+| `reframe`      | recast a concept through a new interpretive lens
+| `extend`       | continue further along the **same descriptive axis**
+
+---
+
+## 🔦 metaphor: shaped spotlight
+
+Focus acts like a **semantic spotlight**, sweeping across a **ring of descriptive variation**.
+But rather than lighting a perfect cone, it reveals a **shaped patch**, molded by:
+
+- query framing and cognitive bias
+- recognition, salience, or memory activation
+- active goals or task relevance
+
+---
+
+## 🔁 interaction with other focus dimensions
+
+- at each `focal.depth`, the **descriptive space** around the concept
+  is governed by `focal.breadth` — which subaxes are activated, and how widely
+
+- **greater breadth** = more **dimensional context**, more analogies, more comparisons
+- **narrower breadth** = tighter conceptual focus, less noise
+
+---
+
+## 📐 compositional tradeoff
+
+\```
+focal.depth × focal.acuity² ∝ focal.breadth²
+\```
+
+Because breadth is **quadratically costly**, high breadth limits:
+
+- depth of abstraction
+- sharpness of detail
+- overall focus stability
+
+---
+
+## 🧭 traversal spectrum
+
+| breadth level     | description                                      |
+|-------------------|--------------------------------------------------|
+| **tight**         | immediate siblings only                          |
+| **medium**        | subtypes, cousins, variations                    |
+| **wide**          | analogies, cross-domain links                    |
+
+At wide angles, `breadth` may traverse **across descriptive subaxes** —
+e.g. from [concept:"dog"] → [concept:"robot"] via behavioral analogy, or → [concept:"wolf"] via categorical frame.
+
+---
+
+## 🧪 examples
+
+### 🐶 anchor: [concept:"dog"]
+
+- `breadth--`: only [concept:"dog"]
+- `breadth++`: [concept:"cat"], [concept:"rabbit"], [concept:"ferret"]
+
+→ favors **mammals**, filters by familiarity
+
+---
+
+### 🍌 anchor: [concept:"banana"]
+
+- `breadth--`: just [concept:"banana"]
+- `breadth++`: [concept:"apple"], [concept:"plantain"], [concept:"mango"]
+
+→ shaped by **culinary use**, **fruit morphology**, **color palette**
+
+---
+
+### 🛠️ anchor: [concept:"screwdriver"]
+
+- `breadth--`: [concept:"manual screwdriver"]
+- `breadth++`: [concept:"torx driver"], [concept:"allen key"], maybe [concept:"impact driver"]
+
+→ selected by **usage**, **mechanism**, **task relevance**
+
+---
+
+## 🎯 use it to:
+
+- **cluster semantic neighbors**
+- **contrast descriptive peers**
+- **explore angular variation**
+- **triangulate concepts within a shared depth layer**

package/dist/roles/thinker/briefs/cognition/cog201.cortal.focus.p2.depth.md

@@ -0,0 +1,147 @@
+# 🌊 .brief: `focal.depth`
+
+## 🧠 what is `focal.depth`?
+
+`focal.depth` represents the **radial distance** between a focused concept
+and the **core abstraction** it belongs to — measuring how **abstract or concrete**
+your current mental frame is.
+
+it governs the **level of generality or specificity** in your thought.
+
+---
+
+## 🧭 how it works
+
+- **radial abstract motion** → `depth.abstract++`
+  → zooms toward **more abstract**, **inclusive** concepts
+  → e.g. `"dog"` ⟶ `"mammal"` ⟶ `"organism"`
+
+- **radial concrete motion** → `depth.concrete++`
+  → zooms toward **more specific**, **instantiated** concepts
+  → e.g. `"color"` ⟶ `"red"` ⟶ `"rust red"`
+
+these motions follow the **universal abstraction axis**
+of the `concept.treestruct`, from root to leaf.
+
+---
+
+## 🌐 interaction with semantic space
+
+- each concept **at a given depth** is surrounded by **descriptive alternatives**
+  along angular axes (e.g. categorical, temporal, causal)
+
+- `focal.depth` does **not change axis** — it moves **radially** through
+  the semantic abstraction that gives rise to those axes at each level.
+
+---
+
+## 📐 structural metaphor
+
+> imagine a tree:
+>
+> - **trunk** = root abstractions
+> - **branches** = intermediate categories
+> - **leaves** = specific instances
+
+`focal.depth` is how far your attention has traveled **along a branch** —
+from the **core abstraction** toward the **concrete edge**.
+
+---
+
+## 🧩 kinds of abstraction
+
+not all abstraction is categorical. each concept sits on one or more
+**abstractive semantic axes**, which define *how* it generalizes:
+
+| abstractive axis | abstraction path                          | generalizes by...         |
+|------------------|--------------------------------------------|---------------------------|
+| **categorical**  | `"banana"` → `"fruit"` → `"plant"`         | kind or type              |
+| **functional**   | `"spoon"` → `"utensil"` → `"tool"`         | purpose or behavior       |
+| **potential**    | `"can walk"` → `"mobility"` → `"agency"`   | ability or constraint     |
+| **causal**       | `"match"` → `"ignition"` → `"fire source"` | influence or mechanism    |
+| **emotional**    | `"fear"` → `"negative affect"` → `"alert"` | affective tone            |
+| **ontological**  | `"emotion"` → `"neural event"` → `"process"` | being or substance       |
+| **logical**      | `"even number"` → `"divisible by 2"` → `"numeric property"` | provable structure |
+
+---
+
+## 📊 thickness vs precision
+
+- `focal.depth++` → more layers included in view
+- `focal.depth--` → thinner slice around anchor
+
+choose based on your cognitive goal:
+
+| Use Case                  | Strategy                         |
+|---------------------------|----------------------------------|
+| Pattern → implementation  | `depth++` for vertical span      |
+| Local precision task      | `depth--` for focus              |
+| Core essence only         | `depth.abstract--`               |
+| Fine-grain edge only      | `depth.concrete--`               |
+
+---
+
+## 📈 compositional interaction
+
+\```
+focal.depth × focal.acuity² ∝ focal.breadth²
+\```
+
+this geometric constraint governs semantic resolution:
+
+- the deeper your shell, the finer your acuity must be reduced
+- you can’t go **deep, wide, and sharp** all at once — without tradeoffs
+
+---
+
+## 🧠 examples
+
+### 🐶 anchor: [concept:"dog"]
+
+- `depth.abstract++`:
+  [concept:"mammal"] → [concept:"animal"] → [concept:"organism"]
+- `depth.concrete++`:
+  [concept:"golden retriever"] → [concept:"service retriever"] → [concept:"autism-assist retriever"]
+
+---
+
+### 🛠️ anchor: [concept:"hammer"]
+
+- `depth.abstract++`:
+  [concept:"hand tool"] → [concept:"manual implement"] → [concept:"mechanical device"]
+- `depth.concrete++`:
+  [concept:"claw hammer"] → [concept:"rubber-handled claw hammer"] → [concept:"ergonomic demolition hammer"]
+
+---
+
+## 🧰 radial composition behavior
+
+\```
+focal.depth++
+⇒ depth.abstract++ && depth.concrete++
+⇒ [concept:"mammal"] ←→ [concept:"dog"] ←→ [concept:"autism-assist retriever"]
+\```
+
+\```
+focal.depth--
+⇒ depth.abstract-- && depth.concrete--
+⇒ only [concept:"dog"]
+\```
+
+---
+
+## 🪞 meta insight
+
+> every **descriptive axis** that varies a concept
+> emerges from **instantiating** the abstraction one level above.
+
+that’s why `focal.depth` controls **which band of descriptive variation** becomes available.
+
+---
+
+## 🧭 use when you need:
+
+- **multilevel semantic perspective**
+- **vertical reasoning chains**
+- **semantic scaffolding**
+- **narrative abstraction control**

package/dist/roles/thinker/briefs/cognition/cog251.cortal.focus.p3.fabric.md

@@ -0,0 +1,96 @@
+# 🧵 .brief: `focus.context.fabric`
+
+## .what
+
+`focus.context.fabric` reframes **context** as a **composite of semantic fabrics** —
+each fabric being its own `concept.treestruct`,
+woven together to define the **background** that gives meaning to current focus.
+
+> 🧠 context is not a flat state or static frame —
+> it’s a **woven composite** of many treestructs layered in parallel.
+
+---
+
+## 🧶 definition
+
+- `focus.context` = a **composite**
+- each **fabric** = a full `concept.treestruct`
+- each fabric models a **different semantic dimension**
+
+\`\`\`ts
+focus.context = fabric.time + fabric.intent + fabric.identity + ...
+\`\`\`
+
+> context ≠ one map
+> context = **a quilt of many maps**, overlaid and stitched together
+
+---
+
+## 📦 structure of a fabric
+
+A **fabric** is:
+
+- a structured semantic space (just like the `concept.treestruct`)
+- specialized for a **particular interpretive dimension**
+- traversable, abstractable, and clusterable just like any other conceptual space
+
+| fabric         | dimension it models     | sample entries                       |
+|----------------|--------------------------|--------------------------------------|
+| `fabric.time`  | temporal structure        | `past`, `present`, `future`, `delay` |
+| `fabric.intent`| motivational scaffolding | `goal`, `plan`, `urge`, `commitment` |
+| `fabric.role`  | social identity           | `speaker`, `agent`, `listener`       |
+| `fabric.quality`| evaluation / judgment    | `flawed`, `valid`, `unclear`         |
+| `fabric.truth` | epistemic belief          | `assumed`, `known`, `uncertain`      |
+
+---
+
+## 🧠 example: plan vs attempt
+
+\`\`\`ts
+[attempt] = [plan] projected through fabric.time
+\`\`\`
+
+- `[plan]` lives in `fabric.intent`
+- `[attempt]` overlays **intent + time**
+- additional overlays (e.g. `fabric.status`) could distinguish between `[attempt]`, `[abandonment]`, `[recovery]`, etc.
+
+---
+
+## 🧭 interaction with focus
+
+| component        | meaning                              |
+|------------------|---------------------------------------|
+| `focus.concept`  | the current anchor (the berry)        |
+| `focus.context`  | the **active weave** of fabrics       |
+| `motion`         | may traverse within or across fabrics |
+
+→ focus doesn't just sit *inside* a fabric —
+it **operates across** many fabrics at once.
+
+---
+
+## 🪡 metaphor
+
+> 🧵 each **fabric** is a stitched-together treestruct
+> 🪡 the full **context** is a layered weave of these fabrics
+> 🧠 motion across fabrics = shifting posture or frame
+
+---
+
+## 📚 usecase: why model context as fabric?
+
+- avoids flattening multidimensional background into a single state
+- enables reuse of existing treestructs as **contextual overlays**
+- lets you model **meaning shifts** by swapping or traversing fabrics
+
+---
+
+## 🔁 related briefs
+
+- [`cortal.focus`](./cortal.focus.md)
+- [`concept.treestruct`](./concept.treestruct.md)
+- [`focus.motion.primitives`](./focus.motion.primitives.md)
+- [`cortal.assemblylang.primitives`](./cortal.assemblylang.primitives.md)
+- [`questions`](./questions.md)
+
+---

package/dist/roles/thinker/briefs/cognition/cog251.cortal.focus.p3.mode.md

@@ -0,0 +1,68 @@
+# .brief: cortal.focus.mode
+
+## what
+
+`cortal.focus.mode` defines the **shape and distribution** of cognitive attention — whether it is narrowly directed or broadly diffused.
+
+It governs how the mind allocates its **attention beam**, affecting what kind of mental processing is possible or favored.
+
+---
+
+## modes
+
+### 🔦 flashlight mode
+- **beam**: narrow, directed
+- **reach**: long-range, precise
+- **focus**: deep, sharp, singular
+- **usecase**: detail work, problem-solving, targeting
+- **mental stance**: concentrated, convergent, analytical
+- **focal tradeoffs**:
+  - `focal.breadth ↓`
+  - `focal.depth ↑`
+  - `focal.acuity ↑`
+
+### 🏮 lantern mode
+- **beam**: wide, ambient
+- **reach**: short-range, fuzzy
+- **focus**: broad, diffuse, multiple
+- **usecase**: situational awareness, brainstorming, ambient scanning
+- **mental stance**: receptive, divergent, associative
+- **focal tradeoffs**:
+  - `focal.breadth ↑`
+  - `focal.depth ↓`
+  - `focal.acuity ↓`
+
+---
+
+## transitions
+
+| transition     | effect                             | grammar          |
+|----------------|------------------------------------|------------------|
+| `flashlight → lantern` | widen scope, invite serendipity | `<zoomout>`       |
+| `lantern → flashlight` | isolate signal, resolve detail | `<zoomin>`        |
+| `flashlight <-> lantern` | shift focus strategy             | `<refocus>`, `<reframe>` |
+
+---
+
+## research summary
+
+- The **focused mode** aligns with the brain’s **Executive Network**, used in analytical and rule-based learning ([Oakley 2018](https://barbaraoakley.com/wp-content/uploads/2018/02/Learning-How-to-Learn-Excerpt.pdf)).
+- The **diffuse mode** activates the **Default Mode Network (DMN)**, associated with creativity, insight, and memory consolidation during rest or daydreaming ([Raichle 2001](https://en.wikipedia.org/wiki/Default_mode_network)).
+- **Alternating modes** improves comprehension and problem-solving. Breaks, sleep, and relaxed walks allow diffuse processing to form connections missed during focus ([Oakley; Brainscape](https://www.brainscape.com/academy/focused-vs-diffuse-thinking-learning/)).
+- Attention rhythmically **pulses (~4 Hz)** between sharp and soft states, suggesting that even “focus” naturally flickers to maintain awareness ([Wired 2023](https://www.wired.com/story/brain-distraction-procrastination-science)).
+
+---
+
+## related
+
+- `focal.breadth` — how wide the current attention span is
+- `focal.acuity` — how detailed the current resolution is
+- `focal.depth` — how far from the conceptual surface we’re focusing
+- `cortal.focus.tradeoffs` — governs how these values relate
+
+---
+
+## metaphor
+
+- flashlight = **targeted beam** → sees far, but only one spot
+- lantern = **ambient glow** → sees nearby, but sees *everything*