KG-SSOT
O grafo de conhecimento verificável: toda afirmação diz de onde veio, quando foi conferida e o que depende dela, e o CI recusa a que não diz.
Este pacote traz o contrato formal do KG-SSOT e as ferramentas que o aplicam:
- o leitor de referência, que julga um grafo
.kg.yamlou.kg.jsoncontra o contrato, nos níveis MUST, que reprova, e SHOULD, que alerta; - a suíte de conformidade, em dados puros, que todo leitor tem de passar;
- o gate por grafo para o CI, com catraca: a dívida que já existe fica nomeada e não pode piorar;
- o armazém, que só grava o que passa no contrato;
- o servidor MCP de referência, que dá o contrato e o armazém a um modelo, por stdio ou por HTTP local;
- o exportador de proveniência para PROV-O em JSON-LD.
O contrato, a suíte e o schema do veredito viajam dentro do pacote, e o leitor não depende de nenhum harness de agente. Python 3.11 ou mais, com PyYAML e jsonschema.
Instalar
pip install kg-ssot
Para usar os comandos sem instalar no seu ambiente, use pipx install kg-ssot ou uvx --from kg-ssot kg-validate.
Validar um grafo
kg-validate grafo.kg.yaml outro.kg.json
PASSA grafo.kg.yaml
REPROVA outro.kg.json
MUST form.range.node.impact ×1 · integrity.orphan-node ×1
· 2 arquivos; 1 passam no MUST; 0 com aviso SHOULD (kg-contract-v4.schema.json + kg-contract-v4.should.schema.json)
O rc é 0 quando todos passam no MUST e 1 quando algum reprova. Alguns modos úteis:
kg-validate --wheremostra o nó ou a aresta de cada ocorrência e, numa ocorrência MUST, a correção logo abaixo;kg-validate --format jsondevolve o veredito estruturado, com código, caminho, linha, mensagem e dica, no formato versionadokg-ssot.verdict/1.
Os comandos
| Comando | O que faz |
|---|---|
kg-validate |
Julga grafos .kg.yaml e .kg.json contra o contrato vigente |
kg-conformance |
Roda a suíte de conformidade que vem no pacote contra o leitor de referência |
kg-gate |
Gate por grafo para o CI: grava uma linha de base (--update) e reprova se algo piorar |
kg-store |
Armazém em disco, git ou versionado, que só grava o que passa no contrato |
kg-mcp (e o atalho kg-ssot) |
Servidor MCP de referência (stdio, ou --http em loopback), com as ferramentas kg_validate, kg_write, kg_get, kg_list, kg_query, kg_history, kg_delete e kg_schema_help |
kg-query |
Consulta e projeção de um corpus de grafos, com as arestas resolvidas para o label |
kg-diff |
Diff por id entre dois grafos ou entre revisões do git |
kg-prov-export |
Exporta a proveniência de cada nó como prov:Entity e prov:Derivation em JSON-LD |
Como biblioteca, os módulos ficam em kg_ssot: kg_ssot.kg_validate, kg_ssot.kg_store, kg_ssot.kg_mcp e os
demais.
O servidor MCP
kg-mcp --root ./grafos --init
uvx kg-ssot --root ./grafos --init # o mesmo servidor, sem instalar: kg-ssot é um atalho para kg-mcp
O servidor fala MCP por stdio. Com --http PORTA, ele serve HTTP só em loopback, sem autenticação nem TLS: é para
uso local. Para um servidor exposto, ponha um proxy com autenticação na frente.
Pacote ou vendor
O pacote é o caminho para usar o leitor como biblioteca, como comando ou como servidor MCP. Para o gate no CI de um
repositório, o canal recomendado continua o vendor por tag: o kg_vendor.py traz a release para dentro do seu
repositório, com o sha256 de cada arquivo conferido. Assim o contrato que julga o seu grafo fica no seu diff. O
guia de adoção explica os dois caminhos.
Documentação
- Manual: o formato, o contrato, as ferramentas, a adoção e os problemas comuns
- Guia de adoção
- Suíte de conformidade
- Para agentes de IA (llms.txt)
Licença
Apache-2.0. Veja LICENSE e NOTICE.
1 maintainer
Metadata
1 maintainer
Release files for kg-ssot 4.17.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| kg_ssot-4.17.0.tar.gz | 165.8 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| kg_ssot-4.17.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 562.5 kB
Release files / kg_ssot-4.17.0.tar.gz
| Download URL | kg_ssot-4.17.0.tar.gz |
|---|---|
| Size | 165.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5d9673eaf106a559847587388284739748e84a27663068c4a2068a4b55421dec
|
|
BLAKE2b-256 checksum How to use checksums |
067fe648eaa047e649de55b539f24d7632792f0055cb40cab6b2b62684570821
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.
Transparency logRelease files / kg_ssot-4.17.0-py3-none-any.whl
| Download URL | kg_ssot-4.17.0-py3-none-any.whl |
|---|---|
| Size | 396.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a6da0a7637dd04f9b641a0c0cfe05b80a1259893471bf1e24a4d37bb8ff7bdac
|
|
BLAKE2b-256 checksum How to use checksums |
a5374ede3595819071a8cdc0adc3934bf626b419af916302986ee4fc62f78b1e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.
Transparency logSecurity for kg-ssot 4.17.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for kg_ssot-4.17.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
