@agentunion/kite 1.3.2 → 1.5.0

package/scripts/plan_manager.py

@@ -0,0 +1,315 @@
+#!/usr/bin/env python3
+"""Kite CLI 开发计划管理器
+
+用于管理开发计划的进度、状态和任务分配。
+"""
+import json
+import re
+from datetime import datetime
+from pathlib import Path
+from typing import List, Dict, Optional
+
+
+class PlanManager:
+    """开发计划管理器"""
+
+    def __init__(self, plan_file: str = None):
+        if plan_file is None:
+            plan_file = Path(__file__).parent.parent / "docs" / "CLI开发计划.md"
+        self.plan_file = Path(plan_file)
+        self.state_file = self.plan_file.parent / ".cli_plan_state.json"
+        self.state = self._load_state()
+
+    def _load_state(self) -> Dict:
+        """加载计划状态"""
+        if self.state_file.exists():
+            with open(self.state_file, "r", encoding="utf-8") as f:
+                return json.load(f)
+        return {
+            "tasks": {},
+            "history": []
+        }
+
+    def _save_state(self):
+        """保存计划状态"""
+        with open(self.state_file, "w", encoding="utf-8") as f:
+            json.dump(self.state, f, indent=2, ensure_ascii=False)
+
+    def list_tasks(self, phase: Optional[str] = None, status: Optional[str] = None):
+        """列出任务"""
+        content = self.plan_file.read_text(encoding="utf-8")
+
+        # 解析任务
+        tasks = []
+        current_phase = None
+        current_section = None
+
+        for line in content.split("\n"):
+            # 检测 Phase
+            phase_match = re.match(r"## (Phase \d+):", line)
+            if phase_match:
+                current_phase = phase_match.group(1)
+                continue
+
+            # 检测子任务
+            section_match = re.match(r"### ([\d.]+) (.+)", line)
+            if section_match:
+                task_id = section_match.group(1)
+                task_name = section_match.group(2)
+                current_section = f"{current_phase}.{task_id}"
+
+                # 获取状态
+                task_state = self.state["tasks"].get(current_section, {})
+                task_status = task_state.get("status", "待开始")
+
+                tasks.append({
+                    "id": current_section,
+                    "phase": current_phase,
+                    "name": task_name,
+                    "status": task_status,
+                    "assignee": task_state.get("assignee"),
+                    "started_at": task_state.get("started_at"),
+                    "completed_at": task_state.get("completed_at")
+                })
+
+        # 过滤
+        if phase:
+            tasks = [t for t in tasks if t["phase"] == phase]
+        if status:
+            tasks = [t for t in tasks if t["status"] == status]
+
+        return tasks
+
+    def show_tasks(self, phase: Optional[str] = None, status: Optional[str] = None):
+        """显示任务列表"""
+        tasks = self.list_tasks(phase, status)
+
+        if not tasks:
+            print("没有找到任务")
+            return
+
+        print(f"\n{'ID':<20} {'任务名称':<30} {'状态':<10} {'负责人':<10}")
+        print("-" * 80)
+
+        for task in tasks:
+            task_id = task["id"]
+            name = task["name"][:28] + ".." if len(task["name"]) > 30 else task["name"]
+            status_str = task["status"]
+            assignee = task["assignee"] or "-"
+
+            print(f"{task_id:<20} {name:<30} {status_str:<10} {assignee:<10}")
+
+        print(f"\n共 {len(tasks)} 个任务")
+
+    def start_task(self, task_id: str, assignee: str = "开发者"):
+        """开始任务"""
+        if task_id not in self.state["tasks"]:
+            self.state["tasks"][task_id] = {}
+
+        self.state["tasks"][task_id].update({
+            "status": "进行中",
+            "assignee": assignee,
+            "started_at": datetime.now().isoformat()
+        })
+
+        self.state["history"].append({
+            "action": "start",
+            "task_id": task_id,
+            "assignee": assignee,
+            "timestamp": datetime.now().isoformat()
+        })
+
+        self._save_state()
+        print(f"[Done] 任务 {task_id} 已开始")
+
+    def complete_task(self, task_id: str, note: str = None):
+        """完成任务"""
+        if task_id not in self.state["tasks"]:
+            print(f"[Error] 任务 {task_id} 不存在")
+            return
+
+        self.state["tasks"][task_id].update({
+            "status": "已完成",
+            "completed_at": datetime.now().isoformat(),
+            "note": note
+        })
+
+        self.state["history"].append({
+            "action": "complete",
+            "task_id": task_id,
+            "note": note,
+            "timestamp": datetime.now().isoformat()
+        })
+
+        self._save_state()
+        print(f"[Done] 任务 {task_id} 已完成")
+
+    def block_task(self, task_id: str, reason: str):
+        """阻塞任务"""
+        if task_id not in self.state["tasks"]:
+            self.state["tasks"][task_id] = {}
+
+        self.state["tasks"][task_id].update({
+            "status": "阻塞",
+            "blocked_reason": reason,
+            "blocked_at": datetime.now().isoformat()
+        })
+
+        self.state["history"].append({
+            "action": "block",
+            "task_id": task_id,
+            "reason": reason,
+            "timestamp": datetime.now().isoformat()
+        })
+
+        self._save_state()
+        print(f"[Warning] 任务 {task_id} 已阻塞: {reason}")
+
+    def unblock_task(self, task_id: str):
+        """解除阻塞"""
+        if task_id not in self.state["tasks"]:
+            print(f"[Error] 任务 {task_id} 不存在")
+            return
+
+        self.state["tasks"][task_id].update({
+            "status": "进行中",
+            "blocked_reason": None,
+            "unblocked_at": datetime.now().isoformat()
+        })
+
+        self.state["history"].append({
+            "action": "unblock",
+            "task_id": task_id,
+            "timestamp": datetime.now().isoformat()
+        })
+
+        self._save_state()
+        print(f"[Done] 任务 {task_id} 已解除阻塞")
+
+    def show_progress(self):
+        """显示整体进度"""
+        tasks = self.list_tasks()
+
+        total = len(tasks)
+        completed = len([t for t in tasks if t["status"] == "已完成"])
+        in_progress = len([t for t in tasks if t["status"] == "进行中"])
+        blocked = len([t for t in tasks if t["status"] == "阻塞"])
+        pending = total - completed - in_progress - blocked
+
+        print("\n=== Kite CLI 开发进度 ===\n")
+        print(f"总任务数: {total}")
+        print(f"已完成:   {completed} ({completed/total*100:.1f}%)")
+        print(f"进行中:   {in_progress} ({in_progress/total*100:.1f}%)")
+        print(f"阻塞:     {blocked} ({blocked/total*100:.1f}%)")
+        print(f"待开始:   {pending} ({pending/total*100:.1f}%)")
+
+        # 按 Phase 统计
+        print("\n=== 各阶段进度 ===\n")
+        phases = {}
+        for task in tasks:
+            phase = task["phase"]
+            if phase not in phases:
+                phases[phase] = {"total": 0, "completed": 0}
+            phases[phase]["total"] += 1
+            if task["status"] == "已完成":
+                phases[phase]["completed"] += 1
+
+        for phase, stats in sorted(phases.items()):
+            total_p = stats["total"]
+            completed_p = stats["completed"]
+            percent = completed_p / total_p * 100 if total_p > 0 else 0
+            print(f"{phase}: {completed_p}/{total_p} ({percent:.1f}%)")
+
+    def show_history(self, limit: int = 10):
+        """显示操作历史"""
+        history = self.state["history"][-limit:]
+
+        if not history:
+            print("暂无操作历史")
+            return
+
+        print(f"\n最近 {len(history)} 条操作:\n")
+
+        for entry in history:
+            timestamp = entry["timestamp"][:19]
+            action = entry["action"]
+            task_id = entry["task_id"]
+
+            action_map = {
+                "start": "开始",
+                "complete": "完成",
+                "block": "阻塞",
+                "unblock": "解除阻塞"
+            }
+
+            action_str = action_map.get(action, action)
+            print(f"{timestamp} - {action_str} {task_id}")
+
+            if action == "complete" and entry.get("note"):
+                print(f"           备注: {entry['note']}")
+            elif action == "block" and entry.get("reason"):
+                print(f"           原因: {entry['reason']}")
+
+
+def main():
+    """命令行入口"""
+    import argparse
+
+    parser = argparse.ArgumentParser(description="Kite CLI 开发计划管理器")
+    subparsers = parser.add_subparsers(dest="command", help="命令")
+
+    # list 命令
+    list_parser = subparsers.add_parser("list", help="列出任务")
+    list_parser.add_argument("--phase", help="过滤 Phase")
+    list_parser.add_argument("--status", help="过滤状态")
+
+    # start 命令
+    start_parser = subparsers.add_parser("start", help="开始任务")
+    start_parser.add_argument("task_id", help="任务 ID")
+    start_parser.add_argument("--assignee", default="开发者", help="负责人")
+
+    # complete 命令
+    complete_parser = subparsers.add_parser("complete", help="完成任务")
+    complete_parser.add_argument("task_id", help="任务 ID")
+    complete_parser.add_argument("--note", help="备注")
+
+    # block 命令
+    block_parser = subparsers.add_parser("block", help="阻塞任务")
+    block_parser.add_argument("task_id", help="任务 ID")
+    block_parser.add_argument("reason", help="阻塞原因")
+
+    # unblock 命令
+    unblock_parser = subparsers.add_parser("unblock", help="解除阻塞")
+    unblock_parser.add_argument("task_id", help="任务 ID")
+
+    # progress 命令
+    progress_parser = subparsers.add_parser("progress", help="显示进度")
+
+    # history 命令
+    history_parser = subparsers.add_parser("history", help="显示历史")
+    history_parser.add_argument("--limit", type=int, default=10, help="显示条数")
+
+    args = parser.parse_args()
+
+    manager = PlanManager()
+
+    if args.command == "list":
+        manager.show_tasks(phase=args.phase, status=args.status)
+    elif args.command == "start":
+        manager.start_task(args.task_id, args.assignee)
+    elif args.command == "complete":
+        manager.complete_task(args.task_id, args.note)
+    elif args.command == "block":
+        manager.block_task(args.task_id, args.reason)
+    elif args.command == "unblock":
+        manager.unblock_task(args.task_id)
+    elif args.command == "progress":
+        manager.show_progress()
+    elif args.command == "history":
+        manager.show_history(args.limit)
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()

package/scripts/python-env.js

@@ -0,0 +1,79 @@
+/**
+ * Python 环境工具模块
+ *
+ * 提供获取虚拟环境 Python 路径的工具函数
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+/**
+ * 获取 KITE_DATA 路径
+ */
+function getKiteDataPath() {
+  return path.join(os.homedir(), '.kite');
+}
+
+/**
+ * 获取虚拟环境路径
+ */
+function getVenvPath() {
+  return path.join(getKiteDataPath(), 'venv');
+}
+
+/**
+ * 获取虚拟环境的 Python 可执行文件路径
+ */
+function getVenvPython() {
+  const venvPath = getVenvPath();
+
+  if (process.platform === 'win32') {
+    return path.join(venvPath, 'Scripts', 'python.exe');
+  } else {
+    return path.join(venvPath, 'bin', 'python');
+  }
+}
+
+/**
+ * 获取虚拟环境的 pip 可执行文件路径
+ */
+function getVenvPip() {
+  const venvPath = getVenvPath();
+
+  if (process.platform === 'win32') {
+    return path.join(venvPath, 'Scripts', 'pip.exe');
+  } else {
+    return path.join(venvPath, 'bin', 'pip');
+  }
+}
+
+/**
+ * 检查虚拟环境是否存在
+ */
+function venvExists() {
+  const pythonPath = getVenvPython();
+  return fs.existsSync(pythonPath);
+}
+
+/**
+ * 检查 Python 环境是否就绪
+ */
+function isPythonReady() {
+  if (!venvExists()) {
+    return false;
+  }
+
+  // 检查 pip 是否存在
+  const pipPath = getVenvPip();
+  return fs.existsSync(pipPath);
+}
+
+module.exports = {
+  getKiteDataPath,
+  getVenvPath,
+  getVenvPython,
+  getVenvPip,
+  venvExists,
+  isPythonReady
+};