@oss-autopilot/core 3.11.0 → 3.13.0

package/dist/formatters/json.d.ts

@@ -3,6 +3,7 @@
  * Provides structured output that can be consumed by scripts and plugins
  */
 import { z, type ZodType } from 'zod';
+import type { AttentionSummary } from '../core/pr-attention.js';
 import type { FetchedPR, DailyDigest, AgentState, RepoGroup, CommentedIssue, ShelvedPRRef, SearchPriority, CapacityAssessment, ActionableIssue, ActionableIssueType, CompactActionableIssue, ActionMenuItem, ActionMenu } from '../core/types.js';
 import type { ContributionStats } from '../core/stats.js';
 import type { PRCheckFailure } from '../core/pr-monitor.js';
@@ -87,6 +88,8 @@ export interface DailyOutput {
     summary: string;
     briefSummary: string;
     actionableIssues: CompactActionableIssue[];
+    /** Unified attention-bucket counts (#1352) — same classifier the dashboard stamps per-PR. */
+    attention: AttentionSummary;
     actionMenu: ActionMenu;
     commentedIssues: CommentedIssue[];
     repoGroups: CompactRepoGroup[];
@@ -119,6 +122,8 @@ export interface CompactDailyOutput {
     capacity: CapacityAssessment;
     briefSummary: string;
     actionableIssues: CompactActionableIssue[];
+    /** Unified attention-bucket counts (#1352), retained under --compact. */
+    attention: AttentionSummary;
     actionMenu: ActionMenu;
     commentedIssues: CommentedIssue[];
     /** Number of PRs that failed to fetch. Non-zero indicates partial results. */
@@ -285,6 +290,12 @@ export declare const StrategyOutputSchema: z.ZodObject<{
     message: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type StrategyCommandOutput = z.infer<typeof StrategyOutputSchema>;
+export declare const AttentionSummarySchema: z.ZodObject<{
+    needsAttention: z.ZodNumber;
+    stuckCI: z.ZodNumber;
+    dormantFollowup: z.ZodNumber;
+    waiting: z.ZodNumber;
+}, z.core.$strip>;
 export declare const DailyOutputSchema: z.ZodObject<{
     digest: z.ZodObject<{
         generatedAt: z.ZodString;
@@ -348,6 +359,12 @@ export declare const DailyOutputSchema: z.ZodObject<{
         label: z.ZodString;
         isNewContribution: z.ZodBoolean;
     }, z.core.$strip>>;
+    attention: z.ZodObject<{
+        needsAttention: z.ZodNumber;
+        stuckCI: z.ZodNumber;
+        dormantFollowup: z.ZodNumber;
+        waiting: z.ZodNumber;
+    }, z.core.$strip>;
     actionMenu: z.ZodObject<{
         items: z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -493,6 +510,12 @@ export declare const CompactDailyOutputSchema: z.ZodObject<{
         label: z.ZodString;
         isNewContribution: z.ZodBoolean;
     }, z.core.$strip>>;
+    attention: z.ZodObject<{
+        needsAttention: z.ZodNumber;
+        stuckCI: z.ZodNumber;
+        dormantFollowup: z.ZodNumber;
+        waiting: z.ZodNumber;
+    }, z.core.$strip>;
     actionMenu: z.ZodObject<{
         items: z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -625,9 +648,11 @@ export declare const SearchOutputSchema: z.ZodObject<{
         }, z.core.$strip>>;
         boostScore: z.ZodOptional<z.ZodNumber>;
         boostReasons: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        diversitySlot: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     excludedRepos: z.ZodArray<z.ZodString>;
     aiPolicyBlocklist: z.ZodArray<z.ZodString>;
+    hiddenOwnPRCount: z.ZodNumber;
     rateLimitWarning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const FeaturesOutputSchema: z.ZodObject<{
@@ -683,6 +708,7 @@ export declare const FeaturesOutputSchema: z.ZodObject<{
         }, z.core.$strip>>;
         boostScore: z.ZodOptional<z.ZodNumber>;
         boostReasons: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        diversitySlot: z.ZodOptional<z.ZodBoolean>;
         horizon: z.ZodEnum<{
             "quick-win": "quick-win";
             "bigger-bet": "bigger-bet";
@@ -740,6 +766,7 @@ export declare const FeaturesOutputSchema: z.ZodObject<{
         }, z.core.$strip>>;
         boostScore: z.ZodOptional<z.ZodNumber>;
         boostReasons: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        diversitySlot: z.ZodOptional<z.ZodBoolean>;
         horizon: z.ZodEnum<{
             "quick-win": "quick-win";
             "bigger-bet": "bigger-bet";
@@ -784,7 +811,7 @@ export declare const ListMoveTierOutputSchema: z.ZodObject<{
     }>;
     fromTier: z.ZodOptional<z.ZodString>;
     count: z.ZodNumber;
-    reason: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodLiteral<"already in target tier">>;
 }, z.core.$strip>;
 export declare const ListMarkDoneOutputSchema: z.ZodObject<{
     marked: z.ZodBoolean;
@@ -792,7 +819,53 @@ export declare const ListMarkDoneOutputSchema: z.ZodObject<{
     url: z.ZodString;
     repoHeadingStruck: z.ZodBoolean;
     remainingUnderRepo: z.ZodNumber;
-    reason: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodLiteral<"already marked done">>;
+}, z.core.$strip>;
+export declare const VerifyIssueOutputSchema: z.ZodObject<{
+    url: z.ZodString;
+    owner: z.ZodString;
+    repo: z.ZodString;
+    number: z.ZodNumber;
+    title: z.ZodString;
+    state: z.ZodEnum<{
+        closed: "closed";
+        open: "open";
+    }>;
+    stateReason: z.ZodNullable<z.ZodEnum<{
+        completed: "completed";
+        reopened: "reopened";
+        not_planned: "not_planned";
+        duplicate: "duplicate";
+    }>>;
+    closedAt: z.ZodNullable<z.ZodString>;
+    assignees: z.ZodArray<z.ZodString>;
+    linkedPRs: z.ZodArray<z.ZodObject<{
+        number: z.ZodNumber;
+        url: z.ZodString;
+        title: z.ZodString;
+        state: z.ZodEnum<{
+            closed: "closed";
+            open: "open";
+            merged: "merged";
+        }>;
+        isDraft: z.ZodBoolean;
+        author: z.ZodNullable<z.ZodString>;
+        isOwn: z.ZodBoolean;
+        linkType: z.ZodEnum<{
+            closing: "closing";
+            "cross-referenced": "cross-referenced";
+        }>;
+        updatedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    verdict: z.ZodEnum<{
+        closed: "closed";
+        "own-open-pr": "own-open-pr";
+        taken: "taken";
+        "at-risk": "at-risk";
+        available: "available";
+    }>;
+    verdictReason: z.ZodString;
+    userLogin: z.ZodString;
 }, z.core.$strip>;
 export declare const PostOutputSchema: z.ZodObject<{
     commentUrl: z.ZodString;
@@ -1146,12 +1219,21 @@ export interface SearchCandidate {
      * opportunities (open PR + no updates for 30+ days, scout 0.9.0 #97).
      */
     linkedPR?: CandidateLinkedPR;
+    /** Strategy-bias sort boost from scout (#1244); absent when unboosted. */
+    boostScore?: number;
+    /** Human-readable boost explanations, e.g. "repo affinity: vercel/next.js". */
+    boostReasons?: string[];
+    /** True when this candidate filled a diversity slot (#1244). */
+    diversitySlot?: boolean;
 }
 export interface SearchOutput {
     candidates: SearchCandidate[];
     excludedRepos: string[];
     /** Repos with known anti-AI contribution policies, filtered from search results (#108). */
     aiPolicyBlocklist: string[];
+    /** Candidates dropped because the authenticated user already has an open PR
+     * linked to the issue (#1354). Surfaced as a count so the filter is visible. */
+    hiddenOwnPRCount: number;
     /** Present when rate limits affected the search — either low pre-flight quota or mid-search rate limit hits (#100). */
     rateLimitWarning?: string;
 }

package/dist/formatters/json.js

@@ -26,6 +26,7 @@ export function toCompactDailyOutput(output) {
         capacity: output.capacity,
         briefSummary: output.briefSummary,
         actionableIssues: output.actionableIssues,
+        attention: output.attention,
         actionMenu: output.actionMenu,
         commentedIssues: output.commentedIssues,
         failureCount: output.failures.length,
@@ -271,12 +272,19 @@ export const StrategyOutputSchema = z.object({
     strategy: StrategyResultSchema.nullable(),
     message: z.string().optional(),
 });
+export const AttentionSummarySchema = z.object({
+    needsAttention: z.number().int().nonnegative(),
+    stuckCI: z.number().int().nonnegative(),
+    dormantFollowup: z.number().int().nonnegative(),
+    waiting: z.number().int().nonnegative(),
+});
 export const DailyOutputSchema = z.object({
     digest: DailyDigestCompactSchema,
     capacity: CapacityAssessmentSchema,
     summary: z.string(),
     briefSummary: z.string(),
     actionableIssues: z.array(CompactActionableIssueSchema),
+    attention: AttentionSummarySchema,
     actionMenu: ActionMenuSchema,
     commentedIssues: z.array(CommentedIssuePassthroughSchema),
     repoGroups: z.array(CompactRepoGroupSchema),
@@ -289,6 +297,7 @@ export const CompactDailyOutputSchema = z.object({
     capacity: CapacityAssessmentSchema,
     briefSummary: z.string(),
     actionableIssues: z.array(CompactActionableIssueSchema),
+    attention: AttentionSummarySchema,
     actionMenu: ActionMenuSchema,
     commentedIssues: z.array(CommentedIssuePassthroughSchema),
     failureCount: z.number().int().nonnegative(),
@@ -344,11 +353,15 @@ const SearchCandidateSchema = z.object({
      */
     boostScore: z.number().optional(),
     boostReasons: z.array(z.string()).optional(),
+    /** True when this candidate filled a diversity slot (#1244) — surfaced so
+     * the user can see the counterweight working, not just its absence. */
+    diversitySlot: z.boolean().optional(),
 });
 export const SearchOutputSchema = z.object({
     candidates: z.array(SearchCandidateSchema),
     excludedRepos: z.array(z.string()),
     aiPolicyBlocklist: z.array(z.string()),
+    hiddenOwnPRCount: z.number().int().nonnegative(),
     rateLimitWarning: z.string().optional(),
 });
 // ── Features output schema (scout 0.9.0 #97/#98/#99) ─────────────────
@@ -396,7 +409,10 @@ export const ListMoveTierOutputSchema = z.object({
     toTier: z.enum(['pursue', 'maybe', 'skip']),
     fromTier: z.string().optional(),
     count: z.number().int().nonnegative(),
-    reason: z.string().optional(),
+    // #1355: not-found now throws before reaching the success envelope, so the
+    // only reachable no-op reason is the idempotent one. Pinned so a new quiet
+    // no-op path trips the #1105 runtime validator instead of shipping silently.
+    reason: z.literal('already in target tier').optional(),
 });
 // list-mark-done (#1299): mirrors {@link MarkDoneOutput} from the command
 // module. Strict shape — additional keys must be added here AND in the
@@ -408,7 +424,39 @@ export const ListMarkDoneOutputSchema = z.object({
     url: z.string(),
     repoHeadingStruck: z.boolean(),
     remainingUnderRepo: z.number().int().nonnegative(),
-    reason: z.string().optional(),
+    // #1406: not-found now throws before the success envelope, so the only
+    // reachable no-op reason is the idempotent one. Pinned so a new quiet
+    // no-op path trips the #1105 runtime validator instead of shipping silently.
+    reason: z.literal('already marked done').optional(),
+});
+// verify-issue (#1353, #1354): mirrors {@link IssueVerification} from
+// core/issue-verification.ts. Strict shape — additional keys must be added
+// here AND in the module output, otherwise the validator rejects the
+// response before it reaches consumers.
+export const VerifyIssueOutputSchema = z.object({
+    url: z.string(),
+    owner: z.string(),
+    repo: z.string(),
+    number: z.number().int().positive(),
+    title: z.string(),
+    state: z.enum(['open', 'closed']),
+    stateReason: z.enum(['completed', 'not_planned', 'reopened', 'duplicate']).nullable(),
+    closedAt: z.string().nullable(),
+    assignees: z.array(z.string()),
+    linkedPRs: z.array(z.object({
+        number: z.number().int().positive(),
+        url: z.string(),
+        title: z.string(),
+        state: z.enum(['open', 'closed', 'merged']),
+        isDraft: z.boolean(),
+        author: z.string().nullable(),
+        isOwn: z.boolean(),
+        linkType: z.enum(['closing', 'cross-referenced']),
+        updatedAt: z.string().nullable(),
+    })),
+    verdict: z.enum(['closed', 'own-open-pr', 'taken', 'at-risk', 'available']),
+    verdictReason: z.string(),
+    userLogin: z.string(),
 });
 // ── #1155: Zod coverage for remaining CLI commands ───────────────────
 export const PostOutputSchema = z.object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oss-autopilot/core",
-  "version": "3.11.0",
+  "version": "3.13.0",
   "description": "CLI and core library for managing open source contributions",
   "type": "module",
   "bin": {
@@ -59,7 +59,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^25.9.1",
+    "@types/node": "^25.9.3",
     "@vitest/coverage-v8": "^4.1.8",
     "esbuild": "^0.28.0",
     "tsx": "^4.22.4",