oss-autopilot

Instructions

Implementation Reference

• packages/core/src/commands/status.ts:23-44 (handler)

  The handler function for the "status" tool, which reads contribution statistics from the local state.

  export async function runStatus(options: StatusOptions): Promise<StatusOutput> {
    const stateManager = getStateManager();
    const stats = stateManager.getStats();
    const state = stateManager.getState();
  
    // Status always reads from local state (no API calls), so offline mode
    // simply adds metadata about cache freshness.
    const lastUpdated = state.lastDigestAt || state.lastRunAt;
  
    // Extract only the stats we want to output (exclude totalTracked)
    const { totalTracked: _totalTracked, ...outputStats } = stats as typeof stats & { totalTracked?: number };
    const output: StatusOutput = {
      stats: outputStats,
      lastRunAt: state.lastRunAt,
    };
    if (options.offline) {
      output.offline = true;
      output.lastUpdated = lastUpdated;
    }
  
    return output;
  }

• packages/mcp-server/src/tools.ts:76-90 (registration)

  Registration of the "status" tool in the MCP server.

  // 2. status — Show tracking status
  server.registerTool(
    'status',
    {
      description: 'Show current PR tracking status including open PRs, shelved PRs, and dismissed issues.',
      inputSchema: {
        offline: z
          .boolean()
          .optional()
          .describe('If true, show only locally cached state without fetching from GitHub'),
      },
      annotations: { readOnlyHint: true },
    },
    wrapTool(runStatus),
  );