@pzy560117/codex-harness 0.1.3 → 0.1.5

package/package-source/tools/install/ai-workflow/sync-targets.example.json

@@ -1,35 +1,35 @@
-{
-  "source": {
-    "repo": "your-org/ai-workflow-kit",
-    "ref": "main"
-  },
-  "defaults": {
-    "baseBranch": "main",
-    "branchPrefix": "chore/ai-kit-sync",
-    "pushBranch": true,
-    "createPullRequest": true,
-    "draftPullRequest": false,
-    "commitMessage": "chore(ai-kit): sync shared AI workflow config",
-    "prTitle": "chore(ai-kit): sync shared AI workflow config from {{sourceRef}}",
-    "prBody": "## AI Workflow Kit Sync`n`nSource: {{sourceRepo}}@{{sourceRef}}`nCommit: {{sourceCommit}}`n`nChanged files:`n{{changedFiles}}`n",
-    "labels": [
-      "ai-kit-sync",
-      "automation"
-    ],
-    "verifyCommands": [
-      "powershell -NoProfile -ExecutionPolicy Bypass -File .\\scripts\\ai-workflow\\check-ai-sync-drift.ps1"
-    ]
-  },
-  "targets": [
-    {
-      "repo": "your-org/project-a",
-      "baseBranch": "main",
-      "syncConfigPath": ".ai-sync.yml"
-    },
-    {
-      "repo": "your-org/project-b",
-      "baseBranch": "main",
-      "syncConfigPath": ".ai-sync.yml"
-    }
-  ]
-}
+{
+  "source": {
+    "repo": "your-org/ai-workflow-kit",
+    "ref": "main"
+  },
+  "defaults": {
+    "baseBranch": "main",
+    "branchPrefix": "chore/ai-kit-sync",
+    "pushBranch": true,
+    "createPullRequest": true,
+    "draftPullRequest": false,
+    "commitMessage": "chore(ai-kit): sync shared AI workflow config",
+    "prTitle": "chore(ai-kit): sync shared AI workflow config from {{sourceRef}}",
+    "prBody": "## AI Workflow Kit Sync`n`nSource: {{sourceRepo}}@{{sourceRef}}`nCommit: {{sourceCommit}}`n`nChanged files:`n{{changedFiles}}`n",
+    "labels": [
+      "ai-kit-sync",
+      "automation"
+    ],
+    "verifyCommands": [
+      "powershell -NoProfile -ExecutionPolicy Bypass -File .\\scripts\\ai-workflow\\check-ai-sync-drift.ps1"
+    ]
+  },
+  "targets": [
+    {
+      "repo": "your-org/project-a",
+      "baseBranch": "main",
+      "syncConfigPath": ".ai-sync.yml"
+    },
+    {
+      "repo": "your-org/project-b",
+      "baseBranch": "main",
+      "syncConfigPath": ".ai-sync.yml"
+    }
+  ]
+}

package/package-source/tools/install/bootstrap-codex-harness.ps1

@@ -13,13 +13,13 @@ param(
 Set-StrictMode -Version Latest
 $ErrorActionPreference = "Stop"
 
-function Get-PackageRoot {
-  return [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot "..\.."))
-}
-
-if ([string]::IsNullOrWhiteSpace($ProjectRoot)) {
-  $ProjectRoot = Get-PackageRoot
-}
+function Get-PackageRoot {
+  return [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot "..\.."))
+}
+
+if ([string]::IsNullOrWhiteSpace($ProjectRoot)) {
+  $ProjectRoot = Get-PackageRoot
+}
 
 function Resolve-TemplateRoot {
   <#
@@ -36,9 +36,9 @@ function Resolve-TemplateRoot {
   }
 
   $candidates += @(
-    (Join-Path (Get-PackageRoot) "docs\codex-harness-engineering\templates"),
-    (Join-Path (Get-PackageRoot) ".agents\docs\codex-harness-engineering\templates"),
-    (Get-PackageRoot),
+    (Join-Path (Get-PackageRoot) "docs\codex-harness-engineering\templates"),
+    (Join-Path (Get-PackageRoot) ".agents\docs\codex-harness-engineering\templates"),
+    (Get-PackageRoot),
     (Join-Path $ProjectPath "docs\codex-harness-engineering\templates"),
     (Join-Path $ProjectPath ".agents\docs\codex-harness-engineering\templates")
   )
@@ -66,7 +66,7 @@ function Resolve-TemplateRoot {
   throw "找不到可用模板目录。请显式传入 -TemplateRoot。"
 }
 
-function Copy-ManagedFile {
+function Copy-ManagedFile {
   <#
     复制单个模板文件，默认只补齐缺失文件。
   #>
@@ -97,62 +97,62 @@ function Copy-ManagedFile {
   }
 
   Copy-Item -LiteralPath $sourcePath -Destination $destinationPath -Force
-  return [PSCustomObject]@{
-    Path = $destinationPath
-    Action = "copied"
-  }
-}
-
-function Copy-ManagedDirectory {
-  param(
-    [string]$SourceDirectory,
-    [string]$DestinationDirectory,
-    [bool]$Overwrite
-  )
-
-  if (-not (Test-Path -LiteralPath $SourceDirectory)) {
-    throw "模板目录不存在: $SourceDirectory"
-  }
-
-  if (Test-Path -LiteralPath $DestinationDirectory) {
-    if (-not $Overwrite) {
-      return [PSCustomObject]@{
-        Path = $DestinationDirectory
-        Action = "kept"
-      }
-    }
-
-    Remove-Item -LiteralPath $DestinationDirectory -Recurse -Force
-  }
-
-  New-Item -ItemType Directory -Force -Path $DestinationDirectory | Out-Null
-  $robocopyArgs = @(
-    $SourceDirectory,
-    $DestinationDirectory,
-    "/E",
-    "/COPY:DAT",
-    "/DCOPY:DAT",
-    "/R:2",
-    "/W:1",
-    "/NFL",
-    "/NDL",
-    "/NJH",
-    "/NJS",
-    "/NP"
-  )
-
-  & robocopy @robocopyArgs | Out-Null
-  $robocopyExitCode = $LASTEXITCODE
-  if ($robocopyExitCode -ge 8) {
-    throw "复制模板目录失败: $SourceDirectory -> $DestinationDirectory (robocopy exit $robocopyExitCode)"
-  }
-
-  $global:LASTEXITCODE = 0
-  return [PSCustomObject]@{
-    Path = $DestinationDirectory
-    Action = "copied"
-  }
-}
+  return [PSCustomObject]@{
+    Path = $destinationPath
+    Action = "copied"
+  }
+}
+
+function Copy-ManagedDirectory {
+  param(
+    [string]$SourceDirectory,
+    [string]$DestinationDirectory,
+    [bool]$Overwrite
+  )
+
+  if (-not (Test-Path -LiteralPath $SourceDirectory)) {
+    throw "模板目录不存在: $SourceDirectory"
+  }
+
+  if (Test-Path -LiteralPath $DestinationDirectory) {
+    if (-not $Overwrite) {
+      return [PSCustomObject]@{
+        Path = $DestinationDirectory
+        Action = "kept"
+      }
+    }
+
+    Remove-Item -LiteralPath $DestinationDirectory -Recurse -Force
+  }
+
+  New-Item -ItemType Directory -Force -Path $DestinationDirectory | Out-Null
+  $robocopyArgs = @(
+    $SourceDirectory,
+    $DestinationDirectory,
+    "/E",
+    "/COPY:DAT",
+    "/DCOPY:DAT",
+    "/R:2",
+    "/W:1",
+    "/NFL",
+    "/NDL",
+    "/NJH",
+    "/NJS",
+    "/NP"
+  )
+
+  & robocopy @robocopyArgs | Out-Null
+  $robocopyExitCode = $LASTEXITCODE
+  if ($robocopyExitCode -ge 8) {
+    throw "复制模板目录失败: $SourceDirectory -> $DestinationDirectory (robocopy exit $robocopyExitCode)"
+  }
+
+  $global:LASTEXITCODE = 0
+  return [PSCustomObject]@{
+    Path = $DestinationDirectory
+    Action = "copied"
+  }
+}
 
 function Sync-TemplateCodexAgents {
   param(
@@ -231,7 +231,7 @@ function Ensure-TaskFile {
   }
 
   if ([string]::IsNullOrWhiteSpace($taskDocument.runtime.driver)) {
-    $taskDocument.runtime.driver = "powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\harness\codex-loop.ps1"
+    $taskDocument.runtime.driver = "powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\harness\codex-loop.ps1"
     $taskDocument | ConvertTo-Json -Depth 8 | Set-Content -LiteralPath $taskPath -Encoding UTF8
     return [PSCustomObject]@{
       Path = $taskPath
@@ -293,25 +293,25 @@ function Resolve-LockManifestSourcePath {
   return Join-Path $PackageRoot ($normalizedSource.Replace('/', '\'))
 }
 
-function Get-FileSha256 {
-  param([string]$Path)
-
-  $hashAlgorithm = [System.Security.Cryptography.SHA256]::Create()
-  try {
-    $stream = [System.IO.File]::OpenRead($Path)
-    try {
-      $hashBytes = $hashAlgorithm.ComputeHash($stream)
-    }
-    finally {
-      $stream.Dispose()
-    }
-  }
-  finally {
-    $hashAlgorithm.Dispose()
-  }
-
-  return ([System.BitConverter]::ToString($hashBytes)).Replace('-', '').ToLowerInvariant()
-}
+function Get-FileSha256 {
+  param([string]$Path)
+
+  $hashAlgorithm = [System.Security.Cryptography.SHA256]::Create()
+  try {
+    $stream = [System.IO.File]::OpenRead($Path)
+    try {
+      $hashBytes = $hashAlgorithm.ComputeHash($stream)
+    }
+    finally {
+      $stream.Dispose()
+    }
+  }
+  finally {
+    $hashAlgorithm.Dispose()
+  }
+
+  return ([System.BitConverter]::ToString($hashBytes)).Replace('-', '').ToLowerInvariant()
+}
 
 function Add-LockManagedFile {
   param(
@@ -374,7 +374,7 @@ function Get-LockManagedFiles {
       continue
     }
 
-    if ($kind -eq "generated-lock" -or $destination -eq ".codex-harness/locks/package.lock.json") {
+    if ($kind -eq "generated-lock" -or $destination -eq ".codex-harness/locks/package.lock.json") {
       continue
     }
 
@@ -467,7 +467,7 @@ function Write-PackageLock {
     }
   }
 
-  $lockDirectory = Join-Path $ProjectPath ".codex-harness\locks"
+  $lockDirectory = Join-Path $ProjectPath ".codex-harness\locks"
   if (-not (Test-Path -LiteralPath $lockDirectory -PathType Container)) {
     New-Item -ItemType Directory -Force -Path $lockDirectory | Out-Null
   }
@@ -520,7 +520,7 @@ function Write-HarnessConfig {
     }
   }
 
-  $configDirectory = Join-Path $ProjectPath ".codex-harness\state"
+  $configDirectory = Join-Path $ProjectPath ".codex-harness\state"
   if (-not (Test-Path -LiteralPath $configDirectory -PathType Container)) {
     New-Item -ItemType Directory -Force -Path $configDirectory | Out-Null
   }
@@ -551,12 +551,12 @@ function Write-InstallManifestSnapshot {
   $installManifestPath = Join-Path $packageRoot "install-manifest.json"
   if (-not (Test-Path -LiteralPath $installManifestPath -PathType Leaf)) {
     return [PSCustomObject]@{
-      Path = (Join-Path $ProjectPath ".codex-harness\manifests\install-manifest.json")
+      Path = (Join-Path $ProjectPath ".codex-harness\manifests\install-manifest.json")
       Action = "missing-source"
     }
   }
 
-  $snapshotDirectory = Join-Path $ProjectPath ".codex-harness\manifests"
+  $snapshotDirectory = Join-Path $ProjectPath ".codex-harness\manifests"
   if (-not (Test-Path -LiteralPath $snapshotDirectory -PathType Container)) {
     New-Item -ItemType Directory -Force -Path $snapshotDirectory | Out-Null
   }
@@ -574,15 +574,16 @@ $resolvedTemplateRoot = Resolve-TemplateRoot -ProjectPath $resolvedProjectRoot -
 $results = @()
 
 $rootFiles = @(
-  @{ Source = "runtime\AGENTS.md"; Destination = "AGENTS.md" },
-  @{ Source = "bootstrap-codex-harness.ps1"; Destination = "tools\install\bootstrap-codex-harness.ps1" },
-  @{ Source = "runtime\codex-loop.ps1"; Destination = "tools\harness\codex-loop.ps1" },
-  @{ Source = "runtime\doctor.ps1"; Destination = "tools\harness\doctor.ps1" },
+  @{ Source = "runtime\AGENTS.md"; Destination = "AGENTS.md" },
+  @{ Source = "bootstrap-codex-harness.ps1"; Destination = "tools\install\bootstrap-codex-harness.ps1" },
+  @{ Source = "runtime\codex-loop.ps1"; Destination = "tools\harness\codex-loop.ps1" },
+  @{ Source = "runtime\doctor.ps1"; Destination = "tools\harness\doctor.ps1" },
   @{ Source = "config\codex-config.toml"; Destination = ".codex\config.toml" },
   @{ Source = "config\codex-readme.md"; Destination = ".codex\README.md" },
-  @{ Source = "hooks\hooks.json"; Destination = ".codex\hooks.json" },
-  @{ Source = "hooks\hook-stop-verify.ps1"; Destination = "tools\harness\hook-stop-verify.ps1" },
-  @{ Source = "scripts\ai-workflow\check-ai-sync-drift.ps1"; Destination = "tools\install\ai-workflow\check-ai-sync-drift.ps1" },
+  @{ Source = "hooks\hooks.json"; Destination = ".codex\hooks.json" },
+  @{ Source = "hooks\hook-stop-verify.ps1"; Destination = "tools\harness\hook-stop-verify.ps1" },
+  @{ Source = "scripts\harness\harness-governance-check.ps1"; Destination = "scripts\harness\harness-governance-check.ps1" },
+  @{ Source = "scripts\ai-workflow\check-ai-sync-drift.ps1"; Destination = "tools\install\ai-workflow\check-ai-sync-drift.ps1" },
   @{ Source = "runtime\task-run-profile.json"; Destination = ".codex\task-run-profile.json" },
   @{ Source = "prompts\implement-one-task.md"; Destination = ".codex\prompts\implement-one-task.md" },
   @{ Source = "prompts\controller-loop.md"; Destination = ".codex\prompts\controller-loop.md" },
@@ -598,34 +599,40 @@ $rootFiles = @(
   @{ Source = "prompts\worker-role\test-runner.md"; Destination = ".codex\prompts\worker-role\test-runner.md" },
   @{ Source = "prompts\worker-role\docs-worker.md"; Destination = ".codex\prompts\worker-role\docs-worker.md" },
   @{ Source = "prompts\worker-role\harness-writer.md"; Destination = ".codex\prompts\worker-role\harness-writer.md" },
-  @{ Source = "runtime\smoke-task.json"; Destination = "tools\harness\templates\smoke-task.json" },
-  @{ Source = "runtime\project-task-template.json"; Destination = "tools\harness\templates\project-task-template.json" },
-  @{ Source = "runtime\verify.ps1"; Destination = "tools\harness\verify.ps1" },
-  @{ Source = "config\env-check.ps1"; Destination = "tools\install\env-check.ps1" },
-  @{ Source = "trace\trace.schema.json"; Destination = "docs\harness\trace.schema.json" }
+  @{ Source = "runtime\smoke-task.json"; Destination = "tools\harness\templates\smoke-task.json" },
+  @{ Source = "runtime\project-task-template.json"; Destination = "tools\harness\templates\project-task-template.json" },
+  @{ Source = "runtime\verify.ps1"; Destination = "tools\harness\verify.ps1" },
+  @{ Source = "tools\harness\docs-lint.ps1"; Destination = "tools\harness\docs-lint.ps1" },
+  @{ Source = "tools\harness\data-lint.ps1"; Destination = "tools\harness\data-lint.ps1" },
+  @{ Source = "tools\harness\integration-lint.ps1"; Destination = "tools\harness\integration-lint.ps1" },
+  @{ Source = "tools\harness\mobile-lint.ps1"; Destination = "tools\harness\mobile-lint.ps1" },
+  @{ Source = "tools\harness\acceptance-lint.ps1"; Destination = "tools\harness\acceptance-lint.ps1" },
+  @{ Source = "tools\harness\session-lint.ps1"; Destination = "tools\harness\session-lint.ps1" },
+  @{ Source = "config\env-check.ps1"; Destination = "tools\install\env-check.ps1" },
+  @{ Source = "trace\trace.schema.json"; Destination = "docs\harness\trace.schema.json" }
 )
 
 foreach ($file in $rootFiles) {
   $results += Copy-ManagedFile -SourceRoot $resolvedTemplateRoot -SourceRelativePath $file.Source -DestinationRoot $resolvedProjectRoot -DestinationRelativePath $file.Destination -Overwrite:$Force.IsPresent
 }
 
-$results += Sync-TemplateCodexAgents -TemplateRoot $resolvedTemplateRoot -ProjectPath $resolvedProjectRoot -Overwrite:$Force.IsPresent
-$results += Sync-TemplateCodexRules -TemplateRoot $resolvedTemplateRoot -ProjectPath $resolvedProjectRoot -Overwrite:$Force.IsPresent
-
-$packageAssetsRoot = Join-Path $resolvedTemplateRoot "package-assets"
-if (Test-Path -LiteralPath $packageAssetsRoot) {
-  $results += Copy-ManagedDirectory `
-    -SourceDirectory (Join-Path $packageAssetsRoot "skills") `
-    -DestinationDirectory (Join-Path $resolvedProjectRoot ".agents\skills") `
-    -Overwrite:$Force.IsPresent
-
-  $results += Copy-ManagedDirectory `
-    -SourceDirectory (Join-Path $packageAssetsRoot "workflows") `
-    -DestinationDirectory (Join-Path $resolvedProjectRoot ".agents\workflows") `
-    -Overwrite:$Force.IsPresent
-}
-
-$results += Ensure-TaskFile -SourceRoot $resolvedTemplateRoot -DestinationRoot $resolvedProjectRoot
+$results += Sync-TemplateCodexAgents -TemplateRoot $resolvedTemplateRoot -ProjectPath $resolvedProjectRoot -Overwrite:$Force.IsPresent
+$results += Sync-TemplateCodexRules -TemplateRoot $resolvedTemplateRoot -ProjectPath $resolvedProjectRoot -Overwrite:$Force.IsPresent
+
+$packageAssetsRoot = Join-Path $resolvedTemplateRoot "package-assets"
+if (Test-Path -LiteralPath $packageAssetsRoot) {
+  $results += Copy-ManagedDirectory `
+    -SourceDirectory (Join-Path $packageAssetsRoot "skills") `
+    -DestinationDirectory (Join-Path $resolvedProjectRoot ".agents\skills") `
+    -Overwrite:$Force.IsPresent
+
+  $results += Copy-ManagedDirectory `
+    -SourceDirectory (Join-Path $packageAssetsRoot "workflows") `
+    -DestinationDirectory (Join-Path $resolvedProjectRoot ".agents\workflows") `
+    -Overwrite:$Force.IsPresent
+}
+
+$results += Ensure-TaskFile -SourceRoot $resolvedTemplateRoot -DestinationRoot $resolvedProjectRoot
 
 $progressPath = Join-Path $resolvedProjectRoot "progress.txt"
 if (-not (Test-Path -LiteralPath $progressPath)) {
@@ -638,10 +645,17 @@ else {
   }
 }
 
-$contextFiles = @(
-  @{ Source = "context\repo-map.md"; Destination = "docs\ai\repo-map.md" },
-  @{ Source = "context\architecture-brief.md"; Destination = "docs\ai\architecture-brief.md" }
-)
+$contextFiles = @(
+  @{ Source = "context\repo-map.md"; Destination = "docs\ai\repo-map.md" },
+  @{ Source = "context\architecture-brief.md"; Destination = "docs\ai\architecture-brief.md" },
+  @{ Source = "context\CURRENT_TASK.md"; Destination = "docs\ai\CURRENT_TASK.md" },
+  @{ Source = "context\PROJECT_CONTEXT.md"; Destination = "docs\ai\PROJECT_CONTEXT.md" },
+  @{ Source = "context\DECISIONS.md"; Destination = "docs\ai\DECISIONS.md" },
+  @{ Source = "context\API_MAP.md"; Destination = "docs\ai\API_MAP.md" },
+  @{ Source = "context\DB_SCHEMA.md"; Destination = "docs\ai\DB_SCHEMA.md" },
+  @{ Source = "context\KNOWN_ISSUES.md"; Destination = "docs\ai\KNOWN_ISSUES.md" },
+  @{ Source = "context\CHANGELOG_AI.md"; Destination = "docs\ai\CHANGELOG_AI.md" }
+)
 
 foreach ($file in $contextFiles) {
   $results += Copy-ManagedFile -SourceRoot $resolvedTemplateRoot -SourceRelativePath $file.Source -DestinationRoot $resolvedProjectRoot -DestinationRelativePath $file.Destination -Overwrite:$Force.IsPresent
@@ -713,10 +727,12 @@ if ($Profile -eq "legacy" -and $IncludeDocs) {
   $docFiles = @(
     @{ Source = "docs\harness-architecture.md"; Destination = "docs/harness/architecture.md" },
     @{ Source = "docs\knowledge-architecture.md"; Destination = "docs/harness/knowledge-architecture.md" },
-    @{ Source = "docs\knowledge-import.md"; Destination = "docs/harness/knowledge-import.md" },
-    @{ Source = "docs\knowledge-lint.md"; Destination = "docs/harness/knowledge-lint.md" },
-    @{ Source = "docs\prompt-knowledge-integration.md"; Destination = "docs/harness/prompt-knowledge-integration.md" },
-    @{ Source = "docs\rule-governance.md"; Destination = "docs/harness/rule-governance.md" },
+    @{ Source = "docs\knowledge-import.md"; Destination = "docs/harness/knowledge-import.md" },
+    @{ Source = "docs\knowledge-lint.md"; Destination = "docs/harness/knowledge-lint.md" },
+    @{ Source = "docs\prompt-knowledge-integration.md"; Destination = "docs/harness/prompt-knowledge-integration.md" },
+    @{ Source = "docs\mcp-knowledge-governance.md"; Destination = "docs/harness/mcp-knowledge-governance.md" },
+    @{ Source = "docs\code-semantics-and-navigation.md"; Destination = "docs/harness/code-semantics-and-navigation.md" },
+    @{ Source = "docs\rule-governance.md"; Destination = "docs/harness/rule-governance.md" },
     @{ Source = "docs\regression-rules.md"; Destination = "docs/harness/regression-rules.md" },
     @{ Source = "docs\team-knowledge-sync.md"; Destination = "docs/harness/team-knowledge-sync.md" },
     @{ Source = "docs\trace-format.md"; Destination = "docs/harness/trace-format.md" },

package/package-source/tools/install/env-check.ps1

@@ -1,40 +1,40 @@
-param(
-  [string[]]$RequiredCommands = @("git", "codex"),
-  [string[]]$RequiredEnvVars = @()
-)
-
-Set-StrictMode -Version Latest
-$ErrorActionPreference = "Stop"
-
-function Assert-CommandExists {
-  <#
-    检查命令是否存在。
-  #>
-  param([string]$Name)
-
-  if (-not (Get-Command $Name -ErrorAction SilentlyContinue)) {
-    throw "缺少必需命令: $Name"
-  }
-}
-
-function Assert-EnvVarExists {
-  <#
-    检查环境变量是否存在且非空。
-  #>
-  param([string]$Name)
-
-  $value = [Environment]::GetEnvironmentVariable($Name)
-  if ([string]::IsNullOrWhiteSpace($value)) {
-    throw "缺少必需环境变量: $Name"
-  }
-}
-
-foreach ($command in $RequiredCommands) {
-  Assert-CommandExists -Name $command
-}
-
-foreach ($envVar in $RequiredEnvVars) {
-  Assert-EnvVarExists -Name $envVar
-}
-
-Write-Output "Environment check passed."
+param(
+  [string[]]$RequiredCommands = @("git", "codex"),
+  [string[]]$RequiredEnvVars = @()
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+function Assert-CommandExists {
+  <#
+    检查命令是否存在。
+  #>
+  param([string]$Name)
+
+  if (-not (Get-Command $Name -ErrorAction SilentlyContinue)) {
+    throw "缺少必需命令: $Name"
+  }
+}
+
+function Assert-EnvVarExists {
+  <#
+    检查环境变量是否存在且非空。
+  #>
+  param([string]$Name)
+
+  $value = [Environment]::GetEnvironmentVariable($Name)
+  if ([string]::IsNullOrWhiteSpace($value)) {
+    throw "缺少必需环境变量: $Name"
+  }
+}
+
+foreach ($command in $RequiredCommands) {
+  Assert-CommandExists -Name $command
+}
+
+foreach ($envVar in $RequiredEnvVars) {
+  Assert-EnvVarExists -Name $envVar
+}
+
+Write-Output "Environment check passed."

package/package-source/tools/install/init-project.ps1

@@ -12,7 +12,7 @@ param(
 Set-StrictMode -Version Latest
 $ErrorActionPreference = 'Stop'
 
-$installScript = Join-Path $PSScriptRoot 'install-agent.ps1'
+$installScript = Join-Path $PSScriptRoot 'install-agent.ps1'
 if (-not (Test-Path -LiteralPath $installScript -PathType Leaf)) {
   throw "找不到 install-agent.ps1: $installScript"
 }

package/package-source/tools/install/install-agent-here.ps1

@@ -1,57 +1,57 @@
-param(
-  [ValidateSet("full")]
-  [string]$Mode = "full",
-  [switch]$Force,
-  [switch]$InitSmoke,
-  [switch]$CommitBaseline,
-  [switch]$SkipBaselineCommit,
-  [switch]$InitGitIfNeeded
-)
-
-Set-StrictMode -Version Latest
-$ErrorActionPreference = "Stop"
-
-$packageRoot = [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot "..\.."))
-$projectRoot = $packageRoot
-$installScript = Join-Path $PSScriptRoot "install-agent.ps1"
-
-if (-not (Test-Path -LiteralPath $installScript)) {
-  throw "找不到 install-agent.ps1: $installScript"
-}
-
-if ([System.IO.Path]::GetFileName($packageRoot) -eq ".agents") {
-  throw "当前脚本位于已安装的 .agents 根目录，不是可移植 agent 包目录。请从独立的 agent/ 包目录运行，或直接调用 install-agent.ps1 并显式传入 -ProjectRoot。"
-}
-
-if ([System.IO.Path]::GetFileName($projectRoot) -eq ".agents") {
-  throw "当前脚本位于 .agents/agent 下，这是源包目录，不是目标项目根目录。请改用 install-agent.ps1 并显式传入 -ProjectRoot。"
-}
-
-Write-Host "[install-agent-here] Target project root: $projectRoot"
-
-$arguments = @{
-  ProjectRoot = $projectRoot
-  Mode = $Mode
-}
-
-if ($Force.IsPresent) {
-  $arguments["Force"] = $true
-}
-
-if ($InitSmoke.IsPresent) {
-  $arguments["InitSmoke"] = $true
-}
-
-if ($CommitBaseline.IsPresent) {
-  $arguments["CommitBaseline"] = $true
-}
-
-if ($SkipBaselineCommit.IsPresent) {
-  $arguments["SkipBaselineCommit"] = $true
-}
-
-if ($InitGitIfNeeded.IsPresent) {
-  $arguments["InitGitIfNeeded"] = $true
-}
-
-& $installScript @arguments
+param(
+  [ValidateSet("full")]
+  [string]$Mode = "full",
+  [switch]$Force,
+  [switch]$InitSmoke,
+  [switch]$CommitBaseline,
+  [switch]$SkipBaselineCommit,
+  [switch]$InitGitIfNeeded
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+$packageRoot = [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot "..\.."))
+$projectRoot = $packageRoot
+$installScript = Join-Path $PSScriptRoot "install-agent.ps1"
+
+if (-not (Test-Path -LiteralPath $installScript)) {
+  throw "找不到 install-agent.ps1: $installScript"
+}
+
+if ([System.IO.Path]::GetFileName($packageRoot) -eq ".agents") {
+  throw "当前脚本位于已安装的 .agents 根目录，不是可移植 agent 包目录。请从独立的 agent/ 包目录运行，或直接调用 install-agent.ps1 并显式传入 -ProjectRoot。"
+}
+
+if ([System.IO.Path]::GetFileName($projectRoot) -eq ".agents") {
+  throw "当前脚本位于 .agents/agent 下，这是源包目录，不是目标项目根目录。请改用 install-agent.ps1 并显式传入 -ProjectRoot。"
+}
+
+Write-Host "[install-agent-here] Target project root: $projectRoot"
+
+$arguments = @{
+  ProjectRoot = $projectRoot
+  Mode = $Mode
+}
+
+if ($Force.IsPresent) {
+  $arguments["Force"] = $true
+}
+
+if ($InitSmoke.IsPresent) {
+  $arguments["InitSmoke"] = $true
+}
+
+if ($CommitBaseline.IsPresent) {
+  $arguments["CommitBaseline"] = $true
+}
+
+if ($SkipBaselineCommit.IsPresent) {
+  $arguments["SkipBaselineCommit"] = $true
+}
+
+if ($InitGitIfNeeded.IsPresent) {
+  $arguments["InitGitIfNeeded"] = $true
+}
+
+& $installScript @arguments