Variable INITIAL_STATEConst

Type Declaration

• activeIssues: {
      createdAt: string;
      id: number;
      labels: string[];
      number: number;
      repo: string;
      status: "candidate" | "claimed" | "in_progress" | "pr_submitted";
      title: string;
      updatedAt: string;
      url: string;
      vetted: boolean;
      vettingResult?: {
          checks: {
              clearRequirements: boolean;
              contributionGuidelinesFound: boolean;
              noExistingPR: boolean;
              notClaimed: boolean;
              projectActive: boolean;
          };
          contributionGuidelines?: {
              branchNamingConvention?: string;
              claRequired?: boolean;
              commitMessageFormat?: string;
              formatter?: string;
              issueClaimProcess?: string;
              linter?: string;
              prTitleFormat?: string;
              rawContent?: string;
              requiredChecks?: string[];
              reviewProcess?: string;
              styleGuideUrl?: string;
              testCoverageRequired?: boolean;
              testFileNaming?: string;
              testFramework?: string;
          };
          notes: string[];
          passedAllChecks: boolean;
      };
  }[]

• OptionalanalyzedIssueConversations?: { analyzedAt: string; repo: string; url: string }[]

• OptionalclosedPRs?: {
      closedAt: string;
      commentsFetchedAt?: string;
      firstMaintainerResponseAt?: string;
      learningsExtractedAt?: string;
      openedAt?: string;
      title: string;
      url: string;
  }[]

• config: {
      aiPolicyBlocklist: string[];
      approachingDormantDays: number;
      autoExtractLearnings: boolean;
      autoFormatBeforePush: boolean;
      avoidRepos: string[];
      boostIssueTypes: string[];
      diffTool: "inline" | "custom" | "sourcetree" | "vscode";
      diffToolCustomCommand?: string;
      dismissedIssues: Record<string, string>;
      dormantThresholdDays: number;
      excludeOrgs?: string[];
      excludeRepos: string[];
      githubUsername: string;
      healthCheckFreshnessMinutes: number;
      includeDocIssues: boolean;
      issueListPath?: string;
      labels: string[];
      languages: string[];
      localRepoScanPaths?: string[];
      maxActivePRs: number;
      maxIssueAgeDays: number;
      minRepoScoreThreshold: number;
      minStars: number;
      persistence: "local" | "gist";
      preferredOrgs: string[];
      projectCategories: (
          | "nonprofit"
          | "devtools"
          | "infrastructure"
          | "web-frameworks"
          | "data-ml"
          | "education"
      )[];
      reviewMaxPasses?: number;
      scope?: ("advanced" | "beginner" | "intermediate")[];
      setupComplete: boolean;
      setupCompletedAt?: string;
      shelvedPRUrls: string[];
      skipBroadWhenSufficientResults: number;
      skippedIssuesPath?: string;
      slmTriageHost: string;
      slmTriageModel: string;
      squashByDefault: boolean | "ask";
      starredRepos: string[];
      starredReposLastFetched?: string;
      statusOverrides?: Record<
          string,
          {
              lastActivityAt: string;
              setAt: string;
              status: "needs_addressing"
              | "waiting_on_maintainer";
          },
      >;
      trustedProjects: string[];
      trustOwnRepoWrites: boolean;
  }

  • aiPolicyBlocklist: string[]

  • approachingDormantDays: number

  • autoExtractLearnings: boolean

    Extract per-repo learnings from freshly merged PRs automatically at /oss startup and in /oss-overnight (#1696). When false, daily offers the extraction as an extract_learnings action-menu item instead.

  • autoFormatBeforePush: boolean

    No effect since the hook was removed in #1642; kept for state-file compatibility.

  • avoidRepos: string[]

    Repos (owner/repo) to softly downrank in discovery results (#1464). Milder than excludeRepos' hard filter: scout pushes matches below equally-recommended candidates but does not remove them, and a strong affinity boost can still outweigh the penalty (scout #168). Threaded to scout via scout-bridge.ts.

  • boostIssueTypes: string[]

    Issue label types (e.g. "bug", "good first issue") to softly boost in discovery ranking, matched case-insensitively against issue labels (scout #168 / #1464). Does not filter results or change viability scores. Threaded to scout via scout-bridge.ts.

  • diffTool: "inline" | "custom" | "sourcetree" | "vscode"

  • OptionaldiffToolCustomCommand?: string

  • dismissedIssues: Record<string, string>

  • dormantThresholdDays: number

  • OptionalexcludeOrgs?: string[]

  • excludeRepos: string[]

  • githubUsername: string

  • healthCheckFreshnessMinutes: number

    No effect since the hook was removed in #1642; kept for state-file compatibility.

  • includeDocIssues: boolean

  • OptionalissueListPath?: string

  • labels: string[]

  • languages: string[]

  • OptionallocalRepoScanPaths?: string[]

  • maxActivePRs: number

  • maxIssueAgeDays: number

  • minRepoScoreThreshold: number

  • minStars: number

  • persistence: "local" | "gist"

  • preferredOrgs: string[]

  • projectCategories: (
        | "nonprofit"
        | "devtools"
        | "infrastructure"
        | "web-frameworks"
        | "data-ml"
        | "education"
    )[]

  • OptionalreviewMaxPasses?: number

    Convergence cap for the multi-agent review loop in workflows/dispatch-review.md (#1275). When unset, the workflow falls back to per-mode defaults (5 for diff, 3 for plan). Lower values shorten the loop at the cost of skipping later iterations if findings persist; higher values give the loop more chances to converge before bailing. Optional — leave unset to use the defaults.

  • Optionalscope?: ("advanced" | "beginner" | "intermediate")[]

  • setupComplete: boolean

  • OptionalsetupCompletedAt?: string

  • shelvedPRUrls: string[]

  • skipBroadWhenSufficientResults: number

  • OptionalskippedIssuesPath?: string

  • slmTriageHost: string

    Optional Ollama HTTP host override. Defaults to http://127.0.0.1:11434 when empty. Useful when Ollama runs on a different machine on the local network.

  • slmTriageModel: string

    Optional Ollama model for SLM pre-triage during issue vetting (#1122). Empty disables the feature. Recommended: gemma4:e4b (default for capable hardware), gemma4:e2b or qwen3:1.7b for low-RAM machines. Threaded through to scout via the bridge in scout-bridge.ts.

  • squashByDefault: boolean | "ask"

  • starredRepos: string[]

  • OptionalstarredReposLastFetched?: string

  • OptionalstatusOverrides?: Record<
        string,
        {
            lastActivityAt: string;
            setAt: string;
            status: "needs_addressing"
            | "waiting_on_maintainer";
        },
    >

  • trustedProjects: string[]

  • trustOwnRepoWrites: boolean

    No effect since the hook was removed in #1642; kept for state-file compatibility.

• OptionalgistId?: string

• OptionallastDigest?: {
      autoUnshelvedPRs: {
          daysSinceActivity: number;
          number: number;
          repo: string;
          status: "needs_addressing" | "waiting_on_maintainer";
          title: string;
          url: string;
      }[];
      generatedAt: string;
      needsAddressingPRs: FetchedPR[];
      openPRs: FetchedPR[];
      recentlyClosedPRs: {
          closedAt: string;
          closedBy?: string;
          number: number;
          openedAt?: string;
          repo: string;
          title: string;
          url: string;
      }[];
      recentlyMergedPRs: {
          mergedAt: string;
          number: number;
          openedAt?: string;
          repo: string;
          title: string;
          url: string;
      }[];
      shelvedPRs: {
          daysSinceActivity: number;
          number: number;
          repo: string;
          status: "needs_addressing"
          | "waiting_on_maintainer";
          title: string;
          url: string;
      }[];
      summary: {
          mergeRate: number;
          totalActivePRs: number;
          totalMergedAllTime: number;
          totalNeedingAttention: number;
      };
      waitingOnMaintainerPRs: FetchedPR[];
  }

• OptionallastDigestAt?: string

• OptionallastOvernight?: {
      implementAttempts?: {
          attemptedAt: string;
          note?: string;
          outcome: "blocked" | "prepared";
          url: string;
      }[];
      implementUrl?: string;
      judgmentCount: number;
      prepareCount: number;
      prepared: {
          branch: string;
          compareUrl?: string;
          note?: string;
          pushedAt?: string;
          pushedRef?: string;
          pushProblem?: string;
          recordedAt: string;
          url: string;
          worktree?: string;
      }[];
      reportPath: string;
      runAt: string;
  }

  Latest overnight run (#1574). Absent until the first overnight.

  • OptionalimplementAttempts?: {
        attemptedAt: string;
        note?: string;
        outcome: "blocked" | "prepared";
        url: string;
    }[]

  • OptionalimplementUrl?: string

    The one curated-list issue picked for implementation this run, if any (#1715).

  • judgmentCount: number

  • prepareCount: number

  • prepared: {
        branch: string;
        compareUrl?: string;
        note?: string;
        pushedAt?: string;
        pushedRef?: string;
        pushProblem?: string;
        recordedAt: string;
        url: string;
        worktree?: string;
    }[]

  • reportPath: string

  • runAt: string

• lastRunAt: string

• OptionallastStrategyAt?: string

  ISO timestamp of the most recent computeStrategy invocation embedded in a daily run output (#1270). The cadence gate in daily.ts consults this — strategy snapshots fire every 30 days OR when 5+ PRs have merged since the last snapshot, whichever comes first. Below STRATEGY_MIN_PRS merged PRs the gate stays silent regardless of cadence.

• OptionallocalRepoCache?: {
      cachedAt: string;
      repos: Record<
          string,
          { currentBranch: string
          | null; exists: boolean; path: string },
      >;
      scanPaths: string[];
  }

• OptionalmergedPRs?: {
      commentsFetchedAt?: string;
      firstMaintainerResponseAt?: string;
      learningsExtractedAt?: string;
      mergedAt: string;
      openedAt?: string;
      title: string;
      url: string;
  }[]

• OptionalmonthlyClosedCounts?: Record<string, number>

• OptionalmonthlyMergedCounts?: Record<string, number>

• OptionalmonthlyOpenedCounts?: Record<string, number>

• OptionalprFollowUpHistory?: Record<
      string,
      {
          draftPath?: string;
          tier: "light_check_in"
          | "direct_check_in"
          | "final_check_in";
          timestamp: string;
      }[],
  >

  Per-PR follow-up history (#1277). Keyed by PR URL. Each entry records a tier-bucketed follow-up that the user drafted (and presumably posted via draft-review-post). The dormant-pr workflow reads this before drafting to enforce the one-follow-up-per-timeframe rule documented in skills/pr-etiquette/SKILL.md.

• repoScores: Record<
      string,
      {
          avgResponseDays: number
          | null;
          closedWithoutMergeCount: number;
          language?: string | null;
          lastEvaluatedAt: string;
          lastMergedAt?: string;
          mergedPRCount: number;
          repo: string;
          score: number;
          signals: {
              hasActiveMaintainers: boolean;
              hasHostileComments: boolean;
              isResponsive: boolean;
          };
          stargazersCount?: number;
      },
  >

• OptionalsearchRotation?: {
      languageOffset: number;
      lastRotatedAt?: string;
      maintainedOffset: number;
      phase0Offset: number;
      starredOffset: number;
      strategyOffset: number;
  }

  Broad-phase language rotation cursor (#1630), oss-scout's searchRotation. Scout advances it after every search whose broad phase ran; autopilot runs scout in persistence:'provided', so the advanced cursor is written back here and fed into the next scout state. Absent until the first search.

• searchSeen: { lastSeenAt: string; url: string }[]

  Durable search seen-set for result rotation (#1528). Issue URLs surfaced by recent searches, with the timestamp they were last surfaced. Fed into oss-scout as savedResults so its rotation excludes recently-surfaced issues, and updated after each search. Culled past the rotation window so it cannot grow without bound.

• version: 4

• OptionalworkflowState?: {
      branchName?: string;
      completedSteps: string[];
      currentStep: string;
      issueContext?: { title: string; url: string };
      lastUpdatedAt: string;
      stepData: Record<string, unknown>;
      workflowName: "draft-first" | "work-through-issues" | "pre-commit-review";
  }

  Pause-point snapshot for resumable workflows (#1280). Set when the user picks "Done for now" mid-workflow; cleared when the workflow completes or the user explicitly discards. The router reads this on every /oss invocation and offers Resume / Restart / Discard when present.