@jahanxu/trellis 0.4.1 → 0.5.0

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

@@ -20,8 +20,9 @@ Usage:
     python3 task.py list-archive [month]        # List archived tasks
 """
 
+from __future__ import annotations
+
 import sys
-from typing import Optional
 
 # IMPORTANT: Force stdout to use UTF-8 on Windows
 # This fixes UnicodeEncodeError when outputting non-ASCII characters
@@ -83,7 +84,7 @@ def colored(text: str, color: str) -> str:
 # Helper Functions
 # =============================================================================
 
-def _read_json_file(path: Path) -> Optional[dict]:
+def _read_json_file(path: Path) -> dict | None:
     """Read and parse a JSON file."""
     try:
         return json.loads(path.read_text(encoding="utf-8"))
@@ -868,105 +869,6 @@ def cmd_set_scope(args: argparse.Namespace) -> int:
     return 0
 
 
-# =============================================================================
-# Command: set-role
-# =============================================================================
-
-def cmd_set_role(args: argparse.Namespace) -> int:
-    """Set role for three-role collaboration."""
-    repo_root = get_repo_root()
-    target_dir = _resolve_task_dir(args.dir, repo_root)
-    role = args.role
-
-    if not role:
-        print(colored("Error: Missing arguments", Colors.RED))
-        print("Usage: python3 task.py set-role <task-dir> <pm|designer|frontend>")
-        return 1
-
-    task_json = target_dir / FILE_TASK_JSON
-    if not task_json.is_file():
-        print(colored(f"Error: task.json not found at {target_dir}", Colors.RED))
-        return 1
-
-    data = _read_json_file(task_json)
-    if not data:
-        return 1
-
-    data["role"] = role
-    _write_json_file(task_json, data)
-
-    print(colored(f"✓ Role set to: {role}", Colors.GREEN))
-    print()
-    print(colored("Next steps:", Colors.BLUE))
-    print(f"  1. Read role spec: cat .trellis/spec/roles/{role}/index.md")
-    print(f"  2. Set as current: python3 task.py start {args.dir}")
-    return 0
-
-
-# =============================================================================
-# Command: set-source
-# =============================================================================
-
-def cmd_set_source(args: argparse.Namespace) -> int:
-    """Set upstream source reference for three-role collaboration."""
-    repo_root = get_repo_root()
-    target_dir = _resolve_task_dir(args.dir, repo_root)
-    pool_type = args.pool_type
-    task_id = args.task_id
-
-    if not pool_type or not task_id:
-        print(colored("Error: Missing arguments", Colors.RED))
-        print("Usage: python3 task.py set-source <task-dir> <requirements|prototypes> <task-id>")
-        return 1
-
-    task_json = target_dir / FILE_TASK_JSON
-    if not task_json.is_file():
-        print(colored(f"Error: task.json not found at {target_dir}", Colors.RED))
-        return 1
-
-    # Read pool to find upstream task
-    import sys
-    sys.path.insert(0, str(Path(__file__).parent))
-    from pool import get_pool_file, read_pool, find_task_in_pool
-
-    pool_file = get_pool_file(pool_type, repo_root)
-    pool_data = read_pool(pool_file)
-
-    status, upstream_task = find_task_in_pool(pool_data, task_id)
-
-    if not status:
-        print(colored(f"Error: Task '{task_id}' not found in {pool_type} pool", Colors.RED))
-        return 1
-
-    if status == "consumed":
-        print(colored(f"Warning: Task '{task_id}' is already consumed", Colors.YELLOW))
-        confirm = input("Continue anyway? [y/N] ")
-        if confirm.lower() != 'y':
-            return 0
-
-    # Create source.json
-    source_data = {
-        "based_on": {
-            "type": pool_type.rstrip('s'),  # requirements -> requirement
-            "id": task_id,
-            "path": upstream_task["path"],
-            "handoff_doc": upstream_task["handoff_doc"]
-        }
-    }
-
-    source_file = target_dir / "source.json"
-    source_file.write_text(json.dumps(source_data, indent=2, ensure_ascii=False), encoding="utf-8")
-
-    print(colored(f"✓ Source reference set", Colors.GREEN))
-    print(f"  Type: {pool_type}")
-    print(f"  ID: {task_id}")
-    print(f"  Path: {upstream_task['path']}")
-    print()
-    print(colored("Upstream context will be auto-injected when you start this task", Colors.BLUE))
-
-    return 0
-
-
 # =============================================================================
 # Command: create-pr (delegates to multi-agent script)
 # =============================================================================
@@ -1005,8 +907,6 @@ Usage:
   python3 task.py finish                             Clear current task
   python3 task.py set-branch <dir> <branch>          Set git branch for multi-agent
   python3 task.py set-scope <dir> <scope>            Set scope for PR title
-  python3 task.py set-role <dir> <role>              Set role (pm|designer|frontend)
-  python3 task.py set-source <dir> <pool> <task-id>  Set upstream source reference
   python3 task.py create-pr [dir] [--dry-run]        Create PR from task
   python3 task.py archive <task-name>                Archive completed task
   python3 task.py list [--mine] [--status <status>]  List tasks
@@ -1097,17 +997,6 @@ def main() -> int:
     p_scope.add_argument("dir", help="Task directory")
     p_scope.add_argument("scope", help="Scope name")
 
-    # set-role
-    p_role = subparsers.add_parser("set-role", help="Set role (pm|designer|frontend)")
-    p_role.add_argument("dir", help="Task directory")
-    p_role.add_argument("role", choices=["pm", "designer", "frontend"], help="Role type")
-
-    # set-source
-    p_source = subparsers.add_parser("set-source", help="Set upstream source")
-    p_source.add_argument("dir", help="Task directory")
-    p_source.add_argument("pool_type", choices=["requirements", "prototypes"], help="Upstream pool type")
-    p_source.add_argument("task_id", help="Upstream task ID")
-
     # create-pr
     p_pr = subparsers.add_parser("create-pr", help="Create PR")
     p_pr.add_argument("dir", nargs="?", help="Task directory")
@@ -1143,8 +1032,6 @@ def main() -> int:
         "set-branch": cmd_set_branch,
         "set-base-branch": cmd_set_base_branch,
         "set-scope": cmd_set_scope,
-        "set-role": cmd_set_role,
-        "set-source": cmd_set_source,
         "create-pr": cmd_create_pr,
         "archive": cmd_archive,
         "list": cmd_list,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jahanxu/trellis",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "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": "Mindfold LLC",
+  "author": "jahanxu",
   "license": "AGPL-3.0-only",
   "dependencies": {
     "chalk": "^5.3.0",
@@ -59,7 +59,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/Michaelxwb/Trellis.git"
+    "url": "https://github.com/mindfold-ai/trellis.git"
   },
   "scripts": {
     "build": "tsc && pnpm run copy-templates",

package/dist/templates/claude/commands/trellis/before-role-work.md

@@ -1,364 +0,0 @@
-# Before Role Work - 加载角色工作规范
-
-在开始任务前，加载并展示当前角色的工作规范，帮助 AI 和用户理解角色职责和标准。
-
----
-
-## 使用场景
-
-| 角色 | 何时使用 | 读取什么 |
-|------|---------|---------|
-| **PM** | 编写 PRD 前 | PM 工作规范、PRD 模板 |
-| **Designer** | 创建原型前 | Designer 工作规范、原型标准 |
-| **Frontend** | 补充逻辑前 | Frontend 工作规范、API 集成指南 |
-
----
-
-## 命令格式
-
-```bash
-/trellis:before-role-work
-```
-
-**无需参数** - 自动检测当前任务的角色
-
----
-
-## 执行流程
-
-### Step 1: 检测当前任务
-
-```bash
-cat .trellis/.current-task
-```
-
-**输出示例**：`.trellis/tasks/designer/02-28-user-login`
-
-**如果没有当前任务**：
-```
-Error: 没有设置当前任务
-
-请先执行以下命令之一：
-  - 创建新任务：python3 .trellis/scripts/task.py create "<title>"
-  - 或选择任务：/trellis:pick-task <pool-type> <task-id>
-```
-
----
-
-### Step 2: 读取任务角色
-
-```bash
-cat <task_dir>/task.json | jq -r '.role'
-```
-
-**输出示例**：`designer`
-
-**如果 task.json 缺少 role 字段**：
-```
-Error: task.json 缺少 role 字段
-
-请先设置角色：
-  python3 .trellis/scripts/task.py set-role <task-dir> <pm|designer|frontend>
-```
-
----
-
-### Step 3: 读取角色规范
-
-**规范文件路径**：
-```python
-role_spec_dir = f".trellis/spec/roles/{role}/"
-index_file = f"{role_spec_dir}/index.md"
-```
-
-**角色规范映射**：
-| Role | 规范目录 | 主文件 |
-|------|---------|--------|
-| `pm` | `.trellis/spec/roles/pm/` | `index.md` |
-| `designer` | `.trellis/spec/roles/designer/` | `index.md` |
-| `frontend` | `.trellis/spec/roles/frontend-impl/` | `index.md` |
-
-**读取文件**：
-```bash
-cat <index_file>
-```
-
-**如果文件不存在**：
-```
-Warning: 角色规范文件未找到
-
-路径: .trellis/spec/roles/<role>/index.md
-
-建议：
-  1. 创建规范文件（参考 Trellis 设计文档）
-  2. 或跳过此步骤，直接开始开发
-```
-
----
-
-### Step 4: 读取补充文档（可选）
-
-**根据角色加载额外文档**：
-
-#### PM 角色
-```bash
-# PRD 模板
-cat .trellis/spec/roles/pm/prd-template.md
-```
-
-#### Designer 角色
-```bash
-# 原型代码指南
-cat .trellis/spec/roles/designer/prototype-guidelines.md
-
-# Mock 数据标准
-cat .trellis/spec/roles/designer/mock-data-standards.md
-```
-
-#### Frontend 角色
-```bash
-# API 集成指南
-cat .trellis/spec/roles/frontend-impl/api-integration.md
-
-# 状态管理规范
-cat .trellis/spec/roles/frontend-impl/state-management.md
-```
-
-**注意**：补充文档是可选的，如果文件不存在，跳过即可。
-
----
-
-### Step 5: 展示给用户
-
-**格式化输出**：
-
-```markdown
-=== PM 工作规范 ===
-
-## 角色定位
-产品经理（PM）是三角色协作流水线的第一环...
-
-## 工作流程
-1. 创建任务
-2. 编写PRD
-3. 完成并交接
-
-## PRD标准
-### 必需章节
-1. 功能概述
-2. 用户故事
-...
-
-[完整规范内容]
-
----
-
-=== 补充文档 ===
-
-## PRD 模板
-[prd-template.md 内容...]
-
----
-
-📖 阅读完毕。现在开始按照规范工作吧！
-```
-
----
-
-### Step 6: 可选 - 高亮关键信息
-
-**AI 可以提取并高亮关键检查清单**：
-
-#### PM 关键要点
-```
-📋 PM 工作检查清单：
-
-在执行 /trellis:handoff 前，确保：
-  □ PRD包含所有必需章节
-  □ 用户故事清晰完整
-  □ 验收标准可测试
-  □ 非功能需求已明确
-  □ 相关资源链接有效
-```
-
-#### Designer 关键要点
-```
-📋 Designer 工作检查清单：
-
-在执行 /trellis:handoff 前，确保：
-  □ 原型可运行（npm run dev 无报错）
-  □ 所有交互可操作
-  □ Mock数据结构合理
-  □ TODO注释清晰
-  □ 组件命名语义化
-```
-
-#### Frontend 关键要点
-```
-📋 Frontend 工作检查清单：
-
-在执行 /trellis:handoff 前，确保：
-  □ 所有PRD要求的功能已实现
-  □ Mock API已全部替换为真实API
-  □ 错误处理完善
-  □ TypeScript编译无错误
-  □ 单元测试覆盖核心逻辑
-```
-
----
-
-## 错误处理
-
-### 错误场景1：没有当前任务
-```
-Error: 没有设置当前任务
-
-请先创建或选择任务：
-  - 新任务：python3 .trellis/scripts/task.py create "<title>"
-  - 选择任务：/trellis:pick-task <pool-type> <task-id>
-  - 恢复任务：python3 .trellis/scripts/task.py start <task-dir>
-```
-
-### 错误场景2：task.json 缺少 role 字段
-```
-Error: 无法确定任务角色
-
-task.json 缺少 role 字段，请先设置：
-  python3 .trellis/scripts/task.py set-role <task-dir> <pm|designer|frontend>
-```
-
-### 错误场景3：角色规范文件不存在
-```
-Warning: 角色规范文件未找到
-
-路径: .trellis/spec/roles/<role>/index.md
-
-可能原因：
-  - 项目尚未配置角色规范
-  - role 字段值错误
-
-建议：
-  1. 检查 role 字段：pm | designer | frontend
-  2. 创建规范文件（参考设计文档）
-  3. 或跳过此步骤，直接开始工作
-```
-
----
-
-## 示例执行流程
-
-### Designer 开始工作前加载规范
-
-```bash
-# 用户执行命令
-/trellis:before-role-work
-
-# AI 执行流程
-1. 读取当前任务：.trellis/tasks/designer/02-28-user-login
-2. 读取 task.json：role=designer ✅
-3. 读取规范：.trellis/spec/roles/designer/index.md
-4. 读取补充文档：
-   - prototype-guidelines.md
-   - mock-data-standards.md
-5. 展示给用户
-
-# AI 输出
-=== Designer 工作规范 ===
-
-## 角色定位
-交互设计师（Designer）是三角色协作流水线的第二环...
-
-## 工作流程
-1. 选择需求：/trellis:pick-task requirements <task-id>
-2. 创建原型
-3. 完成并交接：/trellis:handoff
-
-## 原型代码标准
-### 必需要素
-1. 可运行性 - 原型可以直接 npm run dev 运行
-2. Mock数据规范 - 集中管理，易于替换
-3. Mock API位置标注 - 使用清晰的TODO注释
-
-...
-
----
-
-📋 Designer 工作检查清单：
-
-在执行 /trellis:handoff 前，确保：
-  □ 原型可运行（npm run dev 无报错）
-  □ 所有交互可操作（按钮、表单、链接）
-  □ Mock数据结构合理（接近真实API）
-  □ TODO注释清晰（标注需要替换的Mock）
-  □ 组件命名语义化
-  □ 已测试关键交互流程
-  □ HANDOFF文档包含所有关键信息
-
----
-
-📖 规范已加载。现在开始按照标准创建原型吧！
-```
-
----
-
-## 高级功能（可选）
-
-### 自动调用
-```
-在某些情况下，AI 可以自动调用此命令（无需用户明确请求）：
-
-触发条件：
-  - 用户首次开始任务（task.py start 后）
-  - 用户询问"我应该做什么"、"如何开始"
-
-AI 主动提示：
-  "我注意到这是一个 Designer 任务，让我先加载工作规范..."
-  [自动执行 /trellis:before-role-work]
-```
-
-### 只显示检查清单
-```bash
-# 用户可能只想看检查清单，不看完整规范
-/trellis:before-role-work --checklist
-
-AI 只输出检查清单部分
-```
-
----
-
-## 与其他命令的集成
-
-### 与 /trellis:pick-task 集成
-```
-在 /trellis:pick-task 执行完成后，AI 可以提示：
-
-"任务已创建。是否查看 Designer 工作规范？
- 执行：/trellis:before-role-work"
-```
-
-### 与 /trellis:start 集成
-```
-在 /trellis:start 执行完成后，AI 可以自动加载规范：
-
-"已设置当前任务。正在加载 PM 工作规范..."
-[自动执行 /trellis:before-role-work]
-```
-
----
-
-## 注意事项
-
-1. **规范更新**：角色规范文件应该随着项目演进而更新
-2. **团队定制**：不同团队可以定制自己的角色规范
-3. **版本控制**：规范文件应该提交到 git，团队共享
-4. **可选性**：此命令是辅助性的，用户可以选择跳过
-
----
-
-## 命令别名（可选）
-
-用户可能使用以下变体，AI 应识别并执行相同逻辑：
-- `/trellis:before-role-work`
-- `/before-work`
-- "/加载工作规范"
-- "我应该如何开始这个任务"（AI 主动调用）

package/dist/templates/trellis/VERSION

@@ -1 +0,0 @@
-0.4.0

package/dist/templates/trellis/deliverables/README.md

@@ -1,51 +0,0 @@
-# Deliverables - 三角色产出物池
-
-本目录存放PM、Designer、Frontend三个角色的产出物。
-
-## 目录结构
-
-```
-deliverables/
-├── requirements/     # PM产出池：需求文档
-├── prototypes/       # Designer产出池：前端原型代码
-└── production/       # Frontend产出池：生产代码
-```
-
-## 工作流程
-
-### PM角色
-1. 在 `.trellis/tasks/pm/` 创建任务
-2. 编写PRD和用户故事
-3. 执行 `/trellis:handoff` 生成HANDOFF.md
-4. 产出自动进入 `deliverables/requirements/{task-id}/`
-
-### Designer角色
-1. 执行 `/trellis:pick-task requirements {task-id}` 选择需求
-2. 基于需求生成前端原型（带Mock数据）
-3. 执行 `/trellis:handoff` 生成HANDOFF.md
-4. 产出自动进入 `deliverables/prototypes/{task-id}/`
-
-### Frontend角色
-1. 执行 `/trellis:pick-task prototypes {task-id}` 选择原型
-2. 补充真实API调用和业务逻辑
-3. 执行 `/trellis:handoff` 生成HANDOFF.md
-4. 产出自动进入 `deliverables/production/{task-id}/`
-
-## 产出物要求
-
-每个产出目录必须包含：
-- `HANDOFF.md` - 交接文档（AI自动生成）
-- 角色相关的产出文件（PRD、代码等）
-
-## 任务池状态
-
-产出物状态由 `.trellis/pool/{pool-type}.json` 管理：
-- `available` - 可被下游消费
-- `consumed` - 已被下游领取
-
-查看任务池状态：
-```bash
-python3 .trellis/scripts/pool.py list requirements
-python3 .trellis/scripts/pool.py list prototypes
-python3 .trellis/scripts/pool.py list implementations
-```