@pukujan/create-modular-monolith 2.1.0 → 2.2.0

package/README.md

@@ -3,7 +3,7 @@
 **npm create** scaffold for a modular monolith built for **human + agent** engineering at scale.
 
 ```bash
-npm create @pukujan/modular-monolith@2 my-platform
+npm create @pukujan/modular-monolith@2.2.0 my-platform
 cd my-platform
 npm install --prefix backend && npm install --prefix frontend
 ```
@@ -72,6 +72,8 @@ These live under `template/scripts/` and are copied into new projects:
 | `import-to-file-exchange.mjs` | `npm run import:file-exchange` | Inbound bundles → `imports/{stamp}/` |
 | `new-module.mjs` | `npm run new:module` | Scaffold backend + frontend module |
 
+Scaffolded projects also ship **`npm run test:ci`**, **`.github/workflows/ci.yml`**, **`traceId.js`**, and **[EVAL_AND_CI.md](template/docs/architecture/EVAL_AND_CI.md)** (gates + per-case golden guidance).
+
 Supporting libraries: `scripts/lib/repo-tree.mjs`, `api-inventory.mjs`, `dev-log-human-format.mjs`, `git-snapshot.mjs`, `run-tests.mjs`.
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pukujan/create-modular-monolith",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Scaffold a modular monolith with architecture contracts, file-exchange, agent dev logs, and lint automation for Cursor-scale engineering.",
   "type": "module",
   "bin": {

package/template/.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  quality-gate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: npm
+          cache-dependency-path: |
+            backend/package-lock.json
+            frontend/package-lock.json
+
+      - name: Install backend
+        run: npm ci
+        working-directory: backend
+
+      - name: Install frontend
+        run: npm ci
+        working-directory: frontend
+
+      - name: Lint contracts
+        run: npm run lint:contracts
+
+      - name: Lint repo artifacts
+        run: npm run lint:repo-artifacts
+
+      - name: Lint architecture
+        run: npm run lint:architecture
+
+      - name: Unit tests
+        run: npm test
+
+      - name: Module eval runners
+        run: npm run test:evals

package/template/README.md

@@ -2,8 +2,9 @@
 
 Architecture-first Express + React starter for products that scale with **human + agent** engineering.
 
-**Read first:** [docs/architecture/PLATFORM_ARCHITECTURE.md](docs/architecture/PLATFORM_ARCHITECTURE.md)  
+**Read first:** [docs/architecture/PLATFORM_ARCHITECTURE.md](docs/architecture/PLATFORM_ARCHITECTURE.md)    
 **Contracts:** [docs/architecture/CONTRACTS_OVERVIEW.md](docs/architecture/CONTRACTS_OVERVIEW.md)  
+**Evals & CI gates:** [docs/architecture/EVAL_AND_CI.md](docs/architecture/EVAL_AND_CI.md)  
 **Agents:** [AGENTS.md](AGENTS.md)
 
 ## Quick start
@@ -14,14 +15,21 @@ cd backend && npm install && npm run dev
 cd frontend && npm install && npm run dev
 ```
 
+## Quality gates
+
+```bash
+npm run test:ci             # lint + unit tests + module evals (same as GitHub Actions)
+npm run lint:contracts
+npm run lint:architecture
+npm run test:evals
+```
+
 ## Architecture commands
 
 ```bash
-npm run lint:contracts          # contract manifest paths
-npm run lint:architecture       # module boundaries + layers + API docs
 npm run import:file-exchange -- ./my-bundle
 npm run dev-log:pre-push -- --slug initial-setup
-npm run condense:all            # consolidated snapshots → file-exchange/exports/
+npm run condense:all
 npm run new:module -- my-feature --label "My Feature"
 ```
 
@@ -29,6 +37,7 @@ npm run new:module -- my-feature --label "My Feature"
 
 - `_reference` + `model-condenser` modules (no domain logic)
 - File exchange, work-log dev logs (human + agent), contract manifest v001
+- CI workflow (`.github/workflows/ci.yml`), trace ID helper
 - Lint and condense tooling for trees, prompts, and schemas
 
 Built with [@pukujan/create-modular-monolith](https://github.com/Pukujan/create-modular-monolith).