@blxzer/cursor-trellis 0.3.0 → 0.3.3

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

@@ -350,7 +350,7 @@ def _verification_for_intents(intents: list[dict[str, object]]) -> list[dict[str
                 "id": "policy-doc-top1",
                 "requirement": (
                     "For policy/document intents, confirm Top-1 policy evidence from "
-                    "AGENTS.md or .trellis/spec before ranking implementation modules first."
+                    "AGENTS.md or .cstl/spec before ranking implementation modules first."
                 ),
                 "appliesToRoles": ["exact", "semantic"],
             },
@@ -561,7 +561,7 @@ def _ordered_routes(
                 "sourceFamily": "policy-docs",
                 "commands": [
                     'rg -i "storage default|sidecar|sqlite only" AGENTS.md "**/AGENTS.md" '
-                    "README.md CONTRIBUTING.md .trellis/spec"
+                    "README.md CONTRIBUTING.md .cstl/spec"
                 ],
                 "rationale": "Policy/document intent: search instruction and spec docs first.",
             })
@@ -589,7 +589,7 @@ def _ordered_routes(
             "sourceFamily": "policy-docs",
             "commands": [
                 'rg -i "storage default|sidecar|sqlite only" AGENTS.md "**/AGENTS.md" '
-                "README.md CONTRIBUTING.md .trellis/spec"
+                "README.md CONTRIBUTING.md .cstl/spec"
             ],
             "rationale": "Policy/document intent: search instruction and spec docs first.",
         })
@@ -615,7 +615,7 @@ def _ordered_routes(
                 "sourceFamily": "policy-docs",
                 "commands": [
                     'rg -i "storage default|sidecar|sqlite only" AGENTS.md "**/AGENTS.md" '
-                    "README.md CONTRIBUTING.md .trellis/spec"
+                    "README.md CONTRIBUTING.md .cstl/spec"
                 ],
                 "rationale": "Policy/document branch after exact-primary when both intents match.",
             })
@@ -733,7 +733,7 @@ def _fallback_hints(
     if any(str(item["id"]) == INTENT_POLICY for item in intents):
         hints.append({
             "when": "semantic Top-1 is implementation-only for policy query",
-            "action": "Fall back to policy-doc rg and AGENTS.md/.trellis/spec reads.",
+            "action": "Fall back to policy-doc rg and AGENTS.md/.cstl/spec reads.",
             "replacesRole": "semantic",
         })
     semantic_route = next(
@@ -861,7 +861,7 @@ def codebase_retrieval_selected_from_capabilities(
 def load_capabilities_json(repo_root: Path | None) -> dict[str, Any] | None:
     if repo_root is None:
         return None
-    path = repo_root / ".trellis" / "capabilities.json"
+    path = repo_root / ".cstl" / "capabilities.json"
     if not path.is_file():
         return None
     try:

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

@@ -2,7 +2,7 @@
 """
 Trellis configuration reader.
 
-Reads settings from .trellis/config.yaml with sensible defaults.
+Reads settings from .cstl/config.yaml with sensible defaults.
 """
 
 from __future__ import annotations
@@ -219,7 +219,7 @@ def get_session_auto_commit(repo_root: Path | None = None) -> bool:
     ``task_store.py:_auto_commit_archive``.
 
     Default: ``True`` (existing behavior — auto-stage + auto-commit).
-    Set ``session_auto_commit: false`` in ``.trellis/config.yaml`` to skip
+    Set ``session_auto_commit: false`` in ``.cstl/config.yaml`` to skip
     auto-staging entirely; the journal/archive files are still written to
     disk, but the user manages ``git add`` / ``git commit`` themselves.
 
@@ -370,7 +370,7 @@ def is_monorepo(repo_root: Path | None = None) -> bool:
 
 
 def get_spec_base(package: str | None = None, repo_root: Path | None = None) -> str:
-    """Get the spec directory base path relative to .trellis/.
+    """Get the spec directory base path relative to .cstl/.
 
     Single-repo: returns "spec"
     Monorepo with package: returns "spec/<package>"

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

@@ -34,8 +34,8 @@ def init_developer(name: str, repo_root: Path | None = None) -> bool:
     """Initialize developer.
 
     Creates:
-        - .trellis/.developer file with developer info
-        - .trellis/workspace/<name>/ directory structure
+        - .cstl/.developer file with developer info
+        - .cstl/workspace/<name>/ directory structure
         - Initial journal file and index.md
 
     Args:

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

@@ -14,12 +14,12 @@ from __future__ import annotations
 from pathlib import Path
 
 from .config import _is_true_config_value, get_default_package, get_packages, get_spec_scope
-from .paths import (
-    DIR_SPEC,
-    DIR_WORKFLOW,
-    get_selected_task,
-    get_repo_root,
-)
+from .paths import (
+    DIR_SPEC,
+    DIR_WORKFLOW,
+    get_selected_task,
+    get_repo_root,
+)
 from .tasks import load_task
 
 
@@ -41,13 +41,13 @@ def _scan_spec_layers(spec_dir: Path, package: str | None = None) -> list[str]:
     )
 
 
-def _get_selected_task_package(repo_root: Path) -> str | None:
-    """Get the package field from the selected task's task.json."""
-    selected = get_selected_task(repo_root)
-    if not selected:
-        return None
-    ct = load_task(repo_root / selected)
-    return ct.package if ct and ct.package else None
+def _get_selected_task_package(repo_root: Path) -> str | None:
+    """Get the package field from the selected task's task.json."""
+    selected = get_selected_task(repo_root)
+    if not selected:
+        return None
+    ct = load_task(repo_root / selected)
+    return ct.package if ct and ct.package else None
 
 
 def _resolve_scope_set(
@@ -175,7 +175,7 @@ def get_context_packages_text(repo_root: Path | None = None) -> str:
     packages_dict = get_packages(repo_root) or {}
     default_pkg = get_default_package(repo_root)
     spec_scope = get_spec_scope(repo_root)
-    task_pkg = _get_selected_task_package(repo_root)
+    task_pkg = _get_selected_task_package(repo_root)
     scope_set = _resolve_scope_set(packages_dict, spec_scope, task_pkg, default_pkg)
 
     lines.append("## PACKAGES")
@@ -195,7 +195,7 @@ def get_context_packages_text(repo_root: Path | None = None) -> str:
         if pkg["specLayers"]:
             lines.append(f"Spec layers: {', '.join(pkg['specLayers'])}")
             for layer in pkg["specLayers"]:
-                lines.append(f"  - .trellis/spec/{pkg['name']}/{layer}/index.md")
+                lines.append(f"  - .cstl/spec/{pkg['name']}/{layer}/index.md")
         else:
             lines.append("Spec: not configured")
         lines.append("")
@@ -204,7 +204,7 @@ def get_context_packages_text(repo_root: Path | None = None) -> str:
     guides_dir = repo_root / DIR_WORKFLOW / DIR_SPEC / "guides"
     if guides_dir.is_dir():
         lines.append("### Shared Guides (always included)")
-        lines.append("Path: .trellis/spec/guides/index.md")
+        lines.append("Path: .cstl/spec/guides/index.md")
         lines.append("")
 
     return "\n".join(lines)
@@ -230,10 +230,10 @@ def get_context_packages_json(repo_root: Path | None = None) -> dict:
     task_pkg = _get_active_task_package(repo_root)
 
     return {
-        "mode": "monorepo",
-        "packages": pkg_info,
-        "defaultPackage": default_pkg,
-        "specScope": spec_scope,
-        "activeTaskPackage": task_pkg,
-        "selectedTaskPackage": task_pkg,
-    }
+        "mode": "monorepo",
+        "packages": pkg_info,
+        "defaultPackage": default_pkg,
+        "specScope": spec_scope,
+        "activeTaskPackage": task_pkg,
+        "selectedTaskPackage": task_pkg,
+    }

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

@@ -41,14 +41,14 @@ Validation baseline:
 - Run typecheck when touching TypeScript.
 - Run ESLint for changed TypeScript test/source files when applicable.
 - Run Python compile checks when touching Python scripts/templates.
-- Run `python ./.trellis/scripts/task.py validate <your-child-task>` before handoff."""
+- Run `python ./.cstl/scripts/task.py validate <your-child-task>` before handoff."""
 
 _VALIDATION_BASELINE = """Validation baseline:
 - Run focused tests for touched behavior.
 - Run typecheck when touching TypeScript.
 - Run ESLint for changed TypeScript test/source files when applicable.
 - Run Python compile checks when touching Python scripts/templates.
-- Run `python ./.trellis/scripts/task.py validate <child-dir>` before handoff."""
+- Run `python ./.cstl/scripts/task.py validate <child-dir>` before handoff."""
 
 
 def _utc_now() -> str:
@@ -141,13 +141,13 @@ def _child_prompt_section(
     lines.append("### Suggested child worker commands")
     lines.append("")
     lines.append("```bash")
-    lines.append(f"python ./.trellis/scripts/task.py select {child_rel}")
+    lines.append(f"python ./.cstl/scripts/task.py select {child_rel}")
     lines.append(
-        f"python ./.trellis/scripts/task.py set-child-state {parent_rel} {child_rel} working --evidence implement.md"
+        f"python ./.cstl/scripts/task.py set-child-state {parent_rel} {child_rel} working --evidence implement.md"
     )
     lines.append("# ... implement ...")
     lines.append(
-        f"python ./.trellis/scripts/task.py set-child-state {parent_rel} {child_rel} review --evidence verify.md"
+        f"python ./.cstl/scripts/task.py set-child-state {parent_rel} {child_rel} review --evidence verify.md"
     )
     lines.append("```")
     lines.append("")
@@ -266,7 +266,7 @@ def build_child_prompt(
                 f"Selected task: {child_rel}",
                 "",
                 "Delivery mode: subagent (Cursor)",
-                "- **Default:** Parent session dispatches **Task** with `subagent_type=cstl-implement` and this prompt as the task description (writable sub-agent). Model under Cursor++ BYOK comes from `.trellis/local/cursor2plus/` routing (see `cursor-subagent-policy.md` Method 2.5/2.6).",
+                "- **Default:** Parent session dispatches **Task** with `subagent_type=cstl-implement` and this prompt as the task description (writable sub-agent). Model under Cursor++ BYOK comes from `.cstl/local/cursor2plus/` routing (see `cursor-subagent-policy.md` Method 2.5/2.6).",
                 "- **Exception:** If parent `child-prompts.md` or the user names this child for a **separate writable Agent chat**, open a new Agent session, pick the model manually, paste this prompt — do not use Task from Parent.",
                 "- Parent retains `review-child` / `integrate-child`. Child must not nest further `cstl-research` / `cstl-implement` / `cstl-check` Task dispatches.",
                 f"- Parent orchestration: `execution_topology={topo}`, `merge_limit={merge_lim}`.",
@@ -353,11 +353,11 @@ def build_parent_status(parent_dir: Path) -> str:
     lines.append("## Suggested parent commands")
     lines.append("")
     lines.append("```bash")
-    lines.append(f"python ./.trellis/scripts/task.py parent-status {parent_rel}")
-    lines.append(f"python ./.trellis/scripts/task.py generate-child-prompt {parent_rel} <child> --mode subagent")
-    lines.append(f"python ./.trellis/scripts/task.py generate-child-prompt {parent_rel} <child> --mode inline")
-    lines.append(f"python ./.trellis/scripts/task.py review-child {parent_rel} <child> --check")
-    lines.append(f"python ./.trellis/scripts/task.py review-child {parent_rel} <child> --decision accept --ref <ref>")
+    lines.append(f"python ./.cstl/scripts/task.py parent-status {parent_rel}")
+    lines.append(f"python ./.cstl/scripts/task.py generate-child-prompt {parent_rel} <child> --mode subagent")
+    lines.append(f"python ./.cstl/scripts/task.py generate-child-prompt {parent_rel} <child> --mode inline")
+    lines.append(f"python ./.cstl/scripts/task.py review-child {parent_rel} <child> --check")
+    lines.append(f"python ./.cstl/scripts/task.py review-child {parent_rel} <child> --decision accept --ref <ref>")
     lines.append("```")
     return "\n".join(lines)
 
@@ -421,10 +421,10 @@ def _learning_decision_review_lines(
         "Child verify.md has no grep-friendly durable-learning line yet. Pick one outcome:",
         "",
         "- `Durable learning decision: no durable learning` — routine scope, no reusable contract.",
-        "- `Spec update evidence: .trellis/spec/<path>` — after `/cstl:update-spec` with reviewer confirmation.",
+        "- `Spec update evidence: .cstl/spec/<path>` — after `/cstl:update-spec` with reviewer confirmation.",
         f"- `Learning artifact: {child_rel}/handoff.md` — handoff already captures the insight.",
         "",
-        f"Helper: `python ./.trellis/scripts/task.py prepare-archive-evidence {child_rel}`",
+        f"Helper: `python ./.cstl/scripts/task.py prepare-archive-evidence {child_rel}`",
         "",
     ]
 
@@ -524,7 +524,7 @@ def build_review_report(
                     "transition": "parent-accepted",
                     "optional": True,
                     "hint": (
-                        f"Optional audit: python ./.trellis/scripts/task.py record-gate {parent_dir.name} "
+                        f"Optional audit: python ./.cstl/scripts/task.py record-gate {parent_dir.name} "
                         f"--transition parent-accepted --gate code-review --result PASS "
                         f"--reviewer parent --evidence review-{child_name}.md"
                     ),
@@ -538,7 +538,7 @@ def build_review_report(
                         "transition": "child-review",
                         "optional": False,
                         "hint": (
-                            f"Required before accept: python ./.trellis/scripts/task.py record-gate {child_name} "
+                            f"Required before accept: python ./.cstl/scripts/task.py record-gate {child_name} "
                             f"--transition child-review --gate code-review --result PASS "
                             f"--reviewer parent --evidence verify.md"
                         ),
@@ -640,7 +640,7 @@ def build_review_report(
                     "transition": "parent-integrated",
                     "optional": False,
                     "hint": (
-                        f"Required before parent archive: python ./.trellis/scripts/task.py record-gate {parent_dir.name} "
+                        f"Required before parent archive: python ./.cstl/scripts/task.py record-gate {parent_dir.name} "
                         f"--transition parent-integrated --gate integration-review --result PASS "
                         f"--reviewer parent --evidence task-map.md"
                     ),

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` "
             "中搜索策略/边界关键词。"
         )