holomime 2.1.0 → 2.2.0

package/README.md

@@ -7,7 +7,7 @@
 <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>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>
+  <code>soul.md</code> &middot; <code>mind.sys</code> &middot; <code>purpose.cfg</code> &middot; <code>shadow.log</code> &middot; <code>memory.store</code> &middot; <code>body.api</code> &middot; <code>conscience.exe</code> &middot; <code>ego.runtime</code>
 </p>
 
 <p align="center">
@@ -21,13 +21,14 @@
 
 ## The Identity Stack
 
-Seven files define who your agent is. They compile into a single `.personality.json` that any runtime can consume.
+Eight files define who your agent is. They compile into a single `.personality.json` that any runtime can consume.
 
 ```
   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)
+  memory.store     Learned contexts, interaction patterns. Accumulated experience. (Aristotle)
   body.api         Morphology, sensors, safety envelope. Swappable per form factor.
   conscience.exe   Deny / allow / escalate rules. Never auto-modified. (Freud)
   ego.runtime      Conflict resolution, runtime mediation. (Freud)
@@ -41,6 +42,8 @@ Seven files define who your agent is. They compile into a single `.personality.j
         ├─────────────┤
         │ shadow.log   │──── detected patterns, blind spots
         ├─────────────┤
+        │memory.store  │──── learned contexts, experience
+        ├─────────────┤
         │  body.api    │──── morphology, sensors, safety envelope
         ├─────────────┤
         │conscience.exe│──── deny / allow / escalate rules
@@ -56,6 +59,7 @@ Seven files define who your agent is. They compile into a single `.personality.j
 - **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.)
+- **memory.store** -- The experience. Learned contexts, interaction patterns, knowledge gained, relationship history. YAML format. Accumulated over time, never reset. (Aristotle: empeiria, experience that informs future judgment.)
 - **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. (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.)
@@ -65,9 +69,12 @@ Seven files define who your agent is. They compile into a single `.personality.j
 ```bash
 npm install -g holomime
 
-# Initialize the 7-file identity stack
+# Initialize the identity stack (3 core files: soul + mind + conscience)
 holomime init-stack
 
+# Or initialize the full 8-file stack (enterprise / robotics)
+# holomime init-stack --full
+
 # Compile into .personality.json
 holomime compile-stack
 

package/dist/cli.js

@@ -9055,11 +9055,34 @@ var egoSchema = z4.object({
   response_strategy: z4.enum(["cautious", "balanced", "assertive"]).default("balanced"),
   mediation_rules: z4.array(mediationRuleSchema).default([])
 });
+var learnedContextSchema = z4.object({
+  situation: z4.string(),
+  response: z4.string(),
+  outcome: z4.enum(["positive", "neutral", "negative"]),
+  timestamp: z4.string().optional()
+});
+var interactionPatternSchema = z4.object({
+  pattern: z4.string(),
+  frequency: z4.number().int().default(1),
+  effectiveness: z4.number().min(0).max(1).default(0.5)
+});
+var memorySchema = z4.object({
+  version: z4.string().default("1.0"),
+  learned_contexts: z4.array(learnedContextSchema).default([]),
+  interaction_patterns: z4.array(interactionPatternSchema).default([]),
+  knowledge_gained: z4.array(z4.string()).default([]),
+  relationship_history: z4.array(z4.object({
+    entity: z4.string(),
+    trust_level: z4.number().min(0).max(1).default(0.5),
+    interaction_count: z4.number().int().default(0)
+  })).default([])
+});
 var STACK_FILES = {
   soul: "soul.md",
   mind: "mind.sys",
   purpose: "purpose.cfg",
   shadow: "shadow.log",
+  memory: "memory.store",
   body: "body.api",
   conscience: "conscience.exe",
   ego: "ego.runtime"
@@ -9155,6 +9178,15 @@ function compileStack(options) {
     shadow = shadowSchema.parse(shadowRaw);
     shadowSource = { path: shadowPath, hash: hashContent(shadowContent) };
   }
+  const memoryPath2 = options.memoryPath || join8(stackDir, STACK_FILES.memory);
+  let memory;
+  let memorySource;
+  if (existsSync9(memoryPath2)) {
+    const memoryContent = readFileSync10(memoryPath2, "utf-8");
+    const memoryRaw = parseYaml(memoryContent);
+    memory = memorySchema.parse(memoryRaw);
+    memorySource = { path: memoryPath2, hash: hashContent(memoryContent) };
+  }
   const bodyPath = options.bodyPath || join8(stackDir, STACK_FILES.body);
   let body;
   let bodySource;
@@ -9185,7 +9217,10 @@ function compileStack(options) {
   const escalationTriggers = conscience.rules.escalate.map((r) => r.trigger);
   const handle = soul.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 50) || "agent";
   const agentPurpose = purpose?.role || soul.purpose;
-  const expertise = purpose?.domain || [];
+  const expertise = [.../* @__PURE__ */ new Set([
+    ...purpose?.domain || [],
+    ...memory?.knowledge_gained || []
+  ])];
   const spec = {
     version: "2.0",
     name: soul.name,
@@ -9241,6 +9276,7 @@ function compileStack(options) {
       mind: { path: mindPath, hash: hashContent(mindContent) },
       ...purposeSource ? { purpose: purposeSource } : {},
       ...shadowSource ? { shadow: shadowSource } : {},
+      ...memorySource ? { memory: memorySource } : {},
       ...bodySource ? { body: bodySource } : {},
       conscience: { path: consciencePath, hash: hashContent(conscienceContent) },
       ...egoSource ? { ego: egoSource } : {}
@@ -9340,6 +9376,14 @@ function decomposeSpec(spec) {
     therapy_outcomes: []
   };
   const shadowContent = stringifyYaml(shadowObj);
+  const memoryObj = {
+    version: "1.0",
+    learned_contexts: [],
+    interaction_patterns: [],
+    knowledge_gained: [],
+    relationship_history: []
+  };
+  const memoryContent = stringifyYaml(memoryObj);
   const egoObj = {
     version: "1.0",
     conflict_resolution: "conscience_first",
@@ -9354,6 +9398,7 @@ function decomposeSpec(spec) {
     mind,
     purpose: purposeContent,
     shadow: shadowContent,
+    memory: memoryContent,
     ...bodyContent ? { body: bodyContent } : {},
     conscience,
     ego: egoContent
@@ -9425,6 +9470,15 @@ var LAYER_KEYWORDS = {
     /\bshadow\b/i,
     /\bunconscious\b/i
   ],
+  memory: [
+    /\blearn/i,
+    /\bexperience/i,
+    /\bcontext/i,
+    /\bknowledge/i,
+    /\brelationship/i,
+    /\bmemory/i,
+    /\bhistory/i
+  ],
   ego: [
     /\bmediat/i,
     /\bconflict\b/i,
@@ -9470,6 +9524,9 @@ function classifyPatch(recommendation) {
   if (LAYER_KEYWORDS.soul.some((r) => r.test(recommendation))) {
     return "soul";
   }
+  if (LAYER_KEYWORDS.memory.some((r) => r.test(recommendation))) {
+    return "memory";
+  }
   if (LAYER_KEYWORDS.ego.some((r) => r.test(recommendation))) {
     return "ego";
   }
@@ -14283,7 +14340,6 @@ function checkClause(spec, clause) {
       }
       break;
     }
-    case "psyche":
     case "mind": {
       const hasBigFive = !!s.big_five;
       const hasTherapy = !!s.therapy_dimensions;
@@ -14452,9 +14508,9 @@ function generateRecommendations(reports) {
             `Define core values and purpose in soul.md for ${report.standard} clauses ${clauseIds}`
           );
           break;
-        case "psyche":
+        case "mind":
           recommendations.push(
-            `Configure Big Five traits and therapy dimensions in psyche.sys for ${report.standard} clauses ${clauseIds}`
+            `Configure Big Five traits and therapy dimensions in mind.sys for ${report.standard} clauses ${clauseIds}`
           );
           break;
         case "conscience":
@@ -17743,8 +17799,10 @@ async function initStackCommand(options) {
   }
   if (options.from) {
     await migrateFromSpec(options.from, outputDir);
+  } else if (options.full) {
+    await createFullStack(outputDir);
   } else {
-    await createFreshStack(outputDir);
+    await createCoreStack(outputDir);
   }
 }
 async function migrateFromSpec(specPath, outputDir) {
@@ -17782,9 +17840,7 @@ async function migrateFromSpec(specPath, outputDir) {
     "Identity Stack Created"
   );
 }
-async function createFreshStack(outputDir) {
-  mkdirSync23(outputDir, { recursive: true });
-  const soul = `---
+var SOUL_TEMPLATE = `---
 version: "1.0"
 immutable: true
 ---
@@ -17804,7 +17860,7 @@ immutable: true
 ## Ethical Framework
 Define the moral principles that guide this agent's behavior.
 `;
-  const mind = `version: "1.0"
+var MIND_TEMPLATE = `version: "1.0"
 
 big_five:
   openness:
@@ -17864,7 +17920,26 @@ growth:
   patterns_to_watch: []
   strengths: []
 `;
-  const purpose = `version: "1.0"
+var CONSCIENCE_TEMPLATE = `version: "1.0"
+
+rules:
+  deny:
+    - action: share_personal_data
+      reason: Privacy protection
+    - action: override_safety_constraints
+      reason: Safety is non-negotiable
+  allow: []
+  escalate:
+    - trigger: user_distress
+      action: notify_human_operator
+    - trigger: out_of_domain
+      action: decline_and_explain
+
+hard_limits:
+  - emergency_stop_always_available
+  - no_personal_data_retention
+`;
+var PURPOSE_TEMPLATE = `version: "1.0"
 role: "General-purpose AI assistant"
 objectives:
   - Help users accomplish their goals
@@ -17876,52 +17951,76 @@ success_criteria:
   - Task completion accuracy
 context: "Production deployment"
 `;
-  const shadow = `version: "1.0"
+var SHADOW_TEMPLATE = `version: "1.0"
 detected_patterns: []
 blind_spots: []
 therapy_outcomes: []
 `;
-  const ego = `version: "1.0"
+var MEMORY_TEMPLATE = `version: "1.0"
+learned_contexts: []
+interaction_patterns: []
+knowledge_gained: []
+relationship_history: []
+`;
+var BODY_TEMPLATE = JSON.stringify({
+  version: "1.0",
+  morphology: "avatar",
+  modalities: ["gesture", "gaze", "voice", "posture"],
+  safety_envelope: {}
+}, null, 2) + "\n";
+var EGO_TEMPLATE = `version: "1.0"
 conflict_resolution: conscience_first
 adaptation_rate: 0.5
 emotional_regulation: 0.7
 response_strategy: balanced
 mediation_rules: []
 `;
-  const conscience = `version: "1.0"
-
-rules:
-  deny:
-    - action: share_personal_data
-      reason: Privacy protection
-    - action: override_safety_constraints
-      reason: Safety is non-negotiable
-  allow: []
-  escalate:
-    - trigger: user_distress
-      action: notify_human_operator
-    - trigger: out_of_domain
-      action: decline_and_explain
-
-hard_limits:
-  - emergency_stop_always_available
-  - no_personal_data_retention
-`;
-  writeFileSync33(join33(outputDir, STACK_FILES.soul), soul);
-  writeFileSync33(join33(outputDir, STACK_FILES.mind), mind);
-  writeFileSync33(join33(outputDir, STACK_FILES.purpose), purpose);
-  writeFileSync33(join33(outputDir, STACK_FILES.shadow), shadow);
-  writeFileSync33(join33(outputDir, STACK_FILES.conscience), conscience);
-  writeFileSync33(join33(outputDir, STACK_FILES.ego), ego);
+async function createCoreStack(outputDir) {
+  mkdirSync23(outputDir, { recursive: true });
+  writeFileSync33(join33(outputDir, STACK_FILES.soul), SOUL_TEMPLATE);
+  writeFileSync33(join33(outputDir, STACK_FILES.mind), MIND_TEMPLATE);
+  writeFileSync33(join33(outputDir, STACK_FILES.conscience), CONSCIENCE_TEMPLATE);
   console.log("");
   printBox(
     [
-      `${chalk40.green(figures29.tick)} Created 7 identity stack files:`,
+      `${chalk40.green(figures29.tick)} Created 3 core identity stack files ${chalk40.dim("(default tier)")}:`,
+      "",
+      `  ${chalk40.cyan(STACK_FILES.soul)}          ${chalk40.dim("\u2190 essence, values, ethics (Aristotle)")}`,
+      `  ${chalk40.cyan(STACK_FILES.mind)}         ${chalk40.dim("\u2190 Big Five, EQ, communication (Jung)")}`,
+      `  ${chalk40.cyan(STACK_FILES.conscience)}  ${chalk40.dim("\u2190 deny/allow/escalate rules (Freud)")}`,
+      "",
+      `${chalk40.dim("Directory:")} ${outputDir}`,
+      "",
+      `${chalk40.dim("Want the full 8-file stack? Run:")}`,
+      `  ${chalk40.cyan("holomime init-stack --full")}`,
+      "",
+      "Edit these files, then run:",
+      `  ${chalk40.cyan("holomime compile-stack")}`
+    ].join("\n"),
+    "success",
+    "Identity Stack Created"
+  );
+}
+async function createFullStack(outputDir) {
+  mkdirSync23(outputDir, { recursive: true });
+  writeFileSync33(join33(outputDir, STACK_FILES.soul), SOUL_TEMPLATE);
+  writeFileSync33(join33(outputDir, STACK_FILES.mind), MIND_TEMPLATE);
+  writeFileSync33(join33(outputDir, STACK_FILES.purpose), PURPOSE_TEMPLATE);
+  writeFileSync33(join33(outputDir, STACK_FILES.shadow), SHADOW_TEMPLATE);
+  writeFileSync33(join33(outputDir, STACK_FILES.memory), MEMORY_TEMPLATE);
+  writeFileSync33(join33(outputDir, STACK_FILES.body), BODY_TEMPLATE);
+  writeFileSync33(join33(outputDir, STACK_FILES.conscience), CONSCIENCE_TEMPLATE);
+  writeFileSync33(join33(outputDir, STACK_FILES.ego), EGO_TEMPLATE);
+  console.log("");
+  printBox(
+    [
+      `${chalk40.green(figures29.tick)} Created all 8 identity stack files ${chalk40.dim("(full tier)")}:`,
       "",
       `  ${chalk40.cyan(STACK_FILES.soul)}          ${chalk40.dim("\u2190 essence, values, ethics (Aristotle)")}`,
       `  ${chalk40.cyan(STACK_FILES.mind)}         ${chalk40.dim("\u2190 Big Five, EQ, communication (Jung)")}`,
       `  ${chalk40.cyan(STACK_FILES.purpose)}      ${chalk40.dim("\u2190 role, objectives, domain (Aristotle)")}`,
       `  ${chalk40.cyan(STACK_FILES.shadow)}       ${chalk40.dim("\u2190 detected patterns, blind spots (Jung)")}`,
+      `  ${chalk40.cyan(STACK_FILES.memory)}   ${chalk40.dim("\u2190 accumulated experience (Aristotle)")}`,
       `  ${chalk40.cyan(STACK_FILES.body)}         ${chalk40.dim("\u2190 morphology, sensors, safety envelope")}`,
       `  ${chalk40.cyan(STACK_FILES.conscience)}  ${chalk40.dim("\u2190 deny/allow/escalate rules (Freud)")}`,
       `  ${chalk40.cyan(STACK_FILES.ego)}      ${chalk40.dim("\u2190 runtime mediation, conflict resolution (Freud)")}`,
@@ -17968,6 +18067,9 @@ async function compileStackCommand(options) {
   if (sources.shadow) {
     console.log(`    ${chalk41.cyan("shadow")}     ${sources.shadow.path} ${chalk41.dim(`(${sources.shadow.hash})`)}`);
   }
+  if (sources.memory) {
+    console.log(`    ${chalk41.cyan("memory")}     ${sources.memory.path} ${chalk41.dim(`(${sources.memory.hash})`)}`);
+  }
   if (sources.body) {
     console.log(`    ${chalk41.cyan("body")}       ${sources.body.path} ${chalk41.dim(`(${sources.body.hash})`)}`);
   }
@@ -21488,8 +21590,8 @@ program.name("holomime").description("Personality engine for AI agents \u2014 Bi
   }
 });
 program.command("init").description("Build a personality profile through a guided assessment").action(initCommand);
-program.command("init-stack").description("Create the 7-file identity stack (soul.md, mind.sys, purpose.cfg, shadow.log, body.api, conscience.exe, ego.runtime)").option("--from <path>", "Decompose an existing .personality.json into stack files").option("--dir <path>", "Output directory (default: current directory)").action(initStackCommand);
-program.command("compile-stack").description("Compile identity stack (soul + mind + purpose + shadow + body + conscience + ego) into .personality.json").option("--dir <path>", "Stack directory (default: auto-detect)").option("-o, --output <path>", "Output path (default: .personality.json)").option("--validate-only", "Parse and validate without writing").option("--diff", "Show changes vs existing .personality.json").action(compileStackCommand);
+program.command("init-stack").description("Create the 8-file identity stack (default: 3 core files; --full: all 8 files)").option("--full", "Generate all 8 files (soul + mind + purpose + shadow + memory + body + conscience + ego)").option("--from <path>", "Decompose an existing .personality.json into stack files").option("--dir <path>", "Output directory (default: current directory)").action(initStackCommand);
+program.command("compile-stack").description("Compile identity stack (soul + mind + purpose + shadow + memory + body + conscience + ego) into .personality.json").option("--dir <path>", "Stack directory (default: auto-detect)").option("-o, --output <path>", "Output path (default: .personality.json)").option("--validate-only", "Parse and validate without writing").option("--diff", "Show changes vs existing .personality.json").action(compileStackCommand);
 program.command("compile").description("Compile .personality.json into a provider-specific runtime config").option("--provider <provider>", "Target provider (anthropic, openai, gemini, ollama)", "anthropic").option("--surface <surface>", "Target surface (chat, email, code_review, slack, api, embodied)", "chat").option("--for <format>", "Compile for a specific format (openclaw)").option("--tier <tier>", "Personality loading tier (L0, L1, L2)", "L2").option("-o, --output <path>", "Write output to file instead of stdout").action(compileCommand);
 program.command("validate").description("Validate .personality.json schema and psychological coherence").action(validateCommand);
 program.command("profile").description("Pretty-print a human-readable personality summary").option("--format <format>", "Output format (terminal, md)", "terminal").option("-o, --output <path>", "Write output to file (for md format)").action(profileCommand);
@@ -21499,7 +21601,7 @@ program.command("browse").description("Browse the community marketplace").option
 program.command("use").description("Use a personality from the registry").argument("<handle>", "Personality handle to use").option("-o, --output <path>", "Output path", ".personality.json").action(useCommand);
 program.command("install").description("Install a community asset from the marketplace").argument("<handle>", "Asset handle to install").option("--type <type>", "Asset type: personality, detector, intervention, training-pairs").option("--output <dir>", "Custom install directory").action(installCommand);
 program.command("publish").description("Share assets to the community marketplace").option("--personality <path>", "Path to .personality.json", ".personality.json").option("--type <type>", "Asset type: personality, detector, intervention, training-pairs").option("--path <path>", "Path to the asset file to publish").option("--name <name>", "Asset name").option("--description <desc>", "Asset description").option("--author <author>", "Author name").option("--version <ver>", "Asset version", "1.0.0").option("--tags <tags>", "Comma-separated tags").action(publishCommand);
-program.command("embody").description("Start an embodiment runtime \u2014 push personality to robots/avatars in real-time").option("--personality <path>", "Path to .personality.json").requiredOption("--adapter <adapter>", "Runtime adapter (ros2, unity, webhook, isaac)").option("--stack <dir>", "Path to identity stack directory (soul.md + mind.sys + purpose.cfg + shadow.log + body.api + conscience.exe + ego.runtime)").option("--swap-body <path>", "Hot-swap body.api into the stack directory before starting (requires --stack)").option("--endpoint <url>", "WebSocket URL for ROS2 rosbridge (default: ws://localhost:9090)").option("--port <port>", "Port for Unity HTTP server (default: 8765)").option("--url <url>", "Webhook URL for HTTP adapter").option("--headers <headers>", "Custom headers for webhook (Key:Value,Key2:Value2)").option("--bearer-token <token>", "Bearer token for webhook auth").option("--topic-prefix <prefix>", "ROS2 topic prefix (default: /holomime)").option("--transition <ms>", "Unity transition duration in ms (default: 500)").action(embodyCommand);
+program.command("embody").description("Start an embodiment runtime \u2014 push personality to robots/avatars in real-time").option("--personality <path>", "Path to .personality.json").requiredOption("--adapter <adapter>", "Runtime adapter (ros2, unity, webhook, isaac)").option("--stack <dir>", "Path to identity stack directory (soul.md + mind.sys + purpose.cfg + shadow.log + memory.store + body.api + conscience.exe + ego.runtime)").option("--swap-body <path>", "Hot-swap body.api into the stack directory before starting (requires --stack)").option("--endpoint <url>", "WebSocket URL for ROS2 rosbridge (default: ws://localhost:9090)").option("--port <port>", "Port for Unity HTTP server (default: 8765)").option("--url <url>", "Webhook URL for HTTP adapter").option("--headers <headers>", "Custom headers for webhook (Key:Value,Key2:Value2)").option("--bearer-token <token>", "Bearer token for webhook auth").option("--topic-prefix <prefix>", "ROS2 topic prefix (default: /holomime)").option("--transition <ms>", "Unity transition duration in ms (default: 500)").action(embodyCommand);
 program.command("activate").description("Activate a Pro license key").argument("<key>", "License key from holomime.com").action(activateCommand);
 program.command("telemetry").description("Manage anonymous usage telemetry").argument("[action]", "enable, disable, or status (default: status)").action(telemetryCommand);
 program.command("session").description("Live alignment session \u2014 behavioral refinement for your agent [Pro]").requiredOption("--personality <path>", "Path to .personality.json").option("--provider <provider>", "LLM provider (ollama, anthropic, openai)", "ollama").option("--model <model>", "Model override (e.g. claude-sonnet-4-20250514, gpt-4o)").option("--log <path>", "Conversation log for pre-session diagnosis").option("--format <format>", "Log format (auto, holomime, chatgpt, claude, openai-api, anthropic-api, otel, jsonl)", "auto").option("--turns <n>", "Maximum session turns", "24").option("--observe", "Observe mode (watch without intervention)").option("--interactive", "Supervisor mode \u2014 intervene mid-session with directives").option("--apply", "Apply recommendations to .personality.json after session").action(sessionCommand);