Core Thesis

Core Thesis — 项目宪章

Status: canonical · 版本：2026-09-27（多成员协作修订）· 取代本宪章早先的 "persistent habitat for a single resident" 表述（原因见 ADR-0006） · 本文中的"本轮"指 2026-09-27 的多成员修订轮，不是当前阶段（当前阶段见 Roadmap）

Provenance — Migrated 2026-10-06 from IDEA.md @ zuohaisu/viva@871a00a · 迁移自主仓库产品宪章；原文以 Git 历史为准，repo 内相对链接已改为 Wiki 链接。

North Star

Haisu's AI members should keep their continuity over time:
each member keeps its own role, history and knowledge;
tasks that outlive any single worker session;
executions whose attribution and authority are always recoverable;
work that actually gets done through real tools.

Viva 是 Haisu 的本地优先个人 AI 协作系统。Viva 不是 AI 成员，也不是单一 Agent 的 wrapper、只有 worktree 功能的工具或记忆数据库——它让多个成员持续协作，并保留工作关系与历史。首个可用版本必须由 Viva 自己提供多 worktree 并行开发入口，不依赖 Orca.app；First-Usable-Version明确了真实验收。

核心不变量

Resident ≠ Role ≠ Cognitive Engine ≠ Worker ≠ Execution Session
Workspace ≠ Project ≠ Repository ≠ Worktree ≠ Task
raw event ≠ experience ≠ memory ≠ self-model ≠ identity
Session dies. Resident persists.

• Resident（成员）：长期存在的 AI 身份（Samuel、Deven、Alice…）。名字与职责是配置数据。
• Role：这个成员用来做什么（协调/开发/QA/运维/研究）。配置数据。
• Cognitive Engine：此刻为它提供认知的模型。可替换器官。
• Worker：具体执行的 agent CLI。可替换工具。
• Execution：一次真实运行，固定记录成员、任务、模型、工具、位置、来源与授权。
• Task：意图；跨执行、跨成员、跨重启存活。

对象级定义见 Product-Model 与 Domain-Model。

Customer Zero

Haisu — 一个人类用户，多个 AI 成员

Haisu 是唯一的用户；成员是他创建的记录。产品里没有任何内置人格；Viva ≠ Samuel（成员名不是代码）。详见 Customer-Zero。

架构原则

The member must exist before the member thinks.

成员的状态（身份、角色、历史、知识）必须独立于当前表达它的模型和当前替它执行的工具存在。换模型、换工具、换角色都不删除成员——这是可检验的（V13 前的证据在 tests/viva/；现行 Rust 证据在 crates/viva/tests/，如 v02_members_projects）。

一般化：复用优先。先查仓库内外已有的成熟能力，只补真实缺口；每个自建组件都要说明它对照过什么、缺什么（Transition-Record §6）。

产品形状

Viva Core  →  surfaces: CLI · TUI（本轮主界面）· Desktop（未来）
Viva Core  →  capabilities: dispatch/execution · knowledge · recovery · github(只读)

宿主与终端界面为 Rust + Ratatui + Crossterm（ADR-0011），已随 Rust 首版实现（V01–V13）交付（Python + Textual 实现已于 V13 退役，见 V13-Python-Retirement）；Pi 是首个默认对话宿主，以交互终端与小型扩展接入（extensions/pi/）；成员身份与长期资产独立于 harness。Viva 状态存储采用 SQLite + 普通文件。F04（#26）外部记忆已在 Viva 库中 Rust 原生 落地（viva#109 / viva#131）：viva memory … 提供成员/项目范围、来源记录、FTS 三字母 + 最小 HRR 召回、归档可恢复的 link 层；不需要 Hermes checkout 或 Python。旧 Hermes 关联行保留为 legacy_hermes 仅作溯源，不参与检索。目前没有自动召回或写回；Pi 记忆工具自 #101 起对接真实 Pi API，真实 Pi 端到端仍待独立复验（F01-F04-Acceptance）。OpenViking 等后端比较与是否默认启用记忆仍为开放项（Open-Questions）。自动反思与自我模型演化仍明确未实现。

Ticket Autopilot 曾是本仓库的产品主体，2026-09-27 已退役（ADR-0008）：其中被证明仍有用的三个能力（worktree 隔离、secret redaction、owner 授权）先搬进 Python 小模块、现由 Rust 承载（crates/viva/src/git/、redaction/、authority/）并保留验证；其余代码路径、固定流水线与旧产品文档被删除。历史运行数据未被删除。

进度定义

进度不是功能数量、成员数量或文档数量。进度是证据：Viva 能否再多撑住一个边界——多一个成员、多一个并行任务、一次重启、一次换模型、一次越权尝试——并且如实报告结果。

诚实约束（不可协商）

没有实现的成长能力不得出现在产品里：journal 不叫 memory，self_model_candidate 不叫"学到了"，没有使用记录的条目不叫"已复用"。未知与未实现始终保持可见。