@blxzer/cursor-trellis 0.3.0 → 0.3.3

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

@@ -2,7 +2,7 @@
 """
 Resolve how to invoke the smart-search CLI (argv prefix for subprocess).
 
-No writes under .trellis/.runtime/. Optional per-machine override:
+No writes under .cstl/.runtime/. Optional per-machine override:
 TRELLIS_SMART_SEARCH_COMMAND or smart_search.command in config.yaml.
 """
 

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

@@ -15,7 +15,7 @@ from typing import Literal
 from .io import read_json
 from .paths import FILE_TASK_JSON
 
-DIR_WORKFLOW = ".trellis"
+DIR_WORKFLOW = ".cstl"
 DIR_SPEC = "spec"
 
 AGENT_IMPLEMENT = "cstl-implement"
@@ -369,7 +369,7 @@ Conversations get compacted; files do not. Every research topic MUST be written
 
 ## Write FORBIDDEN
 
-- Code, `.trellis/spec/`, platform config, git operations"""
+- Code, `.cstl/spec/`, platform config, git operations"""
 
 
 def _repo_relative(task_dir: Path, repo_root: Path) -> str:

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

@@ -11,7 +11,7 @@ Note:
     ``cmd_init_context`` was removed in v0.5.0-beta.12. JSONL context files
     are now seeded at ``task.py create`` time with a self-describing
     ``_example`` line; the AI agent curates real entries during planning when
-    the task needs sub-agent/spec context. See ``.trellis/workflow.md`` for the
+    the task needs sub-agent/spec context. See ``.cstl/workflow.md`` for the
     current planning artifact contract.
 """
 

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

@@ -1,140 +1,140 @@
-#!/usr/bin/env python3
-"""Task dashboard rendering for framework entry routing."""
-
-from __future__ import annotations
-
-from pathlib import Path
-
-from .active_task import resolve_selected_task
-from .paths import DIR_TASKS, DIR_WORKFLOW, get_developer, get_repo_root, get_tasks_dir
-from .task_map import get_child_state
-from .tasks import (
-    children_progress,
-    format_child_task_display,
-    iter_active_tasks,
-    load_parent_child_integration_states,
-)
-
-
-_STATUS_ORDER = ("planning", "in_progress", "review", "blocked")
-
-
-def _task_path(dir_name: str) -> str:
-    return f"{DIR_WORKFLOW}/{DIR_TASKS}/{dir_name}"
-
-
-def _selected_line(
-    repo_root: Path,
-    platform_input: dict | None = None,
-    platform: str | None = None,
-) -> str:
-    selected = resolve_selected_task(repo_root, platform_input, platform)
-    if selected.task_path:
-        suffix = f" ({selected.source})" if selected.source else ""
-        return f"Selected task: {selected.task_path}{suffix}"
-    return (
-        "Selected task: none "
-        "(no session pointer — use task.py select <task> or task.py list)"
-    )
-
-
-def render_task_dashboard(
-    repo_root: Path | None = None,
-    platform_input: dict | None = None,
-    platform: str | None = None,
-) -> str:
-    """Render a compact, non-mutating Task Dashboard."""
-    if repo_root is None:
-        repo_root = get_repo_root()
-
-    tasks_dir = get_tasks_dir(repo_root)
-    developer = get_developer(repo_root)
-    all_tasks = {task.dir_name: task for task in iter_active_tasks(tasks_dir)}
-    all_statuses = {name: task.status for name, task in all_tasks.items()}
-
-    lines: list[str] = [
-        "Task Dashboard",
-        "Trellis framework: active",
-        _selected_line(repo_root, platform_input, platform),
-        "",
-    ]
-
-    if not all_tasks:
-        lines.append("Tasks: none")
-    else:
-        printed: set[str] = set()
-        for status in _STATUS_ORDER:
-            names = [
-                name
-                for name, task in sorted(all_tasks.items())
-                if task.status == status and not task.parent
-            ]
-            if not names:
-                continue
-            title = status.replace("_", " ").title()
-            lines.append(f"{title}:")
-            for name in names:
-                _append_task(lines, name, all_tasks, all_statuses, printed)
-            lines.append("")
-
-        other_names = [
-            name
-            for name, task in sorted(all_tasks.items())
-            if name not in printed and not task.parent
-        ]
-        if other_names:
-            lines.append("Other:")
-            for name in other_names:
-                _append_task(lines, name, all_tasks, all_statuses, printed)
-            lines.append("")
-
-    lines.append("Suggested actions:")
-    lines.append("  - Select a task: python ./.trellis/scripts/task.py select <task>")
-    lines.append("  - Create a task: python ./.trellis/scripts/task.py create \"<title>\" --slug <slug>")
-    lines.append("  - Inspect raw list: python ./.trellis/scripts/task.py list")
-    lines.append("  - Continue without a task only for No Task or Micro-Grill work")
-    if developer:
-        lines.append(f"Developer: {developer}")
-
-    return "\n".join(line.rstrip() for line in lines).rstrip()
-
-
-def _append_task(
-    lines: list[str],
-    name: str,
-    all_tasks: dict,
-    all_statuses: dict[str, str],
-    printed: set[str],
-    indent: int = 0,
-    parent_dir: Path | None = None,
-) -> None:
-    task = all_tasks[name]
-    printed.add(name)
-    integration_states = None
-    if task.children:
-        integration_states = load_parent_child_integration_states(
-            task.directory, task.children
-        )
-    progress = children_progress(
-        task.children, all_statuses, integration_states
-    )
-    integration_state = None
-    if parent_dir is not None:
-        integration_state = get_child_state(parent_dir, name)
-    status_display = format_child_task_display(task.status, integration_state)
-    assignee = task.assignee or "-"
-    prefix = "  " * indent + "  - "
-    lines.append(
-        f"{prefix}{_task_path(name)} ({status_display}){progress} [{assignee}]"
-    )
-    for child_name in task.children:
-        if child_name in all_tasks:
-            _append_task(
-                lines,
-                child_name,
-                all_tasks,
-                all_statuses,
-                printed,
-                indent + 1,
-                parent_dir=task.directory,
-            )
+#!/usr/bin/env python3
+"""Task dashboard rendering for framework entry routing."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from .active_task import resolve_selected_task
+from .paths import DIR_TASKS, DIR_WORKFLOW, get_developer, get_repo_root, get_tasks_dir
+from .task_map import get_child_state
+from .tasks import (
+    children_progress,
+    format_child_task_display,
+    iter_active_tasks,
+    load_parent_child_integration_states,
+)
+
+
+_STATUS_ORDER = ("planning", "in_progress", "review", "blocked")
+
+
+def _task_path(dir_name: str) -> str:
+    return f"{DIR_WORKFLOW}/{DIR_TASKS}/{dir_name}"
+
+
+def _selected_line(
+    repo_root: Path,
+    platform_input: dict | None = None,
+    platform: str | None = None,
+) -> str:
+    selected = resolve_selected_task(repo_root, platform_input, platform)
+    if selected.task_path:
+        suffix = f" ({selected.source})" if selected.source else ""
+        return f"Selected task: {selected.task_path}{suffix}"
+    return (
+        "Selected task: none "
+        "(no session pointer — use task.py select <task> or task.py list)"
+    )
+
+
+def render_task_dashboard(
+    repo_root: Path | None = None,
+    platform_input: dict | None = None,
+    platform: str | None = None,
+) -> str:
+    """Render a compact, non-mutating Task Dashboard."""
+    if repo_root is None:
+        repo_root = get_repo_root()
+
+    tasks_dir = get_tasks_dir(repo_root)
+    developer = get_developer(repo_root)
+    all_tasks = {task.dir_name: task for task in iter_active_tasks(tasks_dir)}
+    all_statuses = {name: task.status for name, task in all_tasks.items()}
+
+    lines: list[str] = [
+        "Task Dashboard",
+        "Trellis framework: active",
+        _selected_line(repo_root, platform_input, platform),
+        "",
+    ]
+
+    if not all_tasks:
+        lines.append("Tasks: none")
+    else:
+        printed: set[str] = set()
+        for status in _STATUS_ORDER:
+            names = [
+                name
+                for name, task in sorted(all_tasks.items())
+                if task.status == status and not task.parent
+            ]
+            if not names:
+                continue
+            title = status.replace("_", " ").title()
+            lines.append(f"{title}:")
+            for name in names:
+                _append_task(lines, name, all_tasks, all_statuses, printed)
+            lines.append("")
+
+        other_names = [
+            name
+            for name, task in sorted(all_tasks.items())
+            if name not in printed and not task.parent
+        ]
+        if other_names:
+            lines.append("Other:")
+            for name in other_names:
+                _append_task(lines, name, all_tasks, all_statuses, printed)
+            lines.append("")
+
+    lines.append("Suggested actions:")
+    lines.append("  - Select a task: python ./.cstl/scripts/task.py select <task>")
+    lines.append("  - Create a task: python ./.cstl/scripts/task.py create \"<title>\" --slug <slug>")
+    lines.append("  - Inspect raw list: python ./.cstl/scripts/task.py list")
+    lines.append("  - Continue without a task only for No Task or Micro-Grill work")
+    if developer:
+        lines.append(f"Developer: {developer}")
+
+    return "\n".join(line.rstrip() for line in lines).rstrip()
+
+
+def _append_task(
+    lines: list[str],
+    name: str,
+    all_tasks: dict,
+    all_statuses: dict[str, str],
+    printed: set[str],
+    indent: int = 0,
+    parent_dir: Path | None = None,
+) -> None:
+    task = all_tasks[name]
+    printed.add(name)
+    integration_states = None
+    if task.children:
+        integration_states = load_parent_child_integration_states(
+            task.directory, task.children
+        )
+    progress = children_progress(
+        task.children, all_statuses, integration_states
+    )
+    integration_state = None
+    if parent_dir is not None:
+        integration_state = get_child_state(parent_dir, name)
+    status_display = format_child_task_display(task.status, integration_state)
+    assignee = task.assignee or "-"
+    prefix = "  " * indent + "  - "
+    lines.append(
+        f"{prefix}{_task_path(name)} ({status_display}){progress} [{assignee}]"
+    )
+    for child_name in task.children:
+        if child_name in all_tasks:
+            _append_task(
+                lines,
+                child_name,
+                all_tasks,
+                all_statuses,
+                printed,
+                indent + 1,
+                parent_dir=task.directory,
+            )

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

@@ -1150,7 +1150,7 @@ def durable_learning_decision_status(content: str) -> dict[str, bool]:
 def suggest_spec_targets(repo_root: Path, task_dir: Path, task_data: dict) -> list[str]:
     """Suggest existing spec paths from task scope; does not invent new rules."""
     suggestions: list[str] = []
-    spec_root = repo_root / ".trellis" / "spec"
+    spec_root = repo_root / ".cstl" / "spec"
     if not spec_root.is_dir():
         return suggestions
 
@@ -1158,7 +1158,7 @@ def suggest_spec_targets(repo_root: Path, task_dir: Path, task_data: dict) -> li
     if isinstance(package, str) and package.strip():
         pkg_index = spec_root / package.strip() / "index.md"
         if pkg_index.is_file():
-            suggestions.append(f".trellis/spec/{package.strip()}/index.md")
+            suggestions.append(f".cstl/spec/{package.strip()}/index.md")
 
     scope = task_data.get("scope")
     if isinstance(scope, str) and scope.strip():
@@ -1168,7 +1168,7 @@ def suggest_spec_targets(repo_root: Path, task_dir: Path, task_data: dict) -> li
             index = scope_path / "index.md"
             if index.is_file():
                 suggestions.append(
-                    f".trellis/spec/{scope_path.relative_to(spec_root).as_posix()}/index.md"
+                    f".cstl/spec/{scope_path.relative_to(spec_root).as_posix()}/index.md"
                 )
 
     guide_paths = (
@@ -1178,7 +1178,7 @@ def suggest_spec_targets(repo_root: Path, task_dir: Path, task_data: dict) -> li
     for rel in guide_paths:
         path = spec_root / rel
         if path.is_file():
-            suggestions.append(f".trellis/spec/{rel}")
+            suggestions.append(f".cstl/spec/{rel}")
 
     return _dedupe_preserve_order(suggestions)[:6]
 
@@ -1192,7 +1192,7 @@ def build_spec_update_scaffold(
 ) -> str:
     """Markdown checklist for spec capture; user/reviewer must confirm before editing specs."""
     targets = suggest_spec_targets(repo_root, task_dir, task_data)
-    rel_task = f".trellis/tasks/{task_dir.name}"
+    rel_task = f".cstl/tasks/{task_dir.name}"
     lines = [
         "## Spec update scaffold (reviewer-confirmed)",
         "",
@@ -1205,7 +1205,7 @@ def build_spec_update_scaffold(
         [
             "1. Decide outcome in verify.md:",
             "   - Routine: `Durable learning decision: no durable learning`",
-            "   - Reusable insight: `Spec update evidence: .trellis/spec/<path>` after edits",
+            "   - Reusable insight: `Spec update evidence: .cstl/spec/<path>` after edits",
             f"   - Already documented: `Learning artifact: {rel_task}/handoff.md`",
             "",
             "2. Use `/cstl:update-spec` or `/cstl:break-loop` for depth; never auto-write specs.",
@@ -1219,11 +1219,11 @@ def build_spec_update_scaffold(
         lines.append("")
     else:
         lines.append(
-            "3. Browse `.trellis/spec/<package-or-layer>/index.md` for the right code-spec file."
+            "3. Browse `.cstl/spec/<package-or-layer>/index.md` for the right code-spec file."
         )
         lines.append("")
     lines.append(
-        "4. Re-run `python ./.trellis/scripts/task.py archive <task> --check` after verify.md is final."
+        "4. Re-run `python ./.cstl/scripts/task.py archive <task> --check` after verify.md is final."
     )
     lines.append("")
     return "\n".join(lines)
@@ -1233,13 +1233,13 @@ def _learning_decision_draft_lines(task_dir: Path, task_data: dict) -> list[str]
     """Default durable-learning block for prepare-archive-evidence."""
     repo_root = task_dir.parent.parent.parent
     targets = suggest_spec_targets(repo_root, task_dir, task_data)
-    target_hint = targets[0] if targets else ".trellis/spec/<layer>/index.md"
+    target_hint = targets[0] if targets else ".cstl/spec/<layer>/index.md"
     return [
         "Durable learning decision: no durable learning for this task scope.",
         "",
         "# Replace the line above with ONE of these before archive:",
         f"# Spec update evidence: {target_hint}",
-        f"# Learning artifact: .trellis/tasks/{task_dir.name}/handoff.md",
+        f"# Learning artifact: .cstl/tasks/{task_dir.name}/handoff.md",
         "# Spec update needed: (brief reason) — then run /cstl:update-spec and point Spec update evidence at the edited file",
         "",
     ]
@@ -1268,12 +1268,12 @@ def archive_repair_hints(
     """Map archive validation errors to actionable next-step hints."""
     hints: list[str] = []
     task_ref = task_dir.name
-    rel_task = f".trellis/tasks/{task_ref}"
+    rel_task = f".cstl/tasks/{task_ref}"
 
     for error in errors:
         if error == "verify.md":
             hints.append(
-                f"Create verify.md, then run: python ./.trellis/scripts/task.py "
+                f"Create verify.md, then run: python ./.cstl/scripts/task.py "
                 f"prepare-archive-evidence {rel_task}"
             )
             continue
@@ -1281,7 +1281,7 @@ def archive_repair_hints(
             hints.append(
                 "Add a grep-friendly line such as "
                 "'Validation commands: <command> — <outcome>' to verify.md, "
-                f"or run: python ./.trellis/scripts/task.py prepare-archive-evidence {rel_task}"
+                f"or run: python ./.cstl/scripts/task.py prepare-archive-evidence {rel_task}"
             )
             continue
         if error == "verify.md missing final acceptance evidence":
@@ -1295,9 +1295,9 @@ def archive_repair_hints(
             hints.append(
                 "Durable learning decision (pick one grep-friendly line in verify.md): "
                 "'Durable learning decision: no durable learning' for routine work; "
-                "'Spec update evidence: .trellis/spec/<path>' after /cstl:update-spec; "
+                "'Spec update evidence: .cstl/spec/<path>' after /cstl:update-spec; "
                 "'Learning artifact: <path>' when handoff/retrospective already captures the insight. "
-                f"Or run: python ./.trellis/scripts/task.py prepare-archive-evidence {rel_task}"
+                f"Or run: python ./.cstl/scripts/task.py prepare-archive-evidence {rel_task}"
             )
             continue
         if error == "verify.md missing final integration evidence":
@@ -1313,21 +1313,21 @@ def archive_repair_hints(
             if transition == "parent-integrated":
                 hints.append(
                     f"Parent archive needs record-gate for parent-integrated/{gate}: "
-                    f"python ./.trellis/scripts/task.py record-gate {rel_task} "
+                    f"python ./.cstl/scripts/task.py record-gate {rel_task} "
                     f"--transition parent-integrated --gate {gate} --result PASS "
                     f"--reviewer parent --evidence task-map.md"
                 )
             elif transition == "child-review":
                 hints.append(
                     f"Full Child acceptance needs record-gate for child-review/{gate}: "
-                    f"python ./.trellis/scripts/task.py record-gate {rel_task} "
+                    f"python ./.cstl/scripts/task.py record-gate {rel_task} "
                     f"--transition child-review --gate {gate} --result PASS "
                     f"--reviewer parent --evidence verify.md"
                 )
             else:
                 hints.append(
                     f"Record reviewer gate after explicit review (never auto-PASS): "
-                    f"python ./.trellis/scripts/task.py record-gate {rel_task} "
+                    f"python ./.cstl/scripts/task.py record-gate {rel_task} "
                     f"--transition {transition} --gate {gate} --result PASS "
                     f"--reviewer <reviewer-id> --evidence verify.md"
                 )
@@ -1376,7 +1376,7 @@ def archive_repair_hints(
 
     if not hints and not guard.ok:
         hints.append(
-            f"Run: python ./.trellis/scripts/task.py prepare-archive-evidence {rel_task} "
+            f"Run: python ./.cstl/scripts/task.py prepare-archive-evidence {rel_task} "
             "then archive --check again."
         )
 
@@ -1454,7 +1454,7 @@ def build_archive_evidence_draft(
         )
 
     if guard.is_full_task and guard.required_gates:
-        rel_task = f".trellis/tasks/{task_dir.name}"
+        rel_task = f".cstl/tasks/{task_dir.name}"
         lines.extend(
             [
                 "## Completion gate preparation (not recorded)",
@@ -1465,7 +1465,7 @@ def build_archive_evidence_draft(
         )
         for gate in guard.required_gates:
             lines.append(
-                f"- `python ./.trellis/scripts/task.py record-gate {rel_task} "
+                f"- `python ./.cstl/scripts/task.py record-gate {rel_task} "
                 f"--transition full-task-complete --gate {gate} --result PASS "
                 f"--reviewer <reviewer-id> --evidence verify.md`"
             )
@@ -1900,7 +1900,7 @@ def start_execution_repair_hints(
 ) -> list[str]:
     """Map start-execution validation errors to actionable planning hints."""
     hints: list[str] = []
-    rel_task = f".trellis/tasks/{task_dir.name}"
+    rel_task = f".cstl/tasks/{task_dir.name}"
     for error in errors:
         if error.startswith("missing gate record:"):
             _rest = error.split(":", 1)[1].strip()
@@ -1913,7 +1913,7 @@ def start_execution_repair_hints(
                 )
             else:
                 hints.append(
-                    f"python ./.trellis/scripts/task.py record-gate {rel_task} "
+                    f"python ./.cstl/scripts/task.py record-gate {rel_task} "
                     f"--transition start-execution --gate {gate} --result PASS "
                     f"--reviewer <reviewer-id> --evidence verify.md"
                 )

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

@@ -203,7 +203,7 @@ def _non_trellis_dirty_paths(repo_root: Path) -> list[str]:
         if " -> " in path:
             path = path.split(" -> ", 1)[1].strip()
         path = path.replace("\\", "/").strip('"')
-        if path and path != ".trellis" and not path.startswith(".trellis/"):
+        if path and path != ".cstl" and not path.startswith(".cstl/"):
             dirty.append(path)
     return dirty
 
@@ -252,7 +252,7 @@ _SUBAGENT_CONFIG_DIRS: tuple[str, ...] = (
 _SEED_EXAMPLE = (
     "Fill with {\"file\": \"<path>\", \"reason\": \"<why>\"}. "
     "Put spec/research files only — no code paths. "
-    "Run `python .trellis/scripts/get_context.py --mode packages` to list available specs. "
+    "Run `python .cstl/scripts/get_context.py --mode packages` to list available specs. "
     "Delete this line once real entries are added."
 )
 
@@ -460,7 +460,7 @@ def cmd_create(args: argparse.Namespace) -> int:
     print("", file=sys.stderr)
     print(colored("Next steps:", Colors.BLUE), file=sys.stderr)
     print("  - Fill prd.md with requirements and acceptance criteria", file=sys.stderr)
-    print(f"  - Select it when ready: python ./.trellis/scripts/task.py select {DIR_WORKFLOW}/{DIR_TASKS}/{dir_name}", file=sys.stderr)
+    print(f"  - Select it when ready: python ./.cstl/scripts/task.py select {DIR_WORKFLOW}/{DIR_TASKS}/{dir_name}", file=sys.stderr)
     print("  - Lightweight task: PRD-only is valid", file=sys.stderr)
     print("  - Complex task: add design.md and implement.md before task.py start-execution --check", file=sys.stderr)
     if seeded_jsonl:
@@ -806,10 +806,10 @@ def _auto_commit_archive(
 
     If ``.gitignore`` blocks the paths, we warn + skip — we do NOT
     retry with ``git add -f``. The warning explicitly forbids
-    ``git add -f .trellis/`` (which would fan out to caches/backups)
+    ``git add -f .cstl/`` (which would fan out to caches/backups)
     and points users at ``session_auto_commit: false``.
 
-    Honors ``session_auto_commit`` in ``.trellis/config.yaml``: when
+    Honors ``session_auto_commit`` in ``.cstl/config.yaml``: when
     set to ``false``, this function returns immediately without
     touching git (the archive directory move on disk is unaffected).
     """

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

@@ -176,7 +176,7 @@ def resolve_task_dir(target_dir: str, repo_root: Path) -> Path:
 
     Supports:
     - Absolute path: /path/to/task
-    - Relative path: .trellis/tasks/01-31-my-task
+    - Relative path: .cstl/tasks/01-31-my-task
     - Task name: my-task (uses find_task_by_name for lookup)
 
     Args:
@@ -198,7 +198,7 @@ def resolve_task_dir(target_dir: str, repo_root: Path) -> Path:
         return Path(target_dir)
 
     # Relative path (contains path separator or starts with .trellis)
-    if "/" in normalized or normalized.startswith(".trellis"):
+    if "/" in normalized or normalized.startswith(".cstl"):
         return repo_root / Path(normalized)
 
     # Task name - try to find in tasks directory
@@ -270,5 +270,5 @@ if __name__ == "__main__":
     tasks = get_tasks_dir(repo)
 
     print(f"Tasks dir: {tasks}")
-    print(f"is_safe_task_path('.trellis/tasks/test'): {is_safe_task_path('.trellis/tasks/test', repo)}")
+    print(f"is_safe_task_path('.cstl/tasks/test'): {is_safe_task_path('.cstl/tasks/test', repo)}")
     print(f"is_safe_task_path('../test'): {is_safe_task_path('../test', repo)}")

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

@@ -226,6 +226,6 @@ def parent_archive_child_followup_hint(
     return (
         f"Integrated child task dirs still active: {names}. "
         "Archive each child when ready: "
-        f"python ./.trellis/scripts/task.py archive <child> "
+        f"python ./.cstl/scripts/task.py archive <child> "
         "(or parent archive with --archive-integrated-children after archive --check passes for each)."
     )

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 """
-Standalone reader for .trellis/config.yaml.
+Standalone reader for .cstl/config.yaml.
 
 Mirrors a minimal subset of common.config so callers (hooks, workflow_phase)
 can read configuration without importing the full task/repo helpers. Returns
@@ -13,7 +13,7 @@ from pathlib import Path
 from typing import Optional
 
 
-CONFIG_REL_PATH = ".trellis/config.yaml"
+CONFIG_REL_PATH = ".cstl/config.yaml"
 
 
 def _unquote(value: str) -> str:
@@ -117,7 +117,7 @@ def parse_simple_yaml(content: str) -> dict:
 
 
 def read_trellis_config(repo_root: Optional[Path] = None) -> dict:
-    """Read .trellis/config.yaml. Returns {} on missing or malformed file."""
+    """Read .cstl/config.yaml. Returns {} on missing or malformed file."""
     root = repo_root or Path.cwd()
     config_file = root / CONFIG_REL_PATH
     try:

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

@@ -3,7 +3,7 @@
 """
 Workflow Phase Extraction.
 
-Extracts step-level content from .trellis/workflow.md and optionally filters
+Extracts step-level content from .cstl/workflow.md and optionally filters
 platform-specific blocks.
 
 Platform marker syntax in workflow.md:

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

@@ -76,10 +76,10 @@ def _probe_grep(repo_root: Path) -> dict[str, object]:
     """P-01: Grep a known literal in a known file under the repo.
 
     Known answer: 'TRELLIS_B2_WPeLc8' must appear in
-    .trellis/local/cursor2plus/patch_wpelc8.py (the MARKER constant).
+    .cstl/local/cursor2plus/patch_wpelc8.py (the MARKER constant).
     """
     marker = "TRELLIS_B2_WPeLc8"
-    target = repo_root / ".trellis" / "local" / "cursor2plus" / "patch_wpelc8.py"
+    target = repo_root / ".cstl" / "local" / "cursor2plus" / "patch_wpelc8.py"
     ok_file = target.is_file()
     found = False
     matches: list[str] = []
@@ -172,7 +172,7 @@ def _probe_smart_search(repo_root: Path) -> dict[str, object]:
     argv without running a network search. A separate `doctor` invocation is
     attempted if the resolved entrypoint is the smart-search package CLI.
     """
-    scripts_dir = repo_root / ".trellis" / "scripts"
+    scripts_dir = repo_root / ".cstl" / "scripts"
     if str(scripts_dir) not in sys.path:
         sys.path.insert(0, str(scripts_dir))
     resolved: list[str] | None = None