@ibgib/space-gib 0.0.34 → 0.0.35

package/src/client/ui/router/space-gib-router-helpers.respec.mts

@@ -12,11 +12,13 @@ import {
     SpaceGibRouteInfo,
     PolycosmosRouteInfo,
     CosmosRouteInfo,
-    CodeGalaxyRouteInfo,
-    NotesGalaxyRouteInfo,
+    GalaxyRouteInfo,
     RawAddrRouteInfo,
     RawTjpRouteInfo,
 } from './space-gib-router-types.mjs';
+import { CosmosIbGib_V1 } from '@ibgib/core-gib/dist/cosmology/cosmos/cosmos-types.mjs';
+import { IbGibRouterServiceBase, IbGibCosmosRouterServiceBase } from '@ibgib/web-gib/dist/ui/router/index.mjs';
+import { getSpaceGibRouterSvc, SpaceGibRouterService } from './space-gib-router-service.mjs';
 
 await respecfully(sir, 'SpaceGibRouterHelpers specs', async () => {
 
@@ -109,121 +111,230 @@ await respecfully(sir, 'SpaceGibRouterHelpers specs', async () => {
         });
     });
 
-    await respecfully(sir, 'Code Galaxy Routes', async () => {
-        await ifWe(sir, 'parses /my-cosmos/code/code-1 with galaxyId', async () => {
-            const route = parseSpaceGibRoute('/my-cosmos/code/code-1');
-            iReckon(sir, route.kind).willEqual('code-galaxy');
-            const cg = route as CodeGalaxyRouteInfo;
-            iReckon(sir, cg.cosmos).willEqual('my-cosmos');
-            iReckon(sir, cg.galaxyId).willEqual('code-1');
-            iReckon(sir, cg.branch).willEqual(undefined);
-            iReckon(sir, cg.filePath).willEqual(undefined);
-        });
-
-        await ifWe(sir, 'parses /my-cosmos/code/code-1/main with branch', async () => {
-            const route = parseSpaceGibRoute('/my-cosmos/code/code-1/main');
-            iReckon(sir, route.kind).willEqual('code-galaxy');
-            const cg = route as CodeGalaxyRouteInfo;
-            iReckon(sir, cg.cosmos).willEqual('my-cosmos');
-            iReckon(sir, cg.galaxyId).willEqual('code-1');
-            iReckon(sir, cg.branch).willEqual('main');
-            iReckon(sir, cg.filePath).willEqual(undefined);
-        });
-
-        await ifWe(sir, 'parses /my-cosmos/code/code-1/main/src/index.ts with branch and deep filePath', async () => {
-            const route = parseSpaceGibRoute('/my-cosmos/code/code-1/main/src/index.ts');
-            iReckon(sir, route.kind).willEqual('code-galaxy');
-            const cg = route as CodeGalaxyRouteInfo;
-            iReckon(sir, cg.cosmos).willEqual('my-cosmos');
-            iReckon(sir, cg.galaxyId).willEqual('code-1');
-            iReckon(sir, cg.branch).willEqual('main');
-            iReckon(sir, cg.filePath).willEqual('src/index.ts');
-        });
-
-        await ifWe(sir, 'parses /@bill/my-cosmos/code/code-1/feat-x/src/deep/nested/file.mts with tenant and deep path', async () => {
-            const route = parseSpaceGibRoute('/@bill/my-cosmos/code/code-1/feat-x/src/deep/nested/file.mts');
-            iReckon(sir, route.kind).willEqual('code-galaxy');
-            const cg = route as CodeGalaxyRouteInfo;
-            const tenant = cg.tenant;
+    await respecfully(sir, 'Universal Galaxy Routes (Branching / Code Archetype)', async () => {
+        await ifWe(sir, 'parses /my-cosmos/code-1 with galaxy', async () => {
+            const route = parseSpaceGibRoute('/my-cosmos/code-1');
+            iReckon(sir, route.kind).willEqual('galaxy');
+            const g = route as GalaxyRouteInfo;
+            iReckon(sir, g.cosmos).willEqual('my-cosmos');
+            iReckon(sir, g.galaxy).willEqual('code-1');
+            iReckon(sir, g.topology).willEqual('branching');
+            iReckon(sir, g.branch).willEqual(undefined);
+            iReckon(sir, g.filePath).willEqual(undefined);
+        });
+
+        await ifWe(sir, 'parses /my-cosmos/code-1/main with branch', async () => {
+            const route = parseSpaceGibRoute('/my-cosmos/code-1/main');
+            iReckon(sir, route.kind).willEqual('galaxy');
+            const g = route as GalaxyRouteInfo;
+            iReckon(sir, g.cosmos).willEqual('my-cosmos');
+            iReckon(sir, g.galaxy).willEqual('code-1');
+            iReckon(sir, g.topology).willEqual('branching');
+            iReckon(sir, g.branch).willEqual('main');
+            iReckon(sir, g.filePath).willEqual(undefined);
+        });
+
+        await ifWe(sir, 'parses /my-cosmos/code-1/main/src/index.ts with branch and deep filePath', async () => {
+            const route = parseSpaceGibRoute('/my-cosmos/code-1/main/src/index.ts');
+            iReckon(sir, route.kind).willEqual('galaxy');
+            const g = route as GalaxyRouteInfo;
+            iReckon(sir, g.cosmos).willEqual('my-cosmos');
+            iReckon(sir, g.galaxy).willEqual('code-1');
+            iReckon(sir, g.topology).willEqual('branching');
+            iReckon(sir, g.branch).willEqual('main');
+            iReckon(sir, g.filePath).willEqual('src/index.ts');
+        });
+
+        await ifWe(sir, 'parses /@bill/my-cosmos/code-1/feat-x/src/deep/nested/file.mts with tenant and deep path', async () => {
+            const route = parseSpaceGibRoute('/@bill/my-cosmos/code-1/feat-x/src/deep/nested/file.mts');
+            iReckon(sir, route.kind).willEqual('galaxy');
+            const g = route as GalaxyRouteInfo;
+            const tenant = g.tenant;
             iReckon(sir, tenant?.type).willEqual('username');
             if (tenant && tenant.type === 'username') {
                 iReckon(sir, tenant.siteUsername).willEqual('bill');
             }
-            iReckon(sir, cg.cosmos).willEqual('my-cosmos');
-            iReckon(sir, cg.galaxyId).willEqual('code-1');
-            iReckon(sir, cg.branch).willEqual('feat-x');
-            iReckon(sir, cg.filePath).willEqual('src/deep/nested/file.mts');
+            iReckon(sir, g.cosmos).willEqual('my-cosmos');
+            iReckon(sir, g.galaxy).willEqual('code-1');
+            iReckon(sir, g.topology).willEqual('branching');
+            iReckon(sir, g.branch).willEqual('feat-x');
+            iReckon(sir, g.filePath).willEqual('src/deep/nested/file.mts');
         });
     });
 
-    await respecfully(sir, 'Notes Galaxy Routes', async () => {
-        await ifWe(sir, 'parses /my-cosmos/notes/notes-1 with galaxyId', async () => {
-            const route = parseSpaceGibRoute('/my-cosmos/notes/notes-1');
-            iReckon(sir, route.kind).willEqual('notes-galaxy');
-            const ng = route as NotesGalaxyRouteInfo;
-            iReckon(sir, ng.cosmos).willEqual('my-cosmos');
-            iReckon(sir, ng.galaxyId).willEqual('notes-1');
-            iReckon(sir, ng.topicTjp).willEqual(undefined);
-        });
-
-        await ifWe(sir, 'parses /my-cosmos/notes/notes-1/topic_abc with topicTjp', async () => {
-            const route = parseSpaceGibRoute('/my-cosmos/notes/notes-1/topic_abc');
-            iReckon(sir, route.kind).willEqual('notes-galaxy');
-            const ng = route as NotesGalaxyRouteInfo;
-            iReckon(sir, ng.cosmos).willEqual('my-cosmos');
-            iReckon(sir, ng.galaxyId).willEqual('notes-1');
-            iReckon(sir, ng.topicTjp).willEqual('topic_abc');
-        });
-
-        await ifWe(sir, 'parses /@bill/my-cosmos/notes/notes-1/topic_abc with tenant and topicTjp', async () => {
-            const route = parseSpaceGibRoute('/@bill/my-cosmos/notes/notes-1/topic_abc');
-            iReckon(sir, route.kind).willEqual('notes-galaxy');
-            const ng = route as NotesGalaxyRouteInfo;
-            const tenant = ng.tenant;
+    await respecfully(sir, 'Universal Galaxy Routes (Linear / Notes Archetype)', async () => {
+        await ifWe(sir, 'parses /my-cosmos/notes-1 with galaxy', async () => {
+            const route = parseSpaceGibRoute('/my-cosmos/notes-1');
+            iReckon(sir, route.kind).willEqual('galaxy');
+            const g = route as GalaxyRouteInfo;
+            iReckon(sir, g.cosmos).willEqual('my-cosmos');
+            iReckon(sir, g.galaxy).willEqual('notes-1');
+            iReckon(sir, g.topology).willEqual('linear');
+            iReckon(sir, g.topicTjp).willEqual(undefined);
+        });
+
+        await ifWe(sir, 'parses /my-cosmos/notes-1/topic_abc with topicTjp shorthand', async () => {
+            const route = parseSpaceGibRoute('/my-cosmos/notes-1/topic_abc');
+            iReckon(sir, route.kind).willEqual('galaxy');
+            const g = route as GalaxyRouteInfo;
+            iReckon(sir, g.cosmos).willEqual('my-cosmos');
+            iReckon(sir, g.galaxy).willEqual('notes-1');
+            iReckon(sir, g.topology).willEqual('linear');
+            iReckon(sir, g.topicTjp).willEqual('topic_abc');
+        });
+
+        await ifWe(sir, 'parses /@bill/my-cosmos/notes-1/topic_abc with tenant and topicTjp', async () => {
+            const route = parseSpaceGibRoute('/@bill/my-cosmos/notes-1/topic_abc');
+            iReckon(sir, route.kind).willEqual('galaxy');
+            const g = route as GalaxyRouteInfo;
+            const tenant = g.tenant;
             iReckon(sir, tenant?.type).willEqual('username');
             if (tenant && tenant.type === 'username') {
                 iReckon(sir, tenant.siteUsername).willEqual('bill');
             }
-            iReckon(sir, ng.cosmos).willEqual('my-cosmos');
-            iReckon(sir, ng.galaxyId).willEqual('notes-1');
-            iReckon(sir, ng.topicTjp).willEqual('topic_abc');
-            iReckon(sir, ng.trailMode).willEqual('tjp');
-            iReckon(sir, ng.trail?.length).willEqual(1);
-            iReckon(sir, ng.trail?.[0]).willEqual('topic_abc');
-        });
-
-        await ifWe(sir, 'parses /@bill/my-cosmos/notes/notes-1/tjp/topic_1/reply_2/reply_3 as n-depth tjp trail', async () => {
-            const route = parseSpaceGibRoute('/@bill/my-cosmos/notes/notes-1/tjp/topic_1/reply_2/reply_3');
-            iReckon(sir, route.kind).willEqual('notes-galaxy');
-            const ng = route as NotesGalaxyRouteInfo;
-            iReckon(sir, ng.cosmos).willEqual('my-cosmos');
-            iReckon(sir, ng.galaxyId).willEqual('notes-1');
-            iReckon(sir, ng.trailMode).willEqual('tjp');
-            iReckon(sir, ng.trail?.length).willEqual(3);
-            iReckon(sir, ng.trail?.[0]).willEqual('topic_1');
-            iReckon(sir, ng.trail?.[1]).willEqual('reply_2');
-            iReckon(sir, ng.trail?.[2]).willEqual('reply_3');
-            iReckon(sir, ng.topicTjp).willEqual('topic_1');
-        });
-
-        await ifWe(sir, 'parses /my-cosmos/notes/notes-1/addr/hash1/hash2 as n-depth reified addr trail', async () => {
-            const route = parseSpaceGibRoute('/my-cosmos/notes/notes-1/addr/hash1/hash2');
-            iReckon(sir, route.kind).willEqual('notes-galaxy');
-            const ng = route as NotesGalaxyRouteInfo;
-            iReckon(sir, ng.cosmos).willEqual('my-cosmos');
-            iReckon(sir, ng.galaxyId).willEqual('notes-1');
-            iReckon(sir, ng.trailMode).willEqual('addr');
-            iReckon(sir, ng.trail?.length).willEqual(2);
-            iReckon(sir, ng.trail?.[0]).willEqual('hash1');
-            iReckon(sir, ng.trail?.[1]).willEqual('hash2');
+            iReckon(sir, g.cosmos).willEqual('my-cosmos');
+            iReckon(sir, g.galaxy).willEqual('notes-1');
+            iReckon(sir, g.topology).willEqual('linear');
+            iReckon(sir, g.topicTjp).willEqual('topic_abc');
+            iReckon(sir, g.trailMode).willEqual('tjp');
+            iReckon(sir, g.trail?.length).willEqual(1);
+            iReckon(sir, g.trail?.[0]).willEqual('topic_abc');
+        });
+
+        await ifWe(sir, 'parses /@bill/my-cosmos/notes-1/tjp/topic_1/reply_2/reply_3 as n-depth tjp trail', async () => {
+            const route = parseSpaceGibRoute('/@bill/my-cosmos/notes-1/tjp/topic_1/reply_2/reply_3');
+            iReckon(sir, route.kind).willEqual('galaxy');
+            const g = route as GalaxyRouteInfo;
+            iReckon(sir, g.cosmos).willEqual('my-cosmos');
+            iReckon(sir, g.galaxy).willEqual('notes-1');
+            iReckon(sir, g.topology).willEqual('linear');
+            iReckon(sir, g.trailMode).willEqual('tjp');
+            iReckon(sir, g.trail?.length).willEqual(3);
+            iReckon(sir, g.trail?.[0]).willEqual('topic_1');
+            iReckon(sir, g.trail?.[1]).willEqual('reply_2');
+            iReckon(sir, g.trail?.[2]).willEqual('reply_3');
+            iReckon(sir, g.topicTjp).willEqual('reply_3');
+        });
+
+        await ifWe(sir, 'parses /my-cosmos/notes-1/addr/hash1/hash2 as n-depth reified addr trail', async () => {
+            const route = parseSpaceGibRoute('/my-cosmos/notes-1/addr/hash1/hash2');
+            iReckon(sir, route.kind).willEqual('galaxy');
+            const g = route as GalaxyRouteInfo;
+            iReckon(sir, g.cosmos).willEqual('my-cosmos');
+            iReckon(sir, g.galaxy).willEqual('notes-1');
+            iReckon(sir, g.topology).willEqual('linear');
+            iReckon(sir, g.trailMode).willEqual('addr');
+            iReckon(sir, g.trail?.length).willEqual(2);
+            iReckon(sir, g.trail?.[0]).willEqual('hash1');
+            iReckon(sir, g.trail?.[1]).willEqual('hash2');
         });
 
         await ifWe(sir, 'parses query params for right-panel inspector and lenses', async () => {
-            const route = parseSpaceGibRoute('/@bill/my-cosmos/notes/notes-1/tjp/topic_1?inspect=src%2Findex.ts%23L10&lens=issues');
-            iReckon(sir, route.kind).willEqual('notes-galaxy');
-            const ng = route as NotesGalaxyRouteInfo;
-            iReckon(sir, ng.query?.inspect).willEqual('src/index.ts#L10');
-            iReckon(sir, ng.query?.lens).willEqual('issues');
+            const route = parseSpaceGibRoute('/@bill/my-cosmos/notes-1/tjp/topic_1?inspect=src%2Findex.ts%23L10&lens=issues');
+            iReckon(sir, route.kind).willEqual('galaxy');
+            const g = route as GalaxyRouteInfo;
+            iReckon(sir, g.query?.inspect).willEqual('src/index.ts#L10');
+            iReckon(sir, g.query?.lens).willEqual('issues');
+        });
+    });
+
+    await respecfully(sir, 'Fail-Fast Legacy Route Rejection', async () => {
+        await ifWe(sir, 'rejects obsolete /code/ intermediate segment', async () => {
+            let threw = false;
+            let errorMsg = '';
+            try {
+                parseSpaceGibRoute('/my-cosmos/code/code-1');
+            } catch (e: any) {
+                threw = true;
+                errorMsg = e.message;
+            }
+            iReckon(sir, threw).willEqual(true);
+            iReckon(sir, errorMsg.includes('Legacy route rejected')).willEqual(true);
+            iReckon(sir, errorMsg.includes('FAIL FAST')).willEqual(true);
+        });
+
+        await ifWe(sir, 'rejects obsolete /notes/ intermediate segment', async () => {
+            let threw = false;
+            let errorMsg = '';
+            try {
+                parseSpaceGibRoute('/my-cosmos/notes/notes-1');
+            } catch (e: any) {
+                threw = true;
+                errorMsg = e.message;
+            }
+            iReckon(sir, threw).willEqual(true);
+            iReckon(sir, errorMsg.includes('Legacy route rejected')).willEqual(true);
+            iReckon(sir, errorMsg.includes('FAIL FAST')).willEqual(true);
+        });
+
+        await ifWe(sir, 'rejects tenant-prefixed legacy /code/ route', async () => {
+            let threw = false;
+            let errorMsg = '';
+            try {
+                parseSpaceGibRoute('/@bill/my-cosmos/code/code-1/main');
+            } catch (e: any) {
+                threw = true;
+                errorMsg = e.message;
+            }
+            iReckon(sir, threw).willEqual(true);
+            iReckon(sir, errorMsg.includes('Legacy route rejected')).willEqual(true);
+        });
+    });
+
+    await respecfully(sir, 'Option B: Cosmos Manifest Policy Retrieval', async () => {
+        const mockCosmos: CosmosIbGib_V1 = {
+            ib: 'cosmos mock',
+            gib: 'gib_mock',
+            data: {
+                cosmosName: 'custom-cosmos',
+                uuid: 'u-1',
+                timestamp: '2026-09-18T00:00:00Z',
+                galaxies: {
+                    'custom-canvas': {
+                        galaxyName: 'custom-canvas',
+                        discriminator: 'canvas',
+                        policy: {
+                            role: 'intrinsic',
+                            topology: 'branching',
+                            storageMode: 'text',
+                        },
+                    },
+                    'custom-chat': {
+                        galaxyName: 'custom-chat',
+                        discriminator: 'chat',
+                        policy: {
+                            role: 'extrinsic',
+                            topology: 'linear',
+                            storageMode: 'text',
+                        },
+                    },
+                },
+            },
+            rel8ns: {},
+        };
+
+        await ifWe(sir, 'resolves custom branching galaxy from cosmos manifest', async () => {
+            const route = parseSpaceGibRoute('/custom-cosmos/custom-canvas/branchA/canvas.json', { cosmosManifest: mockCosmos });
+            iReckon(sir, route.kind).willEqual('galaxy');
+            const g = route as GalaxyRouteInfo;
+            iReckon(sir, g.galaxy).willEqual('custom-canvas');
+            iReckon(sir, g.topology).willEqual('branching');
+            iReckon(sir, g.discriminator).willEqual('canvas');
+            iReckon(sir, g.branch).willEqual('branchA');
+            iReckon(sir, g.filePath).willEqual('canvas.json');
+        });
+
+        await ifWe(sir, 'resolves custom linear galaxy from cosmos manifest', async () => {
+            const route = parseSpaceGibRoute('/custom-cosmos/custom-chat/tjp/topicA/msg1', { cosmosManifest: mockCosmos });
+            iReckon(sir, route.kind).willEqual('galaxy');
+            const g = route as GalaxyRouteInfo;
+            iReckon(sir, g.galaxy).willEqual('custom-chat');
+            iReckon(sir, g.topology).willEqual('linear');
+            iReckon(sir, g.discriminator).willEqual('chat');
+            iReckon(sir, g.trailMode).willEqual('tjp');
+            iReckon(sir, g.trail?.length).willEqual(2);
+            iReckon(sir, g.trail?.[0]).willEqual('topicA');
+            iReckon(sir, g.trail?.[1]).willEqual('msg1');
         });
     });
 
@@ -299,16 +410,16 @@ await respecfully(sir, 'SpaceGibRouterHelpers specs', async () => {
             { kind: 'polycosmos', tenant: { type: 'keystone', keystoneTjp: 'tjp_genesis' } },
             { kind: 'cosmos', cosmos: 'cosmos-alpha' },
             { kind: 'cosmos', tenant: { type: 'username', siteUsername: 'bill' }, cosmos: 'cosmos-alpha' },
-            { kind: 'code-galaxy', cosmos: 'my-cosmos', galaxyId: 'code-1' },
-            { kind: 'code-galaxy', cosmos: 'my-cosmos', galaxyId: 'code-1', branch: 'main' },
-            { kind: 'code-galaxy', cosmos: 'my-cosmos', galaxyId: 'code-1', branch: 'main', filePath: 'src/core/index.ts' },
-            { kind: 'code-galaxy', tenant: { type: 'username', siteUsername: 'bill' }, cosmos: 'my-cosmos', galaxyId: 'code-1', branch: 'dev', filePath: 'lib/utils.ts' },
-            { kind: 'notes-galaxy', cosmos: 'my-cosmos', galaxyId: 'notes-1' },
-            { kind: 'notes-galaxy', cosmos: 'my-cosmos', galaxyId: 'notes-1', topicTjp: 'topic_welcome', trailMode: 'tjp', trail: ['topic_welcome'] },
-            { kind: 'notes-galaxy', tenant: { type: 'username', siteUsername: 'bill' }, cosmos: 'my-cosmos', galaxyId: 'notes-1', topicTjp: 'topic_welcome', trailMode: 'tjp', trail: ['topic_welcome'] },
-            { kind: 'notes-galaxy', cosmos: 'my-cosmos', galaxyId: 'notes-1', topicTjp: 't1', trailMode: 'tjp', trail: ['t1', 't2', 't3'] },
-            { kind: 'notes-galaxy', cosmos: 'my-cosmos', galaxyId: 'notes-1', trailMode: 'addr', trail: ['a1', 'a2'] },
-            { kind: 'notes-galaxy', cosmos: 'my-cosmos', galaxyId: 'notes-1', topicTjp: 't1', trailMode: 'tjp', trail: ['t1'], query: { inspect: 'src/index.ts#L10', lens: 'issues' } },
+            { kind: 'galaxy', cosmos: 'my-cosmos', galaxy: 'code-1', topology: 'branching' },
+            { kind: 'galaxy', cosmos: 'my-cosmos', galaxy: 'code-1', topology: 'branching', branch: 'main' },
+            { kind: 'galaxy', cosmos: 'my-cosmos', galaxy: 'code-1', topology: 'branching', branch: 'main', filePath: 'src/core/index.ts' },
+            { kind: 'galaxy', tenant: { type: 'username', siteUsername: 'bill' }, cosmos: 'my-cosmos', galaxy: 'code-1', topology: 'branching', branch: 'dev', filePath: 'lib/utils.ts' },
+            { kind: 'galaxy', cosmos: 'my-cosmos', galaxy: 'notes-1', topology: 'linear' },
+            { kind: 'galaxy', cosmos: 'my-cosmos', galaxy: 'notes-1', topology: 'linear', topicTjp: 'topic_welcome', trailMode: 'tjp', trail: ['topic_welcome'] },
+            { kind: 'galaxy', tenant: { type: 'username', siteUsername: 'bill' }, cosmos: 'my-cosmos', galaxy: 'notes-1', topology: 'linear', topicTjp: 'topic_welcome', trailMode: 'tjp', trail: ['topic_welcome'] },
+            { kind: 'galaxy', cosmos: 'my-cosmos', galaxy: 'notes-1', topology: 'linear', topicTjp: 't3', trailMode: 'tjp', trail: ['t1', 't2', 't3'] },
+            { kind: 'galaxy', cosmos: 'my-cosmos', galaxy: 'notes-1', topology: 'linear', trailMode: 'addr', trail: ['a1', 'a2'] },
+            { kind: 'galaxy', cosmos: 'my-cosmos', galaxy: 'notes-1', topology: 'linear', topicTjp: 't1', trailMode: 'tjp', trail: ['t1'], query: { inspect: 'src/index.ts#L10', lens: 'issues' } },
             { kind: 'raw-addr', cosmos: 'my-cosmos', spaceId: 'branch_space_main', ibGibAddr: 'comment hello world^gib_1' },
             { kind: 'raw-addr', tenant: { type: 'username', siteUsername: 'bill' }, cosmos: 'my-cosmos', spaceId: 'branch_space_main', ibGibAddr: 'comment hello world^gib_1' },
             { kind: 'raw-tjp', cosmos: 'my-cosmos', spaceId: 'branch_space_main', tjpAddr: 'tjp_dna_123' },
@@ -327,15 +438,15 @@ await respecfully(sir, 'SpaceGibRouterHelpers specs', async () => {
 
     await respecfully(sir, 'Edge Cases & Robustness', async () => {
         await ifWe(sir, 'handles trailing slashes', async () => {
-            const route = parseSpaceGibRoute('/my-cosmos/code/code-1/');
-            iReckon(sir, route.kind).willEqual('code-galaxy');
-            iReckon(sir, (route as CodeGalaxyRouteInfo).galaxyId).willEqual('code-1');
+            const route = parseSpaceGibRoute('/my-cosmos/code-1/');
+            iReckon(sir, route.kind).willEqual('galaxy');
+            iReckon(sir, (route as GalaxyRouteInfo).galaxy).willEqual('code-1');
         });
 
         await ifWe(sir, 'strips query parameters', async () => {
-            const route = parseSpaceGibRoute('/my-cosmos/code/code-1?branch=main&debug=true');
-            iReckon(sir, route.kind).willEqual('code-galaxy');
-            iReckon(sir, (route as CodeGalaxyRouteInfo).galaxyId).willEqual('code-1');
+            const route = parseSpaceGibRoute('/my-cosmos/code-1?branch=main&debug=true');
+            iReckon(sir, route.kind).willEqual('galaxy');
+            iReckon(sir, (route as GalaxyRouteInfo).galaxy).willEqual('code-1');
         });
 
         await ifWe(sir, 'strips hash fragments', async () => {
@@ -345,9 +456,74 @@ await respecfully(sir, 'SpaceGibRouterHelpers specs', async () => {
         });
 
         await ifWe(sir, 'handles multiple consecutive slashes gracefully', async () => {
-            const route = parseSpaceGibRoute('///my-cosmos///code///code-1///');
-            iReckon(sir, route.kind).willEqual('code-galaxy');
-            iReckon(sir, (route as CodeGalaxyRouteInfo).galaxyId).willEqual('code-1');
+            const route = parseSpaceGibRoute('///my-cosmos///code-1///');
+            iReckon(sir, route.kind).willEqual('galaxy');
+            iReckon(sir, (route as GalaxyRouteInfo).galaxy).willEqual('code-1');
+        });
+    });
+
+    await respecfully(sir, 'SpaceGibRouterService Subclass Specs', async () => {
+        await ifWeMight(sir, 'provides singleton subclassing IbGibCosmosRouterServiceBase and IbGibRouterServiceBase', async () => {
+            const router = getSpaceGibRouterSvc();
+            iReckon(sir, router instanceof SpaceGibRouterService).isGonnaBe(true);
+            iReckon(sir, router instanceof IbGibRouterServiceBase).isGonnaBe(true);
+            iReckon(sir, router instanceof IbGibCosmosRouterServiceBase).isGonnaBe(true);
+        });
+
+        await ifWeMight(sir, 'parses, formats and navigates cleanly via cosmos base class', async () => {
+            const router = getSpaceGibRouterSvc();
+            const received: SpaceGibRouteInfo[] = [];
+            const unsubscribe = router.subscribe(async (r) => {
+                received.push(r);
+            });
+
+            await router.navigate({
+                kind: 'galaxy',
+                cosmos: 'test-cosmos',
+                galaxy: 'notes-1',
+                topology: 'linear',
+            });
+
+            iReckon(sir, router.getCurrentRoute()?.kind).willEqual('galaxy');
+            iReckon(sir, (router.getCurrentRoute() as GalaxyRouteInfo).galaxy).willEqual('notes-1');
+            iReckon(sir, received.length > 0).isGonnaBe(true);
+
+            unsubscribe();
+        });
+
+        await ifWeMight(sir, 'auto-loads galaxy policy from manifest registered on router', async () => {
+            const router = getSpaceGibRouterSvc();
+            const mockManifest: CosmosIbGib_V1 = {
+                ib: 'cosmos test-auto-cosmos',
+                data: {
+                    cosmosName: 'test-auto-cosmos',
+                    galaxies: {
+                        'auto-canvas': {
+                            galaxyName: 'auto-canvas',
+                            discriminator: 'canvas',
+                            policy: {
+                                topology: 'branching',
+                                role: 'intrinsic',
+                                storageMode: 'text',
+                            },
+                        },
+                    },
+                },
+                rel8ns: {},
+            };
+            router.setCosmosManifest('test-auto-cosmos', mockManifest);
+
+            const received: SpaceGibRouteInfo[] = [];
+            const unsubscribe = router.subscribe((r) => { received.push(r); });
+
+            await router.navigatePath('/test-auto-cosmos/auto-canvas/branchX/art.png');
+
+            const current = router.getCurrentRoute() as GalaxyRouteInfo;
+            iReckon(sir, current.kind).willEqual('galaxy');
+            iReckon(sir, current.topology).willEqual('branching');
+            iReckon(sir, current.discriminator).willEqual('canvas');
+
+            unsubscribe();
         });
     });
 });