create-fullstack-scaffold 0.1.0

package/template/lint-scripts/framework/check-modify.ts

@@ -0,0 +1,152 @@
+import * as fs from 'fs'
+import { execSync } from 'child_process'
+import {
+  computeContentHash,
+  computeFileHash,
+  extractBaselineInfo,
+  extractCodeContent,
+  isFrameworkFile,
+} from './hash-utils'
+
+function getStagedFiles(): string[] {
+  try {
+    const output = execSync('git diff --cached --name-only --diff-filter=ACMR', {
+      encoding: 'utf-8',
+    })
+    return output
+      .split('\n')
+      .filter(Boolean)
+      .filter((f) => f.endsWith('.ts'))
+  } catch {
+    return []
+  }
+}
+
+interface CheckResult {
+  file: string
+  status: 'ok' | 'missing-baseline' | 'modified-no-record' | 'missing-fields'
+  baseline?: string
+  current?: string
+  missingFields?: string[]
+}
+
+function checkFile(filePath: string): CheckResult {
+  const content = fs.readFileSync(filePath, 'utf-8')
+  const info = extractBaselineInfo(content)
+
+  if (!info.baseline) {
+    return { file: filePath, status: 'missing-baseline' }
+  }
+
+  const currentHash = computeFileHash(filePath)
+
+  if (currentHash === info.baseline) {
+    return { file: filePath, status: 'ok', baseline: info.baseline }
+  }
+
+  if (!info.hasModify) {
+    return {
+      file: filePath,
+      status: 'modified-no-record',
+      baseline: info.baseline,
+      current: currentHash || undefined,
+    }
+  }
+
+  const missingFields: string[] = []
+  if (!info.reason) missingFields.push('@reason')
+  if (!info.impact) missingFields.push('@impact')
+
+  if (missingFields.length > 0) {
+    return {
+      file: filePath,
+      status: 'missing-fields',
+      baseline: info.baseline,
+      current: currentHash || undefined,
+      missingFields,
+    }
+  }
+
+  return { file: filePath, status: 'ok', baseline: info.baseline, current: currentHash || undefined }
+}
+
+function main(): void {
+  const stagedFiles = getStagedFiles()
+  const frameworkFiles = stagedFiles.filter(isFrameworkFile)
+
+  if (frameworkFiles.length === 0) {
+    console.log('✅ 没有框架文件被修改')
+    process.exit(0)
+  }
+
+  console.log('')
+  console.log('🔍 检查框架文件修改...\n')
+  console.log(`发现 ${frameworkFiles.length} 个框架文件在暂存区:\n`)
+
+  const results = frameworkFiles.map(checkFile)
+  const errors: CheckResult[] = []
+
+  for (const result of results) {
+    const relativePath = result.file.replace(process.cwd() + '/', '')
+
+    switch (result.status) {
+      case 'ok':
+        console.log(`  ✅ ${relativePath}`)
+        break
+
+      case 'missing-baseline':
+        console.log(`  ❌ ${relativePath}`)
+        console.log(`     缺少 @framework-baseline 声明`)
+        console.log(`     请运行: npm run framework:init\n`)
+        errors.push(result)
+        break
+
+      case 'modified-no-record':
+        console.log(`  ❌ ${relativePath}`)
+        console.log(`     文件已修改但未记录修改说明`)
+        console.log(`     基准: ${result.baseline}`)
+        console.log(`     当前: ${result.current}`)
+        console.log(`     请添加注释:`)
+        console.log(`     @framework-modify`)
+        console.log(`     @reason [修改原因]`)
+        console.log(`     @impact [影响范围]\n`)
+        errors.push(result)
+        break
+
+      case 'missing-fields':
+        console.log(`  ❌ ${relativePath}`)
+        console.log(`     修改记录缺少必要字段: ${result.missingFields?.join(', ')}`)
+        console.log(`     请补充完整注释\n`)
+        errors.push(result)
+        break
+    }
+  }
+
+  console.log('─'.repeat(50))
+
+  if (errors.length > 0) {
+    console.log('')
+    console.log('🚫 提交被阻止！')
+    console.log('')
+    console.log(`${errors.length} 个框架文件修改未正确记录。`)
+    console.log('')
+    console.log('框架文件修改需要添加说明注释，格式如下：')
+    console.log('')
+    console.log('/**')
+    console.log(' * @framework-baseline [基准Hash]')
+    console.log(' *')
+    console.log(' * @framework-modify')
+    console.log(' * @reason [必填] 修改原因')
+    console.log(' * @impact [必填] 影响范围')
+    console.log(' */')
+    console.log('')
+    process.exit(1)
+  }
+
+  console.log('')
+  console.log('✅ 所有框架修改已正确记录，允许提交。')
+  console.log('')
+  process.exit(0)
+}
+
+main()

package/template/lint-scripts/framework/hash-utils.ts

@@ -0,0 +1,180 @@
+import * as crypto from 'crypto'
+import * as fs from 'fs'
+import * as path from 'path'
+
+interface CacheEntry {
+  mtime: number
+  size: number
+  hash: string
+}
+
+const hashCache = new Map<string, CacheEntry>()
+
+const FRAMEWORK_PATTERNS = [
+  '/shared/core/',
+  '/server/core/',
+  '/server/entries/',
+  '/server/test-utils/',
+  '/server/index.ts',
+  '/client/services/',
+  'eslint.config.js',
+  'eslint-rules/',
+]
+
+const FRAMEWORK_FILES = ['eslint.config.js']
+
+export function isFrameworkFile(filePath: string): boolean {
+  if (FRAMEWORK_PATTERNS.some(p => filePath.includes(p))) {
+    return true
+  }
+
+  const normalizedPath = filePath?.replace(/\\/g, '/') ?? ''
+  const fileName = normalizedPath.split('/').pop() ?? ''
+
+  if (FRAMEWORK_FILES.includes(fileName)) {
+    return true
+  }
+
+  if (normalizedPath.includes('/eslint-rules/')) {
+    return true
+  }
+
+  return false
+}
+
+export function computeContentHash(content: string): string {
+  return crypto.createHash('md5').update(content).digest('hex').slice(0, 16)
+}
+
+export function computeFileHash(filePath: string): string {
+  const stat = fs.statSync(filePath)
+  const cached = hashCache.get(filePath)
+
+  if (cached && cached.mtime === stat.mtimeMs && cached.size === stat.size) {
+    return cached.hash
+  }
+
+  const content = fs.readFileSync(filePath, 'utf-8')
+  const codeContent = extractCodeContent(content)
+  const hash = computeContentHash(codeContent)
+
+  hashCache.set(filePath, {
+    mtime: stat.mtimeMs,
+    size: stat.size,
+    hash,
+  })
+
+  return hash
+}
+
+export function extractCodeContent(fullContent: string): string {
+  const lines = fullContent.split('\n')
+  const codeLines: string[] = []
+  let inHeaderComment = false
+  let headerEnded = false
+  let foundFirstCode = false
+
+  for (const line of lines) {
+    if (!headerEnded) {
+      if (line.trim().startsWith('/**')) {
+        inHeaderComment = true
+        continue
+      }
+      if (inHeaderComment) {
+        if (line.trim() === '*/') {
+          inHeaderComment = false
+          headerEnded = true
+        }
+        continue
+      }
+      if (line.trim() === '' || line.trim().startsWith('//')) {
+        continue
+      }
+      headerEnded = true
+      foundFirstCode = true
+    }
+    if (!foundFirstCode && (line.trim() === '' || line.trim().startsWith('//'))) {
+      continue
+    }
+    foundFirstCode = true
+    codeLines.push(line)
+  }
+
+  return codeLines.join('\n')
+}
+
+export interface BaselineInfo {
+  baseline: string | null
+  hasModify: boolean
+  reason: string | null
+  impact: string | null
+  approvedBy: string | null
+}
+
+const BASELINE_REGEX = /@framework-baseline\s+([a-f0-9]+)/i
+const MODIFY_REGEX = /@framework-modify/i
+const REASON_REGEX = /@reason\s+(.+)/i
+const IMPACT_REGEX = /@impact\s+(.+)/i
+const APPROVED_BY_REGEX = /@approved-by\s+(.+)/i
+
+export function extractBaselineInfo(content: string): BaselineInfo {
+  const firstCommentEnd = content.indexOf('*/')
+  const headerComment = firstCommentEnd > 0 ? content.slice(0, firstCommentEnd) : ''
+
+  const baselineMatch = headerComment.match(BASELINE_REGEX)
+  const reasonMatch = headerComment.match(REASON_REGEX)
+  const impactMatch = headerComment.match(IMPACT_REGEX)
+  const approvedByMatch = headerComment.match(APPROVED_BY_REGEX)
+
+  return {
+    baseline: baselineMatch ? baselineMatch[1] : null,
+    hasModify: MODIFY_REGEX.test(headerComment),
+    reason: reasonMatch ? reasonMatch[1].trim() : null,
+    impact: impactMatch ? impactMatch[1].trim() : null,
+    approvedBy: approvedByMatch ? approvedByMatch[1].trim() : null,
+  }
+}
+
+export function generateHeaderComment(baseline: string): string {
+  return `/**
+ * @framework-baseline ${baseline}
+ */`
+}
+
+export function updateFileBaseline(filePath: string, newBaseline: string): void {
+  const content = fs.readFileSync(filePath, 'utf-8')
+  const info = extractBaselineInfo(content)
+
+  if (!info.baseline) {
+    const codeContent = extractCodeContent(content)
+    const newContent = generateHeaderComment(newBaseline) + '\n' + codeContent
+    fs.writeFileSync(filePath, newContent, 'utf-8')
+    return
+  }
+
+  const firstCommentEnd = content.indexOf('*/')
+  if (firstCommentEnd < 0) return
+
+  const beforeComment = content.slice(0, content.indexOf('/**'))
+  const afterComment = content.slice(firstCommentEnd + 2)
+
+  const oldHeader = content.slice(content.indexOf('/**'), firstCommentEnd + 2)
+  const newHeader = oldHeader.replace(
+    /@framework-baseline\s+[a-f0-9]+/i,
+    `@framework-baseline ${newBaseline}`
+  )
+
+  const newContent = beforeComment + newHeader + afterComment
+  fs.writeFileSync(filePath, newContent, 'utf-8')
+}
+
+export function clearCache(): void {
+  hashCache.clear()
+}
+
+export function getCacheStats(): { size: number; keys: string[] } {
+  return {
+    size: hashCache.size,
+    keys: Array.from(hashCache.keys()),
+  }
+}

package/template/lint-scripts/framework/init-baseline.ts

@@ -0,0 +1,84 @@
+import * as fs from 'fs'
+import * as path from 'path'
+import { glob } from 'glob'
+import {
+  computeContentHash,
+  extractCodeContent,
+  extractBaselineInfo,
+  generateHeaderComment,
+  isFrameworkFile,
+} from './hash-utils'
+
+const FRAMEWORK_GLOBS = [
+  'src/shared/core/**/*.ts',
+  'src/server/core/**/*.ts',
+  'src/server/entries/**/*.ts',
+  'src/server/test-utils/**/*.ts',
+  'src/server/index.ts',
+  'src/client/services/**/*.ts',
+  'eslint.config.js',
+  'eslint-rules/**/*.js',
+]
+
+function initFile(filePath: string): {
+  file: string
+  baseline: string
+  action: 'created' | 'skipped'
+} {
+  const content = fs.readFileSync(filePath, 'utf-8')
+  const info = extractBaselineInfo(content)
+
+  if (info.baseline) {
+    return { file: filePath, baseline: info.baseline, action: 'skipped' }
+  }
+
+  const codeContent = extractCodeContent(content)
+  const baseline = computeContentHash(codeContent)
+  const header = generateHeaderComment(baseline)
+
+  const newContent = header + '\n\n' + content
+  fs.writeFileSync(filePath, newContent, 'utf-8')
+
+  return { file: filePath, baseline, action: 'created' }
+}
+
+async function main() {
+  console.log('🔧 初始化框架文件基准...\n')
+
+  const allFiles: string[] = []
+
+  for (const pattern of FRAMEWORK_GLOBS) {
+    const files = await glob(pattern, { cwd: process.cwd() })
+    allFiles.push(...files)
+  }
+
+  const frameworkFiles = allFiles.filter(f => isFrameworkFile(f))
+
+  if (frameworkFiles.length === 0) {
+    console.log('⚠️  未找到框架文件')
+    return
+  }
+
+  console.log(`📁 找到 ${frameworkFiles.length} 个框架文件:\n`)
+
+  const results: Array<{ file: string; baseline: string; action: 'created' | 'skipped' }> = []
+
+  for (const file of frameworkFiles) {
+    const result = initFile(file)
+    results.push(result)
+
+    const status = result.action === 'created' ? '✅ 已添加基准' : '⏭️  已存在基准'
+    console.log(`  ${status} ${file}`)
+    console.log(`     基准: ${result.baseline}\n`)
+  }
+
+  const created = results.filter(r => r.action === 'created').length
+  const skipped = results.filter(r => r.action === 'skipped').length
+
+  console.log('─'.repeat(50))
+  console.log(`✨ 初始化完成！`)
+  console.log(`   新增: ${created} 个文件`)
+  console.log(`   跳过: ${skipped} 个文件`)
+}
+
+main().catch(console.error)

package/template/lint-scripts/framework/update-baseline.ts

@@ -0,0 +1,148 @@
+import * as fs from 'fs'
+import * as path from 'path'
+import { glob } from 'glob'
+import {
+  computeContentHash,
+  extractCodeContent,
+  extractBaselineInfo,
+  isFrameworkFile,
+  updateFileBaseline,
+} from './hash-utils'
+
+const FRAMEWORK_GLOBS = [
+  'src/shared/core/**/*.ts',
+  'src/server/core/**/*.ts',
+  'src/server/entries/**/*.ts',
+  'src/server/test-utils/**/*.ts',
+  'src/server/index.ts',
+  'src/client/services/**/*.ts',
+]
+
+const HISTORY_FILE = 'FRAMEWORK_HISTORY.md'
+
+interface ChangeRecord {
+  file: string
+  oldBaseline: string
+  newBaseline: string
+  reason: string | null
+  impact: string | null
+  approvedBy: string | null
+}
+
+function appendToHistory(records: ChangeRecord[]): void {
+  const timestamp = new Date().toISOString().split('T')[0]
+
+  let historyContent = ''
+
+  if (fs.existsSync(HISTORY_FILE)) {
+    historyContent = fs.readFileSync(HISTORY_FILE, 'utf-8')
+  } else {
+    historyContent = `# 框架文件修改历史
+
+本文件记录所有框架层代码的修改历史。
+
+框架层路径：
+- \`src/shared/core/\`
+- \`src/server/core/\`
+- \`src/server/entries/\`
+- \`src/server/test-utils/\`
+- \`src/server/index.ts\`
+- \`src/client/services/\`
+
+---
+
+| 日期 | 文件 | 基准变更 | 修改原因 | 影响范围 | 审批人 |
+|------|------|----------|----------|----------|--------|
+`
+  }
+
+  const newRows = records
+    .filter((r) => r.reason)
+    .map((r) => {
+      const relativePath = r.file.replace(process.cwd() + '/', '')
+      return `| ${timestamp} | ${relativePath} | ${r.oldBaseline} → ${r.newBaseline} | ${r.reason || '-'} | ${r.impact || '-'} | ${r.approvedBy || '-'} |`
+    })
+    .join('\n')
+
+  if (newRows) {
+    historyContent = historyContent.trimEnd() + '\n' + newRows + '\n'
+    fs.writeFileSync(HISTORY_FILE, historyContent, 'utf-8')
+  }
+}
+
+async function main() {
+  console.log('🔄 更新框架文件基准...\n')
+
+  const allFiles: string[] = []
+
+  for (const pattern of FRAMEWORK_GLOBS) {
+    const files = await glob(pattern, { cwd: process.cwd() })
+    allFiles.push(...files)
+  }
+
+  const frameworkFiles = allFiles.filter((f) => isFrameworkFile(f))
+
+  if (frameworkFiles.length === 0) {
+    console.log('⚠️  未找到框架文件')
+    return
+  }
+
+  const changes: ChangeRecord[] = []
+  let updatedCount = 0
+  let unchangedCount = 0
+
+  for (const file of frameworkFiles) {
+    const content = fs.readFileSync(file, 'utf-8')
+    const info = extractBaselineInfo(content)
+
+    if (!info.baseline) {
+      console.log(`⏭️  跳过 ${file} (无基准)`)
+      continue
+    }
+
+    const codeContent = extractCodeContent(content)
+    const newBaseline = computeContentHash(codeContent)
+
+    if (newBaseline === info.baseline) {
+      unchangedCount++
+      continue
+    }
+
+    if (!info.hasModify) {
+      console.log(`⚠️  ${file} 已修改但未记录修改说明，跳过更新`)
+      console.log(`   请先添加 @framework-modify 和 @reason/@impact 注释\n`)
+      continue
+    }
+
+    updateFileBaseline(file, newBaseline)
+    updatedCount++
+
+    changes.push({
+      file,
+      oldBaseline: info.baseline,
+      newBaseline,
+      reason: info.reason,
+      impact: info.impact,
+      approvedBy: info.approvedBy,
+    })
+
+    console.log(`✅ ${file}`)
+    console.log(`   ${info.baseline} → ${newBaseline}`)
+    if (info.reason) {
+      console.log(`   原因: ${info.reason}`)
+    }
+    console.log()
+  }
+
+  if (changes.length > 0) {
+    appendToHistory(changes)
+    console.log(`📝 已更新 ${HISTORY_FILE}`)
+  }
+
+  console.log('─'.repeat(50))
+  console.log(`✨ 更新完成！`)
+  console.log(`   已更新: ${updatedCount} 个文件`)
+  console.log(`   未变化: ${unchangedCount} 个文件`)
+}
+
+main().catch(console.error)

package/template/lint-scripts/post-commit-track.ts

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+import {
+  trackTests,
+  getGitInfo,
+  ensureDirectories,
+  saveTestRecord,
+  createTestRecord,
+  runTestsWithJson,
+} from './test-tracker.js'
+
+async function postCommitTrack(): Promise<void> {
+  if (process.env.SKIP_TEST_TRACK === 'true') {
+    console.log('⏭️  Test tracking skipped (SKIP_TEST_TRACK=true)')
+    process.exit(0)
+  }
+
+  const gitInfo = getGitInfo()
+
+  const branch = gitInfo.branch
+  if (branch === 'main' || branch === 'master' || branch === 'develop') {
+    console.log('📝 Tracking test results for this commit...')
+  } else {
+    console.log(`📝 Tracking test results for branch: ${branch}...`)
+  }
+
+  console.log(`🔍 Commit: ${gitInfo.shortSha} - ${gitInfo.commitMessage}`)
+
+  console.log('🧪 Running tests...')
+  const report = runTestsWithJson()
+
+  if (!report) {
+    console.error('❌ Failed to get test results')
+    console.log('\n💡 This might happen if:')
+    console.log('   - Tests are not configured properly')
+    console.log('   - No test files exist')
+    console.log('   - Test runner encountered an error')
+    process.exit(0)
+  }
+
+  const record = createTestRecord(report, gitInfo)
+  saveTestRecord(record)
+
+  const status = record.failed === 0 ? '✅' : '❌'
+  console.log(
+    `\n${status} Tests: ${record.passed}/${record.totalTests} passed, ${record.failed} failed`
+  )
+  console.log(`⏱️  Duration: ${(record.duration / 1000).toFixed(2)}s`)
+
+  if (record.failed > 0) {
+    console.log('\n❌ Failed tests:')
+    for (const test of record.testResults.filter(t => t.status === 'failed')) {
+      console.log(`  - ${test.name}`)
+      if (test.error) {
+        const firstLine = test.error.split('\n')[0]
+        console.log(`    ${firstLine.substring(0, 80)}${firstLine.length > 80 ? '...' : ''}`)
+      }
+    }
+    console.log('\n💡 Run `npm run test:history:show` to see full details')
+  }
+}
+
+postCommitTrack().catch(error => {
+  console.error('❌ Post-commit tracking failed:', error)
+  process.exit(0)
+})

package/template/lint-scripts/quick-test.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+
+# 快速测试脚本
+# 用于快速验证所有验证器功能
+
+set -e
+
+echo "🚀 快速验证测试"
+echo "=================================================="
+echo ""
+
+echo "📋 测试 1: 运行单元测试..."
+echo "--------------------------------------------------"
+node --import tsx/esm lint-scripts/test-validators-unit.ts
+
+echo ""
+echo "📋 测试 2: 运行完整验证..."
+echo "--------------------------------------------------"
+npm run validate:all
+
+echo ""
+echo "=================================================="
+echo "✅ 所有测试完成！"
+echo "=================================================="
+echo ""
+echo "📚 更多测试方法请查看: lint-scripts/TESTING.md"
+echo ""