@mindfoldhq/trellis 0.3.10-beta.0 → 0.3.10

package/dist/templates/gemini/commands/trellis/check.toml

@@ -1,29 +0,0 @@
-description = "Check if the code you just wrote follows the development guidelines"
-
-prompt = """
-Check if the code you just wrote follows the development guidelines.
-
-Execute these steps:
-
-1. **Identify changed files**:
-   ```bash
-   git diff --name-only HEAD
-   ```
-
-2. **Determine which spec modules apply** based on the changed file paths:
-   ```bash
-   python3 ./.trellis/scripts/get_context.py --mode packages
-   ```
-
-3. **Read the spec index** for each relevant module:
-   ```bash
-   cat .trellis/spec/<package>/<layer>/index.md
-   ```
-   Follow the **"Quality Check"** section in the index.
-
-4. **Read the specific guideline files** referenced in the Quality Check section (e.g., `quality-guidelines.md`, `conventions.md`). The index is NOT the goal -> it points you to the actual guideline files. Read those files and review your code against them.
-
-5. **Run lint and typecheck** for the affected package.
-
-6. **Report any violations** and fix them if found.
-"""

package/dist/templates/iflow/commands/trellis/before-dev.md

@@ -1,29 +0,0 @@
-Read the relevant development guidelines before starting your task.
-
-Execute these steps:
-
-1. **Discover packages and their spec layers**:
-   ```bash
-   python3 ./.trellis/scripts/get_context.py --mode packages
-   ```
-
-2. **Identify which specs apply** to your task based on:
-   - Which package you're modifying (e.g., `cli/`, `docs-site/`)
-   - What type of work (backend, frontend, unit-test, docs, etc.)
-
-3. **Read the spec index** for each relevant module:
-   ```bash
-   cat .trellis/spec/<package>/<layer>/index.md
-   ```
-   Follow the **"Pre-Development Checklist"** section in the index.
-
-4. **Read the specific guideline files** listed in the Pre-Development Checklist that are relevant to your task. The index is NOT the goal — it points you to the actual guideline files (e.g., `error-handling.md`, `conventions.md`, `mock-strategies.md`). Read those files to understand the coding standards and patterns.
-
-5. **Always read shared guides**:
-   ```bash
-   cat .trellis/spec/guides/index.md
-   ```
-
-6. Understand the coding standards and patterns you need to follow, then proceed with your development plan.
-
-This step is **mandatory** before writing any code.

package/dist/templates/iflow/commands/trellis/check.md

@@ -1,25 +0,0 @@
-Check if the code you just wrote follows the development guidelines.
-
-Execute these steps:
-
-1. **Identify changed files**:
-   ```bash
-   git diff --name-only HEAD
-   ```
-
-2. **Determine which spec modules apply** based on the changed file paths:
-   ```bash
-   python3 ./.trellis/scripts/get_context.py --mode packages
-   ```
-
-3. **Read the spec index** for each relevant module:
-   ```bash
-   cat .trellis/spec/<package>/<layer>/index.md
-   ```
-   Follow the **"Quality Check"** section in the index.
-
-4. **Read the specific guideline files** referenced in the Quality Check section (e.g., `quality-guidelines.md`, `conventions.md`). The index is NOT the goal — it points you to the actual guideline files. Read those files and review your code against them.
-
-5. **Run lint and typecheck** for the affected package.
-
-6. **Report any violations** and fix them if found.

package/dist/templates/kilo/workflows/before-dev.md

@@ -1,29 +0,0 @@
-Read the relevant development guidelines before starting your task.
-
-Execute these steps:
-
-1. **Discover packages and their spec layers**:
-   ```bash
-   python3 ./.trellis/scripts/get_context.py --mode packages
-   ```
-
-2. **Identify which specs apply** to your task based on:
-   - Which package you're modifying (e.g., `cli/`, `docs-site/`)
-   - What type of work (backend, frontend, unit-test, docs, etc.)
-
-3. **Read the spec index** for each relevant module:
-   ```bash
-   cat .trellis/spec/<package>/<layer>/index.md
-   ```
-   Follow the **"Pre-Development Checklist"** section in the index.
-
-4. **Read the specific guideline files** listed in the Pre-Development Checklist that are relevant to your task. The index is NOT the goal — it points you to the actual guideline files (e.g., `error-handling.md`, `conventions.md`, `mock-strategies.md`). Read those files to understand the coding standards and patterns.
-
-5. **Always read shared guides**:
-   ```bash
-   cat .trellis/spec/guides/index.md
-   ```
-
-6. Understand the coding standards and patterns you need to follow, then proceed with your development plan.
-
-This step is **mandatory** before writing any code.

package/dist/templates/kilo/workflows/check.md

@@ -1,25 +0,0 @@
-Check if the code you just wrote follows the development guidelines.
-
-Execute these steps:
-
-1. **Identify changed files**:
-   ```bash
-   git diff --name-only HEAD
-   ```
-
-2. **Determine which spec modules apply** based on the changed file paths:
-   ```bash
-   python3 ./.trellis/scripts/get_context.py --mode packages
-   ```
-
-3. **Read the spec index** for each relevant module:
-   ```bash
-   cat .trellis/spec/<package>/<layer>/index.md
-   ```
-   Follow the **"Quality Check"** section in the index.
-
-4. **Read the specific guideline files** referenced in the Quality Check section (e.g., `quality-guidelines.md`, `conventions.md`). The index is NOT the goal — it points you to the actual guideline files. Read those files and review your code against them.
-
-5. **Run lint and typecheck** for the affected package.
-
-6. **Report any violations** and fix them if found.

package/dist/templates/kiro/skills/before-dev/SKILL.md

@@ -1,34 +0,0 @@
----
-name: before-dev
-description: "Read the relevant development guidelines before starting your task."
----
-
-Read the relevant development guidelines before starting your task.
-
-Execute these steps:
-
-1. **Discover packages and their spec layers**:
-   ```bash
-   python3 ./.trellis/scripts/get_context.py --mode packages
-   ```
-
-2. **Identify which specs apply** to your task based on:
-   - Which package you're modifying (e.g., `cli/`, `docs-site/`)
-   - What type of work (backend, frontend, unit-test, docs, etc.)
-
-3. **Read the spec index** for each relevant module:
-   ```bash
-   cat .trellis/spec/<package>/<layer>/index.md
-   ```
-   Follow the **"Pre-Development Checklist"** section in the index.
-
-4. **Read the specific guideline files** listed in the Pre-Development Checklist that are relevant to your task. The index is NOT the goal — it points you to the actual guideline files (e.g., `error-handling.md`, `conventions.md`, `mock-strategies.md`). Read those files to understand the coding standards and patterns.
-
-5. **Always read shared guides**:
-   ```bash
-   cat .trellis/spec/guides/index.md
-   ```
-
-6. Understand the coding standards and patterns you need to follow, then proceed with your development plan.
-
-This step is **mandatory** before writing any code.

package/dist/templates/kiro/skills/check/SKILL.md

@@ -1,30 +0,0 @@
----
-name: check
-description: "Check if the code you just wrote follows the development guidelines."
----
-
-Check if the code you just wrote follows the development guidelines.
-
-Execute these steps:
-
-1. **Identify changed files**:
-   ```bash
-   git diff --name-only HEAD
-   ```
-
-2. **Determine which spec modules apply** based on the changed file paths:
-   ```bash
-   python3 ./.trellis/scripts/get_context.py --mode packages
-   ```
-
-3. **Read the spec index** for each relevant module:
-   ```bash
-   cat .trellis/spec/<package>/<layer>/index.md
-   ```
-   Follow the **"Quality Check"** section in the index.
-
-4. **Read the specific guideline files** referenced in the Quality Check section (e.g., `quality-guidelines.md`, `conventions.md`). The index is NOT the goal — it points you to the actual guideline files. Read those files and review your code against them.
-
-5. **Run lint and typecheck** for the affected package.
-
-6. **Report any violations** and fix them if found.

package/dist/templates/opencode/commands/trellis/before-dev.md

@@ -1,29 +0,0 @@
-Read the relevant development guidelines before starting your task.
-
-Execute these steps:
-
-1. **Discover packages and their spec layers**:
-   ```bash
-   python3 ./.trellis/scripts/get_context.py --mode packages
-   ```
-
-2. **Identify which specs apply** to your task based on:
-   - Which package you're modifying (e.g., `cli/`, `docs-site/`)
-   - What type of work (backend, frontend, unit-test, docs, etc.)
-
-3. **Read the spec index** for each relevant module:
-   ```bash
-   cat .trellis/spec/<package>/<layer>/index.md
-   ```
-   Follow the **"Pre-Development Checklist"** section in the index.
-
-4. **Read the specific guideline files** listed in the Pre-Development Checklist that are relevant to your task. The index is NOT the goal — it points you to the actual guideline files (e.g., `error-handling.md`, `conventions.md`, `mock-strategies.md`). Read those files to understand the coding standards and patterns.
-
-5. **Always read shared guides**:
-   ```bash
-   cat .trellis/spec/guides/index.md
-   ```
-
-6. Understand the coding standards and patterns you need to follow, then proceed with your development plan.
-
-This step is **mandatory** before writing any code.

package/dist/templates/opencode/commands/trellis/check.md

@@ -1,25 +0,0 @@
-Check if the code you just wrote follows the development guidelines.
-
-Execute these steps:
-
-1. **Identify changed files**:
-   ```bash
-   git diff --name-only HEAD
-   ```
-
-2. **Determine which spec modules apply** based on the changed file paths:
-   ```bash
-   python3 ./.trellis/scripts/get_context.py --mode packages
-   ```
-
-3. **Read the spec index** for each relevant module:
-   ```bash
-   cat .trellis/spec/<package>/<layer>/index.md
-   ```
-   Follow the **"Quality Check"** section in the index.
-
-4. **Read the specific guideline files** referenced in the Quality Check section (e.g., `quality-guidelines.md`, `conventions.md`). The index is NOT the goal — it points you to the actual guideline files. Read those files and review your code against them.
-
-5. **Run lint and typecheck** for the affected package.
-
-6. **Report any violations** and fix them if found.

package/dist/templates/qoder/skills/before-dev/SKILL.md

@@ -1,34 +0,0 @@
----
-name: before-dev
-description: "Read the relevant development guidelines before starting your task."
----
-
-Read the relevant development guidelines before starting your task.
-
-Execute these steps:
-
-1. **Discover packages and their spec layers**:
-   ```bash
-   python3 ./.trellis/scripts/get_context.py --mode packages
-   ```
-
-2. **Identify which specs apply** to your task based on:
-   - Which package you're modifying (e.g., `cli/`, `docs-site/`)
-   - What type of work (backend, frontend, unit-test, docs, etc.)
-
-3. **Read the spec index** for each relevant module:
-   ```bash
-   cat .trellis/spec/<package>/<layer>/index.md
-   ```
-   Follow the **"Pre-Development Checklist"** section in the index.
-
-4. **Read the specific guideline files** listed in the Pre-Development Checklist that are relevant to your task. The index is NOT the goal — it points you to the actual guideline files (e.g., `error-handling.md`, `conventions.md`, `mock-strategies.md`). Read those files to understand the coding standards and patterns.
-
-5. **Always read shared guides**:
-   ```bash
-   cat .trellis/spec/guides/index.md
-   ```
-
-6. Understand the coding standards and patterns you need to follow, then proceed with your development plan.
-
-This step is **mandatory** before writing any code.

package/dist/templates/qoder/skills/check/SKILL.md

@@ -1,30 +0,0 @@
----
-name: check
-description: "Check if the code you just wrote follows the development guidelines."
----
-
-Check if the code you just wrote follows the development guidelines.
-
-Execute these steps:
-
-1. **Identify changed files**:
-   ```bash
-   git diff --name-only HEAD
-   ```
-
-2. **Determine which spec modules apply** based on the changed file paths:
-   ```bash
-   python3 ./.trellis/scripts/get_context.py --mode packages
-   ```
-
-3. **Read the spec index** for each relevant module:
-   ```bash
-   cat .trellis/spec/<package>/<layer>/index.md
-   ```
-   Follow the **"Quality Check"** section in the index.
-
-4. **Read the specific guideline files** referenced in the Quality Check section (e.g., `quality-guidelines.md`, `conventions.md`). The index is NOT the goal — it points you to the actual guideline files. Read those files and review your code against them.
-
-5. **Run lint and typecheck** for the affected package.
-
-6. **Report any violations** and fix them if found.

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

@@ -1,31 +0,0 @@
-"""
-Git command execution utility.
-
-Single source of truth for running git commands across all Trellis scripts.
-"""
-
-from __future__ import annotations
-
-import subprocess
-from pathlib import Path
-
-
-def run_git(args: list[str], cwd: Path | None = None) -> tuple[int, str, str]:
-    """Run a git command and return (returncode, stdout, stderr).
-
-    Uses UTF-8 encoding with -c i18n.logOutputEncoding=UTF-8 to ensure
-    consistent output across all platforms (Windows, macOS, Linux).
-    """
-    try:
-        git_args = ["git", "-c", "i18n.logOutputEncoding=UTF-8"] + args
-        result = subprocess.run(
-            git_args,
-            cwd=cwd,
-            capture_output=True,
-            text=True,
-            encoding="utf-8",
-            errors="replace",
-        )
-        return result.returncode, result.stdout, result.stderr
-    except Exception as e:
-        return 1, "", str(e)

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

@@ -1,37 +0,0 @@
-"""
-JSON file I/O utilities.
-
-Provides read_json and write_json as the single source of truth
-for JSON file operations across all Trellis scripts.
-"""
-
-from __future__ import annotations
-
-import json
-from pathlib import Path
-
-
-def read_json(path: Path) -> dict | None:
-    """Read and parse a JSON file.
-
-    Returns None if the file doesn't exist, is invalid JSON, or can't be read.
-    """
-    try:
-        return json.loads(path.read_text(encoding="utf-8"))
-    except (FileNotFoundError, json.JSONDecodeError, OSError):
-        return None
-
-
-def write_json(path: Path, data: dict) -> bool:
-    """Write dict to JSON file with pretty formatting.
-
-    Returns True on success, False on error.
-    """
-    try:
-        path.write_text(
-            json.dumps(data, indent=2, ensure_ascii=False),
-            encoding="utf-8",
-        )
-        return True
-    except (OSError, IOError):
-        return False

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

@@ -1,45 +0,0 @@
-"""
-Terminal output utilities: colors and structured logging.
-
-Single source of truth for Colors and log_* functions
-used across all Trellis scripts.
-"""
-
-from __future__ import annotations
-
-
-class Colors:
-    """ANSI color codes for terminal output."""
-
-    RED = "\033[0;31m"
-    GREEN = "\033[0;32m"
-    YELLOW = "\033[1;33m"
-    BLUE = "\033[0;34m"
-    CYAN = "\033[0;36m"
-    DIM = "\033[2m"
-    NC = "\033[0m"  # No Color / Reset
-
-
-def colored(text: str, color: str) -> str:
-    """Apply ANSI color to text."""
-    return f"{color}{text}{Colors.NC}"
-
-
-def log_info(msg: str) -> None:
-    """Print info-level message with [INFO] prefix."""
-    print(f"{Colors.BLUE}[INFO]{Colors.NC} {msg}")
-
-
-def log_success(msg: str) -> None:
-    """Print success message with [SUCCESS] prefix."""
-    print(f"{Colors.GREEN}[SUCCESS]{Colors.NC} {msg}")
-
-
-def log_warn(msg: str) -> None:
-    """Print warning message with [WARN] prefix."""
-    print(f"{Colors.YELLOW}[WARN]{Colors.NC} {msg}")
-
-
-def log_error(msg: str) -> None:
-    """Print error message with [ERROR] prefix."""
-    print(f"{Colors.RED}[ERROR]{Colors.NC} {msg}")

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

@@ -1,233 +0,0 @@
-#!/usr/bin/env python3
-"""
-Package discovery and context output.
-
-Provides:
-    get_packages_info           - Get structured package info
-    get_packages_section        - Build PACKAGES text section
-    get_context_packages_text   - Full packages text output (--mode packages)
-    get_context_packages_json   - Full packages JSON output (--mode packages --json)
-"""
-
-from __future__ import annotations
-
-from pathlib import Path
-
-from .config import get_default_package, get_packages, get_spec_scope
-from .paths import (
-    DIR_SPEC,
-    DIR_WORKFLOW,
-    get_current_task,
-    get_repo_root,
-)
-from .tasks import load_task
-
-
-# =============================================================================
-# Internal Helpers
-# =============================================================================
-
-def _scan_spec_layers(spec_dir: Path, package: str | None = None) -> list[str]:
-    """Scan spec directory for available layers (subdirectories).
-
-    For monorepo: scans spec/<package>/
-    For single-repo: scans spec/
-    """
-    target = spec_dir / package if package else spec_dir
-    if not target.is_dir():
-        return []
-    return sorted(
-        d.name for d in target.iterdir() if d.is_dir() and d.name != "guides"
-    )
-
-
-def _get_active_task_package(repo_root: Path) -> str | None:
-    """Get the package field from the active task's task.json."""
-    current = get_current_task(repo_root)
-    if not current:
-        return None
-    ct = load_task(repo_root / current)
-    return ct.package if ct and ct.package else None
-
-
-def _resolve_scope_set(
-    packages: dict,
-    spec_scope,
-    task_pkg: str | None,
-    default_pkg: str | None,
-) -> set | None:
-    """Resolve spec_scope to a set of allowed package names, or None for full scan."""
-    if not packages:
-        return None
-
-    if spec_scope is None:
-        return None
-
-    if isinstance(spec_scope, str) and spec_scope == "active_task":
-        if task_pkg and task_pkg in packages:
-            return {task_pkg}
-        if default_pkg and default_pkg in packages:
-            return {default_pkg}
-        return None
-
-    if isinstance(spec_scope, list):
-        valid = {e for e in spec_scope if e in packages}
-        if valid:
-            return valid
-        # All invalid: fallback
-        if task_pkg and task_pkg in packages:
-            return {task_pkg}
-        if default_pkg and default_pkg in packages:
-            return {default_pkg}
-        return None
-
-    return None
-
-
-# =============================================================================
-# Public Functions
-# =============================================================================
-
-def get_packages_info(repo_root: Path) -> list[dict]:
-    """Get structured package info for monorepo projects.
-
-    Returns list of dicts with keys: name, path, type, default, specLayers, isSubmodule.
-    Returns empty list for single-repo projects.
-    """
-    packages = get_packages(repo_root)
-    if not packages:
-        return []
-
-    default_pkg = get_default_package(repo_root)
-    spec_dir = repo_root / DIR_WORKFLOW / DIR_SPEC
-    result = []
-
-    for pkg_name, pkg_config in packages.items():
-        pkg_path = pkg_config.get("path", pkg_name) if isinstance(pkg_config, dict) else str(pkg_config)
-        pkg_type = pkg_config.get("type", "local") if isinstance(pkg_config, dict) else "local"
-        layers = _scan_spec_layers(spec_dir, pkg_name)
-
-        result.append({
-            "name": pkg_name,
-            "path": pkg_path,
-            "type": pkg_type,
-            "default": pkg_name == default_pkg,
-            "specLayers": layers,
-            "isSubmodule": pkg_type == "submodule",
-        })
-
-    return result
-
-
-def get_packages_section(repo_root: Path) -> str:
-    """Build the PACKAGES section for text output."""
-    spec_dir = repo_root / DIR_WORKFLOW / DIR_SPEC
-    pkg_info = get_packages_info(repo_root)
-
-    lines: list[str] = []
-    lines.append("## PACKAGES")
-
-    if not pkg_info:
-        lines.append("(single-repo mode)")
-        layers = _scan_spec_layers(spec_dir)
-        if layers:
-            lines.append(f"Spec layers: {', '.join(layers)}")
-        return "\n".join(lines)
-
-    default_pkg = get_default_package(repo_root)
-
-    for pkg in pkg_info:
-        layers_str = f"  [{', '.join(pkg['specLayers'])}]" if pkg["specLayers"] else ""
-        submodule_tag = "  (submodule)" if pkg["isSubmodule"] else ""
-        default_tag = "  *" if pkg["default"] else ""
-        lines.append(
-            f"- {pkg['name']:<16} {pkg['path']:<20}{layers_str}{submodule_tag}{default_tag}"
-        )
-
-    if default_pkg:
-        lines.append(f"Default package: {default_pkg}")
-
-    return "\n".join(lines)
-
-
-def get_context_packages_text(repo_root: Path | None = None) -> str:
-    """Get packages context as formatted text (for --mode packages)."""
-    if repo_root is None:
-        repo_root = get_repo_root()
-
-    pkg_info = get_packages_info(repo_root)
-    lines: list[str] = []
-
-    if not pkg_info:
-        spec_dir = repo_root / DIR_WORKFLOW / DIR_SPEC
-        lines.append("Single-repo project (no packages configured)")
-        lines.append("")
-        layers = _scan_spec_layers(spec_dir)
-        if layers:
-            lines.append(f"Spec layers: {', '.join(layers)}")
-        return "\n".join(lines)
-
-    # Resolve scope for annotations
-    packages_dict = get_packages(repo_root) or {}
-    default_pkg = get_default_package(repo_root)
-    spec_scope = get_spec_scope(repo_root)
-    task_pkg = _get_active_task_package(repo_root)
-    scope_set = _resolve_scope_set(packages_dict, spec_scope, task_pkg, default_pkg)
-
-    lines.append("## PACKAGES")
-    lines.append("")
-    for pkg in pkg_info:
-        default_tag = " (default)" if pkg["default"] else ""
-        type_tag = f" [{pkg['type']}]" if pkg["type"] != "local" else ""
-
-        # Scope annotation
-        scope_tag = ""
-        if scope_set is not None and pkg["name"] not in scope_set:
-            scope_tag = " (out of scope)"
-
-        lines.append(f"### {pkg['name']}{default_tag}{type_tag}{scope_tag}")
-        lines.append(f"Path: {pkg['path']}")
-        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")
-        else:
-            lines.append("Spec: not configured")
-        lines.append("")
-
-    # Also show shared guides
-    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("")
-
-    return "\n".join(lines)
-
-
-def get_context_packages_json(repo_root: Path | None = None) -> dict:
-    """Get packages context as a dictionary (for --mode packages --json)."""
-    if repo_root is None:
-        repo_root = get_repo_root()
-
-    pkg_info = get_packages_info(repo_root)
-
-    if not pkg_info:
-        spec_dir = repo_root / DIR_WORKFLOW / DIR_SPEC
-        layers = _scan_spec_layers(spec_dir)
-        return {
-            "mode": "single-repo",
-            "specLayers": layers,
-        }
-
-    default_pkg = get_default_package(repo_root)
-    spec_scope = get_spec_scope(repo_root)
-    task_pkg = _get_active_task_package(repo_root)
-
-    return {
-        "mode": "monorepo",
-        "packages": pkg_info,
-        "defaultPackage": default_pkg,
-        "specScope": spec_scope,
-        "activeTaskPackage": task_pkg,
-    }