@astryxdesign/cli 0.6.3-canary.db4e378 → 0.6.3-canary.db52d98

package/authoring/doctypes/theme/parse.mjs

@@ -0,0 +1,76 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file Theme doc parser (stamped `type: 'theme'`). Zod is sealed here;
+ * theme discovery calls `parseTheme` at the descriptor load boundary.
+ *
+ * @input an unknown loaded or statically extracted theme descriptor
+ * @output a validated ThemeDoc or a readable schema error
+ * @position packages/cli/authoring/doctypes/theme — descriptor load boundary
+ */
+
+import {z} from 'zod';
+import {formatZodError} from '../../_shared/errors.mjs';
+
+/** @typedef {import('./type.js').ThemeDoc} ThemeDoc */
+
+/** @param {string} field */
+const nonBlank = field =>
+  z.string().refine(value => value.trim() !== '', {
+    message: `${field} must not be blank`,
+    abort: true,
+  });
+
+const themeDocSchema = z
+  .object({
+    type: z.literal('theme'),
+    name: nonBlank('name').regex(
+      /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/u,
+      'name must be lowercase kebab-case starting with a letter',
+    ),
+    displayName: nonBlank('displayName'),
+    // Blank is allowed, as the released catalog allowed it.
+    description: z.string(),
+    maintained: z.boolean(),
+  })
+  .strict();
+
+/** Zod skips `__proto__` when it looks for unknown keys. */
+const PROTO_KEY_ISSUE = {
+  code: /** @type {const} */ ('unrecognized_keys'),
+  keys: ['__proto__'],
+  path: [],
+  message: 'Unrecognized key: "__proto__"',
+};
+
+/**
+ * Compile-time drift lock: the sealed schema must infer exactly ThemeDoc.
+ *
+ * @typedef {import('../../_shared/contract.js').Expect<
+ *   import('../../_shared/contract.js').Equal<
+ *     z.infer<typeof themeDocSchema>,
+ *     ThemeDoc
+ *   >
+ * >} _ThemeDocDriftLock
+ */
+
+/**
+ * Validate an unknown value as a theme descriptor, or throw.
+ *
+ * @param {unknown} input
+ * @param {string} [label]
+ * @returns {ThemeDoc}
+ */
+export function parseTheme(input, label = 'theme') {
+  const result = themeDocSchema.safeParse(input);
+  const protoKey =
+    input !== null &&
+    typeof input === 'object' &&
+    Object.hasOwn(input, '__proto__');
+  if (result.success && !protoKey) return result.data;
+  const issues = [
+    ...(result.error?.issues ?? []),
+    ...(protoKey ? [PROTO_KEY_ISSUE] : []),
+  ];
+  throw new Error(formatZodError(label, new z.ZodError(issues)));
+}

package/authoring/doctypes/theme/theme.doc.d.mts

@@ -0,0 +1,9 @@
+// @generated by scripts/sync-api-types.mjs from the JSDoc in authoring/**/*.mjs.
+// DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
+
+/**
+ * @file SchemaDoc for the ThemeDoc authoring type.
+ * @position packages/cli/authoring/doctypes/theme — doc-type documentation
+ */
+/** @type {import('@astryxdesign/cli/authoring').SchemaDoc} */
+export const doc: import("@astryxdesign/cli/authoring").SchemaDoc;

package/authoring/doctypes/theme/theme.doc.mjs

@@ -0,0 +1,79 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file SchemaDoc for the ThemeDoc authoring type.
+ * @position packages/cli/authoring/doctypes/theme — doc-type documentation
+ */
+
+/** @type {import('@astryxdesign/cli/authoring').SchemaDoc} */
+export const doc = {
+  type: 'schema',
+  name: 'theme-doc',
+  displayName: 'ThemeDoc',
+  namespace: 'authoring',
+  description:
+    'The strongly typed descriptor for one integration or CLI-bundled source theme.',
+  appliesTo: '<theme-source-stem>.doc.mjs',
+  fields: [
+    {
+      name: 'type',
+      type: "'theme'",
+      description: 'Doc-kind discriminant.',
+      required: true,
+    },
+    {
+      name: 'name',
+      type: 'string',
+      description:
+        'Lower-kebab CLI theme identity. Must match the descriptor parent directory.',
+      required: true,
+      example: "'ocean'",
+    },
+    {
+      name: 'displayName',
+      type: 'string',
+      description: 'Human-readable name shown by theme listings.',
+      required: true,
+      example: "'Ocean'",
+    },
+    {
+      name: 'description',
+      type: 'string',
+      description: 'One-line summary shown by theme listings.',
+      required: true,
+    },
+    {
+      name: 'maintained',
+      type: 'boolean',
+      description: 'Whether the owning package actively maintains this theme.',
+      required: true,
+    },
+  ],
+  examples: [
+    {
+      label: 'A theme descriptor beside oceanTheme.ts',
+      code: `/** @type {import('@astryxdesign/cli/authoring').ThemeDoc} */
+export default {
+  type: 'theme',
+  name: 'ocean',
+  displayName: 'Ocean',
+  description: 'Cool blue surfaces with crisp contrast.',
+  maintained: true,
+};`,
+    },
+  ],
+  notes: [
+    {
+      type: 'prose',
+      text: 'ThemeDoc is static metadata. Default-export one object with literal string and boolean fields; discovery validates it without executing the descriptor or theme source.',
+    },
+    {
+      type: 'prose',
+      text: 'The descriptor and source share one stem. For oceanTheme.doc.mjs, discovery requires exactly one oceanTheme source module and a named oceanTheme runtime export.',
+    },
+    {
+      type: 'prose',
+      text: 'The parent theme directory, including this descriptor, is the complete copy and pack boundary. Nested source, palettes, assets, and receipts need no second file list.',
+    },
+  ],
+};

package/authoring/doctypes/theme/type.ts

@@ -0,0 +1,42 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file Theme contribution descriptor type.
+ *
+ * A theme descriptor is a strongly typed `.doc.mjs` beside its same-stem theme
+ * source. The shared stem identifies the source entry and required named runtime
+ * export. The lower-kebab parent directory and `name` identify the CLI theme.
+ *
+ * @input metadata authored beside one source theme
+ * @output the public ThemeDoc contract
+ * @position packages/cli/authoring/doctypes/theme — theme descriptor vocabulary
+ */
+
+/**
+ * The descriptor for one source theme contributed by an integration or bundled
+ * with the CLI.
+ *
+ * @example
+ * ```
+ * /** @type {import('@astryxdesign/cli/authoring').ThemeDoc} *\/
+ * export default {
+ *   type: 'theme',
+ *   name: 'ocean',
+ *   displayName: 'Ocean',
+ *   description: 'Cool blue surfaces with crisp contrast.',
+ *   maintained: true,
+ * };
+ * ```
+ */
+export interface ThemeDoc {
+  /** Doc-kind discriminant. */
+  type: 'theme';
+  /** Stable CLI identity. Must be lower-kebab and match the parent directory. */
+  name: string;
+  /** Human-readable name shown by theme listings. */
+  displayName: string;
+  /** One-line summary shown by theme listings. */
+  description: string;
+  /** Whether the owning package actively maintains this theme. */
+  maintained: boolean;
+}

package/authoring/doctypes/types.ts

@@ -3,7 +3,7 @@
 /**
  * @file Doc-type vocabulary barrel. Each kind's types live in one `type.ts`
  * under its folder (`base/` shared leaves, then `component/`, `hook/`,
- * `reference/`, `template/`); this re-exports them as the full doc vocabulary
+ * `reference/`, `template/`, `theme/`); this re-exports them as the full doc vocabulary
  * behind `@astryxdesign/cli/authoring`.
  */
 
@@ -17,3 +17,4 @@ export type * from './template/type.js';
 export type * from './schema/type.js';
 export type * from './command/type.js';
 export type * from './enum/type.js';
+export type * from './theme/type.js';

package/authoring/gap-report/gap-report.doc.d.mts

@@ -0,0 +1,12 @@
+// @generated by scripts/sync-api-types.mjs from the JSDoc in authoring/**/*.mjs.
+// DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
+
+/**
+ * @file SchemaDoc for GapReportHandler, the handler `astryx gap-report` calls.
+ * @input The GapReportHandler type beside it (`type.ts`), which `parse.mjs`
+ *   validates.
+ * @output The `gap-report-handler` section of `astryx docs authoring`.
+ * @position packages/cli/authoring/gap-report — schema documentation
+ */
+/** @type {import('@astryxdesign/cli/authoring').SchemaDoc} */
+export const doc: import("@astryxdesign/cli/authoring").SchemaDoc;

package/authoring/gap-report/gap-report.doc.mjs

@@ -0,0 +1,183 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file SchemaDoc for GapReportHandler, the handler `astryx gap-report` calls.
+ * @input The GapReportHandler type beside it (`type.ts`), which `parse.mjs`
+ *   validates.
+ * @output The `gap-report-handler` section of `astryx docs authoring`.
+ * @position packages/cli/authoring/gap-report — schema documentation
+ */
+
+/** @type {import('@astryxdesign/cli/authoring').SchemaDoc} */
+export const doc = {
+  type: 'schema',
+  name: 'gap-report-handler',
+  displayName: 'GapReportHandler',
+  namespace: 'authoring',
+  description:
+    'A handler for `astryx gap-report`: a plain object with an `audience` and a `handle` function. Set it as `gapReport` in astryx.config, or export it as `gapReport` from an integration manifest. Every handler runs: the project handler first, then each integration handler in config order.',
+  appliesTo:
+    '`gapReport` in astryx.config.*, or the `gapReport` named export of astryx.integration.*',
+  fields: [
+    {
+      name: 'audience',
+      type: "'internal' | 'public'",
+      description:
+        'Whether the destination is internal to your organization or public. A public handler runs only when the caller agrees; an internal handler always runs.',
+      required: true,
+    },
+    {
+      name: 'handle',
+      type: '(report: GapReport, context: GapReportHandlerContext) => GapReportHandlerReceipt | Promise<GapReportHandlerReceipt>',
+      description:
+        'Gets the report and returns a receipt. It can be async, and the CLI waits at most 30 seconds for it. A throw, a timeout, or an invalid receipt is a failed delivery, and the other handlers still run.',
+      required: true,
+      fields: [
+        {
+          name: 'report',
+          type: 'GapReport',
+          description: 'The report. Each handler gets its own copy.',
+          required: true,
+          fields: [
+            {
+              name: 'report.schemaVersion',
+              type: '1',
+              description: 'Version of the report shape.',
+              required: true,
+            },
+            {
+              name: 'report.component',
+              type: 'string',
+              description: 'The component the gap is about.',
+              required: true,
+            },
+            {
+              name: 'report.category',
+              type: 'GapReportCategory',
+              description:
+                "The kind of gap: 'missing_component', 'missing_variant', 'layout_gap', 'styling_gap', 'a11y_gap', 'api_friction', 'docs_gap', or 'other'.",
+              required: true,
+            },
+            {
+              name: 'report.categoryLabel',
+              type: 'string',
+              description: 'A readable name for the category.',
+              required: true,
+            },
+            {
+              name: 'report.intention',
+              type: 'string',
+              description: 'What the caller was trying to do.',
+              required: true,
+            },
+            {
+              name: 'report.detail',
+              type: 'string',
+              description: 'More detail, when the caller gave some.',
+            },
+            {
+              name: 'report.source',
+              type: 'DebugInvocationSource',
+              description:
+                "Who sent the report: 'human', 'ai', 'automation', or 'unknown'.",
+              required: true,
+            },
+            {
+              name: 'report.timestamp',
+              type: 'string',
+              description: 'When the report was sent, as ISO 8601.',
+              required: true,
+            },
+            {
+              name: 'report.target',
+              type: 'GapReportTarget',
+              description: 'The package the report is about.',
+              required: true,
+              fields: [
+                {
+                  name: 'report.target.package',
+                  type: 'string',
+                  description: 'The package name.',
+                  required: true,
+                },
+                {
+                  name: 'report.target.version',
+                  type: 'string',
+                  description:
+                    'The installed version. Null when it is not known.',
+                  required: true,
+                },
+                {
+                  name: 'report.target.issuesUrl',
+                  type: 'string',
+                  description:
+                    'Where the package takes issues. Null when it does not say.',
+                  required: true,
+                },
+              ],
+            },
+          ],
+        },
+        {
+          name: 'context',
+          type: 'GapReportHandlerContext',
+          description: 'The context of this call.',
+          required: true,
+          fields: [
+            {
+              name: 'context.signal',
+              type: 'AbortSignal',
+              description: 'Aborted when the handler runs past 30 seconds.',
+              required: true,
+            },
+          ],
+        },
+      ],
+    },
+  ],
+  examples: [
+    {
+      label: 'A project handler in astryx.config',
+      code:
+        'export default {\n' +
+        '  gapReport: {\n' +
+        "    audience: 'internal',\n" +
+        '    async handle(report, {signal}) {\n' +
+        '      const url = await fileIssue(report, {signal});\n' +
+        "      return {status: 'filed', url};\n" +
+        '    },\n' +
+        '  },\n' +
+        '};',
+    },
+  ],
+  notes: [
+    {
+      type: 'table',
+      headers: ['Receipt field', 'Type', 'Required', 'Description'],
+      rows: [
+        [
+          'status',
+          "'filed' | 'routed_only' | 'skipped'",
+          'yes',
+          "'filed': the handler created or queued the report. 'routed_only': it points to a place to file the report, and must return `url`. 'skipped': it chose not to act, for example on a duplicate.",
+        ],
+        [
+          'url',
+          'string',
+          'no',
+          'An http or https URL. Required when status is routed_only.',
+        ],
+        [
+          'message',
+          'string',
+          'no',
+          'A readable message of at most 2000 characters.',
+        ],
+      ],
+    },
+    {
+      type: 'prose',
+      text: 'The receipt is strict: an unknown field, a URL that is not http or https, or a filed or routed_only receipt with neither `url` nor `message` is invalid.',
+    },
+  ],
+};

package/authoring/identity/identity.doc.mjs

@@ -12,9 +12,9 @@ export const doc = {
   displayName: 'Provider and artifact identity',
   namespace: 'authoring',
   description:
-    'Separates stable provider/artifact identity from package instances and runtime lifecycle state. providerId is in use today: an integration manifest may declare it, and Doctor and every command report two packages that claim one. The artifact, doc, instance, and compiler-input identities are defined for the docs graph, which is not built yet, and no command reads them.',
+    'Separates stable provider/artifact identity from package instances and runtime lifecycle state. Provider identity names integration manifests and settles provider conflicts. Docs-tree nodes are identified by doc identity; the tree covers the CLI\'s own docs. Artifact, instance, and compiler-input identities are defined for every provider-owned artifact; no command reads them.',
   appliesTo:
-    'Integration manifests and provider conflicts today; the docs graph once it ships',
+    'Integration manifests, provider conflicts, and docs-tree node ids.',
   fields: [
     {
       name: 'ProviderId',

package/authoring/index.d.mts

@@ -15,5 +15,6 @@ export { parseSchema } from "./doctypes/schema/parse.mjs";
 export { parseCommand } from "./doctypes/command/parse.mjs";
 export { parseEnum } from "./doctypes/enum/parse.mjs";
 export { parseNamespace } from "./doctypes/namespace/parse.mjs";
+export { parseTheme } from "./doctypes/theme/parse.mjs";
 export { parseLegacyDoc } from "./doctypes/legacy.mjs";
 export { parseGapReportHandler, parseGapReportReceipt } from "./gap-report/parse.mjs";

package/authoring/index.d.ts

@@ -23,15 +23,16 @@
 // ═══════════════════════════════════════════════════════════════════════
 // AUTHOR THESE — each is the default export of one authored file.
 // ═══════════════════════════════════════════════════════════════════════
-export type {ComponentDoc} from './doctypes/types.js'; //   Button.doc.{ts,mjs}
-export type {HookDoc} from './doctypes/types.js'; //         useToast.doc.{ts,mjs}
+export type {ComponentDoc} from './doctypes/types.js'; //   Button.doc.mjs
+export type {HookDoc} from './doctypes/types.js'; //         useToast.doc.mjs
 export type {FunctionDoc} from './doctypes/types.js'; //     search.doc.mjs (hook | api)
-export type {ReferenceDoc} from './doctypes/types.js'; //    theming.doc.{ts,mjs}
-export type {TemplateDoc} from './doctypes/types.js'; //     Foo.template.{ts,mjs}
+export type {ReferenceDoc} from './doctypes/types.js'; //    theming.doc.mjs
+export type {TemplateDoc} from './doctypes/types.js'; //     Foo.doc.mjs
 export type {SchemaDoc} from './doctypes/types.js'; //       config.doc.mjs (object shape)
 export type {CommandDoc} from './doctypes/types.js'; //      search.doc.mjs (CLI command)
 export type {EnumDoc} from './doctypes/types.js'; //         error-codes.doc.mjs (vocabulary)
 export type {NamespaceDoc} from './doctypes/types.js'; //    cli.doc.mjs (hierarchy)
+export type {ThemeDoc} from './doctypes/types.js'; //        oceanTheme.doc.mjs
 export type {AstryxConfig} from './config/type.js'; //       astryx.config.{ts,mjs}
 export type {DebugEvent} from './debug/type.js'; //          one recorded CLI run
 export type {AstryxIntegration} from './integration/type.js'; // astryx.integration.{ts,mjs}
@@ -58,6 +59,7 @@ export {parseSchema} from './doctypes/schema/parse.mjs';
 export {parseCommand} from './doctypes/command/parse.mjs';
 export {parseEnum} from './doctypes/enum/parse.mjs';
 export {parseNamespace} from './doctypes/namespace/parse.mjs';
+export {parseTheme} from './doctypes/theme/parse.mjs';
 export {parseLegacyDoc} from './doctypes/legacy.mjs';
 export {parseConfig} from './config/parse.mjs';
 export {parseIntegration} from './integration/parse.mjs';
@@ -129,6 +131,7 @@ export type {
   // reference
   ReferenceSection,
   ReferenceContentBlock,
+  GraphContentBlock,
   ReferenceTokenPreviewType,
   ReferenceTranslationDoc,
   WorkflowStep,

package/authoring/index.mjs

@@ -11,7 +11,7 @@
  * `type` directly.
  *
  * Types (config, integration, codemod, and the doc vocabulary —
- * component/hook/reference/template) are re-exported via `./index.ts`.
+ * component/hook/reference/template/theme) are re-exported via `./index.ts`.
  */
 
 export {parseConfig} from './config/parse.mjs';
@@ -32,4 +32,5 @@ export {parseSchema} from './doctypes/schema/parse.mjs';
 export {parseCommand} from './doctypes/command/parse.mjs';
 export {parseEnum} from './doctypes/enum/parse.mjs';
 export {parseNamespace} from './doctypes/namespace/parse.mjs';
+export {parseTheme} from './doctypes/theme/parse.mjs';
 export {parseLegacyDoc} from './doctypes/legacy.mjs';

package/authoring/integration/integration.doc.mjs

@@ -11,7 +11,7 @@ export const doc = {
   type: 'schema',
   name: 'integration',
   displayName: 'Astryx Integration',
-  namespace: 'cli',
+  namespace: 'authoring',
   description:
     'The astryx.integration.* manifest that sits beside an integration ' +
     "package's package.json. It can preserve a stable provider identity across a package rename, " +
@@ -57,7 +57,7 @@ export const doc = {
       name: 'themes',
       type: 'string',
       description:
-        'Relative path to a source-theme catalog root containing manifest.json plus one directory per theme slug. Installed themes appear in `astryx theme list` and can be copied with `astryx theme add`.',
+        'Relative path to a source-theme root with one directory per theme slug. Each directory contains a source module and mandatory same-stem, strongly typed .doc.mjs descriptor. Installed themes appear in `astryx theme list` and can be copied with `astryx theme add`.',
       example: "'./themes'",
     },
     {

package/authoring/integration/type.ts

@@ -11,7 +11,7 @@
  * The manifest module may also carry `debug` and `gapReport` NAMED exports.
  * They are not fields here on purpose: a CLI released before a given manifest
  * field existed could reject it and lose every contribution, while an unknown
- * named export is simply not read. See the `cli-integrations` doc topic.
+ * named export is simply not read. See `astryx docs cli/integrations`.
  */
 export interface AstryxIntegration {
   /** Stable logical provider ID. Omit to use package.json#name. Set this only
@@ -34,15 +34,9 @@ export interface AstryxIntegration {
    *  serves from `astryx docs`, alongside the built-in ones. A topic may also
    *  `replace` or `extend` a built-in topic; see the ReferenceDoc type. */
   docs?: string;
-  /** Relative path to the source-theme catalog root (resolved to absolute).
-   *  The root contains `manifest.json` plus one directory per theme slug.
-   *  `manifest.json` is `{ "version": 1, "themes": [...] }` where each
-   *  entry requires `slug`, `displayName`, `description` (string),
-   *  `maintained` (boolean), `entry` (source file relative to `themes/<slug>/`),
-   *  `exportName` (a valid JS identifier naming the runtime export), and
-   *  `files` (non-empty array of filenames relative to `themes/<slug>/`).
-   *  Every file listed must exist on disk; the entry file must also appear
-   *  in `files`. */
+  /** Relative path to the source-theme root (resolved to absolute). Each
+   *  lower-kebab theme directory contains a source module and mandatory
+   *  same-stem, strongly typed `.doc.mjs` descriptor. */
   themes?: string;
   /** Static package guidance appended to the CLI-owned managed agent block. */
   agentDocs?: {

package/clients/cli/__tests__/cliManifest.test.ts

@@ -3,37 +3,35 @@
 import fs from 'fs';
 import path from 'path';
 import {describe, it, expect} from 'vitest';
-
-describe('@astryxdesign/cli Theme Manifest & Template Validation', () => {
-  const manifestPath = path.resolve(
-    'packages/cli/assets/templates/themes/manifest.json',
-  );
-
-  it('validates theme manifest existence and structure', () => {
-    expect(fs.existsSync(manifestPath)).toBe(true);
-    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
-
-    expect(manifest.version).toBe(1);
-    expect(Array.isArray(manifest.themes)).toBe(true);
-    expect(manifest.themes.length).toBeGreaterThan(0);
-  });
-
-  it('verifies all referenced theme files exist', () => {
-    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
-    const themesDir = path.dirname(manifestPath);
-
-    for (const theme of manifest.themes) {
-      expect(theme.slug).toBeDefined();
-      expect(theme.displayName).toBeDefined();
-      expect(theme.entry).toBeDefined();
-
-      const entryPath = path.join(themesDir, theme.slug, theme.entry);
-      expect(fs.existsSync(entryPath)).toBe(true);
-
+import {discoverBundledThemes} from '../../../foundation/discovery/theme-discovery.mjs';
+
+describe('@astryxdesign/cli bundled theme descriptor validation', () => {
+  it('discovers typed descriptors and their same-stem source files', () => {
+    const themes = discoverBundledThemes();
+    expect(themes.length).toBeGreaterThan(0);
+
+    for (const theme of themes) {
+      expect(theme.slug).toBeTruthy();
+      expect(theme.displayName).toBeTruthy();
+      expect(theme.docPath).toBe(
+        path.join(
+          theme.sourceDir,
+          `${path.basename(theme.entry, path.extname(theme.entry))}.doc.mjs`,
+        ),
+      );
+      expect(fs.existsSync(theme.docPath)).toBe(true);
+      expect(fs.existsSync(path.join(theme.sourceDir, theme.entry))).toBe(true);
       for (const file of theme.files) {
-        const filePath = path.join(themesDir, theme.slug, file);
-        expect(fs.existsSync(filePath)).toBe(true);
+        expect(fs.existsSync(path.join(theme.sourceDir, file))).toBe(true);
       }
     }
   });
+
+  it('does not ship the obsolete central theme catalog', () => {
+    expect(
+      fs.existsSync(
+        path.resolve('packages/cli/assets/templates/themes/manifest.json'),
+      ),
+    ).toBe(false);
+  });
 });

package/clients/cli/commands/blog.doc.mjs

@@ -12,7 +12,7 @@ export const doc = {
   type: 'command',
   name: 'blog',
   displayName: 'astryx blog',
-  namespace: 'cli',
+  namespace: 'cli/commands',
   summary: 'Read the Astryx blog from the published feed',
   description:
     'Reads the design-system blog over its published RSS feed (never the source ' +