@sylphx/contract 0.5.0 → 0.6.0

package/dist/schemas/project-manifest.d.ts

@@ -4,7 +4,7 @@
  * Plane: `management`. The manifest is the user-facing, editable surface
  * declared in Git at repo root. The CLI parses `sylphx.toml` via Bun's
  * built-in TOML parser, validates against this schema, and pushes to the
- * Management API (`PUT /projects/:id/manifest`, landing in a follow-up PR).
+ * Management API (`PUT /projects/:id/manifest`).
  *
  * Slug-valued (not TypeID) on purpose: the manifest is what users type,
  * so slugs are the DX-correct surface. The server maps slugs → TypeIDs
@@ -25,10 +25,10 @@ export type Slug = typeof Slug.Type;
 /** Environment name — closed enum matches ADR-080 environment types. */
 export declare const ManifestEnvName: Schema.Literal<["production", "staging", "preview", "development"]>;
 export type ManifestEnvName = typeof ManifestEnvName.Type;
-/** Hetzner region starter set; extend as new regions come online. */
+/** Public region slug. The platform maps this to provider capacity internally. */
 export declare const ManifestRegion: Schema.Literal<["fsn1", "nbg1", "hel1", "ash1", "hil1"]>;
 export type ManifestRegion = typeof ManifestRegion.Type;
-/** Machine size tiers — shared between build runners and service containers. */
+/** Compute size tiers — shared between build runners and runtime services. */
 export declare const MachineSize: Schema.Literal<["nano", "micro", "small", "standard", "large", "xlarge"]>;
 export type MachineSize = typeof MachineSize.Type;
 /** Build runner size — smaller enum than MachineSize (no nano/micro). */
@@ -37,13 +37,19 @@ export type BuildMachineSize = typeof BuildMachineSize.Type;
 /** Buildpack identifier per ADR-071. `auto` lets the platform detect. */
 export declare const BuildpackName: Schema.Literal<["auto", "ruby", "node", "python", "static", "dockerfile"]>;
 export type BuildpackName = typeof BuildpackName.Type;
-/** Service type discriminant — drives K8s workload shape (Deployment/Job). */
+/** Build strategy hint. `dockerfile` pins the build to the declared Dockerfile. */
+export declare const BuildStrategy: Schema.Literal<["auto", "buildpack", "dockerfile", "nixpacks"]>;
+export type BuildStrategy = typeof BuildStrategy.Type;
+/** Service type discriminant — drives the platform runtime shape. */
 export declare const ServiceType: Schema.Literal<["web", "worker", "cron", "function"]>;
 export type ServiceType = typeof ServiceType.Type;
-/** Deploy strategy — `rolling` is the Sylphx default (ArgoCD PreSync-gated). */
+/** Public instance count for user-declared services. */
+export declare const ManifestServiceInstanceCount: Schema.filter<Schema.filter<typeof Schema.Number>>;
+export type ManifestServiceInstanceCount = typeof ManifestServiceInstanceCount.Type;
+/** Deploy strategy — `rolling` is the Sylphx default. */
 export declare const DeployStrategy: Schema.Literal<["rolling", "blue-green", "immediate"]>;
 export type DeployStrategy = typeof DeployStrategy.Type;
-/** WWW-apex redirect policy at the Gateway API listener. */
+/** WWW-apex redirect policy. */
 export declare const WwwRedirect: Schema.Literal<["apex", "www", "none"]>;
 export type WwwRedirect = typeof WwwRedirect.Type;
 export declare const ManifestProjectSection: Schema.Struct<{
@@ -68,8 +74,12 @@ export declare const ManifestBuildSection: Schema.Struct<{
      * package.json / Gemfile / requirements.txt / Dockerfile.
      */
     buildpack: Schema.optional<Schema.Literal<["auto", "ruby", "node", "python", "static", "dockerfile"]>>;
+    /** High-level build strategy alias used by current sylphx.toml files. */
+    strategy: Schema.optional<Schema.Literal<["auto", "buildpack", "dockerfile", "nixpacks"]>>;
     /** Override path to Dockerfile (implies buildpack=dockerfile). */
     dockerfile: Schema.optional<typeof Schema.String>;
+    /** Docker build context path. `context` is the product-facing TOML alias. */
+    context: Schema.optional<typeof Schema.String>;
     /** Docker build context path (default: repo root). */
     docker_context: Schema.optional<typeof Schema.String>;
     /** Custom build command; overrides buildpack default. */
@@ -85,10 +95,10 @@ export type ManifestBuildSection = typeof ManifestBuildSection.Type;
 export declare const ManifestDeploySection: Schema.Struct<{
     /**
      * Command run before traffic cutover (DB migrations via expand-and-
-     * contract). Runs as an ArgoCD PreSync Job (sync-wave "-1"). ADR-066.2.
+     * contract). Runs before the new release accepts traffic. ADR-066.2.
      */
     release_command: Schema.optional<typeof Schema.String>;
-    /** HTTP path for K8s readinessProbe. */
+    /** HTTP readiness path. */
     health_check_path: Schema.optional<typeof Schema.String>;
     /** Timeout in seconds. */
     health_check_timeout: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
@@ -98,57 +108,108 @@ export declare const ManifestDeploySection: Schema.Struct<{
     graceful_shutdown: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
 }>;
 export type ManifestDeploySection = typeof ManifestDeploySection.Type;
-export declare const ManifestServiceSection: Schema.Struct<{
-    /** Service name — unique within project. Used as K8s Deployment name. */
+export declare const ManifestServiceBuildSection: Schema.Struct<{
+    strategy: Schema.optional<Schema.Literal<["auto", "buildpack", "dockerfile", "nixpacks"]>>;
+    dockerfile: Schema.optional<typeof Schema.String>;
+    context: Schema.optional<typeof Schema.String>;
+    docker_context: Schema.optional<typeof Schema.String>;
+    build_command: Schema.optional<typeof Schema.String>;
+}>;
+export type ManifestServiceBuildSection = typeof ManifestServiceBuildSection.Type;
+export declare const ManifestServiceHealthSection: Schema.Struct<{
+    mode: Schema.optional<Schema.Literal<["http", "tcp", "command"]>>;
+    path: Schema.optional<typeof Schema.String>;
+    command: Schema.optional<typeof Schema.String>;
+}>;
+export type ManifestServiceHealthSection = typeof ManifestServiceHealthSection.Type;
+export declare const ManifestServiceSection: Schema.filter<Schema.Struct<{
+    /** Service name — unique within project. */
     name: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
     type: Schema.Literal<["web", "worker", "cron", "function"]>;
-    /** Container start command. */
+    /** Per-service build override. Root [build] remains the default. */
+    build: Schema.optional<Schema.Struct<{
+        strategy: Schema.optional<Schema.Literal<["auto", "buildpack", "dockerfile", "nixpacks"]>>;
+        dockerfile: Schema.optional<typeof Schema.String>;
+        context: Schema.optional<typeof Schema.String>;
+        docker_context: Schema.optional<typeof Schema.String>;
+        build_command: Schema.optional<typeof Schema.String>;
+    }>>;
+    /** Per-service health contract. Platform owns probe translation. */
+    health: Schema.optional<Schema.Struct<{
+        mode: Schema.optional<Schema.Literal<["http", "tcp", "command"]>>;
+        path: Schema.optional<typeof Schema.String>;
+        command: Schema.optional<typeof Schema.String>;
+    }>>;
+    /** Service start command. */
     command: Schema.optional<typeof Schema.String>;
-    /** Internal container port; required for `web`. */
+    /** Service port; required for `web` when it cannot be detected automatically. */
     port: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-    /**
-     * Public HTTP port (Gateway API listener). Defaults to 443 for web.
-     * Most users leave unset.
-     */
-    internal_port: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-    /** Replica count. Ignored for `cron`. */
-    replicas: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-    /** Compute size; maps to per-service K8s resources.requests/limits. */
+    /** Explicit instance count. Ignored for `cron`. */
+    instances: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+    /** Compute size; maps to per-service runtime resources. */
     instance_type: Schema.optional<Schema.Literal<["nano", "micro", "small", "standard", "large", "xlarge"]>>;
     /** Required when type=cron. Standard 5-field cron expression. */
     cron_schedule: Schema.optional<typeof Schema.String>;
     /** Optional per-service region override. */
     regions: Schema.optional<Schema.Array$<Schema.Literal<["fsn1", "nbg1", "hel1", "ash1", "hil1"]>>>;
-    /**
-     * Scale-to-zero (KEDA). `false` (default) = pinned at `min_replicas >= 1`;
-     * `true` = the reconciler emits a KEDA ScaledObject and lets KEDA drive
-     * the replica count from 0 → N on incoming traffic (docs/design/scale-to-zero.md).
-     */
+    /** Scale-to-zero. `false` (default) = pinned at `min_instances >= 1`. */
     scale_to_zero: Schema.optional<typeof Schema.Boolean>;
     /**
-     * Seconds of no traffic before KEDA scales the Deployment down to 0.
-     * Maps to KEDA `cooldownPeriod`. Only meaningful when `scale_to_zero=true`.
+     * Seconds of no traffic before the platform scales the service down to 0.
+     * Only meaningful when `scale_to_zero=true`.
      * Range: 60s–3600s. Default: 300 (5 min).
      */
     idle_timeout_seconds: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
     /**
-     * Minimum replica count. Default: `0` when `scale_to_zero=true`, else `1`.
-     * Setting `min_replicas=1` alongside `scale_to_zero=true` keeps a warm
-     * floor while still letting KEDA scale horizontally beyond 1.
+     * Minimum instance count. Default: `0` when `scale_to_zero=true`, else `1`.
+     * Setting `min_instances=1` alongside `scale_to_zero=true` keeps a warm
+     * floor while still allowing horizontal scale-out beyond 1.
      */
-    min_replicas: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+    min_instances: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+    /** Optional upper bound for platform-managed horizontal scale-out. */
+    max_instances: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
     /** Per-service env var merge — refs entries from top-level [env]. */
     env: Schema.optional<Schema.Array$<typeof Schema.String>>;
-    /** Per-service resource bindings (by resource name). */
+    /**
+     * Reserved for declarative service-scoped managed resource bindings.
+     * Current push-webhook support is environment-scoped via top-level [resources.*],
+     * so deploy parsing fails closed if this field is present.
+     */
     resources: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>>;
-}>;
+    /** Paths whose changes should trigger this service in monorepos. */
+    watch_paths: Schema.optional<Schema.Array$<typeof Schema.String>>;
+}>>;
 export type ManifestServiceSection = typeof ManifestServiceSection.Type;
+export declare const ManifestMigrationEngine: Schema.Literal<["atlas", "drizzle", "prisma", "alembic", "flyway", "goose", "sqlx", "custom"]>;
+export type ManifestMigrationEngine = typeof ManifestMigrationEngine.Type;
+export declare const ManifestMigrationDestructivePolicy: Schema.Literal<["require-approval", "allow"]>;
+export type ManifestMigrationDestructivePolicy = typeof ManifestMigrationDestructivePolicy.Type;
+export declare const ManifestMigrationsSection: Schema.Struct<{
+    engine: Schema.Literal<["atlas", "drizzle", "prisma", "alembic", "flyway", "goose", "sqlx", "custom"]>;
+    dir: Schema.optional<typeof Schema.String>;
+    image: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+    command: Schema.filter<typeof Schema.String>;
+    timeout: Schema.optional<typeof Schema.String>;
+    destructive_policy: Schema.optional<Schema.Literal<["require-approval", "allow"]>>;
+}>;
+export type ManifestMigrationsSection = typeof ManifestMigrationsSection.Type;
+export declare const ManifestDatabaseSection: Schema.Struct<{
+    migrations: Schema.optional<Schema.Struct<{
+        engine: Schema.Literal<["atlas", "drizzle", "prisma", "alembic", "flyway", "goose", "sqlx", "custom"]>;
+        dir: Schema.optional<typeof Schema.String>;
+        image: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+        command: Schema.filter<typeof Schema.String>;
+        timeout: Schema.optional<typeof Schema.String>;
+        destructive_policy: Schema.optional<Schema.Literal<["require-approval", "allow"]>>;
+    }>>;
+}>;
+export type ManifestDatabaseSection = typeof ManifestDatabaseSection.Type;
 /**
  * Env var value — literal, secret reference, or resource attribute.
  * Values are NEVER stored in the manifest — always by reference.
  * `from_secret` resolves via the platform `secrets` table (AES-256-GCM).
- * `from_resource` + `attr` resolves via the `resources` table; valid
- * attributes: `connection_url | host | port | user | password | database`.
+ * `from_resource` + `attr` resolves product-level outputs such as
+ * `database_url`, `cache_url`, `search_url`, and `volume_mount_path`.
  */
 export declare const ManifestEnvValue: Schema.Union<[Schema.Struct<{
     value: typeof Schema.String;
@@ -171,56 +232,116 @@ export declare const ManifestDomainSection: Schema.Struct<{
     aliases: Schema.optional<Schema.Array$<typeof Schema.String>>;
 }>;
 export type ManifestDomainSection = typeof ManifestDomainSection.Type;
-export declare const PostgresTier: Schema.Literal<["nano", "micro", "standard", "large", "xl"]>;
+export declare const ManifestManagedResourceTier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
+export type ManifestManagedResourceTier = typeof ManifestManagedResourceTier.Type;
+export declare const PostgresTier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
 export type PostgresTier = typeof PostgresTier.Type;
 export declare const PostgresVersion: Schema.Literal<["15", "16", "17"]>;
 export type PostgresVersion = typeof PostgresVersion.Type;
-export declare const SearchTier: Schema.Literal<["micro", "standard"]>;
+export declare const SearchTier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
 export type SearchTier = typeof SearchTier.Type;
+export declare const KvTier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
+export type KvTier = typeof KvTier.Type;
+export declare const ManifestVolumeTier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
+export type ManifestVolumeTier = typeof ManifestVolumeTier.Type;
+export declare const ManifestVolumeSharing: Schema.Literal<["single-writer", "shared"]>;
+export type ManifestVolumeSharing = typeof ManifestVolumeSharing.Type;
 export declare const ManifestDatabaseEngine: Schema.Literal<["postgres"]>;
 export type ManifestDatabaseEngine = typeof ManifestDatabaseEngine.Type;
-export declare const ManifestSearchEngine: Schema.Literal<["typesense"]>;
-export type ManifestSearchEngine = typeof ManifestSearchEngine.Type;
 export declare const ManifestDatabaseResource: Schema.Struct<{
     /** Capability-specific engine. PostgreSQL is the first supported database engine. */
     engine: Schema.optional<Schema.Literal<["postgres"]>>;
-    /** CNPG tier; IMMUTABLE after creation. */
-    tier: Schema.Literal<["nano", "micro", "standard", "large", "xl"]>;
+    /** Product tier; IMMUTABLE after creation. */
+    tier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
     storage_gb: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
     version: Schema.optional<Schema.Literal<["15", "16", "17"]>>;
-    /** Enable CNPG read-replica(s). */
-    replicas: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+    /** Optional managed read replicas. */
+    read_replicas: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
     /** Branch-per-preview (P0 gap #4 sibling). */
     branch_on_preview: Schema.optional<typeof Schema.Boolean>;
 }>;
 export type ManifestDatabaseResource = typeof ManifestDatabaseResource.Type;
+export declare const ManifestKvResource: Schema.Struct<{
+    engine: Schema.optionalWith<typeof Schema.Never, {
+        exact: true;
+    }>;
+    tier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
+    storage_gb: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+}>;
+export type ManifestKvResource = typeof ManifestKvResource.Type;
 export declare const ManifestSearchResource: Schema.Struct<{
-    /** Capability-specific engine. Typesense is the first supported search engine. */
-    engine: Schema.optional<Schema.Literal<["typesense"]>>;
-    tier: Schema.Literal<["micro", "standard"]>;
+    engine: Schema.optionalWith<typeof Schema.Never, {
+        exact: true;
+    }>;
+    tier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
     storage_gb: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-    nodes: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
 }>;
 export type ManifestSearchResource = typeof ManifestSearchResource.Type;
+export declare const ManifestVolumeResource: Schema.Struct<{
+    tier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
+    storage_gb: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+    /**
+     * Public sharing intent. The platform maps this to the best backend storage
+     * class without exposing implementation details.
+     */
+    sharing: Schema.optional<Schema.Literal<["single-writer", "shared"]>>;
+    /**
+     * Optional env-facing path metadata. This does not mount the volume into an
+     * app service by itself; service/task mounts stay explicit bindings.
+     */
+    mount_path: Schema.optional<Schema.filter<typeof Schema.String>>;
+    /**
+     * Binding role controls env var prefix. Example: role="workspace" emits
+     * WORKSPACE_VOLUME_ID for a volume binding.
+     */
+    role: Schema.optional<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>;
+}>;
+export type ManifestVolumeResource = typeof ManifestVolumeResource.Type;
 export declare const ManifestResourcesSection: Schema.Struct<{
     database: Schema.optional<Schema.Struct<{
         /** Capability-specific engine. PostgreSQL is the first supported database engine. */
         engine: Schema.optional<Schema.Literal<["postgres"]>>;
-        /** CNPG tier; IMMUTABLE after creation. */
-        tier: Schema.Literal<["nano", "micro", "standard", "large", "xl"]>;
+        /** Product tier; IMMUTABLE after creation. */
+        tier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
         storage_gb: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
         version: Schema.optional<Schema.Literal<["15", "16", "17"]>>;
-        /** Enable CNPG read-replica(s). */
-        replicas: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+        /** Optional managed read replicas. */
+        read_replicas: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
         /** Branch-per-preview (P0 gap #4 sibling). */
         branch_on_preview: Schema.optional<typeof Schema.Boolean>;
     }>>;
+    kv: Schema.optional<Schema.Struct<{
+        engine: Schema.optionalWith<typeof Schema.Never, {
+            exact: true;
+        }>;
+        tier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
+        storage_gb: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+    }>>;
     search: Schema.optional<Schema.Struct<{
-        /** Capability-specific engine. Typesense is the first supported search engine. */
-        engine: Schema.optional<Schema.Literal<["typesense"]>>;
-        tier: Schema.Literal<["micro", "standard"]>;
+        engine: Schema.optionalWith<typeof Schema.Never, {
+            exact: true;
+        }>;
+        tier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
+        storage_gb: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+    }>>;
+    volume: Schema.optional<Schema.Struct<{
+        tier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
         storage_gb: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-        nodes: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+        /**
+         * Public sharing intent. The platform maps this to the best backend storage
+         * class without exposing implementation details.
+         */
+        sharing: Schema.optional<Schema.Literal<["single-writer", "shared"]>>;
+        /**
+         * Optional env-facing path metadata. This does not mount the volume into an
+         * app service by itself; service/task mounts stay explicit bindings.
+         */
+        mount_path: Schema.optional<Schema.filter<typeof Schema.String>>;
+        /**
+         * Binding role controls env var prefix. Example: role="workspace" emits
+         * WORKSPACE_VOLUME_ID for a volume binding.
+         */
+        role: Schema.optional<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>;
     }>>;
 }>;
 export type ManifestResourcesSection = typeof ManifestResourcesSection.Type;
@@ -242,22 +363,22 @@ export type ManifestCiSection = typeof ManifestCiSection.Type;
  * `[[services]]` entry with the matching name. Arrays replace, scalars/
  * structs merge.
  */
-export declare const ManifestServiceOverride: Schema.Struct<{
+export declare const ManifestServiceOverride: Schema.filter<Schema.Struct<{
     name: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
     type: Schema.optional<Schema.Literal<["web", "worker", "cron", "function"]>>;
     command: Schema.optional<typeof Schema.String>;
     port: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-    internal_port: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-    replicas: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+    instances: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
     instance_type: Schema.optional<Schema.Literal<["nano", "micro", "small", "standard", "large", "xlarge"]>>;
     cron_schedule: Schema.optional<typeof Schema.String>;
     regions: Schema.optional<Schema.Array$<Schema.Literal<["fsn1", "nbg1", "hel1", "ash1", "hil1"]>>>;
     scale_to_zero: Schema.optional<typeof Schema.Boolean>;
     idle_timeout_seconds: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-    min_replicas: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+    min_instances: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+    max_instances: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
     env: Schema.optional<Schema.Array$<typeof Schema.String>>;
     resources: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>>;
-}>;
+}>>;
 export type ManifestServiceOverride = typeof ManifestServiceOverride.Type;
 export declare const ManifestEnvironmentOverride: Schema.Struct<{
     /** Shallow-merge over top-level [env]. */
@@ -276,8 +397,12 @@ export declare const ManifestEnvironmentOverride: Schema.Struct<{
          * package.json / Gemfile / requirements.txt / Dockerfile.
          */
         buildpack: Schema.optional<Schema.Literal<["auto", "ruby", "node", "python", "static", "dockerfile"]>>;
+        /** High-level build strategy alias used by current sylphx.toml files. */
+        strategy: Schema.optional<Schema.Literal<["auto", "buildpack", "dockerfile", "nixpacks"]>>;
         /** Override path to Dockerfile (implies buildpack=dockerfile). */
         dockerfile: Schema.optional<typeof Schema.String>;
+        /** Docker build context path. `context` is the product-facing TOML alias. */
+        context: Schema.optional<typeof Schema.String>;
         /** Docker build context path (default: repo root). */
         docker_context: Schema.optional<typeof Schema.String>;
         /** Custom build command; overrides buildpack default. */
@@ -293,10 +418,10 @@ export declare const ManifestEnvironmentOverride: Schema.Struct<{
     deploy: Schema.optional<Schema.Struct<{
         /**
          * Command run before traffic cutover (DB migrations via expand-and-
-         * contract). Runs as an ArgoCD PreSync Job (sync-wave "-1"). ADR-066.2.
+         * contract). Runs before the new release accepts traffic. ADR-066.2.
          */
         release_command: Schema.optional<typeof Schema.String>;
-        /** HTTP path for K8s readinessProbe. */
+        /** HTTP readiness path. */
         health_check_path: Schema.optional<typeof Schema.String>;
         /** Timeout in seconds. */
         health_check_timeout: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
@@ -306,22 +431,22 @@ export declare const ManifestEnvironmentOverride: Schema.Struct<{
         graceful_shutdown: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
     }>>;
     /** Sparse service overrides; entries match by `name`. */
-    services: Schema.optional<Schema.Array$<Schema.Struct<{
+    services: Schema.optional<Schema.Array$<Schema.filter<Schema.Struct<{
         name: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
         type: Schema.optional<Schema.Literal<["web", "worker", "cron", "function"]>>;
         command: Schema.optional<typeof Schema.String>;
         port: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-        internal_port: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-        replicas: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+        instances: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
         instance_type: Schema.optional<Schema.Literal<["nano", "micro", "small", "standard", "large", "xlarge"]>>;
         cron_schedule: Schema.optional<typeof Schema.String>;
         regions: Schema.optional<Schema.Array$<Schema.Literal<["fsn1", "nbg1", "hel1", "ash1", "hil1"]>>>;
         scale_to_zero: Schema.optional<typeof Schema.Boolean>;
         idle_timeout_seconds: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-        min_replicas: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+        min_instances: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+        max_instances: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
         env: Schema.optional<Schema.Array$<typeof Schema.String>>;
         resources: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>>;
-    }>>>;
+    }>>>>;
     /** Per-env region override. */
     region: Schema.optional<Schema.Literal<["fsn1", "nbg1", "hel1", "ash1", "hil1"]>>;
     /** Domain overrides; typically for preview-only hostnames. */
@@ -360,15 +485,15 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             readonly port?: number | undefined;
             readonly env?: readonly string[] | undefined;
             readonly resources?: readonly string[] | undefined;
-            readonly replicas?: number | undefined;
+            readonly instances?: number | undefined;
+            readonly max_instances?: number | undefined;
             readonly command?: string | undefined;
-            readonly internal_port?: number | undefined;
-            readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+            readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
             readonly cron_schedule?: string | undefined;
             readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
             readonly scale_to_zero?: boolean | undefined;
             readonly idle_timeout_seconds?: number | undefined;
-            readonly min_replicas?: number | undefined;
+            readonly min_instances?: number | undefined;
         }[] | undefined;
         readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
         readonly env?: {
@@ -382,6 +507,8 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             };
         } | undefined;
         readonly build?: {
+            readonly context?: string | undefined;
+            readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
             readonly dockerfile?: string | undefined;
             readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
             readonly docker_context?: string | undefined;
@@ -412,15 +539,15 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             readonly port?: number | undefined;
             readonly env?: readonly string[] | undefined;
             readonly resources?: readonly string[] | undefined;
-            readonly replicas?: number | undefined;
+            readonly instances?: number | undefined;
+            readonly max_instances?: number | undefined;
             readonly command?: string | undefined;
-            readonly internal_port?: number | undefined;
-            readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+            readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
             readonly cron_schedule?: string | undefined;
             readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
             readonly scale_to_zero?: boolean | undefined;
             readonly idle_timeout_seconds?: number | undefined;
-            readonly min_replicas?: number | undefined;
+            readonly min_instances?: number | undefined;
         }[] | undefined;
         readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
         readonly env?: {
@@ -434,6 +561,8 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             };
         } | undefined;
         readonly build?: {
+            readonly context?: string | undefined;
+            readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
             readonly dockerfile?: string | undefined;
             readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
             readonly docker_context?: string | undefined;
@@ -464,15 +593,15 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             readonly port?: number | undefined;
             readonly env?: readonly string[] | undefined;
             readonly resources?: readonly string[] | undefined;
-            readonly replicas?: number | undefined;
+            readonly instances?: number | undefined;
+            readonly max_instances?: number | undefined;
             readonly command?: string | undefined;
-            readonly internal_port?: number | undefined;
-            readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+            readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
             readonly cron_schedule?: string | undefined;
             readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
             readonly scale_to_zero?: boolean | undefined;
             readonly idle_timeout_seconds?: number | undefined;
-            readonly min_replicas?: number | undefined;
+            readonly min_instances?: number | undefined;
         }[] | undefined;
         readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
         readonly env?: {
@@ -486,6 +615,8 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             };
         } | undefined;
         readonly build?: {
+            readonly context?: string | undefined;
+            readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
             readonly dockerfile?: string | undefined;
             readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
             readonly docker_context?: string | undefined;
@@ -516,15 +647,15 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             readonly port?: number | undefined;
             readonly env?: readonly string[] | undefined;
             readonly resources?: readonly string[] | undefined;
-            readonly replicas?: number | undefined;
+            readonly instances?: number | undefined;
+            readonly max_instances?: number | undefined;
             readonly command?: string | undefined;
-            readonly internal_port?: number | undefined;
-            readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+            readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
             readonly cron_schedule?: string | undefined;
             readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
             readonly scale_to_zero?: boolean | undefined;
             readonly idle_timeout_seconds?: number | undefined;
-            readonly min_replicas?: number | undefined;
+            readonly min_instances?: number | undefined;
         }[] | undefined;
         readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
         readonly env?: {
@@ -538,6 +669,8 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             };
         } | undefined;
         readonly build?: {
+            readonly context?: string | undefined;
+            readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
             readonly dockerfile?: string | undefined;
             readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
             readonly docker_context?: string | undefined;
@@ -569,15 +702,15 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             readonly port?: number | undefined;
             readonly env?: readonly string[] | undefined;
             readonly resources?: readonly string[] | undefined;
-            readonly replicas?: number | undefined;
+            readonly instances?: number | undefined;
+            readonly max_instances?: number | undefined;
             readonly command?: string | undefined;
-            readonly internal_port?: number | undefined;
-            readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+            readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
             readonly cron_schedule?: string | undefined;
             readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
             readonly scale_to_zero?: boolean | undefined;
             readonly idle_timeout_seconds?: number | undefined;
-            readonly min_replicas?: number | undefined;
+            readonly min_instances?: number | undefined;
         }[] | undefined;
         readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
         readonly env?: {
@@ -591,6 +724,8 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             };
         } | undefined;
         readonly build?: {
+            readonly context?: string | undefined;
+            readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
             readonly dockerfile?: string | undefined;
             readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
             readonly docker_context?: string | undefined;
@@ -621,15 +756,15 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             readonly port?: number | undefined;
             readonly env?: readonly string[] | undefined;
             readonly resources?: readonly string[] | undefined;
-            readonly replicas?: number | undefined;
+            readonly instances?: number | undefined;
+            readonly max_instances?: number | undefined;
             readonly command?: string | undefined;
-            readonly internal_port?: number | undefined;
-            readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+            readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
             readonly cron_schedule?: string | undefined;
             readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
             readonly scale_to_zero?: boolean | undefined;
             readonly idle_timeout_seconds?: number | undefined;
-            readonly min_replicas?: number | undefined;
+            readonly min_instances?: number | undefined;
         }[] | undefined;
         readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
         readonly env?: {
@@ -643,6 +778,8 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             };
         } | undefined;
         readonly build?: {
+            readonly context?: string | undefined;
+            readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
             readonly dockerfile?: string | undefined;
             readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
             readonly docker_context?: string | undefined;
@@ -673,15 +810,15 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             readonly port?: number | undefined;
             readonly env?: readonly string[] | undefined;
             readonly resources?: readonly string[] | undefined;
-            readonly replicas?: number | undefined;
+            readonly instances?: number | undefined;
+            readonly max_instances?: number | undefined;
             readonly command?: string | undefined;
-            readonly internal_port?: number | undefined;
-            readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+            readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
             readonly cron_schedule?: string | undefined;
             readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
             readonly scale_to_zero?: boolean | undefined;
             readonly idle_timeout_seconds?: number | undefined;
-            readonly min_replicas?: number | undefined;
+            readonly min_instances?: number | undefined;
         }[] | undefined;
         readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
         readonly env?: {
@@ -695,6 +832,8 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             };
         } | undefined;
         readonly build?: {
+            readonly context?: string | undefined;
+            readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
             readonly dockerfile?: string | undefined;
             readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
             readonly docker_context?: string | undefined;
@@ -725,15 +864,15 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             readonly port?: number | undefined;
             readonly env?: readonly string[] | undefined;
             readonly resources?: readonly string[] | undefined;
-            readonly replicas?: number | undefined;
+            readonly instances?: number | undefined;
+            readonly max_instances?: number | undefined;
             readonly command?: string | undefined;
-            readonly internal_port?: number | undefined;
-            readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+            readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
             readonly cron_schedule?: string | undefined;
             readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
             readonly scale_to_zero?: boolean | undefined;
             readonly idle_timeout_seconds?: number | undefined;
-            readonly min_replicas?: number | undefined;
+            readonly min_instances?: number | undefined;
         }[] | undefined;
         readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
         readonly env?: {
@@ -747,6 +886,8 @@ export declare const ManifestEnvironmentsMap: Schema.SchemaClass<{
             };
         } | undefined;
         readonly build?: {
+            readonly context?: string | undefined;
+            readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
             readonly dockerfile?: string | undefined;
             readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
             readonly docker_context?: string | undefined;
@@ -793,8 +934,12 @@ export declare const SylphxManifest: Schema.Struct<{
          * package.json / Gemfile / requirements.txt / Dockerfile.
          */
         buildpack: Schema.optional<Schema.Literal<["auto", "ruby", "node", "python", "static", "dockerfile"]>>;
+        /** High-level build strategy alias used by current sylphx.toml files. */
+        strategy: Schema.optional<Schema.Literal<["auto", "buildpack", "dockerfile", "nixpacks"]>>;
         /** Override path to Dockerfile (implies buildpack=dockerfile). */
         dockerfile: Schema.optional<typeof Schema.String>;
+        /** Docker build context path. `context` is the product-facing TOML alias. */
+        context: Schema.optional<typeof Schema.String>;
         /** Docker build context path (default: repo root). */
         docker_context: Schema.optional<typeof Schema.String>;
         /** Custom build command; overrides buildpack default. */
@@ -809,10 +954,10 @@ export declare const SylphxManifest: Schema.Struct<{
     deploy: Schema.optional<Schema.Struct<{
         /**
          * Command run before traffic cutover (DB migrations via expand-and-
-         * contract). Runs as an ArgoCD PreSync Job (sync-wave "-1"). ADR-066.2.
+         * contract). Runs before the new release accepts traffic. ADR-066.2.
          */
         release_command: Schema.optional<typeof Schema.String>;
-        /** HTTP path for K8s readinessProbe. */
+        /** HTTP readiness path. */
         health_check_path: Schema.optional<typeof Schema.String>;
         /** Timeout in seconds. */
         health_check_timeout: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
@@ -821,50 +966,73 @@ export declare const SylphxManifest: Schema.Struct<{
         /** Grace period before SIGKILL (seconds). */
         graceful_shutdown: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
     }>>;
-    services: Schema.optional<Schema.Array$<Schema.Struct<{
-        /** Service name — unique within project. Used as K8s Deployment name. */
+    services: Schema.optional<Schema.Array$<Schema.filter<Schema.Struct<{
+        /** Service name — unique within project. */
         name: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
         type: Schema.Literal<["web", "worker", "cron", "function"]>;
-        /** Container start command. */
+        /** Per-service build override. Root [build] remains the default. */
+        build: Schema.optional<Schema.Struct<{
+            strategy: Schema.optional<Schema.Literal<["auto", "buildpack", "dockerfile", "nixpacks"]>>;
+            dockerfile: Schema.optional<typeof Schema.String>;
+            context: Schema.optional<typeof Schema.String>;
+            docker_context: Schema.optional<typeof Schema.String>;
+            build_command: Schema.optional<typeof Schema.String>;
+        }>>;
+        /** Per-service health contract. Platform owns probe translation. */
+        health: Schema.optional<Schema.Struct<{
+            mode: Schema.optional<Schema.Literal<["http", "tcp", "command"]>>;
+            path: Schema.optional<typeof Schema.String>;
+            command: Schema.optional<typeof Schema.String>;
+        }>>;
+        /** Service start command. */
         command: Schema.optional<typeof Schema.String>;
-        /** Internal container port; required for `web`. */
+        /** Service port; required for `web` when it cannot be detected automatically. */
         port: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-        /**
-         * Public HTTP port (Gateway API listener). Defaults to 443 for web.
-         * Most users leave unset.
-         */
-        internal_port: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-        /** Replica count. Ignored for `cron`. */
-        replicas: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-        /** Compute size; maps to per-service K8s resources.requests/limits. */
+        /** Explicit instance count. Ignored for `cron`. */
+        instances: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+        /** Compute size; maps to per-service runtime resources. */
         instance_type: Schema.optional<Schema.Literal<["nano", "micro", "small", "standard", "large", "xlarge"]>>;
         /** Required when type=cron. Standard 5-field cron expression. */
         cron_schedule: Schema.optional<typeof Schema.String>;
         /** Optional per-service region override. */
         regions: Schema.optional<Schema.Array$<Schema.Literal<["fsn1", "nbg1", "hel1", "ash1", "hil1"]>>>;
-        /**
-         * Scale-to-zero (KEDA). `false` (default) = pinned at `min_replicas >= 1`;
-         * `true` = the reconciler emits a KEDA ScaledObject and lets KEDA drive
-         * the replica count from 0 → N on incoming traffic (docs/design/scale-to-zero.md).
-         */
+        /** Scale-to-zero. `false` (default) = pinned at `min_instances >= 1`. */
         scale_to_zero: Schema.optional<typeof Schema.Boolean>;
         /**
-         * Seconds of no traffic before KEDA scales the Deployment down to 0.
-         * Maps to KEDA `cooldownPeriod`. Only meaningful when `scale_to_zero=true`.
+         * Seconds of no traffic before the platform scales the service down to 0.
+         * Only meaningful when `scale_to_zero=true`.
          * Range: 60s–3600s. Default: 300 (5 min).
          */
         idle_timeout_seconds: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
         /**
-         * Minimum replica count. Default: `0` when `scale_to_zero=true`, else `1`.
-         * Setting `min_replicas=1` alongside `scale_to_zero=true` keeps a warm
-         * floor while still letting KEDA scale horizontally beyond 1.
+         * Minimum instance count. Default: `0` when `scale_to_zero=true`, else `1`.
+         * Setting `min_instances=1` alongside `scale_to_zero=true` keeps a warm
+         * floor while still allowing horizontal scale-out beyond 1.
          */
-        min_replicas: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+        min_instances: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+        /** Optional upper bound for platform-managed horizontal scale-out. */
+        max_instances: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
         /** Per-service env var merge — refs entries from top-level [env]. */
         env: Schema.optional<Schema.Array$<typeof Schema.String>>;
-        /** Per-service resource bindings (by resource name). */
+        /**
+         * Reserved for declarative service-scoped managed resource bindings.
+         * Current push-webhook support is environment-scoped via top-level [resources.*],
+         * so deploy parsing fails closed if this field is present.
+         */
         resources: Schema.optional<Schema.Array$<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>>;
-    }>>>;
+        /** Paths whose changes should trigger this service in monorepos. */
+        watch_paths: Schema.optional<Schema.Array$<typeof Schema.String>>;
+    }>>>>;
+    database: Schema.optional<Schema.Struct<{
+        migrations: Schema.optional<Schema.Struct<{
+            engine: Schema.Literal<["atlas", "drizzle", "prisma", "alembic", "flyway", "goose", "sqlx", "custom"]>;
+            dir: Schema.optional<typeof Schema.String>;
+            image: Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            command: Schema.filter<typeof Schema.String>;
+            timeout: Schema.optional<typeof Schema.String>;
+            destructive_policy: Schema.optional<Schema.Literal<["require-approval", "allow"]>>;
+        }>>;
+    }>>;
     env: Schema.optional<Schema.Record$<typeof Schema.String, Schema.Union<[Schema.Struct<{
         value: typeof Schema.String;
     }>, Schema.Struct<{
@@ -899,15 +1067,15 @@ export declare const SylphxManifest: Schema.Struct<{
                 readonly port?: number | undefined;
                 readonly env?: readonly string[] | undefined;
                 readonly resources?: readonly string[] | undefined;
-                readonly replicas?: number | undefined;
+                readonly instances?: number | undefined;
+                readonly max_instances?: number | undefined;
                 readonly command?: string | undefined;
-                readonly internal_port?: number | undefined;
-                readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+                readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
                 readonly cron_schedule?: string | undefined;
                 readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
                 readonly scale_to_zero?: boolean | undefined;
                 readonly idle_timeout_seconds?: number | undefined;
-                readonly min_replicas?: number | undefined;
+                readonly min_instances?: number | undefined;
             }[] | undefined;
             readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
             readonly env?: {
@@ -921,6 +1089,8 @@ export declare const SylphxManifest: Schema.Struct<{
                 };
             } | undefined;
             readonly build?: {
+                readonly context?: string | undefined;
+                readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
                 readonly dockerfile?: string | undefined;
                 readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
                 readonly docker_context?: string | undefined;
@@ -951,15 +1121,15 @@ export declare const SylphxManifest: Schema.Struct<{
                 readonly port?: number | undefined;
                 readonly env?: readonly string[] | undefined;
                 readonly resources?: readonly string[] | undefined;
-                readonly replicas?: number | undefined;
+                readonly instances?: number | undefined;
+                readonly max_instances?: number | undefined;
                 readonly command?: string | undefined;
-                readonly internal_port?: number | undefined;
-                readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+                readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
                 readonly cron_schedule?: string | undefined;
                 readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
                 readonly scale_to_zero?: boolean | undefined;
                 readonly idle_timeout_seconds?: number | undefined;
-                readonly min_replicas?: number | undefined;
+                readonly min_instances?: number | undefined;
             }[] | undefined;
             readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
             readonly env?: {
@@ -973,6 +1143,8 @@ export declare const SylphxManifest: Schema.Struct<{
                 };
             } | undefined;
             readonly build?: {
+                readonly context?: string | undefined;
+                readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
                 readonly dockerfile?: string | undefined;
                 readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
                 readonly docker_context?: string | undefined;
@@ -1003,15 +1175,15 @@ export declare const SylphxManifest: Schema.Struct<{
                 readonly port?: number | undefined;
                 readonly env?: readonly string[] | undefined;
                 readonly resources?: readonly string[] | undefined;
-                readonly replicas?: number | undefined;
+                readonly instances?: number | undefined;
+                readonly max_instances?: number | undefined;
                 readonly command?: string | undefined;
-                readonly internal_port?: number | undefined;
-                readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+                readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
                 readonly cron_schedule?: string | undefined;
                 readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
                 readonly scale_to_zero?: boolean | undefined;
                 readonly idle_timeout_seconds?: number | undefined;
-                readonly min_replicas?: number | undefined;
+                readonly min_instances?: number | undefined;
             }[] | undefined;
             readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
             readonly env?: {
@@ -1025,6 +1197,8 @@ export declare const SylphxManifest: Schema.Struct<{
                 };
             } | undefined;
             readonly build?: {
+                readonly context?: string | undefined;
+                readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
                 readonly dockerfile?: string | undefined;
                 readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
                 readonly docker_context?: string | undefined;
@@ -1055,15 +1229,15 @@ export declare const SylphxManifest: Schema.Struct<{
                 readonly port?: number | undefined;
                 readonly env?: readonly string[] | undefined;
                 readonly resources?: readonly string[] | undefined;
-                readonly replicas?: number | undefined;
+                readonly instances?: number | undefined;
+                readonly max_instances?: number | undefined;
                 readonly command?: string | undefined;
-                readonly internal_port?: number | undefined;
-                readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+                readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
                 readonly cron_schedule?: string | undefined;
                 readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
                 readonly scale_to_zero?: boolean | undefined;
                 readonly idle_timeout_seconds?: number | undefined;
-                readonly min_replicas?: number | undefined;
+                readonly min_instances?: number | undefined;
             }[] | undefined;
             readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
             readonly env?: {
@@ -1077,6 +1251,8 @@ export declare const SylphxManifest: Schema.Struct<{
                 };
             } | undefined;
             readonly build?: {
+                readonly context?: string | undefined;
+                readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
                 readonly dockerfile?: string | undefined;
                 readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
                 readonly docker_context?: string | undefined;
@@ -1108,15 +1284,15 @@ export declare const SylphxManifest: Schema.Struct<{
                 readonly port?: number | undefined;
                 readonly env?: readonly string[] | undefined;
                 readonly resources?: readonly string[] | undefined;
-                readonly replicas?: number | undefined;
+                readonly instances?: number | undefined;
+                readonly max_instances?: number | undefined;
                 readonly command?: string | undefined;
-                readonly internal_port?: number | undefined;
-                readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+                readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
                 readonly cron_schedule?: string | undefined;
                 readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
                 readonly scale_to_zero?: boolean | undefined;
                 readonly idle_timeout_seconds?: number | undefined;
-                readonly min_replicas?: number | undefined;
+                readonly min_instances?: number | undefined;
             }[] | undefined;
             readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
             readonly env?: {
@@ -1130,6 +1306,8 @@ export declare const SylphxManifest: Schema.Struct<{
                 };
             } | undefined;
             readonly build?: {
+                readonly context?: string | undefined;
+                readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
                 readonly dockerfile?: string | undefined;
                 readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
                 readonly docker_context?: string | undefined;
@@ -1160,15 +1338,15 @@ export declare const SylphxManifest: Schema.Struct<{
                 readonly port?: number | undefined;
                 readonly env?: readonly string[] | undefined;
                 readonly resources?: readonly string[] | undefined;
-                readonly replicas?: number | undefined;
+                readonly instances?: number | undefined;
+                readonly max_instances?: number | undefined;
                 readonly command?: string | undefined;
-                readonly internal_port?: number | undefined;
-                readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+                readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
                 readonly cron_schedule?: string | undefined;
                 readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
                 readonly scale_to_zero?: boolean | undefined;
                 readonly idle_timeout_seconds?: number | undefined;
-                readonly min_replicas?: number | undefined;
+                readonly min_instances?: number | undefined;
             }[] | undefined;
             readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
             readonly env?: {
@@ -1182,6 +1360,8 @@ export declare const SylphxManifest: Schema.Struct<{
                 };
             } | undefined;
             readonly build?: {
+                readonly context?: string | undefined;
+                readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
                 readonly dockerfile?: string | undefined;
                 readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
                 readonly docker_context?: string | undefined;
@@ -1212,15 +1392,15 @@ export declare const SylphxManifest: Schema.Struct<{
                 readonly port?: number | undefined;
                 readonly env?: readonly string[] | undefined;
                 readonly resources?: readonly string[] | undefined;
-                readonly replicas?: number | undefined;
+                readonly instances?: number | undefined;
+                readonly max_instances?: number | undefined;
                 readonly command?: string | undefined;
-                readonly internal_port?: number | undefined;
-                readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+                readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
                 readonly cron_schedule?: string | undefined;
                 readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
                 readonly scale_to_zero?: boolean | undefined;
                 readonly idle_timeout_seconds?: number | undefined;
-                readonly min_replicas?: number | undefined;
+                readonly min_instances?: number | undefined;
             }[] | undefined;
             readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
             readonly env?: {
@@ -1234,6 +1414,8 @@ export declare const SylphxManifest: Schema.Struct<{
                 };
             } | undefined;
             readonly build?: {
+                readonly context?: string | undefined;
+                readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
                 readonly dockerfile?: string | undefined;
                 readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
                 readonly docker_context?: string | undefined;
@@ -1264,15 +1446,15 @@ export declare const SylphxManifest: Schema.Struct<{
                 readonly port?: number | undefined;
                 readonly env?: readonly string[] | undefined;
                 readonly resources?: readonly string[] | undefined;
-                readonly replicas?: number | undefined;
+                readonly instances?: number | undefined;
+                readonly max_instances?: number | undefined;
                 readonly command?: string | undefined;
-                readonly internal_port?: number | undefined;
-                readonly instance_type?: "standard" | "large" | "xlarge" | "nano" | "micro" | "small" | undefined;
+                readonly instance_type?: "nano" | "micro" | "standard" | "large" | "xlarge" | "small" | undefined;
                 readonly cron_schedule?: string | undefined;
                 readonly regions?: readonly ("fsn1" | "nbg1" | "hel1" | "ash1" | "hil1")[] | undefined;
                 readonly scale_to_zero?: boolean | undefined;
                 readonly idle_timeout_seconds?: number | undefined;
-                readonly min_replicas?: number | undefined;
+                readonly min_instances?: number | undefined;
             }[] | undefined;
             readonly region?: "fsn1" | "nbg1" | "hel1" | "ash1" | "hil1" | undefined;
             readonly env?: {
@@ -1286,6 +1468,8 @@ export declare const SylphxManifest: Schema.Struct<{
                 };
             } | undefined;
             readonly build?: {
+                readonly context?: string | undefined;
+                readonly strategy?: "auto" | "dockerfile" | "buildpack" | "nixpacks" | undefined;
                 readonly dockerfile?: string | undefined;
                 readonly buildpack?: "auto" | "static" | "ruby" | "node" | "python" | "dockerfile" | undefined;
                 readonly docker_context?: string | undefined;
@@ -1307,21 +1491,47 @@ export declare const SylphxManifest: Schema.Struct<{
         database: Schema.optional<Schema.Struct<{
             /** Capability-specific engine. PostgreSQL is the first supported database engine. */
             engine: Schema.optional<Schema.Literal<["postgres"]>>;
-            /** CNPG tier; IMMUTABLE after creation. */
-            tier: Schema.Literal<["nano", "micro", "standard", "large", "xl"]>;
+            /** Product tier; IMMUTABLE after creation. */
+            tier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
             storage_gb: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
             version: Schema.optional<Schema.Literal<["15", "16", "17"]>>;
-            /** Enable CNPG read-replica(s). */
-            replicas: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+            /** Optional managed read replicas. */
+            read_replicas: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
             /** Branch-per-preview (P0 gap #4 sibling). */
             branch_on_preview: Schema.optional<typeof Schema.Boolean>;
         }>>;
+        kv: Schema.optional<Schema.Struct<{
+            engine: Schema.optionalWith<typeof Schema.Never, {
+                exact: true;
+            }>;
+            tier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
+            storage_gb: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+        }>>;
         search: Schema.optional<Schema.Struct<{
-            /** Capability-specific engine. Typesense is the first supported search engine. */
-            engine: Schema.optional<Schema.Literal<["typesense"]>>;
-            tier: Schema.Literal<["micro", "standard"]>;
+            engine: Schema.optionalWith<typeof Schema.Never, {
+                exact: true;
+            }>;
+            tier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
+            storage_gb: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+        }>>;
+        volume: Schema.optional<Schema.Struct<{
+            tier: Schema.Literal<["nano", "micro", "standard", "large", "xl", "hobby", "starter", "pro", "business", "enterprise", "enterprise-2x", "enterprise-4x"]>;
             storage_gb: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
-            nodes: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+            /**
+             * Public sharing intent. The platform maps this to the best backend storage
+             * class without exposing implementation details.
+             */
+            sharing: Schema.optional<Schema.Literal<["single-writer", "shared"]>>;
+            /**
+             * Optional env-facing path metadata. This does not mount the volume into an
+             * app service by itself; service/task mounts stay explicit bindings.
+             */
+            mount_path: Schema.optional<Schema.filter<typeof Schema.String>>;
+            /**
+             * Binding role controls env var prefix. Example: role="workspace" emits
+             * WORKSPACE_VOLUME_ID for a volume binding.
+             */
+            role: Schema.optional<Schema.filter<Schema.filter<Schema.filter<typeof Schema.String>>>>;
         }>>;
     }>>;
     ci: Schema.optional<Schema.Struct<{
@@ -1345,13 +1555,13 @@ export type SylphxManifest = typeof SylphxManifest.Type;
  * the schema above.
  */
 export interface ResolvedScaleToZero {
-    /** Whether the service opts into KEDA-managed scale-to-zero. */
+    /** Whether the service opts into platform-managed scale-to-zero. */
     scaleToZero: boolean;
-    /** KEDA `cooldownPeriod` (seconds). Meaningful only when scaleToZero=true. */
+    /** Idle cooldown in seconds. Meaningful only when scaleToZero=true. */
     idleTimeoutSeconds: number;
-    /** KEDA `minReplicaCount`. 0 iff `scaleToZero=true` and caller didn't pin a warm floor. */
+    /** Minimum warm instances. 0 iff `scaleToZero=true` and caller didn't pin a warm floor. */
     minReplicas: number;
-    /** KEDA `maxReplicaCount`. Upper bound for horizontal scaling. */
+    /** Upper bound for horizontal scaling. */
     maxReplicas: number;
 }
 /**
@@ -1362,11 +1572,11 @@ export interface ResolvedScaleToZero {
 export declare const SCALE_TO_ZERO_DEFAULTS: {
     /** Idle timeout in seconds when caller didn't provide one. */
     readonly idleTimeoutSeconds: 300;
-    /** Min replicas when the service opted into scale-to-zero. */
+    /** Min instances when the service opted into scale-to-zero. */
     readonly minReplicasScaleToZero: 0;
-    /** Min replicas when the service did NOT opt in (pinned warm). */
+    /** Min instances when the service did NOT opt in (pinned warm). */
     readonly minReplicasWarm: 1;
-    /** Max replicas fallback when neither manifest nor compute profile specify. */
+    /** Max instances fallback when neither manifest nor compute profile specify. */
     readonly maxReplicasDefault: 10;
 };
 /**
@@ -1378,7 +1588,7 @@ export declare const SCALE_TO_ZERO_DEFAULTS: {
  *                Pass `null`/`undefined` for "no scale-to-zero".
  * @param explicitMax - Optional per-tier ceiling (e.g. resolved from
  *                      compute profile). Takes precedence over the static
- *                      10-replica fallback but not over an input.maxReplicas.
+ *                      10-instance fallback but not over an input.maxReplicas.
  */
 export declare function resolveScaleToZeroDefaults(input: {
     scaleToZero?: boolean;