@pzy560117/codex-harness 0.1.2 → 0.1.4

package/package-source/docs/codex-harness-engineering/templates/tools/harness/state-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 = @()
+
+$frontendArchitecturePath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\design\frontend-architecture.md"
+$verifyMatrixPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\testing\verify-matrix.md"
+$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"
+
+$frontendArchitecture = Get-FileContentOrNull -Path $frontendArchitecturePath
+$verifyMatrix = Get-FileContentOrNull -Path $verifyMatrixPath
+$evidenceProtocol = Get-FileContentOrNull -Path $evidenceProtocolPath
+$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 @("## 5. 状态管理", "可分享、可回退、影响查询结果的状态优先进入 URL", "同一业务条件只能有一个主状态来源", "## 5.1 缓存与失效策略", "写操作完成后，必须明确哪些列表、详情、统计或徽标需要失效或同步更新"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/design/frontend-architecture.md" -Section "state-governance" -Message "frontend-architecture 模板缺少第九章要求的状态分层、状态唯一来源或缓存失效策略。"
+  }
+}
+
+if ($null -eq $verifyMatrix) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/verify-matrix.md" -Section "file" -Message "缺少验证矩阵模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $verifyMatrix -Terms @("状态唯一来源检查", "缓存失效检查"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/testing/verify-matrix.md" -Section "state-checks" -Message "验证矩阵模板还没有显式列出状态唯一来源或缓存失效检查。"
+  }
+}
+
+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 @("cache_observation", "state_source_snapshot"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/testing/EVIDENCE_PROTOCOL.md" -Section "state-evidence" -Message "证据协议模板还没有把状态来源和缓存观察作为独立证据类型。"
+  }
+}
+
+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 "warning" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "state-fields" -Message "CURRENT_TASK 模板缺少状态分层、禁止重复存放或缓存失效决策字段。"
+  }
+}
+
+$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 "State lint passed."
+  exit 0
+}
+
+if ($errors.Count -gt 0) {
+  Write-Output "State 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 "State 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/style-lint.ps1

@@ -0,0 +1,155 @@
+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
+}
+
+function Test-ContainsAny {
+  param(
+    [string]$Content,
+    [string[]]$Terms
+  )
+
+  foreach ($term in $Terms) {
+    if ($Content -match [regex]::Escape($term)) {
+      return $true
+    }
+  }
+
+  return $false
+}
+
+$issues = @()
+
+$styleDocPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\code-style-and-naming.md"
+$currentTaskPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\context\CURRENT_TASK.md"
+$projectAgentsTemplatePath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\project-agents-template.md"
+$codingStyleRulesPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\config\rules\coding-style.md"
+
+$styleDoc = Get-FileContentOrNull -Path $styleDocPath
+$currentTask = Get-FileContentOrNull -Path $currentTaskPath
+$projectAgentsTemplate = Get-FileContentOrNull -Path $projectAgentsTemplatePath
+$codingStyleRules = Get-FileContentOrNull -Path $codingStyleRulesPath
+
+if ($null -eq $styleDoc) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/code-style-and-naming.md" -Section "file" -Message "缺少代码风格与命名模板，无法承载第五章规则。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $styleDoc -Terms @("业务词典", "文件命名规则", "函数命名规则", "类型命名边界", "新增命名前必须确认"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/code-style-and-naming.md" -Section "core-sections" -Message "代码风格模板缺少业务词典、文件命名规则、函数命名规则、类型命名边界或命名前确认项。"
+  }
+  if (-not (Test-ContainsAny -Content $styleDoc -Terms @("doAction", "processData", "dealData", "getInfo", "check"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/docs/code-style-and-naming.md" -Section "bad-examples" -Message "代码风格模板还没有列出典型的模糊命名反例。"
+  }
+}
+
+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 "warning" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "style-fields" -Message "CURRENT_TASK 模板缺少业务词典、同义词禁用、文件命名模式或类型边界记录项。"
+  }
+}
+
+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-ContainsAny -Content $projectAgentsTemplate -Terms @("code-style-and-naming", "docs/code-style.md", "命名"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/docs/project-agents-template.md" -Section "naming-index" -Message "project AGENTS 模板还没有把命名规范文档纳入入口索引。"
+  }
+}
+
+if ($null -eq $codingStyleRules) {
+  $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/config/rules/coding-style.md" -Section "file" -Message "缺少 always-on coding-style 规则文件。"
+}
+else {
+  if (-not (Test-ContainsAny -Content $codingStyleRules -Terms @("业务词典", "命名", "code-style-and-naming"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/config/rules/coding-style.md" -Section "naming-bridge" -Message "always-on coding-style 规则还没有把项目级命名约束桥接到详细文档。"
+  }
+}
+
+$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 "Style lint passed."
+  exit 0
+}
+
+if ($errors.Count -gt 0) {
+  Write-Output "Style 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 "Style 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/testing-lint.ps1

@@ -0,0 +1,192 @@
+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 = @()
+
+$acceptanceCriteriaPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\testing\ACCEPTANCE_CRITERIA.md"
+$acceptanceExamplesPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\testing\ACCEPTANCE_EXAMPLES.md"
+$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"
+$verifyMatrixPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\testing\verify-matrix.md"
+$failureTriagePath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\testing\failure-triage.md"
+$regressionPlanPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\testing\REGRESSION_PLAN.md"
+$currentTaskPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\context\CURRENT_TASK.md"
+
+$acceptanceCriteria = Get-FileContentOrNull -Path $acceptanceCriteriaPath
+$acceptanceExamples = Get-FileContentOrNull -Path $acceptanceExamplesPath
+$traceability = Get-FileContentOrNull -Path $traceabilityPath
+$testStrategy = Get-FileContentOrNull -Path $testStrategyPath
+$nlCases = Get-FileContentOrNull -Path $nlCasesPath
+$verifyMatrix = Get-FileContentOrNull -Path $verifyMatrixPath
+$failureTriage = Get-FileContentOrNull -Path $failureTriagePath
+$regressionPlan = Get-FileContentOrNull -Path $regressionPlanPath
+$currentTask = Get-FileContentOrNull -Path $currentTaskPath
+
+if ($null -eq $acceptanceCriteria) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/ACCEPTANCE_CRITERIA.md" -Section "file" -Message "缺少验收标准模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $acceptanceCriteria -Terms @("Requirement ID", "可观察的成功结果和失败结果", "负向 / 异常条件", "测试层级"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/ACCEPTANCE_CRITERIA.md" -Section "acceptance-shape" -Message "验收标准模板缺少第13章要求的可观察成功/失败结果或测试层级。"
+  }
+}
+
+if ($null -eq $acceptanceExamples) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/ACCEPTANCE_EXAMPLES.md" -Section "file" -Message "缺少验收示例模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $acceptanceExamples -Terms @("正向示例", "负向示例", "证据目标"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/ACCEPTANCE_EXAMPLES.md" -Section "acceptance-examples" -Message "验收示例模板缺少第13章要求的正向、负向示例或证据目标。"
+  }
+}
+
+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 或证据路径的 P0/P1 行不能进入实现"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/TRACEABILITY_MATRIX.md" -Section "traceability-rules" -Message "追溯矩阵模板缺少第13章要求的需求到测试和证据约束。"
+  }
+}
+
+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 @("开发验证与验收验证分层", "TDD RED", "TDD GREEN / REFACTOR", "假测试拦截规则", "只断言 `200`、`truthy`", "只跑 happy path"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/TEST_STRATEGY.md" -Section "testing-policy" -Message "测试策略模板缺少第13章要求的 TDD、开发/验收验证分层或假测试拦截规则。"
+  }
+}
+
+if ($null -eq $nlCases) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/NATURAL_LANGUAGE_TEST_CASES.md" -Section "file" -Message "缺少自然语言测试用例模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $nlCases -Terms @("P0 需求默认不少于 5 条", "P1 需求默认不少于 3 条", "TDD 候选", "不得只写一条端到端 happy path"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/NATURAL_LANGUAGE_TEST_CASES.md" -Section "nl-cases" -Message "自然语言测试用例模板缺少第13章要求的用例规模、TDD 候选或 happy path 约束。"
+  }
+}
+
+if ($null -eq $verifyMatrix) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/verify-matrix.md" -Section "file" -Message "缺少验证矩阵模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $verifyMatrix -Terms @("开发验证", "用户验收链路", "失败态验收", "假测试检测", "发布候选验证"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/testing/verify-matrix.md" -Section "verify-gates" -Message "验证矩阵模板缺少第13章要求的开发验证、验收验证、失败态或假测试检查。"
+  }
+}
+
+if ($null -eq $failureTriage) {
+  $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/testing/failure-triage.md" -Section "file" -Message "缺少 failure-triage 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $failureTriage -Terms @("TEST_CODE_ISSUE", "PRODUCT_BUG", "REQUIREMENT_CHANGE", "ENV_OR_DATA_ISSUE", "FLAKY", "弱化断言掩盖产品问题"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/testing/failure-triage.md" -Section "triage-policy" -Message "failure-triage 模板缺少第13章要求的失败分类或禁止弱化断言规则。"
+  }
+}
+
+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 @("受影响测试", "P0 回归集合", "发布证据"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/testing/REGRESSION_PLAN.md" -Section "regression-shape" -Message "回归计划模板缺少第13章要求的受影响测试、P0 回归或发布证据字段。"
+  }
+}
+
+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 @("本轮 development_validation", "本轮 acceptance_validation", "未运行测试 / 豁免及原因", "假测试风险提示"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "testing-fields" -Message "CURRENT_TASK 模板缺少第13章要求的开发验证、验收验证或未运行测试记录字段。"
+  }
+}
+
+$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 "Testing lint passed."
+  exit 0
+}
+
+if ($errors.Count -gt 0) {
+  Write-Output "Testing 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 "Testing 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/ui-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 = @()
+
+$frontendQualityPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\frontend-quality-rules.md"
+$screenStatesPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\design\screen-states.md"
+$designBriefPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\design\design-brief.md"
+$imageSpecPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\design\image-to-frontend-spec.md"
+$currentTaskPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\context\CURRENT_TASK.md"
+
+$frontendQuality = Get-FileContentOrNull -Path $frontendQualityPath
+$screenStates = Get-FileContentOrNull -Path $screenStatesPath
+$designBrief = Get-FileContentOrNull -Path $designBriefPath
+$imageSpec = Get-FileContentOrNull -Path $imageSpecPath
+$currentTask = Get-FileContentOrNull -Path $currentTaskPath
+
+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 @("设计系统", "移动端和嵌入式 WebView 额外约束", "安全区策略", "键盘弹起后", "表单体验至少补充", "submitting", "retry", "offline"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/frontend-quality-rules.md" -Section "ui-quality-rules" -Message "frontend-quality-rules 模板缺少第10章要求的设计系统、移动端安全区、表单体验或补充交互状态约束。"
+  }
+}
+
+if ($null -eq $screenStates) {
+  $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/design/screen-states.md" -Section "file" -Message "缺少 screen-states 模板。"
+}
+else {
+  if (-not (Test-ContainsAll -Content $screenStates -Terms @("### submitting", "### retry", "### offline", "安全区策略", "键盘遮挡处理"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/design/screen-states.md" -Section "state-coverage" -Message "screen-states 模板缺少第10章要求的 submitting/retry/offline 或移动端安全区状态。"
+  }
+}
+
+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 @("submitting", "retry", "offline", "必须说明安全区、键盘弹起", "安全区 / 键盘遮挡策略"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/design/design-brief.md" -Section "mobile-form-rules" -Message "design-brief 模板还没有完整承接第10章的移动端安全区或表单提交体验。"
+  }
+}
+
+if ($null -eq $imageSpec) {
+  $issues += New-Issue -Severity "error" -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 @("| disabled |", "| submitting |", "| retry |", "| offline |", "## 5.3 表单与安全区规格", "安全区 / 键盘遮挡处理"))) {
+    $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/design/image-to-frontend-spec.md" -Section "interaction-spec" -Message "image-to-frontend-spec 模板缺少第10章要求的状态、表单或安全区实现规格。"
+  }
+}
+
+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 @("设计系统 / token 约束", "移动端安全区 / 键盘遮挡处理", "表单校验与提交流程策略"))) {
+    $issues += New-Issue -Severity "warning" -File "docs/codex-harness-engineering/templates/context/CURRENT_TASK.md" -Section "ui-fields" -Message "CURRENT_TASK 模板缺少设计系统、移动端安全区或表单提交流程决策字段。"
+  }
+}
+
+$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 "UI lint passed."
+  exit 0
+}
+
+if ($errors.Count -gt 0) {
+  Write-Output "UI 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 "UI 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/trace/AGENTS.md

@@ -0,0 +1,16 @@
+# AGENTS.md
+
+## 目录作用
+
+- 存放 trace schema、trace 示例和 eval case 示例。
+
+## 结构索引
+
+- `trace.schema.json`：trace 结构约束。
+- `trace.json`：trace 示例。
+- `eval-case.yaml`：评估样例。
+
+## 修改规则
+
+- trace 字段一旦改动，要同步检查 `docs/trace-format.md`、driver trace 输出和相关验证逻辑。
+- 这里只放 schema 和样例，不放项目特有 trace 产物。