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 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
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
- const fresh = listFiles(freshRoot, env);
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
- /** Scaffold de referência num tmp isolado (ambiente limpo, a lição do release:check). */
24
- function freshScaffold(tmp, withBackend) {
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
- // Sem backend quando o projeto não tem um: "aditivo" não pode significar instalar um NestJS
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, fs.existsSync(path.join(target, 'backend')));
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 })
@@ -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; só traz backend se o projeto já tem um)
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.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",