sqlew 3.7.3 → 3.8.0

package/dist/tools/tasks/help/help.js

@@ -0,0 +1,293 @@
+/**
+ * Task help documentation
+ */
+/**
+ * Return comprehensive help documentation
+ */
+export function taskHelp() {
+    return {
+        tool: 'task',
+        description: 'Kanban Task Watcher for managing tasks with AI-optimized lifecycle states',
+        note: '💡 TIP: Use action: "example" to see comprehensive usage scenarios and real-world examples for all task actions.',
+        important: '🚨 AUTOMATIC FILE WATCHING: Linking files to tasks activates automatic file change monitoring and acceptance criteria validation. You can save 300 tokens per file compared to registering watchers manually. See auto_file_tracking section below.',
+        actions: {
+            create: {
+                description: 'Create a new task',
+                required_params: ['title'],
+                optional_params: ['description', 'acceptance_criteria', 'notes', 'priority', 'assigned_agent', 'created_by_agent', 'layer', 'tags', 'status', 'watch_files', 'file_actions'],
+                watch_files_param: '⚠️ DEPRECATED in v3.8.0: Use file_actions instead (auto-converts for backward compatibility)',
+                file_actions_param: '⭐ NEW in v3.8.0: Array of {path, action} objects for layer-based file tracking',
+                file_actions_validation: {
+                    required_for_layers: ['presentation', 'business', 'data', 'infrastructure', 'cross-cutting', 'documentation'],
+                    optional_for_layers: ['planning', 'coordination', 'review'],
+                    valid_actions: ['create', 'modify', 'delete', 'read'],
+                    note: 'Code and documentation layers MUST specify file_actions. Planning layers MAY specify file_actions.'
+                },
+                example: {
+                    action: 'create',
+                    title: 'Implement authentication endpoint',
+                    description: 'Add JWT-based authentication to /api/login',
+                    priority: 3,
+                    assigned_agent: 'backend-agent',
+                    layer: 'presentation',
+                    tags: ['api', 'authentication'],
+                    file_actions: [
+                        { path: 'src/api/auth.ts', action: 'create' },
+                        { path: 'src/middleware/jwt.ts', action: 'modify' }
+                    ]
+                }
+            },
+            update: {
+                description: 'Update task metadata',
+                required_params: ['task_id'],
+                optional_params: ['title', 'priority', 'assigned_agent', 'layer', 'description', 'acceptance_criteria', 'notes', 'watch_files', 'file_actions'],
+                watch_files_param: '⚠️ DEPRECATED in v3.8.0: Use file_actions instead (auto-converts for backward compatibility)',
+                file_actions_param: '⭐ NEW in v3.8.0: Array of {path, action} objects for layer-based file tracking',
+                example: {
+                    action: 'update',
+                    task_id: 5,
+                    priority: 4,
+                    assigned_agent: 'senior-backend-agent',
+                    file_actions: [
+                        { path: 'src/api/users.ts', action: 'modify' }
+                    ]
+                }
+            },
+            get: {
+                description: 'Get full task details including descriptions and links',
+                required_params: ['task_id'],
+                example: {
+                    action: 'get',
+                    task_id: 5
+                }
+            },
+            list: {
+                description: 'List tasks (token-efficient, no descriptions)',
+                required_params: [],
+                optional_params: ['status', 'assigned_agent', 'layer', 'tags', 'limit', 'offset'],
+                example: {
+                    action: 'list',
+                    status: 'in_progress',
+                    assigned_agent: 'backend-agent',
+                    limit: 20
+                }
+            },
+            move: {
+                description: 'Move task to different status with validation',
+                required_params: ['task_id', 'new_status'],
+                valid_statuses: ['todo', 'in_progress', 'waiting_review', 'blocked', 'done', 'archived'],
+                transitions: {
+                    todo: ['in_progress', 'blocked'],
+                    in_progress: ['waiting_review', 'blocked', 'done'],
+                    waiting_review: ['in_progress', 'todo', 'done'],
+                    blocked: ['todo', 'in_progress'],
+                    done: ['archived'],
+                    archived: []
+                },
+                example: {
+                    action: 'move',
+                    task_id: 5,
+                    new_status: 'in_progress'
+                }
+            },
+            link: {
+                description: 'Link task to decision/constraint/file',
+                required_params: ['task_id', 'link_type', 'target_id'],
+                optional_params: ['link_relation'],
+                link_types: ['decision', 'constraint', 'file'],
+                file_linking_behavior: '⚠️  DEPRECATED in v3.4.1: link_type="file" is deprecated. Use watch_files action or watch_files parameter instead.',
+                deprecation_note: 'For file watching, use: (1) watch_files parameter in create/update, or (2) watch_files action with watch/unwatch/list',
+                example: {
+                    action: 'link',
+                    task_id: 5,
+                    link_type: 'decision',
+                    target_id: 'auth_method',
+                    link_relation: 'implements'
+                }
+            },
+            watch_files: {
+                description: '⭐ NEW in v3.4.1: Watch/unwatch files for a task (replaces task.link(file))',
+                required_params: ['task_id', 'action'],
+                optional_params: ['file_paths'],
+                actions: ['watch', 'unwatch', 'list'],
+                behavior: {
+                    watch: 'Add files to watch list and activate file monitoring',
+                    unwatch: 'Remove files from watch list',
+                    list: 'List all files currently watched by this task'
+                },
+                examples: {
+                    watch: {
+                        task_id: 5,
+                        action: 'watch',
+                        file_paths: ['src/api/auth.ts', 'src/middleware/jwt.ts']
+                    },
+                    unwatch: {
+                        task_id: 5,
+                        action: 'unwatch',
+                        file_paths: ['src/middleware/jwt.ts']
+                    },
+                    list: {
+                        task_id: 5,
+                        action: 'list'
+                    }
+                },
+                note: 'Preferred over task.link(file) for better clarity and batch operations'
+            },
+            archive: {
+                description: 'Archive completed task (must be in done status)',
+                required_params: ['task_id'],
+                example: {
+                    action: 'archive',
+                    task_id: 5
+                }
+            },
+            create_batch: {
+                description: 'Create multiple tasks atomically',
+                required_params: ['tasks'],
+                optional_params: ['atomic'],
+                limits: {
+                    max_items: 50
+                },
+                note: '⚠️  IMPORTANT: The "tasks" parameter must be a JavaScript array, not a JSON string. MCP tools require pre-parsed objects.',
+                example: {
+                    action: 'create_batch',
+                    tasks: [
+                        { title: 'Task 1', priority: 2 },
+                        { title: 'Task 2', priority: 3, layer: 'business' }
+                    ],
+                    atomic: true
+                }
+            },
+            add_dependency: {
+                description: 'Add blocking relationship between tasks',
+                required_params: ['blocker_task_id', 'blocked_task_id'],
+                validations: [
+                    'No self-dependencies',
+                    'No circular dependencies (direct or transitive)',
+                    'Both tasks must exist',
+                    'Neither task can be archived'
+                ],
+                example: {
+                    action: 'add_dependency',
+                    blocker_task_id: 1,
+                    blocked_task_id: 2
+                },
+                note: 'Task #1 must be completed before Task #2 can start'
+            },
+            remove_dependency: {
+                description: 'Remove blocking relationship between tasks',
+                required_params: ['blocker_task_id', 'blocked_task_id'],
+                example: {
+                    action: 'remove_dependency',
+                    blocker_task_id: 1,
+                    blocked_task_id: 2
+                },
+                note: 'Silently succeeds even if dependency does not exist'
+            },
+            get_dependencies: {
+                description: 'Query task dependencies (bidirectional)',
+                required_params: ['task_id'],
+                optional_params: ['include_details'],
+                returns: {
+                    blockers: 'Array of tasks that block this task',
+                    blocking: 'Array of tasks this task blocks'
+                },
+                example: {
+                    action: 'get_dependencies',
+                    task_id: 2,
+                    include_details: true
+                },
+                note: 'Defaults to metadata-only (token-efficient). Set include_details=true for full task details.'
+            },
+            watcher: {
+                description: 'Query file watcher status and monitored files/tasks',
+                required_params: [],
+                optional_params: ['subaction'],
+                subactions: ['status', 'list_files', 'list_tasks', 'help'],
+                default_subaction: 'status',
+                examples: {
+                    status: {
+                        action: 'watcher',
+                        subaction: 'status'
+                    },
+                    list_files: {
+                        action: 'watcher',
+                        subaction: 'list_files'
+                    },
+                    list_tasks: {
+                        action: 'watcher',
+                        subaction: 'list_tasks'
+                    }
+                },
+                note: 'Use to monitor which files/tasks are being watched. File watching activates automatically when you link files to tasks.'
+            },
+            help: {
+                description: 'Return this help documentation',
+                example: { action: 'help' }
+            }
+        },
+        auto_stale_detection: {
+            description: 'Tasks automatically transition when abandoned',
+            behavior: {
+                in_progress: 'Untouched for >2 hours → waiting_review',
+                waiting_review: 'Untouched for >24 hours → todo'
+            },
+            config_keys: {
+                task_stale_hours_in_progress: 'Hours before in_progress tasks go stale (default: 2)',
+                task_stale_hours_waiting_review: 'Hours before waiting_review tasks go stale (default: 24)',
+                task_auto_stale_enabled: 'Enable/disable auto-stale detection (default: true)'
+            }
+        },
+        priority_levels: {
+            1: 'low',
+            2: 'medium (default)',
+            3: 'high',
+            4: 'critical'
+        },
+        layers: {
+            description: 'Architecture layers for task classification (expanded in v3.8.0)',
+            code_layers: {
+                presentation: 'UI/UX, API endpoints, views - REQUIRES file_actions',
+                business: 'Business logic, services, domain models - REQUIRES file_actions',
+                data: 'Database, repositories, data access - REQUIRES file_actions',
+                infrastructure: 'DevOps, config, deployment - REQUIRES file_actions',
+                cross_cutting: 'Logging, security, error handling - REQUIRES file_actions'
+            },
+            planning_layers: {
+                planning: 'Research, surveys, investigation, design decisions - file_actions OPTIONAL',
+                documentation: 'README, CHANGELOG, API docs, user guides - REQUIRES file_actions',
+                coordination: 'Multi-agent orchestration, sprint planning - file_actions OPTIONAL',
+                review: 'Code review, QA verification, testing validation - file_actions OPTIONAL'
+            },
+            note: 'Code and documentation layers enforce file_actions requirement. Planning layers allow tasks without file modifications.'
+        },
+        auto_file_tracking: {
+            description: 'Automatic file watching and acceptance criteria validation - save 300 tokens per file vs manual registration',
+            recommendation: '⭐ BEST PRACTICE: Except in exceptional cases, it is recommended to set up file watchers for all tasks that involve code changes. This provides automatic status tracking with zero token overhead.',
+            how_it_works: [
+                '1. Link files to tasks using the link action with link_type="file"',
+                '2. File watcher automatically activates and monitors linked files',
+                '3. When files are saved, watcher detects changes',
+                '4. If task has acceptance_criteria, watcher validates criteria against changes',
+                '5. Results appear in terminal output with pass/fail status'
+            ],
+            requirements: [
+                'Task must have files linked via link action',
+                'File paths must be relative to project root (e.g., "src/api/auth.ts")',
+                'Watcher only monitors files explicitly linked to tasks'
+            ],
+            token_efficiency: 'File watching happens in background. No MCP tokens consumed until you query status. Manual file tracking would cost ~500-1000 tokens per file check.',
+            documentation_reference: 'docs/AUTO_FILE_TRACKING.md - Complete guide with examples'
+        },
+        documentation: {
+            task_overview: 'docs/TASK_OVERVIEW.md - Lifecycle, status transitions, auto-stale detection (363 lines, ~10k tokens)',
+            task_actions: 'docs/TASK_ACTIONS.md - All action references with examples (854 lines, ~21k tokens)',
+            task_linking: 'docs/TASK_LINKING.md - Link tasks to decisions/constraints/files (729 lines, ~18k tokens)',
+            task_migration: 'docs/TASK_MIGRATION.md - Migrate from decision-based tracking (701 lines, ~18k tokens)',
+            tool_selection: 'docs/TOOL_SELECTION.md - Task vs decision vs constraint comparison (236 lines, ~12k tokens)',
+            workflows: 'docs/WORKFLOWS.md - Multi-agent task coordination workflows (602 lines, ~30k tokens)',
+            shared_concepts: 'docs/SHARED_CONCEPTS.md - Layer definitions, enum values (status/priority), atomic mode (339 lines, ~17k tokens)'
+        }
+    };
+}
+//# sourceMappingURL=help.js.map

package/dist/tools/tasks/help/help.js.map

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

package/dist/tools/tasks/help/use-case.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Task Use Case Documentation (v3.8.0)
+ *
+ * Comprehensive scenarios demonstrating file_actions parameter usage
+ * across all 9 architecture layers.
+ */
+/**
+ * Get comprehensive use case examples for task tool
+ */
+export declare function taskUseCase(): any;
+//# sourceMappingURL=use-case.d.ts.map

package/dist/tools/tasks/help/use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-case.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/help/use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,wBAAgB,WAAW,IAAI,GAAG,CA0yBjC"}