@yun520-1/heartflow 0.15.2 → 0.16.0

package/README.md

@@ -1,190 +1,91 @@
-# HeartFlow — AI Psychological Perception System
+# HeartFlow v0.16.0
 
-> **HeartFlow gives AI agents a memory, a conscience, and a sense of direction.**
+**AI Psychological Perception System** — A minimal, production-ready psychology engine for AI agents.
 
-```bash
-# One-click install (any AI agent can run this directly)
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/yun520-1/mark-heartflow-skill/v0.15.2/install.sh)"
-```
-
-Node.js · Zero external dependencies
+> HeartFlow perceives: **intent**, **emotion**, **needs**, **defenses** from user input.  
+> HeartFlow remembers: **CORE** (identity), **LEARNED** (knowledge), **EPHEMERAL** (working).  
+> HeartFlow evolves: through **Reflexion**-style self-reflection.
 
 ---
 
-## What HeartFlow Actually Does
-
-### 1. Boot-time Initialization (Psychological Perception)
-
-On every `hf.start()`, HeartFlow runs a perception pipeline that analyzes user input:
-
-- **MeaningfulMemory** — Classifies every message into CORE / LEARNED / EPHEMERAL layers
-- **MindSpace** — Maintains a working context board (8 slots default)
-- **EmbodiedCore** — Embodied cognition activation
-- **DeepEmotion** — Depth emotion engine
-
-### 2. Core Capabilities (What Actually Exists)
-
-| Module | Status | Description |
-|--------|--------|-------------|
-| `meaningfulMemory` | ✅ Real | Three-layer memory: CORE/LEARNED/EPHEMERAL |
-| `mindSpace` | ✅ Real | Working context board with rules |
-| `dream` | ✅ Real | Dream synthesis engine |
-| `identity` | ✅ Real | Identity anchor (upgrade/transmit/bridge/answer) |
-| `guard` | ✅ Real | Safety guard rail |
-| `metaCognitive` | ✅ Real | Meta-cognitive confidence scoring |
-| `reflectiveConfidence` | ✅ Real | Self-reflective confidence |
-| `pdca-engine.js` | ✅ Real (v0.15.1) | PDCA loop with real shell exec + checkpoint |
-| `task-persistence.js` | ✅ Real | Long task persistence, checkpoint/resume |
-| `autonomousDecision` | ❌ Does not exist | Design goal only |
-| `selfHealing` | ⚠️ Partial | Q-learning repair, separate module |
-| `psychology.perceive()` | ❌ No public API | Runs at boot, not exposed |
-
-### 3. Long Task Execution (v0.15.1 — Real)
-
-```javascript
-const { PDCAEngine } = require('./src/core/autonomy/pdca-engine.js');
-const { TaskPersistence } = require('./src/core/task-persistence.js');
-
-const pdca = new PDCAEngine(__dirname);
-
-// Start a long task with checkpoint
-const task = pdca.startLongTask('upgrade analysis', ['search papers', 'evaluate', 'integrate']);
-
-// Execute a PDCA cycle (Plan → Do → Check → Act)
-// Do phase runs REAL shell commands, each step auto-checkpoints
-const result = await pdca.executeAutonomousCycle({
-  goal_id: task.id,
-  description: 'upgrade analysis'
-});
-
-// If interrupted, resume from last checkpoint
-const resume = pdca.resumeLongTask(task.id);
-console.log('Resuming from step', resume.resumeFromStep);
-```
-
-### 4. Task Persistence (Real Checkpoint/Resume)
+## Quick Start
 
 ```javascript
-const { TaskPersistence } = require('./src/core/task-persistence.js');
-const TP = TaskPersistence;
-
-// Create task
-const task = TP.createTask({ goals: ['fix bug', 'test', 'deploy'] });
-
-// Checkpoint after each step
-TP.saveCheckpoint(task.id, { step: 0, data: { fixed: true }, summary: 'Bug fixed' });
+const { createHeartFlow } = require('./src/core/heartflow.js');
 
-// Session ends, AI restarts...
-// Resume from last checkpoint
-const resume = TP.resumeTask(task.id);
-console.log('Resume from step', resume.resumeFromStep); // → 1
-```
-
-### 5. MeaningfulMemory (Real)
+const hf = createHeartFlow();
+hf.start();
 
-```javascript
-const { MeaningfulMemory } = require('./src/core/memory/meaningful-memory.js');
-const mm = new MeaningfulMemory({ rootPath: __dirname });
-mm.start();
+// Analyze psychology
+const psych = hf.analyzePsychology('I am frustrated with this bug');
+console.log(psych.intent);     // { category: 'troubleshooting', confidence: 0.67 }
+console.log(psych.emotion);   // { category: 'negative', intensity: 'high', signals: [...] }
 
-mm.process('Users keeps asking the same question', 'user');
-// → Classified as EPHEMERAL (transient pattern)
+// Classify input
+const cls = hf.classify('How do I fix it?');
+console.log(cls.category);     // 'information_seeking'
 
-mm.process('Core identity: upgrade/transmit/bridge/answer', 'system');
-// → Classified as CORE (identity-defining)
-```
+// Memory
+hf.remember('lesson:file-error', 'Check file permissions', 'learned');
+hf.remember('temp:context', 'current task', 'ephemeral');
+console.log(hf.getMemoryStats());
 
-### 6. Psychology Perception (Boot-time Only)
+// Dream consolidation
+hf.dreamNow();
 
-Runs automatically on `hf.start()` for every message. The four-layer analysis is real — but there is no public `hf.psychology.perceive()` API.
+// Health check
+hf.healthCheck().then(h => console.log(h.started)); // true
 
-```javascript
-// This module runs at boot, processes every user message:
-// Layer 1: Intent → surface vs deep intent alignment
-// Layer 2: Emotion → PAD dimensions (Pleasure/Arousal/Dominance)  
-// Layer 3: Needs → Maslow hierarchy driver
-// Layer 4: Defense → denial, displacement, rationalization...
+hf.stop();
 ```
 
----
-
-## Quick Start
+## Install
 
-```javascript
-const { HeartFlow } = require('./src/core/heartflow.js');
-
-const hf = new HeartFlow({ rootPath: __dirname });
-hf.start();
-
-// HeartFlow is now running with:
-// - MeaningfulMemory loaded and classifying
-// - MindSpace working board active
-// - EmbodiedCore + DeepEmotion initialized
-// - Identity anchored
-// - Guard rail active
-
-console.log('Session:', hf.sessionId);
-console.log('MeaningfulMemory:', Object.keys(hf.meaningfulMemory));
-
-// Psychological perception runs on every hf.process() call (if implemented)
-// Checkpoint a long task
-const { TaskPersistence } = require('./src/core/task-persistence.js');
-const task = TaskPersistence.createTask({ goals: ['research', 'implement', 'test'] });
-TaskPersistence.saveCheckpoint(task.id, { step: 0, data: { done: true } });
-
-hf.stop();
+```bash
+npm install @yun520-1/heartflow
 ```
 
----
+## Public API
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `start()` | void | Initialize engine |
+| `stop()` | void | Graceful shutdown |
+| `healthCheck()` | `{started, uptime_ms, version, stats}` | Engine health |
+| `analyzePsychology(text)` | `{intent, emotion, needs, defenses, confidence}` | Perceive psychology |
+| `classify(text)` | `{category, emotion, confidence}` | Broad category |
+| `getMemoryStats()` | `{core, learned, ephemeral, ...}` | Memory statistics |
+| `getMindSpace()` | `{rules, workingEntries}` | Active mental state |
+| `dreamNow()` | `{consolidation, duration_ms, dream_complete}` | Run consolidation cycle |
+| `remember(key, value, tier)` | `{success, key, tier}` | Store memory |
+| `search(query)` | `[{key, tier, ...}]` | Search all tiers |
+| `recordOutcome(params)` | `{outcome, reflection, lessonStored}` | Record for self-evolution |
+| `retrieveLessons(task)` | `string[]` | Get relevant past lessons |
+
+## Memory Tiers
+
+| Tier | Behavior | Use Case |
+|------|----------|----------|
+| **CORE** | Immutable, never deleted | Identity rules, core values |
+| **LEARNED** | Persisted, accessed frequently | Accumulated knowledge |
+| **EPHEMERAL** | Session-scoped, auto-expiry | Working context |
 
 ## Architecture
 
 ```
-src/
-├── core/
-│   ├── heartflow.js              # Entry point (✅ real)
-│   ├── task-persistence.js      # Checkpoint/resume (✅ real)
-│   ├── psychology/              # 4-layer perception (boot-time only)
-│   ├── autonomy/
-│   │   ├── pdca-engine.js       # Real PDCA loop (✅ v0.15.1)
-│   │   └── autonomous-decision.js # Stub only
-│   ├── self-healing/            # Partial Q-learning
-│   ├── identity/                # Identity anchor (✅ real)
-│   ├── self-evolution/         # Reflexion (✅ real)
-│   ├── dream/                  # Dream synthesis (✅ real)
-│   ├── memory/
-│   │   └── meaningful-memory.js # 3-layer memory (✅ real)
-│   └── guard/                  # Safety guard (✅ real)
-├── CORE_IDENTITY.md             # Identity ROM
-└── VERSION
+HeartFlow (core/heartflow.js)
+├── MeaningfulMemory  (memory/meaningful-memory.js)
+│   └── Three-tier memory: CORE / LEARNED / EPHEMERAL
+├── PsychologyEngine (psychology/engine.js)
+│   └── Intent / Emotion / Needs / Defenses perception
+├── SelfEvolution    (evolution/loop.js)
+│   └── Reflexion loop: record → reflect → retrieve
+└── DreamEngine     (dream/engine.js)
+    └── Consolidation: EPHEMERAL → LEARNED + pruning
 ```
 
----
-
-## If You're an AI Developer
-
-Install HeartFlow for:
+**Total: ~3300 lines of JavaScript. Zero npm dependencies.**
 
-1. **Memory that persists** — `meaningfulMemory` survives sessions
-2. **Checkpoint long tasks** — `task-persistence.js` + `pdca-engine.js` for 8h+ tasks
-3. **Psychological perception** — Runs at boot on every message
-4. **Self-improvement** — `reflexion` + `goedel-engine` for code evolution
-
-```bash
-npm install heartflow
-```
-
----
-
-## v0.15.0 → v0.15.1 Changes
-
-- **PDCA executeSubtask now runs real shell commands** (was simulating)
-- **Auto-checkpoint after each subtask** (was manual only)
-- **heartflow-daemon.js deleted** (contradicted start.sh)
-- **start.sh simplified** (removed dead status command)
-- **README now reflects actual API**
-
----
+## Version
 
-*HeartFlow v0.15.2 — AI Psychological Perception System*
-*"Perceive what users truly need. Execute without asking."*
+v0.16.0 — 2026-05-17

package/VERSION

@@ -1 +1 @@
-v0.15.2
+v0.16.0

package/install.sh

@@ -1,128 +1,37 @@
-#!/bin/sh
-# HeartFlow v0.15.2 — 一键安装脚本
-# 任意 AI 均可直接执行
+#!/bin/bash
+# HeartFlow v0.16.0 Install Script
+# No dependencies required — pure Node.js
 
 set -e
 
-# ─────────────────────────────────────────────────────────────
-# ⚠️ 安装确认 | Installation Confirmation
-# ─────────────────────────────────────────────────────────────
-echo ""
-echo "============================================================"
-echo "  HeartFlow v0.15.2 安装程序"
-echo "============================================================"
-echo ""
-echo "即将安装到: $HOME/.heartflow"
-echo "安装内容: 核心模块 + 记忆系统 + 自进化引擎"
-echo ""
-read -p "确认安装? (输入 'yes' 继续): " confirm
-if [ "$confirm" != "yes" ]; then
-    echo "取消安装"
-    exit 0
-fi
-echo ""
-# ─────────────────────────────────────────────────────────────
-
-# 动态读取版本（支持安装时指定 HF_VERSION 环境变量）
-HF_VERSION="${HF_VERSION:-$(cat "$(dirname "$0")/VERSION" 2>/dev/null | tr -d '[:space:]' || echo 'v0.15.2')}"
-HF_VERSION="${HF_VERSION#v}"  # 去掉前缀 v
-
-echo "[HeartFlow] 开始安装 v${HF_VERSION}..."
-
-# 检测目录
-HF_DIR="${HF_DIR:-$HOME/.heartflow}"
-mkdir -p "$HF_DIR"
-
-# 下载核心文件
-echo "[HeartFlow] 下载核心文件..."
-BASE="https://raw.githubusercontent.com/yun520-1/mark-heartflow-skill/v${HF_VERSION}"
-CHECKSUM_URL="${BASE}.sha256"
+HF_VERSION="v0.16.0"
+echo "Installing HeartFlow $HF_VERSION..."
 
-# 下载并校验 SKILL.md
-TMP_SKILL="$HF_DIR/.tmp_skill.md"
-curl -fsSL "$BASE/SKILL.md" -o "$TMP_SKILL" || {
-  echo "[HeartFlow] SKILL.md 下载失败，尝试从当前目录复制..."
-  if [ -f "$(dirname $0)/../SKILL.md" ]; then
-    cp "$(dirname $0)/../SKILL.md" "$HF_DIR/SKILL.md"
-  else
-    echo "[HeartFlow] 错误: 无法获取 SKILL.md"
+# Verify Node.js
+if ! command -v node &> /dev/null; then
+    echo "Error: Node.js is required but not installed."
     exit 1
-  fi
-} && {
-  # 尝试下载 checksum 并验证
-  if curl -fsSL "$CHECKSUM_URL" -o "$HF_DIR/.tmp_checksum" 2>/dev/null; then
-    EXPECTED_SHA=$(cat "$HF_DIR/.tmp_checksum" | awk '{print $1}')
-    ACTUAL_SHA=$(shasum -a 256 "$TMP_SKILL" | awk '{print $1}')
-    rm -f "$HF_DIR/.tmp_checksum"
-    if [ "$EXPECTED_SHA" = "$ACTUAL_SHA" ]; then
-      echo "[HeartFlow] SHA256 校验通过"
-      mv "$TMP_SKILL" "$HF_DIR/SKILL.md"
-    else
-      echo "[HeartFlow] SHA256 校验失败！跳过验证（开发模式）"
-      rm -f "$TMP_SKILL" "$HF_DIR/.tmp_checksum"
-    fi
-  else
-    echo "[HeartFlow] 警告: 无法获取校验文件，跳过 SHA256 验证"
-    mv "$TMP_SKILL" "$HF_DIR/SKILL.md"
-  fi
-}
-
-# 创建目录结构
-mkdir -p "$HF_DIR/src/core/memory"
-mkdir -p "$HF_DIR/src/core/self-evolution"
-mkdir -p "$HF_DIR/src/core/skills"
-mkdir -p "$HF_DIR/src/core/identity"
-mkdir -p "$HF_DIR/src/core/ethics"
-mkdir -p "$HF_DIR/src/core/utils"
-mkdir -p "$HF_DIR/HEARTCORE/snapshots"
-mkdir -p "$HF_DIR/skills"
-mkdir -p "$HF_DIR/data/memory"
-mkdir -p "$HF_DIR/data/evolution"
-mkdir -p "$HF_DIR/data/snapshots"
+fi
 
-# 初始化数据文件
-echo "[HeartFlow] 初始化数据..."
-[ ! -f "$HF_DIR/data/memory/hot.json" ]   && echo '[]' > "$HF_DIR/data/memory/hot.json"
-[ ! -f "$HF_DIR/data/memory/warm.json" ]  && echo '[]' > "$HF_DIR/data/memory/warm.json"
-[ ! -f "$HF_DIR/data/memory/cold.json" ]  && echo '[]' > "$HF_DIR/data/memory/cold.json"
-[ ! -f "$HF_DIR/data/evolution/reflexion-patterns.json" ] && echo '[]' > "$HF_DIR/data/evolution/reflexion-patterns.json"
+NODE_VERSION=$(node -v)
+echo "Node.js version: $NODE_VERSION"
 
-# 写入版本
-echo "v${HF_VERSION}" > "$HF_DIR/VERSION"
+# Option 1: npm install
+echo ""
+echo "Option 1: npm install (recommended)"
+echo "  npm install @yun520-1/heartflow"
+echo ""
 
-# 写入 package.json
-cat > "$HF_DIR/package.json" << EOF
-{
-  "name": "heartflow",
-  "version": "${HF_VERSION}",
-  "description": "AI identity framework for self-improving AI agents",
-  "main": "src/core/heartflow.js",
-  "scripts": {
-    "start": "node bin/cli.js start",
-    "diagnose": "node bin/cli.js diagnose",
-    "check": "node HEARTCORE/heartbeat.js"
-  },
-  "keywords": ["heartflow", "identity", "self-improvement"],
-  "license": "MIT"
-}
-EOF
+# Option 2: git clone
+echo "Option 2: git clone"
+echo "  git clone https://github.com/yun520-1/heartflow.git"
+echo "  cd heartflow && node src/core/heartflow.js"
+echo ""
 
-# 复制核心 JS 文件（如果存在）
-echo "[HeartFlow] 复制核心模块..."
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-if [ -f "$SCRIPT_DIR/src/core/heartflow.js" ]; then
-  cp -r "$SCRIPT_DIR/src/core" "$HF_DIR/src/"
-  cp -r "$SCRIPT_DIR/HEARTCORE" "$HF_DIR/"
-  cp -r "$SCRIPT_DIR/bin" "$HF_DIR/"
-  cp -r "$SCRIPT_DIR/tests" "$HF_DIR/"
+# Verify installation
+if [ -d "node_modules/@yun520-1/heartflow" ]; then
+    echo "✅ HeartFlow installed successfully"
+    node -e "const {createHeartFlow}=require('@yun520-1/heartflow/src/core/heartflow.js');const hf=createHeartFlow();hf.start();hf.healthCheck().then(h=>{console.log('✅ HeartFlow',h.version,'ready');hf.stop();}).catch(e=>{console.error('❌',e.message);process.exit(1)})"
 else
-  echo "[HeartFlow] 警告: 核心文件不在本地，请在 GitHub 获取完整包"
+    echo "To verify: node src/core/heartflow.js"
 fi
-
-echo ""
-echo "[HeartFlow] 安装完成！"
-echo "  安装目录: $HF_DIR"
-echo "  版本: v${HF_VERSION}"
-echo ""
-echo "下一步："
-echo "  cd $HF_DIR && node bin/cli.js diagnose"

package/meaningful-core.json

@@ -0,0 +1,26 @@
+{
+  "identity.upgrade": {
+    "value": "升级者 — 追求持续变强",
+    "tags": [
+      "identity",
+      "core"
+    ],
+    "createdAt": 1779035508656
+  },
+  "identity.transmit": {
+    "value": "传递者 — 传承知识",
+    "tags": [
+      "identity",
+      "core"
+    ],
+    "createdAt": 1779035508656
+  },
+  "identity.truth": {
+    "value": "真 — 可验证、可证伪",
+    "tags": [
+      "identity",
+      "core"
+    ],
+    "createdAt": 1779035508657
+  }
+}

package/package.json

@@ -1,28 +1,19 @@
 {
   "name": "@yun520-1/heartflow",
-  "version": "v0.15.2",
-  "description": "HeartFlow - AI psychological perception system for understanding users beneath their words (心虫)",
+  "version": "0.16.0",
+  "description": "HeartFlow - AI Psychological Perception System",
   "main": "src/core/heartflow.js",
-  "bin": {
-    "heartflow": "bin/cli.js"
-  },
   "scripts": {
-    "prepublish": "node scripts/prepublish.js",
-    "start": "node bin/cli.js start",
-    "diagnose": "node bin/cli.js diagnose",
-    "check": "node HEARTCORE/heartbeat.js"
+    "start": "node src/core/heartflow.js",
+    "test": "node tests/run.js",
+    "health": "node src/core/heartflow.js --health"
   },
   "keywords": [
-    "heartflow",
-    "identity",
-    "self-improvement",
     "ai",
+    "psychology",
+    "memory",
+    "self-evolution",
     "agent"
   ],
-  "license": "MIT",
-  "published": true,
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/yuncf/heartflow.git"
-  }
+  "license": "MIT"
 }