rhachet-roles-ehmpathy 1.0.0 → 1.1.0

package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive.p2.option.chance.choice.md

@@ -0,0 +1,140 @@
+## 🧭 ecologist.brief: option vs chance vs choice
+
+> these three terms describe how actors relate to possible paths.
+> each plays a distinct role in motive grammar:
+> - **option** defines availability
+> - **chance** adds motive
+> - **choice** commits to action
+
+---
+
+### 🛣️ option
+a path the actor *could* take
+neutral — no preference, pressure, or motive required
+
+---
+
+### 🎯 chance
+a path the actor is *driven* to take
+an option made salient by motive — not yet taken, but charged with relevance
+
+→ `chance = option × motive`
+
+*note: [chance] is a synonym for [opportunity]*
+
+---
+
+### 🗳️ choice
+a path the actor *commits* to take
+it turns potential into action
+
+→ `choice = chance × decision`
+
+#### ⌛ reversibility and entropy
+
+- **reversible choices** preserve optionality
+  → paths remain open; entropy stays low
+  _ex: briefly probing a foraging site_
+
+- **irreversible choices** consume or foreclose options
+  → future paths collapse; entropy rises
+  _ex: attacking a predator, migrating, mating_
+
+> reversibility measures how much **future agency** is preserved
+> irreversible choices accelerate **entropic decay**
+> reversibility is how actors **buffer against commitment risk**
+
+---
+
+### 🔁 progression
+
+\`\`\`md
+option
+  ↓ × motive
+chance
+  ↓ × decision
+choice
+\`\`\`
+
+---
+
+### 🔁 pattern
+
+- **option** = could
+- **chance** = should
+- **choice** = will
+
+---
+
+### 🧪 summary
+
+| term   | definition                      | identity          |
+|--------|---------------------------------|-------------------|
+| option | a possible path                 | —                 |
+| chance | a motivated option              | option × motive   |
+| choice | a committed path                | chance × decision |
+
+---
+
+## 🧪 examples: option vs chance vs choice
+
+---
+
+### 1. 🐦 bird sees two berry bushes
+
+- **option**:
+  - [option.1] = bush.1 with 5 berries
+  - [option.2] = bush.2 with 3–10 berries (uncertain yield)
+
+- **chance**:
+  - [chance.1] = <<gain>>[berries] ×5 → <<gain>>[energy], <<gain>>[nutrients]
+  - [chance.2] = <<gain>>[berries] ×3–10 → same drivers, higher upside
+
+- **choice**:
+  commits to [chance.2] — starts with bush.2
+  - reasoning: higher yield may meet need in one stop
+  - fallback remains if yield is low
+
+- ⌛ **reversibility**:
+  - initially reversible (can switch bushes)
+  - becomes irreversible once berries are consumed → entropy ↑
+
+---
+
+### 2. 🧑 human choosing a job offer
+
+- **option**:
+  - [option.1] = local company (stable, low growth)
+  - [option.2] = startup (high risk, high upside)
+
+- **chance**:
+  - [chance.1] = <<gain>>[income], <<drop>>[risk]
+  - [chance.2] = <<gain>>[equity], <<lift>>[future potential], <<gain>>[experience]
+
+- **choice**:
+  commits to [chance.2] — accepts startup offer
+  - reasoning: aligns with ambition and growth motive
+
+- ⌛ **reversibility**:
+  - partially reversible (can leave job), but
+  - opportunity cost and sunk effort accumulate → entropy ↑
+
+---
+
+### 3. 🐘 elephant approaches waterholes
+
+- **option**:
+  - [option.1] = nearby, crowded waterhole
+  - [option.2] = distant, quieter waterhole
+
+- **chance**:
+  - [chance.1] = <<gain>>[water] quickly, but risk <<drop>>[access]
+  - [chance.2] = <<gain>>[water], <<lift>>[safety], <<drop>>[conflict], at cost of <<drop>>[time]
+
+- **choice**:
+  commits to [chance.2] — takes the distant route
+  - reasoning: safer, more reliable, fewer competitors
+
+- ⌛ **reversibility**:
+  - mostly irreversible — once underway, less useful to retreat
+  - travel cost and risk compound → entropy ↑

package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive.p3.chance.motive.polarity.threat.md

@@ -0,0 +1,72 @@
+## 🧭 ecologist.brief: motive polarity
+
+> all behavior is driven by motive — but not all motive attracts.
+> motive can pull actors toward outcomes (**incentives**) or push them away (**decentives**).
+> this polarity applies to [chance] — possible futures with motivational force.
+
+---
+
+### 🧲 incentive
+a **positive motive** — pulls the actor toward a future
+→ drives **approach behavior**
+
+- examples:
+  - food → <<gain>>[energy]
+  - mate → <<gain>>[reproductive chance]
+  - shelter → <<drop>>[exposure]
+
+---
+
+### 🧲 decentive _(preferred term)_
+a **negative motive** — pushes the actor away from a future
+→ drives **avoidance behavior**
+
+> 📌 a decentive is still a motive — not its absence
+> it creates urgency, direction, and action — just in reverse
+
+- examples:
+  - predator → <<drop>>[life], <<drop>>[agency]
+  - fire → <<drop>>[resource]
+  - toxin → <<drop>>[health]
+
+---
+
+### ⚖️ polarity applied to [chance]
+
+> **[chance] = [option] × motive**
+> polarity determines whether the actor is driven *toward* or *away*
+
+---
+
+#### ⚠️ [threat]
+a **negatively motivated [chance]** — a possible future the actor is driven to avoid
+
+→ `threat = chance.motive = {-decentive}`
+
+- a threat is still a [chance] — it might happen
+- what distinguishes it is that the actor wants to avoid it; a **push-away** motive polarity
+
+this includes:
+- **[risk]** — the [chance].probability of this [threat]
+- **[pain]** — the [chance].outcome of this [threat]
+
+> 📌 [risk] and [pain] are specific to [threat]s,
+> but their structure — `chance.probability` and `chance.outcome` — applies to all [chance]s
+
+---
+
+### 🧪 summary
+
+| concept      | what it is                         | motive polarity  | behavior it drives   |
+|--------------|------------------------------------|------------------|----------------------|
+| [chance]     | possible outcome with motive       | + or –           | approach or avoid    |
+| [threat]     | chance with decentive motive       | –                | avoidance            |
+| [magnet]     | chance with incentive motive       | +                | approach             |
+| incentive    | motive that attracts               | +                | approach             |
+| decentive    | motive that repels                 | –                | avoidance            |
+
+---
+
+📌 prefer **decentive** over *disincentive*
+→ it is morphologically parallel to *incentive*
+→ and fits cleanly into the grammar of [chance].motive

package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive.p4.motive.horizon.md

@@ -0,0 +1,101 @@
+## 🧭 ecologist.brief: motive horizon - why [chance] and [threat] govern behavior
+
+why [chance] and [threat] govern behavior
+
+> at the root of all behavior is the drive to manage possible futures.
+> every action serves one of two ends:
+> - **<<gain>>[chance]** — expand potential
+> - **<<drop>>[threat]** — reduce danger
+
+---
+
+### 🧲 motive gravity
+
+all other resource motives (e.g. time, energy, safety) ultimately trace back to their impact on:
+
+- how many **[chance]s** an actor can unlock
+- how many **[threat]s** an actor must avoid
+
+these two shape the actor’s **motive horizon** — the effective space of action and survival.
+
+---
+
+### 🧪 motive forms
+
+\`\`\`text
+[chance] = [option] × motive
+[threat] = [chance].motive = {-decentive}
+\`\`\`
+
+therefore:
+
+- **<<gain>>[chance]** = increase attractive futures
+- **<<drop>>[threat]** = eliminate repulsive futures
+
+
+---
+
+### 📚 references
+
+this framework aligns with several observations in ai and decision theory research:
+
+- **universal intelligence** (leg & hutter, 2007)
+  → intelligence = ability to achieve goals across environments
+  → aligns with maximizing available [chance]
+
+- **empowerment theory** (klyubin et al., 2005)
+  → agents act to maximize future optionality
+  → maps to <<save>>[chance] and reduce entropic collapse
+
+- **free energy principle** (friston, 2010)
+  → agents minimize surprise (i.e., unpredicted [threat]s)
+
+- **economic utility theory**
+  → value comes from expanding possible actions and reducing negative consequences
+
+---
+
+### 🧪 distilled law
+
+> **intelligence seeks to maximize [chance] and minimize [threat]**
+> all other motives are support systems for this horizon
+
+---
+
+### 🧱 resources vs motive
+
+resources like [time], [energy], [space], [status], etc.
+are **not motives themselves** — they are tools actors manage to shift their exposure to [chance] or [threat].
+
+> 📌 every action affecting a resource only matters **insofar as** it:
+> - enables **<<gain>>[chance]**, or
+> - enables **<<drop>>[threat]**
+
+---
+
+### 🧪 examples
+
+- <<save>>[time] → <<gain>>[chance] to act again
+- <<gain>>[energy] → unlocks future options
+- <<drop>>[delay] → avoids missed opportunities
+- <<lift>>[visibility] → avoids surprise attack → <<drop>>[threat]
+- <<gain>>[status] → attracts mates → <<gain>>[chance] for reproduction
+
+---
+
+### 🔁 resource → motive chain
+
+\`\`\`text
+<mechanism> → <<effect>>[resource] → <<gain>>[chance]
+<mechanism> → <<effect>>[resource] → <<drop>>[threat]
+\`\`\`
+
+intermediate effects serve as **levers** toward the actor's ultimate drive:
+maximize opportunity, minimize harm.
+
+---
+
+📌 motive grammar simplifies:
+- **what actors care about** → [chance], [threat]
+- **why resources matter** → as levers
+- **how behavior is structured** → as resource-driven motive traces

package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive.p5.motive.grammar.md

@@ -0,0 +1,131 @@
+## 🧭 ecologist.brief: motive grammar
+
+> defines the structural **syntax of behavior** — how actors transform pressure into action.
+> motive grammar describes how decisions flow through `[resources]`, `<mechanisms>`, and `{drivers}`,
+> forms the **behavioral layer** of `distilisys:grammar`, where system motion becomes legible through cause-effect chains.
+
+---
+
+### 🧬 integration with `distilisys:grammar`
+
+in distilisys, systems are defined by:
+
+- `[resource]` — the things that exist or change
+- `<mechanism>` — the actions taken
+- `{driver}` — the pressure behind the action
+
+**motive grammar** extends this structure to include outcome force:
+
+\`\`\`text
+<mechanism> → <<effect>>[resource] → <<gain>>[chance]
+<mechanism> → <<effect>>[resource] → <<drop>>[threat]
+\`\`\`
+
+this connects **system shape** to **actor behavior** — showing *why* actions occur.
+
+---
+
+### 🔤 syntax reference
+
+| unit           | role in system                           | allowed values / structure                            | examples                                            |
+|----------------|------------------------------------------|-------------------------------------------------------|-----------------------------------------------------|
+| `[resource]`   | constraint or currency                   | any observable noun or state                          | [time], [energy], [status], [space]                 |
+| `<mechanism>`  | atomic action or procedure               | any atomic verb or transformation                     | <rest>, <signal>, <run>, <cache>                    |
+| `<<effect>>`   | motive impact on a resource              | one of `<<gain>>`, `<<drop>>`, `<<save>>`, `<<lift>>` | <<gain>>[chance], <<drop>>[risk]                    |
+| `{driver}`     | pressure or motive signal                | one of four canonical forms *(see below)*             | {+incentive:<<save>>[time]}, {-headwind:[friction]} |
+
+---
+
+### 📌 valid `{driver}` forms
+
+drivers express what creates motive pressure. only **four** canonical forms exist:
+
+| form              | meaning                                 | example                                      |
+|-------------------|------------------------------------------|----------------------------------------------|
+| `{+incentive}`    | actor is pulled toward a [chance]        | `[actor]{+incentive:<<save>>[time]}`         |
+| `{-decentive}`    | actor is pushed away from a [threat]     | `[actor]{-decentive:<<drop>>[health]}`       |
+| `{+tailwind}`     | environment supports action              | `[season]{+tailwind:<<gain>>[customers]}`    |
+| `{-headwind}`     | environment resists action               | `[policy]{-headwind:<<gain>>[growth]}`       |
+
+> 📌 every `{driver}` may reference a `<<effect>>[resource]` to make its motive force explicit.
+
+---
+
+### 🔁 behavioral flow
+
+\`\`\`text
+<mechanism>
+  ↓
+<<effect>>[resource]
+  ↓
+<<gain>>[chance]     → approach behavior
+<<drop>>[threat]     → avoidance behavior
+\`\`\`
+
+motive grammar turns static systems into dynamic agents with reasons.
+
+---
+
+### 🧲 core principle
+
+> every [resource] only matters insofar as it helps:
+> - **<<gain>>[chance]** — unlock more possible futures
+> - **<<drop>>[threat]** — reduce danger or entropy
+
+---
+
+### 🧪 examples
+
+| motive trace | explanation |
+|-------------------------------------------------------------------------------------------|-------------------------|
+| <run> → <<drop>>[delay] → <<save>>[time] → <<gain>>[chance] to escape                     | actor runs to survive   |
+| <rest> → <<gain>>[energy] → <<gain>>[chance] to act later                                 | actor recovers agency   |
+| <hide> → <<drop>>[visibility] → <<drop>>[threat]                                          | actor evades detection  |
+| <signal> → <<lift>>[status] → <<gain>>[chance] to attract mates                           | actor self-promotes     |
+| <skipFight> → <<drop>>[waste] → <<save>>[energy] → <<gain>>[chance] to survive lean times | actor avoids drain      |
+
+---
+
+### ✅ usage in system distillation
+
+- embed motive traces directly in distilisys chains
+- tag `<mechanism>`s with their downstream motive
+- make **actor pressure** legible alongside structural flow
+
+---
+
+### 📌 motive grammar compresses behavior into a compact syntax:
+
+- **what it changes** → `[resource]`
+- **how it changes** → `<mechanism>`
+- **why it matters** → `<<effect>>`
+- **why it happens** → `{driver}`
+- **what it leads to** → `[chance]` or `[threat]`
+
+
+### 📌 recommendations
+
+- use `<<effect>>[resource]` to describe **why** a step matters
+- trace every behavior to ultimately either:
+  - **<<gain>>[chance]**
+  - **<<drop>>[threat]**
+- treat `[chance]` and `[threat]` as root-level outcomes — everything else serves them
+
+---
+
+### 🧪 summary
+
+| layer         | what it declares              |
+|---------------|-------------------------------|
+| `[resource]`  | what exists or is constrained |
+| `<mechanism>` | what acts on it               |
+| `<<effect>>`  | what impact results           |
+| `{driver}`    | what pressure causes action   |
+
+---
+
+📚 related:
+- brief: `ecologist.brief: motive horizon`
+- tactic: `lang:distilisys`
+- concept: `ubiqlang`, `motive polarity`, `resource grammar`
+

package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources._.primitives.summary.md

@@ -0,0 +1,108 @@
+## 🌐 ecologist.brief: primitive resources (summary)
+
+> distills the four core resource classes — [time], [energy], [space], and [claim] — into their motive roles.
+> each shapes what’s possible, costly, or knowable for actors in a system.
+
+---
+
+### ⏳ [time]
+
+**what it is**:
+a fixed-duration window in which action can occur.
+cannot be paused, stored, or regained.
+
+**why it matters**:
+- <<save>>[time] → <<gain>>[chance] for future action
+- <delay> → <<drop>>[chance] as windows close
+
+**valid effects**:
+- ✅ <<save>>[time] — preserve agency and optionality
+- ❌ <<gain>> / <<lift>> / <<drop>> — time is immutable
+
+**example**:
+<abandon> slow task → <<drop>>[waste] → <<save>>[time] → <<gain>>[chance] to redirect effort
+
+---
+
+### ⚡ [energy]
+
+**what it is**:
+a spendable capacity for work. fuels all action.
+finite, depletable, replenishable.
+
+**why it matters**:
+- <<gain>>[energy] → <<gain>>[chance] to act
+- <<save>>[energy] → extends future agency
+- <<drop>>[energy] → <<drop>>[chance] to continue behavior
+
+**valid effects**:
+- ✅ <<gain>>, <<save>>
+- ❌ <<lift>> (no quality), <<drop>> (only as consequence, not goal)
+
+**example**:
+<skipFight> → <<drop>>[waste] → <<save>>[energy] → <<gain>>[chance] to survive
+
+---
+
+### 📍 [space]
+
+**what it is**:
+a bounded field of physical access — defines proximity, reach, and exposure.
+
+**why it matters**:
+- <<gain>>[space] → toward resource → <<gain>>[chance]
+- <<gain>>[space] → from threat → <<drop>>[threat]
+- <<drop>>[space] → <<drop>>[chance] or create safety
+
+**valid effects**:
+- ✅ <<gain>>, <<drop>>, <<save>>, <<lift>> — all apply
+
+**polarity flip**:
+motive depends on perspective:
+- predator: `<<gain>>[space]` → `<<gain>>[chance]` to hunt
+- prey: `<<drop>>[space]` → `<<drop>>[threat]` of detection
+
+**example**:
+<climb> → <<lift>>[space] → <<drop>>[threat] during flood
+
+---
+
+### 🧠 [claim]
+
+**what it is**:
+an internal representational belief held by an actor.
+enables reasoning, learning, and coordination.
+
+**why it matters**:
+- <<gain>>[claim] → <<gain>>[chance] to act wisely
+- <<drop>>[claim] → <<drop>>[threat] of error
+- <<lift>>[claim] → increase generality and reuse
+
+**subtypes**:
+| cluster       | role                               |
+|---------------|------------------------------------|
+| [lesson]      | learned rule from experience       |
+| [assumption]  | unverified belief                  |
+| [question]    | gap in knowledge                   |
+| [pattern]     | reusable structure or analogy      |
+
+**valid effects**:
+- ✅ <<gain>>, <<drop>>, <<save>>, <<lift>> — all apply
+
+**example**:
+<debug> → <<drop>>[claim:assumption] → <<drop>>[threat] of failure
+
+---
+
+📌 summary
+
+| resource | core effect         | key motive paths                                  |
+|----------|---------------------|---------------------------------------------------|
+| [time]   | <<save>>            | preserve windows of opportunity                   |
+| [energy] | <<gain>>, <<save>>  | enable and extend action                          |
+| [space]  | all 4 effects       | control access, exposure, and position            |
+| [claim]  | all 4 effects       | shape beliefs to improve reasoning and response   |
+
+📚 related:
+- brief: `motive.grammar`, `motive.horizon`
+- concept: [chance], [threat], [pattern]

package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt1.primitive.time.md

@@ -0,0 +1,56 @@
+## ⏳ ecologist.brief: time
+
+> time is a fundamental constraint — finite, irreversible, and always flowing.
+> actors cannot gain time, only use it better. motive systems evolve to save time wherever possible.
+
+---
+
+### 🧱 what it is
+a **fixed-duration window** in which things can happen
+time cannot be paused, stored, or extended
+
+---
+
+### 🧲 why it matters
+
+- **delay creates decay**
+  <delay> → <<drop>>[chance] — chances degrade over time or close altogether
+
+- **more time, more chances**
+  <<save>>[time] → <<gain>>[chance] — each unit preserved unlocks another shot
+
+---
+
+### 🧭 how [time] drives actors
+
+> time can’t be controlled — only responded to.
+> its scarcity drives actors to **produce <<save>>[time]** to preserve agency and unlock more chances.
+
+#### valid driver
+
+- **<<save>>[time]** ✅
+  actors save time by:
+  - <<drop>>[delay] — remove lag between intent and outcome
+  - <<lift>>[speed] — accelerate actions
+  - <<drop>>[waste] — cut effort with poor time return
+
+#### invalid or inapplicable
+
+- **<<gain>>[time]** ❌
+  impossible — time cannot be created or recovered
+
+- **<<lift>>[time]**, **<<drop>>[time]** ❌
+  inapplicable — time has no quality to enhance or remove
+
+---
+
+### 🧪 examples
+
+- **choose** faster routes to reach food before dark
+  → <<drop>>[delay] → <<save>>[time] → <<gain>>[chance] to feed safely
+
+- **reproduce** early to increase generational spread
+  → <<drop>>[delay] → <<save>>[time] → <<gain>>[chance] for more offspring
+
+- **abandon** tasks that take too long to complete
+  → <<drop>>[waste] → <<save>>[time] → <<gain>>[chance] to redirect effort

package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt2.primitive.energy.md

@@ -0,0 +1,69 @@
+## ⚡ ecologist.brief: energy
+
+> energy is the fuel of action — finite, spendable, and required for every move.
+> actors must manage it carefully: too little, and no chance can be taken.
+
+---
+
+### 🧱 what it is
+a **spendable capacity** for doing work
+every action costs energy; nothing happens without it
+
+---
+
+### 🧲 why it matters
+
+- **energy gates action**
+  <<gain>>[energy] → <<gain>>[chance] — no energy, no opportunity to act
+
+- **depletion risks collapse**
+  <<drop>>[energy] → <<drop>>[chance] — actors become unable to move, flee, feed, or choose
+
+- **efficiency extends agency**
+  <<save>>[energy] → <<gain>>[chance] — preserved energy allows future actions
+
+---
+
+### 🧭 how [energy] drives actors
+
+> energy is always draining — every step, signal, or struggle consumes it.
+> actors are driven to **spend it well**, **save it when possible**, and **replenish it regularly**.
+
+#### valid drivers
+
+- **<<save>>[energy]** ✅
+  increases longevity, optionality, and future flexibility
+  produced by:
+  - <<drop>>[waste] — stop actions with poor return
+  - <<lift>>[efficiency] — reduce energy required per action
+  - <<drop>>[friction] — minimize resistance, drag, or opposition
+
+- **<<gain>>[energy]** ✅
+  actors must actively recover energy through rest or intake
+  - <consume>[food]
+  - <store>[fat]
+  - <rest> to regenerate
+
+#### inapplicable
+
+- **<<lift>>[energy]** ❌
+  energy has no qualitative height — only quantity and availability
+
+- **<<drop>>[energy]** ❌
+  dropping energy unintentionally is just waste — not a deliberate motive
+
+---
+
+### 🧪 examples
+
+- **hunt** prey at dusk despite fatigue
+  → <spend>[energy] → <<gain>>[chance] to feed before dark
+
+- **choose** shaded paths while migrating
+  → <<drop>>[friction] → <<save>>[energy] → <<gain>>[chance] to reach destination
+
+- **skip** unnecessary fights with rivals
+  → <<drop>>[waste] → <<save>>[energy] → <<gain>>[chance] to survive leaner periods
+
+- **eat** high-fat foods before winter
+  → <consume>[food] → <<gain>>[energy] → <<gain>>[chance] to endure scarcity