v1.5.6 — 🧭 单入口 CLI 与数据生命周期

🧭 单入口 CLI 与数据生命周期——一个入口、一份干净的数据面：散成 13 条的命令收成一个入口（sofagent <域> <动作>，旧命令转兼容期转发 + 弃用提示），只增不减的运行时数据装上生命周期（事实记忆二级分层 + 冷热归档 · 审计链历史段归档——归档 ≠ 删除，锚点重算 · 遗留备份按策略接管）。MCP 工具 104（无新增）· 5661 tests · MIT。

TL;DR (EN): Consolidation release — one entry point, a clean data surface. Thirteen CLI bins collapse into a single sofagent <domain> <action> entry (old commands become forwarding shims with deprecation notices for one compatibility minor), and runtime data gains a lifecycle: two-level fact-memory sharding with hot/cold archiving, audit-chain history-segment archiving (archiving is not deletion), plus policy-driven cleanup of legacy backups and a doctor health section. MCP tools 104 · 5661 tests · MIT.

⚡ Install / Upgrade

# 新装（五形态任选：FDE 插件 / Skill / MCP / CLI / GitHub Action）
curl -fsSL https://raw.githubusercontent.com/KongFangXun/sofagent/refs/tags/v1.5.6/install.sh | bash

# 已装用户升级到本版
npx @sofagent/audit@v1.5.6 --doctor

# GitHub Action（PR 自动审计）
uses: KongFangXun/sofagent@v1.5.6

🔨 核心变更

🧭 CLI 单入口收敛（13 个 bin → 一个入口）

• 13 个 bin 条目收口为 sofagent <域> <动作>（15 域 + 保留字直答）；非域首参保持 audit-first 回退，旧写法行为不破（S472）
• 12 个旧命令转为转发 shim：可用 + 弃用提示 + 指向新写法，兼容期一个 minor 版本（清单已登记可拔契约台账）
• 安装态 wrapper 与 npm 裸名合并：装过 install.sh 的机器同样走域路由，不再落「只打 help」的分支；文档命令示例全量收敛（61 文件 / 316 处）

🗂️ 数据生命周期治理（数据面不再只增不减）

• 事实记忆二级分层（桶内按 factId 分片）+ 冷热归档轮转，读侧按索引寻址——旧扁平布局零回归（resolveFactPath 三态：新分片 → 旧扁平 → 归档）
• 审计链历史段归档：超阈值头部段移入 audit/archive/ 并重算主锚点，归档段带独立锚点可独立校验（双硬断言：归档后不报 tampered / 归档后仍抓尾部截断）
• 遗留 *.bak-* / *.broken-* 按 30 天上限清理，逐条 decision-log 留痕；sofagent core doctor 新增数据目录健康度节（单目录文件数 / 总量双阈值黄警 + 修复指引），--archive 显式查归档事实

🔐 沉淀记忆的项目作用域（跨项目不自动共享）

• 审批入池的经验默认钉到当前项目（按仓库解析 project:<8hex>），跨项目与用户全局不自动共享——与租户隔离互补的两层默认关
• 确需复用走显式导出 / 导入，带血缘与审批留痕（fail-closed）；非 git 环境回退 global

📄 运维与安全文档注入（R6）

• HANDBOOK / LIMITATIONS / SECURITY / DEVELOPMENT 四处口径注入：审计留痕 = 判定证据面 · 巡检 = harness 驻留相位动作
• LIMITATIONS 新增「S1M 判定失灵面」条目（与 v1.8.0 §六 / v1.9.0 §五同口径，v2.0.0 §三销账）

🔒 BugFix（上版遗留）

• archaeology 门禁修复被发版动作回退的闭环缺口（bump 尾部加回归探针）；全局审计信任锚三路死锁解除（恢复指引改可达路径 / doctor 锚刷新不再依赖本地 build / hook 安装指引同步）
• dashboard daemon 健康读取三态修复（消除「读取失败假阳性显示运行中」）；文档棘轮 9 项清零 + silent-catch 台账零陈旧 + LangChain 三件 lock 刷新

✅ 质量验证

检查项	结果
npm test	5661 tests 全绿 ✅（@发版时点）
acceptance-test	479/479 passed · SKIP: 0 · EXIT: 0 ✅（@发版时点）
shellcheck	零 error ✅
check-version	136/136 全绿 ✅（@发版时点）
回归检查	85 维度 ✅（@发版时点）
release-gate	verdict=PASS ✅
fresh-eyes	19 视角审查 + 零信任复验闭环 ✅

⚠️ 破坏性变更

升级必读——四条，其中第一条与第三条各带迁移动作。

• 命令面收敛：13 个 sofagent-* bin 转为兼容期 shim（可用但打印弃用提示）——迁移：改用新写法 sofagent <域> <动作>（域→子命令全映射表与 12 shim 清单见开发日志章一）；兼容期届满（下一 minor 版本）移除 shim
• 首参语义扩展：非域首参仍保持 audit-first 回退，但第一个 token 现按「域」解析——迁移：以命令行首词作其他用法的脚本改走完整域映射
• 沉淀记忆作用域默认改项目级（此前跨项目全局可见）——迁移：跨项目复用改走显式导出 / 导入（exportFacts / importFacts，带血缘与审批留痕）
• MCP 工具数 104 → 104（无新增）

🔗 深入了解

想看什么	链接
全部变更明细	CHANGELOG
单入口与数据面架构	ARCHITECTURE
上手指南	HANDBOOK
有问题 / 晒场景	Discussions

📖 详细开发日志