Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

docs(spec): isolate playground storage and parent-page access (#6497)

Cindy Zhangfe3bf3a60c2d
diff --git a/docs/specs/AST-030/spec.md b/docs/specs/AST-030/spec.md
index 8824a9e902..68e1ffa209 100644
--- a/docs/specs/AST-030/spec.md
+++ b/docs/specs/AST-030/spec.md
@@ -18,6 +18,17 @@ affects_consumer_docs: []
# Positive CI surface routing system spec
+<!-- review-applicability:v1 -->
+
+```json
+{
+ "scope": "global",
+ "triggers": {
+ "testing": ["FR7", "FR11"]
+ }
+}
+```
+
## Intent
Route pull-request checks from the repository surfaces a change can affect rather
diff --git a/docs/specs/AST-033/spec.md b/docs/specs/AST-033/spec.md
index 71e73d0a07..0cbc7e9ee9 100644
--- a/docs/specs/AST-033/spec.md
+++ b/docs/specs/AST-033/spec.md
@@ -24,7 +24,16 @@ affects_consumer_docs: [docsite]
{
"scope": "global",
"triggers": {
- "docsite": ["DEC-1", "DEC-2", "DEC-3", "DEC-5", "FR3", "FR8", "FR13"]
+ "docsite": [
+ "DEC-1",
+ "DEC-2",
+ "DEC-3",
+ "DEC-5",
+ "FR3",
+ "FR8",
+ "FR13",
+ "FR16"
+ ]
}
}
```
@@ -169,6 +178,25 @@ for each bug.
Cancelled, rejected, failed, ignored, closed, or superseded work MUST NOT emit a
success event.
+### Playground storage and parent-page isolation
+
+- **FR16 — Production playground code is isolated from storage and the parent page.**
+ Production previews, including deployed pull-request previews, MUST execute
+ user-authored code with an opaque origin, without access to the Docsite's
+ origin-bound storage or parent-page DOM. Local storage may be blocked entirely;
+ previewed code has no persistence guarantee. The playground MUST explain these
+ restrictions to users. Local development MAY differ, but MUST NOT stand in for
+ production isolation evidence.
+
+ Reload or hostile navigation may reset preview runtime state. The playground
+ MUST recover a trusted preview with the editor's current code and active
+ theme/mode. Replacement content MUST NOT receive editor source, theme state, or
+ authority to edit the parent merely because it occupies the preview.
+
+ Changes to this boundary require real production-browser evidence for storage
+ and parent-DOM denial, trusted recovery after reload and hostile navigation,
+ and restoration of current code and theme/mode.
+
### Authority routing
`architecture:knowledge-contracts` owns public-delta routing and change disposition.
@@ -300,6 +328,20 @@ treatment. Closing or superseding the transition ends that authority.
Rejected: one global pending/deferred value repainting a newly opened, closed, or
newer selection.
+### DEC-6 — Trying code does not require persistence or parent-page access
+
+**Reference:** `spec:AST-033/DEC-6`
+**Decider:** `cixzhang`, `2026-09-23`
+
+The playground is for trying Astryx code, not storing local data. Production
+previews have an opaque origin and no access to the Docsite's origin-bound
+storage or parent-page DOM. Previewed code has no persistence guarantee;
+restrictions are explained to users. Development may differ. Reload and hostile
+navigation recover a trusted preview with current editor code and theme/mode.
+
+Rejected: treating local persistence or parent-page DOM access as a playground
+guarantee.
+
## Open questions
None.