@abraca/cli 1.6.0 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abraca/cli",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "CLI for Abracadabra — interact with CRDT document workspaces from the terminal",
   "license": "MIT",
   "type": "module",

package/src/commands/meta.ts

@@ -32,13 +32,80 @@ registerCommand({
 
     const entry = toPlain(raw)
 
-    // Collect meta updates from remaining params
-    const metaKeys = new Set(['icon', 'color', 'priority', 'status', 'checked', 'rating',
-      'tags', 'dateStart', 'dateEnd', 'datetimeStart', 'datetimeEnd', 'allDay',
-      'url', 'email', 'phone', 'number', 'unit', 'subtitle', 'note',
-      'taskProgress', 'coverUploadId', 'geoType', 'geoLat', 'geoLng',
-      'deskX', 'deskY', 'deskMode', 'spShape', 'spColor', 'chartType',
-      'kanbanColumnWidth', 'galleryColumns', 'calendarView', 'tableMode',
+    // Known meta keys across all page types (universal + renderer-specific).
+    // Kept in sync with cou-sh/app/composables/useChildTree.ts DocPageMeta and
+    // the MCP PageMeta type.
+    const metaKeys = new Set([
+      // Universal display
+      'color', 'icon', 'subtitle', 'note',
+      // Datetime
+      'datetimeStart', 'datetimeEnd', 'allDay', 'dateStart', 'dateEnd',
+      'timeStart', 'timeEnd', 'dateTaken',
+      // Task/status
+      'checked', 'priority', 'status', 'taskProgress', 'rating', 'tags', 'members',
+      // Contact/value
+      'url', 'email', 'phone', 'number', 'unit',
+      // Cover
+      'coverUploadId', 'coverDocId', 'coverMimeType',
+      // Geo/Map (children)
+      'geoType', 'geoLat', 'geoLng', 'geoDescription',
+      // Dashboard (children)
+      'deskX', 'deskY', 'deskZ', 'deskMode',
+      // Mindmap layout (children)
+      'mmX', 'mmY',
+      // Graph layout (children)
+      'graphX', 'graphY', 'graphPinned',
+      // Spatial 3D children (plugin) — uses universal `color`, not spColor
+      'spShape', 'spOpacity', 'spX', 'spY', 'spZ',
+      'spRX', 'spRY', 'spRZ', 'spSX', 'spSY', 'spSZ',
+      'spModelUploadId', 'spModelDocId',
+      // Slides children
+      'slidesTransition',
+      // Coder children (plugin)
+      'fileType', 'entry',
+      // Sheets cell formatting
+      'bold', 'italic', 'textColor', 'bgColor', 'align', 'formula',
+      // Kanban renderer config (on page doc)
+      'kanbanColumnWidth',
+      // Gallery renderer config
+      'galleryColumns', 'galleryAspect', 'galleryCardStyle', 'galleryShowLabels', 'gallerySortBy',
+      // Calendar renderer config
+      'calendarView', 'calendarWeekStart', 'calendarShowWeekNumbers',
+      // Table renderer config
+      'tableMode', 'tableSortKey', 'tableSortDir',
+      // Timeline renderer config
+      'timelineZoom', 'timelinePixelsPerDay', 'timelineCenterDate',
+      // Checklist renderer config
+      'checklistFilter', 'checklistSort',
+      // Map renderer config
+      'mapShowLabels',
+      // Graph renderer config
+      'graphSpacing', 'graphShowLabels', 'graphEdgeThickness', 'showRefEdges',
+      // Mindmap renderer config
+      'mmSpacing',
+      // Spatial renderer config
+      'spatialGridVisible',
+      // Slides renderer config
+      'slidesTheme',
+      // Chart renderer config
+      'chartType', 'chartMetric', 'chartColorScheme', 'chartLimit',
+      'chartShowLegend', 'chartShowValues',
+      // Sheets renderer config
+      'sheetsDefaultColWidth', 'sheetsDefaultRowHeight', 'sheetsShowGridlines',
+      'sheetsFreezeRows', 'sheetsFreezeCols',
+      // Media renderer config (plugin)
+      'mediaRepeat', 'mediaShuffle',
+    ])
+
+    // Keys whose values should be parsed as numbers.
+    const numericKeys = new Set([
+      'priority', 'rating', 'number', 'taskProgress', 'geoLat', 'geoLng',
+      'deskX', 'deskY', 'deskZ', 'mmX', 'mmY', 'graphX', 'graphY',
+      'spOpacity', 'spX', 'spY', 'spZ', 'spRX', 'spRY', 'spRZ',
+      'spSX', 'spSY', 'spSZ',
+      'galleryColumns', 'chartLimit', 'timelinePixelsPerDay',
+      'sheetsDefaultColWidth', 'sheetsDefaultRowHeight',
+      'sheetsFreezeRows', 'sheetsFreezeCols',
     ])
 
     const updates: Record<string, unknown> = {}
@@ -53,8 +120,7 @@ registerCommand({
           updates[key] = true
         } else if (value === 'false') {
           updates[key] = false
-        } else if (['priority', 'rating', 'number', 'taskProgress', 'geoLat', 'geoLng',
-                     'deskX', 'deskY', 'galleryColumns'].includes(key)) {
+        } else if (numericKeys.has(key)) {
           updates[key] = parseFloat(value)
         } else if (key === 'tags') {
           updates[key] = value.split(',').map(s => s.trim())

package/src/commands/page-types.ts

@@ -0,0 +1,90 @@
+/**
+ * page-types / type-info commands: enumerate Abracadabra page types and their
+ * metadata schemas. Works without a server connection — the catalog is static.
+ */
+import { registerCommand } from '../command.ts'
+import type { CLIConnection } from '../connection.ts'
+import type { ParsedArgs } from '../parser.ts'
+import { printJson } from '../output.ts'
+import { PAGE_TYPES, TYPE_ALIASES, resolvePageType } from '../converters/page-types.ts'
+import type { PageTypeInfo, PageTypeMetaField } from '../converters/page-types.ts'
+
+function describeField(f: PageTypeMetaField): string {
+  const bits: string[] = []
+  bits.push(f.type as string)
+  if (f.key) bits.push(`key=${f.key}`)
+  if (f.latKey) bits.push(`latKey=${f.latKey},lngKey=${f.lngKey}`)
+  if (f.startKey) bits.push(`startKey=${f.startKey},endKey=${f.endKey}${f.allDayKey ? `,allDayKey=${f.allDayKey}` : ''}`)
+  if (f.options) bits.push(`options=[${f.options.join(', ')}]`)
+  if (f.presets) bits.push(`presets=${f.presets.length}`)
+  if (typeof f.min === 'number' || typeof f.max === 'number') bits.push(`range=${f.min ?? '?'}..${f.max ?? '?'}`)
+  if (f.step) bits.push(`step=${f.step}`)
+  if (f.unit) bits.push(`unit=${f.unit}`)
+  if (f.default !== undefined) bits.push(`default=${f.default}`)
+  return bits.join(' ')
+}
+
+registerCommand({
+  name: 'page-types',
+  aliases: ['types', 'doctypes'],
+  description: 'List Abracadabra page types and their metadata schemas.',
+  usage: 'page-types [key=<type>] [--format=json]',
+  async run(_conn: CLIConnection | null, args: ParsedArgs): Promise<string> {
+    const key = args.params['key'] || args.params['type'] || args.positional[0]
+    const asJson = args.flags.has('json') || args.params['format'] === 'json'
+
+    if (key) {
+      const info = resolvePageType(key)
+      if (!info) {
+        return `Unknown page type "${key}". Run 'abracadabra page-types' to list all.`
+      }
+      if (asJson) return printJson(info)
+
+      const lines: string[] = [
+        `${info.label}  (${info.key})${info.core ? '' : `  [plugin: ${info.plugin}]`}`,
+        info.description ? `  ${info.description}` : '',
+        `  icon:              ${info.icon}`,
+        `  supportsChildren:  ${info.supportsChildren}`,
+      ]
+      if (info.childLabel) lines.push(`  childLabel:        ${info.childLabel}`)
+      if (info.grandchildLabel) lines.push(`  grandchildLabel:   ${info.grandchildLabel}`)
+      if (info.defaultDepth !== undefined) lines.push(`  defaultDepth:      ${info.defaultDepth === -1 ? 'unlimited' : info.defaultDepth}`)
+
+      if (info.metaSchema?.length) {
+        lines.push('', `  metaSchema (applies to descendants):`)
+        for (const f of info.metaSchema) lines.push(`    - ${describeField(f)}${f.label ? `  "${f.label}"` : ''}`)
+      }
+      if (info.defaultMetaFields?.length) {
+        lines.push('', `  defaultMetaFields (renderer config on this doc):`)
+        for (const f of info.defaultMetaFields) lines.push(`    - ${describeField(f)}${f.label ? `  "${f.label}"` : ''}`)
+      }
+      return lines.filter(Boolean).join('\n')
+    }
+
+    // List all
+    const types = Object.values(PAGE_TYPES) as PageTypeInfo[]
+    if (asJson) return printJson({ types, aliases: TYPE_ALIASES })
+
+    const coreTypes = types.filter((t) => t.core)
+    const pluginTypes = types.filter((t) => !t.core)
+
+    const lines: string[] = ['Core page types:']
+    for (const t of coreTypes) {
+      const depth = t.defaultDepth === -1 ? '∞' : (t.grandchildLabel ? '2' : (t.supportsChildren ? '1' : '0'))
+      const nesting = [t.childLabel, t.grandchildLabel].filter(Boolean).join(' → ')
+      lines.push(`  ${t.key.padEnd(12)}${(nesting || '—').padEnd(28)}depth=${depth}`)
+    }
+    lines.push('', 'Plugin page types (require plugin):')
+    for (const t of pluginTypes) {
+      const depth = t.defaultDepth === -1 ? '∞' : (t.grandchildLabel ? '2' : (t.supportsChildren ? '1' : '0'))
+      const nesting = [t.childLabel, t.grandchildLabel].filter(Boolean).join(' → ')
+      lines.push(`  ${t.key.padEnd(12)}${(nesting || '—').padEnd(28)}depth=${depth}  [plugin: ${t.plugin}]`)
+    }
+    lines.push('', 'Aliases:')
+    for (const [from, to] of Object.entries(TYPE_ALIASES)) {
+      lines.push(`  ${from} → ${to}`)
+    }
+    lines.push('', `Run 'abracadabra page-types <key>' for field-level detail.`)
+    return lines.join('\n')
+  },
+})

package/src/converters/index.ts

@@ -5,6 +5,10 @@
  * not on the MCP SDK, so importing via the source export condition is safe.
  */
 // @ts-ignore — resolve via monorepo source condition
-export { yjsToMarkdown } from '../../mcp/src/converters/yjsToMarkdown.ts'
+export { yjsToMarkdown } from '../../../mcp/src/converters/yjsToMarkdown.ts'
 // @ts-ignore — resolve via monorepo source condition
-export { populateYDocFromMarkdown, parseFrontmatter } from '../../mcp/src/converters/markdownToYjs.ts'
+export { populateYDocFromMarkdown, parseFrontmatter } from '../../../mcp/src/converters/markdownToYjs.ts'
+// @ts-ignore — resolve via monorepo source condition
+export { PAGE_TYPES, TYPE_ALIASES, resolvePageType } from '../../../mcp/src/converters/page-types.ts'
+// @ts-ignore — resolve via monorepo source condition
+export type { PageTypeInfo, PageTypeMetaField, MetaFieldType } from '../../../mcp/src/converters/page-types.ts'

package/src/converters/page-types.ts

@@ -0,0 +1,5 @@
+// Re-export from @abraca/mcp converters (static data, no runtime deps).
+// @ts-ignore — resolve via monorepo relative path
+export { PAGE_TYPES, TYPE_ALIASES, resolvePageType } from '../../../mcp/src/converters/page-types.ts'
+// @ts-ignore — resolve via monorepo relative path
+export type { PageTypeInfo, PageTypeMetaField, MetaFieldType } from '../../../mcp/src/converters/page-types.ts'

package/src/index.ts

@@ -27,9 +27,10 @@ import './commands/meta.ts'
 import './commands/awareness.ts'
 import './commands/files.ts'
 import './commands/permissions.ts'
+import './commands/page-types.ts'
 
 // ── Commands that don't require a connection ─────────────────────────────────
-const NO_CONNECT_COMMANDS = new Set(['help', 'h', '?', 'version', 'v'])
+const NO_CONNECT_COMMANDS = new Set(['help', 'h', '?', 'version', 'v', 'page-types', 'types', 'doctypes'])
 
 async function main() {
   const args = parseArgs(process.argv)