forjajs 2.0.3 → 2.0.4
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/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -339
- package/README.pt-BR.md +345 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +14 -2
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +54 -0
- package/dist/lib/core/registry.js +55 -0
- package/dist/lib/core/release.d.ts +53 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.js +2 -2
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -150
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
- package/dist/scripts/server-persistence-probe.d.ts +0 -1
- package/dist/scripts/server-persistence-probe.js +0 -52
- package/dist/scripts/server-persistence-probe.mjs +0 -52
- /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,558 +1,574 @@
|
|
|
1
|
-
# Changelog
|
|
2
|
-
|
|
3
|
-
Histórico consolidado das mudanças estruturais do framework. Para decisões arquiteturais com rationale, ver `memory/90-decisions/`.
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## [2.0.2] — 2026-08-01 — Integração operacional das Sprints 1–11
|
|
8
|
-
|
|
9
|
-
Consolida a evolução do ForjaJS 2.x após a fundação 2.0.1, conectando a CLI,
|
|
10
|
-
Capability Registry, Runtime, MCP, SQLite, GraphLoop e Context Engine em um
|
|
11
|
-
fluxo persistente, auditável e testado.
|
|
12
|
-
|
|
13
|
-
### Adicionado
|
|
14
|
-
- Adapter da CLI sobre o Capability Registry com `ExecutionResult` estruturado.
|
|
15
|
-
- Persistência SQLite para runtime, aprovações, eventos e GraphLoop.
|
|
16
|
-
- MCP dinâmico derivado das capabilities registradas.
|
|
17
|
-
- Context Engine integrado ao GraphLoop, com cache por checksum e orçamento.
|
|
18
|
-
- Extractors determinísticos e capability `graph.sync` para CLI/MCP.
|
|
19
|
-
- Testes de recuperação, autonomia E2E, contratos e integração.
|
|
20
|
-
- ADRs, auditoria de implementação e handoffs das Sprints 1–11.
|
|
21
|
-
|
|
22
|
-
## [2.0.1] — 2026-08-01 — Higiene de dependências do pacote
|
|
23
|
-
|
|
24
|
-
Move as dependências de NestJS e dashboard para os manifests das aplicações e
|
|
25
|
-
para `devDependencies` do repositório. O tarball do framework agora carrega
|
|
26
|
-
somente `better-sqlite3` como dependência de runtime, eliminando peso morto sem
|
|
27
|
-
alterar os ambientes oficiais de server e dashboard.
|
|
28
|
-
|
|
29
|
-
## [2.0.0] — 2026-08-01 — Fundação programável local-first
|
|
30
|
-
|
|
31
|
-
Primeira release da plataforma ForjaJS 2.0. A versão mantém a
|
|
32
|
-
CLI-first e adiciona um núcleo programável por agentes, com contratos
|
|
33
|
-
versionados, capabilities, runtime controlado, políticas, memória, GraphLoop,
|
|
34
|
-
contexto orçamentado, MCP, SDK, adapters oficiais, observabilidade e dashboard.
|
|
35
|
-
|
|
36
|
-
### Adicionado
|
|
37
|
-
- Monorepo modular com `apps/server`, `apps/dashboard`, `apps/worker` e pacotes
|
|
38
|
-
de domínio/adaptação independentes de framework.
|
|
39
|
-
- Contracts, Capability Registry, Policy Engine, Runtime, Sprint/Task/Handoff,
|
|
40
|
-
Event Bus, Scheduler, Sandbox, Planner, Validator, GraphLoop e Context Engine.
|
|
41
|
-
- MCP, SDK, Plugin SDK, adapters SQLite/Git/NestJS, Control Plane e Evaluation
|
|
42
|
-
Engine.
|
|
43
|
-
- Dashboard Next.js com consultas, GraphLoop, aprovações e ações supervisionadas.
|
|
44
|
-
- Auditoria de segurança, release e migração documentada.
|
|
45
|
-
|
|
46
|
-
### Validação do candidato
|
|
47
|
-
- TypeScript, builds e 267 testes determinísticos aprovados.
|
|
48
|
-
- `npm audit --offline --omit=dev --audit-level=high`: zero vulnerabilidades.
|
|
49
|
-
- Gitleaks: zero achados após limpeza dos artefatos de build.
|
|
50
|
-
- Release validada após merge da PR #40 e execução do gate de publicação sobre
|
|
51
|
-
o commit/tag limpos.
|
|
52
|
-
|
|
53
|
-
## [1.7.3] — 2026-07-23 — Doctor: permissão/lock não é corrupção
|
|
54
|
-
|
|
55
|
-
O check `memory-db` (consumido por `tools:doctor` e pelo `SessionStart`) tratava **qualquer** falha
|
|
56
|
-
de abertura do `universal.db` como corrupção e prescrevia `sync:universal`. Num ambiente sem escrita
|
|
57
|
-
(sandbox, FS read-only, diretório protegido) o driver lança `SQLITE_CANTOPEN` — e a prescrição é
|
|
58
|
-
ativamente errada: `sync:universal` *escreve* no banco, reencenaria o mesmo erro sem curar nada, e
|
|
59
|
-
levaria o operador a "reindexar" um banco íntegro. Reportado a partir de uma sessão real em sandbox.
|
|
60
|
-
|
|
61
|
-
### Corrigido
|
|
62
|
-
- **`memory-db` classifica a falha de abertura por `err.code`** em vez de colapsar tudo em
|
|
63
|
-
"corrompido" (ADR-0033):
|
|
64
|
-
- `SQLITE_CANTOPEN` / `EACCES` → **permissão/sandbox**, não corrupção; o fix orienta garantir
|
|
65
|
-
leitura no path e **desaconselha** `sync:universal`.
|
|
66
|
-
- `SQLITE_BUSY` → `warn` (lock temporário de outro processo; não trava o gate); o fix é aguardar.
|
|
67
|
-
- `SQLITE_CORRUPT` / `SQLITE_NOTADB` / resto → corrupção; fix `npm run sync:universal`.
|
|
68
|
-
O `err.code` já vinha impresso no `detail`, mas não decidia nada — a informação existia, faltava
|
|
69
|
-
ramificar. É a mesma classe do bug de ABI que motivou a SPEC-009, sobrevivendo dentro do arquivo
|
|
70
|
-
escrito para fechá-la.
|
|
71
|
-
|
|
72
|
-
### Adicionado
|
|
73
|
-
- **ADR-0033** e quatro casos em `test/health.test.js` (CANTOPEN, EACCES, BUSY, NOTADB): a distinção
|
|
74
|
-
vira invariante que roda.
|
|
75
|
-
|
|
76
|
-
---
|
|
77
|
-
|
|
78
|
-
## [1.7.2] — 2026-07-22 — Fechando a classe: superfícies do projeto usam `cwd`
|
|
79
|
-
|
|
80
|
-
A auditoria sistemática dos comandos consumer-facing (o passo estrutural após os fixes caso-a-caso
|
|
81
|
-
de `spec:new`/`project:check`) achou **mais três instâncias vivas** da mesma classe — todas escondidas
|
|
82
|
-
num `const root = __dirname/..` que misturava "recurso do framework" com "projeto do usuário". Agora a
|
|
83
|
-
regra é explícita e tem gate (ADR-0032).
|
|
84
|
-
|
|
85
|
-
### Corrigido
|
|
86
|
-
- **`gsd:plan`/`gsd:handoff`/`gsd:check`** (agent-harness) gravavam o runbook e liam `specs/` dentro
|
|
87
|
-
do pacote no consumidor; o `gsd:check` ainda spawava o `spec:check` com `cwd` do pacote e caminho
|
|
88
|
-
`.mjs` cravado (inexistente no dist). Agora operam em `process.cwd()` e resolvem o script via
|
|
89
|
-
`resolveScript` (`.ts` no dev, `.js` no dist).
|
|
90
|
-
- **`context:budget`/`agent:brief`/`context:sprint`** (context-ops) resolviam `.context/`, `specs/`,
|
|
91
|
-
`memory/` e o `.memoryrc.json` no pacote; o `cmdBudget` ainda validava travessia contra a raiz do
|
|
92
|
-
pacote e rejeitava arquivos do projeto. Agora usam `projectRoot = process.cwd()`; `catalog:*`
|
|
93
|
-
(recurso do framework) segue em `root`.
|
|
94
|
-
- **`design:check`** rejeitava o brief do consumidor ("caminho fora do projeto") por ancorar a
|
|
95
|
-
travessia no pacote — agora ancora no projeto.
|
|
96
|
-
|
|
97
|
-
### Adicionado
|
|
98
|
-
- **Gate `consumer-project-surfaces`** no `release:check`: executa `gsd:plan` + `context:budget` no
|
|
99
|
-
cwd de um consumidor instalado e prova que o runbook cai em `<cwd>/.context/` e que o budget o lê de
|
|
100
|
-
lá. Testemunha cruzada, independente do banco — reprova a classe inteira antes do publish.
|
|
101
|
-
- **ADR-0032** e `test/consumer-project-surfaces.test.js`: a regra `projectRoot` (cwd) vs `root`
|
|
102
|
-
(framework) como invariante que roda. `sprint-manager` foi auditado e está são (opera pelo workspace).
|
|
103
|
-
|
|
104
|
-
---
|
|
105
|
-
|
|
106
|
-
## [1.7.1] — 2026-07-22 — Correção: `project:check` em projetos consumidores
|
|
107
|
-
|
|
108
|
-
### Corrigido
|
|
109
|
-
- **`forja project:check` num projeto consumidor auditava `node_modules/forjajs/dist/`** em vez do
|
|
110
|
-
projeto (raiz cravada em `__dirname/..`), reportando os arquivos obrigatórios como faltando (score
|
|
111
|
-
0%) — o que travava o gate `implement` do `orchestrate`. Agora audita `process.cwd()` (propagado
|
|
112
|
-
pelo dispatcher desde a 1.6.2). Mesma classe do `spec-cli` (v1.6.2); o `check-standards` ficou de
|
|
113
|
-
fora. O `check:all` **não** é afetado (agrega health/smoke/release, não `project:check`).
|
|
114
|
-
|
|
115
|
-
### Adicionado
|
|
116
|
-
- **Gate `consumer-project-check`** no `release:check`: planta um arquivo só no cwd e prova que
|
|
117
|
-
`project:check` audita o projeto do consumidor, não o pacote. Provado com dentes (reprova o bug).
|
|
118
|
-
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
Histórico consolidado das mudanças estruturais do framework. Para decisões arquiteturais com rationale, ver `memory/90-decisions/`.
|
|
4
|
+
|
|
119
5
|
---
|
|
120
6
|
|
|
121
|
-
## [
|
|
122
|
-
|
|
123
|
-
O nome do framework sempre foi orquestração multiagente; até aqui, a topologia era coerente
|
|
124
|
-
(SPEC-019) mas o fluxo vivia por disciplina. Esta release o faz **rodar**.
|
|
125
|
-
|
|
126
|
-
### Adicionado
|
|
127
|
-
- **`orchestrate` / `orchestrate:status` / `orchestrate:advance`** (SPEC-021, ADR-0031): a cadeia
|
|
128
|
-
SDD/GSD (spec→plan→tasks→implement→review) como **máquina de estados guardada por gates**. Cada
|
|
129
|
-
etapa abre com um handoff ADR-0005 para o dono do papel; `advance` só fecha a etapa se o artefato
|
|
130
|
-
SDD estiver aprovado **e** o gate da transição sair verde — pular etapa é bloqueado pela máquina,
|
|
131
|
-
não pela memória. O framework orquestra e guarda; o agente (IA ou humano) executa. Estado em
|
|
132
|
-
`<cwd>/.context/orchestrate-<slug>.json`; roda no framework e em projetos consumidores.
|
|
133
|
-
- `commands-documented` ganha fallback para comandos **sem dois-pontos** (grep literal de nome
|
|
134
|
-
conhecido) — `orchestrate` é o primeiro do registry.
|
|
135
|
-
|
|
136
|
-
### Corrigido
|
|
137
|
-
- **Backend gerado compila em Node 26**: o template pinava `better-sqlite3 ^11` (sem prebuild para
|
|
138
|
-
Node novo); alinhado ao do framework (`^12`). Fecha o caveat da v1.6.0 — `check:all --full` verde.
|
|
139
|
-
- **Roadmap defasado**: o `release-auditor` já consumia o gate (ADR-0024); refresh da tabela
|
|
140
|
-
(+ `consumer-spec-new`) e checkboxes marcados nos READMEs.
|
|
141
|
-
|
|
142
|
-
---
|
|
143
|
-
|
|
144
|
-
## [1.6.2] — 2026-07-21 — Correção: `spec:new` em projetos consumidores
|
|
145
|
-
|
|
146
|
-
### Corrigido
|
|
147
|
-
- **`forja spec:new` num projeto consumidor escrevia a spec DENTRO de `node_modules/forjajs/dist`**
|
|
148
|
-
e falhava com "template ausente". Duas causas: o dispatcher spawnava os filhos com `cwd` = raiz do
|
|
149
|
-
pacote (agora usa o cwd de quem invocou — uma CLI opera onde é chamada), e o `spec-cli` resolvia
|
|
150
|
-
templates e destino por uma raiz só (agora separa `pkgRoot`, de onde vêm os templates, de
|
|
151
|
-
`targetRoot`, onde as specs nascem). Framework inalterado.
|
|
152
|
-
- Sem `.gitignore` ou sem bloco de allowlist: silêncio em vez de aviso — num consumidor esse é o
|
|
153
|
-
estado saudável (specs versionadas normalmente).
|
|
154
|
-
|
|
155
|
-
### Adicionado
|
|
156
|
-
- **Gate `consumer-spec-new`** no `release:check`: roda `spec:new` na instalação limpa e reprova se a
|
|
157
|
-
spec não nascer no projeto do consumidor ou vazar para dentro do pacote. O smoke pegava "não
|
|
158
|
-
carrega"; este pega "opera no mundo errado".
|
|
159
|
-
|
|
160
|
-
---
|
|
161
|
-
|
|
162
|
-
## [1.6.1] — 2026-07-20 — Correção: `project:upgrade` no pacote publicado
|
|
163
|
-
|
|
164
|
-
### Corrigido
|
|
165
|
-
- **`project:upgrade` quebrava com `Cannot find module .../create-memory-nest-kit.ts`** no pacote
|
|
166
|
-
instalado. O spawn do gerador cravava a extensão `.ts`; em dev funciona, mas o `dist/` publicado
|
|
167
|
-
tem `.js`. Agora resolve dinamicamente via `resolveScript` (`.ts` em dev, `.js` no publicado). O
|
|
168
|
-
`project:smoke` tinha o mesmo defeito, também corrigido. Teste de regressão guarda a classe.
|
|
169
|
-
|
|
170
|
-
---
|
|
171
|
-
|
|
172
|
-
## [1.6.0] — 2026-07-20 — A orquestração coerente e a governança num comando
|
|
173
|
-
|
|
174
|
-
A governança do framework ganha um ponto de entrada e o namesake — orquestração multiagente — deixa
|
|
175
|
-
de viver por prosa.
|
|
176
|
-
|
|
177
|
-
### Adicionado
|
|
178
|
-
- **`check:all`** (SPEC-020): roda a **bateria inteira de gates** e dá um veredito só. Tier barato:
|
|
179
|
-
coerência (`tools:doctor`) + `project:smoke`; `--full`: + tarball (`release:check`) + build do
|
|
180
|
-
gerado. Compõe os runners existentes — zero check reimplementado. "A casa está coerente?" num
|
|
181
|
-
comando, não num checklist lembrado.
|
|
182
|
-
- **`agent-topology`** (check no `tools:doctor`, SPEC-019): a topologia de orquestração é descrita em
|
|
183
|
-
três fontes (`VALID_AGENTS`, `.claude/agents/*.md`, `AGENTS.md`) e pode divergir em silêncio. O
|
|
184
|
-
check as cruza e reprova quando não concordam. Pegou o `release-auditor` (sub-agent executável sem
|
|
185
|
-
rota) na 1ª execução — agora first-class no router e documentado (AGENTS.md §7).
|
|
186
|
-
|
|
187
|
-
### Corrigido / interno
|
|
188
|
-
- **`generators.test` migrado para `node:test`**: o harness custom legado não contava suas falhas no
|
|
189
|
-
tally do CI e vazava um `/tmp` por execução (588 diretórios acumulados). Agora é `node:test` com
|
|
190
|
-
cleanup — falha derruba o CI de verdade.
|
|
191
|
-
|
|
192
|
-
---
|
|
193
|
-
|
|
194
|
-
## [1.5.0] — 2026-07-19 — A memória como sistema fechado: medir → entregar → proteger → propagar
|
|
195
|
-
|
|
196
|
-
A economia de token do Forja sempre foi a memória persistente (ADR-0009), mas era uma promessa. Esta
|
|
197
|
-
release a torna um ciclo completo e verificável — cada peça fecha um elo.
|
|
198
|
-
|
|
199
|
-
### Adicionado
|
|
200
|
-
- **`code:context <domínio>`** (SPEC-016): **entrega** o mapa da memória como pacote pronto para
|
|
201
|
-
colar (o `context.md`), com `--code` para o código da fatia e o custo em token à mostra. É o −61%
|
|
202
|
-
medido no `token:economy` virado ferramenta. Compõe com `code:impact` para o blast radius.
|
|
203
|
-
- **`memory:audit`** (SPEC-017): **protege** o mapa nas duas direções — reprova se um `context.md`
|
|
204
|
-
cita código que não existe (mapa que mente é pior que mapa nenhum) e avisa sobre módulo de código
|
|
205
|
-
sem mapa (economia perdida em silêncio). O `adr-refs` aplicado aos mapas de memória.
|
|
206
|
-
- **`token:economy --project <path>`**: mede o eixo memória nos **domínios reais do usuário** (mapa
|
|
207
|
-
vs código, por domínio) — o número fica dele, não da fixture.
|
|
208
|
-
- **`project:upgrade`** (SPEC-018): a metade que faltava do scaffolder. Traz peças novas de scaffold
|
|
209
|
-
para um projeto já gerado — **aditivo, nunca sobrescreve** (o código do usuário é intocável).
|
|
210
|
-
Dry-run por padrão; `--apply` copia.
|
|
211
|
-
- **O projeto gerado herda o gate** (ADR-0030): o gerador emite `scripts/check-memory-maps.mjs`, um
|
|
212
|
-
`memory:audit` self-contained (Node puro, zero dep), e o `project:smoke` prova a propagação. O
|
|
213
|
-
invariante da coerência mapa↔código passa a viajar com cada projeto.
|
|
214
|
-
|
|
215
|
-
### Nota
|
|
216
|
-
- Comandos e gates novos do framework; nada muda para projetos já gerados até rodarem `project:upgrade`.
|
|
217
|
-
|
|
218
|
-
---
|
|
219
|
-
|
|
220
|
-
## [1.4.0] — 2026-07-19 — Governança que mede: gate do gerador, economia de token e integridade de ADR
|
|
221
|
-
|
|
222
|
-
Três fronteiras que viviam por disciplina viram harness — e cada uma provou seu valor pegando um
|
|
223
|
-
problema real na estreia.
|
|
224
|
-
|
|
225
|
-
### Adicionado
|
|
226
|
-
- **`project:smoke`** (SPEC-015, ADR-0029): o gate do projeto gerado. Gera um projeto num tmp isolado
|
|
227
|
-
e prova que é coerente — zero placeholder `{{...}}` vazado, `package.json` válido, estrutura íntegra
|
|
228
|
-
(reusa o `structure-validator`). Tier `--full` (opt-in): `npm install` + `npm run build` do backend
|
|
229
|
-
gerado. É o `release:check` da saída do gerador, um nível acima do tarball.
|
|
230
|
-
- **`token:economy`** (fecha a dívida do ADR-0027; mede ADR-0009): mede a economia de token em dois
|
|
231
|
-
eixos, com file-sets explícitos. **Eixo arquitetura** (clean vs flat, mesma feature): camadas
|
|
232
|
-
custam **+56%** numa feature pequena — a versão ingênua de "Clean Architecture economiza tokens"
|
|
233
|
-
não se sustenta. **Eixo memória** (frio vs quente): o `context.md` (mapa) faz o contexto mínimo
|
|
234
|
-
custar **−61%** vs varrer a fatia no frio — e isso **compõe** a cada tarefa. A economia do Forja é
|
|
235
|
-
da memória persistente, amortizada no tempo, não das camadas. Narrativa corrigida no
|
|
236
|
-
`WHEN-CLEAN-WHEN-LEAN.md` e no ADR-0027.
|
|
237
|
-
- **`adr-refs`** (check no `tools:doctor`, ADR-0025): toda citação `ADR-NNNN` aponta para um ADR que
|
|
238
|
-
existe. Na 1ª execução pegou o `ADR-0026` pendurado (citado pela SPEC-012, nunca escrito) — fechado
|
|
239
|
-
escrevendo o **ADR-0026** (arquitetura da migração TS: resolver, runtime duplo, gate-builda-dist).
|
|
240
|
-
|
|
241
|
-
### Nota
|
|
242
|
-
- Nada muda para quem já tem projetos gerados; são comandos e gates novos do framework.
|
|
243
|
-
|
|
244
|
-
---
|
|
245
|
-
|
|
246
|
-
## [1.3.2] — 2026-07-19 — Migração TypeScript concluída (interno)
|
|
247
|
-
|
|
248
|
-
**Sem mudança para quem instala** — o `dist/*.js` publicado é idêntico ao da 1.3.1. Fecha a SPEC-012.
|
|
249
|
-
|
|
250
|
-
### Alterado (interno)
|
|
251
|
-
- **Fonte 100% TypeScript**: os 16 `.js` restantes (entries públicos `init-project`/
|
|
252
|
-
`create-memory-nest-kit`, generators, validators, `context-builder`, scaffolding) viraram `.ts`.
|
|
253
|
-
- **`noImplicitAny: true`** — o ratchet está armado: daqui pra frente todo parâmetro novo precisa de
|
|
254
|
-
tipo explícito. Os ~285 params existentes foram anotados (tipo real onde agrega, `any` explícito
|
|
255
|
-
onde o valor é dinâmico). Os checks de `health`/`release` viram `Check[]` de verdade.
|
|
256
|
-
- Shim `lib/vendor.d.ts` para o `better-sqlite3` (sem tipos publicados); `lib/templates` fora do
|
|
257
|
-
type-check (é conteúdo copiado, não código do framework).
|
|
258
|
-
- Correção pega pelo `release:check`: um sed havia corrompido o array de fallback do `resolveScript`
|
|
259
|
-
(`['.ts','.js','.mjs']`→`['.ts','.ts','.ts']`), quebrando a resolução do `dist/*.js`.
|
|
260
|
-
|
|
261
|
-
---
|
|
262
|
-
|
|
263
|
-
## [1.3.1] — 2026-07-19 — Migração TypeScript dos módulos do framework (interno)
|
|
264
|
-
|
|
265
|
-
**Sem mudança para quem instala** — o `dist/*.js` publicado é idêntico ao da 1.3.0. A conversão é
|
|
266
|
-
interna: fecha a renomeação leaf-first da SPEC-012 Fase 2.
|
|
267
|
-
|
|
268
|
-
### Alterado (interno)
|
|
269
|
-
- **Todos os 21 módulos `.mjs` do framework** (`bin/forja`, `lib/{audit,governance-report,workspace}`,
|
|
270
|
-
todos os `scripts/` incluindo os 4 hooks) convertidos para `.ts`, com ~130 anotações de tipo. Os
|
|
271
|
-
typedefs JSDoc viraram `interface`; os casts-comentário `/** @type */ (x)` viraram `as`.
|
|
272
|
-
- Dev e CI rodam a fonte `.ts` (Node ≥22.6); o `ci.yml` invoca `bin/forja.ts`. O publicado segue
|
|
273
|
-
`dist/*.js` (Node ≥20), provado pelo `release-gate`.
|
|
274
|
-
- **Fora desta fatia** (deliberado): os 16 `.js` (entries públicos + generators + scaffolding), que
|
|
275
|
-
seguem no checkJs, e `noImplicitAny: true` (endurecimento final).
|
|
276
|
-
|
|
277
|
-
---
|
|
278
|
-
|
|
279
|
-
## [1.3.0] — 2026-07-19 — Governança visível e o núcleo em TypeScript
|
|
280
|
-
|
|
281
|
-
Duas frentes que amadurecem o framework: a governança sai do arquivo que ninguém abre para
|
|
282
|
-
**consultável e visível**, e o motor de invariantes (`lib/core/`) passa a ser **TypeScript de
|
|
283
|
-
verdade**, com o pacote publicando `dist/` compilado.
|
|
284
|
-
|
|
285
|
-
### Adicionado
|
|
286
|
-
- **Auditoria consultável + painel de governança** (SPEC-014, ADR-0028): `audit:sync` projeta o
|
|
287
|
-
`.context/forja-runs.jsonl` na tabela `audit_runs` (idempotente por `line_hash` — o `.jsonl` segue
|
|
288
|
-
sendo a fonte de verdade); `audit:query` filtra a trilha por `--failed`/`--cmd`/`--since`/`--gate`;
|
|
289
|
-
`governance:dashboard` gera um HTML **estático e self-contained** (sem servidor — a lição do
|
|
290
|
-
ADR-0022) com o estado de specs, ADRs, gates e métricas.
|
|
291
|
-
- **`lib/core/` em TypeScript** (SPEC-012 Fase 2, leaf-first): `checks`, `health`, `release`,
|
|
292
|
-
`doc-graph` e `registry` viram `.ts` com `interface Check/Probe/Result` reais. Dev roda `.ts`
|
|
293
|
-
nativo (Node ≥22.6); o publicado embarca `dist/*.js` (Node ≥20).
|
|
7
|
+
## [2.0.4] — 2026-08-17 — Auditoria de release e handoffs confiáveis
|
|
294
8
|
|
|
295
9
|
### Alterado
|
|
296
|
-
- **
|
|
297
|
-
`release:check
|
|
298
|
-
|
|
299
|
-
- **CI**: o job `test` roda em Node 22.x/24.x (a fonte `.ts` exige strip-types ≥22.6). O suporte a
|
|
300
|
-
Node 20 do pacote publicado (que é `dist/*.js`) segue provado pelo job `release-gate`.
|
|
301
|
-
|
|
302
|
-
---
|
|
303
|
-
|
|
304
|
-
## [1.2.0] — 2026-07-18 — Boilerplate Clean Architecture, coerência de doc e correções
|
|
305
|
-
|
|
306
|
-
Feature nova (um boilerplate), o terceiro gate de invariante (coerência da documentação), e
|
|
307
|
-
**correções de dois bugs vivos na 1.1.6** que o TypeScript achou. A migração TS avançou até o
|
|
308
|
-
pipeline de build provado — mas continua publicando a fonte `.mjs` (a troca para `dist/` é interna
|
|
309
|
-
e fica para uma release futura).
|
|
310
|
-
|
|
311
|
-
### Corrigido
|
|
312
|
-
- **`npm run dev` estava quebrado** na 1.1.6: `scripts/dev.mjs` chamava `spawn()` sem importar —
|
|
313
|
-
`ReferenceError` em três caminhos (agent-harness, compress-memory, create-memory-nest-kit).
|
|
314
|
-
- **`context:budget` / `catalog:assets` estavam quebrados** na 1.1.6: `scripts/context-ops.mjs`
|
|
315
|
-
importava `dbPath` (inexistente; só há `getDbPath`) e o usava em `new Database(dbPath)`.
|
|
316
|
-
- Typedefs `Check`/`Result` duplicados e divergentes em `health.mjs` (resíduo da extração do runner).
|
|
317
|
-
- 22 links relativos quebrados em docs legadas (personas, quick-reference, structure).
|
|
318
|
-
|
|
319
|
-
### Adicionado
|
|
320
|
-
- **Boilerplate `06-clean-arch`** (SPEC-013, ADR-0027): DDD por camadas onde se paga, caminho enxuto
|
|
321
|
-
onde não. Fatia rica (Orders) com inversão de dependência e invariante testável sem subir o Nest;
|
|
322
|
-
caminho enxuto (Products) lado a lado; `WHEN-CLEAN-WHEN-LEAN.md` com o critério; memória por
|
|
323
|
-
bounded context. A economia de token é reportada com honestidade (argumentada, não provada — o
|
|
324
|
-
benchmark é follow-up).
|
|
325
|
-
- **Gate de coerência da documentação** (SPEC-011, ADR-0025): `lib/core/doc-graph.mjs` + três checks
|
|
326
|
-
no `health.mjs` — `docs-commands` (critical: todo `forja <cmd>` citado existe no registry),
|
|
327
|
-
`commands-documented` e `docs-links` (warn). Rodam no `tools:doctor` e no CI.
|
|
328
|
-
- **Resolver de script agnóstico de extensão** (SPEC-012): `resolveScript` desacopla o registry da
|
|
329
|
-
extensão (`.ts → .js → .mjs`), preparando a migração TS. Backward-compatible.
|
|
330
|
-
|
|
331
|
-
### Interno
|
|
332
|
-
- **TypeScript como gate** (SPEC-012, Fases 0-1): `checkJs` estrito sobre a fonte `.mjs`,
|
|
333
|
-
`types:check` no CI, contratos do núcleo (`Check`/`Probe`/`Result`) tipados. Pipeline de build
|
|
334
|
-
(`tsc → dist`) provado; a publicação de `dist/` e a renomeação `.mjs → .ts` ficam para depois.
|
|
335
|
-
|
|
336
|
-
### Nota
|
|
337
|
-
- O `docs-links` pegou o **próprio autor**: um erro de profundidade relativa (`../../` vs `../../../`)
|
|
338
|
-
na correção dos links foi detectado pelo doctor antes do commit. E o `release:check` pegou o
|
|
339
|
-
acoplamento do dist-publish (código em `dist/scripts`, não `scripts/`) antes de qualquer publish.
|
|
340
|
-
|
|
341
|
-
## [1.1.6] — 2026-07-14 — README em inglês
|
|
342
|
-
|
|
343
|
-
A vitrine do pacote passa a ter versão em inglês, para alcançar quem chega pelo npm.
|
|
344
|
-
|
|
345
|
-
### Adicionado
|
|
346
|
-
- `README.en.md` — adaptação fiel do README em português, no estilo canônico `forja <comando>`.
|
|
347
|
-
Seletor de idioma no topo dos dois arquivos. Incluído no `files[]` do pacote.
|
|
348
|
-
|
|
349
|
-
### Nota
|
|
350
|
-
- A **documentação** (`docs/`) permanece em pt-BR — é parte da identidade do projeto. Só a capa
|
|
351
|
-
ganhou inglês. O README inglês foi verificado contra o registry: zero comandos inexistentes,
|
|
352
|
-
zero links quebrados.
|
|
353
|
-
|
|
354
|
-
## [1.1.5] — 2026-07-14 — O comando é forja
|
|
355
|
-
|
|
356
|
-
A documentação pública ainda falava a língua interna do repo: `npm run x -- args` onde o usuário
|
|
357
|
-
do pacote tem `forja x args`. Esta versão alinha o que o README promete com o que o binário faz.
|
|
358
|
-
|
|
359
|
-
### Corrigido
|
|
360
|
-
|
|
361
|
-
- **README inteiro migrado para `forja` como forma canônica** — os scripts npm continuam
|
|
362
|
-
existindo como aliases do repo clonado, mas deixam de ser a vitrine.
|
|
363
|
-
- **Exemplos do "60 segundos" estavam quebrados**: `forja gsd:handoff -- plan …` passa o `--`
|
|
364
|
-
cru para o script (o core não filtra separador) e o comando falha. O `--` só era necessário
|
|
365
|
-
na forma `npm run`; removido dos exemplos diretos.
|
|
366
|
-
- **Comando errado na lista de essenciais**: validar projeto do workspace é
|
|
367
|
-
`workspace:project:check <nome>`, não `project:check <nome>` (que é o standards check do framework).
|
|
368
|
-
- **Links mortos**: `projects/ai-engineering-from-scratch-main/` não existe no repo;
|
|
369
|
-
`docs/capacidades-externas.md` agora aponta para as fontes upstream (ADR-0016) e a
|
|
370
|
-
reinstalação segue a prescrição do `tools:doctor` (`npm i -g @codegraph/cli`) em vez do
|
|
371
|
-
symlink manual antigo.
|
|
372
|
-
- **`package-lock.json` preso em 1.1.3** desde o bump da 1.1.4; sincronizado.
|
|
373
|
-
|
|
374
|
-
### Adicionado
|
|
375
|
-
|
|
376
|
-
- Seção "Comandos essenciais" do README ampliada com o que já existia no registry mas não
|
|
377
|
-
aparecia: `gsd:plan`/`gsd:check`, `code:check`/`code:impact`, `memory:compress`,
|
|
378
|
-
`tools:doctor`, `release:check --publish`.
|
|
379
|
-
- `allowScripts` no `package.json`: instalações com política allow-scripts ativa deixam de
|
|
380
|
-
bloquear silenciosamente o prebuild do `better-sqlite3` — exatamente o modo de falha que
|
|
381
|
-
matava a memória (ADR-0023).
|
|
382
|
-
|
|
383
|
-
---
|
|
384
|
-
|
|
385
|
-
## [1.1.4] — 2026-07-14 — Os gates
|
|
386
|
-
|
|
387
|
-
Duas fronteiras do framework funcionavam por disciplina, e a disciplina falhou nas duas. Esta versão
|
|
388
|
-
as fecha com gates executáveis — e, pela primeira vez, com **prova**: os bugs históricos foram
|
|
389
|
-
reintroduzidos um a um, e o gate reprovou cada um deles.
|
|
390
|
-
|
|
391
|
-
> "Uma regra que depende de memória não é uma regra; é uma sugestão." — ADR-0021
|
|
392
|
-
|
|
393
|
-
### O que muda para quem usa
|
|
394
|
-
|
|
395
|
-
- **`npm publish` está bloqueado** se a instalação limpa não funcionar (`prepublishOnly` → ADR-0024).
|
|
396
|
-
- **`tools:doctor` reprova** (exit 1) quando o núcleo está quebrado — antes ele auditava só
|
|
397
|
-
ferramentas opcionais e saía com 0 mesmo com a memória morta (ADR-0023).
|
|
398
|
-
- Quando algo quebra, a saída traz **o comando que corrige**, não um stack trace.
|
|
399
|
-
|
|
400
|
-
### Adicionado
|
|
401
|
-
|
|
402
|
-
- **`lib/core/health.mjs`** — saúde do núcleo como dados: ABI do `better-sqlite3`, memória, índice,
|
|
403
|
-
workspace, `engines`, deps de runtime, `.mcp.json`. Fonte única do `tools:doctor` e do hook
|
|
404
|
-
`SessionStart` (ADR-0023).
|
|
405
|
-
- **`lib/core/release.mjs` + `release:check`** — o gate do tarball. Empacota, instala num diretório
|
|
406
|
-
isolado e **executa** os comandos. Grep não prova ausência; instalação prova (ADR-0024).
|
|
407
|
-
- **`lib/core/checks.mjs`** — runner compartilhado. Uma máquina, dois catálogos: um guarda o repo,
|
|
408
|
-
outro guarda o pacote publicado.
|
|
409
|
-
- **CI**: `tools:doctor` na matriz de Nodes e `release:check` em job próprio. A evidência do release
|
|
410
|
-
passa a viver no log do CI, não na memória de quem publica.
|
|
411
|
-
- `spec:new` mantém a allow-list do `.gitignore` — toda spec nova do framework nascia invisível ao git.
|
|
412
|
-
|
|
413
|
-
### Corrigido
|
|
414
|
-
|
|
415
|
-
- **A memória morria em silêncio.** Com o `better-sqlite3` compilado contra outra major do Node,
|
|
416
|
-
`query:universal`, `sync:universal`, `context:smart`, `agent:route` e `memory:compress` ficavam
|
|
417
|
-
todos inoperantes — e o `SessionStart` prescrevia `npm install`, que **não** recompila binário
|
|
418
|
-
nativo. A correção é `npm rebuild better-sqlite3`, e agora é isso que o framework diz.
|
|
419
|
-
- **`docs/token-optimization.md` mandava rodar quatro comandos inexistentes** (`context:build`,
|
|
420
|
-
`memory:db:reindex`, `memory:db:stats`, `cache:clear`) e linkava um `DEPLOYMENT.md` que nunca
|
|
421
|
-
existiu. É o documento que ensina a economia de tokens (ADR-0009) — um agente obediente executava
|
|
422
|
-
fantasmas.
|
|
423
|
-
- **O Governance não conhecia os gates**: descrevia o `tools:doctor` pela definição anterior ao
|
|
424
|
-
ADR-0023 e ignorava o `release:check`.
|
|
425
|
-
- `runtime-deps` passava por sorte: os geradores emitem `import … from '@nestjs/common'` dentro de
|
|
426
|
-
template literal, e o parser contava como dependência do framework.
|
|
427
|
-
|
|
428
|
-
### Evidência
|
|
429
|
-
|
|
430
|
-
| Bug histórico | Reintroduzido → |
|
|
431
|
-
|---|---|
|
|
432
|
-
| `better-sqlite3` como `devDependency` (ADR-0021) | reprovado por **dois** checks independentes |
|
|
433
|
-
| `dashboard/` fora do `files[]` (v1.1.3) | reprovado: 4 comandos mortos, 19 imports sem destino |
|
|
434
|
-
| `otplib`/`qrcode` publicados sem existir no git (v1.1.1) | reprovado sob `--publish`; `npm publish` aborta |
|
|
435
|
-
|
|
436
|
-
**88 testes** (eram 28). ADR-0023 e ADR-0024. SPEC-009 e SPEC-010.
|
|
437
|
-
|
|
438
|
-
## [1.1.3] — 2026-07-09 — Dashboard congelado
|
|
439
|
-
|
|
440
|
-
SPEC-002 (`specs/agent-dashboard/`) passa a `abandoned`. O código permanece em `dashboard/`,
|
|
441
|
-
versionado e com os 68 testes verdes, mas deixa de ser superfície pública. Ver
|
|
442
|
-
ADR-0022 (`memory/90-decisions/0022-congelar-dashboard-web.md`) para rationale e condições de retomada.
|
|
10
|
+
- **Release Auditor consome a saúde canônica** (SPEC-022): executa `tools:doctor` antes de
|
|
11
|
+
`release:check --publish`, interrompe a auditoria em falha crítica e preserva avisos no parecer.
|
|
12
|
+
A prova estrita do tarball continua separada e `npm publish` permanece um ato humano.
|
|
443
13
|
|
|
444
14
|
### Corrigido
|
|
445
|
-
-
|
|
446
|
-
|
|
447
|
-
e
|
|
448
|
-
- `README.md` descrevia o dashboard como "visão opcional read-only"; ele expõe rotas que executam
|
|
449
|
-
processos (`POST /api/workflow/:project/run/:role`). Descrição corrigida.
|
|
450
|
-
- `scripts/spec-cli.mjs` — `abandoned` é status válido, mas o `check` o rejeitava como incoerente
|
|
451
|
-
quando havia `plan.md`/`tasks.md`, derrubando o gate com exit 1. Agora é tratado como terminal,
|
|
452
|
-
junto de `done`.
|
|
453
|
-
|
|
454
|
-
### Removido
|
|
455
|
-
- Scripts `dashboard`, `dashboard:dev`, `dashboard:install`, `dashboard:web:dev` e
|
|
456
|
-
`dashboard:web:build` do `package.json` do root.
|
|
457
|
-
- `docs/dashboard.md` e `specs/agent-dashboard/` do `files[]` do pacote npm.
|
|
458
|
-
|
|
459
|
-
## [Unreleased] — Workspace separado
|
|
460
|
-
|
|
461
|
-
SPEC-028 (`specs/reestruturacao-forja-v2/`): separação do framework Forja do workspace de produção.
|
|
462
|
-
|
|
463
|
-
- `lib/workspace.mjs` — resolução centralizada do workspace (`FORJA_WORKSPACE` > `~/.forjarc.json` > `~/forja-workspace`).
|
|
464
|
-
- `bin/init-project.js` — projetos de produto obrigatoriamente em `~/forja-workspace/projects/<nome>`.
|
|
465
|
-
- `scripts/sync-universal-memory.js`, `query-universal-memory.js`, `build-smart-context.js`, `memory-schema.mjs` — memória universal (SQLite) movida para o workspace.
|
|
466
|
-
- `scripts/check-standards.js` — `npm run project:check <nome>` resolve projeto no workspace.
|
|
467
|
-
- `scripts/agent-harness.mjs` + `package.json` — comandos `workspace:init`, `project:new`, `project:list`, `workspace:project:check`.
|
|
468
|
-
- Documentação atualizada: `README.md`, `AGENTS.md`, `docs/init-project.md`, `docs/structure.md`.
|
|
469
|
-
- ADR-0019 (`memory/90-decisions/0019-workspace-separado.md`) documenta a decisão.
|
|
470
|
-
- `.gitignore` reforça que projetos de produto não entram no repo do framework.
|
|
471
|
-
|
|
472
|
-
## [Unreleased] — Dashboard local
|
|
473
|
-
|
|
474
|
-
SPEC-002 (`specs/agent-dashboard/`) implementada em 12 tasks (T1-T12).
|
|
475
|
-
|
|
476
|
-
- `dashboard/server/` — Fastify 5 com 7 rotas (specs, handoffs, projects, tokens, commands SSE, briefing, health)
|
|
477
|
-
- `dashboard/web/` — Vite + React + Tailwind + Recharts; 6 telas; bundle 166KB gzip (NFR < 500KB ✓)
|
|
478
|
-
- `dashboard/server/lib/` — allowlist hard-coded, run-command, spec-parser, briefing-parser, token-estimator
|
|
479
|
-
- Scripts: `npm run dashboard`, `dashboard:dev`, `dashboard:install`, `dashboard:web:build`
|
|
480
|
-
- **60 testes verde** (55 dashboard + 5 root)
|
|
481
|
-
- `docs/dashboard.md` cobre uso, allowlist, troubleshooting, segurança
|
|
15
|
+
- **`gsd:handoff` voltou a registrar handoffs após a migração TypeScript**: o harness ainda tentava
|
|
16
|
+
executar `scripts/agent-router.mjs`, inexistente no repositório atual. Agora usa `resolveScript`
|
|
17
|
+
para resolver `.ts` em desenvolvimento e `.js` no pacote publicado, com teste de regressão.
|
|
482
18
|
|
|
483
|
-
|
|
19
|
+
### Validação
|
|
20
|
+
- 313 testes, `types:check`, `project:check`, `gsd:check` e `tools:doctor` verdes.
|
|
21
|
+
- `npm audit --omit=dev`: zero vulnerabilidades de produção.
|
|
484
22
|
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
-
|
|
495
|
-
-
|
|
496
|
-
- `
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
- `
|
|
516
|
-
|
|
517
|
-
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
-
|
|
527
|
-
-
|
|
528
|
-
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
- `
|
|
541
|
-
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
- `
|
|
545
|
-
- `
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
23
|
+
## [2.0.2] — 2026-08-01 — Integração operacional das Sprints 1–11
|
|
24
|
+
|
|
25
|
+
Consolida a evolução do ForjaJS 2.x após a fundação 2.0.1, conectando a CLI,
|
|
26
|
+
Capability Registry, Runtime, MCP, SQLite, GraphLoop e Context Engine em um
|
|
27
|
+
fluxo persistente, auditável e testado.
|
|
28
|
+
|
|
29
|
+
### Adicionado
|
|
30
|
+
- Adapter da CLI sobre o Capability Registry com `ExecutionResult` estruturado.
|
|
31
|
+
- Persistência SQLite para runtime, aprovações, eventos e GraphLoop.
|
|
32
|
+
- MCP dinâmico derivado das capabilities registradas.
|
|
33
|
+
- Context Engine integrado ao GraphLoop, com cache por checksum e orçamento.
|
|
34
|
+
- Extractors determinísticos e capability `graph.sync` para CLI/MCP.
|
|
35
|
+
- Testes de recuperação, autonomia E2E, contratos e integração.
|
|
36
|
+
- ADRs, auditoria de implementação e handoffs das Sprints 1–11.
|
|
37
|
+
|
|
38
|
+
## [2.0.1] — 2026-08-01 — Higiene de dependências do pacote
|
|
39
|
+
|
|
40
|
+
Move as dependências de NestJS e dashboard para os manifests das aplicações e
|
|
41
|
+
para `devDependencies` do repositório. O tarball do framework agora carrega
|
|
42
|
+
somente `better-sqlite3` como dependência de runtime, eliminando peso morto sem
|
|
43
|
+
alterar os ambientes oficiais de server e dashboard.
|
|
44
|
+
|
|
45
|
+
## [2.0.0] — 2026-08-01 — Fundação programável local-first
|
|
46
|
+
|
|
47
|
+
Primeira release da plataforma ForjaJS 2.0. A versão mantém a
|
|
48
|
+
CLI-first e adiciona um núcleo programável por agentes, com contratos
|
|
49
|
+
versionados, capabilities, runtime controlado, políticas, memória, GraphLoop,
|
|
50
|
+
contexto orçamentado, MCP, SDK, adapters oficiais, observabilidade e dashboard.
|
|
51
|
+
|
|
52
|
+
### Adicionado
|
|
53
|
+
- Monorepo modular com `apps/server`, `apps/dashboard`, `apps/worker` e pacotes
|
|
54
|
+
de domínio/adaptação independentes de framework.
|
|
55
|
+
- Contracts, Capability Registry, Policy Engine, Runtime, Sprint/Task/Handoff,
|
|
56
|
+
Event Bus, Scheduler, Sandbox, Planner, Validator, GraphLoop e Context Engine.
|
|
57
|
+
- MCP, SDK, Plugin SDK, adapters SQLite/Git/NestJS, Control Plane e Evaluation
|
|
58
|
+
Engine.
|
|
59
|
+
- Dashboard Next.js com consultas, GraphLoop, aprovações e ações supervisionadas.
|
|
60
|
+
- Auditoria de segurança, release e migração documentada.
|
|
61
|
+
|
|
62
|
+
### Validação do candidato
|
|
63
|
+
- TypeScript, builds e 267 testes determinísticos aprovados.
|
|
64
|
+
- `npm audit --offline --omit=dev --audit-level=high`: zero vulnerabilidades.
|
|
65
|
+
- Gitleaks: zero achados após limpeza dos artefatos de build.
|
|
66
|
+
- Release validada após merge da PR #40 e execução do gate de publicação sobre
|
|
67
|
+
o commit/tag limpos.
|
|
68
|
+
|
|
69
|
+
## [1.7.3] — 2026-07-23 — Doctor: permissão/lock não é corrupção
|
|
70
|
+
|
|
71
|
+
O check `memory-db` (consumido por `tools:doctor` e pelo `SessionStart`) tratava **qualquer** falha
|
|
72
|
+
de abertura do `universal.db` como corrupção e prescrevia `sync:universal`. Num ambiente sem escrita
|
|
73
|
+
(sandbox, FS read-only, diretório protegido) o driver lança `SQLITE_CANTOPEN` — e a prescrição é
|
|
74
|
+
ativamente errada: `sync:universal` *escreve* no banco, reencenaria o mesmo erro sem curar nada, e
|
|
75
|
+
levaria o operador a "reindexar" um banco íntegro. Reportado a partir de uma sessão real em sandbox.
|
|
76
|
+
|
|
77
|
+
### Corrigido
|
|
78
|
+
- **`memory-db` classifica a falha de abertura por `err.code`** em vez de colapsar tudo em
|
|
79
|
+
"corrompido" (ADR-0033):
|
|
80
|
+
- `SQLITE_CANTOPEN` / `EACCES` → **permissão/sandbox**, não corrupção; o fix orienta garantir
|
|
81
|
+
leitura no path e **desaconselha** `sync:universal`.
|
|
82
|
+
- `SQLITE_BUSY` → `warn` (lock temporário de outro processo; não trava o gate); o fix é aguardar.
|
|
83
|
+
- `SQLITE_CORRUPT` / `SQLITE_NOTADB` / resto → corrupção; fix `npm run sync:universal`.
|
|
84
|
+
O `err.code` já vinha impresso no `detail`, mas não decidia nada — a informação existia, faltava
|
|
85
|
+
ramificar. É a mesma classe do bug de ABI que motivou a SPEC-009, sobrevivendo dentro do arquivo
|
|
86
|
+
escrito para fechá-la.
|
|
87
|
+
|
|
88
|
+
### Adicionado
|
|
89
|
+
- **ADR-0033** e quatro casos em `test/health.test.js` (CANTOPEN, EACCES, BUSY, NOTADB): a distinção
|
|
90
|
+
vira invariante que roda.
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## [1.7.2] — 2026-07-22 — Fechando a classe: superfícies do projeto usam `cwd`
|
|
95
|
+
|
|
96
|
+
A auditoria sistemática dos comandos consumer-facing (o passo estrutural após os fixes caso-a-caso
|
|
97
|
+
de `spec:new`/`project:check`) achou **mais três instâncias vivas** da mesma classe — todas escondidas
|
|
98
|
+
num `const root = __dirname/..` que misturava "recurso do framework" com "projeto do usuário". Agora a
|
|
99
|
+
regra é explícita e tem gate (ADR-0032).
|
|
100
|
+
|
|
101
|
+
### Corrigido
|
|
102
|
+
- **`gsd:plan`/`gsd:handoff`/`gsd:check`** (agent-harness) gravavam o runbook e liam `specs/` dentro
|
|
103
|
+
do pacote no consumidor; o `gsd:check` ainda spawava o `spec:check` com `cwd` do pacote e caminho
|
|
104
|
+
`.mjs` cravado (inexistente no dist). Agora operam em `process.cwd()` e resolvem o script via
|
|
105
|
+
`resolveScript` (`.ts` no dev, `.js` no dist).
|
|
106
|
+
- **`context:budget`/`agent:brief`/`context:sprint`** (context-ops) resolviam `.context/`, `specs/`,
|
|
107
|
+
`memory/` e o `.memoryrc.json` no pacote; o `cmdBudget` ainda validava travessia contra a raiz do
|
|
108
|
+
pacote e rejeitava arquivos do projeto. Agora usam `projectRoot = process.cwd()`; `catalog:*`
|
|
109
|
+
(recurso do framework) segue em `root`.
|
|
110
|
+
- **`design:check`** rejeitava o brief do consumidor ("caminho fora do projeto") por ancorar a
|
|
111
|
+
travessia no pacote — agora ancora no projeto.
|
|
112
|
+
|
|
113
|
+
### Adicionado
|
|
114
|
+
- **Gate `consumer-project-surfaces`** no `release:check`: executa `gsd:plan` + `context:budget` no
|
|
115
|
+
cwd de um consumidor instalado e prova que o runbook cai em `<cwd>/.context/` e que o budget o lê de
|
|
116
|
+
lá. Testemunha cruzada, independente do banco — reprova a classe inteira antes do publish.
|
|
117
|
+
- **ADR-0032** e `test/consumer-project-surfaces.test.js`: a regra `projectRoot` (cwd) vs `root`
|
|
118
|
+
(framework) como invariante que roda. `sprint-manager` foi auditado e está são (opera pelo workspace).
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## [1.7.1] — 2026-07-22 — Correção: `project:check` em projetos consumidores
|
|
123
|
+
|
|
124
|
+
### Corrigido
|
|
125
|
+
- **`forja project:check` num projeto consumidor auditava `node_modules/forjajs/dist/`** em vez do
|
|
126
|
+
projeto (raiz cravada em `__dirname/..`), reportando os arquivos obrigatórios como faltando (score
|
|
127
|
+
0%) — o que travava o gate `implement` do `orchestrate`. Agora audita `process.cwd()` (propagado
|
|
128
|
+
pelo dispatcher desde a 1.6.2). Mesma classe do `spec-cli` (v1.6.2); o `check-standards` ficou de
|
|
129
|
+
fora. O `check:all` **não** é afetado (agrega health/smoke/release, não `project:check`).
|
|
130
|
+
|
|
131
|
+
### Adicionado
|
|
132
|
+
- **Gate `consumer-project-check`** no `release:check`: planta um arquivo só no cwd e prova que
|
|
133
|
+
`project:check` audita o projeto do consumidor, não o pacote. Provado com dentes (reprova o bug).
|
|
134
|
+
|
|
135
|
+
---
|
|
136
|
+
|
|
137
|
+
## [1.7.0] — 2026-07-22 — O motor de orquestração: o namesake executando
|
|
138
|
+
|
|
139
|
+
O nome do framework sempre foi orquestração multiagente; até aqui, a topologia era coerente
|
|
140
|
+
(SPEC-019) mas o fluxo vivia por disciplina. Esta release o faz **rodar**.
|
|
141
|
+
|
|
142
|
+
### Adicionado
|
|
143
|
+
- **`orchestrate` / `orchestrate:status` / `orchestrate:advance`** (SPEC-021, ADR-0031): a cadeia
|
|
144
|
+
SDD/GSD (spec→plan→tasks→implement→review) como **máquina de estados guardada por gates**. Cada
|
|
145
|
+
etapa abre com um handoff ADR-0005 para o dono do papel; `advance` só fecha a etapa se o artefato
|
|
146
|
+
SDD estiver aprovado **e** o gate da transição sair verde — pular etapa é bloqueado pela máquina,
|
|
147
|
+
não pela memória. O framework orquestra e guarda; o agente (IA ou humano) executa. Estado em
|
|
148
|
+
`<cwd>/.context/orchestrate-<slug>.json`; roda no framework e em projetos consumidores.
|
|
149
|
+
- `commands-documented` ganha fallback para comandos **sem dois-pontos** (grep literal de nome
|
|
150
|
+
conhecido) — `orchestrate` é o primeiro do registry.
|
|
151
|
+
|
|
152
|
+
### Corrigido
|
|
153
|
+
- **Backend gerado compila em Node 26**: o template pinava `better-sqlite3 ^11` (sem prebuild para
|
|
154
|
+
Node novo); alinhado ao do framework (`^12`). Fecha o caveat da v1.6.0 — `check:all --full` verde.
|
|
155
|
+
- **Roadmap defasado**: o `release-auditor` já consumia o gate (ADR-0024); refresh da tabela
|
|
156
|
+
(+ `consumer-spec-new`) e checkboxes marcados nos READMEs.
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## [1.6.2] — 2026-07-21 — Correção: `spec:new` em projetos consumidores
|
|
161
|
+
|
|
162
|
+
### Corrigido
|
|
163
|
+
- **`forja spec:new` num projeto consumidor escrevia a spec DENTRO de `node_modules/forjajs/dist`**
|
|
164
|
+
e falhava com "template ausente". Duas causas: o dispatcher spawnava os filhos com `cwd` = raiz do
|
|
165
|
+
pacote (agora usa o cwd de quem invocou — uma CLI opera onde é chamada), e o `spec-cli` resolvia
|
|
166
|
+
templates e destino por uma raiz só (agora separa `pkgRoot`, de onde vêm os templates, de
|
|
167
|
+
`targetRoot`, onde as specs nascem). Framework inalterado.
|
|
168
|
+
- Sem `.gitignore` ou sem bloco de allowlist: silêncio em vez de aviso — num consumidor esse é o
|
|
169
|
+
estado saudável (specs versionadas normalmente).
|
|
170
|
+
|
|
171
|
+
### Adicionado
|
|
172
|
+
- **Gate `consumer-spec-new`** no `release:check`: roda `spec:new` na instalação limpa e reprova se a
|
|
173
|
+
spec não nascer no projeto do consumidor ou vazar para dentro do pacote. O smoke pegava "não
|
|
174
|
+
carrega"; este pega "opera no mundo errado".
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
## [1.6.1] — 2026-07-20 — Correção: `project:upgrade` no pacote publicado
|
|
179
|
+
|
|
180
|
+
### Corrigido
|
|
181
|
+
- **`project:upgrade` quebrava com `Cannot find module .../create-memory-nest-kit.ts`** no pacote
|
|
182
|
+
instalado. O spawn do gerador cravava a extensão `.ts`; em dev funciona, mas o `dist/` publicado
|
|
183
|
+
tem `.js`. Agora resolve dinamicamente via `resolveScript` (`.ts` em dev, `.js` no publicado). O
|
|
184
|
+
`project:smoke` tinha o mesmo defeito, também corrigido. Teste de regressão guarda a classe.
|
|
185
|
+
|
|
186
|
+
---
|
|
187
|
+
|
|
188
|
+
## [1.6.0] — 2026-07-20 — A orquestração coerente e a governança num comando
|
|
189
|
+
|
|
190
|
+
A governança do framework ganha um ponto de entrada e o namesake — orquestração multiagente — deixa
|
|
191
|
+
de viver por prosa.
|
|
192
|
+
|
|
193
|
+
### Adicionado
|
|
194
|
+
- **`check:all`** (SPEC-020): roda a **bateria inteira de gates** e dá um veredito só. Tier barato:
|
|
195
|
+
coerência (`tools:doctor`) + `project:smoke`; `--full`: + tarball (`release:check`) + build do
|
|
196
|
+
gerado. Compõe os runners existentes — zero check reimplementado. "A casa está coerente?" num
|
|
197
|
+
comando, não num checklist lembrado.
|
|
198
|
+
- **`agent-topology`** (check no `tools:doctor`, SPEC-019): a topologia de orquestração é descrita em
|
|
199
|
+
três fontes (`VALID_AGENTS`, `.claude/agents/*.md`, `AGENTS.md`) e pode divergir em silêncio. O
|
|
200
|
+
check as cruza e reprova quando não concordam. Pegou o `release-auditor` (sub-agent executável sem
|
|
201
|
+
rota) na 1ª execução — agora first-class no router e documentado (AGENTS.md §7).
|
|
202
|
+
|
|
203
|
+
### Corrigido / interno
|
|
204
|
+
- **`generators.test` migrado para `node:test`**: o harness custom legado não contava suas falhas no
|
|
205
|
+
tally do CI e vazava um `/tmp` por execução (588 diretórios acumulados). Agora é `node:test` com
|
|
206
|
+
cleanup — falha derruba o CI de verdade.
|
|
207
|
+
|
|
208
|
+
---
|
|
209
|
+
|
|
210
|
+
## [1.5.0] — 2026-07-19 — A memória como sistema fechado: medir → entregar → proteger → propagar
|
|
211
|
+
|
|
212
|
+
A economia de token do Forja sempre foi a memória persistente (ADR-0009), mas era uma promessa. Esta
|
|
213
|
+
release a torna um ciclo completo e verificável — cada peça fecha um elo.
|
|
214
|
+
|
|
215
|
+
### Adicionado
|
|
216
|
+
- **`code:context <domínio>`** (SPEC-016): **entrega** o mapa da memória como pacote pronto para
|
|
217
|
+
colar (o `context.md`), com `--code` para o código da fatia e o custo em token à mostra. É o −61%
|
|
218
|
+
medido no `token:economy` virado ferramenta. Compõe com `code:impact` para o blast radius.
|
|
219
|
+
- **`memory:audit`** (SPEC-017): **protege** o mapa nas duas direções — reprova se um `context.md`
|
|
220
|
+
cita código que não existe (mapa que mente é pior que mapa nenhum) e avisa sobre módulo de código
|
|
221
|
+
sem mapa (economia perdida em silêncio). O `adr-refs` aplicado aos mapas de memória.
|
|
222
|
+
- **`token:economy --project <path>`**: mede o eixo memória nos **domínios reais do usuário** (mapa
|
|
223
|
+
vs código, por domínio) — o número fica dele, não da fixture.
|
|
224
|
+
- **`project:upgrade`** (SPEC-018): a metade que faltava do scaffolder. Traz peças novas de scaffold
|
|
225
|
+
para um projeto já gerado — **aditivo, nunca sobrescreve** (o código do usuário é intocável).
|
|
226
|
+
Dry-run por padrão; `--apply` copia.
|
|
227
|
+
- **O projeto gerado herda o gate** (ADR-0030): o gerador emite `scripts/check-memory-maps.mjs`, um
|
|
228
|
+
`memory:audit` self-contained (Node puro, zero dep), e o `project:smoke` prova a propagação. O
|
|
229
|
+
invariante da coerência mapa↔código passa a viajar com cada projeto.
|
|
230
|
+
|
|
231
|
+
### Nota
|
|
232
|
+
- Comandos e gates novos do framework; nada muda para projetos já gerados até rodarem `project:upgrade`.
|
|
233
|
+
|
|
234
|
+
---
|
|
235
|
+
|
|
236
|
+
## [1.4.0] — 2026-07-19 — Governança que mede: gate do gerador, economia de token e integridade de ADR
|
|
237
|
+
|
|
238
|
+
Três fronteiras que viviam por disciplina viram harness — e cada uma provou seu valor pegando um
|
|
239
|
+
problema real na estreia.
|
|
240
|
+
|
|
241
|
+
### Adicionado
|
|
242
|
+
- **`project:smoke`** (SPEC-015, ADR-0029): o gate do projeto gerado. Gera um projeto num tmp isolado
|
|
243
|
+
e prova que é coerente — zero placeholder `{{...}}` vazado, `package.json` válido, estrutura íntegra
|
|
244
|
+
(reusa o `structure-validator`). Tier `--full` (opt-in): `npm install` + `npm run build` do backend
|
|
245
|
+
gerado. É o `release:check` da saída do gerador, um nível acima do tarball.
|
|
246
|
+
- **`token:economy`** (fecha a dívida do ADR-0027; mede ADR-0009): mede a economia de token em dois
|
|
247
|
+
eixos, com file-sets explícitos. **Eixo arquitetura** (clean vs flat, mesma feature): camadas
|
|
248
|
+
custam **+56%** numa feature pequena — a versão ingênua de "Clean Architecture economiza tokens"
|
|
249
|
+
não se sustenta. **Eixo memória** (frio vs quente): o `context.md` (mapa) faz o contexto mínimo
|
|
250
|
+
custar **−61%** vs varrer a fatia no frio — e isso **compõe** a cada tarefa. A economia do Forja é
|
|
251
|
+
da memória persistente, amortizada no tempo, não das camadas. Narrativa corrigida no
|
|
252
|
+
`WHEN-CLEAN-WHEN-LEAN.md` e no ADR-0027.
|
|
253
|
+
- **`adr-refs`** (check no `tools:doctor`, ADR-0025): toda citação `ADR-NNNN` aponta para um ADR que
|
|
254
|
+
existe. Na 1ª execução pegou o `ADR-0026` pendurado (citado pela SPEC-012, nunca escrito) — fechado
|
|
255
|
+
escrevendo o **ADR-0026** (arquitetura da migração TS: resolver, runtime duplo, gate-builda-dist).
|
|
256
|
+
|
|
257
|
+
### Nota
|
|
258
|
+
- Nada muda para quem já tem projetos gerados; são comandos e gates novos do framework.
|
|
259
|
+
|
|
260
|
+
---
|
|
261
|
+
|
|
262
|
+
## [1.3.2] — 2026-07-19 — Migração TypeScript concluída (interno)
|
|
263
|
+
|
|
264
|
+
**Sem mudança para quem instala** — o `dist/*.js` publicado é idêntico ao da 1.3.1. Fecha a SPEC-012.
|
|
265
|
+
|
|
266
|
+
### Alterado (interno)
|
|
267
|
+
- **Fonte 100% TypeScript**: os 16 `.js` restantes (entries públicos `init-project`/
|
|
268
|
+
`create-memory-nest-kit`, generators, validators, `context-builder`, scaffolding) viraram `.ts`.
|
|
269
|
+
- **`noImplicitAny: true`** — o ratchet está armado: daqui pra frente todo parâmetro novo precisa de
|
|
270
|
+
tipo explícito. Os ~285 params existentes foram anotados (tipo real onde agrega, `any` explícito
|
|
271
|
+
onde o valor é dinâmico). Os checks de `health`/`release` viram `Check[]` de verdade.
|
|
272
|
+
- Shim `lib/vendor.d.ts` para o `better-sqlite3` (sem tipos publicados); `lib/templates` fora do
|
|
273
|
+
type-check (é conteúdo copiado, não código do framework).
|
|
274
|
+
- Correção pega pelo `release:check`: um sed havia corrompido o array de fallback do `resolveScript`
|
|
275
|
+
(`['.ts','.js','.mjs']`→`['.ts','.ts','.ts']`), quebrando a resolução do `dist/*.js`.
|
|
276
|
+
|
|
277
|
+
---
|
|
278
|
+
|
|
279
|
+
## [1.3.1] — 2026-07-19 — Migração TypeScript dos módulos do framework (interno)
|
|
280
|
+
|
|
281
|
+
**Sem mudança para quem instala** — o `dist/*.js` publicado é idêntico ao da 1.3.0. A conversão é
|
|
282
|
+
interna: fecha a renomeação leaf-first da SPEC-012 Fase 2.
|
|
283
|
+
|
|
284
|
+
### Alterado (interno)
|
|
285
|
+
- **Todos os 21 módulos `.mjs` do framework** (`bin/forja`, `lib/{audit,governance-report,workspace}`,
|
|
286
|
+
todos os `scripts/` incluindo os 4 hooks) convertidos para `.ts`, com ~130 anotações de tipo. Os
|
|
287
|
+
typedefs JSDoc viraram `interface`; os casts-comentário `/** @type */ (x)` viraram `as`.
|
|
288
|
+
- Dev e CI rodam a fonte `.ts` (Node ≥22.6); o `ci.yml` invoca `bin/forja.ts`. O publicado segue
|
|
289
|
+
`dist/*.js` (Node ≥20), provado pelo `release-gate`.
|
|
290
|
+
- **Fora desta fatia** (deliberado): os 16 `.js` (entries públicos + generators + scaffolding), que
|
|
291
|
+
seguem no checkJs, e `noImplicitAny: true` (endurecimento final).
|
|
292
|
+
|
|
293
|
+
---
|
|
294
|
+
|
|
295
|
+
## [1.3.0] — 2026-07-19 — Governança visível e o núcleo em TypeScript
|
|
296
|
+
|
|
297
|
+
Duas frentes que amadurecem o framework: a governança sai do arquivo que ninguém abre para
|
|
298
|
+
**consultável e visível**, e o motor de invariantes (`lib/core/`) passa a ser **TypeScript de
|
|
299
|
+
verdade**, com o pacote publicando `dist/` compilado.
|
|
300
|
+
|
|
301
|
+
### Adicionado
|
|
302
|
+
- **Auditoria consultável + painel de governança** (SPEC-014, ADR-0028): `audit:sync` projeta o
|
|
303
|
+
`.context/forja-runs.jsonl` na tabela `audit_runs` (idempotente por `line_hash` — o `.jsonl` segue
|
|
304
|
+
sendo a fonte de verdade); `audit:query` filtra a trilha por `--failed`/`--cmd`/`--since`/`--gate`;
|
|
305
|
+
`governance:dashboard` gera um HTML **estático e self-contained** (sem servidor — a lição do
|
|
306
|
+
ADR-0022) com o estado de specs, ADRs, gates e métricas.
|
|
307
|
+
- **`lib/core/` em TypeScript** (SPEC-012 Fase 2, leaf-first): `checks`, `health`, `release`,
|
|
308
|
+
`doc-graph` e `registry` viram `.ts` com `interface Check/Probe/Result` reais. Dev roda `.ts`
|
|
309
|
+
nativo (Node ≥22.6); o publicado embarca `dist/*.js` (Node ≥20).
|
|
310
|
+
|
|
311
|
+
### Alterado
|
|
312
|
+
- **O pacote publica `dist/` compilado** (SPEC-012 Fase 3): `bin`/`files[]` apontam para `dist/`. O
|
|
313
|
+
`release:check` **builda o `dist/` antes de empacotar**, então o tarball provado é exatamente o
|
|
314
|
+
publicado — sem step de build no CI, sem `dist/` no git, sem janela de staleness.
|
|
315
|
+
- **CI**: o job `test` roda em Node 22.x/24.x (a fonte `.ts` exige strip-types ≥22.6). O suporte a
|
|
316
|
+
Node 20 do pacote publicado (que é `dist/*.js`) segue provado pelo job `release-gate`.
|
|
317
|
+
|
|
318
|
+
---
|
|
319
|
+
|
|
320
|
+
## [1.2.0] — 2026-07-18 — Boilerplate Clean Architecture, coerência de doc e correções
|
|
321
|
+
|
|
322
|
+
Feature nova (um boilerplate), o terceiro gate de invariante (coerência da documentação), e
|
|
323
|
+
**correções de dois bugs vivos na 1.1.6** que o TypeScript achou. A migração TS avançou até o
|
|
324
|
+
pipeline de build provado — mas continua publicando a fonte `.mjs` (a troca para `dist/` é interna
|
|
325
|
+
e fica para uma release futura).
|
|
326
|
+
|
|
327
|
+
### Corrigido
|
|
328
|
+
- **`npm run dev` estava quebrado** na 1.1.6: `scripts/dev.mjs` chamava `spawn()` sem importar —
|
|
329
|
+
`ReferenceError` em três caminhos (agent-harness, compress-memory, create-memory-nest-kit).
|
|
330
|
+
- **`context:budget` / `catalog:assets` estavam quebrados** na 1.1.6: `scripts/context-ops.mjs`
|
|
331
|
+
importava `dbPath` (inexistente; só há `getDbPath`) e o usava em `new Database(dbPath)`.
|
|
332
|
+
- Typedefs `Check`/`Result` duplicados e divergentes em `health.mjs` (resíduo da extração do runner).
|
|
333
|
+
- 22 links relativos quebrados em docs legadas (personas, quick-reference, structure).
|
|
334
|
+
|
|
335
|
+
### Adicionado
|
|
336
|
+
- **Boilerplate `06-clean-arch`** (SPEC-013, ADR-0027): DDD por camadas onde se paga, caminho enxuto
|
|
337
|
+
onde não. Fatia rica (Orders) com inversão de dependência e invariante testável sem subir o Nest;
|
|
338
|
+
caminho enxuto (Products) lado a lado; `WHEN-CLEAN-WHEN-LEAN.md` com o critério; memória por
|
|
339
|
+
bounded context. A economia de token é reportada com honestidade (argumentada, não provada — o
|
|
340
|
+
benchmark é follow-up).
|
|
341
|
+
- **Gate de coerência da documentação** (SPEC-011, ADR-0025): `lib/core/doc-graph.mjs` + três checks
|
|
342
|
+
no `health.mjs` — `docs-commands` (critical: todo `forja <cmd>` citado existe no registry),
|
|
343
|
+
`commands-documented` e `docs-links` (warn). Rodam no `tools:doctor` e no CI.
|
|
344
|
+
- **Resolver de script agnóstico de extensão** (SPEC-012): `resolveScript` desacopla o registry da
|
|
345
|
+
extensão (`.ts → .js → .mjs`), preparando a migração TS. Backward-compatible.
|
|
346
|
+
|
|
347
|
+
### Interno
|
|
348
|
+
- **TypeScript como gate** (SPEC-012, Fases 0-1): `checkJs` estrito sobre a fonte `.mjs`,
|
|
349
|
+
`types:check` no CI, contratos do núcleo (`Check`/`Probe`/`Result`) tipados. Pipeline de build
|
|
350
|
+
(`tsc → dist`) provado; a publicação de `dist/` e a renomeação `.mjs → .ts` ficam para depois.
|
|
351
|
+
|
|
352
|
+
### Nota
|
|
353
|
+
- O `docs-links` pegou o **próprio autor**: um erro de profundidade relativa (`../../` vs `../../../`)
|
|
354
|
+
na correção dos links foi detectado pelo doctor antes do commit. E o `release:check` pegou o
|
|
355
|
+
acoplamento do dist-publish (código em `dist/scripts`, não `scripts/`) antes de qualquer publish.
|
|
356
|
+
|
|
357
|
+
## [1.1.6] — 2026-07-14 — README em inglês
|
|
358
|
+
|
|
359
|
+
A vitrine do pacote passa a ter versão em inglês, para alcançar quem chega pelo npm.
|
|
360
|
+
|
|
361
|
+
### Adicionado
|
|
362
|
+
- `README.en.md` — adaptação fiel do README em português, no estilo canônico `forja <comando>`.
|
|
363
|
+
Seletor de idioma no topo dos dois arquivos. Incluído no `files[]` do pacote.
|
|
364
|
+
|
|
365
|
+
### Nota
|
|
366
|
+
- A **documentação** (`docs/`) permanece em pt-BR — é parte da identidade do projeto. Só a capa
|
|
367
|
+
ganhou inglês. O README inglês foi verificado contra o registry: zero comandos inexistentes,
|
|
368
|
+
zero links quebrados.
|
|
369
|
+
|
|
370
|
+
## [1.1.5] — 2026-07-14 — O comando é forja
|
|
371
|
+
|
|
372
|
+
A documentação pública ainda falava a língua interna do repo: `npm run x -- args` onde o usuário
|
|
373
|
+
do pacote tem `forja x args`. Esta versão alinha o que o README promete com o que o binário faz.
|
|
374
|
+
|
|
375
|
+
### Corrigido
|
|
376
|
+
|
|
377
|
+
- **README inteiro migrado para `forja` como forma canônica** — os scripts npm continuam
|
|
378
|
+
existindo como aliases do repo clonado, mas deixam de ser a vitrine.
|
|
379
|
+
- **Exemplos do "60 segundos" estavam quebrados**: `forja gsd:handoff -- plan …` passa o `--`
|
|
380
|
+
cru para o script (o core não filtra separador) e o comando falha. O `--` só era necessário
|
|
381
|
+
na forma `npm run`; removido dos exemplos diretos.
|
|
382
|
+
- **Comando errado na lista de essenciais**: validar projeto do workspace é
|
|
383
|
+
`workspace:project:check <nome>`, não `project:check <nome>` (que é o standards check do framework).
|
|
384
|
+
- **Links mortos**: `projects/ai-engineering-from-scratch-main/` não existe no repo;
|
|
385
|
+
`docs/capacidades-externas.md` agora aponta para as fontes upstream (ADR-0016) e a
|
|
386
|
+
reinstalação segue a prescrição do `tools:doctor` (`npm i -g @codegraph/cli`) em vez do
|
|
387
|
+
symlink manual antigo.
|
|
388
|
+
- **`package-lock.json` preso em 1.1.3** desde o bump da 1.1.4; sincronizado.
|
|
389
|
+
|
|
390
|
+
### Adicionado
|
|
391
|
+
|
|
392
|
+
- Seção "Comandos essenciais" do README ampliada com o que já existia no registry mas não
|
|
393
|
+
aparecia: `gsd:plan`/`gsd:check`, `code:check`/`code:impact`, `memory:compress`,
|
|
394
|
+
`tools:doctor`, `release:check --publish`.
|
|
395
|
+
- `allowScripts` no `package.json`: instalações com política allow-scripts ativa deixam de
|
|
396
|
+
bloquear silenciosamente o prebuild do `better-sqlite3` — exatamente o modo de falha que
|
|
397
|
+
matava a memória (ADR-0023).
|
|
398
|
+
|
|
399
|
+
---
|
|
400
|
+
|
|
401
|
+
## [1.1.4] — 2026-07-14 — Os gates
|
|
402
|
+
|
|
403
|
+
Duas fronteiras do framework funcionavam por disciplina, e a disciplina falhou nas duas. Esta versão
|
|
404
|
+
as fecha com gates executáveis — e, pela primeira vez, com **prova**: os bugs históricos foram
|
|
405
|
+
reintroduzidos um a um, e o gate reprovou cada um deles.
|
|
406
|
+
|
|
407
|
+
> "Uma regra que depende de memória não é uma regra; é uma sugestão." — ADR-0021
|
|
408
|
+
|
|
409
|
+
### O que muda para quem usa
|
|
410
|
+
|
|
411
|
+
- **`npm publish` está bloqueado** se a instalação limpa não funcionar (`prepublishOnly` → ADR-0024).
|
|
412
|
+
- **`tools:doctor` reprova** (exit 1) quando o núcleo está quebrado — antes ele auditava só
|
|
413
|
+
ferramentas opcionais e saía com 0 mesmo com a memória morta (ADR-0023).
|
|
414
|
+
- Quando algo quebra, a saída traz **o comando que corrige**, não um stack trace.
|
|
415
|
+
|
|
416
|
+
### Adicionado
|
|
417
|
+
|
|
418
|
+
- **`lib/core/health.mjs`** — saúde do núcleo como dados: ABI do `better-sqlite3`, memória, índice,
|
|
419
|
+
workspace, `engines`, deps de runtime, `.mcp.json`. Fonte única do `tools:doctor` e do hook
|
|
420
|
+
`SessionStart` (ADR-0023).
|
|
421
|
+
- **`lib/core/release.mjs` + `release:check`** — o gate do tarball. Empacota, instala num diretório
|
|
422
|
+
isolado e **executa** os comandos. Grep não prova ausência; instalação prova (ADR-0024).
|
|
423
|
+
- **`lib/core/checks.mjs`** — runner compartilhado. Uma máquina, dois catálogos: um guarda o repo,
|
|
424
|
+
outro guarda o pacote publicado.
|
|
425
|
+
- **CI**: `tools:doctor` na matriz de Nodes e `release:check` em job próprio. A evidência do release
|
|
426
|
+
passa a viver no log do CI, não na memória de quem publica.
|
|
427
|
+
- `spec:new` mantém a allow-list do `.gitignore` — toda spec nova do framework nascia invisível ao git.
|
|
428
|
+
|
|
429
|
+
### Corrigido
|
|
430
|
+
|
|
431
|
+
- **A memória morria em silêncio.** Com o `better-sqlite3` compilado contra outra major do Node,
|
|
432
|
+
`query:universal`, `sync:universal`, `context:smart`, `agent:route` e `memory:compress` ficavam
|
|
433
|
+
todos inoperantes — e o `SessionStart` prescrevia `npm install`, que **não** recompila binário
|
|
434
|
+
nativo. A correção é `npm rebuild better-sqlite3`, e agora é isso que o framework diz.
|
|
435
|
+
- **`docs/token-optimization.md` mandava rodar quatro comandos inexistentes** (`context:build`,
|
|
436
|
+
`memory:db:reindex`, `memory:db:stats`, `cache:clear`) e linkava um `DEPLOYMENT.md` que nunca
|
|
437
|
+
existiu. É o documento que ensina a economia de tokens (ADR-0009) — um agente obediente executava
|
|
438
|
+
fantasmas.
|
|
439
|
+
- **O Governance não conhecia os gates**: descrevia o `tools:doctor` pela definição anterior ao
|
|
440
|
+
ADR-0023 e ignorava o `release:check`.
|
|
441
|
+
- `runtime-deps` passava por sorte: os geradores emitem `import … from '@nestjs/common'` dentro de
|
|
442
|
+
template literal, e o parser contava como dependência do framework.
|
|
443
|
+
|
|
444
|
+
### Evidência
|
|
445
|
+
|
|
446
|
+
| Bug histórico | Reintroduzido → |
|
|
447
|
+
|---|---|
|
|
448
|
+
| `better-sqlite3` como `devDependency` (ADR-0021) | reprovado por **dois** checks independentes |
|
|
449
|
+
| `dashboard/` fora do `files[]` (v1.1.3) | reprovado: 4 comandos mortos, 19 imports sem destino |
|
|
450
|
+
| `otplib`/`qrcode` publicados sem existir no git (v1.1.1) | reprovado sob `--publish`; `npm publish` aborta |
|
|
451
|
+
|
|
452
|
+
**88 testes** (eram 28). ADR-0023 e ADR-0024. SPEC-009 e SPEC-010.
|
|
453
|
+
|
|
454
|
+
## [1.1.3] — 2026-07-09 — Dashboard congelado
|
|
455
|
+
|
|
456
|
+
SPEC-002 (`specs/agent-dashboard/`) passa a `abandoned`. O código permanece em `dashboard/`,
|
|
457
|
+
versionado e com os 68 testes verdes, mas deixa de ser superfície pública. Ver
|
|
458
|
+
ADR-0022 (`memory/90-decisions/0022-congelar-dashboard-web.md`) para rationale e condições de retomada.
|
|
459
|
+
|
|
460
|
+
### Corrigido
|
|
461
|
+
- **Bug de release**: `docs/dashboard.md` e o script `npm run dashboard` eram publicados no npm,
|
|
462
|
+
mas a pasta `dashboard/` nunca esteve no `files[]`. Quem instalava o pacote recebia a documentação
|
|
463
|
+
e o comando, sem o código. Ambos saíram do tarball.
|
|
464
|
+
- `README.md` descrevia o dashboard como "visão opcional read-only"; ele expõe rotas que executam
|
|
465
|
+
processos (`POST /api/workflow/:project/run/:role`). Descrição corrigida.
|
|
466
|
+
- `scripts/spec-cli.mjs` — `abandoned` é status válido, mas o `check` o rejeitava como incoerente
|
|
467
|
+
quando havia `plan.md`/`tasks.md`, derrubando o gate com exit 1. Agora é tratado como terminal,
|
|
468
|
+
junto de `done`.
|
|
469
|
+
|
|
470
|
+
### Removido
|
|
471
|
+
- Scripts `dashboard`, `dashboard:dev`, `dashboard:install`, `dashboard:web:dev` e
|
|
472
|
+
`dashboard:web:build` do `package.json` do root.
|
|
473
|
+
- `docs/dashboard.md` e `specs/agent-dashboard/` do `files[]` do pacote npm.
|
|
474
|
+
|
|
475
|
+
## [Unreleased] — Workspace separado
|
|
476
|
+
|
|
477
|
+
SPEC-028 (`specs/reestruturacao-forja-v2/`): separação do framework Forja do workspace de produção.
|
|
478
|
+
|
|
479
|
+
- `lib/workspace.mjs` — resolução centralizada do workspace (`FORJA_WORKSPACE` > `~/.forjarc.json` > `~/forja-workspace`).
|
|
480
|
+
- `bin/init-project.js` — projetos de produto obrigatoriamente em `~/forja-workspace/projects/<nome>`.
|
|
481
|
+
- `scripts/sync-universal-memory.js`, `query-universal-memory.js`, `build-smart-context.js`, `memory-schema.mjs` — memória universal (SQLite) movida para o workspace.
|
|
482
|
+
- `scripts/check-standards.js` — `npm run project:check <nome>` resolve projeto no workspace.
|
|
483
|
+
- `scripts/agent-harness.mjs` + `package.json` — comandos `workspace:init`, `project:new`, `project:list`, `workspace:project:check`.
|
|
484
|
+
- Documentação atualizada: `README.md`, `AGENTS.md`, `docs/init-project.md`, `docs/structure.md`.
|
|
485
|
+
- ADR-0019 (`memory/90-decisions/0019-workspace-separado.md`) documenta a decisão.
|
|
486
|
+
- `.gitignore` reforça que projetos de produto não entram no repo do framework.
|
|
487
|
+
|
|
488
|
+
## [Unreleased] — Dashboard local
|
|
489
|
+
|
|
490
|
+
SPEC-002 (`specs/agent-dashboard/`) implementada em 12 tasks (T1-T12).
|
|
491
|
+
|
|
492
|
+
- `dashboard/server/` — Fastify 5 com 7 rotas (specs, handoffs, projects, tokens, commands SSE, briefing, health)
|
|
493
|
+
- `dashboard/web/` — Vite + React + Tailwind + Recharts; 6 telas; bundle 166KB gzip (NFR < 500KB ✓)
|
|
494
|
+
- `dashboard/server/lib/` — allowlist hard-coded, run-command, spec-parser, briefing-parser, token-estimator
|
|
495
|
+
- Scripts: `npm run dashboard`, `dashboard:dev`, `dashboard:install`, `dashboard:web:build`
|
|
496
|
+
- **60 testes verde** (55 dashboard + 5 root)
|
|
497
|
+
- `docs/dashboard.md` cobre uso, allowlist, troubleshooting, segurança
|
|
498
|
+
|
|
499
|
+
## [v1.1] — 2026-05-10 — Refator SDD + Orquestração
|
|
500
|
+
|
|
501
|
+
### Frente 1 — Cleanup + ADRs
|
|
502
|
+
- 13 relatórios históricos movidos para `docs/archive/`
|
|
503
|
+
- 4 guias úteis migrados para `docs/{structure,init-project,examples,publishing}.md`
|
|
504
|
+
- 2 exemplos antigos arquivados em `docs/archive/examples/`
|
|
505
|
+
- Monolito bin (1486 LOC) preservado em `docs/archive/legacy-bin/`
|
|
506
|
+
- `DOC-MAP.md` reescrito (204 → 50 linhas)
|
|
507
|
+
- 6 ADRs criados a partir de decisões dispersas (`memory/90-decisions/0001-0006`)
|
|
508
|
+
|
|
509
|
+
### Frente 2 — Bins e exemplos consolidados
|
|
510
|
+
- `bin/create-memory-nest-kit-v2.js` promovido a oficial (substituiu monolito)
|
|
511
|
+
- `package.json`: bin secundário, novos scripts `spec:*`, `agent:route`, `memory:vacuum`
|
|
512
|
+
- `exemplo-v3` mantido como exemplo canônico
|
|
513
|
+
|
|
514
|
+
### Frente 3 — Pipeline SDD
|
|
515
|
+
- `specs/_templates/{spec,plan,tasks}.md`
|
|
516
|
+
- `scripts/spec-cli.mjs` com `new`/`plan`/`tasks`/`check` (4/4 testes verdes)
|
|
517
|
+
- ADR-0007 estabelece SDD como obrigatório para features não-triviais
|
|
518
|
+
- SPEC-001 (`specs/pipeline-sdd-e-orquestracao/`) é a meta-spec deste refator
|
|
519
|
+
|
|
520
|
+
### Frente 4 — Sub-agents executáveis
|
|
521
|
+
- 6 sub-agents em `.claude/agents/`: orchestrator, context-engineer, sdd-architect, product, marketing, governance
|
|
522
|
+
- 3 prompts portáveis novos em `prompts/`
|
|
523
|
+
- `scripts/agent-router.mjs` persiste handoffs em `universal.db.handoffs` (7 campos validados)
|
|
524
|
+
- ADR-0008 documenta migração handoff markdown → SQLite
|
|
525
|
+
- `AGENTS.md` reescrito
|
|
526
|
+
|
|
527
|
+
### Frente 5 — Hooks token-economy
|
|
528
|
+
- `.claude/settings.json` com hooks `SessionStart` e `UserPromptSubmit`
|
|
529
|
+
- `scripts/hook-session-start.mjs` injeta status de specs + handoffs abertos
|
|
530
|
+
- `scripts/hook-user-prompt.mjs` opt-in (`FRAMEWORK_HOOK_INJECT=1`), cache 30min, cap 4KB
|
|
531
|
+
- `scripts/pre-commit.sh` agora roda `spec:check` + `check-standards`
|
|
532
|
+
- ADR-0009 documenta trade-offs
|
|
533
|
+
- `.memoryrc.json` ganha seção `hooks`; `handoff` aponta para SQLite
|
|
534
|
+
|
|
535
|
+
---
|
|
536
|
+
|
|
537
|
+
## [v1.0] — 2026-05-02 — 4 Fases Estruturais
|
|
538
|
+
|
|
539
|
+
Detalhes completos em `docs/archive/PROJETO-COMPLETO.md`.
|
|
540
|
+
|
|
541
|
+
### Fase 1 — Arquitetura
|
|
542
|
+
- Monolito `bin/create-memory-nest-kit.js` (1486 LOC) refatorado em 5 módulos em `lib/`
|
|
543
|
+
- Orquestrador final: 125 LOC (redução de 91%)
|
|
544
|
+
- 1.820 LOC reutilizáveis em `lib/generators/`, `lib/validators/`, `lib/utils/`, `lib/context-builder.js`
|
|
545
|
+
- 7/7 testes passando; backward compatible
|
|
546
|
+
|
|
547
|
+
### Fase 2 — Documentação por Persona
|
|
548
|
+
- `docs/personas/{executive,architect,developer,qa}/` — guias estruturados
|
|
549
|
+
- `docs/quick-reference.md`, `docs/glossary.md`, `DOC-MAP.md`
|
|
550
|
+
- Onboarding reduzido em ~83% (medido em tempo de leitura)
|
|
551
|
+
|
|
552
|
+
### Fase 3 — Economia de Tokens
|
|
553
|
+
- `lib/context-builder.js` — API com 3 modos (`global`, `domain`, `task`), FTS5, cache LRU
|
|
554
|
+
- `scripts/compress-memory.mjs` — archive de runs > 30 dias, VACUUM
|
|
555
|
+
- `.memoryrc.json` — configuração centralizada
|
|
556
|
+
- `docs/token-optimization.md`, `scripts/token-benchmark.mjs`
|
|
557
|
+
- Redução estimada: 40-60% em tokens enviados ao modelo
|
|
558
|
+
|
|
559
|
+
### Fase 4 — Dev Workflow
|
|
560
|
+
- `scripts/dev.mjs` — CLI unificada (health/build-context/sprint/check)
|
|
561
|
+
- `scripts/pre-commit.sh` — validação automática
|
|
562
|
+
- `scripts/check-standards.js`, `scripts/generate-dashboard.js`
|
|
563
|
+
- 100% das operações cobertas por scripts npm
|
|
564
|
+
|
|
565
|
+
---
|
|
566
|
+
|
|
567
|
+
## [v0.x] — 2026-04 — Bootstrap
|
|
568
|
+
|
|
569
|
+
- Estrutura inicial `memory/` hierárquica (00-global a 90-decisions)
|
|
570
|
+
- `bin/create-memory-nest-kit.js` — scaffold inicial monolítico
|
|
571
|
+
- SQLite universal (`.memory/sqlite/universal.db`) com FTS5
|
|
572
|
+
- Scripts `sprint-manager.js`, `sync-universal-memory.js`, `query-universal-memory.js`
|
|
573
|
+
- AGENTS.md com topologia de 6 papéis
|
|
574
|
+
- `exemplo-projeto/`, `exemplo-v2/`, `exemplo-v3/` — outputs de referência
|