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
+3 -2
View File
@@ -15,6 +15,7 @@ import {
import { AnalysisInputError, projectAnalysisError } from "./domain/errors.js";
import type { JsonValue } from "./domain/jsonValue.js";
import type { Logger } from "./logger.js";
import { CLI_COMMANDS } from "./cliCommandNames.js";
const scopeOptions = {
allowedFileRoots: z
@@ -29,7 +30,7 @@ export const registerElectronCommands = (
cli: ReturnType<typeof Cli.create>,
logger: Logger,
): void => {
cli.command("list-electron-targets", {
cli.command(CLI_COMMANDS.listElectronTargets, {
description: "List root-confined file pages from Electron CDP",
args: z.object({ endpoint: z.string() }),
options: z.object({
@@ -58,7 +59,7 @@ export const registerElectronCommands = (
return result.ok ? result.value : cliError(result.error);
}),
});
cli.command("inspect-electron-page", {
cli.command(CLI_COMMANDS.inspectElectronPage, {
description: "Passively inspect one root-confined Electron file page",
args: z.object({ endpoint: z.string(), targetId: z.string() }),
options: z.object({