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
|
@@ -1,43 +1,43 @@
|
|
|
1
|
-
{
|
|
2
|
-
"schemaVersion": "1.0",
|
|
3
|
-
"type": "boilerplate",
|
|
4
|
-
"name": "05-monorepo-starter",
|
|
5
|
-
"title": "Monorepo Starter",
|
|
6
|
-
"path": "boilerplates/05-monorepo-starter",
|
|
7
|
-
"readme": "boilerplates/05-monorepo-starter/README.md",
|
|
8
|
-
"stack": [
|
|
9
|
-
"NestJS",
|
|
10
|
-
"Next.js",
|
|
11
|
-
"React",
|
|
12
|
-
"Docker",
|
|
13
|
-
"Turborepo",
|
|
14
|
-
"JWT",
|
|
15
|
-
"Postgres"
|
|
16
|
-
],
|
|
17
|
-
"useCases": [
|
|
18
|
-
"Monorepo",
|
|
19
|
-
"Dashboard",
|
|
20
|
-
"Auth"
|
|
21
|
-
],
|
|
22
|
-
"commands": [
|
|
23
|
-
"npm install",
|
|
24
|
-
"docker compose up -d",
|
|
25
|
-
"npm test"
|
|
26
|
-
],
|
|
27
|
-
"gates": [
|
|
28
|
-
"npm run spec:check",
|
|
29
|
-
"npm test",
|
|
30
|
-
"npm run project:check"
|
|
31
|
-
],
|
|
32
|
-
"tokenPolicy": {
|
|
33
|
-
"firstRead": [
|
|
34
|
-
"boilerplate.manifest.json",
|
|
35
|
-
"README.md"
|
|
36
|
-
],
|
|
37
|
-
"avoidLoadingByDefault": [
|
|
38
|
-
"node_modules",
|
|
39
|
-
"dist",
|
|
40
|
-
"coverage"
|
|
41
|
-
]
|
|
42
|
-
}
|
|
43
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": "1.0",
|
|
3
|
+
"type": "boilerplate",
|
|
4
|
+
"name": "05-monorepo-starter",
|
|
5
|
+
"title": "Monorepo Starter",
|
|
6
|
+
"path": "boilerplates/05-monorepo-starter",
|
|
7
|
+
"readme": "boilerplates/05-monorepo-starter/README.md",
|
|
8
|
+
"stack": [
|
|
9
|
+
"NestJS",
|
|
10
|
+
"Next.js",
|
|
11
|
+
"React",
|
|
12
|
+
"Docker",
|
|
13
|
+
"Turborepo",
|
|
14
|
+
"JWT",
|
|
15
|
+
"Postgres"
|
|
16
|
+
],
|
|
17
|
+
"useCases": [
|
|
18
|
+
"Monorepo",
|
|
19
|
+
"Dashboard",
|
|
20
|
+
"Auth"
|
|
21
|
+
],
|
|
22
|
+
"commands": [
|
|
23
|
+
"npm install",
|
|
24
|
+
"docker compose up -d",
|
|
25
|
+
"npm test"
|
|
26
|
+
],
|
|
27
|
+
"gates": [
|
|
28
|
+
"npm run spec:check",
|
|
29
|
+
"npm test",
|
|
30
|
+
"npm run project:check"
|
|
31
|
+
],
|
|
32
|
+
"tokenPolicy": {
|
|
33
|
+
"firstRead": [
|
|
34
|
+
"boilerplate.manifest.json",
|
|
35
|
+
"README.md"
|
|
36
|
+
],
|
|
37
|
+
"avoidLoadingByDefault": [
|
|
38
|
+
"node_modules",
|
|
39
|
+
"dist",
|
|
40
|
+
"coverage"
|
|
41
|
+
]
|
|
42
|
+
}
|
|
43
|
+
}
|
|
@@ -1,36 +1,36 @@
|
|
|
1
|
-
version: '3.9'
|
|
2
|
-
|
|
3
|
-
services:
|
|
4
|
-
postgres:
|
|
5
|
-
image: postgres:16-alpine
|
|
6
|
-
container_name: monorepo-postgres
|
|
7
|
-
environment:
|
|
8
|
-
POSTGRES_USER: postgres
|
|
9
|
-
POSTGRES_PASSWORD: postgres
|
|
10
|
-
POSTGRES_DB: monorepo
|
|
11
|
-
ports:
|
|
12
|
-
- "5432:5432"
|
|
13
|
-
volumes:
|
|
14
|
-
- postgres_data:/var/lib/postgresql/data
|
|
15
|
-
healthcheck:
|
|
16
|
-
test: ["CMD-SHELL", "pg_isready -U postgres"]
|
|
17
|
-
interval: 10s
|
|
18
|
-
timeout: 5s
|
|
19
|
-
retries: 5
|
|
20
|
-
|
|
21
|
-
redis:
|
|
22
|
-
image: redis:7-alpine
|
|
23
|
-
container_name: monorepo-redis
|
|
24
|
-
ports:
|
|
25
|
-
- "6379:6379"
|
|
26
|
-
volumes:
|
|
27
|
-
- redis_data:/data
|
|
28
|
-
healthcheck:
|
|
29
|
-
test: ["CMD", "redis-cli", "ping"]
|
|
30
|
-
interval: 10s
|
|
31
|
-
timeout: 5s
|
|
32
|
-
retries: 5
|
|
33
|
-
|
|
34
|
-
volumes:
|
|
35
|
-
postgres_data:
|
|
36
|
-
redis_data:
|
|
1
|
+
version: '3.9'
|
|
2
|
+
|
|
3
|
+
services:
|
|
4
|
+
postgres:
|
|
5
|
+
image: postgres:16-alpine
|
|
6
|
+
container_name: monorepo-postgres
|
|
7
|
+
environment:
|
|
8
|
+
POSTGRES_USER: postgres
|
|
9
|
+
POSTGRES_PASSWORD: postgres
|
|
10
|
+
POSTGRES_DB: monorepo
|
|
11
|
+
ports:
|
|
12
|
+
- "5432:5432"
|
|
13
|
+
volumes:
|
|
14
|
+
- postgres_data:/var/lib/postgresql/data
|
|
15
|
+
healthcheck:
|
|
16
|
+
test: ["CMD-SHELL", "pg_isready -U postgres"]
|
|
17
|
+
interval: 10s
|
|
18
|
+
timeout: 5s
|
|
19
|
+
retries: 5
|
|
20
|
+
|
|
21
|
+
redis:
|
|
22
|
+
image: redis:7-alpine
|
|
23
|
+
container_name: monorepo-redis
|
|
24
|
+
ports:
|
|
25
|
+
- "6379:6379"
|
|
26
|
+
volumes:
|
|
27
|
+
- redis_data:/data
|
|
28
|
+
healthcheck:
|
|
29
|
+
test: ["CMD", "redis-cli", "ping"]
|
|
30
|
+
interval: 10s
|
|
31
|
+
timeout: 5s
|
|
32
|
+
retries: 5
|
|
33
|
+
|
|
34
|
+
volumes:
|
|
35
|
+
postgres_data:
|
|
36
|
+
redis_data:
|
|
@@ -1,28 +1,28 @@
|
|
|
1
|
-
# Agent Contract
|
|
2
|
-
|
|
3
|
-
## Architect Agent
|
|
4
|
-
Manages monorepo structure, dependency graph, and cross-cutting concerns.
|
|
5
|
-
- Tasks: Adding new packages, domain organization
|
|
6
|
-
- Tools: Turborepo config, tsconfig inheritance
|
|
7
|
-
|
|
8
|
-
## Frontend Agent
|
|
9
|
-
Owns Next.js app, components, and UI logic.
|
|
10
|
-
- Tasks: Building pages, components, form handling
|
|
11
|
-
- Imports: shared-types for API contracts, shared-utils for helpers
|
|
12
|
-
- Constraint: Never directly access backend code
|
|
13
|
-
|
|
14
|
-
## Backend Agent
|
|
15
|
-
Owns NestJS modules, business logic, and database.
|
|
16
|
-
- Tasks: API endpoints, domain models, database schemas
|
|
17
|
-
- Imports: shared-types for API contracts, shared-utils for helpers
|
|
18
|
-
- Constraint: Never directly couple to frontend
|
|
19
|
-
|
|
20
|
-
## DevOps Agent
|
|
21
|
-
Manages Docker, deployment, and CI/CD.
|
|
22
|
-
- Tasks: Docker builds, env config, deployment pipelines
|
|
23
|
-
- Focus: Multi-stage builds, Turborepo caching
|
|
24
|
-
|
|
25
|
-
## Integration Points
|
|
26
|
-
- All agents use shared-types for API contracts
|
|
27
|
-
- All agents use shared-utils for common utilities
|
|
28
|
-
- No direct imports between frontend and backend
|
|
1
|
+
# Agent Contract
|
|
2
|
+
|
|
3
|
+
## Architect Agent
|
|
4
|
+
Manages monorepo structure, dependency graph, and cross-cutting concerns.
|
|
5
|
+
- Tasks: Adding new packages, domain organization
|
|
6
|
+
- Tools: Turborepo config, tsconfig inheritance
|
|
7
|
+
|
|
8
|
+
## Frontend Agent
|
|
9
|
+
Owns Next.js app, components, and UI logic.
|
|
10
|
+
- Tasks: Building pages, components, form handling
|
|
11
|
+
- Imports: shared-types for API contracts, shared-utils for helpers
|
|
12
|
+
- Constraint: Never directly access backend code
|
|
13
|
+
|
|
14
|
+
## Backend Agent
|
|
15
|
+
Owns NestJS modules, business logic, and database.
|
|
16
|
+
- Tasks: API endpoints, domain models, database schemas
|
|
17
|
+
- Imports: shared-types for API contracts, shared-utils for helpers
|
|
18
|
+
- Constraint: Never directly couple to frontend
|
|
19
|
+
|
|
20
|
+
## DevOps Agent
|
|
21
|
+
Manages Docker, deployment, and CI/CD.
|
|
22
|
+
- Tasks: Docker builds, env config, deployment pipelines
|
|
23
|
+
- Focus: Multi-stage builds, Turborepo caching
|
|
24
|
+
|
|
25
|
+
## Integration Points
|
|
26
|
+
- All agents use shared-types for API contracts
|
|
27
|
+
- All agents use shared-utils for common utilities
|
|
28
|
+
- No direct imports between frontend and backend
|
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
# Context Policy
|
|
2
|
-
|
|
3
|
-
## Local Development
|
|
4
|
-
- Root `npm run dev` starts frontend + backend + watchers
|
|
5
|
-
- Environment: `.env.local` for secrets, `.env.example` for docs
|
|
6
|
-
- Database: PostgreSQL + Redis via docker-compose
|
|
7
|
-
|
|
8
|
-
## Build & Deployment
|
|
9
|
-
- Turborepo caches builds and tests
|
|
10
|
-
- `npm run build` builds all packages in dependency order
|
|
11
|
-
- Docker multi-stage builds (frontend + backend in one image if needed)
|
|
12
|
-
|
|
13
|
-
## Git Workflow
|
|
14
|
-
- Monorepo uses conventional commits
|
|
15
|
-
- CI/CD runs Turborepo affected checks
|
|
16
|
-
- Shared code changes trigger dependent tests
|
|
17
|
-
|
|
18
|
-
## Code Review
|
|
19
|
-
- Shared-types changes require +2 approval (affects both apps)
|
|
20
|
-
- Domain logic isolated to backend modules
|
|
21
|
-
- UI components isolated to frontend
|
|
1
|
+
# Context Policy
|
|
2
|
+
|
|
3
|
+
## Local Development
|
|
4
|
+
- Root `npm run dev` starts frontend + backend + watchers
|
|
5
|
+
- Environment: `.env.local` for secrets, `.env.example` for docs
|
|
6
|
+
- Database: PostgreSQL + Redis via docker-compose
|
|
7
|
+
|
|
8
|
+
## Build & Deployment
|
|
9
|
+
- Turborepo caches builds and tests
|
|
10
|
+
- `npm run build` builds all packages in dependency order
|
|
11
|
+
- Docker multi-stage builds (frontend + backend in one image if needed)
|
|
12
|
+
|
|
13
|
+
## Git Workflow
|
|
14
|
+
- Monorepo uses conventional commits
|
|
15
|
+
- CI/CD runs Turborepo affected checks
|
|
16
|
+
- Shared code changes trigger dependent tests
|
|
17
|
+
|
|
18
|
+
## Code Review
|
|
19
|
+
- Shared-types changes require +2 approval (affects both apps)
|
|
20
|
+
- Domain logic isolated to backend modules
|
|
21
|
+
- UI components isolated to frontend
|
|
@@ -1,44 +1,44 @@
|
|
|
1
|
-
# Memory Index
|
|
2
|
-
|
|
3
|
-
## 00-global/
|
|
4
|
-
- **mission.md** — Core mission & success criteria
|
|
5
|
-
- **patterns.md** — Monorepo structure & file organization
|
|
6
|
-
- **context-policy.md** — Dev workflow, git, code review
|
|
7
|
-
- **agent-contract.md** — Agent responsibilities & integration points
|
|
8
|
-
- **index.md** (this file) — Navigation
|
|
9
|
-
|
|
10
|
-
## 10-product/
|
|
11
|
-
- **vision.md** — Product vision & core features
|
|
12
|
-
- **personas.md** — User personas
|
|
13
|
-
- **business-rules.md** — Domain constraints
|
|
14
|
-
- **nfrs.md** — Non-functional requirements (performance, security)
|
|
15
|
-
|
|
16
|
-
## 20-architecture/
|
|
17
|
-
- **overview.md** — Monorepo tech stack
|
|
18
|
-
- **frontend.md** — Next.js architecture
|
|
19
|
-
- **backend.md** — NestJS module structure
|
|
20
|
-
- **data.md** — Database design
|
|
21
|
-
- **security.md** — Auth, validation, API security
|
|
22
|
-
|
|
23
|
-
## 30-domains/
|
|
24
|
-
- **user/** — User domain (auth, profile)
|
|
25
|
-
- **product/** — Product domain (catalog, inventory)
|
|
26
|
-
- **order/** — Order domain (shopping, payments)
|
|
27
|
-
|
|
28
|
-
## 40-delivery/
|
|
29
|
-
- Roadmap and sprint planning
|
|
30
|
-
|
|
31
|
-
## 50-orchestration/
|
|
32
|
-
- Handoff protocols, service integration
|
|
33
|
-
|
|
34
|
-
## 60-runs/
|
|
35
|
-
- Execution logs
|
|
36
|
-
|
|
37
|
-
## 70-summaries/
|
|
38
|
-
- Domain & global summaries
|
|
39
|
-
|
|
40
|
-
## 80-data/
|
|
41
|
-
- Database schema docs
|
|
42
|
-
|
|
43
|
-
## 90-decisions/
|
|
44
|
-
- Architecture Decision Records (ADRs)
|
|
1
|
+
# Memory Index
|
|
2
|
+
|
|
3
|
+
## 00-global/
|
|
4
|
+
- **mission.md** — Core mission & success criteria
|
|
5
|
+
- **patterns.md** — Monorepo structure & file organization
|
|
6
|
+
- **context-policy.md** — Dev workflow, git, code review
|
|
7
|
+
- **agent-contract.md** — Agent responsibilities & integration points
|
|
8
|
+
- **index.md** (this file) — Navigation
|
|
9
|
+
|
|
10
|
+
## 10-product/
|
|
11
|
+
- **vision.md** — Product vision & core features
|
|
12
|
+
- **personas.md** — User personas
|
|
13
|
+
- **business-rules.md** — Domain constraints
|
|
14
|
+
- **nfrs.md** — Non-functional requirements (performance, security)
|
|
15
|
+
|
|
16
|
+
## 20-architecture/
|
|
17
|
+
- **overview.md** — Monorepo tech stack
|
|
18
|
+
- **frontend.md** — Next.js architecture
|
|
19
|
+
- **backend.md** — NestJS module structure
|
|
20
|
+
- **data.md** — Database design
|
|
21
|
+
- **security.md** — Auth, validation, API security
|
|
22
|
+
|
|
23
|
+
## 30-domains/
|
|
24
|
+
- **user/** — User domain (auth, profile)
|
|
25
|
+
- **product/** — Product domain (catalog, inventory)
|
|
26
|
+
- **order/** — Order domain (shopping, payments)
|
|
27
|
+
|
|
28
|
+
## 40-delivery/
|
|
29
|
+
- Roadmap and sprint planning
|
|
30
|
+
|
|
31
|
+
## 50-orchestration/
|
|
32
|
+
- Handoff protocols, service integration
|
|
33
|
+
|
|
34
|
+
## 60-runs/
|
|
35
|
+
- Execution logs
|
|
36
|
+
|
|
37
|
+
## 70-summaries/
|
|
38
|
+
- Domain & global summaries
|
|
39
|
+
|
|
40
|
+
## 80-data/
|
|
41
|
+
- Database schema docs
|
|
42
|
+
|
|
43
|
+
## 90-decisions/
|
|
44
|
+
- Architecture Decision Records (ADRs)
|
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
# Mission & Vision
|
|
2
|
-
|
|
3
|
-
## Core Mission
|
|
4
|
-
Build a scalable, maintainable full-stack monorepo architecture supporting modern web applications with shared business logic and types across frontend and backend.
|
|
5
|
-
|
|
6
|
-
## Success Criteria
|
|
7
|
-
- Single source of truth for API contracts (shared-types)
|
|
8
|
-
- Zero-friction local development (one `npm run dev` command)
|
|
9
|
-
- Production-ready deployment pipeline (Docker, Turborepo cache)
|
|
10
|
-
- Clear boundaries between frontend, backend, and shared packages
|
|
11
|
-
- TypeScript end-to-end type safety
|
|
12
|
-
|
|
13
|
-
## Principles
|
|
14
|
-
1. **Monorepo-first**: Shared code lives in packages/, not duplicate
|
|
15
|
-
2. **Type-safety**: All API contracts defined in shared-types/
|
|
16
|
-
3. **Performance**: Turborepo cache for fast builds
|
|
17
|
-
4. **Scalability**: Easy to add new packages and domains
|
|
1
|
+
# Mission & Vision
|
|
2
|
+
|
|
3
|
+
## Core Mission
|
|
4
|
+
Build a scalable, maintainable full-stack monorepo architecture supporting modern web applications with shared business logic and types across frontend and backend.
|
|
5
|
+
|
|
6
|
+
## Success Criteria
|
|
7
|
+
- Single source of truth for API contracts (shared-types)
|
|
8
|
+
- Zero-friction local development (one `npm run dev` command)
|
|
9
|
+
- Production-ready deployment pipeline (Docker, Turborepo cache)
|
|
10
|
+
- Clear boundaries between frontend, backend, and shared packages
|
|
11
|
+
- TypeScript end-to-end type safety
|
|
12
|
+
|
|
13
|
+
## Principles
|
|
14
|
+
1. **Monorepo-first**: Shared code lives in packages/, not duplicate
|
|
15
|
+
2. **Type-safety**: All API contracts defined in shared-types/
|
|
16
|
+
3. **Performance**: Turborepo cache for fast builds
|
|
17
|
+
4. **Scalability**: Easy to add new packages and domains
|
|
@@ -1,48 +1,48 @@
|
|
|
1
|
-
# Architectural Patterns
|
|
2
|
-
|
|
3
|
-
## Monorepo Structure
|
|
4
|
-
```
|
|
5
|
-
packages/
|
|
6
|
-
├── apps/
|
|
7
|
-
│ ├── frontend/ # Next.js 14+ (React)
|
|
8
|
-
│ └── backend/ # NestJS 10+
|
|
9
|
-
└── packages/
|
|
10
|
-
├── shared-types/ # API & domain interfaces
|
|
11
|
-
└── shared-utils/ # Utilities & helpers
|
|
12
|
-
```
|
|
13
|
-
|
|
14
|
-
## Package Interdependencies
|
|
15
|
-
```
|
|
16
|
-
frontend → shared-types ✓
|
|
17
|
-
backend → shared-types ✓
|
|
18
|
-
shared-utils → nothing
|
|
19
|
-
frontend → shared-utils ✓
|
|
20
|
-
backend → shared-utils ✓
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
## File Organization
|
|
24
|
-
|
|
25
|
-
### Frontend (Next.js)
|
|
26
|
-
- `/app` — App Router pages & layouts
|
|
27
|
-
- `/components` — React components
|
|
28
|
-
- `/lib` — Utilities, hooks, api client
|
|
29
|
-
- `/public` — Static assets
|
|
30
|
-
|
|
31
|
-
### Backend (NestJS)
|
|
32
|
-
- `/src/modules` — Feature modules (users, products, orders)
|
|
33
|
-
- `/src/common` — Guards, interceptors, pipes
|
|
34
|
-
- `/test` — Integration tests
|
|
35
|
-
|
|
36
|
-
### Shared Packages
|
|
37
|
-
- `/src/api` — Request/response DTOs
|
|
38
|
-
- `/src/domain` — Business entities
|
|
39
|
-
- `/src/errors` — Custom error types
|
|
40
|
-
|
|
41
|
-
## API Contract Pattern
|
|
42
|
-
All API endpoints defined in shared-types/src/api/:
|
|
43
|
-
```typescript
|
|
44
|
-
export interface CreateUserRequest { ... }
|
|
45
|
-
export interface UserResponse { ... }
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
Frontend & Backend import from shared-types.
|
|
1
|
+
# Architectural Patterns
|
|
2
|
+
|
|
3
|
+
## Monorepo Structure
|
|
4
|
+
```
|
|
5
|
+
packages/
|
|
6
|
+
├── apps/
|
|
7
|
+
│ ├── frontend/ # Next.js 14+ (React)
|
|
8
|
+
│ └── backend/ # NestJS 10+
|
|
9
|
+
└── packages/
|
|
10
|
+
├── shared-types/ # API & domain interfaces
|
|
11
|
+
└── shared-utils/ # Utilities & helpers
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Package Interdependencies
|
|
15
|
+
```
|
|
16
|
+
frontend → shared-types ✓
|
|
17
|
+
backend → shared-types ✓
|
|
18
|
+
shared-utils → nothing
|
|
19
|
+
frontend → shared-utils ✓
|
|
20
|
+
backend → shared-utils ✓
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## File Organization
|
|
24
|
+
|
|
25
|
+
### Frontend (Next.js)
|
|
26
|
+
- `/app` — App Router pages & layouts
|
|
27
|
+
- `/components` — React components
|
|
28
|
+
- `/lib` — Utilities, hooks, api client
|
|
29
|
+
- `/public` — Static assets
|
|
30
|
+
|
|
31
|
+
### Backend (NestJS)
|
|
32
|
+
- `/src/modules` — Feature modules (users, products, orders)
|
|
33
|
+
- `/src/common` — Guards, interceptors, pipes
|
|
34
|
+
- `/test` — Integration tests
|
|
35
|
+
|
|
36
|
+
### Shared Packages
|
|
37
|
+
- `/src/api` — Request/response DTOs
|
|
38
|
+
- `/src/domain` — Business entities
|
|
39
|
+
- `/src/errors` — Custom error types
|
|
40
|
+
|
|
41
|
+
## API Contract Pattern
|
|
42
|
+
All API endpoints defined in shared-types/src/api/:
|
|
43
|
+
```typescript
|
|
44
|
+
export interface CreateUserRequest { ... }
|
|
45
|
+
export interface UserResponse { ... }
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Frontend & Backend import from shared-types.
|
|
@@ -1,24 +1,24 @@
|
|
|
1
|
-
# Business Rules
|
|
2
|
-
|
|
3
|
-
## User Domain
|
|
4
|
-
- Users must have unique email
|
|
5
|
-
- Email must be validated before account activation
|
|
6
|
-
- Passwords must be hashed (bcrypt)
|
|
7
|
-
- Users can have multiple roles (admin, user)
|
|
8
|
-
|
|
9
|
-
## Product Domain
|
|
10
|
-
- Products belong to categories
|
|
11
|
-
- Products have inventory levels
|
|
12
|
-
- Prices are in USD (or configurable currency)
|
|
13
|
-
- Products can be soft-deleted (not hard-deleted)
|
|
14
|
-
|
|
15
|
-
## Order Domain
|
|
16
|
-
- Orders can only be created by authenticated users
|
|
17
|
-
- Items in cart expire after 30 minutes if not checked out
|
|
18
|
-
- Orders transition through states: pending → processing → shipped → delivered
|
|
19
|
-
- Refunds allowed within 30 days of delivery
|
|
20
|
-
|
|
21
|
-
## Inventory
|
|
22
|
-
- Stock decreases when order is confirmed
|
|
23
|
-
- Overselling is prevented (stock check before order creation)
|
|
24
|
-
- Stock alerts trigger at 20% of max inventory
|
|
1
|
+
# Business Rules
|
|
2
|
+
|
|
3
|
+
## User Domain
|
|
4
|
+
- Users must have unique email
|
|
5
|
+
- Email must be validated before account activation
|
|
6
|
+
- Passwords must be hashed (bcrypt)
|
|
7
|
+
- Users can have multiple roles (admin, user)
|
|
8
|
+
|
|
9
|
+
## Product Domain
|
|
10
|
+
- Products belong to categories
|
|
11
|
+
- Products have inventory levels
|
|
12
|
+
- Prices are in USD (or configurable currency)
|
|
13
|
+
- Products can be soft-deleted (not hard-deleted)
|
|
14
|
+
|
|
15
|
+
## Order Domain
|
|
16
|
+
- Orders can only be created by authenticated users
|
|
17
|
+
- Items in cart expire after 30 minutes if not checked out
|
|
18
|
+
- Orders transition through states: pending → processing → shipped → delivered
|
|
19
|
+
- Refunds allowed within 30 days of delivery
|
|
20
|
+
|
|
21
|
+
## Inventory
|
|
22
|
+
- Stock decreases when order is confirmed
|
|
23
|
+
- Overselling is prevented (stock check before order creation)
|
|
24
|
+
- Stock alerts trigger at 20% of max inventory
|
|
@@ -1,39 +1,39 @@
|
|
|
1
|
-
# Non-Functional Requirements
|
|
2
|
-
|
|
3
|
-
## Performance
|
|
4
|
-
- Frontend First Contentful Paint < 2s
|
|
5
|
-
- API response times < 200ms (p95)
|
|
6
|
-
- Database queries < 100ms
|
|
7
|
-
- Build time < 30s (with Turborepo cache)
|
|
8
|
-
|
|
9
|
-
## Scalability
|
|
10
|
-
- Support 10k concurrent users
|
|
11
|
-
- Handle 1000 orders/minute during peak
|
|
12
|
-
- Database: Vertical scaling up to 100GB
|
|
13
|
-
|
|
14
|
-
## Security
|
|
15
|
-
- All passwords hashed (bcrypt, >10 rounds)
|
|
16
|
-
- JWT tokens with 24h expiry
|
|
17
|
-
- Refresh tokens stored in secure httpOnly cookies
|
|
18
|
-
- CORS enabled only for trusted origins
|
|
19
|
-
- API rate limiting (100 req/min per IP)
|
|
20
|
-
- SQL injection prevention via ORM/parameterized queries
|
|
21
|
-
- HTTPS enforced in production
|
|
22
|
-
|
|
23
|
-
## Reliability
|
|
24
|
-
- 99.9% uptime SLA
|
|
25
|
-
- Automated backups (daily)
|
|
26
|
-
- Graceful degradation if Redis down
|
|
27
|
-
- Health checks every 30s
|
|
28
|
-
|
|
29
|
-
## Maintainability
|
|
30
|
-
- <20% cyclomatic complexity per function
|
|
31
|
-
- 80%+ test coverage on business logic
|
|
32
|
-
- Shared types reduce API contract bugs
|
|
33
|
-
- Clear module boundaries (no circular dependencies)
|
|
34
|
-
|
|
35
|
-
## Developer Experience
|
|
36
|
-
- Setup time < 5 minutes
|
|
37
|
-
- Hot reload on code changes (frontend + backend)
|
|
38
|
-
- Clear error messages
|
|
39
|
-
- Comprehensive docs
|
|
1
|
+
# Non-Functional Requirements
|
|
2
|
+
|
|
3
|
+
## Performance
|
|
4
|
+
- Frontend First Contentful Paint < 2s
|
|
5
|
+
- API response times < 200ms (p95)
|
|
6
|
+
- Database queries < 100ms
|
|
7
|
+
- Build time < 30s (with Turborepo cache)
|
|
8
|
+
|
|
9
|
+
## Scalability
|
|
10
|
+
- Support 10k concurrent users
|
|
11
|
+
- Handle 1000 orders/minute during peak
|
|
12
|
+
- Database: Vertical scaling up to 100GB
|
|
13
|
+
|
|
14
|
+
## Security
|
|
15
|
+
- All passwords hashed (bcrypt, >10 rounds)
|
|
16
|
+
- JWT tokens with 24h expiry
|
|
17
|
+
- Refresh tokens stored in secure httpOnly cookies
|
|
18
|
+
- CORS enabled only for trusted origins
|
|
19
|
+
- API rate limiting (100 req/min per IP)
|
|
20
|
+
- SQL injection prevention via ORM/parameterized queries
|
|
21
|
+
- HTTPS enforced in production
|
|
22
|
+
|
|
23
|
+
## Reliability
|
|
24
|
+
- 99.9% uptime SLA
|
|
25
|
+
- Automated backups (daily)
|
|
26
|
+
- Graceful degradation if Redis down
|
|
27
|
+
- Health checks every 30s
|
|
28
|
+
|
|
29
|
+
## Maintainability
|
|
30
|
+
- <20% cyclomatic complexity per function
|
|
31
|
+
- 80%+ test coverage on business logic
|
|
32
|
+
- Shared types reduce API contract bugs
|
|
33
|
+
- Clear module boundaries (no circular dependencies)
|
|
34
|
+
|
|
35
|
+
## Developer Experience
|
|
36
|
+
- Setup time < 5 minutes
|
|
37
|
+
- Hot reload on code changes (frontend + backend)
|
|
38
|
+
- Clear error messages
|
|
39
|
+
- Comprehensive docs
|
|
@@ -1,25 +1,25 @@
|
|
|
1
|
-
# User Personas
|
|
2
|
-
|
|
3
|
-
## 1. Alex (Developer)
|
|
4
|
-
- Role: Full-stack engineer onboarding to the project
|
|
5
|
-
- Goals: Quickly understand monorepo structure, add new features
|
|
6
|
-
- Pain Points: Complex boilerplate, unclear boundaries
|
|
7
|
-
- Solution: Clear docs, working examples, shared-types guidance
|
|
8
|
-
|
|
9
|
-
## 2. Sam (Product Manager)
|
|
10
|
-
- Role: Defines features and roadmap
|
|
11
|
-
- Goals: See completed features fast, measure progress
|
|
12
|
-
- Pain Points: Long build times, unclear status
|
|
13
|
-
- Solution: Turborepo cache, CI/CD feedback
|
|
14
|
-
|
|
15
|
-
## 3. Pat (DevOps Engineer)
|
|
16
|
-
- Role: Deployment and infrastructure
|
|
17
|
-
- Goals: Simple build/deploy pipeline, environment consistency
|
|
18
|
-
- Pain Points: Multi-service deployment complexity
|
|
19
|
-
- Solution: Docker multi-stage builds, docker-compose, Turborepo
|
|
20
|
-
|
|
21
|
-
## 4. Casey (End User)
|
|
22
|
-
- Role: Shops on the platform
|
|
23
|
-
- Goals: Browse products, create orders, track purchases
|
|
24
|
-
- Pain Points: Slow site, poor UX
|
|
25
|
-
- Solution: Fast Next.js frontend, smooth interactions
|
|
1
|
+
# User Personas
|
|
2
|
+
|
|
3
|
+
## 1. Alex (Developer)
|
|
4
|
+
- Role: Full-stack engineer onboarding to the project
|
|
5
|
+
- Goals: Quickly understand monorepo structure, add new features
|
|
6
|
+
- Pain Points: Complex boilerplate, unclear boundaries
|
|
7
|
+
- Solution: Clear docs, working examples, shared-types guidance
|
|
8
|
+
|
|
9
|
+
## 2. Sam (Product Manager)
|
|
10
|
+
- Role: Defines features and roadmap
|
|
11
|
+
- Goals: See completed features fast, measure progress
|
|
12
|
+
- Pain Points: Long build times, unclear status
|
|
13
|
+
- Solution: Turborepo cache, CI/CD feedback
|
|
14
|
+
|
|
15
|
+
## 3. Pat (DevOps Engineer)
|
|
16
|
+
- Role: Deployment and infrastructure
|
|
17
|
+
- Goals: Simple build/deploy pipeline, environment consistency
|
|
18
|
+
- Pain Points: Multi-service deployment complexity
|
|
19
|
+
- Solution: Docker multi-stage builds, docker-compose, Turborepo
|
|
20
|
+
|
|
21
|
+
## 4. Casey (End User)
|
|
22
|
+
- Role: Shops on the platform
|
|
23
|
+
- Goals: Browse products, create orders, track purchases
|
|
24
|
+
- Pain Points: Slow site, poor UX
|
|
25
|
+
- Solution: Fast Next.js frontend, smooth interactions
|