@pzy560117/codex-harness 0.1.3 → 0.1.5

package/package-source/docs/codex-harness-engineering/templates/tools/harness/impact-lint.ps1

@@ -0,0 +1,148 @@
+param(
+  [string]$ProjectRoot = "",
+  [switch]$AsJson,
+  [switch]$AllowWarningsOnly
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+if ([string]::IsNullOrWhiteSpace($ProjectRoot)) {
+  $ProjectRoot = [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot "..\..\..\.."))
+}
+
+function New-Issue {
+  param(
+    [string]$Severity,
+    [string]$File,
+    [string]$Section,
+    [string]$Message
+  )
+
+  [PSCustomObject]@{
+    severity = $Severity
+    file = $File
+    section = $Section
+    message = $Message
+  }
+}
+
+function Get-FileContentOrNull {
+  param([string]$Path)
+
+  if (-not (Test-Path -LiteralPath $Path)) {
+    return $null
+  }
+
+  Get-Content -LiteralPath $Path -Raw
+}
+
+function Test-ContainsAll {
+  param(
+    [string]$Content,
+    [string[]]$Terms
+  )
+
+  foreach ($term in $Terms) {
+    if ($Content -notmatch [regex]::Escape($term)) {
+      return $false
+    }
+  }
+
+  return $true
+}
+
+$issues = @()
+
+$codeNavPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\code-semantics-and-navigation.md"
+$repoMapPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\context\repo-map.md"
+$currentTaskPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\context\CURRENT_TASK.md"
+$devPlanPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\context\dev-plan.md"
+$regressionPlanPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\testing\REGRESSION_PLAN.md"
+
+$codeNav = Get-FileContentOrNull -Path $codeNavPath
+$repoMap = Get-FileContentOrNull -Path $repoMapPath
+$currentTask = Get-FileContentOrNull -Path $currentTaskPath
+$devPlan = Get-FileContentOrNull -Path $devPlanPath
+$regressionPlan = Get-FileContentOrNull -Path $regressionPlanPath
+
+if ($null -eq $codeNav) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/code-semantics-and-navigation.md" -Section "file" -Message "缺少代码语义与导航模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $codeNav -Terms @("影响面分析最少回答", "入口在哪里", "上游是谁", "下游是谁", "受影响文件有哪些", "受影响测试和验证命令有哪些"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/code-semantics-and-navigation.md" -Section "impact-baseline" -Message "代码语义与导航模板缺少第14章要求的调用链和影响面最小回答。"
+  }
+}
+
+if ($null -eq $repoMap) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/context/repo-map.md" -Section "file" -Message "缺少 repo-map 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $repoMap -Terms @("关键调用链", "影响面分析时至少回答", "受影响文件有哪些", "受影响测试和验证命令有哪些"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/context/repo-map.md" -Section "impact-entry" -Message "repo-map 模板还没有完整承接第14章的影响面分析入口。"
+  }
+}
+
+if ($null -eq $currentTask) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "file" -Message "缺少 CURRENT_TASK 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $currentTask -Terms @("可能影响哪些调用方", "直接影响", "间接影响", "相关接口 / 契约", "相关页面 / 路由", "回归范围"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "impact-fields" -Message "CURRENT_TASK 模板缺少第14章要求的影响面字段。"
+  }
+}
+
+if ($null -eq $devPlan) {
+  $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/context/dev-plan.md" -Section "file" -Message "缺少 DEV-PLAN 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $devPlan -Terms @("affected tests", "evidence path 和回归范围", "P0/P1 需求缺少 `TEST_DATA_MATRIX.md`、`REGRESSION_PLAN.md` 或 affected tests"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/context/dev-plan.md" -Section "impact-plan" -Message "DEV-PLAN 模板还没有完整承接第14章要求的 affected tests 和回归范围约束。"
+  }
+}
+
+if ($null -eq $regressionPlan) {
+  $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/testing/REGRESSION_PLAN.md" -Section "file" -Message "缺少回归计划模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $regressionPlan -Terms @("## 影响面", "直接影响", "间接影响", "相关接口 / 契约", "相关页面 / 路由", "潜在风险"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/testing/REGRESSION_PLAN.md" -Section "impact-regression" -Message "回归计划模板还没有完整承接第14章要求的影响面与回归范围字段。"
+  }
+}
+
+$errors = @($issues | Where-Object { $_.severity -eq "error" })
+$warnings = @($issues | Where-Object { $_.severity -eq "warning" })
+$exitCode = if ($errors.Count -gt 0) { 1 } elseif ($warnings.Count -gt 0 -and -not $AllowWarningsOnly) { 2 } else { 0 }
+
+if ($AsJson) {
+  [PSCustomObject]@{
+    ok = ($exitCode -eq 0)
+    errors = $errors
+    warnings = $warnings
+  } | ConvertTo-Json -Depth 6
+  exit $exitCode
+}
+
+if ($errors.Count -eq 0 -and $warnings.Count -eq 0) {
+  Write-Output "Impact lint passed."
+  exit 0
+}
+
+if ($errors.Count -gt 0) {
+  Write-Output "Impact lint failed."
+  foreach ($issue in $errors) {
+    Write-Output ("- [ERROR] {0} :: {1} :: {2}" -f $issue.file, $issue.section, $issue.message)
+  }
+}
+
+if ($warnings.Count -gt 0) {
+  if ($errors.Count -eq 0) {
+    Write-Output "Impact lint passed with warnings."
+  }
+  foreach ($issue in $warnings) {
+    Write-Output ("- [WARNING] {0} :: {1} :: {2}" -f $issue.file, $issue.section, $issue.message)
+  }
+}
+
+exit $exitCode

package/package-source/docs/codex-harness-engineering/templates/tools/harness/integration-lint.ps1

@@ -0,0 +1,37 @@
+param(
+  [string]$ProjectRoot = "",
+  [switch]$AsJson,
+  [switch]$AllowWarningsOnly
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+if ([string]::IsNullOrWhiteSpace($ProjectRoot)) {
+  $ProjectRoot = [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot "..\..\..\.."))
+}
+
+function New-Issue { param([string]$Severity,[string]$File,[string]$Section,[string]$Message) [PSCustomObject]@{ severity=$Severity; file=$File; section=$Section; message=$Message } }
+function Get-FileContentOrNull { param([string]$Path) if (-not (Test-Path -LiteralPath $Path)) { return $null }; Get-Content -LiteralPath $Path -Raw }
+function Test-ContainsAll { param([string]$Content,[string[]]$Terms) foreach ($term in $Terms) { if ($Content -notmatch [regex]::Escape($term)) { return $false } }; return $true }
+
+$issues = @()
+$serviceMatrix = Get-FileContentOrNull (Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\service-dependency-matrix.md")
+$currentTask = Get-FileContentOrNull (Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\context\CURRENT_TASK.md")
+$demoReadme = Get-FileContentOrNull (Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\demo-readme.md")
+
+if ($null -eq $serviceMatrix) { $issues += New-Issue "error" "docs/codex-harness-engineering/templates/docs/service-dependency-matrix.md" "file" "缺少 service-dependency-matrix 模板。" }
+elseif (-not (Test-ContainsAll $serviceMatrix @("callback_webhook", "credential_source", "retry_idempotency", "rate_limit_or_quota", "failure_fallback"))) { $issues += New-Issue "error" "docs/codex-harness-engineering/templates/docs/service-dependency-matrix.md" "integration-fields" "service-dependency-matrix 模板缺少第22章要求的第三方集成字段。" }
+if ($null -eq $currentTask) { $issues += New-Issue "warning" "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" "file" "缺少 CURRENT_TASK 模板。" }
+elseif (-not (Test-ContainsAll $currentTask @("第三方服务 / SDK 依赖", "第三方回调 / Webhook / 验签策略", "凭据 / Secret 注入位置", "上传约束（大小 / 类型 / 扫描 / 权限 / CDN）"))) { $issues += New-Issue "warning" "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" "integration-task-fields" "CURRENT_TASK 模板缺少第22章要求的第三方集成记录字段。" }
+if ($null -eq $demoReadme) { $issues += New-Issue "warning" "docs/codex-harness-engineering/templates/docs/demo-readme.md" "file" "缺少 demo-readme 模板。" }
+elseif (-not (Test-ContainsAll $demoReadme @("支付 / 订单", "推送 / 短信", "接真实支付、签名、回调、失败重试"))) { $issues += New-Issue "warning" "docs/codex-harness-engineering/templates/docs/demo-readme.md" "demo-boundary" "demo-readme 模板还没有完整标出第22章要求的真实第三方边界。" }
+
+$errors = @($issues | Where-Object severity -eq "error")
+$warnings = @($issues | Where-Object severity -eq "warning")
+$exitCode = if ($errors.Count -gt 0) { 1 } elseif ($warnings.Count -gt 0 -and -not $AllowWarningsOnly) { 2 } else { 0 }
+if ($AsJson) { [PSCustomObject]@{ ok = ($exitCode -eq 0); errors = $errors; warnings = $warnings } | ConvertTo-Json -Depth 6; exit $exitCode }
+if ($errors.Count -eq 0 -and $warnings.Count -eq 0) { Write-Output "Integration lint passed."; exit 0 }
+if ($errors.Count -gt 0) { Write-Output "Integration lint failed."; foreach ($issue in $errors) { Write-Output ("- [ERROR] {0} :: {1} :: {2}" -f $issue.file, $issue.section, $issue.message) } }
+if ($warnings.Count -gt 0) { if ($errors.Count -eq 0) { Write-Output "Integration lint passed with warnings." }; foreach ($issue in $warnings) { Write-Output ("- [WARNING] {0} :: {1} :: {2}" -f $issue.file, $issue.section, $issue.message) } }
+exit $exitCode

package/package-source/docs/codex-harness-engineering/templates/tools/harness/mobile-lint.ps1

@@ -0,0 +1,37 @@
+param(
+  [string]$ProjectRoot = "",
+  [switch]$AsJson,
+  [switch]$AllowWarningsOnly
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+if ([string]::IsNullOrWhiteSpace($ProjectRoot)) {
+  $ProjectRoot = [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot "..\..\..\.."))
+}
+
+function New-Issue { param([string]$Severity,[string]$File,[string]$Section,[string]$Message) [PSCustomObject]@{ severity=$Severity; file=$File; section=$Section; message=$Message } }
+function Get-FileContentOrNull { param([string]$Path) if (-not (Test-Path -LiteralPath $Path)) { return $null }; Get-Content -LiteralPath $Path -Raw }
+function Test-ContainsAll { param([string]$Content,[string[]]$Terms) foreach ($term in $Terms) { if ($Content -notmatch [regex]::Escape($term)) { return $false } }; return $true }
+
+$issues = @()
+$frontendQuality = Get-FileContentOrNull (Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\frontend-quality-rules.md")
+$currentTask = Get-FileContentOrNull (Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\context\CURRENT_TASK.md")
+$verifyMatrix = Get-FileContentOrNull (Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\testing\verify-matrix.md")
+
+if ($null -eq $frontendQuality) { $issues += New-Issue "error" "docs/codex-harness-engineering/templates/docs/frontend-quality-rules.md" "file" "缺少 frontend-quality-rules 模板。" }
+elseif (-not (Test-ContainsAll $frontendQuality @("iOS / Android 差异处理", "权限申请", "生命周期 / 中断恢复策略", "真机 / 系统版本矩阵"))) { $issues += New-Issue "error" "docs/codex-harness-engineering/templates/docs/frontend-quality-rules.md" "mobile-app-rules" "frontend-quality-rules 模板缺少第23章要求的平台差异、权限、生命周期或真机矩阵规则。" }
+if ($null -eq $currentTask) { $issues += New-Issue "warning" "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" "file" "缺少 CURRENT_TASK 模板。" }
+elseif (-not (Test-ContainsAll $currentTask @("平台差异（iOS / Android / H5 / 小程序）", "权限申请与拒绝回退", "生命周期 / 中断恢复策略", "设备 / 系统版本验证矩阵"))) { $issues += New-Issue "warning" "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" "mobile-fields" "CURRENT_TASK 模板缺少第23章要求的移动端专项字段。" }
+if ($null -eq $verifyMatrix) { $issues += New-Issue "warning" "docs/codex-harness-engineering/templates/testing/verify-matrix.md" "file" "缺少 verify-matrix 模板。" }
+elseif (-not (Test-ContainsAll $verifyMatrix @("平台差异检查", "权限弹窗 / 拒绝回退", "生命周期 / 中断恢复", "真机 / 版本矩阵"))) { $issues += New-Issue "warning" "docs/codex-harness-engineering/templates/testing/verify-matrix.md" "mobile-verify" "verify-matrix 模板缺少第23章要求的移动端验证矩阵。" }
+
+$errors = @($issues | Where-Object severity -eq "error")
+$warnings = @($issues | Where-Object severity -eq "warning")
+$exitCode = if ($errors.Count -gt 0) { 1 } elseif ($warnings.Count -gt 0 -and -not $AllowWarningsOnly) { 2 } else { 0 }
+if ($AsJson) { [PSCustomObject]@{ ok = ($exitCode -eq 0); errors = $errors; warnings = $warnings } | ConvertTo-Json -Depth 6; exit $exitCode }
+if ($errors.Count -eq 0 -and $warnings.Count -eq 0) { Write-Output "Mobile lint passed."; exit 0 }
+if ($errors.Count -gt 0) { Write-Output "Mobile lint failed."; foreach ($issue in $errors) { Write-Output ("- [ERROR] {0} :: {1} :: {2}" -f $issue.file, $issue.section, $issue.message) } }
+if ($warnings.Count -gt 0) { if ($errors.Count -eq 0) { Write-Output "Mobile lint passed with warnings." }; foreach ($issue in $warnings) { Write-Output ("- [WARNING] {0} :: {1} :: {2}" -f $issue.file, $issue.section, $issue.message) } }
+exit $exitCode

package/package-source/docs/codex-harness-engineering/templates/tools/harness/observability-lint.ps1

@@ -0,0 +1,137 @@
+param(
+  [string]$ProjectRoot = "",
+  [switch]$AsJson,
+  [switch]$AllowWarningsOnly
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+if ([string]::IsNullOrWhiteSpace($ProjectRoot)) {
+  $ProjectRoot = [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot "..\..\..\.."))
+}
+
+function New-Issue {
+  param(
+    [string]$Severity,
+    [string]$File,
+    [string]$Section,
+    [string]$Message
+  )
+
+  [PSCustomObject]@{
+    severity = $Severity
+    file = $File
+    section = $Section
+    message = $Message
+  }
+}
+
+function Get-FileContentOrNull {
+  param([string]$Path)
+
+  if (-not (Test-Path -LiteralPath $Path)) {
+    return $null
+  }
+
+  Get-Content -LiteralPath $Path -Raw
+}
+
+function Test-ContainsAll {
+  param(
+    [string]$Content,
+    [string[]]$Terms
+  )
+
+  foreach ($term in $Terms) {
+    if ($Content -notmatch [regex]::Escape($term)) {
+      return $false
+    }
+  }
+
+  return $true
+}
+
+$issues = @()
+
+$traceFormatPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\trace-format.md"
+$traceSchemaPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\trace\trace.schema.json"
+$evidenceProtocolPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\testing\EVIDENCE_PROTOCOL.md"
+$currentTaskPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\context\CURRENT_TASK.md"
+
+$traceFormat = Get-FileContentOrNull -Path $traceFormatPath
+$traceSchema = Get-FileContentOrNull -Path $traceSchemaPath
+$evidenceProtocol = Get-FileContentOrNull -Path $evidenceProtocolPath
+$currentTask = Get-FileContentOrNull -Path $currentTaskPath
+
+if ($null -eq $traceFormat) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/trace-format.md" -Section "file" -Message "缺少 trace-format 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $traceFormat -Terms @("可观测性最低要求", "请求 ID", "用户 ID / actor", "接口路径或业务入口", "失败原因", "耗时", "审计记录", "告警或失败通知"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/trace-format.md" -Section "observability-fields" -Message "trace-format 模板缺少第17章要求的日志与可观测性最低字段。"
+  }
+}
+
+if ($null -eq $traceSchema) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/trace/trace.schema.json" -Section "file" -Message "缺少 trace schema 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $traceSchema -Terms @("qa_evidence", "failure_repro", "events_file", "log_files", "evidence_files"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/trace/trace.schema.json" -Section "trace-shape" -Message "trace schema 模板还没有完整暴露可观测性相关证据面。"
+  }
+}
+
+if ($null -eq $evidenceProtocol) {
+  $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/testing/EVIDENCE_PROTOCOL.md" -Section "file" -Message "缺少证据协议模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $evidenceProtocol -Terms @("request_trace_sample", "alert_evidence", "audit_log"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/testing/EVIDENCE_PROTOCOL.md" -Section "observability-evidence" -Message "证据协议模板缺少第17章要求的请求追踪、告警或审计证据类型。"
+  }
+}
+
+if ($null -eq $currentTask) {
+  $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "file" -Message "缺少 CURRENT_TASK 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $currentTask -Terms @("日志 / trace 字段要求", "观测指标 / 告警策略"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "observability-fields" -Message "CURRENT_TASK 模板缺少第17章要求的日志或告警决策字段。"
+  }
+}
+
+$errors = @($issues | Where-Object { $_.severity -eq "error" })
+$warnings = @($issues | Where-Object { $_.severity -eq "warning" })
+$exitCode = if ($errors.Count -gt 0) { 1 } elseif ($warnings.Count -gt 0 -and -not $AllowWarningsOnly) { 2 } else { 0 }
+
+if ($AsJson) {
+  [PSCustomObject]@{
+    ok = ($exitCode -eq 0)
+    errors = $errors
+    warnings = $warnings
+  } | ConvertTo-Json -Depth 6
+  exit $exitCode
+}
+
+if ($errors.Count -eq 0 -and $warnings.Count -eq 0) {
+  Write-Output "Observability lint passed."
+  exit 0
+}
+
+if ($errors.Count -gt 0) {
+  Write-Output "Observability lint failed."
+  foreach ($issue in $errors) {
+    Write-Output ("- [ERROR] {0} :: {1} :: {2}" -f $issue.file, $issue.section, $issue.message)
+  }
+}
+
+if ($warnings.Count -gt 0) {
+  if ($errors.Count -eq 0) {
+    Write-Output "Observability lint passed with warnings."
+  }
+  foreach ($issue in $warnings) {
+    Write-Output ("- [WARNING] {0} :: {1} :: {2}" -f $issue.file, $issue.section, $issue.message)
+  }
+}
+
+exit $exitCode

package/package-source/docs/codex-harness-engineering/templates/tools/harness/performance-lint.ps1

@@ -0,0 +1,148 @@
+param(
+  [string]$ProjectRoot = "",
+  [switch]$AsJson,
+  [switch]$AllowWarningsOnly
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+if ([string]::IsNullOrWhiteSpace($ProjectRoot)) {
+  $ProjectRoot = [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot "..\..\..\.."))
+}
+
+function New-Issue {
+  param(
+    [string]$Severity,
+    [string]$File,
+    [string]$Section,
+    [string]$Message
+  )
+
+  [PSCustomObject]@{
+    severity = $Severity
+    file = $File
+    section = $Section
+    message = $Message
+  }
+}
+
+function Get-FileContentOrNull {
+  param([string]$Path)
+
+  if (-not (Test-Path -LiteralPath $Path)) {
+    return $null
+  }
+
+  Get-Content -LiteralPath $Path -Raw
+}
+
+function Test-ContainsAll {
+  param(
+    [string]$Content,
+    [string[]]$Terms
+  )
+
+  foreach ($term in $Terms) {
+    if ($Content -notmatch [regex]::Escape($term)) {
+      return $false
+    }
+  }
+
+  return $true
+}
+
+$issues = @()
+
+$frontendArchitecturePath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\design\frontend-architecture.md"
+$designBriefPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\design\design-brief.md"
+$frontendQualityPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\frontend-quality-rules.md"
+$prdPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\product\prd-lite.md"
+$currentTaskPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\context\CURRENT_TASK.md"
+
+$frontendArchitecture = Get-FileContentOrNull -Path $frontendArchitecturePath
+$designBrief = Get-FileContentOrNull -Path $designBriefPath
+$frontendQuality = Get-FileContentOrNull -Path $frontendQualityPath
+$prd = Get-FileContentOrNull -Path $prdPath
+$currentTask = Get-FileContentOrNull -Path $currentTaskPath
+
+if ($null -eq $frontendArchitecture) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/design/frontend-architecture.md" -Section "file" -Message "缺少 frontend-architecture 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $frontendArchitecture -Terms @('## 9. 性能预算', '列表行数', '首屏依赖', '图片 / 图标', 'client / server / virtualized'))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/design/frontend-architecture.md" -Section "frontend-performance" -Message "frontend-architecture 模板缺少第15章要求的前端性能预算字段。"
+  }
+}
+
+if ($null -eq $designBrief) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/design/design-brief.md" -Section "file" -Message "缺少 design-brief 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $designBrief -Terms @('## 11.1 性能预算', '首屏依赖', '列表 / 表格规模', '数据刷新频率'))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/design/design-brief.md" -Section "design-performance" -Message "design-brief 模板缺少第15章要求的 UI 性能预算项。"
+  }
+}
+
+if ($null -eq $frontendQuality) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/frontend-quality-rules.md" -Section "file" -Message "缺少 frontend-quality-rules 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $frontendQuality -Terms @('## 8. 性能预算', '首屏依赖过多组件、图标、图表或动画库', '表格超过 100 行、复杂筛选、虚拟滚动或服务端分页需求', '性能风险检查结论'))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/frontend-quality-rules.md" -Section "ui-performance-rules" -Message "frontend-quality-rules 模板缺少第15章要求的前端性能风险与证据规则。"
+  }
+}
+
+if ($null -eq $prd) {
+  $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/product/prd-lite.md" -Section "file" -Message "缺少 PRD-Lite 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $prd -Terms @('| 性能 |', '| 安全 |', '| 可用性 |'))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/product/prd-lite.md" -Section "nfr-performance" -Message "PRD-Lite 模板还没有把性能作为明确的非功能需求入口。"
+  }
+}
+
+if ($null -eq $currentTask) {
+  $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "file" -Message "缺少 CURRENT_TASK 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $currentTask -Terms @('前端性能预算', '后端性能策略（索引 / 缓存 / 分页 / N+1）', '弱网 / 离线 / 大数据量策略'))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "performance-fields" -Message "CURRENT_TASK 模板缺少第15章要求的性能决策字段。"
+  }
+}
+
+$errors = @($issues | Where-Object { $_.severity -eq "error" })
+$warnings = @($issues | Where-Object { $_.severity -eq "warning" })
+$exitCode = if ($errors.Count -gt 0) { 1 } elseif ($warnings.Count -gt 0 -and -not $AllowWarningsOnly) { 2 } else { 0 }
+
+if ($AsJson) {
+  [PSCustomObject]@{
+    ok = ($exitCode -eq 0)
+    errors = $errors
+    warnings = $warnings
+  } | ConvertTo-Json -Depth 6
+  exit $exitCode
+}
+
+if ($errors.Count -eq 0 -and $warnings.Count -eq 0) {
+  Write-Output "Performance lint passed."
+  exit 0
+}
+
+if ($errors.Count -gt 0) {
+  Write-Output "Performance lint failed."
+  foreach ($issue in $errors) {
+    Write-Output ("- [ERROR] {0} :: {1} :: {2}" -f $issue.file, $issue.section, $issue.message)
+  }
+}
+
+if ($warnings.Count -gt 0) {
+  if ($errors.Count -eq 0) {
+    Write-Output "Performance lint passed with warnings."
+  }
+  foreach ($issue in $warnings) {
+    Write-Output ("- [WARNING] {0} :: {1} :: {2}" -f $issue.file, $issue.section, $issue.message)
+  }
+}
+
+exit $exitCode

package/package-source/docs/codex-harness-engineering/templates/tools/harness/refactor-lint.ps1

@@ -0,0 +1,137 @@
+param(
+  [string]$ProjectRoot = "",
+  [switch]$AsJson,
+  [switch]$AllowWarningsOnly
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+if ([string]::IsNullOrWhiteSpace($ProjectRoot)) {
+  $ProjectRoot = [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot "..\..\..\.."))
+}
+
+function New-Issue {
+  param(
+    [string]$Severity,
+    [string]$File,
+    [string]$Section,
+    [string]$Message
+  )
+
+  [PSCustomObject]@{
+    severity = $Severity
+    file = $File
+    section = $Section
+    message = $Message
+  }
+}
+
+function Get-FileContentOrNull {
+  param([string]$Path)
+
+  if (-not (Test-Path -LiteralPath $Path)) {
+    return $null
+  }
+
+  Get-Content -LiteralPath $Path -Raw
+}
+
+function Test-ContainsAll {
+  param(
+    [string]$Content,
+    [string[]]$Terms
+  )
+
+  foreach ($term in $Terms) {
+    if ($Content -notmatch [regex]::Escape($term)) {
+      return $false
+    }
+  }
+
+  return $true
+}
+
+$issues = @()
+
+$currentTaskPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\context\CURRENT_TASK.md"
+$implementPromptPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\prompts\implement-one-task.md"
+$regressionRulesPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\regression-rules.md"
+$repairPromptPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\prompts\repair-one-finding.md"
+
+$currentTask = Get-FileContentOrNull -Path $currentTaskPath
+$implementPrompt = Get-FileContentOrNull -Path $implementPromptPath
+$regressionRules = Get-FileContentOrNull -Path $regressionRulesPath
+$repairPrompt = Get-FileContentOrNull -Path $repairPromptPath
+
+if ($null -eq $currentTask) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "file" -Message "缺少 CURRENT_TASK 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $currentTask -Terms @("任务性质（bugfix / feature / refactor / chore）", "行为不变约束", "允许清理的死代码 / 临时代码", "不允许删除的兼容逻辑 / 历史入口"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "refactor-fields" -Message "CURRENT_TASK 模板缺少第18章要求的任务类型、行为不变或死代码清理字段。"
+  }
+}
+
+if ($null -eq $implementPrompt) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/prompts/implement-one-task.md" -Section "file" -Message "缺少实现 prompt 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $implementPrompt -Terms @("bugfix", "feature", "refactor", "chore", "如果是 `refactor`，必须先列出“行为不变约束”", "无用变量", "无用函数", "临时代码"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/prompts/implement-one-task.md" -Section "refactor-flow" -Message "实现 prompt 还没有完整承接第18章的任务类型区分或死代码清理检查。"
+  }
+}
+
+if ($null -eq $regressionRules) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/regression-rules.md" -Section "file" -Message "缺少回归规则模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $regressionRules -Terms @("重构任务必须显式声明行为不变约束", "无用变量", "无用函数", "无用组件", "兼容逻辑"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/docs/regression-rules.md" -Section "refactor-regression" -Message "回归规则模板还没有完整承接第18章的行为不变和死代码清理要求。"
+  }
+}
+
+if ($null -eq $repairPrompt) {
+  $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/prompts/repair-one-finding.md" -Section "file" -Message "缺少 repair prompt 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $repairPrompt -Terms @("不顺手重构", "不要把单点修复顺手扩展成结构性重构或死代码清理任务"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/prompts/repair-one-finding.md" -Section "repair-boundary" -Message "repair prompt 还没有完整承接第18章的小步修复边界。"
+  }
+}
+
+$errors = @($issues | Where-Object { $_.severity -eq "error" })
+$warnings = @($issues | Where-Object { $_.severity -eq "warning" })
+$exitCode = if ($errors.Count -gt 0) { 1 } elseif ($warnings.Count -gt 0 -and -not $AllowWarningsOnly) { 2 } else { 0 }
+
+if ($AsJson) {
+  [PSCustomObject]@{
+    ok = ($exitCode -eq 0)
+    errors = $errors
+    warnings = $warnings
+  } | ConvertTo-Json -Depth 6
+  exit $exitCode
+}
+
+if ($errors.Count -eq 0 -and $warnings.Count -eq 0) {
+  Write-Output "Refactor lint passed."
+  exit 0
+}
+
+if ($errors.Count -gt 0) {
+  Write-Output "Refactor lint failed."
+  foreach ($issue in $errors) {
+    Write-Output ("- [ERROR] {0} :: {1} :: {2}" -f $issue.file, $issue.section, $issue.message)
+  }
+}
+
+if ($warnings.Count -gt 0) {
+  if ($errors.Count -eq 0) {
+    Write-Output "Refactor lint passed with warnings."
+  }
+  foreach ($issue in $warnings) {
+    Write-Output ("- [WARNING] {0} :: {1} :: {2}" -f $issue.file, $issue.section, $issue.message)
+  }
+}
+
+exit $exitCode