@blxzer/cursor-trellis 0.3.0 → 0.3.2

package/dist/templates/markdown/spec/guides/cursor-semantic-compliance.md.txt

@@ -16,7 +16,7 @@ Use the same patterns as telemetry:
 python -c "from common.retrieval_tool_classification import classify_tool_calls; print(classify_tool_calls(['Grep','codebase_search'], platform='cursor'))"
 ```
 
-(Run from `.trellis/scripts` with `PYTHONPATH` set to that directory.)
+(Run from `.cstl/scripts` with `PYTHONPATH` set to that directory.)
 
 On **cursor**, `semantic_executed` = `platform_semantic_executed`. Track `fast_context_count` and `cursor_fast_context_misuse` separately.
 

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

@@ -98,14 +98,14 @@ When research is purely **codebase exploration** (no external web search, no fil
 
 **What it is:** A reversible patch to Cursor++ `extension.js` resolver `WPeLc8` that maps `subagentType` → BYOK catalog **slug** (`model-xxxxx`), evaluated **before** the inherit-parent branch. Verified 2026-06-18 (Cursor++ v0.0.11).
 
-**Trellis ships (every `cstl init` / `cstl update`, strategy C):** `.trellis/local/cursor2plus/` — `patch_wpelc8.py`, `README.md`, `config.local.json.example`. Native Cursor API users can ignore this directory.
+**Trellis ships (every `cstl init` / `cstl update`, strategy C):** `.cstl/local/cursor2plus/` — `patch_wpelc8.py`, `README.md`, `config.local.json.example`. Native Cursor API users can ignore this directory.
 
 **Operator workflow (Cursor++ BYOK only):**
 
 1. Fill **`~/.ccursor/trellis-task-models.json`** (user-wide) with `subagent_type` → slug from **`~/.ccursor/providers.json`** `id` fields.
-2. Optionally override per repo: **`.trellis/local/subagent-models.json`** (project wins on same key).
+2. Optionally override per repo: **`.cstl/local/subagent-models.json`** (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 `.trellis/local/cursor2plus/`: `python patch_wpelc8.py --print-map` → `python patch_wpelc8.py` → **Developer: Reload Window**.
+4. From `.cstl/local/cursor2plus/`: `python patch_wpelc8.py --print-map` → `python patch_wpelc8.py` → **Developer: Reload Window**.
 5. **Verify:** `taskToolCall dispatching` → `resolvedModelId` matches slug.
 
 **Revert:** `python patch_wpelc8.py --revert`; Reload Window. Re-run patch after Cursor / Cursor++ upgrades.
@@ -117,7 +117,7 @@ When research is purely **codebase exploration** (no external web search, no fil
 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** `.trellis/local/subagent-models.json`.
+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.
 
@@ -128,7 +128,7 @@ Parent/Child **default** does not use 2.6 — it uses `cstl-implement` from the
 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**:
 
 1. **Main session prepares the dispatch prompt** — full text with:
-   - First line: Selected task: <path> (e.g. .trellis/tasks/06-17-my-task)
+   - First line: Selected task: <path> (e.g. .cstl/tasks/06-17-my-task)
    - Task context from inject-subagent-context.py content (PRD, design, implement docs)
    - Agent role instructions (from the corresponding .cursor/agents/cstl-<role>.md)
    - Specific work assignment
@@ -217,14 +217,14 @@ Operational contract between the Trellis task ladder and Cursor++ BYOK.
 | 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 + `.trellis/local/cursor2plus/patch_wpelc8.py` — **not** repo agent files |
+| **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 |
 | **Main Agent session** | When to spawn which agent | `workflow.md`, skills, scene matrix |
 | **Hooks** | Never | `inject-subagent-context.py` — task context only |
 
 ### Normal Full / Lite task flow
 
-1. **Select task** — `task.py select`; dispatch prompts include `Selected task: .trellis/tasks/<id>` when hooks need it.
+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.
@@ -252,7 +252,7 @@ No model field in dispatch prompt under Method 2.5. Task `model: fast` does **no
 
 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 `.trellis/local/cursor2plus/` → Reload Window.
+3. Run `patch_wpelc8.py` from `.cstl/local/cursor2plus/` → Reload Window.
 4. Re-apply after Cursor / Cursor++ upgrades.
 
 ### What stays in the Trellis repo
@@ -317,7 +317,7 @@ trellis_task_subagents:
 If a dispatched subagent cannot answer from `prd.md` / jsonl (empty or generic replies):
 
 1. Confirm the main session used **CLI Layer 2** before `Task(...)` (workflow Phase 2.1 / 2.2).
-2. **Manual fallback (Method 3):** run `python ./.trellis/scripts/task.py generate-dispatch-prompt <task-dir> <role> [--scope "..."]`, paste stdout into `Task(subagent_type=..., prompt=...)`.
+2. **Manual fallback (Method 3):** run `python ./.cstl/scripts/task.py generate-dispatch-prompt <task-dir> <role> [--scope "..."]`, paste stdout into `Task(subagent_type=..., prompt=...)`.
 3. Hook-only injection is best-effort on Cursor; do not treat `preToolUse` as the sole source.
 
 This command is **Agent-facing** — not listed in user README or slash command surface.
@@ -385,9 +385,9 @@ For multi-package workspaces, list all install commands needed after a fresh che
 ## References
 
 - `.cursor/agents/cstl-research.md`, `cstl-implement.md`, `cstl-check.md`
-- `.cursor/agents/.trellis-model-overlay.local.md` — optional overlay audit stub (native API)
+- `.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
-- `.trellis/workflow.md` — Task Ladder + Parent orchestration
+- `.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
 - `.cursor/worktrees.json` — Cursor native worktree setup configuration

package/dist/templates/markdown/spec/guides/durable-learning-decision-guide.md.txt

@@ -1,8 +1,8 @@
 # Durable Learning Decision Guide
 
-> **Purpose**: Decide whether a completed task should update `.trellis/spec/` or can archive with an explicit **no durable learning** line.
+> **Purpose**: Decide whether a completed task should update `.cstl/spec/` or can archive with an explicit **no durable learning** line.
 
-This guide is a **thinking checklist**. It does not replace code-spec files under `.trellis/spec/<layer>/`.
+This guide is a **thinking checklist**. It does not replace code-spec files under `.cstl/spec/<layer>/`.
 
 ---
 
@@ -13,9 +13,9 @@ Pick **one** grep-friendly line before `archive --check`:
 | Outcome | Example line in `verify.md` |
 | --- | --- |
 | No reusable insight | `Durable learning decision: no durable learning` (or any line containing `no durable learning`) |
-| Spec was updated | `Spec update evidence: .trellis/spec/Trellis/framework/index.md` |
-| Insight already documented | `Learning artifact: .trellis/tasks/<task>/handoff.md` |
-| Retrospective captured | `Learning artifact: .trellis/workspace/...` or `retrospective.md: <path>` |
+| Spec was updated | `Spec update evidence: .cstl/spec/Trellis/framework/index.md` |
+| Insight already documented | `Learning artifact: .cstl/tasks/<task>/handoff.md` |
+| Retrospective captured | `Learning artifact: .cstl/workspace/...` or `retrospective.md: <path>` |
 
 Optional planning note (not sufficient alone): `Spec update needed: <reason>` — still record **spec update evidence** after `/cstl:update-spec`.
 
@@ -47,13 +47,13 @@ Optional planning note (not sufficient alone): `Spec update needed: <reason>`
 
 ```bash
 # Draft missing archive sections (append-only)
-python ./.trellis/scripts/task.py prepare-archive-evidence .trellis/tasks/<task>
+python ./.cstl/scripts/task.py prepare-archive-evidence .cstl/tasks/<task>
 
 # Print spec-capture checklist (stdout only; does not edit specs)
-python ./.trellis/scripts/task.py prepare-learning-scaffold .trellis/tasks/<task> --trigger "parent review changes"
+python ./.cstl/scripts/task.py prepare-learning-scaffold .cstl/tasks/<task> --trigger "parent review changes"
 
 # Parent review surfaces missing child learning lines
-python ./.trellis/scripts/task.py review-child <parent> <child> --check
+python ./.cstl/scripts/task.py review-child <parent> <child> --check
 ```
 
 ---

package/dist/templates/markdown/spec/guides/execution-strategy.md.txt

@@ -16,8 +16,8 @@ Non-git repo roots do **not** force `inline` for code Full tasks; they only affe
 ## Suggest (planning)
 
 ```bash
-python3 ./.trellis/scripts/task.py suggest-execution-strategy <task-dir>
-python3 ./.trellis/scripts/task.py suggest-execution-strategy <task-dir> --json
+python3 ./.cstl/scripts/task.py suggest-execution-strategy <task-dir>
+python3 ./.cstl/scripts/task.py suggest-execution-strategy <task-dir> --json
 ```
 
 Run during brainstorm / before finalizing the YAML block in `implement.md`. Reconcile suggestion with product intent; the contract in `implement.md` is authoritative after approval.
@@ -32,7 +32,7 @@ Run during brainstorm / before finalizing the YAML block in `implement.md`. Reco
 | Parent / has children | `inline` | `main-worktree` |
 | Child (`task.json` parent set) | `child-task` | `git-worktree` when git package root resolves; else `main-worktree` + WARN |
 
-`touches_code` is deterministic: code `optional_capabilities`, `package`/`scope` path segments (`src`, `packages`, `scripts`, …), or Full with `design.md` and non-doc-only capabilities. Rules live in `.trellis/config/execution-strategy-rules.json`.
+`touches_code` is deterministic: code `optional_capabilities`, `package`/`scope` path segments (`src`, `packages`, `scripts`, …), or Full with `design.md` and non-doc-only capabilities. Rules live in `.cstl/config/execution-strategy-rules.json`.
 
 ## Drift warning (preflight)
 

package/dist/templates/markdown/spec/guides/retrieval-daily-guide.md.txt

@@ -46,13 +46,13 @@ When `projectFileCount > 2000`, the router promotes structural (codegraph) route
 ## Commands
 
 ```powershell
-python ./.trellis/scripts/search_artifacts.py --query "<topic>" --json
-python ./.trellis/scripts/search_memory.py --query "<topic>" --json
-python ./.trellis/scripts/run_smart_search.py "<question>" --intent deep-research --json
-python ./.trellis/scripts/route_codebase_retrieval.py "<question>" --json
-python ./.trellis/scripts/route_codebase_retrieval.py "<question>" --instructions
-python ./.trellis/scripts/get_context.py --mode retrieval-pack --json --input evidence.json
-python ./.trellis/scripts/codegraph_session_smoke.py --json
+python ./.cstl/scripts/search_artifacts.py --query "<topic>" --json
+python ./.cstl/scripts/search_memory.py --query "<topic>" --json
+python ./.cstl/scripts/run_smart_search.py "<question>" --intent deep-research --json
+python ./.cstl/scripts/route_codebase_retrieval.py "<question>" --json
+python ./.cstl/scripts/route_codebase_retrieval.py "<question>" --instructions
+python ./.cstl/scripts/get_context.py --mode retrieval-pack --json --input evidence.json
+python ./.cstl/scripts/codegraph_session_smoke.py --json
 ```
 
 ## Codegraph session readiness (eval / dogfood)
@@ -60,7 +60,7 @@ python ./.trellis/scripts/codegraph_session_smoke.py --json
 Before a **cold benchmark** or structural-heavy run:
 
 1. **MCP**: In Cursor project MCP settings, enable the **codegraph** server for the workspace (or eval checkout).
-2. **Index on disk**: Run `python ./.trellis/scripts/codegraph_session_smoke.py` (exit 0 = at least one `.codegraph/` under workspace root or a top-level subproject). Use `--root <eval-checkout>` when the agent root is not the harness.
+2. **Index on disk**: Run `python ./.cstl/scripts/codegraph_session_smoke.py` (exit 0 = at least one `.codegraph/` under workspace root or a top-level subproject). Use `--root <eval-checkout>` when the agent root is not the harness.
 3. **Live MCP smoke** (manual): one `codegraph_search` with a known symbol in that repo; stale-index banner → re-read affected files.
 
 Paste into the **run report header** (markdown):
@@ -76,7 +76,7 @@ Paste into the **run report header** (markdown):
 
 When `smart-search doctor` is not ok or `run_smart_search.py` status is `not_configured` / `failed` (including **search timeout**), use **Cursor WebSearch/WebFetch**, then persist to `{TASK}/research/` with `source: cursor-web-fallback` in frontmatter. See `smart-search-cli` skill §4b.
 
-**CLI discovery (Cursor):** `TRELLIS_SMART_SEARCH_COMMAND` / `smart_search.command` → PATH `smart-search` → project `node_modules/.bin/smart-search` (when installed as a dependency). Agent entrypoint is always `./.trellis/scripts/run_smart_search.py`.
+**CLI discovery (Cursor):** `TRELLIS_SMART_SEARCH_COMMAND` / `smart_search.command` → PATH `smart-search` → project `node_modules/.bin/smart-search` (when installed as a dependency). Agent entrypoint is always `./.cstl/scripts/run_smart_search.py`.
 
 **Research flags (smart-search ≥ 0.1.15):** pass through `run_smart_search.py` for `--intent deep-research`:
 
@@ -107,7 +107,7 @@ After Grep/codegraph/semantic produce **path candidates**, reorder before choosi
 | `env-config-literal` | Prefer `scripts/`, `e2e/`, `bench/`, `test/` over generic `src/auth` / `src/paths`. |
 
 - **Agent plans**: `render_agent_instructions` / `inject-retrieval-plan.py` append a **结果层排序** block when these intents appear.
-- **Offline reorder**: `python ./.trellis/scripts/rank_retrieval_candidates.py --candidates fixtures.json --intents caller-chain --top-k 5 --pretty`
+- **Offline reorder**: `python ./.cstl/scripts/rank_retrieval_candidates.py --candidates fixtures.json --intents caller-chain --top-k 5 --pretty`
 - **Library**: `common/retrieval_result_ranking.py` (Python mirror used by router and rank script).
 
 Do **not** claim aggregate openclaw score gains from ranking alone without fresh telemetry (`candidate_pool_recall` vs final Top-K).

package/dist/templates/markdown/workspace-index.md

@@ -38,7 +38,7 @@ workspace/
 Run the initialization script:
 
 ```bash
-python3 ./.trellis/scripts/init_developer.py <your-name>
+python3 ./.cstl/scripts/init_developer.py <your-name>
 ```
 
 This will:
@@ -51,12 +51,12 @@ This will:
 
 1. Get your developer name:
    ```bash
-   python3 ./.trellis/scripts/get_developer.py
+   python3 ./.cstl/scripts/get_developer.py
    ```
 
 2. Read your personal index:
    ```bash
-   cat .trellis/workspace/$(python3 ./.trellis/scripts/get_developer.py)/index.md
+   cat .cstl/workspace/$(python3 ./.cstl/scripts/get_developer.py)/index.md
    ```
 
 ---

package/dist/templates/markdown/worktree.yaml.txt

@@ -22,7 +22,7 @@ copy:
   # - .env
   # - .env.local
   # Workflow config
-  - .trellis/.developer
+  - .cstl/.developer
 
 #-------------------------------------------------------------------------------
 # Post-Create Hooks

package/dist/templates/shared-hooks/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared hook templates — platform-independent Python hook scripts.
  *
- * These scripts read only from .trellis/ paths (JSONL, prd.md, spec/) and
+ * These scripts read only from .cstl/ paths (JSONL, prd.md, spec/) and
  * have no platform-specific placeholders. They can be written as-is to any
  * platform's hooks directory.
  */

package/dist/templates/shared-hooks/index.js

@@ -1,7 +1,7 @@
 /**
  * Shared hook templates — platform-independent Python hook scripts.
  *
- * These scripts read only from .trellis/ paths (JSONL, prd.md, spec/) and
+ * These scripts read only from .cstl/ paths (JSONL, prd.md, spec/) and
  * have no platform-specific placeholders. They can be written as-is to any
  * platform's hooks directory.
  */

package/dist/templates/shared-hooks/inject-retrieval-plan.py

@@ -4,10 +4,10 @@
 DEGRADED MODE (2026-06-24): beforeSubmitPrompt hook's additional_context does
 not reach the model in current Cursor versions (L1: event often not fired;
 L2: additional_context not delivered). This hook now runs in telemetry-only
-mode: logs routing decisions to .trellis/.runtime/retrieval-plan-events.log
+mode: logs routing decisions to .cstl/.runtime/retrieval-plan-events.log
 for post-session analysis but does NOT inject plan blocks.
 
-See .trellis/tasks/06-24-handle-beforesubmitprompt-unreliability/prd.md for
+See .cstl/tasks/06-24-handle-beforesubmitprompt-unreliability/prd.md for
 probe results and mitigation strategy.
 
 Silent exit 0 (no stdout) when:
@@ -48,7 +48,7 @@ if sys.platform.startswith("win"):
             except Exception:
                 pass
 
-DIR_WORKFLOW = ".trellis"
+DIR_WORKFLOW = ".cstl"
 PLAN_MARKER_ZH = "## 代码库检索计划"
 PLAN_MARKER_EN = "## Codebase retrieval plan"
 TELEMETRY_LOG = ".runtime/retrieval-plan-events.log"

package/dist/templates/shared-hooks/inject-shell-session-context.py

@@ -2,9 +2,9 @@
 """Cursor beforeShellExecution hook: bridge conversation identity to task.py.
 
 Cursor's shell command environment does not inherit SessionStart data. This
-hook writes a short-lived runtime ticket before Cursor runs a shell command
-that calls `task.py select/selected/exit`. The task script then consumes the
-ticket only when it has no native session environment.
+hook writes a short-lived runtime ticket before Cursor runs a shell command
+that calls `task.py select/selected/exit`. The task script then consumes the
+ticket only when it has no native session environment.
 """
 from __future__ import annotations
 
@@ -18,10 +18,10 @@ from pathlib import Path
 from typing import Any
 
 
-DIR_WORKFLOW = ".trellis"
+DIR_WORKFLOW = ".cstl"
 DIR_RUNTIME = ".runtime"
 DIR_CURSOR_SHELL = "cursor-shell"
-SESSION_SUBCOMMANDS = {"select", "selected", "exit"}
+SESSION_SUBCOMMANDS = {"select", "selected", "exit"}
 TICKET_TTL_SECONDS = 30
 CONTEXT_IDENTITY_KEYS = (
     "session_id",
@@ -80,8 +80,8 @@ def _extract_task_subcommands(command: str) -> list[dict[str, str]]:
         if name not in SESSION_SUBCOMMANDS:
             continue
         item = {"name": name}
-        if name == "select" and index + 2 < len(tokens):
-            item["task_ref"] = tokens[index + 2]
+        if name == "select" and index + 2 < len(tokens):
+            item["task_ref"] = tokens[index + 2]
         subcommands.append(item)
     return subcommands
 

package/dist/templates/shared-hooks/inject-subagent-context.py

@@ -26,7 +26,7 @@ if sys.platform.startswith("win"):
     elif hasattr(sys.stdout, "detach"):
         sys.stdout = _io.TextIOWrapper(sys.stdout.detach(), encoding="utf-8", errors="replace")  # type: ignore[union-attr]
 
-DIR_WORKFLOW = ".trellis"
+DIR_WORKFLOW = ".cstl"
 
 AGENT_IMPLEMENT = "cstl-implement"
 AGENT_CHECK = "cstl-check"

package/dist/templates/shared-hooks/inject-workflow-state.py

@@ -23,7 +23,7 @@ hook entry point). Written to each platform's hooks directory via
 writeSharedHooks() at init time.
 
 Silent exit 0 cases (no output):
-  - No .trellis/ directory found (not a Trellis project)
+  - No .cstl/ directory found (not a Trellis project)
   - task.json malformed or missing status
 """
 from __future__ import annotations
@@ -71,14 +71,14 @@ If you have not already loaded Trellis context this session, read the `cstl-star
 # ---------------------------------------------------------------------------
 
 def find_trellis_root(start: Path) -> Optional[Path]:
-    """Walk up from start to find directory containing .trellis/.
+    """Walk up from start to find directory containing .cstl/.
 
     Handles CWD drift: subdirectory launches, monorepo packages, etc.
-    Returns None if no .trellis/ found (silent no-op).
+    Returns None if no .cstl/ found (silent no-op).
     """
     cur = start.resolve()
     while cur != cur.parent:
-        if (cur / ".trellis").is_dir():
+        if (cur / ".cstl").is_dir():
             return cur
         cur = cur.parent
     return None
@@ -125,7 +125,7 @@ def _detect_platform(input_data: dict) -> str | None:
 
 
 def _resolve_selected_task(root: Path, input_data: dict):
-    scripts_dir = root / ".trellis" / "scripts"
+    scripts_dir = root / ".cstl" / "scripts"
     if str(scripts_dir) not in sys.path:
         sys.path.insert(0, str(scripts_dir))
     from common.active_task import resolve_selected_task  # type: ignore[import-not-found]
@@ -180,7 +180,7 @@ def load_breadcrumbs(root: Path) -> dict[str, str]:
     in build_breadcrumb so users see the broken state and fix
     workflow.md, rather than the hook silently masking the issue.
     """
-    workflow = root / ".trellis" / "workflow.md"
+    workflow = root / ".cstl" / "workflow.md"
     if not workflow.is_file():
         return {}
     try:
@@ -198,12 +198,12 @@ def load_breadcrumbs(root: Path) -> dict[str, str]:
 
 
 def _read_trellis_config(root: Path) -> dict:
-    """Load .trellis/config.yaml via the bundled trellis_config helper.
+    """Load .cstl/config.yaml via the bundled trellis_config helper.
 
-    The helper lives in .trellis/scripts/common; the hook lives outside the
+    The helper lives in .cstl/scripts/common; the hook lives outside the
     scripts tree, so we extend sys.path before importing.
     """
-    scripts_dir = root / ".trellis" / "scripts"
+    scripts_dir = root / ".cstl" / "scripts"
     if str(scripts_dir) not in sys.path:
         sys.path.insert(0, str(scripts_dir))
     try:
@@ -219,7 +219,7 @@ def _read_trellis_config(root: Path) -> dict:
 def _codex_mode_banner(config: dict) -> str:
     """Emit a `<codex-mode>` banner for the additionalContext payload.
 
-    Reads `codex.dispatch_mode` from .trellis/config.yaml; defaults to
+    Reads `codex.dispatch_mode` from .cstl/config.yaml; defaults to
     `inline` when missing or invalid because Codex sub-agents run with
     `fork_turns="none"` isolation and can't inherit the parent session's
     task context. The banner makes the active mode explicit to Codex AI
@@ -254,7 +254,7 @@ def resolve_breadcrumb_key(
 
     Codex defaults to ``inline`` because sub-agents run with ``fork_turns="none"``
     isolation and can't inherit the parent session's task context. Users can
-    opt into ``codex.dispatch_mode: sub-agent`` in ``.trellis/config.yaml``
+    opt into ``codex.dispatch_mode: sub-agent`` in ``.cstl/config.yaml``
     to use the parallel ``<status>-inline`` tag → ``<status>`` flip. Invalid
     or missing values fall back to inline.
 

package/dist/templates/shared-hooks/research-end-retrieval-pack.py

@@ -31,7 +31,7 @@ if sys.platform.startswith("win"):
             sys.stdout.detach(), encoding="utf-8", errors="replace"
         )
 
-DIR_WORKFLOW = ".trellis"
+DIR_WORKFLOW = ".cstl"
 OUTPUT_BASENAME = "retrieval-pack-latest.json"
 MARKER = "<!-- cstl-research-end-pack -->"
 

package/dist/templates/shared-hooks/session-start.py

@@ -308,7 +308,7 @@ def _normalize_task_ref(task_ref: str) -> str:
         normalized = normalized[2:]
 
     if normalized.startswith("tasks/"):
-        return f".trellis/{normalized}"
+        return f".cstl/{normalized}"
 
     return normalized
 
@@ -318,7 +318,7 @@ def _resolve_task_dir(trellis_dir: Path, task_ref: str) -> Path:
     path_obj = Path(normalized)
     if path_obj.is_absolute():
         return path_obj
-    if normalized.startswith(".trellis/"):
+    if normalized.startswith(".cstl/"):
         return trellis_dir.parent / path_obj
     return trellis_dir / "tasks" / path_obj
 
@@ -341,7 +341,7 @@ def _get_task_status(trellis_dir: Path, input_data: dict) -> str:
         return (
             f"Trellis framework: active\nSelected task: {task_ref}\n"
             "Status: STALE SELECTION\n"
-            f"Next-Action: Run `{_PYTHON_CMD} ./.trellis/scripts/task.py exit` to clear the stale selection, "
+            f"Next-Action: Run `{_PYTHON_CMD} ./.cstl/scripts/task.py exit` to clear the stale selection, "
             "then ask the user what to work on next."
         )
 
@@ -570,7 +570,7 @@ def _collect_spec_index_paths(trellis_dir: Path, allowed_pkgs: set | None) -> li
     paths: list[str] = []
     guides_index = trellis_dir / "spec" / "guides" / "index.md"
     if guides_index.is_file():
-        paths.append(".trellis/spec/guides/index.md")
+        paths.append(".cstl/spec/guides/index.md")
 
     spec_dir = trellis_dir / "spec"
     if not spec_dir.is_dir():
@@ -582,7 +582,7 @@ def _collect_spec_index_paths(trellis_dir: Path, allowed_pkgs: set | None) -> li
 
         index_file = sub / "index.md"
         if index_file.is_file():
-            paths.append(f".trellis/spec/{sub.name}/index.md")
+            paths.append(f".cstl/spec/{sub.name}/index.md")
             continue
 
         if allowed_pkgs is not None and sub.name not in allowed_pkgs:
@@ -592,7 +592,7 @@ def _collect_spec_index_paths(trellis_dir: Path, allowed_pkgs: set | None) -> li
                 continue
             nested_index = nested / "index.md"
             if nested_index.is_file():
-                paths.append(f".trellis/spec/{sub.name}/{nested.name}/index.md")
+                paths.append(f".cstl/spec/{sub.name}/{nested.name}/index.md")
 
     return paths
 
@@ -641,7 +641,7 @@ def _build_compact_current_state(
         try:
             task_count = sum(1 for _ in iter_active_tasks(get_tasks_dir(repo_root)))
             lines.append(
-                f"Active tasks: {task_count} total. Use the Task Dashboard for routing; use `{_PYTHON_CMD} ./.trellis/scripts/task.py list --mine` only for raw inspection."
+                f"Active tasks: {task_count} total. Use the Task Dashboard for routing; use `{_PYTHON_CMD} ./.cstl/scripts/task.py list --mine` only for raw inspection."
             )
         except Exception:
             pass
@@ -672,7 +672,7 @@ def _build_task_dashboard(trellis_dir: Path, input_data: dict) -> str:
             _detect_platform(input_data),
         )
     except Exception:
-        return f"Task Dashboard unavailable. Run: {_PYTHON_CMD} ./.trellis/scripts/task.py dashboard"
+        return f"Task Dashboard unavailable. Run: {_PYTHON_CMD} ./.cstl/scripts/task.py dashboard"
 
 
 def _extract_range(content: str, start_header: str, end_header: str) -> str:
@@ -739,7 +739,7 @@ def _build_workflow_overview(workflow_path: Path) -> str:
 
     out_lines = [
         "# Development Workflow - Session Summary",
-        f"Full guide: .trellis/workflow.md. Step detail: `{_PYTHON_CMD} ./.trellis/scripts/get_context.py --mode phase --step <X.Y>`.",
+        f"Full guide: .cstl/workflow.md. Step detail: `{_PYTHON_CMD} ./.cstl/scripts/get_context.py --mode phase --step <X.Y>`.",
         "",
     ]
 
@@ -781,7 +781,7 @@ def main():
     if project_dir is None:
         project_dir = Path(_normalize_windows_shell_path(hook_input.get("cwd", "."))).resolve()
 
-    trellis_dir = project_dir / ".trellis"
+    trellis_dir = project_dir / ".cstl"
     context_key = _resolve_context_key(trellis_dir, hook_input)
     _persist_context_key_for_bash(context_key)
 
@@ -836,17 +836,17 @@ Trellis compact SessionStart context. Use it to orient the session; load details
 
     output.write(
         "Discover more via: "
-        f"`{_PYTHON_CMD} ./.trellis/scripts/get_context.py --mode packages`\n"
+        f"`{_PYTHON_CMD} ./.cstl/scripts/get_context.py --mode packages`\n"
     )
     if _detect_platform(hook_input) == "cursor":
         output.write(
             "\n**External web research (Cursor):** run "
-            f"`{_PYTHON_CMD} ./.trellis/scripts/run_smart_search.py \"<question>\" "
+            f"`{_PYTHON_CMD} ./.cstl/scripts/run_smart_search.py \"<question>\" "
             "--intent deep-research --json` first (Trellis evidence wrapper → "
             "`smart-search` CLI). CLI discovery: `TRELLIS_SMART_SEARCH_COMMAND` / "
             "`smart_search.command`, then PATH `smart-search`, then project "
             "`node_modules/.bin/smart-search`, then optional repo-local layouts "
-            "(see `.trellis/spec/guides/retrieval-daily-guide.md`). "
+            "(see `.cstl/spec/guides/retrieval-daily-guide.md`). "
             "`smart-search-cli` is an internal workflow skill name — not a file under `.cursor/skills/` on Cursor. "
             "If `run_smart_search.py` status is `not_configured` or `failed` (incl. timeout), "
             "use **WebSearch/WebFetch**, persist `{TASK}/research/*.md` with "

package/dist/templates/trellis/config.yaml

@@ -24,7 +24,7 @@ max_journal_lines: 2000
 # - false: scripts do not touch git. Files (journal-*.md, task archive moves)
 #   are still written to disk; you decide whether to git add / commit.
 #
-# Use `false` if your project's .gitignore intentionally excludes `.trellis/`
+# Use `false` if your project's .gitignore intentionally excludes `.cstl/`
 # and you want session data kept local-only, or if you prefer to review
 # staged changes manually before each commit.
 #
@@ -88,7 +88,7 @@ max_journal_lines: 2000
 #-------------------------------------------------------------------------------
 # Cursor subagent dispatch (documentation only — not Cursor product settings)
 #-------------------------------------------------------------------------------
-# See .trellis/spec/guides/cursor-subagent-policy.md
+# See .cstl/spec/guides/cursor-subagent-policy.md
 #
 # cursor:
 #   subagent_dispatch:
@@ -98,26 +98,6 @@ max_journal_lines: 2000
 #     mode: separate_writable_agent_session
 #     reuse_policy: true
 
-#-------------------------------------------------------------------------------
-# Channel worker OOM guard
-#-------------------------------------------------------------------------------
-# Default safeguards for `cstl channel spawn` workers. The guard runs
-# at spawn time (cleans expired idle workers, then enforces the live-worker
-# budget) and inside each supervisor (self-terminates a worker that stays
-# continuously idle past `idle_timeout`).
-#
-# Precedence: CLI flag > env var (TRELLIS_CHANNEL_WORKER_IDLE_TIMEOUT /
-# TRELLIS_CHANNEL_MAX_LIVE_WORKERS) > this config > built-in default.
-#
-# `idle_timeout: 0` disables idle cleanup (workers can sit idle forever
-# unless explicitly killed or given `--timeout`).
-# `max_live_workers: 0` disables the spawn-time budget check.
-#
-channel:
-  worker_guard:
-    idle_timeout: 5m
-    max_live_workers: 6
-
 #-------------------------------------------------------------------------------
 # Codex (dispatch behavior)
 #-------------------------------------------------------------------------------

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

@@ -2,7 +2,7 @@
  * Trellis workflow templates
  *
  * These are GENERIC templates for user projects.
- * Do NOT use Trellis project's own .trellis/ directory (which may be customized).
+ * Do NOT use Trellis project's own .cstl/ directory (which may be customized).
  *
  * Directory structure:
  *   trellis/
@@ -80,7 +80,7 @@ export declare const workflowMdTemplate: string;
 export declare const configYamlTemplate: string;
 export declare const gitignoreTemplate: string;
 /**
- * Optional task artifact templates (under `.trellis/tasks/templates/`).
+ * Optional task artifact templates (under `.cstl/tasks/templates/`).
  * Not applied by `task.py create`; copy into a new task directory when starting
  * release-readiness or release-execution work.
  */

package/dist/templates/trellis/index.js

@@ -2,7 +2,7 @@
  * Trellis workflow templates
  *
  * These are GENERIC templates for user projects.
- * Do NOT use Trellis project's own .trellis/ directory (which may be customized).
+ * Do NOT use Trellis project's own .cstl/ directory (which may be customized).
  *
  * Directory structure:
  *   trellis/
@@ -107,7 +107,7 @@ function readTaskTemplate(relativePath) {
     return readTemplate(join("tasks", "templates", relativePath));
 }
 /**
- * Optional task artifact templates (under `.trellis/tasks/templates/`).
+ * Optional task artifact templates (under `.cstl/tasks/templates/`).
  * Not applied by `task.py create`; copy into a new task directory when starting
  * release-readiness or release-execution work.
  */

package/dist/templates/trellis/local/README.md

@@ -20,7 +20,7 @@ User-wide model doc: `~/.ccursor/trellis-task-models.json5` (see `../trellis-tas
 
 ## Compatibility window
 
-- **Verified:** Cursor **3.7.27** / Cursor++ **v0.0.11** (see `.trellis/spec/guides/cursor-subagent-policy.md`, 2026-06-18)
+- **Verified:** Cursor **3.7.27** / Cursor++ **v0.0.11** (see `.cstl/spec/guides/cursor-subagent-policy.md`, 2026-06-18)
 - **Re-verify** after any Cursor or Cursor++ upgrade: `python patch_wpelc8.py --check-compat`
 - If `--check-compat` reports `fail` or `unknown`, treat the patch as stale until you re-apply or revert
 
@@ -38,7 +38,7 @@ Agent-led setup: run skill **`cstl-cursor2plus-setup`** in Cursor Agent (lists m
 ## Revert recipe
 
 ```bash
-cd .trellis/local/cursor2plus
+cd .cstl/local/cursor2plus
 python patch_wpelc8.py --revert
 ```
 
@@ -82,4 +82,4 @@ python smoke.py                             # env + patch_status smoke
 
 Each role: `{ "primary": "<name>", "fallback": "<name>" }`. Names: **apiModel** or **displayName** from Cursor++ (`--list-models`). **Explore** is not in this file — use the Cursor++ panel.
 
-Policy: `.trellis/spec/guides/cursor-subagent-policy.md` (Method 2.5 / 2.6).
+Policy: `.cstl/spec/guides/cursor-subagent-policy.md` (Method 2.5 / 2.6).