mirror of
https://github.com/morluto/rea.git
synced 2026-11-15 19:23:24 +00:00
morluto
ecf5372627
* ci(guards): run the architecture guards in the pre-push check * docs(limits): name lint as the numeric-limit check's owner * ci(lint): cache the numeric-limit check by every file its restart-field scan reads
68 lines
2.3 KiB
TypeScript
68 lines
2.3 KiB
TypeScript
/** Relative path of the registry. Its text is a declaration, not a producer. */
|
|
export const NUMERIC_LIMIT_DECLARATION: "src/domain/numericLimitRegistry.ts";
|
|
|
|
/** Roots scanned for the removed restart-field names. */
|
|
export const FORBIDDEN_FIELD_SCAN_ROOTS: readonly string[];
|
|
|
|
/** File extensions, without the dot, scanned under those roots. */
|
|
export const FORBIDDEN_FIELD_SCAN_EXTENSIONS: readonly string[];
|
|
|
|
/** True for a numeric `REA_` limit, including the documented endpoint-candidate count. */
|
|
export function isNumericLimit(name: string): boolean;
|
|
|
|
/** Statically declared environment seeds owned by ANALYSIS_SETTINGS. */
|
|
export function parseRuntimeSettingEnvironments(source: string): Set<string>;
|
|
|
|
/** Detect stale or newly introduced temporary per-call exceptions. */
|
|
export function perCallLimitFailures(
|
|
listed: ReadonlyMap<string, string>,
|
|
temporary: ReadonlySet<string>,
|
|
): string[];
|
|
|
|
/** Parse static registry declarations, including external-reader provenance. */
|
|
export function parseNumericLimitRegistry(source: string): Array<{
|
|
name: string;
|
|
update_mode: "restart";
|
|
policy: "restart-only" | "per-call";
|
|
read: "startup" | "per-call" | "construction";
|
|
reason: string;
|
|
provenance?: {
|
|
kind: "external-reader" | "generated-control";
|
|
source: string;
|
|
witness: string;
|
|
generator?: string;
|
|
generatorWitness?: string;
|
|
};
|
|
}>;
|
|
|
|
/** Producer paths for numeric limits. Registry text, comments, and allowlists are omitted. */
|
|
export function discoverNumericLimitUses(
|
|
files: readonly { readonly path: string; readonly source: string }[],
|
|
): Map<
|
|
string,
|
|
{
|
|
readonly path: string;
|
|
read: "module" | "construction" | "unknown";
|
|
readonly sites: Array<{
|
|
readonly path: string;
|
|
readonly read: "module" | "construction" | "unknown";
|
|
readonly offset: number;
|
|
readonly evidence: "direct" | "candidate";
|
|
}>;
|
|
}
|
|
> & {
|
|
readonly unresolved: readonly {
|
|
readonly path: string;
|
|
readonly offset: number;
|
|
readonly line: number;
|
|
readonly column: number;
|
|
readonly reason: string;
|
|
}[];
|
|
};
|
|
|
|
/** Why a tracked limit is not an analysis setting, when it is present. */
|
|
export function requiredRuntimeLimitFailure(
|
|
name: string,
|
|
presence: { readonly inRuntime: boolean; readonly inRegistry: boolean },
|
|
): string | undefined;
|