@jahanxu/trellis 0.5.0 → 0.5.5

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

@@ -0,0 +1,252 @@
+#!/usr/bin/env python3
+"""
+Role management utilities for three-role collaboration pipeline.
+
+Provides:
+    parse_role_from_username   - Parse role prefix from username
+    load_roles_json            - Load roles.json
+    save_roles_json            - Save roles.json
+    get_upstream_dirs          - Get upstream directories for a role
+    upsert_developer_role      - Add or update developer role mapping
+    resolve_role_constraint    - Resolve role and output directory
+"""
+
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+
+from .paths import (
+    DIR_WORKFLOW,
+    FILE_ROLES_JSON,
+    FILE_TASK_JSON,
+    get_repo_root,
+    get_current_task,
+    get_developer,
+)
+
+
+# =============================================================================
+# Constants
+# =============================================================================
+
+KNOWN_ROLES = {"pm", "designer", "frontend"}
+
+
+# =============================================================================
+# JSON Helpers (per-module convention)
+# =============================================================================
+
+def _read_json_file(path: Path) -> dict | None:
+    """Read and parse a JSON file."""
+    try:
+        return json.loads(path.read_text(encoding="utf-8"))
+    except (FileNotFoundError, json.JSONDecodeError, OSError):
+        return None
+
+
+def _write_json_file(path: Path, data: dict) -> bool:
+    """Write dict to JSON file."""
+    try:
+        path.write_text(json.dumps(data, indent=2, ensure_ascii=False), encoding="utf-8")
+        return True
+    except (OSError, IOError):
+        return False
+
+
+# =============================================================================
+# Role Parsing
+# =============================================================================
+
+def parse_role_from_username(username: str) -> tuple[str | None, str]:
+    """Parse role from -u parameter prefix.
+
+    Splits username on the first hyphen. If the prefix is a known role,
+    returns it alongside the full name; otherwise returns None.
+
+    Args:
+        username: Developer username (e.g., "pm-alice", "bob").
+
+    Returns:
+        Tuple of (role, full_name). role is None if no known prefix found.
+    """
+    if not username:
+        return None, username or ""
+    parts = username.split("-", 1)
+    if len(parts) == 2 and parts[0] in KNOWN_ROLES:
+        return parts[0], username
+    return None, username
+
+
+# =============================================================================
+# roles.json I/O
+# =============================================================================
+
+def load_roles_json(repo_root: Path | None = None) -> dict | None:
+    """Load .trellis/roles.json.
+
+    Args:
+        repo_root: Repository root path. Defaults to auto-detected.
+
+    Returns:
+        Parsed dict or None if file doesn't exist or is invalid.
+    """
+    if repo_root is None:
+        repo_root = get_repo_root()
+
+    roles_file = repo_root / DIR_WORKFLOW / FILE_ROLES_JSON
+    return _read_json_file(roles_file)
+
+
+def save_roles_json(data: dict, repo_root: Path | None = None) -> bool:
+    """Save roles.json.
+
+    Args:
+        data: Dictionary to write.
+        repo_root: Repository root path. Defaults to auto-detected.
+
+    Returns:
+        True on success, False on error.
+    """
+    if repo_root is None:
+        repo_root = get_repo_root()
+
+    roles_file = repo_root / DIR_WORKFLOW / FILE_ROLES_JSON
+    return _write_json_file(roles_file, data)
+
+
+# =============================================================================
+# Upstream Directory Resolution
+# =============================================================================
+
+def get_upstream_dirs(role: str, roles_json: dict) -> list[str]:
+    """Get upstream directories (all dirs NOT owned by current role).
+
+    Args:
+        role: Current developer's role.
+        roles_json: Parsed roles.json dict.
+
+    Returns:
+        List of directory paths owned by other roles.
+    """
+    directories = roles_json.get("directories", {})
+    return [d for d, r in directories.items() if r != role]
+
+
+# =============================================================================
+# Developer Role Upsert
+# =============================================================================
+
+def upsert_developer_role(
+    name: str,
+    role: str,
+    output_dir: str,
+    repo_root: Path | None = None,
+) -> bool:
+    """Add or update developer role mapping in roles.json.
+
+    Creates roles.json if it doesn't exist. Appends to existing if it does.
+    Rejects if output_dir is already bound to a DIFFERENT role.
+    Overwrites if same developer re-inits (with warning).
+
+    Args:
+        name: Developer name.
+        role: Developer role (e.g., "pm", "designer", "frontend").
+        output_dir: Output directory path.
+        repo_root: Repository root path. Defaults to auto-detected.
+
+    Returns:
+        True on success, False on conflict.
+    """
+    if repo_root is None:
+        repo_root = get_repo_root()
+
+    data = load_roles_json(repo_root)
+    if data is None:
+        data = {"developers": {}, "directories": {}}
+
+    developers = data.get("developers", {})
+    directories = data.get("directories", {})
+
+    # Check conflict: output_dir already bound to a different role
+    if output_dir in directories and directories[output_dir] != role:
+        existing_role = directories[output_dir]
+        print(
+            f"Error: directory '{output_dir}' is already bound to role "
+            f"'{existing_role}', cannot assign to '{role}'",
+            file=sys.stderr,
+        )
+        return False
+
+    # Check re-init: same developer name already exists
+    if name in developers:
+        print(
+            f"Warning: developer '{name}' already exists, overwriting",
+            file=sys.stderr,
+        )
+
+    # Upsert
+    developers[name] = {"role": role, "output_dir": output_dir}
+    directories[output_dir] = role
+    data["developers"] = developers
+    data["directories"] = directories
+
+    return save_roles_json(data, repo_root)
+
+
+# =============================================================================
+# Role Constraint Resolution
+# =============================================================================
+
+def resolve_role_constraint(
+    repo_root: Path | None = None,
+) -> tuple[str | None, str | None]:
+    """Three-layer fallback to resolve role and output directory.
+
+    L1: .current-task -> task.json.role / output_dir (highest priority)
+    L2: .developer name -> roles.json[name] (persistent fallback)
+    L3: (None, None) - no constraint
+
+    Args:
+        repo_root: Repository root path. Defaults to auto-detected.
+
+    Returns:
+        Tuple of (role, output_dir). Both None if no constraint found.
+    """
+    if repo_root is None:
+        repo_root = get_repo_root()
+
+    # L1: current task -> task.json
+    current_task = get_current_task(repo_root)
+    if current_task:
+        task_json = _read_json_file(repo_root / current_task / FILE_TASK_JSON)
+        if task_json:
+            task_role = task_json.get("role")
+            task_output = task_json.get("output_dir")
+            if task_role and task_output:
+                return task_role, task_output
+
+    # L2: developer name -> roles.json
+    developer = get_developer(repo_root)
+    if developer:
+        roles_data = load_roles_json(repo_root)
+        if roles_data:
+            dev_entry = roles_data.get("developers", {}).get(developer)
+            if dev_entry:
+                return dev_entry.get("role"), dev_entry.get("output_dir")
+
+    # L3: no constraint
+    return None, None
+
+
+# =============================================================================
+# Main Entry (for testing)
+# =============================================================================
+
+if __name__ == "__main__":
+    repo = get_repo_root()
+    print(f"Repository root: {repo}")
+    print(f"Roles JSON: {load_roles_json(repo)}")
+    role, output_dir = resolve_role_constraint(repo)
+    print(f"Role constraint: role={role}, output_dir={output_dir}")

package/dist/templates/trellis/spec/roles/designer/index.md

@@ -0,0 +1,49 @@
+# Designer Role Specification
+
+> Work standards and constraints for the Interaction Designer role.
+
+---
+
+## Role Definition
+
+- **Role ID**: designer
+- **Primary Output**: Interactive prototypes with mock data
+- **Output Directory**: Bound via `trellis init -d`
+
+## Work Standards
+
+### Prototype Requirements
+- All prototypes must be runnable (not static mockups)
+- Use inline mock data with `// TODO: replace with real API` markers
+- Follow the project's existing component library and design system
+
+### Mock Data Convention
+- Inline mock data in component files (not separate mock files)
+- Mark every mock with: `// TODO: replace with real API`
+- Use realistic but clearly fake data (e.g., "test@example.com")
+
+### Component Structure
+- One component per file
+- Clear component hierarchy documented in HANDOFF.md
+- Props interface defined for each component
+
+### Quality Checklist
+- [ ] Prototype renders without errors
+- [ ] All mock data marked with TODO comments
+- [ ] Component hierarchy documented
+- [ ] Responsive layout considered
+- [ ] Accessibility basics covered (labels, alt text)
+
+## Handoff Guidelines
+
+When running `/trellis:handoff`:
+- List all components created with brief descriptions
+- Document mock data locations (file:line)
+- Create "needs frontend implementation" checklist
+- Note any design decisions that differ from PRD
+
+## Constraints
+
+- Only write files within your bound output directory
+- Do not modify requirements or production code
+- Mock data must be inline, not in separate services

package/dist/templates/trellis/spec/roles/frontend-impl/index.md

@@ -0,0 +1,52 @@
+# Frontend Implementation Role Specification
+
+> Work standards and constraints for the Frontend Developer role.
+
+---
+
+## Role Definition
+
+- **Role ID**: frontend
+- **Primary Output**: Production-ready frontend code
+- **Output Directory**: Bound via `trellis init -d`
+
+## Work Standards
+
+### Implementation Guidelines
+- Replace all mock data with real API calls
+- Follow the project's existing patterns for API integration
+- Preserve prototype's component structure unless refactoring is justified
+
+### API Integration
+- Use the project's standard HTTP client
+- Implement proper error handling for all API calls
+- Add loading states for async operations
+- Handle empty states and error states
+
+### Code Quality
+- TypeScript strict mode compliance
+- No `any` types without justification
+- Unit tests for business logic
+- Integration tests for API calls
+
+### Quality Checklist
+- [ ] All `// TODO: replace with real API` markers resolved
+- [ ] Error handling implemented for all API calls
+- [ ] Loading and empty states handled
+- [ ] TypeScript compiles without errors
+- [ ] Lint passes
+- [ ] Core business logic has unit tests
+
+## Handoff Guidelines
+
+When running `/trellis:handoff`:
+- List API integrations completed
+- Document any deviations from prototype
+- Note remaining technical debt or known issues
+- Include test coverage summary
+
+## Constraints
+
+- Only write files within your bound output directory
+- Do not modify requirements or prototype code
+- Preserve prototype component interfaces unless explicitly agreed

package/dist/templates/trellis/spec/roles/pm/index.md

@@ -0,0 +1,44 @@
+# PM Role Specification
+
+> Work standards and constraints for the Product Manager role.
+
+---
+
+## Role Definition
+
+- **Role ID**: pm
+- **Primary Output**: Requirements documents (PRD, user stories, acceptance criteria)
+- **Output Directory**: Bound via `trellis init -d`
+
+## Work Standards
+
+### Document Structure
+- Every feature must have a PRD with: Goal, User Stories, Acceptance Criteria
+- Use markdown format with clear headings and numbered lists
+- Include edge cases and error scenarios
+
+### Naming Conventions
+- PRD files: `prd-<feature-name>.md`
+- User stories: `user-stories-<feature-name>.md`
+- Use kebab-case for all filenames
+
+### Quality Checklist
+- [ ] PRD has clear goal statement
+- [ ] User stories follow "As a... I want... So that..." format
+- [ ] Acceptance criteria are testable
+- [ ] Edge cases documented
+- [ ] Dependencies on other roles noted
+
+## Handoff Guidelines
+
+When running `/trellis:handoff`:
+- Ensure all PRD sections are complete
+- Flag any open questions or assumptions
+- List dependencies for Designer role
+- Include reference links (Figma, API docs, etc.)
+
+## Constraints
+
+- Only write files within your bound output directory
+- Do not modify prototype or production code
+- Do not make technical implementation decisions (leave to Designer/Frontend)

package/dist/utils/template-hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-hash.d.ts","sourceRoot":"","sources":["../../src/utils/template-hash.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AASD;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAYtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAGpE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAQ1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAU1E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAIlE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,IAAI,CAON;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,cAAc,GACrB,OAAO,CAmBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB,OAAO,CAST;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EAAE,EACvB,MAAM,EAAE,cAAc,GACrB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAQtB;AAoED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoBpD"}
+{"version":3,"file":"template-hash.d.ts","sourceRoot":"","sources":["../../src/utils/template-hash.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AASD;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAYtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAGpE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAQ1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAU1E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAIlE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,IAAI,CAON;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,cAAc,GACrB,OAAO,CAmBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB,OAAO,CAST;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EAAE,EACvB,MAAM,EAAE,cAAc,GACrB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAQtB;AAsED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoBpD"}

package/dist/utils/template-hash.js

@@ -164,7 +164,9 @@ const EXCLUDE_FROM_HASH = [
     ".current-task", // Current task marker (file, not directory)
     "spec/frontend/", // User-filled spec files
     "spec/backend/", // User-filled spec files
+    "spec/roles/", // Role spec templates (user-customizable)
     ".backup-", // Backup directories
+    "roles.json", // Role mapping file (user data)
 ];
 /**
  * Check if a path should be excluded from hash tracking

package/dist/utils/template-hash.js.map

@@ -1 +1 @@
-{"version":3,"file":"template-hash.js","sourceRoot":"","sources":["../../src/utils/template-hash.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"template-hash.js","sourceRoot":"","sources":["../../src/utils/template-hash.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jahanxu/trellis",
-  "version": "0.5.0",
+  "version": "0.5.5",
   "description": "AI capabilities grow like ivy — Trellis provides the structure to guide them along a disciplined path",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,7 +24,7 @@
     "memory",
     "trellis"
   ],
-  "author": "jahanxu",
+  "author": "Mindfold LLC",
   "license": "AGPL-3.0-only",
   "dependencies": {
     "chalk": "^5.3.0",

package/dist/templates/claude/commands/trellis/pick-task.md

@@ -1,145 +0,0 @@
-# Pick Task - Select Upstream Deliverable and Start Working
-
-Pick a deliverable from an upstream pool, create a task directory, and inject upstream context.
-
----
-
-## Usage
-
-```
-/trellis:pick-task <pool> <id>
-```
-
-- `<pool>`: `requirements` (for Designers) or `prototypes` (for Frontend)
-- `<id>`: deliverable ID to pick (e.g., `user-login`)
-
----
-
-## Process `[AI]`
-
-### Step 1: Validate Role
-
-```bash
-python3 ./.trellis/scripts/get_context.py
-```
-
-Read the developer name from `.developer` file. Parse role from `{role}-{name}` convention.
-
-Validate role-pool match:
-- `designer` can pick from `requirements`
-- `frontend` / `frontend-impl` can pick from `prototypes`
-- `pm` should NOT pick from pools (PMs create tasks directly)
-
-If role cannot be parsed, warn but continue (soft detection).
-
-### Step 2: Check Pool Availability
-
-```bash
-python3 ./.trellis/scripts/pool.py status <pool> <id>
-```
-
-Verify the item:
-- Exists in the pool
-- Status is `available` (not `consumed`)
-
-If not available, list what IS available:
-```bash
-python3 ./.trellis/scripts/pool.py list <pool>
-```
-
-### Step 3: Check Current Task
-
-If there is already a current task set, ask:
-> "You have an active task: `<current-task>`. Would you like to finish it first, or switch to the new task?"
-
-If user wants to continue, proceed.
-
-### Step 4: Create Task Directory
-
-Determine task suffix based on pool:
-- `requirements` pool -> `{id}-prototype`
-- `prototypes` pool -> `{id}-impl`
-
-```bash
-TASK_DIR=$(python3 ./.trellis/scripts/task.py create "<title>" --slug <id>-<suffix>)
-```
-
-### Step 5: Write source.json
-
-Create `source.json` in the task directory to reference upstream:
-
-```json
-{
-  "based_on": {
-    "type": "<requirement|prototype>",
-    "id": "<id>",
-    "path": "<deliverable path>",
-    "handoff_doc": "<path>/HANDOFF.md"
-  }
-}
-```
-
-Write this file:
-```bash
-cat > "$TASK_DIR/source.json" << 'EOF'
-{content}
-EOF
-```
-
-### Step 6: Configure Context (JSONL)
-
-Initialize context files for the task:
-
-```bash
-python3 ./.trellis/scripts/task.py init-context "$TASK_DIR" frontend
-```
-
-Add upstream deliverable files and role specs to context:
-
-```bash
-# Add role spec
-python3 ./.trellis/scripts/task.py add-context "$TASK_DIR" implement ".trellis/spec/roles/<role>/index.md" "Role guidelines"
-
-# Add upstream HANDOFF doc
-python3 ./.trellis/scripts/task.py add-context "$TASK_DIR" implement "<handoff_doc>" "Upstream handoff document"
-
-# Add upstream deliverable directory files
-# (add each significant file from the upstream output)
-python3 ./.trellis/scripts/task.py add-context "$TASK_DIR" implement "<upstream_file>" "Upstream deliverable"
-```
-
-### Step 7: Consume from Pool
-
-```bash
-python3 ./.trellis/scripts/pool.py consume <pool> <id> <developer>
-```
-
-### Step 8: Activate Task
-
-```bash
-python3 ./.trellis/scripts/task.py start "$TASK_DIR"
-```
-
-### Step 9: Read Upstream Context
-
-Read and summarize the upstream deliverables for the user:
-
-1. Read the HANDOFF.md document
-2. List all upstream files
-3. Summarize key points the user should know
-
-### Step 10: Report
-
-```
-Task picked and ready!
-- Task: <task-dir>
-- Based on: <pool>/<id>
-- Upstream: <deliverable-path>
-- Role specs loaded: .trellis/spec/roles/<role>/
-
-Key points from upstream HANDOFF:
-- (summary point 1)
-- (summary point 2)
-
-What would you like to work on first?
-```