github-issue-tower-defence-management 1.146.0 → 1.146.2

package/src/adapter/entry-points/console/consoleOperationApi.ts

@@ -22,8 +22,12 @@ export type ConsoleProjectResolver = (
 
 export type ConsolePjcodeValidator = (pjcode: string) => boolean;
 
+export type ConsoleIssueRepositoryResolver = (
+  issueOrPullRequestUrl: string,
+) => IssueRepository;
+
 export type ConsoleOperationContext = {
-  issueRepository: IssueRepository;
+  resolveIssueRepository: ConsoleIssueRepositoryResolver;
   resolveProject: ConsoleProjectResolver;
   isPjcodeConfigured: ConsolePjcodeValidator;
   consoleDataOutputDir: string | null;
@@ -210,9 +214,11 @@ export const handleReview = async (
     if (typeof pjcodeResult !== 'string') {
       return pjcodeResult;
     }
-    await context.issueRepository.closePullRequest(prUrl);
+    await context.resolveIssueRepository(prUrl).closePullRequest(prUrl);
     if (isNonEmptyString(body.commentBody)) {
-      await context.issueRepository.createCommentByUrl(prUrl, body.commentBody);
+      await context
+        .resolveIssueRepository(prUrl)
+        .createCommentByUrl(prUrl, body.commentBody);
     }
     recordDone(context, pjcodeResult, projectItemId);
     return ok();
@@ -225,9 +231,9 @@ export const handleReview = async (
   const { project, pjcode } = binding;
 
   if (action === 'approve') {
-    await context.issueRepository.approvePullRequest(prUrl);
+    await context.resolveIssueRepository(prUrl).approvePullRequest(prUrl);
     const failure = await updateStatusByName(
-      context.issueRepository,
+      context.resolveIssueRepository(prUrl),
       project,
       prUrl,
       projectItemId,
@@ -254,14 +260,16 @@ export const handleReview = async (
       isReviewCommentSide(body.side)
         ? { line: body.line, side: body.side }
         : null;
-    await context.issueRepository.requestChangesWithInlineComment(
-      prUrl,
-      changedFilePath,
-      commentBody,
-      inlineCommentLocation,
-    );
+    await context
+      .resolveIssueRepository(prUrl)
+      .requestChangesWithInlineComment(
+        prUrl,
+        changedFilePath,
+        commentBody,
+        inlineCommentLocation,
+      );
     const failure = await updateStatusByName(
-      context.issueRepository,
+      context.resolveIssueRepository(prUrl),
       project,
       prUrl,
       projectItemId,
@@ -300,18 +308,19 @@ export const handleTriage = async (
       return pjcodeResult;
     }
     if (isNonEmptyString(body.commentBody)) {
-      await context.issueRepository.createCommentByUrl(
-        issueUrl,
-        body.commentBody,
-      );
+      await context
+        .resolveIssueRepository(issueUrl)
+        .createCommentByUrl(issueUrl, body.commentBody);
     }
     if (isPullRequestUrl(issueUrl)) {
-      await context.issueRepository.closePullRequest(issueUrl);
+      await context.resolveIssueRepository(issueUrl).closePullRequest(issueUrl);
     } else {
-      await context.issueRepository.closeIssueByUrl(
-        issueUrl,
-        action === 'close_not_planned' ? 'not_planned' : 'completed',
-      );
+      await context
+        .resolveIssueRepository(issueUrl)
+        .closeIssueByUrl(
+          issueUrl,
+          action === 'close_not_planned' ? 'not_planned' : 'completed',
+        );
     }
     recordDone(context, pjcodeResult, projectItemId);
     return ok();
@@ -329,7 +338,7 @@ export const handleTriage = async (
       return badRequest('statusName is required for set_status');
     }
     const failure = await updateStatusByName(
-      context.issueRepository,
+      context.resolveIssueRepository(issueUrl),
       project,
       issueUrl,
       projectItemId,
@@ -350,11 +359,13 @@ export const handleTriage = async (
     if (project.story === null) {
       return badRequest('project does not have a story field');
     }
-    await context.issueRepository.updateStory(
-      { ...project, story: project.story },
-      projectItemReference(issueUrl, projectItemId),
-      storyOptionId,
-    );
+    await context
+      .resolveIssueRepository(issueUrl)
+      .updateStory(
+        { ...project, story: project.story },
+        projectItemReference(issueUrl, projectItemId),
+        storyOptionId,
+      );
     recordDone(context, pjcode, projectItemId);
     return ok();
   }
@@ -362,12 +373,9 @@ export const handleTriage = async (
   if (action === 'snooze_1day' || action === 'snooze_1week') {
     const days = action === 'snooze_1day' ? 1 : 7;
     const target = new Date(Date.now() + days * 24 * 60 * 60 * 1000);
-    await context.issueRepository.updateNextActionDate(
-      issueUrl,
-      project,
-      target,
-      projectItemId,
-    );
+    await context
+      .resolveIssueRepository(issueUrl)
+      .updateNextActionDate(issueUrl, project, target, projectItemId);
     recordDone(context, pjcode, projectItemId);
     return ok();
   }
@@ -387,9 +395,12 @@ export const handleComment = async (
   if (!isNonEmptyString(commentBody)) {
     return badRequest('body is required');
   }
-  await context.issueRepository.createCommentByUrl(url, commentBody);
-  const comments =
-    await context.issueRepository.getIssueOrPullRequestComments(url);
+  await context
+    .resolveIssueRepository(url)
+    .createCommentByUrl(url, commentBody);
+  const comments = await context
+    .resolveIssueRepository(url)
+    .getIssueOrPullRequestComments(url);
   const posted = comments[comments.length - 1] ?? null;
   return {
     statusCode: 200,
@@ -480,13 +491,9 @@ export const handleReviewComment = async (
     return badRequest('body is required');
   }
   try {
-    await context.issueRepository.createPullRequestReviewComment(
-      url,
-      path,
-      line,
-      side,
-      commentBody,
-    );
+    await context
+      .resolveIssueRepository(url)
+      .createPullRequestReviewComment(url, path, line, side, commentBody);
   } catch (error) {
     return badGateway(error instanceof Error ? error.message : 'unknown error');
   }
@@ -518,7 +525,7 @@ export const handleIntmux = async (
   }
   const { project, pjcode } = binding;
   const failure = await updateStatusByName(
-    context.issueRepository,
+    context.resolveIssueRepository(issueUrl),
     project,
     issueUrl,
     projectItemId,

package/src/adapter/entry-points/console/consoleProjectResolver.test.ts

@@ -9,33 +9,33 @@ import {
 describe('buildPjcodeToProjectUrl', () => {
   it('adds the default pjcode entry when it is not already present', () => {
     const mapping = buildPjcodeToProjectUrl(
-      'umino',
-      'https://github.com/orgs/umino/projects/1',
-      { xmile: 'https://github.com/orgs/xmile/projects/2' },
+      'acme',
+      'https://github.com/orgs/acme/projects/1',
+      { globex: 'https://github.com/orgs/globex/projects/2' },
     );
     expect(mapping).toEqual({
-      umino: 'https://github.com/orgs/umino/projects/1',
-      xmile: 'https://github.com/orgs/xmile/projects/2',
+      acme: 'https://github.com/orgs/acme/projects/1',
+      globex: 'https://github.com/orgs/globex/projects/2',
     });
   });
 
   it('keeps an explicit default pjcode entry from consoleProjects', () => {
     const mapping = buildPjcodeToProjectUrl(
-      'umino',
-      'https://github.com/orgs/umino/projects/1',
-      { umino: 'https://github.com/orgs/umino/projects/9' },
+      'acme',
+      'https://github.com/orgs/acme/projects/1',
+      { acme: 'https://github.com/orgs/acme/projects/9' },
     );
-    expect(mapping.umino).toBe('https://github.com/orgs/umino/projects/9');
+    expect(mapping.acme).toBe('https://github.com/orgs/acme/projects/9');
   });
 
   it('uses only the default entry when no consoleProjects mapping is configured', () => {
     const mapping = buildPjcodeToProjectUrl(
-      'umino',
-      'https://github.com/orgs/umino/projects/1',
+      'acme',
+      'https://github.com/orgs/acme/projects/1',
       null,
     );
     expect(mapping).toEqual({
-      umino: 'https://github.com/orgs/umino/projects/1',
+      acme: 'https://github.com/orgs/acme/projects/1',
     });
   });
 });
@@ -43,44 +43,44 @@ describe('buildPjcodeToProjectUrl', () => {
 describe('createPjcodeConfigChecker', () => {
   it('reports true only for a configured pjcode without loading any project', () => {
     const isConfigured = createPjcodeConfigChecker({
-      umino: 'https://github.com/orgs/umino/projects/1',
-      xmile: 'https://github.com/orgs/xmile/projects/2',
+      acme: 'https://github.com/orgs/acme/projects/1',
+      globex: 'https://github.com/orgs/globex/projects/2',
     });
-    expect(isConfigured('umino')).toBe(true);
-    expect(isConfigured('xmile')).toBe(true);
+    expect(isConfigured('acme')).toBe(true);
+    expect(isConfigured('globex')).toBe(true);
     expect(isConfigured('unknown')).toBe(false);
   });
 });
 
 describe('createConsoleProjectResolver', () => {
-  const uminoProject: Project = { ...mock<Project>(), id: 'PVT_umino' };
-  const xmileProject: Project = { ...mock<Project>(), id: 'PVT_xmile' };
+  const acmeProject: Project = { ...mock<Project>(), id: 'PVT_acme' };
+  const globexProject: Project = { ...mock<Project>(), id: 'PVT_globex' };
 
   it('resolves a known pjcode to its loaded project', async () => {
     const loadProject = jest.fn(async (url: string) =>
-      url.includes('umino') ? uminoProject : xmileProject,
+      url.includes('acme') ? acmeProject : globexProject,
     );
     const resolver = createConsoleProjectResolver(
       {
-        umino: 'https://github.com/orgs/umino/projects/1',
-        xmile: 'https://github.com/orgs/xmile/projects/2',
+        acme: 'https://github.com/orgs/acme/projects/1',
+        globex: 'https://github.com/orgs/globex/projects/2',
       },
       loadProject,
     );
-    await expect(resolver('umino')).resolves.toEqual({
-      pjcode: 'umino',
-      project: uminoProject,
+    await expect(resolver('acme')).resolves.toEqual({
+      pjcode: 'acme',
+      project: acmeProject,
     });
-    await expect(resolver('xmile')).resolves.toEqual({
-      pjcode: 'xmile',
-      project: xmileProject,
+    await expect(resolver('globex')).resolves.toEqual({
+      pjcode: 'globex',
+      project: globexProject,
     });
   });
 
   it('returns null for a pjcode that has no configured project url', async () => {
-    const loadProject = jest.fn(async () => uminoProject);
+    const loadProject = jest.fn(async () => acmeProject);
     const resolver = createConsoleProjectResolver(
-      { umino: 'https://github.com/orgs/umino/projects/1' },
+      { acme: 'https://github.com/orgs/acme/projects/1' },
       loadProject,
     );
     await expect(resolver('unknown')).resolves.toBeNull();
@@ -90,20 +90,20 @@ describe('createConsoleProjectResolver', () => {
   it('returns null when the project fails to load', async () => {
     const loadProject = jest.fn(async () => null);
     const resolver = createConsoleProjectResolver(
-      { umino: 'https://github.com/orgs/umino/projects/1' },
+      { acme: 'https://github.com/orgs/acme/projects/1' },
       loadProject,
     );
-    await expect(resolver('umino')).resolves.toBeNull();
+    await expect(resolver('acme')).resolves.toBeNull();
   });
 
   it('loads each project at most once and serves later calls from cache', async () => {
-    const loadProject = jest.fn(async () => uminoProject);
+    const loadProject = jest.fn(async () => acmeProject);
     const resolver = createConsoleProjectResolver(
-      { umino: 'https://github.com/orgs/umino/projects/1' },
+      { acme: 'https://github.com/orgs/acme/projects/1' },
       loadProject,
     );
-    await resolver('umino');
-    await resolver('umino');
+    await resolver('acme');
+    await resolver('acme');
     expect(loadProject).toHaveBeenCalledTimes(1);
   });
 });

package/src/adapter/entry-points/console/dashboardComposeService.test.ts

@@ -22,8 +22,8 @@ describe('buildComposeDashboardInput', () => {
   it('reads every requested project code in order and yields null for absent files', () => {
     const dataDir = makeDataDir();
     try {
-      writeProject(dataDir, 'umino', {
-        pjcode: 'umino',
+      writeProject(dataDir, 'acme', {
+        pjcode: 'acme',
         capturedAt: 'x',
         unread: 3,
         todo: 1,
@@ -36,11 +36,11 @@ describe('buildComposeDashboardInput', () => {
       });
       const input = buildComposeDashboardInput({
         dashboardDataDir: dataDir,
-        projectNames: ['umino', 'xcare'],
+        projectNames: ['acme', 'initech'],
       });
       expect(input.projects).toEqual([
         {
-          code: 'um',
+          code: 'ac',
           row: {
             unread: 3,
             todo: 1,
@@ -52,7 +52,7 @@ describe('buildComposeDashboardInput', () => {
             blocker: 0,
           },
         },
-        { code: 'xc', row: null },
+        { code: 'in', row: null },
       ]);
     } finally {
       fs.rmSync(dataDir, { recursive: true, force: true });
@@ -62,10 +62,10 @@ describe('buildComposeDashboardInput', () => {
   it('treats a project file with a missing field as an absent row', () => {
     const dataDir = makeDataDir();
     try {
-      writeProject(dataDir, 'umino', { unread: 1, todo: 1 });
+      writeProject(dataDir, 'acme', { unread: 1, todo: 1 });
       const input = buildComposeDashboardInput({
         dashboardDataDir: dataDir,
-        projectNames: ['umino'],
+        projectNames: ['acme'],
       });
       expect(input.projects[0].row).toBeNull();
     } finally {
@@ -77,13 +77,10 @@ describe('buildComposeDashboardInput', () => {
     const dataDir = makeDataDir();
     try {
       fs.mkdirSync(path.join(dataDir, 'projects'), { recursive: true });
-      fs.writeFileSync(
-        path.join(dataDir, 'projects', 'umino.json'),
-        'not json',
-      );
+      fs.writeFileSync(path.join(dataDir, 'projects', 'acme.json'), 'not json');
       const input = buildComposeDashboardInput({
         dashboardDataDir: dataDir,
-        projectNames: ['umino'],
+        projectNames: ['acme'],
       });
       expect(input.projects[0].row).toBeNull();
     } finally {
@@ -365,8 +362,8 @@ describe('composeDashboardText', () => {
   it('composes the full byte-identical dashboard text from the data files', () => {
     const dataDir = makeDataDir();
     try {
-      writeProject(dataDir, 'umino', {
-        pjcode: 'umino',
+      writeProject(dataDir, 'acme', {
+        pjcode: 'acme',
         capturedAt: 'x',
         unread: 3,
         todo: 1,
@@ -409,14 +406,14 @@ describe('composeDashboardText', () => {
       expect(
         composeDashboardText({
           dashboardDataDir: dataDir,
-          projectNames: ['umino', 'xcare'],
+          projectNames: ['acme', 'initech'],
         }),
       ).toBe(
         '<tt>M55%&nbsp;C62%&nbsp;D89%&nbsp;cy14</tt><br>\n' +
           '<tt>LA&nbsp;16&nbsp;23&nbsp;40</tt><br>\n' +
           '<tt>pj&nbsp;&nbsp;&nbsp;unr&nbsp;tdo&nbsp;aqc&nbsp;fal&nbsp;prp&nbsp;aws&nbsp;dep</tt><br>\n' +
-          '<tt>🟢um&nbsp;&nbsp;&nbsp;3&nbsp;&nbsp;&nbsp;1&nbsp;&nbsp;&nbsp;2&nbsp;&nbsp;&nbsp;0&nbsp;&nbsp;&nbsp;0&nbsp;&nbsp;&nbsp;4&nbsp;&nbsp;&nbsp;1</tt><br>\n' +
-          '<tt>&nbsp;&nbsp;xc&nbsp;&nbsp;--&nbsp;&nbsp;--&nbsp;&nbsp;--&nbsp;&nbsp;--&nbsp;&nbsp;--&nbsp;&nbsp;--&nbsp;&nbsp;--</tt><br>\n' +
+          '<tt>🟢ac&nbsp;&nbsp;&nbsp;3&nbsp;&nbsp;&nbsp;1&nbsp;&nbsp;&nbsp;2&nbsp;&nbsp;&nbsp;0&nbsp;&nbsp;&nbsp;0&nbsp;&nbsp;&nbsp;4&nbsp;&nbsp;&nbsp;1</tt><br>\n' +
+          '<tt>&nbsp;&nbsp;in&nbsp;&nbsp;--&nbsp;&nbsp;--&nbsp;&nbsp;--&nbsp;&nbsp;--&nbsp;&nbsp;--&nbsp;&nbsp;--&nbsp;&nbsp;--</tt><br>\n' +
           '<tt></tt><br>\n' +
           '<tt>🟢alice&nbsp;&nbsp;10%&nbsp;0d01h00&nbsp;&nbsp;12%&nbsp;5d00h00&nbsp;2&nbsp;1</tt><br>\n',
       );
@@ -446,7 +443,7 @@ describe('dashboardComposeFilesPresent', () => {
   };
 
   const minimalProject = {
-    pjcode: 'umino',
+    pjcode: 'acme',
     capturedAt: 'x',
     unread: 0,
     todo: 0,
@@ -462,12 +459,15 @@ describe('dashboardComposeFilesPresent', () => {
     const dataDir = makeDataDir();
     try {
       writeMachineAndToken(dataDir);
-      writeProject(dataDir, 'umino', minimalProject);
-      writeProject(dataDir, 'xcare', { ...minimalProject, pjcode: 'xcare' });
+      writeProject(dataDir, 'acme', minimalProject);
+      writeProject(dataDir, 'initech', {
+        ...minimalProject,
+        pjcode: 'initech',
+      });
       expect(
         dashboardComposeFilesPresent({
           dashboardDataDir: dataDir,
-          projectNames: ['umino', 'xcare'],
+          projectNames: ['acme', 'initech'],
         }),
       ).toBe(true);
     } finally {
@@ -481,7 +481,7 @@ describe('dashboardComposeFilesPresent', () => {
       expect(
         dashboardComposeFilesPresent({
           dashboardDataDir: dataDir,
-          projectNames: ['umino'],
+          projectNames: ['acme'],
         }),
       ).toBe(false);
     } finally {
@@ -493,11 +493,11 @@ describe('dashboardComposeFilesPresent', () => {
     const dataDir = makeDataDir();
     try {
       writeMachineAndToken(dataDir);
-      writeProject(dataDir, 'umino', minimalProject);
+      writeProject(dataDir, 'acme', minimalProject);
       expect(
         dashboardComposeFilesPresent({
           dashboardDataDir: dataDir,
-          projectNames: ['umino', 'xcare'],
+          projectNames: ['acme', 'initech'],
         }),
       ).toBe(false);
     } finally {
@@ -512,11 +512,11 @@ describe('dashboardComposeFilesPresent', () => {
         path.join(dataDir, 'token-status.json'),
         JSON.stringify({ tokens: [], capturedAt: 'x' }),
       );
-      writeProject(dataDir, 'umino', minimalProject);
+      writeProject(dataDir, 'acme', minimalProject);
       expect(
         dashboardComposeFilesPresent({
           dashboardDataDir: dataDir,
-          projectNames: ['umino'],
+          projectNames: ['acme'],
         }),
       ).toBe(false);
     } finally {
@@ -538,11 +538,11 @@ describe('dashboardComposeFilesPresent', () => {
           capturedAt: 'x',
         }),
       );
-      writeProject(dataDir, 'umino', minimalProject);
+      writeProject(dataDir, 'acme', minimalProject);
       expect(
         dashboardComposeFilesPresent({
           dashboardDataDir: dataDir,
-          projectNames: ['umino'],
+          projectNames: ['acme'],
         }),
       ).toBe(false);
     } finally {

package/src/adapter/entry-points/console/dashboardEmitterComposerKey.test.ts

@@ -2,19 +2,23 @@ import * as fs from 'fs';
 import * as os from 'os';
 import * as path from 'path';
 import { Issue } from '../../../domain/entities/Issue';
-import {
-  DASHBOARD_PROJECT_NAMES,
-  toDashboardDisplayLabel,
-} from '../../../domain/usecases/dashboard/DashboardProjectCode';
+import { toDashboardDisplayLabel } from '../../../domain/usecases/dashboard/DashboardProjectCode';
 import { writeDashboardRow } from '../handlers/dashboardRowWriter';
 import {
   composeDashboardText,
   dashboardComposeFilesPresent,
 } from './dashboardComposeService';
-import { DEFAULT_DASHBOARD_PROJECT_NAMES } from './webServer';
 
 const ASSIGNEE = 'HiromiShikata';
 
+const CONFIGURED_PROJECT_NAMES = [
+  'acme',
+  'globex',
+  'initech',
+  'umbrella',
+  'soylent',
+];
+
 let issueCounter = 0;
 const makeIssue = (overrides: Partial<Issue>): Issue => {
   issueCounter += 1;
@@ -59,7 +63,7 @@ describe('dashboard emitter filename matches composer lookup key', () => {
     fs.rmSync(dir, { recursive: true, force: true });
   });
 
-  it.each(DASHBOARD_PROJECT_NAMES)(
+  it.each(CONFIGURED_PROJECT_NAMES)(
     'emits projects/%s.json under the full project name the composer reads',
     (projectName) => {
       writeDashboardRow({
@@ -80,7 +84,7 @@ describe('dashboard emitter filename matches composer lookup key', () => {
   );
 
   it('detects compose files present when every project name file exists', () => {
-    for (const projectName of DASHBOARD_PROJECT_NAMES) {
+    for (const projectName of CONFIGURED_PROJECT_NAMES) {
       writeDashboardRow({
         dashboardDataDir: dir,
         pjcode: projectName,
@@ -107,20 +111,20 @@ describe('dashboard emitter filename matches composer lookup key', () => {
     expect(
       dashboardComposeFilesPresent({
         dashboardDataDir: dir,
-        projectNames: DEFAULT_DASHBOARD_PROJECT_NAMES,
+        projectNames: CONFIGURED_PROJECT_NAMES,
       }),
     ).toBe(true);
   });
 
   it('composes the full grid with no fallback row and shows the 2-char display labels', () => {
     const issuesByName: Record<string, Issue[]> = {
-      umino: [makeIssue({ status: 'Unread' }), makeIssue({ status: 'Unread' })],
-      xmile: [makeIssue({ status: 'Awaiting Quality Check' })],
-      xcare: [makeIssue({ status: 'Awaiting Workspace' })],
-      utage3: [makeIssue({ status: 'Todo by human' })],
-      cmg: [makeIssue({ status: 'Preparation' })],
+      acme: [makeIssue({ status: 'Unread' }), makeIssue({ status: 'Unread' })],
+      globex: [makeIssue({ status: 'Awaiting Quality Check' })],
+      initech: [makeIssue({ status: 'Awaiting Workspace' })],
+      umbrella: [makeIssue({ status: 'Todo by human' })],
+      soylent: [makeIssue({ status: 'Preparation' })],
     };
-    for (const projectName of DASHBOARD_PROJECT_NAMES) {
+    for (const projectName of CONFIGURED_PROJECT_NAMES) {
       writeDashboardRow({
         dashboardDataDir: dir,
         pjcode: projectName,
@@ -146,7 +150,7 @@ describe('dashboard emitter filename matches composer lookup key', () => {
 
     const composed = composeDashboardText({
       dashboardDataDir: dir,
-      projectNames: DEFAULT_DASHBOARD_PROJECT_NAMES,
+      projectNames: CONFIGURED_PROJECT_NAMES,
     });
 
     const wrap = (line: string): string =>
@@ -157,18 +161,20 @@ describe('dashboard emitter filename matches composer lookup key', () => {
         wrap('LA 16 23 40'),
         wrap('pj   unr tdo aqc fal prp aws dep'),
         wrap(
-          `🟢${toDashboardDisplayLabel('umino')}   2   0   0   0   0   0   0`,
+          `🟢${toDashboardDisplayLabel('acme')}   2   0   0   0   0   0   0`,
+        ),
+        wrap(
+          `🟢${toDashboardDisplayLabel('globex')}   0   0   1   0   0   0   0`,
         ),
         wrap(
-          `🟢${toDashboardDisplayLabel('xmile')}   0   0   1   0   0   0   0`,
+          `🟢${toDashboardDisplayLabel('initech')}   0   0   0   0   0   1   0`,
         ),
         wrap(
-          `🟢${toDashboardDisplayLabel('xcare')}   0   0   0   0   0   1   0`,
+          `🟢${toDashboardDisplayLabel('umbrella')}   0   1   0   0   0   0   0`,
         ),
         wrap(
-          `🟢${toDashboardDisplayLabel('utage3')}   0   1   0   0   0   0   0`,
+          `🟢${toDashboardDisplayLabel('soylent')}   0   0   0   0   1   0   0`,
         ),
-        wrap(`🟢${toDashboardDisplayLabel('cmg')}   0   0   0   0   1   0   0`),
         wrap(''),
       ].join('\n') + '\n';
     expect(composed).toBe(expected);

package/src/adapter/entry-points/console/ensureConsoleRunning.test.ts

@@ -54,14 +54,20 @@ describe('ensureConsoleRunning', () => {
 
   it('should short-circuit and return null when the port already responds', async () => {
     const port = await startProbeServer();
-    const result = await ensureConsoleRunning('/path/to/config.yaml', port);
+    const result = await ensureConsoleRunning('/path/to/config.yaml', port, [
+      'acme',
+      'globex',
+    ]);
     expect(spawnCalls).toHaveLength(0);
     expect(result).toBeNull();
   });
 
   it('should spawn serveWeb when the port is unresponsive', async () => {
     const unusedPort = await findFreePort();
-    await ensureConsoleRunning('/path/to/config.yaml', unusedPort);
+    await ensureConsoleRunning('/path/to/config.yaml', unusedPort, [
+      'acme',
+      'globex',
+    ]);
 
     expect(spawnCalls).toHaveLength(1);
     const [program, args, options] = spawnCalls[0];
@@ -80,16 +86,27 @@ describe('ensureConsoleRunning', () => {
     if (!isObject(options)) {
       throw new Error('Expected spawn options to be an object');
     }
+    expect(args[6]).toBe('--dashboardProjectNames');
+    expect(args[7]).toBe('acme,globex');
     expect(options.detached).toBe(true);
     expect(options.stdio).toBe('ignore');
     expect(unrefMock).toHaveBeenCalledTimes(1);
   });
 
+  it('should refuse to start the console when no project name is configured', async () => {
+    const unusedPort = await findFreePort();
+    await expect(
+      ensureConsoleRunning('/path/to/config.yaml', unusedPort, []),
+    ).rejects.toThrow('consoleProjects is empty');
+    expect(spawnCalls).toHaveLength(0);
+  });
+
   it('should return an object with a kill method that delegates to the child process', async () => {
     const unusedPort = await findFreePort();
     const result = await ensureConsoleRunning(
       '/path/to/config.yaml',
       unusedPort,
+      ['acme', 'globex'],
     );
     expect(result).not.toBeNull();
     result?.kill();

package/src/adapter/entry-points/console/ensureConsoleRunning.ts

@@ -32,7 +32,13 @@ const sleep = (ms: number): Promise<void> =>
 export const ensureConsoleRunning = async (
   configFilePath: string,
   port: number,
+  dashboardProjectNames: string[],
 ): Promise<ConsoleProcess | null> => {
+  if (dashboardProjectNames.length === 0) {
+    throw new Error(
+      `Cannot start the console from ${configFilePath}: consoleProjects is empty, so the dashboard has no project to render`,
+    );
+  }
   if (await isPortResponding(port)) return null;
   const cliEntry = path.resolve(__dirname, '../cli/index.js');
   const child = spawn(
@@ -44,6 +50,8 @@ export const ensureConsoleRunning = async (
       configFilePath,
       '--port',
       String(port),
+      '--dashboardProjectNames',
+      dashboardProjectNames.join(','),
     ],
     {
       detached: true,