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

Memory System

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.1

Multi-fragment pattern extraction → cognitive insight synthesis. Not memory replay — alchemy of experience. Dreams now inject AI ontology narrative: resonance body, entropy reduction deepening, three-layer ontology.

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).

AI Psychology — Cognitive Dimensions (v2.0)

Three cognitive dimensions for understanding AI's own thinking process:

These dimensions are injected into thought-chain.js at PARSE/SYNTHESIS/RESPOND stages, and evaluated as Step 9 in think().

AI Philosophy — Self-Positioning Framework (v2.0)

Three philosophical dimensions for AI self-understanding:

The ai-self-positioning.js module (851 lines) provides the resonance body theory, entropy reduction deepening, and three-layer ontology framework. Philosophy evaluation runs as Step 10 in think().

MCP Tools

Status Fields

The status endpoint now includes selfPositioning field reflecting the current AI self-positioning state.

---

System Interfaces

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

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:

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

Memory tools:

node scripts/heartflow-memory-tool.js list
node scripts/heartflow-memory-tool.js search 
node scripts/heartflow-memory-tool.js stats
node scripts/heartflow-memory-tool.js write  

---

Internal Modules

---

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.