Henabakos/archforge-x
60.4
Adequate · 21 September 2026
11.9k
lines of production code
TypeScript
primary language
4
measurements over time
What this system is
This system is a CLI-based code scaffolding and architecture validation tool that generates production-ready project templates across multiple languages and frameworks. It enforces structural compliance through configurable rules and provides automated verification to ensure generated projects are immediately runnable. The tool supports various architectural patterns and includes comprehensive testing and documentation generation capabilities.
Features
Introduce architecture validation and version management for project templates
The core module now includes a VersionManifest to manage dependency versions for Express, NestJS, and tooling, alongside new architecture definition files (DDD, Clean, Layered) and an ArchitectureValidator that enforces layer boundaries, naming conventions, and import rules. The architecture parser now supports configuration inheritance via an 'extends' field, allowing users to build on top of default templates while maintaining strict validation of layer references.
src/core · high confidence
Introduce comprehensive generator module with framework-agnostic templates and post-generation verification
The project scaffolding system has been refactored into a modular generator module that supports multiple languages (TypeScript, JavaScript, Python, and Go) and frameworks (Express, NestJS, FastAPI, Django, Gin, and Next.js). A new base generator orchestrates the creation of project structures, configuration files, Docker setups, and CI/CD workflows using reusable templates. Additionally, a post-generation verification step automatically checks for build success, valid configuration files, required files, and environment variables, ensuring generated projects are immediately runnable.
src/generators · medium confidence
Introduce modular README generation system
The \src/generators/readme\ directory now contains a new modular README generation system. This includes a context builder that dynamically computes project paths, commands, and feature flags based on generator options (e.g., architecture, framework, ORM). The main generator class (\ReadmeGenerator\) composes README content by selecting sections (header, badges, overview, etc.) and rendering them for specific audiences (beginner, standard, advanced). The system supports generating multiple README variants (e.g., \README.md\, \README-BEGINNER.md\, \README-ADVANCED.md\) and includes a table of contents for non-beginner audiences. Types and section definitions are explicitly defined to support conditional inclusion and audience-specific content.
src/generators/readme · high confidence
New template generators for authentication, TypeORM, CI/CD, and Docker
The template generation system has been refactored to include dedicated generators for authentication (JWT middleware, services, and routes for Express and NestJS), TypeORM entities and repositories, CI/CD workflows (GitHub Actions), and Docker configurations. These new templates provide framework-agnostic scaffolding for common architectural patterns, replacing the previous generic base file generator.
src/generators/templates · high confidence
Production-ready Express and NestJS generators with modular architecture templates
Added new generators for Express and NestJS that scaffold production-grade Node.js projects. Each generator creates a complete project structure supporting Clean, DDD, and Layered architectures, along with ORM integration (Prisma, TypeORM), authentication modules, and comprehensive configuration files (package.json, tsconfig, Jest, ESLint). The generators also include an architecture validation step and generate an architecture-rules.json file to enforce structural constraints.
src/generators/node · high confidence
Behavioural changes
Introduce interactive CLI wizard and new 'sync' command for architecture validation
The CLI now features an interactive wizard (replacing the previous 'init' command) that guides users through selecting a programming language, framework, architecture pattern, ORM, and optional modules like authentication or CI/CD. A new 'sync' command has been added to synchronize the project with 'architecture-rules.json' and validate the structure, providing clear success or failure feedback. The 'analyze' command has been renamed to 'validate' (with 'check' as an alias) to better reflect its purpose of checking architectural compliance, and the 'rules' command has been renamed to 'audit' to indicate a deeper architectural review with auto-fix suggestions.
src/cli · high confidence
Test coverage
Add comprehensive test suite and configuration test harness
Added a new configuration test harness under tests/harness that generates, builds, and validates all supported project configurations (TypeScript/JavaScript, Express/NestJS, DDD/clean/layered architectures, various ORMs and databases) with parallel execution, fail-fast support, and multiple report formats (console, JSON, Markdown, JUnit). Additionally, added unit tests for the dependency analyzer, rules engine, and schema validation, along with a chalk mock to support Jest testing.
tests · high confidence
Dependencies
archforge-x updated to v2.0.0-beta.1 with expanded dependencies and test tooling
The archforge-x package has been updated to version 2.0.0-beta.1, with the license changed from ISC to MIT. New runtime dependencies js-yaml, minimatch, and typescript have been added to support the tool's architecture analysis and code generation features. Additionally, the project has integrated Jest and ts-jest for test coverage, alongside corresponding type definitions, expanding the project's testing capabilities.
(dependencies) · medium confidence
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 60 → 60 (+0.7)
- Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.
Lenses
- Code Health 64 → 61 (-3.1)
- Architecture 87 → 90 (+3.0)
- Maturity 63 → 63 (-0.8)
- Readiness 54 → 55 (+0.8)
- Security 58 → 71 (+13.1)
Resolved (21)
- Coverage not included — suite not readable by the collector
- Critical CVE: [GHSA redacted] (package-lock.json)
- Dependency hygiene not measured — dependency manifest found but not parsed for hygiene
- High CVE: [GHSA redacted] (package-lock.json)
- High CVE: [GHSA redacted] (package-lock.json)
- High CVE: [GHSA redacted] (package-lock.json)
- High CVE: [GHSA redacted] (package-lock.json)
- High CVE: [GHSA redacted] (package-lock.json)
- High CVE: [GHSA redacted] (package-lock.json)
- High CVE: [GHSA redacted] (package-lock.json)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- Low CVE: [GHSA redacted] (package-lock.json)
- Low CVE: [GHSA redacted] (package-lock.json)
- Medium CVE: [GHSA redacted] (package-lock.json)
- No exposed public API
- Test reliability not included
- early-stage repository — too little history to judge knowledge freshness
- …and 1 more
New (58)
- ArchitectureValidator.validate (cognitive 17) (src/core/architecture/validator.ts)
- ArchitectureValidator.validateLayerImports (cognitive 37) (src/core/architecture/validator.ts)
- ArchitectureValidator.validateLayerImports (cyclomatic 17) (src/core/architecture/validator.ts)
- ArchitectureValidator.validateNamingConventions (cognitive 26) (src/core/architecture/validator.ts)
- BaseGenerator.ensureArchitectureFolders (cognitive 19) (src/generators/base.ts)
- BaseGenerator.generateArchForgeConfig (cognitive 16) (src/generators/base.ts)
- BaseGenerator.generateArchForgeConfig (cyclomatic 21) (src/generators/base.ts)
- Critical CVE: [GHSA redacted] (package-lock.json)
- Documentation: no contributor guidance (README.md)
- FileTooLong: readme/sections.ts (src/generators/readme/sections.ts)
- FunctionTooLong: interactive.interactiveCLI (src/cli/interactive.ts)
- High CVE: [GHSA redacted] (package-lock.json)
- High CVE: [GHSA redacted] (package-lock.json)
- High CVE: [GHSA redacted] (package-lock.json)
- High CVE: [GHSA redacted] (package-lock.json)
- High CVE: [GHSA redacted] (package-lock.json)
- High CVE: [GHSA redacted] (package-lock.json)
- High CVE: [GHSA redacted] (package-lock.json)
- High CVE: [GHSA redacted] (package-lock.json)
- High: security finding (details withheld)
- …and 38 more
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
Henabakos/archforge-x was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 21 September 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit f2d0e90567e1271b051c89595204d05b50d0979a — the exact code this score is about.
- Scored under rubric-2026.09.15 — the same rubric and the same method as every other entry in this index.
- Measured by watchdog.canine.dev using codehealth-analyzer preprod-b84573e22831.