agl 42.2.2 → 43.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (171) hide show
  1. package/changelog.md +16 -0
  2. package/dist_serve/bundle.js +6697 -5287
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_serve/bundle.js.third-party-notices.json +29 -29
  5. package/dist_serve/bundle.js.third-party-notices.txt +29 -29
  6. package/dist_serve/third-party-notices.md +597 -8
  7. package/dist_ts/00_commitinfo_data.js +1 -1
  8. package/dist_ts/aglapi/aglapisurface.document.js +114 -16
  9. package/dist_ts/aglapi/interfaces.d.ts +30 -0
  10. package/dist_ts/aglapi/interfaces.js +7 -1
  11. package/dist_ts/classes.authstore.d.ts +7 -0
  12. package/dist_ts/classes.authstore.js +12 -1
  13. package/dist_ts/classes.cli.js +10 -1
  14. package/dist_ts/classes.controller.d.ts +41 -11
  15. package/dist_ts/classes.controller.js +224 -48
  16. package/dist_ts/classes.harnessoperationmanager.d.ts +44 -0
  17. package/dist_ts/classes.harnessoperationmanager.js +15 -10
  18. package/dist_ts/classes.mcpclient.d.ts +5 -0
  19. package/dist_ts/classes.mcpclient.js +15 -3
  20. package/dist_ts/classes.mcpcontrollerhost.d.ts +3 -0
  21. package/dist_ts/classes.mcpcontrollerhost.js +14 -2
  22. package/dist_ts/classes.mcptools.d.ts +4 -3
  23. package/dist_ts/classes.mcptools.js +20 -1
  24. package/dist_ts/classes.mcpvalidation.js +4 -1
  25. package/dist_ts/classes.ticketstore.d.ts +71 -3
  26. package/dist_ts/classes.ticketstore.js +299 -12
  27. package/dist_ts/classes.validation.d.ts +2 -0
  28. package/dist_ts/classes.validation.js +27 -5
  29. package/dist_ts/driver/classes.directreports.d.ts +23 -3
  30. package/dist_ts/driver/classes.directreports.js +59 -2
  31. package/dist_ts/driver/classes.drivereventrelay.js +3 -2
  32. package/dist_ts/driver/functions.driverinstructions.d.ts +1 -1
  33. package/dist_ts/driver/functions.driverinstructions.js +12 -3
  34. package/dist_ts/driver/functions.drivertools.d.ts +4 -0
  35. package/dist_ts/driver/functions.drivertools.js +8 -2
  36. package/dist_ts/fleet/classes.boardpump.d.ts +53 -3
  37. package/dist_ts/fleet/classes.boardpump.js +237 -32
  38. package/dist_ts/fleet/classes.claudeworkers.d.ts +10 -3
  39. package/dist_ts/fleet/classes.claudeworkers.js +43 -19
  40. package/dist_ts/fleet/classes.codexworkers.d.ts +5 -3
  41. package/dist_ts/fleet/classes.codexworkers.js +26 -9
  42. package/dist_ts/fleet/classes.deploymonitor.d.ts +253 -0
  43. package/dist_ts/fleet/classes.deploymonitor.js +821 -0
  44. package/dist_ts/fleet/classes.gitfacts.d.ts +61 -0
  45. package/dist_ts/fleet/classes.gitfacts.js +125 -0
  46. package/dist_ts/fleet/classes.releasereconciler.d.ts +51 -0
  47. package/dist_ts/fleet/classes.releasereconciler.js +101 -0
  48. package/dist_ts/fleet/classes.service.d.ts +13 -1
  49. package/dist_ts/fleet/classes.service.js +76 -7
  50. package/dist_ts/fleet/classes.ticketeffects.d.ts +13 -0
  51. package/dist_ts/fleet/classes.ticketeffects.js +42 -8
  52. package/dist_ts/fleet/classes.workers.d.ts +10 -3
  53. package/dist_ts/fleet/classes.workers.js +18 -3
  54. package/dist_ts/fleet/functions.controllerbuild.d.ts +23 -0
  55. package/dist_ts/fleet/functions.controllerbuild.js +75 -0
  56. package/dist_ts/fleet/functions.deployprobes.d.ts +39 -0
  57. package/dist_ts/fleet/functions.deployprobes.js +82 -0
  58. package/dist_ts/fleet/functions.deployvalidation.d.ts +27 -0
  59. package/dist_ts/fleet/functions.deployvalidation.js +43 -0
  60. package/dist_ts/fleet/functions.release.d.ts +2 -1
  61. package/dist_ts/fleet/functions.release.js +32 -5
  62. package/dist_ts/fleet/functions.releasefacts.d.ts +45 -0
  63. package/dist_ts/fleet/functions.releasefacts.js +68 -0
  64. package/dist_ts/fleet/functions.validation.d.ts +3 -3
  65. package/dist_ts/fleet/functions.validation.js +4 -7
  66. package/dist_ts/fleet/functions.watchprobes.js +7 -9
  67. package/dist_ts/fleet/functions.workervalidation.js +4 -3
  68. package/dist_ts/fleet/interfaces.workers.d.ts +30 -3
  69. package/dist_ts/fleet/interfaces.workers.js +14 -1
  70. package/dist_ts/functions.deploycli.d.ts +33 -0
  71. package/dist_ts/functions.deploycli.js +155 -0
  72. package/dist_ts/functions.mcpdeploytools.d.ts +13 -0
  73. package/dist_ts/functions.mcpdeploytools.js +16 -0
  74. package/dist_ts/functions.mcptickettools.d.ts +54 -0
  75. package/dist_ts/functions.mcptickettools.js +8 -7
  76. package/dist_ts/functions.ticketautolabels.d.ts +2 -0
  77. package/dist_ts/functions.ticketautolabels.js +9 -3
  78. package/dist_ts/functions.ticketcli.d.ts +16 -2
  79. package/dist_ts/functions.ticketcli.js +105 -27
  80. package/dist_ts/functions.ticketvalidation.d.ts +55 -0
  81. package/dist_ts/functions.ticketvalidation.js +26 -8
  82. package/dist_ts_interfaces/deployments.d.ts +241 -0
  83. package/dist_ts_interfaces/deployments.js +5 -6
  84. package/dist_ts_interfaces/fleet.d.ts +12 -0
  85. package/dist_ts_interfaces/fleetworkers.d.ts +21 -1
  86. package/dist_ts_interfaces/interfaces.d.ts +4 -2
  87. package/dist_ts_interfaces/interfaces.js +4 -2
  88. package/dist_ts_interfaces/mcprequests.d.ts +3 -2
  89. package/dist_ts_interfaces/mcprequests.js +3 -1
  90. package/dist_ts_interfaces/requests.d.ts +3 -2
  91. package/dist_ts_interfaces/requests.directreports.d.ts +58 -6
  92. package/dist_ts_interfaces/requests.js +1 -1
  93. package/dist_ts_interfaces/requests.tickets.d.ts +25 -5
  94. package/dist_ts_interfaces/requests.tickets.js +2 -2
  95. package/dist_ts_interfaces/tickets.d.ts +71 -6
  96. package/dist_ts_interfaces/tickets.js +34 -6
  97. package/dist_ts_migration/classes.documentmigrationrunner.d.ts +7 -0
  98. package/dist_ts_migration/classes.documentmigrationrunner.js +14 -1
  99. package/dist_ts_migration/index.d.ts +2 -0
  100. package/dist_ts_migration/index.js +3 -1
  101. package/dist_ts_migration/v41_ticketclosedcolumn.d.ts +20 -0
  102. package/dist_ts_migration/v41_ticketclosedcolumn.js +118 -0
  103. package/dist_ts_migration/v41_ticketlinkrepos.d.ts +24 -0
  104. package/dist_ts_migration/v41_ticketlinkrepos.js +101 -0
  105. package/package.json +6 -2
  106. package/readme.md +306 -36
  107. package/third-party-notices.md +597 -8
  108. package/ts/00_commitinfo_data.ts +1 -1
  109. package/ts/aglapi/aglapisurface.document.ts +113 -15
  110. package/ts/aglapi/interfaces.ts +6 -0
  111. package/ts/classes.authstore.ts +13 -0
  112. package/ts/classes.cli.ts +9 -0
  113. package/ts/classes.controller.ts +238 -59
  114. package/ts/classes.harnessoperationmanager.ts +20 -14
  115. package/ts/classes.mcpclient.ts +17 -2
  116. package/ts/classes.mcpcontrollerhost.ts +15 -1
  117. package/ts/classes.mcptools.ts +21 -2
  118. package/ts/classes.mcpvalidation.ts +2 -0
  119. package/ts/classes.ticketstore.ts +312 -13
  120. package/ts/classes.validation.ts +28 -4
  121. package/ts/driver/classes.directreports.ts +58 -3
  122. package/ts/driver/classes.drivereventrelay.ts +2 -1
  123. package/ts/driver/functions.driverinstructions.ts +11 -2
  124. package/ts/driver/functions.drivertools.ts +10 -2
  125. package/ts/fleet/classes.boardpump.ts +235 -28
  126. package/ts/fleet/classes.claudeworkers.ts +36 -15
  127. package/ts/fleet/classes.codexworkers.ts +24 -7
  128. package/ts/fleet/classes.deploymonitor.ts +854 -0
  129. package/ts/fleet/classes.gitfacts.ts +135 -0
  130. package/ts/fleet/classes.releasereconciler.ts +103 -0
  131. package/ts/fleet/classes.service.ts +81 -8
  132. package/ts/fleet/classes.ticketeffects.ts +38 -6
  133. package/ts/fleet/classes.workers.ts +19 -5
  134. package/ts/fleet/functions.controllerbuild.ts +84 -0
  135. package/ts/fleet/functions.deployprobes.ts +84 -0
  136. package/ts/fleet/functions.deployvalidation.ts +50 -0
  137. package/ts/fleet/functions.release.ts +32 -3
  138. package/ts/fleet/functions.releasefacts.ts +91 -0
  139. package/ts/fleet/functions.validation.ts +3 -6
  140. package/ts/fleet/functions.watchprobes.ts +6 -8
  141. package/ts/fleet/functions.workervalidation.ts +3 -2
  142. package/ts/fleet/interfaces.workers.ts +23 -3
  143. package/ts/functions.deploycli.ts +151 -0
  144. package/ts/functions.mcpdeploytools.ts +18 -0
  145. package/ts/functions.mcptickettools.ts +7 -6
  146. package/ts/functions.ticketautolabels.ts +10 -2
  147. package/ts/functions.ticketcli.ts +100 -24
  148. package/ts/functions.ticketvalidation.ts +26 -7
  149. package/ts_interfaces/deployments.ts +194 -0
  150. package/ts_interfaces/fleet.ts +17 -2
  151. package/ts_interfaces/fleetworkers.ts +20 -0
  152. package/ts_interfaces/interfaces.ts +3 -1
  153. package/ts_interfaces/mcprequests.ts +3 -0
  154. package/ts_interfaces/requests.directreports.ts +52 -8
  155. package/ts_interfaces/requests.tickets.ts +20 -4
  156. package/ts_interfaces/requests.ts +6 -1
  157. package/ts_interfaces/tickets.ts +53 -6
  158. package/ts_migration/classes.documentmigrationrunner.ts +15 -0
  159. package/ts_migration/index.ts +2 -0
  160. package/ts_migration/v41_ticketclosedcolumn.ts +106 -0
  161. package/ts_migration/v41_ticketlinkrepos.ts +91 -0
  162. package/ts_web/00_commitinfo_data.ts +1 -1
  163. package/ts_web/elements.deployments.ts +1066 -0
  164. package/ts_web/elements.directreport.ts +2 -2
  165. package/ts_web/elements.directreportsession.ts +5 -5
  166. package/ts_web/elements.harnesscontrollerapp.ts +179 -13
  167. package/ts_web/elements.makedirectreport.ts +444 -0
  168. package/ts_web/elements.nativesession.ts +29 -1
  169. package/ts_web/elements.ticketboard.ts +74 -18
  170. package/ts_web/functions.deployments.ts +225 -0
  171. package/ts_web/functions.sessionchat.ts +2 -0
@@ -1376,6 +1376,15 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
1376
1376
  "type": "string"
1377
1377
  }
1378
1378
  },
1379
+ "releasePlan": {
1380
+ "$ref": "#/$defs/ITicketReleasePlan"
1381
+ },
1382
+ "maintenanceWindow": {
1383
+ "$ref": "#/$defs/ITicketMaintenanceWindow"
1384
+ },
1385
+ "deployPlan": {
1386
+ "$ref": "#/$defs/ITicketDeployPlanInput"
1387
+ },
1379
1388
  "sourceText": {
1380
1389
  "type": "string"
1381
1390
  },
@@ -1445,8 +1454,8 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
1445
1454
  {
1446
1455
  "method": "agl.mcp.ticket.link",
1447
1456
  "path": "agl.agl_mcp_ticket_link",
1448
- "summary": "Links a branch (repo, branch, full sha), a commit (repo, sha) or a release (package, version) to a ticket assigned to t…",
1449
- "description": "Links a branch (repo, branch, full sha), a commit (repo, sha) or a release (package, version) to a\nticket assigned to the caller. Link the review branch before moving the ticket to review.",
1457
+ "summary": "Links a branch (repo, branch, full sha), a commit (repo, sha), a release (package, version) or the version a bug was fo…",
1458
+ "description": "Links a branch (repo, branch, full sha), a commit (repo, sha), a release (package, version) or the\nversion a bug was found in (`affects`: repo as org/name of a fleet repository, version) to a\nticket assigned to the caller. Link the review branch before moving the ticket to review.",
1450
1459
  "omitted": [
1451
1460
  "ownerToken"
1452
1461
  ],
@@ -1478,13 +1487,13 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
1478
1487
  ],
1479
1488
  "additionalProperties": false
1480
1489
  },
1481
- "declaration": "/**\n * Links a branch (repo, branch, full sha), a commit (repo, sha) or a release (package, version) to a\n * ticket assigned to the caller. Link the review branch before moving the ticket to review.\n */\nfunction agl_mcp_ticket_link(params: { ticketId: string; link: TTicketLink }): Promise<{ ticket: ITicket }>;"
1490
+ "declaration": "/**\n * Links a branch (repo, branch, full sha), a commit (repo, sha), a release (package, version) or the\n * version a bug was found in (`affects`: repo as org/name of a fleet repository, version) to a\n * ticket assigned to the caller. Link the review branch before moving the ticket to review.\n */\nfunction agl_mcp_ticket_link(params: { ticketId: string; link: TTicketLink }): Promise<{ ticket: ITicket }>;"
1482
1491
  },
1483
1492
  {
1484
1493
  "method": "agl.mcp.ticket.list",
1485
1494
  "path": "agl.agl_mcp_ticket_list",
1486
1495
  "summary": "Lists the shared board's tickets across all projects, filtered by `mine`, `project`, `status`, `label` or `text`.",
1487
- "description": "Lists the shared board's tickets across all projects, filtered by `mine`, `project`, `status`,\n`label` or `text`. `mine` means the caller's verified session. `label` also matches AutoLabels,\nwhich AGL computes and nobody sets: `openQuestion` marks a ticket with an unanswered question.",
1496
+ "description": "Lists the shared board's tickets across all projects, filtered by `mine`, `project`, `status`,\n`label` or `text`. `mine` means the caller's verified session. `label` also matches AutoLabels,\nwhich AGL computes and nobody sets: `openQuestion` marks a ticket with an unanswered question,\n`planned` a ticket with a release plan that is not yet released.",
1488
1497
  "omitted": [
1489
1498
  "ownerToken"
1490
1499
  ],
@@ -1525,7 +1534,7 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
1525
1534
  ],
1526
1535
  "additionalProperties": false
1527
1536
  },
1528
- "declaration": "/**\n * Lists the shared board's tickets across all projects, filtered by `mine`, `project`, `status`,\n * `label` or `text`. `mine` means the caller's verified session. `label` also matches AutoLabels,\n * which AGL computes and nobody sets: `openQuestion` marks a ticket with an unanswered question.\n */\nfunction agl_mcp_ticket_list(params?: ITicketFilters): Promise<{ tickets: ITicket[] }>;"
1537
+ "declaration": "/**\n * Lists the shared board's tickets across all projects, filtered by `mine`, `project`, `status`,\n * `label` or `text`. `mine` means the caller's verified session. `label` also matches AutoLabels,\n * which AGL computes and nobody sets: `openQuestion` marks a ticket with an unanswered question,\n * `planned` a ticket with a release plan that is not yet released.\n */\nfunction agl_mcp_ticket_list(params?: ITicketFilters): Promise<{ tickets: ITicket[] }>;"
1529
1538
  },
1530
1539
  {
1531
1540
  "method": "agl.mcp.ticket.move",
@@ -1611,11 +1620,49 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
1611
1620
  },
1612
1621
  "declaration": "/**\n * Finds tickets whose key, title, description or original words contain `query`, optionally with one label.\n */\nfunction agl_mcp_ticket_search(params: { query: string; label?: string }): Promise<{ tickets: ITicket[] }>;"
1613
1622
  },
1623
+ {
1624
+ "method": "agl.mcp.ticket.unlink",
1625
+ "path": "agl.agl_mcp_ticket_unlink",
1626
+ "summary": "Removes one link from a ticket, exactly as the ticket holds it.",
1627
+ "description": "Removes one link from a ticket, exactly as the ticket holds it. Only the driver or the owner\nunlinks, and never the evidence the ticket's column requires (a review branch, a landed branch\nor commit, a release's release link).",
1628
+ "omitted": [
1629
+ "ownerToken"
1630
+ ],
1631
+ "inputSchema": {
1632
+ "type": "object",
1633
+ "additionalProperties": false,
1634
+ "properties": {
1635
+ "ticketId": {
1636
+ "type": "string"
1637
+ },
1638
+ "link": {
1639
+ "$ref": "#/$defs/TTicketLink"
1640
+ }
1641
+ },
1642
+ "required": [
1643
+ "link",
1644
+ "ticketId"
1645
+ ]
1646
+ },
1647
+ "outputSchema": {
1648
+ "type": "object",
1649
+ "properties": {
1650
+ "ticket": {
1651
+ "$ref": "#/$defs/ITicket"
1652
+ }
1653
+ },
1654
+ "required": [
1655
+ "ticket"
1656
+ ],
1657
+ "additionalProperties": false
1658
+ },
1659
+ "declaration": "/**\n * Removes one link from a ticket, exactly as the ticket holds it. Only the driver or the owner\n * unlinks, and never the evidence the ticket's column requires (a review branch, a landed branch\n * or commit, a release's release link).\n */\nfunction agl_mcp_ticket_unlink(params: { ticketId: string; link: TTicketLink }): Promise<{ ticket: ITicket }>;"
1660
+ },
1614
1661
  {
1615
1662
  "method": "agl.mcp.ticket.update",
1616
1663
  "path": "agl.agl_mcp_ticket_update",
1617
1664
  "summary": "Changes the title, Markdown description, priority, labels, project or parent of a ticket assigned to the caller, while …",
1618
- "description": "Changes the title, Markdown description, priority, labels, project or parent of a ticket assigned\nto the caller, while `expectedRevision` still names the ticket's revision; a stale edit is\nrefused as `TICKET_REVISION_CONFLICT` with `currentRevision`, so read it again first. The status\nchanges only by a move, and only the driver or the owner assigns.",
1665
+ "description": "Changes the title, Markdown description, priority, labels, project or parent of a ticket assigned\nto the caller, while `expectedRevision` still names the ticket's revision; a stale edit is\nrefused as `TICKET_REVISION_CONFLICT` with `currentRevision`, so read it again first. The status\nchanges only by a move, and only the driver or the owner assigns. Only the driver or the owner\nsets `releasePlan` (a fleet repository as `org/name` and an optional version; `null` clears it).",
1619
1666
  "omitted": [
1620
1667
  "ownerToken"
1621
1668
  ],
@@ -1651,7 +1698,7 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
1651
1698
  ],
1652
1699
  "additionalProperties": false
1653
1700
  },
1654
- "declaration": "/**\n * Changes the title, Markdown description, priority, labels, project or parent of a ticket assigned\n * to the caller, while `expectedRevision` still names the ticket's revision; a stale edit is\n * refused as `TICKET_REVISION_CONFLICT` with `currentRevision`, so read it again first. The status\n * changes only by a move, and only the driver or the owner assigns.\n */\nfunction agl_mcp_ticket_update(params: { ticketId: string; expectedRevision: number; changes: ITicketChanges }): Promise<{ ticket: ITicket }>;"
1701
+ "declaration": "/**\n * Changes the title, Markdown description, priority, labels, project or parent of a ticket assigned\n * to the caller, while `expectedRevision` still names the ticket's revision; a stale edit is\n * refused as `TICKET_REVISION_CONFLICT` with `currentRevision`, so read it again first. The status\n * changes only by a move, and only the driver or the owner assigns. Only the driver or the owner\n * sets `releasePlan` (a fleet repository as `org/name` and an optional version; `null` clears it).\n */\nfunction agl_mcp_ticket_update(params: { ticketId: string; expectedRevision: number; changes: ITicketChanges }): Promise<{ ticket: ITicket }>;"
1655
1702
  },
1656
1703
  {
1657
1704
  "method": "agl.mcp.workspace.reveal",
@@ -3765,7 +3812,7 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
3765
3812
  },
3766
3813
  "protocolVersion": {
3767
3814
  "type": "number",
3768
- "const": 50
3815
+ "const": 51
3769
3816
  },
3770
3817
  "upgradeManagementVersion": {
3771
3818
  "type": "number"
@@ -3891,7 +3938,7 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
3891
3938
  ],
3892
3939
  "additionalProperties": false
3893
3940
  },
3894
- "declaration": "interface IControllerStatus {\n packageName: string;\n packageVersion: string;\n protocolVersion: 50;\n upgradeManagementVersion: number;\n /**\n * The protocol of the controller's loopback management endpoint (`controllerManagementProtocolVersion`); absent\n * from a controller older than the endpoint, which this release refuses to manage.\n */\n managementProtocolVersion?: number;\n controllerPid: number;\n processGroupId: number;\n processFingerprint: string;\n processMode: TControllerProcessMode;\n lifecycleState: TControllerLifecycleState;\n startedAt: number;\n setupRequired: boolean;\n /** Present when the controller runs as the systemd user unit (`agl service install`); absent for a detached or foreground one. */\n serviceUnit?: \"agl-controller.service\";\n /** The TLS mode of the runtime configuration the controller runs with; absent until it is resolved. */\n tlsMode?: TControllerTlsMode;\n upgrade?: IControllerUpgradeStatus;\n /** AGL's inference proxy, by state only; details need a signed-in owner (`controller.proxy.status.get`). */\n proxy?: { state: TControllerProxyState };\n harnesses: Array<{\n harnessId: TControllerSessionHarnessId;\n pid?: number;\n state: TControllerHarnessLifecycleState;\n healthy: boolean;\n version?: string;\n supportsLocalAttachments?: boolean;\n connectionMode?: 'local' | 'shared' | 'remote';\n diagnostic?: IControllerCodexDiagnostic;\n /** Codex only: automatic reconnection of this entry's profile to the local shared app-server. */\n rejoin?: IControllerCodexRejoinStatus;\n /**\n * Codex only, on the controller status: every connected or required profile. The entry's\n * `healthy` is then true only when each of them is, apart from a profile on an account Codex\n * cannot run on now, listed `stopped` with an `account_unavailable` diagnostic that says why;\n * its other members describe the default profile.\n */\n profiles?: IControllerCodexProfileStatus[];\n }>;\n}"
3941
+ "declaration": "interface IControllerStatus {\n packageName: string;\n packageVersion: string;\n protocolVersion: 51;\n upgradeManagementVersion: number;\n /**\n * The protocol of the controller's loopback management endpoint (`controllerManagementProtocolVersion`); absent\n * from a controller older than the endpoint, which this release refuses to manage.\n */\n managementProtocolVersion?: number;\n controllerPid: number;\n processGroupId: number;\n processFingerprint: string;\n processMode: TControllerProcessMode;\n lifecycleState: TControllerLifecycleState;\n startedAt: number;\n setupRequired: boolean;\n /** Present when the controller runs as the systemd user unit (`agl service install`); absent for a detached or foreground one. */\n serviceUnit?: \"agl-controller.service\";\n /** The TLS mode of the runtime configuration the controller runs with; absent until it is resolved. */\n tlsMode?: TControllerTlsMode;\n upgrade?: IControllerUpgradeStatus;\n /** AGL's inference proxy, by state only; details need a signed-in owner (`controller.proxy.status.get`). */\n proxy?: { state: TControllerProxyState };\n harnesses: Array<{\n harnessId: TControllerSessionHarnessId;\n pid?: number;\n state: TControllerHarnessLifecycleState;\n healthy: boolean;\n version?: string;\n supportsLocalAttachments?: boolean;\n connectionMode?: 'local' | 'shared' | 'remote';\n diagnostic?: IControllerCodexDiagnostic;\n /** Codex only: automatic reconnection of this entry's profile to the local shared app-server. */\n rejoin?: IControllerCodexRejoinStatus;\n /**\n * Codex only, on the controller status: every connected or required profile. The entry's\n * `healthy` is then true only when each of them is, apart from a profile on an account Codex\n * cannot run on now, listed `stopped` with an `account_unavailable` diagnostic that says why;\n * its other members describe the default profile.\n */\n profiles?: IControllerCodexProfileStatus[];\n }>;\n}"
3895
3942
  },
3896
3943
  {
3897
3944
  "name": "IControllerTerminalResource",
@@ -4697,11 +4744,37 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
4697
4744
  "items": {
4698
4745
  "type": "string"
4699
4746
  }
4747
+ },
4748
+ "releasePlan": {
4749
+ "anyOf": [
4750
+ {
4751
+ "$ref": "#/$defs/ITicketReleasePlan"
4752
+ },
4753
+ {
4754
+ "type": "null"
4755
+ }
4756
+ ],
4757
+ "description": "`null` clears the plan. Only the driver or owner plans releases."
4758
+ },
4759
+ "maintenanceWindow": {
4760
+ "anyOf": [
4761
+ {
4762
+ "$ref": "#/$defs/ITicketMaintenanceWindow"
4763
+ },
4764
+ {
4765
+ "type": "null"
4766
+ }
4767
+ ],
4768
+ "description": "`null` cancels the window. Only the driver or owner plans windows."
4769
+ },
4770
+ "deployPlan": {
4771
+ "$ref": "#/$defs/ITicketDeployPlanInput",
4772
+ "description": "A deploy plan asks the owner when it is set. Once asked it keeps its target and version: the same plan set again asks anew once the owner answered, and closing the ticket drops it. A deploy ticket holds no code or release: a ticket that does, or that is done, plans none, and one with a plan takes no branch, commit or release link. Only the driver or owner plans deploys."
4700
4773
  }
4701
4774
  },
4702
4775
  "additionalProperties": false
4703
4776
  },
4704
- "declaration": "interface ITicketChanges {\n title?: string;\n description?: string;\n priority?: TTicketPriority;\n assignee?: ITicketPerson | null;\n parentId?: string | null;\n project?: string;\n labels?: string[];\n}"
4777
+ "declaration": "interface ITicketChanges {\n title?: string;\n description?: string;\n priority?: TTicketPriority;\n assignee?: ITicketPerson | null;\n parentId?: string | null;\n project?: string;\n labels?: string[];\n /** `null` clears the plan. Only the driver or owner plans releases. */\n releasePlan?: ITicketReleasePlan | null;\n /** `null` cancels the window. Only the driver or owner plans windows. */\n maintenanceWindow?: ITicketMaintenanceWindow | null;\n /**\n * A deploy plan asks the owner when it is set. Once asked it keeps its target and version: the same plan set again\n * asks anew once the owner answered, and closing the ticket drops it. A deploy ticket holds no code or release: a\n * ticket that does, or that is done, plans none, and one with a plan takes no branch, commit or release link. Only the\n * driver or owner plans deploys.\n */\n deployPlan?: ITicketDeployPlanInput;\n}"
4705
4778
  },
4706
4779
  {
4707
4780
  "name": "ITicketComment",
@@ -4737,7 +4810,7 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
4737
4810
  },
4738
4811
  {
4739
4812
  "name": "ITicketCreate",
4740
- "declaration": "interface ITicketCreate {\n project: string;\n kind?: TTicketKind;\n title: string;\n description?: string;\n columnId?: TTicketColumn;\n parentId?: string;\n priority?: TTicketPriority;\n assignee?: ITicketPerson;\n labels?: string[];\n sourceText?: string;\n attachments?: ITicketAttachment[];\n}"
4813
+ "declaration": "interface ITicketCreate {\n project: string;\n kind?: TTicketKind;\n title: string;\n description?: string;\n columnId?: TTicketColumn;\n parentId?: string;\n priority?: TTicketPriority;\n assignee?: ITicketPerson;\n labels?: string[];\n releasePlan?: ITicketReleasePlan;\n maintenanceWindow?: ITicketMaintenanceWindow;\n deployPlan?: ITicketDeployPlanInput;\n sourceText?: string;\n attachments?: ITicketAttachment[];\n}"
4741
4814
  },
4742
4815
  {
4743
4816
  "name": "ITicketDeployPlan",
@@ -4760,9 +4833,30 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
4760
4833
  "questionId"
4761
4834
  ],
4762
4835
  "additionalProperties": false,
4763
- "description": "A planned deploy: the deploy target should run `version`, a release of its repository, or a newer one. Setting it asks the owner `questionId` on the ticket; the answer is the owner's go."
4836
+ "description": "A planned deploy: the deploy target should run `version`, a release of its repository, or a newer one. Setting it asks the owner `questionId` on the ticket; the answer is the owner's go. Its ticket is a deploy ticket, which holds no code or release, so no release ends it before its target runs the version."
4837
+ },
4838
+ "declaration": "/**\n * A planned deploy: the deploy target should run `version`, a release of its repository, or a newer one. Setting it\n * asks the owner `questionId` on the ticket; the answer is the owner's go. Its ticket is a deploy ticket, which holds no\n * code or release, so no release ends it before its target runs the version.\n */\ninterface ITicketDeployPlan { target: string; version: string; questionId: string }"
4839
+ },
4840
+ {
4841
+ "name": "ITicketDeployPlanInput",
4842
+ "schema": {
4843
+ "type": "object",
4844
+ "properties": {
4845
+ "target": {
4846
+ "type": "string"
4847
+ },
4848
+ "version": {
4849
+ "type": "string"
4850
+ }
4851
+ },
4852
+ "required": [
4853
+ "target",
4854
+ "version"
4855
+ ],
4856
+ "additionalProperties": false,
4857
+ "description": "What a caller plans: the deploy target and the release it should run; AGL asks the owner and records the question."
4764
4858
  },
4765
- "declaration": "/**\n * A planned deploy: the deploy target should run `version`, a release of its repository, or a newer one. Setting it\n * asks the owner `questionId` on the ticket; the answer is the owner's go.\n */\ninterface ITicketDeployPlan { target: string; version: string; questionId: string }"
4859
+ "declaration": "/** What a caller plans: the deploy target and the release it should run; AGL asks the owner and records the question. */\ninterface ITicketDeployPlanInput { target: string; version: string }"
4766
4860
  },
4767
4861
  {
4768
4862
  "name": "ITicketDetail",
@@ -5898,9 +5992,13 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
5898
5992
  "name": "TTicketAutoLabel",
5899
5993
  "schema": {
5900
5994
  "type": "string",
5901
- "const": "openQuestion"
5995
+ "enum": [
5996
+ "openQuestion",
5997
+ "planned",
5998
+ "undeployed"
5999
+ ]
5902
6000
  },
5903
- "declaration": "type TTicketAutoLabel = (readonly [\"openQuestion\"])[number];"
6001
+ "declaration": "type TTicketAutoLabel = (readonly [\"openQuestion\", \"planned\", \"undeployed\"])[number];"
5904
6002
  },
5905
6003
  {
5906
6004
  "name": "TTicketColumn",
@@ -119,6 +119,7 @@ export const aglApiMethods = {
119
119
  'agl.mcp.ticket.move': { use: 'change', tier: 'normal', roles: tickets },
120
120
  'agl.mcp.ticket.comment': { use: 'change', tier: 'normal', roles: tickets },
121
121
  'agl.mcp.ticket.link': { use: 'change', tier: 'normal', roles: tickets },
122
+ 'agl.mcp.ticket.unlink': { use: 'change', tier: 'normal', roles: tickets },
122
123
  'agl.mcp.ticket.ask': { use: 'change', tier: 'normal', roles: tickets },
123
124
  'agl.mcp.ticket.answer': { use: 'excluded', exclusion: 'person',
124
125
  reason: 'Only the owner or the driver answers ticket questions; the driver answers with its own tools.' },
@@ -145,6 +146,11 @@ export const aglApiMethods = {
145
146
  // A worker never hides its own failure: only a person acknowledges a failed session.
146
147
  'agl.mcp.sessionfeed.list': { use: 'excluded', exclusion: 'person', reason: ownerToken },
147
148
  'agl.mcp.sessionfeed.acknowledge': { use: 'excluded', exclusion: 'person', reason: ownerToken },
149
+ 'agl.mcp.deploy.status': { use: 'excluded', exclusion: 'person', reason: ownerToken },
150
+ 'agl.mcp.deploy.history': { use: 'excluded', exclusion: 'person', reason: ownerToken },
151
+ 'agl.mcp.deploy.probe': { use: 'excluded', exclusion: 'person', reason: ownerToken },
152
+ 'agl.mcp.deploy.release': { use: 'excluded', exclusion: 'person', reason: ownerToken },
153
+ 'agl.mcp.deploy.ticket': { use: 'excluded', exclusion: 'person', reason: ownerToken },
148
154
  'agl.mcp.worker.enroll': { use: 'excluded', exclusion: 'transport',
149
155
  reason: 'It enrols the caller credential of a launched worker: the MCP channel itself.' },
150
156
  } as const satisfies Record<TControllerMcpMethod, TAglApiMethodUse>;
@@ -1610,6 +1610,19 @@ export class SmartDataAuthStore implements IAuthStore, IAuthStoreSessionIdentity
1610
1610
  .runTicketOwnerPrincipal(ticketOwnerPrincipalId(await this.getState()));
1611
1611
  }
1612
1612
 
1613
+ /** AGL-916: tickets released by hand without a release link move to the closed column; answers the keys it moved. */
1614
+ public async migrateTicketClosedColumn(): Promise<string[]> {
1615
+ return await new PostDatabaseDocumentMigrationRunner(this.database).runTicketClosedColumn();
1616
+ }
1617
+
1618
+ /**
1619
+ * AGL-909: once, links and release plans name each repository `resolveArg` resolves as `org/name`; answers the keys it
1620
+ * changed. With no repository discovered (`discoveredArg` 0) it waits for a later start.
1621
+ */
1622
+ public async migrateTicketLinkRepos(resolveArg: (nameArg: string) => string | undefined, discoveredArg: number): Promise<string[]> {
1623
+ return await new PostDatabaseDocumentMigrationRunner(this.database).runTicketLinkRepos(resolveArg, discoveredArg);
1624
+ }
1625
+
1613
1626
  public async assertSetupAuthority(
1614
1627
  setupCodeArg: string,
1615
1628
  ceremonyArg?: IWebAuthnSetupCeremonyDocument,
package/ts/classes.cli.ts CHANGED
@@ -144,6 +144,8 @@ Usage:
144
144
  ${currentCliName} temp-password [--port 4097] [--ttl-hours 24]
145
145
  ${currentCliName} remote set|unset|secret import [--port 4097] [options]
146
146
  ${currentCliName} feed list [--state failed] [--json] | acknowledge <row-id> --updated-at <ms> [--json]
147
+ ${currentCliName} deploy status [TARGET] | history TARGET | probe TARGET [--json]
148
+ ${currentCliName} release status [REPO] [--json]
147
149
 
148
150
  Commands:
149
151
  start Start ${currentRuntimeName} as a detached process (Linux and macOS)
@@ -154,6 +156,8 @@ Commands:
154
156
  ticket Shared project tickets, comments, assignments and atomic board moves
155
157
  fleet Verified branch landing, release tooling and read-only repository audit
156
158
  feed List the sidebar's session feed and acknowledge failed rows as the owner (feed --help)
159
+ deploy What each deploy target runs, as its probe observed it, its history, and a probe now (deploy --help)
160
+ release A repository's newest release tag, its release plans and what the next release ships (release --help)
157
161
  stop Verify and stop the live ${currentRuntimeName} process
158
162
  restart Stop the live ${currentRuntimeName} process and start it again (sessions are not continued)
159
163
  service Run ${currentRuntimeName} as the systemd user unit ${controllerServiceUnitName} (Linux, pnpm-global install)
@@ -2037,6 +2041,11 @@ const runCliCommand = async (testArgvArg?: string[]): Promise<void> => {
2037
2041
  await runFleetCli(runtimeArguments.slice(1));
2038
2042
  return;
2039
2043
  }
2044
+ if (runtimeArguments[0] === 'deploy' || runtimeArguments[0] === 'release') {
2045
+ const { runDeployCli } = await import('./functions.deploycli.js');
2046
+ await runDeployCli(runtimeArguments[0], runtimeArguments.slice(1));
2047
+ return;
2048
+ }
2040
2049
  if (runtimeArguments[0] === 'feed') {
2041
2050
  const { runFeedCli } = await import('./functions.feedcli.js');
2042
2051
  await runFeedCli(runtimeArguments.slice(1));