sqlew 3.7.4 → 3.8.0

package/dist/tools/tasks/actions/link.js

@@ -0,0 +1,118 @@
+/**
+ * Task link action (link to decisions/constraints/files)
+ */
+import { getAdapter, getOrCreateContextKey, getOrCreateFile } from '../../../database.js';
+import { getProjectContext } from '../../../utils/project-context.js';
+import { FileWatcher } from '../../../watcher/index.js';
+import { validateActionParams } from '../../../utils/parameter-validator.js';
+import { debugLog } from '../../../utils/debug-logger.js';
+import connectionManager from '../../../utils/connection-manager.js';
+/**
+ * Link task to decision/constraint/file
+ */
+export async function linkTask(params, adapter) {
+    validateActionParams('task', 'link', params);
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // Get project context (v3.7.3)
+    const projectId = getProjectContext().getProjectId();
+    if (!params.task_id) {
+        throw new Error('Parameter "task_id" is required');
+    }
+    if (!params.link_type) {
+        throw new Error('Parameter "link_type" is required');
+    }
+    if (params.target_id === undefined || params.target_id === null) {
+        throw new Error('Parameter "target_id" is required');
+    }
+    try {
+        return await connectionManager.executeWithRetry(async () => {
+            return await actualAdapter.transaction(async (trx) => {
+                // Check if task exists
+                const taskExists = await trx('t_tasks').where({ id: params.task_id }).first();
+                if (!taskExists) {
+                    throw new Error(`Task with id ${params.task_id} not found`);
+                }
+                if (params.link_type === 'decision') {
+                    const decisionKey = String(params.target_id);
+                    const keyId = await getOrCreateContextKey(actualAdapter, decisionKey, trx);
+                    const linkRelation = params.link_relation || 'implements';
+                    await trx('t_task_decision_links').insert({
+                        task_id: params.task_id,
+                        decision_key_id: keyId,
+                        link_type: linkRelation
+                    }).onConflict(['task_id', 'decision_key_id']).merge();
+                    return {
+                        success: true,
+                        task_id: params.task_id,
+                        linked_to: 'decision',
+                        target: decisionKey,
+                        relation: linkRelation,
+                        message: `Task ${params.task_id} linked to decision "${decisionKey}"`
+                    };
+                }
+                else if (params.link_type === 'constraint') {
+                    const constraintId = Number(params.target_id);
+                    // Check if constraint exists
+                    const constraintExists = await trx('t_constraints').where({ id: constraintId }).first();
+                    if (!constraintExists) {
+                        throw new Error(`Constraint with id ${constraintId} not found`);
+                    }
+                    await trx('t_task_constraint_links').insert({
+                        task_id: params.task_id,
+                        constraint_id: constraintId
+                    }).onConflict(['task_id', 'constraint_id']).ignore();
+                    return {
+                        success: true,
+                        task_id: params.task_id,
+                        linked_to: 'constraint',
+                        target: constraintId,
+                        message: `Task ${params.task_id} linked to constraint ${constraintId}`
+                    };
+                }
+                else if (params.link_type === 'file') {
+                    // Deprecation warning (v3.4.1)
+                    debugLog('WARN', `DEPRECATION: task.link(link_type="file") is deprecated as of v3.4.1. Use task.create(watch_files=[...]) or task.update(watch_files=[...]) instead. Or use the new watch_files action: { action: "watch_files", task_id: ${params.task_id}, file_paths: ["..."] }`);
+                    const filePath = String(params.target_id);
+                    const fileId = await getOrCreateFile(actualAdapter, projectId, filePath, trx);
+                    await trx('t_task_file_links').insert({
+                        task_id: params.task_id,
+                        file_id: fileId
+                    }).onConflict(['task_id', 'file_id']).ignore();
+                    // Register file with watcher for auto-tracking
+                    try {
+                        const taskData = await trx('t_tasks as t')
+                            .join('m_task_statuses as s', 't.status_id', 's.id')
+                            .where('t.id', params.task_id)
+                            .select('t.title', 's.name as status')
+                            .first();
+                        if (taskData) {
+                            const watcher = FileWatcher.getInstance();
+                            watcher.registerFile(filePath, params.task_id, taskData.title, taskData.status);
+                        }
+                    }
+                    catch (error) {
+                        // Watcher may not be initialized yet, ignore
+                        debugLog('WARN', 'Could not register file with watcher', { error });
+                    }
+                    return {
+                        success: true,
+                        task_id: params.task_id,
+                        linked_to: 'file',
+                        target: filePath,
+                        deprecation_warning: 'task.link(link_type="file") is deprecated. Use task.create/update(watch_files) or watch_files action instead.',
+                        message: `Task ${params.task_id} linked to file "${filePath}" (DEPRECATED API - use watch_files instead)`
+                    };
+                }
+                else {
+                    throw new Error(`Invalid link_type: ${params.link_type}. Must be one of: decision, constraint, file`);
+                }
+            });
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to link task: ${message}`);
+    }
+}
+//# sourceMappingURL=link.js.map

package/dist/tools/tasks/actions/link.js.map

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

package/dist/tools/tasks/actions/list.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Task list action
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+/**
+ * List tasks (token-efficient, no descriptions)
+ */
+export declare function listTasks(params?: {
+    status?: string;
+    assigned_agent?: string;
+    layer?: string;
+    tags?: string[];
+    limit?: number;
+    offset?: number;
+    include_dependency_counts?: boolean;
+}, adapter?: DatabaseAdapter): Promise<any>;
+//# sourceMappingURL=list.d.ts.map

package/dist/tools/tasks/actions/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/actions/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAS7D;;GAEG;AACH,wBAAsB,SAAS,CAAC,MAAM,GAAE;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB,CAAC,EAAE,OAAO,CAAC;CAChC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,CAsG/C"}

package/dist/tools/tasks/actions/list.js

@@ -0,0 +1,98 @@
+/**
+ * Task list action
+ */
+import { getAdapter } from '../../../database.js';
+import { getProjectContext } from '../../../utils/project-context.js';
+import { validateActionParams } from '../../../utils/parameter-validator.js';
+import { validateRange } from '../../../utils/validators.js';
+import { parseStringArray } from '../../../utils/param-parser.js';
+import { detectAndTransitionStaleTasks, autoArchiveOldDoneTasks, detectAndCompleteReviewedTasks, detectAndArchiveOnCommit } from '../../../utils/task-stale-detection.js';
+import { STATUS_TO_ID } from '../types.js';
+/**
+ * List tasks (token-efficient, no descriptions)
+ */
+export async function listTasks(params = {}, adapter) {
+    validateActionParams('task', 'list', params);
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // Get current project ID for filtering (Constraint #22)
+    const projectId = getProjectContext().getProjectId();
+    try {
+        // Run auto-stale detection, git-aware completion, and auto-archive before listing
+        const transitionCount = await detectAndTransitionStaleTasks(actualAdapter);
+        const gitCompletedCount = await detectAndCompleteReviewedTasks(actualAdapter);
+        const gitArchivedCount = await detectAndArchiveOnCommit(actualAdapter);
+        const archiveCount = await autoArchiveOldDoneTasks(actualAdapter);
+        // Build query with optional dependency counts
+        let query;
+        if (params.include_dependency_counts) {
+            // Include dependency counts with LEFT JOINs
+            const blockersCTE = knex('t_task_dependencies')
+                .select('blocked_task_id')
+                .count('* as blocked_by_count')
+                .groupBy('blocked_task_id')
+                .as('blockers');
+            const blockingCTE = knex('t_task_dependencies')
+                .select('blocker_task_id')
+                .count('* as blocking_count')
+                .groupBy('blocker_task_id')
+                .as('blocking');
+            query = knex('v_task_board as vt')
+                .leftJoin(blockersCTE, 'vt.id', 'blockers.blocked_task_id')
+                .leftJoin(blockingCTE, 'vt.id', 'blocking.blocker_task_id')
+                .select('vt.*', knex.raw('COALESCE(blockers.blocked_by_count, 0) as blocked_by_count'), knex.raw('COALESCE(blocking.blocking_count, 0) as blocking_count'));
+        }
+        else {
+            // Standard query without dependency counts
+            query = knex('v_task_board');
+        }
+        // Filter by project_id (Constraint #22: Multi-project isolation)
+        query = query.where(params.include_dependency_counts ? 'vt.project_id' : 'project_id', projectId);
+        // Filter by status
+        if (params.status) {
+            if (!STATUS_TO_ID[params.status]) {
+                throw new Error(`Invalid status: ${params.status}. Must be one of: todo, in_progress, waiting_review, blocked, done, archived`);
+            }
+            query = query.where(params.include_dependency_counts ? 'vt.status' : 'status', params.status);
+        }
+        // Filter by assigned agent
+        if (params.assigned_agent) {
+            query = query.where(params.include_dependency_counts ? 'vt.assigned_to' : 'assigned_to', params.assigned_agent);
+        }
+        // Filter by layer
+        if (params.layer) {
+            query = query.where(params.include_dependency_counts ? 'vt.layer' : 'layer', params.layer);
+        }
+        // Filter by tags
+        if (params.tags && params.tags.length > 0) {
+            // Parse tags (handles both arrays and JSON strings from MCP)
+            const tags = parseStringArray(params.tags);
+            for (const tag of tags) {
+                query = query.where(params.include_dependency_counts ? 'vt.tags' : 'tags', 'like', `%${tag}%`);
+            }
+        }
+        // Order by updated timestamp (most recent first)
+        query = query.orderBy(params.include_dependency_counts ? 'vt.updated_ts' : 'updated_ts', 'desc');
+        // Pagination
+        const limit = params.limit !== undefined ? params.limit : 50;
+        const offset = params.offset || 0;
+        validateRange(limit, 'Parameter "limit"', 0, 100);
+        validateRange(offset, 'Parameter "offset"', 0, Number.MAX_SAFE_INTEGER);
+        query = query.limit(limit).offset(offset);
+        // Execute query
+        const rows = await query;
+        return {
+            tasks: rows,
+            count: rows.length,
+            stale_tasks_transitioned: transitionCount,
+            git_auto_completed: gitCompletedCount,
+            git_archived: gitArchivedCount,
+            archived_tasks: archiveCount
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to list tasks: ${message}`);
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/tools/tasks/actions/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/tools/tasks/actions/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,6BAA6B,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAC1K,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAQ5B,EAAE,EAAE,OAAyB;IAC/B,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7C,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;IAErC,wDAAwD;IACxD,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC,YAAY,EAAE,CAAC;IAErD,IAAI,CAAC;QACH,kFAAkF;QAClF,MAAM,eAAe,GAAG,MAAM,6BAA6B,CAAC,aAAa,CAAC,CAAC;QAC3E,MAAM,iBAAiB,GAAG,MAAM,8BAA8B,CAAC,aAAa,CAAC,CAAC;QAC9E,MAAM,gBAAgB,GAAG,MAAM,wBAAwB,CAAC,aAAa,CAAC,CAAC;QACvE,MAAM,YAAY,GAAG,MAAM,uBAAuB,CAAC,aAAa,CAAC,CAAC;QAElE,8CAA8C;QAC9C,IAAI,KAAK,CAAC;QACV,IAAI,MAAM,CAAC,yBAAyB,EAAE,CAAC;YACrC,4CAA4C;YAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,CAAC;iBAC5C,MAAM,CAAC,iBAAiB,CAAC;iBACzB,KAAK,CAAC,uBAAuB,CAAC;iBAC9B,OAAO,CAAC,iBAAiB,CAAC;iBAC1B,EAAE,CAAC,UAAU,CAAC,CAAC;YAElB,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,CAAC;iBAC5C,MAAM,CAAC,iBAAiB,CAAC;iBACzB,KAAK,CAAC,qBAAqB,CAAC;iBAC5B,OAAO,CAAC,iBAAiB,CAAC;iBAC1B,EAAE,CAAC,UAAU,CAAC,CAAC;YAElB,KAAK,GAAG,IAAI,CAAC,oBAAoB,CAAC;iBAC/B,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,0BAA0B,CAAC;iBAC1D,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,0BAA0B,CAAC;iBAC1D,MAAM,CACL,MAAM,EACN,IAAI,CAAC,GAAG,CAAC,4DAA4D,CAAC,EACtE,IAAI,CAAC,GAAG,CAAC,wDAAwD,CAAC,CACnE,CAAC;QACN,CAAC;aAAM,CAAC;YACN,2CAA2C;YAC3C,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/B,CAAC;QAED,iEAAiE;QACjE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QAElG,mBAAmB;QACnB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,MAAM,8EAA8E,CAAC,CAAC;YAClI,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAChG,CAAC;QAED,2BAA2B;QAC3B,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC1B,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;QAClH,CAAC;QAED,kBAAkB;QAClB,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7F,CAAC;QAED,iBAAiB;QACjB,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,6DAA6D;YAC7D,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;YACjG,CAAC;QACH,CAAC;QAED,iDAAiD;QACjD,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAEjG,aAAa;QACb,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAElC,aAAa,CAAC,KAAK,EAAE,mBAAmB,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAClD,aAAa,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAExE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE1C,gBAAgB;QAChB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC;QAEzB,OAAO;YACL,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,wBAAwB,EAAE,eAAe;YACzC,kBAAkB,EAAE,iBAAiB;YACrC,YAAY,EAAE,gBAAgB;YAC9B,cAAc,EAAE,YAAY;SAC7B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/tools/tasks/actions/move.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Task move action (status transitions)
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+/**
+ * Move task to different status
+ */
+export declare function moveTask(params: {
+    task_id: number;
+    new_status: string;
+}, adapter?: DatabaseAdapter): Promise<any>;
+//# sourceMappingURL=move.d.ts.map

package/dist/tools/tasks/actions/move.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/actions/move.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAU7D;;GAEG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,CAyF1C"}

package/dist/tools/tasks/actions/move.js

@@ -0,0 +1,91 @@
+/**
+ * Task move action (status transitions)
+ */
+import { getAdapter } from '../../../database.js';
+import { FileWatcher } from '../../../watcher/index.js';
+import { validateActionParams } from '../../../utils/parameter-validator.js';
+import connectionManager from '../../../utils/connection-manager.js';
+import { logTaskStatusChange } from '../../../utils/activity-logging.js';
+import { detectAndTransitionStaleTasks, autoArchiveOldDoneTasks } from '../../../utils/task-stale-detection.js';
+import { TASK_STATUS } from '../types.js';
+import { validateStatusTransition, getStatusId, getStatusName } from '../internal/state-machine.js';
+/**
+ * Move task to different status
+ */
+export async function moveTask(params, adapter) {
+    validateActionParams('task', 'move', params);
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    if (!params.task_id) {
+        throw new Error('Parameter "task_id" is required');
+    }
+    if (!params.new_status) {
+        throw new Error('Parameter "new_status" is required');
+    }
+    try {
+        // Run auto-stale detection and auto-archive before move
+        await detectAndTransitionStaleTasks(actualAdapter);
+        await autoArchiveOldDoneTasks(actualAdapter);
+        return await connectionManager.executeWithRetry(async () => {
+            return await actualAdapter.transaction(async (trx) => {
+                // Get current status
+                const taskRow = await trx('t_tasks')
+                    .where({ id: params.task_id })
+                    .select('status_id')
+                    .first();
+                if (!taskRow) {
+                    throw new Error(`Task with id ${params.task_id} not found`);
+                }
+                const currentStatusId = taskRow.status_id;
+                const newStatusId = getStatusId(params.new_status);
+                // Validate transition
+                validateStatusTransition(currentStatusId, params.new_status);
+                // Update status
+                const updateData = {
+                    status_id: newStatusId
+                };
+                // Set completed_ts when moving to done
+                if (newStatusId === TASK_STATUS.DONE) {
+                    updateData.completed_ts = Math.floor(Date.now() / 1000);
+                }
+                await trx('t_tasks')
+                    .where({ id: params.task_id })
+                    .update(updateData);
+                // Activity logging (replaces trigger)
+                const systemAgentId = 1;
+                await logTaskStatusChange(trx, {
+                    task_id: params.task_id,
+                    old_status: currentStatusId,
+                    new_status: newStatusId,
+                    agent_id: systemAgentId
+                });
+                // Update watcher if moving to done or archived (stop watching)
+                if (params.new_status === 'done' || params.new_status === 'archived') {
+                    try {
+                        const watcher = FileWatcher.getInstance();
+                        watcher.unregisterTask(params.task_id);
+                    }
+                    catch (error) {
+                        // Watcher may not be initialized, ignore
+                    }
+                }
+                return {
+                    success: true,
+                    task_id: params.task_id,
+                    old_status: getStatusName(currentStatusId),
+                    new_status: params.new_status,
+                    message: `Task ${params.task_id} moved from ${getStatusName(currentStatusId)} to ${params.new_status}`
+                };
+            });
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        // Preserve validation errors (they already contain helpful information)
+        if (message.startsWith('{') && message.includes('"error"')) {
+            throw error;
+        }
+        throw new Error(`Failed to move task: ${message}`);
+    }
+}
+//# sourceMappingURL=move.js.map

package/dist/tools/tasks/actions/move.js.map

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

package/dist/tools/tasks/actions/remove-dependency.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Task remove dependency action
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+/**
+ * Remove dependency between tasks
+ */
+export declare function removeDependency(params: {
+    blocker_task_id: number;
+    blocked_task_id: number;
+}, adapter?: DatabaseAdapter): Promise<any>;
+//# sourceMappingURL=remove-dependency.d.ts.map

package/dist/tools/tasks/actions/remove-dependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-dependency.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/actions/remove-dependency.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAI7D;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,CA8B1C"}

package/dist/tools/tasks/actions/remove-dependency.js

@@ -0,0 +1,36 @@
+/**
+ * Task remove dependency action
+ */
+import { getAdapter } from '../../../database.js';
+import { validateActionParams } from '../../../utils/parameter-validator.js';
+/**
+ * Remove dependency between tasks
+ */
+export async function removeDependency(params, adapter) {
+    validateActionParams('task', 'remove_dependency', params);
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    if (!params.blocker_task_id) {
+        throw new Error('Parameter "blocker_task_id" is required');
+    }
+    if (!params.blocked_task_id) {
+        throw new Error('Parameter "blocked_task_id" is required');
+    }
+    try {
+        await knex('t_task_dependencies')
+            .where({
+            blocker_task_id: params.blocker_task_id,
+            blocked_task_id: params.blocked_task_id
+        })
+            .delete();
+        return {
+            success: true,
+            message: `Dependency removed: Task #${params.blocker_task_id} no longer blocks Task #${params.blocked_task_id}`
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to remove dependency: ${message}`);
+    }
+}
+//# sourceMappingURL=remove-dependency.js.map

package/dist/tools/tasks/actions/remove-dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-dependency.js","sourceRoot":"","sources":["../../../../src/tools/tasks/actions/remove-dependency.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAGtC,EAAE,OAAyB;IAC1B,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAE1D,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;IAErC,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,qBAAqB,CAAC;aAC9B,KAAK,CAAC;YACL,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,eAAe,EAAE,MAAM,CAAC,eAAe;SACxC,CAAC;aACD,MAAM,EAAE,CAAC;QAEZ,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,6BAA6B,MAAM,CAAC,eAAe,2BAA2B,MAAM,CAAC,eAAe,EAAE;SAChH,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC"}

package/dist/tools/tasks/actions/update.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Task update action
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import { TaskUpdateParams } from '../types.js';
+/**
+ * Update task metadata
+ */
+export declare function updateTask(params: TaskUpdateParams, adapter?: DatabaseAdapter): Promise<any>;
+//# sourceMappingURL=update.d.ts.map

package/dist/tools/tasks/actions/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/actions/update.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAO7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,CAoMlG"}

package/dist/tools/tasks/actions/update.js

@@ -0,0 +1,186 @@
+/**
+ * Task update action
+ */
+import { getAdapter, getOrCreateAgent, getLayerId, getOrCreateFile } from '../../../database.js';
+import { getProjectContext } from '../../../utils/project-context.js';
+import { FileWatcher } from '../../../watcher/index.js';
+import { validateActionParams } from '../../../utils/parameter-validator.js';
+import { debugLog } from '../../../utils/debug-logger.js';
+import connectionManager from '../../../utils/connection-manager.js';
+import { validateTaskUpdateParams, parseArrayParam, processAcceptanceCriteria, validateFileActions, convertWatchFilesToFileActions } from '../internal/validation.js';
+/**
+ * Update task metadata
+ */
+export async function updateTask(params, adapter) {
+    validateActionParams('task', 'update', params);
+    const actualAdapter = adapter ?? getAdapter();
+    // Validate parameters
+    validateTaskUpdateParams(params);
+    // Fail-fast project_id validation (Constraint #29)
+    const projectId = getProjectContext().getProjectId();
+    try {
+        return await connectionManager.executeWithRetry(async () => {
+            return await actualAdapter.transaction(async (trx) => {
+                const knex = actualAdapter.getKnex();
+                // Check if task exists with project_id isolation
+                const taskExists = await trx('t_tasks')
+                    .where({ id: params.task_id, project_id: projectId })
+                    .first();
+                if (!taskExists) {
+                    throw new Error(`Task with id ${params.task_id} not found`);
+                }
+                // Build update data dynamically
+                const updateData = {};
+                if (params.title !== undefined) {
+                    updateData.title = params.title;
+                }
+                if (params.priority !== undefined) {
+                    updateData.priority = params.priority;
+                }
+                if (params.assigned_agent !== undefined) {
+                    const agentId = await getOrCreateAgent(actualAdapter, params.assigned_agent, trx);
+                    updateData.assigned_agent_id = agentId;
+                }
+                if (params.layer !== undefined) {
+                    const layerId = await getLayerId(actualAdapter, params.layer, trx);
+                    if (layerId === null) {
+                        throw new Error(`Invalid layer: '${params.layer}'. Must be one of 9 layers (v3.8.0):\n` +
+                            `\n` +
+                            `FILE_REQUIRED (6): presentation, business, data, infrastructure, cross-cutting, documentation\n` +
+                            `  → Must provide file_actions parameter (or [] for non-file tasks)\n` +
+                            `  → Documentation IS files (README, CHANGELOG, docs/)\n` +
+                            `\n` +
+                            `FILE_OPTIONAL (3): planning, coordination, review\n` +
+                            `  → file_actions parameter is optional\n` +
+                            `  → Planning: research, surveys, investigation\n` +
+                            `  → Coordination: multi-agent orchestration\n` +
+                            `  → Review: code review, verification\n` +
+                            `\n` +
+                            `Example: { layer: 'business', file_actions: [{ action: 'edit', path: 'src/model/user.ts' }] }`);
+                    }
+                    updateData.layer_id = layerId;
+                }
+                // Update t_tasks if any updates (with project_id isolation)
+                if (Object.keys(updateData).length > 0) {
+                    await trx('t_tasks')
+                        .where({ id: params.task_id, project_id: projectId })
+                        .update(updateData);
+                }
+                // Update t_task_details if any detail fields provided
+                if (params.description !== undefined || params.acceptance_criteria !== undefined || params.notes !== undefined) {
+                    // Process acceptance_criteria (can be string or array)
+                    let acceptanceCriteriaString = undefined;
+                    let acceptanceCriteriaJson = undefined;
+                    if (params.acceptance_criteria !== undefined) {
+                        const processed = processAcceptanceCriteria(params.acceptance_criteria);
+                        acceptanceCriteriaString = processed.acceptanceCriteriaString;
+                        acceptanceCriteriaJson = processed.acceptanceCriteriaJson;
+                    }
+                    // Check if details exist (with project_id isolation)
+                    const detailsExist = await trx('t_task_details')
+                        .where({ task_id: params.task_id, project_id: projectId })
+                        .first();
+                    const detailsUpdate = {};
+                    if (params.description !== undefined) {
+                        detailsUpdate.description = params.description || null;
+                    }
+                    if (acceptanceCriteriaString !== undefined) {
+                        detailsUpdate.acceptance_criteria = acceptanceCriteriaString;
+                    }
+                    if (acceptanceCriteriaJson !== undefined) {
+                        detailsUpdate.acceptance_criteria_json = acceptanceCriteriaJson;
+                    }
+                    if (params.notes !== undefined) {
+                        detailsUpdate.notes = params.notes || null;
+                    }
+                    if (detailsExist && Object.keys(detailsUpdate).length > 0) {
+                        // Update existing details (with project_id isolation)
+                        await trx('t_task_details')
+                            .where({ task_id: params.task_id, project_id: projectId })
+                            .update(detailsUpdate);
+                    }
+                    else if (!detailsExist) {
+                        // Insert new details
+                        await trx('t_task_details').insert({
+                            project_id: projectId,
+                            task_id: params.task_id,
+                            description: params.description || null,
+                            acceptance_criteria: acceptanceCriteriaString !== undefined ? acceptanceCriteriaString : null,
+                            acceptance_criteria_json: acceptanceCriteriaJson !== undefined ? acceptanceCriteriaJson : null,
+                            notes: params.notes || null
+                        });
+                    }
+                }
+                // Handle backward compatibility: convert watch_files to file_actions (v3.8.0)
+                let file_actions = params.file_actions;
+                // Parse file_actions if it's a string (MCP SDK may send JSON as string)
+                if (file_actions && typeof file_actions === 'string') {
+                    try {
+                        file_actions = JSON.parse(file_actions);
+                    }
+                    catch (error) {
+                        throw new Error('Invalid file_actions format. Expected JSON array of {action, path} objects.');
+                    }
+                }
+                // Backward compatibility: convert watch_files to file_actions
+                if (!file_actions && params.watch_files) {
+                    const watchFilesParsed = parseArrayParam(params.watch_files, 'watch_files');
+                    file_actions = convertWatchFilesToFileActions(watchFilesParsed);
+                }
+                // Validate file_actions is an array if provided
+                if (file_actions !== undefined && !Array.isArray(file_actions)) {
+                    throw new Error('file_actions must be an array of {action, path} objects');
+                }
+                // Validate file_actions based on layer if both are provided (v3.8.0)
+                if (params.layer && file_actions) {
+                    validateFileActions(params.layer, file_actions);
+                }
+                // Handle file_actions if provided (v3.8.0)
+                // Also supports legacy watch_files via auto-conversion above
+                if (file_actions && file_actions.length > 0) {
+                    for (const fileAction of file_actions) {
+                        const fileId = await getOrCreateFile(actualAdapter, projectId, fileAction.path, trx);
+                        await trx('t_task_file_links').insert({
+                            project_id: projectId,
+                            task_id: params.task_id,
+                            file_id: fileId,
+                            linked_ts: Math.floor(Date.now() / 1000)
+                        }).onConflict(['project_id', 'task_id', 'file_id']).ignore();
+                    }
+                    // Register files with watcher for auto-tracking
+                    try {
+                        const taskData = await trx('t_tasks as t')
+                            .join('m_task_statuses as s', 't.status_id', 's.id')
+                            .where({ 't.id': params.task_id, 't.project_id': projectId })
+                            .select('t.title', 's.name as status')
+                            .first();
+                        if (taskData) {
+                            const watcher = FileWatcher.getInstance();
+                            for (const fileAction of file_actions) {
+                                watcher.registerFile(fileAction.path, params.task_id, taskData.title, taskData.status);
+                            }
+                        }
+                    }
+                    catch (error) {
+                        // Watcher may not be initialized yet, ignore
+                        debugLog('WARN', 'Could not register files with watcher', { error });
+                    }
+                }
+                return {
+                    success: true,
+                    task_id: params.task_id,
+                    message: `Task ${params.task_id} updated successfully`
+                };
+            });
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        // Preserve validation errors (they already contain helpful information)
+        if (message.startsWith('{') && message.includes('"error"')) {
+            throw error;
+        }
+        throw new Error(`Failed to update task: ${message}`);
+    }
+}
+//# sourceMappingURL=update.js.map