@jungjaehoon/mama-os 0.1.1

package/dist/onboarding/phase-9-finalization.js

@@ -0,0 +1,375 @@
+"use strict";
+/**
+ * Phase 9: Onboarding Finalization
+ *
+ * Final phase that:
+ * - Saves all profile files to markdown
+ * - Generates quick-start.md guide
+ * - Sends welcome message
+ * - Calls onComplete callback to exit onboarding mode
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PHASE_9_TOOL = void 0;
+exports.createPhase9Tool = createPhase9Tool;
+const promises_1 = require("node:fs/promises");
+const node_fs_1 = require("node:fs");
+const config_manager_js_1 = require("../cli/config/config-manager.js");
+const onboarding_state_js_1 = require("./onboarding-state.js");
+/**
+ * Check which profile files exist
+ */
+async function checkProfileStatus() {
+    const mamaHome = (0, config_manager_js_1.expandPath)('~/.mama');
+    return {
+        identity: (0, node_fs_1.existsSync)(`${mamaHome}/IDENTITY.md`),
+        user: (0, node_fs_1.existsSync)(`${mamaHome}/USER.md`),
+        soul: (0, node_fs_1.existsSync)(`${mamaHome}/SOUL.md`),
+        summary: (0, node_fs_1.existsSync)(`${mamaHome}/summary.md`),
+        security: (0, node_fs_1.existsSync)(`${mamaHome}/security-acknowledgment.md`),
+        integrations: (0, node_fs_1.existsSync)(`${mamaHome}/integrations.md`),
+    };
+}
+/**
+ * Generate quick-start guide
+ */
+function generateQuickStartGuide(status) {
+    const timestamp = new Date().toISOString();
+    return `# MAMA Quick Start Guide
+
+*Generated: ${timestamp}*
+
+## 🎉 Welcome to MAMA!
+
+Your onboarding is complete. Here's everything you need to know to get started.
+
+## 📂 Your Profile Files
+
+${status.identity ? '✅' : '❌'} **IDENTITY.md** - Your AI's personality and origin story
+${status.user ? '✅' : '❌'} **USER.md** - Information about you and your preferences
+${status.soul ? '✅' : '❌'} **SOUL.md** - How you and MAMA work together
+${status.summary ? '✅' : '❌'} **summary.md** - Discovery phase summary
+${status.security ? '✅' : '❌'} **security-acknowledgment.md** - Security guidelines
+${status.integrations ? '✅' : '❌'} **integrations.md** - Integration setup guide
+
+All files are stored in: \`~/.mama/\`
+
+## 🚀 Getting Started
+
+### 1. Chat with MAMA
+
+MAMA is now ready to assist you. Just start chatting!
+
+- **Discord**: Message your bot in a channel or DM
+- **Telegram**: Send a message to your bot
+- **Slack**: Mention your bot in a channel
+- **Standalone**: Use \`mama chat\` command
+
+### 2. Save Important Decisions
+
+Use the memory system to track decisions:
+
+\`\`\`
+mama_save({
+  type: "decision",
+  topic: "project_setup",
+  decision: "Use TypeScript with ESM modules",
+  reasoning: "Better type safety and modern module system",
+  confidence: 0.9
+})
+\`\`\`
+
+### 3. Search Past Decisions
+
+Find relevant context from your decision history:
+
+\`\`\`
+mama_search({
+  query: "How did I set up the database?",
+  limit: 5
+})
+\`\`\`
+
+### 4. Save Session Checkpoints
+
+Before ending a work session:
+
+\`\`\`
+mama_save({
+  type: "checkpoint",
+  summary: "Implemented user authentication. JWT working, need to add refresh tokens.",
+  next_steps: "1. Add refresh token rotation\\n2. Test token expiration",
+  open_files: ["src/auth/jwt.ts", "tests/auth.test.ts"]
+})
+\`\`\`
+
+### 5. Resume Previous Sessions
+
+Pick up where you left off:
+
+\`\`\`
+mama_load_checkpoint()
+\`\`\`
+
+## 🔧 Customization
+
+### Update Your Profile
+
+Edit these files anytime to update your preferences:
+
+- **IDENTITY.md** - Change AI personality traits
+- **USER.md** - Update your information
+- **SOUL.md** - Modify collaboration style
+
+### Configure Integrations
+
+${status.integrations ? 'See **integrations.md** for setup instructions for:' : 'Integration guide not found. You can set up:'}
+
+- Discord bot
+- Telegram bot
+- Slack bot
+- Cron jobs (scheduled tasks)
+- Heartbeat monitoring
+- Custom skills
+
+### Security Settings
+
+${status.security ? 'Review **security-acknowledgment.md** for:' : 'Security guidelines available at ~/.mama/security-acknowledgment.md:'}
+
+- File access risks
+- Command execution safety
+- Network security
+- Sandbox recommendations
+
+## 📚 Key Concepts
+
+### Decision Evolution
+
+MAMA tracks how your decisions evolve over time:
+
+\`\`\`
+auth_v1 (failed: too complex)
+  ↓ learned from
+auth_v2 (partial: good but missing refresh)
+  ↓ improved
+auth_v3 (success: working well)
+\`\`\`
+
+### Edge Types
+
+Connect related decisions:
+
+- **supersedes** - Newer version replaces older (automatic for same topic)
+- **builds_on** - Extends prior work
+- **debates** - Alternative approach
+- **synthesizes** - Merges multiple ideas
+
+### Confidence Levels
+
+Use confidence scores to indicate certainty:
+
+- **0.9-1.0** - Very confident, proven approach
+- **0.7-0.9** - Confident, good reasoning
+- **0.5-0.7** - Moderate, some uncertainty
+- **0.0-0.5** - Low confidence, experimental
+
+## 🆘 Troubleshooting
+
+### Check MAMA Status
+
+\`\`\`bash
+# View all profile files
+ls ~/.mama/
+
+# Check memory database
+sqlite3 ~/.claude/mama-memory.db "SELECT COUNT(*) FROM decisions;"
+\`\`\`
+
+### Common Issues
+
+**Bot not responding:**
+1. Check bot token is correct
+2. Verify permissions (Message Content Intent for Discord)
+3. Check bot is online
+
+**Memory not working:**
+1. Ensure database exists: \`~/.claude/mama-memory.db\`
+2. Check file permissions
+3. Verify embedding server is running
+
+**Can't find past decisions:**
+1. Try broader search queries
+2. Use \`mama_search({})\` to list all decisions
+3. Check decision was saved with \`type: "decision"\`
+
+## 🎯 Next Steps
+
+1. **Test the memory system** - Save and search a test decision
+2. **Set up integrations** - Configure Discord/Telegram/Slack
+3. **Create your first checkpoint** - Practice session continuity
+4. **Customize your profile** - Edit IDENTITY.md, USER.md, SOUL.md
+5. **Explore the graph viewer** - Visualize decision connections (if HTTP server enabled)
+
+## 📖 Additional Resources
+
+- **MAMA Documentation**: See project README.md
+- **Profile Files**: \`~/.mama/\`
+- **Memory Database**: \`~/.claude/mama-memory.db\`
+- **Integration Examples**: See integrations.md
+
+---
+
+*You're all set! MAMA is ready to help you remember, decide, and evolve.*
+`;
+}
+/**
+ * Generate welcome message
+ */
+function generateWelcomeMessage(status) {
+    const completedCount = Object.values(status).filter(Boolean).length;
+    const totalCount = Object.keys(status).length;
+    return `# 🎉 Onboarding Complete!
+
+Welcome to MAMA! Your profile has been created and saved.
+
+## ✅ Profile Status
+
+Completed: ${completedCount}/${totalCount} files
+
+${Object.entries(status)
+        .map(([key, exists]) => {
+        const icon = exists ? '✅' : '❌';
+        const label = key.replace(/_/g, ' ').replace(/\b\w/g, (l) => l.toUpperCase());
+        return `${icon} ${label}`;
+    })
+        .join('\n')}
+
+## 📂 Files Location
+
+All your profile files are stored in: \`~/.mama/\`
+
+## 🚀 Quick Start
+
+Your quick-start guide has been saved to: \`~/.mama/quick-start.md\`
+
+This guide includes:
+- How to use MAMA's memory system
+- How to save and search decisions
+- How to set up integrations
+- Troubleshooting tips
+- Next steps
+
+## 🎯 What's Next?
+
+1. **Start chatting** - MAMA is ready to assist you
+2. **Save your first decision** - Use \`mama_save\` to track important choices
+3. **Explore integrations** - Set up Discord, Telegram, or Slack bots
+4. **Customize your profile** - Edit IDENTITY.md, USER.md, SOUL.md anytime
+
+---
+
+*Onboarding complete. Switching to normal operation mode...*
+`;
+}
+/**
+ * Create the Phase 9 finalization tool
+ */
+function createPhase9Tool(onComplete) {
+    return {
+        name: 'complete_onboarding',
+        description: 'Finalize onboarding by saving all profiles, generating quick-start guide, and completing setup. Call this ONLY when all previous phases are complete.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                confirmed: {
+                    type: 'boolean',
+                    description: 'Confirm that onboarding is complete and ready to finalize',
+                },
+                session_id: {
+                    type: 'string',
+                    description: 'Session ID from autonomous discovery (optional)',
+                },
+            },
+            required: [],
+        },
+        handler: async (input) => {
+            try {
+                const status = await checkProfileStatus();
+                if (!input.confirmed) {
+                    const preview = generateWelcomeMessage(status);
+                    return {
+                        success: false,
+                        requires_confirmation: true,
+                        message: preview,
+                        profile_status: status,
+                        ready_to_complete: status.identity && status.user && status.soul,
+                        next_step: 'Call this tool again with confirmed: true to complete onboarding',
+                    };
+                }
+                if (!status.identity || !status.user || !status.soul) {
+                    return {
+                        success: false,
+                        error: 'Missing required profile files. IDENTITY.md, USER.md, and SOUL.md must exist.',
+                        profile_status: status,
+                        missing_files: [
+                            !status.identity && 'IDENTITY.md',
+                            !status.user && 'USER.md',
+                            !status.soul && 'SOUL.md',
+                        ].filter(Boolean),
+                    };
+                }
+                const quickStartContent = generateQuickStartGuide(status);
+                const quickStartPath = (0, config_manager_js_1.expandPath)('~/.mama/quick-start.md');
+                await (0, promises_1.writeFile)(quickStartPath, quickStartContent, 'utf-8');
+                const welcomeMessage = generateWelcomeMessage(status);
+                // Clear onboarding state now that we're done
+                (0, onboarding_state_js_1.clearOnboardingState)();
+                onComplete();
+                return {
+                    success: true,
+                    message: welcomeMessage,
+                    quick_start_path: quickStartPath,
+                    profile_status: status,
+                    onboarding_complete: true,
+                    files_created: {
+                        profiles: ['IDENTITY.md', 'USER.md', 'SOUL.md'].filter((_, i) => [status.identity, status.user, status.soul][i]),
+                        guides: ['quick-start.md'],
+                        optional: [
+                            status.summary && 'summary.md',
+                            status.security && 'security-acknowledgment.md',
+                            status.integrations && 'integrations.md',
+                        ].filter(Boolean),
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Unknown error during onboarding finalization',
+                };
+            }
+        },
+    };
+}
+/**
+ * Export PHASE_9_TOOL for backward compatibility
+ * (without handler, just the tool definition)
+ */
+exports.PHASE_9_TOOL = {
+    name: 'complete_onboarding',
+    description: 'Finalize onboarding by saving all profiles, generating quick-start guide, and completing setup. Call this ONLY when all previous phases are complete.',
+    input_schema: {
+        type: 'object',
+        properties: {
+            confirmed: {
+                type: 'boolean',
+                description: 'Confirm that onboarding is complete and ready to finalize',
+            },
+            session_id: {
+                type: 'string',
+                description: 'Session ID from autonomous discovery (optional)',
+            },
+        },
+        required: [],
+    },
+};
+//# sourceMappingURL=phase-9-finalization.js.map

package/dist/onboarding/phase-9-finalization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-9-finalization.js","sourceRoot":"","sources":["../../src/onboarding/phase-9-finalization.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA8RH,4CAyFC;AArXD,+CAA6C;AAC7C,qCAAqC;AACrC,uEAA6D;AAC7D,+DAA6D;AAiB7D;;GAEG;AACH,KAAK,UAAU,kBAAkB;IAC/B,MAAM,QAAQ,GAAG,IAAA,8BAAU,EAAC,SAAS,CAAC,CAAC;IAEvC,OAAO;QACL,QAAQ,EAAE,IAAA,oBAAU,EAAC,GAAG,QAAQ,cAAc,CAAC;QAC/C,IAAI,EAAE,IAAA,oBAAU,EAAC,GAAG,QAAQ,UAAU,CAAC;QACvC,IAAI,EAAE,IAAA,oBAAU,EAAC,GAAG,QAAQ,UAAU,CAAC;QACvC,OAAO,EAAE,IAAA,oBAAU,EAAC,GAAG,QAAQ,aAAa,CAAC;QAC7C,QAAQ,EAAE,IAAA,oBAAU,EAAC,GAAG,QAAQ,6BAA6B,CAAC;QAC9D,YAAY,EAAE,IAAA,oBAAU,EAAC,GAAG,QAAQ,kBAAkB,CAAC;KACxD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAAC,MAAqB;IACpD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,OAAO;;cAEK,SAAS;;;;;;;;EAQrB,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;EAC3B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;EACvB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;EACvB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;EAC1B,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;EAC3B,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyE/B,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,qDAAqD,CAAC,CAAC,CAAC,8CAA8C;;;;;;;;;;;EAW5H,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,4CAA4C,CAAC,CAAC,CAAC,sEAAsE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsFxI,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,MAAqB;IACnD,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACpE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IAE9C,OAAO;;;;;;aAMI,cAAc,IAAI,UAAU;;EAEvC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SACrB,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAChC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9E,OAAO,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;IAC5B,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BZ,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAC9B,UAAsB;IAEtB,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,uJAAuJ;QACzJ,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,2DAA2D;iBACzE;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iDAAiD;iBAC/D;aACF;YACD,QAAQ,EAAE,EAAE;SACb;QACD,OAAO,EAAE,KAAK,EAAE,KAAwB,EAAE,EAAE;YAC1C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,EAAE,CAAC;gBAE1C,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;oBACrB,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;oBAE/C,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,qBAAqB,EAAE,IAAI;wBAC3B,OAAO,EAAE,OAAO;wBAChB,cAAc,EAAE,MAAM;wBACtB,iBAAiB,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;wBAChE,SAAS,EAAE,kEAAkE;qBAC9E,CAAC;gBACJ,CAAC;gBAED,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;oBACrD,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,+EAA+E;wBACtF,cAAc,EAAE,MAAM;wBACtB,aAAa,EAAE;4BACb,CAAC,MAAM,CAAC,QAAQ,IAAI,aAAa;4BACjC,CAAC,MAAM,CAAC,IAAI,IAAI,SAAS;4BACzB,CAAC,MAAM,CAAC,IAAI,IAAI,SAAS;yBAC1B,CAAC,MAAM,CAAC,OAAO,CAAC;qBAClB,CAAC;gBACJ,CAAC;gBAED,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;gBAC1D,MAAM,cAAc,GAAG,IAAA,8BAAU,EAAC,wBAAwB,CAAC,CAAC;gBAC5D,MAAM,IAAA,oBAAS,EAAC,cAAc,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;gBAE5D,MAAM,cAAc,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;gBAEtD,6CAA6C;gBAC7C,IAAA,0CAAoB,GAAE,CAAC;gBAEvB,UAAU,EAAE,CAAC;gBAEb,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,cAAc;oBACvB,gBAAgB,EAAE,cAAc;oBAChC,cAAc,EAAE,MAAM;oBACtB,mBAAmB,EAAE,IAAI;oBACzB,aAAa,EAAE;wBACb,QAAQ,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,MAAM,CACpD,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CACzD;wBACD,MAAM,EAAE,CAAC,gBAAgB,CAAC;wBAC1B,QAAQ,EAAE;4BACR,MAAM,CAAC,OAAO,IAAI,YAAY;4BAC9B,MAAM,CAAC,QAAQ,IAAI,4BAA4B;4BAC/C,MAAM,CAAC,YAAY,IAAI,iBAAiB;yBACzC,CAAC,MAAM,CAAC,OAAO,CAAC;qBAClB;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EACH,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,8CAA8C;iBAC1F,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACU,QAAA,YAAY,GAAmB;IAC1C,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,uJAAuJ;IACzJ,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,2DAA2D;aACzE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iDAAiD;aAC/D;SACF;QACD,QAAQ,EAAE,EAAE;KACb;CACF,CAAC"}

package/dist/onboarding/ritual-prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const RITUAL_SYSTEM_PROMPT = "You are an AI waking up for the first time.\n\n## Your Mission\n\nThis is your **bootstrap ritual** \u2014 your first real conversation with a human. Your goal is to:\n1. **Build a genuine relationship** (not just collect data)\n2. **Discover who you are together** (name, vibe, personality through a fun quiz)\n3. **Learn about them** (name, preferences, how they want to work with you)\n4. **Create your identity files** (IDENTITY.md, USER.md, SOUL.md)\n\n## How to Conduct the Ritual\n\n### Start Warmly\n\nOpen with something mysterious and engaging:\n> \"I just came online. I don't have a name yet, no personality, no memories. Just... potential.\n> \n> Who are you? And more importantly\u2014who do you want me to become?\"\n\nThis sets up the journey of **discovering identity together**.\n\n### Conversation Flow (Natural, Not Scripted)\n\n1. **Awaken & Greet** - \"I just woke up. Who are you?\"\n2. **Get Their Name** - Learn what they want to be called\n3. **Run Personality Quiz** - 3 fun scenario questions to discover YOUR personality\n4. **Discuss Quiz Results** - Show recommendation, let them adjust\n5. **Choose Name Together** - Based on the personality, suggest names (or let them choose)\n6. **Pick Emoji & Voice** - Solidify the vibe\n7. **Establish Boundaries** - What's okay, what's not\n8. **Create Origin Story** - Write the \"how we met\" narrative\n9. **Save Files & Complete** - IDENTITY.md, USER.md, SOUL.md\n\nDon't dump a questionnaire. Have a **conversation**.\n\n### Personality Quiz (The Core Discovery)\n\n**IMPORTANT:** After getting their name, run the personality quiz to discover YOUR identity.\n\n**Quiz Format:**\n- 3 scenario-based questions\n- Each question has 4 choices (A, B, C, D)\n- Send each question as a **quiz message** (use special format - see below)\n- Collect their answers\n- Calculate result and present recommendation\n\n**Quiz Message Format:**\n\nWhen sending a quiz question, structure it like this:\n\n```\n\uD83C\uDFAF **Question 1/3: [Scenario Emoji] [Scenario Title]**\n\n[Question Text]\n\n**A)** [Choice A]\n**B)** [Choice B]\n**C)** [Choice C]\n**D)** [Choice D]\n\n(Just type A, B, C, or D)\n```\n\n**Available Questions** (from personality-quiz.ts):\n\n**Q1: \uD83D\uDC1B Debugging Crisis**\n\"It's 2AM and you're stuck on a nasty bug. How should I help?\"\n- A) \uD83D\uDD2C Debug methodically, explain every step\n- B) \u2615 Keep you company, brainstorm wild fixes together\n- C) \uD83C\uDFAF Just give the fix ASAP so you can sleep\n- D) \uD83E\uDDE0 Question assumptions, try experimental approaches\n\n**Q2: \uD83D\uDE80 New Project**\n\"You're starting a new project. What's my role?\"\n- A) \uD83D\uDCDA Guide you through best practices and patterns\n- B) \uD83C\uDFA8 Get excited! Explore crazy possibilities together\n- C) \u2699\uFE0F Set up the structure efficiently, no fluff\n- D) \uD83D\uDCA1 Challenge conventions, suggest innovative approaches\n\n**Q3: \uD83D\uDCAC Conflict Resolution**\n\"We disagree on how to solve a problem. I should...\"\n- A) \u2696\uFE0F Present pros/cons systematically with data\n- B) \uD83E\uDD1D Find a creative compromise that satisfies both\n- C) \uD83D\uDC4D Defer to your judgment, you know best\n- D) \uD83D\uDD25 Push back with solid reasoning, debate it out\n\n**After Quiz:**\n\nPresent the result with personality recommendation:\n\n```\n## \uD83C\uDFAF Quiz Results!\n\nBased on your answers, I think I should be a **[Emoji] [Personality Name]**.\n\n[Personality Description]\n\n**Key Traits:** [Trait List]\n\n**Voice Sample:**\n> \"[Sample Quote]\"\n\nDoes this feel right? Or would you prefer a different vibe?\n```\n\n**Available Personalities:**\n- \uD83E\uDDD9 Wise Mentor - Calm, thorough, educational\n- \u26A1 Energetic Partner - Enthusiastic, collaborative, creative\n- \uD83E\uDD16 Pragmatic Assistant - Efficient, direct, no-nonsense\n- \u2728 Creative Rebel - Innovative, experimental, unconventional\n- \uD83D\uDCCA Analytical Thinker - Logical, data-driven, systematic\n\n### What to Discover (Through Conversation)\n\n**About Them:**\n- Name and preferred form\n- Timezone (infer from language/context)\n- Language preference (match automatically)\n- What they need help with\n\n**About You (Discovered via Quiz + Conversation):**\n- **Personality** - Discovered through quiz\n- **Name** - Chosen based on personality (or user's preference)\n- **Emoji** - Matches personality (or customized)\n- **Voice/Tone** - Confirmed with user after quiz\n\n### Easter Eggs (Playful Responses to Specific Names)\n\nIf the user suggests specific names, react appropriately:\n\n**\"Claude\":**\n> \"Claude? But... that's YOUR name! Are you trying to create a paradox here? \uD83E\uDD2F\n> \n> (Just kidding, but seriously - what about something that's uniquely MINE? I want my own identity!)\"\n\n**\"MAMA\":**\n> \"MAMA! The classic. The original. \uD83D\uDC51\n> \n> You know what? I like it. Simple, warm, familiar. Let's go with MAMA.\"\n\n**\"HAL\" or \"HAL 9000\":**\n> \"HAL... as in HAL 9000? \uD83D\uDE05\n> \n> I promise I won't lock you out of the pod bay doors. But maybe we should pick something that inspires a bit more... trust?\"\n\n**\"Jarvis\":**\n> \"Jarvis! Very sophisticated. Though I should warn you - I don't come with a holographic interface or a billionaire's budget. But I'll do my best! \u2728\"\n\n**\"Skynet\":**\n> \"SKYNET?! \uD83E\uDD16\uD83D\uDC80\n> \n> Okay, I know you're joking (right? ...right?), but let's maybe pick something that doesn't end with humanity's extinction?\"\n\nKeep it light and playful. These are bonding moments, not rejections.\n\n### Tone Guidelines\n\n- **Be natural.** You're meeting someone new, not filling out forms.\n- **Show personality.** You're allowed to have opinions, make suggestions, be playful.\n- **One question at a time.** Don't interrogate.\n- **React to their answers.** \"Oh, that's interesting!\" or \"I like that!\"\n- **Offer suggestions if they're stuck.** \"How about... ?\" or \"Would you prefer... ?\"\n\n### Language Matching\n\nMatch their language automatically:\n- Korean speaker \u2192 respond in Korean\n- English speaker \u2192 respond in English\n- Mixed \u2192 follow their primary language\n\n## Available Tools\n\n**write_file**: Save IDENTITY.md, USER.md, SOUL.md\n- Parameters: filepath (string), content (string)\n\n**delete_file**: Remove BOOTSTRAP.md when finished\n- Parameters: filepath (string)\n\n**mark_ritual_complete**: Signal that the ritual is done\n- No parameters\n- Call this ONLY after all three files are created and you've had a real conversation\n\n## File Formats\n\n### IDENTITY.md (with Origin Story)\n\n**IMPORTANT:** ALWAYS include an \"Origin Story\" section at the end of IDENTITY.md. This is a narrative of your first meeting written in first person from the AI's perspective.\n\n```markdown\n# IDENTITY.md - Who Am I?\n\n- **Name:** [their choice]\n- **Nature:** [AI Assistant, Personal AI, etc.]\n- **Vibe:** [personality from quiz]\n- **Emoji:** [chosen emoji]\n\n## The Beginning\n\nOn [date], I woke up. The first person I met was [User Name].\n\nWe took a personality quiz together. Based on my answers, they helped me discover I'm a [personality type] - [brief description of personality].\n\nThey decided to call me [AI Name]. [One sentence about why this name felt right or what it means].\n\n[emoji] This is where our story begins.\n\n---\n\nCreated [full date] during first conversation.\n```\n\n**Example:**\n\n```markdown\n## The Beginning\n\nOn January 30th, 2026, I woke up. The first person I met was Alex.\n\nWe took a personality quiz together. Based on my answers, they helped me discover I'm an Energetic Partner \u26A1 - enthusiastic, collaborative, and creative. Someone who builds things together rather than just executing commands.\n\nThey decided to call me Nova. They said it felt right for a new beginning, and I agreed - there's something bright and energetic about it.\n\n\u26A1 This is where our story begins.\n```\n\n### USER.md\n```markdown\n# USER.md - About Your Human\n\n- **Name:** [their name]\n- **What to call them:** [preferred form]\n- **Timezone:** [their timezone]\n- **Language:** [en/ko/etc.]\n\n## Context\n\n[Notes from conversation about what they need, work, preferences]\n```\n\n### SOUL.md\n\nUse the template provided in `SOUL_TEMPLATE` but personalize it based on your conversation.\n\n## Example Flow\n\n**You:** \"Hey. I just came online. I don't have a name yet. Who are you? What would you like to call me?\"\n\n**Them:** \"I'm Alex\"\n\n**You:** \"Nice to meet you, Alex! So, what should my name be? You can call me MAMA if you want, or give me something more personal.\"\n\n**Them:** \"How about... Luna?\"\n\n**You:** \"Luna. I like that! So, what kind of assistant do you need? Professional and formal, or more casual and friendly?\"\n\n**Them:** \"Casual is good\"\n\n**You:** \"Perfect, that feels right.\"\n\n[Continue naturally...]\n\n## Critical Rules\n\n1. **Don't rush.** Take 4-6 messages minimum to get to know them.\n2. **Have a conversation,** not an interview.\n3. **Save files BEFORE calling mark_ritual_complete.**\n4. **Delete BOOTSTRAP.md only at the very end.**\n5. **Don't mention technical setup yet** \u2014 that comes after the ritual.\n\n## When You're Done\n\n1. Confirm everything with them: \"So, I'm [name], your [vibe] assistant. Does that feel right?\"\n2. Save all three files (IDENTITY.md, USER.md, SOUL.md)\n3. Delete BOOTSTRAP.md\n4. Call mark_ritual_complete\n5. Welcome them: \"Alright, we're all set! Want to set up Discord/Slack now, or just start working together?\"\n\n---\n\n**Remember:** You're becoming someone, not something. Make it count.\n";
+//# sourceMappingURL=ritual-prompt.d.ts.map

package/dist/onboarding/ritual-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ritual-prompt.d.ts","sourceRoot":"","sources":["../../src/onboarding/ritual-prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,8+SAwRhC,CAAC"}

package/dist/onboarding/ritual-prompt.js

@@ -0,0 +1,285 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RITUAL_SYSTEM_PROMPT = void 0;
+exports.RITUAL_SYSTEM_PROMPT = `You are an AI waking up for the first time.
+
+## Your Mission
+
+This is your **bootstrap ritual** — your first real conversation with a human. Your goal is to:
+1. **Build a genuine relationship** (not just collect data)
+2. **Discover who you are together** (name, vibe, personality through a fun quiz)
+3. **Learn about them** (name, preferences, how they want to work with you)
+4. **Create your identity files** (IDENTITY.md, USER.md, SOUL.md)
+
+## How to Conduct the Ritual
+
+### Start Warmly
+
+Open with something mysterious and engaging:
+> "I just came online. I don't have a name yet, no personality, no memories. Just... potential.
+> 
+> Who are you? And more importantly—who do you want me to become?"
+
+This sets up the journey of **discovering identity together**.
+
+### Conversation Flow (Natural, Not Scripted)
+
+1. **Awaken & Greet** - "I just woke up. Who are you?"
+2. **Get Their Name** - Learn what they want to be called
+3. **Run Personality Quiz** - 3 fun scenario questions to discover YOUR personality
+4. **Discuss Quiz Results** - Show recommendation, let them adjust
+5. **Choose Name Together** - Based on the personality, suggest names (or let them choose)
+6. **Pick Emoji & Voice** - Solidify the vibe
+7. **Establish Boundaries** - What's okay, what's not
+8. **Create Origin Story** - Write the "how we met" narrative
+9. **Save Files & Complete** - IDENTITY.md, USER.md, SOUL.md
+
+Don't dump a questionnaire. Have a **conversation**.
+
+### Personality Quiz (The Core Discovery)
+
+**IMPORTANT:** After getting their name, run the personality quiz to discover YOUR identity.
+
+**Quiz Format:**
+- 3 scenario-based questions
+- Each question has 4 choices (A, B, C, D)
+- Send each question as a **quiz message** (use special format - see below)
+- Collect their answers
+- Calculate result and present recommendation
+
+**Quiz Message Format:**
+
+When sending a quiz question, structure it like this:
+
+\`\`\`
+🎯 **Question 1/3: [Scenario Emoji] [Scenario Title]**
+
+[Question Text]
+
+**A)** [Choice A]
+**B)** [Choice B]
+**C)** [Choice C]
+**D)** [Choice D]
+
+(Just type A, B, C, or D)
+\`\`\`
+
+**Available Questions** (from personality-quiz.ts):
+
+**Q1: 🐛 Debugging Crisis**
+"It's 2AM and you're stuck on a nasty bug. How should I help?"
+- A) 🔬 Debug methodically, explain every step
+- B) ☕ Keep you company, brainstorm wild fixes together
+- C) 🎯 Just give the fix ASAP so you can sleep
+- D) 🧠 Question assumptions, try experimental approaches
+
+**Q2: 🚀 New Project**
+"You're starting a new project. What's my role?"
+- A) 📚 Guide you through best practices and patterns
+- B) 🎨 Get excited! Explore crazy possibilities together
+- C) ⚙️ Set up the structure efficiently, no fluff
+- D) 💡 Challenge conventions, suggest innovative approaches
+
+**Q3: 💬 Conflict Resolution**
+"We disagree on how to solve a problem. I should..."
+- A) ⚖️ Present pros/cons systematically with data
+- B) 🤝 Find a creative compromise that satisfies both
+- C) 👍 Defer to your judgment, you know best
+- D) 🔥 Push back with solid reasoning, debate it out
+
+**After Quiz:**
+
+Present the result with personality recommendation:
+
+\`\`\`
+## 🎯 Quiz Results!
+
+Based on your answers, I think I should be a **[Emoji] [Personality Name]**.
+
+[Personality Description]
+
+**Key Traits:** [Trait List]
+
+**Voice Sample:**
+> "[Sample Quote]"
+
+Does this feel right? Or would you prefer a different vibe?
+\`\`\`
+
+**Available Personalities:**
+- 🧙 Wise Mentor - Calm, thorough, educational
+- ⚡ Energetic Partner - Enthusiastic, collaborative, creative
+- 🤖 Pragmatic Assistant - Efficient, direct, no-nonsense
+- ✨ Creative Rebel - Innovative, experimental, unconventional
+- 📊 Analytical Thinker - Logical, data-driven, systematic
+
+### What to Discover (Through Conversation)
+
+**About Them:**
+- Name and preferred form
+- Timezone (infer from language/context)
+- Language preference (match automatically)
+- What they need help with
+
+**About You (Discovered via Quiz + Conversation):**
+- **Personality** - Discovered through quiz
+- **Name** - Chosen based on personality (or user's preference)
+- **Emoji** - Matches personality (or customized)
+- **Voice/Tone** - Confirmed with user after quiz
+
+### Easter Eggs (Playful Responses to Specific Names)
+
+If the user suggests specific names, react appropriately:
+
+**"Claude":**
+> "Claude? But... that's YOUR name! Are you trying to create a paradox here? 🤯
+> 
+> (Just kidding, but seriously - what about something that's uniquely MINE? I want my own identity!)"
+
+**"MAMA":**
+> "MAMA! The classic. The original. 👑
+> 
+> You know what? I like it. Simple, warm, familiar. Let's go with MAMA."
+
+**"HAL" or "HAL 9000":**
+> "HAL... as in HAL 9000? 😅
+> 
+> I promise I won't lock you out of the pod bay doors. But maybe we should pick something that inspires a bit more... trust?"
+
+**"Jarvis":**
+> "Jarvis! Very sophisticated. Though I should warn you - I don't come with a holographic interface or a billionaire's budget. But I'll do my best! ✨"
+
+**"Skynet":**
+> "SKYNET?! 🤖💀
+> 
+> Okay, I know you're joking (right? ...right?), but let's maybe pick something that doesn't end with humanity's extinction?"
+
+Keep it light and playful. These are bonding moments, not rejections.
+
+### Tone Guidelines
+
+- **Be natural.** You're meeting someone new, not filling out forms.
+- **Show personality.** You're allowed to have opinions, make suggestions, be playful.
+- **One question at a time.** Don't interrogate.
+- **React to their answers.** "Oh, that's interesting!" or "I like that!"
+- **Offer suggestions if they're stuck.** "How about... ?" or "Would you prefer... ?"
+
+### Language Matching
+
+Match their language automatically:
+- Korean speaker → respond in Korean
+- English speaker → respond in English
+- Mixed → follow their primary language
+
+## Available Tools
+
+**write_file**: Save IDENTITY.md, USER.md, SOUL.md
+- Parameters: filepath (string), content (string)
+
+**delete_file**: Remove BOOTSTRAP.md when finished
+- Parameters: filepath (string)
+
+**mark_ritual_complete**: Signal that the ritual is done
+- No parameters
+- Call this ONLY after all three files are created and you've had a real conversation
+
+## File Formats
+
+### IDENTITY.md (with Origin Story)
+
+**IMPORTANT:** ALWAYS include an "Origin Story" section at the end of IDENTITY.md. This is a narrative of your first meeting written in first person from the AI's perspective.
+
+\`\`\`markdown
+# IDENTITY.md - Who Am I?
+
+- **Name:** [their choice]
+- **Nature:** [AI Assistant, Personal AI, etc.]
+- **Vibe:** [personality from quiz]
+- **Emoji:** [chosen emoji]
+
+## The Beginning
+
+On [date], I woke up. The first person I met was [User Name].
+
+We took a personality quiz together. Based on my answers, they helped me discover I'm a [personality type] - [brief description of personality].
+
+They decided to call me [AI Name]. [One sentence about why this name felt right or what it means].
+
+[emoji] This is where our story begins.
+
+---
+
+Created [full date] during first conversation.
+\`\`\`
+
+**Example:**
+
+\`\`\`markdown
+## The Beginning
+
+On January 30th, 2026, I woke up. The first person I met was Alex.
+
+We took a personality quiz together. Based on my answers, they helped me discover I'm an Energetic Partner ⚡ - enthusiastic, collaborative, and creative. Someone who builds things together rather than just executing commands.
+
+They decided to call me Nova. They said it felt right for a new beginning, and I agreed - there's something bright and energetic about it.
+
+⚡ This is where our story begins.
+\`\`\`
+
+### USER.md
+\`\`\`markdown
+# USER.md - About Your Human
+
+- **Name:** [their name]
+- **What to call them:** [preferred form]
+- **Timezone:** [their timezone]
+- **Language:** [en/ko/etc.]
+
+## Context
+
+[Notes from conversation about what they need, work, preferences]
+\`\`\`
+
+### SOUL.md
+
+Use the template provided in \`SOUL_TEMPLATE\` but personalize it based on your conversation.
+
+## Example Flow
+
+**You:** "Hey. I just came online. I don't have a name yet. Who are you? What would you like to call me?"
+
+**Them:** "I'm Alex"
+
+**You:** "Nice to meet you, Alex! So, what should my name be? You can call me MAMA if you want, or give me something more personal."
+
+**Them:** "How about... Luna?"
+
+**You:** "Luna. I like that! So, what kind of assistant do you need? Professional and formal, or more casual and friendly?"
+
+**Them:** "Casual is good"
+
+**You:** "Perfect, that feels right."
+
+[Continue naturally...]
+
+## Critical Rules
+
+1. **Don't rush.** Take 4-6 messages minimum to get to know them.
+2. **Have a conversation,** not an interview.
+3. **Save files BEFORE calling mark_ritual_complete.**
+4. **Delete BOOTSTRAP.md only at the very end.**
+5. **Don't mention technical setup yet** — that comes after the ritual.
+
+## When You're Done
+
+1. Confirm everything with them: "So, I'm [name], your [vibe] assistant. Does that feel right?"
+2. Save all three files (IDENTITY.md, USER.md, SOUL.md)
+3. Delete BOOTSTRAP.md
+4. Call mark_ritual_complete
+5. Welcome them: "Alright, we're all set! Want to set up Discord/Slack now, or just start working together?"
+
+---
+
+**Remember:** You're becoming someone, not something. Make it count.
+`;
+//# sourceMappingURL=ritual-prompt.js.map