@happyvertical/smrt-playground 0.51.37 → 0.51.39

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/agents/host.md +45 -0
  2. package/package.json +4 -3
package/agents/host.md ADDED
@@ -0,0 +1,45 @@
1
+ # host
2
+
3
+ Private SvelteKit fixture that hosts the shared playground for the
4
+ `@happyvertical/smrt-playground` Playwright suite. It is a workspace test
5
+ fixture — not a published package and not an application template.
6
+
7
+ It is registered as the `smrt-playground-host` workspace package but is
8
+ documented here: instruction chains are additive, so a nested `AGENTS.md` under
9
+ `host/` would load on top of this package's own and is prohibited.
10
+
11
+ ## Layout
12
+
13
+ Paths are relative to `host/`.
14
+
15
+ - `src/routes/+page.svelte` — the single route; renders `PlaygroundHost` from the
16
+ parent package against every discovered `./playground` module
17
+ - `src/app.html` — SvelteKit document shell
18
+ - `svelte.config.js` — `adapter-static` with `strict: false`, because the
19
+ playground routes are discovered at build time rather than prerendered
20
+ - `vite.config.ts` — wires the parent package's playground vite plugin
21
+ - `e2e/shared-playground.spec.ts` — asserts the host boots and that no page or
22
+ console errors surface from any discovered playground entry
23
+
24
+ ## Validation
25
+
26
+ ```bash
27
+ pnpm --dir packages/smrt-playground/host build
28
+ pnpm --dir packages/smrt-playground/host test:e2e
29
+ ```
30
+
31
+ ## Gotchas
32
+
33
+ - **Private and unpublished**: `private: true` at version `0.0.0`. It carries no
34
+ `files` allowlist because it ships nothing; the knowledge checker exempts
35
+ private packages from packaging rules for this reason (#2143).
36
+ - **Declared as a literal workspace glob**: `pnpm-workspace.yaml` lists
37
+ `packages/smrt-playground/host` explicitly because it is nested one level
38
+ deeper than `packages/*`. Tooling that assumes a flat `packages/*` layout will
39
+ miss it — that assumption is what #2143 fixed in `smrt-dev-mcp`.
40
+ - **Nested members carry no canonical docs**: because it sits inside another
41
+ workspace package, the freshness checker exempts it from `missing-agents-md`
42
+ and `missing-claude-shim`, and reports `nested-agents-md` if one reappears.
43
+ - **Discovery is the contract under test**: the suite exercises the parent
44
+ package's discovery and runtime, so a failure here usually means a
45
+ `./playground` export in some other package regressed, not the host.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@happyvertical/smrt-playground",
3
- "version": "0.51.37",
3
+ "version": "0.51.39",
4
4
  "smrtJsdoc": "strict",
5
5
  "description": "Shared playground discovery, runtime, and host components for SMRT UI packages",
6
6
  "type": "module",
@@ -10,7 +10,8 @@
10
10
  "CLAUDE.md",
11
11
  "README.md",
12
12
  "dist",
13
- "AGENTS.md"
13
+ "AGENTS.md",
14
+ "agents"
14
15
  ],
15
16
  "exports": {
16
17
  ".": {
@@ -28,7 +29,7 @@
28
29
  }
29
30
  },
30
31
  "dependencies": {
31
- "@happyvertical/smrt-ui": "0.51.37",
32
+ "@happyvertical/smrt-ui": "0.51.39",
32
33
  "fast-glob": "3.3.3",
33
34
  "tsx": "^4.23.13"
34
35
  },