{
  "id": "com.lattice.feeds",
  "name": "Feed Reader",
  "icon": "📰",
  "color": "#2563eb",
  "description": "Read and organize RSS 2.0 items.",
  "provenance": "RSS 2.0 item model, verified 2026-10-14: https://www.rssboard.org/rss-specification#hrelementsOfLtitemgt . Adopted title, link, description, author, category, comments, guid, pubDate -> pub_date, source, plus guid@isPermaLink -> guid_is_perma_link, source@url -> source_url and enclosure@url/length/type -> enclosure_url/enclosure_length/enclosure_type. The fixture selects one category and one enclosure per item; XML attributes are flattened and boolean isPermaLink uses SQLite 0/1. id is a local surrogate. RFC 822 dates and opaque GUIDs are retained. RSS is the independently specified feed format, not an API of a particular reader; local events/listeners are fixture actions.",
  "requested_permissions": {
    "storage": [
      "sql",
      "kv"
    ],
    "network": {
      "allowlist": [],
      "user_sites": true
    },
    "events": {
      "item-received": {
        "description": "A new feed item was received.",
        "schema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "description": "Feed item ID."
            },
            "guid": {
              "type": [
                "string",
                "null"
              ],
              "description": "Opaque RSS identifier, possibly a URL; null means unspecified."
            },
            "guid_is_perma_link": {
              "type": "integer",
              "description": "GUID permalink flag: 0=false, 1=true.",
              "enum": [
                0,
                1
              ]
            },
            "title": {
              "type": [
                "string",
                "null"
              ],
              "description": "Item title; null when only synopsis is supplied."
            },
            "link": {
              "type": [
                "string",
                "null"
              ],
              "description": "Original item URL; null means unspecified."
            },
            "description": {
              "type": [
                "string",
                "null"
              ],
              "description": "Item synopsis, possibly HTML; null means unspecified."
            },
            "author": {
              "type": [
                "string",
                "null"
              ],
              "description": "Author email address, optionally with display name; null means unspecified."
            },
            "category": {
              "type": [
                "string",
                "null"
              ],
              "description": "Single category path; null means unspecified."
            },
            "comments": {
              "type": [
                "string",
                "null"
              ],
              "description": "Comments page URL; null means unspecified."
            },
            "pub_date": {
              "type": [
                "string",
                "null"
              ],
              "description": "Publication timestamp, RFC 822; null means unspecified."
            },
            "source": {
              "type": [
                "string",
                "null"
              ],
              "description": "Originating channel name; null means unspecified."
            },
            "source_url": {
              "type": [
                "string",
                "null"
              ],
              "description": "Source feed URL; null means unspecified."
            },
            "enclosure_url": {
              "type": [
                "string",
                "null"
              ],
              "description": "Attached media URL; null means unspecified."
            },
            "enclosure_length": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Attached media size in bytes; null means unspecified.",
              "minimum": 0
            },
            "enclosure_type": {
              "type": [
                "string",
                "null"
              ],
              "description": "Attached media MIME type; null means unspecified."
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false,
          "anyOf": [
            {
              "required": [
                "title"
              ],
              "properties": {
                "title": {
                  "type": "string"
                }
              }
            },
            {
              "required": [
                "description"
              ],
              "properties": {
                "description": {
                  "type": "string"
                }
              }
            }
          ]
        }
      },
      "item-updated": {
        "description": "An existing feed item was updated.",
        "schema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "description": "Feed item ID."
            },
            "guid": {
              "type": [
                "string",
                "null"
              ],
              "description": "Opaque RSS identifier, possibly a URL; null means unspecified."
            },
            "guid_is_perma_link": {
              "type": "integer",
              "description": "GUID permalink flag: 0=false, 1=true.",
              "enum": [
                0,
                1
              ]
            },
            "title": {
              "type": [
                "string",
                "null"
              ],
              "description": "Item title; null when only synopsis is supplied."
            },
            "link": {
              "type": [
                "string",
                "null"
              ],
              "description": "Original item URL; null means unspecified."
            },
            "description": {
              "type": [
                "string",
                "null"
              ],
              "description": "Item synopsis, possibly HTML; null means unspecified."
            },
            "author": {
              "type": [
                "string",
                "null"
              ],
              "description": "Author email address, optionally with display name; null means unspecified."
            },
            "category": {
              "type": [
                "string",
                "null"
              ],
              "description": "Single category path; null means unspecified."
            },
            "comments": {
              "type": [
                "string",
                "null"
              ],
              "description": "Comments page URL; null means unspecified."
            },
            "pub_date": {
              "type": [
                "string",
                "null"
              ],
              "description": "Publication timestamp, RFC 822; null means unspecified."
            },
            "source": {
              "type": [
                "string",
                "null"
              ],
              "description": "Originating channel name; null means unspecified."
            },
            "source_url": {
              "type": [
                "string",
                "null"
              ],
              "description": "Source feed URL; null means unspecified."
            },
            "enclosure_url": {
              "type": [
                "string",
                "null"
              ],
              "description": "Attached media URL; null means unspecified."
            },
            "enclosure_length": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Attached media size in bytes; null means unspecified.",
              "minimum": 0
            },
            "enclosure_type": {
              "type": [
                "string",
                "null"
              ],
              "description": "Attached media MIME type; null means unspecified."
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false,
          "anyOf": [
            {
              "required": [
                "title"
              ],
              "properties": {
                "title": {
                  "type": "string"
                }
              }
            },
            {
              "required": [
                "description"
              ],
              "properties": {
                "description": {
                  "type": "string"
                }
              }
            }
          ]
        }
      },
      "item-opened": {
        "description": "A feed item or its original link was opened.",
        "schema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "description": "Feed item ID."
            },
            "guid": {
              "type": [
                "string",
                "null"
              ],
              "description": "Opaque RSS identifier, possibly a URL; null means unspecified."
            },
            "title": {
              "type": [
                "string",
                "null"
              ],
              "description": "Item title; null when only synopsis is supplied."
            },
            "link": {
              "type": [
                "string",
                "null"
              ],
              "description": "Original item URL; null means unspecified."
            },
            "pub_date": {
              "type": [
                "string",
                "null"
              ],
              "description": "Publication timestamp, RFC 822; null means unspecified."
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false
        }
      }
    },
    "listeners": {
      "receive-item": {
        "description": "Import a feed item with a title or synopsis.",
        "schema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "description": "Feed item ID; generated when omitted."
            },
            "guid": {
              "type": [
                "string",
                "null"
              ],
              "description": "Opaque RSS identifier, possibly a URL; omitted or null means unspecified."
            },
            "guid_is_perma_link": {
              "type": "integer",
              "description": "GUID permalink flag: 0=false, 1=true; omitted defaults to 1.",
              "enum": [
                0,
                1
              ]
            },
            "title": {
              "type": [
                "string",
                "null"
              ],
              "description": "Item title; omitted or null when synopsis is supplied."
            },
            "link": {
              "type": [
                "string",
                "null"
              ],
              "description": "Original item URL; omitted or null means unspecified."
            },
            "description": {
              "type": [
                "string",
                "null"
              ],
              "description": "Item synopsis, possibly HTML; omitted or null means unspecified."
            },
            "author": {
              "type": [
                "string",
                "null"
              ],
              "description": "Author email address, optionally with display name; omitted or null means unspecified."
            },
            "category": {
              "type": [
                "string",
                "null"
              ],
              "description": "Single category path; omitted or null means unspecified."
            },
            "comments": {
              "type": [
                "string",
                "null"
              ],
              "description": "Comments page URL; omitted or null means unspecified."
            },
            "pub_date": {
              "type": [
                "string",
                "null"
              ],
              "description": "Publication timestamp, RFC 822; omitted or null means unspecified."
            },
            "source": {
              "type": [
                "string",
                "null"
              ],
              "description": "Originating channel name; omitted or null means unspecified."
            },
            "source_url": {
              "type": [
                "string",
                "null"
              ],
              "description": "Source feed URL; omitted or null means unspecified."
            },
            "enclosure_url": {
              "type": [
                "string",
                "null"
              ],
              "description": "Attached media URL; omitted or null means unspecified."
            },
            "enclosure_length": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Attached media size in bytes; omitted or null means unspecified.",
              "minimum": 0
            },
            "enclosure_type": {
              "type": [
                "string",
                "null"
              ],
              "description": "Attached media MIME type; omitted or null means unspecified."
            }
          },
          "required": [],
          "additionalProperties": false,
          "anyOf": [
            {
              "required": [
                "title"
              ],
              "properties": {
                "title": {
                  "type": "string"
                }
              }
            },
            {
              "required": [
                "description"
              ],
              "properties": {
                "description": {
                  "type": "string"
                }
              }
            }
          ]
        }
      }
    }
  },
  "x-effects": {
    "receive-item": {
      "table": "items",
      "emits": "item-received"
    }
  },
  "source": {
    "assets": [
      "index.html",
      "app.js",
      "app.css",
      "ui.css",
      "emits.js",
      "listens.js"
    ]
  }
}