@massu/core 2.5.2 → 2.5.3

package/patterns/testing-patterns.md

@@ -453,7 +453,7 @@ it('should update order', () => {
 {
   "lint-staged": {
     "*.{ts,tsx}": [
-      "npm run test -- --related --run",
+      "{{verify.test | default("declare verification.LANG.test in massu.config.yaml")}} -- --related --run",
       "npm run type-check",
       "npm run lint --fix"
     ]
@@ -465,16 +465,16 @@ it('should update order', () => {
 
 ```bash
 # Before starting work
-git pull origin main && npm install && npm run test
+git pull origin main && npm install && {{verify.test | default("declare verification.LANG.test in massu.config.yaml")}}
 
 # During development
-npm run test -- --watch
+{{verify.test | default("declare verification.LANG.test in massu.config.yaml")}} -- --watch
 
 # Before committing
-npm run test && npm run type-check && npm run lint
+{{verify.test | default("declare verification.LANG.test in massu.config.yaml")}} && npm run type-check && npm run lint
 
 # Before pushing
-npm run build
+{{verify.build | default("(this stack declares no build step)")}}
 ```
 
 ---
@@ -558,11 +558,11 @@ it('should submit form', async () => {
 | Payment processing | E2E | `tests/e2e/critical/` |
 
 ```bash
-npm run test              # All unit + integration tests
-npm run test -- --watch   # Watch mode
+{{verify.test | default("declare verification.LANG.test in massu.config.yaml")}}              # All unit + integration tests
+{{verify.test | default("declare verification.LANG.test in massu.config.yaml")}} -- --watch   # Watch mode
 npm run test:e2e          # E2E tests
 npm run type-check        # TypeScript validation
-npm run build             # Verify production build
+{{verify.build | default("(this stack declares no build step)")}}             # Verify production build
 ```
 
 ---

package/protocols/plan-implementation.md

@@ -156,8 +156,8 @@ If plan says "Add to pages: A, B, C, D, E":
 
 ### Step 5: Run Build and Type Check
 ```bash
-npm run build    # VR-BUILD
-npx tsc --noEmit # VR-TYPE
+{{verify.build | default("(this stack declares no build step)")}}    # VR-BUILD
+{{verify.type | default("declare verification.LANG.type in massu.config.yaml")}} # VR-TYPE
 ```
 
 ### Step 6: Complete Verification Template

package/protocols/verification.md

@@ -15,9 +15,9 @@
 | VR-FILE | `ls -la [path]` | File exists | Claiming file created |
 | VR-GREP | `grep "[pattern]" [file]` | Match found | Claiming code added |
 | VR-NEGATIVE | `grep -rn "[old]" src/` | 0 matches | Claiming removal |
-| VR-BUILD | `npm run build` | Exit 0 | Claiming production ready |
-| VR-TYPE | `npx tsc --noEmit` | 0 errors | Claiming type safety |
-| VR-TEST | `npm test` | All pass | Claiming tested |
+| VR-BUILD | `{{verify.build | default("(this stack declares no build step)")}}` | Exit 0 | Claiming production ready |
+| VR-TYPE | `{{verify.type | default("declare verification.LANG.type in massu.config.yaml")}}` | 0 errors | Claiming type safety |
+| VR-TEST | `{{verify.test | default("declare verification.LANG.test in massu.config.yaml")}}` | All pass | Claiming tested |
 | VR-DEPLOY | `./scripts/pre-deploy-check.sh` | All pass | Claiming deployable |
 | VR-SCHEMA | `SELECT ... FROM information_schema` | Matches expectation | Before DB operations |
 | VR-COUNT | `grep -c "[pattern]" [file]` | Expected count | Verifying all instances |
@@ -358,7 +358,7 @@ After any verification run, if issues found:
 
 **Verification (VR-TEST):**
 ```bash
-npm test
+{{verify.test | default("declare verification.LANG.test in massu.config.yaml")}}
 # Expected: Exit 0, ALL tests pass
 # If ANY test fails, work is NOT complete
 ```

package/reference/lessons-learned.md

@@ -47,7 +47,7 @@
 - Application completely broken for all users
 
 **Root Cause:**
-- Did not run `npm run build` before pushing previous commit
+- Did not run `{{verify.build | default("(this stack declares no build step)")}}` before pushing previous commit
 - Assumed partial checks (type-check, prevention tests) were sufficient
 - Did not analyze full import graph for client/server separation
 - Did not test production build locally before deploying
@@ -59,9 +59,9 @@
 - Zero users could access application
 
 **Lessons:**
-1. **ALWAYS run `npm run build` before pushing** - No exceptions
+1. **ALWAYS run `{{verify.build | default("(this stack declares no build step)")}}` before pushing** - No exceptions
 2. **Trace client import chains** - Verify no server code imported
-3. **Test production build locally** - Run `npm run build && npm start`
+3. **Test production build locally** - Run `{{verify.build | default("(this stack declares no build step)")}} && npm start`
 4. **ESLint warnings = deployment blockers** - Zero tolerance
 5. **Import chain analysis required** - Client components must not transitively import server code
 6. **Lazy-loading for external services** - Never instantiate at module load time
@@ -143,7 +143,7 @@ When encountering errors:
 
 ## Build Timeout Protocol
 
-If `npm run build` times out:
+If `{{verify.build | default("(this stack declares no build step)")}}` times out:
 
 1. **DO NOT** assume it's just slow
 2. **DO NOT** skip to other checks

package/reference/vr-verification-reference.md

@@ -29,9 +29,9 @@
 | VR-FILE | `ls -la [path]` | File exists | Claiming file created | Missing files |
 | VR-GREP | `grep "[pattern]" [file]` | Match found | Claiming code added | Missing code |
 | VR-NEGATIVE | `grep -rn "[old]" src/` | 0 matches | Claiming removal | Leftover code |
-| VR-BUILD | `npm run build` | Exit 0 | Claiming production ready | Build failures |
-| VR-TYPE | `npx tsc --noEmit` | 0 errors | Claiming type safety | Type errors |
-| VR-TEST | `npm test` | All pass | Claiming tested | Test failures |
+| VR-BUILD | `{{verify.build | default("(this stack declares no build step)")}}` | Exit 0 | Claiming production ready | Build failures |
+| VR-TYPE | `{{verify.type | default("declare verification.LANG.type in massu.config.yaml")}}` | 0 errors | Claiming type safety | Type errors |
+| VR-TEST | `{{verify.test | default("declare verification.LANG.test in massu.config.yaml")}}` | All pass | Claiming tested | Test failures |
 | VR-DEPLOY | `./scripts/pre-deploy-check.sh` | All pass | Claiming deployable | Deploy blockers |
 | VR-SCHEMA | `SELECT ... FROM information_schema` | Matches | Before DB operations | Schema mismatches |
 | VR-SCHEMA-PRE | `SELECT column_name...` | Columns exist | BEFORE writing ANY query | Wrong column names |
@@ -129,7 +129,7 @@ grep -rn "legacyPattern" src/ | wc -l
 **Purpose**: Verify code compiles for production deployment.
 
 ```bash
-npm run build
+{{verify.build | default("(this stack declares no build step)")}}
 # Expected: Exit 0, "Compiled successfully"
 ```
 
@@ -145,7 +145,7 @@ npm run build
 **Purpose**: Verify zero TypeScript errors.
 
 ```bash
-NODE_OPTIONS="--max-old-space-size=8192" npx tsc --noEmit
+NODE_OPTIONS="--max-old-space-size=8192" {{verify.type | default("declare verification.LANG.type in massu.config.yaml")}}
 # Expected: 0 errors (no output)
 ```
 
@@ -166,7 +166,7 @@ npm run test:run
 npm run test:e2e
 
 # Specific test file
-npm test -- src/components/feature/__tests__/MyComponent.test.tsx
+{{verify.test | default("declare verification.LANG.test in massu.config.yaml")}} -- src/components/feature/__tests__/MyComponent.test.tsx
 ```
 
 **Expected Output**: All tests pass
@@ -279,12 +279,12 @@ grep "<MyComponent" src/app/**/page.tsx
 
 ```bash
 # Combined check
-grep "<MyComponent" src/app/feature/page.tsx && npm run build
+grep "<MyComponent" src/app/feature/page.tsx && {{verify.build | default("(this stack declares no build step)")}}
 
 # Full integration verification
 grep "import.*MyComponent" src/app/feature/page.tsx && \
 grep "<MyComponent" src/app/feature/page.tsx && \
-npm run build
+{{verify.build | default("(this stack declares no build step)")}}
 ```
 
 **Expected Output**: All checks pass
@@ -849,7 +849,7 @@ When running verifications, document results in this format:
 |---------|---------|----------|--------|--------|
 | VR-FILE | `ls -la component.tsx` | File exists | File exists | PASS |
 | VR-RENDER | `grep "<Component" page.tsx` | Match found | Match line 42 | PASS |
-| VR-BUILD | `npm run build` | Exit 0 | Exit 0 | PASS |
+| VR-BUILD | `{{verify.build | default("(this stack declares no build step)")}}` | Exit 0 | Exit 0 | PASS |
 | VR-NEGATIVE | `grep "oldCode" src/` | 0 matches | 3 matches | **FAIL** |
 
 **Overall Status**: FAIL (VR-NEGATIVE failed)

package/templates/aspnet/massu.config.yaml

@@ -31,6 +31,8 @@ paths:
   # — projects opt into it explicitly. Default to `.` so fresh `npx
   # massu init` doesn't fail on `paths.source 'src' does not exist`.
   source: .
+  # the .NET convention is a sibling test project; `dotnet test` discovers it
+  tests: Tests
   aliases: {}
 
 toolPrefix: massu

package/templates/go-chi/massu.config.yaml

@@ -25,6 +25,8 @@ framework:
 
 paths:
   source: internal
+  # Go keeps `_test.go` files ALONGSIDE the code they test; `go test ./...` walks the tree
+  tests: internal
   aliases: {}
 
 toolPrefix: massu

package/templates/multi-runtime/massu.config.yaml

@@ -37,6 +37,8 @@ framework:
 
 paths:
   source: apps
+  # pytest default discovery under the api app, matching paths.source apps
+  tests: apps/api/tests
   aliases:
     "@": apps
 
@@ -50,7 +52,7 @@ verification:
   python:
     test: cd apps/api && python3 -m pytest -q
     type: cd apps/api && python3 -m mypy .
-    syntax: cd apps/api && python3 -m py_compile
+    syntax: cd apps/api && python3 -m compileall -q .
     lint: cd apps/api && python3 -m ruff check .
   typescript:
     test: cd apps/web && npm test
@@ -65,7 +67,7 @@ verification:
   swift:
     test: cd apps/ios && swift test
     type: cd apps/ios && swift build
-    build: cd apps/ios && xcodebuild build
+    build: cd apps/ios && swift build -c release
     lint: cd apps/ios && swiftlint
 
 python:

package/templates/phoenix/massu.config.yaml

@@ -25,6 +25,8 @@ framework:
 
 paths:
   source: lib
+  # `mix new` scaffolds test/ and `mix test` defaults to it
+  tests: test
   aliases: {}
 
 toolPrefix: massu

package/templates/python-django/massu.config.yaml

@@ -22,6 +22,8 @@ framework:
 
 paths:
   source: src
+  # pytest-django discovery under the declared source root
+  tests: src/tests
   aliases:
     "@": src
 
@@ -35,7 +37,7 @@ verification:
   python:
     test: cd src && python3 -m pytest -q
     type: cd src && python3 -m mypy .
-    syntax: cd src && python3 -m py_compile
+    syntax: cd src && python3 -m compileall -q .
     lint: cd src && python3 -m ruff check .
 
 python:

package/templates/python-fastapi/massu.config.yaml

@@ -22,6 +22,8 @@ framework:
 
 paths:
   source: app
+  # FastAPI's own testing guide puts tests/ at the project root
+  tests: tests
   aliases:
     "@": app
 
@@ -35,7 +37,7 @@ verification:
   python:
     test: cd app && python3 -m pytest -q
     type: cd app && python3 -m mypy .
-    syntax: cd app && python3 -m py_compile
+    syntax: cd app && python3 -m compileall -q .
     lint: cd app && python3 -m ruff check .
 
 python:

package/templates/python-flask/massu.config.yaml

@@ -23,6 +23,8 @@ framework:
 
 paths:
   source: app
+  # Flask's testing docs use a top-level tests/ package
+  tests: tests
   aliases:
     "@": app
 
@@ -36,7 +38,7 @@ verification:
   python:
     test: cd app && python3 -m pytest -q
     type: cd app && python3 -m mypy .
-    syntax: cd app && python3 -m py_compile
+    syntax: cd app && python3 -m compileall -q .
     lint: cd app && python3 -m ruff check .
 
 python:

package/templates/rails/massu.config.yaml

@@ -25,6 +25,8 @@ framework:
 
 paths:
   source: app
+  # Minitest is the Rails default and `bin/rails test` reads test/
+  tests: test
   aliases: {}
 
 toolPrefix: massu
@@ -35,9 +37,9 @@ rules: []
 
 verification:
   ruby:
-    test: bundle exec rspec
+    test: bin/rails test
     type: bundle exec sorbet tc
-    syntax: bundle exec ruby -c
+    syntax: find app lib -name '*.rb' -print0 | xargs -0 -n1 ruby -c > /dev/null
     lint: bundle exec rubocop
 
 ruby:

package/templates/rust-actix/massu.config.yaml

@@ -21,6 +21,8 @@ framework:
 
 paths:
   source: src
+  # Cargo reserves tests/ for integration tests; unit tests live in src/
+  tests: tests
   aliases:
     "@": src
 

package/templates/spring/massu.config.yaml

@@ -25,6 +25,8 @@ framework:
 
 paths:
   source: src/main/java
+  # the Maven Standard Directory Layout, which surefire reads
+  tests: src/test/java
   aliases: {}
 
 toolPrefix: massu

package/templates/swift-ios/massu.config.yaml

@@ -20,6 +20,8 @@ framework:
 
 paths:
   source: Sources
+  # SwiftPM reserves Tests/ and `swift test` requires it
+  tests: Tests
   aliases:
     "@": Sources
 
@@ -33,5 +35,5 @@ verification:
   swift:
     test: swift test
     type: swift build
-    build: xcodebuild build
+    build: swift build -c release
     lint: swiftlint

package/templates/ts-nestjs/massu.config.yaml

@@ -22,6 +22,8 @@ framework:
 
 paths:
   source: src
+  # the Nest CLI scaffolds test/ for e2e alongside co-located *.spec.ts
+  tests: test
   aliases:
     "@": src
 

package/templates/ts-nextjs/massu.config.yaml

@@ -22,6 +22,8 @@ framework:
 
 paths:
   source: src
+  # the convention create-next-app documents for colocated tests
+  tests: __tests__
   aliases:
     "@": src