gentropic.org

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "start",
        "stop",
        "clear",
        "status"
      ],
      "description": "Default: status"
    },
    "feed": {
      "type": "string",
      "description": "start scope: a source by id OR display name (e.g. \"Saved Links\")"
    },
    "category": {
      "type": "string",
      "description": "start scope: a folder name (\"\" = ungrouped)"
    },
    "type": {
      "type": "string",
      "description": "start scope: item type (article|video|paper|…)"
    },
    "recatalog": {
      "type": "boolean",
      "description": "with action:start + a scope: discard that scope's cataloger-generated cards and re-catalog from scratch (re-do a batch cataloged under an old rule). SAFE-BY-DEFAULT: hand-authored / human-reviewed cards (a `reviewer` stamp) are PRESERVED — only regenerable cataloger cards are redone — so it can't silently destroy authored curation (the cataloger abstains on thin/metadata-only items like book holdings, which would have nothing to regenerate them). Returns `preserved` (count kept)."
    },
    "includeAuthored": {
      "type": "boolean",
      "description": "with recatalog: ALSO redo hand-authored / human-reviewed cards in scope (default false → they're preserved). Use only when you want authored cards re-derived — e.g. body text has since arrived and the body-fed cards beat the hand facets."
    }
  }
}