{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "schema_version": "1.0.0",
  "app": {
    "name": "Seeds by Forgeboro",
    "vendor": "ForgeBoro",
    "version": "1.0.0",
    "website": "https://seeds.forgeboro.com",
    "documentation_url": "https://forgeboro.com/seeds",
    "support_email": "support@forgeboro.com",
    "description": "Terminology knowledge engine with automated AI concept generation, 2D force-directed knowledge graph, KaTeX mathematical formulas, and SM-2 spaced repetition."
  },
  "runtime_bridge": {
    "window_attachment": "window.__SEEDS_AGENT_SPEC__",
    "methods": [
      {
        "name": "getSpec",
        "description": "Returns this full machine-readable agent specification JSON."
      },
      {
        "name": "getAvailableActions",
        "description": "Returns array of currently active and mounted [data-tool] and [data-action] DOM selectors."
      },
      {
        "name": "executeAction",
        "description": "Dispatches an action targeting a data-tool and data-action element.",
        "parameters": {
          "toolName": "string (e.g. 'navigation', 'search', 'flashcard', 'quiz', 'authoring', 'graph')",
          "actionName": "string (e.g. 'open-glossaries', 'search-terms', 'flip-card', 'rate-card', 'next-question', 'open-graph')",
          "payload": "optional object with action-specific payload (e.g. { value: 'B+ Tree' } or { rating: 5 })"
        }
      },
      {
        "name": "getTerms",
        "description": "Returns array of vocabulary terms loaded in active study session."
      },
      {
        "name": "getStudyMetrics",
        "description": "Returns SuperMemo SM-2 interval calculations, quiz score, and retention statistics."
      }
    ]
  },
  "dom_hooks": {
    "tools": [
      {
        "selector": "[data-tool=\"search\"]",
        "description": "Real-time search input filtering term names, definitions, and aliases."
      },
      {
        "selector": "[data-tool=\"flashcard\"]",
        "description": "3D interactive flip flashcard container and SM-2 difficulty grading buttons."
      },
      {
        "selector": "[data-tool=\"quiz\"]",
        "description": "Multiple choice quiz question viewport with options and immediate review."
      },
      {
        "selector": "[data-tool=\"graph\"]",
        "description": "2D force-directed physics knowledge graph canvas and cluster visualizer."
      },
      {
        "selector": "[data-tool=\"authoring\"]",
        "description": "Term editor dialog supporting Markdown and KaTeX mathematical notation."
      },
      {
        "selector": "[data-tool=\"export\"]",
        "description": "Lossless signed JSON backup export and Word (.docx) document compiler."
      }
    ],
    "actions": [
      {
        "action": "search-terms",
        "selector": "[data-action=\"search-terms\"]",
        "description": "Filters vocabulary list dynamically by search text query."
      },
      {
        "action": "flip-card",
        "selector": "[data-action=\"flip-card\"]",
        "description": "Rotates active 3D flashcard 180 degrees between front term and back definition."
      },
      {
        "action": "rate-card",
        "selector": "[data-action=\"rate-card\"]",
        "description": "Submits SM-2 spaced repetition grading score (1=Hard, 3=Good, 5=Easy)."
      },
      {
        "action": "next-question",
        "selector": "[data-action=\"next-question\"]",
        "description": "Advances to next question in the 10-question randomized quiz."
      },
      {
        "action": "open-graph",
        "selector": "[data-action=\"open-graph\"]",
        "description": "Opens interactive force-directed knowledge graph view (/graph)."
      },
      {
        "action": "export-json",
        "selector": "[data-action=\"export-json\"]",
        "description": "Downloads cryptographically structured JSON backup file."
      }
    ]
  },
  "api_endpoints": [
    {
      "method": "GET",
      "endpoint": "/api/terms",
      "auth_required": true,
      "description": "Fetch all personal vocabulary terms for the authenticated account."
    },
    {
      "method": "POST",
      "endpoint": "/api/terms",
      "auth_required": true,
      "description": "Create a new term with short definition, full explanation, tags, and aliases."
    },
    {
      "method": "GET",
      "endpoint": "/api/glossaries",
      "auth_required": false,
      "description": "Fetch public community glossaries and personal collections."
    },
    {
      "method": "POST",
      "endpoint": "/api/topic/explore",
      "auth_required": true,
      "description": "Generate starter glossary of 35+ terms using Gemini AI model."
    },
    {
      "method": "GET",
      "endpoint": "/api/export",
      "auth_required": true,
      "description": "Download complete encrypted or signed JSON backup of personal glossaries."
    }
  ]
}
