jvibe 1.1.5 → 1.1.8

package/CHANGELOG.md

@@ -0,0 +1,88 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.1.8] - 2026-01-19
+
+### Added
+
+- **Agent I/O 协议统一** (`agent-contracts.yaml`)
+  - 新增 `docs/.jvibe/agent-contracts.yaml` 作为 subagent 输入输出的单一事实来源
+  - 定义了 `planner`、`developer`、`tester`、`bugfix`、`doc-sync` 的 `task_input` 与输出结构
+  - 包含硬规则 (HR-001 ~ HR-003) 约束 subagent 行为
+
+- **插件管理配置** (`plugins.yaml`)
+  - 新增 `docs/.jvibe/plugins.yaml` 管理工具与插件启用状态
+  - 区分 `core_plugins`（核心工具）与 `project_plugins`（项目按需）
+
+- **上下文最小化原则**
+  - 所有 Agent 新增"硬规则"章节，禁止全仓库扫描
+  - `developer`: 只在 `code_roots`/`test_roots` 范围内读取与修改
+  - `tester`: 新增 `mode: targeted | discover` 双模式
+  - `bugfix`: 优先使用 tester 报告的 `failures`/`modules_hit`/`files`
+
+- **Tester 双模式支持**
+  - `targeted`: 给定 `files`，精确限制测试范围
+  - `discover`: 允许从测试输出反推落点文件，解决"用户报错但不知道 F-XXX"场景
+  - 新增 `issue` 字段用于 discover 模式的问题描述
+
+- **Keepgo 用户报错判定**
+  - 新增关键词匹配（报错/失败/异常/bug/error 等）自动识别用户报告的问题
+  - 支持 `feature_id=null` 时进入 discover 测试流程
+  - 新增 `user_reported_issue`、`user_reported_feature_id`、`user_issue` 状态字段
+
+### Changed
+
+- **测试失败分流策略**
+  - 从简单的 `return_to_developer` 改为 `triage_then_fix` 策略
+  - 多模块/核心模块/用户强制 → 调用 `bugfix`
+  - 单模块/简单问题 → 回退到 `developer`
+
+- **Handoff Payload 结构**
+  - 新增 `mode` 字段（`targeted`/`discover`）
+  - `files` 字段在 targeted 模式下必填且非空
+  - `feature_id` 允许为 `null`
+
+- **文档更新条件**
+  - `doc_updates` 仅在 `pass` 且 `feature_id` 非空时执行
+  - 避免无法关联功能编号时错误更新状态
+
+- **Standards.md**
+  - 新增 §2.6 Tools & Plugins 章节说明工具与插件概念
+
+### Fixed
+
+- **Hook 脚本 grep 错误处理**
+  - 修复 `grep -c ... || true` 导致空字符串的问题
+  - 改为 `|| echo 0` 确保输出为数字，避免后续算术运算错误
+  - 影响文件：`load-context.sh`、`load-jvibe-full-context.sh`、`sync-jvibe-context.sh`
+
+## [1.1.7] - 2026-01-18
+
+### Added
+
+- Hooks 自动加载和同步 JVibe 上下文
+
+### Fixed
+
+- Hooks 脚本 jq-free 重写，fail-open 模式
+
+## [1.1.6] - 2026-01-17
+
+### Added
+
+- Context hooks 自动加载功能
+
+---
+
+## Summary of v1.1.8
+
+This release introduces a major architectural improvement focused on **context minimization** and **unified I/O contracts** for subagents:
+
+1. **Single Source of Truth**: `agent-contracts.yaml` defines all subagent input/output schemas
+2. **Dual-mode Testing**: `targeted` (precise) vs `discover` (user-reported issues without F-XXX)
+3. **Smarter Dispatch**: Main agent no longer directly fixes code; uses `bugfix` for complex issues
+4. **Robust Hooks**: Fixed shell script arithmetic errors with proper fallback values

package/JVIBE.md

@@ -75,7 +75,7 @@ TODO 完成情况 → 功能状态
 5. **测试自动派发**：TODO 包含“测试/test”时，进入测试阶段必须自动调用 tester，无需用户手动指定
 6. **已有项目初始化**：若项目已有代码/文档，/JVibe:init 应先扫描现有项目并用扫描结果填充 Project 与 Feature-List
 7. **Bugfix 调用**：tester 报告失败且问题涉及**多模块**或**核心模块**时才调用 bugfix；否则回退给 developer。用户明确要求时可直接调用
-8. **MCP 权限**：主 Agent 与所有 Sub-Agents 允许直接调用 MCP 工具进行查询/集成操作
+8. **Tools/Plugins 权限**：主 Agent 与所有 Sub-Agents 允许直接调用 Tools/Plugins 进行查询/集成操作（包括 MCP Server、Skills、Daemon 等）
 
 保持此管理块，以便 `jvibe upgrade` 更新指令。
 <!-- JVIBE:END -->

package/README.md

@@ -1,9 +1,39 @@
+<div align="center">
+
 # JVibe
 
-> 文档驱动的 AI 辅助开发系统
+**文档驱动的 AI 辅助开发系统**
+
+*Doc-driven AI-assisted Development System for Claude Code & OpenCode*
 
 [![npm version](https://badge.fury.io/js/jvibe.svg)](https://badge.fury.io/js/jvibe)
+[![npm downloads](https://img.shields.io/npm/dm/jvibe.svg)](https://www.npmjs.com/package/jvibe)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D16.0.0-brightgreen)](https://nodejs.org/)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/9963KK/VibeCoding-Tech/pulls)
+
+[快速开始](#-快速开始) · [使用方法](#-使用方法一览) · [文档](#-文档) · [贡献](#-贡献)
+
+</div>
+
+---
+
+## 目录
+
+- [什么是 JVibe？](#-什么是-jvibe)
+- [为什么选择 JVibe？](#-为什么选择-jvibe)
+- [快速开始](#-快速开始)
+- [使用方法一览](#-使用方法一览)
+- [典型使用场景](#-典型使用场景)
+- [项目结构](#-项目结构)
+- [文档体系](#-文档体系)
+- [Agent 架构](#-agent-架构)
+- [CLI 命令](#-cli-命令)
+- [核心原则](#-核心原则)
+- [���见问题](#-常见问题)
+- [文档](#-文档)
+- [贡献](#-贡献)
+- [许可证](#-许可证)
 
 ---
 
@@ -18,6 +48,35 @@ JVibe 是一个**文档驱动的 AI 辅助开发系统**，面向 Claude Code
 
 ---
 
+## 💡 为什么选择 JVibe？
+
+| 痛点 | JVibe 解决方案 |
+|------|---------------|
+| AI 缺乏项目上下文，每次都要重复解释 | 自动加载项目文档，AI 开箱即知项目全貌 |
+| 功能状态散落各处，难以追踪 | 单一事实来源（SoT），状态只在一处维护 |
+| AI 生成代码质量参差不齐 | 多 Agent 分工协作，专业的事交给专业的 Agent |
+| 文档与代码脱节，维护困难 | 文档驱动开发，代码变更自动触发文档同步 |
+| 团队协作时上下文丢失 | 结构化任务交接文件，无缝衔接工作进度 |
+
+**核心优势**：
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      JVibe 工作流                           │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│   需求 ──→ planner ──→ developer ──→ tester ──→ reviewer   │
+│     │                      │            │           │       │
+│     └──────────────────────┴────────────┴───────────┘       │
+│                            ↓                                │
+│                       doc-sync                              │
+│                    (自动同步状态)                            │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
 ## 🚀 快速开始
 
 ### 初始化方式（选一种）
@@ -281,12 +340,83 @@ JVibe 基于以下原则设计：
 
 ---
 
+## ❓ 常见问题
+
+<details>
+<summary><b>JVibe 支持哪些 AI 编码工具？</b></summary>
+
+目前支持：
+- **Claude Code** - Anthropic 官方 CLI 工具
+- **OpenCode** - 开源 AI 编码助手
+
+通过 `--adapter` 参数选择适配器，或使用 `--adapter=both` 同时支持两者。
+</details>
+
+<details>
+<summary><b>已有项目如何接入 JVibe？</b></summary>
+
+推荐使用 `/JVibe:init` 命令（在 Claude Code 中）或 `/jvibe-init`（在 OpenCode 中）。AI 会自动扫描现有代码和文档，生成符合项目现状的 Feature-List 和 Project 文档。
+</details>
+
+<details>
+<summary><b>CORE-DOCS 和 PROJECT-DOCS 有什么区别？</b></summary>
+
+- **CORE-DOCS**：固定 4 个核心文档，所有项目结构相同，自动存在
+- **PROJECT-DOCS**：按需创建的扩展文档（如 API 文档、数据库文档），必须在规范文档中注册
+
+详见 [CORE vs PROJECT 文档](docs/CORE_VS_PROJECT_DOCS.md)。
+</details>
+
+<details>
+<summary><b>如何升级到新版本？</b></summary>
+
+```bash
+# 检查是否有新版本
+jvibe upgrade --check
+
+# 执行升级（会提示确认）
+jvibe upgrade
+
+# 强制升级（跳过确认）
+jvibe upgrade --force
+```
+</details>
+
+<details>
+<summary><b>Agent 之间如何协作？</b></summary>
+
+JVibe 采用流水线式协作：
+1. `planner` 分析需求，拆解为 TODO 列表
+2. `developer` 逐项完成 TODO，编写代码
+3. `tester` 执行测试，验证功能
+4. `bugfix` 处理复杂 bug（多模块/核心模块问题）
+5. `reviewer` 代码审查，确保质量
+6. `doc-sync` 自动同步文档状态
+
+使用 `/JVibe:keepgo` 可自动推进到下一阶段。
+</details>
+
+<details>
+<summary><b>如何卸载 JVibe？</b></summary>
+
+```bash
+# 卸载项目内的 JVibe 配置
+jvibe uninstall
+
+# 全局卸载
+npm uninstall -g jvibe
+```
+</details>
+
+---
+
 ## 📖 文档
 
 - [快速开始指南](docs/GETTING_STARTED.md)
 - [CLI 命令参考](docs/CLI_COMMANDS.md)
 - [架构说明](docs/ARCHITECTURE.md)
 - [CORE vs PROJECT 文档](docs/CORE_VS_PROJECT_DOCS.md)
+- [Tools & Plugins（工具与插件）](docs/TOOLS_AND_PLUGINS.md)
 - [贡献指南](docs/CONTRIBUTING.md)
 
 ---
@@ -314,3 +444,15 @@ JVibe 基于以下原则设计：
 - [Claude Code 官方文档](https://docs.anthropic.com/claude-code)
 - [OpenCode 官方文档](https://opencode.ai/docs)
 - [OpenSpec](https://github.com/openspec/openspec) - 灵感来源
+- [GitHub Issues](https://github.com/9963KK/VibeCoding-Tech/issues) - 问题反馈
+- [NPM Package](https://www.npmjs.com/package/jvibe) - NPM 主页
+
+---
+
+<div align="center">
+
+**如果 JVibe 对你有帮助，请给个 ⭐ Star 支持一下！**
+
+Made with ❤️ by [9963KK](https://github.com/9963KK)
+
+</div>

package/lib/migrate.js

@@ -471,6 +471,7 @@ async function inferOpencodeVersionFromStructure(opencodeDir) {
     path.join('agent', 'planner.md'),
     path.join('agent', 'developer.md'),
     path.join('agent', 'tester.md'),
+    path.join('agent', 'bugfix.md'),
     path.join('agent', 'reviewer.md'),
     path.join('agent', 'doc-sync.md')
   ];
@@ -584,16 +585,25 @@ async function checkContentMigration(projectDir, currentVersion) {
  * @returns {Promise<MigrationPlan>}
  */
 async function getMigrationPlan(projectDir, versionInfo) {
+  const latestVersion = pkg.version || null;
+  const currentVersion = versionInfo.version || null;
+  const versionMismatch = Boolean(latestVersion && currentVersion && currentVersion !== latestVersion);
+
   const plan = {
-    needsMigration: versionInfo.isLegacy,
+    // needsMigration 表示“是否需要执行自动迁移动作”，不等同于 isLegacy
+    needsMigration: false,
     needsAIMigration: versionInfo.contentMigration.required,
     tasks: [],
     aiTasks: [],
     details: {
       docsToMove: [],
+      hooksNeedUpdate: false,
       hooksToUpdate: [],
+      commandsNeedUpdate: false,
       commandsToRename: [],
+      agentsNeedUpdate: false,
       agentsToUpdate: [],
+      opencodeNeedUpdate: false,
       configToUpdate: false,
       contentChanges: versionInfo.contentMigration.changes || []
     }
@@ -606,7 +616,7 @@ async function getMigrationPlan(projectDir, versionInfo) {
     }
   }
 
-  if (!versionInfo.isLegacy && !versionInfo.contentMigration.required) {
+  if (!versionInfo.isLegacy && !versionInfo.contentMigration.required && !versionMismatch) {
     return plan;
   }
 
@@ -642,7 +652,8 @@ async function getMigrationPlan(projectDir, versionInfo) {
   if (await fs.pathExists(hooksDir)) {
     const hookFiles = await fs.readdir(hooksDir);
     const legacyHookIssues = await checkLegacyHooks(hooksDir);
-    if (legacyHookIssues.length > 0) {
+    if (legacyHookIssues.length > 0 || versionMismatch) {
+      plan.details.hooksNeedUpdate = true;
       plan.details.hooksToUpdate = hookFiles.filter(f => f.endsWith('.sh'));
       plan.tasks.push('更新 hooks 脚本到最新版本');
     }
@@ -660,21 +671,49 @@ async function getMigrationPlan(projectDir, versionInfo) {
       plan.details.commandsToRename.push({ from: cmd, to: newName });
       plan.tasks.push(`重命名 command: ${cmd} → ${newName}`);
     }
+
+    if (legacyCommands.length > 0 || versionMismatch) {
+      plan.details.commandsNeedUpdate = true;
+      if (legacyCommands.length === 0) {
+        plan.tasks.push('更新 commands 到最新版本');
+      }
+    }
   }
 
   // 4. 检查 agents 更新需求
   const agentsDir = path.join(projectDir, '.claude/agents');
   if (await fs.pathExists(agentsDir)) {
-    plan.details.agentsToUpdate = ['planner.md', 'developer.md', 'reviewer.md', 'doc-sync.md'];
+    plan.details.agentsNeedUpdate = true;
+    plan.details.agentsToUpdate = ['planner.md', 'developer.md', 'tester.md', 'reviewer.md', 'doc-sync.md', 'bugfix.md'];
     plan.tasks.push('更新所有 agents 到最新版本');
   }
 
-  // 5. 配置更新
-  if (!versionInfo.version) {
+  // 5. OpenCode 配置更新
+  const opencodeDir = path.join(projectDir, '.opencode');
+  if (await fs.pathExists(opencodeDir)) {
+    if (versionInfo.isLegacy || versionMismatch) {
+      plan.details.opencodeNeedUpdate = true;
+      plan.tasks.push('更新 OpenCode 配置到最新版本');
+    }
+  }
+
+  // 6. 配置更新
+  if (!versionInfo.version || versionMismatch) {
     plan.details.configToUpdate = true;
-    plan.tasks.push('更新 settings.json 添加版本信息');
+    plan.tasks.push('更新版本信息（settings.json / jvibe.json）');
   }
 
+  // 最终 needsMigration：只要存在任一自动迁移动作即可
+  plan.needsMigration = Boolean(
+    plan.details.docsToMove.length > 0 ||
+    plan.details.hooksNeedUpdate ||
+    plan.details.commandsNeedUpdate ||
+    plan.details.commandsToRename.length > 0 ||
+    plan.details.agentsNeedUpdate ||
+    plan.details.opencodeNeedUpdate ||
+    plan.details.configToUpdate
+  );
+
   return plan;
 }
 
@@ -760,30 +799,76 @@ async function migrateAgents(projectDir, templateDir) {
   console.log(chalk.gray('   已更新 agents'));
 }
 
+/**
+ * 执行 OpenCode 配置迁移（覆盖同步）
+ * @param {string} projectDir - 项目目录
+ * @param {string} templateDir - 模板目录
+ */
+async function migrateOpencode(projectDir, templateDir) {
+  const projectOpencodeDir = path.join(projectDir, '.opencode');
+  const templateOpencodeDir = path.join(templateDir, '.opencode');
+
+  if (!await fs.pathExists(projectOpencodeDir)) {
+    return;
+  }
+  if (!await fs.pathExists(templateOpencodeDir)) {
+    return;
+  }
+
+  await fs.copy(templateOpencodeDir, projectOpencodeDir, { overwrite: true });
+  console.log(chalk.gray('   已更新 OpenCode 配置'));
+}
+
 /**
  * 更新配置文件
  * @param {string} projectDir - 项目目录
  * @param {string} newVersion - 新版本号
  */
 async function updateConfig(projectDir, newVersion) {
-  const settingsPath = path.join(projectDir, '.claude/settings.json');
+  const migratedAt = new Date().toISOString();
 
-  let settings = {};
-  if (await fs.pathExists(settingsPath)) {
-    try {
-      settings = await fs.readJson(settingsPath);
-    } catch (e) {
-      // 如果读取失败，创建新的配置
+  // Claude Code settings
+  const claudeDir = path.join(projectDir, '.claude');
+  if (await fs.pathExists(claudeDir)) {
+    const settingsPath = path.join(claudeDir, 'settings.json');
+    let settings = {};
+    if (await fs.pathExists(settingsPath)) {
+      try {
+        settings = await fs.readJson(settingsPath);
+      } catch (e) {
+        // 如果读取失败，创建新的配置
+      }
     }
+
+    settings.jvibe = {
+      ...settings.jvibe,
+      version: newVersion,
+      migratedAt
+    };
+
+    await fs.writeJson(settingsPath, settings, { spaces: 2 });
   }
 
-  settings.jvibe = {
-    ...settings.jvibe,
-    version: newVersion,
-    migratedAt: new Date().toISOString()
-  };
+  // OpenCode meta
+  const opencodeDir = path.join(projectDir, '.opencode');
+  if (await fs.pathExists(opencodeDir)) {
+    const opencodeMetaPath = path.join(opencodeDir, 'jvibe.json');
+    let meta = {};
+    if (await fs.pathExists(opencodeMetaPath)) {
+      try {
+        meta = await fs.readJson(opencodeMetaPath);
+      } catch (e) {
+        // ignore
+      }
+    }
+    meta = {
+      ...meta,
+      version: newVersion,
+      migratedAt
+    };
+    await fs.writeJson(opencodeMetaPath, meta, { spaces: 2 });
+  }
 
-  await fs.writeJson(settingsPath, settings, { spaces: 2 });
   console.log(chalk.gray('   已更新版本信息'));
 }
 
@@ -857,24 +942,30 @@ async function executeMigration(projectDir, templateDir, plan, newVersion) {
   await migrateFeatureList(projectDir);
 
   // 3. 迁移 hooks
-  if (plan.details.hooksToUpdate.length > 0) {
+  if (plan.details.hooksNeedUpdate) {
     console.log(chalk.gray('   更新 hooks...'));
     await migrateHooks(projectDir, templateDir);
   }
 
   // 4. 迁移 commands
-  if (plan.details.commandsToRename.length > 0) {
+  if (plan.details.commandsNeedUpdate || plan.details.commandsToRename.length > 0) {
     console.log(chalk.gray('   更新 commands...'));
     await migrateCommands(projectDir, templateDir, plan);
   }
 
   // 5. 迁移 agents
-  if (plan.details.agentsToUpdate.length > 0) {
+  if (plan.details.agentsNeedUpdate) {
     console.log(chalk.gray('   更新 agents...'));
     await migrateAgents(projectDir, templateDir);
   }
 
-  // 6. 更新配置
+  // 6. 迁移 OpenCode
+  if (plan.details.opencodeNeedUpdate) {
+    console.log(chalk.gray('   更新 OpenCode 配置...'));
+    await migrateOpencode(projectDir, templateDir);
+  }
+
+  // 7. 更新配置
   if (plan.details.configToUpdate) {
     console.log(chalk.gray('   更新配置...'));
     await updateConfig(projectDir, newVersion);
@@ -925,6 +1016,7 @@ module.exports = {
   migrateHooks,
   migrateCommands,
   migrateAgents,
+  migrateOpencode,
   migrateFeatureList,
   updateConfig
 };

package/lib/migrations/index.js

@@ -140,6 +140,61 @@ const MIGRATIONS = [
       renamed: []
     },
     aiMigrationRequired: []
+  },
+  {
+    version: '1.1.3',
+    description: '补丁版本（无文档结构变更）',
+    changes: {
+      added: [],
+      modified: [],
+      removed: [],
+      renamed: []
+    },
+    aiMigrationRequired: []
+  },
+  {
+    version: '1.1.4',
+    description: '补丁版本（无文档结构变更）',
+    changes: {
+      added: [],
+      modified: [],
+      removed: [],
+      renamed: []
+    },
+    aiMigrationRequired: []
+  },
+  {
+    version: '1.1.5',
+    description: '补丁版本（无文档结构变更）',
+    changes: {
+      added: [],
+      modified: [],
+      removed: [],
+      renamed: []
+    },
+    aiMigrationRequired: []
+  },
+  {
+    version: '1.1.6',
+    description: '补丁版本（无文档结构变更）',
+    changes: {
+      added: [],
+      modified: [],
+      removed: [],
+      renamed: []
+    },
+    aiMigrationRequired: []
+  },
+  {
+    version: '1.1.7',
+    description: '补丁版本（无文档结构变更）',
+    changes: {
+      added: [],
+      modified: [],
+      removed: [],
+      renamed: []
+    },
+    aiMigrationRequired: []
   }
 ];
 

package/lib/plugins/registry.json

@@ -0,0 +1,54 @@
+{
+  "version": 1,
+  "plugins": [
+    {
+      "id": "serena",
+      "name": "Serena",
+      "category": "memory",
+      "integration": { "type": "mcp" },
+      "default_tier": "core"
+    },
+    {
+      "id": "brave-search",
+      "name": "Brave Search",
+      "category": "search",
+      "integration": { "type": "mcp" },
+      "default_tier": "core"
+    },
+    {
+      "id": "filesystem-mcp",
+      "name": "Filesystem MCP",
+      "category": "filesystem",
+      "integration": { "type": "mcp" },
+      "default_tier": "core"
+    },
+    {
+      "id": "github-mcp",
+      "name": "GitHub MCP",
+      "category": "git",
+      "integration": { "type": "mcp" },
+      "default_tier": "core"
+    },
+    {
+      "id": "context7",
+      "name": "Context7",
+      "category": "docs",
+      "integration": { "type": "mcp" },
+      "default_tier": "core"
+    },
+    {
+      "id": "agent-browser",
+      "name": "Agent Browser",
+      "category": "browser",
+      "integration": { "type": "daemon+skill" },
+      "default_tier": "core"
+    },
+    {
+      "id": "playwright-mcp",
+      "name": "Playwright MCP",
+      "category": "browser",
+      "integration": { "type": "mcp" },
+      "default_tier": "project"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jvibe",
-  "version": "1.1.5",
+  "version": "1.1.8",
   "description": "\u6587\u6863\u9a71\u52a8\u7684 AI \u8f85\u52a9\u5f00\u53d1\u7cfb\u7edf - Doc-driven AI-assisted development system for Claude Code and OpenCode",
   "main": "bin/jvibe.js",
   "bin": {
@@ -16,6 +16,7 @@
     "template/",
     "JVIBE.md",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "keywords": [

package/scripts/init.js

@@ -165,8 +165,10 @@ async function init(options = {}) {
     if (mode === 'full') {
       console.log(chalk.gray('  - docs/core/           (4 个核心文档)'));
       console.log(chalk.gray('  - docs/project/        (项目文档目录)'));
+      console.log(chalk.gray('  - docs/.jvibe/         (tasks.yaml + agent-contracts.yaml + plugins.yaml)'));
     } else {
       console.log(chalk.gray('  - docs/core/           (4 个核心文档)'));
+      console.log(chalk.gray('  - docs/.jvibe/         (tasks.yaml + agent-contracts.yaml + plugins.yaml)'));
     }
 
     const nextSteps = [];