docs: remove tracked planning and architecture records (#12856)

This commit is contained in:
morluto authored and GitHub committed 2026-11-20 09:47:41 -05:00
1 parent 42b36e200b
commit a1dec2d2d5
362 files changed
+119 -18521

No files matched your search

+2 -4
View File
@@ -94,8 +94,7 @@ export const skillReferenceIssues = async (skillRoot) => {
};
// Living prose that would restate the catalog size. Dated records keep the
// count they measured: release notes, feature specs, verification records and
// decision records describe a past build.
// count they measured in release notes and verification records.
export const LIVING_PROSE_ROOTS = [
"README.md",
"CONTRIBUTING.md",
@@ -104,8 +103,7 @@ export const LIVING_PROSE_ROOTS = [
".agents/skills",
"website/public",
];
const SKIPPED_PROSE =
/^docs\/(?:releases|specs|verification|adr|\.vitepress\/dist)\//u;
const SKIPPED_PROSE = /^docs\/(?:releases|verification|\.vitepress\/dist)\//u;
const PROSE_FILE = /\.(?:md|html)$/u;
// A count of ten or more tools, such as "240 tools" or "all 1,024 MCP tools".
const LITERAL_TOOL_COUNT =
+3 -7
View File
@@ -4,13 +4,9 @@
* layer. An undeclared unit fails the check, so a new directory must choose
* its layer when it is added.
*
* The order follows docs/architecture/architecture.mermaid: the dependency-free
* kernel helpers that every layer may use, domain and
* contracts at the centre, the process/filesystem foundation, the ports
* that providers implement and application consumes, the shared provider
* core (src/providers), provider adapters,
* shared application workflows, production composition, then the CLI and
* MCP entry points.
* The order starts with dependency-free kernel helpers that every layer may
* use, then the domain, contracts, process/filesystem foundation, and ports.
* Providers implement the ports and application workflows consume them.
*/
export const LAYER_ORDER = Object.freeze([
"kernel",
+3 -3
View File
@@ -15,7 +15,7 @@ javascript-application-graph javascript-application-workflows javascript-artifac
javascript-recovery javascript-runtime-observation javascript-runtime-reconciliation
jeb-analysis managed-code-analysis mcp-contracts mcp-prompts migration-6.2
native-investigation packet-captures pcap-analysis process-capture raw-binary reconstruction-obligation-ledgers
reconstruction-readiness recorded-crashes releasing roadmap signal-recordings sqlite-databases
reconstruction-readiness recorded-crashes releasing signal-recordings sqlite-databases
testing tool-design wasm-artifacts web-network-captures web-runtime web-source-location
website-module-trace website-script-export windows-ghidra-p0
binary-hardening desktop-application-capture desktop-application-export desktop-application-state
@@ -24,7 +24,7 @@ design/limits-and-recovery
`
.trim()
.split(/\s+/u);
assert.equal(routes.length, 67);
assert.equal(routes.length, 66);
assert.equal(new Set(routes).size, routes.length);
const documentation = resolve(
@@ -36,7 +36,7 @@ const checked = new Set();
let internalTargets = 0;
let sourceLinks = 0;
// Legacy public routes remain an independent baseline; all generated pages also
// participate so newly authored directories/specifications cannot escape checks.
// participate so newly authored guides cannot escape checks.
for (const route of routes) {
const html = await readFile(resolve(output, route + ".html"), "utf8");
const edit = physicalEditSource(html, route);
+3 -5
View File
@@ -93,7 +93,6 @@ check(
check("NUL-joined list key (use compositeKey)", files, /\.join\(["']\\0["']\)/);
// Pushed effect invalidation (docs/adr/javascript/pushed-effect-invalidation.md).
// Opaque-effect checks are private to javascriptSemanticEffectLog.ts, so the
// compiler keeps readers on its questions, and only the log and its record
// module read the recorded sites. A method read on an intrinsic
@@ -290,9 +289,9 @@ check(
],
);
// Native inventory results parse once against their named fact contract
// (docs/adr/native/typed-operation-facts.md). Hopper's reply table and the
// advertised output schemas own their own protocol and catalog contracts.
// Native inventory results parse once against their named fact contract.
// Hopper's reply table and the advertised output schemas own their protocol
// and catalog contracts.
check(
"native inventory rows parsed outside their fact contract (use executeFact or a contract from src/domain/native/nativeOperationFacts)",
files,
@@ -396,7 +395,6 @@ checkCounted(
["src/process/capturedProviderOutput.ts"],
);
// Pushed effect invalidation (docs/adr/javascript/pushed-effect-invalidation.md).
// Recorded effects belong to the effect log. A reader that reads an effect
// index itself decides on its own which effect kinds and proofs apply; readers
// ask the log instead. Every reader has moved; the remaining counts are the
+5 -5
View File
@@ -8,7 +8,7 @@ import ts from "typescript6";
// reported separately and are not verified by this Node-only scan.
// Per-call limits belong to ANALYSIS_SETTINGS.
// A name in REQUIRED_RUNTIME_LIMITS that is absent from source fails closed.
// Each default, floor, and maximum in docs/design/rea-limit-inventory.md must
// Each default, floor, and maximum in docs/reference/rea-limit-inventory.md must
// equal ANALYSIS_SETTINGS or the owner export the parser enforces.
const root = fileURLToPath(new URL("../../", import.meta.url));
@@ -949,7 +949,7 @@ export const parseDocumentedNumericLimits = (markdown) => {
const heading = lines.findIndex((line) => line.trim() === `## ${title}`);
if (heading < 0)
throw new Error(
`docs/design/rea-limit-inventory.md is missing "## ${title}"`,
`docs/reference/rea-limit-inventory.md is missing "## ${title}"`,
);
let index = heading + 1;
while (index < lines.length && !lines[index].startsWith("|")) {
@@ -1092,7 +1092,7 @@ export const compareDocumentedNumericLimits = (rows, bounds, names) => {
? `${bound.name} (${bound.aliases.join(", ")})`
: bound.name;
failures.push(
`${label}: code exports default ${showLimitValue(bound.defaultValue)}, floor ${showLimitValue(bound.minimum)}, maximum ${showLimitValue(bound.maximum)}, but docs/design/rea-limit-inventory.md has no row`,
`${label}: code exports default ${showLimitValue(bound.defaultValue)}, floor ${showLimitValue(bound.minimum)}, maximum ${showLimitValue(bound.maximum)}, but docs/reference/rea-limit-inventory.md has no row`,
);
}
return failures;
@@ -1373,7 +1373,7 @@ if (direct) {
)) {
if (!runtime.has(name) && !listed.has(name))
failures.push(
`${name} in ${file.path} is neither an analysis setting nor docs/design/rea-limit-inventory.md via src/domain/numericLimitRegistry.ts`,
`${name} in ${file.path} is neither an analysis setting nor docs/reference/rea-limit-inventory.md via src/domain/numericLimitRegistry.ts`,
);
}
for (const name of listed.keys()) {
@@ -1453,7 +1453,7 @@ if (direct) {
if (checkout) {
try {
const inventory = await readFile(
join(root, "docs/design/rea-limit-inventory.md"),
join(root, "docs/reference/rea-limit-inventory.md"),
"utf8",
);
const exported = await loadExportedNumericLimitBounds();