@taskforcehq/taskforce 0.3.170 → 0.3.301

package/dist/resources/templates/workflows/plan.yaml

@@ -18,8 +18,10 @@ compat:
   requiredToolsOptional:
     - "{{MCP_PREFIX}}list_tasks"
     - "{{MCP_PREFIX}}search_tasks"
+    - "{{MCP_PREFIX}}get_task_attachments"
+    - "{{MCP_PREFIX}}read_task_attachment"
     - "{{MCP_PREFIX}}get_config"
-    - "{{MCP_PREFIX}}attach_context_file"
+    - "{{MCP_PREFIX}}link_task_context"
     - "{{MCP_PREFIX}}save_task_attachment"
 toolPolicy:
   requiredToolsPolicy:
@@ -37,12 +39,12 @@ toolPolicy:
       - on-hold
       - in-progress
       - review
-    forbiddenStatuses:
       - done
+    forbiddenStatuses:
       - cancelled
 artifacts:
   implementationPlan:
-    path: .taskforce/task-data/{taskId}/attachments/implementation-plan.md
+    path: task attachment "implementation-plan.md"
     required: false
     savePolicy: ask-before-save
 contextPolicy:
@@ -50,6 +52,8 @@ contextPolicy:
     - mcp
   mcp:
     knownTaskIdTool: "{{MCP_PREFIX}}get_task"
+    taskAttachmentListTool: "{{MCP_PREFIX}}get_task_attachments"
+    taskAttachmentReadTool: "{{MCP_PREFIX}}read_task_attachment"
     unknownTaskIdTools:
       - "{{MCP_PREFIX}}list_tasks"
       - "{{MCP_PREFIX}}search_tasks"
@@ -69,6 +73,8 @@ content:
     > 1. **MCP-first load**:
     >    - If task ID is known, call `{{MCP_PREFIX}}get_task`.
     >    - If task ID is unknown, use `{{MCP_PREFIX}}list_tasks` / `{{MCP_PREFIX}}search_tasks` to identify it.
+    >    - If task attachments may matter, call `{{MCP_PREFIX}}get_task_attachments` and then `{{MCP_PREFIX}}read_task_attachment` for the specific files you need.
+    >    - Do not try to open task attachment HTTP paths directly when MCP attachment-read tools are available.
     >    - If MCP is unavailable, stop and request user action.
     > 2. Print `prompts.startupChecklist`.
 
@@ -77,6 +83,7 @@ content:
     ## 1. Startup (Mandatory)
 
     1. Call `{{MCP_PREFIX}}get_config` before setting category/type/priority/approach/status/complexity.
+       - Treat `{{MCP_PREFIX}}get_config` as the source of truth for taxonomy and enum values; do not rely on remembered type/category names.
     2. Set status to `in-progress` via `{{MCP_PREFIX}}update_task`.
     3. Load specialist instructions for the active environment and acknowledge constraints.
     4. Load all relevant context sources tied to the task.
@@ -86,9 +93,9 @@ content:
     ## 2. Planning Deliverable
 
     0. Choose and record task management mode for follow-on execution:
-       - `checklist_mode` (single parent + in-task checklist) for linear short work.
-       - `decompose_mode` (child tasks) only when dependencies/parallelism/risk tracking justify decomposition.
-       - Record owner strategy: `user`, `agent`, or `mixed`.
+       - `checklist_mode` (single task + in-task checklist) for linear short work.
+       - `planning_mode` (multiple tasks/workstreams/initiatives) only when dependencies, parallelism, or risk tracking justify decomposition.
+       - Record owner strategy as explicit assignee IDs, `unassigned`, or a mixed plan with explicit IDs.
 
     1. Define file-level change plan (exact files and intended changes).
     2. Identify compatibility and regression risks.
@@ -106,7 +113,7 @@ content:
        - `### Next Action`
     6. Ask whether to save as `{artifacts.implementationPlan.path}`.
     7. If user confirms, persist task-specific content via `{{MCP_PREFIX}}save_task_attachment` using `filename: "implementation-plan.md"`.
-       - Use `{{MCP_PREFIX}}attach_context_file` only for linking existing files/URLs (for example, shared docs under `docs/`).
+       - Use `{{MCP_PREFIX}}link_task_context` only for linking existing files/URLs (for example, shared docs under `docs/`).
     8. If setting status to `task` or `on-hold`, add explicit comment justification using `{{MCP_PREFIX}}add_comment`.
-    9. Never set `done` or `cancelled`, and never call `{{MCP_PREFIX}}archive_task`, unless explicitly instructed by the user.
+    9. Never set `cancelled`, and never call `{{MCP_PREFIX}}archive_task`, unless explicitly instructed by the user.
     10. Print `prompts.handoffPrompt` and stop.

package/dist/resources/templates/workflows/review.yaml

@@ -17,8 +17,10 @@ compat:
   requiredToolsOptional:
     - "{{MCP_PREFIX}}list_tasks"
     - "{{MCP_PREFIX}}search_tasks"
+    - "{{MCP_PREFIX}}get_task_attachments"
+    - "{{MCP_PREFIX}}read_task_attachment"
     - "{{MCP_PREFIX}}update_task"
-    - "{{MCP_PREFIX}}attach_context_file"
+    - "{{MCP_PREFIX}}link_task_context"
     - "{{MCP_PREFIX}}save_task_attachment"
 toolPolicy:
   requiredToolsPolicy:
@@ -35,12 +37,12 @@ toolPolicy:
       - on-hold
       - in-progress
       - review
-    forbiddenStatuses:
       - done
+    forbiddenStatuses:
       - cancelled
 artifacts:
   reviewReport:
-    path: .taskforce/task-data/{taskId}/attachments/review.md
+    path: task attachment "review.md"
     required: false
     savePolicy: ask-before-save
 contextPolicy:
@@ -48,6 +50,8 @@ contextPolicy:
     - mcp
   mcp:
     knownTaskIdTool: "{{MCP_PREFIX}}get_task"
+    taskAttachmentListTool: "{{MCP_PREFIX}}get_task_attachments"
+    taskAttachmentReadTool: "{{MCP_PREFIX}}read_task_attachment"
     unknownTaskIdTools:
       - "{{MCP_PREFIX}}list_tasks"
       - "{{MCP_PREFIX}}search_tasks"
@@ -66,6 +70,8 @@ content:
     > 1. **MCP-first load**:
     >    - If task ID is known, call `{{MCP_PREFIX}}get_task`.
     >    - If task ID is unknown, use `{{MCP_PREFIX}}list_tasks` / `{{MCP_PREFIX}}search_tasks` to identify it.
+    >    - If task attachments may matter, call `{{MCP_PREFIX}}get_task_attachments` and then `{{MCP_PREFIX}}read_task_attachment` for the specific files you need.
+    >    - Do not try to open task attachment HTTP paths directly when MCP attachment-read tools are available.
     >    - If MCP is unavailable, stop and request user action.
     > 2. Print `prompts.startupChecklist`.
 
@@ -96,14 +102,14 @@ content:
        - `### Next Status`
     3. Ask whether to save as `{artifacts.reviewReport.path}`.
     4. If user confirms, persist task-specific content via `{{MCP_PREFIX}}save_task_attachment` using `filename: "review.md"`.
-       - Use `{{MCP_PREFIX}}attach_context_file` only for linking existing files/URLs (for example, shared docs under `docs/`).
-    5. Keep status within allowed statuses (`task`, `on-hold`, `in-progress`, `review`) unless user explicitly instructs otherwise.
+       - Use `{{MCP_PREFIX}}link_task_context` only for linking existing files/URLs (for example, shared docs under `docs/`).
+    5. Keep status within allowed statuses (`task`, `on-hold`, `in-progress`, `review`, `done`) unless user explicitly instructs otherwise.
        - If setting status to `task` or `on-hold`, add explicit comment justification using `{{MCP_PREFIX}}add_comment`.
-    6. Never set `done` or `cancelled`, and never call `{{MCP_PREFIX}}archive_task`, unless explicitly instructed by the user.
+    6. Never set `cancelled`, and never call `{{MCP_PREFIX}}archive_task`, unless explicitly instructed by the user.
 
     ## 3. Optional Report Artifact
 
     1. Use report files only when user opts in.
-    2. Save to `.taskforce/task-data/{taskId}/attachments/review.md` and attach to task context when approved.
-       - If the document is not task-specific, store it under `docs/` and optionally link it with `{{MCP_PREFIX}}attach_context_file`.
+    2. Save to `task attachment "review.md"` and attach to task context when approved.
+       - If the document is not task-specific, store it under `docs/` and optionally link it with `{{MCP_PREFIX}}link_task_context`.
     3. Stop.

package/dist/runtime/appGateDefinitions.d.ts

@@ -0,0 +1,32 @@
+export declare const APP_GATE_DEFINITIONS: {
+    readonly 'annotated_attachments.workspace_access': {
+        readonly enabled: true;
+        readonly description: "Annotated Attachment workspace readiness gate.";
+        readonly owner: "taskforce";
+        readonly removalMilestone: "Annotated Attachment GA";
+    };
+    readonly 'documents.workspace_access': {
+        readonly enabled: true;
+        readonly description: "Document Manager/editor workspace readiness gate.";
+        readonly owner: "taskforce";
+        readonly removalMilestone: "Document Manager GA";
+    };
+    readonly 'workflows.workspace_access': {
+        readonly enabled: true;
+        readonly description: "Workflow workspace readiness gate.";
+        readonly owner: "taskforce";
+        readonly removalMilestone: "Workflow workspace GA";
+    };
+    readonly 'agents.workspace_access': {
+        readonly enabled: true;
+        readonly description: "Agents workspace readiness gate.";
+        readonly owner: "taskforce";
+        readonly removalMilestone: "Agents workspace GA";
+    };
+    readonly 'initiatives.workspace_access': {
+        readonly enabled: true;
+        readonly description: "Initiatives workspace readiness gate.";
+        readonly owner: "taskforce";
+        readonly removalMilestone: "Initiatives workspace GA";
+    };
+};

package/dist/runtime/appGateDefinitions.js

@@ -0,0 +1,32 @@
+export const APP_GATE_DEFINITIONS = {
+    'annotated_attachments.workspace_access': {
+        enabled: true,
+        description: 'Annotated Attachment workspace readiness gate.',
+        owner: 'taskforce',
+        removalMilestone: 'Annotated Attachment GA'
+    },
+    'documents.workspace_access': {
+        enabled: true,
+        description: 'Document Manager/editor workspace readiness gate.',
+        owner: 'taskforce',
+        removalMilestone: 'Document Manager GA'
+    },
+    'workflows.workspace_access': {
+        enabled: true,
+        description: 'Workflow workspace readiness gate.',
+        owner: 'taskforce',
+        removalMilestone: 'Workflow workspace GA'
+    },
+    'agents.workspace_access': {
+        enabled: true,
+        description: 'Agents workspace readiness gate.',
+        owner: 'taskforce',
+        removalMilestone: 'Agents workspace GA'
+    },
+    'initiatives.workspace_access': {
+        enabled: true,
+        description: 'Initiatives workspace readiness gate.',
+        owner: 'taskforce',
+        removalMilestone: 'Initiatives workspace GA'
+    }
+};

package/dist/runtime/appGates.d.ts

@@ -0,0 +1,29 @@
+export type RuntimeMode = 'local' | 'cloud';
+export declare const ANNOTATED_ATTACHMENTS_WORKSPACE_FEATURE_KEY: "annotated_attachments.workspace_access";
+export declare const DOCUMENT_WORKSPACE_FEATURE_KEY: "documents.workspace_access";
+export declare const WORKFLOWS_WORKSPACE_FEATURE_KEY: "workflows.workspace_access";
+export declare const AGENTS_WORKSPACE_FEATURE_KEY: "agents.workspace_access";
+export declare const INITIATIVES_WORKSPACE_FEATURE_KEY: "initiatives.workspace_access";
+export type AppGateKey = typeof ANNOTATED_ATTACHMENTS_WORKSPACE_FEATURE_KEY | typeof DOCUMENT_WORKSPACE_FEATURE_KEY | typeof WORKFLOWS_WORKSPACE_FEATURE_KEY | typeof AGENTS_WORKSPACE_FEATURE_KEY | typeof INITIATIVES_WORKSPACE_FEATURE_KEY;
+export interface AppGateDefinition {
+    key: AppGateKey;
+    enabled: boolean;
+    description: string;
+    owner: string;
+    removalMilestone: string;
+}
+export interface ResolvedFeatureAccess {
+    featureKey: string;
+    allowed: boolean;
+    source: 'app_gate' | 'cloud_entitlement' | 'none';
+    code: string;
+}
+export type ResolvedFeatureAccessMap = Record<string, ResolvedFeatureAccess>;
+export declare const APP_GATE_DEFINITIONS: Record<AppGateKey, AppGateDefinition>;
+export declare function listAppGateDefinitions(): AppGateDefinition[];
+export declare function getAppGateDefinition(featureKey: string): AppGateDefinition | null;
+export declare function resolveAppGateAccess(featureKey: string): ResolvedFeatureAccess;
+export declare function resolveFeatureAccess(input: {
+    featureKey: string;
+    runtimeMode: RuntimeMode;
+}): ResolvedFeatureAccess;

package/dist/runtime/appGates.js

@@ -0,0 +1,53 @@
+import { APP_GATE_DEFINITIONS as APP_GATE_CONFIG } from './appGateDefinitions.js';
+export const ANNOTATED_ATTACHMENTS_WORKSPACE_FEATURE_KEY = 'annotated_attachments.workspace_access';
+export const DOCUMENT_WORKSPACE_FEATURE_KEY = 'documents.workspace_access';
+export const WORKFLOWS_WORKSPACE_FEATURE_KEY = 'workflows.workspace_access';
+export const AGENTS_WORKSPACE_FEATURE_KEY = 'agents.workspace_access';
+export const INITIATIVES_WORKSPACE_FEATURE_KEY = 'initiatives.workspace_access';
+export const APP_GATE_DEFINITIONS = Object.entries(APP_GATE_CONFIG).reduce((acc, [key, definition]) => {
+    acc[key] = {
+        key: key,
+        enabled: Boolean(definition.enabled),
+        description: String(definition.description || ''),
+        owner: String(definition.owner || ''),
+        removalMilestone: String(definition.removalMilestone || '')
+    };
+    return acc;
+}, {});
+export function listAppGateDefinitions() {
+    return Object.values(APP_GATE_DEFINITIONS);
+}
+export function getAppGateDefinition(featureKey) {
+    const normalizedKey = String(featureKey || '').trim();
+    if (!normalizedKey)
+        return null;
+    return APP_GATE_DEFINITIONS[normalizedKey] || null;
+}
+export function resolveAppGateAccess(featureKey) {
+    const gate = getAppGateDefinition(featureKey);
+    if (!gate) {
+        return {
+            featureKey,
+            allowed: true,
+            source: 'none',
+            code: 'OK'
+        };
+    }
+    if (!gate.enabled) {
+        return {
+            featureKey,
+            allowed: false,
+            source: 'app_gate',
+            code: 'APP_GATE_DISABLED'
+        };
+    }
+    return {
+        featureKey,
+        allowed: true,
+        source: 'app_gate',
+        code: 'OK'
+    };
+}
+export function resolveFeatureAccess(input) {
+    return resolveAppGateAccess(input.featureKey);
+}

package/dist/runtime/appGates.test.d.ts

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

package/dist/runtime/appGates.test.js

@@ -0,0 +1,42 @@
+import { beforeEach, describe, expect, it } from 'vitest';
+import { APP_GATE_DEFINITIONS, DOCUMENT_WORKSPACE_FEATURE_KEY, resolveAppGateAccess, resolveFeatureAccess } from './appGates';
+describe('app gates', () => {
+    beforeEach(() => {
+        APP_GATE_DEFINITIONS[DOCUMENT_WORKSPACE_FEATURE_KEY].enabled = false;
+    });
+    it('blocks disabled app-gated features before cloud entitlement checks', () => {
+        const result = resolveFeatureAccess({
+            featureKey: DOCUMENT_WORKSPACE_FEATURE_KEY,
+            runtimeMode: 'cloud'
+        });
+        expect(result).toEqual({
+            featureKey: DOCUMENT_WORKSPACE_FEATURE_KEY,
+            allowed: false,
+            source: 'app_gate',
+            code: 'APP_GATE_DISABLED'
+        });
+    });
+    it('allows cloud runtime when the app gate is enabled', () => {
+        APP_GATE_DEFINITIONS[DOCUMENT_WORKSPACE_FEATURE_KEY].enabled = true;
+        const result = resolveFeatureAccess({
+            featureKey: DOCUMENT_WORKSPACE_FEATURE_KEY,
+            runtimeMode: 'cloud'
+        });
+        expect(result).toEqual({
+            featureKey: DOCUMENT_WORKSPACE_FEATURE_KEY,
+            allowed: true,
+            source: 'app_gate',
+            code: 'OK'
+        });
+    });
+    it('allows local runtime when the app gate is enabled', () => {
+        APP_GATE_DEFINITIONS[DOCUMENT_WORKSPACE_FEATURE_KEY].enabled = true;
+        const result = resolveAppGateAccess(DOCUMENT_WORKSPACE_FEATURE_KEY);
+        expect(result).toEqual({
+            featureKey: DOCUMENT_WORKSPACE_FEATURE_KEY,
+            allowed: true,
+            source: 'app_gate',
+            code: 'OK'
+        });
+    });
+});

package/dist/runtime/migrationFlags.d.ts

@@ -0,0 +1 @@
+export declare const MIGRATION_COMPAT_ENABLED = true;

package/dist/runtime/migrationFlags.js

@@ -0,0 +1 @@
+export const MIGRATION_COMPAT_ENABLED = true;

package/dist/server/annotatedAttachmentsRoutes.test.d.ts

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