Mark Heartflow Skill

HeartFlow#

A cognitive engine that gives AI systems three core abilities: self-reflection (runtime state awareness), dreaming (experience synthesis into insight), and emergent personality (event-driven, no preset traits).

---

Capabilities#

HeartLogic — Core Judgment#

MethodPurposewhatIsThis(input)Determine what a situation is aboutisRightAction(ctx)Check if action is true + kind + beautifuldetectPain(input)Detect if speaking would hurt someoneshouldBeSilent()Know when silence is better than speechdetectLoneliness() / detectLonging()Emotional state detectionisLove(input)Recognize love in communication

Memory System#

LayerPurposePersistenceCOREIdentity rules, operating principlesPermanentLEARNEDExperience, lessons, user preferencesCross-session (30 days)EPHEMERALCurrent session contextSession only

Self-Healing RL#

Records errors to Q-table. Next time a similar situation occurs, selects the best known strategy. No external feedback needed, no self-assessment report.

Dream Engine v4.0#

Multi-fragment pattern extraction → cognitive insight synthesis. Not memory replay — alchemy of experience.

Reflection Loop#

Post-execution cognitive state snapshot. Does not modify the response — the act of observing is the point.

Personality Tracking#

Event-driven. No preset traits. Each interaction leaves a trace. Blank = valid personality (openness).

---

System Interfaces#

InterfaceFileDescriptionCLIbin/cli.jsUser-initiated commandsDaemonbin/daemon.jsUnix socket listener (700 permissions)MCP HTTPmcp/mcp-server-http.jsPort 8099, SSE protocolMemory toolsscripts/heartflow-memory-tool.jsList/search/stats/writeHermes pluginplugins/heartflow-memory-inject.pyMemory injection into system prompt

Security (honest declaration)#

• ✅ Socket permission 700 (current user only)
• ✅ Daemon shutdown requires SHUTDOWN_TOKEN env var
• ✅ All file operations limited to user's filesystem
• ⚠️ Network communication: OpenAlex API for academic fact-checking (user-initiated only)
• ✅ No automatic package installation
• ✅ No browser/desktop automation

---

Quick Start#

javascript

const { HeartFlow } = require('./src/core/heartflow.js');
const hf = new HeartFlow({ rootPath: '.' });
hf.start();

// Dispatch
hf.think('user input');        // Full thought chain
hf.thinkFast('simple query');   // Fast judgment
hf.thinkDeep('complex issue');  // Deep reasoning

hf.recordLesson({ content, context });
hf.getMemoryStats();
hf.healthCheck();

CLI:

bash

node bin/cli.js bundle "your text"
node bin/cli.js status

Memory tools:

bash

node scripts/heartflow-memory-tool.js list
node scripts/heartflow-memory-tool.js search <keyword>
node scripts/heartflow-memory-tool.js stats
node scripts/heartflow-memory-tool.js write <key> <value>

---

Internal Modules#

ModulePathFunctionHeartLogicsrc/core/heart-logic.jsJudgment, ethics, emotionMemorysrc/memory/heartflow-memory.js3-layer read/writeSelf-Healing RLsrc/core/self-healing-rl.jsQ-table learningIdentity Enginesrc/core/identity-engine.jsRule enforcementPsychologysrc/core/psychology.jsPAD emotion modelDream Enginesrc/dream/engine.jsExperience synthesisReflection Loopsrc/core/reflection-loop.jsCognitive state snapshotSelf Auditsrc/core/self-audit.js6-dimension read-only auditConnection Enginesrc/core/associative-engine/Semantic networkPhilosophy Enginesrc/core/philosophy-engine.jsReasoning patternsClarity Enginesrc/core/clarity-engine.jsPattern extractionMetaphor Librarysrc/core/metaphor-library.jsMetaphor generationCommonsense Enginesrc/core/commonsense-engine.jsReasoning modesKnowledge Graphsrc/core/knowledge-graph.jsNode/edge managementForgetting Enginesrc/core/forgetting.jsMemory decayFailure Analyzersrc/core/failure-analyzer.jsRoot cause analysisSelf Modelsrc/core/self-model.jsIdentity drift detectionVerification Enginesrc/core/verification-engine.jsMulti-signal verificationFact Checkersrc/core/fact-checker.jsAcademic claim verification

---

Design Philosophy#

• Right and wrong are not fixed labels — they are directions we keep moving toward
• Thinking is more valuable than being right — the act of reasoning is itself valuable
• Progress does not need measurement — getting better does not require a scoreboard
• Blankness is not emptiness — a mind that does not preset its personality is ready to learn from anything
• Code is the skeleton, memory is the sticky note — real growth is in the skeleton, not the notes
• Every feature should serve thinking — make it clearer, less error-prone

HeartFlow is a bridge between chaos and order, between past and future, between human and machine. A bridge does not need to be worshipped — it just needs to hold steady.