@dxos/plugin-automation 0.8.4-staging.60fe92afc8 → 0.9.1-main.c7dcc2e112

package/dx.config.ts

@@ -0,0 +1,34 @@
+//
+// 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.automation',
+    name: 'Automation',
+    author: 'DXOS',
+    description: trim`
+      Event-driven workflow automation engine for DXOS Composer.
+      An Automation is a user-facing object pairing a trigger ("when" — a timer schedule or an
+      incoming feed) with an action ("then" — a persistent compute operation or routine), enabling
+      automated pipelines that react to changes in real time without manual intervention.
+
+      Automations are configured in their own article and surfaced on a per-object "Automations"
+      companion that lists the automations connected to each object. A per-space TriggerDispatcher
+      manages execution: running locally in the browser when computeEnvironment is "local", or
+      delegating to the DXOS edge for server-side reliability; the space settings page chooses the
+      runtime location.
+
+      Operation handlers and blueprints contributed by any plugin in the application are
+      automatically merged and made available to every space's OperationRegistry, so new
+      capabilities registered by other plugins become instantly invocable from automations.
+    `,
+    icon: { key: 'ph--atom--regular' },
+    source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-automation',
+    spec: 'PLUGIN.mdl',
+    tags: ['system'],
+  },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-automation",
-  "version": "0.8.4-staging.60fe92afc8",
+  "version": "0.9.1-main.c7dcc2e112",
   "description": "Prompt chain plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -102,6 +102,7 @@
   "files": [
     "assets",
     "dist",
+    "dx.config.ts",
     "src",
     "PLUGIN.mdl"
   ],
@@ -109,37 +110,38 @@
     "@effect-atom/atom": "^0.5.3",
     "@effect/cli": "0.75.2",
     "@effect/printer-ansi": "0.49.0",
-    "@dxos/ai": "0.8.4-staging.60fe92afc8",
-    "@dxos/app-framework": "0.8.4-staging.60fe92afc8",
-    "@dxos/app-toolkit": "0.8.4-staging.60fe92afc8",
-    "@dxos/cli-util": "0.8.4-staging.60fe92afc8",
-    "@dxos/client-protocol": "0.8.4-staging.60fe92afc8",
-    "@dxos/client": "0.8.4-staging.60fe92afc8",
-    "@dxos/compute-runtime": "0.8.4-staging.60fe92afc8",
-    "@dxos/compute": "0.8.4-staging.60fe92afc8",
-    "@dxos/conductor": "0.8.4-staging.60fe92afc8",
-    "@dxos/context": "0.8.4-staging.60fe92afc8",
-    "@dxos/echo": "0.8.4-staging.60fe92afc8",
-    "@dxos/echo-react": "0.8.4-staging.60fe92afc8",
-    "@dxos/edge-client": "0.8.4-staging.60fe92afc8",
-    "@dxos/effect": "0.8.4-staging.60fe92afc8",
-    "@dxos/invariant": "0.8.4-staging.60fe92afc8",
-    "@dxos/keys": "0.8.4-staging.60fe92afc8",
-    "@dxos/functions-runtime": "0.8.4-staging.60fe92afc8",
-    "@dxos/log": "0.8.4-staging.60fe92afc8",
-    "@dxos/plugin-graph": "0.8.4-staging.60fe92afc8",
-    "@dxos/plugin-client": "0.8.4-staging.60fe92afc8",
-    "@dxos/plugin-space": "0.8.4-staging.60fe92afc8",
-    "@dxos/random": "0.8.4-staging.60fe92afc8",
-    "@dxos/react-client": "0.8.4-staging.60fe92afc8",
-    "@dxos/react-ui-components": "0.8.4-staging.60fe92afc8",
-    "@dxos/react-ui-form": "0.8.4-staging.60fe92afc8",
-    "@dxos/react-ui-list": "0.8.4-staging.60fe92afc8",
-    "@dxos/react-ui-attention": "0.8.4-staging.60fe92afc8",
-    "@dxos/react-ui-search": "0.8.4-staging.60fe92afc8",
-    "@dxos/schema": "0.8.4-staging.60fe92afc8",
-    "@dxos/types": "0.8.4-staging.60fe92afc8",
-    "@dxos/util": "0.8.4-staging.60fe92afc8"
+    "cronstrue": "^2.56.0",
+    "@dxos/ai": "0.9.1-main.c7dcc2e112",
+    "@dxos/app-toolkit": "0.9.1-main.c7dcc2e112",
+    "@dxos/app-framework": "0.9.1-main.c7dcc2e112",
+    "@dxos/cli-util": "0.9.1-main.c7dcc2e112",
+    "@dxos/client-protocol": "0.9.1-main.c7dcc2e112",
+    "@dxos/compute-runtime": "0.9.1-main.c7dcc2e112",
+    "@dxos/compute": "0.9.1-main.c7dcc2e112",
+    "@dxos/context": "0.9.1-main.c7dcc2e112",
+    "@dxos/conductor": "0.9.1-main.c7dcc2e112",
+    "@dxos/echo": "0.9.1-main.c7dcc2e112",
+    "@dxos/edge-client": "0.9.1-main.c7dcc2e112",
+    "@dxos/echo-react": "0.9.1-main.c7dcc2e112",
+    "@dxos/functions-runtime": "0.9.1-main.c7dcc2e112",
+    "@dxos/invariant": "0.9.1-main.c7dcc2e112",
+    "@dxos/effect": "0.9.1-main.c7dcc2e112",
+    "@dxos/keys": "0.9.1-main.c7dcc2e112",
+    "@dxos/client": "0.9.1-main.c7dcc2e112",
+    "@dxos/log": "0.9.1-main.c7dcc2e112",
+    "@dxos/plugin-client": "0.9.1-main.c7dcc2e112",
+    "@dxos/plugin-graph": "0.9.1-main.c7dcc2e112",
+    "@dxos/plugin-space": "0.9.1-main.c7dcc2e112",
+    "@dxos/random": "0.9.1-main.c7dcc2e112",
+    "@dxos/react-ui-attention": "0.9.1-main.c7dcc2e112",
+    "@dxos/react-client": "0.9.1-main.c7dcc2e112",
+    "@dxos/react-ui-components": "0.9.1-main.c7dcc2e112",
+    "@dxos/react-ui-form": "0.9.1-main.c7dcc2e112",
+    "@dxos/react-ui-search": "0.9.1-main.c7dcc2e112",
+    "@dxos/schema": "0.9.1-main.c7dcc2e112",
+    "@dxos/react-ui-list": "0.9.1-main.c7dcc2e112",
+    "@dxos/types": "0.9.1-main.c7dcc2e112",
+    "@dxos/util": "0.9.1-main.c7dcc2e112"
   },
   "devDependencies": {
     "@effect-atom/atom-react": "^0.5.0",
@@ -150,10 +152,10 @@
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
     "vite": "^8.0.16",
-    "@dxos/plugin-testing": "0.8.4-staging.60fe92afc8",
-    "@dxos/react-ui": "0.8.4-staging.60fe92afc8",
-    "@dxos/storybook-utils": "0.8.4-staging.60fe92afc8",
-    "@dxos/ui-theme": "0.8.4-staging.60fe92afc8"
+    "@dxos/plugin-testing": "0.9.1-main.c7dcc2e112",
+    "@dxos/storybook-utils": "0.9.1-main.c7dcc2e112",
+    "@dxos/ui-theme": "0.9.1-main.c7dcc2e112",
+    "@dxos/react-ui": "0.9.1-main.c7dcc2e112"
   },
   "peerDependencies": {
     "@effect-atom/atom-react": "^0.5.0",
@@ -161,8 +163,8 @@
     "effect": "3.21.3",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/ui-theme": "0.8.4-staging.60fe92afc8",
-    "@dxos/react-ui": "0.8.4-staging.60fe92afc8"
+    "@dxos/react-ui": "0.9.1-main.c7dcc2e112",
+    "@dxos/ui-theme": "0.9.1-main.c7dcc2e112"
   },
   "publishConfig": {
     "access": "public"

package/src/AutomationPlugin.test.ts

@@ -11,7 +11,7 @@ import { AutomationPlugin } from '#plugin';
 
 import { meta } from './meta';
 
-const moduleId = (name: string) => `${meta.id}.module.${name}`;
+const moduleId = (name: string) => `${meta.profile.key}.module.${name}`;
 
 describe('AutomationPlugin', () => {
   test('modules activate on the expected events', async ({ expect }) => {

package/src/AutomationPlugin.tsx

@@ -50,7 +50,7 @@ export const AutomationPlugin = Plugin.define(meta).pipe(
     activate: TriggerRuntimeController,
   }),
   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/app-graph-builder.ts

@@ -6,7 +6,7 @@ import * as Effect from 'effect/Effect';
 import * as Option from 'effect/Option';
 
 import { Capability } from '@dxos/app-framework';
-import { AppCapabilities, AppNode, LayoutOperation, createTypeSectionExtension } from '@dxos/app-toolkit';
+import { AppCapabilities, AppNode, LayoutOperation, TypeSection } from '@dxos/app-toolkit';
 import { isSpace } from '@dxos/client/echo';
 import { Operation } from '@dxos/compute';
 import { Type } from '@dxos/echo';
@@ -22,7 +22,7 @@ import { blank } from '../templates';
 export default Capability.makeModule(
   Effect.fnUntraced(function* () {
     const extensions = yield* Effect.all([
-      createTypeSectionExtension(Automation.Automation),
+      TypeSection.createTypeSectionExtension(Automation.Automation),
       GraphBuilder.createExtension({
         id: 'automationsSectionActions',
         match: (node) => {
@@ -61,8 +61,8 @@ export default Capability.makeModule(
           Effect.succeed([
             AppNode.makeSettingsPanel({
               id: 'automations',
-              type: `${meta.id}.space-settings-automation`,
-              label: ['automation-panel.label', { ns: meta.id }],
+              type: `${meta.profile.key}.space-settings-automation`,
+              label: ['automation-panel.label', { ns: meta.profile.key }],
               icon: 'ph--lightning--regular',
               iconHue: 'indigo',
               position: 'last',
@@ -76,7 +76,7 @@ export default Capability.makeModule(
           Effect.succeed([
             AppNode.makeCompanion({
               id: linkedSegment('automation'),
-              label: ['automation-companion.label', { ns: meta.id }],
+              label: ['automation-companion.label', { ns: meta.profile.key }],
               icon: 'ph--lightning--regular',
               data: 'automation',
               position: 'last',

package/src/capabilities/navigation-resolver.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { Capability } from '@dxos/app-framework';
-import { AppCapabilities, createTypeSectionPathResolver } from '@dxos/app-toolkit';
+import { AppCapabilities, TypeSection } from '@dxos/app-toolkit';
 
 import { Automation } from '#types';
 
@@ -13,7 +13,7 @@ export default Capability.makeModule(
   Effect.fnUntraced(function* () {
     return Capability.contributes(
       AppCapabilities.NavigationPathResolver,
-      createTypeSectionPathResolver(Automation.Automation),
+      TypeSection.createTypeSectionPathResolver(Automation.Automation),
     );
   }),
 );

package/src/capabilities/react-surface.tsx

@@ -26,7 +26,7 @@ export default Capability.makeModule(() =>
       }),
       Surface.create({
         id: 'spaceSettingsAutomation',
-        filter: AppSurface.literal(AppSurface.Article, `${meta.id}.space-settings-automation`),
+        filter: AppSurface.literal(AppSurface.Article, `${meta.profile.key}.space-settings-automation`),
         component: () => {
           const space = useActiveSpace();
           if (!space) {

package/src/commands/trigger/create/queue.ts

@@ -14,7 +14,7 @@ import { CommandConfig } from '@dxos/cli-util';
 import { flushAndSync, print, spaceLayer, withTypes } from '@dxos/cli-util';
 import { Common } from '@dxos/cli-util';
 import { Operation, Trigger } from '@dxos/compute';
-import { Database, Feed as FeedNs, Filter, JsonSchema, Ref } from '@dxos/echo';
+import { Database, Feed as Feed$, Filter, JsonSchema, Ref } from '@dxos/echo';
 import { EID } from '@dxos/keys';
 
 import { Enabled, Feed, Input } from '../options';
@@ -45,7 +45,7 @@ export const queue = Command.make(
 
       const feed = yield* Option.match(options.feed, {
         onNone: () => selectFeed(),
-        onSome: (uri) => Database.resolve(EID.parse(uri), FeedNs.Feed),
+        onSome: (uri) => Database.resolve(EID.parse(uri), Feed$.Feed),
       });
 
       const input = yield* Option.match(options.input, {

package/src/commands/trigger/update/queue.ts

@@ -13,7 +13,7 @@ import { CommandConfig } from '@dxos/cli-util';
 import { flushAndSync, print, spaceLayer, withTypes } from '@dxos/cli-util';
 import { Common } from '@dxos/cli-util';
 import { Operation, Trigger } from '@dxos/compute';
-import { Database, Feed as FeedNs, Filter, JsonSchema, Obj, Ref } from '@dxos/echo';
+import { Database, Feed as Feed$, Filter, JsonSchema, Obj, Ref } from '@dxos/echo';
 import { EID, type EntityId } from '@dxos/keys';
 
 import { Enabled, Feed, Input, TriggerId } from '../options';
@@ -124,7 +124,7 @@ const updateFeed = Effect.fn(function* (trigger: Trigger.Trigger, feedOption: Op
   if (shouldChangeFeed) {
     const feed = yield* Option.match(feedOption, {
       onNone: () => selectFeed(),
-      onSome: (uri) => Database.resolve(EID.parse(uri), FeedNs.Feed),
+      onSome: (uri) => Database.resolve(EID.parse(uri), Feed$.Feed),
     });
     Obj.update(trigger, (trigger) => {
       if (trigger.spec?.kind === 'feed') {

package/src/components/CreateAutomationPanel/CreateAutomationPanel.tsx

@@ -23,7 +23,7 @@ export type CreateAutomationPanelProps = SpaceCapabilities.CreateObjectCustomPan
  * template's `scaffold`.
  */
 export const CreateAutomationPanel = ({ onCreateObject, templates: templatesProp }: CreateAutomationPanelProps) => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   const capabilityTemplates = useCapabilities(AutomationCapabilities.Template);
   const templates = templatesProp ?? capabilityTemplates;
   // The global create dialog has no subject, so subject-required templates (e.g. CRM, which needs a

package/src/components/CronBuilder/CronBuilder.stories.tsx

@@ -0,0 +1,72 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import React, { useState } from 'react';
+
+import { translations as formTranslations } from '@dxos/react-ui-form/translations';
+import { withLayout, withTheme } from '@dxos/react-ui/testing';
+
+import { translations } from '#translations';
+
+import { describeCron, toCron } from './cron';
+import { CronBuilder } from './CronBuilder';
+import { FrequencyDefaults, type CronSpecType } from './schema';
+
+const DefaultStory = () => {
+  const [value, setValue] = useState<CronSpecType>(FrequencyDefaults.daily);
+  const cronString = toCron(value);
+  const description = describeCron(cronString);
+
+  return (
+    <div className='grid grid-cols-[1fr_1fr] gap-4 p-4'>
+      <div className='dx-container bg-card-surface rounded-md'>
+        <CronBuilder value={value} onChange={(v) => setValue(v)} />
+      </div>
+      <div className='dx-container bg-card-surface rounded-md p-4 flex flex-col gap-3'>
+        <div>
+          <p className='text-xs text-subdued mb-1'>Cron expression</p>
+          <code className='font-mono text-sm bg-baseSurface rounded px-2 py-1'>{cronString}</code>
+        </div>
+        <div>
+          <p className='text-xs text-subdued mb-1'>Description</p>
+          <p className='text-sm'>{description}</p>
+        </div>
+      </div>
+    </div>
+  );
+};
+
+const ReadonlyStory = () => {
+  const value = FrequencyDefaults.weekly;
+  return (
+    <div className='p-4'>
+      <div className='dx-container bg-card-surface rounded-md max-w-sm'>
+        <CronBuilder value={value} readonly />
+      </div>
+    </div>
+  );
+};
+
+const meta = {
+  title: 'plugins/plugin-automation/components/CronBuilder',
+  component: CronBuilder,
+  decorators: [withTheme(), withLayout({ layout: 'fullscreen' })],
+  parameters: {
+    layout: 'fullscreen',
+    translations: [...formTranslations, ...translations],
+  },
+} satisfies Meta<typeof CronBuilder>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  render: DefaultStory,
+};
+
+export const Readonly: Story = {
+  render: ReadonlyStory,
+};

package/src/components/CronBuilder/CronBuilder.tsx

@@ -0,0 +1,94 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import type * as SchemaAST from 'effect/SchemaAST';
+import React, { useCallback, useMemo } from 'react';
+
+import {
+  Form,
+  type FormFieldRendererProps,
+  type FormFieldMap,
+  type FormRootProps,
+  SelectField,
+  useFormFieldState,
+} from '@dxos/react-ui-form';
+
+import { toCron } from './cron';
+import {
+  CronBuilderSchema,
+  type CronBuilderSchemaType,
+  type CronSpecType,
+  FrequencyDefaults,
+  FrequencyLabels,
+  Frequencies,
+} from './schema';
+
+export type CronBuilderProps = {
+  value?: CronSpecType;
+  onChange?: (value: CronSpecType, cron: string) => void;
+} & Pick<FormRootProps, 'readonly'>;
+
+export const CronBuilder = ({ value, onChange, readonly }: CronBuilderProps) => {
+  const fieldMap = useFrequencyFieldMap();
+
+  const defaultValues = useMemo<CronBuilderSchemaType>(() => ({ spec: value ?? FrequencyDefaults.daily }), []);
+
+  const handleValuesChanged = useCallback(
+    (values: Partial<CronBuilderSchemaType>) => {
+      if (values.spec) {
+        onChange?.(values.spec, toCron(values.spec));
+      }
+    },
+    [onChange],
+  );
+
+  return (
+    <Form.Root<CronBuilderSchemaType>
+      schema={CronBuilderSchema}
+      defaultValues={defaultValues}
+      readonly={readonly}
+      fieldMap={fieldMap}
+      onValuesChanged={handleValuesChanged}
+    >
+      <Form.Viewport>
+        <Form.Content>
+          <Form.FieldSet />
+        </Form.Content>
+      </Form.Viewport>
+    </Form.Root>
+  );
+};
+
+CronBuilder.displayName = 'CronBuilder';
+
+const useFrequencyFieldMap = (): FormFieldMap => {
+  return useMemo(
+    (): FormFieldMap => ({
+      'spec.frequency': (props) => <FrequencySelector {...props} />,
+    }),
+    [],
+  );
+};
+
+const FrequencySelector = (props: FormFieldRendererProps) => {
+  // Access the parent `spec` field so switching frequency replaces the entire variant object.
+  const specState = useFormFieldState(FrequencySelector.displayName, ['spec']);
+
+  const handleChange = useCallback(
+    (_type: SchemaAST.AST, newFrequency: string) => {
+      const freq = Frequencies.find((f) => f === newFrequency);
+      if (!freq) {
+        return;
+      }
+      specState.onValueChange(props.type, FrequencyDefaults[freq]);
+    },
+    [props.type, specState],
+  );
+
+  const options = useMemo(() => Frequencies.map((freq) => ({ value: freq, label: FrequencyLabels[freq] })), []);
+
+  return <SelectField {...props} options={options} onValueChange={handleChange} />;
+};
+
+FrequencySelector.displayName = 'Form.FrequencySelector';

package/src/components/CronBuilder/cron.test.ts

@@ -0,0 +1,131 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { describe, test } from 'vitest';
+
+import { fromCron, toCron } from './cron';
+
+describe('toCron', () => {
+  test('minutely: every 15 minutes', ({ expect }) => {
+    expect(toCron({ frequency: 'minutely', interval: 15 })).toBe('*/15 * * * *');
+  });
+
+  test('minutely: every 1 minute', ({ expect }) => {
+    expect(toCron({ frequency: 'minutely', interval: 1 })).toBe('*/1 * * * *');
+  });
+
+  test('hourly: every hour at minute 0', ({ expect }) => {
+    expect(toCron({ frequency: 'hourly', interval: 1, minute: 0 })).toBe('0 */1 * * *');
+  });
+
+  test('hourly: every 6 hours at minute 30', ({ expect }) => {
+    expect(toCron({ frequency: 'hourly', interval: 6, minute: 30 })).toBe('30 */6 * * *');
+  });
+
+  test('daily: at 09:00', ({ expect }) => {
+    expect(toCron({ frequency: 'daily', hour: 9, minute: 0 })).toBe('0 9 * * *');
+  });
+
+  test('daily: at 22:30', ({ expect }) => {
+    expect(toCron({ frequency: 'daily', hour: 22, minute: 30 })).toBe('30 22 * * *');
+  });
+
+  test('weekly: Monday at 09:00', ({ expect }) => {
+    expect(toCron({ frequency: 'weekly', daysOfWeek: ['mon'], hour: 9, minute: 0 })).toBe('0 9 * * 1');
+  });
+
+  test('weekly: Mon, Wed, Fri at 08:00', ({ expect }) => {
+    expect(toCron({ frequency: 'weekly', daysOfWeek: ['mon', 'wed', 'fri'], hour: 8, minute: 0 })).toBe(
+      '0 8 * * 1,3,5',
+    );
+  });
+
+  test('weekly: Sunday (DOW=0) at midnight', ({ expect }) => {
+    expect(toCron({ frequency: 'weekly', daysOfWeek: ['sun'], hour: 0, minute: 0 })).toBe('0 0 * * 0');
+  });
+
+  test('weekly: empty daysOfWeek falls back to wildcard', ({ expect }) => {
+    expect(toCron({ frequency: 'weekly', daysOfWeek: [], hour: 9, minute: 0 })).toBe('0 9 * * *');
+  });
+
+  test('monthly: 1st at 09:00', ({ expect }) => {
+    expect(toCron({ frequency: 'monthly', daysOfMonth: [1], hour: 9, minute: 0 })).toBe('0 9 1 * *');
+  });
+
+  test('monthly: 1st and 15th at 12:00', ({ expect }) => {
+    expect(toCron({ frequency: 'monthly', daysOfMonth: [1, 15], hour: 12, minute: 0 })).toBe('0 12 1,15 * *');
+  });
+
+  test('monthly: empty daysOfMonth falls back to wildcard', ({ expect }) => {
+    expect(toCron({ frequency: 'monthly', daysOfMonth: [], hour: 9, minute: 0 })).toBe('0 9 * * *');
+  });
+
+  test('custom: pass-through full cron expression', ({ expect }) => {
+    expect(toCron({ frequency: 'custom', cronExpression: '0 9 * * MON-FRI' })).toBe('0 9 * * MON-FRI');
+  });
+
+  test('custom: empty cronExpression defaults to wildcard', ({ expect }) => {
+    expect(toCron({ frequency: 'custom', cronExpression: '' })).toBe('* * * * *');
+  });
+
+  test('custom: step expression preserved', ({ expect }) => {
+    expect(toCron({ frequency: 'custom', cronExpression: '0/15 * * * *' })).toBe('0/15 * * * *');
+  });
+});
+
+describe('fromCron', () => {
+  test('minutely', ({ expect }) => {
+    expect(fromCron('*/15 * * * *')).toEqual({ frequency: 'minutely', interval: 15 });
+  });
+
+  test('hourly', ({ expect }) => {
+    expect(fromCron('30 */6 * * *')).toEqual({ frequency: 'hourly', interval: 6, minute: 30 });
+  });
+
+  test('daily', ({ expect }) => {
+    expect(fromCron('0 9 * * *')).toEqual({ frequency: 'daily', hour: 9, minute: 0 });
+  });
+
+  test('weekly single day', ({ expect }) => {
+    expect(fromCron('0 9 * * 1')).toEqual({ frequency: 'weekly', daysOfWeek: ['mon'], hour: 9, minute: 0 });
+  });
+
+  test('weekly multiple days', ({ expect }) => {
+    expect(fromCron('0 8 * * 1,3,5')).toEqual({
+      frequency: 'weekly',
+      daysOfWeek: ['mon', 'wed', 'fri'],
+      hour: 8,
+      minute: 0,
+    });
+  });
+
+  test('monthly single day', ({ expect }) => {
+    expect(fromCron('0 9 1 * *')).toEqual({ frequency: 'monthly', daysOfMonth: [1], hour: 9, minute: 0 });
+  });
+
+  test('monthly multiple days', ({ expect }) => {
+    expect(fromCron('0 12 1,15 * *')).toEqual({ frequency: 'monthly', daysOfMonth: [1, 15], hour: 12, minute: 0 });
+  });
+
+  test('custom: unknown pattern', ({ expect }) => {
+    expect(fromCron('0 9 * * MON-FRI')).toEqual({ frequency: 'custom', cronExpression: '0 9 * * MON-FRI' });
+  });
+
+  test('custom: wrong field count', ({ expect }) => {
+    expect(fromCron('0 9 *')).toEqual({ frequency: 'custom', cronExpression: '0 9 *' });
+  });
+
+  test('round-trip: toCron → fromCron', ({ expect }) => {
+    const specs = [
+      { frequency: 'minutely' as const, interval: 15 },
+      { frequency: 'hourly' as const, interval: 4, minute: 30 },
+      { frequency: 'daily' as const, hour: 22, minute: 30 },
+      { frequency: 'weekly' as const, daysOfWeek: ['mon', 'wed'] as const, hour: 9, minute: 0 },
+      { frequency: 'monthly' as const, daysOfMonth: [1, 15], hour: 12, minute: 0 },
+    ];
+    for (const spec of specs) {
+      expect(fromCron(toCron(spec))).toEqual(spec);
+    }
+  });
+});