@oss-autopilot/core 3.5.0 → 3.7.0

package/dist/formatters/json.d.ts

@@ -97,6 +97,13 @@ export interface DailyOutput {
      * on clean runs. See #1042.
      */
     warnings: DailyWarning[];
+    /**
+     * Periodic contribution-strategy snapshot (#1270). Populated when the
+     * cadence trigger fires AND the user has crossed the merge floor. The
+     * `/oss` action menu renders this inline ahead of the action options;
+     * absent or null on runs where the gate stays silent.
+     */
+    strategySummary?: import('../core/strategy.js').StrategyResult | null;
 }
 /**
  * Compact version of DailyOutput for reduced JSON payload size (#763).
@@ -122,6 +129,8 @@ export interface CompactDailyOutput {
      * the `--compact` payload. See #1042.
      */
     warnings: DailyWarning[];
+    /** Periodic strategy snapshot, threaded through compact mode for parity. See {@link DailyOutput.strategySummary}. */
+    strategySummary?: import('../core/strategy.js').StrategyResult | null;
 }
 /**
  * Strip a full DailyOutput down to the compact subset (#763).
@@ -275,6 +284,50 @@ export declare const DailyOutputSchema: z.ZodObject<{
         timestamp: z.ZodOptional<z.ZodString>;
         details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>;
+    strategySummary: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        profile: z.ZodObject<{
+            style: z.ZodEnum<{
+                maintainer: "maintainer";
+                explorer: "explorer";
+                specialist: "specialist";
+                generalist: "generalist";
+            }>;
+            totalPRs: z.ZodNumber;
+            mergedCount: z.ZodNumber;
+            mergeRate: z.ZodNumber;
+            primaryLanguages: z.ZodArray<z.ZodString>;
+            favoriteRepos: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>;
+        capacity: z.ZodObject<{
+            openPRCount: z.ZodNumber;
+            dormantPRCount: z.ZodNumber;
+            dormantRepoCount: z.ZodNumber;
+            overExtended: z.ZodBoolean;
+            suggestedAction: z.ZodUnion<readonly [z.ZodLiteral<"open_more">, z.ZodLiteral<"follow_up_dormant">, z.ZodLiteral<"wait_on_maintainers">, z.ZodNull]>;
+        }, z.core.$loose>;
+        patterns: z.ZodObject<{
+            prTypeDistribution: z.ZodObject<{
+                docs: z.ZodNumber;
+                fixes: z.ZodNumber;
+                features: z.ZodNumber;
+                refactors: z.ZodNumber;
+                tests: z.ZodNumber;
+                other: z.ZodNumber;
+            }, z.core.$loose>;
+            trajectoryDirection: z.ZodEnum<{
+                growing: "growing";
+                steady: "steady";
+                declining: "declining";
+            }>;
+            averagePRSize: z.ZodNumber;
+        }, z.core.$loose>;
+        recommendations: z.ZodObject<{
+            languages: z.ZodArray<z.ZodString>;
+            repos: z.ZodArray<z.ZodString>;
+            issueTypes: z.ZodArray<z.ZodString>;
+            avoidPatterns: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>;
+    }, z.core.$loose>>>;
 }, z.core.$strip>;
 export declare const CompactDailyOutputSchema: z.ZodObject<{
     digest: z.ZodObject<{
@@ -371,6 +424,50 @@ export declare const CompactDailyOutputSchema: z.ZodObject<{
         timestamp: z.ZodOptional<z.ZodString>;
         details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>;
+    strategySummary: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        profile: z.ZodObject<{
+            style: z.ZodEnum<{
+                maintainer: "maintainer";
+                explorer: "explorer";
+                specialist: "specialist";
+                generalist: "generalist";
+            }>;
+            totalPRs: z.ZodNumber;
+            mergedCount: z.ZodNumber;
+            mergeRate: z.ZodNumber;
+            primaryLanguages: z.ZodArray<z.ZodString>;
+            favoriteRepos: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>;
+        capacity: z.ZodObject<{
+            openPRCount: z.ZodNumber;
+            dormantPRCount: z.ZodNumber;
+            dormantRepoCount: z.ZodNumber;
+            overExtended: z.ZodBoolean;
+            suggestedAction: z.ZodUnion<readonly [z.ZodLiteral<"open_more">, z.ZodLiteral<"follow_up_dormant">, z.ZodLiteral<"wait_on_maintainers">, z.ZodNull]>;
+        }, z.core.$loose>;
+        patterns: z.ZodObject<{
+            prTypeDistribution: z.ZodObject<{
+                docs: z.ZodNumber;
+                fixes: z.ZodNumber;
+                features: z.ZodNumber;
+                refactors: z.ZodNumber;
+                tests: z.ZodNumber;
+                other: z.ZodNumber;
+            }, z.core.$loose>;
+            trajectoryDirection: z.ZodEnum<{
+                growing: "growing";
+                steady: "steady";
+                declining: "declining";
+            }>;
+            averagePRSize: z.ZodNumber;
+        }, z.core.$loose>;
+        recommendations: z.ZodObject<{
+            languages: z.ZodArray<z.ZodString>;
+            repos: z.ZodArray<z.ZodString>;
+            issueTypes: z.ZodArray<z.ZodString>;
+            avoidPatterns: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>;
+    }, z.core.$loose>>>;
 }, z.core.$strip>;
 export declare const SearchOutputSchema: z.ZodObject<{
     candidates: z.ZodArray<z.ZodObject<{
@@ -412,11 +509,137 @@ export declare const SearchOutputSchema: z.ZodObject<{
             isResponsive: z.ZodBoolean;
             lastMergedAt: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        linkedPR: z.ZodOptional<z.ZodObject<{
+            number: z.ZodNumber;
+            state: z.ZodEnum<{
+                closed: "closed";
+                open: "open";
+                merged: "merged";
+            }>;
+            url: z.ZodString;
+            updatedAt: z.ZodOptional<z.ZodString>;
+            isStalled: z.ZodBoolean;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     excludedRepos: z.ZodArray<z.ZodString>;
     aiPolicyBlocklist: z.ZodArray<z.ZodString>;
     rateLimitWarning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+export declare const FeaturesOutputSchema: z.ZodObject<{
+    quickWins: z.ZodArray<z.ZodObject<{
+        issue: z.ZodObject<{
+            repo: z.ZodString;
+            repoUrl: z.ZodString;
+            number: z.ZodNumber;
+            title: z.ZodString;
+            url: z.ZodString;
+            labels: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        recommendation: z.ZodEnum<{
+            approve: "approve";
+            skip: "skip";
+            needs_review: "needs_review";
+        }>;
+        reasonsToApprove: z.ZodArray<z.ZodString>;
+        reasonsToSkip: z.ZodArray<z.ZodString>;
+        searchPriority: z.ZodEnum<{
+            normal: "normal";
+            merged_pr: "merged_pr";
+            preferred_org: "preferred_org";
+            starred: "starred";
+        }>;
+        viabilityScore: z.ZodNumber;
+        grade: z.ZodObject<{
+            letter: z.ZodEnum<{
+                A: "A";
+                B: "B";
+                C: "C";
+                F: "F";
+            }>;
+            reason: z.ZodString;
+        }, z.core.$strip>;
+        repoScore: z.ZodOptional<z.ZodObject<{
+            score: z.ZodNumber;
+            mergedPRCount: z.ZodNumber;
+            closedWithoutMergeCount: z.ZodNumber;
+            isResponsive: z.ZodBoolean;
+            lastMergedAt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        linkedPR: z.ZodOptional<z.ZodObject<{
+            number: z.ZodNumber;
+            state: z.ZodEnum<{
+                closed: "closed";
+                open: "open";
+                merged: "merged";
+            }>;
+            url: z.ZodString;
+            updatedAt: z.ZodOptional<z.ZodString>;
+            isStalled: z.ZodBoolean;
+        }, z.core.$strip>>;
+        horizon: z.ZodEnum<{
+            "quick-win": "quick-win";
+            "bigger-bet": "bigger-bet";
+        }>;
+    }, z.core.$strip>>;
+    biggerBets: z.ZodArray<z.ZodObject<{
+        issue: z.ZodObject<{
+            repo: z.ZodString;
+            repoUrl: z.ZodString;
+            number: z.ZodNumber;
+            title: z.ZodString;
+            url: z.ZodString;
+            labels: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        recommendation: z.ZodEnum<{
+            approve: "approve";
+            skip: "skip";
+            needs_review: "needs_review";
+        }>;
+        reasonsToApprove: z.ZodArray<z.ZodString>;
+        reasonsToSkip: z.ZodArray<z.ZodString>;
+        searchPriority: z.ZodEnum<{
+            normal: "normal";
+            merged_pr: "merged_pr";
+            preferred_org: "preferred_org";
+            starred: "starred";
+        }>;
+        viabilityScore: z.ZodNumber;
+        grade: z.ZodObject<{
+            letter: z.ZodEnum<{
+                A: "A";
+                B: "B";
+                C: "C";
+                F: "F";
+            }>;
+            reason: z.ZodString;
+        }, z.core.$strip>;
+        repoScore: z.ZodOptional<z.ZodObject<{
+            score: z.ZodNumber;
+            mergedPRCount: z.ZodNumber;
+            closedWithoutMergeCount: z.ZodNumber;
+            isResponsive: z.ZodBoolean;
+            lastMergedAt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        linkedPR: z.ZodOptional<z.ZodObject<{
+            number: z.ZodNumber;
+            state: z.ZodEnum<{
+                closed: "closed";
+                open: "open";
+                merged: "merged";
+            }>;
+            url: z.ZodString;
+            updatedAt: z.ZodOptional<z.ZodString>;
+            isStalled: z.ZodBoolean;
+        }, z.core.$strip>>;
+        horizon: z.ZodEnum<{
+            "quick-win": "quick-win";
+            "bigger-bet": "bigger-bet";
+        }>;
+    }, z.core.$strip>>;
+    anchorRepos: z.ZodArray<z.ZodString>;
+    message: z.ZodNullable<z.ZodString>;
+    rateLimitWarning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const DoctorOutputSchema: z.ZodObject<{
     checks: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -454,6 +677,14 @@ export declare const ListMoveTierOutputSchema: z.ZodObject<{
     count: z.ZodNumber;
     reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+export declare const ListMarkDoneOutputSchema: z.ZodObject<{
+    marked: z.ZodBoolean;
+    filePath: z.ZodString;
+    url: z.ZodString;
+    repoHeadingStruck: z.ZodBoolean;
+    remainingUnderRepo: z.ZodNumber;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const PostOutputSchema: z.ZodObject<{
     commentUrl: z.ZodString;
     url: z.ZodString;
@@ -741,46 +972,95 @@ export declare const LocalReposOutputSchema: z.ZodObject<{
     cachedAt: z.ZodString;
     fromCache: z.ZodBoolean;
 }, z.core.$strip>;
+/**
+ * Compact summary of an issue's first linked PR, surfaced on candidate
+ * outputs (#97 / scout 0.9.0). `isStalled` is `true` when the PR is open
+ * and has not been updated for `STALLED_PR_THRESHOLD_DAYS` (default 30) —
+ * a revive-opportunity signal callers can render or filter on.
+ *
+ * `state` mirrors autopilot's existing tri-state classifier (`'merged'` is
+ * folded in from scout's `merged: true` boolean), not scout's raw enum.
+ */
+export interface CandidateLinkedPR {
+    number: number;
+    state: 'open' | 'closed' | 'merged';
+    url: string;
+    /** ISO timestamp of the PR's last update (when scout surfaces it). */
+    updatedAt?: string;
+    /** True when the PR is open AND `updatedAt` is more than 30 days old. */
+    isStalled: boolean;
+}
+/**
+ * One candidate row in `SearchOutput`/`FeaturesOutput`. Extracted so the
+ * features command can reuse the exact contract `runSearch` already
+ * publishes — keeping the two outputs structurally identical for everything
+ * except the bucket-specific `horizon` annotation.
+ */
+export interface SearchCandidate {
+    issue: {
+        repo: string;
+        repoUrl: string;
+        number: number;
+        title: string;
+        url: string;
+        labels: string[];
+    };
+    recommendation: 'approve' | 'skip' | 'needs_review';
+    reasonsToApprove: string[];
+    reasonsToSkip: string[];
+    searchPriority: SearchPriority;
+    /** 0-100 scale composite viability score. Sanitized on the boundary (#1043): out-of-contract values are coerced to 0 and logged. */
+    viabilityScore: number;
+    /**
+     * Letter grade (A/B/C/F) computed from the autopilot-tracked repoScore.
+     * Scout's `search` does not emit per-candidate projectHealth, so scout-side
+     * signals are treated as unknown; unscored repos grade 'F'. See #1043.
+     */
+    grade: {
+        letter: 'A' | 'B' | 'C' | 'F';
+        reason: string;
+    };
+    repoScore?: {
+        /** 1-10 scale repository quality score */
+        score: number;
+        mergedPRCount: number;
+        closedWithoutMergeCount: number;
+        isResponsive: boolean;
+        lastMergedAt?: string;
+    };
+    /**
+     * First linked PR on the issue, when scout surfaced one. Optional —
+     * absent when no linked PR exists. `isStalled` flags revive
+     * opportunities (open PR + no updates for 30+ days, scout 0.9.0 #97).
+     */
+    linkedPR?: CandidateLinkedPR;
+}
 export interface SearchOutput {
-    candidates: Array<{
-        issue: {
-            repo: string;
-            repoUrl: string;
-            number: number;
-            title: string;
-            url: string;
-            labels: string[];
-        };
-        recommendation: 'approve' | 'skip' | 'needs_review';
-        reasonsToApprove: string[];
-        reasonsToSkip: string[];
-        searchPriority: SearchPriority;
-        /** 0-100 scale composite viability score. Sanitized on the boundary (#1043): out-of-contract values are coerced to 0 and logged. */
-        viabilityScore: number;
-        /**
-         * Letter grade (A/B/C/F) computed from the autopilot-tracked repoScore.
-         * Scout's `search` does not emit per-candidate projectHealth, so scout-side
-         * signals are treated as unknown; unscored repos grade 'F'. See #1043.
-         */
-        grade: {
-            letter: 'A' | 'B' | 'C' | 'F';
-            reason: string;
-        };
-        repoScore?: {
-            /** 1-10 scale repository quality score */
-            score: number;
-            mergedPRCount: number;
-            closedWithoutMergeCount: number;
-            isResponsive: boolean;
-            lastMergedAt?: string;
-        };
-    }>;
+    candidates: SearchCandidate[];
     excludedRepos: string[];
     /** Repos with known anti-AI contribution policies, filtered from search results (#108). */
     aiPolicyBlocklist: string[];
     /** Present when rate limits affected the search — either low pre-flight quota or mid-search rate limit hits (#100). */
     rateLimitWarning?: string;
 }
+/** Horizon classification stamped on each features-mode candidate. */
+export type FeaturesHorizon = 'quick-win' | 'bigger-bet';
+/** A `SearchCandidate` augmented with its features-mode horizon. */
+export type FeaturesCandidate = SearchCandidate & {
+    horizon: FeaturesHorizon;
+};
+export interface FeaturesOutput {
+    /** "Quick-win" bucket: feature-scoped issues without strong commitment markers (no milestone, no roadmap, no bigger-bet labels). */
+    quickWins: FeaturesCandidate[];
+    /** "Bigger-bet" bucket: feature-scoped issues that carry maintainer-commitment signals (milestone, roadmap, bigger-bet label). */
+    biggerBets: FeaturesCandidate[];
+    /** Repos that qualified as anchors for this run (3+ merged PRs, configurable). Empty when the user has no anchor repos yet. */
+    anchorRepos: string[];
+    /** Human-friendly explainer shown when neither bucket has results (no anchors, or anchors but no open feature opportunities). `null` on success. */
+    message: string | null;
+    /** Present when rate limits affected the search. Mirrors `SearchOutput.rateLimitWarning`. */
+    rateLimitWarning?: string;
+}
 export interface TrackOutput {
     pr: {
         repo: string;
@@ -886,8 +1166,14 @@ export interface CheckIntegrationOutput {
     newFiles: NewFileInfo[];
     unreferencedCount: number;
 }
-/** Status of a re-vetted issue from the curated list (#764). */
-export type VetListItemStatus = 'still_available' | 'claimed' | 'closed' | 'has_pr' | 'error';
+/**
+ * Status of a re-vetted issue from the curated list (#764).
+ *
+ * `has_stalled_pr` (scout 0.9.0 #97) distinguishes open-but-stalled linked
+ * PRs from cleanly-claimed `has_pr` issues — the issue is still actionable
+ * as a revive opportunity rather than something to drop.
+ */
+export type VetListItemStatus = 'still_available' | 'claimed' | 'closed' | 'has_pr' | 'has_stalled_pr' | 'error';
 /** Output of the vet-list command (#764). */
 export interface VetListOutput {
     results: Array<VetOutput & {
@@ -900,6 +1186,8 @@ export interface VetListOutput {
         claimed: number;
         closed: number;
         hasPR: number;
+        /** Open linked PRs that haven't been touched in 30+ days (scout 0.9.0 #97). Surfaced as revive opportunities, not auto-dropped. */
+        hasStalledPR: number;
         errors: number;
     };
     pruneResult?: {
@@ -937,6 +1225,12 @@ export interface VetOutput {
      * already has work in flight vs. a competing contributor.
      */
     linkedPRClassification?: 'none' | 'user_open' | 'user_closed' | 'user_merged' | 'other_open' | 'other_closed' | 'other_merged';
+    /**
+     * Compact linked-PR summary (#97 / scout 0.9.0). Present when the issue
+     * has a linked PR; absent otherwise. `isStalled` flags open PRs that
+     * haven't been touched in 30+ days as revive opportunities.
+     */
+    linkedPR?: CandidateLinkedPR;
     /**
      * Optional SLM pre-triage classification (#1122). Populated when the
      * user has set `slmTriageModel` and a local Ollama instance answered

package/dist/formatters/json.js

@@ -30,6 +30,7 @@ export function toCompactDailyOutput(output) {
         commentedIssues: output.commentedIssues,
         failureCount: output.failures.length,
         warnings: output.warnings,
+        strategySummary: output.strategySummary,
     };
 }
 /**
@@ -198,6 +199,65 @@ const CompactRepoGroupSchema = z.object({
 });
 // DailyWarning schemas were hoisted above StatusOutputSchema (#1193) so the
 // status output can reference them without `z.lazy()`.
+// Mirrors {@link StrategyResult} in core/strategy.ts. Kept passthrough on the
+// inner objects so additive shape changes there don't break Zod validation
+// before the schema catches up — drift on required keys still fails.
+const StrategyResultSchema = z
+    .object({
+    profile: z
+        .object({
+        style: z.enum(['maintainer', 'explorer', 'specialist', 'generalist']),
+        totalPRs: z.number().int().nonnegative(),
+        mergedCount: z.number().int().nonnegative(),
+        mergeRate: z.number(),
+        primaryLanguages: z.array(z.string()),
+        favoriteRepos: z.array(z.string()),
+    })
+        .passthrough(),
+    capacity: z
+        .object({
+        openPRCount: z.number().int().nonnegative(),
+        dormantPRCount: z.number().int().nonnegative(),
+        dormantRepoCount: z.number().int().nonnegative(),
+        overExtended: z.boolean(),
+        suggestedAction: z.union([
+            z.literal('open_more'),
+            z.literal('follow_up_dormant'),
+            z.literal('wait_on_maintainers'),
+            z.null(),
+        ]),
+    })
+        .passthrough(),
+    patterns: z
+        .object({
+        // Closed set on the six required PR-type buckets — drift on any
+        // of these breaks the snapshot rendering. `.passthrough()` allows
+        // additive growth (e.g., a future 'security' bucket) without a
+        // schema bump, but a typo on `features` → `feauters` fails here.
+        prTypeDistribution: z
+            .object({
+            docs: z.number(),
+            fixes: z.number(),
+            features: z.number(),
+            refactors: z.number(),
+            tests: z.number(),
+            other: z.number(),
+        })
+            .passthrough(),
+        trajectoryDirection: z.enum(['growing', 'steady', 'declining']),
+        averagePRSize: z.number(),
+    })
+        .passthrough(),
+    recommendations: z
+        .object({
+        languages: z.array(z.string()),
+        repos: z.array(z.string()),
+        issueTypes: z.array(z.string()),
+        avoidPatterns: z.array(z.string()),
+    })
+        .passthrough(),
+})
+    .passthrough();
 export const DailyOutputSchema = z.object({
     digest: DailyDigestCompactSchema,
     capacity: CapacityAssessmentSchema,
@@ -209,6 +269,7 @@ export const DailyOutputSchema = z.object({
     repoGroups: z.array(CompactRepoGroupSchema),
     failures: z.array(PRCheckFailurePassthroughSchema),
     warnings: z.array(DailyWarningSchema),
+    strategySummary: StrategyResultSchema.nullable().optional(),
 });
 export const CompactDailyOutputSchema = z.object({
     digest: DailyDigestCompactSchema,
@@ -219,9 +280,21 @@ export const CompactDailyOutputSchema = z.object({
     commentedIssues: z.array(CommentedIssuePassthroughSchema),
     failureCount: z.number().int().nonnegative(),
     warnings: z.array(DailyWarningSchema),
+    strategySummary: StrategyResultSchema.nullable().optional(),
 });
 // ── Search output schema (#1147) ─────────────────────────────────────
 const SearchPrioritySchema = z.enum(['merged_pr', 'preferred_org', 'starred', 'normal']);
+/**
+ * Schema for the compact linked-PR annotation surfaced on candidate
+ * outputs (#97 / scout 0.9.0). Mirrors {@link CandidateLinkedPR}.
+ */
+const CandidateLinkedPRSchema = z.object({
+    number: z.number().int().positive(),
+    state: z.enum(['open', 'closed', 'merged']),
+    url: z.string(),
+    updatedAt: z.string().optional(),
+    isStalled: z.boolean(),
+});
 const SearchCandidateSchema = z.object({
     issue: z.object({
         repo: z.string(),
@@ -249,6 +322,7 @@ const SearchCandidateSchema = z.object({
         lastMergedAt: z.string().optional(),
     })
         .optional(),
+    linkedPR: CandidateLinkedPRSchema.optional(),
 });
 export const SearchOutputSchema = z.object({
     candidates: z.array(SearchCandidateSchema),
@@ -256,6 +330,22 @@ export const SearchOutputSchema = z.object({
     aiPolicyBlocklist: z.array(z.string()),
     rateLimitWarning: z.string().optional(),
 });
+// ── Features output schema (scout 0.9.0 #97/#98/#99) ─────────────────
+//
+// `SearchCandidateSchema` augmented with the horizon literal that scout
+// stamps in features mode. Reusing the search candidate keeps the two
+// envelopes structurally identical apart from the bucket annotation.
+const FeaturesHorizonSchema = z.enum(['quick-win', 'bigger-bet']);
+const FeaturesCandidateSchema = SearchCandidateSchema.extend({
+    horizon: FeaturesHorizonSchema,
+});
+export const FeaturesOutputSchema = z.object({
+    quickWins: z.array(FeaturesCandidateSchema),
+    biggerBets: z.array(FeaturesCandidateSchema),
+    anchorRepos: z.array(z.string()),
+    message: z.string().nullable(),
+    rateLimitWarning: z.string().optional(),
+});
 // ── Doctor / skip-add / list-move-tier output schemas (#1148) ────────
 const DoctorCheckSchema = z.object({
     name: z.string(),
@@ -287,6 +377,18 @@ export const ListMoveTierOutputSchema = z.object({
     count: z.number().int().nonnegative(),
     reason: z.string().optional(),
 });
+// list-mark-done (#1299): mirrors {@link MarkDoneOutput} from the command
+// module. Strict shape — additional keys must be added here AND in the
+// command output, otherwise the validator's `parse()` rejects the response
+// before it reaches consumers.
+export const ListMarkDoneOutputSchema = z.object({
+    marked: z.boolean(),
+    filePath: z.string(),
+    url: z.string(),
+    repoHeadingStruck: z.boolean(),
+    remainingUnderRepo: z.number().int().nonnegative(),
+    reason: z.string().optional(),
+});
 // ── #1155: Zod coverage for remaining CLI commands ───────────────────
 export const PostOutputSchema = z.object({
     commentUrl: z.string(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oss-autopilot/core",
-  "version": "3.5.0",
+  "version": "3.7.0",
   "description": "CLI and core library for managing open source contributions",
   "type": "module",
   "bin": {
@@ -54,7 +54,7 @@
   "dependencies": {
     "@octokit/plugin-throttling": "^11.0.3",
     "@octokit/rest": "^22.0.1",
-    "@oss-scout/core": "^0.8.0",
+    "@oss-scout/core": "^0.9.0",
     "commander": "^14.0.3",
     "zod": "^4.4.3"
   },