{
  "version": "1.0.0",
  "kind": "olonjs-page-contract",
  "slug": "topics",
  "title": "Topics -- The Brief",
  "description": "Browse The Brief by topic. Engineering, Design, AI, Product, Culture.",
  "manifestHref": "/mcp-manifests/topics.json",
  "systemPrompt": "You are operating the \"Topics -- The Brief\" page in OlonJS Studio. Use only the declared tools and keep mutations valid against the section schema.",
  "sectionTypes": [
    "header",
    "footer",
    "page-hero",
    "tag-index",
    "newsletter-cta"
  ],
  "sectionInstances": [
    {
      "id": "global-header",
      "type": "header",
      "scope": "global",
      "label": "header"
    },
    {
      "id": "global-footer",
      "type": "footer",
      "scope": "global",
      "label": "footer"
    },
    {
      "id": "topics-hero",
      "type": "page-hero",
      "scope": "local",
      "label": "Topics"
    },
    {
      "id": "topics-tag-index",
      "type": "tag-index",
      "scope": "local",
      "label": "What do you want to learn?"
    },
    {
      "id": "topics-newsletter",
      "type": "newsletter-cta",
      "scope": "local",
      "label": "One newsletter. All topics."
    }
  ],
  "sectionSchemas": {
    "header": {
      "type": "object",
      "required": [
        "logoText"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "menu": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "href"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "href": {
                "type": "string",
                "description": "ui:text"
              },
              "isCta": {
                "type": "boolean"
              },
              "label": {
                "type": "string",
                "description": "ui:text"
              }
            },
            "additionalProperties": false
          },
          "description": "ui:list"
        },
        "anchorId": {
          "type": "string",
          "description": "ui:text"
        },
        "logoText": {
          "type": "string",
          "description": "ui:text"
        },
        "announcement": {
          "type": "string",
          "description": "ui:text"
        },
        "logoHighlight": {
          "type": "string",
          "description": "ui:text"
        }
      },
      "additionalProperties": false
    },
    "footer": {
      "type": "object",
      "required": [
        "brandText",
        "copyright"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "menu": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "href"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "href": {
                "type": "string",
                "description": "ui:text"
              },
              "label": {
                "type": "string",
                "description": "ui:text"
              },
              "external": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          },
          "description": "ui:list"
        },
        "anchorId": {
          "type": "string",
          "description": "ui:text"
        },
        "brandText": {
          "type": "string",
          "description": "ui:text"
        },
        "copyright": {
          "type": "string",
          "description": "ui:text"
        },
        "legalLinks": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "href"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "href": {
                "type": "string",
                "description": "ui:text"
              },
              "label": {
                "type": "string",
                "description": "ui:text"
              },
              "external": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          },
          "description": "ui:list"
        },
        "socialLinks": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "href"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "href": {
                "type": "string",
                "description": "ui:text"
              },
              "label": {
                "type": "string",
                "description": "ui:text"
              },
              "external": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          },
          "description": "ui:list"
        },
        "brandTagline": {
          "type": "string",
          "description": "ui:text"
        }
      },
      "additionalProperties": false
    },
    "page-hero": {
      "type": "object",
      "required": [
        "title"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "title": {
          "type": "string",
          "description": "ui:text"
        },
        "eyebrow": {
          "type": "string",
          "description": "ui:text"
        },
        "anchorId": {
          "type": "string",
          "description": "ui:text"
        },
        "subtitle": {
          "type": "string",
          "description": "ui:textarea"
        },
        "breadcrumbs": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "href": {
                "type": "string",
                "description": "ui:text"
              },
              "label": {
                "type": "string",
                "description": "ui:text"
              }
            },
            "additionalProperties": false
          },
          "description": "ui:list"
        }
      },
      "additionalProperties": false
    },
    "tag-index": {
      "type": "object",
      "required": [
        "tags"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "tags": {
          "type": "object",
          "description": "ui:collection-ref:tags",
          "additionalProperties": {
            "type": "object",
            "required": [
              "id",
              "name",
              "slug"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string",
                "description": "ui:text"
              },
              "slug": {
                "type": "string",
                "description": "ui:text"
              },
              "description": {
                "type": "string",
                "description": "ui:textarea"
              }
            },
            "additionalProperties": false
          }
        },
        "label": {
          "type": "string",
          "description": "ui:text"
        },
        "posts": {
          "type": "object",
          "description": "ui:collection-ref:posts",
          "additionalProperties": {
            "type": "object",
            "required": [
              "id",
              "title",
              "slug",
              "excerpt",
              "tag",
              "date",
              "readingTime",
              "author"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "tag": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "id",
                      "name",
                      "slug"
                    ],
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string",
                        "description": "ui:text"
                      },
                      "slug": {
                        "type": "string",
                        "description": "ui:text"
                      },
                      "description": {
                        "type": "string",
                        "description": "ui:textarea"
                      }
                    },
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "required": [
                      "$ref"
                    ],
                    "properties": {
                      "$ref": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  }
                ],
                "description": "ui:collection-ref:tags"
              },
              "body": {
                "type": "string",
                "default": "",
                "description": "ui:editorial-markdown"
              },
              "date": {
                "type": "string",
                "description": "ui:text"
              },
              "slug": {
                "type": "string",
                "description": "ui:text"
              },
              "title": {
                "type": "string",
                "description": "ui:text"
              },
              "author": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "id",
                      "name"
                    ],
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "bio": {
                        "type": "string",
                        "description": "ui:textarea"
                      },
                      "name": {
                        "type": "string",
                        "description": "ui:text"
                      }
                    },
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "required": [
                      "$ref"
                    ],
                    "properties": {
                      "$ref": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  }
                ],
                "description": "ui:collection-ref:autori"
              },
              "excerpt": {
                "type": "string",
                "description": "ui:textarea"
              },
              "featured": {
                "type": "boolean"
              },
              "coverImage": {
                "type": "object",
                "required": [
                  "url"
                ],
                "properties": {
                  "alt": {
                    "type": "string"
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "description": "ui:image-picker",
                "additionalProperties": false
              },
              "readingTime": {
                "type": "string",
                "description": "ui:text"
              }
            },
            "additionalProperties": false
          }
        },
        "title": {
          "type": "string",
          "description": "ui:text"
        },
        "anchorId": {
          "type": "string",
          "description": "ui:text"
        }
      },
      "additionalProperties": false
    },
    "newsletter-cta": {
      "type": "object",
      "required": [
        "title"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "title": {
          "type": "string",
          "description": "ui:text"
        },
        "eyebrow": {
          "type": "string",
          "description": "ui:text"
        },
        "anchorId": {
          "type": "string",
          "description": "ui:text"
        },
        "ctaLabel": {
          "type": "string",
          "description": "ui:text"
        },
        "subtitle": {
          "type": "string",
          "description": "ui:textarea"
        },
        "disclaimer": {
          "type": "string",
          "description": "ui:text"
        },
        "placeholder": {
          "type": "string",
          "description": "ui:text"
        }
      },
      "additionalProperties": false
    }
  },
  "tools": [
    {
      "name": "update-section",
      "description": "Update a section field in the Studio draft. Does not persist — call save when all updates are complete. Use sectionType to select the matching schema from sectionSchemas.",
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "slug": {
            "type": "string",
            "description": "Canonical page slug currently open in Studio."
          },
          "sectionId": {
            "type": "string",
            "description": "Concrete section instance id inside the current draft."
          },
          "sectionType": {
            "type": "string",
            "description": "Section type being updated (for example \"hero\" or \"header\"). Used to select the correct validation schema."
          },
          "scope": {
            "type": "string",
            "enum": [
              "local",
              "global"
            ],
            "default": "local"
          },
          "data": {
            "type": "object",
            "description": "Full replacement payload validated against the schema declared for sectionType."
          },
          "itemPath": {
            "type": "array",
            "description": "Optional root-to-leaf selection path for targeted field mutation.",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "fieldKey": {
                  "type": "string"
                },
                "itemId": {
                  "type": "string"
                }
              },
              "required": [
                "fieldKey"
              ]
            }
          },
          "value": {
            "description": "Value written to the final field targeted by itemPath."
          },
          "fieldKey": {
            "type": "string",
            "description": "Shorthand for a top-level scalar field update when itemPath is omitted."
          }
        },
        "required": [
          "sectionId"
        ],
        "oneOf": [
          {
            "required": [
              "data"
            ]
          },
          {
            "required": [
              "itemPath",
              "value"
            ]
          },
          {
            "required": [
              "fieldKey",
              "value"
            ]
          }
        ]
      }
    },
    {
      "name": "save",
      "description": "Persist all pending draft changes using the active save mode (local file, hot save, or save2repo). Call once after all update-section calls are complete.",
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {}
      }
    }
  ]
}