@bicorne/task-flow 0.1.0

package/dist/slash/parser.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * slash/parser.ts
+ * Parse slash command strings like /tf:propose or /taskflow:apply
+ *
+ * Format: /<namespace>:<command> [args...]
+ * Examples:
+ *   /tf:propose add-dark-mode
+ *   /taskflow:apply
+ *   /tf:archive --task-id my-feature
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_NAMESPACES = exports.DEFAULT_NAMESPACE = void 0;
+exports.parseSlashCommand = parseSlashCommand;
+exports.isSlashCommand = isSlashCommand;
+exports.formatSlashCommand = formatSlashCommand;
+const DEFAULT_NAMESPACE = 'tf';
+exports.DEFAULT_NAMESPACE = DEFAULT_NAMESPACE;
+const VALID_NAMESPACES = ['tf', 'taskflow'];
+exports.VALID_NAMESPACES = VALID_NAMESPACES;
+function isValidNamespace(ns) {
+    return VALID_NAMESPACES.includes(ns);
+}
+function parseSlashCommand(input) {
+    const trimmed = input.trim();
+    if (!trimmed.startsWith('/')) {
+        return {
+            valid: false,
+            namespace: '',
+            command: '',
+            args: [],
+            raw: trimmed,
+            error: `Slash command must start with "/". Got: "${trimmed}"`,
+        };
+    }
+    const withoutSlash = trimmed.slice(1);
+    const colonIndex = withoutSlash.indexOf(':');
+    if (colonIndex === -1) {
+        return {
+            valid: false,
+            namespace: '',
+            command: '',
+            args: [],
+            raw: trimmed,
+            error: `Slash command must contain ":" separator. Format: /<namespace>:<command>. Got: "${trimmed}"`,
+        };
+    }
+    const namespace = withoutSlash.slice(0, colonIndex);
+    const remainder = withoutSlash.slice(colonIndex + 1);
+    if (!namespace) {
+        return {
+            valid: false,
+            namespace: '',
+            command: '',
+            args: [],
+            raw: trimmed,
+            error: `Missing namespace before ":". Format: /<namespace>:<command>. Got: "${trimmed}"`,
+        };
+    }
+    if (!isValidNamespace(namespace)) {
+        return {
+            valid: false,
+            namespace,
+            command: '',
+            args: [],
+            raw: trimmed,
+            error: `Unknown namespace "${namespace}". Valid namespaces: ${VALID_NAMESPACES.join(', ')}`,
+        };
+    }
+    const tokens = remainder.split(/\s+/).filter(Boolean);
+    const command = tokens[0] || '';
+    if (!command) {
+        return {
+            valid: false,
+            namespace,
+            command: '',
+            args: [],
+            raw: trimmed,
+            error: `Missing command after "${namespace}:". Format: /${namespace}:<command>. Got: "${trimmed}"`,
+        };
+    }
+    const args = tokens.slice(1);
+    return {
+        valid: true,
+        namespace,
+        command,
+        args,
+        raw: trimmed,
+    };
+}
+function isSlashCommand(input) {
+    const trimmed = input.trim();
+    if (!trimmed.startsWith('/')) {
+        return false;
+    }
+    const withoutSlash = trimmed.slice(1);
+    return withoutSlash.includes(':');
+}
+function formatSlashCommand(namespace, command) {
+    return `/${namespace}:${command}`;
+}

package/dist/slash/registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * slash/registry.ts
+ * Slash command registry — defines all available slash commands,
+ * their argument schemas, and whether they are composite (multi-step).
+ */
+export type CommandCategory = 'single' | 'composite';
+export interface SlashCommandDef {
+    name: string;
+    description: string;
+    category: CommandCategory;
+    requiresChange: boolean;
+    requiresTaskId: boolean;
+    steps?: string[];
+    usage: string;
+    example: string;
+}
+export declare function getCommand(name: string): SlashCommandDef | undefined;
+export declare function getAllCommands(): SlashCommandDef[];
+export declare function getCompositeCommands(): SlashCommandDef[];
+export declare function getSingleCommands(): SlashCommandDef[];
+export declare function hasCommand(name: string): boolean;
+export declare function printSlashHelp(): string;

package/dist/slash/registry.js

@@ -0,0 +1,155 @@
+"use strict";
+/**
+ * slash/registry.ts
+ * Slash command registry — defines all available slash commands,
+ * their argument schemas, and whether they are composite (multi-step).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCommand = getCommand;
+exports.getAllCommands = getAllCommands;
+exports.getCompositeCommands = getCompositeCommands;
+exports.getSingleCommands = getSingleCommands;
+exports.hasCommand = hasCommand;
+exports.printSlashHelp = printSlashHelp;
+const COMMANDS = {
+    propose: {
+        name: 'propose',
+        description: 'Create a full change proposal (extract → design → tasks)',
+        category: 'composite',
+        requiresChange: true,
+        requiresTaskId: false,
+        steps: ['extract', 'design', 'tasks'],
+        usage: '/tf:propose <change-name>',
+        example: '/tf:propose add-dark-mode',
+    },
+    apply: {
+        name: 'apply',
+        description: 'Apply a change by creating worktree and starting implementation',
+        category: 'composite',
+        requiresChange: true,
+        requiresTaskId: false,
+        steps: ['worktree'],
+        usage: '/tf:apply <change-name>',
+        example: '/tf:apply add-dark-mode',
+    },
+    archive: {
+        name: 'archive',
+        description: 'Archive a completed change (archive → sync)',
+        category: 'composite',
+        requiresChange: false,
+        requiresTaskId: true,
+        steps: ['archive', 'sync'],
+        usage: '/tf:archive --task-id <task-id>',
+        example: '/tf:archive --task-id add-dark-mode',
+    },
+    init: {
+        name: 'init',
+        description: 'Initialize task flow in current project',
+        category: 'single',
+        requiresChange: false,
+        requiresTaskId: false,
+        usage: '/tf:init',
+        example: '/tf:init',
+    },
+    status: {
+        name: 'status',
+        description: 'Show current task and phase status',
+        category: 'single',
+        requiresChange: false,
+        requiresTaskId: false,
+        usage: '/tf:status',
+        example: '/tf:status',
+    },
+    extract: {
+        name: 'extract',
+        description: 'Extract project requirements and generate PRD document',
+        category: 'single',
+        requiresChange: true,
+        requiresTaskId: false,
+        usage: '/tf:extract <change-name>',
+        example: '/tf:extract add-dark-mode',
+    },
+    design: {
+        name: 'design',
+        description: 'Generate technical specification from PRD',
+        category: 'single',
+        requiresChange: true,
+        requiresTaskId: false,
+        usage: '/tf:design <change-name>',
+        example: '/tf:design add-dark-mode',
+    },
+    tasks: {
+        name: 'tasks',
+        description: 'Generate PHASE-*.json task files from PRD and design',
+        category: 'single',
+        requiresChange: true,
+        requiresTaskId: false,
+        usage: '/tf:tasks <change-name>',
+        example: '/tf:tasks add-dark-mode',
+    },
+    worktree: {
+        name: 'worktree',
+        description: 'Create isolated git worktree for task execution',
+        category: 'single',
+        requiresChange: true,
+        requiresTaskId: false,
+        usage: '/tf:worktree <change-name>',
+        example: '/tf:worktree add-dark-mode',
+    },
+    merge: {
+        name: 'merge',
+        description: 'Merge completed worktree back to main branch',
+        category: 'single',
+        requiresChange: false,
+        requiresTaskId: true,
+        usage: '/tf:merge <task-id>',
+        example: '/tf:merge add-dark-mode',
+    },
+    sync: {
+        name: 'sync',
+        description: 'Sync task execution status to spec',
+        category: 'single',
+        requiresChange: false,
+        requiresTaskId: true,
+        usage: '/tf:sync --task-id <task-id>',
+        example: '/tf:sync --task-id add-dark-mode',
+    },
+};
+function getCommand(name) {
+    return COMMANDS[name];
+}
+function getAllCommands() {
+    return Object.values(COMMANDS);
+}
+function getCompositeCommands() {
+    return Object.values(COMMANDS).filter((cmd) => cmd.category === 'composite');
+}
+function getSingleCommands() {
+    return Object.values(COMMANDS).filter((cmd) => cmd.category === 'single');
+}
+function hasCommand(name) {
+    return name in COMMANDS;
+}
+function printSlashHelp() {
+    const lines = [
+        '',
+        'Slash Commands:',
+        '',
+        '  Composite (multi-step):',
+    ];
+    for (const cmd of getCompositeCommands()) {
+        lines.push(`    ${cmd.usage.padEnd(40)} ${cmd.description}`);
+    }
+    lines.push('');
+    lines.push('  Single:');
+    for (const cmd of getSingleCommands()) {
+        lines.push(`    ${cmd.usage.padEnd(40)} ${cmd.description}`);
+    }
+    lines.push('');
+    lines.push('  Examples:');
+    lines.push('    /tf:propose add-dark-mode    →  extract + design + tasks');
+    lines.push('    /tf:apply add-dark-mode      →  create worktree');
+    lines.push('    /tf:archive --task-id feat   →  archive + sync');
+    lines.push('');
+    return lines.join('\n');
+}

package/dist/spec/openspec-to-task/builders.d.ts

@@ -0,0 +1,107 @@
+/**
+ * spec/openspec-to-task/builders.ts
+ * Task object builders for Spec to task sync
+ */
+import { Config } from '../../lib/config';
+/**
+ * Build task output paths config
+ */
+export declare function buildTaskOutputs(config: Config | undefined, taskId: string): {
+    task: string;
+    snapshot: string;
+    report: string;
+};
+/**
+ * Build task object
+ */
+export declare function buildTaskObject(params: {
+    taskId: string;
+    type: string;
+    title: string;
+    priority: string;
+    description: string;
+    files: string[];
+    worktree: string;
+    implementationValidations: string[];
+    reviewValidations: string[];
+    changeName: string;
+    manifestPath: string;
+    executionPath: string;
+    mergeStrategy: {
+        type: string;
+        deleteBranch: boolean;
+        deleteWorktree: boolean;
+    };
+    planningSummary: string;
+    implementationSteps: string[];
+    outputs: {
+        task: string;
+        snapshot: string;
+        report: string;
+    };
+}): Record<string, unknown>;
+/**
+ * Build task JSON string
+ */
+export declare function buildTaskJson(params: {
+    taskId: string;
+    type: string;
+    title: string;
+    priority: string;
+    description: string;
+    files: string[];
+    worktree: string;
+    implementationValidations: string[];
+    reviewValidations: string[];
+    changeName: string;
+    manifestPath: string;
+    executionPath: string;
+    mergeStrategy: {
+        type: string;
+        deleteBranch: boolean;
+        deleteWorktree: boolean;
+    };
+    planningSummary: string;
+    implementationSteps: string[];
+    config?: Config;
+}): string;
+/**
+ * Build sync parameters from options and config
+ */
+export declare function buildSyncParams(options: {
+    taskId?: string;
+    type?: string;
+    priority?: string;
+    worktree?: string;
+}, config: Config, changeName: string, _changeDir: string, proposalContent: string, _designContent: string, tasksContent: string, manifest: {
+    taskId?: string;
+    type?: string;
+    priority?: string;
+    title?: string;
+    files?: string[];
+    worktree?: string;
+    implementationValidation?: string[];
+    reviewValidation?: string[];
+    mergeStrategy?: {
+        type?: string;
+        deleteBranch?: boolean;
+        deleteWorktree?: boolean;
+    };
+}, _manifestPath: string, _executionPath: string): {
+    taskId: string;
+    type: string;
+    title: string;
+    priority: string;
+    description: string;
+    files: string[];
+    worktree: string;
+    implementationValidations: string[];
+    reviewValidations: string[];
+    mergeStrategy: {
+        type: string;
+        deleteBranch: boolean;
+        deleteWorktree: boolean;
+    };
+    planningSummary: string;
+    implementationSteps: string[];
+};

package/dist/spec/openspec-to-task/builders.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * spec/openspec-to-task/builders.ts
+ * Task object builders for Spec to task sync
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTaskOutputs = buildTaskOutputs;
+exports.buildTaskObject = buildTaskObject;
+exports.buildTaskJson = buildTaskJson;
+exports.buildSyncParams = buildSyncParams;
+const parsers_1 = require("./parsers");
+/**
+ * Build task output paths config
+ */
+function buildTaskOutputs(config, taskId) {
+    const tasksDir = config?.tasksDir || 'tasks';
+    const snapshotsDir = config?.snapshotsDir || 'snapshots';
+    const reportsDir = config?.reportsDir || 'reports';
+    return {
+        task: `${tasksDir}/${taskId}.json`,
+        snapshot: `${snapshotsDir}/${taskId}-impl.json`,
+        report: `${reportsDir}/${taskId}-review.md`,
+    };
+}
+/**
+ * Build task object
+ */
+function buildTaskObject(params) {
+    const { taskId, type, title, priority, description, files, worktree, implementationValidations, reviewValidations, changeName, manifestPath, executionPath, mergeStrategy, planningSummary, implementationSteps, outputs, } = params;
+    return {
+        id: taskId,
+        type,
+        title,
+        priority,
+        phase: 1,
+        dependencies: [],
+        docs_to_read: [
+            `spec/changes/${changeName}/product-requirement.md`,
+            `spec/changes/${changeName}/design.md`,
+            `spec/changes/${changeName}/tasks.md`,
+        ],
+        spec: {
+            description: description || `从 Spec 变更 ${changeName} 同步生成。`,
+            files: files || [],
+            context: [],
+        },
+        acceptance_criteria: [
+            'validation-passes',
+            'review-pass',
+        ],
+        implementation: {
+            steps: implementationSteps.map((step) => ({
+                step,
+                details: '',
+            })),
+            notes: planningSummary || '',
+        },
+        validation: {
+            commands: implementationValidations || [],
+            manual_checks: reviewValidations || [],
+        },
+        status: 'pending',
+        metadata: {
+            change: changeName,
+            manifest: manifestPath,
+            execution: executionPath,
+            worktree,
+            mergeStrategy: {
+                type: mergeStrategy.type || 'squash',
+                deleteBranch: mergeStrategy.deleteBranch ?? true,
+                deleteWorktree: mergeStrategy.deleteWorktree ?? true,
+            },
+            outputs,
+        },
+    };
+}
+/**
+ * Build task JSON string
+ */
+function buildTaskJson(params) {
+    const outputs = buildTaskOutputs(params.config, params.taskId);
+    const taskObject = buildTaskObject({ ...params, outputs });
+    return JSON.stringify(taskObject, null, 2);
+}
+/**
+ * Build sync parameters from options and config
+ */
+function buildSyncParams(options, config, changeName, _changeDir, proposalContent, _designContent, tasksContent, manifest, _manifestPath, _executionPath) {
+    const checklistItems = (0, parsers_1.extractChecklistItems)(tasksContent);
+    const taskId = (0, parsers_1.toTaskId)(options.taskId || manifest.taskId || changeName);
+    const type = String(options.type || manifest.type || 'feat');
+    const priority = String(options.priority || manifest.priority || 'medium');
+    const title = String(manifest.title || (0, parsers_1.extractTitle)(changeName, proposalContent));
+    const description = [
+        `从 Spec 变更 ${changeName} 同步生成。`,
+        '',
+        proposalContent ? proposalContent.split(/\r?\n/).slice(0, 20).join('\n') : '请参考 Spec proposal/design/tasks 文档补全细节。',
+    ].join('\n');
+    const fileCandidates = (0, parsers_1.uniqueArray)([
+        ...(Array.isArray(manifest.files) ? manifest.files : []),
+        ...(0, parsers_1.extractFileCandidates)([proposalContent, _designContent, tasksContent]),
+    ]);
+    const files = fileCandidates.length > 0 ? fileCandidates : [`${config.tasksDir}/README.md`];
+    const worktree = String(options.worktree || manifest.worktree || (0, parsers_1.toWorktreeName)(type, taskId));
+    const implementationValidations = (0, parsers_1.uniqueArray)(Array.isArray(manifest.implementationValidation) && manifest.implementationValidation.length > 0
+        ? manifest.implementationValidation
+        : (0, parsers_1.inferImplementationValidations)(checklistItems));
+    const reviewValidations = (0, parsers_1.uniqueArray)(Array.isArray(manifest.reviewValidation) && manifest.reviewValidation.length > 0
+        ? manifest.reviewValidation
+        : (0, parsers_1.inferReviewValidations)(checklistItems));
+    const mergeStrategy = {
+        type: String(manifest.mergeStrategy?.type || 'squash'),
+        deleteBranch: (0, parsers_1.normalizeBoolean)(manifest.mergeStrategy?.deleteBranch, true),
+        deleteWorktree: (0, parsers_1.normalizeBoolean)(manifest.mergeStrategy?.deleteWorktree, true),
+    };
+    const implementationSteps = checklistItems.length > 0
+        ? checklistItems
+        : [
+            '读取 Spec 规格并补全任务分解',
+            '完成实现并执行构建、测试、类型检查与 lint',
+            '输出审查报告并给出结论',
+        ];
+    const planningSummary = `从 Spec 变更 ${changeName} 同步生成，基于 proposal、design、tasks 与 harness manifest 收敛出的执行规划。`;
+    return {
+        taskId,
+        type,
+        title,
+        priority,
+        description,
+        files,
+        worktree,
+        implementationValidations,
+        reviewValidations,
+        mergeStrategy,
+        planningSummary,
+        implementationSteps,
+    };
+}

package/dist/spec/openspec-to-task/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * spec/openspec-to-task/index.ts
+ * Sync Spec change to harness task definition
+ *
+ * Usage:
+ *   node sync-openspec-to-task.js --change <change-name> [options]
+ */
+import { SyncOptions, SyncResult } from './types';
+/**
+ * Sync Spec to task
+ */
+export declare function syncSpecToTask(options?: SyncOptions): SyncResult;
+/**
+ * Main entry point
+ */
+export declare function main(): void;
+declare const _default: {
+    syncSpecToTask: typeof syncSpecToTask;
+};
+export default _default;