@laitszkin/apollo-toolkit 3.13.2 → 3.14.0

package/dist/lib/tools/open-github-issue.js

@@ -0,0 +1,750 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openGitHubIssueHandler = openGitHubIssueHandler;
+// @ts-nocheck
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_https_1 = require("node:https");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const GITHUB_API_BASE = 'https://api.github.com';
+const README_ACCEPT = 'application/vnd.github.raw+json';
+const JSON_ACCEPT = 'application/vnd.github+json';
+const DEFAULT_REPRO_ZH = '尚未穩定重現；需補充更多執行期資料。';
+const DEFAULT_REPRO_EN = 'Not yet reliably reproducible; more runtime evidence is required.';
+const ISSUE_TYPE_PROBLEM = 'problem';
+const ISSUE_TYPE_FEATURE = 'feature';
+const ISSUE_TYPE_PERFORMANCE = 'performance';
+const ISSUE_TYPE_SECURITY = 'security';
+const ISSUE_TYPE_DOCS = 'docs';
+const ISSUE_TYPE_OBSERVABILITY = 'observability';
+const ISSUE_TYPES = [
+    ISSUE_TYPE_PROBLEM,
+    ISSUE_TYPE_FEATURE,
+    ISSUE_TYPE_PERFORMANCE,
+    ISSUE_TYPE_SECURITY,
+    ISSUE_TYPE_DOCS,
+    ISSUE_TYPE_OBSERVABILITY,
+];
+const PROBLEM_BDD_MARKER_GROUPS = [
+    [
+        /Expected Behavior\s*\(BDD\)/i,
+        /Current Behavior\s*\(BDD\)/i,
+        /Behavior Gap/i,
+    ],
+    [
+        /預期行為\s*[（(]BDD[）)]/i,
+        /(?:目前|當前)行為\s*[（(]BDD[）)]/i,
+        /行為(?:落差|差異)/i,
+    ],
+];
+const TEXT_FIELDS = [
+    'title',
+    'problem_description',
+    'suspected_cause',
+    'reproduction',
+    'proposal',
+    'reason',
+    'suggested_architecture',
+    'impact',
+    'evidence',
+    'suggested_action',
+    'affected_scope',
+];
+const PAYLOAD_FIELDS = new Set([
+    'title',
+    'issue_type',
+    'problem_description',
+    'suspected_cause',
+    'reproduction',
+    'proposal',
+    'reason',
+    'suggested_architecture',
+    'impact',
+    'evidence',
+    'suggested_action',
+    'severity',
+    'affected_scope',
+    'repo',
+    'dry_run',
+]);
+function parseArgs(argv) {
+    const args = {
+        payloadFile: null,
+        title: null,
+        issueType: null,
+        problemDescription: null,
+        suspectedCause: null,
+        reproduction: null,
+        proposal: null,
+        reason: null,
+        suggestedArchitecture: null,
+        impact: null,
+        evidence: null,
+        suggestedAction: null,
+        severity: null,
+        affectedScope: null,
+        repo: null,
+        dryRun: false,
+    };
+    let i = 0;
+    while (i < argv.length) {
+        const arg = argv[i];
+        switch (arg) {
+            case '--payload-file':
+                if (i + 1 < argv.length)
+                    args.payloadFile = argv[++i];
+                break;
+            case '--title':
+                if (i + 1 < argv.length)
+                    args.title = argv[++i];
+                break;
+            case '--issue-type':
+                if (i + 1 < argv.length)
+                    args.issueType = argv[++i];
+                break;
+            case '--problem-description':
+                if (i + 1 < argv.length)
+                    args.problemDescription = argv[++i];
+                break;
+            case '--suspected-cause':
+                if (i + 1 < argv.length)
+                    args.suspectedCause = argv[++i];
+                break;
+            case '--reproduction':
+                if (i + 1 < argv.length)
+                    args.reproduction = argv[++i];
+                break;
+            case '--proposal':
+                if (i + 1 < argv.length)
+                    args.proposal = argv[++i];
+                break;
+            case '--reason':
+                if (i + 1 < argv.length)
+                    args.reason = argv[++i];
+                break;
+            case '--suggested-architecture':
+                if (i + 1 < argv.length)
+                    args.suggestedArchitecture = argv[++i];
+                break;
+            case '--impact':
+                if (i + 1 < argv.length)
+                    args.impact = argv[++i];
+                break;
+            case '--evidence':
+                if (i + 1 < argv.length)
+                    args.evidence = argv[++i];
+                break;
+            case '--suggested-action':
+                if (i + 1 < argv.length)
+                    args.suggestedAction = argv[++i];
+                break;
+            case '--severity':
+                if (i + 1 < argv.length)
+                    args.severity = argv[++i];
+                break;
+            case '--affected-scope':
+                if (i + 1 < argv.length)
+                    args.affectedScope = argv[++i];
+                break;
+            case '--repo':
+                if (i + 1 < argv.length)
+                    args.repo = argv[++i];
+                break;
+            case '--dry-run':
+                args.dryRun = true;
+                break;
+            default:
+                if (!arg.startsWith('-')) {
+                    // unsupported positional — ignore per Python behavior
+                }
+                break;
+        }
+        i++;
+    }
+    return args;
+}
+function runCommand(cmd, cmdArgs) {
+    return new Promise((resolve) => {
+        (0, node_child_process_1.execFile)(cmd, cmdArgs, { maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
+            if (error) {
+                resolve({
+                    stdout: stdout || '',
+                    stderr: stderr || '',
+                    exitCode: error.status ?? 1,
+                });
+            }
+            else {
+                resolve({ stdout: stdout || '', stderr: stderr || '', exitCode: 0 });
+            }
+        });
+    });
+}
+function normalizeKey(key) {
+    return key.replace(/-/g, '_');
+}
+function readPayloadFile(rawPath) {
+    let rawContent;
+    let context;
+    if (rawPath === '-') {
+        // We cannot read stdin here easily; throw clear error
+        throw new Error('stdin payload (-) is not supported in handler mode; use a file path');
+    }
+    else {
+        rawContent = (0, node_fs_1.readFileSync)(rawPath, 'utf-8');
+        context = rawPath;
+    }
+    let payload;
+    try {
+        payload = JSON.parse(rawContent);
+    }
+    catch (exc) {
+        throw new Error(`Invalid JSON payload in ${context}: ${exc.message}`);
+    }
+    if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
+        throw new Error(`Invalid JSON payload in ${context}: top-level value must be an object.`);
+    }
+    const normalized = {};
+    for (const [rawKey, value] of Object.entries(payload)) {
+        const key = normalizeKey(rawKey);
+        if (!PAYLOAD_FIELDS.has(key)) {
+            throw new Error(`Unsupported payload key: ${rawKey}`);
+        }
+        normalized[key] = value;
+    }
+    return normalized;
+}
+function readAtFileValue(fieldName, value) {
+    if (value === null)
+        return null;
+    if (value.startsWith('@@'))
+        return value.slice(1);
+    if (value === '@-') {
+        throw new Error('stdin reading (@-) is not supported in handler mode');
+    }
+    if (value.startsWith('@') && value.length > 1) {
+        const filePath = value.slice(1);
+        try {
+            return (0, node_fs_1.readFileSync)(filePath, 'utf-8');
+        }
+        catch (exc) {
+            throw new Error(`Unable to read @${fieldName} file ${filePath}: ${exc.message}`);
+        }
+    }
+    return value;
+}
+function requireNonEmpty(value, message) {
+    if (!(value || '').trim()) {
+        throw new Error(message);
+    }
+}
+function hasRequiredProblemBddSections(problemDescription) {
+    const normalized = problemDescription.trim();
+    return PROBLEM_BDD_MARKER_GROUPS.some((group) => group.every((pattern) => pattern.test(normalized)));
+}
+function hasGhAuth() {
+    return runCommand('gh', ['auth', 'status']).then((r) => r.exitCode === 0);
+}
+function getToken(env) {
+    return env.GITHUB_TOKEN || env.GH_TOKEN || null;
+}
+function resolveRepo(explicitRepo) {
+    if (explicitRepo) {
+        return validateRepo(explicitRepo);
+    }
+    // Try to resolve from git remote
+    const result = runCommand('git', [
+        'remote', 'get-url', 'origin',
+    ]);
+    // This is sync because it's called in a non-async context flow
+    // Actually, let me use the promisified version — but we need to make the caller async
+    // For now, throw a helpful error
+    throw new Error('--repo is required in handler mode. Unable to auto-detect from git remote in-process.');
+}
+function validateRepo(repo) {
+    const candidate = repo.trim();
+    if (!/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(candidate)) {
+        throw new Error('Invalid repo format. Use owner/repo.');
+    }
+    return candidate;
+}
+// ---- HTTP helpers ----
+function githubRequest(method, path, token, accept, payload) {
+    return new Promise((resolve, reject) => {
+        const headers = {
+            Accept: accept,
+            'User-Agent': 'open-github-issue-skill',
+            'X-GitHub-Api-Version': '2022-11-28',
+        };
+        if (token) {
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        let body;
+        if (payload !== undefined) {
+            body = JSON.stringify(payload);
+            headers['Content-Type'] = 'application/json';
+        }
+        const url = new URL(`${GITHUB_API_BASE}${path}`);
+        const req = (0, node_https_1.request)(url, {
+            method,
+            headers,
+        }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => {
+                data += chunk.toString('utf-8');
+            });
+            res.on('end', () => {
+                if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                    resolve(data);
+                }
+                else {
+                    const detail = data || 'unknown error';
+                    reject(new Error(`GitHub API ${res.statusCode} ${path}: ${detail}`));
+                }
+            });
+        });
+        req.on('error', (err) => {
+            reject(new Error(`GitHub API request failed for ${path}: ${err.message}`));
+        });
+        if (body !== undefined) {
+            req.write(body);
+        }
+        req.end();
+    });
+}
+async function fetchRemoteReadme(repo, ghAuthenticated, token) {
+    if (ghAuthenticated) {
+        const result = await runCommand('gh', [
+            'api',
+            '-H',
+            `Accept: ${README_ACCEPT}`,
+            `repos/${repo}/readme`,
+        ]);
+        if (result.exitCode === 0) {
+            return result.stdout;
+        }
+    }
+    try {
+        return await githubRequest('GET', `/repos/${repo}/readme`, token, README_ACCEPT);
+    }
+    catch {
+        return '';
+    }
+}
+function detectIssueLanguage(readmeContent) {
+    if (!readmeContent.trim())
+        return 'en';
+    const chineseChars = (readmeContent.match(/[一-鿿]/g) || []).length;
+    const languageChars = (readmeContent.match(/[A-Za-z一-鿿]/g) || []).length;
+    if (chineseChars >= 20 && languageChars > 0 && chineseChars / languageChars >= 0.08) {
+        return 'zh';
+    }
+    return 'en';
+}
+// ---- Issue body builder ----
+function buildIssueBody(params) {
+    const { issueType, language, title, problemDescription, suspectedCause, reproduction, proposal, reason, suggestedArchitecture, impact, evidence, suggestedAction, severity, affectedScope, } = params;
+    if (issueType === ISSUE_TYPE_FEATURE) {
+        const proposalText = (proposal || title).trim();
+        const reasonText = (reason || '').trim();
+        const architectureText = (suggestedArchitecture || '').trim();
+        if (language === 'zh') {
+            return ('### 功能提案\n' +
+                `${proposalText}\n\n` +
+                '### 原因\n' +
+                `${reasonText}\n\n` +
+                '### 建議架構\n' +
+                `${architectureText}\n`);
+        }
+        return ('### Feature Proposal\n' +
+            `${proposalText}\n\n` +
+            '### Why This Is Needed\n' +
+            `${reasonText}\n\n` +
+            '### Suggested Architecture\n' +
+            `${architectureText}\n`);
+    }
+    if (issueType === ISSUE_TYPE_PERFORMANCE) {
+        if (language === 'zh') {
+            return ('### 效能問題\n' +
+                `${(problemDescription || '').trim()}\n\n` +
+                '### 影響\n' +
+                `${(impact || '').trim()}\n\n` +
+                '### 證據\n' +
+                `${(evidence || '').trim()}\n\n` +
+                '### 建議行動\n' +
+                `${(suggestedAction || '').trim()}\n`);
+        }
+        return ('### Performance Problem\n' +
+            `${(problemDescription || '').trim()}\n\n` +
+            '### Impact\n' +
+            `${(impact || '').trim()}\n\n` +
+            '### Evidence\n' +
+            `${(evidence || '').trim()}\n\n` +
+            '### Suggested Action\n' +
+            `${(suggestedAction || '').trim()}\n`);
+    }
+    if (issueType === ISSUE_TYPE_SECURITY) {
+        if (language === 'zh') {
+            return ('### 安全風險\n' +
+                `${(problemDescription || '').trim()}\n\n` +
+                '### 嚴重程度\n' +
+                `${(severity || '').trim()}\n\n` +
+                '### 受影響範圍\n' +
+                `${(affectedScope || '').trim()}\n\n` +
+                '### 影響\n' +
+                `${(impact || '').trim()}\n\n` +
+                '### 證據\n' +
+                `${(evidence || '').trim()}\n\n` +
+                '### 建議緩解\n' +
+                `${(suggestedAction || '').trim()}\n`);
+        }
+        return ('### Security Risk\n' +
+            `${(problemDescription || '').trim()}\n\n` +
+            '### Severity\n' +
+            `${(severity || '').trim()}\n\n` +
+            '### Affected Scope\n' +
+            `${(affectedScope || '').trim()}\n\n` +
+            '### Impact\n' +
+            `${(impact || '').trim()}\n\n` +
+            '### Evidence\n' +
+            `${(evidence || '').trim()}\n\n` +
+            '### Suggested Mitigation\n' +
+            `${(suggestedAction || '').trim()}\n`);
+    }
+    if (issueType === ISSUE_TYPE_DOCS) {
+        if (language === 'zh') {
+            return ('### 文件缺口\n' +
+                `${(problemDescription || '').trim()}\n\n` +
+                '### 證據\n' +
+                `${(evidence || '').trim()}\n\n` +
+                '### 建議更新\n' +
+                `${(suggestedAction || '').trim()}\n`);
+        }
+        return ('### Documentation Gap\n' +
+            `${(problemDescription || '').trim()}\n\n` +
+            '### Evidence\n' +
+            `${(evidence || '').trim()}\n\n` +
+            '### Suggested Update\n' +
+            `${(suggestedAction || '').trim()}\n`);
+    }
+    if (issueType === ISSUE_TYPE_OBSERVABILITY) {
+        if (language === 'zh') {
+            return ('### 可觀測性缺口\n' +
+                `${(problemDescription || '').trim()}\n\n` +
+                '### 影響\n' +
+                `${(impact || '').trim()}\n\n` +
+                '### 證據\n' +
+                `${(evidence || '').trim()}\n\n` +
+                '### 建議儀表化\n' +
+                `${(suggestedAction || '').trim()}\n`);
+        }
+        return ('### Observability Gap\n' +
+            `${(problemDescription || '').trim()}\n\n` +
+            '### Impact\n' +
+            `${(impact || '').trim()}\n\n` +
+            '### Evidence\n' +
+            `${(evidence || '').trim()}\n\n` +
+            '### Suggested Instrumentation\n' +
+            `${(suggestedAction || '').trim()}\n`);
+    }
+    // Default: problem
+    if (language === 'zh') {
+        const reproText = (reproduction || DEFAULT_REPRO_ZH).trim();
+        return ('### 問題描述\n' +
+            `${(problemDescription || '').trim()}\n\n` +
+            '### 推測原因\n' +
+            `${(suspectedCause || '').trim()}\n\n` +
+            '### 重現條件（如有）\n' +
+            `${reproText}\n`);
+    }
+    const reproText = (reproduction || DEFAULT_REPRO_EN).trim();
+    return ('### Problem Description\n' +
+        `${(problemDescription || '').trim()}\n\n` +
+        '### Suspected Cause\n' +
+        `${(suspectedCause || '').trim()}\n\n` +
+        '### Reproduction Conditions (if available)\n' +
+        `${reproText}\n`);
+}
+// ---- Issue creation ----
+async function createIssueWithGh(repo, title, body) {
+    // Write body to a temp file
+    const tmpFile = (0, node_path_1.join)((0, node_os_1.tmpdir)(), `issue-${Date.now()}.md`);
+    const { writeFileSync, unlinkSync } = await Promise.resolve().then(() => __importStar(require('node:fs')));
+    writeFileSync(tmpFile, body, 'utf-8');
+    try {
+        const result = await runCommand('gh', [
+            'issue',
+            'create',
+            '--repo',
+            repo,
+            '--title',
+            title,
+            '--body-file',
+            tmpFile,
+        ]);
+        if (result.exitCode !== 0) {
+            throw new Error(result.stderr.trim() || 'gh issue create failed');
+        }
+        const urlMatch = result.stdout.match(/https:\/\/github\.com\/[^\s]+\/issues\/\d+/);
+        return urlMatch ? urlMatch[0] : result.stdout.trim();
+    }
+    finally {
+        try {
+            unlinkSync(tmpFile);
+        }
+        catch {
+            // ignore cleanup errors
+        }
+    }
+}
+async function createIssueWithToken(repo, title, body, token) {
+    const response = await githubRequest('POST', `/repos/${repo}/issues`, token, JSON_ACCEPT, {
+        title,
+        body,
+    });
+    const parsed = JSON.parse(response);
+    const issueUrl = parsed.html_url;
+    if (!issueUrl) {
+        throw new Error('Issue created but response did not include html_url');
+    }
+    return issueUrl;
+}
+// ---- Validation ----
+function validateIssueContent(args) {
+    const issueType = args.issueType || ISSUE_TYPE_PROBLEM;
+    if (issueType === ISSUE_TYPE_FEATURE) {
+        requireNonEmpty(args.reason, 'Feature issues require --reason.');
+        requireNonEmpty(args.suggestedArchitecture, 'Feature issues require --suggested-architecture.');
+        return;
+    }
+    if (issueType === ISSUE_TYPE_PERFORMANCE) {
+        requireNonEmpty(args.problemDescription, 'Performance issues require --problem-description.');
+        requireNonEmpty(args.impact, 'Performance issues require --impact.');
+        requireNonEmpty(args.evidence, 'Performance issues require --evidence.');
+        requireNonEmpty(args.suggestedAction, 'Performance issues require --suggested-action.');
+        return;
+    }
+    if (issueType === ISSUE_TYPE_SECURITY) {
+        requireNonEmpty(args.problemDescription, 'Security issues require --problem-description.');
+        requireNonEmpty(args.affectedScope, 'Security issues require --affected-scope.');
+        requireNonEmpty(args.impact, 'Security issues require --impact.');
+        requireNonEmpty(args.evidence, 'Security issues require --evidence.');
+        requireNonEmpty(args.suggestedAction, 'Security issues require --suggested-action.');
+        requireNonEmpty(args.severity, 'Security issues require --severity.');
+        return;
+    }
+    if (issueType === ISSUE_TYPE_DOCS) {
+        requireNonEmpty(args.problemDescription, 'Docs issues require --problem-description.');
+        requireNonEmpty(args.evidence, 'Docs issues require --evidence.');
+        requireNonEmpty(args.suggestedAction, 'Docs issues require --suggested-action.');
+        return;
+    }
+    if (issueType === ISSUE_TYPE_OBSERVABILITY) {
+        requireNonEmpty(args.problemDescription, 'Observability issues require --problem-description.');
+        requireNonEmpty(args.impact, 'Observability issues require --impact.');
+        requireNonEmpty(args.evidence, 'Observability issues require --evidence.');
+        requireNonEmpty(args.suggestedAction, 'Observability issues require --suggested-action.');
+        return;
+    }
+    // Problem issue
+    requireNonEmpty(args.problemDescription, 'Problem issues require --problem-description.');
+    requireNonEmpty(args.suspectedCause, 'Problem issues require --suspected-cause.');
+    if (!hasRequiredProblemBddSections(args.problemDescription || '')) {
+        throw new Error('Problem issues require --problem-description to include ' +
+            'Expected Behavior (BDD), Current Behavior (BDD), and Behavior Gap sections.');
+    }
+}
+function hydrateArgs(args) {
+    const result = { ...args };
+    // Load from payload file if provided
+    if (result.payloadFile) {
+        const payload = readPayloadFile(result.payloadFile);
+        for (const [key, value] of Object.entries(payload)) {
+            if (key === 'dry_run') {
+                if (typeof value !== 'boolean') {
+                    throw new Error("Payload field 'dry_run' must be a boolean.");
+                }
+                if (!result.dryRun) {
+                    result.dryRun = value;
+                }
+                continue;
+            }
+            // String fields
+            if (TEXT_FIELDS.includes(key)) {
+                if (value !== null && typeof value !== 'string') {
+                    throw new Error(`Payload field '${key}' must be a string or null.`);
+                }
+            }
+            else if (typeof value !== 'string') {
+                throw new Error(`Payload field '${key}' must be a string.`);
+            }
+            const currentVal = result[key];
+            if (currentVal === null || currentVal === '') {
+                result[key] = value;
+            }
+        }
+    }
+    // Set default issue type
+    if (!result.issueType) {
+        result.issueType = ISSUE_TYPE_PROBLEM;
+    }
+    if (!ISSUE_TYPES.includes(result.issueType)) {
+        throw new Error(`Invalid issue_type: ${result.issueType}`);
+    }
+    // Resolve @-prefixed file values
+    for (const fieldName of TEXT_FIELDS) {
+        const resultObj = result;
+        const val = resultObj[fieldName];
+        resultObj[fieldName] = readAtFileValue(fieldName, val);
+    }
+    // Title is required
+    if (!(result.title || '').trim()) {
+        throw new Error('Issue title is required. Pass --title or include title in --payload-file.');
+    }
+    return result;
+}
+async function resolveRepoAsync(explicitRepo, context) {
+    if (explicitRepo)
+        return validateRepo(explicitRepo);
+    // Try to resolve from git remote
+    const result = await runCommand('git', ['remote', 'get-url', 'origin']);
+    if (result.exitCode !== 0) {
+        context.stderr.write('Unable to resolve origin remote. Pass --repo owner/repo.\n');
+        throw new Error('--repo resolution failed');
+    }
+    const remote = result.stdout.trim();
+    const match = remote.match(/github\.com[:/](?<owner>[A-Za-z0-9_.-]+)\/(?<repo>[A-Za-z0-9_.-]+?)(?:\.git)?$/);
+    if (!match?.groups) {
+        context.stderr.write('Origin remote is not a GitHub repository. Pass --repo owner/repo.\n');
+        throw new Error('--repo resolution failed');
+    }
+    return `${match.groups.owner}/${match.groups.repo}`;
+}
+async function openGitHubIssueHandler(argv, context) {
+    const { stdout, stderr, env } = context;
+    let args;
+    try {
+        args = hydrateArgs(parseArgs(argv));
+        validateIssueContent(args);
+    }
+    catch (err) {
+        stderr.write(`Error: ${err.message}\n`);
+        return 1;
+    }
+    const ghAuthenticated = await hasGhAuth();
+    const token = getToken(env);
+    let repo;
+    try {
+        repo = await resolveRepoAsync(args.repo, context);
+    }
+    catch {
+        return 1;
+    }
+    const readmeContent = await fetchRemoteReadme(repo, ghAuthenticated, token);
+    const language = detectIssueLanguage(readmeContent);
+    const issueBody = buildIssueBody({
+        issueType: args.issueType || ISSUE_TYPE_PROBLEM,
+        language,
+        title: args.title || '',
+        problemDescription: args.problemDescription,
+        suspectedCause: args.suspectedCause,
+        reproduction: args.reproduction,
+        proposal: args.proposal,
+        reason: args.reason,
+        suggestedArchitecture: args.suggestedArchitecture,
+        impact: args.impact,
+        evidence: args.evidence,
+        suggestedAction: args.suggestedAction,
+        severity: args.severity,
+        affectedScope: args.affectedScope,
+    });
+    let mode = 'draft-only';
+    let issueUrl = '';
+    let publishError = '';
+    if (args.dryRun) {
+        mode = 'dry-run';
+    }
+    else if (ghAuthenticated) {
+        try {
+            issueUrl = await createIssueWithGh(repo, args.title || '', issueBody);
+            mode = 'gh-cli';
+        }
+        catch (exc) {
+            if (token) {
+                try {
+                    issueUrl = await createIssueWithToken(repo, args.title || '', issueBody, token);
+                    mode = 'github-token';
+                }
+                catch (tokenExc) {
+                    publishError = tokenExc.message;
+                }
+            }
+            else {
+                publishError = exc.message;
+            }
+        }
+    }
+    else if (token) {
+        try {
+            issueUrl = await createIssueWithToken(repo, args.title || '', issueBody, token);
+            mode = 'github-token';
+        }
+        catch (exc) {
+            publishError = exc.message;
+        }
+    }
+    const output = {
+        repo,
+        issue_type: args.issueType || ISSUE_TYPE_PROBLEM,
+        language: language === 'zh' ? 'zh' : 'en',
+        mode,
+        issue_url: issueUrl,
+        issue_title: args.title || '',
+        issue_body: issueBody,
+        publish_error: publishError,
+    };
+    stdout.write(JSON.stringify(output, null, 2) + '\n');
+    if (mode === 'draft-only') {
+        if (publishError) {
+            stderr.write(`Issue publish failed. Return draft only: ${publishError}\n`);
+        }
+        else {
+            stderr.write('No authenticated gh CLI session and no GitHub token found. ' +
+                'Return draft issue body only.\n');
+        }
+    }
+    return 0;
+}