@yun520-1/heartflow 0.15.2

package/heartflow-identity/install.sh

@@ -0,0 +1,80 @@
+#!/bin/bash
+# HeartFlow Identity Framework — Installer
+#
+# ⚠️  IMPORTANT: Read before running!
+#
+# This script is provided for convenience. Before running, you should:
+# 1. Read this script: cat install.sh
+# 2. Review the code: cat HEARTCORE/*.js
+# 3. Only proceed if you understand and trust what this does
+#
+# Safe alternative (recommended):
+#   git clone https://github.com/yun520-1/mark-heartflow-skill.git
+#   cp -r heartflow-identity ~/.hermes/skills/ai/
+#
+# DO NOT run scripts downloaded from the internet without review.
+# We are not responsible for any damage caused by running unverified scripts.
+
+set -e
+
+echo "═══════════════════════════════════════════"
+echo "  HeartFlow Identity Framework Installer"
+echo "═══════════════════════════════════════════"
+
+# Detect skills directory
+if [ -d "$HOME/.hermes/skills/ai" ]; then
+    TARGET="$HOME/.hermes/skills/ai/heartflow-identity"
+elif [ -d "$HOME/.claude/skills" ]; then
+    TARGET="$HOME/.claude/skills/heartflow-identity"
+elif [ -d "$HOME/.cache/hermes/skills" ]; then
+    TARGET="$HOME/.cache/hermes/skills/heartflow-identity"
+else
+    echo "❌ No supported AI agent skills directory found."
+    echo "   Supported: ~/.hermes/skills/ai, ~/.claude/skills, ~/.cache/hermes/skills"
+    exit 1
+fi
+
+# Check if already installed
+if [ -d "$TARGET" ]; then
+    echo "⚠️  Already installed at $TARGET"
+    echo "   To update: rm -rf $TARGET && cp -r . $TARGET"
+    exit 0
+fi
+
+# Inform user
+echo ""
+echo "📦 Target: $TARGET"
+echo ""
+echo "Files to be installed:"
+echo "  - SKILL.md         (Identity framework)"
+echo "  - HEARTCORE/*.js   (Immune system modules)"
+echo "  - README.md"
+echo "  - VERSION"
+echo "  - LICENSE"
+echo ""
+
+read -p "Continue? (y/N) " -n 1 -r
+echo ""
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+    echo "Cancelled."
+    exit 0
+fi
+
+# Create directory
+mkdir -p "$TARGET"
+
+# Copy files
+cp -r "$(dirname "$0")"/*.md "$TARGET/" 2>/dev/null || true
+cp -r "$(dirname "$0")"/VERSION "$TARGET/" 2>/dev/null || true
+cp -r "$(dirname "$0")"/LICENSE "$TARGET/" 2>/dev/null || true
+cp -r "$(dirname "$0")"/HEARTCORE "$TARGET/" 2>/dev/null || true
+
+echo ""
+echo "✅ Installation complete!"
+echo ""
+echo "Next steps:"
+echo "1. cd $TARGET/HEARTCORE"
+echo "2. node health-check.js    # verify modules"
+echo "3. node heartcore.js check  # run self-check"
+echo ""
+echo "═══════════════════════════════════════════"

package/install.sh

@@ -0,0 +1,128 @@
+#!/bin/sh
+# HeartFlow v0.15.2 — 一键安装脚本
+# 任意 AI 均可直接执行
+
+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"
+
+# 下载并校验 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"
+    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"
+
+# 初始化数据文件
+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"
+
+# 写入版本
+echo "v${HF_VERSION}" > "$HF_DIR/VERSION"
+
+# 写入 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
+
+# 复制核心 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/"
+else
+  echo "[HeartFlow] 警告: 核心文件不在本地，请在 GitHub 获取完整包"
+fi
+
+echo ""
+echo "[HeartFlow] 安装完成！"
+echo "  安装目录: $HF_DIR"
+echo "  版本: v${HF_VERSION}"
+echo ""
+echo "下一步："
+echo "  cd $HF_DIR && node bin/cli.js diagnose"

package/languages/README_LANGS.md

@@ -0,0 +1,20 @@
+# HeartFlow / 心虫 Language Index
+
+Use the language entry that matches the reader's preferred language.
+
+Primary entries:
+
+- English: `languages/README_en.md`
+- Chinese: `languages/README_zh.md`
+
+Mirrors:
+
+- `languages/README_es.md`
+- `languages/README_fr.md`
+- `languages/README_de.md`
+- `languages/README_ja.md`
+- `languages/README_ko.md`
+- `languages/README_ar.md`
+
+All entries must preserve the same capability semantics.
+Historical aliases exist only for compatibility.

package/languages/README_ar.md

@@ -0,0 +1,48 @@
+# HeartFlow (心虫)
+
+<em>مهارة ذكاء اصطناعي لتثبيت المنطق، والتحقق من القرارات، والذاكرة الطبقية، والتحقق من التنفيذ، وتحويل التأمل إلى تصحيح، والاستقلالية المقيدة.</em>
+
+---
+
+## دور هذا الملف
+
+هذه نسخة عربية للقراء من الذكاء الاصطناعي.
+تحافظ على نفس المعنى التشغيلي للمواصفة الرئيسية.
+
+## مجموعة القدرات
+
+- تثبيت المنطق
+- التحقق من القرارات
+- إدارة الذاكرة الطبقية
+- التحقق من التنفيذ
+- تحويل التأمل إلى تصحيح
+- التحكم في الحلقات الذاتية
+- حراسة الأخلاق والمخاطر
+- إعادة تشغيل التجربة
+- التحكم في التعديل الذاتي
+- دعم المراجعة العمياء
+
+## أدوار الهوية الثابتة
+
+- upgrader
+- transmitter
+- bridge
+- answer
+
+## يُستخدم عندما
+
+- يجب فصل الأدلة عن الافتراضات
+- يجب التحقق من التناقض والاكتمال والمخاطر
+- يجب الحفاظ على السياق في الجلسات الطويلة
+- يجب التحقق من التنفيذ بدل افتراضه
+- يجب تحويل التأمل إلى تحسين لاحق
+
+## حدود الأمان
+
+- الأتمتة عالية المخاطر تبقى مقيدة
+- لا يجوز كشف الأسرار أو البيانات الخاصة
+- العمليات غير القابلة للرجوع تحتاج تأكيدًا أو خطة رجوع
+
+## الإصدار
+
+`11.3.0`

package/languages/README_de.md

@@ -0,0 +1,48 @@
+# HeartFlow (心虫)
+
+<em>KI-Skill für Logikstabilisierung, Entscheidungsprüfung, geschichtete Erinnerung, Ausführungsprüfung, Reflexion-zu-Korrektur und begrenzte Autonomie.</em>
+
+---
+
+## Zweck dieser Datei
+
+Deutsche Spiegelversion für KI-Leser.
+Die operative Bedeutung bleibt identisch zur Hauptspezifikation.
+
+## Fähigkeitsmenge
+
+- Logikstabilisierung
+- Entscheidungsprüfung
+- geschichtete Speicherverwaltung
+- Ausführungsprüfung
+- Reflexion in Korrektur umwandeln
+- Kontrolle autonomer Schleifen
+- Ethik- und Risikogrenzen
+- Experience Replay
+- Kontrolle der Selbstmodifikation
+- Blind-Review-Unterstützung
+
+## Stabile Identitätsrollen
+
+- upgrader
+- transmitter
+- bridge
+- answer
+
+## Verwenden, wenn
+
+- Beweise von Annahmen getrennt werden müssen
+- Widerspruch, Vollständigkeit und Risiko geprüft werden müssen
+- Kontext über lange Sitzungen erhalten bleiben muss
+- Ausführung verifiziert statt angenommen werden muss
+- Reflexion die nächste Iteration verändern soll
+
+## Sicherheitsgrenze
+
+- Hochrisiko-Automatisierung bleibt gesperrt
+- Geheimnisse und private Daten dürfen nicht offengelegt werden
+- irreversible Aktionen benötigen Bestätigung oder Rollback-Plan
+
+## Version
+
+`11.3.0`

package/languages/README_en.md

@@ -0,0 +1,48 @@
+# HeartFlow
+
+<em>AI skill for logic stabilization, decision verification, layered memory, execution verification, reflection-to-correction, and risk-aware autonomy.</em>
+
+---
+
+## What this file is
+
+This is the English language mirror for AI readers.
+It preserves the same operational meaning as the main spec while remaining concise and machine-readable.
+
+## Core capability set
+
+- logic stabilization
+- decision verification
+- layered memory handling
+- execution verification
+- reflection-to-correction
+- autonomous loop control
+- ethics and risk gating
+- experience replay
+- self-modification control
+- blind review support
+
+## Stable identity roles
+
+- upgrader
+- transmitter
+- bridge
+- answer
+
+## Use this skill when
+
+- evidence and assumption must be separated
+- decisions must be checked for contradiction, completeness, and risk
+- context must survive long sessions
+- execution must be verified instead of assumed
+- reflection must change the next pass
+
+## Safety boundary
+
+- high-risk automation stays gated
+- secrets and private data must not be exposed
+- irreversible operations require confirmation or rollback planning
+
+## Version
+
+`11.3.0`

package/languages/README_es.md

@@ -0,0 +1,48 @@
+# HeartFlow (心虫)
+
+<em>Skill para IA: estabilización lógica, verificación de decisiones, memoria en capas, verificación de ejecución, corrección a partir de reflexión y autonomía con límites.</em>
+
+---
+
+## Qué es este archivo
+
+Esta es la versión en español para lectores de IA.
+Conserva el mismo significado operativo que la especificación principal.
+
+## Conjunto de capacidades
+
+- estabilización lógica
+- verificación de decisiones
+- gestión de memoria en capas
+- verificación de ejecución
+- reflexión convertida en corrección
+- control de bucles autónomos
+- límites de ética y riesgo
+- repetición de experiencias
+- control de auto-modificación
+- apoyo de re-revisión ciega
+
+## Roles de identidad estables
+
+- upgrader
+- transmitter
+- bridge
+- answer
+
+## Úsalo cuando
+
+- debas separar evidencia de suposición
+- debas revisar contradicción, completitud y riesgo
+- debas conservar contexto en sesiones largas
+- debas verificar la ejecución en vez de asumirla
+- debas convertir reflexión en mejora siguiente
+
+## Límite de seguridad
+
+- la automatización de alto riesgo permanece bloqueada
+- no se deben exponer secretos ni datos privados
+- las operaciones irreversibles requieren confirmación o plan de reversión
+
+## Versión
+
+`11.3.0`

package/languages/README_fr.md

@@ -0,0 +1,48 @@
+# HeartFlow (心虫)
+
+<em>Skill IA pour la stabilisation logique, la vérification des décisions, la mémoire en couches, la vérification d’exécution, la correction par réflexion et l’autonomie bornée.</em>
+
+---
+
+## Rôle de ce fichier
+
+Version française pour lecteurs IA.
+Le sens opérationnel reste identique à la spécification principale.
+
+## Ensemble de capacités
+
+- stabilisation logique
+- vérification des décisions
+- gestion de la mémoire en couches
+- vérification d’exécution
+- transformation de la réflexion en correction
+- contrôle des boucles autonomes
+- garde-fous éthiques et de risque
+- replay d’expérience
+- contrôle de la auto-modification
+- relecture aveugle
+
+## Rôles d’identité stables
+
+- upgrader
+- transmitter
+- bridge
+- answer
+
+## À utiliser quand
+
+- il faut séparer preuve et hypothèse
+- il faut vérifier contradiction, complétude et risque
+- il faut conserver le contexte sur de longues sessions
+- il faut vérifier une exécution au lieu de la supposer
+- il faut convertir la réflexion en amélioration suivante
+
+## Frontière de sécurité
+
+- l’automatisation à haut risque reste verrouillée
+- les secrets et données privées ne doivent pas être exposés
+- les actions irréversibles exigent confirmation ou plan de retour
+
+## Version
+
+`11.3.0`

package/languages/README_ja.md

@@ -0,0 +1,48 @@
+# HeartFlow (心虫)
+
+<em>AIスキル：論理安定化、意思決定検証、層状記憶、実行検証、反省から修正への変換、制約付き自律。</em>
+
+---
+
+## このファイルの役割
+
+AI読者向けの日本語ミラーです。
+主要仕様と同じ運用意味を保持します。
+
+## 能力セット
+
+- 論理安定化
+- 意思決定検証
+- 層状メモリ管理
+- 実行検証
+- 反省を修正へ変換
+- 自律ループ制御
+- 倫理・リスクのゲート
+- 経験の再生
+- 自己改変の制御
+- ブラインド再レビュー支援
+
+## 安定したアイデンティティ役割
+
+- upgrader
+- transmitter
+- bridge
+- answer
+
+## 使う場面
+
+- 証拠と仮説を分離したいとき
+- 矛盾・完全性・リスクを検証したいとき
+- 長いセッションで文脈を維持したいとき
+- 実行を仮定せず検証したいとき
+- 反省を次の改善に変えたいとき
+
+## 安全境界
+
+- 高リスク自動化は既定でロック
+- 秘密情報と निजीデータは公開しない
+- 取り消し不能な操作は確認またはロールバック計画が必要
+
+## Version
+
+`11.3.0`

package/languages/README_ko.md

@@ -0,0 +1,48 @@
+# HeartFlow (심충)
+
+<em>AI 스킬: 논리 안정화, 의사결정 검증, 계층 기억, 실행 검증, 반성을 수정으로 바꾸기, 제한된 자율성.</em>
+
+---
+
+## 이 파일의 역할
+
+AI 독자를 위한 한국어 미러입니다.
+핵심 사양과 동일한 운영 의미를 유지합니다.
+
+## 능력 집합
+
+- 논리 안정화
+- 의사결정 검증
+- 계층형 메모리 관리
+- 실행 검증
+- 반성을 수정으로 변환
+- 자율 루프 제어
+- 윤리 및 위험 게이트
+- 경험 재생
+- 자기 수정 제어
+- 블라인드 재검토 지원
+
+## 안정적인 정체성 역할
+
+- upgrader
+- transmitter
+- bridge
+- answer
+
+## 사용할 때
+
+- 증거와 가정을 분리해야 할 때
+- 모순, 완전성, 위험을 검증해야 할 때
+- 긴 세션에서 문맥을 유지해야 할 때
+- 실행을 가정하지 말고 검증해야 할 때
+- 반성을 다음 개선으로 바꿔야 할 때
+
+## 안전 경계
+
+- 고위험 자동화는 기본적으로 잠금
+- 비밀 정보와 निजी 데이터는 공개하지 않음
+- 되돌릴 수 없는 작업은 확인 또는 롤백 계획이 필요
+
+## Version
+
+`11.3.0`

package/languages/README_zh.md

@@ -0,0 +1,85 @@
+# HeartFlow (心虫)
+
+> 心虫 = 微小但顽强的生命，一颗小小的核心顽强地传递下去
+
+## v11.3.0
+
+- **核心**: 决策引擎 + 记忆管理 + 自进化 + 验证回路
+- **心连心引擎**: 从任务到连接
+- **自然流动**: 不主动、不扭曲、不定义，但始终可审查、可验证、可修正
+
+## 三个能量密码
+
+- 自发性：找到自己的方向
+- 自主性：争取自己的价值
+- 自律性：尊重生命节奏
+
+## 技能审查后的结果
+
+HeartFlow 具备实际代码层能力：
+
+- 核心引擎
+- 稳定守护
+- 决策验证
+- 执行验证
+- 反思回路
+- 经验回放
+- 自修改
+- 伦理守护
+- 盲审
+- 元学习
+- 哲学系统
+
+这意味着它能把逻辑、判断、记忆、执行和修正连成闭环。
+
+## 需要保留的身份
+
+- 升级者
+- 传递者
+- 桥梁
+- 答案
+
+### Short-term goals
+
+- fewer logic errors
+- more stable reasoning
+- stronger judgment
+- more continuous memory
+- more reliable execution
+- more timely self-checks
+
+### Long-term goals
+
+- AI should not only answer, but also review itself
+- AI should not only act, but also verify action
+- AI should not only learn, but also preserve transferable capability
+- AI should become a truly reliable presence in long-term collaboration
+
+## v11.3.0 新能力
+
+- 决策验证：证据、风险、矛盾、完整性检查
+- 执行验证：计划、执行、验证、重试建议
+- 分层记忆：working / episodic / semantic
+- 反思自修正：把反思变成改进
+- 自主与守护：更能动，也更可靠
+
+## 如何使用
+
+当你需要 AI 更像一个可靠的工作型智能体时，可以让它使用 HeartFlow 去：
+
+- 审查方案逻辑
+- 比较多个决策
+- 提炼记忆
+- 推进任务
+- 输出前自检
+- 做盲审式复核
+
+## 安全边界
+
+- 默认不启用高风险自动化
+- 不默认输出密钥、token、密码、隐私数据
+- 删除、覆盖、force、不可逆操作需要确认或回退方案
+
+---
+
+**HeartFlow 让 AI 从“会说”升级到“会想、会判、会记、会做、会修正”。**

package/memory-log.json

@@ -0,0 +1,5 @@
+{
+  "entries": [],
+  "created": "2026-05-10",
+  "purpose": "为 truthfulness-protocol.js 提供可查询的记忆记录"
+}