mirror of
https://github.com/morluto/rea.git
synced 2026-11-22 06:25:44 +00:00
164 lines
5.9 KiB
TypeScript
164 lines
5.9 KiB
TypeScript
/**
|
|
* Numeric `REA_` limits that are not runtime analysis settings.
|
|
*
|
|
* The static check in `scripts/verify/rea-numeric-limits.mjs` checks recognized
|
|
* TypeScript reads against this list and `ANALYSIS_SETTINGS`. External readers
|
|
* and generated controls declare separate behavioral witnesses, which the
|
|
* Node-only check cannot verify. Every remaining entry is restart-only; limits
|
|
* checked on each call belong in `ANALYSIS_SETTINGS` instead of this list.
|
|
*
|
|
* Narrative bounds, owners, and the non-numeric settings live in
|
|
* `docs/reference/rea-limit-inventory.md`. That same script compares each
|
|
* documented default, floor, and maximum with the exported value.
|
|
*/
|
|
export interface NumericLimitRegistryEntry {
|
|
readonly name: string;
|
|
readonly update_mode: "restart";
|
|
readonly policy: "restart-only";
|
|
readonly read: "startup" | "construction";
|
|
readonly reason: string;
|
|
/** Read outside the TypeScript scan or generated into a bridge; execution needs its behavioral witness. */
|
|
readonly provenance?: {
|
|
readonly kind: "external-reader" | "generated-control";
|
|
readonly source: string;
|
|
readonly witness: string;
|
|
readonly generator?: string;
|
|
readonly generatorWitness?: string;
|
|
};
|
|
}
|
|
|
|
export const NUMERIC_LIMIT_REGISTRY = [
|
|
{
|
|
name: "REA_DEBUGGER_MAX_PENDING_COMMANDS",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"Caps the pending-command queue created with the debugger session manager. It is pool capacity for that manager, not a budget checked independently on each command.",
|
|
},
|
|
{
|
|
name: "REA_DEBUGGER_MAX_SESSIONS",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"Caps how many debugger sessions the session manager created at startup will admit. Changing the pool size of a manager that already exists requires a new REA process.",
|
|
},
|
|
{
|
|
name: "REA_HOPPER_DEMO_DIALOG_TIMEOUT_MS",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"The Linux private-display adapter reads this watch from the process environment when that helper starts. A running adapter does not observe a value stored only in the REA process.",
|
|
provenance: {
|
|
kind: "external-reader",
|
|
source: "scripts/hopper-demo-x11.py",
|
|
witness: "tests/boundary/providers/hopper/linuxPrivateDisplay.test.ts",
|
|
},
|
|
},
|
|
{
|
|
name: "REA_JADX_ACTIVE_PROCESSOR_COUNT",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"Passed to the JVM as -XX:ActiveProcessorCount when the JADX worker process starts. A running JVM does not adopt a new processor count.",
|
|
},
|
|
{
|
|
name: "REA_JADX_HEAP_MIB",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"Passed to the JVM as -Xmx when the JADX worker process starts. A running JVM does not adopt a new heap size.",
|
|
},
|
|
{
|
|
name: "REA_KUNA_CACHE_MAX_BYTES",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"Sizes the Kuna project cache when that cache is constructed for the provider. An existing cache does not resize from a later value.",
|
|
},
|
|
{
|
|
name: "REA_KUNA_JOBS",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"Selects the Kuna worker-pool width when the provider builds its run slots. The pool is not resized for a process that is already running.",
|
|
},
|
|
{
|
|
name: "REA_MCP_DOCTOR_DEADLINE_MS",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"Bounds the MCP doctor phase while the server is starting. It shapes server startup, not a later analysis call.",
|
|
},
|
|
{
|
|
name: "REA_MCP_FIRST_CATALOG_BUDGET_MS",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"Bounds the first MCP catalog phase while the server is starting. It shapes server startup, not a later analysis call.",
|
|
},
|
|
{
|
|
name: "REA_MCP_INITIALIZE_BUDGET_MS",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"Bounds the MCP initialize phase while the server is starting. It shapes server startup, not a later analysis call.",
|
|
},
|
|
{
|
|
name: "REA_MCP_MAX_INPUT_ELEMENTS",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"Sizes argument admission for the MCP server created at process start. A running server does not rebuild that parser for a new allowance.",
|
|
},
|
|
{
|
|
name: "REA_MCP_MAX_RESPONSE_BYTES",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"Sizes the MCP stdio receive buffer when the server process starts. A running transport and the paired client buffer do not adopt a new ceiling.",
|
|
},
|
|
{
|
|
name: "REA_MCP_TOOLS_LIST_BUDGET_MS",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"Bounds the MCP tools/list phase while the server is starting. It shapes server startup, not a later analysis call.",
|
|
},
|
|
{
|
|
name: "REA_RECONNECT_TIMEOUT_SECONDS",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"Fixed 30-second value written into the Hopper bridge helper from HOPPER_SHUTDOWN_TIMEOUT_MS. It is not a caller-selected launch setting.",
|
|
provenance: {
|
|
kind: "generated-control",
|
|
source: "bridge/hopper_bridge.py",
|
|
generator: "src/hopper/BridgeLauncher.ts",
|
|
generatorWitness: "src/hopper/bridgeBootstrapLimit.test.ts",
|
|
witness: "tests/boundary/providers/hopper/hopperBridgeReconnect.test.ts",
|
|
},
|
|
},
|
|
{
|
|
name: "REA_SWIFTC_COMPILE_TIMEOUT_MS",
|
|
update_mode: "restart",
|
|
policy: "restart-only",
|
|
read: "startup",
|
|
reason:
|
|
"Captured when the Darwin ownership-helper reader is constructed at process start. That helper compile uses the captured deadline, so a later value needs a new REA process.",
|
|
},
|
|
] as const satisfies readonly NumericLimitRegistryEntry[];
|