CI (SIAX Cloud) / security (push) Successful in 19s
Security Scan (SIAX Cloud) / security (push) Successful in 19s
CI (SIAX Cloud) / quality (push) Successful in 44s
CI (SIAX Cloud) / security (pull_request) Successful in 21s
Security Scan (SIAX Cloud) / security (pull_request) Successful in 20s
CI (SIAX Cloud) / quality (pull_request) Successful in 42s
BACKLOG P1-1: siax.repo.json/siax.config.json rewritten to be schema-valid against sax3l/siax-standard's actual v2.0 schemas (lifecycle, operationalState, gitHost, domains-as-objects, consumedBy, children, contracts -- validated with jsonschema, not just eyeballed). config.json restructured to the real deploy-descriptor shape (framework/build/start/ port/healthcheck/environments) instead of duplicating repo.json's identity fields, which the schema doesn't allow. BACKLOG P1-2: 3 ADRs for decisions already made and evidenced elsewhere in this repo (Coolify-not-Vercel, Zitadel-not-NextAuth, Iceberg-format pointer to n0d ADR-0030) -- retroactive documentation, not new decisions. The Stripe/Revolut and services/scrapers/* questions are explicitly NOT written as ADRs here; both are account-owner-gated or actively under review elsewhere (see docs/architecture/decisions/README.md). BACKLOG P1-3: CHANGELOG.md from real git log history (no tags/releases exist yet -- this doesn't invent version numbers that were never cut). BACKLOG P1-19: `pnpm siax:doctor` (scripts/siax-doctor.mjs, AGENT-04) -- zero-dependency, checks required files + manifest shape, prints control-IDs. .devcontainer/devcontainer.json (DX-03). compose.dev.yaml (DX-02 -- UNVERIFIED, no Docker available in this environment to smoke-test, flagged in the file itself). All 4 prompts + the index rewritten to AGENT-03 shape (goal/context/prerequisites/scope/contract/acceptance-criteria/ control-ID/forbidden-actions). BACKLOG P1-20: docs/architecture/ARCHITECTURE.md migrated to the v2.0 9-heading template -- new §5 "Ytor och paritet" (capability x API/CLI/MCP/console coverage table, grounded in the same registry facts docs/02-architecture.md already established), §6-9 renumbered from the old §5-8 (all internal cross-references fixed, CLAUDE.md's own §-numbers left untouched). docs/api/ added (points at contracts/openapi.yaml as the one SSOT instead of duplicating it as drift-prone prose). BACKLOG P1-21: packages/schemas now has a real package.json (was loose JSON files with no package -- pnpm-workspace.yaml's packages/* glob matched an empty package). Verified `pnpm install --frozen-lockfile` and the full typecheck/test/build suite still pass with 2 real workspace projects. apps/ restructuring explicitly NOT attempted (BACKLOG's own effort estimate is "L" / large -- moving the whole app tree is a bigger, riskier change than belongs in this pass). Import-boundary check added via dependency-cruiser (ARK-14) -- installed for real, config tested against this codebase (179 modules, 310 deps, 0 violations), wired as `pnpm run deps:check` (advisory, not yet a CI gate). BACKLOG P2-5: docs/02-architecture.md's "Hosting" section marked SUPERSEDED (the Vercel plan was superseded by the Coolify deploy.target flip, 2026-08-09 -- ADR-0001). README.md/.env.example were checked and are already accurately framed (live-on-Vercel vs. config-target-is-Coolify) -- not touched. BACKLOG P3-5: 2 stale github.com/sax3l/0pt/pull/3 links removed (the PR merged long ago, .env.example is real and current) -- docs/09-build-plan.md, docs/08-infrastructure.md. The "two diverged remotes, unresolved which is canonical" language elsewhere (CLAUDE.md, AGENTS.md, SECURITY.md, etc.) is deliberately NOT touched -- that's a live, correctly-flagged, account-owner- owned open question per the Gitea-exclusivity mandate, not a stale link. BACKLOG P6 (19 items): concrete artifacts for the ones that are actually a file (.editorconfig, dependency-cruiser, deprecation policy, K8s reference manifest, .actrc, Makefile, ONBOARDING.md); docs/guides/P6-GUIDES.md for the rest (CLI-13, DOC-18, UI-30, IAM-19, PAY-11, AI-18, OBS-21, TEST-20, NET-19, SCALE-13, OSS-10, AGENT-13) -- each grounded in this repo's actual code/gaps, not generic advice. NOT attempted (out of this task's scope, noted for the record): - P2-1 (cl0ud app-registry.ts mismatch) -- lives in a different repo (sax3l/cl0ud), not cloned/authorized for this task's single-repo PR flow. - The CI "doctor step" half of P1-15 -- deliberately left out of this PR's .gitea/workflows/ci.yml to avoid a 3-way merge conflict with ci/security-headers-and-scanning, which already restructured that file; add it as a follow-up once that PR merges. This branch was authored independently of, but shares docs/architecture/ ARCHITECTURE.md and docs/slo.md with, fix/honest-health-check and ci/security-headers-and-scanning -- expect a small, normal merge conflict if this is rebased after either of those merge first (both already rebased cleanly against each other and against main as of this commit).
155 lines
6.4 KiB
JavaScript
155 lines
6.4 KiB
JavaScript
#!/usr/bin/env node
|
|
// siax-doctor (BACKLOG P1-19, control AGENT-04): "Repot är
|
|
// self-diagnostiserande: `pnpm siax:doctor` kör hela standarden lokalt och
|
|
// skriver ut avvikelser med kontroll-ID."
|
|
//
|
|
// This is a repo-local, zero-dependency subset -- NOT the published
|
|
// @siax/doctor package from sax3l/siax-standard. That package was
|
|
// deliberately not taken on as a dependency here: at the time this was
|
|
// written it wasn't verified reachable/stable from this repo's frozen
|
|
// lockfile install, and a doctor script that can silently fail to install
|
|
// is worse than no doctor script. This checks the same class of
|
|
// machine-checkable facts (required files, manifest shape) using only
|
|
// Node's built-in `fs`/`path` -- no network, no registry.
|
|
//
|
|
// Exit code 0 = every check passed. Exit code 1 = at least one check failed
|
|
// (see the printed control-ID to find the BACKLOG/standard item).
|
|
//
|
|
// NOTE for reviewers: this script was authored alongside two sibling PRs
|
|
// (fix/honest-health-check adds app/api/ready/route.ts;
|
|
// ci/security-headers-and-scanning adds CODEOWNERS) that this branch does
|
|
// not itself contain. Run this on a checkout with all three merged for a
|
|
// clean 0-failure result -- a couple of FAILs on this branch alone, for
|
|
// exactly those two files, is expected and not a bug in either PR.
|
|
import { existsSync, readFileSync } from "node:fs";
|
|
import { join, dirname } from "node:path";
|
|
import { fileURLToPath } from "node:url";
|
|
|
|
const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
|
|
|
|
/** @type {{id: string, label: string, check: () => boolean | string}[]} */
|
|
const checks = [];
|
|
|
|
function file(path) {
|
|
return join(ROOT, path);
|
|
}
|
|
|
|
function requireFile(id, label, path) {
|
|
checks.push({
|
|
id,
|
|
label,
|
|
check: () => (existsSync(file(path)) ? true : `missing: ${path}`),
|
|
});
|
|
}
|
|
|
|
function requireJsonField(id, label, path, fieldPath) {
|
|
checks.push({
|
|
id,
|
|
label,
|
|
check: () => {
|
|
if (!existsSync(file(path))) return `missing file: ${path}`;
|
|
let data;
|
|
try {
|
|
data = JSON.parse(readFileSync(file(path), "utf8"));
|
|
} catch (e) {
|
|
return `invalid JSON in ${path}: ${e.message}`;
|
|
}
|
|
let cur = data;
|
|
for (const key of fieldPath.split(".")) {
|
|
if (cur == null || !(key in cur)) return `missing field "${fieldPath}" in ${path}`;
|
|
cur = cur[key];
|
|
}
|
|
return true;
|
|
},
|
|
});
|
|
}
|
|
|
|
function requireTextMatch(id, label, path, pattern, patternLabel) {
|
|
checks.push({
|
|
id,
|
|
label,
|
|
check: () => {
|
|
if (!existsSync(file(path))) return `missing file: ${path}`;
|
|
const text = readFileSync(file(path), "utf8");
|
|
return pattern.test(text) ? true : `${path} does not contain ${patternLabel}`;
|
|
},
|
|
});
|
|
}
|
|
|
|
// -- REPO-* / DOC-* : required root files --------------------------------
|
|
requireFile("DOC-01", "README.md exists", "README.md");
|
|
requireFile("REPO-08", "LICENSE exists", "LICENSE");
|
|
requireFile("REPO-13", ".editorconfig exists", ".editorconfig");
|
|
checks.push({
|
|
id: "REPO-15/P0-19",
|
|
label: "no committed .env (real secrets)",
|
|
check: () => (existsSync(file(".env")) ? "a real .env file is committed -- should never happen" : true),
|
|
});
|
|
requireFile("P1-15", "CODEOWNERS exists", "CODEOWNERS");
|
|
requireFile("P1-3", "CHANGELOG.md exists", "CHANGELOG.md");
|
|
requireFile("SEC-*", "SECURITY.md exists", "SECURITY.md");
|
|
requireFile("AGENT-01", "AGENTS.md exists", "AGENTS.md");
|
|
requireFile("DOC-01", "CONTRIBUTING.md exists", "CONTRIBUTING.md");
|
|
|
|
// -- DOC-02/DOC-04 : ARCHITECTURE.md at the exact standard path -----------
|
|
requireFile("DOC-02", "docs/architecture/ARCHITECTURE.md exists at the standard path", "docs/architecture/ARCHITECTURE.md");
|
|
requireTextMatch(
|
|
"DOC-02/v2.0",
|
|
"ARCHITECTURE.md has the v2.0 '## 5. Ytor och paritet' section",
|
|
"docs/architecture/ARCHITECTURE.md",
|
|
/^## 5\. Ytor och paritet/m,
|
|
"'## 5. Ytor och paritet'",
|
|
);
|
|
requireTextMatch(
|
|
"DOC-04",
|
|
"ARCHITECTURE.md has a 'Senast verifierad mot kod' date field",
|
|
"docs/architecture/ARCHITECTURE.md",
|
|
/Senast verifierad mot kod:\*\*\s*\d{4}-\d{2}-\d{2}/,
|
|
"a dated 'Senast verifierad mot kod' field",
|
|
);
|
|
|
|
// -- P1-1 / REPO-03/04/06 : manifests --------------------------------------
|
|
requireFile("P1-1/REPO-04", "siax.repo.json exists", "siax.repo.json");
|
|
for (const field of ["repo", "category", "subcategory", "appId", "owner", "lifecycle", "gitHost", "node", "domains", "consumes", "consumedBy", "replacesSaaS", "children", "operationalState"]) {
|
|
requireJsonField("P1-1/REPO-04", `siax.repo.json has required field "${field}"`, "siax.repo.json", field);
|
|
}
|
|
requireFile("P1-1/REPO-06", "siax.config.json exists", "siax.config.json");
|
|
for (const field of ["framework", "build", "start", "port", "healthcheck", "environments"]) {
|
|
requireJsonField("P1-1/REPO-06", `siax.config.json has required field "${field}"`, "siax.config.json", field);
|
|
}
|
|
|
|
// -- AGENT-02/03 : prompts -------------------------------------------------
|
|
requireFile("AGENT-02", "prompts/000-INDEX.md exists", "prompts/000-INDEX.md");
|
|
|
|
// -- DX-03 : devcontainer --------------------------------------------------
|
|
requireFile("DX-03", ".devcontainer/devcontainer.json exists", ".devcontainer/devcontainer.json");
|
|
|
|
// -- P1-2 : ADRs -------------------------------------------------------------
|
|
requireFile("P1-2", "docs/architecture/decisions/ has at least one ADR", "docs/architecture/decisions/README.md");
|
|
|
|
// -- CI-14 : contract ---------------------------------------------------------
|
|
requireFile("A4/DOC", "contracts/openapi.yaml exists", "contracts/openapi.yaml");
|
|
|
|
// -- CD-04/OBS-04 : health/ready ---------------------------------------------
|
|
requireFile("P0-3/CD-04", "app/api/health/route.ts exists", "app/api/health/route.ts");
|
|
requireFile("P0-3/OBS-04", "app/api/ready/route.ts exists (readiness, not just liveness)", "app/api/ready/route.ts");
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
let failures = 0;
|
|
console.log("siax-doctor -- 0pt (repo-local subset, see scripts/siax-doctor.mjs header)\n");
|
|
for (const { id, label, check } of checks) {
|
|
const result = check();
|
|
if (result === true) {
|
|
console.log(` [PASS] ${id.padEnd(14)} ${label}`);
|
|
} else {
|
|
failures += 1;
|
|
console.log(` [FAIL] ${id.padEnd(14)} ${label} -- ${result}`);
|
|
}
|
|
}
|
|
console.log(`\n${checks.length - failures}/${checks.length} checks passed.`);
|
|
if (failures > 0) {
|
|
console.log(`${failures} check(s) failed -- see control-IDs above and cross-reference docs/compliance/BACKLOG.md.`);
|
|
process.exit(1);
|
|
}
|