docs(readme): production in the fleet deploys from infra/komodo, make deploy stays for a checkout deployed by hand

README.md

@@ -11,6 +11,8 @@ A part is a directory with:
 
 Application services carry the `services` profile, databases and other infrastructure carry `external`.
 
+`mcp_servers` writes `.mcp.json` with the Context7 and Svelte docs servers.
+
 The root also gets a `renovate.jsonc` that is nothing but an `extends` on the
 shared preset in `templates/renovate`. It does not subscribe the repo to
 anything on its own: the bot walks an explicit list, so a new repo still has to

copier.yml

@@ -32,6 +32,15 @@ parts:
     frontend: frontend
   default: []
 
+mcp_servers:
+  type: str
+  multiselect: true
+  help: MCP servers in .mcp.json
+  choices:
+    Context7 (library docs): context7
+    Svelte docs: svelte
+  default: []
+
 init_git:
   type: bool
   help: git init and install pre-commit hooks

template/.gitignore.jinja

@@ -14,3 +14,5 @@ node_modules/
 .svelte-kit/
 /build/
 {% endif %}
+# Local playground
+/t/

template/{% if layout == 'parts' %}Makefile{% endif %}

@@ -3,8 +3,17 @@ PARTS := $(patsubst %/Makefile,%,$(wildcard */Makefile))
 .PHONY: env recreate rebuild restart logs down deploy fmt check build pre-deploy post-deploy
 
 env:
-	@test -f .env || awk 'FNR == 1 && NR > 1 { print "" } 1' .env.example $(addsuffix /.env.example,$(PARTS)) > .env
-	@for part in $(PARTS); do test -f $$part/docker-compose.override.yml || cp $$part/docker-compose.override.yml.example $$part/docker-compose.override.yml; done
+	@fresh=; test -f .env || { awk 'FNR == 1 && NR > 1 { print "" } 1' .env.example $(addsuffix /.env.example,$(PARTS)) > .env; fresh=1; }; \
+	for part in $(PARTS); do \
+		override=$$part/docker-compose.override.yml; \
+		test -f $$override && continue; \
+		cp $$override.example $$override; \
+		for port in $$(sed -n 's/.*127\.0\.0\.1:\([0-9]*\):.*/\1/p' $$override | sort -u); do \
+			random=$$((20000 + $$(od -An -N2 -tu2 /dev/urandom) % 40000)); \
+			sed "s/127\.0\.0\.1:$$port:/127.0.0.1:$$random:/" $$override > $$override.tmp && mv $$override.tmp $$override; \
+			test -z "$$fresh" || { sed "s|localhost:$$port/|localhost:$$random/|" .env > .env.tmp && mv .env.tmp .env; }; \
+		done; \
+	done
 
 recreate:
 	docker compose up -d --force-recreate

template/{% if layout == 'parts' %}README.md{% endif %}.jinja

@@ -13,4 +13,6 @@ make recreate
 
 To deploy, `git pull && make deploy`. It runs `make pre-deploy` in every part, which builds images only when their inputs changed and applies migrations, then `docker compose up -d`, then `make post-deploy`, which restarts the services whose mounted code changed. A deploy system with its own `up` step calls the two hooks around it. What was built and started is remembered as `refs/deploy/*` in the clone.
 
+In the fleet, production is deployed from `infra/komodo` instead (git mode of Komodo, see `docs/architecture.md` there): Komodo clones this repo, and a layer plus `deploy.sh` in the stack's directory tag images by the hash of what they bake in, write `.env` from sops and run migrations before the code. The repo only has to stay a plain recipe: images built from `build:` in compose, migrations as the `migrator` service when there is a database, `caddy/site.caddy`. `make deploy` and `refs/deploy/*` are for a checkout deployed by hand.
+
 `make fmt`, `make check` and `make build` run in every part. Part-specific targets live in the part's own Makefile: `make -C {{ parts[0] }} ...`.

template/{% if mcp_servers %}.mcp.json{% endif %}.jinja

@@ -0,0 +1,11 @@
+{%- set urls = {'context7': 'https://mcp.context7.com/mcp', 'svelte': 'https://mcp.svelte.dev/mcp'} -%}
+{
+  "mcpServers": {
+{%- for server in mcp_servers %}
+    "{{ server }}": {
+      "type": "http",
+      "url": "{{ urls[server] }}"
+    }{{ "," if not loop.last }}
+{%- endfor %}
+  }
+}