riverbankcms 0.1.0

package/dist/acceptance/matrix.mjs

@@ -0,0 +1,784 @@
+#!/usr/bin/env node
+//#region src/acceptance/matrix-builders.ts
+const workflow = (scenario, stepId) => ({
+	kind: "scratch_workflow",
+	scenario,
+	stepId
+});
+const localAdapter = (reason) => ({
+	kind: "local_adapter",
+	reason
+});
+const exploratory = (reason) => ({
+	kind: "exploratory_only",
+	reason
+});
+const scratchExecute = (args, options = {}) => ({
+	kind: "scratch_execute",
+	representative: {
+		args,
+		output: options.output ?? "json-envelope",
+		...options
+	}
+});
+const scratchDryRun = (args, options = {}) => ({
+	kind: "scratch_dry_run",
+	representative: {
+		args,
+		output: options.output ?? "json-envelope",
+		...options
+	}
+});
+const literal = (value) => ({
+	kind: "literal",
+	value
+});
+const capture = (stepId, ...path) => ({
+	kind: "capture",
+	stepId,
+	path
+});
+const commandStep = (id, path, args, options = {}) => ({
+	kind: "command",
+	id,
+	path,
+	args: args.map((arg) => typeof arg === "string" ? literal(arg) : arg),
+	output: options.output ?? "json-envelope",
+	...options
+});
+const writeFileStep = (id, path, content) => ({
+	kind: "write_file",
+	id,
+	path,
+	content: `${JSON.stringify(content, null, 2)}\n`
+});
+const richText = (text) => ({
+	type: "doc",
+	content: [{
+		type: "paragraph",
+		content: [{
+			type: "text",
+			text
+		}]
+	}]
+});
+
+//#endregion
+//#region src/acceptance/manifest-scenario.ts
+const manifestFixture = {
+	blocks: [{
+		id: "custom.acceptance",
+		title: "Acceptance block",
+		titleSource: null,
+		description: null,
+		category: "marketing",
+		icon: null,
+		tags: null,
+		fields: [{
+			id: "headline",
+			type: "text",
+			label: "Headline",
+			description: null,
+			required: true,
+			defaultValue: null,
+			multiline: false,
+			maxLength: null
+		}],
+		layout: {
+			type: "section",
+			props: null,
+			children: [{
+				type: "text",
+				props: null,
+				children: null,
+				$bind: {
+					from: "content.headline",
+					fallback: null,
+					transforms: null
+				},
+				$repeat: null,
+				$when: null
+			}],
+			$bind: null,
+			$repeat: null,
+			$when: null
+		}
+	}],
+	themePatch: null,
+	customCssRules: null,
+	customCssAtRules: null,
+	fixRationale: null
+};
+const manifestScenario = {
+	id: "manifest-validation",
+	steps: [writeFileStep("fixture", ".acceptance/manifest.json", manifestFixture), commandStep("validate", "manifest validate", [
+		"manifest",
+		"validate",
+		"--file",
+		".acceptance/manifest.json",
+		"--json"
+	])]
+};
+
+//#endregion
+//#region src/acceptance/style-scenario.ts
+const styleScenario = {
+	id: "style-apply",
+	steps: [{
+		kind: "read_style_selection",
+		id: "current-selection"
+	}, commandStep("apply", "style apply", [
+		"style",
+		"apply",
+		"--site-style-id",
+		"site-style:calm-studio",
+		"--base-selection-version",
+		capture("current-selection", "currentSelection", "selectionVersion"),
+		"--env=local",
+		"--json"
+	])]
+};
+
+//#endregion
+//#region src/acceptance/content-scenario.ts
+const contentEditPage = {
+	identifier: "acceptance-content-edit",
+	title: "Content edit fixture",
+	path: "/acceptance-content-edit",
+	blocks: [{
+		identifier: "acceptance-first",
+		kind: "block.body-text",
+		data: { body: richText("First block") }
+	}, {
+		identifier: "acceptance-second",
+		kind: "block.body-text",
+		data: { body: richText("Second block") }
+	}]
+};
+const contentScenario = {
+	id: "local-content-edits",
+	steps: [
+		writeFileStep("remove-fixture", "content/pages/acceptance-content-edit.json", contentEditPage),
+		commandStep("remove", "content edit remove-page-block", [
+			"content",
+			"edit",
+			"remove-page-block",
+			"acceptance-content-edit",
+			"acceptance-first",
+			"--content-dir",
+			"content",
+			"--write",
+			"--json"
+		], { changedPath: "content/pages/acceptance-content-edit.json" }),
+		writeFileStep("move-fixture", "content/pages/acceptance-content-edit.json", contentEditPage),
+		commandStep("move", "content edit move-page-block", [
+			"content",
+			"edit",
+			"move-page-block",
+			"acceptance-content-edit",
+			"acceptance-first",
+			"--after",
+			"acceptance-second",
+			"--content-dir",
+			"content",
+			"--write",
+			"--json"
+		], { changedPath: "content/pages/acceptance-content-edit.json" }),
+		writeFileStep("field-fixture", "content/pages/acceptance-content-edit.json", contentEditPage),
+		commandStep("field", "content edit set-page-field", [
+			"content",
+			"edit",
+			"set-page-field",
+			"acceptance-content-edit",
+			"title",
+			"--value",
+			"Edited by CLI acceptance",
+			"--content-dir",
+			"content",
+			"--write",
+			"--json"
+		], { changedPath: "content/pages/acceptance-content-edit.json" })
+	]
+};
+
+//#endregion
+//#region src/acceptance/navigation-scenario.ts
+const navigationScenario = {
+	id: "navigation-lifecycle",
+	steps: [
+		commandStep("upsert", "navigation upsert", [
+			"navigation",
+			"upsert",
+			"CLI Acceptance Menu",
+			"--identifier",
+			"cli-acceptance-menu",
+			"--data",
+			JSON.stringify([{
+				label: "Acceptance link",
+				link: {
+					kind: "external",
+					href: "https://example.com/acceptance"
+				}
+			}]),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("get", "navigation get", [
+			"navigation",
+			"get",
+			capture("upsert", "result", "name"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("delete", "navigation delete", [
+			"navigation",
+			"delete",
+			capture("upsert", "result", "id"),
+			"--yes",
+			"--env=local",
+			"--json"
+		])
+	]
+};
+
+//#endregion
+//#region src/acceptance/matrix.ts
+const entryScenario = {
+	id: "entry-lifecycle",
+	steps: [
+		commandStep("upsert", "entry upsert", [
+			"entry",
+			"upsert",
+			"post",
+			"acceptance-entry",
+			"--data",
+			JSON.stringify({
+				excerpt: "Entry created by the installed CLI acceptance workflow.",
+				body: richText("Acceptance entry body.")
+			}),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("publish", "entry publish", [
+			"entry",
+			"publish",
+			"post",
+			capture("upsert", "result", "identifier"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("get", "entry get", [
+			"entry",
+			"get",
+			"post",
+			capture("upsert", "result", "identifier"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("unpublish", "entry unpublish", [
+			"entry",
+			"unpublish",
+			"post",
+			capture("upsert", "result", "identifier"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("delete", "delete entry", [
+			"delete",
+			"entry",
+			"post",
+			capture("upsert", "result", "identifier"),
+			"--yes",
+			"--env=local",
+			"--json"
+		])
+	]
+};
+const pageScenario = {
+	id: "page-lifecycle",
+	steps: [
+		commandStep("upsert", "page upsert", [
+			"page",
+			"upsert",
+			"acceptance-page",
+			"--title",
+			"CLI acceptance page",
+			"--path",
+			"/cli-acceptance-page",
+			"--env=local",
+			"--json"
+		]),
+		commandStep("publish", "page publish", [
+			"page",
+			"publish",
+			capture("upsert", "result", "identifier"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("unpublish", "page unpublish", [
+			"page",
+			"unpublish",
+			capture("upsert", "result", "identifier"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("get", "page get", [
+			"page",
+			"get",
+			capture("upsert", "result", "identifier"),
+			"--env=local",
+			"--json"
+		])
+	]
+};
+const blockScenario = {
+	id: "block-lifecycle",
+	steps: [
+		commandStep("page", "page upsert", [
+			"page",
+			"upsert",
+			"acceptance-block-page",
+			"--title",
+			"CLI acceptance block page",
+			"--path",
+			"/cli-acceptance-block-page",
+			"--env=local",
+			"--json"
+		]),
+		commandStep("first", "block upsert", [
+			"block",
+			"upsert",
+			capture("page", "result", "identifier"),
+			"acceptance-block-first",
+			"--kind",
+			"block.body-text",
+			"--data",
+			JSON.stringify({ body: richText("First block") }),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("second", "block upsert", [
+			"block",
+			"upsert",
+			capture("page", "result", "identifier"),
+			"acceptance-block-second",
+			"--kind",
+			"block.body-text",
+			"--data",
+			JSON.stringify({ body: richText("Second block") }),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("reorder", "block reorder", [
+			"block",
+			"reorder",
+			capture("page", "result", "identifier"),
+			capture("second", "result", "identifier"),
+			capture("first", "result", "identifier"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("get", "block get", [
+			"block",
+			"get",
+			capture("page", "result", "identifier"),
+			capture("first", "result", "identifier"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("delete", "delete block", [
+			"delete",
+			"block",
+			capture("page", "result", "identifier"),
+			capture("first", "result", "identifier"),
+			"--yes",
+			"--env=local",
+			"--json"
+		])
+	]
+};
+const eventScenario = {
+	id: "event-occurrence-lifecycle",
+	steps: [
+		commandStep("upsert", "event upsert", [
+			"event",
+			"upsert",
+			"acceptance-event",
+			"--data",
+			JSON.stringify({
+				title: "CLI acceptance event",
+				slug: "acceptance-event",
+				schedule: {
+					recurrenceRule: null,
+					defaultStartTime: "10:00:00",
+					durationMinutes: 60
+				},
+				pricing: { requiresPayment: false }
+			}),
+			"--env=local",
+			"--json"
+		]),
+		{
+			kind: "known_identifier",
+			id: "event-identifier",
+			value: "acceptance-event"
+		},
+		commandStep("get", "event get", [
+			"event",
+			"get",
+			capture("event-identifier"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("list-occurrences", "event occurrence list", [
+			"event",
+			"occurrence",
+			"list",
+			capture("event-identifier"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("add-occurrence", "event occurrence add", [
+			"event",
+			"occurrence",
+			"add",
+			capture("event-identifier"),
+			"--starts-at",
+			"2026-12-10T10:00:00Z",
+			"--duration-minutes",
+			"60",
+			"--env=local",
+			"--json"
+		]),
+		commandStep("update-occurrence", "event occurrence update", [
+			"event",
+			"occurrence",
+			"update",
+			capture("event-identifier"),
+			capture("add-occurrence", "result", "id"),
+			"--capacity",
+			"20",
+			"--env=local",
+			"--json"
+		]),
+		commandStep("cancel-occurrence", "event occurrence cancel", [
+			"event",
+			"occurrence",
+			"cancel",
+			capture("event-identifier"),
+			capture("add-occurrence", "result", "id"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("delete-occurrence", "event occurrence delete", [
+			"event",
+			"occurrence",
+			"delete",
+			capture("event-identifier"),
+			capture("add-occurrence", "result", "id"),
+			"--yes",
+			"--env=local",
+			"--json"
+		]),
+		commandStep("cancel-event", "event cancel", [
+			"event",
+			"cancel",
+			capture("event-identifier"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("delete-event", "event delete", [
+			"event",
+			"delete",
+			capture("event-identifier"),
+			"--yes",
+			"--env=local",
+			"--json"
+		])
+	]
+};
+/**
+* Every entry is keyed by the complete Commander leaf path.  The automated
+* runner executes representatives and grouped scratch workflows; provider and
+* uninitialized-state commands remain explicit guided QA cases instead of being
+* faked with made-up identifiers.
+*/
+const acceptanceTuples = [
+	["push-config", scratchDryRun([
+		"push-config",
+		"--env=both",
+		"--dry-run",
+		"--json"
+	])],
+	["pull", scratchDryRun([
+		"pull",
+		"pages",
+		"--env=local",
+		"--dry-run",
+		"--json"
+	], {
+		expectedExitCode: 1,
+		untouchedPath: "content/pages/home.json"
+	})],
+	["push", scratchDryRun([
+		"push",
+		"pages",
+		"--env=both",
+		"--dry-run",
+		"--json"
+	])],
+	["entry upsert", workflow(entryScenario, "upsert")],
+	["entry publish", workflow(entryScenario, "publish")],
+	["entry unpublish", workflow(entryScenario, "unpublish")],
+	["entry get", workflow(entryScenario, "get")],
+	["entry list", scratchExecute([
+		"entry",
+		"list",
+		"post",
+		"--env=local",
+		"--json"
+	])],
+	["entry scaffold", scratchExecute([
+		"entry",
+		"scaffold",
+		"post",
+		"--env=local",
+		"--json"
+	])],
+	["page upsert", workflow(pageScenario, "upsert")],
+	["page publish", workflow(pageScenario, "publish")],
+	["page unpublish", workflow(pageScenario, "unpublish")],
+	["page get", workflow(pageScenario, "get")],
+	["page list", scratchExecute([
+		"page",
+		"list",
+		"--env=local",
+		"--json"
+	])],
+	["block upsert", workflow(blockScenario, "first")],
+	["block reorder", workflow(blockScenario, "reorder")],
+	["block list", scratchExecute([
+		"block",
+		"list",
+		"home",
+		"--env=local",
+		"--json"
+	])],
+	["block get", workflow(blockScenario, "get")],
+	["navigation upsert", workflow(navigationScenario, "upsert")],
+	["navigation delete", workflow(navigationScenario, "delete")],
+	["navigation get", workflow(navigationScenario, "get")],
+	["navigation list", scratchExecute([
+		"navigation",
+		"list",
+		"--env=local",
+		"--json"
+	])],
+	["delete entry", workflow(entryScenario, "delete")],
+	["delete block", workflow(blockScenario, "delete")],
+	["content edit remove-page-block", workflow(contentScenario, "remove")],
+	["content edit move-page-block", workflow(contentScenario, "move")],
+	["content edit set-page-field", workflow(contentScenario, "field")],
+	["drafts", scratchExecute([
+		"drafts",
+		"--env=local",
+		"--json"
+	])],
+	["init-docs", scratchExecute([
+		"init-docs",
+		"--path",
+		".acceptance-docs",
+		"--json"
+	], {
+		cwd: "nested",
+		output: "non-empty"
+	})],
+	["identifiers backfill", scratchExecute([
+		"identifiers",
+		"backfill",
+		"--env=local",
+		"--json"
+	])],
+	["deploy", localAdapter("Deploy provider/git effects require an injected adapter; use the deploy command contract tests.")],
+	["content-type list", scratchExecute([
+		"content-type",
+		"list",
+		"--env=local",
+		"--json"
+	])],
+	["verify", scratchExecute([
+		"verify",
+		"--env=local",
+		"--json"
+	], { expectedExitCode: 1 })],
+	["publish-all", scratchDryRun([
+		"publish-all",
+		"post",
+		"--env=local",
+		"--dry-run",
+		"--json"
+	])],
+	["audit", scratchExecute([
+		"audit",
+		"--env=local",
+		"--json"
+	])],
+	["compare", scratchExecute([
+		"compare",
+		"entries",
+		"post",
+		"--env=local",
+		"--json"
+	], { expectedExitCode: 1 })],
+	["event list", scratchExecute([
+		"event",
+		"list",
+		"--env=local",
+		"--json"
+	])],
+	["event get", workflow(eventScenario, "get")],
+	["event upsert", workflow(eventScenario, "upsert")],
+	["event cancel", workflow(eventScenario, "cancel-event")],
+	["event delete", workflow(eventScenario, "delete-event")],
+	["event occurrence list", workflow(eventScenario, "list-occurrences")],
+	["event occurrence add", workflow(eventScenario, "add-occurrence")],
+	["event occurrence update", workflow(eventScenario, "update-occurrence")],
+	["event occurrence cancel", workflow(eventScenario, "cancel-occurrence")],
+	["event occurrence delete", workflow(eventScenario, "delete-occurrence")],
+	["style list", scratchExecute(["style", "list"], {
+		cwd: "nested",
+		output: "non-empty"
+	})],
+	["style init", exploratory("Requires a curated style identifier and mutates generated site theme state.")],
+	["style apply", workflow(styleScenario, "apply")],
+	["webhooks setup", scratchDryRun([
+		"webhooks",
+		"setup",
+		"--env=local",
+		"--url",
+		"https://example.com/revalidate",
+		"--dry-run",
+		"--json"
+	])],
+	["manifest generate", localAdapter("AI generation requires the fake model adapter; validate local manifest output in guided QA.")],
+	["manifest validate", workflow(manifestScenario, "validate")],
+	["env status", scratchExecute([
+		"env",
+		"status",
+		"--env=both",
+		"--json"
+	])],
+	["setup plan", scratchExecute([
+		"setup",
+		"plan",
+		"--env=both",
+		"--json"
+	])],
+	["migrate entries", scratchDryRun([
+		"migrate",
+		"entries",
+		"--dry-run"
+	], {
+		cwd: "nested",
+		output: "non-empty"
+	})],
+	["migrate events", scratchDryRun([
+		"migrate",
+		"events",
+		"--dry-run"
+	], {
+		cwd: "nested",
+		output: "non-empty"
+	})]
+];
+const CLI_ACCEPTANCE_CASES = acceptanceTuples.map(([path, disposition]) => ({
+	path,
+	disposition
+}));
+function leafCommandPaths(program) {
+	const paths = [];
+	const visit = (command, parent) => {
+		const path = [...parent, command.name()];
+		if (command.commands.length === 0) {
+			paths.push(path.slice(1).join(" "));
+			return;
+		}
+		command.commands.forEach((child) => visit(child, path));
+	};
+	visit(program, []);
+	return paths;
+}
+function assertRepresentativeParity(entry, disposition) {
+	if (disposition.representative.args.length === 0) {
+		throw new Error(`CLI acceptance case ${entry.path} has no representative scratch invocation`);
+	}
+	const pathTokens = entry.path.split(" ");
+	const representativePath = disposition.representative.args.slice(0, pathTokens.length);
+	if (!pathTokens.every((token, index) => representativePath[index] === token)) {
+		throw new Error(`CLI acceptance case ${entry.path} executes a different representative command`);
+	}
+}
+function assertWorkflowScenarioReferences(scenario) {
+	const scenarioIndex = new Map(scenario.steps.map((step, index) => [step.id, index]));
+	for (const [index, step] of scenario.steps.entries()) {
+		if (step.kind !== "command") continue;
+		for (const argument of step.args) {
+			if (argument.kind !== "capture") continue;
+			const captureIndex = scenarioIndex.get(argument.stepId);
+			if (captureIndex === undefined || captureIndex >= index) {
+				throw new Error(`CLI acceptance scenario ${scenario.id} captures ${argument.stepId} before it is produced`);
+			}
+		}
+	}
+}
+function assertWorkflowParity(entry, disposition) {
+	const { scenario, stepId } = disposition;
+	if (scenario.id.trim().length === 0 || scenario.steps.length === 0) {
+		throw new Error(`CLI acceptance case ${entry.path} has an empty workflow scenario`);
+	}
+	const steps = new Map();
+	for (const step of scenario.steps) {
+		if (steps.has(step.id)) throw new Error(`CLI acceptance scenario ${scenario.id} repeats step ${step.id}`);
+		steps.set(step.id, step);
+	}
+	const target = steps.get(stepId);
+	if (!target || target.kind !== "command") {
+		throw new Error(`CLI acceptance case ${entry.path} targets unknown workflow command step ${stepId}`);
+	}
+	if (target.path !== entry.path) {
+		throw new Error(`CLI acceptance case ${entry.path} targets workflow step ${stepId} (${target.path})`);
+	}
+	assertWorkflowScenarioReferences(scenario);
+}
+function assertAcceptanceDisposition(entry) {
+	switch (entry.disposition.kind) {
+		case "scratch_execute":
+		case "scratch_dry_run":
+			assertRepresentativeParity(entry, entry.disposition);
+			return;
+		case "scratch_workflow":
+			assertWorkflowParity(entry, entry.disposition);
+			return;
+		case "local_adapter":
+		case "exploratory_only":
+			if (entry.disposition.reason.trim().length === 0) {
+				throw new Error(`CLI acceptance case ${entry.path} has no disposition rationale`);
+			}
+			return;
+		default: {
+			const unreachable = entry.disposition;
+			throw new Error(`CLI acceptance case ${entry.path} has no safety disposition: ${String(unreachable)}`);
+		}
+	}
+}
+function assertCliAcceptanceParity(program) {
+	const actual = new Set(leafCommandPaths(program));
+	const expected = new Set(CLI_ACCEPTANCE_CASES.map((entry) => entry.path));
+	const missing = [...actual].filter((path) => !expected.has(path));
+	const stale = [...expected].filter((path) => !actual.has(path));
+	if (missing.length > 0 || stale.length > 0 || expected.size !== CLI_ACCEPTANCE_CASES.length) throw new Error(`CLI acceptance matrix drifted (missing: ${missing.join(", ") || "none"}; stale: ${stale.join(", ") || "none"}).`);
+	CLI_ACCEPTANCE_CASES.forEach(assertAcceptanceDisposition);
+}
+
+//#endregion
+export { CLI_ACCEPTANCE_CASES, assertCliAcceptanceParity, leafCommandPaths };