Project Telos

A bancada compartilhada: estado durável, controle nativo da estação de trabalho, órgãos sensoriais, uma forja de descobertas.

Telos é uma bancada local de zero dependências para criar, simular e reproduzir trabalho de IA. Ela entrega uma superfície MCP de cinco servidores, além de alternativas via CLI: doctors para CI, apresentação, acessibilidade, desempenho e compatibilidade, um motor criativo com kernels determinísticos e dez medidores de medição, pistas de fundição de modelos e forja de aprendizado, e pacotes de prova de pesquisa cobrindo demonstrações causais, corporificadas e quânticas. Ela une gather, index, forum e crucible em um único mapa de operação que você pode executar com um único node demo/run.mjs. Cada execução grava um recibo que você pode verificar novamente.

Project Telos | gather | crucible | index | forum | telos | learn | emet | buildlang

O que faz

• Uma superfície MCP sobre cinco carros-chefe. node demo/telos-mcp.mjs (ou npm start) executa um servidor MCP stdio expondo 41 ferramentas telos.* nativas, e o manifesto do servidor inicia gather, index, forum e crucible ao lado dele: 69 ferramentas no total, mais 29 ferramentas auxiliares de compatibilidade declaradas, com configuração de host pronta para copiar e colar para Codex (TOML), Claude (JSON) e OpenAI Agents.
• Quatro pistas de prova através de uma única CLI. node demo/proof.mjs monta pacotes de prova de ação de agente, alegação de pesquisa, verdade visual e build. Cada um tem um verificador puro que recalcula toda alegação estrutural a partir de materiais embutidos no pacote, tornando uma aprovação pré-formatada estruturalmente impossível, e node demo/proof.mjs verify <packet.json> reproduz qualquer um deles pelo id do schema.
• Nove doctors. O doctor de CI e o triagem de CI leem o estado do GitHub Actions e separam falhas fatais de avisos de migração em tempo de execução. Os doctors de apresentação, acessibilidade, desempenho, compatibilidade e operador auditam paridade do README, a11y estático, orçamentos de bytes, cobertura de protocolo e descobribilidade. Todos rodam offline contra checkouts locais.
• Um motor criativo que você pode medir. Kernels determinísticos (dither ordenado, pixel sort, harmonógrafo, luz agrupada), um contrato de seleção de renderizador WebGPU/WebGL/canvas/estático e dez medidores executáveis cobrindo sinais de histograma, dither, splat, cluster, áudio, flicker, curvatura, interação, incerteza e orçamento de quadros. A superfície visual vive em demo/index.html.
• Pacotes de prova de pesquisa. Preflights determinísticos para inferência causal (conjunto de ajuste mínimo em DAG de brinquedo), sim-para-real corporificada (tração diferencial com envelope de segurança e limite de latência) e correção quântica de erros (código estabilizador de bit-flip de 3 qubits), cada um com controles negativos e não-alegações explícitas.
• Fundição de modelos e forja de aprendizado. Um contrato delimitado para rotear trabalho entre APIs de fronteira hospedadas e modelos locais de pesos abertos, sete contratos de laboratório executáveis com casos de falha e métricas, e um loop de daemon auto-melhorável que só promove mudanças verificadas.
• Ferramentas de contexto para grandes bases de código. Pacotes e envelopes de contexto orçados e validados para entregar um grande workspace a um modelo sem perder a proveniência.
• Controle nativo da estação de trabalho. node demo/native-control.mjs controla o navegador via Chrome DevTools Protocol e aplicativos nativos via Windows UI Automation, entregando eventos sintéticos para que o cursor e o teclado do operador permaneçam livres; a ferramenta MCP telos.native.control é o catálogo de capacidades somente leitura, e pacotes de evidência de navegador tornam a navegação automatizada revisável.

Experimente

Zero dependências de runtime. Node 20 ou mais recente; a CI roda em Node 24.

git clone https://github.com/HarperZ9/telos.git
cd telos
node demo/run.mjs

demo/run.mjs renderiza um cubo 4-D, percebe-o através de canais independentes, verifica as contagens de vértices e arestas recuperadas contra o critério verdadeiro e imprime um certificado que se reverifica a partir de suas próprias evidências. Em seguida, alimenta o loop com um render pequeno demais para ser lido e mostra-o retornando UNVERIFIABLE em vez de uma aprovação confiante. Um verificador que não pode falhar não é um verificador.

A partir daí, os dois comandos de orientação:

node demo/catalog.mjs --summary          # operator map: 69 tools across 5 flagships
node demo/server-manifest.mjs --summary  # 5-server MCP launch map with host config

Resumo esperado do catálogo:

Project Telos MCP Catalog
tools    69 total, 69 available
transport stdio, streamable-http
gather    5 tools ...
index     5 tools ...
forum     5 tools ...
crucible  13 tools ...
telos     41 tools ...

Para executar o servidor MCP para um host: npm start (stdio). Saúde e estado:

node demo/status.mjs --summary
node demo/doctor.mjs --summary
node demo/room.mjs --json

Todo comando emite um envelope project-telos.flagship-action/v1 com status MATCH, DRIFT ou UNVERIFIABLE. O pacote também inclui entradas de binário telos e telos-mcp que roteiam para a mesma superfície de demonstração.

Exemplo prático: um pacote de prova que pode falhar

Monte o pacote de prova de ação de agente de demonstração e reproduza sua verificação a partir apenas do pacote:

node demo/proof.mjs agent-action --demo --json > packet.json
node demo/proof.mjs verify packet.json

Saída esperada:

verdict       MATCH
witness       witnessed / MATCH

O pacote reúne referências de fonte, referências de contexto, rota, decisão de admissão, efeitos colaterais e digests de saída. O verificador recalcula os digests a partir dos materiais embutidos, então editar qualquer campo estrutural inverte o veredito para DRIFT, e uma base recalculável ausente é relatada como UNVERIFIABLE com a lacuna nomeada por caminho. As pistas irmãs funcionam da mesma forma: research recalcula digests de fonte e controle negativo e recusa promoção gated por reprodução em um único pacote, visual recalcula cor e luminância a partir de amostras sRGB embutidas, e build recalcula um invariante de quantidade conservada contra um fixture negativo que deve quebrá-lo. O ledger de entrega está em docs/PROOF-LANES.md.

Superfície de comandos

node demo/catalog.mjs é o mapa autoritativo. Destaques por área:

Área	Comandos
Orientação	run.mjs, catalog.mjs, server-manifest.mjs, status.mjs, doctor.mjs, room.mjs
Doctors	ci-doctor.mjs, ci-triage.mjs, presentation-doctor.mjs, accessibility-doctor.mjs, performance-doctor.mjs, compatibility-doctor.mjs, operator-doctor.mjs, mcp-freshness.mjs
Prova	proof.mjs (ação de agente, pesquisa, visual, build, verificar, exportar), showcase.mjs
Contexto	context-envelope.mjs, context-pack.mjs, action-receipt.mjs, loop-ledger.mjs
Criativo	creative-engine.mjs, creative-kernels.mjs, measurement-layers.mjs, rendering-capabilities.mjs, display-calibration.mjs
Pesquisa	causal-workbench-proof-packet.mjs, embodied-sim2real-proof-packet.mjs, quantum-error-correction-proof-packet.mjs, thermodynamic-ai-chip-receipt.mjs
Fundição	model-foundry.mjs, learning-forge.mjs, learning-forge-labs.mjs
Estação de trabalho	native-control.mjs, browser-evidence.mjs, workstation-substrate.mjs, revival-registry.mjs, second-level-flagship-queue.mjs

A maioria aceita --summary para uma visualização compacta em terminal (TUI) e --json para hosts de IDE, aplicativos e automação.

As pistas de doctor completas: node demo/ci-doctor.mjs, node demo/presentation-doctor.mjs, node demo/accessibility-doctor.mjs, node demo/performance-doctor.mjs, node demo/compatibility-doctor.mjs e node demo/operator-doctor.mjs, além de node demo/ci-triage.mjs e node demo/mcp-freshness.mjs. A ingestão de CI ao vivo funciona somente leitura: node demo/ci-triage.mjs --gh-run owner/repo#run_id --summary.

Documentação

• docs/INTRODUCTION.md: o que é o Telos e seus primeiros dez minutos.
• docs/HOW-IT-WORKS.md: o loop do verificador, passo a passo, inclusive onde ele para.
• docs/ARCHITECTURE.md e docs/PROJECT-CONNECTION-MAP.md: formato do sistema e como os cinco carros-chefe se conectam.
• docs/PROOF-LANES.md: os contratos das pistas de prova e o ledger de entrega.
• docs/CURRENT-STATE.md: o pacote de estado ao vivo baseado em evidências.
• USAGE.md: comandos de instalação, execução, MCP e verificação.

Repositórios pares: gather (intake de pesquisa), index (mapas de workspace e contexto), forum (roteamento de agentes com ledger causal), crucible (verificação de alegações), emet (testemunha de coerência independente). O Telos inicia e reconcilia todos os cinco a partir de um único manifesto; cada um também funciona de forma independente.

Status e maturidade

Este é um pacote de registro de fonte versão 0.2.0. A superfície de comandos acima é testada e coberta pela CI (o repositório carrega mais de 60 arquivos de teste executados individualmente na CI), mas a publicação no npm é controlada pelo operador e as interfaces podem ainda mudar entre versões menores. Os pacotes de pesquisa são preflights determinísticos com não-alegações explícitas: o pacote causal não alega descoberta causal, o pacote corporificado não alega segurança de robô real, o pacote quântico não alega QEC de hardware. Trate os recibos e testes neste repositório como a evidência, não contagens de prosa.

O roadmap de consolidação ativo está em docs/PROJECT-TELOS-LARGE-SCALE-ROADMAP-2026-07-02.md, e o plano de controle de documentação é docs/DOCUMENTATION-CONSOLIDATION-REGISTRY-2026-07-02.md, com o registro legível por máquina em docs/registry/.

O recibo por baixo

Uma ideia percorre tudo aqui: uma ação ou alegação só conta quando carrega evidência que uma pessoa ou outro sistema possa verificar novamente mais tarde, e quando a verificação não pode passar, a resposta é um honesto UNVERIFIABLE em vez de um palpite confiante. É por isso que todo comando grava um recibo e todo verificador de prova é construído para poder falhar.

Licença

FSL-1.1-ALv2 (fonte justa). O código é aberto para leitura e execução, gratuito para quase qualquer uso, exceto construir um produto concorrente, e cada release converte para Apache 2.0 após dois anos. Os direitos autorais são do autor. Veja LICENSE.

Para desenvolvedores

Zero dependências, então não há nada para instalar. Execute os testes de contrato MCP e os smoke checks antes de abrir um PR:

npm run test:mcp
node demo/catalog.mjs --summary
node demo/server-manifest.mjs --summary
node demo/room.mjs --json

A CI (.github/workflows/ci.yml) executa cada arquivo de teste de contrato individualmente no Node 24; execute qualquer um deles diretamente com node demo/<name>.test.mjs. Mantenha o README, os metadados do pacote e os exemplos alinhados com o comportamento atual; node demo/operator-doctor.mjs --summary verifica essa paridade.

---

Zentropy Labs · ordem a partir do caos. Um laboratório independente que constrói ferramentas baseadas em evidências que deixam um artefato re-verificável para trás. Construído por Zain Dana Harper em Seattle. A bancada completa está em Project Telos.

---

O ecossistema Zentropy Labs

Esta ferramenta é parte de uma família que mantém uma única crença firme em todas as superfícies: conhecimento aberto a qualquer pessoa que possa alcançar os meios; aceitação decidida por verificações externas, nunca por reputação; todo resultado re-executável; nulos honestos em primeira classe; propriedade conquistada por compreensão; aprendizado tecido no trabalho.

• Cânon do workspace: AGENTS.md, CREDO.md, MISSION.md, ECOSYSTEM.md
• Flywheel: a plataforma única (recibos, governança, controles de infraestrutura, loop de aprendizado)
• Começando: seus primeiros trinta minutos

Zentropy Labs - ordem a partir do caos. Construído por Zain Dana Harper em Seattle.