forjajs 2.0.1 → 2.0.2
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/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 +7 -2
- package/dist/apps/server/src/main.js +65 -16
- package/dist/bin/forja.js +208 -0
- package/dist/lib/core/health.js +2 -1
- package/dist/lib/core/registry.d.ts +7 -0
- package/dist/lib/core/registry.js +7 -0
- package/dist/lib/core/release.d.ts +6 -0
- package/dist/packages/adapter-git/src/index.d.ts +12 -0
- package/dist/packages/adapter-git/src/index.js +45 -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/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/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/docs/2x/CLI-CAPABILITIES.md +35 -0
- package/docs/2x/IMPLEMENTATION-AUDIT.md +132 -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-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-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/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/package.json +1 -1
|
@@ -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.
|