@haaaiawd/loom 1.2.1 → 1.2.2

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.2.2 — 2026-07-31
+
+### Fixed
+
+- `guide` 只输出下一步命令、Context Pack 提示与完成校验，不再展示文件输入/输出清单；当下一步是角色激活时，由该命令装配 Context Pack。
+- `activate weaver` 直接注入检索方法与哲学维度目录；`activate architect` 在无 Intent 的设计阶段直接注入愿景、当前 Capability Graph、Intent Map 与未闭合 proposal。
+- Capability Graph 未闭合或 proposal 待裁决时，`guide` 重新指向可推进工作的 Architect Context Pack，而不是重复运行只读检查。
+- `loom intent next` 返回开始该 Intent 和获取 Forge Context Pack 的明确后续命令。
+
 ## 1.2.1 — 2026-07-31
 
 ### Fixed

package/README.md

@@ -87,6 +87,9 @@ loom guide --dry-run  # 只读诊断，不写 heartbeat
 guide 检测项目当前在哪个阶段，输出"你在阶段 X，下一步做 Y"。
 Agent 每完成一步都跑 guide 确认下一步。
 如果只是审计或探测，不希望产生任何状态写入，用 `loom guide --dry-run`。
+
+当 `guide` 的下一步是 `loom activate <role>` 时，先运行这条命令：它会把该阶段需要的
+规范与版本化输入编译为 Context Pack。`guide` 只负责导航，不输出待阅读文件清单。
 
 ### AUTO 模式
 

package/cli/bin/loom.js

@@ -274,9 +274,19 @@ try {
           }));
           break;
         }
-        case 'next':
-          output(getNextIntent(versionDir) ?? '没有可执行的 Intent');
-          break;
+        case 'next':
+          {
+            const next = getNextIntent(versionDir);
+            output(next ? {
+              ...next,
+              suggested_flow: {
+                start: `loom intent update ${next.id} --status in_progress`,
+                forge_context: `loom activate forge --intent ${next.id}`,
+                note: '先显式开始 Intent，再由 activate 命令装配该 Intent 的叙事、契约、图谱路由与专业输入。',
+              },
+            } : '没有可执行的 Intent');
+          }
+          break;
         case 'status': {
           const s = getStatus(versionDir);
           const fmt = (ids) => ids.map((id) => s.titles[id] ? `${id}(${s.titles[id]})` : id).join(', ') || '-';
@@ -518,7 +528,7 @@ try {
               const icon = issue.severity === 'high' ? '⚠' : '·';
               console.log(`  ${icon} [${issue.severity}] ${issue.msg}`);
             }
-            console.log('\n参见 meta/PHILOSOPHY_WEAVER.md + dimensions/SEARCH_METHODOLOGY.md。');
+            console.log('\n下一步: 运行 loom activate weaver；命令会重新输出哲学阶段所需的 Context Pack。');
             exit(1);
           }
           break;
@@ -738,7 +748,7 @@ try {
             console.log(`    → 修复: ${issue.fix_hint}`);
           }
         }
-        console.log(`\n参见 meta/PHILOSOPHY_WEAVER.md + dimensions/SEARCH_METHODOLOGY.md。`);
+        console.log('\n下一步: 运行 loom guide；它会根据当前状态给出可执行动作与所需 Context Pack。');
       }
       break;
     }
@@ -788,17 +798,12 @@ try {
       };
       console.log(`模式: ${modeDesc[result.auto_mode] || result.auto_mode}`);
       console.log(`\n${result.message}`);
-      console.log(`\n下一步: ${result.next_action}`);
-      console.log(`  → ${result.next_command}`);
-      if (result.inputs && result.inputs.length > 0) {
-        console.log(`\n需要读取:`);
-        for (const f of result.inputs) console.log(`  - ${f}`);
-      }
-      if (result.outputs && result.outputs.length > 0) {
-        console.log(`\n需要产出:`);
-        for (const f of result.outputs) console.log(`  - ${f}`);
-      }
-      if (result.verify_command) {
+      console.log(`\n下一步: ${result.next_action}`);
+      console.log(`  → ${result.next_command}`);
+      if (result.input_delivery === 'context_pack') {
+        console.log('\n上下文: 直接运行这条命令；它会输出当前阶段所需的 Context Pack。');
+      }
+      if (result.verify_command) {
         console.log(`\n完成后校验: ${result.verify_command}`);
       }
       if (result.auto_mode === 'manual' && result.stage_num > 0 && result.stage_num < 6) {

package/cli/help/workflow.md

@@ -9,6 +9,9 @@ loom context
 
 只读探测使用 `loom guide --dry-run`。
 
+若 `guide` 指向 `loom activate <role>`，直接运行该命令。它会输出已经装配的 Context Pack；
+`guide` 只负责给出当前动作，不要求 Agent 逐个寻找文件。
+
 ## 1. Doctrine — Weaver
 
 ```bash

package/cli/src/activate.js

@@ -1,7 +1,7 @@
 // activate — compile a role- and intent-scoped Context Pack.
 
-import { readFileSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { join, relative } from 'node:path';
 import { getLoomRoot } from './shared/paths.js';
 import { getIntent, getNarrative } from './intent-map.js';
 import { getIntentDraft } from './intent-draft.js';
@@ -11,6 +11,7 @@ import { extractMdSection } from './shared/md-utils.js';
 import { compileCapabilityInputs } from './capability-graph.js';
 import { getAtelierRecord } from './atelier.js';
 import { formatExpertisePackForPrompt, getExpertisePack, getExpertisePackState } from './expertise-pack.js';
+import { listCapabilityProposals } from './capability-proposals.js';
 
 const VALID_ROLES = ['weaver', 'visionary', 'architect', 'forge', 'keeper'];
 
@@ -354,6 +355,92 @@ function compileWorkingFacts(versionDir, objective) {
   return refs.join('\n');
 }
 
+function readStageFile(path, label) {
+  if (!existsSync(path)) return `> ${label} 当前不存在；不要猜测其内容。按角色契约创建或回流。`;
+  return readFileSync(path, 'utf-8').trim();
+}
+
+function listMarkdownFiles(root, current = root) {
+  if (!existsSync(current)) return [];
+  return readdirSync(current, { withFileTypes: true })
+    .sort((a, b) => a.name.localeCompare(b.name))
+    .flatMap((entry) => {
+      const path = join(current, entry.name);
+      if (entry.isDirectory()) return listMarkdownFiles(root, path);
+      return entry.isFile() && entry.name.endsWith('.md')
+        ? [relative(root, path).replaceAll('\\', '/')]
+        : [];
+    });
+}
+
+/**
+ * Compile the stage inputs that used to be merely named by `loom guide`.
+ * These are intentionally separate from Working Facts: they are the source
+ * material for a role's immediate decision, not a request to hunt for paths.
+ */
+function compileStageInputs(role, versionDir, objective) {
+  if (role === 'weaver') {
+    const dimensionsRoot = join(getLoomRoot(), 'dimensions');
+    const catalog = listMarkdownFiles(dimensionsRoot)
+      .filter((path) => path !== 'SEARCH_METHODOLOGY.md')
+      .map((path) => `- dimensions/${path}`);
+    return [
+      '本节由 `loom activate weaver` 直接装配。不要为了取得这些输入而搜索 CLI 安装目录。',
+      '',
+      '### Search Methodology',
+      '',
+      readStageFile(join(dimensionsRoot, 'SEARCH_METHODOLOGY.md'), 'SEARCH_METHODOLOGY.md'),
+      '',
+      '### Available Dimension Catalog',
+      '',
+      catalog.length
+        ? `${catalog.join('\n')}\n\n只打开会实质改变当前项目原则或取舍的维度；目录本身不是要求逐个阅读。`
+        : '> 当前没有可用的 dimensions 文档。',
+    ].join('\n');
+  }
+
+  if (role === 'architect' && versionDir && !objective.intent && !objective.draft) {
+    let proposals = [];
+    let proposalsError = null;
+    try {
+      proposals = listCapabilityProposals(versionDir, { unresolvedOnly: true });
+    } catch (error) {
+      proposalsError = error.message;
+    }
+    return [
+      '本节由 `loom activate architect` 直接装配。以下是当前设计决策所需的版本化输入，不要先手动查找路径。',
+      '',
+      '### Vision Input (01_VISION.md)',
+      '',
+      readStageFile(join(versionDir, '01_VISION.md'), '01_VISION.md'),
+      '',
+      '### Capability Graph Input (07_CAPABILITY_GRAPH.json)',
+      '',
+      readStageFile(join(versionDir, '07_CAPABILITY_GRAPH.json'), '07_CAPABILITY_GRAPH.json'),
+      '',
+      '### Intent Map Input (04_INTENT_MAP.json)',
+      '',
+      readStageFile(join(versionDir, '04_INTENT_MAP.json'), '04_INTENT_MAP.json'),
+      '',
+      '### Open Capability Graph Proposals',
+      '',
+      proposalsError
+        ? `> Proposal 记录无法读取：${proposalsError}。先修复这份记录，不要猜测其状态。`
+        : proposals.length
+        ? `\`\`\`json\n${JSON.stringify(proposals, null, 2)}\n\`\`\``
+        : '无。',
+    ].join('\n');
+  }
+
+  if (role === 'visionary') {
+    return '产品哲学与决策准则已在上方 Project Judgment 中装配；不要重新搜索 `.loom` 目录。';
+  }
+  if (role === 'forge' || role === 'keeper') {
+    return '当前 Intent 的叙事、契约、图谱路由与已就绪的 Expertise 输入已在上方装配；只有产物本身需要按 Working Facts 检查。';
+  }
+  return '当前角色没有额外的阶段输入。';
+}
+
 /**
  * Compile a role-scoped Context Pack.
  * @param {string} role
@@ -377,9 +464,10 @@ export function activateRole(role, versionDir, intentId = null) {
     section('3. Hard Invariants', compileInvariants(role, versionDir)),
     section('4. Success Contracts', compileContracts(role, versionDir, objective)),
     section('5. Project Judgment', compileProjectJudgment(role, versionDir, objective)),
-    section('6. Expertise Inputs', compileExpertiseInputs(role, versionDir, objective)),
-    section('7. Working Facts', compileWorkingFacts(versionDir, objective)),
-    section('8. Role Contract / Output / Reflow / Stop', readRole(role)),
+    section('6. Stage Inputs (command-assembled)', compileStageInputs(role, versionDir, objective)),
+    section('7. Expertise Inputs', compileExpertiseInputs(role, versionDir, objective)),
+    section('8. Working Facts', compileWorkingFacts(versionDir, objective)),
+    section('9. Role Contract / Output / Reflow / Stop', readRole(role)),
   ];
   return `${parts.join('\n\n---\n\n')}\n`;
 }

package/cli/src/guide.js

@@ -63,35 +63,41 @@ export function guideProject(projectDir, options = {}) {
       outputs: ['.loom/v1/'],
       verify_command: 'loom guide',
     },
-    need_philosophy: {
+    need_philosophy: {
       inputs: ['meta/PHILOSOPHY_WEAVER.md', 'meta/BASELINE.md', 'dimensions/SEARCH_METHODOLOGY.md'],
-      outputs: [`.loom/${current}/00_PHILOSOPHY/PRODUCT_PHILOSOPHY.md`, `.loom/${current}/00_PHILOSOPHY/ENGINEERING_CREED.md`, `.loom/${current}/00_PHILOSOPHY/DECISION_RUBRIC.md`],
-      verify_command: 'loom philosophy check',
-    },
-    need_vision: {
-      inputs: ['roles/visionary.md', `.loom/${current}/00_PHILOSOPHY/`],
-      outputs: [`.loom/${current}/01_VISION.md`],
-      verify_command: 'loom guide',
-    },
+      outputs: [`.loom/${current}/00_PHILOSOPHY/PRODUCT_PHILOSOPHY.md`, `.loom/${current}/00_PHILOSOPHY/ENGINEERING_CREED.md`, `.loom/${current}/00_PHILOSOPHY/DECISION_RUBRIC.md`],
+      verify_command: 'loom philosophy check',
+      input_delivery: 'context_pack',
+    },
+    need_vision: {
+      inputs: ['roles/visionary.md', `.loom/${current}/00_PHILOSOPHY/`],
+      outputs: [`.loom/${current}/01_VISION.md`],
+      verify_command: 'loom guide',
+      input_delivery: 'context_pack',
+    },
     need_architecture: {
       inputs: ['roles/architect.md', `.loom/${current}/01_VISION.md`],
       outputs: [`.loom/${current}/02_ARCHITECTURE.md`, `.loom/${current}/04_INTENT_MAP.json`],
       verify_command: 'loom doctor',
+      input_delivery: 'context_pack',
     },
     need_capability_graph: {
       inputs: ['roles/architect.md', `.loom/${current}/01_VISION.md`],
       outputs: [`.loom/${current}/07_CAPABILITY_GRAPH.json`, `.loom/${current}/07_CAPABILITY_BRIEFS/`],
       verify_command: 'loom capability coverage',
+      input_delivery: 'context_pack',
     },
     capability_graph_incomplete: {
       inputs: ['roles/architect.md', `.loom/${current}/07_CAPABILITY_GRAPH.json`, `.loom/${current}/04_INTENT_MAP.json`],
       outputs: [`.loom/${current}/07_CAPABILITY_GRAPH.json`, `.loom/${current}/07_CAPABILITY_BRIEFS/`],
       verify_command: 'loom capability coverage',
+      input_delivery: 'context_pack',
     },
     capability_graph_proposals_pending: {
       inputs: ['roles/architect.md', `.loom/${current}/07_GRAPH_PROPOSALS/`, `.loom/${current}/07_CAPABILITY_GRAPH.json`],
       outputs: [`.loom/${current}/07_GRAPH_PROPOSALS/`, `.loom/${current}/07_CAPABILITY_GRAPH.json`, `.loom/${current}/04_INTENT_MAP.json`],
       verify_command: 'loom capability proposal list',
+      input_delivery: 'context_pack',
     },
     intent_map_broken: {
       inputs: [`.loom/${current}/04_INTENT_MAP.json`],
@@ -120,9 +126,10 @@ export function guideProject(projectDir, options = {}) {
     },
   };
   const meta = stageMeta[result.stage] || {};
-  result.inputs = meta.inputs || [];
-  result.outputs = meta.outputs || [];
-  result.verify_command = meta.verify_command || null;
+  result.inputs = meta.inputs || [];
+  result.outputs = meta.outputs || [];
+  result.verify_command = meta.verify_command || null;
+  result.input_delivery = meta.input_delivery || null;
   // 统一后处理：写心跳 + 加 AUTO 提示词 + 判断是否需要人类 review
   if (existsSync(loomRoot) && !options.dryRun) {
     try {
@@ -242,14 +249,14 @@ function diagnoseStage(cwd, loomRoot, auto) {
           details: { version: current, proposals: pendingProposals.map((proposal) => proposal.id) },
           auto,
           next_action: '审计新信息对 Capability Graph、Intent 和契约的影响',
-          next_command: 'loom capability proposal list',
+          next_command: 'loom activate architect',
           message: `当前版本 ${current} 有 ${pendingProposals.length} 个未闭合的 Capability Graph proposal。它们是新要求、研究或实现发现，不得由 Forge 静默变成当前 Intent 范围。`,
         };
       }
     } catch (error) {
       return {
         stage: 'capability_graph_proposals_pending', stage_num: 3, details: { version: current, error: error.message }, auto,
-        next_action: '修复 Capability Graph proposal', next_command: 'loom capability proposal list',
+        next_action: '修复 Capability Graph proposal', next_command: 'loom activate architect',
         message: `Capability Graph proposal 无法审计: ${error.message}`,
       };
     }
@@ -262,7 +269,7 @@ function diagnoseStage(cwd, loomRoot, auto) {
           details: { version: current, coverage: coverage.summary },
           auto,
           next_action: '补齐 Capability Graph 的路由、可观察验证入口与 Intent 回链',
-          next_command: 'loom capability coverage',
+          next_command: 'loom activate architect',
           message: `当前版本 ${current}：Capability Graph 尚未闭合（高影响前沿 ${coverage.summary.high_unrouted}、路由缺口 ${coverage.summary.routing_gaps}、不可观察 outcome ${coverage.summary.high_outcomes_without_observable_evidence}、未映射 Intent ${coverage.summary.unmapped_intents}）。先由 Architect 补图谱，再继续设计 Intent。`,
         };
       }
@@ -273,7 +280,7 @@ function diagnoseStage(cwd, loomRoot, auto) {
         details: { version: current, error: error.message },
         auto,
         next_action: '修复 Capability Graph',
-        next_command: 'loom capability coverage',
+        next_command: 'loom activate architect',
         message: `Capability Graph 无法通过校验: ${error.message}`,
       };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haaaiawd/loom",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "LOOM — 哲学驱动开发框架。Agent 通过 CLI 访问 Intent Map / 哲学 / 验证记录，不直接读文件",
   "type": "module",
   "bin": {