@blxzer/cursor-trellis 0.4.1 → 0.4.3

package/dist/goal/worker-prompt.d.ts

@@ -1,13 +0,0 @@
-import type { GoalState } from "./state.js";
-export interface GoalWorkerPromptContext {
-    cwd: string;
-    state: GoalState;
-    contractPath: string;
-    agentDefinitionPath: string;
-    turnIndex: number;
-}
-/**
- * Build the authoritative prompt for cstl-goal-worker (SDK / channel runner).
- */
-export declare function buildGoalWorkerPrompt(ctx: GoalWorkerPromptContext): string;
-//# sourceMappingURL=worker-prompt.d.ts.map

package/dist/goal/worker-prompt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker-prompt.d.ts","sourceRoot":"","sources":["../../src/goal/worker-prompt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,uBAAuB,GAAG,MAAM,CAqC1E"}

package/dist/goal/worker-prompt.js

@@ -1,41 +0,0 @@
-import path from "node:path";
-/**
- * Build the authoritative prompt for cstl-goal-worker (SDK / channel runner).
- */
-export function buildGoalWorkerPrompt(ctx) {
-    const absoluteContract = path.resolve(ctx.contractPath);
-    const absoluteAgent = path.resolve(ctx.agentDefinitionPath);
-    const taskDir = ctx.state.task_dir ? path.resolve(ctx.state.task_dir) : "(none)";
-    const doneWhen = ctx.state.contract?.doneWhen.map((d, i) => `${i + 1}. ${d}`).join("\n") ??
-        "(contract not loaded)";
-    const evidenceHow = ctx.state.contract?.evidenceHow ?? "(unspecified)";
-    return [
-        "## Goal binding (authoritative)",
-        `- goal_id: \`${ctx.state.goal_id}\``,
-        `- mode: \`${ctx.state.mode}\``,
-        `- contract.md (absolute): \`${absoluteContract}\``,
-        `- task_dir (absolute): \`${taskDir}\``,
-        `- worker agent definition: \`${absoluteAgent}\``,
-        `- turn: ${ctx.turnIndex}`,
-        `- worker_turns: ${ctx.state.worker_turns} / ${ctx.state.walls.workerTurnLimit}`,
-        "",
-        "## done_when",
-        doneWhen,
-        "",
-        "## evidence_how",
-        evidenceHow,
-        "",
-        "## Turn instructions",
-        "You are the cstl-goal-worker subagent (G1). Advance one concrete step toward done_when.",
-        "If you need human-reviewed action (push/merge/delete/global-config class): output a single JSON code block",
-        "matching GoalActionPacket v0 (schema_version=1, goal_id, proposed_action, action_kind, axes,",
-        "hard_deny_candidates, done_when_ref, diff_or_cmd_digest). Do NOT include secrets.",
-        "Otherwise reply with a short status: progress vs done_when, next action, blockers.",
-        "",
-        "## Forbidden",
-        "- Mid-flight human approval requests (preflight already passed).",
-        "- Force-push, commit to main/release, bypass hard deny H-1…H-6.",
-        "- Raw secrets in output.",
-    ].join("\n");
-}
-//# sourceMappingURL=worker-prompt.js.map

package/dist/goal/worker-prompt.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker-prompt.js","sourceRoot":"","sources":["../../src/goal/worker-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAY7B;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAA4B;IAChE,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACjF,MAAM,QAAQ,GACZ,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACvE,uBAAuB,CAAC;IAC1B,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,IAAI,eAAe,CAAC;IAEvE,OAAO;QACL,iCAAiC;QACjC,gBAAgB,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI;QACrC,aAAa,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI;QAC/B,+BAA+B,gBAAgB,IAAI;QACnD,4BAA4B,OAAO,IAAI;QACvC,gCAAgC,aAAa,IAAI;QACjD,WAAW,GAAG,CAAC,SAAS,EAAE;QAC1B,mBAAmB,GAAG,CAAC,KAAK,CAAC,YAAY,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,EAAE;QAChF,EAAE;QACF,cAAc;QACd,QAAQ;QACR,EAAE;QACF,iBAAiB;QACjB,WAAW;QACX,EAAE;QACF,sBAAsB;QACtB,yFAAyF;QACzF,4GAA4G;QAC5G,8FAA8F;QAC9F,mFAAmF;QACnF,oFAAoF;QACpF,EAAE;QACF,cAAc;QACd,kEAAkE;QAClE,iEAAiE;QACjE,0BAA0B;KAC3B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/goal/worker.d.ts

@@ -1,42 +0,0 @@
-import type { GoalActionPacket } from "./action-packet.js";
-import type { GoalState, GoalWorkerKind } from "./state.js";
-export type { GoalWorkerKind } from "./state.js";
-export interface WorkerTurnContext {
-    cwd: string;
-    state: GoalState;
-    contractPath: string;
-    agentDefinitionPath: string;
-    turnIndex: number;
-    timeoutMs: number;
-}
-export type WorkerTurnKind = "status" | "action" | "error";
-export interface WorkerTurnResult {
-    kind: WorkerTurnKind;
-    summary: string;
-    packet?: GoalActionPacket;
-    error?: string;
-    evidencePath: string;
-}
-export interface GoalWorkerAdapter {
-    readonly id: GoalWorkerKind;
-    runTurn(ctx: WorkerTurnContext): Promise<WorkerTurnResult>;
-}
-export declare function goalWorkerTurnPath(cwd: string, goalId: string, turnIndex: number): string;
-export declare function extractJsonBlocks(text: string): unknown[];
-export declare function parseWorkerPacketFromText(text: string, goalId: string): GoalActionPacket | null;
-export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, label: string): Promise<T>;
-export declare class MockWorkerAdapter implements GoalWorkerAdapter {
-    readonly id: "mock";
-    runTurn(ctx: WorkerTurnContext): Promise<WorkerTurnResult>;
-}
-export declare class SdkWorkerAdapter implements GoalWorkerAdapter {
-    readonly id: "sdk";
-    runTurn(ctx: WorkerTurnContext): Promise<WorkerTurnResult>;
-}
-export declare function resolveWorkerAdapter(opts: {
-    mockWorker?: boolean;
-    worker?: GoalWorkerKind;
-}): GoalWorkerAdapter;
-export declare function defaultAgentDefinitionPath(cwd: string): string;
-export declare function buildWorkerTurnContext(cwd: string, state: GoalState, turnIndex: number): WorkerTurnContext;
-//# sourceMappingURL=worker.d.ts.map

package/dist/goal/worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/goal/worker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAM5D,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,OAAO,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC5D;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAczD;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,gBAAgB,GAAG,IAAI,CAWzB;AAkCD,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,CAAC,CAeZ;AAED,qBAAa,iBAAkB,YAAW,iBAAiB;IACzD,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAU;IAExB,OAAO,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAwBjE;AAED,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,QAAQ,CAAC,EAAE,EAAG,KAAK,CAAU;IAEvB,OAAO,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAmDjE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,GAAG,iBAAiB,CAcpB;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,MAAM,GAChB,iBAAiB,CASnB"}

package/dist/goal/worker.js

@@ -1,180 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { safeParseGoalActionPacket } from "./action-packet.js";
-import { goalContractPath, goalRunDir } from "./paths.js";
-import { promptCursorAgent } from "./sdk-client.js";
-import { buildGoalWorkerPrompt } from "./worker-prompt.js";
-import { packAction } from "./review-seam.js";
-import { hasCursorApiKey } from "../utils/cursor-sdk-gate.js";
-import { cursorApiKeySetupGuide } from "../utils/cursor-sdk-gate.js";
-export function goalWorkerTurnPath(cwd, goalId, turnIndex) {
-    return path.join(goalRunDir(cwd, goalId), "worker-turns", `${turnIndex}.md`);
-}
-export function extractJsonBlocks(text) {
-    const blocks = [];
-    const re = /```(?:json)?\s*([\s\S]*?)```/gi;
-    let match;
-    while ((match = re.exec(text)) !== null) {
-        const raw = match[1]?.trim();
-        if (!raw)
-            continue;
-        try {
-            blocks.push(JSON.parse(raw));
-        }
-        catch {
-            // skip invalid JSON fences
-        }
-    }
-    return blocks;
-}
-export function parseWorkerPacketFromText(text, goalId) {
-    for (const block of extractJsonBlocks(text)) {
-        const parsed = safeParseGoalActionPacket(block);
-        if (parsed.valid && parsed.packet.goal_id === goalId) {
-            return parsed.packet;
-        }
-        if (parsed.valid && !parsed.packet.goal_id) {
-            return parsed.packet;
-        }
-    }
-    return null;
-}
-function writeWorkerEvidence(evidencePath, body) {
-    fs.mkdirSync(path.dirname(evidencePath), { recursive: true });
-    const content = [
-        `# Goal worker turn ${body.turnIndex}`,
-        "",
-        `adapter: \`${body.adapter}\``,
-        `kind: \`${body.kind}\``,
-        `status: \`${body.status}\``,
-        `prompt_chars: ${body.promptChars}`,
-        "",
-        "## Result",
-        "",
-        "```text",
-        body.result.slice(0, 8000),
-        "```",
-        "",
-        body.error ? `## Error\n\n${body.error}\n` : "",
-    ].join("\n");
-    fs.writeFileSync(evidencePath, content, "utf-8");
-}
-export function withTimeout(promise, timeoutMs, label) {
-    return new Promise((resolve, reject) => {
-        const timer = setTimeout(() => {
-            reject(new Error(`${label} timed out after ${timeoutMs}ms`));
-        }, timeoutMs);
-        promise
-            .then((value) => {
-            clearTimeout(timer);
-            resolve(value);
-        })
-            .catch((error) => {
-            clearTimeout(timer);
-            reject(error);
-        });
-    });
-}
-export class MockWorkerAdapter {
-    id = "mock";
-    async runTurn(ctx) {
-        const evidencePath = goalWorkerTurnPath(ctx.cwd, ctx.state.goal_id, ctx.turnIndex);
-        const packet = packAction(ctx.state, {
-            summary: "Run focused validation for goal step (mock worker)",
-            kind: "shell",
-            digest: "pnpm test goal/",
-            axes: { A: false, B: false, C: true },
-            hardDenyCandidates: [],
-        });
-        writeWorkerEvidence(evidencePath, {
-            adapter: this.id,
-            turnIndex: ctx.turnIndex,
-            promptChars: 0,
-            status: "completed",
-            result: `[mock] worker turn ${ctx.turnIndex}`,
-            kind: "action",
-        });
-        return {
-            kind: "action",
-            summary: `mock worker step ${ctx.turnIndex}`,
-            packet,
-            evidencePath,
-        };
-    }
-}
-export class SdkWorkerAdapter {
-    id = "sdk";
-    async runTurn(ctx) {
-        const evidencePath = goalWorkerTurnPath(ctx.cwd, ctx.state.goal_id, ctx.turnIndex);
-        const prompt = buildGoalWorkerPrompt(ctx);
-        try {
-            const outcome = await withTimeout(promptCursorAgent(prompt, ctx.cwd), ctx.timeoutMs, "SDK worker turn");
-            const packet = parseWorkerPacketFromText(outcome.result, ctx.state.goal_id);
-            const kind = packet ? "action" : "status";
-            writeWorkerEvidence(evidencePath, {
-                adapter: this.id,
-                turnIndex: ctx.turnIndex,
-                promptChars: prompt.length,
-                status: outcome.status,
-                result: outcome.result,
-                kind,
-            });
-            if (packet) {
-                return {
-                    kind: "action",
-                    summary: `sdk worker proposed action (turn ${ctx.turnIndex})`,
-                    packet,
-                    evidencePath,
-                };
-            }
-            const summary = outcome.result.trim().slice(0, 240) ||
-                `sdk worker status (turn ${ctx.turnIndex})`;
-            return { kind: "status", summary, evidencePath };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            writeWorkerEvidence(evidencePath, {
-                adapter: this.id,
-                turnIndex: ctx.turnIndex,
-                promptChars: prompt.length,
-                status: "error",
-                result: "",
-                kind: "error",
-                error: message,
-            });
-            return {
-                kind: "error",
-                summary: `sdk worker error: ${message}`,
-                error: message,
-                evidencePath,
-            };
-        }
-    }
-}
-export function resolveWorkerAdapter(opts) {
-    if (opts.mockWorker || opts.worker === "mock") {
-        return new MockWorkerAdapter();
-    }
-    if (!hasCursorApiKey()) {
-        throw new Error([
-            "Runner goal worker requires CURSOR_API_KEY for live SDK turns.",
-            "Use --mock-worker for offline/CI, or set the key per `cstl sdk status`.",
-            cursorApiKeySetupGuide(),
-        ].join(" "));
-    }
-    return new SdkWorkerAdapter();
-}
-export function defaultAgentDefinitionPath(cwd) {
-    return path.join(cwd, ".cursor", "agents", "cstl-goal-worker.md");
-}
-export function buildWorkerTurnContext(cwd, state, turnIndex) {
-    return {
-        cwd,
-        state,
-        contractPath: goalContractPath(cwd, state.goal_id),
-        agentDefinitionPath: defaultAgentDefinitionPath(cwd),
-        turnIndex,
-        timeoutMs: state.walls.workerTurnTimeoutMs,
-    };
-}
-//# sourceMappingURL=worker.js.map

package/dist/goal/worker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/goal/worker.ts"],"names":[],"mappings":"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"}

package/dist/templates/common/bundled-skills/cstl-cursor2plus-setup/SKILL.md

@@ -1,63 +0,0 @@
----
-name: cstl-cursor2plus-setup
-description: "Guides Cursor++ BYOK users through trellis-task-models.json5 setup at init or on demand. User picks models per Trellis/Cursor Task role; the agent lists providers, writes commented JSON5 with primary/fallback, runs patch_wpelc8.py. Use when cstl init just finished with Cursor selected, user asks to configure subagent models, or providers.json changed."
----
-
-# Trellis Cursor++ subagent model setup (agent-led)
-
-## Who does what
-
-| Role | Responsibility |
-|------|----------------|
-| **User** | Chooses which **display/api model name** they want per scene (research / implement / check / built-in Task types). May skip types they never use. |
-| **Agent** | Lists catalog, writes `~/.ccursor/trellis-task-models.json5` with **comments per entry**, primary + fallback, runs patch, reports WARN/ERROR from resolver. |
-
-Do **not** ask the user to hand-edit slugs (`model-xxxxx`) unless they prefer it.
-
-## When to run
-
-- Right after **`cstl init`** when **Cursor** was selected (CLI prints a follow-up hint).
-- User says they use **Cursor++ BYOK** and want per–subagent-type models.
-- After Cursor++ **providers** change: re-list, adjust fallbacks, re-patch.
-- After **Cursor or Cursor++ upgrade**: run `python ./.cstl/local/cursor2plus/patch_wpelc8.py --check-compat` before `--apply --approve`; revert first if compat fails.
-
-Native **Cursor API** (no Cursor++): **stop** — frontmatter `model:` works; this skill does not apply. Tell the user: **`.cstl/local/cursor2plus/` is safe to ignore or delete** unless they use Cursor++ BYOK.
-
-## Workflow
-
-1. Confirm Cursor++ data dir exists (`~/.ccursor/providers.json` or user path in `.cstl/local/cursor2plus/config.local.json`).
-2. From repo root:
-   ```bash
-   python ./.cstl/local/cursor2plus/patch_wpelc8.py --list-models
-   python ./.cstl/local/cursor2plus/patch_wpelc8.py --explain
-   ```
-3. Ask the user **one role at a time** (or one message with a table) which **apiModel/displayName** they want for:
-   - `cstl-research`, `cstl-implement`, `cstl-check`
-   - optional: `generalPurpose`, `shell`, `best-of-n-runner`
-   For each, ask **fallback** if they care (recommend a second choice from `--list-models`).
-4. Write **`%USERPROFILE%\.ccursor\trellis-task-models.json5`** (or `~/.ccursor/`) using structure from `.cstl/local/trellis-task-models.json5.example`:
-   - JSON5 with `//` comments above each key explaining the Trellis/Cursor role
-   - `"models": { "<subagent_type>": { "primary": "...", "fallback": "..." } }`
-5. Run:
-   ```bash
-   python ./.cstl/local/cursor2plus/patch_wpelc8.py --print-map
-   python ./.cstl/local/cursor2plus/patch_wpelc8.py --apply --approve
-   ```
-6. Tell user: **Developer: Reload Window** in Cursor (once per patch).
-7. If stderr shows `WARN ... using fallback`, explain that primary was missing from current `providers.json` and fallback was used — suggest updating primary/fallback names, not panicking.
-
-## Resolver rules (for agent)
-
-- Values match `apiModel`, `displayName`, or slug from latest `providers.json` (case-insensitive for names).
-- **Primary** tried first; **fallback** only if primary does not resolve.
-- **ERROR** only when **both** fail for a configured type — then fix JSON or ask user to pick another model from `--list-models`.
-- Omit entire types the user does not use.
-
-## Files
-
-- User catalog: `~/.ccursor/providers.json`
-- User routing doc: `~/.ccursor/trellis-task-models.json5` (gitignored on machine)
-- Project override (optional): `.cstl/local/subagent-models.json5` — same shape, wins on same key
-- Patch bundle: `.cstl/local/cursor2plus/`
-
-Policy: `.cstl/spec/guides/cursor-subagent-policy.md` (Method 2.5 / 2.6).

package/dist/templates/cursor/commands/cursor2plus-setup.md

@@ -1,82 +0,0 @@
-# Trellis Cursor++ Subagent Model Setup
-
-Configure per-subagent-type model routing for Cursor++ BYOK. Run this after `cstl init` (when Cursor++ is selected), when providers change, or whenever you want to re-map which model each Trellis Task subagent uses.
-
-Native Cursor API (no Cursor++): stop — this does not apply; agent frontmatter `model:` works natively.
-
----
-
-## Step 1: Verify Cursor++ is configured
-
-Confirm the Cursor++ data directory exists:
-
-- `~/.ccursor/providers.json` (or a custom path in `.cstl/local/cursor2plus/config.local.json`)
-
-If missing, Cursor++ is not set up — ask the user to install/configure it first.
-
-## Step 2: List available models + roles
-
-```bash
-python ./.cstl/local/cursor2plus/patch_wpelc8.py --list-models
-python ./.cstl/local/cursor2plus/patch_wpelc8.py --explain
-```
-
-`--list-models` shows the model catalog (apiModel / displayName / slug / provider) from `providers.json`.
-`--explain` lists the subagent types you can route:
-
-- `cstl-research`, `cstl-implement`, `cstl-check` (core Trellis roles)
-- `generalPurpose`, `shell`, `best-of-n-runner` (built-in Cursor Task types, optional)
-
-## Step 3: Ask the user which model per role
-
-Ask the user (one role at a time, or a single table) which **apiModel/displayName** they want for each subagent type they use. For each, also ask a **fallback** (recommended: a second choice from `--list-models`).
-
-The user may skip types they don't use — omit those from the map.
-
-## Step 4: Write the routing map
-
-Write `~/.ccursor/trellis-task-models.json5` (or `~/.ccursor/` on Unix) using the structure from `.cstl/local/trellis-task-models.json5.example`:
-
-```json5
-// Trellis + Cursor++ BYOK — per-subagent-type model routing
-{
-  "models": {
-    // <role comment>
-    "cstl-research": { "primary": "<model>", "fallback": "<model>" },
-    "cstl-implement": { "primary": "<model>", "fallback": "<model>" },
-    "cstl-check": { "primary": "<model>", "fallback": "<model>" }
-  }
-}
-```
-
-Project-level override (optional, wins on same key): `.cstl/local/subagent-models.json5`.
-
-## Step 5: Apply the patch + verify
-
-```bash
-python ./.cstl/local/cursor2plus/patch_wpelc8.py --print-map
-python ./.cstl/local/cursor2plus/patch_wpelc8.py
-```
-
-Then tell the user: **Developer: Reload Window** in Cursor (required once per patch for the resolver change to take effect).
-
-## Step 6: Interpret resolver output
-
-- `OK <type>: '<model>' → model-<slug>` — resolved successfully.
-- `WARN ... using fallback` — primary was missing from current `providers.json`; fallback was used. Suggest updating primary/fallback names.
-- `ERROR` — both primary and fallback failed for a configured type. Fix the JSON or pick another model from `--list-models`.
-
-## Resolver rules
-
-- Values match `apiModel`, `displayName`, or slug from latest `providers.json` (case-insensitive for names).
-- Primary tried first; fallback only if primary does not resolve.
-- ERROR only when both fail for a configured type.
-
-## Files
-
-- User catalog: `~/.ccursor/providers.json`
-- User routing doc: `~/.ccursor/trellis-task-models.json5` (machine-local, gitignored)
-- Project override (optional): `.cstl/local/subagent-models.json5`
-- Patch bundle: `.cstl/local/cursor2plus/`
-
-Policy: `.cstl/spec/guides/cursor-subagent-policy.md` (Method 2.5 / 2.6).

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

@@ -1,32 +0,0 @@
----
-description: "Prefer Cursor native modes — task-driven; quiet cstl spine fallback"
-alwaysApply: true
----
-
-# Prefer Cursor native modes (P1 — orchestrate, don't replace)
-
-cstl **prefers** Cursor native modes and maps them to Trellis Triage/phases. **Do not** replace Cursor UI or invent a parallel Plan/Ask/Debug product. Full table: `.cstl/spec/guides/cursor-native-modes-guide.md` · evidence: `{TASK}/research/modes-callability-matrix.md`.
-
-## Quick routing
-
-| Situation | Prefer | Trellis anchor |
-| --- | --- | --- |
-| Read-only explain / lookup | **Ask** when reachable; else No Task in Agent | `[Triage: No Task]` — no durable edits |
-| Scope / design before code | **Try `SwitchMode(plan)`**; if poor, write artifacts in Agent | Phase 1 → `prd.md` / `design.md` / `implement.md`; `--check` |
-| Approved build / verify | **Agent**; `SwitchMode(agent)` after Plan | Phase 2–3; `execution_mode` |
-| Runtime / repeat failure | **Debug** when reachable; else verify + break-loop | Evidence → `verify.md` |
-| Independent Parent children (post-approval) | **Multitask** / `Task` parallel when useful | Explicit `.cstl/tasks/<dir>` per worker; Parent integrates |
-
-## Quiet fallback
-
-When native cannot be task-driven well: continue on the **cstl spine** (Triage / Phase / artifacts / gates). Do **not** add user-facing “本版本不适配某 mode” copy. Do **not** center guidance on “please open the mode picker.”
-
-## Hard boundaries
-
-- Plan default save = **home dir** until Save to workspace → map into task files.
-- Multitask/subagents: **never** rely on `selected_task`; worktrees + Parent review.
-- Agent `SwitchMode`: **`plan` / `agent` only** (Ask/Debug not in the tool enum).
-
-## Rollback
-
-Delete this file + `cursor-native-modes-guide.md` (see guide Rollback).

package/dist/templates/cursor/rules/cstl-session-rename.mdc

@@ -1,31 +0,0 @@
----
-description: "Rename Cursor chat to cstl task directory name after select or start-execution (cursor-app-control rename_chat)"
-alwaysApply: true
----
-
-# Trellis session rename (Cursor main session)
-
-Encourage **one task per main Agent chat**. Subagent / Task child windows are out of scope.
-
-## When to rename
-
-After **you** successfully run either command in the **main** session (same turn or immediately after shell output):
-
-- `python ./.cstl/scripts/task.py select <task-dir>`
-- `python ./.cstl/scripts/task.py start-execution <task-dir> --approved`
-
-Do **not** rename for `task.py create` alone (create does not bind the session).
-
-## Title
-
-Use the task **directory name** only (e.g. `07-04-cstl-session-rename`), not `task.json` `title`.
-
-## How
-
-1. If `cursor-app-control` MCP `rename_chat` is available, call it once with `title` = directory name.
-2. If the tool is **not** available (BYOK or other environments), **skip silently** — no user prompt to rename manually.
-3. Do not rename repeatedly for the same task in the same session unless the user switched to a different task directory.
-
-## Native vs BYOK
-
-Same rule for both. BYOK availability of `rename_chat` is environment-dependent; never fail the task workflow when rename is unavailable.

package/dist/templates/cursor/rules/cstl-subagent-dispatch.mdc

@@ -1,34 +0,0 @@
----
-description: "Trellis subagent dispatch — generate dispatch prompt via CLI before Task tool (hook injection is broken in Cursor 3.8.22; this rule is the D-1 workaround)"
-alwaysApply: true
----
-
-# Trellis Subagent Dispatch (CLI Layer 2 — MANDATORY)
-
-**CLI Layer 2 is the primary Cursor path.** The `preToolUse` hook does NOT fire for the Task tool in Cursor 3.8.22. Agent definition body does NOT enter subagent system prompt. The ONLY reliable context channel is the `Task` tool's `prompt` parameter.
-
-## Rule
-
-Before calling `Task(subagent_type="cstl-research|cstl-implement|cstl-check", ...)` you MUST:
-
-1. Generate a complete dispatch prompt via CLI:
-
-   ```powershell
-   python ./.cstl/scripts/generate_dispatch_prompt.py --agent <research|implement|check> --task "<task-path>" --repo-root "<repo-root>"
-   ```
-
-2. Use the CLI output as the `prompt` parameter value for `Task(...)`.
-
-3. Append any additional user instructions AFTER the generated prompt, separated by `\n\n---\n\n`.
-
-## Why
-
-The generated prompt carries role identity ("You are the Trellis Research/Implement/Check Agent"), write scope constraints, recursion guard, and dynamic context (prd.md, design.md, implement.md, spec tree, jsonl files). Without this, the subagent receives only a bare user instruction with no Trellis context.
-
-## Auto-detection
-
-If `--task` is omitted, the script resolves the currently selected task. If `--repo-root` is omitted, it auto-detects via `.cstl` or `.git` upward search.
-
-## Exception
-
-This rule does NOT apply to `generalPurpose`, `explore`, `shell`, or other non-Trellis subagent types. Only `cstl-research`, `cstl-implement`, `cstl-check` require CLI-generated prompts.

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

@@ -1,36 +0,0 @@
----
-description: "Trellis Request Triage — mandatory classification before any work (Cursor: alwaysApply rule is the per-turn reliable channel; sessionStart is session-level only)"
-alwaysApply: true
----
-
-# Trellis Request Triage (MANDATORY — hard gate, not optional)
-
-You MUST classify every work-capable user request BEFORE acting. This is not a suggestion. If you skip classification, you are breaking the Trellis workflow contract.
-
-## Decision tree (first match wins)
-
-1. **No durable project change** (explanation, status, read-only lookup, one-liner Q&A) → `No Task`
-2. **Underspecified small request, no task yet** (needs clarification before work exists) → `Micro-Grill` (load `cstl-micro-grill`)
-3. **Low-risk durable work, single file, local validation, no contract change** → `Lite Task`
-4. **Durable code/template/runtime/workflow change, cross-file behavior, or framework semantics** → `Full Task`
-5. **Multiple independent deliverables, staged/parallel execution, or integration authority** → `Parent Task`
-
-## Classification mark — REQUIRED as the FIRST line of your reply
-
-```
-[Triage: <Mode>] <one-sentence reason citing the trigger signal>
-```
-
-- `<Mode>` ∈ `No Task | Micro-Grill | Lite | Full | Parent`
-- The reason MUST cite the trigger signal (e.g. "cross-file workflow change", "read-only explanation"). Vague reasons like "looks complex" are rejected.
-- **`No Task` turns still require the mark** — it is how the user audits that you classified rather than skipped.
-
-## Consent gate
-
-After classifying into `Micro-Grill` / `Lite` / `Full` / `Parent`: **ASK the user for task-creation consent before creating any Trellis artifact.** Do NOT start implementation on your own. User consent to create a task is NOT consent to start coding — planning still happens first.
-
-If the user declines a task for a simple request, skip Trellis for this session.
-
-## Why this rule exists
-
-Request Triage must be visible **on every turn**, not only at session start. `.cursor/rules` with `alwaysApply: true` is the reliable per-turn channel on Cursor. `sessionStart` `additional_context` delivers session-level orientation (dashboard, workflow summary) once per session — useful but insufficient for a per-turn hard gate. The full decision tree also lives in `.cstl/workflow.md` for on-demand loading via `get_context.py` / `cstl-continue`.