diff --git a/apps/desktop/e2e/app.spec.ts b/apps/desktop/e2e/app.spec.ts
index 59bbd6a5..6bd333b0 100644
--- a/apps/desktop/e2e/app.spec.ts
+++ b/apps/desktop/e2e/app.spec.ts
@@ -1138,6 +1138,9 @@ test('the first start walks through SolidCraft, assistant, printer and project f
await setup.getByTestId('first-start-next').click();
await expect(setup).toHaveAttribute('data-step', 'assistant');
await expect(setup.getByRole('radio', { name: /^Claude Code/ })).toBeChecked();
+ // Signed in, the step says so; the model per step waits folded under "Advanced" (usability U-01).
+ await expect(setup.getByTestId('agent-detail')).toContainText('Signed in');
+ await expect(setup.getByTestId('first-start-models')).not.toHaveAttribute('open');
await setup.getByTestId('first-start-next').click();
await expect(setup).toHaveAttribute('data-step', 'print');
await setup.getByTestId('printer-name').getByRole('textbox').fill('Werkstatt');
@@ -1472,7 +1475,7 @@ test('the assistant shows the signed-in plan and needs SolidCraft', async () =>
// The plan's default model with a named effort; the plan itself is in the menu.
await expect(chip).toHaveText('Claude Code · Opus 9 · Medium');
await chip.click();
- await expect(page.getByTestId('agent-detail')).toHaveText('Claude Code 9.9.9 · Claude subscription');
+ await expect(page.getByTestId('agent-detail')).toHaveText('Signed in · Claude Code 9.9.9 · Claude subscription');
await expect(page.getByRole('radio', { name: /^Claude Code/ })).toBeChecked();
await page.screenshot({ path: test.info().outputPath('agent-menu.png') });
await page.keyboard.press('Escape');
diff --git a/apps/desktop/e2e/solidcraft.contract.spec.ts b/apps/desktop/e2e/solidcraft.contract.spec.ts
index b746cab7..2c53b413 100644
--- a/apps/desktop/e2e/solidcraft.contract.spec.ts
+++ b/apps/desktop/e2e/solidcraft.contract.spec.ts
@@ -1271,6 +1271,42 @@ test('a failed turn says why: the plan used up until a time, no connection, or t
}
});
+test('on an empty start page "Describe a part" opens a new project with the chat ready to type (usability U-06, U-11)', async () => {
+ const { mkdtempSync, rmSync } = await import('node:fs');
+ const { tmpdir } = await import('node:os');
+ const { join } = await import('node:path');
+ const work = mkdtempSync(join(tmpdir(), 'partbuddy-describe-'));
+ const launched = await launchApp({
+ isolated: false,
+ work,
+ env: {
+ SOLIDCRAFT_CONTROL_DIR: join(work, 'control'),
+ PARTBUDDY_SOLIDCRAFT_PORT: '7902',
+ PARTBUDDY_PROJECTS_DIR: join(work, 'projects'),
+ PARTBUDDY_START_PAGE: '1',
+ PARTBUDDY_KEYRING_SERVICE: 'PartBuddy-e2e',
+ PARTBUDDY_CLAUDE_COMMAND: JSON.stringify([process.execPath, join(__dirname, '..', 'test', 'fakeClaude.mjs')]),
+ },
+ });
+ const { page } = launched;
+ try {
+ await expect(page.getByTestId('connection-status')).toHaveAttribute('data-engine', 'headless', { timeout: 30_000 });
+ const home = page.getByTestId('home-page');
+ // The start page is no project: no name, no printer or print light in the bars.
+ await expect(page.getByTestId('project-menu')).toHaveCount(0);
+ await expect(page.getByTestId('material-chip')).toHaveCount(0);
+ await page.screenshot({ path: test.info().outputPath('home-empty.png') });
+ await home.getByTestId('home-describe').click();
+ await expect(home).toHaveCount(0);
+ await expect(page.getByTestId('design-name')).toHaveText('New part', { timeout: 30_000 });
+ await expect(page.getByRole('textbox', { name: 'Message to the assistant' })).toBeFocused();
+ await expect(page.getByTestId('material-chip')).toBeVisible();
+ } finally {
+ await launched.close();
+ rmSync(work, { recursive: true, force: true, maxRetries: 10, retryDelay: 500 });
+ }
+});
+
test('PartBuddy starts on the start page with no project open; a saved part gets a preview, and tiles open and import projects (B3)', async () => {
test.setTimeout(240_000);
const { copyFileSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync } = await import('node:fs');
diff --git a/apps/desktop/src/renderer/src/assistant/AgentChip.tsx b/apps/desktop/src/renderer/src/assistant/AgentChip.tsx
index c22837f5..ef85e1a4 100644
--- a/apps/desktop/src/renderer/src/assistant/AgentChip.tsx
+++ b/apps/desktop/src/renderer/src/assistant/AgentChip.tsx
@@ -233,7 +233,8 @@ function ModelChoiceSection({ status }: { status: AgentStatus }) {
* The assistant's route, model and effort, and its sign-in state (B1); in the chip's menu and in the
* settings (B6).
*/
-export function AssistantChoice() {
+/** `setup`: the first start, where the model choice waits folded under "Advanced" (usability U-01). */
+export function AssistantChoice({ setup = false }: { setup?: boolean }) {
const { t } = useTranslation();
const state = useAssistant((s) => s.state);
const status = selectedStatus(state);
@@ -261,7 +262,16 @@ export function AssistantChoice() {
))}
- {t('firstStart.models')}
+
{t('home.emptyTitle')}
{t('home.emptyBody')}
+ {/* The way to a first part for someone new: a project, and the chat ready to type (usability U-06). */} +{t('firstStart.assistant')}
-