@shipfox/client-projects 22.0.3 → 23.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shipfox/client-projects",
   "license": "MIT",
-  "version": "22.0.3",
+  "version": "23.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ShipfoxHQ/shipfox.git",
@@ -28,14 +28,14 @@
     "@swc/helpers": "^0.5.17",
     "@tanstack/react-form": "^1.32.0",
     "@shipfox/api-common-dto": "12.0.0",
-    "@shipfox/api-definitions-dto": "12.3.0",
-    "@shipfox/api-integration-core-dto": "12.2.0",
-    "@shipfox/api-projects-dto": "12.2.0",
-    "@shipfox/client-agent": "22.0.3",
+    "@shipfox/api-definitions-dto": "14.0.0",
+    "@shipfox/api-integration-core-dto": "14.0.0",
+    "@shipfox/api-projects-dto": "14.0.0",
+    "@shipfox/client-agent": "23.0.0",
     "@shipfox/client-api": "6.0.1",
-    "@shipfox/client-auth": "22.0.3",
-    "@shipfox/client-integrations": "22.0.3",
-    "@shipfox/client-shell": "22.0.3",
+    "@shipfox/client-auth": "23.0.0",
+    "@shipfox/client-integrations": "23.0.0",
+    "@shipfox/client-shell": "23.0.0",
     "@shipfox/client-ui": "22.0.3",
     "@shipfox/react-ui": "2.2.0"
   },

package/src/core/definition.ts

@@ -22,13 +22,15 @@ export interface DefinitionSyncSummary {
   finishedAt: string | null;
   lastErrorCode: string | null;
   lastErrorMessage: string | null;
-  warnings: DefinitionSyncWarning[];
+  diagnostics: DefinitionSyncDiagnostic[];
 }
 
-export interface DefinitionSyncWarning {
+export interface DefinitionSyncDiagnostic {
   code: string;
   message: string;
   path?: string | undefined;
+  filePath?: string | undefined;
+  severity: 'error' | 'warning';
 }
 
 export interface DefinitionList {

package/src/hooks/api/mappers.test.ts

@@ -1,7 +1,7 @@
 import {toDefinitionSyncSummary} from './mappers.js';
 
 describe('toDefinitionSyncSummary', () => {
-  it('preserves warnings without manufacturing a missing path', () => {
+  it('maps diagnostics with severity and file path while preserving an absent path', () => {
     const summary = toDefinitionSyncSummary({
       ref: 'main',
       status: 'succeeded',
@@ -10,10 +10,28 @@ describe('toDefinitionSyncSummary', () => {
       finished_at: '2026-05-07T01:00:00.000Z',
       last_error_code: null,
       last_error_message: null,
-      warnings: [{code: 'warning-code', message: 'Warning without a path'}],
+      diagnostics: [
+        {code: 'warning-code', message: 'Warning without a path', severity: 'warning'},
+        {
+          code: 'error-code',
+          message: 'Trigger error with a path',
+          path: 'triggers.on_demand',
+          file_path: '.shipfox/workflows/deploy.yml',
+          severity: 'error',
+        },
+      ],
     });
 
-    expect(summary.warnings).toEqual([{code: 'warning-code', message: 'Warning without a path'}]);
-    expect(summary.warnings[0]).not.toHaveProperty('path');
+    expect(summary.diagnostics).toEqual([
+      {code: 'warning-code', message: 'Warning without a path', severity: 'warning'},
+      {
+        code: 'error-code',
+        message: 'Trigger error with a path',
+        path: 'triggers.on_demand',
+        filePath: '.shipfox/workflows/deploy.yml',
+        severity: 'error',
+      },
+    ]);
+    expect(summary.diagnostics[0]).not.toHaveProperty('path');
   });
 });

package/src/hooks/api/mappers.ts

@@ -52,10 +52,12 @@ export function toDefinitionSyncSummary(dto: DefinitionSyncSummaryDto): Definiti
     finishedAt: dto.finished_at,
     lastErrorCode: dto.last_error_code,
     lastErrorMessage: dto.last_error_message,
-    warnings: dto.warnings.map((warning) => ({
-      code: warning.code,
-      message: warning.message,
-      ...(warning.path === undefined ? {} : {path: warning.path}),
+    diagnostics: dto.diagnostics.map((diagnostic) => ({
+      code: diagnostic.code,
+      message: diagnostic.message,
+      severity: diagnostic.severity,
+      ...(diagnostic.path === undefined ? {} : {path: diagnostic.path}),
+      ...(diagnostic.file_path === undefined ? {} : {filePath: diagnostic.file_path}),
     })),
   };
 }

package/src/index.ts

@@ -1,4 +1,9 @@
-export type {Definition, DefinitionList, DefinitionSyncSummary} from '#core/definition.js';
+export type {
+  Definition,
+  DefinitionList,
+  DefinitionSyncDiagnostic,
+  DefinitionSyncSummary,
+} from '#core/definition.js';
 export {
   type CreateProjectCommand,
   type Project,

package/src/pages/projects-hub-page.stories.tsx

@@ -1,5 +1,6 @@
 import {configureApiClient} from '@shipfox/client-api';
 import {type AuthState, authStateAtom} from '@shipfox/client-auth';
+import {ChromeProvider} from '@shipfox/client-shell/runtime';
 import {Toaster} from '@shipfox/react-ui/toast';
 import type {Meta, StoryObj} from '@storybook/react';
 import {QueryClient, QueryClientProvider} from '@tanstack/react-query';
@@ -50,16 +51,23 @@ function ProjectsHubPageStory({scenario}: {scenario: Scenario}) {
   const router = useMemo(() => createStoryRouter(), []);
 
   return (
-    <QueryClientProvider client={queryClient}>
-      <JotaiProvider store={store}>
-        <div className="min-h-screen bg-background-subtle-base px-24 py-32">
-          <div className="mx-auto w-full max-w-[1120px]">
-            <RouterProvider router={router} />
+    <ChromeProvider
+      chrome={{
+        ProjectBreadcrumb: () => null,
+        projectSlugResolver: async () => undefined,
+      }}
+    >
+      <QueryClientProvider client={queryClient}>
+        <JotaiProvider store={store}>
+          <div className="min-h-screen bg-background-subtle-base px-24 py-32">
+            <div className="mx-auto w-full max-w-[1120px]">
+              <RouterProvider router={router} />
+            </div>
           </div>
-        </div>
-        <Toaster />
-      </JotaiProvider>
-    </QueryClientProvider>
+          <Toaster />
+        </JotaiProvider>
+      </QueryClientProvider>
+    </ChromeProvider>
   );
 }
 

package/src/pages/projects-hub-page.test.tsx

@@ -12,11 +12,36 @@ const NEW_PROJECT_REGEX = /New project/i;
 const WORKSPACE_PROJECTS_NEW_HREF = `/w/${PROJECT_TEST_WSLUG}/projects/new`;
 const CONNECTION_ID = '33333333-3333-4333-8333-333333333333';
 
+function StubWorkspaceSetupChecklist() {
+  return <section aria-label="Workspace setup checklist">Workspace setup checklist</section>;
+}
+
 describe('ProjectsHubPage', () => {
   beforeEach(() => {
     window.sessionStorage.clear();
   });
 
+  test('renders the workspace setup checklist before the projects panel', async () => {
+    configureApiClient({
+      fetchImpl: createHubFetch({
+        projects: jsonResponse({projects: [], next_cursor: null}),
+        modelProviders: jsonResponse(modelProviderConfigsDto()),
+      }),
+    });
+
+    renderProjectPage(`/w/${PROJECT_TEST_WSLUG}`, <ProjectsHubPage />, undefined, {
+      WorkspaceSetupChecklist: StubWorkspaceSetupChecklist,
+    });
+
+    expect(await screen.findByText('Create your first project')).toBeInTheDocument();
+    const checklist = screen.getByRole('region', {name: 'Workspace setup checklist'});
+    const projects = screen.getByRole('region', {name: 'Projects'});
+
+    expect(checklist.compareDocumentPosition(projects) & Node.DOCUMENT_POSITION_FOLLOWING).toBe(
+      Node.DOCUMENT_POSITION_FOLLOWING,
+    );
+  });
+
   test('renders the Projects panel controls and empty state with create CTA', async () => {
     configureApiClient({
       fetchImpl: createHubFetch({

package/src/pages/projects-hub-page.tsx

@@ -5,6 +5,7 @@ import {
   IntegrationIcon,
   useIntegrationConnectionsQuery,
 } from '@shipfox/client-integrations';
+import {useChrome} from '@shipfox/client-shell/runtime';
 import {QueryLoadError} from '@shipfox/client-ui';
 import {Button} from '@shipfox/react-ui/button';
 import {Callout} from '@shipfox/react-ui/callout';
@@ -29,6 +30,7 @@ import {useProjectsInfiniteQuery} from '#hooks/api/projects.js';
 
 export function ProjectsHubPage({search = ''}: {search?: string}) {
   const workspace = useActiveWorkspace();
+  const {WorkspaceSetupChecklist} = useChrome();
   const navigate = useNavigate();
   const query = useProjectsInfiniteQuery(workspace.id, search || undefined);
   const projects = query.data?.pages.flatMap((page) => page.projects) ?? [];
@@ -49,6 +51,7 @@ export function ProjectsHubPage({search = ''}: {search?: string}) {
 
   return (
     <div className="flex w-full flex-col gap-section">
+      {WorkspaceSetupChecklist ? <WorkspaceSetupChecklist /> : null}
       <ModelProviderReminderBanner workspaceId={workspace.id} />
 
       <section aria-label="Projects">

package/test/pages.tsx

@@ -1,5 +1,6 @@
 import {configureApiClient} from '@shipfox/client-api';
 import {type AuthState, authStateAtom} from '@shipfox/client-auth';
+import {ChromeProvider, type ChromeSlots} from '@shipfox/client-shell/runtime';
 import {Toaster} from '@shipfox/react-ui/toast';
 import {QueryClient, QueryClientProvider} from '@tanstack/react-query';
 import {
@@ -122,19 +123,27 @@ export function renderProjectPage(
   path: string,
   element: ReactElement,
   queryClient = new QueryClient({defaultOptions: {queries: {retry: false}}}),
+  chromeOverrides: Partial<ChromeSlots> = {},
 ): RenderResult {
   const router = createTestRouter(path, element);
   const store = createStore();
   store.set(authStateAtom, authState);
+  const chrome: ChromeSlots = {
+    ProjectBreadcrumb: () => null,
+    projectSlugResolver: async () => undefined,
+    ...chromeOverrides,
+  };
 
   configureApiClient({baseUrl: 'https://api.example.test'});
 
   return render(
-    <QueryClientProvider client={queryClient}>
-      <JotaiProvider store={store}>
-        <RouterProvider router={router} />
-        <Toaster />
-      </JotaiProvider>
-    </QueryClientProvider>,
+    <ChromeProvider chrome={chrome}>
+      <QueryClientProvider client={queryClient}>
+        <JotaiProvider store={store}>
+          <RouterProvider router={router} />
+          <Toaster />
+        </JotaiProvider>
+      </QueryClientProvider>
+    </ChromeProvider>,
   );
 }