trackops 2.0.6 → 2.1.0

package/lib/quality-assert.js

@@ -0,0 +1,49 @@
+"use strict";
+
+function assertControlInvariants(control) {
+  if (!control || typeof control !== "object") {
+    throw new Error("TRACKOPS_ASSERT: control state must be an object.");
+  }
+  if (!Array.isArray(control.tasks)) {
+    throw new Error("TRACKOPS_ASSERT: control.tasks must be an array.");
+  }
+
+  const ids = new Set();
+  const duplicates = new Set();
+  for (const task of control.tasks) {
+    const id = String(task?.id || "").trim();
+    if (!id) {
+      throw new Error("TRACKOPS_ASSERT: every task must have a non-empty id.");
+    }
+    if (ids.has(id)) duplicates.add(id);
+    ids.add(id);
+  }
+
+  if (duplicates.size) {
+    throw new Error(`TRACKOPS_ASSERT: duplicate task ids detected: ${[...duplicates].join(", ")}`);
+  }
+
+  for (const task of control.tasks) {
+    const id = String(task.id || "").trim();
+    const parentId = String(task.parentId || "").trim();
+    if (parentId) {
+      if (parentId === id) {
+        throw new Error(`TRACKOPS_ASSERT: task '${id}' cannot be its own parent.`);
+      }
+      if (!ids.has(parentId)) {
+        throw new Error(`TRACKOPS_ASSERT: task '${id}' references missing parent '${parentId}'.`);
+      }
+    }
+    for (const dep of Array.isArray(task.dependsOn) ? task.dependsOn : []) {
+      const depId = String(dep || "").trim();
+      if (!depId) continue;
+      if (depId === id) {
+        throw new Error(`TRACKOPS_ASSERT: task '${id}' cannot depend on itself.`);
+      }
+    }
+  }
+}
+
+module.exports = {
+  assertControlInvariants,
+};