@litmers/cursorflow-orchestrator 0.1.3 → 0.1.6

package/dist/utils/doctor.js

@@ -0,0 +1,280 @@
+"use strict";
+/**
+ * CursorFlow Doctor - environment and preflight checks
+ *
+ * This module provides actionable diagnostics for common run failures:
+ * - Not inside a Git work tree
+ * - Missing `origin` remote (required for pushing lane branches)
+ * - Missing Git worktree support
+ * - Missing base branch referenced by lane task files
+ * - Missing/invalid tasks directory
+ * - Missing Cursor Agent setup (optional)
+ */
+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.runDoctor = runDoctor;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const git = __importStar(require("./git"));
+const cursor_agent_1 = require("./cursor-agent");
+const setup_commands_1 = require("../cli/setup-commands");
+function addIssue(issues, issue) {
+    issues.push(issue);
+}
+function resolveRepoRoot(cwd) {
+    const res = git.runGitResult(['rev-parse', '--show-toplevel'], { cwd });
+    if (!res.success || !res.stdout)
+        return null;
+    return res.stdout;
+}
+function isInsideGitWorktree(cwd) {
+    const res = git.runGitResult(['rev-parse', '--is-inside-work-tree'], { cwd });
+    return res.success && res.stdout.trim() === 'true';
+}
+function hasAtLeastOneCommit(repoRoot) {
+    const res = git.runGitResult(['rev-parse', '--verify', 'HEAD'], { cwd: repoRoot });
+    return res.success;
+}
+function hasOriginRemote(repoRoot) {
+    const res = git.runGitResult(['remote', 'get-url', 'origin'], { cwd: repoRoot });
+    return res.success && !!res.stdout;
+}
+function hasWorktreeSupport(repoRoot) {
+    const res = git.runGitResult(['worktree', 'list'], { cwd: repoRoot });
+    if (res.success)
+        return { ok: true };
+    return { ok: false, details: res.stderr || res.stdout || 'git worktree failed' };
+}
+function branchExists(repoRoot, branchName) {
+    // rev-parse --verify works for both branches and tags; restrict to heads first.
+    const headRes = git.runGitResult(['show-ref', '--verify', `refs/heads/${branchName}`], { cwd: repoRoot });
+    if (headRes.success)
+        return true;
+    const anyRes = git.runGitResult(['rev-parse', '--verify', branchName], { cwd: repoRoot });
+    return anyRes.success;
+}
+function readLaneJsonFiles(tasksDir) {
+    const files = fs
+        .readdirSync(tasksDir)
+        .filter(f => f.endsWith('.json'))
+        .sort()
+        .map(f => path.join(tasksDir, f));
+    return files.map(p => {
+        const raw = fs.readFileSync(p, 'utf8');
+        const json = JSON.parse(raw);
+        return { path: p, json };
+    });
+}
+function collectBaseBranchesFromLanes(lanes, defaultBaseBranch) {
+    const set = new Set();
+    for (const lane of lanes) {
+        const baseBranch = String(lane.json?.baseBranch || defaultBaseBranch || 'main').trim();
+        if (baseBranch)
+            set.add(baseBranch);
+    }
+    return Array.from(set);
+}
+/**
+ * Run doctor checks.
+ *
+ * If `tasksDir` is provided, additional preflight checks are performed:
+ * - tasks directory existence and JSON validity
+ * - baseBranch referenced by lanes exists locally
+ */
+function runDoctor(options = {}) {
+    const cwd = options.cwd || process.cwd();
+    const issues = [];
+    const context = {
+        cwd,
+        executor: options.executor,
+    };
+    // 1) Git repository checks
+    if (!isInsideGitWorktree(cwd)) {
+        addIssue(issues, {
+            id: 'git.not_repo',
+            severity: 'error',
+            title: 'Not a Git repository',
+            message: 'Current directory is not inside a Git work tree. CursorFlow requires Git to create worktrees and branches.',
+            fixes: [
+                'cd into your repository root (or any subdirectory inside it)',
+                'If this is a new project: git init && git commit --allow-empty -m "chore: initial commit"',
+            ],
+        });
+        return { ok: false, issues, context };
+    }
+    const repoRoot = resolveRepoRoot(cwd) || undefined;
+    context.repoRoot = repoRoot;
+    const gitCwd = repoRoot || cwd;
+    if (!hasAtLeastOneCommit(gitCwd)) {
+        addIssue(issues, {
+            id: 'git.no_commits',
+            severity: 'error',
+            title: 'Repository has no commits',
+            message: 'CursorFlow needs at least one commit (HEAD) to create worktrees and new branches.',
+            fixes: ['git commit --allow-empty -m "chore: initial commit"'],
+        });
+    }
+    if (!hasOriginRemote(gitCwd)) {
+        addIssue(issues, {
+            id: 'git.no_origin',
+            severity: 'error',
+            title: "Missing remote 'origin'",
+            message: "Remote 'origin' is not configured. CursorFlow pushes lane branches to 'origin' during execution.",
+            fixes: [
+                'git remote add origin <your-repo-url>',
+                'git remote -v  # verify remotes',
+            ],
+        });
+    }
+    const wt = hasWorktreeSupport(gitCwd);
+    if (!wt.ok) {
+        addIssue(issues, {
+            id: 'git.worktree_unavailable',
+            severity: 'error',
+            title: 'Git worktree not available',
+            message: 'Git worktree support is required, but `git worktree` failed.',
+            fixes: [
+                'Upgrade Git (worktrees require Git >= 2.5)',
+                'Ensure the repository is not corrupted',
+            ],
+            details: wt.details,
+        });
+    }
+    // 2) Tasks-dir checks (optional; used by `cursorflow run` preflight)
+    if (options.tasksDir) {
+        const tasksDirAbs = path.isAbsolute(options.tasksDir)
+            ? options.tasksDir
+            : path.resolve(cwd, options.tasksDir);
+        context.tasksDir = tasksDirAbs;
+        if (!fs.existsSync(tasksDirAbs)) {
+            addIssue(issues, {
+                id: 'tasks.missing_dir',
+                severity: 'error',
+                title: 'Tasks directory not found',
+                message: `Tasks directory does not exist: ${tasksDirAbs}`,
+                fixes: [
+                    'Double-check the path you passed to `cursorflow run`',
+                    'If needed, run: cursorflow init --example',
+                ],
+            });
+        }
+        else {
+            let lanes = [];
+            try {
+                lanes = readLaneJsonFiles(tasksDirAbs);
+            }
+            catch (error) {
+                addIssue(issues, {
+                    id: 'tasks.invalid_json',
+                    severity: 'error',
+                    title: 'Invalid lane JSON file',
+                    message: `Failed to read/parse lane JSON files in: ${tasksDirAbs}`,
+                    details: error?.message ? String(error.message) : String(error),
+                    fixes: ['Validate JSON syntax for each lane file (*.json)'],
+                });
+                lanes = [];
+            }
+            if (lanes.length === 0) {
+                addIssue(issues, {
+                    id: 'tasks.no_lanes',
+                    severity: 'error',
+                    title: 'No lane files found',
+                    message: `No lane task files (*.json) found in: ${tasksDirAbs}`,
+                    fixes: ['Ensure the tasks directory contains one or more lane JSON files'],
+                });
+            }
+            else {
+                const baseBranches = collectBaseBranchesFromLanes(lanes, 'main');
+                for (const baseBranch of baseBranches) {
+                    if (!branchExists(gitCwd, baseBranch)) {
+                        addIssue(issues, {
+                            id: `git.missing_base_branch.${baseBranch}`,
+                            severity: 'error',
+                            title: `Missing base branch: ${baseBranch}`,
+                            message: `Lane files reference baseBranch "${baseBranch}", but it does not exist locally.`,
+                            fixes: [
+                                'git fetch origin --prune',
+                                `Or update lane JSON baseBranch to an existing branch`,
+                            ],
+                        });
+                    }
+                }
+            }
+        }
+    }
+    // 3) Cursor Agent checks (optional)
+    const includeCursor = options.includeCursorAgentChecks !== false;
+    if (includeCursor && (options.executor || 'cursor-agent') === 'cursor-agent') {
+        if (!(0, cursor_agent_1.checkCursorAgentInstalled)()) {
+            addIssue(issues, {
+                id: 'cursor_agent.missing',
+                severity: 'error',
+                title: 'cursor-agent CLI not installed',
+                message: 'cursor-agent is required for local execution.',
+                fixes: ['npm install -g @cursor/agent', 'cursor-agent --version'],
+            });
+        }
+        else {
+            const auth = (0, cursor_agent_1.checkCursorAuth)();
+            if (!auth.authenticated) {
+                addIssue(issues, {
+                    id: 'cursor_agent.not_authenticated',
+                    severity: 'error',
+                    title: 'Cursor authentication required',
+                    message: auth.message,
+                    details: auth.details || auth.error,
+                    fixes: [
+                        'Open Cursor IDE and sign in',
+                        'Verify AI features work in the IDE',
+                        'Re-run: cursorflow doctor',
+                    ],
+                });
+            }
+        }
+    }
+    // 4) IDE Integration checks
+    if (!(0, setup_commands_1.areCommandsInstalled)()) {
+        addIssue(issues, {
+            id: 'ide.commands_missing',
+            severity: 'warn',
+            title: 'Cursor IDE commands not installed',
+            message: 'CursorFlow slash commands (e.g., /cursorflow-run) are missing or outdated.',
+            fixes: ['cursorflow-setup --force', 'or run `cursorflow run` to auto-install'],
+        });
+    }
+    const ok = issues.every(i => i.severity !== 'error');
+    return { ok, issues, context };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/utils/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/utils/doctor.ts"],"names":[],"mappings":"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"}

package/dist/utils/git.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Git utilities for CursorFlow
+ */
+export interface GitRunOptions {
+    cwd?: string;
+    silent?: boolean;
+}
+export interface GitResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    success: boolean;
+}
+export interface WorktreeInfo {
+    path: string;
+    branch?: string;
+    head?: string;
+}
+export interface ChangedFile {
+    status: string;
+    file: string;
+}
+export interface CommitInfo {
+    hash: string;
+    shortHash: string;
+    author: string;
+    authorEmail: string;
+    timestamp: number;
+    subject: string;
+}
+/**
+ * Run git command and return output
+ */
+export declare function runGit(args: string[], options?: GitRunOptions): string;
+/**
+ * Run git command and return result object
+ */
+export declare function runGitResult(args: string[], options?: GitRunOptions): GitResult;
+/**
+ * Get current branch name
+ */
+export declare function getCurrentBranch(cwd?: string): string;
+/**
+ * Get repository root directory
+ */
+export declare function getRepoRoot(cwd?: string): string;
+/**
+ * Check if directory is a git repository
+ */
+export declare function isGitRepo(cwd?: string): boolean;
+/**
+ * Check if worktree exists
+ */
+export declare function worktreeExists(worktreePath: string, cwd?: string): boolean;
+/**
+ * Create worktree
+ */
+export declare function createWorktree(worktreePath: string, branchName: string, options?: {
+    cwd?: string;
+    baseBranch?: string;
+}): string;
+/**
+ * Remove worktree
+ */
+export declare function removeWorktree(worktreePath: string, options?: {
+    cwd?: string;
+    force?: boolean;
+}): void;
+/**
+ * List all worktrees
+ */
+export declare function listWorktrees(cwd?: string): WorktreeInfo[];
+/**
+ * Check if there are uncommitted changes
+ */
+export declare function hasUncommittedChanges(cwd?: string): boolean;
+/**
+ * Get list of changed files
+ */
+export declare function getChangedFiles(cwd?: string): ChangedFile[];
+/**
+ * Create commit
+ */
+export declare function commit(message: string, options?: {
+    cwd?: string;
+    addAll?: boolean;
+}): void;
+/**
+ * Push to remote
+ */
+export declare function push(branchName: string, options?: {
+    cwd?: string;
+    force?: boolean;
+    setUpstream?: boolean;
+}): void;
+/**
+ * Fetch from remote
+ */
+export declare function fetch(options?: {
+    cwd?: string;
+    prune?: boolean;
+}): void;
+/**
+ * Check if branch exists (local or remote)
+ */
+export declare function branchExists(branchName: string, options?: {
+    cwd?: string;
+    remote?: boolean;
+}): boolean;
+/**
+ * Delete branch
+ */
+export declare function deleteBranch(branchName: string, options?: {
+    cwd?: string;
+    force?: boolean;
+    remote?: boolean;
+}): void;
+/**
+ * Merge branch
+ */
+export declare function merge(branchName: string, options?: {
+    cwd?: string;
+    noFf?: boolean;
+    message?: string | null;
+}): void;
+/**
+ * Get commit info
+ */
+export declare function getCommitInfo(commitHash: string, options?: {
+    cwd?: string;
+}): CommitInfo | null;

package/dist/utils/git.js

@@ -0,0 +1,272 @@
+"use strict";
+/**
+ * Git utilities for CursorFlow
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGit = runGit;
+exports.runGitResult = runGitResult;
+exports.getCurrentBranch = getCurrentBranch;
+exports.getRepoRoot = getRepoRoot;
+exports.isGitRepo = isGitRepo;
+exports.worktreeExists = worktreeExists;
+exports.createWorktree = createWorktree;
+exports.removeWorktree = removeWorktree;
+exports.listWorktrees = listWorktrees;
+exports.hasUncommittedChanges = hasUncommittedChanges;
+exports.getChangedFiles = getChangedFiles;
+exports.commit = commit;
+exports.push = push;
+exports.fetch = fetch;
+exports.branchExists = branchExists;
+exports.deleteBranch = deleteBranch;
+exports.merge = merge;
+exports.getCommitInfo = getCommitInfo;
+const child_process_1 = require("child_process");
+/**
+ * Run git command and return output
+ */
+function runGit(args, options = {}) {
+    const { cwd, silent = false } = options;
+    try {
+        const result = (0, child_process_1.spawnSync)('git', args, {
+            cwd: cwd || process.cwd(),
+            encoding: 'utf8',
+            stdio: silent ? 'pipe' : 'inherit',
+        });
+        if (result.status !== 0 && !silent) {
+            throw new Error(`Git command failed: git ${args.join(' ')}\n${result.stderr || ''}`);
+        }
+        return result.stdout ? result.stdout.trim() : '';
+    }
+    catch (error) {
+        if (silent) {
+            return '';
+        }
+        throw error;
+    }
+}
+/**
+ * Run git command and return result object
+ */
+function runGitResult(args, options = {}) {
+    const { cwd } = options;
+    const result = (0, child_process_1.spawnSync)('git', args, {
+        cwd: cwd || process.cwd(),
+        encoding: 'utf8',
+        stdio: 'pipe',
+    });
+    return {
+        exitCode: result.status ?? 1,
+        stdout: (result.stdout || '').toString().trim(),
+        stderr: (result.stderr || '').toString().trim(),
+        success: result.status === 0,
+    };
+}
+/**
+ * Get current branch name
+ */
+function getCurrentBranch(cwd) {
+    return runGit(['rev-parse', '--abbrev-ref', 'HEAD'], { cwd, silent: true });
+}
+/**
+ * Get repository root directory
+ */
+function getRepoRoot(cwd) {
+    return runGit(['rev-parse', '--show-toplevel'], { cwd, silent: true });
+}
+/**
+ * Check if directory is a git repository
+ */
+function isGitRepo(cwd) {
+    const result = runGitResult(['rev-parse', '--git-dir'], { cwd });
+    return result.success;
+}
+/**
+ * Check if worktree exists
+ */
+function worktreeExists(worktreePath, cwd) {
+    const result = runGitResult(['worktree', 'list'], { cwd });
+    if (!result.success)
+        return false;
+    return result.stdout.includes(worktreePath);
+}
+/**
+ * Create worktree
+ */
+function createWorktree(worktreePath, branchName, options = {}) {
+    const { cwd, baseBranch = 'main' } = options;
+    // Check if branch already exists
+    const branchExists = runGitResult(['rev-parse', '--verify', branchName], { cwd }).success;
+    if (branchExists) {
+        // Branch exists, checkout to worktree
+        runGit(['worktree', 'add', worktreePath, branchName], { cwd });
+    }
+    else {
+        // Create new branch from base
+        runGit(['worktree', 'add', '-b', branchName, worktreePath, baseBranch], { cwd });
+    }
+    return worktreePath;
+}
+/**
+ * Remove worktree
+ */
+function removeWorktree(worktreePath, options = {}) {
+    const { cwd, force = false } = options;
+    const args = ['worktree', 'remove', worktreePath];
+    if (force) {
+        args.push('--force');
+    }
+    runGit(args, { cwd });
+}
+/**
+ * List all worktrees
+ */
+function listWorktrees(cwd) {
+    const result = runGitResult(['worktree', 'list', '--porcelain'], { cwd });
+    if (!result.success)
+        return [];
+    const worktrees = [];
+    const lines = result.stdout.split('\n');
+    let current = {};
+    for (const line of lines) {
+        if (line.startsWith('worktree ')) {
+            if (current.path) {
+                worktrees.push(current);
+            }
+            current = { path: line.slice(9) };
+        }
+        else if (line.startsWith('branch ')) {
+            current.branch = line.slice(7);
+        }
+        else if (line.startsWith('HEAD ')) {
+            current.head = line.slice(5);
+        }
+    }
+    if (current.path) {
+        worktrees.push(current);
+    }
+    return worktrees;
+}
+/**
+ * Check if there are uncommitted changes
+ */
+function hasUncommittedChanges(cwd) {
+    const result = runGitResult(['status', '--porcelain'], { cwd });
+    return result.success && result.stdout.length > 0;
+}
+/**
+ * Get list of changed files
+ */
+function getChangedFiles(cwd) {
+    const result = runGitResult(['status', '--porcelain'], { cwd });
+    if (!result.success)
+        return [];
+    return result.stdout
+        .split('\n')
+        .filter(line => line.trim())
+        .map(line => {
+        const status = line.slice(0, 2);
+        const file = line.slice(3);
+        return { status, file };
+    });
+}
+/**
+ * Create commit
+ */
+function commit(message, options = {}) {
+    const { cwd, addAll = true } = options;
+    if (addAll) {
+        runGit(['add', '-A'], { cwd });
+    }
+    runGit(['commit', '-m', message], { cwd });
+}
+/**
+ * Push to remote
+ */
+function push(branchName, options = {}) {
+    const { cwd, force = false, setUpstream = false } = options;
+    const args = ['push'];
+    if (force) {
+        args.push('--force');
+    }
+    if (setUpstream) {
+        args.push('-u', 'origin', branchName);
+    }
+    else {
+        args.push('origin', branchName);
+    }
+    runGit(args, { cwd });
+}
+/**
+ * Fetch from remote
+ */
+function fetch(options = {}) {
+    const { cwd, prune = true } = options;
+    const args = ['fetch', 'origin'];
+    if (prune) {
+        args.push('--prune');
+    }
+    runGit(args, { cwd });
+}
+/**
+ * Check if branch exists (local or remote)
+ */
+function branchExists(branchName, options = {}) {
+    const { cwd, remote = false } = options;
+    if (remote) {
+        const result = runGitResult(['ls-remote', '--heads', 'origin', branchName], { cwd });
+        return result.success && result.stdout.length > 0;
+    }
+    else {
+        const result = runGitResult(['rev-parse', '--verify', branchName], { cwd });
+        return result.success;
+    }
+}
+/**
+ * Delete branch
+ */
+function deleteBranch(branchName, options = {}) {
+    const { cwd, force = false, remote = false } = options;
+    if (remote) {
+        runGit(['push', 'origin', '--delete', branchName], { cwd });
+    }
+    else {
+        const args = ['branch', force ? '-D' : '-d', branchName];
+        runGit(args, { cwd });
+    }
+}
+/**
+ * Merge branch
+ */
+function merge(branchName, options = {}) {
+    const { cwd, noFf = false, message = null } = options;
+    const args = ['merge'];
+    if (noFf) {
+        args.push('--no-ff');
+    }
+    if (message) {
+        args.push('-m', message);
+    }
+    args.push(branchName);
+    runGit(args, { cwd });
+}
+/**
+ * Get commit info
+ */
+function getCommitInfo(commitHash, options = {}) {
+    const { cwd } = options;
+    const format = '--format=%H%n%h%n%an%n%ae%n%at%n%s';
+    const result = runGitResult(['show', '-s', format, commitHash], { cwd });
+    if (!result.success)
+        return null;
+    const lines = result.stdout.split('\n');
+    return {
+        hash: lines[0] || '',
+        shortHash: lines[1] || '',
+        author: lines[2] || '',
+        authorEmail: lines[3] || '',
+        timestamp: parseInt(lines[4] || '0'),
+        subject: lines[5] || '',
+    };
+}
+//# sourceMappingURL=git.js.map