@mindfoldhq/trellis 0.4.0 → 0.5.0-beta.10

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

@@ -1,305 +0,0 @@
-#!/usr/bin/env python3
-"""
-Worktree utilities for Multi-Agent Pipeline.
-
-Provides:
-    get_worktree_config         - Get worktree.yaml path
-    get_worktree_base_dir       - Get worktree storage directory
-    get_worktree_copy_files     - Get files to copy list
-    get_worktree_post_create_hooks - Get post-create hooks
-    get_agents_dir              - Get agents registry directory
-"""
-
-from __future__ import annotations
-
-from pathlib import Path
-
-from .paths import (
-    DIR_WORKFLOW,
-    get_repo_root,
-    get_workspace_dir,
-)
-
-
-# =============================================================================
-# YAML Simple Parser (no dependencies)
-# =============================================================================
-
-
-def _unquote(s: str) -> str:
-    """Remove exactly one layer of matching surrounding quotes.
-
-    Unlike str.strip('"'), this only removes the outermost pair,
-    preserving any nested quotes inside the value.
-
-    Examples:
-        _unquote('"hello"')        -> 'hello'
-        _unquote("'hello'")        -> 'hello'
-        _unquote('"echo \\'hi\\'"')  -> "echo 'hi'"
-        _unquote('hello')          -> 'hello'
-        _unquote('"hello\\'')       -> '"hello\\''  (mismatched, unchanged)
-    """
-    if len(s) >= 2 and s[0] == s[-1] and s[0] in ('"', "'"):
-        return s[1:-1]
-    return s
-
-
-def parse_simple_yaml(content: str) -> dict:
-    """Parse simple YAML with nested dict support (no dependencies).
-
-    Supports:
-        - key: value (string)
-        - key: (followed by list items)
-            - item1
-            - item2
-        - key: (followed by nested dict)
-            nested_key: value
-            nested_key2:
-              - item
-
-    Uses indentation to detect nesting (2+ spaces deeper = child).
-
-    Args:
-        content: YAML content string.
-
-    Returns:
-        Parsed dict (values can be str, list[str], or dict).
-    """
-    lines = content.splitlines()
-    result: dict = {}
-    _parse_yaml_block(lines, 0, 0, result)
-    return result
-
-
-def _parse_yaml_block(
-    lines: list[str], start: int, min_indent: int, target: dict
-) -> int:
-    """Parse a YAML block into target dict, returning next line index."""
-    i = start
-    current_list: list | None = None
-
-    while i < len(lines):
-        line = lines[i]
-        stripped = line.strip()
-
-        # Skip empty lines and comments
-        if not stripped or stripped.startswith("#"):
-            i += 1
-            continue
-
-        # Calculate indentation
-        indent = len(line) - len(line.lstrip())
-
-        # If dedented past our block, we're done
-        if indent < min_indent:
-            break
-
-        if stripped.startswith("- "):
-            if current_list is not None:
-                current_list.append(_unquote(stripped[2:].strip()))
-            i += 1
-        elif ":" in stripped:
-            key, _, value = stripped.partition(":")
-            key = key.strip()
-            value = _unquote(value.strip())
-            current_list = None
-
-            if value:
-                # key: value
-                target[key] = value
-                i += 1
-            else:
-                # key: (no value) — peek ahead to determine list vs nested dict
-                next_i, next_line = _next_content_line(lines, i + 1)
-                if next_i >= len(lines):
-                    target[key] = {}
-                    i = next_i
-                elif next_line.strip().startswith("- "):
-                    # It's a list
-                    current_list = []
-                    target[key] = current_list
-                    i += 1
-                else:
-                    next_indent = len(next_line) - len(next_line.lstrip())
-                    if next_indent > indent:
-                        # It's a nested dict
-                        nested: dict = {}
-                        target[key] = nested
-                        i = _parse_yaml_block(lines, i + 1, next_indent, nested)
-                    else:
-                        # Empty value, same or less indent follows
-                        target[key] = {}
-                        i += 1
-        else:
-            i += 1
-
-    return i
-
-
-def _next_content_line(lines: list[str], start: int) -> tuple[int, str]:
-    """Find the next non-empty, non-comment line."""
-    i = start
-    while i < len(lines):
-        stripped = lines[i].strip()
-        if stripped and not stripped.startswith("#"):
-            return i, lines[i]
-        i += 1
-    return i, ""
-
-
-def _yaml_get_value(config_file: Path, key: str) -> str | None:
-    """Read simple value from worktree.yaml.
-
-    Args:
-        config_file: Path to config file.
-        key: Key to read.
-
-    Returns:
-        Value string or None.
-    """
-    try:
-        content = config_file.read_text(encoding="utf-8")
-        data = parse_simple_yaml(content)
-        value = data.get(key)
-        if isinstance(value, str):
-            return value
-    except (OSError, IOError):
-        pass
-    return None
-
-
-def _yaml_get_list(config_file: Path, section: str) -> list[str]:
-    """Read list from worktree.yaml.
-
-    Args:
-        config_file: Path to config file.
-        section: Section name.
-
-    Returns:
-        List of items.
-    """
-    try:
-        content = config_file.read_text(encoding="utf-8")
-        data = parse_simple_yaml(content)
-        value = data.get(section)
-        if isinstance(value, list):
-            return [str(item) for item in value]
-    except (OSError, IOError):
-        pass
-    return []
-
-
-# =============================================================================
-# Worktree Configuration
-# =============================================================================
-
-# Worktree config file relative path (relative to repo root)
-WORKTREE_CONFIG_PATH = f"{DIR_WORKFLOW}/worktree.yaml"
-
-
-def get_worktree_config(repo_root: Path | None = None) -> Path:
-    """Get worktree.yaml config file path.
-
-    Args:
-        repo_root: Repository root path. Defaults to auto-detected.
-
-    Returns:
-        Absolute path to config file.
-    """
-    if repo_root is None:
-        repo_root = get_repo_root()
-    return repo_root / WORKTREE_CONFIG_PATH
-
-
-def get_worktree_base_dir(repo_root: Path | None = None) -> Path:
-    """Get worktree base directory.
-
-    Args:
-        repo_root: Repository root path. Defaults to auto-detected.
-
-    Returns:
-        Absolute path to worktree base directory.
-    """
-    if repo_root is None:
-        repo_root = get_repo_root()
-
-    config = get_worktree_config(repo_root)
-    worktree_dir = _yaml_get_value(config, "worktree_dir")
-
-    # Default value
-    if not worktree_dir:
-        worktree_dir = "../worktrees"
-
-    # Handle relative path
-    if worktree_dir.startswith("../") or worktree_dir.startswith("./"):
-        # Relative to repo_root
-        return repo_root / worktree_dir
-    else:
-        # Absolute path
-        return Path(worktree_dir)
-
-
-def get_worktree_copy_files(repo_root: Path | None = None) -> list[str]:
-    """Get files to copy list.
-
-    Args:
-        repo_root: Repository root path. Defaults to auto-detected.
-
-    Returns:
-        List of file paths to copy.
-    """
-    if repo_root is None:
-        repo_root = get_repo_root()
-    config = get_worktree_config(repo_root)
-    return _yaml_get_list(config, "copy")
-
-
-def get_worktree_post_create_hooks(repo_root: Path | None = None) -> list[str]:
-    """Get post_create hooks.
-
-    Args:
-        repo_root: Repository root path. Defaults to auto-detected.
-
-    Returns:
-        List of commands to run.
-    """
-    if repo_root is None:
-        repo_root = get_repo_root()
-    config = get_worktree_config(repo_root)
-    return _yaml_get_list(config, "post_create")
-
-
-# =============================================================================
-# Agents Registry
-# =============================================================================
-
-def get_agents_dir(repo_root: Path | None = None) -> Path | None:
-    """Get agents directory for current developer.
-
-    Args:
-        repo_root: Repository root path. Defaults to auto-detected.
-
-    Returns:
-        Absolute path to agents directory, or None if no workspace.
-    """
-    if repo_root is None:
-        repo_root = get_repo_root()
-
-    workspace_dir = get_workspace_dir(repo_root)
-    if workspace_dir:
-        return workspace_dir / ".agents"
-    return None
-
-
-# =============================================================================
-# Main Entry (for testing)
-# =============================================================================
-
-if __name__ == "__main__":
-    repo = get_repo_root()
-    print(f"Repository root: {repo}")
-    print(f"Worktree config: {get_worktree_config(repo)}")
-    print(f"Worktree base dir: {get_worktree_base_dir(repo)}")
-    print(f"Copy files: {get_worktree_copy_files(repo)}")
-    print(f"Post create hooks: {get_worktree_post_create_hooks(repo)}")
-    print(f"Agents dir: {get_agents_dir(repo)}")

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

@@ -1,298 +0,0 @@
-#!/usr/bin/env python3
-"""
-Create Bootstrap Task for First-Time Setup.
-
-Creates a guided task to help users fill in project guidelines
-after initializing Trellis for the first time.
-
-Usage:
-    python3 create_bootstrap.py [project-type]
-
-Arguments:
-    project-type: frontend | backend | fullstack (default: fullstack)
-
-Prerequisites:
-    - .trellis/.developer must exist (run init_developer.py first)
-
-Creates:
-    .trellis/tasks/00-bootstrap-guidelines/
-        - task.json    # Task metadata
-        - prd.md       # Task description and guidance
-"""
-
-from __future__ import annotations
-
-import json
-import sys
-from datetime import datetime
-from pathlib import Path
-
-from common.paths import (
-    DIR_WORKFLOW,
-    DIR_SCRIPTS,
-    DIR_TASKS,
-    get_repo_root,
-    get_developer,
-    get_tasks_dir,
-    set_current_task,
-)
-from common.config import get_spec_base, resolve_package
-
-
-# =============================================================================
-# Constants
-# =============================================================================
-
-TASK_NAME = "00-bootstrap-guidelines"
-
-
-# =============================================================================
-# PRD Content
-# =============================================================================
-
-def write_prd_header() -> str:
-    """Write PRD header section."""
-    return """# Bootstrap: Fill Project Development Guidelines
-
-## Purpose
-
-Welcome to Trellis! This is your first task.
-
-AI agents use `.trellis/spec/` to understand YOUR project's coding conventions.
-**Starting from scratch = AI writes generic code that doesn't match your project style.**
-
-Filling these guidelines is a one-time setup that pays off for every future AI session.
-
----
-
-## Your Task
-
-Fill in the guideline files based on your **existing codebase**.
-"""
-
-
-def write_prd_backend_section(spec_base: str) -> str:
-    """Write PRD backend section."""
-    return f"""
-
-### Backend Guidelines
-
-| File | What to Document |
-|------|------------------|
-| `.trellis/{spec_base}/backend/directory-structure.md` | Where different file types go (routes, services, utils) |
-| `.trellis/{spec_base}/backend/database-guidelines.md` | ORM, migrations, query patterns, naming conventions |
-| `.trellis/{spec_base}/backend/error-handling.md` | How errors are caught, logged, and returned |
-| `.trellis/{spec_base}/backend/logging-guidelines.md` | Log levels, format, what to log |
-| `.trellis/{spec_base}/backend/quality-guidelines.md` | Code review standards, testing requirements |
-"""
-
-
-def write_prd_frontend_section(spec_base: str) -> str:
-    """Write PRD frontend section."""
-    return f"""
-
-### Frontend Guidelines
-
-| File | What to Document |
-|------|------------------|
-| `.trellis/{spec_base}/frontend/directory-structure.md` | Component/page/hook organization |
-| `.trellis/{spec_base}/frontend/component-guidelines.md` | Component patterns, props conventions |
-| `.trellis/{spec_base}/frontend/hook-guidelines.md` | Custom hook naming, patterns |
-| `.trellis/{spec_base}/frontend/state-management.md` | State library, patterns, what goes where |
-| `.trellis/{spec_base}/frontend/type-safety.md` | TypeScript conventions, type organization |
-| `.trellis/{spec_base}/frontend/quality-guidelines.md` | Linting, testing, accessibility |
-"""
-
-
-def write_prd_footer() -> str:
-    """Write PRD footer section."""
-    return """
-
-### Thinking Guides (Optional)
-
-The `.trellis/spec/guides/` directory contains thinking guides that are already
-filled with general best practices. You can customize them for your project if needed.
-
----
-
-## How to Fill Guidelines
-
-### Principle: Document Reality, Not Ideals
-
-Write what your codebase **actually does**, not what you wish it did.
-AI needs to match existing patterns, not introduce new ones.
-
-### Steps
-
-1. **Look at existing code** - Find 2-3 examples of each pattern
-2. **Document the pattern** - Describe what you see
-3. **Include file paths** - Reference real files as examples
-4. **List anti-patterns** - What does your team avoid?
-
----
-
-## Tips for Using AI
-
-Ask AI to help analyze your codebase:
-
-- "Look at my codebase and document the patterns you see"
-- "Analyze my code structure and summarize the conventions"
-- "Find error handling patterns and document them"
-
-The AI will read your code and help you document it.
-
----
-
-## Completion Checklist
-
-- [ ] Guidelines filled for your project type
-- [ ] At least 2-3 real code examples in each guideline
-- [ ] Anti-patterns documented
-
-When done:
-
-```bash
-python3 ./.trellis/scripts/task.py finish
-python3 ./.trellis/scripts/task.py archive 00-bootstrap-guidelines
-```
-
----
-
-## Why This Matters
-
-After completing this task:
-
-1. AI will write code that matches your project style
-2. Relevant `/trellis:before-*-dev` commands will inject real context
-3. `/trellis:check-*` commands will validate against your actual standards
-4. Future developers (human or AI) will onboard faster
-"""
-
-
-def write_prd(task_dir: Path, project_type: str, spec_base: str) -> None:
-    """Write prd.md file."""
-    content = write_prd_header()
-
-    if project_type == "frontend":
-        content += write_prd_frontend_section(spec_base)
-    elif project_type == "backend":
-        content += write_prd_backend_section(spec_base)
-    else:  # fullstack
-        content += write_prd_backend_section(spec_base)
-        content += write_prd_frontend_section(spec_base)
-
-    content += write_prd_footer()
-
-    prd_file = task_dir / "prd.md"
-    prd_file.write_text(content, encoding="utf-8")
-
-
-# =============================================================================
-# Task JSON
-# =============================================================================
-
-def write_task_json(task_dir: Path, developer: str, project_type: str, spec_base: str) -> None:
-    """Write task.json file."""
-    today = datetime.now().strftime("%Y-%m-%d")
-
-    # Generate subtasks and related files based on project type
-    if project_type == "frontend":
-        subtasks = [
-            {"name": "Fill frontend guidelines", "status": "pending"},
-            {"name": "Add code examples", "status": "pending"},
-        ]
-        related_files = [f".trellis/{spec_base}/frontend/"]
-    elif project_type == "backend":
-        subtasks = [
-            {"name": "Fill backend guidelines", "status": "pending"},
-            {"name": "Add code examples", "status": "pending"},
-        ]
-        related_files = [f".trellis/{spec_base}/backend/"]
-    else:  # fullstack
-        subtasks = [
-            {"name": "Fill backend guidelines", "status": "pending"},
-            {"name": "Fill frontend guidelines", "status": "pending"},
-            {"name": "Add code examples", "status": "pending"},
-        ]
-        related_files = [f".trellis/{spec_base}/backend/", f".trellis/{spec_base}/frontend/"]
-
-    task_data = {
-        "id": TASK_NAME,
-        "name": "Bootstrap Guidelines",
-        "description": "Fill in project development guidelines for AI agents",
-        "status": "in_progress",
-        "dev_type": "docs",
-        "priority": "P1",
-        "creator": developer,
-        "assignee": developer,
-        "createdAt": today,
-        "completedAt": None,
-        "commit": None,
-        "subtasks": subtasks,
-        "children": [],
-        "parent": None,
-        "relatedFiles": related_files,
-        "notes": f"First-time setup task created by trellis init ({project_type} project)",
-        "meta": {},
-    }
-
-    task_json = task_dir / "task.json"
-    task_json.write_text(json.dumps(task_data, indent=2, ensure_ascii=False), encoding="utf-8")
-
-
-# =============================================================================
-# Main
-# =============================================================================
-
-def main() -> int:
-    """Main entry point."""
-    # Parse project type argument
-    project_type = "fullstack"
-    if len(sys.argv) > 1:
-        project_type = sys.argv[1]
-
-    # Validate project type
-    if project_type not in ("frontend", "backend", "fullstack"):
-        print(f"Unknown project type: {project_type}, defaulting to fullstack")
-        project_type = "fullstack"
-
-    repo_root = get_repo_root()
-    developer = get_developer(repo_root)
-
-    # Check developer initialized
-    if not developer:
-        print("Error: Developer not initialized")
-        print(f"Run: python3 ./{DIR_WORKFLOW}/{DIR_SCRIPTS}/init_developer.py <your-name>")
-        return 1
-
-    # Resolve spec base path (monorepo: spec/<package>, single-repo: spec)
-    package = resolve_package(repo_root=repo_root)
-    spec_base = get_spec_base(package, repo_root)
-
-    tasks_dir = get_tasks_dir(repo_root)
-    task_dir = tasks_dir / TASK_NAME
-    relative_path = f"{DIR_WORKFLOW}/{DIR_TASKS}/{TASK_NAME}"
-
-    # Check if already exists
-    if task_dir.exists():
-        print(f"Bootstrap task already exists: {relative_path}")
-        return 0
-
-    # Create task directory
-    task_dir.mkdir(parents=True, exist_ok=True)
-
-    # Write files
-    write_task_json(task_dir, developer, project_type, spec_base)
-    write_prd(task_dir, project_type, spec_base)
-
-    # Set as current task
-    set_current_task(relative_path, repo_root)
-
-    # Silent output - init command handles user-facing messages
-    # Only output the task path for programmatic use
-    print(relative_path)
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

package/dist/templates/trellis/scripts/multi_agent/__init__.py

@@ -1,5 +0,0 @@
-"""
-Multi-Agent Pipeline Scripts.
-
-This module provides orchestration for multi-agent workflows.
-"""

package/dist/templates/trellis/scripts/multi_agent/_bootstrap.py

@@ -1,17 +0,0 @@
-"""Bootstrap path setup for multi_agent scripts.
-
-Import this module before importing from common/:
-
-    import _bootstrap  # noqa: F401
-
-This adds the parent scripts/ directory to sys.path so that
-`from common.xxx import yyy` works when running scripts directly
-via `python3 .trellis/scripts/multi_agent/some_script.py`.
-"""
-
-import sys
-from pathlib import Path
-
-_scripts_dir = str(Path(__file__).resolve().parent.parent)
-if _scripts_dir not in sys.path:
-    sys.path.insert(0, _scripts_dir)