forjajs 2.0.2 → 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 -317
- package/README.pt-BR.md +345 -323
- 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/apps/server/src/main.d.ts +3 -2
- package/dist/apps/server/src/main.js +8 -6
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +22 -5
- 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 +64 -0
- package/dist/lib/core/registry.js +65 -0
- package/dist/lib/core/release.d.ts +63 -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-git/src/index.d.ts +2 -0
- package/dist/packages/adapter-git/src/index.js +22 -1
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/contracts/src/index.d.ts +1 -1
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/packages/plugin-docker/src/index.d.ts +3 -0
- package/dist/packages/plugin-docker/src/index.js +13 -0
- package/dist/packages/plugin-github/src/index.d.ts +3 -0
- package/dist/packages/plugin-github/src/index.js +13 -0
- package/dist/packages/sandbox/src/index.d.ts +2 -0
- package/dist/packages/sandbox/src/index.js +10 -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-benchmark.d.ts +2 -0
- package/dist/scripts/context-benchmark.js +39 -0
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.d.ts +15 -0
- package/dist/scripts/demo-autonomy.js +200 -0
- 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.d.ts +1 -0
- 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 -132
- 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 -0
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -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 -0
- 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 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
- package/memory/90-decisions/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 -0
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
- package/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 -140
- 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/docs/processo-projeto.md
CHANGED
|
@@ -1,138 +1,138 @@
|
|
|
1
|
-
# Processo de projeto com a IA — criar ou atualizar
|
|
2
|
-
|
|
3
|
-
Mapa de **nível 0**: como a demanda entra no framework e vira trabalho. Decide entre
|
|
4
|
-
**criar** um projeto novo e **atualizar** um existente; ambos convergem no ciclo
|
|
5
|
-
CLI-first de 6 etapas detalhado em [`docs/fluxo.md`](./fluxo.md).
|
|
6
|
-
|
|
7
|
-
> "Nossa IA" = os 6 papéis (`AGENTS.md`) operando via Claude Code, apoiados pelas 3
|
|
8
|
-
> capacidades do [ADR-0016](../memory/90-decisions/0016-integracao-capacidades-externas.md):
|
|
9
|
-
> **codegraph** (entender código), **harness** (desenhar time), **ai-engineering** (referência).
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
## Mapa de decisão
|
|
14
|
-
|
|
15
|
-
```mermaid
|
|
16
|
-
flowchart TD
|
|
17
|
-
D(["💡 Demanda"]) --> Q{"Projeto já<br/>existe?"}
|
|
18
|
-
|
|
19
|
-
%% ── Ramo A: NOVO ──
|
|
20
|
-
Q -- "Não" --> A1["A1· Gerar scaffold<br/>npm run init:project <nome> --ai claude,copilot"]
|
|
21
|
-
A1 --> A2["A2· Escolher boilerplate<br/>api-rest · saas · ecommerce · microservices · monorepo"]
|
|
22
|
-
A2 --> A3["A3· (opcional) harness<br/>desenha o time de agentes do domínio"]
|
|
23
|
-
A3 --> C0
|
|
24
|
-
|
|
25
|
-
%% ── Ramo B: EXISTENTE ──
|
|
26
|
-
Q -- "Sim" --> B0{"Já tem<br/>memory/?"}
|
|
27
|
-
B0 -- "Não" --> B1["B1· Overlay de memória<br/>init:project detecta backend → --only-memory"]
|
|
28
|
-
B0 -- "Sim" --> B2["B2· Indexar código<br/>codegraph init (entender o que existe)"]
|
|
29
|
-
B1 --> B2
|
|
30
|
-
B2 --> C0
|
|
31
|
-
|
|
32
|
-
%% ── Convergência: ciclo SDD+GSD ──
|
|
33
|
-
C0(["▶ Entra no ciclo CLI-first"]) --> CICLO
|
|
34
|
-
subgraph CICLO["docs/fluxo.md — 6 etapas"]
|
|
35
|
-
direction LR
|
|
36
|
-
c1["1·Entender"] --> c2["2·Especificar"] --> c3["3·Arquitetar"] --> c4["4·Decompor"] --> c5["5·Implementar"] --> c6["6·Governar"]
|
|
37
|
-
end
|
|
38
|
-
CICLO --> OUT(["✅ Entrega + memória atualizada"])
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
### Fallback ASCII
|
|
42
|
-
|
|
43
|
-
```
|
|
44
|
-
💡 Demanda
|
|
45
|
-
│
|
|
46
|
-
├─ projeto NÃO existe ─► A1 init:project <nome> --ai …
|
|
47
|
-
│ A2 escolher boilerplate
|
|
48
|
-
│ A3 (opc.) harness desenha o time ─┐
|
|
49
|
-
│ │
|
|
50
|
-
└─ projeto JÁ existe ──► tem memory/? │
|
|
51
|
-
├─ não ► B1 overlay --only-memory │
|
|
52
|
-
└─ sim ─┘ │
|
|
53
|
-
B2 codegraph init ────────┤
|
|
54
|
-
▼
|
|
55
|
-
▶ CICLO (docs/fluxo.md):
|
|
56
|
-
1·Entender → 2·Especificar → 3·Arquitetar
|
|
57
|
-
→ 4·Decompor → 5·Implementar → 6·Governar ─► ✅
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
---
|
|
61
|
-
|
|
62
|
-
## Ramo A — Criar projeto novo
|
|
63
|
-
|
|
64
|
-
O gerador (`bin/init-project.js`) roda 8 passos: git-init → estrutura agentes+memória
|
|
65
|
-
→ design-lib → instruções multi-IA → install-backend → init memória SQLite →
|
|
66
|
-
context-pack → next-steps. Cada projeto nasce com `memory/`, `.ia-instructions/`
|
|
67
|
-
(claude/copilot/gemini/codex) e seu próprio banco de memória.
|
|
68
|
-
|
|
69
|
-
Projetos de produto vivem no **workspace Forja** (`~/forja-workspace/projects/<nome>`
|
|
70
|
-
por padrão), fora do repo do framework. Veja ADR-0019.
|
|
71
|
-
|
|
72
|
-
```bash
|
|
73
|
-
# 1. preparar workspace (uma vez)
|
|
74
|
-
npm run workspace:init
|
|
75
|
-
|
|
76
|
-
# 2. gerar (cria em ~/forja-workspace/projects/<nome>)
|
|
77
|
-
npm run project:new <nome> -- --ai claude,copilot,gemini
|
|
78
|
-
|
|
79
|
-
# 3. (opcional) escolher boilerplate de stack
|
|
80
|
-
ls boilerplates/ # 01-api-rest · 02-saas-starter · 03-ecommerce · 04-microservices · 05-monorepo
|
|
81
|
-
|
|
82
|
-
# 4. (opcional) na sessão Claude Code, desenhar o time de agentes do domínio:
|
|
83
|
-
# "build a harness for this project" → gera .claude/agents + .claude/skills
|
|
84
|
-
|
|
85
|
-
# 5. entrar no ciclo: começa pela spec
|
|
86
|
-
npm run spec:new -- <slug>
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
---
|
|
90
|
-
|
|
91
|
-
## Ramo B — Atualizar projeto existente
|
|
92
|
-
|
|
93
|
-
```bash
|
|
94
|
-
# B1. projeto sem memória ainda? sobrepõe só a camada de memória/agentes
|
|
95
|
-
# (init:project detecta backend e aplica --only-memory automaticamente)
|
|
96
|
-
npm run init:project <nome> # apontando para o projeto existente
|
|
97
|
-
|
|
98
|
-
# B2. indexar o código atual ANTES de mexer (entender sem ler arquivo a arquivo)
|
|
99
|
-
codegraph init # ou: npm run code:index
|
|
100
|
-
codegraph explore "<área a mudar>"
|
|
101
|
-
|
|
102
|
-
# entra no ciclo pela spec da mudança
|
|
103
|
-
npm run spec:new -- <slug>
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
A diferença essencial do ramo B é a **etapa 1 (Entender) com codegraph**: antes de
|
|
107
|
-
especificar a mudança, mapeie símbolos, callers e impacto no código que já existe.
|
|
108
|
-
|
|
109
|
-
---
|
|
110
|
-
|
|
111
|
-
## Convergência — o ciclo (resumo)
|
|
112
|
-
|
|
113
|
-
Os dois ramos terminam no mesmo ciclo de 6 etapas. Quem dirige cada uma:
|
|
114
|
-
|
|
115
|
-
| # | Etapa | Papel | Capacidade |
|
|
116
|
-
|---|-------|-------|------------|
|
|
117
|
-
| 1 | Entender | context-engineer | codegraph · ai-engineering |
|
|
118
|
-
| 2 | Especificar | product | — |
|
|
119
|
-
| 3 | Arquitetar | sdd-architect | harness · ADR |
|
|
120
|
-
| 4 | Decompor | sdd-architect | — |
|
|
121
|
-
| 5 | Implementar | orchestrator + worker | codegraph (MCP) |
|
|
122
|
-
| 6 | Governar | governance | codegraph (`affected`) |
|
|
123
|
-
|
|
124
|
-
Detalhe de comandos por etapa, handoffs (7 campos, ADR-0005) e o papel do dashboard
|
|
125
|
-
opcional: **[`docs/fluxo.md`](./fluxo.md)**.
|
|
126
|
-
|
|
127
|
-
---
|
|
128
|
-
|
|
129
|
-
## Onde "nossa IA" age em cada ramo
|
|
130
|
-
|
|
131
|
-
- **Novo projeto:** a IA gera o scaffold, e o **harness** desenha o time de agentes
|
|
132
|
-
inicial sob medida para o domínio. ai-engineering fundamenta escolhas técnicas.
|
|
133
|
-
- **Projeto existente:** **codegraph** dá à IA o mapa do código atual (símbolos,
|
|
134
|
-
call paths, testes afetados) — é o que evita refator às cegas. O overlay
|
|
135
|
-
`--only-memory` dá ao projeto a camada de memória/agentes sem tocar no código.
|
|
136
|
-
- **Sempre:** memória e contexto são transversais (`sync:universal`,
|
|
137
|
-
`query:universal`, `context:smart`) e cada handoff entre papéis fica registrado em
|
|
138
|
-
`~/forja-workspace/memory/sqlite/universal.db`.
|
|
1
|
+
# Processo de projeto com a IA — criar ou atualizar
|
|
2
|
+
|
|
3
|
+
Mapa de **nível 0**: como a demanda entra no framework e vira trabalho. Decide entre
|
|
4
|
+
**criar** um projeto novo e **atualizar** um existente; ambos convergem no ciclo
|
|
5
|
+
CLI-first de 6 etapas detalhado em [`docs/fluxo.md`](./fluxo.md).
|
|
6
|
+
|
|
7
|
+
> "Nossa IA" = os 6 papéis (`AGENTS.md`) operando via Claude Code, apoiados pelas 3
|
|
8
|
+
> capacidades do [ADR-0016](../memory/90-decisions/0016-integracao-capacidades-externas.md):
|
|
9
|
+
> **codegraph** (entender código), **harness** (desenhar time), **ai-engineering** (referência).
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Mapa de decisão
|
|
14
|
+
|
|
15
|
+
```mermaid
|
|
16
|
+
flowchart TD
|
|
17
|
+
D(["💡 Demanda"]) --> Q{"Projeto já<br/>existe?"}
|
|
18
|
+
|
|
19
|
+
%% ── Ramo A: NOVO ──
|
|
20
|
+
Q -- "Não" --> A1["A1· Gerar scaffold<br/>npm run init:project <nome> --ai claude,copilot"]
|
|
21
|
+
A1 --> A2["A2· Escolher boilerplate<br/>api-rest · saas · ecommerce · microservices · monorepo"]
|
|
22
|
+
A2 --> A3["A3· (opcional) harness<br/>desenha o time de agentes do domínio"]
|
|
23
|
+
A3 --> C0
|
|
24
|
+
|
|
25
|
+
%% ── Ramo B: EXISTENTE ──
|
|
26
|
+
Q -- "Sim" --> B0{"Já tem<br/>memory/?"}
|
|
27
|
+
B0 -- "Não" --> B1["B1· Overlay de memória<br/>init:project detecta backend → --only-memory"]
|
|
28
|
+
B0 -- "Sim" --> B2["B2· Indexar código<br/>codegraph init (entender o que existe)"]
|
|
29
|
+
B1 --> B2
|
|
30
|
+
B2 --> C0
|
|
31
|
+
|
|
32
|
+
%% ── Convergência: ciclo SDD+GSD ──
|
|
33
|
+
C0(["▶ Entra no ciclo CLI-first"]) --> CICLO
|
|
34
|
+
subgraph CICLO["docs/fluxo.md — 6 etapas"]
|
|
35
|
+
direction LR
|
|
36
|
+
c1["1·Entender"] --> c2["2·Especificar"] --> c3["3·Arquitetar"] --> c4["4·Decompor"] --> c5["5·Implementar"] --> c6["6·Governar"]
|
|
37
|
+
end
|
|
38
|
+
CICLO --> OUT(["✅ Entrega + memória atualizada"])
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
### Fallback ASCII
|
|
42
|
+
|
|
43
|
+
```
|
|
44
|
+
💡 Demanda
|
|
45
|
+
│
|
|
46
|
+
├─ projeto NÃO existe ─► A1 init:project <nome> --ai …
|
|
47
|
+
│ A2 escolher boilerplate
|
|
48
|
+
│ A3 (opc.) harness desenha o time ─┐
|
|
49
|
+
│ │
|
|
50
|
+
└─ projeto JÁ existe ──► tem memory/? │
|
|
51
|
+
├─ não ► B1 overlay --only-memory │
|
|
52
|
+
└─ sim ─┘ │
|
|
53
|
+
B2 codegraph init ────────┤
|
|
54
|
+
▼
|
|
55
|
+
▶ CICLO (docs/fluxo.md):
|
|
56
|
+
1·Entender → 2·Especificar → 3·Arquitetar
|
|
57
|
+
→ 4·Decompor → 5·Implementar → 6·Governar ─► ✅
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## Ramo A — Criar projeto novo
|
|
63
|
+
|
|
64
|
+
O gerador (`bin/init-project.js`) roda 8 passos: git-init → estrutura agentes+memória
|
|
65
|
+
→ design-lib → instruções multi-IA → install-backend → init memória SQLite →
|
|
66
|
+
context-pack → next-steps. Cada projeto nasce com `memory/`, `.ia-instructions/`
|
|
67
|
+
(claude/copilot/gemini/codex) e seu próprio banco de memória.
|
|
68
|
+
|
|
69
|
+
Projetos de produto vivem no **workspace Forja** (`~/forja-workspace/projects/<nome>`
|
|
70
|
+
por padrão), fora do repo do framework. Veja ADR-0019.
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
# 1. preparar workspace (uma vez)
|
|
74
|
+
npm run workspace:init
|
|
75
|
+
|
|
76
|
+
# 2. gerar (cria em ~/forja-workspace/projects/<nome>)
|
|
77
|
+
npm run project:new <nome> -- --ai claude,copilot,gemini
|
|
78
|
+
|
|
79
|
+
# 3. (opcional) escolher boilerplate de stack
|
|
80
|
+
ls boilerplates/ # 01-api-rest · 02-saas-starter · 03-ecommerce · 04-microservices · 05-monorepo
|
|
81
|
+
|
|
82
|
+
# 4. (opcional) na sessão Claude Code, desenhar o time de agentes do domínio:
|
|
83
|
+
# "build a harness for this project" → gera .claude/agents + .claude/skills
|
|
84
|
+
|
|
85
|
+
# 5. entrar no ciclo: começa pela spec
|
|
86
|
+
npm run spec:new -- <slug>
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## Ramo B — Atualizar projeto existente
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
# B1. projeto sem memória ainda? sobrepõe só a camada de memória/agentes
|
|
95
|
+
# (init:project detecta backend e aplica --only-memory automaticamente)
|
|
96
|
+
npm run init:project <nome> # apontando para o projeto existente
|
|
97
|
+
|
|
98
|
+
# B2. indexar o código atual ANTES de mexer (entender sem ler arquivo a arquivo)
|
|
99
|
+
codegraph init # ou: npm run code:index
|
|
100
|
+
codegraph explore "<área a mudar>"
|
|
101
|
+
|
|
102
|
+
# entra no ciclo pela spec da mudança
|
|
103
|
+
npm run spec:new -- <slug>
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
A diferença essencial do ramo B é a **etapa 1 (Entender) com codegraph**: antes de
|
|
107
|
+
especificar a mudança, mapeie símbolos, callers e impacto no código que já existe.
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## Convergência — o ciclo (resumo)
|
|
112
|
+
|
|
113
|
+
Os dois ramos terminam no mesmo ciclo de 6 etapas. Quem dirige cada uma:
|
|
114
|
+
|
|
115
|
+
| # | Etapa | Papel | Capacidade |
|
|
116
|
+
|---|-------|-------|------------|
|
|
117
|
+
| 1 | Entender | context-engineer | codegraph · ai-engineering |
|
|
118
|
+
| 2 | Especificar | product | — |
|
|
119
|
+
| 3 | Arquitetar | sdd-architect | harness · ADR |
|
|
120
|
+
| 4 | Decompor | sdd-architect | — |
|
|
121
|
+
| 5 | Implementar | orchestrator + worker | codegraph (MCP) |
|
|
122
|
+
| 6 | Governar | governance | codegraph (`affected`) |
|
|
123
|
+
|
|
124
|
+
Detalhe de comandos por etapa, handoffs (7 campos, ADR-0005) e o papel do dashboard
|
|
125
|
+
opcional: **[`docs/fluxo.md`](./fluxo.md)**.
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## Onde "nossa IA" age em cada ramo
|
|
130
|
+
|
|
131
|
+
- **Novo projeto:** a IA gera o scaffold, e o **harness** desenha o time de agentes
|
|
132
|
+
inicial sob medida para o domínio. ai-engineering fundamenta escolhas técnicas.
|
|
133
|
+
- **Projeto existente:** **codegraph** dá à IA o mapa do código atual (símbolos,
|
|
134
|
+
call paths, testes afetados) — é o que evita refator às cegas. O overlay
|
|
135
|
+
`--only-memory` dá ao projeto a camada de memória/agentes sem tocar no código.
|
|
136
|
+
- **Sempre:** memória e contexto são transversais (`sync:universal`,
|
|
137
|
+
`query:universal`, `context:smart`) e cada handoff entre papéis fica registrado em
|
|
138
|
+
`~/forja-workspace/memory/sqlite/universal.db`.
|
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
# ForjaJS: Factsheet de Produto
|
|
2
|
+
|
|
3
|
+
**Versão de referência:** 2.0.3 com o LLM Fit Loop em desenvolvimento.
|
|
4
|
+
|
|
5
|
+
## Mensagem central
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
## Para quem é
|
|
10
|
+
|
|
11
|
+
- Desenvolvedores solo e times pequenos que usam IA como força principal de implementação.
|
|
12
|
+
- Tech leads que precisam limitar autonomia sem desacelerar o fluxo de entrega.
|
|
13
|
+
- Produtos que precisam manter decisões, specs e evidências entre sessões e entre ferramentas de IA.
|
|
14
|
+
|
|
15
|
+
Não é uma IDE, uma hospedagem de agentes, uma plataforma SaaS multi-tenant nem substitui Git.
|
|
16
|
+
|
|
17
|
+
## Problema que resolve
|
|
18
|
+
|
|
19
|
+
Agentes de desenvolvimento são bons em uma sessão, mas normalmente não têm memória persistente,
|
|
20
|
+
processo verificável ou uma fronteira confiável entre sugestão e ação. Isso resulta em contexto
|
|
21
|
+
repetido, decisões perdidas, mudanças sem validação e autonomia baseada em confiança.
|
|
22
|
+
|
|
23
|
+
O ForjaJS adiciona a camada operacional ao redor do agente:
|
|
24
|
+
|
|
25
|
+
```text
|
|
26
|
+
contexto e memória -> plano -> policy/aprovação -> execução isolada -> validação -> evidência
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## O núcleo funcional
|
|
30
|
+
|
|
31
|
+
| Capacidade | O que entrega | Prova operacional |
|
|
32
|
+
| --- | --- | --- |
|
|
33
|
+
| CLI e Capability Registry | Capacidades versionadas, descobríveis e com entrada/saída validadas | `forja capabilities:list` e `forja capability:execute` |
|
|
34
|
+
| Policy Engine | Allow, deny, limites e aprovação para ações por risco | contratos e testes de policy/runtime |
|
|
35
|
+
| Runtime supervisionado | Execução com estado, checkpoints, pausa, retomada, retry limitado e orçamento | `test/runtime.test.js` |
|
|
36
|
+
| SDD/GSD | Spec, plano, tarefas, handoffs de sete campos e gates de governança | `forja spec:*`, `forja gsd:*`, `forja orchestrate:*` |
|
|
37
|
+
| Memória e contexto | SQLite local, evidências, contexto selecionado por orçamento e cache | `forja context:smart`, `forja benchmark:context` |
|
|
38
|
+
| GraphLoop | Grafo incremental de documentos, símbolos, relações e evidências | `forja graph:sync`, impacto e consultas GraphLoop |
|
|
39
|
+
| Sandbox Git | Worktree isolada, diff, promoção explícita e rollback | `forja demo:autonomy` |
|
|
40
|
+
| Validator | Resultado aceito, rejeitado, inconclusivo ou bloqueado por checks/evidências | `packages/validator` e testes de runtime |
|
|
41
|
+
| Observabilidade e evals | Observações locais, custo/tokens quando fornecidos e métricas determinísticas | `EvaluationEngine` e `llm:eval` |
|
|
42
|
+
| MCP e SDK | Acesso programático à mesma capability registry | `forja mcp:start` e `packages/sdk` |
|
|
43
|
+
| Plugins | Fronteiras permissionadas para extensões | manifests GitHub/Docker e Plugin SDK |
|
|
44
|
+
|
|
45
|
+
## Fluxo de entrega
|
|
46
|
+
|
|
47
|
+
```text
|
|
48
|
+
briefing -> spec -> plano -> tarefas -> implementação -> validação -> governança
|
|
49
|
+
| |
|
|
50
|
+
+-- contexto mínimo e evidências ----+
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
O motor `orchestrate` mantém essa sequência como máquina de estados. Uma etapa só avança depois do
|
|
54
|
+
artefato exigido e do gate correspondente. O agente ou humano executa o trabalho; o ForjaJS controla
|
|
55
|
+
o processo, a política e a evidência.
|
|
56
|
+
|
|
57
|
+
## LLM Fit Loop
|
|
58
|
+
|
|
59
|
+
O ForjaJS não exige um único fornecedor de modelo. O LLM Fit Loop integra CLIs já autenticadas pelo
|
|
60
|
+
operador, como Codex, Claude, Gemini, Ollama e executáveis compatíveis.
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
forja llm:profiles:init
|
|
64
|
+
forja llm:doctor
|
|
65
|
+
forja llm:recommend --role worker --task implementation
|
|
66
|
+
forja llm:run --profile codex --task specs/minha-feature/spec.md
|
|
67
|
+
forja llm:eval --scope model --id codex:default
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
O ciclo registra modelo, duração, resultado, referências de contexto e tokens estimados. A seleção é
|
|
71
|
+
uma recomendação explicável, não failover automático. Credenciais ficam na CLI do fornecedor; prompts
|
|
72
|
+
passados por `--prompt` são mascarados da trilha de auditoria.
|
|
73
|
+
|
|
74
|
+
## Segurança e privacidade
|
|
75
|
+
|
|
76
|
+
- **Local-first:** SQLite, filesystem e Git local são as dependências padrão do fluxo comprovado.
|
|
77
|
+
- **Aprovação explícita:** ações de risco podem exigir uma aprovação persistida antes da execução.
|
|
78
|
+
- **Sandbox:** alterações são feitas em worktree e só chegam ao repositório por promoção explícita.
|
|
79
|
+
- **Rollback:** uma promoção pode ser revertida por operação auditável.
|
|
80
|
+
- **Sem shell para adapters LLM:** executáveis recebem `argv` estruturado.
|
|
81
|
+
- **Evidência separada de afirmação:** validação e GraphLoop carregam status e referências de prova.
|
|
82
|
+
|
|
83
|
+
## Demonstrações que sustentam a mensagem
|
|
84
|
+
|
|
85
|
+
| Demonstração | O que mostra |
|
|
86
|
+
| --- | --- |
|
|
87
|
+
| `forja demo:autonomy` | fixture externa, Git worktree real, aprovação, teste, diff, promoção, SQLite, GraphLoop e handoff |
|
|
88
|
+
| `forja benchmark:context` | baseline, contexto selecionado, checksum, cache e estimativa de economia de tokens |
|
|
89
|
+
| `forja mcp:start` | transporte MCP JSON-RPC por stdio e tools derivadas do registry |
|
|
90
|
+
| `forja llm:profiles:init` + `llm:run` | adapters de LLM sem API key no framework e observação persistida |
|
|
91
|
+
| `forja demo:workspace` | workspace isolado e rotulado para demonstração de CLI e dashboard sem dados reais |
|
|
92
|
+
|
|
93
|
+
## Mensagens prontas para marketing
|
|
94
|
+
|
|
95
|
+
### Headline
|
|
96
|
+
|
|
97
|
+
**Pare de tratar agentes de código como chats descartáveis. Opere-os como um time de engenharia.**
|
|
98
|
+
|
|
99
|
+
### Subheadline
|
|
100
|
+
|
|
101
|
+
ForjaJS adiciona memória, contexto econômico, política, sandbox e evidência ao fluxo de agentes de
|
|
102
|
+
desenvolvimento, sem exigir nuvem nem prender seu time a um provedor de LLM.
|
|
103
|
+
|
|
104
|
+
### Diferenciais em três pontos
|
|
105
|
+
|
|
106
|
+
1. **Memória que sobrevive:** contexto, decisions e handoffs continuam entre sessões e ferramentas.
|
|
107
|
+
2. **Autonomia com limite:** policy, orçamento, sandbox e aprovação decidem o que pode acontecer.
|
|
108
|
+
3. **Entrega comprovável:** validação independente, evidências e auditoria substituem “o agente disse
|
|
109
|
+
que terminou”.
|
|
110
|
+
|
|
111
|
+
### Elevator pitch
|
|
112
|
+
|
|
113
|
+
ForjaJS é o control plane local-first para times que desenvolvem software com agentes de IA. Ele não
|
|
114
|
+
tenta substituir o modelo: organiza o processo ao redor dele, conectando contexto, execução
|
|
115
|
+
supervisionada, governança e memória em uma trilha auditável.
|
|
116
|
+
|
|
117
|
+
## Claims permitidos
|
|
118
|
+
|
|
119
|
+
- “CLI-first e local-first para operação de agentes de desenvolvimento.”
|
|
120
|
+
- “Memória SQLite, contexto selecionado por orçamento e evidências persistentes.”
|
|
121
|
+
- “Execução supervisionada com policy, aprovação, sandbox Git e rollback explícito.”
|
|
122
|
+
- “Integração multi-LLM por adapters de CLI, sem API keys armazenadas no ForjaJS.”
|
|
123
|
+
- “MCP, SDK, REST/SSE e CLI sobre contratos versionados.”
|
|
124
|
+
|
|
125
|
+
## Claims a evitar por enquanto
|
|
126
|
+
|
|
127
|
+
- “Autonomia total” ou “agentes trabalham sozinhos sem supervisão”.
|
|
128
|
+
- “Integração completa com GitHub ou Docker”: hoje existem boundaries/plugin manifests permissionados,
|
|
129
|
+
não clientes externos completos.
|
|
130
|
+
- “Economia fixa de tokens”: o benchmark usa proxy bytes/4 e varia por projeto/contexto.
|
|
131
|
+
- “Dashboard de produção”: o dashboard 2.x é parcial e a interface legada é opcional.
|
|
132
|
+
- ROI, redução de bugs, cobertura ou velocidade com percentuais sem telemetria do usuário.
|
|
133
|
+
|
|
134
|
+
## Estado das superfícies visuais
|
|
135
|
+
|
|
136
|
+
- **Dashboard 2.x:** superfície de supervisão parcial via API; não é requisito do fluxo CLI-first.
|
|
137
|
+
- **Dashboard React/Vite legado:** útil para demonstração local de telas e navegação. Em 2026-08-17,
|
|
138
|
+
ele inicia em Node 24 com `better-sqlite3` 12 e expõe API local em `127.0.0.1:7777`; o frontend
|
|
139
|
+
Vite fica em `http://127.0.0.1:5173`. Um workspace sem projetos ou handoffs mostra coleções vazias,
|
|
140
|
+
não dados de demonstração inventados.
|
|
141
|
+
- O dashboard não executa LLMs diretamente: essa ação foi direcionada para `forja llm:run` para manter
|
|
142
|
+
policy, auditoria e privacidade.
|
|
143
|
+
|
|
144
|
+
## Referências de engenharia
|
|
145
|
+
|
|
146
|
+
- Visão: `docs/vision/FORJA-2.0-VISION.md`
|
|
147
|
+
- Arquitetura: `docs/architecture/FORJA-2.0-ARCHITECTURE.md`
|
|
148
|
+
- Auditoria de implementação: `docs/2x/IMPLEMENTATION-AUDIT.md`
|
|
149
|
+
- LLM Fit Loop: `docs/llm-fit-loop.md`
|
|
150
|
+
- Roteiro de demonstração: `docs/produto/roteiro-demo.md`
|
|
151
|
+
- Decisões: `memory/90-decisions/`
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# Roteiro de Demonstração: Atlas Pay
|
|
2
|
+
|
|
3
|
+
`forja demo:workspace` cria dados sintéticos e isolados para mostrar o produto sem acessar projetos
|
|
4
|
+
reais. O cenário não chama LLMs, não usa rede e não representa métricas de clientes.
|
|
5
|
+
|
|
6
|
+
## Preparação
|
|
7
|
+
|
|
8
|
+
```bash
|
|
9
|
+
forja demo:workspace
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
O comando cria `~/forja-demo-workspace` com o projeto fictício `atlas-pay`, uma spec aprovada, plano,
|
|
13
|
+
tarefas, contexto, três handoffs, três observações e um perfil LLM local desabilitado.
|
|
14
|
+
|
|
15
|
+
Para abrir o dashboard sobre esse cenário, inicie os dois processos com o mesmo workspace:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
FORJA_WORKSPACE=~/forja-demo-workspace npm --prefix dashboard start
|
|
19
|
+
FORJA_WORKSPACE=~/forja-demo-workspace npm --prefix dashboard/web run dev
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
No Windows PowerShell:
|
|
23
|
+
|
|
24
|
+
```powershell
|
|
25
|
+
$env:FORJA_WORKSPACE = "$HOME\forja-demo-workspace"
|
|
26
|
+
npm --prefix dashboard start
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Abra `http://127.0.0.1:5173`. O dashboard mostra o estado vazio apenas se não estiver recebendo a
|
|
30
|
+
variável `FORJA_WORKSPACE` do cenário.
|
|
31
|
+
|
|
32
|
+
## Sequência de apresentação
|
|
33
|
+
|
|
34
|
+
1. Abra **Sistema**: mostra o projeto Atlas Pay, gates e a contagem de handoffs.
|
|
35
|
+
2. Abra **Specs**: apresente problema, critérios de aceite, plano e tarefas aprovados.
|
|
36
|
+
3. Abra **Handoffs**: há dois handoffs concluídos e um em review, todos marcados como demonstração.
|
|
37
|
+
4. Abra **Memória** e **Tokens**: explique que contexto e observações são dados locais e consultáveis.
|
|
38
|
+
5. Abra **Agentes** para mostrar o perfil `demo-ollama`: ele fica desabilitado até existir uma CLI
|
|
39
|
+
Ollama local, reforçando que o Forja não inventa disponibilidade de modelo.
|
|
40
|
+
6. Mostre `forja demo:autonomy` separadamente para a prova de sandbox Git, aprovação e promoção real.
|
|
41
|
+
|
|
42
|
+
## Regras de uso
|
|
43
|
+
|
|
44
|
+
- Nunca apresente Atlas Pay como cliente, case real ou métrica de produção.
|
|
45
|
+
- Não habilite o perfil `demo-ollama` sem uma instalação local de Ollama.
|
|
46
|
+
- Use `forja demo:workspace --path <diretório>` para criar outro cenário isolado.
|
|
47
|
+
- O comando recusa gravar em diretório existente que não tenha o selo `.context/forja-demo.json`.
|