@standardbeagle/dart-query 0.5.0 → 0.7.0

package/README.md

@@ -1,90 +1,18 @@
 # dart-query
 
-**Production-ready MCP server for Dart AI task management with batch operations, SQL-like selectors, CSV import, and zero context rot.**
+MCP server for [Dart AI](https://dartai.com) task management, optimized for batch operations and minimal context usage.
 
-## What Problem Does This Solve?
-
-### The Context Rot Problem
-
-When managing tasks in Dart AI through an LLM, you quickly run into **context rot**:
-
-```
-You: "Update all high-priority tasks in Engineering to assign them to John"
-
-LLM: Let me list the tasks...
-[Fetches 847 tasks, fills context window with JSON]
-[Context limit hit before making any updates]
-[Lost track of what we were doing]
-```
-
-**Traditional approach** (context explosion):
-1. List all tasks → 2000+ tokens
-2. Filter in LLM → context fills with intermediate data
-3. Update each task individually → 50+ API calls, each response adds more context
-4. By task #10, you've lost context of what you're doing
-5. No way to verify results without re-fetching everything
-
-**dart-query approach** (zero context rot):
-1. Single DartQL query: `"dartboard = 'Engineering' AND priority = 'high'"`
-2. Server-side batch operation updates all 50 tasks
-3. Returns summary: "50 tasks updated in 12s"
-4. Context usage: ~100 tokens total
-
-### Context-Efficient Design
-
-Every operation is designed to **minimize token usage** while maximizing capability:
-
-| Operation | Traditional | dart-query | Token Savings |
-|-----------|-------------|------------|---------------|
-| Update 50 tasks | 50 API calls, ~25K tokens | 1 batch op, ~200 tokens | **99% reduction** |
-| Import 100 tasks | 100 create calls, ~30K tokens | 1 CSV import, ~300 tokens | **99% reduction** |
-| Find + update tasks | List all + filter + update, ~20K tokens | DartQL selector, ~150 tokens | **99% reduction** |
-
-**Key features for context efficiency:**
-- **Progressive disclosure**: `info` tool discovers capabilities without reading schemas
-- **Detail levels**: Return minimal/standard/full data based on need
-- **Batch operations**: Single operation handles hundreds of tasks
-- **Config caching**: 5-minute cache prevents repeated fetches
-- **DartQL language**: SQL-like selectors instead of procedural filtering
-
-### Production Safety Without Sandbox
-
-Dart AI has **no sandbox environment** - all operations are production. dart-query provides safety through:
-
-- **Dry-run modes**: Preview every batch operation before execution
-- **Validation phases**: CSV imports validate before creating anything
-- **Confirmation flags**: Batch deletes require explicit `confirm=true`
-- **Recoverable operations**: Deleted tasks go to trash, not permanent deletion
-- **Error isolation**: Failed operations don't corrupt subsequent work
+Instead of looping through tasks one-by-one (filling your context window with intermediate JSON), dart-query uses DartQL selectors and server-side batch operations to update hundreds of tasks in a single call. A 50-task update that would normally consume ~30K tokens takes ~200 tokens with zero context rot.
 
 ## Quick Start
 
-### 1. Installation
+### 1. Get Your Dart AI Token
 
-**Option A: Install from npm (recommended)**
+Visit https://app.dartai.com/?settings=account and copy your token (starts with `dsa_`).
 
-```bash
-npm install -g @standardbeagle/dart-query
-```
-
-**Option B: Install from source**
-
-```bash
-git clone https://github.com/standardbeagle/dart-query
-cd dart-query
-npm install
-npm run build
-```
-
-### 2. Get Your Dart AI Token
-
-Visit https://app.dartai.com/?settings=account and copy your token (starts with `dsa_`)
-
-### 3. Configure MCP
+### 2. Configure MCP
 
-**Option A: Using npm global install**
-
-Add to your MCP settings (e.g., `~/Library/Application Support/Claude/claude_desktop_config.json`):
+**npx (recommended)**
 
 ```json
 {
@@ -100,328 +28,72 @@ Add to your MCP settings (e.g., `~/Library/Application Support/Claude/claude_des
 }
 ```
 
-**Option B: Using local installation**
-
-```json
-{
-  "mcpServers": {
-    "dart-query": {
-      "command": "node",
-      "args": ["/absolute/path/to/dart-query/dist/index.js"],
-      "env": {
-        "DART_TOKEN": "dsa_your_token_here"
-      }
-    }
-  }
-}
-```
-
-**Option C: Using SLOP-MCP for dynamic management**
+**SLOP-MCP (v0.10.0+)**
 
 ```bash
-# With npm package
 slop register dart-query \
   --command npx \
   --args "-y" "@standardbeagle/dart-query" \
   --env DART_TOKEN=dsa_your_token_here \
   --scope user
-
-# With local installation
-slop register dart-query \
-  --command node \
-  --args dist/index.js \
-  --env DART_TOKEN=dsa_your_token_here \
-  --scope user
 ```
 
-### 4. Verify Connection
-
-```typescript
-// Get workspace config
-get_config({})
+### 3. Verify
 
-// Explore capabilities
+```
 info({ level: "overview" })
 ```
 
-### 5. Your First Operations
+### 4. Example: Batch Update
 
 ```typescript
-// Create a task
-create_task({
-  title: "Test dart-query MCP",
-  dartboard: "Personal/test",
-  priority: "high"
-})
-
-// Batch update multiple tasks (dry run first!)
+// Preview first
 batch_update_tasks({
-  selector: "dartboard = 'Personal/test' AND priority = 'high'",
+  selector: "dartboard = 'Engineering' AND priority = 'high'",
   updates: { status: "Doing" },
-  dry_run: true  // Preview first
+  dry_run: true
 })
 
-// Execute after reviewing preview
+// Execute
 batch_update_tasks({
-  selector: "dartboard = 'Personal/test' AND priority = 'high'",
+  selector: "dartboard = 'Engineering' AND priority = 'high'",
   updates: { status: "Doing" },
   dry_run: false
 })
-
-// Clean up
-batch_delete_tasks({
-  selector: "dartboard = 'Personal/test'",
-  dry_run: false,
-  confirm: true  // Required safety flag
-})
-```
-
-## Core Features
-
-### 🔍 **Progressive Discovery**
-Start with `info` tool to explore capabilities without loading all schemas. Navigate overview → group → tool with increasing detail.
-
-### 🎯 **DartQL Query Language**
-SQL-like WHERE clause syntax for powerful batch operations:
-```sql
-dartboard = 'Engineering' AND priority = 'high' AND tags CONTAINS 'bug'
-```
-
-### 📊 **CSV Bulk Import**
-Import hundreds of tasks from CSV with validation, error recovery, and fuzzy matching:
-- Validate phase catches errors before creating anything
-- Parallel import with configurable concurrency
-- Continue-on-error mode for resilience
-
-### ⚡ **Batch Operations**
-Update or delete hundreds of tasks in a single operation:
-- Server-side execution (no context rot)
-- Dry-run preview mode
-- Parallel processing with rate limiting
-
-### 💾 **Context Efficiency**
-- Detail levels (minimal/standard/full)
-- 5-minute config cache
-- Token-optimized responses
-- Progressive disclosure of capabilities
-
-### 🛡️ **Production Safety**
-- No sandbox: all operations are production
-- Dry-run modes for batch operations
-- Validation phases for CSV imports
-- Confirmation flags for destructive operations
-- Recoverable deletions (tasks → trash)
-
-## Tool Groups
-
-| Group | Tools | Use Case |
-|-------|-------|----------|
-| **Discovery** | `info`, `get_config` | Explore capabilities, get workspace config |
-| **Task CRUD** | `create_task`, `get_task`, `update_task`, `delete_task`, `add_task_comment` | Single task operations |
-| **Task Query** | `list_tasks`, `search_tasks` | Find tasks with filters or full-text search |
-| **Batch Operations** | `batch_update_tasks`, `batch_delete_tasks`, `get_batch_status` | Bulk operations on hundreds of tasks |
-| **CSV Import** | `import_tasks_csv` | Bulk create from CSV files |
-| **Documents** | `list_docs`, `create_doc`, `get_doc`, `update_doc`, `delete_doc` | Document management |
-
-## Common Use Cases
-
-### Bulk Task Management
-```typescript
-// Update all overdue high-priority tasks
-batch_update_tasks({
-  selector: "due_at < '2026-01-18' AND priority = 'high' AND status != 'Done'",
-  updates: { priority: "critical", assignees: ["john@company.com"] },
-  dry_run: true  // Preview first!
-})
-```
-
-### Project Cleanup
-```typescript
-// Archive completed tasks from Q4 2025
-batch_update_tasks({
-  selector: "completed_at >= '2025-10-01' AND completed_at < '2026-01-01'",
-  updates: { dartboard: "Archive" },
-  dry_run: false,
-  concurrency: 10
-})
-```
-
-### CSV Migration
-```typescript
-// Import tasks from external system
-import_tasks_csv({
-  csv_file_path: "./jira-export.csv",
-  dartboard: "Engineering",
-  column_mapping: {
-    "Issue Summary": "title",
-    "Assignee Email": "assignee",
-    "Priority": "priority"
-  },
-  validate_only: true  // Validate first!
-})
-```
-
-### Search and Update
-```typescript
-// Find all authentication-related tasks
-const results = search_tasks({
-  query: "authentication oauth security",
-  dartboard: "Engineering",
-  limit: 20
-})
-
-// Update them in batch
-batch_update_tasks({
-  selector: "tags CONTAINS 'security' AND title LIKE '%auth%'",
-  updates: { priority: "high" }
-})
-```
-
-## Documentation
-
-📖 **[Complete Tool Documentation →](./TOOLS.md)**
-
-Detailed documentation for all tools including:
-- Full parameter references
-- Return value schemas
-- How-to guides for common workflows
-- Use case examples
-- DartQL syntax reference
-- CSV import formats
-- Error handling strategies
-- Performance optimization tips
-
-## Production Safety Checklist
-
-**Before ANY batch operation:**
-- [ ] Use `dry_run: true` and review preview
-- [ ] Verify selector matches ONLY intended tasks
-- [ ] Test with small dataset first (< 10 tasks)
-- [ ] Have rollback plan (tasks go to trash, recoverable)
-
-**Before CSV import:**
-- [ ] Use `validate_only: true` and fix all errors
-- [ ] Test with 5-10 rows first
-- [ ] Verify column mapping is correct
-- [ ] Check references exist in workspace (`get_config`)
-
-**Before batch delete:**
-- [ ] Triple-check selector specificity
-- [ ] Understand tasks move to trash (recoverable)
-- [ ] Set `confirm: true` (required safety flag)
-
-## Performance Metrics
-
-Tested with production Dart API:
-
-| Operation | Tasks | Time | Throughput |
-|-----------|-------|------|------------|
-| CSV Import | 41 tasks | 17.4s | 2.4 tasks/sec |
-| Batch Update | 75 tasks | 22s | 3.4 tasks/sec |
-| Batch Delete | 165 tasks | 37s | 4.5 tasks/sec |
-| Single CRUD | 1 task | <2s | - |
-
-*Concurrency: 10-20 parallel operations, production rate limits observed*
-
-## Troubleshooting
-
-### Authentication Issues
-```
-Error: Invalid DART_TOKEN
-```
-**Solution**: Ensure token starts with `dsa_` and get fresh token from https://app.dartai.com/?settings=account
-
-### Rate Limiting (429)
-```
-Error: Rate limit exceeded
 ```
-**Solution**: Reduce `concurrency` parameter (default: 5, try: 2-3). Automatic retry with exponential backoff.
 
-### CSV Import Errors
-```
-Error: Row 3, column 'priority': Invalid priority: "5". Available: critical, high, medium, low
-```
-**Solution**: Use `validate_only: true` to see all errors. Check available values with `get_config()`.
-
-### DartQL Syntax Errors
-```
-Error: Unknown field: priorty. Did you mean: priority?
-```
-**Solution**: Use fuzzy match suggestions. Reference field list with `info({ level: "tool", target: "batch_update_tasks" })`.
-
-**See [TOOLS.md](./TOOLS.md) for comprehensive troubleshooting guide.**
+## Tools
 
-## Development
+| Group | Tools | Purpose |
+|-------|-------|---------|
+| Discovery | `info`, `get_config` | Explore capabilities, workspace config |
+| Task CRUD | `create_task`, `get_task`, `update_task`, `delete_task`, `add_task_comment` | Single task operations |
+| Query | `list_tasks`, `search_tasks` | Find tasks with filters or full-text search |
+| Batch | `batch_update_tasks`, `batch_delete_tasks`, `get_batch_status` | Bulk operations with DartQL selectors |
+| Import | `import_tasks_csv` | Bulk create from CSV with validation |
+| Docs | `list_docs`, `create_doc`, `get_doc`, `update_doc`, `delete_doc` | Document management |
 
-```bash
-# Install dependencies
-npm install
+See **[TOOLS.md](./TOOLS.md)** for full parameter references, DartQL syntax, and CSV import format.
 
-# Build TypeScript
-npm run build
+## DartQL Selectors
 
-# Type checking
-npm run typecheck
+SQL-like WHERE clauses for targeting tasks in batch operations:
 
-# Run tests (unit tests only - no sandbox for integration)
-npm test
-```
-
-### Project Structure
-```
-src/
-├── index.ts              # MCP server entry point
-├── tools/                # Tool implementations (info, CRUD, batch, import)
-├── api/dartClient.ts     # Dart API wrapper with retry logic
-├── parsers/              # DartQL and CSV parsers
-├── cache/configCache.ts  # 5-minute config cache
-├── batch/                # Batch operation tracking
-└── types/index.ts        # TypeScript interfaces
-```
-
-## Design Philosophy
-
-1. **Context efficiency first**: Every feature minimizes token usage
-2. **Production safety**: Dry-run, validation, confirmation flags
-3. **Progressive disclosure**: Discover capabilities without overwhelming schemas
-4. **Zero context rot**: Batch operations prevent context pollution
-5. **Fail-safe defaults**: `dry_run: true`, `validate_only: true` by default
-
-## Comparison: Traditional vs dart-query
-
-### Update 50 Tasks (Traditional LLM approach)
-```
-1. list_tasks() → Returns 50 task objects (~15,000 tokens)
-2. For each task:
-   - update_task(task1) → ~300 tokens
-   - update_task(task2) → ~300 tokens
-   - ... (50 iterations)
-3. Total: ~30,000 tokens, 50 API calls, context window exhausted
-```
-
-### Update 50 Tasks (dart-query)
-```
-1. batch_update_tasks({
-     selector: "dartboard = 'X' AND priority = 'high'",
-     updates: { assignee: "john@company.com" }
-   })
-2. Total: ~200 tokens, 1 API call, zero context rot
+```sql
+dartboard = 'Engineering' AND priority = 'high' AND tags CONTAINS 'bug'
+due_at < '2026-01-18' AND status != 'Done'
+title LIKE '%auth%'
 ```
 
-**Token savings: 99%**
-**Time savings: 90%**
-**Context rot: Eliminated**
+## Safety
 
-## Related Projects
+All Dart AI operations are production (no sandbox). dart-query provides:
 
-- [Dart AI](https://dartai.com) - AI-powered task management platform
-- [MCP](https://modelcontextprotocol.io) - Model Context Protocol specification
-- [SLOP-MCP](https://github.com/belingud/slop-mcp) - Dynamic MCP server management
+- **Dry-run mode** on all batch operations — preview before executing
+- **Validation phase** for CSV imports — catch errors before creating anything
+- **Confirmation flag** (`confirm: true`) required for batch deletes
+- **Recoverable deletes** — tasks move to trash, not permanent deletion
 
 ## License
 
 MIT
-
----
-
-**Built for production use. Tested with live Dart AI workspace managing 2000+ tasks across 67 dartboards.**

package/dist/api/dartClient.d.ts

@@ -1,4 +1,4 @@
-import { DartTask, DartConfig, DartDoc, CreateTaskInput, UpdateTaskInput, ListTasksInput } from '../types/index.js';
+import { DartTask, DartConfig, DartDoc, CreateTaskInput, ListTasksInput } from '../types/index.js';
 export interface DartClientConfig {
     token: string;
     baseUrl?: string;
@@ -17,7 +17,7 @@ export declare class DartClient {
     }>;
     private mapTaskResponse;
     getTask(dartId: string): Promise<DartTask>;
-    updateTask(input: UpdateTaskInput): Promise<DartTask>;
+    updateTask(dartId: string, updates: Partial<DartTask>): Promise<DartTask>;
     deleteTask(dartId: string): Promise<{
         success: boolean;
         dart_id: string;

package/dist/api/dartClient.d.ts.map

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

package/dist/api/dartClient.js

@@ -1,5 +1,15 @@
 import pRetry from 'p-retry';
 import { DartAPIError, } from '../types/index.js';
+const STATUS_LABELS = {
+    400: 'Bad Request',
+    401: 'Unauthorized',
+    403: 'Forbidden',
+    404: 'Not Found',
+    429: 'Rate Limited',
+    500: 'Server Error',
+    502: 'Bad Gateway',
+    503: 'Service Unavailable',
+};
 export class DartClient {
     token;
     baseUrl;
@@ -74,40 +84,42 @@ export class DartClient {
         });
     }
     async handleErrorResponse(response) {
-        let errorData = {};
-        let errorMessage = response.statusText || 'Unknown error';
-        const contentType = response.headers.get('content-type');
-        if (contentType && contentType.includes('application/json')) {
-            try {
-                const text = await response.text();
-                if (text) {
-                    errorData = JSON.parse(text);
-                    errorMessage = errorData.error?.message || errorMessage;
+        let responseBody;
+        let errorDetail = '';
+        try {
+            const text = await response.text();
+            if (text) {
+                const contentType = response.headers.get('content-type');
+                if (contentType?.includes('application/json')) {
+                    const parsed = JSON.parse(text);
+                    responseBody = parsed;
+                    errorDetail =
+                        parsed.error?.message ||
+                            parsed.detail ||
+                            parsed.message ||
+                            (typeof parsed.error === 'string' ? parsed.error : '') ||
+                            '';
+                    if (!errorDetail && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                        const fields = Object.entries(parsed)
+                            .filter(([, v]) => v !== null && v !== undefined)
+                            .map(([k, v]) => `${k}: ${Array.isArray(v) ? v.join(', ') : v}`)
+                            .slice(0, 5);
+                        if (fields.length > 0) {
+                            errorDetail = fields.join('; ');
+                        }
+                    }
+                }
+                else {
+                    errorDetail = text.slice(0, 500);
                 }
-            }
-            catch {
             }
         }
-        switch (response.status) {
-            case 400:
-                throw new DartAPIError(`Bad Request: ${errorMessage}`, 400, errorData);
-            case 401:
-                throw new DartAPIError(`Unauthorized: Invalid or expired token. ${errorMessage}`, 401, errorData);
-            case 403:
-                throw new DartAPIError(`Forbidden: Insufficient permissions. ${errorMessage}`, 403, errorData);
-            case 404:
-                throw new DartAPIError(`Not Found: ${errorMessage}`, 404, errorData);
-            case 429:
-                throw new DartAPIError(`Rate Limit Exceeded: ${errorMessage}`, 429, errorData);
-            case 500:
-                throw new DartAPIError(`Internal Server Error: ${errorMessage}`, 500, errorData);
-            case 502:
-                throw new DartAPIError(`Bad Gateway: ${errorMessage}`, 502, errorData);
-            case 503:
-                throw new DartAPIError(`Service Unavailable: ${errorMessage}`, 503, errorData);
-            default:
-                throw new DartAPIError(`HTTP ${response.status}: ${errorMessage}`, response.status, errorData);
+        catch {
         }
+        const status = response.status;
+        const statusLabel = STATUS_LABELS[status] || `HTTP ${status}`;
+        const message = errorDetail || response.statusText || 'No details available';
+        throw new DartAPIError(`${statusLabel}: ${message}`, status, responseBody);
     }
     async getConfig() {
         return this.request('GET', '/config');
@@ -141,16 +153,20 @@ export class DartClient {
             apiInput.startAt = input.start_at;
         if (input.parent_task)
             apiInput.parentId = input.parent_task;
+        const taskRelationships = {};
         if (input.subtask_ids !== undefined)
-            apiInput.subtaskIds = input.subtask_ids;
+            taskRelationships.subtaskIds = input.subtask_ids;
         if (input.blocker_ids !== undefined)
-            apiInput.blockerIds = input.blocker_ids;
+            taskRelationships.blockerIds = input.blocker_ids;
         if (input.blocking_ids !== undefined)
-            apiInput.blockingIds = input.blocking_ids;
+            taskRelationships.blockingIds = input.blocking_ids;
         if (input.duplicate_ids !== undefined)
-            apiInput.duplicateIds = input.duplicate_ids;
+            taskRelationships.duplicateIds = input.duplicate_ids;
         if (input.related_ids !== undefined)
-            apiInput.relatedIds = input.related_ids;
+            taskRelationships.relatedIds = input.related_ids;
+        if (Object.keys(taskRelationships).length > 0) {
+            apiInput.taskRelationships = taskRelationships;
+        }
         const response = await this.request('POST', '/tasks', { item: apiInput });
         return this.mapTaskResponse(response.item);
     }
@@ -212,16 +228,15 @@ export class DartClient {
         const response = await this.request('GET', `/tasks/${encodeURIComponent(dartId.trim())}`);
         return this.mapTaskResponse(response.item);
     }
-    async updateTask(input) {
-        if (!input.dart_id || typeof input.dart_id !== 'string' || input.dart_id.trim() === '') {
+    async updateTask(dartId, updates) {
+        if (!dartId || typeof dartId !== 'string' || dartId.trim() === '') {
             throw new DartAPIError('dart_id is required and must be a non-empty string', 400);
         }
-        if (!input.updates || typeof input.updates !== 'object' || Object.keys(input.updates).length === 0) {
-            throw new DartAPIError('updates is required and must be a non-empty object', 400);
+        if (!updates || typeof updates !== 'object' || Object.keys(updates).length === 0) {
+            throw new DartAPIError('No fields to update', 400);
         }
-        const { dart_id, updates } = input;
         const apiUpdates = {
-            id: dart_id.trim(),
+            id: dartId.trim(),
         };
         if (updates.title !== undefined)
             apiUpdates.title = updates.title;
@@ -245,17 +260,21 @@ export class DartClient {
             apiUpdates.startAt = updates.start_at;
         if (updates.parent_task !== undefined)
             apiUpdates.parentId = updates.parent_task;
+        const taskRelationships = {};
         if (updates.subtask_ids !== undefined)
-            apiUpdates.subtaskIds = updates.subtask_ids;
+            taskRelationships.subtaskIds = updates.subtask_ids;
         if (updates.blocker_ids !== undefined)
-            apiUpdates.blockerIds = updates.blocker_ids;
+            taskRelationships.blockerIds = updates.blocker_ids;
         if (updates.blocking_ids !== undefined)
-            apiUpdates.blockingIds = updates.blocking_ids;
+            taskRelationships.blockingIds = updates.blocking_ids;
         if (updates.duplicate_ids !== undefined)
-            apiUpdates.duplicateIds = updates.duplicate_ids;
+            taskRelationships.duplicateIds = updates.duplicate_ids;
         if (updates.related_ids !== undefined)
-            apiUpdates.relatedIds = updates.related_ids;
-        const response = await this.request('PUT', `/tasks/${encodeURIComponent(dart_id.trim())}`, { item: apiUpdates });
+            taskRelationships.relatedIds = updates.related_ids;
+        if (Object.keys(taskRelationships).length > 0) {
+            apiUpdates.taskRelationships = taskRelationships;
+        }
+        const response = await this.request('PUT', `/tasks/${encodeURIComponent(dartId.trim())}`, { item: apiUpdates });
         return this.mapTaskResponse(response.item);
     }
     async deleteTask(dartId) {