Skip to content

Commit ef8c684

Browse files
author
DavidQ
committed
Normalize sample class metadata to concrete engine refs (exclude Phase 20)
- cleaned non-Phase-20 `classValues` to remove non-concrete sample-style tokens - backfilled missing `engineClassesUsed` by scanning sample JS imports - aligned non-Phase-20 `classValues` with concrete `engineClassesUsed` - preserved Phase 20 metadata unchanged - result: Classes dropdown now resolves from concrete engine classes with clean labels
1 parent 7efa27e commit ef8c684

8 files changed

Lines changed: 1086 additions & 148 deletions

File tree

docs/dev/roadmaps/MASTER_ROADMAP_SAMPLES2TOOLS.md

Lines changed: 19 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,13 @@
1616
- `samples/metadata/samples.index.metadata.json` (sample catalog metadata)
1717
- `tools/toolRegistry.js` (active tool registry and ids)
1818

19+
## Kickoff Status (2026-04-23)
20+
- [.] Roadmap kickoff started
21+
- [.] Phase 1 vertical slice target selected: `Parallax Scene Studio`
22+
- [.] Batch 1 implementation start
23+
1924
## Canonical Data Contract
20-
- [ ] File naming standard: `samples/phase-xx/xxxx/sample-xxxx.json`
25+
- [.] File naming standard: `samples/phase-xx/xxxx/sample-xxxx.json`
2126
- [ ] Required fields:
2227
- `sampleId` (string)
2328
- `phase` (string)
@@ -31,7 +36,7 @@
3136
- `provenance` (path, createdAt, version)
3237

3338
## Launch Contract (Shared)
34-
- [ ] Standard query parameters for tool launch:
39+
- [.] Standard query parameters for tool launch:
3540
- `sampleId=<id>`
3641
- `samplePresetPath=/samples/phase-xx/xxxx/sample-xxxx.json`
3742
- [ ] Tool boot behavior:
@@ -50,13 +55,21 @@
5055

5156
## Rollout Plan
5257

58+
### Batch 1 - Active Work (Phase 1 Slice)
59+
- [.] Add `samples/phase-12/1208/sample-1208.json` as shared sample/tool preset source.
60+
- [.] Wire Sample 1208 page/tool link to pass:
61+
- `sampleId=1208`
62+
- `samplePresetPath=/samples/phase-12/1208/sample-1208.json`
63+
- [.] Wire `Parallax Scene Studio` launch path to load and hydrate from `samplePresetPath` when provided.
64+
- [ ] Validate end-to-end parity for the slice (sample load + tool preload + visible content match).
65+
5366
### Phase 1 - Foundation + One Vertical Slice
54-
- [ ] Add shared adapter guidance document for sample-to-tool loading.
55-
- [ ] Implement one full reference flow:
67+
- [.] Add shared adapter guidance document for sample-to-tool loading.
68+
- [.] Implement one full reference flow:
5669
- sample page loads `sample-xxxx.json`
5770
- same file is passed to tool launch
5871
- tool hydrates from same file
59-
- [ ] Suggested first slice: `Parallax Scene Studio` (clear, low candidate count).
72+
- [.] Suggested first slice: `Parallax Scene Studio` (clear, low candidate count).
6073
- [ ] Validate:
6174
- sample runs using file
6275
- tool opens from sample and loads matching content
@@ -125,4 +138,4 @@
125138
## Current Snapshot (from tools_used.txt)
126139
- [x] Current tagged samples across active tools: `0` (excluding Phase 20)
127140
- [x] Candidate coverage inventory exists for all active tools
128-
- [ ] Convert candidates into curated, validated sample-to-tool links
141+
- [.] Convert candidates into curated, validated sample-to-tool links

0 commit comments

Comments
 (0)