create-qa-architect 5.0.6 → 5.3.1

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.
Files changed (37) hide show
  1. package/.github/workflows/auto-release.yml +49 -0
  2. package/.github/workflows/dependabot-auto-merge.yml +32 -0
  3. package/LICENSE +3 -3
  4. package/README.md +54 -15
  5. package/docs/ADOPTION-SUMMARY.md +41 -0
  6. package/docs/ARCHITECTURE-REVIEW.md +67 -0
  7. package/docs/ARCHITECTURE.md +29 -41
  8. package/docs/CODE-REVIEW.md +100 -0
  9. package/docs/PREFLIGHT_REPORT.md +32 -40
  10. package/docs/REQUIREMENTS.md +148 -0
  11. package/docs/SECURITY-AUDIT.md +68 -0
  12. package/docs/TESTING.md +3 -4
  13. package/docs/test-trace-matrix.md +28 -0
  14. package/lib/billing-dashboard.html +6 -12
  15. package/lib/commands/deps.js +245 -0
  16. package/lib/commands/index.js +25 -0
  17. package/lib/commands/validate.js +85 -0
  18. package/lib/error-reporter.js +13 -1
  19. package/lib/github-api.js +108 -13
  20. package/lib/license-signing.js +110 -0
  21. package/lib/license-validator.js +359 -71
  22. package/lib/licensing.js +343 -111
  23. package/lib/prelaunch-validator.js +828 -0
  24. package/lib/quality-tools-generator.js +495 -0
  25. package/lib/result-types.js +112 -0
  26. package/lib/security-enhancements.js +1 -1
  27. package/lib/smart-strategy-generator.js +28 -9
  28. package/lib/template-loader.js +52 -19
  29. package/lib/validation/cache-manager.js +36 -6
  30. package/lib/validation/config-security.js +82 -15
  31. package/lib/validation/workflow-validation.js +49 -23
  32. package/package.json +8 -10
  33. package/scripts/check-test-coverage.sh +46 -0
  34. package/setup.js +356 -285
  35. package/templates/QUALITY_TROUBLESHOOTING.md +32 -33
  36. package/templates/scripts/smart-test-strategy.sh +1 -1
  37. package/create-saas-monetization.js +0 -1513
@@ -253,13 +253,25 @@ class ErrorReporter {
253
253
  const category = categorizeError(error)
254
254
  const reportId = generateReportId()
255
255
 
256
+ // DR20 fix: Limit stack trace exposure in production mode
257
+ const isProduction = process.env.NODE_ENV === 'production'
258
+ const fullStack = sanitizeStackTrace(error?.stack || '')
259
+
260
+ // In production: only include first 3 lines of stack (error + top 2 frames)
261
+ // In dev/test: include full sanitized stack for debugging
262
+ const stackToInclude =
263
+ isProduction && fullStack
264
+ ? fullStack.split('\n').slice(0, 3).join('\n')
265
+ : fullStack
266
+
256
267
  const report = {
257
268
  id: reportId,
258
269
  timestamp: new Date().toISOString(),
259
270
  category,
260
271
  errorType: error?.constructor?.name || 'Error',
261
272
  message: sanitizeMessage(error?.message || 'Unknown error'),
262
- sanitizedStack: sanitizeStackTrace(error?.stack || ''),
273
+ sanitizedStack: stackToInclude,
274
+ stackTruncated: isProduction && fullStack.split('\n').length > 3,
263
275
  operation: this.operation,
264
276
  context: {
265
277
  nodeVersion: process.version,
package/lib/github-api.js CHANGED
@@ -6,6 +6,63 @@
6
6
  const https = require('https')
7
7
  const { execSync } = require('child_process')
8
8
 
9
+ // TD5 fix: Simple rate limiter for GitHub API
10
+ // GitHub allows 5000 requests/hour for authenticated requests
11
+ const rateLimiter = {
12
+ tokens: 100, // Start with 100 tokens
13
+ maxTokens: 100,
14
+ refillRate: 100 / 3600, // Refill ~100 tokens per hour
15
+ lastRefill: Date.now(),
16
+ minDelayMs: 100, // Minimum delay between requests
17
+
18
+ async acquire() {
19
+ try {
20
+ // Refill tokens based on time elapsed
21
+ const now = Date.now()
22
+ const elapsed = (now - this.lastRefill) / 1000
23
+ const refilled = elapsed * this.refillRate
24
+
25
+ // DR5 fix: Validate math to prevent NaN/Infinity
26
+ if (!Number.isFinite(refilled) || refilled < 0) {
27
+ console.warn('⚠️ Rate limiter math error, resetting')
28
+ this.tokens = this.maxTokens
29
+ this.lastRefill = now
30
+ return
31
+ }
32
+
33
+ this.tokens = Math.min(this.maxTokens, this.tokens + refilled)
34
+ this.lastRefill = now
35
+
36
+ // If we have tokens, use one
37
+ if (this.tokens >= 1) {
38
+ this.tokens -= 1
39
+ return
40
+ }
41
+
42
+ // Wait before allowing request
43
+ const waitTime = Math.max(
44
+ this.minDelayMs,
45
+ ((1 - this.tokens) / this.refillRate) * 1000
46
+ )
47
+
48
+ // DR5 fix: Validate waitTime before setTimeout
49
+ if (!Number.isFinite(waitTime) || waitTime < 0 || waitTime > 60000) {
50
+ console.warn(
51
+ `⚠️ Rate limiter computed invalid wait time: ${waitTime}ms, using minimum`
52
+ )
53
+ await new Promise(resolve => setTimeout(resolve, this.minDelayMs))
54
+ } else {
55
+ await new Promise(resolve => setTimeout(resolve, waitTime))
56
+ }
57
+
58
+ this.tokens = 0
59
+ } catch (error) {
60
+ // DR5 fix: Don't block on rate limiter errors, just log and proceed
61
+ console.error(`❌ Rate limiter error: ${error.message}`)
62
+ }
63
+ },
64
+ }
65
+
9
66
  /**
10
67
  * Get GitHub token from environment or gh CLI
11
68
  */
@@ -15,12 +72,21 @@ function getGitHubToken() {
15
72
  return process.env.GITHUB_TOKEN
16
73
  }
17
74
 
18
- // Try to get from gh CLI
75
+ // Try to get from gh CLI (hardcoded command - no injection risk)
19
76
  try {
20
77
  const token = execSync('gh auth token', { encoding: 'utf8' }).trim()
21
78
  if (token) return token
22
- } catch {
23
- // gh CLI not available or not authenticated
79
+ } catch (error) {
80
+ // Silent failure fix: Log unexpected errors for debugging
81
+ // ENOENT = gh not installed (expected), other errors should be visible in DEBUG mode
82
+ if (
83
+ error?.code !== 'ENOENT' &&
84
+ !error?.message?.includes('command not found')
85
+ ) {
86
+ if (process.env.DEBUG) {
87
+ console.warn(`⚠️ gh auth token failed: ${error.message}`)
88
+ }
89
+ }
24
90
  }
25
91
 
26
92
  return null
@@ -28,6 +94,7 @@ function getGitHubToken() {
28
94
 
29
95
  /**
30
96
  * Get repository info from git remote
97
+ * Uses hardcoded git command - no injection risk
31
98
  */
32
99
  function getRepoInfo(projectPath = '.') {
33
100
  try {
@@ -45,15 +112,29 @@ function getRepoInfo(projectPath = '.') {
45
112
  }
46
113
 
47
114
  return null
48
- } catch {
115
+ } catch (error) {
116
+ // Silent failure fix: Log unexpected errors for debugging
117
+ // "No such remote" is expected when origin isn't configured
118
+ if (
119
+ !error?.stderr?.includes('No such remote') &&
120
+ error?.code !== 'ENOENT'
121
+ ) {
122
+ if (process.env.DEBUG) {
123
+ console.warn(`⚠️ git remote get-url failed: ${error.message}`)
124
+ }
125
+ }
49
126
  return null
50
127
  }
51
128
  }
52
129
 
53
130
  /**
54
- * Make GitHub API request
131
+ * Make GitHub API request with rate limiting
132
+ * TD5 fix: Added rate limiting to prevent hitting GitHub's API limits
55
133
  */
56
- function githubRequest(method, path, token, data = null) {
134
+ async function githubRequest(method, path, token, data = null) {
135
+ // TD5 fix: Acquire rate limit token before making request
136
+ await rateLimiter.acquire()
137
+
57
138
  return new Promise((resolve, reject) => {
58
139
  const options = {
59
140
  hostname: 'api.github.com',
@@ -77,17 +158,31 @@ function githubRequest(method, path, token, data = null) {
77
158
  res.on('data', chunk => (body += chunk))
78
159
  res.on('end', () => {
79
160
  if (res.statusCode >= 200 && res.statusCode < 300) {
80
- resolve({
81
- status: res.statusCode,
82
- data: body ? JSON.parse(body) : null,
83
- })
161
+ // DR12 fix: Handle JSON parse errors gracefully
162
+ try {
163
+ const data = body ? JSON.parse(body) : null
164
+ resolve({ status: res.statusCode, data })
165
+ } catch (_error) {
166
+ reject(
167
+ new Error(
168
+ `GitHub API returned invalid JSON (status ${res.statusCode}): ${body.slice(0, 100)}`
169
+ )
170
+ )
171
+ }
84
172
  } else if (res.statusCode === 204) {
85
173
  resolve({ status: 204, data: null })
86
174
  } else {
175
+ // DR12 fix: GitHub errors are usually JSON, but handle parse failures
176
+ let errorBody = body || res.statusMessage
177
+ try {
178
+ const errorData = JSON.parse(body)
179
+ errorBody = errorData.message || errorBody
180
+ } catch (_error) {
181
+ // Use raw body if JSON parse fails
182
+ }
183
+
87
184
  reject(
88
- new Error(
89
- `GitHub API error: ${res.statusCode} - ${body || res.statusMessage}`
90
- )
185
+ new Error(`GitHub API error: ${res.statusCode} - ${errorBody}`)
91
186
  )
92
187
  }
93
188
  })
@@ -0,0 +1,110 @@
1
+ 'use strict'
2
+
3
+ const crypto = require('crypto')
4
+
5
+ // TD15 fix: Single source of truth for license key format validation
6
+ const LICENSE_KEY_PATTERN =
7
+ /^QAA-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/
8
+
9
+ /**
10
+ * Deterministic JSON stringify with sorted keys for signature verification.
11
+ * TD13 fix: Added circular reference protection using WeakSet.
12
+ */
13
+ function stableStringify(value, seen = new WeakSet()) {
14
+ if (value === null || typeof value !== 'object') {
15
+ return JSON.stringify(value)
16
+ }
17
+ // TD13 fix: Detect circular references to prevent stack overflow
18
+ if (seen.has(value)) {
19
+ throw new Error('Circular reference detected in payload - cannot serialize')
20
+ }
21
+ seen.add(value)
22
+
23
+ if (Array.isArray(value)) {
24
+ return `[${value.map(item => stableStringify(item, seen)).join(',')}]`
25
+ }
26
+ const keys = Object.keys(value).sort()
27
+ const entries = keys.map(
28
+ key => `${JSON.stringify(key)}:${stableStringify(value[key], seen)}`
29
+ )
30
+ return `{${entries.join(',')}}`
31
+ }
32
+
33
+ function normalizeEmail(email) {
34
+ if (!email || typeof email !== 'string') return null
35
+ const normalized = email.trim().toLowerCase()
36
+ return normalized.length > 0 ? normalized : null
37
+ }
38
+
39
+ function hashEmail(email) {
40
+ const normalized = normalizeEmail(email)
41
+ if (!normalized) return null
42
+ return crypto.createHash('sha256').update(normalized).digest('hex')
43
+ }
44
+
45
+ /**
46
+ * Build a license payload for signing/verification.
47
+ * TD14 fix: Added input validation to prevent signature mismatches from invalid data.
48
+ */
49
+ function buildLicensePayload({
50
+ licenseKey,
51
+ tier,
52
+ isFounder,
53
+ emailHash,
54
+ issued,
55
+ }) {
56
+ // TD14 fix: Validate required fields to catch issues early
57
+ if (!licenseKey || typeof licenseKey !== 'string') {
58
+ throw new Error('licenseKey is required and must be a string')
59
+ }
60
+ if (!tier || typeof tier !== 'string') {
61
+ throw new Error('tier is required and must be a string')
62
+ }
63
+ if (!issued || typeof issued !== 'string') {
64
+ throw new Error('issued is required and must be a string')
65
+ }
66
+
67
+ const payload = {
68
+ licenseKey,
69
+ tier,
70
+ isFounder: Boolean(isFounder),
71
+ issued,
72
+ }
73
+ if (emailHash) {
74
+ payload.emailHash = emailHash
75
+ }
76
+ return payload
77
+ }
78
+
79
+ function signPayload(payload, privateKey) {
80
+ const data = Buffer.from(stableStringify(payload))
81
+ const signature = crypto.sign(null, data, privateKey)
82
+ return signature.toString('base64')
83
+ }
84
+
85
+ function verifyPayload(payload, signature, publicKey) {
86
+ const data = Buffer.from(stableStringify(payload))
87
+ return crypto.verify(null, data, publicKey, Buffer.from(signature, 'base64'))
88
+ }
89
+
90
+ function loadKeyFromEnv(envValue, envPathValue) {
91
+ if (envValue) return envValue
92
+ if (envPathValue) {
93
+ const fs = require('fs')
94
+ if (fs.existsSync(envPathValue)) {
95
+ return fs.readFileSync(envPathValue, 'utf8')
96
+ }
97
+ }
98
+ return null
99
+ }
100
+
101
+ module.exports = {
102
+ LICENSE_KEY_PATTERN,
103
+ stableStringify,
104
+ normalizeEmail,
105
+ hashEmail,
106
+ buildLicensePayload,
107
+ signPayload,
108
+ verifyPayload,
109
+ loadKeyFromEnv,
110
+ }