rhachet-roles-ehmpathy 1.1.0 → 1.3.0

package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.2.1.primitives.rough.interrogative.md

@@ -0,0 +1,108 @@
+# ❓ .brief: `interrogative.primitives`
+
+## .what
+
+**interrogative primitives** are the **universal, semantic building blocks**
+that underlie all question forms across human languages.
+
+They serve as the **deep structure** of inquiry —
+basic cognitive intents like *"what is it?"*, *"who did it?"*, or *"I want to know"*,
+which are **expressed in different surface forms** depending on the language or system.
+
+In structured reasoning systems (like `cortal.focus`), interrogative primitives
+are also used as **motion triggers** — initiating semantic traversal
+across specific focus axes (e.g. breadth, depth, acuity).
+
+---
+
+## 🌐 linguistic foundation
+
+This concept draws from **Natural Semantic Metalanguage (NSM)** theory,
+which identifies **semantic primes** — universal concepts
+that exist in all languages and are irreducible.
+
+| theory term        | role in questioning                                      |
+|--------------------|----------------------------------------------------------|
+| **semantic prime** | the irreducible core meaning (e.g. *"something?"*)        |
+| **interrogative primitive** | universal questioning intent (e.g. *"I want to know X"*) |
+| **deep structure** | the underlying conceptual frame of the question           |
+| **surface structure** | the language-specific form used to express it           |
+
+> ✨ Despite variation in syntax, **all languages ask the same kinds of questions**
+> — using different tools to express the same deep conceptual needs.
+
+---
+
+## 🧩 catalog of interrogative primitives
+
+| primitive     | intent                        | NSM gloss             | maps to motion along...                    |
+|---------------|-------------------------------|------------------------|---------------------------------------------|
+| `what`        | identity, content, definition | “something?”           | `acuity.attributes++`, `depth.instantiate`  |
+| `why`         | cause, reason                 | “because...”           | `breadth.causal++`, `depth.abstract++`      |
+| `how`         | method, mechanism             | “in what way?”         | `acuity.substructs++`, `breadth.functional++` |
+| `when`        | time, stage                   | “at what time?”        | `breadth.temporal++`                        |
+| `where`       | space, location               | “in what place?”       | `breadth.spatial++`                         |
+| `who`         | agent, subject                | “someone?”             | `breadth.subjective++`                      |
+| `which`       | selection, contrast           | “which one?”           | `breadth.categorical++`, `acuity++`         |
+| `what if`     | possibility, variation        | “maybe something?”     | `breadth.categorical++` + `depth.instantiate` |
+| `what’s next` | temporal progression          | “then what?”           | `breadth.temporal++` + `depth.instantiate`  |
+
+> 🧠 these are not just English words — they reflect **core cognitive forms**
+> that show up in every language’s deep semantic structure.
+
+---
+
+## 🔄 interrogatives as motion triggers
+
+In the `cortal.focus` system, each interrogative primitive
+can be interpreted as a **semantic motion vector** —
+a directive to shift focus along a particular axis of thought.
+
+> e.g.
+> “why?” → generalize causally
+> “how?” → decompose structurally
+> “what?” → articulate traits or instantiate
+
+---
+
+## 🧬 precision and composition
+
+Primitive questions are often **rough** — initiating motion but underspecified.
+They can be **refined** or **composed** into **smoother** asks
+that encode more direction and scope.
+
+| progression example |
+|---------------------|
+| “why?” → “why did it happen?” → “what underlying mechanism caused it to shift at time X?” |
+
+> 📈 Smoother questions = tighter alignment to the answer space
+
+---
+
+## 🌍 language diversity, semantic unity
+
+| language    | "what"   | "who"     | "where"   |
+|-------------|----------|-----------|-----------|
+| English     | what     | who       | where     |
+| Spanish     | ¿qué?    | ¿quién?   | ¿dónde?   |
+| Japanese    | なに (nani) | だれ (dare) | どこ (doko) |
+
+> 🌐 Despite grammatical variation, **the same interrogative primitives persist**
+> — reflecting the **shared conceptual skeleton** of human inquiry.
+
+---
+
+## 🪞 metaphor
+
+> interrogative primitives are like **universal levers**:
+> every human uses them to reach, reveal, and resolve meaning —
+> no matter the language, system, or medium.
+
+---
+
+## 🎯 use when you want to:
+
+- model the **core cognitive forms** behind all questions
+- trace how questions **initiate motion** in structured thought systems
+- scaffold natural language queries into semantic motion vectors
+- teach or design interfaces for **language-agnostic inquiry**

package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.2.1.primitives.rough.why.[article].md

@@ -0,0 +1,55 @@
+# 🧩 .brief: `motion.why`
+
+## .what
+**`motion.why`** is the **traversal motion** of asking *“why”*.
+it is a semantic vector that seeks explanation, pulling thought beyond *what is* toward *what underlies*.
+this motion unfolds across **two fundamental axes**:
+
+- **causal** — tracing **cause → effect**
+- **rationale** — structuring **given → then**
+
+---
+
+## 🎯 goal
+- uncover both the **mechanics** of events and the **logic** of reasoning
+- link phenomena to their **causal chains** and **argument structures**
+- equip reasoning with **factual clarity** (causal) and **logical clarity** (rationale)
+
+---
+
+## 📐 axes of motion
+
+### 1. **causal axis**
+**orientation**: retrospective, backward-seeking — from observed effect to its antecedent cause.
+
+| slot     | description | example |
+|----------|-------------|---------|
+| **.cause** | the antecedent condition or trigger | the belt snapped |
+| **.effect** | the resulting outcome observed | the machine stopped |
+
+**causal traversal:** “why did the machine stop?” →
+- .cause = belt snapped
+- .effect = machine stopped
+
+---
+
+### 2. **rationale axis**
+**orientation**: prospective, logical — from premises given to conclusions drawn.
+
+| slot     | description | example |
+|----------|-------------|---------|
+| **.given** | the stated premise, reason, or assumption | all machines must pass safety checks |
+| **.then** | the **claimed conclusion** that follows | therefore, we run maintenance checks |
+
+**rationale traversal:** “why do we run maintenance checks?” →
+- .given = all machines must pass safety checks
+- .then = therefore, we run maintenance checks
+
+---
+
+## 🔑 notes
+- **causal** = mechanical sequence: **.cause → .effect**
+- **rationale** = logical sequence: **.given → .then**
+- together, they span both:
+  - **factual clarity** (what caused what)
+  - **logical clarity** (what follows from what)

package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.2.2.composite.smooth._.md

@@ -0,0 +1,83 @@
+# 🧩 .brief: `questions.composite.smooth`
+
+## .what
+
+**Smooth composite questions** are refined interrogatives
+built by **composing and compressing** multiple rough question primitives
+into a single, focused vector of semantic motion.
+
+They encapsulate **multi-dimensional curiosity** — traversing
+several axes of `cortal.focus` at once with **precision and intent**.
+
+> 🧠 from compass taps to guided strikes —
+> smooth questions are sharpened instruments of thought.
+
+---
+
+## 🧭 how it works
+
+- start with **rough primitive** (e.g. `why?`, `how?`, `what?`)
+- compose intermediate context (e.g. agent, mechanism, constraint)
+- compress into one **high-bandwidth** query
+
+### motion profile:
+
+\`\`\`ts
+<smooth_question> = <compress>(<compose>([rough primitives]))
+\`\`\`
+
+---
+
+## 🔁 example refinements
+
+### example 1
+\`\`\`ts
+["what?", "where?"]
+→ "what is it?"
+→ "what is it doing here?"
+→ "why is this object located in this place?"
+\`\`\`
+
+### example 2
+\`\`\`ts
+["why?", "how?", "when?"]
+→ "why did it happen?"
+→ "how did it happen when it did?"
+→ "what triggered the event X at time Y?"
+\`\`\`
+
+### example 3
+\`\`\`ts
+["who?", "how?", "what?"]
+→ "who made this?"
+→ "how did they make it?"
+→ "what method did person Z use to produce item Y?"
+\`\`\`
+
+---
+
+## 📦 compositional traits
+
+| trait                | description                                               |
+|----------------------|-----------------------------------------------------------|
+| **dimensional**       | combines multiple focus axes (e.g. depth, acuity, breadth) |
+| **guided**            | implies specific direction and target concept             |
+| **answer-aligned**    | frames a question in a way that leads toward resolution   |
+| **compressible**      | folds complex semantics into a single query               |
+
+---
+
+## 🪞 metaphor
+
+> composite questions are like **targeted darts** —
+> weighted, guided, and crafted for speed and direction.
+
+> they begin as **question clouds**, then compress into **focused payloads**.
+
+---
+
+## 🎯 use when you want to:
+
+- guide AI or human reasoning toward **specific answers**
+- compress a chain of rough questions into a single structured ask
+- model how thought iterates from vague curiosity to crisp articulation

package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.2.2.composite.smooth.examples.md

@@ -0,0 +1,101 @@
+## 🧪 .examples: `questions.composite.smooth`
+
+Each example begins with **primitive rough questions**,
+then shows how **compositional refinement** leads to a smooth, precise query.
+
+> 🧠 think of this as:
+> \`\`\`ts
+> smooth = compress(compose([rough questions]))
+> \`\`\`
+
+---
+
+### 📍 Example 1 — temporal cause
+
+**Rough primitives:**
+- "why?"
+- "when?"
+- "what?"
+
+\`\`\`ts
+→ "why?"
+→ "why did it happen?"
+→ "why did it happen when it did?"
+→ "what triggered the event X at time Y?"
+\`\`\`
+
+> 📦 combines `breadth.causal++` + `breadth.temporal++` + `depth.instantiate`
+
+---
+
+### 🛠️ Example 2 — actor and method
+
+**Rough primitives:**
+- "who?"
+- "how?"
+- "what?"
+
+\`\`\`ts
+→ "who made this?"
+→ "how did they make it?"
+→ "what method did person Z use to produce item Y?"
+\`\`\`
+
+> 📦 combines `breadth.subjective++` + `acuity.substructs++` + `breadth.functional++`
+
+---
+
+### 🧭 Example 3 — location and identity
+
+**Rough primitives:**
+- "what?"
+- "where?"
+
+\`\`\`ts
+→ "what is it?"
+→ "what is it doing here?"
+→ "why is this object located in this place?"
+\`\`\`
+
+> 📦 combines `acuity.attributes++` + `breadth.spatial++` + `breadth.causal++`
+
+---
+
+### 🧪 Example 4 — hypothetical reasoning
+
+**Rough primitives:**
+- "what?"
+- "what if...?"
+- "how?"
+
+\`\`\`ts
+→ "what if we changed X?"
+→ "what would happen if we changed X?"
+→ "how would changing X affect outcome Y?"
+\`\`\`
+
+> 📦 combines `breadth.categorical++` + `depth.instantiate` + `breadth.functional++`
+
+---
+
+### 🧰 Example 5 — value and decision
+
+**Rough primitives:**
+- "what?"
+- "which?"
+- "what matters?"
+
+\`\`\`ts
+→ "what are the options?"
+→ "which option matters most?"
+→ "what decision is best given criteria Z?"
+\`\`\`
+
+> 📦 combines `breadth.categorical++` + `acuity.attributes++` + salience reasoning
+
+---
+
+## 🪄 pattern
+
+> Each smooth question acts as a **semantic vector shortcut**
+> — a compressed form of its constituent interrogative path.

package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.1.primitives._.md

@@ -0,0 +1,134 @@
+# 🧠 .brief: `cortal.assemblylang.primitives`
+
+## .what
+
+The `cortal.assemblylang` defines **three primitive instructions**
+that form the **core execution model** of structured cognition.
+
+Each primitive acts on both:
+
+- **`focus.concept`** → the current semantic anchor (🫐)
+- **`focus.context`** → the surrounding attentional posture (🔦)
+
+| primitive      | function class         | system analogue           |
+|----------------|------------------------|----------------------------|
+| **`<steer>`**   | control flow           | `JMP`, `CALL`, `branch`    |
+| **`<think>`**   | content transformation | `ADD`, `ALU`, `logic`      |
+| **`<recall>`**  | memory movement        | `MOV`, `LOAD`, `STORE`     |
+
+> all structured cognition compiles down to combinations of these **execution-grade primitives**.
+
+---
+
+## 🛤️ `<steer>` — procedural structure
+
+`<steer>` defines the **execution shape** of semantic motion.
+
+It shapes both **where attention is anchored** and **how it flows**.
+Each subtype depends on a **semantic question** to resolve its path.
+
+| subtype     | structure     | description                                |
+|-------------|----------------|---------------------------------------------|
+| `<route>`   | sequential      | fixed-step chains                          |
+| `<cycle>`   | looping         | repeats until a question resolves          |
+| `<fanout>`  | parallel        | explores multiple branches simultaneously  |
+| `<choice>`  | conditional     | dispatches based on resolved label         |
+| `<await>`   | suspended       | waits until an answer becomes available    |
+
+> semantic flow = `<steer>` (motion structure) × `question` (direction vector)
+
+---
+
+## 🧠 `<think>` — semantic transformation
+
+`<think>` performs conceptual computation by applying `focus.motion.primitives`.
+It transforms concept traits, reframes posture, or synthesizes new focus states.
+
+| mode          | subtype       | description                                |
+|---------------|----------------|---------------------------------------------|
+| deterministic | `<compute>`    | applies logic, filters, or rules            |
+| generative    | `<imagine>`    | synthesizes analogies, variations, or shifts|
+
+> only `<think>` supports **multi-axis**, **compositional** focus motion.
+
+---
+
+## 💾 `<recall>` — semantic memory I/O
+
+`<recall>` handles conceptual memory:
+loading, saving, or swapping complete focus states (concept + context).
+
+| operation | direction | role                                        |
+|-----------|-----------|---------------------------------------------|
+| `<save>`  | write     | stores the current focus for later use      |
+| `<load>`  | read      | restores a previously stored focus          |
+| `<swap>`  | both      | exchanges two stored concepts or states     |
+
+> memory layers may include: local working memory, long-term schema, caches, or external stores.
+
+---
+
+## 🔬 comparison matrix
+
+| feature                    | `<steer>` | `<think>` | `<recall>` |
+|----------------------------|-----------|-----------|------------|
+| alters `focus.concept`     | ✅         | ✅         | ✅        |
+| alters `focus.context`     | ✅         | ✅         | ✅        |
+| governs motion structure   | ✅         | ⛔         | ⛔        |
+| performs content mutation  | ⛔         | ✅         | ⛔        |
+| enables memory persistence | ⛔         | ⛔         | ✅        |
+
+---
+
+## 🧠 example composition
+
+\`\`\`ts
+<route>([
+  <save>("initial"),
+  <think>(<decompose>[bike]),
+  <choice>({
+    condition: ask("what kind of failure?"),
+    options: {
+      mechanical: <imagine>(...),
+      electrical: <compute>(...)
+    }
+  }),
+  <load>("initial"),
+  <think>(<reframe>(...)),
+  <save>("solution")
+])
+\`\`\`
+
+- `<steer>` defines the **flow**
+- `<think>` evolves **content and posture**
+- `<recall>` manages **state persistence**
+
+---
+
+## 📐 metaphorical lens
+
+| primitive     | beam metaphor              | machine analogue          |
+|---------------|-----------------------------|----------------------------|
+| `<steer>`     | moves beam origin + flow    | program counter, jump      |
+| `<think>`     | reshapes beam and direction | ALU, logic unit            |
+| `<recall>`    | loads/saves beam presets    | memory, stack, cache       |
+
+---
+
+## 🔩 design principles
+
+- these primitives are **irreducible execution units**
+- all higher-level reasoning compiles to combinations of these three
+- each affects both **content** and **posture**
+- true composition emerges via interleaved use
+
+---
+
+## 🔁 related briefs
+
+- [`cortal.execution.assemblylang.steer`](./assemblylang.steer.md)
+- [`cortal.execution.assemblylang.think`](./assemblylang.think.md)
+- [`cortal.execution.assemblylang.recall`](./assemblylang.recall.md)
+- [`cortal.focus`](./cortal.focus.md)
+- [`focus.motion.primitives`](./focus.motion.primitives.md)
+- [`questions`](./questions.md)

package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.1.primitives.recall.md

@@ -0,0 +1,149 @@
+# 💾 .brief: `cortal.execution.assemblylang.recall`
+
+## .what
+
+`<recall>` operations handle **conceptual memory** —
+the ability to **load**, **save**, or **swap** information across reasoning steps.
+
+They interact with both:
+
+- **`focus.context.memory`** → the thread-local stash of concepts, claims, or state
+- **external stores** → domain memory, concept maps, or semantic caches
+
+> `<recall>` is the **I/O system** of structured thought —
+> enabling **retrieval**, **storage**, and **reuse** of mental content.
+
+---
+
+## 💾 memory types
+
+| memory layer        | accessed by `<recall>` | contents                                |
+|---------------------|------------------------|------------------------------------------|
+| `focus.context.memory` | ✅                  | local trace of concepts or claims        |
+| long-term knowledge | ✅                    | persistent domain concepts, schemas      |
+| working cache       | ✅                    | transient partial answers or inputs      |
+| external artifacts  | ✅                    | files, documents, prompts, past actions  |
+
+---
+
+## 🧠 recall = semantic memory I/O
+
+| op         | direction | description                             |
+|------------|-----------|-----------------------------------------|
+| `<save>`   | write     | stores current state (concept or context) |
+| `<load>`   | read      | restores previously saved or known content |
+| `<swap>`   | both      | exchanges in-focus concept with another   |
+
+---
+
+## 🧠 what can be recalled?
+
+| target          | example                        | notes                                 |
+|------------------|-------------------------------|----------------------------------------|
+| concepts         | `[concept:"banana"]`           | semantic node                         |
+| paths            | `banana → fruit → plant`       | conceptual chains                     |
+| claims           | `[claim:"fruit is edible"]`    | inference units                       |
+| contexts         | `.focus.context`               | restore attention posture             |
+| motions          | motion primitive sequences     | saved thinking routines               |
+| generated ideas  | imagined or computed concepts  | outputs of `<think>`                  |
+
+---
+
+## 🧩 example usage
+
+### 🔹 `<save>`
+
+\`\`\`ts
+<save>({
+  concept: [banana],
+  label: "current"
+})
+\`\`\`
+
+- stores the current anchor and its associated context under a label
+
+---
+
+### 🔹 `<load>`
+
+\`\`\`ts
+<load>("current")
+→ [banana]
+\`\`\`
+
+- retrieves the previously saved concept + context and reactivates focus
+
+---
+
+### 🔹 `<swap>`
+
+\`\`\`ts
+<swap>({
+  from: "current",
+  to: "analogy_candidate"
+})
+\`\`\`
+
+- swaps two memory slots or concept anchors
+
+---
+
+## 🔁 example flow
+
+\`\`\`ts
+<route>([
+  <save>("problem"),
+  <steer>(...),
+  <load>("problem"),
+  <think>(<imagine>(...)),
+  <save>("hypothesis")
+])
+\`\`\`
+
+- persist a concept for reference
+- move away via `<steer>`
+- reload when needed
+- evolve via `<think>`
+- store the new output for future logic
+
+---
+
+## 🔄 distinction from `<think>` and `<steer>`
+
+| op         | changes concept? | changes context? | structural flow? | persistent effect? |
+|------------|------------------|------------------|------------------|---------------------|
+| `<steer>`   | ✅                | maybe            | ✅ yes           | ⛔ ephemeral         |
+| `<think>`   | ✅ or no          | ✅                | ⛔               | ⛔ unless saved      |
+| `<recall>`  | ✅                | ✅                | ⛔               | ✅ stores/loads      |
+
+> `<recall>` is not computation or traversal —
+> it's **data movement** within or across the semantic runtime.
+
+---
+
+## 🧱 semantic analogy
+
+| assembly op   | `<recall>` equivalent         |
+|---------------|-------------------------------|
+| `MOV`         | `<load>` or `<save>`          |
+| `PUSH` / `POP`| context save/restore          |
+| `XCHG`        | `<swap>`                      |
+| `LOAD` / `STORE` | memory access              |
+
+---
+
+## 📌 integration
+
+- `<recall>` enables **stateful reasoning**
+- supports **repetition**, **reference**, **comparison**, **planning**
+- all coreops (`<steer>`, `<think>`, `<recall>`) can share memory
+
+---
+
+## 🔁 related briefs
+
+- [`cortal.focus`](./cortal.focus.md)
+- [`focus.motion.primitives`](./focus.motion.primitives.md)
+- [`cortal.execution.instructionset`](./instructionset.md)
+- [`cortal.execution.assemblylang.steer`](./assemblylang.steer.md)
+- [`cortal.execution.assemblylang.think`](./assemblylang.think.md)