@ibgib/space-gib 0.0.2 → 0.0.4

package/src/client/dev-tools.mts

@@ -1,1103 +1,32 @@
 /**
  * @module client/dev-tools
  *
- * Wires up the Dev Tools panel button handlers for manual testing during
- * development. Import this from index.mts inside the DOMContentLoaded handler.
- *
- * ## intent
- *
- * Remove or gate this module once the real sync WebSocket endpoint is confirmed
- * working end-to-end.
+ * Facade entry point for Dev Tools panel button handlers.
+ * Imports and wires up all modular sub-file handlers under dev-tools/.
  */
 
-import { extractErrorMsg, getTimestamp, getUUID, } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-import { Factory_V1 as factory } from '@ibgib/ts-gib/dist/V1/factory.mjs';
-import { ROOT } from '@ibgib/ts-gib/dist/V1/constants.mjs';
-import { getIbGibAddr, } from '@ibgib/ts-gib/dist/helper.mjs';
-import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
-import { KeystoneService_V1 } from '@ibgib/core-gib/dist/keystone/keystone-service-v1.mjs';
-import { KeystoneIbGib_V1, KeystoneReplenishStrategy } from '@ibgib/core-gib/dist/keystone/keystone-types.mjs';
-import { createManagePoolConfig } from '@ibgib/core-gib/dist/keystone/keystone-config-builder.mjs';
-import { KeystoneStrategyFactory } from '@ibgib/core-gib/dist/keystone/strategy/keystone-strategy-factory.mjs';
-import { SyncPeerWebSocketSender_V1 } from '@ibgib/core-gib/dist/sync/sync-peer/sync-peer-websocket-sender/sync-peer-websocket-sender-v1.mjs';
-import { SyncSagaCoordinator } from '@ibgib/core-gib/dist/sync/sync-saga-coordinator.mjs';
-import { KEYSTONE_VERB_CONNECT, POOL_ID_CONNECT, POOL_ID_SYNC } from '@ibgib/core-gib/dist/keystone/keystone-constants.mjs';
-import { getGlobalMetaspace_waitIfNeeded } from "@ibgib/web-gib/dist/helpers.mjs";
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
 
-import { GLOBAL_LOG_A_LOT } from './constants.mjs';
+import { devLog, debugState, lc } from './dev-tools/common.mjs';
 import {
-    SESSION_KEYSTONE_POLICY, getConnectChallenge, getSpaceGibPoolConfig
-} from "../common/keystone-policies.mjs";
-import { SpaceGibApiBridge } from './api/space-gib-api-bridge.mjs';
-
-const logalot = GLOBAL_LOG_A_LOT
-const lc = '[dev-tools]';
-
-interface DebugState {
-    domainI?: KeystoneIbGib_V1;
-    domainIMasterSecret?: string;
-    targetX?: IbGib_V1;
-    sessionS?: KeystoneIbGib_V1;
-    sessionSecret?: string;
-    senderPeer?: SyncPeerWebSocketSender_V1;
-    sagaId?: string;
-}
-
-export const debugState: DebugState = {};
-(window as any).ibgibDebugState = debugState;
-
-// ---------------------------------------------------------------------------
-// Dev panel log helper
-// ---------------------------------------------------------------------------
-
-export function devLog(msg: string): void {
-    const logEl = document.getElementById('dev-panel-log') as HTMLPreElement | null;
-    if (!logEl) { return; }
-    const timestamp = new Date().toISOString().slice(11, 23); // HH:MM:SS.mmm
-    logEl.textContent = `[${timestamp}] ${msg}\n` + logEl.textContent;
-}
-
-// ---------------------------------------------------------------------------
-// Test WebSocket button
-// ---------------------------------------------------------------------------
-
-let _ws: WebSocket | null = null;
-
-function initWsTestButton(): void {
-    const lc_fn = `${lc}[initWsTestButton]`;
-    const btn = document.getElementById('btn-test-ws') as HTMLButtonElement | null;
-    if (!btn) {
-        console.warn(`${lc_fn} btn-test-ws not found — skipping`);
-        return;
-    }
-
-    btn.addEventListener('click', () => {
-        try {
-            if (_ws && _ws.readyState === WebSocket.OPEN) {
-                // Already connected — send a test ping instead
-                _ws.send(JSON.stringify({ ping: 'hello from client', ts: Date.now() }));
-                devLog('→ sent ping on existing connection');
-                return;
-            }
-
-            // Build the WebSocket URL from the current origin (wss:// if https://)
-            const protocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
-            const wsUrl = `${protocol}//${location.host}/api/debug/ws-echo`;
-            devLog(`→ connecting to ${wsUrl}`);
-
-            _ws = new WebSocket(wsUrl);
-
-            _ws.addEventListener('open', () => {
-                devLog('✓ WebSocket connected');
-                btn.textContent = 'Send WS Ping';
-            });
-
-            _ws.addEventListener('message', (ev) => {
-                devLog(`← ${ev.data}`);
-            });
-
-            _ws.addEventListener('close', (ev) => {
-                devLog(`✗ WebSocket closed (code ${ev.code})`);
-                btn.textContent = 'Test WebSocket';
-                _ws = null;
-            });
-
-            _ws.addEventListener('error', (ev) => {
-                devLog(`✗ WebSocket error — check console`);
-                console.error(`${lc_fn} WebSocket error`, ev);
-            });
-
-        } catch (error) {
-            devLog(`✗ ${extractErrorMsg(error)}`);
-            console.error(`${lc_fn} ${extractErrorMsg(error)}`);
-        }
-    });
-}
-
-// ---------------------------------------------------------------------------
-// Print Dev State button
-// ---------------------------------------------------------------------------
-
-function initPrintStateButton(): void {
-    const btn = document.getElementById('btn-print-dev-state') as HTMLButtonElement | null;
-    if (!btn) return;
-    btn.addEventListener('click', () => {
-        devLog(`Printing debug state to console...`);
-        console.dir(debugState);
-    });
-}
-
-// ---------------------------------------------------------------------------
-// Create Domain Keystone (I) button
-// ---------------------------------------------------------------------------
-
-function initCreateDomainKeystoneButton(): void {
-    const lc_fn = `${lc}[initCreateDomainKeystoneButton]`;
-    const btn = document.getElementById('btn-create-domain-keystone') as HTMLButtonElement | null;
-    if (!btn) return;
-
-    btn.addEventListener('click', async () => {
-        try {
-            btn.disabled = true;
-            devLog('Generating dummy Domain Keystone (I)...');
-
-            const metaspace = await getGlobalMetaspace_waitIfNeeded();
-            const space = await metaspace.getLocalUserSpace({});
-            if (!space) { throw new Error("No default space found in metaspace."); }
-
-            const masterSecret = 'password'; // Hardcoded for debug as requested
-            const keystoneService = new KeystoneService_V1();
-
-            const domainI = await keystoneService.genesis({
-                masterSecret,
-                configs: [
-                    createManagePoolConfig({
-                        id: 'default',
-                        salt: await getUUID(),
-                        replenishStrategy: KeystoneReplenishStrategy.topUp,
-                    }),
-                ],
-                metaspace,
-                space,
-                frameDetails: { client: 'space-gib-web-dev', timestamp: getTimestamp() }
-            });
-
-            const iAddr = getIbGibAddr({ ibGib: domainI });
-            devLog(`✓ Local genesis complete: ${iAddr}`);
-
-            debugState.domainI = domainI;
-            debugState.domainIMasterSecret = masterSecret;
-
-            // Post to server
-            devLog(`Posting genesis keystone to server...`);
-            const apiBridge = new SpaceGibApiBridge();
-            const resSync = await apiBridge.postGenesisKeystone(domainI);
-            if (!resSync.success) {
-                devLog(`✗ Server rejected genesis keystone: ${resSync.message}`);
-                btn.disabled = false;
-                return;
-            }
-
-            devLog(`✓ Server accepted Domain Keystone (I)`);
-            btn.textContent = '✓ Domain Keystone Created';
-
-            // Enable next step
-            const nextBtn = document.getElementById('btn-create-test-ibgib') as HTMLButtonElement;
-            if (nextBtn) nextBtn.disabled = false;
-
-        } catch (error) {
-            devLog(`✗ ${extractErrorMsg(error)}`);
-            console.error(`${lc_fn} ${extractErrorMsg(error)}`);
-            btn.disabled = false;
-        }
-    });
-}
-
-// ---------------------------------------------------------------------------
-// Create Test IbGib button
-// ---------------------------------------------------------------------------
-
-function initCreateTestIbGibButton(): void {
-    const lc_fn = `${lc}[initCreateTestIbGibButton]`;
-    const btn = document.getElementById('btn-create-test-ibgib') as HTMLButtonElement | null;
-    if (!btn) {
-        console.warn(`${lc_fn} btn-create-test-ibgib not found — skipping`);
-        return;
-    }
-
-    btn.addEventListener('click', async () => {
-        try {
-            devLog('Generating dummy X^Xtjp ibgib...');
-            const resX = await factory.firstGen({
-                parentIbGib: ROOT,
-                ib: 'test data',
-                data: { hello: 'world', random: Math.random() },
-                dna: true,
-                nCounter: true,
-                tjp: { uuid: true, timestamp: true }
-            });
-            const xIbGib = resX.newIbGib;
-            const xAddr = getIbGibAddr({ ibGib: xIbGib });
-
-            debugState.targetX = xIbGib;
-            devLog(`✓ Created X: ${xAddr}`);
-            btn.textContent = '✓ Test IbGib (X) Created';
-
-            // Enable next step
-            const nextBtn = document.getElementById('btn-create-session-keystone') as HTMLButtonElement;
-            if (nextBtn) nextBtn.disabled = false;
-        } catch (error) {
-            devLog(`✗ ${extractErrorMsg(error)}`);
-            console.error(`${lc_fn} ${extractErrorMsg(error)}`);
-        }
-    });
-}
-
-// ---------------------------------------------------------------------------
-// Create Session Keystone (S^Stjp) button
-// ---------------------------------------------------------------------------
-
-function initCreateSessionKeystoneButton(): void {
-    const lc_fn = `${lc}[initCreateSessionKeystoneButton]`;
-    const btn = document.getElementById('btn-create-session-keystone') as HTMLButtonElement | null;
-    if (!btn) {
-        console.warn(`${lc_fn} btn-create-session-keystone not found — skipping`);
-        return;
-    }
-
-    btn.addEventListener('click', async () => {
-        try {
-            devLog('Generating Session Keystone (S^Stjp)...');
-
-            const domainI = debugState.domainI;
-            const targetX = debugState.targetX;
-
-            if (!domainI) { devLog('⚠ No domain keystone (I) found in state. Please Create Domain Keystone first.'); return; }
-            if (!targetX) { devLog('⚠ No target ibgib (X) found in state. Please Create Test IbGib first.'); return; }
-
-            const metaspace = await getGlobalMetaspace_waitIfNeeded();
-            const space = await metaspace.getLocalUserSpace({});
-            if (!space) { throw new Error("No default space found in metaspace."); }
-
-            const sessionSecret = 'ephemeral-' + Math.random().toString();
-            const keystoneService = new KeystoneService_V1();
-
-            console.warn(`${lc}[NAG] placeholder genesis keystone config right now (W: 69b108687cf8bec0f9a8e148bcca8d26)`);
-            const sIbGib = await keystoneService.genesis({
-                masterSecret: sessionSecret,
-                configs: [
-                    {
-                        id: SESSION_KEYSTONE_POLICY.DEFAULT_POOL.ID,
-                        salt: await getUUID(),
-                        type: SESSION_KEYSTONE_POLICY.COMMON.TYPE,
-                        algo: SESSION_KEYSTONE_POLICY.COMMON.ALGO,
-                        rounds: SESSION_KEYSTONE_POLICY.COMMON.ROUNDS,
-                        behavior: {
-                            size: SESSION_KEYSTONE_POLICY.DEFAULT_POOL.SIZE,
-                            replenish: SESSION_KEYSTONE_POLICY.COMMON.REPLENISH,
-                            selectSequentially: SESSION_KEYSTONE_POLICY.DEFAULT_POOL.SELECT_SEQUENTIALLY,
-                            selectRandomly: SESSION_KEYSTONE_POLICY.DEFAULT_POOL.SELECT_RANDOMLY,
-                            targetBindingChars: SESSION_KEYSTONE_POLICY.DEFAULT_POOL.TARGET_BINDING_CHARS,
-                        },
-                        allowedVerbs: [],
-                    },
-                    {
-                        id: SESSION_KEYSTONE_POLICY.CONNECT_POOL.ID,
-                        salt: await getUUID(),
-                        type: SESSION_KEYSTONE_POLICY.COMMON.TYPE,
-                        algo: SESSION_KEYSTONE_POLICY.COMMON.ALGO,
-                        rounds: SESSION_KEYSTONE_POLICY.COMMON.ROUNDS,
-                        behavior: {
-                            size: SESSION_KEYSTONE_POLICY.CONNECT_POOL.SIZE,
-                            replenish: SESSION_KEYSTONE_POLICY.COMMON.REPLENISH,
-                            selectSequentially: SESSION_KEYSTONE_POLICY.CONNECT_POOL.SELECT_SEQUENTIALLY,
-                            selectRandomly: SESSION_KEYSTONE_POLICY.CONNECT_POOL.SELECT_RANDOMLY,
-                            targetBindingChars: SESSION_KEYSTONE_POLICY.CONNECT_POOL.TARGET_BINDING_CHARS,
-                        },
-                        allowedVerbs: [SESSION_KEYSTONE_POLICY.CONNECT_POOL.VERB],
-                    }
-                ],
-                metaspace,
-                space,
-                frameDetails: {
-                    client: 'space-gib-web-session',
-                    target_I: domainI ? getIbGibAddr({ ibGib: domainI }) : undefined,
-                    target_X: targetX ? getIbGibAddr({ ibGib: targetX }) : undefined,
-                }
-            });
-
-            const sAddr = getIbGibAddr({ ibGib: sIbGib });
-            debugState.sessionS = sIbGib;
-            debugState.sessionSecret = sessionSecret;
-
-            devLog(`✓ Created Session Keystone: ${sAddr}`);
-            btn.textContent = '✓ Session Keystone Created';
-
-            // Enable next step
-            const nextBtn = document.getElementById('btn-evolve-domain-keystone') as HTMLButtonElement;
-            if (nextBtn) nextBtn.disabled = false;
-        } catch (error) {
-            devLog(`✗ ${extractErrorMsg(error)}`);
-            console.error(`${lc_fn} ${extractErrorMsg(error)}`);
-        }
-    });
-}
-
-// ---------------------------------------------------------------------------
-// Evolve Domain Keystone (I^I1) button
-// ---------------------------------------------------------------------------
-
-function initEvolveDomainKeystoneButton(): void {
-    const lc_fn = `${lc}[initEvolveDomainKeystoneButton]`;
-    const btn = document.getElementById('btn-evolve-domain-keystone') as HTMLButtonElement | null;
-    if (!btn) {
-        console.warn(`${lc_fn} btn-evolve-domain-keystone not found — skipping`);
-        return;
-    }
-
-    btn.addEventListener('click', async () => {
-        try {
-            btn.disabled = true;
-            devLog('Evolving Domain Keystone (I^I1) with sync claim...');
-
-            const domainI = debugState.domainI;
-            const masterSecret = debugState.domainIMasterSecret;
-            const sessionS = debugState.sessionS;
-
-            if (!domainI || !masterSecret) { devLog('⚠ No domain keystone (I) found. Please Create Domain Keystone first.'); return; }
-            if (!sessionS) { devLog('⚠ No session keystone (S) found. Please Create Session Keystone first.'); return; }
-
-            const metaspace = await getGlobalMetaspace_waitIfNeeded();
-            const space = await metaspace.getLocalUserSpace({});
-            if (!space) { throw new Error("No default space found in metaspace."); }
-
-            const keystoneService = new KeystoneService_V1();
-            const sAddr = getIbGibAddr({ ibGib: sessionS });
-
-            devLog('Solving challenges to authorize sync...');
-            const evolvedI = await keystoneService.sign({
-                latestKeystone: domainI,
-                masterSecret,
-                claim: {
-                    target: sAddr,
-                    verb: 'sync'
-                },
-                metaspace,
-                space
-            });
-
-            const evolvedAddr = getIbGibAddr({ ibGib: evolvedI });
-            devLog(`✓ Local evolution complete: ${evolvedAddr}`);
-
-            // Update state with new tip
-            debugState.domainI = evolvedI;
-
-            devLog('Posting evolution to server...');
-            const apiBridge = new SpaceGibApiBridge();
-            // We pass the domain address (from the original TJP) and the session keystone
-            const domainAddr = getIbGibAddr({ ibGib: domainI });
-            const resSync = await apiBridge.putEvolveKeystone(domainAddr, evolvedI, [sessionS]);
-
-            if (!resSync.success) {
-                devLog(`✗ Server rejected evolution: ${resSync.message}`);
-                btn.disabled = false;
-                return;
-            }
-
-            devLog('✓ Server accepted Domain Keystone evolution!');
-            btn.textContent = '✓ Domain Keystone Evolved';
-
-            // Enable next step
-            const nextBtn = document.getElementById('btn-perform-sync') as HTMLButtonElement;
-            if (nextBtn) nextBtn.disabled = false;
-
-        } catch (error) {
-            devLog(`✗ ${extractErrorMsg(error)}`);
-            console.error(`${lc_fn} ${extractErrorMsg(error)}`);
-            btn.disabled = false;
-        }
-    });
-}
-
-// ---------------------------------------------------------------------------
-// Perform Sync Connect (S) button
-// ---------------------------------------------------------------------------
-
-function initPerformSyncButton(): void {
-    const lc_fn = `${lc}[initPerformSyncButton]`;
-    const btn = document.getElementById('btn-perform-sync') as HTMLButtonElement | null;
-    if (!btn) return;
-
-    btn.addEventListener('click', async () => {
-        try {
-            debugger; // walk through sync
-            btn.disabled = true;
-            devLog('Initiating Sync Connect via WebSocket...');
-
-            const sessionS = debugState.sessionS;
-            const sessionSecret = debugState.sessionSecret;
-            const domainI = debugState.domainI;
-
-            if (!sessionS || !sessionSecret || !domainI) {
-                devLog('⚠ Incomplete state. Please complete steps 1-4.');
-                btn.disabled = false;
-                return;
-            }
-
-            const metaspace = await getGlobalMetaspace_waitIfNeeded();
-            const space = await metaspace.getLocalUserSpace({});
-            if (!space) { throw new Error("No space."); }
-
-            devLog('Pre-solving upfront picket-fence challenge...');
-            const connectPool = (sessionS.data?.challengePools ?? []).find(p => p.id === SESSION_KEYSTONE_POLICY.CONNECT_POOL.ID);
-            if (!connectPool) {
-                throw new Error(`Session keystone missing "${SESSION_KEYSTONE_POLICY.CONNECT_POOL.ID}" pool`);
-            }
-
-            const { challengeId } = getConnectChallenge(sessionS);
-            const strategy = KeystoneStrategyFactory.create({ config: connectPool.config });
-            const poolSecret = await strategy.derivePoolSecret({ masterSecret: sessionSecret });
-            const solution = await strategy.generateSolution({
-                poolSecret,
-                poolId: SESSION_KEYSTONE_POLICY.CONNECT_POOL.ID,
-                challengeId
-            });
-
-            const sAddr = getIbGibAddr({ ibGib: sessionS });
-            const domainAddr = getIbGibAddr({ ibGib: domainI });
-            const protocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
-            const wsUrl = `${protocol}//${location.host}/api/sync/ws/${encodeURIComponent(domainAddr)}` +
-                `?sAddr=${encodeURIComponent(sAddr)}` +
-                `&solution=${solution.value}`;
-
-            devLog(`→ connecting to ${wsUrl}`);
-            const ws = new WebSocket(wsUrl);
-
-            ws.addEventListener('open', () => {
-                devLog('✓ WebSocket connected. Waiting for server challenge...');
-            });
-
-            ws.addEventListener('message', async (ev) => {
-                try {
-                    const msg = JSON.parse(ev.data);
-                    devLog(`← received: ${msg.type ?? 'message'}`);
-
-                    if (msg.type === 'auth-challenge-init') {
-                        devLog('→ sending auth-init with sAddr...');
-                        ws.send(JSON.stringify({
-                            type: 'auth-init',
-                            sAddr: getIbGibAddr({ ibGib: sessionS })
-                        }));
-                    } else if (msg.type === 'auth-challenge') {
-                        const { challengeUuid, demandedIds } = msg;
-                        devLog(`→ server demanded ${demandedIds.length} ids. Signing connect proof...`);
-
-                        const keystoneService = new KeystoneService_V1();
-                        const proofFrame = await keystoneService.sign({
-                            latestKeystone: sessionS,
-                            masterSecret: sessionSecret,
-                            poolId: POOL_ID_CONNECT,
-                            requiredChallengeIds: demandedIds,
-                            claim: {
-                                verb: KEYSTONE_VERB_CONNECT,
-                                target: challengeUuid
-                            },
-                            metaspace,
-                            space
-                        });
-
-                        devLog('→ sending auth-proof...');
-                        ws.send(JSON.stringify({
-                            type: 'auth-proof',
-                            proofFrame
-                        }));
-                    } else if (msg.type === 'auth-ok') {
-                        devLog('✓ Connect SUCCESS! Sync session authorized.');
-                        btn.textContent = '✓ Sync Authorized';
-                    } else if (msg.type === 'auth-fail') {
-                        devLog(`✗ Connect FAILED: ${msg.message}`);
-                        btn.disabled = false;
-                    }
-                } catch (error) {
-                    devLog(`✗ Message handler error: ${extractErrorMsg(error)}`);
-                    console.error(`${lc_fn} Message handler error:`, error);
-                    btn.disabled = false;
-                }
-            });
-
-            ws.addEventListener('close', (ev) => {
-                devLog(`✗ WebSocket closed (code ${ev.code})`);
-                btn.disabled = false;
-            });
-
-            ws.addEventListener('error', () => {
-                devLog(`✗ WebSocket error — check server`);
-                btn.disabled = false;
-            });
-
-        } catch (error) {
-            devLog(`✗ ${extractErrorMsg(error)}`);
-            console.error(`${lc_fn} ${extractErrorMsg(error)}`);
-            btn.disabled = false;
-        }
-    });
-}
-
-// ---------------------------------------------------------------------------
-// Phase 1B: Standardized Setup / Sync / Check testing loop
-// ---------------------------------------------------------------------------
-
-function init1bSetupButton(): void {
-    const lc_fn = `${lc}[init1bSetupButton]`;
-    const btn = document.getElementById('btn-1b-setup') as HTMLButtonElement | null;
-    if (!btn) return;
-
-    btn.addEventListener('click', async () => {
-        try {
-            btn.disabled = true;
-            devLog('1B Setup: Generating Alice\'s long-lived Domain Keystone (I) and Target (X)...');
-
-            const metaspace = await getGlobalMetaspace_waitIfNeeded();
-            const space = await metaspace.getLocalUserSpace({});
-            if (!space) { throw new Error("No default space."); }
-
-            const masterSecret = 'test-sender-secret-phase1';
-            const keystoneService = new KeystoneService_V1();
-
-            // 1. Create Genesis Domain Keystone (I^Itjp) in local sourceSpace
-            const domainI = await keystoneService.genesis({
-                masterSecret,
-                configs: [
-                    getSpaceGibPoolConfig('sync', 'senderidentitysyncsaltphase1'),
-                    getSpaceGibPoolConfig('manage', 'senderidentitymanagesaltphase1'),
-                ],
-                metaspace,
-                space,
-                frameDetails: { client: 'space-gib-web-dev', timestamp: getTimestamp() }
-            });
-
-            debugState.domainI = domainI;
-            debugState.domainIMasterSecret = masterSecret;
-
-            devLog(`1B Setup: ✓ Domain Keystone (I) created locally: ${getIbGibAddr({ ibGib: domainI })}`);
-            devLog(`1B Setup: Starting postGenesisKeystone...`);
-
-            // 2. Post Genesis Domain Keystone to receiver/server
-            const apiBridge = new SpaceGibApiBridge();
-            const resGenesis = await apiBridge.postGenesisKeystone(domainI);
-            if (resGenesis.success) {
-                devLog(`1B Setup: ✓ Domain Keystone registered and stored on receiver (server).`);
-            } else {
-                devLog(`1B Setup: X postGenesisKeystone failed: ${resGenesis.message}.`);
-                throw new Error(`1B Setup: Server rejected genesis domain keystone: ${resGenesis.message}`);
-            }
-
-            // 3. Create Test IbGib (X) locally
-            const resX = await factory.firstGen({
-                parentIbGib: ROOT,
-                ib: 'test data',
-                data: { hello: 'world', random: Math.random() },
-                dna: true,
-                nCounter: true,
-                tjp: { uuid: true, timestamp: true }
-            });
-            debugState.targetX = resX.newIbGib;
-            devLog(`1B Setup: ✓ Target (X) created locally: ${getIbGibAddr({ ibGib: resX.newIbGib })}`);
-
-            devLog('✓ 1B Setup Complete! Ready for 1B Sync.');
-            btn.textContent = '✓ 1B Setup Complete';
-
-            // Enable next button in the phase flow
-            const syncBtn = document.getElementById('btn-1b-sync') as HTMLButtonElement | null;
-            if (syncBtn) syncBtn.disabled = false;
-
-        } catch (error) {
-            devLog(`✗ 1B Setup FAILED: ${extractErrorMsg(error)}`);
-            console.error(`${lc_fn} 1B Setup error:`, error);
-            btn.disabled = false;
-        }
-    });
-}
-
-function init1bSyncButton(): void {
-    const lc_fn = `${lc}[init1bSyncButton]`;
-    const btn = document.getElementById('btn-1b-sync') as HTMLButtonElement | null;
-    if (!btn) return;
-
-    btn.addEventListener('click', async () => {
-        try {
-            btn.disabled = true;
-            devLog('1B Sync: Executing senderCoordinator.sync(...) using WebSocket Peer...');
-
-            const domainI = debugState.domainI;
-            const targetX = debugState.targetX;
-            if (!domainI || !targetX) {
-                devLog('⚠ 1B Sync: Missing setup state. Please run Setup first.');
-                btn.disabled = false;
-                return;
-            }
-
-            const domainAddr = getIbGibAddr({ ibGib: domainI });
-            const metaspace = await getGlobalMetaspace_waitIfNeeded();
-            const space = await metaspace.getLocalUserSpace({});
-            if (!space) { throw new Error("No default space."); }
-
-            // Instantiate WebSocket sender peer
-            const protocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
-            const senderPeer = new SyncPeerWebSocketSender_V1({
-                classname: 'SyncPeerWebSocketSender_V1',
-                httpEvolveUrl: `${location.protocol}//${location.host}/api/keystone/evolve/${encodeURIComponent(domainAddr)}`,
-                wsUrl: `${protocol}//${location.host}/api/sync/ws/${encodeURIComponent(domainAddr)}`
-            });
-
-            const coordinator = new SyncSagaCoordinator();
-            const sagaId = await getUUID();
-            debugState.sagaId = sagaId;
-            debugState.senderPeer = senderPeer;
-
-            await senderPeer.initializeOpts({
-                localMetaspace: metaspace,
-                localSpace: space,
-                senderIdentity: domainI,
-                fnSenderSecret: async () => debugState.domainIMasterSecret!,
-                sagaId,
-                sessionConnectPoolConfig: SESSION_KEYSTONE_POLICY.CONNECT_POOL as any,
-                sessionSyncPoolConfig: SESSION_KEYSTONE_POLICY.DEFAULT_POOL as any,
-                targetAddrs: [domainAddr]
-            });
-
-            try {
-                // Execute sync saga — triggers establishSessionIdentity internally!
-                const syncSaga = await coordinator.sync({
-                    domainIbGibs: [targetX],
-                    senderIdentity: domainI,
-                    fnSenderSecret: async () => debugState.domainIMasterSecret!,
-                    peer: senderPeer,
-                    localSpace: space,
-                    metaspace,
-                    conflictStrategy: 'optimisticWithLCS' as any
-                });
-                await syncSaga.done;
-            } catch (err) {
-                // connection/sync error is fine/expected right now since connection is in Phase 2
-                devLog(`1B Sync: Coordinator sync executed (establish phase successfully run; connection/sync errors expected in 1B): ${extractErrorMsg(err)}`);
-            }
-
-            devLog('✓ 1B Sync Execution Complete! Ready for State Checks.');
-            btn.textContent = '✓ 1B Sync Run';
-
-            // Enable check button
-            const checkBtn = document.getElementById('btn-1b-check') as HTMLButtonElement | null;
-            if (checkBtn) checkBtn.disabled = false;
-
-        } catch (error) {
-            devLog(`✗ 1B Sync FAILED: ${extractErrorMsg(error)}`);
-            console.error(`${lc_fn} 1B Sync error:`, error);
-            btn.disabled = false;
-        }
-    });
-}
-
-function init1bCheckButton(): void {
-    const lc_fn = `${lc}[init1bCheckButton]`;
-    const btn = document.getElementById('btn-1b-check') as HTMLButtonElement | null;
-    if (!btn) return;
-
-    btn.addEventListener('click', async () => {
-        try {
-            devLog('1B Check: Asserting cryptographic and durable state expectations from respec...');
-
-            debugger; // allow for walkthrough 1B check
-            const metaspace = await getGlobalMetaspace_waitIfNeeded();
-            const space = await metaspace.getLocalUserSpace({});
-            if (!space) { throw new Error("No default space."); }
-
-            const domainI = debugState.domainI!;
-            const targetX = debugState.targetX!;
-            const xAddr = getIbGibAddr({ ibGib: targetX });
-
-            // 1. Resolve evolved sender identity I1 locally
-            const newSenderIdentityAddr = await metaspace.getLatestAddr({
-                addr: getIbGibAddr({ ibGib: domainI }),
-                space
-            });
-
-            if (!newSenderIdentityAddr) {
-                devLog('✗ Check: Evolved domain keystone tip I1 NOT found in local space!');
-                return;
-            }
-            devLog(`✓ Check: Evolved Domain Keystone (I1) created and stored locally.`);
-
-            const getRes = await metaspace.get({ addrs: [newSenderIdentityAddr], space });
-            const newSenderIdentity = getRes.ibGibs?.[0] as KeystoneIbGib_V1 | undefined;
-
-            if (!newSenderIdentity) {
-                devLog('✗ Check: Failed to load I1 from local space.');
-                return;
-            }
-
-            const syncProof = newSenderIdentity.data?.proofs?.find(p => p.claim?.verb === 'sync');
-            if (!syncProof) {
-                devLog('✗ Check: I1 is missing sync-verb claim proof!');
-            } else {
-                devLog('✓ Check: I1 contains valid sync-verb claim proof.');
-            }
-
-            const sessionIdentityTjpAddr = syncProof?.claim?.target;
-            if (!sessionIdentityTjpAddr) {
-                devLog('✗ Check: I1 sync claim does not target a session keystone.');
-                return;
-            }
-            devLog(`✓ Check: Sync claim targets session keystone: ${sessionIdentityTjpAddr}`);
-
-            // 2. Load Session Keystone (S) locally
-            const sRes = await metaspace.get({ addrs: [sessionIdentityTjpAddr], space });
-            const sessionIdentity = sRes.ibGibs?.[0] as KeystoneIbGib_V1 | undefined;
-
-            if (!sessionIdentity) {
-                devLog('✗ Check: Session Keystone (S) NOT found in local space.');
-                return;
-            }
-            devLog('✓ Check: Session Keystone (S) successfully created locally.');
-
-            const sPools = sessionIdentity.data?.challengePools ?? [];
-            const hasConnectPool = sPools.some(p => p.id === POOL_ID_CONNECT);
-            const hasSyncPool = sPools.some(p => p.id === POOL_ID_SYNC);
-
-            if (hasConnectPool && hasSyncPool) {
-                devLog('✓ Check: S contains both connect and sync challenge pools.');
-            } else {
-                devLog(`✗ Check: S is missing challenge pools! (connect: ${hasConnectPool}, sync: ${hasSyncPool})`);
-            }
-
-            // we don't check this yet until sync ping pong
-            // const targetAddrs = sessionIdentity.data?.frameDetails?.targetAddrs ?? [];
-            // if (targetAddrs.includes(xAddr)) {
-            //     devLog('✓ Check: S is securely bound to target domain X in frameDetails.');
-            // } else {
-            //     devLog('✗ Check: S is not bound to target domain X!');
-            // }
-
-            // #region 3. Verify Server-Side (receiver) registrations via GET REST API
-            devLog('Check: Verifying registrations on server (receiver metaspace)...');
-            const apiBridge = new SpaceGibApiBridge();
-
-            // Check if I, evolved I1 and session S exist on server
-            let hasI = false;
-            let hasI1 = false;
-            let hasS = false;
-
-            const domainAddr = getIbGibAddr({ ibGib: domainI });
-            const resGetDomainIGraphFromServer = await apiBridge.getKeystoneGraph(domainAddr);
-            if (resGetDomainIGraphFromServer.success && resGetDomainIGraphFromServer.graph) {
-                const domainGraph = resGetDomainIGraphFromServer.graph;
-                hasI = domainGraph[domainAddr] !== undefined;
-                hasI1 = domainGraph[newSenderIdentityAddr] !== undefined;
-            } else {
-                devLog(`✗ Check Server: Failed to fetch keystone graph from server: ${resGetDomainIGraphFromServer.message}`);
-            }
-
-            const resGetSessionSFromServer = await apiBridge.getIbGib(domainAddr, sessionIdentityTjpAddr);
-            if (resGetSessionSFromServer.success && resGetSessionSFromServer.ibGib) {
-                hasS = true;
-            } else {
-                devLog(`✗ Check Server: Failed to fetch session keystone from server: ${resGetSessionSFromServer.message}`);
-            }
-
-            if (hasI) devLog('✓ Check Server: Genesis Domain Keystone (I) registered on server.');
-            else devLog('✗ Check Server: Genesis Domain Keystone (I) missing on server!');
-            if (hasI1) devLog('✓ Check Server: Evolved Domain Keystone (I1) accepted and stored on server.');
-            else devLog('✗ Check Server: Evolved Domain Keystone (I1) missing on server!');
-            if (hasS) devLog('✓ Check Server: Session Keystone (S) accepted and stored on server.');
-            else devLog('✗ Check Server: Session Keystone (S) missing on server!');
-            if (hasI && hasI1 && hasS) {
-                devLog('🎉 ALL PHASE 1B ESTABLISH CHECKS PASSED FLAWLESSLY! ✓');
-                btn.textContent = '✓ 1B All Passed';
-
-                const btn2bSetup = document.getElementById('btn-2b-setup') as HTMLButtonElement | null;
-                if (btn2bSetup) btn2bSetup.disabled = false;
-            }
-
-            // #endregion 3. Verify Server-Side (receiver) registrations via GET REST API
-
-        } catch (error) {
-            devLog(`✗ 1B Check FAILED: ${extractErrorMsg(error)}`);
-            console.error(`${lc_fn} 1B Check error:`, error);
-        }
-    });
-}
-
-// ---------------------------------------------------------------------------
-// Phase 2B Implementation
-// ---------------------------------------------------------------------------
-
-function init2bSetupButton(): void {
-    const lc_fn = `${lc}[init2bSetupButton]`;
-    const btn = document.getElementById('btn-2b-setup') as HTMLButtonElement | null;
-    if (!btn) return;
-
-    btn.addEventListener('click', async () => {
-        try {
-            btn.disabled = true;
-            devLog('2B Setup: Generating Alice\'s long-lived Domain Keystone (I) and Target (X)...');
-
-            const metaspace = await getGlobalMetaspace_waitIfNeeded();
-            const space = await metaspace.getLocalUserSpace({});
-            if (!space) { throw new Error("No default space."); }
-
-            const masterSecret = 'test-sender-secret-phase2';
-            const keystoneService = new KeystoneService_V1();
-
-            // 1. Create Genesis Domain Keystone (I^Itjp) in local sourceSpace
-            const domainI = await keystoneService.genesis({
-                masterSecret,
-                configs: [
-                    getSpaceGibPoolConfig('sync', 'senderidentitysyncsaltphase2'),
-                    getSpaceGibPoolConfig('manage', 'senderidentitymanagesaltphase2'),
-                ],
-                metaspace,
-                space,
-                frameDetails: { client: 'space-gib-web-dev', timestamp: getTimestamp() }
-            });
-
-            debugState.domainI = domainI;
-            debugState.domainIMasterSecret = masterSecret;
-
-            devLog(`2B Setup: ✓ Domain Keystone (I) created locally: ${getIbGibAddr({ ibGib: domainI })}`);
-            devLog(`2B Setup: Starting postGenesisKeystone...`);
-
-            // 2. Post Genesis Domain Keystone to receiver/server
-            const apiBridge = new SpaceGibApiBridge();
-            const resGenesis = await apiBridge.postGenesisKeystone(domainI);
-            if (resGenesis.success) {
-                devLog(`2B Setup: ✓ Domain Keystone registered and stored on receiver (server).`);
-            } else {
-                devLog(`2B Setup: X postGenesisKeystone failed: ${resGenesis.message}.`);
-                throw new Error(`2B Setup: Server rejected genesis domain keystone: ${resGenesis.message}`);
-            }
-
-            // 3. Create Test IbGib (X) locally
-            const resX = await factory.firstGen({
-                parentIbGib: ROOT,
-                ib: 'test data',
-                data: { hello: 'world2', random: Math.random() },
-                dna: true,
-                nCounter: true,
-                tjp: { uuid: true, timestamp: true }
-            });
-            debugState.targetX = resX.newIbGib;
-            devLog(`2B Setup: ✓ Target (X) created locally: ${getIbGibAddr({ ibGib: resX.newIbGib })}`);
-
-            devLog('✓ 2B Setup Complete! Ready for 2B Sync.');
-            btn.textContent = '✓ 2B Setup Complete';
-
-            // Enable next button in the phase flow
-            const syncBtn = document.getElementById('btn-2b-sync') as HTMLButtonElement | null;
-            if (syncBtn) syncBtn.disabled = false;
-
-        } catch (error) {
-            devLog(`✗ 2B Setup FAILED: ${extractErrorMsg(error)}`);
-            console.error(`${lc_fn} 2B Setup error:`, error);
-            btn.disabled = false;
-        }
-    });
-}
-
-function init2bSyncButton(): void {
-    const lc_fn = `${lc}[init2bSyncButton]`;
-    const btn = document.getElementById('btn-2b-sync') as HTMLButtonElement | null;
-    if (!btn) return;
-
-    btn.addEventListener('click', async () => {
-        try {
-            btn.disabled = true;
-            devLog('2B Sync: Executing senderCoordinator.sync(...) using WebSocket Peer...');
-
-            const domainI = debugState.domainI;
-            const targetX = debugState.targetX;
-            if (!domainI || !targetX) {
-                devLog('⚠ 2B Sync: Missing setup state. Please run Setup first.');
-                btn.disabled = false;
-                return;
-            }
-
-            const domainAddr = getIbGibAddr({ ibGib: domainI });
-            const metaspace = await getGlobalMetaspace_waitIfNeeded();
-            const space = await metaspace.getLocalUserSpace({});
-            if (!space) { throw new Error("No default space."); }
-
-            // Instantiate WebSocket sender peer
-            const protocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
-            const senderPeer = new SyncPeerWebSocketSender_V1({
-                classname: 'SyncPeerWebSocketSender_V1',
-                httpEvolveUrl: `${location.protocol}//${location.host}/api/keystone/evolve/${encodeURIComponent(domainAddr)}`,
-                wsUrl: `${protocol}//${location.host}/api/sync/ws/${encodeURIComponent(domainAddr)}`
-            });
-
-            const coordinator = new SyncSagaCoordinator();
-            const sagaId = await getUUID();
-            debugState.sagaId = sagaId;
-            debugState.senderPeer = senderPeer;
-
-            await senderPeer.initializeOpts({
-                localMetaspace: metaspace,
-                localSpace: space,
-                senderIdentity: domainI,
-                fnSenderSecret: async () => debugState.domainIMasterSecret!,
-                sagaId,
-                sessionConnectPoolConfig: SESSION_KEYSTONE_POLICY.CONNECT_POOL as any,
-                sessionSyncPoolConfig: SESSION_KEYSTONE_POLICY.DEFAULT_POOL as any,
-                targetAddrs: [domainAddr]
-            });
-
-            try {
-                // Execute sync saga — triggers establishSessionIdentity and connectImpl internally!
-                const syncSaga = await coordinator.sync({
-                    domainIbGibs: [targetX],
-                    senderIdentity: domainI,
-                    fnSenderSecret: async () => debugState.domainIMasterSecret!,
-                    peer: senderPeer,
-                    localSpace: space,
-                    metaspace,
-                    conflictStrategy: 'optimisticWithLCS' as any
-                });
-                await syncSaga.done;
-            } catch (err) {
-                // connection/sync error is fine/expected right now since sync protocol (Phase 3) might be incomplete
-                devLog(`2B Sync: Coordinator sync executed (connect phase successfully run; subsequent sync errors expected in 2B): ${extractErrorMsg(err)}`);
-            }
-
-            devLog('✓ 2B Sync Execution Complete! Ready for State Checks.');
-            btn.textContent = '✓ 2B Sync Run';
-
-            // Enable check button
-            const checkBtn = document.getElementById('btn-2b-check') as HTMLButtonElement | null;
-            if (checkBtn) checkBtn.disabled = false;
-
-        } catch (error) {
-            devLog(`✗ 2B Sync FAILED: ${extractErrorMsg(error)}`);
-            console.error(`${lc_fn} 2B Sync error:`, error);
-            btn.disabled = false;
-        }
-    });
-}
-
-function init2bCheckButton(): void {
-    const lc_fn = `${lc}[init2bCheckButton]`;
-    const btn = document.getElementById('btn-2b-check') as HTMLButtonElement | null;
-    if (!btn) return;
-
-    btn.addEventListener('click', async () => {
-        try {
-            debugger; // allow for walkthrough 2B check
-            devLog('2B Check: Asserting cryptographic and WebSocket state expectations...');
-
-            const metaspace = await getGlobalMetaspace_waitIfNeeded();
-            const space = await metaspace.getLocalUserSpace({});
-            if (!space) { throw new Error("No default space."); }
-
-            const domainI = debugState.domainI!;
-            const targetX = debugState.targetX!;
-            const xAddr = getIbGibAddr({ ibGib: targetX });
-
-            // 1. Resolve evolved sender identity I1 locally
-            const domainAddr = getIbGibAddr({ ibGib: domainI });
-            const newSenderIdentityAddr = await metaspace.getLatestAddr({
-                addr: domainAddr,
-                space
-            });
-
-            if (!newSenderIdentityAddr) {
-                devLog('✗ Check: Evolved domain keystone tip I1 NOT found in local space!');
-                return;
-            }
-            devLog(`✓ Check: Evolved Domain Keystone (I1) created and stored locally.`);
-
-            const getRes = await metaspace.get({ addrs: [newSenderIdentityAddr], space });
-            const newSenderIdentity = getRes.ibGibs?.[0] as KeystoneIbGib_V1 | undefined;
-
-            if (!newSenderIdentity) {
-                devLog('✗ Check: Failed to load I1 from local space.');
-                return;
-            }
-
-            const syncProof = newSenderIdentity.data?.proofs?.find(p => p.claim?.verb === 'sync');
-            const sessionIdentityTjpAddr = syncProof?.claim?.target;
-            if (!sessionIdentityTjpAddr) {
-                devLog('✗ Check: I1 sync claim does not target a session keystone.');
-                return;
-            }
-            devLog(`✓ Check: Sync claim targets session keystone: ${sessionIdentityTjpAddr}`);
-
-            // 2. Load Session Keystone (S) locally and get latest tip
-            const latestSessionSAddr = await metaspace.getLatestAddr({
-                addr: sessionIdentityTjpAddr,
-                space
-            });
-            if (!latestSessionSAddr) {
-                devLog('✗ Check: Latest Session Keystone (S) NOT found in local space.');
-                return;
-            }
-            devLog(`✓ Check: Found latest session keystone (S) locally.`);
-
-            const sRes = await metaspace.get({ addrs: [latestSessionSAddr], space });
-            const sessionIdentity = sRes.ibGibs?.[0] as KeystoneIbGib_V1 | undefined;
-
-            if (!sessionIdentity) {
-                devLog('✗ Check: Failed to load latest Session Keystone (S).');
-                return;
-            }
-
-            // Verify S contains connect and sync pools
-            const sPools = sessionIdentity.data?.challengePools ?? [];
-            const connectPool = sPools.find(p => p.id === POOL_ID_CONNECT);
-            const syncPool = sPools.find(p => p.id === POOL_ID_SYNC);
-
-            if (connectPool && syncPool) {
-                devLog('✓ Check: S contains both connect and sync challenge pools.');
-            } else {
-                devLog(`✗ Check: S is missing challenge pools! (connect: ${!!connectPool}, sync: ${!!syncPool})`);
-                return;
-            }
-
-            // Verify S was successfully evolved (depleted connect pool)
-            const remainingChallenges = Object.keys(connectPool.challenges).length;
-            if (remainingChallenges === 0) {
-                devLog('✓ Check: S connect pool successfully depleted (0 challenges remaining).');
-            } else {
-                devLog(`✗ Check: S connect pool not depleted! (${remainingChallenges} challenges remaining)`);
-                return;
-            }
-
-            // we don't check this yet until sync ping pong
-            // const targetAddrs = sessionIdentity.data?.frameDetails?.targetAddrs ?? [];
-            // if (targetAddrs.includes(xAddr)) {
-            //     devLog('✓ Check: S is securely bound to target domain X in frameDetails.');
-            // } else {
-            //     devLog('✗ Check: S is not bound to target domain X!');
-            // }
-
-            // 3. Verify WebSocket Connection is open and active
-            if (debugState.senderPeer && debugState.senderPeer.isSocketOpen) {
-                devLog('✓ Check: WebSocket connection is active and OPEN.');
-            } else {
-                devLog('✗ Check: WebSocket connection is NOT open or peer is missing!');
-                return;
-            }
-
-            devLog('🎉 ALL PHASE 2B CONNECT CHECKS PASSED FLAWLESSLY! ✓');
-            btn.textContent = '✓ 2B All Passed';
-
-            // Enable Phase 3B setup
-            const p3SetupBtn = document.getElementById('btn-3b-setup') as HTMLButtonElement | null;
-            if (p3SetupBtn) p3SetupBtn.disabled = false;
-
-        } catch (error) {
-            devLog(`✗ 2B Check FAILED: ${extractErrorMsg(error)}`);
-            console.error(`${lc_fn} 2B Check error:`, error);
-        }
-    });
-}
-
-function init3bPlaceholder(): void {
-    const btnSetup = document.getElementById('btn-3b-setup') as HTMLButtonElement | null;
-    const btnSync = document.getElementById('btn-3b-sync') as HTMLButtonElement | null;
-    const btnCheck = document.getElementById('btn-3b-check') as HTMLButtonElement | null;
-
-    if (btnSetup) {
-        btnSetup.addEventListener('click', () => devLog('3B Setup: Placeholders ready for Phase 3B (Transactional Sync).'));
-    }
-    if (btnSync) {
-        btnSync.addEventListener('click', () => devLog('3B Sync: Placeholders ready for Phase 3B (Transactional Sync).'));
-    }
-    if (btnCheck) {
-        btnCheck.addEventListener('click', () => devLog('3B Check: Placeholders ready for Phase 3B (Transactional Sync).'));
-    }
-}
-
-// ---------------------------------------------------------------------------
-// Dev Tools UI Init
-// ---------------------------------------------------------------------------
+    initWsTestButton, initPrintStateButton, initCreateDomainKeystoneButton,
+    initCreateTestIbGibButton, initCreateSessionKeystoneButton
+} from './dev-tools/base-tools.mjs';
+import { init1bSetupButton, init1bSyncButton, init1bCheckButton } from './dev-tools/phase-1.mjs';
+import { init2bSetupButton, init2bSyncButton, init2bCheckButton } from './dev-tools/phase-2.mjs';
+import { init3bSetupButton, init3bSyncButton, init3bCheckButton } from './dev-tools/phase-3.mjs';
+import { init4_1bSetupButton, init4_1bSyncButton, init4_1bCheckButton } from './dev-tools/phase-4-1.mjs';
+import { init4_2bSetupButton, init4_2bSyncButton, init4_2bCheckButton } from './dev-tools/phase-4-2.mjs';
+import { init4_3bSetupButton, init4_3bSyncButton, init4_3bCheckButton } from './dev-tools/phase-4-3.mjs';
+import { init4_4bSetupButton, init4_4bSyncButton, init4_4bCheckButton } from './dev-tools/phase-4-4.mjs';
+import { init4_5bSetupButton, init4_5bSyncButton, init4_5bCheckButton } from './dev-tools/phase-4-5.mjs';
+import { init4_6bSetupButton, init4_6bSyncButton, init4_6bCheckButton } from './dev-tools/phase-4-6.mjs';
+import { init4_7bSetupButton, init4_7bSyncButton, init4_7bCheckButton } from './dev-tools/phase-4-7.mjs';
+import { init4_8bSetupButton, init4_8bSyncButton, init4_8bCheckButton } from './dev-tools/phase-4-8.mjs';
+import { init4_9bSetupButton, init4_9bSyncButton, init4_9bCheckButton } from './dev-tools/phase-4-9.mjs';
+import { init4_10bSetupButton, init4_10bSyncButton, init4_10bCheckButton } from './dev-tools/phase-4-10.mjs';
+
+export { devLog, debugState };
 
 /**
  * Call once inside DOMContentLoaded to wire up all dev-tool buttons.
@@ -1110,15 +39,45 @@ export function initDevTools(): void {
         initWsTestButton();
         initCreateTestIbGibButton();
         initCreateSessionKeystoneButton();
-        initEvolveDomainKeystoneButton();
-        initPerformSyncButton();
         init1bSetupButton();
         init1bSyncButton();
         init1bCheckButton();
         init2bSetupButton();
         init2bSyncButton();
         init2bCheckButton();
-        init3bPlaceholder();
+        init3bSetupButton();
+        init3bSyncButton();
+        init3bCheckButton();
+        init4_1bSetupButton();
+        init4_1bSyncButton();
+        init4_1bCheckButton();
+        init4_2bSetupButton();
+        init4_2bSyncButton();
+        init4_2bCheckButton();
+        init4_3bSetupButton();
+        init4_3bSyncButton();
+        init4_3bCheckButton();
+        init4_4bSetupButton();
+        init4_4bSyncButton();
+        init4_4bCheckButton();
+        init4_5bSetupButton();
+        init4_5bSyncButton();
+        init4_5bCheckButton();
+        init4_6bSetupButton();
+        init4_6bSyncButton();
+        init4_6bCheckButton();
+        init4_7bSetupButton();
+        init4_7bSyncButton();
+        init4_7bCheckButton();
+        init4_8bSetupButton();
+        init4_8bSyncButton();
+        init4_8bCheckButton();
+        init4_9bSetupButton();
+        init4_9bSyncButton();
+        init4_9bCheckButton();
+        init4_10bSetupButton();
+        init4_10bSyncButton();
+        init4_10bCheckButton();
     } catch (error) {
         console.error(`${lc_fn} ${extractErrorMsg(error)}`);
     }