@oss-autopilot/core 1.9.0 → 1.11.0

package/dist/core/state-schema.d.ts

@@ -32,13 +32,11 @@ export declare const IssueScopeSchema: z.ZodEnum<{
     beginner: "beginner";
     intermediate: "intermediate";
 }>;
-export declare const StateEventTypeSchema: z.ZodEnum<{
-    pr_tracked: "pr_tracked";
-    pr_merged: "pr_merged";
-    pr_closed: "pr_closed";
-    pr_dormant: "pr_dormant";
-    daily_check: "daily_check";
-    comment_posted: "comment_posted";
+export declare const DiffToolSchema: z.ZodEnum<{
+    inline: "inline";
+    custom: "custom";
+    sourcetree: "sourcetree";
+    vscode: "vscode";
 }>;
 export declare const RepoSignalsSchema: z.ZodObject<{
     hasActiveMaintainers: z.ZodBoolean;
@@ -61,28 +59,22 @@ export declare const RepoScoreSchema: z.ZodObject<{
     stargazersCount: z.ZodOptional<z.ZodNumber>;
     language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
-export declare const StateEventSchema: z.ZodObject<{
-    id: z.ZodString;
-    type: z.ZodEnum<{
-        pr_tracked: "pr_tracked";
-        pr_merged: "pr_merged";
-        pr_closed: "pr_closed";
-        pr_dormant: "pr_dormant";
-        daily_check: "daily_check";
-        comment_posted: "comment_posted";
-    }>;
-    at: z.ZodString;
-    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-}, z.core.$strip>;
 export declare const StoredMergedPRSchema: z.ZodObject<{
     url: z.ZodString;
     title: z.ZodString;
     mergedAt: z.ZodString;
+    learningsExtractedAt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const StoredClosedPRSchema: z.ZodObject<{
     url: z.ZodString;
     title: z.ZodString;
     closedAt: z.ZodString;
+    learningsExtractedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const AnalyzedIssueConversationSchema: z.ZodObject<{
+    url: z.ZodString;
+    repo: z.ZodString;
+    analyzedAt: z.ZodString;
 }, z.core.$strip>;
 export declare const ContributionGuidelinesSchema: z.ZodObject<{
     branchNamingConvention: z.ZodOptional<z.ZodString>;
@@ -193,6 +185,10 @@ export declare const StatusOverrideSchema: z.ZodObject<{
 export declare const AgentConfigSchema: z.ZodObject<{
     setupComplete: z.ZodDefault<z.ZodBoolean>;
     setupCompletedAt: z.ZodOptional<z.ZodString>;
+    persistence: z.ZodDefault<z.ZodEnum<{
+        local: "local";
+        gist: "gist";
+    }>>;
     maxActivePRs: z.ZodDefault<z.ZodNumber>;
     dormantThresholdDays: z.ZodDefault<z.ZodNumber>;
     approachingDormantDays: z.ZodDefault<z.ZodNumber>;
@@ -209,10 +205,8 @@ export declare const AgentConfigSchema: z.ZodObject<{
     trustedProjects: z.ZodDefault<z.ZodArray<z.ZodString>>;
     githubUsername: z.ZodDefault<z.ZodString>;
     minRepoScoreThreshold: z.ZodDefault<z.ZodNumber>;
-    scoreThreshold: z.ZodDefault<z.ZodNumber>;
     starredRepos: z.ZodDefault<z.ZodArray<z.ZodString>>;
     starredReposLastFetched: z.ZodOptional<z.ZodString>;
-    showHealthCheck: z.ZodOptional<z.ZodBoolean>;
     squashByDefault: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"ask">]>>;
     localRepoScanPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
     minStars: z.ZodDefault<z.ZodNumber>;
@@ -239,6 +233,13 @@ export declare const AgentConfigSchema: z.ZodObject<{
         education: "education";
     }>>>;
     preferredOrgs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    diffTool: z.ZodDefault<z.ZodEnum<{
+        inline: "inline";
+        custom: "custom";
+        sourcetree: "sourcetree";
+        vscode: "vscode";
+    }>>;
+    diffToolCustomCommand: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const LocalRepoCacheSchema: z.ZodObject<{
     repos: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -320,7 +321,8 @@ export declare const DailyDigestSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const AgentStateSchema: z.ZodObject<{
-    version: z.ZodLiteral<2>;
+    version: z.ZodLiteral<3>;
+    gistId: z.ZodOptional<z.ZodString>;
     repoScores: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         repo: z.ZodString;
         score: z.ZodNumber;
@@ -340,6 +342,10 @@ export declare const AgentStateSchema: z.ZodObject<{
     config: z.ZodDefault<z.ZodObject<{
         setupComplete: z.ZodDefault<z.ZodBoolean>;
         setupCompletedAt: z.ZodOptional<z.ZodString>;
+        persistence: z.ZodDefault<z.ZodEnum<{
+            local: "local";
+            gist: "gist";
+        }>>;
         maxActivePRs: z.ZodDefault<z.ZodNumber>;
         dormantThresholdDays: z.ZodDefault<z.ZodNumber>;
         approachingDormantDays: z.ZodDefault<z.ZodNumber>;
@@ -356,10 +362,8 @@ export declare const AgentStateSchema: z.ZodObject<{
         trustedProjects: z.ZodDefault<z.ZodArray<z.ZodString>>;
         githubUsername: z.ZodDefault<z.ZodString>;
         minRepoScoreThreshold: z.ZodDefault<z.ZodNumber>;
-        scoreThreshold: z.ZodDefault<z.ZodNumber>;
         starredRepos: z.ZodDefault<z.ZodArray<z.ZodString>>;
         starredReposLastFetched: z.ZodOptional<z.ZodString>;
-        showHealthCheck: z.ZodOptional<z.ZodBoolean>;
         squashByDefault: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"ask">]>>;
         localRepoScanPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
         minStars: z.ZodDefault<z.ZodNumber>;
@@ -386,20 +390,14 @@ export declare const AgentStateSchema: z.ZodObject<{
             education: "education";
         }>>>;
         preferredOrgs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        diffTool: z.ZodDefault<z.ZodEnum<{
+            inline: "inline";
+            custom: "custom";
+            sourcetree: "sourcetree";
+            vscode: "vscode";
+        }>>;
+        diffToolCustomCommand: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
-    events: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        type: z.ZodEnum<{
-            pr_tracked: "pr_tracked";
-            pr_merged: "pr_merged";
-            pr_closed: "pr_closed";
-            pr_dormant: "pr_dormant";
-            daily_check: "daily_check";
-            comment_posted: "comment_posted";
-        }>;
-        at: z.ZodString;
-        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    }, z.core.$strip>>>;
     lastRunAt: z.ZodDefault<z.ZodString>;
     lastDigestAt: z.ZodOptional<z.ZodString>;
     lastDigest: z.ZodOptional<z.ZodObject<{
@@ -454,7 +452,6 @@ export declare const AgentStateSchema: z.ZodObject<{
     monthlyMergedCounts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     monthlyClosedCounts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     monthlyOpenedCounts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-    dailyActivityCounts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     localRepoCache: z.ZodOptional<z.ZodObject<{
         repos: z.ZodRecord<z.ZodString, z.ZodObject<{
             path: z.ZodString;
@@ -468,11 +465,18 @@ export declare const AgentStateSchema: z.ZodObject<{
         url: z.ZodString;
         title: z.ZodString;
         mergedAt: z.ZodString;
+        learningsExtractedAt: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     closedPRs: z.ZodOptional<z.ZodArray<z.ZodObject<{
         url: z.ZodString;
         title: z.ZodString;
         closedAt: z.ZodString;
+        learningsExtractedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    analyzedIssueConversations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        repo: z.ZodString;
+        analyzedAt: z.ZodString;
     }, z.core.$strip>>>;
     activeIssues: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodNumber;
@@ -523,12 +527,12 @@ export type IssueStatus = z.infer<typeof IssueStatusSchema>;
 export type FetchedPRStatus = z.infer<typeof FetchedPRStatusSchema>;
 export type ProjectCategory = z.infer<typeof ProjectCategorySchema>;
 export type IssueScope = z.infer<typeof IssueScopeSchema>;
-export type StateEventType = z.infer<typeof StateEventTypeSchema>;
+export type DiffTool = z.infer<typeof DiffToolSchema>;
 export type RepoSignals = z.infer<typeof RepoSignalsSchema>;
 export type RepoScore = z.infer<typeof RepoScoreSchema>;
-export type StateEvent = z.infer<typeof StateEventSchema>;
 export type StoredMergedPR = z.infer<typeof StoredMergedPRSchema>;
 export type StoredClosedPR = z.infer<typeof StoredClosedPRSchema>;
+export type AnalyzedIssueConversation = z.infer<typeof AnalyzedIssueConversationSchema>;
 export type ContributionGuidelines = z.infer<typeof ContributionGuidelinesSchema>;
 export type IssueVettingResult = z.infer<typeof IssueVettingResultSchema>;
 export type TrackedIssue = z.infer<typeof TrackedIssueSchema>;

package/dist/core/state-schema.js

@@ -21,14 +21,7 @@ export const ProjectCategorySchema = z.enum([
     'education',
 ]);
 export const IssueScopeSchema = z.enum(['beginner', 'intermediate', 'advanced']);
-export const StateEventTypeSchema = z.enum([
-    'pr_tracked',
-    'pr_merged',
-    'pr_closed',
-    'pr_dormant',
-    'daily_check',
-    'comment_posted',
-]);
+export const DiffToolSchema = z.enum(['inline', 'sourcetree', 'vscode', 'custom']);
 // ── 2. Leaf schemas ──────────────────────────────────────────────────
 export const RepoSignalsSchema = z.object({
     hasActiveMaintainers: z.boolean(),
@@ -47,21 +40,22 @@ export const RepoScoreSchema = z.object({
     stargazersCount: z.number().optional(),
     language: z.string().nullable().optional(),
 });
-export const StateEventSchema = z.object({
-    id: z.string(),
-    type: StateEventTypeSchema,
-    at: z.string(),
-    data: z.record(z.string(), z.unknown()),
-});
 export const StoredMergedPRSchema = z.object({
     url: z.string(),
     title: z.string(),
     mergedAt: z.string(),
+    learningsExtractedAt: z.string().optional(),
 });
 export const StoredClosedPRSchema = z.object({
     url: z.string(),
     title: z.string(),
     closedAt: z.string(),
+    learningsExtractedAt: z.string().optional(),
+});
+export const AnalyzedIssueConversationSchema = z.object({
+    url: z.string(),
+    repo: z.string(),
+    analyzedAt: z.string(),
 });
 // ── 3. Contribution schemas ──────────────────────────────────────────
 export const ContributionGuidelinesSchema = z.object({
@@ -123,6 +117,7 @@ export const StatusOverrideSchema = z.object({
 export const AgentConfigSchema = z.object({
     setupComplete: z.boolean().default(false),
     setupCompletedAt: z.string().optional(),
+    persistence: z.enum(['local', 'gist']).default('local'),
     maxActivePRs: z.number().default(10),
     dormantThresholdDays: z.number().default(30),
     approachingDormantDays: z.number().default(25),
@@ -135,10 +130,8 @@ export const AgentConfigSchema = z.object({
     trustedProjects: z.array(z.string()).default([]),
     githubUsername: z.string().default(''),
     minRepoScoreThreshold: z.number().default(4),
-    scoreThreshold: z.number().int().min(1).max(10).default(6),
     starredRepos: z.array(z.string()).default([]),
     starredReposLastFetched: z.string().optional(),
-    showHealthCheck: z.boolean().optional(),
     squashByDefault: z.union([z.boolean(), z.literal('ask')]).default(true),
     localRepoScanPaths: z.array(z.string()).optional(),
     minStars: z.number().default(50),
@@ -151,6 +144,8 @@ export const AgentConfigSchema = z.object({
     skippedIssuesPath: z.string().optional(),
     projectCategories: z.array(ProjectCategorySchema).default([]),
     preferredOrgs: z.array(z.string()).default([]),
+    diffTool: DiffToolSchema.default('inline'),
+    diffToolCustomCommand: z.string().optional(),
 });
 // ── 6. Cache schemas ─────────────────────────────────────────────────
 export const LocalRepoCacheSchema = z.object({
@@ -198,19 +193,19 @@ export const DailyDigestSchema = z.object({
 });
 // ── 8. Root schema ───────────────────────────────────────────────────
 export const AgentStateSchema = z.object({
-    version: z.literal(2),
+    version: z.literal(3),
+    gistId: z.string().optional(),
     repoScores: z.record(z.string(), RepoScoreSchema).default({}),
     config: AgentConfigSchema.default(() => AgentConfigSchema.parse({})),
-    events: z.array(StateEventSchema).default([]),
     lastRunAt: z.string().default(() => new Date().toISOString()),
     lastDigestAt: z.string().optional(),
     lastDigest: DailyDigestSchema.optional(),
     monthlyMergedCounts: z.record(z.string(), z.number()).optional(),
     monthlyClosedCounts: z.record(z.string(), z.number()).optional(),
     monthlyOpenedCounts: z.record(z.string(), z.number()).optional(),
-    dailyActivityCounts: z.record(z.string(), z.number()).optional(),
     localRepoCache: LocalRepoCacheSchema.optional(),
     mergedPRs: z.array(StoredMergedPRSchema).optional(),
     closedPRs: z.array(StoredClosedPRSchema).optional(),
+    analyzedIssueConversations: z.array(AnalyzedIssueConversationSchema).optional(),
     activeIssues: z.array(TrackedIssueSchema).default([]),
 });

package/dist/core/state.d.ts

@@ -3,23 +3,26 @@
  * Thin coordinator that delegates persistence to state-persistence.ts
  * and scoring logic to repo-score-manager.ts.
  */
-import { AgentState, TrackedIssue, RepoScore, RepoScoreUpdate, StateEvent, StateEventType, DailyDigest, LocalRepoCache, StatusOverride, FetchedPRStatus, StoredMergedPR, StoredClosedPR } from './types.js';
+import { AgentState, TrackedIssue, RepoScore, RepoScoreUpdate, DailyDigest, LocalRepoCache, StatusOverride, FetchedPRStatus, StoredMergedPR, StoredClosedPR } from './types.js';
 import type { Stats } from './repo-score-manager.js';
+import { GistStateStore } from './gist-state-store.js';
 export { acquireLock, releaseLock, atomicWriteFileSync } from './state-persistence.js';
 export type { Stats } from './repo-score-manager.js';
 /**
  * Singleton manager for persistent agent state stored in ~/.oss-autopilot/state.json.
  *
  * Delegates file I/O to state-persistence.ts and scoring logic to repo-score-manager.ts.
- * Retains lightweight CRUD operations for config, events, issues, shelving, dismissal,
+ * Retains lightweight CRUD operations for config, issues, shelving, dismissal,
  * and status overrides.
  */
 export declare class StateManager {
-    private state;
-    private readonly inMemoryOnly;
+    protected state: AgentState;
+    protected inMemoryOnly: boolean;
     private lastLoadedMtimeMs;
     private _batching;
     private _batchDirty;
+    protected gistStore: GistStateStore | null;
+    protected gistDegraded: boolean;
     /**
      * Create a new StateManager instance.
      * @param inMemoryOnly - When true, state is held only in memory and never read from or
@@ -27,6 +30,15 @@ export declare class StateManager {
      *   Defaults to false (normal persistent mode).
      */
     constructor(inMemoryOnly?: boolean);
+    /**
+     * Async factory that creates a StateManager backed by a GitHub Gist.
+     *
+     * The regular constructor is synchronous (for backwards-compat), but Gist
+     * bootstrapping requires network calls, so this factory is async.
+     *
+     * @param token - GitHub personal access token with `gist` scope
+     */
+    static createWithGist(token: string): Promise<StateManager>;
     /**
      * Attempt PR count reconciliation, logging a warning on failure.
      * Called after every state load from disk.
@@ -58,8 +70,17 @@ export declare class StateManager {
     /**
      * Persist the current state to disk, creating a timestamped backup of the previous
      * state file first. In in-memory mode, only updates `lastRunAt` without any file I/O.
+     *
+     * In Gist mode, writes to a local cache file (not the main state file) so the Gist
+     * remains the source of truth. Use `checkpoint()` to push state to the Gist.
      */
     save(): void;
+    /** Push current state to Gist (async). Call at well-defined moments (end of daily, after claim). */
+    checkpoint(): Promise<boolean>;
+    /** Whether this StateManager is backed by a Gist. */
+    isGistMode(): boolean;
+    /** Whether the Gist is in degraded mode (using local cache fallback). */
+    isGistDegraded(): boolean;
     /**
      * Get the current state as a read-only snapshot.
      */
@@ -69,6 +90,11 @@ export declare class StateManager {
      * Returns true if state was reloaded, false if unchanged or in-memory mode.
      */
     reloadIfChanged(): boolean;
+    /**
+     * Re-fetch state from the backing Gist (if in Gist mode).
+     * Throttled to once per 30 seconds by GistStateStore. Returns true if state was refreshed.
+     */
+    refreshFromGist(): Promise<boolean>;
     /**
      * Store the latest daily digest and update the digest timestamp.
      * @param digest - The daily digest to store
@@ -89,11 +115,6 @@ export declare class StateManager {
      * @param counts - Monthly opened PR counts keyed by YYYY-MM
      */
     setMonthlyOpenedCounts(counts: Record<string, number>): void;
-    /**
-     * Update daily activity counts for dashboard display.
-     * @param counts - Daily activity counts keyed by YYYY-MM-DD
-     */
-    setDailyActivityCounts(counts: Record<string, number>): void;
     /**
      * Update the local repository cache.
      * @param cache - Local repository cache mapping repo names to paths
@@ -122,26 +143,6 @@ export declare class StateManager {
      * @param config - Partial config object to merge
      */
     updateConfig(config: Partial<AgentState['config']>): void;
-    /**
-     * Append a new event to the event log and auto-persist.
-     * Events are capped at 1000 to prevent unbounded growth.
-     * @param type - The event type identifier
-     * @param data - Arbitrary event payload
-     */
-    appendEvent(type: StateEventType, data: Record<string, unknown>): void;
-    /**
-     * Filter events by type.
-     * @param type - The event type to filter by
-     * @returns Events matching the given type
-     */
-    getEventsByType(type: StateEventType): StateEvent[];
-    /**
-     * Filter events within a date range.
-     * @param since - Start of range (inclusive)
-     * @param until - End of range (inclusive), defaults to now
-     * @returns Events within the date range
-     */
-    getEventsInRange(since: Date, until?: Date): StateEvent[];
     /**
      * Track a new issue. No-op if the issue URL is already tracked.
      * @param issue - The issue to track
@@ -287,6 +288,19 @@ export declare class StateManager {
  * ```
  */
 export declare function getStateManager(): StateManager;
+/**
+ * Get or create a StateManager with Gist-backed persistence.
+ * If a StateManager already exists (from sync init), returns it.
+ * If a token is provided and no manager exists, creates one with Gist backing.
+ * Falls back to sync initialization if no token is provided.
+ *
+ * **Important:** This must be called (and awaited) before any command runs for
+ * Gist mode to be active. It pre-sets the singleton so that subsequent
+ * `getStateManager()` calls return the Gist-backed instance. If this is not
+ * called first, `getStateManager()` will lazily create a local-only
+ * StateManager and Gist checkpoints will be no-ops.
+ */
+export declare function getStateManagerAsync(token?: string): Promise<StateManager>;
 /**
  * Reset the singleton StateManager instance to null. Intended for test isolation.
  */