@kitsy/coop-core 2.2.4 → 2.2.5

package/dist/index.cjs

@@ -3704,6 +3704,23 @@ function clone_ledger2(ledger) {
 function normalize_track3(track) {
   return (track ?? "unassigned").trim().toLowerCase();
 }
+function promotion_timestamp(task, track) {
+  if (!task.promoted_at) {
+    return 0;
+  }
+  const promotedTrack = task.promoted_track?.trim();
+  const scopedTrack = track?.trim();
+  if (promotedTrack) {
+    if (!scopedTrack) {
+      return 0;
+    }
+    if (normalize_track3(promotedTrack) !== normalize_track3(scopedTrack)) {
+      return 0;
+    }
+  }
+  const parsed = Date.parse(task.promoted_at);
+  return Number.isNaN(parsed) ? 0 : parsed;
+}
 function task_matches_track(task, track) {
   const normalized = normalize_track3(track);
   if (normalize_track3(task.track) === normalized) {
@@ -3809,6 +3826,11 @@ function schedule_next(graph, options = {}) {
     fits_wip: true
   }));
   scored.sort((a, b) => {
+    const promotionA = promotion_timestamp(a.task, options.track);
+    const promotionB = promotion_timestamp(b.task, options.track);
+    if (promotionA !== promotionB) {
+      return promotionB - promotionA;
+    }
     if (a.score !== b.score) return b.score - a.score;
     return a.task.id.localeCompare(b.task.id);
   });
@@ -4765,6 +4787,10 @@ function isIsoDate(value) {
   }
   return date.toISOString().slice(0, 10) === value;
 }
+function isIsoDateTime(value) {
+  const date = new Date(value);
+  return !Number.isNaN(date.valueOf());
+}
 function validateStringArrayField(errors, field, value, options = {}) {
   if (value === void 0) {
     return;
@@ -4891,6 +4917,28 @@ function validateStructural(task, context = {}) {
   validateStringArrayField(errors, "fix_versions", task.fix_versions);
   validateStringArrayField(errors, "released_in", task.released_in);
   validatePriorityContext(errors, task.priority_context);
+  if (task.promoted_at !== void 0) {
+    if (typeof task.promoted_at !== "string" || !isIsoDateTime(task.promoted_at)) {
+      errors.push(
+        error4(
+          "promoted_at",
+          "struct.promoted_at_iso_datetime",
+          "Field 'promoted_at' must be an ISO datetime string."
+        )
+      );
+    }
+  }
+  if (task.promoted_track !== void 0 && task.promoted_track !== null) {
+    if (typeof task.promoted_track !== "string" || task.promoted_track.trim().length === 0) {
+      errors.push(
+        error4(
+          "promoted_track",
+          "struct.promoted_track_string",
+          "Field 'promoted_track' must be a non-empty string or null."
+        )
+      );
+    }
+  }
   if (task.story_points !== void 0 && (!Number.isFinite(task.story_points) || task.story_points < 0)) {
     errors.push(
       error4(

package/dist/index.d.cts

@@ -305,6 +305,8 @@ interface TaskPlanning {
     track?: string;
     delivery_tracks?: string[];
     priority_context?: Record<string, TaskPriority>;
+    promoted_at?: string;
+    promoted_track?: string | null;
     assignee?: string | null;
     depends_on?: string[];
     tags?: string[];

package/dist/index.d.ts

@@ -305,6 +305,8 @@ interface TaskPlanning {
     track?: string;
     delivery_tracks?: string[];
     priority_context?: Record<string, TaskPriority>;
+    promoted_at?: string;
+    promoted_track?: string | null;
     assignee?: string | null;
     depends_on?: string[];
     tags?: string[];

package/dist/index.js

@@ -2620,6 +2620,23 @@ function clone_ledger(ledger) {
 function normalize_track2(track) {
   return (track ?? "unassigned").trim().toLowerCase();
 }
+function promotion_timestamp(task, track) {
+  if (!task.promoted_at) {
+    return 0;
+  }
+  const promotedTrack = task.promoted_track?.trim();
+  const scopedTrack = track?.trim();
+  if (promotedTrack) {
+    if (!scopedTrack) {
+      return 0;
+    }
+    if (normalize_track2(promotedTrack) !== normalize_track2(scopedTrack)) {
+      return 0;
+    }
+  }
+  const parsed = Date.parse(task.promoted_at);
+  return Number.isNaN(parsed) ? 0 : parsed;
+}
 function task_matches_track(task, track) {
   const normalized = normalize_track2(track);
   if (normalize_track2(task.track) === normalized) {
@@ -2725,6 +2742,11 @@ function schedule_next(graph, options = {}) {
     fits_wip: true
   }));
   scored.sort((a, b) => {
+    const promotionA = promotion_timestamp(a.task, options.track);
+    const promotionB = promotion_timestamp(b.task, options.track);
+    if (promotionA !== promotionB) {
+      return promotionB - promotionA;
+    }
     if (a.score !== b.score) return b.score - a.score;
     return a.task.id.localeCompare(b.task.id);
   });
@@ -3681,6 +3703,10 @@ function isIsoDate(value) {
   }
   return date.toISOString().slice(0, 10) === value;
 }
+function isIsoDateTime(value) {
+  const date = new Date(value);
+  return !Number.isNaN(date.valueOf());
+}
 function validateStringArrayField(errors, field, value, options = {}) {
   if (value === void 0) {
     return;
@@ -3807,6 +3833,28 @@ function validateStructural(task, context = {}) {
   validateStringArrayField(errors, "fix_versions", task.fix_versions);
   validateStringArrayField(errors, "released_in", task.released_in);
   validatePriorityContext(errors, task.priority_context);
+  if (task.promoted_at !== void 0) {
+    if (typeof task.promoted_at !== "string" || !isIsoDateTime(task.promoted_at)) {
+      errors.push(
+        error4(
+          "promoted_at",
+          "struct.promoted_at_iso_datetime",
+          "Field 'promoted_at' must be an ISO datetime string."
+        )
+      );
+    }
+  }
+  if (task.promoted_track !== void 0 && task.promoted_track !== null) {
+    if (typeof task.promoted_track !== "string" || task.promoted_track.trim().length === 0) {
+      errors.push(
+        error4(
+          "promoted_track",
+          "struct.promoted_track_string",
+          "Field 'promoted_track' must be a non-empty string or null."
+        )
+      );
+    }
+  }
   if (task.story_points !== void 0 && (!Number.isFinite(task.story_points) || task.story_points < 0)) {
     errors.push(
       error4(

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kitsy/coop-core",
   "description": "Core models, parser, validator, graph, and planning engine for COOP.",
-  "version": "2.2.4",
+  "version": "2.2.5",
   "license": "MIT",
   "type": "module",
   "publishConfig": {