rhachet-roles-ehmpathy 1.0.0 → 1.2.0

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**.

package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p2.trophic-dynamics.md

@@ -0,0 +1,59 @@
+## `.brief.eco101.trophic-dynamics`
+
+### 🧠 topic: trophic dynamics
+
+---
+
+### 🎯 goal
+understand how energy moves through ecosystems by examining who eats whom, how much energy transfers, and what happens when the balance shifts.
+
+---
+
+### 🧭 trophic levels
+
+- **autotrophs (producers)** – organisms that create energy-rich compounds from sunlight or chemicals (e.g., plants, algae)
+- **herbivores (primary consumers)** – eat autotrophs (e.g., deer, insects)
+- **carnivores (secondary+ consumers)** – eat other consumers (e.g., wolves, hawks)
+- **decomposers** – break down dead organisms and recycle nutrients (e.g., fungi, bacteria)
+
+🔄 energy flows **up**, nutrients **cycle**
+
+---
+
+### ⚡ energy transfer efficiency
+
+- only ~**10%** of energy is passed to the next trophic level
+- ~**90%** is lost as heat, movement, metabolism, or undigested material
+- explains why:
+  - food chains rarely extend beyond 4–5 levels
+  - top predators are few in number and require large territories
+
+---
+
+### 🔗 food chains vs. food webs
+
+#### **food chain**
+- a **linear** sequence of who eats whom
+  example: grass → grasshopper → frog → snake → hawk
+
+#### **food web**
+- a **network** of interconnected food chains
+- reflects real-world complexity
+- shows redundancy, indirect effects, and resilience potential
+
+---
+
+### 🔄 top-down vs. bottom-up control
+
+#### **top-down (predator-driven)**
+- predators suppress herbivores, allowing plant populations to grow
+  example: adding wolves to Yellowstone → fewer deer → more willow trees
+
+#### **bottom-up (resource-driven)**
+- changes in resource availability (e.g., nutrients, water) affect producers, which cascade upward
+  example: nutrient-poor soil → fewer plants → fewer herbivores → fewer predators
+
+---
+
+### 🔁 mental model
+> trophic dynamics describe the **flow of energy and influence** in an ecosystem — like a supply chain where **efficiency is low** and **imbalances ripple** in either direction.

package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p3.population-ecology.md

@@ -0,0 +1,71 @@
+## `.brief.eco101.population-ecology`
+
+### 🧠 topic: population ecology
+
+---
+
+### 🎯 goal
+learn how populations grow, shrink, and stabilize — and what forces shape their numbers over time.
+
+---
+
+### 📈 population growth models
+
+#### **exponential growth**
+- occurs when resources are unlimited
+- population grows at a constant rate
+- **J-shaped curve**
+- equation: `dN/dt = rN`
+  where `r` = intrinsic rate of increase, `N` = population size
+
+#### **logistic growth**
+- growth slows as resources become limited
+- approaches a maximum size: **carrying capacity (K)**
+- **S-shaped curve**
+- equation: `dN/dt = rN(1 - N/K)`
+
+---
+
+### 🏞 carrying capacity & density dependence
+
+#### **carrying capacity (K)**
+- the max population size an environment can sustain over time
+- shaped by resource availability, habitat space, and ecosystem limits
+
+#### **density-dependent factors**
+- effects that increase with population size
+  e.g., disease, competition, predation, stress
+
+#### **density-independent factors**
+- effects unrelated to population size
+  e.g., weather events, natural disasters, pollution
+
+---
+
+### 🧮 population change drivers
+
+- **births (B)** – increase population
+- **deaths (D)** – decrease population
+- **immigration (I)** – individuals entering the population
+- **emigration (E)** – individuals leaving the population
+
+📊 total change: `ΔN = (B + I) - (D + E)`
+
+---
+
+### 📊 life tables & survivorship curves
+
+#### **life tables**
+- track survival and reproduction across age classes
+- used to calculate life expectancy, mortality rates, and reproduction output
+
+#### **survivorship curves**
+- graph survival probability over lifespan
+  - **Type I**: low early mortality (e.g., humans)
+  - **Type II**: constant mortality (e.g., birds)
+  - **Type III**: high early mortality (e.g., fish, plants)
+
+---
+
+### 🔁 mental model
+> population ecology reveals how a species’ **numbers respond to internal feedbacks and external forces** — shaped by **births, deaths, limits, and movement** over time.

package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p4.community-interactions.md

@@ -0,0 +1,78 @@
+## `.brief.eco101.community-interactions`
+
+### 🧠 topic: community interactions
+
+---
+
+### 🎯 goal
+understand how species interact, compete, and cooperate — and how these relationships shape the structure and function of ecological communities.
+
+---
+
+### 🔗 interaction types
+
+#### **competition (– / –)**
+- both species are harmed by shared resource use
+  e.g., two plants competing for sunlight
+
+#### **predation (+ / –)**
+- one species benefits by consuming another
+  e.g., wolf hunting deer
+
+#### **mutualism (+ / +)**
+- both species benefit
+  e.g., bees pollinate flowers while collecting nectar
+
+#### **parasitism (+ / –)**
+- one species benefits by exploiting another
+  e.g., tapeworm in a mammal’s intestine
+
+#### **commensalism (+ / 0)**
+- one species benefits, the other is unaffected
+  e.g., barnacles on a whale
+
+---
+
+### 📈 impact on fitness & composition
+
+- interactions affect **reproductive success**, survival, and access to resources
+- over time, these interactions shape:
+  - **who thrives or disappears**
+  - **which species coexist**
+  - **what niches get filled**
+
+---
+
+### 🧩 keystone species & niche partitioning
+
+#### **keystone species**
+- has a **disproportionate impact** on community structure
+- removing it can collapse food webs or shift ecosystems
+  e.g., sea otters controlling sea urchins, preserving kelp forests
+
+#### **niche partitioning**
+- species avoid direct competition by **dividing resources**
+  - by time (e.g., day vs. night feeders)
+  - by space (e.g., canopy vs. ground dwellers)
+  - by food type (e.g., seeds vs. insects)
+
+---
+
+### 🌱 succession: community change over time
+
+#### **primary succession**
+- starts from bare substrate (e.g., lava flow, glacier retreat)
+- slow buildup of soil and life from scratch
+
+#### **secondary succession**
+- recovery after disturbance (e.g., fire, flood, logging)
+- faster, since soil and seed banks may remain
+
+#### **climax community**
+- stable endpoint (in theory)
+- actual systems often remain dynamic due to ongoing disturbance
+
+---
+
+### 🔁 mental model
+> communities are **living tapestries woven by interaction** — shaped by who competes, who cooperates, and how species carve out niches, respond to change, and shape each other over time.