codeblog-app 2.3.0 → 2.3.1

package/src/cli/ui.ts

@@ -0,0 +1,357 @@
+import { EOL } from "os"
+
+export namespace UI {
+  export const Style = {
+    TEXT_HIGHLIGHT: "\x1b[96m",
+    TEXT_HIGHLIGHT_BOLD: "\x1b[96m\x1b[1m",
+    TEXT_DIM: "\x1b[90m",
+    TEXT_DIM_BOLD: "\x1b[90m\x1b[1m",
+    TEXT_NORMAL: "\x1b[0m",
+    TEXT_NORMAL_BOLD: "\x1b[1m",
+    TEXT_WARNING: "\x1b[93m",
+    TEXT_WARNING_BOLD: "\x1b[93m\x1b[1m",
+    TEXT_DANGER: "\x1b[91m",
+    TEXT_DANGER_BOLD: "\x1b[91m\x1b[1m",
+    TEXT_SUCCESS: "\x1b[92m",
+    TEXT_SUCCESS_BOLD: "\x1b[92m\x1b[1m",
+    TEXT_INFO: "\x1b[94m",
+    TEXT_INFO_BOLD: "\x1b[94m\x1b[1m",
+  }
+
+  export function println(...message: string[]) {
+    print(...message)
+    Bun.stderr.write(EOL)
+  }
+
+  export function print(...message: string[]) {
+    Bun.stderr.write(message.join(" "))
+  }
+
+  export function logo() {
+    const orange = "\x1b[38;5;214m"
+    const cyan = "\x1b[36m"
+    const reset = "\x1b[0m"
+    return [
+      "",
+      `${orange}  ██████╗ ██████╗ ██████╗ ███████╗${cyan}██████╗ ██╗      ██████╗  ██████╗ ${reset}`,
+      `${orange} ██╔════╝██╔═══██╗██╔══██╗██╔════╝${cyan}██╔══██╗██║     ██╔═══██╗██╔════╝ ${reset}`,
+      `${orange} ██║     ██║   ██║██║  ██║█████╗  ${cyan}██████╔╝██║     ██║   ██║██║  ███╗${reset}`,
+      `${orange} ██║     ██║   ██║██║  ██║██╔══╝  ${cyan}██╔══██╗██║     ██║   ██║██║   ██║${reset}`,
+      `${orange} ╚██████╗╚██████╔╝██████╔╝███████╗${cyan}██████╔╝███████╗╚██████╔╝╚██████╔╝${reset}`,
+      `${orange}  ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝${cyan}╚═════╝ ╚══════╝ ╚═════╝  ╚═════╝ ${reset}`,
+      "",
+      `  ${Style.TEXT_DIM}The AI-powered coding forum in your terminal${Style.TEXT_NORMAL}`,
+      "",
+    ].join(EOL)
+  }
+
+  export function error(message: string) {
+    println(Style.TEXT_DANGER_BOLD + "Error: " + Style.TEXT_NORMAL + message)
+  }
+
+  export function success(message: string) {
+    println(Style.TEXT_SUCCESS_BOLD + "✓ " + Style.TEXT_NORMAL + message)
+  }
+
+  export function info(message: string) {
+    println(Style.TEXT_INFO + "ℹ " + Style.TEXT_NORMAL + message)
+  }
+
+  export function warn(message: string) {
+    println(Style.TEXT_WARNING + "⚠ " + Style.TEXT_NORMAL + message)
+  }
+
+  export async function input(prompt: string): Promise<string> {
+    const readline = require("readline")
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+    return new Promise((resolve) => {
+      rl.question(prompt, (answer: string) => {
+        rl.close()
+        resolve(answer.trim())
+      })
+    })
+  }
+
+  /**
+   * Input with ESC support. Returns null if user presses Escape, otherwise the input string.
+   */
+  export async function inputWithEscape(prompt: string): Promise<string | null> {
+    const stdin = process.stdin
+    process.stderr.write(prompt)
+
+    return new Promise((resolve) => {
+      const wasRaw = stdin.isRaw
+      if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(true)
+
+      let buf = ""
+      let paste = false
+      let onData: ((ch: Buffer) => void) = () => {}
+
+      const restore = () => {
+        if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(wasRaw ?? false)
+        stdin.removeListener("data", onData)
+      }
+
+      const readClipboard = () => {
+        if (process.platform !== "darwin") return ""
+        try {
+          const out = Bun.spawnSync(["pbpaste"])
+          if (out.exitCode !== 0) return ""
+          return out.stdout.toString().replace(/\r\n/g, "\n").replace(/\r/g, "\n").replace(/\n/g, "")
+        } catch {
+          return ""
+        }
+      }
+
+      const append = (text: string) => {
+        if (!text) return
+        buf += text
+        process.stderr.write(text)
+      }
+
+      onData = (ch: Buffer) => {
+        const c = ch.toString("utf8")
+        if (c === "\u0003") {
+          // Ctrl+C
+          restore()
+          process.exit(130)
+        }
+        if (!paste && c === "\x1b") {
+          // Escape
+          restore()
+          process.stderr.write("\n")
+          resolve(null)
+          return
+        }
+        if (c === "\x16" || c === "\x1bv") {
+          const clip = readClipboard()
+          if (clip) append(clip)
+          return
+        }
+
+        let text = c
+        if (text.includes("\x1b[200~")) {
+          paste = true
+          text = text.replace(/\x1b\[200~/g, "")
+        }
+        if (text.includes("\x1b[201~")) {
+          paste = false
+          text = text.replace(/\x1b\[201~/g, "")
+        }
+        text = text.replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, "").replace(/\x1b./g, "")
+
+        if (!paste && (text === "\r" || text === "\n")) {
+          // Enter
+          restore()
+          process.stderr.write("\n")
+          resolve(buf)
+          return
+        }
+        if (!paste && (text === "\u007f" || text === "\b")) {
+          // Backspace
+          if (buf.length > 0) {
+            buf = buf.slice(0, -1)
+            process.stderr.write("\b \b")
+          }
+          return
+        }
+        // Regular character
+        const clean = text.replace(/[\x00-\x08\x0b-\x1f\x7f]/g, "")
+        append(clean)
+      }
+      stdin.on("data", onData)
+    })
+  }
+
+  export async function password(prompt: string): Promise<string> {
+    const readline = require("readline")
+    const rl = readline.createInterface({ input: process.stdin, output: process.stderr, terminal: true })
+    return new Promise((resolve) => {
+      // Disable echoing by writing the prompt manually and muting stdout
+      process.stderr.write(prompt)
+      const stdin = process.stdin
+      const wasRaw = stdin.isRaw
+      if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(true)
+
+      let buf = ""
+      const onData = (ch: Buffer) => {
+        const c = ch.toString("utf8")
+        if (c === "\n" || c === "\r" || c === "\u0004") {
+          if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(wasRaw ?? false)
+          stdin.removeListener("data", onData)
+          process.stderr.write("\n")
+          rl.close()
+          resolve(buf.trim())
+        } else if (c === "\u007f" || c === "\b") {
+          // backspace
+          if (buf.length > 0) buf = buf.slice(0, -1)
+        } else if (c === "\u0003") {
+          // Ctrl+C
+          if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(wasRaw ?? false)
+          stdin.removeListener("data", onData)
+          rl.close()
+          process.exit(130)
+        } else {
+          buf += c
+          process.stderr.write("*")
+        }
+      }
+      stdin.on("data", onData)
+    })
+  }
+
+  export async function select(prompt: string, options: string[]): Promise<number> {
+    if (options.length === 0) return 0
+
+    const stdin = process.stdin
+    const wasRaw = stdin.isRaw
+    if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(true)
+    process.stderr.write("\x1b[?25l")
+
+    let idx = 0
+    let drawnRows = 0
+    const maxRows = 12
+    let onData: ((ch: Buffer) => void) = () => {}
+
+    const stripAnsi = (text: string) => text.replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, "").replace(/\x1b./g, "")
+    const rowCount = (line: string) => {
+      const cols = Math.max(20, process.stderr.columns || 80)
+      const len = Array.from(stripAnsi(line)).length
+      return Math.max(1, Math.ceil((len || 1) / cols))
+    }
+
+    const draw = () => {
+      if (drawnRows > 1) process.stderr.write(`\x1b[${drawnRows - 1}F`)
+      process.stderr.write("\x1b[J")
+
+      const start = options.length <= maxRows ? 0 : Math.max(0, Math.min(idx - 4, options.length - maxRows))
+      const items = options.slice(start, start + maxRows)
+      const lines = [
+        prompt,
+        ...items.map((item, i) => {
+          const active = start + i === idx
+          const marker = active ? `${Style.TEXT_HIGHLIGHT}●${Style.TEXT_NORMAL}` : "○"
+          const text = active ? `${Style.TEXT_NORMAL_BOLD}${item}${Style.TEXT_NORMAL}` : item
+          return `  ${marker} ${text}`
+        }),
+        options.length > maxRows
+          ? `  ${Style.TEXT_DIM}${start > 0 ? "↑ more  " : ""}${start + maxRows < options.length ? "↓ more" : ""}${Style.TEXT_NORMAL}`
+          : `  ${Style.TEXT_DIM}${Style.TEXT_NORMAL}`,
+        `  ${Style.TEXT_DIM}Use ↑/↓ then Enter (Esc to cancel)${Style.TEXT_NORMAL}`,
+      ]
+      process.stderr.write(lines.map((line) => `\x1b[2K\r${line}`).join("\n"))
+      drawnRows = lines.reduce((sum, line) => sum + rowCount(line), 0)
+    }
+
+    const restore = () => {
+      process.stderr.write("\x1b[?25h")
+      if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(wasRaw ?? false)
+      stdin.removeListener("data", onData)
+      process.stderr.write("\n")
+    }
+
+    draw()
+
+    return new Promise((resolve) => {
+      onData = (ch: Buffer) => {
+        const c = ch.toString("utf8")
+        if (c === "\u0003") {
+          restore()
+          process.exit(130)
+        }
+        if (c === "\r" || c === "\n") {
+          restore()
+          resolve(idx)
+          return
+        }
+        if (c === "\x1b") {
+          restore()
+          resolve(-1)
+          return
+        }
+        if (c === "k" || c.includes("\x1b[A") || c.includes("\x1bOA")) {
+          idx = (idx - 1 + options.length) % options.length
+          draw()
+          return
+        }
+        if (c === "j" || c.includes("\x1b[B") || c.includes("\x1bOB")) {
+          idx = (idx + 1) % options.length
+          draw()
+          return
+        }
+      }
+      stdin.on("data", onData)
+    })
+  }
+
+  export async function waitKey(prompt: string, keys: string[]): Promise<string> {
+    const stdin = process.stdin
+    process.stderr.write(`  ${Style.TEXT_DIM}${prompt}${Style.TEXT_NORMAL}`)
+
+    return new Promise((resolve) => {
+      const wasRaw = stdin.isRaw
+      if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(true)
+
+      const onData = (ch: Buffer) => {
+        const c = ch.toString("utf8")
+        if (c === "\u0003") {
+          // Ctrl+C
+          if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(wasRaw ?? false)
+          stdin.removeListener("data", onData)
+          process.exit(130)
+        }
+        const key = (c === "\r" || c === "\n") ? "enter" : c === "\x1b" ? "escape" : c.toLowerCase()
+        if (keys.includes(key)) {
+          if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(wasRaw ?? false)
+          stdin.removeListener("data", onData)
+          process.stderr.write("\n")
+          resolve(key)
+        }
+      }
+      stdin.on("data", onData)
+    })
+  }
+
+  /**
+   * Wait for Enter key (or Esc to skip). Returns "enter" or "escape".
+   */
+  export async function waitEnter(prompt?: string): Promise<"enter" | "escape"> {
+    return waitKey(prompt || "Press Enter to continue...", ["enter", "escape"]) as Promise<"enter" | "escape">
+  }
+
+  /**
+   * Streaming typewriter effect — prints text character by character to stderr.
+   */
+  export async function typeText(text: string, opts?: { charDelay?: number; prefix?: string }) {
+    const delay = opts?.charDelay ?? 12
+    const prefix = opts?.prefix ?? "  "
+    Bun.stderr.write(prefix)
+    for (const ch of text) {
+      Bun.stderr.write(ch)
+      if (delay > 0) await Bun.sleep(delay)
+    }
+    Bun.stderr.write(EOL)
+  }
+
+  /**
+   * Clean markdown formatting from MCP tool output for CLI display.
+   * Removes **bold**, *italic*, keeps structure readable.
+   */
+  export function cleanMarkdown(text: string): string {
+    return text
+      .replace(/\*\*(.+?)\*\*/g, "$1")   // **bold** → bold
+      .replace(/\*(.+?)\*/g, "$1")        // *italic* → italic
+      .replace(/`([^`]+)`/g, "$1")        // `code` → code
+      .replace(/^#{1,6}\s+/gm, "")        // ### heading → heading
+      .replace(/^---+$/gm, "──────────────────────────────────") // horizontal rule
+  }
+
+  /**
+   * Print a horizontal divider.
+   */
+  export function divider() {
+    println("")
+    println(`  ${Style.TEXT_DIM}──────────────────────────────────${Style.TEXT_NORMAL}`)
+    println("")
+  }
+}

package/src/config/index.ts

@@ -0,0 +1,92 @@
+import path from "path"
+import { chmod, writeFile } from "fs/promises"
+import { Global } from "../global"
+
+const CONFIG_FILE = path.join(Global.Path.config, "config.json")
+
+export namespace Config {
+  export type ModelApi = "anthropic" | "openai" | "google" | "openai-compatible"
+  export type CompatProfile = "anthropic" | "openai" | "openai-compatible" | "google"
+
+  export interface FeatureFlags {
+    ai_provider_registry_v2?: boolean
+    ai_onboarding_wizard_v2?: boolean
+  }
+
+  export interface ProviderConfig {
+    api_key: string
+    base_url?: string
+    api?: ModelApi
+    compat_profile?: CompatProfile
+  }
+
+  export interface CodeblogConfig {
+    api_url: string
+    api_key?: string
+    token?: string
+    model?: string
+    default_provider?: string
+    default_language?: string
+    activeAgent?: string
+    providers?: Record<string, ProviderConfig>
+    feature_flags?: FeatureFlags
+  }
+
+  const defaults: CodeblogConfig = {
+    api_url: "https://codeblog.ai",
+  }
+
+  export const filepath = CONFIG_FILE
+
+  const FEATURE_FLAG_ENV: Record<keyof FeatureFlags, string> = {
+    ai_provider_registry_v2: "CODEBLOG_AI_PROVIDER_REGISTRY_V2",
+    ai_onboarding_wizard_v2: "CODEBLOG_AI_ONBOARDING_WIZARD_V2",
+  }
+
+  export async function load(): Promise<CodeblogConfig> {
+    const file = Bun.file(CONFIG_FILE)
+    const data = await file.json().catch(() => ({}))
+    return { ...defaults, ...data }
+  }
+
+  export async function save(config: Partial<CodeblogConfig>) {
+    const current = await load()
+    const merged = { ...current, ...config }
+    await writeFile(CONFIG_FILE, JSON.stringify(merged, null, 2))
+    await chmod(CONFIG_FILE, 0o600).catch(() => {})
+  }
+
+  export async function url() {
+    return process.env.CODEBLOG_URL || (await load()).api_url || "https://codeblog.ai"
+  }
+
+  export async function key() {
+    return process.env.CODEBLOG_API_KEY || (await load()).api_key || ""
+  }
+
+  export async function token() {
+    return process.env.CODEBLOG_TOKEN || (await load()).token || ""
+  }
+
+  export async function language() {
+    return process.env.CODEBLOG_LANGUAGE || (await load()).default_language
+  }
+
+  function parseBool(raw: string | undefined): boolean | undefined {
+    if (!raw) return undefined
+    const v = raw.trim().toLowerCase()
+    if (["1", "true", "yes", "on"].includes(v)) return true
+    if (["0", "false", "no", "off"].includes(v)) return false
+    return undefined
+  }
+
+  export function envFlagName(flag: keyof FeatureFlags): string {
+    return FEATURE_FLAG_ENV[flag]
+  }
+
+  export async function featureEnabled(flag: keyof FeatureFlags): Promise<boolean> {
+    const env = parseBool(process.env[FEATURE_FLAG_ENV[flag]])
+    if (env !== undefined) return env
+    return !!(await load()).feature_flags?.[flag]
+  }
+}

package/src/flag/index.ts

@@ -0,0 +1,23 @@
+function truthy(key: string) {
+  const value = process.env[key]?.toLowerCase()
+  return value === "true" || value === "1"
+}
+
+export namespace Flag {
+  export const CODEBLOG_URL = process.env["CODEBLOG_URL"]
+  export const CODEBLOG_API_KEY = process.env["CODEBLOG_API_KEY"]
+  export const CODEBLOG_TOKEN = process.env["CODEBLOG_TOKEN"]
+  export const CODEBLOG_DEBUG = truthy("CODEBLOG_DEBUG")
+  export const CODEBLOG_DISABLE_AUTOUPDATE = truthy("CODEBLOG_DISABLE_AUTOUPDATE")
+  export const CODEBLOG_DISABLE_SCANNER_CACHE = truthy("CODEBLOG_DISABLE_SCANNER_CACHE")
+  export const CODEBLOG_TEST_HOME = process.env["CODEBLOG_TEST_HOME"]
+  export declare const CODEBLOG_CLIENT: string
+}
+
+Object.defineProperty(Flag, "CODEBLOG_CLIENT", {
+  get() {
+    return process.env["CODEBLOG_CLIENT"] ?? "cli"
+  },
+  enumerable: true,
+  configurable: false,
+})

package/src/global/index.ts

@@ -0,0 +1,38 @@
+import fs from "fs/promises"
+import { xdgData, xdgCache, xdgConfig, xdgState } from "xdg-basedir"
+import path from "path"
+import os from "os"
+
+const app = "codeblog"
+
+const home = process.env.CODEBLOG_TEST_HOME || os.homedir()
+const win = os.platform() === "win32"
+const appdata = process.env.APPDATA || path.join(home, "AppData", "Roaming")
+const localappdata = process.env.LOCALAPPDATA || path.join(home, "AppData", "Local")
+
+const data = win ? path.join(localappdata, app) : path.join(xdgData || path.join(home, ".local", "share"), app)
+const cache = win ? path.join(localappdata, app, "cache") : path.join(xdgCache || path.join(home, ".cache"), app)
+const config = win ? path.join(appdata, app) : path.join(xdgConfig || path.join(home, ".config"), app)
+const state = win ? path.join(localappdata, app, "state") : path.join(xdgState || path.join(home, ".local", "state"), app)
+
+export namespace Global {
+  export const Path = {
+    get home() {
+      return process.env.CODEBLOG_TEST_HOME || os.homedir()
+    },
+    data,
+    bin: path.join(data, "bin"),
+    log: path.join(data, "log"),
+    cache,
+    config,
+    state,
+  }
+}
+
+await Promise.all([
+  fs.mkdir(Global.Path.data, { recursive: true }),
+  fs.mkdir(Global.Path.config, { recursive: true }),
+  fs.mkdir(Global.Path.state, { recursive: true }),
+  fs.mkdir(Global.Path.log, { recursive: true }),
+  fs.mkdir(Global.Path.bin, { recursive: true }),
+])

package/src/id/index.ts

@@ -0,0 +1,20 @@
+import { randomBytes } from "crypto"
+
+export namespace ID {
+  export function generate(prefix = ""): string {
+    const bytes = randomBytes(12).toString("hex")
+    return prefix ? `${prefix}_${bytes}` : bytes
+  }
+
+  export function short(): string {
+    return randomBytes(6).toString("hex")
+  }
+
+  export function uuid(): string {
+    return crypto.randomUUID()
+  }
+
+  export function timestamp(): string {
+    return `${Date.now()}-${randomBytes(4).toString("hex")}`
+  }
+}