@litmers/cursorflow-orchestrator 0.1.34 → 0.1.37

package/CHANGELOG.md

@@ -5,6 +5,41 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.37] - 2025-12-26
+
+### Fixed
+- **Runner**: Updated `cursor-agent` CLI flags to `--output-format` and added `--print`, `--force`, `--approve-mcps` for compatibility with latest versions.
+
+### Performance
+- **Git**: Optimized `pre-push` hook by excluding heavy E2E tests from local validation.
+
+## [0.1.36] - 2025-12-26
+
+### Fixed
+- **CLI**: Fixed indentation and validation logic in `tasks` command.
+- **Tests**: Improved `stop.test.ts` stability by mocking `process.chdir`.
+- **E2E**: Removed redundant `lane-a.json` from `test-tasks-e2e`.
+
+### Changed
+- **Release**: Improved release process with annotated tags.
+
+## [0.1.35] - 2025-12-26
+
+### Changed
+- **Log Format**: Updated log format to `L{n}-T{t}-{lanename}` with single-digit numbers and 10-char max lane name for cleaner output.
+- **Flow Support**: All commands now support flow names in addition to directory paths.
+  - `run`, `resume`, `doctor` can now use flow names like `cursorflow run MyFlow`
+  - `tasks` command now browses flows from `_cursorflow/flows/` directory
+
+### Fixed
+- **Build Errors**: Fixed missing `getLogsDir` import in `logs.ts` and `monitor.ts`.
+- **Flow Recognition**: Fixed `flow.meta.json` being incorrectly treated as a lane file in orchestrator.
+- **Doctor CLI**: Fixed positional argument parsing for flow names.
+
+### Added
+- `getFlowsDir()` function in config.ts for consistent flow directory resolution.
+- `findFlowDir()` utility for resolving flow names to paths.
+
 ## [0.1.30] - 2025-12-25
 
 ### Added

package/README.md

@@ -266,23 +266,54 @@ cursorflow doctor --tasks-dir _cursorflow/tasks/my-feature
 
 ## 📚 Commands Reference
 
+### Flow Commands (New)
+| Command | Description |
+|---------|-------------|
+| `cursorflow new` | Create Flow with Lanes |
+| `cursorflow add` | Add Tasks to Lane |
+| `cursorflow config` | View/set configuration |
+| `cursorflow tasks` | Browse flows and legacy tasks |
+
+### Execution
 | Command | Description |
 |---------|-------------|
-| `cursorflow init` | Initialize CursorFlow in project |
-| `cursorflow setup` | Install Cursor IDE commands |
-| `cursorflow prepare` | Prepare task directory and JSON files |
 | `cursorflow run` | Run orchestration (DAG-based) |
 | `cursorflow monitor` | Interactive lane dashboard |
-| `cursorflow clean` | Clean branches/worktrees/logs/tasks |
 | `cursorflow resume` | Resume lane(s) - use --all for batch resume |
+| `cursorflow stop` | Stop running workflows |
+
+### Inspection
+| Command | Description |
+|---------|-------------|
 | `cursorflow doctor` | Check environment and preflight |
-| `cursorflow signal` | Directly intervene in a running lane |
-| `cursorflow models` | List available AI models |
 | `cursorflow logs` | View, export, and follow logs |
+| `cursorflow models` | List available AI models |
+
+### Utility
+| Command | Description |
+|---------|-------------|
+| `cursorflow init` | Initialize CursorFlow in project |
+| `cursorflow setup` | Install Cursor IDE commands |
+| `cursorflow clean` | Clean branches/worktrees/logs/tasks |
+| `cursorflow signal` | Directly intervene in a running lane |
+
+### Legacy
+| Command | Description |
+|---------|-------------|
+| `cursorflow prepare` | (deprecated) Use 'new' + 'add' instead |
 
 ## 📝 Enhanced Logging
 
-CursorFlow provides comprehensive logging with automatic cleanup and export options:
+CursorFlow provides comprehensive logging with automatic cleanup and export options.
+
+### Log Format
+
+Logs use the format `[L{n}-T{t}-{lanename}]`:
+- `L{n}`: Lane number (1-indexed, single digit)
+- `T{t}`: Task number (1-indexed, single digit)
+- `{lanename}`: First 10 characters of lane name
+
+Example: `[L1-T2-backend]` = Lane 1, Task 2, lane "backend"
 
 ### Features
 - **ANSI Stripping**: Clean logs without terminal escape codes

package/commands/cursorflow-doctor.md

@@ -1,42 +1,43 @@
 # CursorFlow Doctor
 
 ## Overview
-Verify that your environment and task configurations are properly set up for CursorFlow.
+Verify that your environment and flow configurations are properly set up for CursorFlow.
 
 ## Usage
 
 ```bash
-cursorflow doctor [options]
+cursorflow doctor [flow-name] [options]
 ```
 
 ## Checks Performed
 - **Environment**: Git repository status, remote availability, and worktree support.
 - **Cursor IDE**: Verifies `cursor-agent` is installed and authenticated.
-- **Tasks**: (Optional) Validates task JSON files for schema errors or missing fields.
+- **Flow/Tasks**: (Optional) Validates flow JSON files for schema errors or missing fields.
 
 ## Options
 
 | Option | Description |
 |------|------|
-| `--tasks-dir <path>` | Validate lane files in a specific directory |
+| `[flow-name]` | Flow name to validate (e.g., `SearchFeature`) |
+| `--tasks-dir <path>` | Validate flow/tasks in a specific directory (legacy) |
 | `--executor <type>` | Check environment for `cursor-agent` \| `cloud` |
 | `--test-agent` | Run an interactive agent test (to approve permissions) |
 | `--no-cursor` | Skip Cursor Agent installation and auth checks |
 | `--json` | Output the report in machine-readable JSON format |
 
-## Task Validation
+## Flow Validation
 
-When `--tasks-dir` is provided, the doctor performs comprehensive validation:
+When a flow name or `--tasks-dir` is provided, the doctor performs comprehensive validation:
 
 ### Structure Validation
 - **tasks array**: Must exist and be non-empty
 - **task.name**: Required, must be alphanumeric with `-` and `_` only, unique within lane
 - **task.prompt**: Required, should be descriptive (warns if < 10 chars)
 - **task.model**: Optional, must be string if provided
-- **task.acceptanceCriteria**: Optional, must be non-empty array if provided
+- **task.dependsOn**: Optional, task-level dependencies
 
 ### Dependency Validation (DAG)
-- **Unknown dependencies**: Reports if `dependsOn` references non-existent lanes
+- **Unknown dependencies**: Reports if `dependsOn` references non-existent lanes/tasks
 - **Circular dependencies**: Detects cycles (e.g., A→B→A) that would cause deadlock
 - Reports the exact cycle path for easy debugging
 
@@ -44,30 +45,44 @@ When `--tasks-dir` is provided, the doctor performs comprehensive validation:
 - **Prefix collision**: Warns if multiple lanes use the same `branchPrefix`
 - **Existing branch conflicts**: Detects if existing branches match a lane's prefix
 - **Duplicate lane names**: Ensures each lane file has a unique name
-- **Naming suggestions**: Recommends using lane numbers in branch prefixes for consistency
 
-Example errors:
-```
-❌ Branch prefix collision
-   Multiple lanes use the same branchPrefix "feature/lane-1-": 01-lane-1, 02-lane-2
-   Fix: Update the branchPrefix in each lane JSON file to be unique
-
-⚠️ Existing branches may conflict with 01-lane-1
-   Found 2 existing branch(es) matching prefix "feature/lane-1-": feature/lane-1-abc, feature/lane-1-xyz
-   Fix: Delete conflicting branches or change the branchPrefix
-```
-
-## Example
+## Examples
 
 ```bash
 # Basic environment check
 cursorflow doctor
 
+# Validate a specific flow by name
+cursorflow doctor SearchFeature
+
 # Test agent permissions
 cursorflow doctor --test-agent
 
-# Validate a specific task set
-cursorflow doctor --tasks-dir _cursorflow/tasks/my-feature/
+# Validate a specific flow directory
+cursorflow doctor --tasks-dir _cursorflow/flows/001_SearchFeature
+
+# Skip cursor checks (faster)
+cursorflow doctor SearchFeature --no-cursor
+
+# Output as JSON
+cursorflow doctor SearchFeature --json
+```
+
+## Example Output
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  🩺 CursorFlow Doctor
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+cwd: /home/user/project
+repo: /home/user/project
+tasks: /home/user/project/_cursorflow/flows/001_SearchFeature
+
+✅ All checks passed
+
+💡 Tip: If this is your first run, we recommend running:
+   cursorflow doctor --test-agent
 ```
 
 ## Common Issues & Fixes
@@ -78,3 +93,10 @@ cursorflow doctor --tasks-dir _cursorflow/tasks/my-feature/
 | `Not authenticated` | Open Cursor IDE and log in to your account. |
 | `Worktree not supported` | Upgrade your Git version (requires Git >= 2.5). |
 | `Circular dependency` | Check the `dependsOn` fields in your task JSON files. |
+| `Flow not found` | Verify flow name or create with `cursorflow new`. |
+
+## Related Commands
+
+- [cursorflow new](cursorflow-new.md) - Create Flow and Lanes
+- [cursorflow add](cursorflow-add.md) - Add Tasks to Lanes
+- [cursorflow run](cursorflow-run.md) - Run Flow

package/commands/cursorflow-run.md

@@ -2,62 +2,66 @@
 
 ## Overview
 
-Execute AI agent orchestration using task configurations generated by `prepare`. CursorFlow uses a DAG (Directed Acyclic Graph) scheduler to handle lane dependencies and automatic branch merging.
+Execute AI agent orchestration using Flow configurations. CursorFlow uses a DAG (Directed Acyclic Graph) scheduler to handle task dependencies and automatic branch merging.
 
 ## Workflow
 
 ```
 ┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
-│ 1. Create Lanes │ ──▶ │ 2. Add Tasks    │ ──▶ │ 3. Validate     │ ──▶ │ 4. Run          │
-│ (prepare)       │     │ (prepare)       │     │ (doctor)        │     │ (run)           │
+│ 1. Create Flow  │ ──▶ │ 2. Add Tasks    │ ──▶ │ 3. Validate     │ ──▶ │ 4. Run          │
+│ (new)           │     │ (add)           │     │ (doctor)        │     │ (run)           │
 └─────────────────┘     └─────────────────┘     └─────────────────┘     └─────────────────┘
 ```
 
 ## Usage
 
 ```bash
-cursorflow run <tasks-dir> [options]
+cursorflow run <flow-name> [options]
+cursorflow run <flow-path> [options]
 ```
 
 ### Quick Start
 
 ```bash
-# Step 1: Create lanes
-cursorflow prepare AddAPI --prompt "Create REST API for users" --criteria "CRUD works,Tests pass"
+# Step 1: Create flow and lanes
+cursorflow new AddAPI --lanes "backend,frontend"
 
-# Step 2: (Optional) Add more lanes or tasks
-cursorflow prepare --add-lane _cursorflow/tasks/2412211530_AddAPI \
-  --prompt "Add authentication" --depends-on "01-lane-1"
+# Step 2: Add tasks to lanes
+cursorflow add AddAPI backend \
+  --task "name=implement|prompt=Create REST API for users"
+
+cursorflow add AddAPI frontend \
+  --task "name=ui|prompt=Create frontend UI" \
+  --after "backend:implement"
 
 # Step 3: Validate configuration
-cursorflow doctor --tasks-dir _cursorflow/tasks/2412211530_AddAPI
+cursorflow doctor AddAPI
 
 # Step 4: Run
-cursorflow run _cursorflow/tasks/2412211530_AddAPI
-
-# Or run the latest prepared task
-cursorflow run latest
+cursorflow run AddAPI
 ```
 
 ## How It Works
 
-1. **Load**: Read all JSON files from the tasks directory
+1. **Load**: Read all JSON files from the flow directory (excluding `flow.meta.json`)
 2. **Validate**: Check `tasks` array, required fields (`name`, `prompt`)
 3. **Resolve**: Build execution order from `dependsOn` dependencies
 4. **Execute**:
    - Start lanes with no dependencies in parallel
-   - When a lane completes, unlock dependent lanes
-   - **Dependent lanes auto-merge predecessor branches before starting**
+   - When a task completes, unlock dependent tasks
+   - **Dependent tasks auto-merge predecessor branches before starting**
 5. **Monitor**: Heartbeat logs every 30 seconds
 
 ## Options
 
 | Option | Description |
 |--------|-------------|
-| `<tasks-dir>` | Directory containing JSON task files |
+| `<flow-name>` | Flow name (e.g., `AddAPI`) |
+| `<flow-path>` | Flow directory path (e.g., `_cursorflow/flows/001_AddAPI`) |
 | `--max-concurrent <num>` | Limit concurrent lane execution |
 | `--executor <type>` | `cursor-agent` (default) or `cloud` |
 | `--skip-doctor` | Skip environment checks (not recommended) |
+| `--no-git` | Skip Git operations (worktree, commits, push) |
 | `--dry-run` | Show execution plan without running |
 
 ## Execution Flow
@@ -65,15 +69,16 @@ cursorflow run latest
 ### Single Lane
 
 ```bash
-cursorflow prepare SimpleFix --prompt "Fix the bug"
-cursorflow run _cursorflow/tasks/2412211530_SimpleFix
+cursorflow new SimpleFix --lanes "main"
+cursorflow add SimpleFix main --task "name=fix|prompt=Fix the bug"
+cursorflow run SimpleFix
 ```
 
 ```
 ┌─────────────────────────────────────────────────────────┐
-│  01-lane-1                                              │
+│  main                                                   │
 │  ┌─────────┐                                            │
-│  │implement│ → AI executes → Review → Complete          │
+│  │   fix   │ → AI executes → Complete                   │
 │  └─────────┘                                            │
 └─────────────────────────────────────────────────────────┘
 ```
@@ -81,108 +86,67 @@ cursorflow run _cursorflow/tasks/2412211530_SimpleFix
 ### Multiple Tasks in Lane
 
 ```bash
-cursorflow prepare Feature \
-  --task "plan|sonnet-4.5-thinking|Create plan|Plan ready" \
-  --task "implement|sonnet-4.5|Build feature|Code done"
+cursorflow add Feature api \
+  --task "name=plan|prompt=Create plan" \
+  --task "name=implement|prompt=Build feature"
 ```
 
 ```
 ┌─────────────────────────────────────────────────────────┐
-│  01-lane-1                                              │
+│  api                                                    │
 │  ┌────┐     ┌─────────┐                                 │
-│  │plan│ ──▶ │implement│ → Review → Complete             │
+│  │plan│ ──▶ │implement│ → Complete                      │
 │  └────┘     └─────────┘                                 │
 └─────────────────────────────────────────────────────────┘
 ```
 
-### Sequential Lanes (with `--sequential`)
+### Sequential Lanes (with dependencies)
 
 ```bash
-cursorflow prepare FullStack --lanes 3 --sequential \
-  --prompt "Implement your layer"
+cursorflow new FullStack --lanes "backend,api,frontend"
+
+cursorflow add FullStack backend --task "name=db|prompt=Setup database"
+cursorflow add FullStack api --task "name=impl|prompt=Create API" --after "backend"
+cursorflow add FullStack frontend --task "name=ui|prompt=Create UI" --after "api"
 ```
 
 ```
 ┌───────────┐     ┌───────────┐     ┌───────────┐
-│ 01-lane-1 │ ──▶ │ 02-lane-2 │ ──▶ │ 03-lane-3 │
-│ (DB)      │     │ (API)     │     │ (UI)      │
+│  backend  │ ──▶ │    api    │ ──▶ │ frontend  │
+│   (db)    │     │  (impl)   │     │   (ui)    │
 └───────────┘     └───────────┘     └───────────┘
                         │                 │
-                    merges 01         merges 01,02
+                   merges            merges
+                   backend          backend,api
 ```
 
 ### Parallel Lanes
 
 ```bash
-cursorflow prepare FrontBack --lanes 2 \
-  --prompt "Implement your layer"
+cursorflow new FrontBack --lanes "frontend,backend"
+
+cursorflow add FrontBack frontend --task "name=ui|prompt=Create UI"
+cursorflow add FrontBack backend --task "name=api|prompt=Create API"
 ```
 
 ```
 ┌───────────┐
-│ 01-lane-1 │  (Frontend)
+│ frontend  │  (UI)
 └───────────┘
               ─── both run in parallel
 ┌───────────┐
-│ 02-lane-2 │  (Backend)
+│  backend  │  (API)
 └───────────┘
 ```
 
-## JSON Schema (RunnerConfig)
-
-Each JSON file in the tasks directory follows this schema:
-
-```json
-{
-  "baseBranch": "main",
-  "branchPrefix": "feature/lane-1-",
-  "timeout": 600000,
-  "enableIntervention": false,
-  "dependsOn": ["01-lane-1"],
-  "dependencyPolicy": {
-    "allowDependencyChange": false,
-    "lockfileReadOnly": true
-  },
-  "enableReview": true,
-  "reviewModel": "sonnet-4.5-thinking",
-  "maxReviewIterations": 3,
-  "tasks": [
-    {
-      "name": "implement",
-      "prompt": "Create a reusable button component...",
-      "model": "sonnet-4.5",
-      "acceptanceCriteria": ["Build passes", "Tests pass"]
-    }
-  ]
-}
-```
-
-### Configuration Reference
-
-| Field | Type | Required | Description |
-|-------|------|----------|-------------|
-| `baseBranch` | string | Yes | Branch to create worktree from |
-| `branchPrefix` | string | Yes | Prefix for feature branch naming |
-| `tasks` | Task[] | Yes | Array of task objects to execute |
-| `dependsOn` | string[] | No | Lane names to wait for and merge |
-| `timeout` | number | No | Task timeout in ms (default: 600000) |
-| `enableIntervention` | boolean | No | Allow stdin injection during execution |
-| `dependencyPolicy.allowDependencyChange` | boolean | No | Allow package.json modifications |
-| `dependencyPolicy.lockfileReadOnly` | boolean | No | Keep lockfile read-only |
-| `enableReview` | boolean | No | Enable AI code review (default: true) |
-| `reviewModel` | string | No | Model for code review |
-| `maxReviewIterations` | number | No | Max review cycles (default: 3) |
-
-### Task Object
-
-| Field | Type | Required | Description |
-|-------|------|----------|-------------|
-| `name` | string | Yes | Task identifier (alphanumeric, `-`, `_`) |
-| `prompt` | string | Yes | Instructions for the AI agent |
-| `model` | string | No | Model override for this task |
-| `acceptanceCriteria` | string[] | No | Criteria for AI reviewer validation |
-| `dependsOn` | string[] | No | Task-level dependencies (lane:task) |
-| `timeout` | number | No | Task-specific timeout in ms |
+## Log Format
+
+Logs use the format `[L{n}-T{t}-{lanename}]`:
+- `L{n}`: Lane number (1-indexed)
+- `T{t}`: Task number (1-indexed)
+- `{lanename}`: First 10 characters of lane name
+
+Example: `[L1-T2-backend]` = Lane 1, Task 2, lane name "backend"
 
 ## Monitoring During Execution
 
@@ -190,8 +154,8 @@ Each JSON file in the tasks directory follows this schema:
 # In another terminal
 cursorflow monitor latest
 
-# Or specify the task directory
-cursorflow monitor _cursorflow/tasks/2412211530_AddAPI
+# Or specify the run directory
+cursorflow monitor _cursorflow/logs/runs/run-xxxxx
 ```
 
 The monitor shows:
@@ -221,33 +185,18 @@ Circular dependency detected
 ```
 → Check your `dependsOn` fields for cycles (A→B, B→A)
 
-```
-Unknown dependency: 01-lane-99
-```
-→ Verify the lane name in `dependsOn` matches an actual JSON filename
-
-### Merge Conflicts
-
-When a dependent lane's auto-merge fails:
-
-1. Find the worktree path in `cursorflow monitor`
-2. Navigate to the worktree directory
-3. Resolve conflicts manually and commit
-4. Resume with `cursorflow resume <lane-name>`
-
 ### Lane Stuck
 
 If a lane stops responding:
 
 1. Check the agent window in Cursor IDE
 2. Use `cursorflow signal <lane-name> --message "continue"` to nudge
-3. Or terminate and restart with `cursorflow run --resume`
+3. Or use `cursorflow resume --all` to resume
 
 ## Best Practices
 
-1. **Always Validate First**: Run `cursorflow doctor --tasks-dir <dir>` before `run`
+1. **Always Validate First**: Run `cursorflow doctor <flow-name>` before `run`
 2. **Start Small**: Test with a single lane before scaling up
 3. **Use `--dry-run`**: Preview execution plan before committing
 4. **Monitor Actively**: Keep `cursorflow monitor` running in a separate terminal
 5. **Plan Dependencies**: Draw out the DAG before running complex workflows
-6. **Include Verification**: Add verify tasks to catch edge cases

package/dist/cli/doctor.js

@@ -46,17 +46,25 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 const logger = __importStar(require("../utils/logger"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
 const doctor_1 = require("../utils/doctor");
 const cursor_agent_1 = require("../utils/cursor-agent");
+const config_1 = require("../utils/config");
+const path_1 = require("../utils/path");
+const flow_1 = require("../utils/flow");
 function printHelp() {
     console.log(`
-Usage: cursorflow doctor [options]
+Usage: cursorflow doctor [flow-name] [options]
 
 Verify your environment is ready for CursorFlow runs.
 
+Arguments:
+  [flow-name]            Flow or task name to validate (optional)
+
 Options:
   --json                 Output machine-readable JSON
-  --tasks-dir <path>     Also validate lane files (run preflight)
+  --tasks-dir <path>     Validate specific directory (legacy)
   --executor <type>      cursor-agent | cloud
   --no-cursor            Skip Cursor Agent install/auth checks
   --test-agent           Run interactive agent test (to approve MCP/permissions)
@@ -64,16 +72,26 @@ Options:
 
 Examples:
   cursorflow doctor
+  cursorflow doctor TestFeature
   cursorflow doctor --test-agent
-  cursorflow doctor --tasks-dir _cursorflow/tasks/demo-test/
+  cursorflow doctor --tasks-dir _cursorflow/flows/001_TestFeature
   `);
 }
 function parseArgs(args) {
     const tasksDirIdx = args.indexOf('--tasks-dir');
     const executorIdx = args.indexOf('--executor');
+    // Find positional argument (flow/task name)
+    // Exclude args that are values for options
+    const optionValueIndices = new Set();
+    if (tasksDirIdx >= 0 && tasksDirIdx + 1 < args.length)
+        optionValueIndices.add(tasksDirIdx + 1);
+    if (executorIdx >= 0 && executorIdx + 1 < args.length)
+        optionValueIndices.add(executorIdx + 1);
+    const flowOrTaskName = args.find((arg, idx) => !arg.startsWith('--') && !optionValueIndices.has(idx)) || null;
     const options = {
         json: args.includes('--json'),
         tasksDir: tasksDirIdx >= 0 ? (args[tasksDirIdx + 1] || null) : null,
+        flowOrTaskName,
         executor: executorIdx >= 0 ? (args[executorIdx + 1] || null) : null,
         includeCursorAgentChecks: !args.includes('--no-cursor'),
         testAgent: args.includes('--test-agent'),
@@ -130,9 +148,34 @@ async function doctor(args) {
         const success = (0, cursor_agent_1.runInteractiveAgentTest)();
         process.exit(success ? 0 : 1);
     }
+    // Resolve tasksDir from flow name if provided
+    let tasksDir = options.tasksDir;
+    if (!tasksDir && options.flowOrTaskName) {
+        try {
+            const config = (0, config_1.loadConfig)();
+            const flowsDir = (0, path_1.safeJoin)(config.projectRoot, config.flowsDir);
+            const foundFlow = (0, flow_1.findFlowDir)(flowsDir, options.flowOrTaskName);
+            if (foundFlow) {
+                tasksDir = foundFlow;
+            }
+            else {
+                // Try as a direct path
+                const directPath = path.resolve(process.cwd(), options.flowOrTaskName);
+                if (fs.existsSync(directPath)) {
+                    tasksDir = directPath;
+                }
+                else {
+                    tasksDir = options.flowOrTaskName;
+                }
+            }
+        }
+        catch {
+            tasksDir = options.flowOrTaskName;
+        }
+    }
     const report = (0, doctor_1.runDoctor)({
         cwd: process.cwd(),
-        tasksDir: options.tasksDir || undefined,
+        tasksDir: tasksDir || undefined,
         executor: options.executor || undefined,
         includeCursorAgentChecks: options.includeCursorAgentChecks,
     });

package/dist/cli/doctor.js.map

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

package/dist/cli/logs.js

@@ -711,10 +711,19 @@ async function logs(args) {
         return;
     }
     const config = (0, config_1.loadConfig)();
+    const originalCwd = process.cwd();
+    // Change current directory to project root for consistent path handling
+    if (config.projectRoot !== originalCwd) {
+        logger.debug(`Changing directory to project root: ${config.projectRoot}`);
+        process.chdir(config.projectRoot);
+    }
     // Find run directory
     let runDir = options.runDir;
+    if (runDir && runDir !== 'latest' && !path.isAbsolute(runDir)) {
+        runDir = path.resolve(originalCwd, runDir);
+    }
     if (!runDir || runDir === 'latest') {
-        runDir = findLatestRunDir(config.logsDir) || undefined;
+        runDir = findLatestRunDir((0, config_1.getLogsDir)(config)) || undefined;
     }
     if (!runDir || !fs.existsSync(runDir)) {
         console.error('No run found');