mancode 0.4.2 → 0.5.1

package/README.en.md

@@ -11,14 +11,14 @@
 
 <p align="center">
   Adapts to common coding agent tools, including Claude Code, Cursor, Codex in
-  the ChatGPT desktop app and CLI, GitHub Copilot, and ZCode.
+  the ChatGPT desktop app and CLI, GitHub Copilot, ZCode, Kimi Code, and Qoder.
 </p>
 
 <p align="center">
   <a href="./LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg?style=flat-square" alt="License: AGPL-3.0" /></a>
   <a href="https://www.npmjs.com/package/mancode"><img src="https://img.shields.io/npm/v/mancode?style=flat-square" alt="npm version" /></a>
-  <img src="https://img.shields.io/badge/status-Continuity%20v0.4.2-2f855a?style=flat-square" alt="Status: mancode Continuity v0.4.2" />
-  <img src="https://img.shields.io/badge/platforms-Claude%20Code%20%7C%20Cursor%20%7C%20Codex%20%7C%20Copilot%20%7C%20ZCode-5865F2?style=flat-square" alt="Platforms: Claude Code, Cursor, Codex in ChatGPT desktop and CLI, GitHub Copilot, ZCode" />
+  <img src="https://img.shields.io/badge/status-Continuity%20v0.5.1-2f855a?style=flat-square" alt="Status: mancode Continuity v0.5.1" />
+  <img src="https://img.shields.io/badge/platforms-Claude%20Code%20%7C%20Cursor%20%7C%20Codex%20%7C%20Copilot%20%7C%20ZCode%20%7C%20Kimi%20Code%20%7C%20Qoder-5865F2?style=flat-square" alt="Platforms: Claude Code, Cursor, Codex in ChatGPT desktop and CLI, GitHub Copilot, ZCode, Kimi Code, Qoder" />
 </p>
 
 <p align="center">
@@ -41,7 +41,8 @@ conversations.
 [Installation](#installation) · [Usage](#usage)
 
 mancode ships with adapters for Claude Code, Cursor, Codex in the ChatGPT
-desktop app and CLI, GitHub Copilot, and ZCode. It keeps the original `man*`
+desktop app and CLI, GitHub Copilot, ZCode, Kimi Code (desktop/CLI), and Qoder
+(IDE/CLI). It keeps the original `man*`
 entries on every platform and connects them to one Context Pack and workflow
 authority through static bootstraps.
 
@@ -124,7 +125,8 @@ CLI form above is useful for diagnostics, automation, or manual recovery.
 
 mancode gives team projects stable TaskRefs, isolated sessions, governance
 ledgers, worktree claims and handoffs, and optional git-ref coordination across
-clones. Claude Code, Cursor, Codex, GitHub Copilot, and ZCode use the same
+clones. Claude Code, Cursor, Codex, GitHub Copilot, ZCode, Kimi Code, and
+Qoder use the same
 workflow data through platform bootstraps; platform files do not hold task or
 session copies.
 
@@ -172,13 +174,15 @@ By default, `mancode init` creates mancode workflow and platform integration fil
 ├── schema.json
 ├── shared/config.json
 ├── shared/context/project.json
+├── shared/context/design-policy.json # optional; created by design configure
 ├── shared/team/
-└── local/                         # sessions, workflows, manps reports
+└── local/                         # sessions, workflows, scan reports, style cache
 
 .claude/skills/                  # Claude Code: bootstrap + original mode skills
 .cursor/rules/ + commands/       # Cursor: bootstrap + original mode commands
-AGENTS.md                        # Codex (ChatGPT desktop/CLI): managed instructions
-.agents/skills/                  # Codex / ZCode: original mode skills
+AGENTS.md                        # Codex / ZCode / Kimi Code / Qoder: separate managed instruction blocks
+.agents/skills/                  # Codex / ZCode / Kimi Code: original mode skills
+.qoder/commands/                 # Qoder: original mode commands
 .github/copilot-instructions.md  # GitHub Copilot: managed instruction block
 .github/prompts/                 # GitHub Copilot: original mode prompts
 ```
@@ -206,7 +210,7 @@ the original mode entries, never task/session snapshots. `mancode init
 - **Support team context**: use `/manteam` with confirmed typed entities under
   `.mancode/shared/`.
 - **Scan project health**: use `mancode manps` to detect stale TODOs, unused
-  dependencies, risky packages, and hardcoded design values.
+  dependencies, risky packages, mixed icon systems, and hardcoded design values.
 
 ## Best Fit
 
@@ -381,8 +385,8 @@ it should behave, and why previous decisions were made.
 
 ## Installation
 
-**Status**: mancode Continuity v0.4.2. Claude Code, Cursor, Codex in the ChatGPT
-desktop app and CLI, GitHub Copilot, and ZCode adapters are included.
+**Status**: mancode Continuity v0.5.1. Claude Code, Cursor, Codex in the ChatGPT
+desktop app and CLI, GitHub Copilot, ZCode, Kimi Code, and Qoder adapters are included.
 
 Requires Node.js 20 or newer. macOS, Linux, Windows CMD, PowerShell, and Git Bash
 are supported. Git is optional: without it, initialization continues with solo
@@ -408,6 +412,11 @@ Supported platforms:
 - ZCode: managed `AGENTS.md` block and provisional `$man*` skills in
   `.agents/skills/`; project skill discovery and slash commands pending verified
   workspace paths
+- Kimi Code (desktop app and CLI): managed `AGENTS.md` block plus
+  `/skill:man*` repo skills under `.agents/skills/`; host discovery paths
+  pending real-host verification
+- Qoder (IDE and CLI): managed `AGENTS.md` block plus `/man*` repo commands
+  under `.qoder/commands/`; host discovery paths pending real-host verification
 - Windsurf, Cline, Roo Code: planned later
 
 ### Install Options
@@ -418,7 +427,7 @@ mancode init --yes        # Skip generic-project confirmation (use --platform in
 mancode init --team       # Force-enable team mode
 mancode init --no-team    # Force-disable team mode
 mancode init --legacy --style NAME # Legacy only: save a default style preference
-mancode init --platform PLATFORMS # One or more: claude-code,cursor,codex,copilot,zcode, or all
+mancode init --platform PLATFORMS # One or more: claude-code,cursor,codex,copilot,zcode,kimi-code,qoder, or all
 mancode init --empty      # Allow a safe empty directory in non-interactive scripts
 mancode init --lang zh-CN # Explicit initialization language (zh-CN or en)
 mancode refresh-project   # Refresh facts after Git or project files are added
@@ -453,7 +462,7 @@ mancode init --legacy
 mancode status
 mancode status --json
 mancode status --brief --json
-mancode install <claude-code|cursor|codex|copilot|zcode> --confirm --operation-id <operationId> --session <id> --client <client>
+mancode install <claude-code|cursor|codex|copilot|zcode|kimi-code|qoder> --confirm --operation-id <operationId> --session <id> --client <client>
 mancode adapter status [--platform <platform>] --json
 mancode adapter upgrade <--all|--platform <platform>> --dry-run
 mancode adapter upgrade <--all|--platform <platform>> --confirm --operation-id <operationId> --session <id> --client <client>
@@ -476,8 +485,12 @@ mancode workflow verify <namespace:ULID> apply --file <verification-ledger.json>
 mancode workflow reframe <local:ULID> --expected-revision <n> --checkpoint-id <ULID> --session <id>
 mancode workflow complete <namespace:ULID> --expected-revision <n> --session <id>
 mancode manps [area]
+mancode design status --json
+mancode design context --json
+mancode design configure --expected-revision <n> [options]
+mancode design disable --expected-revision <n>
 mancode refresh-project
-mancode refresh-style
+mancode refresh-style [--root <relative-path>]
 mancode version
 ```
 
@@ -488,7 +501,7 @@ mancode version
 Simplified output:
 
 ```text
-mancode v0.4.2
+mancode v0.5.1
 
 Project:     my-app
 Runtime:     ready
@@ -502,6 +515,8 @@ mancode adapter status:
   ✓ Codex (ChatGPT desktop/CLI): ready
   ○ GitHub Copilot: not installed
   ○ ZCode: not installed
+  ○ Kimi Code (desktop/CLI): not installed
+  ○ Qoder (IDE/CLI): not installed
 ```
 
 ### `mancode manps deps`
@@ -578,6 +593,53 @@ Outputs:
 .mancode/local/preseason-reports/<timestamp>-<area>.md
 ```
 
+### `mancode design`
+
+Project design policy is opt-in. `mancode init` does not create a policy. When
+the policy is missing, disabled, or corrupt, `design context` safely resolves to
+`preserve`; ordinary coding and workflow recovery continue normally.
+Legacy projects can read this safe context, but only current Continuity projects
+can configure the shared policy.
+
+- `preserve` retains the existing hierarchy, layout, component system, and
+  interaction patterns while making only task-required UI changes.
+- `refine` improves hierarchy, typography, spacing, states, and responsive
+  behavior without changing the product structure.
+- `experimental` permits one coherent, product-appropriate visual direction
+  and more advanced composition or motion, but requires
+  `--confirm-experimental`. It never authorizes new product behavior,
+  information-architecture changes, or broader task scope.
+
+For a new UI surface or aesthetic redesign, if the user has not selected a
+visual direction, the agent first presents 2-3 distinct,
+product-appropriate directions with concise tradeoffs and a recommendation,
+then waits for the user to choose. Scoped UI fixes, changes within an existing
+design system, and tasks with an already selected direction continue directly.
+For brand, campaign, editorial, portfolio, and launch surfaces, `experimental`
+emphasizes a memorable first viewport and a visual motif carried through the
+full page; task-oriented products still prioritize workflow clarity.
+
+The policy stores only strict enums for preset, icons, emoji, motion, and browser
+validation, never free-form prompt text. Agents read code-generated guidance,
+quality gates, and a sanitized style summary through `mancode design context
+--json`. `--icons lucide` does not install Lucide; dependency changes still need
+explicit task approval.
+
+```bash
+mancode design status --json
+mancode design configure --expected-revision 0 --preset refine --icons lucide --emoji forbid-as-interface-icon --motion purposeful --browser-validation when-available
+mancode design context --json
+mancode design disable --expected-revision 1
+
+# experimental always needs an extra confirmation
+mancode design configure --expected-revision 0 --preset experimental --confirm-experimental
+```
+
+The policy lives at `.mancode/shared/context/design-policy.json` and should be
+reviewed and committed like other repository configuration. `configure` and
+`disable` update only the current checkout; they do not publish a git-ref remote
+sync receipt.
+
 ### `mancode refresh-style`
 
 Refreshes the project profile and, when UI assets are detected, rescans design
@@ -588,6 +650,11 @@ tokens. It updates:
 .mancode/shared/context/project.json
 ```
 
+For a monorepo, select one repository-relative UI root explicitly, for example
+`mancode refresh-style --root apps/web`. Absolute paths, traversal, and symlinks
+that escape the repository are rejected. Omitting `--root` preserves the
+whole-repository scan behavior.
+
 Platform adapters are static bootstraps that embed no task or style snapshot, so
 refreshing project facts does not require reinstalling them.
 
@@ -677,7 +744,8 @@ platforms (Codex, ZCode, Copilot), the managed block in `AGENTS.md` or
 
 ### AGENTS.md or copilot-instructions.md managed block was accidentally deleted
 
-Preview `mancode adapter upgrade --platform codex --dry-run` (or `zcode`, or
+Preview `mancode adapter upgrade --platform codex --dry-run` (or `zcode`,
+`kimi-code`, `qoder`, or
 `copilot`), then run it with the returned `--operation-id`, an active session,
 and `--confirm` to reinsert the managed block. User-authored content outside the
 relevant markers is preserved.

package/README.md

@@ -11,14 +11,14 @@
 
 <p align="center">
   适配常见编程代理工具，包括 Claude Code、Cursor、ChatGPT 桌面端中的 Codex、
-  Codex CLI、GitHub Copilot 和 ZCode。
+  Codex CLI、GitHub Copilot、ZCode、Kimi Code 和 Qoder。
 </p>
 
 <p align="center">
   <a href="./LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg?style=flat-square" alt="许可证：AGPL-3.0" /></a>
   <a href="https://www.npmjs.com/package/mancode"><img src="https://img.shields.io/npm/v/mancode?style=flat-square" alt="npm 版本" /></a>
-  <img src="https://img.shields.io/badge/status-Continuity%20v0.4.2-2f855a?style=flat-square" alt="状态：mancode Continuity v0.4.2" />
-  <img src="https://img.shields.io/badge/platforms-Claude%20Code%20%7C%20Cursor%20%7C%20Codex%20%7C%20Copilot%20%7C%20ZCode-5865F2?style=flat-square" alt="平台：Claude Code、Cursor、ChatGPT 桌面端 Codex、Codex CLI、GitHub Copilot、ZCode" />
+  <img src="https://img.shields.io/badge/status-Continuity%20v0.5.1-2f855a?style=flat-square" alt="状态：mancode Continuity v0.5.1" />
+  <img src="https://img.shields.io/badge/platforms-Claude%20Code%20%7C%20Cursor%20%7C%20Codex%20%7C%20Copilot%20%7C%20ZCode%20%7C%20Kimi%20Code%20%7C%20Qoder-5865F2?style=flat-square" alt="平台：Claude Code、Cursor、ChatGPT 桌面端 Codex、Codex CLI、GitHub Copilot、ZCode、Kimi Code、Qoder" />
 </p>
 
 <p align="center">
@@ -39,7 +39,7 @@
 **mancode Continuity（跨会话与团队协作运行时）**负责把任务、决策和验证证据安全地带到后续对话，并协调多人或多 Agent 的任务权威。
 
 mancode 当前支持 Claude Code、Cursor、ChatGPT 桌面端中的 Codex、Codex CLI、
-GitHub Copilot 和 ZCode。每个平台继续使用原来的 `man*` 入口，并通过静态
+GitHub Copilot、ZCode、Kimi Code（桌面端/CLI）和 Qoder（IDE/CLI）。每个平台继续使用原来的 `man*` 入口，并通过静态
 bootstrap 接入统一的 Context Pack 与 workflow authority。
 
 mancode 会安装三类能力：
@@ -106,8 +106,8 @@ mancode context show --purpose orient --session <id> --client claude-code
 ## 跨客户端与团队协作
 
 mancode 为团队项目提供稳定 TaskRef、隔离 session、治理账本、worktree claim/handoff，
-以及可选的 git-ref 跨 clone 协调。Claude Code、Cursor、Codex、GitHub Copilot 和
-ZCode 都通过 bootstrap 使用同一套工作流数据；平台文件本身不保存任务或 session 副本。
+以及可选的 git-ref 跨 clone 协调。Claude Code、Cursor、Codex、GitHub Copilot、
+ZCode、Kimi Code 和 Qoder 都通过 bootstrap 使用同一套工作流数据；平台文件本身不保存任务或 session 副本。
 
 git-ref 下的 workflow create、requirements、plan、review 和 verification 使用显式的
 延后发布边界：先不带 `--sync` 执行 mutation，将对应的 `.mancode/shared`
@@ -159,13 +159,15 @@ legacy `state.json` 与当前工作流权威数据。
 ├── schema.json
 ├── shared/config.json
 ├── shared/context/project.json
+├── shared/context/design-policy.json # 可选：design configure 后创建
 ├── shared/team/
-└── local/                         # session、workflow、manps 报告
+└── local/                         # session、workflow、扫描报告和样式缓存
 
 .claude/skills/                  # Claude Code：bootstrap + 原 mode skills
 .cursor/rules/ + commands/       # Cursor：bootstrap + 原 mode commands
-AGENTS.md                        # Codex（ChatGPT 桌面端/CLI）：托管 instructions
-.agents/skills/                  # Codex / ZCode：原 mode skills
+AGENTS.md                        # Codex / ZCode / Kimi Code / Qoder：各自托管 instructions block
+.agents/skills/                  # Codex / ZCode / Kimi Code：原 mode skills
+.qoder/commands/                 # Qoder：原 mode commands
 .github/copilot-instructions.md  # GitHub Copilot：托管 instruction block
 .github/prompts/                 # GitHub Copilot：原 mode prompts
 ```
@@ -182,7 +184,7 @@ AGENTS.md                        # Codex（ChatGPT 桌面端/CLI）：托管 ins
 - **自由选择执行强度**：计划确认后，可只保留计划、交给默认 `solo` 轻量开发，或继续完整 `/man` 的验证与有界风险审查。
 - **保留工作流产物**：调研、计划、审查报告和总结会保存到 `.mancode/<namespace>/workflows/<ULID>/`。
 - **支持团队上下文**：`/manteam` 通过 `.mancode/shared/` 的类型化实体共享已确认信息。
-- **扫描项目健康度**：`mancode manps` 检测陈旧 TODO、未使用依赖、风险依赖和硬编码设计值。
+- **扫描项目健康度**：`mancode manps` 检测陈旧 TODO、未使用依赖、风险依赖、混用图标系统和硬编码设计值。
 
 ## 适合什么项目？
 
@@ -335,8 +337,8 @@ src/components/
 
 ## 安装
 
-**状态**：mancode Continuity v0.4.2。Claude Code、Cursor、ChatGPT 桌面端中的
-Codex、Codex CLI、GitHub Copilot 和 ZCode adapter 均已接入。
+**状态**：mancode Continuity v0.5.1。Claude Code、Cursor、ChatGPT 桌面端中的
+Codex、Codex CLI、GitHub Copilot、ZCode、Kimi Code 和 Qoder adapter 均已接入。
 
 需要 Node.js 20 或更高版本。原生支持 macOS、Linux、Windows CMD、
 PowerShell 和 Git Bash。Git 是可选依赖：未安装时仍可初始化，只会把团队
@@ -360,6 +362,10 @@ mancode init --platform all
 - GitHub Copilot：托管 instruction block 与 `.github/prompts/` 原 mode prompts
 - ZCode：托管 `AGENTS.md` block，并暂按 `.agents/skills/` 生成 `$man*`
   skills；项目级 skill 发现和 slash commands 仍需确认 workspace 路径后再发布承诺
+- Kimi Code（桌面端、CLI）：托管 `AGENTS.md` block，并在 `.agents/skills/`
+  下提供 `/skill:man*` 项目 skills；宿主发现路径仍需真实验证
+- Qoder（IDE、CLI）：托管 `AGENTS.md` block，并在 `.qoder/commands/` 下提供
+  `/man*` 项目 commands；宿主发现路径仍需真实验证
 - Windsurf、Cline、Roo Code：后续计划
 
 ### 安装参数
@@ -370,7 +376,7 @@ mancode init --yes        # 跳过通用项目确认（CI 中仍需 --platform
 mancode init --team       # 强制启用团队模式
 mancode init --no-team    # 强制禁用团队模式
 mancode init --legacy --style NAME # 仅 legacy：保存默认审美偏好
-mancode init --platform PLATFORMS # 一个或多个：claude-code,cursor,codex,copilot,zcode，或 all
+mancode init --platform PLATFORMS # 一个或多个：claude-code,cursor,codex,copilot,zcode,kimi-code,qoder，或 all
 mancode init --empty      # 非交互脚本中允许安全的空目录
 mancode init --lang zh-CN # 显式指定初始化语言（zh-CN 或 en）
 mancode refresh-project   # 后续加入 Git 或项目文件后刷新项目事实
@@ -405,7 +411,7 @@ mancode init --legacy
 mancode status
 mancode status --json
 mancode status --brief --json
-mancode install <claude-code|cursor|codex|copilot|zcode> --confirm --operation-id <operationId> --session <id> --client <client>
+mancode install <claude-code|cursor|codex|copilot|zcode|kimi-code|qoder> --confirm --operation-id <operationId> --session <id> --client <client>
 mancode adapter status [--platform <platform>] --json
 mancode adapter upgrade <--all|--platform <platform>> --dry-run
 mancode adapter upgrade <--all|--platform <platform>> --confirm --operation-id <operationId> --session <id> --client <client>
@@ -428,8 +434,12 @@ mancode workflow verify <namespace:ULID> apply --file <verification-ledger.json>
 mancode workflow reframe <local:ULID> --expected-revision <n> --checkpoint-id <ULID> --session <id>
 mancode workflow complete <namespace:ULID> --expected-revision <n> --session <id>
 mancode manps [area]
+mancode design status --json
+mancode design context --json
+mancode design configure --expected-revision <n> [options]
+mancode design disable --expected-revision <n>
 mancode refresh-project
-mancode refresh-style
+mancode refresh-style [--root <relative-path>]
 mancode version
 ```
 
@@ -440,7 +450,7 @@ mancode version
 以下是简化输出示例：
 
 ```text
-mancode v0.4.2
+mancode v0.5.1
 
 Project:     my-app
 Runtime:     ready
@@ -454,6 +464,8 @@ mancode adapter status:
   ✓ Codex (ChatGPT desktop/CLI): ready
   ○ GitHub Copilot: not installed
   ○ ZCode: not installed
+  ○ Kimi Code (desktop/CLI): not installed
+  ○ Qoder (IDE/CLI): not installed
 ```
 
 ### `mancode manps deps`
@@ -527,6 +539,35 @@ mancode manps config
 .mancode/local/preseason-reports/<timestamp>-<area>.md
 ```
 
+### `mancode design`
+
+项目设计策略是显式启用功能。`mancode init` 不会创建策略；策略缺失、禁用或损坏时，
+`design context` 会安全降级为 `preserve`，普通编码和工作流恢复不受影响。
+Legacy 项目也可读取这个安全上下文，但只有当前 Continuity 项目能配置共享策略。
+
+- `preserve`：保持现有层级、布局、组件系统和交互模式，只完成任务要求的 UI 改动。
+- `refine`：在不改变产品结构的前提下改善层级、排版、间距、状态和响应式行为。
+- `experimental`：允许一个符合产品语境的统一视觉方向和更高级的构图/动效，但必须显式传入 `--confirm-experimental`；它不授权新增产品功能、改变信息架构或扩大任务范围。
+
+新建 UI 或视觉重做时，如果用户尚未选定视觉方向，Agent 会先给出 2–3 个差异明确、符合产品语境的方向，简述取舍并推荐一个，等待用户选择后再实现。局部 UI 修复、既有设计系统内的改动，以及用户已经选定方向的任务不会被这一步打断。`experimental` 对品牌、活动、编辑、作品集和发布型页面强调首屏记忆点与贯穿全页的视觉母题；对任务型产品仍优先保证工作流清晰度。
+
+策略只保存 preset、图标、表情、动效和浏览器验证的严格枚举，不保存自由文本提示词。
+Agent 通过 `mancode design context --json` 获取代码生成的固定指导、质量门槛和经过清洗的
+样式摘要。`--icons lucide` 不会自动安装 Lucide；依赖变更仍需任务明确授权。
+
+```bash
+mancode design status --json
+mancode design configure --expected-revision 0 --preset refine --icons lucide --emoji forbid-as-interface-icon --motion purposeful --browser-validation when-available
+mancode design context --json
+mancode design disable --expected-revision 1
+
+# experimental 必须额外确认
+mancode design configure --expected-revision 0 --preset experimental --confirm-experimental
+```
+
+策略保存在 `.mancode/shared/context/design-policy.json`，应像其他仓库配置一样审查并提交。
+`configure`/`disable` 只更新当前 checkout，不会发布 git-ref 远端同步回执。
+
 ### `mancode refresh-style`
 
 刷新项目 profile；检测到 UI 资产时，还会重新扫描设计 token。它会更新：
@@ -536,6 +577,9 @@ mancode manps config
 .mancode/shared/context/project.json
 ```
 
+Monorepo 可显式选择一个仓库内 UI 根目录，例如 `mancode refresh-style --root apps/web`。
+绝对路径、路径穿越和逃逸仓库的符号链接会被拒绝；不传 `--root` 时保持整仓扫描行为。
+
 平台 adapter 是不嵌入 task/style 快照的静态 bootstrap，因此刷新项目事实后不需要重装。
 
 ## 项目文件
@@ -609,7 +653,7 @@ mancode/
 
 ### AGENTS.md 或 copilot-instructions.md 受控区被误删
 
-运行 `mancode adapter upgrade --platform codex --dry-run`（或 `zcode`、`copilot`）
+运行 `mancode adapter upgrade --platform codex --dry-run`（或 `zcode`、`kimi-code`、`qoder`、`copilot`）
 检查差异，再用该预览返回的 `--operation-id` 和 active session 执行 `--confirm`
 重新插入受控区。
 对应 mancode 受控标记外的用户内容会被保留。