@pzy560117/codex-harness 0.1.3 → 0.1.4

package/package-source/docs/codex-harness-engineering/templates/tools/harness/backend-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 = @()
+
+$architectureConstraintsPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\architecture-constraints.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"
+$projectAgentsTemplatePath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\project-agents-template.md"
+
+$architectureConstraints = Get-FileContentOrNull -Path $architectureConstraintsPath
+$currentTask = Get-FileContentOrNull -Path $currentTaskPath
+$devPlan = Get-FileContentOrNull -Path $devPlanPath
+$projectAgentsTemplate = Get-FileContentOrNull -Path $projectAgentsTemplatePath
+
+if ($null -eq $architectureConstraints) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/architecture-constraints.md" -Section "file" -Message "缺少架构约束包模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $architectureConstraints -Terms @("## 4.1 Backend Layering And Error Boundary", "controller_policy", "service_policy", "repository_policy_detail", "error_handling_policy", "transaction_boundary", "idempotency_policy"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/architecture-constraints.md" -Section "backend-boundary" -Message "architecture-constraints 模板缺少第11章要求的后端分层、异常处理、事务或幂等约束。"
+  }
+}
+
+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 @("Controller / Handler 边界", "Service 边界", "Repository / DAO 边界", "事务 / 幂等策略", "异常处理与错误码策略"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "backend-fields" -Message "CURRENT_TASK 模板缺少第11章要求的后端分层和异常/事务决策字段。"
+  }
+}
+
+if ($null -eq $devPlan) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/context/dev-plan.md" -Section "file" -Message "缺少 DEV-PLAN 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $devPlan -Terms @("Backend layering check", "事务 / 幂等验证", "异常处理 / 错误码验证", "Controller / Service / Repository 边界未声明", "事务、幂等或异常处理策略未声明"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/context/dev-plan.md" -Section "backend-plan-gates" -Message "DEV-PLAN 模板缺少第11章要求的后端验证矩阵或 BLOCKED 条件。"
+  }
+}
+
+if ($null -eq $projectAgentsTemplate) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/project-agents-template.md" -Section "file" -Message "缺少 project AGENTS 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $projectAgentsTemplate -Terms @("Controller 只处理请求和响应", "Service 处理业务逻辑", "Repository/DAO 处理数据库", "DTO 处理输入输出结构"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/docs/project-agents-template.md" -Section "backend-sample" -Message "project AGENTS 模板还没有完整覆盖第11章的后端分层样板。"
+  }
+}
+
+$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 "Backend lint passed."
+  exit 0
+}
+
+if ($errors.Count -gt 0) {
+  Write-Output "Backend 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 "Backend 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/business-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 = @()
+
+$prdPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\product\prd-lite.md"
+$stateMatrixPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\product\state-matrix.yaml"
+$traceabilityPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\testing\TRACEABILITY_MATRIX.md"
+$testStrategyPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\testing\TEST_STRATEGY.md"
+$nlCasesPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\testing\NATURAL_LANGUAGE_TEST_CASES.md"
+
+$prd = Get-FileContentOrNull -Path $prdPath
+$stateMatrix = Get-FileContentOrNull -Path $stateMatrixPath
+$traceability = Get-FileContentOrNull -Path $traceabilityPath
+$testStrategy = Get-FileContentOrNull -Path $testStrategyPath
+$nlCases = Get-FileContentOrNull -Path $nlCasesPath
+
+if ($null -eq $prd) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/product/prd-lite.md" -Section "file" -Message "缺少 PRD-Lite 模板，无法承载业务规则。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $prd -Terms @("## 11. 业务规则", "状态流转规则", "权限拒绝规则", "幂等 / 重复提交规则", "外部依赖失败或超时后的兜底规则", "关键不变量"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/product/prd-lite.md" -Section "business-rules" -Message "PRD-Lite 模板缺少第七章要求的业务规则类型清单。"
+  }
+}
+
+if ($null -eq $stateMatrix) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/product/state-matrix.yaml" -Section "file" -Message "缺少状态矩阵模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $stateMatrix -Terms @("related_business_rules", "business_rule_checklist", "是否存在重复提交 / 幂等保护", "是否存在关键不变量"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/product/state-matrix.yaml" -Section "rule-binding" -Message "状态矩阵模板缺少业务规则绑定或关键规则检查清单。"
+  }
+}
+
+if ($null -eq $traceability) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/TRACEABILITY_MATRIX.md" -Section "file" -Message "缺少追溯矩阵模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $traceability -Terms @("业务规则", "每条 P0/P1 业务规则至少要在矩阵中出现一次", "写操作、权限失败、非法状态流转和异步链路必须包含副作用或无副作用 Oracle"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/TRACEABILITY_MATRIX.md" -Section "traceability-rules" -Message "追溯矩阵模板缺少业务规则追溯或异常路径 Oracle 约束。"
+  }
+}
+
+if ($null -eq $testStrategy) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/TEST_STRATEGY.md" -Section "file" -Message "缺少测试策略模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $testStrategy -Terms @("不能只写 happy path", "业务规则如果会影响状态流转、副作用、金额/库存、权限或幂等，必须至少有一条异常路径或无副作用路径用例"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/TEST_STRATEGY.md" -Section "business-coverage" -Message "测试策略模板缺少第七章要求的非 happy path 业务规则覆盖约束。"
+  }
+}
+
+if ($null -eq $nlCases) {
+  $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/testing/NATURAL_LANGUAGE_TEST_CASES.md" -Section "file" -Message "缺少自然语言测试用例模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $nlCases -Terms @("重放请求", "无副作用证据", "不能只挂在 PRD 文本里不进测试"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/testing/NATURAL_LANGUAGE_TEST_CASES.md" -Section "business-rule-cases" -Message "自然语言用例模板还没有明确高风险业务规则必须映射测试用例。"
+  }
+}
+
+$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 "Business lint passed."
+  exit 0
+}
+
+if ($errors.Count -gt 0) {
+  Write-Output "Business 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 "Business 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/component-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 = @()
+
+$componentMapPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\design\component-map.md"
+$frontendArchitecturePath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\design\frontend-architecture.md"
+$frontendQualityPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\frontend-quality-rules.md"
+$currentTaskPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\context\CURRENT_TASK.md"
+$imageSpecPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\design\image-to-frontend-spec.md"
+
+$componentMap = Get-FileContentOrNull -Path $componentMapPath
+$frontendArchitecture = Get-FileContentOrNull -Path $frontendArchitecturePath
+$frontendQuality = Get-FileContentOrNull -Path $frontendQualityPath
+$currentTask = Get-FileContentOrNull -Path $currentTaskPath
+$imageSpec = Get-FileContentOrNull -Path $imageSpecPath
+
+if ($null -eq $componentMap) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/design/component-map.md" -Section "file" -Message "缺少 component-map 模板，无法承载第六章公共组件复用盘点。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $componentMap -Terms @("复用与新增规则", "组件复用决策", "existing / new / generated", "两个真实使用场景", "公共组件改动影响面"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/design/component-map.md" -Section "reuse-rules" -Message "component-map 模板缺少复用规则、复用决策、existing/new 来源、双场景约束或公共组件改动影响面。"
+  }
+}
+
+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 @("## 11. 复用决策", "第二个真实使用场景", "业务组件默认留在 feature 内", "受影响调用方", "兼容策略"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/design/frontend-architecture.md" -Section "reuse-decision" -Message "frontend-architecture 模板缺少第六章要求的复用决策、抽象阈值或公共组件兼容约束。"
+  }
+}
+
+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 @("## 5. 组件复用边界", "新通用组件必须至少有两个明确使用场景", "generated types 可以作为数据输入类型", "修改 existing 公共组件时，必须列出受影响调用方", "wrapper、variant、slot、可选 props"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/frontend-quality-rules.md" -Section "shared-component-guard" -Message "frontend-quality-rules 模板缺少复用边界、双场景门槛、generated types 限制或公共组件变更保护规则。"
+  }
+}
+
+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 @("类似组件", "复用决定", "不复用理由", "如果修改公共组件，组件名称", "如果修改公共组件，受影响页面 / 模块", "如果修改公共组件，props 兼容性影响"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "reuse-fields" -Message "CURRENT_TASK 模板缺少类似组件搜索、复用决策或公共组件改动影响面字段。"
+  }
+}
+
+if ($null -eq $imageSpec) {
+  $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/design/image-to-frontend-spec.md" -Section "file" -Message "缺少 image-to-frontend-spec 模板，前端组件复用映射链路不完整。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $imageSpec -Terms @("复用来源", "page / feature / primitive", "每个组件都声明了 page / feature / primitive 层级和复用边界", "如果 `复用来源 = existing`"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/design/image-to-frontend-spec.md" -Section "component-mapping" -Message "image-to-frontend-spec 模板还没有完整约束 existing 组件的复用映射和兼容策略。"
+  }
+}
+
+$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 "Component lint passed."
+  exit 0
+}
+
+if ($errors.Count -gt 0) {
+  Write-Output "Component 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 "Component 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/config-lint.ps1

@@ -0,0 +1,159 @@
+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 = @()
+
+$envExamplePath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\config\env.example"
+$envCheckPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\config\env-check.ps1"
+$envTemplatePath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\env-and-deployment-template.md"
+$newProjectUsagePath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\new-project-usage.md"
+$codexReadmePath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\config\codex-readme.md"
+$currentTaskPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\context\CURRENT_TASK.md"
+
+$envExample = Get-FileContentOrNull -Path $envExamplePath
+$envCheck = Get-FileContentOrNull -Path $envCheckPath
+$envTemplate = Get-FileContentOrNull -Path $envTemplatePath
+$newProjectUsage = Get-FileContentOrNull -Path $newProjectUsagePath
+$codexReadme = Get-FileContentOrNull -Path $codexReadmePath
+$currentTask = Get-FileContentOrNull -Path $currentTaskPath
+
+if ($null -eq $envExample) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/config/env.example" -Section "file" -Message "缺少 env.example 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $envExample -Terms @("OPENAI_API_KEY", "DATABASE_URL", "APP_BASE_URL"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/config/env.example" -Section "variables" -Message "env.example 模板缺少第16章要求的基础变量入口样例。"
+  }
+}
+
+if ($null -eq $envCheck) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/config/env-check.ps1" -Section "file" -Message "缺少 env-check 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $envCheck -Terms @("RequiredCommands", "RequiredEnvVars", "Environment check passed.", "变量用途、环境差异、部署注入方式和回滚策略应记录"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/config/env-check.ps1" -Section "env-check-shape" -Message "env-check 模板缺少第16章要求的命令/变量检查或文档桥接说明。"
+  }
+}
+
+if ($null -eq $envTemplate) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/env-and-deployment-template.md" -Section "file" -Message "缺少环境变量与部署模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $envTemplate -Terms @("环境变量清单", "构建与运行命令", "CI / CD 入口", "健康检查与发布约束", "配置变更前必须说明"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/env-and-deployment-template.md" -Section "env-deploy-sections" -Message "环境与部署模板缺少第16章要求的变量、构建、CI/CD、健康检查或回滚章节。"
+  }
+}
+
+if ($null -eq $newProjectUsage) {
+  $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/docs/new-project-usage.md" -Section "file" -Message "缺少新项目使用指南模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $newProjectUsage -Terms @("env-check.ps1", "doctor.ps1", "install-user.ps1", "init-project.ps1"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/docs/new-project-usage.md" -Section "setup-commands" -Message "新项目使用指南还没有完整承接第16章的环境/检查入口。"
+  }
+}
+
+if ($null -eq $codexReadme) {
+  $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/config/codex-readme.md" -Section "file" -Message "缺少 Codex 控制面说明。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $codexReadme -Terms @("config.toml", "hooks.json", "task-run-profile.json"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/config/codex-readme.md" -Section "config-surface" -Message "Codex 控制面说明还没有完整覆盖配置面。"
+  }
+}
+
+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 @("必需环境变量 / Secret", "受影响配置文件", "构建 / 部署影响", "回滚配置策略"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "config-fields" -Message "CURRENT_TASK 模板缺少第16章要求的配置/环境决策字段。"
+  }
+}
+
+$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 "Config lint passed."
+  exit 0
+}
+
+if ($errors.Count -gt 0) {
+  Write-Output "Config 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 "Config lint passed with warnings."
+  }
+  foreach ($issue in $warnings) {
+    Write-Output ("- [WARNING] {0} :: {1} :: {2}" -f $issue.file, $issue.section, $issue.message)
+  }
+}
+
+exit $exitCode