@task-mcp/shared 1.0.7 → 1.0.8

package/dist/schemas/response-schema.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+/**
+ * Response Schema
+ *
+ * Standardized formats for AI agents to ask questions, make suggestions,
+ * or request confirmation from users.
+ */
+// Response types
+export const ResponseType = z.enum(["question", "suggestion", "confirmation"]);
+// Priority level for responses
+export const ResponsePriority = z.enum(["low", "medium", "high", "critical"]);
+// Option for multiple choice responses
+export const ResponseOption = z.object({
+    label: z.string().describe("Display text for the option"),
+    value: z.string().describe("Value to return when selected"),
+    description: z.string().optional().describe("Additional explanation"),
+});
+// Base response schema
+const BaseResponse = z.object({
+    type: ResponseType.describe("Type of response: question, suggestion, or confirmation"),
+    message: z.string().describe("Main message to display to user"),
+    context: z.string().optional().describe("Additional context or explanation"),
+    priority: ResponsePriority.optional().describe("Urgency/importance of response (default: medium)"),
+});
+// Question response - for clarification
+export const QuestionResponse = BaseResponse.extend({
+    type: z.literal("question"),
+    options: z.array(ResponseOption).optional()
+        .describe("Multiple choice options (omit for free-form answer)"),
+    defaultOption: z.string().optional()
+        .describe("Default option value if user provides no input"),
+});
+// Suggestion response - for recommendations
+export const SuggestionResponse = BaseResponse.extend({
+    type: z.literal("suggestion"),
+    options: z.array(ResponseOption).min(1)
+        .describe("Suggested options for user to choose from"),
+    reasoning: z.string().optional()
+        .describe("Explanation of why these suggestions were made"),
+});
+// Confirmation response - for explicit approval
+export const ConfirmationResponse = BaseResponse.extend({
+    type: z.literal("confirmation"),
+    action: z.string().describe("Action that will be taken if confirmed"),
+    consequences: z.array(z.string()).optional()
+        .describe("List of effects or changes that will occur"),
+    defaultConfirm: z.boolean().optional()
+        .describe("Default choice if user provides no input (default: false)"),
+});
+// Union type for all response types
+export const AgentResponse = z.discriminatedUnion("type", [
+    QuestionResponse,
+    SuggestionResponse,
+    ConfirmationResponse,
+]);
+// Input schema for generating responses
+export const GenerateResponseInput = z.object({
+    type: ResponseType.describe("Type of response to generate"),
+    message: z.string().describe("Main message"),
+    options: z.array(ResponseOption).optional()
+        .describe("Options for question/suggestion types"),
+    context: z.string().optional(),
+    priority: ResponsePriority.optional().default("medium"),
+    action: z.string().optional()
+        .describe("Action description (for confirmation type)"),
+    consequences: z.array(z.string()).optional()
+        .describe("Consequences list (for confirmation type)"),
+    reasoning: z.string().optional()
+        .describe("Reasoning explanation (for suggestion type)"),
+    defaultOption: z.string().optional()
+        .describe("Default option value (for question type)"),
+    defaultConfirm: z.boolean().optional()
+        .describe("Default confirmation choice (for confirmation type)"),
+});
+//# sourceMappingURL=response-schema.js.map

package/dist/schemas/response-schema.js.map

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

package/dist/schemas/response-schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=response-schema.test.d.ts.map

package/dist/schemas/response-schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-schema.test.d.ts","sourceRoot":"","sources":["../../src/schemas/response-schema.test.ts"],"names":[],"mappings":""}

package/dist/schemas/response-schema.test.js

@@ -0,0 +1,256 @@
+import { describe, expect, it } from "bun:test";
+import { ResponseType, ResponsePriority, ResponseOption, QuestionResponse, SuggestionResponse, ConfirmationResponse, GenerateResponseInput, } from "./response-schema.js";
+describe("Response Schema", () => {
+    describe("ResponseType", () => {
+        it("should accept valid response types", () => {
+            expect(() => ResponseType.parse("question")).not.toThrow();
+            expect(() => ResponseType.parse("suggestion")).not.toThrow();
+            expect(() => ResponseType.parse("confirmation")).not.toThrow();
+        });
+        it("should reject invalid response types", () => {
+            expect(() => ResponseType.parse("invalid")).toThrow();
+            expect(() => ResponseType.parse("ask")).toThrow();
+        });
+    });
+    describe("ResponsePriority", () => {
+        it("should accept valid priority levels", () => {
+            expect(() => ResponsePriority.parse("low")).not.toThrow();
+            expect(() => ResponsePriority.parse("medium")).not.toThrow();
+            expect(() => ResponsePriority.parse("high")).not.toThrow();
+            expect(() => ResponsePriority.parse("critical")).not.toThrow();
+        });
+        it("should reject invalid priority levels", () => {
+            expect(() => ResponsePriority.parse("urgent")).toThrow();
+            expect(() => ResponsePriority.parse("normal")).toThrow();
+        });
+    });
+    describe("ResponseOption", () => {
+        it("should validate option with all fields", () => {
+            const option = {
+                label: "High Priority",
+                value: "high",
+                description: "For urgent tasks",
+            };
+            expect(() => ResponseOption.parse(option)).not.toThrow();
+            const parsed = ResponseOption.parse(option);
+            expect(parsed.label).toBe("High Priority");
+            expect(parsed.value).toBe("high");
+            expect(parsed.description).toBe("For urgent tasks");
+        });
+        it("should validate option without description", () => {
+            const option = {
+                label: "Low Priority",
+                value: "low",
+            };
+            expect(() => ResponseOption.parse(option)).not.toThrow();
+            const parsed = ResponseOption.parse(option);
+            expect(parsed.label).toBe("Low Priority");
+            expect(parsed.value).toBe("low");
+            expect(parsed.description).toBeUndefined();
+        });
+        it("should reject option without required fields", () => {
+            expect(() => ResponseOption.parse({ label: "Test" })).toThrow();
+            expect(() => ResponseOption.parse({ value: "test" })).toThrow();
+            expect(() => ResponseOption.parse({})).toThrow();
+        });
+    });
+    describe("QuestionResponse", () => {
+        it("should validate question with all fields", () => {
+            const question = {
+                type: "question",
+                message: "What should we do?",
+                context: "Need clarification on approach",
+                priority: "high",
+                options: [
+                    { label: "Option A", value: "a" },
+                    { label: "Option B", value: "b" },
+                ],
+                defaultOption: "a",
+            };
+            expect(() => QuestionResponse.parse(question)).not.toThrow();
+            const parsed = QuestionResponse.parse(question);
+            expect(parsed.type).toBe("question");
+            expect(parsed.message).toBe("What should we do?");
+            expect(parsed.options).toHaveLength(2);
+            expect(parsed.defaultOption).toBe("a");
+        });
+        it("should validate question with minimal fields", () => {
+            const question = {
+                type: "question",
+                message: "Proceed?",
+            };
+            expect(() => QuestionResponse.parse(question)).not.toThrow();
+            const parsed = QuestionResponse.parse(question);
+            expect(parsed.type).toBe("question");
+            expect(parsed.message).toBe("Proceed?");
+            expect(parsed.context).toBeUndefined();
+            expect(parsed.options).toBeUndefined();
+        });
+        it("should reject question without message", () => {
+            expect(() => QuestionResponse.parse({ type: "question" })).toThrow();
+        });
+        it("should reject question with wrong type", () => {
+            expect(() => QuestionResponse.parse({
+                type: "suggestion",
+                message: "Test",
+            })).toThrow();
+        });
+    });
+    describe("SuggestionResponse", () => {
+        it("should validate suggestion with all fields", () => {
+            const suggestion = {
+                type: "suggestion",
+                message: "Consider breaking down this task",
+                context: "Task is complex",
+                priority: "medium",
+                options: [
+                    { label: "3 subtasks", value: "sub_3" },
+                    { label: "5 subtasks", value: "sub_5" },
+                ],
+                reasoning: "Based on complexity analysis",
+            };
+            expect(() => SuggestionResponse.parse(suggestion)).not.toThrow();
+            const parsed = SuggestionResponse.parse(suggestion);
+            expect(parsed.type).toBe("suggestion");
+            expect(parsed.options).toHaveLength(2);
+            expect(parsed.reasoning).toBe("Based on complexity analysis");
+        });
+        it("should validate suggestion with minimal fields", () => {
+            const suggestion = {
+                type: "suggestion",
+                message: "Try this",
+                options: [{ label: "Do it", value: "yes" }],
+            };
+            expect(() => SuggestionResponse.parse(suggestion)).not.toThrow();
+            const parsed = SuggestionResponse.parse(suggestion);
+            expect(parsed.options).toHaveLength(1);
+        });
+        it("should reject suggestion without options", () => {
+            expect(() => SuggestionResponse.parse({
+                type: "suggestion",
+                message: "Test",
+            })).toThrow();
+        });
+        it("should reject suggestion with empty options array", () => {
+            expect(() => SuggestionResponse.parse({
+                type: "suggestion",
+                message: "Test",
+                options: [],
+            })).toThrow();
+        });
+    });
+    describe("ConfirmationResponse", () => {
+        it("should validate confirmation with all fields", () => {
+            const confirmation = {
+                type: "confirmation",
+                message: "Are you sure?",
+                action: "Delete all completed tasks",
+                context: "This operation is irreversible",
+                priority: "critical",
+                consequences: ["10 tasks will be removed", "Cannot be undone"],
+                defaultConfirm: false,
+            };
+            expect(() => ConfirmationResponse.parse(confirmation)).not.toThrow();
+            const parsed = ConfirmationResponse.parse(confirmation);
+            expect(parsed.type).toBe("confirmation");
+            expect(parsed.action).toBe("Delete all completed tasks");
+            expect(parsed.consequences).toHaveLength(2);
+            expect(parsed.defaultConfirm).toBe(false);
+        });
+        it("should validate confirmation with minimal fields", () => {
+            const confirmation = {
+                type: "confirmation",
+                message: "Delete this?",
+                action: "Delete task",
+            };
+            expect(() => ConfirmationResponse.parse(confirmation)).not.toThrow();
+            const parsed = ConfirmationResponse.parse(confirmation);
+            expect(parsed.action).toBe("Delete task");
+            expect(parsed.consequences).toBeUndefined();
+        });
+        it("should reject confirmation without action", () => {
+            expect(() => ConfirmationResponse.parse({
+                type: "confirmation",
+                message: "Confirm?",
+            })).toThrow();
+        });
+        it("should reject confirmation without message", () => {
+            expect(() => ConfirmationResponse.parse({
+                type: "confirmation",
+                action: "Do something",
+            })).toThrow();
+        });
+    });
+    describe("GenerateResponseInput", () => {
+        it("should validate input for question type", () => {
+            const input = {
+                type: "question",
+                message: "What to do?",
+                options: [{ label: "Yes", value: "yes" }],
+                defaultOption: "yes",
+            };
+            expect(() => GenerateResponseInput.parse(input)).not.toThrow();
+            const parsed = GenerateResponseInput.parse(input);
+            expect(parsed.type).toBe("question");
+        });
+        it("should validate input for suggestion type", () => {
+            const input = {
+                type: "suggestion",
+                message: "Try this",
+                options: [{ label: "Option", value: "opt" }],
+                reasoning: "Because reasons",
+            };
+            expect(() => GenerateResponseInput.parse(input)).not.toThrow();
+        });
+        it("should validate input for confirmation type", () => {
+            const input = {
+                type: "confirmation",
+                message: "Sure?",
+                action: "Delete",
+                consequences: ["Gone forever"],
+                defaultConfirm: false,
+            };
+            expect(() => GenerateResponseInput.parse(input)).not.toThrow();
+        });
+        it("should use default priority of medium", () => {
+            const input = {
+                type: "question",
+                message: "Test?",
+            };
+            const parsed = GenerateResponseInput.parse(input);
+            expect(parsed.priority).toBe("medium");
+        });
+        it("should allow custom priority", () => {
+            const input = {
+                type: "question",
+                message: "Test?",
+                priority: "critical",
+            };
+            const parsed = GenerateResponseInput.parse(input);
+            expect(parsed.priority).toBe("critical");
+        });
+    });
+    describe("Type discrimination", () => {
+        it("should differentiate response types at compile time", () => {
+            const question = {
+                type: "question",
+                message: "Test",
+            };
+            const suggestion = {
+                type: "suggestion",
+                message: "Test",
+                options: [{ label: "A", value: "a" }],
+            };
+            const confirmation = {
+                type: "confirmation",
+                message: "Test",
+                action: "Do it",
+            };
+            // TypeScript should allow this
+            expect(question.type).toBe("question");
+            expect(suggestion.type).toBe("suggestion");
+            expect(confirmation.type).toBe("confirmation");
+        });
+    });
+});
+//# sourceMappingURL=response-schema.test.js.map

package/dist/schemas/response-schema.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@task-mcp/shared",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Shared utilities for task-mcp: types, algorithms, and natural language parsing",
   "type": "module",
   "main": "./src/index.ts",

package/src/schemas/index.ts

@@ -58,4 +58,27 @@ export {
   type InboxPreview,
   type CriticalPathSummary,
   type BottleneckSummary,
+  // Dashboard types
+  type DashboardProgress,
+  type DashboardPriorityBreakdown,
+  type DashboardDependencyMetrics,
+  type DashboardNextTask,
+  type DashboardCriticalPath,
+  type DashboardStatusBreakdown,
+  type DashboardSubtaskProgress,
+  type DashboardDependencyStats,
+  type DashboardConcise,
+  type DashboardStandard,
 } from "./response-format.js";
+
+// Response schema (agent interaction)
+export {
+  ResponseType,
+  ResponsePriority,
+  ResponseOption,
+  QuestionResponse,
+  SuggestionResponse,
+  ConfirmationResponse,
+  AgentResponse,
+  GenerateResponseInput,
+} from "./response-schema.js";

package/src/schemas/project.ts

@@ -33,6 +33,7 @@ export const Project = z.object({
   createdAt: z.string(),
   updatedAt: z.string(),
   targetDate: z.string().optional(),
+  sortOrder: z.number().optional(), // User-defined display order (auto-assigned if not specified)
 
   // Computed stats
   completionPercentage: z.number().optional(),
@@ -50,6 +51,7 @@ export const ProjectCreateInput = z.object({
   defaultPriority: Priority.optional(),
   contexts: z.array(Context).optional(),
   targetDate: z.string().optional(),
+  sortOrder: z.number().optional(), // Auto-assigned if not specified
 });
 export type ProjectCreateInput = z.infer<typeof ProjectCreateInput>;
 
@@ -61,5 +63,6 @@ export const ProjectUpdateInput = z.object({
   defaultPriority: Priority.optional(),
   contexts: z.array(Context).optional(),
   targetDate: z.string().optional(),
+  sortOrder: z.number().optional(),
 });
 export type ProjectUpdateInput = z.infer<typeof ProjectUpdateInput>;

package/src/schemas/response-format.ts

@@ -106,3 +106,99 @@ export interface BottleneckSummary {
   title: string;
   blockedCount: number;
 }
+
+/**
+ * Dashboard response types - project_dashboard tool
+ *
+ * Provides unified project overview with progress, priority breakdown,
+ * dependency metrics, and next task recommendation.
+ */
+
+// Progress metrics
+export interface DashboardProgress {
+  completed: number;
+  total: number;
+  pct: number; // 0-100
+}
+
+// Priority breakdown
+export interface DashboardPriorityBreakdown {
+  critical: number;
+  high: number;
+  medium: number;
+  low: number;
+}
+
+// Dependency metrics
+export interface DashboardDependencyMetrics {
+  ready: number;    // No dependencies or all satisfied
+  blocked: number;  // Has unsatisfied dependencies
+  noDeps: number;   // Tasks with no dependencies
+}
+
+// Next task recommendation
+export interface DashboardNextTask {
+  id: string;
+  title: string;
+  priority: string;
+  reason: string;   // Why this task is recommended
+}
+
+// Critical path info
+export interface DashboardCriticalPath {
+  length: number;    // Total duration in minutes
+  taskCount: number; // Number of tasks on critical path
+}
+
+// Status breakdown (TaskMaster-style)
+export interface DashboardStatusBreakdown {
+  done: number;
+  inProgress: number;
+  pending: number;
+  blocked: number;
+  deferred: number;
+  cancelled: number;
+}
+
+// Subtask progress metrics (TaskMaster-style)
+export interface DashboardSubtaskProgress {
+  completed: number;
+  total: number;
+  pct: number;       // 0-100
+  inProgress: number;
+  pending: number;
+  blocked: number;
+}
+
+// Dependency statistics (TaskMaster-style)
+export interface DashboardDependencyStats {
+  mostDependedOn?: {
+    taskId: string;
+    title: string;
+    dependentCount: number; // How many tasks depend on this
+  };
+  avgDepsPerTask: number; // Average number of dependencies per task
+}
+
+// Concise format (~100 tokens) - essential metrics only
+export interface DashboardConcise {
+  id: string;
+  name: string;
+  progress: DashboardProgress;
+  statusBreakdown: DashboardStatusBreakdown;
+  subtaskProgress?: DashboardSubtaskProgress;
+  priority: DashboardPriorityBreakdown;
+  dependency: DashboardDependencyMetrics;
+  dependencyStats: DashboardDependencyStats;
+  nextTask?: DashboardNextTask;
+}
+
+// Standard format (~300 tokens) - includes tasks and critical path
+export interface DashboardStandard extends DashboardConcise {
+  projectStatus: string;
+  targetDate?: string;
+  criticalPath?: DashboardCriticalPath;
+  tasks: TaskSummary[];
+}
+
+// Detailed format - human-readable markdown (use string output)