@blxzer/cursor-trellis 0.4.2 → 0.4.3

package/dist/templates/cursor/agents/cstl-research.md

@@ -68,7 +68,7 @@ Run independent searches in parallel (Glob + Grep + smart-search CLI for externa
 
 #### External search — provider relevance caveats
 
-- **Context7** and generic third-party library docs are often **irrelevant** to Trellis/Cursor platform questions. Prefer **Cursor / Cursor++ official documentation**, `docs.cursor.com`, and **local `.cstl/spec/`** before trusting Context7 hits.
+- **Context7** and generic third-party library docs are often **irrelevant** to Trellis/Cursor platform questions. Prefer **Cursor official documentation**, `docs.cursor.com`, and **local `.cstl/spec/`** before trusting Context7 hits.
 - Every smart-search result you persist must **label the provider source** (e.g. `exa`, `context7`, `cursor-docs`, `tavily`) in the research file — in frontmatter or per bullet — so downstream check/finish can audit provenance.
 - Trellis harness facts: `./.cstl/scripts/run_smart_search.py` writes manifests under `{TASK}/research/smart-search/<run-id>/`; scored pack output (when built) is `{TASK}/research/retrieval-pack-latest.json`.
 

package/dist/templates/cursor/fixtures/expected-rules.d.ts

@@ -3,7 +3,7 @@
  * Update alongside rule content changes in templates/cursor/rules/.
  */
 export interface ExpectedRule {
-    /** Filename including .mdc extension, e.g. "cstl-triage.mdc" */
+    /** Filename including .mdc extension, e.g. "cstl-bootstrap.mdc" */
     filename: string;
     /** Substrings that must appear in rule body (case-sensitive) */
     requiredSections: string[];

package/dist/templates/cursor/fixtures/expected-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expected-rules.d.ts","sourceRoot":"","sources":["../../../../src/templates/cursor/fixtures/expected-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,aAAa,EAAE,YAAY,EA8BvC,CAAC"}
+{"version":3,"file":"expected-rules.d.ts","sourceRoot":"","sources":["../../../../src/templates/cursor/fixtures/expected-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,aAAa,EAAE,YAAY,EAavC,CAAC"}

package/dist/templates/cursor/fixtures/expected-rules.js

@@ -4,32 +4,15 @@
  */
 export const expectedRules = [
     {
-        filename: "cstl-triage.mdc",
+        filename: "cstl-bootstrap.mdc",
         requiredSections: [
-            "Decision tree",
-            "Classification mark",
-            "Consent gate",
+            "Event Bridge",
+            "Capability router",
+            "external-knowledge",
+            "Optional",
+            "Native SSOT",
+            ".cstl/middleware",
         ],
-        minBytes: 500,
-    },
-    {
-        filename: "cstl-subagent-dispatch.mdc",
-        requiredSections: ["Layer 2", "generate_dispatch_prompt", "CLI"],
-        minBytes: 400,
-    },
-    {
-        filename: "retrieval-routing.mdc",
-        requiredSections: ["Prefer", "Adapt", "Own", "Native", "BYOK", "codegraph", "smart-search"],
-        minBytes: 600,
-    },
-    {
-        filename: "cstl-session-rename.mdc",
-        requiredSections: ["rename_chat", "select", "start-execution", "skip silently"],
-        minBytes: 300,
-    },
-    {
-        filename: "cstl-cursor-modes.mdc",
-        requiredSections: ["Prefer Cursor native modes", "Quick routing", "Hard boundaries", "Rollback"],
         minBytes: 400,
     },
 ];

package/dist/templates/cursor/fixtures/expected-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"expected-rules.js","sourceRoot":"","sources":["../../../../src/templates/cursor/fixtures/expected-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C;QACE,QAAQ,EAAE,iBAAiB;QAC3B,gBAAgB,EAAE;YAChB,eAAe;YACf,qBAAqB;YACrB,cAAc;SACf;QACD,QAAQ,EAAE,GAAG;KACd;IACD;QACE,QAAQ,EAAE,4BAA4B;QACtC,gBAAgB,EAAE,CAAC,SAAS,EAAE,0BAA0B,EAAE,KAAK,CAAC;QAChE,QAAQ,EAAE,GAAG;KACd;IACD;QACE,QAAQ,EAAE,uBAAuB;QACjC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC;QAC3F,QAAQ,EAAE,GAAG;KACd;IACD;QACE,QAAQ,EAAE,yBAAyB;QACnC,gBAAgB,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,CAAC;QAC/E,QAAQ,EAAE,GAAG;KACd;IACD;QACE,QAAQ,EAAE,uBAAuB;QACjC,gBAAgB,EAAE,CAAC,4BAA4B,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,CAAC;QAChG,QAAQ,EAAE,GAAG;KACd;CACF,CAAC"}
+{"version":3,"file":"expected-rules.js","sourceRoot":"","sources":["../../../../src/templates/cursor/fixtures/expected-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C;QACE,QAAQ,EAAE,oBAAoB;QAC9B,gBAAgB,EAAE;YAChB,cAAc;YACd,mBAAmB;YACnB,oBAAoB;YACpB,UAAU;YACV,aAAa;YACb,kBAAkB;SACnB;QACD,QAAQ,EAAE,GAAG;KACd;CACF,CAAC"}

package/dist/templates/cursor/hooks.json

@@ -9,6 +9,10 @@
       }
     ],
     "sessionStart": [
+      {
+        "command": "{{PYTHON_CMD}} .cursor/hooks/event-bridge.py --event sessionStart",
+        "timeout": 30
+      },
       {
         "command": "{{PYTHON_CMD}} .cursor/hooks/session-start.py",
         "timeout": 30

package/dist/templates/cursor/index.d.ts

@@ -4,7 +4,7 @@
  * Directory structure:
  *   cursor/
  *   ├── agents/        # Sub-agent definitions
- *   ├── commands/      # Cursor-only slash commands (e.g. cursor2plus-setup)
+ *   ├── commands/      # Cursor-only slash commands (optional extras)
  *   ├── rules/         # .cursor/rules/*.mdc (alwaysApply / glob-scoped rules)
  *   ├── hooks.json     # Hooks configuration
  *   └── worktrees.json # Cursor native worktree setup

package/dist/templates/cursor/index.js

@@ -4,7 +4,7 @@
  * Directory structure:
  *   cursor/
  *   ├── agents/        # Sub-agent definitions
- *   ├── commands/      # Cursor-only slash commands (e.g. cursor2plus-setup)
+ *   ├── commands/      # Cursor-only slash commands (optional extras)
  *   ├── rules/         # .cursor/rules/*.mdc (alwaysApply / glob-scoped rules)
  *   ├── hooks.json     # Hooks configuration
  *   └── worktrees.json # Cursor native worktree setup

package/dist/templates/cursor/rules/cstl-bootstrap.mdc

@@ -0,0 +1,17 @@
+---
+description: "Cursor Adapter Bootstrap — Event Bridge pointer, four retrieval intents, independent Middleware. Prefer this thin rule over adding more always-on."
+alwaysApply: true
+---
+
+# Cursor Adapter Bootstrap
+
+This is the **single thin Bootstrap** for Cursor. It points; it does not carry full Triage, Gate, smart-search, or codegraph methodology.
+
+- **Event Bridge:** Cursor hook events (`sessionStart` and others) record/dispatch through Kernel `event_bridge` extras. Unsubscribed modules must not fail the hook.
+- **Capability router:** Baseline intents are only `exact` / `semantic` / `structural` / `external`. Do not bind Agent tool names here.
+- **external-knowledge:** smart-search is an independent Middleware Provider. Probe readiness. Missing → Profile `degraded`. Tasks that do not need the capability may Close. Platform Web is a downgrade, not an equivalent.
+- **Optional code intelligence:** codegraph and fast-context stay Optional. Do not treat them as default always-on or forced install.
+- **Native SSOT:** no Cursor++ command/skill/init ask and no cstl-byok live install on this surface. Env probe fields (`TRELLIS_CURSOR_BYOK`, `~/.ccursor/routes.json`) may remain.
+- **User overlay:** project `.cstl/middleware/` Manifests. `cstl init` / `cstl update` never write, delete, or hash that directory. Protocol: `.cstl/framework/middleware-protocol.md`.
+
+This is the only default always-on rule. Do **not** add middleware-specific always-on. Methodology lives in `.cstl/workflow.md` (human overview, not runtime SSOT) and on-demand docs.

package/dist/templates/markdown/agents.md

@@ -5,7 +5,10 @@ These instructions are for AI assistants working in this project.
 
 This project is managed by cursor-trellis. The working knowledge you need lives under `.cstl/`:
 
-- `.cstl/workflow.md` — development phases, when to create tasks, skill routing
+- `.cstl/workflow.md` — human overview of phases and skill routing (not runtime SSOT). Parallel first (convention, not a CLI gate). Personal Lite: Open→Close without Parent/Git; Full Quality: `required_controls` + AC ledger + graded Check; Topology/On-demand: Rigor × Topology, `task-map` is a graph projection; Adapter/Middleware: Event Bridge + four retrieval intents + independent smart-search Provider; user overlay `.cstl/middleware/` is never touched by `cstl update`; prefer `get_context.py --mode lite` for Lite
+- `.cstl/framework/middleware-protocol.md` — Middleware Protocol v1 (one ABI; Manifest sample)
+- `.cstl/framework/upgrade.md` — terminal-user upgrade half-page
+- `.cstl/framework/release-boundary.md` — CSTL this-batch ship vs independent cstl-byok ship
 - `.cstl/spec/` — package- and layer-scoped coding guidelines (read before writing code in a given layer)
 - `.cstl/workspace/` — per-developer journals and session traces
 - `.cstl/tasks/` — active and archived tasks (PRDs, research, jsonl context)
@@ -19,21 +22,16 @@ Only a handful of Trellis entry points are meant for **manual `/` invocation**.
 - **User-invocable (manual)**: `cstl-continue`, `cstl-finish-work` (and `cstl-start` when needed).
 - **Internal auto-triggered (do NOT call manually)**: `cstl-brainstorm`, `cstl-before-dev`, `cstl-check`, `cstl-break-loop`, `cstl-update-spec`, `cstl-micro-grill`, `cstl-meta`, `cstl-spec-bootstrap`, `cstl-skill-creator`, `smart-search-cli`. These activate on their own when the workflow/skill matcher decides they fit.
 
-## Goal runtime (not a task type)
+## Skill authoring (mandatory)
 
-**Goal** here means the **CLI subsystem** `cstl goal` (preflight → accept → run / pause / status / review), not a Task Ladder type and not Parent/Child orchestration.
-
-- Prefer: `cstl goal status` / `cstl goal preflight …` in the project terminal.
-- Do **not** invent a "goal" task kind or map "use goal" onto `add-subtask` / Parent-only planning.
-- Default Cursor install has **no** `/cstl-goal` slash command (optional dogfood/extension only).
-- Task directory `handoff.md` = child integration evidence; session handoff = `/cstl-handoff` (temp file).
+When **creating** or making a **behavioral/structural** change to a Trellis bundled skill, a `blaze-skills` skill, or a harness skill, **first Read** `cstl-skill-creator` and follow its workflow + `references/review-checklist.md`. Do not hand-write around it. **Skip** for typo / pure link fixes. This skill is **internal** (not a user `/` command). **Does not apply** to Cursor product skills (e.g. `~/.cursor/skills-cursor/create-skill`). Load paths: see `.cstl/framework/internal-skills-cursor-reachability.md` (`cstl-skill-creator` row).
 
 ## Invocation map (short)
 
 | Intent | Use | Do not |
 | --- | --- | --- |
 | Session handoff | `/cstl-handoff` → report temp path | task `handoff.md`; ad-hoc workspace handoff |
-| Goal runtime | `cstl goal status\|preflight\|run\|…` | Parent/Child as "goal"; invent goal task type |
+| Durable objective | official Cursor `/goal` | restore `cstl-goal`; treat as Parent/Child or a Trellis task type |
 | User slash surface | only listed `/cstl-*` commands | assume internal skills are slash commands |
 | Internal skills (brainstorm, …) | workflow says load → Read documented path (see guides); not user slash | claim loaded with no file read |
 
@@ -44,12 +42,19 @@ Commands-only: internal skills stay **out of** the `/` palette by design; they m
 Internal auto-triggered skills are **not** shipped to `.cursor/skills/` and have **no** default slash command. When the workflow routes to one, load its body by reading a documented path — do **not** claim it is loaded without a file read.
 
 - PRD Grill / brainstorm discipline → **`Read .cstl/framework/prd-grill-frontier.md`** (SSOT: bundled `common/skills/brainstorm.md`).
+- Skill authoring (new / structural) → **must Read** bundled `cstl-skill-creator/SKILL.md` then `references/review-checklist.md` (paths in `internal-skills-cursor-reachability.md`). Not a slash command.
 - Full skill × load-channel matrix → **`Read .cstl/framework/internal-skills-cursor-reachability.md`**.
 - Dogfood-only install surfaces (never shipped by default) → **`Read .cstl/framework/dogfood-only-surfaces.md`**.
 
+## Durable objectives (official /goal)
+
+For a persistent in-session objective, use Cursor's official `/goal`. That is **not** a Trellis task type and **not** Parent/Child. Do **not** restore or invent `cstl-goal` / `cstl goal`.
+
+Default install is **Native Cursor**. CSTL does **not** embed BYOK (no install-time BYOK; an optional independent track stays outside this package).
+
 ## Web research routing (smart-search first)
 
-For **any external / current / web fact**, run **`python ./.cstl/scripts/run_smart_search.py "<question>" --intent deep-research --json`** first. That script is the **only** Trellis web-research evidence entrypoint (it shells out to the `smart-search` CLI). Do not guess paths under package source trees or sibling repos. Platform built-in web tools (Cursor `WebSearch` / `WebFetch`, or native web tools elsewhere) are **downgrade-only fallbacks**, used solely when smart-search is unavailable (`doctor` not ok, status `not_configured` / `failed`, or search timeout). Do not reach for built-in web search while smart-search is healthy. On Cursor, `smart-search-cli` is an **internal workflow skill name** only (not shipped under `.cursor/skills/`); follow `.cstl/framework/retrieval-daily-guide.md` and `.cursor/rules/retrieval-routing.mdc` for the executable contract.
+For **any external / current / web fact**, use the independent **smart-search** Provider (`smart-search` CLI when installed). Maintainer installs may still have `run_smart_search.py`; it is not Baseline. Platform built-in web tools are **downgrade-only fallbacks**. Follow `.cstl/framework/retrieval-daily-guide.md`.
 
 **External-knowledge gate:** If the answer would be wrong because the **world or a third-party API moved** and that matters → use smart-search (cheap `docs` / `broad-search` when enough; `deep-research` when multi-source). If truth lives only in this workspace → do not default to web. When unsure, prefer a cheap probe over guessing. See `.cstl/framework/retrieval-daily-guide.md` § External-knowledge gate.
 

package/dist/templates/markdown/framework/cursor-native-modes-guide.md.txt

@@ -31,7 +31,7 @@
 | **Plan** | Scope / design / tradeoffs before code | **Try `SwitchMode(plan)`**; after review, `SwitchMode(agent)` or Build; **Save to workspace** → map into task files | Keep writing `prd.md` / `design.md` / `implement.md` + `cstl-brainstorm` in Agent | Phase 1 files |
 | **Agent** | Approved build / verify | Default; `SwitchMode(agent)` when returning from Plan | — | Diff, `verify.md`, gates |
 | **Debug** | Repro / runtime / regressions | Prefer real Cursor Debug when the user/session can reach it | Evidence → `verify.md`; `cstl-break-loop` if looped | Notes / logs in `verify.md` |
-| **Multitask** | Independent Parent children post-approval | Prefer `/multitask` / Build in Parallel / Agent `Task` background workers **when useful** | Explicit `.cstl/tasks/<dir>` prompts + Parent `integrate-child` | Child `verify`/`handoff`; Parent `task-map` |
+| **Multitask** | Independent Parent children post-approval (**default** when ≥2 units, empty `depends_on`) | Prefer `/multitask` / Build in Parallel / Agent `Task` / native worktree — **not** a Trellis scheduler | Explicit `.cstl/tasks/<dir>` prompts + Parent `integrate-child`; serial needs `serial_reason` | Child `verify`/`handoff`; Parent `task-map` |
 
 ### Phase quick map
 
@@ -40,7 +40,7 @@ Triage (No Task / Micro-Grill)  → Ask surface if present; else No Task in Agen
 Phase 1                         → SwitchMode(plan) when useful; else write artifacts in Agent
 Phase 2–3                       → Agent (+ workers when contracted)
 Stuck / repeat failure          → Debug when reachable; else verify.md + break-loop
-Parent parallel children        → Multitask / Task parallel when useful; Parent integrates
+Parent parallel children        → Multitask / Task parallel **by default**; serial needs serial_reason; Parent integrates
 ```
 
 ---
@@ -67,10 +67,11 @@ Parent parallel children        → Multitask / Task parallel when useful; Paren
 
 ### Multitask ↔ Parent/Child
 
-1. Trellis remains source of truth for status, gates, integration.
-2. Prefer native parallel surfaces to support independent Children when they help isolation/throughput.
-3. Every worker prompt includes **explicit `.cstl/tasks/<dir>`** — never rely on `selected_task`.
-4. Parent alone `integrate-child`; no collision guarantee without worktrees + review.
+1. Trellis remains source of truth for status, gates, integration. This is **not** a Trellis-built parallel product — Prefer Cursor Multitask / Build in Parallel / Agent `Task` / native worktree.
+2. **Default parallel** when planning has ≥2 independent units (Parent children with empty `depends_on`, or Full Task fan-out). Lite / single-file work is not forced into parallel agents.
+3. **Serial needs a written reason** (`serial_reason`): shared write-set / HITL or reviewer gate / `depends_on` unmet / user asked serial / conflict surface cannot isolate. HITL, `start-execution --approved`, reviewer gates, and `integrate-child` stay serial even when workers run in parallel (`merge_limit: 1`).
+4. Every worker prompt includes **explicit `.cstl/tasks/<dir>`** — never rely on `selected_task`.
+5. Parent alone `integrate-child`; no collision guarantee without worktrees + review. Declare 可并行组 / 合并点 / 冲突面 on the task-map — see `.cstl/framework/parallel-first-execution.md`.
 
 ---
 
@@ -79,7 +80,7 @@ Parent parallel children        → Multitask / Task parallel when useful; Paren
 | Surface | Plan | Agent | Ask | Debug | Parallel Children |
 | --- | --- | --- | --- | --- | --- |
 | Agent `SwitchMode` | Yes → `plan` | Yes → `agent` | — | — | — |
-| Agent `Task` / Multitask | — | workers | — | — | Prefer when useful |
+| Agent `Task` / Multitask | — | workers | — | — | Prefer **by default** (serial needs `serial_reason`) |
 | User / CLI modes | Plan UI / `/plan` | default | Ask UI / `/ask` | Debug UI | `/multitask`, Build in Parallel |
 
 Details: `research/modes-callability-matrix.md`.
@@ -93,6 +94,7 @@ Details: `research/modes-callability-matrix.md`.
 - Parallel agents cannot conflict without Trellis/worktree discipline.
 - `SwitchMode` can open Ask or Debug.
 - Shipping a parallel fake Plan/Ask/Debug product, or documenting gaps as “本版本不适配”.
+- Replacing Cursor Multitask with a Trellis scheduler, queue, or new parallel CLI.
 
 ---
 
@@ -102,7 +104,7 @@ Details: `research/modes-callability-matrix.md`.
 | --- | --- | --- |
 | **Plan** | Schema or live `SwitchMode(plan)` note in verify | Prefer path documented; quiet Agent fallback if unused |
 | **Ask / Debug** | Callability matrix | Quiet spine behavior; no “不适配” section |
-| **Multitask** | Task parallel or doc contract | Explicit child paths; Parent integrates |
+| **Multitask** | Task parallel or doc contract | Explicit child paths; default parallel; serial has `serial_reason`; Parent integrates |
 | **Agent** | Session implements under contract | Artifacts on disk |
 
 ---
@@ -111,7 +113,7 @@ Details: `research/modes-callability-matrix.md`.
 
 Docs + rules only:
 
-1. Delete `.cursor/rules/cstl-cursor-modes.mdc` and `.cstl/framework/cursor-native-modes-guide.md`.
+1. Delete `.cursor/rules/cstl-cursor-modes.mdc`, `.cstl/framework/cursor-native-modes-guide.md`, and `.cstl/framework/parallel-first-execution.md`.
 2. Drop related `guides/index.md` / `workflow.md` rows, or `cstl update` from pre-P1 templates.
 3. **cursor-trellis**: revert this Child’s tip or delete mirrored template paths.
 
@@ -123,3 +125,4 @@ Docs + rules only:
 - `{TASK}/research/cursor-modes-external.md`
 - `.cursor/rules/cstl-cursor-modes.mdc`
 - `.cstl/framework/cursor-subagent-policy.md`
+- `.cstl/framework/parallel-first-execution.md`

package/dist/templates/markdown/framework/cursor-subagent-policy.md.txt

@@ -2,6 +2,8 @@
 
 > **Purpose:** Cursor-first guidance for when to spawn Trellis custom agents, which mode to use, and how model choice stays on the Cursor side.
 
+> **⚠️ Cursor++ 路线已废弃（2026-08-19 用户裁决）**：Trellis 不再为 Cursor++ / `cstl-cursor2plus-setup` / `.cstl/local/cursor2plus/` 服务。现行路径 = **Native Cursor API**。Cursor++ 产品面已从 Trellis SSOT 移除；遗留 `.cstl/local/cursor2plus/` 视为死档残渣（勿 patch）。下文 **Historical appendix** 仅保留 Method 2.5/2.6 证据摘要，**禁止当操作指南**（勿 patch、勿 Reload、勿跑 `patch_wpelc8.py`）。
+
 **Abstract policy:** `model_policy: cursor-configured` — Trellis workflow, agents, skills, and hooks **must not** hardcode vendor model IDs in **committed** defaults (`gpt-*`, `claude-*`, etc.).
 
 ---
@@ -14,13 +16,13 @@ The same `cstl-*` name can be reached via three entry points with **different mo
 How did I reach cstl-research / cstl-implement / cstl-check?
 │
 ├─ Opened a Cursor chat and @mentioned or /slash-invoked it
-│  → Agent session. Top-bar model decides. Cursor Settings for cstl-* are
-│    largely ineffective under BYOK. Do NOT expect json5 + Method 2.5 here.
+│  → Agent session. Top-bar model decides.
 │
 ├─ Main session dispatched Task(subagent_type=cstl-*)
-│  → Task dispatch. ONLY path where BYOK json5 + Method 2.5 applies.
-│    Context: CLI Layer 2 pre-embed (primary on Cursor); hook is best-effort
-│    (<!-- cstl-hook-injected --> marker; skips if already present).
+│  → Task dispatch. Native: frontmatter `model:` (Method 4) may apply.
+│    BYOK env: inherit parent unless the gateway override
+│    is configured. Context: CLI Layer 2 pre-embed (primary on Cursor);
+│    hook is best-effort (<!-- cstl-hook-injected --> marker).
 │
 └─ Used the cstl-check SKILL in main session (no subagent spawn)
    → Skill form. Main-session model. Only cstl-check has both
@@ -39,34 +41,34 @@ If unsure: Task dispatch is the path Trellis workflow routes through; Agent sess
 | Implementation (after `start-execution --approved`) | `cstl-implement`                                            | Agent                               | Code edits; no `git commit` in subagent; **CLI Layer 2** dispatch prompt on Cursor |
 | Post-implementation verification                    | `cstl-check`                                                | Agent                               | Fixes + `verify.md` / gate hints; **CLI Layer 2** on Cursor; main session records gates |
 | Parent/Child child worker                           | `generate-child-prompt --mode subagent`                        | **Parent Task** `cstl-implement` (default) | Child delivers `verify.md` + `handoff.md`; rare per-child model → **new writable Agent** session when user names that child |
-| Architecture / deep review                          | `cstl-check` or documented inline deep review               | Agent or main session               | Model via dispatch strategy (Methods 1–2.5, 3–4 below)                                               |
+| Architecture / deep review                          | `cstl-check` or documented inline deep review               | Agent or main session               | Model via dispatch strategy (Methods 1–4 below)                                               |
 | PRD Grill (planning)                                | `cstl-micro-grill` contract **inside** `cstl-brainstorm` | **Not** a subagent                  | Single-question business follow-ups only                                                     |
 | Small unclear ask (no task)                         | `cstl-micro-grill` skill                                    | Main session                        | No task artifacts by default                                                                 |
 
 ---
 
-## Model dispatch strategy (BYOK-aware)
-
-> **Model routing details:** See Method 2.5 / 2.6 below and Cursor++ provider settings (`~/.ccursor/providers.json`).
+## Model dispatch strategy (Native / BYOK env detection)
 
 ### Environment detection
 
-| Environment           | Custom Task subagent model control                                                                 | Explore subagent model control                     |
-| --------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
-| **Native Cursor API** | Frontmatter `model:` works (server-side routing)                                                   | Native model picker                                |
-| **Cursor++ BYOK**     | ❌ Frontmatter / Cursor Settings per-agent: not wired for `cstl-*`; **✅ Method 2.5** if applied | ✅ Independent model via Cursor++ panel (v0.0.11+) |
+`cursorEnv` (`native` | `byok` | `unknown`) comes from `~/.ccursor/routes.json` `byokMode` or `TRELLIS_CURSOR_BYOK`. Detection is for retrieval/model env split (`cursorEnv`) — **not** a Cursor++ install path.
 
-Under Cursor++ BYOK, **committed** agent frontmatter `model:` and **Cursor Settings** UI for `cstl-research` / `cstl-implement` / `cstl-check` do **not** populate `subagentModelOverrides` for those types (verified). Without **Method 2.5**, custom Task subagents **inherit** the parent session BYOK model.
+| Environment | Custom Task subagent model control | Explore subagent model control |
+| ----------- | ---------------------------------- | ------------------------------ |
+| **Native Cursor API** | Frontmatter `model:` works (server-side routing) | Native model picker |
+| **BYOK env (`cursorEnv=byok`)** | Inherit parent session model unless the gateway override is configured | Native / gateway picker — **not** a Cursor++ panel |
+
+Do **not** install Cursor++ or run archived `patch_wpelc8.py`. Without a gateway override, custom Task subagents **inherit** the parent session model.
 
 ### Dispatch strategy matrix
 
-| Subagent type                       | Independent model? (BYOK)            | Method                                                                  | Fallback             |
-| ----------------------------------- | ------------------------------------ | ----------------------------------------------------------------------- | -------------------- |
-| **Explore** (built-in)              | ✅ Yes                               | Cursor++ panel (built-in override row)                                  | Inherit parent model |
-| **cstl-research** (custom Task)  | ✅ Yes if **Method 2.5** map applied | **Method 2.5** (machine-local); else Method 1 or **Method 3** (manual) | Inherit parent model |
-| **cstl-implement** (custom Task) | ✅ Yes if **Method 2.5** map applied | **Method 2.5**; else Method 1 or **Method 3**                           | Inherit parent model |
-| **cstl-check** (custom Task)     | ✅ Yes if **Method 2.5** map applied | **Method 2.5**; else Method 1 or **Method 3**                           | Inherit parent model |
-| **generalPurpose** / **shell** / **best-of-n-runner** | ✅ Yes if map includes keys | **Method 2.5 / 2.6** JSON map | Inherit parent model |
+| Subagent type                       | Independent model? | Method | Fallback |
+| ----------------------------------- | ------------------ | ------ | -------- |
+| **Explore** (built-in)              | ✅ Yes (Native picker) | Method 2 | Inherit parent model |
+| **cstl-research** (custom Task)  | Native: Method 4 overlay; else inherit | Method 1 or **Method 3** (manual) | Inherit parent model |
+| **cstl-implement** (custom Task) | Native: Method 4 overlay; else inherit | Method 1 or **Method 3** | Inherit parent model |
+| **cstl-check** (custom Task)     | Native: Method 4 overlay; else inherit | Method 1 or **Method 3** | Inherit parent model |
+| **generalPurpose** / **shell** / **best-of-n-runner** | Inherit unless Native overlay | Method 1 or Method 3 | Inherit parent model |
 
 ### When to ask (and when not)
 
@@ -84,7 +86,7 @@ Task mode (Lite / Full / Parent) does **not** by itself trigger the question —
 
 ### Method 2: Explore subagent with custom model (read-only research)
 
-When research is purely **codebase exploration** (no external web search, no file writing outside exploration scope), dispatch an **Explore subagent** instead of cstl-research. The Explore type gets independent model selection via the Cursor++ panel.
+When research is purely **codebase exploration** (no external web search, no file writing outside exploration scope), dispatch an **Explore subagent** instead of cstl-research. Pick the Explore model with the **Native** model picker (or inherit).
 
 **Constraints:**
 
@@ -94,40 +96,9 @@ When research is purely **codebase exploration** (no external web search, no fil
 
 **Use when:** Pure codebase search/understanding tasks where a different model adds value. Main session receives findings and writes the research files.
 
-### Method 2.5: Cursor++ BYOK proxy map (publishable bundle)
-
-**What it is:** A reversible patch to Cursor++ `extension.js` **subagent model resolver** that maps `subagentType` → BYOK catalog **slug** (`model-xxxxx`), evaluated **before** the inherit-parent branch. Obfuscated symbol names change per build (historical `WPeLc8`; 2026-08+ profile `ZiKp4I`). Script uses multi-profile detection.
-
-**Trellis ships (every `cstl init` / `cstl update`, strategy C):** `.cstl/local/cursor2plus/` — `patch_wpelc8.py`, `README.md`, **`UPGRADE-NOTE.md`** (upgrade re-apply), `config.local.json.example`. Native Cursor API users can ignore this directory.
-
-**Operator workflow (Cursor++ BYOK only):**
-
-1. Fill **`~/.ccursor/trellis-task-models.json5`** (user-wide) with `subagent_type` → displayName/apiModel from **`~/.ccursor/providers.json`**.
-2. Optionally override per repo: **`.cstl/local/subagent-models.json5`** (project wins on same key).
-3. If paths are not auto-detected: copy `config.local.json.example` → `config.local.json`, or run `python patch_wpelc8.py --bootstrap`, or set `TRELLIS_CCURSOR_HOME` / `TRELLIS_CURSOR2PLUS_EXTENSION`.
-4. From `.cstl/local/cursor2plus/`: `python patch_wpelc8.py --check-compat` → `--print-map` → `--apply --approve` → **Developer: Reload Window**.
-5. **Verify:** A≠B probe (parent model ≠ map target) or `resolvedModelId` matches slug.
-
-**Revert:** `python patch_wpelc8.py --revert`; Reload Window.
-
-**After any Cursor / Cursor++ upgrade:** assume patch is stale — follow **`.cstl/local/cursor2plus/UPGRADE-NOTE.md`** (`--check-compat`, re-apply, or add a new resolver profile if symbols moved).
-
-**Cursor++ sidebar / Cursor Settings:** Do **not** wire `cstl-*` BYOK routing; use JSON + patch.
-
-### Method 2.6: Temporary Task types (advanced, BYOK)
-
-For rare per-dispatch models on the Task channel without changing global slots:
-
-1. Add `.cursor/agents/cstl-worker-<id>.md` (role prompt only; no committed `model:`).
-2. Add `"cstl-worker-<id>": "model-xxxxx"` to **project** `.cstl/local/subagent-models.json`.
-3. Re-run `patch_wpelc8.py`; dispatch `Task(subagent_type=cstl-worker-<id>)`.
-4. Remove agent file and JSON key when done.
-
-Parent/Child **default** does not use 2.6 — it uses `cstl-implement` from the user map. Per-child manual model → **new writable Agent** session (user-named exception).
-
 ### Method 3: Manual dispatch (different model for Task subagent)
 
-When a custom Task subagent (`cstl-research`, `cstl-implement`, `cstl-check`) needs a **different model** than the parent under BYOK **and Method 2.5 is not available**:
+When a custom Task subagent (`cstl-research`, `cstl-implement`, `cstl-check`) needs a **different model** than the parent **and** Native overlay (Method 4) is not available or not desired:
 
 1. **Main session prepares the dispatch prompt** — full text with:
    - First line: Selected task: <path> (e.g. .cstl/tasks/06-17-my-task)
@@ -168,12 +139,10 @@ Under **native Cursor API** (non-BYOK), frontmatter model: on agent files works
 
 ```text
 Subagent dispatch needed
-├─ Cursor++ BYOK + cstl-* needs fixed per-role models?
-│  └─ Method 2.5 applied on this machine? → dispatch Task normally (map handles routing)
 ├─ Parent model appropriate for cstl-*? → Method 1 (inherit)
-├─ Read-only codebase exploration only? → Method 2 (Explore + Cursor++ panel)
+├─ Read-only codebase exploration only? → Method 2 (Explore + Native picker)
 ├─ Native Cursor API (non-BYOK)? → Method 4 (ephemeral frontmatter overlay)
-└─ BYOK, no Method 2.5, different model required? → Method 3 (manual dispatch)
+└─ Different model required, overlay unavailable? → Method 3 (manual dispatch)
 ```
 
 ### Main-session contract
@@ -181,46 +150,44 @@ Subagent dispatch needed
 When a dispatch is imminent:
 
 1. Assess which method applies based on the decision flow.
-2. If **Method 2.5** is active on this machine: dispatch `cstl-research` / `cstl-implement` / `cstl-check` via Task tool as usual — **do not** ask model each time; **do not** edit agent frontmatter.
-3. If Method 1 (inherit): dispatch directly, no model question.
-4. If Method 2 (Explore): set Explore model in Cursor++ panel if needed, dispatch `explore`.
-5. If Method 3 (manual): prepare the full dispatch prompt, present to user.
-6. If Method 4 (overlay, native API): ask model preference, apply overlay, dispatch, restore.
+2. If Method 1 (inherit): dispatch directly, no model question.
+3. If Method 2 (Explore): set Explore model in the Native picker if needed, dispatch `explore`.
+4. If Method 3 (manual): prepare the full dispatch prompt, present to user.
+5. If Method 4 (overlay, native API): ask model preference, apply overlay, dispatch, restore.
 
 ### Rules
 
 - **Never** commit long-lived model: in shared Trellis templates or team repo defaults.
 - **Never** inject model IDs via hooks (inject-subagent-context.py stays task-only).
 - **Do not** attempt ephemeral model overlay under BYOK — it silently fails for routing (Method 4).
-- **Do not** rely on Cursor Settings per `cstl-*` agent for BYOK routing — use Method 2.5 map or Method 3.
-- Method 2.5 map lives **outside** committed Trellis templates (machine-local); never commit patched `extension.js` into the Trellis repo.
+- **Do not** rely on Cursor Settings per `cstl-*` agent for BYOK routing — inherit, BYOK env override, or Method 3.
+- **Do not** apply Cursor++ `extension.js` patches, `patch_wpelc8.py`, or `cstl-cursor2plus-setup`. Those paths are retired.
 - **Do not** assume Explore subagent can replace cstl-research for all scenarios — it is read-only and cannot persist files.
 - Workflow and skills **must not** hardcode vendor model IDs.
 
 ### Child worker
 
-- **Default (BYOK + map):** Parent session dispatches **Task** `cstl-implement` with prompt from `generate-child-prompt --mode subagent`; model from user/project JSON map.
+- **Default:** Parent session dispatches **Task** `cstl-implement` with prompt from `generate-child-prompt --mode subagent`; model inherits parent (Native overlay Method 4 when applicable).
 - **Exception:** User or `child-prompts.md` names a child for **separate writable Agent** → new chat, manual model, paste prompt (Method 3).
 - **Native API:** ephemeral overlay on `cstl-implement` (Method 4) still valid.
 
 ### Technical note
 
-Client layer still only builds override rows for built-in types such as `explore`. Cursor Settings entries for custom agent **names** do not reach the BYOK proxy override list for `cstl-*`. **Method 2.5** patches Cursor++ subagent model resolver (profile-bound; see `UPGRADE-NOTE.md`) so `taskToolCall` sets `resolvedModelId` from a local `subagentType → slug` table before inherit-parent. **Method 3** bypasses Task routing (user picks model in a new chat).
+Client layer still only builds override rows for built-in types such as `explore`. Cursor Settings entries for custom agent **names** do not reliably reach custom `cstl-*` Task types. **Method 3** bypasses Task routing (user picks model in a new chat). Historical Cursor++ resolver-map evidence lives in the appendix — not a current control plane.
 
 ---
 
+## Trellis workflow: using per-agent models (Native / BYOK env)
 
-## Trellis workflow: using per-agent models (BYOK + Method 2.5)
-
-Operational contract between the Trellis task ladder and Cursor++ BYOK.
+Operational contract between the Trellis task ladder and Cursor model routing.
 
 ### Roles and who picks the model
 
 | Layer | Picks model for… | Mechanism |
 | ----- | ---------------- | --------- |
-| **You (operator)** | Main orchestration chat | Cursor model picker (parent BYOK route) |
-| **You (operator)** | `cstl-research` / `cstl-implement` / `cstl-check` (+ optional built-in Task types) | **Method 2.5 / 2.6** JSON maps + `.cstl/local/cursor2plus/patch_wpelc8.py` — **not** repo agent files |
-| **You (operator)** | `explore` | Cursor++ panel |
+| **You (operator)** | Main orchestration chat | Cursor model picker |
+| **You (operator)** | `cstl-research` / `cstl-implement` / `cstl-check` | Inherit, Native Method 4 overlay, or Method 3 — **not** Cursor++ JSON/patch |
+| **You (operator)** | `explore` | Native model picker |
 | **Main Agent session** | When to spawn which agent | `workflow.md`, skills, scene matrix |
 | **Hooks** | Never | `inject-subagent-context.py` — task context only |
 
@@ -228,39 +195,32 @@ Operational contract between the Trellis task ladder and Cursor++ BYOK.
 
 1. **Select task** — `task.py select`; dispatch prompts include `Selected task: .cstl/tasks/<id>` when hooks need it.
 2. **Main session model** — your choice for planning and orchestration.
-3. **Research** — Task `subagent_type=cstl-research` → mapped research slug (Method 2.5).
-4. **Implement** — after `start-execution --approved`, Task `cstl-implement` → mapped implement slug.
-5. **Check** — Task `cstl-check` → mapped check slug.
+3. **Research** — Task `subagent_type=cstl-research` (inherit or Method 4).
+4. **Implement** — after `start-execution --approved`, Task `cstl-implement`.
+5. **Check** — Task `cstl-check`.
 6. **Gates / finish** — main session `record-gate`, `cstl-finish-work`.
 
-No model field in dispatch prompt under Method 2.5. Task `model: fast` does **not** override custom types under BYOK.
+Task `model: fast` does **not** override custom types under BYOK.
 
 ### When to use which method
 
 | Setup | Research | Implement | Check |
 | ----- | -------- | --------- | ----- |
-| Method 2.5 configured | `cstl-research` Task | `cstl-implement` Task | `cstl-check` Task |
-| No map; one parent model | Task (inherit) | Task (inherit) | Task (inherit) |
-| No map; different models | Method 3 | Method 3 | Method 3 |
+| One parent model | Task (inherit) | Task (inherit) | Task (inherit) |
+| Native; different models | Method 4 | Method 4 | Method 4 |
+| BYOK / overlay unavailable; different models | Method 3 | Method 3 | Method 3 |
 | Repo read-only only | Method 2 Explore | — | — |
 
 ### Parent/Child
 
-- **Default:** Parent dispatches **Task** `cstl-implement` (BYOK map applies to `subagentType`).
+- **Default:** Parent dispatches **Task** `cstl-implement`.
 - **Rare per-child model:** new writable Agent session when user names that child — not a separate Trellis subagent type by default.
 - Parent retains `review-child` / `integrate-child`; serial integration and worktree rules unchanged.
 
-### Maintainer checklist (BYOK)
-
-1. Resolve slugs in `~/.ccursor/providers.json` (or path in `config.local.json`).
-2. Edit user and/or project JSON maps; include `generalPurpose`, `shell`, `best-of-n-runner` if you use those Task types.
-3. Run `patch_wpelc8.py` from `.cstl/local/cursor2plus/` → Reload Window.
-4. Re-apply after Cursor / Cursor++ upgrades.
-
 ### What stays in the Trellis repo
 
 - `.cursor/agents/cstl-*.md` — no committed `model:`; link to this policy.
-- Skills/workflow — **which** agent to spawn, not BYOK slugs.
+- Skills/workflow — **which** agent to spawn, not vendor slugs.
 
 ---
 
@@ -273,13 +233,13 @@ Optional team paste (comments only — not Cursor product settings):
 
 ```yaml
 model_policy: cursor-configured
-dispatch_model: inherit_or_method25_or_manual
+dispatch_model: inherit_or_native_overlay_or_manual
 child_worker:
   mode: separate_writable_agent_session
 explore_subagent:
-  model: independent # Cursor++ panel
+  model: independent # Native picker
 trellis_task_subagents:
-  model: method_2_5_proxy_map # machine-local; not in git
+  model: inherit # Native Method 4 overlay optional; Cursor++ map retired
 ```
 
 ---
@@ -311,6 +271,7 @@ trellis_task_subagents:
 - Do not spawn `cstl-implement` from inside `cstl-implement` (recursion guard in agent defs).
 - Do not spawn a subagent for PRD Grill — use brainstorm Phase B + micro-grill contract.
 - Do not leave `model:` on agent files after dispatch (always restore).
+- Do not treat Cursor++ / `cstl-cursor2plus-setup` / Method 2.5 as a current option.
 
 ---
 
@@ -330,43 +291,18 @@ This command is **Agent-facing** — not listed in user README or slash command
 
 When `preToolUse` cannot resolve a selected task, the subagent should read **`Selected task:`** from the first line of its dispatch prompt, then load `implement.jsonl` / `check.jsonl`, `prd.md`, `design.md`, and `implement.md` manually. Trellis does **not** document or depend on Cursor `/multitask` for workflow orchestration.
 
-## Cursor++ (BYOK) compatibility
-
-[Cursor++](https://ccursor.cometix.dev) (ccursor by cometix) is a third-party Patch that intercepts Cursor API traffic via a local server (`127.0.0.1:39831`). It does **not** modify `.cursor/` files — it intercepts at the API/gRPC layer (`AgentService/RunSSE`, `AvailableModels`, etc.) and routes requests to BYOK providers.
-
-### Confirmed compatibility (v0.0.11+, Cursor 3.7.27)
-
-| Trellis component     | Status under Cursor++ | Notes                                                                               |
-| --------------------- | --------------------- | ----------------------------------------------------------------------------------- |
-| `.cursor/agents/`     | Normal                | Agent files not intercepted; `model:` frontmatter read by Cursor at spawn           |
-| `.cursor/hooks/`      | Normal                | Hook config loads; verify `hooksConfig` in agent logs when debugging                  |
-| `.cursor/mcp.json`    | Normal                | MCP servers and tools load normally                                                 |
-| SubAgent write access | **Fixed in v0.0.11**  | Prior versions defaulted SubAgent to readonly; `cstl-implement` now writes files |
-
-**Minimum version: v0.0.11.** Earlier versions break `cstl-implement` due to SubAgent readonly bug.
-
-### Model routing under BYOK (verified 2026-06-18)
-
-- **Explore subagent:** Independent model selection works via Cursor++ panel (v0.0.11+). Cursor++ intercepts and routes the selected BYOK model for Explore-type requests.
-- **Custom Task subagents:** Frontmatter `model:` and Cursor Settings per-agent names are **not** applied for `cstl-*` BYOK routing. Use **Method 2.5** or **Method 3**. **Explore** uses Cursor++ panel.
-- The `model:` ID **must match** a model configured in Cursor++ provider settings (`~/.ccursor/providers.json`). If it doesn't match, the request will fail with a provider error.
-- Cursor++ intercepts `AvailableModels`/`GetDefaultModel` - the model picker and model list are determined by BYOK provider config, not Cursor's official model catalog.
-- Under Cursor++, "inherit" means the parent session's BYOK-routed model, which may differ from what the Cursor UI label suggests.
+---
 
-### Safety boundary
+## Historical appendix — Cursor++ Method 2.5 / 2.6 (retired; not SOP)
 
-- Cursor++ patches Cursor internal modules at runtime. Strongest recovery: reinstall Cursor.
-- API keys are stored in **plaintext** in `~/.ccursor/providers.json` — restrict file permissions (`chmod 600` / Windows ACL).
-- Cursor++ stores rules in `~/.ccursor/knowledge-base.json`, independent of `.cursor/rules/` and Trellis rules.
-- Version updates lag behind Cursor releases — after a Cursor update, BYOK routing may break until Cursor++ catches up. Trellis hooks/agents/skills survive the window (they don't depend on API routing).
-- Do not mix Cursor++ BYOK sessions with Cursor official sessions — they cannot be continued across each other.
-- Cursor++ may violate Cursor ToS; use at own risk. Not recommended for enterprise/compliance environments.
+**Do not follow this appendix as an operator runbook.** It records what existed so archive evidence stays findable.
 
-### Anti-patterns for Cursor++
+- **What it was:** A reversible patch to a third-party Cursor++ `extension.js` subagent-model resolver (historical symbol `WPeLc8`, later `ZiKp4I`) mapping `subagentType` → catalog slug before inherit-parent. Operator maps lived in `~/.ccursor/trellis-task-models.json5` and project json5; apply required Reload Window.
+- **Where the dead files are:** `.cstl/local/archive/cursor2plus/`, `.cstl/local/archive/cursor2plus_bundle_src/`, archived `subagent-models.json5`. Reverse-engineering notes: `.cstl/spec/guides/cursor-subagent-reverse-engineering-report.md` (also retired).
+- **Why it is not current:** User retired Cursor++ (2026-08-19). `cstl-cursor2plus-setup` and live `.cstl/local/cursor2plus/` were removed from the Trellis SSOT (P23). Product path = Native Cursor.
+- **Do not:** run `patch_wpelc8.py`, copy archive back into `.cstl/local/cursor2plus/`, invoke `cstl init --cursor2plus`, or use a Cursor++ panel as the Trellis model control plane.
 
-- Do not use Cursor++ older than v0.0.11 with Trellis (SubAgent readonly bug).
-- Do not assume Cursor official model IDs work under BYOK — use model IDs from your provider config.
-- Do not mix Cursor++ and Cursor official sessions for the same conversation.
+---
 
 ## Worktree template
 
@@ -388,7 +324,7 @@ For multi-package workspaces, list all install commands needed after a fresh che
 
 - `.cursor/agents/cstl-research.md`, `cstl-implement.md`, `cstl-check.md`
 - `.cursor/agents/.cstl-model-overlay.local.md` — optional overlay audit stub (native API)
-- Reference `patch_wpelc8.py` in task `06-18-byok-manual-dispatch-automation/research/` — copy locally; not a runtime git dependency
+- `.cstl/local/archive/` — retired Cursor++ bundle (not a runtime dependency)
 - `.cstl/workflow.md` — Task Ladder + Parent orchestration
 - [Cursor Subagents](https://cursor.com/docs/subagents) — `model: inherit | <id>`
 - [Cursor Multitask changelog](https://cursor.com/changelog/04-24-26) — `/multitask`, Worktrees, Multi-root Workspaces