build: add canonical product catalog and docs drift checks

Derive package, tool-family, provider, setup-client, schema-version, and CLI facts from the runtime contract sources into a deterministic checked-in catalog.

Add non-mutating generated-file checks, exact TypeDoc regenerate-and-compare validation, caller-visible documentation fact checks, and CI enforcement through docs:check.

Cover command-router parity, source-derived catalog values, deliberate documentation drift, and stale generated artifacts while preserving runtime behavior.
This commit is contained in:
N0zoM1z0
2026-07-15 17:43:52 +08:00
parent addc208f12
commit beb9ece7d1
109 changed files with 1878 additions and 281 deletions
+2 -1
View File
@@ -10,6 +10,7 @@ import {
authorizeFileReadWithDeferredWrite,
authorizeRootPermission,
} from "./application/DeferredFileAuthorization.js";
import { CLI_COMMANDS } from "./cliCommandNames.js";
const investigationOptionsSchema = z.object({
yes: z
@@ -48,7 +49,7 @@ export const registerInvestigationCommands = (
cli: ReturnType<typeof Cli.create>,
logger: Logger,
): void => {
cli.command("investigate-versions", {
cli.command(CLI_COMMANDS.investigateVersions, {
description:
"Run or resume a persistent cross-version artifact investigation",
args: z.object({