liteagents 2.20.0 → 2.21.0

package/packages/opencode/command/stash.md

@@ -8,12 +8,18 @@ argument-hint: [optional stash name]
 Save session context for compaction recovery or handoffs.
 
 **Guardrails**
-- Favor straightforward, minimal implementations first and add complexity only when requested or clearly required.
-- Keep changes tightly scoped to the requested outcome.
-- **Mid-tier model, not hardcoded.** The write-up subagent (step 2) uses a mid-tier model —
-  capable of semantic judgment, cheaper/faster than your top reasoning tier (e.g. Claude's
-  Sonnet vs Opus). Use whatever your tool designates as that balanced default; never hardcode
-  a vendor-specific model name.
+- **Write only what the brief contains.** The subagent expands the brief into a file; it does
+  not research, re-derive, or infer. Every fact, number, SHA, path, and identifier in the
+  stash comes from the brief verbatim — never invent, never round, never fill a gap with a
+  plausible guess. Missing detail stays missing.
+- **Escalate, never assume.** Anything the subagent cannot do, cannot verify, or that this
+  spec does not cover → report it back to the orchestrator (the main session) rather than
+  improvising. Never widen scope beyond writing the file and counting the backlog.
+- **Mid-tier model, not hardcoded.** Run the worker on your tool's balanced default tier —
+  judgment-capable, cheaper and faster than your top reasoning tier. **Not the
+  cheapest/fastest tier**: on judgment work it measurably degrades (misclassification rates
+  several times higher). Never hardcode a vendor-specific model name; use whatever your tool
+  designates as that default.
 - **Background dispatch where supported.** Run the write-up subagent in the background
   (non-blocking) so the session isn't held up waiting on formatting/file I/O. Fall back to
   writing inline (today's behavior) if your tool has no subagent or background-dispatch

package/packages/opencode/opencode.jsonc

@@ -157,21 +157,21 @@
       "template": "{file:./command/refactor.md}",
       "description": "Refactor code while maintaining behavior and tests"
     },
-    "diff-review": {
-      "template": "{file:./command/diff-review.md}",
-      "description": "Comprehensive code review including quality, tests, and architecture"
+    "branch-review": {
+      "template": "{file:./command/branch-review.md}",
+      "description": "Pre-merge review: general review + full security audit, verify pass, no fixes"
     },
     "security": {
       "template": "{file:./command/security.md}",
-      "description": "Security vulnerability scan and analysis"
+      "description": "Security audit — recurring six, injection, auth, trust boundaries; reports, never fixes"
     },
     "ship": {
       "template": "{file:./command/ship.md}",
-      "description": "Pre-deployment verification checklist"
+      "description": "Mechanical pre-deploy gate — tests, build, tree state"
     },
     "release": {
       "template": "{file:./command/release.md}",
-      "description": "Deliver a feature end-to-end: verify, docs, merge, tag (publish stays manual)"
+      "description": "Verify, sweep docs, cut a version — then hand back the merge/tag/publish sequence"
     },
     "remember": {
       "template": "{file:./command/remember.md}",

package/packages/subagentic-manual.md

@@ -56,7 +56,7 @@ Install for your platform:
 - brainstorming, debug-method, live-canvas, skill-creator, trace-back
 
 **10 Commands** - Workflow helpers
-- docs-builder, optimize, refactor, remember, diff-review, security, ship, release, stash, test-generate
+- docs-builder, optimize, refactor, remember, branch-review, security, ship, release, stash, test-generate
 
 **Orchestration System**
 - Automatic intent matching to 9 workflow patterns
@@ -123,10 +123,10 @@ Install for your platform:
 - `optimize` - Performance analysis
 - `refactor` - Maintain behavior while improving code
 - `remember` - Consolidate stashes + friction into project memory
-- `diff-review` - Review a file, branch, or range; verifies findings before fixing
+- `branch-review` - Review a branch + full security audit; verifies findings, reports without fixing
 - `security` - Vulnerability scanning
 - `ship` - Pre-deployment checklist
-- `release` - Deliver a feature end-to-end: verify → docs → merge → tag (publish stays manual)
+- `release` - Prepare a release: verify → docs → bump → commit, then report the merge/tag/publish sequence for you to authorize
 - `stash` - Save session context for compaction recovery or handoffs
 - `test-generate` - Test suite generation
 
@@ -139,7 +139,7 @@ Same functionality as skills+commands, but:
 
 **Command Categories**:
 - **Development & Testing (6)**: tdd-flow, test-traps, test-generate, debug-method, trace-back, verify-done
-- **Code Operations (6)**: refactor, optimize, diff-review, security, ship, release
+- **Code Operations (6)**: refactor, optimize, branch-review, security, ship, release
 - **Session & Memory (5)**: brainstorming, skill-creator, docs-builder, stash, remember
 - **Design (1)**: live-canvas
 
@@ -236,7 +236,7 @@ Each pattern includes conditional decision points requiring user approval.
 ### Droid/OpenCode: Direct Command Invocation
 
 No orchestrator - invoke commands directly:
-- `/diff-review <file-or-branch>`
+- `/branch-review <file-or-branch> [level]`
 - `/refactor <code-section>`
 - `/tdd-flow <feature>`
 

package/packages/ampcode/commands/diff-review.md

@@ -1,78 +0,0 @@
----
-name: diff-review
-description: Review diff [file, branch, or range]
-usage: /diff-review
-argument-hint: [file, branch (e.g. main), range (main..HEAD), or empty]
-allowed-tools: Read, Edit, Grep, Glob, Bash(git diff *), Bash(git log *), Bash(git show *), Bash(git status *), Bash(git grep *), Bash(git rev-parse *), Bash(git merge-base *), Bash(rg *)
----
-Review $ARGUMENTS. Interpret in this order:
-1. **Empty** → staged diff (`git diff --staged`); if empty, working-tree diff
-   (`git diff`).
-2. **A range** like `main..HEAD` or `origin/main...HEAD` → `git diff <range>`.
-3. **A single ref** (branch / tag / SHA — confirm with `git rev-parse
-   --verify`) → diff that ref's merge-base against `HEAD` (i.e. everything on
-   the current branch since it diverged: `git diff $(git merge-base <ref>
-   HEAD)..HEAD`). This is the common "review my branch before merging" path.
-4. **A file or directory path** → that target.
-5. Otherwise → ask.
-
-The diff is the subject; widen to surrounding code only as needed to judge a
-hunk. For multi-commit ranges, also skim `git log <range>` to understand
-intent before judging.
-
-## Check For
-- **Bugs needing a fix.** Logic errors, off-by-one, null/undefined paths,
-  races, wrong defaults, broken edge cases. Concrete failure modes only — not
-  vibes.
-- **Dead code.** Unreferenced functions / vars / imports / params, unreachable
-  branches, commented-out blocks, legacy paths the diff just obsoleted.
-  `git grep` the symbol before flagging — easy to be wrong.
-- **Loose ends.** TODO / FIXME / XXX added by this diff, half-finished
-  branches, silently swallowed errors, stub bodies, mocked-out paths,
-  "temporary" names, abandoned feature flags.
-- **Correctness.** Edge cases, error handling, type / contract violations,
-  broken invariants.
-- **Security.** OWASP Top 10, auth, data exposure. (`/security` for depth.)
-- **Performance.** N+1, blocking calls in hot paths, unbounded loops, indexes
-  the diff actually touches.
-- **Maintainability.** Complexity, naming, duplication — only when material.
-
-## Output Format
-### 🚨 Critical (blocks merge)
-### ⚠️ Warnings (should fix)
-### 💡 Suggestions (nice to have)
-
-Each finding: **Location** (`file:line`), **What's wrong**, **Why it matters**,
-**Concrete fix** — not "consider improving".
-
-## After the review — verify, then fix
-
-Findings are claims, not facts. Validate before acting; validate again after.
-
-**Verify each claim.** Re-read the cited `file:line` in context. For
-dead-code or unused-symbol claims, `git grep` the name across the repo before
-trusting it. Mark each **confirmed**, **false positive** (with reason), or
-**uncertain**.
-
-**Fix what's confirmed and unambiguous** — minimal shape, one obvious way, no
-change to a public API / response / caller contract. Apply directly. After
-each edit, re-read the changed region and confirm it does what you intended
-without breaking nearby logic. A fix isn't done until you've grounded it the
-same way you grounded the claim.
-
-**Stop and ask** when any of these hold (HITL gates — not all the time, only
-here):
-- the finding is **uncertain** after grounding,
-- the fix has **multiple reasonable shapes** (e.g. delete-vs-keep-behind-flag,
-  extract-vs-inline, patch-vs-rewrite) — present options with tradeoffs, not a
-  chosen path,
-- it **affects downstream** (signatures, response shape, schema, any caller
-  contract) or removes a public/exported symbol, or
-- the "dead code" looks intentionally kept (stub for upcoming work, framework
-  hook, documented extension point) — confirm before deleting.
-
-Final report: **confirmed-and-fixed** · **confirmed-but-asking** (why +
-options) · **false-positive** (why) · **uncertain** (what's needed to decide).
-
-End with a one-line verdict: **Ready to merge? Yes / No / With fixes** — and
-the reason in a sentence.

package/packages/claude/commands/diff-review.md

@@ -1,78 +0,0 @@
----
-name: diff-review
-description: Review diff [file, branch, or range]
-usage: /diff-review
-argument-hint: [file, branch (e.g. main), range (main..HEAD), or empty]
-allowed-tools: Read, Edit, Grep, Glob, Bash(git diff:*), Bash(git log:*), Bash(git show:*), Bash(git status:*), Bash(git grep:*), Bash(git rev-parse:*), Bash(git merge-base:*), Bash(rg:*)
----
-Review $ARGUMENTS. Interpret in this order:
-1. **Empty** → staged diff (`git diff --staged`); if empty, working-tree diff
-   (`git diff`).
-2. **A range** like `main..HEAD` or `origin/main...HEAD` → `git diff <range>`.
-3. **A single ref** (branch / tag / SHA — confirm with `git rev-parse
-   --verify`) → diff that ref's merge-base against `HEAD` (i.e. everything on
-   the current branch since it diverged: `git diff $(git merge-base <ref>
-   HEAD)..HEAD`). This is the common "review my branch before merging" path.
-4. **A file or directory path** → that target.
-5. Otherwise → ask.
-
-The diff is the subject; widen to surrounding code only as needed to judge a
-hunk. For multi-commit ranges, also skim `git log <range>` to understand
-intent before judging.
-
-## Check For
-- **Bugs needing a fix.** Logic errors, off-by-one, null/undefined paths,
-  races, wrong defaults, broken edge cases. Concrete failure modes only — not
-  vibes.
-- **Dead code.** Unreferenced functions / vars / imports / params, unreachable
-  branches, commented-out blocks, legacy paths the diff just obsoleted.
-  `git grep` the symbol before flagging — easy to be wrong.
-- **Loose ends.** TODO / FIXME / XXX added by this diff, half-finished
-  branches, silently swallowed errors, stub bodies, mocked-out paths,
-  "temporary" names, abandoned feature flags.
-- **Correctness.** Edge cases, error handling, type / contract violations,
-  broken invariants.
-- **Security.** OWASP Top 10, auth, data exposure. (`/security` for depth.)
-- **Performance.** N+1, blocking calls in hot paths, unbounded loops, indexes
-  the diff actually touches.
-- **Maintainability.** Complexity, naming, duplication — only when material.
-
-## Output Format
-### 🚨 Critical (blocks merge)
-### ⚠️ Warnings (should fix)
-### 💡 Suggestions (nice to have)
-
-Each finding: **Location** (`file:line`), **What's wrong**, **Why it matters**,
-**Concrete fix** — not "consider improving".
-
-## After the review — verify, then fix
-
-Findings are claims, not facts. Validate before acting; validate again after.
-
-**Verify each claim.** Re-read the cited `file:line` in context. For
-dead-code or unused-symbol claims, `git grep` the name across the repo before
-trusting it. Mark each **confirmed**, **false positive** (with reason), or
-**uncertain**.
-
-**Fix what's confirmed and unambiguous** — minimal shape, one obvious way, no
-change to a public API / response / caller contract. Apply directly. After
-each edit, re-read the changed region and confirm it does what you intended
-without breaking nearby logic. A fix isn't done until you've grounded it the
-same way you grounded the claim.
-
-**Stop and ask** when any of these hold (HITL gates — not all the time, only
-here):
-- the finding is **uncertain** after grounding,
-- the fix has **multiple reasonable shapes** (e.g. delete-vs-keep-behind-flag,
-  extract-vs-inline, patch-vs-rewrite) — present options with tradeoffs, not a
-  chosen path,
-- it **affects downstream** (signatures, response shape, schema, any caller
-  contract) or removes a public/exported symbol, or
-- the "dead code" looks intentionally kept (stub for upcoming work, framework
-  hook, documented extension point) — confirm before deleting.
-
-Final report: **confirmed-and-fixed** · **confirmed-but-asking** (why +
-options) · **false-positive** (why) · **uncertain** (what's needed to decide).
-
-End with a one-line verdict: **Ready to merge? Yes / No / With fixes** — and
-the reason in a sentence.

package/packages/droid/commands/diff-review.md

@@ -1,78 +0,0 @@
----
-name: diff-review
-description: Review diff [file, branch, or range]
-usage: /diff-review
-argument-hint: [file, branch (e.g. main), range (main..HEAD), or empty]
-allowed-tools: Read, Edit, Grep, Glob, Bash(git diff *), Bash(git log *), Bash(git show *), Bash(git status *), Bash(git grep *), Bash(git rev-parse *), Bash(git merge-base *), Bash(rg *)
----
-Review $ARGUMENTS. Interpret in this order:
-1. **Empty** → staged diff (`git diff --staged`); if empty, working-tree diff
-   (`git diff`).
-2. **A range** like `main..HEAD` or `origin/main...HEAD` → `git diff <range>`.
-3. **A single ref** (branch / tag / SHA — confirm with `git rev-parse
-   --verify`) → diff that ref's merge-base against `HEAD` (i.e. everything on
-   the current branch since it diverged: `git diff $(git merge-base <ref>
-   HEAD)..HEAD`). This is the common "review my branch before merging" path.
-4. **A file or directory path** → that target.
-5. Otherwise → ask.
-
-The diff is the subject; widen to surrounding code only as needed to judge a
-hunk. For multi-commit ranges, also skim `git log <range>` to understand
-intent before judging.
-
-## Check For
-- **Bugs needing a fix.** Logic errors, off-by-one, null/undefined paths,
-  races, wrong defaults, broken edge cases. Concrete failure modes only — not
-  vibes.
-- **Dead code.** Unreferenced functions / vars / imports / params, unreachable
-  branches, commented-out blocks, legacy paths the diff just obsoleted.
-  `git grep` the symbol before flagging — easy to be wrong.
-- **Loose ends.** TODO / FIXME / XXX added by this diff, half-finished
-  branches, silently swallowed errors, stub bodies, mocked-out paths,
-  "temporary" names, abandoned feature flags.
-- **Correctness.** Edge cases, error handling, type / contract violations,
-  broken invariants.
-- **Security.** OWASP Top 10, auth, data exposure. (`/security` for depth.)
-- **Performance.** N+1, blocking calls in hot paths, unbounded loops, indexes
-  the diff actually touches.
-- **Maintainability.** Complexity, naming, duplication — only when material.
-
-## Output Format
-### 🚨 Critical (blocks merge)
-### ⚠️ Warnings (should fix)
-### 💡 Suggestions (nice to have)
-
-Each finding: **Location** (`file:line`), **What's wrong**, **Why it matters**,
-**Concrete fix** — not "consider improving".
-
-## After the review — verify, then fix
-
-Findings are claims, not facts. Validate before acting; validate again after.
-
-**Verify each claim.** Re-read the cited `file:line` in context. For
-dead-code or unused-symbol claims, `git grep` the name across the repo before
-trusting it. Mark each **confirmed**, **false positive** (with reason), or
-**uncertain**.
-
-**Fix what's confirmed and unambiguous** — minimal shape, one obvious way, no
-change to a public API / response / caller contract. Apply directly. After
-each edit, re-read the changed region and confirm it does what you intended
-without breaking nearby logic. A fix isn't done until you've grounded it the
-same way you grounded the claim.
-
-**Stop and ask** when any of these hold (HITL gates — not all the time, only
-here):
-- the finding is **uncertain** after grounding,
-- the fix has **multiple reasonable shapes** (e.g. delete-vs-keep-behind-flag,
-  extract-vs-inline, patch-vs-rewrite) — present options with tradeoffs, not a
-  chosen path,
-- it **affects downstream** (signatures, response shape, schema, any caller
-  contract) or removes a public/exported symbol, or
-- the "dead code" looks intentionally kept (stub for upcoming work, framework
-  hook, documented extension point) — confirm before deleting.
-
-Final report: **confirmed-and-fixed** · **confirmed-but-asking** (why +
-options) · **false-positive** (why) · **uncertain** (what's needed to decide).
-
-End with a one-line verdict: **Ready to merge? Yes / No / With fixes** — and
-the reason in a sentence.

package/packages/opencode/command/diff-review.md

@@ -1,78 +0,0 @@
----
-name: diff-review
-description: Review diff [file, branch, or range]
-usage: /diff-review
-argument-hint: [file, branch (e.g. main), range (main..HEAD), or empty]
-allowed-tools: Read, Edit, Grep, Glob, Bash(git diff *), Bash(git log *), Bash(git show *), Bash(git status *), Bash(git grep *), Bash(git rev-parse *), Bash(git merge-base *), Bash(rg *)
----
-Review $ARGUMENTS. Interpret in this order:
-1. **Empty** → staged diff (`git diff --staged`); if empty, working-tree diff
-   (`git diff`).
-2. **A range** like `main..HEAD` or `origin/main...HEAD` → `git diff <range>`.
-3. **A single ref** (branch / tag / SHA — confirm with `git rev-parse
-   --verify`) → diff that ref's merge-base against `HEAD` (i.e. everything on
-   the current branch since it diverged: `git diff $(git merge-base <ref>
-   HEAD)..HEAD`). This is the common "review my branch before merging" path.
-4. **A file or directory path** → that target.
-5. Otherwise → ask.
-
-The diff is the subject; widen to surrounding code only as needed to judge a
-hunk. For multi-commit ranges, also skim `git log <range>` to understand
-intent before judging.
-
-## Check For
-- **Bugs needing a fix.** Logic errors, off-by-one, null/undefined paths,
-  races, wrong defaults, broken edge cases. Concrete failure modes only — not
-  vibes.
-- **Dead code.** Unreferenced functions / vars / imports / params, unreachable
-  branches, commented-out blocks, legacy paths the diff just obsoleted.
-  `git grep` the symbol before flagging — easy to be wrong.
-- **Loose ends.** TODO / FIXME / XXX added by this diff, half-finished
-  branches, silently swallowed errors, stub bodies, mocked-out paths,
-  "temporary" names, abandoned feature flags.
-- **Correctness.** Edge cases, error handling, type / contract violations,
-  broken invariants.
-- **Security.** OWASP Top 10, auth, data exposure. (`/security` for depth.)
-- **Performance.** N+1, blocking calls in hot paths, unbounded loops, indexes
-  the diff actually touches.
-- **Maintainability.** Complexity, naming, duplication — only when material.
-
-## Output Format
-### 🚨 Critical (blocks merge)
-### ⚠️ Warnings (should fix)
-### 💡 Suggestions (nice to have)
-
-Each finding: **Location** (`file:line`), **What's wrong**, **Why it matters**,
-**Concrete fix** — not "consider improving".
-
-## After the review — verify, then fix
-
-Findings are claims, not facts. Validate before acting; validate again after.
-
-**Verify each claim.** Re-read the cited `file:line` in context. For
-dead-code or unused-symbol claims, `git grep` the name across the repo before
-trusting it. Mark each **confirmed**, **false positive** (with reason), or
-**uncertain**.
-
-**Fix what's confirmed and unambiguous** — minimal shape, one obvious way, no
-change to a public API / response / caller contract. Apply directly. After
-each edit, re-read the changed region and confirm it does what you intended
-without breaking nearby logic. A fix isn't done until you've grounded it the
-same way you grounded the claim.
-
-**Stop and ask** when any of these hold (HITL gates — not all the time, only
-here):
-- the finding is **uncertain** after grounding,
-- the fix has **multiple reasonable shapes** (e.g. delete-vs-keep-behind-flag,
-  extract-vs-inline, patch-vs-rewrite) — present options with tradeoffs, not a
-  chosen path,
-- it **affects downstream** (signatures, response shape, schema, any caller
-  contract) or removes a public/exported symbol, or
-- the "dead code" looks intentionally kept (stub for upcoming work, framework
-  hook, documented extension point) — confirm before deleting.
-
-Final report: **confirmed-and-fixed** · **confirmed-but-asking** (why +
-options) · **false-positive** (why) · **uncertain** (what's needed to decide).
-
-End with a one-line verdict: **Ready to merge? Yes / No / With fixes** — and
-the reason in a sentence.