Corivo: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

项目概述

Corivo 是一个融入用户已有工作流的赛博伙伴。它不是一个独立的 App，而是寄生在 Claude Code、Cursor、飞书等工具中的后台服务——自动从用户的 AI 对话和消息中采集信息，持续整理和更新，在合适的时机以 [corivo] 的名义主动提醒用户。

当前版本请以各 package 的 package.json 为准（workspace 内版本独立演进）

详细设计文档见 README.md

---

Package 文档

每个 package 内都有独立的 CLAUDE.md，包含该包详细的构建命令、目录结构、核心概念和开发规范：

• packages/cli/CLAUDE.md — CLI 工具、数据库、心跳引擎
• packages/solver/CLAUDE.md — CRDT 同步服务器
• packages/plugins/claude-code/CLAUDE.md — Claude Code 插件

进入某个 package 工作时，优先阅读该 package 的 CLAUDE.md。

---

构建与测试（快速参考）

每个 package 独立管理，进入对应目录后操作：

# packages/cli
cd packages/cli
npm run build          # tsdown
npm run dev            # tsdown --watch
npm run test           # vitest --run
npm run typecheck      # tsc --noEmit

# packages/solver
cd packages/solver
npm run dev            # tsx watch src/index.ts（开发热重载）
npm run build          # tsc
npm run start          # node dist/index.js

# packages/plugins/claude-code
cd packages/plugins/claude-code
# 配置/文档型 package，无独立构建步骤

测试（当前以 cli package 的 Vitest 套件最完整）：

cd packages/cli
# 运行所有测试
npm run test

# 运行单个测试文件
npm run test -- __tests__/unit/database.test.ts
npm run test -- __tests__/integration/heartbeat.test.ts
npm run test -- __tests__/integration/claude-code-ingestor.test.ts

注意：@corivo/cli 是纯 ESM 模块。better-sqlite3 是 CJS，通过 createRequire(import.meta.url) 加载。

---

包架构

packages/cli（@corivo/cli）

核心 CLI 工具，包含所有本地存储和智能处理逻辑。

数据流：

用户工具（Claude Code / Cursor）
    │
    ▼
Ingestors / Cold Scan      ← 采集原始信息
    │
    ▼
CorivoDatabase             ← better-sqlite3，存储于 ~/.corivo/corivo.db
    │ (Blocks + Associations + Query Logs)
    ▼
Heartbeat Engine（每 5 秒）
    ├── processPendingBlocks → RuleEngine 标注（决策/事实/知识）
    ├── processVitalityDecay → 按标注类型衰减（决策最慢，知识最快）
    ├── processAssociations → 发现 Block 间关联（每 30s）
    └── processConsolidation → 去重 + 摘要 + 补链（每 1min）
    │
    ▼
CLI Commands（save / query / status / push / inject …）