* docs(adr): add ADR-0003 model catalog module * fix(#3229): add shared model catalog as source of truth for agent profiles and runtime tier defaults Research / design (ADR-0003): - Existing drift came from 4 independent model truths: 1. CJS model-profiles.cjs 2. SDK config-query.ts stale copy (18 agents) 3. settings-advanced.md runtime tier table 4. session-runner Claude-only profile map - New design: one machine-readable Model Catalog Module in sdk/shared/ that both packages ship and consume. Implementation: - sdk/shared/model-catalog.json — canonical source of truth for: - full 33-agent registry - per-agent golden (quality) alias + balanced/budget aliases - adaptive derivation from routingTier - agent→phaseType map - agent→dynamic-routing default tier map - runtime tier defaults for all supported runtimes - get-shit-done/bin/lib/model-catalog.cjs — CJS adapter over the catalog - sdk/src/model-catalog.ts — SDK adapter over the same catalog - CJS model-profiles.cjs now re-exports derived data from model-catalog.cjs - SDK config-query.ts now re-exports MODEL_PROFILES/VALID_PROFILES from model-catalog.ts instead of maintaining its own list - sdk/src/query/helpers.ts runtime list now comes from the catalog (fixes hermes drift) - sdk/src/session-runner.ts Claude profile→model-id mapping now resolves via catalog - docs/CONFIGURATION.md + settings-advanced.md runtime tables updated to match catalog Behavior changes: - resolve-model now covers every shipped agent file on disk (33 agents) - unknown-agent fallback is profile-semantic, not hardcoded sonnet: quality→opus, budget→haiku, balanced/adaptive→sonnet, inherit→inherit - Group B runtimes remain known runtimes but do not get built-in tier defaults Tests (RED→GREEN): - root tests: shipped agent files must equal MODEL_PROFILES keys - sdk tests: shipped agent files must equal MODEL_PROFILES keys - direct fix assertion: gsd-code-reviewer resolves to opus under quality with no unknown_agent - runtime defaults parity test: settings-advanced.md + CONFIGURATION.md tables must match catalog - helper tests: hermes included in SUPPORTED_RUNTIMES and getRuntimeConfigDir() Closes #3229 * chore(changeset): update #3229 changeset pr field to 3230 * fix(ci): update inherit fallback expectations and inventory parity for model catalog
93 lines
3.1 KiB
JavaScript
93 lines
3.1 KiB
JavaScript
'use strict';
|
|
|
|
const path = require('node:path');
|
|
const catalog = require(path.join(__dirname, '..', '..', '..', 'sdk', 'shared', 'model-catalog.json'));
|
|
|
|
const VALID_PROFILES = [...catalog.profiles];
|
|
const VALID_PHASE_TYPES = new Set(catalog.phaseTypes);
|
|
const VALID_AGENT_TIERS = new Set(Object.keys(catalog.adaptiveTierMap));
|
|
|
|
const MODEL_PROFILES = Object.fromEntries(
|
|
Object.entries(catalog.agents).map(([agent, meta]) => [agent, {
|
|
quality: meta.golden,
|
|
balanced: meta.balanced,
|
|
budget: meta.budget,
|
|
adaptive: catalog.adaptiveTierMap[meta.routingTier],
|
|
}])
|
|
);
|
|
|
|
const AGENT_TO_PHASE_TYPE = Object.fromEntries(
|
|
Object.entries(catalog.agents).map(([agent, meta]) => [agent, meta.phaseType])
|
|
);
|
|
|
|
const AGENT_DEFAULT_TIERS = Object.fromEntries(
|
|
Object.entries(catalog.agents).map(([agent, meta]) => [agent, meta.routingTier])
|
|
);
|
|
|
|
const MODEL_ALIAS_MAP = Object.fromEntries(
|
|
Object.entries(catalog.runtimeTierDefaults.claude).map(([tier, entry]) => [tier, entry?.model])
|
|
);
|
|
|
|
const RUNTIME_PROFILE_MAP = Object.fromEntries(
|
|
Object.entries(catalog.runtimeTierDefaults)
|
|
.map(([runtime, tiers]) => [
|
|
runtime,
|
|
Object.fromEntries(
|
|
Object.entries(tiers).filter(([, entry]) => entry).map(([tier, entry]) => [tier, entry])
|
|
),
|
|
])
|
|
.filter(([, tiers]) => Object.keys(tiers).length > 0)
|
|
);
|
|
|
|
const KNOWN_RUNTIMES = new Set(Object.keys(catalog.runtimeTierDefaults));
|
|
const RUNTIMES_WITH_REASONING_EFFORT = new Set(
|
|
Object.entries(catalog.runtimeTierDefaults)
|
|
.filter(([, tiers]) => Object.values(tiers).some((entry) => entry && entry.reasoning_effort))
|
|
.map(([runtime]) => runtime)
|
|
);
|
|
|
|
function nextTier(currentTier) {
|
|
const order = ['light', 'standard', 'heavy'];
|
|
const idx = order.indexOf(String(currentTier));
|
|
if (idx === -1) return null;
|
|
return order[Math.min(idx + 1, order.length - 1)];
|
|
}
|
|
|
|
function formatAgentToModelMapAsTable(agentToModelMap) {
|
|
const agentWidth = Math.max('Agent'.length, ...Object.keys(agentToModelMap).map((a) => a.length));
|
|
const modelWidth = Math.max('Model'.length, ...Object.values(agentToModelMap).map((m) => m.length));
|
|
const sep = '─'.repeat(agentWidth + 2) + '┼' + '─'.repeat(modelWidth + 2);
|
|
const header = ` ${'Agent'.padEnd(agentWidth)} │ ${'Model'.padEnd(modelWidth)}`;
|
|
let out = `${header}\n${sep}\n`;
|
|
for (const [agent, model] of Object.entries(agentToModelMap)) {
|
|
out += ` ${agent.padEnd(agentWidth)} │ ${model.padEnd(modelWidth)}\n`;
|
|
}
|
|
return out;
|
|
}
|
|
|
|
function getAgentToModelMapForProfile(normalizedProfile) {
|
|
const profile = VALID_PROFILES.includes(normalizedProfile) ? normalizedProfile : 'balanced';
|
|
const out = {};
|
|
for (const [agent, profiles] of Object.entries(MODEL_PROFILES)) {
|
|
out[agent] = profile === 'inherit' ? 'inherit' : profiles[profile];
|
|
}
|
|
return out;
|
|
}
|
|
|
|
module.exports = {
|
|
catalog,
|
|
MODEL_PROFILES,
|
|
VALID_PROFILES,
|
|
AGENT_TO_PHASE_TYPE,
|
|
VALID_PHASE_TYPES,
|
|
AGENT_DEFAULT_TIERS,
|
|
VALID_AGENT_TIERS,
|
|
MODEL_ALIAS_MAP,
|
|
RUNTIME_PROFILE_MAP,
|
|
KNOWN_RUNTIMES,
|
|
RUNTIMES_WITH_REASONING_EFFORT,
|
|
nextTier,
|
|
formatAgentToModelMapAsTable,
|
|
getAgentToModelMapForProfile,
|
|
};
|