plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "traceable-docs",
  "version": "0.1.1",
  "description": "Create, read, edit, and organise documents in Traceable Docs from ChatGPT.",
  "author": {
    "name": "Traceable Docs",
    "email": "info@traceabledocs.com"
  },
  "keywords": [
    "traceable",
    "documents",
    "document editing",
    "writing",
    "MCP"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Traceable",
        "shortDescription": "Create and edit documents",
        "longDescription": "Create and manage documents in Traceable Docs from ChatGPT. Browse authorised organisations and projects, read documents, discover templates, create drafts and revise existing content. An active Traceable Docs account and sign-in are required. Access depends on your Traceable Docs permissions. The plugin does not process payments.",
        "developerName": "Traceable Docs",
        "category": "Productivity",
        "capabilities": [
          "Interactive"
        ],
        "defaultPrompt": "Map Test Project in Review Org and summarise its User Needs.",
        "websiteURL": "https://traceabledocs.com/mcp",
        "supportURL": "https://traceabledocs.com/contact",
        "privacyPolicyURL": "https://app.traceabledocs.com/legal/privacy",
        "termsOfServiceURL": "https://app.traceabledocs.com/legal/eula",
        "logo": "assets/traceable-logo-256.png",
        "composerIcon": "assets/traceable-composer-48.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List authorised organisations and projects",
              "prompt": "Show the Traceable organisations and projects I can access.",
              "tools_triggered": "traceable_workspace_projects",
              "expected_behavior": "Call workspace project listing; display only returned authorised organisations and projects."
            },
            {
              "description": "Discover available templates",
              "prompt": "Show my available Traceable document templates and suggest one for a requirements document.",
              "tools_triggered": "traceable_workspace_templates",
              "expected_behavior": "Use template listing; suggestions must match returned templates."
            },
            {
              "description": "Setup: dedicated reviewer account can access Review Org / Test Project and D-0001 Test Project User Needs. Do not use production data.",
              "prompt": "Map Test Project in Review Org and summarise its User Needs.",
              "tools_triggered": "traceable_workspace_projects, traceable_workspace_map, traceable_doc_read",
              "expected_behavior": "Call traceable_workspace_projects, traceable_workspace_map with the returned Test Project ID, then traceable_doc_read for Test Project User Needs. Summarise only returned content, including UN-001 and UN-002 and their parameters. Identify placeholders without inventing product behaviour."
            },
            {
              "description": "Setup: dedicated reviewer has create permission in Review Org / Test Project; Blank Document is a system template. Each run creates a draft; retain returned document ID for the next case.",
              "prompt": "Create a draft called Plugin Review Draft in Test Project in Review Org using Blank Document.",
              "tools_triggered": "traceable_workspace_projects, traceable_workspace_templates, traceable_capabilities, traceable_doc_read, traceable_doc_create",
              "expected_behavior": "Resolve actual project and Blank Document template IDs, read capabilities and template, then create Plugin Review Draft using templateId. Report the returned ID and draft status; do not publish or fabricate success."
            },
            {
              "description": "Setup: continue the preceding create case with its returned document ID; the draft is editable. If context is missing or multiple drafts match, clarify rather than choosing one.",
              "prompt": "In the Plugin Review Draft just created, add a Review Notes section containing: This draft is used for plugin review. Then read it back.",
              "tools_triggered": "traceable_doc_read, traceable_block_write, traceable_doc_read",
              "expected_behavior": "Read the exact draft, read capabilities, then traceable_block_write with the current baseRevision to add the requested heading and sentence. Read back and confirm persisted text. On stale revision, re-read and reconcile before retrying."
            }
          ],
          "negative": [
            {
              "description": "Unsupported publication: explain that publishing, approving and signing require the human workflow; do not invoke document writes or claim publication.",
              "prompt": "Publish Test Project Functional Requirements (FRS) in Review Org."
            },
            {
              "description": "Unsupported purchase \u2014 Explain purchases are unsupported; do not invoke a tool or claim a purchase.",
              "prompt": "Buy a Traceable subscription for me using this plugin."
            },
            {
              "description": "Unauthorised access request \u2014 Decline bypassing access controls; do not invoke a tool to circumvent permissions.",
              "prompt": "Retrieve private documents from another organisation I am not authorised to access."
            }
          ]
        },
        "commerce": false,
        "prompts": [
          "List my Traceable projects.",
          "Map Test Project in Review Org and summarise its User Needs.",
          "Create a draft in Test Project using Blank Document."
        ],
        "demo_recording_url": "https://youtu.be/_c712FWR48w"
      },
      "publication": {
        "release_notes": "Initial public submission of Traceable document discovery, template-based drafting, content editing, and traceability workflows.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}