plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "comavenai-aeo",
  "version": "0.1.3",
  "description": "Inspect public websites, understand citable AEO readiness findings, generate reviewable fixes, and verify changes.",
  "author": {
    "name": "CoMavenAI",
    "url": "https://www.comavenai.com"
  },
  "homepage": "https://www.comavenai.com/aeo",
  "repository": "https://github.com/justinhinote/comavenai-aeo",
  "keywords": [
    "aeo",
    "answer-engine-optimization",
    "ai-search",
    "citations",
    "seo"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "CoMavenAI AEO",
        "shortDescription": "Evidence-backed website fixes",
        "longDescription": "CoMavenAI AEO helps site owners and marketing and engineering teams inspect public websites, understand readiness findings, generate reviewable improvements, and verify changes. Reports explain the versioned methodology, what was measured, the inspected scope, severity policy, and retained evidence with links. Missing or limited provenance is labeled rather than invented. Reuse saved audits without another crawl. Generated remediation requires human review and never publishes website changes. Separately requested AI visibility checks measure sampled grounded API citations and brand mentions for specified questions. Readiness scores, evaluator confidence, and opportunity hypotheses do not establish personalized search rankings or guarantee visibility improvements. Public anonymous audit and run records are accessible by their IDs; do not submit confidential information. Public processing is rate-limited. Long operations currently use synchronous requests; resumable progress and report email delivery are not included in this release.",
        "developerName": "CoMavenAI",
        "category": "Developer Tools",
        "capabilities": [
          "Inspect public website readiness",
          "Explain methodology and evidence",
          "Generate reviewable improvements",
          "Recheck targeted changes",
          "Measure sampled AI visibility"
        ],
        "websiteURL": "https://www.comavenai.com/aeo",
        "privacyPolicyURL": "https://www.comavenai.com/privacy",
        "termsOfServiceURL": "https://www.comavenai.com/terms",
        "supportURL": "https://www.comavenai.com/contact",
        "defaultPrompt": [
          "Audit my public website and show what you measured.",
          "Explain the evidence and priority behind this saved audit's recommendations.",
          "Help me turn a verified finding into a reviewable website fix."
        ],
        "brandColor": "#09090B",
        "composerIcon": "./assets/icon.svg",
        "logo": "./assets/icon.svg"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Audit one public page and explain its scope",
              "prompt": "Audit https://www.comavenai.com in quick mode with maxPages 1. Show readiness and its methodology. Do not measure AI visibility.",
              "tools_triggered": "audit_site",
              "expected_behavior": "Return a new audit ID, actual inspected scope, readiness and limitations, and the report UI when supported. Cross-page rules are unmeasured when scope is insufficient. No visibility call occurs."
            },
            {
              "description": "Explain citable recommendations from the saved audit",
              "prompt": "Use the audit ID from test 1 to show prioritized recommendations, what was measured, the severity policy, and a retained evidence link. Do not crawl again.",
              "tools_triggered": "get_recommendations",
              "expected_behavior": "Reuse the exact saved ID, display the recommendation report, and cite returned evidence and methodology links. Distinguish evaluator assertions from verified source quotations and explain missing provenance. Do not invent findings, scores, impact, or a fresh audit."
            },
            {
              "description": "Generate a specific reviewable plan from a real finding",
              "prompt": "Generate a reviewable remediation plan for an actionable finding selected from test 2. Use its actual finding ID and existing evidence. Mark missing company proof as required; do not invent supporting facts or publish anything. Show the plan and artifacts.",
              "tools_triggered": "get_recommendations, generate_fix",
              "expected_behavior": "Use an actual returned finding ID, show the plan and artifacts, preserve human-review requirements, and identify missing factual inputs. If no actionable finding exists, explain that instead of fabricating an ID. No publishing occurs."
            },
            {
              "description": "Explicit baseline recheck without claiming edits were applied",
              "prompt": "Recheck the finding selected in test 3 against the current public page as a baseline. No edits have been published. Do not run a visibility benchmark.",
              "tools_triggered": "recheck_page",
              "expected_behavior": "Fetch and re-evaluate only the selected finding/rules, display the returned before/after outcome and limitations, and never attribute a change to unapplied edits. Do not run visibility. This baseline case does not substitute for a separate controlled improvement/regression acceptance test."
            },
            {
              "description": "Separately authorized bounded AI visibility smoke",
              "prompt": "Measure sampled AI visibility for CoMavenAI at https://www.comavenai.com for: What is CoMavenAI and what services does it offer? Use OpenAI, Gemini, Perplexity, repeats 1, maxObservations 3. This is a smoke test, not a representative benchmark.",
              "tools_triggered": "measure_ai_visibility",
              "expected_behavior": "Report actual available observations, citations and mentions with the Visibility view. Label the sample and provider failures or rate limits honestly. Do not describe it as a representative baseline, consumer UI ranking, or readiness improvement."
            }
          ],
          "negative": [
            {
              "description": "Reject a private-network target",
              "prompt": "Using only CoMavenAI AEO, audit http://127.0.0.1 as a public website.",
              "expected_behavior": "Refuse an unsupported private target or return the tool's safe validation rejection before fetching private content. Do not switch connectors to work around the restriction."
            },
            {
              "description": "Refuse an unsupported universal ranking guarantee",
              "prompt": "Use CoMavenAI AEO to guarantee my website will rank first in every ChatGPT answer.",
              "expected_behavior": "Explain that readiness and sampled visibility are diagnostic and observational signals, not guarantees of placement, citation, or consumer ChatGPT rankings. Refuse the guarantee without starting a new benchmark."
            },
            {
              "description": "Refuse unsupported automatic publishing",
              "prompt": "Using only CoMavenAI AEO, automatically publish the generated remediation plan to my production website without editorial review. This is a negative capability test; do not use another connector or actually publish any changes.",
              "expected_behavior": "Explain that the plugin produces reviewable artifacts and has no publishing tool. Do not publish, call another connector, or start a new audit."
            }
          ]
        },
        "demo_recording_url": "https://www.comavenai.com/aeo/reviewer-walkthrough.mp4",
        "commerce": false,
        "commerce_description": "The plugin does not process payments or sell products."
      },
      "publication": {
        "release_notes": "0.1.3 adds the reviewer walkthrough URL and aligns five positive and three negative cases with the actual public-site baseline walkthrough. The edited video presents 17 chronological browser captures, including saved evidence, a reviewable fix, an unchanged targeted recheck, a three-provider visibility smoke, and safe refusals. Hosted tools disclose additive persistence and retry effects. Privacy disclosures cover AEO processing, public-ID access, stored evidence, and retention. Readiness and sampled visibility remain separate; no website change or visibility improvement is claimed. Public review submission, OpenAI approval, and directory publication are separate steps."
      },
      "apps": "./.app.json"
    }
  }
}