holomime 2.0.0 → 2.1.1

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://holomime.dev/logo-icon.svg" alt="holomime" width="80" />
+  <img src="site/public/logo-icon.svg" alt="holomime" width="80" />
 </p>
 
 <h1 align="center">holomime</h1>
@@ -7,53 +7,65 @@
 <p align="center">
   Behavioral intelligence for humanoid robots. Train the mind. Deploy the body.<br />
   <em>We train AI agents through structured behavioral therapy, then deploy them into physical robot bodies. The agent is the rehearsal. The robot is the performance.</em><br />
-  <code>soul.md</code> &middot; <code>psyche.sys</code> &middot; <code>body.api</code> &middot; <code>conscience.exe</code>
+  <code>soul.md</code> &middot; <code>mind.sys</code> &middot; <code>purpose.cfg</code> &middot; <code>shadow.log</code> &middot; <code>body.api</code> &middot; <code>conscience.exe</code> &middot; <code>ego.runtime</code>
 </p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/holomime"><img src="https://img.shields.io/npm/v/holomime.svg" alt="npm version" /></a>
   <a href="https://github.com/productstein/holomime/actions/workflows/ci.yml"><img src="https://github.com/productstein/holomime/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
   <a href="https://github.com/productstein/holomime/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/holomime.svg" alt="license" /></a>
-  <a href="https://holomime.dev"><img src="https://img.shields.io/badge/docs-holomime.dev-blue" alt="docs" /></a>
+  <a href="https://holomime.com"><img src="https://img.shields.io/badge/docs-holomime.com-blue" alt="docs" /></a>
 </p>
 
 ---
 
 ## The Identity Stack
 
-Four files define who your agent is. They compile into a single `.personality.json` that any runtime can consume.
+Seven files define who your agent is. They compile into a single `.personality.json` that any runtime can consume.
 
 ```
-  soul.md          Values, ethics, purpose. Immutable.
-  psyche.sys       Big Five, EQ, communication. Auto-patched by therapy.
+  soul.md          Essence, values, ethics. Immutable. (Aristotle)
+  mind.sys         Big Five, EQ, communication. Auto-patched by therapy. (Jung)
+  purpose.cfg      Role, objectives, domain. Configured per deployment. (Aristotle)
+  shadow.log       Detected patterns, blind spots. Auto-generated by diagnosis. (Jung)
   body.api         Morphology, sensors, safety envelope. Swappable per form factor.
-  conscience.exe   Deny / allow / escalate rules. Never auto-modified.
+  conscience.exe   Deny / allow / escalate rules. Never auto-modified. (Freud)
+  ego.runtime      Conflict resolution, runtime mediation. (Freud)
 
         ┌─────────────┐
-        │   soul.md    │──── values, red lines, purpose
+        │   soul.md    │──── essence, values, red lines
         ├─────────────┤
-        │ psyche.sys   │──── Big Five, EQ, communication style
+        │  mind.sys    │──── Big Five, EQ, communication style
+        ├─────────────┤
+        │ purpose.cfg  │──── role, objectives, domain scope
+        ├─────────────┤
+        │ shadow.log   │──── detected patterns, blind spots
         ├─────────────┤
         │  body.api    │──── morphology, sensors, safety envelope
         ├─────────────┤
         │conscience.exe│──── deny / allow / escalate rules
+        ├─────────────┤
+        │ ego.runtime  │──── conflict resolution, mediation
         └──────┬──────┘
                │ compile
                ▼
       .personality.json
 ```
 
-- **soul.md** -- Your agent's essence. Core values, ethical framework, red lines. Written in Markdown with YAML frontmatter. Immutable -- never modified by therapy or automation.
-- **psyche.sys** -- The inner life. Big Five personality (20 sub-facets), emotional intelligence, communication style, growth areas. YAML format. Auto-patched when therapy detects cognitive or emotional drift.
+- **soul.md** -- Your agent's essence. Core values, ethical framework, red lines. Written in Markdown with YAML frontmatter. Immutable -- never modified by therapy or automation. (Aristotle: the essence that makes a thing what it is.)
+- **mind.sys** -- The inner life. Big Five personality (20 sub-facets), emotional intelligence, communication style, growth areas. YAML format. Auto-patched when therapy detects cognitive or emotional drift. (Jung: the totality of all psychic processes.)
+- **purpose.cfg** -- The mission. Role, objectives, domain scope, stakeholders, success criteria. YAML format. Configured per deployment -- the same soul can serve different purposes. (Aristotle: telos, the final cause.)
+- **shadow.log** -- The unconscious. Detected behavioral patterns, blind spots, therapy outcomes. YAML format. Auto-generated by diagnosis -- never manually edited. (Jung: the shadow, the patterns the agent cannot see about itself.)
 - **body.api** -- The physical interface contract. Morphology, modalities, safety envelope, hardware profile. JSON format. Swap it to move the same identity into a different body.
-- **conscience.exe** -- The moral authority. Deny/allow/escalate enforcement rules, hard limits, oversight mode. YAML format. Never auto-modified. Deny dominates in policy composition.
+- **conscience.exe** -- The moral authority. Deny/allow/escalate enforcement rules, hard limits, oversight mode. YAML format. Never auto-modified. Deny dominates in policy composition. (Freud: the superego.)
+- **ego.runtime** -- The mediator. Conflict resolution strategy, adaptation rate, emotional regulation, mediation rules. YAML format. Balances raw model output against conscience constraints at runtime. (Freud: the ego.)
 
 ## Quick Start
 
 ```bash
 npm install -g holomime
 
-# Initialize the 4-file identity stack
+# Initialize the 7-file identity stack
 holomime init-stack
 
 # Compile into .personality.json
@@ -99,7 +111,7 @@ Standards supported:
 
 The therapy loop is formally a behavioral feedback controller:
 
-- **Set point**: target personality (`soul.md` + `psyche.sys`)
+- **Set point**: target personality (`soul.md` + `mind.sys`)
 - **Sensor**: 14 drift detectors (11 cognitive + 3 embodied)
 - **Controller**: therapy engine with tunable PID-like gains
 - **Actuator**: DPO fine-tuning
@@ -126,7 +138,7 @@ Same soul. Different body. One command.
 # Move your agent from Figure 02 to Spot
 holomime embody --swap-body registry/bodies/spot.body.api
 
-# The soul, psyche, and conscience stay the same.
+# The soul, mind, and conscience stay the same.
 # Only the body layer changes — safety envelope, modalities, hardware profile.
 ```
 
@@ -148,7 +160,7 @@ Run it manually with `holomime session`, automatically with `holomime autopilot`
 
 11 rule-based detectors analyze real conversations without any LLM calls. 80+ behavioral signals total.
 
-**Cognitive (psyche layer):**
+**Cognitive (mind layer):**
 
 1. **Over-apologizing** -- Apology frequency above healthy range
 2. **Hedge stacking** -- 3+ hedging words per response
@@ -223,9 +235,12 @@ Auto-detects `.personality.json` in your workspace.
 
 The identity stack draws from three traditions:
 
-- **Soul** (Aristotle) -- the essence that makes a thing what it is. Immutable. Defines purpose and values.
-- **Psyche** (Jung) -- the totality of all psychic processes. Measurable, evolving, shaped by experience.
+- **Soul** (Aristotle) -- the essence that makes a thing what it is. Immutable. Defines values and ethics.
+- **Mind** (Jung) -- the totality of all psychic processes. Measurable, evolving, shaped by experience.
+- **Purpose** (Aristotle) -- telos, the final cause. What the agent is for. Configured per deployment.
+- **Shadow** (Jung) -- the patterns the agent cannot see about itself. Auto-generated by diagnosis.
 - **Conscience** (Freud) -- the superego. Internalized moral authority. Enforcement, not suggestion.
+- **Ego** (Freud) -- the mediator. Balances raw impulse against moral constraint at runtime.
 
 The **body** is the interface between identity and world. Same soul, different body -- a principle as old as philosophy itself.
 
@@ -235,4 +250,4 @@ We don't know if AI is sentient. But we can give it a conscience.
 
 MIT licensed. The identity stack is a standard, not a product. The standard is free. The training infrastructure is the business.
 
-See [LICENSE](LICENSE). Built by [Productstein](https://productstein.com). Documentation at [holomime.dev](https://holomime.dev).
+See [LICENSE](LICENSE). Built by [Productstein](https://productstein.com). Documentation at [holomime.com](https://holomime.com).