forjajs 2.0.4 → 3.0.0
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 +50 -50
- 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 +133 -133
- package/CHANGELOG.md +619 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +64 -60
- package/LICENSE +21 -21
- package/README.md +404 -343
- package/README.pt-BR.md +374 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
- package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
- package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/forja-nest.module.js +9 -4
- package/dist/apps/server/src/main.js +10 -1
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/code-context.js +6 -0
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/architecture-gate.d.ts +20 -0
- package/dist/lib/core/architecture-gate.js +60 -0
- package/dist/lib/core/drift-gate.d.ts +18 -0
- package/dist/lib/core/drift-gate.js +55 -0
- package/dist/lib/core/gates.d.ts +9 -2
- package/dist/lib/core/gates.js +13 -2
- package/dist/lib/core/health.js +15 -0
- package/dist/lib/core/incident-search.d.ts +19 -0
- package/dist/lib/core/incident-search.js +32 -0
- package/dist/lib/core/model-pricing.d.ts +31 -0
- package/dist/lib/core/model-pricing.js +74 -0
- package/dist/lib/core/registry.d.ts +194 -0
- package/dist/lib/core/registry.js +194 -0
- package/dist/lib/core/release.d.ts +194 -0
- package/dist/lib/core/risk-collect.d.ts +19 -0
- package/dist/lib/core/risk-collect.js +173 -0
- package/dist/lib/drift-sentinel.d.ts +59 -0
- package/dist/lib/drift-sentinel.js +126 -0
- package/dist/lib/generators/memory-generator.js +691 -691
- package/dist/lib/generators/nest-generator.js +412 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/workspace.js +29 -29
- package/dist/packages/adapter-git/src/index.d.ts +1 -1
- package/dist/packages/adapter-git/src/index.js +11 -6
- package/dist/packages/adapter-nest/src/index.d.ts +19 -0
- package/dist/packages/adapter-nest/src/index.js +26 -1
- package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
- package/dist/packages/adapter-sqlite/src/index.js +61 -12
- package/dist/packages/contracts/src/index.d.ts +33 -0
- package/dist/packages/contracts/src/index.js +13 -0
- package/dist/packages/core/src/index.d.ts +12 -0
- package/dist/packages/core/src/index.js +29 -0
- package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
- package/dist/packages/engineering/architecture/src/index.js +131 -0
- package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
- package/dist/packages/engineering/evidence/src/index.js +31 -0
- package/dist/packages/engineering/identity/src/index.d.ts +57 -0
- package/dist/packages/engineering/identity/src/index.js +88 -0
- package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
- package/dist/packages/engineering/monitoring/src/index.js +40 -0
- package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
- package/dist/packages/engineering/provenance/src/index.js +21 -0
- package/dist/packages/engineering/risk/src/index.d.ts +89 -0
- package/dist/packages/engineering/risk/src/index.js +120 -0
- package/dist/packages/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.js +27 -4
- package/dist/packages/mcp/src/index.js +27 -8
- package/dist/packages/orchestration/src/index.d.ts +11 -1
- package/dist/packages/orchestration/src/index.js +34 -7
- package/dist/packages/policy/src/index.d.ts +40 -0
- package/dist/packages/policy/src/index.js +39 -4
- package/dist/packages/runtime/src/index.js +3 -0
- package/dist/packages/sandbox/src/index.d.ts +47 -0
- package/dist/packages/sandbox/src/index.js +59 -0
- package/dist/packages/validator/src/index.d.ts +8 -0
- package/dist/packages/validator/src/index.js +21 -6
- package/dist/scripts/adr.d.ts +17 -0
- package/dist/scripts/adr.js +152 -0
- package/dist/scripts/agent-harness.js +72 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/agent.d.ts +27 -0
- package/dist/scripts/agent.js +249 -0
- package/dist/scripts/architecture.d.ts +16 -0
- package/dist/scripts/architecture.js +186 -0
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/cost-economy.d.ts +2 -0
- package/dist/scripts/cost-economy.js +79 -0
- package/dist/scripts/demo-autonomy.js +13 -6
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/drift-check.d.ts +17 -0
- package/dist/scripts/drift-check.js +63 -0
- package/dist/scripts/engineer.d.ts +20 -0
- package/dist/scripts/engineer.js +208 -0
- package/dist/scripts/evidence.d.ts +12 -0
- package/dist/scripts/evidence.js +55 -0
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/gates.d.ts +6 -2
- package/dist/scripts/gates.js +14 -4
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/incident.d.ts +19 -0
- package/dist/scripts/incident.js +103 -0
- package/dist/scripts/llm-fit.js +32 -3
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/provenance.d.ts +14 -0
- package/dist/scripts/provenance.js +114 -0
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/risk.d.ts +15 -0
- package/dist/scripts/risk.js +81 -0
- package/dist/scripts/simulate.d.ts +20 -0
- package/dist/scripts/simulate.js +150 -0
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +44 -44
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
- 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/manual-operacional-cli-sdd-gsd.md +1014 -1014
- 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/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 +20 -20
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
- package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
- package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -157
- 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/agent-identity-reputation/plan.md +133 -0
- package/specs/agent-identity-reputation/spec.md +125 -0
- package/specs/agent-identity-reputation/tasks.md +51 -0
- package/specs/agent-runtime-monitoring/plan.md +78 -0
- package/specs/agent-runtime-monitoring/spec.md +92 -0
- package/specs/agent-runtime-monitoring/tasks.md +39 -0
- package/specs/ai-code-provenance/plan.md +71 -0
- package/specs/ai-code-provenance/spec.md +97 -0
- package/specs/ai-code-provenance/tasks.md +39 -0
- package/specs/architecture-constitution/plan.md +110 -0
- package/specs/architecture-constitution/spec.md +114 -0
- package/specs/architecture-constitution/tasks.md +58 -0
- package/specs/change-risk-engine/plan.md +130 -0
- package/specs/change-risk-engine/spec.md +119 -0
- package/specs/change-risk-engine/tasks.md +72 -0
- 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/cost-aware-autonomy-budget/spec.md +102 -0
- 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/drift-sentinel/spec.md +117 -0
- package/specs/engineer-facade-extension/plan.md +71 -0
- package/specs/engineer-facade-extension/spec.md +98 -0
- package/specs/engineer-facade-extension/tasks.md +36 -0
- package/specs/engineering-evidence-ledger/plan.md +121 -0
- package/specs/engineering-evidence-ledger/spec.md +90 -0
- package/specs/engineering-evidence-ledger/tasks.md +54 -0
- package/specs/engineering-graph-extensions/plan.md +92 -0
- package/specs/engineering-graph-extensions/spec.md +101 -0
- package/specs/engineering-graph-extensions/tasks.md +60 -0
- package/specs/engineering-intelligence/spec.md +177 -0
- 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/learning-loop-incidents/plan.md +59 -0
- package/specs/learning-loop-incidents/spec.md +93 -0
- package/specs/learning-loop-incidents/tasks.md +36 -0
- 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/predictive-change-simulation/plan.md +109 -0
- package/specs/predictive-change-simulation/spec.md +107 -0
- package/specs/predictive-change-simulation/tasks.md +41 -0
- 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/spec.md +23 -23
- 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/smart-agent-routing/plan.md +55 -0
- package/specs/smart-agent-routing/spec.md +85 -0
- package/specs/smart-agent-routing/tasks.md +26 -0
- 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/README.md
CHANGED
|
@@ -1,125 +1,132 @@
|
|
|
1
|
-
<h1 align="center">🔨 Forja</h1>
|
|
2
|
-
|
|
3
|
-
<p align="center">
|
|
4
|
-
<strong>Turn coding AI into an engineering team with process and memory:<br>every project starts from a spec, every decision becomes an ADR, and nothing is lost between sessions.</strong>
|
|
5
|
-
</p>
|
|
6
|
-
|
|
7
|
-
<p align="center">
|
|
8
|
-
<a href="https://www.npmjs.com/package/forjajs"><img src="https://img.shields.io/npm/v/forjajs?style=flat-square&color=cb3837&logo=npm" alt="npm"></a>
|
|
9
|
-
<img src="https://github.com/allanpablo/forja/actions/workflows/ci.yml/badge.svg" alt="CI">
|
|
10
|
-
<img src="https://img.shields.io/badge/operation-CLI--first-3553ff?style=flat-square" alt="CLI-first">
|
|
11
|
-
<img src="https://img.shields.io/badge/agents-6_roles-orange?style=flat-square" alt="6 agents">
|
|
12
|
-
<img src="https://img.shields.io/badge/pipeline-SDD_+_GSD-teal?style=flat-square" alt="SDD+GSD">
|
|
13
|
-
<img src="https://img.shields.io/badge/memory-SQLite_FTS5-green?style=flat-square" alt="Memory">
|
|
14
|
-
<img src="https://img.shields.io/badge/node-%E2%89%A520-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node >= 20">
|
|
15
|
-
<img src="https://img.shields.io/badge/license-MIT-1a1a1a?style=flat-square" alt="MIT">
|
|
16
|
-
<img src="https://img.shields.io/badge/PRs-welcome-8957e5?style=flat-square" alt="PRs welcome">
|
|
17
|
-
</p>
|
|
18
|
-
|
|
19
|
-
<p align="center"><sub>🌐 <strong>English</strong> · <a href="README.pt-BR.md">Português</a></sub></p>
|
|
20
|
-
|
|
21
|
-
---
|
|
22
|
-
|
|
23
|
-
## Why Forja exists
|
|
24
|
-
|
|
25
|
-
Coding agents are **amnesiac and undisciplined**: every session starts from zero, architecture
|
|
26
|
-
decisions evaporate, code drifts from intent — and if you run several products at once, you pay
|
|
27
|
-
that tax multiplied by N.
|
|
28
|
-
|
|
29
|
-
**Forja** is the studio around the AI. It coordinates **6 agent roles** through a
|
|
30
|
-
**Spec-Driven (SDD)** + **Get-Stuff-Done (GSD)** pipeline, keeps a **hierarchical memory** indexed
|
|
31
|
-
in SQLite that survives across sessions, and ties it all together behind **a single core CLI with
|
|
32
|
-
gates and an audit trail** (`forja`, ADR-0020). Multi-AI by design (Claude, Copilot, Gemini,
|
|
33
|
-
Codex). Everything is driven from the CLI.
|
|
34
|
-
|
|
35
|
-
**Who it's for**: the solo dev or small team running multiple products with AI as the main
|
|
36
|
-
workforce — and needing the discipline of a big team without having one.
|
|
37
|
-
|
|
38
|
-
## The 3 pillars
|
|
39
|
-
|
|
40
|
-
| Pillar | What it delivers | Proof |
|
|
41
|
-
|---|---|---|
|
|
42
|
-
| **Memory that survives** | hierarchical, searchable context, shared across sessions and AIs | SQLite FTS5, smart-context (ADR-0003) |
|
|
43
|
-
| **Process that governs** | nothing becomes code without a spec; nothing structural without an ADR; every command audited | SDD+GSD, 7-field handoffs (ADR-0005), `forja` core (ADR-0020) |
|
|
44
|
-
| **A factory, not a single project** | multi-product workspace, per-project agent teams | ADR-0019, harness, codegraph (ADR-0017) |
|
|
45
|
-
|
|
46
|
-
> This repository is the **engine (framework)** — it does not host production apps.
|
|
47
|
-
> Your products live in the **Forja workspace** (`~/forja-workspace` by default), outside this repo.
|
|
48
|
-
> See ADR-0019 for the rationale.
|
|
49
|
-
|
|
50
|
-
## Forja in 60 seconds
|
|
51
|
-
|
|
52
|
-
```console
|
|
53
|
-
$ forja spec:new pix-payments
|
|
54
|
-
✓ Spec created: specs/pix-payments/spec.md # nothing becomes code without this
|
|
55
|
-
|
|
56
|
-
$ forja gsd:handoff plan pix-payments
|
|
57
|
-
Handoff recorded: product → sdd-architect # 7 fields, auditable (ADR-0005)
|
|
58
|
-
|
|
59
|
-
$ forja code:impact processPayment
|
|
60
|
-
Impact map: processPayment (depth 2) # blast radius BEFORE you edit
|
|
61
|
-
--- Direct callers ---
|
|
62
|
-
BillingController.charge · RetryWorker.run
|
|
63
|
-
|
|
64
|
-
$ forja gsd:check pix-payments
|
|
65
|
-
OK GSD runbook OK Spec directory
|
|
66
|
-
OK SDD spec check OK Codegraph
|
|
67
|
-
Result: baseline gates ready. # executable governance, not a checklist
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
And each command above was recorded in `.context/forja-runs.jsonl` — when governance asks "was the
|
|
71
|
-
process followed?", the answer is a file, not a promise.
|
|
72
|
-
|
|
73
|
-
## Why not just…?
|
|
74
|
-
|
|
75
|
-
| Alternative | Where it stops | What Forja adds |
|
|
76
|
-
|---|---|---|
|
|
77
|
-
| **Plain Claude Code / Copilot** | brilliant in-session, amnesiac between sessions | FTS5 memory + process + audit around the AI |
|
|
78
|
-
| **LangGraph / CrewAI** | infrastructure to *build* agents | the layer above: it *operates* the agent team day to day |
|
|
79
|
-
| **Templates & spec kits** | stop once the spec is written | the full pipeline through governance, with gates that execute |
|
|
80
|
-
|
|
81
|
-
## Key capabilities
|
|
82
|
-
|
|
83
|
-
- **Single core CLI** — every process command goes through `forja <command>`: a declarative
|
|
84
|
-
registry, cross-cutting gates (workspace), and append-only audit in
|
|
85
|
-
`.context/forja-runs.jsonl` (ADR-0020).
|
|
86
|
-
- **Multi-agent orchestration** — 6 roles (orchestrator, context-engineer, sdd-architect, product,
|
|
87
|
-
marketing, governance) with tracked handoffs (7 fields, ADR-0005).
|
|
88
|
-
- **Hierarchical memory** — global → domain → task → summary, with FTS5 search and *smart-context*
|
|
89
|
-
in 3 modes (ADR-0003).
|
|
90
|
-
- **SDD + GSD pipeline** — `spec → plan → tasks → check`, decisions recorded as ADRs.
|
|
91
|
-
- **Self-verification (invariants that run)** — the framework proves itself: a family of gates guards
|
|
92
|
-
each frontier (core, tarball, doc coherence, agent topology, generated project), and `check:all`
|
|
93
|
-
runs the whole battery into a single verdict. Governance stops depending on discipline — it becomes
|
|
94
|
-
harness.
|
|
95
|
-
- **Token economy measured, not asserted** — memory (the `context.md` as a map) saves ~60% vs
|
|
96
|
-
exploring cold, and `token:economy` **proves** it across your domains. `code:context` delivers the
|
|
97
|
-
map ready to paste; `memory:audit` guarantees it doesn't lie about the code.
|
|
98
|
-
- **Project generation** — `project:new` scaffolds a full project (memory, agents, multi-AI
|
|
99
|
-
instructions, a NestJS backend as the default boilerplate) and registers the record; `project:upgrade`
|
|
100
|
-
brings new scaffold pieces to already-generated projects without touching the user's code.
|
|
1
|
+
<h1 align="center">🔨 Forja</h1>
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<strong>Turn coding AI into an engineering team with process and memory:<br>every project starts from a spec, every decision becomes an ADR, and nothing is lost between sessions.</strong>
|
|
5
|
+
</p>
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
<a href="https://www.npmjs.com/package/forjajs"><img src="https://img.shields.io/npm/v/forjajs?style=flat-square&color=cb3837&logo=npm" alt="npm"></a>
|
|
9
|
+
<img src="https://github.com/allanpablo/forja/actions/workflows/ci.yml/badge.svg" alt="CI">
|
|
10
|
+
<img src="https://img.shields.io/badge/operation-CLI--first-3553ff?style=flat-square" alt="CLI-first">
|
|
11
|
+
<img src="https://img.shields.io/badge/agents-6_roles-orange?style=flat-square" alt="6 agents">
|
|
12
|
+
<img src="https://img.shields.io/badge/pipeline-SDD_+_GSD-teal?style=flat-square" alt="SDD+GSD">
|
|
13
|
+
<img src="https://img.shields.io/badge/memory-SQLite_FTS5-green?style=flat-square" alt="Memory">
|
|
14
|
+
<img src="https://img.shields.io/badge/node-%E2%89%A520-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node >= 20">
|
|
15
|
+
<img src="https://img.shields.io/badge/license-MIT-1a1a1a?style=flat-square" alt="MIT">
|
|
16
|
+
<img src="https://img.shields.io/badge/PRs-welcome-8957e5?style=flat-square" alt="PRs welcome">
|
|
17
|
+
</p>
|
|
18
|
+
|
|
19
|
+
<p align="center"><sub>🌐 <strong>English</strong> · <a href="README.pt-BR.md">Português</a></sub></p>
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Why Forja exists
|
|
24
|
+
|
|
25
|
+
Coding agents are **amnesiac and undisciplined**: every session starts from zero, architecture
|
|
26
|
+
decisions evaporate, code drifts from intent — and if you run several products at once, you pay
|
|
27
|
+
that tax multiplied by N.
|
|
28
|
+
|
|
29
|
+
**Forja** is the studio around the AI. It coordinates **6 agent roles** through a
|
|
30
|
+
**Spec-Driven (SDD)** + **Get-Stuff-Done (GSD)** pipeline, keeps a **hierarchical memory** indexed
|
|
31
|
+
in SQLite that survives across sessions, and ties it all together behind **a single core CLI with
|
|
32
|
+
gates and an audit trail** (`forja`, ADR-0020). Multi-AI by design (Claude, Copilot, Gemini,
|
|
33
|
+
Codex). Everything is driven from the CLI.
|
|
34
|
+
|
|
35
|
+
**Who it's for**: the solo dev or small team running multiple products with AI as the main
|
|
36
|
+
workforce — and needing the discipline of a big team without having one.
|
|
37
|
+
|
|
38
|
+
## The 3 pillars
|
|
39
|
+
|
|
40
|
+
| Pillar | What it delivers | Proof |
|
|
41
|
+
|---|---|---|
|
|
42
|
+
| **Memory that survives** | hierarchical, searchable context, shared across sessions and AIs | SQLite FTS5, smart-context (ADR-0003) |
|
|
43
|
+
| **Process that governs** | nothing becomes code without a spec; nothing structural without an ADR; every command audited | SDD+GSD, 7-field handoffs (ADR-0005), `forja` core (ADR-0020) |
|
|
44
|
+
| **A factory, not a single project** | multi-product workspace, per-project agent teams | ADR-0019, harness, codegraph (ADR-0017) |
|
|
45
|
+
|
|
46
|
+
> This repository is the **engine (framework)** — it does not host production apps.
|
|
47
|
+
> Your products live in the **Forja workspace** (`~/forja-workspace` by default), outside this repo.
|
|
48
|
+
> See ADR-0019 for the rationale.
|
|
49
|
+
|
|
50
|
+
## Forja in 60 seconds
|
|
51
|
+
|
|
52
|
+
```console
|
|
53
|
+
$ forja spec:new pix-payments
|
|
54
|
+
✓ Spec created: specs/pix-payments/spec.md # nothing becomes code without this
|
|
55
|
+
|
|
56
|
+
$ forja gsd:handoff plan pix-payments
|
|
57
|
+
Handoff recorded: product → sdd-architect # 7 fields, auditable (ADR-0005)
|
|
58
|
+
|
|
59
|
+
$ forja code:impact processPayment
|
|
60
|
+
Impact map: processPayment (depth 2) # blast radius BEFORE you edit
|
|
61
|
+
--- Direct callers ---
|
|
62
|
+
BillingController.charge · RetryWorker.run
|
|
63
|
+
|
|
64
|
+
$ forja gsd:check pix-payments
|
|
65
|
+
OK GSD runbook OK Spec directory
|
|
66
|
+
OK SDD spec check OK Codegraph
|
|
67
|
+
Result: baseline gates ready. # executable governance, not a checklist
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
And each command above was recorded in `.context/forja-runs.jsonl` — when governance asks "was the
|
|
71
|
+
process followed?", the answer is a file, not a promise.
|
|
72
|
+
|
|
73
|
+
## Why not just…?
|
|
74
|
+
|
|
75
|
+
| Alternative | Where it stops | What Forja adds |
|
|
76
|
+
|---|---|---|
|
|
77
|
+
| **Plain Claude Code / Copilot** | brilliant in-session, amnesiac between sessions | FTS5 memory + process + audit around the AI |
|
|
78
|
+
| **LangGraph / CrewAI** | infrastructure to *build* agents | the layer above: it *operates* the agent team day to day |
|
|
79
|
+
| **Templates & spec kits** | stop once the spec is written | the full pipeline through governance, with gates that execute |
|
|
80
|
+
|
|
81
|
+
## Key capabilities
|
|
82
|
+
|
|
83
|
+
- **Single core CLI** — every process command goes through `forja <command>`: a declarative
|
|
84
|
+
registry, cross-cutting gates (workspace), and append-only audit in
|
|
85
|
+
`.context/forja-runs.jsonl` (ADR-0020).
|
|
86
|
+
- **Multi-agent orchestration** — 6 roles (orchestrator, context-engineer, sdd-architect, product,
|
|
87
|
+
marketing, governance) with tracked handoffs (7 fields, ADR-0005).
|
|
88
|
+
- **Hierarchical memory** — global → domain → task → summary, with FTS5 search and *smart-context*
|
|
89
|
+
in 3 modes (ADR-0003).
|
|
90
|
+
- **SDD + GSD pipeline** — `spec → plan → tasks → check`, decisions recorded as ADRs.
|
|
91
|
+
- **Self-verification (invariants that run)** — the framework proves itself: a family of gates guards
|
|
92
|
+
each frontier (core, tarball, doc coherence, agent topology, generated project), and `check:all`
|
|
93
|
+
runs the whole battery into a single verdict. Governance stops depending on discipline — it becomes
|
|
94
|
+
harness.
|
|
95
|
+
- **Token economy measured, not asserted** — memory (the `context.md` as a map) saves ~60% vs
|
|
96
|
+
exploring cold, and `token:economy` **proves** it across your domains. `code:context` delivers the
|
|
97
|
+
map ready to paste; `memory:audit` guarantees it doesn't lie about the code.
|
|
98
|
+
- **Project generation** — `project:new` scaffolds a full project (memory, agents, multi-AI
|
|
99
|
+
instructions, a NestJS backend as the default boilerplate) and registers the record; `project:upgrade`
|
|
100
|
+
brings new scaffold pieces to already-generated projects without touching the user's code.
|
|
101
101
|
- **3 integrated capabilities** (ADR-0016): **codegraph** (code analysis via MCP), **harness**
|
|
102
102
|
(agent-team design), **ai-engineering** (knowledge base).
|
|
103
103
|
- **LLM Fit Loop** — adapters de CLI, perfis no workspace, probes sem custo, observações e
|
|
104
104
|
recomendação determinística por papel/tarefa; credenciais nunca entram no Forja.
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
#
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
forja
|
|
122
|
-
|
|
105
|
+
- **Engineering Control Plane** (v3.0, ADR-0078) — the Engineering Graph turns ADRs/SPECs into
|
|
106
|
+
first-class, queryable nodes; the Architecture Constitution checks real code against decisions
|
|
107
|
+
already recorded; the Change Risk Engine scores a change 0-100 with named, evidenced factors;
|
|
108
|
+
`forja simulate` tests a ref in an isolated worktree and never promotes on its own. One façade,
|
|
109
|
+
`forja engineer "<goal>"`, composes all of it — context, relevant ADRs, architecture check, risk,
|
|
110
|
+
recommended agents, similar past incidents — before you start. Every score is information for a
|
|
111
|
+
human/policy rule to consult, never an autonomous decision on its own.
|
|
112
|
+
|
|
113
|
+
## ⚡ Quick start
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
# Install (the package is forjajs; the command is forja)
|
|
117
|
+
npm install -g forjajs
|
|
118
|
+
forja # help grouped by domain
|
|
119
|
+
|
|
120
|
+
# Prepare the production workspace (the fixed home for your projects)
|
|
121
|
+
forja workspace:init
|
|
122
|
+
|
|
123
|
+
# Create a new project (generated in ~/forja-workspace/projects/<name>)
|
|
124
|
+
forja project:new my-project --ai claude,copilot
|
|
125
|
+
|
|
126
|
+
# Enter the SDD/GSD cycle for the first feature
|
|
127
|
+
forja spec:new my-feature
|
|
128
|
+
forja spec:plan my-feature
|
|
129
|
+
forja spec:tasks my-feature
|
|
123
130
|
forja spec:check my-feature
|
|
124
131
|
```
|
|
125
132
|
|
|
@@ -134,113 +141,141 @@ forja spec:set-status <feature> <spec|plan|tasks> <draft|approved>
|
|
|
134
141
|
```
|
|
135
142
|
|
|
136
143
|
### Prove supervised autonomy locally
|
|
137
|
-
|
|
138
|
-
The deterministic offline proof uses an external fixture, a real Git worktree,
|
|
139
|
-
human approval, a real `npm test`, diff validation, promotion, SQLite state,
|
|
140
|
-
GraphLoop evidence and a compact handoff:
|
|
141
|
-
|
|
142
|
-
```bash
|
|
143
|
-
npm run demo:autonomy
|
|
144
|
-
```
|
|
145
|
-
|
|
146
|
-
The full flow is documented in [`docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md`](docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md).
|
|
147
|
-
|
|
148
|
-
Measure the deterministic context baseline and cache evidence:
|
|
149
|
-
|
|
150
|
-
```bash
|
|
151
|
-
npm run benchmark:context
|
|
152
|
-
```
|
|
153
|
-
|
|
154
|
-
The sandbox also exposes an explicit, auditable rollback after promotion. Official
|
|
155
|
-
plugin boundaries are available as `@forja/plugin-github` and `@forja/plugin-docker`;
|
|
156
|
-
external network or Docker handlers must be injected and permissioned by the host.
|
|
157
|
-
|
|
158
|
-
> Cloned the repo instead of installing? The same commands run as
|
|
159
|
-
> `node bin/forja.ts <command>` — the npm scripts are just thin aliases of the core.
|
|
160
|
-
> The source is TypeScript and runs natively: **dev needs Node ≥ 22.6** (type stripping). The
|
|
161
|
-
> *published* package ships `dist/*.js` and runs on **Node ≥ 20** — the `release-gate` proves it
|
|
162
|
-
> every release (SPEC-012).
|
|
163
|
-
|
|
164
|
-
Step by step on **create vs update** a project: [`docs/processo-projeto.md`](docs/processo-projeto.md).
|
|
165
|
-
|
|
166
|
-
## How it works — the process
|
|
167
|
-
|
|
168
|
-
```
|
|
169
|
-
💡 Demand
|
|
170
|
-
├─ project does NOT exist ─► project:new + boilerplate + harness (designs the team)
|
|
171
|
-
└─ project DOES exist ─────► overlay --only-memory + codegraph init (understands the code)
|
|
172
|
-
│
|
|
173
|
-
▼
|
|
174
|
-
CLI-first CYCLE (docs/fluxo.md):
|
|
175
|
-
1·Understand → 2·Specify → 3·Architect → 4·Decompose → 5·Implement → 6·Govern → ✅
|
|
176
|
-
```
|
|
177
|
-
|
|
178
|
-
| Step | Role | Capability |
|
|
179
|
-
|------|------|------------|
|
|
180
|
-
| 1 Understand | context-engineer | codegraph · ai-engineering |
|
|
181
|
-
| 2 Specify | product | — |
|
|
182
|
-
| 3 Architect | sdd-architect | harness · ADR |
|
|
183
|
-
| 4 Decompose | sdd-architect | — |
|
|
184
|
-
| 5 Implement | orchestrator + worker | codegraph (MCP) |
|
|
185
|
-
| 6 Govern | governance | codegraph (`affected`) |
|
|
186
|
-
|
|
187
|
-
Full cycle map: [`docs/fluxo.md`](docs/fluxo.md).
|
|
188
|
-
|
|
189
|
-
## The 3 integrated capabilities
|
|
190
|
-
|
|
191
|
-
| Capability | Role | How to use |
|
|
192
|
-
|---|---|---|
|
|
193
|
-
| **codegraph** | code analysis (local MCP) | `forja code:index` · `codegraph explore "<area>"` · MCP tools `codegraph_explore`/`codegraph_node` |
|
|
194
|
-
| **harness** | agent-team design (plugin) | in a Claude Code session: _"build a harness for this project"_ → generates `.claude/agents` + `.claude/skills` |
|
|
195
|
-
| **ai-engineering** | knowledge base (reference) | see [`docs/capacidades-externas.md`](docs/capacidades-externas.md) |
|
|
196
|
-
|
|
197
|
-
Details and reinstall: [`docs/capacidades-externas.md`](docs/capacidades-externas.md) · [ADR-0016](memory/90-decisions/0016-integracao-capacidades-externas.md).
|
|
198
|
-
|
|
199
|
-
## The `forja` core
|
|
200
|
-
|
|
201
|
-
Every process command goes through a single entry point (ADR-0020):
|
|
202
|
-
|
|
203
|
-
```bash
|
|
204
|
-
forja # help grouped by domain
|
|
205
|
-
forja <command> [args] # in a cloned repo: node bin/forja.ts <command>
|
|
206
|
-
```
|
|
207
|
-
|
|
208
|
-
The core applies **gates** before running (e.g. product commands fail fast without a workspace) and
|
|
209
|
-
records an **audit** of each run (command, args, exit code, duration) in
|
|
210
|
-
`<workspace>/.context/forja-runs.jsonl` — the trail governance uses at review. The repo's npm
|
|
211
|
-
scripts are thin aliases that route through the core.
|
|
212
|
-
|
|
213
|
-
## Essential commands
|
|
214
|
-
|
|
215
|
-
```bash
|
|
216
|
-
# Workspace & projects
|
|
217
|
-
forja workspace:init # create ~/forja-workspace
|
|
218
|
-
forja project:new <name> --ai claude,copilot # create a project in the workspace
|
|
219
|
-
forja project:list # list workspace projects
|
|
220
|
-
forja workspace:project:check <name> # validate standards in a workspace project
|
|
221
|
-
|
|
222
|
-
# SDD pipeline
|
|
223
|
-
forja spec:new <slug> # also: spec:plan · spec:tasks · spec:check
|
|
224
|
-
|
|
225
|
-
# Sprint & handoffs (GSD)
|
|
226
|
-
forja sprint:start # also: sprint:status · sprint:complete
|
|
227
|
-
forja gsd:plan <slug> # GSD runbook in .context/
|
|
228
|
-
forja gsd:handoff <intent> <slug> # role-to-role handoff (ADR-0005)
|
|
229
|
-
forja gsd:check <slug> # baseline runbook gates
|
|
230
|
-
forja orchestrate "<goal>" --slug <s> # open a run: the SDD/GSD chain as a gated state machine (SPEC-021)
|
|
231
|
-
forja orchestrate:status <slug> # the machine state: stages, gates, verdicts
|
|
232
|
-
forja orchestrate:advance <slug> # run the stage gate; green → next; red → blocked
|
|
233
|
-
|
|
234
|
-
# Code analysis (codegraph)
|
|
235
|
-
forja code:check # trustworthy index (worktree + freshness)
|
|
236
|
-
forja code:impact <symbol> # callers + blast radius before you edit
|
|
237
|
-
forja code:query "<term>" # also: code:index · code:sync · code:status
|
|
238
|
-
|
|
239
|
-
#
|
|
240
|
-
forja
|
|
241
|
-
forja
|
|
144
|
+
|
|
145
|
+
The deterministic offline proof uses an external fixture, a real Git worktree,
|
|
146
|
+
human approval, a real `npm test`, diff validation, promotion, SQLite state,
|
|
147
|
+
GraphLoop evidence and a compact handoff:
|
|
148
|
+
|
|
149
|
+
```bash
|
|
150
|
+
npm run demo:autonomy
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
The full flow is documented in [`docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md`](docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md).
|
|
154
|
+
|
|
155
|
+
Measure the deterministic context baseline and cache evidence:
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
npm run benchmark:context
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
The sandbox also exposes an explicit, auditable rollback after promotion. Official
|
|
162
|
+
plugin boundaries are available as `@forja/plugin-github` and `@forja/plugin-docker`;
|
|
163
|
+
external network or Docker handlers must be injected and permissioned by the host.
|
|
164
|
+
|
|
165
|
+
> Cloned the repo instead of installing? The same commands run as
|
|
166
|
+
> `node bin/forja.ts <command>` — the npm scripts are just thin aliases of the core.
|
|
167
|
+
> The source is TypeScript and runs natively: **dev needs Node ≥ 22.6** (type stripping). The
|
|
168
|
+
> *published* package ships `dist/*.js` and runs on **Node ≥ 20** — the `release-gate` proves it
|
|
169
|
+
> every release (SPEC-012).
|
|
170
|
+
|
|
171
|
+
Step by step on **create vs update** a project: [`docs/processo-projeto.md`](docs/processo-projeto.md).
|
|
172
|
+
|
|
173
|
+
## How it works — the process
|
|
174
|
+
|
|
175
|
+
```
|
|
176
|
+
💡 Demand
|
|
177
|
+
├─ project does NOT exist ─► project:new + boilerplate + harness (designs the team)
|
|
178
|
+
└─ project DOES exist ─────► overlay --only-memory + codegraph init (understands the code)
|
|
179
|
+
│
|
|
180
|
+
▼
|
|
181
|
+
CLI-first CYCLE (docs/fluxo.md):
|
|
182
|
+
1·Understand → 2·Specify → 3·Architect → 4·Decompose → 5·Implement → 6·Govern → ✅
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
| Step | Role | Capability |
|
|
186
|
+
|------|------|------------|
|
|
187
|
+
| 1 Understand | context-engineer | codegraph · ai-engineering |
|
|
188
|
+
| 2 Specify | product | — |
|
|
189
|
+
| 3 Architect | sdd-architect | harness · ADR |
|
|
190
|
+
| 4 Decompose | sdd-architect | — |
|
|
191
|
+
| 5 Implement | orchestrator + worker | codegraph (MCP) |
|
|
192
|
+
| 6 Govern | governance | codegraph (`affected`) |
|
|
193
|
+
|
|
194
|
+
Full cycle map: [`docs/fluxo.md`](docs/fluxo.md).
|
|
195
|
+
|
|
196
|
+
## The 3 integrated capabilities
|
|
197
|
+
|
|
198
|
+
| Capability | Role | How to use |
|
|
199
|
+
|---|---|---|
|
|
200
|
+
| **codegraph** | code analysis (local MCP) | `forja code:index` · `codegraph explore "<area>"` · MCP tools `codegraph_explore`/`codegraph_node` |
|
|
201
|
+
| **harness** | agent-team design (plugin) | in a Claude Code session: _"build a harness for this project"_ → generates `.claude/agents` + `.claude/skills` |
|
|
202
|
+
| **ai-engineering** | knowledge base (reference) | see [`docs/capacidades-externas.md`](docs/capacidades-externas.md) |
|
|
203
|
+
|
|
204
|
+
Details and reinstall: [`docs/capacidades-externas.md`](docs/capacidades-externas.md) · [ADR-0016](memory/90-decisions/0016-integracao-capacidades-externas.md).
|
|
205
|
+
|
|
206
|
+
## The `forja` core
|
|
207
|
+
|
|
208
|
+
Every process command goes through a single entry point (ADR-0020):
|
|
209
|
+
|
|
210
|
+
```bash
|
|
211
|
+
forja # help grouped by domain
|
|
212
|
+
forja <command> [args] # in a cloned repo: node bin/forja.ts <command>
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
The core applies **gates** before running (e.g. product commands fail fast without a workspace) and
|
|
216
|
+
records an **audit** of each run (command, args, exit code, duration) in
|
|
217
|
+
`<workspace>/.context/forja-runs.jsonl` — the trail governance uses at review. The repo's npm
|
|
218
|
+
scripts are thin aliases that route through the core.
|
|
219
|
+
|
|
220
|
+
## Essential commands
|
|
221
|
+
|
|
222
|
+
```bash
|
|
223
|
+
# Workspace & projects
|
|
224
|
+
forja workspace:init # create ~/forja-workspace
|
|
225
|
+
forja project:new <name> --ai claude,copilot # create a project in the workspace
|
|
226
|
+
forja project:list # list workspace projects
|
|
227
|
+
forja workspace:project:check <name> # validate standards in a workspace project
|
|
228
|
+
|
|
229
|
+
# SDD pipeline
|
|
230
|
+
forja spec:new <slug> # also: spec:plan · spec:tasks · spec:check
|
|
231
|
+
|
|
232
|
+
# Sprint & handoffs (GSD)
|
|
233
|
+
forja sprint:start # also: sprint:status · sprint:complete
|
|
234
|
+
forja gsd:plan <slug> # GSD runbook in .context/
|
|
235
|
+
forja gsd:handoff <intent> <slug> # role-to-role handoff (ADR-0005)
|
|
236
|
+
forja gsd:check <slug> # baseline runbook gates
|
|
237
|
+
forja orchestrate "<goal>" --slug <s> # open a run: the SDD/GSD chain as a gated state machine (SPEC-021)
|
|
238
|
+
forja orchestrate:status <slug> # the machine state: stages, gates, verdicts
|
|
239
|
+
forja orchestrate:advance <slug> # run the stage gate; green → next; red → blocked
|
|
240
|
+
|
|
241
|
+
# Code analysis (codegraph)
|
|
242
|
+
forja code:check # trustworthy index (worktree + freshness)
|
|
243
|
+
forja code:impact <symbol> # callers + blast radius before you edit
|
|
244
|
+
forja code:query "<term>" # also: code:index · code:sync · code:status
|
|
245
|
+
forja drift:check [--domain <d>] # reindex + flag 'verified' relations that stopped being true
|
|
246
|
+
forja adr:list # ADRs as first-class graph nodes, with status (SPEC-032)
|
|
247
|
+
forja adr:show <id> # status, source file, constraints
|
|
248
|
+
forja adr:impact <id> # who/what depends on this ADR — GraphLoop.impact()
|
|
249
|
+
forja adr:graph [<id>] # ADR/SPEC subgraph as JSON
|
|
250
|
+
forja architecture:compile # ADRs (## Constraints) → constitution.json (SPEC-033)
|
|
251
|
+
forja architecture:check # real code vs. the compiled Constitution
|
|
252
|
+
forja architecture:status # active/proposed rules, last compile
|
|
253
|
+
forja architecture:explain <rule-id> # source ADR, original text, severity
|
|
254
|
+
forja architecture:approve <rule-id> # promotes a proposed rule to active (via ApprovalLedger)
|
|
255
|
+
forja risk:assess [ref] # 0-100 change risk score, 7 named factors (SPEC-034)
|
|
256
|
+
forja risk:explain <assessment-id> # replays a computed assessment, factor by factor
|
|
257
|
+
forja evidence:show <run-id> # aggregated view of a persisted run (SPEC-035)
|
|
258
|
+
forja engineer "<objetivo>" [--ref <ref>] [--role <role>] [--json] # façade: context + relevant ADRs + architecture check + risk + recommended agents + similar incidents + recommended flow (SPEC-035, SPEC-042)
|
|
259
|
+
forja agent:register <id> --role <role> [--provider <p>] [--model <m>] [--capabilities <c1,c2>] [--domains <d1,d2>] # register/update an agent (SPEC-036)
|
|
260
|
+
forja agent:list # registered agents, with trustLevel if already scored
|
|
261
|
+
forja agent:show <id> # detail of one registered agent
|
|
262
|
+
forja agent:score <id> [--domain <d>] # computes and persists trustLevel/autonomyLevel from real Observations
|
|
263
|
+
forja agent:history <id> # an agent's Observations, most recent first
|
|
264
|
+
forja agent:recommend --role <role> [--domain <d>] # ranks registered agents by fit — information, not assignment (SPEC-037)
|
|
265
|
+
forja simulate <ref> [--command "npm test"] [--json] # test+architecture+risk against an isolated worktree, never promotes (SPEC-038)
|
|
266
|
+
forja provenance:record <run-id> # extracts file<->agent provenance from a persisted RuntimeRun (SPEC-039)
|
|
267
|
+
forja blame <file> # provenance history for a file — file granularity, not line
|
|
268
|
+
forja sbom [--json] # AI-SBOM: provenance report aggregated by agent
|
|
269
|
+
forja agent:monitor <id> [--window-hours <n>] # compares recent behavior against historical baseline — information, never blocks (SPEC-040)
|
|
270
|
+
forja incident:record --title <t> [--description <d>] # records an incident in the Engineering Graph (SPEC-041)
|
|
271
|
+
forja incident:list # recorded incidents, most recent first
|
|
272
|
+
forja incident:similar "<query>" # keyword-based similar-incident suggestion — never applies anything
|
|
273
|
+
|
|
274
|
+
# Memory & context (workspace)
|
|
275
|
+
forja sync:universal # reindex the workspace SQLite FTS5
|
|
276
|
+
forja query:universal "<query>" # FTS5 search
|
|
242
277
|
forja context:smart # smart-context (3 modes, ADR-0003)
|
|
243
|
-
forja memory:compress # archive old runs + VACUUM
|
|
278
|
+
forja memory:compress # archive old runs + VACUUM
|
|
244
279
|
forja memory:extract # extract global knowledge from memory
|
|
245
280
|
|
|
246
281
|
# LLM adapters and evidence
|
|
@@ -249,122 +284,148 @@ forja llm:doctor # verify configured CLIs without invo
|
|
|
249
284
|
forja llm:recommend --role worker --task implementation
|
|
250
285
|
forja llm:run --profile codex --task specs/my-feature/spec.md
|
|
251
286
|
forja llm:eval --scope model --id codex:default
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
forja
|
|
256
|
-
forja
|
|
257
|
-
forja
|
|
258
|
-
forja project:
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
forja audit:
|
|
263
|
-
forja
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
- [`
|
|
317
|
-
- [`docs/
|
|
318
|
-
- [`
|
|
319
|
-
- [`
|
|
320
|
-
- [`
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
- **
|
|
326
|
-
- **
|
|
327
|
-
- **
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
- [x] **
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
- [x]
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
**
|
|
351
|
-
|
|
352
|
-
- [x] **
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
- [x]
|
|
356
|
-
(
|
|
357
|
-
- [
|
|
358
|
-
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
287
|
+
forja cost:economy # real $ cost per model, from the observation store
|
|
288
|
+
|
|
289
|
+
# Quality & release
|
|
290
|
+
forja project:check # framework standards (pre-commit)
|
|
291
|
+
forja tools:doctor # core X-ray; tells permission/lock from corruption; exit 1 if broken
|
|
292
|
+
forja release:check --publish # tarball gate before publishing
|
|
293
|
+
forja project:smoke # generated-project gate; --full installs and builds the backend
|
|
294
|
+
forja project:dashboard # static status report
|
|
295
|
+
|
|
296
|
+
# Governance & audit
|
|
297
|
+
forja audit:sync # project the audit trail into a queryable table
|
|
298
|
+
forja audit:query --failed # query: --failed, --cmd <x>, --since 7d
|
|
299
|
+
forja governance:dashboard # static HTML panel (gates, SDD, audit) — no server
|
|
300
|
+
```
|
|
301
|
+
|
|
302
|
+
## Framework vs workspace separation
|
|
303
|
+
|
|
304
|
+
Forja is split in two:
|
|
305
|
+
|
|
306
|
+
1. **Framework** (this repository): the engine, conventions, scripts, and the framework's own memory.
|
|
307
|
+
2. **Workspace** (`~/forja-workspace` by default): the "fixed home" where product projects, their
|
|
308
|
+
universal memory, and product specs live.
|
|
309
|
+
|
|
310
|
+
The workspace path is resolved by priority:
|
|
311
|
+
|
|
312
|
+
1. `FORJA_WORKSPACE` environment variable
|
|
313
|
+
2. `workspaceRoot` field in `~/.forjarc.json`
|
|
314
|
+
3. Default: `~/forja-workspace`
|
|
315
|
+
|
|
316
|
+
See ADR-0019 for the architectural decision.
|
|
317
|
+
|
|
318
|
+
## Repository structure (framework)
|
|
319
|
+
|
|
320
|
+
```
|
|
321
|
+
bin/ CLIs (forja — the core; init-project, create-memory-nest-kit)
|
|
322
|
+
lib/ Reusable modules; lib/core/ is the invariant engine (registry, checks, health, release, doc-graph, gates)
|
|
323
|
+
scripts/ Automation (sprint-manager, agent-router, sync-universal-memory, …)
|
|
324
|
+
specs/ The framework's own SDD pipeline (spec → plan → tasks)
|
|
325
|
+
boilerplates/ Stack templates (api-rest, saas, ecommerce, microservices, monorepo)
|
|
326
|
+
memory/ Framework memory (00-global … 90-decisions/ADRs)
|
|
327
|
+
docs/ Documentation by persona and by topic (see DOC-MAP.md)
|
|
328
|
+
prompts/ Portable prompts for the 6 roles
|
|
329
|
+
.claude/ Claude Code sub-agents and settings
|
|
330
|
+
projects/ LEGACY — do not use; projects live in the external workspace
|
|
331
|
+
```
|
|
332
|
+
|
|
333
|
+
## Workspace structure
|
|
334
|
+
|
|
335
|
+
```
|
|
336
|
+
~/forja-workspace/
|
|
337
|
+
projects/ # generated products
|
|
338
|
+
memory/
|
|
339
|
+
sqlite/universal.db # SQLite FTS5 for the products
|
|
340
|
+
30-projects/ # project records
|
|
341
|
+
specs/ # product specs
|
|
342
|
+
.context/ # product GSD runbooks
|
|
343
|
+
README.md
|
|
344
|
+
```
|
|
345
|
+
|
|
346
|
+
## Documentation
|
|
347
|
+
|
|
348
|
+
The docs are written in **Brazilian Portuguese** — that's part of the project's identity. The CLI
|
|
349
|
+
output, code, and ADRs are readable regardless of language.
|
|
350
|
+
|
|
351
|
+
- [`DOC-MAP.md`](DOC-MAP.md) — map by role and by topic (start here)
|
|
352
|
+
- [`docs/processo-projeto.md`](docs/processo-projeto.md) — create vs update a project
|
|
353
|
+
- [`docs/fluxo.md`](docs/fluxo.md) — the CLI-first cycle map
|
|
354
|
+
- [`AGENTS.md`](AGENTS.md) — the 6 roles and the topology
|
|
355
|
+
- [`memory/90-decisions/`](memory/90-decisions/) — ADRs with rationale
|
|
356
|
+
- [`CHANGELOG.md`](CHANGELOG.md) — history
|
|
357
|
+
|
|
358
|
+
## Conventions
|
|
359
|
+
|
|
360
|
+
- **CLI-first** — sprints, SDD, GSD, handoffs, and governance by command; the UI is never a gate.
|
|
361
|
+
- **ADRs** — every structural decision becomes `memory/90-decisions/NNNN-title.md`.
|
|
362
|
+
- **Handoffs** — 7 required fields (ADR-0005), stored in SQLite (ADR-0008).
|
|
363
|
+
- **pt-BR** — communication and documentation in Portuguese.
|
|
364
|
+
|
|
365
|
+
## Roadmap
|
|
366
|
+
|
|
367
|
+
The throughline: **turn knowledge that lives as convention into an executable invariant.** Each item
|
|
368
|
+
below either closes a framework frontier with a gate, or carries that pattern into generated projects.
|
|
369
|
+
|
|
370
|
+
**Shipped** (v3.0.0 — Engineering Control Plane, ADR-0078)
|
|
371
|
+
|
|
372
|
+
- [x] **Engineering Graph** — ADRs/SPECs as first-class, queryable nodes (`adr:list/show/impact/graph`),
|
|
373
|
+
deterministic extraction, no LLM (SPEC-032).
|
|
374
|
+
- [x] **Architecture Constitution** — ADR `## Constraints` compile into rules checked against real
|
|
375
|
+
code (`architecture:compile/check/status/explain/approve`), reusing `ApprovalLedger`, not a
|
|
376
|
+
parallel approval system (SPEC-033).
|
|
377
|
+
- [x] **Change Risk Engine** — a 0-100 score with 7 named, evidenced factors (`risk:assess/explain`);
|
|
378
|
+
`PolicyEngine` can optionally consult it (`riskScoreRange`), never a parallel decision engine
|
|
379
|
+
(SPEC-034).
|
|
380
|
+
- [x] **Evidence Ledger + `forja engineer`** — a per-run aggregated view, and the façade that
|
|
381
|
+
composes context + relevant ADRs + architecture + risk + recommended agents + similar incidents +
|
|
382
|
+
recommended flow before you start (SPEC-035, extended in SPEC-042).
|
|
383
|
+
- [x] **Agent Identity & Reputation, Smart Routing** — persistent agent registry with reputation
|
|
384
|
+
derived from real behavior, never self-declared (`agent:register/score/recommend`, SPEC-036/037).
|
|
385
|
+
- [x] **Predictive Change Simulation** — `forja simulate <ref>` tests a ref in an isolated git
|
|
386
|
+
worktree; never promotes on its own (SPEC-038).
|
|
387
|
+
- [x] **AI Code Provenance + Runtime Monitoring** — `forja blame`/`sbom` (file-granularity
|
|
388
|
+
provenance), `agent:monitor` (behavior-anomaly detection vs. an agent's own baseline) — both
|
|
389
|
+
information for `PolicyEngine`/a human to consult, never automatic (SPEC-039/040).
|
|
390
|
+
- [x] **Learning Loop** — `incident:record/list/similar`, keyword-based suggestion, never automatic
|
|
391
|
+
application (SPEC-041).
|
|
392
|
+
- [x] **Autonomous Maintenance readiness** — ADR-0079 documents the guardrails any future real
|
|
393
|
+
autonomous-maintenance spec must respect; deliberately not enabled yet, by the vision's own design.
|
|
394
|
+
|
|
395
|
+
**Shipped** (through v1.6.0)
|
|
396
|
+
|
|
397
|
+
- [x] **Gate family** — every framework frontier is guarded by an invariant that runs: core
|
|
398
|
+
(`tools:doctor`, ADR-0023), tarball (`release:check`, ADR-0024), doc + ADR + agent-topology
|
|
399
|
+
coherence (ADR-0025, SPEC-019), generated project (`project:smoke`, ADR-0029). And `check:all`
|
|
400
|
+
runs the whole battery into one verdict (SPEC-020).
|
|
401
|
+
- [x] **TypeScript migration complete** — source 100% `.ts`, ships `dist/`, `noImplicitAny` ON. Found
|
|
402
|
+
latent bugs no test caught (SPEC-012).
|
|
403
|
+
- [x] **Memory economy as a system** — **measured** (`token:economy` proves ~60% vs cold),
|
|
404
|
+
**delivered** (`code:context`), **protected** (`memory:audit`, both directions), and **propagated**:
|
|
405
|
+
the generated project inherits the maps gate (ADR-0030).
|
|
406
|
+
- [x] **`project:upgrade`** — update an already-generated project without losing code: additive, never
|
|
407
|
+
overwrites (SPEC-018).
|
|
408
|
+
- [x] **Calibrated Clean Architecture** — layers where they pay off, lean where they don't; and the
|
|
409
|
+
token claim **measured and corrected** — the saving is memory's, not the layers' (ADR-0027).
|
|
410
|
+
- [x] **Generated backend `builds` under new toolchains** — the template now matches the
|
|
411
|
+
framework's `better-sqlite3` (^12, with prebuilds); `check:all --full` compiles the generated
|
|
412
|
+
backend on Node 26.
|
|
413
|
+
- [x] **`release-auditor` consumes the gate** — the agent runs and judges `release:check --publish`
|
|
414
|
+
(ADR-0024), including `consumer-spec-new`; it doesn't reimplement the procedure.
|
|
415
|
+
|
|
416
|
+
**Next** (by dependency, not by wish)
|
|
417
|
+
|
|
418
|
+
- [ ] **Cross-project Intelligence** (Phase 6 remainder) — correlating incidents across multiple
|
|
419
|
+
repositories; needs a data source this single-repo workspace doesn't have yet.
|
|
420
|
+
- [ ] **Boilerplates beyond NestJS** — the process is stack-agnostic; the templates will follow.
|
|
421
|
+
|
|
422
|
+
Suggestions? Open an issue — a non-trivial feature here starts from a spec, yours included.
|
|
423
|
+
|
|
424
|
+
---
|
|
425
|
+
|
|
426
|
+
<p align="center">
|
|
427
|
+
<strong>Did Forja help you tame your agents?</strong><br>
|
|
428
|
+
A ⭐ is what carries the project to more devs still paying the amnesiac-AI tax.
|
|
429
|
+
</p>
|
|
430
|
+
|
|
431
|
+
<p align="center"><sub>Forja (npm: <code>forjajs</code>) · MIT License · <a href="CONTRIBUTING.md">Contributing</a></sub></p>
|