crewly 1.5.18 → 1.5.19

package/dist/backend/backend/src/services/fission/fission-guard.types.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Fission Guard Type Definitions
+ *
+ * Types for the FissionGuardService — prevents agents from creating
+ * unbounded sub-tasks. Implements 6 guardrails: maxDepth, maxTasks,
+ * rate limit, branching factor, TTL, and budget gate.
+ *
+ * @module services/fission/fission-guard.types
+ */
+/**
+ * Result of a fission guard check.
+ * Returned by canCreateSubTask() to indicate whether creation is allowed.
+ */
+export interface GuardResult {
+    /** Whether the sub-task creation is allowed */
+    allowed: boolean;
+    /** Human-readable reason when blocked */
+    reason?: string;
+    /** Which guardrail was violated (for programmatic handling) */
+    violationType?: FissionViolationType;
+}
+/**
+ * Types of fission violations.
+ */
+export type FissionViolationType = 'max_depth' | 'max_tasks' | 'rate_limit' | 'branching_factor' | 'ttl_exceeded' | 'budget_exceeded';
+/** All valid FissionViolationType values. */
+export declare const FISSION_VIOLATION_TYPES: readonly FissionViolationType[];
+/**
+ * A recorded fission guard violation.
+ * Stored for auditing — shows what was blocked and why.
+ */
+export interface FissionViolation {
+    /** UUID of the violation record */
+    id: string;
+    /** Which guardrail was triggered */
+    violationType: FissionViolationType;
+    /** Agent that attempted the creation */
+    agentId: string;
+    /** Parent WorkItem ID (the would-be parent) */
+    parentWorkItemId: string;
+    /** Mission ID if applicable */
+    missionId?: string;
+    /** Human-readable reason for the block */
+    reason: string;
+    /** Current value that exceeded the limit (e.g., depth=4) */
+    currentValue: number;
+    /** The configured limit that was exceeded (e.g., maxDepth=3) */
+    configuredLimit: number;
+    /** ISO8601 timestamp */
+    violatedAt: string;
+}
+/**
+ * Configuration for all fission guardrails.
+ * Each field controls one specific guardrail.
+ */
+export interface FissionGuardConfig {
+    /** Maximum depth of parentWorkItemId chain (default: 3) */
+    maxDepth: number;
+    /** Maximum tasks per Mission (default: 50, hard limit: 200) */
+    maxTasksPerMission: number;
+    /** Absolute hard limit on tasks per Mission — cannot be overridden */
+    hardMaxTasksPerMission: number;
+    /** Rate limit window in milliseconds (default: 600_000 = 10 minutes) */
+    rateLimitWindowMs: number;
+    /** Maximum sub-tasks an agent can create within the rate limit window */
+    rateLimitMaxCreations: number;
+    /** Maximum children per single WorkItem (default: 5) */
+    maxBranchingFactor: number;
+    /** Default TTL for new WorkItems in milliseconds (default: 86_400_000 = 24h) */
+    defaultTtlMs: number;
+    /** Maximum allowed TTL in milliseconds (default: 604_800_000 = 7 days) */
+    maxTtlMs: number;
+    /** Budget threshold in USD — exceeding triggers approval requirement */
+    budgetThresholdUsd: number;
+    /** Whether the budget gate is enabled */
+    budgetGateEnabled: boolean;
+    /** Maximum violation history entries retained */
+    maxViolationHistory: number;
+}
+/**
+ * Default fission guard configuration.
+ * Values match CEO requirements from the implementation checklist.
+ */
+export declare const DEFAULT_FISSION_CONFIG: Readonly<FissionGuardConfig>;
+/**
+ * Tracks an agent's recent sub-task creation timestamps
+ * for rate limiting.
+ */
+export interface AgentCreationRecord {
+    /** Agent ID */
+    agentId: string;
+    /** Timestamps (epoch ms) of recent sub-task creations */
+    timestamps: number[];
+}
+/**
+ * Checks whether a string is a valid FissionViolationType.
+ *
+ * @param value - The string to check
+ * @returns True if value is a valid FissionViolationType
+ */
+export declare function isValidViolationType(value: string): value is FissionViolationType;
+/**
+ * Validates that an unknown value conforms to GuardResult.
+ *
+ * @param value - Unknown value to validate
+ * @returns True if value is a valid GuardResult
+ */
+export declare function isGuardResult(value: unknown): value is GuardResult;
+/**
+ * Validates that an unknown value conforms to FissionViolation.
+ *
+ * @param value - Unknown value to validate
+ * @returns True if value is a valid FissionViolation
+ */
+export declare function isFissionViolation(value: unknown): value is FissionViolation;
+/**
+ * Validates that an unknown value conforms to FissionGuardConfig.
+ *
+ * @param value - Unknown value to validate
+ * @returns True if value is a valid FissionGuardConfig
+ */
+export declare function isValidFissionGuardConfig(value: unknown): value is FissionGuardConfig;
+/**
+ * Creates a GuardResult indicating the action is allowed.
+ *
+ * @returns A GuardResult with allowed=true
+ */
+export declare function createAllowedResult(): GuardResult;
+/**
+ * Creates a GuardResult indicating the action is blocked.
+ *
+ * @param violationType - Which guardrail was violated
+ * @param reason - Human-readable explanation
+ * @returns A GuardResult with allowed=false
+ */
+export declare function createBlockedResult(violationType: FissionViolationType, reason: string): GuardResult;
+//# sourceMappingURL=fission-guard.types.d.ts.map

package/dist/backend/backend/src/services/fission/fission-guard.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fission-guard.types.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/fission/fission-guard.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,WAAW,GACX,WAAW,GACX,YAAY,GACZ,kBAAkB,GAClB,cAAc,GACd,iBAAiB,CAAC;AAEtB,6CAA6C;AAC7C,eAAO,MAAM,uBAAuB,EAAE,SAAS,oBAAoB,EAOzD,CAAC;AAMX;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,aAAa,EAAE,oBAAoB,CAAC;IACpC,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wEAAwE;IACxE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wDAAwD;IACxD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iDAAiD;IACjD,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,kBAAkB,CAYtD,CAAC;AAMX;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,oBAAoB,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAUlE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAc5E;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAgBrF;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,oBAAoB,EACnC,MAAM,EAAE,MAAM,GACb,WAAW,CAEb"}

package/dist/backend/backend/src/services/fission/fission-guard.types.js

@@ -0,0 +1,133 @@
+/**
+ * Fission Guard Type Definitions
+ *
+ * Types for the FissionGuardService — prevents agents from creating
+ * unbounded sub-tasks. Implements 6 guardrails: maxDepth, maxTasks,
+ * rate limit, branching factor, TTL, and budget gate.
+ *
+ * @module services/fission/fission-guard.types
+ */
+/** All valid FissionViolationType values. */
+export const FISSION_VIOLATION_TYPES = [
+    'max_depth',
+    'max_tasks',
+    'rate_limit',
+    'branching_factor',
+    'ttl_exceeded',
+    'budget_exceeded',
+];
+/**
+ * Default fission guard configuration.
+ * Values match CEO requirements from the implementation checklist.
+ */
+export const DEFAULT_FISSION_CONFIG = {
+    maxDepth: 3,
+    maxTasksPerMission: 50,
+    hardMaxTasksPerMission: 200,
+    rateLimitWindowMs: 600_000, // 10 minutes
+    rateLimitMaxCreations: 5,
+    maxBranchingFactor: 5,
+    defaultTtlMs: 86_400_000, // 24 hours
+    maxTtlMs: 604_800_000, // 7 days
+    budgetThresholdUsd: 10.0,
+    budgetGateEnabled: true,
+    maxViolationHistory: 500,
+};
+// ---------------------------------------------------------------------------
+// Type Guards
+// ---------------------------------------------------------------------------
+/**
+ * Checks whether a string is a valid FissionViolationType.
+ *
+ * @param value - The string to check
+ * @returns True if value is a valid FissionViolationType
+ */
+export function isValidViolationType(value) {
+    return FISSION_VIOLATION_TYPES.includes(value);
+}
+/**
+ * Validates that an unknown value conforms to GuardResult.
+ *
+ * @param value - Unknown value to validate
+ * @returns True if value is a valid GuardResult
+ */
+export function isGuardResult(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    if (typeof obj.allowed !== 'boolean')
+        return false;
+    if (obj.reason !== undefined && typeof obj.reason !== 'string')
+        return false;
+    if (obj.violationType !== undefined) {
+        if (typeof obj.violationType !== 'string')
+            return false;
+        if (!isValidViolationType(obj.violationType))
+            return false;
+    }
+    return true;
+}
+/**
+ * Validates that an unknown value conforms to FissionViolation.
+ *
+ * @param value - Unknown value to validate
+ * @returns True if value is a valid FissionViolation
+ */
+export function isFissionViolation(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    return (typeof obj.id === 'string' &&
+        typeof obj.violationType === 'string' &&
+        isValidViolationType(obj.violationType) &&
+        typeof obj.agentId === 'string' &&
+        typeof obj.parentWorkItemId === 'string' &&
+        typeof obj.reason === 'string' &&
+        typeof obj.currentValue === 'number' &&
+        typeof obj.configuredLimit === 'number' &&
+        typeof obj.violatedAt === 'string');
+}
+/**
+ * Validates that an unknown value conforms to FissionGuardConfig.
+ *
+ * @param value - Unknown value to validate
+ * @returns True if value is a valid FissionGuardConfig
+ */
+export function isValidFissionGuardConfig(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    return (typeof obj.maxDepth === 'number' && obj.maxDepth > 0 &&
+        typeof obj.maxTasksPerMission === 'number' && obj.maxTasksPerMission > 0 &&
+        typeof obj.hardMaxTasksPerMission === 'number' && obj.hardMaxTasksPerMission > 0 &&
+        typeof obj.rateLimitWindowMs === 'number' && obj.rateLimitWindowMs > 0 &&
+        typeof obj.rateLimitMaxCreations === 'number' && obj.rateLimitMaxCreations > 0 &&
+        typeof obj.maxBranchingFactor === 'number' && obj.maxBranchingFactor > 0 &&
+        typeof obj.defaultTtlMs === 'number' && obj.defaultTtlMs > 0 &&
+        typeof obj.maxTtlMs === 'number' && obj.maxTtlMs > 0 &&
+        typeof obj.budgetThresholdUsd === 'number' && obj.budgetThresholdUsd >= 0 &&
+        typeof obj.budgetGateEnabled === 'boolean' &&
+        typeof obj.maxViolationHistory === 'number' && obj.maxViolationHistory > 0);
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a GuardResult indicating the action is allowed.
+ *
+ * @returns A GuardResult with allowed=true
+ */
+export function createAllowedResult() {
+    return { allowed: true };
+}
+/**
+ * Creates a GuardResult indicating the action is blocked.
+ *
+ * @param violationType - Which guardrail was violated
+ * @param reason - Human-readable explanation
+ * @returns A GuardResult with allowed=false
+ */
+export function createBlockedResult(violationType, reason) {
+    return { allowed: false, reason, violationType };
+}
+//# sourceMappingURL=fission-guard.types.js.map

package/dist/backend/backend/src/services/fission/fission-guard.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fission-guard.types.js","sourceRoot":"","sources":["../../../../../../backend/src/services/fission/fission-guard.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8BH,6CAA6C;AAC7C,MAAM,CAAC,MAAM,uBAAuB,GAAoC;IACtE,WAAW;IACX,WAAW;IACX,YAAY;IACZ,kBAAkB;IAClB,cAAc;IACd,iBAAiB;CACT,CAAC;AAgEX;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAiC;IAClE,QAAQ,EAAE,CAAC;IACX,kBAAkB,EAAE,EAAE;IACtB,sBAAsB,EAAE,GAAG;IAC3B,iBAAiB,EAAE,OAAO,EAAQ,aAAa;IAC/C,qBAAqB,EAAE,CAAC;IACxB,kBAAkB,EAAE,CAAC;IACrB,YAAY,EAAE,UAAU,EAAU,WAAW;IAC7C,QAAQ,EAAE,WAAW,EAAa,SAAS;IAC3C,kBAAkB,EAAE,IAAI;IACxB,iBAAiB,EAAE,IAAI;IACvB,mBAAmB,EAAE,GAAG;CAChB,CAAC;AAiBX,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAQ,uBAA6C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC7E,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACxD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,aAAa,CAAC;YAAE,OAAO,KAAK,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,CACL,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ;QAC1B,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ;QACrC,oBAAoB,CAAC,GAAG,CAAC,aAAa,CAAC;QACvC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,OAAO,GAAG,CAAC,gBAAgB,KAAK,QAAQ;QACxC,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ;QACpC,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ;QACvC,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,CACnC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,CACL,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,GAAG,CAAC;QACpD,OAAO,GAAG,CAAC,kBAAkB,KAAK,QAAQ,IAAI,GAAG,CAAC,kBAAkB,GAAG,CAAC;QACxE,OAAO,GAAG,CAAC,sBAAsB,KAAK,QAAQ,IAAI,GAAG,CAAC,sBAAsB,GAAG,CAAC;QAChF,OAAO,GAAG,CAAC,iBAAiB,KAAK,QAAQ,IAAI,GAAG,CAAC,iBAAiB,GAAG,CAAC;QACtE,OAAO,GAAG,CAAC,qBAAqB,KAAK,QAAQ,IAAI,GAAG,CAAC,qBAAqB,GAAG,CAAC;QAC9E,OAAO,GAAG,CAAC,kBAAkB,KAAK,QAAQ,IAAI,GAAG,CAAC,kBAAkB,GAAG,CAAC;QACxE,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,IAAI,GAAG,CAAC,YAAY,GAAG,CAAC;QAC5D,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,GAAG,CAAC;QACpD,OAAO,GAAG,CAAC,kBAAkB,KAAK,QAAQ,IAAI,GAAG,CAAC,kBAAkB,IAAI,CAAC;QACzE,OAAO,GAAG,CAAC,iBAAiB,KAAK,SAAS;QAC1C,OAAO,GAAG,CAAC,mBAAmB,KAAK,QAAQ,IAAI,GAAG,CAAC,mBAAmB,GAAG,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,aAAmC,EACnC,MAAc;IAEd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AACnD,CAAC"}

package/dist/backend/backend/src/services/intent-task/intent-decomposition.service.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Intent Decomposition Service — Utility Layer
+ *
+ * Lightweight utility for pre-filtering non-actionable messages and
+ * providing regex-based fallback decomposition.
+ *
+ * Architecture: The orchestrator LLM (Claude Code) performs the actual
+ * intent decomposition using its own reasoning — no separate LLM API call
+ * is needed. The orchestrator then calls POST /api/intent-tasks/batch
+ * with structured task data.
+ *
+ * This service provides:
+ * - Pre-filtering: quickly reject obviously non-actionable messages
+ * - Regex fallback: basic decomposition when LLM-based flow is unavailable
+ * - Task creation: wraps IntentTaskService for convenience
+ *
+ * @module services/intent-task/intent-decomposition.service
+ */
+import type { IntentTask, DecomposedIntent } from '../../types/intent-task.types.js';
+/**
+ * Utility service for intent task decomposition.
+ *
+ * The primary decomposition path is:
+ * 1. Orchestrator LLM receives a user message
+ * 2. Orchestrator extracts tasks using its own reasoning
+ * 3. Orchestrator calls POST /api/intent-tasks/batch with structured data
+ *
+ * This service provides a fallback regex-based path and pre-filtering utilities.
+ *
+ * @example
+ * ```typescript
+ * const service = IntentDecompositionService.getInstance();
+ *
+ * // Check if a message is worth processing
+ * if (!service.isObviouslyNonActionable(message)) {
+ *   // Let the orchestrator LLM handle decomposition
+ * }
+ *
+ * // Fallback: regex-based decomposition
+ * const tasks = service.decomposeWithRegexAndCreate(message, chatMessageId);
+ * ```
+ */
+export declare class IntentDecompositionService {
+    private static instance;
+    private readonly logger;
+    constructor();
+    /**
+     * Get the singleton instance.
+     *
+     * @returns Shared IntentDecompositionService instance
+     */
+    static getInstance(): IntentDecompositionService;
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Quick pre-filter to skip obviously non-actionable messages.
+     * Used by the orchestrator to decide whether to bother with
+     * intent extraction for a given message.
+     *
+     * @param message - Trimmed message
+     * @returns true if the message is obviously not actionable
+     */
+    isObviouslyNonActionable(message: string): boolean;
+    /**
+     * Check if a message is within processable bounds.
+     *
+     * @param message - Raw message
+     * @returns true if the message length is within bounds for processing
+     */
+    isWithinBounds(message: string): boolean;
+    /**
+     * Regex-based decomposition fallback.
+     * Uses heuristic pattern matching to split messages into intents.
+     *
+     * @param message - User message
+     * @returns Array of decomposed intents
+     */
+    decomposeWithRegex(message: string): DecomposedIntent[];
+    /**
+     * Regex-based decomposition with automatic task creation.
+     * Falls back to this when the orchestrator LLM path is unavailable.
+     *
+     * @param message - User message
+     * @param chatMessageId - Chat message ID for correlation
+     * @returns Array of created IntentTasks
+     */
+    decomposeWithRegexAndCreate(message: string, chatMessageId: string): IntentTask[];
+}
+//# sourceMappingURL=intent-decomposition.service.d.ts.map

package/dist/backend/backend/src/services/intent-task/intent-decomposition.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-decomposition.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/intent-task/intent-decomposition.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EACjB,MAAM,kCAAkC,CAAC;AAoB1C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2C;IAElE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;;IAMzC;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,0BAA0B;IAOhD;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAQ5B;;;;;;;OAOG;IACH,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAkBlD;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IASxC;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAKvD;;;;;;;OAOG;IACH,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,UAAU,EAAE;CA6ClF"}

package/dist/backend/backend/src/services/intent-task/intent-decomposition.service.js

@@ -0,0 +1,179 @@
+/**
+ * Intent Decomposition Service — Utility Layer
+ *
+ * Lightweight utility for pre-filtering non-actionable messages and
+ * providing regex-based fallback decomposition.
+ *
+ * Architecture: The orchestrator LLM (Claude Code) performs the actual
+ * intent decomposition using its own reasoning — no separate LLM API call
+ * is needed. The orchestrator then calls POST /api/intent-tasks/batch
+ * with structured task data.
+ *
+ * This service provides:
+ * - Pre-filtering: quickly reject obviously non-actionable messages
+ * - Regex fallback: basic decomposition when LLM-based flow is unavailable
+ * - Task creation: wraps IntentTaskService for convenience
+ *
+ * @module services/intent-task/intent-decomposition.service
+ */
+import { IntentTaskService } from './intent-task.service.js';
+import { LoggerService } from '../core/logger.service.js';
+import { decomposeIntents, } from '../../types/intent-task.types.js';
+import { FissionGuardService } from '../fission/fission-guard.service.js';
+// =============================================================================
+// Constants
+// =============================================================================
+/** Maximum message length to process (skip extremely long pastes) */
+const MAX_MESSAGE_LENGTH = 4000;
+/** Minimum message length to bother with decomposition */
+const MIN_MESSAGE_LENGTH = 5;
+// =============================================================================
+// Service
+// =============================================================================
+/**
+ * Utility service for intent task decomposition.
+ *
+ * The primary decomposition path is:
+ * 1. Orchestrator LLM receives a user message
+ * 2. Orchestrator extracts tasks using its own reasoning
+ * 3. Orchestrator calls POST /api/intent-tasks/batch with structured data
+ *
+ * This service provides a fallback regex-based path and pre-filtering utilities.
+ *
+ * @example
+ * ```typescript
+ * const service = IntentDecompositionService.getInstance();
+ *
+ * // Check if a message is worth processing
+ * if (!service.isObviouslyNonActionable(message)) {
+ *   // Let the orchestrator LLM handle decomposition
+ * }
+ *
+ * // Fallback: regex-based decomposition
+ * const tasks = service.decomposeWithRegexAndCreate(message, chatMessageId);
+ * ```
+ */
+export class IntentDecompositionService {
+    static instance = null;
+    logger;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('IntentDecomposition');
+    }
+    /**
+     * Get the singleton instance.
+     *
+     * @returns Shared IntentDecompositionService instance
+     */
+    static getInstance() {
+        if (!IntentDecompositionService.instance) {
+            IntentDecompositionService.instance = new IntentDecompositionService();
+        }
+        return IntentDecompositionService.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        IntentDecompositionService.instance = null;
+    }
+    // ===========================================================================
+    // Pre-filters
+    // ===========================================================================
+    /**
+     * Quick pre-filter to skip obviously non-actionable messages.
+     * Used by the orchestrator to decide whether to bother with
+     * intent extraction for a given message.
+     *
+     * @param message - Trimmed message
+     * @returns true if the message is obviously not actionable
+     */
+    isObviouslyNonActionable(message) {
+        const trimmed = message.trim();
+        // Too short to be meaningful
+        if (trimmed.length < 3)
+            return true;
+        // Pure greetings
+        if (/^(hi|hello|hey|yo|sup|thanks|thank\s+you|thx|bye|goodbye|welcome\s+back)\s*[.!]?$/i.test(trimmed))
+            return true;
+        // Pure acknowledgments
+        if (/^(ok|okay|sure|got\s+it|yes|no|yep|yup|yeah|nah|nope|alright|fine|great|perfect|awesome|cool|nice|lgtm|noted|agreed)\s*[.!]?$/i.test(trimmed))
+            return true;
+        // Emoji-only
+        if (/^[\p{Emoji}\s.,!?]+$/u.test(trimmed))
+            return true;
+        return false;
+    }
+    /**
+     * Check if a message is within processable bounds.
+     *
+     * @param message - Raw message
+     * @returns true if the message length is within bounds for processing
+     */
+    isWithinBounds(message) {
+        const len = message.trim().length;
+        return len >= MIN_MESSAGE_LENGTH && len <= MAX_MESSAGE_LENGTH;
+    }
+    // ===========================================================================
+    // Regex Fallback
+    // ===========================================================================
+    /**
+     * Regex-based decomposition fallback.
+     * Uses heuristic pattern matching to split messages into intents.
+     *
+     * @param message - User message
+     * @returns Array of decomposed intents
+     */
+    decomposeWithRegex(message) {
+        const result = decomposeIntents(message);
+        return result.intents;
+    }
+    /**
+     * Regex-based decomposition with automatic task creation.
+     * Falls back to this when the orchestrator LLM path is unavailable.
+     *
+     * @param message - User message
+     * @param chatMessageId - Chat message ID for correlation
+     * @returns Array of created IntentTasks
+     */
+    decomposeWithRegexAndCreate(message, chatMessageId) {
+        const trimmed = message.trim();
+        if (!this.isWithinBounds(trimmed) || this.isObviouslyNonActionable(trimmed)) {
+            return [];
+        }
+        const decomposed = this.decomposeWithRegex(trimmed);
+        if (decomposed.length === 0) {
+            return [];
+        }
+        // Fission guard: check rate limit before creating tasks via regex fallback
+        try {
+            const fissionGuard = FissionGuardService.getInstance();
+            const rateCheck = fissionGuard.checkRateLimit('system-decomposition');
+            if (!rateCheck.allowed) {
+                this.logger.warn('Fission guard blocked regex decomposition', {
+                    chatMessageId,
+                    reason: rateCheck.reason,
+                });
+                return [];
+            }
+        }
+        catch {
+            // FissionGuardService not initialized — skip (non-fatal)
+        }
+        const taskService = IntentTaskService.getInstance();
+        const tasks = taskService.batchCreateTasks({
+            originalMessage: trimmed,
+            tasks: decomposed.map((d, index) => ({
+                intent: d.intent,
+                level: d.level,
+                category: d.category,
+                order: index,
+            })),
+        });
+        this.logger.info('Intent tasks created via regex fallback', {
+            chatMessageId,
+            taskCount: tasks.length,
+        });
+        return tasks;
+    }
+}
+//# sourceMappingURL=intent-decomposition.service.js.map

package/dist/backend/backend/src/services/intent-task/intent-decomposition.service.js.map

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