@kezlahd/atlas-mcp 0.2.0 → 0.3.0

package/dist/section-catalog.js

@@ -9,18 +9,22 @@
  * to reason about the shape; what it needs is a nudge on the field
  * *names* and *ranges*, not a full API doc.
  */
-export const SECTION_CATALOG = [
+/** Every section accepts a top-level `hidden: boolean`. Appended to each
+ * entry's `common_fields` by the exported `SECTION_CATALOG` so Claude
+ * sees it on every describe-section-type call. */
+const HIDDEN_FIELD = "hidden?: boolean — hide section from the printed output without deleting (dimmed in editor)";
+const RAW_CATALOG = [
     {
         type: "cover",
         purpose: "Full-bleed cover page: title, subtitle, date, workspace lockup, optional hero image.",
-        data_shape: "Held on TemplateContent.cover, not on a section.data.",
+        data_shape: "Held on TemplateContent.cover, NOT on a section.data. Update via atlas_update_cover (scoped merge) — atlas_update_section can't touch the cover.",
         common_fields: [
             "subtitle: string",
             "date: string (free-form or ISO)",
-            "bgImageUrl: string | null",
+            "bgImageUrl: string | null — SIGNED URL (not a storage key) — pass storage keys through atlas_get_file_url first",
             "titlePosition: '(top|middle|bottom)-(left|center|right)'",
             "accentColor: hex",
-            "presentedBy: { enabled, showLogo, logoUrl, size, position, ... }",
+            "presentedBy: { enabled, showLogo, logoUrl (signed URL), size, position, ... }",
         ],
     },
     {
@@ -72,7 +76,7 @@ export const SECTION_CATALOG = [
     },
     {
         type: "team",
-        purpose: "DEPRECATED — the Atlas loader auto-migrates `team` sections into `people-link` on open (TeamPerson → LinkedPerson, external=true). New docs should use `people-link` directly; this entry is kept so Claude can still answer questions about legacy docs.",
+        purpose: "DEPRECATED — the Atlas loader auto-migrates `team` sections into `people-link` on open (TeamPerson → LinkedPerson, external=true), and the API rejects new `team` writes with a 400. New docs must use `people-link` directly; this entry is kept so Claude can still answer questions about legacy docs.",
         data_shape: "section.data — { title, people: [{ name, role }] } (legacy)",
         common_fields: ["people: object[]"],
     },
@@ -102,7 +106,7 @@ export const SECTION_CATALOG = [
         purpose: "Mixed list of workspace members and external contacts.",
         data_shape: "section.data — { title, people: LinkedPerson[] }",
         common_fields: [
-            "people: [{ userId?, name, role?, email?, phone?, external? }]",
+            "people: [{ userId?, name, role?, email?, phone?, external?, photoUrl? (SIGNED URL — not a storage key) }]",
         ],
     },
     {
@@ -114,29 +118,30 @@ export const SECTION_CATALOG = [
     {
         type: "moodboard",
         purpose: "Image grid with configurable rows/cols/spacing/radius/aspect.",
-        data_shape: "section.data — { title, images: (MoodBoardImage|null)[], rows, cols, aspect, spacing, radius, ... }",
+        data_shape: "section.data — { title, images: (MoodBoardImage|null)[], rows, cols, aspect, spacing, radius, ... } where MoodBoardImage = { id, url (SIGNED URL — not a storage key), alt? }",
         common_fields: [
-            "images: length === rows * cols (missing slots are null)",
+            "images: length === rows * cols (missing slots are null); each image is { id, url (signed), alt? } — raw storage keys render as 404s",
             "aspect: 'square' | 'portrait' | 'landscape'",
-            "rows, cols: number",
+            "rows, cols: number — default 3x3",
         ],
     },
     {
         type: "palette",
         purpose: "Colour palette extracted from a source moodboard (or manually curated).",
-        data_shape: "section.data — { title, sourceSectionId, rows, cols, extractedColours, ... }",
+        data_shape: "section.data — { title, sourceId, rows, cols, numColors, extractedColours, ... }",
         common_fields: [
-            "sourceSectionId: string (id of a moodboard section)",
+            "sourceId: string (id of a moodboard section — the field is `sourceId`, not `sourceSectionId`)",
             "rows, cols: number",
-            "extractedColours: PaletteColour[]",
+            "numColors: number (rows * cols on new palettes; legacy docs may only have numColors)",
+            "extractedColours: PaletteColour[] (hex + weight)",
         ],
     },
     {
         type: "calendar-event",
-        purpose: "Embed one or more workspace shoots inline — card / table / banner layouts, optional attendee avatars.",
+        purpose: "Embed one or more ALREADY-SCHEDULED workspace shoots inline — card / table / banner layouts, optional attendee avatars. This section only references `eventIds`; it does NOT schedule the shoot. Use atlas_add_calendar_event_to_doc to schedule a shoot AND wire it into the section in one call.",
         data_shape: "section.data — { title, eventIds: string[], layout: 'card'|'table'|'banner', showAttendees, showLocation, showDescription, radius, ... }",
         common_fields: [
-            "eventIds: uuid[] (from workspace shoots)",
+            "eventIds: uuid[] (from workspace shoots — must already exist; create via atlas_create_event or atlas_add_calendar_event_to_doc)",
             "layout: 'card' | 'table' | 'banner'",
             "showAttendees, showLocation, showDescription: boolean",
             "radius: number (px, card + banner only)",
@@ -159,6 +164,12 @@ export const SECTION_CATALOG = [
         common_fields: ["css: string (legacy — use docSettings.customCss instead)"],
     },
 ];
+/** Final catalogue — every entry gets the shared `hidden` field appended
+ * to common_fields so Claude sees it uniformly. */
+export const SECTION_CATALOG = RAW_CATALOG.map((entry) => ({
+    ...entry,
+    common_fields: [...entry.common_fields, HIDDEN_FIELD],
+}));
 export function findSection(type) {
     return SECTION_CATALOG.find((s) => s.type === type) ?? null;
 }

package/dist/section-catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"section-catalog.js","sourceRoot":"","sources":["../src/section-catalog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"section-catalog.js","sourceRoot":"","sources":["../src/section-catalog.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kezlahd/atlas-mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server for the Atlas creative-team platform – lets Claude Code and other AI agents edit doc templates, files, and gear.",
   "type": "module",
   "license": "MIT",
@@ -8,7 +8,7 @@
   "homepage": "https://atlas.mjsons.net",
   "repository": {
     "type": "git",
-    "url": "https://github.com/KezLahd/atlas.git",
+    "url": "git+https://github.com/KezLahd/atlas.git",
     "directory": "packages/atlas-mcp"
   },
   "bugs": {
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "bin": {
-    "atlas-mcp": "./dist/index.js"
+    "atlas-mcp": "dist/index.js"
   },
   "main": "./dist/index.js",
   "files": [