fix(docs/exports): gate reference drift and repair Fresh UI coverage

.github/workflows/pages.yml

@@ -140,6 +140,9 @@ jobs:
         uses: denoland/setup-deno@v2
         with:
           deno-version: '2.9.5'
+      - name: Check documentation exports drift
+        if: env.RUN == 'true'
+        run: deno task docs:exports-drift
       - name: Check documentation snippets
         if: env.RUN == 'true'
         run: deno task docs:snippets

.llm/assets/agent-docs/provenance.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "version": "0.0.6",
-  "sourceCommit": "ef3e43f06",
-  "extractionTimestamp": "2026-08-15T18:30:08.338Z",
+  "sourceCommit": "0d4c82d6e",
+  "extractionTimestamp": "2026-08-15T20:40:35.830Z",
   "files": [
     "context/01-how-the-web-became-the-default.mdx",
     "context/02-how-the-web-stack-grew-up.mdx",
@@ -186,7 +186,7 @@
     "pages/web-layer/vite/index.md",
     "pages/why/index.md"
   ],
-  "uncompressedBytes": 4755371,
-  "compressedBytes": 1364040,
-  "sha256": "c8491e535b4c728541439196ad4862ead67a9e2305af1d91e6412091b38bfd28"
+  "uncompressedBytes": 4770349,
+  "compressedBytes": 1368351,
+  "sha256": "c1d095a62e72555356d346d78848bff144ce9773c38eb9cd95f2d406b28174b3"
 }

.llm/runs/release-0.0.7-internals--orchestration/slices/reference-export-drift-gate/audit/base-refresh/evidence-set.json

@@ -0,0 +1,35 @@
+{
+  "schemaVersion": 1,
+  "immutableHead": "8c03d862931b64573df9a4bac76ebf266e0ec175",
+  "surface": "reference-export-drift-gate post-eval base refresh",
+  "expectedGateIds": [
+    "agent-docs-prose",
+    "arch-check",
+    "assets-barrel",
+    "check",
+    "docs-accuracy",
+    "docs-source-format",
+    "docs-source-format-test",
+    "docs-tagline",
+    "publish-assets",
+    "publish-dry-run",
+    "quality-job",
+    "test"
+  ],
+  "receiptIds": [
+    "reference-export-base-refresh-agent-docs-prose",
+    "reference-export-base-refresh-arch-check",
+    "reference-export-base-refresh-assets-barrel",
+    "reference-export-base-refresh-check",
+    "reference-export-base-refresh-docs-accuracy",
+    "reference-export-base-refresh-docs-source-format",
+    "reference-export-base-refresh-docs-source-format-test",
+    "reference-export-base-refresh-docs-tagline",
+    "reference-export-base-refresh-publish-assets",
+    "reference-export-base-refresh-publish-dry-run",
+    "reference-export-base-refresh-quality-job",
+    "reference-export-base-refresh-test"
+  ],
+  "sufficiency": "SUFFICIENT",
+  "reasons": []
+}

.llm/runs/release-0.0.7-internals--orchestration/slices/reference-export-drift-gate/audit/base-refresh/path-lock-union.json

@@ -0,0 +1,53 @@
+{
+  "schemaVersion": 1,
+  "immutableHead": "8c03d862931b64573df9a4bac76ebf266e0ec175",
+  "mergeParents": [
+    "0d4c82d6e4bd327abd88eb8b80e7a7acd20ea4aa",
+    "0ef48c2ec661a7e6d55ec2faf5def6ae7dd2e6eb"
+  ],
+  "conflictAndCombinedDiffPaths": [
+    ".llm/assets/agent-docs/prose.json.gz",
+    ".llm/assets/agent-docs/provenance.json",
+    "packages/cli/src/kernel/assets/agent-docs.generated.ts",
+    "packages/mcp/src/publish-assets.generated.ts"
+  ],
+  "implementationPathCount": 14,
+  "authorizedContractPathCount": 17,
+  "implementationPaths": [
+    ".github/workflows/pages.yml",
+    ".llm/assets/agent-docs/prose.json.gz",
+    ".llm/assets/agent-docs/provenance.json",
+    ".llm/tools/docs/check-accuracy-and-discoverability.ts",
+    ".llm/tools/docs/check-exports-drift.ts",
+    ".llm/tools/docs/check-exports-drift_test.ts",
+    "deno.json",
+    "docs/site/reference/fresh-ui/index.md",
+    "packages/cli/src/kernel/assets/agent-docs.generated.ts",
+    "packages/contracts/schemas/filters.ts",
+    "packages/contracts/schemas/pagination.ts",
+    "packages/contracts/src/application/paginated-query.ts",
+    "packages/contracts/src/application/transform-helpers.ts",
+    "packages/mcp/src/publish-assets.generated.ts"
+  ],
+  "unexpectedImplementationPaths": [],
+  "unionEvidence": {
+    "main1665Page": "pages/web-layer/query-bridge/index.md",
+    "main1665Markers": [
+      "one possibility is that two",
+      "module instances are loaded"
+    ],
+    "leaf1666Page": "pages/reference/fresh-ui/index.md",
+    "leaf1666Marker": "exact, reason-bearing omission group",
+    "allPresentInCanonicalCorpus": true
+  },
+  "corpus": {
+    "fileCount": 181,
+    "uncompressedBytes": 4770349,
+    "compressedBytes": 1368351,
+    "canonicalSha256": "c1d095a62e72555356d346d78848bff144ce9773c38eb9cd95f2d406b28174b3",
+    "gzipSha256": "46703a024d102c278043e2b48ebab906154c728a9c615d939651842068c52f7c"
+  },
+  "denoLockBlob": "a1522e6ecc98dd4232312385b0cea4e52f5fa4b2",
+  "denoLockMatchesPremergeMainHeadAndWorkingTree": true,
+  "priorEvidenceAppendOnly": true
+}

.llm/runs/release-0.0.7-internals--orchestration/slices/reference-export-drift-gate/audit/doc-lint-contracts.json

@@ -0,0 +1,83 @@
+{
+  "source": {
+    "mode": "auto",
+    "root": "packages/contracts",
+    "entrypoints": [
+      "./crud.ts",
+      "./mod.ts",
+      "./query.ts",
+      "./transform.ts"
+    ],
+    "exitCode": 1
+  },
+  "summary": {
+    "totalPackages": 1,
+    "totalErrors": 9,
+    "totalPrivateTypeRef": 9,
+    "totalMissingJSDoc": 0,
+    "totalOther": 0
+  },
+  "packages": [
+    {
+      "name": "@netscript/contracts",
+      "dir": "packages/contracts",
+      "entrypoints": [
+        {
+          "path": "./crud.ts",
+          "privateTypeRef": 12,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 12
+        },
+        {
+          "path": "./mod.ts",
+          "privateTypeRef": 8,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 8
+        },
+        {
+          "path": "./query.ts",
+          "privateTypeRef": 0,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 0
+        },
+        {
+          "path": "./transform.ts",
+          "privateTypeRef": 0,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 0
+        }
+      ],
+      "files": [
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/contracts/src/application/contract-primitives.ts",
+          "privateTypeRef": 8,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 8
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/contracts/crud/create-crud-contract.ts",
+          "privateTypeRef": 1,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 1
+        }
+      ],
+      "combinedTotal": 9,
+      "combinedPrivateTypeRef": 9,
+      "combinedMissingJSDoc": 0,
+      "combinedOther": 0,
+      "combinedExitCode": 1,
+      "entrypointExitCodes": {
+        "./crud.ts": 1,
+        "./mod.ts": 1,
+        "./query.ts": 0,
+        "./transform.ts": 0
+      }
+    }
+  ]
+}

.llm/runs/release-0.0.7-internals--orchestration/slices/reference-export-drift-gate/audit/doc-lint-fresh-ui.json

@@ -0,0 +1,192 @@
+{
+  "source": {
+    "mode": "auto",
+    "root": "packages/fresh-ui",
+    "entrypoints": [
+      "./desktop.ts",
+      "./interactive.ts",
+      "./mod.ts",
+      "./primitives.tsx",
+      "./registry.ts",
+      "./src/ai/render-ui.tsx"
+    ],
+    "exitCode": 1
+  },
+  "summary": {
+    "totalPackages": 1,
+    "totalErrors": 123,
+    "totalPrivateTypeRef": 96,
+    "totalMissingJSDoc": 27,
+    "totalOther": 0
+  },
+  "packages": [
+    {
+      "name": "@netscript/fresh-ui",
+      "dir": "packages/fresh-ui",
+      "entrypoints": [
+        {
+          "path": "./desktop.ts",
+          "privateTypeRef": 0,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 0
+        },
+        {
+          "path": "./interactive.ts",
+          "privateTypeRef": 96,
+          "missingJSDoc": 27,
+          "other": 0,
+          "total": 123
+        },
+        {
+          "path": "./mod.ts",
+          "privateTypeRef": 0,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 0
+        },
+        {
+          "path": "./primitives.tsx",
+          "privateTypeRef": 0,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 0
+        },
+        {
+          "path": "./registry.ts",
+          "privateTypeRef": 0,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 0
+        },
+        {
+          "path": "./src/ai/render-ui.tsx",
+          "privateTypeRef": 0,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 0
+        }
+      ],
+      "files": [
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/combobox/combobox.types.ts",
+          "privateTypeRef": 15,
+          "missingJSDoc": 18,
+          "other": 0,
+          "total": 33
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/popover/Popover.tsx",
+          "privateTypeRef": 10,
+          "missingJSDoc": 1,
+          "other": 0,
+          "total": 11
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/popover/popover.types.ts",
+          "privateTypeRef": 10,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 10
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/dialog/Dialog.tsx",
+          "privateTypeRef": 6,
+          "missingJSDoc": 1,
+          "other": 0,
+          "total": 7
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/drawer/Drawer.tsx",
+          "privateTypeRef": 6,
+          "missingJSDoc": 1,
+          "other": 0,
+          "total": 7
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/sheet/Sheet.tsx",
+          "privateTypeRef": 6,
+          "missingJSDoc": 1,
+          "other": 0,
+          "total": 7
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/tooltip/Tooltip.tsx",
+          "privateTypeRef": 6,
+          "missingJSDoc": 1,
+          "other": 0,
+          "total": 7
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/accordion/Accordion.tsx",
+          "privateTypeRef": 5,
+          "missingJSDoc": 1,
+          "other": 0,
+          "total": 6
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/dialog/dialog.types.ts",
+          "privateTypeRef": 6,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 6
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/sheet/sheet.types.ts",
+          "privateTypeRef": 6,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 6
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/tooltip/tooltip.types.ts",
+          "privateTypeRef": 6,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 6
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/accordion/accordion.types.ts",
+          "privateTypeRef": 5,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 5
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/tabs/Tabs.tsx",
+          "privateTypeRef": 4,
+          "missingJSDoc": 1,
+          "other": 0,
+          "total": 5
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/tabs/tabs.types.ts",
+          "privateTypeRef": 4,
+          "missingJSDoc": 0,
+          "other": 0,
+          "total": 4
+        },
+        {
+          "path": "/home/codex/repos/netscript-007-reference-export/packages/fresh-ui/src/runtime/combobox/Combobox.tsx",
+          "privateTypeRef": 1,
+          "missingJSDoc": 2,
+          "other": 0,
+          "total": 3
+        }
+      ],
+      "combinedTotal": 123,
+      "combinedPrivateTypeRef": 96,
+      "combinedMissingJSDoc": 27,
+      "combinedOther": 0,
+      "combinedExitCode": 1,
+      "entrypointExitCodes": {
+        "./desktop.ts": 0,
+        "./interactive.ts": 1,
+        "./mod.ts": 0,
+        "./primitives.tsx": 0,
+        "./registry.ts": 0,
+        "./src/ai/render-ui.tsx": 0
+      }
+    }
+  ]
+}