@kitsy/coop-core 2.2.4 → 2.3.0

package/dist/index.cjs

@@ -64,6 +64,7 @@ __export(index_exports, {
   check_permission: () => check_permission,
   check_unblocked: () => check_unblocked,
   check_wip: () => check_wip,
+  cloneTaskTransitions: () => cloneTaskTransitions,
   completeItem: () => completeItem,
   complexity_penalty: () => complexity_penalty,
   compute_all_readiness: () => compute_all_readiness,
@@ -100,6 +101,7 @@ __export(index_exports, {
   get_user_role: () => get_user_role,
   has_legacy_project_layout: () => has_legacy_project_layout,
   has_v2_projects_layout: () => has_v2_projects_layout,
+  isTaskStatus: () => isTaskStatus,
   is_external_dependency: () => is_external_dependency,
   is_project_initialized: () => is_project_initialized,
   list_projects: () => list_projects,
@@ -133,6 +135,7 @@ __export(index_exports, {
   renderAgentPrompt: () => renderAgentPrompt,
   repo_default_project_id: () => repo_default_project_id,
   repo_default_project_name: () => repo_default_project_name,
+  resolveTaskTransitions: () => resolveTaskTransitions,
   resolve_external_dependencies: () => resolve_external_dependencies,
   resolve_project: () => resolve_project,
   risk_penalty: () => risk_penalty,
@@ -156,6 +159,7 @@ __export(index_exports, {
   validate: () => validate,
   validateReferential: () => validateReferential,
   validateRepo: () => validateRepo,
+  validateResolvedTaskTransitions: () => validateResolvedTaskTransitions,
   validateSemantic: () => validateSemantic,
   validateStructural: () => validateStructural,
   validateTransition: () => validateTransition,
@@ -2178,6 +2182,8 @@ var TASK_FIELD_ORDER = [
   "track",
   "delivery_tracks",
   "priority_context",
+  "promoted_at",
+  "promoted_track",
   "assignee",
   "depends_on",
   "tags",
@@ -3704,6 +3710,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 +3832,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);
   });
@@ -4436,12 +4464,52 @@ function check_unblocked(task, dependencyStatuses) {
 // src/state/machine.ts
 var VALID_TASK_TRANSITIONS = /* @__PURE__ */ new Map([
   ["todo", /* @__PURE__ */ new Set(["in_progress", "blocked", "canceled"])],
-  ["blocked", /* @__PURE__ */ new Set(["todo"])],
+  ["blocked", /* @__PURE__ */ new Set(["todo", "in_progress", "canceled"])],
   ["in_progress", /* @__PURE__ */ new Set(["in_review", "blocked", "todo", "canceled"])],
-  ["in_review", /* @__PURE__ */ new Set(["done", "todo"])],
-  ["done", /* @__PURE__ */ new Set()],
-  ["canceled", /* @__PURE__ */ new Set(["todo"])]
+  ["in_review", /* @__PURE__ */ new Set(["done", "todo", "blocked", "canceled"])],
+  ["done", /* @__PURE__ */ new Set(["todo", "blocked", "canceled"])],
+  ["canceled", /* @__PURE__ */ new Set(["todo", "blocked"])]
 ]);
+function isTaskStatus(value) {
+  return typeof value === "string" && VALID_TASK_TRANSITIONS.has(value);
+}
+function cloneTaskTransitions() {
+  return new Map(Array.from(VALID_TASK_TRANSITIONS.entries(), ([from, targets]) => [from, new Set(targets)]));
+}
+function resolveTaskTransitions(config) {
+  const resolved = cloneTaskTransitions();
+  const rawWorkflow = config && typeof config === "object" && !Array.isArray(config) && typeof config.workflow === "object" ? config.workflow : null;
+  const rawTransitions = rawWorkflow && typeof rawWorkflow.task_transitions === "object" && rawWorkflow.task_transitions !== null && !Array.isArray(rawWorkflow.task_transitions) ? rawWorkflow.task_transitions : null;
+  if (!rawTransitions) {
+    return resolved;
+  }
+  for (const [from, to] of Object.entries(rawTransitions)) {
+    if (!isTaskStatus(from)) {
+      continue;
+    }
+    if (!Array.isArray(to)) {
+      continue;
+    }
+    const allowed = /* @__PURE__ */ new Set();
+    for (const entry of to) {
+      if (isTaskStatus(entry)) {
+        allowed.add(entry);
+      }
+    }
+    resolved.set(from, allowed);
+  }
+  return resolved;
+}
+function validateResolvedTaskTransitions(transitions) {
+  const errors = [];
+  for (const status of VALID_TASK_TRANSITIONS.keys()) {
+    const targets = transitions.get(status);
+    if (!targets || targets.size === 0) {
+      errors.push(`Task status '${status}' cannot have zero outbound transitions.`);
+    }
+  }
+  return errors;
+}
 function toStatusMap2(value) {
   if (!value) return /* @__PURE__ */ new Map();
   if (value instanceof Map) return new Map(value);
@@ -4482,7 +4550,7 @@ function validateGovernanceAndDeps(task, targetStatus, context) {
   return null;
 }
 function transition(task, targetStatus, context = {}) {
-  const allowed = VALID_TASK_TRANSITIONS.get(task.status) ?? /* @__PURE__ */ new Set();
+  const allowed = resolveTaskTransitions(context.config).get(task.status) ?? /* @__PURE__ */ new Set();
   if (!allowed.has(targetStatus)) {
     return {
       success: false,
@@ -4765,6 +4833,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 +4963,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(
@@ -5010,14 +5104,7 @@ function validateStructural(task, context = {}) {
 }
 
 // src/validator/transition.ts
-var VALID_TRANSITIONS = /* @__PURE__ */ new Map([
-  ["todo", /* @__PURE__ */ new Set(["in_progress", "blocked", "canceled"])],
-  ["blocked", /* @__PURE__ */ new Set(["todo"])],
-  ["in_progress", /* @__PURE__ */ new Set(["in_review", "blocked", "todo", "canceled"])],
-  ["in_review", /* @__PURE__ */ new Set(["done", "todo"])],
-  ["done", /* @__PURE__ */ new Set()],
-  ["canceled", /* @__PURE__ */ new Set(["todo"])]
-]);
+var VALID_TRANSITIONS = VALID_TASK_TRANSITIONS;
 function error5(field, rule, message) {
   return { level: "error", field, rule, message };
 }
@@ -5031,14 +5118,15 @@ function asMap2(value) {
   return new Map(Object.entries(value));
 }
 function validate_transition(fromStatus, toStatus) {
-  const allowed = VALID_TRANSITIONS.get(fromStatus);
+  const allowed = VALID_TASK_TRANSITIONS.get(fromStatus);
   return Boolean(allowed?.has(toStatus));
 }
 function validateTransition(task, toStatus, context = {}) {
   const issues = [];
   const fromStatus = task.status;
-  if (!validate_transition(fromStatus, toStatus)) {
-    const allowed = Array.from(VALID_TRANSITIONS.get(fromStatus) ?? []);
+  const transitions = resolveTaskTransitions(context.config);
+  if (!(transitions.get(fromStatus)?.has(toStatus) ?? false)) {
+    const allowed = Array.from(transitions.get(fromStatus) ?? []);
     issues.push(
       error5(
         "status",
@@ -5839,6 +5927,7 @@ function validateRepo(rootDir) {
   check_permission,
   check_unblocked,
   check_wip,
+  cloneTaskTransitions,
   completeItem,
   complexity_penalty,
   compute_all_readiness,
@@ -5875,6 +5964,7 @@ function validateRepo(rootDir) {
   get_user_role,
   has_legacy_project_layout,
   has_v2_projects_layout,
+  isTaskStatus,
   is_external_dependency,
   is_project_initialized,
   list_projects,
@@ -5908,6 +5998,7 @@ function validateRepo(rootDir) {
   renderAgentPrompt,
   repo_default_project_id,
   repo_default_project_name,
+  resolveTaskTransitions,
   resolve_external_dependencies,
   resolve_project,
   risk_penalty,
@@ -5931,6 +6022,7 @@ function validateRepo(rootDir) {
   validate,
   validateReferential,
   validateRepo,
+  validateResolvedTaskTransitions,
   validateSemantic,
   validateStructural,
   validateTransition,

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[];
@@ -800,6 +802,12 @@ interface CoopConfig {
         on_task_transition?: string;
         on_delivery_complete?: string;
     };
+    workflow?: {
+        task_transitions?: Partial<Record<TaskStatus, TaskStatus[]>>;
+        track_overrides?: Record<string, {
+            task_transitions?: Partial<Record<TaskStatus, TaskStatus[]>>;
+        }>;
+    };
     api?: {
         host?: string;
         port?: number;
@@ -1375,6 +1383,7 @@ declare function check_unblocked(task: Task, dependencyStatuses?: DependencyStat
 type TransitionContext = {
     actor?: string;
     dependencyStatuses?: Map<string, TaskStatus> | Record<string, TaskStatus>;
+    config?: CoopConfig | Record<string, unknown>;
     now?: string | Date;
     eventEmitter?: CoopEventEmitter;
 };
@@ -1384,6 +1393,10 @@ type TransitionResult = {
     error?: string;
 };
 declare const VALID_TASK_TRANSITIONS: Map<TaskStatus, Set<TaskStatus>>;
+declare function isTaskStatus(value: unknown): value is TaskStatus;
+declare function cloneTaskTransitions(): Map<TaskStatus, Set<TaskStatus>>;
+declare function resolveTaskTransitions(config?: CoopConfig | Record<string, unknown>): Map<TaskStatus, Set<TaskStatus>>;
+declare function validateResolvedTaskTransitions(transitions: Map<TaskStatus, Set<TaskStatus>>): string[];
 declare function transition(task: Task, targetStatus: TaskStatus, context?: TransitionContext): TransitionResult;
 
 type ValidationLevel = "error" | "warning";
@@ -1426,6 +1439,7 @@ declare const VALID_TRANSITIONS: Map<TaskStatus, Set<TaskStatus>>;
 interface TransitionValidationContext {
     actor?: string;
     dependencyStatuses?: Map<string, TaskStatus> | Record<string, TaskStatus>;
+    config?: CoopConfig | Record<string, unknown>;
 }
 declare function validate_transition(fromStatus: TaskStatus, toStatus: TaskStatus): boolean;
 declare function validateTransition(task: Task, toStatus: TaskStatus, context?: TransitionValidationContext): ValidationError[];
@@ -1539,4 +1553,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, 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 };
+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, cloneTaskTransitions, 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, isTaskStatus, 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, resolveTaskTransitions, 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, validateResolvedTaskTransitions, validateSemantic, validateStructural, validateTransition, validate_graph, validate_transition, writeTask, writeYamlFile, write_schema_version, write_workspace_config };

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[];
@@ -800,6 +802,12 @@ interface CoopConfig {
         on_task_transition?: string;
         on_delivery_complete?: string;
     };
+    workflow?: {
+        task_transitions?: Partial<Record<TaskStatus, TaskStatus[]>>;
+        track_overrides?: Record<string, {
+            task_transitions?: Partial<Record<TaskStatus, TaskStatus[]>>;
+        }>;
+    };
     api?: {
         host?: string;
         port?: number;
@@ -1375,6 +1383,7 @@ declare function check_unblocked(task: Task, dependencyStatuses?: DependencyStat
 type TransitionContext = {
     actor?: string;
     dependencyStatuses?: Map<string, TaskStatus> | Record<string, TaskStatus>;
+    config?: CoopConfig | Record<string, unknown>;
     now?: string | Date;
     eventEmitter?: CoopEventEmitter;
 };
@@ -1384,6 +1393,10 @@ type TransitionResult = {
     error?: string;
 };
 declare const VALID_TASK_TRANSITIONS: Map<TaskStatus, Set<TaskStatus>>;
+declare function isTaskStatus(value: unknown): value is TaskStatus;
+declare function cloneTaskTransitions(): Map<TaskStatus, Set<TaskStatus>>;
+declare function resolveTaskTransitions(config?: CoopConfig | Record<string, unknown>): Map<TaskStatus, Set<TaskStatus>>;
+declare function validateResolvedTaskTransitions(transitions: Map<TaskStatus, Set<TaskStatus>>): string[];
 declare function transition(task: Task, targetStatus: TaskStatus, context?: TransitionContext): TransitionResult;
 
 type ValidationLevel = "error" | "warning";
@@ -1426,6 +1439,7 @@ declare const VALID_TRANSITIONS: Map<TaskStatus, Set<TaskStatus>>;
 interface TransitionValidationContext {
     actor?: string;
     dependencyStatuses?: Map<string, TaskStatus> | Record<string, TaskStatus>;
+    config?: CoopConfig | Record<string, unknown>;
 }
 declare function validate_transition(fromStatus: TaskStatus, toStatus: TaskStatus): boolean;
 declare function validateTransition(task: Task, toStatus: TaskStatus, context?: TransitionValidationContext): ValidationError[];
@@ -1539,4 +1553,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, 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 };
+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, cloneTaskTransitions, 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, isTaskStatus, 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, resolveTaskTransitions, 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, validateResolvedTaskTransitions, validateSemantic, validateStructural, validateTransition, validate_graph, validate_transition, writeTask, writeYamlFile, write_schema_version, write_workspace_config };

package/dist/index.js

@@ -1967,6 +1967,8 @@ var TASK_FIELD_ORDER = [
   "track",
   "delivery_tracks",
   "priority_context",
+  "promoted_at",
+  "promoted_track",
   "assignee",
   "depends_on",
   "tags",
@@ -2620,6 +2622,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 +2744,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);
   });
@@ -3352,12 +3376,52 @@ function check_unblocked(task, dependencyStatuses) {
 // src/state/machine.ts
 var VALID_TASK_TRANSITIONS = /* @__PURE__ */ new Map([
   ["todo", /* @__PURE__ */ new Set(["in_progress", "blocked", "canceled"])],
-  ["blocked", /* @__PURE__ */ new Set(["todo"])],
+  ["blocked", /* @__PURE__ */ new Set(["todo", "in_progress", "canceled"])],
   ["in_progress", /* @__PURE__ */ new Set(["in_review", "blocked", "todo", "canceled"])],
-  ["in_review", /* @__PURE__ */ new Set(["done", "todo"])],
-  ["done", /* @__PURE__ */ new Set()],
-  ["canceled", /* @__PURE__ */ new Set(["todo"])]
+  ["in_review", /* @__PURE__ */ new Set(["done", "todo", "blocked", "canceled"])],
+  ["done", /* @__PURE__ */ new Set(["todo", "blocked", "canceled"])],
+  ["canceled", /* @__PURE__ */ new Set(["todo", "blocked"])]
 ]);
+function isTaskStatus(value) {
+  return typeof value === "string" && VALID_TASK_TRANSITIONS.has(value);
+}
+function cloneTaskTransitions() {
+  return new Map(Array.from(VALID_TASK_TRANSITIONS.entries(), ([from, targets]) => [from, new Set(targets)]));
+}
+function resolveTaskTransitions(config) {
+  const resolved = cloneTaskTransitions();
+  const rawWorkflow = config && typeof config === "object" && !Array.isArray(config) && typeof config.workflow === "object" ? config.workflow : null;
+  const rawTransitions = rawWorkflow && typeof rawWorkflow.task_transitions === "object" && rawWorkflow.task_transitions !== null && !Array.isArray(rawWorkflow.task_transitions) ? rawWorkflow.task_transitions : null;
+  if (!rawTransitions) {
+    return resolved;
+  }
+  for (const [from, to] of Object.entries(rawTransitions)) {
+    if (!isTaskStatus(from)) {
+      continue;
+    }
+    if (!Array.isArray(to)) {
+      continue;
+    }
+    const allowed = /* @__PURE__ */ new Set();
+    for (const entry of to) {
+      if (isTaskStatus(entry)) {
+        allowed.add(entry);
+      }
+    }
+    resolved.set(from, allowed);
+  }
+  return resolved;
+}
+function validateResolvedTaskTransitions(transitions) {
+  const errors = [];
+  for (const status of VALID_TASK_TRANSITIONS.keys()) {
+    const targets = transitions.get(status);
+    if (!targets || targets.size === 0) {
+      errors.push(`Task status '${status}' cannot have zero outbound transitions.`);
+    }
+  }
+  return errors;
+}
 function toStatusMap2(value) {
   if (!value) return /* @__PURE__ */ new Map();
   if (value instanceof Map) return new Map(value);
@@ -3398,7 +3462,7 @@ function validateGovernanceAndDeps(task, targetStatus, context) {
   return null;
 }
 function transition(task, targetStatus, context = {}) {
-  const allowed = VALID_TASK_TRANSITIONS.get(task.status) ?? /* @__PURE__ */ new Set();
+  const allowed = resolveTaskTransitions(context.config).get(task.status) ?? /* @__PURE__ */ new Set();
   if (!allowed.has(targetStatus)) {
     return {
       success: false,
@@ -3681,6 +3745,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 +3875,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(
@@ -3926,14 +4016,7 @@ function validateStructural(task, context = {}) {
 }
 
 // src/validator/transition.ts
-var VALID_TRANSITIONS = /* @__PURE__ */ new Map([
-  ["todo", /* @__PURE__ */ new Set(["in_progress", "blocked", "canceled"])],
-  ["blocked", /* @__PURE__ */ new Set(["todo"])],
-  ["in_progress", /* @__PURE__ */ new Set(["in_review", "blocked", "todo", "canceled"])],
-  ["in_review", /* @__PURE__ */ new Set(["done", "todo"])],
-  ["done", /* @__PURE__ */ new Set()],
-  ["canceled", /* @__PURE__ */ new Set(["todo"])]
-]);
+var VALID_TRANSITIONS = VALID_TASK_TRANSITIONS;
 function error5(field, rule, message) {
   return { level: "error", field, rule, message };
 }
@@ -3947,14 +4030,15 @@ function asMap2(value) {
   return new Map(Object.entries(value));
 }
 function validate_transition(fromStatus, toStatus) {
-  const allowed = VALID_TRANSITIONS.get(fromStatus);
+  const allowed = VALID_TASK_TRANSITIONS.get(fromStatus);
   return Boolean(allowed?.has(toStatus));
 }
 function validateTransition(task, toStatus, context = {}) {
   const issues = [];
   const fromStatus = task.status;
-  if (!validate_transition(fromStatus, toStatus)) {
-    const allowed = Array.from(VALID_TRANSITIONS.get(fromStatus) ?? []);
+  const transitions = resolveTaskTransitions(context.config);
+  if (!(transitions.get(fromStatus)?.has(toStatus) ?? false)) {
+    const allowed = Array.from(transitions.get(fromStatus) ?? []);
     issues.push(
       error5(
         "status",
@@ -4754,6 +4838,7 @@ export {
   check_permission,
   check_unblocked,
   check_wip,
+  cloneTaskTransitions,
   completeItem,
   complexity_penalty,
   compute_all_readiness,
@@ -4790,6 +4875,7 @@ export {
   get_user_role,
   has_legacy_project_layout,
   has_v2_projects_layout,
+  isTaskStatus,
   is_external_dependency,
   is_project_initialized,
   list_projects,
@@ -4823,6 +4909,7 @@ export {
   renderAgentPrompt,
   repo_default_project_id,
   repo_default_project_name,
+  resolveTaskTransitions,
   resolve_external_dependencies,
   resolve_project,
   risk_penalty,
@@ -4846,6 +4933,7 @@ export {
   validate,
   validateReferential,
   validateRepo,
+  validateResolvedTaskTransitions,
   validateSemantic,
   validateStructural,
   validateTransition,

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.3.0",
   "license": "MIT",
   "type": "module",
   "publishConfig": {