feat(agent): add risk-adjusted action portfolio

apps/gittensory-ui/public/openapi.json

@@ -421,6 +421,231 @@
           "detail"
         ]
       },
+      "ActionPortfolio": {
+        "type": "object",
+        "properties": {
+          "generatedAt": {
+            "type": "string"
+          },
+          "bucketOrder": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ActionPortfolioBucketName"
+            }
+          },
+          "buckets": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "bucket": {
+                  "$ref": "#/components/schemas/ActionPortfolioBucketName"
+                },
+                "label": {
+                  "type": "string"
+                },
+                "summary": {
+                  "type": "string"
+                },
+                "actions": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ActionPortfolioItem"
+                  }
+                }
+              },
+              "required": [
+                "bucket",
+                "label",
+                "summary",
+                "actions"
+              ]
+            }
+          },
+          "topActions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ActionPortfolioItem"
+            }
+          },
+          "counts": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "number"
+            }
+          },
+          "summary": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "generatedAt",
+          "bucketOrder",
+          "buckets",
+          "topActions",
+          "counts",
+          "summary"
+        ]
+      },
+      "ActionPortfolioBucketName": {
+        "type": "string",
+        "enum": [
+          "cleanup",
+          "wait",
+          "direct_pr",
+          "issue_discovery",
+          "avoid",
+          "maintainer_lane"
+        ]
+      },
+      "ActionPortfolioItem": {
+        "type": "object",
+        "properties": {
+          "bucket": {
+            "$ref": "#/components/schemas/ActionPortfolioBucketName"
+          },
+          "repoFullName": {
+            "type": "string"
+          },
+          "actionKind": {
+            "$ref": "#/components/schemas/DecisionActionKind"
+          },
+          "priorityScore": {
+            "type": "number"
+          },
+          "recommendation": {
+            "$ref": "#/components/schemas/DecisionRecommendation"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "recommended",
+              "blocked",
+              "watch"
+            ]
+          },
+          "whyNow": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "scoreabilityImpact": {
+            "type": "string"
+          },
+          "riskImpact": {
+            "type": "string"
+          },
+          "maintainerImpact": {
+            "type": "string"
+          },
+          "blockedBy": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "rerunWhen": {
+            "type": "string"
+          },
+          "publicSafeSummary": {
+            "type": "string"
+          },
+          "nextActions": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "publicNextActions": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "source": {
+            "type": "string",
+            "enum": [
+              "decision_pack"
+            ]
+          },
+          "scenarioProjection": {
+            "type": "object",
+            "properties": {
+              "source": {
+                "type": "string",
+                "enum": [
+                  "github_observed",
+                  "user_supplied"
+                ]
+              },
+              "pendingMergedPrCount": {
+                "type": "number"
+              },
+              "pendingClosedPrCount": {
+                "type": "number"
+              },
+              "approvedPrCount": {
+                "type": "number"
+              },
+              "expectedOpenPrCountAfterMerge": {
+                "type": "number"
+              },
+              "notes": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "source",
+              "pendingMergedPrCount",
+              "pendingClosedPrCount",
+              "approvedPrCount",
+              "notes"
+            ]
+          }
+        },
+        "required": [
+          "bucket",
+          "repoFullName",
+          "priorityScore",
+          "recommendation",
+          "status",
+          "whyNow",
+          "scoreabilityImpact",
+          "riskImpact",
+          "maintainerImpact",
+          "blockedBy",
+          "rerunWhen",
+          "publicSafeSummary",
+          "nextActions",
+          "publicNextActions",
+          "source"
+        ]
+      },
+      "DecisionActionKind": {
+        "type": "string",
+        "enum": [
+          "cleanup_existing_prs",
+          "land_existing_prs",
+          "open_new_direct_pr",
+          "file_issue_discovery",
+          "maintainer_lane_improve_repo",
+          "maintainer_cut_readiness"
+        ]
+      },
+      "DecisionRecommendation": {
+        "type": "string",
+        "enum": [
+          "pursue",
+          "cleanup_first",
+          "maintainer_lane",
+          "avoid_for_now",
+          "watch"
+        ]
+      },
       "WorkboardItem": {
         "type": "object",
         "properties": {
@@ -1977,6 +2202,9 @@
               }
             }
           },
+          "actionPortfolio": {
+            "$ref": "#/components/schemas/ActionPortfolio"
+          },
           "cleanupFirst": {
             "type": "array",
             "items": {
@@ -2062,6 +2290,7 @@
           "opportunities",
           "repoDecisions",
           "topActions",
+          "actionPortfolio",
           "cleanupFirst",
           "pursueRepos",
           "avoidRepos",

src/openapi/schemas.ts

@@ -1425,6 +1425,63 @@ export const ContributorStrategySchema = z
 
 export const DecisionPackFreshnessSchema = z.enum(["fresh", "stale", "rebuilding", "missing"]).openapi("DecisionPackFreshness");
 
+export const DecisionRecommendationSchema = z.enum(["pursue", "cleanup_first", "maintainer_lane", "avoid_for_now", "watch"]).openapi("DecisionRecommendation");
+
+export const DecisionActionKindSchema = z
+  .enum(["cleanup_existing_prs", "land_existing_prs", "open_new_direct_pr", "file_issue_discovery", "maintainer_lane_improve_repo", "maintainer_cut_readiness"])
+  .openapi("DecisionActionKind");
+
+export const ActionPortfolioBucketNameSchema = z.enum(["cleanup", "wait", "direct_pr", "issue_discovery", "avoid", "maintainer_lane"]).openapi("ActionPortfolioBucketName");
+
+export const ActionPortfolioItemSchema = z
+  .object({
+    bucket: ActionPortfolioBucketNameSchema,
+    repoFullName: z.string(),
+    actionKind: DecisionActionKindSchema.optional(),
+    priorityScore: z.number(),
+    recommendation: DecisionRecommendationSchema,
+    status: z.enum(["recommended", "blocked", "watch"]),
+    whyNow: z.array(z.string()),
+    scoreabilityImpact: z.string(),
+    riskImpact: z.string(),
+    maintainerImpact: z.string(),
+    blockedBy: z.array(z.string()),
+    rerunWhen: z.string(),
+    publicSafeSummary: z.string(),
+    nextActions: z.array(z.string()),
+    publicNextActions: z.array(z.string()),
+    source: z.enum(["decision_pack"]),
+    scenarioProjection: z
+      .object({
+        source: z.enum(["github_observed", "user_supplied"]),
+        pendingMergedPrCount: z.number(),
+        pendingClosedPrCount: z.number(),
+        approvedPrCount: z.number(),
+        expectedOpenPrCountAfterMerge: z.number().optional(),
+        notes: z.array(z.string()),
+      })
+      .optional(),
+  })
+  .openapi("ActionPortfolioItem");
+
+export const ActionPortfolioSchema = z
+  .object({
+    generatedAt: z.string(),
+    bucketOrder: z.array(ActionPortfolioBucketNameSchema),
+    buckets: z.array(
+      z.object({
+        bucket: ActionPortfolioBucketNameSchema,
+        label: z.string(),
+        summary: z.string(),
+        actions: z.array(ActionPortfolioItemSchema),
+      }),
+    ),
+    topActions: z.array(ActionPortfolioItemSchema),
+    counts: z.record(z.string(), z.number()),
+    summary: z.string(),
+  })
+  .openapi("ActionPortfolio");
+
 export const ContributorDecisionPackSchema = z
   .object({
     status: z.enum(["ready"]),
@@ -1442,6 +1499,7 @@ export const ContributorDecisionPackSchema = z
     opportunities: z.array(ContributorOpportunitySchema),
     repoDecisions: z.array(z.record(z.string(), z.unknown())),
     topActions: z.array(z.record(z.string(), z.unknown())),
+    actionPortfolio: ActionPortfolioSchema,
     cleanupFirst: z.array(z.record(z.string(), z.unknown())),
     pursueRepos: z.array(z.record(z.string(), z.unknown())),
     avoidRepos: z.array(z.record(z.string(), z.unknown())),

src/openapi/spec.ts

@@ -2,6 +2,7 @@ import { OpenApiGeneratorV3, OpenAPIRegistry } from "@asteasolutions/zod-to-open
 import { z } from "zod";
 import {
   AdvisorySchema,
+  ActionPortfolioSchema,
   AgentActionSchema,
   AgentContextSnapshotSchema,
   AgentRunBundleSchema,
@@ -80,6 +81,7 @@ export function buildOpenApiSpec() {
   registry.register("RegistrySnapshot", RegistrySnapshotSchema);
   registry.register("Repository", RepositorySchema);
   registry.register("Advisory", AdvisorySchema);
+  registry.register("ActionPortfolio", ActionPortfolioSchema);
   registry.register("WorkboardItem", WorkboardItemSchema);
   registry.register("QueueHealth", QueueHealthSchema);
   registry.register("CollisionReport", CollisionReportSchema);