forjajs 5.0.0 → 5.0.1
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 +30 -0
- package/dist/bin/create-memory-nest-kit.js +0 -0
- package/dist/bin/forja.js +0 -0
- package/dist/bin/init-project.js +0 -0
- package/dist/lib/project-upgrade.d.ts +0 -4
- package/dist/lib/project-upgrade.js +19 -1
- package/dist/scripts/project-upgrade.js +9 -6
- package/docs/init-project.md +1 -1
- package/memory/90-decisions/0086-projeto-conectado-e-jornada-como-gate.md +1 -1
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -19,6 +19,36 @@ GitHub reusa esse bloco. O README também é reconciliado na mesma entrega — v
|
|
|
19
19
|
|
|
20
20
|
_(preencher a cada release: diff de produto vs. a versão anterior, antes das seções técnicas)_
|
|
21
21
|
|
|
22
|
+
## [5.0.1] — 2026-10-10 — Correção: o upgrade nunca toca o código do projeto
|
|
23
|
+
|
|
24
|
+
### O que melhorou
|
|
25
|
+
|
|
26
|
+
- **`forja project:upgrade` não mexe mais no código do projeto.** Na 5.0.0, um projeto com pasta
|
|
27
|
+
`backend/` recebia o scaffold do backend NestJS — inclusive quando o backend era de outra stack (um
|
|
28
|
+
backend Python ganharia um app Nest inteiro). Agora o upgrade traz só a camada do Forja (memória,
|
|
29
|
+
agentes, prompts, skills, scripts) e a conexão com a IA; `backend/`, `frontend/`, `apps/`,
|
|
30
|
+
`packages/` e `src/` ficam de fora.
|
|
31
|
+
- **A memória de um projeto existente não ganha conteúdo de exemplo.** Os domínios de exemplo do
|
|
32
|
+
scaffold (`memory/30-domains/auth`, `billing`) não entram mais pelo upgrade; ao lado dos domínios
|
|
33
|
+
reais, a IA os leria como parte do produto. Agente e skill de NestJS só entram em projeto que usa
|
|
34
|
+
NestJS.
|
|
35
|
+
- **`npm run build` mantém o `forja` executável.** Para quem usa o Forja linkado ao checkout
|
|
36
|
+
(`npm link`), o comando e os hooks dos projetos não falham mais com "Permissão negada" depois de
|
|
37
|
+
recompilar.
|
|
38
|
+
|
|
39
|
+
### Corrigido
|
|
40
|
+
|
|
41
|
+
- `scripts/project-upgrade.ts` / `lib/project-upgrade.ts`: referência sempre `--only-memory`; plano
|
|
42
|
+
exclui diretórios de código, domínios de exemplo e peças Nest fora de projeto Nest (#73). Teste de
|
|
43
|
+
regressão em `test/project-adoption.test.js`.
|
|
44
|
+
- `package.json` (`build`): restaura o bit de execução dos `bin` após o `tsc`.
|
|
45
|
+
- `docs/init-project.md` e ADR-0086 alinhados ao novo comportamento do upgrade.
|
|
46
|
+
|
|
47
|
+
### Notas
|
|
48
|
+
|
|
49
|
+
- Achado ao migrar um workspace real com `project:upgrade --all`. Quem usou o `--apply` da 5.0.0
|
|
50
|
+
num projeto com `backend/` que não é o gerado pelo Forja deve revisar o `git status` do backend.
|
|
51
|
+
|
|
22
52
|
## [5.0.0] — 2026-10-09 — Projeto conectado à IA e a jornada do usuário como gate
|
|
23
53
|
|
|
24
54
|
### O que melhorou
|
|
File without changes
|
package/dist/bin/forja.js
CHANGED
|
File without changes
|
package/dist/bin/init-project.js
CHANGED
|
File without changes
|
|
@@ -19,10 +19,6 @@ export interface UpgradePlan {
|
|
|
19
19
|
/** Presentes nos dois — não tocados (podem ter edição do usuário). */
|
|
20
20
|
existing: number;
|
|
21
21
|
}
|
|
22
|
-
/**
|
|
23
|
-
* Planeja o upgrade: o que o scaffold fresco tem que o projeto-alvo não tem. **Só adições** — nunca
|
|
24
|
-
* lista sobrescritas, porque um arquivo existente é território do usuário.
|
|
25
|
-
*/
|
|
26
22
|
export declare function planUpgrade(freshRoot: string, targetRoot: string, env?: UpgradeEnv): UpgradePlan;
|
|
27
23
|
/** Aplica o plano: copia as peças novas para o alvo, criando diretórios. Nunca sobrescreve. */
|
|
28
24
|
export declare function applyUpgrade(freshRoot: string, targetRoot: string, plan: UpgradePlan, env?: UpgradeEnv): string[];
|
|
@@ -47,8 +47,26 @@ export function listFiles(root, env = defaultEnv) {
|
|
|
47
47
|
* Planeja o upgrade: o que o scaffold fresco tem que o projeto-alvo não tem. **Só adições** — nunca
|
|
48
48
|
* lista sobrescritas, porque um arquivo existente é território do usuário.
|
|
49
49
|
*/
|
|
50
|
+
/** Código do usuário: nunca é scaffold a trazer, mesmo que a referência o tenha. */
|
|
51
|
+
const USER_CODE = /^(backend|frontend|apps|packages|src)\//;
|
|
52
|
+
/** Conteúdo de exemplo do scaffold que só faz sentido num projeto que ainda não tem o seu. */
|
|
53
|
+
const SAMPLE_DOMAINS = /^memory\/30-domains\/(?!shared\/)[^/]+\//;
|
|
54
|
+
const NEST_ONLY = /^(agents\/backend-nest\.md|skills\/nest-api\/)/;
|
|
55
|
+
function usesNest(targetRoot, env) {
|
|
56
|
+
return ['package.json', 'backend/package.json'].some((rel) => {
|
|
57
|
+
try {
|
|
58
|
+
return /"@nestjs\/core"/.test(String(env.fs.readFileSync(path.join(targetRoot, rel), 'utf8')));
|
|
59
|
+
}
|
|
60
|
+
catch {
|
|
61
|
+
return false;
|
|
62
|
+
}
|
|
63
|
+
});
|
|
64
|
+
}
|
|
50
65
|
export function planUpgrade(freshRoot, targetRoot, env = defaultEnv) {
|
|
51
|
-
|
|
66
|
+
// Domínios de exemplo (auth, billing…) num projeto que já existe confundem a IA: ela os leria como
|
|
67
|
+
// parte do produto. Idem agente/skill de NestJS num backend que não é Nest.
|
|
68
|
+
const nest = usesNest(targetRoot, env);
|
|
69
|
+
const fresh = listFiles(freshRoot, env).filter((rel) => !USER_CODE.test(rel) && !SAMPLE_DOMAINS.test(rel) && !(!nest && NEST_ONLY.test(rel)));
|
|
52
70
|
const newFiles = [];
|
|
53
71
|
let existing = 0;
|
|
54
72
|
for (const rel of fresh) {
|
|
@@ -20,17 +20,20 @@ import { COMMANDS } from '../lib/core/registry.js';
|
|
|
20
20
|
import { wireProject, checkProjectWiring, detectWiredAi } from '../lib/project-wiring.js';
|
|
21
21
|
import { getProjectsDir, listProjects } from '../lib/workspace.js';
|
|
22
22
|
import { script } from '../lib/paths.js';
|
|
23
|
-
/**
|
|
24
|
-
|
|
23
|
+
/**
|
|
24
|
+
* Scaffold de referência num tmp isolado (ambiente limpo, a lição do release:check). Sempre sem
|
|
25
|
+
* backend: o upgrade traz a camada do Forja (memória, agentes, prompts, skills, scripts) e nunca
|
|
26
|
+
* toca `backend/`, que é código do usuário — e pode nem ser NestJS (um backend Python receberia um
|
|
27
|
+
* app Nest inteiro com o critério antigo "tem pasta backend → traz o scaffold do backend").
|
|
28
|
+
*/
|
|
29
|
+
function freshScaffold(tmp) {
|
|
25
30
|
const fresh = path.join(tmp, 'fresh');
|
|
26
31
|
const env = { ...process.env };
|
|
27
32
|
delete env.NODE_PATH;
|
|
28
33
|
for (const k of Object.keys(env))
|
|
29
34
|
if (k.startsWith('npm_'))
|
|
30
35
|
delete env[k];
|
|
31
|
-
|
|
32
|
-
// inteiro num projeto --skip-backend ou num repositório existente.
|
|
33
|
-
const args = [script('bin/create-memory-nest-kit'), fresh, ...(withBackend ? [] : ['--only-memory']), '--force'];
|
|
36
|
+
const args = [script('bin/create-memory-nest-kit'), fresh, '--only-memory', '--force'];
|
|
34
37
|
try {
|
|
35
38
|
execFileSync(process.execPath, args, { cwd: tmp, env, stdio: 'pipe' });
|
|
36
39
|
}
|
|
@@ -47,7 +50,7 @@ export function upgradeProject(target, apply) {
|
|
|
47
50
|
}
|
|
48
51
|
const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'forja-upgrade-'));
|
|
49
52
|
try {
|
|
50
|
-
const fresh = freshScaffold(tmp
|
|
53
|
+
const fresh = freshScaffold(tmp);
|
|
51
54
|
const plan = planUpgrade(fresh, target);
|
|
52
55
|
const ai = detectWiredAi(target);
|
|
53
56
|
const wiringGaps = checkProjectWiring(target, { commands: COMMANDS, ai: ai.length ? ai : undefined })
|
package/docs/init-project.md
CHANGED
|
@@ -77,7 +77,7 @@ qual remover a marca `<!-- forja:managed -->` não é mais tocado. Hooks e servi
|
|
|
77
77
|
```bash
|
|
78
78
|
cd meu-projeto
|
|
79
79
|
forja project:upgrade # dry-run: peças de scaffold novas + conexão a refazer
|
|
80
|
-
forja project:upgrade --apply # aplica (aditivo;
|
|
80
|
+
forja project:upgrade --apply # aplica (aditivo; nunca toca backend/, frontend/, apps/ nem src/)
|
|
81
81
|
forja project:wire --check
|
|
82
82
|
```
|
|
83
83
|
|
|
@@ -60,7 +60,7 @@ aponta para um arquivo real.
|
|
|
60
60
|
|
|
61
61
|
**3. Superfícies.** `project:new` usa o wire e falha alto (exit 1 e resumo de pendências) quando algo
|
|
62
62
|
essencial não sai. `project:wire` conecta e verifica. `project:upgrade` religa projetos pré-v5 e só
|
|
63
|
-
traz backend para quem já tem um. `tools:doctor` mostra a conexão quando roda num projeto.
|
|
63
|
+
traz backend para quem já tem um (revisto na 5.0.1: o upgrade nunca toca `backend/`, `frontend/`, `apps/`, `packages/` nem `src/`, nem traz domínios de exemplo — ver #73). `tools:doctor` mostra a conexão quando roda num projeto.
|
|
64
64
|
`hook:session-start` e `hook:user-prompt` entram no registry. Handoffs passam a ser carimbados com o
|
|
65
65
|
projeto de origem, e o briefing e o `next` filtram por ele.
|
|
66
66
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "forjajs",
|
|
3
|
-
"version": "5.0.
|
|
3
|
+
"version": "5.0.1",
|
|
4
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",
|
|
@@ -88,7 +88,7 @@
|
|
|
88
88
|
"dashboard:dev": "npm --prefix apps/dashboard run dev -- -p 3001",
|
|
89
89
|
"dashboard:build": "npm --prefix apps/dashboard run build",
|
|
90
90
|
"dashboard:start": "npm --prefix apps/dashboard run start",
|
|
91
|
-
"build": "tsc -p tsconfig.build.json",
|
|
91
|
+
"build": "tsc -p tsconfig.build.json && node -e \"for (const f of Object.values(require('./package.json').bin)) require('fs').chmodSync(f, 0o755)\"",
|
|
92
92
|
"types:check": "tsc --noEmit",
|
|
93
93
|
"test": "node --test test/*.test.js",
|
|
94
94
|
"demo:autonomy": "node bin/forja.ts demo:autonomy",
|