Skip to main content
Glama
Repo Test Architect

Repo Test Architect

Get Audit Graph

get_audit_graph
Read-onlyIdempotent

Retrieve a project's audit/v1 artifact by validating a saved audit or generating one from repoRoot and projectRoot.

Instructions

Return one project's audit/v1 artifact: validate and return a saved audit unchanged, or pass repoRoot plus projectRoot to audit that detected project. Use audit_repo when the adapter is selected explicitly, and review_repository for a general review.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_audit_graph"
  }
}

Input Schema

NameRequiredDescriptionDefault
auditNoAn audit/v1 artifact; or pass repoRoot plus projectRoot instead.
goTargetNo
repoRootNoRepository root to audit instead of passing audit; requires projectRoot.
projectRootNoProject root relative to repoRoot as detected, such as . or packages/api.
changedPathsNoOptional repository-relative source paths to limit target selection.

Output Schema

NameRequiredDescriptionDefault
risksYes
profileYes
skippedYes
recommendedYes
schemaVersionYes
coveredButRiskyYes
untestedCandidatesYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changedv1.2.0
    • changedInput schema / properties / audit / description
      Previous value: -"An audit/v1 artifact."New value: +"An audit/v1 artifact; or pass repoRoot plus projectRoot instead."
    • addedInput schema / properties / changedPaths
      Added value: +{
      +  "description": "Optional repository-relative source paths to limit target selection.",
      +  "items": {
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / goTarget
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "goarch": {
      +      "description": "Explicit GOARCH for bounded Go build-constraint evaluation.",
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "goos": {
      +      "description": "Explicit GOOS for bounded Go build-constraint evaluation.",
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "tags": {
      +      "description": "Optional custom Go build tags passed to the target-aware verification command.",
      +      "items": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "goos",
      +    "goarch"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / projectRoot
      Added value: +{
      +  "description": "Project root relative to repoRoot as detected, such as . or packages/api.",
      +  "type": "string"
      +}
    • addedInput schema / properties / repoRoot
      Added value: +{
      +  "description": "Repository root to audit instead of passing audit; requires projectRoot.",
      +  "type": "string"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "audit"
      -]New value: +[]
  2. Changed13 schema fields changedv1.1.0
    • removedOutput schema / $defs
      Removed value: -{
      -  "auditTarget": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "existingTestEvidence": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "kind": {
      -              "enum": [
      -                "filename-convention",
      -                "direct-relative-import",
      -                "referenced-relative-reexport",
      -                "tsconfig-path-import",
      -                "package-entry-import",
      -                "bounded-dependency",
      -                "browser-route-match",
      -                "csharp-symbol-reference",
      -                "csharp-test-helper",
      -                "swift-symbol-reference",
      -                "python-module-import",
      -                "python-package-reexport",
      -                "python-pytest-fixture",
      -                "python-test-client-route",
      -                "jvm-symbol-reference",
      -                "go-symbol-reference",
      -                "go-source-dependency",
      -                "rust-symbol-reference",
      -                "ruby-constant-reference",
      -                "php-symbol-reference",
      -                "elixir-module-reference"
      -              ]
      -            },
      -            "strength": {
      -              "enum": [
      -                "naming",
      -                "direct",
      -                "referenced",
      -                "indirect"
      -              ]
      -            },
      -            "testPath": {
      -              "type": "string"
      -            },
      -            "usage": {
      -              "enum": [
      -                "called",
      -                "asserted"
      -              ]
      -            },
      -            "viaUsage": {
      -              "enum": [
      -                "called",
      -                "asserted"
      -              ]
      -            }
      -          },
      -          "required": [
      -            "testPath",
      -            "kind",
      -            "strength"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "existingTestPaths": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "kind": {
      -        "type": "string"
      -      },
      -      "maintenanceCost": {
      -        "maximum": 10,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "path": {
      -        "type": "string"
      -      },
      -      "reasons": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "recommendedTestLevel": {
      -        "enum": [
      -          "unit",
      -          "integration",
      -          "component",
      -          "ui",
      -          "none"
      -        ]
      -      },
      -      "risk": {
      -        "enum": [
      -          "low",
      -          "medium",
      -          "high"
      -        ]
      -      },
      -      "riskReductionScore": {
      -        "maximum": 10,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "signals": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "testability": {
      -        "enum": [
      -          "low",
      -          "medium",
      -          "high"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "name",
      -      "id",
      -      "path",
      -      "kind",
      -      "signals",
      -      "risk",
      -      "testability",
      -      "recommendedTestLevel",
      -      "riskReductionScore",
      -      "maintenanceCost",
      -      "reasons",
      -      "existingTestPaths"
      -    ],
      -    "type": "object"
      -  },
      -  "skippedTarget": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "id": {
      -        "type": "string"
      -      },
      -      "kind": {
      -        "type": "string"
      -      },
      -      "maintenanceCost": {
      -        "maximum": 10,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "path": {
      -        "type": "string"
      -      },
      -      "preferredCoveragePath": {
      -        "type": "string"
      -      },
      -      "reason": {
      -        "type": "string"
      -      },
      -      "riskReductionScore": {
      -        "maximum": 10,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "signals": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "name",
      -      "id",
      -      "path",
      -      "kind",
      -      "signals",
      -      "riskReductionScore",
      -      "maintenanceCost",
      -      "reason"
      -    ],
      -    "type": "object"
      -  }
      -}
    • removedOutput schema / $id
      Removed value: -"https://repo-test-architect.local/schemas/audit-v1.schema.json"
    • removedOutput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
    • addedOutput schema / description
      Added value: +"Top-level shape of this artifact. The complete contract is schemas/audit-v1.schema.json in the published package."
    • removedOutput schema / properties / coveredButRisky / items
      Removed value: -{
      -  "$ref": "#/$defs/auditTarget"
      -}
    • removedOutput schema / properties / profile / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / profile / properties
      Removed value: -{
      -  "architectures": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "blockers": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "confidence": {
      -    "enum": [
      -      "low",
      -      "medium",
      -      "high"
      -    ]
      -  },
      -  "detectedConventions": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "existingTestLocations": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "languages": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "packageManagers": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "root": {
      -    "type": "string"
      -  },
      -  "setupSignals": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "testCommand": {
      -    "type": "string"
      -  },
      -  "testFrameworks": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  }
      -}
    • removedOutput schema / properties / profile / required
      Removed value: -[
      -  "root",
      -  "languages",
      -  "packageManagers",
      -  "testFrameworks",
      -  "architectures",
      -  "detectedConventions",
      -  "existingTestLocations",
      -  "setupSignals",
      -  "confidence",
      -  "blockers"
      -]
    • removedOutput schema / properties / recommended / items
      Removed value: -{
      -  "$ref": "#/$defs/auditTarget"
      -}
    • removedOutput schema / properties / risks / items
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / skipped / items
      Removed value: -{
      -  "$ref": "#/$defs/skippedTarget"
      -}
    • removedOutput schema / properties / untestedCandidates / items
      Removed value: -{
      -  "$ref": "#/$defs/auditTarget"
      -}
    • removedOutput schema / title
      Removed value: -"Repo Test Architect Audit"
  3. Changed1 schema field changedv1.0.0
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "auditTarget": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "existingTestEvidence": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "kind": {
      +                "enum": [
      +                  "filename-convention",
      +                  "direct-relative-import",
      +                  "referenced-relative-reexport",
      +                  "tsconfig-path-import",
      +                  "package-entry-import",
      +                  "bounded-dependency",
      +                  "browser-route-match",
      +                  "csharp-symbol-reference",
      +                  "csharp-test-helper",
      +                  "swift-symbol-reference",
      +                  "python-module-import",
      +                  "python-package-reexport",
      +                  "python-pytest-fixture",
      +                  "python-test-client-route",
      +                  "jvm-symbol-reference",
      +                  "go-symbol-reference",
      +                  "go-source-dependency",
      +                  "rust-symbol-reference",
      +                  "ruby-constant-reference",
      +                  "php-symbol-reference",
      +                  "elixir-module-reference"
      +                ]
      +              },
      +              "strength": {
      +                "enum": [
      +                  "naming",
      +                  "direct",
      +                  "referenced",
      +                  "indirect"
      +                ]
      +              },
      +              "testPath": {
      +                "type": "string"
      +              },
      +              "usage": {
      +                "enum": [
      +                  "called",
      +                  "asserted"
      +                ]
      +              },
      +              "viaUsage": {
      +                "enum": [
      +                  "called",
      +                  "asserted"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "testPath",
      +              "kind",
      +              "strength"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "existingTestPaths": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "id": {
      +          "type": "string"
      +        },
      +        "kind": {
      +          "type": "string"
      +        },
      +        "maintenanceCost": {
      +          "maximum": 10,
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "name": {
      +          "type": "string"
      +        },
      +        "path": {
      +          "type": "string"
      +        },
      +        "reasons": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "recommendedTestLevel": {
      +          "enum": [
      +            "unit",
      +            "integration",
      +            "component",
      +            "ui",
      +            "none"
      +          ]
      +        },
      +        "risk": {
      +          "enum": [
      +            "low",
      +            "medium",
      +            "high"
      +          ]
      +        },
      +        "riskReductionScore": {
      +          "maximum": 10,
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "signals": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "testability": {
      +          "enum": [
      +            "low",
      +            "medium",
      +            "high"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "name",
      +        "id",
      +        "path",
      +        "kind",
      +        "signals",
      +        "risk",
      +        "testability",
      +        "recommendedTestLevel",
      +        "riskReductionScore",
      +        "maintenanceCost",
      +        "reasons",
      +        "existingTestPaths"
      +      ],
      +      "type": "object"
      +    },
      +    "skippedTarget": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "id": {
      +          "type": "string"
      +        },
      +        "kind": {
      +          "type": "string"
      +        },
      +        "maintenanceCost": {
      +          "maximum": 10,
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "name": {
      +          "type": "string"
      +        },
      +        "path": {
      +          "type": "string"
      +        },
      +        "preferredCoveragePath": {
      +          "type": "string"
      +        },
      +        "reason": {
      +          "type": "string"
      +        },
      +        "riskReductionScore": {
      +          "maximum": 10,
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "signals": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        }
      +      },
      +      "required": [
      +        "name",
      +        "id",
      +        "path",
      +        "kind",
      +        "signals",
      +        "riskReductionScore",
      +        "maintenanceCost",
      +        "reason"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "$id": "https://repo-test-architect.local/schemas/audit-v1.schema.json",
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "properties": {
      +    "coveredButRisky": {
      +      "items": {
      +        "$ref": "#/$defs/auditTarget"
      +      },
      +      "type": "array"
      +    },
      +    "profile": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "architectures": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "blockers": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "confidence": {
      +          "enum": [
      +            "low",
      +            "medium",
      +            "high"
      +          ]
      +        },
      +        "detectedConventions": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "existingTestLocations": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "languages": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "packageManagers": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "root": {
      +          "type": "string"
      +        },
      +        "setupSignals": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "testCommand": {
      +          "type": "string"
      +        },
      +        "testFrameworks": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        }
      +      },
      +      "required": [
      +        "root",
      +        "languages",
      +        "packageManagers",
      +        "testFrameworks",
      +        "architectures",
      +        "detectedConventions",
      +        "existingTestLocations",
      +        "setupSignals",
      +        "confidence",
      +        "blockers"
      +      ],
      +      "type": "object"
      +    },
      +    "recommended": {
      +      "items": {
      +        "$ref": "#/$defs/auditTarget"
      +      },
      +      "type": "array"
      +    },
      +    "risks": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "schemaVersion": {
      +      "const": "audit/v1"
      +    },
      +    "skipped": {
      +      "items": {
      +        "$ref": "#/$defs/skippedTarget"
      +      },
      +      "type": "array"
      +    },
      +    "untestedCandidates": {
      +      "items": {
      +        "$ref": "#/$defs/auditTarget"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "schemaVersion",
      +    "profile",
      +    "untestedCandidates",
      +    "coveredButRisky",
      +    "recommended",
      +    "skipped",
      +    "risks"
      +  ],
      +  "title": "Repo Test Architect Audit",
      +  "type": "object"
      +}
  4. First observedv0.1.0

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false and a closed world, so the safety profile is covered. The description adds real behavioral value by disclosing two distinct execution modes (passthrough validation of a saved audit 'unchanged' versus computing an audit from repoRoot/projectRoot), but it says nothing about cost/latency of the compute path or what a validation failure looks like.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is a single front-loaded sentence that opens with the verb and resource before branching into modes and alternatives. The colon-and-comma construction is dense and packs three ideas into one sentence, which costs a little readability but wastes no words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present the return shape need not be described, and the annotations carry the safety profile, so the description's job is mode selection and routing, which it does. The remaining shortfall is that two schema parameters (goTarget, changedPaths) are never referenced and error behavior for a failed validation is unstated.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 80%, so the schema already documents most parameters and the baseline is 3. The description does add the either/or structure between the audit object and the repoRoot+projectRoot pair, which the per-property schema text only states piecemeal, but goTarget and changedPaths receive no mention at all.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource ('Return one project's audit/v1 artifact') with scope limited to a single project, and it distinguishes itself from two named siblings. The only gap is that the tool name says 'graph' while the description never explains any graph aspect, so a small mismatch in framing remains.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It names two concrete alternatives and the conditions selecting them: audit_repo 'when the adapter is selected explicitly' and review_repository 'for a general review'. What is missing is a positive statement of when this tool is the right default, so the routing rule is inferential rather than explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.