crewly 1.5.18 → 1.5.19

package/dist/backend/backend/src/types/v2/reconcile.types.js

@@ -0,0 +1,121 @@
+/**
+ * V2 Reconciler Type Definitions
+ *
+ * The Reconciler is the "CPU" of Crewly V3 — it periodically recomputes
+ * system truth from durable state, not trusting event delivery.
+ * These types define its outputs and configuration.
+ *
+ * @module types/v2/reconcile.types
+ */
+/** All valid ReconcileType values. */
+export const RECONCILE_TYPES = [
+    'full',
+    'targeted_request',
+    'targeted_mission',
+    'fast',
+];
+/**
+ * Default Reconciler configuration values.
+ * Performance budget: single reconcile < 3s (CEO requirement).
+ */
+export const DEFAULT_RECONCILER_CONFIG = {
+    fastLoopIntervalMs: 10_000, // 10 seconds
+    fullLoopIntervalMs: 60_000, // 60 seconds
+    maxReconcileDurationMs: 3_000, // 3 seconds performance budget
+    workItemTimeoutMs: 600_000, // 10 minutes
+    maxHistorySize: 100,
+    eventTriggeredEnabled: true,
+};
+// ---------------------------------------------------------------------------
+// Type Guards
+// ---------------------------------------------------------------------------
+/**
+ * Checks whether a string is a valid ReconcileType.
+ *
+ * @param value - The string to check
+ * @returns True if value is a valid ReconcileType
+ */
+export function isValidReconcileType(value) {
+    return RECONCILE_TYPES.includes(value);
+}
+/**
+ * Validates that an unknown value is structurally a valid ReconcileResult.
+ *
+ * @param value - Unknown value to validate
+ * @returns True if value conforms to the ReconcileResult interface
+ */
+export function isReconcileResult(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    return (typeof obj.requestsUpdated === 'number' &&
+        typeof obj.workItemsTimedOut === 'number' &&
+        typeof obj.workItemsRequeued === 'number' &&
+        typeof obj.claimsRevoked === 'number' &&
+        typeof obj.triggersRebuilt === 'number' &&
+        typeof obj.staleItemsCleaned === 'number' &&
+        typeof obj.reconciledAt === 'string' &&
+        typeof obj.durationMs === 'number' &&
+        typeof obj.type === 'string' &&
+        isValidReconcileType(obj.type) &&
+        typeof obj.agentsWoken === 'number' &&
+        Array.isArray(obj.corrections) &&
+        Array.isArray(obj.wakeActions) &&
+        Array.isArray(obj.errors));
+}
+/**
+ * Validates that an unknown value is a valid ReconcilerConfig.
+ *
+ * @param value - Unknown value to validate
+ * @returns True if value conforms to ReconcilerConfig
+ */
+export function isValidReconcilerConfig(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    return (typeof obj.fastLoopIntervalMs === 'number' && obj.fastLoopIntervalMs > 0 &&
+        typeof obj.fullLoopIntervalMs === 'number' && obj.fullLoopIntervalMs > 0 &&
+        typeof obj.maxReconcileDurationMs === 'number' && obj.maxReconcileDurationMs > 0 &&
+        typeof obj.workItemTimeoutMs === 'number' && obj.workItemTimeoutMs > 0 &&
+        typeof obj.maxHistorySize === 'number' && obj.maxHistorySize > 0 &&
+        typeof obj.eventTriggeredEnabled === 'boolean');
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates an empty ReconcileResult for a new reconciliation pass.
+ *
+ * @param type - The type of reconciliation being performed
+ * @returns A ReconcileResult with all counters at zero
+ */
+export function createEmptyReconcileResult(type) {
+    return {
+        requestsUpdated: 0,
+        workItemsTimedOut: 0,
+        workItemsRequeued: 0,
+        claimsRevoked: 0,
+        triggersRebuilt: 0,
+        staleItemsCleaned: 0,
+        agentsWoken: 0,
+        reconciledAt: new Date().toISOString(),
+        durationMs: 0,
+        type,
+        corrections: [],
+        wakeActions: [],
+        errors: [],
+    };
+}
+/**
+ * Creates a ReconcileCorrection entry.
+ *
+ * @param params - Correction details
+ * @returns A fully populated ReconcileCorrection
+ */
+export function createCorrection(params) {
+    return {
+        ...params,
+        correctedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=reconcile.types.js.map

package/dist/backend/backend/src/types/v2/reconcile.types.js.map

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

package/dist/backend/backend/src/types/v2/request.types.d.ts

@@ -0,0 +1,188 @@
+/**
+ * V2 Request Type Definitions
+ *
+ * A Request represents a single user goal — "one thing the user wants
+ * the system to accomplish." Requests are the primary user-facing object
+ * in V2 architecture.
+ *
+ * @module types/v2/request.types
+ */
+/**
+ * Lifecycle statuses for a Request.
+ *
+ * State machine:
+ *   open → ready                  (planner created WorkItems)
+ *   open → cancelled              (user cancelled before planning)
+ *   ready → running               (first WorkItem started)
+ *   running → blocked             (all active WorkItems blocked/failed)
+ *   running → waiting_confirmation (all done, requiresConfirmation=true)
+ *   running → done                (all done, requiresConfirmation=false)
+ *   blocked → running             (WorkItem unblocked or new WorkItem created)
+ *   waiting_confirmation → done   (user confirmed)
+ *   waiting_confirmation → running (user rejected, new WorkItems needed)
+ *   any → cancelled               (user explicitly cancels)
+ */
+export type RequestStatus = 'open' | 'ready' | 'running' | 'blocked' | 'waiting_confirmation' | 'done' | 'cancelled';
+/** All valid RequestStatus values as a readonly array. */
+export declare const REQUEST_STATUSES: readonly RequestStatus[];
+/** Terminal statuses — no further transitions allowed (except cancel). */
+export declare const TERMINAL_REQUEST_STATUSES: ReadonlySet<RequestStatus>;
+/**
+ * Intent category carried from v1 IntentTask system.
+ */
+export type IntentCategory = 'query' | 'code_change' | 'debugging' | 'deployment' | 'research' | 'review' | 'planning' | 'communication' | 'other';
+/** All valid IntentCategory values. */
+export declare const INTENT_CATEGORIES: readonly IntentCategory[];
+/**
+ * Intent complexity level — determines planning strategy.
+ * - L0: trivial, no WorkItem needed (direct response)
+ * - L1: single WorkItem sufficient
+ * - L2: multiple WorkItems, potentially parallel
+ */
+export type IntentLevel = 'L0' | 'L1' | 'L2';
+/**
+ * A user-level request representing a single goal.
+ *
+ * Requests are the primary unit of work visible to users.
+ * Each Request is fulfilled through one or more WorkItems.
+ */
+export interface Request {
+    /** UUID v4 */
+    id: string;
+    /** ConversationItem that originated this Request */
+    sourceConversationItemId: string;
+    /** Human-readable title (generated from intent parsing) */
+    title: string;
+    /** Detailed description of what the user wants */
+    description: string;
+    /** Lifecycle status */
+    status: RequestStatus;
+    /** User-assigned or auto-classified priority */
+    priority: 'low' | 'normal' | 'high';
+    /** Whether completion requires explicit user confirmation */
+    requiresConfirmation: boolean;
+    /** Reason confirmation is needed (shown to user) */
+    confirmationReason?: string;
+    /** WorkItem IDs created to fulfill this Request */
+    workItemIds: string[];
+    /** Optional link to a Mission this Request contributes to */
+    missionId?: string;
+    /** Optional link to a ProjectTask created from this Request */
+    projectTaskId?: string;
+    /** Intent complexity level */
+    intentLevel: IntentLevel;
+    /** Intent category */
+    intentCategory: IntentCategory;
+    /** Tags for filtering */
+    tags: string[];
+    /** ISO8601 timestamps */
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+    /** Result summary (set on completion) */
+    result?: string;
+    /** Total token usage across all WorkItems */
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    /** Total cost in USD */
+    totalCost: number;
+    /** Session name of the agent that handled this Request directly (no WorkItem delegation) */
+    ownerAgent?: string;
+}
+/**
+ * Input for creating a new Request.
+ * Fields with defaults are optional.
+ */
+export interface CreateRequestInput {
+    sourceConversationItemId: string;
+    title: string;
+    description: string;
+    priority?: 'low' | 'normal' | 'high';
+    requiresConfirmation?: boolean;
+    confirmationReason?: string;
+    missionId?: string;
+    intentLevel?: IntentLevel;
+    intentCategory?: IntentCategory;
+    tags?: string[];
+}
+/**
+ * Input for updating an existing Request.
+ * All fields optional — only provided fields are updated.
+ */
+export interface UpdateRequestInput {
+    title?: string;
+    description?: string;
+    status?: RequestStatus;
+    priority?: 'low' | 'normal' | 'high';
+    requiresConfirmation?: boolean;
+    confirmationReason?: string;
+    missionId?: string;
+    projectTaskId?: string;
+    result?: string;
+    tags?: string[];
+    /** Token roll-up fields — incremented by V3.1 task completion hooks */
+    totalInputTokens?: number;
+    totalOutputTokens?: number;
+    totalCost?: number;
+    /** Session name of the agent that handled this Request directly */
+    ownerAgent?: string;
+}
+/**
+ * Map of valid status transitions.
+ * Key = current status, Value = set of allowed next statuses.
+ */
+export declare const REQUEST_TRANSITIONS: Record<RequestStatus, ReadonlySet<RequestStatus>>;
+/**
+ * Checks whether a string is a valid RequestStatus.
+ *
+ * @param value - The string to check
+ * @returns True if value is a valid RequestStatus
+ */
+export declare function isValidRequestStatus(value: string): value is RequestStatus;
+/**
+ * Checks whether a string is a valid IntentCategory.
+ *
+ * @param value - The string to check
+ * @returns True if value is a valid IntentCategory
+ */
+export declare function isValidIntentCategory(value: string): value is IntentCategory;
+/**
+ * Checks whether a status transition is valid according to the state machine.
+ *
+ * @param from - Current status
+ * @param to - Desired next status
+ * @returns True if transition is allowed
+ */
+export declare function isValidRequestTransition(from: RequestStatus, to: RequestStatus): boolean;
+/**
+ * Validates that an object is structurally a valid Request.
+ *
+ * @param value - Unknown value to validate
+ * @returns True if value conforms to the Request interface
+ */
+export declare function isRequest(value: unknown): value is Request;
+/**
+ * Validates CreateRequestInput and returns an array of error messages.
+ * Empty array means input is valid.
+ *
+ * @param input - The creation input to validate
+ * @returns Array of validation error strings (empty = valid)
+ */
+export declare function validateCreateRequestInput(input: CreateRequestInput): string[];
+/**
+ * Creates a new Request with sensible defaults.
+ *
+ * @param input - Required and optional creation fields
+ * @returns A fully populated Request object
+ *
+ * @example
+ * ```typescript
+ * const request = createRequest({
+ *   sourceConversationItemId: 'conv-123',
+ *   title: 'Deploy staging',
+ *   description: 'Deploy the current build to staging env',
+ * });
+ * ```
+ */
+export declare function createRequest(input: CreateRequestInput): Request;
+//# sourceMappingURL=request.types.d.ts.map

package/dist/backend/backend/src/types/v2/request.types.d.ts.map

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

package/dist/backend/backend/src/types/v2/request.types.js

@@ -0,0 +1,178 @@
+/**
+ * V2 Request Type Definitions
+ *
+ * A Request represents a single user goal — "one thing the user wants
+ * the system to accomplish." Requests are the primary user-facing object
+ * in V2 architecture.
+ *
+ * @module types/v2/request.types
+ */
+import { v4 as uuidv4 } from 'uuid';
+/** All valid RequestStatus values as a readonly array. */
+export const REQUEST_STATUSES = [
+    'open',
+    'ready',
+    'running',
+    'blocked',
+    'waiting_confirmation',
+    'done',
+    'cancelled',
+];
+/** Terminal statuses — no further transitions allowed (except cancel). */
+export const TERMINAL_REQUEST_STATUSES = new Set([
+    'done',
+    'cancelled',
+]);
+/** All valid IntentCategory values. */
+export const INTENT_CATEGORIES = [
+    'query',
+    'code_change',
+    'debugging',
+    'deployment',
+    'research',
+    'review',
+    'planning',
+    'communication',
+    'other',
+];
+// ---------------------------------------------------------------------------
+// Valid State Transitions
+// ---------------------------------------------------------------------------
+/**
+ * Map of valid status transitions.
+ * Key = current status, Value = set of allowed next statuses.
+ */
+export const REQUEST_TRANSITIONS = {
+    open: new Set(['ready', 'done', 'cancelled']),
+    ready: new Set(['running', 'cancelled']),
+    running: new Set(['blocked', 'waiting_confirmation', 'done', 'cancelled']),
+    blocked: new Set(['running', 'cancelled']),
+    waiting_confirmation: new Set(['done', 'running', 'cancelled']),
+    done: new Set(),
+    cancelled: new Set(),
+};
+// ---------------------------------------------------------------------------
+// Type Guards
+// ---------------------------------------------------------------------------
+/**
+ * Checks whether a string is a valid RequestStatus.
+ *
+ * @param value - The string to check
+ * @returns True if value is a valid RequestStatus
+ */
+export function isValidRequestStatus(value) {
+    return REQUEST_STATUSES.includes(value);
+}
+/**
+ * Checks whether a string is a valid IntentCategory.
+ *
+ * @param value - The string to check
+ * @returns True if value is a valid IntentCategory
+ */
+export function isValidIntentCategory(value) {
+    return INTENT_CATEGORIES.includes(value);
+}
+/**
+ * Checks whether a status transition is valid according to the state machine.
+ *
+ * @param from - Current status
+ * @param to - Desired next status
+ * @returns True if transition is allowed
+ */
+export function isValidRequestTransition(from, to) {
+    return REQUEST_TRANSITIONS[from].has(to);
+}
+/**
+ * Validates that an object is structurally a valid Request.
+ *
+ * @param value - Unknown value to validate
+ * @returns True if value conforms to the Request interface
+ */
+export function isRequest(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    return (typeof obj.id === 'string' &&
+        typeof obj.sourceConversationItemId === 'string' &&
+        typeof obj.title === 'string' &&
+        typeof obj.description === 'string' &&
+        typeof obj.status === 'string' &&
+        isValidRequestStatus(obj.status) &&
+        typeof obj.createdAt === 'string' &&
+        typeof obj.updatedAt === 'string' &&
+        Array.isArray(obj.workItemIds));
+}
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+/**
+ * Validates CreateRequestInput and returns an array of error messages.
+ * Empty array means input is valid.
+ *
+ * @param input - The creation input to validate
+ * @returns Array of validation error strings (empty = valid)
+ */
+export function validateCreateRequestInput(input) {
+    const errors = [];
+    if (!input.sourceConversationItemId || typeof input.sourceConversationItemId !== 'string') {
+        errors.push('sourceConversationItemId is required and must be a string');
+    }
+    if (!input.title || typeof input.title !== 'string') {
+        errors.push('title is required and must be a non-empty string');
+    }
+    if (!input.description || typeof input.description !== 'string') {
+        errors.push('description is required and must be a non-empty string');
+    }
+    if (input.priority && !['low', 'normal', 'high'].includes(input.priority)) {
+        errors.push('priority must be one of: low, normal, high');
+    }
+    if (input.intentCategory && !isValidIntentCategory(input.intentCategory)) {
+        errors.push(`intentCategory must be one of: ${INTENT_CATEGORIES.join(', ')}`);
+    }
+    if (input.intentLevel && !['L0', 'L1', 'L2'].includes(input.intentLevel)) {
+        errors.push('intentLevel must be one of: L0, L1, L2');
+    }
+    return errors;
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a new Request with sensible defaults.
+ *
+ * @param input - Required and optional creation fields
+ * @returns A fully populated Request object
+ *
+ * @example
+ * ```typescript
+ * const request = createRequest({
+ *   sourceConversationItemId: 'conv-123',
+ *   title: 'Deploy staging',
+ *   description: 'Deploy the current build to staging env',
+ * });
+ * ```
+ */
+export function createRequest(input) {
+    const now = new Date().toISOString();
+    return {
+        id: uuidv4(),
+        sourceConversationItemId: input.sourceConversationItemId,
+        title: input.title,
+        description: input.description,
+        status: 'open',
+        priority: input.priority ?? 'normal',
+        requiresConfirmation: input.requiresConfirmation ?? false,
+        confirmationReason: input.confirmationReason,
+        workItemIds: [],
+        missionId: input.missionId,
+        intentLevel: input.intentLevel ?? 'L1',
+        intentCategory: input.intentCategory ?? 'other',
+        tags: input.tags ?? [],
+        createdAt: now,
+        updatedAt: now,
+        totalInputTokens: 0,
+        totalOutputTokens: 0,
+        totalCost: 0,
+    };
+}
+//# sourceMappingURL=request.types.js.map

package/dist/backend/backend/src/types/v2/request.types.js.map

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