@amsterdamdatalabs/adl-agent-control-linux-x64 0.1.35 → 0.1.46

package/packages/azdo/src/tool-dispatch.ts

@@ -4,10 +4,13 @@ import {
   validatePullRequestMetadata,
   validatePullRequestTitle,
 } from './lib/validate-pr-metadata.ts';
-import { prCreateOrUpdate, prListOrGet, type PrCreateOrUpdateArgs } from './azdo-pr.ts';
+import { prCreateOrUpdate, prListOrGet, derivePrKind, type PrCreateOrUpdateArgs } from './azdo-pr.ts';
+import { currentBranch } from './lib/client.ts';
 import { prReview, VOTE_NAMES, type PrReviewArgs, type VoteName } from './azdo-pr-review.ts';
 import { buildListOrGet, buildRun } from './azdo-pl.ts';
-import { workitemCreateOrUpdate, workitemListOrGet } from './azdo-wit.ts';
+import { workitemAttachments } from './azdo-attachments.ts';
+import { activityAdd, activityList } from './activity-log.ts';
+import { workitemCommentsRead, workitemCreateOrUpdateBug, workitemCreateOrUpdateFeature, workitemCreateOrUpdatePbi, workitemListOrGet, type WorkItemWriteArgs } from './azdo-wit.ts';
 
 type PullRequestWriteArguments = {
   action?: unknown;
@@ -17,6 +20,9 @@ type PullRequestWriteArguments = {
   autoComplete?: unknown;
   mergeStrategy?: unknown;
   deleteSourceBranch?: unknown;
+  attachmentContent?: unknown;
+  addWorkItems?: unknown;
+  removeWorkItems?: unknown;
   repository?: unknown;
   sourceBranch?: unknown;
   targetBranch?: unknown;
@@ -34,6 +40,9 @@ export function pullRequestWriteArgs(args: PullRequestWriteArguments): PrCreateO
       ...validatePullRequestMetadata(
         typeof args.title === 'string' ? args.title : '',
         typeof args.description === 'string' ? args.description : '',
+        // P3: a planning branch may write "none (docs-only)" in the last two
+        // body sections; the branch is this process's own checkout.
+        derivePrKind(currentBranch() ?? '').kind === 'planning',
       ),
     );
   }
@@ -41,12 +50,16 @@ export function pullRequestWriteArgs(args: PullRequestWriteArguments): PrCreateO
     if (!Number.isInteger(args.pullRequestId)) errors.push('pullRequestId is required for update');
     if (typeof args.title === 'string') errors.push(...validatePullRequestTitle(args.title));
     if (typeof args.description === 'string') errors.push(...validatePullRequestDescription(args.description));
+    const hasAdd = Array.isArray(args.addWorkItems) && (args.addWorkItems as unknown[]).length > 0;
+    const hasRemove = Array.isArray(args.removeWorkItems) && (args.removeWorkItems as unknown[]).length > 0;
     if (
       args.title === undefined &&
       args.description === undefined &&
       args.autoComplete !== true &&
       args.mergeStrategy === undefined &&
-      args.deleteSourceBranch !== true
+      args.deleteSourceBranch !== true &&
+      !hasAdd &&
+      !hasRemove
     ) {
       errors.push('update requires metadata or completion options');
     }
@@ -54,6 +67,15 @@ export function pullRequestWriteArgs(args: PullRequestWriteArguments): PrCreateO
   if (args.mergeStrategy !== undefined && args.mergeStrategy !== 'Squash') {
     errors.push('mergeStrategy must be Squash');
   }
+  if (args.attachmentContent !== undefined && typeof args.attachmentContent !== 'string') {
+    errors.push('attachmentContent must be a string');
+  }
+  if (args.addWorkItems !== undefined && (!Array.isArray(args.addWorkItems) || (args.addWorkItems as unknown[]).some((value) => !Number.isInteger(value)))) {
+    errors.push('addWorkItems must be an array of integers');
+  }
+  if (args.removeWorkItems !== undefined && (!Array.isArray(args.removeWorkItems) || (args.removeWorkItems as unknown[]).some((value) => !Number.isInteger(value)))) {
+    errors.push('removeWorkItems must be an array of integers');
+  }
   if (errors.length > 0) throw new Error(`Invalid pull request write:\n- ${errors.join('\n- ')}`);
 
   return {
@@ -65,6 +87,9 @@ export function pullRequestWriteArgs(args: PullRequestWriteArguments): PrCreateO
       : {}),
     ...(args.mergeStrategy === 'Squash' ? { mergeStrategy: args.mergeStrategy } : {}),
     ...(args.deleteSourceBranch === true ? { deleteSourceBranch: true } : {}),
+    ...(typeof args.attachmentContent === 'string' ? { attachmentContent: args.attachmentContent } : {}),
+    ...(Array.isArray(args.addWorkItems) ? { addWorkItems: args.addWorkItems as number[] } : {}),
+    ...(Array.isArray(args.removeWorkItems) ? { removeWorkItems: args.removeWorkItems as number[] } : {}),
     ...(typeof args.repository === 'string' ? { repository: args.repository } : {}),
   };
 }
@@ -112,6 +137,33 @@ export function pullRequestReviewArgs(args: PullRequestReviewArguments): PrRevie
 
 export type ToolArguments = Record<string, unknown>;
 
+/** The three per-type work-item write tools take the same arguments — only the
+ *  name differs — so the raw MCP/CLI arguments are narrowed once, here. */
+function workItemWriteArgs(args: ToolArguments): WorkItemWriteArgs {
+  return {
+    ...(Number.isInteger(args.id) ? { id: args.id as number } : {}),
+    ...(typeof args.title === 'string' ? { title: args.title } : {}),
+    ...(typeof args.description === 'string' ? { description: args.description } : {}),
+    ...(Number.isInteger(args.parentId) ? { parentId: args.parentId as number } : {}),
+    ...(Array.isArray(args.predecessors) ? { predecessors: args.predecessors as number[] } : {}),
+    ...(Array.isArray(args.related) ? { related: args.related as number[] } : {}),
+    ...(args.fields && typeof args.fields === 'object' && !Array.isArray(args.fields) ? { fields: args.fields as Record<string, unknown> } : {}),
+    ...(typeof args.state === 'string' ? { state: args.state } : {}),
+    ...(typeof args.comment === 'string' ? { comment: args.comment } : {}),
+    ...(typeof args.assignedTo === 'string' ? { assignedTo: args.assignedTo } : {}),
+    ...(typeof args.acceptanceCriteria === 'string' ? { acceptanceCriteria: args.acceptanceCriteria } : {}),
+    ...(Number.isInteger(args.priority) ? { priority: args.priority as number } : {}),
+    ...(typeof args.effort === 'number' ? { effort: args.effort } : {}),
+    ...(typeof args.startDate === 'string' ? { startDate: args.startDate } : {}),
+    ...(typeof args.targetDate === 'string' ? { targetDate: args.targetDate } : {}),
+    ...(Number.isInteger(args.planRevision) ? { planRevision: args.planRevision as number } : {}),
+    ...(typeof args.planHash === 'string' ? { planHash: args.planHash } : {}),
+    ...(typeof args.baselineSha === 'string' ? { baselineSha: args.baselineSha } : {}),
+    ...(Number.isInteger(args.removePredecessor) ? { removePredecessor: args.removePredecessor as number } : {}),
+    ...(Number.isInteger(args.removeRelated) ? { removeRelated: args.removeRelated as number } : {}),
+  };
+}
+
 function assertString(args: ToolArguments, key: string, allowNumber = false): void {
   const value = args[key];
   if (value !== undefined && typeof value !== 'string' && !(allowNumber && typeof value === 'number')) {
@@ -131,14 +183,34 @@ function validateToolArguments(name: string, args: ToolArguments): void {
   switch (name) {
     case 'build_list_or_get': ['buildId', 'top', 'tail'].forEach((key) => assertString(args, key, true)); assertString(args, 'branch'); return;
     case 'build_run': assertString(args, 'id', true); assertString(args, 'branch'); return;
+    case 'pr_create_or_update':
+      ['pullRequestId'].forEach((key) => assertInteger(args, key));
+      ['addWorkItems', 'removeWorkItems'].forEach((key) => assertIntegerArray(args, key));
+      return;
     case 'workitem_list_or_get':
       ['id', 'limit'].forEach((key) => assertInteger(args, key)); assertIntegerArray(args, 'ids');
       ['type', 'state', 'assignedTo'].forEach((key) => assertString(args, key)); assertBoolean(args, 'raw'); return;
-    case 'workitem_create_or_update':
-      ['id', 'parentId', 'priority'].forEach((key) => assertInteger(args, key)); ['predecessors', 'related'].forEach((key) => assertIntegerArray(args, key));
-      ['type', 'title', 'description', 'state', 'comment', 'assignedTo', 'acceptanceCriteria', 'startDate', 'targetDate'].forEach((key) => assertString(args, key));
+    case 'workitem_create_or_update_feature':
+    case 'workitem_create_or_update_pbi':
+    case 'workitem_create_or_update_bug':
+      ['id', 'parentId', 'priority', 'planRevision', 'removePredecessor', 'removeRelated'].forEach((key) => assertInteger(args, key));
+      ['predecessors', 'related'].forEach((key) => assertIntegerArray(args, key));
+      ['title', 'description', 'state', 'comment', 'assignedTo', 'acceptanceCriteria', 'startDate', 'targetDate', 'planHash', 'baselineSha'].forEach((key) => assertString(args, key));
+      // Effort is days and accepts fractions, so it is a plain number, not an integer.
+      if (args.effort !== undefined && typeof args.effort !== 'number') throw new Error('effort must be a number (days)');
       if (args.fields !== undefined && (typeof args.fields !== 'object' || args.fields === null || Array.isArray(args.fields))) throw new Error('fields must be an object');
       return;
+    case 'workitem_comments_read':
+      assertInteger(args, 'id'); return;
+    case 'workitem_attachments':
+      assertInteger(args, 'id');
+      if (args.action !== undefined && args.action !== 'read' && args.action !== 'upload' && args.action !== 'delete') {
+        throw new Error('action must be read, upload or delete');
+      }
+      ['fileName', 'content'].forEach((key) => assertString(args, key));
+      return;
+    case 'activity_add': assertString(args, 'note'); return;
+    case 'activity_list': return;
     default: return;
   }
 }
@@ -180,24 +252,36 @@ export async function dispatchTool(name: string, args: ToolArguments = {}): Prom
         ...(Number.isInteger(args.limit) ? { limit: args.limit as number } : {}),
         ...(typeof args.raw === 'boolean' ? { raw: args.raw } : {}),
       });
-    case 'workitem_create_or_update':
-      return workitemCreateOrUpdate({
-        ...(Number.isInteger(args.id) ? { id: args.id as number } : {}),
-        ...(typeof args.type === 'string' ? { type: args.type } : {}),
-        ...(typeof args.title === 'string' ? { title: args.title } : {}),
-        ...(typeof args.description === 'string' ? { description: args.description } : {}),
-        ...(Number.isInteger(args.parentId) ? { parentId: args.parentId as number } : {}),
-        ...(Array.isArray(args.predecessors) ? { predecessors: args.predecessors as number[] } : {}),
-        ...(Array.isArray(args.related) ? { related: args.related as number[] } : {}),
-        ...(args.fields && typeof args.fields === 'object' && !Array.isArray(args.fields) ? { fields: args.fields as Record<string, unknown> } : {}),
-        ...(typeof args.state === 'string' ? { state: args.state } : {}),
-        ...(typeof args.comment === 'string' ? { comment: args.comment } : {}),
-        ...(typeof args.assignedTo === 'string' ? { assignedTo: args.assignedTo } : {}),
-        ...(typeof args.acceptanceCriteria === 'string' ? { acceptanceCriteria: args.acceptanceCriteria } : {}),
-        ...(Number.isInteger(args.priority) ? { priority: args.priority as number } : {}),
-        ...(typeof args.startDate === 'string' ? { startDate: args.startDate } : {}),
-        ...(typeof args.targetDate === 'string' ? { targetDate: args.targetDate } : {}),
+    case 'workitem_create_or_update_feature':
+      return workitemCreateOrUpdateFeature(workItemWriteArgs(args));
+    case 'workitem_create_or_update_pbi':
+      return workitemCreateOrUpdatePbi(workItemWriteArgs(args));
+    case 'workitem_create_or_update_bug':
+      return workitemCreateOrUpdateBug(workItemWriteArgs(args));
+    case 'workitem_comments_read':
+      if (!Number.isInteger(args.id)) throw new Error('id is required (a work item id)');
+      return workitemCommentsRead({ id: args.id as number });
+    case 'workitem_attachments': {
+      if (!Number.isInteger(args.id)) throw new Error('id is required (a work item id)');
+      const action = args.action;
+      if (action !== 'read' && action !== 'upload' && action !== 'delete') {
+        throw new Error('action is required and must be read, upload or delete');
+      }
+      return workitemAttachments({
+        id: args.id as number,
+        action,
+        ...(typeof args.fileName === 'string' ? { fileName: args.fileName } : {}),
+        ...(typeof args.content === 'string' ? { content: args.content } : {}),
       });
+    }
+    case 'activity_add': {
+      if (typeof args.note !== 'string' || args.note.trim() === '') {
+        throw new Error('note is required (a non-empty string)');
+      }
+      return activityAdd(args.note);
+    }
+    case 'activity_list':
+      return activityList();
     default:
       throw new Error(`Unknown tool: ${name}`);
   }

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

@@ -2,11 +2,11 @@ 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,Design Validation,skipped,In Planning;Awaiting Approval;Approved,,
+Product Backlog Item,New,In Implementation,skipped,In Planning;Awaiting Approval;Approved;Design Validation,,
+Product Backlog Item,New,In Testing,skipped,In Planning;Awaiting Approval;Approved;Design Validation;In Implementation,,
+Product Backlog Item,New,In Review,skipped,In Planning;Awaiting Approval;Approved;Design Validation;In Implementation;In Testing,,
+Product Backlog Item,New,Updating Docs,skipped,In Planning;Awaiting Approval;Approved;Design 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,
@@ -14,51 +14,52 @@ Product Backlog Item,New,Committed,no-transition,,,Committed is a retired state
 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,Design Validation,skipped,Awaiting Approval;Approved,,
+Product Backlog Item,In Planning,In Implementation,skipped,Awaiting Approval;Approved;Design Validation,,
+Product Backlog Item,In Planning,In Testing,skipped,Awaiting Approval;Approved;Design Validation;In Implementation,,
+Product Backlog Item,In Planning,In Review,skipped,Awaiting Approval;Approved;Design Validation;In Implementation;In Testing,,
+Product Backlog Item,In Planning,Updating Docs,skipped,Awaiting Approval;Approved;Design 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,Design Validation,skipped,Approved,,
+Product Backlog Item,Awaiting Approval,In Implementation,skipped,Approved;Design Validation,,
+Product Backlog Item,Awaiting Approval,In Testing,skipped,Approved;Design Validation;In Implementation,,
+Product Backlog Item,Awaiting Approval,In Review,skipped,Approved;Design Validation;In Implementation;In Testing,,
+Product Backlog Item,Awaiting Approval,Updating Docs,skipped,Approved;Design 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,Design Validation,allowed,,,
+Product Backlog Item,Approved,In Implementation,skipped,Design Validation,,
+Product Backlog Item,Approved,In Testing,skipped,Design Validation;In Implementation,,
+Product Backlog Item,Approved,In Review,skipped,Design Validation;In Implementation;In Testing,,
+Product Backlog Item,Approved,Updating Docs,skipped,Design 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,Design Validation,New,allowed,,,
+Product Backlog Item,Design Validation,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Product Backlog Item,Design Validation,In Implementation,allowed,,,
+Product Backlog Item,Design Validation,In Testing,skipped,In Implementation,,
+Product Backlog Item,Design Validation,In Review,skipped,In Implementation;In Testing,,
+Product Backlog Item,Design Validation,Updating Docs,skipped,In Implementation;In Testing;In Review,,
+Product Backlog Item,Design Validation,Done,human-only,,entered only by PR merge automation into integration,
+Product Backlog Item,Design Validation,Parked for Removal,allowed,,,
+Product Backlog Item,Design Validation,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Product Backlog Item,Design 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,Design Validation,allowed,,,
+Product Backlog Item,In Implementation,In Review,allowed,,,
+Product Backlog Item,In Implementation,Updating Docs,allowed,,,
 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,
@@ -66,7 +67,8 @@ Product Backlog Item,In Implementation,Committed,no-transition,,,Committed is a
 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,In Implementation,allowed,,,
+Product Backlog Item,In Testing,Updating Docs,allowed,,,
 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,
@@ -75,6 +77,7 @@ 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,In Testing,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,
@@ -83,35 +86,38 @@ 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,In Implementation,allowed,,,
+Product Backlog Item,Updating Docs,In Review,allowed,,,
+Product Backlog Item,Updating Docs,In Testing,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,In Planning,no-transition,,,completed items stay Done; a G2 rejection gets its own linked item
 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,Parked for Removal,no-transition,,,completed items stay Done; a G2 rejection gets its own linked item
 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,New,human-only,,human revive only; agents cannot move items from Parked for Removal back to New,
+Product Backlog Item,Parked for Removal,In Planning,no-transition,,,Parked for Removal exits only to New (human-only revive) or Removed (G3 human)
+Product Backlog Item,Parked for Removal,Awaiting Approval,no-transition,,,Parked for Removal exits only to New (human-only revive) 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,Design Validation,no-transition,,,Parked for Removal exits only to New (human-only revive) or Removed (G3 human)
+Product Backlog Item,Parked for Removal,In Implementation,no-transition,,,Parked for Removal exits only to New (human-only revive) or Removed (G3 human)
+Product Backlog Item,Parked for Removal,In Testing,no-transition,,,Parked for Removal exits only to New (human-only revive) or Removed (G3 human)
+Product Backlog Item,Parked for Removal,In Review,no-transition,,,Parked for Removal exits only to New (human-only revive) or Removed (G3 human)
+Product Backlog Item,Parked for Removal,Updating Docs,no-transition,,,Parked for Removal exits only to New (human-only revive) 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,New,no-transition,,,Removed is terminal
 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,Parked for Removal,no-transition,,,Removed is terminal
 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,Design 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)
@@ -119,120 +125,132 @@ Product Backlog Item,Committed,Updating Docs,no-transition,,,Committed is a reti
 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,,
+Product Backlog Item,In Reproduction,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Product Backlog Item,In Reproduction,Done,human-only,,entered only by PR merge automation into integration,
+Product Backlog Item,In Reproduction,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Product Backlog Item,In Reproduction,Parked for Removal,allowed,,,
+Product Backlog Item,In Reproduction,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,In Fixing,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Product Backlog Item,In Fixing,Done,human-only,,entered only by PR merge automation into integration,
+Product Backlog Item,In Fixing,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Product Backlog Item,In Fixing,Parked for Removal,allowed,,,
+Product Backlog Item,In Fixing,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Committed,In Reproduction,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Product Backlog Item,Committed,In Fixing,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
 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,In Reproduction,allowed,,,
 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,Design Validation,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,Design Validation,Done,human-only,,entered only by PR merge automation into integration,
+Bug,Design Validation,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Bug,Design Validation,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
 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 Reproduction,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,In Reproduction,In Fixing,allowed,,,
+Bug,In Reproduction,Done,human-only,,entered only by PR merge automation into integration,
+Bug,In Reproduction,Parked for Removal,allowed,,,
+Bug,In Reproduction,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Bug,In Reproduction,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,In Fixing,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,In Fixing,In Testing,allowed,,,
+Bug,In Fixing,In Review,allowed,,,
+Bug,In Fixing,Updating Docs,allowed,,,
+Bug,In Fixing,Done,human-only,,entered only by PR merge automation into integration,
+Bug,In Fixing,Parked for Removal,allowed,,,
+Bug,In Fixing,Removed,human-only,,G3 — human removal only; agents cannot move items to Removed,
+Bug,In Fixing,Committed,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
 Bug,In Testing,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,In Testing,In Fixing,allowed,,,
 Bug,In Testing,In Review,allowed,,,
-Bug,In Testing,Updating Docs,skipped,In Review,,
+Bug,In Testing,Updating Docs,allowed,,,
 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,In Fixing,allowed,,,
+Bug,In Review,In Testing,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,In Fixing,allowed,,,
+Bug,Updating Docs,In Testing,allowed,,,
+Bug,Updating Docs,In Review,allowed,,,
 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,New,no-transition,,,completed items stay Done; a G2 rejection gets its own linked item
+Bug,Done,In Planning,no-transition,,,completed items stay Done; a G2 rejection gets its own linked item
+Bug,Done,Awaiting Approval,no-transition,,,completed items stay Done; a G2 rejection gets its own linked item
 Bug,Done,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
-Bug,Done,Parked for Removal,allowed,,,
+Bug,Done,Design Validation,no-transition,,,completed items stay Done; a G2 rejection gets its own linked item
+Bug,Done,In Implementation,no-transition,,,completed items stay Done; a G2 rejection gets its own linked item
+Bug,Done,In Reproduction,no-transition,,,completed items stay Done; a G2 rejection gets its own linked item
+Bug,Done,In Fixing,no-transition,,,completed items stay Done; a G2 rejection gets its own linked item
+Bug,Done,In Testing,no-transition,,,completed items stay Done; a G2 rejection gets its own linked item
+Bug,Done,In Review,no-transition,,,completed items stay Done; a G2 rejection gets its own linked item
+Bug,Done,Updating Docs,no-transition,,,completed items stay Done; a G2 rejection gets its own linked item
+Bug,Done,Parked for Removal,no-transition,,,completed items stay Done; a G2 rejection gets its own linked item
 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,New,human-only,,human revive only; agents cannot move items from Parked for Removal back to New,
+Bug,Parked for Removal,In Planning,no-transition,,,Parked for Removal exits only to New (human-only revive) or Removed (G3 human)
+Bug,Parked for Removal,Awaiting Approval,no-transition,,,Parked for Removal exits only to New (human-only revive) 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,Design Validation,no-transition,,,Parked for Removal exits only to New (human-only revive) or Removed (G3 human)
+Bug,Parked for Removal,In Implementation,no-transition,,,Parked for Removal exits only to New (human-only revive) or Removed (G3 human)
+Bug,Parked for Removal,In Reproduction,no-transition,,,Parked for Removal exits only to New (human-only revive) or Removed (G3 human)
+Bug,Parked for Removal,In Fixing,no-transition,,,Parked for Removal exits only to New (human-only revive) or Removed (G3 human)
+Bug,Parked for Removal,In Testing,no-transition,,,Parked for Removal exits only to New (human-only revive) or Removed (G3 human)
+Bug,Parked for Removal,In Review,no-transition,,,Parked for Removal exits only to New (human-only revive) or Removed (G3 human)
+Bug,Parked for Removal,Updating Docs,no-transition,,,Parked for Removal exits only to New (human-only revive) 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,New,no-transition,,,Removed is terminal
+Bug,Removed,In Planning,no-transition,,,Removed is terminal
+Bug,Removed,Awaiting Approval,no-transition,,,Removed is terminal
 Bug,Removed,Approved,human-only,,G1 — human approval only; agents cannot move items to Approved,
+Bug,Removed,Design Validation,no-transition,,,Removed is terminal
+Bug,Removed,In Implementation,no-transition,,,Removed is terminal
+Bug,Removed,In Reproduction,no-transition,,,Removed is terminal
+Bug,Removed,In Fixing,no-transition,,,Removed is terminal
+Bug,Removed,In Testing,no-transition,,,Removed is terminal
+Bug,Removed,In Review,no-transition,,,Removed is terminal
+Bug,Removed,Updating Docs,no-transition,,,Removed is terminal
 Bug,Removed,Done,human-only,,entered only by PR merge automation into integration,
-Bug,Removed,Parked for Removal,allowed,,,
+Bug,Removed,Parked for Removal,no-transition,,,Removed is terminal
 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,Design 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 Reproduction,no-transition,,,Committed is a retired state (UI-hidden; no route references it)
+Bug,Committed,In Fixing,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)