@bicorne/task-flow 0.1.0

package/dist/commands/extract.js

@@ -0,0 +1,477 @@
+"use strict";
+/**
+ * commands/extract.ts
+ * Extract project requirements and generate PRD document
+ *
+ * This command is AI-only - use it to summarize existing projects
+ * and generate structured Product Requirement Documents.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extract = extract;
+exports.main = main;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("../lib/config");
+function parseArgs(argv) {
+    const args = {};
+    for (let i = 2; i < argv.length; i += 1) {
+        const token = argv[i] || '';
+        if (!token.startsWith('--')) {
+            continue;
+        }
+        const key = token.slice(2);
+        const next = argv[i + 1] || '';
+        if (!next || next.startsWith('--')) {
+            args[key] = true;
+            continue;
+        }
+        args[key] = next;
+        i += 1;
+    }
+    return args;
+}
+function loadTemplate(name) {
+    const templatePath = path.resolve(__dirname, '../../assets', name);
+    if (fs.existsSync(templatePath)) {
+        return fs.readFileSync(templatePath, 'utf8');
+    }
+    return `# 产品需求文档
+
+## 文档基础信息（Meta Data）
+
+| 字段 | 内容 |
+|------|------|
+| 项目名称 | <!-- 项目名称 --> |
+| 版本 | v1.0.0 |
+| 创建日期 | <!-- YYYY-MM-DD --> |
+| 作者 | <!-- 作者 --> |
+| 文档状态 | 草稿 |
+| 评审人 | <!-- 评审人列表 --> |
+
+## 项目背景与目标（Why）
+
+### 背景
+<!-- 描述项目背景和动机，当前存在的问题或痛点 -->
+
+### 目标
+<!-- 描述项目要达成的核心目标，可量化指标优先 -->
+
+### 范围
+<!-- 明确项目包含和不包含的内容 -->
+
+## 用户与场景（Who and When）
+
+### 目标用户
+<!-- 描述目标用户群体及其特征 -->
+
+### 用户场景
+<!-- 描述典型使用场景和用户旅程 -->
+
+### 用户故事
+<!-- 以"作为[用户]，我希望[功能]，以便[价值]"格式描述 -->
+
+## 全局设计与架构（How）
+
+### 整体架构
+<!-- 描述系统整体架构设计 -->
+
+### 核心流程
+<!-- 描述核心业务流程 -->
+
+### 约束条件
+<!-- 技术、业务或时间约束 -->
+
+## 详细功能需求（What）
+
+### 功能清单
+<!-- 以表格或列表形式列出所有功能需求 -->
+
+| 编号 | 功能名称 | 优先级 | 描述 | 验收标准 |
+|------|----------|--------|------|----------|
+| F-001 | <!-- 功能 --> | P0 | <!-- 描述 --> | <!-- 标准 --> |
+
+### 功能详细说明
+<!-- 对每个功能进行详细说明 -->
+
+## 非功能性需求
+
+### 性能需求
+<!-- 响应时间、吞吐量、并发用户数等 -->
+
+### 安全需求
+<!-- 认证、授权、数据加密、审计等 -->
+
+### 可用性需求
+<!-- SLA、容灾、降级策略等 -->
+
+### 兼容性需求
+<!-- 浏览器、操作系统、设备兼容性 -->
+
+## 上线与运营计划
+
+### 上线计划
+<!-- 上线步骤、灰度策略、回滚方案 -->
+
+### 监控与告警
+<!-- 关键指标监控、告警阈值 -->
+
+### 运营计划
+<!-- 数据埋点、A/B 测试、迭代计划 -->
+`;
+}
+function toChangeName(input) {
+    const sanitized = String(input || '')
+        .trim()
+        .replace(/[^a-zA-Z0-9-_]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+    if (sanitized.includes('..') || sanitized.startsWith('/')) {
+        return '';
+    }
+    return sanitized;
+}
+function readStdin() {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('readable', () => {
+            let chunk;
+            while ((chunk = process.stdin.read()) !== null) {
+                chunks.push(chunk);
+            }
+        });
+        process.stdin.on('end', () => {
+            resolve(chunks.join(''));
+        });
+        process.stdin.on('error', (error) => {
+            reject(error);
+        });
+        // Timeout after 5 seconds if no data
+        setTimeout(() => {
+            if (chunks.length === 0) {
+                reject(new Error('Stdin timeout: no data received'));
+            }
+        }, 5000);
+    });
+}
+function generatePrdContent(aiInput, context) {
+    const templateContent = loadTemplate('product-requirement.md');
+    // Pre-fill from context file if provided
+    const projectName = context?.project.name || '';
+    const projectDesc = context?.project.description || '';
+    const techStack = context?.project.techStack;
+    const analysis = context?.analysis;
+    const taskInfo = context?.task;
+    // If AI provides analysis input, integrate it into the template
+    if (aiInput) {
+        // Try to parse as structured JSON first
+        try {
+            const parsed = JSON.parse(aiInput);
+            let content = templateContent;
+            if (parsed.projectName || projectName) {
+                content = content.replace('<!-- 项目名称 -->', parsed.projectName || projectName);
+            }
+            if (parsed.background) {
+                content = content.replace('<!-- 描述项目背景和动机，当前存在的问题或痛点 -->', parsed.background);
+            }
+            if (parsed.goals) {
+                const goalsText = Array.isArray(parsed.goals) ? parsed.goals.join('\n') : parsed.goals;
+                content = content.replace('<!-- 描述项目要达成的核心目标，可量化指标优先 -->', goalsText);
+            }
+            if (parsed.users) {
+                const usersText = Array.isArray(parsed.users) ? parsed.users.join('\n') : parsed.users;
+                content = content.replace('<!-- 描述目标用户群体及其特征 -->', usersText);
+            }
+            if (parsed.scenarios) {
+                const scenariosText = Array.isArray(parsed.scenarios) ? parsed.scenarios.join('\n') : parsed.scenarios;
+                content = content.replace('<!-- 描述典型使用场景和用户旅程 -->', scenariosText);
+            }
+            if (parsed.architecture) {
+                content = content.replace('<!-- 描述系统整体架构设计 -->', parsed.architecture);
+            }
+            if (parsed.features) {
+                const featuresText = Array.isArray(parsed.features) ? parsed.features.join('\n') : parsed.features;
+                content = content.replace('<!-- 以表格或列表形式列出所有功能需求 -->', featuresText);
+            }
+            return content;
+        }
+        catch {
+            // If not valid JSON, treat as plain text analysis
+            return generatePrdFromText(aiInput, projectName, projectDesc, techStack, analysis, taskInfo);
+        }
+    }
+    // No AI input, use context file to pre-fill template if available
+    return generatePrdFromText(undefined, projectName, projectDesc, techStack, analysis, taskInfo);
+}
+function generatePrdFromText(aiInput, projectName, projectDesc, _techStack, analysis, taskInfo) {
+    const taskType = taskInfo?.type || 'feat';
+    const taskPriority = taskInfo?.priority || 'medium';
+    const backgroundSection = projectDesc
+        || aiInput
+        || '<!-- 描述项目背景和动机，当前存在的问题或痛点 -->';
+    const architectureSection = analysis?.architectureSummary
+        ? `### 架构现状\n\n${analysis.architectureSummary}\n`
+        : '';
+    const risksSection = analysis?.risks && analysis.risks.length > 0
+        ? `### 潜在风险\n\n${analysis.risks.map((r) => `- ${r}`).join('\n')}\n`
+        : '';
+    const suggestionsSection = analysis?.suggestions && analysis.suggestions.length > 0
+        ? `### 改进建议\n\n${analysis.suggestions.map((s) => `- ${s}`).join('\n')}\n`
+        : '';
+    const affectedFiles = taskInfo?.affectedFiles && taskInfo.affectedFiles.length > 0
+        ? `### 涉及文件\n\n${taskInfo.affectedFiles.map((f) => `- \`${f}\``).join('\n')}\n`
+        : '';
+    const constraints = taskInfo?.constraints && taskInfo.constraints.length > 0
+        ? taskInfo.constraints.map((c) => `- ${c}`).join('\n')
+        : '<!-- 技术、业务或时间约束 -->';
+    return `# 产品需求文档
+
+## 文档基础信息（Meta Data）
+
+| 字段 | 内容 |
+|------|------|
+| 项目名称 | ${projectName || '<!-- 项目名称 -->'} |
+| 任务类型 | ${taskType} |
+| 优先级 | ${taskPriority} |
+| 版本 | v1.0.0 |
+| 创建日期 | ${new Date().toISOString().split('T')[0]} |
+| 作者 | AI Agent |
+| 文档状态 | 草稿 |
+| 评审人 | <!-- 评审人列表 --> |
+
+## 项目背景与目标（Why）
+
+### 背景
+
+${backgroundSection}
+
+${architectureSection}${risksSection}${suggestionsSection}
+### 目标
+<!-- 描述项目要达成的核心目标，可量化指标优先 -->
+
+### 范围
+<!-- 明确项目包含和不包含的内容 -->
+
+## 用户与场景（Who and When）
+
+### 目标用户
+<!-- 描述目标用户群体及其特征 -->
+
+### 用户场景
+<!-- 描述典型使用场景和用户旅程 -->
+
+### 用户故事
+<!-- 以"作为[用户]，我希望[功能]，以便[价值]"格式描述 -->
+
+## 全局设计与架构（How）
+
+### 整体架构
+<!-- 描述系统整体架构设计 -->
+
+### 核心流程
+<!-- 描述核心业务流程 -->
+
+### 约束条件
+
+${constraints}
+
+## 详细功能需求（What）
+
+### 功能清单
+<!-- 以表格或列表形式列出所有功能需求 -->
+
+| 编号 | 功能名称 | 优先级 | 描述 | 验收标准 |
+|------|----------|--------|------|----------|
+| F-001 | <!-- 功能 --> | P0 | <!-- 描述 --> | <!-- 标准 --> |
+
+### 功能详细说明
+<!-- 对每个功能进行详细说明 -->
+
+${affectedFiles}
+## 非功能性需求
+
+### 性能需求
+<!-- 响应时间、吞吐量、并发用户数等 -->
+
+### 安全需求
+<!-- 认证、授权、数据加密、审计等 -->
+
+### 可用性需求
+<!-- SLA、容灾、降级策略等 -->
+
+### 兼容性需求
+<!-- 浏览器、操作系统、设备兼容性 -->
+
+## 上线与运营计划
+
+### 上线计划
+<!-- 上线步骤、灰度策略、回滚方案 -->
+
+### 监控与告警
+<!-- 关键指标监控、告警阈值 -->
+
+### 运营计划
+<!-- 数据埋点、A/B 测试、迭代计划 -->
+`;
+}
+function validateConfigForExtract(config) {
+    if (!config.projectRoot) {
+        return {
+            valid: false,
+            reason: 'missing-project-root',
+            message: 'Config missing projectRoot',
+        };
+    }
+    return { valid: true };
+}
+async function extract(options = {}) {
+    const config = (0, config_1.loadConfig)({ cwd: options.cwd });
+    const changeName = toChangeName(options.change);
+    if (!changeName) {
+        return {
+            success: false,
+            reason: 'missing-change',
+            message: 'Missing required argument: --change <change-name>',
+        };
+    }
+    const configValidation = validateConfigForExtract(config);
+    if (!configValidation.valid) {
+        return {
+            success: false,
+            reason: configValidation.reason,
+            message: configValidation.message || 'Unknown config validation error',
+        };
+    }
+    const projectRoot = config.projectRoot || process.cwd();
+    const specRoot = config.specRootAbs || path.resolve(projectRoot, 'spec');
+    const changeDir = path.resolve(specRoot, 'changes', changeName);
+    const prdPath = path.resolve(changeDir, 'product-requirement.md');
+    if (fs.existsSync(changeDir) && !options.force) {
+        return {
+            success: false,
+            reason: 'already-exists',
+            message: `Change directory already exists: ${changeDir}. Use --force to overwrite.`,
+        };
+    }
+    try {
+        fs.mkdirSync(changeDir, { recursive: true });
+        // Determine AI input source: --input parameter, stdin, or --context-file
+        // Only read stdin when running as CLI (not when called programmatically from tests)
+        let aiInput = options.input;
+        let contextData;
+        // Load context file if provided
+        if (options.contextFile) {
+            try {
+                const contextContent = fs.readFileSync(options.contextFile, 'utf8');
+                contextData = JSON.parse(contextContent);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                return {
+                    success: false,
+                    reason: 'invalid-context-file',
+                    message: `Failed to parse context file: ${errorMessage}`,
+                };
+            }
+        }
+        if (!aiInput && !process.stdin.isTTY && require.main === module) {
+            try {
+                aiInput = await readStdin();
+                if (aiInput.trim()) {
+                    console.log(`[EXTRACT] Received ${aiInput.length} bytes from stdin`);
+                }
+                else {
+                    aiInput = undefined;
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                console.warn(`[EXTRACT] Warning: Failed to read stdin: ${errorMessage}`);
+                aiInput = undefined;
+            }
+        }
+        const prdContent = generatePrdContent(aiInput, contextData);
+        fs.writeFileSync(prdPath, prdContent, 'utf8');
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            success: false,
+            reason: 'file-write-error',
+            message: `Failed to create PRD: ${errorMessage}`,
+        };
+    }
+    return {
+        success: true,
+        changeName,
+        changeDir,
+        prdPath,
+    };
+}
+async function main() {
+    const args = parseArgs(process.argv);
+    const result = await extract({
+        cwd: args.cwd,
+        change: args.change,
+        type: args.type,
+        priority: args.priority,
+        force: args.force === true,
+        input: args.input,
+        contextFile: args['context-file'],
+    });
+    if (!result.success) {
+        console.error(`[EXTRACT] ${result.message}`);
+        process.exit(1);
+    }
+    console.log('');
+    console.log('[EXTRACT] PRD document created successfully!');
+    console.log(`  Change Name: ${result.changeName}`);
+    console.log(`  Directory: ${result.changeDir}`);
+    console.log(`  PRD: ${result.prdPath}`);
+    console.log('');
+    console.log('Next steps:');
+    console.log('  1. Edit product-requirement.md to describe your requirements');
+    console.log('  2. Run: task-flow design --change <change-name>');
+    console.log('');
+    process.exit(0);
+}
+if (require.main === module) {
+    main();
+}
+exports.default = {
+    extract,
+    main,
+};

package/dist/commands/init.d.ts

@@ -0,0 +1,24 @@
+/**
+ * commands/init.ts
+ * Initialize task flow in current project
+ */
+import { Config } from '../lib/config';
+import { State } from '../lib/state';
+export interface InitOptions {
+    cwd?: string;
+    force?: boolean;
+}
+export interface InitResult {
+    success: boolean;
+    reason?: string;
+    message?: string;
+    config?: Config;
+    state?: State;
+}
+export declare function initHarness(options?: InitOptions): InitResult;
+export declare function main(): void;
+declare const _default: {
+    initHarness: typeof initHarness;
+    main: typeof main;
+};
+export default _default;

package/dist/commands/init.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * commands/init.ts
+ * Initialize task flow in current project
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initHarness = initHarness;
+exports.main = main;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("../lib/config");
+const state_1 = require("../lib/state");
+function parseArgs(argv) {
+    const args = {};
+    for (let i = 2; i < argv.length; i += 1) {
+        const token = argv[i] || '';
+        if (!token.startsWith('--')) {
+            continue;
+        }
+        const key = token.slice(2);
+        const next = argv[i + 1];
+        if (!next || next.startsWith('--')) {
+            args[key] = true;
+            continue;
+        }
+        args[key] = next;
+        i += 1;
+    }
+    return args;
+}
+function initHarness(options = {}) {
+    const config = (0, config_1.loadConfig)({ cwd: options.cwd });
+    // Check if already initialized
+    const harnessRootAbs = config.harnessRootAbs;
+    if (!harnessRootAbs) {
+        return {
+            success: false,
+            reason: 'missing-harness-root',
+            message: 'Config missing harnessRootAbs',
+        };
+    }
+    const statePath = path.resolve(harnessRootAbs, 'state.json');
+    if (fs.existsSync(statePath) && !options.force) {
+        return {
+            success: false,
+            reason: 'already-initialized',
+            message: `Harness already initialized at ${harnessRootAbs}. Use --force to reinitialize.`,
+        };
+    }
+    // Create directories
+    (0, config_1.ensureDirectories)(config);
+    // Create initial state
+    const state = (0, state_1.createInitialState)();
+    if (!(0, state_1.saveState)(state, config)) {
+        return {
+            success: false,
+            reason: 'save-state-failed',
+            message: 'Failed to save initial state',
+        };
+    }
+    // Create config template if not exists
+    const projectRoot = config.projectRoot;
+    if (!projectRoot) {
+        return {
+            success: false,
+            reason: 'missing-project-root',
+            message: 'Config missing projectRoot',
+        };
+    }
+    const configTemplatePath = path.resolve(projectRoot, '.harnessrc.example');
+    if (!fs.existsSync(configTemplatePath)) {
+        const template = {
+            harnessRoot: '.harness',
+            worktreesDir: '.worktrees',
+            tasksDir: 'tasks',
+            snapshotsDir: 'snapshots',
+            archiveDir: 'archive',
+            reportsDir: 'reports',
+            plansDir: 'plans',
+            specRoot: 'spec',
+        };
+        try {
+            fs.writeFileSync(configTemplatePath, JSON.stringify(template, null, 2), 'utf8');
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                success: false,
+                reason: 'file-write-error',
+                message: `Failed to write config template: ${errorMessage}`,
+            };
+        }
+    }
+    return {
+        success: true,
+        config,
+        state,
+    };
+}
+function main() {
+    const args = parseArgs(process.argv);
+    const result = initHarness({
+        cwd: args.cwd,
+        force: args.force === true,
+    });
+    if (!result.success) {
+        console.error(`[INIT] ${result.message}`);
+        process.exit(1);
+    }
+    const harnessRoot = result.config?.harnessRootAbs || 'unknown';
+    const worktreesDir = result.config?.worktreesDirAbs || 'unknown';
+    const tasksDir = result.config?.tasksDirAbs || 'unknown';
+    const snapshotsDir = result.config?.snapshotsDirAbs || 'unknown';
+    console.log('[INIT] Task flow initialized successfully!');
+    console.log(`  Root: ${harnessRoot}`);
+    console.log(`  Worktrees: ${worktreesDir}`);
+    console.log(`  Tasks: ${tasksDir}`);
+    console.log(`  Snapshots: ${snapshotsDir}`);
+    console.log('');
+    console.log('Next steps:');
+    console.log('  1. Create a proposal: task-flow extract --change <change-name>');
+    console.log('  2. Check status: task-flow status');
+    console.log('');
+    process.exit(0);
+}
+if (require.main === module) {
+    main();
+}
+exports.default = {
+    initHarness,
+    main,
+};

package/dist/commands/merge/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * commands/merge/index.ts
+ * Merge completed worktree back to main
+ */
+import { MergeOptions, MergeResult } from './types';
+/**
+ * Merge task
+ */
+export declare function mergeTask(options?: MergeOptions): MergeResult | Promise<MergeResult>;
+/**
+ * Main entry point
+ */
+export declare function main(): void;
+declare const _default: {
+    mergeTask: typeof mergeTask;
+};
+export default _default;