@hasna/loops 0.3.28 → 0.3.30

package/dist/cli/index.js

@@ -5253,7 +5253,7 @@ function buildScriptInventoryReport(store, opts = {}) {
 // package.json
 var package_default = {
   name: "@hasna/loops",
-  version: "0.3.28",
+  version: "0.3.30",
   description: "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   type: "module",
   main: "dist/index.js",
@@ -6636,6 +6636,10 @@ function routeThrottleDryRunPreview(args) {
     limits: args.limits
   };
 }
+function findLoopByTaskIdempotency(store, idempotencyKey) {
+  const marker = `idempotency=${idempotencyKey}`;
+  return store.listLoops({ includeArchived: true, limit: 1e5 }).find((loop) => loop.description?.includes(marker));
+}
 async function readEventEnvelopeFromStdin() {
   const raw = process.env.HASNA_EVENT_JSON || await Bun.stdin.text();
   const event = JSON.parse(raw);
@@ -6687,7 +6691,7 @@ function routeTodosTaskEvent(event, opts) {
   if (!opts.dryRun) {
     const store2 = new Store;
     try {
-      const existingLoop = store2.findLoopByName(loopName) ?? store2.findLoopByName(legacyLoopName);
+      const existingLoop = store2.findLoopByName(loopName) ?? store2.findLoopByName(legacyLoopName) ?? findLoopByTaskIdempotency(store2, idempotencyKey);
       if (existingLoop) {
         const existingWorkflow = existingLoop.target.type === "workflow" ? store2.getWorkflow(existingLoop.target.workflowId) : undefined;
         return {
@@ -6775,7 +6779,7 @@ function routeTodosTaskEvent(event, opts) {
       event: event.id
     }, {}) : undefined;
     const outcome = store.writeTransaction(() => {
-      const existingLoop = store.findLoopByName(loopName) ?? store.findLoopByName(legacyLoopName);
+      const existingLoop = store.findLoopByName(loopName) ?? store.findLoopByName(legacyLoopName) ?? findLoopByTaskIdempotency(store, idempotencyKey);
       if (existingLoop) {
         const existingWorkflow2 = existingLoop.target.type === "workflow" ? store.getWorkflow(existingLoop.target.workflowId) : undefined;
         return { kind: "deduped", existingLoop, existingWorkflow: existingWorkflow2 };
@@ -6852,6 +6856,10 @@ function taskListId(task) {
 function taskProjectId(task) {
   return taskField(task, ["project_id", "projectId"]);
 }
+function taskProjectPath(task) {
+  const metadata = objectField(task.metadata) ?? {};
+  return taskField(task, ["working_dir", "workingDir", "project_path", "projectPath", "cwd"]) ?? taskEventField(metadata, ["working_dir", "workingDir", "project_path", "projectPath", "project_canonical_path", "cwd"]);
+}
 function taskDrainEvent(task) {
   const taskId = taskField(task, ["id", "task_id", "taskId"]);
   if (!taskId)
@@ -6917,6 +6925,15 @@ function taskMatchesDrainFilters(task, filters) {
     return false;
   if (filters.taskListId && taskListId(task) !== filters.taskListId)
     return false;
+  if (filters.projectPathPrefix) {
+    const path = taskProjectPath(task);
+    if (!path)
+      return false;
+    const normalizedPath = normalizeRoutePath(path) ?? resolve2(path);
+    const normalizedPrefix = normalizeRoutePath(filters.projectPathPrefix) ?? resolve2(filters.projectPathPrefix);
+    if (normalizedPath !== normalizedPrefix && !normalizedPath.startsWith(`${normalizedPrefix}/`))
+      return false;
+  }
   if (filters.tags.length) {
     const taskTags = new Set(tagsFromValue(task.tags));
     for (const tag of filters.tags) {
@@ -7082,19 +7099,20 @@ eventsHandle.command("todos-task").description("create a one-shot worker/verifie
   print(result.value, result.human);
 });
 var eventsDrain = events.command("drain").description("drain durable source queues into bounded OpenLoops workflows");
-eventsDrain.command("todos-task").description("drain ready todos tasks into bounded worker/verifier workflow loops").option("--todos-project <path>", "todos storage project path", defaultLoopsProject()).option("--todos-project-id <id>", "filter todos ready output to one todos project id").option("--task-list <id-or-slug>", "filter ready tasks to one task-list id, slug, or name").option("--tags <tags>", "require all comma-separated tags before routing").option("--tag <tags>", "alias for --tags").option("--limit <n>", "maximum filtered ready-task candidates to consider", "50").option("--scan-limit <n>", "maximum raw todos ready rows to fetch before filters; defaults to 500 when filters are used").option("--max-dispatch <n>", "maximum new workflow loops to create in this drain run", "1").option("--evidence-dir <path>", "write a JSON drain report to this directory").option("--provider <provider>", "agent provider", "codewith").option("--auth-profile <profile>", "provider-native auth profile; currently supported for codewith").option("--auth-profile-pool <profiles>", "comma-separated provider-native auth profile pool").option("--worker-auth-profile <profile>", "provider-native auth profile for worker step").option("--verifier-auth-profile <profile>", "provider-native auth profile for verifier step").option("--account <profile>", "OpenAccounts profile name").option("--account-pool <profiles>", "comma-separated OpenAccounts profile pool").option("--worker-account <profile>", "OpenAccounts profile for worker step").option("--verifier-account <profile>", "OpenAccounts profile for verifier step").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("--project-group <name>", "optional project group for concurrency limits").option("--max-active <n>", "skip creating a workflow when this many active routed workflows already exist globally").option("--max-active-per-project <n>", "skip creating a workflow when this many active routed workflows already exist for the project").option("--max-active-per-project-group <n>", "skip creating a workflow when this many active routed workflows already exist for the project group").option("--worktree-mode <mode>", "worktree isolation mode: auto, required, off, or main", "auto").option("--worktree-root <path>", "base directory for OpenLoops-managed git worktrees").option("--worktree-branch-prefix <prefix>", "branch prefix for generated task worktrees", "openloops").option("--name-prefix <prefix>", "workflow/loop name prefix", "event:todos-task").option("--preflight", "check generated workflow steps before storing workflow loops").option("--dry-run", "preview selected tasks and generated workflow loops without storing anything").action((opts) => {
+eventsDrain.command("todos-task").description("drain ready todos tasks into bounded worker/verifier workflow loops").option("--todos-project <path>", "todos storage project path", defaultLoopsProject()).option("--todos-project-id <id>", "filter todos ready output to one todos project id").option("--task-list <id-or-slug>", "filter ready tasks to one task-list id, slug, or name").option("--project-path-prefix <path>", "filter ready tasks to a project/repo path prefix").option("--tags <tags>", "require all comma-separated tags before routing").option("--tag <tags>", "alias for --tags").option("--limit <n>", "maximum filtered ready-task candidates to consider", "50").option("--scan-limit <n>", "maximum raw todos ready rows to fetch before filters; defaults to 500 when filters are used").option("--max-dispatch <n>", "maximum new workflow loops to create in this drain run", "1").option("--evidence-dir <path>", "write a JSON drain report to this directory").option("--provider <provider>", "agent provider", "codewith").option("--auth-profile <profile>", "provider-native auth profile; currently supported for codewith").option("--auth-profile-pool <profiles>", "comma-separated provider-native auth profile pool").option("--worker-auth-profile <profile>", "provider-native auth profile for worker step").option("--verifier-auth-profile <profile>", "provider-native auth profile for verifier step").option("--account <profile>", "OpenAccounts profile name").option("--account-pool <profiles>", "comma-separated OpenAccounts profile pool").option("--worker-account <profile>", "OpenAccounts profile for worker step").option("--verifier-account <profile>", "OpenAccounts profile for verifier step").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("--project-group <name>", "optional project group for concurrency limits").option("--max-active <n>", "skip creating a workflow when this many active routed workflows already exist globally").option("--max-active-per-project <n>", "skip creating a workflow when this many active routed workflows already exist for the project").option("--max-active-per-project-group <n>", "skip creating a workflow when this many active routed workflows already exist for the project group").option("--worktree-mode <mode>", "worktree isolation mode: auto, required, off, or main", "auto").option("--worktree-root <path>", "base directory for OpenLoops-managed git worktrees").option("--worktree-branch-prefix <prefix>", "branch prefix for generated task worktrees", "openloops").option("--name-prefix <prefix>", "workflow/loop name prefix", "event:todos-task").option("--preflight", "check generated workflow steps before storing workflow loops").option("--dry-run", "preview selected tasks and generated workflow loops without storing anything").action((opts) => {
   const maxDispatch = positiveInteger(opts.maxDispatch ?? "1", "--max-dispatch") ?? 1;
   const todosProject = opts.todosProject ?? defaultLoopsProject();
   const requiredTags = splitList(opts.tags ?? opts.tag) ?? [];
   const taskListFilter = resolveTaskListFilter(todosProject, opts.taskList);
   const candidateLimit = positiveInteger(opts.limit ?? "50", "--limit") ?? 50;
-  const hasPostFilters = Boolean(opts.todosProjectId || taskListFilter || requiredTags.length);
+  const hasPostFilters = Boolean(opts.todosProjectId || taskListFilter || opts.projectPathPrefix || requiredTags.length);
   const defaultScanLimit = hasPostFilters ? Math.max(candidateLimit, 500) : candidateLimit;
   const scanLimit = positiveInteger(opts.scanLimit ?? String(defaultScanLimit), "--scan-limit") ?? defaultScanLimit;
   const ready = loadReadyTodosTasks(opts, scanLimit);
   const filteredCandidates = ready.filter((task) => taskMatchesDrainFilters(task, {
     projectId: opts.todosProjectId,
     taskListId: taskListFilter,
+    projectPathPrefix: opts.projectPathPrefix,
     tags: requiredTags
   }));
   const candidates = filteredCandidates.slice(0, candidateLimit);
@@ -7117,6 +7135,7 @@ eventsDrain.command("todos-task").description("drain ready todos tasks into boun
     todosProjectId: opts.todosProjectId,
     taskList: opts.taskList,
     taskListId: taskListFilter,
+    projectPathPrefix: opts.projectPathPrefix,
     tags: requiredTags,
     limit: candidateLimit,
     scanLimit,

package/dist/daemon/index.js

@@ -4574,7 +4574,7 @@ function enableStartup(result) {
 // package.json
 var package_default = {
   name: "@hasna/loops",
-  version: "0.3.28",
+  version: "0.3.30",
   description: "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   type: "module",
   main: "dist/index.js",

package/docs/USAGE.md

@@ -320,6 +320,7 @@ loops events drain todos-task \
   --todos-project /home/hasna/.hasna/loops \
   --task-list repoops-pr-queue \
   --tags auto:route \
+  --project-path-prefix /home/hasna/workspace/hasna/opensource \
   --provider codewith \
   --auth-profile-pool account004,account005,account006 \
   --project-group oss \
@@ -334,14 +335,16 @@ loops events drain todos-task \
 
 `--max-dispatch` caps new workflow-loop creation per drain run. `--limit` caps
 filtered ready-task candidates, while `--scan-limit` controls how many raw
-`todos ready` rows are fetched before filters. When `--task-list`, `--tags`, or
-`--todos-project-id` are set, the default scan limit is raised to 500 so a busy
-shared queue is less likely to starve project-specific drains. The route
-throttle flags are still checked for every candidate, so a drain can safely run
-every few minutes as a deterministic command loop: it fills only available
-capacity, writes compact JSON evidence when requested, and leaves excess ready
-tasks in todos for a later drain pass. Use `--dry-run` to preview candidates and
-rendered workflows without mutating OpenLoops state.
+`todos ready` rows are fetched before filters. Use `--task-list`, `--tags`,
+`--todos-project-id`, and `--project-path-prefix` to keep each drain aligned
+with the route/name-prefix it services. When any of those filters are set, the
+default scan limit is raised to 500 so a busy shared queue is less likely to
+starve project-specific drains. The route throttle flags are still checked for
+every candidate, so a drain can safely run every few minutes as a deterministic
+command loop: it fills only available capacity, writes compact JSON evidence
+when requested, and leaves excess ready tasks in todos for a later drain pass.
+Use `--dry-run` to preview candidates and rendered workflows without mutating
+OpenLoops state.
 
 For other Hasna apps that expose `@hasna/events` webhooks, use the generic
 handler:

package/package.json

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