rhachet-roles-ehmpathy 1.1.0 → 1.3.0

package/dist/logic/roles/bhrain/.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/logic/roles/bhrain/.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/logic/roles/bhrain/.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/logic/roles/bhrain/.briefs/cognition/cog251.cortal.focus.p3.usecases.md

@@ -0,0 +1,76 @@
+# 🧰 .brief: `cortal.focus.usecases`
+
+## .what
+
+This brief catalogs **usecases for thinking explicitly about focus**
+— when it's helpful to become aware of `focus.context`, `focus.concept`, and their configuration.
+
+These are moments where **meta-focus** enables stronger reasoning, clarity, or problem-solving.
+
+> To use focus well is to **see clearly**, **ask precisely**, and **move intentionally** through complex ideas.
+
+---
+
+## 🧠 why think about focus?
+
+Most reasoning happens *with* focus but not *about* it.
+
+> But in moments of friction, ambiguity, or overload —
+> explicitly managing your focus can transform how you think.
+
+Thinking about focus helps you:
+
+- **reset direction** (when stuck or scattered)
+- **reframe problems** (by rotating context or anchor)
+- **improve question quality** (via sharper configuration)
+- **accelerate insight** (by tuning depth, breadth, acuity)
+
+---
+
+## 📘 key usecases
+
+| usecase                  | what you do                                       | why it matters                                                |
+|--------------------------|----------------------------------------------------|----------------------------------------------------------------|
+| **🧠 gather your focus**      | align context and concept intentionally          | prepares you to ask precise, meaningful questions               |
+| **🪞 reflect on your focus**  | notice what you're holding + how                 | builds meta-cognition; reveals hidden assumptions or noise      |
+| **🧵 trace a focus drift**    | identify where your attention slipped            | helps recover lost clarity or intent                            |
+| **📐 compress your focus**   | distill many ideas into one articulable node     | boosts communicability and insight                              |
+| **🎯 aim your focus**        | pick a better anchor concept                     | sharpens the entry point of exploration                         |
+| **🔀 reframe your focus**    | shift interpretive context                       | enables new understandings or alternate paths                   |
+| **🚪 unblock with focus**    | realize a question is stuck due to bad focus     | unlocks better questions and next moves                         |
+| **🌀 overload triage**       | manage breadth/depth/acuity tradeoffs            | prevents overwhelm or blur                                      |
+
+---
+
+## 🧠 example: compress your focus
+
+You’ve just gathered a wide set of notes across multiple concepts.
+They feel loosely related, but disorganized.
+
+By **articulating** the shared traits and **generalizing** an abstraction,
+you compress the mess into a **new focal concept**.
+
+```txt
+"These are all ways people avoid decisions"
+→ articulate
+→ [concept: decision avoidance]
+```
+
+
+> Compression is how focus becomes **portable**, **nameable**, and **sharable**.
+
+---
+
+## 🔁 when to think about focus
+
+- when you're **lost** → “what am I even trying to do?”
+- when you're **stuck** → “why can’t I ask a better question?”
+- when you're **drowning** → “too much info, no handle”
+- when you're **scattered** → “my thoughts are all over the place”
+- when you're **teaching** → “what should the learner focus on?”
+- when you're **designing prompts** → “how should this be framed?”
+
+---
+
+> **Focus is a cognitive interface**
+> Thinking explicitly about it gives you control over how you traverse concept space.

package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.1.motion.primitives._.md

@@ -0,0 +1,155 @@
+# 🧱 .brief: `focus.motion.primitives`
+
+## .what
+
+**focus motion primitives** are the atomic units of conceptual motion — each performs a **pure**, **irreducible**, and **driftless** motion along a **single subaxis** of `cortal.focus`.
+
+they enable precise navigation of concepts for thought with clarity and control.
+
+---
+
+## 🧭 properties of a focus motion primitive
+
+| trait              | requirement                                           |
+|--------------------|-------------------------------------------------------|
+| **single subaxis** | modifies exactly one `.focus.[axis].[subaxis]`        |
+| **driftless**      | causes no collateral movement on other subaxes        |
+| **irreducible**    | cannot be broken into simpler focus operations        |
+| **composable**     | may be chained into composite or strategic sequences  |
+| **reversible**     | usually has a well-defined semantic inverse           |
+
+---
+
+## 🔹 catalog of primitives
+
+### `focal.acuity`
+
+acuity has two **distinct subaxes**:
+- `.attributes` → surface qualities and traits
+- `.substructs` → internal components or parts
+
+| primitive        | subaxis           | motion             | description                                     |
+|------------------|--------------------|---------------------|------------------------------------------------|
+| `<articulate>`    | `.attributes++`    | enrich description  | surface observable traits or qualities          |
+| `<compress>`      | `.attributes--`    | reduce description  | flatten or simplify descriptive richness        |
+| `<decompose>`     | `.substructs++`    | reveal parts        | expose internal structure or components         |
+| `<encompose>`     | `.substructs--`    | encapsulate         | bind parts into a coherent structural whole     |
+
+> 🧠 acuity often **varies per node** —
+> some concepts remain blurry while others are semantically sharp.
+
+---
+
+### `focal.depth`
+
+| primitive         | subaxis           | motion             | description                                     |
+|-------------------|--------------------|---------------------|-------------------------------------------------|
+| `<generalize>`     | `.abstract++`      | inward (coreward)   | move to a broader, more inclusive abstraction   |
+| `<instantiate>`    | `.concrete++`      | outward (leafward)  | specify a concrete form, example, or case       |
+
+> 🧭 `focal.depth` primitives move strictly **radially** through semantic space:
+> - `.abstract++` ≡ `.concrete--`
+> - `.concrete++` ≡ `.abstract--`
+
+> this changes **how general or specific** the concept is,
+> but **not which semantic axis** it belongs to.
+
+> 🧩 abstraction may follow distinct semantic **dimensions** —
+> see [catalog of abstraction dimensions](#) for examples (e.g. categorical, functional, causal, potential, emotional, etc.)
+
+> 🪞 meta insight:
+> every `focal.breadth` axis becomes accessible **only after** instantiating into a particular depth shell.
+> → breadth variation happens **within** a given layer of depth.
+
+---
+
+### `focal.breadth`
+
+breadth primitives operate **angularly**, sweeping across lateral variation
+while remaining anchored within the current `focal.depth` shell.
+
+| primitive      | subaxis              | motion                       | description                                         |
+|----------------|-----------------------|-------------------------------|-----------------------------------------------------|
+| `<shift>`       | `.breadth.[axis]++`   | lateral peer change           | switch to nearby alternative along same subaxis     |
+| `<rotate>`      | `.breadth.axis→axis`  | axis reorientation            | shift to a different descriptive axis               |
+| `<invert>`      | `.breadth.axis±180°`  | polarity reversal             | flip to the semantic opposite along same axis       |
+
+---
+
+#### descriptive subaxes
+
+| subaxis         | variation domain                 | example                           |
+|------------------|----------------------------------|-----------------------------------|
+| `categorical`     | type/kind variation              | `"dog"` → `"cat"`                 |
+| `temporal`        | time/stage variation             | `"child"` → `"adult"`             |
+| `functional`      | purpose/behavior                 | `"email"` → `"letter"`            |
+| `emotional`       | affective tone                   | `"curiosity"` → `"fear"`          |
+| `spatial`         | physical or perceptual location  | `"indoors"` → `"outdoors"`        |
+| `subjective`      | role or POV framing              | `"observer"` → `"actor"`          |
+
+> 💡 this list is **illustrative**, not exhaustive —
+> domain-specific systems may define additional semantic axes.
+
+---
+
+## 🔁 reversibility pairs
+
+| primitive       | inverse         | subaxis        | effect                                  |
+|------------------|------------------|------------------|-------------------------------------------|
+| `<decompose>`     | `<encompose>`     | `.substructs`     | expose structure ←→ encapsulate           |
+| `<articulate>`    | `<compress>`      | `.attributes`     | enrich traits ←→ flatten traits           |
+| `<generalize>`    | `<instantiate>`   | `.depth`          | abstract ←→ specify                       |
+| `<invert>`        | `<invert>`        | `.breadth.axis`   | polarity flip ←→ polarity flip            |
+| `<rotate>`        | `<rotate>`        | `.breadth.axis`   | axis A → B ←→ B → A (semantic symmetry)   |
+
+---
+
+## 🧬 classification of motion variants
+
+| kind            | example             | motion profile                          | composite? |
+|-----------------|---------------------|------------------------------------------|------------|
+| **primitive**   | `<compress>`        | `.attributes--`                          | ❌ no      |
+| **composite**   | `<elaborate>`       | `.breadth++` + `.acuity++`               | ✅ yes     |
+| **structural**  | `<zoomout><$x>`     | framework wrapper for composite behavior | ✅ yes     |
+| **strategic**   | `<diagnose>`        | dynamic chaining of tailored composites  | ✅ yes     |
+
+---
+
+## 📐 compositional constraint
+
+\`\`\`
+focal.depth × focal.acuity² ∝ focal.breadth²
+\`\`\`
+
+> you can't go **deep, sharp, and wide** all at once.
+> primitives help you deliberately balance:
+> - `focal.depth` → abstraction layer
+> - `focal.acuity` → resolution/sharpness
+> - `focal.breadth` → descriptive variation
+
+---
+
+## 🪞 metaphor glossary
+
+| primitive        | metaphor                               |
+|------------------|----------------------------------------|
+| `<articulate>`    | reveal the surface texture            |
+| `<compress>`      | smooth out descriptive detail         |
+| `<decompose>`     | crack open the inner workings         |
+| `<encompose>`     | wrap into a unified whole             |
+| `<generalize>`    | collapse coreward into a broader idea |
+| `<instantiate>`   | unfold edgeward into a specific case  |
+| `<shift>`         | step sideways within a dimension      |
+| `<rotate>`        | spin the axis dial                    |
+| `<invert>`        | flip the concept’s polarity           |
+
+---
+
+## 🧱 design usage
+
+- **compose** custom semantic operations using primitive chains
+- **trace** tree-of-thought or weave logs using precise subaxis tags
+- **constrain** reasoning systems to driftless, isolable operations
+- **diagnose** or debug motion paths via their reversible steps
+
+> 💡 focus motion primitives are the **assembly language** of structured thought.