@oss-autopilot/core 3.8.0 → 3.9.0

package/dist/commands/index.d.ts

@@ -21,6 +21,8 @@ export { executeDailyCheck } from './daily.js';
 export { runStartup } from './startup.js';
 /** Return contribution statistics (merge rate, PR counts, repo breakdown) from local state. */
 export { runStatus } from './status.js';
+/** On-demand strategy snapshot via the typed `computeStrategy` core function (#1243 step 4). */
+export { runStrategy } from './strategy.js';
 /** Search GitHub for contributable issues using multi-strategy discovery. */
 export { runSearch, MAX_SEARCH_RESULTS } from './search.js';
 /** Surface feature-scoped opportunities in repos with 3+ merged PRs (scout 0.9.0). */

package/dist/commands/index.js

@@ -22,6 +22,8 @@ export { executeDailyCheck } from './daily.js';
 export { runStartup } from './startup.js';
 /** Return contribution statistics (merge rate, PR counts, repo breakdown) from local state. */
 export { runStatus } from './status.js';
+/** On-demand strategy snapshot via the typed `computeStrategy` core function (#1243 step 4). */
+export { runStrategy } from './strategy.js';
 /** Search GitHub for contributable issues using multi-strategy discovery. */
 export { runSearch, MAX_SEARCH_RESULTS } from './search.js';
 /** Surface feature-scoped opportunities in repos with 3+ merged PRs (scout 0.9.0). */

package/dist/commands/strategy.d.ts

@@ -0,0 +1,31 @@
+/**
+ * strategy command (#1243 step 4).
+ *
+ * Runs the typed `computeStrategy` core function against local state on
+ * demand. The daily auto-display already emits `strategySummary` under
+ * a cadence gate; this command is the *ungated* path used by the
+ * `contribution-strategist` agent so a user asking "how am I doing?"
+ * always gets an answer (or a clear "not enough data yet" message) even
+ * when the daily cadence has not fired.
+ *
+ * Read-only: no API calls, no state mutation.
+ */
+import { type StrategyResult } from '../core/strategy.js';
+/**
+ * On-demand strategy snapshot. Mirrors `StrategyOutputSchema` in
+ * `formatters/json.ts` structurally — that schema uses `.passthrough()`
+ * for forward compatibility on the JSON-validation surface, so its
+ * inferred type carries an extra `unknown` index signature that does
+ * not match `StrategyResult`. The command's TypeScript shape is the
+ * exact structural form below.
+ */
+export interface StrategyCommandOutput {
+    strategy: StrategyResult | null;
+    message?: string;
+}
+/**
+ * Compute the on-demand strategy snapshot. Returns `{ strategy: null,
+ * message }` when state is below the merged-PR floor, and `{ strategy }`
+ * with the full typed result otherwise.
+ */
+export declare function runStrategy(): Promise<StrategyCommandOutput>;

package/dist/commands/strategy.js

@@ -0,0 +1,33 @@
+/**
+ * strategy command (#1243 step 4).
+ *
+ * Runs the typed `computeStrategy` core function against local state on
+ * demand. The daily auto-display already emits `strategySummary` under
+ * a cadence gate; this command is the *ungated* path used by the
+ * `contribution-strategist` agent so a user asking "how am I doing?"
+ * always gets an answer (or a clear "not enough data yet" message) even
+ * when the daily cadence has not fired.
+ *
+ * Read-only: no API calls, no state mutation.
+ */
+import { getStateManager } from '../core/index.js';
+import { computeStrategy, STRATEGY_MIN_PRS } from '../core/strategy.js';
+/**
+ * Compute the on-demand strategy snapshot. Returns `{ strategy: null,
+ * message }` when state is below the merged-PR floor, and `{ strategy }`
+ * with the full typed result otherwise.
+ */
+export async function runStrategy() {
+    const stateManager = getStateManager();
+    const state = stateManager.getState();
+    const strategy = computeStrategy(state);
+    if (strategy === null) {
+        const merged = state.mergedPRs?.length ?? 0;
+        return {
+            strategy: null,
+            message: `Strategy snapshot needs at least ${STRATEGY_MIN_PRS} merged PRs in local state; ` +
+                `currently tracking ${merged}. Keep contributing and the snapshot becomes available automatically.`,
+        };
+    }
+    return { strategy };
+}

package/dist/formatters/json.d.ts

@@ -184,6 +184,106 @@ export declare const StatusOutputSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type StatusOutput = z.infer<typeof StatusOutputSchema>;
+export declare const StrategyResultSchema: 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>;
+/**
+ * On-demand strategy snapshot output (#1243 step 4). Wraps the same
+ * `StrategyResult` shape consumed by the daily auto-display, but is
+ * always available — the cadence gate only governs the auto-display,
+ * not direct CLI/MCP calls. `strategy` is null when the minimum-data
+ * gate fails (fewer than `STRATEGY_MIN_PRS` merged PRs); `message`
+ * carries the human-readable explanation in that case.
+ */
+export declare const StrategyOutputSchema: z.ZodObject<{
+    strategy: 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>>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StrategyCommandOutput = z.infer<typeof StrategyOutputSchema>;
 export declare const DailyOutputSchema: z.ZodObject<{
     digest: z.ZodObject<{
         generatedAt: z.ZodString;

package/dist/formatters/json.js

@@ -202,7 +202,7 @@ const CompactRepoGroupSchema = z.object({
 // 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
+export const StrategyResultSchema = z
     .object({
     profile: z
         .object({
@@ -258,6 +258,18 @@ const StrategyResultSchema = z
         .passthrough(),
 })
     .passthrough();
+/**
+ * On-demand strategy snapshot output (#1243 step 4). Wraps the same
+ * `StrategyResult` shape consumed by the daily auto-display, but is
+ * always available — the cadence gate only governs the auto-display,
+ * not direct CLI/MCP calls. `strategy` is null when the minimum-data
+ * gate fails (fewer than `STRATEGY_MIN_PRS` merged PRs); `message`
+ * carries the human-readable explanation in that case.
+ */
+export const StrategyOutputSchema = z.object({
+    strategy: StrategyResultSchema.nullable(),
+    message: z.string().optional(),
+});
 export const DailyOutputSchema = z.object({
     digest: DailyDigestCompactSchema,
     capacity: CapacityAssessmentSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oss-autopilot/core",
-  "version": "3.8.0",
+  "version": "3.9.0",
   "description": "CLI and core library for managing open source contributions",
   "type": "module",
   "bin": {
@@ -59,13 +59,13 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^25.6.0",
-    "@vitest/coverage-v8": "^4.1.5",
+    "@types/node": "^25.7.0",
+    "@vitest/coverage-v8": "^4.1.6",
     "esbuild": "^0.28.0",
     "tsx": "^4.21.0",
     "typedoc": "^0.28.19",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.6"
   },
   "scripts": {
     "build": "tsc",