feat(dargstack)!: migrate to v4

.github/FUNDING.yml

@@ -1,12 +1 @@
-# These are supported funding model platforms
-
-github: [dargmuesli] # 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
-otechie: # Replace with a single Otechie username
-custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
+github: [dargmuesli]

.github/workflows/ci.yml

@@ -20,12 +20,31 @@ jobs:
   build:
     needs: ci-optimization
     if: needs.ci-optimization.outputs.continue == 'true'
-    name: dargstack rgen
-    uses: dargmuesli/github-actions/.github/workflows/dargstack-rgen.yml@7fbad16a13b7cbfe4f905498c71cd5e2c08751d8 # 5.5.2
+    name: Update generated docs
+    runs-on: ubuntu-latest
     permissions:
-      contents: read
-    with:
-      APT_PACKAGES: mkcert
+      contents: write
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+        with:
+          ref: ${{ github.head_ref || github.ref_name }}
+      - name: Regenerate docs
+        run: |
+          go install github.com/dargstack/dargstack/v4/cmd/dargstack@v4.0.0-beta.16
+          export PATH="$(go env GOPATH)/bin:$PATH"
+          dargstack document
+      - name: Commit and push updated docs
+        if: github.event_name == 'push'
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add artifacts/docs/
+          if git diff --staged --quiet; then
+            echo "Docs are already up to date"
+          else
+            git commit -m "chore: update generated docs"
+            git push
+          fi
   release-semantic:
     needs: build
     name: Semantic Release

.releaserc.json

@@ -15,14 +15,7 @@
       }
     ],
     "@semantic-release/changelog",
-    [
-      "@semantic-release/exec",
-      {
-        "prepareCmd": "pnpm version ${nextRelease.version} --git-tag-version=false --no-git-checks"
-      }
-    ],
     "@semantic-release/github",
     "@semantic-release/git"
-  ],
-  "tagFormat": "${version}"
+  ]
 }

AGENTS.md

@@ -0,0 +1,44 @@
+---
+applyTo: '**'
+---
+# Project Instructions
+
+`stack` is the Docker Swarm configuration for [vibetype.app](https://vibetype.app/), an event community platform, managed with [dargstack](https://github.com/dargstack/dargstack/).
+
+## Documentation Map
+
+**For understanding the stack structure and deployment:**
+- [README.md](README.md): Project overview, quick start
+- [artifacts/docs/README.md](artifacts/docs/README.md): Auto-generated service, secret and volume reference (do not edit manually)
+
+**For contributing:**
+- [CONTRIBUTING.md](CONTRIBUTING.md): Development setup, dargstack guidelines, code style, git workflow
+
+## Code Style
+
+- Do not use abbreviations in naming, except where omitting them would look unnatural
+- Use natural language in any non-code text instead of referring to code directly, e.g. "the database's password" instead of "the `postgres_password`", except when a code reference is needed
+- Use backticks in any non-code text to refer to code, e.g. "`postgres`" instead of "postgres"
+- Sort YAML keys lexicographically except where order is semantically significant
+- Code formatting is done by the editor via `.editorconfig`
+
+## Git
+
+- Work on branches other than the default branch
+  - Use this branch naming pattern: `<type>/<scope>/<description>`
+- Git commit titles must follow the Conventional Commits specification and be lowercase only
+  - The commit scope should not be repeated in the commit description, e.g. `feat(postgres): add role` instead of `feat(postgres): add postgres role`
+- Git commit scopes must be chosen as follows (ordered by priority):
+  1. service name, e.g. `postgres`, `traefik`, `vibetype`
+  2. simplified dependency name, e.g. `dargstack`, `docker`
+  3. area, e.g. `secrets`, `volumes`, `certificates`
+- Commit bodies are only to be filled in when necessary, e.g. to mention a resolved issue link
+
+## Docker / dargstack
+
+- Each service lives under `src/development/<service>/compose.yaml` as a full Compose document and optionally `src/production/<service>/compose.yaml` as a delta-only override
+- Lines annotated with `# dargstack:dev-only` are stripped from production compose
+- Run `dargstack build <service>` after changing a service's source code to rebuild its development container image
+- Run `dargstack validate` to check the stack configuration
+- Run `dargstack document` to regenerate `artifacts/docs/README.md` (do not edit that file manually)
+- Do not commit files from `artifacts/` unless they are tracked (e.g. `artifacts/docs/SERVICES_ADDITIONAL.md`)

CONTRIBUTING.md

@@ -0,0 +1,116 @@
+# Contributing to stack
+
+Thank you for your interest in contributing!
+
+The fullstack environment composes several services, among those are the following first-party:
+
+| Repository | Required | Profile | Access |
+|---|---|---|---|
+| [maevsi/android](https://github.com/maevsi/android) | optional | — | public |
+| [maevsi/ios](https://github.com/maevsi/ios) | optional | — | public |
+| [maevsi/postgraphile](https://github.com/maevsi/postgraphile) | ✅ | `default` | public |
+| [maevsi/reccoom](https://github.com/maevsi/reccoom) | optional | `recommendation` | private |
+| [maevsi/sqitch](https://github.com/maevsi/sqitch) | ✅ | `default` | public |
+| [maevsi/stack](https://github.com/maevsi/stack) | ✅ | — | public |
+| [maevsi/vibetype](https://github.com/maevsi/vibetype) | ✅ | `default` | public |
+
+## Development Setup
+
+There are two development modes:
+
+| Mode | When to use | Setup | Where to start |
+|---|---|---|---|
+| **Frontend only** | Working on UI, i18n, or anything that doesn't require running backend services | Manual only | [Vibetype repository](https://github.com/maevsi/vibetype#development) |
+| **Fullstack** | Working on backend services, the database, the API, or any cross-cutting concern | Automated or manual | This guide (continue reading) |
+
+> 🪟 **Windows users:** Set up [WSL](https://docs.microsoft.com/en-us/windows/wsl/install) first and continue inside the Linux subsystem.
+> If you use VS Code, see [VS Code + WSL](https://learn.microsoft.com/en-us/windows/wsl/tutorials/wsl-vscode).
+
+### Automated Setup
+
+```sh
+dargstack init
+```
+<!-- TODO: add https://github.com/maevsi/stack.git parameter -->
+### Manual Setup
+
+If you prefer to step through each action yourself:
+
+1. Install prerequisites
+
+    1. [Git](https://git-scm.com/): version control
+    2. [Docker](https://docs.docker.com/engine/install/): container runtime
+    3. [dargstack](https://github.com/dargstack/dargstack#install): stack management CLI
+    <!-- 4. [nvm](https://github.com/nvm-sh/nvm#installing-and-updating): Node.js version manager (for Vibetype frontend setup) -->
+
+1. Create a parent directory and clone the sibling repositories into it:
+
+   ```sh
+   mkdir vibetype && cd vibetype
+   git clone git@github.com:maevsi/android.git # optional
+   git clone git@github.com:maevsi/ios.git # optional
+   git clone git@github.com:maevsi/postgraphile.git
+   git clone git@github.com:maevsi/reccoom.git # optional, private
+   git clone git@github.com:maevsi/sqitch.git
+   git clone git@github.com:maevsi/stack.git
+   git clone git@github.com:maevsi/vibetype.git
+   ```
+
+   <details>
+     <summary>Click here if you don't have SSH set up (you should!) to use HTTPS URLs instead</summary>
+
+
+   ```sh
+   mkdir vibetype && cd vibetype
+   git clone https://github.com/maevsi/android.git # optional
+   git clone https://github.com/maevsi/ios.git # optional
+   git clone https://github.com/maevsi/postgraphile.git
+   git clone https://github.com/maevsi/reccoom.git # optional, private
+   git clone https://github.com/maevsi/sqitch.git
+   git clone https://github.com/maevsi/stack.git
+   git clone https://github.com/maevsi/vibetype.git
+   ```
+    </details>
+
+2. Initialize all cloned projects for development according to their READMEs.
+
+3. Build development container images:
+
+   ```sh
+   cd stack
+   dargstack build
+   ```
+
+   An interactive selection dialog will let you choose which services to build.
+
+4. Deploy:
+
+   ```sh
+   dargstack deploy
+   ```
+
+5. You should now be able to access Vibetype at [https://app.localhost](https://app.localhost) 🎉
+
+
+## Guidelines
+
+### Git & GitHub
+
+Follow [@dargmuesli's Contributing Guidelines](https://gist.github.com/dargmuesli/430b7d902a22df02d88d1969a22a81b5#contribution-workflow) for branch naming, commit formatting, and the pull request workflow.
+
+### Semantic Versioning
+
+Read [@dargmuesli's guide on Semantic Versioning](https://gist.github.com/dargmuesli/430b7d902a22df02d88d1969a22a81b5#file-semantic-versioning-md) for how to format PR, issue and commit titles.
+
+### dargstack
+
+- Service files live in `src/development/<service>/compose.yaml` (full Compose document) and `src/production/<service>/compose.yaml` (production delta only).
+- Run `dargstack build` to interactively select and build development container images after making changes to a service's source code.
+- Run `dargstack document` to regenerate `artifacts/docs/README.md` after adding or modifying services.
+- Do not edit `artifacts/` files directly: they are generated or gitignored.
+
+### Code Style
+
+- Keep YAML keys sorted lexicographically where order is semantically irrelevant.
+- Use natural language in comments; refer to code artifacts with backticks.
+- Do not use abbreviations in names unless omitting them would look unnatural.

Dockerfile.md

@@ -0,0 +1,3 @@
+# <DEPENDENCIES>
+FROM ghcr.io/dargstack/dargstack:4.0.0-beta.16
+# </DEPENDENCIES>