@jahanxu/trellis 0.5.1 → 0.5.6

package/dist/templates/markdown/spec/roles/pm/prd-template.md.txt

@@ -1,64 +0,0 @@
-# PRD Template
-
-> Standard structure for Product Requirements Documents.
-
----
-
-## Template
-
-```markdown
-# Feature: {Feature Name}
-
-## Background
-Why this feature is needed. Business context and user pain points.
-
-## Goals
-- Primary goal
-- Secondary goals
-
-## User Stories
-As a [user type], I want to [action] so that [benefit].
-
-## Requirements
-
-### Functional Requirements
-1. ...
-2. ...
-
-### Non-Functional Requirements
-- Performance: ...
-- Security: ...
-- Accessibility: ...
-
-## UI/UX Requirements
-- Layout description
-- Key interactions
-- Error states
-
-## API Requirements (if applicable)
-- Endpoints needed
-- Data format expectations
-
-## Acceptance Criteria
-- [ ] Criterion 1
-- [ ] Criterion 2
-
-## Out of Scope
-- Items explicitly excluded from this feature
-
-## Open Questions
-- Questions that need resolution
-```
-
----
-
-## Guidelines
-
-1. **Be specific**: Avoid vague language like "should be fast" - specify measurable criteria
-2. **Include edge cases**: Document what happens with empty data, errors, permission issues
-3. **Reference designs**: Link to Figma/mockups when available
-4. **Scope clearly**: Explicitly state what is NOT included
-
----
-
-**Language**: All documentation should be written in **English**.

package/dist/templates/markdown/spec/roles/pm/requirement-checklist.md.txt

@@ -1,43 +0,0 @@
-# Requirement Checklist
-
-> Quality checklist before handing off requirements to the Designer.
-
----
-
-## Pre-Handoff Checklist
-
-### Completeness
-- [ ] All user stories are written with clear acceptance criteria
-- [ ] Edge cases are documented (empty states, error states, loading states)
-- [ ] UI/UX requirements include layout descriptions and key interactions
-- [ ] API requirements are specified (if applicable)
-- [ ] Non-functional requirements are defined (performance, security, accessibility)
-
-### Clarity
-- [ ] No ambiguous language (e.g., "fast", "nice", "user-friendly" without metrics)
-- [ ] Technical constraints are explicitly stated
-- [ ] Out-of-scope items are listed
-- [ ] Open questions are resolved or explicitly deferred
-
-### Consistency
-- [ ] Feature aligns with existing product patterns
-- [ ] Naming conventions match existing features
-- [ ] No contradictions between requirements sections
-
-### Downstream Readiness
-- [ ] Designer can start prototyping without needing clarification meetings
-- [ ] All referenced resources (Figma links, API docs) are accessible
-- [ ] Priority and scope are clear
-
----
-
-## Common Issues to Avoid
-
-1. **Missing error states**: Every user action should have a defined failure path
-2. **Implicit assumptions**: State all assumptions explicitly
-3. **Feature creep**: Keep scope tight - add "future considerations" for nice-to-haves
-4. **Missing data requirements**: Specify what data the UI needs and where it comes from
-
----
-
-**Language**: All documentation should be written in **English**.

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

@@ -1,321 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-Pool Management Script for Three-Role Collaboration Pipeline.
-
-Usage:
-    python3 pool.py init [pool-name...]         # Create pool JSON files
-    python3 pool.py add <pool> <id> <title> <path> [--handoff <path>]  # Add deliverable
-    python3 pool.py list [pool]                 # List available items
-    python3 pool.py status <pool> <id>          # Get item status
-    python3 pool.py consume <pool> <id> <consumed-by>  # Mark as consumed
-"""
-
-from __future__ import annotations
-
-import sys
-
-# IMPORTANT: Force stdout to use UTF-8 on Windows
-# This fixes UnicodeEncodeError when outputting non-ASCII characters
-if sys.platform == "win32":
-    import io as _io
-    if hasattr(sys.stdout, "reconfigure"):
-        sys.stdout.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[union-attr]
-    elif hasattr(sys.stdout, "detach"):
-        sys.stdout = _io.TextIOWrapper(sys.stdout.detach(), encoding="utf-8", errors="replace")  # type: ignore[union-attr]
-
-import argparse
-import json
-import os
-from datetime import datetime, timezone
-from pathlib import Path
-
-from common.paths import (
-    get_repo_root,
-    get_developer,
-    get_pool_dir,
-    get_pool_file,
-)
-
-
-# =============================================================================
-# Colors
-# =============================================================================
-
-class Colors:
-    RED = "\033[0;31m"
-    GREEN = "\033[0;32m"
-    YELLOW = "\033[1;33m"
-    BLUE = "\033[0;34m"
-    CYAN = "\033[0;36m"
-    NC = "\033[0m"
-
-
-def colored(text: str, color: str) -> str:
-    """Apply color to text."""
-    return f"{color}{text}{Colors.NC}"
-
-
-# =============================================================================
-# Constants
-# =============================================================================
-
-DEFAULT_POOLS = ["requirements", "prototypes", "implementations"]
-
-EMPTY_POOL = {"available": []}
-
-
-# =============================================================================
-# Pool I/O (atomic writes)
-# =============================================================================
-
-def _read_pool(pool_path: Path) -> dict:
-    """Read pool JSON file. Auto-create if missing, backup if corrupted."""
-    if not pool_path.is_file():
-        return {"available": []}
-
-    try:
-        data = json.loads(pool_path.read_text(encoding="utf-8"))
-        if not isinstance(data, dict) or "available" not in data:
-            raise ValueError("Invalid pool schema")
-        return data
-    except (json.JSONDecodeError, ValueError):
-        # Backup corrupted file
-        bak_path = pool_path.with_suffix(".json.bak")
-        try:
-            pool_path.rename(bak_path)
-            print(colored(f"  Warning: Corrupted pool backed up to {bak_path.name}", Colors.YELLOW))
-        except OSError:
-            pass
-        return {"available": []}
-
-
-def _write_pool(pool_path: Path, data: dict) -> bool:
-    """Write pool JSON atomically (write .tmp then os.replace)."""
-    tmp_path = pool_path.with_suffix(".json.tmp")
-    try:
-        pool_path.parent.mkdir(parents=True, exist_ok=True)
-        tmp_path.write_text(
-            json.dumps(data, indent=2, ensure_ascii=False) + "\n",
-            encoding="utf-8",
-        )
-        os.replace(str(tmp_path), str(pool_path))
-        return True
-    except (OSError, IOError) as e:
-        print(colored(f"  Error writing pool: {e}", Colors.RED))
-        # Clean up tmp if it exists
-        try:
-            tmp_path.unlink(missing_ok=True)
-        except OSError:
-            pass
-        return False
-
-
-# =============================================================================
-# Subcommands
-# =============================================================================
-
-def cmd_init(args: argparse.Namespace) -> int:
-    """Create pool JSON files."""
-    repo_root = get_repo_root()
-    pool_dir = get_pool_dir(repo_root)
-    pool_dir.mkdir(parents=True, exist_ok=True)
-
-    pool_names = args.pools if args.pools else DEFAULT_POOLS
-
-    for name in pool_names:
-        pool_path = pool_dir / f"{name}.json"
-        if pool_path.is_file():
-            print(colored(f"  Pool '{name}' already exists, skipping", Colors.YELLOW))
-            continue
-        if _write_pool(pool_path, EMPTY_POOL):
-            print(colored(f"  Created pool: {name}", Colors.GREEN))
-        else:
-            print(colored(f"  Failed to create pool: {name}", Colors.RED))
-            return 1
-
-    print(colored("Pool initialization complete.", Colors.GREEN))
-    return 0
-
-
-def cmd_add(args: argparse.Namespace) -> int:
-    """Add a deliverable to a pool."""
-    repo_root = get_repo_root()
-    pool_path = get_pool_file(args.pool, repo_root)
-
-    data = _read_pool(pool_path)
-
-    # Check for duplicate ID
-    for item in data["available"]:
-        if item["id"] == args.id:
-            print(colored(f"  Warning: ID '{args.id}' already exists in pool '{args.pool}', skipping", Colors.YELLOW))
-            return 0
-
-    developer = get_developer(repo_root) or "unknown"
-
-    entry = {
-        "id": args.id,
-        "title": args.title,
-        "path": args.path,
-        "completed_by": developer,
-        "completed_at": datetime.now(timezone.utc).isoformat(),
-        "handoff_doc": args.handoff if args.handoff else f"{args.path}/HANDOFF.md",
-        "status": "available",
-    }
-
-    data["available"].append(entry)
-
-    if _write_pool(pool_path, data):
-        print(colored(f"  Added '{args.id}' to pool '{args.pool}'", Colors.GREEN))
-        return 0
-    return 1
-
-
-def cmd_list(args: argparse.Namespace) -> int:
-    """List available items in pools."""
-    repo_root = get_repo_root()
-    pool_dir = get_pool_dir(repo_root)
-
-    if not pool_dir.is_dir():
-        print(colored("No pool directory found. Run 'pool.py init' first.", Colors.YELLOW))
-        return 0
-
-    pools_to_list = [args.pool] if args.pool else [
-        p.stem for p in sorted(pool_dir.glob("*.json"))
-    ]
-
-    if not pools_to_list:
-        print(colored("No pools found.", Colors.YELLOW))
-        return 0
-
-    for pool_name in pools_to_list:
-        pool_path = get_pool_file(pool_name, repo_root)
-        data = _read_pool(pool_path)
-
-        available = [i for i in data["available"] if i.get("status") == "available"]
-        consumed = [i for i in data["available"] if i.get("status") == "consumed"]
-
-        print(colored(f"\n=== {pool_name} ===", Colors.CYAN))
-        print(f"  Available: {len(available)}  |  Consumed: {len(consumed)}")
-
-        if available:
-            print(colored("  Available items:", Colors.GREEN))
-            for item in available:
-                print(f"    - {item['id']}: {item['title']} (by {item.get('completed_by', '?')})")
-        if consumed:
-            print(colored("  Consumed items:", Colors.YELLOW))
-            for item in consumed:
-                consumed_by = item.get("consumed_by", "?")
-                print(f"    - {item['id']}: {item['title']} (consumed by {consumed_by})")
-
-    print()
-    return 0
-
-
-def cmd_status(args: argparse.Namespace) -> int:
-    """Get status of a specific item."""
-    repo_root = get_repo_root()
-    pool_path = get_pool_file(args.pool, repo_root)
-    data = _read_pool(pool_path)
-
-    for item in data["available"]:
-        if item["id"] == args.id:
-            print(json.dumps(item, indent=2, ensure_ascii=False))
-            return 0
-
-    print(colored(f"  Item '{args.id}' not found in pool '{args.pool}'", Colors.RED))
-    return 1
-
-
-def cmd_consume(args: argparse.Namespace) -> int:
-    """Mark an item as consumed."""
-    repo_root = get_repo_root()
-    pool_path = get_pool_file(args.pool, repo_root)
-    data = _read_pool(pool_path)
-
-    for item in data["available"]:
-        if item["id"] == args.id:
-            if item.get("status") == "consumed":
-                consumed_by = item.get("consumed_by", "?")
-                print(colored(f"  Item '{args.id}' already consumed by {consumed_by}", Colors.YELLOW))
-                return 1
-
-            item["status"] = "consumed"
-            item["consumed_by"] = args.consumed_by
-            item["consumed_at"] = datetime.now(timezone.utc).isoformat()
-
-            if _write_pool(pool_path, data):
-                print(colored(f"  Marked '{args.id}' as consumed by {args.consumed_by}", Colors.GREEN))
-                return 0
-            return 1
-
-    print(colored(f"  Item '{args.id}' not found in pool '{args.pool}'", Colors.RED))
-    return 1
-
-
-# =============================================================================
-# CLI Parser
-# =============================================================================
-
-def build_parser() -> argparse.ArgumentParser:
-    """Build argument parser."""
-    parser = argparse.ArgumentParser(
-        description="Pool management for three-role collaboration pipeline",
-    )
-    subparsers = parser.add_subparsers(dest="command", help="Available commands")
-
-    # init
-    p_init = subparsers.add_parser("init", help="Create pool JSON files")
-    p_init.add_argument("pools", nargs="*", help="Pool names (default: requirements, prototypes, implementations)")
-
-    # add
-    p_add = subparsers.add_parser("add", help="Add deliverable to pool")
-    p_add.add_argument("pool", help="Pool name (e.g., requirements)")
-    p_add.add_argument("id", help="Deliverable ID (e.g., user-login)")
-    p_add.add_argument("title", help="Deliverable title")
-    p_add.add_argument("path", help="Path to deliverable directory")
-    p_add.add_argument("--handoff", help="Path to HANDOFF.md (default: <path>/HANDOFF.md)")
-
-    # list
-    p_list = subparsers.add_parser("list", help="List available items")
-    p_list.add_argument("pool", nargs="?", help="Pool name (omit for all)")
-
-    # status
-    p_status = subparsers.add_parser("status", help="Get item status")
-    p_status.add_argument("pool", help="Pool name")
-    p_status.add_argument("id", help="Item ID")
-
-    # consume
-    p_consume = subparsers.add_parser("consume", help="Mark item as consumed")
-    p_consume.add_argument("pool", help="Pool name")
-    p_consume.add_argument("id", help="Item ID")
-    p_consume.add_argument("consumed_by", help="Consumer identity (e.g., designer-bob)")
-
-    return parser
-
-
-# =============================================================================
-# Main
-# =============================================================================
-
-def main() -> int:
-    parser = build_parser()
-    args = parser.parse_args()
-
-    if not args.command:
-        parser.print_help()
-        return 1
-
-    commands = {
-        "init": cmd_init,
-        "add": cmd_add,
-        "list": cmd_list,
-        "status": cmd_status,
-        "consume": cmd_consume,
-    }
-
-    return commands[args.command](args)
-
-
-if __name__ == "__main__":
-    sys.exit(main())