@shipfox/client-onboarding 22.0.2 → 23.0.0

package/.storybook/main.ts

@@ -0,0 +1 @@
+export {default} from '../../.storybook/main.ts';

package/.storybook/preview.css

@@ -0,0 +1,7 @@
+@import "@shipfox/react-ui/index.css";
+
+/* The `@import` supplies design-system tokens and base styles. Tailwind v4 only emits
+   utilities from scanned source, so include package stories plus the react-ui components
+   the setup checklist renders. */
+@source "../src";
+@source "../../../shared/react/ui/src";

package/.storybook/preview.tsx

@@ -0,0 +1,56 @@
+import './preview.css';
+import {ThemeProvider} from '@shipfox/react-ui/theme';
+import type {Decorator, Preview} from '@storybook/react';
+
+if (typeof document !== 'undefined' && document.fonts) {
+  void Promise.all([
+    document.fonts.load("16px 'IBM Plex Sans'"),
+    document.fonts.load("italic 16px 'IBM Plex Sans'"),
+    document.fonts.load("16px 'Commit Mono'"),
+    document.fonts.load("bold 16px 'Commit Mono'"),
+  ]);
+}
+
+const withTheme: Decorator = (Story, context) => {
+  const theme = context.globals.theme;
+  return (
+    <ThemeProvider key={theme} defaultTheme={theme} storageKey={`shipfox-theme-${theme}`}>
+      <Story />
+    </ThemeProvider>
+  );
+};
+
+const preview: Preview = {
+  decorators: [withTheme],
+  parameters: {
+    argos: {
+      // Dual-theme coverage lives in @shipfox/react-ui (the theming source of truth);
+      // feature packages capture only the primary dark theme to limit Argos spend.
+      modes: {
+        dark: {theme: 'dark'},
+      },
+      fitToContent: false,
+    },
+    options: {
+      storySort: {method: 'alphabetical'},
+    },
+  },
+  globalTypes: {
+    theme: {
+      name: 'Theme',
+      description: 'Global theme for components',
+      defaultValue: 'dark',
+      toolbar: {
+        icon: 'sun',
+        items: [
+          {value: 'light', icon: 'sun', title: 'Light'},
+          {value: 'dark', icon: 'moon', title: 'Dark'},
+          {value: 'system', icon: 'info', title: 'System'},
+        ],
+        showName: true,
+      },
+    },
+  },
+};
+
+export default preview;

package/.turbo/turbo-build.log

@@ -1,2 +1,2 @@
 $ shipfox-swc
-Successfully compiled: 2 files with swc (199.78ms)
+Successfully compiled: 4 files with swc (436.14ms)

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @shipfox/client-onboarding
 
+## 23.0.0
+
+### Minor Changes
+
+- f64c66f: Adds `deriveIntegrationReadiness` and `deriveSetupChecklist`, which derive
+  per-provider integration-connected and attention state and the workspace
+  Get-started setup checklist.
+
+### Patch Changes
+
+- Updated dependencies [693e656]
+- Updated dependencies [f7b3db8]
+  - @shipfox/client-shell@23.0.0
+  - @shipfox/client-projects@23.0.0
+  - @shipfox/client-agent@23.0.0
+  - @shipfox/client-integrations@23.0.0
+
+## 22.0.3
+
+### Patch Changes
+
+- 0d3c2e3: Updates @shipfox/client-agent, @shipfox/client-onboarding, and @shipfox/client-workflows to show
+  managed inference providers without exposing workspace credential setup, keep workflow examples
+  limited to supported models, and explain managed-provider failures in workflow runs.
+- Updated dependencies [0d3c2e3]
+- Updated dependencies [b734450]
+- Updated dependencies [ddcc546]
+  - @shipfox/client-agent@22.0.3
+  - @shipfox/client-integrations@22.0.3
+  - @shipfox/client-projects@22.0.3
+  - @shipfox/client-shell@22.0.3
+
 ## 22.0.2
 
 ### Patch Changes

package/README.md

@@ -0,0 +1,110 @@
+# Shipfox Client Onboarding
+
+Client onboarding for Shipfox workspaces: the pre-project setup gate and the
+pure derivations behind the post-activation Get-started checklist.
+
+## What it does
+
+- **`loadWorkspaceSetupRoute`**: the existing onboarding gate. It recomputes
+  "where should this user be" from live queries on every navigation under
+  `/w/$workspaceSlug`: suspended check, then project existence, then usable
+  source connections, then model-provider handling, then project creation.
+- **`deriveIntegrationReadiness`**: the readiness model shared with the
+  first-workflow spec. It turns the provider catalog and the workspace's
+  connections into per-provider `connected` and `attention` state, an
+  `attentionProviders` list ordered by the most recent connection update, and
+  the two workspace-level facts `hasSourceControl` and `hasToolIntegration`.
+- **`deriveSetupChecklist`**: the setup-checklist derivation. It turns
+  integration readiness plus runner, model-provider, and membership facts into
+  the ordered `items` list, the tracked `openCount` and `trackedCount`, and
+  `complete`. Rows follow the spec order; the runner and model-provider rows
+  exist only when the installation does not already provide the capability;
+  the first-workflow and teammates rows are pointers that never count.
+
+Both derivations are pure functions. They test without React and decide what
+the checklist shows, so the component work in this package renders their
+output without re-deriving anything.
+
+## Installation and setup
+
+```sh
+pnpm add @shipfox/client-onboarding
+```
+
+The package is part of the `libs/client` workspace. Its runtime dependencies
+are `client-agent`, `client-integrations`, `client-projects`, and `client-shell`.
+
+## Usage
+
+```ts
+import {
+  deriveIntegrationReadiness,
+  deriveSetupChecklist,
+} from '@shipfox/client-onboarding';
+
+const readiness = deriveIntegrationReadiness({
+  providers: [
+    {provider: 'github', displayName: 'GitHub', capabilities: ['source_control']},
+    {provider: 'linear', displayName: 'Linear', capabilities: ['agent_tools']},
+  ],
+  connections: [],
+});
+
+const checklist = deriveSetupChecklist({
+  readiness,
+  installationRunners: 'none',
+  workspaceRunnerCapacity: false,
+  modelProvider: {installationProvided: false, configured: false},
+  membership: {memberCount: 1, pendingInvitationCount: 0},
+});
+
+checklist.items; // 7 rows: source control, project, tools, runner,
+// model provider, first workflow, teammates
+checklist.trackedCount; // 5
+checklist.openCount; // 3
+checklist.complete; // false
+```
+
+The caller maps its own query results to the derivation inputs:
+
+- `providers` and `connections` use the plain values from
+  `@shipfox/client-integrations`.
+- `installationRunners` is `'managed'` or `'none'`.
+- `workspaceRunnerCapacity` reports whether the workspace has runner capacity.
+- `modelProvider` reports installation-provided inference and workspace
+  configuration.
+- `membership` reports the member and pending-invitation counts.
+
+## Behavior notes
+
+- A provider is `connected` when at least one connection is `active`; it needs
+  `attention` when connections exist but none is active. The two states are
+  mutually exclusive.
+- `hasToolIntegration` is the tools-row criterion: an active connection whose
+  provider lacks the `source_control` capability. GitHub never satisfies it.
+- The tools row names one attention provider ("Linear needs attention") or
+  counts several ("2 integrations need attention").
+- `complete` is true when every tracked row is done. Tracked rows are source
+  control, project, and tools, plus runner and model-provider when those rows
+  exist. The first-workflow and teammates pointers never count.
+- The runner row exists only when `installationRunners` is `'none'`; the
+  model-provider row exists only when `modelProvider.installationProvided` is
+  false.
+- The teammates row renders done at `memberCount >= 2` or
+  `pendingInvitationCount >= 1`, but stays a pointer.
+
+## Development
+
+```sh
+turbo check --filter=@shipfox/client-onboarding
+turbo type --filter=@shipfox/client-onboarding
+turbo test --filter=@shipfox/client-onboarding
+turbo build --filter=@shipfox/client-onboarding
+```
+
+The package runs Storybook per the per-package recipe (`pnpm storybook` on
+port 6015). The Storybook test project activates when checklist stories land.
+
+## License
+
+MIT

package/dist/core/integration-readiness.d.ts

@@ -0,0 +1,35 @@
+import { type IntegrationCapability, type IntegrationConnection, type IntegrationProvider } from '@shipfox/client-integrations';
+/**
+ * Per-provider connection state for the workspace setup readiness model.
+ * `connected` and `attention` are mutually exclusive: a provider with at
+ * least one active connection is connected, a provider whose connections
+ * exist but are all inactive needs attention, and a provider without
+ * connections is neither.
+ */
+export interface IntegrationProviderReadiness {
+    provider: string;
+    displayName: string;
+    capabilities: ReadonlyArray<IntegrationCapability>;
+    connected: boolean;
+    attention: boolean;
+}
+export interface WorkspaceIntegrationReadiness {
+    providers: ReadonlyArray<IntegrationProviderReadiness>;
+    /** Providers in attention, most recently updated connection first. */
+    attentionProviders: readonly string[];
+    /** At least one active connection to a source-control provider. */
+    hasSourceControl: boolean;
+    /** At least one active connection to a provider without `source_control`. */
+    hasToolIntegration: boolean;
+}
+export interface IntegrationReadinessInput {
+    providers: readonly IntegrationProvider[];
+    connections: readonly IntegrationConnection[];
+}
+/**
+ * Derives the workspace integration readiness from the provider catalog and
+ * the workspace's connections. The result is the shared input for the setup
+ * checklist and for the first-workflow spec's contextual "Connect X" prompt.
+ */
+export declare function deriveIntegrationReadiness({ providers, connections, }: IntegrationReadinessInput): WorkspaceIntegrationReadiness;
+//# sourceMappingURL=integration-readiness.d.ts.map

package/dist/core/integration-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-readiness.d.ts","sourceRoot":"","sources":["../../src/core/integration-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EAEzB,MAAM,8BAA8B,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,aAAa,CAAC,4BAA4B,CAAC,CAAC;IACvD,sEAAsE;IACtE,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,mEAAmE;IACnE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,6EAA6E;IAC7E,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC1C,WAAW,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC/C;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,SAAS,EACT,WAAW,GACZ,EAAE,yBAAyB,GAAG,6BAA6B,CAkC3D"}

package/dist/core/integration-readiness.js

@@ -0,0 +1,44 @@
+import { isUsableConnection } from '@shipfox/client-integrations';
+/**
+ * Derives the workspace integration readiness from the provider catalog and
+ * the workspace's connections. The result is the shared input for the setup
+ * checklist and for the first-workflow spec's contextual "Connect X" prompt.
+ */ export function deriveIntegrationReadiness({ providers, connections }) {
+    const readiness = providers.map((provider)=>{
+        const providerConnections = connections.filter((connection)=>connection.provider === provider.provider);
+        const connected = providerConnections.some(isUsableConnection);
+        return {
+            provider: provider.provider,
+            displayName: provider.displayName,
+            capabilities: provider.capabilities,
+            connected,
+            attention: providerConnections.length > 0 && !connected
+        };
+    });
+    const latestConnectionUpdate = latestConnectionUpdateByProvider(connections);
+    const attentionProviders = readiness.filter((provider)=>provider.attention).sort((a, b)=>{
+        const aUpdate = latestConnectionUpdate.get(a.provider) ?? 0;
+        const bUpdate = latestConnectionUpdate.get(b.provider) ?? 0;
+        return bUpdate - aUpdate;
+    }).map((provider)=>provider.provider);
+    const hasSourceControl = readiness.some((provider)=>provider.connected && provider.capabilities.includes('source_control'));
+    const hasToolIntegration = readiness.some((provider)=>provider.connected && !provider.capabilities.includes('source_control'));
+    return {
+        providers: readiness,
+        attentionProviders,
+        hasSourceControl,
+        hasToolIntegration
+    };
+}
+function latestConnectionUpdateByProvider(connections) {
+    const updates = new Map();
+    for (const connection of connections){
+        const timestamp = Date.parse(connection.updatedAt);
+        if (Number.isNaN(timestamp)) continue;
+        const current = updates.get(connection.provider) ?? 0;
+        if (timestamp > current) updates.set(connection.provider, timestamp);
+    }
+    return updates;
+}
+
+//# sourceMappingURL=integration-readiness.js.map

package/dist/core/integration-readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/integration-readiness.ts"],"sourcesContent":["import {\n  type IntegrationCapability,\n  type IntegrationConnection,\n  type IntegrationProvider,\n  isUsableConnection,\n} from '@shipfox/client-integrations';\n\n/**\n * Per-provider connection state for the workspace setup readiness model.\n * `connected` and `attention` are mutually exclusive: a provider with at\n * least one active connection is connected, a provider whose connections\n * exist but are all inactive needs attention, and a provider without\n * connections is neither.\n */\nexport interface IntegrationProviderReadiness {\n  provider: string;\n  displayName: string;\n  capabilities: ReadonlyArray<IntegrationCapability>;\n  connected: boolean;\n  attention: boolean;\n}\n\nexport interface WorkspaceIntegrationReadiness {\n  providers: ReadonlyArray<IntegrationProviderReadiness>;\n  /** Providers in attention, most recently updated connection first. */\n  attentionProviders: readonly string[];\n  /** At least one active connection to a source-control provider. */\n  hasSourceControl: boolean;\n  /** At least one active connection to a provider without `source_control`. */\n  hasToolIntegration: boolean;\n}\n\nexport interface IntegrationReadinessInput {\n  providers: readonly IntegrationProvider[];\n  connections: readonly IntegrationConnection[];\n}\n\n/**\n * Derives the workspace integration readiness from the provider catalog and\n * the workspace's connections. The result is the shared input for the setup\n * checklist and for the first-workflow spec's contextual \"Connect X\" prompt.\n */\nexport function deriveIntegrationReadiness({\n  providers,\n  connections,\n}: IntegrationReadinessInput): WorkspaceIntegrationReadiness {\n  const readiness = providers.map((provider) => {\n    const providerConnections = connections.filter(\n      (connection) => connection.provider === provider.provider,\n    );\n    const connected = providerConnections.some(isUsableConnection);\n    return {\n      provider: provider.provider,\n      displayName: provider.displayName,\n      capabilities: provider.capabilities,\n      connected,\n      attention: providerConnections.length > 0 && !connected,\n    };\n  });\n\n  const latestConnectionUpdate = latestConnectionUpdateByProvider(connections);\n\n  const attentionProviders = readiness\n    .filter((provider) => provider.attention)\n    .sort((a, b) => {\n      const aUpdate = latestConnectionUpdate.get(a.provider) ?? 0;\n      const bUpdate = latestConnectionUpdate.get(b.provider) ?? 0;\n      return bUpdate - aUpdate;\n    })\n    .map((provider) => provider.provider);\n\n  const hasSourceControl = readiness.some(\n    (provider) => provider.connected && provider.capabilities.includes('source_control'),\n  );\n  const hasToolIntegration = readiness.some(\n    (provider) => provider.connected && !provider.capabilities.includes('source_control'),\n  );\n\n  return {providers: readiness, attentionProviders, hasSourceControl, hasToolIntegration};\n}\n\nfunction latestConnectionUpdateByProvider(\n  connections: readonly IntegrationConnection[],\n): Map<string, number> {\n  const updates = new Map<string, number>();\n  for (const connection of connections) {\n    const timestamp = Date.parse(connection.updatedAt);\n    if (Number.isNaN(timestamp)) continue;\n    const current = updates.get(connection.provider) ?? 0;\n    if (timestamp > current) updates.set(connection.provider, timestamp);\n  }\n  return updates;\n}\n"],"names":["isUsableConnection","deriveIntegrationReadiness","providers","connections","readiness","map","provider","providerConnections","filter","connection","connected","some","displayName","capabilities","attention","length","latestConnectionUpdate","latestConnectionUpdateByProvider","attentionProviders","sort","a","b","aUpdate","get","bUpdate","hasSourceControl","includes","hasToolIntegration","updates","Map","timestamp","Date","parse","updatedAt","Number","isNaN","current","set"],"mappings":"AAAA,SAIEA,kBAAkB,QACb,+BAA+B;AAgCtC;;;;CAIC,GACD,OAAO,SAASC,2BAA2B,EACzCC,SAAS,EACTC,WAAW,EACe;IAC1B,MAAMC,YAAYF,UAAUG,GAAG,CAAC,CAACC;QAC/B,MAAMC,sBAAsBJ,YAAYK,MAAM,CAC5C,CAACC,aAAeA,WAAWH,QAAQ,KAAKA,SAASA,QAAQ;QAE3D,MAAMI,YAAYH,oBAAoBI,IAAI,CAACX;QAC3C,OAAO;YACLM,UAAUA,SAASA,QAAQ;YAC3BM,aAAaN,SAASM,WAAW;YACjCC,cAAcP,SAASO,YAAY;YACnCH;YACAI,WAAWP,oBAAoBQ,MAAM,GAAG,KAAK,CAACL;QAChD;IACF;IAEA,MAAMM,yBAAyBC,iCAAiCd;IAEhE,MAAMe,qBAAqBd,UACxBI,MAAM,CAAC,CAACF,WAAaA,SAASQ,SAAS,EACvCK,IAAI,CAAC,CAACC,GAAGC;QACR,MAAMC,UAAUN,uBAAuBO,GAAG,CAACH,EAAEd,QAAQ,KAAK;QAC1D,MAAMkB,UAAUR,uBAAuBO,GAAG,CAACF,EAAEf,QAAQ,KAAK;QAC1D,OAAOkB,UAAUF;IACnB,GACCjB,GAAG,CAAC,CAACC,WAAaA,SAASA,QAAQ;IAEtC,MAAMmB,mBAAmBrB,UAAUO,IAAI,CACrC,CAACL,WAAaA,SAASI,SAAS,IAAIJ,SAASO,YAAY,CAACa,QAAQ,CAAC;IAErE,MAAMC,qBAAqBvB,UAAUO,IAAI,CACvC,CAACL,WAAaA,SAASI,SAAS,IAAI,CAACJ,SAASO,YAAY,CAACa,QAAQ,CAAC;IAGtE,OAAO;QAACxB,WAAWE;QAAWc;QAAoBO;QAAkBE;IAAkB;AACxF;AAEA,SAASV,iCACPd,WAA6C;IAE7C,MAAMyB,UAAU,IAAIC;IACpB,KAAK,MAAMpB,cAAcN,YAAa;QACpC,MAAM2B,YAAYC,KAAKC,KAAK,CAACvB,WAAWwB,SAAS;QACjD,IAAIC,OAAOC,KAAK,CAACL,YAAY;QAC7B,MAAMM,UAAUR,QAAQL,GAAG,CAACd,WAAWH,QAAQ,KAAK;QACpD,IAAIwB,YAAYM,SAASR,QAAQS,GAAG,CAAC5B,WAAWH,QAAQ,EAAEwB;IAC5D;IACA,OAAOF;AACT"}

package/dist/core/setup-checklist.d.ts

@@ -0,0 +1,49 @@
+import type { WorkspaceIntegrationReadiness } from './integration-readiness.js';
+export type SetupChecklistItemStatus = 'done' | 'open' | 'info';
+export type SetupChecklistItemId = 'source-control' | 'project' | 'tools' | 'runner' | 'model-provider' | 'first-workflow' | 'teammates';
+export interface SetupChecklistAction {
+    label: string;
+    href: string;
+}
+export interface SetupChecklistItem {
+    id: SetupChecklistItemId;
+    title: string;
+    status: SetupChecklistItemStatus;
+    /** Tracked items count toward completion; pointers never do. */
+    tracked: boolean;
+    /** One line of purpose, rendered for open and pointer rows. */
+    purpose?: string;
+    /** Primary action, a link to the settings page where the work happens. */
+    action?: SetupChecklistAction;
+}
+export interface SetupChecklist {
+    /** Rows in spec order: done progress, activation asks, then pointers. */
+    items: readonly SetupChecklistItem[];
+    /** Open tracked rows. */
+    openCount: number;
+    /** Rows that count toward completion. */
+    trackedCount: number;
+    /** True when every tracked row is done. */
+    complete: boolean;
+}
+export interface SetupChecklistInput {
+    readiness: WorkspaceIntegrationReadiness;
+    installationRunners: 'managed' | 'none';
+    workspaceRunnerCapacity: boolean;
+    modelProvider: {
+        installationProvided: boolean;
+        configured: boolean;
+    };
+    membership: {
+        memberCount: number;
+        pendingInvitationCount: number;
+    };
+}
+/**
+ * Derives the workspace setup checklist from integration readiness and the
+ * runner, model-provider, and membership facts. Rows follow the spec order;
+ * the runner and model-provider rows exist only when the installation does
+ * not already provide the capability.
+ */
+export declare function deriveSetupChecklist({ readiness, installationRunners, workspaceRunnerCapacity, modelProvider, membership, }: SetupChecklistInput): SetupChecklist;
+//# sourceMappingURL=setup-checklist.d.ts.map

package/dist/core/setup-checklist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-checklist.d.ts","sourceRoot":"","sources":["../../src/core/setup-checklist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,4BAA4B,CAAC;AAE9E,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhE,MAAM,MAAM,oBAAoB,GAC5B,gBAAgB,GAChB,SAAS,GACT,OAAO,GACP,QAAQ,GACR,gBAAgB,GAChB,gBAAgB,GAChB,WAAW,CAAC;AAEhB,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,oBAAoB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,wBAAwB,CAAC;IACjC,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrC,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,6BAA6B,CAAC;IACzC,mBAAmB,EAAE,SAAS,GAAG,MAAM,CAAC;IACxC,uBAAuB,EAAE,OAAO,CAAC;IACjC,aAAa,EAAE;QAAC,oBAAoB,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAC,CAAC;IACpE,UAAU,EAAE;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,sBAAsB,EAAE,MAAM,CAAA;KAAC,CAAC;CACnE;AAWD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,SAAS,EACT,mBAAmB,EACnB,uBAAuB,EACvB,aAAa,EACb,UAAU,GACX,EAAE,mBAAmB,GAAG,cAAc,CAiEtC"}

package/dist/core/setup-checklist.js

@@ -0,0 +1,110 @@
+const TOOLS_TITLE = 'Connect your tools';
+const TOOLS_PURPOSE = 'Connect issue tracking, messaging, observability, or any Shipfox integration so workflows can react to events and agents can use them';
+const RUNNER_PURPOSE = 'Jobs wait in `pending` until a runner is online';
+const MODEL_PROVIDER_PURPOSE = 'Agent steps need a model provider to run';
+const FIRST_WORKFLOW_PURPOSE = 'Add a workflow file under `.shipfox/workflows/` and Shipfox picks it up on the next push';
+const TEAMMATES_PURPOSE = 'Everyone in the workspace can edit workflows and see runs';
+/**
+ * Derives the workspace setup checklist from integration readiness and the
+ * runner, model-provider, and membership facts. Rows follow the spec order;
+ * the runner and model-provider rows exist only when the installation does
+ * not already provide the capability.
+ */ export function deriveSetupChecklist({ readiness, installationRunners, workspaceRunnerCapacity, modelProvider, membership }) {
+    const items = [
+        {
+            id: 'source-control',
+            title: 'Connect source control',
+            status: 'done',
+            tracked: true
+        },
+        {
+            id: 'project',
+            title: 'Create a project',
+            status: 'done',
+            tracked: true
+        },
+        {
+            id: 'tools',
+            title: toolsTitle(readiness),
+            status: readiness.hasToolIntegration ? 'done' : 'open',
+            tracked: true,
+            purpose: TOOLS_PURPOSE,
+            action: {
+                label: 'Connect',
+                href: '/settings/integrations'
+            }
+        }
+    ];
+    if (installationRunners === 'none') {
+        items.push({
+            id: 'runner',
+            title: 'Set up runner capacity',
+            status: workspaceRunnerCapacity ? 'done' : 'open',
+            tracked: true,
+            purpose: RUNNER_PURPOSE,
+            action: {
+                label: 'Set up',
+                href: '/settings/runners'
+            }
+        });
+    }
+    if (!modelProvider.installationProvided) {
+        items.push({
+            id: 'model-provider',
+            title: 'Configure a model provider',
+            status: modelProvider.configured ? 'done' : 'open',
+            tracked: true,
+            purpose: MODEL_PROVIDER_PURPOSE,
+            action: {
+                label: 'Configure',
+                href: '/settings/agents'
+            }
+        });
+    }
+    items.push({
+        id: 'first-workflow',
+        title: 'Push your first workflow',
+        status: 'info',
+        tracked: false,
+        purpose: FIRST_WORKFLOW_PURPOSE,
+        action: {
+            label: 'Read the quickstart',
+            href: '/docs/getting-started'
+        }
+    }, {
+        id: 'teammates',
+        title: 'Invite your teammates',
+        status: membership.memberCount >= 2 || membership.pendingInvitationCount >= 1 ? 'done' : 'info',
+        tracked: false,
+        purpose: TEAMMATES_PURPOSE,
+        action: {
+            label: 'Invite',
+            href: '/settings/members'
+        }
+    });
+    const trackedItems = items.filter((item)=>item.tracked);
+    const openCount = trackedItems.filter((item)=>item.status === 'open').length;
+    return {
+        items,
+        openCount,
+        trackedCount: trackedItems.length,
+        complete: openCount === 0
+    };
+}
+function toolsTitle(readiness) {
+    if (!readiness.hasToolIntegration) {
+        const attentionToolProviders = readiness.attentionProviders.map((providerKey)=>readiness.providers.find(({ provider })=>provider === providerKey)).filter((provider)=>provider !== undefined && !provider.capabilities.includes('source_control'));
+        if (attentionToolProviders.length === 1) {
+            const provider = attentionToolProviders[0];
+            if (provider !== undefined) {
+                return `${provider.displayName || provider.provider} needs attention`;
+            }
+        }
+        if (attentionToolProviders.length > 1) {
+            return `${attentionToolProviders.length} integrations need attention`;
+        }
+    }
+    return TOOLS_TITLE;
+}
+
+//# sourceMappingURL=setup-checklist.js.map

package/dist/core/setup-checklist.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/setup-checklist.ts"],"sourcesContent":["import type {WorkspaceIntegrationReadiness} from './integration-readiness.js';\n\nexport type SetupChecklistItemStatus = 'done' | 'open' | 'info';\n\nexport type SetupChecklistItemId =\n  | 'source-control'\n  | 'project'\n  | 'tools'\n  | 'runner'\n  | 'model-provider'\n  | 'first-workflow'\n  | 'teammates';\n\nexport interface SetupChecklistAction {\n  label: string;\n  href: string;\n}\n\nexport interface SetupChecklistItem {\n  id: SetupChecklistItemId;\n  title: string;\n  status: SetupChecklistItemStatus;\n  /** Tracked items count toward completion; pointers never do. */\n  tracked: boolean;\n  /** One line of purpose, rendered for open and pointer rows. */\n  purpose?: string;\n  /** Primary action, a link to the settings page where the work happens. */\n  action?: SetupChecklistAction;\n}\n\nexport interface SetupChecklist {\n  /** Rows in spec order: done progress, activation asks, then pointers. */\n  items: readonly SetupChecklistItem[];\n  /** Open tracked rows. */\n  openCount: number;\n  /** Rows that count toward completion. */\n  trackedCount: number;\n  /** True when every tracked row is done. */\n  complete: boolean;\n}\n\nexport interface SetupChecklistInput {\n  readiness: WorkspaceIntegrationReadiness;\n  installationRunners: 'managed' | 'none';\n  workspaceRunnerCapacity: boolean;\n  modelProvider: {installationProvided: boolean; configured: boolean};\n  membership: {memberCount: number; pendingInvitationCount: number};\n}\n\nconst TOOLS_TITLE = 'Connect your tools';\nconst TOOLS_PURPOSE =\n  'Connect issue tracking, messaging, observability, or any Shipfox integration so workflows can react to events and agents can use them';\nconst RUNNER_PURPOSE = 'Jobs wait in `pending` until a runner is online';\nconst MODEL_PROVIDER_PURPOSE = 'Agent steps need a model provider to run';\nconst FIRST_WORKFLOW_PURPOSE =\n  'Add a workflow file under `.shipfox/workflows/` and Shipfox picks it up on the next push';\nconst TEAMMATES_PURPOSE = 'Everyone in the workspace can edit workflows and see runs';\n\n/**\n * Derives the workspace setup checklist from integration readiness and the\n * runner, model-provider, and membership facts. Rows follow the spec order;\n * the runner and model-provider rows exist only when the installation does\n * not already provide the capability.\n */\nexport function deriveSetupChecklist({\n  readiness,\n  installationRunners,\n  workspaceRunnerCapacity,\n  modelProvider,\n  membership,\n}: SetupChecklistInput): SetupChecklist {\n  const items: SetupChecklistItem[] = [\n    {id: 'source-control', title: 'Connect source control', status: 'done', tracked: true},\n    {id: 'project', title: 'Create a project', status: 'done', tracked: true},\n    {\n      id: 'tools',\n      title: toolsTitle(readiness),\n      status: readiness.hasToolIntegration ? 'done' : 'open',\n      tracked: true,\n      purpose: TOOLS_PURPOSE,\n      action: {label: 'Connect', href: '/settings/integrations'},\n    },\n  ];\n\n  if (installationRunners === 'none') {\n    items.push({\n      id: 'runner',\n      title: 'Set up runner capacity',\n      status: workspaceRunnerCapacity ? 'done' : 'open',\n      tracked: true,\n      purpose: RUNNER_PURPOSE,\n      action: {label: 'Set up', href: '/settings/runners'},\n    });\n  }\n\n  if (!modelProvider.installationProvided) {\n    items.push({\n      id: 'model-provider',\n      title: 'Configure a model provider',\n      status: modelProvider.configured ? 'done' : 'open',\n      tracked: true,\n      purpose: MODEL_PROVIDER_PURPOSE,\n      action: {label: 'Configure', href: '/settings/agents'},\n    });\n  }\n\n  items.push(\n    {\n      id: 'first-workflow',\n      title: 'Push your first workflow',\n      status: 'info',\n      tracked: false,\n      purpose: FIRST_WORKFLOW_PURPOSE,\n      action: {label: 'Read the quickstart', href: '/docs/getting-started'},\n    },\n    {\n      id: 'teammates',\n      title: 'Invite your teammates',\n      status:\n        membership.memberCount >= 2 || membership.pendingInvitationCount >= 1 ? 'done' : 'info',\n      tracked: false,\n      purpose: TEAMMATES_PURPOSE,\n      action: {label: 'Invite', href: '/settings/members'},\n    },\n  );\n\n  const trackedItems = items.filter((item) => item.tracked);\n  const openCount = trackedItems.filter((item) => item.status === 'open').length;\n\n  return {\n    items,\n    openCount,\n    trackedCount: trackedItems.length,\n    complete: openCount === 0,\n  };\n}\n\nfunction toolsTitle(readiness: WorkspaceIntegrationReadiness): string {\n  if (!readiness.hasToolIntegration) {\n    const attentionToolProviders = readiness.attentionProviders\n      .map((providerKey) => readiness.providers.find(({provider}) => provider === providerKey))\n      .filter(\n        (provider) => provider !== undefined && !provider.capabilities.includes('source_control'),\n      );\n    if (attentionToolProviders.length === 1) {\n      const provider = attentionToolProviders[0];\n      if (provider !== undefined) {\n        return `${provider.displayName || provider.provider} needs attention`;\n      }\n    }\n    if (attentionToolProviders.length > 1) {\n      return `${attentionToolProviders.length} integrations need attention`;\n    }\n  }\n  return TOOLS_TITLE;\n}\n"],"names":["TOOLS_TITLE","TOOLS_PURPOSE","RUNNER_PURPOSE","MODEL_PROVIDER_PURPOSE","FIRST_WORKFLOW_PURPOSE","TEAMMATES_PURPOSE","deriveSetupChecklist","readiness","installationRunners","workspaceRunnerCapacity","modelProvider","membership","items","id","title","status","tracked","toolsTitle","hasToolIntegration","purpose","action","label","href","push","installationProvided","configured","memberCount","pendingInvitationCount","trackedItems","filter","item","openCount","length","trackedCount","complete","attentionToolProviders","attentionProviders","map","providerKey","providers","find","provider","undefined","capabilities","includes","displayName"],"mappings":"AAiDA,MAAMA,cAAc;AACpB,MAAMC,gBACJ;AACF,MAAMC,iBAAiB;AACvB,MAAMC,yBAAyB;AAC/B,MAAMC,yBACJ;AACF,MAAMC,oBAAoB;AAE1B;;;;;CAKC,GACD,OAAO,SAASC,qBAAqB,EACnCC,SAAS,EACTC,mBAAmB,EACnBC,uBAAuB,EACvBC,aAAa,EACbC,UAAU,EACU;IACpB,MAAMC,QAA8B;QAClC;YAACC,IAAI;YAAkBC,OAAO;YAA0BC,QAAQ;YAAQC,SAAS;QAAI;QACrF;YAACH,IAAI;YAAWC,OAAO;YAAoBC,QAAQ;YAAQC,SAAS;QAAI;QACxE;YACEH,IAAI;YACJC,OAAOG,WAAWV;YAClBQ,QAAQR,UAAUW,kBAAkB,GAAG,SAAS;YAChDF,SAAS;YACTG,SAASlB;YACTmB,QAAQ;gBAACC,OAAO;gBAAWC,MAAM;YAAwB;QAC3D;KACD;IAED,IAAId,wBAAwB,QAAQ;QAClCI,MAAMW,IAAI,CAAC;YACTV,IAAI;YACJC,OAAO;YACPC,QAAQN,0BAA0B,SAAS;YAC3CO,SAAS;YACTG,SAASjB;YACTkB,QAAQ;gBAACC,OAAO;gBAAUC,MAAM;YAAmB;QACrD;IACF;IAEA,IAAI,CAACZ,cAAcc,oBAAoB,EAAE;QACvCZ,MAAMW,IAAI,CAAC;YACTV,IAAI;YACJC,OAAO;YACPC,QAAQL,cAAce,UAAU,GAAG,SAAS;YAC5CT,SAAS;YACTG,SAAShB;YACTiB,QAAQ;gBAACC,OAAO;gBAAaC,MAAM;YAAkB;QACvD;IACF;IAEAV,MAAMW,IAAI,CACR;QACEV,IAAI;QACJC,OAAO;QACPC,QAAQ;QACRC,SAAS;QACTG,SAASf;QACTgB,QAAQ;YAACC,OAAO;YAAuBC,MAAM;QAAuB;IACtE,GACA;QACET,IAAI;QACJC,OAAO;QACPC,QACEJ,WAAWe,WAAW,IAAI,KAAKf,WAAWgB,sBAAsB,IAAI,IAAI,SAAS;QACnFX,SAAS;QACTG,SAASd;QACTe,QAAQ;YAACC,OAAO;YAAUC,MAAM;QAAmB;IACrD;IAGF,MAAMM,eAAehB,MAAMiB,MAAM,CAAC,CAACC,OAASA,KAAKd,OAAO;IACxD,MAAMe,YAAYH,aAAaC,MAAM,CAAC,CAACC,OAASA,KAAKf,MAAM,KAAK,QAAQiB,MAAM;IAE9E,OAAO;QACLpB;QACAmB;QACAE,cAAcL,aAAaI,MAAM;QACjCE,UAAUH,cAAc;IAC1B;AACF;AAEA,SAASd,WAAWV,SAAwC;IAC1D,IAAI,CAACA,UAAUW,kBAAkB,EAAE;QACjC,MAAMiB,yBAAyB5B,UAAU6B,kBAAkB,CACxDC,GAAG,CAAC,CAACC,cAAgB/B,UAAUgC,SAAS,CAACC,IAAI,CAAC,CAAC,EAACC,QAAQ,EAAC,GAAKA,aAAaH,cAC3ET,MAAM,CACL,CAACY,WAAaA,aAAaC,aAAa,CAACD,SAASE,YAAY,CAACC,QAAQ,CAAC;QAE5E,IAAIT,uBAAuBH,MAAM,KAAK,GAAG;YACvC,MAAMS,WAAWN,sBAAsB,CAAC,EAAE;YAC1C,IAAIM,aAAaC,WAAW;gBAC1B,OAAO,GAAGD,SAASI,WAAW,IAAIJ,SAASA,QAAQ,CAAC,gBAAgB,CAAC;YACvE;QACF;QACA,IAAIN,uBAAuBH,MAAM,GAAG,GAAG;YACrC,OAAO,GAAGG,uBAAuBH,MAAM,CAAC,4BAA4B,CAAC;QACvE;IACF;IACA,OAAOhC;AACT"}

package/dist/index.d.ts

@@ -1,2 +1,4 @@
+export { deriveIntegrationReadiness, type IntegrationProviderReadiness, type IntegrationReadinessInput, type WorkspaceIntegrationReadiness, } from '#core/integration-readiness.js';
+export { deriveSetupChecklist, type SetupChecklist, type SetupChecklistAction, type SetupChecklistInput, type SetupChecklistItem, type SetupChecklistItemId, type SetupChecklistItemStatus, } from '#core/setup-checklist.js';
 export { loadWorkspaceSetupRoute, type WorkspaceSetupRouteOptions, } from './workspace-setup-route.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,KAAK,0BAA0B,GAChC,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,GACnC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,uBAAuB,EACvB,KAAK,0BAA0B,GAChC,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,3 +1,5 @@
+export { deriveIntegrationReadiness } from '#core/integration-readiness.js';
+export { deriveSetupChecklist } from '#core/setup-checklist.js';
 export { loadWorkspaceSetupRoute } from './workspace-setup-route.js';
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export {\n  loadWorkspaceSetupRoute,\n  type WorkspaceSetupRouteOptions,\n} from './workspace-setup-route.js';\n"],"names":["loadWorkspaceSetupRoute"],"mappings":"AAAA,SACEA,uBAAuB,QAElB,6BAA6B"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export {\n  deriveIntegrationReadiness,\n  type IntegrationProviderReadiness,\n  type IntegrationReadinessInput,\n  type WorkspaceIntegrationReadiness,\n} from '#core/integration-readiness.js';\nexport {\n  deriveSetupChecklist,\n  type SetupChecklist,\n  type SetupChecklistAction,\n  type SetupChecklistInput,\n  type SetupChecklistItem,\n  type SetupChecklistItemId,\n  type SetupChecklistItemStatus,\n} from '#core/setup-checklist.js';\nexport {\n  loadWorkspaceSetupRoute,\n  type WorkspaceSetupRouteOptions,\n} from './workspace-setup-route.js';\n"],"names":["deriveIntegrationReadiness","deriveSetupChecklist","loadWorkspaceSetupRoute"],"mappings":"AAAA,SACEA,0BAA0B,QAIrB,iCAAiC;AACxC,SACEC,oBAAoB,QAOf,2BAA2B;AAClC,SACEC,uBAAuB,QAElB,6BAA6B"}