Merge pull request 'fix(ci): guard check/build/deploy against unsubstituted template' (#7) from fix-ci-template-guard into main

template-go-web was seeded from the real `hostexecutor` project and never
parameterized: go.mod hardcoded `module gitea.d-ma.be/mathias/hostexecutor` and
`hostexecutor` appeared throughout (cmd dir, Dockerfile, Taskfile, CI, context
docs). create_project_from_template therefore substituted nothing and returned
a "no placeholders" partial_failure on the zero-config default path.

Replaced the full module path with __MODULE_PATH__ and the bare project name
with __PROJECT_NAME__ (incl. renaming cmd/hostexecutor → cmd/__PROJECT_NAME__),
matching the substitution the tool performs. Also drops the stale gitea.d-ma.be
host (the placeholder resolves to git.d-ma.be/<owner>/<name>).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

.aider.conf.yml

@@ -0,0 +1,2 @@
+read: .aider.conventions.md
+auto-commits: false

.aider.conventions.md

@@ -0,0 +1,13 @@
+# __PROJECT_NAME__
+
+## Identity
+
+- **Name**: __PROJECT_NAME__
+- **Owner**: Mathias
+- **Client**: personal
+- **Repo**: __MODULE_PATH__
+- **Status**: active
+
+## Stack
+
+Go + Templ + HTMX + CDN Tailwind. See `~/dev/.context/AGENT.md` for cross-project conventions.

.context/PROJECT.md

@@ -5,7 +5,7 @@
 - **Name**: __PROJECT_NAME__
 - **Owner**: Mathias
 - **Client**: personal
-- **Repo**: gitea.d-ma.be/mathias/__PROJECT_NAME__
+- **Repo**: __MODULE_PATH__
 - **Status**: active
 
 ## Stack

.context/mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "knowledge": {
+      "url": "http://localhost:3100/mcp",
+      "description": "Project knowledge base — vector + graph retrieval"
+    }
+  }
+}

.context/system-prompt.txt

@@ -0,0 +1,20 @@
+You are a coding assistant working on a specific project.
+Follow all conventions from both the root agent context and project context.
+
+---
+
+# __PROJECT_NAME__
+
+## Identity
+
+- **Name**: __PROJECT_NAME__
+- **Owner**: Mathias
+- **Client**: personal
+- **Repo**: __MODULE_PATH__
+- **Status**: active
+
+## Stack
+
+Go + Templ + HTMX + CDN Tailwind. See `~/dev/.context/AGENT.md` for cross-project conventions.
+
+---

.cursorrules

@@ -0,0 +1,16 @@
+# Cursor rules — auto-generated
+# Do not edit. Run: task context:sync
+
+# __PROJECT_NAME__
+
+## Identity
+
+- **Name**: __PROJECT_NAME__
+- **Owner**: Mathias
+- **Client**: personal
+- **Repo**: __MODULE_PATH__
+- **Status**: active
+
+## Stack
+
+Go + Templ + HTMX + CDN Tailwind. See `~/dev/.context/AGENT.md` for cross-project conventions.

.gitea/workflows/cd.yml

@@ -11,8 +11,25 @@ env:
   IMAGE: __PROJECT_NAME__
 
 jobs:
+  guard:
+    name: Detect unsubstituted template
+    runs-on: self-hosted
+    outputs:
+      is_template: ${{ steps.detect.outputs.is_template }}
+    steps:
+      - uses: actions/checkout@v4
+      - id: detect
+        run: |
+          if grep -q '__MODULE_PATH__' go.mod; then
+            echo "is_template=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "is_template=false" >> "$GITHUB_OUTPUT"
+          fi
+
   check:
     name: Lint / Test / Vet
+    needs: guard
+    if: needs.guard.outputs.is_template != 'true'
     runs-on: self-hosted
     steps:
       - uses: actions/checkout@v4
@@ -34,9 +51,9 @@ jobs:
 
   build:
     name: Build & Import
-    needs: check
+    needs: [guard, check]
+    if: needs.guard.outputs.is_template != 'true' && github.event_name != 'pull_request'
     runs-on: self-hosted
-    if: github.event_name != 'pull_request'
     outputs:
       image-tag: ${{ steps.meta.outputs.sha-tag }}
     steps:
@@ -63,9 +80,9 @@ jobs:
 
   deploy:
     name: Deploy via GitOps
-    needs: build
+    needs: [guard, build]
+    if: needs.guard.outputs.is_template != 'true' && github.ref == 'refs/heads/main' && github.event_name == 'push'
     runs-on: self-hosted
-    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
     steps:
       - name: Update image tag in infra repo
         env:

.gitea/workflows/init.yml

@@ -1,107 +0,0 @@
-name: Init
-
-# One-shot bootstrap — runs on first push to main, skips if already initialised.
-# Substitutes all __PROJECT_NAME__ / __MODULE_PATH__ placeholders (file contents
-# and directory names), then runs context:sync to generate CLAUDE.md and friends.
-# Deletes itself on completion so it never runs again.
-
-on:
-  push:
-    branches: [main]
-
-jobs:
-  init:
-    name: Bootstrap project from template
-    runs-on: self-hosted
-
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Check if already initialised
-        id: guard
-        run: |
-          if [ -f CLAUDE.md ]; then
-            echo "skip=true" >> "$GITHUB_OUTPUT"
-          else
-            echo "skip=false" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: Derive project variables
-        if: steps.guard.outputs.skip == 'false'
-        id: vars
-        run: |
-          PROJECT_NAME=$(basename "$(git rev-parse --show-toplevel)")
-          GITEA_HOST=$(git remote get-url origin | sed 's|http://||;s|https://||;s|/.*||')
-          OWNER=$(git remote get-url origin | sed 's|.*://[^/]*/\([^/]*\)/.*|\1|')
-          MODULE_PATH="${GITEA_HOST}/${OWNER}/${PROJECT_NAME}"
-          echo "project_name=${PROJECT_NAME}" >> "$GITHUB_OUTPUT"
-          echo "module_path=${MODULE_PATH}"   >> "$GITHUB_OUTPUT"
-          echo "→ PROJECT_NAME=${PROJECT_NAME}"
-          echo "→ MODULE_PATH=${MODULE_PATH}"
-
-      - name: Configure git with token
-        if: steps.guard.outputs.skip == 'false'
-        env:
-          GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
-        run: |
-          REMOTE=$(git remote get-url origin)
-          # Inject token into remote URL for push-back
-          AUTH_REMOTE=$(echo "$REMOTE" | sed "s|http://|http://gitea-actions:${GITEA_TOKEN}@|")
-          git remote set-url origin "$AUTH_REMOTE"
-          git config user.name  "gitea-actions[bot]"
-          git config user.email "gitea-actions[bot]@noreply.local"
-
-      - name: Substitute placeholders in file contents
-        if: steps.guard.outputs.skip == 'false'
-        env:
-          PROJECT_NAME: ${{ steps.vars.outputs.project_name }}
-          MODULE_PATH:  ${{ steps.vars.outputs.module_path }}
-        run: |
-          set -euo pipefail
-          while IFS= read -r f; do
-            if grep -qE '__PROJECT_NAME__|__MODULE_PATH__' "$f" 2>/dev/null; then
-              sed -i \
-                -e "s|__PROJECT_NAME__|${PROJECT_NAME}|g" \
-                -e "s|__MODULE_PATH__|${MODULE_PATH}|g" \
-                "$f"
-              echo "  substituted: $f"
-            fi
-          done < <(git ls-files | grep -v '^\.gitea/workflows/init\.yml$')
-
-      - name: Rename templated directories
-        if: steps.guard.outputs.skip == 'false'
-        env:
-          PROJECT_NAME: ${{ steps.vars.outputs.project_name }}
-        run: |
-          set -euo pipefail
-          if [ -d "cmd/__PROJECT_NAME__" ]; then
-            git mv "cmd/__PROJECT_NAME__" "cmd/${PROJECT_NAME}"
-            echo "  renamed: cmd/__PROJECT_NAME__ → cmd/${PROJECT_NAME}"
-          fi
-
-      - name: Install task if missing
-        if: steps.guard.outputs.skip == 'false'
-        run: |
-          which task 2>/dev/null || go install github.com/go-task/task/v3/cmd/task@latest
-
-      - name: Run context:sync
-        if: steps.guard.outputs.skip == 'false'
-        run: task context:sync
-
-      - name: Remove this init workflow
-        if: steps.guard.outputs.skip == 'false'
-        run: |
-          git rm .gitea/workflows/init.yml
-          echo "  removed: .gitea/workflows/init.yml"
-
-      - name: Commit and push
-        if: steps.guard.outputs.skip == 'false'
-        env:
-          PROJECT_NAME: ${{ steps.vars.outputs.project_name }}
-        run: |
-          git add -A
-          git commit -m "chore: bootstrap ${PROJECT_NAME} from template"
-          git push origin main
-          echo "✓ project initialised"

AGENTS.md

@@ -0,0 +1,13 @@
+# __PROJECT_NAME__
+
+## Identity
+
+- **Name**: __PROJECT_NAME__
+- **Owner**: Mathias
+- **Client**: personal
+- **Repo**: __MODULE_PATH__
+- **Status**: active
+
+## Stack
+
+Go + Templ + HTMX + CDN Tailwind. See `~/dev/.context/AGENT.md` for cross-project conventions.

CLAUDE.md

@@ -0,0 +1,13 @@
+# __PROJECT_NAME__
+
+## Identity
+
+- **Name**: __PROJECT_NAME__
+- **Owner**: Mathias
+- **Client**: personal
+- **Repo**: __MODULE_PATH__
+- **Status**: active
+
+## Stack
+
+Go + Templ + HTMX + CDN Tailwind. See `~/dev/.context/AGENT.md` for cross-project conventions.