@dxos/plugin-pipeline 0.8.4-main.c85a9c8dae → 0.8.4-main.effb148878

package/src/containers/{PipelineObjectSettings/PipelineObjectSettings.tsx → PipelineProperties/PipelineProperties.tsx}

@@ -5,66 +5,61 @@
 import * as Schema from 'effect/Schema';
 import React, { useCallback, useMemo, useRef, useState } from 'react';
 
-import { DXN, Filter, JsonSchema, Obj, Query, type QueryAST, Ref, Tag } from '@dxos/echo';
+import { resolveSchemaWithRegistry } from '@dxos/app-toolkit/query';
+import { useTypeOptions } from '@dxos/app-toolkit/ui';
+import { EchoURI, Filter, JsonSchema, Obj, Query, type QueryAST, Ref, Tag, type Type } from '@dxos/echo';
 import { type JsonPath, type Mutable } from '@dxos/echo/internal';
-import { useTypeOptions } from '@dxos/plugin-space';
-import { resolveSchemaWithRegistry } from '@dxos/plugin-space';
-import { getSpace, useObject, useQuery } from '@dxos/react-client/echo';
+import { useObject, useQuery } from '@dxos/react-client/echo';
 import { IconButton, type ThemedClassName, useAsyncEffect, useTranslation } from '@dxos/react-ui';
 import { Form, ViewEditor } from '@dxos/react-ui-form';
 import { List } from '@dxos/react-ui-list';
 import { type ProjectionModel, ViewModel } from '@dxos/schema';
-import { Pipeline, Task } from '@dxos/types';
-import { mx, osTranslations, subtleHover } from '@dxos/ui-theme';
+import { Pipeline } from '@dxos/types';
+import { mx, osTranslations } from '@dxos/ui-theme';
 import { arrayMove } from '@dxos/util';
 
-import { meta } from '../../meta';
+import { meta } from '#meta';
 
 const listGrid = 'grid grid-cols-[min-content_1fr_min-content_min-content_min-content]';
 const listItemGrid = 'grid grid-cols-subgrid col-span-5';
 
 const ColumnFormSchema = Pipeline.Column.pipe(Schema.mutable, Schema.pick('name'));
 
-// TODO(burdon): Standardize Object/Plugin settings.
-export type PipelineObjectSettingsProps = ThemedClassName<{
+export type PipelinePropertiesProps = ThemedClassName<{
   pipeline: Pipeline.Pipeline;
 }>;
 
 /**
  * Supports editing the pipeline view.
  */
-export const PipelineObjectSettings = ({ classNames, pipeline }: PipelineObjectSettingsProps) => {
+export const PipelineProperties = ({ classNames, pipeline }: PipelinePropertiesProps) => {
   const { t } = useTranslation(meta.id);
-  const space = getSpace(pipeline);
+  const db = Obj.getDatabase(pipeline);
   const [expandedId, setExpandedId] = useState<string>();
   const [columns, updateColumns] = useObject(pipeline, 'columns');
-  const column = useMemo(
-    () => columns.find((column) => column.view.dxn.toString() === expandedId),
-    [columns, expandedId],
-  );
+  const column = useMemo(() => columns.find((column) => column.view.uri === expandedId), [columns, expandedId]);
   const [view, updateView] = useObject(column?.view);
-  const [schema, setSchema] = useState<Schema.Schema.AnyNoContext>(() => Schema.Struct({}));
+  const [type, setType] = useState<Type.AnyEntity>();
   const projectionRef = useRef<ProjectionModel>(null);
-  const tags = useQuery(space?.db, Filter.type(Tag.Tag));
+  const tags = useQuery(db, Filter.type(Tag.Tag));
   const types = useTypeOptions({
-    space,
+    db,
     annotation: {
       location: ['database', 'runtime'],
       kind: ['user'],
-      registered: ['registered', 'unregistered'],
     },
   });
 
   useAsyncEffect(async () => {
-    if (!view?.query || !space) {
+    if (!view?.query || !db) {
       return;
     }
 
-    const foundSchema = await resolveSchemaWithRegistry(space.db.schemaRegistry, view.query.ast);
-    if (foundSchema && foundSchema !== schema) {
-      setSchema(() => foundSchema);
+    const foundType = await resolveSchemaWithRegistry(db.schemaRegistry, view.query.ast);
+    if (foundType && foundType !== type) {
+      setType(() => foundType);
     }
-  }, [space, view, schema]);
+  }, [db, view, type]);
 
   const handleMove = useCallback(
     (fromIndex: number, toIndex: number) =>
@@ -75,32 +70,32 @@ export const PipelineObjectSettings = ({ classNames, pipeline }: PipelineObjectS
   );
 
   const handleQueryChanged = useCallback(
-    async (newQuery: QueryAST.Query, target?: string) => {
-      if (!view || !space) {
+    async (newQuery: QueryAST.Query, target?: EchoURI.EchoURI) => {
+      if (!view || !db) {
         return;
       }
 
-      const queue = target && DXN.tryParse(target) ? target : undefined;
-      const query = queue ? Query.fromAst(newQuery).from({ queues: [queue] }) : Query.fromAst(newQuery);
+      const queue = target;
+      const query = queue ? Query.fromAst(newQuery).from({ feeds: [queue] }) : Query.fromAst(newQuery);
       updateView((view) => {
         view.query.ast = query.ast as Mutable<typeof query.ast>;
       });
-      const newSchema = await resolveSchemaWithRegistry(space.db.schemaRegistry, query.ast);
-      if (!newSchema) {
+      const newType = await resolveSchemaWithRegistry(db.schemaRegistry, query.ast);
+      if (!newType) {
         return;
       }
 
       const newView = ViewModel.make({
         query,
-        jsonSchema: JsonSchema.toJsonSchema(newSchema),
+        jsonSchema: newType.jsonSchema,
       });
       updateView((view) => {
         view.projection = Obj.getSnapshot(newView).projection as Mutable<typeof view.projection>;
       });
 
-      setSchema(() => newSchema);
+      setType(() => newType);
     },
-    [view, updateView, schema],
+    [db, view, updateView, type],
   );
 
   const handleColumnValuesChanged = useCallback(
@@ -120,14 +115,12 @@ export const PipelineObjectSettings = ({ classNames, pipeline }: PipelineObjectS
   );
 
   const handleToggleField = useCallback((column: Pipeline.Column) => {
-    setExpandedId((prevExpandedId) =>
-      prevExpandedId === column.view.dxn.toString() ? undefined : column.view.dxn.toString(),
-    );
+    setExpandedId((prevExpandedId) => (prevExpandedId === column.view.uri ? undefined : column.view.uri));
   }, []);
 
   const handleDelete = useCallback(
     async (column: Pipeline.Column) => {
-      if (column.view.dxn.toString() === expandedId) {
+      if (column.view.uri === expandedId) {
         setExpandedId(undefined);
       }
 
@@ -136,39 +129,39 @@ export const PipelineObjectSettings = ({ classNames, pipeline }: PipelineObjectS
       updateColumns((columns) => {
         columns.splice(index, 1);
       });
-      space?.db.remove(viewToRemove);
+      db?.remove(viewToRemove);
     },
-    [expandedId, columns, updateColumns, space],
+    [expandedId, columns, updateColumns, db],
   );
 
   const handleAdd = useCallback(() => {
-    if (!space) {
+    if (!db) {
       return;
     }
     const newView = ViewModel.make({
-      query: Query.select(Filter.type(Task.Task)),
-      jsonSchema: JsonSchema.toJsonSchema(Task.Task),
+      query: Query.select(Filter.nothing()),
+      jsonSchema: JsonSchema.toJsonSchema(Schema.Struct({})),
     });
-    space.db.add(newView);
+    db.add(newView);
     updateColumns((columns) => {
       columns.push({
-        name: 'Tasks',
+        name: '',
         // Type assertion needed due to QueryAST type variance.
         view: Ref.make(newView) as (typeof columns)[number]['view'],
         order: [],
       });
     });
     setExpandedId(newView.id);
-  }, [space, updateColumns]);
+  }, [db, updateColumns]);
 
   return (
-    <div role='none' className={mx('py-form-padding overflow-y-auto', classNames)}>
-      <h2 className='text-sm text-description py-1'>{t('views label')}</h2>
+    <div className={mx('py-form-padding overflow-y-auto', classNames)}>
+      <h2 className='text-sm text-description py-1'>{t('views.label')}</h2>
 
       <List.Root<Pipeline.Column>
         items={columns}
         isItem={Schema.is(Pipeline.Column)}
-        getId={(column) => column.view.dxn.toString()}
+        getId={(column) => column.view.uri}
         onMove={handleMove}
       >
         {({ items: columns }) => (
@@ -176,16 +169,18 @@ export const PipelineObjectSettings = ({ classNames, pipeline }: PipelineObjectS
             <div role='list' className={mx(listGrid)}>
               {columns.map((column) => (
                 <List.Item<Pipeline.Column>
-                  key={column.view.dxn.toString()}
+                  key={column.view.uri}
                   item={column}
                   classNames={listItemGrid}
-                  aria-expanded={expandedId === column.view.dxn.toString()}
+                  aria-expanded={expandedId === column.view.uri}
                 >
-                  <div role='none' className={mx(subtleHover, listItemGrid, 'rounded-xs cursor-pointer min-h-10')}>
+                  <div className={mx(listItemGrid, 'dx-hover rounded-xs cursor-pointer min-h-10')}>
                     <List.ItemDragHandle />
-                    <List.ItemTitle onClick={() => handleToggleField(column)}>{column.name}</List.ItemTitle>
+                    <List.ItemTitle onClick={() => handleToggleField(column)}>
+                      {column.name || t('untitled-view.title')}
+                    </List.ItemTitle>
                     <List.ItemDeleteButton
-                      label={t('delete view label')}
+                      label={t('delete-view.label')}
                       autoHide={false}
                       onClick={() => handleDelete(column)}
                       data-testid='view.delete'
@@ -193,17 +188,13 @@ export const PipelineObjectSettings = ({ classNames, pipeline }: PipelineObjectS
                     <IconButton
                       iconOnly
                       variant='ghost'
-                      label={t('toggle expand label', { ns: osTranslations })}
-                      icon={
-                        expandedId === column.view.dxn.toString()
-                          ? 'ph--caret-down--regular'
-                          : 'ph--caret-right--regular'
-                      }
+                      label={t('toggle-expand.label', { ns: osTranslations })}
+                      icon={expandedId === column.view.uri ? 'ph--caret-down--regular' : 'ph--caret-right--regular'}
                       onClick={() => handleToggleField(column)}
                     />
                   </div>
-                  {expandedId === column.view.dxn.toString() && column?.view.target && (
-                    <div role='none' className='col-span-5 my-2 border border-separator rounded-md'>
+                  {expandedId === column.view.uri && column?.view.target && (
+                    <div className='col-span-5 my-2 border border-separator rounded-md'>
                       <Form.Root
                         schema={ColumnFormSchema}
                         values={column}
@@ -213,18 +204,20 @@ export const PipelineObjectSettings = ({ classNames, pipeline }: PipelineObjectS
                           <Form.FieldSet />
                         </Form.Content>
                       </Form.Root>
-                      <ViewEditor
-                        ref={projectionRef}
-                        mode='tag'
-                        readonly
-                        schema={schema}
-                        view={column.view.target}
-                        registry={space?.db.schemaRegistry}
-                        db={space?.db}
-                        tags={tags}
-                        types={types}
-                        onQueryChanged={handleQueryChanged}
-                      />
+                      {type && (
+                        <ViewEditor
+                          ref={projectionRef}
+                          mode='tag'
+                          readonly
+                          type={type}
+                          view={column.view.target}
+                          registry={db?.schemaRegistry}
+                          db={db}
+                          tags={tags}
+                          types={types}
+                          onQueryChanged={handleQueryChanged}
+                        />
+                      )}
                     </div>
                   )}
                 </List.Item>
@@ -234,8 +227,8 @@ export const PipelineObjectSettings = ({ classNames, pipeline }: PipelineObjectS
         )}
       </List.Root>
 
-      <div role='none' className='my-form-padding'>
-        <IconButton icon='ph--plus--regular' label={t('add view label')} onClick={handleAdd} classNames='w-full' />
+      <div className='my-form-padding'>
+        <IconButton icon='ph--plus--regular' label={t('add-view.label')} onClick={handleAdd} classNames='w-full' />
       </div>
     </div>
   );

package/src/containers/PipelineProperties/index.ts

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

package/src/containers/index.ts

@@ -4,5 +4,5 @@
 
 import { type ComponentType, lazy } from 'react';
 
-export const PipelineContainer: ComponentType<any> = lazy(() => import('./PipelineContainer'));
-export const PipelineObjectSettings: ComponentType<any> = lazy(() => import('./PipelineObjectSettings'));
+export const PipelineArticle: ComponentType<any> = lazy(() => import('./PipelineArticle'));
+export const PipelineProperties: ComponentType<any> = lazy(() => import('./PipelineProperties'));

package/src/hooks/usePipelineBoardModel.ts

@@ -6,9 +6,9 @@ import { Atom, type Registry } from '@effect-atom/atom-react';
 import * as Schema from 'effect/Schema';
 import { useMemo } from 'react';
 
+import { getQueryTarget } from '@dxos/app-toolkit/query';
 import { Obj, Query } from '@dxos/echo';
 import { AtomObj, AtomQuery } from '@dxos/echo-atom';
-import { getQueryTarget } from '@dxos/plugin-space';
 import { getSpace, isSpace } from '@dxos/react-client/echo';
 import { type BoardModel } from '@dxos/react-ui-mosaic';
 import { Pipeline } from '@dxos/types';
@@ -27,7 +27,7 @@ export const usePipelineBoardModel = (
     const columnAtomFamily = Atom.family<string, Atom.Atom<Pipeline.Column | undefined>>((viewKey: string) =>
       Atom.make((get) => {
         const columns = get(columnsAtom);
-        return columns.find((c) => c.view.dxn.toString() === viewKey);
+        return columns.find((c) => c.view.uri === viewKey);
       }),
     );
 
@@ -52,14 +52,14 @@ export const usePipelineBoardModel = (
     );
 
     return {
-      getColumnId: (data) => (data as Pipeline.Column).view.dxn.toString(),
+      getColumnId: (data) => (data as Pipeline.Column).view.uri,
       getItemId: (data) => (data as Obj.Unknown).id,
       isColumn: (obj: unknown): obj is Pipeline.Column => Schema.is(Pipeline.Column)(obj),
       isItem: (obj: unknown): obj is Obj.Unknown => Obj.isObject(obj),
       columns: columnsAtom,
-      items: (column) => itemsAtomFamily(column.view.dxn.toString()),
+      items: (column) => itemsAtomFamily(column.view.uri),
       getColumns: () => [...registry.get(columnsAtom)],
-      getItems: (column) => registry.get(itemsAtomFamily(column.view.dxn.toString())) ?? [],
+      getItems: (column) => registry.get(itemsAtomFamily(column.view.uri)) ?? [],
     };
   }, [pipeline, registry]);
 
@@ -68,7 +68,7 @@ const emptyColumnsAtom = Atom.make(() => [] as Pipeline.Column[]);
 const emptyItemsAtom = Atom.make(() => [] as Obj.Unknown[]);
 
 const emptyPipelineModel: BoardModel<Pipeline.Column, Obj.Unknown> = {
-  getColumnId: (data) => (data as Pipeline.Column).view.dxn.toString(),
+  getColumnId: (data) => (data as Pipeline.Column).view.uri,
   getItemId: (data) => (data as Obj.Unknown).id,
   isColumn: (obj: unknown): obj is Pipeline.Column => Schema.is(Pipeline.Column)(obj),
   isItem: (obj): obj is Obj.Unknown => Obj.isObject(obj),

package/src/index.ts

@@ -3,4 +3,3 @@
 //
 
 export * from './meta';
-export * from './PipelinePlugin';

package/src/meta.ts

@@ -6,14 +6,26 @@ import { type Plugin } from '@dxos/app-framework';
 import { trim } from '@dxos/util';
 
 export const meta: Plugin.Meta = {
-  id: 'dxos.org/plugin/pipeline',
+  id: 'org.dxos.plugin.pipeline',
   name: 'Pipelines',
+  author: 'DXOS',
   description: trim`
-    Pipelines for organizing tasks, milestones, and deliverables.
-    Track progress across multiple pipelines and coordinate team activities in a structured environment.
+    A multi-column Kanban-style pipeline plugin for DXOS Composer.
+    Each Pipeline holds an ordered set of Columns; each Column is backed by a ViewModel whose query
+    can select any ECHO object type — messages, contacts, documents, or custom types — from the active space.
+
+    Columns are fully configurable through the Settings companion panel, where users can add, rename,
+    reorder, and delete columns and edit the underlying query and projection for each column.
+    Objects can be dragged between columns and the full pipeline state, including column order and
+    per-column item order, persists collaboratively via ECHO.
+
+    A built-in Research template scaffolds a four-column pipeline wired to the Mailbox, Contacts,
+    Organizations, and Notes objects in the space, providing an out-of-the-box CRM-style workflow.
+    Pipeline articles also expose Invocations and Automation companion tabs for AI-driven automation.
   `,
   icon: 'ph--path--regular',
   iconHue: 'purple',
   source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-pipeline',
+  spec: 'PLUGIN.mdl',
   tags: ['labs'],
 };

package/src/plugin.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Plugin } from '@dxos/app-framework';
+
+import { meta } from './meta';
+
+export const PipelinePlugin = Plugin.lazy(meta, () => import('#plugin'));

package/src/templates/research.ts

@@ -2,9 +2,9 @@
 // Copyright 2025 DXOS.org
 //
 
-import { type Database, Feed, Filter, JsonSchema, Query, Ref } from '@dxos/echo';
-import { Mailbox } from '@dxos/plugin-inbox/types';
-import { Markdown } from '@dxos/plugin-markdown/types';
+import { type Database, Filter, JsonSchema, Query, Ref } from '@dxos/echo';
+import { Mailbox } from '@dxos/plugin-inbox';
+import { Markdown } from '@dxos/plugin-markdown';
 import { ViewModel } from '@dxos/schema';
 import { Message, Organization, Person, Pipeline } from '@dxos/types';
 
@@ -12,14 +12,15 @@ export const createResearchProject = async (
   db: Database.Database,
   name?: string,
 ): Promise<Pipeline.Pipeline | null> => {
-  const feeds = await db.query(Filter.type(Feed.Feed)).run();
-  const mailbox = feeds.find((feed) => feed.kind === Mailbox.kind);
-  if (!mailbox) {
+  const mailboxes = await db.query(Filter.type(Mailbox.Mailbox)).run();
+  const mailbox = mailboxes[0];
+  const feed = await mailbox?.feed?.tryLoad();
+  if (!mailbox || !feed) {
     return null;
   }
 
   const mailboxView = ViewModel.make({
-    query: Query.select(Filter.type(Message.Message)).from(mailbox),
+    query: Query.select(Filter.type(Message.Message)).from(feed),
     jsonSchema: JsonSchema.toJsonSchema(Message.Message),
   });
 

package/src/translations.ts

@@ -1,37 +1,39 @@
+import { Type } from '@dxos/echo';
 import { type Resource } from '@dxos/react-ui';
 import { Pipeline } from '@dxos/types';
 //
 // Copyright 2023 DXOS.org
 //
 
-import { meta } from './meta';
+import { meta } from '#meta';
 
 export const translations = [
   {
     'en-US': {
-      [Pipeline.Pipeline.typename]: {
-        'typename label': 'Pipeline',
-        'typename label_zero': 'Pipelines',
-        'typename label_one': 'Pipeline',
-        'typename label_other': 'Pipelines',
-        'object name placeholder': 'New pipeline',
-        'rename object label': 'Rename pipeline',
-        'delete object label': 'Delete pipeline',
-        'object deleted label': 'Pipeline deleted',
+      [Type.getTypename(Pipeline.Pipeline)]: {
+        'typename.label': 'Pipeline',
+        'typename.label_zero': 'Pipelines',
+        'typename.label_one': 'Pipeline',
+        'typename.label_other': 'Pipelines',
+        'object-name.placeholder': 'New pipeline',
+        'add-object.label': 'Add pipeline',
+        'rename-object.label': 'Rename pipeline',
+        'delete-object.label': 'Delete pipeline',
+        'object-deleted.label': 'Pipeline deleted',
       },
       [meta.id]: {
-        'plugin name': 'Pipelines',
-        'add column label': 'Add column',
-        'add card label': 'Add object',
-        'untitled view title': 'New view',
-        'enumerating tab label': 'List',
-        'editing tab label': 'Edit',
-        'views label': 'Views',
-        'pipeline invocations label': 'Invocations',
-        'pipeline automation label': 'Automations',
-        'toggle expand label': 'Toggle expand',
-        'delete view label': 'Delete view',
-        'add view label': 'Add view',
+        'plugin.name': 'Pipelines',
+        'add-column.label': 'Add column',
+        'add-card.label': 'Add object',
+        'untitled-view.title': 'New view',
+        'enumerating-tab.label': 'List',
+        'editing-tab.label': 'Edit',
+        'views.label': 'Views',
+        'pipeline-invocations.label': 'Invocations',
+        'pipeline-automation.label': 'Automations',
+        'toggle-expand.label': 'Toggle expand',
+        'delete-view.label': 'Delete view',
+        'add-view.label': 'Add view',
       },
     },
   },

package/src/types/index.ts

@@ -1,6 +1,3 @@
 //
 // Copyright 2025 DXOS.org
 //
-
-export * as PipelineAction from './PipelineAction';
-export { PipelineOperation } from './PipelineAction';