Package com.cloudforge.core.local

package com.cloudforge.core.local

Cross-module contracts for post-synthesis local CloudFormation deployment and emulator lifecycle.

Implementations live in target modules such as cloudforge-ministack and cloudforge-localstack, registered via LocalEmulatorRuntimeProvider and StackPortRuntimeProvider. Resolve runtimes with LocalEmulatorRuntimes and StackPortRuntimes. Shared nginx edge: EmulatorEdgeLifecycle. CDK synthesis stays in cloudforge-api. See docs/architecture/module-boundaries-and-refactor.plan.md.

Class	Description
AbstractLocalEmulatorRuntime	Shared Docker lifecycle for CloudForge local emulators.
AbstractStackPortRuntime	Shared Docker lifecycle for target-owned StackPort resource browsers.
CloudFormationTemplateDiff	Semantic resource-level diff for canonical CloudFormation templates.
CloudFormationTemplateDiff.Action
CloudFormationTemplateDiff.ResourceChange
DefaultEmulatorEdgeRuntime	Dockerized nginx edge for *.cloudforge.localhost Host routing.
DeploymentTarget	Post-synthesis deployment target for CloudForge templates.
DockerEmulatorSupport	Shared Docker CLI helpers for local emulator containers.
EmulatorEdgeCli	Command-line entry point for EmulatorEdgeLifecycle — backs scripts/emulator-edge-*.sh.
EmulatorEdgeLifecycle	Applies EmulatorEdgeLifecycleAction to the shared nginx emulator edge.
EmulatorEdgeLifecycleAction	Emulator edge (nginx) lifecycle actions for Maven goals and EmulatorLifecycle.
EmulatorEdgeRuntime	Shared nginx edge in front of MiniStack/LocalStack host-published ECS ports.
EmulatorLifecycle	Applies EmulatorLifecycleAction to a LocalEmulatorRuntime.
EmulatorLifecycleAction	Lifecycle operations exposed by Maven goals and programmatic callers.
LocalAuthRuntime	Reconciles local processes required when canonical templates include auth the emulator cannot execute at the load balancer (for example ALB OIDC/Cognito).
LocalDeployer	Deploys adapted CloudFormation templates to a local emulator endpoint.
LocalDeploymentArtifactPaths	Canonical, adapted, and adaptation-report paths for a local deployment.
LocalDeploymentCatalog	Resolves applicationId from per-stack catalog files under deployment-contexts/.
LocalDeploymentNaming	Stack and artifact naming conventions for local deployment targets.
LocalDeploymentPipeline	Target-agnostic adapt → deploy → auth-runtime reconcile pipeline.
LocalDeploymentPipelineResult	Combined outcome of template adaptation and local CloudFormation deploy.
LocalDeploymentRequest	Inputs for adapt-and-deploy against a local emulator target.
LocalDeployResult	Outcome of deploying an adapted template to a local emulator endpoint.
LocalEmulatorDefaults	Canonical Docker and gateway defaults shared by all CloudForge local emulators.
LocalEmulatorHostPortProbe	Detects host ports already used by local emulator ECS tasks (Docker) or stack outputs (CFN).
LocalEmulatorPaths	Resolves on-disk paths used by local emulator runtimes.
LocalEmulatorRuntime	Docker lifecycle for a local AWS emulator (MiniStack or LocalStack).
LocalEmulatorRuntimeProvider	ServiceLoader entry point for LocalEmulatorRuntime implementations in target modules.
LocalEmulatorRuntimes	Discovers LocalEmulatorRuntime implementations registered by target modules.
LocalEmulatorSpec	Immutable metadata for a CloudForge-managed local emulator container.
LocalHostPortConflictChecker	Blocks local emulator deploys when the required localhost port is already in use.
LocalHostPortOccupant	A host port already claimed on the local machine by an emulator ECS task or stack output.
LocalHostPortPolicy	Resolves the host port a MiniStack Fargate deploy will bind (localhost:port).
LocalResourceChange	One CloudFormation resource change from a local deploy change set.
LocalSameApplicationStackReplacer	Deletes prior local emulator stacks for the same CloudForge applicationId when redeploying under a new stack name.
LocalSameApplicationStackReplacer.Result
LocalSameApplicationStackReplacer.StackDeleter
LocalStackCapabilitySnapshot	Snapshot of LocalStack health, edition, and service availability for adapt/deploy decisions.
LocalStackCapabilitySnapshotHealth	JSON-friendly projection of LocalStackCapabilitySnapshot for health APIs.
LocalStackServiceCapability	AWS service areas CloudForge probes on LocalStack before adapt/deploy.
LocalStackTierProfile	LocalStack product tier profile used by the template adapter.
MiniStackCfnResourceCatalog	Maps CloudFormation resource types to MiniStack support policy.
MiniStackCfnResourceCatalog.TemplateResourceRef
MiniStackResourcePolicy	How MiniStack treats a CloudFormation resource type.
PlatformRuntimeAction	Lifecycle capability exposed by a local deployment platform.
PlatformRuntimeProvider	Target-owned platform lifecycle capability, discovered through ServiceLoader.
PlatformRuntimeProviders	Classpath registry for target-owned PlatformRuntimeProvider implementations.
PreferredUrlResolver	Resolves the best "open this application" URL from a deployed stack's CFN outputs.
PreflightMessages	Formats preflight outcomes for CLI and exception messages.
PreflightMode	How local emulator deploy preflight treats violations.
PreflightResult	Outcome of a local emulator deploy preflight check.
PreflightSeverity
PreflightViolation	Single preflight finding.
StackPortLifecycle	Applies StackPortLifecycleAction to a StackPortRuntime.
StackPortLifecycleAction	StackPort lifecycle operations exposed by Maven goals and programmatic callers.
StackPortRuntime	Docker lifecycle for a target-owned StackPort resource browser.
StackPortRuntimeProvider	ServiceLoader entry point for StackPortRuntime implementations in target modules.
StackPortRuntimes	Discovers StackPortRuntime implementations registered by target modules.
StackPortSpec	Metadata for a target-owned StackPort resource browser container.
TemplateAdaptation	One audited change applied while adapting a canonical template for local deployment.
TemplateAdaptationResult	Adapted CloudFormation template plus an explicit adaptation audit trail.
TemplateAdapter	Adapts a canonical AWS CloudFormation template for a local emulator target.
TemplateAdapterSupport	File-based helpers for TemplateAdapter implementations.
TemplateResourceScanner	Reads canonical CloudFormation templates for preflight scans.