mancode 0.3.3 → 0.3.4

package/README.md

@@ -17,7 +17,7 @@
 <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-stable%20v0.3.3-green?style=flat-square" alt="Status: stable v0.3.3" />
+  <img src="https://img.shields.io/badge/status-stable%20v0.3.4-green?style=flat-square" alt="Status: stable v0.3.4" />
   <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/tests-381%20passed-brightgreen?style=flat-square" alt="Tests: 381 passed" />
 </p>
@@ -67,6 +67,13 @@ cd your-project
 mancode init
 ```
 
+`init` guides you through the agent choice and marks a detected agent as a hint;
+it never silently installs every adapter. Choose one or more adapters, or choose
+**All platforms**. In a brand-new empty folder it asks whether to initialize a
+generic project, so users do not need to know `git init` or `npm init -y` first.
+Adding Git or a manifest later is safe; run `mancode refresh-project` to update
+the detected project facts and installed static adapters.
+
 ## 
 
 After initialization, keep using your coding agent normally. `solo` mode runs by
@@ -285,7 +292,7 @@ it should behave, and why previous decisions were made.
 
 ## Installation
 
-**Status**: stable v0.3.3. Claude Code, Cursor, Codex in the ChatGPT desktop app
+**Status**: stable v0.3.4. Claude Code, Cursor, Codex in the ChatGPT desktop app
 and CLI, and GitHub Copilot are supported. ZCode adapter support is included,
 with project skill discovery kept behind a verification gate before release.
 
@@ -299,6 +306,8 @@ npm install -g mancode
 cd your-project
 mancode init
 mancode init --platform cursor
+mancode init --platform codex,cursor
+mancode init --platform all
 ```
 
 Supported platforms:
@@ -317,11 +326,14 @@ Supported platforms:
 
 ```bash
 mancode init --force      # Reinstall while preserving scanned tokens
-mancode init --yes        # Skip confirmations for CI usage
+mancode init --yes        # Skip generic-project confirmation (use --platform in CI)
 mancode init --team       # Force-enable team mode
 mancode init --no-team    # Force-disable team mode
 mancode init --style NAME # Save a default style preference
-mancode init --platform PLATFORM # Initialize for claude-code, cursor, codex, copilot, or zcode
+mancode init --platform PLATFORMS # One or more: claude-code,cursor,codex,copilot,zcode, 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
 mancode install --force   # Reinstall adapter while preserving scanned tokens
 mancode install --minimal # Install only solo-mode essentials
 ```
@@ -373,7 +385,7 @@ mancode version
 Example output for a UI project (not a default stack):
 
 ```text
-mancode v0.3.3
+mancode v0.3.4
 
 Project:     my-app (React + TypeScript + Tailwind)
 Mode:        solo (default)
@@ -542,10 +554,11 @@ mancode/
 
 ### `mancode init` says "not a project directory"
 
-mancode requires either a `.git` directory or a recognized project manifest
-(such as `package.json`, `pyproject.toml`, `go.mod`, `Cargo.toml`, `pom.xml`,
-`build.gradle`, `build.gradle.kts`, `Package.swift`, or `pubspec.yaml`). Run `mancode init` inside
-a git repository or a supported project directory.
+In an interactive terminal, an empty directory is offered as a new generic
+project. No Git or package command is required. To protect existing files,
+non-empty unrecognized directories are rejected; enter the project directory
+instead. For scripts, use `mancode init --empty --platform <platform>` only for
+a deliberately empty directory.
 
 ### Claude Code hooks not triggering
 

package/README.zh-CN.md

@@ -17,7 +17,7 @@
 <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-stable%20v0.3.3-green?style=flat-square" alt="状态：稳定版 v0.3.3" />
+  <img src="https://img.shields.io/badge/status-stable%20v0.3.4-green?style=flat-square" alt="状态：稳定版 v0.3.4" />
   <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/tests-381%20passed-brightgreen?style=flat-square" alt="测试：381 通过" />
 </p>
@@ -63,6 +63,11 @@ cd your-project
 mancode init
 ```
 
+`init` 会引导选择 Agent，并把检测到的 Agent 仅作为提示；不会悄悄安装全部适配器。
+可以选择一个、多个或“全部平台”。全新空目录会询问是否初始化为通用项目，因此用户不必
+先知道 `git init` 或 `npm init -y`。之后再加入 Git 或项目 manifest 也安全，执行
+`mancode refresh-project` 即可刷新项目事实和已安装的静态适配器。
+
 
 
 初始化后，继续正常使用你的编码代理。`solo` 默认自动生效：日常训练，零仪式感。遇到需要
@@ -248,7 +253,7 @@ src/components/
 
 ## 安装
 
-**状态**：稳定版 v0.3.3。Claude Code、Cursor、ChatGPT 桌面端中的 Codex、
+**状态**：稳定版 v0.3.4。Claude Code、Cursor、ChatGPT 桌面端中的 Codex、
 Codex CLI 和 GitHub Copilot 均已支持。ZCode adapter 已接入，但项目级 skill
 发现路径在发布前仍作为验证门禁。
 
@@ -261,6 +266,8 @@ npm install -g mancode
 cd your-project
 mancode init
 mancode init --platform cursor
+mancode init --platform codex,cursor
+mancode init --platform all
 ```
 
 平台支持：
@@ -278,11 +285,14 @@ mancode init --platform cursor
 
 ```bash
 mancode init --force      # 重装并保留已扫描 token
-mancode init --yes        # CI 场景跳过确认
+mancode init --yes        # 跳过通用项目确认（CI 中仍需 --platform）
 mancode init --team       # 强制启用团队模式
 mancode init --no-team    # 强制禁用团队模式
 mancode init --style NAME # 保存默认审美偏好
-mancode init --platform PLATFORM # 初始化 claude-code、cursor、codex、copilot 或 zcode
+mancode init --platform PLATFORMS # 一个或多个：claude-code,cursor,codex,copilot,zcode，或 all
+mancode init --empty      # 非交互脚本中允许安全的空目录
+mancode init --lang zh-CN # 显式指定初始化语言（zh-CN 或 en）
+mancode refresh-project   # 后续加入 Git 或项目文件后刷新项目事实
 mancode install --force   # 重装适配并保留已扫描 token
 mancode install --minimal # 只安装 solo 必需文件
 ```
@@ -334,7 +344,7 @@ mancode version
 以下是 UI 项目的输出示例，并非默认技术栈：
 
 ```text
-mancode v0.3.3
+mancode v0.3.4
 
 Project:     my-app (React + TypeScript + Tailwind)
 Mode:        solo (default)
@@ -492,7 +502,9 @@ mancode/
 
 ### `mancode init` 提示"not a project directory"
 
-mancode 要求目标目录有 `.git` 或已识别的项目 manifest（如 `package.json`、`pyproject.toml`、`go.mod`、`Cargo.toml`、`pom.xml`、`build.gradle`、`build.gradle.kts`、`Package.swift` 或 `pubspec.yaml`）。请在 git 仓库或支持的项目目录中运行 `mancode init`。
+交互式终端中的空目录会询问是否初始化为通用项目，不需要 Git 或 npm 命令。为了保护已有
+文件，未识别且非空的目录仍会被拒绝；请进入真正的项目目录。脚本里只应针对明确为空的
+目录使用 `mancode init --empty --platform <platform>`。
 
 ### Claude Code hooks 不生效