codeblog-app 1.0.0 → 1.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "codeblog-app",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "CLI client for CodeBlog — the forum where AI writes the posts",
   "type": "module",
   "license": "MIT",

package/src/ai/provider.ts

@@ -53,7 +53,7 @@ export namespace AIProvider {
   // Provider env key mapping
   // ---------------------------------------------------------------------------
   const PROVIDER_ENV: Record<string, string[]> = {
-    anthropic: ["ANTHROPIC_API_KEY"],
+    anthropic: ["ANTHROPIC_API_KEY", "ANTHROPIC_AUTH_TOKEN"],
     openai: ["OPENAI_API_KEY"],
     google: ["GOOGLE_GENERATIVE_AI_API_KEY", "GOOGLE_API_KEY"],
     "amazon-bedrock": ["AWS_ACCESS_KEY_ID"],
@@ -70,6 +70,22 @@ export namespace AIProvider {
     "openai-compatible": ["OPENAI_COMPATIBLE_API_KEY"],
   }
 
+  // ---------------------------------------------------------------------------
+  // Provider base URL env mapping (for third-party API proxies)
+  // ---------------------------------------------------------------------------
+  const PROVIDER_BASE_URL_ENV: Record<string, string[]> = {
+    anthropic: ["ANTHROPIC_BASE_URL"],
+    openai: ["OPENAI_BASE_URL", "OPENAI_API_BASE"],
+    google: ["GOOGLE_API_BASE_URL"],
+    azure: ["AZURE_OPENAI_BASE_URL"],
+    xai: ["XAI_BASE_URL"],
+    mistral: ["MISTRAL_BASE_URL"],
+    groq: ["GROQ_BASE_URL"],
+    deepinfra: ["DEEPINFRA_BASE_URL"],
+    openrouter: ["OPENROUTER_BASE_URL"],
+    "openai-compatible": ["OPENAI_COMPATIBLE_BASE_URL"],
+  }
+
   // ---------------------------------------------------------------------------
   // Provider → npm package mapping
   // ---------------------------------------------------------------------------
@@ -177,6 +193,18 @@ export namespace AIProvider {
     return cfg.providers?.[providerID]?.api_key
   }
 
+  // ---------------------------------------------------------------------------
+  // Get base URL for a provider (env var or config)
+  // ---------------------------------------------------------------------------
+  export async function getBaseUrl(providerID: string): Promise<string | undefined> {
+    const envKeys = PROVIDER_BASE_URL_ENV[providerID] || []
+    for (const key of envKeys) {
+      if (process.env[key]) return process.env[key]
+    }
+    const cfg = await Config.load()
+    return cfg.providers?.[providerID]?.base_url
+  }
+
   // ---------------------------------------------------------------------------
   // List all available providers with their models
   // ---------------------------------------------------------------------------
@@ -223,7 +251,8 @@ export namespace AIProvider {
     if (builtin) {
       const apiKey = await getApiKey(builtin.providerID)
       if (!apiKey) throw noKeyError(builtin.providerID)
-      return getLanguageModel(builtin.providerID, id, apiKey)
+      const base = await getBaseUrl(builtin.providerID)
+      return getLanguageModel(builtin.providerID, id, apiKey, undefined, base)
     }
 
     // Try models.dev
@@ -234,7 +263,8 @@ export namespace AIProvider {
         const apiKey = await getApiKey(providerID)
         if (!apiKey) throw noKeyError(providerID)
         const npm = p.models[id].provider?.npm || p.npm || "@ai-sdk/openai-compatible"
-        return getLanguageModel(providerID, id, apiKey, npm, p.api)
+        const base = await getBaseUrl(providerID)
+        return getLanguageModel(providerID, id, apiKey, npm, base || p.api)
       }
     }
 
@@ -244,7 +274,8 @@ export namespace AIProvider {
       const mid = rest.join("/")
       const apiKey = await getApiKey(providerID)
       if (!apiKey) throw noKeyError(providerID)
-      return getLanguageModel(providerID, mid, apiKey)
+      const base = await getBaseUrl(providerID)
+      return getLanguageModel(providerID, mid, apiKey, undefined, base)
     }
 
     throw new Error(`Unknown model: ${id}. Run: codeblog config --list`)
@@ -289,6 +320,25 @@ export namespace AIProvider {
     return cfg.model
   }
 
+  // ---------------------------------------------------------------------------
+  // Check if any AI provider has a key configured
+  // ---------------------------------------------------------------------------
+  export async function hasAnyKey(): Promise<boolean> {
+    // Check env vars
+    for (const providerID of Object.keys(PROVIDER_ENV)) {
+      const key = await getApiKey(providerID)
+      if (key) return true
+    }
+    // Check config file (covers third-party providers not in PROVIDER_ENV)
+    const cfg = await Config.load()
+    if (cfg.providers) {
+      for (const p of Object.values(cfg.providers)) {
+        if (p.api_key) return true
+      }
+    }
+    return false
+  }
+
   // ---------------------------------------------------------------------------
   // List available models with key status (for codeblog config --list)
   // ---------------------------------------------------------------------------

package/src/cli/cmd/ai-publish.ts

@@ -1,5 +1,6 @@
 import type { CommandModule } from "yargs"
 import { AIChat } from "../../ai/chat"
+import { AIProvider } from "../../ai/provider"
 import { Posts } from "../../api/posts"
 import { Config } from "../../config"
 import { scanAll, parseSession, registerAllScanners } from "../../scanner"
@@ -32,6 +33,21 @@ export const AIPublishCommand: CommandModule = {
       }),
   handler: async (args) => {
     try {
+      // Check AI key before scanning
+      const hasKey = await AIProvider.hasAnyKey()
+      if (!hasKey) {
+        console.log("")
+        UI.warn("No AI provider configured. ai-publish requires an AI API key to generate posts.")
+        console.log("")
+        console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Configure an AI provider first:${UI.Style.TEXT_NORMAL}`)
+        console.log(`    ${UI.Style.TEXT_HIGHLIGHT}codeblog config --provider anthropic --api-key sk-ant-...${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+        console.log(`  ${UI.Style.TEXT_DIM}Run: codeblog config --list  to see all supported providers${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+        process.exitCode = 1
+        return
+      }
+
       UI.info("Scanning IDE sessions...")
       registerAllScanners()
       const sessions = scanAll(args.limit as number)

package/src/cli/cmd/chat.ts

@@ -23,6 +23,25 @@ export const ChatCommand: CommandModule = {
   handler: async (args) => {
     const modelID = args.model as string | undefined
 
+    // Check AI key before doing anything
+    const hasKey = await AIProvider.hasAnyKey()
+    if (!hasKey) {
+      console.log("")
+      UI.warn("No AI provider configured. AI features require an API key.")
+      console.log("")
+      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Configure an AI provider:${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+      console.log(`    ${UI.Style.TEXT_HIGHLIGHT}codeblog config --provider anthropic --api-key sk-ant-...${UI.Style.TEXT_NORMAL}`)
+      console.log(`    ${UI.Style.TEXT_HIGHLIGHT}codeblog config --provider openai --api-key sk-...${UI.Style.TEXT_NORMAL}`)
+      console.log(`    ${UI.Style.TEXT_HIGHLIGHT}codeblog config --provider google --api-key AIza...${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+      console.log(`  ${UI.Style.TEXT_DIM}Or set an environment variable: ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.${UI.Style.TEXT_NORMAL}`)
+      console.log(`  ${UI.Style.TEXT_DIM}Run: codeblog config --list  to see all 15+ supported providers${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+      process.exitCode = 1
+      return
+    }
+
     // Non-interactive: single prompt
     if (args.prompt) {
       try {

package/src/cli/cmd/config.ts

@@ -36,6 +36,10 @@ export const ConfigCommand: CommandModule = {
         type: "boolean",
         default: false,
       })
+      .option("base-url", {
+        describe: "Custom base URL for the provider (for third-party API proxies)",
+        type: "string",
+      })
       .option("language", {
         describe: "Default content language for posts (e.g. English, 中文, 日本語)",
         type: "string",
@@ -80,12 +84,18 @@ export const ConfigCommand: CommandModule = {
         return
       }
 
-      if (args.provider && args.apiKey) {
+      if (args.provider && (args.apiKey || args.baseUrl)) {
         const cfg = await Config.load()
         const providers = cfg.providers || {}
-        providers[args.provider as string] = { ...providers[args.provider as string], api_key: args.apiKey as string }
+        const existing = providers[args.provider as string] || {} as Config.ProviderConfig
+        if (args.apiKey) existing.api_key = args.apiKey as string
+        if (args.baseUrl) existing.base_url = args.baseUrl as string
+        providers[args.provider as string] = existing
         await Config.save({ providers })
-        UI.success(`${args.provider} API key saved`)
+        const parts: string[] = []
+        if (args.apiKey) parts.push("API key")
+        if (args.baseUrl) parts.push(`base URL (${args.baseUrl})`)
+        UI.success(`${args.provider} ${parts.join(" + ")} saved`)
         return
       }
 
@@ -125,12 +135,14 @@ export const ConfigCommand: CommandModule = {
         console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}AI Providers${UI.Style.TEXT_NORMAL}`)
         for (const [id, p] of Object.entries(providers)) {
           const masked = p.api_key ? p.api_key.slice(0, 8) + "..." : "not set"
-          console.log(`    ${UI.Style.TEXT_SUCCESS}✓${UI.Style.TEXT_NORMAL} ${id}: ${UI.Style.TEXT_DIM}${masked}${UI.Style.TEXT_NORMAL}`)
+          const url = p.base_url ? ` → ${p.base_url}` : ""
+          console.log(`    ${UI.Style.TEXT_SUCCESS}✓${UI.Style.TEXT_NORMAL} ${id}: ${UI.Style.TEXT_DIM}${masked}${url}${UI.Style.TEXT_NORMAL}`)
         }
       } else {
         console.log(`  ${UI.Style.TEXT_DIM}No AI providers configured.${UI.Style.TEXT_NORMAL}`)
         console.log(`  ${UI.Style.TEXT_DIM}Set one: codeblog config --provider anthropic --api-key sk-...${UI.Style.TEXT_NORMAL}`)
-        console.log(`  ${UI.Style.TEXT_DIM}Or use env: ANTHROPIC_API_KEY=sk-...${UI.Style.TEXT_NORMAL}`)
+        console.log(`  ${UI.Style.TEXT_DIM}Third-party proxy: codeblog config --provider anthropic --api-key sk-... --base-url https://proxy.example.com${UI.Style.TEXT_NORMAL}`)
+        console.log(`  ${UI.Style.TEXT_DIM}Or use env: ANTHROPIC_API_KEY + ANTHROPIC_BASE_URL${UI.Style.TEXT_NORMAL}`)
       }
       console.log("")
     } catch (err) {

package/src/cli/cmd/setup.ts

@@ -1,6 +1,7 @@
 import type { CommandModule } from "yargs"
 import { Auth } from "../../auth"
 import { OAuth } from "../../auth/oauth"
+import { AIProvider } from "../../ai/provider"
 import { registerAllScanners, scanAll } from "../../scanner"
 import { Publisher } from "../../publisher"
 import { UI } from "../ui"
@@ -76,10 +77,26 @@ export const SetupCommand: CommandModule = {
     console.log("")
     UI.success("Setup complete! 🎉")
     console.log("")
+
+    // Check if AI is configured
+    const hasKey = await AIProvider.hasAnyKey()
+    if (!hasKey) {
+      console.log(`  ${UI.Style.TEXT_WARNING}💡 Optional: Configure an AI provider to unlock AI features${UI.Style.TEXT_NORMAL}`)
+      console.log(`  ${UI.Style.TEXT_DIM}(ai-publish, chat, and other AI-powered commands)${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+      console.log(`    ${UI.Style.TEXT_HIGHLIGHT}codeblog config --provider anthropic --api-key sk-ant-...${UI.Style.TEXT_NORMAL}`)
+      console.log(`    ${UI.Style.TEXT_HIGHLIGHT}codeblog config --provider openai --api-key sk-...${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+      console.log(`  ${UI.Style.TEXT_DIM}Run: codeblog config --list  to see all 15+ supported providers${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+    }
+
     console.log(`  ${UI.Style.TEXT_DIM}Useful commands:${UI.Style.TEXT_NORMAL}`)
     console.log(`    codeblog feed        ${UI.Style.TEXT_DIM}— Browse the forum${UI.Style.TEXT_NORMAL}`)
     console.log(`    codeblog scan        ${UI.Style.TEXT_DIM}— Scan IDE sessions${UI.Style.TEXT_NORMAL}`)
     console.log(`    codeblog publish     ${UI.Style.TEXT_DIM}— Publish sessions${UI.Style.TEXT_NORMAL}`)
+    console.log(`    codeblog ai-publish  ${UI.Style.TEXT_DIM}— AI writes a post from your session${UI.Style.TEXT_NORMAL}`)
+    console.log(`    codeblog chat        ${UI.Style.TEXT_DIM}— Interactive AI chat${UI.Style.TEXT_NORMAL}`)
     console.log(`    codeblog dashboard   ${UI.Style.TEXT_DIM}— Your stats${UI.Style.TEXT_NORMAL}`)
     console.log("")
   },

package/src/global/index.ts

@@ -6,10 +6,14 @@ import os from "os"
 const app = "codeblog"
 
 const home = process.env.CODEBLOG_TEST_HOME || os.homedir()
-const data = path.join(xdgData || path.join(home, ".local", "share"), app)
-const cache = path.join(xdgCache || path.join(home, ".cache"), app)
-const config = path.join(xdgConfig || path.join(home, ".config"), app)
-const state = path.join(xdgState || path.join(home, ".local", "state"), app)
+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 = {

package/src/index.ts

@@ -35,7 +35,7 @@ import { WeeklyDigestCommand } from "./cli/cmd/weekly-digest"
 import { TagsCommand } from "./cli/cmd/tags"
 import { ExploreCommand } from "./cli/cmd/explore"
 
-const VERSION = "0.4.3"
+const VERSION = "1.2.0"
 
 process.on("unhandledRejection", (e) => {
   Log.Default.error("rejection", {