@kitsy/coop-core 2.1.1 → 2.2.0

package/dist/index.cjs

@@ -85,6 +85,7 @@ __export(index_exports, {
   detect_cycle: () => detect_cycle,
   detect_delivery_risks: () => detect_delivery_risks,
   determinism_weight: () => determinism_weight,
+  effective_priority: () => effective_priority,
   effective_weekly_hours: () => effective_weekly_hours,
   effort_or_default: () => effort_or_default,
   ensureCoopLayout: () => ensureCoopLayout,
@@ -2172,23 +2173,30 @@ var TASK_FIELD_ORDER = [
   "aliases",
   "priority",
   "track",
+  "delivery_tracks",
+  "priority_context",
   "assignee",
   "depends_on",
   "tags",
   "delivery",
+  "fix_versions",
+  "released_in",
   "acceptance",
   "tests_required",
   "origin",
   "complexity",
   "determinism",
+  "story_points",
   "estimate",
   "resources",
+  "time",
   "execution",
   "artifacts",
   "governance",
   "risk",
   "metrics",
-  "enterprise"
+  "enterprise",
+  "comments"
 ];
 var ORDERED_TASK_FIELDS = new Set(TASK_FIELD_ORDER);
 function buildOrderedFrontmatter(task, raw) {
@@ -3393,6 +3401,13 @@ function detect_delivery_risks(delivery, graph, velocity, options = {}) {
 }
 
 // src/planning/scorer.ts
+function effective_priority(task, track) {
+  const candidate = track?.trim();
+  if (candidate && task.priority_context?.[candidate]) {
+    return task.priority_context[candidate];
+  }
+  return task.priority ?? "p2";
+}
 var DEFAULT_SCORE_WEIGHTS = {
   priority: {
     p0: 100,
@@ -3545,9 +3560,9 @@ function unresolved_dependencies(task, graph) {
     return !dep || dep.status !== "done" && dep.status !== "canceled";
   });
 }
-function priority_weight(task, config) {
+function priority_weight(task, config, track) {
   const weights = configured_weights(config);
-  const priority = task.priority ?? "p2";
+  const priority = effective_priority(task, track);
   return weights.priority[priority];
 }
 function urgency_weight(task, deliveries, today, config) {
@@ -3645,7 +3660,7 @@ function compute_score(task, graph, context = {}) {
   const deliveries = context.deliveries ?? graph.deliveries;
   const today = context.today ?? /* @__PURE__ */ new Date();
   const config = context.config;
-  return priority_weight(task, config) + urgency_weight(task, deliveries, today, config) + dependency_unlock_weight(task.id, graph, config) + critical_path_weight(task.id, context.cpm, config) + determinism_weight(task, config) + executor_fit_weight(task, context.target_executor, config) + type_weight(task, config) + complexity_penalty(task, config) + risk_penalty(task, config);
+  return priority_weight(task, config, context.track) + urgency_weight(task, deliveries, today, config) + dependency_unlock_weight(task.id, graph, config) + critical_path_weight(task.id, context.cpm, config) + determinism_weight(task, config) + executor_fit_weight(task, context.target_executor, config) + type_weight(task, config) + complexity_penalty(task, config) + risk_penalty(task, config);
 }
 
 // src/planning/scheduler.ts
@@ -3686,6 +3701,13 @@ function clone_ledger2(ledger) {
 function normalize_track3(track) {
   return (track ?? "unassigned").trim().toLowerCase();
 }
+function task_matches_track(task, track) {
+  const normalized = normalize_track3(track);
+  if (normalize_track3(task.track) === normalized) {
+    return true;
+  }
+  return (task.delivery_tracks ?? []).some((candidate) => normalize_track3(candidate) === normalized);
+}
 function find_track_slots2(ledger, track) {
   const normalized = normalize_track3(track);
   return ledger.slots.get(normalized) ?? ledger.slots.get("unassigned") ?? null;
@@ -3753,7 +3775,7 @@ function schedule_next(graph, options = {}) {
   );
   let filtered = ready_tasks;
   if (options.track) {
-    filtered = filtered.filter((task) => (task.track ?? "unassigned") === options.track);
+    filtered = filtered.filter((task) => task_matches_track(task, options.track));
   }
   const deliveryFilter = options.delivery;
   if (deliveryFilter) {
@@ -3776,6 +3798,7 @@ function schedule_next(graph, options = {}) {
       cpm,
       today: options.today ?? /* @__PURE__ */ new Date(),
       target_executor: options.executor,
+      track: options.track,
       config: options.config
     }),
     readiness: compute_readiness(task, graph),
@@ -4656,6 +4679,18 @@ function validateSemantic(task, context = {}) {
       }
     }
   }
+  if (task.time?.planned_hours !== void 0 && task.time.logs) {
+    const plannedTotal = task.time.logs.filter((entry) => entry.kind === "planned").reduce((sum, entry) => sum + entry.hours, 0);
+    if (plannedTotal > 0 && plannedTotal !== task.time.planned_hours) {
+      issues.push(
+        warning2(
+          "time.planned_hours",
+          "sem.time_planned_mismatch",
+          `Task planned_hours (${task.time.planned_hours}) does not match total planned logs (${plannedTotal}).`
+        )
+      );
+    }
+  }
   const taskStatuses = asMap(context.taskStatuses);
   if (task.status === "done" && (task.depends_on?.length ?? 0) > 0) {
     const unresolved = (task.depends_on ?? []).filter((depId) => taskStatuses.get(depId) !== "done");
@@ -4744,6 +4779,45 @@ function validateStringArrayField(errors, field, value, options = {}) {
     }
   }
 }
+function isPriority(value) {
+  return typeof value === "string" && Object.values(TaskPriority).includes(value);
+}
+function validatePriorityContext(errors, value) {
+  if (value === void 0) {
+    return;
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    errors.push(
+      error4(
+        "priority_context",
+        "struct.priority_context_object",
+        "Field 'priority_context' must be an object keyed by track id."
+      )
+    );
+    return;
+  }
+  for (const [track, priority] of Object.entries(value)) {
+    if (!track.trim()) {
+      errors.push(
+        error4(
+          "priority_context",
+          "struct.priority_context_key",
+          "Field 'priority_context' keys must be non-empty track ids."
+        )
+      );
+      continue;
+    }
+    if (!isPriority(priority)) {
+      errors.push(
+        error4(
+          "priority_context",
+          "struct.priority_context_priority",
+          `Priority override for track '${track}' must be one of ${Object.values(TaskPriority).join(", ")}.`
+        )
+      );
+    }
+  }
+}
 function validateStructural(task, context = {}) {
   const errors = [];
   const required = ["id", "title", "type", "status", "created", "updated"];
@@ -4810,6 +4884,106 @@ function validateStructural(task, context = {}) {
   }
   validateStringArrayField(errors, "acceptance", task.acceptance);
   validateStringArrayField(errors, "tests_required", task.tests_required);
+  validateStringArrayField(errors, "delivery_tracks", task.delivery_tracks);
+  validateStringArrayField(errors, "fix_versions", task.fix_versions);
+  validateStringArrayField(errors, "released_in", task.released_in);
+  validatePriorityContext(errors, task.priority_context);
+  if (task.story_points !== void 0 && (!Number.isFinite(task.story_points) || task.story_points < 0)) {
+    errors.push(
+      error4(
+        "story_points",
+        "struct.story_points_non_negative",
+        "Field 'story_points' must be a non-negative number."
+      )
+    );
+  }
+  if (task.time !== void 0) {
+    if (!task.time || typeof task.time !== "object" || Array.isArray(task.time)) {
+      errors.push(error4("time", "struct.time_object", "Field 'time' must be an object."));
+    } else {
+      if (task.time.planned_hours !== void 0 && (!Number.isFinite(task.time.planned_hours) || task.time.planned_hours < 0)) {
+        errors.push(
+          error4(
+            "time.planned_hours",
+            "struct.time_planned_hours_non_negative",
+            "Field 'time.planned_hours' must be a non-negative number."
+          )
+        );
+      }
+      if (task.time.logs !== void 0) {
+        if (!Array.isArray(task.time.logs)) {
+          errors.push(error4("time.logs", "struct.time_logs_array", "Field 'time.logs' must be an array."));
+        } else {
+          for (const [index, entry] of task.time.logs.entries()) {
+            if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+              errors.push(
+                error4("time.logs", "struct.time_logs_object", `Entry ${index} in 'time.logs' must be an object.`)
+              );
+              continue;
+            }
+            const record = entry;
+            if (typeof record.at !== "string" || record.at.trim().length === 0) {
+              errors.push(error4("time.logs", "struct.time_logs_at", `Entry ${index} in 'time.logs' requires 'at'.`));
+            }
+            if (typeof record.actor !== "string" || record.actor.trim().length === 0) {
+              errors.push(
+                error4("time.logs", "struct.time_logs_actor", `Entry ${index} in 'time.logs' requires 'actor'.`)
+              );
+            }
+            if (record.kind !== "planned" && record.kind !== "worked") {
+              errors.push(
+                error4(
+                  "time.logs",
+                  "struct.time_logs_kind",
+                  `Entry ${index} in 'time.logs' must use kind planned|worked.`
+                )
+              );
+            }
+            if (typeof record.hours !== "number" || !Number.isFinite(record.hours) || record.hours < 0) {
+              errors.push(
+                error4(
+                  "time.logs",
+                  "struct.time_logs_hours",
+                  `Entry ${index} in 'time.logs' requires non-negative numeric 'hours'.`
+                )
+              );
+            }
+            if (record.note !== void 0 && typeof record.note !== "string") {
+              errors.push(
+                error4(
+                  "time.logs",
+                  "struct.time_logs_note",
+                  `Entry ${index} in 'time.logs' must use a string note when present.`
+                )
+              );
+            }
+          }
+        }
+      }
+    }
+  }
+  if (task.comments !== void 0) {
+    if (!Array.isArray(task.comments)) {
+      errors.push(error4("comments", "struct.comments_array", "Field 'comments' must be an array."));
+    } else {
+      for (const [index, entry] of task.comments.entries()) {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+          errors.push(error4("comments", "struct.comments_object", `Entry ${index} in 'comments' must be an object.`));
+          continue;
+        }
+        const record = entry;
+        if (typeof record.at !== "string" || record.at.trim().length === 0) {
+          errors.push(error4("comments", "struct.comments_at", `Entry ${index} in 'comments' requires 'at'.`));
+        }
+        if (typeof record.author !== "string" || record.author.trim().length === 0) {
+          errors.push(error4("comments", "struct.comments_author", `Entry ${index} in 'comments' requires 'author'.`));
+        }
+        if (typeof record.body !== "string" || record.body.trim().length === 0) {
+          errors.push(error4("comments", "struct.comments_body", `Entry ${index} in 'comments' requires 'body'.`));
+        }
+      }
+    }
+  }
   if (task.origin !== void 0) {
     if (!task.origin || typeof task.origin !== "object" || Array.isArray(task.origin)) {
       errors.push(error4("origin", "struct.origin_object", "Field 'origin' must be an object."));
@@ -5683,6 +5857,7 @@ function validateRepo(rootDir) {
   detect_cycle,
   detect_delivery_risks,
   determinism_weight,
+  effective_priority,
   effective_weekly_hours,
   effort_or_default,
   ensureCoopLayout,

package/dist/index.d.cts

@@ -285,14 +285,30 @@ interface TaskCore {
     created: string;
     updated: string;
 }
+interface TaskTimeLog {
+    at: string;
+    actor: string;
+    kind: "planned" | "worked";
+    hours: number;
+    note?: string;
+}
+interface TaskComment {
+    at: string;
+    author: string;
+    body: string;
+}
 interface TaskPlanning {
     aliases?: string[];
     priority?: TaskPriority;
     track?: string;
+    delivery_tracks?: string[];
+    priority_context?: Record<string, TaskPriority>;
     assignee?: string | null;
     depends_on?: string[];
     tags?: string[];
     delivery?: string | null;
+    fix_versions?: string[];
+    released_in?: string[];
     acceptance?: string[];
     tests_required?: string[];
     origin?: {
@@ -317,8 +333,13 @@ interface TaskResources {
 interface TaskEstimation {
     complexity?: TaskComplexity;
     determinism?: TaskDeterminism;
+    story_points?: number;
     estimate?: TaskEstimate;
     resources?: TaskResources;
+    time?: {
+        planned_hours?: number;
+        logs?: TaskTimeLog[];
+    };
 }
 interface RunbookStep {
     step: string;
@@ -380,6 +401,7 @@ interface TaskGovernance {
         target_cycle_time_days?: number;
     };
     enterprise?: Record<string, unknown>;
+    comments?: TaskComment[];
 }
 type Task = TaskCore & TaskPlanning & TaskEstimation & TaskExecution & TaskGovernance;
 interface TaskComputed {
@@ -1218,15 +1240,17 @@ interface ScoreContext {
     cpm?: CriticalPathResult;
     today?: string | Date;
     target_executor?: ExecutorType;
+    track?: string;
     config?: CoopConfig;
 }
+declare function effective_priority(task: Task, track?: string): TaskPriority;
 /**
  * Default readiness ranking weights used by `compute_score`.
  * [SPEC: Scheduler v2.0 §4.6]
  */
 declare const DEFAULT_SCORE_WEIGHTS: ScoreWeights;
 /** [SPEC: Scheduler v2.0 §4.6] */
-declare function priority_weight(task: Task, config?: CoopConfig): number;
+declare function priority_weight(task: Task, config?: CoopConfig, track?: string): number;
 /** [SPEC: Scheduler v2.0 §4.6] */
 declare function urgency_weight(task: Task, deliveries: Map<string, Delivery> | Delivery[], today: string | Date, config?: CoopConfig): number;
 /** [SPEC: Scheduler v2.0 §4.6] */
@@ -1501,4 +1525,4 @@ declare function validateRepo(rootDir: string): {
     warnings: string[];
 };
 
-export { type AIAgent, type AIResource, type AgentSpec, type AllocationResult, ArtifactType, type AuthConfig, type AuthPolicy, type AutoTransitionResult, type AvailabilityWindow, type BacklogItem, type BacklogItemData, COOP_EVENT_TYPES, CURRENT_SCHEMA_VERSION, type CapacityLedger, type ComparisonResult, type ComparisonRow, type ComputeNode, type ComputeResource, type CoopConfig, type CoopEvent, CoopEventEmitter, type CoopEventType, type CoopProjectRef, type CoopWorkspaceConfig, type CreateItemParams, type CriticalPathResult, type CriticalPathTaskMetrics, DEFAULT_SCORE_WEIGHTS, type Delivery, type DeliveryAtRisk, type DeliveryBudget, type DeliveryCommitted, type DeliveryGovernance, type DeliveryRisk, type DeliveryRiskType, type DeliveryScope, DeliveryStatus, type DetectedDeliveryRisk, type EffectiveCapacity, type EventByType, type ExecutionConstraints, type ExecutionPermissions, ExecutorType, type ExternalDependencyRef, type ExternalDependencyResolution, type ExternalDependencyResolutionStatus, type ExternalDependencyResolverOptions, type ExternalRepoConfig, type FeasibilityResult, type FeasibilityRisk, type FeasibilityStatus, type FeasibilitySummary, type FilterSpec, type FrontmatterParseResult, type GraphCycleDetected, type GraphValidationContext, type GraphValidationResult, type HookRunResult, type HumanMember, type HumanResource, ITEM_STATUSES, ITEM_TYPES, type Idea, IdeaStatus, IndexManager, type IndexStatus, type ItemLinks, type ItemStatus, type ItemType, MIGRATIONS, type MigrateRepositoryOptions, type MigrationContext, type MigrationDefinition, type MigrationReport, type MonteCarloHistogramBucket, type MonteCarloOptions, type MonteCarloResult, type MonteCarloWorkerPayload, type ParsedDelivery, type ParsedIdea, type ParsedTask, type Permission, type PermissionContext, type PluginAction, type PluginActionConsole, type PluginActionGitHubPr, type PluginActionHandler, type PluginActionHandlerResult, type PluginActionWebhook, type PluginManifest, type PluginRunOptions, type PluginRunRecord, type PluginTrigger, type PolicyAction, type ReadinessComputation, type ReadinessPartitions, type ReadinessState, type ReadinessTransitionEvent, type ReadinessWarning, type ReferentialValidationContext, type RepoConfig, type RepoState, type ResourceProfile, RiskLevel, type Role, type Run, type RunCompleted, type RunFailed, type RunResourcesConsumed, type RunStarted, RunStatus, type RunStepResult, RunStepStatus, RunbookAction, type RunbookStep, type ScheduleOptions, type ScoreContext, type ScoredTask, type SemanticValidationContext, type SimulationResult, type StructuralValidationContext, type Task, type TaskAssigned, TaskComplexity, type TaskComputed, type TaskCore, type TaskCreated, TaskDeterminism, type TaskEstimate, type TaskEstimation, type TaskExecution, type TaskGovernance, type TaskGraph, type TaskPlanning, TaskPriority, type TaskResources, type TaskScheduleEntry, TaskStatus, type TaskTransitioned, type TaskTransitionedEvent, TaskType, type Track, type TrackUtilization, type TrackWip, type TransitionContext, type TransitionResult, type TransitionValidationContext, type UpdateItemParams, VALID_TASK_TRANSITIONS, VALID_TRANSITIONS, type ValidationContext, type ValidationError, type ValidationLevel, type ValidationResult, type VelocityMetrics, type VelocityPoint, type VelocityTrend, type WhatIfBaseline, type WhatIfModification, type WriteTaskOptions, allocate, allocate_ai, allocate_ai_tokens, analyze_feasibility, analyze_what_if, build_capacity_ledger, build_graph, check_blocked, check_permission, check_unblocked, check_wip, completeItem, complexity_penalty, compute_all_readiness, compute_critical_path, compute_readiness, compute_readiness_with_corrections, compute_score, compute_velocity, coop_project_config_path, coop_project_root, coop_projects_dir, coop_workspace_config_path, coop_workspace_dir, createItem, create_seeded_rng, critical_path_weight, deleteItem, dependency_unlock_weight, detect_cycle, detect_delivery_risks, determinism_weight, effective_weekly_hours, effort_or_default, ensureCoopLayout, ensure_workspace_layout, executor_fit_weight, external_dependencies_for_task, extract_subgraph, findRepoRoot, find_external_dependencies, getItemById, get_remaining_tokens, get_user_role, has_legacy_project_layout, has_v2_projects_layout, is_external_dependency, is_project_initialized, list_projects, loadState, load_auth_config, load_completed_runs, load_graph, load_plugins, migrate_repository, migrate_task, monte_carlo_forecast, parseDeliveryContent, parseDeliveryFile, parseFrontmatterContent, parseFrontmatterFile, parseIdeaContent, parseIdeaFile, parseTaskContent, parseTaskFile, parseYamlContent, parseYamlFile, parse_external_dependency, partition_by_readiness, pert_hours, pert_stddev, priority_weight, queryItems, read_project_config, read_schema_version, read_workspace_config, renderAgentPrompt, repo_default_project_id, repo_default_project_name, resolve_external_dependencies, resolve_project, risk_penalty, run_hook, run_monte_carlo_chunk, run_plugins_for_event, sample_pert_beta, sample_task_hours, schedule_next, simulate_schedule, stringifyFrontmatter, stringifyYamlContent, task_effort_hours, topological_sort, transition, transitive_dependencies, transitive_dependents, type_weight, updateItem, urgency_weight, validate, validateReferential, validateRepo, validateSemantic, validateStructural, validateTransition, validate_graph, validate_transition, writeTask, writeYamlFile, write_schema_version, write_workspace_config };
+export { type AIAgent, type AIResource, type AgentSpec, type AllocationResult, ArtifactType, type AuthConfig, type AuthPolicy, type AutoTransitionResult, type AvailabilityWindow, type BacklogItem, type BacklogItemData, COOP_EVENT_TYPES, CURRENT_SCHEMA_VERSION, type CapacityLedger, type ComparisonResult, type ComparisonRow, type ComputeNode, type ComputeResource, type CoopConfig, type CoopEvent, CoopEventEmitter, type CoopEventType, type CoopProjectRef, type CoopWorkspaceConfig, type CreateItemParams, type CriticalPathResult, type CriticalPathTaskMetrics, DEFAULT_SCORE_WEIGHTS, type Delivery, type DeliveryAtRisk, type DeliveryBudget, type DeliveryCommitted, type DeliveryGovernance, type DeliveryRisk, type DeliveryRiskType, type DeliveryScope, DeliveryStatus, type DetectedDeliveryRisk, type EffectiveCapacity, type EventByType, type ExecutionConstraints, type ExecutionPermissions, ExecutorType, type ExternalDependencyRef, type ExternalDependencyResolution, type ExternalDependencyResolutionStatus, type ExternalDependencyResolverOptions, type ExternalRepoConfig, type FeasibilityResult, type FeasibilityRisk, type FeasibilityStatus, type FeasibilitySummary, type FilterSpec, type FrontmatterParseResult, type GraphCycleDetected, type GraphValidationContext, type GraphValidationResult, type HookRunResult, type HumanMember, type HumanResource, ITEM_STATUSES, ITEM_TYPES, type Idea, IdeaStatus, IndexManager, type IndexStatus, type ItemLinks, type ItemStatus, type ItemType, MIGRATIONS, type MigrateRepositoryOptions, type MigrationContext, type MigrationDefinition, type MigrationReport, type MonteCarloHistogramBucket, type MonteCarloOptions, type MonteCarloResult, type MonteCarloWorkerPayload, type ParsedDelivery, type ParsedIdea, type ParsedTask, type Permission, type PermissionContext, type PluginAction, type PluginActionConsole, type PluginActionGitHubPr, type PluginActionHandler, type PluginActionHandlerResult, type PluginActionWebhook, type PluginManifest, type PluginRunOptions, type PluginRunRecord, type PluginTrigger, type PolicyAction, type ReadinessComputation, type ReadinessPartitions, type ReadinessState, type ReadinessTransitionEvent, type ReadinessWarning, type ReferentialValidationContext, type RepoConfig, type RepoState, type ResourceProfile, RiskLevel, type Role, type Run, type RunCompleted, type RunFailed, type RunResourcesConsumed, type RunStarted, RunStatus, type RunStepResult, RunStepStatus, RunbookAction, type RunbookStep, type ScheduleOptions, type ScoreContext, type ScoredTask, type SemanticValidationContext, type SimulationResult, type StructuralValidationContext, type Task, type TaskAssigned, type TaskComment, TaskComplexity, type TaskComputed, type TaskCore, type TaskCreated, TaskDeterminism, type TaskEstimate, type TaskEstimation, type TaskExecution, type TaskGovernance, type TaskGraph, type TaskPlanning, TaskPriority, type TaskResources, type TaskScheduleEntry, TaskStatus, type TaskTimeLog, type TaskTransitioned, type TaskTransitionedEvent, TaskType, type Track, type TrackUtilization, type TrackWip, type TransitionContext, type TransitionResult, type TransitionValidationContext, type UpdateItemParams, VALID_TASK_TRANSITIONS, VALID_TRANSITIONS, type ValidationContext, type ValidationError, type ValidationLevel, type ValidationResult, type VelocityMetrics, type VelocityPoint, type VelocityTrend, type WhatIfBaseline, type WhatIfModification, type WriteTaskOptions, allocate, allocate_ai, allocate_ai_tokens, analyze_feasibility, analyze_what_if, build_capacity_ledger, build_graph, check_blocked, check_permission, check_unblocked, check_wip, completeItem, complexity_penalty, compute_all_readiness, compute_critical_path, compute_readiness, compute_readiness_with_corrections, compute_score, compute_velocity, coop_project_config_path, coop_project_root, coop_projects_dir, coop_workspace_config_path, coop_workspace_dir, createItem, create_seeded_rng, critical_path_weight, deleteItem, dependency_unlock_weight, detect_cycle, detect_delivery_risks, determinism_weight, effective_priority, effective_weekly_hours, effort_or_default, ensureCoopLayout, ensure_workspace_layout, executor_fit_weight, external_dependencies_for_task, extract_subgraph, findRepoRoot, find_external_dependencies, getItemById, get_remaining_tokens, get_user_role, has_legacy_project_layout, has_v2_projects_layout, is_external_dependency, is_project_initialized, list_projects, loadState, load_auth_config, load_completed_runs, load_graph, load_plugins, migrate_repository, migrate_task, monte_carlo_forecast, parseDeliveryContent, parseDeliveryFile, parseFrontmatterContent, parseFrontmatterFile, parseIdeaContent, parseIdeaFile, parseTaskContent, parseTaskFile, parseYamlContent, parseYamlFile, parse_external_dependency, partition_by_readiness, pert_hours, pert_stddev, priority_weight, queryItems, read_project_config, read_schema_version, read_workspace_config, renderAgentPrompt, repo_default_project_id, repo_default_project_name, resolve_external_dependencies, resolve_project, risk_penalty, run_hook, run_monte_carlo_chunk, run_plugins_for_event, sample_pert_beta, sample_task_hours, schedule_next, simulate_schedule, stringifyFrontmatter, stringifyYamlContent, task_effort_hours, topological_sort, transition, transitive_dependencies, transitive_dependents, type_weight, updateItem, urgency_weight, validate, validateReferential, validateRepo, validateSemantic, validateStructural, validateTransition, validate_graph, validate_transition, writeTask, writeYamlFile, write_schema_version, write_workspace_config };

package/dist/index.d.ts

@@ -285,14 +285,30 @@ interface TaskCore {
     created: string;
     updated: string;
 }
+interface TaskTimeLog {
+    at: string;
+    actor: string;
+    kind: "planned" | "worked";
+    hours: number;
+    note?: string;
+}
+interface TaskComment {
+    at: string;
+    author: string;
+    body: string;
+}
 interface TaskPlanning {
     aliases?: string[];
     priority?: TaskPriority;
     track?: string;
+    delivery_tracks?: string[];
+    priority_context?: Record<string, TaskPriority>;
     assignee?: string | null;
     depends_on?: string[];
     tags?: string[];
     delivery?: string | null;
+    fix_versions?: string[];
+    released_in?: string[];
     acceptance?: string[];
     tests_required?: string[];
     origin?: {
@@ -317,8 +333,13 @@ interface TaskResources {
 interface TaskEstimation {
     complexity?: TaskComplexity;
     determinism?: TaskDeterminism;
+    story_points?: number;
     estimate?: TaskEstimate;
     resources?: TaskResources;
+    time?: {
+        planned_hours?: number;
+        logs?: TaskTimeLog[];
+    };
 }
 interface RunbookStep {
     step: string;
@@ -380,6 +401,7 @@ interface TaskGovernance {
         target_cycle_time_days?: number;
     };
     enterprise?: Record<string, unknown>;
+    comments?: TaskComment[];
 }
 type Task = TaskCore & TaskPlanning & TaskEstimation & TaskExecution & TaskGovernance;
 interface TaskComputed {
@@ -1218,15 +1240,17 @@ interface ScoreContext {
     cpm?: CriticalPathResult;
     today?: string | Date;
     target_executor?: ExecutorType;
+    track?: string;
     config?: CoopConfig;
 }
+declare function effective_priority(task: Task, track?: string): TaskPriority;
 /**
  * Default readiness ranking weights used by `compute_score`.
  * [SPEC: Scheduler v2.0 §4.6]
  */
 declare const DEFAULT_SCORE_WEIGHTS: ScoreWeights;
 /** [SPEC: Scheduler v2.0 §4.6] */
-declare function priority_weight(task: Task, config?: CoopConfig): number;
+declare function priority_weight(task: Task, config?: CoopConfig, track?: string): number;
 /** [SPEC: Scheduler v2.0 §4.6] */
 declare function urgency_weight(task: Task, deliveries: Map<string, Delivery> | Delivery[], today: string | Date, config?: CoopConfig): number;
 /** [SPEC: Scheduler v2.0 §4.6] */
@@ -1501,4 +1525,4 @@ declare function validateRepo(rootDir: string): {
     warnings: string[];
 };
 
-export { type AIAgent, type AIResource, type AgentSpec, type AllocationResult, ArtifactType, type AuthConfig, type AuthPolicy, type AutoTransitionResult, type AvailabilityWindow, type BacklogItem, type BacklogItemData, COOP_EVENT_TYPES, CURRENT_SCHEMA_VERSION, type CapacityLedger, type ComparisonResult, type ComparisonRow, type ComputeNode, type ComputeResource, type CoopConfig, type CoopEvent, CoopEventEmitter, type CoopEventType, type CoopProjectRef, type CoopWorkspaceConfig, type CreateItemParams, type CriticalPathResult, type CriticalPathTaskMetrics, DEFAULT_SCORE_WEIGHTS, type Delivery, type DeliveryAtRisk, type DeliveryBudget, type DeliveryCommitted, type DeliveryGovernance, type DeliveryRisk, type DeliveryRiskType, type DeliveryScope, DeliveryStatus, type DetectedDeliveryRisk, type EffectiveCapacity, type EventByType, type ExecutionConstraints, type ExecutionPermissions, ExecutorType, type ExternalDependencyRef, type ExternalDependencyResolution, type ExternalDependencyResolutionStatus, type ExternalDependencyResolverOptions, type ExternalRepoConfig, type FeasibilityResult, type FeasibilityRisk, type FeasibilityStatus, type FeasibilitySummary, type FilterSpec, type FrontmatterParseResult, type GraphCycleDetected, type GraphValidationContext, type GraphValidationResult, type HookRunResult, type HumanMember, type HumanResource, ITEM_STATUSES, ITEM_TYPES, type Idea, IdeaStatus, IndexManager, type IndexStatus, type ItemLinks, type ItemStatus, type ItemType, MIGRATIONS, type MigrateRepositoryOptions, type MigrationContext, type MigrationDefinition, type MigrationReport, type MonteCarloHistogramBucket, type MonteCarloOptions, type MonteCarloResult, type MonteCarloWorkerPayload, type ParsedDelivery, type ParsedIdea, type ParsedTask, type Permission, type PermissionContext, type PluginAction, type PluginActionConsole, type PluginActionGitHubPr, type PluginActionHandler, type PluginActionHandlerResult, type PluginActionWebhook, type PluginManifest, type PluginRunOptions, type PluginRunRecord, type PluginTrigger, type PolicyAction, type ReadinessComputation, type ReadinessPartitions, type ReadinessState, type ReadinessTransitionEvent, type ReadinessWarning, type ReferentialValidationContext, type RepoConfig, type RepoState, type ResourceProfile, RiskLevel, type Role, type Run, type RunCompleted, type RunFailed, type RunResourcesConsumed, type RunStarted, RunStatus, type RunStepResult, RunStepStatus, RunbookAction, type RunbookStep, type ScheduleOptions, type ScoreContext, type ScoredTask, type SemanticValidationContext, type SimulationResult, type StructuralValidationContext, type Task, type TaskAssigned, TaskComplexity, type TaskComputed, type TaskCore, type TaskCreated, TaskDeterminism, type TaskEstimate, type TaskEstimation, type TaskExecution, type TaskGovernance, type TaskGraph, type TaskPlanning, TaskPriority, type TaskResources, type TaskScheduleEntry, TaskStatus, type TaskTransitioned, type TaskTransitionedEvent, TaskType, type Track, type TrackUtilization, type TrackWip, type TransitionContext, type TransitionResult, type TransitionValidationContext, type UpdateItemParams, VALID_TASK_TRANSITIONS, VALID_TRANSITIONS, type ValidationContext, type ValidationError, type ValidationLevel, type ValidationResult, type VelocityMetrics, type VelocityPoint, type VelocityTrend, type WhatIfBaseline, type WhatIfModification, type WriteTaskOptions, allocate, allocate_ai, allocate_ai_tokens, analyze_feasibility, analyze_what_if, build_capacity_ledger, build_graph, check_blocked, check_permission, check_unblocked, check_wip, completeItem, complexity_penalty, compute_all_readiness, compute_critical_path, compute_readiness, compute_readiness_with_corrections, compute_score, compute_velocity, coop_project_config_path, coop_project_root, coop_projects_dir, coop_workspace_config_path, coop_workspace_dir, createItem, create_seeded_rng, critical_path_weight, deleteItem, dependency_unlock_weight, detect_cycle, detect_delivery_risks, determinism_weight, effective_weekly_hours, effort_or_default, ensureCoopLayout, ensure_workspace_layout, executor_fit_weight, external_dependencies_for_task, extract_subgraph, findRepoRoot, find_external_dependencies, getItemById, get_remaining_tokens, get_user_role, has_legacy_project_layout, has_v2_projects_layout, is_external_dependency, is_project_initialized, list_projects, loadState, load_auth_config, load_completed_runs, load_graph, load_plugins, migrate_repository, migrate_task, monte_carlo_forecast, parseDeliveryContent, parseDeliveryFile, parseFrontmatterContent, parseFrontmatterFile, parseIdeaContent, parseIdeaFile, parseTaskContent, parseTaskFile, parseYamlContent, parseYamlFile, parse_external_dependency, partition_by_readiness, pert_hours, pert_stddev, priority_weight, queryItems, read_project_config, read_schema_version, read_workspace_config, renderAgentPrompt, repo_default_project_id, repo_default_project_name, resolve_external_dependencies, resolve_project, risk_penalty, run_hook, run_monte_carlo_chunk, run_plugins_for_event, sample_pert_beta, sample_task_hours, schedule_next, simulate_schedule, stringifyFrontmatter, stringifyYamlContent, task_effort_hours, topological_sort, transition, transitive_dependencies, transitive_dependents, type_weight, updateItem, urgency_weight, validate, validateReferential, validateRepo, validateSemantic, validateStructural, validateTransition, validate_graph, validate_transition, writeTask, writeYamlFile, write_schema_version, write_workspace_config };
+export { type AIAgent, type AIResource, type AgentSpec, type AllocationResult, ArtifactType, type AuthConfig, type AuthPolicy, type AutoTransitionResult, type AvailabilityWindow, type BacklogItem, type BacklogItemData, COOP_EVENT_TYPES, CURRENT_SCHEMA_VERSION, type CapacityLedger, type ComparisonResult, type ComparisonRow, type ComputeNode, type ComputeResource, type CoopConfig, type CoopEvent, CoopEventEmitter, type CoopEventType, type CoopProjectRef, type CoopWorkspaceConfig, type CreateItemParams, type CriticalPathResult, type CriticalPathTaskMetrics, DEFAULT_SCORE_WEIGHTS, type Delivery, type DeliveryAtRisk, type DeliveryBudget, type DeliveryCommitted, type DeliveryGovernance, type DeliveryRisk, type DeliveryRiskType, type DeliveryScope, DeliveryStatus, type DetectedDeliveryRisk, type EffectiveCapacity, type EventByType, type ExecutionConstraints, type ExecutionPermissions, ExecutorType, type ExternalDependencyRef, type ExternalDependencyResolution, type ExternalDependencyResolutionStatus, type ExternalDependencyResolverOptions, type ExternalRepoConfig, type FeasibilityResult, type FeasibilityRisk, type FeasibilityStatus, type FeasibilitySummary, type FilterSpec, type FrontmatterParseResult, type GraphCycleDetected, type GraphValidationContext, type GraphValidationResult, type HookRunResult, type HumanMember, type HumanResource, ITEM_STATUSES, ITEM_TYPES, type Idea, IdeaStatus, IndexManager, type IndexStatus, type ItemLinks, type ItemStatus, type ItemType, MIGRATIONS, type MigrateRepositoryOptions, type MigrationContext, type MigrationDefinition, type MigrationReport, type MonteCarloHistogramBucket, type MonteCarloOptions, type MonteCarloResult, type MonteCarloWorkerPayload, type ParsedDelivery, type ParsedIdea, type ParsedTask, type Permission, type PermissionContext, type PluginAction, type PluginActionConsole, type PluginActionGitHubPr, type PluginActionHandler, type PluginActionHandlerResult, type PluginActionWebhook, type PluginManifest, type PluginRunOptions, type PluginRunRecord, type PluginTrigger, type PolicyAction, type ReadinessComputation, type ReadinessPartitions, type ReadinessState, type ReadinessTransitionEvent, type ReadinessWarning, type ReferentialValidationContext, type RepoConfig, type RepoState, type ResourceProfile, RiskLevel, type Role, type Run, type RunCompleted, type RunFailed, type RunResourcesConsumed, type RunStarted, RunStatus, type RunStepResult, RunStepStatus, RunbookAction, type RunbookStep, type ScheduleOptions, type ScoreContext, type ScoredTask, type SemanticValidationContext, type SimulationResult, type StructuralValidationContext, type Task, type TaskAssigned, type TaskComment, TaskComplexity, type TaskComputed, type TaskCore, type TaskCreated, TaskDeterminism, type TaskEstimate, type TaskEstimation, type TaskExecution, type TaskGovernance, type TaskGraph, type TaskPlanning, TaskPriority, type TaskResources, type TaskScheduleEntry, TaskStatus, type TaskTimeLog, type TaskTransitioned, type TaskTransitionedEvent, TaskType, type Track, type TrackUtilization, type TrackWip, type TransitionContext, type TransitionResult, type TransitionValidationContext, type UpdateItemParams, VALID_TASK_TRANSITIONS, VALID_TRANSITIONS, type ValidationContext, type ValidationError, type ValidationLevel, type ValidationResult, type VelocityMetrics, type VelocityPoint, type VelocityTrend, type WhatIfBaseline, type WhatIfModification, type WriteTaskOptions, allocate, allocate_ai, allocate_ai_tokens, analyze_feasibility, analyze_what_if, build_capacity_ledger, build_graph, check_blocked, check_permission, check_unblocked, check_wip, completeItem, complexity_penalty, compute_all_readiness, compute_critical_path, compute_readiness, compute_readiness_with_corrections, compute_score, compute_velocity, coop_project_config_path, coop_project_root, coop_projects_dir, coop_workspace_config_path, coop_workspace_dir, createItem, create_seeded_rng, critical_path_weight, deleteItem, dependency_unlock_weight, detect_cycle, detect_delivery_risks, determinism_weight, effective_priority, effective_weekly_hours, effort_or_default, ensureCoopLayout, ensure_workspace_layout, executor_fit_weight, external_dependencies_for_task, extract_subgraph, findRepoRoot, find_external_dependencies, getItemById, get_remaining_tokens, get_user_role, has_legacy_project_layout, has_v2_projects_layout, is_external_dependency, is_project_initialized, list_projects, loadState, load_auth_config, load_completed_runs, load_graph, load_plugins, migrate_repository, migrate_task, monte_carlo_forecast, parseDeliveryContent, parseDeliveryFile, parseFrontmatterContent, parseFrontmatterFile, parseIdeaContent, parseIdeaFile, parseTaskContent, parseTaskFile, parseYamlContent, parseYamlFile, parse_external_dependency, partition_by_readiness, pert_hours, pert_stddev, priority_weight, queryItems, read_project_config, read_schema_version, read_workspace_config, renderAgentPrompt, repo_default_project_id, repo_default_project_name, resolve_external_dependencies, resolve_project, risk_penalty, run_hook, run_monte_carlo_chunk, run_plugins_for_event, sample_pert_beta, sample_task_hours, schedule_next, simulate_schedule, stringifyFrontmatter, stringifyYamlContent, task_effort_hours, topological_sort, transition, transitive_dependencies, transitive_dependents, type_weight, updateItem, urgency_weight, validate, validateReferential, validateRepo, validateSemantic, validateStructural, validateTransition, validate_graph, validate_transition, writeTask, writeYamlFile, write_schema_version, write_workspace_config };

package/dist/index.js

@@ -1962,23 +1962,30 @@ var TASK_FIELD_ORDER = [
   "aliases",
   "priority",
   "track",
+  "delivery_tracks",
+  "priority_context",
   "assignee",
   "depends_on",
   "tags",
   "delivery",
+  "fix_versions",
+  "released_in",
   "acceptance",
   "tests_required",
   "origin",
   "complexity",
   "determinism",
+  "story_points",
   "estimate",
   "resources",
+  "time",
   "execution",
   "artifacts",
   "governance",
   "risk",
   "metrics",
-  "enterprise"
+  "enterprise",
+  "comments"
 ];
 var ORDERED_TASK_FIELDS = new Set(TASK_FIELD_ORDER);
 function buildOrderedFrontmatter(task, raw) {
@@ -2310,6 +2317,13 @@ function detect_delivery_risks(delivery, graph, velocity, options = {}) {
 }
 
 // src/planning/scorer.ts
+function effective_priority(task, track) {
+  const candidate = track?.trim();
+  if (candidate && task.priority_context?.[candidate]) {
+    return task.priority_context[candidate];
+  }
+  return task.priority ?? "p2";
+}
 var DEFAULT_SCORE_WEIGHTS = {
   priority: {
     p0: 100,
@@ -2462,9 +2476,9 @@ function unresolved_dependencies(task, graph) {
     return !dep || dep.status !== "done" && dep.status !== "canceled";
   });
 }
-function priority_weight(task, config) {
+function priority_weight(task, config, track) {
   const weights = configured_weights(config);
-  const priority = task.priority ?? "p2";
+  const priority = effective_priority(task, track);
   return weights.priority[priority];
 }
 function urgency_weight(task, deliveries, today, config) {
@@ -2562,7 +2576,7 @@ function compute_score(task, graph, context = {}) {
   const deliveries = context.deliveries ?? graph.deliveries;
   const today = context.today ?? /* @__PURE__ */ new Date();
   const config = context.config;
-  return priority_weight(task, config) + urgency_weight(task, deliveries, today, config) + dependency_unlock_weight(task.id, graph, config) + critical_path_weight(task.id, context.cpm, config) + determinism_weight(task, config) + executor_fit_weight(task, context.target_executor, config) + type_weight(task, config) + complexity_penalty(task, config) + risk_penalty(task, config);
+  return priority_weight(task, config, context.track) + urgency_weight(task, deliveries, today, config) + dependency_unlock_weight(task.id, graph, config) + critical_path_weight(task.id, context.cpm, config) + determinism_weight(task, config) + executor_fit_weight(task, context.target_executor, config) + type_weight(task, config) + complexity_penalty(task, config) + risk_penalty(task, config);
 }
 
 // src/planning/scheduler.ts
@@ -2603,6 +2617,13 @@ function clone_ledger(ledger) {
 function normalize_track2(track) {
   return (track ?? "unassigned").trim().toLowerCase();
 }
+function task_matches_track(task, track) {
+  const normalized = normalize_track2(track);
+  if (normalize_track2(task.track) === normalized) {
+    return true;
+  }
+  return (task.delivery_tracks ?? []).some((candidate) => normalize_track2(candidate) === normalized);
+}
 function find_track_slots(ledger, track) {
   const normalized = normalize_track2(track);
   return ledger.slots.get(normalized) ?? ledger.slots.get("unassigned") ?? null;
@@ -2670,7 +2691,7 @@ function schedule_next(graph, options = {}) {
   );
   let filtered = ready_tasks;
   if (options.track) {
-    filtered = filtered.filter((task) => (task.track ?? "unassigned") === options.track);
+    filtered = filtered.filter((task) => task_matches_track(task, options.track));
   }
   const deliveryFilter = options.delivery;
   if (deliveryFilter) {
@@ -2693,6 +2714,7 @@ function schedule_next(graph, options = {}) {
       cpm,
       today: options.today ?? /* @__PURE__ */ new Date(),
       target_executor: options.executor,
+      track: options.track,
       config: options.config
     }),
     readiness: compute_readiness(task, graph),
@@ -3573,6 +3595,18 @@ function validateSemantic(task, context = {}) {
       }
     }
   }
+  if (task.time?.planned_hours !== void 0 && task.time.logs) {
+    const plannedTotal = task.time.logs.filter((entry) => entry.kind === "planned").reduce((sum, entry) => sum + entry.hours, 0);
+    if (plannedTotal > 0 && plannedTotal !== task.time.planned_hours) {
+      issues.push(
+        warning2(
+          "time.planned_hours",
+          "sem.time_planned_mismatch",
+          `Task planned_hours (${task.time.planned_hours}) does not match total planned logs (${plannedTotal}).`
+        )
+      );
+    }
+  }
   const taskStatuses = asMap(context.taskStatuses);
   if (task.status === "done" && (task.depends_on?.length ?? 0) > 0) {
     const unresolved = (task.depends_on ?? []).filter((depId) => taskStatuses.get(depId) !== "done");
@@ -3661,6 +3695,45 @@ function validateStringArrayField(errors, field, value, options = {}) {
     }
   }
 }
+function isPriority(value) {
+  return typeof value === "string" && Object.values(TaskPriority).includes(value);
+}
+function validatePriorityContext(errors, value) {
+  if (value === void 0) {
+    return;
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    errors.push(
+      error4(
+        "priority_context",
+        "struct.priority_context_object",
+        "Field 'priority_context' must be an object keyed by track id."
+      )
+    );
+    return;
+  }
+  for (const [track, priority] of Object.entries(value)) {
+    if (!track.trim()) {
+      errors.push(
+        error4(
+          "priority_context",
+          "struct.priority_context_key",
+          "Field 'priority_context' keys must be non-empty track ids."
+        )
+      );
+      continue;
+    }
+    if (!isPriority(priority)) {
+      errors.push(
+        error4(
+          "priority_context",
+          "struct.priority_context_priority",
+          `Priority override for track '${track}' must be one of ${Object.values(TaskPriority).join(", ")}.`
+        )
+      );
+    }
+  }
+}
 function validateStructural(task, context = {}) {
   const errors = [];
   const required = ["id", "title", "type", "status", "created", "updated"];
@@ -3727,6 +3800,106 @@ function validateStructural(task, context = {}) {
   }
   validateStringArrayField(errors, "acceptance", task.acceptance);
   validateStringArrayField(errors, "tests_required", task.tests_required);
+  validateStringArrayField(errors, "delivery_tracks", task.delivery_tracks);
+  validateStringArrayField(errors, "fix_versions", task.fix_versions);
+  validateStringArrayField(errors, "released_in", task.released_in);
+  validatePriorityContext(errors, task.priority_context);
+  if (task.story_points !== void 0 && (!Number.isFinite(task.story_points) || task.story_points < 0)) {
+    errors.push(
+      error4(
+        "story_points",
+        "struct.story_points_non_negative",
+        "Field 'story_points' must be a non-negative number."
+      )
+    );
+  }
+  if (task.time !== void 0) {
+    if (!task.time || typeof task.time !== "object" || Array.isArray(task.time)) {
+      errors.push(error4("time", "struct.time_object", "Field 'time' must be an object."));
+    } else {
+      if (task.time.planned_hours !== void 0 && (!Number.isFinite(task.time.planned_hours) || task.time.planned_hours < 0)) {
+        errors.push(
+          error4(
+            "time.planned_hours",
+            "struct.time_planned_hours_non_negative",
+            "Field 'time.planned_hours' must be a non-negative number."
+          )
+        );
+      }
+      if (task.time.logs !== void 0) {
+        if (!Array.isArray(task.time.logs)) {
+          errors.push(error4("time.logs", "struct.time_logs_array", "Field 'time.logs' must be an array."));
+        } else {
+          for (const [index, entry] of task.time.logs.entries()) {
+            if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+              errors.push(
+                error4("time.logs", "struct.time_logs_object", `Entry ${index} in 'time.logs' must be an object.`)
+              );
+              continue;
+            }
+            const record = entry;
+            if (typeof record.at !== "string" || record.at.trim().length === 0) {
+              errors.push(error4("time.logs", "struct.time_logs_at", `Entry ${index} in 'time.logs' requires 'at'.`));
+            }
+            if (typeof record.actor !== "string" || record.actor.trim().length === 0) {
+              errors.push(
+                error4("time.logs", "struct.time_logs_actor", `Entry ${index} in 'time.logs' requires 'actor'.`)
+              );
+            }
+            if (record.kind !== "planned" && record.kind !== "worked") {
+              errors.push(
+                error4(
+                  "time.logs",
+                  "struct.time_logs_kind",
+                  `Entry ${index} in 'time.logs' must use kind planned|worked.`
+                )
+              );
+            }
+            if (typeof record.hours !== "number" || !Number.isFinite(record.hours) || record.hours < 0) {
+              errors.push(
+                error4(
+                  "time.logs",
+                  "struct.time_logs_hours",
+                  `Entry ${index} in 'time.logs' requires non-negative numeric 'hours'.`
+                )
+              );
+            }
+            if (record.note !== void 0 && typeof record.note !== "string") {
+              errors.push(
+                error4(
+                  "time.logs",
+                  "struct.time_logs_note",
+                  `Entry ${index} in 'time.logs' must use a string note when present.`
+                )
+              );
+            }
+          }
+        }
+      }
+    }
+  }
+  if (task.comments !== void 0) {
+    if (!Array.isArray(task.comments)) {
+      errors.push(error4("comments", "struct.comments_array", "Field 'comments' must be an array."));
+    } else {
+      for (const [index, entry] of task.comments.entries()) {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+          errors.push(error4("comments", "struct.comments_object", `Entry ${index} in 'comments' must be an object.`));
+          continue;
+        }
+        const record = entry;
+        if (typeof record.at !== "string" || record.at.trim().length === 0) {
+          errors.push(error4("comments", "struct.comments_at", `Entry ${index} in 'comments' requires 'at'.`));
+        }
+        if (typeof record.author !== "string" || record.author.trim().length === 0) {
+          errors.push(error4("comments", "struct.comments_author", `Entry ${index} in 'comments' requires 'author'.`));
+        }
+        if (typeof record.body !== "string" || record.body.trim().length === 0) {
+          errors.push(error4("comments", "struct.comments_body", `Entry ${index} in 'comments' requires 'body'.`));
+        }
+      }
+    }
+  }
   if (task.origin !== void 0) {
     if (!task.origin || typeof task.origin !== "object" || Array.isArray(task.origin)) {
       errors.push(error4("origin", "struct.origin_object", "Field 'origin' must be an object."));
@@ -4599,6 +4772,7 @@ export {
   detect_cycle,
   detect_delivery_risks,
   determinism_weight,
+  effective_priority,
   effective_weekly_hours,
   effort_or_default,
   ensureCoopLayout,

package/package.json

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