Pular para o conteúdo
Sil Builder

CLI e MCP, lado a lado

Busque um comando ou selecione MCP para inspecionar o JSON Schema de cada ferramenta. Os nomes e as descrições técnicas abaixo vêm do código, sem tradução que possa alterar seu significado.

80 resultados

dotnet builder inspect [module/project]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder list modules|projects|contracts|rulesCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder check [--static|--ci|--changed] [--base commit]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder explain ruleCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder baselineCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder fix [--rule SIL1106] [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder refactor uuid-identities [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder refactor rename-entity feature NewName [--plural Plural] [--table schema.table] [--task PLANE-ID --author name --link url [--date yyyy-MM-dd]] [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder refactor rename-field feature Field NewName [--json json] [--column column] [--task PLANE-ID --author name --link url [--date yyyy-MM-dd]] [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder refactor move-route feature area/vN/resource [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder refactor change-public feature client|backoffice[,...] [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder new satellite name [--sdkmono-version version]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder new module nameCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder new entity name --module nameCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder new migration task description --author name --link url --date yyyy-MM-ddCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder new feature Module slug --entity Name [--superficie api,persistencia] [--publics client,backoffice] [--date yyyy-MM-dd] [--owner team] [--from-db schema.table --connection cs] [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder spec lint [paths...] [--db cs]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder spec plan feature [--task PLANE-ID --author name --link url [--date yyyy-MM-dd]]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder spec apply feature [--task PLANE-ID --author name --link url [--date yyyy-MM-dd]] [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder spec sync featureCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder tests from-spec feature [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder add field feature Name:type --json json [--required] [--max N] [--unique none|organization|global] [--values A,B] [--target Entity] [--precision P,S] [--description text] [--apply [--task ... --author ... --link ... --date ...]] [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder add filter feature Field op[,op] [--apply ...] [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder add endpoint feature insert|update|patch|delete|get|list [--patch-fields Name,Active] [--apply ...] [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder add permission feature operation PRD.MOD.funcio.objeto.AC [--apply ...] [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder add platform-client Name --openapi openapi.json --tag Tag [--solution file.slnx] [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder plan fileCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder apply fileCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder recoverCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder manifest rebuild [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder contract export|lint|diff --input openapi.jsonCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder contract export --from-specs [--output .builder/openapi.json] [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder contract hoppscotch [--input .builder/openapi.json] [--output .builder/hoppscotch.json] [--dry-run]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder db verify --connection cs [--baseline schema.sql] [--keep]CLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder db diff feature --connection csCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder contextCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder docsCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder doctorCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder pr summary --base commitCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

dotnet builder release notes --base commitCLI

Sintaxe exportada por help. Substitua os argumentos posicionais e revise as opções antes de executar.

builder_add_endpointMCP

Publishes an operation, creating builder.api with the default resource when absent.

{
  "additionalProperties": false,
  "properties": {
    "apply": {
      "description": "After editing the spec, run spec apply on the feature; task, author, link and date go with it (migration header, BLD2001).",
      "type": "boolean"
    },
    "author": {
      "description": "Author name.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "date": {
      "description": "Date in yyyy-MM-dd.",
      "minLength": 1,
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "type": "string"
    },
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "feature": {
      "description": "The feature: its id (features/<module>/<yyyy-MM-dd>-<slug>) or its .md path.",
      "minLength": 1,
      "pattern": "^(features/([a-z0-9-]+/)*[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+|(?!-).+\\.md)$",
      "type": "string"
    },
    "link": {
      "description": "Absolute http(s) link of the task.",
      "minLength": 1,
      "pattern": "^https?://",
      "type": "string"
    },
    "operation": {
      "description": "Operation.",
      "enum": [
        "insert",
        "update",
        "patch",
        "delete",
        "get",
        "list"
      ],
      "type": "string"
    },
    "patchFields": {
      "description": "Explicit allowlist required for patch.",
      "items": {
        "description": "Allowed C# field name.",
        "minLength": 1,
        "pattern": "^[A-Z][A-Za-z0-9]*$",
        "type": "string"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "task": {
      "description": "Task id such as BLD-42.",
      "minLength": 1,
      "pattern": "^[A-Za-z][A-Za-z0-9]*-[0-9]+$",
      "type": "string"
    }
  },
  "required": [
    "feature",
    "operation"
  ],
  "type": "object"
}
builder_add_fieldMCP

Adds a field to the builder block of a feature; refused when it would introduce lint errors.

{
  "additionalProperties": false,
  "properties": {
    "apply": {
      "description": "After editing the spec, run spec apply on the feature; task, author, link and date go with it (migration header, BLD2001).",
      "type": "boolean"
    },
    "author": {
      "description": "Author name.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "date": {
      "description": "Date in yyyy-MM-dd.",
      "minLength": 1,
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "type": "string"
    },
    "description": {
      "description": "Description of the field.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "feature": {
      "description": "The feature: its id (features/<module>/<yyyy-MM-dd>-<slug>) or its .md path.",
      "minLength": 1,
      "pattern": "^(features/([a-z0-9-]+/)*[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+|(?!-).+\\.md)$",
      "type": "string"
    },
    "json": {
      "description": "JSON name in lower snake_case.",
      "minLength": 1,
      "pattern": "^[a-z][a-z0-9]*(_[a-z0-9]+)*$",
      "type": "string"
    },
    "link": {
      "description": "Absolute http(s) link of the task.",
      "minLength": 1,
      "pattern": "^https?://",
      "type": "string"
    },
    "max": {
      "description": "Maximum length (string, text).",
      "maximum": 10485760,
      "minimum": 1,
      "type": "integer"
    },
    "name": {
      "description": "C# name in PascalCase.",
      "minLength": 1,
      "pattern": "^[A-Z][A-Za-z0-9]*$",
      "type": "string"
    },
    "precision": {
      "additionalProperties": false,
      "description": "Decimal precision and scale (decimal fields; default 18,2).",
      "properties": {
        "precision": {
          "description": "Total digits.",
          "maximum": 38,
          "minimum": 1,
          "type": "integer"
        },
        "scale": {
          "description": "Digits after the point.",
          "maximum": 38,
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "precision",
        "scale"
      ],
      "type": "object"
    },
    "required": {
      "description": "The field is required.",
      "type": "boolean"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "target": {
      "description": "Referenced entity of the same module.",
      "minLength": 1,
      "pattern": "^[A-Z][A-Za-z0-9]*$",
      "type": "string"
    },
    "task": {
      "description": "Task id such as BLD-42.",
      "minLength": 1,
      "pattern": "^[A-Za-z][A-Za-z0-9]*-[0-9]+$",
      "type": "string"
    },
    "type": {
      "description": "Field type.",
      "enum": [
        "string",
        "text",
        "json",
        "jsonb",
        "int",
        "long",
        "decimal",
        "bool",
        "date",
        "datetime",
        "guid",
        "enum",
        "reference"
      ],
      "type": "string"
    },
    "unique": {
      "description": "Uniqueness.",
      "enum": [
        "none",
        "organization",
        "global"
      ],
      "type": "string"
    },
    "values": {
      "description": "Allowed codes of an enum field.",
      "items": {
        "description": "Code.",
        "minLength": 1,
        "pattern": "^[A-Z0-9_]{1,20}$",
        "type": "string"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    }
  },
  "required": [
    "feature",
    "name",
    "type",
    "json"
  ],
  "type": "object"
}
builder_add_filterMCP

Adds (or merges) the list filter of a field in the builder block.

{
  "additionalProperties": false,
  "properties": {
    "apply": {
      "description": "After editing the spec, run spec apply on the feature; task, author, link and date go with it (migration header, BLD2001).",
      "type": "boolean"
    },
    "author": {
      "description": "Author name.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "date": {
      "description": "Date in yyyy-MM-dd.",
      "minLength": 1,
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "type": "string"
    },
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "feature": {
      "description": "The feature: its id (features/<module>/<yyyy-MM-dd>-<slug>) or its .md path.",
      "minLength": 1,
      "pattern": "^(features/([a-z0-9-]+/)*[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+|(?!-).+\\.md)$",
      "type": "string"
    },
    "field": {
      "description": "C# name of an existing field.",
      "minLength": 1,
      "pattern": "^[A-Z][A-Za-z0-9]*$",
      "type": "string"
    },
    "link": {
      "description": "Absolute http(s) link of the task.",
      "minLength": 1,
      "pattern": "^https?://",
      "type": "string"
    },
    "ops": {
      "description": "Filter operators.",
      "items": {
        "description": "Operator.",
        "enum": [
          "eq",
          "neq",
          "in",
          "like",
          "gt",
          "gte",
          "lt",
          "lte",
          "range",
          "null"
        ],
        "type": "string"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "task": {
      "description": "Task id such as BLD-42.",
      "minLength": 1,
      "pattern": "^[A-Za-z][A-Za-z0-9]*-[0-9]+$",
      "type": "string"
    }
  },
  "required": [
    "feature",
    "field",
    "ops"
  ],
  "type": "object"
}
builder_add_permissionMCP

Sets the Sil permission code (PRD.MOD.funcio.objeto.AC) of a published operation.

{
  "additionalProperties": false,
  "properties": {
    "apply": {
      "description": "After editing the spec, run spec apply on the feature; task, author, link and date go with it (migration header, BLD2001).",
      "type": "boolean"
    },
    "author": {
      "description": "Author name.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "code": {
      "description": "Permission code; the action range matches the operation (get/list 10-19, insert 20-29, update 30-39, delete 40-49).",
      "minLength": 1,
      "pattern": "^[A-Z]{3}\\.[A-Z]{3}\\.[a-z]{6}\\.[a-z]{6}\\.(1[0-9]|[2-9][0-9])$",
      "type": "string"
    },
    "date": {
      "description": "Date in yyyy-MM-dd.",
      "minLength": 1,
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "type": "string"
    },
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "feature": {
      "description": "The feature: its id (features/<module>/<yyyy-MM-dd>-<slug>) or its .md path.",
      "minLength": 1,
      "pattern": "^(features/([a-z0-9-]+/)*[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+|(?!-).+\\.md)$",
      "type": "string"
    },
    "link": {
      "description": "Absolute http(s) link of the task.",
      "minLength": 1,
      "pattern": "^https?://",
      "type": "string"
    },
    "operation": {
      "description": "Operation.",
      "enum": [
        "insert",
        "update",
        "patch",
        "delete",
        "get",
        "list"
      ],
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "task": {
      "description": "Task id such as BLD-42.",
      "minLength": 1,
      "pattern": "^[A-Za-z][A-Za-z0-9]*-[0-9]+$",
      "type": "string"
    }
  },
  "required": [
    "feature",
    "operation",
    "code"
  ],
  "type": "object"
}
builder_add_platform_clientMCP

L14: an optional typed HTTP client of the operations of one tag of the platform's OpenAPI 3.x JSON document, in src/Platform/Sil.Platform.<Name> (added to the solution): I<Name>Client with one async method per operationId, DTO records, errors returned as Result/SilError (the platform envelope, timeout, transport failure, 5xx, unexpected response), the identity hook (forwards Authorization until BDN-003.c), Add<Name>PlatformClient(IConfiguration) bound to Platform:<Name>, Fake<Name>Client and generated tests. Unsupported OpenAPI constructs are BLD7004; hand edits stop with SIL1601.

{
  "additionalProperties": false,
  "properties": {
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "name": {
      "description": "Client name in PascalCase; the project is Sil.Platform.<Name>.",
      "minLength": 1,
      "pattern": "^[A-Z][A-Za-z0-9]*$",
      "type": "string"
    },
    "openapi": {
      "description": "OpenAPI 3.0/3.1 JSON document of the platform, relative to the workspace.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "solution": {
      "description": "Solution file (.slnx/.sln) when the workspace has several.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "tag": {
      "description": "The tag whose operations the client gets.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    }
  },
  "required": [
    "name",
    "openapi",
    "tag"
  ],
  "type": "object"
}
builder_applyMCP

Applies a generation plan file under the apply lock and recovery journal, refusing stale files; dryRun only validates it.

{
  "additionalProperties": false,
  "properties": {
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "file": {
      "description": "Plan JSON file, relative to the workspace.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "file"
  ],
  "type": "object"
}
builder_baselineMCP

Runs check and writes its diagnostics to .builder/debt.json as an inventory (no exemptions for blocking modules); dryRun previews the file.

{
  "additionalProperties": false,
  "properties": {
    "base": {
      "description": "Base commit for migration immutability (BLD2004).",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "mode": {
      "description": "static or changed.",
      "enum": [
        "static",
        "changed"
      ],
      "type": "string"
    },
    "noBuild": {
      "description": "Skip the build; the inventory is then incomplete.",
      "type": "boolean"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "solution": {
      "description": "Solution file (.slnx/.sln) when the workspace has several.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
builder_checkMCP

Structure, source review, migrations, generated files, error catalog, message norm and build (tests with mode ci). Every diagnostic carries fix {kind, command?, args?} and level N0|N1|N2.

{
  "additionalProperties": false,
  "properties": {
    "base": {
      "description": "Base commit for migration immutability (BLD2004).",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "mode": {
      "description": "static, ci (also runs tests and lists incomplete rules) or changed.",
      "enum": [
        "static",
        "ci",
        "changed"
      ],
      "type": "string"
    },
    "noBuild": {
      "description": "Skip the build; the report is then incomplete.",
      "type": "boolean"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "solution": {
      "description": "Solution file (.slnx/.sln) when the workspace has several.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
builder_contextMCP

Writes .builder/context.md and the managed region of AGENTS.md: per module, entities and fields, endpoints, errors, business regions, active rules and commands.

{
  "additionalProperties": false,
  "properties": {
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "solution": {
      "description": "Solution file (.slnx/.sln) when the workspace has several.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
builder_contract_diffMCP

Compares a base and a current OpenAPI document; exit 1 on breaking changes.

{
  "additionalProperties": false,
  "properties": {
    "base": {
      "description": "Base OpenAPI JSON file.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "input": {
      "description": "Current OpenAPI JSON file.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "input",
    "base"
  ],
  "type": "object"
}
builder_contract_exportMCP

Writes an OpenAPI document through the generation plan: a linted input file to output, or (fromSpecs) the OpenAPI 3.1 document derived from every feature spec with builder.api (L12), at output or .builder/openapi.json.

{
  "additionalProperties": false,
  "oneOf": [
    {
      "not": {
        "required": [
          "fromSpecs"
        ]
      },
      "required": [
        "input",
        "output"
      ]
    },
    {
      "not": {
        "required": [
          "input"
        ]
      },
      "properties": {
        "fromSpecs": {
          "const": true
        }
      },
      "required": [
        "fromSpecs"
      ]
    }
  ],
  "properties": {
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "fromSpecs": {
      "description": "Derive the document from the feature specs under .plintrix/features instead of reading input.",
      "type": "boolean"
    },
    "input": {
      "description": "OpenAPI JSON file; not with fromSpecs.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "output": {
      "description": "Output path relative to the workspace; required with input, .builder/openapi.json by default with fromSpecs.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
builder_contract_hoppscotchMCP

Writes a Hoppscotch collection (collection v11, request v17) generated from an OpenAPI document (L12): one folder per tag, one request per operation on <<baseUrl>> with the bearer <<token>>, valid example bodies and one saved example per status.

{
  "additionalProperties": false,
  "properties": {
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "input": {
      "description": "OpenAPI JSON file; .builder/openapi.json by default.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "output": {
      "description": "Output path relative to the workspace; .builder/hoppscotch.json by default.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
builder_contract_lintMCP

Lints an OpenAPI 3 document (BLD4001): summaries, tags, operationIds, error envelope, parameters, object_id.

{
  "additionalProperties": false,
  "properties": {
    "input": {
      "description": "OpenAPI JSON file.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}
builder_db_diffMCP

L11: compares one feature's table with the real schema of an existing database, read from pg_catalog in a READ ONLY transaction (never writes): missing or extra tables and columns, types, nullability, defaults, constraints, indexes, partial predicates and comments, each with its JSON path; exit 1 on drift.

{
  "additionalProperties": false,
  "properties": {
    "connection": {
      "description": "PostgreSQL connection string of the database to compare (read only).",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "feature": {
      "description": "The feature: its id (features/<module>/<yyyy-MM-dd>-<slug>) or its .md path.",
      "minLength": 1,
      "pattern": "^(features/([a-z0-9-]+/)*[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+|(?!-).+\\.md)$",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "feature",
    "connection"
  ],
  "type": "object"
}
builder_db_verifyMCP

L9: creates sil_verify_<random> on the server, applies the optional schema-only baseline and every .migrations/V*.sql twice (idempotency), compares the result with the specs and snapshots (BLD6005-BLD6016), prepares and explains every statement of the generated query repositories (BLD6017) and drops the database. Nothing else on the server is touched; exit 1 on any finding.

{
  "additionalProperties": false,
  "properties": {
    "baseline": {
      "description": "Schema-only baseline SQL file applied before the migrations (optional while PAR-08 has no approved baseline).",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "connection": {
      "description": "PostgreSQL connection string of a role that may create databases (CREATEDB).",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "keep": {
      "description": "Keep the disposable database and report its name, for inspection.",
      "type": "boolean"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "connection"
  ],
  "type": "object"
}
builder_doctorMCP

SDK version, profile, solution and projects that need a restore.

{
  "additionalProperties": false,
  "properties": {
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "solution": {
      "description": "Solution file (.slnx/.sln) when the workspace has several.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
builder_executeMCP

Debugging only: runs any builder command line through the shared CLI engine. Prefer the typed builder_* tools, whose closed schemas reject invalid arguments.

{
  "additionalProperties": false,
  "properties": {
    "args": {
      "description": "The CLI arguments, such as [\"list\", \"rules\"].",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "args"
  ],
  "type": "object"
}
builder_explainMCP

Description, decision source, level, fix (with the command template) and good/bad examples of one rule.

{
  "additionalProperties": false,
  "properties": {
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "rule": {
      "description": "Rule id from the catalog.",
      "enum": [
        "SIL1001",
        "SIL1002",
        "SIL1003",
        "SIL1004",
        "SIL1006",
        "SIL1104",
        "SIL1105",
        "SIL1106",
        "SIL1108",
        "SIL1201",
        "SIL1204",
        "SIL1206",
        "SIL1301",
        "SIL1302",
        "SIL1303",
        "SIL1305",
        "SIL1306",
        "SIL1307",
        "SIL1308",
        "SIL1309",
        "SIL1404",
        "SIL1801",
        "SIL1601",
        "SIL9001",
        "BLD2001",
        "BLD2002",
        "BLD2003",
        "BLD2004",
        "BLD2005",
        "BLD2006",
        "BLD2007",
        "BLD2008",
        "BLD2009",
        "BLD4001",
        "BLD4002",
        "BLD4003",
        "BLD4004",
        "BLD4005",
        "BLD7001",
        "BLD7002",
        "BLD7003",
        "BLD7004",
        "BLD7005",
        "BLD7006",
        "BLD7010",
        "BLD7011",
        "BLD7012",
        "BLD7013",
        "BLD7014",
        "BLD7015",
        "BLD7016",
        "BLD5001",
        "BLD5002",
        "BLD5003",
        "BLD5004",
        "BLD5005",
        "BLD5006",
        "BLD5010",
        "BLD5011",
        "BLD5012",
        "BLD5013",
        "BLD5014",
        "BLD5015",
        "BLD5016",
        "BLD5017",
        "BLD5018",
        "BLD5019",
        "BLD5020",
        "BLD5021",
        "BLD5030",
        "BLD5031",
        "BLD5032",
        "BLD5033",
        "BLD5034",
        "BLD5035",
        "BLD5036",
        "BLD5040",
        "BLD6001",
        "BLD6002",
        "BLD6003",
        "BLD6004",
        "BLD6005",
        "BLD6006",
        "BLD6007",
        "BLD6008",
        "BLD6009",
        "BLD6010",
        "BLD6011",
        "BLD6012",
        "BLD6013",
        "BLD6014",
        "BLD6015",
        "BLD6016",
        "BLD6017",
        "BLD6018",
        "BLD6019",
        "BLD6020",
        "SIL1103",
        "BLD3001",
        "BLD3002"
      ],
      "type": "string"
    }
  },
  "required": [
    "rule"
  ],
  "type": "object"
}
builder_fixMCP

Applies the deterministic fix of a rule (today SIL1106: Guid Id initializers of Domain projects).

{
  "additionalProperties": false,
  "properties": {
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "rule": {
      "description": "Rule with a deterministic fix.",
      "enum": [
        "SIL1106"
      ],
      "type": "string"
    },
    "solution": {
      "description": "Solution file (.slnx/.sln) when the workspace has several.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
builder_inspectMCP

The discovered solution, projects, layers, references and packages, or the projects of one module or project.

{
  "additionalProperties": false,
  "properties": {
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "solution": {
      "description": "Solution file (.slnx/.sln) when the workspace has several.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "target": {
      "description": "Module or project name.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
builder_listMCP

List the modules, projects, Contracts projects or the rule catalog of the solution.

{
  "additionalProperties": false,
  "properties": {
    "kind": {
      "description": "What to list.",
      "enum": [
        "modules",
        "projects",
        "contracts",
        "rules"
      ],
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "solution": {
      "description": "Solution file (.slnx/.sln) when the workspace has several.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    }
  },
  "required": [
    "kind"
  ],
  "type": "object"
}
builder_manifest_rebuildMCP

BDN-012.a after a merge: rewrites .builder/manifest.json (even with conflict markers) from the files that are provably generator output, those equal to the generation of the specs and those whose hash a manifest in the git history recorded (the delta migrations of the other branch). Other files keep their old entry (SIL1601) or stay out; nothing else is written. dryRun only reports.

{
  "additionalProperties": false,
  "properties": {
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
builder_new_entityMCP

Adds an entity scaffold to an existing module.

{
  "additionalProperties": false,
  "properties": {
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "module": {
      "description": "Existing module in PascalCase.",
      "minLength": 1,
      "pattern": "^[A-Z][A-Za-z0-9]*$",
      "type": "string"
    },
    "name": {
      "description": "Entity name in PascalCase.",
      "minLength": 1,
      "pattern": "^[A-Z][A-Za-z0-9]*$",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "solution": {
      "description": "Solution file (.slnx/.sln) when the workspace has several.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    }
  },
  "required": [
    "name",
    "module"
  ],
  "type": "object"
}
builder_new_featureMCP

Creates a C4 feature spec (template v2) with a lint-clean builder skeleton in .plintrix/features/<module>/<date>-<slug>.md. With fromDb and connection, the entity and fields are inferred from an existing table (read only); what the database cannot tell is reported as BLD6018.

{
  "additionalProperties": false,
  "properties": {
    "connection": {
      "description": "PostgreSQL connection string of the database that holds fromDb (read only).",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "date": {
      "description": "Date in yyyy-MM-dd.",
      "minLength": 1,
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "type": "string"
    },
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "entity": {
      "description": "Entity in PascalCase.",
      "minLength": 1,
      "pattern": "^[A-Z][A-Za-z0-9]*$",
      "type": "string"
    },
    "fromDb": {
      "description": "Existing table <schema>.<table> to infer the entity and fields from; needs connection.",
      "minLength": 1,
      "pattern": "^[a-z][a-z0-9_]*\\.[a-z][a-z0-9_]*$",
      "type": "string"
    },
    "module": {
      "description": "Module in PascalCase.",
      "minLength": 1,
      "pattern": "^[A-Z][A-Za-z0-9]*$",
      "type": "string"
    },
    "owner": {
      "description": "Owner team such as @silsistemas/dock.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "publics": {
      "description": "Publics of the HTTP surface (default client); needs api in superficie.",
      "items": {
        "description": "Public.",
        "enum": [
          "client",
          "backoffice"
        ],
        "type": "string"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "slug": {
      "description": "Slug such as dock-docas.",
      "minLength": 1,
      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
      "type": "string"
    },
    "superficie": {
      "description": "Technical surfaces (default api, persistencia).",
      "items": {
        "description": "Surface.",
        "enum": [
          "api",
          "persistencia"
        ],
        "type": "string"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    }
  },
  "required": [
    "module",
    "slug",
    "entity"
  ],
  "type": "object"
}
builder_new_migrationMCP

Creates .migrations/V<yyyyMMdd>_<TASK>.sql with the header and the UP/DOWN blocks of the SQL convention (BLD2001).

{
  "additionalProperties": false,
  "properties": {
    "author": {
      "description": "Author name.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "date": {
      "description": "Date in yyyy-MM-dd.",
      "minLength": 1,
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "type": "string"
    },
    "description": {
      "description": "What the migration does.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "link": {
      "description": "Absolute http(s) link of the task.",
      "minLength": 1,
      "pattern": "^https?://",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "solution": {
      "description": "Solution file (.slnx/.sln) when the workspace has several.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "task": {
      "description": "Task id such as BLD-42.",
      "minLength": 1,
      "pattern": "^[A-Za-z][A-Za-z0-9]*-[0-9]+$",
      "type": "string"
    }
  },
  "required": [
    "task",
    "description",
    "author",
    "link",
    "date"
  ],
  "type": "object"
}
builder_new_moduleMCP

Adds the five projects of a module (and its tests) to the solution.

{
  "additionalProperties": false,
  "properties": {
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "name": {
      "description": "Module name in PascalCase.",
      "minLength": 1,
      "pattern": "^[A-Z][A-Za-z0-9]*$",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "solution": {
      "description": "Solution file (.slnx/.sln) when the workspace has several.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}
builder_new_satelliteMCP

Creates a backend from the sil-satellite template; sdkMonoVersion pins the optional Sil.SdkMono package.

{
  "additionalProperties": false,
  "properties": {
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "name": {
      "description": "Backend name in PascalCase.",
      "minLength": 1,
      "pattern": "^[A-Z][A-Za-z0-9]*$",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "sdkMonoVersion": {
      "description": "Published Sil.SdkMono NuGet version, such as 1.2.3.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}
builder_planMCP

Reads a generation plan file (JSON of a dry run's plan), validates it against the workspace (paths, hashes, journal) and returns it; nothing is written.

{
  "additionalProperties": false,
  "properties": {
    "file": {
      "description": "Plan JSON file, relative to the workspace.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "file"
  ],
  "type": "object"
}
builder_pr_summaryMCP

JSON and Markdown summary from a base commit to HEAD: feature spec changes, contract diff, errors, migrations, generated/business-region/hand-written files, checks and pending items.

{
  "additionalProperties": false,
  "properties": {
    "base": {
      "description": "Base commit, branch or tag.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "releaseNotes": {
      "description": "Title it as release notes (release notes --base).",
      "type": "boolean"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "solution": {
      "description": "Solution file (.slnx/.sln) when the workspace has several.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    }
  },
  "required": [
    "base"
  ],
  "type": "object"
}
builder_recoverMCP

Restores the originals recorded by an interrupted apply (.builder/transaction.json), refusing files changed by hand since; dryRun only checks.

{
  "additionalProperties": false,
  "properties": {
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
builder_refactorMCP

Runs a solution-wide codemod (uuid-identities). The feature codemods of L17 have their own tools: builder_refactor_rename_entity, builder_refactor_rename_field, builder_refactor_move_route and builder_refactor_change_public.

{
  "additionalProperties": false,
  "properties": {
    "codemod": {
      "description": "Codemod.",
      "enum": [
        "uuid-identities"
      ],
      "type": "string"
    },
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "solution": {
      "description": "Solution file (.slnx/.sln) when the workspace has several.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    }
  },
  "required": [
    "codemod"
  ],
  "type": "object"
}
builder_refactor_change_publicMCP

L17 codemod, one plan with spec apply semantics on an applied feature whose spec equals its applied state (BLD7010): the spec block, the generated files, business regions and hand-written C# of the module, its tests and the host (Roslyn rename), .builder state and contract artifacts change together; a moved file is deleted only while it is generator output (SIL1601 otherwise). change-public sets the publics that serve the feature: controllers are added, moved or deleted (only while generator output and unreferenced, BLD7016), the derived contract artifacts are regenerated and removed routes are reported as breaking changes (BLD7015). The database is untouched.

{
  "additionalProperties": false,
  "properties": {
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "feature": {
      "description": "The feature: its id (features/<module>/<yyyy-MM-dd>-<slug>) or its .md path.",
      "minLength": 1,
      "pattern": "^(features/([a-z0-9-]+/)*[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+|(?!-).+\\.md)$",
      "type": "string"
    },
    "publics": {
      "description": "The publics that serve the feature.",
      "items": {
        "description": "Public.",
        "enum": [
          "client",
          "backoffice"
        ],
        "type": "string"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "feature",
    "publics"
  ],
  "type": "object"
}
builder_refactor_move_routeMCP

L17 codemod, one plan with spec apply semantics on an applied feature whose spec equals its applied state (BLD7010): the spec block, the generated files, business regions and hand-written C# of the module, its tests and the host (Roslyn rename), .builder state and contract artifacts change together; a moved file is deleted only while it is generator output (SIL1601 otherwise). move-route serves the feature at another resource (area/vN/resource): the controllers, their tests, hand-written route strings and the derived contract artifacts are regenerated, and the removed routes are reported as breaking changes (BLD7015). The database is untouched.

{
  "additionalProperties": false,
  "properties": {
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "feature": {
      "description": "The feature: its id (features/<module>/<yyyy-MM-dd>-<slug>) or its .md path.",
      "minLength": 1,
      "pattern": "^(features/([a-z0-9-]+/)*[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+|(?!-).+\\.md)$",
      "type": "string"
    },
    "resource": {
      "description": "New resource area/vN/resource, without the public.",
      "minLength": 1,
      "pattern": "^[a-z][a-z0-9-]*/v[1-9][0-9]*/[a-z][a-z0-9-]*$",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "feature",
    "resource"
  ],
  "type": "object"
}
builder_refactor_rename_entityMCP

L17 codemod, one plan with spec apply semantics on an applied feature whose spec equals its applied state (BLD7010): the spec block, the generated files, business regions and hand-written C# of the module, its tests and the host (Roslyn rename), .builder state and contract artifacts change together; a moved file is deleted only while it is generator output (SIL1601 otherwise). rename-entity changes the C# name, plural and optionally the table (same schema) of an applied feature: files named after the entity move, the migration renames the table, its constraints and indexes (ALTER ... RENAME, rows kept) and entity.codeStem keeps every public error code. Refused for an entity another feature references (BLD7012) or a table in another schema (BLD7013).

{
  "additionalProperties": false,
  "properties": {
    "author": {
      "description": "Author name.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "date": {
      "description": "Date in yyyy-MM-dd.",
      "minLength": 1,
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "type": "string"
    },
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "feature": {
      "description": "The feature: its id (features/<module>/<yyyy-MM-dd>-<slug>) or its .md path.",
      "minLength": 1,
      "pattern": "^(features/([a-z0-9-]+/)*[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+|(?!-).+\\.md)$",
      "type": "string"
    },
    "link": {
      "description": "Absolute http(s) link of the task.",
      "minLength": 1,
      "pattern": "^https?://",
      "type": "string"
    },
    "name": {
      "description": "New entity name in PascalCase.",
      "minLength": 1,
      "pattern": "^[A-Z][A-Za-z0-9]*$",
      "type": "string"
    },
    "plural": {
      "description": "New plural in PascalCase; by default derived from the new name like the old plural was.",
      "minLength": 1,
      "pattern": "^[A-Z][A-Za-z0-9]*$",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "table": {
      "description": "New table schema.table, in the same schema.",
      "minLength": 1,
      "pattern": "^[a-z][a-z0-9_]*\\.[a-z][a-z0-9_]*$",
      "type": "string"
    },
    "task": {
      "description": "Task id such as BLD-42.",
      "minLength": 1,
      "pattern": "^[A-Za-z][A-Za-z0-9]*-[0-9]+$",
      "type": "string"
    }
  },
  "required": [
    "feature",
    "name"
  ],
  "type": "object"
}
builder_refactor_rename_fieldMCP

L17 codemod, one plan with spec apply semantics on an applied feature whose spec equals its applied state (BLD7010): the spec block, the generated files, business regions and hand-written C# of the module, its tests and the host (Roslyn rename), .builder state and contract artifacts change together; a moved file is deleted only while it is generator output (SIL1601 otherwise). rename-field changes the C# name and optionally the JSON name and column of a field: field.codeStem keeps every public error code, a new column is renamed by the migration (ALTER TABLE ... RENAME COLUMN, rows kept); a new JSON name is a breaking contract change (BLD7015).

{
  "additionalProperties": false,
  "properties": {
    "author": {
      "description": "Author name.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "column": {
      "description": "New column in lower snake_case; without it the column stays.",
      "minLength": 1,
      "pattern": "^[a-z][a-z0-9]*(_[a-z0-9]+)*$",
      "type": "string"
    },
    "date": {
      "description": "Date in yyyy-MM-dd.",
      "minLength": 1,
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "type": "string"
    },
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "feature": {
      "description": "The feature: its id (features/<module>/<yyyy-MM-dd>-<slug>) or its .md path.",
      "minLength": 1,
      "pattern": "^(features/([a-z0-9-]+/)*[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+|(?!-).+\\.md)$",
      "type": "string"
    },
    "field": {
      "description": "Current C# name of the field.",
      "minLength": 1,
      "pattern": "^[A-Z][A-Za-z0-9]*$",
      "type": "string"
    },
    "json": {
      "description": "New JSON name in lower snake_case (breaking for consumers).",
      "minLength": 1,
      "pattern": "^[a-z][a-z0-9]*(_[a-z0-9]+)*$",
      "type": "string"
    },
    "link": {
      "description": "Absolute http(s) link of the task.",
      "minLength": 1,
      "pattern": "^https?://",
      "type": "string"
    },
    "name": {
      "description": "New C# name in PascalCase.",
      "minLength": 1,
      "pattern": "^[A-Z][A-Za-z0-9]*$",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "task": {
      "description": "Task id such as BLD-42.",
      "minLength": 1,
      "pattern": "^[A-Za-z][A-Za-z0-9]*-[0-9]+$",
      "type": "string"
    }
  },
  "required": [
    "feature",
    "field",
    "name"
  ],
  "type": "object"
}
builder_spec_applyMCP

Executes the plan of the feature, preserving business regions, and updates .builder/ state.

{
  "additionalProperties": false,
  "properties": {
    "author": {
      "description": "Author name.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "date": {
      "description": "Date in yyyy-MM-dd.",
      "minLength": 1,
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "type": "string"
    },
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "feature": {
      "description": "The feature: its id (features/<module>/<yyyy-MM-dd>-<slug>) or its .md path.",
      "minLength": 1,
      "pattern": "^(features/([a-z0-9-]+/)*[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+|(?!-).+\\.md)$",
      "type": "string"
    },
    "link": {
      "description": "Absolute http(s) link of the task.",
      "minLength": 1,
      "pattern": "^https?://",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "task": {
      "description": "Task id such as BLD-42.",
      "minLength": 1,
      "pattern": "^[A-Za-z][A-Za-z0-9]*-[0-9]+$",
      "type": "string"
    }
  },
  "required": [
    "feature"
  ],
  "type": "object"
}
builder_spec_lintMCP

Lint C4 feature specs (BLD5001-BLD5040); without paths, every .plintrix/features/**/*.md. With db, each clean spec is also compared with that database (read only, BLD5040). Diagnostics carry a JSON path, fix and level.

{
  "additionalProperties": false,
  "properties": {
    "db": {
      "description": "PostgreSQL connection string: compare each spec that lints clean with this database, read only (BLD5040).",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "paths": {
      "description": "Files or directories to lint.",
      "items": {
        "description": "A feature .md file or a directory.",
        "minLength": 1,
        "pattern": "^(?!-)",
        "type": "string"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
builder_spec_planMCP

The plan of files (with hashes) that spec apply would write for the feature; nothing is written.

{
  "additionalProperties": false,
  "properties": {
    "author": {
      "description": "Author name.",
      "minLength": 1,
      "pattern": "^(?!-)",
      "type": "string"
    },
    "date": {
      "description": "Date in yyyy-MM-dd.",
      "minLength": 1,
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "type": "string"
    },
    "feature": {
      "description": "The feature: its id (features/<module>/<yyyy-MM-dd>-<slug>) or its .md path.",
      "minLength": 1,
      "pattern": "^(features/([a-z0-9-]+/)*[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+|(?!-).+\\.md)$",
      "type": "string"
    },
    "link": {
      "description": "Absolute http(s) link of the task.",
      "minLength": 1,
      "pattern": "^https?://",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    },
    "task": {
      "description": "Task id such as BLD-42.",
      "minLength": 1,
      "pattern": "^[A-Za-z][A-Za-z0-9]*-[0-9]+$",
      "type": "string"
    }
  },
  "required": [
    "feature"
  ],
  "type": "object"
}
builder_spec_syncMCP

Reports divergences between the spec, the generated code and manual edits; exit 1 when they diverge. Never rewrites the spec.

{
  "additionalProperties": false,
  "properties": {
    "feature": {
      "description": "The feature: its id (features/<module>/<yyyy-MM-dd>-<slug>) or its .md path.",
      "minLength": 1,
      "pattern": "^(features/([a-z0-9-]+/)*[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+|(?!-).+\\.md)$",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "feature"
  ],
  "type": "object"
}
builder_tests_from_specMCP

Applies only the tests of the feature (validators, handlers, HTTP with fakes, acceptance criteria); dryRun previews the plan.

{
  "additionalProperties": false,
  "properties": {
    "dryRun": {
      "description": "Preview the plan (files and hashes) without writing.",
      "type": "boolean"
    },
    "feature": {
      "description": "The feature: its id (features/<module>/<yyyy-MM-dd>-<slug>) or its .md path.",
      "minLength": 1,
      "pattern": "^(features/([a-z0-9-]+/)*[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+|(?!-).+\\.md)$",
      "type": "string"
    },
    "root": {
      "description": "Workspace directory; defaults to the server's working directory.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "feature"
  ],
  "type": "object"
}

Convenções úteis

Seção intitulada “Convenções úteis”
  • --root caminho seleciona o backend consumidor.
  • --solution arquivo.slnx resolve workspaces com mais de uma solução, nos comandos que aceitam a opção.
  • A saída do CLI é JSON; --json é aceito explicitamente.
  • No MCP, prefira builder_* tipado. builder_execute é para depuração.
  • structuredContent contém exitCode, data e nextActions; preencha os placeholders antes de chamar a próxima ferramenta.

Ter um comando no catálogo não significa que toda combinação esteja implementada. Resultados incompletos permanecem incompletos também no MCP.