@orkastery/cli 0.2.0 → 0.4.1

package/monitor/varredura-pulse.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# Varredura de cinco minutos. O núcleo consulta, deduplica e entrega sem LLM.
+# Configure .orkastery/monitor/pulse-host.json com executável e argumentos do host.
+set -euo pipefail
+export PATH="${ORK_PULSE_RUNTIME_BIN:-$HOME/.local/bin}:$PATH"
+ORK_PULSE_RAIZ="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
+if [ -f "$ORK_PULSE_RAIZ/core/dist/pulse-delivery.js" ]; then
+  ORK_PULSE_ALVO="${ORK_PULSE_PROJECT:-$ORK_PULSE_RAIZ}"
+else
+  ORK_PULSE_ALVO="${ORK_PULSE_PROJECT:-$PWD}"
+fi
+# Candidatos do projeto alvo. Versao legada ou rebuild sozinhos nunca autorizam escrita.
+# O recibo de ork activation, validado pelo runtime atual, concede o escopo efetivo.
+ORK_PULSE_ESCOPO_ARQUIVO="$ORK_PULSE_ALVO/monitor/pulse-write-scope.json"
+if [ -e "$ORK_PULSE_ESCOPO_ARQUIVO" ] || [ -L "$ORK_PULSE_ESCOPO_ARQUIVO" ]; then
+  ORK_PULSE_ESCOPO_CONFIGURADO="$(node "$ORK_PULSE_RAIZ/monitor/pulse-scope.cjs" "$ORK_PULSE_ESCOPO_ARQUIVO")"
+  if [ -n "${ORK_PULSE_WRITE_SCOPE+x}" ] && [ "$ORK_PULSE_WRITE_SCOPE" != "$ORK_PULSE_ESCOPO_CONFIGURADO" ]; then
+    echo 'pulse.scope.conflict: ambiente diverge da allowlist duravel' >&2
+    exit 1
+  fi
+  export ORK_PULSE_WRITE_SCOPE="$ORK_PULSE_ESCOPO_CONFIGURADO"
+fi
+if [ -f "$ORK_PULSE_RAIZ/core/dist/pulse-delivery.js" ]; then
+  exec node "$ORK_PULSE_RAIZ/core/dist/pulse-delivery.js" "$ORK_PULSE_ALVO"
+fi
+# No pacote npm, dist/ fica ao lado de monitor/. O projeto é o cwd do chamador.
+exec node "$ORK_PULSE_RAIZ/dist/pulse-delivery.js" "$ORK_PULSE_ALVO"

package/package.json

@@ -1,22 +1,26 @@
 {
   "name": "@orkastery/cli",
-  "version": "0.2.0",
-  "description": "Nucleo CLI deterministico do Orkastery: conduz N looping threads em fases GOAL..MASTER, sem LLM embutido",
+  "version": "0.4.1",
+  "description": "A software factory of AI agents that proves its work: parallel threads, verified results, and short decisions only when they matter.",
   "license": "MIT",
-  "homepage": "https://github.com/Orkastery/orkastery#readme",
+  "homepage": "https://github.com/orkastery/orkastery#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Orkastery/orkastery.git",
+    "url": "git+https://github.com/orkastery/orkastery.git",
     "directory": "core"
   },
   "bugs": {
-    "url": "https://github.com/Orkastery/orkastery/issues"
+    "url": "https://github.com/orkastery/orkastery/issues"
   },
   "keywords": [
     "orkastery",
     "ork",
+    "claude-code",
+    "codex",
+    "ai-agents",
+    "agentic-coding",
     "orquestracao",
-    "agentes",
+    "verification",
     "looping-threads",
     "cli",
     "ledger",
@@ -28,10 +32,19 @@
   "main": "dist/index.js",
   "files": [
     "dist/",
+    "!dist/.tsbuildinfo",
+    "assets/",
+    "schemas/",
     "skills/",
     "references/",
     "eval/",
     "adapters/",
+    "!adapters/**/test/",
+    "!adapters/**/__pycache__/",
+    "!adapters/claude-code/ACTIVATION.md",
+    "monitor/",
+    "!monitor/*.test.cjs",
+    "!monitor/pulse-write-scope.json",
     "README.md",
     "LICENSE"
   ],
@@ -41,7 +54,8 @@
   "scripts": {
     "build": "tsc -p tsconfig.json && chmod +x dist/index.js",
     "build:test": "tsc -p tsconfig.test.json",
-    "test": "npm run build && npm run build:test && node --test \"dist-test/test/**/*.test.js\"",
+    "test": "npm run build && npm run build:test && node --test dist-test/test/*.test.js",
+    "test:ci": "npm run build && npm run build:test && node scripts/test-ci.js",
     "ork": "node dist/index.js",
     "prepack": "npm run build && node scripts/preparar-pacote.js",
     "postpack": "node scripts/preparar-pacote.js --limpar"
@@ -51,6 +65,13 @@
   },
   "devDependencies": {
     "@types/node": "^22.10.2",
+    "markdownlint-cli2": "^0.23.3",
     "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "smol-toml": "1.8.0",
+    "zod": "3.25.76",
+    "zod-to-json-schema": "3.25.2"
   }
 }

package/references/definition-of-done.md

@@ -39,7 +39,7 @@ flowchart LR
 | 8 | Os cinco eixos de review (correcao, seguranca, performance, manutenibilidade, estilo) trazem achados ou um "nenhum" explicito, cada um categorizado bloqueador, aviso ou sugestao. | A tabela dos cinco eixos do relatorio de CHECK, conforme [code-review-axes.md](code-review-axes.md). |
 | 9 | A auditoria de seguranca reporta zero bloqueadores, e a auditoria de performance web ou rodou ou declara por que o alvo nao tem superficie web. | As secoes de auditoria do relatorio, conforme [security-checklist.md](security-checklist.md) e [performance-checklist.md](performance-checklist.md). |
 | 10 | Correcoes classificadas com honestidade: tipo A e uma linha ou equivalente, registrada, com as verificacoes afetadas reexecutadas; tipo B devolveu a tarefa ao GO, e esta rodada de CHECK e a reexecucao completa. | `ork fix open <thread>` deriva uma correcao por motivo tipado, com a spec exata e o comando que a julga; `ork fix reverify <thread>` da o veredito POR correcao e RECUSA reexecucao parcial quando ha tipo B. Os eventos `go_fix_opened` e `check_reverify` do ledger contra as contagens do relatorio. Estas contagens medem a qualidade do PLAN e do GO, nao a do reviewer. |
-| 11 | O relatorio esta no diretorio da thread com exatamente um veredito (PASSOU, PRECISA DE MUDANCA, BLOQUEADO), todo aviso aceito tem seu registro, e o gate foi resolvido pelo caminho certo. | `ork gate approve <thread> evidencias --por <quem>` para decisao humana, ou o evento de decisao autonoma do modo, que so um veredito PASSOU pode tomar. Falha de verify, falha anti-alucinacao, qualquer CHECK com correcao tipo B, desvio de envelope, veredito diferente de PASSOU e emergencia sobem sempre para o humano, em qualquer modo. |
+| 11 | O relatorio esta no diretorio da thread com exatamente um veredito (PASSOU, PRECISA DE MUDANCA, BLOQUEADO), todo aviso aceito tem seu registro, e o gate foi resolvido pelo caminho certo. | A resposta humana ao `ork gate request <thread>`, pelo canal autenticado, para decisao humana, ou o evento de decisao autonoma do modo, que so um veredito PASSOU pode tomar. Falha de verify, falha anti-alucinacao, qualquer CHECK com correcao tipo B, desvio de envelope, veredito diferente de PASSOU e emergencia sobem sempre para o humano, em qualquer modo. |
 
 ## Todo merge, antes de o SHIP fechar
 
@@ -48,7 +48,7 @@ flowchart LR
 | 12 | Guarda de contrato: nada no diff final muda contrato publico versionado (schema de telemetria, contrato de interface, layout de estado, tipos de evento) sem decisao de classe 2 ratificada. | `git diff <base>...HEAD` sobre esses arquivos e o id do gate que ratificou, no ledger. Sem ratificacao nao ha merge. |
 | 13 | O merge passou pela fila serializada, atualizado contra a base mais recente, revalidado por inteiro sempre que a atualizacao trouxe mudanca, com a guarda de `DoD 12` reexecutada contra o diff final. | `ork ship <thread> --para <base>` toma o lease `main-tree`; a atualizacao pode trazer mudanca que toca contrato, entao um veredito calculado antes dela descreve um diff que nao existe mais. |
 | 14 | O push foi provado por comando, nao relatado. | O `ork ship` compara o sha local com `git ls-remote` no remoto e grava `pushVerificado` no ledger. Push relatado sem sha do remoto conta como push nao acontecido. |
-| 15 | Passo irreversivel so acontece com autorizacao do modo: push, merge e delecao exigem a pausa que a #TAG previu ou uma autorizacao antecipada registrada. | `ork gate approve <thread> push --por <quem>`, visivel em `ork phase list <thread>`. |
+| 15 | Passo irreversivel so acontece com autorizacao do modo: push, merge e delecao exigem a pausa que a #TAG previu ou uma autorizacao antecipada registrada. | `ork ship <thread> --para <base> --autorizar-push <quem>`, ou a resposta humana a pausa do modo, visivel em `ork phase list <thread>`. |
 
 ## Todo fechamento, antes de a thread morrer
 

package/schemas/claims.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schemaVersion": { "type": "integer", "const": 1 },
+    "claims": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 256,
+      "items": {
+        "type": "object",
+        "properties": {
+          "tarefa": { "type": "string", "minLength": 1, "maxLength": 128 },
+          "arquivo": { "type": "string", "minLength": 1, "maxLength": 4096 },
+          "alegacao": { "type": "string", "minLength": 1, "maxLength": 8192 },
+          "verifyId": { "type": "string", "minLength": 1, "maxLength": 128 }
+        },
+        "required": ["tarefa", "arquivo", "alegacao", "verifyId"],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": ["schemaVersion", "claims"],
+  "additionalProperties": false
+}