taskode 0.4.0

package/README.md

@@ -0,0 +1,398 @@
+# 🚀 Taskode — 任务即代码
+
+> 把任务变成代码，让 AI 为你开发。
+
+---
+
+## ✨ 什么是 Taskode？
+
+**Taskode** 是一个本地优先（local-first）的 AI 开发操作系统，
+同时也是一个 **对齐 Symphony 设计理念的 Node.js 编排器实现**。
+
+只需一条命令：
+
+```bash
+taskode
+```
+
+你就可以在当前项目中获得一个完整的 AI 开发环境：
+
+* 🧠 内置任务 / Issue 管理系统
+* 🤖 AI 自动执行任务（生成代码、修改代码、补充测试）
+* 📊 实时可视化 AI 工作过程
+* 🧩 支持多任务源（Local / Linear / GitHub）
+* ⚙️ 可配置 Agent、并发与执行策略
+
+---
+
+## 🧠 核心理念
+
+> 任务即代码（Task = Code）
+
+传统开发：
+
+```text
+人 → 写代码 → 提交
+```
+
+Taskode：
+
+```text
+任务 → AI执行 → 生成代码 → 人审核
+```
+
+开发者从“写代码的人”，变成“管理 AI 工程团队的人”。
+
+---
+
+## 🧩 核心能力
+
+### 🗂️ 内置任务系统
+
+* 创建 / 编辑 / 管理任务（Todo / Issue）
+* 看板式流程（Todo / In Progress / Review / Done）
+* 支持任务依赖与拆解
+* 支持优先级与状态管理
+
+---
+
+### 🤖 AI 自动执行任务
+
+每个任务由 AI 在隔离环境中执行，输出：
+
+* 代码修改（diff）
+* 新增文件
+* 测试代码
+* 执行日志
+* 任务总结
+
+---
+
+### 🧠 Agent 调度系统
+
+* 任务队列管理
+* 多 Agent 并发执行
+* 自动失败重试
+* 状态持久化与恢复
+
+---
+
+### 🔁 Retry Queue（持久化）
+
+* 支持失败任务自动重试
+* 状态持久化（支持重启恢复）
+* 最大重试次数可配置
+
+---
+
+### 🧩 Workspace 生命周期管理
+
+每个任务运行在独立 workspace：
+
+```text
+.taskode/workspaces/{task-id}
+```
+
+支持：
+
+* 自动创建 / 复用
+* `after_create / before_run / after_run / before_remove` hooks
+* workspace 路径安全校验
+* SSH worker 远程 workspace
+* 终态自动清理
+
+---
+
+### 📊 可视化控制台
+
+启动后访问：
+
+```text
+http://localhost:4317
+```
+
+可查看：
+
+* 任务状态
+* Agent 执行过程
+* 日志与输出
+* 代码变更（diff）
+* 系统运行状态
+
+---
+
+### 🔌 多任务源支持
+
+支持：
+
+* Local（默认）
+* Linear（双向同步）
+* GitHub Issues（扩展）
+
+---
+
+### 🔗 Linear 双向闭环
+
+* 拉取任务
+* 评论同步
+* 状态迁移
+* 动态工具 `linear_graphql`
+
+---
+
+### 🔍 Review / Apply 流程
+
+* 自动生成 diff / patch
+* Web 端审核运行结果
+* 审批后应用 workspace 变更回主项目
+* 可回写任务评论 / 状态
+
+---
+
+### 🧠 App-Server 会话模式
+
+支持两种执行模式：
+
+#### 1️⃣ App-server 模式（推荐）
+
+* 多轮对话（turn-based）
+* token 使用可观测
+* JSON-RPC thread / turn 会话
+* 支持动态工具调用
+* 更接近真实 AI 编程
+
+#### 2️⃣ Shell 模式
+
+* 单次命令执行
+* 简单、快速
+
+---
+
+### 🔐 安全与策略控制
+
+* API Token 鉴权
+* 命令 allow / deny 策略
+* 审计日志（Audit Log）
+* 工作区路径逃逸防护
+* 默认 `workspace-write` turn sandbox policy
+
+---
+
+### ♻️ WORKFLOW 热重载
+
+* 运行中自动检测 `WORKFLOW.md` 变化
+* 重载失败保留 last-known-good 配置
+* 支持更严格的前置配置校验
+
+---
+
+### 🧪 测试门禁
+
+支持：
+
+* Unit Test
+* Integration Test
+* E2E Test
+
+可作为 AI 执行的质量门禁。
+
+---
+
+## 🚀 快速开始
+
+### 1️⃣ 安装
+
+```bash
+npm install -g taskode
+```
+
+---
+
+### 2️⃣ 初始化项目
+
+```bash
+taskode init
+```
+
+---
+
+### 3️⃣ 启动系统
+
+```bash
+npm run start
+```
+
+或：
+
+```bash
+taskode
+```
+
+---
+
+### 4️⃣ 打开控制台
+
+```text
+http://localhost:4317
+```
+
+---
+
+## ⚙️ 配置
+
+创建：
+
+```bash
+taskode.config.ts
+```
+
+示例：
+
+```ts
+export default {
+  project: {
+    name: "my-project",
+    root: ".",
+  },
+
+  web: {
+    port: 4317,
+  },
+
+  database: {
+    provider: "sqlite",
+    url: "./.taskode/data.db",
+  },
+
+  tracker: {
+    type: "local", // local | linear | github
+  },
+
+  agent: {
+    provider: "codex",
+    concurrency: 2,
+  },
+
+  git: {
+    baseBranch: "main",
+    workspaceDir: "./.taskode/workspaces",
+  },
+};
+```
+
+---
+
+## 🧩 WORKFLOW.md（核心运行配置）
+
+```yaml
+tracker:
+  kind: local # or linear
+
+agent:
+  poll_interval_ms: 3000
+  max_concurrent_agents: 2
+  max_retry_attempts: 5
+  max_turns: 20
+
+codex:
+  mode: shell # or app-server
+  command: echo "simulated codex run"
+  timeout_ms: 120000
+
+policy:
+  allow_commands: ["*"]
+  deny_commands: []
+
+auth:
+  token: $TASKODE_API_TOKEN
+
+hooks:
+  after_create: |
+    echo "workspace created"
+
+  before_remove: |
+    echo "cleanup start"
+
+  after_remove: |
+    echo "cleanup done"
+```
+
+---
+
+## 📁 项目目录结构
+
+```text
+.taskode/
+  ├── data.db
+  ├── logs/
+  ├── workspaces/
+  ├── runs/
+  └── config.json
+```
+
+---
+
+## 🔌 API
+
+### Public
+
+* `GET /api/health`
+
+### Protected（需要 token）
+
+* `GET /api/tasks`
+* `POST /api/tasks`
+* `PATCH /api/tasks/:id`
+* `GET /api/runs`
+* `GET /api/logs`
+* `GET /api/audit`
+* `GET /api/v1/state`
+* `GET /api/v1/:issueIdentifier`
+* `POST /api/v1/refresh`
+
+---
+
+## 🧪 Testing
+
+```bash
+npm run test:unit
+npm run test:integration
+npm run test:e2e
+npm test
+```
+
+---
+
+## 📌 Notes
+
+* Linear 模式需要 `LINEAR_API_KEY`
+* App-server 模式需要可运行的 agent 服务
+* 未配置 auth token 时 API 默认开放
+
+---
+
+## 🧠 设计原则
+
+* Local-first（本地优先）
+* 可观测（AI行为透明）
+* 可控（人类最终决策）
+* 可扩展（任务源 / agent / workflow）
+
+---
+
+## 🤝 贡献
+
+欢迎 PR。
+
+---
+
+## 📄 License
+
+MIT
+
+---
+
+## 🧠 最后一句
+
+> 不要写代码。
+> 让 AI 写代码。

package/WORKFLOW.md

@@ -0,0 +1,53 @@
+---
+tracker:
+  kind: local
+workspace:
+  root: ./.taskode/workspaces
+agent:
+  poll_interval_ms: 3000
+  max_concurrent_agents: 2
+  max_retry_attempts: 5
+  max_retry_backoff_ms: 60000
+  max_concurrent_agents_by_state: {}
+  max_turns: 20
+worker:
+  ssh_hosts: []
+  max_concurrent_agents_per_host:
+codex:
+  mode: shell
+  command: echo "simulated codex run"
+  timeout_ms: 120000
+  read_timeout_ms: 5000
+  turn_timeout_ms: 3600000
+  stall_timeout_ms: 300000
+  approval_policy:
+    reject:
+      sandbox_approval: true
+      rules: true
+      mcp_elicitations: true
+  thread_sandbox: workspace-write
+hooks:
+  after_create:
+  before_run:
+  after_run:
+  before_remove:
+  timeout_ms: 60000
+policy:
+  allow_commands: ["*"]
+  deny_commands: []
+auth:
+  token: $TASKODE_API_TOKEN
+server:
+  port: 4317
+---
+
+You are working on issue {{ issue.identifier }}.
+
+Title: {{ issue.title }}
+Body: {{ issue.description }}
+
+Deliverables:
+1) Plan
+2) Implementation
+3) Tests
+4) Summary

package/bin/taskode.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runCli } from '../src/cli.js';
+
+runCli(process.argv.slice(2)).catch((error) => {
+  console.error(`[taskode] fatal: ${error?.stack || error}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "taskode",
+  "version": "0.4.0",
+  "description": "Taskode - Symphony-aligned Node orchestrator for AI issue execution",
+  "type": "module",
+  "files": [
+    "README.md",
+    "WORKFLOW.md",
+    "bin",
+    "public",
+    "src"
+  ],
+  "bin": {
+    "taskode": "bin/taskode.js"
+  },
+  "scripts": {
+    "start": "node ./bin/taskode.js ./WORKFLOW.md",
+    "test": "npm run test:unit && npm run test:integration && npm run test:e2e",
+    "test:unit": "node --test test/*.test.js",
+    "test:integration": "node test/integration/orchestrator-flow.test.js && node test/integration/recovery-and-cleanup.test.js",
+    "test:e2e": "node test/e2e/cli-smoke.test.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "express": "^4.21.2",
+    "js-yaml": "^4.1.1"
+  }
+}