@haaaiawd/loom 0.8.0 → 0.9.0

package/cli/src/diagnostics.js

@@ -2,102 +2,105 @@
 // 提供 doctor / context / trace / reverse-dep / reverse-ref 五个聚合命令。
 // 全部是只读的数据聚合，不做决策、不修改文件。
 
-import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
-import { join } from 'node:path';
-import { loadIntentMap, getStatus, getNextIntent, getNarrative, getIntent } from './intent-map.js';
-import { getPhilosophy, validateInspirationSources, validatePartDecomposition } from './philosophy.js';
-import { getVerificationHistory, getPendingVerifications, getVerificationContract } from './verify.js';
-
-function readIntentMapRaw(versionDir) {
-  const filePath = join(versionDir, '04_INTENT_MAP.json');
-  if (!existsSync(filePath)) return null;
-  return JSON.parse(readFileSync(filePath, 'utf-8'));
-}
-
-function summarizeRawIntentMap(data) {
-  const intents = data?.intents && typeof data.intents === 'object' ? data.intents : {};
-  const ids = { pending: [], in_progress: [], completed: [], blocked: [], needs_review: [] };
-  const titles = {};
-
-  for (const [id, intent] of Object.entries(intents)) {
-    const status = intent?.status;
-    if (ids[status]) ids[status].push(id);
-    titles[id] = intent?.title || '';
-  }
-
-  return {
-    counts: {
-      pending: ids.pending.length,
-      in_progress: ids.in_progress.length,
-      completed: ids.completed.length,
-      blocked: ids.blocked.length,
-      needs_review: ids.needs_review.length,
-      total: Object.keys(intents).length,
-    },
-    ids,
-    titles,
-  };
-}
-
-function intentMapDiagnostics(versionDir) {
-  const issues = [];
-  let raw = null;
-  let valid = null;
-  let validMap = null;
-
-  try {
-    raw = readIntentMapRaw(versionDir);
-  } catch (e) {
-    issues.push({ id: 'intent_map', type: 'intent_map_unreadable', severity: 'fatal', msg: `Intent Map 无法读取或 JSON 损坏: ${e.message}` });
-    return { raw, valid, issues, validMap: null };
-  }
-
-  if (!raw) {
-    issues.push({ id: 'intent_map', type: 'intent_map_missing', severity: 'fatal', msg: '缺少 04_INTENT_MAP.json' });
-    return { raw, valid, issues, validMap: null };
-  }
-
-  if (raw._meta?._template === true) {
-    issues.push({ id: 'intent_map', type: 'intent_map_template', severity: 'high', msg: 'Intent Map 仍是模板，尚未由 Architect 产出真实意图图' });
-  }
-
-  try {
-    validMap = loadIntentMap(versionDir);
-    valid = true;
-  } catch (e) {
-    valid = false;
-    issues.push({ id: 'intent_map', type: 'intent_map_invalid', severity: 'fatal', msg: e.message });
-  }
-
-  return { raw, valid, issues, validMap };
-}
-
-function getIntentVerificationMethod(intent) {
-  return intent.verification_method || intent._optional?.verification_method || null;
-}
-
-function normalizeVerificationCommand(command) {
-  return String(command || '')
-    .replace(/^\s*run\s+/i, '')
-    .replace(/^\s*exec\s+/i, '')
-    .replace(/\s+/g, ' ')
-    .trim();
-}
-
-function commandCoversMethod(actualCommand, expectedMethod) {
-  const actual = normalizeVerificationCommand(actualCommand);
-  const expected = normalizeVerificationCommand(expectedMethod);
-  if (!actual || !expected) return false;
-
-  return expected.split('&&').every((part) => {
-    const expectedPart = normalizeVerificationCommand(part);
-    if (!expectedPart) return true;
-    if (actual.includes(expectedPart)) return true;
-    // npm test is an acceptable broader reproduction for node --test based methods.
-    if (expectedPart.startsWith('node --test') && actual.includes('npm test')) return true;
-    return false;
-  });
-}
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadIntentMap, getStatus, getNextIntent, getNarrative, getIntent } from './intent-map.js';
+import { getPhilosophy, validateInspirationSources, validatePartDecomposition } from './philosophy.js';
+import { getVerificationHistory, getPendingVerifications, getVerificationContract } from './verify.js';
+
+function readIntentMapRaw(versionDir) {
+  const filePath = join(versionDir, '04_INTENT_MAP.json');
+  if (!existsSync(filePath)) return null;
+  return JSON.parse(readFileSync(filePath, 'utf-8'));
+}
+
+function summarizeRawIntentMap(data) {
+  const intents = data?.intents && typeof data.intents === 'object' ? data.intents : {};
+  const ids = { pending: [], in_progress: [], completed: [], blocked: [], needs_review: [] };
+  const titles = {};
+
+  for (const [id, intent] of Object.entries(intents)) {
+    const status = intent?.status;
+    if (ids[status]) ids[status].push(id);
+    titles[id] = intent?.title || '';
+  }
+
+  return {
+    counts: {
+      pending: ids.pending.length,
+      in_progress: ids.in_progress.length,
+      completed: ids.completed.length,
+      blocked: ids.blocked.length,
+      needs_review: ids.needs_review.length,
+      total: Object.keys(intents).length,
+    },
+    ids,
+    titles,
+  };
+}
+
+function intentMapDiagnostics(versionDir) {
+  const issues = [];
+  let raw = null;
+  let valid = null;
+  let validMap = null;
+
+  try {
+    raw = readIntentMapRaw(versionDir);
+  } catch (e) {
+    issues.push({ id: 'intent_map', type: 'intent_map_unreadable', severity: 'fatal', msg: `Intent Map 无法读取或 JSON 损坏: ${e.message}` });
+    return { raw, valid, issues, validMap: null };
+  }
+
+  if (!raw) {
+    issues.push({ id: 'intent_map', type: 'intent_map_missing', severity: 'fatal', msg: '缺少 04_INTENT_MAP.json' });
+    return { raw, valid, issues, validMap: null };
+  }
+
+  const isTemplate = raw._meta?._template === true;
+  if (isTemplate) {
+    issues.push({ id: 'intent_map', type: 'intent_map_template', severity: 'high', msg: 'Intent Map 仍是模板，尚未由 Architect 产出真实意图图' });
+  }
+
+  try {
+    validMap = loadIntentMap(versionDir);
+    valid = true;
+  } catch (e) {
+    valid = false;
+    // 模板状态下字段缺失是预期的，降级为 high 而非 fatal
+    // 非模板状态下字段缺失是真正的损坏，保持 fatal
+    issues.push({ id: 'intent_map', type: 'intent_map_invalid', severity: isTemplate ? 'high' : 'fatal', msg: e.message });
+  }
+
+  return { raw, valid, issues, validMap };
+}
+
+function getIntentVerificationMethod(intent) {
+  return intent.verification_method || intent._optional?.verification_method || null;
+}
+
+function normalizeVerificationCommand(command) {
+  return String(command || '')
+    .replace(/^\s*run\s+/i, '')
+    .replace(/^\s*exec\s+/i, '')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+function commandCoversMethod(actualCommand, expectedMethod) {
+  const actual = normalizeVerificationCommand(actualCommand);
+  const expected = normalizeVerificationCommand(expectedMethod);
+  if (!actual || !expected) return false;
+
+  return expected.split('&&').every((part) => {
+    const expectedPart = normalizeVerificationCommand(part);
+    if (!expectedPart) return true;
+    if (actual.includes(expectedPart)) return true;
+    // npm test is an acceptable broader reproduction for node --test based methods.
+    if (expectedPart.startsWith('node --test') && actual.includes('npm test')) return true;
+    return false;
+  });
+}
 
 // ─── doctor ────────────────────────────────────────────
 // 全面健康检查：一致性 + 孤儿引用 + 循环依赖 + 僵尸 Intent
@@ -109,16 +112,16 @@ function commandCoversMethod(actualCommand, expectedMethod) {
  * @param {string} philosophyDir — 哲学目录
  * @returns {{ issues: object[], summary: object }}
  */
-export function doctor(versionDir, verificationsDir, philosophyDir) {
-  const mapState = intentMapDiagnostics(versionDir);
-  const issues = [...mapState.issues];
-
-  if (!mapState.validMap) {
-    appendPhilosophyDiagnostics(issues, philosophyDir);
-    return { issues, summary: summarizeIssues(issues) };
-  }
-
-  const { intents } = mapState.validMap;
+export function doctor(versionDir, verificationsDir, philosophyDir) {
+  const mapState = intentMapDiagnostics(versionDir);
+  const issues = [...mapState.issues];
+
+  if (!mapState.validMap) {
+    appendPhilosophyDiagnostics(issues, philosophyDir);
+    return { issues, summary: summarizeIssues(issues) };
+  }
+
+  const { intents } = mapState.validMap;
 
   // 1. 状态一致性：in_progress/completed 但无验证记录
   for (const [id, intent] of Object.entries(intents)) {
@@ -188,13 +191,13 @@ export function doctor(versionDir, verificationsDir, philosophyDir) {
     }
   }
 
-  // 7. 验证脚本可执行性：检查 verification_method 引用的脚本/目录是否存在
-  const projectDir = join(versionDir, '..', '..');
-  for (const [id, intent] of Object.entries(intents)) {
-    const vm = getIntentVerificationMethod(intent);
-    if (!vm) continue;
-    // 检测 npm test 引用
-    if (vm.includes('npm test') || vm.includes('npm run test')) {
+  // 7. 验证脚本可执行性：检查 verification_method 引用的脚本/目录是否存在
+  const projectDir = join(versionDir, '..', '..');
+  for (const [id, intent] of Object.entries(intents)) {
+    const vm = getIntentVerificationMethod(intent);
+    if (!vm) continue;
+    // 检测 npm test 引用
+    if (vm.includes('npm test') || vm.includes('npm run test')) {
       const pkgPath = join(projectDir, 'package.json');
       if (!existsSync(pkgPath)) {
         issues.push({ id, type: 'test_script_missing', severity: 'medium', msg: `${id} verification_method 要求 npm test 但项目根没有 package.json` });
@@ -218,61 +221,61 @@ export function doctor(versionDir, verificationsDir, philosophyDir) {
         } catch {
           // package.json 解析失败，不报——不是 doctor 的职责
         }
-      }
-    }
-  }
-
-  // 8. completed Intent 的 verification_method 必须被最新验证记录覆盖，防止契约命令漂移。
-  for (const [id, intent] of Object.entries(intents)) {
-    if (intent.status !== 'completed') continue;
-    const method = getIntentVerificationMethod(intent);
-    if (!method) continue;
-
-    const expected = normalizeVerificationCommand(method);
-    if (!expected || expected === 'human_review') continue;
-
-    const history = getVerificationHistory(verificationsDir, id);
-    const latest = history?.records?.[history.records.length - 1];
-    const actual = normalizeVerificationCommand(latest?.reproduction_command);
-
-    if (!latest) {
-      issues.push({ id, type: 'verification_method_unverified', severity: 'high', msg: `${id} 声明了 verification_method 但没有验证记录覆盖: ${method}` });
-    } else if (!actual) {
-      issues.push({ id, type: 'verification_method_unverified', severity: 'high', msg: `${id} 最新验证记录缺少 reproduction_command，无法复现 verification_method: ${method}` });
-    } else if (!commandCoversMethod(actual, expected)) {
-      issues.push({ id, type: 'verification_method_drift', severity: 'high', msg: `${id} verification_method 未被最新 reproduction_command 覆盖。method="${method}" reproduction_command="${latest.reproduction_command}"` });
-    }
-  }
-
-  appendPhilosophyDiagnostics(issues, philosophyDir);
-  return { issues, summary: summarizeIssues(issues) };
-}
-
-function appendPhilosophyDiagnostics(issues, philosophyDir) {
-  // 哲学灵感来源校验（防止 Weaver 从训练数据"背"几个名字就交差）
-  if (!existsSync(philosophyDir)) return;
-
-  const inspirationCheck = validateInspirationSources(philosophyDir);
-  for (const issue of inspirationCheck.issues) {
-    issues.push({ id: 'philosophy', type: 'inspiration_source', severity: issue.severity, msg: issue.msg });
-  }
-
-  // 实现部分拆解校验（防止 Weaver 跳过拆解步骤）
-  const decompositionCheck = validatePartDecomposition(philosophyDir);
-  for (const issue of decompositionCheck.issues) {
-    issues.push({ id: 'philosophy', type: 'part_decomposition', severity: issue.severity, msg: issue.msg });
-  }
-}
-
-function summarizeIssues(issues) {
-  return {
-    total_issues: issues.length,
-    fatal: issues.filter((i) => i.severity === 'fatal').length,
-    high: issues.filter((i) => i.severity === 'high').length,
-    medium: issues.filter((i) => i.severity === 'medium').length,
-    healthy: issues.length === 0,
-  };
-}
+      }
+    }
+  }
+
+  // 8. completed Intent 的 verification_method 必须被最新验证记录覆盖，防止契约命令漂移。
+  for (const [id, intent] of Object.entries(intents)) {
+    if (intent.status !== 'completed') continue;
+    const method = getIntentVerificationMethod(intent);
+    if (!method) continue;
+
+    const expected = normalizeVerificationCommand(method);
+    if (!expected || expected === 'human_review') continue;
+
+    const history = getVerificationHistory(verificationsDir, id);
+    const latest = history?.records?.[history.records.length - 1];
+    const actual = normalizeVerificationCommand(latest?.reproduction_command);
+
+    if (!latest) {
+      issues.push({ id, type: 'verification_method_unverified', severity: 'high', msg: `${id} 声明了 verification_method 但没有验证记录覆盖: ${method}` });
+    } else if (!actual) {
+      issues.push({ id, type: 'verification_method_unverified', severity: 'high', msg: `${id} 最新验证记录缺少 reproduction_command，无法复现 verification_method: ${method}` });
+    } else if (!commandCoversMethod(actual, expected)) {
+      issues.push({ id, type: 'verification_method_drift', severity: 'high', msg: `${id} verification_method 未被最新 reproduction_command 覆盖。method="${method}" reproduction_command="${latest.reproduction_command}"` });
+    }
+  }
+
+  appendPhilosophyDiagnostics(issues, philosophyDir);
+  return { issues, summary: summarizeIssues(issues) };
+}
+
+function appendPhilosophyDiagnostics(issues, philosophyDir) {
+  // 哲学灵感来源校验（防止 Weaver 从训练数据"背"几个名字就交差）
+  if (!existsSync(philosophyDir)) return;
+
+  const inspirationCheck = validateInspirationSources(philosophyDir);
+  for (const issue of inspirationCheck.issues) {
+    issues.push({ id: 'philosophy', type: 'inspiration_source', severity: issue.severity, msg: issue.msg });
+  }
+
+  // 实现部分拆解校验（防止 Weaver 跳过拆解步骤）
+  const decompositionCheck = validatePartDecomposition(philosophyDir);
+  for (const issue of decompositionCheck.issues) {
+    issues.push({ id: 'philosophy', type: 'part_decomposition', severity: issue.severity, msg: issue.msg });
+  }
+}
+
+function summarizeIssues(issues) {
+  return {
+    total_issues: issues.length,
+    fatal: issues.filter((i) => i.severity === 'fatal').length,
+    high: issues.filter((i) => i.severity === 'high').length,
+    medium: issues.filter((i) => i.severity === 'medium').length,
+    healthy: issues.length === 0,
+  };
+}
 
 /**
  * DFS 检测循环依赖。
@@ -321,26 +324,26 @@ function detectCycles(intents) {
  * @param {string} philosophyDir
  * @returns {object}
  */
-export function contextSummary(versionDir, verificationsDir, philosophyDir) {
-  const mapState = intentMapDiagnostics(versionDir);
-  const status = mapState.valid ? getStatus(versionDir) : summarizeRawIntentMap(mapState.raw);
-  const next = mapState.valid ? getNextIntent(versionDir) : null;
-  const pending = mapState.valid ? getPendingVerifications(versionDir, verificationsDir) : [];
-  const { issues } = doctor(versionDir, verificationsDir, philosophyDir);
+export function contextSummary(versionDir, verificationsDir, philosophyDir) {
+  const mapState = intentMapDiagnostics(versionDir);
+  const status = mapState.valid ? getStatus(versionDir) : summarizeRawIntentMap(mapState.raw);
+  const next = mapState.valid ? getNextIntent(versionDir) : null;
+  const pending = mapState.valid ? getPendingVerifications(versionDir, verificationsDir) : [];
+  const { issues } = doctor(versionDir, verificationsDir, philosophyDir);
 
   const risks = [];
   const fatalCount = issues.filter((i) => i.severity === 'fatal').length;
   const highCount = issues.filter((i) => i.severity === 'high').length;
-  if (fatalCount > 0) risks.push(`${fatalCount} 个致命问题（Intent Map 损坏/循环依赖）`);
-  if (highCount > 0) risks.push(`${highCount} 个高严重度问题（状态不一致/孤儿引用）`);
-  if (status.counts.blocked > 0) risks.push(`${status.counts.blocked} 个阻塞 Intent`);
-
-  return {
-    intent_map_valid: mapState.valid === true,
-    progress: {
-      completed: status.counts.completed,
-      total: status.counts.total,
-      rate: `${status.counts.completed}/${status.counts.total}`,
+  if (fatalCount > 0) risks.push(`${fatalCount} 个致命问题（Intent Map 损坏/循环依赖）`);
+  if (highCount > 0) risks.push(`${highCount} 个高严重度问题（状态不一致/孤儿引用）`);
+  if (status.counts.blocked > 0) risks.push(`${status.counts.blocked} 个阻塞 Intent`);
+
+  return {
+    intent_map_valid: mapState.valid === true,
+    progress: {
+      completed: status.counts.completed,
+      total: status.counts.total,
+      rate: `${status.counts.completed}/${status.counts.total}`,
     },
     next_intent: next ? next.id : null,
     pending_verifications: pending,

package/cli/src/philosophy.js

@@ -62,10 +62,13 @@ const REASON_KEYWORDS = ['萃取', '理由', '为什么', '因为', '启发', '
  * 从哲学文档内容中提取"灵感来源"章节的条目。
  * @param {string} content — MD 全文
  * @returns {Array<{ raw: string, name: string, urls: string[], hasReason: boolean }>}
+ *   如果返回空数组，调用方需区分"没有章节"和"有章节但没条目"——
+ *   用 hasInspirationSection() 单独判断。
  */
 function parseInspirationSources(content) {
-  // 匹配 "## 灵感来源" 或 "## Inspiration" 章节
-  const sectionMatch = content.match(/^##\s+(?:灵感来源|Inspiration|参考来源|References)/m);
+  // 匹配 "## 灵感来源" 或 "## Inspiration Sources" 等章节
+  // 支持 {#anchor} 后缀和多种标题变体
+  const sectionMatch = content.match(/^##\s+(?:灵感来源|Inspiration|参考来源|References?|参考文献|参考资料|Sources|Bibliography)/m);
   if (!sectionMatch) return [];
 
   const startIdx = sectionMatch.index + sectionMatch[0].length;
@@ -75,16 +78,19 @@ function parseInspirationSources(content) {
     ? content.slice(startIdx, startIdx + nextSection.index)
     : content.slice(startIdx);
 
-  // 解析每个 list item（- 或 * 开头）
+  // 解析每个 list item（- / * / 1. / 2. 等开头的无序或有序列表）
   const items = [];
   const lines = sectionText.split('\n');
   let currentItem = null;
 
+  // 匹配 - xxx / * xxx / 1. xxx / 2. xxx 等
+  const ITEM_RE = /^\s*(?:[-*]|\d+\.)\s+/;
+
   for (const line of lines) {
-    if (/^\s*[-*]\s/.test(line)) {
+    if (ITEM_RE.test(line)) {
       // 新条目
       if (currentItem) items.push(currentItem);
-      const raw = line.replace(/^\s*[-*]\s/, '').trim();
+      const raw = line.replace(ITEM_RE, '').trim();
       const urls = [...raw.matchAll(/https?:\/\/[^\s）)]+/g)].map((m) => m[0]);
       const name = raw.replace(/\*\*/g, '').split(/[（(——]/)[0].trim();
       const hasReason = REASON_KEYWORDS.some((kw) => raw.includes(kw));
@@ -103,6 +109,14 @@ function parseInspirationSources(content) {
   return items;
 }
 
+/**
+ * 检查哲学文档是否有"灵感来源"章节（不管有没有条目）。
+ * 用来区分"没有章节"和"有章节但没条目"两种情况。
+ */
+function hasInspirationSection(content) {
+  return /^##\s+(?:灵感来源|Inspiration|参考来源|References?|参考文献|参考资料|Sources|Bibliography)/m.test(content);
+}
+
 /**
  * 判断 URL 是否为 Wikipedia 链接。
  */
@@ -173,12 +187,26 @@ export function validateInspirationSources(philosophyDir) {
     }
   }
 
-  // 如果没有任何文件包含灵感来源章节
+  // 如果没有任何文件提取到灵感来源条目
   if (allSources.length === 0) {
-    issues.push({
-      severity: 'high',
-      msg: '所有哲学文档都没有"灵感来源"章节。PHILOSOPHY_WEAVER.md 要求哲学文档必须包含灵感来源（参考了哪些机构、人物、流派——附 URL 和理由）。',
-    });
+    // 区分两种情况：完全没有章节 vs 有章节但没条目
+    const filesWithSection = [];
+    for (const file of files) {
+      const content = readFileSync(join(philosophyDir, file), 'utf-8');
+      if (hasInspirationSection(content)) filesWithSection.push(file);
+    }
+
+    if (filesWithSection.length > 0) {
+      issues.push({
+        severity: 'high',
+        msg: `${filesWithSection.join(', ')} 有"灵感来源"章节但没有可识别的条目。章节里可能是模板占位符。需要 Weaver 真正走搜索漏斗，填入至少 ${MIN_SOURCES} 个源（- **源名** — 理由。来源：URL 格式）。`,
+      });
+    } else {
+      issues.push({
+        severity: 'high',
+        msg: '所有哲学文档都没有"灵感来源"章节。PHILOSOPHY_WEAVER.md 要求哲学文档必须包含灵感来源（参考了哪些机构、人物、流派——附 URL 和理由）。支持的标题：灵感来源 / Inspiration / 参考来源 / References / 参考文献 / 参考资料 / Sources / Bibliography。',
+      });
+    }
   }
 
   return {
@@ -204,7 +232,7 @@ export function validatePartDecomposition(philosophyDir) {
 
   const files = listPhilosophyFiles(philosophyDir);
 
-  // 搜索"实现部分"相关章节——可能叫"实现部分清单""部分拆解""Part Decomposition"等
+  // 搜索"实现部分"相关章节——支持 {#anchor} 后缀和多种标题变体
   const PART_SECTION_PATTERNS = [
     /^##\s+实现部分清单/m,
     /^##\s+部分拆解/m,
@@ -212,11 +240,15 @@ export function validatePartDecomposition(philosophyDir) {
     /^##\s+Part Decomposition/m,
     /^##\s+Implementation Parts/m,
     /^##\s+拆解出的部分/m,
+    /^##\s+Implementation Decomposition/m,
+    /^##\s+Parts? /m,
   ];
 
-  // 搜索部分条目——通常是 "- **部分名**" 或 "├── 部分名" 或 "| 部分名 |"
+  // 搜索部分条目——支持无序列表、有序列表、树形符号
   const PART_ITEM_PATTERNS = [
-    /^\s*[-*]\s+\*\*(.+?)\*\*/gm,  // - **CLI 交互设计**
+    /^\s*[-*]\s+\*\*(.+?)\*\*/gm,    // - **CLI 交互设计**
+    /^\s*\d+\.\s+\*\*(.+?)\*\*/gm,   // 1. **CLI 交互设计**
+    /^\s*\d+\.\s+(.+)/gm,            // 1. CLI 交互设计
     /^\s*├──\s+(.+)/gm,              // ├── CLI 交互设计
     /^\s*└──\s+(.+)/gm,              // └── 产物设计
   ];
@@ -257,12 +289,12 @@ export function validatePartDecomposition(philosophyDir) {
   if (!foundSection) {
     issues.push({
       severity: 'high',
-      msg: '哲学文档没有"实现部分清单"章节。PHILOSOPHY_WEAVER.md Step 2 要求按 PART_DECOMPOSITION.md 拆解实现部分，并在哲学文档中显式列出。可能 Weaver 跳过了拆解步骤。',
+      msg: '哲学文档没有"实现部分清单"章节。PHILOSOPHY_WEAVER.md Step 2 要求按 PART_DECOMPOSITION.md 拆解实现部分，并在哲学文档中显式列出。支持的标题：实现部分清单 / 部分拆解 / 实现部分 / Part Decomposition / Implementation Parts / 拆解出的部分。',
     });
   } else if (parts.length < 2) {
     issues.push({
       severity: 'medium',
-      msg: `实现部分清单仅识别到 ${parts.length} 个部分。PART_DECOMPOSITION.md 建议小项目 3-5 个部分，大项目 6-10 个。可能拆解不充分。`,
+      msg: `找到"实现部分清单"章节但仅识别到 ${parts.length} 个部分。可能章节里是模板占位符，或条目格式不被识别（用 - **部分名** 或 ├── 部分名 格式）。PART_DECOMPOSITION.md 建议小项目 3-5 个部分，大项目 6-10 个。`,
     });
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haaaiawd/loom",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "LOOM — 哲学驱动开发框架。Agent 通过 CLI 访问 Intent Map / 哲学 / 验证记录，不直接读文件",
   "type": "module",
   "bin": {
@@ -35,8 +35,8 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Haaaiawd/loom.git"
-  },
-  "homepage": "https://github.com/Haaaiawd/loom#readme",
+    "url": "git+https://github.com/Haaaiawd/loom.git"
+  },
+  "homepage": "https://github.com/Haaaiawd/loom#readme",
   "author": "haaaiawd"
 }