rootr-cli 0.20.0 → 0.23.3

package/lib/mcp-tools/pages.js

@@ -26,7 +26,9 @@ import {
 const BLOCK_GUIDE =
   'A page is `blocks[]` (ordered, max 200) + `config`. Each block is {id?, type, props}. ' +
   'You assemble a page from these block types:\n' +
-  '· hero {title, subtitle?, align?:"left"|"center", background?:{kind:"color",color}|{kind:"image",attachmentId}, button?:{label,target}} — the opening banner\n' +
+  '· hero {title, subtitle?, align?:"left"|"center", size?:"normal"|"screen", background?:{kind:"color",color}|{kind:"image",attachmentId}, button?:{label,target}} — the opening banner. ' +
+  'size:"screen" makes it a FULL-SCREEN landing hero: edge to edge and one viewport tall (minus the top name bar, capped at 1200px), big headline, content centred vertically ' +
+  '(default "normal" = a compact banner inside the text column)\n' +
   '· text {body (markdown), title?} — prose section; markdown is sanitized when rendered\n' +
   '· features {columns?:1|2|3, items:[{title, body, icon?(emoji)}]} — "what it does" grid\n' +
   '· gallery {images:[{attachmentId, caption?}]} — images must be workspace attachments (no external image URLs)\n' +
@@ -40,12 +42,35 @@ const BLOCK_GUIDE =
   '· liveTable {source:{nodeId}, columns?:[name], rowLimit?(1-200), orderBy?:{column, dir:"asc"|"desc"}}\n' +
   '· liveChart {source:{nodeId, sheet?, range?}, chart, labelColumn, valueColumn?, agg?, …} — a LIVE chart (46 kinds, see CHARTS below)\n' +
   '· form {formNodeId(FORM node), headline?, submitLabel?} — visitors submit right on the page\n' +
-  '· custom {html, height?(40-4000, default 260)} — free HTML/CSS, rendered inside a locked-down sandboxed iframe ' +
+  '· booking {bookingNodeId(DATABASE node id — a table that is published with visitor booking turned on, see rootr_set_booking), headline?, type?} — ' +
+  'a visitor scheduling calendar right on the page; `type` shows only one of the table\'s booking types. ' +
+  'bookingNodeId must be the node ID (names/paths are not resolved here); a table that is not published or has booking off renders as "not taking bookings"\n' +
+  '· custom {html, height?(40-4000, default 260), minHeight?:"none"|"screen", bleed?:boolean} — free HTML/CSS, rendered inside a locked-down sandboxed iframe ' +
   '(no scripts, no same-origin, no network). Use it for a look the other blocks cannot make. Page theme colors are ' +
   'available inside as var(--pg-bg|text|muted|faint|card|line|accent|on-accent) and var(--pg-font). Scripts and ' +
-  'on*= handlers are stripped on save — do not put behaviour here, only markup and CSS.\n' +
+  'on*= handlers are stripped on save — do not put behaviour here, only markup and CSS. ' +
+  'bleed:true makes the frame span the FULL page width with no gap or padding around it, so consecutive bleed blocks ' +
+  'stack into seamless edge-to-edge colour bands (the sandbox is unchanged). Inside a bleed block paint your own ' +
+  'full-width background and keep the content in a centred max-width wrapper; still set `height` (the frame does not auto-size). ' +
+  'minHeight:"screen" makes the frame ONE VIEWPORT TALL on every device (same rule as hero size:"screen": minus the top name bar, capped at 1200px); ' +
+  'a numeric `height` given with it becomes the FLOOR — frame height = max(one screen, height) — so give the height your content ' +
+  'needs on a short phone and nothing is clipped. Inside, take the frame height with `height:100%` (html and body already are 100%) ' +
+  'and centre the content with flexbox. bleed:true + minHeight:"screen" = a full-screen section; stack several for a ' +
+  'section-per-screen landing page.\n' +
   'LAYOUT: any block takes `width:"full"|"twoThirds"|"half"|"third"` — neighbouring blocks sit side by side (phones stack them). ' +
-  'That is how a page becomes a DASHBOARD: a row of `chart:"kpi"` blocks at width "third", then charts at width "half".\n' +
+  'That is how a page becomes a DASHBOARD: a row of `chart:"kpi"` blocks at width "third", then charts at width "half". ' +
+  'A hero with size:"screen" and a custom block with bleed:true always take the whole row — `width` is ignored (not stored) on them.\n' +
+  'REVEAL (scroll-in animation): any block takes `reveal:"fade"|"fade-up"` (default "none" = always visible). On the published page ' +
+  'the block appears ONCE when it scrolls into view (its top passes ~85% of the viewport height; blocks already on the first screen ' +
+  'play right after load): "fade" fades in, "fade-up" also rises a little. A hero staggers title → subtitle → button while its ' +
+  'background stays put. On a custom block, reveal ALSO starts the CSS animations inside the frame at that moment — the sandboxed ' +
+  'frame is created only when the block scrolls in, so `@keyframes`/`animation` in your html run from 0s exactly when the visitor ' +
+  'sees the section (without reveal they start at page load and are over before anyone scrolls down). Write those animations so ' +
+  'the content is still fine without them and wrap them in `@media (prefers-reduced-motion: no-preference)`. Visitors who ask ' +
+  'for reduced motion, and browsers without IntersectionObserver, simply see everything at once; nothing shifts layout. The editor ' +
+  'always shows blocks (the effect plays in its preview mode and on the published page).\n' +
+  'LANDING PAGE: start with hero size:"screen", follow with custom bleed:true bands (add minHeight:"screen" where a section should fill the screen), and set config.navEnabled:false so the hero owns the first screen. ' +
+  'All other blocks stay in the centred text column.\n' +
   'CHARTS (liveChart): chart ∈ bar|barH|stackedBar|stackedBarH|percentBar|lollipop|dumbbell|bullet|waterfall|pareto|radar|polarBar|line|step|area|stackedArea|percentArea|combo|slope|stream|calendar|pie|donut|halfDonut|rose|funnel|treemap|sunburst|waffle|histogram|boxplot|heatmap|scatter|bubble|sankey|chord|network|tree|kpi|gauge|progress|ring|candlestick|gantt|wordCloud|pivot. ' +
   'source = a DATABASE, SPREADSHEET or LOG node (sheet: {nodeId, sheet?(name), range?:"A1:F200"} — first row = column names, formula results are read). ' +
   'Category charts: labelColumn (dates are bucketed: dateBucket day|week|month|quarter|year|weekday|hour, empty periods filled with 0) + ' +
@@ -69,8 +94,10 @@ const BLOCK_GUIDE =
   'for a document in the same workspace. Internal path strings are rejected. A node link renders as the in-app ' +
   'document for members, as the public address on the published page, and is hidden entirely if that document is ' +
   'not published — so link to nodes rather than pasting addresses.\n' +
-  'CONFIG: {theme, accentColor?, navEnabled?}. theme is one of classic | minimal | warm | pastel | editorial | mono | ' +
-  'dark | midnight. accentColor is a hex like "#1A4A7A"; leave it out and the theme picks a matching accent. ' +
+  'CONFIG: {theme, accentColor?, navEnabled?, metaPixelId?}. theme is one of classic | minimal | warm | pastel | editorial | mono | ' +
+  'dark | midnight. accentColor is a hex like "#1A4A7A"; leave it out and the theme picks a matching accent.' +
+  ' metaPixelId is the numeric Meta (Facebook/Instagram) Pixel ID: when set, the PUBLISHED page reports PageView and, when a visitor books through a booking block, Schedule to that pixel (never in the editor); send "" to turn it off. ' +
+  'config is replaced as a whole on update, so resend the keys you want to keep. ' +
   'Every published page carries the Rootr signature at the bottom.\n' +
   'Block ids are optional — omit them and they are generated. Keep the ids you get back if you want to edit one block later.';
 
@@ -104,7 +131,7 @@ export function registerPageTools(server) {
         config: z
           .record(z.unknown())
           .optional()
-          .describe('{theme, accentColor?, navEnabled?} — theme: classic|minimal|warm|pastel|editorial|mono|dark|midnight'),
+          .describe('{theme, accentColor?, navEnabled?, metaPixelId?} — theme: classic|minimal|warm|pastel|editorial|mono|dark|midnight; metaPixelId: numeric Meta Pixel ID'),
         workspace: z.string().optional().describe('Workspace id; defaults to ROOTR_WORKSPACE/config if omitted'),
       },
     },
@@ -186,7 +213,7 @@ export function registerPageTools(server) {
           .array(z.record(z.unknown()))
           .optional()
           .describe('COMPLETE blocks array to set — any block you omit is deleted'),
-        config: z.record(z.unknown()).optional().describe('{theme, accentColor?, navEnabled?}'),
+        config: z.record(z.unknown()).optional().describe('{theme, accentColor?, navEnabled?, metaPixelId?} — replaces the whole config'),
       },
     },
     async ({ pageId, blocks, config }) => {

package/lib/mcp-tools/presentations.js

@@ -24,6 +24,8 @@ const AUTHORING_GUIDE =
   'placement does not draw the image. For `images[]`, x/y/w/h give freeform PPT-style placement in 1280x720 canvas ' +
   'coords (drawn only when both x and y are set). ALWAYS add an `alt` caption to every image — alt text is part of the graph text spine, so a captioned image ' +
   'connects into the knowledge graph while an uncaptioned one does not.\n' +
+  'Videos (Team plan and above — a Free workspace gets 403 PLAN_UPGRADE_REQUIRED when it ADDS a video; existing ones stay editable/removable): `videos[]` (max 20 per slide) holds {id?, src, title?, poster?, x?, y?, w?, h?} in 1280x720 canvas coords (default 640x360 centred). `src` is an uploaded video file URL (upload mp4/webm ≤75MB via rootr_upload_attachment with nodeId = this deck, then use /api/v1/attachments/{id}/raw), an https video-file URL, or a YouTube/Vimeo link; `poster` is an image URL (thumbnail). `title` is a caption and joins the graph text spine. Slide `html` may instead contain <video src="…/v1/attachments/{id}/raw" controls>, <div data-video-embed="https://www.youtube.com/watch?v=…">, or a YouTube/Vimeo <iframe>. Uploaded videos play through short-lived signed URLs (`vt=` query) the server adds when it returns the slide — never write `vt=` yourself; it is stripped on save.\n' +
+  'Animations (all plans): in slide `html`, add data-anim="<effect>" to any element to animate it when the slide opens in view/present mode. Entrance effects: fade, fade-up, fade-down, fly-left, fly-right, zoom, pop, blur. Looping effects: pulse, float, spin, blink, shake. Duration/delay go in inline CSS variables, e.g. <div data-anim="fade-up" style="--anim-delay:.4s;--anim-dur:.8s">; stagger delays to set the order. Thumbnails and PDF/PPTX exports show the finished state. Your own @keyframes/animation CSS in the html also plays.\n' +
   'Use kind to mark each slide\'s role: "cover" (deck title slide), "section" (chapter divider), "content" (body slide, ' +
   'the default), "closing" (last slide / call to action).\n' +
   'Page numbers: "content" and "section" slides automatically show a page number that follows the slide order (it ' +
@@ -70,6 +72,19 @@ const imageShape = z
   })
   .describe('A slide image. Set src (uploaded/https/data: URI) or prompt (AI-generate); always add an alt caption.');
 
+const videoShape = z
+  .object({
+    id: z.string().optional().describe('Stable video id. Auto-generated by the editor if omitted.'),
+    src: z.string().describe('Uploaded video URL (/api/v1/attachments/{id}/raw), https video file URL, or a YouTube/Vimeo link'),
+    title: z.string().optional().describe('Caption — part of the graph text spine'),
+    poster: z.string().optional().describe('Thumbnail image URL for file videos'),
+    x: z.number().optional().describe('Left in 1280x720 canvas px'),
+    y: z.number().optional().describe('Top in 1280x720 canvas px'),
+    w: z.number().optional().describe('Width px (default 640)'),
+    h: z.number().optional().describe('Height px (default 360)'),
+  })
+  .describe('A video placed on a slide. Team plan and above.');
+
 const slideShape = z
   .object({
     id: z.string().optional().describe('Unique slide id, e.g. "SLD-001". Auto-generated if omitted.'),
@@ -108,6 +123,10 @@ const slideShape = z
       .array(imageShape)
       .optional()
       .describe('Additional inserted/uploaded images placed on the slide (up to 50). Each should carry an alt caption.'),
+    videos: z
+      .array(videoShape)
+      .optional()
+      .describe('Videos placed on the slide (Team plan+, up to 20): {src (uploaded /attachments/{id}/raw URL, https video file, or YouTube/Vimeo link), title?, poster?, x?, y?, w?, h? in 1280x720 coords}.'),
     code: z.string().optional().describe('Code-first React slide source (max design freedom, advanced use)'),
     html: z.string().optional().describe('Rendered self-contained slide HTML (usually machine-produced, not hand-authored)'),
     notes: z.string().optional().describe('Speaker notes — text spine'),

package/lib/mcp-tools/workspaces.js

@@ -41,6 +41,11 @@ const ACCESS_HINT =
   'lock) and `database.notifications` (who to notify on row changes). A database property may carry ' +
   '`searchExcluded: true` (values stay out of the search index behind ask / AI explore / similar rows — not a read permission) and a `type: "vector"` ' +
   'property needs `dimensions` (an embedding column agents fill with rootr_set_row_vectors). ' +
+  'A phone/email/name property may carry `dedupe: true` (warn when the same person is entered again) with ' +
+  '`dedupeShow: ["진행상태","특이사항","콜 이력"]` (fields of the existing row the warning shows — a relation shows its latest 5 rows); ' +
+  'a relation property may carry `relationFilter: [{ propId, op: "is"|"is_not_empty", values? }]` (which linked rows may be picked). ' +
+  'A board view config may carry `cardProps: ["면접예정일","연락처"]` (fields on each card, rollups too) and any view `rowColors` ' +
+  '(`[{ propId, op: "is"|"is_not_empty", values?, color }]`). ' +
   'A DOCUMENT\'s `content` may embed a live ' +
   'table/sheet/deck with a line `[[embed:<name of a node in this same tree>]]` or `[[embed:/absolute/path]]` — it is ' +
   'linked to the real node after the whole tree is built (an unknown name rolls the whole tree back).';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rootr-cli",
-  "version": "0.20.0",
+  "version": "0.23.3",
   "description": "Official Rootr CLI + MCP server — read, write, edit and search Rootr documents from the shell or from an AI agent.",
   "type": "module",
   "bin": {