rhachet-roles-ehmpathy 1.1.0 → 1.2.0

package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.coords.2.abstractive.md

@@ -0,0 +1,59 @@
+# 🧭 .brief: `cog101.concept.treestruct.coords.abstractive`
+
+## .why
+Use this brief if you want to:
+
+- **understand how abstraction works** in a concept `TreeStruct`, especially in terms of generality and specificity
+- **navigate or manipulate concepts radially** — moving inward toward abstractions or outward toward instances
+- **distinguish between different kinds of abstraction**, such as categorical vs functional vs modal
+- **identify the semantic axis** a concept belongs to (e.g., “fruit” is a categorical abstraction)
+- **structure your knowledge hierarchically** by tracing how concepts generalize along meaningful dimensions
+- **design tools or prompts** that rely on structured abstraction (e.g., AI reasoning, taxonomy design, teaching models)
+
+---
+
+## .what
+The **abstractive coordinate** of a concept describes its **radial position** in a `TreeStruct` of meaning — how **general or specific** it is.
+
+This radial motion is called **abstraction**, and moves either:
+- **inward** toward **more general, inclusive** ideas
+- or **outward** toward **more specific, detailed** instances
+
+Every abstraction path follows a **semantic axis** — a distinct dimension of meaning.
+
+---
+
+## 🧱 structure
+
+Each concept has a position along one or more **abstractive semantic axes**.
+Each axis defines a **consistent rule** of generalization.
+
+Examples of such axes:
+
+| axis name        | abstraction path                           | generalizes by...          |
+|------------------|--------------------------------------------|----------------------------|
+| **categorical**  | `"banana"` → `"fruit"` → `"plant"`         | kind or type               |
+| **functional**   | `"spoon"` → `"utensil"` → `"tool"`         | purpose or behavior        |
+| **modal**        | `"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 |
+
+---
+
+## 🔁 radial traversal
+
+Abstractive motion is **radial** in the `concept.treestruct`, not lateral.
+Each axis defines a **line of abstraction** from specific to general — i.e., from **leaf** to **trunk**.
+
+- **inward** motion = `<generalize>`: higher-level, more inclusive
+- **outward** motion = `<instantiate>`: more detailed or constrained
+
+---
+
+## 📌 key point example
+> "Category" is not just a label — it's a **semantic abstraction** along the **categorical axis**.
+
+All categories are abstractive.
+But not all abstractions are categorical.

package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.coords.3.descriptive.md

@@ -0,0 +1,64 @@
+# 🧭 .brief: `cog101.concept.treestruct.coordinates.descriptive`
+
+## .why
+Use this brief if you want to:
+
+- **understand how concepts vary across peers**, not just across levels of abstraction
+- **navigate laterally** within a concept space — across similar-level alternatives
+- **distinguish a concept from its siblings** by highlighting descriptive differences
+- **identify the descriptive axes** a concept can vary along (e.g., flavor, size, style, plausibility)
+- **model variation, contrast, or diversity** within a semantic category
+- **support analogy-making, reframing, or contrastive analysis** between similar ideas
+
+---
+
+## .what
+The **descriptive coordinate** of a concept defines its **angular position** in the `TreeStruct`.
+It captures **how a concept differs from its peers** — not by abstraction, but by **descriptive variation**.
+
+This is an **angular motion**, moving **around the same level** of abstraction.
+
+Where radial abstraction answers “what is this an instance of?”,
+descriptive variation asks “**what kind of this** is it?”
+
+---
+
+## 🧱 structure
+
+Each concept can vary along one or more **descriptive semantic axes**,
+which define the dimensions by which peer concepts differ.
+
+Examples of descriptive axes:
+
+| axis name         | example variations                                | describes...                      |
+|-------------------|---------------------------------------------------|-----------------------------------|
+| **qualitative**   | red / blue / green                                | color                             |
+| **quantitative**  | small / medium / large                            | size                              |
+| **stylistic**     | formal / casual / ironic                          | tone or mode of expression        |
+| **temporal**      | recent / ongoing / historical                     | time-related state                |
+| **systemic**      | part / module / whole                             | structural composition            |
+| **behavioral**    | aggressive / passive / cooperative                | attitude or action pattern        |
+| **plausibility**  | absurd / unlikely / likely / obvious              | perceived believability or realism|
+
+---
+
+## 🔄 angular traversal
+
+Descriptive motion is **lateral** or **angular** — it moves among **peers at the same abstraction level**.
+Think of concepts orbiting the same distance from the core, but **differing in character**.
+
+This enables operations like:
+
+- `<reframe>` — view the same concept from another descriptive lens
+- `<contrast>` — emphasize a difference along one axis
+- `<analogize>` — map lateral structure to a different context
+
+---
+
+## 📌 key point
+> Descriptive motion defines **how** something *is that thing*, not *what* thing it is.
+
+A “banana” and a “mango” are **peers** under the **categorical abstraction** "fruit" —
+but they differ descriptively by flavor, texture, shape, and usage.
+
+Descriptive axes **reveal the variation space** within a category.

package/dist/logic/roles/bhrain/.briefs/cognition/{cog101.cortal.focus.p1.definition.md → cog201.cortal.focus.p1.definition.md}

@@ -3,7 +3,7 @@
 ## .what
 **Cortal focus** is the directional beam of your cognitive attention — a **semantic lightcone** that shines outward from a chosen **conceptual core**, illuminating a structured region of concept space.
 
-It operates over a **concept.treestruct** (radial RootStruct), using geometric parameters to determine:
+It operates over a **concept.treestruct** (spherical RootStruct), using geometric parameters to determine:
 
 - **how far** you reach (`focal.depth`)
 - **how wide** you sweep (`focal.breadth`)
@@ -14,19 +14,28 @@ It operates over a **concept.treestruct** (radial RootStruct), using geometric p
 
 ---
 
+## 🧩 focus = position + posture
+
+Cortal focus is composed of:
+
+- **focus.concept** = **position** → the **anchor concept**, your current location in the semantic structure
+- **focus.context** = **posture** → the **shape of your attention** — how your focus is distributed across depth, breadth, and acuity
+
+---
+
 ## 🌐 where is focus?
 
-The terrain is a **radial concept.treestruct**, where:
+The terrain is a **spherical concept.treestruct**, where:
 
-- nodes = concepts
-- links = semantic relationships (abstraction, specialization, analogy)
+- **nodes** = concepts
+- **links** = **relationships between concepts**, defined as **questions**
+  → each link is a **semantic prompt** — a concept temporarily narrowed into a relationship
 - space = infinite, recursive, intersective
 
 From your **anchor concept**, you emit a cone of attention shaped by:
 
-- **radial** → inward/outward (abstraction/specialization)
-- **lateral** → semantic neighbors at same depth
-- **angular** → cross-branch analogies and metaphors
+- **radial** → abstraction axis (generalizations ⇄ instances)
+- **angular** → descriptive axis (flavor, tone, function)
 
 Your cone of focus slices through this terrain like a lightbeam through mist —
 defining what is **seen**, **resolved**, and **reachable**.
@@ -38,7 +47,7 @@ defining what is **seen**, **resolved**, and **reachable**.
 Cortal focus is a **radial cone** emitted from your current concept:
 
 - `focal.depth` → radial span of semantic layers reached
-- `focal.breadth` → lateral spread of included neighbor concepts
+- `focal.breadth` → angular spread of included neighbor concepts
 - `focal.acuity` → resolution sharpness per concept node
 
 The shape of your focus is not a perfect ring — it’s an **irregular patch of included neighbors**, carved from the TreeStruct by your current attentional configuration.
@@ -49,12 +58,13 @@ The shape of your focus is not a perfect ring — it’s an **irregular patch of
 
 ### 🔬 `focal.acuity`
 
-- **what:** semantic resolution per concept node
+- **what:** semantic resolution at the current concept
 - **effect:** fine-grained traits vs holistic blobs
 - **metaphor:** lens sharpness or pixel density
 - **behavior:**
-  - `acuity++` = more traits, subtypes, distinctions
-  - `acuity--` = coarser impressions, general categories
+  - `.attributes++` = sharper external traits
+  - `.substructs++` = clearer internal structure
+  - `acuity--` = surface-only, low-resolution forms
 
 ---
 
@@ -76,37 +86,40 @@ The shape of your focus is not a perfect ring — it’s an **irregular patch of
 - **effect:** surface detail vs multilevel integration
 - **metaphor:** light penetration into a semantic sphere
 - **behavior:**
-  - `depth++` = more layers (inward and/or outward)
+  - `depth.abstract++` = include more generalizations (inward)
+  - `depth.concrete++` = include more specific instances (outward)
+  - both expanding = `depth++` radial shell of abstraction
   - `depth--` = tighter slice around your current layer
-  - relative to anchor; **not** fixed universal depth
+  - depth is **relative** to anchor, not a fixed universal level
 
 ---
 
 ## 📐 compositional tradeoffs
 
-\\```text
+\`\`\`
 focal.depth × focal.acuity² ∝ focal.breadth²
-\\```
+\`\`\`
 
-This expresses how **cognitive focus** is a constrained beam:
+This expresses the tradeoff between **vertical integration**, **horizontal scope**, and **local resolution**:
 
-- high acuity = more semantic pixels per node
-- high breadth = more nodes in view
-- high depth = more layers stacked
+- `depth` = radial span of abstraction/specialization
+- `breadth²` = angular sweep of peer concepts
+- `acuity²` = pixel density per concept
 
-You can’t max all three without overload or blur.
+> Holding any two constant requires tradeoff with the third.
+> You can’t max all three without overload or blur.
 
 ---
 
 ### 🎛️ cognitive tuning patterns
 
-- `depth++` + `acuity--` → broad but imprecise vertical insight
+- `depth.abstract++` + `acuity--` → broad but imprecise vertical insight
 - `acuity++` + `breadth++` → sharp lateral comparison across peers
 - `depth--` + `acuity++` → zoomed-in detail
 - `breadth++` + `acuity--` → conceptual sweep, low precision
 - `depth++` + `breadth++` + `acuity++` → **unsustainable semantic load**
 
-→ adjust based on whether you're scanning, designing, comparing, teaching, etc.
+→ Adjust based on whether you're scanning, designing, comparing, teaching, etc.
 
 ---
 
@@ -114,12 +127,38 @@ You can’t max all three without overload or blur.
 
 From any anchor (e.g. `"banana"`), you navigate concept space via:
 
-- `<zoomin><abstract>` → "banana" → "fruit" → "organism"
-- `<zoomout><broaden>` → "banana" ↔ "mango" ↔ "apple"
-- `<zoomin><specify>` → "banana" → "peeled banana" → "sliced banana"
-- `<rotate><reframe>` → "banana" ↔ "crescent shape" ↔ "moon"
+- `<generalize>` → "banana" → "fruit" → "organism"
+- `<contrast>` → "banana" ↔ "apple" ↔ "mango"
+- `<decompose>` → "banana" → "peeled banana" → "sliced banana"
+- `<reframe>` → "banana" ↔ "crescent shape" ↔ "moon"
+
+All traversal motions arise from **questions-as-links** —
+concepts narrowed into **semantic relationships** that enable motion.
+Each traversal is an **executable prompt**, and each destination is a **sumption** — possibly another question.
+
+> Focus behaves like a **steerable beam**, shaped by intent, strategy, and available structure.
+
+---
+
+## 🧵 focus.context as fabric
+
+`focus.context` is a **composite of semantic fabrics** —
+each fabric a `concept.treestruct` modeling a contextual dimension (e.g. time, intent, role).
+
+\`\`\`ts
+focus.context = Σ fabric[x]
+\`\`\`
+
+This layered weave defines how your anchor is interpreted.
+
+| fabric         | models...        | sample values           |
+|----------------|------------------|--------------------------|
+| `fabric.time`  | temporal frame   | `future`, `ongoing`      |
+| `fabric.intent`| motivation       | `goal`, `plan`, `urge`   |
+| `fabric.role`  | identity         | `agent`, `observer`      |
 
-Focus behaves like a **steerable beam** — shaped by intent, strategy, and available structure.
+> 🧠 context = **mesh of treestructs**, not a flat state
+> motion can traverse
 
 ---
 
@@ -158,6 +197,17 @@ Focus behaves like a **steerable beam** — shaped by intent, strategy, and avai
 
 ---
 
+### 🧩 shallow + narrow + substructed
+**“internal dissector”**
+**scenario:** modeling [concept:"bicycle gear system"]
+
+- `depth--`
+- `breadth--`
+- `acuity.substructs++` → chains, sprockets, resistance ratios
+→ **outcome:** internal mechanism mastery
+
+---
+
 ### 🌐 deep + wide + fuzzy
 **“system mapper”**
 **scenario:** modeling [concept:"family routine"]
@@ -175,7 +225,6 @@ Cortal focus connects to:
 
 - `concept.treestruct` → the semantic terrain of nodes and links
 - `concept.gravity` → why some concepts act as attention magnets
-- `concept.traversal` → the modes of movement: inward, lateral, radial
 - `concept.perspectives` → defines your frame of motion and relative center
 
 > You never see the whole forest —

package/dist/logic/roles/bhrain/.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/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**