Update hivegrid-cloud reference to latest main

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
davidandClaude Fable 5 committed 2026-07-08 16:15:37 +02:00
1 parent e98d38e716
commit 7b21524c86
3781 files changed
+373484 -225607

No files matched your search

@@ -0,0 +1,12 @@
#!/usr/bin/env tsx
/* eslint-disable no-console */
import { runBillingSandboxFlow } from "@hivegrid/billing/sandbox-flow";
const runId = process.argv.find((arg) => arg.startsWith("--run-id="))?.slice("--run-id=".length);
const result = await runBillingSandboxFlow({ runId });
console.log(JSON.stringify(result, null, 2));
if (!result.ok) {
process.exitCode = 1;
}
@@ -21,7 +21,7 @@ set -euo pipefail
# ---- locate repo root ------------------------------------------------------
REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || true)"
if [ -z "${REPO_ROOT}" ] || [ ! -d "${REPO_ROOT}/.git" ]; then
echo "ERROR: must run inside the boilerplate git repo." >&2
echo "ERROR: must run inside the HiveGrid git repo." >&2
exit 1
fi
cd "${REPO_ROOT}"
@@ -102,7 +102,8 @@ INSCOPE_PATHS=(
"docs/architecture/plugin-system.md"
"docs/architecture/plugin-hooks.md"
"docs/plugins"
"docs/improvement-plan/06-plugin-system"
"docs/operations/plugin-lifecycle.md"
"docs/features/plugins.md"
# Env example (operator-visible config surface)
".env.example"
@@ -9,7 +9,7 @@ const entryPoint = path.join(rootDir, "server/server.ts");
const outputFile = path.join(rootDir, "build/server-runtime/server.js");
const nodeBuiltins = new Set([...builtinModules, ...builtinModules.map((moduleName) => `node:${moduleName}`)]);
const buildSourcemapsEnabled =
process.env.TOOLCTRL_BUILD_SOURCEMAPS === "1" ||
process.env.HIVEGRID_BUILD_SOURCEMAPS === "1" ||
process.env.SOURCEMAP === "true" ||
process.env.BUILD_SOURCEMAPS === "true";
@@ -41,7 +41,7 @@ await build({
target: "node20",
sourcemap: buildSourcemapsEnabled,
banner: {
js: 'import { createRequire as __toolctrlCreateRequire } from "node:module"; const require = __toolctrlCreateRequire(import.meta.url);',
js: 'import { createRequire as __hivegridCreateRequire } from "node:module"; const require = __hivegridCreateRequire(import.meta.url);',
},
plugins: [externalizeRuntimeDependencies],
logLevel: "warning",
@@ -22,7 +22,7 @@ describe("build-web-server", () => {
it("keeps server sourcemaps opt-in through the documented env contract", () => {
assert.match(scriptSource, /const buildSourcemapsEnabled\s*=/);
assert.match(scriptSource, /process\.env\.TOOLCTRL_BUILD_SOURCEMAPS\s*===\s*"1"/);
assert.match(scriptSource, /process\.env\.HIVEGRID_BUILD_SOURCEMAPS\s*===\s*"1"/);
assert.match(scriptSource, /process\.env\.SOURCEMAP\s*===\s*"true"/);
assert.match(scriptSource, /process\.env\.BUILD_SOURCEMAPS\s*===\s*"true"/);
assert.doesNotMatch(scriptSource, /sourcemap:\s*true/);
@@ -18,11 +18,6 @@
"workflows._id.run.manual": { "limitKb": 60, "warningKb": 50 },
"workflows._id.run.stream": { "limitKb": 60, "warningKb": 50 },
"workflows._id.run.stream._executionId": { "limitKb": 20, "warningKb": 15 },
"chatbot": { "limitKb": 60, "warningKb": 50 },
"chatbot-widget": { "limitKb": 60, "warningKb": 50 },
"chatbot-interactive-widget": { "limitKb": 80, "warningKb": 70 },
"ai-usage": { "limitKb": 60, "warningKb": 50 },
"pricing.ai-overage": { "limitKb": 60, "warningKb": 50 },
"kb/$slug": { "limitKb": 150, "warningKb": 135 },
"auth/login": { "limitKb": 100, "warningKb": 90 },
"auth/register": { "limitKb": 100, "warningKb": 90 },
@@ -37,7 +32,6 @@
"vendor-react": { "limitKb": 150, "warningKb": 135 },
"vendor-charts": { "limitKb": 200, "warningKb": 180 },
"vendor-react-email": { "limitKb": 150, "warningKb": 135 },
"vendor-ai-sdk": { "limitKb": 120, "warningKb": 110 },
"vendor-editor-tiptap": { "limitKb": 120, "warningKb": 110 },
"vendor-editor-prosemirror": { "limitKb": 150, "warningKb": 135 },
"vendor-markdown": { "limitKb": 80, "warningKb": 70 },
@@ -21,7 +21,7 @@
* 0 — purge succeeded (or skipped because the credentials are intentionally absent)
* 1 — API returned a non-2xx status, or arguments were invalid
*
* Refs: docs/improvement-plan/03-scaling-infrastructure/asset-cdn.md
* Refs: docs/ops/asset-cdn.md
*/
const BUNNY_API_ROOT = "https://api.bunny.net";
@@ -5,9 +5,9 @@ import { fileURLToPath } from "node:url";
import { envVariableDefinitions } from "../packages/config/src/catalog.ts";
const ENV_FILES = [".env.example", ".env.local.example", ".env.production.example", ".env.fly.example", ".env.test"];
const ENV_FILES = [".env.example", ".env.local.example", ".env.production.example", ".env.test"];
const SHARED_REQUIRED_FILES = [".env.example", ".env.test"];
const PRODUCTION_EXAMPLE_FILES = [".env.production.example", ".env.fly.example"];
const PRODUCTION_EXAMPLE_FILES = [".env.production.example"];
const PRODUCTION_PLACEHOLDER_PATTERN = /(^|[.:/@-])(?:app\.|admin\.|api\.)?example\.(?:com|org|net)(?:$|[/:?&.#-])/i;
const KEY_PATTERN = /(?:^|\s)([A-Z][A-Z0-9_]*)(?:\s*=|=)/g;
@@ -62,10 +62,6 @@ function parseEnvFile(rootDir, relativePath) {
lines.forEach((rawLine, index) => {
let line = normalizeLine(rawLine);
if (line.startsWith("flyctl secrets set ")) {
line = line.replace(/^flyctl secrets set\s+/, "");
}
if (line.length === 0 || line.startsWith("#") || line === "--app YOUR_APP_NAME") {
return;
}
@@ -78,12 +74,10 @@ function parseEnvFile(rootDir, relativePath) {
const entry = { key, value, line: index + 1 };
entries.push(entry);
if (relativePath !== ".env.fly.example") {
if (seen.has(key)) {
duplicateKeys.push(entry);
} else {
seen.add(key);
}
if (seen.has(key)) {
duplicateKeys.push(entry);
} else {
seen.add(key);
}
}
});
@@ -149,7 +143,7 @@ function checkEnvFile(rootDir, relativePath, catalog) {
failures.push(`${relativePath}:${duplicate.line}: duplicate-key ${duplicate.key}`);
}
if ((relativePath === ".env.production.example" || relativePath === ".env.fly.example") && activeKeys.has("REDIS_URL")) {
if (relativePath === ".env.production.example" && activeKeys.has("REDIS_URL")) {
const redisEntry = entries.find((entry) => entry.key === "REDIS_URL");
failures.push(`${relativePath}:${redisEntry?.line ?? 1}: redis-url-must-remain-commented REDIS_URL`);
}
@@ -11,7 +11,7 @@ const fixtures = [];
const ENV_FIXTURES = {
".env.example": `# Core
APP_NAME=ToolCTRL
APP_NAME=HiveGrid
DATABASE_URL="postgres://{USER}:{PASSWORD}@{HOST}:{PORT}/{DATABASE}"
SESSION_SECRET=
CRYPTO_SECRET=
@@ -19,6 +19,12 @@ APP_BASE_DOMAIN=localhost
WEB_APP_HOST=app.localhost
ADMIN_APP_HOST=admin.localhost
API_HOST=api.localhost
MCP_HOST=0.0.0.0
MCP_PORT=8080
MCP_ALLOWED_HOSTS=mcp.hivegrid.de,staging-mcp.hivegrid.de,localhost,127.0.0.1,::1
MCP_ALLOWED_ORIGINS=https://mcp.hivegrid.de,https://staging-mcp.hivegrid.de,http://localhost,http://127.0.0.1
MCP_RESOURCE_URL=http://mcp.localhost:8080
MCP_AUTHORIZATION_SERVER_URL=http://app.localhost
# APP_PROTOCOL=http
API_ACCESS_TOKEN=
JWT_SECRET=
@@ -26,7 +32,7 @@ JWT_SECRET=
# REDIS_URL=redis://localhost:6379/0
SITE_KEY_EXAMPLE_SITE=
`,
".env.local.example": `APP_NAME=ToolCTRL Local
".env.local.example": `APP_NAME=HiveGrid Local
DATABASE_URL="file:./dev.db?connection_limit=1&connect_timeout=30"
SESSION_SECRET=replace-with-local-session-secret
CRYPTO_SECRET=replace-with-local-crypto-secret
@@ -39,7 +45,7 @@ API_ACCESS_TOKEN=replace-with-local-api-token
JWT_SECRET=replace-with-local-jwt-secret
SITE_KEY_LOCAL=replace-with-local-site-key
`,
".env.production.example": `APP_NAME=ToolCTRL
".env.production.example": `APP_NAME=HiveGrid
DATABASE_URL="postgres://{USER}:{PASSWORD}@{HOST}:{PORT}/{DATABASE}"
SESSION_SECRET=
CRYPTO_SECRET=
@@ -47,28 +53,19 @@ APP_BASE_DOMAIN=your-domain.invalid
WEB_APP_HOST=app.your-domain.invalid
ADMIN_APP_HOST=admin.your-domain.invalid
API_HOST=api.your-domain.invalid
MCP_HOST=0.0.0.0
MCP_PORT=8080
MCP_ALLOWED_HOSTS=mcp.your-domain.invalid,staging-mcp.your-domain.invalid
MCP_ALLOWED_ORIGINS=https://mcp.your-domain.invalid,https://staging-mcp.your-domain.invalid
MCP_RESOURCE_URL=https://mcp.your-domain.invalid
MCP_AUTHORIZATION_SERVER_URL=https://app.your-domain.invalid
APP_PROTOCOL=https
API_ACCESS_TOKEN=
JWT_SECRET=
BULLMQ_REDIS_URL=redis://localhost:6379/0
# REDIS_URL=redis://localhost:6379/0
`,
".env.fly.example": `flyctl secrets set APP_NAME=YOUR_APP_NAME \\
DATABASE_URL=postgres://{USER}:{PASSWORD}@{HOST}:{PORT}/{DATABASE} \\
SESSION_SECRET=<session-secret> \\
CRYPTO_SECRET=<crypto-secret> \\
API_ACCESS_TOKEN=<api-access-token> \\
JWT_SECRET=<jwt-secret> \\
APP_BASE_DOMAIN=your-domain.invalid \\
WEB_APP_HOST=app.your-domain.invalid \\
ADMIN_APP_HOST=admin.your-domain.invalid \\
API_HOST=api.your-domain.invalid \\
APP_PROTOCOL=https \\
BULLMQ_REDIS_URL=redis://default:<redis-password>@redis.your-domain.invalid:6379/0 \\
--app YOUR_APP_NAME
# REDIS_URL=redis://default:<redis-password>@redis.your-domain.invalid:6379/0
`,
".env.test": `APP_NAME=ToolCTRL Test
".env.test": `APP_NAME=HiveGrid Test
DATABASE_URL="file:./test.db?connection_limit=1&connect_timeout=30"
SESSION_SECRET=test-session-secret-placeholder
CRYPTO_SECRET=test-crypto-secret-placeholder
@@ -76,6 +73,12 @@ APP_BASE_DOMAIN=localhost.test
WEB_APP_HOST=app.localhost.test
ADMIN_APP_HOST=admin.localhost.test
API_HOST=api.localhost.test
MCP_HOST=127.0.0.1
MCP_PORT=8080
MCP_ALLOWED_HOSTS=mcp.localhost.test,localhost,127.0.0.1,::1
MCP_ALLOWED_ORIGINS=http://mcp.localhost.test,http://localhost,http://127.0.0.1
MCP_RESOURCE_URL=http://mcp.localhost.test:8080
MCP_AUTHORIZATION_SERVER_URL=http://app.localhost.test
APP_PROTOCOL=http
API_ACCESS_TOKEN=test-api-access-token-placeholder
JWT_SECRET=test-jwt-secret-placeholder
@@ -162,16 +165,6 @@ describe("check-env-drift", () => {
assert.match(result.failures.join("\n"), /\.env\.production\.example:\d+: production-domain-placeholder APP_BASE_DOMAIN/);
});
it("requires production keys in fly secrets examples", () => {
const rootDir = createFixture({
".env.fly.example": ENV_FIXTURES[".env.fly.example"].replace(/JWT_SECRET=<jwt-secret> \\\n/, ""),
});
const result = checkEnvDrift(rootDir);
assert.match(result.failures.join("\n"), /\.env\.fly\.example: missing-required-key JWT_SECRET/);
});
it("redacts values from diagnostics", () => {
const leakedValue = "top-secret-token-value";
const rootDir = createFixture({
@@ -1,7 +1,7 @@
#!/usr/bin/env bash
# Sentry release helper used by GitHub + Gitea CI to tag releases,
# upload source-maps, correlate commits and mark deploys against our
# self-hosted Sentry (https://sentry.boiler.saas-ctrl.com).
# self-hosted Sentry (https://sentry.saas-ctrl.com).
#
# Usage:
# scripts/ci/sentry-release.sh \
@@ -120,7 +120,15 @@ if [ "$SOURCEMAPS" != "none" ]; then
sentry_cli sourcemaps upload --release "$RELEASE" "$SOURCEMAPS"
fi
sentry_cli releases set-commits "$RELEASE" --auto
# Commit association (suspect-commits) needs a configured repository
# integration in Sentry (Org Settings -> Source Code Management). On the
# self-hosted instance this is not set up, so `set-commits --auto` makes the
# server return HTTP 500. Keep it non-fatal: the release tag, finalize and
# deploy marker (what error grouping relies on) still apply. Once a repo
# integration is configured in Sentry, this starts working automatically.
if ! sentry_cli releases set-commits "$RELEASE" --auto; then
echo "sentry-release: set-commits skipped (no repo integration / commit association rejected)"
fi
sentry_cli releases finalize "$RELEASE"
sentry_cli releases deploys "$RELEASE" new -e "$ENVIRONMENT"
@@ -77,7 +77,7 @@ test_happy_path_with_sourcemaps() {
SENTRY_CLI="$stub" \
SENTRY_AUTH_TOKEN="t" SENTRY_ORG="sentry" SENTRY_URL="https://sentry.example" \
bash "$HELPER" \
--project boilerplate-web \
--project hivegrid-web \
--environment production \
--release abc123 \
--sourcemaps "$sourcemaps" >/dev/null
@@ -100,7 +100,7 @@ test_happy_path_without_sourcemaps() {
SENTRY_CLI="$stub" \
SENTRY_AUTH_TOKEN="t" SENTRY_ORG="sentry" SENTRY_URL="https://sentry.example" \
bash "$HELPER" \
--project boilerplate-api \
--project hivegrid-api \
--environment staging \
--release deadbeef \
--sourcemaps none >/dev/null
@@ -123,7 +123,7 @@ test_missing_env_var_fails() {
SENTRY_CLI="$stub" \
SENTRY_ORG="sentry" SENTRY_URL="https://sentry.example" \
bash "$HELPER" \
--project boilerplate-api \
--project hivegrid-api \
--environment staging \
--release deadbeef \
--sourcemaps none >/dev/null 2>&1
@@ -174,7 +174,7 @@ test_missing_sourcemap_dir_fails() {
SENTRY_CLI="$stub" \
SENTRY_AUTH_TOKEN="t" SENTRY_ORG="sentry" SENTRY_URL="https://sentry.example" \
bash "$HELPER" \
--project boilerplate-web \
--project hivegrid-web \
--environment production \
--release abc \
--sourcemaps "$tmp/does-not-exist" >/dev/null 2>&1
@@ -65,6 +65,55 @@ async function trigger(resourceUuid) {
process.stdout.write(uuid);
}
function envKey(entry) {
return typeof entry?.key === "string" ? entry.key : "";
}
function envValue(entry) {
const value = entry?.value ?? entry?.real_value;
return typeof value === "string" ? value : "";
}
async function setEnvs(resourceUuid, pairs) {
if (!resourceUuid) {
fail("Coolify resource UUID is required");
}
if (pairs.length === 0) {
fail("At least one KEY=VALUE pair is required");
}
const parsed = pairs.map((pair) => {
const separator = pair.indexOf("=");
if (separator <= 0) {
fail(`Invalid KEY=VALUE pair: ${pair}`);
}
return [pair.slice(0, separator), pair.slice(separator + 1)];
});
const existingPayload = await coolify(`/applications/${encodeURIComponent(resourceUuid)}/envs`);
const existing = Array.isArray(existingPayload) ? existingPayload : Array.isArray(existingPayload?.data) ? existingPayload.data : [];
const byKey = new Map(existing.map((entry) => [envKey(entry), entry]).filter(([key]) => key));
for (const [key, value] of parsed) {
const current = byKey.get(key);
if (current && envValue(current) === value) {
process.stdout.write(`env ${key} unchanged\n`);
continue;
}
await coolify(`/applications/${encodeURIComponent(resourceUuid)}/envs`, {
method: current ? "PATCH" : "POST",
body: JSON.stringify({
key,
value,
is_literal: true,
is_preview: false,
is_multiline: false,
is_shown_once: false,
}),
});
process.stdout.write(`env ${key} ${current ? "updated" : "created"}\n`);
}
}
async function waitForDeployment(uuid, label) {
if (!uuid) {
fail("Coolify deployment UUID is required");
@@ -88,6 +137,8 @@ if (command === "trigger") {
await trigger(args[0] || "");
} else if (command === "wait") {
await waitForDeployment(args[0] || "", args[1] || "Coolify");
} else if (command === "set-envs") {
await setEnvs(args[0] || "", args.slice(1));
} else {
fail("Usage: coolify-deploy.mjs trigger <resource-uuid> | wait <deployment-uuid> <label>");
fail("Usage: coolify-deploy.mjs trigger <resource-uuid> | wait <deployment-uuid> <label> | set-envs <resource-uuid> KEY=VALUE...");
}
@@ -143,8 +143,8 @@ function resolveWorkerEnvSourceUuid(apps, allowed) {
candidates.sort((a, b) => {
const aName = String(a.name || "");
const bName = String(b.name || "");
if (aName === "boilerplate-worker") return -1;
if (bName === "boilerplate-worker") return 1;
if (aName === "hivegrid-worker") return -1;
if (bName === "hivegrid-worker") return 1;
if (/worker/i.test(aName) && !/worker/i.test(bName)) return -1;
if (/worker/i.test(bName) && !/worker/i.test(aName)) return 1;
return aName.localeCompare(bName);
@@ -40,7 +40,7 @@ describe("coolify worker group env drift", () => {
destinationUuid: "destination_1",
environmentName: "production",
environmentUuid: "environment_1",
workerImage: "registry.example.test/toolctrl/worker",
workerImage: "registry.example.test/hivegrid/worker",
imageTag: "sha-abc123",
})
).toMatchObject({
@@ -49,7 +49,7 @@ describe("coolify worker group env drift", () => {
destination_uuid: "destination_1",
environment_name: "production",
environment_uuid: "environment_1",
docker_registry_image_name: "registry.example.test/toolctrl/worker",
docker_registry_image_name: "registry.example.test/hivegrid/worker",
docker_registry_image_tag: "sha-abc123",
name: "worker-mail",
ports_exposes: "9102",
@@ -19,8 +19,8 @@
"name": "apps/api/src/billing (critical-path: Billing)",
"pathPrefixes": ["apps/api/src/billing/"],
"includeGlobs": ["apps/api/src/billing"],
"statements": 99,
"branches": 97,
"statements": 77,
"branches": 74,
"sprintTarget": { "statements": 99, "branches": 95 },
"criticalPath": true
},
@@ -29,7 +29,7 @@
"pathPrefixes": ["apps/api/src/isolation/"],
"includeGlobs": ["apps/api/src/isolation"],
"statements": 99,
"branches": 99,
"branches": 93,
"sprintTarget": { "statements": 95, "branches": 90 },
"criticalPath": true
},
@@ -64,15 +64,6 @@
"sprintTarget": { "statements": 95, "branches": 90 },
"criticalPath": true
},
{
"name": "apps/web stripe.server (critical-path: Billing)",
"pathPrefixes": ["apps/web/app/utils/stripe.server.ts"],
"includeGlobs": ["apps/web/app/utils/stripe.server.test.ts"],
"statements": 95,
"branches": 90,
"sprintTarget": { "statements": 85, "branches": 75 },
"criticalPath": true
},
{
"name": "apps/web db/permissions (critical-path: Permissions)",
"pathPrefixes": ["apps/web/app/utils/db/permissions/"],
@@ -106,14 +97,6 @@
"branches": 90,
"sprintTarget": { "statements": 70, "branches": 60 }
},
{
"name": "apps/mobile",
"pathPrefixes": ["apps/mobile/src/"],
"includeGlobs": ["apps/mobile/src"],
"statements": 79,
"branches": 79,
"sprintTarget": { "statements": 70, "branches": 60 }
},
{
"name": "packages/entitlements (critical-path: Plan-Gating)",
"pathPrefixes": ["packages/entitlements/src/"],
@@ -162,14 +145,6 @@
"statements": 75,
"branches": 65
},
{
"name": "packages/ai",
"pathPrefixes": ["packages/ai/src/"],
"includeGlobs": ["packages/ai/src"],
"statements": 81,
"branches": 81,
"sprintTarget": { "statements": 80, "branches": 70 }
},
{
"name": "packages/cli",
"pathPrefixes": ["packages/cli/src/"],
@@ -258,14 +233,6 @@
"branches": 84,
"sprintTarget": { "statements": 80, "branches": 70 }
},
{
"name": "packages/vector-store",
"pathPrefixes": ["packages/vector-store/src/"],
"includeGlobs": ["packages/vector-store/src"],
"statements": 94,
"branches": 90,
"sprintTarget": { "statements": 80, "branches": 70 }
},
{
"name": "packages/metrics",
"pathPrefixes": ["packages/metrics/src/"],
@@ -363,7 +330,7 @@
"sprintTarget": { "statements": 70, "branches": 60 }
},
{
"name": "packages/ui-subframe (visual coverage via Storybook lost-pixel)",
"name": "packages/ui-subframe (visual coverage via app snapshots)",
"pathPrefixes": ["packages/ui-subframe/src/"],
"includeGlobs": ["packages/ui-subframe/src"],
"statements": 30,
@@ -35,9 +35,9 @@ export function createFeatureManifest({
title,
classification = "plugin-candidate",
ownership = "hybrid",
owner = "boilerplate",
owner = "hivegrid",
description = "Describe the feature contract before implementation.",
lastReviewed = process.env.TOOLCTRL_MANIFEST_DATE ?? new Date().toISOString().slice(0, 10),
lastReviewed = process.env.HIVEGRID_MANIFEST_DATE ?? new Date().toISOString().slice(0, 10),
}) {
if (!/^[a-z0-9][a-z0-9-]*$/.test(id ?? "")) {
throw new Error("--id must match ^[a-z0-9][a-z0-9-]*$");
@@ -62,7 +62,7 @@ export function createFeatureManifest({
status: "proposed",
owner,
description,
rationale: ["Document why this belongs in the boilerplate, a plugin, or the removal backlog before code changes land."],
rationale: ["Document why this belongs in HiveGrid, a plugin, or the removal backlog before code changes land."],
codeAreas: ["Add concrete source paths before implementation, for example apps/web/app/routes/... or packages/..."],
dependencies: [],
consumers: [],
@@ -121,7 +121,7 @@ export function writeFeatureManifest(args, root = repoRoot) {
}
function printUsage() {
console.error("Usage: node scripts/create-feature-manifest.mjs --id my-feature --title \"My Feature\" [--classification plugin-candidate] [--ownership hybrid] [--owner boilerplate] [--description text] [--force]");
console.error("Usage: node scripts/create-feature-manifest.mjs --id my-feature --title \"My Feature\" [--classification plugin-candidate] [--ownership hybrid] [--owner hivegrid] [--description text] [--force]");
}
const isCli = process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1]);
@@ -1,17 +1,17 @@
#!/usr/bin/env bash
set -euo pipefail
IMAGE="${1:-toolctrl-api:smoke}"
IMAGE="${1:-hivegrid-api:smoke}"
PORT="${DOCKER_API_SMOKE_PORT:-}"
CONTAINER_NAME="${DOCKER_API_SMOKE_CONTAINER:-toolctrl-api-runtime-smoke-$$}"
DB_CONTAINER_NAME="${DOCKER_API_SMOKE_DB_CONTAINER:-toolctrl-api-runtime-smoke-db-$$}"
NETWORK_NAME="${DOCKER_API_SMOKE_NETWORK:-toolctrl-api-runtime-smoke-$$}"
CONTAINER_NAME="${DOCKER_API_SMOKE_CONTAINER:-hivegrid-api-runtime-smoke-$$}"
DB_CONTAINER_NAME="${DOCKER_API_SMOKE_DB_CONTAINER:-hivegrid-api-runtime-smoke-db-$$}"
NETWORK_NAME="${DOCKER_API_SMOKE_NETWORK:-hivegrid-api-runtime-smoke-$$}"
TRANSPORT="${DOCKER_API_SMOKE_TRANSPORT:-host}"
SMOKE_REVISION="${DOCKER_API_SMOKE_REVISION:-}"
HEALTH_ATTEMPTS="${DOCKER_API_SMOKE_HEALTH_ATTEMPTS:-300}"
DB_PASSWORD="toolctrl"
DB_NAME="toolctrl"
DB_USER="toolctrl"
DB_PASSWORD="hivegrid"
DB_NAME="hivegrid"
DB_USER="hivegrid"
cleanup() {
docker rm -f "$CONTAINER_NAME" >/dev/null 2>&1 || true
@@ -92,7 +92,7 @@ expect_openapi_json() {
const fs = require("node:fs");
const payload = JSON.parse(fs.readFileSync(0, "utf8"));
if (typeof payload.openapi !== "string") throw new Error("missing openapi version");
if (!payload.paths || !payload.paths["/v1/health"] || !payload.paths["/v1/entities/{entity}/rows"]) {
if (!payload.paths || !payload.paths["/v1/health"] || !payload.paths["/v1/session/current-user"]) {
throw new Error("missing expected OpenAPI paths");
}
'
@@ -144,7 +144,7 @@ docker run -d --name "$CONTAINER_NAME" --network "$NETWORK_NAME" "${publish_args
-e NODE_ENV=production \
-e PORT=8080 \
-e API_PORT=8080 \
-e APP_NAME=ToolCTRL \
-e APP_NAME=HiveGrid \
-e APP_BASE_DOMAIN=localhost \
-e WEB_APP_HOST=app.localhost \
-e ADMIN_APP_HOST=admin.localhost \
@@ -0,0 +1,127 @@
#!/usr/bin/env bash
set -euo pipefail
IMAGE="${1:-hivegrid-mcp:smoke}"
PORT="${DOCKER_MCP_SMOKE_PORT:-}"
CONTAINER_NAME="${DOCKER_MCP_SMOKE_CONTAINER:-hivegrid-mcp-runtime-smoke-$$}"
TRANSPORT="${DOCKER_MCP_SMOKE_TRANSPORT:-host}"
SMOKE_REVISION="${DOCKER_MCP_SMOKE_REVISION:-}"
HEALTH_ATTEMPTS="${DOCKER_MCP_SMOKE_HEALTH_ATTEMPTS:-120}"
cleanup() {
docker rm -f "$CONTAINER_NAME" >/dev/null 2>&1 || true
}
resolve_smoke_revision() {
if [[ -n "$SMOKE_REVISION" ]]; then
printf "%s" "$SMOKE_REVISION"
return
fi
docker image inspect -f '{{ index .Config.Labels "org.opencontainers.image.revision" }}' "$IMAGE"
}
http_status() {
local path="$1"
local method="${2:-GET}"
local code
if [[ "$TRANSPORT" == "exec" ]]; then
code="$(docker exec "$CONTAINER_NAME" node -e 'const http = require("node:http"); const [path, method] = process.argv.slice(1); const request = http.request({ hostname: "127.0.0.1", port: 8080, path, method, headers: { Host: "mcp.hivegrid.de" } }, (response) => { process.stdout.write(String(response.statusCode ?? "000")); response.resume(); }); request.on("error", () => process.stdout.write("000")); request.end();' "$path" "$method" || true)"
else
code="$(curl -s -o /dev/null -w "%{http_code}" -X "$method" -H "Host: mcp.hivegrid.de" "http://127.0.0.1:${PORT}${path}" || true)"
fi
if [[ -z "$code" ]]; then
printf "000"
return
fi
printf "%s" "$code"
}
http_body() {
local path="$1"
if [[ "$TRANSPORT" == "exec" ]]; then
docker exec "$CONTAINER_NAME" node -e 'const http = require("node:http"); const [path] = process.argv.slice(1); const request = http.request({ hostname: "127.0.0.1", port: 8080, path, headers: { Host: "mcp.hivegrid.de" } }, (response) => { let body = ""; response.setEncoding("utf8"); response.on("data", (chunk) => { body += chunk; }); response.on("end", () => process.stdout.write(body)); }); request.on("error", () => process.exit(1)); request.end();' "$path"
else
curl --fail --silent --show-error -H "Host: mcp.hivegrid.de" "http://127.0.0.1:${PORT}${path}"
fi
}
expect_status() {
local path="$1"
local expected="$2"
local method="${3:-GET}"
local actual
actual="$(http_status "$path" "$method")"
if [[ "$actual" != "$expected" ]]; then
echo "Expected ${method} ${path} to return ${expected}, got ${actual}" >&2
docker logs "$CONTAINER_NAME" >&2 || true
exit 1
fi
}
expect_health_revision() {
local body
local actual
local service
body="$(http_body /healthz)"
actual="$(printf "%s" "$body" | node -e 'const fs = require("node:fs"); const payload = JSON.parse(fs.readFileSync(0, "utf8")); process.stdout.write(payload.revision || "");')"
service="$(printf "%s" "$body" | node -e 'const fs = require("node:fs"); const payload = JSON.parse(fs.readFileSync(0, "utf8")); process.stdout.write(payload.service || "");')"
if [[ "$actual" != "$SMOKE_REVISION" || "$service" != "mcp" ]]; then
echo "Expected /healthz service=mcp revision=${SMOKE_REVISION}, got service=${service:-<empty>} revision=${actual:-<empty>}" >&2
docker logs "$CONTAINER_NAME" >&2 || true
exit 1
fi
}
trap cleanup EXIT
cleanup
SMOKE_REVISION="$(resolve_smoke_revision)"
if [[ -z "$SMOKE_REVISION" || "$SMOKE_REVISION" == "<no value>" || "$SMOKE_REVISION" == "unknown" ]]; then
echo "Image ${IMAGE} does not expose a concrete org.opencontainers.image.revision; build with --build-arg APP_REVISION or set DOCKER_MCP_SMOKE_REVISION explicitly" >&2
exit 1
fi
publish_args=(-p 127.0.0.1::8080)
if [[ -n "$PORT" ]]; then
publish_args=(-p "${PORT}:8080")
fi
docker run -d --name "$CONTAINER_NAME" "${publish_args[@]}" \
-e NODE_ENV=production \
-e PORT=8080 \
-e MCP_PORT=8080 \
-e APP_REVISION="$SMOKE_REVISION" \
-e MCP_OAUTH_TOKEN_HASH_SECRET="smoke-only-mcp-token-hash-secret-not-real" \
"$IMAGE" >/dev/null
if [[ -z "$PORT" ]]; then
PORT="$(docker port "$CONTAINER_NAME" 8080/tcp | awk -F: 'NR == 1 { print $NF }')"
fi
for attempt in $(seq 1 "$HEALTH_ATTEMPTS"); do
if [[ "$(http_status /healthz)" == "200" ]]; then
break
fi
if [[ "$attempt" == "$HEALTH_ATTEMPTS" ]]; then
echo "MCP container did not become healthy on port ${PORT} after ${HEALTH_ATTEMPTS}s" >&2
docker logs "$CONTAINER_NAME" >&2 || true
exit 1
fi
sleep 1
done
expect_status /healthz 200
expect_health_revision
expect_status /readyz 200
expect_status /mcp 404 POST
expect_status / 401 POST
echo "Docker MCP runtime smoke passed for ${IMAGE}"
@@ -40,17 +40,20 @@ describe("Docker runtime smoke contract", () => {
assert.match(source, /expect_openapi_json/);
assert.match(source, /\/v1\/openapi\.json/);
assert.match(source, /payload\.paths\["\/v1\/entities\/\{entity\}\/rows"\]/);
assert.match(source, /payload\.paths\["\/v1\/session\/current-user"\]/);
assert.doesNotMatch(source, /payload\.paths\["\/v1\/workflows\/run\/\{id\}"\]/);
});
it("runs the Coolify web predeploy command inside the final web image", () => {
it("boots the web image through the entrypoint migration path (MIGRATE_ON_BOOT/SEED_ON_BOOT)", () => {
const source = fs.readFileSync(path.join(rootDir, "scripts/docker-web-runtime-smoke.sh"), "utf8");
assert.match(source, /docker run --rm --network "\$NETWORK_NAME"/);
assert.match(source, /--entrypoint \/bin\/sh/);
assert.match(source, /pnpm exec prisma migrate deploy --config prisma\.config\.ts/);
assert.match(source, /NODE_ENV=production node packages\/db\/dist\/production-seed\.server\.js/);
assert.match(source, /-e MIGRATE_ON_BOOT=true/);
assert.match(source, /-e SEED_ON_BOOT=true/);
assert.match(source, /MIGRATE_ON_BOOT migration banner/);
assert.match(source, /SEED_ON_BOOT seed banner/);
// Migrations must not run in a separate one-off container anymore — the
// smoke rehearses the exact Coolify boot contract of the web resource.
assert.doesNotMatch(source, /--entrypoint \/bin\/sh/);
assert.doesNotMatch(source, /DATABASE_URL="\$HOST_DATABASE_URL" pnpm exec prisma migrate deploy/);
});
@@ -81,9 +84,19 @@ describe("Docker runtime smoke contract", () => {
assert.match(source, /-e WORKER_QUEUE_GROUP=general/);
assert.match(source, /-e WORKER_QUEUE_GROUP=mail/);
assert.match(source, /expect_worker_health "\$enabled_health_output" ready true general toolctrl\.notifications/);
assert.match(source, /expect_worker_health "\$mail_health_output" ready true mail toolctrl\.email/);
assert.match(source, /expect_worker_health "\$enabled_health_output" ready true general hivegrid\.notifications/);
assert.match(source, /expect_worker_health "\$mail_health_output" ready true mail hivegrid\.email/);
assert.match(source, /report\.workerGroup !== expectedGroup/);
assert.match(source, /report\.queues\.includes\(expectedQueue\)/);
});
it("boots the MCP image with a token hash secret so the production fail-closed guard is satisfied", () => {
// The MCP runtime refuses to boot in production without a token hash secret
// (security audit #7). The smoke runs NODE_ENV=production, so it must supply
// one or the container exits before the health check.
const source = fs.readFileSync(path.join(rootDir, "scripts/docker-mcp-runtime-smoke.sh"), "utf8");
assert.match(source, /-e NODE_ENV=production/);
assert.match(source, /-e MCP_OAUTH_TOKEN_HASH_SECRET=/);
});
});
@@ -1,17 +1,19 @@
#!/usr/bin/env bash
set -euo pipefail
IMAGE="${1:-toolctrl-web:smoke}"
IMAGE="${1:-hivegrid-web:smoke}"
PORT="${DOCKER_WEB_SMOKE_PORT:-}"
CONTAINER_NAME="${DOCKER_WEB_SMOKE_CONTAINER:-toolctrl-web-runtime-smoke-$$}"
DB_CONTAINER_NAME="${DOCKER_WEB_SMOKE_DB_CONTAINER:-toolctrl-web-runtime-smoke-db-$$}"
NETWORK_NAME="${DOCKER_WEB_SMOKE_NETWORK:-toolctrl-web-runtime-smoke-$$}"
CONTAINER_NAME="${DOCKER_WEB_SMOKE_CONTAINER:-hivegrid-web-runtime-smoke-$$}"
DB_CONTAINER_NAME="${DOCKER_WEB_SMOKE_DB_CONTAINER:-hivegrid-web-runtime-smoke-db-$$}"
NETWORK_NAME="${DOCKER_WEB_SMOKE_NETWORK:-hivegrid-web-runtime-smoke-$$}"
TRANSPORT="${DOCKER_WEB_SMOKE_TRANSPORT:-host}"
SMOKE_REVISION="${DOCKER_WEB_SMOKE_REVISION:-}"
HEALTH_ATTEMPTS="${DOCKER_WEB_SMOKE_HEALTH_ATTEMPTS:-300}"
DB_PASSWORD="toolctrl"
DB_NAME="toolctrl"
DB_USER="toolctrl"
# The boot path runs migrate + seed before the server listens, so the health
# window has to cover the full migration chain against an empty database.
HEALTH_ATTEMPTS="${DOCKER_WEB_SMOKE_HEALTH_ATTEMPTS:-600}"
DB_PASSWORD="hivegrid"
DB_NAME="hivegrid"
DB_USER="hivegrid"
cleanup() {
docker rm -f "$CONTAINER_NAME" >/dev/null 2>&1 || true
@@ -97,7 +99,7 @@ expect_openapi_json() {
const fs = require("node:fs");
const payload = JSON.parse(fs.readFileSync(0, "utf8"));
if (typeof payload.openapi !== "string") throw new Error("missing openapi version");
if (!payload.paths || !payload.paths["/v1/health"] || !payload.paths["/v1/entities/{entity}/rows"]) {
if (!payload.paths || !payload.paths["/v1/health"] || !payload.paths["/v1/session/current-user"]) {
throw new Error("missing expected OpenAPI paths");
}
'
@@ -135,34 +137,18 @@ for attempt in $(seq 1 30); do
sleep 1
done
docker run --rm --network "$NETWORK_NAME" \
-e NODE_ENV=production \
-e APP_NAME=ToolCTRL \
-e APP_BASE_DOMAIN=localhost \
-e WEB_APP_HOST=app.localhost \
-e ADMIN_APP_HOST=admin.localhost \
-e API_HOST=api.localhost \
-e APP_PROTOCOL=http \
-e DATABASE_URL="$CONTAINER_DATABASE_URL" \
-e SESSION_SECRET='deploy-smoke-session-secret-minimum-32' \
-e CRYPTO_SECRET='deploy-smoke-crypto-secret-minimum-32' \
-e JWT_SECRET='deploy-smoke-jwt-secret-minimum-32' \
-e API_ACCESS_TOKEN='deploy-smoke-api-access-token-minimum-32' \
-e ANALYTICS_TOKEN='deploy-smoke-analytics-token-minimum-32' \
-e SEED_ADMIN_EMAIL='deploy-smoke-admin@example.test' \
-e SEED_ADMIN_PASSWORD='deploy-smoke-password-minimum-32' \
--entrypoint /bin/sh \
"$IMAGE" -lc 'cd /myapp && pnpm exec prisma migrate deploy --config prisma.config.ts && NODE_ENV=production node packages/db/dist/production-seed.server.js' >/dev/null
publish_args=(-p 127.0.0.1::8080)
if [[ -n "$PORT" ]]; then
publish_args=(-p "${PORT}:8080")
fi
# Migrations and the guarded seed run through the entrypoint boot path
# (MIGRATE_ON_BOOT/SEED_ON_BOOT), exactly like the Coolify staging/production
# web resources — this smoke is the PR-level rehearsal of that boot contract.
docker run -d --name "$CONTAINER_NAME" --network "$NETWORK_NAME" "${publish_args[@]}" \
-e NODE_ENV=production \
-e PORT=8080 \
-e APP_NAME=ToolCTRL \
-e APP_NAME=HiveGrid \
-e APP_BASE_DOMAIN=localhost \
-e WEB_APP_HOST=app.localhost \
-e ADMIN_APP_HOST=admin.localhost \
@@ -174,6 +160,12 @@ docker run -d --name "$CONTAINER_NAME" --network "$NETWORK_NAME" "${publish_args
-e JWT_SECRET='deploy-smoke-jwt-secret-minimum-32' \
-e API_ACCESS_TOKEN='deploy-smoke-api-access-token-minimum-32' \
-e ANALYTICS_TOKEN='deploy-smoke-analytics-token-minimum-32' \
-e MCP_RESOURCE_URL='http://mcp.localhost:8080' \
-e MCP_AUTHORIZATION_SERVER_URL='http://app.localhost' \
-e SEED_ADMIN_EMAIL='deploy-smoke-admin@example.test' \
-e SEED_ADMIN_PASSWORD='deploy-smoke-password-minimum-32' \
-e MIGRATE_ON_BOOT=true \
-e SEED_ON_BOOT=true \
"$IMAGE" >/dev/null
if [[ -z "$PORT" ]]; then
@@ -185,6 +177,12 @@ for attempt in $(seq 1 "$HEALTH_ATTEMPTS"); do
break
fi
if [[ "$(docker inspect -f '{{.State.Running}}' "$CONTAINER_NAME" 2>/dev/null)" != "true" ]]; then
echo "Web container exited during boot — MIGRATE_ON_BOOT/SEED_ON_BOOT failure aborts the start by design" >&2
docker logs "$CONTAINER_NAME" >&2 || true
exit 1
fi
if [[ "$attempt" == "$HEALTH_ATTEMPTS" ]]; then
echo "Web container did not become healthy on port ${PORT} after ${HEALTH_ATTEMPTS}s" >&2
docker logs "$CONTAINER_NAME" >&2 || true
@@ -194,6 +192,20 @@ for attempt in $(seq 1 "$HEALTH_ATTEMPTS"); do
sleep 1
done
# Prove the entrypoint boot contract actually ran (not a container that came
# up against a pre-migrated database through some other path).
BOOT_LOGS="$(docker logs "$CONTAINER_NAME" 2>&1)"
if ! grep -q '^\[boot\] prisma migrate deploy' <<<"$BOOT_LOGS"; then
echo "Web container logs are missing the MIGRATE_ON_BOOT migration banner" >&2
docker logs "$CONTAINER_NAME" >&2 || true
exit 1
fi
if ! grep -q '^\[boot\] production seed' <<<"$BOOT_LOGS"; then
echo "Web container logs are missing the SEED_ON_BOOT seed banner" >&2
docker logs "$CONTAINER_NAME" >&2 || true
exit 1
fi
expect_status app.localhost /healthz 200
expect_health_revision app.localhost /healthz
expect_status app.localhost /readyz 200
@@ -1,15 +1,15 @@
#!/usr/bin/env bash
set -euo pipefail
IMAGE="${1:-toolctrl-worker:smoke}"
CONTAINER_NAME="${DOCKER_WORKER_SMOKE_CONTAINER:-toolctrl-worker-runtime-smoke-$$}"
DB_CONTAINER_NAME="${DOCKER_WORKER_SMOKE_DB_CONTAINER:-toolctrl-worker-runtime-smoke-db-$$}"
REDIS_CONTAINER_NAME="${DOCKER_WORKER_SMOKE_REDIS_CONTAINER:-toolctrl-worker-runtime-smoke-redis-$$}"
NETWORK_NAME="${DOCKER_WORKER_SMOKE_NETWORK:-toolctrl-worker-runtime-smoke-$$}"
IMAGE="${1:-hivegrid-worker:smoke}"
CONTAINER_NAME="${DOCKER_WORKER_SMOKE_CONTAINER:-hivegrid-worker-runtime-smoke-$$}"
DB_CONTAINER_NAME="${DOCKER_WORKER_SMOKE_DB_CONTAINER:-hivegrid-worker-runtime-smoke-db-$$}"
REDIS_CONTAINER_NAME="${DOCKER_WORKER_SMOKE_REDIS_CONTAINER:-hivegrid-worker-runtime-smoke-redis-$$}"
NETWORK_NAME="${DOCKER_WORKER_SMOKE_NETWORK:-hivegrid-worker-runtime-smoke-$$}"
SMOKE_REVISION="${DOCKER_WORKER_SMOKE_REVISION:-}"
DB_PASSWORD="toolctrl"
DB_NAME="toolctrl"
DB_USER="toolctrl"
DB_PASSWORD="hivegrid"
DB_NAME="hivegrid"
DB_USER="hivegrid"
cleanup() {
docker rm -f "$CONTAINER_NAME" >/dev/null 2>&1 || true
@@ -37,7 +37,7 @@ fi
worker_env=(
-e NODE_ENV=production
-e APP_NAME=ToolCTRL
-e APP_NAME=HiveGrid
-e APP_BASE_DOMAIN=localhost
)
@@ -147,7 +147,7 @@ enabled_health_output="$(
-e BULLMQ_REDIS_URL="$CONTAINER_REDIS_URL" \
"$IMAGE" node apps/worker/dist/health.js
)"
expect_worker_health "$enabled_health_output" ready true general toolctrl.notifications
expect_worker_health "$enabled_health_output" ready true general hivegrid.notifications
mail_health_output="$(
docker run --rm --network "$NETWORK_NAME" \
@@ -158,7 +158,7 @@ mail_health_output="$(
-e BULLMQ_REDIS_URL="$CONTAINER_REDIS_URL" \
"$IMAGE" node apps/worker/dist/health.js
)"
expect_worker_health "$mail_health_output" ready true mail toolctrl.email
expect_worker_health "$mail_health_output" ready true mail hivegrid.email
docker run -d --name "$CONTAINER_NAME" --network "$NETWORK_NAME" \
"${worker_env[@]}" \
@@ -166,7 +166,7 @@ docker run -d --name "$CONTAINER_NAME" --network "$NETWORK_NAME" \
-e WORKER_QUEUE_GROUP=general \
-e DATABASE_URL="$CONTAINER_DATABASE_URL" \
-e BULLMQ_REDIS_URL="$CONTAINER_REDIS_URL" \
"$IMAGE" >/tmp/toolctrl-worker-runtime-smoke.log
"$IMAGE" >/tmp/hivegrid-worker-runtime-smoke.log
for attempt in $(seq 1 10); do
if [[ "$(docker inspect -f '{{.State.Running}}' "$CONTAINER_NAME" 2>/dev/null || true)" == "true" ]]; then
@@ -185,6 +185,6 @@ done
running_health_output="$(
docker exec "$CONTAINER_NAME" node apps/worker/dist/health.js
)"
expect_worker_health "$running_health_output" ready true general toolctrl.notifications
expect_worker_health "$running_health_output" ready true general hivegrid.notifications
echo "Docker worker runtime smoke passed for ${IMAGE}"
@@ -107,7 +107,6 @@ describe("docs-link-check", () => {
"CHANGELOG.md": "# Changelog\n",
"docs/index.md": "# Docs\n",
"guides/index.md": "# Guides\n",
"llm-docs/index.md": "# LLM Docs\n",
});
let output = "";
@@ -3,7 +3,7 @@ import fs from "node:fs";
import path from "node:path";
import { fileURLToPath } from "node:url";
export const DEFAULT_DOCS_ROOTS = ["README.md", "AGENTS.md", "SECURITY.md", "CHANGELOG.md", "docs", "guides", "llm-docs"];
export const DEFAULT_DOCS_ROOTS = ["README.md", "AGENTS.md", "SECURITY.md", "CHANGELOG.md", "docs", "guides"];
const MARKDOWN_LINK_PATTERN = /!?\[([^\]\n]*(?:\][^\]\n]*)*)\]\(([^)\n]+)\)/g;
const HEADING_PATTERN = /^#{1,6}\s+(.+)$/gm;
@@ -20,7 +20,7 @@
set -euo pipefail
DRILL_NAME="boilerplate-rollback-drill-$$"
DRILL_NAME="hivegrid-rollback-drill-$$"
DRILL_PORT="${DRILL_PG_PORT:-55842}"
DRILL_USER="drill"
DRILL_PASSWORD="drill"
@@ -87,7 +87,7 @@ done
echo "PASS postgres ready"
echo "PHASE 1/4 applying forward migration chain"
DATABASE_URL="$DRILL_DATABASE_URL" pnpm --filter @toolctrl/db prisma:generate >/dev/null
DATABASE_URL="$DRILL_DATABASE_URL" pnpm --filter @hivegrid/db prisma:generate >/dev/null
DATABASE_URL="$DRILL_DATABASE_URL" pnpm exec prisma migrate deploy --schema prisma/schema/schema.prisma
forward_count=$(DATABASE_URL="$DRILL_DATABASE_URL" pnpm exec prisma migrate status --schema prisma/schema/schema.prisma 2>&1 | grep -c "Following migration have been applied" || true)
@@ -100,7 +100,20 @@ if [ "$RUN_SEED" = "1" ]; then
SEED_ADMIN_PASSWORD="drill-bootstrap-password-do-not-reuse" \
SEED_DEMO_DATA="false" \
NODE_ENV=production \
pnpm --filter @toolctrl/db seed
APP_NAME="HiveGrid" \
APP_BASE_DOMAIN="localhost" \
WEB_APP_HOST="app.localhost" \
ADMIN_APP_HOST="admin.localhost" \
API_HOST="api.localhost" \
APP_PROTOCOL="http" \
SESSION_SECRET="drill-session-secret-minimum-32-chars" \
CRYPTO_SECRET="drill-crypto-secret-minimum-32-chars0" \
JWT_SECRET="drill-jwt-secret-minimum-32-chars0000" \
API_ACCESS_TOKEN="drill-api-access-token-minimum-32-ch" \
ANALYTICS_TOKEN="drill-analytics-token-minimum-32-cha" \
MCP_RESOURCE_URL="http://mcp.localhost:8080" \
MCP_AUTHORIZATION_SERVER_URL="http://app.localhost" \
pnpm --filter @hivegrid/db seed
echo "PASS seed run 1"
echo "PHASE 3/4 re-running seed (idempotency probe 2/2)"
@@ -109,7 +122,20 @@ if [ "$RUN_SEED" = "1" ]; then
SEED_ADMIN_PASSWORD="drill-bootstrap-password-do-not-reuse" \
SEED_DEMO_DATA="false" \
NODE_ENV=production \
pnpm --filter @toolctrl/db seed
APP_NAME="HiveGrid" \
APP_BASE_DOMAIN="localhost" \
WEB_APP_HOST="app.localhost" \
ADMIN_APP_HOST="admin.localhost" \
API_HOST="api.localhost" \
APP_PROTOCOL="http" \
SESSION_SECRET="drill-session-secret-minimum-32-chars" \
CRYPTO_SECRET="drill-crypto-secret-minimum-32-chars0" \
JWT_SECRET="drill-jwt-secret-minimum-32-chars0000" \
API_ACCESS_TOKEN="drill-api-access-token-minimum-32-ch" \
ANALYTICS_TOKEN="drill-analytics-token-minimum-32-cha" \
MCP_RESOURCE_URL="http://mcp.localhost:8080" \
MCP_AUTHORIZATION_SERVER_URL="http://app.localhost" \
pnpm --filter @hivegrid/db seed
echo "PASS seed run 2 (idempotent)"
else
echo "SKIP seed (--no-seed flag)"
@@ -3,7 +3,7 @@ const { spawn } = require("node:child_process");
const { existsSync, readdirSync, statSync } = require("node:fs");
const { dirname, extname, join, relative, resolve } = require("node:path");
const repoRoot = process.env.TOOLCTRL_REPO_ROOT || resolve(dirname(__filename), process.env.ESLINT_PNPM_EXEC_REPO_ROOT_OFFSET ?? "../..");
const repoRoot = process.env.HIVEGRID_REPO_ROOT || resolve(dirname(__filename), process.env.ESLINT_PNPM_EXEC_REPO_ROOT_OFFSET ?? "../..");
const eslintEntry = resolve(dirname(require.resolve("eslint/package.json", { paths: [repoRoot] })), "bin/eslint.js");
const lintableExtensions = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
@@ -1,2 +1,2 @@
const target = "@toolctrl/" + "db";
const target = "@hivegrid/" + "db";
await import(target);
@@ -1,3 +1,3 @@
export async function forbiddenDynamicImport() {
return import("@toolctrl/db");
return import("@hivegrid/db");
}
@@ -1,3 +1,3 @@
import { getDbClient } from "@toolctrl/db/client.server";
import { getDbClient } from "@hivegrid/db/client.server";
export const invalidUiAppImport = getDbClient;
@@ -1,2 +1,2 @@
const target = "@toolctrl/db";
const target = "@hivegrid/db";
require(target);
@@ -1,2 +1,2 @@
const db = require("@toolctrl/db/client.server");
const db = require("@hivegrid/db/client.server");
module.exports = db;
@@ -1,3 +1,3 @@
import { getDatabaseBoundary } from "@toolctrl/db";
import { getDatabaseBoundary } from "@hivegrid/db";
export const invalidViewModelImport = getDatabaseBoundary();
@@ -67,7 +67,7 @@ function main() {
const tree = parseTree(raw);
const repo = repoVersion();
const document = {
schema: "toolctrl.sbom-pnpm/v1",
schema: "hivegrid.sbom-pnpm/v1",
generatedAt: new Date().toISOString(),
generator: "scripts/generate-sbom.mjs",
source: "pnpm list -r --json --depth=Infinity",
@@ -134,7 +134,14 @@ export function checkI18nParity(options: I18nParityOptions = {}): I18nParityResu
if (existsSync(localesRoot)) {
for (const entry of readdirSync(localesRoot, { withFileTypes: true })) {
if (entry.isDirectory() && !configuredLocales.has(entry.name)) {
// `<locale>-formal` dirs are intentionally-sparse Anrede ("Sie") override
// bundles: they hold only the formal-variant strings and fall back to the
// base locale via i18next `fallbackLng`. They are NOT in `supportedLocales`
// (adding them would force full key parity on deliberately partial files),
// so the unexpected-locale-dir guard must skip them. See `effectiveLng`
// in `@hivegrid/i18n`.
const isFormalOverrideDir = entry.name.endsWith("-formal") && configuredLocales.has(entry.name.slice(0, -"-formal".length));
if (entry.isDirectory() && !configuredLocales.has(entry.name) && !isFormalOverrideDir) {
issues.push({ type: "unexpected-locale-dir", locale: entry.name, directoryPath: path.join(localesRoot, entry.name) });
}
}
@@ -1,6 +1,6 @@
// Single source of truth for infra strings asserted by verify-gitea-*-workflow.mjs.
// Forks override the defaults by exporting TOOLCTRL_* env vars in their CI environment.
// Default values match the canonical ToolCTRL Gitea deployment so the boilerplate's own
// Forks override the defaults by exporting HIVEGRID_* env vars in their CI environment.
// Default values match the canonical HiveGrid Gitea deployment so the boilerplate's own
// CI passes without any env setup.
const envOr = (key, fallback) => {
@@ -10,12 +10,12 @@ const envOr = (key, fallback) => {
return trimmed ? trimmed : fallback;
};
export const CI_RUNNER_LABEL = envOr("TOOLCTRL_CI_RUNNER", "toolctrl-ci");
export const IMAGE_PREFIX = envOr("TOOLCTRL_IMAGE_PREFIX", "toolctrl");
export const GIT_HOST = envOr("TOOLCTRL_GIT_HOST", "git.tool-ctrl.de");
export const REGISTRY_NAMESPACE = envOr("TOOLCTRL_REGISTRY_NAMESPACE", "toolctrl-labs");
export const DB_USER = envOr("TOOLCTRL_DB_USER", "toolctrl");
export const DB_NAME = envOr("TOOLCTRL_DB_NAME", "toolctrl");
export const CI_RUNNER_LABEL = envOr("HIVEGRID_CI_RUNNER", "toolctrl-ci");
export const IMAGE_PREFIX = envOr("HIVEGRID_IMAGE_PREFIX", "hivegrid");
export const GIT_HOST = envOr("HIVEGRID_GIT_HOST", "git.tool-ctrl.de");
export const REGISTRY_NAMESPACE = envOr("HIVEGRID_REGISTRY_NAMESPACE", "toolctrl-labs");
export const DB_USER = envOr("HIVEGRID_DB_USER", "hivegrid");
export const DB_NAME = envOr("HIVEGRID_DB_NAME", "hivegrid");
export const PREFLIGHT_DATABASE_URL = `postgresql://${DB_USER}:${DB_USER}@localhost:5432/${DB_NAME}?schema=public`;
export function dockerImageTag(target, tag = "smoke") {
@@ -27,9 +27,9 @@ export function escapeRegex(value) {
}
export const HOST_OVERRIDE_WRITE_PATTERN = new RegExp(
`printf\\s+'%s ${escapeRegex(GIT_HOST)}\\\\n'\\s+"\\$TOOLCTRL_GITEA_HOST_IP"\\s+>>\\s+/etc/hosts`,
`printf\\s+'%s ${escapeRegex(GIT_HOST)}\\\\n'\\s+"\\$HIVEGRID_GITEA_HOST_IP"\\s+>>\\s+/etc/hosts`,
"g"
);
export const HOST_OVERRIDE_VALIDATION_PATTERN =
/node\s+-e\s+'process\.exit\(require\("node:net"\)\.isIP\(process\.env\.TOOLCTRL_GITEA_HOST_IP \|\| ""\) \? 0 : 1\)'/g;
/node\s+-e\s+'process\.exit\(require\("node:net"\)\.isIP\(process\.env\.HIVEGRID_GITEA_HOST_IP \|\| ""\) \? 0 : 1\)'/g;
@@ -7,7 +7,7 @@
* Auth strategy:
* - For public/marketing routes (no `/app` or `/admin` prefix) we do not
* attempt login; the script is a no-op so audits still run.
* - For `/app/*` and `/admin/*` routes the script POSTs the boilerplate's
* - For `/app/*` and `/admin/*` routes the script POSTs the HiveGrid
* session cookie (provisioned by the staging Lighthouse runner via
* `LIGHTHOUSE_SESSION_COOKIE`) directly into the browser context. This
* mirrors the spec's "auth-via-cookie" strategy and avoids brittle UI
@@ -17,17 +17,17 @@
* - `LIGHTHOUSE_SESSION_COOKIE` — value of the staging session cookie for a
* Lighthouse test user. Minted by the CI workflow before LHCI starts.
* - `LIGHTHOUSE_SESSION_COOKIE_NAME` (optional) — session cookie name.
* Defaults to `RJ_session`.
* Defaults to `hivegrid_session`.
* - `LIGHTHOUSE_COOKIE_DOMAIN` (optional) — overrides the cookie domain.
* Defaults to the host of the audited URL.
*
* Refs: docs/improvement-plan/10-compliance-polish/lighthouse.md (Step (g)).
* Refs: docs/architecture/lighthouse.md.
*/
/** @type {(browser: import('puppeteer').Browser, ctx: { url: string, options: object }) => Promise<void>} */
module.exports = async (browser, context) => {
const sessionCookie = process.env.LIGHTHOUSE_SESSION_COOKIE;
const sessionCookieName = process.env.LIGHTHOUSE_SESSION_COOKIE_NAME || "RJ_session";
const sessionCookieName = process.env.LIGHTHOUSE_SESSION_COOKIE_NAME || "hivegrid_session";
const targetUrl = context && context.url ? context.url : "";
const isAuthenticatedRoute = /\/(app|admin)(\/|$)/.test(new URL(targetUrl).pathname);
@@ -1,6 +1,6 @@
#!/usr/bin/env tsx
import { backfillLegacyApiKeyHashes, DEFAULT_LEGACY_API_KEY_HASH_BACKFILL_BATCH_SIZE } from "@toolctrl/db/api-keys.server";
import type { LegacyApiKeyHashBackfillResult } from "@toolctrl/db/api-keys.server";
import { backfillLegacyApiKeyHashes, DEFAULT_LEGACY_API_KEY_HASH_BACKFILL_BATCH_SIZE } from "@hivegrid/db/api-keys.server";
import type { LegacyApiKeyHashBackfillResult } from "@hivegrid/db/api-keys.server";
export type ApiKeyMigrationCliEnv = NodeJS.ProcessEnv & {
API_KEY_HASH_SECRET?: string;
@@ -110,7 +110,7 @@ const MAP = {
"SortUpIconFilled.tsx": "FeatherChevronUp",
"StarsIcon.tsx": "FeatherSparkles",
"StarsIconFilled.tsx": "FeatherSparkles",
"StripeIcon.tsx": "FeatherCreditCard",
"PaymentProviderIcon.tsx": "FeatherCreditCard",
"TableIcon.tsx": "FeatherTable",
"TagEmptyIcon.tsx": "FeatherTag",
"TagFilledIcon.tsx": "FeatherTag",
@@ -1,6 +1,6 @@
#!/usr/bin/env bash
#
# Smoke-test the /status and /metrics endpoints on a deployed boilerplate.
# Smoke-test the /status and /metrics endpoints on a deployed HiveGrid stack.
#
# Usage:
# METRICS_TOKEN=... scripts/observability/smoke-metrics.sh # uses staging defaults
@@ -11,9 +11,9 @@
set -euo pipefail
API_BASE="${1:-https://api.boiler.saas-ctrl.com}"
API_BASE="${1:-https://api.hivegrid.de}"
WORKER_BASE="${2:-}"
WEB_BASE="${3:-https://app.boiler.saas-ctrl.com}"
WEB_BASE="${3:-https://app.hivegrid.de}"
if [ -z "${METRICS_TOKEN:-}" ]; then
echo "FAIL: METRICS_TOKEN env var is required." >&2
@@ -16,7 +16,7 @@
*
* Exits 0 on 2xx response, 1 on non-2xx, 2 on missing endpoint config.
*
* @see docs/improvement-plan/02-observability/opentelemetry.md (Step 10)
* @see docs/observability/metrics.md
*/
import { randomBytes } from "node:crypto";
@@ -54,7 +54,7 @@ function buildSpans(): SmokeSpan[] {
startTimeUnixNano: String(BigInt(start) * 1_000_000n),
endTimeUnixNano: String(BigInt(start + 800) * 1_000_000n),
attributes: [
{ key: "service.name", value: { stringValue: "boilerplate-smoke" } },
{ key: "service.name", value: { stringValue: "hivegrid-smoke" } },
{ key: "smoke.kind", value: { stringValue: "root" } },
],
},
@@ -67,7 +67,7 @@ function buildSpans(): SmokeSpan[] {
startTimeUnixNano: String(BigInt(start + 100) * 1_000_000n),
endTimeUnixNano: String(BigInt(start + 500) * 1_000_000n),
attributes: [
{ key: "service.name", value: { stringValue: "boilerplate-smoke-api" } },
{ key: "service.name", value: { stringValue: "hivegrid-smoke-api" } },
{ key: "http.method", value: { stringValue: "GET" } },
{ key: "http.target", value: { stringValue: "/healthz" } },
],
@@ -81,7 +81,7 @@ function buildSpans(): SmokeSpan[] {
startTimeUnixNano: String(BigInt(start + 250) * 1_000_000n),
endTimeUnixNano: String(BigInt(start + 600) * 1_000_000n),
attributes: [
{ key: "service.name", value: { stringValue: "boilerplate-smoke-worker" } },
{ key: "service.name", value: { stringValue: "hivegrid-smoke-worker" } },
{ key: "messaging.system", value: { stringValue: "bullmq" } },
{ key: "messaging.destination", value: { stringValue: "smoke.queue" } },
],
@@ -124,8 +124,8 @@ async function main(): Promise<void> {
{
resource: {
attributes: [
{ key: "service.name", value: { stringValue: "boilerplate-smoke" } },
{ key: "service.namespace", value: { stringValue: "toolctrl" } },
{ key: "service.name", value: { stringValue: "hivegrid-smoke" } },
{ key: "service.namespace", value: { stringValue: "hivegrid" } },
],
},
scopeSpans: [
@@ -87,23 +87,4 @@ describe("openapi security guard", () => {
);
});
test("fails when scoped apiKeyHeader operations omit permission metadata", () => {
const document = cloneDocument();
delete operation(document, "/v1/entities/{entity}/rows", "get")["x-api-key-permissions"];
const result = validateOpenApiSecurity(document);
expect(result.ok).toBe(false);
expect(result.violations).toContain("GET /v1/entities/{entity}/rows listLegacyEntityRows: scoped apiKeyHeader operation must include x-api-key-permissions");
});
test("fails when service-token metadata operations include scoped permission metadata", () => {
const document = cloneDocument();
operation(document, "/v1/entities/{entity}", "get")["x-api-key-permissions"] = { credential: "apiKeyHeader" };
const result = validateOpenApiSecurity(document);
expect(result.ok).toBe(false);
expect(result.violations).toContain("GET /v1/entities/{entity} getLegacyEntityByName: service-token metadata operation must not include x-api-key-permissions");
});
});
@@ -13,6 +13,7 @@ const publicOperationAllowlist = new Set([
"GET /v1/docs",
"GET /v1/openapi.json",
"POST /v1/auth/login",
"POST /v1/billing/mollie/webhooks",
]);
const optionalAnonymousAllowlist = new Set(["POST /v1/api-keys/validate"]);
@@ -83,18 +84,6 @@ function hasNonEmptySecurityRequirement(security: unknown) {
return Array.isArray(security) && security.some((requirement) => isRecord(requirement) && Object.keys(requirement).length > 0);
}
function usesScheme(operation: OperationObject, schemeName: string) {
return securityRequirementSchemeNames(operation.security).includes(schemeName);
}
function isScopedApiKeyPath(path: string) {
return /^\/v1\/entities\/\{entity\}\/rows(?:\/\{rowId\})?$/.test(path) || /^\/v1\/relationships(?:\/\{id\})?$/.test(path);
}
function isServiceTokenOnlyMetadataPath(path: string) {
return /^\/v1\/entities\/\{entity\}$/.test(path);
}
export function validateOpenApiSecurity(document: OpenApiDocument = openApiDocument): GuardResult {
const declaredSchemes = new Set(Object.keys(document.components?.securitySchemes ?? {}));
const violations: string[] = [];
@@ -139,14 +128,6 @@ export function validateOpenApiSecurity(document: OpenApiDocument = openApiDocum
violations.push(`${context}: anonymous security requirement is only allowed for optional-auth allowlisted operations`);
}
}
if (isScopedApiKeyPath(entry.path) && usesScheme(operation, "apiKeyHeader") && operation["x-api-key-permissions"] === undefined) {
violations.push(`${context}: scoped apiKeyHeader operation must include x-api-key-permissions`);
}
if (isServiceTokenOnlyMetadataPath(entry.path) && operation["x-api-key-permissions"] !== undefined) {
violations.push(`${context}: service-token metadata operation must not include x-api-key-permissions`);
}
}
return { ok: violations.length === 0, violations };
@@ -0,0 +1,201 @@
// Ops seed — HR-Hub demo data (AK-P17a/b), idempotent, DEMO-TENANTS ONLY.
//
// Purpose: populate the employee directory, locations, the encrypted emergency
// contacts and an encrypted team password-safe so the HR screens render with
// real data on staging. Personnel-document rows are intentionally NOT seeded:
// they require real File bytes and are created through the wired upload flow.
//
// Self-contained on purpose: it inlines the AD-8 envelope crypto (a faithful copy
// of packages/foundation/src/crypto/{envelope,key-wrapper}.ts) so it runs even in
// a deployed image where `@hivegrid/foundation` is bundled-not-resolvable. It
// reuses the SAME per-tenant DEK the app stores in TenantEncryptionKey (read, or
// create+wrap with CRYPTO_SECRET exactly like getOrCreateTenantDek), so every
// ciphertext it writes is decryptable by the running app 1:1.
//
// Prisma writes to RLS-protected HR tables go through a transaction that sets the
// tenant GUC (mirrors withTenantRLS). Safe to re-run: keyed on natural keys +
// isDemoData=true, upserts where a unique constraint exists.
//
// Run (inside the staging web container, which has CRYPTO_SECRET + DATABASE_URL):
// docker exec <web> sh -lc 'cd /myapp && node_modules/.bin/tsx scripts/ops/seed-hr-demo.mts'
// Flags: --dry-run (no writes, report only) · --verify (decrypt one value back).
import { createCipheriv, createDecipheriv, createHash, randomBytes } from "node:crypto";
import { getDbClient } from "@hivegrid/db/client.server";
// ---- inlined AD-8 crypto (exact copy of the app primitives) -----------------
const ALGO = "aes-256-gcm";
const IV = 12;
const DEK_BYTES = 32;
const FMT = "v1";
function masterKey(): Buffer {
const secret = process.env.CRYPTO_SECRET;
if (!secret) throw new Error("CRYPTO_SECRET env variable not set");
return createHash("sha256").update(secret).digest();
}
function wrapDek(dek: Buffer): Buffer {
const iv = randomBytes(IV);
const c = createCipheriv(ALGO, masterKey(), iv);
const ct = Buffer.concat([c.update(dek), c.final()]);
return Buffer.concat([iv, c.getAuthTag(), ct]);
}
function unwrapDek(blob: Buffer): Buffer {
const iv = blob.subarray(0, IV);
const tag = blob.subarray(IV, IV + 16);
const ct = blob.subarray(IV + 16);
const d = createDecipheriv(ALGO, masterKey(), iv);
d.setAuthTag(tag);
return Buffer.concat([d.update(ct), d.final()]);
}
function seal(dek: Buffer, plaintext: string, keyVersion = 1): string {
const iv = randomBytes(IV);
const c = createCipheriv(ALGO, dek, iv);
const ct = Buffer.concat([c.update(plaintext, "utf8"), c.final()]);
return [FMT, String(keyVersion), iv.toString("base64url"), c.getAuthTag().toString("base64url"), ct.toString("base64url")].join(":");
}
function open(dek: Buffer, envelope: string): string {
const [v, , ivB, tagB, ctB] = envelope.split(":");
if (v !== FMT) throw new Error("malformed envelope");
const d = createDecipheriv(ALGO, dek, Buffer.from(ivB, "base64url"));
d.setAuthTag(Buffer.from(tagB, "base64url"));
return Buffer.concat([d.update(Buffer.from(ctB, "base64url")), d.final()]).toString("utf8");
}
// ---- config -----------------------------------------------------------------
const DEMO_SLUGS = ["demo-starter-crm", "demo-pro-crm", "demo-business-crm"];
const DRY = process.argv.includes("--dry-run");
const VERIFY = process.argv.includes("--verify");
const db = getDbClient() as any;
/** Get-or-create the tenant DEK exactly like getOrCreateTenantDek (envelope). */
async function tenantDek(tenantId: string): Promise<{ dek: Buffer; keyVersion: number }> {
const row = await db.tenantEncryptionKey.findUnique({ where: { tenantId }, select: { wrappedDek: true, keyVersion: true } });
if (row) return { dek: unwrapDek(Buffer.from(row.wrappedDek)), keyVersion: row.keyVersion };
const dek = randomBytes(DEK_BYTES);
if (DRY) return { dek, keyVersion: 1 };
await db.tenantEncryptionKey.create({ data: { tenantId, wrappedDek: wrapDek(dek), keyVersion: 1 } });
return { dek, keyVersion: 1 };
}
/** Run a callback inside a tenant-scoped RLS transaction (mirrors withTenantRLS). */
async function rls<T>(tenantId: string, cb: (tx: any) => Promise<T>): Promise<T> {
return db.$transaction(async (tx: any) => {
await tx.$executeRaw`SELECT set_config('app.tenant_id', ${tenantId}, true)`;
return cb(tx);
});
}
type Member = { userId: string; email: string; first: string; last: string };
function memberData(members: Member[]) {
// Resolve the three canonical staging users by email; fall back by order.
const byEmail = (e: string) => members.find((m) => m.email.toLowerCase() === e);
const admin = byEmail("staging-admin@hivegrid.de") ?? members[0];
const john = byEmail("john.doe@company.com") ?? members[1];
const luna = byEmail("luna.davis@company.com") ?? members[2];
return { admin, john, luna };
}
async function seedTenant(t: { id: string; slug: string }) {
const tenantId = t.id;
const tus = await db.tenantUser.findMany({ where: { tenantId }, select: { userId: true } });
const users: any[] = await db.user.findMany({ where: { id: { in: tus.map((x: any) => x.userId) } }, select: { id: true, email: true, firstName: true, lastName: true } });
const members: Member[] = users.map((u) => ({ userId: u.id, email: u.email, first: u.firstName, last: u.lastName }));
const { admin, john, luna } = memberData(members);
const { dek, keyVersion } = await tenantDek(tenantId);
const enc = (plain: string) => seal(dek, plain, keyVersion);
const summary: string[] = [];
await rls(tenantId, async (tx) => {
// --- Locations (idempotent by tenantId+name) ---
async function ensureLocation(name: string, data: Record<string, unknown>, isDefault: boolean): Promise<string> {
const existing = await tx.hrLocation.findFirst({ where: { tenantId, name }, select: { id: true } });
if (existing) return existing.id;
if (DRY) { summary.push(`+location ${name}`); return "dry"; }
const created = await tx.hrLocation.create({ data: { tenantId, name, isDefault, isDemoData: true, ...data }, select: { id: true } });
summary.push(`+location ${name}`);
return created.id;
}
const berlin = await ensureLocation("Zentrale Berlin", { addressLine1: "Torstraße 1", postalCode: "10119", city: "Berlin", country: "DE", phone: "+49 30 1234000" }, true);
const muc = await ensureLocation("Standort München", { addressLine1: "Sendlinger Str. 12", postalCode: "80331", city: "München", country: "DE", phone: "+49 89 9876000" }, false);
// --- Profiles (upsert on tenantId_userId) ---
async function ensureProfile(m: Member, p: { position: string; team: string; locationId: string; personalNumber: string; managerUserId?: string; emergency?: { name: string; phone: string; relation: string } }) {
const data: Record<string, unknown> = {
position: p.position, team: p.team, locationId: p.locationId === "dry" ? null : p.locationId,
personalNumber: p.personalNumber, managerUserId: p.managerUserId ?? null, isDemoData: true,
};
if (p.emergency) data.emergencyContactCiphertext = enc(JSON.stringify(p.emergency));
if (DRY) { summary.push(`~profile ${m.email}`); return; }
await tx.hrEmployeeProfile.upsert({
where: { tenantId_userId: { tenantId, userId: m.userId } },
update: data,
create: { tenantId, userId: m.userId, ...data },
});
summary.push(`~profile ${m.email}${p.emergency ? " (+emergency)" : ""}`);
}
if (admin) await ensureProfile(admin, { position: "Geschäftsführung", team: "Leitung", locationId: berlin, personalNumber: "P-0001", emergency: { name: "Sabine Berger", phone: "+49 170 1112233", relation: "Ehepartnerin" } });
if (john) await ensureProfile(john, { position: "Vertriebsmitarbeiter", team: "Sales", locationId: berlin, personalNumber: "P-0002", managerUserId: admin?.userId, emergency: { name: "Maria Doe", phone: "+49 171 4455667", relation: "Schwester" } });
if (luna) await ensureProfile(luna, { position: "HR-Managerin", team: "People", locationId: muc, personalNumber: "P-0003", managerUserId: admin?.userId, emergency: { name: "Tom Davis", phone: "+49 172 8899001", relation: "Ehepartner" } });
// --- Password safe: one vault + access + entries ---
const vaultName = "Team-Zugänge (Demo)";
let vaultId = (await tx.employeePasswordSafeVault.findFirst({ where: { tenantId, name: vaultName }, select: { id: true } }))?.id ?? null;
if (!vaultId && !DRY && admin) {
vaultId = (await tx.employeePasswordSafeVault.create({ data: { tenantId, name: vaultName, description: "Gemeinsame Zugangsdaten des Teams.", createdByUserId: admin.userId, isDemoData: true }, select: { id: true } })).id;
summary.push(`+vault ${vaultName}`);
}
if (vaultId && !DRY) {
// Access grants: admin=admin, john=read, luna=write.
async function grant(m: Member | undefined, level: "read" | "write" | "admin") {
if (!m || !admin) return;
await tx.employeePasswordSafeAccess.upsert({
where: { vaultId_userId: { vaultId, userId: m.userId } },
update: { permissionLevel: level, grantedByUserId: admin.userId },
create: { tenantId, vaultId, userId: m.userId, permissionLevel: level, grantedByUserId: admin.userId },
});
}
await grant(admin, "admin"); await grant(john, "read"); await grant(luna, "write");
summary.push("~access admin/read/write");
// Entries (idempotent by tenantId+vaultId+title), secrets encrypted.
async function ensureEntry(title: string, url: string | null, username: string, password: string, notes: string) {
const exists = await tx.employeePasswordSafeEntry.findFirst({ where: { tenantId, vaultId, title }, select: { id: true } });
if (exists) return;
await tx.employeePasswordSafeEntry.create({
data: { tenantId, vaultId, title, url, tags: [], isDemoData: true, usernameCiphertext: enc(username), passwordCiphertext: enc(password), notesCiphertext: notes ? enc(notes) : null },
});
summary.push(`+entry ${title}`);
}
await ensureEntry("Firmen-WLAN", null, "hivegrid-guest", "Sommer2026!", "Nur für Gäste, monatlich wechseln.");
await ensureEntry("Microsoft 365 Sammelkonto", "https://portal.office.com", "team@company.com", "Xk9$mPq2Lz7w", "Nicht für Einzel-Logins verwenden.");
await ensureEntry("Newsletter-Tool", "https://newsletter.example.com", "marketing", "N3wsL!2026#", "");
}
return null;
});
// --- optional verify: decrypt one emergency contact back ---
if (VERIFY && !DRY) {
const prof = await rls(tenantId, (tx) => tx.hrEmployeeProfile.findFirst({ where: { tenantId, emergencyContactCiphertext: { not: null } }, select: { userId: true, emergencyContactCiphertext: true } }));
if (prof?.emergencyContactCiphertext) {
const back = open(dek, prof.emergencyContactCiphertext);
summary.push(`verify decrypt ok: ${back}`);
}
}
console.log(`\n[${t.slug}] (${tenantId})`);
for (const line of summary) console.log(" " + line);
}
async function main() {
const tenants = await db.tenant.findMany({ where: { slug: { in: DEMO_SLUGS } }, select: { id: true, slug: true } });
if (tenants.length === 0) { console.error("No demo tenants found — aborting (safety guard)."); process.exit(1); }
console.log(`HR demo seed — ${DRY ? "DRY RUN" : "WRITE"}${VERIFY ? " +verify" : ""} — tenants: ${tenants.map((t: any) => t.slug).join(", ")}`);
for (const t of tenants) await seedTenant(t);
console.log("\nDone.");
}
main().then(() => process.exit(0)).catch((e) => { console.error("SEED-ERR", e); process.exit(1); });
@@ -1,8 +1,8 @@
#!/usr/bin/env node
import fs from "node:fs";
const DEFAULT_LOGIN_URL = "https://boiler.saas-ctrl.com/login";
const DEFAULT_COOKIE_NAME = "RJ_session";
const DEFAULT_LOGIN_URL = "https://app.hivegrid.de/login";
const DEFAULT_COOKIE_NAME = "hivegrid_session";
function fail(message) {
console.error(`FAIL lighthouse cookie rotation: ${message}`);
@@ -46,7 +46,7 @@ function startLoginServer() {
if (req.method === "GET" && req.url === "/login") {
res.writeHead(200, {
"content-type": "text/html",
"set-cookie": "RJ_session=seed-cookie; Path=/; HttpOnly",
"set-cookie": "hivegrid_session=seed-cookie; Path=/; HttpOnly",
});
res.end('<form><input value="csrf-token-123" name="csrf" type="hidden"></form>');
return;
@@ -62,14 +62,14 @@ function startLoginServer() {
try {
const params = new URLSearchParams(body);
assert.equal(req.headers["x-csrf-token"], "csrf-token-123");
assert.equal(req.headers.cookie, "RJ_session=seed-cookie");
assert.equal(req.headers.cookie, "hivegrid_session=seed-cookie");
assert.equal(params.get("action"), "login");
assert.equal(params.get("csrf"), "csrf-token-123");
assert.equal(params.get("email"), "lighthouse@example.test");
assert.equal(params.get("password"), "super-secret-password");
res.writeHead(302, {
location: "/",
"set-cookie": "RJ_session=fresh-cookie; Path=/; HttpOnly; Secure",
"set-cookie": "hivegrid_session=fresh-cookie; Path=/; HttpOnly; Secure",
});
res.end();
} catch (error) {
@@ -117,19 +117,19 @@ describe("rotate-lighthouse-session-cookie", () => {
LIGHTHOUSE_LOGIN_URL: server.url,
LIGHTHOUSE_LOGIN_EMAIL: "lighthouse@example.test",
LIGHTHOUSE_LOGIN_PASSWORD: "super-secret-password",
LIGHTHOUSE_SESSION_COOKIE_NAME: "RJ_session",
LIGHTHOUSE_COOKIE_DOMAIN: "boiler.saas-ctrl.com",
LIGHTHOUSE_SESSION_COOKIE_NAME: "hivegrid_session",
LIGHTHOUSE_COOKIE_DOMAIN: "app.hivegrid.de",
});
assert.equal(result.status, 0, result.stderr);
assert.match(result.stdout, /Minted Lighthouse session cookie RJ_session/);
assert.match(result.stdout, /Minted Lighthouse session cookie hivegrid_session/);
assert.doesNotMatch(result.stdout, /fresh-cookie|super-secret-password/);
assert.doesNotMatch(result.stderr, /fresh-cookie|super-secret-password/);
const envFile = fs.readFileSync(githubEnv, "utf8");
assert.match(envFile, /^LIGHTHOUSE_SESSION_COOKIE=fresh-cookie$/m);
assert.match(envFile, /^LIGHTHOUSE_SESSION_COOKIE_NAME=RJ_session$/m);
assert.match(envFile, /^LIGHTHOUSE_COOKIE_DOMAIN=boiler\.saas-ctrl\.com$/m);
assert.match(envFile, /^LIGHTHOUSE_SESSION_COOKIE_NAME=hivegrid_session$/m);
assert.match(envFile, /^LIGHTHOUSE_COOKIE_DOMAIN=app\.hivegrid\.de$/m);
assert.equal(server.requests.length, 2);
assert.deepEqual(server.assertionErrors, []);
} finally {
@@ -164,12 +164,12 @@ describe("rotate-lighthouse-session-cookie", () => {
LIGHTHOUSE_LOGIN_EMAIL: "",
LIGHTHOUSE_LOGIN_PASSWORD: "",
LIGHTHOUSE_SESSION_COOKIE: "existing-cookie",
LIGHTHOUSE_SESSION_COOKIE_NAME: "RJ_session",
LIGHTHOUSE_SESSION_COOKIE_NAME: "hivegrid_session",
},
});
assert.equal(result.status, 0, result.stderr);
assert.match(result.stdout, /Using pre-provisioned Lighthouse session cookie RJ_session/);
assert.match(result.stdout, /Using pre-provisioned Lighthouse session cookie hivegrid_session/);
assert.doesNotMatch(result.stdout, /existing-cookie/);
assert.match(fs.readFileSync(githubEnv, "utf8"), /^LIGHTHOUSE_SESSION_COOKIE=existing-cookie$/m);
});
@@ -0,0 +1,18 @@
import { spawn } from "node:child_process";
process.env.HIVEGRID_CORE_TESTS_ONLY = "1";
const child = spawn(process.execPath, ["scripts/vitest-cli-compat.mjs", ...process.argv.slice(2)], {
cwd: process.cwd(),
stdio: "inherit",
env: process.env,
});
child.on("exit", (code, signal) => {
if (signal) {
process.kill(process.pid, signal);
return;
}
process.exit(code ?? 1);
});
@@ -1,13 +1,32 @@
#!/usr/bin/env node
import { spawnSync } from "node:child_process";
import path from "node:path";
import { fileURLToPath } from "node:url";
const result = spawnSync("npx", ["--yes", "@lhci/cli@0.13.x", "autorun"], {
stdio: "inherit",
});
export function runLighthouse({ spawn = spawnSync, stdout = process.stdout, stderr = process.stderr } = {}) {
const result = spawn("npx", ["--yes", "@lhci/cli@0.13.x", "autorun"], {
encoding: "utf8",
});
if (result.error?.code === "ENOENT") {
console.log("SKIP lhci not installable in this environment");
process.exit(0);
if (result.stdout) stdout.write(result.stdout);
if (result.stderr) stderr.write(result.stderr);
if (result.error?.code === "ENOENT") {
stdout.write("SKIP lhci not installable in this environment\n");
return 0;
}
const combinedOutput = `${result.stdout ?? ""}\n${result.stderr ?? ""}`;
if (combinedOutput.includes("Chrome installation not found")) {
stdout.write("SKIP Chrome not installed; Lighthouse CI requires a local Chrome/Chromium binary.\n");
return 0;
}
return result.status ?? 0;
}
process.exit(result.status ?? 0);
const isCli = process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1]);
if (isCli) {
process.exit(runLighthouse());
}
@@ -0,0 +1,49 @@
import { describe, expect, it } from "vitest";
import { runLighthouse } from "./run-lighthouse.mjs";
function createStream() {
let output = "";
return {
stream: { write: (chunk) => { output += chunk; } },
get output() {
return output;
},
};
}
describe("run-lighthouse", () => {
it("skips cleanly when npx is unavailable", () => {
const stdout = createStream();
const exitCode = runLighthouse({
spawn: () => ({ error: { code: "ENOENT" }, stdout: "", stderr: "", status: null }),
stdout: stdout.stream,
stderr: createStream().stream,
});
expect(exitCode).toBe(0);
expect(stdout.output).toContain("SKIP lhci not installable");
});
it("skips cleanly when Chrome is unavailable", () => {
const stdout = createStream();
const exitCode = runLighthouse({
spawn: () => ({ stdout: "Chrome installation not found\nHealthcheck failed!\n", stderr: "", status: 1 }),
stdout: stdout.stream,
stderr: createStream().stream,
});
expect(exitCode).toBe(0);
expect(stdout.output).toContain("SKIP Chrome not installed");
});
it("returns the lhci exit status for real failures", () => {
const exitCode = runLighthouse({
spawn: () => ({ stdout: "assertion failed\n", stderr: "", status: 1 }),
stdout: createStream().stream,
stderr: createStream().stream,
});
expect(exitCode).toBe(1);
});
});
@@ -89,8 +89,6 @@ export function missingReadinessEnv({ env = process.env } = {}) {
"E2E_TENANT_LOG_EVENTS_PATH",
"E2E_TENANT_AUDIT_EXPORT_PATH",
"E2E_TENANT_PRIVACY_PATH",
"E2E_TENANT_CHATBOT_PATH",
"E2E_TENANT_AI_USAGE_PATH",
"E2E_TENANT_API_PATH",
"E2E_TENANT_API_KEYS_PATH",
"E2E_TENANT_API_DOCS_PATH",
@@ -58,8 +58,6 @@ function completeReadinessEnv(overrides = {}) {
E2E_TENANT_LOG_EVENTS_PATH: "/app/acme/settings/logs/events",
E2E_TENANT_AUDIT_EXPORT_PATH: "/app/acme/settings/audit-export",
E2E_TENANT_PRIVACY_PATH: "/app/acme/settings/privacy",
E2E_TENANT_CHATBOT_PATH: "/app/acme/settings/chatbot",
E2E_TENANT_AI_USAGE_PATH: "/app/acme/settings/ai-usage",
E2E_TENANT_API_PATH: "/app/acme/settings/api",
E2E_TENANT_API_KEYS_PATH: "/app/acme/settings/api/keys",
E2E_TENANT_API_DOCS_PATH: "/app/acme/settings/api/docs",
@@ -282,8 +280,6 @@ describe("run-playwright-a11y", () => {
assert.match(stdout.lines[0], /E2E_TENANT_LOG_EVENTS_PATH/);
assert.match(stdout.lines[0], /E2E_TENANT_AUDIT_EXPORT_PATH/);
assert.match(stdout.lines[0], /E2E_TENANT_PRIVACY_PATH/);
assert.match(stdout.lines[0], /E2E_TENANT_CHATBOT_PATH/);
assert.match(stdout.lines[0], /E2E_TENANT_AI_USAGE_PATH/);
assert.match(stdout.lines[0], /E2E_TENANT_API_PATH/);
assert.match(stdout.lines[0], /E2E_TENANT_API_KEYS_PATH/);
assert.match(stdout.lines[0], /E2E_TENANT_API_DOCS_PATH/);
@@ -330,8 +326,6 @@ describe("run-playwright-a11y", () => {
E2E_TENANT_LOG_EVENTS_PATH: "/app/acme/settings/logs/events",
E2E_TENANT_AUDIT_EXPORT_PATH: "/app/acme/settings/audit-export",
E2E_TENANT_PRIVACY_PATH: "/app/acme/settings/privacy",
E2E_TENANT_CHATBOT_PATH: "/app/acme/settings/chatbot",
E2E_TENANT_AI_USAGE_PATH: "/app/acme/settings/ai-usage",
E2E_TENANT_API_PATH: "/app/acme/settings/api",
E2E_TENANT_API_KEYS_PATH: "/app/acme/settings/api/keys",
E2E_TENANT_API_DOCS_PATH: "/app/acme/settings/api/docs",
@@ -540,8 +534,6 @@ describe("run-playwright-a11y", () => {
E2E_TENANT_LOG_EVENTS_PATH: "/app/acme/settings/logs/events",
E2E_TENANT_AUDIT_EXPORT_PATH: "/app/acme/settings/audit-export",
E2E_TENANT_PRIVACY_PATH: "/app/acme/settings/privacy",
E2E_TENANT_CHATBOT_PATH: "/app/acme/settings/chatbot",
E2E_TENANT_AI_USAGE_PATH: "/app/acme/settings/ai-usage",
E2E_TENANT_API_PATH: "/app/acme/settings/api",
E2E_TENANT_API_KEYS_PATH: "/app/acme/settings/api/keys",
E2E_TENANT_API_DOCS_PATH: "/app/acme/settings/api/docs",
@@ -789,8 +781,6 @@ describe("run-playwright-a11y", () => {
"E2E_TENANT_LOG_EVENTS_PATH",
"E2E_TENANT_AUDIT_EXPORT_PATH",
"E2E_TENANT_PRIVACY_PATH",
"E2E_TENANT_CHATBOT_PATH",
"E2E_TENANT_AI_USAGE_PATH",
"E2E_TENANT_API_PATH",
"E2E_TENANT_API_KEYS_PATH",
"E2E_TENANT_API_DOCS_PATH",
@@ -27,7 +27,6 @@ export const ignoredDirectoryNames = new Set([
"generated",
"node_modules",
"out",
"storybook-static",
"tmp",
"temp",
"vendor",
@@ -1,5 +1,5 @@
import { describe, expect, test } from "vitest";
import { defaultAppRoleSeeds, defaultPermissionSeedDescriptors } from "@toolctrl/db/permissions-seed.server";
import { defaultAppRoleSeeds, defaultPermissionSeedDescriptors } from "@hivegrid/db/permissions-seed.server";
import { missingReadinessEnv } from "./run-playwright-a11y.mjs";
import {
@@ -24,12 +24,12 @@ import {
E2E_READINESS_PLUGIN_READONLY_EMAIL,
E2E_READINESS_PLUGIN_READONLY_PASSWORD,
E2E_READINESS_PLUGIN_READONLY_ROLE_NAME,
E2E_READINESS_SUBSCRIPTION_PLAN_STRIPE_ID,
E2E_READINESS_SUBSCRIPTION_PRICE_STRIPE_ID,
E2E_READINESS_SUBSCRIPTION_PLAN_BILLING_PROVIDER_ID,
E2E_READINESS_SUBSCRIPTION_PRICE_BILLING_PROVIDER_ID,
E2E_READINESS_TENANT_NAME,
E2E_READINESS_TENANT_SLUG,
E2E_READINESS_UPGRADE_PLAN_STRIPE_ID,
E2E_READINESS_UPGRADE_PRICE_STRIPE_ID,
E2E_READINESS_UPGRADE_PLAN_BILLING_PROVIDER_ID,
E2E_READINESS_UPGRADE_PRICE_BILLING_PROVIDER_ID,
E2E_READINESS_USER_EMAIL,
E2E_READINESS_USER_PASSWORD,
appFixturePath,
@@ -101,8 +101,6 @@ describe("seed-e2e-readiness", () => {
E2E_TENANT_LOG_EVENTS_PATH: "/e2e-readiness/settings/logs/events",
E2E_TENANT_AUDIT_EXPORT_PATH: "/e2e-readiness/settings/audit-export",
E2E_TENANT_PRIVACY_PATH: "/e2e-readiness/settings/privacy",
E2E_TENANT_CHATBOT_PATH: "/e2e-readiness/settings/chatbot",
E2E_TENANT_AI_USAGE_PATH: "/e2e-readiness/settings/ai-usage",
E2E_TENANT_API_PATH: "/e2e-readiness/settings/api",
E2E_TENANT_API_KEYS_PATH: "/e2e-readiness/settings/api/keys",
E2E_TENANT_API_DOCS_PATH: "/e2e-readiness/settings/api/docs",
@@ -142,7 +140,6 @@ describe("seed-e2e-readiness", () => {
expect(renderE2eReadinessEnvFile(env)).toContain('E2E_TENANT_SETTINGS_ACCOUNT_PATH="/e2e-readiness/settings/account"');
expect(renderE2eReadinessEnvFile(env)).toContain('E2E_TENANT_MEMBERS_PATH="/e2e-readiness/settings/members"');
expect(renderE2eReadinessEnvFile(env)).toContain('E2E_TENANT_PRIVACY_PATH="/e2e-readiness/settings/privacy"');
expect(renderE2eReadinessEnvFile(env)).toContain('E2E_TENANT_AI_USAGE_PATH="/e2e-readiness/settings/ai-usage"');
expect(renderE2eReadinessEnvFile(env)).toContain('E2E_TENANT_API_LOGS_PATH="/e2e-readiness/settings/api/logs"');
expect(renderE2eReadinessEnvFile(env)).toContain('E2E_ADMIN_EMAIL_SEQUENCES_PATH="/email-sequences"');
expect(renderE2eReadinessEnvFile(env)).toContain('E2E_ALLOW_WORKFLOW_WEBHOOK_RUN="0"');
@@ -168,10 +165,10 @@ describe("seed-e2e-readiness", () => {
});
test("defines separate owned and unowned subscription fixtures for billing smokes", () => {
expect(E2E_READINESS_SUBSCRIPTION_PLAN_STRIPE_ID).toBe("e2e_readiness_plan");
expect(E2E_READINESS_SUBSCRIPTION_PRICE_STRIPE_ID).toBe("e2e_readiness_price_monthly");
expect(E2E_READINESS_UPGRADE_PLAN_STRIPE_ID).toBe("e2e_readiness_upgrade_plan");
expect(E2E_READINESS_UPGRADE_PRICE_STRIPE_ID).toBe("e2e_readiness_upgrade_price_monthly");
expect(E2E_READINESS_SUBSCRIPTION_PLAN_BILLING_PROVIDER_ID).toBe("e2e_readiness_plan");
expect(E2E_READINESS_SUBSCRIPTION_PRICE_BILLING_PROVIDER_ID).toBe("e2e_readiness_price_monthly");
expect(E2E_READINESS_UPGRADE_PLAN_BILLING_PROVIDER_ID).toBe("e2e_readiness_upgrade_plan");
expect(E2E_READINESS_UPGRADE_PRICE_BILLING_PROVIDER_ID).toBe("e2e_readiness_upgrade_price_monthly");
});
test("keeps the plugin read-only fixture on the default User app role contract", () => {
@@ -5,12 +5,12 @@ import path from "node:path";
import { fileURLToPath } from "node:url";
import bcrypt from "bcryptjs";
import { entitlementPlanIds } from "@toolctrl/entitlements";
import { syncDefaultRolesAndPermissions } from "@toolctrl/db/permissions-seed.server";
import { getDbClient, type DbClient } from "@toolctrl/db/client.server";
import { deriveLegacyApiKeyHashMetadata } from "@toolctrl/db/api-keys.server";
import type { PluginManifest } from "@toolctrl/plugin-runtime";
import type { SequenceStep } from "@toolctrl/email-sequences";
import { entitlementPlanIds } from "@hivegrid/entitlements";
import { syncDefaultRolesAndPermissions } from "@hivegrid/db/permissions-seed.server";
import { getDbClient, type DbClient } from "@hivegrid/db/client.server";
import { deriveLegacyApiKeyHashMetadata } from "@hivegrid/db/api-keys.server";
import type { PluginManifest } from "@hivegrid/plugin-runtime";
import type { SequenceStep } from "@hivegrid/email-sequences";
export const E2E_READINESS_USER_EMAIL = "e2e.readiness@example.test";
export const E2E_READINESS_USER_PASSWORD = "ReadinessPass123!";
@@ -40,9 +40,9 @@ export const E2E_READINESS_WAITING_WORKFLOW_ID = "wf_waiting_123";
export const E2E_READINESS_WAITING_WORKFLOW_NAME = "E2E Readiness Waiting Workflow";
export const E2E_READINESS_WAITING_EXECUTION_ID = "wfe_waiting_123";
export const E2E_READINESS_WAITING_MANUAL_BLOCK_EXECUTION_ID = "wfbe_waiting_manual_123";
export const E2E_READINESS_PLUGIN_ID = "com.toolctrl.e2e-readiness";
export const E2E_READINESS_PLUGIN_ID = "com.hivegrid.e2e-readiness";
export const E2E_READINESS_PLUGIN_VERSION = "1.0.0";
export const E2E_READINESS_LIFECYCLE_PLUGIN_ID = "com.toolctrl.e2e-lifecycle";
export const E2E_READINESS_LIFECYCLE_PLUGIN_ID = "com.hivegrid.e2e-lifecycle";
export const E2E_READINESS_LIFECYCLE_PLUGIN_VERSION = "1.0.0";
// Must match WORKSPACE_ROLES_FEATURE_FLAG in workspaceRoles.server.ts.
export const E2E_READINESS_WORKSPACE_ROLES_FLAG = "workspace-roles";
@@ -51,10 +51,10 @@ export const E2E_READINESS_API_LOG_ENDPOINT = "/v1/e2e-readiness";
export const E2E_READINESS_API_LOG_METHOD = "GET";
export const E2E_READINESS_PORTAL_SUBDOMAIN = "e2e-readiness";
export const E2E_READINESS_PORTAL_TITLE = "E2E Readiness Portal";
export const E2E_READINESS_SUBSCRIPTION_PLAN_STRIPE_ID = "e2e_readiness_plan";
export const E2E_READINESS_SUBSCRIPTION_PRICE_STRIPE_ID = "e2e_readiness_price_monthly";
export const E2E_READINESS_UPGRADE_PLAN_STRIPE_ID = "e2e_readiness_upgrade_plan";
export const E2E_READINESS_UPGRADE_PRICE_STRIPE_ID = "e2e_readiness_upgrade_price_monthly";
export const E2E_READINESS_SUBSCRIPTION_PLAN_BILLING_PROVIDER_ID = "e2e_readiness_plan";
export const E2E_READINESS_SUBSCRIPTION_PRICE_BILLING_PROVIDER_ID = "e2e_readiness_price_monthly";
export const E2E_READINESS_UPGRADE_PLAN_BILLING_PROVIDER_ID = "e2e_readiness_upgrade_plan";
export const E2E_READINESS_UPGRADE_PRICE_BILLING_PROVIDER_ID = "e2e_readiness_upgrade_price_monthly";
// Entitlement plan granted to the seeded tenant's active subscription product so
// per-feature gates (workflow engine, API, advanced builder, ...) resolve as allowed
// instead of redirecting to /plan-required. "business" grants the widest feature set.
@@ -237,8 +237,6 @@ export function buildE2eReadinessEnv(fixture: ReadinessFixture): Record<string,
E2E_TENANT_LOG_EVENTS_PATH: appFixturePath(fixture.tenantSlug, "settings/logs/events"),
E2E_TENANT_AUDIT_EXPORT_PATH: appFixturePath(fixture.tenantSlug, "settings/audit-export"),
E2E_TENANT_PRIVACY_PATH: appFixturePath(fixture.tenantSlug, "settings/privacy"),
E2E_TENANT_CHATBOT_PATH: appFixturePath(fixture.tenantSlug, "settings/chatbot"),
E2E_TENANT_AI_USAGE_PATH: appFixturePath(fixture.tenantSlug, "settings/ai-usage"),
E2E_TENANT_API_PATH: appFixturePath(fixture.tenantSlug, "settings/api"),
E2E_TENANT_API_KEYS_PATH: appFixturePath(fixture.tenantSlug, "settings/api/keys"),
E2E_TENANT_API_DOCS_PATH: appFixturePath(fixture.tenantSlug, "settings/api/docs"),
@@ -747,10 +745,10 @@ async function seedSubscription(db: DbClient, tenantId: string) {
periodEnd.setUTCMonth(periodEnd.getUTCMonth() + 1);
const product =
(await db.subscriptionProduct.findFirst({ where: { stripeId: E2E_READINESS_SUBSCRIPTION_PLAN_STRIPE_ID } })) ??
(await db.subscriptionProduct.findFirst({ where: { billingProviderId: E2E_READINESS_SUBSCRIPTION_PLAN_BILLING_PROVIDER_ID } })) ??
(await db.subscriptionProduct.create({
data: {
stripeId: E2E_READINESS_SUBSCRIPTION_PLAN_STRIPE_ID,
billingProviderId: E2E_READINESS_SUBSCRIPTION_PLAN_BILLING_PROVIDER_ID,
order: 1,
title: "E2E Readiness Plan",
active: true,
@@ -779,11 +777,11 @@ async function seedSubscription(db: DbClient, tenantId: string) {
}
const price =
(await db.subscriptionPrice.findFirst({ where: { subscriptionProductId: product.id, stripeId: E2E_READINESS_SUBSCRIPTION_PRICE_STRIPE_ID } })) ??
(await db.subscriptionPrice.findFirst({ where: { subscriptionProductId: product.id, billingProviderId: E2E_READINESS_SUBSCRIPTION_PRICE_BILLING_PROVIDER_ID } })) ??
(await db.subscriptionPrice.create({
data: {
subscriptionProductId: product.id,
stripeId: E2E_READINESS_SUBSCRIPTION_PRICE_STRIPE_ID,
billingProviderId: E2E_READINESS_SUBSCRIPTION_PRICE_BILLING_PROVIDER_ID,
type: 0,
billingPeriod: 3,
price: "19",
@@ -799,10 +797,10 @@ async function seedSubscription(db: DbClient, tenantId: string) {
});
const upgradeProduct =
(await db.subscriptionProduct.findFirst({ where: { stripeId: E2E_READINESS_UPGRADE_PLAN_STRIPE_ID } })) ??
(await db.subscriptionProduct.findFirst({ where: { billingProviderId: E2E_READINESS_UPGRADE_PLAN_BILLING_PROVIDER_ID } })) ??
(await db.subscriptionProduct.create({
data: {
stripeId: E2E_READINESS_UPGRADE_PLAN_STRIPE_ID,
billingProviderId: E2E_READINESS_UPGRADE_PLAN_BILLING_PROVIDER_ID,
order: 2,
title: "E2E Readiness Upgrade Plan",
active: true,
@@ -828,12 +826,12 @@ async function seedSubscription(db: DbClient, tenantId: string) {
const upgradePrice =
(await db.subscriptionPrice.findFirst({
where: { subscriptionProductId: upgradeProduct.id, stripeId: E2E_READINESS_UPGRADE_PRICE_STRIPE_ID },
where: { subscriptionProductId: upgradeProduct.id, billingProviderId: E2E_READINESS_UPGRADE_PRICE_BILLING_PROVIDER_ID },
})) ??
(await db.subscriptionPrice.create({
data: {
subscriptionProductId: upgradeProduct.id,
stripeId: E2E_READINESS_UPGRADE_PRICE_STRIPE_ID,
billingProviderId: E2E_READINESS_UPGRADE_PRICE_BILLING_PROVIDER_ID,
type: 0,
billingPeriod: 3,
price: "29",
@@ -850,7 +848,7 @@ async function seedSubscription(db: DbClient, tenantId: string) {
const tenantSubscription = await db.tenantSubscription.upsert({
where: { tenantId },
create: { tenantId, stripeCustomerId: null },
create: { tenantId, billingProviderCustomerId: null },
update: {},
});
@@ -1027,7 +1025,7 @@ async function seedPortal(db: DbClient, tenantId: string, userId: string) {
// mounted; this fixture lets the readiness lane exercise the tenant portal
// management surfaces (analytics + settings) once the env opt-in is set. A
// minimal published portal is enough — the pages render their empty-state /
// form without any Stripe/analytics data.
// form without any Mollie/analytics data.
await db.portal.upsert({
where: { subdomain: E2E_READINESS_PORTAL_SUBDOMAIN },
create: {
@@ -125,7 +125,7 @@ function extractTestNames(content: string): string[] {
function parseS04Summary(source: EvidenceSource): TenantIsolationEvidence["s04"] {
const verificationStatus = source.content.match(/^verification_result:\s*(.+)$/m)?.[1]?.trim() ?? "unknown";
const headingSummary = source.content.match(/^\*\*(.+?)\*\*/m)?.[1]?.trim() ?? "S04 summary available.";
const patternBlock = source.content.match(/^patterns_established:\n([\s\S]*?)(?:\n[a-z_]+:|\n---)/m)?.[1] ?? "";
const patternBlock = source.content.match(/^patterns_established:\r?\n([\s\S]*?)(?:\r?\n[a-z_]+:|\r?\n---)/m)?.[1] ?? "";
const patterns = uniqueSorted([...patternBlock.matchAll(/^\s*-\s+(.+)$/gm)].map((match) => sanitizeSummaryText(match[1])));
return {
@@ -4,7 +4,7 @@ import fs from "node:fs";
import path from "node:path";
const BASELINE_PATH = ".eslintrc.a11y-baseline.json";
const DEFAULT_SCOPE = ["apps/web/app/**/*.tsx", "packages/ui/src/stories/**/*.tsx"];
const DEFAULT_SCOPE = ["apps/web/app/**/*.tsx", "packages/ui/src/**/*.tsx"];
function readBaseline(rootDir) {
return JSON.parse(fs.readFileSync(path.join(rootDir, BASELINE_PATH), "utf8"));
@@ -38,7 +38,7 @@ export const REQUIRED_E2E_FLOW_ASSERTIONS = {
"zeroTenantAccountStatePattern",
"/login?redirectTo=",
"[data-ui-id=\"ui.account.create.form\"]",
"failOnStripeNetworkRequests(",
"failOnPaymentProviderNetworkRequests(",
"tenantSettingsSubscriptionPath(",
"[data-ui-id=\"ui.subscription.page\"]",
"[data-ui-id=\"ui.subscription.billing.portal\"]",
@@ -165,32 +165,6 @@ export const REQUIRED_E2E_FLOW_ASSERTIONS = {
"[data-ui-id=\"ui.settings.notifications.preference.team.email\"]",
],
},
"tenant-chatbot-settings": {
file: "tests/e2e/tenant-chatbot-settings.mobile-a11y.spec.ts",
axe: true,
mobileOverflow: true,
requiredSnippets: [
"renders access controls without mobile overflow or critical a11y violations",
"submits tenant default access contract with csrf without mutating data",
"interceptCurrentRoutePost(",
"[data-ui-id=\"ui.settings.chatbot.page\"]",
"[data-ui-id=\"ui.settings.chatbot.master.form\"]",
"[data-ui-id=\"ui.settings.chatbot.defaults.form\"]",
"[data-ui-id=\"ui.settings.chatbot.providers\"]",
],
},
"tenant-ai-usage": {
file: "tests/e2e/ai-usage.mobile-a11y.spec.ts",
axe: true,
mobileOverflow: true,
requiredSnippets: [
"renders quota and forecast without mobile overflow or critical a11y violations",
"deriveAiUsagePath(",
"getByRole(\"progressbar\"",
"getByRole(\"heading\"",
"/settings/ai-usage",
],
},
"workflow-builder-run": {
file: "tests/e2e/workflow-builder-run.mobile-a11y.spec.ts",
axe: true,
@@ -243,7 +217,7 @@ export const REQUIRED_E2E_FLOW_ASSERTIONS = {
mobileOverflow: true,
requiredSnippets: [
"navigates authenticated mobile readiness surfaces without mutations",
"failOnStripeNetworkRequests(",
"failOnPaymentProviderNetworkRequests(",
"[data-ui-id=\"ui.subscription.checkout.page\"]",
"[data-ui-id=\"ui.plugins.page\"]",
"[data-ui-id=\"ui.workflows.builder.canvas\"]",
@@ -262,7 +236,7 @@ export const REQUIRED_E2E_FLOW_ASSERTIONS = {
"submits cancellation action contract with CSRF when cancellation controls are rendered",
"opens cancellation confirmation by keyboard and dismisses it with Escape without posting",
"reconciles checkout success state so it persists across reload and re-login",
"failOnStripeNetworkRequests(",
"failOnPaymentProviderNetworkRequests(",
],
},
"mobile-authenticated-shell": {
@@ -253,7 +253,7 @@ describe("verify-a11y-coverage", () => {
mobileOverflow: true,
requiredSnippets: [
"navigates authenticated mobile readiness surfaces without mutations",
"failOnStripeNetworkRequests(",
"failOnPaymentProviderNetworkRequests(",
"[data-ui-id=\"ui.subscription.checkout.page\"]",
"[data-ui-id=\"ui.plugins.page\"]",
"[data-ui-id=\"ui.workflows.builder.canvas\"]",
@@ -266,7 +266,7 @@ describe("verify-a11y-coverage", () => {
ok: false,
failures: [
'required e2e flow "readiness-golden-path" in tests/e2e/readiness-golden-path.mobile-a11y.spec.ts must include "navigates authenticated mobile readiness surfaces without mutations"',
'required e2e flow "readiness-golden-path" in tests/e2e/readiness-golden-path.mobile-a11y.spec.ts must include "failOnStripeNetworkRequests("',
'required e2e flow "readiness-golden-path" in tests/e2e/readiness-golden-path.mobile-a11y.spec.ts must include "failOnPaymentProviderNetworkRequests("',
'required e2e flow "readiness-golden-path" in tests/e2e/readiness-golden-path.mobile-a11y.spec.ts must include "[data-ui-id=\\"ui.subscription.checkout.page\\"]"',
'required e2e flow "readiness-golden-path" in tests/e2e/readiness-golden-path.mobile-a11y.spec.ts must include "[data-ui-id=\\"ui.plugins.page\\"]"',
'required e2e flow "readiness-golden-path" in tests/e2e/readiness-golden-path.mobile-a11y.spec.ts must include "[data-ui-id=\\"ui.workflows.builder.canvas\\"]"',
@@ -328,8 +328,6 @@ describe("verify-a11y-coverage", () => {
"profile-security",
"tenant-members",
"tenant-notifications-settings",
"tenant-chatbot-settings",
"tenant-ai-usage",
];
const requiredE2eAssertions = Object.fromEntries(flows.map((flow) => [flow, REQUIRED_E2E_FLOW_ASSERTIONS[flow]]));
const requiredE2eSpecs = Object.fromEntries(flows.map((flow) => [flow, REQUIRED_E2E_FLOW_ASSERTIONS[flow].file]));
@@ -368,8 +366,6 @@ describe("verify-a11y-coverage", () => {
'required e2e flow "profile-security" in tests/e2e/profile-security.mobile-a11y.spec.ts must include "renders security, MFA, session, and danger controls without mobile overflow or critical a11y violations"',
'required e2e flow "tenant-members" in tests/e2e/tenant-members.mobile-a11y.spec.ts must include "renders members table at"',
'required e2e flow "tenant-notifications-settings" in tests/e2e/tenant-notifications-settings.mobile-a11y.spec.ts must include "renders notification categories without mobile overflow or critical a11y violations"',
'required e2e flow "tenant-chatbot-settings" in tests/e2e/tenant-chatbot-settings.mobile-a11y.spec.ts must include "renders access controls without mobile overflow or critical a11y violations"',
'required e2e flow "tenant-ai-usage" in tests/e2e/ai-usage.mobile-a11y.spec.ts must include "renders quota and forecast without mobile overflow or critical a11y violations"',
]),
);
});
@@ -58,8 +58,8 @@ describe("e2e readiness workflows", () => {
assert.ok(source.includes("workflow_outbox_drain:"), `${workflow} must expose the workflow outbox-drain manual dispatch opt-in`);
assert.ok(source.includes("workflow_webhook_run:"), `${workflow} must expose the real workflow webhook manual dispatch opt-in`);
assert.ok(source.includes("workflow_webhook_target_url:"), `${workflow} must expose the real workflow webhook target URL input`);
assert.ok(source.includes("subscription_success:"), `${workflow} must expose the Stripe checkout success manual dispatch opt-in`);
assert.ok(source.includes("subscription_success_path:"), `${workflow} must expose the Stripe checkout success return path input`);
assert.ok(source.includes("subscription_success:"), `${workflow} must expose the checkout success manual dispatch opt-in`);
assert.ok(source.includes("subscription_success_path:"), `${workflow} must expose the checkout success return path input`);
assert.ok(source.includes("Apply manual operator E2E opt-ins"), `${workflow} must apply manual operator opt-ins before running Playwright`);
for (const requiredEnv of [
@@ -110,7 +110,7 @@ describe("e2e readiness workflows", () => {
const source = readWorkflow(".gitea/workflows/e2e-readiness.yml");
assert.ok(source.includes("runs-on: toolctrl-ci"));
assert.ok(source.includes("TOOLCTRL_GITEA_HOST_IP"));
assert.ok(source.includes("HIVEGRID_GITEA_HOST_IP"));
assert.ok(source.includes("git.tool-ctrl.de"));
});
});
@@ -10,21 +10,23 @@ import { spawn } from "node:child_process";
const __dirname = path.dirname(fileURLToPath(import.meta.url));
const repoRoot = path.resolve(__dirname, "..");
export const reportPath = path.join(repoRoot, ".tc/baselines/billing-boundary/baseline-health.md");
const pnpmCommand = process.platform === "win32" ? "pnpm.cmd" : "pnpm";
const billingInventoryPatterns = [
{ id: "plan-equality", pattern: /\bplan\s*===/g },
{ id: "trial-days", pattern: /\btrialDays\b/g },
{ id: "trial-free-autosubscribe", pattern: /\bautosubscribeToTrialOrFreePlan\b/g },
{ id: "stripe-price-product-lookup", pattern: /\b(?:stripePriceId|stripeProductId|getSubscriptionPriceByStripeId|getSubscriptionProductByStripeId|price\.stripeId|product\.stripeId|stripe\.prices|stripe\.products)\b/g },
{ id: "billing-price-product-lookup", pattern: /\b(?:billingProviderPriceId|billingProviderProductId|getSubscriptionPriceByBillingProviderId|getSubscriptionProductByBillingProviderId|price\.billingProviderId|product\.billingProviderId|billing\.prices|billing\.products)\b/g },
{ id: "direct-subscription-model-access", pattern: /\bdb\.(?:subscriptionProduct|subscriptionPrice|subscriptionFeature|subscriptionUsageBasedPrice|subscriptionUsageBasedTier|tenantSubscription|tenantSubscriptionProduct|tenantSubscriptionProductPrice|tenantSubscriptionUsageRecord|checkoutSessionStatus)\b/g },
];
export const gates = [
{ id: "typecheck", command: "pnpm", args: ["run", "typecheck"] },
{ id: "lint", command: "pnpm", args: ["run", "lint"] },
{ id: "typecheck", command: pnpmCommand, displayCommand: "pnpm", args: ["run", "typecheck"] },
{ id: "lint", command: pnpmCommand, displayCommand: "pnpm", args: ["run", "lint"] },
{
id: "vitest-billing-boundary",
command: "pnpm",
command: pnpmCommand,
displayCommand: "pnpm",
args: [
"exec",
"vitest",
@@ -39,7 +41,7 @@ export const gates = [
function shellCommand(gate) {
if (gate.type === "billing-inventory") return "read-only billing inventory";
return [gate.command, ...gate.args].join(" ");
return [gate.displayCommand ?? gate.command, ...gate.args].join(" ");
}
function outputFingerprint(output) {
@@ -106,7 +108,7 @@ function runShellGate(gate) {
const child = spawn(gate.command, gate.args, {
cwd: repoRoot,
env: { ...process.env, CI: "1" },
shell: false,
shell: process.platform === "win32",
});
let stdout = "";
@@ -211,7 +213,7 @@ export function renderReport(results) {
`Generated: ${new Date().toISOString()}`,
"",
"This report captures non-E2E baseline gates for Billing Boundary baseline. The runner exits 0 when every gate was executed and this report was written, even if individual gates fail.",
"The billing inventory gate is read-only and fingerprints known plan, trial, Stripe lookup, and direct subscription model access hot spots without failing on legacy findings.",
"The billing inventory gate is read-only and fingerprints known plan, trial, billing provider lookup, and direct subscription model access hot spots without failing on legacy findings.",
"",
];
@@ -37,15 +37,27 @@ const DEFAULT_BUDGETS_CONFIG_PATH = path.join(REPO_ROOT, "scripts", "bundle-budg
// Hard budgets (bytes). Seeded from current build + tight headroom.
// If you intentionally grow the bundle, update these and call it out in the
// commit so reviewers can sanity-check the new floor.
//
// 2026-06-26: absorbs auth WF-P2 + P19 growth. The merge of the new auth
// screens and P19 grew the route manifest and aggregate JS/CSS past the
// May-2026 floors with no per-route regression (per-route soft gate stays
// green). Raised the exceeded groups to current-build + ~10% headroom; vendor
// and other still pass and are left untouched:
// root 790_964 -> 1_135_000 (build 1_031_227, +30.4% over old)
// initial_payload_js 790_964 -> 1_135_000 (build 1_031_227, mirrors root)
// manifest_js 699_563 -> 1_040_000 (build 944_428, +35.0% over old)
// route 2_650_000 -> 3_175_000 (build 2_883_556, +8.8% over old)
// total_js 6_776_505 -> 7_750_000 (build 7_033_988, +3.8% over old)
// css 770_317 -> 1_020_000 (build 923_551, +19.9% over old)
export const BUDGETS = Object.freeze({
root: 790_964,
initial_payload_js: 790_964,
manifest_js: 699_563,
root: 1_135_000,
initial_payload_js: 1_135_000,
manifest_js: 1_040_000,
vendor: 1_690_674,
route: 2_650_000,
route: 3_175_000,
other: 1_821_650,
total_js: 6_776_505,
css: 770_317,
total_js: 7_750_000,
css: 1_020_000,
});
export const EMPTY_JS_CHUNK_ALLOWLIST = Object.freeze([
@@ -344,7 +344,7 @@ describe("per-route budget config", () => {
expect(Object.keys(cfg.vendorChunks).length).toBeGreaterThanOrEqual(3);
});
it("pins emitted workflow and AI chunk names to explicit budgets", () => {
it("pins emitted workflow chunk names to explicit budgets", () => {
const cfg = loadBudgetsConfig();
for (const key of [
"workflow-engine",
@@ -354,11 +354,6 @@ describe("per-route budget config", () => {
"workflows._id.run.manual",
"workflows._id.run.stream",
"workflows._id.run.stream._executionId",
"chatbot",
"chatbot-widget",
"chatbot-interactive-widget",
"ai-usage",
"pricing.ai-overage",
]) {
expect(lookupBudget(key, cfg)).toMatchObject({
kind: "route",
@@ -4,10 +4,10 @@ import path from "node:path";
import { fileURLToPath } from "node:url";
const REQUIRED_PACKAGE_MANAGER = "pnpm@10.33.0";
const REQUIRED_SCRIPTS = ["typecheck", "lint", "test", "test:packages", "test:mobile", "build", "build:ci"];
const REQUIRED_SCRIPTS = ["typecheck", "lint", "test", "test:packages", "build", "build:ci"];
const REQUIRED_FILES = ["package.json", "pnpm-lock.yaml", ".eslintrc"];
const REQUIRED_SCRIPT_BODIES = {
build: "pnpm --filter @toolctrl/db prisma:generate && pnpm --filter @toolctrl/db build && pnpm --filter @toolctrl/web build",
build: "pnpm --filter @hivegrid/db prisma:generate && pnpm --filter @hivegrid/db build && pnpm --filter @hivegrid/web build",
"build:ci": "pnpm run build",
"verify:i18n": "tsx scripts/i18n-check.ts && node scripts/verify-hardcoded-strings.mjs && eslint --max-warnings=0 --ext .tsx,.ts packages/ui-app/src packages/ui-subframe/src packages/ui-mock/src",
"verify:ui-hot-swap": "tsx scripts/verify-ui-hot-swap.ts",
@@ -16,7 +16,6 @@ const REQUIRED_SCRIPT_BODIES = {
"verify:sidebar-routes": "pnpm exec vitest run apps/web/app/application/sidebar/AdminSidebar.test.tsx apps/web/app/application/sidebar/AppSidebar.test.tsx apps/web/app/components/layouts/sidebars/shadcn/app-sidebar.test.tsx apps/web/app/routes/admin/admin-route-targets.test.ts apps/web/app/routes.test.ts",
"verify:a11y-coverage": "node scripts/verify-a11y-coverage.mjs",
"test:a11y": "pnpm exec vitest run apps/web/app/components/ui/button.a11y.test.tsx apps/web/app/components/ui/errors/ErrorPage.a11y.test.tsx apps/web/app/components/ui/*.axe.test.tsx apps/web/app/components/core/SkipToContent.test.tsx apps/web/app/components/aceternity/HoverEffect.a11y.test.tsx apps/web/app/components/ui/lists/ViewToggle.a11y.test.tsx apps/web/app/components/ui/lists/ViewToggleWithUrl.a11y.test.tsx apps/web/app/components/ui/tabs/TabsWithIcons.a11y.test.tsx scripts/verify-color-contrast.test.mjs",
"test:mobile": "pnpm --filter @toolctrl/mobile test",
};
const PHASE_C_UI_GLOBS = ["packages/ui-app/src", "packages/ui-subframe/src", "packages/ui-mock/src"];
const PHASE_C_I18N_SELECTOR_SNIPPETS = [
@@ -11,12 +11,11 @@ const VALID_PACKAGE = {
private: true,
packageManager: "pnpm@10.33.0",
scripts: {
build: "pnpm --filter @toolctrl/db prisma:generate && pnpm --filter @toolctrl/db build && pnpm --filter @toolctrl/web build",
build: "pnpm --filter @hivegrid/db prisma:generate && pnpm --filter @hivegrid/db build && pnpm --filter @hivegrid/web build",
"build:ci": "pnpm run build",
lint: "eslint --max-warnings=0 --ext .tsx,.ts .",
test: "pnpm --filter @toolctrl/web test",
test: "pnpm --filter @hivegrid/web test",
"test:packages": "node scripts/verify-package-test-scripts.mjs && pnpm --filter './packages/*' --if-present test",
"test:mobile": "pnpm --filter @toolctrl/mobile test",
typecheck: "tsc -b",
"verify:i18n": "tsx scripts/i18n-check.ts && node scripts/verify-hardcoded-strings.mjs && eslint --max-warnings=0 --ext .tsx,.ts packages/ui-app/src packages/ui-subframe/src packages/ui-mock/src",
"verify:ui-hot-swap": "tsx scripts/verify-ui-hot-swap.ts",
@@ -131,7 +130,6 @@ describe("verify-ci-baseline", () => {
assert.deepEqual(result.failures, []);
assert.ok(result.passes.some((pass) => pass === "package.json: packageManager is pnpm@10.33.0"));
assert.ok(result.passes.some((pass) => pass === "package.json: script \"typecheck\" is defined"));
assert.ok(result.passes.some((pass) => pass === "package.json: script \"test:mobile\" is defined"));
assert.ok(result.passes.some((pass) => pass === "package.json: script \"build:ci\" is defined"));
assert.ok(result.passes.some((pass) => pass === "package.json: script \"build:ci\" matches the required CI command"));
assert.ok(result.passes.some((pass) => pass === "package.json: script \"lint\" invokes ESLint"));
@@ -143,7 +141,6 @@ describe("verify-ci-baseline", () => {
assert.ok(result.passes.some((pass) => pass === "package.json: script \"verify:sidebar-routes\" matches the required CI command"));
assert.ok(result.passes.some((pass) => pass === "package.json: script \"verify:a11y-coverage\" matches the required CI command"));
assert.ok(result.passes.some((pass) => pass === "package.json: script \"test:a11y\" matches the required CI command"));
assert.ok(result.passes.some((pass) => pass === "package.json: script \"test:mobile\" matches the required CI command"));
assert.ok(result.passes.some((pass) => pass === "package.json: script \"verify:i18n\" runs ESLint over Phase C UI packages"));
assert.ok(result.passes.some((pass) => pass === "pnpm-lock.yaml: exists"));
assert.ok(result.passes.some((pass) => pass === ".eslintrc: rule \"no-console\" is warn"));
@@ -262,7 +259,7 @@ describe("verify-ci-baseline", () => {
it("fails when build omits Prisma generation", () => {
const rootDir = createFixture({
rootPackage: mutatePackage((rootPackage) => {
rootPackage.scripts.build = "pnpm --filter @toolctrl/db build && pnpm --filter @toolctrl/web build";
rootPackage.scripts.build = "pnpm --filter @hivegrid/db build && pnpm --filter @hivegrid/web build";
}),
});
@@ -270,7 +267,7 @@ describe("verify-ci-baseline", () => {
assert.match(
result.failures.join("\n"),
/package\.json: script "build" must be exactly "pnpm --filter @toolctrl\/db prisma:generate && pnpm --filter @toolctrl\/db build && pnpm --filter @toolctrl\/web build"/,
/package\.json: script "build" must be exactly "pnpm --filter @hivegrid\/db prisma:generate && pnpm --filter @hivegrid\/db build && pnpm --filter @hivegrid\/web build"/,
);
});
@@ -17,7 +17,7 @@
* The script has no third-party dependencies — the WCAG contrast formula is
* <20 lines of math and tightly testable.
*
* Spec: docs/improvement-plan/10-compliance-polish/wcag-internal.md
* Docs: docs/contributing/wcag-audit.md
*/
import fs from "node:fs";
import path from "node:path";
@@ -22,7 +22,6 @@ const ignoredDirectoryNames = new Set([
".cache",
".vite",
"generated",
"llm-docs",
".tc",
]);
@@ -46,7 +45,7 @@ export const complianceRetentionInventoryPatterns = [
{ id: "export-hook-marker", pattern: /\b(?:export|exports|download|downloads|dataExport|exportJob|processExport|csv|json|xlsx|pdf)\b/gi },
{ id: "admin-pause-resume-marker", pattern: /\b(?:admin|pause|paused|resume|resumed|suspend|unsuspend|disable|enable)\b/gi },
{ id: "audit-subscription-risk-marker", pattern: /\b(?:audit|auditable|auditLog|actorId|tenantId|workspaceId|subscription|billing|entitlement|risk)\b/g },
{ id: "generated-client-reference", pattern: /\b(?:packages\/db\/generated|@toolctrl\/db\/generated|generated\/prisma|PrismaClient|client\/models|client\/enums)\b/g },
{ id: "generated-client-reference", pattern: /\b(?:packages\/db\/generated|@hivegrid\/db\/generated|generated\/prisma|PrismaClient|client\/models|client\/enums)\b/g },
];
export const gates = [
@@ -48,7 +48,7 @@ export const sourceFileExtensions = new Set([
]);
const forbiddenPatterns = [
{ id: "toolctrl-plugins-package", pattern: /(?:^|["'`\s])@toolctrl\/plugins(?:["'`\s/]|$)/ },
{ id: "hivegrid-plugins-package", pattern: /(?:^|["'`\s])@hivegrid\/plugins(?:["'`\s/]|$)/ },
{ id: "packages-plugins-path", pattern: /(?:^|["'`\s./])packages\/plugins(?:["'`\s/]|$)/ },
];
@@ -51,7 +51,7 @@ describe("Feature Manifest core build smoke verifier helpers", () => {
root,
"app/runtime.ts",
[
"import { loadPlugins } from '@toolctrl/plugins';",
"import { loadPlugins } from '@hivegrid/plugins';",
"const allowed = 'not a plugin reference';",
"const manifestPath = 'packages/plugins/manifest.json';",
].join("\n"),
@@ -63,8 +63,8 @@ describe("Feature Manifest core build smoke verifier helpers", () => {
{
file: "app/runtime.ts",
line: 1,
id: "toolctrl-plugins-package",
text: "import { loadPlugins } from '@toolctrl/plugins';",
id: "hivegrid-plugins-package",
text: "import { loadPlugins } from '@hivegrid/plugins';",
},
{
file: "app/runtime.ts",
@@ -77,7 +77,7 @@ describe("Feature Manifest core build smoke verifier helpers", () => {
it("scans package manifests and Dockerfile runtime copy paths", async () => {
const root = await createFixtureRoot();
await writeFixtureFile(root, "package.json", '{ "dependencies": { "@toolctrl/plugins": "workspace:*" } }\n');
await writeFixtureFile(root, "package.json", '{ "dependencies": { "@hivegrid/plugins": "workspace:*" } }\n');
await writeFixtureFile(root, "Dockerfile", "COPY --from=build /myapp/packages/plugins /myapp/packages/plugins\n");
const result = await scanForbiddenPluginImports(root, ["package.json", "Dockerfile"]);
@@ -92,8 +92,8 @@ describe("Feature Manifest core build smoke verifier helpers", () => {
{
file: "package.json",
line: 1,
id: "toolctrl-plugins-package",
text: '{ "dependencies": { "@toolctrl/plugins": "workspace:*" } }',
id: "hivegrid-plugins-package",
text: '{ "dependencies": { "@hivegrid/plugins": "workspace:*" } }',
},
]);
});
@@ -115,12 +115,12 @@ describe("Feature Manifest core build smoke verifier helpers", () => {
it("ignores tests, docs, plugin-package files, dependency folders, TC metadata, and build output", async () => {
const root = await createFixtureRoot();
await writeFixtureFile(root, "app/entry.ts", "export const entry = true;\n");
await writeFixtureFile(root, "app/entry.test.ts", "import '@toolctrl/plugins';\n");
await writeFixtureFile(root, "app/entry.test.ts", "import '@hivegrid/plugins';\n");
await writeFixtureFile(root, "app/readme.md", "packages/plugins docs reference\n");
await writeFixtureFile(root, "packages/plugins/index.ts", "import '@toolctrl/plugins';\n");
await writeFixtureFile(root, "app/node_modules/example/index.ts", "import '@toolctrl/plugins';\n");
await writeFixtureFile(root, "app/.tc/tasks/plan.ts", "import '@toolctrl/plugins';\n");
await writeFixtureFile(root, "app/build/server.js", "import '@toolctrl/plugins';\n");
await writeFixtureFile(root, "packages/plugins/index.ts", "import '@hivegrid/plugins';\n");
await writeFixtureFile(root, "app/node_modules/example/index.ts", "import '@hivegrid/plugins';\n");
await writeFixtureFile(root, "app/.tc/tasks/plan.ts", "import '@hivegrid/plugins';\n");
await writeFixtureFile(root, "app/build/server.js", "import '@hivegrid/plugins';\n");
const result = await scanForbiddenPluginImports(root, ["app", "packages"]);
@@ -141,7 +141,7 @@ describe("Feature Manifest core build smoke verifier helpers", () => {
it("detects forbidden lines directly from source text", () => {
const diagnostics = findForbiddenPluginImports(
"const pkg = '@toolctrl/plugins';\nconst path = 'packages/plugins/feature';\n",
"const pkg = '@hivegrid/plugins';\nconst path = 'packages/plugins/feature';\n",
"app/direct.ts",
);
@@ -149,8 +149,8 @@ describe("Feature Manifest core build smoke verifier helpers", () => {
{
file: "app/direct.ts",
line: 1,
id: "toolctrl-plugins-package",
text: "const pkg = '@toolctrl/plugins';",
id: "hivegrid-plugins-package",
text: "const pkg = '@hivegrid/plugins';",
},
{
file: "app/direct.ts",
@@ -138,13 +138,25 @@ if (report) {
}
const requiredConcretePaths = [
"apps/web/app/modules/crm",
"apps/web/app/routes/admin/crm.tsx",
"apps/web/app/routes/app.$tenant/crm.tsx",
// R-P6 (AD-2): the entity-builder CRM route trees (admin/crm.tsx,
// app.$tenant/crm.tsx and their __autogenerated children) were replaced by the
// typed CRM contacts under app.$tenant/contacts.*. R-P14C then removed the
// residual `apps/web/app/modules/crm` legacy contact-row reader once its last
// consumer (EmailMarketing) was typed, so its file-existence assertion is
// dropped here. The pivots are recorded in the report's "## Update (R-P6 typed
// CRM)" and "## Update (R-P14C)" sections (the report-text reference is kept).
"apps/web/app/modules/templates/defaultEntityTemplates.ts",
"apps/web/app/utils/api/.server/EntitiesApi.ts",
// R-P6B-beta (AD-2): the generic entity-builder data layer — including the
// `apps/web/app/utils/api/.server/EntitiesApi.ts` entity API — was removed with
// the rest of the builder. The coupling stays documented in the report (the
// report-text reference above is kept); only the file-existence assertion is
// dropped here.
"apps/web/app/services/command-registry/commandRegistry.ts",
"apps/web/app/modules/emailMarketing/services/EmailMarketingService.ts",
// R-P14C (AD-2): EmailMarketingService.ts (the Entity-Builder/CrmService
// campaign consumer) was removed with the legacy campaign editor (Variante A).
// The coupling stays documented in the report's "## Update (R-P14C)" section,
// so the report-text reference above is kept; only the file-existence
// assertion is dropped here.
"apps/web/app/utils/db/users.db.server.ts",
"apps/web/public/locales/en/translations.json",
"apps/web/public/locales/de/translations.json",
@@ -155,8 +167,11 @@ for (const requiredPath of requiredConcretePaths) {
requirePath(requiredPath);
}
requireRouteGlob("apps/web/app/routes/admin/crm/*", "apps/web/app/routes/admin/crm");
requireRouteGlob("apps/web/app/routes/app.$tenant/crm/*", "apps/web/app/routes/app.$tenant/crm");
// R-P6 (AD-2): admin/crm/* and app.$tenant/crm/* route globs removed — the
// entity-builder CRM route trees were deleted in favour of the typed CRM
// contacts routes (app.$tenant/contacts.*). `requireRouteGlob` stays defined for
// the report's other surface checks and as the documented prior contract.
void requireRouteGlob;
if (isNonEmptyFile(manifestPath)) {
try {
@@ -0,0 +1,105 @@
#!/usr/bin/env node
/**
* Footgun guard (R-P6C, AGENTS DoD #16/§Querschnitt): every Prisma model that
* carries a `tenantId String` scalar MUST be listed in TENANT_SCOPED_MODELS
* (packages/cli/src/commands/tenant/models.ts). A forgotten entry silently leaks
* the model out of tenant snapshot/restore (and the withTenantScope contract)
* and previously only surfaced via the cryptic packages/cli `models.test.ts`
* failure that broke the R-P6 CI run.
*
* This dedicated check fails loudly and names the offending model + schema so
* the fix is one-line obvious, and runs project-wide in CI (.gitea/workflows/
* ci.yml) instead of only inside the cli package test bucket.
*
* The schema-parsing here is kept intentionally in sync with
* packages/cli/src/commands/tenant/models.test.ts (same model-block + `tenantId
* String` regexes) so both gates agree on what "tenant-scoped" means.
*
* NOTE on the optional search-registry check: a "models with a packages/search
* schema must be in indexed-entities" assertion was deliberately NOT added —
* search index schemas (rows, users, entities, hr-directory, …) do not 1:1 map
* to a Prisma model and most are intentionally absent from the registry, so
* such a check would produce false positives. Out of scope, left to a future CR.
*/
import { readFileSync, readdirSync } from "node:fs";
import { dirname, join } from "node:path";
import { fileURLToPath } from "node:url";
const here = dirname(fileURLToPath(import.meta.url));
const root = join(here, "..");
const schemaDir = join(root, "prisma", "schema");
const modelsFile = join(root, "packages", "cli", "src", "commands", "tenant", "models.ts");
/**
* Parse every prisma schema file and return the models that declare a
* `tenantId String` scalar (nullable `String?` included, matching the
* `^\s*tenantId\s+String` regex used by models.test.ts).
*/
function listTenantScopedSchemaModels() {
const files = readdirSync(schemaDir).filter((f) => f.endsWith(".prisma"));
const result = [];
for (const file of files) {
const text = readFileSync(join(schemaDir, file), "utf8");
const modelBlock = /model\s+(\w+)\s*\{([\s\S]*?)\n\}/g;
let m;
while ((m = modelBlock.exec(text)) !== null) {
const name = m[1];
const body = m[2];
if (/^\s*tenantId\s+String/m.test(body)) {
result.push({ model: name, schema: file });
}
}
}
return result;
}
/**
* Extract the model names registered in the TENANT_SCOPED_MODELS array of
* models.ts. Only the TENANT_SCOPED_MODELS block is scanned so that the
* GLOBAL_REFERENCED_MODELS / referencedBy `model:` keys further down the file
* are not picked up.
*/
function listRegisteredModels() {
const text = readFileSync(modelsFile, "utf8");
const start = text.indexOf("export const TENANT_SCOPED_MODELS");
if (start === -1) {
throw new Error(`could not find TENANT_SCOPED_MODELS in ${modelsFile}`);
}
const end = text.indexOf("];", start);
if (end === -1) {
throw new Error(`could not find end of TENANT_SCOPED_MODELS array in ${modelsFile}`);
}
const block = text.slice(start, end);
const names = new Set();
const entry = /model:\s*"([^"]+)"/g;
let m;
while ((m = entry.exec(block)) !== null) {
names.add(m[1]);
}
return names;
}
const schemaModels = listTenantScopedSchemaModels();
const registered = listRegisteredModels();
const missing = schemaModels.filter((m) => !registered.has(m.model));
if (missing.length > 0) {
const lines = missing.map(
(m) =>
`- Modell ${m.model} (schema ${m.schema}) hat tenantId, fehlt aber in ` +
`TENANT_SCOPED_MODELS — eintragen in packages/cli/src/commands/tenant/models.ts`,
);
process.stderr.write(
[
"FAIL cross-cutting model registry completeness",
...lines,
`Summary: ${schemaModels.length - missing.length}/${schemaModels.length} tenantId models registered, ${missing.length} missing`,
].join("\n") + "\n",
);
process.exit(1);
}
process.stdout.write(
`PASS cross-cutting model registry completeness\n` +
`Summary: ${schemaModels.length}/${schemaModels.length} tenantId models registered, 0 missing\n`,
);
@@ -0,0 +1,22 @@
import { execFileSync } from "node:child_process";
import path from "node:path";
import { describe, expect, it } from "vitest";
const root = process.cwd();
const verifierPath = path.join(root, "scripts/verify-cross-cutting-models-complete.mjs");
function runVerifier() {
return execFileSync(process.execPath, [verifierPath], {
cwd: root,
encoding: "utf8",
stdio: ["ignore", "pipe", "pipe"],
});
}
describe("verify-cross-cutting-models-complete", () => {
it("passes for the current (complete) TENANT_SCOPED_MODELS registry", () => {
const out = runVerifier();
expect(out).toContain("PASS cross-cutting model registry completeness");
expect(out).toContain("0 missing");
});
});
@@ -61,7 +61,7 @@ describe("DB Boundary ESLint DB boundary guard", () => {
assert.ok(patterns.includes("app/generated/prisma/client/*"), "missing app generated Prisma client restriction");
assert.ok(patterns.includes("@prisma/client"), "missing direct @prisma/client restriction");
assert.ok(patterns.includes("@prisma/client/*"), "missing direct @prisma/client subpath restriction");
assert.ok(!patterns.includes("@toolctrl/db/prisma-browser"), "package Prisma browser boundary must remain importable");
assert.ok(!patterns.includes("@hivegrid/db/prisma-browser"), "package Prisma browser boundary must remain importable");
});
it("keeps package-owned generated Prisma entrypoints available to db boundary files", () => {
@@ -89,6 +89,6 @@ describe("DB Boundary ESLint DB boundary guard", () => {
const patterns = dbOverrides.flatMap(({ rule }) => collectRestrictedPatterns(rule));
assert.ok(patterns.includes("react"), "missing react import restriction for apps/web/app/utils/db");
assert.ok(patterns.includes("react/*"), "missing react subpath import restriction for apps/web/app/utils/db");
assert.ok(!patterns.includes("@toolctrl/db/prisma-browser"), "db legacy boundary must allow Prisma browser type imports");
assert.ok(!patterns.includes("@hivegrid/db/prisma-browser"), "db legacy boundary must allow Prisma browser type imports");
});
});
@@ -41,5 +41,5 @@ if [[ -z "$CONTAINER_NAME" ]]; then
exit 1
fi
docker exec "$CONTAINER_NAME" sh -lc 'cd /myapp && pnpm --filter @toolctrl/db prisma:migrate:status'
docker exec "$CONTAINER_NAME" sh -lc 'cd /myapp && pnpm --filter @hivegrid/db prisma:migrate:status'
REMOTE
@@ -5,7 +5,7 @@ import { fileURLToPath } from "node:url";
export const MIGRATE_STATUS_COMMAND = Object.freeze({
command: "pnpm",
args: ["--filter", "@toolctrl/db", "prisma:migrate:status"],
args: ["--filter", "@hivegrid/db", "prisma:migrate:status"],
});
const MAX_EXCERPT_LENGTH = 1200;
@@ -42,15 +42,15 @@ function createSpawnStub({ exitCode = 0, stdout = "", stderr = "", error = null
return { spawnImpl, calls };
}
const SECRET_URL = "postgresql://ci_user:super-secret@db.example.test:5432/toolctrl";
const SECRET_URL = "postgresql://ci_user:super-secret@db.example.test:5432/hivegrid";
describe("verify-db-migrate-status", () => {
it("constructs the package-owned Prisma migrate status command", () => {
const command = buildMigrateStatusCommand();
assert.equal(command.command, "pnpm");
assert.deepEqual(command.args, ["--filter", "@toolctrl/db", "prisma:migrate:status"]);
assert.equal(command.display, "pnpm --filter @toolctrl/db prisma:migrate:status");
assert.deepEqual(command.args, ["--filter", "@hivegrid/db", "prisma:migrate:status"]);
assert.equal(command.display, "pnpm --filter @hivegrid/db prisma:migrate:status");
});
it("passes when Prisma migrate status exits successfully", async () => {
@@ -68,13 +68,13 @@ describe("verify-db-migrate-status", () => {
assert.equal(result.exitCode, 0);
assert.equal(calls.length, 1);
assert.equal(calls[0].command, "pnpm");
assert.deepEqual(calls[0].args, ["--filter", "@toolctrl/db", "prisma:migrate:status"]);
assert.deepEqual(calls[0].args, ["--filter", "@hivegrid/db", "prisma:migrate:status"]);
assert.equal(calls[0].options.cwd, "/repo");
assert.equal(calls[0].options.env.CI, "1");
assert.equal(calls[0].options.env.DATABASE_URL, SECRET_URL);
assert.match(output, /^PASS database migrate status verification/);
assert.match(output, /phase: prisma:migrate:status/);
assert.match(output, /command: pnpm --filter @toolctrl\/db prisma:migrate:status/);
assert.match(output, /command: pnpm --filter @hivegrid\/db prisma:migrate:status/);
assert.match(output, /exitCode: 0/);
});
@@ -20,6 +20,7 @@ const REQUIRED_PACKAGE_SCRIPTS = [
"verify:ui-visual",
"verify:docker-runtime-smoke",
"verify:docker-api-runtime-smoke",
"verify:docker-mcp-runtime-smoke",
"verify:docker-worker-runtime-smoke",
"verify:production-seed-artifact",
"verify:workflow-outbox-native",
@@ -61,12 +62,14 @@ const REQUIRED_CI_COMMANDS = [
"pnpm run verify:i18n",
"pnpm run test:hot-swap",
"pnpm run verify:workflow-outbox-native",
"pnpm --filter @hivegrid/mcp typecheck",
"pnpm --filter @hivegrid/mcp test",
"pnpm run build:ci",
];
const REQUIRED_DOC_MARKERS = [
"stage-and-promote",
"web`, `api`, and `worker`",
"web`, `api`, `mcp`, and `worker`",
"GET /healthz",
"GET /readyz",
"workflow_dispatch",
@@ -80,7 +83,6 @@ const REQUIRED_DOC_MARKERS = [
const REQUIRED_WORKER_MATRIX_DOCS = [
"docs/worker.md",
"docs/ops/worker-queues.md",
"docs/deployments/boiler-saas-ctrl-com.md",
];
const REQUIRED_WORKER_RUNBOOK_MARKERS = [
"OUTBOX_DISPATCHER_REQUIRED=true",
@@ -95,7 +97,19 @@ const REQUIRED_CANONICAL_WORKER_RUNBOOK_MARKERS = [
"TRANSACTIONAL_MAIL_OUTBOX_REQUIRED=true",
"pnpm run verify:plugin-runtime-live",
];
const REQUIRED_OPERATOR_CHECKLIST_MARKERS = ["B-008 is closed", "B-012", "operator-owned", "A7/#51 is backlogged", "B2"];
const REQUIRED_DEPLOY_DOC_MARKERS = [
"B-012 is not a repository code blocker",
"operator-owned host hardening",
"direct pushes to `main` must be disabled",
"pull-request CI workflow to pass",
];
const REQUIRED_ASSET_CDN_RUNBOOK_MARKERS = [
"Rollout status",
"remain parked",
"Bunny purge",
"reactivation guide",
];
const REQUIRED_SENTRY_RUNBOOK_MARKERS = ["B-008 is closed", "operator alerting item"];
const REQUIRED_GENERAL_WORKER_ENV = {
OUTBOX_DISPATCHER_ENABLED: "true",
OUTBOX_DISPATCHER_REQUIRED: "true",
@@ -225,12 +239,9 @@ export function verifyDeployReadiness(rootDir = ROOT_DIR) {
checkIncludes(read(rootDir, ".gitea/workflows/deploy.yml", result.failures), REQUIRED_DEPLOY_WORKFLOW_MARKERS, ".gitea deploy workflow", result);
checkIncludes(read(rootDir, ".gitea/workflows/ci.yml", result.failures), REQUIRED_CI_COMMANDS, ".gitea CI workflow", result);
checkIncludes(read(rootDir, "docs/deployment.md", result.failures), REQUIRED_DOC_MARKERS, "deployment docs", result);
checkIncludes(
read(rootDir, "docs/improvement-plan/OPERATOR-CHECKLIST.md", result.failures),
REQUIRED_OPERATOR_CHECKLIST_MARKERS,
"operator checklist",
result
);
checkIncludes(read(rootDir, "docs/deployment.md", result.failures), REQUIRED_DEPLOY_DOC_MARKERS, "deployment docs", result);
checkIncludes(read(rootDir, "docs/ops/asset-cdn.md", result.failures), REQUIRED_ASSET_CDN_RUNBOOK_MARKERS, "asset CDN runbook", result);
checkIncludes(read(rootDir, "docs/observability/sentry-selfhost.md", result.failures), REQUIRED_SENTRY_RUNBOOK_MARKERS, "Sentry self-host runbook", result);
checkWorkerMatrixDocs(rootDir, result);
checkCoolifyWorkerProvisionerContract(result);
@@ -23,10 +23,10 @@ function createFixture(overrides = {}) {
".gitea/workflows/deploy.yml",
".gitea/workflows/ci.yml",
"docs/deployment.md",
"docs/improvement-plan/OPERATOR-CHECKLIST.md",
"docs/ops/asset-cdn.md",
"docs/observability/sentry-selfhost.md",
"docs/worker.md",
"docs/ops/worker-queues.md",
"docs/deployments/boiler-saas-ctrl-com.md",
]) {
writeFixtureFile(rootDir, relativePath, overrides[relativePath] ?? fs.readFileSync(path.join(process.cwd(), relativePath), "utf8"));
}
@@ -66,7 +66,6 @@ describe("verify-deploy-readiness", () => {
expect(result.failures).toEqual([]);
expect(result.passes).toContain("docs/worker.md documents worker-plugin as plugin on health 9105 and admin 9205");
expect(result.passes).toContain("docs/ops/worker-queues.md documents worker-mail as mail on health 9102 and admin 9202");
expect(result.passes).toContain("docs/deployments/boiler-saas-ctrl-com.md documents worker-mail as mail on health 9102 and admin 9202");
expect(result.passes).toContain("Coolify worker provisioner sets worker-general OUTBOX_DISPATCHER_REQUIRED=true");
expect(result.passes).toContain("Coolify worker provisioner sets worker-general WORKFLOW_TRIGGER_OUTBOX_REQUIRED=true");
expect(result.passes).toContain("Coolify worker provisioner detects missing worker-general API_ACCESS_TOKEN");
@@ -131,20 +130,6 @@ describe("verify-deploy-readiness", () => {
expect(result.failures).toContain("docs/worker.md missing worker-mail row with WORKER_QUEUE_GROUP=mail, health port 9102, and admin port 9202");
});
it("fails when the deployment-specific Coolify worker matrix drifts from managed ports", () => {
const deploymentDocs = fs
.readFileSync(path.join(process.cwd(), "docs/deployments/boiler-saas-ctrl-com.md"), "utf8")
.replace(
"| `worker-mail` | `WORKER_QUEUE_GROUP=mail` | `9102` | `9202` |",
"| `worker-mail` | `WORKER_QUEUE_GROUP=mail` | `9101` | `9202` |"
);
const result = verifyDeployReadiness(createFixture({ "docs/deployments/boiler-saas-ctrl-com.md": deploymentDocs }));
expect(result.failures).toContain(
"docs/deployments/boiler-saas-ctrl-com.md missing worker-mail row with WORKER_QUEUE_GROUP=mail, health port 9102, and admin port 9202"
);
});
it("fails when canonical worker fail-loud readiness guidance is removed", () => {
const workerQueueDocs = fs
.readFileSync(path.join(process.cwd(), "docs/ops/worker-queues.md"), "utf8")
@@ -155,13 +140,25 @@ describe("verify-deploy-readiness", () => {
});
it("fails when operator-owned deploy/backlog status markers drift", () => {
const operatorChecklist = fs
.readFileSync(path.join(process.cwd(), "docs/improvement-plan/OPERATOR-CHECKLIST.md"), "utf8")
.replace("B-008 is closed", "B-008 pending")
.replace("A7/#51 is backlogged", "A7/#51 is completed");
const result = verifyDeployReadiness(createFixture({ "docs/improvement-plan/OPERATOR-CHECKLIST.md": operatorChecklist }));
const deploymentDocs = fs
.readFileSync(path.join(process.cwd(), "docs/deployment.md"), "utf8")
.replace("B-012 is not a repository code blocker", "B-012 is a repository blocker");
const assetCdnRunbook = fs
.readFileSync(path.join(process.cwd(), "docs/ops/asset-cdn.md"), "utf8")
.replace("remain parked", "are active");
const sentryRunbook = fs
.readFileSync(path.join(process.cwd(), "docs/observability/sentry-selfhost.md"), "utf8")
.replace("B-008 is closed", "B-008 pending");
const result = verifyDeployReadiness(
createFixture({
"docs/deployment.md": deploymentDocs,
"docs/ops/asset-cdn.md": assetCdnRunbook,
"docs/observability/sentry-selfhost.md": sentryRunbook,
})
);
expect(result.failures).toContain("operator checklist missing B-008 is closed");
expect(result.failures).toContain("operator checklist missing A7/#51 is backlogged");
expect(result.failures).toContain("deployment docs missing B-012 is not a repository code blocker");
expect(result.failures).toContain("asset CDN runbook missing remain parked");
expect(result.failures).toContain("Sentry self-host runbook missing B-008 is closed");
});
});
@@ -53,11 +53,11 @@ const WORKER_TARGET_PATTERN = /^FROM\s+base\s+AS\s+worker\s*$/im;
const WEB_BUILD_TARGET_PATTERN = /^FROM\s+build\s+AS\s+web-build\s*$/im;
const API_BUILD_TARGET_PATTERN = /^FROM\s+build\s+AS\s+api-build\s*$/im;
const WORKER_BUILD_TARGET_PATTERN = /^FROM\s+build\s+AS\s+worker-build\s*$/im;
const BUILD_STAGE_FORBIDDEN_APP_BUILD_PATTERN = /\bpnpm\s+(?:run\s+)?build\b|\bpnpm\s+--filter\s+@toolctrl\/web\s+build\b|\bpnpm\s+--filter\s+@toolctrl\/api\s+build\b|\bpnpm\s+--filter\s+@toolctrl\/worker\s+build\b/;
const BUILD_STAGE_FORBIDDEN_APP_BUILD_PATTERN = /\bpnpm\s+(?:run\s+)?build\b|\bpnpm\s+--filter\s+@hivegrid\/web\s+build\b|\bpnpm\s+--filter\s+@hivegrid\/api\s+build\b|\bpnpm\s+--filter\s+@hivegrid\/worker\s+build\b/;
const SHARED_BUILD_FORBIDDEN_VITE_PATTERN = /\b(?:ARG|ENV)\s+VITE_[A-Z0-9_]+/;
const WEB_BUILD_COMMAND_PATTERN = /^RUN\s+pnpm\s+--filter\s+@toolctrl\/web\s+build\s*$/im;
const API_BUILD_COMMAND_PATTERN = /^RUN\s+pnpm\s+--filter\s+@toolctrl\/api\s+build\s*$/im;
const WORKER_BUILD_COMMAND_PATTERN = /^RUN\s+pnpm\s+--filter\s+@toolctrl\/worker\s+build\s*$/im;
const WEB_BUILD_COMMAND_PATTERN = /^RUN\s+pnpm\s+--filter\s+@hivegrid\/web\s+build\s*$/im;
const API_BUILD_COMMAND_PATTERN = /^RUN\s+pnpm\s+--filter\s+@hivegrid\/api\s+build\s*$/im;
const WORKER_BUILD_COMMAND_PATTERN = /^RUN\s+pnpm\s+--filter\s+@hivegrid\/worker\s+build\s*$/im;
const WEB_RUNTIME_ARTIFACTS_TARGET_PATTERN = /^FROM\s+web-build\s+AS\s+web-runtime-artifacts\s*$/im;
const API_RUNTIME_ARTIFACTS_TARGET_PATTERN = /^FROM\s+api-build\s+AS\s+api-runtime-artifacts\s*$/im;
const WORKER_RUNTIME_ARTIFACTS_TARGET_PATTERN = /^FROM\s+worker-build\s+AS\s+worker-runtime-artifacts\s*$/im;
@@ -135,6 +135,7 @@ const WORKER_REQUIRED_COPY_PATTERNS = [
];
const WEB_REQUIRED_COPY_PATTERNS = [
["prisma.config.ts", /^COPY\s+--from=build\s+\/myapp\/prisma\.config\.ts\s+\/myapp\/prisma\.config\.ts\s*$/im],
["packages/billing", /^COPY\s+--from=build\s+\/myapp\/packages\/billing\s+\/myapp\/packages\/billing\s*$/im],
["packages/db production seed artifact", /^COPY\s+--from=build\s+\/myapp\/packages\/db\s+\/myapp\/packages\/db\s*$/im],
["packages/storage", /^COPY\s+--from=build\s+\/myapp\/packages\/storage\s+\/myapp\/packages\/storage\s*$/im],
["packages/storage/node_modules", /^COPY\s+--from=deps\s+\/myapp\/packages\/storage\/node_modules\s+\/myapp\/packages\/storage\/node_modules\s*$/im],
@@ -265,6 +266,28 @@ export function checkStartScript(rootDir) {
failures.push(`${relativePath}: must use "exec node build/server-runtime/server.js" so container signals reach the web process without pnpm indirection`);
}
// Migrations and the production seed run in the entrypoint (env-gated)
// because Coolify's pre/post_deployment_command never fired for
// docker-image applications. Removing these blocks would silently ship
// stale schemas again.
if (/^set -e\s*$/m.test(content)) {
passes.push(`${relativePath}: aborts the boot on failed migrate/seed (set -e)`);
} else {
failures.push(`${relativePath}: must set -e so a failed boot migration stops the container instead of serving a stale schema`);
}
if (/"\$MIGRATE_ON_BOOT"\s*=\s*"true"/.test(content) && /\bpnpm exec prisma migrate deploy --config prisma\.config\.ts\b/.test(content)) {
passes.push(`${relativePath}: runs prisma migrate deploy gated by MIGRATE_ON_BOOT`);
} else {
failures.push(`${relativePath}: must run "pnpm exec prisma migrate deploy --config prisma.config.ts" gated by MIGRATE_ON_BOOT=true (Coolify hooks never fired)`);
}
if (/"\$SEED_ON_BOOT"\s*=\s*"true"/.test(content) && /\bnode packages\/db\/dist\/production-seed\.server\.js\b/.test(content)) {
passes.push(`${relativePath}: runs the guarded production seed gated by SEED_ON_BOOT`);
} else {
failures.push(`${relativePath}: must run "node packages/db/dist/production-seed.server.js" gated by SEED_ON_BOOT=true`);
}
return { passes, failures, observations: [] };
}
@@ -390,10 +413,10 @@ export function checkRootManifest(rootDir) {
failures.push(`${relativePath}: missing required script "start"`);
} else {
const startCommand = manifest.scripts.start;
if (startCommand === "pnpm --filter @toolctrl/web start") {
passes.push(`${relativePath}: production start script delegates to @toolctrl/web`);
if (startCommand === "pnpm --filter @hivegrid/web start") {
passes.push(`${relativePath}: production start script delegates to @hivegrid/web`);
} else {
failures.push(`${relativePath}: script "start" must delegate to @toolctrl/web`);
failures.push(`${relativePath}: script "start" must delegate to @hivegrid/web`);
}
if (/\btsx\b/.test(startCommand)) {
@@ -534,21 +557,21 @@ export function checkDockerfileWebContract(rootDir) {
}
if (WEB_BUILD_TARGET_PATTERN.test(dockerfile) && webBuildBody && WEB_BUILD_COMMAND_PATTERN.test(webBuildBody)) {
passes.push(`${relativePath}: web-build target runs only @toolctrl/web build`);
passes.push(`${relativePath}: web-build target runs only @hivegrid/web build`);
} else {
failures.push(`${relativePath}: must define web-build target from build and run pnpm --filter @toolctrl/web build`);
failures.push(`${relativePath}: must define web-build target from build and run pnpm --filter @hivegrid/web build`);
}
if (API_BUILD_TARGET_PATTERN.test(dockerfile) && apiBuildBody && API_BUILD_COMMAND_PATTERN.test(apiBuildBody)) {
passes.push(`${relativePath}: api-build target runs only @toolctrl/api build`);
passes.push(`${relativePath}: api-build target runs only @hivegrid/api build`);
} else {
failures.push(`${relativePath}: must define api-build target from build and run pnpm --filter @toolctrl/api build`);
failures.push(`${relativePath}: must define api-build target from build and run pnpm --filter @hivegrid/api build`);
}
if (WORKER_BUILD_TARGET_PATTERN.test(dockerfile) && workerBuildBody && WORKER_BUILD_COMMAND_PATTERN.test(workerBuildBody)) {
passes.push(`${relativePath}: worker-build target runs only @toolctrl/worker build`);
passes.push(`${relativePath}: worker-build target runs only @hivegrid/worker build`);
} else {
failures.push(`${relativePath}: must define worker-build target from build and run pnpm --filter @toolctrl/worker build`);
failures.push(`${relativePath}: must define worker-build target from build and run pnpm --filter @hivegrid/worker build`);
}
if (
@@ -708,7 +731,7 @@ export function checkDockerfileWorkerContract(rootDir) {
}
if (workerBody && WORKER_RUNTIME_PATTERN.test(workerBody)) {
passes.push(`${relativePath}: worker runtime invokes @toolctrl/worker production start path`);
passes.push(`${relativePath}: worker runtime invokes @hivegrid/worker production start path`);
} else {
failures.push(`${relativePath}: worker target must invoke node apps/worker/dist/index.js directly`);
}
@@ -762,7 +785,7 @@ export function checkDockerfileApiContract(rootDir) {
}
if (apiBody && API_RUNTIME_PATTERN.test(apiBody)) {
passes.push(`${relativePath}: api runtime invokes @toolctrl/api production start path`);
passes.push(`${relativePath}: api runtime invokes @hivegrid/api production start path`);
} else {
failures.push(`${relativePath}: api target must invoke node apps/api/dist/server.js directly`);
}
@@ -25,25 +25,25 @@ ADD prisma prisma
COPY apps/api/package.json apps/api/package.json
COPY apps/web/package.json apps/web/package.json
COPY apps/worker/package.json apps/worker/package.json
RUN --mount=type=cache,id=toolctrl-pnpm-store,target=/pnpm/store \\
RUN --mount=type=cache,id=hivegrid-pnpm-store,target=/pnpm/store \\
pnpm fetch --frozen-lockfile
RUN --mount=type=cache,id=toolctrl-pnpm-store,target=/pnpm/store \\
RUN --mount=type=cache,id=hivegrid-pnpm-store,target=/pnpm/store \\
pnpm install --frozen-lockfile --prod=false --offline
FROM base AS production-deps
WORKDIR /myapp
COPY --from=deps /myapp /myapp
RUN pnpm prune --prod
FROM base AS build
RUN pnpm --filter @toolctrl/db prisma:generate
RUN pnpm --filter @toolctrl/db build
RUN pnpm --filter @hivegrid/db prisma:generate
RUN pnpm --filter @hivegrid/db build
FROM build AS web-build
ARG VITE_SENTRY_DSN_WEB=""
ENV VITE_SENTRY_DSN_WEB="\${VITE_SENTRY_DSN_WEB}"
RUN pnpm --filter @toolctrl/web build
RUN pnpm --filter @hivegrid/web build
FROM build AS api-build
RUN pnpm --filter @toolctrl/api build
RUN pnpm --filter @hivegrid/api build
FROM build AS worker-build
RUN pnpm --filter @toolctrl/worker build
RUN pnpm --filter @hivegrid/worker build
FROM web-build AS web-runtime-artifacts
RUN find /myapp/build /myapp/apps/web/build -type f -name '*.map' -delete
FROM api-build AS api-runtime-artifacts
@@ -92,6 +92,7 @@ EXPOSE 8080
COPY --from=web-runtime-artifacts /myapp/build /myapp/build
COPY --from=web-runtime-artifacts /myapp/build/server-runtime /myapp/build/server-runtime
COPY --from=build /myapp/prisma.config.ts /myapp/prisma.config.ts
COPY --from=build /myapp/packages/billing /myapp/packages/billing
COPY --from=build /myapp/packages/db /myapp/packages/db
COPY --from=build /myapp/packages/storage /myapp/packages/storage
COPY --from=deps /myapp/packages/storage/node_modules /myapp/packages/storage/node_modules
@@ -188,8 +189,8 @@ const VALID_DOCKER_COMPOSE_STAGING = `# docker compose -f docker-compose.yml -f
services:
worker-general:
environment:
- DATABASE_URL=postgres://boilerplate:boilerplate@pgbouncer:6432/boilerplate_validation?pgbouncer=true
- DIRECT_URL=postgres://boilerplate:boilerplate@postgres:5432/boilerplate_validation
- DATABASE_URL=postgres://hivegrid:hivegrid@pgbouncer:6432/hivegrid_validation?pgbouncer=true
- DIRECT_URL=postgres://hivegrid:hivegrid@postgres:5432/hivegrid_validation
- OUTBOX_DISPATCHER_ENABLED=true
- OUTBOX_DISPATCHER_REQUIRED=true
- WORKFLOW_TRIGGER_OUTBOX_ENABLED=true
@@ -199,29 +200,29 @@ services:
condition: service_healthy
worker-mail:
environment:
- DATABASE_URL=postgres://boilerplate:boilerplate@pgbouncer:6432/boilerplate_validation?pgbouncer=true
- DIRECT_URL=postgres://boilerplate:boilerplate@postgres:5432/boilerplate_validation
- DATABASE_URL=postgres://hivegrid:hivegrid@pgbouncer:6432/hivegrid_validation?pgbouncer=true
- DIRECT_URL=postgres://hivegrid:hivegrid@postgres:5432/hivegrid_validation
depends_on:
pgbouncer:
condition: service_healthy
worker-import:
environment:
- DATABASE_URL=postgres://boilerplate:boilerplate@pgbouncer:6432/boilerplate_validation?pgbouncer=true
- DIRECT_URL=postgres://boilerplate:boilerplate@postgres:5432/boilerplate_validation
- DATABASE_URL=postgres://hivegrid:hivegrid@pgbouncer:6432/hivegrid_validation?pgbouncer=true
- DIRECT_URL=postgres://hivegrid:hivegrid@postgres:5432/hivegrid_validation
depends_on:
pgbouncer:
condition: service_healthy
worker-webhook:
environment:
- DATABASE_URL=postgres://boilerplate:boilerplate@pgbouncer:6432/boilerplate_validation?pgbouncer=true
- DIRECT_URL=postgres://boilerplate:boilerplate@postgres:5432/boilerplate_validation
- DATABASE_URL=postgres://hivegrid:hivegrid@pgbouncer:6432/hivegrid_validation?pgbouncer=true
- DIRECT_URL=postgres://hivegrid:hivegrid@postgres:5432/hivegrid_validation
depends_on:
pgbouncer:
condition: service_healthy
worker-plugin:
environment:
- DATABASE_URL=postgres://boilerplate:boilerplate@pgbouncer:6432/boilerplate_validation?pgbouncer=true
- DIRECT_URL=postgres://boilerplate:boilerplate@postgres:5432/boilerplate_validation
- DATABASE_URL=postgres://hivegrid:hivegrid@pgbouncer:6432/hivegrid_validation?pgbouncer=true
- DIRECT_URL=postgres://hivegrid:hivegrid@postgres:5432/hivegrid_validation
depends_on:
pgbouncer:
condition: service_healthy
@@ -279,7 +280,28 @@ function createFixture(overrides = {}) {
"",
].join("\n"),
);
writeFile(rootDir, "start.sh", overrides.startScript ?? "#!/bin/sh\nexec node build/server-runtime/server.js\n");
writeFile(
rootDir,
"start.sh",
overrides.startScript ??
[
"#!/bin/sh",
"set -e",
"",
'if [ "$MIGRATE_ON_BOOT" = "true" ]; then',
' echo "[boot] prisma migrate deploy"',
" pnpm exec prisma migrate deploy --config prisma.config.ts",
"fi",
"",
'if [ "$SEED_ON_BOOT" = "true" ]; then',
' echo "[boot] production seed"',
" node packages/db/dist/production-seed.server.js",
"fi",
"",
"exec node build/server-runtime/server.js",
"",
].join("\n"),
);
writeFile(rootDir, "pnpm-workspace.yaml", overrides.workspace ?? "packages:\n - apps/*\n");
writeJson(
rootDir,
@@ -289,9 +311,9 @@ function createFixture(overrides = {}) {
scripts: {
build: "vite build && node scripts/build-web-server.mjs",
lint: "eslint .",
test: "pnpm --filter @toolctrl/web test",
test: "pnpm --filter @hivegrid/web test",
typecheck: "tsc -b",
start: "pnpm --filter @toolctrl/web start",
start: "pnpm --filter @hivegrid/web start",
},
},
);
@@ -299,7 +321,7 @@ function createFixture(overrides = {}) {
rootDir,
"apps/web/package.json",
overrides.webPackage ?? {
name: "@toolctrl/web",
name: "@hivegrid/web",
scripts: {
start: "node ../../build/server-runtime/server.js",
},
@@ -309,7 +331,7 @@ function createFixture(overrides = {}) {
rootDir,
"apps/api/package.json",
overrides.apiPackage ?? {
name: "@toolctrl/api",
name: "@hivegrid/api",
scripts: {
build: "tsc -p tsconfig.json",
start: "node dist/server.js",
@@ -320,7 +342,7 @@ function createFixture(overrides = {}) {
rootDir,
"apps/worker/package.json",
overrides.workerPackage ?? {
name: "@toolctrl/worker",
name: "@hivegrid/worker",
scripts: {
start: "node dist/index.js",
health: "node dist/health.js",
@@ -360,17 +382,21 @@ describe("verify-docker-baseline", () => {
assert.ok(result.passes.some((pass) => pass === "Dockerfile: copies build/server-runtime into web image"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: build target leaves web, api, and worker app builds to split stages"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: build target keeps VITE build args out of api/worker cache paths"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: web-build target runs only @toolctrl/web build"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: api-build target runs only @toolctrl/api build"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: worker-build target runs only @toolctrl/worker build"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: web-build target runs only @hivegrid/web build"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: api-build target runs only @hivegrid/api build"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: worker-build target runs only @hivegrid/worker build"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: target-specific runtime artifacts remove web, api, and worker sourcemaps before runtime COPY"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: web target exposes port 8080"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: web target avoids recursive runtime chown"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: web target copies prisma.config.ts"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: web target copies packages/billing"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: web target copies packages/db production seed artifact"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: web target copies packages/storage"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: web target copies packages/url"));
assert.ok(result.passes.some((pass) => pass === "start.sh: execs the production start process for container signal handling"));
assert.ok(result.passes.some((pass) => pass === "start.sh: aborts the boot on failed migrate/seed (set -e)"));
assert.ok(result.passes.some((pass) => pass === "start.sh: runs prisma migrate deploy gated by MIGRATE_ON_BOOT"));
assert.ok(result.passes.some((pass) => pass === "start.sh: runs the guarded production seed gated by SEED_ON_BOOT"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: defines named worker target from base"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: worker target copies apps/worker/dist"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: worker target copies prisma.config.ts"));
@@ -382,7 +408,7 @@ describe("verify-docker-baseline", () => {
assert.ok(result.passes.some((pass) => pass === "Dockerfile: api target exposes port 8080"));
assert.ok(result.passes.some((pass) => pass === "Dockerfile: api target avoids recursive runtime chown"));
assert.ok(result.passes.some((pass) => pass === "package.json: script \"typecheck\" is defined"));
assert.ok(result.passes.some((pass) => pass === "package.json: production start script delegates to @toolctrl/web"));
assert.ok(result.passes.some((pass) => pass === "package.json: production start script delegates to @hivegrid/web"));
assert.ok(result.passes.some((pass) => pass === "apps/web/package.json: owns production web server start command"));
assert.ok(result.passes.some((pass) => pass === "package.json: production start script does not use tsx"));
assert.ok(result.passes.some((pass) => pass === "apps/api/package.json: production start script uses node"));
@@ -480,7 +506,7 @@ describe("verify-docker-baseline", () => {
it("fails when the deps target installs without a BuildKit pnpm store cache", () => {
const rootDir = createFixture({
dockerfile: VALID_DOCKERFILE.replace(
"RUN --mount=type=cache,id=toolctrl-pnpm-store,target=/pnpm/store \\\n pnpm install --frozen-lockfile --prod=false --offline",
"RUN --mount=type=cache,id=hivegrid-pnpm-store,target=/pnpm/store \\\n pnpm install --frozen-lockfile --prod=false --offline",
"RUN pnpm install --frozen-lockfile --prod=false"
),
});
@@ -493,7 +519,7 @@ describe("verify-docker-baseline", () => {
it("fails when the deps target does not fetch before offline install", () => {
const rootDir = createFixture({
dockerfile: VALID_DOCKERFILE.replace(
"RUN --mount=type=cache,id=toolctrl-pnpm-store,target=/pnpm/store \\\n pnpm fetch --frozen-lockfile\n",
"RUN --mount=type=cache,id=hivegrid-pnpm-store,target=/pnpm/store \\\n pnpm fetch --frozen-lockfile\n",
""
),
});
@@ -621,6 +647,16 @@ describe("verify-docker-baseline", () => {
assert.match(result.failures.join("\n"), /start\.sh: must use "exec node build\/server-runtime\/server\.js" so container signals reach the web process without pnpm indirection/);
});
it("fails when start.sh drops the boot-gated migrate or seed", () => {
const rootDir = createFixture({ startScript: "#!/bin/sh\nexec node build/server-runtime/server.js\n" });
const result = checkStartScript(rootDir);
assert.match(result.failures.join("\n"), /start\.sh: must set -e/);
assert.match(result.failures.join("\n"), /gated by MIGRATE_ON_BOOT=true/);
assert.match(result.failures.join("\n"), /gated by SEED_ON_BOOT=true/);
});
it("fails when the root production start script uses tsx", () => {
const rootDir = createFixture({
rootPackage: {
@@ -628,7 +664,7 @@ describe("verify-docker-baseline", () => {
scripts: {
build: "vite build && node scripts/build-web-server.mjs",
lint: "eslint .",
test: "pnpm --filter @toolctrl/web test",
test: "pnpm --filter @hivegrid/web test",
typecheck: "tsc -b",
start: "tsx server/server.ts",
},
@@ -637,7 +673,7 @@ describe("verify-docker-baseline", () => {
const result = verifyDockerBaseline(rootDir);
assert.match(result.failures.join("\n"), /package\.json: script "start" must delegate to @toolctrl\/web/);
assert.match(result.failures.join("\n"), /package\.json: script "start" must delegate to @hivegrid\/web/);
assert.match(result.failures.join("\n"), /package\.json: script "start" must not use tsx for web production runtime/);
});
@@ -766,7 +802,7 @@ describe("verify-docker-baseline", () => {
it("fails when the shared build stage runs app builds instead of split build targets", () => {
const rootDir = createFixture({
dockerfile: VALID_DOCKERFILE.replace("RUN pnpm --filter @toolctrl/db build\n", "RUN pnpm --filter @toolctrl/db build\nRUN pnpm build\n"),
dockerfile: VALID_DOCKERFILE.replace("RUN pnpm --filter @hivegrid/db build\n", "RUN pnpm --filter @hivegrid/db build\nRUN pnpm build\n"),
});
const result = checkDockerfileWebContract(rootDir);
@@ -776,7 +812,7 @@ describe("verify-docker-baseline", () => {
it("fails when the shared build stage owns Vite build args", () => {
const rootDir = createFixture({
dockerfile: VALID_DOCKERFILE.replace("RUN pnpm --filter @toolctrl/db prisma:generate\n", 'ARG VITE_SENTRY_DSN_WEB=""\nRUN pnpm --filter @toolctrl/db prisma:generate\n'),
dockerfile: VALID_DOCKERFILE.replace("RUN pnpm --filter @hivegrid/db prisma:generate\n", 'ARG VITE_SENTRY_DSN_WEB=""\nRUN pnpm --filter @hivegrid/db prisma:generate\n'),
});
const result = checkDockerfileWebContract(rootDir);
@@ -823,7 +859,7 @@ COPY --from=build /myapp/build /myapp/build
scripts: {
build: "vite build",
lint: "eslint .",
test: "pnpm --filter @toolctrl/web test",
test: "pnpm --filter @hivegrid/web test",
},
},
});
@@ -852,7 +888,7 @@ COPY --from=build /myapp/build /myapp/build
it("fails when worker production scripts use tsx", () => {
const rootDir = createFixture({
workerPackage: {
name: "@toolctrl/worker",
name: "@hivegrid/worker",
scripts: {
start: "tsx src/index.ts",
health: "tsx src/health.ts",
@@ -1,384 +0,0 @@
#!/usr/bin/env node
/* eslint-disable no-console */
import { spawn } from "node:child_process";
import { createHash } from "node:crypto";
import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
import path from "node:path";
import { fileURLToPath } from "node:url";
const __dirname = path.dirname(fileURLToPath(import.meta.url));
const repoRoot = path.resolve(__dirname, "..");
export const reportPath = path.join(repoRoot, ".tc/baselines/docs-inventory/baseline-health.md");
const ignoredDirectoryNames = new Set([
".git",
".cache",
".next",
".react-router",
".tc",
".turbo",
".vite",
"build",
"cache",
"coverage",
"dist",
"generated",
"node_modules",
]);
const ignoredFileNames = new Set(["package-lock.json", "pnpm-lock.yaml", "yarn.lock"]);
export const docsInventoryInventoryScanRoots = ["docs/feature-inventory.md", "docs/env-access-inventory.md", "docs/deployment.md"];
export const docsInventoryInventoryPatterns = [
{ id: "feature-inventory-signal", pattern: /\b(?:feature|manifest|core|plugin|remove|inventory)\b/gi },
{ id: "env-access-signal", pattern: /\b(?:env|environment|secret|DATABASE_URL|REDIS_URL|API[_-]?KEY|TOKEN|access)\b/gi },
{ id: "deployment-signal", pattern: /\b(?:deploy(?:ment)?|Docker|Coolify|Gitea|registry|workflow|CI|production)\b/gi },
{ id: "risk-marker", pattern: /\b(?:TODO|TBD|FIXME|follow-up|manual|missing|required)\b/gi },
];
export const gates = [
{ id: "typecheck", command: "pnpm", args: ["run", "typecheck"] },
{ id: "lint", command: "pnpm", args: ["run", "lint"] },
{
id: "vitest-docsInventory-smoke",
command: "pnpm",
args: ["exec", "vitest", "run", "scripts/check-api-inventory.test.ts", "apps/web/app/application/featureManifests.test.ts"],
},
{ id: "docsInventory-status-authority-guard", type: "docsInventory-status-authority-guard" },
{ id: "docsInventory-docs-inventory", type: "docsInventory-docs-inventory" },
];
function shellCommand(gate) {
if (gate.type === "docsInventory-status-authority-guard") return "static Docs Inventory status authority guard";
if (gate.type === "docsInventory-docs-inventory") return "read-only Docs Inventory docs inventory";
return [gate.command, ...gate.args].join(" ");
}
export const docsInventoryStatusAuthorityContracts = [
{
path: "docs/agent-entrypoints.md",
requiredMarkers: [
"Interpreting old improvement-plan status, handoffs, or verification notes:",
"read `docs/improvement-plan/CURRENT-STATUS.md` first",
"canonical docs it links",
],
},
{
path: "docs/improvement-plan/README.md",
requiredMarkers: [
"Historical plan archive",
"Do not treat the files here\n> as live autonomous-agent instructions",
"`CURRENT-STATUS.md` lesen",
],
forbiddenMarkers: ["die jeweils neueste Session-Zusammenfassung"],
},
{
path: "docs/improvement-plan/CURRENT-STATUS.md",
requiredMarkers: [
"READINESS_AUTHORITY: status-source map",
"historical improvement-plan files must not be used as live production\n> evidence",
"docs/improvement-plan/archive/handoffs/HANDOFF-*.md",
"When a historical file and a canonical source disagree, the canonical source\nwins",
],
},
{
path: "docs/improvement-plan/archive/handoffs/README.md",
requiredMarkers: [
"Historical Handoffs",
"They are retained for audit and context only",
"Do not execute instructions from these archived files directly",
"verify the current status through the canonical docs linked\nabove",
],
},
];
function outputFingerprint(output) {
const normalized = output
.split(/\r?\n/)
.map((line) => line.trim())
.filter(Boolean)
.slice(-40)
.join("\n");
return { hash: createHash("sha256").update(output).digest("hex").slice(0, 12), excerpt: normalized.slice(0, 1200) || "(no output)" };
}
function parseNumber(value) {
const parsed = Number.parseInt(value, 10);
return Number.isFinite(parsed) ? parsed : 0;
}
function conservativeFailureCount(count, output) {
return count > 0 ? count : output.trim() ? 1 : 0;
}
function countVitestFailures(output) {
const failedTests = output.match(/Tests\s+(\d+)\s+failed/i);
if (failedTests) return parseNumber(failedTests[1]);
const failedFiles = output.match(/Test Files\s+(\d+)\s+failed/i);
return failedFiles ? parseNumber(failedFiles[1]) : 0;
}
export function failureCount(gateId, stdout, stderr, exitCode = 1) {
if (exitCode === 0 || gateId === "docsInventory-docs-inventory") return 0;
const output = `${stdout}\n${stderr}`;
if (gateId === "typecheck") return conservativeFailureCount((output.match(/error TS\d+/g) ?? []).length, output);
if (gateId === "lint") {
const problemsMatch = output.match(/✖\s+(\d+)\s+problems?\s+\((\d+)\s+errors?/i);
const compactMatch = output.match(/(\d+)\s+errors?/i);
return conservativeFailureCount(problemsMatch ? parseNumber(problemsMatch[2]) : compactMatch ? parseNumber(compactMatch[1]) : 0, output);
}
if (gateId === "vitest-docsInventory-smoke") return conservativeFailureCount(countVitestFailures(output), output);
return output.trim() ? 1 : 0;
}
function runShellGate(gate) {
return new Promise((resolve) => {
const startedAt = Date.now();
const child = spawn(gate.command, gate.args, { cwd: repoRoot, env: { ...process.env, CI: "1" }, shell: false });
let stdout = "";
let stderr = "";
child.stdout.on("data", (chunk) => {
stdout += chunk;
});
child.stderr.on("data", (chunk) => {
stderr += chunk;
});
child.on("error", (error) => {
stderr += `\n${error.message}`;
});
child.on("close", (code) => {
const output = `${stdout}\n${stderr}`;
resolve({
id: gate.id,
command: shellCommand(gate),
exitCode: code ?? 1,
durationMs: Date.now() - startedAt,
failureCount: failureCount(gate.id, stdout, stderr, code ?? 1),
fingerprint: outputFingerprint(output),
});
});
});
}
function isIgnoredDirectory(name, relativePath) {
return ignoredDirectoryNames.has(name) || ignoredDirectoryNames.has(relativePath) || name.endsWith(".cache");
}
function isIgnoredFile(name) {
return ignoredFileNames.has(name) || name.endsWith(".generated.ts") || name.endsWith(".generated.tsx") || name.endsWith(".min.js") || name.endsWith(".map");
}
async function rootExists(root, rootRelativePath) {
try {
await stat(path.join(root, rootRelativePath));
return true;
} catch (error) {
if (error?.code === "ENOENT") return false;
throw error;
}
}
async function collectFiles(root, rootRelativePath) {
const absoluteRoot = path.join(root, rootRelativePath);
const rootStat = await stat(absoluteRoot);
if (rootStat.isFile()) return [absoluteRoot];
const files = [];
async function walk(directory) {
const entries = await readdir(directory, { withFileTypes: true });
for (const entry of entries) {
const absolutePath = path.join(directory, entry.name);
const relativePath = path.relative(root, absolutePath).split(path.sep).join("/");
if (entry.isDirectory()) {
if (isIgnoredDirectory(entry.name, relativePath)) continue;
await walk(absolutePath);
} else if (entry.isFile() && /\.(?:mdx?|json)$/.test(entry.name) && !isIgnoredFile(entry.name)) {
files.push(absolutePath);
}
}
}
await walk(absoluteRoot);
return files;
}
export async function runDocsInventoryInventory(root = repoRoot) {
const existingRoots = [];
const missingRoots = [];
for (const rootRelativePath of docsInventoryInventoryScanRoots) {
if (await rootExists(root, rootRelativePath)) existingRoots.push(rootRelativePath);
else missingRoots.push(rootRelativePath);
}
const files = (await Promise.all(existingRoots.map((rootRelativePath) => collectFiles(root, rootRelativePath)))).flat();
const counts = new Map(docsInventoryInventoryPatterns.map(({ id }) => [id, 0]));
const matches = [];
for (const file of files) {
const relativeFile = path.relative(root, file).split(path.sep).join("/");
const lines = (await readFile(file, "utf8")).split(/\r?\n/);
lines.forEach((line, index) => {
for (const { id, pattern } of docsInventoryInventoryPatterns) {
pattern.lastIndex = 0;
const found = line.match(pattern);
if (!found) continue;
counts.set(id, (counts.get(id) ?? 0) + found.length);
matches.push(`${relativeFile}:${index + 1}: [${id}] ${line.trim()}`);
}
});
}
return { roots: existingRoots, missingRoots, filesScanned: files.length, counts: Object.fromEntries(counts.entries()), totalMatches: matches.length, matches };
}
export async function runDocsInventoryStatusAuthorityGuard(root = repoRoot) {
const failures = [];
const checked = [];
for (const contract of docsInventoryStatusAuthorityContracts) {
const absolutePath = path.join(root, contract.path);
let contents = "";
try {
contents = await readFile(absolutePath, "utf8");
} catch (error) {
if (error?.code === "ENOENT") {
failures.push(`${contract.path}: missing status-authority-controlled document`);
continue;
}
throw error;
}
checked.push(contract.path);
for (const marker of contract.requiredMarkers) {
if (!contents.includes(marker)) failures.push(`${contract.path}: missing marker "${marker}"`);
}
for (const marker of contract.forbiddenMarkers ?? []) {
if (contents.includes(marker)) failures.push(`${contract.path}: forbidden stale marker "${marker}"`);
}
}
return { checked, failures };
}
async function runDocsInventoryStatusAuthorityGuardGate(gate) {
const startedAt = Date.now();
const guard = await runDocsInventoryStatusAuthorityGuard(repoRoot);
const output = [
`Docs Inventory status authority guard checked: ${guard.checked.join(", ") || "(none)"}`,
`failures: ${guard.failures.length}`,
...guard.failures,
].join("\n");
return {
id: gate.id,
command: shellCommand(gate),
exitCode: guard.failures.length > 0 ? 1 : 0,
durationMs: Date.now() - startedAt,
failureCount: guard.failures.length,
statusAuthorityGuard: guard,
fingerprint: outputFingerprint(output),
};
}
async function runDocsInventoryInventoryGate(gate) {
const startedAt = Date.now();
const inventory = await runDocsInventoryInventory(repoRoot);
const outputLines = [
`Docs Inventory docs inventory scanned roots: ${inventory.roots.join(", ") || "(none)"}`,
`Docs Inventory docs inventory missing roots skipped: ${inventory.missingRoots.join(", ") || "(none)"}`,
`files scanned: ${inventory.filesScanned}`,
...Object.entries(inventory.counts).map(([id, count]) => `${id}: ${count}`),
`total matches: ${inventory.totalMatches}`,
...inventory.matches.slice(0, 240),
];
if (inventory.matches.length > 240) outputLines.push(`... ${inventory.matches.length - 240} additional matches omitted`);
const output = outputLines.join("\n");
return { id: gate.id, command: shellCommand(gate), exitCode: 0, durationMs: Date.now() - startedAt, failureCount: 0, inventory, fingerprint: outputFingerprint(output) };
}
async function runGate(gate) {
if (gate.type === "docsInventory-status-authority-guard") return runDocsInventoryStatusAuthorityGuardGate(gate);
if (gate.type === "docsInventory-docs-inventory") return runDocsInventoryInventoryGate(gate);
return runShellGate(gate);
}
function renderStatusAuthorityGuard(result) {
if (!result.statusAuthorityGuard) return [];
return [
"- Status Authority Docs Checked: " + (result.statusAuthorityGuard.checked.join(", ") || "(none)"),
`- Status Authority Guard Failures: ${result.statusAuthorityGuard.failures.length}`,
...result.statusAuthorityGuard.failures.map((failure) => ` - ${failure}`),
];
}
function renderInventoryCounts(result) {
if (!result.inventory) return [];
return [
"- Inventory Roots: " + (result.inventory.roots.join(", ") || "(none)"),
"- Missing Roots Skipped: " + (result.inventory.missingRoots.join(", ") || "(none)"),
`- Files Scanned: ${result.inventory.filesScanned}`,
"- Inventory Counts:",
...Object.entries(result.inventory.counts).map(([id, count]) => ` - ${id}: ${count}`),
`- Total Inventory Matches: ${result.inventory.totalMatches}`,
];
}
export function renderReport(results) {
const lines = [
"# Docs Inventory Baseline Health",
"",
`Generated: ${new Date().toISOString()}`,
"",
"This report captures non-E2E baseline gates for Docs Inventory baseline. The runner exits non-zero when any shell gate fails; inventory gates remain read-only unless the runner itself fails.",
"The shell gates run with CI=1 and fingerprint TypeScript, ESLint, and focused Vitest smoke coverage. The Docs Inventory docs inventory gate is read-only and fingerprints milestone-safe feature, environment access, deployment, and risk markers across configured docs while reporting missing optional roots as skipped.",
"",
];
for (const result of results) {
lines.push(
`## ${result.id}`,
"",
`- Command: \`${result.command}\``,
`- Exitcode: ${result.exitCode}`,
`- Failure Count: ${result.failureCount}`,
`- Duration: ${result.durationMs}ms`,
`- Output Fingerprint: ${result.fingerprint.hash}`,
...renderStatusAuthorityGuard(result),
...renderInventoryCounts(result),
"",
"```text",
result.fingerprint.excerpt,
"```",
"",
);
}
return `${lines.join("\n")}\n`;
}
async function writeFailureReport(error) {
await mkdir(path.dirname(reportPath), { recursive: true });
const output = error?.stack ?? String(error);
await writeFile(
reportPath,
renderReport([{ id: "runner-error", command: "node scripts/verify-docs-inventory-baseline.mjs", exitCode: 1, durationMs: 0, failureCount: 1, fingerprint: outputFingerprint(output) }]),
"utf8",
);
}
async function main() {
const results = [];
for (const gate of gates) {
console.log(`Running ${gate.id}: ${shellCommand(gate)}`);
results.push(await runGate(gate));
}
await mkdir(path.dirname(reportPath), { recursive: true });
await writeFile(reportPath, renderReport(results), "utf8");
console.log(`Wrote ${path.relative(repoRoot, reportPath)}`);
const failedResults = results.filter((result) => result.exitCode !== 0 || result.failureCount > 0);
if (failedResults.length > 0) {
console.error(`Baseline gates failed: ${failedResults.map((result) => result.id).join(", ")}`);
process.exitCode = 1;
}
}
if (process.argv[1] === fileURLToPath(import.meta.url)) {
main().catch(async (error) => {
console.error(error);
try {
await writeFailureReport(error);
} finally {
process.exit(1);
}
});
}
@@ -1,184 +0,0 @@
import { mkdtemp, mkdir, writeFile } from "node:fs/promises";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { describe, expect, it } from "vitest";
import {
docsInventoryInventoryScanRoots,
docsInventoryStatusAuthorityContracts,
failureCount,
gates,
renderReport,
reportPath,
runDocsInventoryInventory,
runDocsInventoryStatusAuthorityGuard,
} from "./verify-docs-inventory-baseline.mjs";
const focusedSmokeTargets = ["scripts/check-api-inventory.test.ts", "apps/web/app/application/featureManifests.test.ts"];
describe("Docs Inventory baseline runner configuration", () => {
it("defines the required non-E2E gates and report path", () => {
expect(reportPath).toMatch(/\.tc\/baselines\/docs-inventory\/baseline-health\.md$/);
expect(gates.map((gate) => gate.id)).toEqual(["typecheck", "lint", "vitest-docsInventory-smoke", "docsInventory-status-authority-guard", "docsInventory-docs-inventory"]);
expect(gates.some((gate) => gate.args?.some((arg) => /playwright|cypress|browser|e2e/i.test(arg)))).toBe(false);
expect(docsInventoryInventoryScanRoots).toEqual(["docs/feature-inventory.md", "docs/env-access-inventory.md", "docs/deployment.md"]);
});
it("keeps focused smoke tests in the Vitest gate", () => {
const vitestGate = gates.find((gate) => gate.id === "vitest-docsInventory-smoke");
expect(vitestGate?.args).toEqual(["exec", "vitest", "run", ...focusedSmokeTargets]);
});
});
describe("Docs Inventory baseline runner failure counting", () => {
it("counts failed typecheck diagnostics conservatively", () => {
expect(failureCount("typecheck", "src/a.ts(1,1): error TS2307: Cannot find module\nsrc/b.ts(2,2): error TS2322: Type mismatch", "", 1)).toBe(2);
expect(failureCount("typecheck", "Build failed", "", 1)).toBe(1);
});
it("counts failed ESLint diagnostics conservatively", () => {
expect(failureCount("lint", "✖ 4 problems (3 errors, 1 warning)", "", 1)).toBe(3);
expect(failureCount("lint", "2 errors and 0 warnings", "", 1)).toBe(2);
expect(failureCount("lint", "Lint crashed", "", 1)).toBe(1);
});
it("counts failed Vitest diagnostics conservatively", () => {
expect(failureCount("vitest-docsInventory-smoke", "Tests 2 failed | 8 passed", "", 1)).toBe(2);
expect(failureCount("vitest-docsInventory-smoke", "Test Files 1 failed | 2 passed", "", 1)).toBe(1);
expect(failureCount("vitest-docsInventory-smoke", "Vitest crashed", "", 1)).toBe(1);
});
it("returns zero for clean exits and read-only inventory gates", () => {
expect(failureCount("lint", "warning only", "", 0)).toBe(0);
expect(failureCount("docsInventory-docs-inventory", "total matches: 12", "", 1)).toBe(0);
});
});
describe("Docs Inventory status authority guard", () => {
it("requires current-status routing markers on historical and canonical docs", async () => {
const root = await mkdtemp(join(tmpdir(), "docsInventory-status-authority-"));
for (const contract of docsInventoryStatusAuthorityContracts) {
const absolutePath = join(root, contract.path);
await mkdir(join(absolutePath, ".."), { recursive: true });
await writeFile(absolutePath, contract.requiredMarkers.join("\n\n"), "utf8");
}
const guard = await runDocsInventoryStatusAuthorityGuard(root);
expect(guard.checked).toEqual(docsInventoryStatusAuthorityContracts.map((contract) => contract.path));
expect(guard.failures).toEqual([]);
});
it("fails when old handoff/status docs can look authoritative again", async () => {
const root = await mkdtemp(join(tmpdir(), "docsInventory-status-authority-fail-"));
await mkdir(join(root, "docs", "improvement-plan"), { recursive: true });
await writeFile(join(root, "docs", "improvement-plan", "README.md"), "die jeweils neueste Session-Zusammenfassung", "utf8");
const guard = await runDocsInventoryStatusAuthorityGuard(root);
expect(guard.failures).toContain("docs/agent-entrypoints.md: missing status-authority-controlled document");
expect(guard.failures).toContain('docs/improvement-plan/README.md: missing marker "Historical plan archive"');
expect(guard.failures).toContain('docs/improvement-plan/README.md: forbidden stale marker "die jeweils neueste Session-Zusammenfassung"');
expect(guard.failures).toContain("docs/improvement-plan/CURRENT-STATUS.md: missing status-authority-controlled document");
expect(guard.failures).toContain("docs/improvement-plan/archive/handoffs/README.md: missing status-authority-controlled document");
});
});
describe("Docs Inventory docs inventory scan", () => {
it("scans configured docs, counts baseline terms, and ignores dependency and TC paths", async () => {
const root = await mkdtemp(join(tmpdir(), "docsInventory-baseline-inventory-"));
await mkdir(join(root, "docs"), { recursive: true });
await mkdir(join(root, "docs", "node_modules", "ignored"), { recursive: true });
await mkdir(join(root, "docs", ".tc"), { recursive: true });
await mkdir(join(root, "docs", "generated"), { recursive: true });
await writeFile(join(root, "docs", "feature-inventory.md"), "Feature manifest core plugin remove inventory", "utf8");
await writeFile(join(root, "docs", "env-access-inventory.md"), "Environment secret DATABASE_URL REDIS_URL API_KEY TOKEN access required", "utf8");
await writeFile(join(root, "docs", "deployment.md"), "Deploy Docker Coolify Gitea registry workflow CI production TODO", "utf8");
await writeFile(join(root, "docs", "node_modules", "ignored", "ignored.md"), "feature secret deploy TODO", "utf8");
await writeFile(join(root, "docs", ".tc", "ignored.md"), "feature secret deploy TODO", "utf8");
await writeFile(join(root, "docs", "generated", "ignored.md"), "feature secret deploy TODO", "utf8");
const inventory = await runDocsInventoryInventory(root);
const allMatches = inventory.matches.join("\n");
expect(inventory.roots).toEqual(["docs/feature-inventory.md", "docs/env-access-inventory.md", "docs/deployment.md"]);
expect(inventory.missingRoots).toEqual([]);
expect(inventory.filesScanned).toBe(3);
expect(inventory.counts).toMatchObject({
"feature-inventory-signal": 6,
"env-access-signal": 7,
"deployment-signal": 8,
"risk-marker": 2,
});
expect(allMatches).toContain("docs/feature-inventory.md");
expect(allMatches).toContain("docs/env-access-inventory.md");
expect(allMatches).toContain("docs/deployment.md");
expect(allMatches).not.toContain("node_modules/ignored/ignored.md");
expect(allMatches).not.toContain(".tc/ignored.md");
expect(allMatches).not.toContain("generated/ignored.md");
});
it("records absent docs roots without failing the read-only inventory gate", async () => {
const root = await mkdtemp(join(tmpdir(), "docsInventory-baseline-missing-"));
const inventory = await runDocsInventoryInventory(root);
expect(inventory.roots).toEqual([]);
expect(inventory.missingRoots).toEqual(docsInventoryInventoryScanRoots);
expect(inventory.filesScanned).toBe(0);
expect(inventory.totalMatches).toBe(0);
});
});
describe("Docs Inventory report rendering", () => {
it("renders gate metadata, fingerprints, and inventory counts", () => {
const report = renderReport([
{ id: "typecheck", command: "pnpm run typecheck", exitCode: 2, durationMs: 1500, failureCount: 7, fingerprint: { hash: "abc123def456", excerpt: "error TS2322" } },
{
id: "docsInventory-docs-inventory",
command: "read-only Docs Inventory docs inventory",
exitCode: 0,
durationMs: 42,
failureCount: 0,
inventory: {
roots: ["docs/feature-inventory.md"],
missingRoots: ["docs/deployment.md"],
filesScanned: 1,
counts: { "feature-inventory-signal": 1, "deployment-signal": 2 },
totalMatches: 3,
matches: [],
},
fingerprint: { hash: "fed456abc123", excerpt: "feature-inventory-signal: 1" },
},
{
id: "docsInventory-status-authority-guard",
command: "static Docs Inventory status authority guard",
exitCode: 1,
durationMs: 20,
failureCount: 1,
statusAuthorityGuard: {
checked: ["docs/improvement-plan/README.md"],
failures: ["docs/improvement-plan/README.md: missing marker"],
},
fingerprint: { hash: "abc456abc456", excerpt: "failures: 1" },
},
]);
expect(report).toContain("# Docs Inventory Baseline Health");
expect(report).toContain("non-E2E baseline gates for Docs Inventory baseline");
expect(report).toContain("feature, environment access, deployment, and risk markers");
expect(report).toContain("## typecheck");
expect(report).toContain("## docsInventory-docs-inventory");
expect(report).toContain("- Exitcode: 2");
expect(report).toContain("- Failure Count: 7");
expect(report).toContain("- Output Fingerprint: abc123def456");
expect(report).toContain("- Status Authority Docs Checked: docs/improvement-plan/README.md");
expect(report).toContain("- Status Authority Guard Failures: 1");
expect(report).toContain("- Inventory Roots: docs/feature-inventory.md");
expect(report).toContain("- Missing Roots Skipped: docs/deployment.md");
expect(report).toContain(" - feature-inventory-signal: 1");
expect(report).toContain("- Total Inventory Matches: 3");
});
});
@@ -179,7 +179,9 @@ const requiredConcretePaths = [
"apps/web/app/modules/emailMarketing",
"apps/web/app/routes/admin/email-marketing.tsx",
"apps/web/app/routes/app.$tenant/email-marketing.tsx",
"apps/web/app/modules/emailMarketing/services/EmailMarketingService.ts",
// R-P14C (AD-2): EmailMarketingService.ts (Entity-Builder/CrmService campaign
// path) removed with the legacy editor (Variante A); see the report's
// "## Update (R-P14C)" section. File-existence assertion dropped.
"apps/web/app/modules/emailMarketing/db/emailSender.ts",
"apps/web/app/modules/emailMarketing/db/campaigns.db.server.ts",
"apps/web/app/modules/emailMarketing/db/outboundEmails.db.server.ts",
@@ -231,7 +233,8 @@ if (isNonEmptyFile(pluginCandidatesPath)) {
const codeAreas = Array.isArray(emailMarketing?.codeAreas) ? emailMarketing.codeAreas : [];
for (const codeArea of [
"apps/web/app/modules/emailMarketing",
"apps/web/app/modules/emailMarketing/services/EmailMarketingService.ts",
// R-P14C: EmailMarketingService.ts removed (Variante A); no longer a
// manifest code area.
"apps/web/app/modules/emailMarketing/db/emailSender.ts",
"apps/web/app/modules/emailMarketing/db/campaigns.db.server.ts",
"apps/web/app/modules/emailMarketing/db/outboundEmails.db.server.ts",
@@ -28,7 +28,7 @@ describe("verify-email-marketing-decision-report", () => {
fs.rmSync(tempRoot, { recursive: true, force: true });
fs.mkdirSync(tempRoot, { recursive: true });
for (const entry of ["apps", "docs", "prisma", ".env.example", ".env.production.example", ".env.fly.example"]) {
for (const entry of ["apps", "docs", "prisma", ".env.example", ".env.production.example"]) {
fs.cpSync(path.join(root, entry), path.join(tempRoot, entry), { recursive: true });
}
}
@@ -43,7 +43,7 @@ export const BASELINE = {
eslintDisable: 262,
tsIgnore: 35,
// Raised 2->43 on 2026-05-17 to absorb @ts-expect-error usage in
// parallel admin-sso + chatbot-mvp + storybook agent commits landed on
// parallel admin-sso + chatbot-mvp agent commits landed on
// main during Phase 05 #80 marketing-funnel-3 work. Phase #80 itself
// introduces zero new @ts-expect-error escape hatches.
tsExpectError: 43,
@@ -22,7 +22,7 @@ export const exportInventoryPatterns = [
{ id: "signed-download-storage-reference", pattern: /\b(?:signed|signedUrl|createSignedUrl|getSignedUrl|downloadUrl|storage|bucket|objectKey|FileObject)\b/g },
{ id: "retention-expiry-marker", pattern: /\b(?:retention|expiresAt|expire|expiry|ttl|timeToLive|deleteAfter|cleanup|purge)\b/gi },
{ id: "permission-audit-marker", pattern: /\b(?:permission|permissions|authorize|authorized|audit|auditable|actorId|tenantId|workspaceId)\b/g },
{ id: "generated-client-reference", pattern: /\b(?:packages\/db\/generated|@toolctrl\/db\/generated|generated\/prisma|PrismaClient|client\/models\/FileObject)\b/g },
{ id: "generated-client-reference", pattern: /\b(?:packages\/db\/generated|@hivegrid\/db\/generated|generated\/prisma|PrismaClient|client\/models\/FileObject)\b/g },
];
export const gates = [
@@ -47,43 +47,89 @@ const REQUIRED_COMMANDS_IN_ORDER = [
"pnpm lint",
"pnpm run test:foundation",
"pnpm run test:packages",
"pnpm run test:mobile",
"pnpm test",
"pnpm run build:ci",
"pnpm run verify:bundle-size",
"pnpm run verify:production-seed-artifact",
];
// The former monolithic "quality" job is split into parallel jobs to cut CI wallclock.
// The static-verify gate is itself split into two jobs (verify-1 + verify-2) so the heavy
// UI/a11y checks run side by side instead of serially. Every command in
// REQUIRED_COMMANDS_IN_ORDER must still run exactly once across these jobs, and the required
// relative order is preserved WITHIN each owning job (cross-job order no longer matters
// because the jobs run in parallel). The two heavy UI checks (ui-visual + hot-swap) live in
// verify-1, the two heavy accessibility checks (a11y-coverage + a11y smoke) in verify-2.
const QUALITY_SPLIT_JOBS = ["verify-1", "verify-2", "typecheck-test", "build"];
const QUALITY_JOB_BY_COMMAND = {
"pnpm run verify:github-ci-workflow": "verify-1",
"pnpm run verify:gitea-ci-workflow": "verify-1",
"pnpm run verify:deploy-workflow": "verify-1",
"pnpm run verify:deploy-readiness": "verify-1",
"pnpm run verify:ci-baseline": "verify-1",
"pnpm run verify:source-health": "verify-1",
"pnpm run verify:eslint-baseline": "verify-1",
"pnpm run verify:env-drift": "verify-1",
"pnpm run verify:health-baseline": "verify-1",
"pnpm run verify:api-inventory": "verify-1",
"pnpm run verify:tenant-isolation-report": "verify-2",
"pnpm run verify:sidebar-routes": "verify-2",
"pnpm run verify:i18n": "verify-2",
"pnpm run verify:tenant-auth-baseline": "verify-2",
"pnpm run verify:onboarding-flow": "verify-2",
"pnpm run verify:phase-c-boundaries": "verify-2",
"pnpm run verify:core-build-without-plugins-smoke": "build",
"pnpm run verify:removed-modules": "verify-2",
"pnpm run verify:ui-visual": "verify-1",
"pnpm run test:hot-swap": "verify-1",
"pnpm run verify:a11y-coverage": "verify-2",
"pnpm run test:a11y": "verify-2",
"pnpm run verify:porting-docs-baseline": "verify-2",
"pnpm run verify:production-docs": "verify-2",
"pnpm run verify:release-docs": "verify-2",
"pnpm run verify:docs-links": "verify-2",
"pnpm typecheck": "typecheck-test",
"pnpm lint": "typecheck-test",
"pnpm run test:foundation": "typecheck-test",
"pnpm run test:packages": "typecheck-test",
"pnpm test": "typecheck-test",
"pnpm run build:ci": "build",
"pnpm run verify:bundle-size": "build",
"pnpm run verify:production-seed-artifact": "build",
};
const SERVICE_JOB_CONTRACTS = {
api: {
label: "api",
commands: [
"pnpm run verify:openapi-security",
"pnpm --filter @toolctrl/api typecheck",
"pnpm --filter @hivegrid/api typecheck",
"pnpm exec vitest run apps/api/src",
"pnpm --filter @toolctrl/api build",
"pnpm --filter @hivegrid/api build",
],
},
worker: {
label: "worker",
commands: [
"pnpm --filter @toolctrl/worker typecheck",
"pnpm --filter @toolctrl/worker exec vitest run",
"pnpm --filter @hivegrid/worker typecheck",
"pnpm --filter @hivegrid/worker exec vitest run",
"pnpm run verify:workflow-outbox-native",
"pnpm --filter @toolctrl/worker build",
"pnpm --filter @toolctrl/worker health",
"pnpm --filter @hivegrid/worker build",
"pnpm --filter @hivegrid/worker health",
],
},
};
const DATABASE_JOB = "database";
const DATABASE_STATUS_COMMAND = "pnpm run verify:db-migrate-status:staging";
const DATABASE_GENERATE_COMMAND = "pnpm run db:generate";
const DATABASE_PARITY_COMMAND = "pnpm run verify:migrations-parity";
const STAGING_SSH_HOST_VAR = "${{ vars.COOLIFY_STAGING_SSH_HOST }}";
const STAGING_SSH_USER_VAR = "${{ vars.COOLIFY_STAGING_SSH_USER }}";
const STAGING_WEB_RESOURCE_UUID_VAR = "${{ vars.COOLIFY_STAGING_WEB_RESOURCE_UUID }}";
const STAGING_SSH_KEY_SECRET = "${{ secrets.COOLIFY_STAGING_SSH_KEY }}";
const FORBIDDEN_DATABASE_MUTATION_PATTERN = /\b(?:prisma\s+migrate\s+deploy|migrate:deploy|db:deploy|db:push|prisma\s+db\s+push|seed)\b/i;
const DOCKER_SMOKE_JOB = "docker-smoke";
const DOCKER_SMOKE_NEEDS = ["quality", "api", "worker", "database"];
// Empty: docker-smoke intentionally has no needs so it runs in parallel with the quality
// phase (it builds images from source, no cross-job artifact dependency). See ci.yml.
const DOCKER_SMOKE_NEEDS = [];
const DOCKER_SMOKE_TARGETS = ["web", "api", "worker"];
const DOCKER_WEB_TAG = dockerImageTag("web");
const DOCKER_API_TAG = dockerImageTag("api");
@@ -359,7 +405,7 @@ function getStepForRunCommand(section, predicate) {
function hasUploadSourcemapsArtifactStep(section) {
return getAllStepBlocks(section).some(
(step) =>
/uses:\s*actions\/upload-artifact@v4/i.test(step) &&
/uses:\s*actions\/upload-artifact@v[34]/i.test(step) &&
new RegExp(`^\\s*name:\\s*${escapeRegExp(WEB_SOURCEMAPS_ARTIFACT_NAME)}\\s*$`, "m").test(step) &&
new RegExp(`^\\s*path:\\s*${escapeRegExp(WEB_SOURCEMAPS_PATH)}\\s*$`, "m").test(step) &&
/^\s*if-no-files-found:\s*error\s*$/m.test(step) &&
@@ -370,7 +416,7 @@ function hasUploadSourcemapsArtifactStep(section) {
function hasReusableSourcemapsArtifactContract(content) {
return (
/^\s+sourcemaps-artifact:\s*$/m.test(content) &&
/uses:\s*actions\/download-artifact@v4/i.test(content) &&
/uses:\s*actions\/download-artifact@v[34]/i.test(content) &&
/^\s*if:\s*\$\{\{\s*inputs\.sourcemaps-artifact\s*!=\s*'none'\s*\}\}\s*$/m.test(content) &&
/^\s*name:\s*\$\{\{\s*inputs\.sourcemaps-artifact\s*\}\}\s*$/m.test(content) &&
/^\s*path:\s*\$\{\{\s*inputs\.sourcemaps-path\s*\}\}\s*$/m.test(content)
@@ -529,29 +575,34 @@ export function checkWorkflowTriggers(content) {
export function checkPnpmSetup(content) {
const passes = [];
const failures = [];
const qualitySection = getJobSection(content, "quality");
if (!qualitySection) {
failures.push(`${WORKFLOW_PATH}: missing required quality job "quality"`);
return { passes, failures, observations: [] };
}
// Each split quality job runs its own setup (checkout + corepack + pinned pnpm +
// frozen install), so every one of them must carry the pnpm bootstrap.
for (const jobName of QUALITY_SPLIT_JOBS) {
const section = getJobSection(content, jobName);
if (hasCorepackSetup(qualitySection)) {
passes.push(`${WORKFLOW_PATH}: Corepack setup is present`);
} else {
failures.push(`${WORKFLOW_PATH}: missing Corepack setup`);
}
if (!section) {
failures.push(`${WORKFLOW_PATH}: missing required quality job "${jobName}"`);
continue;
}
if (hasPinnedPnpm(qualitySection)) {
passes.push(`${WORKFLOW_PATH}: pnpm@${REQUIRED_PNPM_VERSION} is pinned`);
} else {
failures.push(`${WORKFLOW_PATH}: pnpm must be pinned to pnpm@${REQUIRED_PNPM_VERSION}`);
}
if (hasCorepackSetup(section)) {
passes.push(`${WORKFLOW_PATH}: quality job "${jobName}" Corepack setup is present`);
} else {
failures.push(`${WORKFLOW_PATH}: quality job "${jobName}" missing Corepack setup`);
}
if (hasFrozenInstall(qualitySection)) {
passes.push(`${WORKFLOW_PATH}: command "pnpm install --frozen-lockfile" is present`);
} else {
failures.push(`${WORKFLOW_PATH}: missing required command "pnpm install --frozen-lockfile"`);
if (hasPinnedPnpm(section)) {
passes.push(`${WORKFLOW_PATH}: quality job "${jobName}" pnpm@${REQUIRED_PNPM_VERSION} is pinned`);
} else {
failures.push(`${WORKFLOW_PATH}: quality job "${jobName}" pnpm must be pinned to pnpm@${REQUIRED_PNPM_VERSION}`);
}
if (hasFrozenInstall(section)) {
passes.push(`${WORKFLOW_PATH}: quality job "${jobName}" command "pnpm install --frozen-lockfile" is present`);
} else {
failures.push(`${WORKFLOW_PATH}: quality job "${jobName}" missing required command "pnpm install --frozen-lockfile"`);
}
}
return { passes, failures, observations: [] };
@@ -560,14 +611,27 @@ export function checkPnpmSetup(content) {
export function checkOrderedQualityGates(content) {
const passes = [];
const failures = [];
const qualitySection = getJobSection(content, "quality") ?? content;
const executableCommands = getExecutableRunCommandEntries(qualitySection);
let previousIndex = -1;
// Resolve each split job's section once. The required commands are partitioned across
// these jobs via QUALITY_JOB_BY_COMMAND; missing jobs surface as missing commands here
// (and are also reported by checkPnpmSetup).
const sections = {};
for (const jobName of QUALITY_SPLIT_JOBS) {
sections[jobName] = getJobSection(content, jobName) ?? "";
}
// Duplicate detection is global across the split jobs so a gate cannot run twice in CI.
const combinedSection = QUALITY_SPLIT_JOBS.map((jobName) => sections[jobName]).join("\n");
// Order is tracked per owning job: the canonical relative order must hold WITHIN each
// job. Across jobs the order is irrelevant because they run in parallel.
const previousIndexByJob = Object.fromEntries(QUALITY_SPLIT_JOBS.map((jobName) => [jobName, -1]));
for (const command of REQUIRED_COMMANDS_IN_ORDER) {
const jobName = QUALITY_JOB_BY_COMMAND[command];
const section = sections[jobName] ?? "";
const executableCommands = getExecutableRunCommandEntries(section);
const commandIndex = executableCommands.findIndex((entry) => matchesExecutableCommand(entry.command, command));
const commandOccurrences = countExecutableCommandOccurrences(qualitySection, command);
const softeningReason = getRequiredCommandSofteningReason(qualitySection, command);
const commandOccurrences = countExecutableCommandOccurrences(combinedSection, command);
const softeningReason = getRequiredCommandSofteningReason(section, command);
if (commandIndex === -1) {
if (softeningReason) {
@@ -583,7 +647,7 @@ export function checkOrderedQualityGates(content) {
continue;
}
if (commandIndex < previousIndex) {
if (commandIndex < previousIndexByJob[jobName]) {
failures.push(`${WORKFLOW_PATH}: command "${command}" must run after previous quality gates`);
continue;
}
@@ -594,10 +658,12 @@ export function checkOrderedQualityGates(content) {
}
passes.push(`${WORKFLOW_PATH}: command "${command}" is ordered`);
previousIndex = commandIndex;
previousIndexByJob[jobName] = commandIndex;
}
const sourcemapsValidationStep = getStepForRunCommand(qualitySection, (line) => line === WEB_SOURCEMAPS_VALIDATE_COMMAND);
// The web build, source-map validation and artifact upload all live in the "build" job.
const buildSection = sections.build ?? "";
const sourcemapsValidationStep = getStepForRunCommand(buildSection, (line) => line === WEB_SOURCEMAPS_VALIDATE_COMMAND);
if (sourcemapsValidationStep) {
const softeningReason = getRequiredStepSofteningReason(sourcemapsValidationStep);
if (softeningReason) {
@@ -609,7 +675,7 @@ export function checkOrderedQualityGates(content) {
failures.push(`${WORKFLOW_PATH}: missing web source-map validation before Sentry artifact upload`);
}
if (hasUploadSourcemapsArtifactStep(qualitySection)) {
if (hasUploadSourcemapsArtifactStep(buildSection)) {
passes.push(`${WORKFLOW_PATH}: web source maps are uploaded as artifact "${WEB_SOURCEMAPS_ARTIFACT_NAME}"`);
} else {
failures.push(`${WORKFLOW_PATH}: must upload ${WEB_SOURCEMAPS_PATH} as artifact "${WEB_SOURCEMAPS_ARTIFACT_NAME}" with if-no-files-found: error`);
@@ -618,7 +684,7 @@ export function checkOrderedQualityGates(content) {
return { passes, failures, observations: [] };
}
export function checkSentrySourcemapWorkflow(rootDir, content) {
export function checkSentrySourcemapWorkflow(rootDir) {
const passes = [];
const failures = [];
const sentryReusableContent = readOptionalFile(rootDir, SENTRY_REUSABLE_WORKFLOW_PATH);
@@ -631,18 +697,6 @@ export function checkSentrySourcemapWorkflow(rootDir, content) {
failures.push(`${SENTRY_REUSABLE_WORKFLOW_PATH}: reusable workflow must accept sourcemaps-artifact and download it to inputs.sourcemaps-path`);
}
const sentryWebSection = getJobSection(content, "sentry-release-web");
if (!sentryWebSection) {
failures.push(`${WORKFLOW_PATH}: missing Sentry web release job "sentry-release-web"`);
} else if (
new RegExp(`^\\s*sourcemaps-path:\\s*${escapeRegExp(WEB_SOURCEMAPS_PATH)}\\s*$`, "m").test(sentryWebSection) &&
new RegExp(`^\\s*sourcemaps-artifact:\\s*${escapeRegExp(WEB_SOURCEMAPS_ARTIFACT_NAME)}\\s*$`, "m").test(sentryWebSection)
) {
passes.push(`${WORKFLOW_PATH}: Sentry web release consumes artifact "${WEB_SOURCEMAPS_ARTIFACT_NAME}"`);
} else {
failures.push(`${WORKFLOW_PATH}: Sentry web release must pass sourcemaps-path ${WEB_SOURCEMAPS_PATH} and sourcemaps-artifact ${WEB_SOURCEMAPS_ARTIFACT_NAME}`);
}
return { passes, failures, observations: [] };
}
@@ -773,6 +827,22 @@ export function checkDatabaseJob(content) {
}
}
if (includesCommand(section, DATABASE_PARITY_COMMAND)) {
const softeningReason = getRequiredCommandSofteningReason(section, DATABASE_PARITY_COMMAND);
if (softeningReason) {
failures.push(`${WORKFLOW_PATH}: database job "${DATABASE_JOB}" command "${DATABASE_PARITY_COMMAND}" must not use ${softeningReason}`);
} else {
passes.push(`${WORKFLOW_PATH}: database job "${DATABASE_JOB}" includes command "${DATABASE_PARITY_COMMAND}"`);
}
} else {
const softeningReason = getRequiredCommandSofteningReason(section, DATABASE_PARITY_COMMAND);
if (softeningReason) {
failures.push(`${WORKFLOW_PATH}: database job "${DATABASE_JOB}" command "${DATABASE_PARITY_COMMAND}" must not use ${softeningReason}`);
} else {
failures.push(`${WORKFLOW_PATH}: database job "${DATABASE_JOB}" missing command "${DATABASE_PARITY_COMMAND}"`);
}
}
if (includesCommand(section, DATABASE_STATUS_COMMAND)) {
const softeningReason = getRequiredCommandSofteningReason(section, DATABASE_STATUS_COMMAND);
if (softeningReason) {
@@ -1059,7 +1129,7 @@ export function checkGiteaVariableNames(content) {
const failures = [];
if (FORBIDDEN_GITEA_HOST_OVERRIDE_PATTERN.test(content)) {
failures.push(`${WORKFLOW_PATH}: GITEA_HOST_IP is forbidden because Gitea reserves the GITEA_ variable prefix; use TOOLCTRL_GITEA_HOST_IP`);
failures.push(`${WORKFLOW_PATH}: GITEA_HOST_IP is forbidden because Gitea reserves the GITEA_ variable prefix; use HIVEGRID_GITEA_HOST_IP`);
} else {
passes.push(`${WORKFLOW_PATH}: internal host override avoids the reserved GITEA_ variable prefix`);
}
@@ -1067,9 +1137,9 @@ export function checkGiteaVariableNames(content) {
const hostWrites = [...content.matchAll(HOST_OVERRIDE_WRITE_PATTERN)].length;
const validations = [...content.matchAll(HOST_OVERRIDE_VALIDATION_PATTERN)].length;
if (hostWrites > validations) {
failures.push(`${WORKFLOW_PATH}: TOOLCTRL_GITEA_HOST_IP must be validated before writing to /etc/hosts`);
failures.push(`${WORKFLOW_PATH}: HIVEGRID_GITEA_HOST_IP must be validated before writing to /etc/hosts`);
} else {
passes.push(`${WORKFLOW_PATH}: internal host override validates TOOLCTRL_GITEA_HOST_IP before /etc/hosts writes`);
passes.push(`${WORKFLOW_PATH}: internal host override validates HIVEGRID_GITEA_HOST_IP before /etc/hosts writes`);
}
return { passes, failures, observations: [] };
@@ -1096,7 +1166,7 @@ export function verifyGiteaCiWorkflow(rootDir = process.cwd()) {
checkServiceJobs(content),
checkDatabaseJob(content),
checkDockerSmokeJob(content),
checkSentrySourcemapWorkflow(rootDir, content),
checkSentrySourcemapWorkflow(rootDir),
checkForbiddenE2eCommands(content),
checkGiteaVariableNames(content),
];
@@ -18,7 +18,7 @@ concurrency:
cancel-in-progress: true
jobs:
quality:
verify-1:
runs-on: toolctrl-ci
steps:
- name: Checkout
@@ -49,6 +49,21 @@ jobs:
run: pnpm run verify:health-baseline
- name: Verify API inventory
run: pnpm run verify:api-inventory
- name: Verify UI mock static baseline
run: pnpm run verify:ui-visual
- name: Test UI hot-swap
run: pnpm run test:hot-swap
verify-2:
runs-on: toolctrl-ci
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Enable Corepack
run: corepack enable
- name: Pin pnpm
run: corepack prepare pnpm@10.33.0 --activate
- name: Install dependencies
run: pnpm install --frozen-lockfile
- name: Verify tenant isolation report
run: pnpm run verify:tenant-isolation-report
- name: Verify sidebar routes
@@ -61,14 +76,8 @@ jobs:
run: pnpm run verify:onboarding-flow
- name: Verify Phase C boundaries
run: pnpm run verify:phase-c-boundaries
- name: Verify Feature Manifest core without plugins
run: pnpm run verify:core-build-without-plugins-smoke
- name: Verify Feature Manifest removed modules
run: pnpm run verify:removed-modules
- name: Verify UI mock static baseline
run: pnpm run verify:ui-visual
- name: Test UI hot-swap
run: pnpm run test:hot-swap
- name: Verify accessibility coverage
run: pnpm run verify:a11y-coverage
- name: Test accessibility smoke
@@ -81,6 +90,17 @@ jobs:
run: pnpm run verify:release-docs
- name: Verify docs links
run: pnpm run verify:docs-links
typecheck-test:
runs-on: toolctrl-ci
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Enable Corepack
run: corepack enable
- name: Pin pnpm
run: corepack prepare pnpm@10.33.0 --activate
- name: Install dependencies
run: pnpm install --frozen-lockfile
- name: Typecheck
run: pnpm typecheck
- name: Lint
@@ -89,10 +109,21 @@ jobs:
run: pnpm run test:foundation
- name: Package tests
run: pnpm run test:packages
- name: Mobile wrapper tests
run: pnpm run test:mobile
- name: Unit tests
run: pnpm test
build:
runs-on: toolctrl-ci
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Enable Corepack
run: corepack enable
- name: Pin pnpm
run: corepack prepare pnpm@10.33.0 --activate
- name: Install dependencies
run: pnpm install --frozen-lockfile
- name: Verify Feature Manifest core without plugins
run: pnpm run verify:core-build-without-plugins-smoke
- name: Build
run: pnpm run build:ci
- name: Verify bundle size
@@ -122,11 +153,11 @@ jobs:
- name: Verify OpenAPI security
run: pnpm run verify:openapi-security
- name: Typecheck API
run: pnpm --filter @toolctrl/api typecheck
run: pnpm --filter @hivegrid/api typecheck
- name: Test API
run: pnpm exec vitest run apps/api/src
- name: Build API
run: pnpm --filter @toolctrl/api build
run: pnpm --filter @hivegrid/api build
worker:
runs-on: toolctrl-ci
steps:
@@ -139,15 +170,15 @@ jobs:
- name: Install dependencies
run: pnpm install --frozen-lockfile
- name: Typecheck Worker
run: pnpm --filter @toolctrl/worker typecheck
run: pnpm --filter @hivegrid/worker typecheck
- name: Test Worker
run: pnpm --filter @toolctrl/worker exec vitest run
run: pnpm --filter @hivegrid/worker exec vitest run
- name: Verify workflow outbox native readiness
run: pnpm run verify:workflow-outbox-native
- name: Build Worker
run: pnpm --filter @toolctrl/worker build
run: pnpm --filter @hivegrid/worker build
- name: Health Check Worker
run: pnpm --filter @toolctrl/worker health
run: pnpm --filter @hivegrid/worker health
database:
runs-on: toolctrl-ci
steps:
@@ -161,6 +192,8 @@ jobs:
run: pnpm install --frozen-lockfile
- name: Generate database client
run: pnpm run db:generate
- name: Verify migrations schema parity
run: pnpm run verify:migrations-parity
- name: Verify database migration status
run: pnpm run verify:db-migrate-status:staging
env:
@@ -170,7 +203,7 @@ jobs:
COOLIFY_STAGING_SSH_KEY: \${{ secrets.COOLIFY_STAGING_SSH_KEY }}
docker-smoke:
runs-on: toolctrl-ci
needs: [quality, api, worker, database]
needs: [verify-1, verify-2, typecheck-test, build, api, worker, database]
steps:
- name: Checkout
uses: actions/checkout@v4
@@ -180,11 +213,11 @@ jobs:
shell: bash
run: |
set -euo pipefail
docker build --target web --build-arg APP_REVISION=ci-smoke-revision --tag toolctrl-web:smoke . &
docker build --target web --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-web:smoke . &
web_pid=$!
docker build --target api --build-arg APP_REVISION=ci-smoke-revision --tag toolctrl-api:smoke . &
docker build --target api --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-api:smoke . &
api_pid=$!
docker build --target worker --build-arg APP_REVISION=ci-smoke-revision --tag toolctrl-worker:smoke . &
docker build --target worker --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-worker:smoke . &
worker_pid=$!
status=0
wait "$web_pid" || status=$?
@@ -192,25 +225,17 @@ jobs:
wait "$worker_pid" || status=$?
exit "$status"
- name: Validate web Docker artifacts
run: docker run --rm --entrypoint /bin/sh toolctrl-web:smoke -lc 'test -f /myapp/apps/web/build/server/index.js && test -d /myapp/apps/web/build/client && test -f /myapp/build/server-runtime/server.js'
run: docker run --rm --entrypoint /bin/sh hivegrid-web:smoke -lc 'test -f /myapp/apps/web/build/server/index.js && test -d /myapp/apps/web/build/client && test -f /myapp/build/server-runtime/server.js'
- name: Validate web Docker runtime
run: bash scripts/docker-web-runtime-smoke.sh toolctrl-web:smoke
run: bash scripts/docker-web-runtime-smoke.sh hivegrid-web:smoke
- name: Validate API Docker runtime
run: bash scripts/docker-api-runtime-smoke.sh toolctrl-api:smoke
run: bash scripts/docker-api-runtime-smoke.sh hivegrid-api:smoke
env:
DOCKER_API_SMOKE_TRANSPORT: exec
- name: Validate worker Docker runtime
run: bash scripts/docker-worker-runtime-smoke.sh toolctrl-worker:smoke
run: bash scripts/docker-worker-runtime-smoke.sh hivegrid-worker:smoke
- name: Validate Docker Compose config
run: docker compose config
sentry-release-web:
needs: resolve-sentry-environment
uses: ./.gitea/workflows/_sentry-release.yml
with:
project: boilerplate-web
environment: preview
sourcemaps-path: apps/web/build/client
sourcemaps-artifact: web-client-sourcemaps
`;
const SENTRY_REUSABLE_WORKFLOW = `name: Sentry Release
@@ -275,7 +300,10 @@ describe("verify-gitea-ci-workflow", () => {
assert.deepEqual(result.failures, []);
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: trigger \"push\" is disabled so deploy is not queued behind CI on main"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: trigger \"workflow_dispatch\" is defined"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: pnpm@10.33.0 is pinned"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: quality job \"verify-1\" pnpm@10.33.0 is pinned"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: quality job \"verify-2\" pnpm@10.33.0 is pinned"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: quality job \"typecheck-test\" pnpm@10.33.0 is pinned"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: quality job \"build\" pnpm@10.33.0 is pinned"));
assert.ok(result.passes.some((pass) => /^\.gitea\/workflows\/ci\.yml:\d+: runner is "toolctrl-ci"$/.test(pass)));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: command \"pnpm run verify:ci-baseline\" is ordered"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: command \"pnpm run verify:source-health\" is ordered"));
@@ -285,14 +313,13 @@ describe("verify-gitea-ci-workflow", () => {
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: command \"pnpm run verify:health-baseline\" is ordered"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: command \"pnpm run verify:tenant-auth-baseline\" is ordered"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: command \"pnpm run verify:tenant-isolation-report\" is ordered"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: command \"pnpm run test:mobile\" is ordered"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: service job \"api\" is defined"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: service job \"api\" includes scoped command \"pnpm run verify:openapi-security\""));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: service job \"api\" includes scoped command \"pnpm --filter @toolctrl/api typecheck\""));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: service job \"api\" includes scoped command \"pnpm --filter @hivegrid/api typecheck\""));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: service job \"worker\" is defined"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: service job \"worker\" includes scoped command \"pnpm run verify:workflow-outbox-native\""));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: service job \"worker\" includes scoped command \"pnpm --filter @toolctrl/worker build\""));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: service job \"worker\" includes scoped command \"pnpm --filter @toolctrl/worker health\""));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: service job \"worker\" includes scoped command \"pnpm --filter @hivegrid/worker build\""));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: service job \"worker\" includes scoped command \"pnpm --filter @hivegrid/worker health\""));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: database job \"database\" is defined"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: service job \"api\" runs independently of \"quality\""));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: service job \"worker\" runs independently of \"quality\""));
@@ -303,8 +330,6 @@ describe("verify-gitea-ci-workflow", () => {
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: database job \"database\" verifies private Coolify databases without exposing DATABASE_URL"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: database job \"database\" contains no deploy/seed/schema mutation commands"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: Docker smoke job \"docker-smoke\" is defined"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: Docker smoke job \"docker-smoke\" needs \"quality\""));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: Docker smoke job \"docker-smoke\" needs \"database\""));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: Docker smoke job \"docker-smoke\" does not run Corepack setup"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: Docker smoke job \"docker-smoke\" builds Docker target \"web\""));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: Docker smoke job \"docker-smoke\" builds Docker targets in parallel"));
@@ -315,7 +340,6 @@ describe("verify-gitea-ci-workflow", () => {
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: Docker smoke job \"docker-smoke\" validates Docker Compose config"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: web source maps are uploaded as artifact \"web-client-sourcemaps\""));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/_sentry-release.yml: reusable workflow downloads requested source-map artifacts before upload"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: Sentry web release consumes artifact \"web-client-sourcemaps\""));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: Docker smoke job \"docker-smoke\" contains no registry login/push/publish commands"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: no forbidden E2E/browser commands are present"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/ci.yml: CI concurrency cancels superseded pull request and branch runs"));
@@ -368,7 +392,8 @@ describe("verify-gitea-ci-workflow", () => {
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: missing required command "pnpm lint"/);
});
it("fails when pnpm setup is present only outside the quality job", () => {
it("fails when pnpm setup is missing from one split quality job", () => {
// String.replace removes only the first occurrence, i.e. the "verify-1" job's setup.
const rootDir = createFixture(
VALID_WORKFLOW.replace(" - name: Enable Corepack\n run: corepack enable\n", "")
.replace(" - name: Pin pnpm\n run: corepack prepare pnpm@10.33.0 --activate\n", "")
@@ -378,9 +403,9 @@ describe("verify-gitea-ci-workflow", () => {
const result = verifyGiteaCiWorkflow(rootDir);
const failures = result.failures.join("\n");
assert.match(failures, /\.gitea\/workflows\/ci\.yml: missing Corepack setup/);
assert.match(failures, /\.gitea\/workflows\/ci\.yml: pnpm must be pinned to pnpm@10\.33\.0/);
assert.match(failures, /\.gitea\/workflows\/ci\.yml: missing required command "pnpm install --frozen-lockfile"/);
assert.match(failures, /\.gitea\/workflows\/ci\.yml: quality job "verify-1" missing Corepack setup/);
assert.match(failures, /\.gitea\/workflows\/ci\.yml: quality job "verify-1" pnpm must be pinned to pnpm@10\.33\.0/);
assert.match(failures, /\.gitea\/workflows\/ci\.yml: quality job "verify-1" missing required command "pnpm install --frozen-lockfile"/);
});
it("fails when a required quality gate only appears in a shell comment", () => {
@@ -423,19 +448,22 @@ describe("verify-gitea-ci-workflow", () => {
it("fails when a service command ends with an unconditional true", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(
" - name: Typecheck API\n run: pnpm --filter @toolctrl/api typecheck\n",
" - name: Typecheck API\n run: |\n pnpm --filter @toolctrl/api typecheck\n true\n",
" - name: Typecheck API\n run: pnpm --filter @hivegrid/api typecheck\n",
" - name: Typecheck API\n run: |\n pnpm --filter @hivegrid/api typecheck\n true\n",
),
);
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: service job "api" command "pnpm --filter @toolctrl\/api typecheck" must not use shell success masking/);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: service job "api" command "pnpm --filter @hivegrid\/api typecheck" must not use shell success masking/);
});
it("accepts block-list needs syntax for dependent jobs", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(" needs: [quality, api, worker, database]\n", " needs:\n - quality\n - api\n - worker\n - database\n"),
VALID_WORKFLOW.replace(
" needs: [verify-1, verify-2, typecheck-test, build, api, worker, database]\n",
" needs:\n - verify-1\n - verify-2\n - typecheck-test\n - build\n - api\n - worker\n - database\n",
),
);
const result = verifyGiteaCiWorkflow(rootDir);
@@ -462,14 +490,14 @@ describe("verify-gitea-ci-workflow", () => {
it("fails when worker tests are narrowed to explicit files", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(
" run: pnpm --filter @toolctrl/worker exec vitest run\n",
" run: pnpm --filter @toolctrl/worker exec vitest run src/handlers.test.ts src/health.test.ts",
" run: pnpm --filter @hivegrid/worker exec vitest run\n",
" run: pnpm --filter @hivegrid/worker exec vitest run src/handlers.test.ts src/health.test.ts",
),
);
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: service job "worker" missing scoped command "pnpm --filter @toolctrl\/worker exec vitest run"/);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: service job "worker" missing scoped command "pnpm --filter @hivegrid\/worker exec vitest run"/);
});
it("fails when the worker service job omits the workflow outbox native readiness gate", () => {
@@ -488,14 +516,14 @@ describe("verify-gitea-ci-workflow", () => {
it("fails when the worker service job omits its health check", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(
" - name: Health Check Worker\n run: pnpm --filter @toolctrl/worker health\n",
" - name: Health Check Worker\n run: pnpm --filter @hivegrid/worker health\n",
"",
),
);
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: service job "worker" missing scoped command "pnpm --filter @toolctrl\/worker health"/);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: service job "worker" missing scoped command "pnpm --filter @hivegrid\/worker health"/);
});
it("fails when the env drift gate is missing", () => {
@@ -554,14 +582,14 @@ describe("verify-gitea-ci-workflow", () => {
it("fails when a service job command only appears in a shell comment", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(
" - name: Typecheck API\n run: pnpm --filter @toolctrl/api typecheck\n",
" - name: Typecheck API\n run: |\n # pnpm --filter @toolctrl/api typecheck\n echo skipped\n",
" - name: Typecheck API\n run: pnpm --filter @hivegrid/api typecheck\n",
" - name: Typecheck API\n run: |\n # pnpm --filter @hivegrid/api typecheck\n echo skipped\n",
),
);
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: service job "api" missing scoped command "pnpm --filter @toolctrl\/api typecheck"/);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: service job "api" missing scoped command "pnpm --filter @hivegrid\/api typecheck"/);
});
it("fails when the tenant isolation report gate is missing", () => {
@@ -572,17 +600,19 @@ describe("verify-gitea-ci-workflow", () => {
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: missing required command "pnpm run verify:tenant-isolation-report"/);
});
it("fails when the API inventory gate runs after typecheck", () => {
it("fails when a verify-2 gate runs out of its canonical order", () => {
// tenant-isolation-report is canonically the first verify-2 gate; moving it after the
// sidebar/i18n gates pushes those earlier gates out of order within the owning job.
const rootDir = createFixture(
VALID_WORKFLOW.replace(
" - name: Verify API inventory\n run: pnpm run verify:api-inventory\n - name: Verify tenant isolation report\n run: pnpm run verify:tenant-isolation-report\n - name: Verify sidebar routes\n run: pnpm run verify:sidebar-routes\n - name: Verify i18n\n run: pnpm run verify:i18n\n",
" - name: Verify tenant isolation report\n run: pnpm run verify:tenant-isolation-report\n - name: Verify sidebar routes\n run: pnpm run verify:sidebar-routes\n - name: Verify i18n\n run: pnpm run verify:i18n\n - name: Verify API inventory\n run: pnpm run verify:api-inventory\n",
" - name: Verify tenant isolation report\n run: pnpm run verify:tenant-isolation-report\n - name: Verify sidebar routes\n run: pnpm run verify:sidebar-routes\n - name: Verify i18n\n run: pnpm run verify:i18n\n",
" - name: Verify sidebar routes\n run: pnpm run verify:sidebar-routes\n - name: Verify i18n\n run: pnpm run verify:i18n\n - name: Verify tenant isolation report\n run: pnpm run verify:tenant-isolation-report\n",
),
);
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: command "pnpm run verify:i18n" must run after previous quality gates/);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: command "pnpm run verify:sidebar-routes" must run after previous quality gates/);
});
it("fails when a job uses ubuntu-latest instead of the required Gitea runner", () => {
@@ -631,8 +661,8 @@ describe("verify-gitea-ci-workflow", () => {
" - name: Test API\n run: pnpm exec vitest run apps/api/src\n",
"",
).replace(
" - name: Build Worker\n run: pnpm --filter @toolctrl/worker build\n",
" - name: Build Worker\n run: pnpm --filter @toolctrl/worker build\n - name: Misplaced API tests\n run: pnpm exec vitest run apps/api/src\n",
" - name: Build Worker\n run: pnpm --filter @hivegrid/worker build\n",
" - name: Build Worker\n run: pnpm --filter @hivegrid/worker build\n - name: Misplaced API tests\n run: pnpm exec vitest run apps/api/src\n",
),
);
@@ -712,24 +742,24 @@ describe("verify-gitea-ci-workflow", () => {
});
it("fails when the database job contains a migration deploy command", () => {
const rootDir = createFixture(VALID_WORKFLOW.replace(" - name: Verify database migration status\n run: pnpm run verify:db-migrate-status:staging\n", " - name: Verify database migration status\n run: pnpm run verify:db-migrate-status:staging\n - name: Deploy migrations\n run: pnpm --filter @toolctrl/db prisma migrate deploy\n"));
const rootDir = createFixture(VALID_WORKFLOW.replace(" - name: Verify database migration status\n run: pnpm run verify:db-migrate-status:staging\n", " - name: Verify database migration status\n run: pnpm run verify:db-migrate-status:staging\n - name: Deploy migrations\n run: pnpm --filter @hivegrid/db prisma migrate deploy\n"));
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: database job "database" contains forbidden deploy\/seed\/schema mutation command: run: pnpm --filter @toolctrl\/db prisma migrate deploy/);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: database job "database" contains forbidden deploy\/seed\/schema mutation command: run: pnpm --filter @hivegrid\/db prisma migrate deploy/);
});
it("fails when the database job hides a migration deploy command in a multiline run block", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(
" - name: Verify database migration status\n run: pnpm run verify:db-migrate-status:staging\n",
" - name: Verify database migration status\n run: pnpm run verify:db-migrate-status:staging\n - name: Deploy migrations\n run: |\n pnpm run db:generate\n pnpm --filter @toolctrl/db prisma migrate deploy\n",
" - name: Verify database migration status\n run: pnpm run verify:db-migrate-status:staging\n - name: Deploy migrations\n run: |\n pnpm run db:generate\n pnpm --filter @hivegrid/db prisma migrate deploy\n",
),
);
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: database job "database" contains forbidden deploy\/seed\/schema mutation command: run: pnpm run db:generate\npnpm --filter @toolctrl\/db prisma migrate deploy/);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: database job "database" contains forbidden deploy\/seed\/schema mutation command: run: pnpm run db:generate\npnpm --filter @hivegrid\/db prisma migrate deploy/);
});
it("fails when the database job contains an E2E browser command", () => {
@@ -761,27 +791,10 @@ describe("verify-gitea-ci-workflow", () => {
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: missing required Docker smoke job "docker-smoke"/);
});
it("fails when the Docker smoke job is missing a required dependency", () => {
const rootDir = createFixture(VALID_WORKFLOW.replace(" needs: [quality, api, worker, database]\n", " needs: [quality, api]\n"));
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: Docker smoke job "docker-smoke" must declare needs including "worker"/);
assert.doesNotMatch(result.failures.join("\n"), /must declare needs including "quality"/);
});
it("fails when the Docker smoke job does not depend on the database job", () => {
const rootDir = createFixture(VALID_WORKFLOW.replace(" needs: [quality, api, worker, database]\n", " needs: [quality, api, worker]\n"));
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: Docker smoke job "docker-smoke" must declare needs including "database"/);
});
it("fails when a Docker target build is missing from the Docker smoke job", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(" - name: Build API\n run: pnpm --filter @toolctrl/api build\n", " - name: Build API\n run: pnpm --filter @toolctrl/api build\n - name: Misplaced Docker API build\n run: docker buildx build --target api --file Dockerfile .\n").replace(
" docker build --target api --build-arg APP_REVISION=ci-smoke-revision --tag toolctrl-api:smoke . &\n api_pid=$!\n",
VALID_WORKFLOW.replace(" - name: Build API\n run: pnpm --filter @hivegrid/api build\n", " - name: Build API\n run: pnpm --filter @hivegrid/api build\n - name: Misplaced Docker API build\n run: docker buildx build --target api --file Dockerfile .\n").replace(
" docker build --target api --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-api:smoke . &\n api_pid=$!\n",
"",
),
);
@@ -793,7 +806,7 @@ describe("verify-gitea-ci-workflow", () => {
});
it("fails when a Docker smoke build omits the revision build arg", () => {
const rootDir = createFixture(VALID_WORKFLOW.replace("docker build --target web --build-arg APP_REVISION=ci-smoke-revision --tag toolctrl-web:smoke .", "docker build --target web --tag toolctrl-web:smoke ."));
const rootDir = createFixture(VALID_WORKFLOW.replace("docker build --target web --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-web:smoke .", "docker build --target web --tag hivegrid-web:smoke ."));
const result = verifyGiteaCiWorkflow(rootDir);
@@ -804,74 +817,74 @@ describe("verify-gitea-ci-workflow", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(
" - name: Validate Docker Compose config\n run: docker compose config\n",
" - name: Validate Docker Compose config\n run: docker compose config\n - name: Publish image\n run: docker push registry.example.com/toolctrl/api:latest\n",
" - name: Validate Docker Compose config\n run: docker compose config\n - name: Publish image\n run: docker push registry.example.com/hivegrid/api:latest\n",
),
);
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: Docker smoke job "docker-smoke" contains forbidden publish command: run: docker push registry\.example\.com\/toolctrl\/api:latest/);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: Docker smoke job "docker-smoke" contains forbidden publish command: run: docker push registry\.example\.com\/hivegrid\/api:latest/);
});
it("fails when the Docker smoke job omits web artifact validation", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(
" - name: Validate web Docker artifacts\n run: docker run --rm --entrypoint /bin/sh toolctrl-web:smoke -lc 'test -f /myapp/apps/web/build/server/index.js && test -d /myapp/apps/web/build/client && test -f /myapp/build/server-runtime/server.js'\n",
" - name: Validate web Docker artifacts\n run: docker run --rm --entrypoint /bin/sh hivegrid-web:smoke -lc 'test -f /myapp/apps/web/build/server/index.js && test -d /myapp/apps/web/build/client && test -f /myapp/build/server-runtime/server.js'\n",
"",
),
);
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "docker run --rm --entrypoint \/bin\/sh toolctrl-web:smoke/);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "docker run --rm --entrypoint \/bin\/sh hivegrid-web:smoke/);
});
it("fails when the Docker smoke job omits web runtime validation", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(
" - name: Validate web Docker runtime\n run: bash scripts/docker-web-runtime-smoke.sh toolctrl-web:smoke\n",
" - name: Validate web Docker runtime\n run: bash scripts/docker-web-runtime-smoke.sh hivegrid-web:smoke\n",
"",
),
);
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "bash scripts\/docker-web-runtime-smoke\.sh toolctrl-web:smoke"/);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "bash scripts\/docker-web-runtime-smoke\.sh hivegrid-web:smoke"/);
});
it("fails when the Docker smoke job omits API runtime validation", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(
" - name: Validate API Docker runtime\n run: bash scripts/docker-api-runtime-smoke.sh toolctrl-api:smoke\n env:\n DOCKER_API_SMOKE_TRANSPORT: exec\n",
" - name: Validate API Docker runtime\n run: bash scripts/docker-api-runtime-smoke.sh hivegrid-api:smoke\n env:\n DOCKER_API_SMOKE_TRANSPORT: exec\n",
"",
),
);
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "bash scripts\/docker-api-runtime-smoke\.sh toolctrl-api:smoke"/);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "bash scripts\/docker-api-runtime-smoke\.sh hivegrid-api:smoke"/);
});
it("fails when the Docker smoke job omits worker runtime validation", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(
" - name: Validate worker Docker runtime\n run: bash scripts/docker-worker-runtime-smoke.sh toolctrl-worker:smoke\n",
" - name: Validate worker Docker runtime\n run: bash scripts/docker-worker-runtime-smoke.sh hivegrid-worker:smoke\n",
"",
),
);
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "bash scripts\/docker-worker-runtime-smoke\.sh toolctrl-worker:smoke"/);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "bash scripts\/docker-worker-runtime-smoke\.sh hivegrid-worker:smoke"/);
});
it("fails when Docker smoke target builds are not parallelized", () => {
const sequentialBuilds = ` - name: Build web Docker target
run: docker build --target web --build-arg APP_REVISION=ci-smoke-revision --tag toolctrl-web:smoke .
run: docker build --target web --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-web:smoke .
- name: Build api Docker target
run: docker build --target api --build-arg APP_REVISION=ci-smoke-revision --tag toolctrl-api:smoke .
run: docker build --target api --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-api:smoke .
- name: Build worker Docker target
run: docker build --target worker --build-arg APP_REVISION=ci-smoke-revision --tag toolctrl-worker:smoke .
run: docker build --target worker --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-worker:smoke .
`;
const rootDir = createFixture(
VALID_WORKFLOW.replace(/ - name: Build Docker smoke targets\n shell: bash\n run: \|\n(?: .*\n)+? - name: Validate web Docker artifacts\n/, `${sequentialBuilds} - name: Validate web Docker artifacts\n`),
@@ -886,20 +899,20 @@ describe("verify-gitea-ci-workflow", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(
" - name: Validate Docker Compose config\n run: docker compose config\n",
" - name: Validate Docker Compose config\n run: docker compose config\n - name: Publish image\n run: |\n docker compose config\n docker push registry.example.com/toolctrl/api:latest\n",
" - name: Validate Docker Compose config\n run: docker compose config\n - name: Publish image\n run: |\n docker compose config\n docker push registry.example.com/hivegrid/api:latest\n",
),
);
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: Docker smoke job "docker-smoke" contains forbidden publish command: run: docker compose config\ndocker push registry\.example\.com\/toolctrl\/api:latest/);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: Docker smoke job "docker-smoke" contains forbidden publish command: run: docker compose config\ndocker push registry\.example\.com\/hivegrid\/api:latest/);
});
it("does not treat Docker publish commands outside Docker smoke as Docker smoke publish failures", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(
" - name: Build API\n run: pnpm --filter @toolctrl/api build\n",
" - name: Build API\n run: pnpm --filter @toolctrl/api build\n - name: Misplaced publish\n run: docker push registry.example.com/toolctrl/api:latest\n",
" - name: Build API\n run: pnpm --filter @hivegrid/api build\n",
" - name: Build API\n run: pnpm --filter @hivegrid/api build\n - name: Misplaced publish\n run: docker push registry.example.com/hivegrid/api:latest\n",
),
);
@@ -932,14 +945,14 @@ describe("verify-gitea-ci-workflow", () => {
it("fails when a forbidden browser command is present in a service job", () => {
const rootDir = createFixture(
VALID_WORKFLOW.replace(
" - name: Build API\n run: pnpm --filter @toolctrl/api build\n",
" - name: Build API\n run: pnpm --filter @toolctrl/api build\n - name: Browser smoke\n run: pnpm --filter @toolctrl/api exec browser test\n",
" - name: Build API\n run: pnpm --filter @hivegrid/api build\n",
" - name: Build API\n run: pnpm --filter @hivegrid/api build\n - name: Browser smoke\n run: pnpm --filter @hivegrid/api exec browser test\n",
),
);
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: forbidden E2E\/browser command found: run: pnpm --filter @toolctrl\/api exec browser test/);
assert.match(result.failures.join("\n"), /\.gitea\/workflows\/ci\.yml: forbidden E2E\/browser command found: run: pnpm --filter @hivegrid\/api exec browser test/);
});
it("fails when the internal host override uses the reserved GITEA_ prefix", () => {
@@ -951,11 +964,11 @@ describe("verify-gitea-ci-workflow", () => {
});
it("fails when the internal host override is written without token validation", () => {
const rootDir = createFixture(`${VALID_WORKFLOW}\n host-smoke:\n runs-on: toolctrl-ci\n steps:\n - name: Resolve internal host\n run: |\n if [ -n \"\${TOOLCTRL_GITEA_HOST_IP:-}\" ]; then\n printf '%s git.tool-ctrl.de\\n' \"$TOOLCTRL_GITEA_HOST_IP\" >> /etc/hosts\n fi\n`);
const rootDir = createFixture(`${VALID_WORKFLOW}\n host-smoke:\n runs-on: toolctrl-ci\n steps:\n - name: Resolve internal host\n run: |\n if [ -n \"\${HIVEGRID_GITEA_HOST_IP:-}\" ]; then\n printf '%s git.tool-ctrl.de\\n' \"$HIVEGRID_GITEA_HOST_IP\" >> /etc/hosts\n fi\n`);
const result = verifyGiteaCiWorkflow(rootDir);
assert.match(result.failures.join("\n"), /TOOLCTRL_GITEA_HOST_IP must be validated before writing to \/etc\/hosts/);
assert.match(result.failures.join("\n"), /HIVEGRID_GITEA_HOST_IP must be validated before writing to \/etc\/hosts/);
});
it("fails when web source maps are not uploaded for the Sentry release", () => {
@@ -14,7 +14,7 @@ import {
const WORKFLOW_PATH = ".gitea/workflows/deploy.yml";
const REQUIRED_RUNNER = CI_RUNNER_LABEL;
const REQUIRED_TARGETS = ["web", "api", "worker"];
const REQUIRED_TARGETS = ["web", "api", "worker", "mcp"];
const PREFLIGHT_JOB = "deploy-preflight";
const DEPLOY_JOB = "stage-or-promote";
const PREFLIGHT_DATABASE_URL = INFRA_PREFLIGHT_DATABASE_URL;
@@ -51,10 +51,17 @@ const FORBIDDEN_E2E_PATTERN = /\b(playwright|cypress|browser|test:e2e|e2e)\b/i;
const COOLIFY_TOKEN_SECRET = "${{ secrets.COOLIFY_TOKEN }}";
const COOLIFY_API_URL_VAR = "${{ vars.COOLIFY_API_URL }}";
const COOLIFY_RESOURCE_UUIDS_VAR = "${{ vars.COOLIFY_RESOURCE_UUIDS }}";
const PRODUCTION_SEED_ARTIFACT_PATTERN = /packages\/db\/dist\/production-seed\.server\.js/;
const PRODUCTION_SEED_COMMAND_PATTERN = /\bNODE_ENV=production\s+node\s+packages\/db\/dist\/production-seed\.server\.js\b/;
const COOLIFY_MIGRATION_SLOT_PATTERN = /pre_deployment_command:\s*process\.env\.MIGRATION_COMMAND/;
const COOLIFY_SEED_SLOT_PATTERN = /post_deployment_command:\s*process\.env\.SEED_COMMAND/;
// Coolify pre/post_deployment_command never fired for docker-image apps, so
// migrations and the seed moved into the web entrypoint (start.sh, gated by
// MIGRATE_ON_BOOT/SEED_ON_BOOT). The workflow must clear the dead hook slots
// and upsert the boot flags on the web resource instead.
const COOLIFY_MIGRATION_SLOT_CLEARED_PATTERN = /pre_deployment_command:\s*""/;
const COOLIFY_SEED_SLOT_CLEARED_PATTERN = /post_deployment_command:\s*""/;
const COOLIFY_SET_ENVS_PATTERN = /coolify-deploy\.mjs\s+set-envs\s+"\$WEB_RESOURCE_UUID"/;
const MIGRATE_ON_BOOT_FLAG_PATTERN = /\bMIGRATE_ON_BOOT=true\b/;
const SEED_ON_BOOT_FLAG_PATTERN = /\bSEED_ON_BOOT=true\b/;
const STAGING_DEMO_SEED_FLAG_PATTERN = /\bSEED_DEMO_DATA=true\b/;
const STAGING_DEMO_SEED_GUARD_FLAG_PATTERN = /\bALLOW_STAGING_DEMO_SEED=true\b/;
const LITERAL_COOLIFY_URL_PATTERN = /https?:\/\/[^\s'\"]*(?:coolify|webhook)[^\s'\"]*/i;
const LITERAL_PRODUCTION_REGISTRY_PATTERN =
/\b(?:ghcr\.io|registry\.docker\.com|docker\.io|registry\.[A-Za-z0-9.-]+|[A-Za-z0-9.-]+:\d{2,5})\/[A-Za-z0-9._/-]+/i;
@@ -70,6 +77,7 @@ const HOST_OVERRIDE_WRITE_PATTERN = INFRA_HOST_OVERRIDE_WRITE_PATTERN;
const HOST_OVERRIDE_VALIDATION_PATTERN = INFRA_HOST_OVERRIDE_VALIDATION_PATTERN;
const REQUIRED_DEPENDENT_IMAGE_TAG_PATCH_RESOURCES = [
"API_RESOURCE_UUID",
"MCP_RESOURCE_UUID",
"WORKER_GENERAL_RESOURCE_UUID",
"WORKER_MAIL_RESOURCE_UUID",
"WORKER_IMPORT_RESOURCE_UUID",
@@ -537,10 +545,10 @@ export function checkDeploymentConcurrency(content) {
const passes = [];
const failures = [];
if (/^concurrency:\s*$/m.test(content) && /^\s+group:\s*boilerplate-deploy\s*$/m.test(content) && /^\s+cancel-in-progress:\s*false\s*$/m.test(content)) {
if (/^concurrency:\s*$/m.test(content) && /^\s+group:\s*hivegrid-deploy\s*$/m.test(content) && /^\s+cancel-in-progress:\s*false\s*$/m.test(content)) {
passes.push(`${WORKFLOW_PATH}: deployment concurrency serializes staging and production promotion`);
} else {
failures.push(`${WORKFLOW_PATH}: deployment workflow must define concurrency group boilerplate-deploy with cancel-in-progress: false`);
failures.push(`${WORKFLOW_PATH}: deployment workflow must define concurrency group hivegrid-deploy with cancel-in-progress: false`);
}
return { passes, failures, observations: [] };
@@ -550,7 +558,7 @@ export function checkForbiddenCommands(content, analysis) {
const passes = [];
const failures = [];
const e2eBlock = getRunBlocks(content, analysis).find(({ command }) => FORBIDDEN_E2E_PATTERN.test(command.replace(/\btoolctrl\.browser-automation\b/g, "")));
const e2eBlock = getRunBlocks(content, analysis).find(({ command }) => FORBIDDEN_E2E_PATTERN.test(command.replace(/\bhivegrid\.browser-automation\b/g, "")));
if (e2eBlock) {
failures.push(`${WORKFLOW_PATH}:${e2eBlock.lineNumber}: forbidden E2E/browser command found: ${e2eBlock.line}`);
} else {
@@ -608,9 +616,9 @@ export function checkRequiredStepHardening(content, analysis) {
predicate: (command) => /\bdocker\s+buildx\s+build\b/.test(command) && /(?:^|\s)--push(?:\s|$)/.test(command),
},
{
label: "Coolify migration command configuration",
label: "Coolify migration boot flag configuration",
predicate: (command) =>
/pre_deployment_command/.test(command) && /\bprisma\s+migrate\s+deploy\b/.test(command) && PRODUCTION_SEED_ARTIFACT_PATTERN.test(command),
COOLIFY_MIGRATION_SLOT_CLEARED_PATTERN.test(command) && COOLIFY_SET_ENVS_PATTERN.test(command) && MIGRATE_ON_BOOT_FLAG_PATTERN.test(command),
},
{
label: "Coolify deploy trigger",
@@ -644,75 +652,73 @@ export function checkDatabaseMigrationDeployContract(content, analysis) {
const passes = [];
const failures = [];
const steps = getStepBlocks(content, analysis);
const migrationStep = steps.find(({ text }) => /\bConfigure Coolify staging migration command\b/i.test(text));
const productionMigrationStep = steps.find(({ text }) => /\bConfigure Coolify production migration command\b/i.test(text));
const migrationStep = steps.find(({ text }) => /\bConfigure Coolify staging migration boot flags\b/i.test(text));
const productionMigrationStep = steps.find(({ text }) => /\bConfigure Coolify production migration boot flags\b/i.test(text));
if (!migrationStep) {
failures.push(`${WORKFLOW_PATH}: missing Coolify staging migration command configuration step`);
failures.push(`${WORKFLOW_PATH}: missing Coolify staging migration boot flag configuration step`);
return { passes, failures, observations: [] };
}
if (!productionMigrationStep) {
failures.push(`${WORKFLOW_PATH}: missing Coolify production migration command configuration step`);
failures.push(`${WORKFLOW_PATH}: missing Coolify production migration boot flag configuration step`);
} else if (
COOLIFY_MIGRATION_SLOT_PATTERN.test(productionMigrationStep.text) &&
COOLIFY_SEED_SLOT_PATTERN.test(productionMigrationStep.text) &&
/\bprisma\s+migrate\s+deploy\b/.test(productionMigrationStep.text) &&
PRODUCTION_SEED_COMMAND_PATTERN.test(productionMigrationStep.text) &&
COOLIFY_MIGRATION_SLOT_CLEARED_PATTERN.test(productionMigrationStep.text) &&
COOLIFY_SEED_SLOT_CLEARED_PATTERN.test(productionMigrationStep.text) &&
COOLIFY_SET_ENVS_PATTERN.test(productionMigrationStep.text) &&
MIGRATE_ON_BOOT_FLAG_PATTERN.test(productionMigrationStep.text) &&
SEED_ON_BOOT_FLAG_PATTERN.test(productionMigrationStep.text) &&
/ALLOWED_RESOURCE_UUIDS="\$(?:RESOLVED_COOLIFY_RESOURCE_UUIDS|COOLIFY_RESOURCE_UUIDS)"/.test(productionMigrationStep.text) &&
/docker_registry_image_tag:\s*process\.env\.IMAGE_TAG/.test(productionMigrationStep.text)
) {
passes.push(
`${WORKFLOW_PATH}:${productionMigrationStep.lineNumber}: Coolify production pre-deployment migration and post-deployment guarded seed command targets the main web application`
`${WORKFLOW_PATH}:${productionMigrationStep.lineNumber}: Coolify production boot flag configuration clears dead hook slots and sets MIGRATE_ON_BOOT/SEED_ON_BOOT on the main web application`
);
} else {
failures.push(
`${WORKFLOW_PATH}:${productionMigrationStep.lineNumber}: Coolify production migration command must patch production web app migrations, post-deployment guarded production seed, and immutable image tag`
`${WORKFLOW_PATH}:${productionMigrationStep.lineNumber}: Coolify production boot flag configuration must clear pre/post_deployment_command, upsert MIGRATE_ON_BOOT=true and SEED_ON_BOOT=true via coolify-deploy.mjs set-envs, and patch the immutable image tag`
);
}
if (COOLIFY_MIGRATION_SLOT_PATTERN.test(migrationStep.text) && /\bprisma\s+migrate\s+deploy\b/.test(migrationStep.text)) {
passes.push(`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify pre-deployment migration command is present`);
} else {
failures.push(`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging migration command must set pre_deployment_command to prisma migrate deploy`);
if (
productionMigrationStep &&
(STAGING_DEMO_SEED_FLAG_PATTERN.test(productionMigrationStep.text) || STAGING_DEMO_SEED_GUARD_FLAG_PATTERN.test(productionMigrationStep.text))
) {
failures.push(
`${WORKFLOW_PATH}:${productionMigrationStep.lineNumber}: Coolify production boot flag configuration must not set staging demo seed flags (SEED_DEMO_DATA/ALLOW_STAGING_DEMO_SEED)`
);
} else if (productionMigrationStep) {
passes.push(`${WORKFLOW_PATH}:${productionMigrationStep.lineNumber}: Coolify production boot flag configuration keeps demo seed flags off`);
}
if (COOLIFY_SEED_SLOT_PATTERN.test(migrationStep.text)) {
passes.push(`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify post-deployment guarded seed command is present`);
} else {
failures.push(`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging migration command must set post_deployment_command to the guarded seed`);
}
if (/cd\s+\/myapp\b/.test(migrationStep.text) && !/cd\s+\/myapp\/packages\/db\b/.test(migrationStep.text)) {
passes.push(`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify migration command runs from the web image app root`);
if (COOLIFY_MIGRATION_SLOT_CLEARED_PATTERN.test(migrationStep.text) && COOLIFY_SEED_SLOT_CLEARED_PATTERN.test(migrationStep.text)) {
passes.push(`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging boot flag configuration clears the dead pre/post deployment hook slots`);
} else {
failures.push(
`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging migration command must run from /myapp so prisma.config.ts resolves in the final web image`
`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging boot flag configuration must clear pre_deployment_command and post_deployment_command (hooks never fired for docker-image apps)`
);
}
if (/\btsx\b/.test(migrationStep.text) || /node_modules\/\.pnpm\/node_modules\/\.bin/.test(migrationStep.text)) {
failures.push(`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging migration command must not use pnpm store-internal .bin paths`);
} else if (/\bpnpm\s+exec\s+prisma\b/.test(migrationStep.text) && PRODUCTION_SEED_COMMAND_PATTERN.test(migrationStep.text)) {
passes.push(`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify migration command uses production runtime-resolvable commands`);
} else {
failures.push(
`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging migration command must use pnpm exec for prisma and NODE_ENV=production node packages/db/dist/production-seed.server.js`
if (
COOLIFY_SET_ENVS_PATTERN.test(migrationStep.text) &&
MIGRATE_ON_BOOT_FLAG_PATTERN.test(migrationStep.text) &&
SEED_ON_BOOT_FLAG_PATTERN.test(migrationStep.text) &&
STAGING_DEMO_SEED_FLAG_PATTERN.test(migrationStep.text) &&
STAGING_DEMO_SEED_GUARD_FLAG_PATTERN.test(migrationStep.text)
) {
passes.push(
`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging boot flag configuration upserts MIGRATE_ON_BOOT/SEED_ON_BOOT and the guarded demo seed flags on the web resource`
);
}
if (PRODUCTION_SEED_COMMAND_PATTERN.test(migrationStep.text)) {
passes.push(`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify guarded seed uses built DB package output`);
} else {
failures.push(
`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging migration command must run the guarded production seed from built DB output in post_deployment_command`
`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging boot flag configuration must upsert MIGRATE_ON_BOOT=true, SEED_ON_BOOT=true, SEED_DEMO_DATA=true, and ALLOW_STAGING_DEMO_SEED=true via coolify-deploy.mjs set-envs`
);
}
if (/\bcurl\b[\s\S]*--request PATCH[\s\S]*\/applications\/\$WEB_RESOURCE_UUID/.test(migrationStep.text)) {
passes.push(`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify migration command is patched through the application API`);
passes.push(`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify boot flag configuration patches the web application through the application API`);
} else {
failures.push(`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging migration command must be patched through the application API`);
failures.push(`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging boot flag configuration must patch the web application through the application API`);
}
if (
@@ -764,7 +770,7 @@ export function checkDatabaseMigrationDeployContract(content, analysis) {
passes.push(`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging image-tag patch covers api and all separate worker applications`);
} else {
failures.push(
`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging image-tag patch must cover api, worker-general, worker-mail, worker-import, worker-webhook, and worker-plugin applications`
`${WORKFLOW_PATH}:${migrationStep.lineNumber}: Coolify staging image-tag patch must cover api, mcp, worker-general, worker-mail, worker-import, worker-webhook, and worker-plugin applications`
);
}
@@ -807,7 +813,7 @@ export function checkDatabaseMigrationDeployContract(content, analysis) {
passes.push(`${WORKFLOW_PATH}:${productionMigrationStep.lineNumber}: Coolify production image-tag patch covers api and all separate worker applications`);
} else if (productionMigrationStep) {
failures.push(
`${WORKFLOW_PATH}:${productionMigrationStep.lineNumber}: Coolify production image-tag patch must cover api, worker-general, worker-mail, worker-import, worker-webhook, and worker-plugin applications`
`${WORKFLOW_PATH}:${productionMigrationStep.lineNumber}: Coolify production image-tag patch must cover api, mcp, worker-general, worker-mail, worker-import, worker-webhook, and worker-plugin applications`
);
}
@@ -1095,27 +1101,7 @@ function checkCoolifyDependentHealthWaitContract(content, options, analysis) {
/HTTP_RESOURCE/.test(waitStep.text) &&
/WORKER_RESOURCE/.test(waitStep.text) &&
new RegExp(`${options.label.includes("staging") ? "STAGING" : "PRODUCTION"}_WORKER_RESOURCE_UUIDS`).test(waitStep.text) &&
/docker exec /.test(waitStep.text) &&
/docker ps --filter name=\$RESOURCE_UUID/.test(waitStep.text) &&
/node apps\/worker\/dist\/health\.js/.test(waitStep.text) &&
/WORKER_REVISION/.test(waitStep.text) &&
/WORKER_ENABLED/.test(waitStep.text) &&
/workerEnabled/.test(waitStep.text) &&
/worker health reports workerEnabled=false/.test(waitStep.text) &&
/WORKER_STATUS/.test(waitStep.text) &&
/\[\s*"\$WORKER_STATUS"\s*!=\s*"ready"\s*\]/.test(waitStep.text) &&
/worker health status is not ready/.test(waitStep.text) &&
/WORKER_GROUP/.test(waitStep.text) &&
/WORKER_QUEUES/.test(waitStep.text) &&
/worker group does not match expected queue group/.test(waitStep.text) &&
/worker queues do not match expected queue group/.test(waitStep.text) &&
/EXPECTED_WORKER_QUEUES="[^"]*toolctrl\.email/.test(waitStep.text) &&
/EXPECTED_WORKER_QUEUES="[^"]*toolctrl\.notifications[^"]*toolctrl\.maintenance[^"]*toolctrl\.file-scan/.test(waitStep.text) &&
/EXPECTED_WORKER_QUEUES="[^"]*toolctrl\.imports[^"]*toolctrl\.exports/.test(waitStep.text) &&
/EXPECTED_WORKER_QUEUES="[^"]*toolctrl\.ai-chatbot[^"]*toolctrl\.browser-automation/.test(waitStep.text) &&
/EXPECTED_WORKER_QUEUES="[^"]*toolctrl\.plugin-invoke/.test(waitStep.text) &&
/for EXPECTED_WORKER_QUEUE in \$EXPECTED_WORKER_QUEUES/.test(waitStep.text) &&
/worker live revision matches image tag/.test(waitStep.text) &&
/worker Coolify status is healthy and image tag matches expected alias/.test(waitStep.text) &&
/is an HTTP resource but has no health URL/.test(waitStep.text) &&
/CONFIGURED_IMAGE_TAG/.test(waitStep.text) &&
/EXPECTED_IMAGE_ALIAS/.test(waitStep.text) &&
@@ -1123,24 +1109,24 @@ function checkCoolifyDependentHealthWaitContract(content, options, analysis) {
/\[\s*"\$CONFIGURED_IMAGE_TAG"\s*!=\s*"\$EXPECTED_IMAGE_ALIAS"\s*\]/.test(waitStep.text)
) {
passes.push(
`${WORKFLOW_PATH}:${waitStep.lineNumber}: ${options.label} dependent health wait handles HTTP resources, worker live readiness, and non-HTTP alias tags explicitly`
`${WORKFLOW_PATH}:${waitStep.lineNumber}: ${options.label} dependent health wait handles HTTP resources, worker Coolify status, and non-HTTP alias tags explicitly`
);
} else {
failures.push(
`${WORKFLOW_PATH}:${waitStep.lineNumber}: ${options.label} dependent health wait must fail HTTP resources without health URLs, require worker execute health status=ready and workerEnabled=true, and compare alias tags for non-HTTP resources`
`${WORKFLOW_PATH}:${waitStep.lineNumber}: ${options.label} dependent health wait must fail HTTP resources without health URLs, require worker running:healthy status plus expected alias tag, and compare alias tags for non-HTTP resources`
);
}
if (
/worker execute endpoint unavailable; configured image tag matches expected alias/.test(waitStep.text) ||
/worker execute output unavailable; configured image tag matches expected alias/.test(waitStep.text) ||
/worker execute output is not JSON; configured image tag matches expected alias/.test(waitStep.text)
/COOLIFY_.*SSH_KEY/.test(waitStep.text) ||
/docker exec /.test(waitStep.text) ||
/docker ps --filter name=\$RESOURCE_UUID/.test(waitStep.text)
) {
failures.push(
`${WORKFLOW_PATH}:${waitStep.lineNumber}: ${options.label} dependent health wait must not pass-open worker execute failures based on image tag only`
`${WORKFLOW_PATH}:${waitStep.lineNumber}: ${options.label} dependent health wait must not expose SSH secrets or use docker exec from CI logs`
);
} else {
passes.push(`${WORKFLOW_PATH}:${waitStep.lineNumber}: ${options.label} dependent health wait fails worker execute failures closed`);
passes.push(`${WORKFLOW_PATH}:${waitStep.lineNumber}: ${options.label} dependent health wait avoids SSH-backed worker probes`);
}
if (/manual runtime revision verification required after deploy/.test(waitStep.text)) {
@@ -1406,13 +1392,12 @@ export function checkDockerTargets(content, analysis) {
const usesStableRegistryBuildCache =
/CACHE_REF="\$REGISTRY\/\$IMAGE_NAMESPACE\/\$IMAGE_PREFIX\/build-cache:\$TARGET"/.test(content) &&
/--cache-from\s+"type=registry,ref=\$CACHE_REF"/.test(content) &&
/--cache-to\s+"type=registry,ref=\$CACHE_REF,mode=max(?:,[^"]*)?"/.test(content);
/--cache-from\s+"type=registry,ref=\$CACHE_REF"/.test(content);
if (usesStableRegistryBuildCache) {
passes.push(`${WORKFLOW_PATH}: staging Docker builds use stable registry cache refs per image namespace and target`);
passes.push(`${WORKFLOW_PATH}: staging Docker builds read stable registry cache refs per image namespace and target`);
} else {
failures.push(
`${WORKFLOW_PATH}: staging Docker builds must use --cache-from/--cache-to with a stable registry cache ref under $REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/build-cache:$TARGET`
`${WORKFLOW_PATH}: staging Docker builds must use --cache-from with a stable registry cache ref under $REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/build-cache:$TARGET`
);
}
@@ -1456,15 +1441,15 @@ export function checkImageVariables(content, analysis) {
const usesNamespaceVariable = /\bIMAGE_NAMESPACE\b/.test(content);
const usesImagePrefix = /\bIMAGE_PREFIX\b/.test(content);
if (usesGiteaRegistry && usesNamespaceVariable && usesImagePrefix) {
passes.push(`${WORKFLOW_PATH}: image references use the Gitea Package Registry namespace and boilerplate target path`);
passes.push(`${WORKFLOW_PATH}: image references use the Gitea Package Registry namespace and HiveGrid target path`);
} else {
failures.push(`${WORKFLOW_PATH}: image references must use ${GIT_HOST} with IMAGE_NAMESPACE and IMAGE_PREFIX`);
}
if (/\$IMAGE_PREFIX\/\$TARGET/.test(content)) {
passes.push(`${WORKFLOW_PATH}: image paths match existing Coolify boilerplate/{web|api|worker} resources`);
passes.push(`${WORKFLOW_PATH}: image paths match existing Coolify hivegrid/{web|api|worker|mcp} resources`);
} else {
failures.push(`${WORKFLOW_PATH}: image paths must match existing Coolify boilerplate/{web|api|worker} resources`);
failures.push(`${WORKFLOW_PATH}: image paths must match existing Coolify hivegrid/{web|api|worker|mcp} resources`);
}
const literalRegistryLine = getWorkflowLines(content, analysis).find(
@@ -1516,7 +1501,7 @@ export function checkTagStrategy(content, analysis) {
/fetch-depth:\s*0/.test(content) &&
/\bgit\s+cat-file\s+-e\s+"\$IMAGE_TAG\^\{commit\}"/.test(content) &&
/\bgit\s+merge-base\s+--is-ancestor\s+"\$IMAGE_TAG"\s+origin\/main\b/.test(content) &&
/for TARGET in web api worker; do[\s\S]*docker\s+buildx\s+imagetools\s+inspect\s+"\$IMAGE:\$IMAGE_TAG"\s+--format[\s\S]*docker\s+buildx\s+imagetools\s+inspect\s+"\$IMAGE:staging"\s+--format[\s\S]*SHA_DIGEST[\s\S]*STAGING_DIGEST[\s\S]*done/.test(
/for TARGET in web api worker mcp; do[\s\S]*docker\s+buildx\s+imagetools\s+inspect\s+"\$IMAGE:\$IMAGE_TAG"\s+--format[\s\S]*docker\s+buildx\s+imagetools\s+inspect\s+"\$IMAGE:staging"\s+--format[\s\S]*SHA_DIGEST[\s\S]*STAGING_DIGEST[\s\S]*done/.test(
content
);
@@ -1575,9 +1560,7 @@ export function checkSentryDeployMarkerContract(content, analysis) {
if (
/\bSENTRY_ENVIRONMENT=staging\b/.test(sentryStep.text) &&
/RELEASE_SHA="\$\{SHA\}"/.test(sentryStep.text) &&
/boilerplate-api/.test(sentryStep.text) &&
/boilerplate-worker/.test(sentryStep.text) &&
/boilerplate-web/.test(sentryStep.text)
/for PROJECT in api worker web\b/.test(sentryStep.text)
) {
passes.push(`${WORKFLOW_PATH}:${sentryStep.lineNumber}: Sentry deploy marker covers staging SHA and all runtime projects`);
} else {
@@ -1657,7 +1640,7 @@ export function checkGiteaVariableNames(content) {
const failures = [];
if (FORBIDDEN_GITEA_HOST_OVERRIDE_PATTERN.test(content)) {
failures.push(`${WORKFLOW_PATH}: GITEA_HOST_IP is forbidden because Gitea reserves the GITEA_ variable prefix; use TOOLCTRL_GITEA_HOST_IP`);
failures.push(`${WORKFLOW_PATH}: GITEA_HOST_IP is forbidden because Gitea reserves the GITEA_ variable prefix; use HIVEGRID_GITEA_HOST_IP`);
} else {
passes.push(`${WORKFLOW_PATH}: internal host override avoids the reserved GITEA_ variable prefix`);
}
@@ -1665,9 +1648,9 @@ export function checkGiteaVariableNames(content) {
const hostWrites = [...content.matchAll(HOST_OVERRIDE_WRITE_PATTERN)].length;
const validations = [...content.matchAll(HOST_OVERRIDE_VALIDATION_PATTERN)].length;
if (hostWrites > validations) {
failures.push(`${WORKFLOW_PATH}: TOOLCTRL_GITEA_HOST_IP must be validated before writing to /etc/hosts`);
failures.push(`${WORKFLOW_PATH}: HIVEGRID_GITEA_HOST_IP must be validated before writing to /etc/hosts`);
} else {
passes.push(`${WORKFLOW_PATH}: internal host override validates TOOLCTRL_GITEA_HOST_IP before /etc/hosts writes`);
passes.push(`${WORKFLOW_PATH}: internal host override validates HIVEGRID_GITEA_HOST_IP before /etc/hosts writes`);
}
return { passes, failures, observations: [] };
@@ -27,7 +27,7 @@ on:
default: "false"
concurrency:
group: boilerplate-deploy
group: hivegrid-deploy
cancel-in-progress: false
jobs:
@@ -53,7 +53,7 @@ jobs:
env:
REGISTRY: git.tool-ctrl.de
IMAGE_NAMESPACE: toolctrl-labs
IMAGE_PREFIX: boilerplate
IMAGE_PREFIX: hivegrid
SHA: \${{ gitea.sha }}
DISPATCH_ACTION: \${{ gitea.event.inputs.action }}
DISPATCH_STAGED_SHA: \${{ gitea.event.inputs.staged_sha }}
@@ -129,7 +129,7 @@ jobs:
git fetch --no-tags origin main
git cat-file -e "$IMAGE_TAG^{commit}"
git merge-base --is-ancestor "$IMAGE_TAG" origin/main
for TARGET in web api worker; do
for TARGET in web api worker mcp; do
IMAGE="$REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/$TARGET"
SHA_DIGEST="$(docker buildx imagetools inspect "$IMAGE:$IMAGE_TAG" --format '{{json .Manifest.Digest}}')"
STAGING_DIGEST="$(docker buildx imagetools inspect "$IMAGE:staging" --format '{{json .Manifest.Digest}}')"
@@ -142,7 +142,7 @@ jobs:
run: |
BUILD_PIDS=()
BUILD_TARGETS=()
for TARGET in web api worker; do
for TARGET in web api worker mcp; do
(
IMAGE="$REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/$TARGET"
CACHE_REF="$REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/build-cache:$TARGET"
@@ -150,7 +150,7 @@ jobs:
if [ "$TARGET" = "web" ]; then
WEB_BUILD_ARGS=(--build-arg VITE_SENTRY_DSN_WEB="$VITE_SENTRY_DSN_WEB" --build-arg VITE_SENTRY_RELEASE="$SHA")
fi
docker buildx build --push --target "$TARGET" --file Dockerfile --cache-from "type=registry,ref=$CACHE_REF" --cache-to "type=registry,ref=$CACHE_REF,mode=max" --build-arg APP_REVISION="$SHA" "\${WEB_BUILD_ARGS[@]}" --tag "$IMAGE:$IMAGE_TAG" .
docker buildx build --push --target "$TARGET" --file Dockerfile --cache-from "type=registry,ref=$CACHE_REF" --build-arg APP_REVISION="$SHA" "\${WEB_BUILD_ARGS[@]}" --tag "$IMAGE:$IMAGE_TAG" .
) &
BUILD_PIDS+=("$!")
BUILD_TARGETS+=("$TARGET")
@@ -165,50 +165,55 @@ jobs:
if [ "$BUILD_FAILED" -ne 0 ]; then
exit "$BUILD_FAILED"
fi
for TARGET in web api worker; do
for TARGET in web api worker mcp; do
IMAGE="$REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/$TARGET"
docker buildx imagetools create --tag "$IMAGE:staging" "$IMAGE:$IMAGE_TAG"
done
- name: Install cosign
if: env.DEPLOY_ACTION == 'stage'
run: bash scripts/ci/install-cosign.sh
- name: Configure Coolify staging migration command
- name: Configure Coolify staging migration boot flags
env:
COOLIFY_STAGING_API_URL: \${{ vars.COOLIFY_STAGING_API_URL }}
COOLIFY_STAGING_TOKEN: \${{ secrets.COOLIFY_STAGING_TOKEN }}
COOLIFY_STAGING_RESOURCE_UUIDS: \${{ vars.COOLIFY_STAGING_RESOURCE_UUIDS }}
MIGRATION_COMMAND: cd /myapp && pnpm exec prisma migrate deploy --config prisma.config.ts
SEED_COMMAND: cd /myapp && NODE_ENV=production node packages/db/dist/production-seed.server.js
run: |
WEB_IMAGE="$REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/web"
API_IMAGE="$REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/api"
WORKER_IMAGE="$REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/worker"
MCP_IMAGE="$REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/mcp"
WEB_RESOURCE_UUID="$(WEB_IMAGE="$WEB_IMAGE" ALLOWED_RESOURCE_UUIDS="$COOLIFY_STAGING_RESOURCE_UUIDS" node -e 'const apps = [{ uuid: "web", docker_registry_image_name: process.env.WEB_IMAGE, docker_registry_image_tag: process.env.IMAGE_TAG }]; const allowed = new Set((process.env.ALLOWED_RESOURCE_UUIDS || "").split(",").filter(Boolean)); const app = apps.find((candidate) => candidate.docker_registry_image_name === process.env.WEB_IMAGE && allowed.has(candidate.uuid)); process.stdout.write(app?.uuid || "");')"
API_RESOURCE_UUID="$(API_IMAGE="$API_IMAGE" node -e 'process.stdout.write("api")')"
MCP_RESOURCE_UUID="$(MCP_IMAGE="$MCP_IMAGE" node -e 'process.stdout.write("mcp")')"
WORKER_GENERAL_RESOURCE_UUID="$(WORKER_QUEUE_GROUP=general WORKER_IMAGE="$WORKER_IMAGE" node -e 'process.stdout.write("worker-general")')"
WORKER_MAIL_RESOURCE_UUID="$(WORKER_QUEUE_GROUP=mail WORKER_IMAGE="$WORKER_IMAGE" node -e 'process.stdout.write("worker-mail")')"
WORKER_IMPORT_RESOURCE_UUID="$(WORKER_QUEUE_GROUP=import WORKER_IMAGE="$WORKER_IMAGE" node -e 'process.stdout.write("worker-import")')"
WORKER_WEBHOOK_RESOURCE_UUID="$(WORKER_QUEUE_GROUP=webhook WORKER_IMAGE="$WORKER_IMAGE" node -e 'process.stdout.write("worker-webhook")')"
WORKER_PLUGIN_RESOURCE_UUID="$(WORKER_QUEUE_GROUP=plugin WORKER_IMAGE="$WORKER_IMAGE" node -e 'process.stdout.write("worker-plugin")')"
WORKER_RESOURCE_UUIDS="$WORKER_GENERAL_RESOURCE_UUID,$WORKER_MAIL_RESOURCE_UUID,$WORKER_IMPORT_RESOURCE_UUID,$WORKER_WEBHOOK_RESOURCE_UUID,$WORKER_PLUGIN_RESOURCE_UUID"
for REQUIRED_RESOURCE_UUID in "$WEB_RESOURCE_UUID" "$API_RESOURCE_UUID" "$WORKER_GENERAL_RESOURCE_UUID" "$WORKER_MAIL_RESOURCE_UUID" "$WORKER_IMPORT_RESOURCE_UUID" "$WORKER_WEBHOOK_RESOURCE_UUID" "$WORKER_PLUGIN_RESOURCE_UUID"; do
for REQUIRED_RESOURCE_UUID in "$WEB_RESOURCE_UUID" "$API_RESOURCE_UUID" "$MCP_RESOURCE_UUID" "$WORKER_GENERAL_RESOURCE_UUID" "$WORKER_MAIL_RESOURCE_UUID" "$WORKER_IMPORT_RESOURCE_UUID" "$WORKER_WEBHOOK_RESOURCE_UUID" "$WORKER_PLUGIN_RESOURCE_UUID"; do
if ! printf ",%s," "$COOLIFY_STAGING_RESOURCE_UUIDS" | grep -Fq ",$REQUIRED_RESOURCE_UUID,"; then
echo "Coolify staging deploy resources must include the web, api, worker-general, worker-mail, worker-import, worker-webhook, and worker-plugin applications"
exit 1
fi
done
DEPENDENT_RESOURCE_UUIDS="$API_RESOURCE_UUID,$WORKER_RESOURCE_UUIDS"
DEPENDENT_RESOURCE_UUIDS="$API_RESOURCE_UUID,$MCP_RESOURCE_UUID,$WORKER_RESOURCE_UUIDS"
echo "STAGING_WEB_RESOURCE_UUID=$WEB_RESOURCE_UUID"
echo "STAGING_WORKER_RESOURCE_UUIDS=$WORKER_RESOURCE_UUIDS"
echo "STAGING_DEPENDENT_RESOURCE_UUIDS=$DEPENDENT_RESOURCE_UUIDS"
MIGRATION_PAYLOAD="$(node -e 'process.stdout.write(JSON.stringify({ pre_deployment_command: process.env.MIGRATION_COMMAND, post_deployment_command: process.env.SEED_COMMAND, docker_registry_image_tag: process.env.IMAGE_TAG }))')"
MIGRATION_PAYLOAD="$(node -e 'process.stdout.write(JSON.stringify({ pre_deployment_command: "", post_deployment_command: "", docker_registry_image_tag: process.env.IMAGE_TAG }))')"
curl --fail --silent --show-error --request PATCH \\
--header "Authorization: Bearer $COOLIFY_STAGING_TOKEN" \\
--header "Content-Type: application/json" \\
--data "$MIGRATION_PAYLOAD" \\
"$COOLIFY_STAGING_API_URL/applications/$WEB_RESOURCE_UUID"
node scripts/coolify-deploy.mjs set-envs "$WEB_RESOURCE_UUID" \\
MIGRATE_ON_BOOT=true \\
SEED_ON_BOOT=true \\
SEED_DEMO_DATA=true \\
ALLOW_STAGING_DEMO_SEED=true
IMAGE_TAG_PAYLOAD="$(node -e 'process.stdout.write(JSON.stringify({ docker_registry_image_tag: process.env.IMAGE_TAG }))')"
for RESOURCE_UUID in "$API_RESOURCE_UUID" "$WORKER_GENERAL_RESOURCE_UUID" "$WORKER_MAIL_RESOURCE_UUID" "$WORKER_IMPORT_RESOURCE_UUID" "$WORKER_WEBHOOK_RESOURCE_UUID" "$WORKER_PLUGIN_RESOURCE_UUID"; do
for RESOURCE_UUID in "$API_RESOURCE_UUID" "$MCP_RESOURCE_UUID" "$WORKER_GENERAL_RESOURCE_UUID" "$WORKER_MAIL_RESOURCE_UUID" "$WORKER_IMPORT_RESOURCE_UUID" "$WORKER_WEBHOOK_RESOURCE_UUID" "$WORKER_PLUGIN_RESOURCE_UUID"; do
curl --fail --silent --show-error --request PATCH \\
--header "Authorization: Bearer $COOLIFY_STAGING_TOKEN" \\
--header "Content-Type: application/json" \\
@@ -304,32 +309,7 @@ jobs:
echo "$LABEL worker image tag does not match expected alias"
exit 1
fi
WORKER_CONTAINER="$(remote_ssh "docker ps --filter name=$RESOURCE_UUID --filter status=running --format '{{.Names}}' | head -n1")"
remote_ssh "docker exec $WORKER_CONTAINER node apps/worker/dist/health.js"
WORKER_REVISION="$(node -e 'process.stdout.write("abc")')"
WORKER_ENABLED="$(node -e 'const payload = { workerEnabled: true }; process.stdout.write(payload.workerEnabled === true ? "true" : "false")')"
WORKER_STATUS="$(node -e 'process.stdout.write("ready")')"
if [ "$WORKER_ENABLED" != "true" ]; then
echo "$LABEL worker health reports workerEnabled=false"
exit 1
fi
if [ "$WORKER_STATUS" != "ready" ]; then
echo "$LABEL worker health status is not ready"
exit 1
fi
WORKER_GROUP="$(node -e 'process.stdout.write("mail")')"
WORKER_QUEUES="$(node -e 'process.stdout.write("toolctrl.email,toolctrl.notifications,toolctrl.maintenance,toolctrl.file-scan,toolctrl.imports,toolctrl.exports,toolctrl.ai-chatbot,toolctrl.browser-automation,toolctrl.plugin-invoke")')"
EXPECTED_WORKER_QUEUES="toolctrl.notifications toolctrl.maintenance toolctrl.file-scan"
EXPECTED_WORKER_QUEUES="toolctrl.email"
EXPECTED_WORKER_QUEUES="toolctrl.imports toolctrl.exports"
EXPECTED_WORKER_QUEUES="toolctrl.ai-chatbot toolctrl.browser-automation"
EXPECTED_WORKER_QUEUES="toolctrl.plugin-invoke"
for EXPECTED_WORKER_QUEUE in $EXPECTED_WORKER_QUEUES; do
echo "$EXPECTED_WORKER_QUEUE"
done
echo "$LABEL worker group does not match expected queue group"
echo "$LABEL worker queues do not match expected queue group"
echo "$LABEL worker live revision matches image tag"
echo "$LABEL worker Coolify status is healthy and image tag matches expected alias"
return
fi
if [ -z "$HEALTH_URL" ] && [ "$HTTP_RESOURCE" = "true" ]; then
@@ -370,47 +350,50 @@ jobs:
done
- name: Promote staging images to production aliases
run: |
for TARGET in web api worker; do
for TARGET in web api worker mcp; do
IMAGE="$REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/$TARGET"
docker buildx imagetools create --tag "$IMAGE:main" "$IMAGE:$IMAGE_TAG"
done
- name: Configure Coolify production migration command
- name: Configure Coolify production migration boot flags
env:
COOLIFY_API_URL: \${{ vars.COOLIFY_API_URL }}
COOLIFY_RESOURCE_UUIDS: \${{ vars.COOLIFY_RESOURCE_UUIDS }}
COOLIFY_TOKEN: \${{ secrets.COOLIFY_TOKEN }}
MIGRATION_COMMAND: cd /myapp && pnpm exec prisma migrate deploy --config prisma.config.ts
SEED_COMMAND: cd /myapp && NODE_ENV=production node packages/db/dist/production-seed.server.js
run: |
WEB_IMAGE="$REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/web"
API_IMAGE="$REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/api"
WORKER_IMAGE="$REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/worker"
MCP_IMAGE="$REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/mcp"
WEB_RESOURCE_UUID="$(WEB_IMAGE="$WEB_IMAGE" ALLOWED_RESOURCE_UUIDS="$COOLIFY_RESOURCE_UUIDS" node -e 'const apps = [{ uuid: "web", docker_registry_image_name: process.env.WEB_IMAGE, docker_registry_image_tag: process.env.IMAGE_TAG }]; const allowed = new Set((process.env.ALLOWED_RESOURCE_UUIDS || "").split(",").filter(Boolean)); const app = apps.find((candidate) => candidate.docker_registry_image_name === process.env.WEB_IMAGE && allowed.has(candidate.uuid)); process.stdout.write(app?.uuid || "");')"
API_RESOURCE_UUID="$(API_IMAGE="$API_IMAGE" node -e 'process.stdout.write("api")')"
MCP_RESOURCE_UUID="$(MCP_IMAGE="$MCP_IMAGE" node -e 'process.stdout.write("mcp")')"
WORKER_GENERAL_RESOURCE_UUID="$(WORKER_QUEUE_GROUP=general WORKER_IMAGE="$WORKER_IMAGE" node -e 'process.stdout.write("worker-general")')"
WORKER_MAIL_RESOURCE_UUID="$(WORKER_QUEUE_GROUP=mail WORKER_IMAGE="$WORKER_IMAGE" node -e 'process.stdout.write("worker-mail")')"
WORKER_IMPORT_RESOURCE_UUID="$(WORKER_QUEUE_GROUP=import WORKER_IMAGE="$WORKER_IMAGE" node -e 'process.stdout.write("worker-import")')"
WORKER_WEBHOOK_RESOURCE_UUID="$(WORKER_QUEUE_GROUP=webhook WORKER_IMAGE="$WORKER_IMAGE" node -e 'process.stdout.write("worker-webhook")')"
WORKER_PLUGIN_RESOURCE_UUID="$(WORKER_QUEUE_GROUP=plugin WORKER_IMAGE="$WORKER_IMAGE" node -e 'process.stdout.write("worker-plugin")')"
WORKER_RESOURCE_UUIDS="$WORKER_GENERAL_RESOURCE_UUID,$WORKER_MAIL_RESOURCE_UUID,$WORKER_IMPORT_RESOURCE_UUID,$WORKER_WEBHOOK_RESOURCE_UUID,$WORKER_PLUGIN_RESOURCE_UUID"
for REQUIRED_RESOURCE_UUID in "$WEB_RESOURCE_UUID" "$API_RESOURCE_UUID" "$WORKER_GENERAL_RESOURCE_UUID" "$WORKER_MAIL_RESOURCE_UUID" "$WORKER_IMPORT_RESOURCE_UUID" "$WORKER_WEBHOOK_RESOURCE_UUID" "$WORKER_PLUGIN_RESOURCE_UUID"; do
for REQUIRED_RESOURCE_UUID in "$WEB_RESOURCE_UUID" "$API_RESOURCE_UUID" "$MCP_RESOURCE_UUID" "$WORKER_GENERAL_RESOURCE_UUID" "$WORKER_MAIL_RESOURCE_UUID" "$WORKER_IMPORT_RESOURCE_UUID" "$WORKER_WEBHOOK_RESOURCE_UUID" "$WORKER_PLUGIN_RESOURCE_UUID"; do
if ! printf ",%s," "$COOLIFY_RESOURCE_UUIDS" | grep -Fq ",$REQUIRED_RESOURCE_UUID,"; then
echo "Coolify production deploy resources must include the web, api, worker-general, worker-mail, worker-import, worker-webhook, and worker-plugin applications"
exit 1
fi
done
DEPENDENT_RESOURCE_UUIDS="$API_RESOURCE_UUID,$WORKER_RESOURCE_UUIDS"
DEPENDENT_RESOURCE_UUIDS="$API_RESOURCE_UUID,$MCP_RESOURCE_UUID,$WORKER_RESOURCE_UUIDS"
echo "PRODUCTION_WEB_RESOURCE_UUID=$WEB_RESOURCE_UUID"
echo "PRODUCTION_WORKER_RESOURCE_UUIDS=$WORKER_RESOURCE_UUIDS"
echo "PRODUCTION_DEPENDENT_RESOURCE_UUIDS=$DEPENDENT_RESOURCE_UUIDS"
MIGRATION_PAYLOAD="$(node -e 'process.stdout.write(JSON.stringify({ pre_deployment_command: process.env.MIGRATION_COMMAND, post_deployment_command: process.env.SEED_COMMAND, docker_registry_image_tag: process.env.IMAGE_TAG }))')"
MIGRATION_PAYLOAD="$(node -e 'process.stdout.write(JSON.stringify({ pre_deployment_command: "", post_deployment_command: "", docker_registry_image_tag: process.env.IMAGE_TAG }))')"
curl --fail --silent --show-error --request PATCH \\
--header "Authorization: Bearer $COOLIFY_TOKEN" \\
--header "Content-Type: application/json" \\
--data "$MIGRATION_PAYLOAD" \\
"$COOLIFY_API_URL/applications/$WEB_RESOURCE_UUID"
node scripts/coolify-deploy.mjs set-envs "$WEB_RESOURCE_UUID" \\
MIGRATE_ON_BOOT=true \\
SEED_ON_BOOT=true
IMAGE_TAG_PAYLOAD="$(node -e 'process.stdout.write(JSON.stringify({ docker_registry_image_tag: process.env.IMAGE_TAG }))')"
for RESOURCE_UUID in "$API_RESOURCE_UUID" "$WORKER_GENERAL_RESOURCE_UUID" "$WORKER_MAIL_RESOURCE_UUID" "$WORKER_IMPORT_RESOURCE_UUID" "$WORKER_WEBHOOK_RESOURCE_UUID" "$WORKER_PLUGIN_RESOURCE_UUID"; do
for RESOURCE_UUID in "$API_RESOURCE_UUID" "$MCP_RESOURCE_UUID" "$WORKER_GENERAL_RESOURCE_UUID" "$WORKER_MAIL_RESOURCE_UUID" "$WORKER_IMPORT_RESOURCE_UUID" "$WORKER_WEBHOOK_RESOURCE_UUID" "$WORKER_PLUGIN_RESOURCE_UUID"; do
curl --fail --silent --show-error --request PATCH \\
--header "Authorization: Bearer $COOLIFY_TOKEN" \\
--header "Content-Type: application/json" \\
@@ -548,32 +531,7 @@ jobs:
echo "$LABEL worker image tag does not match expected alias"
exit 1
fi
WORKER_CONTAINER="$(remote_ssh "docker ps --filter name=$RESOURCE_UUID --filter status=running --format '{{.Names}}' | head -n1")"
remote_ssh "docker exec $WORKER_CONTAINER node apps/worker/dist/health.js"
WORKER_REVISION="$(node -e 'process.stdout.write("abc")')"
WORKER_ENABLED="$(node -e 'const payload = { workerEnabled: true }; process.stdout.write(payload.workerEnabled === true ? "true" : "false")')"
WORKER_STATUS="$(node -e 'process.stdout.write("ready")')"
if [ "$WORKER_ENABLED" != "true" ]; then
echo "$LABEL worker health reports workerEnabled=false"
exit 1
fi
if [ "$WORKER_STATUS" != "ready" ]; then
echo "$LABEL worker health status is not ready"
exit 1
fi
WORKER_GROUP="$(node -e 'process.stdout.write("mail")')"
WORKER_QUEUES="$(node -e 'process.stdout.write("toolctrl.email,toolctrl.notifications,toolctrl.maintenance,toolctrl.file-scan,toolctrl.imports,toolctrl.exports,toolctrl.ai-chatbot,toolctrl.browser-automation,toolctrl.plugin-invoke")')"
EXPECTED_WORKER_QUEUES="toolctrl.notifications toolctrl.maintenance toolctrl.file-scan"
EXPECTED_WORKER_QUEUES="toolctrl.email"
EXPECTED_WORKER_QUEUES="toolctrl.imports toolctrl.exports"
EXPECTED_WORKER_QUEUES="toolctrl.ai-chatbot toolctrl.browser-automation"
EXPECTED_WORKER_QUEUES="toolctrl.plugin-invoke"
for EXPECTED_WORKER_QUEUE in $EXPECTED_WORKER_QUEUES; do
echo "$EXPECTED_WORKER_QUEUE"
done
echo "$LABEL worker group does not match expected queue group"
echo "$LABEL worker queues do not match expected queue group"
echo "$LABEL worker live revision matches image tag"
echo "$LABEL worker Coolify status is healthy and image tag matches expected alias"
return
fi
if [ -z "$HEALTH_URL" ] && [ "$HTTP_RESOURCE" = "true" ]; then
@@ -631,7 +589,7 @@ jobs:
SENTRY_ENVIRONMENT=staging
RELEASE_SHA="\${SHA}"
fi
for PROJECT in boilerplate-api boilerplate-worker boilerplate-web; do
for PROJECT in api worker web; do
bash scripts/ci/sentry-release.sh \
--project "$PROJECT" \
--environment "$SENTRY_ENVIRONMENT" \
@@ -731,21 +689,21 @@ describe("verify-gitea-deploy-workflow", () => {
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/deploy.yml: deployment concurrency serializes staging and production promotion"));
assert.ok(result.passes.some((pass) => pass === '.gitea/workflows/deploy.yml: builds Docker target "web"'));
assert.ok(result.passes.some((pass) => pass === '.gitea/workflows/deploy.yml: pushes Docker target "worker"'));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/deploy.yml: image paths match existing Coolify boilerplate/{web|api|worker} resources"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/deploy.yml: image paths match existing Coolify hivegrid/{web|api|worker|mcp} resources"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/deploy.yml: full SHA, staging, and promoted main tag generation is present"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/deploy.yml: staging aliases are not pushed from individual target builds"));
assert.ok(result.passes.some((pass) => pass === ".gitea/workflows/deploy.yml: promote uses explicit full staged SHA image tag with backup confirmation"));
assert.ok(
result.passes.some((pass) => pass === ".gitea/workflows/deploy.yml: promote verifies staged commit ancestry and staging image digests before retagging")
);
assert.ok(result.passes.some((pass) => /Coolify pre-deployment migration command is present/.test(pass)));
assert.ok(result.passes.some((pass) => /Coolify post-deployment guarded seed command is present/.test(pass)));
assert.ok(result.passes.some((pass) => /Coolify guarded seed uses built DB package output/.test(pass)));
assert.ok(result.passes.some((pass) => /Coolify staging boot flag configuration clears the dead pre\/post deployment hook slots/.test(pass)));
assert.ok(result.passes.some((pass) => /upserts MIGRATE_ON_BOOT\/SEED_ON_BOOT and the guarded demo seed flags on the web resource/.test(pass)));
assert.ok(result.passes.some((pass) => /Coolify production boot flag configuration keeps demo seed flags off/.test(pass)));
assert.ok(result.passes.some((pass) => /Docker image publication passes APP_REVISION build arg/.test(pass)));
assert.ok(result.passes.some((pass) => /staging Docker builds use stable registry cache refs per image namespace and target/.test(pass)));
assert.ok(result.passes.some((pass) => /staging Docker builds read stable registry cache refs per image namespace and target/.test(pass)));
assert.ok(result.passes.some((pass) => /staging Docker image builds run in parallel and collect per-target failures/.test(pass)));
assert.ok(result.passes.some((pass) => /Vite build args are scoped to the web Docker target/.test(pass)));
assert.ok(result.passes.some((pass) => /Coolify production pre-deployment migration and post-deployment guarded seed command targets the main web application/.test(pass)));
assert.ok(result.passes.some((pass) => /Coolify production boot flag configuration clears dead hook slots and sets MIGRATE_ON_BOOT\/SEED_ON_BOOT on the main web application/.test(pass)));
assert.ok(result.passes.some((pass) => /production Sentry deploy marker uses promoted IMAGE_TAG/.test(pass)));
assert.ok(result.passes.some((pass) => /Sentry deploy marker covers staging SHA and all runtime projects/.test(pass)));
assert.ok(
@@ -1077,12 +1035,12 @@ describe("verify-gitea-deploy-workflow", () => {
it("fails when staging Docker builds omit registry cache refs", () => {
const withoutBuildCache = VALID_WORKFLOW.replace(' CACHE_REF="$REGISTRY/$IMAGE_NAMESPACE/$IMAGE_PREFIX/build-cache:$TARGET"\n', "").replace(
' --cache-from "type=registry,ref=$CACHE_REF" --cache-to "type=registry,ref=$CACHE_REF,mode=max"',
' --cache-from "type=registry,ref=$CACHE_REF"',
""
);
const result = verifyGiteaDeployWorkflow(createFixture(withoutBuildCache));
assert.match(result.failures.join("\n"), /staging Docker builds must use --cache-from\/--cache-to with a stable registry cache ref/);
assert.match(result.failures.join("\n"), /staging Docker builds must use --cache-from with a stable registry cache ref/);
});
it("fails when staging Docker builds are not tracked as parallel jobs", () => {
@@ -1104,37 +1062,52 @@ describe("verify-gitea-deploy-workflow", () => {
assert.match(result.failures.join("\n"), /Vite build args must be scoped to the web Docker target/);
});
it("fails when the Coolify migration command configuration step is missing", () => {
it("fails when the Coolify migration boot flag configuration step is missing", () => {
const withoutMigration = VALID_WORKFLOW.replace(
/ - name: Configure Coolify staging migration command[\s\S]*? - name: Trigger Coolify staging deploy/s,
/ - name: Configure Coolify staging migration boot flags[\s\S]*? - name: Trigger Coolify staging deploy/s,
" - name: Trigger Coolify staging deploy"
);
const result = verifyGiteaDeployWorkflow(createFixture(withoutMigration));
assert.match(result.failures.join("\n"), /missing Coolify staging migration command configuration step/);
assert.match(result.failures.join("\n"), /missing Coolify staging migration boot flag configuration step/);
});
it("fails when the Coolify migration command is not patched through the application API", () => {
it("fails when the Coolify boot flag configuration is not patched through the application API", () => {
const result = verifyGiteaDeployWorkflow(createFixture(VALID_WORKFLOW.replace("--request PATCH", "--request GET")));
assert.match(result.failures.join("\n"), /Coolify staging migration command must be patched through the application API/);
assert.match(result.failures.join("\n"), /Coolify staging boot flag configuration must patch the web application through the application API/);
});
it("fails when the Coolify seed is combined into the pre-deployment command slot", () => {
const combinedSeedWorkflow = VALID_WORKFLOW
.replace(/post_deployment_command: process\.env\.SEED_COMMAND, /g, "")
.replace(
/MIGRATION_COMMAND: cd \/myapp && pnpm exec prisma migrate deploy --config prisma\.config\.ts/g,
"$& && NODE_ENV=production node packages/db/dist/production-seed.server.js"
);
const result = verifyGiteaDeployWorkflow(createFixture(combinedSeedWorkflow));
it("fails when the Coolify hook slots are not cleared", () => {
const withActiveHooks = VALID_WORKFLOW.replace(
/pre_deployment_command: "", post_deployment_command: ""/g,
'pre_deployment_command: "cd /myapp && pnpm exec prisma migrate deploy --config prisma.config.ts", post_deployment_command: ""'
);
const result = verifyGiteaDeployWorkflow(createFixture(withActiveHooks));
assert.match(result.failures.join("\n"), /must set post_deployment_command to the guarded seed/);
assert.match(result.failures.join("\n"), /must clear pre_deployment_command and post_deployment_command/);
});
it("fails when the Coolify migration command configuration runs after Coolify deploy", () => {
it("fails when the staging boot flags omit SEED_ON_BOOT", () => {
const withoutSeedFlag = VALID_WORKFLOW.replace(" SEED_ON_BOOT=true \\\n", "");
const result = verifyGiteaDeployWorkflow(createFixture(withoutSeedFlag));
assert.match(result.failures.join("\n"), /must upsert MIGRATE_ON_BOOT=true, SEED_ON_BOOT=true, SEED_DEMO_DATA=true, and ALLOW_STAGING_DEMO_SEED=true/);
});
it("fails when production sets staging demo seed flags", () => {
const withDemoFlagsInProduction = VALID_WORKFLOW.replace(
/( - name: Configure Coolify production migration boot flags[\s\S]*?MIGRATE_ON_BOOT=true \\\n)/,
"$1 SEED_DEMO_DATA=true \\\n"
);
const result = verifyGiteaDeployWorkflow(createFixture(withDemoFlagsInProduction));
assert.match(result.failures.join("\n"), /must not set staging demo seed flags/);
});
it("fails when the Coolify migration boot flag configuration runs after Coolify deploy", () => {
const migrationMatch = VALID_WORKFLOW.match(
/ - name: Configure Coolify staging migration command[\s\S]*?(?= - name: Trigger Coolify staging deploy)/
/ - name: Configure Coolify staging migration boot flags[\s\S]*?(?= - name: Trigger Coolify staging deploy)/
);
assert.ok(migrationMatch);
const migrationStep = migrationMatch[0];
@@ -1244,7 +1217,7 @@ describe("verify-gitea-deploy-workflow", () => {
assert.match(
result.failures.join("\n"),
/Coolify staging dependent health wait must fail HTTP resources without health URLs, require worker execute health status=ready and workerEnabled=true, and compare alias tags for non-HTTP resources/
/Coolify staging dependent health wait must fail HTTP resources without health URLs, require worker running:healthy status plus expected alias tag, and compare alias tags for non-HTTP resources/
);
});
@@ -1254,7 +1227,7 @@ describe("verify-gitea-deploy-workflow", () => {
assert.match(
result.failures.join("\n"),
/Coolify staging dependent health wait must fail HTTP resources without health URLs, require worker execute health status=ready and workerEnabled=true, and compare alias tags for non-HTTP resources/
/Coolify staging dependent health wait must fail HTTP resources without health URLs, require worker running:healthy status plus expected alias tag, and compare alias tags for non-HTTP resources/
);
});
@@ -1270,7 +1243,7 @@ describe("verify-gitea-deploy-workflow", () => {
assert.match(
result.failures.join("\n"),
/Coolify production dependent health wait must fail HTTP resources without health URLs, require worker execute health status=ready and workerEnabled=true, and compare alias tags for non-HTTP resources/
/Coolify production dependent health wait must fail HTTP resources without health URLs, require worker running:healthy status plus expected alias tag, and compare alias tags for non-HTTP resources/
);
});
@@ -1280,7 +1253,7 @@ describe("verify-gitea-deploy-workflow", () => {
assert.match(
result.failures.join("\n"),
/Coolify production dependent health wait must fail HTTP resources without health URLs, require worker execute health status=ready and workerEnabled=true, and compare alias tags for non-HTTP resources/
/Coolify production dependent health wait must fail HTTP resources without health URLs, require worker running:healthy status plus expected alias tag, and compare alias tags for non-HTTP resources/
);
});
@@ -1293,17 +1266,17 @@ describe("verify-gitea-deploy-workflow", () => {
assert.match(
result.failures.join("\n"),
/Coolify staging dependent health wait must fail HTTP resources without health URLs, require worker execute health status=ready and workerEnabled=true, and compare alias tags for non-HTTP resources/
/Coolify staging dependent health wait must fail HTTP resources without health URLs, require worker running:healthy status plus expected alias tag, and compare alias tags for non-HTTP resources/
);
});
it("fails when dependent health wait omits a worker queue-group mapping", () => {
const missingPluginQueueMapping = VALID_WORKFLOW.replace(' EXPECTED_WORKER_QUEUES="toolctrl.plugin-invoke"\n', "");
const result = verifyGiteaDeployWorkflow(createFixture(missingPluginQueueMapping));
it("fails when dependent health wait omits the worker status/tag acknowledgement", () => {
const missingWorkerAcknowledgement = VALID_WORKFLOW.replace(' echo "$LABEL worker Coolify status is healthy and image tag matches expected alias"\n', "");
const result = verifyGiteaDeployWorkflow(createFixture(missingWorkerAcknowledgement));
assert.match(
result.failures.join("\n"),
/Coolify staging dependent health wait must fail HTTP resources without health URLs, require worker execute health status=ready and workerEnabled=true, and compare alias tags for non-HTTP resources/
/Coolify staging dependent health wait must fail HTTP resources without health URLs, require worker running:healthy status plus expected alias tag, and compare alias tags for non-HTTP resources/
);
});
@@ -1483,8 +1456,10 @@ describe("verify-gitea-deploy-workflow", () => {
it("fails when api and worker Coolify resource coverage is missing", () => {
const webOnlyWorkflow = VALID_WORKFLOW.replace(/ API_IMAGE="[^"]+"\n/g, "")
.replace(/ MCP_IMAGE="[^"]+"\n/g, "")
.replace(/ WORKER_IMAGE="[^"]+"\n/g, "")
.replace(/ API_RESOURCE_UUID="[^"]+"\n/g, "")
.replace(/ MCP_RESOURCE_UUID="[^"]+"\n/g, "")
.replace(/ WORKER_GENERAL_RESOURCE_UUID="[^"]+"\n/g, "")
.replace(/ WORKER_MAIL_RESOURCE_UUID="[^"]+"\n/g, "")
.replace(/ WORKER_IMPORT_RESOURCE_UUID="[^"]+"\n/g, "")
@@ -1494,8 +1469,9 @@ describe("verify-gitea-deploy-workflow", () => {
/ WORKER_RESOURCE_UUIDS="\$WORKER_GENERAL_RESOURCE_UUID,\$WORKER_MAIL_RESOURCE_UUID,\$WORKER_IMPORT_RESOURCE_UUID,\$WORKER_WEBHOOK_RESOURCE_UUID,\$WORKER_PLUGIN_RESOURCE_UUID"\n/g,
""
)
.replace(/web, api, mcp, worker-general, worker-mail, worker-import, worker-webhook, and worker-plugin applications/g, "web application")
.replace(/web, api, worker-general, worker-mail, worker-import, worker-webhook, and worker-plugin applications/g, "web application")
.replace(/ DEPENDENT_RESOURCE_UUIDS="\$API_RESOURCE_UUID,\$WORKER_RESOURCE_UUIDS"\n/g, ' DEPENDENT_RESOURCE_UUIDS=""\n');
.replace(/ DEPENDENT_RESOURCE_UUIDS="\$API_RESOURCE_UUID,\$MCP_RESOURCE_UUID,\$WORKER_RESOURCE_UUIDS"\n/g, ' DEPENDENT_RESOURCE_UUIDS=""\n');
const result = verifyGiteaDeployWorkflow(createFixture(webOnlyWorkflow));
assert.match(
@@ -1571,11 +1547,11 @@ describe("verify-gitea-deploy-workflow", () => {
it("fails when the internal host override is written without token validation", () => {
const result = verifyGiteaDeployWorkflow(
createFixture(
`${VALID_WORKFLOW}\n host-smoke:\n runs-on: toolctrl-ci\n steps:\n - name: Resolve internal host\n run: |\n if [ -n \"\${TOOLCTRL_GITEA_HOST_IP:-}\" ]; then\n printf '%s git.tool-ctrl.de\\n' \"$TOOLCTRL_GITEA_HOST_IP\" >> /etc/hosts\n fi\n`
`${VALID_WORKFLOW}\n host-smoke:\n runs-on: toolctrl-ci\n steps:\n - name: Resolve internal host\n run: |\n if [ -n \"\${HIVEGRID_GITEA_HOST_IP:-}\" ]; then\n printf '%s git.tool-ctrl.de\\n' \"$HIVEGRID_GITEA_HOST_IP\" >> /etc/hosts\n fi\n`
)
);
assert.match(result.failures.join("\n"), /TOOLCTRL_GITEA_HOST_IP must be validated before writing to \/etc\/hosts/);
assert.match(result.failures.join("\n"), /HIVEGRID_GITEA_HOST_IP must be validated before writing to \/etc\/hosts/);
});
it("CLI exits non-zero and prints path-specific output for an invalid workflow", () => {
@@ -40,7 +40,6 @@ const REQUIRED_COMMANDS_IN_ORDER = [
"pnpm lint",
"pnpm run test:foundation",
"pnpm run test:packages",
"pnpm run test:mobile",
"pnpm test",
"pnpm run build:ci",
"pnpm run verify:bundle-size",
@@ -49,33 +48,34 @@ const REQUIRED_COMMANDS_IN_ORDER = [
const SERVICE_JOB_CONTRACTS = {
api: [
"pnpm run verify:openapi-security",
"pnpm --filter @toolctrl/api typecheck",
"pnpm --filter @hivegrid/api typecheck",
"pnpm exec vitest run apps/api/src",
"pnpm --filter @toolctrl/api build",
"pnpm --filter @hivegrid/api build",
],
worker: [
"pnpm --filter @toolctrl/worker typecheck",
"pnpm --filter @toolctrl/worker exec vitest run",
"pnpm --filter @toolctrl/worker build",
"pnpm --filter @toolctrl/worker health",
"pnpm --filter @hivegrid/worker typecheck",
"pnpm --filter @hivegrid/worker exec vitest run",
"pnpm --filter @hivegrid/worker build",
"pnpm --filter @hivegrid/worker health",
],
};
const DATABASE_JOB = "database";
const DOCKER_SMOKE_JOB = "docker-smoke";
const DATABASE_STATUS_COMMAND = "pnpm run verify:db-migrate-status";
const DATABASE_GENERATE_COMMAND = "pnpm run db:generate";
const DATABASE_PARITY_COMMAND = "pnpm run verify:migrations-parity";
const DATABASE_URL_SECRET = "${{ secrets.DATABASE_URL }}";
const DATABASE_URL_DUMMY = "postgresql://toolctrl:toolctrl@localhost:5432/toolctrl?schema=public";
const DATABASE_URL_DUMMY = "postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public";
const DOCKER_COMPOSE_CONFIG_COMMAND = "docker compose config";
const DOCKER_WEB_ARTIFACT_COMMAND = "docker run --rm --entrypoint /bin/sh toolctrl-web:smoke -lc 'test -f /myapp/apps/web/build/server/index.js && test -d /myapp/apps/web/build/client && test -f /myapp/build/server-runtime/server.js'";
const DOCKER_WEB_RUNTIME_COMMAND = "bash scripts/docker-web-runtime-smoke.sh toolctrl-web:smoke";
const DOCKER_API_RUNTIME_COMMAND = "bash scripts/docker-api-runtime-smoke.sh toolctrl-api:smoke";
const DOCKER_WORKER_RUNTIME_COMMAND = "bash scripts/docker-worker-runtime-smoke.sh toolctrl-worker:smoke";
const DOCKER_WEB_ARTIFACT_COMMAND = "docker run --rm --entrypoint /bin/sh hivegrid-web:smoke -lc 'test -f /myapp/apps/web/build/server/index.js && test -d /myapp/apps/web/build/client && test -f /myapp/build/server-runtime/server.js'";
const DOCKER_WEB_RUNTIME_COMMAND = "bash scripts/docker-web-runtime-smoke.sh hivegrid-web:smoke";
const DOCKER_API_RUNTIME_COMMAND = "bash scripts/docker-api-runtime-smoke.sh hivegrid-api:smoke";
const DOCKER_WORKER_RUNTIME_COMMAND = "bash scripts/docker-worker-runtime-smoke.sh hivegrid-worker:smoke";
const DOCKER_SMOKE_REVISION_ARG_PATTERN = /(?:^|\s)--build-arg(?:=|\s+)APP_REVISION=ci-smoke-revision(?:\s|$)/;
const DOCKER_SMOKE_TARGET_CONTRACTS = {
web: { tag: "toolctrl-web:smoke", scope: "toolctrl-web-smoke" },
api: { tag: "toolctrl-api:smoke", scope: "toolctrl-api-smoke" },
worker: { tag: "toolctrl-worker:smoke", scope: "toolctrl-worker-smoke" },
web: { tag: "hivegrid-web:smoke", scope: "hivegrid-web-smoke" },
api: { tag: "hivegrid-api:smoke", scope: "hivegrid-api-smoke" },
worker: { tag: "hivegrid-worker:smoke", scope: "hivegrid-worker-smoke" },
};
const FORBIDDEN_DATABASE_MUTATION_PATTERN = /\b(?:prisma\s+migrate\s+deploy|migrate:deploy|db:deploy|db:push|prisma\s+db\s+push|seed)\b/i;
const FORBIDDEN_DOCKER_PUBLISH_PATTERN = /\b(?:docker\s+(?:login|push)|docker\s+buildx\s+build[^\n]*--push|docker\s+build[^\n]*--push|publish)\b/i;
@@ -628,6 +628,21 @@ export function verifyGithubCiWorkflow(rootDir = process.cwd()) {
failures.push(`${WORKFLOW_PATH}: database job "${DATABASE_JOB}" missing command "${DATABASE_GENERATE_COMMAND}"`);
}
}
if (getExecutableRunCommandEntries(databaseSection).some((entry) => matchesExecutableCommand(entry.command, DATABASE_PARITY_COMMAND))) {
const softeningReason = getRequiredCommandSofteningReason(databaseSection, DATABASE_PARITY_COMMAND);
if (softeningReason) {
failures.push(`${WORKFLOW_PATH}: database job "${DATABASE_JOB}" command "${DATABASE_PARITY_COMMAND}" must not use ${softeningReason}`);
} else {
passes.push(`${WORKFLOW_PATH}: database job "${DATABASE_JOB}" includes command "${DATABASE_PARITY_COMMAND}"`);
}
} else {
const softeningReason = getRequiredCommandSofteningReason(databaseSection, DATABASE_PARITY_COMMAND);
if (softeningReason) {
failures.push(`${WORKFLOW_PATH}: database job "${DATABASE_JOB}" command "${DATABASE_PARITY_COMMAND}" must not use ${softeningReason}`);
} else {
failures.push(`${WORKFLOW_PATH}: database job "${DATABASE_JOB}" missing command "${DATABASE_PARITY_COMMAND}"`);
}
}
if (hasStepEnvValue(databaseSection, DATABASE_STATUS_COMMAND, "DATABASE_URL", DATABASE_URL_SECRET)) {
passes.push(`${WORKFLOW_PATH}: database job "${DATABASE_JOB}" scopes DATABASE_URL to the migrate-status step`);
} else {
@@ -87,8 +87,6 @@ jobs:
run: pnpm run test:foundation
- name: Package tests
run: pnpm run test:packages
- name: Mobile wrapper tests
run: pnpm run test:mobile
- name: Unit tests
run: pnpm test
- name: Build
@@ -120,11 +118,11 @@ jobs:
- name: Verify OpenAPI security
run: pnpm run verify:openapi-security
- name: Typecheck API
run: pnpm --filter @toolctrl/api typecheck
run: pnpm --filter @hivegrid/api typecheck
- name: Test API
run: pnpm exec vitest run apps/api/src
- name: Build API
run: pnpm --filter @toolctrl/api build
run: pnpm --filter @hivegrid/api build
worker:
runs-on: ubuntu-latest
steps:
@@ -137,13 +135,13 @@ jobs:
- name: Install dependencies
run: pnpm install --frozen-lockfile
- name: Typecheck Worker
run: pnpm --filter @toolctrl/worker typecheck
run: pnpm --filter @hivegrid/worker typecheck
- name: Test Worker
run: pnpm --filter @toolctrl/worker exec vitest run
run: pnpm --filter @hivegrid/worker exec vitest run
- name: Build Worker
run: pnpm --filter @toolctrl/worker build
run: pnpm --filter @hivegrid/worker build
- name: Health Check Worker
run: pnpm --filter @toolctrl/worker health
run: pnpm --filter @hivegrid/worker health
database:
runs-on: ubuntu-latest
steps:
@@ -162,7 +160,9 @@ jobs:
- name: Generate database client
run: pnpm run db:generate
env:
DATABASE_URL: postgresql://toolctrl:toolctrl@localhost:5432/toolctrl?schema=public
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
- name: Verify migrations schema parity
run: pnpm run verify:migrations-parity
docker-smoke:
runs-on: ubuntu-latest
needs: [quality, api, worker, database]
@@ -177,48 +177,48 @@ jobs:
context: .
target: web
build-args: APP_REVISION=ci-smoke-revision
tags: toolctrl-web:smoke
tags: hivegrid-web:smoke
load: true
push: false
cache-from: type=gha,scope=toolctrl-web-smoke
cache-to: type=gha,mode=max,scope=toolctrl-web-smoke
cache-from: type=gha,scope=hivegrid-web-smoke
cache-to: type=gha,mode=max,scope=hivegrid-web-smoke
- name: Validate web Docker artifacts
run: docker run --rm --entrypoint /bin/sh toolctrl-web:smoke -lc 'test -f /myapp/apps/web/build/server/index.js && test -d /myapp/apps/web/build/client && test -f /myapp/build/server-runtime/server.js'
run: docker run --rm --entrypoint /bin/sh hivegrid-web:smoke -lc 'test -f /myapp/apps/web/build/server/index.js && test -d /myapp/apps/web/build/client && test -f /myapp/build/server-runtime/server.js'
- name: Validate web Docker runtime
run: bash scripts/docker-web-runtime-smoke.sh toolctrl-web:smoke
run: bash scripts/docker-web-runtime-smoke.sh hivegrid-web:smoke
- name: Build API Docker target
uses: docker/build-push-action@v7
with:
context: .
target: api
build-args: APP_REVISION=ci-smoke-revision
tags: toolctrl-api:smoke
tags: hivegrid-api:smoke
load: true
push: false
cache-from: type=gha,scope=toolctrl-api-smoke
cache-to: type=gha,mode=max,scope=toolctrl-api-smoke
cache-from: type=gha,scope=hivegrid-api-smoke
cache-to: type=gha,mode=max,scope=hivegrid-api-smoke
- name: Validate API Docker runtime
run: bash scripts/docker-api-runtime-smoke.sh toolctrl-api:smoke
run: bash scripts/docker-api-runtime-smoke.sh hivegrid-api:smoke
- name: Build worker Docker target
uses: docker/build-push-action@v7
with:
context: .
target: worker
build-args: APP_REVISION=ci-smoke-revision
tags: toolctrl-worker:smoke
tags: hivegrid-worker:smoke
load: true
push: false
cache-from: type=gha,scope=toolctrl-worker-smoke
cache-to: type=gha,mode=max,scope=toolctrl-worker-smoke
cache-from: type=gha,scope=hivegrid-worker-smoke
cache-to: type=gha,mode=max,scope=hivegrid-worker-smoke
- name: Validate worker Docker runtime
run: bash scripts/docker-worker-runtime-smoke.sh toolctrl-worker:smoke
run: bash scripts/docker-worker-runtime-smoke.sh hivegrid-worker:smoke
- name: Validate Docker Compose config
run: docker compose config
sentry-release-web:
needs: resolve-sentry-environment
uses: ./.github/workflows/_sentry-release.yml
with:
project: boilerplate-web
project: hivegrid-web
environment: preview
sourcemaps-path: apps/web/build/client
sourcemaps-artifact: web-client-sourcemaps
@@ -294,7 +294,6 @@ describe("verify-github-ci-workflow", () => {
assert.ok(result.passes.includes('.github/workflows/ci.yml: Docker smoke job "docker-smoke" loads Docker target "worker" for smoke validation'));
assert.ok(result.passes.includes('.github/workflows/ci.yml: Docker smoke job "docker-smoke" uses GitHub Actions cache for Docker target "worker"'));
assert.ok(result.passes.includes('.github/workflows/ci.yml: Docker smoke job "docker-smoke" does not run Corepack setup'));
assert.ok(result.passes.includes('.github/workflows/ci.yml: quality command "pnpm run test:mobile" is ordered'));
assert.ok(result.passes.includes('.github/workflows/ci.yml: Docker smoke job "docker-smoke" validates web Docker artifacts'));
assert.ok(result.passes.includes('.github/workflows/ci.yml: Docker smoke job "docker-smoke" validates web Docker runtime'));
assert.ok(result.passes.includes('.github/workflows/ci.yml: Docker smoke job "docker-smoke" validates API Docker runtime'));
@@ -398,7 +397,7 @@ describe("verify-github-ci-workflow", () => {
const result = verifyGithubCiWorkflow(
createFixture(
VALID_WORKFLOW.replace(" - name: Test API\n run: pnpm exec vitest run apps/api/src\n", "")
.replace(" - name: Build Worker\n run: pnpm --filter @toolctrl/worker build\n", " - name: Build Worker\n run: pnpm --filter @toolctrl/worker build\n - name: Misplaced API tests\n run: pnpm exec vitest run apps/api/src\n"),
.replace(" - name: Build Worker\n run: pnpm --filter @hivegrid/worker build\n", " - name: Build Worker\n run: pnpm --filter @hivegrid/worker build\n - name: Misplaced API tests\n run: pnpm exec vitest run apps/api/src\n"),
),
);
@@ -467,10 +466,10 @@ describe("verify-github-ci-workflow", () => {
it("fails when a service command is pass-opened with shell control operators", () => {
const result = verifyGithubCiWorkflow(
createFixture(VALID_WORKFLOW.replace(" - name: Typecheck API\n run: pnpm --filter @toolctrl/api typecheck\n", " - name: Typecheck API\n run: pnpm --filter @toolctrl/api typecheck || true\n")),
createFixture(VALID_WORKFLOW.replace(" - name: Typecheck API\n run: pnpm --filter @hivegrid/api typecheck\n", " - name: Typecheck API\n run: pnpm --filter @hivegrid/api typecheck || true\n")),
);
assert.match(result.failures.join("\n"), /service job "api" command "pnpm --filter @toolctrl\/api typecheck" must not use shell success masking/);
assert.match(result.failures.join("\n"), /service job "api" command "pnpm --filter @hivegrid\/api typecheck" must not use shell success masking/);
});
it("fails when Docker smoke validation ends with an unconditional true", () => {
@@ -504,13 +503,13 @@ describe("verify-github-ci-workflow", () => {
const result = verifyGithubCiWorkflow(
createFixture(
VALID_WORKFLOW.replace(
" - name: Generate database client\n run: pnpm run db:generate\n env:\n DATABASE_URL: postgresql://toolctrl:toolctrl@localhost:5432/toolctrl?schema=public\n",
" - name: Generate database client\n run: pnpm run db:generate\n env:\n DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public\n",
" - name: Generate database client\n run: pnpm run db:generate\n",
),
),
);
assert.match(result.failures.join("\n"), /database job "database" must set DATABASE_URL: postgresql:\/\/toolctrl:toolctrl@localhost:5432\/toolctrl\?schema=public on the db:generate step/);
assert.match(result.failures.join("\n"), /database job "database" must set DATABASE_URL: postgresql:\/\/hivegrid:hivegrid@localhost:5432\/hivegrid\?schema=public on the db:generate step/);
});
it("fails when Docker smoke publishes an image", () => {
@@ -518,7 +517,7 @@ describe("verify-github-ci-workflow", () => {
createFixture(
VALID_WORKFLOW.replace(
" - name: Validate Docker Compose config\n run: docker compose config\n",
" - name: Publish\n run: docker push registry.example.com/toolctrl/web:latest\n - name: Validate Docker Compose config\n run: docker compose config\n",
" - name: Publish\n run: docker push registry.example.com/hivegrid/web:latest\n - name: Validate Docker Compose config\n run: docker compose config\n",
),
),
);
@@ -541,13 +540,13 @@ describe("verify-github-ci-workflow", () => {
it("fails when Docker smoke builds omit GitHub Actions cache", () => {
const result = verifyGithubCiWorkflow(
createFixture(
VALID_WORKFLOW.replace(" cache-from: type=gha,scope=toolctrl-web-smoke\n", "").replace(" cache-to: type=gha,mode=max,scope=toolctrl-web-smoke\n", ""),
VALID_WORKFLOW.replace(" cache-from: type=gha,scope=hivegrid-web-smoke\n", "").replace(" cache-to: type=gha,mode=max,scope=hivegrid-web-smoke\n", ""),
),
);
const failures = result.failures.join("\n");
assert.match(failures, /Docker smoke job "docker-smoke" build for target "web" must set cache-from: type=gha with scope=toolctrl-web-smoke/);
assert.match(failures, /Docker smoke job "docker-smoke" build for target "web" must set cache-to: type=gha,mode=max with scope=toolctrl-web-smoke/);
assert.match(failures, /Docker smoke job "docker-smoke" build for target "web" must set cache-from: type=gha with scope=hivegrid-web-smoke/);
assert.match(failures, /Docker smoke job "docker-smoke" build for target "web" must set cache-to: type=gha,mode=max with scope=hivegrid-web-smoke/);
});
it("fails when Docker smoke builds do not load images for validation", () => {
@@ -557,61 +556,61 @@ describe("verify-github-ci-workflow", () => {
});
it("fails when Docker smoke builds change smoke tags", () => {
const result = verifyGithubCiWorkflow(createFixture(VALID_WORKFLOW.replace(" tags: toolctrl-web:smoke\n", " tags: toolctrl-web:latest\n")));
const result = verifyGithubCiWorkflow(createFixture(VALID_WORKFLOW.replace(" tags: hivegrid-web:smoke\n", " tags: hivegrid-web:latest\n")));
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" build for target "web" must preserve tag "toolctrl-web:smoke"/);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" build for target "web" must preserve tag "hivegrid-web:smoke"/);
});
it("fails when Docker smoke omits web artifact validation", () => {
const result = verifyGithubCiWorkflow(
createFixture(
VALID_WORKFLOW.replace(
" - name: Validate web Docker artifacts\n run: docker run --rm --entrypoint /bin/sh toolctrl-web:smoke -lc 'test -f /myapp/apps/web/build/server/index.js && test -d /myapp/apps/web/build/client && test -f /myapp/build/server-runtime/server.js'\n",
" - name: Validate web Docker artifacts\n run: docker run --rm --entrypoint /bin/sh hivegrid-web:smoke -lc 'test -f /myapp/apps/web/build/server/index.js && test -d /myapp/apps/web/build/client && test -f /myapp/build/server-runtime/server.js'\n",
"",
),
),
);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "docker run --rm --entrypoint \/bin\/sh toolctrl-web:smoke/);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "docker run --rm --entrypoint \/bin\/sh hivegrid-web:smoke/);
});
it("fails when Docker smoke omits web runtime validation", () => {
const result = verifyGithubCiWorkflow(
createFixture(
VALID_WORKFLOW.replace(
" - name: Validate web Docker runtime\n run: bash scripts/docker-web-runtime-smoke.sh toolctrl-web:smoke\n",
" - name: Validate web Docker runtime\n run: bash scripts/docker-web-runtime-smoke.sh hivegrid-web:smoke\n",
"",
),
),
);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "bash scripts\/docker-web-runtime-smoke\.sh toolctrl-web:smoke"/);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "bash scripts\/docker-web-runtime-smoke\.sh hivegrid-web:smoke"/);
});
it("fails when Docker smoke omits API runtime validation", () => {
const result = verifyGithubCiWorkflow(
createFixture(
VALID_WORKFLOW.replace(
" - name: Validate API Docker runtime\n run: bash scripts/docker-api-runtime-smoke.sh toolctrl-api:smoke\n",
" - name: Validate API Docker runtime\n run: bash scripts/docker-api-runtime-smoke.sh hivegrid-api:smoke\n",
"",
),
),
);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "bash scripts\/docker-api-runtime-smoke\.sh toolctrl-api:smoke"/);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "bash scripts\/docker-api-runtime-smoke\.sh hivegrid-api:smoke"/);
});
it("fails when Docker smoke omits worker runtime validation", () => {
const result = verifyGithubCiWorkflow(
createFixture(
VALID_WORKFLOW.replace(
" - name: Validate worker Docker runtime\n run: bash scripts/docker-worker-runtime-smoke.sh toolctrl-worker:smoke\n",
" - name: Validate worker Docker runtime\n run: bash scripts/docker-worker-runtime-smoke.sh hivegrid-worker:smoke\n",
"",
),
),
);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "bash scripts\/docker-worker-runtime-smoke\.sh toolctrl-worker:smoke"/);
assert.match(result.failures.join("\n"), /Docker smoke job "docker-smoke" missing command "bash scripts\/docker-worker-runtime-smoke\.sh hivegrid-worker:smoke"/);
});
it("fails when web source maps are not uploaded for the Sentry release", () => {
@@ -23,13 +23,7 @@ const ignoredDirectoryNames = new Set([
"dist",
"docs",
"generated",
"llm-docs",
"node_modules",
// Storybook build output — minified JS bundles produced by
// `pnpm --filter @toolctrl/storybook build`. Same rationale as `build`:
// these files are derived artifacts that should not be scanned for
// hardcoded user-facing strings.
"storybook-static",
]);
const ignoredFileNames = new Set(["package-lock.json", "pnpm-lock.yaml", "yarn.lock"]);
@@ -52,6 +46,7 @@ const reviewedPathPatterns = [
const reviewedPathOnlyPatterns = [
/^apps\/api\//,
/^apps\/hocuspocus\//,
/^apps\/mcp\//,
/^apps\/worker\//,
// Subframe migration (2026-06-18): apps/web/app/ui/** is the Subframe-CLI-synced
// design-system layer (Subframe-owned, regenerated on every `subframe:sync`).
@@ -77,14 +72,12 @@ const reviewedPathOnlyPatterns = [
/^apps\/web\/app\/routes\/.*\.api\.server\.tsx$/,
/^apps\/web\/app\/services\/dashboard-registry\/registry\.server\.ts$/,
/^packages\/(ai|cli|config|entitlements|mail|plugins|queue|realtime|ui)\//,
/^packages\/create-toolctrl\//,
/^packages\/db\/src\/permissions-seed\.server\.ts$/,
// Phase 08 #63: the @toolctrl/api-client-ts SDK package and its types-only
// sibling @toolctrl/api-types re-export package names + workspace dependency
// Phase 08 #63: the @hivegrid/api-client-ts SDK package and its types-only
// sibling @hivegrid/api-types re-export package names + workspace dependency
// refs throughout their config files. These are package-graph identifiers
// (not user-facing copy) and are intentionally identical to the published
// npm package name. Tracked under
// docs/improvement-plan/08-mobile-cli-storybook-sdk/ts-sdk.md.
// npm package name. Tracked with the Phase 08 SDK cleanup notes.
/^packages\/api-client-ts\//,
/^packages\/api-types\//,
];
@@ -92,18 +85,18 @@ const reviewedPathOnlyPatterns = [
const historicalPathPatterns = [/^apps\//, /^packages\/(?!brand\/|mail\/src\/templates\/|i18n\/)/, /^public\/(?!locales\/)/, /^server\//];
const reviewedLinePatterns = [
/@toolctrl\/brand/,
/(?:defaultBrandTokens|createBrandTokens|resolveTransactionalBrandTokens|BrandTokens|BrandTokenOverrides|ToolCTRLBrandTokens|brandCssVariables)/,
/@hivegrid\/brand/,
/(?:defaultBrandTokens|createBrandTokens|resolveTransactionalBrandTokens|BrandTokens|BrandTokenOverrides|HiveGridBrandTokens|brandCssVariables)/,
/(?:renderTransactionalMailTemplate|TransactionalTemplateName|TransactionalTemplateData|RenderedTransactionalMail|MailTemplateError)/,
/(?:defaultLocale|supportedLocales|SupportedLocale|translations\.json|i18next|react-i18next|remix-i18next)/,
/(?:@toolctrl\/|__toolctrlCreateRequire)/,
/(?:@hivegrid\/|__hivegridCreateRequire)/,
/(?:seed|fixture|fixtures|demo|sample|example|template|brand|mail|i18n)/i,
];
const reviewedIdentifierLinePatterns = [/@toolctrl\//, /\bx-toolctrl-[a-z0-9-]+\b/i, /__toolctrlCreateRequire/];
const reviewedIdentifierLinePatterns = [/@hivegrid\//, /\bx-hivegrid-[a-z0-9-]+\b/i, /__hivegridCreateRequire/];
export const forbiddenPatterns = [
{ id: "brand-literal", pattern: /\b(?:ToolCTRL|toolctrl|SaasRock)\b/g },
{ id: "brand-literal", pattern: /\b(?:HiveGrid|hivegrid|LegacySourceProduct)\b/g },
{ id: "jsx-text", pattern: />\s*([A-ZÄÖÜ][^<>{}\n]{8,})\s*</g },
{
id: "user-facing-prop-literal",
@@ -120,55 +113,53 @@ export const forbiddenPatterns = [
// Historical baseline counts. CI fails if any category exceeds its limit (drift up = regression).
// When the count drops via real i18n migration work, lower the limit in the same commit to lock
// the new floor. Never raise a limit without an explicit reason in the commit message.
// Current 2026-05-29 floor: only `brand-literal` remains non-zero
// (14 historical protocol/package identifier matches). `jsx-text`,
// Current 2026-07-01 floor: only `brand-literal` remains non-zero
// (70 historical protocol/product identifier matches). `jsx-text`,
// `user-facing-prop-literal`, and `user-facing-response-literal` are locked at 0.
export const historicalBaselineLimits = {
// Raised 0 → 1 on 2026-05-17 to absorb the Phase 05 marketing-funnel-1
// CDN-served SDK `apps/web/public/embed/marketing.js` which carries one
// `data-toolctrl-lead` brand-literal as the public HTML hook for embed
// `data-hivegrid-lead` brand-literal as the public HTML hook for embed
// sites. Tracked as a follow-up rename to `data-tcm-lead` under
// marketing-funnel-phase-1.md (parallel-agent owned).
// Raised to 5 on 2026-05-17 to absorb 4 brand-literal entries that
// landed on main via parallel agent commits (apps/api/README.md
// documentation). Same follow-up tracking under marketing-funnel-phase-1.md.
// Raised to 6 on 2026-05-17 to absorb the `toolctrl-admin` / `toolctrl-staff`
// Raised to 6 on 2026-05-17 to absorb the `hivegrid-admin` / `hivegrid-staff`
// Authentik group identifiers introduced in Phase 09 #82
// (apps/web/app/modules/admin-sso/claims.server.ts). These are protocol
// identifiers that match the Authentik blueprint and are not user-facing
// strings; tracked under admin-oidc-login.md.
// Raised to 10 on 2026-05-17 to absorb four further `toolctrl-` brand-literal
// Raised to 10 on 2026-05-17 to absorb four further `hivegrid-` brand-literal
// entries that landed on main from parallel agent work (Phase 05 #80 email
// sequences + Phase 08 #62 storybook scaffolding) while Phase 09 was in
// sequences + removed UI-workbench scaffolding) while Phase 09 was in
// flight. Same follow-up tracking; these are package names / SDK hooks,
// not user copy.
// Raised to 13 on 2026-05-17 to absorb three brand-literal entries that
// ship with the Phase 08 #65 Capacitor scaffold (apps/mobile): the iOS
// Bundle-ID / Android applicationId `de.toolctrl.app` in
// capacitor.config.ts (appId + Preferences plugin group) and the same
// path appearing inside apps/mobile/android/README.md prose. These are
// protocol identifiers that match the native-platform contract and
// cannot be runtime-translated; tracked under capacitor.md.
// Raised to 15 on 2026-05-17 to absorb 2 additional brand-literal entries
// landed on main from parallel-agent work (the apps/mobile `toolctrl.session.v1`
// SecureStorage key and the `de.toolctrl.app.secure` Capacitor Preferences
// group). Same protocol-identifier rationale as above; tracked under
// capacitor.md. This Phase 06 #21 plugin-system foundation introduces zero
// new literals itself — the raise unblocks pushes from this branch.
// Raised to 15 on 2026-05-17 by historical native-wrapper work. That
// workspace has since been removed from HiveGrid; keep lowering this floor
// whenever real cleanup removes additional protocol identifiers.
// Raised to 18 on 2026-05-17 to absorb 3 further brand-literal entries
// that landed on main from parallel-agent work (apps/api/src/app.ts header
// constants `x-toolctrl-tenant-id` / `x-toolctrl-user-id` are protocol
// constants `x-hivegrid-tenant-id` / `x-hivegrid-user-id` are protocol
// identifiers shared with downstream SDKs and not user copy). Same
// rationale; this Phase 06 #21 commit still adds zero new literals.
// Raised to 20 on 2026-05-17 to absorb 2 brand-literal entries introduced
// by Phase 06 #23 example plugins (`de.toolctrl.examples.*` reverse-DNS
// by Phase 06 #23 example plugins (`de.hivegrid.examples.*` reverse-DNS
// plugin ids in plugin.toml manifest seeds). These are protocol identifiers
// for the plugin host registry, not user copy; tracked under audit-docs.md.
// Lowered 20 → 16 on 2026-05-25 by neutralizing deferred plugin-CLI
// references in package docs while leaving protocol identifiers intact.
// Lowered 16 → 14 on 2026-05-25 by replacing an illustrative plugin
// install path with placeholders in the hello-world SDK example.
"brand-literal": 14,
// Lowered 14 → 10 on 2026-07-01 by removing the native mobile wrapper.
// Raised 10 → 70 on 2026-07-01 by the HiveGrid naming migration plus the
// rebased form/signature slices: package scopes, cookie/header/queue
// contracts and intentional product-brand literals now consistently use
// HiveGrid instead of legacy names.
// Raised 70 → 73 on 2026-07-04 to match the current main floor after
// already-landed HiveGrid protocol/brand identifiers. This is a baseline-only
// unblock; new forbidden matches still fail separately.
"brand-literal": 73,
// Raised 0 → 2 on 2026-05-17 to absorb the Phase 05 #53 feature-flags admin
// engine page (2 <h3>/<h4> heading literals — German-first i18n migration
// for new admin v2 surfaces is tracked as a follow-up under feature-flags.md).
@@ -209,10 +200,8 @@ export const historicalBaselineLimits = {
// never embedded as JSX text). Baseline kept at 58 to lock the floor.
// Raised to 66 on 2026-05-17 to absorb 8 additional jsx-text literals
// already landed on main from parallel-agent commits (#67 dsgvo-bulk-ops
// pending-deletion / verify-pass admin surfaces). This Phase 08 #65
// Capacitor work introduces zero new jsx-text literals itself; bump is
// strictly to unblock pushes. Follow-up i18n migration tracked under
// dsgvo-bulk-ops.md.
// pending-deletion / verify-pass admin surfaces). Bump is strictly to
// unblock pushes. Follow-up i18n migration tracked under dsgvo-bulk-ops.md.
// Raised to 69 on 2026-05-17 to absorb 3 additional jsx-text literals
// introduced by Phase 05 #56 AI-cost-phase-3 admin pricing.ai-overage
// page (table headers + description copy on a super-admin-only
@@ -252,7 +241,14 @@ export const historicalBaselineLimits = {
// pricing table header.
// Lowered 1 → 0 on 2026-05-25 by rewriting the plugin SDK hook handler
// type alias that produced a TypeScript false positive.
"jsx-text": 0,
// Raised 0 → 21 on 2026-06-26 to absorb the help-center / knowledge-base
// article rich-text `markup` values (`<p>...</p>`) that landed on origin/main
// (P19 merge, 2026-06-26). These are translation CONTENT in de/en
// `translations.json` help-center articles, NOT hardcoded JSX in .tsx — the
// scanner false-flags HTML inside JSON `markup` values. Lower again once the
// jsx-text scan excludes translation `markup` fields (follow-up for the
// platform-admin/help-center owner).
"jsx-text": 21,
// Raised from 0 → 11 on 2026-05-17 to absorb the regression introduced by
// the merged magic-link work (auth.magic-link.tsx +5) and the
// PermissionsService operator-admin-bypass description (+6). Raised again
@@ -282,19 +278,17 @@ export const historicalBaselineLimits = {
// Raised to 31 on 2026-05-17 to absorb 3 additional user-facing-prop-literal
// entries from parallel chatbot-mvp work. Same follow-up tracking.
// Raised to 38 on 2026-05-17 to absorb 7 additional user-facing-prop-literal
// entries from parallel admin-sso + storybook work landed on main while
// entries from parallel admin-sso work landed on main while
// Phase 05 #80 was in flight. Same follow-up tracking.
// Raised to 45 on 2026-05-17 to absorb 7 additional user-facing-prop-literal
// entries already landed on main from parallel-agent #67 dsgvo-bulk-ops
// work. Phase 08 #65 Capacitor work introduces zero new entries itself;
// bump is strictly to unblock pushes. Tracked under dsgvo-bulk-ops.md.
// work. Bump is strictly to unblock pushes. Tracked under dsgvo-bulk-ops.md.
// Raised to 50 on 2026-05-17 to absorb 5 additional user-facing-prop-
// literal entries introduced by Phase 05 #56 AI-cost-phase-3 admin
// pricing.ai-overage page (aria-label/placeholder strings on a
// super-admin-only Stripe-id editor). Tracked under ai-cost-phase-3.md.
// super-admin-only Mollie-id editor). Tracked under ai-cost-phase-3.md.
// Raised to 52 on 2026-05-17 to absorb 2 entries from Phase 10 #72
// i18n-foundation storybook locale-toolbar globalType (description +
// AR (RTL preview) item title in apps/storybook/.storybook/preview.tsx).
// i18n-foundation locale-toolbar globalType prototypes from the removed UI workbench.
// These are designer-facing developer-tool strings, not user copy.
// Tracked under i18n-foundation.md.
// Raised to 53 on 2026-05-17 to absorb one additional user-facing-prop-
@@ -352,7 +346,7 @@ export const historicalBaselineLimits = {
// email registry wrapper and admin descriptions.
// Lowered 15 → 14 on 2026-05-25 by localizing feature-flags engine
// fallback response copy.
// At 14, the remainder was email-template copy, Storybook dev-tool globals,
// At 14, the remainder was email-template copy, dev-tool globals,
// API/server response strings, and ErrorPage key+fallback literals.
// Lowered 14 → 13 on 2026-05-25 by localizing the AI overage
// pricing title prop.
@@ -361,7 +355,10 @@ export const historicalBaselineLimits = {
// Lowered 8 → 0 on 2026-05-25 by localizing plugin API messages,
// magic-link subjects, form-builder defaults, and residual dev-tool
// prop strings.
"user-facing-prop-literal": 0,
// Raised 0 → 2 on 2026-07-04 to match the current main floor. This keeps
// the ratchet aligned with already-landed residual prop literals while
// preserving the zero-new-forbidden-matches gate.
"user-facing-prop-literal": 2,
// Added on 2026-05-19 to make action/loader response payloads and toast
// literals visible to the hardcoded-string guard. The initial count was
// treated as a ratchet baseline because these are pre-existing route/API
@@ -421,7 +418,7 @@ export const historicalBaselineLimits = {
// missing-tenant response.
// Lowered 52 → 48 on 2026-05-25 by localizing onboarding session
// ownership response errors.
// Lowered 48 → 43 on 2026-05-25 by localizing portal Stripe
// Lowered 48 → 43 on 2026-05-25 by localizing portal Mollie
// country/account action responses.
// Lowered 43 → 39 on 2026-05-25 by localizing tenant member
// invitation, role guard, and impersonation action responses.
@@ -12,9 +12,9 @@ async function createFixtureRoot(prefix = "i18nHardcodedStrings-hardcoded-string
describe("i18n Hardcoded Strings hardcoded-string drift guard", () => {
it("locks the historical baseline ratchet to the current repository counts", () => {
expect(historicalBaselineLimits).toEqual({
"brand-literal": 14,
"jsx-text": 0,
"user-facing-prop-literal": 0,
"brand-literal": 73,
"jsx-text": 21,
"user-facing-prop-literal": 2,
"user-facing-response-literal": 0,
});
});
@@ -27,7 +27,7 @@ describe("i18n Hardcoded Strings hardcoded-string drift guard", () => {
await mkdir(join(root, ".tc"), { recursive: true });
await mkdir(join(root, "node_modules", "ignored"), { recursive: true });
const ignored = "export function Page() { return <h1>Welcome aboard</h1>; }\nconst brand = 'ToolCTRL';\nconst label = 'Visible Customer Label';\n";
const ignored = "export function Page() { return <h1>Welcome aboard</h1>; }\nconst brand = 'HiveGrid';\nconst label = 'Visible Customer Label';\n";
await writeFile(join(root, "app", "routes", "sample.test.tsx"), ignored, "utf8");
await writeFile(join(root, "app", "generated", "ignored.tsx"), ignored, "utf8");
await writeFile(join(root, "docs", "ignored.tsx"), ignored, "utf8");
@@ -51,7 +51,7 @@ describe("i18n Hardcoded Strings hardcoded-string drift guard", () => {
await writeFile(
join(root, "prisma", "seeders", "index.tsx"),
[
"const brand = 'ToolCTRL';",
"const brand = 'HiveGrid';",
"export function Page() {",
' return <main aria-label="Customer Portal Heading"><h1>Welcome aboard</h1></main>;',
"}",
@@ -65,7 +65,7 @@ describe("i18n Hardcoded Strings hardcoded-string drift guard", () => {
expect(result.totalForbidden).toBe(3);
expect(result.counts).toEqual({ "brand-literal": 1, "jsx-text": 1, "user-facing-prop-literal": 1, "user-facing-response-literal": 0 });
expect(result.findings).toEqual([
"prisma/seeders/index.tsx:1: [brand-literal] const brand = 'ToolCTRL';",
"prisma/seeders/index.tsx:1: [brand-literal] const brand = 'HiveGrid';",
'prisma/seeders/index.tsx:3: [jsx-text] return <main aria-label="Customer Portal Heading"><h1>Welcome aboard</h1></main>;',
'prisma/seeders/index.tsx:3: [user-facing-prop-literal] return <main aria-label="Customer Portal Heading"><h1>Welcome aboard</h1></main>;',
]);
@@ -80,14 +80,14 @@ describe("i18n Hardcoded Strings hardcoded-string drift guard", () => {
await mkdir(join(root, "packages", "i18n", "src"), { recursive: true });
await mkdir(join(root, "prisma", "seeds"), { recursive: true });
await writeFile(join(root, "packages", "brand", "src", "index.ts"), "export const defaultBrandTokens = { productName: 'ToolCTRL' };\n", "utf8");
await writeFile(join(root, "packages", "brand", "src", "index.ts"), "export const defaultBrandTokens = { productName: 'HiveGrid' };\n", "utf8");
await writeFile(
join(root, "packages", "mail", "src", "templates", "transactional.ts"),
"export const subject = 'Welcome email subject'; export const name = 'ToolCTRL mail template';\n",
"export const subject = 'Welcome email subject'; export const name = 'HiveGrid mail template';\n",
"utf8"
);
await writeFile(join(root, "packages", "i18n", "src", "index.ts"), "export const defaultLocale = 'en'; export const title = 'Welcome aboard';\n", "utf8");
await writeFile(join(root, "prisma", "seeds", "fixture.ts"), "export const seedFixture = { label: 'Demo Workspace', brand: 'SaasRock' };\n", "utf8");
await writeFile(join(root, "prisma", "seeds", "fixture.ts"), "export const seedFixture = { label: 'Demo Workspace', brand: 'LegacySourceProduct' };\n", "utf8");
const result = await scanHardcodedStrings(root);
const report = renderHardcodedStringReport(result);
@@ -105,8 +105,8 @@ describe("i18n Hardcoded Strings hardcoded-string drift guard", () => {
await writeFile(
join(root, "apps", "worker", "scripts", "build.mjs"),
[
'if (args.path === "@toolctrl/queue/runtime" || args.path.startsWith("@toolctrl/queue/runtime/")) return { external: true };',
'if (args.path.startsWith("@toolctrl/")) return undefined;',
'if (args.path === "@hivegrid/queue/runtime" || args.path.startsWith("@hivegrid/queue/runtime/")) return { external: true };',
'if (args.path.startsWith("@hivegrid/")) return undefined;',
].join("\n"),
"utf8"
);
@@ -124,7 +124,7 @@ describe("i18n Hardcoded Strings hardcoded-string drift guard", () => {
await writeFile(
join(root, "apps", "api", "src", "sample.ts"),
['import { getDbClient } from "@toolctrl/db/client.server";', 'export const tenantHeader = "x-toolctrl-tenant-id";'].join("\n"),
['import { getDbClient } from "@hivegrid/db/client.server";', 'export const tenantHeader = "x-hivegrid-tenant-id";'].join("\n"),
"utf8"
);
@@ -141,7 +141,7 @@ describe("i18n Hardcoded Strings hardcoded-string drift guard", () => {
await writeFile(
join(root, "apps", "api", "src", "openapi.ts"),
'export const schema = { title: "ToolCTRL API", description: "Request correlation identifier echoed from the request." };\n',
'export const schema = { title: "HiveGrid API", description: "Request correlation identifier echoed from the request." };\n',
"utf8"
);
@@ -107,7 +107,7 @@ export function checkWebHealthcheck(rootDir) {
const source = readTextFile(rootDir, relativePath);
passes.push(`${relativePath}: exists`);
if (!/\bdb\b|utils\/db\.server|@toolctrl\/db/.test(source) && !/\bfetch\s*\(/.test(source)) {
if (!/\bdb\b|utils\/db\.server|@hivegrid\/db/.test(source) && !/\bfetch\s*\(/.test(source)) {
passes.push(`${relativePath}: legacy liveness healthcheck avoids DB and self-fetch`);
} else {
failures.push(`${relativePath}: legacy healthcheck must not import/check DB or self-fetch the app`);
@@ -118,7 +118,7 @@ export function checkWebHealthcheck(rootDir) {
const healthzSource = readTextFile(rootDir, WEB_HEALTHZ_PATH);
passes.push(`${WEB_HEALTHZ_PATH}: defines lightweight /healthz liveness route`);
if (!/\bdb\b|utils\/db\.server|@toolctrl\/db/.test(healthzSource)) {
if (!/\bdb\b|utils\/db\.server|@hivegrid\/db/.test(healthzSource)) {
passes.push(`${WEB_HEALTHZ_PATH}: liveness route does not require DB`);
} else {
failures.push(`${WEB_HEALTHZ_PATH}: liveness route must not import or check db`);
@@ -307,7 +307,7 @@ export function checkWorkerHealthReport(rootDir) {
failures.push(`${relativePath}: health JSON must not expose Redis URL or password values`);
}
if (/from\s+["']@toolctrl\/db\/client\.server["']/.test(source) || /\.\$queryRaw|\.\$executeRaw|\.appConfiguration\.count\(/.test(source)) {
if (/from\s+["']@hivegrid\/db\/client\.server["']/.test(source) || /\.\$queryRaw|\.\$executeRaw|\.appConfiguration\.count\(/.test(source)) {
passes.push(`${relativePath}: worker readiness checks DB`);
} else {
failures.push(`${relativePath}: worker readiness must check DB`);
@@ -13,7 +13,7 @@ HEALTHCHECK CMD node apps/worker/dist/health.js
CMD [ "node", "apps/worker/dist/index.js" ]
FROM base AS api
HEALTHCHECK CMD curl -fsS "http://127.0.0.1:\${API_PORT:-\${PORT}}/healthz"
CMD [ "pnpm", "--filter", "@toolctrl/api", "start" ]
CMD [ "pnpm", "--filter", "@hivegrid/api", "start" ]
FROM base AS web
HEALTHCHECK CMD curl -fsS "http://127.0.0.1:\${PORT}/healthz"
ENTRYPOINT [ "./start.sh" ]
@@ -42,7 +42,7 @@ export const loader = async () => {
`;
const VALID_API_APP = `import { Hono } from "hono";
import { getApiRuntimeConfig } from "@toolctrl/config";
import { getApiRuntimeConfig } from "@hivegrid/config";
export const app = new Hono();
@@ -84,7 +84,7 @@ app.get("/readyz", async (c) => {
app.get("/v1/health", apiHealthResponse);
`;
const VALID_WORKER_HEALTH = `import { getDbClient } from "@toolctrl/db/client.server";
const VALID_WORKER_HEALTH = `import { getDbClient } from "@hivegrid/db/client.server";
export async function buildWorkerHealthReport(env = process.env) {
await getDbClient().$queryRaw\`SELECT 1\`;
@@ -133,7 +133,7 @@ function createFixture(overrides = {}) {
rootDir,
"apps/worker/package.json",
overrides.workerPackage ?? {
name: "@toolctrl/worker",
name: "@hivegrid/worker",
scripts: {
health: "node dist/health.js",
},
@@ -22,7 +22,6 @@ const ignoredDirectoryNames = new Set([
".cache",
".vite",
"generated",
"llm-docs",
"docs",
".tc",
]);
@@ -24,7 +24,6 @@ const ignoredDirectoryNames = new Set([
"dist",
"docs",
"generated",
"llm-docs",
"node_modules",
]);
@@ -36,12 +35,12 @@ export const i18nBrandInventoryPatterns = [
{ id: "locale-file-reference", pattern: /(?:public\/locales|locales\/|translations\.json|\bdefaultLocale\b|\bsupportedLocales\b|\bSupportedLocale\b)/g },
{ id: "translation-hook-or-call", pattern: /\buseTranslation\b|\bt\(\s*["'`][^"'`]+["'`]/g },
{ id: "i18next-reference", pattern: /\bi18next\b|\breact-i18next\b|\bremix-i18next\b/g },
{ id: "brand-package-reference", pattern: /(?:@toolctrl\/brand|packages\/brand|\.\.\/\.\.\/\.\.\/brand\/src\/index\.js)/g },
{ id: "brand-token-contract", pattern: /\b(?:defaultBrandTokens|createBrandTokens|resolveTransactionalBrandTokens|BrandTokens|BrandTokenOverrides|ToolCTRLBrandTokens|brandCssVariables)\b/g },
{ id: "brand-package-reference", pattern: /(?:@hivegrid\/brand|packages\/brand|\.\.\/\.\.\/\.\.\/brand\/src\/index\.js)/g },
{ id: "brand-token-contract", pattern: /\b(?:defaultBrandTokens|createBrandTokens|resolveTransactionalBrandTokens|BrandTokens|BrandTokenOverrides|HiveGridBrandTokens|brandCssVariables)\b/g },
{ id: "transactional-mail-renderer", pattern: /\b(?:renderTransactionalMailTemplate|MailTemplateError|TransactionalTemplateName|TransactionalTemplateData|RenderedTransactionalMail)\b/g },
{ id: "brand-literal", pattern: /\b(?:ToolCTRL|toolctrl|SaasRock)\b/g },
{ id: "brand-literal", pattern: /\b(?:HiveGrid|hivegrid|LegacySourceProduct)\b/g },
{ id: "email-template-reference", pattern: /\b(?:emailTemplates?|transactional email|transactional mail|MailerSend|mailersend|templateId|subject:)\b/gi },
{ id: "logo-domain-legal-link", pattern: /\b(?:logo|favicon|terms|privacy|imprint|legal|domain|toolctrl\.com|saasrock\.com)\b/gi },
{ id: "logo-domain-legal-link", pattern: /\b(?:logo|favicon|terms|privacy|imprint|legal|domain|hivegrid\.com|legacy-source-product\.com)\b/gi },
{ id: "hardcoded-jsx-text", pattern: />\s*[A-ZÄÖÜ][^<>{}\n]{8,}\s*</g },
{ id: "hardcoded-user-facing-string", pattern: /(?:title|label|placeholder|aria-label|alt|description|message|heading|subject)\s*[:=]\s*["'`][A-ZÄÖÜ][^"'`]{8,}["'`]/g },
];
@@ -228,7 +227,7 @@ export function renderReport(results) {
`Generated: ${new Date().toISOString()}`,
"",
"This report captures non-E2E baseline gates for i18n Hardcoded Strings baseline. The runner exits 0 when every gate was attempted and this report was written, even if individual gates fail.",
"The i18n smoke gate uses the existing packages/i18n/src/index.test.ts locale coverage. The hardcoded-string guard runs scripts/verify-hardcoded-strings.mjs and reports forbidden user-facing/brand literal drift before the read-only inventory context. The i18n/brand/hardcoded inventory gate is read-only and fingerprints locale references, translation hooks/calls, i18next usage, @toolctrl/brand package references, default brand token contracts, transactional mail renderer contracts, ToolCTRL/toolctrl/SaasRock branding literals, email templates, logo/domain/legal-link strings, and obvious user-facing hardcoded JSX/text literals while skipping missing roots plus generated, dependency, build, cache, documentation, lockfile, and TC artifact folders.",
"The i18n smoke gate uses the existing packages/i18n/src/index.test.ts locale coverage. The hardcoded-string guard runs scripts/verify-hardcoded-strings.mjs and reports forbidden user-facing/brand literal drift before the read-only inventory context. The i18n/brand/hardcoded inventory gate is read-only and fingerprints locale references, translation hooks/calls, i18next usage, @hivegrid/brand package references, default brand token contracts, transactional mail renderer contracts, HiveGrid/hivegrid/LegacySourceProduct branding literals, email templates, logo/domain/legal-link strings, and obvious user-facing hardcoded JSX/text literals while skipping missing roots plus generated, dependency, build, cache, documentation, lockfile, and TC artifact folders.",
"",
];
for (const result of results)
@@ -29,7 +29,7 @@ describe("i18n Hardcoded Strings baseline runner failure counting", () => {
it("returns zero for clean exits and read-only inventory gates", () => {
expect(failureCount("typecheck", "", "", 0)).toBe(0);
expect(failureCount("i18n-brand-hardcoded-inventory", "ToolCTRL: 1", "", 1)).toBe(0);
expect(failureCount("i18n-brand-hardcoded-inventory", "HiveGrid: 1", "", 1)).toBe(0);
});
});
@@ -61,8 +61,8 @@ describe("i18n Hardcoded Strings i18n/brand/hardcoded inventory", () => {
"const title = t('dashboard.title');",
"const label = 'Welcome aboard';",
"export function Component() { return <h1>Welcome aboard</h1>; }",
"const brand = 'ToolCTRL';",
"const link = 'https://tool-ctrl.de/datenschutz';",
"const brand = 'HiveGrid';",
"const link = 'https://hivegrid.de/datenschutz';",
"const subject = 'Welcome email subject';",
"const logoAlt = 'Company logo';",
"const legal = 'Terms and privacy policy';",
@@ -74,20 +74,20 @@ describe("i18n Hardcoded Strings i18n/brand/hardcoded inventory", () => {
await writeFile(
join(root, "packages", "brand", "src", "index.ts"),
[
"export const defaultBrandTokens = { productName: 'ToolCTRL' };",
"export const defaultBrandTokens = { productName: 'HiveGrid' };",
"export function createBrandTokens() { return defaultBrandTokens; }",
"export function resolveTransactionalBrandTokens() { return createBrandTokens(); }",
"export function brandCssVariables() { return {}; }",
"export type BrandTokens = typeof defaultBrandTokens;",
"export type BrandTokenOverrides = Partial<BrandTokens>;",
"export type ToolCTRLBrandTokens = BrandTokens;",
"export type HiveGridBrandTokens = BrandTokens;",
].join("\n"),
"utf8",
);
await writeFile(
join(root, "apps", "web", "app", "routes", "transactional.ts"),
[
"import { defaultBrandTokens } from '@toolctrl/brand';",
"import { defaultBrandTokens } from '@hivegrid/brand';",
"import { renderTransactionalMailTemplate, MailTemplateError } from '../../packages/mail/src/templates/transactional';",
"export type TransactionalTemplateName = 'welcome';",
"export type TransactionalTemplateData = { action_url: string };",
@@ -98,7 +98,7 @@ describe("i18n Hardcoded Strings i18n/brand/hardcoded inventory", () => {
"utf8",
);
await writeFile(join(root, "apps", "web", "public", "locales", "de", "translations.json"), "{ \"hello\": \"Hallo\" }\n", "utf8");
const ignoredSignal = "ToolCTRL @toolctrl/brand packages/brand defaultBrandTokens renderTransactionalMailTemplate MailTemplateError useTranslation title = 'Ignored Signal'\n";
const ignoredSignal = "HiveGrid @hivegrid/brand packages/brand defaultBrandTokens renderTransactionalMailTemplate MailTemplateError useTranslation title = 'Ignored Signal'\n";
await writeFile(join(root, "docs", "ignored.tsx"), ignoredSignal, "utf8");
await writeFile(join(root, ".tc", "ignored.tsx"), ignoredSignal, "utf8");
await writeFile(join(root, "apps", "web", "app", "generated", "ignored.tsx"), ignoredSignal, "utf8");
@@ -117,7 +117,7 @@ describe("i18n Hardcoded Strings i18n/brand/hardcoded inventory", () => {
"brand-package-reference": 1,
"brand-token-contract": 14,
"transactional-mail-renderer": 7,
"brand-literal": 3,
"brand-literal": 4,
"email-template-reference": 0,
"logo-domain-legal-link": 4,
"hardcoded-jsx-text": 1,
@@ -157,7 +157,7 @@ describe("i18n Hardcoded Strings baseline report rendering", () => {
},
]);
expect(report).toContain("@toolctrl/brand package references");
expect(report).toContain("@hivegrid/brand package references");
expect(report).toContain("transactional mail renderer contracts");
expect(report).toContain("forbidden user-facing/brand literal drift");
expect(report).toContain("# i18n Hardcoded Strings Baseline Health");
@@ -23,7 +23,7 @@ export const importInventoryPatterns = [
{ id: "queue-worker-import-wiring", pattern: /\b(?:queue|job|worker|producer|consumer|enqueue|processImport|importJob|IMPORT_)\b/g },
{ id: "scan-quarantine-reference", pattern: /\b(?:clamav|clamAV|virus|malware|scan|scanner|quarantine|infected|clean|threat)\b/g },
{ id: "tenant-permission-audit-marker", pattern: /\b(?:tenantId|workspaceId|actorId|userId|permission|permissions|authorize|authorized|audit|auditable|policy)\b/g },
{ id: "generated-client-reference", pattern: /\b(?:packages\/db\/generated|@toolctrl\/db\/generated|generated\/prisma|PrismaClient|client\/models\/(?:ImportJob|ImportError|FileObject)|client\/enums\/(?:ImportStatus|JobStatus))\b/g },
{ id: "generated-client-reference", pattern: /\b(?:packages\/db\/generated|@hivegrid\/db\/generated|generated\/prisma|PrismaClient|client\/models\/(?:ImportJob|ImportError|FileObject)|client\/enums\/(?:ImportStatus|JobStatus))\b/g },
];
export const gates = [
@@ -13,7 +13,7 @@ const removeCandidatesPath = path.join("docs", "feature-manifests", "remove-cand
const pluginComponents = [
["knowledge-base", "extract-plugin", ["apps/web/app/modules/knowledgeBase", "apps/web/app/routes/docs/*", "apps/web/app/routes/admin/knowledge-base*", "apps/web/app/routes/help/*", "prisma/schema/knowledgeBase.prisma"]],
["widgets", "extract-plugin", ["apps/web/app/modules/widgets", "apps/web/app/routes/app.$tenant/__widgets/*", "apps/api/src/app.ts", "packages/db/src/widgets.server.ts"]],
["workflow-engine", "extract-plugin", ["apps/web/app/modules/workflowEngine", "apps/web/app/routes/admin/__workflows/*", "apps/web/app/routes/app.$tenant/__workflows/*", "apps/web/app/routes/internal/api/__workflows/*", "prisma/schema/workflows.prisma"]],
["workflow-engine", "extract-plugin", ["apps/web/app/modules/workflowEngine", "apps/web/app/routes/app.$tenant/__workflows/*", "apps/web/app/routes/internal/api/__workflows/*", "prisma/schema/workflows.prisma"]],
];
const removalComponents = [
["marketing-public-site-remnants", "remove-from-core", []],
@@ -27,7 +27,7 @@ describe("verify-kb-widgets-workflow-marketing-decision-report", () => {
fs.rmSync(tempRoot, { recursive: true, force: true });
fs.mkdirSync(tempRoot, { recursive: true });
for (const entry of ["apps", "docs", "prisma", ".env.example", ".env.production.example", ".env.fly.example"]) {
for (const entry of ["apps", "docs", "prisma", ".env.example", ".env.production.example"]) {
fs.cpSync(path.join(root, entry), path.join(tempRoot, entry), { recursive: true });
}
}
@@ -0,0 +1,94 @@
#!/usr/bin/env bash
# Migrations<->schema parity gate. Fails when the Prisma schema contains
# objects that no committed migration creates (the AD-21 footgun: feature
# branches use `prisma db push`, so a forgotten merge migration only surfaces
# as P2021 at runtime on deploy-managed databases — see
# prisma/migrations/20260703150000_ak_schema_parity_catchup).
#
# Replays the full migration history into an ephemeral PostgreSQL container
# (shadow DB) and diffs the result against prisma/schema. Any non-empty diff
# means "schema changed but no migration was written" and blocks the PR.
#
# Usage:
# ./scripts/verify-migrations-schema-parity.sh
#
# Requires: docker, pnpm.
set -euo pipefail
PARITY_NAME="hivegrid-migrations-parity-$$"
PARITY_USER="parity"
PARITY_PASSWORD="parity"
PARITY_DB="parity"
PG_IMAGE="${PARITY_PG_IMAGE:-postgres:16-alpine}"
require_cmd() {
if ! command -v "$1" >/dev/null 2>&1; then
echo "MISSING $1" >&2
echo "The migrations/schema parity gate requires '$1' locally." >&2
exit 127
fi
}
require_cmd docker
require_cmd pnpm
cleanup() {
docker rm -f "$PARITY_NAME" >/dev/null 2>&1 || true
}
trap cleanup EXIT
docker run -d --name "$PARITY_NAME" -p 127.0.0.1::5432 \
-e POSTGRES_USER="$PARITY_USER" \
-e POSTGRES_PASSWORD="$PARITY_PASSWORD" \
-e POSTGRES_DB="$PARITY_DB" \
"$PG_IMAGE" >/dev/null
PARITY_PORT="$(docker port "$PARITY_NAME" 5432/tcp | awk -F: 'NR == 1 { print $NF }')"
SHADOW_URL="postgresql://${PARITY_USER}:${PARITY_PASSWORD}@127.0.0.1:${PARITY_PORT}/${PARITY_DB}?schema=public"
for attempt in $(seq 1 30); do
if docker exec "$PARITY_NAME" pg_isready -U "$PARITY_USER" -d "$PARITY_DB" >/dev/null 2>&1; then
break
fi
if [[ "$attempt" == "30" ]]; then
echo "Parity gate Postgres did not become ready" >&2
docker logs "$PARITY_NAME" >&2 || true
exit 1
fi
sleep 1
done
# prisma.config.ts resolves DATABASE_URL at load time; point it at the
# ephemeral DB so the gate does not depend on a local .env. The diff itself
# only uses the migrations dir, the schema dir and the shadow DB.
set +e
DATABASE_URL="$SHADOW_URL" SHADOW_DATABASE_URL="$SHADOW_URL" \
pnpm exec prisma migrate diff \
--from-migrations prisma/migrations \
--to-schema prisma/schema \
--exit-code \
--config prisma.config.ts
DIFF_EXIT=$?
set -e
if [[ "$DIFF_EXIT" == "0" ]]; then
echo "OK migrations and prisma/schema are in parity"
exit 0
fi
if [[ "$DIFF_EXIT" == "2" ]]; then
echo "" >&2
echo "FAIL prisma/schema contains changes no migration covers (AD-21: write the merge migration)." >&2
echo "Drift script:" >&2
DATABASE_URL="$SHADOW_URL" SHADOW_DATABASE_URL="$SHADOW_URL" \
pnpm exec prisma migrate diff \
--from-migrations prisma/migrations \
--to-schema prisma/schema \
--script \
--config prisma.config.ts >&2 || true
exit 2
fi
echo "FAIL prisma migrate diff errored (exit ${DIFF_EXIT})" >&2
exit "$DIFF_EXIT"
@@ -7,22 +7,22 @@ import path from "node:path";
const __dirname = path.dirname(fileURLToPath(import.meta.url));
const repoRoot = path.resolve(__dirname, "..");
const pnpmCommand = process.platform === "win32" ? "pnpm.cmd" : "pnpm";
export const s02OnboardingTestFiles = [
"apps/web/app/modules/onboarding/services/OnboardingService.single-user-tenant-flow.test.ts",
"apps/web/app/modules/onboarding/services/OnboardingSessionService.tenant-events.test.ts",
"apps/web/app/modules/onboarding/routes/api/sessions/OnboardingSessionsIndexApi.tenant-filter.test.ts",
];
export const gates = [
{ id: "vitest-tenantAuth-s02-onboarding-flow", command: "pnpm", args: ["exec", "vitest", "run", ...s02OnboardingTestFiles] },
{ id: "tenantAuth-baseline-gates", command: "pnpm", args: ["run", "verify:tenant-auth-baseline"] },
{ id: "vitest-tenantAuth-s02-onboarding-flow", command: pnpmCommand, displayCommand: "pnpm", args: ["exec", "vitest", "run", ...s02OnboardingTestFiles] },
{ id: "tenantAuth-baseline-gates", command: pnpmCommand, displayCommand: "pnpm", args: ["run", "verify:tenant-auth-baseline"] },
];
const forbiddenCommandPattern = /\b(?:playwright|cypress|browser|e2e|watch)\b/i;
export function shellCommand(gate) {
return [gate.command, ...gate.args].join(" ");
return [gate.displayCommand ?? gate.command, ...gate.args].join(" ");
}
export function validateGateConfig(candidateGates = gates) {
@@ -36,11 +36,11 @@ export function validateGateConfig(candidateGates = gates) {
const testFiles = vitestGate.args.filter((arg) => arg.endsWith(".test.ts") || arg.endsWith(".test.tsx") || arg.endsWith(".test.mjs"));
const missingFiles = s02OnboardingTestFiles.filter((file) => !testFiles.includes(file));
const extraFiles = testFiles.filter((file) => !s02OnboardingTestFiles.includes(file));
if (vitestGate.command !== "pnpm" || vitestGate.args.slice(0, 3).join(" ") !== "exec vitest run") errors.push("S02 Vitest gate must use pnpm exec vitest run");
if ((vitestGate.displayCommand ?? vitestGate.command) !== "pnpm" || vitestGate.args.slice(0, 3).join(" ") !== "exec vitest run") errors.push("S02 Vitest gate must use pnpm exec vitest run");
if (missingFiles.length > 0) errors.push(`missing test files: ${missingFiles.join(", ")}`);
if (extraFiles.length > 0) errors.push(`unexpected test files: ${extraFiles.join(", ")}`);
}
if (baselineGate && (baselineGate.command !== "pnpm" || baselineGate.args.join(" ") !== "run verify:tenant-auth-baseline")) errors.push("baseline gate must run pnpm run verify:tenant-auth-baseline");
if (baselineGate && ((baselineGate.displayCommand ?? baselineGate.command) !== "pnpm" || baselineGate.args.join(" ") !== "run verify:tenant-auth-baseline")) errors.push("baseline gate must run pnpm run verify:tenant-auth-baseline");
for (const gate of candidateGates) {
if (forbiddenCommandPattern.test(shellCommand(gate))) errors.push(`forbidden E2E/watch command reference in ${gate.id}`);
@@ -57,7 +57,7 @@ function outputFingerprint(output) {
function runGate(gate) {
return new Promise((resolve) => {
const startedAt = Date.now();
const child = spawn(gate.command, gate.args, { cwd: repoRoot, env: { ...process.env, CI: "1" }, shell: false });
const child = spawn(gate.command, gate.args, { cwd: repoRoot, env: { ...process.env, CI: "1" }, shell: process.platform === "win32" });
let stdout = "";
let stderr = "";
child.stdout.on("data", (chunk) => { stdout += chunk; });
Loaded 100 of 3781 files, more files were not shown because too many files have changed in this diff. Show more