@jterrats/smart-deployment 1.3.1 → 1.4.0

package/README.md

@@ -32,6 +32,7 @@ What is working today:
 - `sf smart-deployment ci-publish`
 - `sf smart-deployment retrieve`
 - JSON and HTML analysis reports
+- release-owner CLI summaries and stable JSON release reports for `start`, `validate`, and `ci-publish`
 - repo-level AI configuration via `.smart-deployment.json`
 
 What is still partial:
@@ -119,6 +120,25 @@ sf smart-deployment validate \
   --use-ai
 ```
 
+Generate a story scope manifest from reviewed commits, then use it as the CI release contract:
+
+```bash
+sf smart-deployment validate \
+  --source-path . \
+  --scope-commits abc123,def456 \
+  --scope-manifest-output manifests/story-scope.generated.json
+
+sf smart-deployment ci preset \
+  --source-path . \
+  --scope-manifest manifests/story-scope.generated.json \
+  --validation-mode strict
+```
+
+Story scope manifests are JSON objects with `schemaVersion: 1`, top-level `commits`, optional `changes`, and a
+`scope` object containing `changedComponents`, `dependencyComponents`, `explicitComponents`, `includedComponents`, and
+`ignoredComponents`. CI treats `scope.includedComponents` as the deployment boundary; metadata outside that list is
+ignored unless it is added through `includeComponents` or `stories[].includeComponents`.
+
 When to use each:
 
 - use `validate` for local wave plan readiness and risk checks
@@ -170,6 +190,24 @@ When executing deploy phases, Smart Deployment respects `.forceignore` by buildi
 For retrieve flows, `sf smart-deployment retrieve` runs `sf project retrieve start`, detects touched paths, restores `.forceignore`-protected bundle sub-paths with `git checkout HEAD -- <path>` or untracked cleanup, and can fail the command with `--strict-ignore`. Use `--normalize-meta` to opt into deterministic formatting for DigitalExperience `*_meta.json` files.
 When `--target-org` is provided, the coordinated publish flow also passes the org through to Salesforce CLI commands and checks AI evaluation subjects against source metadata or the target org before deploy.
 
+### Release Report
+
+`start`, `validate`, and `ci-publish` print a release-owner summary and write:
+
+```text
+.smart-deployment/reports/release-report.json
+```
+
+`start --report-dir <path>` relocates the report alongside the other requested report artifacts. The versioned
+`schemaVersion: "1.0"` contract includes the command, target org when supplied, deterministic or AI-enriched analysis
+mode, enrichment availability, overall outcome, totals, phases, metadata items, safe command evidence, and remediation.
+Operations (`deploy`, `publish`, `activate`, `validate`) are separate from statuses (`succeeded`, `failed`, `skipped`,
+`needs_review`) so CI can parse the artifact without scraping logs.
+
+Report creation is advisory. A build, sanitization, serialization, persistence, or optional enrichment failure emits a
+warning but does not replace the underlying command result or exit behavior. Evidence excludes raw arguments,
+stdout/stderr, stack traces, credentials, and paths outside the Salesforce project.
+
 ## Commands
 
 See:

package/lib/analysis/metadata-capability-definitions.d.ts

@@ -0,0 +1,2 @@
+import type { MetadataCapabilityDefinition } from '../types/metadata-capability.js';
+export declare const METADATA_CAPABILITY_DEFINITIONS: readonly MetadataCapabilityDefinition[];

package/lib/analysis/metadata-capability-definitions.js

@@ -0,0 +1,260 @@
+import { DEPLOYMENT_ORDER } from '../constants/deployment-order.js';
+const API_67 = '67.0';
+const REPOSITORY_SOURCE_ID = 'smart-deployment-repository';
+const RESEARCH_SOURCE_ID = 'metadata-catalog-research';
+const REPOSITORY_SOURCE = {
+    id: REPOSITORY_SOURCE_ID,
+    kind: 'repository',
+    locator: 'smart-deployment source and focused tests',
+};
+const RESEARCH_SOURCE = {
+    id: RESEARCH_SOURCE_ID,
+    kind: 'repository',
+    locator: 'docs/research/metadata-catalog',
+    retrievedAt: '2026-07-23',
+};
+const SALESFORCE_COVERAGE_SOURCE = {
+    id: 'salesforce-metadata-coverage-67',
+    kind: 'vendor-documentation',
+    locator: 'https://developer.salesforce.com/docs/success/metadata-coverage-report/references/coverage-report/v67.0',
+    retrievedAt: '2026-07-23',
+};
+const LEGACY_SCANNER_TYPES = [
+    'ApexClass',
+    'ApexTrigger',
+    'AuraDefinitionBundle',
+    'Bot',
+    'BrandingSet',
+    'CustomSite',
+    'DigitalExperienceBundle',
+    'EmailTemplate',
+    'EmbeddedServiceConfig',
+    'FlexiPage',
+    'Layout',
+    'LightningComponentBundle',
+    'Network',
+    'Profile',
+    'Queue',
+    'StandardValueSet',
+];
+const P0_DEFINITIONS = [
+    metadataDefinition('ApexComponent', 'VisualforceComponent', 'C1', '61.0', {
+        discovery: proven('code-metadata-scanner.ts CODE_FILE_SCANNERS discovers Visualforce components.'),
+        parsing: proven('experience-metadata-scanner.ts parses Visualforce components.'),
+        dependencies: proven('Visualforce component dependency extraction is implemented.'),
+        ordering: proven('VisualforceComponent is present in DEPLOYMENT_ORDER.'),
+        lifecycle: notApplicable(),
+        fixtures: proven('Focused Visualforce scanner fixtures exist.'),
+    }),
+    metadataDefinition('ApexPage', 'VisualforcePage', 'C1', '61.0', {
+        discovery: proven('code-metadata-scanner.ts CODE_FILE_SCANNERS discovers Visualforce pages.'),
+        parsing: proven('experience-metadata-scanner.ts parses Visualforce pages.'),
+        dependencies: proven('Visualforce page dependency extraction is implemented.'),
+        ordering: proven('VisualforcePage is present in DEPLOYMENT_ORDER.'),
+        lifecycle: notApplicable(),
+        fixtures: proven('Focused Visualforce scanner fixtures exist.'),
+    }),
+    metadataDefinition('CustomApplication', 'LightningApp', 'C1', '61.0', {
+        discovery: partial('Source-path and manifest discovery exist without a component scanner.'),
+        parsing: absent('No CustomApplication parser is registered.'),
+        dependencies: partial('Security parsers can emit LightningApp references.'),
+        ordering: absent('Vendor CustomApplication has no proven ordering contract.'),
+        lifecycle: notApplicable(),
+        fixtures: absent('No focused end-to-end CustomApplication fixture exists.'),
+    }),
+    metadataDefinition('CustomMetadata', 'CustomMetadataRecord', 'C1', '61.0', {
+        discovery: proven('data-metadata-scanner.ts discovers custom metadata records.'),
+        parsing: proven('parseCustomMetadataComponents parses custom metadata records.'),
+        dependencies: proven('Custom metadata dependency extraction is implemented.'),
+        ordering: proven('CustomMetadataRecord is present in DEPLOYMENT_ORDER.'),
+        lifecycle: notApplicable(),
+        fixtures: proven('Focused custom metadata fixtures exist.'),
+    }),
+    metadataDefinition('CustomObject', 'CustomObject', 'C1', '61.0', {
+        discovery: proven('data-metadata-scanner.ts discovers CustomObject components.'),
+        parsing: proven('custom-object-parser.ts parses CustomObject metadata.'),
+        dependencies: partial('Only a subset of parsed object references reaches typed graph edges.'),
+        ordering: proven('CustomObject is present in DEPLOYMENT_ORDER.'),
+        lifecycle: notApplicable(),
+        fixtures: proven('Focused CustomObject parser and scanner fixtures exist.'),
+    }),
+    metadataDefinition('Flow', 'Flow', 'C1', '61.0', {
+        discovery: proven('automation-ai-metadata-scanner.ts discovers Flow components.'),
+        parsing: proven('flow-parser.ts parses Flow metadata.'),
+        dependencies: partial('Scanner assembly retains only part of the parsed Flow dependency set.'),
+        ordering: proven('Flow is present in DEPLOYMENT_ORDER.'),
+        lifecycle: notApplicable(),
+        fixtures: proven('Focused Flow parser and scanner fixtures exist.'),
+    }),
+    metadataDefinition('MatchingRules', 'MatchingRules', 'C1', '61.0', {
+        discovery: partial('Manifest and matchingRule source suffix detection exist.'),
+        parsing: absent('No MatchingRules parser is registered.'),
+        dependencies: absent('No MatchingRules dependency extraction is registered.'),
+        ordering: absent('MatchingRules is absent from DEPLOYMENT_ORDER.'),
+        lifecycle: notApplicable(),
+        fixtures: absent('Only metadata-gap detection coverage exists.'),
+    }),
+    metadataDefinition('PermissionSet', 'PermissionSet', 'C1', '61.0', {
+        discovery: proven('security-metadata-scanner.ts discovers PermissionSet components.'),
+        parsing: proven('permission-set-parser.ts parses PermissionSet metadata.'),
+        dependencies: partial('Several security references are not consistently normalized to typed node IDs.'),
+        ordering: proven('PermissionSet is present in DEPLOYMENT_ORDER.'),
+        lifecycle: notApplicable(),
+        fixtures: proven('Focused PermissionSet parser and scanner fixtures exist.'),
+    }),
+    metadataDefinition('OrderManagementSettings', 'OrderManagementSettings', 'C1', '67.0', {
+        discovery: partial('Manifest discovery preserves the vendor type; source inference remains generic.'),
+        parsing: absent('No OrderManagementSettings parser is registered.'),
+        dependencies: absent('No dependency extraction is registered.'),
+        ordering: absent('No validated deployment order exists.'),
+        lifecycle: absent('Enablement and rollback behavior require licensed-org evidence.'),
+        fixtures: absent('No licensed-org fixture or CLI contract exists.'),
+    }),
+    metadataDefinition('AiAuthoringBundle', 'AiAuthoringBundle', 'C2', '66.0', {
+        discovery: proven('automation-ai-metadata-scanner.ts discovers AiAuthoringBundle source.'),
+        parsing: partial('Bundle descriptor and Agent Script references are not fully parsed.'),
+        dependencies: absent('No complete AiAuthoringBundle dependency graph is emitted.'),
+        ordering: proven('AiAuthoringBundle has explicit special deployment ordering.'),
+        lifecycle: proven('special-deployment executor publishes and optionally activates authoring bundles.'),
+        fixtures: proven('API 66 authoring bundle and special deployment fixtures exist.'),
+    }, 'source-format-composite'),
+    metadataDefinition('GenAiPlannerBundle', 'GenAiPlannerBundle', 'C2', '66.0', {
+        discovery: proven('automation-ai-metadata-scanner.ts discovers planner bundles.'),
+        parsing: partial('Planner parsing covers actions and references but not all provenance.'),
+        dependencies: proven('Flow, Apex, and prompt references are extracted.'),
+        ordering: proven('GenAiPlannerBundle is present in DEPLOYMENT_ORDER.'),
+        lifecycle: partial('Generated-versus-owned publish provenance is not persisted.'),
+        fixtures: proven('API 66 planner bundle dependency fixtures exist.'),
+    }),
+    metadataDefinition('GenAiPromptTemplate', 'GenAiPromptTemplate', 'C2', '66.0', {
+        discovery: proven('automation-ai-metadata-scanner.ts discovers prompt templates.'),
+        parsing: proven('genai-prompt-parser.ts parses prompt metadata.'),
+        dependencies: partial('Model, field, and provider facts are not fully projected into graph edges.'),
+        ordering: proven('GenAiPromptTemplate is present in DEPLOYMENT_ORDER.'),
+        lifecycle: partial('Activation is separate and not fully modeled.'),
+        fixtures: proven('Focused prompt-template parser fixtures exist.'),
+    }),
+    metadataDefinition('AiEvaluationDefinition', 'AiEvaluationDefinition', 'C2', '67.0', {
+        discovery: proven('Canonical AiEvaluationDefinition source files are scanned deterministically.'),
+        parsing: proven('Required agent subject fields are parsed and validated.'),
+        dependencies: proven('The schema-proven Bot subject reference is emitted as a hard parser dependency.'),
+        ordering: proven('Evaluations are excluded from core deployment and owned by the ordered special phase.'),
+        lifecycle: partial('Connect API execution is separate from metadata deployment.'),
+        fixtures: proven('Evaluation definition validation fixtures exist.'),
+    }),
+    externalDefinition('BotVersion', 'BotVersion', 'C2', 'provider-lifecycle', {
+        discovery: absent('No independent BotVersion scanner exists.'),
+        parsing: absent('No independent BotVersion parser exists.'),
+        dependencies: absent('No independent BotVersion dependency extraction exists.'),
+        ordering: absent('A generic order entry does not prove provider lifecycle ordering.'),
+        lifecycle: partial('Bot version lifecycle is provider-managed and only partially represented.'),
+        fixtures: absent('No independent BotVersion lifecycle fixture exists.'),
+    }),
+    metadataDefinition('SlackApp', 'SlackApp', 'C1', '67.0', absentCapabilities()),
+    externalDefinition('SlackAppManifest', 'SlackAppManifest', 'C1', 'external-provider', {
+        discovery: absent('No Slack provider adapter is registered.'),
+        parsing: notApplicable(),
+        dependencies: notApplicable(),
+        ordering: notApplicable(),
+        lifecycle: absent('No Slack install or reinstall lifecycle is registered.'),
+        fixtures: absent('No secret-safe Slack manifest fixture exists.'),
+    }),
+    externalDefinition('FSLManagedConfiguration', 'FSLManagedConfiguration', 'C1', 'managed-package-data', {
+        discovery: absent('No package-aware FSL configuration data adapter is registered.'),
+        parsing: notApplicable(),
+        dependencies: notApplicable(),
+        ordering: notApplicable(),
+        lifecycle: absent('No package-version-aware data lifecycle is registered.'),
+        fixtures: absent('No licensed FSL configuration fixture exists.'),
+    }),
+    externalDefinition('FieldServiceOperationalRecords', 'FieldServiceOperationalRecords', 'C1', 'managed-package-data', {
+        discovery: notApplicable('Operational records are deliberately excluded from metadata discovery.'),
+        parsing: notApplicable(),
+        dependencies: notApplicable(),
+        ordering: notApplicable(),
+        lifecycle: absent('Operational data migration is outside smart-deployment.'),
+        fixtures: absent('No operational data fixture belongs in this plugin.'),
+    }),
+];
+export const METADATA_CAPABILITY_DEFINITIONS = [
+    ...Object.keys(DEPLOYMENT_ORDER)
+        .filter((metadataType) => !isExplicitlyDefined(metadataType) && !isLegacyScannerType(metadataType))
+        .map((metadataType) => orderedDefinition(metadataType)),
+    ...LEGACY_SCANNER_TYPES.filter((metadataType) => !isExplicitlyDefined(metadataType)).map((metadataType) => scannerDefinition(metadataType)),
+    ...P0_DEFINITIONS,
+];
+function metadataDefinition(vendorType, canonicalType, canonicalOwner, minimumApiVersion, capabilities, deploymentChannel = 'metadata-api') {
+    return definition(vendorType, canonicalType, canonicalOwner, API_67, minimumApiVersion, deploymentChannel, capabilities);
+}
+function externalDefinition(vendorType, canonicalType, canonicalOwner, deploymentChannel, capabilities) {
+    return definition(vendorType, canonicalType, canonicalOwner, 'n/a', 'n/a', deploymentChannel, capabilities);
+}
+function scannerDefinition(metadataType) {
+    return metadataDefinition(metadataType, metadataType, 'legacy-repository', '61.0', {
+        discovery: proven('Existing metadata scanner coverage.'),
+        parsing: partial('Parser depth varies by metadata family.'),
+        dependencies: partial('Dependency evidence varies by metadata family.'),
+        ordering: Object.hasOwn(DEPLOYMENT_ORDER, metadataType)
+            ? proven(`${metadataType} is present in DEPLOYMENT_ORDER.`)
+            : absent(`${metadataType} is absent from DEPLOYMENT_ORDER.`),
+        lifecycle: notApplicable(),
+        fixtures: partial('Focused fixture coverage varies by metadata family.'),
+    });
+}
+function orderedDefinition(metadataType) {
+    return metadataDefinition(metadataType, metadataType, 'legacy-repository', '61.0', {
+        discovery: absent(`No scanner is registered for ordered type ${metadataType}.`),
+        parsing: absent(`No parser is registered for ordered type ${metadataType}.`),
+        dependencies: absent(`No dependency extractor is registered for ordered type ${metadataType}.`),
+        ordering: proven(`${metadataType} is present in DEPLOYMENT_ORDER.`),
+        lifecycle: notApplicable(),
+        fixtures: absent(`No focused fixture proves support for ordered-only type ${metadataType}.`),
+    });
+}
+function definition(vendorType, canonicalType, canonicalOwner, apiVersion, minimumApiVersion, deploymentChannel, capabilities) {
+    return {
+        apiVersion,
+        minimumApiVersion,
+        deploymentChannel,
+        vendorType,
+        canonicalType,
+        internalAliases: [],
+        canonicalOwner,
+        capabilities,
+        evidenceSources: apiVersion === 'n/a'
+            ? [REPOSITORY_SOURCE, RESEARCH_SOURCE]
+            : [REPOSITORY_SOURCE, RESEARCH_SOURCE, SALESFORCE_COVERAGE_SOURCE],
+    };
+}
+function isExplicitlyDefined(metadataType) {
+    return P0_DEFINITIONS.some((entry) => entry.vendorType === metadataType || entry.canonicalType === metadataType);
+}
+function isLegacyScannerType(metadataType) {
+    return LEGACY_SCANNER_TYPES.includes(metadataType);
+}
+function absentCapabilities() {
+    return {
+        discovery: absent('No deterministic discovery is registered.'),
+        parsing: absent('No semantic parser is registered.'),
+        dependencies: absent('No dependency extraction is registered.'),
+        ordering: absent('No deployment ordering is registered.'),
+        lifecycle: absent('No deployment or provider lifecycle is registered.'),
+        fixtures: absent('No deterministic fixture or CLI evidence is registered.'),
+    };
+}
+function proven(detail) {
+    return evidence('proven', REPOSITORY_SOURCE_ID, detail);
+}
+function partial(detail) {
+    return evidence('partial', REPOSITORY_SOURCE_ID, detail);
+}
+function absent(detail) {
+    return evidence('absent', RESEARCH_SOURCE_ID, detail);
+}
+function notApplicable(detail = 'Capability does not apply to this deployment channel.') {
+    return evidence('not-applicable', RESEARCH_SOURCE_ID, detail);
+}
+function evidence(status, sourceId, detail) {
+    return { status, evidence: [{ sourceId, detail }] };
+}
+//# sourceMappingURL=metadata-capability-definitions.js.map

package/lib/analysis/metadata-capability-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-capability-definitions.js","sourceRoot":"","sources":["../../src/analysis/metadata-capability-definitions.ts"],"names":[],"mappings":"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"}

package/lib/analysis/metadata-capability-registry.d.ts

@@ -0,0 +1,11 @@
+import type { MetadataCapabilityDefinition, MetadataCapabilityEntry, MetadataDeploymentChannel } from '../types/metadata-capability.js';
+export declare class MetadataCapabilityRegistry {
+    private readonly entriesByKey;
+    private readonly sortedEntries;
+    constructor(definitions: readonly MetadataCapabilityDefinition[]);
+    list(): readonly MetadataCapabilityEntry[];
+    getByCatalogKey(catalogKey: string): MetadataCapabilityEntry | undefined;
+    resolve(metadataType: string, projectApiVersion: string, deploymentChannel?: MetadataDeploymentChannel): MetadataCapabilityEntry | undefined;
+}
+export declare function buildMetadataCapabilityCatalogKey(apiVersion: string, deploymentChannel: MetadataDeploymentChannel, vendorType: string): string;
+export declare const metadataCapabilityRegistry: MetadataCapabilityRegistry;

package/lib/analysis/metadata-capability-registry.js

@@ -0,0 +1,142 @@
+import { METADATA_CAPABILITY_DEFINITIONS } from './metadata-capability-definitions.js';
+const CAPABILITY_NAMES = ['discovery', 'parsing', 'dependencies', 'ordering', 'lifecycle', 'fixtures'];
+export class MetadataCapabilityRegistry {
+    entriesByKey;
+    sortedEntries;
+    constructor(definitions) {
+        const entriesByKey = new Map();
+        const aliasesByScope = new Map();
+        const entries = definitions.map((definition) => normalizeDefinition(definition));
+        for (const entry of entries) {
+            if (entriesByKey.has(entry.catalogKey)) {
+                throw new Error(`Duplicate metadata capability catalog key: ${entry.catalogKey}`);
+            }
+            entriesByKey.set(entry.catalogKey, entry);
+            for (const name of [entry.vendorType, entry.canonicalType, ...entry.internalAliases]) {
+                const aliasKey = buildAliasKey(entry.apiVersion, entry.deploymentChannel, name);
+                const existing = aliasesByScope.get(aliasKey);
+                if (existing && existing.catalogKey !== entry.catalogKey) {
+                    throw new Error(`Duplicate metadata capability name "${name}" for ${entry.apiVersion}|${entry.deploymentChannel}`);
+                }
+                aliasesByScope.set(aliasKey, entry);
+            }
+        }
+        this.entriesByKey = entriesByKey;
+        this.sortedEntries = Object.freeze([...entries].sort((left, right) => compareText(left.catalogKey, right.catalogKey)));
+    }
+    list() {
+        return this.sortedEntries;
+    }
+    getByCatalogKey(catalogKey) {
+        return this.entriesByKey.get(catalogKey);
+    }
+    resolve(metadataType, projectApiVersion, deploymentChannel) {
+        const candidates = this.sortedEntries.filter((entry) => (deploymentChannel === undefined || entry.deploymentChannel === deploymentChannel) &&
+            [entry.vendorType, entry.canonicalType, ...entry.internalAliases].includes(metadataType) &&
+            isCompatibleWithProject(entry.minimumApiVersion, projectApiVersion));
+        const channels = new Set(candidates.map((entry) => entry.deploymentChannel));
+        if (channels.size !== 1) {
+            return undefined;
+        }
+        return [...candidates].sort((left, right) => compareApiVersion(left.apiVersion, right.apiVersion)).at(-1);
+    }
+}
+export function buildMetadataCapabilityCatalogKey(apiVersion, deploymentChannel, vendorType) {
+    return `${apiVersion}|${deploymentChannel}|${vendorType}`;
+}
+export const metadataCapabilityRegistry = new MetadataCapabilityRegistry(METADATA_CAPABILITY_DEFINITIONS);
+function normalizeDefinition(definition) {
+    validateApiVersion(definition.apiVersion, 'apiVersion');
+    validateApiVersion(definition.minimumApiVersion, 'minimumApiVersion');
+    validateText(definition.vendorType, 'vendorType');
+    validateText(definition.canonicalType, 'canonicalType');
+    const aliases = [...definition.internalAliases].sort(compareText);
+    if (new Set(aliases).size !== aliases.length) {
+        throw new Error(`Duplicate aliases in metadata capability definition: ${definition.vendorType}`);
+    }
+    const evidenceSources = normalizeEvidenceSources(definition.evidenceSources, definition.vendorType);
+    const sourceIds = new Set(evidenceSources.map((source) => source.id));
+    const capabilities = normalizeCapabilities(definition.capabilities, sourceIds, definition.vendorType);
+    return Object.freeze({
+        ...definition,
+        internalAliases: Object.freeze(aliases),
+        capabilities,
+        evidenceSources,
+        catalogKey: buildMetadataCapabilityCatalogKey(definition.apiVersion, definition.deploymentChannel, definition.vendorType),
+    });
+}
+function normalizeEvidenceSources(sources, vendorType) {
+    const normalized = [...sources]
+        .map((source) => {
+        validateText(source.id, 'evidence source id');
+        validateText(source.locator, 'evidence source locator');
+        if (source.retrievedAt !== undefined && !/^\d{4}-\d{2}-\d{2}$/u.test(source.retrievedAt)) {
+            throw new Error(`Invalid metadata capability evidence retrieval date: "${source.retrievedAt}"`);
+        }
+        return Object.freeze({ ...source });
+    })
+        .sort((left, right) => compareText(left.id, right.id));
+    if (new Set(normalized.map((source) => source.id)).size !== normalized.length) {
+        throw new Error(`Duplicate evidence sources in metadata capability definition: ${vendorType}`);
+    }
+    return Object.freeze(normalized);
+}
+function normalizeCapabilities(capabilities, sourceIds, vendorType) {
+    const actualNames = Object.keys(capabilities).sort(compareText);
+    const expectedNames = [...CAPABILITY_NAMES].sort(compareText);
+    if (actualNames.join('|') !== expectedNames.join('|')) {
+        throw new Error(`Invalid capability dimensions in metadata capability definition: ${vendorType}`);
+    }
+    return Object.freeze(Object.fromEntries(CAPABILITY_NAMES.map((name) => {
+        const capability = capabilities[name];
+        return [
+            name,
+            Object.freeze({
+                ...capability,
+                evidence: Object.freeze(capability.evidence.map((reference) => normalizeEvidenceReference(reference, sourceIds, vendorType))),
+            }),
+        ];
+    })));
+}
+function normalizeEvidenceReference(reference, sourceIds, vendorType) {
+    validateText(reference.sourceId, 'evidence sourceId');
+    validateText(reference.detail, 'evidence detail');
+    if (!sourceIds.has(reference.sourceId)) {
+        throw new Error(`Unknown evidence source "${reference.sourceId}" in metadata capability definition: ${vendorType}`);
+    }
+    return Object.freeze({ ...reference });
+}
+function buildAliasKey(apiVersion, deploymentChannel, name) {
+    return `${apiVersion}|${deploymentChannel}|${name}`;
+}
+function validateApiVersion(value, field) {
+    validateText(value, field);
+    if (value !== 'n/a' && !/^\d+\.\d+$/u.test(value)) {
+        throw new Error(`Invalid metadata capability ${field}: "${value}"`);
+    }
+}
+function validateText(value, field) {
+    if (value.trim().length === 0 || value !== value.trim() || value.includes('|')) {
+        throw new Error(`Invalid metadata capability ${field}: "${value}"`);
+    }
+}
+function isCompatibleWithProject(minimumApiVersion, projectApiVersion) {
+    if (minimumApiVersion === 'n/a') {
+        return true;
+    }
+    const requestedVersion = Number.parseFloat(projectApiVersion);
+    return Number.isFinite(requestedVersion) && Number.parseFloat(minimumApiVersion) <= requestedVersion;
+}
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function compareApiVersion(left, right) {
+    if (left === right)
+        return 0;
+    if (left === 'n/a')
+        return -1;
+    if (right === 'n/a')
+        return 1;
+    return Number.parseFloat(left) - Number.parseFloat(right);
+}
+//# sourceMappingURL=metadata-capability-registry.js.map

package/lib/analysis/metadata-capability-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-capability-registry.js","sourceRoot":"","sources":["../../src/analysis/metadata-capability-registry.ts"],"names":[],"mappings":"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"}

package/lib/analysis/metadata-gap-analysis-service.d.ts

@@ -0,0 +1,51 @@
+import { MetadataCapabilityRegistry } from './metadata-capability-registry.js';
+export type MetadataGapClassification = 'registry-only' | 'dependency-rule' | 'ordering-special' | 'provider-owned' | 'human-review-required';
+export type MetadataGapSupportStatus = 'supported' | 'ordered-only' | 'unsupported';
+export type MetadataGapDetectedType = {
+    metadataType: string;
+    supportStatus: MetadataGapSupportStatus;
+    evidence: string[];
+    detectedFrom: Array<'package-manifest' | 'source-path'>;
+};
+export type MetadataGapFinding = MetadataGapDetectedType & {
+    classification: MetadataGapClassification;
+    reason: string;
+    suggestedImplementation: string[];
+    requiresHumanReview: boolean;
+};
+export type MetadataGapAIContext = {
+    mode: 'workflow-prompt';
+    directProviderApiAllowed: false;
+    recommendedCommand: string;
+    prompt: string;
+};
+export type MetadataGapAnalysisResult = {
+    success: boolean;
+    analysisMode: 'deterministic' | 'deterministic-with-ai-context';
+    projectRoot: string;
+    apiVersion: string;
+    detectedTypes: MetadataGapDetectedType[];
+    gaps: MetadataGapFinding[];
+    aiContext?: MetadataGapAIContext;
+    summary: {
+        detectedTypeCount: number;
+        supportedTypeCount: number;
+        gapCount: number;
+        humanReviewCount: number;
+    };
+};
+export type MetadataGapAnalysisOptions = {
+    sourcePath?: string;
+    aiExplain?: boolean;
+};
+export declare class MetadataGapAnalysisService {
+    private readonly capabilityRegistry;
+    constructor(capabilityRegistry?: MetadataCapabilityRegistry);
+    analyze(options?: MetadataGapAnalysisOptions): Promise<MetadataGapAnalysisResult>;
+    private collectManifestTypes;
+    private collectSourceTypes;
+    private addEvidence;
+    private toDetectedType;
+    private toGap;
+    private buildAIContext;
+}