[fix.lab.sigma.D8+] make FEP review an exact recoverable scientific workflow

Pose, campaign, network, and RunSet decisions previously survived identity edits,
lost durable receipts, or depended on ambiguous visual state. The standalone FEP
workspace now binds every transition to content-addressed scientific provenance,
fails closed on unresolved chemistry and receptor policy, restores interrupted
operations exactly once, and remains operable by keyboard and at high zoom.

The production build adds only the standalone FEP entry; it does not absorb the
concurrent AppShell redesign or the unrelated time-tunnel demos.

Author: ivanicu

scripts/build.mjs

@@ -30,7 +30,7 @@ const Apps = [
     { kind: 'app', name: 'viewer', themes: ['light', 'dark', 'blue'], entryRoot: './src/apps.reference.viewer-demos.vendored-readonly/viewer' },
     { kind: 'app', name: 'docking-viewer', entryRoot: './src/apps.reference.viewer-demos.vendored-readonly/docking-viewer' },
     { kind: 'app', name: 'mesoscale-explorer', entryRoot: './src/apps.reference.viewer-demos.vendored-readonly/mesoscale-explorer' },
-    { kind: 'app', name: 'dirac', filename: 'dirac.js', entryRoot: './src/app.frontend.facets.molstar-rdkit.editable', staticDirs: ['assets/rdkit', 'fonts'], staticFiles: ['fonts.css','fascia-tokens.css','theme-fascia.css','theme-fascia.js','workspace-shell.css','voice-composer.css','addons.css','palette.js', ['../../node_modules/frappe-gantt/dist/frappe-gantt.css', 'frappe-gantt.css']], auxiliaryEntries: [{ entry: 'voice-composer-demo.ts', outfile: 'voice-composer-demo/voice-composer-demo.js', staticFiles: [['voice-composer-demo.html', 'voice-composer-demo/index.html'], ['voice-composer.css', 'voice-composer-demo/voice-composer.css']] }] },
+    { kind: 'app', name: 'dirac', filename: 'dirac.js', entryRoot: './src/app.frontend.facets.molstar-rdkit.editable', staticDirs: ['assets/rdkit', 'fonts'], staticFiles: ['fonts.css','fascia-tokens.css','theme-fascia.css','theme-fascia.js','workspace-shell.css','voice-composer.css','addons.css','palette.js', ['../../node_modules/frappe-gantt/dist/frappe-gantt.css', 'frappe-gantt.css']], auxiliaryEntries: [{ entry: 'voice-composer-demo.ts', outfile: 'voice-composer-demo/voice-composer-demo.js', staticFiles: [['voice-composer-demo.html', 'voice-composer-demo/index.html'], ['voice-composer.css', 'voice-composer-demo/voice-composer.css']] }, { entry: 'fep-workbench/fep-workbench.ts', outfile: 'time-tunnel/fep-workbench.js', staticFiles: [['fep-workbench/fep-workbench.html', 'time-tunnel/fep-workbench.html'], ['fep-workbench/fep-workbench.css', 'time-tunnel/fep-workbench.css']] }] },
     { kind: 'app', name: 'mvs-stories', globalName: 'mvsStories', filename: 'mvs-stories.js', entryRoot: './src/apps.reference.viewer-demos.vendored-readonly/mvs-stories' },
 
     // Examples

src/app.frontend.facets.molstar-rdkit.editable/fep-workbench/fep-workbench.css

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <base href="/">
+  <title>DIRAC · FEP Lab</title>
+  <link rel="stylesheet" href="time-tunnel/fep-workbench.css">
+</head>
+<body>
+  <div id="fep-lab"></div>
+  <script src="time-tunnel/fep-workbench.js"></script>
+</body>
+</html>

src/app.frontend.facets.molstar-rdkit.editable/fep-workbench/fep-workbench.html

@@ -0,0 +1,45 @@
+import { describe, expect, it } from '@jest/globals';
+import { readFileSync, readdirSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+const facadePath = resolve(__dirname, 'fep-workbench.ts');
+const facade = readFileSync(facadePath, 'utf8');
+const sources = readdirSync(__dirname)
+    .filter(name => name.endsWith('.ts') && !name.endsWith('.spec.ts'))
+    .map(name => ({ name, source: readFileSync(resolve(__dirname, name), 'utf8') }));
+
+const owners: Readonly<Record<string, string>> = {
+    decideWorkbenchBoot: 'workbench-boot.ts',
+    setSafeText: 'workbench-dom.ts',
+    escapeHtml: 'workbench-dom.ts',
+    safeElement: 'workbench-dom.ts',
+    preparationReceiptFrom: 'workbench-receipts.ts',
+    preparationRequestKey: 'workbench-receipts.ts',
+    runReceiptFromData: 'workbench-receipts.ts',
+    operationBindingFromReceipt: 'workbench-receipts.ts',
+    preparationPolicyGate: 'workbench-view-model.ts',
+    runAggregateViewFrom: 'workbench-view-model.ts',
+    aggregatePanelViewFrom: 'workbench-view-model.ts',
+    runHistoryViewFrom: 'workbench-view-model.ts',
+    submitPreparationExactlyOnce: 'workbench-preparation.ts',
+    preparationResultMatchesOpenCampaign: 'workbench-preparation.ts',
+};
+
+describe('FEP controller architecture ratchets', () => {
+    it('keeps the facade below the accepted monolith ceiling', () => {
+        expect(statSync(facadePath).size).toBeLessThan(200_000);
+        expect(facade.split(/\r?\n/).length).toBeLessThanOrEqual(1_200);
+    });
+
+    it.each(Object.entries(owners))('%s has one module owner and no facade definition', (symbol, owner) => {
+        const definition = new RegExp(`(?:export\\s+)?function\\s+${symbol}\\b`);
+        expect(sources.filter(file => definition.test(file.source)).map(file => file.name)).toEqual([owner]);
+        expect(definition.test(facade)).toBe(false);
+    });
+
+    it('keeps receipt parsing and obsolete mock routes out of the facade', () => {
+        expect(facade).not.toMatch(/JSON\.parse[^\n]*(?:pending_prepare|pending_planner|active_run)/);
+        expect(facade).not.toContain('/time-tunnel/#/free-energy');
+        expect(facade).not.toContain('/time-tunnel/field-workbench.html');
+    });
+});

src/app.frontend.facets.molstar-rdkit.editable/fep-workbench/fep-workbench.ts

@@ -0,0 +1,17 @@
+import { describe, expect, it } from '@jest/globals';
+import { decideWorkbenchBoot } from './workbench-boot';
+
+describe('serialized FEP workbench boot reducer',()=>{
+    const decide=(overrides:Partial<Parameters<typeof decideWorkbenchBoot>[0]>)=>decideWorkbenchBoot({hasRunReceipt:false,hasLegacyRunId:false,hasPlannerReceipt:false,hasPreparationReceipt:false,blankRequested:false,...overrides});
+    it.each([
+        [{hasRunReceipt:true},'reconcile-run'],
+        [{hasLegacyRunId:true},'reconcile-run'],
+        [{hasRunReceipt:true,blankRequested:true},'reconcile-run'],
+        [{blankRequested:true,hasPlannerReceipt:true,hasPreparationReceipt:true},'new-campaign'],
+        [{hasPlannerReceipt:true,hasPreparationReceipt:true},'resume-planner'],
+        [{hasPreparationReceipt:true},'resume-preparation'],
+        [{},'load-network'],
+    ] as const)('chooses one authoritative lane for %j', (input, expected) => {
+        expect(decide(input)).toBe(expected);
+    });
+});

src/app.frontend.facets.molstar-rdkit.editable/fep-workbench/molecule-sketcher.ts

@@ -0,0 +1,23 @@
+export type WorkbenchBootAction = 'reconcile-run' | 'new-campaign'
+    | 'resume-planner' | 'resume-preparation' | 'load-network';
+
+export type WorkbenchBootState = Readonly<{
+    hasRunReceipt: boolean;
+    hasLegacyRunId: boolean;
+    hasPlannerReceipt: boolean;
+    hasPreparationReceipt: boolean;
+    blankRequested: boolean;
+}>;
+
+/**
+ * Reduce all durable startup evidence to one authoritative recovery lane.
+ * Keeping this decision pure prevents boot from racing independent restore
+ * promises whose completion order would otherwise become application state.
+ */
+export function decideWorkbenchBoot(input: WorkbenchBootState): WorkbenchBootAction {
+    if (input.hasRunReceipt || input.hasLegacyRunId) return 'reconcile-run';
+    if (input.blankRequested) return 'new-campaign';
+    if (input.hasPlannerReceipt) return 'resume-planner';
+    if (input.hasPreparationReceipt) return 'resume-preparation';
+    return 'load-network';
+}