@pixelbyte-software/pixcode 1.54.10 → 1.55.0

package/scripts/github/create-vscode-workbench-issues.mjs

@@ -1,121 +1,121 @@
-#!/usr/bin/env node
-import { spawnSync } from 'node:child_process';
-
-const issues = [
-  {
-    title: 'feat(vscode-layout): audit existing open issues before workbench rollout',
-    body: `Reason
-The VS Code-style workbench should be delivered together with the current GitHub issue queue, not as an isolated local note.
-
-Scope
-- Read all currently open issues in alicomert/pixcode.
-- Mark which issues are directly affected by the VS Code workbench shell.
-- Keep unrelated issues open and untouched.
-- Add completion notes to related issues after implementation.
-
-Acceptance
-- Existing issues are reviewed before release.
-- Related issues receive implementation notes.
-- No unrelated issue is closed only because this work shipped.`,
-  },
-  {
-    title: 'feat(vscode-layout): add selectable VS Code-style workbench mode',
-    body: `Reason
-Users are more familiar with the VS Code workspace model, so Pixcode should offer a separate VS Code-style view without removing the existing experience.
-
-Scope
-- Add a persisted classic/vscode layout preference.
-- Keep the current Pixcode UI available.
-- Switch desktop users into the VS Code-style workbench when selected.
-- Leave mobile on the existing responsive shell.
-
-Acceptance
-- Users can choose between the existing Pixcode view and VS Code-style view.
-- The chosen mode persists between sessions.
-- Desktop users can enter the new workbench without changing provider/session behavior.`,
-  },
-  {
-    title: 'feat(vscode-layout): build left activity bar and explorer panels',
-    body: `Reason
-The left side should match the familiar VS Code model: activity buttons plus project/files/source-control/terminal panels.
-
-Scope
-- Add Explorer, Projects, Source Control, and Terminal activity buttons.
-- Reuse the existing Pixcode project/sidebar component for project and history access.
-- Reuse the existing file tree, git panel, and standalone shell.
-- Allow the left pane to collapse and resize.
-
-Acceptance
-- Project and session selection still works from the new shell.
-- File tree actions still open files.
-- Left pane can be resized and collapsed.`,
-  },
-  {
-    title: 'feat(vscode-layout): add central editor surface for files and system screens',
-    body: `Reason
-VS Code users expect file contents and code to live in the middle, while platform screens remain reachable without leaving the workbench.
-
-Scope
-- Open file tree selections in the central editor.
-- Reuse the existing CodeMirror editor and save/download behavior.
-- Render Control Room, Remote, Orchestration, Tasks, and plugin screens in the center when selected.
-- Keep the center area responsive between resizable side panes.
-
-Acceptance
-- Opening a file from Explorer shows it in the center.
-- System screens remain available inside the workbench.
-- The center pane remains usable while resizing side panes.`,
-  },
-  {
-    title: 'feat(vscode-layout): add right-side CLI work area for all providers',
-    body: `Reason
-The selected CLI should run in the right pane, similar to a focused agent/terminal side area in a three-column workbench.
-
-Scope
-- Reuse the current chat/CLI orchestration surface in the right pane.
-- Preserve Claude Code, Cursor, Codex, Gemini, Qwen Code, and OpenCode selection through existing provider controls.
-- Add a terminal tab in the right pane for shell work.
-- Allow the right pane to resize.
-
-Acceptance
-- Existing provider selection and send flow are reused.
-- The right pane can run CLI chat work and terminal work.
-- The pane can be resized without layout overlap.`,
-  },
-  {
-    title: 'feat(vscode-layout): expose layout at login and settings before release',
-    body: `Reason
-Users should be able to choose the new layout on entry and change it later without hunting through hidden configuration.
-
-Scope
-- Add layout selection to login.
-- Add layout selection to Appearance settings.
-- Add translations for supported locales.
-- Verify with smoke, typecheck, lint, and build.
-- Publish a release only after all issue notes are posted.
-
-Acceptance
-- Login includes Classic and VS Code workbench choices.
-- Appearance settings includes the same choices.
-- Locale coverage exists for all supported language files.
-- Release work starts only after verification is clean.`,
-  },
-];
-
-for (const issue of issues) {
-  const result = spawnSync(
-    'gh',
-    ['issue', 'create', '--repo', 'alicomert/pixcode', '--title', issue.title, '--body', issue.body],
-    {
-      stdio: 'inherit',
-      env: {
-        ...process.env,
-        GH_TOKEN: process.env.GITHUB_TOKEN || process.env.GH_TOKEN || '',
-      },
-    },
-  );
-
-  if (result.status !== 0) {
-    process.exit(result.status ?? 1);
-  }
-}
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+
+const issues = [
+  {
+    title: 'feat(vscode-layout): audit existing open issues before workbench rollout',
+    body: `Reason
+The VS Code-style workbench should be delivered together with the current GitHub issue queue, not as an isolated local note.
+
+Scope
+- Read all currently open issues in alicomert/pixcode.
+- Mark which issues are directly affected by the VS Code workbench shell.
+- Keep unrelated issues open and untouched.
+- Add completion notes to related issues after implementation.
+
+Acceptance
+- Existing issues are reviewed before release.
+- Related issues receive implementation notes.
+- No unrelated issue is closed only because this work shipped.`,
+  },
+  {
+    title: 'feat(vscode-layout): add selectable VS Code-style workbench mode',
+    body: `Reason
+Users are more familiar with the VS Code workspace model, so Pixcode should offer a separate VS Code-style view without removing the existing experience.
+
+Scope
+- Add a persisted classic/vscode layout preference.
+- Keep the current Pixcode UI available.
+- Switch desktop users into the VS Code-style workbench when selected.
+- Leave mobile on the existing responsive shell.
+
+Acceptance
+- Users can choose between the existing Pixcode view and VS Code-style view.
+- The chosen mode persists between sessions.
+- Desktop users can enter the new workbench without changing provider/session behavior.`,
+  },
+  {
+    title: 'feat(vscode-layout): build left activity bar and explorer panels',
+    body: `Reason
+The left side should match the familiar VS Code model: activity buttons plus project/files/source-control/terminal panels.
+
+Scope
+- Add Explorer, Projects, Source Control, and Terminal activity buttons.
+- Reuse the existing Pixcode project/sidebar component for project and history access.
+- Reuse the existing file tree, git panel, and standalone shell.
+- Allow the left pane to collapse and resize.
+
+Acceptance
+- Project and session selection still works from the new shell.
+- File tree actions still open files.
+- Left pane can be resized and collapsed.`,
+  },
+  {
+    title: 'feat(vscode-layout): add central editor surface for files and system screens',
+    body: `Reason
+VS Code users expect file contents and code to live in the middle, while platform screens remain reachable without leaving the workbench.
+
+Scope
+- Open file tree selections in the central editor.
+- Reuse the existing CodeMirror editor and save/download behavior.
+- Render Control Room, Remote, Orchestration, Tasks, and plugin screens in the center when selected.
+- Keep the center area responsive between resizable side panes.
+
+Acceptance
+- Opening a file from Explorer shows it in the center.
+- System screens remain available inside the workbench.
+- The center pane remains usable while resizing side panes.`,
+  },
+  {
+    title: 'feat(vscode-layout): add right-side CLI work area for all providers',
+    body: `Reason
+The selected CLI should run in the right pane, similar to a focused agent/terminal side area in a three-column workbench.
+
+Scope
+- Reuse the current chat/CLI orchestration surface in the right pane.
+- Preserve Claude Code, Cursor, Codex, Gemini, Qwen Code, and OpenCode selection through existing provider controls.
+- Add a terminal tab in the right pane for shell work.
+- Allow the right pane to resize.
+
+Acceptance
+- Existing provider selection and send flow are reused.
+- The right pane can run CLI chat work and terminal work.
+- The pane can be resized without layout overlap.`,
+  },
+  {
+    title: 'feat(vscode-layout): expose layout at login and settings before release',
+    body: `Reason
+Users should be able to choose the new layout on entry and change it later without hunting through hidden configuration.
+
+Scope
+- Add layout selection to login.
+- Add layout selection to Appearance settings.
+- Add translations for supported locales.
+- Verify with smoke, typecheck, lint, and build.
+- Publish a release only after all issue notes are posted.
+
+Acceptance
+- Login includes Classic and VS Code workbench choices.
+- Appearance settings includes the same choices.
+- Locale coverage exists for all supported language files.
+- Release work starts only after verification is clean.`,
+  },
+];
+
+for (const issue of issues) {
+  const result = spawnSync(
+    'gh',
+    ['issue', 'create', '--repo', 'alicomert/pixcode', '--title', issue.title, '--body', issue.body],
+    {
+      stdio: 'inherit',
+      env: {
+        ...process.env,
+        GH_TOKEN: process.env.GITHUB_TOKEN || process.env.GH_TOKEN || '',
+      },
+    },
+  );
+
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+  }
+}

package/scripts/smoke/backend-resource-bounds.mjs

@@ -1,152 +1,152 @@
-#!/usr/bin/env node
-
-import { readFileSync } from 'node:fs';
-
-const read = (path) => readFileSync(path, 'utf8');
-
-const checks = [
-  {
-    path: 'server/projects.js',
-    assert: (source) =>
-      source.includes('CLAUDE_JSONL_LINE_MAX_CHARS') &&
-      source.includes('firstUserMessageIds') &&
-      source.includes('fs.opendir') &&
-      !source.includes('entries.push(entry)') &&
-      !source.includes('result.entries') &&
-      !source.includes('allEntries') &&
-      !source.includes('uuidToSessionMap'),
-    message: 'Claude project parsing must not retain every JSONL entry in memory.',
-  },
-  {
-    path: 'server/index.js',
-    assert: (source) =>
-      source.includes('FILE_TREE_MAX_ITEMS') &&
-      source.includes('FILE_TREE_MAX_DIRECTORIES') &&
-      source.includes('FILE_TREE_SCAN_MAX_MS') &&
-      source.includes('fsPromises.opendir') &&
-      source.includes('invalidated: true') &&
-      source.includes('JSONL_STREAM_LINE_MAX_CHARS') &&
-      source.includes('fs.createReadStream'),
-    message: 'Backend watchers/file tree scans must be bounded and must not broadcast full project trees.',
-  },
-  {
-    path: 'server/index.js',
-    assert: (source) =>
-      source.includes('function resizeTerminalPty') &&
-      source.includes("resizeTerminalPty(shellProcess, data.cols, data.rows, 'reconnect resize')") &&
-      source.includes('resizeTerminalPty(activePty, data.cols, data.rows)'),
-    message: 'Shell reconnect must resize existing PTYs with the latest browser rows and columns.',
-  },
-  {
-    path: 'server/routes/git.js',
-    assert: (source) =>
-      source.includes('fs.opendir') &&
-      source.includes('FILESYSTEM_SCAN_EXCLUDED_DIRS') &&
-      source.includes("'prebuilts'"),
-    message: 'Git filesystem fallback must use bounded streaming directory scans and skip heavy folders.',
-  },
-  {
-    path: 'src/types/app.ts',
-    assert: (source) => source.includes('projects?: Project[]') && source.includes('invalidated?: boolean'),
-    message: 'Project update websocket messages must support lightweight invalidation payloads.',
-  },
-  {
-    path: 'src/hooks/useProjectsState.ts',
-    assert: (source) => source.includes('void fetchProjects();') && source.includes('Array.isArray(projectsMessage.projects)'),
-    message: 'Projects state must refetch after lightweight invalidation messages.',
-  },
-  {
-    path: 'src/components/standalone-shell/view/StandaloneShell.tsx',
-    assert: (source) => source.includes('showHeader={showHeader}') && source.includes('layoutSignal={layoutSignal}'),
-    message: 'Standalone shell must pass header visibility and layout refit signals through to the inner shell.',
-  },
-  {
-    path: 'src/components/shell/view/Shell.tsx',
-    assert: (source) =>
-      source.includes('showHeader?: boolean') &&
-      source.includes('showHeader &&') &&
-      source.includes('layoutSignal?: string | number | null') &&
-      source.includes('isRightCliTerminal') &&
-      source.includes('pixcode-shell-terminal--right-cli') &&
-      source.includes('pixcode-shell-terminal') &&
-      source.includes('min-w-0') &&
-      source.includes('max-w-full'),
-    message: 'Shell must support true headerless rendering, right CLI scoping, and a stable terminal fit container.',
-  },
-  {
-    path: 'src/components/shell/hooks/useShellTerminal.ts',
-    assert: (source) =>
-      source.includes('fitShellTerminal') &&
-      source.includes('layoutSignalRef.current') &&
-      !source.includes('}, [fitAddonRef, layoutSignal, terminalContainerRef, terminalRef, wsRef])'),
-    message: 'Shell terminal must refit on layout changes without reconnecting the terminal lifecycle.',
-  },
-  {
-    path: 'src/components/shell/hooks/useShellConnection.ts',
-    assert: (source) =>
-      source.includes('terminalContainerRef') &&
-      source.includes('layoutSignalRef') &&
-      source.includes('fitShellTerminal') &&
-      source.includes('cols: currentTerminal.cols') &&
-      source.includes('rows: currentTerminal.rows'),
-    message: 'Shell connection init must fit terminal dimensions from the real container before sending PTY rows and columns.',
-  },
-  {
-    path: 'src/components/shell/utils/terminalFit.ts',
-    assert: (source) =>
-      source.includes('getBoundingClientRect()') &&
-      source.includes('measureCellFromDom') &&
-      source.includes('proposeDimensionsFromContainer') &&
-      source.includes('right-cli:') &&
-      source.includes('terminal.resize(nextCols, nextRows)') &&
-      !source.includes('terminal.options.fontSize = nextFontSize'),
-    message: 'Terminal fit utility must use real container geometry for the right CLI panel.',
-  },
-  {
-    path: 'src/components/shell/utils/terminalStyles.ts',
-    assert: (source) =>
-      source.includes('.pixcode-shell-terminal') &&
-      source.includes('display: flex') &&
-      source.includes('max-width: 100%') &&
-      source.includes('.pixcode-shell-terminal .xterm-viewport') &&
-      source.includes('.pixcode-shell-terminal--right-cli .xterm-rows') &&
-      !source.includes('white-space: pre-wrap !important') &&
-      !source.includes('overflow-wrap: anywhere !important') &&
-      !source.includes('word-break: break-word !important') &&
-      !source.includes('.pixcode-shell-terminal .xterm-rows > div'),
-    message: 'Terminal styles must preserve xterm row semantics and avoid CSS wrapping terminal rows.',
-  },
-  {
-    path: 'src/components/vscode-workbench/view/VSCodeWorkbench.tsx',
-    assert: (source) =>
-      source.includes('getDefaultBottomTerminalHeight') &&
-      source.includes("useState(() => getDefaultBottomTerminalHeight())") &&
-      !source.includes('BOTTOM_TERMINAL_DEFAULT_HEIGHT'),
-    message: 'Desktop workbench terminal must use a viewport-aware default height.',
-  },
-  {
-    path: 'src/components/vscode-workbench/view/VSCodeWorkbench.tsx',
-    assert: (source) =>
-      source.includes("autoConnect={canAutoConnect && tab.id === activeCliTab?.id}") &&
-      source.includes('layoutSignal={rightPaneWidth}') &&
-      source.includes('right-cli:${layoutSignal}') &&
-      source.includes('getRightPaneMaxWidth') &&
-      source.includes('RIGHT_HARD_MAX_WIDTH') &&
-      !source.includes('RIGHT_MAX_WIDTH = 680') &&
-      source.includes("absolute inset-0 min-w-0 overflow-hidden") &&
-      source.includes("h-full min-w-0 shrink-0 overflow-hidden bg-background"),
-    message: 'Right CLI panel must keep hidden tabs disconnected, refit on resize, and avoid a narrow fixed width cap.',
-  },
-];
-
-const failures = checks.flatMap(({ path, assert, message }) => {
-  const source = read(path);
-  return assert(source) ? [] : [`${path}: ${message}`];
-});
-
-if (failures.length > 0) {
-  console.error(failures.join('\n'));
-  process.exit(1);
-}
-
-console.log('backend resource bound static checks passed');
+#!/usr/bin/env node
+
+import { readFileSync } from 'node:fs';
+
+const read = (path) => readFileSync(path, 'utf8');
+
+const checks = [
+  {
+    path: 'server/projects.js',
+    assert: (source) =>
+      source.includes('CLAUDE_JSONL_LINE_MAX_CHARS') &&
+      source.includes('firstUserMessageIds') &&
+      source.includes('fs.opendir') &&
+      !source.includes('entries.push(entry)') &&
+      !source.includes('result.entries') &&
+      !source.includes('allEntries') &&
+      !source.includes('uuidToSessionMap'),
+    message: 'Claude project parsing must not retain every JSONL entry in memory.',
+  },
+  {
+    path: 'server/index.js',
+    assert: (source) =>
+      source.includes('FILE_TREE_MAX_ITEMS') &&
+      source.includes('FILE_TREE_MAX_DIRECTORIES') &&
+      source.includes('FILE_TREE_SCAN_MAX_MS') &&
+      source.includes('fsPromises.opendir') &&
+      source.includes('invalidated: true') &&
+      source.includes('JSONL_STREAM_LINE_MAX_CHARS') &&
+      source.includes('fs.createReadStream'),
+    message: 'Backend watchers/file tree scans must be bounded and must not broadcast full project trees.',
+  },
+  {
+    path: 'server/index.js',
+    assert: (source) =>
+      source.includes('function resizeTerminalPty') &&
+      source.includes("resizeTerminalPty(shellProcess, data.cols, data.rows, 'reconnect resize')") &&
+      source.includes('resizeTerminalPty(activePty, data.cols, data.rows)'),
+    message: 'Shell reconnect must resize existing PTYs with the latest browser rows and columns.',
+  },
+  {
+    path: 'server/routes/git.js',
+    assert: (source) =>
+      source.includes('fs.opendir') &&
+      source.includes('FILESYSTEM_SCAN_EXCLUDED_DIRS') &&
+      source.includes("'prebuilts'"),
+    message: 'Git filesystem fallback must use bounded streaming directory scans and skip heavy folders.',
+  },
+  {
+    path: 'src/types/app.ts',
+    assert: (source) => source.includes('projects?: Project[]') && source.includes('invalidated?: boolean'),
+    message: 'Project update websocket messages must support lightweight invalidation payloads.',
+  },
+  {
+    path: 'src/hooks/useProjectsState.ts',
+    assert: (source) => source.includes('void fetchProjects();') && source.includes('Array.isArray(projectsMessage.projects)'),
+    message: 'Projects state must refetch after lightweight invalidation messages.',
+  },
+  {
+    path: 'src/components/standalone-shell/view/StandaloneShell.tsx',
+    assert: (source) => source.includes('showHeader={showHeader}') && source.includes('layoutSignal={layoutSignal}'),
+    message: 'Standalone shell must pass header visibility and layout refit signals through to the inner shell.',
+  },
+  {
+    path: 'src/components/shell/view/Shell.tsx',
+    assert: (source) =>
+      source.includes('showHeader?: boolean') &&
+      source.includes('showHeader &&') &&
+      source.includes('layoutSignal?: string | number | null') &&
+      source.includes('isRightCliTerminal') &&
+      source.includes('pixcode-shell-terminal--right-cli') &&
+      source.includes('pixcode-shell-terminal') &&
+      source.includes('min-w-0') &&
+      source.includes('max-w-full'),
+    message: 'Shell must support true headerless rendering, right CLI scoping, and a stable terminal fit container.',
+  },
+  {
+    path: 'src/components/shell/hooks/useShellTerminal.ts',
+    assert: (source) =>
+      source.includes('fitShellTerminal') &&
+      source.includes('layoutSignalRef.current') &&
+      !source.includes('}, [fitAddonRef, layoutSignal, terminalContainerRef, terminalRef, wsRef])'),
+    message: 'Shell terminal must refit on layout changes without reconnecting the terminal lifecycle.',
+  },
+  {
+    path: 'src/components/shell/hooks/useShellConnection.ts',
+    assert: (source) =>
+      source.includes('terminalContainerRef') &&
+      source.includes('layoutSignalRef') &&
+      source.includes('fitShellTerminal') &&
+      source.includes('cols: currentTerminal.cols') &&
+      source.includes('rows: currentTerminal.rows'),
+    message: 'Shell connection init must fit terminal dimensions from the real container before sending PTY rows and columns.',
+  },
+  {
+    path: 'src/components/shell/utils/terminalFit.ts',
+    assert: (source) =>
+      source.includes('getBoundingClientRect()') &&
+      source.includes('measureCellFromDom') &&
+      source.includes('proposeDimensionsFromContainer') &&
+      source.includes('right-cli:') &&
+      source.includes('terminal.resize(nextCols, nextRows)') &&
+      !source.includes('terminal.options.fontSize = nextFontSize'),
+    message: 'Terminal fit utility must use real container geometry for the right CLI panel.',
+  },
+  {
+    path: 'src/components/shell/utils/terminalStyles.ts',
+    assert: (source) =>
+      source.includes('.pixcode-shell-terminal') &&
+      source.includes('display: flex') &&
+      source.includes('max-width: 100%') &&
+      source.includes('.pixcode-shell-terminal .xterm-viewport') &&
+      source.includes('.pixcode-shell-terminal--right-cli .xterm-rows') &&
+      !source.includes('white-space: pre-wrap !important') &&
+      !source.includes('overflow-wrap: anywhere !important') &&
+      !source.includes('word-break: break-word !important') &&
+      !source.includes('.pixcode-shell-terminal .xterm-rows > div'),
+    message: 'Terminal styles must preserve xterm row semantics and avoid CSS wrapping terminal rows.',
+  },
+  {
+    path: 'src/components/vscode-workbench/view/VSCodeWorkbench.tsx',
+    assert: (source) =>
+      source.includes('getDefaultBottomTerminalHeight') &&
+      source.includes("useState(() => getDefaultBottomTerminalHeight())") &&
+      !source.includes('BOTTOM_TERMINAL_DEFAULT_HEIGHT'),
+    message: 'Desktop workbench terminal must use a viewport-aware default height.',
+  },
+  {
+    path: 'src/components/vscode-workbench/view/VSCodeWorkbench.tsx',
+    assert: (source) =>
+      source.includes("autoConnect={canAutoConnect && tab.id === activeCliTab?.id}") &&
+      source.includes('layoutSignal={rightPaneWidth}') &&
+      source.includes('right-cli:${layoutSignal}') &&
+      source.includes('getRightPaneMaxWidth') &&
+      source.includes('RIGHT_HARD_MAX_WIDTH') &&
+      !source.includes('RIGHT_MAX_WIDTH = 680') &&
+      source.includes("absolute inset-0 min-w-0 overflow-hidden") &&
+      source.includes("h-full min-w-0 shrink-0 overflow-hidden bg-background"),
+    message: 'Right CLI panel must keep hidden tabs disconnected, refit on resize, and avoid a narrow fixed width cap.',
+  },
+];
+
+const failures = checks.flatMap(({ path, assert, message }) => {
+  const source = read(path);
+  return assert(source) ? [] : [`${path}: ${message}`];
+});
+
+if (failures.length > 0) {
+  console.error(failures.join('\n'));
+  process.exit(1);
+}
+
+console.log('backend resource bound static checks passed');

package/scripts/smoke/changes-panel-layout.mjs

@@ -1,48 +1,48 @@
-#!/usr/bin/env node
-
-import assert from 'node:assert/strict';
-import { readFileSync } from 'node:fs';
-
-const appTypes = readFileSync('src/types/app.ts', 'utf8');
-const mainContent = readFileSync('src/components/main-content/view/MainContent.tsx', 'utf8');
-const tabSwitcher = readFileSync('src/components/main-content/view/subcomponents/MainContentTabSwitcher.tsx', 'utf8');
-const quickSettings = readFileSync('src/components/quick-settings-panel/view/QuickSettingsContent.tsx', 'utf8');
-
-assert.ok(
-  appTypes.includes("'changes'"),
-  'AppTab should expose Changes as a first-class tab.',
-);
-
-assert.ok(
-  /const sidePanelTabs = new Set<AppTab>\(\[[^\]]*'changes'[^\]]*\]\)/.test(mainContent),
-  'Changes should use the same split/full side-panel behavior as Files, Shell, and Source Control.',
-);
-
-assert.ok(
-  tabSwitcher.includes("id: 'changes'")
-    && tabSwitcher.includes("labelKey: 'tabs.changes'"),
-  'The main tab switcher should render a Changes pill in the top-left project nav.',
-);
-
-assert.ok(
-  /renderSidePanel = \(tab: [^)]*'changes'/.test(mainContent),
-  'MainContent should render Changes through the side-panel renderer.',
-);
-
-assert.ok(
-  mainContent.includes("useChangedFilesMonitor(selectedProject, Boolean(selectedProject), latestMessage, changeTrackingMode)"),
-  'Changed-file tracking should not depend on the Quick Settings Command Center toggle.',
-);
-
-assert.ok(
-  !mainContent.includes('showChangedFilesRail'),
-  'Changed files should live in the Changes side panel, not as a rail that changes chat layout.',
-);
-
-assert.ok(
-  !quickSettings.includes('quickSettings.sections.changeAwareness')
-    && !quickSettings.includes("onPreferenceChange('changeAwareness'"),
-  'Quick Settings should not own the Changes panel toggle.',
-);
-
-console.log('changes panel layout smoke passed');
+#!/usr/bin/env node
+
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+
+const appTypes = readFileSync('src/types/app.ts', 'utf8');
+const mainContent = readFileSync('src/components/main-content/view/MainContent.tsx', 'utf8');
+const tabSwitcher = readFileSync('src/components/main-content/view/subcomponents/MainContentTabSwitcher.tsx', 'utf8');
+const quickSettings = readFileSync('src/components/quick-settings-panel/view/QuickSettingsContent.tsx', 'utf8');
+
+assert.ok(
+  appTypes.includes("'changes'"),
+  'AppTab should expose Changes as a first-class tab.',
+);
+
+assert.ok(
+  /const sidePanelTabs = new Set<AppTab>\(\[[^\]]*'changes'[^\]]*\]\)/.test(mainContent),
+  'Changes should use the same split/full side-panel behavior as Files, Shell, and Source Control.',
+);
+
+assert.ok(
+  tabSwitcher.includes("id: 'changes'")
+    && tabSwitcher.includes("labelKey: 'tabs.changes'"),
+  'The main tab switcher should render a Changes pill in the top-left project nav.',
+);
+
+assert.ok(
+  /renderSidePanel = \(tab: [^)]*'changes'/.test(mainContent),
+  'MainContent should render Changes through the side-panel renderer.',
+);
+
+assert.ok(
+  mainContent.includes("useChangedFilesMonitor(selectedProject, Boolean(selectedProject), latestMessage, changeTrackingMode)"),
+  'Changed-file tracking should not depend on the Quick Settings Command Center toggle.',
+);
+
+assert.ok(
+  !mainContent.includes('showChangedFilesRail'),
+  'Changed files should live in the Changes side panel, not as a rail that changes chat layout.',
+);
+
+assert.ok(
+  !quickSettings.includes('quickSettings.sections.changeAwareness')
+    && !quickSettings.includes("onPreferenceChange('changeAwareness'"),
+  'Quick Settings should not own the Changes panel toggle.',
+);
+
+console.log('changes panel layout smoke passed');