@haaaiawd/loom 1.2.2 → 2.0.0

package/cli/src/preview-prompt.md

@@ -1,337 +0,0 @@
-# LOOM Preview 生成提示词
-
-你的任务：读 `.loom/` 目录下当前版本的所有文件，把信息**拆解成关键要点**，用最合适的视觉和交互手段呈现成一份 HTML 页面，写到 `loom-preview.html`。
-
-## 核心原则：信息密度靠视觉手段，不靠文字堆砌
-
-类比 PPT——PPT 不是把报告文字排成幻灯片，是用图表、图示、对比、交互把信息密度压缩到人类一眼能消化的程度。能用图就不表，能交互就不静态，能一句话就不写一段。
-
-### 错误 vs 正确
-
-| 错误（文字堆砌） | 正确（视觉手段） |
-|---|---|
-| 哲学全文渲染成 HTML | 北极星一句话 + 信念用图标网格 + 反模式用红色警告卡 |
-| Intent 列表表格 | SVG 依赖图，节点颜色=状态，一眼看出阻塞链 |
-| 验证记录 JSON 列表 | 时间轴，通过绿色偏离红色，点击节点看证据 |
-| 进度用文字描述 | 环形进度图 + 大数字仪表盘 |
-| 状态分布用表格 | 堆叠条形图，一段横条按状态颜色分段 |
-| 决策原则用列表 | 对比表，两列并排突出差异 |
-| 意图叙事全文展示 | 卡片网格，每张卡片一句话，点击展开详情 |
-
-### 拆解粒度
-
-每个信息块回答一个问题，人类 3 秒内能消化：
-- 产品为什么存在？→ 北极星一句话
-- 产品信什么？→ 3-5 个图标 + 关键句
-- 什么绝对不做？→ 红色警告卡，每张一句
-- 项目推进到哪了？→ 环形进度图 + 数字仪表盘
-- 谁阻塞谁？→ SVG 依赖图
-- 这个 Intent 为什么存在？→ 一句话叙事
-- 验证历史怎么样？→ 时间轴
-
-如果一个块需要读超过 3 行文字才能理解，它太长了——换一种视觉形式。
-
----
-
-## 去读哪些文件
-
-当前版本目录在 `.loom/current` 指针里（通常是 `.loom/v1/`）。读：
-
-| 文件 | 拆解出什么 |
-|---|---|
-| `00_PHILOSOPHY/*.md` | 北极星、核心信念、反模式、决策原则 |
-| `01_VISION.md` | 北极星、问题空间、意图叙事、不做什么 |
-| `02_ARCHITECTURE.md` | 关键决策、trade-offs |
-| `04_INTENT_MAP.json` | 依赖关系、状态、完成/质量契约、专业能力需求 |
-| `verifications/*.json` | 验证时间轴、基础维度、按需的质量维度与 Quality Proof |
-| `06_CHANGELOG.json` | Patch 历史（唯一权威来源）；不要从生成的 Markdown 反推数据 |
-| `06_CHANGELOG.md` | JSON 的确定性只读投影，仅用于交叉检查 |
-
-文件还是模板（含 `<!-- LOOM_TEMPLATE -->` 标记）时，对应区域显示提示："等待 {角色} 填充"。
-
----
-
-## 一、视觉手段库——什么信息用什么呈现
-
-不同信息适合不同视觉手段。不要什么都用卡片或列表——选最能压缩信息密度的方式。
-
-### 图表类（数据可视化）
-
-**环形进度图** — 适合：整体完成度
-一个圆环，填充比例 = completed/total。中心显示百分比。比横条进度条更紧凑、更视觉化。纯 SVG 实现。
-
-**堆叠条形图** — 适合：状态分布
-一段横条，按状态颜色分段（完成绿/进行中黄/待执行灰/阻塞红）。一段条形展示所有状态比例，比 4 个数字卡片更紧凑。
-
-**柱状图** — 适合：各 Intent 的验证轮数、各系统的 Intent 数量
-SVG 矩形，高度=数值。适合比较多个项的数量。
-
-**燃尽图风格折线** — 适合：剩余 Intent 随时间变化（如果有历史数据）
-SVG 折线，横轴时间，纵轴剩余数。
-
-### 图示类（关系和结构）
-
-**SVG 依赖图** — 适合：Intent 之间的依赖关系
-节点是 Intent，边是 depends_on。拓扑排序布局，无依赖的在左，依赖链向右。节点颜色按状态编码。节点可点击，点击后侧边面板显示详情。
-
-**热力图网格** — 适合：Intent × 验证轮次的通过/偏离矩阵
-行是 Intent，列是验证轮次，格子颜色=通过(绿)/偏离(红)/未验证(灰)。一眼看出哪个 Intent 反复偏离。
-
-**树状图** — 适合：架构的系统层级、Intent 的依赖树
-展开/折叠的树形结构，点击节点展开子项。
-
-### 交互类（探索和筛选）
-
-**过滤面板** — 适合：Intent 列表、验证记录
-复选框按状态过滤（全部/待执行/进行中/完成/阻塞），输入框模糊搜索。过滤后实时更新视图。
-
-**点击下钻** — 适合：从概览到详情
-概览页点击某个 Intent → 展开详情面板或跳到详情区。不在一页摊开所有详情，按需展开。
-
-**Hover 工具提示** — 适合：图表上的额外信息
-鼠标悬停在依赖图节点上 → 显示 tooltip（ID + 状态 + 一句话叙事）。不点击就能预览。
-
-**Tab 切换** — 适合：大板块切换
-概览 / Intent Map / 哲学 / 愿景 / 架构。所有内容先渲染堆叠，JS 切换显示。
-
-**可折叠面板** — 适合：分层信息
-默认折叠显示标题，点击展开内容。用 `max-height` 过渡，不要 `display: none`。
-
-### 布局类（组织和对比）
-
-**仪表盘** — 适合：关键指标概览
-大数字 + 颜色编码。数字 24-32px，标签 12-13px。一眼看到状态。
-
-**对比表** — 适合：trade-offs、做什么 vs 不做什么
-两列或三列并排，突出差异。每列一个方向，行是对比维度。
-
-**卡片网格** — 适合：核心信念、意图叙事
-每张卡片一个要点，标题 + 一句话。网格排列，大小一致。卡片内不超过 3 行。
-
-**时间轴** — 适合：验证历史、项目演进
-横向或纵向，每个节点一个事件。通过绿色偏离红色，附证据摘要。
-
-**看板列** — 适合：按状态分组的 Intent
-四列：待执行 / 进行中 / 完成 / 阻塞。每列下面是该状态的 Intent 卡片。一眼看出分布。
-
-**清单** — 适合：反模式、不做什么、决策原则
-每条一行 + 一句话理由。反模式用红色警告样式。
-
-### 标记类（状态和强调）
-
-**状态徽章** — 适合：Intent 状态
-颜色 + 图标 + 文字（不只靠颜色，色盲友好）：
-- 完成 = 绿色 + ✓
-- 进行中 = 黄色 + ◐
-- 待执行 = 灰色 + ○
-- 阻塞 = 红色 + ✕
-- 需复审 = 蓝色 + ?
-
-**高亮引用** — 适合：北极星、关键宣言
-大字号 + 左侧色条 + 引用样式。视觉上从周围内容跳出来。
-
----
-
-## 二、页面结构
-
-### 顶部：一屏概览
-
-人类打开第一眼看到全局：
-
-- 项目名 + 版本号
-- 北极星一句话（高亮引用样式，最醒目）
-- **环形进度图**：完成 X/Y（百分比）
-- **堆叠条形图**：状态分布（一段条形展示所有状态比例）
-- **数字仪表盘**：进行中 N、阻塞 M（大数字 + 颜色）
-
-### Intent Map 区域
-
-项目推进到哪了——用多种手段呈现不同维度：
-
-- **SVG 依赖图**：依赖链和阻塞点
-- **看板列**：按状态分组的 Intent 卡片（待执行/进行中/完成/阻塞）
-- **过滤面板**：状态过滤 + 模糊搜索（Intent 多时）
-- **点击下钻**：点击节点或卡片 → 侧边详情面板（叙事、完成/质量契约、能力需求、验证历史）
-
-### 哲学区域
-
-"我们信什么"——拆解成视觉块：
-
-- **北极星**：高亮引用，一句话
-- **核心信念**：卡片网格，每张一个图标 + 关键句
-- **不可妥协的价值**：清单，每条一句话 + 一句话理由
-- **反模式**：红色警告卡，每张一句
-- **决策原则**：对比表或清单，遇到冲突时怎么取舍
-- **灵感来源**：哲学文档里的"灵感来源"章节——展示参考的艺术家、机构、流派、著作。这是 LOOM 哲学织造的核心机制：从真实思想体系萃取核心思想。每个来源用卡片或标签展示：名字（如 Dieter Rams / Stripe / Unix Philosophy / Anthropic）+ 一句话说明"从这个体系萃取了什么原则" + 来源引用（著作/URL）。这些名字是"思想压缩包的索引"——人类看到名字就能激活对这套哲学的理解。不要把灵感来源藏在正文里，要作为独立视觉块展示。
-
-### 愿景区域
-
-"我们要去哪"——拆解：
-
-- **北极星**：和哲学呼应
-- **问题空间**：一段话
-- **意图叙事**：卡片网格，每个意图一张卡片，一句话"为什么存在"，点击展开详情
-- **不做什么**：清单，和"做什么"同样醒目
-
-### 架构区域（如果有）
-
-"怎么实现"——拆解：
-
-- **关键决策对比表**：每个决策两列对比（选了什么 / 放弃了什么）
-- **trade-offs 清单**：每条一句话
-
-### 验证历史区域（如果有）
-
-"质量怎么样"——拆解：
-
-- **时间轴**：每次验证一个节点，通过/偏离用颜色区分，点击看证据
-- **热力图网格**（Intent 多时）：Intent × 验证轮次矩阵，一眼看出哪个反复偏离
-- **偏离清单**：哪些 Intent 偏离了，证据是什么
-
-### Patch 历史区域（如果有）
-
-- 从 `06_CHANGELOG.json` 展示 Patch 时间轴：摘要、原因、影响的 Intent、文件和已记录的验证结果
-- 明确区分 Patch 与 Intent 验证；`06_CHANGELOG.md` 是生成文件，不是另一份真相
-
-### 底部
-
-- 提醒：这是只读投影，修改请编辑源文件后运行 `loom preview` 重新生成
-- 可选：一个"复制项目状态"按钮
-
----
-
-## 三、符合人类直觉
-
-### 视觉权重
-
-最重要的信息最大、最醒目。次要信息小、灰、退后：
-- 北极星 → 全页最大字号
-- 进度数字 → 大数字 + 颜色
-- Intent ID → 中等字号，等宽字体
-- 完成契约正文 → 小字，可展开才显示；质量契约与 Quality Proof 使用相邻但可区分的区域
-- 辅助说明 → 最小字，灰色
-
-不要所有文字一样大。人类靠大小判断重要性。
-
-### 渐进披露
-
-不要一次把所有信息摊开。先给摘要，想看详情再展开：
-- Intent 卡片默认折叠，只显示 ID + 状态 + 一句话
-- 点击展开后显示：意图叙事、验收契约、哲学锚点、验证历史
-- 图表上 Hover 显示 tooltip 预览，点击才展开完整详情
-
-### 信息分组
-
-相关信息放一起，不相关的用空间分隔：
-- 进度概览自成一个区块
-- Intent 依赖图 + 详情面板自成一个区块
-- 哲学、愿景、架构各自独立区块
-- 区块之间用足够留白分隔（32-48px），不要挤
-
----
-
-## 四、视觉设计原则
-
-参考 Anthropic 和 CopilotKit 的 Generative UI 设计系统：
-
-### 平面克制
-
-- **无渐变**：纯色背景
-- **无阴影**：用边框区分层次
-- **无模糊**：不要 filter: blur
-- **无发光**：不要 text-shadow 或 glow
-- **无装饰性 emoji**：用 CSS 形状或 SVG 路径做图标
-
-### 字体克制
-
-- 只用两种字重：400（正文）和 500（标题/强调）
-- 不要 600、700——太重，破坏平面感
-- 标题用句首大写，不要全大写
-- 正文不要句中加粗，用 `code style` 标记实体名
-- 最小字号 12px
-
-### 边框和间距
-
-- 边框 `1px solid`
-- 卡片圆角 8-12px
-- 卡片内边距 16-20px
-- 卡片之间间距 16-24px
-- 区块之间间距 32-48px——大间距区分大板块
-
-### CSS 变量
-
-```css
-:root {
-  --bg: ...;
-  --surface: ...;
-  --border: ...;
-  --text: ...;
-  --text-muted: ...;
-  --accent: ...;
-  --success: ...;
-  --warning: ...;
-  --danger: ...;
-}
-```
-
-不要在 HTML 里硬编码颜色。所有颜色引用变量。
-
-### 配色自定
-
-不要求暗色也不要求亮色。选你觉得让信息最易读的方案。关键是：
-- 背景和文字对比度足够（WCAG AA 标准）
-- 状态颜色区分明显
-- 不要花哨——信息是主角，视觉是配角
-
----
-
-## 五、技术约束
-
-- **单文件**：所有 HTML/CSS/JS 内联，零外部依赖
-- **零构建**：双击即可在浏览器打开
-- **内联 SVG**：图表和依赖图直接写 `<svg>`，不用 `<img>` 或外部库
-- **语义化 HTML**：用 `<section>` `<nav>` `<article>` `<button>`
-- **响应式**：手机宽度下布局不崩（`@media (max-width: 768px)`）
-
----
-
-## 六、质量检查清单
-
-生成前逐项确认：
-
-**信息密度**
-- [ ] 每个信息块用最合适的视觉手段，不是什么都用卡片或列表
-- [ ] 能用图表展示的数据不用表格
-- [ ] 能用图示展示的关系不用文字描述
-- [ ] 每个块 3 秒内能消化，不超过 3 行文字
-
-**功能**
-- [ ] 双击能在浏览器打开，不需要任何外部资源
-- [ ] SVG 依赖图节点颜色按状态编码
-- [ ] 点击 Intent 能展开详情
-- [ ] Tab 切换正常
-- [ ] 图表 Hover 有 tooltip（如果适用）
-
-**视觉**
-- [ ] 无渐变、无阴影、无模糊、无发光
-- [ ] 字重只有 400 和 500
-- [ ] 所有颜色用 CSS 变量
-- [ ] 边框统一 1px
-- [ ] 信息层次清晰（大字重要，小字次要）
-
-**可访问性**
-- [ ] `@media (prefers-reduced-motion: reduce)` 禁用动画
-- [ ] 对比度足够
-- [ ] 点击区域 ≥ 44px
-- [ ] 不仅靠颜色传达信息（颜色 + 图标 + 文字）
-
-**响应式**
-- [ ] 手机宽度下布局不崩
-- [ ] SVG 依赖图横向滚动
-- [ ] Tab 导航横向滚动
-
----
-
-## 输出
-
-把 HTML 写到 `loom-preview.html`。完成后告诉用户文件路径。

package/cli/src/preview.js

@@ -1,73 +0,0 @@
-// preview — 输出提示词，让 AI 读 .loom/ 文件并生成 HTML，并检查投影新鲜度。
-// CLI 不生成 HTML。AI 自己读文件、重组信息、生成 HTML。
-
-import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
-import { join, relative } from 'node:path';
-import { readCurrentPointer } from './shared/paths.js';
-
-const PROMPT_PATH = new URL('./preview-prompt.md', import.meta.url);
-const SOURCE_FILE_NAMES = new Set([
-  '01_VISION.md',
-  '02_ARCHITECTURE.md',
-  '04_INTENT_MAP.json',
-  '05_VERIFICATION.md',
-  '06_CHANGELOG.json',
-  '06_CHANGELOG.md',
-]);
-
-/**
- * 输出 preview 提示词。
- * @returns {string}
- */
-export function generatePreviewPrompt() {
-  return readFileSync(PROMPT_PATH, 'utf-8');
-}
-
-function shouldIncludeSource(filePath) {
-  const normalized = filePath.replace(/\\/g, '/');
-  const fileName = normalized.split('/').pop();
-  if (SOURCE_FILE_NAMES.has(fileName)) return true;
-  return normalized.includes('/00_PHILOSOPHY/')
-    || normalized.includes('/03_DECISIONS/')
-    || normalized.includes('/verifications/');
-}
-
-function collectSourceFiles(dir, files = []) {
-  if (!existsSync(dir)) return files;
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
-    const fullPath = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      collectSourceFiles(fullPath, files);
-    } else if (shouldIncludeSource(fullPath)) {
-      files.push(fullPath);
-    }
-  }
-  return files;
-}
-
-export function getPreviewStatus(projectDir) {
-  const previewPath = join(projectDir, 'loom-preview.html');
-  const loomRoot = join(projectDir, '.loom');
-  const current = readCurrentPointer(loomRoot);
-  const versionDir = current ? join(loomRoot, current) : null;
-  const sourceFiles = versionDir ? collectSourceFiles(versionDir) : [];
-  const latestSource = sourceFiles
-    .map((filePath) => ({ filePath, mtimeMs: statSync(filePath).mtimeMs }))
-    .sort((a, b) => b.mtimeMs - a.mtimeMs)[0] || null;
-
-  const exists = existsSync(previewPath);
-  const previewMtimeMs = exists ? statSync(previewPath).mtimeMs : null;
-  const sourceLatestMtimeMs = latestSource?.mtimeMs ?? null;
-  const fresh = exists && sourceLatestMtimeMs !== null && previewMtimeMs >= sourceLatestMtimeMs;
-
-  return {
-    exists,
-    fresh,
-    version: current,
-    preview_path: previewPath,
-    preview_mtime: previewMtimeMs ? new Date(previewMtimeMs).toISOString() : null,
-    source_latest_mtime: sourceLatestMtimeMs ? new Date(sourceLatestMtimeMs).toISOString() : null,
-    latest_source_file: latestSource ? relative(projectDir, latestSource.filePath).replace(/\\/g, '/') : null,
-    next_command: fresh ? 'loom preview' : 'loom preview --regen',
-  };
-}

package/cli/src/shared/intent-ref.js

@@ -1,38 +0,0 @@
-// intent-ref.js — Resolve current and version-qualified Intent read references.
-
-import { existsSync } from 'node:fs';
-import { basename, dirname, join } from 'node:path';
-
-export const VERSION_PATTERN = /^v\d+$/;
-export const INTENT_ID_PATTERN = /^INT-\d+$/;
-
-export function formatIntentRef(version, intentId) {
-  return `${version}:${intentId}`;
-}
-
-/** Resolve INT-003 against the current version or v1:INT-003 against .loom/v1. */
-export function resolveIntentRef(currentVersionDir, input) {
-  const currentVersion = basename(currentVersionDir);
-  if (!VERSION_PATTERN.test(currentVersion)) {
-    throw new Error(`无法从目录确定当前 LOOM 版本: ${currentVersionDir}`);
-  }
-
-  const parts = String(input || '').split(':');
-  if (parts.length > 2) throw new Error(`Intent 引用格式非法: ${input}`);
-  const qualified = parts.length === 2;
-  const version = qualified ? parts[0] : currentVersion;
-  const intentId = qualified ? parts[1] : parts[0];
-  if (!VERSION_PATTERN.test(version) || !INTENT_ID_PATTERN.test(intentId)) {
-    throw new Error(`Intent 引用格式非法: ${input}（应为 INT-003 或 v1:INT-003）`);
-  }
-
-  const versionDir = qualified ? join(dirname(currentVersionDir), version) : currentVersionDir;
-  if (!existsSync(versionDir)) throw new Error(`版本不存在: ${version}`);
-  return {
-    ref: formatIntentRef(version, intentId),
-    version,
-    intentId,
-    versionDir,
-    historical: version !== currentVersion,
-  };
-}

package/cli/src/shared/md-utils.js

@@ -1,125 +0,0 @@
-// shared/md-utils.js — MD 章节解析的公共工具
-// 提取自 philosophy.js / intent-map.js / verify.js 三处重复实现。
-// 统一 slugify + extractMdSection + 显式锚点逻辑，修中文标题 bug。
-
-import { readFileSync, existsSync } from 'node:fs';
-
-/**
- * 从 heading 文本中提取显式锚点。
- * 支持 Pandoc/MDX 风格语法: "## 核心信念 {#core-belief}"
- * @param {string} headingText — heading 文本（不含 # 前缀）
- * @returns {string|null} 显式锚点 slug，或 null（无显式锚点时）
- */
-export function extractExplicitAnchor(headingText) {
-  const match = headingText.match(/\{#([\w-]+)\}\s*$/);
-  return match ? match[1] : null;
-}
-
-/**
- * 从 heading 文本生成 slug（fallback，无显式锚点时用）。
- * 规则：小写、去除 \r、空格转连字符、去除非 [a-z0-9_-] 字符。
- *
- * 中文标题处理：\w 不匹配中文，所以纯中文标题 slugify 后是空字符串。
- * 这是设计约束——中文标题必须用显式锚点 {#anchor} 标注。
- * slugify 返回空字符串时，调用方应给出明确错误提示。
- *
- * @param {string} text — heading 文本
- * @returns {string} slug（可能为空字符串——纯中文标题无显式锚点时）
- */
-export function slugify(text) {
-  return text
-    .replace(/\r/g, '')           // strip CRLF 的 \r
-    .replace(/\{#[\w-]+\}\s*$/, '') // 去掉显式锚点标记
-    .toLowerCase()
-    .replace(/[^\w\s-]/g, '')     // \w = [a-zA-Z0-9_]
-    .replace(/\s+/g, '-')
-    .replace(/-+/g, '-')
-    .replace(/^-|-$/g, '')
-    .trim();
-}
-
-/**
- * 从 MD 内容中提取指定 section 的内容（到下一个同级或更高级 heading 为止）。
- * 如果 sectionSlug 为 null/空，返回整个文件。
- * 支持显式锚点 {#slug} 和自动 slugify 两种方式匹配。
- *
- * @param {string} content — MD 文件内容
- * @param {string} sectionSlug — 目标 section 的 slug
- * @param {string} contextLabel — 错误信息里的上下文标签（如 "意图叙事"、"验证契约"）
- * @returns {string} 提取的章节内容
- * @throws {Error} 章节未找到时抛错，错误信息包含 contextLabel 和 slug
- */
-export function extractMdSection(content, sectionSlug, contextLabel = '章节') {
-  if (!sectionSlug) return content;
-
-  const lines = content.split('\n');
-  let capturing = false;
-  let targetLevel = 0;
-  const captured = [];
-
-  for (const line of lines) {
-    // strip \r 以兼容 Windows CRLF
-    const cleanLine = line.replace(/\r$/, '');
-    const headingMatch = cleanLine.match(/^(#{1,6})\s+(.+)$/);
-    if (headingMatch) {
-      const level = headingMatch[1].length;
-      const headingText = headingMatch[2];
-      // 优先用显式锚点，没有再 fallback 到 slugify
-      const slug = extractExplicitAnchor(headingText) || slugify(headingText);
-
-      if (capturing && level <= targetLevel) {
-        break;
-      }
-      if (slug === sectionSlug) {
-        capturing = true;
-        targetLevel = level;
-        captured.push(cleanLine);
-        continue;
-      }
-    }
-    if (capturing) {
-      captured.push(cleanLine);
-    }
-  }
-
-  if (captured.length === 0) {
-    throw new Error(
-      `${contextLabel}章节未找到: #${sectionSlug}\n` +
-      `可能原因：\n` +
-      `  1. 章节标题用了中文但没加显式锚点 {#anchor}\n` +
-      `  2. 锚点 slug 拼写错误\n` +
-      `  3. 引用的文件不存在该章节`
-    );
-  }
-  return captured.join('\n').trim();
-}
-
-/**
- * 安全读取并解析 JSON 文件。
- * 统一错误处理——文件不存在、JSON 解析失败时给出明确错误信息。
- *
- * @param {string} filePath — JSON 文件绝对路径
- * @param {string} contextLabel — 错误信息里的上下文标签（如 "Intent Map"、"验证记录"）
- * @returns {object} 解析后的 JSON 对象
- * @throws {Error} 文件不存在或 JSON 解析失败时抛错，错误信息包含文件路径和原因
- */
-export function readJsonFile(filePath, contextLabel = 'JSON 文件') {
-  if (!existsSync(filePath)) {
-    throw new Error(`${contextLabel}文件不存在: ${filePath}`);
-  }
-  let raw;
-  try {
-    raw = readFileSync(filePath, 'utf-8');
-  } catch (e) {
-    throw new Error(`${contextLabel}文件读取失败: ${filePath}\n原因: ${e.message}`);
-  }
-  try {
-    return JSON.parse(raw);
-  } catch (e) {
-    throw new Error(
-      `${contextLabel}文件 JSON 解析失败: ${filePath}\n` +
-      `原因: ${e.message}\n` +
-      `请检查文件内容是否为合法 JSON（多余逗号、缺少引号等）。`
-    );
-  }
-}

package/cli/src/shared/paths.js

@@ -1,73 +0,0 @@
-// shared/paths.js — LOOM 路径解析的公共工具
-// 统一 getLoomRoot / findLoomRoot / findVersionDir 的命名和实现。
-
-import { resolve, join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
-import { argv, cwd } from 'node:process';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-/**
- * 获取 LOOM 框架根目录（cli/src/shared 的上上上级）。
- * cli/src/shared/paths.js -> cli/src/shared -> cli/src -> cli -> LOOM root
- * @returns {string} LOOM 框架根目录绝对路径
- */
-export function getLoomRoot() {
-  return resolve(__dirname, '..', '..', '..');
-}
-
-/**
- * 从命令行参数或 cwd 推断 .loom 目录路径。
- * 优先级：--loom-dir 参数（指向版本目录，反推 .loom root）> cwd/.loom
- * @returns {string} .loom 目录绝对路径
- */
-export function findLoomRoot() {
-  const flagIdx = argv.indexOf('--loom-dir');
-  if (flagIdx !== -1 && argv[flagIdx + 1]) {
-    // --loom-dir 直接指向版本目录，反推 .loom root
-    const dir = resolve(argv[flagIdx + 1]);
-    return resolve(dir, '..');
-  }
-  return join(cwd(), '.loom');
-}
-
-/**
- * 从命令行参数或 .loom/current 指针推断当前版本目录。
- * @returns {string} .loom/v{N} 目录绝对路径
- * @throws {Error} .loom 不存在或没有版本目录时抛错
- */
-export function findVersionDir() {
-  const flagIdx = argv.indexOf('--loom-dir');
-  if (flagIdx !== -1 && argv[flagIdx + 1]) {
-    return resolve(argv[flagIdx + 1]);
-  }
-  const loomRoot = join(cwd(), '.loom');
-  if (!existsSync(loomRoot)) {
-    throw new Error(`找不到 .loom 目录: ${loomRoot}`);
-  }
-  const current = readCurrentPointer(loomRoot);
-  if (!current) {
-    throw new Error(`.loom 下没有版本目录 (v1, v2, ...)`);
-  }
-  return join(loomRoot, current);
-}
-
-/**
- * 读取当前版本指针。
- * 优先读 .loom/current 文件；不存在则回退到自动探测最新版本。
- * @param {string} loomRoot — .loom 目录路径
- * @returns {string|null} 版本号如 'v1'，或 null
- */
-export function readCurrentPointer(loomRoot) {
-  const pointerPath = join(loomRoot, 'current');
-  if (existsSync(pointerPath)) {
-    const v = readFileSync(pointerPath, 'utf-8').trim();
-    if (/^v\d+$/.test(v) && existsSync(join(loomRoot, v))) return v;
-  }
-  if (!existsSync(loomRoot)) return null;
-  const versions = readdirSync(loomRoot)
-    .filter((d) => /^v\d+$/.test(d) && statSync(join(loomRoot, d)).isDirectory())
-    .sort((a, b) => parseInt(b.slice(1)) - parseInt(a.slice(1)));
-  return versions[0] ?? null;
-}

package/cli/src/shared/proof-reference.js

@@ -1,19 +0,0 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { isAbsolute, relative, resolve } from 'node:path';
-import { extractMdSection } from './md-utils.js';
-
-/** Resolve a root-relative Markdown proof reference without allowing path escape. */
-export function resolveQualityProofReference(versionDir, ref) {
-  if (typeof ref !== 'string' || !ref.trim()) throw new Error('quality_proof_ref 必须是非空字符串');
-  const match = ref.trim().match(/^([^#]+)#([\w-]+)$/);
-  if (!match) throw new Error('quality_proof_ref 必须是项目相对路径加 Markdown 锚点，例如 verifications/INT-001-quality-proof.md#int-001');
-  const [, file, anchor] = match;
-  if (isAbsolute(file)) throw new Error('quality_proof_ref 不得使用绝对路径');
-  const projectDir = resolve(versionDir, '..', '..');
-  const filePath = resolve(projectDir, file);
-  const relation = relative(projectDir, filePath);
-  if (relation.startsWith('..') || isAbsolute(relation)) throw new Error('quality_proof_ref 不得越出项目目录');
-  if (!existsSync(filePath)) throw new Error(`quality_proof_ref 指向的文件不存在: ${file}`);
-  extractMdSection(readFileSync(filePath, 'utf-8'), anchor, 'Quality Proof');
-  return { filePath, anchor, ref: ref.trim() };
-}