rhachet-roles-ehmpathy 1.0.0 → 1.1.0

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

package/dist/logic/roles/bhrain/.briefs/cognition/cog101.cortal.focus.p3.rythm.md

@@ -0,0 +1,56 @@
+# .brief: cortal.focus.rhythm
+
+## what
+
+`cortal.focus.rhythm` describes the **temporal dynamics** of attention — how focus fluctuates over time, even during sustained concentration.
+
+This rhythm determines how often the mind shifts between **sharp focal moments** and **ambient peripheral checks**, balancing vigilance with stability.
+
+---
+
+## empirical basis
+
+- Neuroscience shows attention **oscillates ~4 times per second (~4 Hz)** between high-acuity “spotlight” and broader “scan” states.
+- These pulses help us stay focused **without going blind to the environment** — maintaining both **task lock** and **situational readiness**.
+- This oscillation may stem from **theta band activity** in the brain’s attentional circuits ([Wired 2023](https://www.wired.com/story/brain-distraction-procrastination-science)).
+
+---
+
+## structure
+
+| property         | value                    |
+|------------------|--------------------------|
+| `rhythm.freq`    | ~4 Hz (pulses/sec)       |
+| `rhythm.period`  | ~250 ms per cycle        |
+| `rhythm.shape`   | alternating sharp/broad  |
+| `rhythm.bias`    | can skew flashlight/lantern depending on context or fatigue |
+
+---
+
+## cognitive implications
+
+- Even in “focus mode,” awareness **flickers** to check surroundings or internal memory queues.
+- Interrupting this rhythm (via multitasking, noise, or UI overload) **reduces working memory** and **increases error rate**.
+- Honoring the rhythm — via rhythm-aligned study blocks or spaced breaks — **boosts learning and resilience**.
+
+---
+
+## related
+
+- `cortal.focus.mode` — flashlight vs lantern
+- `focal.acuity` — varies within each pulse
+- `focus.shift.latency` — time cost of switching between tasks vs pulses
+- `cortal.fatigue.adaptation` — rhythm slows or degrades under exhaustion
+
+---
+
+## metaphor
+
+- Like a **strobe light** that rapidly alternates narrow laser beams and wide-angle flashes
+- Like **saccades** in eye movement: we scan and fixate in bursts, not smoothly
+
+---
+
+## design principle
+
+🧠 Interfaces, study strategies, and communication should **respect natural attention pulses** — avoid overwhelming the mind between its inhale/exhale moments.

package/dist/logic/roles/bhrain/.briefs/cognition/cog301.concept.traversal.p1.universal.md

@@ -0,0 +1,108 @@
+# 🧭 .brief: concept.treestruct.traversal
+
+## .what
+The **concept.treestruct.traversal** model defines the three fundamental directions of **semantic movement** in the universal rootball:
+
+1. **radial** — abstraction and specialization
+2. **lateral** — peer-to-peer comparison at the same depth
+3. **angular** — cross-axis shifts, often involving metaphor, analogy, or re-framing
+
+These directions describe how a thinker or system can **navigate** from one concept to another — based not on static position, but on the **path taken through meaning**.
+
+---
+
+## .why
+
+Modeling traversal is essential for:
+
+- distinguishing between **structural motion** and **semantic drift**
+- grounding metaphor and analogy in measurable displacements
+- explaining how conceptual reasoning moves from point to point
+- linking relative and universal perspectives through common mechanics
+
+Traversal defines the **vectors of thought** in concept space.
+
+---
+
+## .modes of traversal
+
+### 🌀 radial traversal
+
+> Move toward or away from the core concept: `"concept"`
+
+- **inward** = abstraction (generalization, simplification)
+- **outward** = specification (elaboration, detail)
+- controlled by `focal.depth`
+- radial motion defines how far a concept is from the root
+
+📌 this is the **primary axis of compression**
+📌 motion is often hierarchical or categorical in nature
+
+---
+
+### ↔️ lateral traversal
+
+> Move across peer concepts at the same level of abstraction
+
+- explores conceptual **neighbors**
+- often used in comparison, substitution, clustering
+- measured by `focal.breadth`
+- lateral motion assumes local semantic coherence
+
+📌 when semantic angle is small, **angular ≈ lateral**
+📌 often invisible in thought — we "drift" between peers seamlessly
+
+---
+
+### 🔀 angular traversal
+
+> Shift semantic direction — change frame, domain, or axis
+
+- may involve:
+  - domain switching (e.g. taxonomy → function)
+  - role shifting (e.g. `"dog"` as animal → `"dog"` as servant)
+  - metaphor (e.g. `"knife"` ↔ `"word"`)
+  - analogical reasoning
+- often includes **radial changes** as side-effects
+- angular motion is less linear — more like a **semantic curve**
+
+📌 angular motion is the **engine of creative, lateral, symbolic thought**
+📌 enables pattern recognition, schema transfer, and reframing
+
+---
+
+## .gradient boundary
+
+> The boundary between lateral and angular traversal is **not discrete**.
+
+- when angular displacement is small, lateral ≈ angular
+- when axis/frame changes, angular ≠ lateral
+- key distinction: **does the movement preserve semantic orientation or reframe it?**
+
+---
+
+## .compound traversal
+
+Most real traversal is **blended**:
+
+- `"banana"` → `"apple"` → `"fruit"` → `"snack"` → `"joke"` → `"banana phone"`
+
+This path includes:
+- lateral (apple)
+- radial-in (fruit)
+- radial-out (snack)
+- angular (joke)
+- angular again (banana as visual pun)
+
+📌 traversal chains accumulate displacement
+📌 over time, they drift semantically and structurally
+
+---
+
+## .notes
+
+- traversal ≠ position — it's **semantic movement**
+- traversal defines how we **think**, **search**, **compare**, and **reinterpret**
+- all traversal occurs within the **universal RootStruct**, but may be framed **relatively** or **fractally**
+
+> Concepts are not just things to describe — they are places to move between.

package/dist/logic/roles/bhrain/.briefs/cognition/cog301.concept.traversal.p2.relative.md

@@ -0,0 +1,76 @@
+# 🎯 .brief: concept.traversal.relative
+
+## .what
+**Relative traversal** is the act of navigating concept space from a **local anchor**, using directional motion along the axes of:
+
+- **depth** → how far you traverse across abstraction layers
+- **breadth** → how many semantic neighbors you include
+- **acuity** → how finely you resolve each concept in view
+
+This motion takes place within the `concept.treestruct` and is governed by the structure of your `cortal.focus`.
+
+---
+
+## 🎛️ axes of motion
+
+### 🕳️ depth
+Radial traversal **inward or outward** from the anchor concept.
+
+- `depth.inward++` → include more **abstract cores**
+  - e.g. `"banana"` → `"fruit"` → `"plant organ"` → `"organism"`
+- `depth.outward++` → include more **specialized instances**
+  - e.g. `"banana"` → `"sliced banana"` → `"frozen banana coin"`
+- `depth.inward--` or `depth.outward--` → **trim layers** from core or edge
+
+---
+
+### 🔭 breadth
+Lateral inclusion of **semantic neighbor** concepts at a given depth.
+
+- `breadth++` → include more **neighbor concepts**
+  - e.g. `"banana"` ↔ `"mango"` ↔ `"pear"` ↔ `"pineapple"`
+- `breadth--` → restrict to fewer or single peer(s)
+  - e.g. `"banana"` only
+
+> Real breadth is not a perfect ring — it's an **irregular cloud** of selected neighbors.
+
+---
+
+### 🔬 acuity
+Adjustment of **semantic resolution** on each concept.
+
+- `acuity++` → resolve more fine-grained features or attributes
+  - e.g. `banana.color`, `banana.curvature`, `banana.firmness`
+- `acuity--` → see only coarse or holistic forms
+  - e.g. just “banana” as “fruit,” ignoring detail
+
+---
+
+## 🧠 common traversal moves
+
+| Move         | Axis       | Description                                   | Example                                              |
+|--------------|------------|-----------------------------------------------|------------------------------------------------------|
+| `abstract`   | depth.inward++  | move toward more general concept             | `"banana"` → `"fruit"`                               |
+| `specify`    | depth.outward++ | move toward more specific subtype            | `"dog"` → `"border collie"`                          |
+| `exemplify`  | depth.outward++ | point to an instance of a type               | `"fruit"` → `"banana"`                               |
+| `decompose`  | acuity++        | break into semantic parts or properties      | `"banana"` → `"peel"`, `"flesh"`, `"color"`          |
+| `broaden`    | breadth++       | include more lateral peers                   | `"banana"` ↔ `"mango"`, `"pear"`, `"grape"`          |
+| `narrow`     | breadth--       | restrict peer inclusion                      | only `"banana"`                                      |
+| `blur`       | acuity--        | reduce resolution for general interpretation | ignore peel/flesh — treat `"banana"` holistically    |
+| `sharpen`    | acuity++        | increase resolution on semantic structure    | attend to `stem.thickness`, `ripeness.window`, etc.  |
+
+---
+
+## 🔁 traversal = active reconfiguration
+
+Each traversal move modifies your **focal envelope** — the portion of concept space currently visible and resolved.
+
+This enables:
+
+- **pattern matching** (`depth.inward++` + `breadth++`)
+- **artifact design** (`depth.outward++` + `acuity++`)
+- **decision making** (`breadth++` + `acuity++`)
+- **abstraction** and **integration** (`depth.inward++` + `acuity--`)
+
+> Thought is traversal —
+> and traversal is motion through structured meaning.

package/dist/logic/roles/bhrain/.briefs/cognition/cog301.concept.traversal.p3.directions.md

@@ -0,0 +1,42 @@
+# 🧭 .brief: concept.traversal.directions
+
+## .what
+**concept.traversal.directions** defines the **axes of movement** across a `concept.treestruct` — representing the **semantic paths** along which a mind or system may navigate, abstract, compare, or elaborate meanings.
+
+Each axis captures a **distinct mode of generalization or relation**, structuring how concepts cluster and evolve across the conceptual terrain.
+
+---
+
+## 🧠 comment
+There is a **set of common traversal axes** that appear across human language, categorization, and reasoning. These directions can **intersect**, allowing a single concept to move outward or inward in **multiple dimensions simultaneously**.
+
+---
+
+## 📐 common semantic directions of traversal
+
+| axis             | abstraction path                                  | how it generalizes             |
+|------------------|---------------------------------------------------|--------------------------------|
+| **categorical**  | `"dog"` → `"mammal"` → `"animal"`                | by type or membership          |
+| **functional**   | `"email"` → `"message"` → `"communication"`      | by purpose or behavior         |
+| **ontological**  | `"emotion"` → `"neural state"` → `"event"`       | by kind of being               |
+| **capability**   | `"can walk"` → `"has mobility"` → `"has agency"` | by possibility or constraint   |
+| **emotional**    | `"fear"` → `"negative affect"` → `"alert signal"`| by affective tone              |
+| **causal**       | `"match"` → `"ignition"` → `"fire source"`       | by mechanism or influence      |
+
+---
+
+## 🧩 notes
+
+- These directions are often **interwoven** — real-world traversal might follow a **braid of axes**.
+- They define **local gradients** within the `concept.treestruct`, shaping how concepts relate and flow.
+- Each direction may support both:
+  - **abstraction** (inward traversal)
+  - **elaboration** (outward traversal)
+
+---
+
+## 🔁 related
+
+- `concept.treestruct` → the structured semantic space
+- `cortal.focus` → how your attention moves through it
+- `<zoom>` → the traversal operations executed across dimensions

package/dist/logic/roles/bhrain/.briefs/distilisys.grammar.compressed.md

@@ -0,0 +1,19 @@
+patterns:
+  - [resource] -> <mechanism> -> [resource]
+  - <mechanism>[resource]
+  - <mechanism>[resource]<mechanism>
+  - @[actor]<mechanism> -> [resource] -> {drive:<<effect>>[motive]}
+  - <create>[<mechanism>].to(<mechanism>[resource])
+
+requirements:
+  - all <verb>s must be declared as <mechanism>s
+  - all [noun]s must be declared as [resource]s
+  - all <mechanism>s should be prefixed with their root operation
+    - <get> for reads
+    - <set> for dobj mutations
+    - <rec> for event emissions
+  - use <mechanism>[resource] syntax for brevity, when applicable
+  - scope [resources] within [domain]s when needed for specificity
+    - [domain][resource]
+  - leverage [resources] .attributes when needed
+    - [resource].attribute

package/dist/logic/roles/bhrain/.briefs/physics/optics.focal.acuity.md

@@ -0,0 +1,77 @@
+# .brief: focal.acuity
+
+## what
+
+**focal.acuity** refers to the **fineness of structure** that can be resolved **at the focal plane** — the geometric surface where optical focus is sharpest. It represents the **resolving power** of the system in the region of maximum clarity.
+
+---
+
+## why
+
+While **focal.depth** determines *how much* of the scene appears in focus, **focal.acuity** determines *how sharply* the focal plane itself is rendered.
+
+It is essential for:
+- Capturing fine textures and edge contrast
+- Supporting high-resolution imaging
+- Achieving clinical clarity in product, macro, and technical photography
+
+---
+
+## governed by
+
+### 🔬 Diffraction-limited resolution
+
+blur_diameter = d = 2.44 * λ * N
+=> focal.acuity ∝ 1 / d
+=> focal.acuity ∝ 1 / N
+
+```\`\`
+focal.acuity ∝ 1 / N
+\`\```
+
+where:
+- d = diffraction blur diameter
+- lambda = wavelength of light (e.g. 550 nm for green)
+- N = aperture (f-number)
+
+> focal.acuity **decreases** (detail coarsens) with:
+> - smaller aperture (larger f-number)
+> - longer wavelengths (e.g. redder light)
+
+---
+
+## key behaviors
+
+| Adjustment                   | Effect on focal.acuity        |
+|------------------------------|-------------------------------|
+| Larger aperture (↓ f-number) | increases it (sharper detail) |
+| Smaller aperture (↑ f-number)| decreases it (diffraction blur) |
+| Shorter wavelength           | increases it (sharper edges)  |
+| Better optics/sensor         | improves overall acuity       |
+
+---
+
+## creative usage
+
+- **High focal.acuity** (e.g. f/2.8–f/5.6):
+  - Yields crisp microtexture and high subject clarity
+  - Ideal for macro, studio, and product photography
+
+- **Reduced focal.acuity** (e.g. f/16–f/22):
+  - Acceptable in landscape or documentary work
+  - Used when prioritizing depth over precision
+
+---
+
+## limitations
+
+- **focal.acuity** is fundamentally limited by diffraction at small apertures
+- Increasing acuity reduces **focal.depth**, unless distance is increased
+- Post-processing cannot restore detail beyond optical resolution
+
+---
+
+## metaphorical phrasing
+
+> **focal.acuity** is how finely your lens can **etch the truth** onto the focal plane
+> It defines the **maximum clarity** achievable in the region of perfect focus

package/dist/logic/roles/bhrain/.briefs/physics/optics.focal.breadth.md

@@ -0,0 +1,74 @@
+# .brief: focal.breadth
+
+## what
+
+**focal.breadth** refers to the **field of view** (FoV) — the angular or spatial extent of the scene captured by the lens. It defines *how much* of the world is included in the frame, horizontally, vertically, and diagonally.
+
+The term "breadth" is used here as a conceptual synonym for FoV: a lens’s **focal.breadth** determines the spatial span visible at any moment of focus.
+
+---
+
+## why
+
+**focal.breadth** governs spatial inclusion:
+- Wide breadth = broader context, more environment, less magnification
+- Narrow breadth = tighter crop, more subject isolation, stronger compression
+
+This impacts:
+- **Composition and storytelling**
+- **Spatial relationships** (e.g. background flattening)
+- **Perceptual distance** between foreground and background elements
+
+---
+
+## governed by
+
+### 📐 Lens-to-sensor geometry
+
+\`\`\`
+focal.breadth ∝ k₁ / f
+\`\`\`
+
+Where:
+- `k₁` = `sensor_size` = physical diagonal of the camera sensor
+- `f` = `focal_length` = optical focal length of the lens
+
+> Shorter focal lengths → **wider breadth**
+> Longer focal lengths → **narrower breadth**
+
+---
+
+## key behaviors
+
+| Adjustment             | Effect on focal.breadth         |
+|------------------------|----------------------------------|
+| Decrease focal length  | expands breadth (wide angle)     |
+| Increase focal length  | narrows breadth (telephoto)      |
+| Crop sensor vs full-frame | reduces breadth (less of scene) |
+
+---
+
+## creative usage
+
+- **Wide focal.breadth** (e.g. 24mm):
+  - Landscape, architecture, immersive scenes
+  - Emphasizes environment over subject
+
+- **Narrow focal.breadth** (e.g. 85mm+):
+  - Portraits, wildlife, compressed compositions
+  - Emphasizes subject, de-emphasizes context
+
+---
+
+## limitations
+
+- Very wide breadths may introduce distortion at frame edges
+- Very narrow breadths reduce spatial awareness and require greater stability
+- Breadth must be balanced with focal.acuity and focal.depth to maintain clarity across the frame
+
+---
+
+## metaphorical phrasing
+
+> **focal.breadth** is your **window onto the world**
+> It defines *how wide the camera can see* — the lateral span of your visual attention.

package/dist/logic/roles/bhrain/.briefs/physics/optics.focal.depth.md

@@ -0,0 +1,77 @@
+# .brief: focal.depth
+
+## what
+
+**focal.depth** refers to the **range of object distances** in front of and behind the focal plane that appear **acceptably sharp**. It defines the "thickness" of the focus zone surrounding the point of perfect sharpness.
+
+---
+
+## why
+
+While **focal.acuity** describes *how sharply* the focal plane is rendered, **focal.depth** describes *how far that sharpness extends*. It's critical for:
+
+- Keeping entire subjects or scenes acceptably in focus
+- Managing viewer attention and spatial context
+- Balancing artistic isolation with technical clarity
+
+---
+
+## governed by
+
+### 📐 Depth of field (approximate)
+
+```\`\`
+focal.depth ≈ (2 * N * c * focal.distance²) / f²
+\`\```
+
+where
+- `N` = aperture (f-number)
+- `c` = circle of confusion (maximum acceptable blur)
+- `focal.distance` = subject distance (from lens to focal plane)
+- `f` = focal length, a fn of `focal.breadth`
+
+simplified
+- assume `c = d = 2.44 * λ * N`, a diffraction-limited system
+- deref `f ∝ k₁ / focal.breadth`, by definition
+
+```\`\`
+focal.depth ∝ N² × focal.distance² × focal.breadth²
+\`\```
+
+---
+
+## key behaviors
+
+| Adjustment                   | Effect on focal.depth         |
+|------------------------------|-------------------------------|
+| Smaller aperture (↑ f-number)| increases it (more in focus)  |
+| Larger aperture (↓ f-number) | decreases it (shallower zone) |
+| Farther focus distance       | increases it nonlinearly      |
+| Closer focus distance        | decreases it rapidly          |
+
+---
+
+## creative usage
+
+- **Shallow focal.depth** (e.g. f/1.4):
+  - Isolates subject from background
+  - Ideal for portraits and cinematic shots
+
+- **Deep focal.depth** (e.g. f/16):
+  - Maintains clarity across space
+  - Used in landscapes, architecture, documentation
+
+---
+
+## limitations
+
+- Increasing focal.depth via smaller apertures introduces **diffraction**, reducing **focal.acuity**
+- Getting more depth often requires stepping farther away
+- Focal.depth depends on the lens, aperture, and subject distance — not just focus point
+
+---
+
+## metaphorical phrasing
+
+> **focal.depth** is the **breadth** of your clarity
+> It defines how far sharpness can **reach** across space, extending from the focal plane outward