feat: add runtime and init-image support (TDD)

.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: mcrich23 # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/workflows/README.md

@@ -0,0 +1,36 @@
+# GitHub Actions Workflows
+
+This directory contains GitHub Actions workflows for Container-Compose.
+
+## Available Workflows
+
+### Tests (`tests.yml`)
+
+A required status check for pull requests that must be run manually before merging.
+
+**How to run:**
+1. Go to the "Actions" tab in the GitHub repository
+2. Select "Tests" workflow from the left sidebar
+3. Click "Run workflow" button
+4. Select the branch (e.g., your PR branch)
+5. Click "Run workflow" to start the tests
+
+**Requirements:** macOS 15 runner (tests require macOS environment)
+
+**Note:** Tests are configured as a required check but do NOT run automatically on each commit. This allows you to control when tests run (e.g., after you're done with a series of commits) while still enforcing that tests must pass before merging.
+
+## Test Environment
+
+All tests run on macOS 15 with Swift 6.0+ because:
+- Container-Compose depends on `apple/container` package
+- The upstream dependency requires macOS-specific `os` module
+- Swift Package Manager dependencies are cached for faster builds
+
+## Troubleshooting
+
+If tests fail to run:
+1. Check that the workflow was triggered on the correct branch
+2. Verify Package.swift is valid
+3. Check the Actions tab for detailed logs
+4. Ensure macOS 15 runners are available
+5. If the workflow doesn't appear as a status check, you may need to run it once first

.github/workflows/release.yml

@@ -0,0 +1,65 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Release version (e.g., v1.0.0)'
+        required: false
+        type: string
+
+jobs:
+  build-release:
+    runs-on: macos-26
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Swift
+        uses: maartene/setup-swift@main
+        with:
+          swift-version: '6.2'
+
+      - name: Build Release
+        run: swift build -c release
+
+      - name: Create Release
+        if: github.event_name == 'push'
+        uses: softprops/action-gh-release@v1
+        with:
+          name: ${{ github.ref_name }}
+          draft: false
+          prerelease: ${{ contains(github.ref_name, 'alpha') || contains(github.ref_name, 'beta') }}
+          files: |
+            .build/release/container-compose
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Upload to Release
+        if: github.event_name == 'workflow_dispatch'
+        run: |
+          # Create release if it doesn't exist
+          VERSION="${{ github.inputs.version || 'latest' }}"
+          TAG="v${VERSION#v}"
+
+          # Create or get release ID
+          RELEASE_ID=$(gh api repos/${{ github.repository }}/releases/tags/$TAG --jq '.id' 2>/dev/null || echo "")
+
+          if [ -z "$RELEASE_ID" ]; then
+            RELEASE_ID=$(gh api repos/${{ github.repository }}/releases -X POST \
+              --field tag_name="$TAG" \
+              --field name="$TAG" \
+              --field draft=false \
+              --jq '.id')
+          fi
+
+          # Upload asset
+          gh api repos/${{ github.repository }}/releases/$RELEASE_ID/assets \
+            -F "file=@.build/release/container-compose" \
+            -F "name=container-compose"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/tests.yml

@@ -0,0 +1,88 @@
+name: Tests and Release
+
+on:
+  # Manual trigger only - run via workflow_dispatch
+  workflow_dispatch:
+  # Required status check for PRs (but doesn't auto-run on commits)
+  push:
+    branches: [main]
+    paths:
+      - "Sources/**"
+      - "Tests/**"
+      - "Package.swift"
+      - ".github/workflows/tests.yml"
+  pull_request:
+    branches: [main]
+    paths:
+      - "Sources/**"
+      - "Tests/**"
+      - "Package.swift"
+      - ".github/workflows/tests.yml"
+
+jobs:
+  test:
+    name: Run Swift Static Tests
+    runs-on: macos-26
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Swift
+        uses: maartene/setup-swift@main
+        with:
+          swift-version: "6.2"
+
+      - name: Cache Swift dependencies
+        uses: actions/cache@v4
+        with:
+          path: .build
+          key: ${{ runner.os }}-spm-${{ hashFiles('Package.resolved') }}
+          restore-keys: |
+            ${{ runner.os }}-spm-
+
+      - name: Build
+        run: swift build --build-tests
+
+      - name: Run static tests
+        run: swift test --filter Container-Compose-StaticTests.
+
+      - name: Upload static test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results
+          path: .build/debug/*.xctest
+          if-no-files-found: ignore
+
+  build-release:
+    name: Build Release Binary
+    runs-on: macos-26
+    needs: test
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Swift
+        uses: maartene/setup-swift@main
+        with:
+          swift-version: "6.2"
+
+      - name: Cache Swift dependencies
+        uses: actions/cache@v4
+        with:
+          path: .build
+          key: ${{ runner.os }}-spm-release-${{ hashFiles('Package.resolved') }}
+          restore-keys: |
+            ${{ runner.os }}-spm-release-
+
+      - name: Build Release
+        run: swift build -c release
+
+      - name: Upload Binary
+        uses: actions/upload-artifact@v4
+        with:
+          name: container-compose-release
+          path: .build/release/container-compose
+          if-no-files-found: error

.gitignore

@@ -6,3 +6,4 @@ DerivedData/
 .swiftpm/configuration/registries.json
 .swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
 .netrc
+.vscode/launch.json

.swiftpm/xcode/xcshareddata/xcschemes/Container-Compose.xcscheme

@@ -29,6 +29,38 @@
       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
       shouldUseLaunchSchemeArgsEnv = "YES"
       shouldAutocreateTestPlan = "YES">
+      <Testables>
+         <TestableReference
+            skipped = "NO">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "Container-ComposeTests"
+               BuildableName = "Container-ComposeTests"
+               BlueprintName = "Container-ComposeTests"
+               ReferencedContainer = "container:">
+            </BuildableReference>
+         </TestableReference>
+         <TestableReference
+            skipped = "NO">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "Container-Compose-StaticTests"
+               BuildableName = "Container-Compose-StaticTests"
+               BlueprintName = "Container-Compose-StaticTests"
+               ReferencedContainer = "container:">
+            </BuildableReference>
+         </TestableReference>
+         <TestableReference
+            skipped = "NO">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "Container-Compose-DynamicTests"
+               BuildableName = "Container-Compose-DynamicTests"
+               BlueprintName = "Container-Compose-DynamicTests"
+               ReferencedContainer = "container:">
+            </BuildableReference>
+         </TestableReference>
+      </Testables>
    </TestAction>
    <LaunchAction
       buildConfiguration = "Debug"
@@ -39,7 +71,9 @@
       ignoresPersistentStateOnLaunch = "NO"
       debugDocumentVersioning = "YES"
       debugServiceExtension = "internal"
-      allowLocationSimulation = "YES">
+      allowLocationSimulation = "YES"
+      consoleMode = "0"
+      structuredConsoleMode = "2">
       <BuildableProductRunnable
          runnableDebuggingMode = "0">
          <BuildableReference
@@ -52,17 +86,25 @@
       </BuildableProductRunnable>
       <CommandLineArguments>
          <CommandLineArgument
-            argument = "down"
+            argument = "up"
             isEnabled = "YES">
          </CommandLineArgument>
+         <CommandLineArgument
+            argument = "down"
+            isEnabled = "NO">
+         </CommandLineArgument>
          <CommandLineArgument
             argument = "-d"
             isEnabled = "NO">
          </CommandLineArgument>
          <CommandLineArgument
-            argument = "--build"
+            argument = "db"
             isEnabled = "NO">
          </CommandLineArgument>
+         <CommandLineArgument
+            argument = "--build"
+            isEnabled = "YES">
+         </CommandLineArgument>
          <CommandLineArgument
             argument = "--cwd=/Users/mcrich/Xcode/Assignment-Manager-API"
             isEnabled = "YES">

CHANGELOG.md

@@ -0,0 +1,32 @@
+# CHANGELOG
+
+## v0.9.1 - Fork release (explicitcontextualunderstanding)
+
+This release bundles several upstream fixes and improvements merged into this fork. Highlights and user-facing notes:
+
+- dnsSearch support
+  - Commit: https://github.com/Mcrich23/Container-Compose/commit/d509f8af30f9d2382c1804f575ea0f22eb4e5734
+  - User note: Services can now specify dns_search/dnsSearch entries so containers can resolve each other by name using custom DNS search domains. Configure in your service's networks or service definition.
+
+- Multi-stage Docker build target support
+  - Commit: https://github.com/Mcrich23/Container-Compose/commit/02ca6462b84121c1553bd7adb862ee22aabc4997
+  - User note: When using build: with Dockerfiles that include multiple stages, the `target` field is respected so you can build a specific stage (e.g., `build: { context: ".", target: "release" }`).
+
+- Improved volume handling and named-volume destination preservation
+  - Commits/PRs: https://github.com/Mcrich23/Container-Compose/commit/b1badf86a4faf5c6ed512643e255760073d38988, https://github.com/Mcrich23/Container-Compose/pull/32, https://github.com/Mcrich23/Container-Compose/pull/42
+  - User note: Named volumes now preserve full destination paths (e.g., `- elasticsearch-data:/usr/share/elasticsearch/data`), and relative host paths are normalized to absolute paths for bind mounts.
+
+- Correct --entrypoint placement
+  - Commit: https://github.com/Mcrich23/Container-Compose/commit/84201f9416f4a5f1bd383763679f8e2fd7579e94
+  - User note: Entrypoint overrides in compose files are now passed to the container run command properly (as `--entrypoint <cmd>` before the image), preventing unexpected immediate container exit.
+
+- Startup/wait fixes and improved command debugging
+  - Commits: https://github.com/Mcrich23/Container-Compose/commit/8a4e5bb0e634155d122ac5d93905a75dcbf5b3da, https://github.com/Mcrich23/Container-Compose/commit/eeddb266a45686c99f53f300c2c5d049b1f3b157, https://github.com/Mcrich23/Container-Compose/commit/4968a8669babe7822ada82cc90328f102edfd02e
+  - User note: Waiting logic no longer times out incorrectly when a container is already running; the tool prints the exact container run command being executed to aid debugging.
+
+- CI and release automation (fork-specific)
+  - Origin commits: https://github.com/explicitcontextualunderstanding/Container-Compose/commit/3f20dbf6a6268a93fa196632caa2c178214892f7 and https://github.com/explicitcontextualunderstanding/Container-Compose/commit/98b7fc4a50467067158d15eb47d9acca78121719
+  - User note: This fork adds GitHub Actions for release automation used by the maintainers of this fork.
+
+
+For full details and links to the source commits/PRs, see FORK_CHANGES.md.

CONTRIBUTING.md

@@ -0,0 +1,10 @@
+## Contributing to Container-Compose
+
+Contributions are welcome! Please open issues or submit pull requests to help improve this project.
+
+1. Fork the repository.
+2. Create your feature branch (`git checkout -b feat/YourFeature`).
+3. Commit your changes (`git commit -am 'Add new feature'`).
+4. Add tests to you changes.
+5. Push to the branch (`git push origin feature/YourFeature`).
+6. Open a pull request.