Skip to content

Commit f54d9f5

Browse files
committed
docs: preserve latest staging Search assets and compatibility evidence
1 parent 5588062 commit f54d9f5

4 files changed

Lines changed: 97 additions & 14 deletions

File tree

‎apps/docs/migration/VERIFICATION.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@ The merge preserves seven upstream prose/reference updates, two updated OpenAPI
1212

1313
Independent source comparison found no lost authored routes, heading anchors, code fences or operation identities against either main `a52fc509b5b8a18df519ff0781f00c8d45711164` or the new staging commit. Current staging and the merge both contain 495 authored pages, 22,012 headings, 1,236 code fences and 308 operations across seven specifications and 201 paths. All 187 staging assets and all seven specification files match the merge byte-for-byte. The remaining MDX differences from staging are component imports, shared screenshot sizing props, and the Introduction's shared Cards wrapper. The historical reports below were not regenerated by this inventory refresh and do not establish HTTP or browser verification of the new merge.
1414

15+
The final CI comparison incorporated staging `3175daab84bfc2d7dfc8d924d55313190c280476` at merge `558806215e94d50582309f9bee38069691ba49c4`. The compatibility inventory was rebuilt from that exact Git archive using Fumadocs 16.8.5, retaining the original evidence commit and digest. The preceding baseline remains in commit `fb45faeb4983d2b64906c3bd1554caeb43e2c152` with SHA-256 `3e55855ff9a0687da205a8e764eb17b1b3dc0aad8a6ef0db625731fd8526f998`. Upstream changed only the Connect your account guide and three Search screenshots: `assistant-action-review.png`, `assistant-tool-permissions.png`, and `organization-search.png`. The guide now specifies one connected account per provider, explains tool-description controls, removes the Reset instruction, and requires reconnecting with the same provider identity. Counts remain 495 pages, 22,012 headings, 1,236 fences, 308 operations, seven specifications, 201 paths, 187 assets, and 249 redirects; no routes, heading anchors, fences, operation identities, or specifications changed. All 187 assets and seven specification files match the merge byte-for-byte, and the changed guide matches staging exactly. No preservation assertion was relaxed. This source-only refresh did not run builds or tests, regenerate historical reports, or relabel the measurements taken at `66faa48d018adaa7ebf540968f029455557cfef1`.
16+
1517
## Preserved corpus
1618

1719
- 495 authored MDX documents and 308 generated operations across seven specifications and 201 paths.

‎apps/docs/migration/baseline.json‎

Lines changed: 9 additions & 9 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎apps/docs/migration/production-readiness.md‎

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,13 +12,20 @@ The implementation passes the verified pre-release checks, but production releas
1212
| Previous production / main | `a52fc509b5b8a18df519ff0781f00c8d45711164`; GitHub deployment `7407017030`, live `docs.sim.ai` |
1313
| Initial staging comparison | `9e2afe0c4d3ce970f5c5251028ef6b7f2f0add0d` |
1414
| Staging incorporated during audit | `5facc5f2656fdc2c09b5a5e3b39476ad60f6cb49`, merged at `179c340e8069b59d770cfc763dd42602d8c66c76` |
15-
| Candidate source | `66faa48d018adaa7ebf540968f029455557cfef1`; final validation below |
15+
| Benchmarked implementation source | `66faa48d018adaa7ebf540968f029455557cfef1`; final validation below |
16+
| Latest staging synchronization | `3175daab84bfc2d7dfc8d924d55313190c280476`, merged at `558806215e94d50582309f9bee38069691ba49c4` |
1617
| Before measurements | [Run 40998182625](https://github.com/simstudioai/sim/actions/runs/40998182625); raw Lighthouse JSON/HTML, navigation/network records and viewport captures |
1718
| Corrected before interaction harness | [Run 41045285861](https://github.com/simstudioai/sim/actions/runs/41045285861); all 132 observations completed against immutable f06 |
1819
| Corrected before navigation harness | [Run 41041567090](https://github.com/simstudioai/sim/actions/runs/41041567090); immutable f06 build, no further production traffic |
1920

2021
The source inventory was independently reconstructed from Git blobs and version-matched Fumadocs AST transforms, then cross-checked against the migration fixture. [baseline.json](baseline.json) now identifies the incorporated staging commit; its original evidence commit and digest are retained. Historical [report.json](report.json) was not silently regenerated by ordinary builds. [VERIFICATION.md](VERIFICATION.md) records the refresh provenance.
2122

23+
### Later staging changes caught by final verification
24+
25+
[Run 41119763582](https://github.com/simstudioai/sim/actions/runs/41119763582) tested merge `efca1d6bdeeea8791cad8c8f01a5f5ff55b70144` against newer staging `3175daab`. It passed all browser/interface/database/sample/generator checks but correctly failed seven corpus assertions because the compatibility fixture still recorded three previous Search screenshots. The Git diff independently confirms three replacement PNGs and four prose changes in Connect your account: one account per provider, tool-description help, removal of the Reset instruction, and reconnecting with the same provider identity. These intentional product changes were incorporated, and the compatibility inventory was reconstructed from that exact staging tree without weakening its assertions. [Retained failure and refresh provenance](readiness/staging-refresh.json).
26+
27+
The full before/after tables below remain attributed to measured source `66faa48`; they are not relabeled as measurements of the newer Search screenshot. Shared docs components, compiler and performance fixes are unchanged by this synchronization. The final-head checks and post-synchronization confirmation run are linked in the PR. The retained introduction/API/frame captures do not depict the three replaced Search images.
28+
2229
## Issues corrected
2330

2431
| Issue and impact | Central owner / correction | Regression evidence |
@@ -112,7 +119,7 @@ Report median, range and raw n=3 observations, not p95. A 100 ms local-control t
112119

113120
### Navigation and interactions
114121

115-
The exact final source completed all **300/300 navigation/interaction observations** in [run 41114445590](https://github.com/simstudioai/sim/actions/runs/41114445590). The companion [navigation observations](readiness/navigation-observations.csv) retain the corrected before set, final set and explicitly incomplete production set, including request counts, known body bytes, intent requests, media timing and long tasks.
122+
The exact benchmarked source completed all **300/300 navigation/interaction observations** in [run 41114445590](https://github.com/simstudioai/sim/actions/runs/41114445590). The companion [navigation observations](readiness/navigation-observations.csv) retain the corrected before set, final set and explicitly incomplete production set, including request counts, known body bytes, intent requests, media timing and long tasks.
116123

117124
All times in milliseconds; median (range; n). Raw observations are retained in the companion CSV.
118125

@@ -294,7 +301,7 @@ Manual inspection of the downloaded `179c340` production build confirmed the unc
294301

295302
## Validation and remaining release steps
296303

297-
**Assessment: ready for PR review; not cleared for production release or first index publication.** The tested source is `66faa48d018adaa7ebf540968f029455557cfef1`. Repository verification, preservation and boundary checks pass; live provider/relevance and actual CDN verification remain release requirements. Performance targets are partially met, with the heavy mobile page explicitly below target. No production change is implied by this report.
304+
**Assessment: ready for PR review; not cleared for production release or first index publication.** The full measured implementation source is `66faa48d018adaa7ebf540968f029455557cfef1`; the later staging synchronization and its required final-head verification are identified above. Repository verification, preservation and boundary checks pass; live provider/relevance and actual CDN verification remain release requirements. Performance targets are partially met, with the heavy mobile page explicitly below target. No production change is implied by this report.
298305

299306
| Check | Status | Exact evidence / limitation |
300307
| --- | --- | --- |
@@ -318,9 +325,9 @@ Manual inspection of the downloaded `179c340` production build confirmed the unc
318325
| Native Safari/Find/zoom/text scaling/screen reader | Not verified | Emulation and WebKit automation do not replace these manual/device checks |
319326
| `sim.ai/docs` cutover / rollback rehearsal | Not verified; out of scope | Current canonicals remain `docs.sim.ai`; exact future checklist maintained separately |
320327

321-
The docs PR workflow checked merge `4a9977a2c1ed434f8251f67cfa77ab78961f7f79`, combining candidate `66faa48` with staging `13a782b804b938ecdd4322c825706d254734ac58`; the generator report confirms that checkout. Performance was measured on exact standalone candidate `66faa48`. This report and retained evidence are a report-only follow-up; the [PR checks](https://github.com/simstudioai/sim/pull/9459/checks) show validation of the resulting final head. [Validation summary](readiness/validation.json) records run provenance and supported/unsupported counts. [Chunk negative controls](readiness/chunk-regression.json) retain their original b313/179 source labels rather than being relabeled as new measurements.
328+
The docs PR workflow checked merge `4a9977a2c1ed434f8251f67cfa77ab78961f7f79`, combining candidate `66faa48` with staging `13a782b804b938ecdd4322c825706d254734ac58`; the generator report confirms that checkout. Performance was measured on exact standalone candidate `66faa48`. The report/evidence follow-up and later staging synchronization are identified above; the [PR checks](https://github.com/simstudioai/sim/pull/9459/checks) show validation of the resulting final head. [Validation summary](readiness/validation.json) records run provenance and supported/unsupported counts. [Chunk negative controls](readiness/chunk-regression.json) retain their original b313/179 source labels rather than being relabeled as new measurements.
322329

323-
Representative captures below come from the final docs CI merge build, not a development server. Full artifacts also contain every breakpoint, image frame, streaming panel, search/error state and keyboard check.
330+
Representative captures below come from the measured `4a9977a` docs CI merge build, not a development server. Full artifacts also contain every breakpoint, image frame, streaming panel, search/error state and keyboard check.
324331

325332
- [Desktop introduction and inline platform framing](readiness/captures/image-hero-1440.png)
326333
- [Dark phone layout](readiness/captures/responsive-dark-390.png)
Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
{
2+
"failedRun": "https://github.com/simstudioai/sim/actions/runs/41119763582",
3+
"testedMerge": "efca1d6bdeeea8791cad8c8f01a5f5ff55b70144",
4+
"stagingSource": "3175daab84bfc2d7dfc8d924d55313190c280476",
5+
"supersededCompatibilitySource": "5facc5f2656fdc2c09b5a5e3b39476ad60f6cb49",
6+
"failures": [
7+
{
8+
"name": "HTML identity, anchors, media and operation reference",
9+
"path": "/search",
10+
"status": "failed",
11+
"durationMs": 34,
12+
"responseStatus": 200,
13+
"bytes": 504740,
14+
"error": "Missing source media /static/search/organization-search.png (expected /static/search/organization-search.png)"
15+
},
16+
{
17+
"name": "HTML identity, anchors, media and operation reference",
18+
"path": "/search/ask-questions",
19+
"status": "failed",
20+
"durationMs": 26,
21+
"responseStatus": 200,
22+
"bytes": 523078,
23+
"error": "Missing source media /static/search/assistant-action-review.png (expected /static/search/assistant-action-review.png)"
24+
},
25+
{
26+
"name": "HTML identity, anchors, media and operation reference",
27+
"path": "/search/connect-your-account",
28+
"status": "failed",
29+
"durationMs": 31,
30+
"responseStatus": 200,
31+
"bytes": 484147,
32+
"error": "Missing source media /static/search/assistant-tool-permissions.png (expected /static/search/assistant-tool-permissions.png)"
33+
},
34+
{
35+
"name": "HTML identity, anchors, media and operation reference",
36+
"path": "/search/find-content",
37+
"status": "failed",
38+
"durationMs": 24,
39+
"responseStatus": 200,
40+
"bytes": 477582,
41+
"error": "Missing source media /static/search/organization-search.png (expected /static/search/organization-search.png)"
42+
},
43+
{
44+
"name": "Original public asset bytes preserved",
45+
"path": "/static/search/assistant-action-review.png",
46+
"status": "failed",
47+
"durationMs": 1,
48+
"responseStatus": 200,
49+
"bytes": 78318,
50+
"error": "Asset differs from its original source bytes"
51+
},
52+
{
53+
"name": "Original public asset bytes preserved",
54+
"path": "/static/search/assistant-tool-permissions.png",
55+
"status": "failed",
56+
"durationMs": 1,
57+
"responseStatus": 200,
58+
"bytes": 72055,
59+
"error": "Asset differs from its original source bytes"
60+
},
61+
{
62+
"name": "Original public asset bytes preserved",
63+
"path": "/static/search/organization-search.png",
64+
"status": "failed",
65+
"durationMs": 1,
66+
"responseStatus": 200,
67+
"bytes": 51203,
68+
"error": "Asset differs from its original source bytes"
69+
}
70+
],
71+
"preservationAssertionsChanged": false,
72+
"previousBaselineSha256": "3e55855ff9a0687da205a8e764eb17b1b3dc0aad8a6ef0db625731fd8526f998",
73+
"refreshedBaselineSha256": "54de4878f15e69585c15453d3f2b4501806033df0ecf6fadf7cb17a5782d0f10"
74+
}

0 commit comments

Comments
 (0)