@amsterdamdatalabs/adl-agent-control-linux-x64 0.1.12 → 0.1.28

package/packages/azdo/src/workflow-ladder.csv

@@ -0,0 +1,241 @@
+work_item_type,from_state,to_state,rule,skipped_states,owner,note
+Product Backlog Item,New,In Planning,allowed,,,
+Product Backlog Item,New,Awaiting Approval,skipped,In Planning,,
+Product Backlog Item,New,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Product Backlog Item,New,Spec Validation,skipped,In Planning;Awaiting Approval;Approved,,
+Product Backlog Item,New,In Implementation,skipped,In Planning;Awaiting Approval;Approved;Spec Validation,,
+Product Backlog Item,New,In Testing,skipped,In Planning;Awaiting Approval;Approved;Spec Validation;In Implementation,,
+Product Backlog Item,New,In Review,skipped,In Planning;Awaiting Approval;Approved;Spec Validation;In Implementation;In Testing,,
+Product Backlog Item,New,Updating Docs,skipped,In Planning;Awaiting Approval;Approved;Spec Validation;In Implementation;In Testing;In Review,,
+Product Backlog Item,New,Done,human-only,,entered only by PR merge automation into integration,
+Product Backlog Item,New,Parked for Removal,allowed,,,
+Product Backlog Item,New,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Product Backlog Item,New,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,In Planning,New,allowed,,,
+Product Backlog Item,In Planning,Awaiting Approval,allowed,,,
+Product Backlog Item,In Planning,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Product Backlog Item,In Planning,Spec Validation,skipped,Awaiting Approval;Approved,,
+Product Backlog Item,In Planning,In Implementation,skipped,Awaiting Approval;Approved;Spec Validation,,
+Product Backlog Item,In Planning,In Testing,skipped,Awaiting Approval;Approved;Spec Validation;In Implementation,,
+Product Backlog Item,In Planning,In Review,skipped,Awaiting Approval;Approved;Spec Validation;In Implementation;In Testing,,
+Product Backlog Item,In Planning,Updating Docs,skipped,Awaiting Approval;Approved;Spec Validation;In Implementation;In Testing;In Review,,
+Product Backlog Item,In Planning,Done,human-only,,entered only by PR merge automation into integration,
+Product Backlog Item,In Planning,Parked for Removal,allowed,,,
+Product Backlog Item,In Planning,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Product Backlog Item,In Planning,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Awaiting Approval,New,allowed,,,
+Product Backlog Item,Awaiting Approval,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Product Backlog Item,Awaiting Approval,Spec Validation,skipped,Approved,,
+Product Backlog Item,Awaiting Approval,In Implementation,skipped,Approved;Spec Validation,,
+Product Backlog Item,Awaiting Approval,In Testing,skipped,Approved;Spec Validation;In Implementation,,
+Product Backlog Item,Awaiting Approval,In Review,skipped,Approved;Spec Validation;In Implementation;In Testing,,
+Product Backlog Item,Awaiting Approval,Updating Docs,skipped,Approved;Spec Validation;In Implementation;In Testing;In Review,,
+Product Backlog Item,Awaiting Approval,Done,human-only,,entered only by PR merge automation into integration,
+Product Backlog Item,Awaiting Approval,Parked for Removal,allowed,,,
+Product Backlog Item,Awaiting Approval,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Product Backlog Item,Awaiting Approval,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Approved,New,allowed,,,
+Product Backlog Item,Approved,Spec Validation,allowed,,,
+Product Backlog Item,Approved,In Implementation,skipped,Spec Validation,,
+Product Backlog Item,Approved,In Testing,skipped,Spec Validation;In Implementation,,
+Product Backlog Item,Approved,In Review,skipped,Spec Validation;In Implementation;In Testing,,
+Product Backlog Item,Approved,Updating Docs,skipped,Spec Validation;In Implementation;In Testing;In Review,,
+Product Backlog Item,Approved,Done,human-only,,entered only by PR merge automation into integration,
+Product Backlog Item,Approved,Parked for Removal,allowed,,,
+Product Backlog Item,Approved,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Product Backlog Item,Approved,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Spec Validation,New,allowed,,,
+Product Backlog Item,Spec Validation,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Product Backlog Item,Spec Validation,In Implementation,allowed,,,
+Product Backlog Item,Spec Validation,In Testing,skipped,In Implementation,,
+Product Backlog Item,Spec Validation,In Review,skipped,In Implementation;In Testing,,
+Product Backlog Item,Spec Validation,Updating Docs,skipped,In Implementation;In Testing;In Review,,
+Product Backlog Item,Spec Validation,Done,human-only,,entered only by PR merge automation into integration,
+Product Backlog Item,Spec Validation,Parked for Removal,allowed,,,
+Product Backlog Item,Spec Validation,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Product Backlog Item,Spec Validation,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,In Implementation,New,allowed,,,
+Product Backlog Item,In Implementation,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Product Backlog Item,In Implementation,In Testing,allowed,,,
+Product Backlog Item,In Implementation,In Review,skipped,In Testing,,
+Product Backlog Item,In Implementation,Updating Docs,skipped,In Testing;In Review,,
+Product Backlog Item,In Implementation,Done,human-only,,entered only by PR merge automation into integration,
+Product Backlog Item,In Implementation,Parked for Removal,allowed,,,
+Product Backlog Item,In Implementation,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Product Backlog Item,In Implementation,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,In Testing,New,allowed,,,
+Product Backlog Item,In Testing,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Product Backlog Item,In Testing,In Review,allowed,,,
+Product Backlog Item,In Testing,Updating Docs,skipped,In Review,,
+Product Backlog Item,In Testing,Done,human-only,,entered only by PR merge automation into integration,
+Product Backlog Item,In Testing,Parked for Removal,allowed,,,
+Product Backlog Item,In Testing,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Product Backlog Item,In Testing,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,In Review,New,allowed,,,
+Product Backlog Item,In Review,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Product Backlog Item,In Review,In Implementation,allowed,,,
+Product Backlog Item,In Review,Updating Docs,allowed,,,
+Product Backlog Item,In Review,Done,human-only,,entered only by PR merge automation into integration,
+Product Backlog Item,In Review,Parked for Removal,allowed,,,
+Product Backlog Item,In Review,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Product Backlog Item,In Review,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Updating Docs,New,allowed,,,
+Product Backlog Item,Updating Docs,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Product Backlog Item,Updating Docs,Done,human-only,,entered only by PR merge automation into integration,
+Product Backlog Item,Updating Docs,Parked for Removal,allowed,,,
+Product Backlog Item,Updating Docs,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Product Backlog Item,Updating Docs,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Done,In Planning,allowed,,,
+Product Backlog Item,Done,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Product Backlog Item,Done,Parked for Removal,allowed,,,
+Product Backlog Item,Done,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Product Backlog Item,Done,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Parked for Removal,New,allowed,,,
+Product Backlog Item,Parked for Removal,In Planning,no-transition,,,Parked for Removal exits only to New (re-plan) or Removed (G3 human)
+Product Backlog Item,Parked for Removal,Awaiting Approval,no-transition,,,Parked for Removal exits only to New (re-plan) or Removed (G3 human)
+Product Backlog Item,Parked for Removal,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Product Backlog Item,Parked for Removal,Spec Validation,no-transition,,,Parked for Removal exits only to New (re-plan) or Removed (G3 human)
+Product Backlog Item,Parked for Removal,In Implementation,no-transition,,,Parked for Removal exits only to New (re-plan) or Removed (G3 human)
+Product Backlog Item,Parked for Removal,In Testing,no-transition,,,Parked for Removal exits only to New (re-plan) or Removed (G3 human)
+Product Backlog Item,Parked for Removal,In Review,no-transition,,,Parked for Removal exits only to New (re-plan) or Removed (G3 human)
+Product Backlog Item,Parked for Removal,Updating Docs,no-transition,,,Parked for Removal exits only to New (re-plan) or Removed (G3 human)
+Product Backlog Item,Parked for Removal,Done,human-only,,entered only by PR merge automation into integration,
+Product Backlog Item,Parked for Removal,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Product Backlog Item,Parked for Removal,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Removed,New,allowed,,,
+Product Backlog Item,Removed,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Product Backlog Item,Removed,Done,human-only,,entered only by PR merge automation into integration,
+Product Backlog Item,Removed,Parked for Removal,allowed,,,
+Product Backlog Item,Removed,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Committed,New,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Committed,In Planning,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Committed,Awaiting Approval,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Committed,Approved,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Committed,Spec Validation,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Committed,In Implementation,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Committed,In Testing,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Committed,In Review,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Committed,Updating Docs,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Committed,Done,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Committed,Parked for Removal,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Committed,Removed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,New,In Planning,allowed,,,
+Bug,New,Awaiting Approval,skipped,In Planning,,
+Bug,New,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,New,Spec Validation,skipped,In Planning;Awaiting Approval;Approved,,
+Bug,New,In Implementation,skipped,In Planning;Awaiting Approval;Approved;Spec Validation,,
+Bug,New,In Testing,skipped,In Planning;Awaiting Approval;Approved;Spec Validation;In Implementation,,
+Bug,New,In Review,skipped,In Planning;Awaiting Approval;Approved;Spec Validation;In Implementation;In Testing,,
+Bug,New,Updating Docs,skipped,In Planning;Awaiting Approval;Approved;Spec Validation;In Implementation;In Testing;In Review,,
+Bug,New,Done,human-only,,entered only by PR merge automation into integration,
+Bug,New,Parked for Removal,allowed,,,
+Bug,New,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Bug,New,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,In Planning,New,allowed,,,
+Bug,In Planning,Awaiting Approval,allowed,,,
+Bug,In Planning,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,In Planning,Spec Validation,skipped,Awaiting Approval;Approved,,
+Bug,In Planning,In Implementation,skipped,Awaiting Approval;Approved;Spec Validation,,
+Bug,In Planning,In Testing,skipped,Awaiting Approval;Approved;Spec Validation;In Implementation,,
+Bug,In Planning,In Review,skipped,Awaiting Approval;Approved;Spec Validation;In Implementation;In Testing,,
+Bug,In Planning,Updating Docs,skipped,Awaiting Approval;Approved;Spec Validation;In Implementation;In Testing;In Review,,
+Bug,In Planning,Done,human-only,,entered only by PR merge automation into integration,
+Bug,In Planning,Parked for Removal,allowed,,,
+Bug,In Planning,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Bug,In Planning,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Awaiting Approval,New,allowed,,,
+Bug,Awaiting Approval,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,Awaiting Approval,Spec Validation,skipped,Approved,,
+Bug,Awaiting Approval,In Implementation,skipped,Approved;Spec Validation,,
+Bug,Awaiting Approval,In Testing,skipped,Approved;Spec Validation;In Implementation,,
+Bug,Awaiting Approval,In Review,skipped,Approved;Spec Validation;In Implementation;In Testing,,
+Bug,Awaiting Approval,Updating Docs,skipped,Approved;Spec Validation;In Implementation;In Testing;In Review,,
+Bug,Awaiting Approval,Done,human-only,,entered only by PR merge automation into integration,
+Bug,Awaiting Approval,Parked for Removal,allowed,,,
+Bug,Awaiting Approval,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Bug,Awaiting Approval,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Approved,New,allowed,,,
+Bug,Approved,Spec Validation,allowed,,,
+Bug,Approved,In Implementation,skipped,Spec Validation,,
+Bug,Approved,In Testing,skipped,Spec Validation;In Implementation,,
+Bug,Approved,In Review,skipped,Spec Validation;In Implementation;In Testing,,
+Bug,Approved,Updating Docs,skipped,Spec Validation;In Implementation;In Testing;In Review,,
+Bug,Approved,Done,human-only,,entered only by PR merge automation into integration,
+Bug,Approved,Parked for Removal,allowed,,,
+Bug,Approved,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Bug,Approved,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Spec Validation,New,allowed,,,
+Bug,Spec Validation,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,Spec Validation,In Implementation,allowed,,,
+Bug,Spec Validation,In Testing,skipped,In Implementation,,
+Bug,Spec Validation,In Review,skipped,In Implementation;In Testing,,
+Bug,Spec Validation,Updating Docs,skipped,In Implementation;In Testing;In Review,,
+Bug,Spec Validation,Done,human-only,,entered only by PR merge automation into integration,
+Bug,Spec Validation,Parked for Removal,allowed,,,
+Bug,Spec Validation,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Bug,Spec Validation,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,In Implementation,New,allowed,,,
+Bug,In Implementation,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,In Implementation,In Testing,allowed,,,
+Bug,In Implementation,In Review,skipped,In Testing,,
+Bug,In Implementation,Updating Docs,skipped,In Testing;In Review,,
+Bug,In Implementation,Done,human-only,,entered only by PR merge automation into integration,
+Bug,In Implementation,Parked for Removal,allowed,,,
+Bug,In Implementation,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Bug,In Implementation,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,In Testing,New,allowed,,,
+Bug,In Testing,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,In Testing,In Review,allowed,,,
+Bug,In Testing,Updating Docs,skipped,In Review,,
+Bug,In Testing,Done,human-only,,entered only by PR merge automation into integration,
+Bug,In Testing,Parked for Removal,allowed,,,
+Bug,In Testing,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Bug,In Testing,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,In Review,New,allowed,,,
+Bug,In Review,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,In Review,In Implementation,allowed,,,
+Bug,In Review,Updating Docs,allowed,,,
+Bug,In Review,Done,human-only,,entered only by PR merge automation into integration,
+Bug,In Review,Parked for Removal,allowed,,,
+Bug,In Review,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Bug,In Review,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Updating Docs,New,allowed,,,
+Bug,Updating Docs,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,Updating Docs,Done,human-only,,entered only by PR merge automation into integration,
+Bug,Updating Docs,Parked for Removal,allowed,,,
+Bug,Updating Docs,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Bug,Updating Docs,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Done,In Planning,allowed,,,
+Bug,Done,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,Done,Parked for Removal,allowed,,,
+Bug,Done,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Bug,Done,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Parked for Removal,New,allowed,,,
+Bug,Parked for Removal,In Planning,no-transition,,,Parked for Removal exits only to New (re-plan) or Removed (G3 human)
+Bug,Parked for Removal,Awaiting Approval,no-transition,,,Parked for Removal exits only to New (re-plan) or Removed (G3 human)
+Bug,Parked for Removal,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,Parked for Removal,Spec Validation,no-transition,,,Parked for Removal exits only to New (re-plan) or Removed (G3 human)
+Bug,Parked for Removal,In Implementation,no-transition,,,Parked for Removal exits only to New (re-plan) or Removed (G3 human)
+Bug,Parked for Removal,In Testing,no-transition,,,Parked for Removal exits only to New (re-plan) or Removed (G3 human)
+Bug,Parked for Removal,In Review,no-transition,,,Parked for Removal exits only to New (re-plan) or Removed (G3 human)
+Bug,Parked for Removal,Updating Docs,no-transition,,,Parked for Removal exits only to New (re-plan) or Removed (G3 human)
+Bug,Parked for Removal,Done,human-only,,entered only by PR merge automation into integration,
+Bug,Parked for Removal,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Bug,Parked for Removal,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Removed,New,allowed,,,
+Bug,Removed,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,Removed,Done,human-only,,entered only by PR merge automation into integration,
+Bug,Removed,Parked for Removal,allowed,,,
+Bug,Removed,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Committed,New,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Committed,In Planning,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Committed,Awaiting Approval,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Committed,Approved,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Committed,Spec Validation,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Committed,In Implementation,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Committed,In Testing,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Committed,In Review,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Committed,Updating Docs,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Committed,Done,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Committed,Parked for Removal,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Committed,Removed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)

package/packages/azdo/src/workflow-rules-matrix.csv

@@ -0,0 +1,85 @@
+work_item_type,state,state_category,flag_ref,flag_label,rule,meaning,failure_reason
+Product Backlog Item,New,Proposed,Custom.Planwritten,Plan written,no,must be false,Plan rejected
+Product Backlog Item,New,Proposed,Custom.Implementationcomplete,Implementation complete,no,must be false,
+Product Backlog Item,New,Proposed,Custom.Reviewpassed,Review passed,no,must be false,Reviewer rejected
+Product Backlog Item,New,Proposed,Custom.Testspassing,Tests passing,no,must be false,Tests failed
+Product Backlog Item,New,Proposed,Custom.Docsupdated,Docs updated,no,must be false,
+Product Backlog Item,New,Proposed,Custom.Mergedtointegration,Merged to integration,no,must be false,Build failed
+Product Backlog Item,Approved,Proposed,Custom.Planwritten,Plan written,yes,must be true,Plan rejected
+Product Backlog Item,Approved,Proposed,Custom.Implementationcomplete,Implementation complete,no,must be false,
+Product Backlog Item,Approved,Proposed,Custom.Reviewpassed,Review passed,no,must be false,Reviewer rejected
+Product Backlog Item,Approved,Proposed,Custom.Testspassing,Tests passing,no,must be false,Tests failed
+Product Backlog Item,Approved,Proposed,Custom.Docsupdated,Docs updated,no,must be false,
+Product Backlog Item,Approved,Proposed,Custom.Mergedtointegration,Merged to integration,no,must be false,Build failed
+Product Backlog Item,Committed,InProgress,Custom.Planwritten,Plan written,yes,must be true,Plan rejected
+Product Backlog Item,Committed,InProgress,Custom.Implementationcomplete,Implementation complete,no,must be false,
+Product Backlog Item,Committed,InProgress,Custom.Reviewpassed,Review passed,no,must be false,Reviewer rejected
+Product Backlog Item,Committed,InProgress,Custom.Testspassing,Tests passing,no,must be false,Tests failed
+Product Backlog Item,Committed,InProgress,Custom.Docsupdated,Docs updated,no,must be false,
+Product Backlog Item,Committed,InProgress,Custom.Mergedtointegration,Merged to integration,no,must be false,Build failed
+Product Backlog Item,In Progress,InProgress,Custom.Planwritten,Plan written,yes,must be true,Plan rejected
+Product Backlog Item,In Progress,InProgress,Custom.Implementationcomplete,Implementation complete,free,either — this is where the gate is worked,
+Product Backlog Item,In Progress,InProgress,Custom.Reviewpassed,Review passed,no,must be false,Reviewer rejected
+Product Backlog Item,In Progress,InProgress,Custom.Testspassing,Tests passing,free,either — this is where the gate is worked,Tests failed
+Product Backlog Item,In Progress,InProgress,Custom.Docsupdated,Docs updated,free,either — this is where the gate is worked,
+Product Backlog Item,In Progress,InProgress,Custom.Mergedtointegration,Merged to integration,no,must be false,Build failed
+Product Backlog Item,In Testing,InProgress,Custom.Planwritten,Plan written,yes,must be true,Plan rejected
+Product Backlog Item,In Testing,InProgress,Custom.Implementationcomplete,Implementation complete,yes,must be true,
+Product Backlog Item,In Testing,InProgress,Custom.Reviewpassed,Review passed,free,either — this is where the gate is worked,Reviewer rejected
+Product Backlog Item,In Testing,InProgress,Custom.Testspassing,Tests passing,free,either — this is where the gate is worked,Tests failed
+Product Backlog Item,In Testing,InProgress,Custom.Docsupdated,Docs updated,free,either — this is where the gate is worked,
+Product Backlog Item,In Testing,InProgress,Custom.Mergedtointegration,Merged to integration,no,must be false,Build failed
+Product Backlog Item,Done,Completed,Custom.Planwritten,Plan written,yes,must be true,Plan rejected
+Product Backlog Item,Done,Completed,Custom.Implementationcomplete,Implementation complete,yes,must be true,
+Product Backlog Item,Done,Completed,Custom.Reviewpassed,Review passed,yes,must be true,Reviewer rejected
+Product Backlog Item,Done,Completed,Custom.Testspassing,Tests passing,yes,must be true,Tests failed
+Product Backlog Item,Done,Completed,Custom.Docsupdated,Docs updated,yes,must be true,
+Product Backlog Item,Done,Completed,Custom.Mergedtointegration,Merged to integration,yes,must be true,Build failed
+Product Backlog Item,Removed,Removed,Custom.Planwritten,Plan written,free,either — this is where the gate is worked,Plan rejected
+Product Backlog Item,Removed,Removed,Custom.Implementationcomplete,Implementation complete,free,either — this is where the gate is worked,
+Product Backlog Item,Removed,Removed,Custom.Reviewpassed,Review passed,free,either — this is where the gate is worked,Reviewer rejected
+Product Backlog Item,Removed,Removed,Custom.Testspassing,Tests passing,free,either — this is where the gate is worked,Tests failed
+Product Backlog Item,Removed,Removed,Custom.Docsupdated,Docs updated,free,either — this is where the gate is worked,
+Product Backlog Item,Removed,Removed,Custom.Mergedtointegration,Merged to integration,free,either — this is where the gate is worked,Build failed
+Bug,New,Proposed,Custom.Planwritten,Plan written,no,must be false,Plan rejected
+Bug,New,Proposed,Custom.Implementationcomplete,Implementation complete,no,must be false,
+Bug,New,Proposed,Custom.Reviewpassed,Review passed,no,must be false,Reviewer rejected
+Bug,New,Proposed,Custom.Testspassing,Tests passing,no,must be false,Tests failed
+Bug,New,Proposed,Custom.Docsupdated,Docs updated,no,must be false,
+Bug,New,Proposed,Custom.Mergedtointegration,Merged to integration,no,must be false,Build failed
+Bug,Approved,Proposed,Custom.Planwritten,Plan written,yes,must be true,Plan rejected
+Bug,Approved,Proposed,Custom.Implementationcomplete,Implementation complete,no,must be false,
+Bug,Approved,Proposed,Custom.Reviewpassed,Review passed,no,must be false,Reviewer rejected
+Bug,Approved,Proposed,Custom.Testspassing,Tests passing,no,must be false,Tests failed
+Bug,Approved,Proposed,Custom.Docsupdated,Docs updated,no,must be false,
+Bug,Approved,Proposed,Custom.Mergedtointegration,Merged to integration,no,must be false,Build failed
+Bug,Committed,InProgress,Custom.Planwritten,Plan written,yes,must be true,Plan rejected
+Bug,Committed,InProgress,Custom.Implementationcomplete,Implementation complete,no,must be false,
+Bug,Committed,InProgress,Custom.Reviewpassed,Review passed,no,must be false,Reviewer rejected
+Bug,Committed,InProgress,Custom.Testspassing,Tests passing,no,must be false,Tests failed
+Bug,Committed,InProgress,Custom.Docsupdated,Docs updated,no,must be false,
+Bug,Committed,InProgress,Custom.Mergedtointegration,Merged to integration,no,must be false,Build failed
+Bug,In Progress,InProgress,Custom.Planwritten,Plan written,yes,must be true,Plan rejected
+Bug,In Progress,InProgress,Custom.Implementationcomplete,Implementation complete,free,either — this is where the gate is worked,
+Bug,In Progress,InProgress,Custom.Reviewpassed,Review passed,no,must be false,Reviewer rejected
+Bug,In Progress,InProgress,Custom.Testspassing,Tests passing,free,either — this is where the gate is worked,Tests failed
+Bug,In Progress,InProgress,Custom.Docsupdated,Docs updated,free,either — this is where the gate is worked,
+Bug,In Progress,InProgress,Custom.Mergedtointegration,Merged to integration,no,must be false,Build failed
+Bug,In Testing,InProgress,Custom.Planwritten,Plan written,yes,must be true,Plan rejected
+Bug,In Testing,InProgress,Custom.Implementationcomplete,Implementation complete,yes,must be true,
+Bug,In Testing,InProgress,Custom.Reviewpassed,Review passed,free,either — this is where the gate is worked,Reviewer rejected
+Bug,In Testing,InProgress,Custom.Testspassing,Tests passing,free,either — this is where the gate is worked,Tests failed
+Bug,In Testing,InProgress,Custom.Docsupdated,Docs updated,free,either — this is where the gate is worked,
+Bug,In Testing,InProgress,Custom.Mergedtointegration,Merged to integration,no,must be false,Build failed
+Bug,Done,Completed,Custom.Planwritten,Plan written,yes,must be true,Plan rejected
+Bug,Done,Completed,Custom.Implementationcomplete,Implementation complete,yes,must be true,
+Bug,Done,Completed,Custom.Reviewpassed,Review passed,yes,must be true,Reviewer rejected
+Bug,Done,Completed,Custom.Testspassing,Tests passing,yes,must be true,Tests failed
+Bug,Done,Completed,Custom.Docsupdated,Docs updated,yes,must be true,
+Bug,Done,Completed,Custom.Mergedtointegration,Merged to integration,yes,must be true,Build failed
+Bug,Removed,Removed,Custom.Planwritten,Plan written,free,either — this is where the gate is worked,Plan rejected
+Bug,Removed,Removed,Custom.Implementationcomplete,Implementation complete,free,either — this is where the gate is worked,
+Bug,Removed,Removed,Custom.Reviewpassed,Review passed,free,either — this is where the gate is worked,Reviewer rejected
+Bug,Removed,Removed,Custom.Testspassing,Tests passing,free,either — this is where the gate is worked,Tests failed
+Bug,Removed,Removed,Custom.Docsupdated,Docs updated,free,either — this is where the gate is worked,
+Bug,Removed,Removed,Custom.Mergedtointegration,Merged to integration,free,either — this is where the gate is worked,Build failed

package/packages/azdo/src/workflow-rules.ts

@@ -0,0 +1,194 @@
+// Workflow state ladder for the board's Product Backlog Item/Bug items. The
+// 2026-10-04 ADL-Product process cutover replaced the six boolean Build
+// flags (Custom.Planwritten, Custom.Implementationcomplete,
+// Custom.Reviewpassed, Custom.Testspassing, Custom.Docsupdated,
+// Custom.Mergedtointegration) with ordered item states; the flags were
+// removed from the process at the cutover and nothing here reads or writes
+// them. The routes below implement the owner's final state model (PBI and
+// Bug identical), carried as src/workflow-ladder.csv next to this file; the
+// unit test tests/workflow-rules.test.ts asserts the embedded table agrees
+// with that CSV on every type × from × to triple, so the compiled binary
+// needs no file access at runtime. Features and Epics walk no item ladder
+// and are exempt: evaluateWorkflowTransition returns no violations for
+// them.
+
+/**
+ * The thirteen recognized states: the twelve active states of the final
+ * model, plus Committed — retired (UI-hidden, no route references it) but
+ * still recognized so a transition touching it is refused with the retired
+ * note instead of passing through silently.
+ */
+export const WORKFLOW_STATES = [
+  'New',
+  'In Planning',
+  'Awaiting Approval',
+  'Approved',
+  'Spec Validation',
+  'In Implementation',
+  'In Testing',
+  'In Review',
+  'Updating Docs',
+  'Done',
+  'Parked for Removal',
+  'Removed',
+  'Committed',
+] as const;
+export type WorkflowState = (typeof WORKFLOW_STATES)[number];
+
+const GATED_TYPES = ['Product Backlog Item', 'Bug'] as const;
+
+/**
+ * The main line, in route order — forward only. PBI and Bug share it (no
+ * type deltas in the final model).
+ */
+const MAIN_LINE: readonly WorkflowState[] = [
+  'New',
+  'In Planning',
+  'Awaiting Approval',
+  'Approved',
+  'Spec Validation',
+  'In Implementation',
+  'In Testing',
+  'In Review',
+  'Updating Docs',
+];
+const MAIN_LINE_INDEX = new Map<string, number>(MAIN_LINE.map((state, index) => [state, index]));
+
+/** The adjacent forward moves on the main line. */
+const LADDER_EDGES: readonly (readonly [WorkflowState, WorkflowState])[] = MAIN_LINE.slice(1).map(
+  (state, index) => [MAIN_LINE[index]!, state] as const,
+);
+
+/**
+ * The states that may move back to New — any active state (re-plan /
+ * unpark), plus Removed (recovery). Done is not active: its one recovery is
+ * In Planning (see RECOVERY_EDGES).
+ */
+const REPLAN_SOURCES: ReadonlySet<WorkflowState> = new Set([
+  'In Planning',
+  'Awaiting Approval',
+  'Approved',
+  'Spec Validation',
+  'In Implementation',
+  'In Testing',
+  'In Review',
+  'Updating Docs',
+  'Parked for Removal',
+  'Removed',
+]);
+
+/** The ONE sanctioned backward work-edge: review agent rejection. */
+const REJECTION_EDGE: readonly [WorkflowState, WorkflowState] = ['In Review', 'In Implementation'];
+/** The documented recovery out of the completed terminal. */
+const RECOVERY_EDGE: readonly [WorkflowState, WorkflowState] = ['Done', 'In Planning'];
+
+/**
+ * Targets no agent may set, with the owner named in the refusal: Approved is
+ * G1 (human approval, taken from Awaiting Approval), Removed is G3 (human
+ * removal, taken from Parked for Removal), Done is entered only by PR merge
+ * automation into integration (from Updating Docs).
+ */
+export const WORKFLOW_HUMAN_ONLY_TARGETS: Readonly<Record<'Approved' | 'Done' | 'Removed', string>> = {
+  Approved: 'G1 — human approval only; agents cannot move items to Approved',
+  Done: 'entered only by PR merge automation into integration',
+  Removed: 'G3 — human removal only; agents cannot move items to Removed',
+};
+
+const RETIRED_COMMITTED_NOTE = 'Committed is a retired state (UI-hidden; no route references it)';
+const PARKED_EXIT_NOTE = 'Parked for Removal exits only to New (re-plan) or Removed (G3 human)';
+
+export type WorkflowViolation =
+  | { kind: 'skipped-gate'; fromState: WorkflowState; toState: WorkflowState; skippedState: WorkflowState }
+  | { kind: 'human-only'; fromState: WorkflowState; toState: WorkflowState; owner: string }
+  | { kind: 'no-transition'; fromState: WorkflowState; toState: WorkflowState; note?: string };
+
+/**
+ * Evaluate a state TRANSITION (from-state → to-state) against the final
+ * state model. One violation per refusal class:
+ *
+ * - `human-only` — the target is owned by G1 approval, PR merge automation
+ *   or G3 human removal; agents never set it.
+ * - `skipped-gate` — a forward jump over main-line states; one violation per
+ *   skipped state, in route order, so the refusal names every gate
+ *   bypassed. Approved is annotated "(G1: human approval)".
+ * - `no-transition` — anything off the model. Committed is retired: any
+ *   transition touching it names the retired state. Parked for Removal is
+ *   enterable from anywhere but exits only to New or Removed. Everything
+ *   else backward is refused flat — including In Implementation → Spec
+ *   Validation and In Testing → In Implementation (no special-casing; the
+ *   owner decision is "no backward rule, enforce forward").
+ *
+ * Allowed to writers: identity writes (from === to, never gated); the
+ * adjacent main-line forward moves; parking to Parked for Removal from any
+ * state; re-plan moves to New from any active state plus Removed; the
+ * review-rejection edge In Review → In Implementation; and the Done →
+ * In Planning recovery. Exits from Done other than In Planning and from
+ * Removed other than New/Parked keep the terminal notes ("completed items
+ * stay Done; a G2 rejection gets its own linked item" / "Removed is
+ * terminal"). A state outside the thirteen recognized states yields none —
+ * the ADO process template enforces server-side. Exempt types
+ * (Feature/Epic) yield none.
+ */
+export function evaluateWorkflowTransition(
+  workItemType: string,
+  fromState: string,
+  toState: string,
+): WorkflowViolation[] {
+  if (!(GATED_TYPES as readonly string[]).includes(workItemType)) return [];
+  if (!(WORKFLOW_STATES as readonly string[]).includes(fromState)) return [];
+  if (!(WORKFLOW_STATES as readonly string[]).includes(toState)) return [];
+  const from = fromState as WorkflowState;
+  const to = toState as WorkflowState;
+  if (from === to) return [];
+  if (from === 'Committed' || to === 'Committed') {
+    return [{ kind: 'no-transition', fromState: from, toState: to, note: RETIRED_COMMITTED_NOTE }];
+  }
+  const owner = (WORKFLOW_HUMAN_ONLY_TARGETS as Partial<Record<WorkflowState, string>>)[to];
+  if (owner !== undefined) return [{ kind: 'human-only', fromState: from, toState: to, owner }];
+  if (to === 'Parked for Removal') return [];
+  if (to === 'New' && REPLAN_SOURCES.has(from)) return [];
+  if (from === REJECTION_EDGE[0] && to === REJECTION_EDGE[1]) return [];
+  if (from === RECOVERY_EDGE[0] && to === RECOVERY_EDGE[1]) return [];
+  if (from === 'Done' || from === 'Removed') {
+    return [{ kind: 'no-transition', fromState: from, toState: to, note: terminalSourceNote(from) }];
+  }
+  if (from === 'Parked for Removal') {
+    return [{ kind: 'no-transition', fromState: from, toState: to, note: PARKED_EXIT_NOTE }];
+  }
+  if (LADDER_EDGES.some(([edgeFrom, edgeTo]) => edgeFrom === from && edgeTo === to)) return [];
+  const fromIndex = MAIN_LINE_INDEX.get(from)!;
+  const toIndex = MAIN_LINE_INDEX.get(to)!;
+  if (toIndex > fromIndex) {
+    return MAIN_LINE.slice(fromIndex + 1, toIndex).map((skippedState) => ({
+      kind: 'skipped-gate',
+      fromState: from,
+      toState: to,
+      skippedState,
+    }));
+  }
+  return [{ kind: 'no-transition', fromState: from, toState: to }];
+}
+
+/** from is Done or Removed here; identity, parking and recoveries were handled by the caller. */
+function terminalSourceNote(from: WorkflowState): string {
+  return from === 'Done'
+    ? 'completed items stay Done; a G2 rejection gets its own linked item'
+    : 'Removed is terminal';
+}
+
+export function formatWorkflowViolation(violation: WorkflowViolation): string {
+  if (violation.kind === 'skipped-gate') {
+    const g1 = violation.skippedState === 'Approved' ? ' (G1: human approval)' : '';
+    return `fenced by state ladder: '${violation.fromState}' → '${violation.toState}' skips '${violation.skippedState}'${g1}`;
+  }
+  if (violation.kind === 'human-only') {
+    return `fenced by state ladder: '${violation.fromState}' → '${violation.toState}' is ${violation.owner}`;
+  }
+  const note = violation.note === undefined ? '' : ` (${violation.note})`;
+  return `fenced by state ladder: no ladder transition '${violation.fromState}' → '${violation.toState}'${note}`;
+}
+
+/** One refusal line per violation, joined for a loud multi-line error. */
+export function formatWorkflowRefusal(violations: WorkflowViolation[]): string {
+  return violations.map(formatWorkflowViolation).join('\n');
+}