@taskforcehq/taskforce 0.3.170 → 0.3.301

package/dist/mcp/structuredCommentValidation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/{__tests__ → mcp}/structuredCommentValidation.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { validateStructuredCommentForAdd } from '../mcp/structuredCommentValidation';
+import { validateStructuredCommentForAdd } from './structuredCommentValidation';
 describe('structured comment add validation', () => {
     it('passes ordinary comments', () => {
         const result = validateStructuredCommentForAdd('LGTM. Proceeding with implementation.');

package/dist/mcp/structuredDocValidation.js

@@ -58,8 +58,7 @@ const RULES = [
 export function validateStructuredDocForAttach(relativePath, content) {
     const normalizedPath = relativePath.split(path.sep).join('/');
     const isLegacyDocPath = normalizedPath.startsWith('.taskforce/docs/');
-    const isTaskDataPath = normalizedPath.startsWith('.taskforce/task-data/');
-    if (!isLegacyDocPath && !isTaskDataPath)
+    if (!isLegacyDocPath)
         return { ok: true };
     const rule = RULES.find((r) => normalizedPath.includes(r.dirSegment) &&
         r.filenameSuffixes.some((suffix) => normalizedPath.endsWith(suffix)));

package/dist/mcp/structuredDocValidation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/{__tests__ → mcp}/structuredDocValidation.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { validateStructuredDocForAttach } from '../mcp/structuredDocValidation';
+import { validateStructuredDocForAttach } from './structuredDocValidation';
 describe('structured doc attach validation', () => {
     it('passes non-structured paths', () => {
         const result = validateStructuredDocForAttach('notes/random.md', '# anything');
@@ -15,12 +15,17 @@ describe('structured doc attach validation', () => {
             '### Key Tradeoffs',
             '### Next Step'
         ].join('\n');
-        const result = validateStructuredDocForAttach('.taskforce/task-data/task-1/evaluations/evaluation.md', content);
+        const result = validateStructuredDocForAttach('.taskforce/docs/evaluations/evaluation.md', content);
         expect(result).toEqual({ ok: true });
     });
-    it('fails review docs missing required headings', () => {
+    it('passes generic workspace review attachments without strict heading enforcement', () => {
         const content = ['## Review Verdict', '### Findings'].join('\n');
-        const result = validateStructuredDocForAttach('.taskforce/task-data/task-1/reviews/review.md', content);
+        const result = validateStructuredDocForAttach('.taskforce/workspaces/workspace-1/assets/documents/review.md', content);
+        expect(result).toEqual({ ok: true });
+    });
+    it('fails legacy review docs missing required headings', () => {
+        const content = ['## Review Verdict', '### Findings'].join('\n');
+        const result = validateStructuredDocForAttach('.taskforce/docs/reviews/review.md', content);
         expect(result.ok).toBe(false);
         if (!result.ok) {
             expect(result.message).toContain('### Verdict (PASS | WARN | FAIL)');

package/dist/mcp/toolRegistry.d.ts

@@ -0,0 +1,570 @@
+import type { McpAccessTokenScope } from '../core/Taskforce.js';
+export type McpPermission = {
+    kind: 'public';
+} | {
+    kind: 'scope';
+    scope: McpAccessTokenScope;
+} | {
+    kind: 'local-only';
+} | {
+    kind: 'session-only';
+};
+export declare const MCP_TOOL_REGISTRY: Readonly<{
+    readonly list_assignees: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "workspace:read";
+        };
+        readonly mutating: false;
+    };
+    readonly get_current_profile: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "workspace:read";
+        };
+        readonly mutating: false;
+    };
+    readonly list_tasks: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly search_tasks: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly get_task: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly list_initiatives: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly get_initiative: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly create_initiative: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly update_initiative: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly archive_initiative: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly unarchive_initiative: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly list_workstreams: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly get_workstream: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly create_workstream: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly update_workstream: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly archive_workstream: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly unarchive_workstream: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly set_task_workstream: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly clear_task_workstream: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly set_workstream_initiative: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly clear_workstream_initiative: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly get_task_checklist: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly replace_task_checklist: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly get_task_attachments: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly read_task_attachment: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly search_images: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly get_image: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly search_documents: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly get_document: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly read_document_content: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly get_annotated_attachment_sessions: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly read_annotated_attachment_payload: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly create_annotated_attachment_session: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly update_annotated_attachment_session: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly delete_annotated_attachment_session: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly review_image: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly add_annotated_attachment_marker: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly bulk_add_annotated_attachment_markers: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly update_annotated_attachment_marker: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly reorder_annotated_attachment_marker: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly delete_annotated_attachment_marker: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly get_document_review_sessions: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly get_document_review_session: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly create_document_review_session: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly update_document_review_session: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly review_document: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly add_document_review_comment: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly update_document_review_comment: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly delete_document_review_comment: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly get_schedule_board: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly schedule_task: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly unschedule_task: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly reorder_scheduled_tasks: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly bulk_carryover: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly set_schedule_preferences: {
+        readonly permission: {
+            readonly kind: "session-only";
+        };
+        readonly mutating: true;
+    };
+    readonly resolve_profile: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly create_task: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly start_task: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly update_task: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly finish_task: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly assign_task: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly bulk_assign_tasks: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly archive_task: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly add_comment: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly link_task_context: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly save_task_attachment: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly delete_task_attachment: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly list_archive: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+    readonly unarchive_task: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly bulk_archive: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly get_config: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "workspace:read";
+        };
+        readonly mutating: false;
+    };
+    readonly update_categories: {
+        readonly permission: {
+            readonly kind: "session-only";
+        };
+        readonly mutating: true;
+    };
+    readonly update_types: {
+        readonly permission: {
+            readonly kind: "session-only";
+        };
+        readonly mutating: true;
+    };
+    readonly bulk_update_type: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly bulk_update_fields: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:write";
+        };
+        readonly mutating: true;
+    };
+    readonly export_resources: {
+        readonly permission: {
+            readonly kind: "local-only";
+        };
+        readonly mutating: true;
+    };
+    readonly get_paths: {
+        readonly permission: {
+            readonly kind: "local-only";
+        };
+        readonly mutating: false;
+    };
+    readonly update_priorities: {
+        readonly permission: {
+            readonly kind: "session-only";
+        };
+        readonly mutating: true;
+    };
+    readonly update_approaches: {
+        readonly permission: {
+            readonly kind: "session-only";
+        };
+        readonly mutating: true;
+    };
+    readonly get_stats: {
+        readonly permission: {
+            readonly kind: "scope";
+            readonly scope: "tasks:read";
+        };
+        readonly mutating: false;
+    };
+}>;
+export type McpToolName = keyof typeof MCP_TOOL_REGISTRY;
+export declare const MCP_TOOL_PERMISSIONS: Record<McpToolName, McpPermission>;
+export declare const MCP_WRITE_TOOL_NAMES: Set<string>;
+export declare const MCP_CLOUD_TOOL_SCOPE_REQUIREMENTS: Record<string, McpAccessTokenScope>;