@devtrack-solution/codesdd 1.2.3 → 1.2.4

package/dist/core/sdd/api-foundation-parity.d.ts

@@ -0,0 +1,114 @@
+export declare const CODESDD_FULL_FOUNDATION_COMPATIBLE_PROFILE_ID = "full-foundation-compatible";
+export declare const CODESDD_FULL_FOUNDATION_PARITY_MATRIX: {
+    readonly id: "full-foundation-compatible-parity-matrix";
+    readonly version: 1;
+    readonly profile_id: "full-foundation-compatible";
+    readonly foundation_reference: "devtrack-foundation-api";
+};
+export declare const CODESDD_FULL_FOUNDATION_PARITY_DIMENSIONS: readonly ["architecture-roots", "contract-boundaries", "api-documentation", "env-and-runtime-config", "package-scripts", "auth-and-authorization", "persistence-typeorm", "validation-and-errors", "evidence-and-quality-gates"];
+export declare const CODESDD_FULL_FOUNDATION_PARITY_QUALITY_GATES: readonly ["foundation-parity-matrix-required", "foundation-architecture-roots-parity", "foundation-contract-boundaries-parity", "foundation-api-documentation-parity", "foundation-env-runtime-config-parity", "foundation-package-scripts-parity", "foundation-auth-authorization-parity", "foundation-typeorm-persistence-parity", "foundation-validation-errors-parity", "foundation-evidence-quality-gates-parity"];
+export type CodeSddFullFoundationParityDimensionId = (typeof CODESDD_FULL_FOUNDATION_PARITY_DIMENSIONS)[number];
+export interface CodeSddFullFoundationParityDimension {
+    id: CodeSddFullFoundationParityDimensionId;
+    title: string;
+    foundation_reference: typeof CODESDD_FULL_FOUNDATION_PARITY_MATRIX.foundation_reference;
+    severity: 'P0';
+    quality_gate: (typeof CODESDD_FULL_FOUNDATION_PARITY_QUALITY_GATES)[number];
+    contract_rule_refs: readonly string[];
+    required_artifacts: readonly string[];
+    required_evidence: readonly string[];
+}
+export declare const CODESDD_FULL_FOUNDATION_PARITY_DIMENSION_DEFINITIONS: {
+    'architecture-roots': {
+        id: "architecture-roots";
+        title: string;
+        foundation_reference: "devtrack-foundation-api";
+        severity: "P0";
+        quality_gate: "foundation-architecture-roots-parity";
+        contract_rule_refs: string[];
+        required_artifacts: string[];
+        required_evidence: string[];
+    };
+    'contract-boundaries': {
+        id: "contract-boundaries";
+        title: string;
+        foundation_reference: "devtrack-foundation-api";
+        severity: "P0";
+        quality_gate: "foundation-contract-boundaries-parity";
+        contract_rule_refs: string[];
+        required_artifacts: string[];
+        required_evidence: string[];
+    };
+    'api-documentation': {
+        id: "api-documentation";
+        title: string;
+        foundation_reference: "devtrack-foundation-api";
+        severity: "P0";
+        quality_gate: "foundation-api-documentation-parity";
+        contract_rule_refs: string[];
+        required_artifacts: string[];
+        required_evidence: string[];
+    };
+    'env-and-runtime-config': {
+        id: "env-and-runtime-config";
+        title: string;
+        foundation_reference: "devtrack-foundation-api";
+        severity: "P0";
+        quality_gate: "foundation-env-runtime-config-parity";
+        contract_rule_refs: string[];
+        required_artifacts: string[];
+        required_evidence: string[];
+    };
+    'package-scripts': {
+        id: "package-scripts";
+        title: string;
+        foundation_reference: "devtrack-foundation-api";
+        severity: "P0";
+        quality_gate: "foundation-package-scripts-parity";
+        contract_rule_refs: string[];
+        required_artifacts: string[];
+        required_evidence: string[];
+    };
+    'auth-and-authorization': {
+        id: "auth-and-authorization";
+        title: string;
+        foundation_reference: "devtrack-foundation-api";
+        severity: "P0";
+        quality_gate: "foundation-auth-authorization-parity";
+        contract_rule_refs: string[];
+        required_artifacts: string[];
+        required_evidence: string[];
+    };
+    'persistence-typeorm': {
+        id: "persistence-typeorm";
+        title: string;
+        foundation_reference: "devtrack-foundation-api";
+        severity: "P0";
+        quality_gate: "foundation-typeorm-persistence-parity";
+        contract_rule_refs: string[];
+        required_artifacts: string[];
+        required_evidence: string[];
+    };
+    'validation-and-errors': {
+        id: "validation-and-errors";
+        title: string;
+        foundation_reference: "devtrack-foundation-api";
+        severity: "P0";
+        quality_gate: "foundation-validation-errors-parity";
+        contract_rule_refs: string[];
+        required_artifacts: string[];
+        required_evidence: string[];
+    };
+    'evidence-and-quality-gates': {
+        id: "evidence-and-quality-gates";
+        title: string;
+        foundation_reference: "devtrack-foundation-api";
+        severity: "P0";
+        quality_gate: "foundation-evidence-quality-gates-parity";
+        contract_rule_refs: string[];
+        required_artifacts: string[];
+        required_evidence: string[];
+    };
+};
+export declare function getCodeSddFullFoundationParityMatrix(): CodeSddFullFoundationParityDimension[];
+//# sourceMappingURL=api-foundation-parity.d.ts.map

package/dist/core/sdd/api-foundation-parity.js

@@ -0,0 +1,131 @@
+export const CODESDD_FULL_FOUNDATION_COMPATIBLE_PROFILE_ID = 'full-foundation-compatible';
+export const CODESDD_FULL_FOUNDATION_PARITY_MATRIX = {
+    id: 'full-foundation-compatible-parity-matrix',
+    version: 1,
+    profile_id: CODESDD_FULL_FOUNDATION_COMPATIBLE_PROFILE_ID,
+    foundation_reference: 'devtrack-foundation-api',
+};
+export const CODESDD_FULL_FOUNDATION_PARITY_DIMENSIONS = [
+    'architecture-roots',
+    'contract-boundaries',
+    'api-documentation',
+    'env-and-runtime-config',
+    'package-scripts',
+    'auth-and-authorization',
+    'persistence-typeorm',
+    'validation-and-errors',
+    'evidence-and-quality-gates',
+];
+export const CODESDD_FULL_FOUNDATION_PARITY_QUALITY_GATES = [
+    'foundation-parity-matrix-required',
+    'foundation-architecture-roots-parity',
+    'foundation-contract-boundaries-parity',
+    'foundation-api-documentation-parity',
+    'foundation-env-runtime-config-parity',
+    'foundation-package-scripts-parity',
+    'foundation-auth-authorization-parity',
+    'foundation-typeorm-persistence-parity',
+    'foundation-validation-errors-parity',
+    'foundation-evidence-quality-gates-parity',
+];
+export const CODESDD_FULL_FOUNDATION_PARITY_DIMENSION_DEFINITIONS = {
+    'architecture-roots': {
+        id: 'architecture-roots',
+        title: 'Foundation-compatible source roots',
+        foundation_reference: 'devtrack-foundation-api',
+        severity: 'P0',
+        quality_gate: 'foundation-architecture-roots-parity',
+        contract_rule_refs: ['DTAPI-P0-FULL-FOUNDATION-PARITY-001', 'DTAPI-P0-PATH-001', 'DTAPI-P0-IMPORTS-001'],
+        required_artifacts: ['src/application/**', 'src/domain/**', 'src/infrastructure/**', 'src/presentation/**', 'src/shared/**'],
+        required_evidence: ['generated roots use Foundation-compatible singular output structure', 'artifact map records Foundation source references'],
+    },
+    'contract-boundaries': {
+        id: 'contract-boundaries',
+        title: 'Application and domain contract boundaries',
+        foundation_reference: 'devtrack-foundation-api',
+        severity: 'P0',
+        quality_gate: 'foundation-contract-boundaries-parity',
+        contract_rule_refs: ['DTAPI-P0-FULL-FOUNDATION-PARITY-001', 'DTAPI-P0-COMPOSITION-001', 'DTAPI-P0-PORTS-001'],
+        required_artifacts: ['src/application/**/ports/**', 'src/application/**/use-cases/**', 'src/domain/**'],
+        required_evidence: ['ports and use cases are present for user-facing flows', 'presentation does not call infrastructure directly'],
+    },
+    'api-documentation': {
+        id: 'api-documentation',
+        title: 'Swagger/OpenAPI parity',
+        foundation_reference: 'devtrack-foundation-api',
+        severity: 'P0',
+        quality_gate: 'foundation-api-documentation-parity',
+        contract_rule_refs: ['DTAPI-P0-FULL-FOUNDATION-PARITY-001', 'DTAPI-P0-OPENAPI-001'],
+        required_artifacts: ['src/main.ts', 'src/presentation/rest/**', '.env.example'],
+        required_evidence: ['Swagger bootstrap and /docs route are present', 'controllers and DTOs expose documented request and response shapes'],
+    },
+    'env-and-runtime-config': {
+        id: 'env-and-runtime-config',
+        title: 'Environment and typed runtime configuration parity',
+        foundation_reference: 'devtrack-foundation-api',
+        severity: 'P0',
+        quality_gate: 'foundation-env-runtime-config-parity',
+        contract_rule_refs: ['DTAPI-P0-FULL-FOUNDATION-PARITY-001', 'DTAPI-P0-TOOL-BASELINE-001'],
+        required_artifacts: ['.env.example', 'src/infrastructure/settings/**'],
+        required_evidence: ['all runtime variables are represented as placeholders', 'typed configuration reads environment without exposing secrets'],
+    },
+    'package-scripts': {
+        id: 'package-scripts',
+        title: 'Package scripts and operational bootstrap parity',
+        foundation_reference: 'devtrack-foundation-api',
+        severity: 'P0',
+        quality_gate: 'foundation-package-scripts-parity',
+        contract_rule_refs: ['DTAPI-P0-FULL-FOUNDATION-PARITY-001', 'DTAPI-P0-TOOL-BASELINE-001', 'DTAPI-P0-RUNTIME-SCRIPTS-001'],
+        required_artifacts: ['package.json', 'scripts/cleanup.sh', 'scripts/kill-port.js'],
+        required_evidence: [
+            'build, lint, test, coverage, e2e, cleanup, cleanup:install, start, start:dev, and start:prod scripts are present',
+            'start and start:dev kill the configured port listener before continuing bootstrap',
+            'nested package-script calls use npm run/npm install so npm and pnpm invocations both work without requiring pnpm in Docker',
+            'migration scripts are present when persistence is included',
+        ],
+    },
+    'auth-and-authorization': {
+        id: 'auth-and-authorization',
+        title: 'Authentication, authorization, guards, and security docs parity',
+        foundation_reference: 'devtrack-foundation-api',
+        severity: 'P0',
+        quality_gate: 'foundation-auth-authorization-parity',
+        contract_rule_refs: ['DTAPI-P0-FULL-FOUNDATION-PARITY-001', 'DTAPI-P0-AUTH-PLAN-001', 'DTAPI-P0-OPENAPI-001'],
+        required_artifacts: ['src/presentation/**/guards/**', 'src/presentation/**/decorators/**', 'FEAT quality evidence'],
+        required_evidence: ['auth/authz decisions are recorded', 'protected routes include guards/decorators and documented security schemes'],
+    },
+    'persistence-typeorm': {
+        id: 'persistence-typeorm',
+        title: 'TypeORM persistence parity',
+        foundation_reference: 'devtrack-foundation-api',
+        severity: 'P0',
+        quality_gate: 'foundation-typeorm-persistence-parity',
+        contract_rule_refs: ['DTAPI-P0-FULL-FOUNDATION-PARITY-001', 'DTAPI-P0-TYPEORM-001', 'DTAPI-P1-RUNTIME-001'],
+        required_artifacts: ['src/infrastructure/adapters/orm/typeorm.module.ts', 'src/infrastructure/adapters/orm/*-orm.module.ts', 'src/infrastructure/adapters/orm/**', 'src/application/**/ports/out/**'],
+        required_evidence: ['persistence uses TypeORM only', 'typeorm.module.ts owns root TypeORM wiring', '<context>-orm.module.ts exports repository/service port providers', 'application depends on output ports instead of ORM entities'],
+    },
+    'validation-and-errors': {
+        id: 'validation-and-errors',
+        title: 'Validation and structured API errors parity',
+        foundation_reference: 'devtrack-foundation-api',
+        severity: 'P0',
+        quality_gate: 'foundation-validation-errors-parity',
+        contract_rule_refs: ['DTAPI-P0-FULL-FOUNDATION-PARITY-001', 'DTAPI-P0-USECASE-001', 'DTAPI-P0-OPENAPI-001'],
+        required_artifacts: ['src/main.ts', 'src/presentation/**/dtos/**', 'src/presentation/dtos/api-error-response.dto.ts'],
+        required_evidence: ['validation pipe is configured', 'DTO validators and structured error response docs are present'],
+    },
+    'evidence-and-quality-gates': {
+        id: 'evidence-and-quality-gates',
+        title: 'Evidence manifest and quality gates parity',
+        foundation_reference: 'devtrack-foundation-api',
+        severity: 'P0',
+        quality_gate: 'foundation-evidence-quality-gates-parity',
+        contract_rule_refs: ['DTAPI-P0-FULL-FOUNDATION-PARITY-001', 'DTAPI-P1-EVIDENCE-001'],
+        required_artifacts: ['.sdd/plugin-evidence/**', 'coverage/**', 'test/**'],
+        required_evidence: ['artifact and evidence manifests are emitted', 'validation commands and FEAT quality evidence are recorded'],
+    },
+};
+export function getCodeSddFullFoundationParityMatrix() {
+    return CODESDD_FULL_FOUNDATION_PARITY_DIMENSIONS.map((dimensionId) => CODESDD_FULL_FOUNDATION_PARITY_DIMENSION_DEFINITIONS[dimensionId]);
+}
+//# sourceMappingURL=api-foundation-parity.js.map

package/dist/core/sdd/api-profile-catalog.d.ts

@@ -0,0 +1,36 @@
+import { CODESDD_FULL_FOUNDATION_PARITY_DIMENSIONS, CODESDD_FULL_FOUNDATION_PARITY_MATRIX } from './api-foundation-parity.js';
+export declare const CODESDD_API_PROFILE_FAMILY_ID = "codesdd-api-profile-family";
+export declare const LEGACY_DEVTRACK_API_PROFILE_ALIAS = "devtrack-api";
+export { CODESDD_API_FOUNDATION_SHARED_BASELINE, CODESDD_API_SHARED_BASELINE_QUALITY_GATES, CODESDD_API_SHARED_BASELINE_REQUIREMENT_DEFINITIONS, CODESDD_API_SHARED_BASELINE_REQUIREMENTS, getCodeSddApiSharedBaselineRequirements, type CodeSddApiSharedBaselineRequirement, type CodeSddApiSharedBaselineRequirementId, } from './api-foundation-baseline.js';
+export { CODESDD_FULL_FOUNDATION_COMPATIBLE_PROFILE_ID, CODESDD_FULL_FOUNDATION_PARITY_DIMENSION_DEFINITIONS, CODESDD_FULL_FOUNDATION_PARITY_DIMENSIONS, CODESDD_FULL_FOUNDATION_PARITY_MATRIX, CODESDD_FULL_FOUNDATION_PARITY_QUALITY_GATES, getCodeSddFullFoundationParityMatrix, type CodeSddFullFoundationParityDimension, type CodeSddFullFoundationParityDimensionId, } from './api-foundation-parity.js';
+export { CODESDD_AI_AGENT_API_PROFILE_QUALITY_GATES, CODESDD_AI_AGENT_API_PROFILE_RECIPE, CODESDD_AI_AGENT_API_PROFILE_VALIDATION_COMMANDS, CODESDD_API_MANDATORY_CLEANUP_SCRIPT_MARKERS, CODESDD_API_MANDATORY_KILL_PORT_SCRIPT_MARKERS, CODESDD_API_MANDATORY_PACKAGE_SCRIPT_MARKERS, CODESDD_API_PROFILE_RECIPE_CONTRACT, CODESDD_EVENTED_API_PROFILE_QUALITY_GATES, CODESDD_EVENTED_API_PROFILE_RECIPE, CODESDD_EVENTED_API_PROFILE_VALIDATION_COMMANDS, CODESDD_MINIMAL_REST_PROFILE_QUALITY_GATES, CODESDD_MINIMAL_REST_PROFILE_RECIPE, CODESDD_MINIMAL_REST_PROFILE_VALIDATION_COMMANDS, CODESDD_REST_AUTH_RBAC_PROFILE_QUALITY_GATES, CODESDD_REST_AUTH_RBAC_PROFILE_RECIPE, CODESDD_REST_AUTH_RBAC_PROFILE_VALIDATION_COMMANDS, CODESDD_REST_CRUD_TYPEORM_PROFILE_QUALITY_GATES, CODESDD_REST_CRUD_TYPEORM_PROFILE_RECIPE, CODESDD_REST_CRUD_TYPEORM_PROFILE_VALIDATION_COMMANDS, validateAiAgentApiProfileRecipe, validateEventedApiProfileRecipe, validateMinimalRestProfileRecipe, validateRestAuthRbacProfileRecipe, validateRestCrudTypeormProfileRecipe, type CodeSddApiProfileRecipe, type CodeSddApiProfileRecipeArtifact, type CodeSddApiProfileRecipeArtifactCategory, type CodeSddApiProfileRecipeValidationFindingCode, type CodeSddApiProfileRecipeValidationFinding, type CodeSddApiProfileRecipeValidationInput, type CodeSddApiProfileRecipeValidationResult, } from './api-profile-recipes.js';
+export declare const CODESDD_API_PROFILE_IDS: readonly ["minimal-rest", "rest-auth-rbac", "rest-crud-typeorm", "evented-api", "ai-agent-api", "full-foundation-compatible"];
+export type CodeSddApiProfileId = (typeof CODESDD_API_PROFILE_IDS)[number];
+export declare const DEFAULT_CODESDD_API_PROFILE_ID: CodeSddApiProfileId;
+export declare const DEFAULT_DEVTRACK_API_ALIAS_PROFILE_ID: CodeSddApiProfileId;
+export interface CodeSddApiProfileDefinition {
+    id: CodeSddApiProfileId;
+    title: string;
+    summary: string;
+    foundation_reference: 'devtrack-foundation-api';
+    inherits_shared_baseline: true;
+    selection_triggers: string[];
+    adds: string[];
+    required_proof: string[];
+    parity_matrix_ref?: typeof CODESDD_FULL_FOUNDATION_PARITY_MATRIX.id;
+    parity_dimensions?: typeof CODESDD_FULL_FOUNDATION_PARITY_DIMENSIONS;
+}
+export interface ResolvedCodeSddApiProfile {
+    family_id: typeof CODESDD_API_PROFILE_FAMILY_ID;
+    input: string | undefined;
+    profile_id: CodeSddApiProfileId;
+    legacy_alias: boolean;
+    migration_notice?: string;
+}
+export declare const CODESDD_API_PROFILE_DEFINITIONS: Record<CodeSddApiProfileId, CodeSddApiProfileDefinition>;
+export declare function isCodeSddApiProfileId(value: string): value is CodeSddApiProfileId;
+export declare function resolveCodeSddApiProfile(value?: string, options?: {
+    defaultProfile?: CodeSddApiProfileId;
+}): ResolvedCodeSddApiProfile;
+export declare function selectCodeSddApiProfileFromIntent(intent: string): CodeSddApiProfileId;
+//# sourceMappingURL=api-profile-catalog.d.ts.map

package/dist/core/sdd/api-profile-catalog.js

@@ -0,0 +1,132 @@
+import { CODESDD_FULL_FOUNDATION_PARITY_DIMENSIONS, CODESDD_FULL_FOUNDATION_PARITY_MATRIX, } from './api-foundation-parity.js';
+export const CODESDD_API_PROFILE_FAMILY_ID = 'codesdd-api-profile-family';
+export const LEGACY_DEVTRACK_API_PROFILE_ALIAS = 'devtrack-api';
+export { CODESDD_API_FOUNDATION_SHARED_BASELINE, CODESDD_API_SHARED_BASELINE_QUALITY_GATES, CODESDD_API_SHARED_BASELINE_REQUIREMENT_DEFINITIONS, CODESDD_API_SHARED_BASELINE_REQUIREMENTS, getCodeSddApiSharedBaselineRequirements, } from './api-foundation-baseline.js';
+export { CODESDD_FULL_FOUNDATION_COMPATIBLE_PROFILE_ID, CODESDD_FULL_FOUNDATION_PARITY_DIMENSION_DEFINITIONS, CODESDD_FULL_FOUNDATION_PARITY_DIMENSIONS, CODESDD_FULL_FOUNDATION_PARITY_MATRIX, CODESDD_FULL_FOUNDATION_PARITY_QUALITY_GATES, getCodeSddFullFoundationParityMatrix, } from './api-foundation-parity.js';
+export { CODESDD_AI_AGENT_API_PROFILE_QUALITY_GATES, CODESDD_AI_AGENT_API_PROFILE_RECIPE, CODESDD_AI_AGENT_API_PROFILE_VALIDATION_COMMANDS, CODESDD_API_MANDATORY_CLEANUP_SCRIPT_MARKERS, CODESDD_API_MANDATORY_KILL_PORT_SCRIPT_MARKERS, CODESDD_API_MANDATORY_PACKAGE_SCRIPT_MARKERS, CODESDD_API_PROFILE_RECIPE_CONTRACT, CODESDD_EVENTED_API_PROFILE_QUALITY_GATES, CODESDD_EVENTED_API_PROFILE_RECIPE, CODESDD_EVENTED_API_PROFILE_VALIDATION_COMMANDS, CODESDD_MINIMAL_REST_PROFILE_QUALITY_GATES, CODESDD_MINIMAL_REST_PROFILE_RECIPE, CODESDD_MINIMAL_REST_PROFILE_VALIDATION_COMMANDS, CODESDD_REST_AUTH_RBAC_PROFILE_QUALITY_GATES, CODESDD_REST_AUTH_RBAC_PROFILE_RECIPE, CODESDD_REST_AUTH_RBAC_PROFILE_VALIDATION_COMMANDS, CODESDD_REST_CRUD_TYPEORM_PROFILE_QUALITY_GATES, CODESDD_REST_CRUD_TYPEORM_PROFILE_RECIPE, CODESDD_REST_CRUD_TYPEORM_PROFILE_VALIDATION_COMMANDS, validateAiAgentApiProfileRecipe, validateEventedApiProfileRecipe, validateMinimalRestProfileRecipe, validateRestAuthRbacProfileRecipe, validateRestCrudTypeormProfileRecipe, } from './api-profile-recipes.js';
+export const CODESDD_API_PROFILE_IDS = [
+    'minimal-rest',
+    'rest-auth-rbac',
+    'rest-crud-typeorm',
+    'evented-api',
+    'ai-agent-api',
+    'full-foundation-compatible',
+];
+const CODESDD_API_PROFILE_SELECTION_ORDER = [
+    'rest-auth-rbac',
+    'rest-crud-typeorm',
+    'evented-api',
+    'ai-agent-api',
+    'full-foundation-compatible',
+    'minimal-rest',
+];
+export const DEFAULT_CODESDD_API_PROFILE_ID = 'minimal-rest';
+export const DEFAULT_DEVTRACK_API_ALIAS_PROFILE_ID = 'full-foundation-compatible';
+export const CODESDD_API_PROFILE_DEFINITIONS = {
+    'minimal-rest': {
+        id: 'minimal-rest',
+        title: 'Minimal REST',
+        summary: 'Smallest production-grade REST API baseline.',
+        foundation_reference: 'devtrack-foundation-api',
+        inherits_shared_baseline: true,
+        selection_triggers: ['api', 'rest', 'minimal', 'endpoint', 'route'],
+        adds: ['health route', 'root REST module', 'controller DTOs', 'single use-case slice'],
+        required_proof: ['OpenAPI docs', '.env.example', 'package scripts', 'route/use-case tests'],
+    },
+    'rest-auth-rbac': {
+        id: 'rest-auth-rbac',
+        title: 'REST Auth RBAC',
+        summary: 'REST API with authentication, authorization, guards, and permission boundaries.',
+        foundation_reference: 'devtrack-foundation-api',
+        inherits_shared_baseline: true,
+        selection_triggers: ['auth', 'authentication', 'authorization', 'rbac', 'permission', 'guard'],
+        adds: ['auth strategy', 'route guards', 'permission decorators', 'current-user boundary', 'RBAC policy examples'],
+        required_proof: ['protected OpenAPI docs', 'allow/deny route tests', 'guard/decorator artifacts'],
+    },
+    'rest-crud-typeorm': {
+        id: 'rest-crud-typeorm',
+        title: 'REST CRUD TypeORM',
+        summary: 'REST CRUD API with TypeORM persistence and application/repository boundaries.',
+        foundation_reference: 'devtrack-foundation-api',
+        inherits_shared_baseline: true,
+        selection_triggers: ['crud', 'typeorm', 'database', 'entity', 'repository', 'migration'],
+        adds: ['TypeORM entity', 'repository port', 'migration scripts', 'pagination', 'filtering', 'uniqueness checks'],
+        required_proof: ['repository boundary tests', 'migration script evidence', 'CRUD integration evidence'],
+    },
+    'evented-api': {
+        id: 'evented-api',
+        title: 'Evented API',
+        summary: 'API with application events, handlers, queue delivery, idempotency, and retry policy.',
+        foundation_reference: 'devtrack-foundation-api',
+        inherits_shared_baseline: true,
+        selection_triggers: ['event', 'events', 'outbox', 'queue', 'handler', 'idempotency', 'retry'],
+        adds: ['application event contracts', 'application handlers', 'queue delivery strategy', 'idempotency', 'retry/error policy'],
+        required_proof: ['event contract docs', 'handler tests', 'idempotency/retry evidence'],
+    },
+    'ai-agent-api': {
+        id: 'ai-agent-api',
+        title: 'AI Agent API',
+        summary: 'API for AI agent workflows with tool boundaries, safety, redaction, and deterministic tests.',
+        foundation_reference: 'devtrack-foundation-api',
+        inherits_shared_baseline: true,
+        selection_triggers: ['ai', 'agent', 'llm', 'tool', 'prompt', 'provider', 'model'],
+        adds: ['agent endpoint conventions', 'tool/action boundaries', 'provider config redaction', 'audit trail'],
+        required_proof: ['no live credential tests', 'tool boundary validation', 'redaction evidence', 'auditability evidence'],
+    },
+    'full-foundation-compatible': {
+        id: 'full-foundation-compatible',
+        title: 'Full Foundation Compatible',
+        summary: 'Strict profile for full compatibility with devtrack-foundation-api architecture and conventions.',
+        foundation_reference: 'devtrack-foundation-api',
+        inherits_shared_baseline: true,
+        selection_triggers: ['foundation', 'foundation-compatible', 'full', 'devtrack-api', 'devtrack-foundation-api'],
+        adds: ['Foundation parity matrix', 'full layer structure', 'strict contract validation', 'legacy alias compatibility'],
+        required_proof: ['Foundation parity matrix', 'artifact map evidence', 'strict validation gates'],
+        parity_matrix_ref: CODESDD_FULL_FOUNDATION_PARITY_MATRIX.id,
+        parity_dimensions: CODESDD_FULL_FOUNDATION_PARITY_DIMENSIONS,
+    },
+};
+export function isCodeSddApiProfileId(value) {
+    return CODESDD_API_PROFILE_IDS.includes(value);
+}
+export function resolveCodeSddApiProfile(value, options = {}) {
+    const normalized = value?.trim();
+    const defaultProfile = options.defaultProfile ?? DEFAULT_CODESDD_API_PROFILE_ID;
+    if (!normalized) {
+        return {
+            family_id: CODESDD_API_PROFILE_FAMILY_ID,
+            input: value,
+            profile_id: defaultProfile,
+            legacy_alias: false,
+        };
+    }
+    if (normalized === LEGACY_DEVTRACK_API_PROFILE_ALIAS) {
+        return {
+            family_id: CODESDD_API_PROFILE_FAMILY_ID,
+            input: value,
+            profile_id: DEFAULT_DEVTRACK_API_ALIAS_PROFILE_ID,
+            legacy_alias: true,
+            migration_notice: 'devtrack-api is a compatibility alias; use full-foundation-compatible for new CodeSDD API profile requests.',
+        };
+    }
+    if (isCodeSddApiProfileId(normalized)) {
+        return {
+            family_id: CODESDD_API_PROFILE_FAMILY_ID,
+            input: value,
+            profile_id: normalized,
+            legacy_alias: false,
+        };
+    }
+    throw new Error(`Unknown CodeSDD API profile "${value}". Expected one of: ${CODESDD_API_PROFILE_IDS.join(', ')}.`);
+}
+export function selectCodeSddApiProfileFromIntent(intent) {
+    const normalized = intent.toLowerCase();
+    for (const profile of CODESDD_API_PROFILE_SELECTION_ORDER) {
+        const definition = CODESDD_API_PROFILE_DEFINITIONS[profile];
+        if (definition.selection_triggers.some((trigger) => normalized.includes(trigger))) {
+            return profile;
+        }
+    }
+    return DEFAULT_CODESDD_API_PROFILE_ID;
+}
+//# sourceMappingURL=api-profile-catalog.js.map

package/dist/core/sdd/api-profile-dry-run-projection.d.ts

@@ -0,0 +1,93 @@
+import { type CodeSddApiProfileId, type ResolvedCodeSddApiProfile } from './api-profile-catalog.js';
+import type { PluginArtifactKind, PluginArtifactLayer, PluginArtifactRole } from './plugin-sdk-contract.js';
+export declare const CODESDD_API_PROFILE_DRY_RUN_EVIDENCE_CONTRACT: {
+    readonly id: "profile-aware-dry-run-evidence";
+    readonly version: 1;
+    readonly mode: "dry-run";
+    readonly mutation_policy: "planning-only";
+};
+export type CodeSddApiProfileDryRunWriteSource = 'shared-baseline' | 'profile-overlay' | 'full-foundation-parity';
+export interface CodeSddApiProfileExpectedWriteDefinition {
+    path: string;
+    layer: PluginArtifactLayer;
+    artifact_kind: PluginArtifactKind;
+    role: PluginArtifactRole;
+    source: CodeSddApiProfileDryRunWriteSource;
+    reason: string;
+    required_by: readonly string[];
+}
+export interface CodeSddApiProfileDryRunExpectationDefinition {
+    profile_id: CodeSddApiProfileId;
+    profile_quality_gates: readonly string[];
+    expected_writes: readonly CodeSddApiProfileExpectedWriteDefinition[];
+}
+export interface CodeSddApiProfileArtifactMapRefInput {
+    path: string;
+    layer: PluginArtifactLayer;
+    artifact_kind: PluginArtifactKind;
+    role: PluginArtifactRole;
+    content_type: string;
+    source_reference: string;
+    tags: readonly string[];
+}
+export interface CodeSddApiProfileProjectedWrite extends CodeSddApiProfileExpectedWriteDefinition {
+    status: 'expected';
+    planned_in_current_scaffold: boolean;
+}
+export interface CodeSddApiProfileArtifactMapRef {
+    path: string;
+    layer: PluginArtifactLayer;
+    artifact_kind: PluginArtifactKind;
+    role: PluginArtifactRole;
+    content_type: string;
+    source_refs: string[];
+    tags: string[];
+    status: 'planned';
+}
+export interface CodeSddApiProfileValidationResult {
+    command: string;
+    status: 'pending';
+    result: 'not_executed_dry_run';
+    expected_outcome: string;
+    evidence_required: readonly string[];
+}
+export interface CodeSddApiProfileMigrationWarning {
+    code: 'legacy-profile-alias';
+    severity: 'warning';
+    requested_profile: string;
+    resolves_to: CodeSddApiProfileId;
+    message: string;
+}
+export interface CodeSddApiProfileDryRunProjection {
+    id: typeof CODESDD_API_PROFILE_DRY_RUN_EVIDENCE_CONTRACT.id;
+    version: typeof CODESDD_API_PROFILE_DRY_RUN_EVIDENCE_CONTRACT.version;
+    mode: typeof CODESDD_API_PROFILE_DRY_RUN_EVIDENCE_CONTRACT.mode;
+    mutation_policy: typeof CODESDD_API_PROFILE_DRY_RUN_EVIDENCE_CONTRACT.mutation_policy;
+    selected_profile: CodeSddApiProfileId;
+    requested_profile: string;
+    legacy_alias: boolean;
+    inherited_baseline: true;
+    expected_write_scope: string[];
+    expected_writes: CodeSddApiProfileProjectedWrite[];
+    expected_quality_gates: string[];
+    artifact_map_refs: CodeSddApiProfileArtifactMapRef[];
+    validation_results: CodeSddApiProfileValidationResult[];
+    migration_warnings: CodeSddApiProfileMigrationWarning[];
+}
+export declare const CODESDD_API_PROFILE_DRY_RUN_EXPECTATION_DEFINITIONS: {
+    'minimal-rest': CodeSddApiProfileDryRunExpectationDefinition;
+    'rest-auth-rbac': CodeSddApiProfileDryRunExpectationDefinition;
+    'rest-crud-typeorm': CodeSddApiProfileDryRunExpectationDefinition;
+    'evented-api': CodeSddApiProfileDryRunExpectationDefinition;
+    'ai-agent-api': CodeSddApiProfileDryRunExpectationDefinition;
+    'full-foundation-compatible': CodeSddApiProfileDryRunExpectationDefinition;
+};
+export declare function getCodeSddApiProfileDryRunExpectation(profileId: CodeSddApiProfileId): CodeSddApiProfileDryRunExpectationDefinition;
+export declare function getCodeSddApiProfileDryRunExpectations(): CodeSddApiProfileDryRunExpectationDefinition[];
+export declare function buildCodeSddApiProfileDryRunProjection(input: {
+    apiProfile: ResolvedCodeSddApiProfile;
+    expectedWriteScope: readonly string[];
+    artifactMapRefs: readonly CodeSddApiProfileArtifactMapRefInput[];
+    validationCommands: readonly string[];
+}): CodeSddApiProfileDryRunProjection;
+//# sourceMappingURL=api-profile-dry-run-projection.d.ts.map