@blxzer/cursor-trellis 0.3.0 → 0.3.3

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).

package/dist/templates/trellis/local/patch_wpelc8.py

@@ -23,7 +23,7 @@ INJECT_NEEDLE = "});return!UbAQWn||"
 def _repo_root(start: Path) -> Path:
     cur = start.resolve()
     for _ in range(12):
-        if (cur / ".trellis").is_dir():
+        if (cur / ".cstl").is_dir():
             return cur
         if cur.parent == cur:
             break
@@ -94,8 +94,8 @@ def resolve_project_models_path(bundle_dir: Path, config: dict) -> Path | None:
         p = Path(config["projectModelsJson"].strip()).expanduser()
         return p if p.is_file() else None
     return _first_existing(
-        root / ".trellis" / "local" / "subagent-models.json5",
-        root / ".trellis" / "local" / "subagent-models.json",
+        root / ".cstl" / "local" / "subagent-models.json5",
+        root / ".cstl" / "local" / "subagent-models.json",
     )
 
 
@@ -167,7 +167,7 @@ def build_inject_block(model_map: dict[str, str]) -> str:
     if not model_map:
         raise SystemExit(
             "model map empty — use skill cstl-cursor2plus-setup or write "
-            "~/.ccursor/trellis-task-models.json5 (see .trellis/local/trellis-task-models.json5.example)"
+            "~/.ccursor/trellis-task-models.json5 (see .cstl/local/trellis-task-models.json5.example)"
         )
     pairs = ",".join(f'"{k}":"{v}"' for k, v in sorted(model_map.items()))
     return (

package/dist/templates/trellis/scripts/add_session.py

@@ -12,11 +12,11 @@ Usage:
     <session content here>
     EOF
 
-Branch resolution order:
-    1. --branch CLI arg (explicit)
-    2. task.json branch field (from selected task)
-    3. git branch --show-current (auto-detect)
-    4. None (omitted gracefully)
+Branch resolution order:
+    1. --branch CLI arg (explicit)
+    2. task.json branch field (from selected task)
+    3. git branch --show-current (auto-detect)
+    4. None (omitted gracefully)
 """
 
 from __future__ import annotations
@@ -28,12 +28,12 @@ from datetime import datetime
 from pathlib import Path
 
 from common.paths import (
-    FILE_JOURNAL_PREFIX,
-    get_repo_root,
-    get_selected_task,
-    get_developer,
-    get_workspace_dir,
-)
+    FILE_JOURNAL_PREFIX,
+    get_repo_root,
+    get_selected_task,
+    get_developer,
+    get_workspace_dir,
+)
 from common.developer import ensure_developer
 from common.git import run_git
 from common.safe_commit import (
@@ -322,11 +322,11 @@ def _auto_commit_workspace(repo_root: Path) -> None:
     """Stage Trellis-owned workspace + task paths and commit.
 
     Path scope is restricted to specific products (journal files, index.md,
-    selected task dirs, the archive subtree). We never `git add` the whole
-    `.trellis/` tree, and if `.gitignore` blocks the specific paths we
+    selected task dirs, the archive subtree). We never `git add` the whole
+    `.cstl/` tree, and if `.gitignore` blocks the specific paths we
     warn + skip — never retry with ``-f``.
 
-    Honors ``session_auto_commit`` in ``.trellis/config.yaml``: when set to
+    Honors ``session_auto_commit`` in ``.cstl/config.yaml``: when set to
     ``false``, this function returns immediately without touching git
     (journal/index files are still written to disk by the caller).
     """
@@ -502,10 +502,10 @@ def main() -> int:
     elif args.stdin:
         extra_content = sys.stdin.read()
 
-    # Load selected task once — shared by package and branch resolution
-    repo_root = get_repo_root()
-    selected = get_selected_task(repo_root)
-    task_data = load_task(repo_root / selected) if selected else None
+    # Load selected task once — shared by package and branch resolution
+    repo_root = get_repo_root()
+    selected = get_selected_task(repo_root)
+    task_data = load_task(repo_root / selected) if selected else None
 
     package = args.package
     if package:
@@ -519,8 +519,8 @@ def main() -> int:
             print(f"Error: unknown package '{package}'. Available: {available}", file=sys.stderr)
             return 1
     else:
-        # Inferred: selected task's task.json.package → default_package → None
-        task_package = task_data.package if task_data else None
+        # Inferred: selected task's task.json.package → default_package → None
+        task_package = task_data.package if task_data else None
         package = resolve_package(task_package, repo_root)
 
     # Resolve branch: CLI → task.json → git auto-detect → None

package/dist/templates/trellis/scripts/common/active_task.py

@@ -2,7 +2,7 @@
 """Session-scoped selected task resolution.
 
 The user-facing concept is a live-session "selected task". Trellis stores that
-pointer per AI session/window under `.trellis/.runtime/sessions/`; without a
+pointer per AI session/window under `.cstl/.runtime/sessions/`; without a
 stable session key there is no selected task.
 """
 
@@ -19,7 +19,7 @@ from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any
 
-DIR_WORKFLOW = ".trellis"
+DIR_WORKFLOW = ".cstl"
 DIR_TASKS = "tasks"
 DIR_RUNTIME = ".runtime"
 DIR_SESSIONS = "sessions"