duaer-spec 0.6.1 → 0.6.2

package/ADOPT.md

@@ -1,70 +1,39 @@
 # 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
 ```
 
+That’s it. If you customized local files, glance at `git diff` once.
+
 Ensure the repo has **`main`** and **`develop`**. See
 [`docs/agent/branching-and-release.md`](docs/agent/branching-and-release.md).
 
-After that: talk to the agent in plain language.
-
-## Updating an existing install
-
-Already ran `duaer init` before? Refresh managed files:
-
-```bash
-npx duaer-spec@latest init --here --force
-```
-
-Then:
-
-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,21 +1,23 @@
 # Changelog
 
+## 0.6.2 — 2026-09-15
+
+### Simple update
+
+- `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.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)
+- `.duaer/handoff.json` + `duaer handoff [--run]`
+- Mandatory restart on develop after worktree remove
 
 ## 0.6.0 — 2026-09-15
 
-### Mandatory branch model + release flows
-
-- Required: `main` / `develop` / `feat/*` / `fix/*`
-- [`docs/agent/branching-and-release.md`](docs/agent/branching-and-release.md)
+- Mandatory `main` / `develop` / `feat/*` / `fix/*` + release flows
 
 ## 0.5.1 — 2026-09-15
 
@@ -23,24 +25,8 @@
 
 ## 0.5.0 — 2026-09-15
 
-- Autonomous digital employee (ask, don’t operate phases)
-
-## 0.4.0 — 2026-09-15
-
-- Everyday `/duaer-do` path (later agent-internal)
-
-## 0.3.0 — 2026-09-15
-
-- Job handoff policy
-
-## 0.2.0 — 2026-09-15
-
-- `delivery.json`
-
-## 0.1.1 — 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/README.md

@@ -13,8 +13,13 @@ 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.
 
 ## What the employee does (by itself)
 
@@ -41,18 +46,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/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/e2e-test-plan.md

@@ -34,7 +34,7 @@ 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 |
 
 ## Traceability
 
@@ -49,4 +49,4 @@ 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 |

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.2",
+  "description": "Digital employees: autonomous delivery; main/develop/feat/fix; simple update",
   "type": "module",
   "bin": {
     "duaer": "bin/duaer.mjs",