create-sdd-project 0.16.5 → 0.16.6

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-sdd-project",
3
- "version": "0.16.5",
3
+ "version": "0.16.6",
4
4
  "description": "Create a new SDD DevFlow project with AI-assisted development workflow",
5
5
  "bin": {
6
6
  "create-sdd-project": "bin/cli.js"
@@ -54,3 +54,32 @@ jobs:
54
54
 
55
55
  - name: Build
56
56
  run: npm run build --if-present
57
+
58
+ # ===========================================
59
+ # Scaling tips
60
+ # ===========================================
61
+ # When this project grows and you split CI into multiple jobs with path
62
+ # filters (e.g., test-api, test-frontend triggered only when relevant files
63
+ # change), enabling branch protection that requires those individual checks
64
+ # will create a deadlock for docs-only PRs: no code changed → no jobs run →
65
+ # required checks never report → merge blocked.
66
+ #
67
+ # Solution: add a rollup job that always runs and aggregates the others.
68
+ # Then configure branch protection to require ONLY the rollup, not the
69
+ # individual jobs:
70
+ #
71
+ # ci-success:
72
+ # runs-on: ubuntu-latest
73
+ # needs: [test-api, test-frontend] # list all jobs to aggregate
74
+ # if: always()
75
+ # steps:
76
+ # - name: All required jobs passed or were skipped
77
+ # run: |
78
+ # if [[ "${{ contains(needs.*.result, 'failure') }}" == "true" ]]; then
79
+ # echo "One or more required jobs failed"
80
+ # exit 1
81
+ # fi
82
+ #
83
+ # The rollup passes when all dependencies pass OR were skipped due to path
84
+ # filters. This is the standard pattern for path-filtered CI + required
85
+ # checks. Avoid `|| true` and `continue-on-error` — they silence real failures.