@dxos/plugin-kanban 0.8.4-main.f5c0578 → 0.8.4-main.fcc0d83b33

package/package.json

@@ -1,85 +1,118 @@
 {
   "name": "@dxos/plugin-kanban",
-  "version": "0.8.4-main.f5c0578",
+  "version": "0.8.4-main.fcc0d83b33",
   "description": "Kanban DXOS Surface plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
   "license": "MIT",
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
+  "imports": {
+    "#blueprints": "./src/blueprints/index.ts",
+    "#capabilities": "./src/capabilities/index.ts",
+    "#components": "./src/components/index.ts",
+    "#containers": "./src/containers/index.ts",
+    "#hooks": "./src/hooks/index.ts",
+    "#meta": "./src/meta.ts",
+    "#operations": "./src/operations/index.ts",
+    "#testing": "./src/testing/index.ts",
+    "#translations": "./src/translations.ts",
+    "#types": "./src/types/index.ts"
+  },
   "exports": {
     ".": {
       "source": "./src/index.ts",
-      "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs",
-      "node": "./dist/lib/node-esm/index.mjs"
+      "node": "./dist/lib/node-esm/index.mjs",
+      "types": "./dist/types/src/index.d.ts"
+    },
+    "./blueprints": {
+      "source": "./src/blueprints/index.ts",
+      "browser": "./dist/lib/browser/blueprints/index.mjs",
+      "node": "./dist/lib/node-esm/blueprints/index.mjs",
+      "types": "./dist/types/src/blueprints/index.d.ts"
+    },
+    "./operations": {
+      "source": "./src/operations/index.ts",
+      "browser": "./dist/lib/browser/operations/index.mjs",
+      "node": "./dist/lib/node-esm/operations/index.mjs",
+      "types": "./dist/types/src/operations/index.d.ts"
+    },
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "browser": "./dist/lib/browser/translations.mjs",
+      "node": "./dist/lib/node-esm/translations.mjs"
     },
     "./types": {
       "source": "./src/types/index.ts",
-      "types": "./dist/types/src/types/index.d.ts",
       "browser": "./dist/lib/browser/types/index.mjs",
-      "node": "./dist/lib/node-esm/types/index.mjs"
+      "node": "./dist/lib/node-esm/types/index.mjs",
+      "types": "./dist/types/src/types/index.d.ts"
     }
   },
   "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "types": [
-        "dist/types/src/types/index.d.ts"
-      ]
-    }
-  },
   "files": [
     "dist",
     "src"
   ],
   "dependencies": {
-    "@preact-signals/safe-react": "^0.9.0",
-    "@preact/signals-core": "^1.9.0",
-    "effect": "3.17.7",
-    "@dxos/ai": "0.8.4-main.f5c0578",
-    "@dxos/async": "0.8.4-main.f5c0578",
-    "@dxos/assistant": "0.8.4-main.f5c0578",
-    "@dxos/echo": "0.8.4-main.f5c0578",
-    "@dxos/blueprints": "0.8.4-main.f5c0578",
-    "@dxos/echo-schema": "0.8.4-main.f5c0578",
-    "@dxos/effect": "0.8.4-main.f5c0578",
-    "@dxos/app-framework": "0.8.4-main.f5c0578",
-    "@dxos/plugin-client": "0.8.4-main.f5c0578",
-    "@dxos/log": "0.8.4-main.f5c0578",
-    "@dxos/plugin-search": "0.8.4-main.f5c0578",
-    "@dxos/plugin-space": "0.8.4-main.f5c0578",
-    "@dxos/random": "0.8.4-main.f5c0578",
-    "@dxos/react-client": "0.8.4-main.f5c0578",
-    "@dxos/invariant": "0.8.4-main.f5c0578",
-    "@dxos/react-ui-form": "0.8.4-main.f5c0578",
-    "@dxos/react-ui-kanban": "0.8.4-main.f5c0578",
-    "@dxos/react-ui": "0.8.4-main.f5c0578",
-    "@dxos/react-ui-stack": "0.8.4-main.f5c0578",
-    "@dxos/schema": "0.8.4-main.f5c0578",
-    "@dxos/util": "0.8.4-main.f5c0578",
-    "@dxos/plugin-graph": "0.8.4-main.f5c0578"
+    "@effect-atom/atom-react": "^0.5.0",
+    "@radix-ui/react-context": "1.1.1",
+    "effect": "3.20.0",
+    "@dxos/ai": "0.8.4-main.fcc0d83b33",
+    "@dxos/compute": "0.8.4-main.fcc0d83b33",
+    "@dxos/app-toolkit": "0.8.4-main.fcc0d83b33",
+    "@dxos/app-framework": "0.8.4-main.fcc0d83b33",
+    "@dxos/async": "0.8.4-main.fcc0d83b33",
+    "@dxos/echo": "0.8.4-main.fcc0d83b33",
+    "@dxos/echo-atom": "0.8.4-main.fcc0d83b33",
+    "@dxos/effect": "0.8.4-main.fcc0d83b33",
+    "@dxos/invariant": "0.8.4-main.fcc0d83b33",
+    "@dxos/log": "0.8.4-main.fcc0d83b33",
+    "@dxos/plugin-search": "0.8.4-main.fcc0d83b33",
+    "@dxos/plugin-space": "0.8.4-main.fcc0d83b33",
+    "@dxos/plugin-graph": "0.8.4-main.fcc0d83b33",
+    "@dxos/random": "0.8.4-main.fcc0d83b33",
+    "@dxos/react-client": "0.8.4-main.fcc0d83b33",
+    "@dxos/assistant": "0.8.4-main.fcc0d83b33",
+    "@dxos/react-ui-form": "0.8.4-main.fcc0d83b33",
+    "@dxos/react-ui": "0.8.4-main.fcc0d83b33",
+    "@dxos/react-ui-menu": "0.8.4-main.fcc0d83b33",
+    "@dxos/react-ui-mosaic": "0.8.4-main.fcc0d83b33",
+    "@dxos/react-ui-stack": "0.8.4-main.fcc0d83b33",
+    "@dxos/schema": "0.8.4-main.fcc0d83b33",
+    "@dxos/util": "0.8.4-main.fcc0d83b33",
+    "@dxos/types": "0.8.4-main.fcc0d83b33",
+    "@dxos/plugin-client": "0.8.4-main.fcc0d83b33"
   },
   "devDependencies": {
-    "@types/react": "~18.2.0",
-    "@types/react-dom": "~18.2.0",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "vite": "5.4.7",
-    "@dxos/plugin-preview": "0.8.4-main.f5c0578",
-    "@dxos/plugin-theme": "0.8.4-main.f5c0578",
-    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.f5c0578",
-    "@dxos/react-ui-theme": "0.8.4-main.f5c0578",
-    "@dxos/storybook-utils": "0.8.4-main.f5c0578",
-    "@dxos/test-utils": "0.8.4-main.f5c0578"
+    "@types/react": "~19.2.7",
+    "@types/react-dom": "~19.2.3",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "vite": "^8.0.10",
+    "@dxos/echo-db": "0.8.4-main.fcc0d83b33",
+    "@dxos/keys": "0.8.4-main.fcc0d83b33",
+    "@dxos/plugin-testing": "0.8.4-main.fcc0d83b33",
+    "@dxos/plugin-preview": "0.8.4-main.fcc0d83b33",
+    "@dxos/plugin-theme": "0.8.4-main.fcc0d83b33",
+    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.fcc0d83b33",
+    "@dxos/storybook-utils": "0.8.4-main.fcc0d83b33",
+    "@dxos/ui-theme": "0.8.4-main.fcc0d83b33",
+    "@dxos/test-utils": "0.8.4-main.fcc0d83b33"
   },
   "peerDependencies": {
-    "effect": "^3.13.3",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.8.4-main.f5c0578",
-    "@dxos/react-ui-theme": "0.8.4-main.f5c0578"
+    "effect": "3.20.0",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/react-ui": "0.8.4-main.fcc0d83b33",
+    "@dxos/ui-theme": "0.8.4-main.fcc0d83b33"
   },
   "publishConfig": {
     "access": "public"

package/src/KanbanPlugin.tsx

@@ -2,57 +2,60 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Capabilities, Events, contributes, createIntent, defineModule, definePlugin } from '@dxos/app-framework';
-import { ClientEvents } from '@dxos/plugin-client';
-import { SpaceCapabilities } from '@dxos/plugin-space';
-import { defineObjectForm } from '@dxos/plugin-space/types';
-import { KanbanView, translations as kanbanTranslations } from '@dxos/react-ui-kanban';
+import * as Effect from 'effect/Effect';
+import * as Option from 'effect/Option';
 
-import { IntentResolver, ReactSurface } from './capabilities';
-import { meta } from './meta';
-import { translations } from './translations';
-import { CreateKanbanSchema, KanbanAction } from './types';
+import { Plugin } from '@dxos/app-framework';
+import { AppPlugin } from '@dxos/app-toolkit';
+import { Operation } from '@dxos/compute';
+import { Annotation, Type } from '@dxos/echo';
+import { ClientEvents } from '@dxos/plugin-client/types';
+import { SpaceOperation } from '@dxos/plugin-space/operations';
+import { type CreateObject } from '@dxos/plugin-space/types';
+import { ViewModel } from '@dxos/schema';
 
-export const KanbanPlugin = () =>
-  definePlugin(meta, [
-    defineModule({
-      id: `${meta.id}/module/translations`,
-      activatesOn: Events.SetupTranslations,
-      activate: () => contributes(Capabilities.Translations, [...translations, ...kanbanTranslations]),
-    }),
-    defineModule({
-      id: `${meta.id}/module/metadata`,
-      activatesOn: Events.SetupMetadata,
-      activate: () =>
-        contributes(Capabilities.Metadata, {
-          id: KanbanView.typename,
-          metadata: {
-            icon: 'ph--kanban--regular',
-          },
-        }),
-    }),
-    defineModule({
-      id: `${meta.id}/module/object-form`,
-      activatesOn: ClientEvents.SetupSchema,
-      activate: () =>
-        contributes(
-          SpaceCapabilities.ObjectForm,
-          defineObjectForm({
-            objectSchema: KanbanView,
-            formSchema: CreateKanbanSchema,
-            hidden: true,
-            getIntent: (props, options) => createIntent(KanbanAction.Create, { ...props, space: options.space }),
-          }),
-        ),
-    }),
-    defineModule({
-      id: `${meta.id}/module/react-surface`,
-      activatesOn: Events.SetupReactSurface,
-      activate: ReactSurface,
-    }),
-    defineModule({
-      id: `${meta.id}/module/intent-resolver`,
-      activatesOn: Events.SetupIntentResolver,
-      activate: IntentResolver,
-    }),
-  ]);
+import { BlueprintDefinition, Migrations, OperationHandler, UndoMappings, ReactSurface } from '#capabilities';
+import { meta } from '#meta';
+import { translations } from '#translations';
+import { CreateKanbanSchema, Kanban } from '#types';
+
+export const KanbanPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addBlueprintDefinitionModule({ activate: BlueprintDefinition }),
+  AppPlugin.addMetadataModule({
+    metadata: {
+      id: Type.getTypename(Kanban.Kanban),
+      metadata: {
+        icon: Annotation.IconAnnotation.get(Kanban.Kanban).pipe(Option.getOrThrow).icon,
+        iconHue: Annotation.IconAnnotation.get(Kanban.Kanban).pipe(Option.getOrThrow).hue ?? 'white',
+        inputSchema: CreateKanbanSchema,
+        createObject: ((props, options) =>
+          Effect.gen(function* () {
+            const object = yield* Effect.promise(async () => {
+              const { view } = await ViewModel.makeFromDatabase({
+                db: options.db,
+                typename: props.typename,
+                pivotFieldName: props.initialPivotColumn,
+              });
+              return Kanban.make({ name: props.name, view });
+            });
+            return yield* Operation.invoke(SpaceOperation.AddObject, {
+              object,
+              target: options.target,
+              hidden: true,
+              targetNodeId: options.targetNodeId,
+            });
+          })) satisfies CreateObject,
+      },
+    },
+  }),
+  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
+  AppPlugin.addOperationHandlerModule({ id: 'undo-mappings', activate: UndoMappings }),
+  AppPlugin.addSchemaModule({ schema: [Kanban.Kanban] }),
+  AppPlugin.addSurfaceModule({ activate: ReactSurface }),
+  AppPlugin.addTranslationsModule({ translations }),
+  Plugin.addModule({
+    activatesOn: ClientEvents.SetupMigration,
+    activate: Migrations,
+  }),
+  Plugin.make,
+);

package/src/blueprints/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export { default as KanbanBlueprint } from './kanban-blueprint';

package/src/blueprints/kanban-blueprint.ts

@@ -0,0 +1,27 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Blueprint, Template } from '@dxos/compute';
+import { trim } from '@dxos/util';
+
+const BLUEPRINT_KEY = 'org.dxos.blueprint.kanban';
+
+const make = () =>
+  Blueprint.make({
+    key: BLUEPRINT_KEY,
+    name: 'Kanban',
+    tools: Blueprint.toolDefinitions({ tools: [] }),
+    instructions: Template.make({
+      source: trim`
+        You can create and update kanban boards to show data in sorted columns defined by schema.
+      `,
+    }),
+  });
+
+const blueprint: Blueprint.Definition = {
+  key: BLUEPRINT_KEY,
+  make,
+};
+
+export default blueprint;

package/src/capabilities/artifact-definition.ts

@@ -5,22 +5,23 @@
 // ISSUE(burdon): defineArtifact
 // @ts-nocheck
 
-import { Schema, pipe } from 'effect';
+import * as Effect from 'effect/Effect';
+import * as Schema from 'effect/Schema';
 
 import { ToolResult, createTool } from '@dxos/ai';
-import { Capabilities, type PromiseIntentDispatcher, chain, contributes, createIntent } from '@dxos/app-framework';
+import { Capabilities, Capability, type PromiseIntentDispatcher } from '@dxos/app-framework';
 import { createArtifactElement } from '@dxos/assistant';
-import { defineArtifact } from '@dxos/blueprints';
+import { defineArtifact } from '@dxos/compute';
 import { Obj, Query } from '@dxos/echo';
+import { View } from '@dxos/echo';
 import { invariant } from '@dxos/invariant';
-import { SpaceAction } from '@dxos/plugin-space/types';
-import { Filter, type Space, fullyQualifiedId } from '@dxos/react-client/echo';
-import { KanbanView } from '@dxos/react-ui-kanban';
-import { DataType } from '@dxos/schema';
+import { SpaceOperation } from '@dxos/plugin-space/operations';
+import { Filter, type Space } from '@dxos/react-client/echo';
+import { ViewModel } from '@dxos/schema';
 import { isNonNullable } from '@dxos/util';
 
-import { meta } from '../meta';
-import { KanbanAction } from '../types';
+import { meta } from '#meta';
+import { Kanban } from '#types';
 
 const QualifiedId = Schema.String.annotations({
   description: 'The fully qualified ID of the kanban `spaceID:objectID`',
@@ -33,115 +34,118 @@ declare global {
   }
 }
 
-export default () => {
-  const definition = defineArtifact({
-    id: `artifact:${meta.id}`,
-    name: meta.name,
-    instructions: `
+export default Capability.makeModule(() =>
+  Effect.sync(() => {
+    const definition = defineArtifact({
+      id: `artifact:${meta.id}`,
+      name: meta.name,
+      instructions: `
       - Before adding items to a kanban board, inspect the board to see its schema
       - When adding items, you must not include the 'id' field -- it is automatically generated
       - BEFORE adding items, always make sure the board has been shown to the user!
     `,
-    schema: KanbanView,
-    tools: [
-      createTool(meta.id, {
-        name: 'create',
-        description: `
+      schema: Kanban.Kanban,
+      tools: [
+        createTool(meta.id, {
+          name: 'create',
+          description: `
             Create a new kanban board using an existing schema.
             Use schema_create first to create a schema, or schema_list to choose an existing one.`,
-        caption: 'Creating kanban board...',
-        schema: Schema.Struct({
-          typename: Schema.String.annotations({
-            description: 'The fully qualified name of the record type to use for the kanban cards.',
-          }),
-          pivotColumn: Schema.optional(Schema.String).annotations({
-            description: 'Optional field name to use as the column pivot.',
-          }),
-        }),
-        execute: async ({ typename, pivotColumn }, { extensions }) => {
-          invariant(extensions?.space, 'No space');
-          invariant(extensions?.dispatch, 'No intent dispatcher');
-
-          // Validate schema exists first
-          const schema = await extensions.space.db.schemaRegistry.query({ typename }).firstOrUndefined();
-          if (!schema) {
-            return ToolResult.Error(`Schema not found: ${typename}`);
-          }
-
-          const intent = pipe(
-            createIntent(KanbanAction.Create, {
-              space: extensions.space,
-              typename,
-              initialPivotColumn: pivotColumn,
+          caption: 'Creating kanban board...',
+          schema: Schema.Struct({
+            typename: Schema.String.annotations({
+              description: 'The fully qualified name of the record type to use for the kanban cards.',
             }),
-            chain(SpaceAction.AddObject, { target: extensions.space }),
-          );
-
-          const { data, error } = await extensions.dispatch(intent);
-          if (!data || error) {
-            return ToolResult.Error(error?.message ?? 'Failed to create kanban board');
-          }
-
-          return ToolResult.Success(createArtifactElement(data.id));
-        },
-      }),
-      createTool(meta.id, {
-        name: 'list',
-        description: 'List all kanban boards in the current space.',
-        caption: 'Listing kanban boards...',
-        schema: Schema.Struct({}),
-        execute: async (_input, { extensions }) => {
-          invariant(extensions?.space, 'No space');
-          const space = extensions.space;
-          const { objects } = await space.db.query(Filter.type(DataType.View)).run();
-
-          const boardInfo = await Promise.all(
-            objects.map(async (view) => {
-              const kanban = await view.presentation.load();
-              if (!Obj.instanceOf(KanbanView, kanban)) {
-                return null;
-              }
-
-              return {
-                id: fullyQualifiedId(view),
-                name: view.name ?? 'Unnamed Kanban',
-                typename: view.query.typename,
-              };
+            pivotColumn: Schema.optional(Schema.String).annotations({
+              description: 'Optional field name to use as the column pivot.',
             }),
-          );
-
-          return ToolResult.Success(boardInfo.filter(isNonNullable));
-        },
-      }),
-      createTool(meta.id, {
-        name: 'inspect',
-        description: 'Get details about a specific kanban board.',
-        caption: 'Inspecting kanban board...',
-        schema: Schema.Struct({ id: QualifiedId }),
-        execute: async ({ id }, { extensions }) => {
-          invariant(extensions?.space, 'No space');
-          const space = extensions.space;
-          const view = (await space.db
-            // TODO(wittjosiah): Filter.and should aggregate type
-            .query(Query.select(Filter.and(Filter.type(DataType.View), Filter.ids(id))))
-            .first()) as DataType.View;
-
-          const kanban = await view.presentation.load();
-          invariant(Obj.instanceOf(KanbanView, kanban));
-
-          const typename = view.query.typename;
-          const schema = await space.db.schemaRegistry.query({ typename }).firstOrUndefined();
-          invariant(schema);
-
-          return ToolResult.Success({
-            schema,
-            columnField: kanban.columnFieldId,
-            viewFields: view.projection.fields,
-          });
-        },
-      }),
-    ],
-  });
-
-  return contributes(Capabilities.ArtifactDefinition, definition);
-};
+          }),
+          execute: async ({ typename, pivotColumn }, { extensions }) => {
+            invariant(extensions?.space, 'No space');
+            invariant(extensions?.invoke, 'No operation invoker');
+
+            // Validate schema exists first
+            const schema = await extensions.space.db.schemaRegistry.query({ typename }).firstOrUndefined();
+            if (!schema) {
+              return ToolResult.Error(`Schema not found: ${typename}`);
+            }
+
+            const { view } = await ViewModel.makeFromDatabase({
+              db: extensions.space.db,
+              typename,
+              pivotFieldName: pivotColumn,
+            });
+            const kanban = Kanban.make({ view });
+
+            const { error } = await extensions.invoke(SpaceOperation.AddObject, {
+              target: extensions.space,
+              object: kanban,
+            });
+            if (error) {
+              return ToolResult.Error(error?.message ?? 'Failed to add kanban board to space');
+            }
+
+            return ToolResult.Success(createArtifactElement(kanban.id));
+          },
+        }),
+        createTool(meta.id, {
+          name: 'list',
+          description: 'List all kanban boards in the current space.',
+          caption: 'Listing kanban boards...',
+          schema: Schema.Struct({}),
+          execute: async (_input, { extensions }) => {
+            invariant(extensions?.space, 'No space');
+            const space = extensions.space;
+            const { objects } = await space.db.query(Filter.type(View.View)).run();
+
+            const boardInfo = await Promise.all(
+              objects.map(async (view) => {
+                const kanban = await view.presentation.load();
+                if (!Obj.instanceOf(Kanban.Kanban, kanban)) {
+                  return null;
+                }
+
+                return {
+                  id: Obj.getDXN(view).toString(),
+                  name: view.name ?? 'Unnamed Kanban',
+                  typename: view.query.typename,
+                };
+              }),
+            );
+
+            return ToolResult.Success(boardInfo.filter(isNonNullable));
+          },
+        }),
+        createTool(meta.id, {
+          name: 'inspect',
+          description: 'Get details about a specific kanban board.',
+          caption: 'Inspecting kanban board...',
+          schema: Schema.Struct({ id: QualifiedId }),
+          execute: async ({ id }, { extensions }) => {
+            invariant(extensions?.space, 'No space');
+            const space = extensions.space;
+            const view = (await space.db
+              // TODO(wittjosiah): Filter.and should aggregate type
+              .query(Query.select(Filter.and(Filter.type(View.View), Filter.id(id))))
+              .first()) as View.View;
+
+            const kanban = await view.presentation.load();
+            invariant(Obj.instanceOf(Kanban.Kanban, kanban));
+
+            const typename = view.query.typename;
+            const schema = await space.db.schemaRegistry.query({ typename }).firstOrUndefined();
+            invariant(schema);
+
+            return ToolResult.Success({
+              schema,
+              columnField: view.projection.pivotFieldId,
+              viewFields: view.projection.fields,
+            });
+          },
+        }),
+      ],
+    });
+
+    return Capability.contributes(Capabilities.ArtifactDefinition, definition);
+  }),
+);

package/src/capabilities/blueprint-definition.ts

@@ -0,0 +1,17 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { AppCapabilities } from '@dxos/app-toolkit';
+
+import { KanbanBlueprint } from '#blueprints';
+
+const blueprintDefinition = Capability.makeModule<
+  [],
+  Capability.Capability<typeof AppCapabilities.BlueprintDefinition>[]
+>(() => Effect.succeed([Capability.contributes(AppCapabilities.BlueprintDefinition, KanbanBlueprint)]));
+
+export default blueprintDefinition;

package/src/capabilities/index.ts

@@ -2,7 +2,14 @@
 // Copyright 2025 DXOS.org
 //
 
-import { lazy } from '@dxos/app-framework';
+import { Capability } from '@dxos/app-framework';
+import { OperationHandlerSet } from '@dxos/compute';
 
-export const IntentResolver = lazy(() => import('./intent-resolver'));
-export const ReactSurface = lazy(() => import('./react-surface'));
+export const BlueprintDefinition = Capability.lazy('BlueprintDefinition', () => import('./blueprint-definition'));
+export const Migrations = Capability.lazy('Migrations', () => import('./migrations'));
+export const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(
+  'OperationHandler',
+  () => import('./operation-handler'),
+);
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));
+export const UndoMappings = Capability.lazy('UndoMappings', () => import('./undo-mappings'));

package/src/capabilities/migrations.ts

@@ -0,0 +1,35 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { defineObjectMigration } from '@dxos/client/echo';
+import { ClientCapabilities } from '@dxos/plugin-client/types';
+
+import { Kanban } from '#types';
+
+/**
+ * v0.1.0 → v0.2.0: nests the existing `view` ref under a `spec: { kind: 'view', view }`
+ * discriminated union. v0.2.0 introduced an items-variant for externally-synced kanbans;
+ * pre-migration objects were all view-based by construction.
+ */
+const migrations = [
+  defineObjectMigration({
+    from: Kanban.KanbanV1,
+    to: Kanban.Kanban,
+    transform: async (from) => ({
+      name: from.name,
+      arrangement: from.arrangement,
+      spec: { kind: 'view' as const, view: from.view },
+    }),
+    onMigration: async () => {},
+  }),
+];
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    return Capability.contributes(ClientCapabilities.Migration, migrations);
+  }),
+);