wade-cli 1.2.1__tar.gz → 1.2.3__tar.gz

{wade_cli-1.2.1 → wade_cli-1.2.3}/.gitignore

@@ -44,8 +44,7 @@ PR-SUMMARY.md
 .DS_Store
 Thumbs.db
 
-# uv
-uv.lock
+# uv.lock is tracked for the published Crossby contract (#511).
 
 # Local archive (pre-reset export)
 archive/

{wade_cli-1.2.1 → wade_cli-1.2.3}/AGENTS.md

@@ -92,6 +92,12 @@ No circular dependencies. Models are pure data. Services orchestrate. **Never im
 
 AI tool adapters are not part of this repo — they live in the external [`crossby`](https://github.com/ivanviragine/crossby) package (`pyproject.toml`). See `docs/dev/architecture.md` for what moved there.
 
+Native planning uses Crossby's public collected-session/preflight API, not the
+ordinary launch/autonomy path. WADE owns bundle import, parent review/validation,
+knowledge handoff and task persistence; native protocols and command-policy
+translation stay upstream. Update the tracked `uv.lock` and Crossby contract
+tripwire alongside a dependency adoption. Native plans are not transcripts.
+
 CLI modules are thin dispatch — they parse flags via Typer, then call service methods. Business logic lives in `services/`, not in `cli/`.
 
 > Full package structure, command dispatch, config system, and subsystem details: see `docs/dev/architecture.md`

{wade_cli-1.2.1 → wade_cli-1.2.3}/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Conventional Commits](https://conventionalcommits.org/).
 
+## [v1.2.3] — 2026-09-15
+
+### Bug Fixes
+
+- integrate Crossby native planning sessions (#512) (c58ea77)
+
+## [v1.2.2] — 2026-09-09
+
+### Bug Fixes
+
+- keep retained effort editable in PR-comment retry sessions (#507) (8daabc8)
+
 ## [v1.2.1] — 2026-09-08
 
 ### Chores
@@ -200,13 +212,6 @@ The format is based on [Conventional Commits](https://conventionalcommits.org/).
 ### Bug Fixes
 
 - propagate Codex worktree launch context through sessions (#429) (032daa2)
-- resolve branch by issue number so retitled issues resume their PR/plan (#428) (c840b5e)
-
-## [v0.46.0] — 2026-08-16
-
-### Bug Fixes
-
-- propagate Codex worktree launch context through sessions (3967453)
 
 ## [v0.45.10] — 2026-08-16
 
@@ -298,12 +303,6 @@ The format is based on [Conventional Commits](https://conventionalcommits.org/).
 
 - make WADE session output report-by-exception (terse on success) (#402) (9f96c94)
 
-## [v0.43.1] — 2026-08-12
-
-### Bug Fixes
-
-- surface stale base loudly and reconcile migration collisions at catchup (68150ef)
-
 ## [v0.43.0] — 2026-08-11
 
 ### Features
@@ -455,16 +454,6 @@ The format is based on [Conventional Commits](https://conventionalcommits.org/).
 
 - bump crossby to v0.11.0 and adopt newer models (Opus 5) (#345) (d9ac8a5)
 
-## [v0.35.2] — 2026-07-24
-
-### Bug Fixes
-
-- exclude scaffold-branch commits from generated changelog (c40a9ca)
-
-### Chores
-
-- bump crossby to v0.11.0 and adopt newer models (Opus 5) (ff0ab48)
-
 ## [v0.35.1] — 2026-07-24
 
 ### Bug Fixes

{wade_cli-1.2.1 → wade_cli-1.2.3}/CONTRIBUTING.md

@@ -17,6 +17,10 @@ cd wade
 uv pip install -e ".[dev]"
 ```
 
+`uv.lock` is tracked for reproducible dependency validation. When adopting a
+Crossby release, update the declaration, lockfile and contract tripwire together;
+use `uv sync --all-extras` to verify the installed release without a local override.
+
 ## Running Checks
 
 > Always use the scripts — never invoke `pytest`, `mypy`, or `ruff` directly.
@@ -28,7 +32,7 @@ uv pip install -e ".[dev]"
 | `./scripts/check.sh` | Lint + type-check |
 | `./scripts/check.sh --lint` | Lint only |
 | `./scripts/check.sh --types` | mypy strict only |
-| `./scripts/fmt.sh` | Auto-format in-place |
+| `./scripts/fmt.sh [paths...]` | Auto-format selected paths (default: `src/`) |
 | `./scripts/check-all.sh` | Full suite (tests + lint + types) |
 
 ## Architecture

{wade_cli-1.2.1 → wade_cli-1.2.3}/KNOWLEDGE.ratings.jsonl

@@ -178,3 +178,15 @@
 {"dir": "stale", "event_id": "5fd6f7c8f26544249827eacae223694a", "id": "4d5fa933ffe6", "ts": "2026-09-08T18:20:11.796646+00:00"}
 {"dir": "stale", "event_id": "e4417aa5f0064b3f9c7e47f3fdae4ffe", "id": "8a9bfc96", "ts": "2026-09-08T19:15:19.450727+00:00"}
 {"dir": "stale", "event_id": "647e662229b04eb19f5a337d2c0a1d27", "id": "4d419ec6629c", "ts": "2026-09-08T19:15:19.602521+00:00"}
+{"dir": "stale", "event_id": "d8b30c93957946b087bc118cf807859d", "id": "9f5e5e2c", "ts": "2026-09-15T12:40:24.351399+00:00"}
+{"dir": "stale", "event_id": "23483fb102fb45a2bf60fbcb862110bd", "id": "2112b028ab73", "ts": "2026-09-15T12:40:24.525550+00:00"}
+{"dir": "stale", "event_id": "857f1e42499144c5a2b7a7c44a277de9", "id": "c55057c13ebb", "ts": "2026-09-15T12:40:24.692975+00:00"}
+{"dir": "up", "event_id": "79659f3434bd4bc8bf0e1dae2deae918", "id": "cb42b47b0a78", "ts": "2026-09-15T12:40:24.859865+00:00"}
+{"dir": "up", "event_id": "d41302d8d7844cc1bf6008fb9e6b1b81", "id": "8ee8260b", "ts": "2026-09-15T12:40:25.034740+00:00"}
+{"dir": "up", "event_id": "56ccbf428f61455292ebe28e7f6a5884", "id": "d7e3010043a2", "ts": "2026-09-15T12:40:25.199085+00:00"}
+{"dir": "up", "event_id": "613813c3b5e24b75ab9b5296a35ada5f", "id": "9eacd93219c1", "ts": "2026-09-15T12:40:25.361743+00:00"}
+{"dir": "up", "event_id": "d0fbb52cfa63456d81d455a83b7d0288", "id": "9f5e5e2c", "ts": "2026-09-15T15:24:18.473921+00:00"}
+{"dir": "up", "event_id": "4cc96512911d4170b894daf7e3b8ffae", "id": "97d81e85", "ts": "2026-09-15T15:24:18.626569+00:00"}
+{"dir": "up", "event_id": "66056751a7824f6bb780f4974e2e2d7d", "id": "b08abb58", "ts": "2026-09-15T15:24:18.781881+00:00"}
+{"dir": "up", "event_id": "86b45a2f2bf74f0c8736e3ce9c7a7642", "id": "40a26d7cfd61", "ts": "2026-09-15T15:24:18.938217+00:00"}
+{"dir": "stale", "event_id": "86da7ec333234953869f880b857ce682", "id": "6cd9b543", "ts": "2026-09-15T15:24:19.088735+00:00"}

{wade_cli-1.2.1 → wade_cli-1.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: wade-cli
-Version: 1.2.1
+Version: 1.2.3
 Summary: WADE — Workflow for AI-Driven Engineering
 Project-URL: Homepage, https://github.com/ivanviragine/wade
 Project-URL: Repository, https://github.com/ivanviragine/wade
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Version Control :: Git
 Requires-Python: >=3.11
-Requires-Dist: crossby<0.30.0,>=0.29.0
+Requires-Dist: crossby<0.33.0,>=0.32.0
 Requires-Dist: httpx<1.0,>=0.27
 Requires-Dist: pydantic-settings>=2.0
 Requires-Dist: pydantic>=2.0
@@ -209,8 +209,8 @@ wade plan ─▶ tasks + draft PRs ─▶ wade <N> ─▶ AI implements in an is
   `wade review pr-comments <N>`, and `wade cd <N>`.
 - **The AI runs** the session commands that enforce the workflow and open/update
   the PR: `wade implementation-session {check,sync,done}`,
-  `wade review-pr-comments-session {check,sync,done,fetch,resolve}`, and
-  `wade plan-session done`.
+  `wade review-pr-comments-session {check,sync,done,fetch,resolve}`. Native
+  planning returns an artifact; the parent runs its review and validation gates.
 
 ## Commands
 
@@ -273,19 +273,58 @@ These are invoked by the AI during a session — you normally don't run them by
 | `wade review-pr-comments-session fetch <N>` | Fetch unresolved PR review comments as markdown |
 | `wade review-pr-comments-session resolve <thread>` | Mark a PR review thread as resolved on GitHub |
 | `wade plan-session check` | Verify detached planning capabilities before writing plan artefacts or knowledge votes |
-| `wade plan-session done <plan_dir>` | Finalize a planning session |
+| `wade plan-session done <plan_dir>` | Validate materialized plans (not native collection or task persistence) |
 | `wade deps-session check` | Verify the detached dependency-analysis runtime before writing output or staging a knowledge vote |
 
 Most workflow commands accept `--ai <tool>`, `--model <model>`, `--effort <level>`, `--permission-mode <tier>`, and `--yolo` to override configured defaults. `review pr-comments` additionally accepts `--effort none` to pin the tool default instead of a configured effort across a later wait/relaunch. `plan`, `implement`, and `review pr-comments` accept repeatable `--skill` and `--review-skill` methodology bindings plus `--refresh-skills` for an existing frozen session; `implement-batch` forwards the same binding request to every child session. Standalone plan/code/batch review and `task deps` accept repeatable `--skill`. `plan`, `implement`, `implement-batch`, standalone reviews (`review plan`, `review implementation`, `review batch`), `review pr-comments`, `task deps`, and the `wade <N>` shorthand also accept `--sandbox` / `--no-sandbox` (see [AI runtime sandbox profile](#ai-runtime-sandbox-profile)); batch and shorthand forward an explicit flag to the child session they launch. `implement` additionally supports `--detach` (new terminal tab), `--cd` (print worktree path only), and `--base <branch>` (see [Planning & base branches](#planning--base-branches)).
 
 ## Planning & base branches
 
-`wade plan` runs an AI planning session and then, from the validated plan files
-it produces, creates a lightweight task plus a draft PR for each one (labeled by
-complexity). Plan files are **strictly validated** before they become tasks — a
-`PLAN*.md` missing a valid `## Complexity` or a conventional-commit title is
-dropped with a loud error rather than silently becoming a task with no complexity
-label.
+`wade plan` enters the selected tool's **native Plan mode before the first task
+turn**. Crossby collects one authoritative Markdown artifact; WADE imports its
+plans, runs the fixed review and strict validation, then creates a lightweight
+task plus a draft PR per accepted plan. It never substitutes `/plan`, an editing
+session, or a hook for native activation.
+
+One task can be plain Markdown (`# feat: title`, `## Complexity`, tasks and
+acceptance criteria). Multiple tasks use the explicit versioned
+[plan bundle contract](templates/workflows/reference/plan-output-contract.md),
+with filenames and `depends_on` relationships; headings do not imply task
+boundaries. Knowledge-enabled sessions also use the bundle to return ratings.
+The parent runs the frozen plan-review method; prompt-mode review needs actual
+self-review and explicit acknowledgement, so it cannot complete noninteractively.
+Review failures preserve output instead of creating tasks.
+
+Planning has independent `--sandbox` / `--no-sandbox`,
+`--network-access` / `--no-network-access`,
+`--approval-policy on-request|untrusted|never`, repeatable `--trusted-dir`, and
+`--timeout` (1–3600 seconds; default 600, or `ai.plan.timeout`) requirements.
+Unset sandbox uses the collector's safe default; explicit confinement requires
+public support and tool-managed behavior is not a confinement guarantee.
+Unsupported policies, model/effort combinations, or `ai.plan.mode` transport
+overrides fail clearly. `--yolo` affects only WADE's post-plan confirmations;
+`auto` and `accept-edits` are rejected. The separate implementation offer still
+requires explicit confirmation.
+
+Omitting the network flag adds no network grant; it does not promise isolation
+for an unrestricted or tool-managed runtime. Explicit `--no-network-access`
+requires supported sandbox network control (and is rejected with `--no-sandbox`
+in the adopted contract). WADE never drops that explicit restriction to enable
+a collector.
+
+Eligibility follows Crossby's complete-session metadata and bounded version
+preflight after final tool selection, before worktree/provider mutations.
+With the adopted release, Claude (attached terminal), Codex, and OpenCode support
+WADE's required command policy. Cursor and Antigravity CLI are rejected until
+their collectors support that policy; Copilot lacks native-question collection,
+and GUI launchers are unsupported. This is not a permanent tool allowlist.
+Authentication, model availability, protocol negotiation, and artifacts are
+checked at runtime; static preflight does not promise them. Unavailable input
+never supplies a native answer or permission grant.
+
+Session IDs and exact native provenance are retained. The collection API does
+not provide a full transcript or token usage; WADE reports them unavailable,
+without substituting the plan text or fabricated usage totals.
 
 `wade plan --issue <N>` re-plans an existing task. If the session produces a
 single plan file, it's attached to `#N` and the task stays open. If the
@@ -296,8 +335,6 @@ per plan file, a comment and a `> **Superseded by ...**` banner are added to
 `--yolo`/non-interactive). If any plan file fails to become a task, `#N` is
 left open with a warning instead of superseding on a partial split.
 
-Antigravity CLI (`agy`) planning sessions launch in normal file-writing mode within a guarded git planning worktree rather than `agy`'s native `--mode plan` (which sandboxes writes to its own per-conversation artifact store outside the worktree). WADE's plan-artifact guard strictly confines writes to `.wade/plans/` and scratch paths, preserving planning safety while generating real plan files. Antigravity CLI planning therefore requires a guarded git planning worktree.
-
 ### Base branch
 
 By default WADE branches from and merges into the project's configured main branch (`project.main_branch` in `.wade.yml`, falling back to the repo's detected default). To target a different branch — e.g. `develop` or a `release/*` branch — declare it once, at planning time, in an optional `## Base Branch` section of the plan file:
@@ -497,16 +534,17 @@ enough to pick up improvements, with no re-init or migration.
 | Worktree containment | Writes that land outside your worktree |
 | Plan-artifact | During `wade plan`, writes to anything but plan artifacts |
 | Session completion | Finishing an implement/review session with unfinished work not yet run through `done` (nudges once) |
-| Plan completion | Finishing a `wade plan` session that produced no valid `PLAN*.md` yet (nudges once) |
+| Native plan completion (parent gate) | Creating tasks before authoritative import, review, and strict plan validation |
 
 The session-completion guard keys on the same fact `done` records — a sha-keyed
 `.wade/done@<HEAD>` marker written when `done`'s gates pass — so it nudges only
 when the branch has commits ahead of its base **and** `done` has not finalized
 the current commit. An early "stopping to ask a question" turn (no commits ahead)
-never triggers it. The plan-completion guard is the planning counterpart: it
-nudges once if a plan session is about to end with no valid plan file (a title
-with a conventional-commit prefix plus a `## Complexity`). Both fail **open** — a
-session is never trapped.
+never triggers it. This Stop nudge fails **open**. Native planning does not
+install the old file-based Stop nudge: canonical files exist only after the
+collector returns. Required review and validation now run in the parent.
+Native transports may exclude ambient tool settings/hooks to preserve command
+policy; hooks are defense in depth, not a native collection guarantee.
 
 Independently of that nudge, `wade plan` now **strictly validates** plan files
 before creating tasks: a `PLAN*.md` missing a valid `## Complexity` or a
@@ -530,8 +568,8 @@ the label never fails task creation, and a body with no `## Complexity` section
 just skips it. An explicit `--label complexity:X` takes precedence over the body
 value, so the task never ends up with two conflicting complexity labels.
 
-If some files pass and others fail, an interactive run asks whether to continue
-with the valid ones; `--yolo` and non-interactive runs continue without asking.
+If some files pass and others fail, a human must explicitly accept a
+dependency-closed valid subset, even with `--yolo`. Noninteractive runs abort.
 If you decline, or if every plan file fails validation, no tasks are created —
 the generated `PLAN*.md` are preserved to a temp directory so you can fix the
 reported errors and re-run instead of regenerating from scratch.
@@ -652,6 +690,9 @@ Description body here. Sub-headings, code blocks, anything markdown.
 
 ### Permission modes
 
+These autonomy tiers apply to ordinary launches. Native `wade plan` is the
+exception described above: default/YOLO control the parent, never the child.
+
 `--permission-mode` sets how much autonomy the AI tool is granted — an axis
 independent of the delegation `--mode` (which controls *how* a tool is
 dispatched: prompt/interactive/headless). The tiers, most→least permissive, are
@@ -713,6 +754,9 @@ failure feedback, and any truncation is labeled.
 
 ### AI runtime sandbox profile
 
+The defaults below apply to **non-plan launches**. Native planning uses the
+independent request policies described in [Planning & base branches](#planning--base-branches).
+
 `ai.sandbox` is a single cross-tool boolean that decides whether WADE launches
 the **AI runtime** inside its own filesystem sandbox. It governs the external
 runtime boundary only — it never relaxes WADE's own guards (see below).
@@ -722,9 +766,9 @@ runtime boundary only — it never relaxes WADE's own guards (see below).
 | `sandbox: false` (**default**) | Launch the runtime unrestricted. Codex gets `--sandbox danger-full-access`, Cursor `--sandbox disabled`. Repository commands and delegated child tools keep **normal host access and credentials**. |
 | `sandbox: true` | Launch the runtime confined. Codex gets `--sandbox workspace-write`, Cursor `--sandbox enabled`. |
 
-Network access is **on in both profiles** and is no longer configurable — it is
-enabled for every WADE launch. Not every phase needs it (planning and
-dependency analysis deliberately do not), but the phases that do — `git
+Network access is **on in both non-plan profiles** and is not configurable for
+ordinary launches. Not every phase needs it (dependency analysis does not),
+but the phases that do — `git
 fetch`/`push`, `gh`, package installs — cannot work without it, and the profile
 is fixed at launch.
 

{wade_cli-1.2.1 → wade_cli-1.2.3}/README.md

@@ -173,8 +173,8 @@ wade plan ─▶ tasks + draft PRs ─▶ wade <N> ─▶ AI implements in an is
   `wade review pr-comments <N>`, and `wade cd <N>`.
 - **The AI runs** the session commands that enforce the workflow and open/update
   the PR: `wade implementation-session {check,sync,done}`,
-  `wade review-pr-comments-session {check,sync,done,fetch,resolve}`, and
-  `wade plan-session done`.
+  `wade review-pr-comments-session {check,sync,done,fetch,resolve}`. Native
+  planning returns an artifact; the parent runs its review and validation gates.
 
 ## Commands
 
@@ -237,19 +237,58 @@ These are invoked by the AI during a session — you normally don't run them by
 | `wade review-pr-comments-session fetch <N>` | Fetch unresolved PR review comments as markdown |
 | `wade review-pr-comments-session resolve <thread>` | Mark a PR review thread as resolved on GitHub |
 | `wade plan-session check` | Verify detached planning capabilities before writing plan artefacts or knowledge votes |
-| `wade plan-session done <plan_dir>` | Finalize a planning session |
+| `wade plan-session done <plan_dir>` | Validate materialized plans (not native collection or task persistence) |
 | `wade deps-session check` | Verify the detached dependency-analysis runtime before writing output or staging a knowledge vote |
 
 Most workflow commands accept `--ai <tool>`, `--model <model>`, `--effort <level>`, `--permission-mode <tier>`, and `--yolo` to override configured defaults. `review pr-comments` additionally accepts `--effort none` to pin the tool default instead of a configured effort across a later wait/relaunch. `plan`, `implement`, and `review pr-comments` accept repeatable `--skill` and `--review-skill` methodology bindings plus `--refresh-skills` for an existing frozen session; `implement-batch` forwards the same binding request to every child session. Standalone plan/code/batch review and `task deps` accept repeatable `--skill`. `plan`, `implement`, `implement-batch`, standalone reviews (`review plan`, `review implementation`, `review batch`), `review pr-comments`, `task deps`, and the `wade <N>` shorthand also accept `--sandbox` / `--no-sandbox` (see [AI runtime sandbox profile](#ai-runtime-sandbox-profile)); batch and shorthand forward an explicit flag to the child session they launch. `implement` additionally supports `--detach` (new terminal tab), `--cd` (print worktree path only), and `--base <branch>` (see [Planning & base branches](#planning--base-branches)).
 
 ## Planning & base branches
 
-`wade plan` runs an AI planning session and then, from the validated plan files
-it produces, creates a lightweight task plus a draft PR for each one (labeled by
-complexity). Plan files are **strictly validated** before they become tasks — a
-`PLAN*.md` missing a valid `## Complexity` or a conventional-commit title is
-dropped with a loud error rather than silently becoming a task with no complexity
-label.
+`wade plan` enters the selected tool's **native Plan mode before the first task
+turn**. Crossby collects one authoritative Markdown artifact; WADE imports its
+plans, runs the fixed review and strict validation, then creates a lightweight
+task plus a draft PR per accepted plan. It never substitutes `/plan`, an editing
+session, or a hook for native activation.
+
+One task can be plain Markdown (`# feat: title`, `## Complexity`, tasks and
+acceptance criteria). Multiple tasks use the explicit versioned
+[plan bundle contract](templates/workflows/reference/plan-output-contract.md),
+with filenames and `depends_on` relationships; headings do not imply task
+boundaries. Knowledge-enabled sessions also use the bundle to return ratings.
+The parent runs the frozen plan-review method; prompt-mode review needs actual
+self-review and explicit acknowledgement, so it cannot complete noninteractively.
+Review failures preserve output instead of creating tasks.
+
+Planning has independent `--sandbox` / `--no-sandbox`,
+`--network-access` / `--no-network-access`,
+`--approval-policy on-request|untrusted|never`, repeatable `--trusted-dir`, and
+`--timeout` (1–3600 seconds; default 600, or `ai.plan.timeout`) requirements.
+Unset sandbox uses the collector's safe default; explicit confinement requires
+public support and tool-managed behavior is not a confinement guarantee.
+Unsupported policies, model/effort combinations, or `ai.plan.mode` transport
+overrides fail clearly. `--yolo` affects only WADE's post-plan confirmations;
+`auto` and `accept-edits` are rejected. The separate implementation offer still
+requires explicit confirmation.
+
+Omitting the network flag adds no network grant; it does not promise isolation
+for an unrestricted or tool-managed runtime. Explicit `--no-network-access`
+requires supported sandbox network control (and is rejected with `--no-sandbox`
+in the adopted contract). WADE never drops that explicit restriction to enable
+a collector.
+
+Eligibility follows Crossby's complete-session metadata and bounded version
+preflight after final tool selection, before worktree/provider mutations.
+With the adopted release, Claude (attached terminal), Codex, and OpenCode support
+WADE's required command policy. Cursor and Antigravity CLI are rejected until
+their collectors support that policy; Copilot lacks native-question collection,
+and GUI launchers are unsupported. This is not a permanent tool allowlist.
+Authentication, model availability, protocol negotiation, and artifacts are
+checked at runtime; static preflight does not promise them. Unavailable input
+never supplies a native answer or permission grant.
+
+Session IDs and exact native provenance are retained. The collection API does
+not provide a full transcript or token usage; WADE reports them unavailable,
+without substituting the plan text or fabricated usage totals.
 
 `wade plan --issue <N>` re-plans an existing task. If the session produces a
 single plan file, it's attached to `#N` and the task stays open. If the
@@ -260,8 +299,6 @@ per plan file, a comment and a `> **Superseded by ...**` banner are added to
 `--yolo`/non-interactive). If any plan file fails to become a task, `#N` is
 left open with a warning instead of superseding on a partial split.
 
-Antigravity CLI (`agy`) planning sessions launch in normal file-writing mode within a guarded git planning worktree rather than `agy`'s native `--mode plan` (which sandboxes writes to its own per-conversation artifact store outside the worktree). WADE's plan-artifact guard strictly confines writes to `.wade/plans/` and scratch paths, preserving planning safety while generating real plan files. Antigravity CLI planning therefore requires a guarded git planning worktree.
-
 ### Base branch
 
 By default WADE branches from and merges into the project's configured main branch (`project.main_branch` in `.wade.yml`, falling back to the repo's detected default). To target a different branch — e.g. `develop` or a `release/*` branch — declare it once, at planning time, in an optional `## Base Branch` section of the plan file:
@@ -461,16 +498,17 @@ enough to pick up improvements, with no re-init or migration.
 | Worktree containment | Writes that land outside your worktree |
 | Plan-artifact | During `wade plan`, writes to anything but plan artifacts |
 | Session completion | Finishing an implement/review session with unfinished work not yet run through `done` (nudges once) |
-| Plan completion | Finishing a `wade plan` session that produced no valid `PLAN*.md` yet (nudges once) |
+| Native plan completion (parent gate) | Creating tasks before authoritative import, review, and strict plan validation |
 
 The session-completion guard keys on the same fact `done` records — a sha-keyed
 `.wade/done@<HEAD>` marker written when `done`'s gates pass — so it nudges only
 when the branch has commits ahead of its base **and** `done` has not finalized
 the current commit. An early "stopping to ask a question" turn (no commits ahead)
-never triggers it. The plan-completion guard is the planning counterpart: it
-nudges once if a plan session is about to end with no valid plan file (a title
-with a conventional-commit prefix plus a `## Complexity`). Both fail **open** — a
-session is never trapped.
+never triggers it. This Stop nudge fails **open**. Native planning does not
+install the old file-based Stop nudge: canonical files exist only after the
+collector returns. Required review and validation now run in the parent.
+Native transports may exclude ambient tool settings/hooks to preserve command
+policy; hooks are defense in depth, not a native collection guarantee.
 
 Independently of that nudge, `wade plan` now **strictly validates** plan files
 before creating tasks: a `PLAN*.md` missing a valid `## Complexity` or a
@@ -494,8 +532,8 @@ the label never fails task creation, and a body with no `## Complexity` section
 just skips it. An explicit `--label complexity:X` takes precedence over the body
 value, so the task never ends up with two conflicting complexity labels.
 
-If some files pass and others fail, an interactive run asks whether to continue
-with the valid ones; `--yolo` and non-interactive runs continue without asking.
+If some files pass and others fail, a human must explicitly accept a
+dependency-closed valid subset, even with `--yolo`. Noninteractive runs abort.
 If you decline, or if every plan file fails validation, no tasks are created —
 the generated `PLAN*.md` are preserved to a temp directory so you can fix the
 reported errors and re-run instead of regenerating from scratch.
@@ -616,6 +654,9 @@ Description body here. Sub-headings, code blocks, anything markdown.
 
 ### Permission modes
 
+These autonomy tiers apply to ordinary launches. Native `wade plan` is the
+exception described above: default/YOLO control the parent, never the child.
+
 `--permission-mode` sets how much autonomy the AI tool is granted — an axis
 independent of the delegation `--mode` (which controls *how* a tool is
 dispatched: prompt/interactive/headless). The tiers, most→least permissive, are
@@ -677,6 +718,9 @@ failure feedback, and any truncation is labeled.
 
 ### AI runtime sandbox profile
 
+The defaults below apply to **non-plan launches**. Native planning uses the
+independent request policies described in [Planning & base branches](#planning--base-branches).
+
 `ai.sandbox` is a single cross-tool boolean that decides whether WADE launches
 the **AI runtime** inside its own filesystem sandbox. It governs the external
 runtime boundary only — it never relaxes WADE's own guards (see below).
@@ -686,9 +730,9 @@ runtime boundary only — it never relaxes WADE's own guards (see below).
 | `sandbox: false` (**default**) | Launch the runtime unrestricted. Codex gets `--sandbox danger-full-access`, Cursor `--sandbox disabled`. Repository commands and delegated child tools keep **normal host access and credentials**. |
 | `sandbox: true` | Launch the runtime confined. Codex gets `--sandbox workspace-write`, Cursor `--sandbox enabled`. |
 
-Network access is **on in both profiles** and is no longer configurable — it is
-enabled for every WADE launch. Not every phase needs it (planning and
-dependency analysis deliberately do not), but the phases that do — `git
+Network access is **on in both non-plan profiles** and is not configurable for
+ordinary launches. Not every phase needs it (dependency analysis does not),
+but the phases that do — `git
 fetch`/`push`, `gh`, package installs — cannot work without it, and the profile
 is fixed at launch.