rhachet-roles-ehmpathy 1.13.0 → 1.13.2

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

@@ -1,101 +0,0 @@
-## 🧭 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

@@ -1,131 +0,0 @@
-## 🧭 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

@@ -1,108 +0,0 @@
-## 🌐 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

@@ -1,56 +0,0 @@
-## ⏳ 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

@@ -1,69 +0,0 @@
-## ⚡ 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

@@ -1,85 +0,0 @@
-## 📍 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

@@ -1,113 +0,0 @@
-## 🧠 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`