forjajs 2.0.1 → 2.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +15 -0
- package/README.md +22 -0
- package/README.pt-BR.md +22 -0
- package/dist/apps/cli/src/index.d.ts +44 -0
- package/dist/apps/cli/src/index.js +304 -0
- package/dist/apps/server/src/main.d.ts +9 -3
- package/dist/apps/server/src/main.js +70 -19
- package/dist/bin/forja.js +213 -0
- package/dist/lib/core/health.js +2 -1
- package/dist/lib/core/registry.d.ts +17 -0
- package/dist/lib/core/registry.js +17 -0
- package/dist/lib/core/release.d.ts +16 -0
- package/dist/packages/adapter-git/src/index.d.ts +14 -0
- package/dist/packages/adapter-git/src/index.js +66 -0
- package/dist/packages/adapter-sqlite/src/index.d.ts +59 -2
- package/dist/packages/adapter-sqlite/src/index.js +136 -0
- package/dist/packages/context/src/index.d.ts +8 -0
- package/dist/packages/context/src/index.js +7 -0
- package/dist/packages/contracts/src/index.d.ts +1 -1
- package/dist/packages/events/src/index.d.ts +2 -0
- package/dist/packages/events/src/index.js +16 -0
- package/dist/packages/graph/src/index.d.ts +59 -3
- package/dist/packages/graph/src/index.js +139 -21
- package/dist/packages/mcp/src/index.d.ts +14 -0
- package/dist/packages/mcp/src/index.js +39 -5
- package/dist/packages/plugin-docker/src/index.d.ts +3 -0
- package/dist/packages/plugin-docker/src/index.js +13 -0
- package/dist/packages/plugin-github/src/index.d.ts +3 -0
- package/dist/packages/plugin-github/src/index.js +13 -0
- package/dist/packages/policy/src/index.d.ts +7 -0
- package/dist/packages/policy/src/index.js +17 -1
- package/dist/packages/runtime/src/index.d.ts +20 -1
- package/dist/packages/runtime/src/index.js +34 -1
- package/dist/packages/sandbox/src/index.d.ts +2 -0
- package/dist/packages/sandbox/src/index.js +10 -0
- package/dist/scripts/context-benchmark.d.ts +2 -0
- package/dist/scripts/context-benchmark.js +39 -0
- package/dist/scripts/demo-autonomy.d.ts +15 -0
- package/dist/scripts/demo-autonomy.js +200 -0
- package/dist/scripts/server-persistence-probe.d.mts +1 -0
- package/dist/scripts/server-persistence-probe.d.ts +1 -0
- package/dist/scripts/server-persistence-probe.js +52 -0
- package/dist/scripts/server-persistence-probe.mjs +52 -0
- package/docs/2x/CLI-CAPABILITIES.md +35 -0
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -0
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -0
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -0
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -0
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -0
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -0
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -0
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -0
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -0
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -0
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -0
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -0
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -0
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -0
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -0
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -0
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -0
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -0
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -0
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -0
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -0
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
- package/package.json +13 -3
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# ADR-0061 — MCP dinâmico sobre o Registry e transporte stdio local
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o adapter MCP possuía ferramentas fixas e executava capabilities quando o
|
|
6
|
+
consumidor fornecia um registry, mas não expunha `describe` nem descoberta dinâmica dos aliases.
|
|
7
|
+
- **Decisão**: manter ferramentas operacionais fixas para recursos do Forja e adicionar uma
|
|
8
|
+
ferramenta derivada para cada capability visível (`forja_capability_<id>`), além de
|
|
9
|
+
`forja_capability_describe`. `forja mcp:start` fornece transporte JSON-RPC local por stdio e
|
|
10
|
+
delega todas as chamadas ao `McpServer`.
|
|
11
|
+
- **Consequências**: clientes podem descobrir o catálogo sem documentação humana e executar pelo
|
|
12
|
+
mesmo registry usado pela CLI. O transporte não conhece handlers nem implementa regras de
|
|
13
|
+
autorização; schemas detalhados permanecem nos validadores do registry.
|
|
14
|
+
- **Alternativas rejeitadas**: lista manual de cada capability; handler MCP duplicado; servidor
|
|
15
|
+
remoto obrigatório nesta etapa.
|
|
16
|
+
- **Evidência**: `packages/mcp/src/index.ts`, `bin/forja.ts`, `test/mcp.test.js` e o smoke stdio.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# ADR-0062 — Catálogo oficial compartilhado e persistência de approvals/auditoria
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o server criava `CapabilityRegistry` vazio e approvals/auditoria MCP ficavam em
|
|
6
|
+
memória ou sem sink persistente.
|
|
7
|
+
- **Decisão**: o server constrói o catálogo usando `registerCliCapabilities` e o runner legado
|
|
8
|
+
compartilhado. `ApprovalLedger` recebe a porta `ApprovalStore`, implementada pelo SQLite. MCP
|
|
9
|
+
recebe `McpAuditSink`, adaptado para `SqliteAuditStore`; falha de auditoria não interrompe a
|
|
10
|
+
operação, mas é responsabilidade do sink expor saúde própria.
|
|
11
|
+
- **Consequências**: CLI e server descobrem os mesmos IDs e compartilham handlers; approvals
|
|
12
|
+
sobrevivem a reinício; chamadas MCP deixam trilha persistente. O catálogo ainda é composto em
|
|
13
|
+
memória no boot, enquanto persistência de definições fica adiada.
|
|
14
|
+
- **Alternativas rejeitadas**: catálogo manual separado no server; ledger de approvals duplicado;
|
|
15
|
+
auditoria somente em memória.
|
|
16
|
+
- **Evidência**: `apps/server/src/main.ts`, `packages/policy/src/index.ts`,
|
|
17
|
+
`packages/adapter-sqlite/src/index.ts` e testes Sprint 5.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# ADR-0063 — Event Bus SQLite e prova E2E determinística
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o Event Bus tinha append, retries e idempotência apenas em memória;
|
|
6
|
+
o server publicava eventos somente no stream SSE e não havia uma prova integrada
|
|
7
|
+
do ciclo supervisionado.
|
|
8
|
+
- **Decisão**: o `EventBus` hidrata idempotência e sequências a partir de qualquer
|
|
9
|
+
`EventStore` antes do primeiro append/list. O bootstrap NestJS usa
|
|
10
|
+
`SqliteEventStore` no banco local e encaminha publicações do Control Plane para
|
|
11
|
+
SSE e persistência. A prova operacional usa capability, sandbox e validator
|
|
12
|
+
determinísticos, sem LLM.
|
|
13
|
+
- **Consequências**: eventos de domínio sobrevivem ao reinício e não duplicam por
|
|
14
|
+
idempotency key; a entrega SSE continua local e efêmera; subscriptions e dead
|
|
15
|
+
letters ainda não são duráveis entre processos.
|
|
16
|
+
- **Alternativas rejeitadas**: broker externo nesta fase; catálogo paralelo de
|
|
17
|
+
eventos; prova baseada em chamada real de modelo.
|
|
18
|
+
- **Evidência**: `packages/events/src/index.ts`, `apps/server/src/main.ts`,
|
|
19
|
+
`test/events-scheduler.test.js` e `test/autonomy-e2e.test.js`.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# ADR-0064 — GraphLoop com porta de store e SQLite oficial
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o GraphLoop validava evidências, relações e checksums, mas o
|
|
6
|
+
store padrão era composto apenas por `Map`, fazendo nós e arestas desaparecerem
|
|
7
|
+
após reinício.
|
|
8
|
+
- **Decisão**: o domínio define `GraphStore` síncrono. `InMemoryGraphStore`
|
|
9
|
+
permanece para testes e `SqliteGraphStore` implementa a distribuição oficial.
|
|
10
|
+
A migração v4 cria tabelas dedicadas para nós, arestas, evidências, fontes e
|
|
11
|
+
futuras claims/contradições/agenda/extractions. O server compartilha a mesma
|
|
12
|
+
instância persistente entre MCP e Runtime.
|
|
13
|
+
- **Consequências**: consultas e sincronização incremental sobrevivem a reinício;
|
|
14
|
+
a política de “toda aresta tem endpoints e evidência” continua no core. O
|
|
15
|
+
schema das entidades futuras existe, mas seus engines ainda não persistem
|
|
16
|
+
automaticamente.
|
|
17
|
+
- **Alternativas rejeitadas**: importar SQLite no domínio; substituir a API por
|
|
18
|
+
operações assíncronas nesta fase; manter o server em memória.
|
|
19
|
+
- **Evidência**: `packages/graph/src/index.ts`, `packages/adapter-sqlite/src/index.ts`,
|
|
20
|
+
`apps/server/src/main.ts` e testes da Sprint 7.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# ADR-0065 — GraphLoop como fonte determinística do Context Engine
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o Context Engine tinha uma porta genérica de fontes, mas o
|
|
6
|
+
server não a compunha com o GraphLoop persistente; o cache padrão era apenas
|
|
7
|
+
em memória.
|
|
8
|
+
- **Decisão**: `GraphContextSource` adapta uma porta `searchContext` e o
|
|
9
|
+
GraphLoop retorna relações ativas que tenham evidência e coincidam
|
|
10
|
+
deterministicamente com termos do objetivo. `SqliteContextCache` persiste o
|
|
11
|
+
conteúdo por checksum. O bootstrap compartilha o banco entre GraphLoop,
|
|
12
|
+
Context Engine, MCP e Runtime.
|
|
13
|
+
- **Consequências**: contexto mínimo pode ser recuperado offline, com referências
|
|
14
|
+
auditáveis, cache e orçamento. A busca é lexical e compacta; embeddings,
|
|
15
|
+
trechos de arquivos e sumarização ficam para fases posteriores.
|
|
16
|
+
- **Alternativas rejeitadas**: chamar LLM para busca; importar SQLite no pacote
|
|
17
|
+
context; duplicar uma busca de grafo dentro do MCP.
|
|
18
|
+
- **Evidência**: `packages/context/src/index.ts`, `packages/graph/src/index.ts`,
|
|
19
|
+
`packages/adapter-sqlite/src/index.ts`, `apps/server/src/main.ts` e testes da
|
|
20
|
+
Sprint 8.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# ADR-0066 — Extração determinística incremental do GraphLoop
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o extractor inicial cobria somente imports e links Markdown,
|
|
6
|
+
deixando specs, ADRs, tarefas, handoffs, testes e manifests fora do grafo.
|
|
7
|
+
- **Decisão**: ampliar o extractor por padrões explícitos e auditáveis: símbolos,
|
|
8
|
+
chamadas, referências ADR, checkboxes, agentes de handoff, testes e dependências
|
|
9
|
+
de manifest. Cada relação usa uma evidência com locator de linha e é aplicada
|
|
10
|
+
pela mesma mutation com checksum.
|
|
11
|
+
- **Consequências**: consultas de impacto e contexto ganham relações offline sem
|
|
12
|
+
custo de LLM. A resolução semântica completa de TypeScript, aliases, commits e
|
|
13
|
+
diffs permanece fora do extractor lexical.
|
|
14
|
+
- **Alternativas rejeitadas**: inferência por LLM para relações determinísticas;
|
|
15
|
+
parser completo obrigatório nesta etapa; aceitar arestas sem evidência.
|
|
16
|
+
- **Evidência**: `packages/graph/src/index.ts` e `test/graph.test.js`.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# ADR-0067 — Indexação GraphLoop por fonte Git e capability `graph.sync`
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: extractors determinísticos existiam, mas não havia uma operação
|
|
6
|
+
incremental que lesse o workspace e aplicasse mutations ao GraphLoop.
|
|
7
|
+
- **Decisão**: `GraphIndexer` recebe uma porta `GraphDocumentSource`; o adapter
|
|
8
|
+
`GitGraphDocumentSource` usa `git ls-files` e leitura local limitada; a
|
|
9
|
+
capability `graph.sync` executa o indexador, retorna contagens estruturadas e
|
|
10
|
+
gera evidência. O server compõe essa capability sobre `SqliteGraphStore`.
|
|
11
|
+
- **Consequências**: indexação local é reproduzível, incremental e sem LLM;
|
|
12
|
+
arquivos ignorados ficam fora. Remoções, commits e diffs exigem uma próxima
|
|
13
|
+
evolução para não introduzir poda ou histórico incorreto nesta fase.
|
|
14
|
+
- **Alternativas rejeitadas**: varrer recursivamente sem respeitar `.gitignore`;
|
|
15
|
+
indexar conteúdo binário; criar um segundo registry específico para o grafo.
|
|
16
|
+
- **Evidência**: `packages/graph/src/index.ts`, `packages/adapter-git/src/index.ts`,
|
|
17
|
+
`apps/cli/src/index.ts`, `apps/server/src/main.ts` e testes Sprint 10.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# ADR-0068 — Graph sync compartilhado entre CLI e MCP
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: `graph.sync` estava registrável no server, mas o dispatch
|
|
6
|
+
standalone e o MCP stdio ainda criavam somente o catálogo legado.
|
|
7
|
+
- **Decisão**: `graph:sync` declara `capability: graph.sync` no registry do core;
|
|
8
|
+
o adaptador CLI recebe uma composição opcional GraphLoop + Git source e registra
|
|
9
|
+
o mesmo handler. O MCP stdio usa essa composição e descobre a ferramenta
|
|
10
|
+
dinâmica automaticamente. O resultado inclui contagens, arquivos e duração.
|
|
11
|
+
- **Consequências**: CLI, MCP e server compartilham execução e policy; a CLI
|
|
12
|
+
mantém um resumo humano e o envelope JSON. O banco local é aberto pela
|
|
13
|
+
composição do processo e usa as migrações existentes.
|
|
14
|
+
- **Alternativas rejeitadas**: duplicar um handler em `bin/forja`; manter lista
|
|
15
|
+
manual de ferramenta MCP; indexar sem `.gitignore`.
|
|
16
|
+
- **Evidência**: `lib/core/registry.ts`, `apps/cli/src/index.ts`, `bin/forja.ts`,
|
|
17
|
+
`packages/graph/src/index.ts` e testes Sprint 11.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# ADR-0069 — Demonstração de autonomia com sandbox Git real
|
|
2
|
+
|
|
3
|
+
- **Status:** aceito
|
|
4
|
+
- **Data:** 2026-08-01
|
|
5
|
+
- **Decisão:** o caminho demonstrável de autonomia deve usar uma fixture externa, Git
|
|
6
|
+
worktree real, comandos reais, aprovação persistida, Validator independente e
|
|
7
|
+
promoção explícita. O agente da fixture pode ser determinístico para manter a prova
|
|
8
|
+
offline e repetível.
|
|
9
|
+
- **Motivo:** os testes anteriores validavam o contrato do sandbox, mas usavam store e
|
|
10
|
+
backend simulados; isso não comprovava isolamento, subprocesso, diff ou promoção.
|
|
11
|
+
- **Consequências:** `npm run demo:autonomy` é uma prova operacional e não depende de
|
|
12
|
+
LLM. O cenário usa um teste Node nativo para evitar instalação de dependências na
|
|
13
|
+
fixture e deixa SQLite, Git e npm observáveis.
|
|
14
|
+
- **Evidências:** `scripts/demo-autonomy.ts` e `test/demo-autonomy.test.js`.
|
|
15
|
+
- **Próximos passos:** repetir a mesma composição no MCP stdio e no bootstrap oficial
|
|
16
|
+
do servidor; adicionar rollback e cenários de caos.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# ADR-0070 — MCP stdio como transporte testado por processo real
|
|
2
|
+
|
|
3
|
+
- **Status:** aceito
|
|
4
|
+
- **Decisão:** o transporte MCP local usa JSON-RPC delimitado por newline em
|
|
5
|
+
stdin/stdout; logs operacionais não podem ocupar stdout. Notificações sem `id`
|
|
6
|
+
não recebem resposta. EOF é o shutdown normal.
|
|
7
|
+
- **Motivo:** testes unitários do adapter não provavam compatibilidade do processo
|
|
8
|
+
lançado pelo usuário nem isolamento do canal de protocolo.
|
|
9
|
+
- **Consequências:** o teste inicia o binário real, envia mensagens em sequência e
|
|
10
|
+
rejeita stdout não parseável; diagnósticos devem usar stderr.
|
|
11
|
+
- **Evidência:** `test/mcp-stdio.test.js`.
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# ADR-0071 — Bootstrap Nest com persistência SQLite completa
|
|
2
|
+
|
|
3
|
+
- **Status:** aceito
|
|
4
|
+
- **Decisão:** o bootstrap oficial injeta `SqliteRuntimePersistence`,
|
|
5
|
+
`SqliteGraphStore`, `SqliteApprovalStore`, `SqliteEventStore`,
|
|
6
|
+
`SqliteContextCache`, `SqliteOrchestrationStore` e `SqliteObservationStore`.
|
|
7
|
+
Stores em memória ficam restritos a defaults de testes e composição isolada.
|
|
8
|
+
- **Motivo:** a composição anterior persistia runtime, approvals, eventos, grafo e
|
|
9
|
+
contexto, mas criava orquestração e observabilidade em memória.
|
|
10
|
+
- **Consequências:** Sprint/Task/Handoff e métricas sobrevivem ao restart; shutdown
|
|
11
|
+
deve drenar publicações assíncronas do Event Bus antes de fechar SQLite.
|
|
12
|
+
- **Evidência:** `apps/server/src/main.ts` e `test/server-persistence.test.js`.
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# ADR-0072 — Limites de ambiente e caminho no adapter Git
|
|
2
|
+
|
|
3
|
+
- **Status:** aceito
|
|
4
|
+
- **Decisão:** `SpawnCommandRunner` herda apenas variáveis operacionais mínimas
|
|
5
|
+
(`PATH`, temporários e `NODE_PATH`) e permite overrides explícitos. O
|
|
6
|
+
`GitGraphDocumentSource` rejeita locators que escapem da raiz resolvida.
|
|
7
|
+
- **Motivo:** comandos de sandbox não devem copiar secrets do processo e fontes
|
|
8
|
+
Git não devem transformar um locator malicioso em leitura fora do workspace.
|
|
9
|
+
- **Evidência:** testes de segurança em `test/adapter-git.test.js`.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# ADR-0073 — Última milha: rollback, benchmark e plugins permissionados
|
|
2
|
+
|
|
3
|
+
## Status
|
|
4
|
+
|
|
5
|
+
Accepted
|
|
6
|
+
|
|
7
|
+
## Contexto
|
|
8
|
+
|
|
9
|
+
O ForjaJS já comprovava promoção de uma alteração em Git worktree, contexto com cache e isolamento de plugins, mas não possuía uma operação de rollback formal, um artefato de benchmark estável nem plugins oficiais registráveis.
|
|
10
|
+
|
|
11
|
+
## Decisão
|
|
12
|
+
|
|
13
|
+
Adicionar `rollback` ao contrato `SandboxBackend` e ao `SandboxEngine`, com estado terminal `rolled_back`. O backend Git reverte o patch binário na raiz do repositório através do mesmo `PatchApplier` usado na promoção. O benchmark de contexto emite JSON determinístico com checksum e estimativa documentada de tokens. GitHub e Docker são manifests oficiais mínimos; handlers de rede/daemon são injetados pelo host e nunca implícitos.
|
|
14
|
+
|
|
15
|
+
## Consequências
|
|
16
|
+
|
|
17
|
+
Rollback permanece explícito e auditável. A medição pode ser reproduzida em CI, mas tokens continuam uma estimativa bytes/4. Os plugins são extensíveis e permissionados, porém não afirmam uma integração externa até que um adapter real seja fornecido.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "forjajs",
|
|
3
|
-
"version": "2.0.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "2.0.3",
|
|
4
|
+
"description": "ForjaJS é uma plataforma local-first para memória, contexto, governança e execução supervisionada de agentes de desenvolvimento",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "index.js",
|
|
7
7
|
"bin": {
|
|
@@ -89,10 +89,20 @@
|
|
|
89
89
|
"dashboard:start": "npm --prefix apps/dashboard run start",
|
|
90
90
|
"build": "tsc -p tsconfig.build.json",
|
|
91
91
|
"types:check": "tsc --noEmit",
|
|
92
|
-
"test": "node --test test/*.test.js"
|
|
92
|
+
"test": "node --test test/*.test.js",
|
|
93
|
+
"demo:autonomy": "node scripts/demo-autonomy.ts",
|
|
94
|
+
"benchmark:context": "node scripts/context-benchmark.ts"
|
|
93
95
|
},
|
|
94
96
|
"keywords": [
|
|
95
97
|
"agents",
|
|
98
|
+
"agentic",
|
|
99
|
+
"agent-runtime",
|
|
100
|
+
"mcp",
|
|
101
|
+
"graph-memory",
|
|
102
|
+
"context-engineering",
|
|
103
|
+
"local-first",
|
|
104
|
+
"developer-tools",
|
|
105
|
+
"autonomous-agents",
|
|
96
106
|
"orchestration",
|
|
97
107
|
"memory",
|
|
98
108
|
"sqlite",
|