@aion0/forge 0.10.6 → 0.10.17

package/RELEASE_NOTES.md

@@ -1,11 +1,11 @@
-# Forge v0.10.6
+# Forge v0.10.17
 
 Released: 2026-05-30
 
-## Changes since v0.10.5
+## Changes since v0.10.16
 
-### Other
-- feat(settings): folder picker for Add Project / Add Document Directory
+### Features
+- feat: API profile model picker uses registry providers
 
 
-**Full Changelog**: https://github.com/aiwatching/forge/compare/v0.10.5...v0.10.6
+**Full Changelog**: https://github.com/aiwatching/forge/compare/v0.10.16...v0.10.17

package/app/api/public-info/[resource]/route.ts

@@ -0,0 +1,40 @@
+/**
+ * GET /api/public-info/<resource>?refresh=1
+ *
+ * Server-side proxy + cache for files under the public-info repo. UI
+ * never hits GitHub directly — avoids CORS / rate-limit headaches and
+ * gives us a single cache shared across all browser tabs.
+ *
+ * Supported resources (extend by adding to RESOURCE_MAP):
+ *   - `models` → `models/registry.json`
+ *
+ * The UI passes the short name (`models`), this route translates to the
+ * actual path under the repo and pairs it with the right fallback.
+ */
+
+import { NextRequest, NextResponse } from 'next/server';
+import { fetchPublicInfo } from '@/lib/public-info/fetch';
+import { KNOWN_MODELS_FALLBACK } from '@/lib/agents/known-models';
+
+interface ResourceSpec {
+  path: string;
+  fallback: unknown;
+}
+
+const RESOURCE_MAP: Record<string, ResourceSpec> = {
+  models: { path: 'models/registry.json', fallback: KNOWN_MODELS_FALLBACK },
+};
+
+export async function GET(
+  req: NextRequest,
+  { params }: { params: Promise<{ resource: string }> },
+): Promise<NextResponse> {
+  const { resource } = await params;
+  const spec = RESOURCE_MAP[resource];
+  if (!spec) {
+    return NextResponse.json({ error: `unknown resource: ${resource}` }, { status: 404 });
+  }
+  const forceRefresh = req.nextUrl.searchParams.get('refresh') === '1';
+  const data = await fetchPublicInfo(spec.path, spec.fallback, { forceRefresh });
+  return NextResponse.json(data);
+}

package/app/api/skills/install-local/route.ts

@@ -29,6 +29,7 @@ import AdmZip from 'adm-zip';
 import { homedir } from 'node:os';
 import { getDb } from '@/src/core/db/database';
 import { getDbPath } from '@/src/config';
+import { getClaudeDir } from '@/lib/dirs';
 
 /**
  * Refuse to clobber an existing skill (registry-synced or previously
@@ -52,7 +53,7 @@ function db() { return getDb(getDbPath()); }
 // ─── Helpers ──────────────────────────────────────────────
 
 function getClaudeHome(): string {
-  return process.env.CLAUDE_HOME || join(homedir(), '.claude');
+  return getClaudeDir();
 }
 
 function isValidName(s: string): boolean {

package/cli/mw.mjs

@@ -745,7 +745,7 @@ __export(dirs_exports, {
 });
 import { homedir as homedir2 } from "node:os";
 import { join as join3 } from "node:path";
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, renameSync, copyFileSync, readFileSync as readFileSync2 } from "node:fs";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, renameSync, copyFileSync } from "node:fs";
 function getConfigDir() {
   return join3(homedir2(), ".forge");
 }
@@ -797,17 +797,7 @@ function migrateDataDir() {
   console.log("[forge] Migration complete. Old files kept as backup.");
 }
 function getClaudeDir() {
-  if (process.env.CLAUDE_HOME) return process.env.CLAUDE_HOME;
-  try {
-    const settingsFile = join3(getDataDir(), "settings.yaml");
-    if (existsSync3(settingsFile)) {
-      const raw = readFileSync2(settingsFile, "utf-8");
-      const m = raw.match(/^\s*claudeHome:\s*["']?(.+?)["']?\s*$/m);
-      if (m?.[1]) return m[1].replace(/^~/, homedir2());
-    }
-  } catch {
-  }
-  return join3(homedir2(), ".claude");
+  return process.env.CLAUDE_HOME || join3(homedir2(), ".claude");
 }
 var MIGRATE_FILES, MIGRATE_DIRS, migrated;
 var init_dirs = __esm({
@@ -835,10 +825,10 @@ var BASE2 = process.env.MW_URL || `http://localhost:${_cliPort || "3000"}`;
 var [, , cmd, ...args] = process.argv;
 async function checkForUpdate() {
   try {
-    const { readFileSync: readFileSync3 } = await import("node:fs");
+    const { readFileSync: readFileSync2 } = await import("node:fs");
     const { join: join4, dirname } = await import("node:path");
     const { fileURLToPath } = await import("node:url");
-    const pkg = JSON.parse(readFileSync3(join4(dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf-8"));
+    const pkg = JSON.parse(readFileSync2(join4(dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf-8"));
     const current = pkg.version;
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), 3e3);
@@ -872,11 +862,11 @@ async function api3(path, opts) {
 }
 async function main() {
   if (cmd === "--version" || cmd === "-v") {
-    const { readFileSync: readFileSync3 } = await import("node:fs");
+    const { readFileSync: readFileSync2 } = await import("node:fs");
     const { join: join4, dirname } = await import("node:path");
     const { fileURLToPath } = await import("node:url");
     try {
-      const pkg = JSON.parse(readFileSync3(join4(dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf-8"));
+      const pkg = JSON.parse(readFileSync2(join4(dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf-8"));
       console.log(`@aion0/forge v${pkg.version}`);
     } catch {
       console.log("forge (version unknown)");
@@ -1193,14 +1183,14 @@ Resume in CLI:`);
     }
     case "tunnel_code":
     case "tcode": {
-      const { readFileSync: readFileSync3, existsSync: existsSync4 } = await import("node:fs");
+      const { readFileSync: readFileSync2, existsSync: existsSync4 } = await import("node:fs");
       const { join: join4 } = await import("node:path");
       const { getDataDir: _gdd } = await Promise.resolve().then(() => (init_dirs(), dirs_exports));
       const dataDir2 = _gdd();
       const codeFile = join4(dataDir2, "session-code.json");
       try {
         if (existsSync4(codeFile)) {
-          const data = JSON.parse(readFileSync3(codeFile, "utf-8"));
+          const data = JSON.parse(readFileSync2(codeFile, "utf-8"));
           if (data.code) {
             console.log(`Session code: ${data.code}`);
           } else {
@@ -1212,7 +1202,7 @@ Resume in CLI:`);
       } catch {
       }
       try {
-        const tunnelState = JSON.parse(readFileSync3(join4(dataDir2, "tunnel-state.json"), "utf-8"));
+        const tunnelState = JSON.parse(readFileSync2(join4(dataDir2, "tunnel-state.json"), "utf-8"));
         if (tunnelState.url) console.log(`Tunnel URL: ${tunnelState.url}`);
       } catch {
       }
@@ -1356,9 +1346,9 @@ ${task.gitDiff.slice(0, 2e3)}`);
             cwd: homedir3()
           });
           try {
-            const { readFileSync: readFileSync3 } = await import("node:fs");
+            const { readFileSync: readFileSync2 } = await import("node:fs");
             const globalRoot = execSync2("npm root -g", { encoding: "utf-8", cwd: homedir3() }).trim();
-            const pkg = JSON.parse(readFileSync3(join4(globalRoot, "@aion0", "forge", "package.json"), "utf-8"));
+            const pkg = JSON.parse(readFileSync2(join4(globalRoot, "@aion0", "forge", "package.json"), "utf-8"));
             console.log(`[forge] Upgraded to v${pkg.version}. Run: forge server restart`);
           } catch {
             console.log("[forge] Upgraded. Run: forge server restart");

package/components/SettingsModal.tsx

@@ -2,6 +2,7 @@
 
 import { useState, useEffect, useCallback, useRef } from 'react';
 import { FolderPicker } from './FolderPicker';
+import { useModelsRegistry, pickerOptions } from '@/lib/public-info/use-models-registry';
 
 function SecretInput({ value, onChange, placeholder, className }: {
   value: string;
@@ -917,6 +918,7 @@ function ProfileRow({ id, cfg, inputClass, onUpdate, onDelete, isApi: isApiProp
   onUpdate: (cfg: any) => void; onDelete: () => void;
   isApi?: boolean;
 }) {
+  const { registry: modelsRegistry } = useModelsRegistry();
   const [expanded, setExpanded] = useState(false);
   const [testing, setTesting] = useState(false);
   const [testResult, setTestResult] = useState<{ ok: boolean; message?: string; error?: string; duration_ms?: number } | null>(null);
@@ -975,20 +977,23 @@ function ProfileRow({ id, cfg, inputClass, onUpdate, onDelete, isApi: isApiProp
               <label className="text-[8px] text-[var(--text-secondary)]">Model</label>
               <input value={cfg.model || ''} onChange={e => onUpdate({ ...cfg, model: e.target.value })}
                 list={`profile-model-${id}`} className={inputClass} />
-              {(cfg.cliType === 'claude-code' || (!cfg.cliType && !cfg.base && !isApi)) && (
-                <datalist id={`profile-model-${id}`}>
-                  <option value="claude-opus-4-6" />
-                  <option value="claude-sonnet-4-6" />
-                  <option value="claude-haiku-4-5-20251001" />
-                </datalist>
-              )}
-              {(cfg.cliType === 'codex' || cfg.base === 'codex') && (
-                <datalist id={`profile-model-${id}`}>
-                  <option value="codex-mini" />
-                  <option value="o4-mini" />
-                  <option value="gpt-4o" />
-                </datalist>
-              )}
+              {/* Datalist sourced from forge-public-info registry — adding a new
+                  model id over there shows up here within 24h, no forge release.
+                  API profiles look up by provider; CLI profiles look up by cliType. */}
+              <datalist id={`profile-model-${id}`}>
+                {(() => {
+                  const models = isApi
+                    ? modelsRegistry.providers?.[cfg.provider || 'anthropic']?.models
+                    : modelsRegistry.agents[
+                        cfg.cliType === 'codex' || cfg.base === 'codex' ? 'codex'
+                        : cfg.cliType === 'aider' || cfg.base === 'aider' ? 'aider'
+                        : 'claude-code'
+                      ]?.models;
+                  return (models || []).map(m => (
+                    <option key={m.id} value={m.id} />
+                  ));
+                })()}
+              </datalist>
             </div>
           </div>
           {isApi ? (
@@ -1127,6 +1132,7 @@ function AddProfileForm({ type, baseAgents, onAdd }: {
   baseAgents: AgentEntry[];
   onAdd: (id: string, cfg: any) => void;
 }) {
+  const { registry: modelsRegistry } = useModelsRegistry();
   const [open, setOpen] = useState(false);
   const [id, setId] = useState('');
   const [name, setName] = useState('');
@@ -1228,22 +1234,17 @@ function AddProfileForm({ type, baseAgents, onAdd }: {
           <div className="flex-1">
             <label className="text-[8px] text-[var(--text-secondary)]">Model</label>
             <input value={model} onChange={e => setModel(e.target.value)}
-              placeholder={base === 'claude' ? 'claude-sonnet-4-6' : base === 'codex' ? 'codex-mini' : ''}
+              placeholder={
+                base === 'claude' ? modelsRegistry.agents['claude-code']?.default || ''
+                : base === 'codex' ? modelsRegistry.agents['codex']?.default || ''
+                : ''
+              }
               list={`model-list-${base}`} className={inputClass} />
-            {base === 'claude' && (
-              <datalist id="model-list-claude">
-                <option value="claude-opus-4-6" />
-                <option value="claude-sonnet-4-6" />
-                <option value="claude-haiku-4-5-20251001" />
-              </datalist>
-            )}
-            {base === 'codex' && (
-              <datalist id="model-list-codex">
-                <option value="codex-mini" />
-                <option value="o4-mini" />
-                <option value="gpt-4o" />
-              </datalist>
-            )}
+            <datalist id={`model-list-${base}`}>
+              {(modelsRegistry.agents[base === 'claude' ? 'claude-code' : base]?.models || []).map(m => (
+                <option key={m.id} value={m.id} />
+              ))}
+            </datalist>
           </div>
         </div>
         <div>
@@ -1275,7 +1276,14 @@ function AddProfileForm({ type, baseAgents, onAdd }: {
             </div>
             <div className="flex-1">
               <label className="text-[8px] text-[var(--text-secondary)]">Model</label>
-              <input value={model} onChange={e => setModel(e.target.value)} placeholder="claude-sonnet-4-6" className={inputClass} />
+              <input value={model} onChange={e => setModel(e.target.value)}
+                placeholder={modelsRegistry.providers?.[provider]?.default || ''}
+                list={`api-model-list-${provider}`} className={inputClass} />
+              <datalist id={`api-model-list-${provider}`}>
+                {(modelsRegistry.providers?.[provider]?.models || []).map(m => (
+                  <option key={m.id} value={m.id} />
+                ))}
+              </datalist>
             </div>
           </div>
           <div>
@@ -1314,6 +1322,7 @@ function AddProfileForm({ type, baseAgents, onAdd }: {
 }
 
 function AgentsSection({ settings, setSettings }: { settings: any; setSettings: (s: any) => void }) {
+  const { registry: modelsRegistry } = useModelsRegistry();
   const [agents, setAgents] = useState<AgentEntry[]>([]);
   const [loading, setLoading] = useState(true);
   const [expandedAgent, setExpandedAgent] = useState<string | null>(null);
@@ -1649,9 +1658,9 @@ function AgentsSection({ settings, setSettings }: { settings: any; setSettings:
                       <span className="text-[8px] text-[var(--text-secondary)]">Presets:</span>
                       {((() => {
                         const ct = (settings.agents?.[a.id] as any)?.cliType || (a.id === 'claude' ? 'claude-code' : a.id === 'codex' ? 'codex' : a.id === 'aider' ? 'aider' : 'generic');
-                        if (ct === 'claude-code') return ['default', 'sonnet', 'opus', 'haiku', 'claude-sonnet-4-6', 'claude-opus-4-6', 'claude-haiku-4-5-20251001'];
-                        if (ct === 'codex') return ['default', 'o3-mini', 'o4-mini', 'gpt-4.1'];
-                        return ['default'];
+                        // Models pulled from forge-public-info repo (lib/public-info/fetch.ts).
+                        // Add new IDs there and they show up here within 24h with no forge release.
+                        return pickerOptions(modelsRegistry, ct);
                       })()).map(preset => (
                         <button
                           key={preset}

package/components/WorkspaceView.tsx

@@ -2,6 +2,7 @@
 
 import { useState, useEffect, useCallback, useMemo, useRef, forwardRef, useImperativeHandle, lazy, Suspense } from 'react';
 import { TerminalSessionPickerLazy, fetchAgentSessions, type PickerSelection } from './TerminalLauncher';
+import { useModelsRegistry } from '@/lib/public-info/use-models-registry';
 import {
   ReactFlow, Background, Controls, Handle, Position, useReactFlow, ReactFlowProvider,
   type Node, type NodeProps, MarkerType, type NodeChange,
@@ -715,6 +716,7 @@ function AgentConfigModal({ initial, mode, existingAgents, projectPath, onConfir
   onConfirm: (cfg: Omit<AgentConfig, 'id'>) => void;
   onCancel: () => void;
 }) {
+  const { registry: modelsRegistry } = useModelsRegistry();
   const [label, setLabel] = useState(initial.label || '');
   const [icon, setIcon] = useState(initial.icon || '🤖');
   const [role, setRole] = useState(initial.role || '');
@@ -1160,9 +1162,9 @@ function AgentConfigModal({ initial, mode, existingAgents, projectPath, onConfir
                   list="workspace-model-list"
                   className="text-xs bg-[#161b22] border border-[#30363d] rounded px-2 py-1 text-white focus:outline-none focus:border-[#58a6ff] font-mono" />
                 <datalist id="workspace-model-list">
-                  <option value="claude-sonnet-4-6" />
-                  <option value="claude-opus-4-6" />
-                  <option value="claude-haiku-4-5-20251001" />
+                  {(modelsRegistry.agents['claude-code']?.models || []).map(m => (
+                    <option key={m.id} value={m.id} />
+                  ))}
                 </datalist>
               </div>
             );

package/lib/agents/index.ts

@@ -91,7 +91,7 @@ export function listAgents(): AgentConfig[] {
           enabled: cfg.enabled !== false,
           isProfile: true,
           backendType: 'cli',
-          model: cfg.model || cfg.models?.task,
+          model: cfg.models?.task,
           skipPermissionsFlag: cfg.skipPermissionsFlag || baseAgent?.skipPermissionsFlag,
           env: cfg.env,
           cliType: (baseAgent as any)?.cliType || 'generic',
@@ -117,7 +117,7 @@ export function listAgents(): AgentConfig[] {
           base: cfg.base,
           isProfile: true,
           backendType: 'cli',
-          model: cfg.model || cfg.models?.task,
+          model: cfg.models?.task,
           skipPermissionsFlag: cfg.skipPermissionsFlag || baseAgent?.skipPermissionsFlag,
           env: cfg.env,
           cliType: cfg.cliType || (baseAgent as any)?.cliType || 'generic',
@@ -262,20 +262,19 @@ export function resolveTerminalLaunch(agentId?: string): TerminalLaunchInfo {
     || (cliType === 'codex' ? probeCodexSkipFlag(agentCfg.path || 'codex') : cli.skip)
     || undefined;
 
-  // Resolve env/model: either from this agent's own profile fields, or from linked profile
+  // Resolve env/model from this agent's per-use models sub-table.
+  // 顶层 model 字段已在 0.10 起被 migrate.ts 清理,这里只读 models.terminal。
   let env: Record<string, string> | undefined;
   let model: string | undefined;
-  if (agentCfg.base || agentCfg.env || agentCfg.model || agentCfg.models) {
-    // This agent has profile-like config — read env/model directly
+  if (agentCfg.base || agentCfg.env || agentCfg.models) {
     if (agentCfg.env) env = { ...agentCfg.env };
-    model = agentCfg.model || agentCfg.models?.terminal;
-    if (model === 'default') model = undefined; // 'default' means no override
+    model = agentCfg.models?.terminal;
+    if (model === 'default') model = undefined; // 'default' = 不加 --model
   } else if (agentCfg.profile) {
-    // Agent links to a separate profile — read from that
     const profileCfg = settings.agents?.[agentCfg.profile];
     if (profileCfg) {
       if (profileCfg.env) env = { ...profileCfg.env };
-      model = profileCfg.model || profileCfg.models?.terminal;
+      model = profileCfg.models?.terminal;
       if (model === 'default') model = undefined;
     }
   }

package/lib/agents/known-models.ts

@@ -0,0 +1,75 @@
+/**
+ * Built-in fallback model list. Forge prefers the public-info repo's
+ * registry (see `lib/public-info/fetch.ts`), but falls back to this
+ * when the network is unreachable, the file is malformed, or the
+ * user is on first-run before the cache is populated.
+ *
+ * Keep this list reasonably current — if the registry is permanently
+ * unreachable, this is what users see. New models in the wild should
+ * land in the public-info repo first (no code change required), and
+ * trickle into this fallback whenever the next forge release happens.
+ */
+
+import type { ModelsRegistry } from '../public-info/types';
+
+export const KNOWN_MODELS_FALLBACK: ModelsRegistry = {
+  version: 1,
+  updatedAt: '2026-05-30',
+  note: 'Bundled fallback — actual current list lives in forge-public-info/models/registry.json',
+  agents: {
+    'claude-code': {
+      displayName: 'Claude Code',
+      default: 'claude-sonnet-4-6',
+      aliases: [
+        { id: 'default', label: 'default (CLI decides)' },
+        { id: 'sonnet',  label: 'sonnet (alias)' },
+        { id: 'opus',    label: 'opus (alias)' },
+        { id: 'haiku',   label: 'haiku (alias)' },
+      ],
+      models: [
+        { id: 'claude-opus-4-8',           label: 'Opus 4.8',   tier: 'premium'  },
+        { id: 'claude-sonnet-4-6',         label: 'Sonnet 4.6', tier: 'standard', default: true },
+        { id: 'claude-haiku-4-5-20251001', label: 'Haiku 4.5',  tier: 'fast'     },
+      ],
+    },
+    codex: {
+      displayName: 'OpenAI Codex',
+      default: 'o4-mini',
+      aliases: [{ id: 'default', label: 'default (CLI decides)' }],
+      models: [
+        { id: 'o4-mini', label: 'o4-mini', tier: 'fast',     default: true },
+        { id: 'o3-mini', label: 'o3-mini', tier: 'fast'                    },
+        { id: 'gpt-4.1', label: 'GPT-4.1', tier: 'standard'                },
+      ],
+    },
+    aider: {
+      displayName: 'Aider',
+      default: 'default',
+      aliases: [{ id: 'default', label: 'default (CLI decides)' }],
+      models: [],
+    },
+  },
+  providers: {
+    anthropic: {
+      displayName: 'Anthropic API',
+      default: 'claude-sonnet-4-6',
+      aliases: [],
+      models: [
+        { id: 'claude-opus-4-8',           label: 'Opus 4.8',   tier: 'premium'  },
+        { id: 'claude-sonnet-4-6',         label: 'Sonnet 4.6', tier: 'standard', default: true },
+        { id: 'claude-haiku-4-5-20251001', label: 'Haiku 4.5',  tier: 'fast'     },
+      ],
+    },
+    openai: {
+      displayName: 'OpenAI API',
+      default: 'gpt-4.1',
+      aliases: [],
+      models: [
+        { id: 'gpt-4.1', label: 'GPT-4.1', tier: 'premium', default: true },
+        { id: 'gpt-4o',  label: 'GPT-4o',  tier: 'standard' },
+        { id: 'o4-mini', label: 'o4-mini', tier: 'fast' },
+        { id: 'o3-mini', label: 'o3-mini', tier: 'fast' },
+      ],
+    },
+  },
+};

package/lib/agents/migrate.ts

@@ -74,9 +74,19 @@ export function migrateAgentsFlatten(settings: Settings): boolean {
     }
     if (raw.type !== undefined) { delete raw.type; mutated = true; }
 
-    // 老嵌套 models.task → 扁平 model(如果 model 字段空)
-    if (!raw.model && raw.models?.task && raw.models.task !== 'default') {
-      raw.model = raw.models.task;
+    // 顶层 model 字段已被 per-use models 子表完整取代(terminal / task /
+    // telegram / help / mobile 各自可配)。0.10 之前的迁移逻辑反方向复制了
+    // models.task → model,导致 resolveTerminalLaunch 错把"task 模型"
+    // 当成"全场景兜底",新建项目终端被强插 --model。
+    //
+    // 这里反向收尾:把残留的 model 搬回 models.task(只在 task 为空或
+    // 'default' 时填,避免覆盖用户更近期的选择),然后彻底删字段。
+    if (raw.model !== undefined) {
+      if (!raw.models) raw.models = {};
+      if ((!raw.models.task || raw.models.task === 'default') && raw.model !== 'default') {
+        raw.models.task = raw.model;
+      }
+      delete raw.model;
       mutated = true;
     }
   }
@@ -116,6 +126,7 @@ function detectsLegacyShape(settings: Settings): boolean {
     if (cfg.type === 'api') return true;
     if (cfg.base !== undefined) return true;
     if (cfg.cliType !== undefined) return true;
+    if (cfg.model !== undefined) return true;     // 顶层 model 已废,改 models.task
     // 没有 tool + 是 builtin id → 也算需要迁移(补 tool 字段)
   }
   // 内置 agent 没有 tool 字段也需要补

package/lib/dirs.ts

@@ -9,7 +9,7 @@
 
 import { homedir } from 'node:os';
 import { join } from 'node:path';
-import { existsSync, mkdirSync, renameSync, copyFileSync, readFileSync } from 'node:fs';
+import { existsSync, mkdirSync, renameSync, copyFileSync } from 'node:fs';
 
 /** Shared config directory — only binaries, fixed at ~/.forge/ */
 export function getConfigDir(): string {
@@ -85,30 +85,10 @@ export function migrateDataDir(): void {
   console.log('[forge] Migration complete. Old files kept as backup.');
 }
 
-/** Claude Code home directory — skills, commands, sessions.
- *
- *  Circular-dep note: dirs ↔ settings (settings.ts imports getDataDir).
- *  Used to do `require('./settings')` here as a lazy hack — but that
- *  fires ReferenceError under ESM concurrent loads, and dirs is on
- *  the hot path for every task / connector / pipeline node.
- *
- *  Cut the cycle by reading the YAML directly here. No parser needed:
- *  we only need one field (`claudeHome`), which is plain "key: value".
- *  Falls back to ~/.claude if anything goes sideways.
- */
+/** Claude config directory — skills, commands, sessions, etc. Override
+ *  via the `CLAUDE_HOME` env var (same name claude CLI uses); defaults
+ *  to `~/.claude`. The settings.yaml `claudeHome` field was removed in
+ *  0.10.10 — set the env var if you need a non-default location. */
 export function getClaudeDir(): string {
-  if (process.env.CLAUDE_HOME) return process.env.CLAUDE_HOME;
-  try {
-    const settingsFile = join(getDataDir(), 'settings.yaml');
-    if (existsSync(settingsFile)) {
-      const raw = readFileSync(settingsFile, 'utf-8');
-      // Match a top-level `claudeHome: <value>` line. Tolerates quoted /
-      // unquoted strings and stray whitespace. Not a full YAML parser
-      // because we explicitly want to avoid loading the YAML module
-      // (and settings.ts) from this hot path.
-      const m = raw.match(/^\s*claudeHome:\s*["']?(.+?)["']?\s*$/m);
-      if (m?.[1]) return m[1].replace(/^~/, homedir());
-    }
-  } catch {}
-  return join(homedir(), '.claude');
+  return process.env.CLAUDE_HOME || join(homedir(), '.claude');
 }

package/lib/public-info/fetch.ts

@@ -0,0 +1,116 @@
+/**
+ * Generic fetch+cache helper for `forge-public-info` resources.
+ *
+ * Pattern: GitHub-hosted JSON files live under
+ *   `<publicInfoRepoUrl>/<resourceDir>/<file>.json`
+ *
+ * On read:
+ *   1. If a fresh cached copy exists (< TTL), return it.
+ *   2. Otherwise fetch from the configured `publicInfoRepoUrl`.
+ *   3. On any error (offline, 4xx, malformed JSON), return the bundled
+ *      fallback so the UI never breaks.
+ *
+ * Cache lives at `<dataDir>/public-info-cache/<resource>.json`. Each
+ * file has a sidecar `<resource>.meta.json` carrying the fetch
+ * timestamp; we don't trust HTTP `Last-Modified` because GitHub raw
+ * serves through a CDN that strips it.
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getDataDir } from '../dirs';
+import { loadSettings } from '../settings';
+
+const DEFAULT_REPO_URL = 'https://raw.githubusercontent.com/aiwatching/forge-public-info/main';
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+const FETCH_TIMEOUT_MS = 5000;
+
+interface CacheMeta { fetchedAt: number; etag?: string }
+
+function cacheDir(): string {
+  const dir = join(getDataDir(), 'public-info-cache');
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+function repoUrl(): string {
+  return (loadSettings() as any).publicInfoRepoUrl || DEFAULT_REPO_URL;
+}
+
+function cacheKey(resourcePath: string): string {
+  // public/info/models/registry.json → models-registry
+  return resourcePath.replace(/\.json$/, '').replace(/[^a-zA-Z0-9]/g, '-').replace(/^-+|-+$/g, '');
+}
+
+function readCache(resourcePath: string): { data: unknown; meta: CacheMeta } | null {
+  const key = cacheKey(resourcePath);
+  const dataPath = join(cacheDir(), `${key}.json`);
+  const metaPath = join(cacheDir(), `${key}.meta.json`);
+  if (!existsSync(dataPath) || !existsSync(metaPath)) return null;
+  try {
+    return {
+      data: JSON.parse(readFileSync(dataPath, 'utf-8')),
+      meta: JSON.parse(readFileSync(metaPath, 'utf-8')),
+    };
+  } catch {
+    return null;
+  }
+}
+
+function writeCache(resourcePath: string, data: unknown): void {
+  const key = cacheKey(resourcePath);
+  try {
+    writeFileSync(join(cacheDir(), `${key}.json`), JSON.stringify(data, null, 2), 'utf-8');
+    writeFileSync(
+      join(cacheDir(), `${key}.meta.json`),
+      JSON.stringify({ fetchedAt: Date.now() } satisfies CacheMeta, null, 2),
+      'utf-8',
+    );
+  } catch (err) {
+    console.warn('[public-info] cache write failed:', err instanceof Error ? err.message : err);
+  }
+}
+
+/**
+ * Fetch a public-info resource with built-in cache + fallback.
+ *
+ * @param resourcePath  Path under the repo, e.g. `"models/registry.json"`
+ * @param fallback      Used when network + cache both fail
+ * @param opts.forceRefresh  Skip cache TTL check (e.g., user-triggered refresh)
+ */
+export async function fetchPublicInfo<T>(
+  resourcePath: string,
+  fallback: T,
+  opts: { forceRefresh?: boolean } = {},
+): Promise<T> {
+  const now = Date.now();
+
+  // 1. Cache hit (fresh)
+  if (!opts.forceRefresh) {
+    const cached = readCache(resourcePath);
+    if (cached && now - cached.meta.fetchedAt < CACHE_TTL_MS) {
+      return cached.data as T;
+    }
+  }
+
+  // 2. Network fetch
+  const url = `${repoUrl()}/${resourcePath}`;
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+    if (res.ok) {
+      const data = await res.json();
+      writeCache(resourcePath, data);
+      return data as T;
+    }
+    console.warn(`[public-info] ${url} returned HTTP ${res.status}, using fallback`);
+  } catch (err) {
+    console.warn(`[public-info] ${url} fetch failed:`, err instanceof Error ? err.message : err);
+  }
+
+  // 3. Stale cache (better than fallback)
+  const cached = readCache(resourcePath);
+  if (cached) return cached.data as T;
+
+  // 4. Bundled fallback
+  return fallback;
+}