rhachet-roles-ehmpathy 1.0.0 → 1.1.0

package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt3.primitive.space.md

@@ -0,0 +1,85 @@
+## 📍 ecologist.brief: space
+
+> space is the physical field in which all behavior unfolds.
+> actors must position themselves to access resources, avoid threats, and reach outcomes.
+
+---
+
+### 🧱 what it is
+a **bounded environment** with constraints on reach, range, proximity, and separation
+space defines what’s nearby — and what’s out of reach
+
+---
+
+### 🧲 why it matters
+
+- **proximity enables access**
+  <<gain>>[space] (toward resource) → <<gain>>[chance] to act on it
+
+- **distance enables safety**
+  <<gain>>[space] (from threat) → <<drop>>[threat]
+
+- **limits create scarcity**
+  <<drop>>[space] → <<drop>>[chance] — crowding, enclosure, or separation can block action
+
+---
+
+### 🧭 how [space] drives actors
+
+> space defines **what’s reachable** — every gain or loss of position affects access and danger.
+> actors are driven to **optimize position**, **reduce crowding**, or **expand access**.
+
+#### valid drivers
+
+- **<<gain>>[space]** ✅
+  expands access to food, mates, cover, or escape paths
+
+- **<<drop>>[space]** ✅
+  reduces exposure or narrows territory (can be strategic or forced)
+  often used to:
+  - <<drop>>[threat]
+  - <<save>>[energy]
+
+- **<<lift>>[space]** ✅
+  increases the *value* of current position (e.g. elevation, visibility, territory quality)
+
+- **<<save>>[space]** ✅
+  preserve access to a known area or niche for future use
+  produced by:
+  - <mark> territory
+  - <cache> resources
+  - <guard> boundaries
+
+#### inapplicable
+
+- each effect is applicable
+
+---
+
+
+#### polarity flip
+
+> the same [space] may have different motive polarities, dependent on the actor's considered
+
+- predator → `<<gain>>[space]` → `<<gain>>[chance]` to hunt
+- prey → `<<drop>>[space]` → `<<drop>>[threat]` of being seen
+
+this makes [space] a **polarity-sensitive resource** — its motive value is shaped by actor perspective.
+
+
+---
+
+### 🧪 examples
+
+- **approach** watering hole from downwind
+  → <move> → <<gain>>[space] (toward resource) → <<gain>>[chance] to drink safely
+
+- **flee** to higher ground during flood
+  → <climb> → <<lift>>[space] → <<drop>>[threat]
+
+- **defend** core territory from rival
+  → <guard> → <<save>>[space] → <<gain>>[chance] to feed and mate locally
+
+- **avoid** narrow canyon when predators nearby
+  → <reroute> → <<drop>>[space] → <<drop>>[threat]
+

package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt4.primitive.claim.md

@@ -0,0 +1,113 @@
+## 🧠 ecologist.brief: claim
+
+> [claim] is a **mental resource** — a unit of belief, knowledge, or inference.
+> actors manage claims to reduce uncertainty, plan effectively, and coordinate meaning.
+
+---
+
+### 🧱 what it is
+[claim] is a **representational state** about the world or self.
+it enables reasoning, prediction, and adaptation.
+
+unlike physical resources, [claim] is **internal** — a cognitive asset that affects action.
+
+---
+
+### 🧲 why it matters
+
+- <<gain>>[claim] → <<gain>>[chance] to act wisely
+- <<drop>>[claim] → <<drop>>[threat] of being wrong
+- <<save>>[claim] → preserve useful belief or memory
+- <<lift>>[claim] → increase the utility or scope of a claim
+
+---
+
+### 🧬 types of [claim]
+
+every [claim] belongs to a **cluster** — a structural subtype that shapes its role:
+
+| cluster       | what it represents                     | example                              |
+|---------------|-----------------------------------------|--------------------------------------|
+| [lesson]      | learned regularity from experience      | “fire burns”                         |
+| [assumption]  | belief without verification             | “they probably left”                |
+| [question]    | open gap in knowledge or certainty      | “why did it break?”                 |
+| [pattern]     | reusable structure, case, or analogy    | “rain usually means earthworms”     |
+
+> 📌 [pattern] replaces [observation]
+> → emphasizes structured, reusable **case knowledge** over atomic facts
+
+---
+
+### 🧭 how [claim] drives actors
+
+- actors constantly evaluate and adjust [claim]s to:
+  - resolve ambiguity
+  - improve predictions
+  - guide coordination
+
+#### valid drivers
+
+- **<<gain>>[claim]** ✅
+  - acquire new beliefs, facts, patterns
+  - often via <observe>, <ask>, <simulate>
+
+- **<<drop>>[claim]** ✅
+  - discard false or outdated beliefs
+  - often via <revise>, <debug>, <test>
+
+- **<<save>>[claim]** ✅
+  - memorize or preserve important beliefs
+  - often via <note>, <store>, <encode>
+
+- **<<lift>>[claim]** ✅
+  - improve generality, abstraction, or power of inference
+  - e.g. turning a [pattern] into a [lesson]
+
+---
+
+### 🧪 examples
+
+- <ask> → <<gain>>[claim:pattern] → <<gain>>[chance] to choose a safe tool
+- <debug> → <<drop>>[claim:assumption] → <<drop>>[threat] of mistake
+- <note> → <<save>>[claim:lesson] → <<gain>>[chance] to reuse knowledge
+- <reflect> → <<lift>>[claim:pattern] → <<gain>>[chance] to generalize behavior
+- <simulate> → <<gain>>[claim:question] → <<gain>>[chance] to plan better
+
+---
+
+### 🧲 claim vs info
+
+| term      | what it represents                  | actor dependency |
+|-----------|--------------------------------------|------------------|
+| [info]    | raw data, objective signal           | no               |
+| [claim]   | belief or structure **held by actor** | yes              |
+
+> 📌 [claim] = **info + ownership**
+> → a system only has a [claim] if it holds, stores, or references it
+
+---
+
+### 🔁 cycles
+
+- actors often loop:
+  - <observe> → <<gain>>[claim:pattern]
+  - <test> → <<drop>>[claim:assumption]
+  - <reflect> → <<lift>>[claim:lesson]
+- these loops govern intelligence, learning, and planning
+
+---
+
+### 🧪 motive traces
+
+```text
+<observe> → <<gain>>[claim:pattern] → <<gain>>[chance]
+<debug> → <<drop>>[claim:assumption] → <<drop>>[threat]
+<note> → <<save>>[claim:lesson] → <<gain>>[chance] to reuse
+```
+
+---
+
+📚 related:
+- resource: [info]
+- concept: [chance], [pattern], [lesson]
+- brief: `motive.grammar`, `motive.horizon`

package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt5.composites.md

@@ -0,0 +1,146 @@
+## 🧬 ecologist.brief: composite resource motives
+
+> composite resources combine or emerge from primitive ones (like [time], [energy], [space], [claim])
+> they often serve as strong attractors or threats in ecosystems — shaping how actors behave over time.
+
+---
+
+### 🤝 relational resources
+> shape access to support, reproduction, or influence
+
+- **[mate]** — access to reproduction
+  <<gain>>[mate] → <<gain>>[chance] to produce [child]
+  shaped by [rank], [signal], [territory]
+
+- **[child]** — lineage continuation
+  <<save>>[child] → <<save>>[lineage]
+  core driver of nurture, protection, and provisioning behavior
+
+- **[tribe]** — social belonging or collective power
+  <<gain>>[tribe] → <<gain>>[chance] to coordinate, defend, or thrive
+  actors may also <<drop>>[tribe] to reduce [threat] (e.g., avoid infection)
+
+- **[repute]** — composite of [rank] and [esteem]; a collective belief about an actor’s value or behavior
+  <<lift>>[repute] → <<gain>>[chance] for trust, inclusion, or influence
+  actor-local [claim], environment-global [effect]
+
+  - **[rank]** — objective social position within a hierarchy
+    <<lift>>[rank] → <<gain>>[chance] to access [mate], [food], or [space]
+
+  - **[esteem]** — subjective value or admiration, internal or perceived
+    <<gain>>[esteem] → <<gain>>[chance] to act with confidence or attract allies
+
+
+- **[trust]** — confidence in another actor’s reliability or intent
+
+  trust often emerges from:
+  - <<lift>>[repute]
+  - <<save>>[claim:pattern] about actor behavior
+  - repeated <interaction> or <signal> consistency
+
+  📌 trust is a **relational affordance** —
+  a conditional [chance] based on observed history or perceived alignment
+
+  | motive           | effect                                                        |
+  |------------------|---------------------------------------------------------------|
+  | <<gain>>[trust]  | → <<gain>>[chance] to coordinate, depend, or share resources  |
+  | <<drop>>[trust]  | → <<drop>>[chance] for collaboration or mutual safety         |
+
+---
+
+### 🛠️ instrumental resources
+> enable leverage, durability, or capacity to act
+
+- **[tool]** — external object used to enhance action
+  <<gain>>[tool] → <<lift>>[efficiency] → <<save>>[energy]
+  <<gain>>[tool] → <<gain>>[option] → <<gain>>[chance]
+
+- **[shelter]** — protection from environment or predators
+  <<save>>[shelter] → <<drop>>[threat] of exposure or attack
+
+- **[signal]** — visible or audible marker of identity or intent
+  <<lift>>[signal] → <<gain>>[chance] to attract [mate] or warn [tribe]
+
+- **[territory]** — bounded [space] with defensible value
+  <<save>>[territory] → <<gain>>[chance] to access [food], [mate], or [shelter]
+
+---
+
+### 🧠 cognitive resources
+> shape future behavior through mental [claim] composites
+
+- **[value]** — internal priority assigned to an outcome, object, or state
+  <<gain>>[value] → <<gain>>[chance] to resolve tradeoffs or guide choice
+
+  [value] acts as a **weighting system** for action:
+  - clarifies which [goal]s or [claim]s matter most
+  - determines how much [energy], [time], or [risk] an actor is willing to invest
+
+  📌 [value] drives **selection** — it governs why an actor prefers one [chance] over another
+  often inferred from behavior, [signal]s, or stated [claim]s
+
+
+- **[goal]** — targeted future outcome held in mind
+  <<gain>>[goal] → <<gain>>[chance] to align effort, persist, or coordinate
+
+  a [goal] is a structured, value-laden [claim] that guides future action:
+  - [claim:pattern] → model of what's possible
+  - [value] → priority assigned
+  - [plan] → path toward realization
+
+  📌 [goal] = valued, structured claim about the future
+
+
+- **[plan]** — future-directed [claim:pattern]
+  <<gain>>[plan] → <<gain>>[chance] to achieve [goal]
+
+  [plan]s are shaped by:
+  - [value] of outcomes
+  - known [claim:pattern]s of steps
+  - expected [cost] and [chance] of execution
+
+
+#### directional motive chain
+→ **[value]** → **[goal]** → **[plan]**
+
+each builds upon the last:
+- [value] defines **what matters**
+- [goal] clarifies **what to aim for**
+- [plan] specifies **how to get there**
+
+
+---
+
+### 💰 accumulative resources
+> stores of value that extend optionality or delay decay
+
+- **[food]** — directly replenishes [energy]
+  <<gain>>[food] → <<gain>>[energy] → <<gain>>[chance] to act
+
+- **[cache]** — stored [food] or [tool]
+  <<gain>>[cache] → <<save>>[chance] in lean conditions
+
+- **[wealth]** — abstract form of accumulated leverage (esp. in humans)
+  <<gain>>[wealth] → <<gain>>[chance] via trade or [rank]
+
+---
+
+### 🔁 insight: motive hierarchy
+
+many composite resources exist **to serve** primitive needs
+e.g.
+- [tool] → saves [energy]
+- [territory] → grants [space]
+- [plan] → improves [claim]
+- [rank] → unlocks [mate], [food], [tribe]
+- [repute] → boosts [tribe], [trust]
+
+> every composite resource ultimately leads back to
+> - <<gain>>[chance]
+> - <<drop>>[threat]
+
+---
+
+📚 related:
+- brief: `ecologist.brief: time`, `space`, `energy`, `claim`
+- concept: [chance], [threat], [cycle], [motive horizon]

package/dist/logic/roles/ecologist/.briefs/distilisys/sys231.actor.claims.p1.primitive.exchange.md

@@ -0,0 +1,130 @@
+# 📘 ecologist.brief: claim exchange mechanisms
+
+> this brief defines the **fundamental ways [claim]s move between actors**.
+> every social interaction involving mental models reduces to one of three atomic mechanisms:
+> **<push>**, **<pull>**, or **<grab>**.
+
+---
+
+## 🧩 primitives
+
+these are the **irreducible operations** by which actors exchange [claim]s — the building blocks of all communication, collaboration, or persuasion.
+
+---
+
+### ➡️ <push>[claim] = <speak> & <verify>
+> the actor **offers** a [claim] to another, and checks that it landed
+- initiator: speaker
+- direction: outward
+- outcome: **transfer**
+
+🧬 **example:**
+A shopkeeper calls out,
+> “Fresh apples! Sweet and crisp!”
+
+They watch to see who hears and reacts.
+This is a **<push>** — they *offer a claim* and check if it sticks.
+
+---
+
+### ⬅️ <pull>[claim] = <probe> & <study> & <verify>
+> the actor **extracts** a [claim] from another through questioning or prompting
+- initiator: listener
+- direction: inward
+- outcome: **elicit**
+
+🧬 **example:**
+A passerby stops and asks,
+> “What’s in season today?”
+
+The shopkeeper replies with what’s best — *a new claim, drawn out by the question*.
+This is a **<pull>** — *the listener triggers the reveal*.
+
+---
+
+### 🫳 <grab>[claim] = <study> & <verify>
+> the actor **takes in** an already-offered [claim], and verifies its meaning
+- initiator: listener
+- direction: inward
+- outcome: **absorb**
+
+🧬 **example:**
+A second passerby, just walking by, hears
+> “Fresh apples!”
+
+They glance, nod, and walk over to buy — without saying a word.
+This is a **<grab>** — *they took the claim in and absorbed it*.
+
+---
+
+## 🧠 why <grab> is unique
+
+> **<grab>** exists to give the **listener** agency over unrequested signals.
+> no equivalent exists for the speaker, because **<push> already covers all speaker intent**.
+
+- speakers control the channel — they choose when to push
+- listeners don’t control the speaker — but they can choose what to **pull** or **grab**
+
+---
+
+## 🧬 summary
+
+| mechanism | who initiates | direction | description                   |
+|-----------|---------------|-----------|-------------------------------|
+| <push>    | speaker        | →         | offer + confirm delivery      |
+| <pull>    | listener       | ←         | prompt + extract + confirm    |
+| <grab>    | listener       | →         | accept offered claim + verify |
+
+these three form the **core grammar of cognitive exchange**.
+everything else — debate, teaching, bonding — is a **composite protocol** built from these.
+
+
+---
+
+
+## 🧠 more analogies
+
+---
+
+### 🎓 teacher–student
+
+- **<push>** → the teacher explains a concept:
+  > “photosynthesis is how plants convert sunlight into energy.”
+
+- **<pull>** → the student raises their hand and asks:
+  > “Why do plants need water for that?”
+
+- **<grab>** → a quiet student hears the explanation, nods, and writes it down.
+
+---
+
+### 🦅 predator–prey
+
+- **<push>** → a bird issues an alarm call:
+  > “Hawk overhead!”
+
+  It broadcasts a danger [claim] to nearby animals — that’s a **<push>**.
+
+- **<pull>** → a squirrel pauses mid-forage, then stands upright and flicks its tail.
+  This **posture is a probe** — a signal asking, *“is there danger nearby?”*
+  In response, a hawk shifts slightly on its branch.
+  The squirrel locks eyes, freezes, and darts into cover.
+  This is a **<pull>** — the squirrel *provoked* a revealing signal, *studied it*, and *verified the claim*.
+
+- **<grab>** → a rabbit hears the alarm call and bolts into cover —
+  no request, no probe, just rapid **uptake** of the offered [claim] — that’s a **<grab>**.
+
+---
+
+### 🐦 bird-of-paradise courtship
+
+- **<pull>** → a female perches nearby and performs a head-tilt + wing-flick — a ritualized probe:
+  > *"show me your fitness."*
+  The male responds with an elaborate display: feathers flared, hopping, vibrating.
+  She watches closely, then flies down — a verified [claim] exchange.
+
+- **<push>** → the male later performs his display unprompted, facing the open forest.
+  This is a **<push>** — he offers a [claim], watching for attention.
+
+- **<grab>** → another female, hidden nearby, sees the display and swoops in.
+  She didn’t signal — she simply **grabbed** the offered [claim].

package/dist/logic/roles/ecologist/.briefs/ecology/.eco001.origin.prompt.md

@@ -0,0 +1,11 @@
+```md
+outline a list of .briefs that any ecologist would need to know to do their job
+
+order in terms of importance
+```
+
+=>
+
+```md
+group them by importance and clusters
+```

package/dist/logic/roles/ecologist/.briefs/ecology/eco001.overview.md

@@ -0,0 +1,44 @@
+# ecologist.briefs.grouped
+
+## 🧠 Tier 1: core system understanding
+### cluster: ecological fundamentals
+- **ecosystem structure**
+  understand components, flows, and scales
+- **trophic dynamics**
+  who eats whom, and how energy moves
+- **population ecology**
+  how populations grow, shrink, or stabilize
+- **community interactions**
+  species affect each other’s fitness through interactions
+
+## 🔄 Tier 2: drivers of change
+### cluster: natural processes & resilience
+- **disturbance and succession**
+  how systems respond to shock and change over time
+- **biogeochemical cycles**
+  matter flows: nitrogen, carbon, phosphorus, water
+- **evolutionary ecology**
+  how traits evolve in response to ecological pressures
+
+## 🌍 Tier 3: landscapes, systems, and services
+### cluster: macro-patterns & applied meaning
+- **landscape ecology**
+  spatial patterns, fragmentation, corridors
+- **ecosystem services**
+  what nature provides humans, and how we value it
+
+## 🌡️ Tier 4: modern pressures & complexities
+### cluster: anthropogenic impact
+- **climate change ecology**
+  impacts, range shifts, feedbacks
+- **invasive species & novel ecosystems**
+  species transplants, hybrids, and human-induced ecosystems
+- **human dimensions**
+  policy, ethics, co-management, socio-ecological systems
+
+## 🧪 Tier 5: tools & methods
+### cluster: measurement & modeling
+- **field methods & monitoring**
+  how we observe and quantify ecological patterns
+- **modeling & systems thinking**
+  how we simulate, predict, and design interventions

package/dist/logic/roles/ecologist/.briefs/ecology/eco101.core-system-understanding.md

@@ -0,0 +1,70 @@
+## `.brief.eco101.core-system-understanding`
+
+### 🧠 Tier 1: core system understanding
+**cluster**: ecological fundamentals
+
+---
+
+### 🎯 goal
+equip new ecologists with the mental models to understand **how life systems function** — from parts to patterns, individuals to ecosystems.
+
+---
+
+## 🌐 ecosystem structure
+**understand components, flows, and scales**
+
+- **biotic components**: producers, consumers, decomposers
+- **abiotic components**: sunlight, soil, water, temperature, nutrients
+- **flows**: energy moves one-way (sun → heat); materials cycle (carbon, nitrogen, water)
+- **scales**: patch → landscape → biome; daily → seasonal → successional
+- **boundaries**: often conceptual (e.g., watershed, study plot)
+
+💡 ecosystems are structured by **what's in them**, how things **move**, and **where and when** they operate
+
+---
+
+## 🔗 trophic dynamics
+**who eats whom, and how energy moves**
+
+- **trophic levels**: autotroph → herbivore → carnivore → decomposer
+- **energy transfer**: ~10% efficiency per level → top predators are rare
+- **food chains** show direct links; **food webs** reveal complex interactions
+- **top-down** control: predators shape lower levels
+- **bottom-up** control: resource availability shapes entire system
+
+💡 trophic structure determines **who survives**, **who influences whom**, and **how resilient the system is**
+
+---
+
+## 📈 population ecology
+**how populations grow, shrink, or stabilize**
+
+- growth models: **exponential** (J-curve) vs. **logistic** (S-curve)
+- **carrying capacity (K)** = max sustainable population
+- **density dependence**: as density increases, resources become limiting
+- dynamics driven by: births, deaths, immigration, emigration
+- tools: **life tables**, **survivorship curves**, **growth rates**
+
+💡 population trends reveal how species **respond to limits**, **recover**, or **collapse**
+
+---
+
+## 🧬 community interactions
+**species affect each other’s fitness through interactions**
+
+- interaction types:
+  - **competition (–/–)**
+  - **predation (+/–)**
+  - **mutualism (+/+)**
+  - **parasitism (+/–)**
+  - **commensalism (+/0)**
+- **keystone species**: have disproportionate effects on structure
+- **niche partitioning**: species avoid direct conflict by specializing
+- **succession**: communities evolve over time, from colonization to climax
+
+💡 communities are shaped by a **web of effects**, where gains and losses ripple across species and time
+
+---
+
+### 🔁 mental model
+> life systems are **interdependent networks of flow, feedback, and interaction** — understanding them requires seeing not just parts, but **how parts connect, scale, and change**.

package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p1.ecosystem-structure.md

@@ -0,0 +1,62 @@
+## `.brief.eco101.ecosystem-structure`
+
+### 🧠 topic: ecosystem structure
+
+---
+
+### 🎯 goal
+understand what ecosystems are made of, how materials and energy move through them, and how they’re framed in space and time.
+
+---
+
+### 🧩 components of an ecosystem
+
+#### **biotic (living)**
+- **producers** – organisms that convert energy (usually sunlight) into biomass (e.g., plants, algae)
+- **consumers** – organisms that eat other organisms (herbivores, carnivores, omnivores)
+- **decomposers** – organisms that break down dead matter, recycling nutrients (fungi, bacteria, detritivores)
+
+#### **abiotic (non-living)**
+- sunlight, temperature, water, soil, air, nutrients — the physical environment that shapes and limits biological processes
+
+---
+
+### 🔄 flows in an ecosystem
+
+#### **energy flow**
+- one-way: sun → producers → consumers → decomposers → heat
+- governed by inefficiencies: only ~10% of energy moves up each trophic level
+
+#### **material cycling**
+- closed loop: atoms (carbon, nitrogen, water, phosphorus) cycle between biotic and abiotic compartments
+- driven by biological activity, decomposition, and physical processes
+
+---
+
+### 🗺 scales of analysis
+
+#### **spatial scales**
+- **patch** – a small habitat unit (e.g., a pond, a tree)
+- **landscape** – a collection of interacting patches
+- **biome** – large ecological region shaped by climate (e.g., desert, tundra)
+
+#### **temporal scales**
+- **daily** – diurnal patterns (e.g., photosynthesis, foraging)
+- **seasonal** – migration, hibernation, breeding cycles
+- **successional** – long-term shifts in community structure over years or decades
+
+---
+
+### 🧱 system boundaries
+
+- not always visible or fixed
+- may be defined by:
+  - topography (e.g., a watershed)
+  - biological activity (e.g., range of keystone species)
+  - research goals (e.g., plot size in a field study)
+- important for clarifying inputs, outputs, and interactions
+
+---
+
+### 🔁 mental model
+> an ecosystem is **a dynamic mesh of living and non-living parts**, stitched together by **energy flow** and **material cycles**, and understood across **space and time**.