Function collectGitHubConfig

packages/setupWizard/src/github.ts:72–222

(connectionName: string)

}

export async function collectGitHubConfig(connectionName: string): Promise<CollectResult> {
    const env: EnvVars = {};
    const config: GithubConnectionConfig = { type: 'github' };

    const url = await input({
        message: 'GitHub URL',
        default: 'https://github.com',
        theme: INPUT_THEME,
        validate: (v) => {
            if (!v?.trim()) {
                return 'URL is required';
            }
            if (!/^https?:\/\//.test(v)) {
                return 'Must start with http:// or https://';
            }
            return true;
        },
    });
    if (url !== 'https://github.com') {
        config.url = url;
    }

    note(
        [
            'Fine-grained PAT (recommended):',
            `  ${url}/settings/personal-access-tokens/new`,
            '  Required permissions: Contents (read), Metadata (read)',
            '',
            'Classic PAT:',
            `  ${url}/settings/tokens/new`,
            '  Required scope: repo',
        ].join('\n'),
        'Create a GitHub Personal Access Token',
    );

    const tokenEnvKey = toEnvKey(connectionName, 'TOKEN');
    const token = await password({
        message: `GitHub Personal Access Token (stored locally in .env as ${tokenEnvKey}, leave blank for public repos only)`,
        mask: true,
    });
    if (token.trim()) {
        env[tokenEnvKey] = token;
        config.token = { env: tokenEnvKey };
    }

    const apiBase = githubApiBase(url);

    const targets = await checkbox<string>({
        message: 'What do you want to index?',
        choices: [
            { value: 'repos', name: 'Specific repositories', description: 'Hand-pick individual repos to index' },
            { value: 'orgs', name: 'Organizations', description: 'Index every repo each chosen org owns' },
            { value: 'users', name: 'Users', description: 'Index every repo each chosen user owns' },
        ],
        required: true,
    });

    if (targets.includes('repos')) {