@dxos/plugin-kanban 0.9.0 → 0.9.1-staging.ee54ba693a

package/dx.config.ts

@@ -0,0 +1,36 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Config2 } from '@dxos/app-framework/config';
+import { trim } from '@dxos/util';
+
+export default Config2.make({
+  plugin: {
+    key: 'org.dxos.plugin.kanban',
+    name: 'Kanban',
+    author: 'DXOS',
+    description: trim`
+      Visual project management using customizable kanban boards to track workflow progress.
+      Organize any ECHO type into drag-and-drop columns defined by a single-select field, move cards
+      between stages, and reorder both columns and cards — all changes are persisted to ECHO and
+      replicated to collaborators in real time.
+
+      Kanban boards come in two variants: view-variant boards source their cards through a linked
+      View query (any ECHO type can be pivoted on a single-select field), while items-variant boards
+      own their cards explicitly and are used by external sync integrations such as Linear or GitHub.
+      Both variants share the same arrangement storage and drag-and-drop mechanics.
+
+      Board settings let users choose which single-select field drives the column layout and
+      optionally hide the uncategorized column for items that have no pivot value.
+      Field-level undo support allows deleted card fields to be restored without data loss.
+
+      The plugin contributes a Kanban skill that exposes board creation and card management
+      to AI agents, enabling automated project tracking workflows.
+    `,
+    source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-kanban',
+    icon: { key: 'ph--kanban--regular', hue: 'green' },
+    spec: 'PLUGIN.mdl',
+    screenshots: [{ dark: 'https://dxos.network/plugin-details-kanban-dark.png' }],
+  },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-kanban",
-  "version": "0.9.0",
+  "version": "0.9.1-staging.ee54ba693a",
   "description": "Kanban DXOS Surface plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -13,10 +13,10 @@
   "sideEffects": true,
   "type": "module",
   "imports": {
-    "#blueprints": {
-      "source": "./src/blueprints/index.ts",
-      "types": "./dist/types/src/blueprints/index.d.ts",
-      "default": "./dist/lib/neutral/blueprints/index.mjs"
+    "#skills": {
+      "source": "./src/skills/index.ts",
+      "types": "./dist/types/src/skills/index.d.ts",
+      "default": "./dist/lib/neutral/skills/index.mjs"
     },
     "#capabilities": {
       "source": "./src/capabilities/index.ts",
@@ -78,10 +78,10 @@
       "default": "./dist/lib/neutral/index.mjs"
     },
     "./assets/PLUGIN.mdl": "./PLUGIN.mdl",
-    "./blueprints": {
-      "source": "./src/blueprints/index.ts",
-      "types": "./dist/types/src/blueprints/index.d.ts",
-      "default": "./dist/lib/neutral/blueprints/index.mjs"
+    "./skills": {
+      "source": "./src/skills/index.ts",
+      "types": "./dist/types/src/skills/index.d.ts",
+      "default": "./dist/lib/neutral/skills/index.mjs"
     },
     "./plugin": {
       "source": "./src/plugin.ts",
@@ -102,56 +102,57 @@
   "types": "dist/types/src/index.d.ts",
   "files": [
     "dist",
+    "dx.config.ts",
     "src",
     "PLUGIN.mdl"
   ],
   "dependencies": {
     "@effect-atom/atom-react": "^0.5.0",
     "@radix-ui/react-context": "1.1.1",
-    "effect": "3.21.3",
-    "@dxos/ai": "0.9.0",
-    "@dxos/app-framework": "0.9.0",
-    "@dxos/app-toolkit": "0.9.0",
-    "@dxos/assistant": "0.9.0",
-    "@dxos/echo": "0.9.0",
-    "@dxos/compute": "0.9.0",
-    "@dxos/log": "0.9.0",
-    "@dxos/effect": "0.9.0",
-    "@dxos/plugin-space": "0.9.0",
-    "@dxos/plugin-client": "0.9.0",
-    "@dxos/invariant": "0.9.0",
-    "@dxos/random": "0.9.0",
-    "@dxos/react-client": "0.9.0",
-    "@dxos/react-ui-form": "0.9.0",
-    "@dxos/react-ui-menu": "0.9.0",
-    "@dxos/schema": "0.9.0",
-    "@dxos/react-ui": "0.9.0",
-    "@dxos/react-ui-mosaic": "0.9.0",
-    "@dxos/util": "0.9.0",
-    "@dxos/types": "0.9.0"
+    "effect": "3.21.4",
+    "@dxos/ai": "0.9.1-staging.ee54ba693a",
+    "@dxos/app-framework": "0.9.1-staging.ee54ba693a",
+    "@dxos/assistant": "0.9.1-staging.ee54ba693a",
+    "@dxos/compute": "0.9.1-staging.ee54ba693a",
+    "@dxos/echo": "0.9.1-staging.ee54ba693a",
+    "@dxos/effect": "0.9.1-staging.ee54ba693a",
+    "@dxos/invariant": "0.9.1-staging.ee54ba693a",
+    "@dxos/log": "0.9.1-staging.ee54ba693a",
+    "@dxos/random": "0.9.1-staging.ee54ba693a",
+    "@dxos/react-client": "0.9.1-staging.ee54ba693a",
+    "@dxos/plugin-client": "0.9.1-staging.ee54ba693a",
+    "@dxos/react-ui-form": "0.9.1-staging.ee54ba693a",
+    "@dxos/plugin-space": "0.9.1-staging.ee54ba693a",
+    "@dxos/react-ui": "0.9.1-staging.ee54ba693a",
+    "@dxos/react-ui-menu": "0.9.1-staging.ee54ba693a",
+    "@dxos/react-ui-mosaic": "0.9.1-staging.ee54ba693a",
+    "@dxos/schema": "0.9.1-staging.ee54ba693a",
+    "@dxos/app-toolkit": "0.9.1-staging.ee54ba693a",
+    "@dxos/types": "0.9.1-staging.ee54ba693a",
+    "@dxos/util": "0.9.1-staging.ee54ba693a"
   },
   "devDependencies": {
-    "@types/react": "~19.2.7",
+    "@types/react": "~19.2.17",
     "@types/react-dom": "~19.2.3",
-    "react": "~19.2.3",
-    "react-dom": "~19.2.3",
+    "react": "~19.2.7",
+    "react-dom": "~19.2.7",
     "vite": "^8.0.16",
-    "@dxos/keys": "0.9.0",
-    "@dxos/echo-client": "0.9.0",
-    "@dxos/plugin-preview": "0.9.0",
-    "@dxos/plugin-testing": "0.9.0",
-    "@dxos/plugin-theme": "0.9.0",
-    "@dxos/test-utils": "0.9.0",
-    "@dxos/ui-theme": "0.9.0",
-    "@dxos/react-ui-syntax-highlighter": "0.9.0",
-    "@dxos/storybook-utils": "0.9.0"
+    "@dxos/keys": "0.9.1-staging.ee54ba693a",
+    "@dxos/echo-client": "0.9.1-staging.ee54ba693a",
+    "@dxos/plugin-preview": "0.9.1-staging.ee54ba693a",
+    "@dxos/plugin-testing": "0.9.1-staging.ee54ba693a",
+    "@dxos/plugin-theme": "0.9.1-staging.ee54ba693a",
+    "@dxos/react-ui-syntax-highlighter": "0.9.1-staging.ee54ba693a",
+    "@dxos/test-utils": "0.9.1-staging.ee54ba693a",
+    "@dxos/ui-theme": "0.9.1-staging.ee54ba693a",
+    "@dxos/storybook-utils": "0.9.1-staging.ee54ba693a"
   },
   "peerDependencies": {
-    "effect": "3.21.3",
-    "react": "~19.2.3",
-    "react-dom": "~19.2.3",
-    "@dxos/react-ui": "0.9.0",
-    "@dxos/ui-theme": "0.9.0"
+    "effect": "3.21.4",
+    "react": "~19.2.7",
+    "react-dom": "~19.2.7",
+    "@dxos/ui-theme": "0.9.1-staging.ee54ba693a",
+    "@dxos/react-ui": "0.9.1-staging.ee54ba693a"
   },
   "publishConfig": {
     "access": "public"

package/src/KanbanPlugin.node.ts

@@ -5,12 +5,12 @@
 import { Plugin } from '@dxos/app-framework';
 import { AppPlugin } from '@dxos/app-toolkit';
 
-import { BlueprintDefinition, CreateObject, OperationHandler, UndoMappings } from '#capabilities';
+import { CreateObject, OperationHandler, SkillDefinition, UndoMappings } from '#capabilities';
 import { meta } from '#meta';
 import { Kanban } from '#types';
 
 export const KanbanPlugin = Plugin.define(meta).pipe(
-  AppPlugin.addBlueprintDefinitionModule({ activate: BlueprintDefinition }),
+  AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }),
   AppPlugin.addCreateObjectModule({ activate: CreateObject }),
   AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
   AppPlugin.addUndoMappingsModule({ activate: UndoMappings }),

package/src/KanbanPlugin.test.ts

@@ -11,7 +11,7 @@ import { KanbanPlugin } from '#plugin';
 
 import { meta } from './meta';
 
-const moduleId = (name: string) => `${meta.id}.module.${name}`;
+const moduleId = (name: string) => `${meta.profile.key}.module.${name}`;
 
 describe('KanbanPlugin', () => {
   test('modules activate on the expected events', async ({ expect }) => {
@@ -24,8 +24,8 @@ describe('KanbanPlugin', () => {
       expect.arrayContaining([moduleId('OperationHandler'), moduleId('UndoMappings')]),
     );
 
-    // BlueprintDefinition fires when AssistantPlugin loads blueprint definitions.
+    // SkillDefinition fires when AssistantPlugin loads skill definitions.
     await harness.fire(AppActivationEvents.SetupArtifactDefinition);
-    expect(harness.manager.getActive()).toContain(moduleId('BlueprintDefinition'));
+    expect(harness.manager.getActive()).toContain(moduleId('SkillDefinition'));
   });
 });

package/src/KanbanPlugin.tsx

@@ -5,7 +5,7 @@
 import { Plugin } from '@dxos/app-framework';
 import { AppPlugin } from '@dxos/app-toolkit';
 
-import { BlueprintDefinition, CreateObject, OperationHandler, UndoMappings, ReactSurface } from '#capabilities';
+import { CreateObject, OperationHandler, ReactSurface, SkillDefinition, UndoMappings } from '#capabilities';
 import { meta } from '#meta';
 import { translations } from '#translations';
 import { Kanban } from '#types';
@@ -14,7 +14,7 @@ import { Kanban } from '#types';
 import pluginSpec from '../PLUGIN.mdl?raw';
 
 export const KanbanPlugin = Plugin.define(meta).pipe(
-  AppPlugin.addBlueprintDefinitionModule({ activate: BlueprintDefinition }),
+  AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }),
   AppPlugin.addCreateObjectModule({ activate: CreateObject }),
   AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
   AppPlugin.addUndoMappingsModule({ activate: UndoMappings }),
@@ -22,7 +22,7 @@ export const KanbanPlugin = Plugin.define(meta).pipe(
   AppPlugin.addSurfaceModule({ activate: ReactSurface }),
   AppPlugin.addTranslationsModule({ translations }),
   AppPlugin.addPluginAssetModule({
-    asset: { pluginId: meta.id, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },
+    asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },
   }),
   Plugin.make,
 );

package/src/capabilities/create-object.ts

@@ -21,17 +21,19 @@ export default Capability.makeModule(
       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 });
+            if (props.typename) {
+              const { view } = await ViewModel.makeFromDatabase({
+                db: options.db,
+                typename: props.typename,
+                pivotFieldName: props.initialPivotColumn,
+              });
+              return Kanban.make({ name: props.name, view });
+            }
+            return Kanban.makeItems({ name: props.name, pivotField: props.initialPivotColumn ?? '' });
           });
           return yield* Operation.invoke(SpaceOperation.AddObject, {
             object,
             target: options.target,
-            hidden: true,
             targetNodeId: options.targetNodeId,
           });
         }),

package/src/capabilities/index.ts

@@ -3,15 +3,9 @@
 //
 
 import { Capability } from '@dxos/app-framework';
-import { type AppCapabilities } from '@dxos/app-toolkit';
 import type { OperationHandlerSet } from '@dxos/compute';
 
-// The contributed capability type references Blueprint types from @dxos/compute, so the lazy
-// wrapper needs an explicit annotation to keep the inferred type portable (TS2883).
-export const BlueprintDefinition: Capability.LazyCapability<
-  void,
-  Capability.Capability<typeof AppCapabilities.BlueprintDefinition>[]
-> = Capability.lazy('BlueprintDefinition', () => import('./blueprint-definition'));
+export const SkillDefinition = Capability.lazy('SkillDefinition', () => import('./skill-definition'));
 export const CreateObject = Capability.lazy('CreateObject', () => import('./create-object'));
 export const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(
   'OperationHandler',

package/src/capabilities/react-surface.tsx

@@ -3,18 +3,17 @@
 //
 
 import * as Effect from 'effect/Effect';
-import type * as Schema from 'effect/Schema';
-import * as SchemaAST from 'effect/SchemaAST';
 import React, { useMemo } from 'react';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
 import { Surface } from '@dxos/app-framework/ui';
 import { AppSurface } from '@dxos/app-toolkit/ui';
-import { type Collection, Database, Obj, Type } from '@dxos/echo';
+import { Database, Obj, Type } from '@dxos/echo';
 import { SchemaEx } from '@dxos/effect';
-import { type FormFieldComponentProps, SelectField, useFormValues } from '@dxos/react-ui-form';
+import { type FormFieldRendererProps, SelectField, useFormValues } from '@dxos/react-ui-form';
+import { Position } from '@dxos/util';
 
-import { KanbanArticle, KanbanSettings } from '#containers';
+import { KanbanArticle, KanbanProperties } from '#containers';
 import { Kanban, PivotColumnAnnotationId } from '#types';
 
 export default Capability.makeModule(() =>
@@ -31,35 +30,22 @@ export default Capability.makeModule(() =>
       }),
       Surface.create({
         id: 'objectProperties',
-        position: 'first',
+        position: Position.first,
         filter: AppSurface.object(AppSurface.ObjectProperties, Kanban.Kanban),
-        component: ({ data }) => <KanbanSettings subject={data.subject} />,
+        component: ({ data }) => <KanbanProperties subject={data.subject} />,
       }),
       Surface.create({
         id: 'createInitialSchemaForm',
-        role: 'form-input',
-        filter: (
-          data,
-        ): data is {
-          prop: string;
-          schema: Schema.Schema<any>;
-          target: Database.Database | Collection.Collection | undefined;
-          fieldPropertyAst?: SchemaAST.AST;
-        } => {
-          const annotation = SchemaEx.findAnnotation<boolean>(
-            (data.schema as Schema.Schema.All).ast,
-            PivotColumnAnnotationId,
-          );
-          return !!annotation;
-        },
-        component: ({ data: { target, fieldPropertyAst }, ...inputProps }) => {
-          const ast = fieldPropertyAst;
+        filter: AppSurface.formInputBySchema((ast) => !!SchemaEx.findAnnotation<boolean>(ast, PivotColumnAnnotationId)),
+        component: ({ data, ...inputProps }) => {
+          const ast = data.fieldPropertyAst;
           if (!ast) {
             return null;
           }
 
-          const props = { ...inputProps, type: ast } as any as FormFieldComponentProps;
-          const db = Database.isDatabase(target) ? target : target && Obj.getDatabase(target);
+          const props = { ...inputProps, type: ast } as any as FormFieldRendererProps;
+          const target = data.target;
+          const db = Database.isDatabase(target) ? target : Obj.isObject(target) ? Obj.getDatabase(target) : undefined;
           if (!db) {
             return null;
           }
@@ -84,7 +70,11 @@ export default Capability.makeModule(() =>
             }
 
             const columns = Object.entries(properties).reduce<string[]>((acc, [key, value]) => {
-              if (typeof value === 'object' && value?.format === 'single-select') {
+              if (
+                typeof value === 'object' &&
+                value !== null &&
+                (value as { format?: string }).format === 'single-select'
+              ) {
                 acc.push(key);
               }
               return acc;

package/src/capabilities/skill-definition.ts

@@ -0,0 +1,14 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { AppCapabilities } from '@dxos/app-toolkit';
+
+import { KanbanSkill } from '#skills';
+
+const skillDefinition = () => Effect.succeed([Capability.contributes(AppCapabilities.SkillDefinition, KanbanSkill)]);
+
+export default skillDefinition;

package/src/capabilities/undo-mappings.ts

@@ -19,7 +19,7 @@ export default Capability.makeModule(() =>
           props: output.props,
           index: output.index,
         }),
-        message: ['card-field-deleted.label', { ns: meta.id }],
+        message: ['card-field-deleted.label', { ns: meta.profile.key }],
       }),
       UndoMapping.make({
         operation: KanbanOperation.DeleteCard,
@@ -27,7 +27,7 @@ export default Capability.makeModule(() =>
         deriveContext: (_input, output) => ({
           card: output.card,
         }),
-        message: ['card-deleted.label', { ns: meta.id }],
+        message: ['card-deleted.label', { ns: meta.profile.key }],
       }),
     ]),
   ),

package/src/components/KanbanBoard/KanbanBoard.tsx

@@ -57,7 +57,7 @@ export const KanbanBoardRoot = ({
   onCardRemove,
 }: KanbanBoardRootProps) => {
   const registry = useContext(RegistryContext);
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   const model = useKanbanBoardModel(kanban, projection, items, registry);
   const columns = model?.getColumns?.() ?? [];
   const view = kanban?.spec.kind === 'view' ? kanban.spec.view.target : undefined;

package/src/components/KanbanBoard/KanbanCard.tsx

@@ -7,7 +7,7 @@ import React, { forwardRef, useCallback, useMemo, useState } from 'react';
 import { Surface } from '@dxos/app-framework/ui';
 import { AppSurface, useObjectMenuItems } from '@dxos/app-toolkit/ui';
 import { Obj } from '@dxos/echo';
-import { Card, Toolbar, useTranslation } from '@dxos/react-ui';
+import { Card, IconButton, useTranslation } from '@dxos/react-ui';
 import { Menu, createMenuAction } from '@dxos/react-ui-menu';
 import { Focus, Mosaic, useBoard } from '@dxos/react-ui-mosaic';
 
@@ -25,7 +25,7 @@ const KANBAN_CARD_TILE_NAME = 'KanbanBoard.Card';
  */
 export const KanbanCard = forwardRef<HTMLDivElement, KanbanCardProps>(
   ({ data, location, debug, draggable }, forwardedRef) => {
-    const { t } = useTranslation(meta.id);
+    const { t } = useTranslation(meta.profile.key);
     const { model } = useBoard(KANBAN_CARD_TILE_NAME);
     const { projection, columnFieldPath, onCardRemove } = useKanbanBoard(KANBAN_CARD_TILE_NAME);
     const [dragHandle, setDragHandle] = useState<HTMLButtonElement | null>(null);
@@ -65,20 +65,22 @@ export const KanbanCard = forwardRef<HTMLDivElement, KanbanCardProps>(
                 <Card.DragHandle ref={dragHandleRef} testId='mosaicBoard.cardDragHandle' />
                 <Card.Title data-testid='mosaicBoard.cardTitle'>{Obj.getLabel(data)}</Card.Title>
                 {/* TODO(wittjosiah): Reconcile with Card.Menu. */}
-                <Menu.Trigger asChild disabled={!menuItems?.length}>
-                  <Toolbar.IconButton
-                    iconOnly
-                    variant='ghost'
-                    icon='ph--dots-three-vertical--regular'
-                    label={t('action-menu.label')}
-                  />
-                </Menu.Trigger>
-                <Menu.Content items={menuItems} />
+                <Card.Block end>
+                  <Menu.Trigger asChild disabled={!menuItems?.length}>
+                    <IconButton
+                      iconOnly
+                      variant='ghost'
+                      icon='ph--dots-three-vertical--regular'
+                      label={t('action-menu.label')}
+                    />
+                  </Menu.Trigger>
+                  <Menu.Content items={menuItems} />
+                </Card.Block>
               </Card.Header>
               <Card.Body>
                 {projection && (
                   <Surface.Surface
-                    type={AppSurface.Card}
+                    type={AppSurface.CardContent}
                     limit={1}
                     data={{
                       subject: data,

package/src/containers/KanbanArticle/KanbanArticle.stories.tsx

@@ -22,7 +22,7 @@ import { PreviewPlugin } from '@dxos/plugin-preview/testing';
 import { SpacePlugin } from '@dxos/plugin-space/testing';
 import { StorybookPlugin, corePlugins } from '@dxos/plugin-testing';
 import { random } from '@dxos/random';
-import { type Space, useQuery, useType, useSpaces } from '@dxos/react-client/echo';
+import { type Space, useQuery, useSpaces, useType } from '@dxos/react-client/echo';
 import { ViewEditor } from '@dxos/react-ui-form';
 import { Syntax } from '@dxos/react-ui-syntax-highlighter';
 import { withLayout } from '@dxos/react-ui/testing';

package/src/containers/KanbanArticle/KanbanArticle.tsx

@@ -7,7 +7,7 @@ import React, { useCallback, useContext, useMemo } from 'react';
 
 import { useCapabilities, useOperationInvoker } from '@dxos/app-framework/ui';
 import { AppCapabilities } from '@dxos/app-toolkit';
-import { useSchemaFilter, type AppSurface } from '@dxos/app-toolkit/ui';
+import { type AppSurface, useSchemaFilter } from '@dxos/app-toolkit/ui';
 import { Filter, Obj, Query, type Ref, Type } from '@dxos/echo';
 import { useObject, useType } from '@dxos/react-client/echo';
 import { Panel, Toolbar } from '@dxos/react-ui';

package/src/containers/{KanbanSettings/KanbanSettings.tsx → KanbanProperties/KanbanProperties.tsx}

@@ -15,16 +15,16 @@ import { getTypeURIFromQuery } from '@dxos/schema';
 import { useProjectionModel } from '#hooks';
 import { type Kanban, KanbanSettingsSchema, KanbanViewSettingsSchema, UNCATEGORIZED_VALUE } from '#types';
 
-export type KanbanSettingsProps = AppSurface.ObjectPropertiesProps<Kanban.Kanban>;
+export type KanbanPropertiesProps = AppSurface.ObjectPropertiesProps<Kanban.Kanban>;
 
 /**
- * Settings panel for a Kanban. Renders fields common to every kanban
+ * Object-properties panel for a Kanban. Renders fields common to every kanban
  * (currently the "Hide uncategorized column" toggle); for view-variant
  * kanbans an additional "Column field" picker drives the View's pivot
  * field. Items-variant kanbans use a hardcoded `spec.pivotField`, so that
  * field is omitted there.
  */
-export const KanbanSettings = ({ subject: object }: KanbanSettingsProps) => {
+export const KanbanProperties = ({ subject: object }: KanbanPropertiesProps) => {
   const registry = useContext(RegistryContext);
   const db = Obj.getDatabase(object);
   const isView = object.spec.kind === 'view';
@@ -87,8 +87,15 @@ export const KanbanSettings = ({ subject: object }: KanbanSettingsProps) => {
   const settingsSchema = (isView ? KanbanViewSettingsSchema : KanbanSettingsSchema) as any;
 
   return (
-    <Form.Root schema={settingsSchema} values={initialValues} fieldMap={fieldMap} onValuesChanged={handleValuesChanged}>
-      <Form.FieldSet />
-    </Form.Root>
+    <Form.Section>
+      <Form.Root
+        schema={settingsSchema}
+        values={initialValues}
+        fieldMap={fieldMap}
+        onValuesChanged={handleValuesChanged}
+      >
+        <Form.FieldSet />
+      </Form.Root>
+    </Form.Section>
   );
 };

package/src/containers/KanbanProperties/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+export { KanbanProperties as default } from './KanbanProperties';

package/src/containers/index.ts

@@ -5,4 +5,4 @@
 import { type ComponentType, lazy } from 'react';
 
 export const KanbanArticle: ComponentType<any> = lazy(() => import('./KanbanArticle'));
-export const KanbanSettings: ComponentType<any> = lazy(() => import('./KanbanSettings'));
+export const KanbanProperties: ComponentType<any> = lazy(() => import('./KanbanProperties'));

package/src/hooks/useKanbanBoardModel.browser.test.ts

@@ -18,25 +18,27 @@ import { Kanban } from '#types';
 import { useKanbanBoardModel } from './useKanbanBoardModel';
 
 // TODO(wittjosiah): Consider adding single-select to TestSchema.Task and using that instead.
-const KanbanTaskSchema = Schema.Struct({
-  title: Schema.optional(Schema.String),
-  status: Schema.Literal('__uncategorized__', 'a', 'b').pipe(
-    FormatAnnotation.set(Format.TypeFormat.SingleSelect),
-    Schema.annotations({
-      title: 'Status',
-      [PropertyMetaAnnotationId]: {
-        singleSelect: {
-          options: [
-            { id: '__uncategorized__', title: 'Uncategorized', color: 'neutral' },
-            { id: 'a', title: 'A', color: 'blue' },
-            { id: 'b', title: 'B', color: 'green' },
-          ],
+const KanbanTaskSchema = Type.makeObject(DXN.make('com.example.type.kanbanTask', '0.1.0'))(
+  Schema.Struct({
+    title: Schema.optional(Schema.String),
+    status: Schema.Literal('__uncategorized__', 'a', 'b').pipe(
+      FormatAnnotation.set(Format.TypeFormat.SingleSelect),
+      Schema.annotations({
+        title: 'Status',
+        [PropertyMetaAnnotationId]: {
+          singleSelect: {
+            options: [
+              { id: '__uncategorized__', title: 'Uncategorized', color: 'neutral' },
+              { id: 'a', title: 'A', color: 'blue' },
+              { id: 'b', title: 'B', color: 'green' },
+            ],
+          },
         },
-      },
-    }),
-    Schema.optional,
-  ),
-}).pipe(Type.makeObject(DXN.make('com.example.type.kanbanTask', '0.1.0')));
+      }),
+      Schema.optional,
+    ),
+  }),
+);
 
 type KanbanTask = Type.InstanceType<typeof KanbanTaskSchema>;
 

package/src/index.ts

@@ -2,7 +2,7 @@
 // Copyright 2023 DXOS.org
 //
 
-export * from './blueprints';
+export * from './skills';
 export * from './meta';
 export * from './operations';
 export * from './types';

package/src/meta.ts

@@ -3,34 +3,7 @@
 //
 
 import { Plugin } from '@dxos/app-framework';
-import { DXN } from '@dxos/echo';
-import { trim } from '@dxos/util';
 
-export const meta = Plugin.makeMeta({
-  key: DXN.make('org.dxos.plugin.kanban'),
-  name: 'Kanban',
-  author: 'DXOS',
-  description: trim`
-    Visual project management using customizable kanban boards to track workflow progress.
-    Organize any ECHO type into drag-and-drop columns defined by a single-select field, move cards
-    between stages, and reorder both columns and cards — all changes are persisted to ECHO and
-    replicated to collaborators in real time.
+import config from '../dx.config';
 
-    Kanban boards come in two variants: view-variant boards source their cards through a linked
-    View query (any ECHO type can be pivoted on a single-select field), while items-variant boards
-    own their cards explicitly and are used by external sync integrations such as Linear or GitHub.
-    Both variants share the same arrangement storage and drag-and-drop mechanics.
-
-    Board settings let users choose which single-select field drives the column layout and
-    optionally hide the uncategorized column for items that have no pivot value.
-    Field-level undo support allows deleted card fields to be restored without data loss.
-
-    The plugin contributes a Kanban blueprint that exposes board creation and card management
-    to AI agents, enabling automated project tracking workflows.
-  `,
-  icon: 'ph--kanban--regular',
-  iconHue: 'green',
-  source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-kanban',
-  spec: 'PLUGIN.mdl',
-  screenshots: ['https://dxos.network/plugin-details-kanban-dark.png'],
-});
+export const meta = Plugin.getMetaFromConfig(config);

package/src/skills/index.ts

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