Add a markdown-native System Guide acceptance fixture for notebook runtime parity #129

New issue

Closed

opened 2026-05-27 13:33:29 +00:00 by steve · 0 comments

steve commented

2026-05-27 13:33:29 +00:00

Owner

Add a markdown-native notebook fixture and acceptance coverage that reproduces the key behavior demonstrated by Observable's System Guide.

Problem

Notebook runtime parity work currently relies on scattered unit tests and existing demo notes. That makes it harder to tell whether the Lapis runtime behaves like the intended Observable v2 execution model from a user-facing perspective.

Goal

Create one stable .notebook.md acceptance target that exercises the System Guide behavior through Lapis syntax and can be used to verify runtime and rendering changes over time.

Scope

Add a markdown-native fixture note and any required supporting assets.
Add workspace acceptance coverage for the fixture.
Use the fixture to verify notebook runtime/rendering changes delivered under TASK-NOTEBOOK-002.

Non-goals

Do not change the canonical notebook file format.
Do not turn this issue into the broader runtime implementation itself.
Do not require exact Observable source syntax; only the rendered/executed behavior needs to align.

Acceptance Criteria

The repo contains a .notebook.md fixture that covers the targeted System Guide behaviors in Lapis syntax.
Workspace e2e or equivalent acceptance coverage validates the fixture output and interaction path.
The fixture avoids legacy viewof syntax and uses the current plain view(...) authoring path.

Implementation Notes

Keep the fixture readable enough to serve as a future regression reference.
Prefer coverage that validates visible runtime behavior rather than internal implementation details.

Suggested Files or Specs To Inspect

e2e-vault/plugin-notebook/Notebook Gallery.notebook.md
packages/workspace/e2e/notebook-*.spec.ts
packages/workspace/e2e/notebook.helpers.ts
spec/src/20-packages/plugins/notebook/documents-and-runtime.md

Validation Commands

pnpm --filter @lapis-notes/workspace exec playwright test packages/workspace/e2e
pnpm --filter @lapis-notes/workspace check
pnpm test:smoke

Follow-up Tasks

Expand the fixture only when additional parity behaviors are intentionally promoted into scope.

Implementation Summary

Added a checked-in markdown-native System Guide notebook fixture with a vault-backed attachment, covered it with focused workspace Playwright acceptance, and documented the fixture as the current Observable parity anchor for supported async, view(...), markdown, html, and FileAttachment behavior.

Add a markdown-native notebook fixture and acceptance coverage that reproduces the key behavior demonstrated by Observable's System Guide. ## Problem Notebook runtime parity work currently relies on scattered unit tests and existing demo notes. That makes it harder to tell whether the Lapis runtime behaves like the intended Observable v2 execution model from a user-facing perspective. ## Goal Create one stable `.notebook.md` acceptance target that exercises the System Guide behavior through Lapis syntax and can be used to verify runtime and rendering changes over time. ## Scope - Add a markdown-native fixture note and any required supporting assets. - Add workspace acceptance coverage for the fixture. - Use the fixture to verify notebook runtime/rendering changes delivered under `TASK-NOTEBOOK-002`. ## Non-goals - Do not change the canonical notebook file format. - Do not turn this issue into the broader runtime implementation itself. - Do not require exact Observable source syntax; only the rendered/executed behavior needs to align. ## Acceptance Criteria - The repo contains a `.notebook.md` fixture that covers the targeted System Guide behaviors in Lapis syntax. - Workspace e2e or equivalent acceptance coverage validates the fixture output and interaction path. - The fixture avoids legacy `viewof` syntax and uses the current plain `view(...)` authoring path. ## Implementation Notes - Keep the fixture readable enough to serve as a future regression reference. - Prefer coverage that validates visible runtime behavior rather than internal implementation details. ## Suggested Files or Specs To Inspect - `e2e-vault/plugin-notebook/Notebook Gallery.notebook.md` - `packages/workspace/e2e/notebook-*.spec.ts` - `packages/workspace/e2e/notebook.helpers.ts` - `spec/src/20-packages/plugins/notebook/documents-and-runtime.md` ## Validation Commands ```bash pnpm --filter @lapis-notes/workspace exec playwright test packages/workspace/e2e pnpm --filter @lapis-notes/workspace check pnpm test:smoke ``` ## Follow-up Tasks - Expand the fixture only when additional parity behaviors are intentionally promoted into scope. ## Implementation Summary Added a checked-in markdown-native System Guide notebook fixture with a vault-backed attachment, covered it with focused workspace Playwright acceptance, and documented the fixture as the current Observable parity anchor for supported async, view(...), markdown, html, and FileAttachment behavior.

steve added this to the Complete Daily-Use App milestone

2026-05-27 13:33:29 +00:00

steve added the

labels

2026-05-27 13:33:29 +00:00