feat: add durable encryption migration journal

.github/copilot-instructions.md

@@ -167,7 +167,7 @@ On any non-trivial code change add a single-line comment explaining **why**, not
 ### Git & CI
 
 - Conventional Commits format: `feat:`, `fix:`, `docs:`, `refactor:`, `test:`, `chore:`
-- Pre-commit: `simple-git-hooks` runs Biome check on staged files
+- Pre-commit: after explicit `pnpm run hooks:install`, `simple-git-hooks` runs Biome on staged files; CI is mandatory regardless
 - **⚠️ Constrained local hardware — do NOT run heavy suites locally.** This machine has ~3–4 GB RAM. **Never** run the full Vitest **coverage** suite, **Playwright E2E**, **Stryker mutation**, **Lighthouse CI**, or the **Storybook test-runner** locally — they are **CI-only by design**. Run **one heavy command at a time** (no parallel `vitest`/`biome`/`tsc`/`vite`).
 - Local preflight (sequential, minimal): `pnpm run lint` → `pnpm run typecheck` → `pnpm run i18n:check` (only when locale JSON changed) → **targeted** `pnpm exec vitest run <path>` (no `--coverage`). Run `pnpm run build && pnpm run smoke:prod` only when you touched `vite.config.ts`, `packages/ai-core`, or `workers/`. Coverage, E2E, Lighthouse, Stryker, and Storybook are **CI gate jobs** — let GitHub Actions run them.
 - CI pipeline (see [`docs/CI.md`](../docs/CI.md)): **`security` → `quality`** (Biome + `tsc` + Vitest matrix) **→ `build` / `e2e` / `storybook` in parallel** → **`lighthouse`** after build → **`deploy`** on `main` after build+e2e

.npmrc

@@ -1,28 +1 @@
-# Peer dependencies
-# strict mode: install fails on unmet or conflicting peers (instead of just warning)
-# QNBS-v3: TS7 migration - disabled strict-peer-dependencies for tsgo preview compatibility
-strict-peer-dependencies=false
-# autoInstallPeers stays true to match lockfile settings.autoInstallPeers: true;
-# flipping it requires a full lockfile regen + React-19 peer-dep audit (deferred to pnpm v11 migration)
-auto-install-peers=true
-
-# Build scripts
-# allowBuilds in pnpm-workspace.yaml is the v10 guard — only core-js, esbuild, protobufjs
-# may run lifecycle scripts; ignore-scripts stays false so that list is enforced, not bypassed
-ignore-scripts=false
-
-# Runtime safety
-engine-strict=true            # fail install if Node version doesn't satisfy engines.node (>=22)
-prefer-frozen-lockfile=true   # pnpm install refuses to mutate the lockfile (CI-safe)
-verify-store-integrity=true   # checksum-verify packages from the content-addressable store
-
-# Performance / correctness (unchanged)
-side-effects-cache=true
-
-# Supply-chain hardening (QNBS-v3: P1)
-# strict-dep-builds: verify that all built dependencies match lockfile checksums
-strict-dep-builds=true
-# block-exotic-subdeps: reject packages with exotic subdependency patterns (security risk)
-block-exotic-subdeps=true
-# minimum-release-age: quarantine packages newer than 7 days (10080 minutes)
-minimum-release-age=10080
+# QNBS-v3: The pnpm v11 workspace policy is defined exclusively in pnpm-workspace.yaml.

AGENTS.md

@@ -139,7 +139,7 @@ WorldScript-Studio/
 - `vitest.config.ts` — coverage thresholds (lines 74, branches 60, functions 67, statements 72), `maxWorkers: 1`
 - `playwright.config.ts` — E2E projects: Chromium desktop + Pixel 5 mobile in CI; Firefox + optional mobile locally
 - `turbo.json` — task graph for `build`, `dev`, `lint`, `typecheck`, `test`, `mutation`
-- `pnpm-workspace.yaml` — workspace packages + `onlyBuiltDependencies` allowlist
+- `pnpm-workspace.yaml` — workspace packages + pnpm v11 `allowBuilds` default-deny map
 - `stryker.conf.json` — ~20 mutation targets (services + features), `break: 75`
 - `.lighthouserc.cjs` — accessibility `error` ≥ 0.95, CLS `error` ≤ 0.1, performance/SEO `warn`
 - `src-tauri/tauri.conf.json` / `Cargo.toml` — desktop window config, CSP, updater endpoints, rust-compute feature
@@ -258,7 +258,8 @@ On any non-trivial change, add a single-line comment explaining **why**, not wha
 ### Commit Messages
 
 Conventional Commits: `feat:`, `fix:`, `docs:`, `refactor:`, `test:`, `chore:`.
-Pre-commit hook runs `biome check --write` on staged files via `simple-git-hooks` + `lint-staged`.
+After an explicit `pnpm run hooks:install`, the pre-commit hook runs `biome check --write` on staged
+files via `simple-git-hooks` + `lint-staged`; CI remains mandatory when hooks are not installed.
 
 ---
 

AUDIT.md

@@ -113,7 +113,7 @@ the same root cause in one sprint is itself the finding: **the failure mode is n
 - **Rebrand residue:** ADR-0008 present-tense "StoryCraft is offline-first" → "WorldScript Studio". Remaining `storycraft*` hits are intentional historical records (CHANGELOG version entries, archived sprints) or technical identifiers that were genuine at their version — left intact.
 - **GitHub releases:** 6 historical release titles renamed StoryCraft → WorldScript (v1.3.0, v1.5.0, v1.7.0, v1.17.0, v1.20.0, v1.21.0); v1.23.0 release/tag verified correct (latest, full changelog, tag → `fbaa33c3`).
 - **GitHub Packages:** orphaned `storycraft-studio` GHCR container image to be deleted so only `worldscript-studio` remains (requires `delete:packages` token scope — pending maintainer auth refresh).
-- **Dependabot hardening:** added `cooldown: default-days: 7` to all three `.github/dependabot.yml` ecosystems so newly released versions age 7 days before a PR is opened — matched to the `.npmrc` `minimum-release-age=10080` (7-day) supply-chain quarantine already enforced at pnpm install-time, so a version is never PR'd before `pnpm install --frozen-lockfile` would accept it (`.github/dependabot.yml` is the source of truth for the cooldown value). Open queue handled per the CodeAnt Correction Loop: #150 candle-nn merged; #151 candle-core rebased + re-running; #152 dev-tooling fixed at root (dual `playwright-core` deduped to 1.61.0 via `pnpm-workspace.yaml` override); #154/#155 are blocked solely by the `minimum-release-age` quarantine (packages too fresh — working as designed) and clear once aged.
+- **Dependabot hardening:** added `cooldown: default-days: 7` to all three `.github/dependabot.yml` ecosystems so newly released versions age 7 days before a PR is opened — matched to the `pnpm-workspace.yaml` `minimumReleaseAge: 10080` (7-day) supply-chain quarantine enforced at pnpm install-time, so a version is never PR'd before `pnpm install --frozen-lockfile` would accept it (`.github/dependabot.yml` is the source of truth for the cooldown value). Open queue handled per the CodeAnt Correction Loop: #150 candle-nn merged; #151 candle-core rebased + re-running; #152 dev-tooling fixed at root (dual `playwright-core` deduped to 1.61.0 via `pnpm-workspace.yaml` override); #154/#155 are blocked solely by the `minimumReleaseAge` quarantine (packages too fresh — working as designed) and clear once aged.
 
 ## v1.23 i18n Interpolation Bug-Class Fix + Regression Guard (2026-06-14)
 
@@ -260,7 +260,7 @@ the same root cause in one sprint is itself the finding: **the failure mode is n
 | `package.json` | Added `@typescript/native-preview@beta` and `@typescript/typescript6` alias |
 | `tsconfig.tsgo.json` | New tsgo-specific config (excludes `vite/client` types) |
 | `.github/workflows/ci.yml` | Updated typecheck step to use tsgo |
-| `.npmrc` | Disabled `strict-peer-dependencies` for tsgo compatibility |
+| `pnpm-workspace.yaml` | Disabled `strictPeerDependencies` for tsgo compatibility |
 | `pnpm-workspace.yaml` | Added `strictPeerDependencies: false` |
 | `docs/TS7-MIGRATION.md` | Migration guide created |
 
@@ -1744,9 +1744,9 @@ WorldScript Studio was assessed as a strong, modern React/TypeScript application
 
 | Status | Item |
 |--------|------|
-| ✅ | Added `strict-dep-builds=true` to `.npmrc` |
-| ✅ | Added `block-exotic-subdeps=true` to `.npmrc` |
-| ✅ | Added `minimum-release-age=10080` (7 days) to `.npmrc` |
+| ✅ | Added `strictDepBuilds: true` to `pnpm-workspace.yaml` |
+| ✅ | Added `blockExoticSubdeps: true` to `pnpm-workspace.yaml` |
+| ✅ | Added `minimumReleaseAge: 10080` (7 days) to `pnpm-workspace.yaml` |
 | ✅ | Added security justification comments to `pnpm-workspace.yaml` overrides |
 
 ### OpenRouter Provider Hardening (P1)
@@ -1834,7 +1834,7 @@ several apply only to dev/test transitive deps and are never shipped to users.
 **Dependency hygiene status (2026-06-13):**
 - `pnpm audit --audit-level=high` → 0 vulnerabilities.
 - `pnpm audit --audit-level=moderate` → 0 vulnerabilities.
-- `.npmrc` hardening active: `strict-dep-builds=true`, `block-exotic-subdeps=true`, `minimum-release-age=10080`.
+- `pnpm-workspace.yaml` hardening active: `strictDepBuilds: true`, `blockExoticSubdeps: true`, `minimumReleaseAge: 10080`.
 - `pnpm outdated` (re-run 2026-06-13): only non-critical patch/minor drift — `@ai-sdk/google|openai|react`, `ai`, `@storybook/*` + `storybook` (10.4.2→10.4.4), `@types/node`, `docx`, `dompurify`, `lint-staged`, `turbo`, `yjs`, `zustand`, `wrangler`. No major versions. `@duckdb/duckdb-wasm` (1.32.0) and `@typescript/native-preview` are dev/pre-release tracks and intentionally pinned.
 
 **Plugin sandbox post-fix validation (2026-06-13):** The v1.22 plugin-isolation hardening

App.tsx

@@ -67,7 +67,6 @@ import { pluginRegistry } from './services/pluginRegistry';
 import { repairProjectI18nFields } from './services/projectI18nRepair';
 import { hasCompletedSpotlightTour, startSpotlightTour } from './services/spotlightTour';
 import {
-  clearIdbPassphrase,
   hasPassphraseSentinel,
   isIdbEncryptionReady,
 } from './services/storage/storageEncryptionService';
@@ -196,15 +195,6 @@ const App: FC<AppProps> = ({ isNewUser }) => {
   const isIdbUnlockOpen = useTransientUiStore((s) => s.isIdbUnlockOpen);
   const setIdbUnlockOpen = useTransientUiStore((s) => s.setIdbUnlockOpen);
 
-  // QNBS-v3: escape hatch — clears sentinel + disables flag so the app is accessible again
-  const handleForgotPassphrase = useCallback(async () => {
-    await clearIdbPassphrase();
-    dispatch(featureFlagsActions.setEnableIdbAtRestEncryption(false));
-    setIdbUnlockOpen(false);
-    // QNBS-v3: WCAG 4.1.3 — assertive announcement so screen reader users know the security state changed
-    announce(t('settings.privacy.encryptionDisabledStatus'), 'assertive');
-  }, [dispatch, setIdbUnlockOpen, announce, t]);
-
   // Collaboration Panel State
   const [isCollabPanelOpen, setIsCollabPanelOpen] = useState(false);
 
@@ -256,6 +246,14 @@ const App: FC<AppProps> = ({ isNewUser }) => {
     }
   }, [settings.appearancePreset]);
 
+  useEffect(() => {
+    // QNBS-v3: Decorative fixed layers are opt-out so long-form writers can keep a neutral canvas.
+    document.body.classList.toggle(
+      'writing-surface-plain',
+      settings.writingSurfaceStyle === 'plain',
+    );
+  }, [settings.writingSurfaceStyle]);
+
   useEffect(() => {
     document.body.classList.toggle(
       'accessibility-high-contrast',
@@ -809,10 +807,7 @@ const App: FC<AppProps> = ({ isNewUser }) => {
               )}
               {isIdbUnlockOpen && (
                 <ErrorBoundary onReset={() => setIdbUnlockOpen(false)}>
-                  <IdbUnlockModal
-                    onUnlocked={() => setIdbUnlockOpen(false)}
-                    onForgotPassphrase={() => void handleForgotPassphrase()}
-                  />
+                  <IdbUnlockModal onUnlocked={() => setIdbUnlockOpen(false)} />
                 </ErrorBoundary>
               )}
             </div>

CONTRIBUTING.md

@@ -84,8 +84,11 @@ pnpm run graphs:update        # update both Graphify + CodeGraph
 git clone https://github.com/qnbs/WorldScript-Studio.git
 cd WorldScript-Studio
 pnpm install
+pnpm run hooks:install  # configures the pre-commit lint-staged hook
 ```
 
+`hooks:install` is a separate, explicit step rather than an automatic `prepare` script: pnpm v11's `allowBuilds` policy denies `simple-git-hooks`' own install-time script by default (supply-chain hardening — see `pnpm-workspace.yaml`), so a `prepare` script that shelled out to it would silently do nothing anyway. Skipping this step means commits bypass the `lint-staged` pre-commit check.
+
 ### Environment
 
 The app uses **no build-time secrets**. The Gemini API key is entered via the Settings UI and stored encrypted in IndexedDB.  

README.md

@@ -12,7 +12,7 @@
   <img src="https://img.shields.io/badge/Version-v1.26.0-6366F1" alt="v1.26.0">
   <img src="https://img.shields.io/badge/Storage-IndexedDB_v8-F59E0B" alt="IndexedDB v8">
   <img src="https://img.shields.io/badge/PWA-v3.0-5BB974?logo=pwa" alt="PWA v3.0">
-  <img src="https://img.shields.io/badge/i18n-19_locales-2869_keys-0EA5E9" alt="i18n 19 locales — 2869 keys">
+  <img src="https://img.shields.io/badge/i18n-19_locales-2903_keys-0EA5E9" alt="i18n 19 locales — 2903 keys">
   <img src="https://img.shields.io/badge/Tests-6477%2B_%2F_532_files-22C55E" alt="6477+ tests / 532 files">
   <img src="https://img.shields.io/codecov/c/github/qnbs/WorldScript-Studio?logo=codecov&label=Coverage" alt="Codecov Coverage">
   <img src="https://img.shields.io/badge/License-MIT-22C55E" alt="License MIT">
@@ -307,20 +307,21 @@ Real-time P2P co-editing via **Yjs + collab-transport** (vendor fork of y-webrtc
 
 ### 🔒 IDB At-Rest Encryption _(B-1, v1.19.0)_
 
-All project data, snapshots, and settings stored in IndexedDB can be encrypted at rest via `services/storage/storageEncryptionService.ts`:
+The current primary project, settings, snapshot, image, Codex, RAG, and binder-asset IndexedDB paths can be encrypted at rest via `services/storage/storageEncryptionService.ts`. This is not yet a claim that every IndexedDB surface is covered:
 
 - **AES-256-GCM** with a PBKDF2-derived key (600 000 iterations, SHA-256, 32-byte random salt).
-- Gated behind `featureFlags.enableIdbAtRestEncryption` (on by default since v1.23; the passphrase unlock UX is complete — Settings → Privacy).
-- Same passphrase-entry unlock screen (`IdbUnlockModal`) on cold start, session-scoped in-memory key, on **both** the web build and the Tauri desktop build — Tauri's WebView uses the same IndexedDB-backed storage path, not an OS keychain. (No `tauri-plugin-stronghold` or equivalent OS-keychain integration ships today — see the API-key encryption note below for the desktop-specific mechanism that does exist.)
-- GDPR-compliant: encrypted blobs are unreadable without the passphrase, even from the browser profile directory.
+- Gated behind `featureFlags.enableIdbAtRestEncryption`. When a library is configured but locked, protected reads and writes fail closed rather than falling back to plaintext.
+- Disable and passphrase rotation are temporarily unavailable until a journaled, cross-store migration protocol can prove recovery after interruption.
+- **Web/PWA build only.** The unlock screen (`IdbUnlockModal`) and session-scoped in-memory key protect the IndexedDB-backed storage path used by the browser/PWA build. On the **Tauri desktop build**, primary project, settings, snapshot, image, Codex, RAG, and binder-asset data are written by the filesystem-backed store (`services/fs/*`), which is plaintext (LZ-string compressed, not encrypted) regardless of this setting — enabling it on desktop still shows the same unlock screen (the passphrase sentinel lives in the WebView's IndexedDB) but does not encrypt the actual manuscript files on disk. No `tauri-plugin-stronghold` or equivalent OS-keychain integration ships today — see the API-key encryption note below for the desktop-specific mechanism that does exist.
+- At-rest protection reduces disclosure from an extracted browser profile while the library is locked; it does not protect an unlocked renderer, a compromised device, or every persistence surface.
 
 ### 🔐 Encrypted Library Backup
 
 One-click encrypted export of your entire project library from **Settings → Data**:
 
 - Archives all projects as a **ZIP** containing `META.json` + `vault.bin`.
 - `vault.bin` is encrypted with **AES-256-GCM** — the decryption key is derived from your chosen passphrase using PBKDF2.
-- No plaintext project data ever leaves your device unencrypted.
+- The encrypted vault holds its project payload in `vault.bin`; users must still protect the downloaded archive and should not confuse it with ordinary plaintext JSON export.
 - Import on any device using the same passphrase to restore your full library.
 
 ### 🔑 Encryption — which mechanism protects what
@@ -396,7 +397,7 @@ Infrastructure-level features that keep the app fast and extensible as projects
 
 ### 🌐 Full Multi-Language Support
 
-Shipped UI locales with **2869 i18n keys** across all 19 languages — zero hardcoded user-facing strings:
+Shipped UI locales with **2903 i18n keys** across all 19 languages — zero hardcoded user-facing strings:
 
 - 🇩🇪 **German** (Deutsch)
 - 🇬🇧 **English**
@@ -505,7 +506,7 @@ The Settings → AI panel shows a live GPU status badge with adapter details and
 | **PDF Export**       | jsPDF                                                     | Client-side, configurable PDF document generation                    |
 | **Document Export**  | docx + jszip                                              | Word-compatible `.docx` generation (lazy-loaded)                     |
 | **PWA**              | Service Worker + Web App Manifest v3                     | Offline support, installability, Workbox chunking                    |
-| **i18n**             | Custom React Context (`I18nContext.tsx`)                  | 2869 keys × 19 locales (de/en/es/fr/it + ar/he/fa RTL Beta + ja/zh/pt/el/fi/sv/hu/is/eu/ru/ko Beta); EN fallback; `localStorage` persistence |
+| **i18n**             | Custom React Context (`I18nContext.tsx`)                  | 2903 keys × 19 locales (de/en/es/fr/it + ar/he/fa RTL Beta + ja/zh/pt/el/fi/sv/hu/is/eu/ru/ko Beta); EN fallback; `localStorage` persistence |
 | **Testing**          | Vitest 4.x (6477+ tests / 532 files) + Playwright E2E     | Unit/integration + cross-browser E2E; Stryker mutation (manual workflow)          |
 | **Code Quality**     | Biome (lint + format) + TypeScript 7 (tsgo) strict       | `--error-on-warnings` in CI; zero `any` policy                      |
 | **Visualization**    | Force-directed graph                                      | Interactive character relationship network                           |
@@ -707,7 +708,7 @@ The main pipeline is [`.github/workflows/ci.yml`](.github/workflows/ci.yml). Opt
 **Current test metrics (2026-07-30, CI-reported):**
 - **6477+ unit tests** across **532 test files** — all passing
 - Coverage thresholds: lines ≥ 74 · branches ≥ 60 · functions ≥ 67 · statements ≥ 72 — enforced in CI (see Codecov badge for live metrics)
-- i18n: **2869 keys × 19 locales** (en/de/fr/es/it + ar/he/fa RTL Beta + ja/zh/pt/el/fi/sv/hu/is/eu Beta)
+- i18n: **2903 keys × 19 locales** (en/de/fr/es/it + ar/he/fa RTL Beta + ja/zh/pt/el/fi/sv/hu/is/eu Beta)
 
 **CI-cloud-first workflow (recommended):** On constrained hardware run **`pnpm run lint && pnpm run i18n:check && pnpm run typecheck`** locally, then push and let CI handle coverage, E2E, Lighthouse, and Stryker. Authoritative numbers come from CI artifacts (Codecov, JUnit). After CI goes green, update the README badges and `AUDIT.md` quality-gate line from the reported metrics. See **[`docs/CI.md`](docs/CI.md) § Cloud CI-first vs local development** for the full post-merge doc-update checklist.