@blxzer/cursor-trellis 0.1.0

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

@@ -0,0 +1,223 @@
+#!/usr/bin/env python3
+"""
+Task JSONL context management.
+
+Provides:
+    cmd_add_context   - Add entry to JSONL context file
+    cmd_validate      - Validate JSONL context files
+    cmd_list_context  - List JSONL context entries
+
+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
+    current planning artifact contract.
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+
+from .log import Colors, colored
+from .paths import get_repo_root
+from .task_utils import resolve_task_dir
+
+
+# =============================================================================
+# Command: add-context
+# =============================================================================
+
+def cmd_add_context(args: argparse.Namespace) -> int:
+    """Add entry to JSONL context file."""
+    repo_root = get_repo_root()
+    target_dir = resolve_task_dir(args.dir, repo_root)
+
+    jsonl_name = args.file
+    path = args.path
+    reason = args.reason or "Added manually"
+
+    if not target_dir.is_dir():
+        print(colored(f"Error: Directory not found: {target_dir}", Colors.RED))
+        return 1
+
+    # Support shorthand
+    if not jsonl_name.endswith(".jsonl"):
+        jsonl_name = f"{jsonl_name}.jsonl"
+
+    jsonl_file = target_dir / jsonl_name
+    full_path = repo_root / path
+
+    entry_type = "file"
+    if full_path.is_dir():
+        entry_type = "directory"
+        if not path.endswith("/"):
+            path = f"{path}/"
+    elif not full_path.is_file():
+        print(colored(f"Error: Path not found: {path}", Colors.RED))
+        return 1
+
+    # Check if already exists
+    if jsonl_file.is_file():
+        content = jsonl_file.read_text(encoding="utf-8")
+        if f'"{path}"' in content:
+            print(colored(f"Warning: Entry already exists for {path}", Colors.YELLOW))
+            return 0
+
+    # Add entry
+    entry: dict
+    if entry_type == "directory":
+        entry = {"file": path, "type": "directory", "reason": reason}
+    else:
+        entry = {"file": path, "reason": reason}
+
+    with jsonl_file.open("a", encoding="utf-8") as f:
+        f.write(json.dumps(entry, ensure_ascii=False) + "\n")
+
+    print(colored(f"Added {entry_type}: {path}", Colors.GREEN))
+    return 0
+
+
+# =============================================================================
+# Command: validate
+# =============================================================================
+
+def cmd_validate(args: argparse.Namespace) -> int:
+    """Validate JSONL context files."""
+    repo_root = get_repo_root()
+    target_dir = resolve_task_dir(args.dir, repo_root)
+
+    if not target_dir.is_dir():
+        print(colored("Error: task directory required", Colors.RED))
+        return 1
+
+    print(colored("=== Validating Context Files ===", Colors.BLUE))
+    print(f"Target dir: {target_dir}")
+    print()
+
+    total_errors = 0
+    for jsonl_name in ["implement.jsonl", "check.jsonl"]:
+        jsonl_file = target_dir / jsonl_name
+        errors = _validate_jsonl(jsonl_file, repo_root)
+        total_errors += errors
+
+    print()
+    if total_errors == 0:
+        print(colored("✓ All validations passed", Colors.GREEN))
+        return 0
+    else:
+        print(colored(f"✗ Validation failed ({total_errors} errors)", Colors.RED))
+        return 1
+
+
+def _validate_jsonl(jsonl_file: Path, repo_root: Path) -> int:
+    """Validate a single JSONL file.
+
+    Seed rows (no ``file`` field — typically ``{"_example": "..."}``) are
+    skipped silently; they are self-describing comments, not real entries.
+    """
+    file_name = jsonl_file.name
+    errors = 0
+
+    if not jsonl_file.is_file():
+        print(f"  {colored(f'{file_name}: not found (skipped)', Colors.YELLOW)}")
+        return 0
+
+    line_num = 0
+    real_entries = 0
+    for line in jsonl_file.read_text(encoding="utf-8").splitlines():
+        line_num += 1
+        if not line.strip():
+            continue
+
+        try:
+            data = json.loads(line)
+        except json.JSONDecodeError:
+            print(f"  {colored(f'{file_name}:{line_num}: Invalid JSON', Colors.RED)}")
+            errors += 1
+            continue
+
+        file_path = data.get("file")
+        entry_type = data.get("type", "file")
+
+        if not file_path:
+            # Seed / comment row — skip silently
+            continue
+
+        real_entries += 1
+        full_path = repo_root / file_path
+        if entry_type == "directory":
+            if not full_path.is_dir():
+                print(f"  {colored(f'{file_name}:{line_num}: Directory not found: {file_path}', Colors.RED)}")
+                errors += 1
+        else:
+            if not full_path.is_file():
+                print(f"  {colored(f'{file_name}:{line_num}: File not found: {file_path}', Colors.RED)}")
+                errors += 1
+
+    if errors == 0:
+        print(f"  {colored(f'{file_name}: ✓ ({real_entries} entries)', Colors.GREEN)}")
+    else:
+        print(f"  {colored(f'{file_name}: ✗ ({errors} errors)', Colors.RED)}")
+
+    return errors
+
+
+# =============================================================================
+# Command: list-context
+# =============================================================================
+
+def cmd_list_context(args: argparse.Namespace) -> int:
+    """List JSONL context entries."""
+    repo_root = get_repo_root()
+    target_dir = resolve_task_dir(args.dir, repo_root)
+
+    if not target_dir.is_dir():
+        print(colored("Error: task directory required", Colors.RED))
+        return 1
+
+    print(colored("=== Context Files ===", Colors.BLUE))
+    print()
+
+    for jsonl_name in ["implement.jsonl", "check.jsonl"]:
+        jsonl_file = target_dir / jsonl_name
+        if not jsonl_file.is_file():
+            continue
+
+        print(colored(f"[{jsonl_name}]", Colors.CYAN))
+
+        count = 0
+        seed_only = True
+        for line in jsonl_file.read_text(encoding="utf-8").splitlines():
+            if not line.strip():
+                continue
+
+            try:
+                data = json.loads(line)
+            except json.JSONDecodeError:
+                continue
+
+            file_path = data.get("file")
+            if not file_path:
+                # Seed / comment row — don't count as a real entry
+                continue
+            seed_only = False
+
+            count += 1
+            entry_type = data.get("type", "file")
+            reason = data.get("reason", "-")
+
+            if entry_type == "directory":
+                print(f"  {colored(f'{count}.', Colors.GREEN)} [DIR] {file_path}")
+            else:
+                print(f"  {colored(f'{count}.', Colors.GREEN)} {file_path}")
+            print(f"     {colored('→', Colors.YELLOW)} {reason}")
+
+        if seed_only:
+            print(f"  {colored('(no curated entries yet — only seed row)', Colors.YELLOW)}")
+
+        print()
+
+    return 0

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

@@ -0,0 +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,
+            )