duaer-spec 0.6.1 → 0.6.3

package/ADOPT.md

@@ -1,70 +1,44 @@
 # Adopt duaer-spec
 
-Install once so the coding agent behaves as a **digital employee**: it runs
-Brief → work → accept **without** the human operating slash commands or CLI.
-
-## Install (human, once)
+## Install
 
 ```bash
 npx duaer-spec init --here
-# pin: npx github:fujiezee/duaer-spec@v0.6.1 duaer init --here
 ```
 
+## Update
+
 ```bash
-npx duaer-spec init --here --method
-npx duaer-spec init --here --ops
+npx duaer-spec update
 ```
 
-Ensure the repo has **`main`** and **`develop`**. See
-[`docs/agent/branching-and-release.md`](docs/agent/branching-and-release.md).
+Do **not** use `init --here --force` as the everyday refresh. `update` reuses
+the mode/branch from `.duaer/duaer-init.json`.
 
-After that: talk to the agent in plain language.
+If you customized constitution / baseline / `.duaer/handoff.json` commands,
+glance at `git diff` once and keep your overrides.
 
-## Updating an existing install
-
-Already ran `duaer init` before? Refresh managed files:
-
-```bash
-npx duaer-spec@latest init --here --force
-```
-
-Then:
+Ensure the repo has **`main`** and **`develop`**. See
+[`docs/agent/branching-and-release.md`](docs/agent/branching-and-release.md)
+(Chinese: [`README.zh-CN.md`](README.zh-CN.md)).
 
-1. **Review the git diff** — keep your project-specific edits to
-   `.duaer/memory/constitution.md`, `project-context.md`, `docs/baseline.md`,
-   and especially **`.duaer/handoff.json` `commands`** (your restart scripts).
-2. Restore any local overrides you still need.
-3. Confirm `.gitignore` still contains `.worktree/`.
-4. No need to re-learn slash commands — talk to the agent as before.
+Then talk to the agent in plain language.
 
-Pin a version if you prefer:
+## Options
 
 ```bash
-npx duaer-spec@0.6.1 init --here --force
-# or
-npx github:fujiezee/duaer-spec@v0.6.1 duaer init --here --force
+npx duaer-spec init --here --method
+npx duaer-spec init --here --ops
+npx duaer-spec update --method    # rare; usually omit
 ```
 
-Adopters are **not** auto-updated; re-run init when you want a newer revision.
-
-## What gets installed
-
-- Always-on autonomous job loop  
-- `.duaer/handoff.json` — restart services on **develop** after worktree remove  
-- Agent ops: `AGENTS.md`, branching/release docs, mandatory `.worktree/`  
-
-## Branch model (mandatory)
-
-| Branch | Role |
-|---|---|
-| `main` | Production / online |
-| `develop` | Day-to-day integration |
-| `feat/<name>` | Features → `develop` |
-| `fix/<name>` | Fixes → `develop` (hotfix via `main`) |
+## What you get
 
-After merge: **`duaer handoff [--run]`** (stop worktree services → restart on develop).
+- Autonomous job loop (ask → Brief → work → accept)  
+- `.duaer/handoff.json` + `duaer handoff` after worktree remove  
+- Agent ops: `main` / `develop` / `feat` / `fix` + `.worktree/`  
 
 ## Precedence
 
-1. `AGENTS.md` — how employees operate  
-2. `DUADER.md` / `.duaer/` — how jobs are briefed  
+1. `AGENTS.md`  
+2. `DUADER.md` / `.duaer/`  

package/CHANGELOG.md

@@ -1,46 +1,40 @@
 # Changelog
 
-## 0.6.1 — 2026-09-15
-
-### Worktree → develop service handoff
-
-- Mandatory handoff after merge: stop worktree-bound processes, remove
-  `.worktree/<id>`, restart from primary checkout on `develop`
-- `.duaer/handoff.json` configures restart commands (e.g. `npm run dev`)
-- CLI: `duaer handoff` / `duaer handoff --run`
-- Docs: update path for existing installs (`init --force` + review diff)
+## 0.6.3 — 2026-09-15
 
-## 0.6.0 — 2026-09-15
+### Docs: update path in installed 说明
 
-### Mandatory branch model + release flows
+- `DUADER.md` and `docs/agent/branching-and-release.md` document `npx duaer-spec update`
+- Add `README.zh-CN.md` (install / update / branches)
+- ADOPT clarifies: do not use `init --force` for everyday refresh
 
-- Required: `main` / `develop` / `feat/*` / `fix/*`
-- [`docs/agent/branching-and-release.md`](docs/agent/branching-and-release.md)
+## 0.6.2 — 2026-09-15
 
-## 0.5.1 — 2026-09-15
+### Simple update
 
-- Mandatory `.worktree/` (gitignored)
+- `npx duaer-spec update` refreshes an existing install (no `--force` flags to remember)
+- Remembers prior init mode from `.duaer/duaer-init.json`
+- README / ADOPT: install + update are each one line
 
-## 0.5.0 — 2026-09-15
-
-- Autonomous digital employee (ask, don’t operate phases)
+## 0.6.1 — 2026-09-15
 
-## 0.4.0 — 2026-09-15
+### Worktree → develop service handoff
 
-- Everyday `/duaer-do` path (later agent-internal)
+- `.duaer/handoff.json` + `duaer handoff [--run]`
+- Mandatory restart on develop after worktree remove
 
-## 0.3.0 — 2026-09-15
+## 0.6.0 — 2026-09-15
 
-- Job handoff policy
+- Mandatory `main` / `develop` / `feat/*` / `fix/*` + release flows
 
-## 0.2.0 — 2026-09-15
+## 0.5.1 — 2026-09-15
 
-- `delivery.json`
+- Mandatory `.worktree/` (gitignored)
 
-## 0.1.1 — 2026-09-15
+## 0.5.0 — 2026-09-15
 
-- Digital-employee positioning
+- Autonomous digital employee
 
-## 0.1.0 — 2026-09-15
+## 0.4.0 — 0.1.0
 
-- First public release
+See git history for earlier notes.

package/DUADER.md

@@ -7,9 +7,10 @@ runs Brief → work → accept. Humans are not the operators of the phase machin
 
 ## Human experience
 
-1. One-time: `npx duaer-spec init --here`  
-2. Ongoing: describe work in chat  
-3. Review the handoff line (accepted / not yet)
+1. One-time install: `npx duaer-spec init --here`  
+2. Later refresh: `npx duaer-spec update`  
+3. Ongoing: describe work in chat  
+4. Review the handoff line (accepted / not yet)
 
 ## Agent procedure (autonomous)
 
@@ -42,4 +43,5 @@ Humans need not configure it for everyday use.
 ## Related
 
 - Adopt: [`ADOPT.md`](ADOPT.md)
+- Branches / go-live: [`docs/agent/branching-and-release.md`](docs/agent/branching-and-release.md)
 - Agent ops: [`AGENTS.md`](AGENTS.md)

package/README.md

@@ -13,8 +13,15 @@ talk; the employee runs the process.
 npx duaer-spec init --here
 ```
 
-Then use Cursor as usual — describe what you want. No slash-command chain
-required.
+## Update
+
+```bash
+npx duaer-spec update
+```
+
+Then use Cursor as usual — describe what you want.
+
+中文说明：[`README.zh-CN.md`](README.zh-CN.md)
 
 ## What the employee does (by itself)
 
@@ -41,18 +48,10 @@ Go-live and flows by issue type:
 **After merge:** `duaer handoff [--run]` restarts local services on `develop`
 (configure commands in `.duaer/handoff.json`).
 
-## Updating
-
-```bash
-npx duaer-spec@latest init --here --force   # review diff; keep handoff commands
-```
-
-Details: [`ADOPT.md`](ADOPT.md)#updating-an-existing-install
-
 ## Optional
 
 ```bash
-npx duaer-spec@0.6.1 init --here --method
+npx duaer-spec init --here --method
 ```
 
 Details: [`ADOPT.md`](ADOPT.md) · Method: [`DUADER.md`](DUADER.md) · Ops: [`AGENTS.md`](AGENTS.md)

package/README.zh-CN.md

@@ -0,0 +1,34 @@
+# duaer-spec
+
+**Duaer** 把 AI 编程助手变成**数字员工**：你用自然语言提需求，它自己跑 Spec → 实现 → 验收；只有交接干净才算完成。
+
+你**不用**操作流程。装一次之后，说话即可。
+
+## 安装
+
+```bash
+npx duaer-spec init --here
+```
+
+## 更新
+
+```bash
+npx duaer-spec update
+```
+
+若你改过本地 constitution / baseline / `handoff.json` 命令，看一眼 `git diff` 即可。
+
+## 必须有的分支
+
+| 分支 | 作用 |
+|---|---|
+| `main` | 生产 / 正式上线 |
+| `develop` | 日常集成、联调 |
+| `feat/<name>` | 功能 → 合进 `develop` |
+| `fix/<name>` | 缺陷 → 合进 `develop`（紧急从 `main` 出，再回补 `develop`） |
+
+不同问题怎么上线：[`docs/agent/branching-and-release.md`](docs/agent/branching-and-release.md)
+
+合并后：`duaer handoff [--run]` 在 `develop` 上重启本地服务（命令写在 `.duaer/handoff.json`）。
+
+英文源：[`README.md`](README.md) · 采纳细节：[`ADOPT.md`](ADOPT.md)

package/bin/duaer.mjs

@@ -27,25 +27,16 @@ const POLICY_MODES = new Set(['off', 'coach', 'strict'])
 
 const USAGE = `duaer — digital-employee delivery (duaer-spec ${PKG.version})
 
-Human (once / update):
-  duaer init [--here] [--force]   Install or refresh into a project
+Install:  npx duaer-spec init --here
+Update:   npx duaer-spec update
 
-After install: talk to the agent in plain language.
+Then talk to the agent in plain language.
 
-Agent / optional:
-  duaer handoff [dir] [--run]   After merge: print/restart services on develop
-  duaer status [dir]
-  duaer check | policy | version
+Also:
+  duaer handoff [--run]   Restart services on develop after worktree remove
+  duaer status | check | policy | version | help
 
-Init: --all (default) | --method | --ops | --force | --branch <n> (default: develop) | --here
-
-Update existing install:
-  npx duaer-spec@latest init --here --force
-  # then review git diff; keep project-specific constitution / baseline / handoff commands
-
-Example:
-  npx duaer-spec init --here
-  duaer handoff --run
+Init options: --all | --method | --ops | --force | --branch <n> | --here
 `
 
 function parseArgs(argv) {
@@ -63,14 +54,21 @@ function parseArgs(argv) {
     strict: false,
     policyMode: null,
     run: false,
+    modeExplicit: false,
   }
   const rest = args.slice(1)
   for (let i = 0; i < rest.length; i++) {
     const a = rest[i]
-    if (a === '--all') out.mode = 'all'
-    else if (a === '--method') out.mode = 'method'
-    else if (a === '--ops') out.mode = 'ops'
-    else if (a === '--force') out.force = true
+    if (a === '--all') {
+      out.mode = 'all'
+      out.modeExplicit = true
+    } else if (a === '--method') {
+      out.mode = 'method'
+      out.modeExplicit = true
+    } else if (a === '--ops') {
+      out.mode = 'ops'
+      out.modeExplicit = true
+    } else if (a === '--force') out.force = true
     else if (a === '--here') out.dir = '.'
     else if (a === '--workplace') out.workplace = true
     else if (a === '--delivery') out.delivery = true
@@ -338,11 +336,31 @@ function cmdInit(opts) {
   console.log(`
 Hired.
 
-You: describe work in Cursor (plain language).
-Agent: runs Brief → work → accept; uses develop + .worktree/; after merge runs handoff.
+Talk to the agent in plain language.
+Later update:  npx duaer-spec update
+`)
+}
 
-Update later: npx duaer-spec@latest init --here --force  (review the diff)
-Handoff:      duaer handoff [--run]   # restart services on develop after worktree remove
+function cmdUpdate(opts) {
+  const target = resolve(opts.dir)
+  const marker = readJson(join(target, '.duaer', 'duaer-init.json'), null)
+  if (!marker && !existsSync(join(target, '.duaer')) && !existsSync(join(target, 'DUADER.md'))) {
+    console.log('No duaer install found here. Use: npx duaer-spec init --here')
+    process.exitCode = 1
+    return
+  }
+
+  if (!opts.modeExplicit && marker?.mode && ['all', 'method', 'ops'].includes(marker.mode)) {
+    opts.mode = marker.mode
+  }
+  if (marker?.branch) opts.branch = marker.branch
+  opts.force = true
+
+  console.log(`Updating → ${PKG.version}`)
+  cmdInit(opts)
+  console.log(`
+Updated.
+If you customized constitution / baseline / handoff commands, check git diff once.
 `)
 }
 
@@ -690,6 +708,9 @@ function main() {
       case 'init':
         cmdInit(opts)
         break
+      case 'update':
+        cmdUpdate(opts)
+        break
       case 'check':
         cmdCheck(opts)
         break

package/docs/agent/README.md

@@ -10,4 +10,6 @@ Wins over Duaer and `examples/` when they conflict.
 | [change-checklist.md](change-checklist.md) | Finish checklist |
 | [e2e-test-plan.md](e2e-test-plan.md) | E2E scenario catalog template |
 
-Root contract: [`AGENTS.md`](../../AGENTS.md). Adoption: [`ADOPT.md`](../../ADOPT.md).
+Root contract: [`AGENTS.md`](../../AGENTS.md).  
+Adoption: [`ADOPT.md`](../../ADOPT.md) — `npx duaer-spec init --here` / `npx duaer-spec update`.  
+Chinese summary: [`README.zh-CN.md`](../../README.zh-CN.md).

package/docs/agent/branching-and-release.md

@@ -199,9 +199,20 @@ All implementation edits happen inside the request worktree.
 
 ---
 
+## 7. Install and update (adopters)
+
+```bash
+npx duaer-spec init --here     # once
+npx duaer-spec update          # later refresh — no --force recipe
+```
+
+Details: [`ADOPT.md`](../../ADOPT.md). Chinese summary: [`README.zh-CN.md`](../../README.zh-CN.md).
+
 ## Related
 
 - [workflow.md](workflow.md) — R4 and development loop  
 - [change-checklist.md](change-checklist.md) — finish checklist  
 - [baseline.md](../baseline.md) — frozen: `develop` + `main`  
-- [ADOPT.md](../../ADOPT.md) — install into another repo  
+- [ADOPT.md](../../ADOPT.md) — install / update into another repo  
+- [README.zh-CN.md](../../README.zh-CN.md) — Chinese install, update, branches  
+

package/docs/agent/e2e-test-plan.md

@@ -34,7 +34,9 @@ the table for their app.
 | E2E-007 | Request worktrees use `.worktree/<id>`; `.worktree/` gitignored | manual |
 | E2E-008 | Docs require main+develop+feat+fix and typed go-live flows | manual |
 | E2E-009 | After merge, handoff restarts services on develop (`duaer handoff`) | manual |
-| E2E-010 | ADOPT documents `init --force` update path for existing installs | manual |
+| E2E-010 | `npx duaer-spec update` refreshes an existing install | manual |
+| E2E-011 | Installed docs (`DUADER.md`, `docs/agent/`) document `update` | manual |
+| E2E-012 | `README.zh-CN.md` covers install, update, branch model | manual |
 
 ## Traceability
 
@@ -49,4 +51,6 @@ the table for their app.
 | E2E-007 | `.worktree/` + `.gitignore` | Mandatory isolation |
 | E2E-008 | `branching-and-release.md` | Branch + release matrix |
 | E2E-009 | `.duaer/handoff.json` / `duaer handoff` | Service handoff |
-| E2E-010 | `ADOPT.md` Updating | Existing installs |
+| E2E-010 | `duaer update` | One-line refresh |
+| E2E-011 | DUADER + agent docs | Update path in installed 说明 |
+| E2E-012 | `README.zh-CN.md` | Chinese 说明文档 |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "duaer-spec",
-  "version": "0.6.1",
-  "description": "Digital employees: autonomous delivery; main/develop/feat/fix; worktree handoff",
+  "version": "0.6.3",
+  "description": "Digital employees: autonomous delivery; main/develop/feat/fix; simple update",
   "type": "module",
   "bin": {
     "duaer": "bin/duaer.mjs",
@@ -18,7 +18,8 @@
     "docs/agent",
     "docs/baseline.md",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "README.zh-CN.md"
   ],
   "publishConfig": {
     "access": "public"