@msn-control/liftoff 0.10.4 → 0.11.2

package/dist/domain/project/contracts.d.ts

@@ -0,0 +1,247 @@
+import type { ActivationIdentity } from '../../governance-activation/types.js';
+export type PatternId = 'generic' | 'rag' | 'chatbot' | 'agent' | 'prompt' | 'multi-agent' | 'fine-tuned' | 'streaming' | 'workflow';
+export type ProviderId = 'azure' | 'aws' | 'gcp';
+export type ProviderStatus = 'available' | 'planned';
+export type SpecWorkflowId = 'openspec' | 'spec-kit';
+export type CodingAgentId = 'github-copilot' | 'claude';
+export type EnvironmentId = 'dev' | 'staging' | 'prod';
+export type ScaffoldStatus = 'full' | 'foundation' | 'integration-shell';
+export type ProjectTypeId = 'genai' | 'standard';
+export type ApiStackId = 'python-fastapi' | 'node-fastify' | 'go-huma';
+export type GovernanceProfileId = 'single-maintainer-gitflow' | 'none';
+export type ManifestGovernanceProfileId = GovernanceProfileId | 'unspecified';
+export interface ProjectTypeDefinition {
+    id: ProjectTypeId;
+    label: string;
+    description: string;
+}
+export interface ApiStackDefinition {
+    id: ApiStackId;
+    label: string;
+    aliases: string[];
+    language: string;
+    framework: string;
+    databaseTooling: string;
+    testFramework: string;
+}
+export interface PatternDefinition {
+    id: PatternId;
+    label: string;
+    aliases: string[];
+    description: string;
+    scaffoldStatus: ScaffoldStatus;
+    frontendStarter: string;
+    routePrefix: string;
+    worker: boolean;
+    requiresVectorStore: boolean;
+}
+export interface ProviderDefinition {
+    id: ProviderId;
+    label: string;
+    status: ProviderStatus;
+    description: string;
+}
+export interface RegionDefinition {
+    provider: ProviderId;
+    slug: string;
+    displayName: string;
+    geography: string;
+    aliases: string[];
+    default?: boolean;
+}
+export type RegionResolution = {
+    status: 'resolved';
+    region: RegionDefinition;
+} | {
+    status: 'ambiguous';
+    matches: RegionDefinition[];
+} | {
+    status: 'unknown';
+    input: string;
+};
+export interface EnvironmentDefinition {
+    id: EnvironmentId;
+    label: string;
+    description: string;
+}
+export interface SpecWorkflowDefinition {
+    id: SpecWorkflowId;
+    label: string;
+    default: boolean;
+    description: string;
+}
+export interface GovernanceProfileDefinition {
+    id: GovernanceProfileId;
+    label: string;
+    description: string;
+    default: boolean;
+    policyVersion?: string;
+}
+export interface ExternalCommand {
+    executable: string;
+    args: string[];
+}
+export interface CodingAgentDefinition {
+    id: CodingAgentId;
+    inputName: string;
+    label: string;
+    aliases: string[];
+    executable: string;
+    integrationIds: Record<SpecWorkflowId, string>;
+}
+export interface FrameworkDefinition {
+    id: SpecWorkflowId;
+    executable: string;
+    version: string;
+    installCommand: ExternalCommand;
+    allowedRoots: string[];
+    baseMarkers: string[][];
+    agentMarkers: Record<CodingAgentId, string[][]>;
+}
+export interface ProjectOptions {
+    projectName?: string;
+    projectType?: string;
+    genai?: boolean;
+    apiStack?: string;
+    pattern?: string;
+    cloud?: string;
+    region?: string;
+    includeFrontend?: boolean;
+    environments?: string[];
+    specWorkflow?: string;
+    agents?: string[];
+    defaultAgent?: string;
+    copilotCloud?: boolean;
+    configureOpenSpecProfile?: boolean;
+    governanceProfile?: string;
+    configPath?: string;
+    yes?: boolean;
+    force?: boolean;
+    installTools?: boolean;
+    installDependencies?: boolean;
+}
+export interface GenAiWorkloadPlan {
+    workload: 'genai';
+    apiStack: ApiStackDefinition;
+    pattern: PatternDefinition;
+    provider: ProviderDefinition;
+    region: RegionDefinition;
+    includeFrontend: boolean;
+    frontendStarter: string;
+    environments: EnvironmentDefinition[];
+}
+export interface StandardApiWorkloadPlan {
+    workload: 'standard';
+    apiStack: ApiStackDefinition;
+    provider: ProviderDefinition;
+    region: RegionDefinition;
+    includeFrontend: boolean;
+    frontendStarter: string;
+    environments: EnvironmentDefinition[];
+}
+export type ApiWorkloadPlan = GenAiWorkloadPlan | StandardApiWorkloadPlan;
+export type WorkloadPlan = ApiWorkloadPlan;
+export interface ProjectPlanBase {
+    projectName: string;
+    safeProjectName: string;
+    packageName: string;
+    projectType: ProjectTypeDefinition;
+    specWorkflow: SpecWorkflowDefinition;
+    agents: CodingAgentDefinition[];
+    defaultAgent?: CodingAgentDefinition;
+    copilotCloud: boolean;
+    framework: FrameworkDefinition;
+    governanceProfile: GovernanceProfileDefinition;
+    approvedStack: string[];
+}
+export type ProjectPlan = ProjectPlanBase & WorkloadPlan;
+export type GenAiProjectPlan = ProjectPlanBase & GenAiWorkloadPlan;
+export type StandardApiProjectPlan = ProjectPlanBase & StandardApiWorkloadPlan;
+export type ApiProjectPlan = GenAiProjectPlan | StandardApiProjectPlan;
+export type ArtifactLifecycle = 'managed-core' | 'project' | 'desired-state' | 'framework' | 'seed' | 'manifest';
+export type ProjectProvisioningGroup = 'base' | 'frontend' | `environment:${EnvironmentId}`;
+interface GeneratedArtifactBase {
+    logicalName: string;
+    category: string;
+    pathParts: string[];
+    content: string;
+}
+export type GeneratedArtifact = (GeneratedArtifactBase & {
+    lifecycle: 'project';
+    provisioningGroup: ProjectProvisioningGroup;
+}) | (GeneratedArtifactBase & {
+    lifecycle: Exclude<ArtifactLifecycle, 'project'>;
+    provisioningGroup?: never;
+});
+export interface ManifestManagedArtifact {
+    logicalName: string;
+    category: string;
+    pathParts: string[];
+    contentHash: string;
+}
+export interface ManifestProjectArtifact {
+    logicalName: string;
+    category: string;
+    pathParts: string[];
+    generatedBy: string;
+    generationHash: string;
+    provisioningGroup: ProjectProvisioningGroup;
+}
+export type ManifestArtifact = ManifestManagedArtifact;
+export interface ManifestGenAiWorkload {
+    kind: 'genai';
+    apiStack: ApiStackId;
+    pattern: PatternId;
+    cloud: ProviderId;
+    region: string;
+    frontend: boolean;
+    environments: EnvironmentId[];
+}
+export interface ManifestStandardApiWorkload {
+    kind: 'standard';
+    apiStack: ApiStackId;
+    cloud: ProviderId;
+    region: string;
+    frontend: boolean;
+    environments: EnvironmentId[];
+}
+export type ManifestWorkload = ManifestGenAiWorkload | ManifestStandardApiWorkload;
+export type ManifestGovernance = {
+    profile: 'none';
+    state: 'disabled';
+} | {
+    profile: 'unspecified';
+    state: 'unspecified';
+} | {
+    profile: Exclude<GovernanceProfileId, 'none'>;
+    state: 'handoff-generated' | 'handoff-partial';
+    policyVersion: string;
+    activationIdentity?: ActivationIdentity;
+};
+export interface LiftoffManifest {
+    artifactVersion: 2 | 3 | 4 | 5 | 6 | 7;
+    generatedBy: 'Mission Control Liftoff';
+    liftoffVersion: string;
+    project: {
+        name: string;
+        workload: ManifestWorkload;
+        specWorkflow: SpecWorkflowId;
+        agents: CodingAgentId[];
+        defaultAgent?: CodingAgentId;
+    };
+    framework: {
+        state: 'initialized' | 'legacy';
+        adapter: SpecWorkflowId;
+        contractVersion?: string;
+    };
+    governance: ManifestGovernance;
+    managedArtifacts: ManifestManagedArtifact[];
+    projectArtifacts: ManifestProjectArtifact[];
+}
+export interface ParsedArgs {
+    command?: string;
+    subcommand?: string;
+    positional: string[];
+    flags: Record<string, string | boolean | string[]>;
+}
+export {};

package/dist/domain/project/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/domain/project/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/domain/project/contracts.ts"],"names":[],"mappings":""}

package/dist/domain/project/errors.d.ts

@@ -0,0 +1,3 @@
+export declare class FileSystemError extends Error {
+    constructor(message: string);
+}

package/dist/domain/project/errors.js

@@ -0,0 +1,7 @@
+export class FileSystemError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FileSystemError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/domain/project/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/domain/project/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/domain/project/infrastructure-layout.d.ts

@@ -0,0 +1,26 @@
+import type { EnvironmentId, LiftoffManifest, ProjectProvisioningGroup } from './contracts.js';
+export interface InfrastructureArtifactIdentity {
+    logicalName: string;
+    category: 'infrastructure';
+    pathParts: readonly string[];
+    provisioningGroup: ProjectProvisioningGroup;
+}
+export type InfrastructureLayoutKind = 'independent' | 'legacy-shared' | 'unknown';
+export interface InfrastructureLayoutAssessment {
+    kind: InfrastructureLayoutKind;
+    canProvisionEnvironment: boolean;
+    reason: string;
+}
+export interface InfrastructureProvisioningGate {
+    status: 'ready' | 'migration-required';
+    reason: string;
+}
+export declare const independentInfrastructureGenerationVersion: '0.11.0';
+export declare const compatibleIndependentInfrastructureGenerationVersions: readonly ["0.11.0", '0.11.1', '0.11.2'];
+export declare const sharedApplicationModuleIdentities: InfrastructureArtifactIdentity[];
+export declare const retainedInfrastructureIdentities: readonly InfrastructureArtifactIdentity[];
+export declare const retiredFlatRootInfrastructureIdentities: InfrastructureArtifactIdentity[];
+export declare function environmentRootInfrastructureIdentities(environment: EnvironmentId): InfrastructureArtifactIdentity[];
+export declare function currentInfrastructureIdentities(environments: readonly EnvironmentId[]): InfrastructureArtifactIdentity[];
+export declare function assessInfrastructureLayout(manifest: LiftoffManifest): InfrastructureLayoutAssessment;
+export declare function infrastructureProvisioningGate(manifest: LiftoffManifest, environment: EnvironmentId): InfrastructureProvisioningGate;

package/dist/domain/project/infrastructure-layout.js

@@ -0,0 +1,125 @@
+const azureRoot = ['infrastructure', 'opentofu', 'azure'];
+export const independentInfrastructureGenerationVersion = '0.11.0';
+export const compatibleIndependentInfrastructureGenerationVersions = [
+    independentInfrastructureGenerationVersion,
+    '0.11.1',
+    '0.11.2'
+];
+export const sharedApplicationModuleIdentities = [
+    ['opentofu-application-versions', 'versions.tf'],
+    ['opentofu-application-variables', 'variables.tf'],
+    ['opentofu-application-main', 'main.tf'],
+    ['opentofu-application-outputs', 'outputs.tf']
+].map(([logicalName, file]) => ({
+    logicalName,
+    category: 'infrastructure',
+    pathParts: [...azureRoot, 'modules', 'application', file],
+    provisioningGroup: 'base'
+}));
+export const retainedInfrastructureIdentities = [
+    {
+        logicalName: 'opentofu-readme',
+        category: 'infrastructure',
+        pathParts: [...azureRoot, 'README.md'],
+        provisioningGroup: 'base'
+    }
+];
+export const retiredFlatRootInfrastructureIdentities = [
+    ['opentofu-versions', 'versions.tf'],
+    ['opentofu-provider-lock', '.terraform.lock.hcl'],
+    ['opentofu-providers', 'providers.tf'],
+    ['opentofu-variables', 'variables.tf'],
+    ['opentofu-main', 'main.tf'],
+    ['opentofu-outputs', 'outputs.tf'],
+    ['opentofu-local-state', 'backend.local.tf'],
+    ['opentofu-remote-state-example', 'backend.remote.example.tf']
+].map(([logicalName, file]) => ({
+    logicalName,
+    category: 'infrastructure',
+    pathParts: [...azureRoot, file],
+    provisioningGroup: 'base'
+}));
+const environmentFiles = [
+    ['versions', 'versions.tf'],
+    ['provider-lock', '.terraform.lock.hcl'],
+    ['providers', 'providers.tf'],
+    ['variables', 'variables.tf'],
+    ['main', 'main.tf'],
+    ['outputs', 'outputs.tf'],
+    ['local-state', 'backend.local.tf'],
+    ['remote-state-example', 'backend.remote.example.tf']
+];
+export function environmentRootInfrastructureIdentities(environment) {
+    const root = [...azureRoot, 'environments', environment];
+    const group = `environment:${environment}`;
+    return [
+        ...environmentFiles.map(([identity, file]) => ({
+            logicalName: `opentofu-${environment}-${identity}`,
+            category: 'infrastructure',
+            pathParts: [...root, file],
+            provisioningGroup: group
+        })),
+        {
+            logicalName: `opentofu-${environment}-tfvars`,
+            category: 'infrastructure',
+            pathParts: [...root, `${environment}.tfvars`],
+            provisioningGroup: group
+        }
+    ];
+}
+export function currentInfrastructureIdentities(environments) {
+    return [
+        ...sharedApplicationModuleIdentities,
+        ...retainedInfrastructureIdentities,
+        ...environments.flatMap(environmentRootInfrastructureIdentities)
+    ];
+}
+function isRecordedIdentity(artifacts, identity, supportedGenerations) {
+    return artifacts.some((artifact) => artifact.logicalName === identity.logicalName &&
+        artifact.category === identity.category &&
+        artifact.provisioningGroup === identity.provisioningGroup &&
+        artifact.pathParts.join('\0') === identity.pathParts.join('\0') &&
+        (supportedGenerations === undefined
+            ? artifact.generatedBy.length > 0
+            : supportedGenerations.includes(artifact.generatedBy)) &&
+        /^sha256:[0-9a-f]{64}$/.test(artifact.generationHash));
+}
+export function assessInfrastructureLayout(manifest) {
+    const artifacts = manifest.projectArtifacts;
+    if (retiredFlatRootInfrastructureIdentities.some((identity) => isRecordedIdentity(artifacts, identity))) {
+        return {
+            kind: 'legacy-shared',
+            canProvisionEnvironment: false,
+            reason: 'Recorded infrastructure uses the legacy shared-state OpenTofu root and requires an explicit reviewed migration.'
+        };
+    }
+    const expected = [
+        ...sharedApplicationModuleIdentities,
+        ...manifest.project.workload.environments.flatMap((environment) => environmentRootInfrastructureIdentities(environment))
+    ];
+    if (expected.every((identity) => isRecordedIdentity(artifacts, identity, compatibleIndependentInfrastructureGenerationVersions))) {
+        return {
+            kind: 'independent',
+            canProvisionEnvironment: true,
+            reason: 'Recorded provenance contains the shared application module and complete independent environment roots.'
+        };
+    }
+    return {
+        kind: 'unknown',
+        canProvisionEnvironment: false,
+        reason: 'Recorded provenance does not establish a complete supported independent-environment infrastructure layout.'
+    };
+}
+export function infrastructureProvisioningGate(manifest, environment) {
+    const layout = assessInfrastructureLayout(manifest);
+    return layout.canProvisionEnvironment
+        ? {
+            status: 'ready',
+            reason: `Recorded infrastructure can provision the independent ${environment} environment root.`
+        }
+        : {
+            status: 'migration-required',
+            reason: `${layout.reason} The ${environment} environment was not provisioned.`
+        };
+}
+//# sourceMappingURL=infrastructure-layout.js.map

package/dist/domain/project/infrastructure-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infrastructure-layout.js","sourceRoot":"","sources":["../../../src/domain/project/infrastructure-layout.ts"],"names":[],"mappings":"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"}

package/dist/domain/project/inputs.d.ts

@@ -0,0 +1,21 @@
+import type { ProjectOptions, ProjectTypeDefinition } from './contracts.js';
+type CatalogLookup = (value: string) => {
+    id: string;
+} | undefined;
+export interface ProjectInputCatalog {
+    getProjectType(value: string): ProjectTypeDefinition | undefined;
+    getApiStack: CatalogLookup;
+    getPattern: CatalogLookup;
+    getProvider: CatalogLookup;
+    getSpecWorkflow: CatalogLookup;
+    getGovernanceProfile: CatalogLookup;
+    getCodingAgent: CatalogLookup;
+    getEnvironment: CatalogLookup;
+}
+export declare function catalogKey(value: string): string;
+export declare function normalizeProjectOptions(input: ProjectOptions, catalog: ProjectInputCatalog): ProjectOptions;
+export declare function resolveProjectTypeInput(input: ProjectOptions, lookup: ProjectInputCatalog['getProjectType']): {
+    projectType: ProjectTypeDefinition | undefined;
+    issues: string[];
+};
+export {};

package/dist/domain/project/inputs.js

@@ -0,0 +1,41 @@
+export function catalogKey(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]/g, '');
+}
+export function normalizeProjectOptions(input, catalog) {
+    const canonical = (value, lookup) => value === undefined ? undefined : lookup(value)?.id ?? value;
+    return {
+        ...input,
+        projectType: canonical(input.projectType, catalog.getProjectType),
+        apiStack: canonical(input.apiStack, catalog.getApiStack),
+        pattern: canonical(input.pattern, catalog.getPattern),
+        cloud: canonical(input.cloud, catalog.getProvider),
+        specWorkflow: canonical(input.specWorkflow, catalog.getSpecWorkflow),
+        governanceProfile: canonical(input.governanceProfile, catalog.getGovernanceProfile),
+        agents: input.agents?.map((value) => catalog.getCodingAgent(value)?.id ?? value),
+        defaultAgent: canonical(input.defaultAgent, catalog.getCodingAgent),
+        environments: input.environments?.map((value) => catalog.getEnvironment(value)?.id ?? value)
+    };
+}
+export function resolveProjectTypeInput(input, lookup) {
+    const issues = [];
+    const explicit = input.projectType ? lookup(input.projectType) : undefined;
+    if (input.projectType && !explicit)
+        issues.push(`Unknown project type: ${input.projectType}.`);
+    const signals = [
+        input.genai === undefined ? undefined : input.genai ? 'genai' : 'standard',
+        input.pattern ? 'genai' : undefined,
+        input.apiStack && !input.pattern && input.genai !== true && explicit?.id !== 'genai'
+            ? 'standard'
+            : undefined
+    ].filter((value) => value !== undefined);
+    const unique = [...new Set(signals)];
+    if (unique.length > 1) {
+        issues.push('Project type inputs conflict: GenAI pattern/flags cannot be combined with standard API inputs.');
+    }
+    if (explicit && unique.some((signal) => signal !== explicit.id)) {
+        issues.push(`Project type ${explicit.id} conflicts with legacy project-type, pattern, or API-stack inputs.`);
+    }
+    const inferred = explicit?.id ?? unique[0];
+    return { projectType: inferred ? lookup(inferred) : undefined, issues };
+}
+//# sourceMappingURL=inputs.js.map

package/dist/domain/project/inputs.js.map

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

package/dist/domain/project/manifest/artifacts.d.ts

@@ -0,0 +1,8 @@
+import type { ManifestManagedArtifact, ManifestProjectArtifact } from '../contracts.js';
+import type { ManifestContractContext } from './context.js';
+export declare function createManifestArtifactReader(catalog: ManifestContractContext['catalog']): {
+    normalizeManifestManagedArtifacts: (value: unknown, scopeRoot: string) => ManifestManagedArtifact[];
+    normalizeManifestProjectArtifacts: (value: unknown) => ManifestProjectArtifact[];
+    validateV6AndV7ArtifactAuthority: (managedArtifacts: readonly ManifestManagedArtifact[], projectArtifacts: readonly ManifestProjectArtifact[]) => void;
+    validateManifestArtifactUniqueness: (managedArtifacts: readonly ManifestManagedArtifact[], projectArtifacts: readonly ManifestProjectArtifact[]) => void;
+};

package/dist/domain/project/manifest/artifacts.js

@@ -0,0 +1,150 @@
+import { FileSystemError } from '../errors.js';
+import { validateArtifactPathParts } from '../paths.js';
+import { isManagedCoreLogicalName, isRetiredManagedCoreArtifactIdentity, isRetiredManagedCoreLogicalName, isUnknownRetiredManagedCoreAliasLogicalName } from '../artifact-lifecycle.js';
+import { assertOnlyFields, isRecord, requiredString, SEMVER_PATTERN } from './fields.js';
+const CONTENT_HASH_PATTERN = /^sha256:[0-9a-f]{64}$/;
+export function createManifestArtifactReader(catalog) {
+    const { getEnvironment } = catalog;
+    function normalizeManifestManagedArtifacts(value, scopeRoot) {
+        if (!Array.isArray(value)) {
+            throw new FileSystemError(`${scopeRoot} must be an array.`);
+        }
+        const logicalNames = new Set();
+        const paths = new Set();
+        return value.map((entry, index) => {
+            const scope = `${scopeRoot}[${index}]`;
+            if (!isRecord(entry)) {
+                throw new FileSystemError(`${scope} must be a JSON object.`);
+            }
+            assertOnlyFields(entry, ['logicalName', 'category', 'pathParts', 'contentHash'], scope);
+            const logicalName = requiredString(entry, 'logicalName', scope);
+            const category = requiredString(entry, 'category', scope);
+            const pathParts = validateArtifactPathParts(entry.pathParts, `${scope}.pathParts`);
+            const contentHash = requiredString(entry, 'contentHash', scope);
+            if (!CONTENT_HASH_PATTERN.test(contentHash)) {
+                throw new FileSystemError(`${scope}.contentHash must be a sha256-prefixed lowercase hexadecimal digest.`);
+            }
+            if (logicalNames.has(logicalName)) {
+                throw new FileSystemError(`Manifest contains duplicate logicalName ${JSON.stringify(logicalName)}.`);
+            }
+            logicalNames.add(logicalName);
+            const pathKey = pathParts.join('\0');
+            if (paths.has(pathKey)) {
+                throw new FileSystemError(`Manifest contains duplicate artifact path ${pathParts.join('/')}.`);
+            }
+            paths.add(pathKey);
+            return { logicalName, category, pathParts, contentHash };
+        });
+    }
+    function normalizeManifestProjectArtifacts(value) {
+        if (!Array.isArray(value)) {
+            throw new FileSystemError('Manifest.projectArtifacts must be an array.');
+        }
+        const logicalNames = new Set();
+        const paths = new Set();
+        return value.map((entry, index) => {
+            const scope = `Manifest.projectArtifacts[${index}]`;
+            if (!isRecord(entry)) {
+                throw new FileSystemError(`${scope} must be a JSON object.`);
+            }
+            assertOnlyFields(entry, [
+                'logicalName',
+                'category',
+                'pathParts',
+                'generatedBy',
+                'generationHash',
+                'provisioningGroup'
+            ], scope);
+            const logicalName = requiredString(entry, 'logicalName', scope);
+            const category = requiredString(entry, 'category', scope);
+            const pathParts = validateArtifactPathParts(entry.pathParts, `${scope}.pathParts`);
+            const generatedBy = requiredString(entry, 'generatedBy', scope);
+            if (!SEMVER_PATTERN.test(generatedBy)) {
+                throw new FileSystemError(`${scope}.generatedBy must be a valid semantic version.`);
+            }
+            const generationHash = requiredString(entry, 'generationHash', scope);
+            if (!CONTENT_HASH_PATTERN.test(generationHash)) {
+                throw new FileSystemError(`${scope}.generationHash must be a sha256-prefixed lowercase hexadecimal digest.`);
+            }
+            const provisioningGroup = normalizeProjectProvisioningGroup(requiredString(entry, 'provisioningGroup', scope), scope);
+            if (logicalNames.has(logicalName)) {
+                throw new FileSystemError(`Manifest contains duplicate logicalName ${JSON.stringify(logicalName)}.`);
+            }
+            logicalNames.add(logicalName);
+            const pathKey = pathParts.join('\0');
+            if (paths.has(pathKey)) {
+                throw new FileSystemError(`Manifest contains duplicate artifact path ${pathParts.join('/')}.`);
+            }
+            paths.add(pathKey);
+            return {
+                logicalName,
+                category,
+                pathParts,
+                generatedBy,
+                generationHash,
+                provisioningGroup
+            };
+        });
+    }
+    function normalizeProjectProvisioningGroup(value, scope) {
+        if (value === 'base' ||
+            value === 'frontend') {
+            return value;
+        }
+        const prefix = 'environment:';
+        if (value.startsWith(prefix)) {
+            const environmentValue = value.slice(prefix.length);
+            const environment = getEnvironment(environmentValue);
+            if (environment?.id === environmentValue) {
+                return `environment:${environment.id}`;
+            }
+        }
+        throw new FileSystemError(`${scope}.provisioningGroup is invalid.`);
+    }
+    function validateV6AndV7ArtifactAuthority(managedArtifacts, projectArtifacts) {
+        for (const artifact of managedArtifacts) {
+            if (isManagedCoreLogicalName(artifact.logicalName)) {
+                continue;
+            }
+            if (isRetiredManagedCoreLogicalName(artifact.logicalName)) {
+                if (!isRetiredManagedCoreArtifactIdentity(artifact.logicalName, artifact.category, artifact.pathParts)) {
+                    throw new FileSystemError(`Retired managed-core artifact ${artifact.logicalName} has invalid identity.`);
+                }
+                continue;
+            }
+            if (isUnknownRetiredManagedCoreAliasLogicalName(artifact.logicalName)) {
+                throw new FileSystemError(`Manifest managed artifact ${artifact.logicalName} is an unknown retired managed-core alias logical name.`);
+            }
+            throw new FileSystemError(`Manifest managed artifact ${artifact.logicalName} is not an explicit managed-core logical name.`);
+        }
+        for (const artifact of projectArtifacts) {
+            if (isManagedCoreLogicalName(artifact.logicalName)) {
+                throw new FileSystemError(`Manifest project artifact ${artifact.logicalName} cannot contain a managed-core logical name.`);
+            }
+            if (isRetiredManagedCoreLogicalName(artifact.logicalName)) {
+                throw new FileSystemError(`Manifest project artifact ${artifact.logicalName} cannot contain a retired managed-core logical name.`);
+            }
+            if (isUnknownRetiredManagedCoreAliasLogicalName(artifact.logicalName)) {
+                throw new FileSystemError(`Manifest project artifact ${artifact.logicalName} cannot contain an unknown retired managed-core alias logical name.`);
+            }
+        }
+    }
+    function validateManifestArtifactUniqueness(managedArtifacts, projectArtifacts) {
+        const logicalNames = new Set();
+        const paths = new Set();
+        for (const artifact of [...managedArtifacts, ...projectArtifacts]) {
+            if (logicalNames.has(artifact.logicalName)) {
+                throw new FileSystemError(`Manifest contains duplicate logicalName ${JSON.stringify(artifact.logicalName)}.`);
+            }
+            logicalNames.add(artifact.logicalName);
+            const pathKey = artifact.pathParts.join('\0');
+            if (paths.has(pathKey)) {
+                throw new FileSystemError(`Manifest contains duplicate artifact path ${artifact.pathParts.join('/')}.`);
+            }
+            paths.add(pathKey);
+        }
+    }
+    return { normalizeManifestManagedArtifacts, normalizeManifestProjectArtifacts,
+        validateV6AndV7ArtifactAuthority, validateManifestArtifactUniqueness };
+}
+//# sourceMappingURL=artifacts.js.map