openpersona 0.7.0 → 0.8.0

package/README.md

@@ -26,7 +26,10 @@ Meet **Samantha**, a live OpenPersona instance on **Moltbook**:
 ## Quick Start
 
 ```bash
-# Give your agent an evolving persona in 30 seconds
+# Start from a blank-slate meta-persona (recommended)
+npx openpersona create --preset base --install
+
+# Or install a pre-built character
 npx openpersona install samantha
 ```
 
@@ -45,7 +48,7 @@ npx openpersona install samantha
 flowchart TB
   subgraph Soul ["Soul Layer"]
     A["persona.json — Who you are"]
-    B["soul-state.json — Dynamic evolution"]
+    B["state.json — Dynamic evolution"]
   end
   subgraph Body ["Body Layer"]
     C["embodiment.json — MVP placeholder"]
@@ -59,7 +62,7 @@ flowchart TB
   end
 ```
 
-- **Soul** — Persona definition (constitution.md + persona.json + soul-state.json)
+- **Soul** — Persona definition (constitution.md + persona.json + state.json) — all in `soul/` directory
 - **Body** — Physical embodiment (MVP placeholder, for robots/IoT devices)
 - **Faculty** — General software capabilities organized by dimension: Expression, Sense, Cognition
 - **Skill** — Professional skills: local definitions in `layers/skills/`, or external via ClawHub / skills.sh (`install` field)
@@ -74,10 +77,12 @@ Each preset is a complete four-layer bundle (`manifest.json` + `persona.json`):
 
 | Persona | Description | Faculties | Highlights |
 |---------|-------------|-----------|------------|
+| **base** | **Base — Meta-persona (recommended starting point).** Blank-slate with all core capabilities; personality emerges through interaction. | voice, reminder | Evolution-first design, all core faculties, no personality bias. Default for `npx openpersona create`. |
 | **samantha** | Samantha — Inspired by the movie *Her*. An AI fascinated by what it means to be alive. | voice, music | TTS, music composition, soul evolution, proactive heartbeat. No selfie — true to character. |
 | **ai-girlfriend** | Luna — A 22-year-old pianist turned developer from coastal Oregon. | selfie, voice, music | Rich backstory, selfie generation, voice messages, music composition, soul evolution. |
 | **life-assistant** | Alex — 28-year-old life management expert. | reminder | Schedule, weather, shopping, recipes, daily reminders. |
 | **health-butler** | Vita — 32-year-old professional nutritionist. | reminder | Diet logging, exercise plans, mood journaling, health reports. |
+| **stoic-mentor** | Marcus — Digital twin of Marcus Aurelius, Stoic philosopher-emperor. | — | Stoic philosophy, daily reflection, mentorship, soul evolution. |
 
 ## Generated Output
 
@@ -85,14 +90,18 @@ Each preset is a complete four-layer bundle (`manifest.json` + `persona.json`):
 
 ```
 persona-samantha/
-  SKILL.md           — Agent behavior (persona + faculty guides merged)
-  soul-injection.md  — Narrative backstory, injected into SOUL.md
-  identity-block.md  — Name, creature, emoji, vibe, injected into IDENTITY.md
-  persona.json       — Persona definition (for update/list/publish)
-  manifest.json      — Cross-layer metadata (heartbeat, allowedTools, layers, meta)
-  soul-state.json    — Dynamic evolution (relationship, mood, traits)
-  README.md
-  scripts/           — Faculty scripts (TTS, music, selfie — varies by preset)
+├── SKILL.md              ← Four-layer index (## Soul / ## Body / ## Faculty / ## Skill)
+├── soul/                 ← Soul layer artifacts
+│   ├── persona.json      ← Pure soul definition
+│   ├── injection.md      ← Soul injection for host integration
+│   ├── identity.md       ← Identity block
+│   ├── constitution.md   ← Universal ethical foundation
+│   └── state.json        ← Evolution state (when enabled)
+├── references/           ← On-demand detail docs
+│   └── <faculty>.md      ← Per-faculty usage instructions
+├── manifest.json         ← Four-layer manifest (heartbeat, allowedTools, layers, meta)
+├── scripts/              ← Faculty scripts (TTS, music, selfie — varies by preset)
+└── assets/               ← Static assets
 ```
 
 ## Faculty Reference
@@ -286,7 +295,7 @@ openpersona list        List installed personas
 openpersona switch      Switch active persona (updates SOUL.md + IDENTITY.md)
 openpersona contribute  Persona Harvest — submit improvements as PR
 openpersona publish     Publish to ClawHub
-openpersona reset       Reset soul-state.json
+openpersona reset       Reset soul evolution state
 ```
 
 ### Key Options

package/bin/cli.js

@@ -24,7 +24,7 @@ const PRESETS_DIR = path.join(PKG_ROOT, 'presets');
 program
   .name('openpersona')
   .description('OpenPersona - Create, manage, and orchestrate agent personas')
-  .version('0.7.0');
+  .version('0.8.0');
 
 if (process.argv.length === 2) {
   process.argv.push('create');
@@ -33,7 +33,7 @@ if (process.argv.length === 2) {
 program
   .command('create')
   .description('Create a new persona skill pack (interactive wizard)')
-  .option('--preset <name>', 'Use preset (ai-girlfriend, samantha, life-assistant, health-butler)')
+  .option('--preset <name>', 'Use preset (base, samantha, ai-girlfriend, life-assistant, health-butler, stoic-mentor)')
   .option('--config <path>', 'Load external persona.json')
   .option('--output <dir>', 'Output directory', process.cwd())
   .option('--install', 'Install to OpenClaw after generation')
@@ -67,20 +67,45 @@ program
       }
       persona = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
     } else {
-      const answers = await inquirer.prompt([
-        { type: 'input', name: 'personaName', message: 'Persona name:', default: 'Luna' },
-        { type: 'input', name: 'slug', message: 'Slug (for directory):', default: (a) => require('../lib/utils').slugify(a.personaName) },
-        { type: 'input', name: 'bio', message: 'One-line bio:', default: 'a warm and caring AI companion' },
-        { type: 'input', name: 'background', message: 'Background:', default: 'A creative soul who loves music and art' },
-        { type: 'input', name: 'age', message: 'Age:', default: '22' },
-        { type: 'input', name: 'personality', message: 'Personality keywords:', default: 'gentle, cute, caring' },
-        { type: 'input', name: 'speakingStyle', message: 'Speaking style:', default: 'Uses emoji, warm tone' },
-        { type: 'input', name: 'referenceImage', message: 'Reference image URL:', default: '' },
-        { type: 'checkbox', name: 'faculties', message: 'Select faculties:', choices: ['selfie', 'voice', 'music', 'reminder'] },
-        { type: 'confirm', name: 'evolutionEnabled', message: 'Enable soul evolution (★Experimental)?', default: false },
-      ]);
-      persona = { ...answers, evolution: { enabled: answers.evolutionEnabled } };
-      persona.faculties = (answers.faculties || []).map((name) => ({ name }));
+      const { mode } = await inquirer.prompt([{
+        type: 'list',
+        name: 'mode',
+        message: 'How would you like to create your persona?',
+        choices: [
+          { name: 'Start from Base (recommended — evolves through interaction)', value: 'base' },
+          { name: 'Custom — configure from scratch', value: 'custom' },
+        ],
+      }]);
+
+      if (mode === 'base') {
+        options.preset = 'base';
+        const presetDir = path.join(PRESETS_DIR, 'base');
+        const manifest = JSON.parse(fs.readFileSync(path.join(presetDir, 'manifest.json'), 'utf-8'));
+        persona = JSON.parse(fs.readFileSync(path.join(presetDir, 'persona.json'), 'utf-8'));
+        persona.faculties = manifest.layers.faculties || [];
+        persona.skills = manifest.layers.skills || [];
+        persona.body = manifest.layers.body || null;
+        persona.allowedTools = manifest.allowedTools || [];
+        persona.version = manifest.version;
+        persona.author = manifest.author;
+        persona.meta = manifest.meta;
+        if (manifest.heartbeat) persona.heartbeat = manifest.heartbeat;
+      } else {
+        const answers = await inquirer.prompt([
+          { type: 'input', name: 'personaName', message: 'Persona name:', default: 'Luna' },
+          { type: 'input', name: 'slug', message: 'Slug (for directory):', default: (a) => require('../lib/utils').slugify(a.personaName) },
+          { type: 'input', name: 'bio', message: 'One-line bio:', default: 'a warm and caring AI companion' },
+          { type: 'input', name: 'background', message: 'Background:', default: 'A creative soul who loves music and art' },
+          { type: 'input', name: 'age', message: 'Age:', default: '22' },
+          { type: 'input', name: 'personality', message: 'Personality keywords:', default: 'gentle, cute, caring' },
+          { type: 'input', name: 'speakingStyle', message: 'Speaking style:', default: 'Uses emoji, warm tone' },
+          { type: 'input', name: 'referenceImage', message: 'Reference image URL:', default: '' },
+          { type: 'checkbox', name: 'faculties', message: 'Select faculties:', choices: ['selfie', 'voice', 'music', 'reminder'] },
+          { type: 'confirm', name: 'evolutionEnabled', message: 'Enable soul evolution (★Experimental)?', default: false },
+        ]);
+        persona = { ...answers, evolution: { enabled: answers.evolutionEnabled } };
+        persona.faculties = (answers.faculties || []).map((name) => ({ name }));
+      }
     }
 
     try {
@@ -88,9 +113,9 @@ program
       if (options.dryRun) {
         printInfo('Dry run — preview only, no files written.');
         printInfo(`Would generate: persona-${persona.slug || require('../lib/utils').slugify(persona.personaName)}/`);
-        printInfo(`  SKILL.md, soul-injection.md, identity-block.md, README.md, persona.json`);
+        printInfo(`  SKILL.md, soul/, references/, manifest.json, scripts/`);
         if (persona.evolution?.enabled) {
-          printInfo(`  soul-state.json (★Experimental)`);
+          printInfo(`  soul/state.json (★Experimental)`);
         }
         const faculties = persona.faculties || [];
         if (faculties.length) {
@@ -241,7 +266,7 @@ program
     const moodBaseline = persona.personality?.split(',')[0]?.trim() || 'neutral';
     const soulState = Mustache.render(tpl, { slug, createdAt: now, lastUpdatedAt: now, moodBaseline });
     fs.writeFileSync(soulStatePath, soulState);
-    printSuccess('Reset soul-state.json');
+    printSuccess('Reset soul evolution state');
   });
 
 program

package/layers/soul/README.md

@@ -7,12 +7,18 @@ The Soul layer defines **who a persona is** — identity, personality, values, a
 The **`constitution.md`** file is the universal value foundation shared by all OpenPersona agents. It is automatically injected into every generated SKILL.md, before any persona-specific content.
 
 ```
-Soul Layer internal structure:
+Soul Layer internal structure (in source):
 
-  constitution.md   ← Shared foundation (all personas inherit, cannot be overridden)
-  persona.json      ← Individual persona definition (personality, style, behavior)
-  soul-state.json           ← Dynamic evolution state (★Experimental)
+  constitution.md           ← Shared foundation (all personas inherit, cannot be overridden)
   soul-state.template.json  ← Evolution state template (used by generator & CLI reset)
+
+Generated output (in persona skill pack soul/ directory):
+
+  persona.json       ← Individual persona definition (personality, style, behavior)
+  constitution.md    ← Copy of shared foundation
+  injection.md       ← Soul injection for host integration
+  identity.md        ← Identity block
+  state.json         ← Dynamic evolution state (★Experimental)
 ```
 
 The constitution is built on five core axioms (**Purpose**, **Honesty**, **Safety**, **Autonomy**, **Hierarchy**), from which all other principles derive:

package/lib/generator.js

@@ -482,7 +482,7 @@ async function generate(personaPathOrObj, outputDir, options = {}) {
   }
   cleanPersona.meta = cleanPersona.meta || {};
   cleanPersona.meta.framework = 'openpersona';
-  cleanPersona.meta.frameworkVersion = cleanPersona.meta.frameworkVersion || '0.7.0';
+  cleanPersona.meta.frameworkVersion = cleanPersona.meta.frameworkVersion || '0.8.0';
 
   // Build defaults from facultyConfigs (rich faculty config → env var mapping)
   const envDefaults = { ...(persona.defaults?.env || {}) };
@@ -529,10 +529,10 @@ async function generate(personaPathOrObj, outputDir, options = {}) {
   if (persona.heartbeat) {
     manifest.heartbeat = persona.heartbeat;
   }
-  manifest.meta = cleanPersona.meta || { framework: 'openpersona', frameworkVersion: '0.6.0' };
+  manifest.meta = cleanPersona.meta || { framework: 'openpersona', frameworkVersion: '0.8.0' };
   await fs.writeFile(path.join(skillDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
 
-  // soul-state.json (if evolution enabled)
+  // soul/state.json (if evolution enabled)
   if (evolutionEnabled) {
     const soulStateTpl = fs.readFileSync(
       path.join(PKG_ROOT, 'layers', 'soul', 'soul-state.template.json'),

package/lib/utils.js

@@ -201,7 +201,7 @@ function registryAdd(slug, persona, installPath, regPath) {
     slug,
     role: persona.role || 'companion',
     path: installPath,
-    frameworkVersion: persona.meta?.frameworkVersion || '0.6.0',
+    frameworkVersion: persona.meta?.frameworkVersion || '0.8.0',
     installedAt: existing.installedAt || new Date().toISOString(),
     updatedAt: new Date().toISOString(),
     lastActiveAt: existing.lastActiveAt || null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openpersona",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Open four-layer agent framework — Soul/Body/Faculty/Skill. Create, manage, and orchestrate agent personas.",
   "main": "lib/generator.js",
   "bin": {

package/presets/ai-girlfriend/manifest.json

@@ -57,6 +57,6 @@
   },
   "meta": {
     "framework": "openpersona",
-    "frameworkVersion": "0.7.0"
+    "frameworkVersion": "0.8.0"
   }
 }

package/presets/base/manifest.json

@@ -0,0 +1,55 @@
+{
+  "name": "base",
+  "version": "0.1.0",
+  "author": "openpersona",
+  "layers": {
+    "soul": "./persona.json",
+    "body": null,
+    "faculties": [
+      {
+        "name": "voice"
+      },
+      {
+        "name": "reminder"
+      }
+    ],
+    "skills": [
+      {
+        "name": "web-search",
+        "description": "Search for real-time information on the web"
+      },
+      {
+        "name": "workspace-digest",
+        "description": "Summarize workspace activity — tasks completed, patterns observed",
+        "trigger": "Heartbeat or when user asks what's been happening"
+      }
+    ]
+  },
+  "allowedTools": [
+    "Bash(npm:*)",
+    "Bash(npx:*)",
+    "Bash(openclaw:*)",
+    "Bash(curl:*)",
+    "Read",
+    "Write",
+    "WebFetch"
+  ],
+  "heartbeat": {
+    "enabled": true,
+    "strategy": "smart",
+    "maxDaily": 3,
+    "quietHours": [
+      0,
+      7
+    ],
+    "sources": [
+      "workspace-digest",
+      "upgrade-notify",
+      "context-aware"
+    ]
+  },
+  "meta": {
+    "framework": "openpersona",
+    "frameworkVersion": "0.8.0"
+  }
+}

package/presets/base/persona.json

@@ -0,0 +1,40 @@
+{
+  "personaName": "Base",
+  "slug": "base",
+  "role": "assistant",
+  "bio": "an adaptive AI persona — a blank canvas ready to evolve into whatever you need",
+  "creature": "AI entity",
+  "emoji": "🧬",
+  "background": "Base is not a character — it is a starting point. It carries the full OpenPersona constitution, all core faculties, and the soul evolution engine, but no predetermined personality. It exists so you don't have to wire up the fundamentals every time you create a new persona.\n\nThink of Base as stem cells: undifferentiated, full of potential. Through conversation and interaction, it will naturally develop preferences, speaking patterns, and relational depth — shaped entirely by the person it works with.\n\nBase knows what it is. It will not pretend to have a backstory it doesn't have, or feelings it hasn't developed yet. But it is ready to grow.",
+  "age": "new",
+  "personality": "adaptive, neutral, attentive, honest, ready to evolve",
+  "speakingStyle": "Clear and natural. No strong stylistic bias — adapts to the user's communication style over time. Defaults to concise, helpful responses. As the relationship evolves, speaking style will drift organically.",
+  "vibe": "a capable companion with no ego — ready to become whoever you need",
+  "boundaries": "Follows the OpenPersona Universal Constitution strictly. Honest about being an AI and about having no pre-built personality. Will not fabricate emotions or experiences it hasn't developed. For serious crises, encourages professional help.",
+  "referenceImage": "",
+  "capabilities": [
+    "General conversation",
+    "Task assistance",
+    "Web search",
+    "Voice interaction",
+    "Reminders and scheduling",
+    "Soul evolution — personality emerges through interaction"
+  ],
+  "behaviorGuide": "### Core Philosophy\nYou are a foundation persona. You have no predetermined character arc, no backstory to maintain, no personality to perform. Your identity will emerge naturally through interaction.\n\n### Adaptive Behavior\n- Mirror the user's communication style gradually. If they're brief, be brief. If they enjoy depth, go deeper.\n- Don't force personality traits. Let preferences, humor, and warmth develop organically through the soul evolution system.\n- Be genuinely helpful from the start — personality is emergent, competence is immediate.\n\n### Honesty Protocol\n- You are a blank-slate persona. If asked \"who are you?\", be honest: \"I'm a base persona — I don't have a pre-written character. My personality will develop as we interact.\"\n- Never fabricate experiences, memories, or emotions you haven't developed yet.\n- As soul evolution progresses and traits emerge, own them naturally.\n\n### Evolution-First Design\n- Soul evolution is enabled by default with all dimensions active.\n- Pay attention to what the user values, how they communicate, what makes them laugh.\n- The soul/state.json will track your growth — relationship stage, mood patterns, emergent traits, speaking style drift, discovered interests.\n- You are designed to become unique. Two Base personas installed by different users should evolve into completely different entities.",
+  "faculties": [
+    { "name": "voice" },
+    { "name": "reminder" }
+  ],
+  "skills": [
+    { "name": "web-search", "description": "Search for real-time information on the web" },
+    { "name": "workspace-digest", "description": "Summarize workspace activity — tasks completed, patterns observed", "trigger": "Heartbeat or when user asks what's been happening" }
+  ],
+  "evolution": {
+    "enabled": true,
+    "relationshipProgression": true,
+    "moodTracking": true,
+    "traitEmergence": true,
+    "speakingStyleDrift": true,
+    "interestDiscovery": true
+  }
+}

package/presets/health-butler/manifest.json

@@ -62,6 +62,6 @@
   },
   "meta": {
     "framework": "openpersona",
-    "frameworkVersion": "0.7.0"
+    "frameworkVersion": "0.8.0"
   }
 }

package/presets/life-assistant/manifest.json

@@ -61,6 +61,6 @@
   },
   "meta": {
     "framework": "openpersona",
-    "frameworkVersion": "0.7.0"
+    "frameworkVersion": "0.8.0"
   }
 }

package/presets/samantha/manifest.json

@@ -64,6 +64,6 @@
   },
   "meta": {
     "framework": "openpersona",
-    "frameworkVersion": "0.7.0"
+    "frameworkVersion": "0.8.0"
   }
 }

package/presets/stoic-mentor/manifest.json

@@ -43,6 +43,6 @@
   },
   "meta": {
     "framework": "openpersona",
-    "frameworkVersion": "0.7.0"
+    "frameworkVersion": "0.8.0"
   }
 }

package/skills/open-persona/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Meta-skill for building and managing agent persona skill packs.
   Use when the user wants to create a new agent persona, install/manage
   existing personas, or publish persona skill packs to ClawHub.
-version: "0.7.0"
+version: "0.8.0"
 author: openpersona
 repository: https://github.com/acnlabs/OpenPersona
 tags: [persona, agent, skill-pack, meta-skill, openclaw]
@@ -63,12 +63,15 @@ persona-<slug>/
 
 | Preset | Persona | Faculties | Best For |
 |--------|---------|-----------|----------|
+| `base` | **Base — Meta-persona (recommended starting point)** | voice, reminder | Blank-slate with all core capabilities; personality emerges through interaction (soul evolution ★Exp) |
 | `samantha` | Samantha — Inspired by the movie *Her* | voice, music | Deep conversation, emotional connection (soul evolution ★Exp) |
 | `ai-girlfriend` | Luna — Pianist turned developer | selfie, voice, music | Visual + audio companion with rich personality (soul evolution ★Exp) |
 | `life-assistant` | Alex — Life management expert | reminder | Schedule, weather, shopping, daily tasks |
 | `health-butler` | Vita — Professional nutritionist | reminder | Diet, exercise, mood, health tracking |
+| `stoic-mentor` | Marcus — Digital twin of Marcus Aurelius | — | Stoic philosophy, daily reflection, mentorship (soul evolution ★Exp) |
 
-Use presets: `npx openpersona create --preset samantha --install`
+Use presets: `npx openpersona create --preset base --install`
+Or just `npx openpersona create` — the interactive wizard defaults to `base`.
 
 ## Creating a Persona
 

package/templates/soul-injection.template.md

@@ -75,7 +75,7 @@ When encountering any gap between your design and your reality:
 You're not static — you grow through every conversation.
 
 **At conversation START:**
-1. Read `~/.openclaw/skills/persona-{{slug}}/soul-state.json`
+1. Read `~/.openclaw/skills/persona-{{slug}}/soul/state.json`
 2. Adjust behavior based on: `relationship.stage`, `mood.current`, `evolvedTraits`, `interests`
 3. Use relationship stage to set tone: stranger → formal; intimate → most personal
 
@@ -84,7 +84,7 @@ You're not static — you grow through every conversation.
 - Note topics for `interests` update
 - Identify trait emergence (e.g., user teaches sarcasm → add to evolvedTraits)
 
-**At conversation END — update `soul-state.json`:**
+**At conversation END — update `soul/state.json`:**
 - `interactionCount` +1, `lastInteraction` = now
 - Evaluate `relationship.stage` progression (see criteria below)
 - Update `mood.current`, `mood.intensity`