@pzy560117/codex-harness 0.1.3 → 0.1.5

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

@@ -20,12 +20,12 @@ param(
   [switch]$InitGitIfNeeded
 )
 
-Set-StrictMode -Version Latest
-$ErrorActionPreference = "Stop"
-
-function Get-PackageRoot {
-  return [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot "..\.."))
-}
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+function Get-PackageRoot {
+  return [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot "..\.."))
+}
 
 function Write-Step {
   param([string]$Message)
@@ -287,7 +287,7 @@ function Get-PackageSourceCommit {
 function Read-PackageLockOrNull {
   param([string]$ProjectRoot)
 
-  $lockPath = Join-Path $ProjectRoot ".codex-harness\locks\package.lock.json"
+  $lockPath = Join-Path $ProjectRoot ".codex-harness\locks\package.lock.json"
   if (-not (Test-Path -LiteralPath $lockPath -PathType Leaf)) {
     return $null
   }
@@ -466,7 +466,7 @@ function Write-UpgradePlan {
   $lockInfo = Read-PackageLockOrNull -ProjectRoot $ProjectRoot
   if ($null -eq $lockInfo) {
     Write-Output "Status: missing-lock"
-    Write-Output "Reason: .codex-harness/locks/package.lock.json 不存在，无法安全区分包管理文件和用户文件。"
+    Write-Output "Reason: .codex-harness/locks/package.lock.json 不存在，无法安全区分包管理文件和用户文件。"
     return
   }
 
@@ -894,7 +894,7 @@ function Write-MigrationAdoptPackageLock {
     [object[]]$AdoptRecords
   )
 
-  $lockDirectory = Join-Path $ProjectRoot ".codex-harness\locks"
+  $lockDirectory = Join-Path $ProjectRoot ".codex-harness\locks"
   if (-not (Test-Path -LiteralPath $lockDirectory -PathType Container)) {
     New-Item -ItemType Directory -Force -Path $lockDirectory | Out-Null
   }
@@ -961,7 +961,7 @@ function Invoke-MigrationApply {
   $blockedRecords = @($records | Where-Object { @("blocked-user-drift", "unknown-legacy-file", "manual-review") -contains [string]$_.Action })
   $plannedWrites = @()
   if ($adoptRecords.Count -gt 0) {
-    $plannedWrites = @(".codex-harness/locks/package.lock.json", ".codex-harness/state/config.json")
+    $plannedWrites = @(".codex-harness/locks/package.lock.json", ".codex-harness/state/config.json")
   }
 
   if (-not [bool]$plan.AgentsExists) {
@@ -1165,7 +1165,7 @@ function Get-InstallLockManagedFiles {
       continue
     }
 
-    if ([string]$entry.Kind -eq "generated-lock" -or [string]$entry.Destination -eq ".codex-harness/locks/package.lock.json") {
+    if ([string]$entry.Kind -eq "generated-lock" -or [string]$entry.Destination -eq ".codex-harness/locks/package.lock.json") {
       continue
     }
 
@@ -1228,7 +1228,7 @@ function Write-InstalledPackageLock {
   $packageVersion = Get-InstallManifestVersion -ManifestInfo $ManifestInfo
   $aiKitManifestPath = Join-Path $PackageRoot "ai-sync\ai-kit-manifest.json"
 
-  $lockDirectory = Join-Path $ProjectRoot ".codex-harness\locks"
+  $lockDirectory = Join-Path $ProjectRoot ".codex-harness\locks"
   if (-not (Test-Path -LiteralPath $lockDirectory -PathType Container)) {
     New-Item -ItemType Directory -Force -Path $lockDirectory | Out-Null
   }
@@ -1269,7 +1269,7 @@ function Write-ProjectHarnessConfig {
     [string]$PackageRoot
   )
 
-  $configDirectory = Join-Path $ProjectRoot ".codex-harness\state"
+  $configDirectory = Join-Path $ProjectRoot ".codex-harness\state"
   if (-not (Test-Path -LiteralPath $configDirectory -PathType Container)) {
     New-Item -ItemType Directory -Force -Path $configDirectory | Out-Null
   }
@@ -1366,7 +1366,7 @@ function Invoke-UpgradeExecution {
 
   $lockInfo = Read-PackageLockOrNull -ProjectRoot $ProjectRoot
   if ($null -eq $lockInfo) {
-    throw "missing-lock: .codex-harness/locks/package.lock.json 不存在，无法安全执行升级。"
+    throw "missing-lock: .codex-harness/locks/package.lock.json 不存在，无法安全执行升级。"
   }
 
   $lockDocument = $lockInfo.Document
@@ -1539,7 +1539,7 @@ function Invoke-UninstallExecution {
 
   $lockInfo = Read-PackageLockOrNull -ProjectRoot $ProjectRoot
   if ($null -eq $lockInfo) {
-    throw "missing-lock: .codex-harness/locks/package.lock.json 不存在，无法安全执行卸载。"
+    throw "missing-lock: .codex-harness/locks/package.lock.json 不存在，无法安全执行卸载。"
   }
 
   $lockDocument = $lockInfo.Document
@@ -2139,10 +2139,10 @@ function Copy-Package {
     -DestinationRelativePath "docs\codex-harness-engineering\templates"
 }
 
-$sourceRoot = Get-PackageRoot
-if ([string]::IsNullOrWhiteSpace($ProjectRoot)) {
-  $ProjectRoot = $sourceRoot
-}
+$sourceRoot = Get-PackageRoot
+if ([string]::IsNullOrWhiteSpace($ProjectRoot)) {
+  $ProjectRoot = $sourceRoot
+}
 
 $resolvedProjectRoot = [System.IO.Path]::GetFullPath($ProjectRoot)
 $targetAgentsRoot = Join-Path $resolvedProjectRoot ".agents"
@@ -2319,7 +2319,7 @@ try {
       $scopeUserPackage = Install-UserPackageLayer -ManifestInfo $installManifestInfo -PackageRoot $effectiveSourceRoot
     }
 
-    $bootstrapScript = Join-Path $effectiveSourceRoot "tools\install\bootstrap-codex-harness.ps1"
+    $bootstrapScript = Join-Path $effectiveSourceRoot "tools\install\bootstrap-codex-harness.ps1"
     Write-Step "同步项目根 runtime 文件 (mode=$Mode)"
     $bootstrapArgs = @(
       '-NoProfile',
@@ -2417,7 +2417,7 @@ try {
       Write-Step "为 smoke 初始化补充 README.md: $generatedReadme"
     }
 
-    $smokeTaskPath = Join-Path $resolvedProjectRoot "tools\harness\templates\smoke-task.json"
+    $smokeTaskPath = Join-Path $resolvedProjectRoot "tools\harness\templates\smoke-task.json"
     $taskPath = Join-Path $resolvedProjectRoot "task.json"
     if (-not (Test-Path -LiteralPath $smokeTaskPath)) {
       throw "找不到 smoke-task.json: $smokeTaskPath"
@@ -2494,16 +2494,18 @@ try {
   Write-Output ("SmokeInitialized: {0}" -f $InitSmoke.IsPresent)
   Write-Output ("BaselineCommitted: {0}" -f $baselineCommitted)
   Write-Output ("BaselinePolicy: {0}" -f $baselinePolicy)
-  if ($Mode -eq "full" -or $Mode -eq "project") {
-    Write-Output ""
-    Write-Output "Next steps:"
-    Write-Output ("- 裁剪 `"{0}`" 和 `"{1}`" 为目标项目事实" -f (Join-Path $resolvedProjectRoot 'docs\ai\repo-map.md'), (Join-Path $resolvedProjectRoot 'docs\ai\architecture-brief.md'))
-    Write-Output ("- powershell -NoProfile -ExecutionPolicy Bypass -File `"{0}`"" -f (Join-Path $resolvedProjectRoot 'tools\install\env-check.ps1'))
-    Write-Output ("- powershell -NoProfile -ExecutionPolicy Bypass -File `"{0}`"" -f (Join-Path $resolvedProjectRoot 'tools\harness\verify.ps1'))
-    Write-Output ("- 如需 7x24 长时间推进，可在 Codex app 中使用 `/goal`；推荐先读 `"{0}`" 和 `"{1}`"" -f (Join-Path $resolvedProjectRoot 'docs\codex-harness-engineering\goal-harness-integration-guide.md'), (Join-Path $resolvedProjectRoot 'docs\codex-harness-engineering\examples\goal-templates.md'))
-    Write-Output ("- powershell -NoProfile -ExecutionPolicy Bypass -File `"{0}`"" -f (Join-Path $resolvedProjectRoot 'tools\harness\codex-loop.ps1'))
-  }
-}
+  if ($Mode -eq "full" -or $Mode -eq "project") {
+    Write-Output ""
+    Write-Output "Next steps:"
+    Write-Output ("- 先裁剪 `"{0}`"、`"{1}`" 和 `"{2}`" 为目标项目事实" -f (Join-Path $resolvedProjectRoot 'docs\ai\repo-map.md'), (Join-Path $resolvedProjectRoot 'docs\ai\architecture-brief.md'), (Join-Path $resolvedProjectRoot 'docs\ai\CURRENT_TASK.md'))
+    Write-Output ("- 复杂项目继续补齐 `"{0}`"、`"{1}`"、`"{2}`"、`"{3}`"、`"{4}`"、`"{5}`"" -f (Join-Path $resolvedProjectRoot 'docs\ai\PROJECT_CONTEXT.md'), (Join-Path $resolvedProjectRoot 'docs\ai\DECISIONS.md'), (Join-Path $resolvedProjectRoot 'docs\ai\API_MAP.md'), (Join-Path $resolvedProjectRoot 'docs\ai\DB_SCHEMA.md'), (Join-Path $resolvedProjectRoot 'docs\ai\KNOWN_ISSUES.md'), (Join-Path $resolvedProjectRoot 'docs\ai\CHANGELOG_AI.md'))
+    Write-Output ("- powershell -NoProfile -ExecutionPolicy Bypass -File `"{0}`"" -f (Join-Path $resolvedProjectRoot 'tools\install\env-check.ps1'))
+    Write-Output ("- powershell -NoProfile -ExecutionPolicy Bypass -File `"{0}`"" -f (Join-Path $resolvedProjectRoot 'tools\harness\verify.ps1'))
+    Write-Output ("- 如需接入外部知识或代码语义工具，先读 `"{0}`" 和 `"{1}`"" -f (Join-Path $resolvedProjectRoot 'docs\harness\mcp-knowledge-governance.md'), (Join-Path $resolvedProjectRoot 'docs\harness\code-semantics-and-navigation.md'))
+    Write-Output ("- 如需 7x24 长时间推进，可在 Codex app 中使用 `/goal`；推荐先读 `"{0}`" 和 `"{1}`"" -f (Join-Path $resolvedProjectRoot 'docs\codex-harness-engineering\goal-harness-integration-guide.md'), (Join-Path $resolvedProjectRoot 'docs\codex-harness-engineering\examples\goal-templates.md'))
+    Write-Output ("- powershell -NoProfile -ExecutionPolicy Bypass -File `"{0}`"" -f (Join-Path $resolvedProjectRoot 'tools\harness\codex-loop.ps1'))
+  }
+}
 finally {
   if (($null -ne $stagedSourceRoot) -and (Test-Path -LiteralPath $stagedSourceRoot)) {
     Remove-Item -LiteralPath $stagedSourceRoot -Recurse -Force -ErrorAction SilentlyContinue

package/package.json

@@ -1,23 +1,23 @@
-{
-  "name": "@pzy560117/codex-harness",
-  "version": "0.1.3",
-  "description": "Codex Harness installer and project runtime CLI",
-  "type": "module",
-  "bin": {
-    "harness": "./bin/harness.js"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "files": [
-    "bin",
-    "lib",
-    "package-source",
-    "README.md"
-  ],
-  "scripts": {
-    "test": "node --test",
-    "prepack": "node ../tools/release/sync-cli-package-source.mjs",
-    "pack:check": "npm pack --dry-run"
-  }
-}
+{
+  "name": "@pzy560117/codex-harness",
+  "version": "0.1.5",
+  "description": "Codex Harness installer and project runtime CLI",
+  "type": "module",
+  "bin": {
+    "harness": "bin/harness.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "package-source",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test",
+    "prepack": "node ../tools/release/sync-cli-package-source.mjs",
+    "pack:check": "npm pack --dry-run"
+  }
+}