@task-shepherd/agent 1.0.5 → 1.0.7

package/shared/dist/mcp-client/types.js

@@ -0,0 +1,193 @@
+/**
+ * Generated MCP Client Types
+ *
+ * This file is auto-generated from MCP tool mappings.
+ * Do not modify directly - run npm run generate:mcp-client instead.
+ */
+/**
+ * Tool registry for type-safe tool execution
+ */
+export const MCP_TOOL_REGISTRY = {
+    'list_projects': {
+        name: 'list_projects',
+        description: 'List all projects with optional filtering',
+        operationType: 'query',
+        graphqlOperation: 'projects',
+        requiredPermissions: ["VIEW"],
+    },
+    'get_project': {
+        name: 'get_project',
+        description: 'Get a specific project by ID',
+        operationType: 'query',
+        graphqlOperation: 'project',
+        requiredPermissions: ["VIEW"],
+    },
+    'create_project': {
+        name: 'create_project',
+        description: 'Create a new project',
+        operationType: 'mutation',
+        graphqlOperation: 'createProject',
+        requiredPermissions: ["PRODUCT", "ADMIN"],
+    },
+    'update_project': {
+        name: 'update_project',
+        description: 'Update an existing project',
+        operationType: 'mutation',
+        graphqlOperation: 'updateProject',
+        requiredPermissions: ["PRODUCT", "ADMIN"],
+    },
+    'delete_project': {
+        name: 'delete_project',
+        description: 'Delete a project',
+        operationType: 'mutation',
+        graphqlOperation: 'deleteProject',
+        requiredPermissions: ["PRODUCT", "ADMIN"],
+    },
+    'list_stories': {
+        name: 'list_stories',
+        description: 'List stories with filtering and pagination',
+        operationType: 'query',
+        graphqlOperation: 'stories',
+        requiredPermissions: ["VIEW"],
+    },
+    'get_story': {
+        name: 'get_story',
+        description: 'Get a specific story by ID',
+        operationType: 'query',
+        graphqlOperation: 'story',
+        requiredPermissions: ["VIEW"],
+    },
+    'create_story': {
+        name: 'create_story',
+        description: 'Create a new story',
+        operationType: 'mutation',
+        graphqlOperation: 'createStory',
+        requiredPermissions: ["WORKER", "PRODUCT", "ADMIN"],
+    },
+    'update_story': {
+        name: 'update_story',
+        description: 'Update an existing story',
+        operationType: 'mutation',
+        graphqlOperation: 'updateStory',
+        requiredPermissions: ["WORKER", "PRODUCT", "ADMIN"],
+    },
+    'claim_story': {
+        name: 'claim_story',
+        description: 'Claim a story for work',
+        operationType: 'mutation',
+        graphqlOperation: 'claimStory',
+        requiredPermissions: ["WORKER", "PRODUCT", "ADMIN"],
+    },
+    'unclaim_story': {
+        name: 'unclaim_story',
+        description: 'Unclaim a previously claimed story',
+        operationType: 'mutation',
+        graphqlOperation: 'releaseStory',
+        requiredPermissions: ["WORKER", "PRODUCT", "ADMIN"],
+    },
+    'complete_story': {
+        name: 'complete_story',
+        description: 'Mark a story as complete',
+        operationType: 'mutation',
+        graphqlOperation: 'completeStory',
+        requiredPermissions: ["WORKER", "PRODUCT", "ADMIN"],
+    },
+    'review_story': {
+        name: 'review_story',
+        description: 'Review a completed story',
+        operationType: 'mutation',
+        graphqlOperation: 'reviewStory',
+        requiredPermissions: ["PRODUCT", "ADMIN"],
+    },
+    'list_tasks': {
+        name: 'list_tasks',
+        description: 'List tasks with filtering and pagination',
+        operationType: 'query',
+        graphqlOperation: 'tasks',
+        requiredPermissions: ["VIEW"],
+    },
+    'get_task': {
+        name: 'get_task',
+        description: 'Get a specific task by ID',
+        operationType: 'query',
+        graphqlOperation: 'task',
+        requiredPermissions: ["VIEW"],
+    },
+    'create_task': {
+        name: 'create_task',
+        description: 'Create a new task',
+        operationType: 'mutation',
+        graphqlOperation: 'createTask',
+        requiredPermissions: ["WORKER", "PRODUCT", "ADMIN"],
+    },
+    'update_task': {
+        name: 'update_task',
+        description: 'Update an existing task',
+        operationType: 'mutation',
+        graphqlOperation: 'updateTask',
+        requiredPermissions: ["WORKER", "PRODUCT", "ADMIN"],
+    },
+    'claim_task': {
+        name: 'claim_task',
+        description: 'Claim a task for work',
+        operationType: 'mutation',
+        graphqlOperation: 'claimTask',
+        requiredPermissions: ["WORKER", "PRODUCT", "ADMIN"],
+    },
+    'unclaim_task': {
+        name: 'unclaim_task',
+        description: 'Unclaim a previously claimed task',
+        operationType: 'mutation',
+        graphqlOperation: 'unclaimTask',
+        requiredPermissions: ["WORKER", "PRODUCT", "ADMIN"],
+    },
+    'complete_task': {
+        name: 'complete_task',
+        description: 'Mark a task as complete with implementation details',
+        operationType: 'mutation',
+        graphqlOperation: 'completeTask',
+        requiredPermissions: ["WORKER", "PRODUCT", "ADMIN"],
+    },
+    'register_worker': {
+        name: 'register_worker',
+        description: 'Register a new worker (human or AI) with the system',
+        operationType: 'mutation',
+        graphqlOperation: 'register',
+        requiredPermissions: [],
+    },
+    'list_workers': {
+        name: 'list_workers',
+        description: 'List all registered workers',
+        operationType: 'query',
+        graphqlOperation: 'users',
+        requiredPermissions: ["ADMIN"],
+    },
+    'create_story_dependency': {
+        name: 'create_story_dependency',
+        description: 'Create a dependency between two stories',
+        operationType: 'mutation',
+        graphqlOperation: 'createStoryDependency',
+        requiredPermissions: ["WORKER", "PRODUCT", "ADMIN"],
+    },
+    'get_dependency_graph': {
+        name: 'get_dependency_graph',
+        description: 'Get the complete dependency graph for a project',
+        operationType: 'query',
+        graphqlOperation: 'project',
+        requiredPermissions: ["VIEW"],
+    },
+    'get_available_stories': {
+        name: 'get_available_stories',
+        description: 'Find stories available for claiming',
+        operationType: 'query',
+        graphqlOperation: 'stories',
+        requiredPermissions: ["VIEW"],
+    },
+    'get_available_tasks': {
+        name: 'get_available_tasks',
+        description: 'Find tasks available for claiming',
+        operationType: 'query',
+        graphqlOperation: 'tasks',
+        requiredPermissions: ["VIEW"],
+    }
+};

package/shared/dist/schema/index.d.ts

@@ -0,0 +1,189 @@
+/**
+ * Centralized Schema Management System
+ *
+ * This module serves as the single source of truth for all schema-related
+ * operations across TasqHub components.
+ */
+export * from './mcp-mappings.js';
+export * from './validation.js';
+export interface GraphQLOperation {
+    name: string;
+    type: 'query' | 'mutation' | 'subscription';
+    description?: string;
+    deprecated?: boolean;
+}
+export interface TypeDefinition {
+    name: string;
+    kind: 'object' | 'interface' | 'union' | 'enum' | 'input' | 'scalar';
+    fields?: FieldDefinition[];
+    description?: string;
+}
+export interface FieldDefinition {
+    name: string;
+    type: string;
+    nullable: boolean;
+    description?: string;
+    deprecated?: boolean;
+}
+export declare enum UserRole {
+    VIEW = 0,
+    WORKER = 1,
+    PRODUCT = 2,
+    ADMIN = 3
+}
+export declare enum UserStatus {
+    ACTIVE = "ACTIVE",
+    DISABLED = "DISABLED"
+}
+export declare enum ProjectStage {
+    REQUIREMENTS = "REQUIREMENTS",
+    DESIGN = "DESIGN",
+    IMPLEMENTATION = "IMPLEMENTATION",
+    COMPLETE = "COMPLETE",
+    ARCHIVED = "ARCHIVED"
+}
+export declare enum StoryState {
+    PENDING = "PENDING",
+    IMPLEMENTATION = "IMPLEMENTATION",
+    REVIEW = "REVIEW",
+    COMPLETE = "COMPLETE",
+    BLOCKED = "BLOCKED"
+}
+export declare enum TaskState {
+    PENDING = "PENDING",
+    IMPLEMENTATION = "IMPLEMENTATION",
+    COMPLETE = "COMPLETE",
+    BLOCKED = "BLOCKED"
+}
+export declare enum TaskType {
+    PLANNED = "PLANNED",
+    FOLLOWUP = "FOLLOWUP",
+    ASK = "ASK"
+}
+export declare enum PriorityLevel {
+    LOW = "LOW",
+    MEDIUM = "MEDIUM",
+    HIGH = "HIGH",
+    CRITICAL = "CRITICAL"
+}
+export declare enum NotificationType {
+    ASSIGNMENT = "ASSIGNMENT",
+    MENTION = "MENTION",
+    STATUS_CHANGE = "STATUS_CHANGE",
+    COMMENT = "COMMENT",
+    DEADLINE = "DEADLINE"
+}
+export declare enum AuditAction {
+    CREATED = "CREATED",
+    UPDATED = "UPDATED",
+    DELETED = "DELETED",
+    STATE_CHANGED = "STATE_CHANGED",
+    ASSIGNED = "ASSIGNED",
+    UNASSIGNED = "UNASSIGNED"
+}
+export declare enum InvitationStatus {
+    PENDING = "PENDING",
+    ACCEPTED = "ACCEPTED",
+    DECLINED = "DECLINED",
+    EXPIRED = "EXPIRED"
+}
+export declare enum AIWorkType {
+    PROJECT_REVIEW = "project_review",
+    IMPLEMENTATION_PLAN = "implementation_plan",
+    STORY_IMPLEMENTATION = "story_implementation",
+    TASK_COMPLETION = "task_completion",
+    CODE_REVIEW = "code_review",
+    REVIEW_APPLICATION = "review_application"
+}
+export declare enum AIWorkerType {
+    PROJECT_REVIEWER = "project_reviewer",
+    DEVELOPMENT_PLANNER = "development_planner",
+    STORY_DEVELOPER = "story_developer",
+    CODE_REVIEWER = "code_reviewer",
+    REVIEW_APPLICATION_AGENT = "review_application_agent"
+}
+export declare enum AIWorkStatus {
+    QUEUED = "QUEUED",
+    CLAIMED = "CLAIMED",
+    IN_PROGRESS = "IN_PROGRESS",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    CANCELLED = "CANCELLED"
+}
+export interface User {
+    id: string;
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    role: UserRole;
+    status: UserStatus;
+    avatarUrl?: string;
+    timezone?: string;
+    lastLoginAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface Project {
+    id: string;
+    name: string;
+    description?: string;
+    stage: ProjectStage;
+    isArchived: boolean;
+    isPublic: boolean;
+    repositoryUrl?: string;
+    documentationUrl?: string;
+    startDate?: Date;
+    targetCompletionDate?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+    createdBy?: string;
+}
+export interface Story {
+    id: string;
+    title: string;
+    description?: string;
+    status: StoryState;
+    priority: PriorityLevel;
+    estimate?: number;
+    acceptanceCriteria: string[];
+    tags: string[];
+    projectId: string;
+    assignedTo?: string;
+    claimedAt?: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface Task {
+    id: string;
+    title: string;
+    description?: string;
+    status: TaskState;
+    type: TaskType;
+    priority: PriorityLevel;
+    areas: string[];
+    estimate?: number;
+    storyId: string;
+    assignedTo?: string;
+    claimedAt?: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const SCHEMA_VERSION = "1.0.0";
+export declare const SCHEMA_COMPATIBILITY_VERSION = "1.0";
+/**
+ * Schema registry for tracking changes and versions
+ */
+export declare class SchemaRegistry {
+    private static instance;
+    private version;
+    private compatibilityVersion;
+    private constructor();
+    static getInstance(): SchemaRegistry;
+    getVersion(): string;
+    getCompatibilityVersion(): string;
+    isCompatible(clientVersion: string): boolean;
+}

package/shared/dist/schema/index.js

@@ -0,0 +1,142 @@
+/**
+ * Centralized Schema Management System
+ *
+ * This module serves as the single source of truth for all schema-related
+ * operations across TasqHub components.
+ */
+export * from './mcp-mappings.js';
+export * from './validation.js';
+// Core enums that all components should use
+export var UserRole;
+(function (UserRole) {
+    UserRole[UserRole["VIEW"] = 0] = "VIEW";
+    UserRole[UserRole["WORKER"] = 1] = "WORKER";
+    UserRole[UserRole["PRODUCT"] = 2] = "PRODUCT";
+    UserRole[UserRole["ADMIN"] = 3] = "ADMIN";
+})(UserRole || (UserRole = {}));
+export var UserStatus;
+(function (UserStatus) {
+    UserStatus["ACTIVE"] = "ACTIVE";
+    UserStatus["DISABLED"] = "DISABLED";
+})(UserStatus || (UserStatus = {}));
+export var ProjectStage;
+(function (ProjectStage) {
+    ProjectStage["REQUIREMENTS"] = "REQUIREMENTS";
+    ProjectStage["DESIGN"] = "DESIGN";
+    ProjectStage["IMPLEMENTATION"] = "IMPLEMENTATION";
+    ProjectStage["COMPLETE"] = "COMPLETE";
+    ProjectStage["ARCHIVED"] = "ARCHIVED";
+})(ProjectStage || (ProjectStage = {}));
+export var StoryState;
+(function (StoryState) {
+    StoryState["PENDING"] = "PENDING";
+    StoryState["IMPLEMENTATION"] = "IMPLEMENTATION";
+    StoryState["REVIEW"] = "REVIEW";
+    StoryState["COMPLETE"] = "COMPLETE";
+    StoryState["BLOCKED"] = "BLOCKED";
+})(StoryState || (StoryState = {}));
+export var TaskState;
+(function (TaskState) {
+    TaskState["PENDING"] = "PENDING";
+    TaskState["IMPLEMENTATION"] = "IMPLEMENTATION";
+    TaskState["COMPLETE"] = "COMPLETE";
+    TaskState["BLOCKED"] = "BLOCKED";
+})(TaskState || (TaskState = {}));
+export var TaskType;
+(function (TaskType) {
+    TaskType["PLANNED"] = "PLANNED";
+    TaskType["FOLLOWUP"] = "FOLLOWUP";
+    TaskType["ASK"] = "ASK";
+})(TaskType || (TaskType = {}));
+export var PriorityLevel;
+(function (PriorityLevel) {
+    PriorityLevel["LOW"] = "LOW";
+    PriorityLevel["MEDIUM"] = "MEDIUM";
+    PriorityLevel["HIGH"] = "HIGH";
+    PriorityLevel["CRITICAL"] = "CRITICAL";
+})(PriorityLevel || (PriorityLevel = {}));
+export var NotificationType;
+(function (NotificationType) {
+    NotificationType["ASSIGNMENT"] = "ASSIGNMENT";
+    NotificationType["MENTION"] = "MENTION";
+    NotificationType["STATUS_CHANGE"] = "STATUS_CHANGE";
+    NotificationType["COMMENT"] = "COMMENT";
+    NotificationType["DEADLINE"] = "DEADLINE";
+})(NotificationType || (NotificationType = {}));
+export var AuditAction;
+(function (AuditAction) {
+    AuditAction["CREATED"] = "CREATED";
+    AuditAction["UPDATED"] = "UPDATED";
+    AuditAction["DELETED"] = "DELETED";
+    AuditAction["STATE_CHANGED"] = "STATE_CHANGED";
+    AuditAction["ASSIGNED"] = "ASSIGNED";
+    AuditAction["UNASSIGNED"] = "UNASSIGNED";
+})(AuditAction || (AuditAction = {}));
+export var InvitationStatus;
+(function (InvitationStatus) {
+    InvitationStatus["PENDING"] = "PENDING";
+    InvitationStatus["ACCEPTED"] = "ACCEPTED";
+    InvitationStatus["DECLINED"] = "DECLINED";
+    InvitationStatus["EXPIRED"] = "EXPIRED";
+})(InvitationStatus || (InvitationStatus = {}));
+// AI Work Types - Single source of truth for all AI work operations
+export var AIWorkType;
+(function (AIWorkType) {
+    // Project-related work
+    AIWorkType["PROJECT_REVIEW"] = "project_review";
+    AIWorkType["IMPLEMENTATION_PLAN"] = "implementation_plan";
+    // Story and task work
+    AIWorkType["STORY_IMPLEMENTATION"] = "story_implementation";
+    AIWorkType["TASK_COMPLETION"] = "task_completion";
+    // Code review
+    AIWorkType["CODE_REVIEW"] = "code_review";
+    // Review application
+    AIWorkType["REVIEW_APPLICATION"] = "review_application";
+})(AIWorkType || (AIWorkType = {}));
+// AI Worker Types - Types of AI workers that can perform work
+export var AIWorkerType;
+(function (AIWorkerType) {
+    AIWorkerType["PROJECT_REVIEWER"] = "project_reviewer";
+    AIWorkerType["DEVELOPMENT_PLANNER"] = "development_planner";
+    AIWorkerType["STORY_DEVELOPER"] = "story_developer";
+    AIWorkerType["CODE_REVIEWER"] = "code_reviewer";
+    AIWorkerType["REVIEW_APPLICATION_AGENT"] = "review_application_agent";
+})(AIWorkerType || (AIWorkerType = {}));
+// Work Queue Status
+export var AIWorkStatus;
+(function (AIWorkStatus) {
+    AIWorkStatus["QUEUED"] = "QUEUED";
+    AIWorkStatus["CLAIMED"] = "CLAIMED";
+    AIWorkStatus["IN_PROGRESS"] = "IN_PROGRESS";
+    AIWorkStatus["COMPLETED"] = "COMPLETED";
+    AIWorkStatus["FAILED"] = "FAILED";
+    AIWorkStatus["CANCELLED"] = "CANCELLED";
+})(AIWorkStatus || (AIWorkStatus = {}));
+// Schema version information for compatibility tracking
+export const SCHEMA_VERSION = '1.0.0';
+export const SCHEMA_COMPATIBILITY_VERSION = '1.0';
+/**
+ * Schema registry for tracking changes and versions
+ */
+export class SchemaRegistry {
+    constructor() {
+        this.version = SCHEMA_VERSION;
+        this.compatibilityVersion = SCHEMA_COMPATIBILITY_VERSION;
+    }
+    static getInstance() {
+        if (!SchemaRegistry.instance) {
+            SchemaRegistry.instance = new SchemaRegistry();
+        }
+        return SchemaRegistry.instance;
+    }
+    getVersion() {
+        return this.version;
+    }
+    getCompatibilityVersion() {
+        return this.compatibilityVersion;
+    }
+    isCompatible(clientVersion) {
+        // Simple compatibility check - in practice, this would be more sophisticated
+        return clientVersion.startsWith(this.compatibilityVersion);
+    }
+}

package/shared/dist/schema/mcp-mappings.d.ts

@@ -0,0 +1,50 @@
+/**
+ * MCP Tool Mappings Configuration
+ *
+ * This file serves as the centralized mapping between MCP tools and GraphQL operations,
+ * ensuring consistency across all TasqHub components. It defines which GraphQL
+ * operations each MCP tool corresponds to and validates the interfaces.
+ */
+export interface MCPToolMapping {
+    toolName: string;
+    description: string;
+    graphqlOperation: string;
+    operationType: 'query' | 'mutation' | 'subscription';
+    requiredPermissions?: string[];
+    inputSchema?: Record<string, any>;
+    outputSchema?: Record<string, any>;
+    deprecated?: boolean;
+    deprecationReason?: string;
+}
+export interface MCPToolCategory {
+    name: string;
+    description: string;
+    tools: MCPToolMapping[];
+}
+/**
+ * Centralized MCP tool mappings organized by functional categories
+ */
+export declare const MCP_TOOL_MAPPINGS: MCPToolCategory[];
+/**
+ * Get MCP tool mapping by tool name
+ */
+export declare function getMCPToolMapping(toolName: string): MCPToolMapping | undefined;
+/**
+ * Get all MCP tool names
+ */
+export declare function getAllMCPToolNames(): string[];
+/**
+ * Get tools by GraphQL operation
+ */
+export declare function getToolsByGraphQLOperation(operationName: string): MCPToolMapping[];
+/**
+ * Get tools by category
+ */
+export declare function getToolsByCategory(categoryName: string): MCPToolMapping[];
+/**
+ * Validate that a tool operation matches its GraphQL schema
+ */
+export declare function validateToolOperation(toolName: string, input: any): {
+    valid: boolean;
+    errors: string[];
+};