diff --git a/.githooks/pre-commit b/.githooks/pre-commit new file mode 100755 index 0000000..82456f7 --- /dev/null +++ b/.githooks/pre-commit @@ -0,0 +1,12 @@ +#!/usr/bin/env bash +set -euo pipefail + +if [[ -f package.json && -f scripts/release-sync.cjs && -f scripts/release-verify.cjs ]]; then + npm run --silent release:sync >/dev/null + if [[ -d public ]]; then + while IFS= read -r -d '' file; do + git add -- "$file" + done < <(find public -type f -name '*.html' -print0 2>/dev/null) + fi + npm run --silent release:verify +fi diff --git a/AGENTS.md b/AGENTS.md index 5109bed..ee38f29 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -30,3 +30,10 @@ helldivers/ ## Sicherheit - Niemals `data/helldivers.db` committen + +## Release-Automation +- **Version ist Single Source of Truth:** `package.json` +- **Cache-Busting nie manuell pflegen** – stattdessen `npm run release:sync` +- **Vor jedem Commit zusätzlich:** `npm run release:verify` +- Repo-Hook: `.githooks/pre-commit` führt `release:sync` und `release:verify` automatisch aus +- Für Versionssprünge: `npm run release:bump:patch`, `release:bump:minor` oder `release:bump:major` diff --git a/CHANGELOG.md b/CHANGELOG.md index 3671bdc..f18a884 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,4 +1,9 @@ -# Changelog – helldivers-trainer +# Changelog + +## [Unreleased] + +### Changed +- Release-Automation ergänzt: `npm run release:sync`, `npm run release:verify`, `.githooks/pre-commit` und versionsbasiertes Cache-Busting aus `package.json` – helldivers-trainer ## [2.1.3] – 2026-03-31 diff --git a/CLAUDE.md b/CLAUDE.md index c1a9a80..5d8870a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -40,3 +40,11 @@ Falls Funktionen, API-Routen, WebSocket-Message-Types oder State-Variablen **hin ## Changelog - Nach jeder Änderung `CHANGELOG.md` aktualisieren - Format: `## [Unreleased]` für laufende Änderungen + +## Release Automation + +- Version source of truth: `package.json` +- Never update `?v=...` asset parameters manually; use `npm run release:sync` +- Run `npm run release:verify` before commit whenever frontend/server/version files changed +- Repo hook: `.githooks/pre-commit` runs release sync + verification automatically +- Use `npm run release:bump:patch`, `release:bump:minor`, or `release:bump:major` for version bumps diff --git a/PROJECT_MAP.md b/PROJECT_MAP.md index 8d678dd..5183e97 100644 --- a/PROJECT_MAP.md +++ b/PROJECT_MAP.md @@ -132,3 +132,9 @@ state = { ### WebSocket Message Types (Server → Client) `lobby_update`, `challenge_received`, `challenge_declined`, `match_start`, `round_start`, `round_result`, `match_end`, `opponent_progress`, `error` + +## Release Automation +- Version source of truth: `package.json` +- `scripts/release-sync.cjs`: synchronisiert lokale CSS/JS-Referenzen in HTML-Dateien auf die aktuelle Paketversion +- `scripts/release-verify.cjs`: prüft Version-Parameter sowie Pflichtdateien wie `CHANGELOG.md` und `PROJECT_MAP.md` vor Commits +- `.githooks/pre-commit`: führt Release-Sync und Verify automatisch aus diff --git a/package.json b/package.json index b356c6e..d68093c 100644 --- a/package.json +++ b/package.json @@ -5,7 +5,12 @@ "main": "server.js", "scripts": { "start": "node server.js", - "dev": "node --watch server.js" + "dev": "node --watch server.js", + "release:sync": "node scripts/release-sync.cjs", + "release:verify": "node scripts/release-verify.cjs", + "release:bump:patch": "npm version patch --no-git-tag-version && npm run release:sync", + "release:bump:minor": "npm version minor --no-git-tag-version && npm run release:sync", + "release:bump:major": "npm version major --no-git-tag-version && npm run release:sync" }, "dependencies": { "bcryptjs": "^3.0.3", diff --git a/public/index.html b/public/index.html index 0a0cfab..39e38fc 100644 --- a/public/index.html +++ b/public/index.html @@ -7,7 +7,7 @@ - + @@ -55,24 +55,47 @@
-
- @@ -105,6 +128,28 @@ -
- -
- -
⚡
+
+
+ Live Drill + Stay on target
-
-
-
-
Arrow Keys or D-Pad · Esc to stop
-
+ - -
+
+ +
+ +
⚡
+
+
+
+
+
Arrow Keys or D-Pad · Esc to stop
+
-
- -
-
TIME
-
- - - - -
30
+ +
+ +
+ +
+
TIME
+
+ + + + +
30
+
+
+ + + + +
+
SCORE
+
0
+
+
+
STREAK
+
0
+
- -
@@ -406,27 +461,38 @@
-
-
-
YOU
-
+
+ +
+
+
YOU
+
+
+
0 / 0
+
+
+
+
+
OPPONENT
+
+
+
0 / 0
+
+
+
-
-
OPPONENT
-
-
-
-
-
- -
-
- -
- -
-
- +
+
+ +
+
+ +
+ +
+
+ +
@@ -451,14 +517,16 @@
- - - - - - - -
#HelldiverRankTotal ScoreSessionsMatch W/Total
Loading...
+
+ + + + + + + +
#HelldiverRankTotal ScoreSessionsMatch W/Total
Loading...
+
@@ -466,6 +534,29 @@ @@ -566,6 +680,9 @@
+

PERFORMANCE ANALYSIS

+
+

TOP STRATAGEMS

@@ -577,10 +694,11 @@ +
- + diff --git a/scripts/release-sync.cjs b/scripts/release-sync.cjs new file mode 100755 index 0000000..a2e2d21 --- /dev/null +++ b/scripts/release-sync.cjs @@ -0,0 +1,57 @@ +#!/usr/bin/env node +const fs = require('fs'); +const path = require('path'); + +const repoRoot = process.cwd(); +const pkgPath = path.join(repoRoot, 'package.json'); +const publicDir = path.join(repoRoot, 'public'); +if (!fs.existsSync(pkgPath) || !fs.existsSync(publicDir)) process.exit(0); + +const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8')); +const version = pkg.version; +if (!version) { + console.error('package.json version missing'); + process.exit(1); +} + +function walkHtmlFiles(dir) { + const out = []; + for (const entry of fs.readdirSync(dir, { withFileTypes: true })) { + const full = path.join(dir, entry.name); + if (entry.isDirectory()) out.push(...walkHtmlFiles(full)); + else if (entry.isFile() && entry.name.endsWith('.html')) out.push(full); + } + return out; +} + +function isLocalAsset(rawUrl) { + return !/^(?:[a-z]+:|\/\/|#)/i.test(rawUrl); +} + +function withVersion(rawUrl) { + const [baseWithQuery, hash = ''] = rawUrl.split('#'); + const [pathname, query = ''] = baseWithQuery.split('?'); + const params = new URLSearchParams(query); + params.set('v', version); + const qs = params.toString(); + return pathname + (qs ? '?' + qs : '') + (hash ? '#' + hash : ''); +} + +const htmlFiles = walkHtmlFiles(publicDir); +let changed = 0; +for (const file of htmlFiles) { + let content = fs.readFileSync(file, 'utf8'); + const next = content + .replace(/(]*href=["'])([^"']+\.css(?:\?[^"']*)?)(["'][^>]*>)/gi, (m, p1, url, p3) => { + return isLocalAsset(url) ? p1 + withVersion(url) + p3 : m; + }) + .replace(/(]*type=["']application\/json["'])[^>]*\bsrc=["'])([^"']+\.js(?:\?[^"']*)?)(["'][^>]*>\s*<\/script>)/gi, (m, p1, url, p3) => { + return isLocalAsset(url) ? p1 + withVersion(url) + p3 : m; + }); + if (next !== content) { + fs.writeFileSync(file, next); + changed += 1; + } +} + +if (changed > 0) console.log('Synced versioned assets in ' + changed + ' HTML file(s).'); diff --git a/scripts/release-verify.cjs b/scripts/release-verify.cjs new file mode 100755 index 0000000..e8117ed --- /dev/null +++ b/scripts/release-verify.cjs @@ -0,0 +1,73 @@ +#!/usr/bin/env node +const fs = require('fs'); +const path = require('path'); +const cp = require('child_process'); + +const repoRoot = process.cwd(); +const pkgPath = path.join(repoRoot, 'package.json'); +const publicDir = path.join(repoRoot, 'public'); +if (!fs.existsSync(pkgPath) || !fs.existsSync(publicDir)) process.exit(0); + +const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8')); +const version = pkg.version; +const failures = []; + +function git(args) { + return cp.execFileSync('git', args, { cwd: repoRoot, encoding: 'utf8' }).trim(); +} + +function walkHtmlFiles(dir) { + const out = []; + for (const entry of fs.readdirSync(dir, { withFileTypes: true })) { + const full = path.join(dir, entry.name); + if (entry.isDirectory()) out.push(...walkHtmlFiles(full)); + else if (entry.isFile() && entry.name.endsWith('.html')) out.push(full); + } + return out; +} + +function isLocalAsset(rawUrl) { + return !/^(?:[a-z]+:|\/\/|#)/i.test(rawUrl); +} + +for (const file of walkHtmlFiles(publicDir)) { + const rel = path.relative(repoRoot, file); + const content = fs.readFileSync(file, 'utf8'); + for (const match of content.matchAll(/]*href=["']([^"']+\.css(?:\?[^"']*)?)["']/gi)) { + const url = match[1]; + if (isLocalAsset(url) && !new URLSearchParams((url.split('?')[1] || '')).get('v')?.includes(version)) { + failures.push(rel + ': stylesheet version does not match package.json'); + } + } + for (const match of content.matchAll(/]*type=["']application\/json["'])[^>]*\bsrc=["']([^"']+\.js(?:\?[^"']*)?)["']/gi)) { + const url = match[1]; + if (isLocalAsset(url) && !new URLSearchParams((url.split('?')[1] || '')).get('v')?.includes(version)) { + failures.push(rel + ': script version does not match package.json'); + } + } +} + +const staged = git(['diff', '--cached', '--name-only', '--diff-filter=ACMR']).split(/\n+/).filter(Boolean); +const codeTouched = staged.some(file => /^(public\/.*\.(html|css|js)|server\.js|package\.json|package-lock\.json)$/.test(file)); +const projectMapTouched = staged.includes('PROJECT_MAP.md'); +const changelogTouched = staged.includes('CHANGELOG.md'); +if (codeTouched && !changelogTouched) failures.push('CHANGELOG.md must be staged when app code, assets, or version files change.'); +if (codeTouched && fs.existsSync(path.join(repoRoot, 'PROJECT_MAP.md')) && !projectMapTouched) { + failures.push('PROJECT_MAP.md must be staged when app code or frontend state/routes change.'); +} + +const stagedPackageDiff = staged.includes('package.json') + ? git(['diff', '--cached', '--', 'package.json']) + : ''; +if (stagedPackageDiff.includes('"version"') && fs.existsSync(path.join(repoRoot, 'CHANGELOG.md'))) { + const changelog = fs.readFileSync(path.join(repoRoot, 'CHANGELOG.md'), 'utf8'); + if (!changelog.includes('## [' + version + ']') && !changelog.includes('## [Unreleased]')) { + failures.push('CHANGELOG.md must mention the current package.json version or contain an [Unreleased] section.'); + } +} + +if (failures.length) { + console.error('Release verification failed:'); + for (const failure of failures) console.error('- ' + failure); + process.exit(1); +}