rhachet-roles-ehmpathy 1.0.0 → 1.2.0

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

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`