Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,281 @@
|
||||
#!/usr/bin/env node
|
||||
import fs from "node:fs";
|
||||
import path from "node:path";
|
||||
|
||||
const root = path.resolve(process.argv[2] ?? process.cwd());
|
||||
const failures = [];
|
||||
const passes = [];
|
||||
|
||||
function rel(...parts) {
|
||||
return path.join(...parts);
|
||||
}
|
||||
|
||||
function abs(relativePath) {
|
||||
return path.join(root, relativePath);
|
||||
}
|
||||
|
||||
function pass(message) {
|
||||
passes.push(message);
|
||||
}
|
||||
|
||||
function fail(message) {
|
||||
failures.push(message);
|
||||
}
|
||||
|
||||
function exists(relativePath) {
|
||||
return fs.existsSync(abs(relativePath));
|
||||
}
|
||||
|
||||
function isNonEmptyFile(relativePath) {
|
||||
try {
|
||||
return fs.statSync(abs(relativePath)).isFile() && fs.readFileSync(abs(relativePath), "utf8").trim().length > 0;
|
||||
} catch {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
function hasDirectoryEntries(relativePath) {
|
||||
try {
|
||||
const stat = fs.statSync(abs(relativePath));
|
||||
return stat.isDirectory() && fs.readdirSync(abs(relativePath)).length > 0;
|
||||
} catch {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
function requireReportText(report, text) {
|
||||
if (report.includes(text)) {
|
||||
pass(`report references ${text}`);
|
||||
} else {
|
||||
fail(`report must reference ${text}`);
|
||||
}
|
||||
}
|
||||
|
||||
function requireDocumentText(label, document, text) {
|
||||
if (document.includes(text)) {
|
||||
pass(`${label} references ${text}`);
|
||||
} else {
|
||||
fail(`${label} must reference ${text}`);
|
||||
}
|
||||
}
|
||||
|
||||
function requirePath(relativePath) {
|
||||
if (exists(relativePath)) {
|
||||
pass(`path exists: ${relativePath}`);
|
||||
} else {
|
||||
fail(`missing path: ${relativePath}`);
|
||||
}
|
||||
}
|
||||
|
||||
function requireRouteGlob(globText, directoryPath) {
|
||||
if (hasDirectoryEntries(directoryPath)) {
|
||||
pass(`glob resolves: ${globText} -> ${directoryPath}`);
|
||||
} else {
|
||||
fail(`glob does not resolve to a non-empty directory: ${globText} -> ${directoryPath}`);
|
||||
}
|
||||
}
|
||||
|
||||
function requireJsonArrayIncludes(fileLabel, array, expected, messagePrefix) {
|
||||
if (Array.isArray(array) && array.includes(expected)) {
|
||||
pass(`${messagePrefix}: ${expected}`);
|
||||
} else {
|
||||
fail(`${fileLabel} missing ${messagePrefix}: ${expected}`);
|
||||
}
|
||||
}
|
||||
|
||||
const reportPath = rel("docs", "feature-decisions", "portals-sites-decision-report.md");
|
||||
const inventoryPath = rel("docs", "feature-inventory.md");
|
||||
const pluginCandidatesPath = rel("docs", "feature-manifests", "plugin-candidates.json");
|
||||
|
||||
let report = "";
|
||||
if (isNonEmptyFile(reportPath)) {
|
||||
report = fs.readFileSync(abs(reportPath), "utf8");
|
||||
pass(`report exists and is non-empty: ${reportPath}`);
|
||||
} else {
|
||||
fail(`report is missing or empty: ${reportPath}`);
|
||||
}
|
||||
|
||||
if (report) {
|
||||
const requiredHeadings = [
|
||||
"## Decision",
|
||||
"## Scope",
|
||||
"## Current Code Surfaces",
|
||||
"## Couplings",
|
||||
"## Stripe Billing and Provider Boundary",
|
||||
"## Schema and Data Impact",
|
||||
"## Sidebar Command Docs Impact",
|
||||
"## Execution Plan",
|
||||
"## Verification Plan",
|
||||
"## Risks",
|
||||
];
|
||||
|
||||
for (const heading of requiredHeadings) {
|
||||
if (report.includes(heading)) {
|
||||
pass(`heading present: ${heading}`);
|
||||
} else {
|
||||
fail(`missing required heading: ${heading}`);
|
||||
}
|
||||
}
|
||||
|
||||
if (report.includes("Decision: `extract-plugin`")) {
|
||||
pass("decision token present: Decision: `extract-plugin`");
|
||||
} else {
|
||||
fail("report must contain exact decision token: Decision: `extract-plugin`");
|
||||
}
|
||||
|
||||
for (const decisionText of ["D007", "D006"] ) {
|
||||
requireReportText(report, decisionText);
|
||||
}
|
||||
|
||||
const placeholderPattern = /\b(?:TODO|TBD)\b/i;
|
||||
const placeholderMatch = report.split(/\r?\n/).find((line) => placeholderPattern.test(line));
|
||||
if (placeholderMatch) {
|
||||
fail(`report contains unresolved placeholder line: ${placeholderMatch}`);
|
||||
} else {
|
||||
pass("report has no TODO/TBD placeholder lines");
|
||||
}
|
||||
|
||||
const requiredReportReferences = [
|
||||
"apps/web/app/modules/portals",
|
||||
"apps/web/app/modules/sites",
|
||||
"apps/web/app/routes/admin/portals.tsx",
|
||||
"apps/web/app/routes/app.$tenant/__portals/*",
|
||||
"apps/web/app/routes/app.$tenant/sites/*",
|
||||
"apps/web/app/modules/portals/services/PortalStripe.server.ts",
|
||||
"apps/web/app/modules/portals/services/StripeConnect.server.ts",
|
||||
"apps/web/app/modules/portals/db/portals.db.server.ts",
|
||||
"apps/web/app/modules/sites/db/sites.db.server.ts",
|
||||
"apps/web/app/modules/sites/site-types.ts",
|
||||
"apps/web/app/routes/admin/analytics/page-views.tsx",
|
||||
"prisma/schema/analytics.prisma",
|
||||
"apps/web/app/modules/domains/services/Domains.server.ts",
|
||||
"apps/web/app/application/sidebar/AppSidebar.test.tsx",
|
||||
"prisma/schema/portals.prisma",
|
||||
"prisma/schema/sites.prisma",
|
||||
".env.example",
|
||||
".env.production.example",
|
||||
".env.fly.example",
|
||||
inventoryPath,
|
||||
pluginCandidatesPath,
|
||||
];
|
||||
|
||||
for (const reference of requiredReportReferences) {
|
||||
requireReportText(report, reference);
|
||||
}
|
||||
|
||||
for (const coverageText of [
|
||||
"Stripe",
|
||||
"analytics",
|
||||
"domains",
|
||||
"sidebar",
|
||||
"environment",
|
||||
"schema/data migration plan",
|
||||
"without browser or E2E execution",
|
||||
]) {
|
||||
requireReportText(report, coverageText);
|
||||
}
|
||||
}
|
||||
|
||||
const requiredConcretePaths = [
|
||||
"apps/web/app/modules/portals",
|
||||
"apps/web/app/modules/sites",
|
||||
"apps/web/app/routes/admin/portals.tsx",
|
||||
"apps/web/app/modules/portals/services/PortalStripe.server.ts",
|
||||
"apps/web/app/modules/portals/services/StripeConnect.server.ts",
|
||||
"apps/web/app/modules/portals/db/portals.db.server.ts",
|
||||
"apps/web/app/modules/sites/db/sites.db.server.ts",
|
||||
"apps/web/app/modules/sites/site-types.ts",
|
||||
"apps/web/app/routes/admin/analytics/page-views.tsx",
|
||||
"prisma/schema/analytics.prisma",
|
||||
"apps/web/app/modules/domains/services/Domains.server.ts",
|
||||
"apps/web/app/application/sidebar/AppSidebar.test.tsx",
|
||||
"prisma/schema/portals.prisma",
|
||||
"prisma/schema/sites.prisma",
|
||||
".env.example",
|
||||
".env.production.example",
|
||||
".env.fly.example",
|
||||
inventoryPath,
|
||||
pluginCandidatesPath,
|
||||
];
|
||||
|
||||
for (const requiredPath of requiredConcretePaths) {
|
||||
requirePath(requiredPath);
|
||||
}
|
||||
|
||||
requireRouteGlob("apps/web/app/routes/app.$tenant/__portals/*", "apps/web/app/routes/app.$tenant/__portals");
|
||||
requireRouteGlob("apps/web/app/routes/app.$tenant/sites/*", "apps/web/app/routes/app.$tenant/sites");
|
||||
|
||||
if (isNonEmptyFile(inventoryPath)) {
|
||||
const inventory = fs.readFileSync(abs(inventoryPath), "utf8");
|
||||
for (const text of ["Portals/Sites", reportPath, "extract-plugin"]) {
|
||||
requireDocumentText("inventory", inventory, text);
|
||||
}
|
||||
} else {
|
||||
fail(`inventory is missing or empty: ${inventoryPath}`);
|
||||
}
|
||||
|
||||
if (isNonEmptyFile(pluginCandidatesPath)) {
|
||||
try {
|
||||
const manifest = JSON.parse(fs.readFileSync(abs(pluginCandidatesPath), "utf8"));
|
||||
const portalsSites = Array.isArray(manifest.components)
|
||||
? manifest.components.find((component) => component && component.id === "portals-sites")
|
||||
: undefined;
|
||||
|
||||
if (portalsSites) {
|
||||
pass('manifest contains component id "portals-sites"');
|
||||
} else {
|
||||
fail('manifest must contain component id "portals-sites"');
|
||||
}
|
||||
|
||||
const rationale = typeof portalsSites?.rationale === "string" ? portalsSites.rationale : "";
|
||||
if (rationale.trim().length > 0) {
|
||||
pass("manifest portals-sites rationale is present");
|
||||
} else {
|
||||
fail("manifest portals-sites rationale must be present");
|
||||
}
|
||||
|
||||
const validationSources = Array.isArray(manifest.validation?.source) ? manifest.validation.source : [];
|
||||
requireJsonArrayIncludes("plugin-candidates manifest", validationSources, reportPath, "validation source present");
|
||||
|
||||
const manifestText = fs.readFileSync(abs(pluginCandidatesPath), "utf8");
|
||||
for (const text of [reportPath, "extract-plugin"]) {
|
||||
requireDocumentText("plugin-candidates manifest", manifestText, text);
|
||||
}
|
||||
|
||||
const codeAreas = Array.isArray(portalsSites?.codeAreas) ? portalsSites.codeAreas : [];
|
||||
for (const codeArea of [
|
||||
"apps/web/app/modules/portals",
|
||||
"apps/web/app/modules/sites",
|
||||
"apps/web/app/routes/app.$tenant/__portals/*",
|
||||
"apps/web/app/routes/app.$tenant/sites/*",
|
||||
]) {
|
||||
requireJsonArrayIncludes("plugin-candidates manifest", codeAreas, codeArea, "manifest Portals/Sites code area present");
|
||||
}
|
||||
|
||||
|
||||
if (manifest.pruning?.action === "extract-plugin") {
|
||||
pass("manifest pruning.action is extract-plugin");
|
||||
} else {
|
||||
fail(`manifest pruning.action must be extract-plugin, got ${JSON.stringify(manifest.pruning?.action)}`);
|
||||
}
|
||||
} catch (error) {
|
||||
fail(`manifest JSON parse failed: ${error.message}`);
|
||||
}
|
||||
} else {
|
||||
fail(`manifest is missing or empty: ${pluginCandidatesPath}`);
|
||||
}
|
||||
|
||||
if (failures.length > 0) {
|
||||
process.stderr.write(
|
||||
[
|
||||
"FAIL portals/sites decision report verification",
|
||||
...failures.map((failure) => `- ${failure}`),
|
||||
`Summary: ${passes.length} passed, ${failures.length} failed`,
|
||||
].join("\n") + "\n",
|
||||
);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
process.stdout.write(
|
||||
`PASS portals/sites decision report verification\nSummary: ${passes.length} passed, 0 failed\n`,
|
||||
);
|
||||
Reference in new issue
Block a user