crewly 1.5.18 → 1.5.20

package/dist/cli/backend/src/types/v2/trigger.types.js

@@ -0,0 +1,174 @@
+/**
+ * V2 Trigger Type Definitions
+ *
+ * Triggers unify v1's ScheduledMessage, CronTask, and EventSubscription
+ * into a single time/signal/compound mechanism that creates or wakes WorkItems.
+ *
+ * @module types/v2/trigger.types
+ */
+import { v4 as uuidv4 } from 'uuid';
+/** All valid TriggerType values. */
+export const TRIGGER_TYPES = ['time', 'signal', 'compound'];
+/** All valid TriggerStatus values. */
+export const TRIGGER_STATUSES = [
+    'active',
+    'paused',
+    'exhausted',
+    'cancelled',
+];
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Default max idle fires before auto-cancel. From v1 issue #131 lesson. */
+export const DEFAULT_MAX_IDLE_FIRES = 3;
+// ---------------------------------------------------------------------------
+// Type Guards
+// ---------------------------------------------------------------------------
+/**
+ * Checks whether a string is a valid TriggerType.
+ *
+ * @param value - The string to check
+ * @returns True if value is a valid TriggerType
+ */
+export function isValidTriggerType(value) {
+    return TRIGGER_TYPES.includes(value);
+}
+/**
+ * Checks whether a string is a valid TriggerStatus.
+ *
+ * @param value - The string to check
+ * @returns True if value is a valid TriggerStatus
+ */
+export function isValidTriggerStatus(value) {
+    return TRIGGER_STATUSES.includes(value);
+}
+/**
+ * Validates that a trigger config's type field matches its parent type.
+ *
+ * @param config - The config to validate
+ * @returns True if the config is internally consistent
+ */
+export function isValidTriggerConfig(config) {
+    if (!config || typeof config !== 'object')
+        return false;
+    switch (config.type) {
+        case 'time':
+            return !!(config.cronExpression || config.delayMs || config.fireAt);
+        case 'signal':
+            return typeof config.eventType === 'string' && config.eventType.length > 0;
+        case 'compound':
+            return ((config.operator === 'and' || config.operator === 'or') &&
+                Array.isArray(config.conditions) &&
+                config.conditions.length > 0);
+        default:
+            return false;
+    }
+}
+/**
+ * Validates that an unknown value is structurally a valid Trigger.
+ *
+ * @param value - Unknown value to validate
+ * @returns True if value conforms to the Trigger interface
+ */
+export function isTrigger(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    return (typeof obj.id === 'string' &&
+        typeof obj.type === 'string' &&
+        isValidTriggerType(obj.type) &&
+        typeof obj.status === 'string' &&
+        isValidTriggerStatus(obj.status) &&
+        typeof obj.createdAt === 'string' &&
+        typeof obj.fireCount === 'number' &&
+        typeof obj.maxIdleFires === 'number');
+}
+/**
+ * Checks whether a TriggerAction has at least one action defined.
+ *
+ * @param action - The action to validate
+ * @returns True if at least one action field is set
+ */
+export function isValidTriggerAction(action) {
+    if (!action || typeof action !== 'object')
+        return false;
+    return !!(action.createWorkItem ||
+        action.wakeWorkItemId ||
+        action.sendMessage ||
+        action.runReconciler);
+}
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+/**
+ * Validates CreateTriggerInput and returns an array of error messages.
+ *
+ * @param input - The creation input to validate
+ * @returns Array of validation error strings (empty = valid)
+ */
+export function validateCreateTriggerInput(input) {
+    const errors = [];
+    if (!input.type || !isValidTriggerType(input.type)) {
+        errors.push(`type must be one of: ${TRIGGER_TYPES.join(', ')}`);
+    }
+    if (!input.config) {
+        errors.push('config is required');
+    }
+    else if (!isValidTriggerConfig(input.config)) {
+        errors.push('config is invalid for the given trigger type');
+    }
+    if (!input.action) {
+        errors.push('action is required');
+    }
+    else if (!isValidTriggerAction(input.action)) {
+        errors.push('action must have at least one action field set');
+    }
+    if (!input.createdBy) {
+        errors.push('createdBy is required');
+    }
+    if (input.maxFires !== undefined && (input.maxFires < 1 || !Number.isInteger(input.maxFires))) {
+        errors.push('maxFires must be a positive integer');
+    }
+    if (input.maxIdleFires !== undefined && (input.maxIdleFires < 1 || !Number.isInteger(input.maxIdleFires))) {
+        errors.push('maxIdleFires must be a positive integer');
+    }
+    return errors;
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a new Trigger with sensible defaults.
+ *
+ * @param input - Required and optional creation fields
+ * @returns A fully populated Trigger object
+ *
+ * @example
+ * ```typescript
+ * const trigger = createTrigger({
+ *   type: 'time',
+ *   config: { type: 'time', cronExpression: '0 9 * * 1' },
+ *   action: { runReconciler: true },
+ *   createdBy: 'system',
+ * });
+ * ```
+ */
+export function createTrigger(input) {
+    const now = new Date().toISOString();
+    return {
+        id: uuidv4(),
+        type: input.type,
+        config: input.config,
+        action: input.action,
+        status: 'active',
+        createdBy: input.createdBy,
+        createdAt: now,
+        fireCount: 0,
+        maxFires: input.maxFires,
+        maxIdleFires: input.maxIdleFires ?? DEFAULT_MAX_IDLE_FIRES,
+        consecutiveIdleFires: 0,
+        teamId: input.teamId,
+        name: input.name,
+    };
+}
+//# sourceMappingURL=trigger.types.js.map

package/dist/cli/backend/src/types/v2/trigger.types.js.map

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

package/dist/cli/backend/src/types/v2/work-item.types.d.ts

@@ -0,0 +1,333 @@
+/**
+ * V2 WorkItem Type Definitions
+ *
+ * A WorkItem is the unified execution primitive. Every action the system
+ * takes to fulfill a Request or advance a Mission materializes as a WorkItem.
+ * This replaces v1's separate delegation, scheduled-message, and event-subscription concepts.
+ *
+ * @module types/v2/work-item.types
+ */
+/**
+ * Execution type — determines handler and behavior.
+ */
+export type WorkItemType = 'delegate' | 'project_task' | 'check' | 'notify' | 'cron_run' | 'review' | 'confirm' | 'reconcile';
+/** All valid WorkItemType values. */
+export declare const WORK_ITEM_TYPES: readonly WorkItemType[];
+/**
+ * Who is responsible for execution.
+ */
+export type WorkItemOwner = 'orchestrator' | 'team_lead' | 'agent' | 'system';
+/** All valid WorkItemOwner values. */
+export declare const WORK_ITEM_OWNERS: readonly WorkItemOwner[];
+/**
+ * Lifecycle statuses for a WorkItem.
+ *
+ * State machine (extended with acceptance/verification flow):
+ *
+ *   --- Creation & Scheduling ---
+ *   queued → running          (executor picks up item — simple tasks)
+ *   queued → proposed         (TL sends task contract to worker)
+ *   queued → scheduled        (has future scheduledAt)
+ *   queued → cancelled        (parent cancelled)
+ *   scheduled → queued        (scheduledAt reached, trigger fires)
+ *
+ *   --- Acceptance Handshake ---
+ *   proposed → accepted       (worker confirms understanding)
+ *   proposed → rejected       (worker cannot accept — wrong fit, unclear, etc.)
+ *   proposed → cancelled      (parent cancelled before acceptance)
+ *   accepted → running        (worker begins execution)
+ *   rejected → queued         (TL reassigns or re-scopes)
+ *
+ *   --- Execution ---
+ *   running → done_by_worker  (worker reports completion, pending TL verification)
+ *   running → failed          (execution failed, retries exhausted)
+ *   running → blocked         (waiting on dependency)
+ *   running → escalated       (worker escalates — scope/risk/ambiguity)
+ *   running → cancelled       (parent cancelled during execution)
+ *
+ *   --- Verification ---
+ *   done_by_worker → verified (TL verifies and accepts)
+ *   done_by_worker → rejected (TL rejects — needs rework)
+ *   rejected → queued         (re-queue for retry/reassignment)
+ *   escalated → queued        (TL/human resolves and re-queues)
+ *   escalated → cancelled     (escalation results in cancellation)
+ *
+ *   --- Recovery ---
+ *   blocked → queued          (dependency resolved, re-queue)
+ *   failed → queued           (manual retry or reconciler recovery)
+ *
+ *   --- Legacy Compatibility ---
+ *   running → done            (simple tasks without TL verification)
+ *   done is terminal (backward compatible with existing pool operations)
+ */
+export type WorkItemStatus = 'queued' | 'scheduled' | 'proposed' | 'accepted' | 'running' | 'blocked' | 'escalated' | 'done_by_worker' | 'verified' | 'rejected' | 'done' | 'failed' | 'cancelled';
+/** All valid WorkItemStatus values. */
+export declare const WORK_ITEM_STATUSES: readonly WorkItemStatus[];
+/** Terminal statuses — no further transitions allowed. */
+export declare const TERMINAL_WORK_ITEM_STATUSES: ReadonlySet<WorkItemStatus>;
+/**
+ * A single unit of system execution.
+ *
+ * WorkItems are the internal execution primitive — users rarely see them directly.
+ * They unify what v1 had as separate concepts: delegations, scheduled messages,
+ * event subscriptions, cron runs, and checks.
+ */
+export interface WorkItem {
+    /** UUID v4 */
+    id: string;
+    /** Parent Request (undefined for Mission-generated items) */
+    requestId?: string;
+    /** Parent WorkItem for sub-tasks / retries */
+    parentWorkItemId?: string;
+    /** Execution type — determines handler and behavior */
+    type: WorkItemType;
+    /** Who is responsible for execution */
+    owner: WorkItemOwner;
+    /** Target agent session, team, or system component */
+    target?: string;
+    /** Human-readable title */
+    title: string;
+    /** Detailed instructions or description */
+    description?: string;
+    /** Lifecycle status */
+    status: WorkItemStatus;
+    /** When this item should execute (null = immediately) */
+    scheduledAt?: string;
+    /** ISO8601 timestamps */
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    /** Execution result data */
+    result?: Record<string, unknown>;
+    /** Error details if failed */
+    error?: string;
+    /** Number of retry attempts so far */
+    retryCount: number;
+    /** Maximum retries before permanent failure */
+    maxRetries: number;
+    /** Trigger ID that created or will wake this WorkItem */
+    triggerId?: string;
+    /** Link to ProjectTask (for durable project work) */
+    projectTaskId?: string;
+    /** Link to Mission (for autonomy-generated work) */
+    missionId?: string;
+    /** Token usage for this specific WorkItem */
+    inputTokens: number;
+    outputTokens: number;
+    /** Cost in USD for this WorkItem */
+    cost: number;
+    /** Extensible metadata (dependency tracking, skill requirements, etc.) */
+    metadata?: Record<string, unknown>;
+    /**
+     * IDs of upstream WorkItems that must reach terminal success (`done` or
+     * `verified`) before this item is allowed to run. When any dep is still
+     * pending at creation time, the item starts in `blocked` status and is
+     * auto-promoted to `queued` by the TaskPool resolver once every dep
+     * completes.
+     */
+    dependsOn?: string[];
+}
+/**
+ * Input for creating a new WorkItem.
+ */
+export interface CreateWorkItemInput {
+    requestId?: string;
+    parentWorkItemId?: string;
+    type: WorkItemType;
+    owner: WorkItemOwner;
+    target?: string;
+    title: string;
+    description?: string;
+    scheduledAt?: string;
+    maxRetries?: number;
+    triggerId?: string;
+    projectTaskId?: string;
+    missionId?: string;
+    metadata?: Record<string, unknown>;
+    /** Upstream WorkItem IDs that must reach terminal success before this runs. */
+    dependsOn?: string[];
+}
+/**
+ * Input for updating an existing WorkItem.
+ */
+export interface UpdateWorkItemInput {
+    status?: WorkItemStatus;
+    target?: string;
+    result?: Record<string, unknown>;
+    error?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    cost?: number;
+}
+/**
+ * Map of valid status transitions for WorkItems.
+ *
+ * Includes both the original simple flow (queued→running→done) and
+ * the extended acceptance/verification flow (proposed→accepted→running→done_by_worker→verified).
+ */
+export declare const WORK_ITEM_TRANSITIONS: Record<WorkItemStatus, ReadonlySet<WorkItemStatus>>;
+/**
+ * Defines which roles are allowed to trigger specific status transitions.
+ *
+ * Format: `from→to` key maps to a set of allowed WorkItemOwner roles.
+ * If a transition is not listed here, any role may trigger it (backward compatible).
+ * The 'system' role (reconciler) can always trigger any valid transition.
+ */
+export declare const TRANSITION_PERMISSIONS: Record<string, ReadonlySet<WorkItemOwner>>;
+/**
+ * Checks whether a role is permitted to trigger a specific status transition.
+ *
+ * If no explicit permission is defined for a transition, it is considered
+ * open to all roles (backward compatible). The 'system' role always has
+ * permission for any valid transition.
+ *
+ * @param from - Current status
+ * @param to - Desired next status
+ * @param actorRole - Role of the agent/system attempting the transition
+ * @returns True if the role is permitted to trigger this transition
+ */
+export declare function isTransitionPermitted(from: WorkItemStatus, to: WorkItemStatus, actorRole: WorkItemOwner): boolean;
+/**
+ * Checks whether a string is a valid WorkItemType.
+ *
+ * @param value - The string to check
+ * @returns True if value is a valid WorkItemType
+ */
+export declare function isValidWorkItemType(value: string): value is WorkItemType;
+/**
+ * Checks whether a string is a valid WorkItemStatus.
+ *
+ * @param value - The string to check
+ * @returns True if value is a valid WorkItemStatus
+ */
+export declare function isValidWorkItemStatus(value: string): value is WorkItemStatus;
+/**
+ * Checks whether a string is a valid WorkItemOwner.
+ *
+ * @param value - The string to check
+ * @returns True if value is a valid WorkItemOwner
+ */
+export declare function isValidWorkItemOwner(value: string): value is WorkItemOwner;
+/**
+ * Checks whether a WorkItem status transition is valid.
+ *
+ * @param from - Current status
+ * @param to - Desired next status
+ * @returns True if transition is allowed
+ */
+export declare function isValidWorkItemTransition(from: WorkItemStatus, to: WorkItemStatus): boolean;
+/**
+ * Validates that an unknown value is structurally a valid WorkItem.
+ *
+ * @param value - Unknown value to validate
+ * @returns True if value conforms to the WorkItem interface
+ */
+export declare function isWorkItem(value: unknown): value is WorkItem;
+/**
+ * Validates CreateWorkItemInput and returns an array of error messages.
+ *
+ * @param input - The creation input to validate
+ * @returns Array of validation error strings (empty = valid)
+ */
+export declare function validateCreateWorkItemInput(input: CreateWorkItemInput): string[];
+/** Default max retries for WorkItems. */
+export declare const DEFAULT_MAX_RETRIES = 3;
+/**
+ * Creates a new WorkItem with sensible defaults.
+ *
+ * @param input - Required and optional creation fields
+ * @returns A fully populated WorkItem object
+ *
+ * @example
+ * ```typescript
+ * const workItem = createWorkItem({
+ *   type: 'delegate',
+ *   owner: 'agent',
+ *   target: 'crewly-product-leo-member-n',
+ *   title: 'Implement TaskPoolService',
+ * });
+ * ```
+ */
+export declare function createWorkItem(input: CreateWorkItemInput): WorkItem;
+/**
+ * Structured contract that a Team Lead sends when delegating a task.
+ *
+ * The worker must confirm understanding before execution begins.
+ * This prevents misaligned expectations and reduces costly late-stage rework.
+ */
+export interface TaskContract {
+    /** What the worker must achieve */
+    goal: string;
+    /** What is explicitly out of scope */
+    nonGoals: string[];
+    /** Specific, verifiable conditions for "done" */
+    acceptanceCriteria: string[];
+    /** Expected deliverable structure */
+    outputFormat: string;
+    /** When to stop and report back (time, complexity, risk thresholds) */
+    cutoffConditions: string[];
+    /** Situations that require immediate escalation */
+    escalationTriggers: string[];
+    /** If true, worker may skip classification gate and proceed directly */
+    preClassified?: boolean;
+}
+/**
+ * Worker's structured confirmation of a received Task Contract.
+ *
+ * TL reviews this before allowing the task to enter 'running' status.
+ */
+export interface TaskAcceptance {
+    /** Worker's understanding of the goal */
+    understoodGoal: string;
+    /** How the worker intends to accomplish it */
+    plannedApproach: string;
+    /** What the worker will NOT do */
+    outOfScope: string[];
+    /** Risks or blockers the worker foresees */
+    identifiedRisks: string[];
+}
+/** Target for an alignment request. */
+export type AlignmentTarget = 'team_lead' | 'human';
+/**
+ * Reason categories for why a worker cannot proceed with direct execution.
+ */
+export type AlignmentReason = 'scope_change' | 'priority_resource' | 'ownership_authority' | 'ambiguity_tradeoff' | 'high_risk';
+/**
+ * A structured escalation from a worker who determines that direct execution
+ * is inappropriate for the current task.
+ *
+ * This replaces unstructured "I'm blocked" messages with actionable information
+ * that enables fast decision-making by TLs or humans.
+ */
+export interface AlignmentRequest {
+    /** The task the worker was asked to do */
+    currentTask: string;
+    /** What triggered the escalation */
+    discoveredIssue: string;
+    /** Category of alignment needed */
+    reason: AlignmentReason;
+    /** Why direct execution is inappropriate */
+    whyCannotExecute: string;
+    /** 2-3 possible approaches with impact analysis */
+    options: AlignmentOption[];
+    /** Worker's recommended path */
+    recommendation: string;
+    /** What the TL/human needs to decide */
+    decisionNeeded: string;
+    /** Who should make this decision */
+    target: AlignmentTarget;
+}
+/**
+ * A single option in an Alignment Request.
+ */
+export interface AlignmentOption {
+    /** Brief description of the approach */
+    description: string;
+    /** Expected positive outcomes */
+    pros: string[];
+    /** Expected negative outcomes or risks */
+    cons: string[];
+    /** Estimated effort/impact level */
+    impact: 'low' | 'medium' | 'high';
+}
+//# sourceMappingURL=work-item.types.d.ts.map

package/dist/cli/backend/src/types/v2/work-item.types.d.ts.map

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