Files
Profa 2253d05618 feat: flatten project structure — archive v2, promote v3 to root
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>
2026-03-01 11:35:41 +00:00

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

References