Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
/**
* Update Claude CLI/TUI provider defaults to the current model lineup.
*
* Two prior seeded shapes existed for `claude-code` / `claude-code-tui`:
* 1. The data.reference 4-item dated list — `claude-haiku-4-5-20251001`,
* `claude-sonnet-4-5-20250929`, `claude-opus-4-5-20251101`,
* `claude-opus-4-6` (defaultModel: `claude-opus-4-6`).
* 2. The scaffold-route 3-item dated list — `claude-haiku-4-5-20251001`,
* `claude-sonnet-4-5-20250929`, `claude-opus-4-5-20251101`
* (defaultModel: `claude-sonnet-4-5-20250929`).
*
* The current default is the undated trio (`claude-haiku-4-5`,
* `claude-sonnet-4-6`, `claude-opus-4-7`) with `claude-opus-4-7` as the
* defaultModel. Existing installs only pick this up if a migration rewrites
* their providers.json — `setup-data.js` merges *missing* provider entries
* but never updates existing ones.
*
* Conservative: only rewrites a provider when its `models` array matches one
* of the known legacy seeded shapes EXACTLY (order-sensitive). A user who
* curated their own model list (added a private endpoint, dropped sonnet,
* reordered the list, etc.) is left alone.
*
* Tier-pointer policy when a rewrite does happen:
* - `defaultModel`: if it's one of the previously *seeded* defaults
* (`claude-opus-4-6` from data.reference, `claude-sonnet-4-5-20250929`
* from the scaffold route), upgrade to the policy default
* `claude-opus-4-7`. If it's some *other* retired id (a user pinned
* haiku-/opus-4-5-dated as default), fall back to the per-model
* successor — preserving their tier intent (e.g. keep a haiku pin
* small/fast as `claude-haiku-4-5`). A pin to a still-current model
* (e.g. `claude-sonnet-4-6`) is always preserved.
* - `lightModel`/`mediumModel`/`heavyModel`: use the per-model successor
* map (haiku→haiku, sonnet→sonnet, opus→opus). Still-current pins
* are preserved.
*
* There's a third "seeded" shape — the aiToolkit fallback defaults that
* shipped before this PR also had the new-trio `models` list but kept
* `defaultModel: claude-sonnet-4-6` (with the canonical aiToolkit tier
* fingerprint light=haiku-4-5 / medium=sonnet-4-6 / heavy=opus-4-7). An
* install that picked up that shape would look "already current" by
* `models` alone but still have the old default. We detect that exact
* fingerprint and upgrade just `defaultModel` to `claude-opus-4-7`. A
* user who hand-pinned `claude-sonnet-4-6` *without* the canonical
* aiToolkit tier fingerprint is preserved.
*
* Because the retired-id map covers every member of every legacy shape, no
* tier pointer can be left referencing a model that's no longer in
* `provider.models` after the rewrite (which would otherwise break dropdowns).
* As a final safety net, any pointer that doesn't resolve to a member of
* the new `provider.models` — whether it's null/undefined/empty-string or
* points at a hand-typed/future/foreign id — is reset to its per-tier
* fallback (light=haiku-4-5, medium=sonnet-4-6, heavy/default=opus-4-7)
* so tier intent is preserved and the provider stays usable (the UI
* selector and server callers both expect every slot to be a real id).
*/
import { readFile } from 'fs/promises';
import { writeJsonAtomic } from './_lib.js';
import { join } from 'path';
const PROVIDERS_REL_PATH = 'data/providers.json';
const PRIOR_MODELS_DATA_SAMPLE = [
'claude-haiku-4-5-20251001',
'claude-sonnet-4-5-20250929',
'claude-opus-4-5-20251101',
'claude-opus-4-6',
];
const PRIOR_MODELS_SCAFFOLD = [
'claude-haiku-4-5-20251001',
'claude-sonnet-4-5-20250929',
'claude-opus-4-5-20251101',
];
const PRIOR_MODELS_SHAPES = [PRIOR_MODELS_DATA_SAMPLE, PRIOR_MODELS_SCAFFOLD];
const NEW_MODELS = ['claude-haiku-4-5', 'claude-sonnet-4-6', 'claude-opus-4-7'];
// Map of every retired Claude model id → its successor in the new trio.
// Used by tier pointers (`lightModel`/`mediumModel`/`heavyModel`) — when a
// pointer references a retired id, it's upgraded to the same-tier successor
// (keeps a haiku-pinned light slot as haiku-4-5, etc.). Pointers at still-
// current ids (e.g. `claude-sonnet-4-6`) are NOT in this map, so a hand-pin
// to a current model is always preserved. Because this covers every retired
// id, no tier pointer can be left referencing a model that's no longer in
// `provider.models` after the rewrite — keeping dropdowns/pickers consistent.
const RETIRED_TO_SUCCESSOR = {
'claude-haiku-4-5-20251001': 'claude-haiku-4-5',
'claude-sonnet-4-5-20250929': 'claude-sonnet-4-6',
'claude-opus-4-5-20251101': 'claude-opus-4-7',
'claude-opus-4-6': 'claude-opus-4-7',
};
// `defaultModel` follows a different policy than the tier pointers: when the
// existing default is one of the previously *seeded* defaults (data.reference's
// `claude-opus-4-6` or scaffold's `claude-sonnet-4-5-20250929`), upgrade to
// the policy default `claude-opus-4-7` — this is the migration's stated
// goal. For any *other* retired-id default (a user who actively pinned
// haiku-/opus-4-5-dated as their default), fall back to the per-model
// successor to preserve their tier intent (keep a haiku pin small/fast).
const SEEDED_DEFAULTS = new Set(['claude-opus-4-6', 'claude-sonnet-4-5-20250929']);
const POLICY_DEFAULT = 'claude-opus-4-7';
// Canonical aiToolkit fallback shape (models = new trio already; only the
// defaultModel is stale at `claude-sonnet-4-6`). Matching the full tier-
// pointer fingerprint avoids false positives on a hand-pinned sonnet-4-6
// — but a user who explicitly set every field to exactly the aiToolkit
// pattern *will* get bumped to opus-4-7. There's no further signal we can
// use to distinguish "I want the aiToolkit defaults" from "I want this
// exact shape", and the PR's stated goal is opus-4-7 across the board, so
// the bump is intentional.
const AITOOLKIT_SEEDED_FINGERPRINT = {
defaultModel: 'claude-sonnet-4-6',
lightModel: 'claude-haiku-4-5',
mediumModel: 'claude-sonnet-4-6',
heavyModel: 'claude-opus-4-7',
};
// When a pointer can't be resolved (orphan: not retired, not current, not
// in new models), reset to the per-tier default from the new trio. Keeps
// tier intent (a "light" slot stays small/fast even when the original pin
// was foreign). `defaultModel` / `heavyModel` fall back to POLICY_DEFAULT
// — referenced via the constant so the policy default has one source of
// truth.
const TIER_FALLBACK = {
defaultModel: POLICY_DEFAULT,
lightModel: 'claude-haiku-4-5',
mediumModel: 'claude-sonnet-4-6',
heavyModel: POLICY_DEFAULT,
};
const TIER_POINTER_KEYS = ['lightModel', 'mediumModel', 'heavyModel'];
const matchesAiToolkitSeededShape = (provider) =>
Object.entries(AITOOLKIT_SEEDED_FINGERPRINT).every(([k, v]) => provider[k] === v);
// Orphan safety net: reset every pointer that doesn't resolve to a member
// of the new `provider.models` — null, undefined, empty-string, and
// foreign ids all produce the same broken UI state. Must be called only
// after `provider.models` has been set to (or already is) NEW_MODELS.
// Mutates in place; returns true if any pointer was changed.
const normalizeOrphanPointers = (provider) => {
let changed = false;
for (const key of ['defaultModel', ...TIER_POINTER_KEYS]) {
const v = provider[key];
if (v == null || v === '' || !provider.models.includes(v)) {
provider[key] = TIER_FALLBACK[key];
changed = true;
}
}
return changed;
};
const TARGET_IDS = ['claude-code', 'claude-code-tui'];
// Order-sensitive equality. Reordering the legacy seeded list is treated as
// customization (skipped) — being maximally conservative matches the header
// comment's "left alone" promise and avoids overwriting user intent.
const sameArray = (a, b) => {
if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;
return a.every((v, i) => v === b[i]);
};
export default {
async up({ rootDir }) {
const providersPath = join(rootDir, PROVIDERS_REL_PATH);
const raw = await readFile(providersPath, 'utf-8').catch((err) => {
if (err.code === 'ENOENT') return null;
throw err;
});
if (raw == null) {
console.log(`📄 ${PROVIDERS_REL_PATH} not present — skipping (fresh install seeds from data.reference with the new defaults)`);
return;
}
let config;
try {
config = JSON.parse(raw);
} catch (err) {
console.log(`⚠️ ${PROVIDERS_REL_PATH}: invalid JSON, skipping (${err.message})`);
return;
}
const providers = config?.providers;
if (!providers || typeof providers !== 'object') {
console.log(`⚠️ ${PROVIDERS_REL_PATH}: no providers map — skipping`);
return;
}
const touched = [];
const alreadyCurrent = [];
const customized = [];
for (const id of TARGET_IDS) {
const provider = providers[id];
if (!provider) continue;
if (sameArray(provider.models, NEW_MODELS)) {
// Models already current — two reasons to still rewrite:
// 1. aiToolkit-seeded shape (new trio + stale sonnet-4-6 default).
// 2. Orphan pointer despite current models (e.g. defaultModel still
// at claude-opus-4-6, or null/empty after a hand-edit).
const isAiToolkitSeeded = matchesAiToolkitSeededShape(provider);
if (isAiToolkitSeeded) {
provider.defaultModel = POLICY_DEFAULT;
}
const orphanFixed = normalizeOrphanPointers(provider);
if (isAiToolkitSeeded || orphanFixed) {
touched.push({ id, defaultModel: provider.defaultModel });
} else {
alreadyCurrent.push(id);
}
continue;
}
if (!PRIOR_MODELS_SHAPES.some((shape) => sameArray(provider.models, shape))) {
customized.push(id);
continue;
}
provider.models = [...NEW_MODELS];
// defaultModel: seeded defaults → policy default; other retired ids → per-model successor.
if (SEEDED_DEFAULTS.has(provider.defaultModel)) {
provider.defaultModel = POLICY_DEFAULT;
} else if (RETIRED_TO_SUCCESSOR[provider.defaultModel]) {
provider.defaultModel = RETIRED_TO_SUCCESSOR[provider.defaultModel];
}
for (const key of TIER_POINTER_KEYS) {
const successor = RETIRED_TO_SUCCESSOR[provider[key]];
if (successor) {
provider[key] = successor;
}
}
// Final safety net — after the legacy-shape rewrite, fix any pointer
// that's still orphaned (null/undefined/empty/foreign-id). Same
// helper used by the already-current branch above.
normalizeOrphanPointers(provider);
touched.push({ id, defaultModel: provider.defaultModel });
}
if (touched.length === 0) {
const notes = [];
if (alreadyCurrent.length > 0) notes.push(`already current: ${alreadyCurrent.join(', ')}`);
if (customized.length > 0) notes.push(`customized: ${customized.join(', ')}`);
console.log(`✅ ${PROVIDERS_REL_PATH}: no Claude CLI/TUI changes needed${notes.length ? ` (${notes.join('; ')})` : ''}`);
return;
}
await writeJsonAtomic(providersPath, config);
const summary = touched.map((t) => `${t.id} (default: ${t.defaultModel})`).join(', ');
console.log(`📝 ${PROVIDERS_REL_PATH}: updated ${summary} → models claude-haiku-4-5 / claude-sonnet-4-6 / claude-opus-4-7`);
},
};