nawabari 0.9.2 → 0.10.2

package/dist/domain/runtime-file-identity.js

@@ -0,0 +1,114 @@
+import fs from "node:fs";
+let testHooks;
+function identityOf(stat) {
+    return Object.freeze({ dev: stat.dev, ino: stat.ino });
+}
+function sameIdentity(left, right) {
+    return left.dev === right.dev && left.ino === right.ino;
+}
+function verifyCanonicalIdentity(candidate, source, identity, requireCanonicalPath) {
+    if (requireCanonicalPath && source !== candidate) {
+        throw new Error("the file resolves through a symlink");
+    }
+    testHooks?.beforeFinalIdentityCheck?.(source, identity);
+    const pathStat = requireCanonicalPath
+        ? fs.lstatSync(candidate, { bigint: true })
+        : fs.statSync(source, { bigint: true });
+    if (!pathStat.isFile() || !sameIdentity(identity, identityOf(pathStat))) {
+        throw new Error("the file identity changed during materialization");
+    }
+}
+/**
+ * Open and inspect one regular file through one descriptor, then prove that
+ * its canonical pathname still names the descriptor's Linux file identity.
+ */
+export function inspectRuntimeFile(candidate, inspect, options = {}) {
+    let descriptor = null;
+    try {
+        descriptor = fs.openSync(candidate, fs.constants.O_RDONLY);
+        const descriptorStat = fs.fstatSync(descriptor, { bigint: true });
+        if (!descriptorStat.isFile())
+            throw new Error("the file is not regular");
+        const source = fs.realpathSync.native(candidate);
+        if (options.requireCanonicalPath === true && source !== candidate) {
+            throw new Error("the file resolves through a symlink");
+        }
+        const value = inspect(descriptor, descriptorStat);
+        verifyCanonicalIdentity(candidate, source, identityOf(descriptorStat), options.requireCanonicalPath === true);
+        return Object.freeze({ source, identity: identityOf(descriptorStat), value });
+    }
+    finally {
+        if (descriptor !== null) {
+            try {
+                fs.closeSync(descriptor);
+            }
+            catch {
+                // Preserve the inspection result or original failure.
+            }
+        }
+    }
+}
+/** Read a bounded file through an already inspected descriptor. */
+export function readRuntimeFile(descriptor, size, maximum) {
+    const maximumSize = BigInt(maximum);
+    if (size < 0n || size > maximumSize)
+        throw new Error("the file exceeds the bounded inspection size");
+    const length = Number(size);
+    const buffer = Buffer.alloc(length);
+    let offset = 0;
+    while (offset < length) {
+        const bytes = fs.readSync(descriptor, buffer, offset, length - offset, null);
+        if (bytes === 0)
+            throw new Error("the file ended during descriptor inspection");
+        offset += bytes;
+    }
+    return buffer;
+}
+/**
+ * Exclusively create, write, chmod, and identity-check one file. On failure,
+ * the invocation-owned partial artifact is left in place rather than removed
+ * by pathname: a pathname-based unlink after the identity check would race
+ * against a replacement at that path and could delete a competing file. The
+ * next materialization attempt fails closed on the existing destination.
+ */
+export function createRuntimeFile(destination, write) {
+    let descriptor = null;
+    try {
+        testHooks?.beforeExclusiveCreate?.(destination);
+        descriptor = fs.openSync(destination, fs.constants.O_WRONLY | fs.constants.O_CREAT | fs.constants.O_EXCL, 0o755);
+        const descriptorStat = fs.fstatSync(descriptor, { bigint: true });
+        if (!descriptorStat.isFile())
+            throw new Error("the created file is not regular");
+        const createdIdentity = identityOf(descriptorStat);
+        const value = write(descriptor, descriptorStat);
+        const source = fs.realpathSync.native(destination);
+        verifyCanonicalIdentity(destination, source, createdIdentity, true);
+        return value;
+    }
+    finally {
+        if (descriptor !== null) {
+            try {
+                fs.closeSync(descriptor);
+            }
+            catch {
+                // Preserve the original creation result.
+            }
+        }
+    }
+}
+/**
+ * Test-only seam for deterministic replacement and exclusive-create races.
+ * It is intentionally private to the runtime/domain implementation and is
+ * never re-exported by Nawabari's public API.
+ */
+export function withRuntimeFileIdentityTestHooks(hooks, action) {
+    const previous = testHooks;
+    testHooks = hooks;
+    try {
+        return action();
+    }
+    finally {
+        testHooks = previous;
+    }
+}
+//# sourceMappingURL=runtime-file-identity.js.map

package/dist/domain/runtime-file-identity.js.map

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

package/dist/domain/runtime-profile.d.ts

@@ -0,0 +1,66 @@
+import { DomainError, type DomainResult, type ErrorCode, type JsonObject } from "./errors.js";
+import type { RuntimeProfileIdentity, RuntimeRequirement } from "./runtime-projection.js";
+/** Versioned identity for the logical runtime-profile/material contract. */
+export declare const RUNTIME_PROFILE_CONTRACT_ID: "nawabari.runtime-profile.v1";
+export declare const RUNTIME_PROFILE_SCHEMA_VERSION: 1;
+export declare const RUNTIME_PROFILE_REQUIREMENT_KINDS: readonly ["runtime", "package"];
+export type RuntimeProfileRequirement = RuntimeRequirement;
+export type RuntimeProfileRequirementKind = (typeof RUNTIME_PROFILE_REQUIREMENT_KINDS)[number];
+/** A profile is material identity plus logical requirements, never mounts or commands. */
+export type RuntimeProfileDefinition = Readonly<{
+    readonly id: string;
+    readonly version: string;
+    readonly extends: readonly string[];
+    readonly requirements: readonly RuntimeProfileRequirement[];
+}>;
+export type RuntimeProfileRequirementOperation = Readonly<{
+    readonly operation: "add";
+    readonly requirement: RuntimeProfileRequirement;
+}> | Readonly<{
+    readonly operation: "remove";
+    readonly requirement_id: string;
+}> | Readonly<{
+    readonly operation: "override";
+    readonly requirement: RuntimeProfileRequirement;
+}>;
+/** Profile IDs are an explicit composition set; operation order is explicit and significant. */
+export type RuntimeProfileSelection = Readonly<{
+    readonly profiles: readonly string[];
+    readonly operations?: readonly RuntimeProfileRequirementOperation[];
+}>;
+export type ResolvedRuntimeProfile = Readonly<{
+    readonly contract_id: typeof RUNTIME_PROFILE_CONTRACT_ID;
+    readonly schema_version: typeof RUNTIME_PROFILE_SCHEMA_VERSION;
+    readonly profile: RuntimeProfileIdentity;
+    readonly selected_profiles: readonly RuntimeProfileIdentity[];
+    readonly requirements: readonly RuntimeProfileRequirement[];
+}>;
+export type RuntimeProfileErrorCode = Extract<ErrorCode, "RUNTIME_PROFILE_INVALID" | "RUNTIME_PROFILE_AMBIGUOUS" | "RUNTIME_PROFILE_MISSING" | "RUNTIME_PROFILE_REQUIREMENT_MISSING" | "RUNTIME_PROFILE_REQUIREMENT_CONFLICT">;
+/**
+ * Resolve an explicit, backend-neutral profile selection without consulting
+ * PATH, home directories, shell configuration, package managers, or the host.
+ */
+export declare function resolveRuntimeProfile(selection: unknown, catalog?: unknown): DomainResult<ResolvedRuntimeProfile>;
+/** Convenience form for callers that already have explicit profile IDs. */
+export declare function composeRuntimeProfiles(profiles: readonly string[], operations?: readonly RuntimeProfileRequirementOperation[], catalog?: readonly RuntimeProfileDefinition[]): DomainResult<ResolvedRuntimeProfile>;
+export declare const selectRuntimeProfile: typeof resolveRuntimeProfile;
+export declare const BASE_RUNTIME_PROFILE: RuntimeProfileDefinition;
+export declare const MINIMAL_RUNTIME_PROFILE: Readonly<{
+    readonly id: string;
+    readonly version: string;
+    readonly extends: readonly string[];
+    readonly requirements: readonly RuntimeProfileRequirement[];
+}>;
+export declare const DEVELOPMENT_RUNTIME_PROFILE: RuntimeProfileDefinition;
+export declare const DEFAULT_DEVELOPMENT_RUNTIME_PROFILE: Readonly<{
+    readonly id: string;
+    readonly version: string;
+    readonly extends: readonly string[];
+    readonly requirements: readonly RuntimeProfileRequirement[];
+}>;
+export declare const CANONICAL_RUNTIME_PROFILES: readonly RuntimeProfileDefinition[];
+export declare function isRuntimeProfileError(error: DomainError): error is DomainError & {
+    readonly code: RuntimeProfileErrorCode;
+};
+/** JSON-safe descriptor for consumers that need to identify this contract. */
+export declare const RUNTIME_PROFILE_DESCRIPTOR: JsonObject;

package/dist/domain/runtime-profile.js

@@ -0,0 +1,356 @@
+import { DomainError, failure, success } from "./errors.js";
+/** Versioned identity for the logical runtime-profile/material contract. */
+export const RUNTIME_PROFILE_CONTRACT_ID = "nawabari.runtime-profile.v1";
+export const RUNTIME_PROFILE_SCHEMA_VERSION = 1;
+export const RUNTIME_PROFILE_REQUIREMENT_KINDS = Object.freeze(["runtime", "package"]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNonEmptyText(value) {
+    return typeof value === "string" && value.length > 0 && !value.includes("\u0000");
+}
+function isStableIdentifier(value) {
+    return typeof value === "string" && /^[a-z0-9][a-z0-9._-]*$/u.test(value);
+}
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function requirementKey(requirement) {
+    return requirement.id;
+}
+function requirementSortKey(requirement) {
+    return `${requirement.kind}:${requirement.id}`;
+}
+function sameRequirement(left, right) {
+    return left.id === right.id && left.kind === right.kind && left.name === right.name && left.version === right.version;
+}
+function profileFailure(code, field, reason, details = {}) {
+    return failure(new DomainError(code, `Runtime profile field '${field}' is invalid: ${reason}.`, {
+        field,
+        ...details,
+    }));
+}
+function profileAmbiguity(field, reason, value) {
+    return failure(new DomainError("RUNTIME_PROFILE_AMBIGUOUS", `Runtime profile field '${field}' is ambiguous: ${reason}.`, {
+        field,
+        value,
+    }));
+}
+function missingProfile(profileId, referencedBy) {
+    return failure(new DomainError("RUNTIME_PROFILE_MISSING", `Runtime profile '${profileId}' is not declared.`, {
+        profile_id: profileId,
+        ...(referencedBy === undefined ? {} : { referenced_by: referencedBy }),
+    }));
+}
+function missingRequirement(requirementId, operation) {
+    return failure(new DomainError("RUNTIME_PROFILE_REQUIREMENT_MISSING", `Runtime profile requirement '${requirementId}' cannot be ${operation}d because it is not selected.`, { requirement_id: requirementId, operation }));
+}
+function validateRequirement(value, field) {
+    if (!isRecord(value))
+        return profileFailure("RUNTIME_PROFILE_INVALID", field, "expected a requirement object");
+    if (!isStableIdentifier(value.id) ||
+        !RUNTIME_PROFILE_REQUIREMENT_KINDS.includes(value.kind) ||
+        !isNonEmptyText(value.name) ||
+        !isNonEmptyText(value.version)) {
+        return profileFailure("RUNTIME_PROFILE_INVALID", field, "expected stable id, kind, name, and version");
+    }
+    if (value.name.startsWith("/") ||
+        value.name.startsWith("~") ||
+        value.name.startsWith("$") ||
+        value.version.startsWith("/") ||
+        value.version.startsWith("~") ||
+        value.version.startsWith("$")) {
+        return profileFailure("RUNTIME_PROFILE_INVALID", field, "host paths are not logical package names or versions");
+    }
+    if ("source" in value || "target" in value || "provider" in value || "executable" in value) {
+        return profileFailure("RUNTIME_PROFILE_INVALID", field, "runtime profiles declare material only and cannot contain projection or executable fields");
+    }
+    return success(Object.freeze({
+        id: value.id,
+        kind: value.kind,
+        name: value.name,
+        version: value.version,
+    }));
+}
+function validateDefinition(value, index) {
+    const field = `catalog[${index}]`;
+    if (!isRecord(value))
+        return profileFailure("RUNTIME_PROFILE_INVALID", field, "expected a profile object");
+    if (!isStableIdentifier(value.id) || !isNonEmptyText(value.version)) {
+        return profileFailure("RUNTIME_PROFILE_INVALID", field, "expected a stable id and non-empty version");
+    }
+    if (!Array.isArray(value.extends)) {
+        return profileFailure("RUNTIME_PROFILE_INVALID", `${field}.extends`, "expected an array");
+    }
+    if (!Array.isArray(value.requirements)) {
+        return profileFailure("RUNTIME_PROFILE_INVALID", `${field}.requirements`, "expected an array");
+    }
+    if ("filesystem" in value || "executables" in value) {
+        return profileFailure("RUNTIME_PROFILE_INVALID", field, "runtime profiles cannot contain filesystem or executable projections");
+    }
+    const parents = [];
+    for (const [parentIndex, parent] of value.extends.entries()) {
+        if (!isStableIdentifier(parent)) {
+            return profileFailure("RUNTIME_PROFILE_INVALID", `${field}.extends[${parentIndex}]`, "expected a stable profile id");
+        }
+        if (parents.includes(parent))
+            return profileAmbiguity(`${field}.extends`, "duplicate parent profile", parent);
+        parents.push(parent);
+    }
+    const requirements = [];
+    const ids = new Set();
+    for (const [requirementIndex, requirement] of value.requirements.entries()) {
+        const result = validateRequirement(requirement, `${field}.requirements[${requirementIndex}]`);
+        if (!result.ok)
+            return failure(result.error);
+        if (ids.has(result.value.id)) {
+            return profileAmbiguity(`${field}.requirements`, "duplicate requirement id", result.value.id);
+        }
+        ids.add(result.value.id);
+        requirements.push(result.value);
+    }
+    return success(Object.freeze({
+        id: value.id,
+        version: value.version,
+        extends: Object.freeze(parents.sort(compareText)),
+        requirements: Object.freeze(requirements.sort((left, right) => compareText(requirementSortKey(left), requirementSortKey(right)))),
+    }));
+}
+function validateCatalog(value) {
+    if (!Array.isArray(value))
+        return profileFailure("RUNTIME_PROFILE_INVALID", "catalog", "expected an array");
+    const catalog = new Map();
+    for (const [index, definition] of value.entries()) {
+        const result = validateDefinition(definition, index);
+        if (!result.ok)
+            return failure(result.error);
+        if (catalog.has(result.value.id))
+            return profileAmbiguity("catalog", "duplicate profile id", result.value.id);
+        catalog.set(result.value.id, result.value);
+    }
+    return success(catalog);
+}
+function validateSelection(value) {
+    if (!isRecord(value) || !Array.isArray(value.profiles) || value.profiles.length === 0) {
+        return profileFailure("RUNTIME_PROFILE_INVALID", "selection.profiles", "expected a non-empty array");
+    }
+    const profiles = [];
+    for (const [index, profile] of value.profiles.entries()) {
+        if (!isStableIdentifier(profile)) {
+            return profileFailure("RUNTIME_PROFILE_INVALID", `selection.profiles[${index}]`, "expected a stable profile id");
+        }
+        if (profiles.includes(profile))
+            return profileAmbiguity("selection.profiles", "duplicate selected profile", profile);
+        profiles.push(profile);
+    }
+    if (value.operations !== undefined && !Array.isArray(value.operations)) {
+        return profileFailure("RUNTIME_PROFILE_INVALID", "selection.operations", "expected an array");
+    }
+    const operations = [];
+    for (const [index, operation] of (value.operations ?? []).entries()) {
+        const field = `selection.operations[${index}]`;
+        if (!isRecord(operation) ||
+            (operation.operation !== "add" && operation.operation !== "remove" && operation.operation !== "override")) {
+            return profileFailure("RUNTIME_PROFILE_INVALID", field, "expected add, remove, or override");
+        }
+        if (operation.operation === "remove") {
+            if (!isStableIdentifier(operation.requirement_id)) {
+                return profileFailure("RUNTIME_PROFILE_INVALID", `${field}.requirement_id`, "expected a stable requirement id");
+            }
+            operations.push(Object.freeze({ operation: "remove", requirement_id: operation.requirement_id }));
+            continue;
+        }
+        const requirement = validateRequirement(operation.requirement, `${field}.requirement`);
+        if (!requirement.ok)
+            return failure(requirement.error);
+        operations.push(Object.freeze({ operation: operation.operation, requirement: requirement.value }));
+    }
+    return success({
+        profiles: Object.freeze(profiles.sort(compareText)),
+        operations: Object.freeze(operations),
+    });
+}
+function mergeRequirements(target, requirements, source) {
+    for (const requirement of requirements) {
+        const key = requirementKey(requirement);
+        const existing = target.get(key);
+        if (existing === undefined) {
+            target.set(key, requirement);
+            continue;
+        }
+        if (!sameRequirement(existing, requirement)) {
+            return failure(new DomainError("RUNTIME_PROFILE_REQUIREMENT_CONFLICT", `Runtime profile requirement '${requirement.id}' has conflicting definitions.`, {
+                requirement_id: requirement.id,
+                existing_name: existing.name,
+                existing_version: existing.version,
+                conflicting_name: requirement.name,
+                conflicting_version: requirement.version,
+                source,
+            }));
+        }
+    }
+    return success(null);
+}
+function resolveDefinition(profileId, catalog, states, resolved) {
+    const cached = resolved.get(profileId);
+    if (cached !== undefined)
+        return success(cached);
+    if (states.get(profileId) === "visiting") {
+        return profileAmbiguity("catalog.extends", "profile inheritance cycle", profileId);
+    }
+    const definition = catalog.get(profileId);
+    if (definition === undefined)
+        return missingProfile(profileId);
+    states.set(profileId, "visiting");
+    const requirements = new Map();
+    for (const parent of definition.extends) {
+        const result = resolveDefinition(parent, catalog, states, resolved);
+        if (!result.ok) {
+            if (result.error.code === "RUNTIME_PROFILE_MISSING") {
+                return missingProfile(parent, profileId);
+            }
+            return failure(result.error);
+        }
+        const merged = mergeRequirements(requirements, result.value, parent);
+        if (!merged.ok)
+            return failure(merged.error);
+    }
+    const merged = mergeRequirements(requirements, definition.requirements, profileId);
+    if (!merged.ok)
+        return failure(merged.error);
+    const canonical = Object.freeze([...requirements.values()].sort((left, right) => compareText(requirementSortKey(left), requirementSortKey(right))));
+    states.set(profileId, "resolved");
+    resolved.set(profileId, canonical);
+    return success(canonical);
+}
+function applyOperations(requirements, operations) {
+    for (const operation of operations) {
+        if (operation.operation === "remove") {
+            if (!requirements.has(operation.requirement_id))
+                return missingRequirement(operation.requirement_id, "remove");
+            requirements.delete(operation.requirement_id);
+            continue;
+        }
+        const key = requirementKey(operation.requirement);
+        if (operation.operation === "add") {
+            if (requirements.has(key)) {
+                return failure(new DomainError("RUNTIME_PROFILE_REQUIREMENT_CONFLICT", `Runtime profile requirement '${operation.requirement.id}' is added twice.`, {
+                    requirement_id: operation.requirement.id,
+                    operation: "add",
+                }));
+            }
+            requirements.set(key, operation.requirement);
+            continue;
+        }
+        const existing = requirements.get(key);
+        if (existing === undefined)
+            return missingRequirement(operation.requirement.id, "override");
+        if (existing.kind !== operation.requirement.kind) {
+            return failure(new DomainError("RUNTIME_PROFILE_REQUIREMENT_CONFLICT", `Runtime profile requirement '${operation.requirement.id}' cannot change kind during override.`, {
+                requirement_id: operation.requirement.id,
+                existing_kind: existing.kind,
+                conflicting_kind: operation.requirement.kind,
+                operation: "override",
+            }));
+        }
+        requirements.set(key, operation.requirement);
+    }
+    return success(null);
+}
+function composedIdentity(definitions, operationCount, requirements) {
+    if (definitions.length === 1 && operationCount === 0) {
+        return Object.freeze({ id: definitions[0].id, version: definitions[0].version });
+    }
+    const id = `composition-${definitions.map((definition) => definition.id).join("--")}${operationCount === 0 ? "" : "-custom"}`;
+    const material = requirements
+        .map((requirement) => `${requirement.id}=${requirement.kind}:${requirement.name}@${requirement.version}`)
+        .join(",");
+    const version = `${definitions.map((definition) => definition.version).join("+")}:${material}`;
+    return Object.freeze({ id, version });
+}
+/**
+ * Resolve an explicit, backend-neutral profile selection without consulting
+ * PATH, home directories, shell configuration, package managers, or the host.
+ */
+export function resolveRuntimeProfile(selection, catalog = CANONICAL_RUNTIME_PROFILES) {
+    const catalogResult = validateCatalog(catalog);
+    if (!catalogResult.ok)
+        return failure(catalogResult.error);
+    const selectionResult = validateSelection(selection);
+    if (!selectionResult.ok)
+        return failure(selectionResult.error);
+    const states = new Map();
+    const resolved = new Map();
+    const requirements = new Map();
+    const definitions = [];
+    for (const profileId of selectionResult.value.profiles) {
+        const definition = catalogResult.value.get(profileId);
+        if (definition === undefined)
+            return missingProfile(profileId);
+        definitions.push(definition);
+        const result = resolveDefinition(profileId, catalogResult.value, states, resolved);
+        if (!result.ok)
+            return failure(result.error);
+        const merged = mergeRequirements(requirements, result.value, profileId);
+        if (!merged.ok)
+            return failure(merged.error);
+    }
+    const operations = selectionResult.value.operations;
+    const applied = applyOperations(requirements, operations);
+    if (!applied.ok)
+        return failure(applied.error);
+    const selectedProfiles = Object.freeze([...definitions]
+        .sort((left, right) => compareText(left.id, right.id))
+        .map((definition) => Object.freeze({ id: definition.id, version: definition.version })));
+    return success(Object.freeze({
+        contract_id: RUNTIME_PROFILE_CONTRACT_ID,
+        schema_version: RUNTIME_PROFILE_SCHEMA_VERSION,
+        profile: composedIdentity(definitions, operations.length, [...requirements.values()].sort((left, right) => compareText(requirementSortKey(left), requirementSortKey(right)))),
+        selected_profiles: selectedProfiles,
+        requirements: Object.freeze([...requirements.values()].sort((left, right) => compareText(requirementSortKey(left), requirementSortKey(right)))),
+    }));
+}
+/** Convenience form for callers that already have explicit profile IDs. */
+export function composeRuntimeProfiles(profiles, operations = [], catalog = CANONICAL_RUNTIME_PROFILES) {
+    return resolveRuntimeProfile({ profiles, operations }, catalog);
+}
+export const selectRuntimeProfile = resolveRuntimeProfile;
+export const BASE_RUNTIME_PROFILE = Object.freeze({
+    id: "base",
+    version: "1",
+    extends: Object.freeze([]),
+    requirements: Object.freeze([Object.freeze({ id: "node-runtime", kind: "runtime", name: "node", version: ">=24" })]),
+});
+export const MINIMAL_RUNTIME_PROFILE = BASE_RUNTIME_PROFILE;
+export const DEVELOPMENT_RUNTIME_PROFILE = Object.freeze({
+    id: "development",
+    version: "1",
+    extends: Object.freeze(["base"]),
+    requirements: Object.freeze([
+        Object.freeze({ id: "git-package", kind: "package", name: "git", version: ">=2" }),
+        Object.freeze({ id: "pnpm-package", kind: "package", name: "pnpm", version: ">=11" }),
+    ]),
+});
+export const DEFAULT_DEVELOPMENT_RUNTIME_PROFILE = DEVELOPMENT_RUNTIME_PROFILE;
+export const CANONICAL_RUNTIME_PROFILES = Object.freeze([
+    BASE_RUNTIME_PROFILE,
+    DEVELOPMENT_RUNTIME_PROFILE,
+]);
+export function isRuntimeProfileError(error) {
+    return (error.code === "RUNTIME_PROFILE_INVALID" ||
+        error.code === "RUNTIME_PROFILE_AMBIGUOUS" ||
+        error.code === "RUNTIME_PROFILE_MISSING" ||
+        error.code === "RUNTIME_PROFILE_REQUIREMENT_MISSING" ||
+        error.code === "RUNTIME_PROFILE_REQUIREMENT_CONFLICT");
+}
+/** JSON-safe descriptor for consumers that need to identify this contract. */
+export const RUNTIME_PROFILE_DESCRIPTOR = Object.freeze({
+    contract_id: RUNTIME_PROFILE_CONTRACT_ID,
+    schema_version: RUNTIME_PROFILE_SCHEMA_VERSION,
+    fields: ["profile", "selected_profiles", "requirements"],
+    ownership: {
+        describes: "logical runtime/package material",
+        excludes: ["filesystem", "executables", "providers", "host-discovery"],
+    },
+});
+//# sourceMappingURL=runtime-profile.js.map

package/dist/domain/runtime-profile.js.map

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