@hotmeshio/long-tail 0.4.13 → 0.4.15

package/build/sdk/index.d.ts

@@ -150,6 +150,27 @@ export declare function createClient(options?: LTClientOptions): {
             ids: string[];
             hint?: string;
         }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        findByMetadata: (input: {
+            key: string;
+            value: string;
+            status?: string;
+            limit?: number;
+            offset?: number;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        claimByMetadata: (input: {
+            key: string;
+            value: string;
+            durationMinutes?: number;
+            assignee?: string;
+            metadata?: Record<string, any>;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        resolveByMetadata: (input: {
+            key: string;
+            value: string;
+            resolverPayload: Record<string, any>;
+            assignee?: string;
+            metadata?: Record<string, any>;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
     };
     workflows: {
         invoke: (input: {

package/build/sdk/index.js

@@ -130,6 +130,9 @@ function createClient(options = {}) {
             bulkAssign: bindAuth(escalationsApi.bulkAssign, auth),
             bulkEscalate: bindAuth(escalationsApi.bulkEscalate, auth),
             bulkTriage: bindAuth(escalationsApi.bulkTriage, auth),
+            findByMetadata: bindAuth(escalationsApi.findByMetadata, auth),
+            claimByMetadata: bindAuth(escalationsApi.claimByMetadata, auth),
+            resolveByMetadata: bindAuth(escalationsApi.resolveByMetadata, auth),
         },
         // ── Workflows ──────────────────────────────────────────────────────────
         workflows: {

package/build/services/escalation/crud.d.ts

@@ -45,3 +45,8 @@ export declare function enrichEscalationRouting(id: string, metadataPatch: Recor
     taskId?: string;
 }): Promise<LTEscalationRecord | null>;
 export declare function getEscalationsByOriginId(originId: string): Promise<LTEscalationRecord[]>;
+export declare function findByMetadata(key: string, value: string, status?: string, limit?: number, offset?: number): Promise<{
+    escalations: LTEscalationRecord[];
+    total: number;
+}>;
+export declare function claimByMetadata(key: string, value: string, userId: string, durationMinutes?: number, metadata?: Record<string, any>): Promise<ClaimResult | null>;

package/build/services/escalation/crud.js

@@ -14,9 +14,14 @@ exports.getEscalationsByWorkflowId = getEscalationsByWorkflowId;
 exports.updateEscalationMetadata = updateEscalationMetadata;
 exports.enrichEscalationRouting = enrichEscalationRouting;
 exports.getEscalationsByOriginId = getEscalationsByOriginId;
+exports.findByMetadata = findByMetadata;
+exports.claimByMetadata = claimByMetadata;
 const db_1 = require("../../lib/db");
+const publish_1 = require("../../lib/events/publish");
+const logger_1 = require("../../lib/logger");
 const sql_1 = require("./sql");
 async function createEscalation(input) {
+    logger_1.loggerRegistry.info(`[escalation-crud] createEscalation called for wf=${input.workflow_id} type=${input.type} caller=${new Error().stack?.split('\n')[2]?.trim()}`);
     const pool = (0, db_1.getPool)();
     // Ensure the role exists in lt_roles (FK constraint)
     await pool.query(sql_1.ENSURE_ROLE_EXISTS, [input.role]);
@@ -38,7 +43,18 @@ async function createEscalation(input) {
         input.trace_id || null,
         input.span_id || null,
     ]);
-    return rows[0];
+    const escalation = rows[0];
+    (0, publish_1.publishEscalationEvent)({
+        type: 'escalation.created',
+        source: 'service',
+        workflowId: escalation.workflow_id || '',
+        workflowName: escalation.workflow_type || '',
+        taskQueue: escalation.task_queue || '',
+        escalationId: escalation.id,
+        status: 'pending',
+        data: { type: input.type, role: input.role },
+    });
+    return escalation;
 }
 /**
  * Atomic claim operation. Does NOT change status — "claimed" is implicit
@@ -56,15 +72,39 @@ async function claimEscalation(id, userId, durationMinutes = 30) {
     if (rows.length === 0)
         return null;
     const row = rows[0];
+    const escalation = row;
+    (0, publish_1.publishEscalationEvent)({
+        type: 'escalation.claimed',
+        source: 'service',
+        workflowId: escalation.workflow_id || '',
+        workflowName: escalation.workflow_type || '',
+        taskQueue: escalation.task_queue || '',
+        escalationId: escalation.id,
+        status: 'claimed',
+        data: { assigned_to: userId },
+    });
     return {
-        escalation: row,
+        escalation,
         isExtension: row.prev_assigned_to === userId,
     };
 }
 async function resolveEscalation(id, resolverPayload) {
     const pool = (0, db_1.getPool)();
     const { rows } = await pool.query(sql_1.RESOLVE_ESCALATION, [id, JSON.stringify(resolverPayload)]);
-    return rows[0] || null;
+    const escalation = rows[0] || null;
+    if (escalation) {
+        (0, publish_1.publishEscalationEvent)({
+            type: 'escalation.resolved',
+            source: 'service',
+            workflowId: escalation.workflow_id || '',
+            workflowName: escalation.workflow_type || '',
+            taskQueue: escalation.task_queue || '',
+            escalationId: escalation.id,
+            status: 'resolved',
+            data: {},
+        });
+    }
+    return escalation;
 }
 /**
  * Bulk update priority for a set of escalations.
@@ -148,3 +188,40 @@ async function getEscalationsByOriginId(originId) {
     const { rows } = await pool.query(sql_1.GET_ESCALATIONS_BY_ORIGIN_ID, [originId]);
     return rows;
 }
+// --- Metadata candidate key lookups -----------------------------------------
+async function findByMetadata(key, value, status, limit = 50, offset = 0) {
+    const pool = (0, db_1.getPool)();
+    const filter = JSON.stringify({ [key]: value });
+    const [countResult, dataResult] = await Promise.all([
+        pool.query(sql_1.COUNT_BY_METADATA, [filter, status || null]),
+        pool.query(sql_1.FIND_BY_METADATA, [filter, status || null, limit, offset]),
+    ]);
+    return {
+        escalations: dataResult.rows,
+        total: parseInt(countResult.rows[0].count, 10),
+    };
+}
+async function claimByMetadata(key, value, userId, durationMinutes = 30, metadata) {
+    const pool = (0, db_1.getPool)();
+    const filter = JSON.stringify({ [key]: value });
+    const metaPatch = metadata ? JSON.stringify(metadata) : null;
+    const { rows } = await pool.query(sql_1.CLAIM_BY_METADATA, [filter, userId, durationMinutes, metaPatch]);
+    if (rows.length === 0)
+        return null;
+    const row = rows[0];
+    const escalation = row;
+    (0, publish_1.publishEscalationEvent)({
+        type: 'escalation.claimed',
+        source: 'service',
+        workflowId: escalation.workflow_id || '',
+        workflowName: escalation.workflow_type || '',
+        taskQueue: escalation.task_queue || '',
+        escalationId: escalation.id,
+        status: 'claimed',
+        data: { assigned_to: userId },
+    });
+    return {
+        escalation,
+        isExtension: row.prev_assigned_to === userId,
+    };
+}

package/build/services/escalation/sql.d.ts

@@ -19,3 +19,8 @@ export declare const BULK_RESOLVE_FOR_TRIAGE = "UPDATE lt_escalations\nSET statu
 export declare const UPDATE_ESCALATION_METADATA = "UPDATE lt_escalations\nSET metadata = COALESCE(metadata, '{}'::jsonb) || $2::jsonb,\n    updated_at = NOW()\nWHERE id = $1\nRETURNING *";
 export declare const ENRICH_ESCALATION_ROUTING = "UPDATE lt_escalations\nSET metadata = COALESCE(metadata, '{}'::jsonb) || $2::jsonb,\n    workflow_type = COALESCE(workflow_type, $3),\n    workflow_id = COALESCE(workflow_id, $4),\n    task_queue = COALESCE(task_queue, $5),\n    task_id = COALESCE(task_id, $6),\n    updated_at = NOW()\nWHERE id = $1\nRETURNING *";
 export declare const LIST_DISTINCT_TYPES = "SELECT DISTINCT type FROM lt_escalations ORDER BY type";
+/** Find escalations by a single metadata key-value pair. */
+export declare const FIND_BY_METADATA = "SELECT * FROM lt_escalations\nWHERE metadata @> $1::jsonb\n  AND ($2::text IS NULL OR status = $2)\nORDER BY priority ASC, created_at ASC\nLIMIT $3 OFFSET $4";
+export declare const COUNT_BY_METADATA = "SELECT COUNT(*) FROM lt_escalations\nWHERE metadata @> $1::jsonb\n  AND ($2::text IS NULL OR status = $2)";
+/** Atomic claim by metadata: find one available escalation, claim it, and optionally merge metadata. */
+export declare const CLAIM_BY_METADATA = "WITH target AS (\n  SELECT id, assigned_to\n  FROM lt_escalations\n  WHERE metadata @> $1::jsonb\n    AND status = 'pending'\n    AND (\n      assigned_to IS NULL\n      OR assigned_until <= NOW()\n      OR assigned_to = $2\n    )\n  ORDER BY priority ASC, created_at ASC\n  LIMIT 1\n  FOR UPDATE SKIP LOCKED\n),\nupdated AS (\n  UPDATE lt_escalations e\n  SET assigned_to = $2,\n      claimed_at = NOW(),\n      assigned_until = NOW() + INTERVAL '1 minute' * $3,\n      metadata = CASE WHEN $4::jsonb IS NOT NULL\n        THEN COALESCE(e.metadata, '{}'::jsonb) || $4::jsonb\n        ELSE e.metadata END\n  FROM target t\n  WHERE e.id = t.id\n  RETURNING e.*, t.assigned_to AS prev_assigned_to\n)\nSELECT * FROM updated";

package/build/services/escalation/sql.js

@@ -3,7 +3,7 @@
 // Escalation SQL – externalized from crud.ts, bulk.ts, queries.ts
 // ---------------------------------------------------------------------------
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LIST_DISTINCT_TYPES = exports.ENRICH_ESCALATION_ROUTING = exports.UPDATE_ESCALATION_METADATA = exports.BULK_RESOLVE_FOR_TRIAGE = exports.BULK_ESCALATE_TO_ROLE = exports.BULK_ASSIGN = exports.BULK_CLAIM = exports.GET_ESCALATIONS_BY_ORIGIN_ID = exports.GET_ESCALATIONS_BY_WORKFLOW_ID = exports.GET_ESCALATIONS_BY_TASK_ID = exports.GET_ESCALATION = exports.ESCALATE_TO_ROLE = exports.RELEASE_EXPIRED_CLAIMS = exports.RELEASE_ESCALATION = exports.GET_ESCALATION_ROLES = exports.UPDATE_ESCALATIONS_PRIORITY = exports.RESOLVE_ESCALATION = exports.CLAIM_ESCALATION = exports.CREATE_ESCALATION = exports.ENSURE_ROLE_EXISTS = void 0;
+exports.CLAIM_BY_METADATA = exports.COUNT_BY_METADATA = exports.FIND_BY_METADATA = exports.LIST_DISTINCT_TYPES = exports.ENRICH_ESCALATION_ROUTING = exports.UPDATE_ESCALATION_METADATA = exports.BULK_RESOLVE_FOR_TRIAGE = exports.BULK_ESCALATE_TO_ROLE = exports.BULK_ASSIGN = exports.BULK_CLAIM = exports.GET_ESCALATIONS_BY_ORIGIN_ID = exports.GET_ESCALATIONS_BY_WORKFLOW_ID = exports.GET_ESCALATIONS_BY_TASK_ID = exports.GET_ESCALATION = exports.ESCALATE_TO_ROLE = exports.RELEASE_EXPIRED_CLAIMS = exports.RELEASE_ESCALATION = exports.GET_ESCALATION_ROLES = exports.UPDATE_ESCALATIONS_PRIORITY = exports.RESOLVE_ESCALATION = exports.CLAIM_ESCALATION = exports.CREATE_ESCALATION = exports.ENSURE_ROLE_EXISTS = void 0;
 // --- Role management -------------------------------------------------------
 exports.ENSURE_ROLE_EXISTS = 'INSERT INTO lt_roles (role) VALUES ($1) ON CONFLICT DO NOTHING';
 // --- Single-record CRUD ---------------------------------------------------
@@ -133,3 +133,44 @@ SET metadata = COALESCE(metadata, '{}'::jsonb) || $2::jsonb,
 WHERE id = $1
 RETURNING *`;
 exports.LIST_DISTINCT_TYPES = 'SELECT DISTINCT type FROM lt_escalations ORDER BY type';
+// --- Metadata candidate key lookups -----------------------------------------
+/** Find escalations by a single metadata key-value pair. */
+exports.FIND_BY_METADATA = `\
+SELECT * FROM lt_escalations
+WHERE metadata @> $1::jsonb
+  AND ($2::text IS NULL OR status = $2)
+ORDER BY priority ASC, created_at ASC
+LIMIT $3 OFFSET $4`;
+exports.COUNT_BY_METADATA = `\
+SELECT COUNT(*) FROM lt_escalations
+WHERE metadata @> $1::jsonb
+  AND ($2::text IS NULL OR status = $2)`;
+/** Atomic claim by metadata: find one available escalation, claim it, and optionally merge metadata. */
+exports.CLAIM_BY_METADATA = `\
+WITH target AS (
+  SELECT id, assigned_to
+  FROM lt_escalations
+  WHERE metadata @> $1::jsonb
+    AND status = 'pending'
+    AND (
+      assigned_to IS NULL
+      OR assigned_until <= NOW()
+      OR assigned_to = $2
+    )
+  ORDER BY priority ASC, created_at ASC
+  LIMIT 1
+  FOR UPDATE SKIP LOCKED
+),
+updated AS (
+  UPDATE lt_escalations e
+  SET assigned_to = $2,
+      claimed_at = NOW(),
+      assigned_until = NOW() + INTERVAL '1 minute' * $3,
+      metadata = CASE WHEN $4::jsonb IS NOT NULL
+        THEN COALESCE(e.metadata, '{}'::jsonb) || $4::jsonb
+        ELSE e.metadata END
+  FROM target t
+  WHERE e.id = t.id
+  RETURNING e.*, t.assigned_to AS prev_assigned_to
+)
+SELECT * FROM updated`;

package/build/services/interceptor/activities/escalation.js

@@ -106,5 +106,6 @@ async function ltCreateEscalation(input) {
         trace_id: input.traceId,
         span_id: input.spanId,
     });
+    // Event published by service layer (services/escalation/crud.ts)
     return escalation.id;
 }

package/build/services/interceptor/activities/task.js

@@ -81,16 +81,7 @@ async function ltCreateTask(input) {
         executing_as: input.executingAs,
         status: input.status,
     });
-    (0, publish_1.publishTaskEvent)({
-        type: 'task.created',
-        source: 'interceptor',
-        workflowId: input.workflowId,
-        workflowName: input.workflowType,
-        taskQueue: input.taskQueue || 'unknown',
-        taskId: task.id,
-        originId: input.originId,
-        status: input.status || 'pending',
-    });
+    // Event published by service layer (services/task/crud.ts)
     return task.id;
 }
 /**
@@ -109,19 +100,7 @@ async function ltCompleteTask(input) {
         data: input.data,
         milestones: input.milestones,
     });
-    // Publish task.completed event
-    if (input.workflowId) {
-        (0, publish_1.publishTaskEvent)({
-            type: 'task.completed',
-            source: 'orchestrator',
-            workflowId: input.workflowId,
-            workflowName: input.workflowName || 'unknown',
-            taskQueue: input.taskQueue || 'unknown',
-            taskId: input.taskId,
-            status: 'completed',
-            milestones: input.milestones,
-        });
-    }
+    // task.completed event published by service layer (services/task/crud.ts)
     // Publish milestone event from orchestrator context
     if (input.milestones?.length && input.workflowId) {
         (0, publish_1.publishMilestoneEvent)({

package/build/services/interceptor/completion.js

@@ -115,28 +115,8 @@ async function createAdvisoryEscalation(state, result) {
         traceId: state.traceId,
         spanId: state.spanId,
     });
-    (0, publish_1.publishEscalationEvent)({
-        type: 'escalation.created',
-        source: 'interceptor',
-        workflowId: state.workflowId,
-        workflowName: state.workflowName,
-        taskQueue: state.taskQueue,
-        taskId: state.taskId,
-        escalationId,
-        originId: state.envelope?.lt?.originId,
-        status: 'pending',
-        data: result.data,
-    });
-    (0, publish_1.publishTaskEvent)({
-        type: 'task.escalated',
-        source: 'interceptor',
-        workflowId: state.workflowId,
-        workflowName: state.workflowName,
-        taskQueue: state.taskQueue,
-        taskId: state.taskId,
-        originId: state.envelope?.lt?.originId,
-        status: 'needs_intervention',
-    });
+    // escalation.created event published by service layer (services/escalation/crud.ts)
+    // task.escalated event published by service layer (services/task/crud.ts)
     // Auto-claim to submitting user if known
     const userId = state.envelope?.lt?.userId;
     if (userId) {

package/build/services/interceptor/escalation.js

@@ -41,28 +41,8 @@ async function handleEscalation(state, result) {
         traceId: state.traceId,
         spanId: state.spanId,
     });
-    (0, publish_1.publishEscalationEvent)({
-        type: 'escalation.created',
-        source: 'interceptor',
-        workflowId: state.workflowId,
-        workflowName: state.workflowName,
-        taskQueue: state.taskQueue,
-        taskId: state.taskId,
-        escalationId,
-        originId: state.envelope?.lt?.originId,
-        status: 'pending',
-        data: result.data,
-    });
-    (0, publish_1.publishTaskEvent)({
-        type: 'task.escalated',
-        source: 'interceptor',
-        workflowId: state.workflowId,
-        workflowName: state.workflowName,
-        taskQueue: state.taskQueue,
-        taskId: state.taskId,
-        originId: state.envelope?.lt?.originId,
-        status: 'needs_intervention',
-    });
+    // escalation.created event published by service layer (services/escalation/crud.ts)
+    // task.escalated event published by service layer (services/task/crud.ts)
     return result;
 }
 /**
@@ -109,28 +89,9 @@ async function handleErrorEscalation(state, err) {
         traceId: state.traceId,
         spanId: state.spanId,
     });
-    (0, publish_1.publishEscalationEvent)({
-        type: 'escalation.created',
-        source: 'interceptor',
-        workflowId: state.workflowId,
-        workflowName: state.workflowName,
-        taskQueue: state.taskQueue,
-        taskId: state.taskId,
-        escalationId: errorEscalationId,
-        originId: state.envelope?.lt?.originId,
-        status: 'pending',
-        data: { error: err.message },
-    });
-    (0, publish_1.publishTaskEvent)({
-        type: 'task.escalated',
-        source: 'interceptor',
-        workflowId: state.workflowId,
-        workflowName: state.workflowName,
-        taskQueue: state.taskQueue,
-        taskId: state.taskId,
-        originId: state.envelope?.lt?.originId,
-        status: 'needs_intervention',
-    });
+    // escalation.created event published by service layer (services/escalation/crud.ts)
+    // task.escalated event published by service layer (services/task/crud.ts)
+    // Publish workflow.failed event (error path only runs once — no replay guard needed)
     (0, publish_1.publishWorkflowEvent)({
         type: 'workflow.failed',
         source: 'interceptor',

package/build/services/interceptor/index.js

@@ -44,6 +44,7 @@ const escalation_1 = require("./escalation");
 const completion_1 = require("./completion");
 const lifecycle_1 = require("./lifecycle");
 const context_2 = require("../iam/context");
+const publish_1 = require("../../lib/events/publish");
 const envelope_1 = require("../iam/envelope");
 const DEFAULT_ACTIVITY_QUEUE = 'lt-interceptor';
 /**
@@ -104,13 +105,36 @@ function createLTInterceptor(options) {
             //    task creation, and escalation wiring.
             if (envelope?.metadata?.certified !== true) {
                 const toolCtx = (0, envelope_1.buildToolContextFromEnvelope)(envelope, wf.workflowId, wf.workflowTrace, wf.workflowSpan);
-                return toolCtx ? (0, context_2.runWithToolContext)(toolCtx, next) : next();
+                // Publish workflow events even for uncertified workflows
+                const taskQueue = (0, lifecycle_1.deriveTaskQueue)(wf);
+                (0, lifecycle_1.publishStartedEvents)(wf, taskQueue, undefined, wf.workflowId);
+                const result = toolCtx ? await (0, context_2.runWithToolContext)(toolCtx, next) : await next();
+                (0, publish_1.publishWorkflowEvent)({
+                    type: 'workflow.completed',
+                    source: 'interceptor',
+                    workflowId: wf.workflowId,
+                    workflowName: wf.workflowName,
+                    taskQueue,
+                    status: 'completed',
+                });
+                return result;
             }
             // 3. Load config — unregistered/uncertified workflows get ToolContext only
             const wfConfig = await activities.ltGetWorkflowConfig(wf.workflowName);
             if (!wfConfig) {
                 const toolCtx = (0, envelope_1.buildToolContextFromEnvelope)(envelope, wf.workflowId, wf.workflowTrace, wf.workflowSpan);
-                return toolCtx ? (0, context_2.runWithToolContext)(toolCtx, next) : next();
+                const taskQueue2 = (0, lifecycle_1.deriveTaskQueue)(wf);
+                (0, lifecycle_1.publishStartedEvents)(wf, taskQueue2, undefined, wf.workflowId);
+                const result2 = toolCtx ? await (0, context_2.runWithToolContext)(toolCtx, next) : await next();
+                (0, publish_1.publishWorkflowEvent)({
+                    type: 'workflow.completed',
+                    source: 'interceptor',
+                    workflowId: wf.workflowId,
+                    workflowName: wf.workflowName,
+                    taskQueue: taskQueue2,
+                    status: 'completed',
+                });
+                return result2;
             }
             const taskQueue = (0, lifecycle_1.deriveTaskQueue)(wf);
             // 3. Find existing task and handle re-run escalation resolution

package/build/services/interceptor/lifecycle.d.ts

@@ -37,7 +37,7 @@ export declare function resolveReRun(activities: ProxiedActivities, envelope: LT
  * Also injects originId back into the envelope for downstream consistency.
  */
 export declare function ensureTaskWithRouting(activities: ProxiedActivities, wf: WorkflowIdentity, envelope: LTEnvelope | undefined, existingTask: any | null, taskQueue: string, reRun: ReRunContext): Promise<TaskContext>;
-/** Publish workflow.started + task.started events. */
+/** Publish workflow.started event (guarded against replay). */
 export declare function publishStartedEvents(wf: WorkflowIdentity, taskQueue: string, taskId: string | undefined, originId: string): void;
 /** Complete a task and signal parent for plain (non-LTReturn) results. */
 export declare function completePlainResult(activities: ProxiedActivities, wf: WorkflowIdentity, taskQueue: string, taskId: string | undefined, routing: Record<string, any> | null, result: any): Promise<void>;

package/build/services/interceptor/lifecycle.js

@@ -13,6 +13,7 @@ exports.resolveReRun = resolveReRun;
 exports.ensureTaskWithRouting = ensureTaskWithRouting;
 exports.publishStartedEvents = publishStartedEvents;
 exports.completePlainResult = completePlainResult;
+const hotmesh_1 = require("@hotmeshio/hotmesh");
 const publish_1 = require("../../lib/events/publish");
 // ── Helpers ──────────────────────────────────────────────────────────────────
 /** Extract workflow identity fields from the HotMesh context map. */
@@ -56,17 +57,7 @@ async function resolveReRun(activities, envelope, existingTask, wf, taskQueue) {
             escalationId: escalationId,
             resolverPayload: envelope.resolver,
         });
-        (0, publish_1.publishEscalationEvent)({
-            type: 'escalation.resolved',
-            source: 'interceptor',
-            workflowId: wf.workflowId,
-            workflowName: wf.workflowName,
-            taskQueue,
-            taskId: task?.id || existingTask?.id,
-            escalationId: escalationId,
-            originId: envelope?.lt?.originId,
-            status: 'resolved',
-        });
+        // escalation.resolved event published by service layer (services/escalation/crud.ts)
     }
     return { isReRun, task, metadata };
 }
@@ -128,28 +119,23 @@ async function ensureTaskWithRouting(activities, wf, envelope, existingTask, tas
     }
     return { taskId, routing, originId };
 }
-/** Publish workflow.started + task.started events. */
+/** Publish workflow.started event (guarded against replay). */
 function publishStartedEvents(wf, taskQueue, taskId, originId) {
-    (0, publish_1.publishWorkflowEvent)({
-        type: 'workflow.started',
-        source: 'interceptor',
-        workflowId: wf.workflowId,
-        workflowName: wf.workflowName,
-        taskQueue,
-        taskId,
-        originId,
-        status: 'running',
-    });
-    (0, publish_1.publishTaskEvent)({
-        type: 'task.started',
-        source: 'interceptor',
-        workflowId: wf.workflowId,
-        workflowName: wf.workflowName,
-        taskQueue,
-        taskId: taskId,
-        originId,
-        status: 'in_progress',
-    });
+    const { replay } = hotmesh_1.Durable.workflow.workflowInfo();
+    const isFirstExecution = Object.keys(replay).length === 0;
+    if (isFirstExecution) {
+        (0, publish_1.publishWorkflowEvent)({
+            type: 'workflow.started',
+            source: 'interceptor',
+            workflowId: wf.workflowId,
+            workflowName: wf.workflowName,
+            taskQueue,
+            taskId,
+            originId,
+            status: 'running',
+        });
+    }
+    // task.started event published by service layer (services/task/crud.ts)
 }
 /** Complete a task and signal parent for plain (non-LTReturn) results. */
 async function completePlainResult(activities, wf, taskQueue, taskId, routing, result) {

package/build/services/task/crud.js

@@ -8,6 +8,7 @@ exports.getTaskBySignalId = getTaskBySignalId;
 exports.getTaskByWorkflowId = getTaskByWorkflowId;
 exports.listTasks = listTasks;
 const db_1 = require("../../lib/db");
+const publish_1 = require("../../lib/events/publish");
 const sql_1 = require("./sql");
 async function createTask(input) {
     const pool = (0, db_1.getPool)();
@@ -30,7 +31,18 @@ async function createTask(input) {
         input.executing_as || null,
         input.status || null,
     ]);
-    return rows[0];
+    const task = rows[0];
+    (0, publish_1.publishTaskEvent)({
+        type: 'task.created',
+        source: 'service',
+        workflowId: task.workflow_id || '',
+        workflowName: task.workflow_type || '',
+        taskQueue: task.task_queue || '',
+        taskId: task.id,
+        originId: task.origin_id || undefined,
+        status: task.status || 'pending',
+    });
+    return task;
 }
 async function updateTask(id, input) {
     const pool = (0, db_1.getPool)();
@@ -59,7 +71,29 @@ async function updateTask(id, input) {
     }
     values.push(id);
     const { rows } = await pool.query(`UPDATE lt_tasks SET ${sets.join(', ')} WHERE id = $${idx} RETURNING *`, values);
-    return rows[0];
+    const task = rows[0];
+    // Publish status-driven events from the single write path
+    if (input.status && task) {
+        const STATUS_EVENTS = {
+            in_progress: 'task.started',
+            completed: 'task.completed',
+            needs_intervention: 'task.escalated',
+        };
+        const eventType = STATUS_EVENTS[input.status];
+        if (eventType) {
+            (0, publish_1.publishTaskEvent)({
+                type: eventType,
+                source: 'service',
+                workflowId: task.workflow_id || '',
+                workflowName: task.workflow_type || '',
+                taskQueue: task.task_queue || '',
+                taskId: task.id,
+                originId: task.origin_id || undefined,
+                status: input.status,
+            });
+        }
+    }
+    return task;
 }
 async function appendMilestones(id, milestones) {
     const pool = (0, db_1.getPool)();

package/build/start/server.js

@@ -30,13 +30,14 @@ function startServer() {
     const prodDist = path_1.default.join(__dirname, '..', '..', 'dashboard', 'dist');
     const dashboardDist = (0, fs_1.existsSync)(devDist) ? devDist : prodDist;
     if ((0, fs_1.existsSync)(dashboardDist)) {
-        app.use(express_1.default.static(dashboardDist));
+        app.use(express_1.default.static(dashboardDist, { index: false }));
         // SPA fallback — inject <base href="/"> so relative asset paths
         // resolve from root regardless of route depth (e.g. /admin/users).
-        const rawHtml = (0, fs_1.readFileSync)(path_1.default.join(dashboardDist, 'index.html'), 'utf-8');
-        const indexHtml = rawHtml.replace('<head>', '<head><base href="/">');
+        // Read on each request so dashboard rebuilds take effect without restart.
+        const indexPath = path_1.default.join(dashboardDist, 'index.html');
         app.get('/{*splat}', (_req, res) => {
-            res.type('html').send(indexHtml);
+            const html = (0, fs_1.readFileSync)(indexPath, 'utf-8').replace('<head>', '<head><base href="/">');
+            res.type('html').send(html);
         });
         logger_1.loggerRegistry.info(`[long-tail] Dashboard: http://localhost:${config_1.config.PORT}/`);
     }