@hasna/loops 0.3.13 → 0.3.14

package/dist/cli/index.js

@@ -2074,6 +2074,7 @@ class Store {
 }
 
 // src/cli/index.ts
+import { createHash } from "crypto";
 import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
 import { Command } from "commander";
 
@@ -4494,7 +4495,7 @@ function runDoctor(store) {
 // package.json
 var package_default = {
   name: "@hasna/loops",
-  version: "0.3.13",
+  version: "0.3.14",
   description: "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   type: "module",
   main: "dist/index.js",
@@ -4558,7 +4559,7 @@ var package_default = {
     bun: ">=1.0.0"
   },
   dependencies: {
-    "@hasna/events": "^0.1.8",
+    "@hasna/events": "^0.1.9",
     "@hasna/machines": "0.0.49",
     "@openrouter/ai-sdk-provider": "2.9.1",
     ai: "6.0.204",
@@ -4956,12 +4957,21 @@ function eventData(event) {
     return data;
   return {};
 }
+function eventMetadata(event) {
+  const metadata = event.metadata;
+  if (metadata && typeof metadata === "object" && !Array.isArray(metadata))
+    return metadata;
+  return {};
+}
 function stringField(value) {
   return typeof value === "string" && value.trim() ? value.trim() : undefined;
 }
 function slugSegment(value, fallback = "event") {
   return value.toLowerCase().replace(/[^a-z0-9._:-]+/g, "-").replace(/^-|-$/g, "").slice(0, 80) || fallback;
 }
+function stableSuffix(value) {
+  return createHash("sha256").update(value).digest("hex").slice(0, 12);
+}
 function taskEventField(data, keys) {
   for (const key of keys) {
     const direct = stringField(data[key]);
@@ -5142,12 +5152,23 @@ var eventsHandle = events.command("handle").description("handle a Hasna event en
 eventsHandle.command("todos-task").description("create a one-shot worker/verifier workflow loop for a todos task event").option("--provider <provider>", "agent provider", "codewith").option("--auth-profile <profile>", "provider-native auth profile; currently supported for codewith").option("--account <profile>", "OpenAccounts profile name").option("--account-tool <tool>", "OpenAccounts tool id").option("--model <model>", "provider model").option("--variant <variant>", "provider-specific model variant or reasoning effort").option("--agent <agent>", "provider-specific agent").option("--permission-mode <mode>", "provider permission mode: default, plan, auto, or bypass", "bypass").option("--sandbox <mode>", "provider sandbox").option("--project-path <path>", "fallback project/repo working directory").option("--name-prefix <prefix>", "workflow/loop name prefix", "event:todos-task").option("--dry-run", "print the workflow and loop input without storing anything").action(async (opts) => {
   const event = await readEventEnvelopeFromStdin();
   const data = eventData(event);
+  const metadata = eventMetadata(event);
   const taskId = taskEventField(data, ["id", "task_id", "taskId"]);
   if (!taskId)
     throw new Error("todos task event is missing task id in data.id, data.task_id, data.task.id, or data.payload.id");
   const taskTitle = taskEventField(data, ["title", "task_title", "taskTitle"]);
   const taskDescription = taskEventField(data, ["description", "body"]);
-  const projectPath = opts.projectPath ?? taskEventField(data, ["working_dir", "workingDir", "project_path", "projectPath", "cwd"]) ?? process.cwd();
+  const dataProjectPath = taskEventField(data, ["working_dir", "workingDir", "project_path", "projectPath", "cwd"]);
+  const metadataProjectPath = taskEventField(metadata, [
+    "working_dir",
+    "workingDir",
+    "project_path",
+    "projectPath",
+    "project_canonical_path",
+    "cwd"
+  ]);
+  const projectPath = opts.projectPath ?? dataProjectPath ?? metadataProjectPath ?? process.cwd();
+  const idempotencyKey = `todos-task:${taskId}:${event.type}`;
   const provider = opts.provider;
   if (!["claude", "cursor", "codewith", "aicopilot", "opencode", "codex"].includes(provider))
     throw new Error("unsupported provider");
@@ -5170,13 +5191,14 @@ eventsHandle.command("todos-task").description("create a one-shot worker/verifie
     eventId: event.id,
     eventType: event.type
   });
-  const eventSuffix = event.id.slice(0, 8);
-  workflowBody.name = `${opts.namePrefix}:${taskId.slice(0, 8)}:${eventSuffix}:workflow`;
-  workflowBody.description = `Task-triggered worker/verifier workflow for ${taskTitle ?? taskId} from ${event.source}/${event.type}`;
-  const loopName = `${opts.namePrefix}:${taskId.slice(0, 8)}:${eventSuffix}:run`;
+  const idempotencySuffix = stableSuffix(idempotencyKey);
+  workflowBody.name = `${opts.namePrefix}:${taskId.slice(0, 8)}:${idempotencySuffix}:workflow`;
+  workflowBody.description = `Task-triggered worker/verifier workflow for ${taskTitle ?? taskId} from ${event.source}/${event.type}; ` + `idempotency=${idempotencyKey}; event=${event.id}`;
+  const loopName = `${opts.namePrefix}:${taskId.slice(0, 8)}:${idempotencySuffix}:run`;
+  const legacyLoopName = `${opts.namePrefix}:${taskId.slice(0, 8)}:${event.id.slice(0, 8)}:run`;
   const loopInput = {
     name: loopName,
-    description: `Run ${workflowBody.name} once for task ${taskId}`,
+    description: `Run ${workflowBody.name} once for task ${taskId}; idempotency=${idempotencyKey}; event=${event.id}`,
     schedule: { type: "once", at: new Date(Date.now() + 1000).toISOString() },
     target: { type: "workflow", workflowId: "<created-workflow-id>" },
     overlap: "skip",
@@ -5185,15 +5207,22 @@ eventsHandle.command("todos-task").description("create a one-shot worker/verifie
     leaseMs: 90 * 60000
   };
   if (opts.dryRun) {
-    print({ event, workflow: workflowBody, loop: loopInput }, `dry-run ${loopName}`);
+    print({ deduped: false, idempotencyKey, event, workflow: workflowBody, loop: loopInput }, `dry-run ${loopName}`);
     return;
   }
   const store = new Store;
   try {
-    const existingLoop = store.findLoopByName(loopName);
+    const existingLoop = store.findLoopByName(loopName) ?? store.findLoopByName(legacyLoopName);
     if (existingLoop) {
       const existingWorkflow2 = existingLoop.target.type === "workflow" ? store.getWorkflow(existingLoop.target.workflowId) : undefined;
-      print({ deduped: true, event, workflow: existingWorkflow2 ? publicWorkflow(existingWorkflow2) : undefined, loop: publicLoop(existingLoop) }, `deduped existing loop ${existingLoop.id} (${existingLoop.name})`);
+      print({
+        deduped: true,
+        idempotencyKey,
+        dedupedBy: existingLoop.name === loopName ? "idempotency" : "legacy-event-name",
+        event,
+        workflow: existingWorkflow2 ? publicWorkflow(existingWorkflow2) : undefined,
+        loop: publicLoop(existingLoop)
+      }, `deduped existing loop ${existingLoop.id} (${existingLoop.name}) for event=${event.id} idempotency=${idempotencyKey}`);
       return;
     }
     const existingWorkflow = store.findWorkflowByName(workflowBody.name);
@@ -5202,7 +5231,7 @@ eventsHandle.command("todos-task").description("create a one-shot worker/verifie
       ...loopInput,
       target: { type: "workflow", workflowId: workflow.id }
     });
-    print({ deduped: false, event, workflow: publicWorkflow(workflow), loop: publicLoop(loop) }, `created ${loop.id} (${loop.name}) workflow=${workflow.name}`);
+    print({ deduped: false, idempotencyKey, event, workflow: publicWorkflow(workflow), loop: publicLoop(loop) }, `created ${loop.id} (${loop.name}) workflow=${workflow.name} event=${event.id} idempotency=${idempotencyKey}`);
   } finally {
     store.close();
   }

package/dist/daemon/index.js

@@ -4276,7 +4276,7 @@ function enableStartup(result) {
 // package.json
 var package_default = {
   name: "@hasna/loops",
-  version: "0.3.13",
+  version: "0.3.14",
   description: "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   type: "module",
   main: "dist/index.js",
@@ -4340,7 +4340,7 @@ var package_default = {
     bun: ">=1.0.0"
   },
   dependencies: {
-    "@hasna/events": "^0.1.8",
+    "@hasna/events": "^0.1.9",
     "@hasna/machines": "0.0.49",
     "@openrouter/ai-sdk-provider": "2.9.1",
     ai: "6.0.204",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/loops",
-  "version": "0.3.13",
+  "version": "0.3.14",
   "description": "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   "type": "module",
   "main": "dist/index.js",
@@ -64,7 +64,7 @@
     "bun": ">=1.0.0"
   },
   "dependencies": {
-    "@hasna/events": "^0.1.8",
+    "@hasna/events": "^0.1.9",
     "@hasna/machines": "0.0.49",
     "@openrouter/ai-sdk-provider": "2.9.1",
     "ai": "6.0.204",