Skip to content

release: merge 0.4.0 candidate #17

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
whitelonng merged 6 commits into from
Jul 22, 2026
Merged

release: merge 0.4.0 candidate #17

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
c12969b
feat: complete continuity governance evolution
whitelonng Jul 21, 2026
4dc2e7e
fix: align planning governance release contracts
whitelonng Jul 22, 2026
57855bf
fix: harden planning reframe recovery
whitelonng Jul 22, 2026
d04d706
fix: restore conditional requirement clarification
whitelonng Jul 22, 2026
2c9d697
fix: restore Continuity requirement clarification
whitelonng Jul 22, 2026
91caac8
fix: align release gates with explicit sessions
whitelonng Jul 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 12 additions & 12 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,27 +2,28 @@
# mancode .gitignore
# ===================================

# 内部开发文档（包含借鉴对象名，不公开）
DEVELOPMENT.md
# 内部法律文档（包含借鉴对象名，不公开）
LEGAL.md
*.backup

# 设计文档（内部参考，不公开）
# 历史设计文档默认不公开；当前文档白名单见下方
docs/

# Claude Code 开发配置（本地测试用）
.claude/

# 技术实现文档（包含借鉴对象名和完整实现细节，不公开）
docs/12-lifecycle.md
docs/13-scanning.md
docs/14-orchestration.md
docs/15-adapters.md

# 公开优化决策文档：PostToolUse P0 设计决策需要随代码提交
# 当前维护文档
!docs/
docs/*
!docs/README.md
!docs/architecture.md
!docs/workflows.md
!docs/project-intelligence.md
!docs/platform-adapters.md
!docs/engineering.md
!docs/12-lifecycle.md
!docs/release-acceptance.md
!docs/planning-governance-evolution.md

# Node.js
node_modules/
Expand Down Expand Up @@ -94,6 +95,5 @@ output/
# Demo projects (local only, not published)
examples/

# Local-only publishing and planning documents
# Local-only publishing configuration
.npmrc
CONTEXT_TEAM_REFACTOR_PLAN.md
95 changes: 60 additions & 35 deletions README.en.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-Continuity%20v0.3.18-2f855a?style=flat-square" alt="Status: mancode Continuity v0.3.18" />
<img src="https://img.shields.io/badge/status-Continuity%20v0.4.0-2f855a?style=flat-square" alt="Status: mancode Continuity v0.4.0" />
<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" />
</p>

Expand All @@ -34,8 +34,9 @@ different gears for different stakes: light solo mode for daily practice, `/man`
for playoff-level engineering discipline, and coaching-staff subagents for
research, planning, implementation, and review.

**mancode Continuity** is the continuous-context runtime that carries tasks,
decisions, and verification evidence safely into later conversations.
**mancode Continuity** is the cross-session and team-collaboration runtime that
carries tasks, decisions, and verification evidence safely into later
conversations.

[Installation](#installation) · [Usage](#usage)

Expand Down Expand Up @@ -107,10 +108,15 @@ one window's temporary state as another window's identity.
```bash
mancode status --brief --json
mancode context session new --client claude-code
mancode context session show --session <id> --client claude-code --json
mancode context resume <namespace:ULID> --session <id> --client claude-code
mancode context show --purpose orient --session <id> --client claude-code
```

When the project has a local mancode install, pin one CLI binary for the whole
task: prefer `./node_modules/.bin/mancode`, otherwise use `mancode`. Check the
selected binary with `--version` once and do not mix versions afterward.

The original `/man`, `/manba`, and `/manteam` entries handle these steps. The
CLI form above is useful for diagnostics, automation, or manual recovery.

Expand Down Expand Up @@ -234,7 +240,9 @@ design tokens:
</Button>
```

The default workflow asks six questions before writing code:
The default workflow evaluates a conditional clarity gate before writing code: it asks the user
only when an unresolved decision could change the goal, scope, behavior, acceptance, or key
constraints, and it proceeds without ceremonial questions when the request is already clear.

1. What problem does this change solve?
2. Can an existing implementation be reused?
Expand All @@ -243,6 +251,10 @@ The default workflow asks six questions before writing code:
5. What is the smallest meaningful runtime check?
6. What remains uncertain after checking the code and docs?

These are internal readiness checks, not a mandatory questionnaire. Any unresolved
decision-changing uncertainty becomes a focused question and blocks requirements finalization
until the user answers; clear requests continue directly.

<span id="usage"></span>

## Usage
Expand Down Expand Up @@ -353,7 +365,7 @@ it should behave, and why previous decisions were made.

## Installation

**Status**: mancode Continuity v0.3.18. Claude Code, Cursor, Codex in the ChatGPT
**Status**: mancode Continuity v0.4.0. Claude Code, Cursor, Codex in the ChatGPT
desktop app and CLI, GitHub Copilot, and ZCode adapters are included.

Requires Node.js 20 or newer. macOS, Linux, Windows CMD, PowerShell, and Git Bash
Expand Down Expand Up @@ -394,8 +406,9 @@ mancode init --platform PLATFORMS # One or more: claude-code,cursor,codex,copilo
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 # Repair or reinstall the selected adapter
mancode install --minimal # The bootstrap is already minimal; retained for compatibility
mancode adapter status --json # Inspect actual managed-content digests
mancode adapter upgrade --platform codex --dry-run # Stage a preview only
mancode adapter upgrade --platform codex --confirm --operation-id <operationId> --session <id> --client <client>
```

## Agent Modes
Expand Down Expand Up @@ -424,10 +437,16 @@ mancode init --legacy
mancode status
mancode status --json
mancode status --brief --json
mancode install <claude-code|cursor|codex|copilot|zcode>
mancode install <claude-code|cursor|codex|copilot|zcode> --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>
mancode project upgrade --policy 2 --dry-run
mancode project upgrade --policy 2 --operation-id <operationId> --session <id> --client <client>
mancode list-platforms
mancode team identity create --name "<name>"
mancode context session new --client <platform>
mancode context session show --session <id> --client <client> --json
mancode workflow create <man|manba|manteam> "<task>" --session <id>
mancode workflow list --json
mancode workflow show <namespace:ULID> --json
Expand All @@ -438,6 +457,7 @@ mancode workflow plan <namespace:ULID> confirm --plan-decision <plan_only|govern
mancode workflow update <namespace:ULID> --status <status> --expected-revision <n> --session <id>
mancode workflow review <namespace:ULID> apply --file <review-ledger.json> --expected-revision <n> --session <id>
mancode workflow verify <namespace:ULID> apply --file <verification-ledger.json> --expected-revision <n> --session <id>
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 refresh-project
Expand All @@ -452,7 +472,7 @@ mancode version
Simplified output:

```text
mancode v0.3.18
mancode v0.4.0

Project: my-app
Runtime: ready
Expand Down Expand Up @@ -594,14 +614,19 @@ mancode/
- Irreversible operations such as force pushes, schema migrations, and bulk
deletes require explicit human confirmation.

## Roadmap
## Remaining Work

- Complete real-host session acceptance for Claude Code, Codex, Cursor,
GitHub Copilot, and ZCode on one release candidate; verified host sessions
and isolated explicit sessions are both valid evidence paths.
- Run `npm run release:check -- --candidate <full-commit-sha>` for the clean
checkout, automated two-clone/legacy checks, tarball SHA-256, and install
smoke; complete cross-host recovery separately.
- Confirm ZCode project-skill discovery and workspace-command paths; keep the
adapter provisional until then.
- Evaluate Windsurf, Cline, and Roo Code adapters based on real demand.

| Phase | Focus |
|---|---|
| MVP-1 | solo mode, aesthetics, and Claude Code hooks |
| MVP-2 | `/manba`, `/man`, `/manteam`, `/manps`, and coaching-staff subagents |
| MVP-3 | Cursor, Codex (ChatGPT desktop/CLI), and GitHub Copilot adapters |
| Public Release | stable npm release, marketplace distribution, docs, and demos |
See [0.4.0 Continuity Release Acceptance](./docs/release-acceptance.md) for the complete gate.

## Troubleshooting

Expand All @@ -616,21 +641,26 @@ a deliberately empty directory.
### Claude Code hooks not triggering

After `mancode init`, restart Claude Code so it reloads `.claude/settings.json`.
Run `mancode status` to verify hooks are registered. If hooks are still missing,
run `mancode install claude-code --force` to rewrite the settings.
Run `mancode status` to verify hooks are registered. For Continuity adapter drift, preview
`mancode adapter upgrade --platform claude-code --dry-run`, then repair that
preview with its `--operation-id`, an active session, and `--confirm`. The legacy
hook architecture still uses `mancode init --legacy --force`.

### `mancode status` shows a platform as "not ready"

This means the platform's target files are missing. Run
`mancode install <platform> --force` to regenerate them. For managed-block
This means the platform's target files are missing or their digest is stale.
Preview `mancode adapter upgrade --platform <platform> --dry-run`, inspect the
staged result, then run it with the returned `--operation-id`, an active session,
and `--confirm`. For managed-block
platforms (Codex, ZCode, Copilot), the managed block in `AGENTS.md` or
`.github/copilot-instructions.md` may have been manually edited or deleted.

### AGENTS.md or copilot-instructions.md managed block was accidentally deleted

Run `mancode install codex --force` (or `zcode`, or `copilot`) to reinsert the
managed block. User-authored content outside the relevant mancode managed
markers is preserved.
Preview `mancode adapter upgrade --platform codex --dry-run` (or `zcode`, 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.

### ZCode skills not appearing

Expand All @@ -648,16 +678,8 @@ description field — invoke them by asking for `/manba` or similar.
### How to reinstall Continuity adapters

```bash
mancode uninstall claude-code --force
mancode uninstall cursor --force
mancode uninstall codex --force
mancode uninstall copilot --force
mancode uninstall zcode --force
mancode install claude-code
mancode install cursor
mancode install codex
mancode install copilot
mancode install zcode
mancode adapter upgrade --all --dry-run
mancode adapter upgrade --all --confirm --operation-id <operationId> --session <id> --client <client>
```

Continuity authority is protected, so `mancode uninstall --all` does not delete workflow
Expand All @@ -684,8 +706,11 @@ use.

### How is mancode different from a CLAUDE.md file?

A `CLAUDE.md` file is static guidance. mancode adds hooks, persisted workflow
state, slash-command skills, and separate review subagents with clean context.
A `CLAUDE.md` file is static guidance. Continuity maintains one always-loaded
Claude Code bootstrap block there, while sessions, TaskRefs, requirements,
plans, and review evidence remain structured authority under `.mancode/`.
mancode also adds mode skills, persisted workflows, and separate review
subagents with clean context.

### How is mancode different from Cursor rules, custom prompts, or agent instructions?

Expand Down
Loading
Loading