feat: add debug subcommand with version, runtime, paths, and auth status info

🤖 Generated with [opencode](https://opencode.ai)

Co-Authored-By: opencode <noreply@opencode.ai>

Author: ericc-ch

src/debug.ts

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+
+import { defineCommand } from "citty"
+import consola from "consola"
+import fs from "node:fs/promises"
+import os from "node:os"
+
+import { PATHS } from "./lib/paths"
+
+interface DebugInfo {
+  version: string
+  runtime: {
+    name: string
+    version: string
+    platform: string
+    arch: string
+  }
+  paths: {
+    APP_DIR: string
+    GITHUB_TOKEN_PATH: string
+  }
+  tokenExists: boolean
+}
+
+interface RunDebugOptions {
+  json: boolean
+}
+
+async function getPackageVersion(): Promise<string> {
+  try {
+    const packageJsonPath = new URL("../package.json", import.meta.url).pathname
+    // @ts-expect-error https://github.com/sindresorhus/eslint-plugin-unicorn/blob/v59.0.1/docs/rules/prefer-json-parse-buffer.md
+    // JSON.parse() can actually parse buffers
+    const packageJson = JSON.parse(await fs.readFile(packageJsonPath)) as {
+      version: string
+    }
+    return packageJson.version
+  } catch {
+    return "unknown"
+  }
+}
+
+function getRuntimeInfo() {
+  const isBun = typeof Bun !== "undefined"
+
+  return {
+    name: isBun ? "bun" : "node",
+    version: isBun ? Bun.version : process.version.slice(1),
+    platform: os.platform(),
+    arch: os.arch(),
+  }
+}
+
+async function checkTokenExists(): Promise<boolean> {
+  try {
+    const stats = await fs.stat(PATHS.GITHUB_TOKEN_PATH)
+    if (!stats.isFile()) return false
+
+    const content = await fs.readFile(PATHS.GITHUB_TOKEN_PATH, "utf8")
+    return content.trim().length > 0
+  } catch {
+    return false
+  }
+}
+
+async function getDebugInfo(): Promise<DebugInfo> {
+  const [version, tokenExists] = await Promise.all([
+    getPackageVersion(),
+    checkTokenExists(),
+  ])
+
+  return {
+    version,
+    runtime: getRuntimeInfo(),
+    paths: {
+      APP_DIR: PATHS.APP_DIR,
+      GITHUB_TOKEN_PATH: PATHS.GITHUB_TOKEN_PATH,
+    },
+    tokenExists,
+  }
+}
+
+function printDebugInfoPlain(info: DebugInfo): void {
+  consola.info(`copilot-api debug
+
+Version: ${info.version}
+Runtime: ${info.runtime.name} ${info.runtime.version} (${info.runtime.platform} ${info.runtime.arch})
+
+Paths:
+- APP_DIR: ${info.paths.APP_DIR}
+- GITHUB_TOKEN_PATH: ${info.paths.GITHUB_TOKEN_PATH}
+
+Token exists: ${info.tokenExists ? "Yes" : "No"}`)
+}
+
+function printDebugInfoJson(info: DebugInfo): void {
+  console.log(JSON.stringify(info, null, 2))
+}
+
+export async function runDebug(options: RunDebugOptions): Promise<void> {
+  const debugInfo = await getDebugInfo()
+
+  if (options.json) {
+    printDebugInfoJson(debugInfo)
+  } else {
+    printDebugInfoPlain(debugInfo)
+  }
+}
+
+export const debug = defineCommand({
+  meta: {
+    name: "debug",
+    description: "Print debug information about the application",
+  },
+  args: {
+    json: {
+      type: "boolean",
+      default: false,
+      description: "Output debug information as JSON",
+    },
+  },
+  run({ args }) {
+    return runDebug({
+      json: args.json,
+    })
+  },
+})

src/main.ts

@@ -4,6 +4,7 @@ import { defineCommand, runMain } from "citty"
 
 import { auth } from "./auth"
 import { checkUsage } from "./check-usage"
+import { debug } from "./debug"
 import { start } from "./start"
 
 const main = defineCommand({
@@ -12,7 +13,7 @@ const main = defineCommand({
     description:
       "A wrapper around GitHub Copilot API to make it OpenAI compatible, making it usable for other tools.",
   },
-  subCommands: { auth, start, "check-usage": checkUsage },
+  subCommands: { auth, start, "check-usage": checkUsage, debug },
 })
 
 await runMain(main)