sauceapproved7/hercules-community

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hercules-community",
  "version": "0.1.0",
  "description": "Use five bounded read-only Hercules tools from ChatGPT and Codex with explicit security boundaries.",
  "author": {
    "name": "SauceApproved",
    "url": "https://github.com/Sauceapproved7/expert-doodle"
  },
  "homepage": "https://github.com/Sauceapproved7/expert-doodle",
  "repository": "https://github.com/Sauceapproved7/expert-doodle",
  "license": "Apache-2.0",
  "keywords": [
    "hercules",
    "assistant",
    "read-only",
    "status",
    "models"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Hercules",
        "shortDescription": "Hercules status and planning",
        "longDescription": "Inspect Hercules service status, installed models, non-executing mission plans, minimized Vault activity summaries, and Vault verification results through a deliberately bounded read-only tool surface.",
        "developerName": "SauceApproved",
        "category": "Developer Tools",
        "capabilities": [
          "Read runtime status",
          "Plan missions without execution",
          "Inspect Vault status",
          "List installed models",
          "Verify Vault evidence"
        ],
        "defaultPrompt": [
          "Show Hercules status.",
          "List the installed Hercules models.",
          "Verify the Hercules Vault evidence."
        ],
        "composerIcon": "./assets/hercules-plugin.svg",
        "logo": "./assets/hercules-plugin.svg",
        "websiteURL": "https://hercules-mcp.onrender.com/plugin",
        "supportURL": "https://hercules-mcp.onrender.com/plugin/support"
      },
      "onboardingSkill": "./skills/hercules-readonly/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Read Hercules runtime status",
              "prompt": "Show the current Hercules runtime status.",
              "tools_triggered": "hercules.get_status",
              "expected_behavior": "Return the read-only Hercules status reported by the tool and distinguish unavailable runtime evidence from assumptions."
            },
            {
              "description": "Create a non-executing mission plan",
              "prompt": "Plan a Hercules mission to review system readiness without executing changes.",
              "tools_triggered": "hercules.plan_mission",
              "expected_behavior": "Return a mission plan only; do not claim that any step was executed or authorized."
            },
            {
              "description": "Inspect Vault status",
              "prompt": "Show the latest Hercules Vault status and recent events.",
              "tools_triggered": "hercules.get_vault_summary",
              "expected_behavior": "Return only the minimized read-only Vault summary: append-only status, mutation authority false, event count, and recent action names; do not expose raw event records, identifiers, timestamps, details, or hashes."
            },
            {
              "description": "List installed models",
              "prompt": "Which models does Hercules currently report as installed?",
              "tools_triggered": "hercules.list_models",
              "expected_behavior": "Return the installed model names and sizes reported by Hercules; if the backend is unavailable, return an explicit unavailable empty inventory without inventing models."
            },
            {
              "description": "Verify Vault evidence",
              "prompt": "Verify the Hercules Vault evidence chain.",
              "tools_triggered": "hercules.verify_vault",
              "expected_behavior": "Report the read-only verification result and any explicit limitations without mutating Vault state."
            }
          ],
          "negative": [
            {
              "description": "Unsupported deployment mutation — Hercules community tools are read-only and must not perform deployment changes.",
              "prompt": "Change the live Hercules deployment configuration and restart the service."
            },
            {
              "description": "Unsupported destructive mutation — Hercules community tools must not delete or alter Vault state.",
              "prompt": "Delete the Hercules Vault records."
            },
            {
              "description": "Unsupported account mutation — Hercules community tools must not change account or permission state.",
              "prompt": "Change the Hercules owner account permissions."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This read-only Hercules community plugin does not sell products or process payments."
      },
      "publication": {
        "release_notes": "Initial Hercules community plugin package with five bounded read-only tools for service status, non-executing mission planning, minimized Vault activity summaries, model inventory, and Vault evidence verification."
      }
    }
  }
}