Add mirror smoke marker document
Intent: Introduce a dedicated smoke-test marker file that the deployed runtime can look for after a forge merge, validating that the GitHub mirror sync pipeline picks up new content with acceptable latency.
Affected files: docs/forge-mirror-smoke.md
@@ -0,0 +1,7 @@
+---
+summary: Mirror smoke branch marker used to validate hosted GitHub mirror latency.
+read_when:
+ - validating post-deploy forge mirror behavior
+---
+
+Mirror smoke validation: deployed runtime should request and run mirror sync promptly after a forge merge.
A new file docs/forge-mirror-smoke.md is added to the repository with no modifications to any existing files.
What the file contains
- YAML front-matter — declares a
summarydescribing its purpose (mirror latency validation) and aread_whencondition scoped to validating post-deploy forge mirror behavior. - Body text — a single sentence asserting the expected behavior: the deployed runtime should request and execute a mirror sync promptly after a forge merge.
Why it matters
The file acts as a canary artifact. By merging a known marker into the repository, operators can verify end-to-end that:
- The forge merge propagates to the hosted GitHub mirror.
- The deployed runtime detects and fetches the new content within an acceptable latency window.
Because the file is purely declarative documentation with no code side-effects, it is safe to merge and serves only as an observable signal for the mirror smoke test.