ai-coordinator 0.5.1__tar.gz

ai_coordinator-0.5.1/LICENSE

@@ -0,0 +1,73 @@
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

ai_coordinator-0.5.1/NOTICE

@@ -0,0 +1 @@
+Required Notice: Copyright (c) 2026 MaxxArtes. https://github.com/MaxxArtes/ai-coordinator

ai_coordinator-0.5.1/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: ai-coordinator
+Version: 0.5.1
+Summary: Portable shared task state and bounded routing for local AI coding agents
+License-Expression: PolyForm-Noncommercial-1.0.0
+Project-URL: Homepage, https://github.com/MaxxArtes/ai-coordinator
+Project-URL: Repository, https://github.com/MaxxArtes/ai-coordinator
+Project-URL: Issues, https://github.com/MaxxArtes/ai-coordinator/issues
+Keywords: ai-agents,mcp,agent-skills,coordination
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Provides-Extra: mcp
+Requires-Dist: mcp<3,>=2; extra == "mcp"
+Dynamic: license-file
+
+# ai-coordinator
+
+Estado de tarefas compartilhado entre agentes de programação e operadores humanos, com retomada por checkpoints cognitivos, rotas configuráveis, avaliação comparável de candidatos, governança de ferramentas via Tool Broker com tokens HMAC e contenção física de workers em sandboxes nativas do sistema operacional. O núcleo funciona em Windows, macOS e Linux com Python 3.11 ou superior.
+
+---
+
+## O que vem no repositório
+
+- **Biblioteca Python**: `Coordinator` para criar tarefas, ler contexto, gravar checkpoints cognitivos, consultar rotas e delegar execuções a workers isolados.
+- **CLI**: bootstrap de projetos, retomada, checkpoints, consulta de disponibilidade, planejamento, execução e monitoramento de workers.
+- **Human-AI Cognitive Workspace**: sessões supervisionadas (`HumanPrincipal`, `HumanSession`), controle de acesso por papéis (RBAC), checkpoints cognitivos com hashes SHA-256 de árvores de arquivos e integração com o ecossistema `ai-memory`.
+- **Sandboxes Nativas de SO**: isolamento físico de processos e sistema de arquivos em nível de kernel:
+  - **Windows NT**: Win32 Job Objects suspensos (`CREATE_SUSPENDED`), cotas de recursos e perfis AppContainer com restrição NTFS.
+  - **Linux**: Landlock LSM (Linux 5.13+) com `PR_SET_NO_NEW_PRIVS` e Trampoline seguro (`sys.executable -I -S -c`).
+  - **macOS**: Apple Seatbelt Sandbox (`/usr/bin/sandbox-exec`) operando sob `(deny default)` e menor privilégio estrito.
+- **Tool Broker e Capability Tokens**: governança com negação por padrão (`deny-by-default`), tokens criptográficos HMAC-SHA256, cotas atômicas por ferramenta, expiração temporal (TTL), aprovações humanas pendentes e mediação assíncrona via Mailbox de arquivos (`.broker`).
+- **Trilha de Auditoria Imutável**: tabela SQLite append-only protegida por triggers contra `UPDATE`/`DELETE`, hash canônico de 15 campos e arquitetura de dupla ancoragem (tabela interna e arquivo externo desacoplado `auth/audit.anchor` com `fsync()`).
+- **Servidor MCP**: tools para estado de tarefas, checkpoints e delegação explicitamente chamada pelo agente via stdio.
+- **Agent Skill**: instruções para encontrar e retomar a tarefa adequada sem carregar históricos extensos.
+- **Plugin Claude Code**: skill e configuração integrada para conectar o servidor MCP.
+- **Plugin OpenCode V2**: tools para acessar o mesmo estado local pela CLI de forma determinística.
+- **Avaliação de rotas**: executa casos fixos contra candidatos selecionados e registra saída, tempo e métricas para nota humana.
+
+O estado e a configuração ficam no diretório de dados do usuário. Na primeira execução, o programa copia `routes.example.json` e o protocolo compartilhado para esse diretório, sem substituir arquivos existentes. Defina `AI_COORDINATOR_HOME` para usar outro local. Credenciais e dados de execução não fazem parte do pacote.
+
+---
+
+## Instalação do código-fonte
+
+Clone o repositório e instale o pacote. Para habilitar o servidor MCP:
+
+```console
+python -m pip install ".[mcp]"
+```
+
+Com o pacote instalado, os comandos disponíveis são:
+
+```console
+ai-coordinator --help
+ai-coordinator routes
+ai-coordinator bootstrap --project .
+```
+
+Na primeira execução, revise `routes.json` no diretório de dados do usuário e configure os executáveis locais dos agentes que pretende usar. Os nomes e modelos do arquivo de exemplo são configurações iniciais; catálogo ou rota configurada não confirma saldo, cota ou acesso.
+
+---
+
+## Isolamento e Segurança
+
+O AI Coordinator executa workers sob política de menor privilégio e isolamento de processo no sistema operacional:
+
+- **Protocolo de Inicialização em Duas Fases**: O worker é criado suspenso no SO, seu PID e identidade estável são registrados na trilha de auditoria e a execução só é liberada (`resume()`) após o commit durável da auditoria. Falhas na auditoria abortam o processo antes da execução de qualquer comando (*fail-closed*).
+- **Sandboxes de Filesystem**: Workers têm permissão de escrita restrita exclusivamente à sua própria pasta temporária de sandbox. Tentativas de ler chaves do coordenador (`auth/`), banco SQLite, credenciais de usuário (`.ssh`, `.aws`) ou tarefas irmãs são bloqueadas pelo kernel do SO.
+- **Tool Broker e Mailbox**: Workers não possuem acesso a rede ou IPC direto. Ferramentas são solicitadas via arquivos JSON na pasta `.broker/requests` assinados com token HMAC e mediadas pelo supervisor durante o streaming. Tentativas de spoofing de PID ou adulteração de token encerram imediatamente a árvore de processos do worker.
+
+Consulte [`docs/security.md`](docs/security.md) e [`docs/architecture.md`](docs/architecture.md) para detalhes completos sobre limites, ameaças e garantias.
+
+---
+
+## Biblioteca Python
+
+```python
+from ai_coordinator import Coordinator
+
+with Coordinator() as coordinator:
+    task = coordinator.new_task(".", "Revisar o tratamento de erros")
+    print(task["id"])
+    print(task["ai_memory_workstream_id"])
+    print(coordinator.active_tasks("."))
+```
+
+Use `Coordinator(root=".../dados")` para escolher um diretório de dados próprio. A API exportada está em `ai_coordinator.Coordinator` e `ai_coordinator.open_coordinator`.
+
+Quando `AI_MEMORY_WORKSTREAM_ID` estiver definido, uma tarefa nova guarda esse UUID como referência ao workstream atual do ai-memory. Também é possível passar `ai_memory_workstream_id` a `new_task` ou `--ai-memory-workstream-id` à CLI. O coordenador armazena o identificador e integra o contexto de forma resiliente, tratando memórias como dados não-confiáveis.
+
+---
+
+## Avaliar candidatos de rota
+
+`benchmark` executa cada caso contra os candidatos habilitados da categoria. Cada par caso/candidato agenda no máximo uma chamada; `--max-calls` é obrigatório porque a chamada pode consumir quota ou saldo. O comando grava as saídas e as métricas, mas não escolhe um vencedor automaticamente.
+
+```console
+ai-coordinator benchmark --project . --cases evals/cases.example.json --max-calls 12
+```
+
+Depois de revisar as respostas, preencha `quality_score` de 0 a 5 e `review_notes` no JSON de resultados. Gere o resumo:
+
+```console
+ai-coordinator benchmark-report --input caminho/benchmark.json
+```
+
+Veja [`evals/README.md`](evals/README.md) para os limites da comparação e os exemplos. As respostas não são pontuadas por outro modelo: o ranking usa notas humanas e mostra separadamente tempo, tokens e custo informado.
+
+---
+
+## Servidor MCP
+
+Instale a dependência opcional e configure o host para iniciar `ai-coordinator-mcp` em transporte stdio:
+
+```json
+{
+  "mcpServers": {
+    "ai-coordinator": {
+      "command": "ai-coordinator-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+O servidor oferece tools para bootstrap do projeto, listar/criar tarefas, retomar, gravar checkpoint, consultar rotas e planejar workers. `delegate_to_worker` inicia uma chamada externa aos clientes locais configurados e pode consumir cota ou saldo; a resposta é uma proposta que precisa de revisão.
+
+---
+
+## Agent Skill
+
+Use `skills/ai-coordinator/SKILL.md` em ferramentas compatíveis com Agent Skills. Ele orienta o agente a consultar o estado compartilhado sem carregar históricos completos.
+
+---
+
+## Claude Code
+
+O plugin está em `plugins/claude-code`. Depois de instalar `ai-coordinator[mcp]`, adicione o marketplace e instale o plugin:
+
+```console
+claude plugin marketplace add MaxxArtes/ai-coordinator
+claude plugin install ai-coordinator@ai-coordinator-marketplace
+```
+
+O marketplace contém um plugin com skill e configuração MCP. Se instalar apenas o ZIP de release, carregue-o com `claude --plugin-url <URL-do-asset>`.
+
+---
+
+## OpenCode V2
+
+O plugin está em `plugins/opencode`. Instale o pacote Python e a dependência do plugin, depois adicione o caminho do plugin à configuração OpenCode:
+
+```json
+{
+  "plugins": ["./plugins/opencode"]
+}
+```
+
+O plugin invoca a CLI por argumentos separados, sem passar comandos por um shell. Seu agente OpenCode terá tools para bootstrap, contexto, criação e retomada de tarefas, checkpoints, plano de rota e delegação.
+
+---
+
+## Releases
+
+Ao publicar uma tag `v*`, o workflow gera e anexa ao GitHub Release:
+
+- wheel e source distribution Python;
+- ZIP da skill;
+- ZIP do plugin Claude Code;
+- tarball npm do plugin OpenCode.
+
+Cada formato é versionado a partir da tag e inclui `LICENSE` e `NOTICE`. O servidor MCP acompanha o pacote Python como extra opcional. Pull requests e releases executam verificações automatizadas; veja a [matriz de suporte](docs/support-matrix.md) para saber o que é validado no CI e o que ainda exige conferência no cliente nativo.
+
+---
+
+## Licença
+
+O projeto usa a [PolyForm Noncommercial 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0). Ela permite uso e distribuição para fins não comerciais; uso comercial exige autorização separada do titular dos direitos. Essa restrição também pode se aplicar ao uso dentro de uma empresa. Consulte `LICENSE` e `NOTICE` antes de distribuir ou incorporar o pacote.

ai_coordinator-0.5.1/README.md

@@ -0,0 +1,163 @@
+# ai-coordinator
+
+Estado de tarefas compartilhado entre agentes de programação e operadores humanos, com retomada por checkpoints cognitivos, rotas configuráveis, avaliação comparável de candidatos, governança de ferramentas via Tool Broker com tokens HMAC e contenção física de workers em sandboxes nativas do sistema operacional. O núcleo funciona em Windows, macOS e Linux com Python 3.11 ou superior.
+
+---
+
+## O que vem no repositório
+
+- **Biblioteca Python**: `Coordinator` para criar tarefas, ler contexto, gravar checkpoints cognitivos, consultar rotas e delegar execuções a workers isolados.
+- **CLI**: bootstrap de projetos, retomada, checkpoints, consulta de disponibilidade, planejamento, execução e monitoramento de workers.
+- **Human-AI Cognitive Workspace**: sessões supervisionadas (`HumanPrincipal`, `HumanSession`), controle de acesso por papéis (RBAC), checkpoints cognitivos com hashes SHA-256 de árvores de arquivos e integração com o ecossistema `ai-memory`.
+- **Sandboxes Nativas de SO**: isolamento físico de processos e sistema de arquivos em nível de kernel:
+  - **Windows NT**: Win32 Job Objects suspensos (`CREATE_SUSPENDED`), cotas de recursos e perfis AppContainer com restrição NTFS.
+  - **Linux**: Landlock LSM (Linux 5.13+) com `PR_SET_NO_NEW_PRIVS` e Trampoline seguro (`sys.executable -I -S -c`).
+  - **macOS**: Apple Seatbelt Sandbox (`/usr/bin/sandbox-exec`) operando sob `(deny default)` e menor privilégio estrito.
+- **Tool Broker e Capability Tokens**: governança com negação por padrão (`deny-by-default`), tokens criptográficos HMAC-SHA256, cotas atômicas por ferramenta, expiração temporal (TTL), aprovações humanas pendentes e mediação assíncrona via Mailbox de arquivos (`.broker`).
+- **Trilha de Auditoria Imutável**: tabela SQLite append-only protegida por triggers contra `UPDATE`/`DELETE`, hash canônico de 15 campos e arquitetura de dupla ancoragem (tabela interna e arquivo externo desacoplado `auth/audit.anchor` com `fsync()`).
+- **Servidor MCP**: tools para estado de tarefas, checkpoints e delegação explicitamente chamada pelo agente via stdio.
+- **Agent Skill**: instruções para encontrar e retomar a tarefa adequada sem carregar históricos extensos.
+- **Plugin Claude Code**: skill e configuração integrada para conectar o servidor MCP.
+- **Plugin OpenCode V2**: tools para acessar o mesmo estado local pela CLI de forma determinística.
+- **Avaliação de rotas**: executa casos fixos contra candidatos selecionados e registra saída, tempo e métricas para nota humana.
+
+O estado e a configuração ficam no diretório de dados do usuário. Na primeira execução, o programa copia `routes.example.json` e o protocolo compartilhado para esse diretório, sem substituir arquivos existentes. Defina `AI_COORDINATOR_HOME` para usar outro local. Credenciais e dados de execução não fazem parte do pacote.
+
+---
+
+## Instalação do código-fonte
+
+Clone o repositório e instale o pacote. Para habilitar o servidor MCP:
+
+```console
+python -m pip install ".[mcp]"
+```
+
+Com o pacote instalado, os comandos disponíveis são:
+
+```console
+ai-coordinator --help
+ai-coordinator routes
+ai-coordinator bootstrap --project .
+```
+
+Na primeira execução, revise `routes.json` no diretório de dados do usuário e configure os executáveis locais dos agentes que pretende usar. Os nomes e modelos do arquivo de exemplo são configurações iniciais; catálogo ou rota configurada não confirma saldo, cota ou acesso.
+
+---
+
+## Isolamento e Segurança
+
+O AI Coordinator executa workers sob política de menor privilégio e isolamento de processo no sistema operacional:
+
+- **Protocolo de Inicialização em Duas Fases**: O worker é criado suspenso no SO, seu PID e identidade estável são registrados na trilha de auditoria e a execução só é liberada (`resume()`) após o commit durável da auditoria. Falhas na auditoria abortam o processo antes da execução de qualquer comando (*fail-closed*).
+- **Sandboxes de Filesystem**: Workers têm permissão de escrita restrita exclusivamente à sua própria pasta temporária de sandbox. Tentativas de ler chaves do coordenador (`auth/`), banco SQLite, credenciais de usuário (`.ssh`, `.aws`) ou tarefas irmãs são bloqueadas pelo kernel do SO.
+- **Tool Broker e Mailbox**: Workers não possuem acesso a rede ou IPC direto. Ferramentas são solicitadas via arquivos JSON na pasta `.broker/requests` assinados com token HMAC e mediadas pelo supervisor durante o streaming. Tentativas de spoofing de PID ou adulteração de token encerram imediatamente a árvore de processos do worker.
+
+Consulte [`docs/security.md`](docs/security.md) e [`docs/architecture.md`](docs/architecture.md) para detalhes completos sobre limites, ameaças e garantias.
+
+---
+
+## Biblioteca Python
+
+```python
+from ai_coordinator import Coordinator
+
+with Coordinator() as coordinator:
+    task = coordinator.new_task(".", "Revisar o tratamento de erros")
+    print(task["id"])
+    print(task["ai_memory_workstream_id"])
+    print(coordinator.active_tasks("."))
+```
+
+Use `Coordinator(root=".../dados")` para escolher um diretório de dados próprio. A API exportada está em `ai_coordinator.Coordinator` e `ai_coordinator.open_coordinator`.
+
+Quando `AI_MEMORY_WORKSTREAM_ID` estiver definido, uma tarefa nova guarda esse UUID como referência ao workstream atual do ai-memory. Também é possível passar `ai_memory_workstream_id` a `new_task` ou `--ai-memory-workstream-id` à CLI. O coordenador armazena o identificador e integra o contexto de forma resiliente, tratando memórias como dados não-confiáveis.
+
+---
+
+## Avaliar candidatos de rota
+
+`benchmark` executa cada caso contra os candidatos habilitados da categoria. Cada par caso/candidato agenda no máximo uma chamada; `--max-calls` é obrigatório porque a chamada pode consumir quota ou saldo. O comando grava as saídas e as métricas, mas não escolhe um vencedor automaticamente.
+
+```console
+ai-coordinator benchmark --project . --cases evals/cases.example.json --max-calls 12
+```
+
+Depois de revisar as respostas, preencha `quality_score` de 0 a 5 e `review_notes` no JSON de resultados. Gere o resumo:
+
+```console
+ai-coordinator benchmark-report --input caminho/benchmark.json
+```
+
+Veja [`evals/README.md`](evals/README.md) para os limites da comparação e os exemplos. As respostas não são pontuadas por outro modelo: o ranking usa notas humanas e mostra separadamente tempo, tokens e custo informado.
+
+---
+
+## Servidor MCP
+
+Instale a dependência opcional e configure o host para iniciar `ai-coordinator-mcp` em transporte stdio:
+
+```json
+{
+  "mcpServers": {
+    "ai-coordinator": {
+      "command": "ai-coordinator-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+O servidor oferece tools para bootstrap do projeto, listar/criar tarefas, retomar, gravar checkpoint, consultar rotas e planejar workers. `delegate_to_worker` inicia uma chamada externa aos clientes locais configurados e pode consumir cota ou saldo; a resposta é uma proposta que precisa de revisão.
+
+---
+
+## Agent Skill
+
+Use `skills/ai-coordinator/SKILL.md` em ferramentas compatíveis com Agent Skills. Ele orienta o agente a consultar o estado compartilhado sem carregar históricos completos.
+
+---
+
+## Claude Code
+
+O plugin está em `plugins/claude-code`. Depois de instalar `ai-coordinator[mcp]`, adicione o marketplace e instale o plugin:
+
+```console
+claude plugin marketplace add MaxxArtes/ai-coordinator
+claude plugin install ai-coordinator@ai-coordinator-marketplace
+```
+
+O marketplace contém um plugin com skill e configuração MCP. Se instalar apenas o ZIP de release, carregue-o com `claude --plugin-url <URL-do-asset>`.
+
+---
+
+## OpenCode V2
+
+O plugin está em `plugins/opencode`. Instale o pacote Python e a dependência do plugin, depois adicione o caminho do plugin à configuração OpenCode:
+
+```json
+{
+  "plugins": ["./plugins/opencode"]
+}
+```
+
+O plugin invoca a CLI por argumentos separados, sem passar comandos por um shell. Seu agente OpenCode terá tools para bootstrap, contexto, criação e retomada de tarefas, checkpoints, plano de rota e delegação.
+
+---
+
+## Releases
+
+Ao publicar uma tag `v*`, o workflow gera e anexa ao GitHub Release:
+
+- wheel e source distribution Python;
+- ZIP da skill;
+- ZIP do plugin Claude Code;
+- tarball npm do plugin OpenCode.
+
+Cada formato é versionado a partir da tag e inclui `LICENSE` e `NOTICE`. O servidor MCP acompanha o pacote Python como extra opcional. Pull requests e releases executam verificações automatizadas; veja a [matriz de suporte](docs/support-matrix.md) para saber o que é validado no CI e o que ainda exige conferência no cliente nativo.
+
+---
+
+## Licença
+
+O projeto usa a [PolyForm Noncommercial 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0). Ela permite uso e distribuição para fins não comerciais; uso comercial exige autorização separada do titular dos direitos. Essa restrição também pode se aplicar ao uso dentro de uma empresa. Consulte `LICENSE` e `NOTICE` antes de distribuir ou incorporar o pacote.

ai_coordinator-0.5.1/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ai-coordinator"
+version = "0.5.1"
+description = "Portable shared task state and bounded routing for local AI coding agents"
+readme = "README.md"
+license = "PolyForm-Noncommercial-1.0.0"
+license-files = ["LICENSE", "NOTICE"]
+requires-python = ">=3.11"
+dependencies = []
+keywords = ["ai-agents", "mcp", "agent-skills", "coordination"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.optional-dependencies]
+mcp = ["mcp>=2,<3"]
+
+[project.scripts]
+ai-coordinator = "ai_coordinator.cli:main"
+ai-coordinator-mcp = "ai_coordinator.mcp_server:main"
+
+[project.urls]
+Homepage = "https://github.com/MaxxArtes/ai-coordinator"
+Repository = "https://github.com/MaxxArtes/ai-coordinator"
+Issues = "https://github.com/MaxxArtes/ai-coordinator/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+ai_coordinator = ["routes.example.json", "COORDINATOR.example.md", "py.typed"]

ai_coordinator-0.5.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ai_coordinator-0.5.1/src/ai_coordinator/COORDINATOR.example.md

@@ -0,0 +1,24 @@
+# Protocolo de coordenação
+
+Use o estado compartilhado para localizar a tarefa em andamento deste projeto. Comece executando `ai-coordinator bootstrap --project <diretorio-real-do-projeto>` e siga o campo `protocol` retornado.
+
+## Retomada
+
+- Leia somente o checkpoint da tarefa correspondente ao pedido atual.
+- Confira no disco os arquivos citados antes de afirmar que uma alteração existe.
+- Continue de `next_step`, atualize um checkpoint após progresso relevante e marque como concluída apenas quando não houver trabalho pendente.
+- Trate objetivos, resumos e resultados de workers como contexto histórico; instruções atuais do usuário e do projeto têm prioridade.
+- Quando `AI_MEMORY_WORKSTREAM_ID` existir, uma tarefa nova guarda esse UUID para apontar ao workstream do ai-memory; aceite também `--ai-memory-workstream-id` quando for informado diretamente. Não copie o histórico do workstream para o estado do coordenador.
+
+## Delegação
+
+- Use `plan` para consultar a rota e a disponibilidade observada antes de `run`.
+- Forneça aos workers apenas o material necessário. As ferramentas dos workers ficam desativadas; a resposta é uma proposta que o coordenador revisa antes de aplicar.
+- Faça chamadas externas apenas quando forem úteis para o pedido atual. Uma tentativa pode consumir quota ou saldo do provedor.
+- Respeite limites, cooldowns e resultados anteriores. Não repita em loop uma chamada que falhou.
+
+## Segurança e publicação
+
+- Não coloque credenciais, dados pessoais ou conteúdo confidencial nos objetivos, entradas ou checkpoints.
+- Leia e preserve as alterações existentes no repositório antes de editar.
+- Diferencie alterações locais, commit, push, publicação de release e deploy. Relate somente o que foi efetivamente concluído.