@vibesdotdev/infra-core 0.0.2 → 1.0.0-rc.4

package/dist/schemas.js

@@ -1,27 +1,15 @@
 import * as z from 'zod/v4';
-/**
- * Deployment providers with active adapter implementations.
- * Only providers backed by adapter packages are enumerated.
- * - cloudflare-workers: via infra-cloudflare
- * - digitalocean-app: via infra-doks
- */
-export const deploymentProviderSchema = z.enum([
-    'cloudflare-workers',
-    'digitalocean-app'
-]);
-/**
- * Map of valid provider × runtime combinations.
- * Used for cross-validation in appDeploymentSchema refinement.
- */
-const VALID_PROVIDER_RUNTIME_MATRIX = {
-    'cloudflare-workers': ['edge', 'worker'],
-    'digitalocean-app': ['node', 'worker']
-};
+import { deploymentOriginKindSchema } from '@vibesdotdev/infra-contracts';
+export { deploymentOriginKindSchema } from '@vibesdotdev/infra-contracts';
+/** Provider IDs are open; the handed runtime admits registered capabilities. */
+export const deploymentProviderSchema = z.string().min(1);
 export const appRuntimeSchema = z.enum(['edge', 'node', 'worker', 'browser']);
+/** The environment variables an upstream's origin is published as (`NAME` → origin). */
+export const deploymentOriginEnvSchema = z.record(z.string().regex(/^[_A-Z0-9]+$/), z.string());
 export const deploymentOriginSchema = z.object({
     hostname: z.string().min(1),
     origin: z.string().url(),
-    kind: z.enum(['primary', 'redirect', 'preview', 'internal']).default('primary'),
+    kind: deploymentOriginKindSchema.default('primary'),
     description: z.string().optional()
 });
 export const deploymentBuildSchema = z.object({
@@ -43,11 +31,20 @@ export const deploymentEnvRequirementSchema = z.object({
      * Only meaningful when `secret: true` and the deployment targets a shared
      * Secrets Store binding (e.g. `secrets_store_secrets[].secret_name`).
      */
-    storeKey: z.string().min(1).optional()
+    storeKey: z.string().min(1).optional(),
+    /**
+     * When `false`, this secret never emits a `secrets_store_secrets[]` binding —
+     * it is read via runtime env only (e.g. `$env/dynamic/private` in local dev).
+     * Wrangler hard-rejects a deploy whose binding references a store secret that
+     * does not exist, so local-only secrets must opt out of store binding.
+     * Defaults to `true` (bound) for `secret: true` entries.
+     */
+    storeBinding: z.boolean().optional()
 });
 export const deploymentDependencySchema = z.object({
     appId: z.string().min(1),
-    reason: z.string().min(1)
+    reason: z.string().min(1),
+    required: z.boolean().default(true)
 });
 export const deploymentUpstreamSchema = z.object({
     name: z.string().min(1),
@@ -58,11 +55,30 @@ export const deploymentUpstreamSchema = z.object({
         .regex(/^[_A-Z0-9]+$/)
         .optional()
 });
+/** Execution requirements validated against the registered provider at admission. */
+export const deploymentExecutionSchema = z
+    .object({
+    /** App needs an interactive PTY session. */
+    pty: z.boolean().optional(),
+    /** App runs commands through a shell. */
+    shell: z.boolean().optional(),
+    /** Maximum concurrent live PTY sessions this host advertises. */
+    maxSessions: z.number().int().positive().optional()
+})
+    .optional();
 export const appDeploymentSchema = z
     .object({
     appId: z.string().min(1),
     appName: z.string().min(1),
     provider: deploymentProviderSchema,
+    /**
+     * The plugin specifier that registers `provider` as an
+     * `infra/deployment-provider`, declared by the provider package's own
+     * deployment factory. A deploy whose runtime has not composed `provider`
+     * composes this plugin first, so a checkout CLI deploys with the
+     * provider its deployment names and no host lists it.
+     */
+    providerPlugin: z.string().trim().min(1).optional(),
     runtime: appRuntimeSchema,
     build: deploymentBuildSchema,
     origins: z.array(deploymentOriginSchema).min(1),
@@ -87,16 +103,106 @@ export const appDeploymentSchema = z
         command: z.string().min(1),
         description: z.string().optional()
     }))
-        .default([])
+        .default([]),
+    execution: deploymentExecutionSchema,
+    /**
+     * Schema migrations of the databases this app declares. A failed local
+     * migration pass of an app that sets `requiredForLocalDev` stops the dev
+     * stack; any other app's failure is reported and the stack starts.
+     */
+    migrations: z
+        .object({
+        requiredForLocalDev: z.boolean().default(false)
+    })
+        .optional()
+});
+/** Default preview TTL in hours. Redeploys refresh `expiresAt` from this. */
+export const DEFAULT_PREVIEW_TTL_HOURS = 72;
+export const PreviewRecordStatusSchema = z.enum(['building', 'live', 'failed', 'destroyed']);
+export const PreviewRepoOfRecordSchema = z.enum(['forge', 'github']);
+export const PreviewSecretsModeSchema = z.enum(['namespace', 'script-pushed']);
+/** Provider-reported availability for one declared preview capability. */
+export const PreviewCapabilityStatusSchema = z.enum([
+    'available',
+    'degraded',
+    'unavailable',
+    'not-declared'
+]);
+/** Resource isolation achieved by a rendered preview binding. */
+export const PreviewCapabilityIsolationSchema = z.enum([
+    'preview-tier',
+    'shared-external',
+    'none',
+    'not-applicable'
+]);
+/** Machine-readable proof of what one preview capability actually renders. */
+export const PreviewCapabilitySchema = z.object({
+    status: PreviewCapabilityStatusSchema,
+    isolation: PreviewCapabilityIsolationSchema,
+    critical: z.boolean(),
+    declared: z.array(z.string()),
+    rendered: z.array(z.string()),
+    reason: z.string().min(1)
+});
+export const PreviewFidelityLevelSchema = z.enum(['full', 'degraded']);
+/**
+ * Provider-neutral preview fidelity envelope. Providers own the capability
+ * facts; orchestration surfaces expose this exact shape and may require
+ * `level: 'full'` before any build or upload begins.
+ */
+export const PreviewFidelitySchema = z
+    .object({
+    level: PreviewFidelityLevelSchema,
+    fullFidelity: z.boolean(),
+    criticalMissing: z.array(z.string()),
+    capabilities: z.record(z.string(), PreviewCapabilitySchema)
 })
-    .refine((data) => {
-    const validRuntimes = VALID_PROVIDER_RUNTIME_MATRIX[data.provider];
-    return validRuntimes.includes(data.runtime);
-}, {
-    error: (issue) => {
-        const data = issue.input;
-        return `Invalid runtime "${data.runtime}" for provider "${data.provider}". Valid runtimes: ${VALID_PROVIDER_RUNTIME_MATRIX[data.provider].join(', ')}`;
-    },
-    path: ['runtime']
+    .superRefine((fidelity, ctx) => {
+    const actualMissing = Object.entries(fidelity.capabilities)
+        .filter(([, capability]) => capability.critical && capability.status !== 'available')
+        .map(([name]) => name)
+        .sort();
+    const claimedMissing = [...new Set(fidelity.criticalMissing)].sort();
+    const expectedFull = actualMissing.length === 0;
+    if (fidelity.fullFidelity !== expectedFull ||
+        fidelity.level !== (expectedFull ? 'full' : 'degraded')) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['level'],
+            message: 'Preview fidelity level/fullFidelity must match critical capability availability.'
+        });
+    }
+    if (JSON.stringify(claimedMissing) !== JSON.stringify(actualMissing)) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['criticalMissing'],
+            message: 'criticalMissing must name every unavailable critical capability exactly once.'
+        });
+    }
+});
+/**
+ * Current-state record for one preview deployment (one per previewId).
+ * Persisted as the `infra-deploy.previews` storage manifest (infra-deploy);
+ * `runId` references the matching `deployment_runs` history row.
+ */
+export const PreviewRecordSchema = z.object({
+    previewId: z.string().min(1),
+    appId: z.string().min(1),
+    branch: z.string().min(1),
+    worktreePath: z.string().min(1).optional(),
+    /** Build-input ref, e.g. `refs/previews/<previewId>`. */
+    previewRef: z.string().min(1).optional(),
+    sha: z.string().min(1),
+    repoOfRecord: PreviewRepoOfRecordSchema.default('forge'),
+    buildJobId: z.string().min(1).optional(),
+    status: PreviewRecordStatusSchema,
+    url: z.string().url(),
+    dispatchScript: z.string().min(1),
+    secretsMode: PreviewSecretsModeSchema.default('script-pushed'),
+    fidelity: PreviewFidelitySchema.optional(),
+    ttlHours: z.number().int().positive().default(DEFAULT_PREVIEW_TTL_HOURS),
+    expiresAt: z.string().datetime(),
+    createdBy: z.string().min(1),
+    runId: z.string().min(1)
 });
 //# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/service.d.ts

@@ -0,0 +1,87 @@
+import * as z from 'zod/v4';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import type { RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/descriptor';
+import { canonicalOrigin } from '@vibesdotdev/config/environment/canonical-origin';
+import type { ConfigManifestDescriptor } from '@vibesdotdev/config/schemas/config-manifest-descriptor';
+import { type ServiceDescriptor, type ServiceEnvironment, type ServicePort, type ServiceTarget, type ServiceTargetKind } from '@vibesdotdev/infra-contracts';
+export { ServiceOriginSchema, ServiceDescriptorSchema } from '@vibesdotdev/infra-contracts';
+export type { ServiceDescriptor, ServiceEnvironment } from '@vibesdotdev/infra-contracts';
+export declare class ServiceImplementation implements ServicePort {
+    readonly descriptor: ServiceDescriptor;
+    private readonly runtime;
+    constructor(descriptor: RuntimeDescriptor, context: KindContext);
+    /**
+     * This service's origin in the constructing runtime's configured service
+     * environment. Consumers resolve it through the `infra/service` kind, so
+     * reading an origin needs no import of this package.
+     */
+    target(kind?: ServiceTargetKind): Promise<ServiceTarget>;
+    /** Compatibility door: the service owner selects the same target once. */
+    origin(kind?: ServiceTargetKind): Promise<string>;
+}
+export declare const serviceKind: import("@vibesdotdev/kernel").RuntimeKindDescriptorRecord<ServiceImplementation>;
+export declare const InfraServicesConfigSchema: z.ZodObject<{
+    environment: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+        local: "local";
+        dev: "dev";
+        staging: "staging";
+        production: "production";
+    }>, z.ZodLiteral<"host">]>>;
+    origins: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        primary: z.ZodOptional<z.ZodURL>;
+        internal: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type InfraServicesConfig = z.infer<typeof InfraServicesConfigSchema>;
+export declare const infraServicesConfigManifest: ConfigManifestDescriptor;
+export declare const infraServicesPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+/** Pure selection from one runtime-resolved declaration; no hostname guesses. */
+export declare function originOf(service: ServiceDescriptor | ServiceImplementation | null | undefined, environment: ServiceEnvironment, kind?: 'primary' | 'internal'): string;
+/** The `infra/service` reader lives with the contract, so consumers need no import of this package. */
+export { serviceOrigin } from '@vibesdotdev/infra-contracts/service';
+/**
+ * The service's local dev port: the explicit port of its declared `local`
+ * `internal` origin (the loopback transport its dev server binds). A service
+ * declaring none refuses `dev-port-undeclared`; nothing is guessed.
+ */
+export declare function localDevPort(service: ServiceDescriptor | ServiceImplementation | null | undefined): number;
+/** The runtime port the declared-service readers below need: the kind query, nothing else. */
+export type ServiceCatalogRuntime = Pick<RuntimeRef, 'hasKind' | 'query'>;
+/**
+ * Where the readers below find service declarations: a runtime's registered
+ * `infra/service` descriptors, or a host's own declarations read statically
+ * (for a test harness or PM descriptor that has no runtime to query).
+ */
+export type ServiceCatalog = ServiceCatalogRuntime | readonly ServiceDescriptor[];
+/** `value`'s origin in canonical form for host comparison (config owns the one implementation). */
+export { canonicalOrigin };
+/**
+ * The origin a server uses to reach the declared service that serves `origin`:
+ * the `internal` origin that service declares for the same environment as the
+ * matched origin, otherwise `origin` unchanged. An origin no registered
+ * service declares refuses `service-undeclared`; an unparseable one refuses
+ * `origin-invalid`.
+ */
+export declare function serviceTransportOrigin(catalog: ServiceCatalog, origin: string): Promise<string>;
+/** {@link serviceTransportOrigin} for a full URL; its path, query and hash are kept. */
+export declare function serviceTransportUrl(catalog: ServiceCatalog, url: string): Promise<string>;
+/** Every origin a registered service declares for the `local` environment, sorted and unique. */
+export declare function localServiceOrigins(catalog: ServiceCatalog): string[];
+/** True when `url` is on an origin a registered service declares for the `local` environment. */
+export declare function isLocalServiceUrl(catalog: ServiceCatalog, url: string | URL): boolean;
+/**
+ * The declared `local` origins the local proxy serves: every one whose host is
+ * not loopback (loopback origins are the services' direct dev transports).
+ */
+export declare function localProxyOrigins(catalog: ServiceCatalog): string[];
+/**
+ * Chromium host-resolver arguments mapping every hostname a registered
+ * service declares for the `local` environment onto loopback, where the local
+ * proxy serves it. Loopback origins need no mapping; none declared, none.
+ */
+export declare function localHostResolverArgs(catalog: ServiceCatalog): string[];
+/** The deployment a host calls is config, distinct from the host's own tier. */
+export declare function serviceEnvironment(runtime: RuntimeRef): Promise<ServiceEnvironment>;
+export default infraServicesPlugin;
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

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

package/dist/service.js

@@ -0,0 +1,199 @@
+import * as z from 'zod/v4';
+import { CapabilityError, EnvironmentTierSchema, createRuntimeKind, createRuntimePlugin } from '@vibesdotdev/kernel';
+import { ConfigManifest } from '@vibesdotdev/config/manifest/config-manifest';
+import { canonicalOrigin } from '@vibesdotdev/config/environment/canonical-origin';
+import { readKindDescriptor } from "./kinds/read-descriptor.js";
+import { ServiceDescriptorSchema, ServiceTargetKindSchema, ServiceTargetSchema } from '@vibesdotdev/infra-contracts';
+export { ServiceOriginSchema, ServiceDescriptorSchema } from '@vibesdotdev/infra-contracts';
+export class ServiceImplementation {
+    descriptor;
+    runtime;
+    constructor(descriptor, context) {
+        this.descriptor = readKindDescriptor(ServiceDescriptorSchema, descriptor);
+        this.runtime = context.runtime;
+    }
+    /**
+     * This service's origin in the constructing runtime's configured service
+     * environment. Consumers resolve it through the `infra/service` kind, so
+     * reading an origin needs no import of this package.
+     */
+    async target(kind = 'primary') {
+        const requested = ServiceTargetKindSchema.safeParse(kind);
+        if (!requested.success)
+            throw new CapabilityError('Service target kind is invalid.', 'INVALID_INPUT', {
+                reason: 'service-target-kind-invalid', cause: requested.error
+            });
+        const config = await ConfigManifest.forRuntime(this.runtime, 'infra.services').load();
+        const environment = configuredServiceEnvironment(this.runtime, config);
+        const override = config.origins[this.descriptor.id];
+        const primary = override?.primary?.replace(/\/$/, '') ?? originOf(this.descriptor, environment);
+        const origin = requested.data === 'primary' ? primary :
+            override?.internal?.replace(/\/$/, '') ?? this.descriptor.origins.find((entry) => entry.environment === environment && entry.kind === 'internal')?.origin ?? primary;
+        return ServiceTargetSchema.parse({ origin, environment });
+    }
+    /** Compatibility door: the service owner selects the same target once. */
+    async origin(kind = 'primary') {
+        return (await this.target(kind)).origin;
+    }
+}
+export const serviceKind = createRuntimeKind({
+    id: 'infra/service', descriptorSchema: ServiceDescriptorSchema,
+    defaultImplementation: ServiceImplementation,
+    discoveryPatterns: ['*.infra.service.ts', 'infra/services/*.infra.service.ts']
+});
+export const InfraServicesConfigSchema = z.strictObject({
+    // The CLI has always addressed the production Vibes services unless a host
+    // declared otherwise; a workspace that declares no service environment
+    // keeps that behaviour instead of failing as "invalid at environment".
+    environment: z.union([EnvironmentTierSchema, z.literal('host')]).default('production'),
+    // Host composition may override declared services for its selected target
+    // environment. Internal transport stays independent of a public override.
+    origins: z.record(z.string().min(1), z.strictObject({
+        primary: z.url().optional(),
+        internal: z.url().optional()
+    })).default({})
+});
+export const infraServicesConfigManifest = {
+    kind: 'config/manifest', id: 'infra.services', name: 'Service environment',
+    namespace: 'infra.services', schema: InfraServicesConfigSchema,
+    // Never cloud-api: resolving that adapter's endpoint would recurse here.
+    allowedAdapters: ['storage.json', 'storage.localdb'],
+    scope: 'global', customTables: false, version: 1, internal: false, tier: 'user', fields: { environment: { ui: { label: 'Service environment', component: 'select' } } }
+};
+export const infraServicesPlugin = createRuntimePlugin({
+    id: 'infra.services', name: 'Infrastructure services', dependencies: ['config'],
+    kinds: [serviceKind], descriptors: [infraServicesConfigManifest]
+});
+/** Pure selection from one runtime-resolved declaration; no hostname guesses. */
+export function originOf(service, environment, kind = 'primary') {
+    const descriptor = service && ('descriptor' in service ? service.descriptor : service);
+    const primary = descriptor?.origins.find((entry) => entry.environment === environment && entry.kind === 'primary');
+    if (!primary)
+        throw new CapabilityError('Service has no declared primary origin in this environment.', 'NOT_FOUND', {
+            reason: 'service-undeclared', details: { serviceId: descriptor?.id, environment }
+        });
+    return (kind === 'internal' ? descriptor?.origins.find((entry) => entry.environment === environment && entry.kind === 'internal') : primary)?.origin ?? primary.origin;
+}
+/** The `infra/service` reader lives with the contract, so consumers need no import of this package. */
+export { serviceOrigin } from '@vibesdotdev/infra-contracts/service';
+/**
+ * The service's local dev port: the explicit port of its declared `local`
+ * `internal` origin (the loopback transport its dev server binds). A service
+ * declaring none refuses `dev-port-undeclared`; nothing is guessed.
+ */
+export function localDevPort(service) {
+    const descriptor = service && ('descriptor' in service ? service.descriptor : service);
+    const internal = descriptor?.origins.find((entry) => entry.environment === 'local' && entry.kind === 'internal');
+    const port = internal ? Number(new URL(internal.origin).port) : Number.NaN;
+    if (!Number.isInteger(port) || port <= 0)
+        throw new CapabilityError('Service declares no local dev port.', 'NOT_FOUND', {
+            reason: 'dev-port-undeclared', details: { serviceId: descriptor?.id }
+        });
+    return port;
+}
+function isDeclarationList(catalog) {
+    return Array.isArray(catalog);
+}
+function declaredServices(catalog) {
+    if (isDeclarationList(catalog))
+        return catalog;
+    return catalog.hasKind('infra/service')
+        ? catalog.query('infra/service').descriptors()
+        : [];
+}
+/** `value`'s origin in canonical form for host comparison (config owns the one implementation). */
+export { canonicalOrigin };
+function parsedOrigin(value) {
+    return canonicalOrigin(value);
+}
+/**
+ * The origin a server uses to reach the declared service that serves `origin`:
+ * the `internal` origin that service declares for the same environment as the
+ * matched origin, otherwise `origin` unchanged. An origin no registered
+ * service declares refuses `service-undeclared`; an unparseable one refuses
+ * `origin-invalid`.
+ */
+export async function serviceTransportOrigin(catalog, origin) {
+    const target = parsedOrigin(origin);
+    // The refusal names the field, never its value: the input may hold a credential.
+    if (target === undefined)
+        throw new CapabilityError('Service origin is not a URL.', 'INVALID_INPUT', {
+            reason: 'origin-invalid', details: { paths: ['origin'] }
+        });
+    for (const service of declaredServices(catalog)) {
+        const matched = service.origins.find((entry) => parsedOrigin(entry.origin) === target);
+        if (!matched)
+            continue;
+        const internal = service.origins.find((entry) => entry.environment === matched.environment && entry.kind === 'internal');
+        return internal?.origin ?? origin;
+    }
+    throw new CapabilityError('No declared service serves this origin.', 'NOT_FOUND', {
+        reason: 'service-undeclared', details: { origin: target }
+    });
+}
+/** {@link serviceTransportOrigin} for a full URL; its path, query and hash are kept. */
+export async function serviceTransportUrl(catalog, url) {
+    if (!URL.canParse(url))
+        throw new CapabilityError('Service URL is not a URL.', 'INVALID_INPUT', {
+            reason: 'origin-invalid', details: { paths: ['url'] }
+        });
+    const parsed = new URL(url);
+    const transport = await serviceTransportOrigin(catalog, parsed.origin);
+    if (transport === parsed.origin)
+        return url;
+    return new URL(`${parsed.pathname}${parsed.search}${parsed.hash}`, `${transport}/`).toString();
+}
+/** Every origin a registered service declares for the `local` environment, sorted and unique. */
+export function localServiceOrigins(catalog) {
+    const origins = new Set();
+    for (const service of declaredServices(catalog)) {
+        for (const entry of service.origins) {
+            const origin = entry.environment === 'local' ? parsedOrigin(entry.origin) : undefined;
+            if (origin !== undefined)
+                origins.add(origin);
+        }
+    }
+    return [...origins].sort();
+}
+/** True when `url` is on an origin a registered service declares for the `local` environment. */
+export function isLocalServiceUrl(catalog, url) {
+    const origin = parsedOrigin(url);
+    return origin !== undefined && localServiceOrigins(catalog).includes(origin);
+}
+const LOOPBACK_HOSTNAMES = new Set(['127.0.0.1', 'localhost', '[::1]']);
+/**
+ * The declared `local` origins the local proxy serves: every one whose host is
+ * not loopback (loopback origins are the services' direct dev transports).
+ */
+export function localProxyOrigins(catalog) {
+    return localServiceOrigins(catalog).filter((origin) => !LOOPBACK_HOSTNAMES.has(new URL(origin).hostname));
+}
+/**
+ * Chromium host-resolver arguments mapping every hostname a registered
+ * service declares for the `local` environment onto loopback, where the local
+ * proxy serves it. Loopback origins need no mapping; none declared, none.
+ */
+export function localHostResolverArgs(catalog) {
+    const hostnames = new Set(localProxyOrigins(catalog).map((origin) => new URL(origin).hostname));
+    if (hostnames.size === 0)
+        return [];
+    return [`--host-resolver-rules=${[...hostnames].sort().map((hostname) => `MAP ${hostname} 127.0.0.1`).join(',')}`];
+}
+/** The deployment a host calls is config, distinct from the host's own tier. */
+export async function serviceEnvironment(runtime) {
+    const config = await ConfigManifest.forRuntime(runtime, 'infra.services').load();
+    return configuredServiceEnvironment(runtime, config);
+}
+function configuredServiceEnvironment(runtime, config) {
+    if (config.environment !== 'host')
+        return config.environment;
+    const tier = runtime.scope.qualifiers?.environmentTier;
+    if (tier === undefined)
+        throw new CapabilityError('Host service environment requires a declared tier.', 'INTERNAL', { reason: 'tier-undeclared' });
+    const parsed = EnvironmentTierSchema.safeParse(tier);
+    if (!parsed.success)
+        throw new CapabilityError('Host environment tier is invalid.', 'INVALID_INPUT', { reason: 'scope-invalid' });
+    return parsed.data;
+}
+export default infraServicesPlugin;
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/dist/settle-work.d.ts

@@ -0,0 +1,20 @@
+/**
+ * One unit of work settled into its outcome: the value, or the value-free
+ * facts of what it threw (`valueFreeFailure`: class name, and code and reason
+ * when typed; never the message, stack or cause). A batch that must report
+ * each failure and continue (a backend walk, a seed run, a generator loop)
+ * reads every failure through here, so what a provider threw is never
+ * repeated in a result, a log or a refusal.
+ */
+import { type ValueFreeFailure } from '@vibesdotdev/kernel';
+export type WorkOutcome<Value> = {
+    readonly ok: true;
+    readonly value: Value;
+} | {
+    readonly ok: false;
+    readonly failure: ValueFreeFailure;
+};
+export declare function settleWork<Value>(work: () => Promise<Value>): Promise<WorkOutcome<Value>>;
+/** The facts as one line: `Name [CODE reason]`. */
+export declare function failureText(failure: ValueFreeFailure): string;
+//# sourceMappingURL=settle-work.d.ts.map

package/dist/settle-work.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle-work.d.ts","sourceRoot":"","sources":["../src/settle-work.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAyC,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEnG,MAAM,MAAM,WAAW,CAAC,KAAK,IAC1B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE9D,wBAAsB,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAM/F;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAE7D"}

package/dist/settle-work.js

@@ -0,0 +1,22 @@
+/**
+ * One unit of work settled into its outcome: the value, or the value-free
+ * facts of what it threw (`valueFreeFailure`: class name, and code and reason
+ * when typed; never the message, stack or cause). A batch that must report
+ * each failure and continue (a backend walk, a seed run, a generator loop)
+ * reads every failure through here, so what a provider threw is never
+ * repeated in a result, a log or a refusal.
+ */
+import { CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+export async function settleWork(work) {
+    try {
+        return { ok: true, value: await work() };
+    }
+    catch (error) {
+        return { ok: false, failure: valueFreeFailure(CaughtFailureSchema.parse(error)) };
+    }
+}
+/** The facts as one line: `Name [CODE reason]`. */
+export function failureText(failure) {
+    return [failure.name, failure.code, failure.reason].filter(Boolean).join(' ');
+}
+//# sourceMappingURL=settle-work.js.map

package/dist/settle-work.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle-work.js","sourceRoot":"","sources":["../src/settle-work.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAyB,MAAM,qBAAqB,CAAC;AAMnG,MAAM,CAAC,KAAK,UAAU,UAAU,CAAQ,IAA0B;IACjE,IAAI,CAAC;QACJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IACnF,CAAC;AACF,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,WAAW,CAAC,OAAyB;IACpD,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/E,CAAC"}