mirror of
https://github.com/proffesor-for-testing/agentic-qe.git
synced 2026-09-19 08:45:47 +08:00
2253d05618
Remove the nested v3/ subdirectory by moving all active source code, tests, configs, and assets directly to the project root. Archive v2/ (dead code, 847MB) to v2-archive.tar.gz. Key changes: - Move v3/src/ → src/, v3/tests/ → tests/, v3/packages/ → packages/ - Move v3/tsconfig.json, v3/vitest.config.ts to root - Merge v3/package.json into root package.json (ESM, scripts, deps, exports) - Merge v3/scripts/ into scripts/, v3/implementation/ into docs/implementation/ - Update all CI workflows to remove "cd v3 &&" and v3/ path prefixes - Fix all init installer path resolution (3-level-up → 2-level-up) - Fix hooks to use "node ./dist/cli/bundle.js" instead of bare "aqe" - Update settings.json ADR/DDD directories to docs/implementation/ - Fix helper scripts (statusline, adr-compliance, ddd-tracker, guidance-hooks) - Update 58 agent definitions: aqe/v3/ → aqe/ memory namespaces - Update 15 guidance shards: v3/src/ → src/ path references - Fix sync interfaces: remove v3/ and v2/ path references - Fix test path calculations (process.cwd() + '..' no longer needed) - Fix flaky perf test threshold (500ms → 1000ms for CI environments) - Fix complexity-analyzer test to match ADR-051 keyword-based eligibility Build passes, 17,901 tests pass, CLI and MCP bundles verified. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
4.0 KiB
4.0 KiB
SPEC-043-C: Model ID Mapping
| Field | Value |
|---|---|
| Specification ID | SPEC-043-C |
| Parent ADR | ADR-043 |
| Version | 1.0 |
| Status | Implemented |
| Last Updated | 2026-01-15 |
| Author | Architecture Team |
Overview
This specification defines the bidirectional model ID mapping system that enables vendor-independent model references across all supported providers.
Model Mapping Structure
const MODEL_MAPPINGS = {
'claude-sonnet-4.5': {
anthropic: 'claude-sonnet-4-5-20250929',
openrouter: 'anthropic/claude-sonnet-4.5',
bedrock: 'anthropic.claude-sonnet-4-5-v2:0',
canonical: 'Claude Sonnet 4.5'
},
'claude-opus-4': {
anthropic: 'claude-opus-4-20250514',
openrouter: 'anthropic/claude-opus-4',
bedrock: 'anthropic.claude-opus-4-v1:0',
canonical: 'Claude Opus 4'
},
'gpt-4o': {
openai: 'gpt-4o',
azure: 'gpt-4o',
openrouter: 'openai/gpt-4o',
canonical: 'GPT-4o'
},
'gpt-4-turbo': {
openai: 'gpt-4-turbo',
azure: 'gpt-4-turbo',
openrouter: 'openai/gpt-4-turbo',
canonical: 'GPT-4 Turbo'
},
'gemini-pro': {
gemini: 'gemini-pro',
openrouter: 'google/gemini-pro',
canonical: 'Gemini Pro'
},
'llama-3-70b': {
ollama: 'llama3:70b',
openrouter: 'meta-llama/llama-3-70b-instruct',
bedrock: 'meta.llama3-70b-instruct-v1:0',
canonical: 'Llama 3 70B'
}
};
Mapping Functions
/**
* Map a canonical model ID to provider-specific ID
*/
function mapModelId(modelId: string, targetProvider: ProviderType): string {
const mapping = MODEL_MAPPINGS[modelId];
if (!mapping) {
return modelId; // Pass through unknown models
}
return mapping[targetProvider] || modelId;
}
/**
* Reverse lookup: find canonical ID from provider-specific ID
*/
function reverseMapModelId(providerModelId: string, sourceProvider: ProviderType): string {
for (const [canonical, mapping] of Object.entries(MODEL_MAPPINGS)) {
if (mapping[sourceProvider] === providerModelId) {
return canonical;
}
}
return providerModelId;
}
/**
* Get all available mappings for a model
*/
function getModelAvailability(modelId: string): ProviderType[] {
const mapping = MODEL_MAPPINGS[modelId];
if (!mapping) return [];
return Object.keys(mapping).filter(k => k !== 'canonical') as ProviderType[];
}
Model Registry
interface ModelMetadata {
canonical: string;
contextWindow: number;
maxOutputTokens: number;
supportsTools: boolean;
supportsStreaming: boolean;
costPer1kInput: number;
costPer1kOutput: number;
latencyMs: number; // Estimated P50
}
const MODEL_REGISTRY: Record<string, ModelMetadata> = {
'claude-sonnet-4.5': {
canonical: 'Claude Sonnet 4.5',
contextWindow: 200000,
maxOutputTokens: 8192,
supportsTools: true,
supportsStreaming: true,
costPer1kInput: 0.003,
costPer1kOutput: 0.015,
latencyMs: 1200
},
// ... additional models
};
Implementation Files
| File | LOC | Description |
|---|---|---|
src/shared/llm/model-mapping.ts |
300 | Bidirectional mapping functions |
src/shared/llm/model-registry.ts |
250 | Model metadata and capabilities |
Validation Rules
| Rule ID | Description | Severity |
|---|---|---|
| SPEC-043-C-001 | All mapped models must have canonical name | Error |
| SPEC-043-C-002 | Provider-specific IDs must be unique per provider | Error |
| SPEC-043-C-003 | Unknown models should pass through unchanged | Warning |
Changelog
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0 | 2026-01-15 | Architecture Team | Initial specification |