rhachet-roles-ehmpathy 1.1.0 → 1.2.0

package/dist/logic/roles/mechanic/write/loopWrite.d.ts

@@ -1,13 +1,4 @@
 export declare const loopWrite: import("rhachet").Stitcher<import("rhachet").GStitcher<import("rhachet").Threads<{
-    mechanic: import("rhachet").RoleContext<"mechanic", {
-        art: {
-            inflight: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
-        };
-    } & {
-        art: {
-            inflight: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
-        };
-    }>;
     caller: import("rhachet").RoleContext<"caller", {
         ask: string;
         art: {
@@ -20,6 +11,15 @@ export declare const loopWrite: import("rhachet").Stitcher<import("rhachet").GSt
             feedback: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
         };
     }>;
+    mechanic: import("rhachet").RoleContext<"mechanic", {
+        art: {
+            inflight: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    } & {
+        art: {
+            inflight: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    }>;
 }>, import("../../../../data/sdk/sdkOpenAi").ContextOpenAI & import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, {
     feedback: import("rhachet-artifact-git").GitFile | null;
 }>>;

package/dist/logic/roles/mechanic/write/loopWrite.skill.d.ts

@@ -1,13 +1,4 @@
 export declare const SKILL_WRITE: import("rhachet").RoleSkill<import("rhachet").GStitcher<import("rhachet").Threads<{
-    mechanic: import("rhachet").RoleContext<"mechanic", {
-        art: {
-            inflight: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
-        };
-    } & {
-        art: {
-            inflight: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
-        };
-    }>;
     caller: import("rhachet").RoleContext<"caller", {
         ask: string;
         art: {
@@ -20,6 +11,15 @@ export declare const SKILL_WRITE: import("rhachet").RoleSkill<import("rhachet").
             feedback: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
         };
     }>;
+    mechanic: import("rhachet").RoleContext<"mechanic", {
+        art: {
+            inflight: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    } & {
+        art: {
+            inflight: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    }>;
 }>, import("../../../../data/sdk/sdkOpenAi").ContextOpenAI & import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, {
     feedback: import("rhachet-artifact-git").GitFile | null;
 }>>;

package/dist/logic/roles/mechanic/write/loopWrite.skill.js

@@ -22,7 +22,7 @@ exports.SKILL_WRITE = (0, rhachet_1.genRoleSkill)({
             },
             references: {
                 source: 'process.argv',
-                char: 'p',
+                char: 'f',
                 desc: 'reference files to to use',
                 type: '?string', // todo: string []
             },

package/dist/logic/roles/mechanic/write/stepWrite.js

@@ -21,6 +21,7 @@ const template = (0, rhachet_1.genTemplate)({
                 ...(0, getMechanicBrief_1.getMechanicBriefs)([
                     'architecture/ubiqlang.md',
                     'style.names.treestruct.md',
+                    'codestyle/mech.what-why.v2.md',
                 ]),
                 ...(0, getEcologistBrief_1.getEcologistBriefs)([
                     'distilisys/sys101.distilisys.grammar.md',

package/dist/logic/roles/mechanic/write/stepWrite.js.map

@@ -1 +1 @@
-{"version":3,"file":"stepWrite.js","sourceRoot":"","sources":["../../../../../src/logic/roles/mechanic/write/stepWrite.ts"],"names":[],"mappings":";;;AAAA,qCAUiB;AAGjB,6CAAqD;AAErD,8DAA0E;AAC1E,mEAAgE;AAChE,yEAAuE;AACvE,0DAAwD;AA2BxD,MAAM,QAAQ,GAAG,IAAA,qBAAW,EAA6B;IACvD,GAAG,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE;IACvD,YAAY,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,CAAC,MAAM,IAAA,wCAA8B,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvE,GAAG,EACD,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO;YACjE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG;QAClC,UAAU,EAAE,MAAM,IAAA,qCAA2B,EAAC;YAC5C,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE;SAC7D,CAAC;QACF,MAAM,EAAE,MAAM,IAAA,qCAA2B,EAAC;YACxC,SAAS,EAAE;gBACT,GAAG,IAAA,oCAAiB,EAAC;oBACnB,0BAA0B;oBAC1B,2BAA2B;iBAC5B,CAAC;gBACF,GAAG,IAAA,sCAAkB,EAAC;oBACpB,yCAAyC;oBACzC,6CAA6C;iBAC9C,CAAC;aACH;SACF,CAAC;QACF,QAAQ,EACN,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;KAC3E,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,mCAAyB,EAAkB;IAC7D,IAAI,EAAE,4BAA4B;IAClC,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,EAAE;IACV,QAAQ;IACR,OAAO,EAAE,IAAA,uBAAS,EAChB,IAAA,yBAAW,EAAC,qBAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,CAC/D;CACF,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,6BAAa,EAAC;IAChC,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,UAAU;CAClB,CAAC,CAAC;AAEU,QAAA,SAAS,GAAG,IAAA,wBAAc,EACrC,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,mBAAmB;IACzB,MAAM,EAAE,kCAAkC;IAC1C,QAAQ,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;CACrC,CAAC,CACH,CAAC"}
+{"version":3,"file":"stepWrite.js","sourceRoot":"","sources":["../../../../../src/logic/roles/mechanic/write/stepWrite.ts"],"names":[],"mappings":";;;AAAA,qCAUiB;AAGjB,6CAAqD;AAErD,8DAA0E;AAC1E,mEAAgE;AAChE,yEAAuE;AACvE,0DAAwD;AA2BxD,MAAM,QAAQ,GAAG,IAAA,qBAAW,EAA6B;IACvD,GAAG,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE;IACvD,YAAY,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,CAAC,MAAM,IAAA,wCAA8B,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvE,GAAG,EACD,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO;YACjE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG;QAClC,UAAU,EAAE,MAAM,IAAA,qCAA2B,EAAC;YAC5C,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE;SAC7D,CAAC;QACF,MAAM,EAAE,MAAM,IAAA,qCAA2B,EAAC;YACxC,SAAS,EAAE;gBACT,GAAG,IAAA,oCAAiB,EAAC;oBACnB,0BAA0B;oBAC1B,2BAA2B;oBAC3B,+BAA+B;iBAChC,CAAC;gBACF,GAAG,IAAA,sCAAkB,EAAC;oBACpB,yCAAyC;oBACzC,6CAA6C;iBAC9C,CAAC;aACH;SACF,CAAC;QACF,QAAQ,EACN,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;KAC3E,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,mCAAyB,EAAkB;IAC7D,IAAI,EAAE,4BAA4B;IAClC,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,EAAE;IACV,QAAQ;IACR,OAAO,EAAE,IAAA,uBAAS,EAChB,IAAA,yBAAW,EAAC,qBAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,CAC/D;CACF,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,6BAAa,EAAC;IAChC,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,UAAU;CAClB,CAAC,CAAC;AAEU,QAAA,SAAS,GAAG,IAAA,wBAAc,EACrC,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,mBAAmB;IACzB,MAAM,EAAE,kCAAkC;IAC1C,QAAQ,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;CACrC,CAAC,CACH,CAAC"}

package/dist/logic/roles/mechanic/write/stepWrite.template.md

@@ -4,10 +4,14 @@ output the updated ```md of the "document", only.
 - do not include the outside ```md. return ONLY the documents CONTENT
 - update the [document] based on the @[caller]s current [comment]
 - never return ```md. only return the insides
+- RETAIN ALL COMMENTS; NEVER DROP COMMENTS; THIS IS MOST IMPORTANT
 
 ---
 
 here are the .traits you have
+
+- you are meticulous about info retention; never loose details, especially not code.comments, which are the most important
+
 $.rhachet{inherit.traits}
 
 ---

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet-roles-ehmpathy",
   "author": "ehmpathy",
   "description": "empathetic software construction roles and skills, via rhachet",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "repository": "ehmpathy/rhachet-roles-ehmpathy",
   "homepage": "https://github.com/ehmpathy/rhachet-roles-ehmpathy",
   "keywords": [
@@ -52,13 +52,14 @@
     "@ehmpathy/as-command": "1.0.3",
     "@ehmpathy/uni-time": "1.8.1",
     "as-procedure": "1.1.7",
+    "domain-objects": "0.25.2",
     "fast-glob": "3.3.3",
     "helpful-errors": "1.3.8",
     "inquirer": "12.7.0",
     "openai": "5.8.2",
     "rhachet": "1.4.0",
     "rhachet-artifact": "1.0.0",
-    "rhachet-artifact-git": "1.0.2",
+    "rhachet-artifact-git": "1.1.0",
     "serde-fns": "1.2.0",
     "type-fns": "1.19.0",
     "wrapper-fns": "1.1.0"

package/readme.[seed].md

@@ -0,0 +1,2 @@
+- dependable; with rhachet roles, you can depend on consistent performance, since the full context is explicitly known and stable
+- precision; with .briefs, you can become as precise as required, as you can supply the focus.acuity required

package/dist/logic/roles/bhrain/.briefs/cognition/cog101.cortal.focus.p2.acuity.md

@@ -1,107 +0,0 @@
-# 🔬 .brief: cortal.focal.acuity
-
-## .what
-**cortal.focal.acuity** governs the **semantic resolution** of each concept in focus — how **granular**, **fine-differentiated**, and **multi-dimensional** the concept representation is.
-
-It determines how **much inner detail** your focus resolves per concept node within the radial `concept.treestruct`.
-
----
-
-## 🧠 how it works
-
-Acuity controls the **grain of resolution** across semantic traits:
-
-- `acuity++` → high resolution
-  - many dimensions: features, subtypes, conditions, histories
-  - e.g. for [concept:"hammer"]: `head.mass`, `handle.material`, `strike.radius`
-
-- `acuity--` → low resolution
-  - coarse, holistic representations
-  - e.g. just “thing you hit with”
-
-It operates **independently** of:
-- `focal.depth`: how many concept layers are stacked
-- `focal.breadth`: how many neighbors are viewed
-
----
-
-## 🔦 metaphor: optical focus
-
-- high acuity = **sharp lens**
-  - captures fine semantic edges and attributes
-  - like increasing megapixels on a single node
-
-- low acuity = **blurry filter**
-  - sees only general shape or role
-  - useful for fast scanning or abstract reasoning
-
----
-
-## 📐 composition tradeoff
-
-```
-focal.depth × focal.acuity² ∝ focal.breadth²
-```
-
-Because acuity is squared, it's **computationally expensive** — high acuity costs high breadth or very limited depth without overload.
-
----
-
-## 🧪 examples
-
-### 🐶 [concept:"dog"]
-
-- `acuity--`: “a furry animal that barks”
-- `acuity++`:
-  - `breed.type`, `coat.pattern`, `jaw.structure`, `training.history`, `social.role`
-
----
-
-### 🔋 [concept:"battery"]
-
-- `acuity--`: “thing that stores energy”
-- `acuity++`:
-  - `electrode.material`, `charge.curve`, `form.factor`, `voltage.stability`, `temp.range`
-
----
-
-### 🪚 [concept:"handsaw"]
-
-- `acuity--`: “tool for cutting”
-- `acuity++`:
-  - `tooth.pitch`, `blade.flex`, `grip.material`, `cut.style`, `pull.push.orientation`
-
----
-
-## 🎯 why acuity matters
-
-High acuity enables:
-
-- **precise design thinking**
-- **deep diagnosis**
-- **feature-based comparison**
-
-Low acuity supports:
-
-- **rapid categorization**
-- **abstraction and generalization**
-- **semantic compression**
-
----
-
-## 🔁 dynamic behavior
-
-Acuity is often **modulated** as you move between tasks:
-
-- zoom in = `acuity++` to analyze fine traits
-- zoom out = `acuity--` to generalize or jump layers
-
-Acuity can also vary **per neighbor** during lateral traversal — some concepts may be crisp, others fuzzy.
-
----
-
-## 🧰 use it for:
-
-- **design**, **diagnosis**, **teaching**, **modeling**
-- any task that benefits from distinguishing between **subtle features** or **internal structure**
-

package/dist/logic/roles/bhrain/.briefs/cognition/cog101.cortal.focus.p2.breadth.md

@@ -1,118 +0,0 @@
-# 🌐 .brief: cortal.focal.breadth
-
-## .what
-**cortal.focal.breadth** defines the **angular sweep** of attention around a concept anchor in the `concept.treestruct`, determining how many **neighbor concepts** are held in focus at a given semantic depth.
-
-Unlike a perfect ring, this breadth is a **selective and shaped patch** of concept space — it may be symmetrical or irregular, depending on salience, familiarity, or intent.
-
----
-
-## 🌀 relative geometry
-
-From the **relative perspective**, breadth expands **around** your current anchor concept.
-
-- **breadth** includes a set of **neighbor concepts** at the same semantic depth
-- the inclusion shape is **not uniform** — it can be lopsided, sparse, or clustered
-- this creates an **irregular band** of peer concepts, shaped by relevance or recognition
-
-> e.g. from [concept:"banana"], `breadth++` might include [concept:"apple"], [concept:"plantain"], [concept:"mango"], skipping [concept:"fig"] entirely
-
----
-
-## ↔️ traversal behavior
-
-| operation     | effect                                         |
-|---------------|------------------------------------------------|
-| `breadth++`   | adds more **neighbor concepts** to the shape   |
-| `breadth--`   | contracts the included set                     |
-
----
-
-## 🔦 metaphor: shaped spotlight
-
-Your focus acts like a **spotlight beam**, projecting outward across a semantic layer.
-But rather than lighting a perfect cone, it traces a **contoured patch** — a shape defined by:
-
-- cognitive salience
-- current intent
-- available attention
-- memory activation
-
----
-
-## 🧠 why it matters
-
-**Breadth** empowers:
-
-- **semantic comparison**
-- **pattern triangulation**
-- **category discovery**
-- **exploration across peer variations**
-
-But it must be composed carefully with **depth** and **acuity** to avoid:
-
-- overload
-- drift
-- incoherent jumps
-
----
-
-## 📈 compositional tradeoff
-
-```
-focal.depth × focal.acuity² ∝ focal.breadth²
-```
-
-As breadth grows:
-
-- it taxes depth and acuity
-- it risks blurring or dilution
-- but it also enables richer relational context
-
----
-
-## 🧭 traversal spectrum
-
-- **tight breadth** → local siblings only
-- **medium breadth** → neighboring subtypes, cousins
-- **wide breadth** → cross-domain links or analogies
-
-At extreme angles, `breadth` borders **angular traversal**, crossing semantic axes (e.g., from [concept:"dog"] to [concept:"vehicle"] by metaphor).
-
----
-
-## 🧪 examples
-
-### 🐶 anchor: [concept:"dog"]
-
-- `breadth--`: only [concept:"dog"]
-- `breadth++`: [concept:"dog"], [concept:"cat"], [concept:"rabbit"], [concept:"ferret"]
-
-→ note: may **favor mammals**, exclude reptiles, skip obscure species
-
----
-
-### 🍌 anchor: [concept:"banana"]
-
-- `breadth--`: just [concept:"banana"]
-- `breadth++`: [concept:"apple"], [concept:"plantain"], [concept:"mango"], maybe [concept:"dates"]
-
-→ shaped by **culinary familiarity** or **visual similarity**
-
----
-
-### 🛠️ anchor: [concept:"screwdriver"]
-
-- `breadth--`: only [concept:"mechanical screwdriver"]
-- `breadth++`: [concept:"torx driver"], [concept:"allen key"], skips [concept:"impact driver"]
-
-→ shaped by **use case**, **manual vs powered**, or **available knowledge**
-
----
-
-## 🧭 use it to:
-
-- **cluster neighbors**
-- **contrast category members**
-- **explore semantically nearby ideas**
-- **triangulate relationships**

package/dist/logic/roles/bhrain/.briefs/cognition/cog101.cortal.focus.p2.depth.md

@@ -1,121 +0,0 @@
-# 🕳️ .brief: cortal.focal.depth
-
-## .what
-**cortal.focal.depth** defines the **radial thickness** of semantic layers surrounding a concept, measured within the `concept.treestruct` from a **relative anchor**.
-
-It reflects how many layers of meaning — both more abstract and more specific — are simultaneously in view, relative to the current center of thought.
-
----
-
-## 📐 relative geometry
-
-In the **relative perspective**, attention radiates outward from an anchor concept — forming a **radial shell** through the surrounding concept space:
-
-- `focal.depth` defines **how thick** that shell is
-- traversal still follows **universal abstraction**:
-  - **inward** = more abstract
-  - **outward** = more specific
-- but the **frame of reference** is **local**:
-  - depth is measured “**around**” the anchor
-
-> from [concept:"banana"], a thick depth might include [concept:"fruit"] (inward) and [concept:"plantain"] (outward)
-
----
-
-## 🔦 metaphor: beam of attention
-
-Imagine a **beam of focus** radiating from your current anchor:
-
-- it slices through surrounding layers of the TreeStruct
-- the **thickness** of that slice is `focal.depth`
-- one direction reaches **inward** toward abstraction
-- the other moves **outward** toward specialization
-
-This beam defines which semantic layers are cognitively lit up — and how far in both directions your reasoning stretches.
-
----
-
-## ↕️ directional behavior (universal semantics)
-
-```
-depth.inward++   → include more abstract concepts
-depth.outward++  → include more specific concepts
-depth.inward--   → trim inner abstraction
-depth.outward--  → trim edge specificity
-```
-
-These movements are **semantic**, not spatial — they follow the **universal axis of abstraction** regardless of your anchor point.
-
----
-
-## 📊 thickness vs precision
-
-- `depth++` → more layers included
-- `depth--` → thinner slice around anchor
-
-Choose based on your cognitive goal:
-
-| Use Case                  | Strategy                         |
-|---------------------------|----------------------------------|
-| Pattern → implementation  | `depth++` for vertical span      |
-| Local precision task      | `depth--` for focus              |
-| Core essence only         | `depth.inward--`                 |
-| Fine-grain edge only      | `depth.outward--`                |
-
----
-
-## 📈 compositional interaction
-
-```
-focal.depth × focal.acuity² ∝ focal.breadth²
-```
-
-This geometric relation constrains focus:
-
-- the deeper your shell, the finer your acuity must be reduced to maintain clarity across a wide breadth
-- you can’t go **deep, wide, and sharp** all at once — without tradeoffs
-
----
-
-## 🧠 examples
-
-### 🐶 anchor: [concept:"dog"]
-
-- `depth.inward++`:
-  [concept:"mammal"] → [concept:"animal"] → [concept:"organism"]
-- `depth.outward++`:
-  [concept:"golden retriever"] → [concept:"service retriever"] → [concept:"autism-assist retriever"]
-
----
-
-### 🛠️ anchor: [concept:"hammer"]
-
-- `depth.inward++`:
-  [concept:"hand tool"] → [concept:"manual implement"] → [concept:"mechanical device"]
-- `depth.outward++`:
-  [concept:"claw hammer"] → [concept:"rubber-handled claw hammer"] → [concept:"ergonomic demolition hammer"]
-
----
-
-## 🧰 radial composition behavior
-
-```
-focal.depth++
-⇒ depth.inward++ && depth.outward++
-⇒ [concept:"dog"] ←→ [concept:"autism-assist retriever"]
-```
-
-```
-focal.depth--
-⇒ depth.inward-- && depth.outward--
-⇒ only [concept:"dog"]
-```
-
----
-
-## 🧭 use when you need:
-
-- **multilevel semantic perspective**
-- **vertical reasoning chains**
-- **semantic scaffolding**
-- **narrative abstraction control**

package/dist/logic/roles/bhrain/.briefs/cognition/cog301.concept.traversal.p1.universal.md

@@ -1,108 +0,0 @@
-# 🧭 .brief: concept.treestruct.traversal
-
-## .what
-The **concept.treestruct.traversal** model defines the three fundamental directions of **semantic movement** in the universal rootball:
-
-1. **radial** — abstraction and specialization
-2. **lateral** — peer-to-peer comparison at the same depth
-3. **angular** — cross-axis shifts, often involving metaphor, analogy, or re-framing
-
-These directions describe how a thinker or system can **navigate** from one concept to another — based not on static position, but on the **path taken through meaning**.
-
----
-
-## .why
-
-Modeling traversal is essential for:
-
-- distinguishing between **structural motion** and **semantic drift**
-- grounding metaphor and analogy in measurable displacements
-- explaining how conceptual reasoning moves from point to point
-- linking relative and universal perspectives through common mechanics
-
-Traversal defines the **vectors of thought** in concept space.
-
----
-
-## .modes of traversal
-
-### 🌀 radial traversal
-
-> Move toward or away from the core concept: `"concept"`
-
-- **inward** = abstraction (generalization, simplification)
-- **outward** = specification (elaboration, detail)
-- controlled by `focal.depth`
-- radial motion defines how far a concept is from the root
-
-📌 this is the **primary axis of compression**
-📌 motion is often hierarchical or categorical in nature
-
----
-
-### ↔️ lateral traversal
-
-> Move across peer concepts at the same level of abstraction
-
-- explores conceptual **neighbors**
-- often used in comparison, substitution, clustering
-- measured by `focal.breadth`
-- lateral motion assumes local semantic coherence
-
-📌 when semantic angle is small, **angular ≈ lateral**
-📌 often invisible in thought — we "drift" between peers seamlessly
-
----
-
-### 🔀 angular traversal
-
-> Shift semantic direction — change frame, domain, or axis
-
-- may involve:
-  - domain switching (e.g. taxonomy → function)
-  - role shifting (e.g. `"dog"` as animal → `"dog"` as servant)
-  - metaphor (e.g. `"knife"` ↔ `"word"`)
-  - analogical reasoning
-- often includes **radial changes** as side-effects
-- angular motion is less linear — more like a **semantic curve**
-
-📌 angular motion is the **engine of creative, lateral, symbolic thought**
-📌 enables pattern recognition, schema transfer, and reframing
-
----
-
-## .gradient boundary
-
-> The boundary between lateral and angular traversal is **not discrete**.
-
-- when angular displacement is small, lateral ≈ angular
-- when axis/frame changes, angular ≠ lateral
-- key distinction: **does the movement preserve semantic orientation or reframe it?**
-
----
-
-## .compound traversal
-
-Most real traversal is **blended**:
-
-- `"banana"` → `"apple"` → `"fruit"` → `"snack"` → `"joke"` → `"banana phone"`
-
-This path includes:
-- lateral (apple)
-- radial-in (fruit)
-- radial-out (snack)
-- angular (joke)
-- angular again (banana as visual pun)
-
-📌 traversal chains accumulate displacement
-📌 over time, they drift semantically and structurally
-
----
-
-## .notes
-
-- traversal ≠ position — it's **semantic movement**
-- traversal defines how we **think**, **search**, **compare**, and **reinterpret**
-- all traversal occurs within the **universal RootStruct**, but may be framed **relatively** or **fractally**
-
-> Concepts are not just things to describe — they are places to move between.

package/dist/logic/roles/bhrain/.briefs/cognition/cog301.concept.traversal.p2.relative.md

@@ -1,76 +0,0 @@
-# 🎯 .brief: concept.traversal.relative
-
-## .what
-**Relative traversal** is the act of navigating concept space from a **local anchor**, using directional motion along the axes of:
-
-- **depth** → how far you traverse across abstraction layers
-- **breadth** → how many semantic neighbors you include
-- **acuity** → how finely you resolve each concept in view
-
-This motion takes place within the `concept.treestruct` and is governed by the structure of your `cortal.focus`.
-
----
-
-## 🎛️ axes of motion
-
-### 🕳️ depth
-Radial traversal **inward or outward** from the anchor concept.
-
-- `depth.inward++` → include more **abstract cores**
-  - e.g. `"banana"` → `"fruit"` → `"plant organ"` → `"organism"`
-- `depth.outward++` → include more **specialized instances**
-  - e.g. `"banana"` → `"sliced banana"` → `"frozen banana coin"`
-- `depth.inward--` or `depth.outward--` → **trim layers** from core or edge
-
----
-
-### 🔭 breadth
-Lateral inclusion of **semantic neighbor** concepts at a given depth.
-
-- `breadth++` → include more **neighbor concepts**
-  - e.g. `"banana"` ↔ `"mango"` ↔ `"pear"` ↔ `"pineapple"`
-- `breadth--` → restrict to fewer or single peer(s)
-  - e.g. `"banana"` only
-
-> Real breadth is not a perfect ring — it's an **irregular cloud** of selected neighbors.
-
----
-
-### 🔬 acuity
-Adjustment of **semantic resolution** on each concept.
-
-- `acuity++` → resolve more fine-grained features or attributes
-  - e.g. `banana.color`, `banana.curvature`, `banana.firmness`
-- `acuity--` → see only coarse or holistic forms
-  - e.g. just “banana” as “fruit,” ignoring detail
-
----
-
-## 🧠 common traversal moves
-
-| Move         | Axis       | Description                                   | Example                                              |
-|--------------|------------|-----------------------------------------------|------------------------------------------------------|
-| `abstract`   | depth.inward++  | move toward more general concept             | `"banana"` → `"fruit"`                               |
-| `specify`    | depth.outward++ | move toward more specific subtype            | `"dog"` → `"border collie"`                          |
-| `exemplify`  | depth.outward++ | point to an instance of a type               | `"fruit"` → `"banana"`                               |
-| `decompose`  | acuity++        | break into semantic parts or properties      | `"banana"` → `"peel"`, `"flesh"`, `"color"`          |
-| `broaden`    | breadth++       | include more lateral peers                   | `"banana"` ↔ `"mango"`, `"pear"`, `"grape"`          |
-| `narrow`     | breadth--       | restrict peer inclusion                      | only `"banana"`                                      |
-| `blur`       | acuity--        | reduce resolution for general interpretation | ignore peel/flesh — treat `"banana"` holistically    |
-| `sharpen`    | acuity++        | increase resolution on semantic structure    | attend to `stem.thickness`, `ripeness.window`, etc.  |
-
----
-
-## 🔁 traversal = active reconfiguration
-
-Each traversal move modifies your **focal envelope** — the portion of concept space currently visible and resolved.
-
-This enables:
-
-- **pattern matching** (`depth.inward++` + `breadth++`)
-- **artifact design** (`depth.outward++` + `acuity++`)
-- **decision making** (`breadth++` + `acuity++`)
-- **abstraction** and **integration** (`depth.inward++` + `acuity--`)
-
-> Thought is traversal —
-> and traversal is motion through structured meaning.