Merge pull request #22 from pie-framework/develop

merge dev

Author: chillenious

.github/workflows/ci.yml

@@ -26,7 +26,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.5
+          bun-version: 1.3.6
 
       - name: Cache Bun downloads
         uses: actions/cache@v4
@@ -59,7 +59,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.5
+          bun-version: 1.3.6
 
       - name: Check translation coverage
         run: |
@@ -77,7 +77,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.5
+          bun-version: 1.3.6
 
       - name: Scan for hardcoded strings
         run: |
@@ -99,7 +99,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.5
+          bun-version: 1.3.6
 
       - name: Cache Bun downloads
         uses: actions/cache@v4
@@ -131,7 +131,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.5
+          bun-version: 1.3.6
 
       - name: Cache Bun downloads
         uses: actions/cache@v4

.github/workflows/deploy-pages.yml

@@ -32,7 +32,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.5
+          bun-version: 1.3.6
 
       - name: Cache Bun downloads
         uses: actions/cache@v4

.github/workflows/release.yml

@@ -53,7 +53,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.5
+          bun-version: 1.3.6
 
       - name: Cache Bun downloads
         uses: actions/cache@v4

README.md

@@ -129,7 +129,7 @@ Interactive web UI for transformations:
 - **Transform** — Batch convert with progress reporting
 - **Preview** — Side-by-side QTI and PIE rendering
 
-The app uses sessionized local filesystem storage by default, but the architecture supports custom backend adapters.
+Storage is pluggable with filesystem (default), S3, or database backends via configuration.
 
 ### CLI (`@pie-qti/transform-cli`)
 
@@ -198,6 +198,8 @@ bun run preview:pages
 ### Transforms
 
 - **[Transformation Guide](docs/PIE-QTI-TRANSFORMATION-GUIDE.md)** — Bidirectional transform overview
+- **[Configuration Guide](docs/CONFIGURATION.md)** — Storage backends, plugins, and environment setup
+- **[Migration Guide](docs/MIGRATION_GUIDE.md)** — Upgrading from legacy storage to new architecture
 - **[Transform App](packages/transform-app/README.md)** — Web UI for transformations
 - **[CLI](tools/cli/README.md)** — Command-line batch operations
 - **[QTI → PIE](packages/qti2-to-pie/README.md)** — QTI to PIE transformer

STATUS.md

@@ -1,6 +1,6 @@
 # PIE QTI 2.2 Implementation Status
 
-**Last Updated**: 2026-01-07
+**Last Updated**: 2026-01-12
 
 ---
 
@@ -37,6 +37,11 @@ The transformation framework and tooling are functional but under active develop
 
 - ✅ **Default-components evals**: YAML specs in `docs/evals/qti2-default-components/*/evals.yaml` executed by Playwright runner in `packages/qti2-example/tests/playwright/qti2-default-components-evals.pw.ts` (currently **49** cases)
 - ✅ **Assessment-player evals**: YAML specs in `docs/evals/qti2-assessment-player/*/evals.yaml` (currently **15** cases)
+- ✅ **i18n evals**: YAML specs in `docs/evals/qti2-i18n/*/evals.yaml` testing internationalization across 8 locales (currently **14** cases)
+- ✅ **Settings UI evals**: YAML specs in `docs/evals/qti2-settings-ui/*/evals.yaml` testing theme and locale switching UI (currently **7** cases)
+- ✅ **Asset loading evals**: YAML specs in `docs/evals/qti2-asset-loading/*/evals.yaml` testing URL resolution and asset loading (currently **3** cases)
+- ✅ **Web components evals**: YAML specs in `docs/evals/qti2-web-components/*/evals.yaml` testing configuration passing (currently **4** cases)
+- ✅ **Total eval cases**: **92** (up from 64)
 - ✅ **Unit tests**: additional coverage exists across packages (see package READMEs and workflows for the authoritative commands)
 
 ---

bun.lock

@@ -34,9 +34,10 @@ Everything lives under `packages/`:
 
 ### Transform system
 
-- `packages/types`: shared transformation type contracts (input/output formats)
+- `packages/types`: shared transformation type contracts (input/output formats, storage interfaces)
 - `packages/schemas`: PIE schema/validation assets
 - `packages/core`: transform engine + plugin registry (format orchestration)
+- `packages/storage`: pluggable storage backends (filesystem, S3, database)
 - `packages/qti2-to-pie`: QTI → PIE transform plugin (plus vendor extension hooks)
 - `packages/pie-to-qti2`: PIE → QTI transform plugin (generator registry + packaging)
 
@@ -432,11 +433,37 @@ Key reference:
 
 The transform app is a SvelteKit web UI that wires together:
 
-- upload and extraction (sessionized filesystem storage),
+- upload and extraction (pluggable storage backend with session management),
 - analysis (discover items/tests, count interactions, record issues),
 - transformation (batch convert to PIE),
 - preview (QTI player preview and PIE player preview side-by-side).
 
+### Storage architecture
+
+The transform app uses a **pluggable storage system** (`@pie-qti/storage`) that abstracts storage backends:
+
+- **Default**: Filesystem backend (stores sessions in `./uploads/sessions/`)
+- **Optional**: S3, database, or custom backends via configuration
+
+Sessions are stored with separate metadata files:
+
+- `metadata.json` - Core session state (id, status, timestamps)
+- `analysis.json` - Analysis results (packages, items, interactions)
+- `transformation.json` - Transform results (items, assessments, errors)
+
+This separation enables:
+
+- Independent loading of analysis/transformation data
+- Efficient storage backends (only fetch what's needed)
+- Clear data ownership and versioning
+
+Key references:
+
+- Storage types: `packages/types/src/storage/index.ts`
+- Storage package: `packages/storage/src/`
+- App storage wrapper: `packages/transform-app/src/lib/server/storage/app-session-storage.ts`
+- Configuration: `docs/CONFIGURATION.md`
+
 ### Server-side flow (sessioned)
 
 1) **Upload**: `POST /api/upload` stores ZIP(s) in a new session