@amsterdamdatalabs/adl-agent-control-linux-x64 0.1.34 → 0.1.37

package/packages/azdo/src/mcp-server.ts

@@ -29,7 +29,7 @@ import {
 import pkg from '../package.json' with { type: 'json' };
 
 /**
- * Builds a fresh, unconnected `Server` with the 7 public tools registered.
+ * Builds a fresh, unconnected `Server` with the 12 public tools registered.
  * Called by `runMcpServer()` below; also usable directly by tests that want
  * to drive the server without stdio (e.g. via an in-memory transport).
  */
@@ -62,17 +62,18 @@ export function createServer(): Server {
       },
       {
         name: 'pr_create_or_update',
-        description: 'Create a pull request from the current branch into integration, or update a pull request.',
+        description: 'Create a pull request from the current branch into integration, or update a pull request. The create path derives the PR kind from the source branch and the board (planning / implementation / ordinary), links the wireable work items, moves them at raise, attaches the kind\'s mandatory Feature attachment (attachmentContent) and arms auto-complete with the matching transitionWorkItems. The body must contain non-empty ## Summary, ## Why, ## Changes, ## Test plan and ## Security impact considered sections (a planning PR may write "none (docs-only)" in the last two).',
         inputSchema: {
           type: 'object',
           properties: {
             title: { type: 'string', description: 'Conventional lowercase title: <type>(<scope>): <subject>' },
-            description: { type: 'string', description: 'Must contain non-empty ## Summary, ## Why, and ## Changes sections' },
+            description: { type: 'string', description: 'Must contain non-empty ## Summary, ## Why, ## Changes, ## Test plan and ## Security impact considered sections' },
             action: { type: 'string', enum: ['create', 'update'] },
             pullRequestId: { type: 'number' },
             autoComplete: { type: 'boolean' },
             mergeStrategy: { type: 'string', enum: ['Squash'] },
             deleteSourceBranch: { type: 'boolean' },
+            attachmentContent: { type: 'string', description: 'Create only: the content of the kind\'s mandatory Feature attachment (plan-r<N>-<sha7>.md or impl-report-pr<id>.md); refused without it on planning/implementation PRs' },
             repository: { type: 'string', description: 'Repository name; defaults to AZURE_DEVOPS_REPO' },
           },
           required: ['action'],
@@ -124,7 +125,7 @@ export function createServer(): Server {
       },
       {
         name: 'workitem_list_or_get',
-        description: 'Get one or many tracked work items, or query the scoped backlog. Each item carries effort and failureReason (both null when unset).',
+        description: 'Get one or many tracked work items, or query the scoped backlog. Each item carries effort, failureReason and the Feature plan fields planRevision, planHash and baselineSha (all null when unset).',
         inputSchema: {
           type: 'object',
           properties: {
@@ -134,16 +135,63 @@ export function createServer(): Server {
       },
       {
         name: 'workitem_create_or_update',
-        description: 'Create a tracked work item under its required parent, or update an existing item.',
+        description: 'Create a tracked work item under its required parent, or update an existing item. The plan fields (planRevision, planHash, baselineSha) are Feature-only and map to the Custom.PlanRevision / Custom.PlanHash / Custom.BaselineSha process fields.',
         inputSchema: {
           type: 'object',
           properties: {
             id: { type: 'number' }, type: { type: 'string', enum: ['Feature', 'Product Backlog Item', 'Bug'] },
             title: { type: 'string' },
             description: { type: 'string' }, parentId: { type: 'number' }, predecessors: { type: 'array', items: { type: 'number' } }, related: { type: 'array', items: { type: 'number' } }, fields: { type: 'object' }, state: { type: 'string' }, comment: { type: 'string' }, assignedTo: { type: 'string' }, acceptanceCriteria: { type: 'string' }, priority: { type: 'number' }, startDate: { type: 'string' }, targetDate: { type: 'string' },
+            planRevision: { type: 'number', description: 'Feature only: which plan revision G1 approves (Custom.PlanRevision)' },
+            planHash: { type: 'string', description: 'Feature only: sha256 of requirements.md (Custom.PlanHash)' },
+            baselineSha: { type: 'string', description: 'Feature only: the integration commit the plan was written against (Custom.BaselineSha)' },
           },
         },
       },
+      {
+        name: 'workitem_comments_read',
+        description: "Read a work item's comments (Work Item Tracking Comments – List). This is the read path for the board's evidence: --raw on workitem_list_or_get shows only the latest System.History value.",
+        inputSchema: {
+          type: 'object',
+          properties: {
+            id: { type: 'number', description: 'The work item id whose comments are read' },
+          },
+          required: ['id'],
+        },
+      },
+      {
+        name: 'workitem_attachments',
+        description: 'Read, upload or delete a work item\'s attachments (Feature attachments only, per board-rules.md § Attachments). Upload POSTs an octet-stream to the attachments endpoint and PATCHes an AttachedFile relation with a test/rev guard. Delete removes only the AttachedFile relation (the stored file stays; Attachments-Delete is 7.2-preview only) and refuses a plan-r* file once any item of the Feature has left Awaiting Approval.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            id: { type: 'number', description: 'The work item id (the Feature carrying the attachments)' },
+            action: { type: 'string', enum: ['read', 'upload', 'delete'] },
+            fileName: { type: 'string', description: 'upload/delete: the attachment file name' },
+            content: { type: 'string', description: 'upload: the file content, sent as an octet-stream body' },
+          },
+          required: ['id', 'action'],
+        },
+      },
+      {
+        name: 'activity_add',
+        description: 'Append one entry to this repository\'s local agent activity log (.adl/agent-activity.sqlite, gitignored; A1, replaces docs/notes.md). Only the note is supplied — the server fills time (UTC ISO-8601), surface, agent identity and repository. Requires a resolvable agent identity, like every other tool.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            note: { type: 'string', description: 'The note text; non-empty' },
+          },
+          required: ['note'],
+        },
+      },
+      {
+        name: 'activity_list',
+        description: 'Read this repository\'s local agent activity log (.adl/agent-activity.sqlite): every entry, oldest first, each with time (UTC ISO-8601), surface, agent identity, repository and note.',
+        inputSchema: {
+          type: 'object',
+          properties: {},
+        },
+      },
     ],
   }));
 

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, workitemCreateOrUpdate, workitemListOrGet } from './azdo-wit.ts';
 
 type PullRequestWriteArguments = {
   action?: unknown;
@@ -17,6 +20,7 @@ type PullRequestWriteArguments = {
   autoComplete?: unknown;
   mergeStrategy?: unknown;
   deleteSourceBranch?: unknown;
+  attachmentContent?: unknown;
   repository?: unknown;
   sourceBranch?: unknown;
   targetBranch?: unknown;
@@ -34,6 +38,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',
       ),
     );
   }
@@ -54,6 +61,9 @@ 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 (errors.length > 0) throw new Error(`Invalid pull request write:\n- ${errors.join('\n- ')}`);
 
   return {
@@ -65,6 +75,7 @@ export function pullRequestWriteArgs(args: PullRequestWriteArguments): PrCreateO
       : {}),
     ...(args.mergeStrategy === 'Squash' ? { mergeStrategy: args.mergeStrategy } : {}),
     ...(args.deleteSourceBranch === true ? { deleteSourceBranch: true } : {}),
+    ...(typeof args.attachmentContent === 'string' ? { attachmentContent: args.attachmentContent } : {}),
     ...(typeof args.repository === 'string' ? { repository: args.repository } : {}),
   };
 }
@@ -135,10 +146,21 @@ function validateToolArguments(name: string, args: ToolArguments): void {
       ['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));
+      ['id', 'parentId', 'priority', 'planRevision'].forEach((key) => assertInteger(args, key)); ['predecessors', 'related'].forEach((key) => assertIntegerArray(args, key));
+      ['type', 'title', 'description', 'state', 'comment', 'assignedTo', 'acceptanceCriteria', 'startDate', 'targetDate', 'planHash', 'baselineSha'].forEach((key) => assertString(args, key));
       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;
   }
 }
@@ -197,7 +219,34 @@ export async function dispatchTool(name: string, args: ToolArguments = {}): Prom
         ...(Number.isInteger(args.priority) ? { priority: args.priority as number } : {}),
         ...(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 } : {}),
+      });
+    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)