@zeyue0329/xiaoma-cli 1.8.0 → 1.8.1

package/.idea/XiaoMa-Cli.iml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
+  </profile>
+</component>

package/.idea/misc.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_24" default="true" project-jdk-name="24" project-jdk-type="JavaSDK">
+    <output url="file://$PROJECT_DIR$/out" />
+  </component>
+</project>

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/XiaoMa-Cli.iml" filepath="$PROJECT_DIR$/.idea/XiaoMa-Cli.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/prettier.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="PrettierConfiguration">
+    <option name="myConfigurationMode" value="AUTOMATIC" />
+  </component>
+</project>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

package/CLAUDE.md

@@ -0,0 +1,93 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+XiaoMa-CLI (`@zeyue0329/xiaoma-cli`) is an AI-driven agile development framework/CLI tool. It installs specialized AI agent personas, workflows, and skills into a user's project directory for use with AI IDEs (Claude Code, Cursor, etc.). Node.js v20+ required.
+
+## Common Commands
+
+```bash
+# Quality gate (run before commits)
+npm run quality
+
+# Individual checks
+npm run test:schemas        # Agent YAML schema validation (Zod-based)
+npm run test:install        # Installation component tests
+npm run test:refs           # Cross-file reference validation
+npm run validate:schemas    # Schema validation (separate from test)
+npm run validate:refs       # File reference validation (strict mode)
+npm run lint                # ESLint (JS + YAML), zero warnings allowed
+npm run lint:md             # Markdown linting
+npm run format:check        # Prettier check
+npm run format:fix          # Prettier auto-fix
+
+# Test coverage
+npm run test:coverage       # c8 coverage report for schema tests
+
+# Run the CLI locally
+npm run install:xiaoma      # Run install command
+npm run xiaoma:uninstall    # Run uninstall command
+```
+
+The full `npm test` runs: test:schemas → test:refs → test:install → validate:schemas → lint → lint:md → format:check.
+
+## Architecture
+
+### Two-Layer Structure
+
+1. **`src/`** — Content modules (YAML agents, Markdown workflows, skills)
+2. **`tools/`** — CLI implementation (Node.js/CommonJS, installer, validators)
+
+### Module System
+
+Modules are defined by `module.yaml` files with configuration variables, prompts, and directory declarations:
+- **`src/core/`** — Shared skills and tasks (module code: `core`)
+- **`src/xmc/`** — XiaoMa Method module, the primary agile framework (module code: `xmc`)
+
+### Agent System (`src/xmc/agents/`)
+
+Agents are YAML files validated against a Zod schema (`tools/schema/`). Each agent defines:
+- `metadata` — id, name, title, icon, module, capabilities
+- `persona` — role, identity, communication_style, principles
+- `menu` — trigger commands pointing to workflow exec targets
+- `prompts` / `critical_actions` — optional
+
+### Workflow System (`src/xmc/workflows/`)
+
+Organized by development phase:
+- `1-analysis/` — Brainstorming, research, product brief
+- `2-plan-workflows/` — PRD creation/validation, UX design
+- `3-solutioning/` — Architecture, epics/stories, implementation readiness
+- `4-implementation/` — Sprint planning, story execution, code review, retros
+
+Each workflow has: `workflow.md` (entry point with metadata), `steps/` or `steps-{variant}/` directories, and optional `templates/` and `data/` directories.
+
+### CLI (`tools/cli/`)
+
+- **Entry**: `xiaoma-cli.js` (Commander.js) → wrapped by `xiaoma-npx-wrapper.js`
+- **Commands**: `install`, `status`, `uninstall`
+- **Installer** (`tools/cli/installers/`): Core orchestration class (~8K LOC), module manager, IDE config manager, manifest generator
+- **UI**: `@clack/prompts` for interactive terminal prompts
+
+### Skills (`src/core/skills/`)
+
+Reusable capabilities: `xiaoma-help`, `xiaoma-brainstorming`, `xiaoma-distillator`, `xiaoma-party-mode`, editorial review skills, etc.
+
+## Code Conventions
+
+- **JS**: CommonJS (`require`/`module.exports`) for all CLI/tool code
+- **YAML**: `.yaml` extension enforced by ESLint (not `.yml`); double quotes preferred
+- **Formatting**: Prettier with 140 char print width, 2-space indent, double quotes in YAML, single quotes in JS
+- **Linting**: ESLint flat config with unicorn, node, yml plugins; `--max-warnings=0`
+- **Schema validation**: Zod for agent YAML validation at `tools/schema/`
+- **Git hooks**: Husky + lint-staged (runs lint:fix and format:fix on staged files)
+
+## Testing
+
+Tests are plain Node.js scripts (no test framework), located in `test/`:
+- `test-agent-schema.js` — Validates all agent YAML against Zod schema; 50 fixtures (18 valid, 32 invalid); targets 100% coverage
+- `test-installation-components.js` — Installation flow verification
+- `test-file-refs-csv.js` — Validates cross-file references in CSV data files
+- Fixtures in `test/fixtures/agent-schema/{valid,invalid}/`

package/TECH-STACK.md

@@ -0,0 +1,62 @@
+# XiaoMa-CLI 技术栈清单
+
+## 运行环境
+
+| 技术 | 版本 | 用途 |
+|---|---|---|
+| Node.js | >= 20.0.0 | 运行环境 |
+| npm | - | 包管理 |
+
+## 运行时依赖
+
+| 库 | 用途 |
+|---|---|
+| **commander** | CLI 命令行参数解析 |
+| **@clack/prompts** + **@clack/core** | 交互式终端提示 UI |
+| **chalk** | 终端颜色输出 |
+| **picocolors** | 轻量终端颜色（配合 clack） |
+| **ora** | 终端 loading 动画 |
+| **zod** | YAML schema 运行时校验 |
+| **yaml** + **js-yaml** | YAML 解析（两个库并存） |
+| **csv-parse** | CSV 文件解析 |
+| **xml2js** | XML 解析 |
+| **glob** | 文件路径模式匹配 |
+| **fs-extra** | 增强的文件系统操作 |
+| **semver** | 语义化版本号比较 |
+| **ignore** | .gitignore 风格的文件过滤 |
+| **@kayvan/markdown-tree-parser** | Markdown 结构解析 |
+
+## 开发依赖
+
+| 库 | 用途 |
+|---|---|
+| **eslint** (v9, flat config) | JS/YAML 代码检查 |
+| **eslint-plugin-n** | Node.js 规则 |
+| **eslint-plugin-unicorn** | 现代 JS 最佳实践 |
+| **eslint-plugin-yml** | YAML 文件检查 |
+| **yaml-eslint-parser** | YAML ESLint 解析器 |
+| **prettier** | 代码格式化 |
+| **prettier-plugin-packagejson** | package.json 排序格式化 |
+| **eslint-config-prettier** | ESLint/Prettier 冲突处理 |
+| **markdownlint-cli2** | Markdown 检查 |
+| **yaml-lint** | YAML 语法检查 |
+| **jest** (v30) | 测试框架（已引入，当前测试为纯 Node 脚本） |
+| **c8** | 代码覆盖率（Istanbul 兼容） |
+| **husky** | Git hooks 管理 |
+| **lint-staged** | 暂存文件自动检查 |
+
+## 内容/配置格式
+
+| 格式 | 用途 |
+|---|---|
+| **YAML** | Agent 定义、模块配置、CI/CD |
+| **Markdown** | 工作流步骤、模板、文档 |
+| **CSV** | 数据文件、交叉引用 |
+| **JSON** | 包配置、IDE 配置输出 |
+
+## CI/CD
+
+| 技术 | 用途 |
+|---|---|
+| **GitHub Actions** | 质量门禁 + 发布自动化 |
+| **npm publish** | 包发布（public scope） |

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@zeyue0329/xiaoma-cli",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "XiaoMa Universal AI Agent Framework",
   "keywords": [
     "agile",