@blxzer/cursor-trellis 0.3.0 → 0.3.3

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/cursor-trellis-release-coexistence-guide.md.txt

@@ -0,0 +1,166 @@
+# cursor-trellis Release & Coexistence Guide
+
+> **Audience**: Maintainers and agents working on `@blxzer/cursor-trellis` in `D:\MyHarness\cursor-trellis`.  
+> **Scope**: npm publish runbook, git tag naming (`cstl-v*`), and upstream Trellis coexistence semantics (0.3.2+).
+
+---
+
+## 1. npm publish runbook (mandatory)
+
+cursor-trellis ships **two** npm packages at the **same version**:
+
+| Package | Role |
+| --- | --- |
+| `@blxzer/cursor-trellis-core` | SDK (must publish **first**) |
+| `@blxzer/cursor-trellis` | CLI (depends on core) |
+
+### Do
+
+```bash
+cd D:\MyHarness\cursor-trellis\packages\cli
+
+# 1. Version parity (cli + core package.json must match)
+cd ../.. && pnpm release:check
+
+# 2. Optional: dry-run pack shape (rewrites workspace:* in tarball)
+node packages/cli/scripts/publish-packages.js --dry-run
+
+# 3. Publish both packages in dependency order
+node packages/cli/scripts/publish-packages.js
+
+# 4. Verify registry visibility
+node packages/cli/scripts/release-preflight.js verify-npm --package all
+```
+
+`publish-packages.js` uses **`pnpm publish`** (not bare `npm publish`). pnpm rewrites `workspace:*` dependencies to the resolved semver (e.g. `"@blxzer/cursor-trellis-core": "0.3.3"`). Bare `npm publish` leaves `workspace:*` in the tarball → **`EUNSUPPORTEDPROTOCOL`** on install.
+
+### Do not
+
+- **`npm publish`** from `packages/cli` alone (0.3.1 incident: cli tarball had `workspace:*`, core was missing).
+- Publish cli before core (cli install fails with ETARGET until core exists).
+- Skip `prepublishOnly` (runs test + build + copy-release-assets on cli).
+
+### Preflight commands
+
+| Command | Purpose |
+| --- | --- |
+| `release-preflight.js check-versions` | cli/core version match |
+| `release-preflight.js verify-packed-cli` | Packed cli resolves core to exact semver (not `workspace:*`) |
+| `release-preflight.js verify-npm` | Post-publish registry check |
+| `release-preflight.js publish-plan` | Idempotent CI plan (skip already-published versions) |
+
+### Withdrawn / deprecated versions
+
+- **0.3.1 cli**: withdrawn (unpublish); use **0.3.2+**.
+- **0.3.1 core**: cannot unpublish (npm policy); **`npm deprecate`** applied — use `@latest`.
+
+---
+
+## 2. Git tags (`cstl-v*` prefix)
+
+This repo shares git history with legacy `@blxzer/trellis` (1.x). Old tags `v0.3.x`–`v0.6.x` point at **trellis** commits, not cursor-trellis releases.
+
+| Tag pattern | Product | Example |
+| --- | --- | --- |
+| `v*` (legacy) | `@blxzer/trellis` | `v0.3.2` @ 2026-03 trellis commit |
+| **`cstl-v*`** | `@blxzer/cursor-trellis` | `cstl-v0.3.2` @ cursor-trellis release commit |
+
+`packages/cli/scripts/release.js` tags releases as **`cstl-v${version}`** (since 0.3.2 tag-hygiene commit).
+
+`release-preflight tagVersionFromEnv` extracts semver from tag suffix (`cstl-v0.3.2` → `0.3.2`).
+
+**CI publish workflow** (`.github/workflows/publish.yml`): triggers on `push.tags: cstl-v*`. Requires repo secret `NPM_TOKEN`.
+
+Do **not** delete legacy `v*` tags — they are historical trellis releases.
+
+---
+
+## 3. Coexistence with upstream mindfold-ai/Trellis
+
+**Product decision**: Both are workflow frameworks. **Cursor configuration belongs to cursor-trellis**. Upstream Trellis keeps `.trellis/` and non-Cursor platform dirs; cursor-trellis uses `.cstl/` + `.cursor/cstl-*`.
+
+### Scenario matrix
+
+| Scenario | User state | Action |
+| --- | --- | --- |
+| 1 Pure cstl | Only cursor-trellis (legacy `.trellis/` runtime) | `cstl update --migrate` → rename `.trellis/` → `.cstl/` |
+| 2 Coexistence | Upstream `.trellis/` + wants Cursor cstl | `cstl init --cursor` → creates `.cstl/`, **takes over `.cursor/`**, AGENTS dual-block |
+| 3 Fresh | Never used either | `cstl init --cursor` → `.cstl/` only |
+
+### `cstl init` coexistence mode
+
+When `.trellis/` exists and `.cstl/` does not:
+
+1. Creates `.cstl/` (does not touch `.trellis/`).
+2. **Force-writes** `.cursor/` (hooks, rules, commands) even under `-y`.
+3. **AGENTS.md dual-block**: preserves `<!-- TRELLIS:START -->`, adds/refreshes `<!-- CSTL:START -->` (`insertCstlManagedBlock`).
+4. Prints banner: do **not** run `cstl update --migrate` (would rename upstream `.trellis/`).
+
+### Migrate gate (`assessCstlDirectoryMigrate`)
+
+Conservative by default for `.trellis/` → `.cstl/` rename:
+
+| Signal | Meaning |
+| --- | --- |
+| F1 | `.cursor/commands/cstl-*.md` |
+| F2 | `.cursor/rules/cstl-triage.mdc` |
+| F3 | `.trellis/scripts/common/cli_adapter.py` contains `cstl` |
+| U1 | `.claude/agents/trellis-implement.md` |
+| U2 | Non-Cursor platform `trellis-*` agents/skills |
+| U4 | `.cursor/commands/trellis-*.md` without cstl fingerprint |
+
+- No F fingerprint → **abort** (protect scenario 2).
+- F + U mixed → **abort** (manual split).
+- Escape: `cstl update --force-cstl-migrate`.
+
+### AGENTS.md hash tracking (block-level)
+
+`.template-hashes.json` stores **CSTL block hash only** for `AGENTS.md`, not the whole file. Upstream edits to TRELLIS block or user content outside CSTL block do **not** trigger "modified" on `cstl update`.
+
+Implementation: `template-hash.ts` → `hashContentForPath` + `extractBlock(CSTL:START/END)`.
+
+### `cstl uninstall` in coexistence repos
+
+- Strips **CSTL block only** (`removeCstlManagedBlock`); keeps TRELLIS block + user content.
+- If file was only the CSTL block → deletes `AGENTS.md`.
+- Does **not** restore upstream `.cursor/` files overwritten during init (by design: cstl owned Cursor).
+
+---
+
+## 4. Post-release dogfood checklist
+
+```bash
+npm install -g @blxzer/cursor-trellis@latest
+cstl --version
+
+# Each dogfood project (no --migrate unless upgrading from pre-0.3.1):
+cd <project>
+cstl update --skip-readiness --skip-all
+# Confirm .cstl/.version matches npm latest
+```
+
+Sandbox smoke (from empty dir):
+
+```bash
+npm init -y && npm install @blxzer/cursor-trellis@latest
+npx cstl init --yes --skip-readiness --cursor
+```
+
+---
+
+## 5. Related files (source of truth)
+
+| Topic | Path |
+| --- | --- |
+| Publish orchestration | `cursor-trellis/packages/cli/scripts/publish-packages.js` |
+| Release preflight | `cursor-trellis/packages/cli/scripts/release-preflight.js` |
+| Tag prefix | `cursor-trellis/packages/cli/scripts/release.js` |
+| Coexistence init | `packages/cli/src/commands/init.ts` |
+| Migrate gate | `packages/cli/src/utils/workflow-ownership.ts` |
+| AGENTS helpers | `packages/cli/src/utils/agents-md.ts` |
+| Block-level hash | `packages/cli/src/utils/template-hash.ts` |
+| Uninstall strip | `packages/cli/src/commands/uninstall.ts` |
+
+---
+
+**Last updated**: 2026-07-04 (0.3.3 follow-up: uninstall CSTL strip + block hash + this guide).

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/index.md.txt

@@ -29,6 +29,7 @@ These guides help you **ask the right questions before coding**.
 | [Cursor subagent policy](./cursor-subagent-policy.md) | Task tool scenes, Agent mode, `model_policy: cursor-configured`, Cursor++ | Parent/Child dispatch, research/implement/check, parallel execution |
 | [Execution strategy](./execution-strategy.md) | `suggest-execution-strategy`, rules JSON, inline vs worker vs child-task | Writing `implement.md` contract, Phase 2 dispatch |
 | [Cursor context injection guide](./cursor-context-injection-guide.md) | Which Cursor channels reach the model (sessionStart bug, .cursor/rules, AGENTS.md) | "Agent ignored instructions" on Cursor, adding always-visible rules |
+| [cursor-trellis release & coexistence](./cursor-trellis-release-coexistence-guide.md) | npm publish runbook, `cstl-v*` tags, upstream Trellis coexistence | Releasing cstl, scenario 2 init, migrate gate, uninstall AGENTS strip |
 
 ---
 

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 -->"