@blxzer/cursor-trellis 0.2.9 → 0.3.2

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

@@ -22,7 +22,7 @@ from pathlib import Path
 # =============================================================================
 
 # Directory names
-DIR_WORKFLOW = ".trellis"
+DIR_WORKFLOW = ".cstl"
 DIR_WORKSPACE = "workspace"
 DIR_TASKS = "tasks"
 DIR_ARCHIVE = "archive"
@@ -41,7 +41,7 @@ FILE_JOURNAL_PREFIX = "journal-"
 # =============================================================================
 
 def get_repo_root(start_path: Path | None = None) -> Path:
-    """Find the nearest directory containing .trellis/ folder.
+    """Find the nearest directory containing .cstl/ folder.
 
     This handles nested git repos correctly (e.g., test project inside another repo).
 
@@ -49,7 +49,7 @@ def get_repo_root(start_path: Path | None = None) -> Path:
         start_path: Starting directory to search from. Defaults to current directory.
 
     Returns:
-        Path to repository root, or current directory if no .trellis/ found.
+        Path to repository root, or current directory if no .cstl/ found.
     """
     current = (start_path or Path.cwd()).resolve()
 
@@ -58,7 +58,7 @@ def get_repo_root(start_path: Path | None = None) -> Path:
             return current
         current = current.parent
 
-    # Fallback to current directory if no .trellis/ found
+    # Fallback to current directory if no .cstl/ found
     return Path.cwd().resolve()
 
 
@@ -204,14 +204,14 @@ def count_lines(file_path: Path) -> int:
 
 
 # =============================================================================
-# Selected Task Management
+# Selected Task Management
 # =============================================================================
 
-def normalize_task_ref(task_ref: str) -> str:
+def normalize_task_ref(task_ref: str) -> str:
     """Normalize a task ref for stable runtime storage.
 
     Stored refs should prefer repo-relative POSIX paths like
-    `.trellis/tasks/03-27-my-task`, even on Windows. Absolute paths are preserved
+    `.cstl/tasks/03-27-my-task`, even on Windows. Absolute paths are preserved
     unless they can later be converted back to repo-relative form by callers.
     """
     normalized = task_ref.strip()
@@ -251,70 +251,70 @@ def resolve_task_ref(task_ref: str, repo_root: Path | None = None) -> Path | Non
     return repo_root / DIR_WORKFLOW / DIR_TASKS / path_obj
 
 
-def get_selected_task(
-    repo_root: Path | None = None,
-    platform_input: dict | None = None,
-    platform: str | None = None,
-) -> str | None:
-    """Get selected task directory path (relative to repo_root).
-
-    Args:
-        repo_root: Repository root path. Defaults to auto-detected.
-
-    Returns:
-        Relative path to selected task directory or None.
-    """
-    if repo_root is None:
-        repo_root = get_repo_root()
-
-    from .active_task import resolve_selected_task
-
-    return resolve_selected_task(repo_root, platform_input, platform).task_path
-
-
-def get_selected_task_abs(
-    repo_root: Path | None = None,
-    platform_input: dict | None = None,
-    platform: str | None = None,
-) -> Path | None:
-    """Get selected task directory absolute path.
-
-    Args:
-        repo_root: Repository root path. Defaults to auto-detected.
-
-    Returns:
-        Absolute path to selected task directory or None.
-    """
-    if repo_root is None:
-        repo_root = get_repo_root()
-
-    relative = get_selected_task(repo_root, platform_input, platform)
-    if relative:
-        return resolve_task_ref(relative, repo_root)
-    return None
-
-
-def get_selected_task_source(
-    repo_root: Path | None = None,
-    platform_input: dict | None = None,
-    platform: str | None = None,
-) -> tuple[str, str | None, str | None]:
-    """Get selected task source as (`source`, `context_key`, `task_path`)."""
-    if repo_root is None:
-        repo_root = get_repo_root()
-
-    from .active_task import get_selected_task_source as _get_source
-
-    return _get_source(repo_root, platform_input, platform)
-
-
-def set_selected_task(
-    task_path: str,
-    repo_root: Path | None = None,
-    platform_input: dict | None = None,
-    platform: str | None = None,
-) -> bool:
-    """Set selected task in session scope.
+def get_selected_task(
+    repo_root: Path | None = None,
+    platform_input: dict | None = None,
+    platform: str | None = None,
+) -> str | None:
+    """Get selected task directory path (relative to repo_root).
+
+    Args:
+        repo_root: Repository root path. Defaults to auto-detected.
+
+    Returns:
+        Relative path to selected task directory or None.
+    """
+    if repo_root is None:
+        repo_root = get_repo_root()
+
+    from .active_task import resolve_selected_task
+
+    return resolve_selected_task(repo_root, platform_input, platform).task_path
+
+
+def get_selected_task_abs(
+    repo_root: Path | None = None,
+    platform_input: dict | None = None,
+    platform: str | None = None,
+) -> Path | None:
+    """Get selected task directory absolute path.
+
+    Args:
+        repo_root: Repository root path. Defaults to auto-detected.
+
+    Returns:
+        Absolute path to selected task directory or None.
+    """
+    if repo_root is None:
+        repo_root = get_repo_root()
+
+    relative = get_selected_task(repo_root, platform_input, platform)
+    if relative:
+        return resolve_task_ref(relative, repo_root)
+    return None
+
+
+def get_selected_task_source(
+    repo_root: Path | None = None,
+    platform_input: dict | None = None,
+    platform: str | None = None,
+) -> tuple[str, str | None, str | None]:
+    """Get selected task source as (`source`, `context_key`, `task_path`)."""
+    if repo_root is None:
+        repo_root = get_repo_root()
+
+    from .active_task import get_selected_task_source as _get_source
+
+    return _get_source(repo_root, platform_input, platform)
+
+
+def set_selected_task(
+    task_path: str,
+    repo_root: Path | None = None,
+    platform_input: dict | None = None,
+    platform: str | None = None,
+) -> bool:
+    """Set selected task in session scope.
 
     Args:
         task_path: Task directory path (relative to repo_root).
@@ -326,22 +326,22 @@ def set_selected_task(
     if repo_root is None:
         repo_root = get_repo_root()
 
-    from .active_task import set_selected_task as _set_selected_task
-
-    return _set_selected_task(
-        task_path,
-        repo_root,
-        platform_input=platform_input,
+    from .active_task import set_selected_task as _set_selected_task
+
+    return _set_selected_task(
+        task_path,
+        repo_root,
+        platform_input=platform_input,
         platform=platform,
     ) is not None
 
 
-def clear_selected_task(
-    repo_root: Path | None = None,
-    platform_input: dict | None = None,
-    platform: str | None = None,
-) -> bool:
-    """Clear selected task in session scope.
+def clear_selected_task(
+    repo_root: Path | None = None,
+    platform_input: dict | None = None,
+    platform: str | None = None,
+) -> bool:
+    """Clear selected task in session scope.
 
     Args:
         repo_root: Repository root path. Defaults to auto-detected.
@@ -352,36 +352,36 @@ def clear_selected_task(
     if repo_root is None:
         repo_root = get_repo_root()
 
-    from .active_task import clear_selected_task as _clear_selected_task
-
-    _clear_selected_task(
-        repo_root,
-        platform_input=platform_input,
-        platform=platform,
+    from .active_task import clear_selected_task as _clear_selected_task
+
+    _clear_selected_task(
+        repo_root,
+        platform_input=platform_input,
+        platform=platform,
     )
     return True
 
 
-def has_selected_task(repo_root: Path | None = None) -> bool:
-    """Check if a selected task exists.
+def has_selected_task(repo_root: Path | None = None) -> bool:
+    """Check if a selected task exists.
 
     Args:
         repo_root: Repository root path. Defaults to auto-detected.
 
     Returns:
-        True if selected task is set.
-    """
-    return get_selected_task(repo_root) is not None
-
-
-# Internal compatibility aliases. New user-facing code should use selected-task
-# names; existing internal helpers can migrate incrementally.
-get_current_task = get_selected_task
-get_current_task_abs = get_selected_task_abs
-get_current_task_source = get_selected_task_source
-set_current_task = set_selected_task
-clear_current_task = clear_selected_task
-has_current_task = has_selected_task
+        True if selected task is set.
+    """
+    return get_selected_task(repo_root) is not None
+
+
+# Internal compatibility aliases. New user-facing code should use selected-task
+# names; existing internal helpers can migrate incrementally.
+get_current_task = get_selected_task
+get_current_task_abs = get_selected_task_abs
+get_current_task_source = get_selected_task_source
+set_current_task = set_selected_task
+clear_current_task = clear_selected_task
+has_current_task = has_selected_task
 
 
 # =============================================================================
@@ -405,8 +405,8 @@ def generate_task_date_prefix() -> str:
 def get_spec_dir(package: str | None = None, repo_root: Path | None = None) -> Path:
     """Get the spec directory path.
 
-    Single-repo: .trellis/spec
-    Monorepo with package: .trellis/spec/<package>
+    Single-repo: .cstl/spec
+    Monorepo with package: .cstl/spec/<package>
 
     Uses lazy import to avoid circular dependency with config.py.
     """
@@ -454,4 +454,4 @@ if __name__ == "__main__":
     print(f"Tasks dir: {get_tasks_dir(repo)}")
     print(f"Workspace dir: {get_workspace_dir(repo)}")
     print(f"Journal file: {get_active_journal_file(repo)}")
-    print(f"Selected task: {get_selected_task(repo)}")
+    print(f"Selected task: {get_selected_task(repo)}")

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

@@ -12,7 +12,7 @@ DEFAULT_LARGE_PROJECT_THRESHOLD = 2000
 _SKIP_DIR_NAMES = frozenset(
     {
         ".git",
-        ".trellis",
+        ".cstl",
         ".venv",
         "venv",
         "node_modules",

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

@@ -181,7 +181,7 @@ def _cursor_step_for_route(
 
     if route_id == "policy-docs-rg" or str(route.get("sourceFamily")) == "policy-docs":
         return (
-            "使用 **Grep** 在 `AGENTS.md`、`**/AGENTS.md`、`.trellis/spec`、`README.md` "
+            "使用 **Grep** 在 `AGENTS.md`、`**/AGENTS.md`、`.cstl/spec`、`README.md` "
             "中搜索策略/边界关键词。"
         )
 

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

@@ -3,24 +3,24 @@ Safe git-add helpers for Trellis-owned paths.
 
 Why this module exists
 ----------------------
-A real user incident: a project's `.gitignore` listed `.trellis/` (company-wide
+A real user incident: a project's `.gitignore` listed `.cstl/` (company-wide
 template / personal habit). When `add_session.py` and `task.py archive` ran
 their auto-commit and `git add` failed with `ignored by .gitignore`, the AI
 agent driving the workflow "fixed" it by retrying with
-`git add -f .trellis/` — which fan-out-included every ignored subtree
-(`.trellis/.backup-*/`, `.trellis/worktrees/`, `.trellis/.template-hashes.json`,
-`.trellis/.runtime/`), committing 548 files / 83474 lines of caches/backups.
+`git add -f .cstl/` — which fan-out-included every ignored subtree
+(`.cstl/.backup-*/`, `.cstl/worktrees/`, `.cstl/.template-hashes.json`,
+`.cstl/.runtime/`), committing 548 files / 83474 lines of caches/backups.
 
 Design
 ------
 - Scripts only stage SPECIFIC product paths (journal files, index.md, the
-  current task dir, the archive dir). Never the whole `.trellis/` tree.
+  current task dir, the archive dir). Never the whole `.cstl/` tree.
 - If plain `git add <specific>` fails with "ignored by", DO NOT retry with
-  ``-f``. The presence of `.trellis/` in `.gitignore` is treated as user
-  intent ("keep .trellis/ local-only"). The script warns and skips the
+  ``-f``. The presence of `.cstl/` in `.gitignore` is treated as user
+  intent ("keep .cstl/ local-only"). The script warns and skips the
   auto-commit; users who want auto-staging can either fix their `.gitignore`
   or set ``session_auto_commit: false`` and manage git themselves.
-- The warning includes a negative example: ``Do NOT use `git add -f .trellis/` ...``
+- The warning includes a negative example: ``Do NOT use `git add -f .cstl/` ...``
   so any AI rereading the log doesn't reinvent the bug.
 
 History note: 0.5.10 introduced an automatic ``git add -f`` retry on the
@@ -46,15 +46,15 @@ from .paths import (
 )
 
 
-# Paths under .trellis/ that must NEVER be auto-staged. Listed here so the
+# Paths under .cstl/ that must NEVER be auto-staged. Listed here so the
 # warning to the user can show concrete subpaths to ignore individually
-# instead of ignoring the whole `.trellis/` tree.
+# instead of ignoring the whole `.cstl/` tree.
 TRELLIS_IGNORED_SUBPATHS = (
-    ".trellis/.backup-*",
-    ".trellis/worktrees/",
-    ".trellis/.template-hashes.json",
-    ".trellis/.runtime/",
-    ".trellis/.cache/",
+    ".cstl/.backup-*",
+    ".cstl/worktrees/",
+    ".cstl/.template-hashes.json",
+    ".cstl/.runtime/",
+    ".cstl/.cache/",
 )
 
 
@@ -66,14 +66,14 @@ def safe_trellis_paths_to_add(repo_root: Path) -> list[str]:
     checking afterwards.
 
     Included:
-      - .trellis/workspace/<developer>/journal-*.md
-      - .trellis/workspace/<developer>/index.md
-      - .trellis/tasks/<task-dir>/   (every active task directory)
-      - .trellis/tasks/archive/      (whole archive subtree, if present)
+      - .cstl/workspace/<developer>/journal-*.md
+      - .cstl/workspace/<developer>/index.md
+      - .cstl/tasks/<task-dir>/   (every active task directory)
+      - .cstl/tasks/archive/      (whole archive subtree, if present)
 
     Excluded (intentionally — these must not be staged):
-      - .trellis/.backup-*, .trellis/worktrees/,
-        .trellis/.template-hashes.json, .trellis/.runtime/, .trellis/.cache/
+      - .cstl/.backup-*, .cstl/worktrees/,
+        .cstl/.template-hashes.json, .cstl/.runtime/, .cstl/.cache/
     """
     paths: list[str] = []
 
@@ -133,7 +133,7 @@ def safe_archive_paths_to_add(
     commit boundary.
 
     Backwards-compat: with no arguments, the function walks the whole
-    `.trellis/tasks/` subtree the old way (active tasks + archive). New
+    `.cstl/tasks/` subtree the old way (active tasks + archive). New
     callers should always pass `task_name`.
     """
     paths: list[str] = []
@@ -206,11 +206,11 @@ def print_gitignore_warning(paths: list[str]) -> None:
     """Explain to the user (and any AI reading the log) what to do.
 
     CRITICAL: includes the negative example
-    ``Do NOT use `git add -f .trellis/``` — agents reading the warning are
+    ``Do NOT use `git add -f .cstl/``` — agents reading the warning are
     known to invent that command, which fans out to ignored caches/backups.
     """
     print(
-        "[WARN] git add failed because .trellis/ paths are ignored by your .gitignore.",
+        "[WARN] git add failed because .cstl/ paths are ignored by your .gitignore.",
         file=sys.stderr,
     )
     print(
@@ -231,20 +231,20 @@ def print_gitignore_warning(paths: list[str]) -> None:
             print(f"[WARN]   {p}", file=sys.stderr)
     else:
         print(
-            "[WARN]   .trellis/workspace/<developer>/{journal-*.md,index.md}",
+            "[WARN]   .cstl/workspace/<developer>/{journal-*.md,index.md}",
             file=sys.stderr,
         )
         print(
-            "[WARN]   .trellis/tasks/<task-dir>/",
+            "[WARN]   .cstl/tasks/<task-dir>/",
             file=sys.stderr,
         )
         print(
-            "[WARN]   .trellis/tasks/archive/",
+            "[WARN]   .cstl/tasks/archive/",
             file=sys.stderr,
         )
     print("[WARN]", file=sys.stderr)
     print(
-        "[WARN] Recommended: change your .gitignore from `.trellis/` to specific",
+        "[WARN] Recommended: change your .gitignore from `.cstl/` to specific",
         file=sys.stderr,
     )
     print(
@@ -255,11 +255,11 @@ def print_gitignore_warning(paths: list[str]) -> None:
         print(f"[WARN]   {sub}", file=sys.stderr)
     print("[WARN]", file=sys.stderr)
     print(
-        "[WARN] Or, if you intentionally keep .trellis/ local-only, set in",
+        "[WARN] Or, if you intentionally keep .cstl/ local-only, set in",
         file=sys.stderr,
     )
     print(
-        "[WARN] .trellis/config.yaml:",
+        "[WARN] .cstl/config.yaml:",
         file=sys.stderr,
     )
     print(
@@ -276,7 +276,7 @@ def print_gitignore_warning(paths: list[str]) -> None:
     )
     print("[WARN]", file=sys.stderr)
     print(
-        "[WARN] Do NOT use `git add -f .trellis/` — it pulls in backups, worktrees,",
+        "[WARN] Do NOT use `git add -f .cstl/` — it pulls in backups, worktrees,",
         file=sys.stderr,
     )
     print(