@hasna/loops 0.3.51 → 0.3.53

package/dist/sdk/index.js

@@ -621,7 +621,7 @@ function writeWorkflowRunManifest(args) {
 var DEFAULT_RECOVERY_BATCH_LIMIT = 100;
 var DEFAULT_RECOVERY_SCAN_MULTIPLIER = 5;
 var LIVE_EXPIRED_RUN_GRACE_MS = 60000;
-var GENERATED_ROUTE_TEMPLATE_IDS = new Set(["todos-task-worker-verifier", "event-worker-verifier"]);
+var GENERATED_ROUTE_TEMPLATE_IDS = new Set(["todos-task-worker-verifier", "task-lifecycle", "event-worker-verifier"]);
 var GENERATED_ROUTE_KEYS = new Set(["todos-task", "generic-event"]);
 function rowToLoop(row) {
   return {
@@ -1565,6 +1565,65 @@ class Store {
       throw new Error(`workflow invocation not found after create: ${id}`);
     return rowToWorkflowInvocation(row);
   }
+  refreshWorkflowInvocationForWorkItem(workItemId, input) {
+    const sourceDedupeKey = input.sourceRef.dedupeKey ?? undefined;
+    if (!sourceDedupeKey)
+      throw new Error("cannot refresh workflow invocation without sourceRef.dedupeKey");
+    const now = nowIso();
+    const claimableStatuses = ["queued", "deferred", "failed", "dead_letter", "cancelled"];
+    const statusBindings = Object.fromEntries(claimableStatuses.map((status, index) => [`$status${index}`, status]));
+    const placeholders = claimableStatuses.map((_, index) => `$status${index}`).join(",");
+    const result = this.db.query(`UPDATE workflow_invocations
+         SET workflow_id=COALESCE($workflowId, workflow_id),
+          template_id=COALESCE($templateId, template_id),
+          source_id=COALESCE($sourceId, source_id),
+          source_json=$sourceJson,
+          subject_kind=$subjectKind,
+          subject_id=COALESCE($subjectId, subject_id),
+          subject_path=COALESCE($subjectPath, subject_path),
+          subject_url=COALESCE($subjectUrl, subject_url),
+          subject_json=$subjectJson,
+          intent=$intent,
+          scope_json=COALESCE($scopeJson, scope_json),
+          output_policy_json=COALESCE($outputPolicyJson, output_policy_json),
+          updated_at=$updated
+         WHERE source_kind=$sourceKind
+          AND source_dedupe_key=$sourceDedupeKey
+          AND EXISTS (
+            SELECT 1
+            FROM workflow_work_items
+            WHERE id=$workItemId
+              AND invocation_id=workflow_invocations.id
+              AND status IN (${placeholders})
+          )`).run({
+      $workItemId: workItemId,
+      $sourceKind: input.sourceRef.kind,
+      $sourceDedupeKey: sourceDedupeKey,
+      $workflowId: input.workflowId ?? null,
+      $templateId: input.templateId ?? null,
+      $sourceId: input.sourceRef.id ?? null,
+      $sourceJson: JSON.stringify(input.sourceRef),
+      $subjectKind: input.subjectRef.kind,
+      $subjectId: input.subjectRef.id ?? null,
+      $subjectPath: input.subjectRef.path ?? null,
+      $subjectUrl: input.subjectRef.url ?? null,
+      $subjectJson: JSON.stringify(input.subjectRef),
+      $intent: input.intent,
+      $scopeJson: input.scope ? JSON.stringify(input.scope) : null,
+      $outputPolicyJson: input.outputPolicy ? JSON.stringify(input.outputPolicy) : null,
+      $updated: now,
+      ...statusBindings
+    });
+    if (result.changes !== 1)
+      throw new Error(`workflow work item is not refreshable: ${workItemId}`);
+    const updated = this.db.query(`SELECT workflow_invocations.*
+         FROM workflow_invocations
+         JOIN workflow_work_items ON workflow_work_items.invocation_id = workflow_invocations.id
+         WHERE workflow_work_items.id = ?`).get(workItemId);
+    if (!updated)
+      throw new Error(`workflow invocation not found after refresh for work item: ${workItemId}`);
+    return rowToWorkflowInvocation(updated);
+  }
   getWorkflowInvocation(id) {
     const row = this.db.query("SELECT * FROM workflow_invocations WHERE id = ?").get(id);
     return row ? rowToWorkflowInvocation(row) : undefined;

package/docs/USAGE.md

@@ -345,6 +345,7 @@ into a deduped one-shot workflow loop when route capacity allows:
 
 ```bash
 cat task-created-event.json | loops events handle todos-task \
+  --template task-lifecycle \
   --provider codewith \
   --auth-profile-pool account004,account005,account006 \
   --permission-mode bypass \
@@ -362,6 +363,20 @@ approval-required, or `no-auto` tasks. This guard exists even when the upstream
 `@hasna/events` webhook filter is misconfigured, so task existence alone is not
 permission to execute agent work.
 
+By default, `todos-task` routes use `todos-task-worker-verifier` for backwards
+compatibility. Use `--template task-lifecycle` when the task should run the full
+triage -> planner -> worker -> verifier lifecycle. The route rejects unrelated
+workflow templates such as `pr-review` so a todos task cannot accidentally use a
+template with the wrong contract.
+The lifecycle template inserts deterministic gate steps after triage and after
+planning. If either agent marks the task blocked, omits its contextual
+`openloops:triage=go task=<id> event=<event-id>` /
+`openloops:planner=go task=<id> event=<event-id>` marker comment, or the task
+is marked no-auto/manual/approval-required, the next agent step is not started.
+Use `--triage-auth-profile`, `--planner-auth-profile`,
+`--worker-auth-profile`, and `--verifier-auth-profile` for exact Codewith role
+profiles, or use `--auth-profile-pool` for deterministic role rotation.
+
 Use route throttles to avoid stampeding agents when a producer creates many
 tasks at once:
 
@@ -426,6 +441,7 @@ locks, or non-pending states stay queued in todos and are not routed:
 ```bash
 loops events drain todos-task \
   --todos-project "$HOME/.hasna/loops" \
+  --template task-lifecycle \
   --task-list repoops-pr-queue \
   --tags auto:route \
   --project-path-prefix /home/hasna/workspace/hasna/opensource \
@@ -461,6 +477,7 @@ For the Hasna OSS task-created route, keep the drain deterministic and narrow:
 loops routes schedule todos-task oss-task-route-drain \
   --every 5m \
   --todos-project "$HOME/.hasna/loops" \
+  --template task-lifecycle \
   --project-path-prefix /home/hasna/workspace/hasna/opensource \
   --tags auto:route \
   --provider codewith \

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/loops",
-  "version": "0.3.51",
+  "version": "0.3.53",
   "description": "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   "type": "module",
   "main": "dist/index.js",