taskforce-loop-engineering 0.15.5 → 0.15.6

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+## 0.15.6 - 2026-08-24
+
+- Allow project configurations to use an external authoritative `backlogSource` without duplicating an embedded backlog registry.
+- Keep project status fail-closed when neither an embedded backlog nor an external backlog source is configured.
+- Suppress false registry-drift findings when no embedded projection is intentionally present, while retaining drift detection when both representations exist.
+- Add regression coverage for external-only authoritative project backlogs.
+
 ## 0.15.5 - 2026-08-24
 
 - Treat embedded-runtime `incomplete_turn` / abandoned-liveness trailers as recoverable interruptions even when the dispatcher wrapper exits zero, preventing partial work from being accepted or stale human gates from being replayed.

package/lib/core.mjs

@@ -1669,7 +1669,12 @@ function validateProjectSpec(spec) {
     normalizeLoopId(queue.queue);
     if (!['code', 'standard'].includes(queue.kind)) throw new Error(`Unsupported project queue kind: ${queue.kind}`);
   }
-  if (!Array.isArray(spec.backlog) || spec.backlog.length === 0) throw new Error('Project spec backlog must be non-empty.');
+  const hasEmbeddedBacklog = Array.isArray(spec.backlog) && spec.backlog.length > 0;
+  const configuredBacklogSource = spec.backlogSource ?? spec.authoritativeBacklog;
+  const hasConfiguredBacklog = typeof configuredBacklogSource === 'string' && configuredBacklogSource.trim().length > 0;
+  if (!hasEmbeddedBacklog && !hasConfiguredBacklog) {
+    throw new Error('Project spec must provide a non-empty backlog or backlogSource.');
+  }
 }
 
 export async function projectPlan(root, options = {}) {
@@ -1801,17 +1806,20 @@ export async function projectStatus(root, options = {}) {
       acceptanceLedger = { file: path.relative(root, ledgerFile), readable: false, error: error.message };
     }
   }
-  const registryItems = Array.isArray(spec.backlog) ? spec.backlog : [];
+  const hasEmbeddedBacklog = Array.isArray(spec.backlog) && spec.backlog.length > 0;
+  const registryItems = hasEmbeddedBacklog ? spec.backlog : [];
   const sourceItems = backlog ? await readJson(backlogFile).then((loaded) => loaded.items ?? loaded.tasks ?? []) : [];
   const registryById = new Map(registryItems.map((item) => [item.id, item]));
   const sourceById = new Map(sourceItems.map((item) => [item.id, item]));
   const drift = [];
-  for (const id of new Set([...registryById.keys(), ...sourceById.keys()])) {
-    const registry = registryById.get(id);
-    const authoritative = sourceById.get(id);
-    if (!registry || !authoritative) drift.push({ id, kind: registry ? 'missing_from_authoritative_backlog' : 'missing_from_registry' });
-    else if (registry.status !== authoritative.status || Boolean(registry.required) !== Boolean(authoritative.required)) {
-      drift.push({ id, kind: 'status_or_scope_mismatch', registry: { status: registry.status, required: registry.required }, authoritative: { status: authoritative.status, required: authoritative.required } });
+  if (hasEmbeddedBacklog) {
+    for (const id of new Set([...registryById.keys(), ...sourceById.keys()])) {
+      const registry = registryById.get(id);
+      const authoritative = sourceById.get(id);
+      if (!registry || !authoritative) drift.push({ id, kind: registry ? 'missing_from_authoritative_backlog' : 'missing_from_registry' });
+      else if (registry.status !== authoritative.status || Boolean(registry.required) !== Boolean(authoritative.required)) {
+        drift.push({ id, kind: 'status_or_scope_mismatch', registry: { status: registry.status, required: registry.required }, authoritative: { status: authoritative.status, required: authoritative.required } });
+      }
     }
   }
   const projectCompletion = acceptanceLedger?.status === 'accepted' && acceptanceLedger.unmet.length === 0 && acceptanceLedger.blockers.length === 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taskforce-loop-engineering",
-  "version": "0.15.5",
+  "version": "0.15.6",
   "private": false,
   "description": "OpenClaw-native loop engineering CLI, templates, and skill for verifiable agent work loops.",
   "type": "module",

package/scripts/project-gate-reconciliation-self-test.mjs

@@ -91,6 +91,27 @@ assert.equal(drifted.authority.acceptanceLedger, 'project/acceptance-ledger.json
 assert.equal(drifted.consistency.ok, false);
 assert(drifted.needsAttention.includes('authoritative_source_drift'));
 
+// A project may keep its authoritative backlog exclusively in backlogSource.
+// Requiring a duplicate embedded backlog makes the two copies drift and used
+// to prevent project-status from reading an otherwise valid project ledger.
+await writeFile(projectFile, `${JSON.stringify({
+  ...spec,
+  backlog: undefined,
+  backlogSource: 'project/backlog.json',
+  acceptanceLedger: 'project/acceptance-ledger.json',
+  terminalContract: 'project/terminal.md'
+}, null, 2)}\n`);
+const externalOnly = await projectStatus(root, { project: 'openreel' });
+assert.equal(externalOnly.backlog.file, 'project/backlog.json');
+assert.equal(externalOnly.backlog.count, 1);
+assert.equal(externalOnly.consistency.ok, true);
+await writeFile(projectFile, `${JSON.stringify({
+  ...spec,
+  backlogSource: 'project/backlog.json',
+  acceptanceLedger: 'project/acceptance-ledger.json',
+  terminalContract: 'project/terminal.md'
+}, null, 2)}\n`);
+
 // A ready milestone with project in progress and a deferred authorization is
 // converted into a structured waiting gate, not left as prose on a done task.
 const deferred = await enqueueTask(root, { queue, title: 'OpenReel deferred S-01', task: 'Project openreel S-01', projectId: 'openreel', sourceChannel: 'test', sourceTarget: 'owner' });