@haaaiawd/loom 1.3.1 → 2.0.0

package/cli/help/version.md

@@ -1,136 +0,0 @@
-## 版本演进指南
-
-LOOM 用 .loom/v{N}/ 目录支持多版本共存与演进。
-
-## 什么时候演进版本
-
-| 变更类型 | 判定标准 | 处理方式 |
-|---|---|---|
-| Patch | 不触及 Intent，不改变验收契约，只修 bug / 样式 / 实现细节 | 当前版本内修正，跑验证并记录 changelog；不进入 Intent Loop |
-| Minor | 新增或修改 Intent，但不改哲学前提、不改愿景北极星、不改架构边界 | 当前版本内改（变更回流机制），相关 Intent 进入 pending / needs_review |
-| Major | 哲学前提变了、愿景北极星变了、架构边界变了 | 创建新版本 |
-
-判定由用户 + Agent 对话完成，CLI 不做决策。
-
-哲学修订可用 CLI 做后果分析和审计记录，但 CLI 不自动编辑哲学正文：
-
-```bash
-loom philosophy impact <anchor>
-loom philosophy revise <anchor> --classification clarification --reason "<why>"
-loom philosophy revise <anchor> --classification minor --reason "<why>"
-loom philosophy revise <anchor> --classification major --reason "<why>"
-```
-
-前两条 revise 在没有 `--confirm` 时严格只读，并返回精确确认命令。确认 clarification 时 `--review` 必须为空，所有直接引用和传递影响均归入 `--unaffected`。确认 minor 时每个影响必须恰好一次归入 `--review` 或 `--unaffected`；review 中仅 `completed` 转为 `needs_review`，其余状态原样报告。两者均不改 acceptance，并写入下一个 `03_DECISIONS/PHIL-REV-NNN.md`。Major 即使带 `--confirm` 也不改当前版本，只提示 `loom version new`。哲学正文随后由 Weaver/用户单独编辑。
-
-## Patch 流程
-
-Patch 用于纯实现修正：bugfix、样式微调、文案 typo、测试补强。它不改变 Intent，也不改变验收契约。
-
-```bash
-# 1. 确认当前 Intent 都已完成
-loom guide
-
-# 2. 修改实现细节后，按项目约定跑测试 / lint
-
-# 3. 如修复影响已有承诺，补一条验证记录
-loom verify write --json-file <path>
-
-# 4. 通过 CLI 写入权威 JSON 并生成 Markdown 投影
-loom patch record --json-file <path>
-loom patch validate
-```
-
-Patch 不应使用 `loom version new`，也不应新增 Intent。如果变更需要改验收契约，它已经不是 Patch。
-完整输入契约见 `loom help patch`。
-
-## Minor 流程
-
-Minor 用于当前哲学和架构边界内的能力演进。
-
-常见情况：
-- 新增功能 → 由 Visionary 补叙事，Architect 增加 Intent，再进入 Intent Loop
-- 修改已有功能承诺 → 将相关 Intent 标记为 `needs_review`，重新验证 / 实现
-- 一个改动影响已完成 Intent → 通过反向依赖 / 哲学引用找影响面，标记 `needs_review`
-- 当前版本能力退出但仍需保留历史与依赖图 → 用 `intent deprecate` 记录 lifecycle，不虚构 `deprecated` status
-
-```bash
-# 新增：先创建 draft，再分别由 Visionary / Architect 补齐叙事、契约和锚点
-loom intent add --title "<title>" --depends-on INT-001,INT-002
-loom activate visionary --intent INT-003
-loom activate architect --intent INT-003
-loom intent finalize INT-003
-
-# 修订：revision 自动递增，并返回直接/传递反向依赖
-loom intent revise <id> --reason "<why>"
-loom activate visionary --intent <id>
-loom activate architect --intent <id>
-# 必须完整分类所有直接与传递下游；review 会使已完成下游回流复验
-loom intent finalize <id> --review <ids> --unaffected <ids>
-
-# 弃用：先评估，确认时完整分类所有直接和传递依赖方
-loom intent deprecate <id> --reason "<why>"
-loom intent deprecate <id> --reason "<why>" --confirm --review <ids> --unaffected <ids>
-
-# 继续按 guide 进入收敛趟
-loom guide
-```
-
-`add` / `revise` 在 finalize 前不修改官方 `04_INTENT_MAP.json` 和 `topo_order`。`add` 还会向愿景和验证文档追加明确标记的 draft 章节；finalize 通过后提升这些章节并删除 draft。新增 Intent 是 `pending`；修订保留 `pending` / `in_progress` / `blocked` / `needs_review`，原 `completed` 变为 `needs_review`，旧 revision 的验证自动失效。
-
-当前版本内演进不是偷懒；只要哲学前提、北极星、架构边界没变，Minor 就应该留在当前版本。
-
-弃用要求目标已完成。它写入 `lifecycle.deprecation = { deprecated_at, reason, replacement }`，不改变目标的 `completed` status，也不删除节点、依赖或契约。可选 replacement 必须是另一个当前版本 Intent。所有直接和传递依赖方必须在 review/unaffected 中恰好分类一次；叶子无需分类。重复确认会失败，避免不同参数被误认为已应用。
-
-## Major 升级流程
-
-\`\`\`bash
-# 1. 创建新版本（空目录 + 模板，自动切换为当前）
-loom version new
-
-# 2. 看文件变化与显式 Intent 沿革
-loom version diff v1 v2
-loom intent diff v1 v2
-
-# 3. Weaver 读旧哲学，织造新哲学
-loom activate weaver
-# → 必须读 .loom/v1/00_PHILOSOPHY/，记录"相对 v1 变了什么"
-
-# 4. Visionary 读旧愿景，定义新愿景
-loom activate visionary
-# → 必须读 .loom/v1/01_VISION.md
-
-# 5. Architect 读旧架构，设计新架构
-loom activate architect
-# → 必须读 .loom/v1/02_ARCHITECTURE.md + 04_INTENT_MAP.json
-
-# 6. 进入新版本的 Intent Loop
-\`\`\`
-
-## 关键设计
-
-- **空目录 + 模板**：\`loom version new\` 不自动复制旧版本内容。强制重新思考——参考 ≠ 复制。
-- **旧版本只读**：当前指针指向的版本是当前真相，旧版本保留作历史参考。
-- **显式 Intent lineage**：可用 `lineage: { predecessors: [{ version: "v1", intent_id: "INT-003" }], change_summary, change_ref? }` 表达修订、拆分或合并。它不属于 `depends_on`；同 ID/标题不会自动映射。
-- **版本元数据**：脚手架写入真实 `_loom_version`，并写入 `_parent_version`（v1 为 `null`，新版本为创建前的当前版本）。
-- **历史只读**：`v1:INT-003` 可用于 `intent get/narrative/trace` 和 `verify history`，写命令仍只操作当前版本。
-
-## 版本管理命令
-
-\`\`\`bash
-loom version list              # 列出所有版本（* 标记当前）
-loom version current           # 显示当前版本
-loom version new               # 创建 v{N+1} + 自动切换
-loom version use <v>           # 切换当前版本
-loom version diff <v1> <v2>    # 对比文件差异
-loom intent diff <v1> <v2>     # 对比显式 lineage 与语义字段
-loom verify history v2:INT-007 --across-versions
-\`\`\`
-
-## 切换回旧版本
-
-\`\`\`bash
-loom version use v1            # 切回 v1 查看历史
-loom intent trace v1:INT-003   # 无需切换即可只读历史 Intent
-loom version use v2            # 切回 v2 继续
-\`\`\`

package/cli/help/workflow.md

@@ -1,116 +0,0 @@
-## LOOM 工作流
-
-## 0. 诊断
-
-```bash
-loom guide
-loom context
-```
-
-只读探测使用 `loom guide --dry-run`。
-
-若 `guide` 指向 `loom activate <role>`，直接运行该命令。它会输出已经装配的 Context Pack；
-`guide` 只负责给出当前动作，不要求 Agent 逐个寻找文件。
-
-## 1. Doctrine — Weaver
-
-```bash
-loom activate weaver
-loom philosophy check
-```
-
-输出项目长期判断、卓越标准、决策原则、创作空间、反模式与 Evidence Map。
-研究数量不设配额；只保留真实改变判断、能够追溯的证据。
-
-## 2. Intent — Visionary
-
-```bash
-loom activate visionary
-```
-
-输出产品目标、成功图景、非目标与 Intent narrative。Visionary 不写 acceptance、DAG 或架构。
-
-## 3. Capability Graph — Architect
-
-```bash
-loom activate architect
-loom capability graph
-loom capability frontier
-loom capability coverage
-```
-
-在写 Intent Map 前，Architect 先完成 Lens Contract：对用户旅程、交互与可访问性、视觉与信息表达、内容与沟通、系统与数据、横切质量与风险逐项判断，并将适用项连接到具体图谱节点。随后才把愿景展开为项目问题面、能力缺口、风险与证据。图谱不是待办列表：高影响节点必须继续展开、形成项目化 Capability Brief、编译为 Intent，或带理由地延后/排除。每个 Intent 必须回链图谱；只有边界清楚且可独立验证的结果才进入 Intent Map。
-
-在创建 Intent Map 前还要通过 Impact Gate：Architect 为每个具体 capability 写影响判断；随后在**新的 Agent thread / 子代理**中运行 `loom activate impact-reviewer`，逐项复审 high/medium/low 和外部获取必要性，并写回 `impact_review`。高影响 capability 至少占全部具体 capability 的 30%（向上取整，至少一个）；通过 `loom capability coverage` 后才能进入 Contract。
-
-## 4. Contract — Architect
-
-```bash
-loom activate architect
-loom intent validate
-loom doctor
-```
-
-Architect 产出系统边界、Intent DAG、完成契约和可选质量契约，并声明
-`capability_needs` 与 `creative_scope`。
-
-完成契约定义 **Reliability Floor**：做到什么才算可靠完成。
-质量契约定义 **Distinctive Ceiling**：什么可观察差异让结果不止合格。
-
-## 5. Quality Engine — Forge 与 Keeper
-
-```bash
-loom intent next
-loom intent update <id> --status in_progress
-loom activate forge --intent <id>
-loom activate keeper --intent <id>
-```
-
-Forge 编译 Expertise Pack，在 Quality Arena 中实现与比较。
-Keeper 从当前磁盘事实和契约独立验证，不继承 Forge 的解释。
-
-当 `loom capability compile <id>` 报告 `acquisition.required=true` 时，先运行：
-
-```bash
-loom expertise init <id>
-# 实际执行 find skill / web / official docs / research 检索并填写 Pack
-loom expertise validate <id>
-```
-
-门未闭合时不能写入 passed。Keeper 会重新打开关键来源，passed 记录绑定当前 Pack。
-
-无质量契约时，四个基础维度通过即可闭合。存在质量契约时，额外验证
-`quality_achievement`；声明相对提升时，在该维度中链接 Quality Proof：
-
-```bash
-loom verify pass <id> \
-  --summary "<具体证据>" \
-  --reproduction-command "<可复现命令>" \
-  --quality-proof "<基线、比较和稳定性证据的位置>"
-
-loom intent done <id>
-```
-
-复杂或混合判定使用 `loom verify write --json-file <path>`。
-
-## 6. Reflow
-
-验证偏离时，不要把所有问题都扔回 Forge：
-
-- Doctrine 不足 → Weaver
-- 产品目标错误 → Visionary
-- 问题面、能力缺口或 Intent 路由遗漏 → Architect 更新 Capability Graph
-- 契约、边界或依赖错误 → Architect
-- 专业判断或实现不足 → Forge
-- 证据不足 → Keeper 补证或 `pending_human`
-
-连续三次 `deviated` 自动升级为 `blocked`。所有当前 revision 和当前验证 epoch 的 Intent 都有最新 passed
-记录，且没有 `needs_review`、`loom doctor` 没有 fatal/high 风险、`loom atlas validate` 通过当前版本的决策图谱交付门时，本轮收敛。
-
-## 7. 演进
-
-- Patch：不改变 Intent 语义，验证后记录 changelog。
-- Minor：用 `loom intent add|revise` 创建 draft，经限定作用域的 Visionary/Architect 更新后 finalize。
-- Major：Doctrine、北极星或主要架构边界改变，使用 `loom version new`。
-
-原则只有一句：流程成本必须小于它降低的风险；质量声明必须小于等于它拥有的证据。