crewly 1.0.6 → 1.0.8

package/dist/cli/backend/src/types/auto-assign.types.d.ts

@@ -0,0 +1,271 @@
+/**
+ * Auto-Assignment Type Definitions
+ *
+ * Types for the automatic task assignment system.
+ *
+ * @module types/auto-assign.types
+ */
+/**
+ * Prioritization strategy for task assignment
+ */
+export type PrioritizationStrategy = 'fifo' | 'priority' | 'deadline' | 'custom';
+/**
+ * Role matching rule for task assignment
+ */
+export interface RoleMatchRule {
+    /** The agent role this rule applies to */
+    role: string;
+    /** Task types this role can handle */
+    taskTypes: string[];
+    /** Priority order (lower = higher priority) */
+    priority: number;
+    /** If true, only this role can handle these task types */
+    exclusive?: boolean;
+}
+/**
+ * Load balancing configuration
+ */
+export interface LoadBalancingConfig {
+    /** Whether load balancing is enabled */
+    enabled: boolean;
+    /** Maximum tasks an agent can work on simultaneously */
+    maxConcurrentTasks: number;
+    /** Whether to prefer assigning to idle agents */
+    preferIdleAgents: boolean;
+}
+/**
+ * Dependency handling configuration
+ */
+export interface DependencyConfig {
+    /** Whether to respect blocking dependencies */
+    respectBlocking: boolean;
+    /** Whether to wait for dependencies before assignment */
+    waitForDependencies: boolean;
+}
+/**
+ * Complete assignment strategy configuration
+ */
+export interface AssignmentStrategy {
+    /** How tasks are prioritized */
+    prioritization: PrioritizationStrategy;
+    /** Role matching rules */
+    roleMatching: RoleMatchRule[];
+    /** Load balancing settings */
+    loadBalancing: LoadBalancingConfig;
+    /** Dependency handling settings */
+    dependencies: DependencyConfig;
+}
+/**
+ * Result of a task assignment operation
+ */
+export interface TaskAssignmentResult {
+    /** Task ID that was assigned */
+    taskId: string;
+    /** Path to the task file */
+    taskPath: string;
+    /** Agent ID that received the task */
+    agentId: string;
+    /** Session name of the agent */
+    sessionName: string;
+    /** When the task was assigned */
+    assignedAt: string;
+    /** Estimated completion time (optional) */
+    estimatedCompletion?: string;
+}
+/**
+ * Task in the assignment queue
+ */
+export interface QueuedTask {
+    /** Unique task identifier */
+    taskId: string;
+    /** Path to the task file */
+    taskPath: string;
+    /** Task title */
+    title: string;
+    /** Task priority (lower = higher priority) */
+    priority: number;
+    /** Type of task (feature, fix, test, etc.) */
+    taskType?: string;
+    /** Role required to complete this task */
+    requiredRole?: string;
+    /** Task IDs that must complete before this task */
+    dependencies: string[];
+    /** Task IDs currently blocking this task */
+    blockedBy: string[];
+    /** When the task was created */
+    createdAt: string;
+    /** Estimated hours to complete */
+    estimatedHours?: number;
+    /** Task labels/tags */
+    labels?: string[];
+}
+/**
+ * Assignment status
+ */
+export type AssignmentStatus = 'active' | 'completed' | 'failed' | 'reassigned';
+/**
+ * Record of a task assignment
+ */
+export interface TaskAssignment {
+    /** Task ID */
+    taskId: string;
+    /** Agent ID assigned to the task */
+    agentId: string;
+    /** Session name of the agent */
+    sessionName: string;
+    /** When the task was assigned */
+    assignedAt: string;
+    /** Current status of the assignment */
+    status: AssignmentStatus;
+    /** When the task was completed (if applicable) */
+    completedAt?: string;
+    /** Number of continuation iterations */
+    iterations?: number;
+}
+/**
+ * Task queue for a project
+ */
+export interface TaskQueue {
+    /** Project path */
+    projectPath: string;
+    /** All open tasks, sorted by priority */
+    tasks: QueuedTask[];
+    /** Assignment history */
+    assignments: TaskAssignment[];
+    /** Assignment strategy configuration */
+    config: AssignmentStrategy;
+    /** Last updated timestamp */
+    lastUpdated: string;
+}
+/**
+ * Types of assignment events
+ */
+export type AssignmentEventType = 'task_assigned' | 'task_completed' | 'task_failed' | 'agent_idle' | 'no_tasks' | 'assignment_skipped';
+/**
+ * Event emitted by the AutoAssignService
+ */
+export interface AssignmentEvent {
+    /** Type of event */
+    type: AssignmentEventType;
+    /** Agent ID involved */
+    agentId: string;
+    /** Session name of the agent */
+    sessionName: string;
+    /** Task ID (if applicable) */
+    taskId?: string;
+    /** Timestamp of the event */
+    timestamp: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Notification configuration for auto-assignment
+ */
+export interface NotificationConfig {
+    /** Notify when agent becomes idle */
+    notifyOnIdle: boolean;
+    /** Idle threshold in minutes before notification */
+    idleThresholdMinutes: number;
+    /** Notify when no tasks available */
+    notifyOnNoTasks: boolean;
+}
+/**
+ * Rate limits for auto-assignment
+ */
+export interface AssignmentLimits {
+    /** Maximum assignments per day per agent */
+    maxAssignmentsPerDay: number;
+    /** Cooldown between task assignments in seconds */
+    cooldownBetweenTasks: number;
+}
+/**
+ * Complete auto-assignment configuration
+ */
+export interface AutoAssignConfig {
+    /** Whether auto-assignment is enabled */
+    enabled: boolean;
+    /** Assignment strategy */
+    strategy: AssignmentStrategy;
+    /** Notification settings */
+    notifications: NotificationConfig;
+    /** Rate limits */
+    limits: AssignmentLimits;
+}
+/**
+ * Parameters for finding the next task
+ */
+export interface FindNextTaskParams {
+    /** Session name of the agent */
+    sessionName: string;
+    /** Agent's role */
+    role: string;
+    /** Project path */
+    projectPath: string;
+    /** Preferred task types (optional) */
+    preferredTaskTypes?: string[];
+}
+/**
+ * Result of finding the next task
+ */
+export interface FindNextTaskResult {
+    /** Whether a task was found */
+    found: boolean;
+    /** The task (if found) */
+    task?: QueuedTask;
+    /** Reason if no task found */
+    reason?: 'no_tasks' | 'all_blocked' | 'role_mismatch' | 'at_limit' | 'cooldown';
+}
+/**
+ * Auto-assignment related constants
+ */
+export declare const AUTO_ASSIGN_CONSTANTS: {
+    /** Default configuration values */
+    readonly DEFAULTS: {
+        readonly MAX_CONCURRENT_TASKS: 1;
+        readonly MAX_ASSIGNMENTS_PER_DAY: 50;
+        readonly COOLDOWN_BETWEEN_TASKS: 60;
+        readonly IDLE_THRESHOLD_MINUTES: 5;
+    };
+    /** Task type categories */
+    readonly TASK_TYPES: {
+        readonly DEVELOPMENT: readonly ["feature", "fix", "refactor", "implement"];
+        readonly TESTING: readonly ["test", "verify", "qa"];
+        readonly FRONTEND: readonly ["ui", "component", "style", "frontend"];
+        readonly BACKEND: readonly ["api", "service", "database", "backend"];
+        readonly MANAGEMENT: readonly ["planning", "review", "coordination", "documentation"];
+    };
+    /** Priority levels */
+    readonly PRIORITY: {
+        readonly CRITICAL: 1;
+        readonly HIGH: 2;
+        readonly MEDIUM: 5;
+        readonly LOW: 10;
+        readonly BACKLOG: 20;
+    };
+    /** Configuration file paths */
+    readonly PATHS: {
+        readonly CONFIG_FILE: "auto-assign.yaml";
+        readonly CONFIG_DIR: ".crewly/config";
+    };
+};
+/**
+ * Default role matching rules
+ */
+export declare const DEFAULT_ROLE_MATCHING: RoleMatchRule[];
+/**
+ * Default assignment strategy
+ */
+export declare const DEFAULT_ASSIGNMENT_STRATEGY: AssignmentStrategy;
+/**
+ * Default notification configuration
+ */
+export declare const DEFAULT_NOTIFICATION_CONFIG: NotificationConfig;
+/**
+ * Default assignment limits
+ */
+export declare const DEFAULT_ASSIGNMENT_LIMITS: AssignmentLimits;
+/**
+ * Default complete auto-assignment configuration
+ */
+export declare const DEFAULT_AUTO_ASSIGN_CONFIG: AutoAssignConfig;
+//# sourceMappingURL=auto-assign.types.d.ts.map

package/dist/cli/backend/src/types/auto-assign.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-assign.types.d.ts","sourceRoot":"","sources":["../../../../../backend/src/types/auto-assign.types.ts"],"names":[],"mappings":"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"}

package/dist/cli/backend/src/types/auto-assign.types.js

@@ -0,0 +1,136 @@
+/**
+ * Auto-Assignment Type Definitions
+ *
+ * Types for the automatic task assignment system.
+ *
+ * @module types/auto-assign.types
+ */
+// ======================
+// Constants
+// ======================
+/**
+ * Auto-assignment related constants
+ */
+export const AUTO_ASSIGN_CONSTANTS = {
+    /** Default configuration values */
+    DEFAULTS: {
+        MAX_CONCURRENT_TASKS: 1,
+        MAX_ASSIGNMENTS_PER_DAY: 50,
+        COOLDOWN_BETWEEN_TASKS: 60, // seconds
+        IDLE_THRESHOLD_MINUTES: 5,
+    },
+    /** Task type categories */
+    TASK_TYPES: {
+        DEVELOPMENT: ['feature', 'fix', 'refactor', 'implement'],
+        TESTING: ['test', 'verify', 'qa'],
+        FRONTEND: ['ui', 'component', 'style', 'frontend'],
+        BACKEND: ['api', 'service', 'database', 'backend'],
+        MANAGEMENT: ['planning', 'review', 'coordination', 'documentation'],
+    },
+    /** Priority levels */
+    PRIORITY: {
+        CRITICAL: 1,
+        HIGH: 2,
+        MEDIUM: 5,
+        LOW: 10,
+        BACKLOG: 20,
+    },
+    /** Configuration file paths */
+    PATHS: {
+        CONFIG_FILE: 'auto-assign.yaml',
+        CONFIG_DIR: '.crewly/config',
+    },
+};
+/**
+ * Default role matching rules
+ */
+export const DEFAULT_ROLE_MATCHING = [
+    {
+        role: 'developer',
+        taskTypes: ['feature', 'fix', 'refactor', 'test', 'implement'],
+        priority: 1,
+    },
+    {
+        role: 'frontend-developer',
+        taskTypes: ['feature', 'fix', 'ui', 'component', 'style', 'frontend'],
+        priority: 1,
+    },
+    {
+        role: 'backend-developer',
+        taskTypes: ['feature', 'fix', 'api', 'service', 'database', 'backend'],
+        priority: 1,
+    },
+    {
+        role: 'qa',
+        taskTypes: ['test', 'review', 'verify', 'qa'],
+        priority: 1,
+        exclusive: true,
+    },
+    {
+        role: 'tester',
+        taskTypes: ['test', 'review', 'verify'],
+        priority: 2,
+    },
+    {
+        role: 'pm',
+        taskTypes: ['planning', 'review', 'coordination', 'documentation'],
+        priority: 1,
+    },
+    {
+        role: 'tpm',
+        taskTypes: ['planning', 'coordination', 'tracking'],
+        priority: 1,
+    },
+    {
+        role: 'pgm',
+        taskTypes: ['planning', 'management', 'coordination'],
+        priority: 1,
+    },
+    {
+        role: 'designer',
+        taskTypes: ['design', 'ui', 'ux', 'mockup'],
+        priority: 1,
+        exclusive: true,
+    },
+];
+/**
+ * Default assignment strategy
+ */
+export const DEFAULT_ASSIGNMENT_STRATEGY = {
+    prioritization: 'priority',
+    roleMatching: DEFAULT_ROLE_MATCHING,
+    loadBalancing: {
+        enabled: true,
+        maxConcurrentTasks: AUTO_ASSIGN_CONSTANTS.DEFAULTS.MAX_CONCURRENT_TASKS,
+        preferIdleAgents: true,
+    },
+    dependencies: {
+        respectBlocking: true,
+        waitForDependencies: true,
+    },
+};
+/**
+ * Default notification configuration
+ */
+export const DEFAULT_NOTIFICATION_CONFIG = {
+    notifyOnIdle: true,
+    idleThresholdMinutes: AUTO_ASSIGN_CONSTANTS.DEFAULTS.IDLE_THRESHOLD_MINUTES,
+    notifyOnNoTasks: true,
+};
+/**
+ * Default assignment limits
+ */
+export const DEFAULT_ASSIGNMENT_LIMITS = {
+    maxAssignmentsPerDay: AUTO_ASSIGN_CONSTANTS.DEFAULTS.MAX_ASSIGNMENTS_PER_DAY,
+    cooldownBetweenTasks: AUTO_ASSIGN_CONSTANTS.DEFAULTS.COOLDOWN_BETWEEN_TASKS,
+};
+/**
+ * Default complete auto-assignment configuration
+ */
+export const DEFAULT_AUTO_ASSIGN_CONFIG = {
+    enabled: true,
+    strategy: DEFAULT_ASSIGNMENT_STRATEGY,
+    notifications: DEFAULT_NOTIFICATION_CONFIG,
+    limits: DEFAULT_ASSIGNMENT_LIMITS,
+};
+//# sourceMappingURL=auto-assign.types.js.map

package/dist/cli/backend/src/types/auto-assign.types.js.map

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

package/dist/cli/backend/src/types/budget.types.d.ts

@@ -0,0 +1,217 @@
+/**
+ * Budget Service Type Definitions
+ *
+ * Types for API usage tracking and budget management.
+ *
+ * @module types/budget.types
+ */
+/**
+ * Record of API usage for a single operation
+ */
+export interface UsageRecord {
+    /** Unique identifier for the agent */
+    agentId: string;
+    /** Session name of the agent */
+    sessionName: string;
+    /** Project path */
+    projectPath: string;
+    /** Timestamp of the usage */
+    timestamp: string;
+    /** Number of input tokens used */
+    inputTokens: number;
+    /** Number of output tokens generated */
+    outputTokens: number;
+    /** Model used for the operation */
+    model: string;
+    /** Type of operation (task, continuation, memory, etc.) */
+    operation: BudgetOperationType;
+    /** Associated task ID, if applicable */
+    taskId?: string;
+    /** Estimated cost in USD (calculated after recording) */
+    estimatedCost?: number;
+}
+/**
+ * Types of budget operations
+ */
+export type BudgetOperationType = 'task' | 'continuation' | 'memory' | 'sop' | 'quality_gate' | 'prompt_building' | 'other';
+/**
+ * Summary of usage over a period
+ */
+export interface UsageSummary {
+    /** Total input tokens used */
+    totalInputTokens: number;
+    /** Total output tokens generated */
+    totalOutputTokens: number;
+    /** Total tokens (input + output) */
+    totalTokens: number;
+    /** Estimated cost in USD */
+    estimatedCost: number;
+    /** Breakdown by operation type */
+    operationBreakdown: Record<string, number>;
+    /** Breakdown by model */
+    modelBreakdown: Record<string, number>;
+}
+/**
+ * Scope of budget configuration
+ */
+export type BudgetScope = 'global' | 'project' | 'agent';
+/**
+ * Budget configuration
+ */
+export interface BudgetConfig {
+    /** Scope of the budget (global, project, or agent) */
+    scope: BudgetScope;
+    /** Identifier for the scope (project path or agent ID) */
+    scopeId: string;
+    /** Daily spending limit in USD */
+    dailyLimit?: number;
+    /** Weekly spending limit in USD */
+    weeklyLimit?: number;
+    /** Monthly spending limit in USD */
+    monthlyLimit?: number;
+    /** Maximum tokens per task */
+    maxTokensPerTask?: number;
+    /** Percentage (0-1) at which to trigger warning */
+    warningThreshold: number;
+}
+/**
+ * Current budget status
+ */
+export interface BudgetStatus {
+    /** Whether usage is within budget */
+    withinBudget: boolean;
+    /** Amount used today in USD */
+    dailyUsed: number;
+    /** Daily limit in USD */
+    dailyLimit: number;
+    /** Percentage of budget used (0-1) */
+    percentUsed: number;
+    /** Estimated remaining runway description */
+    estimatedRunway: string;
+}
+/**
+ * Budget alert types
+ */
+export type BudgetAlertType = 'warning' | 'exceeded';
+/**
+ * Budget alert event
+ */
+export interface BudgetAlert {
+    /** Type of alert */
+    type: BudgetAlertType;
+    /** Scope of the budget */
+    scope: BudgetScope;
+    /** Scope identifier */
+    scopeId: string;
+    /** Current usage in USD */
+    currentUsage: number;
+    /** Budget limit in USD */
+    limit: number;
+    /** Timestamp of the alert */
+    timestamp: string;
+}
+/**
+ * Time period for reports
+ */
+export type BudgetPeriod = 'day' | 'week' | 'month';
+/**
+ * Parameters for generating a budget report
+ */
+export interface ReportParams {
+    /** Time period to report on */
+    period: BudgetPeriod;
+    /** Optional project path to filter by */
+    projectPath?: string;
+    /** Optional agent ID to filter by */
+    agentId?: string;
+}
+/**
+ * Agent usage summary for reports
+ */
+export interface AgentUsageSummary extends UsageSummary {
+    /** Agent identifier */
+    agentId: string;
+}
+/**
+ * Complete budget report
+ */
+export interface BudgetReport {
+    /** Time period covered */
+    period: BudgetPeriod;
+    /** When the report was generated */
+    generatedAt: string;
+    /** Total cost in USD */
+    totalCost: number;
+    /** Total tokens used */
+    totalTokens: number;
+    /** Breakdown by agent */
+    agentBreakdown: AgentUsageSummary[];
+}
+/**
+ * Stored budget configuration file format
+ */
+export interface BudgetConfigFile {
+    /** Global budget settings */
+    global?: Omit<BudgetConfig, 'scope' | 'scopeId'>;
+    /** Project-specific budgets */
+    projects?: Record<string, Omit<BudgetConfig, 'scope' | 'scopeId'>>;
+    /** Agent-specific budgets */
+    agents?: Record<string, Omit<BudgetConfig, 'scope' | 'scopeId'>>;
+}
+/**
+ * Token cost rates per model
+ */
+export interface TokenCostRates {
+    /** Cost per input token in USD */
+    input: number;
+    /** Cost per output token in USD */
+    output: number;
+}
+/**
+ * Budget-related constants
+ */
+export declare const BUDGET_CONSTANTS: {
+    /** Default configuration values */
+    readonly DEFAULTS: {
+        readonly DAILY_LIMIT: 50;
+        readonly WEEKLY_LIMIT: 200;
+        readonly MONTHLY_LIMIT: 500;
+        readonly WARNING_THRESHOLD: 0.8;
+        readonly MAX_TOKENS_PER_TASK: 100000;
+    };
+    /** Token cost rates by model (USD per token) */
+    readonly TOKEN_COSTS: Record<string, TokenCostRates>;
+    /** File paths */
+    readonly PATHS: {
+        readonly USAGE_DIR: "usage";
+        readonly BUDGETS_FILE: "budgets.json";
+        readonly BUDGETS_YAML_FILE: "budgets.yaml";
+    };
+    /** Operation types */
+    readonly OPERATIONS: {
+        readonly TASK: BudgetOperationType;
+        readonly CONTINUATION: BudgetOperationType;
+        readonly MEMORY: BudgetOperationType;
+        readonly SOP: BudgetOperationType;
+        readonly QUALITY_GATE: BudgetOperationType;
+        readonly PROMPT_BUILDING: BudgetOperationType;
+        readonly OTHER: BudgetOperationType;
+    };
+};
+/**
+ * Default global budget configuration
+ */
+export declare const DEFAULT_BUDGET_CONFIG: BudgetConfig;
+/**
+ * All budget operation types
+ */
+export declare const ALL_BUDGET_OPERATIONS: BudgetOperationType[];
+/**
+ * All budget scopes
+ */
+export declare const ALL_BUDGET_SCOPES: BudgetScope[];
+/**
+ * All budget periods
+ */
+export declare const ALL_BUDGET_PERIODS: BudgetPeriod[];
+//# sourceMappingURL=budget.types.d.ts.map

package/dist/cli/backend/src/types/budget.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.types.d.ts","sourceRoot":"","sources":["../../../../../backend/src/types/budget.types.ts"],"names":[],"mappings":"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"}