Implementation
gradeNot graded
gradeNot graded
get_architectureAnswer
Read Nivra's active structured architecture, including elements, relations, boundaries, constraints, findings, ownership, and deployment metadata. Visual layout is excluded.
View tool JSON
{
"name": "get_architecture",
"kind": "answer",
"impl": "imperative",
"description": "Read Nivra's active structured architecture, including elements, relations, boundaries, constraints, findings, ownership, and deployment metadata. Visual layout is excluded.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}inspect_elementAnswer
Inspect one architecture element and return its children, incoming and outgoing relations, constraints, and findings.
View tool JSON
{
"name": "inspect_element",
"kind": "answer",
"impl": "imperative",
"description": "Inspect one architecture element and return its children, incoming and outgoing relations, constraints, and findings.",
"inputSchema": {
"type": "object",
"properties": {
"elementId": {
"type": "string",
"description": "Stable ID of the architecture element to inspect."
}
},
"required": [
"elementId"
],
"additionalProperties": false
}
}show_architecture_viewAction
Open an architecture view in the shared Nivra workspace and optionally focus elements or relations visible in that view.
View tool JSON
{
"name": "show_architecture_view",
"kind": "act",
"impl": "imperative",
"description": "Open an architecture view in the shared Nivra workspace and optionally focus elements or relations visible in that view.",
"inputSchema": {
"type": "object",
"properties": {
"viewId": {
"type": "string",
"description": "Stable ID of the architecture view to show."
},
"focusElementIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional element IDs to focus after opening the view."
},
"focusRelationIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional relation IDs to focus after opening the view."
}
},
"required": [
"viewId"
],
"additionalProperties": false
}
}annotate_architectureAction
Create or update an agent Finding with stable evidence IDs. Use this to make an observed architecture risk visible to the human.
View tool JSON
{
"name": "annotate_architecture",
"kind": "act",
"impl": "imperative",
"description": "Create or update an agent Finding with stable evidence IDs. Use this to make an observed architecture risk visible to the human.",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"description": "Stable, idempotent kebab-case finding ID."
},
"title": {
"type": "string",
"minLength": 1
},
"description": {
"type": "string",
"minLength": 1
},
"severity": {
"type": "string",
"enum": [
"info",
"warning",
"error"
]
},
"elementIds": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true
},
"relationIds": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true
}
},
"required": [
"id",
"title",
"description",
"severity"
],
"additionalProperties": false
}
}add_constraintAction
Create or update an explicit deterministic architecture rule. Supported rules are forbidden dependency, independent deployment, no cycles, and allowed protocol.
View tool JSON
{
"name": "add_constraint",
"kind": "act",
"impl": "imperative",
"description": "Create or update an explicit deterministic architecture rule. Supported rules are forbidden dependency, independent deployment, no cycles, and allowed protocol.",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"description": "Stable, idempotent kebab-case constraint ID."
},
"name": {
"type": "string",
"minLength": 1
},
"description": {
"type": "string",
"minLength": 1
},
"severity": {
"type": "string",
"enum": [
"info",
"warning",
"error"
]
},
"rule": {
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"const": "forbidden-dependency"
},
"sourceId": {
"type": "string"
},
"targetId": {
"type": "string"
}
},
"required": [
"type",
"sourceId",
"targetId"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "independent-deployment"
},
"elementId": {
"type": "string"
}
},
"required": [
"type",
"elementId"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "no-cycles"
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "allowed-protocol"
},
"sourceId": {
"type": "string"
},
"targetId": {
"type": "string"
},
"protocols": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"required": [
"type",
"sourceId",
"targetId",
"protocols"
],
"additionalProperties": false
}
]
}
},
"required": [
"id",
"name",
"description",
"severity",
"rule"
],
"additionalProperties": false
}
}create_proposalAction
Create or update a patch-based alternative to Current Architecture. The proposal becomes active, while Current elements and relations remain untouched.
View tool JSON
{
"name": "create_proposal",
"kind": "act",
"impl": "imperative",
"description": "Create or update a patch-based alternative to Current Architecture. The proposal becomes active, while Current elements and relations remain untouched.",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"description": "Stable, idempotent kebab-case proposal ID."
},
"name": {
"type": "string",
"minLength": 1
},
"description": {
"type": "string"
},
"baseVersion": {
"type": "number"
},
"changes": {
"type": "object",
"properties": {
"addElements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"system",
"application",
"microfrontend",
"service",
"module",
"component",
"api",
"contract",
"datastore",
"queue",
"state",
"external-system",
"infrastructure"
]
},
"area": {
"type": "string",
"enum": [
"frontend",
"backend",
"data",
"infrastructure",
"external"
]
},
"level": {
"type": "string",
"enum": [
"system",
"hld",
"lld"
]
},
"parentId": {
"type": "string"
},
"description": {
"type": "string"
},
"technology": {
"type": "string"
},
"owner": {
"type": "string"
},
"deploymentUnit": {
"type": "string"
},
"metadata": {
"type": "object"
}
},
"required": [
"id",
"name",
"kind",
"area",
"level"
],
"additionalProperties": false
}
},
"updateElements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"changes": {
"type": "object",
"minProperties": 1
}
},
"required": [
"id",
"changes"
],
"additionalProperties": false
}
},
"removeElementIds": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true
},
"addRelations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"sourceId": {
"type": "string"
},
"targetId": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"depends-on",
"calls",
"publishes",
"subscribes",
"reads",
"writes",
"shares-state",
"hosts"
]
},
"protocol": {
"type": "string"
},
"description": {
"type": "string"
},
"contractId": {
"type": "string"
},
"metadata": {
"type": "object"
}
},
"required": [
"id",
"sourceId",
"targetId",
"type"
],
"additionalProperties": false
}
},
"updateRelations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"changes": {
"type": "object",
"minProperties": 1
}
},
"required": [
"id",
"changes"
],
"additionalProperties": false
}
},
"removeRelationIds": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true
}
},
"required": [
"addElements",
"updateElements",
"removeElementIds",
"addRelations",
"updateRelations",
"removeRelationIds"
],
"additionalProperties": false
}
},
"required": [
"id",
"name",
"baseVersion",
"changes"
],
"additionalProperties": false
}
}validate_architectureAction
Run Nivra's deterministic constraint engine against Current or the active Proposal and show the result in the shared workspace.
View tool JSON
{
"name": "validate_architecture",
"kind": "act",
"impl": "imperative",
"description": "Run Nivra's deterministic constraint engine against Current or the active Proposal and show the result in the shared workspace.",
"inputSchema": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"current",
"proposal"
],
"description": "Architecture mode to validate. Defaults to the visible active mode."
}
},
"additionalProperties": false
}
}