@dtlabs/ai-toolkit 0.16.7 → 0.16.9

package/CHANGELOG.md

@@ -1,4 +1,20 @@
 ## 0.1.4 (2026-07-21)
+## [0.16.9](https://github.com/dtlab-tech/ai-toolkit/compare/v0.16.8...v0.16.9) (2026-10-07)
+
+
+### Bug Fixes
+
+* **task-executor:** let "skipped" satisfy a downstream dependency ([f00d3c6](https://github.com/dtlab-tech/ai-toolkit/commit/f00d3c68324c0ca7f1d8f965b15288027830fd01))
+* **task-executor:** let "skipped" satisfy a downstream dependency ([6b48a61](https://github.com/dtlab-tech/ai-toolkit/commit/6b48a619e64f497b9b93e4a1a0254105eda1b718))
+
+## [0.16.8](https://github.com/dtlab-tech/ai-toolkit/compare/v0.16.7...v0.16.8) (2026-10-07)
+
+
+### Bug Fixes
+
+* **task-executor:** treat a zero-diff checkpoint as a valid no-op ([a587ee0](https://github.com/dtlab-tech/ai-toolkit/commit/a587ee0a88f24934235f64e9fbc9c395a76001fb))
+* **task-executor:** treat a zero-diff checkpoint as a valid no-op ([568e590](https://github.com/dtlab-tech/ai-toolkit/commit/568e590f8359c405561ef7e23ca626ddcecb9b12))
+
 ## [0.16.7](https://github.com/dtlab-tech/ai-toolkit/compare/v0.16.6...v0.16.7) (2026-10-07)
 
 

package/lib/task-executor/index.js

@@ -2119,6 +2119,30 @@ async function _runTaskToResolution(ctx) {
       continue;
     }
 
+    if (changedPaths.length === 0) {
+      // Verification and review both confirm the task's deliverable already
+      // matches its expected baseline — there is nothing for THIS attempt to
+      // stage or commit (a prior manual commit, an earlier attempt, or a
+      // prerequisite task already produced it). git.stageTaskFiles()
+      // deliberately refuses an empty changedPaths array ("must be a
+      // non-empty array — explicit enumeration, never a wildcard") — calling
+      // it here would throw STAGING_VALIDATION_ERROR uncaught by anything in
+      // this loop, crashing the whole execute() run instead of completing
+      // one task cleanly. Confirmed against a real run: a retried INFRA task
+      // whose deliverable had already been committed manually hit exactly
+      // this on its second attempt, after verification and review both
+      // legitimately passed. Mark the task 'skipped' instead of forcing it
+      // through a checkpoint pipeline that has nothing to stage — already a
+      // first-class terminal-success outcome (TASK_STATUSES; this loop's own
+      // allTerminalSuccess check above already includes it, and reconcile's
+      // _classifyTask already special-cases task.status === 'skipped' before
+      // ever looking at an attempt's stage).
+      state = store.readState(executionRoot, runId);
+      state = state.setTaskStatus(taskId, 'skipped');
+      store.writeState(executionRoot, runId, state);
+      return;
+    }
+
     // Checkpoint: stage first (US-05-TASK-BE-02) so its OWN write-tree
     // result becomes the checkpoint intent's expectedTreeSha, THEN persist
     // the intent (US-05-TASK-BE-01) with that now-known treeSha, THEN commit
@@ -2853,7 +2877,17 @@ async function execute(args) {
         if (t.status !== 'pending') return false;
         return t.dependencies.every(function (depId) {
           const dep = state.tasks[depId];
-          return dep && (dep.status === 'checkpointed' || dep.status === 'integrated');
+          // 'skipped' must satisfy a dependency exactly like 'checkpointed'/
+          // 'integrated' do — it is already treated as terminal success by
+          // both the nonTerminalIds filter just above and the allTerminalSuccess
+          // check below (and by reconcile's _classifyTask). Omitting it here
+          // left any task depending on a 'skipped' one stuck 'pending' forever,
+          // even though the rest of this run correctly treated 'skipped' as a
+          // completed, successful outcome — confirmed against a real run: both
+          // tasks that reached 'skipped' (the Bug 4 no-op-checkpoint fix) had
+          // downstream dependents that never got scheduled, blocking the
+          // entire remaining 64-task run.
+          return dep && (dep.status === 'checkpointed' || dep.status === 'integrated' || dep.status === 'skipped');
         });
       });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dtlabs/ai-toolkit",
-  "version": "0.16.7",
+  "version": "0.16.9",
   "description": "AI Toolkit — reusable agents and procedures for developers to build AI-powered applications.",
   "files": [
     "docs/",