@pzy560117/codex-harness 0.1.9 → 0.1.11

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

@@ -72,10 +72,12 @@ $issues = @()
 $architectureRulesPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\docs\project-agents-template.md"
 $currentTaskPath = Join-Path $ProjectRoot "docs\codex-harness-engineering\templates\context\CURRENT_TASK.md"
 $taskTemplatePath = Join-Path $ProjectRoot "tools\harness\templates\project-task-template.json"
+$featureTaskReferencePath = Join-Path $ProjectRoot "tools\harness\templates\feature-task-reference.json"
 
 $architectureRules = Get-FileContentOrNull -Path $architectureRulesPath
 $currentTask = Get-FileContentOrNull -Path $currentTaskPath
 $taskTemplate = Get-FileContentOrNull -Path $taskTemplatePath
+$featureTaskReference = Get-FileContentOrNull -Path $featureTaskReferencePath
 
 if ($null -eq $architectureRules) {
   $issues += New-Issue -Severity "error" -File "docs/codex-harness-engineering/templates/docs/project-agents-template.md" -Section "file" -Message "缺少 project AGENTS 模板，无法承载第三章目录级架构规则。"
@@ -102,14 +104,23 @@ if ($null -eq $taskTemplate) {
   $issues += New-Issue -Severity "error" -File "tools/harness/templates/project-task-template.json" -Section "file" -Message "缺少 project-task-template，无法承载第三章计划约束。"
 }
 else {
-  if (Test-ContainsPlaceholder -Content $taskTemplate) {
-    $issues += New-Issue -Severity "warning" -File "tools/harness/templates/project-task-template.json" -Section "placeholders" -Message "task 模板仍包含占位符；这是模板预期，但需要保证第三章字段存在。"
+  if (-not (Test-ContainsAll -Content $taskTemplate -Terms @("INIT-001", "ANALYSIS-001", "TESTCASE-001", "PLAN-001", "seed queue", "feature-task-reference.json"))) {
+    $issues += New-Issue -Severity "error" -File "tools/harness/templates/project-task-template.json" -Section "seed-queue-fields" -Message "project-task-template 没有清晰表达四阶段 seed queue 和 feature-task-reference 的分层关系。"
   }
-  if (-not (Test-ContainsAll -Content $taskTemplate -Terms @("architecture_constraints", "forbidden_implementations", "关键调用链", "受影响文件", "受影响测试"))) {
-    $issues += New-Issue -Severity "error" -File "tools/harness/templates/project-task-template.json" -Section "architecture-fields" -Message "task 模板缺少第三章所需的架构与影响面字段。"
+}
+
+if ($null -eq $featureTaskReference) {
+  $issues += New-Issue -Severity "error" -File "tools/harness/templates/feature-task-reference.json" -Section "file" -Message "缺少 feature-task-reference，无法为后续 feature_impl / release 任务提供蓝本。"
+}
+else {
+  if (Test-ContainsPlaceholder -Content $featureTaskReference) {
+    $issues += New-Issue -Severity "warning" -File "tools/harness/templates/feature-task-reference.json" -Section "placeholders" -Message "feature-task-reference 仍包含占位符；这是模板预期，但需要保证完整字段存在。"
+  }
+  if (-not (Test-ContainsAll -Content $featureTaskReference -Terms @("qa_contract", "required_layers", "tdd_contract", "architecture_constraints", "forbidden_implementations", "story_full_chain", "acceptance_validation"))) {
+    $issues += New-Issue -Severity "error" -File "tools/harness/templates/feature-task-reference.json" -Section "implementation-fields" -Message "feature-task-reference 缺少后续 feature_impl / release 任务所需的 QA 和架构字段。"
   }
-  if (-not (Test-ContainsAll -Content $taskTemplate -Terms @("模块归属", "文件改动清单", "复用内容", "新增内容", "不改内容", "风险点", "测试范围"))) {
-    $issues += New-Issue -Severity "error" -File "tools/harness/templates/project-task-template.json" -Section "design-plan-fields" -Message "task 模板缺少复杂功能技术方案字段。"
+  if (-not (Test-ContainsAll -Content $featureTaskReference -Terms @("模块归属", "文件改动清单", "复用内容", "新增内容", "不改内容", "风险点", "测试范围"))) {
+    $issues += New-Issue -Severity "error" -File "tools/harness/templates/feature-task-reference.json" -Section "design-plan-fields" -Message "feature-task-reference 缺少复杂功能技术方案字段。"
   }
 }
 

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

@@ -125,7 +125,7 @@ function Test-IsFormalTaskQueue {
 
   foreach ($task in @($Tasks)) {
     $taskKind = [string](Get-ObjectPropertyValue -InputObject $task -Name "task_kind" -Default "")
-    if (@("feature_research", "feature_spec", "feature_design", "feature_plan", "feature_impl", "release", "archive") -contains $taskKind) {
+    if (@("feature_research", "feature_spec", "feature_design", "feature_plan", "testcase_design", "feature_impl", "release", "archive") -contains $taskKind) {
       return $true
     }
   }

package/package-source/install-manifest.json

@@ -2,7 +2,7 @@
   "schemaVersion": "0.1",
   "status": "draft",
   "package": "codex-harness",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "installModes": [
     {
       "name": "user",
@@ -85,13 +85,20 @@
       "kind": "task-template",
       "mutable": false
     },
-    {
-      "source": "templates/runtime/project-task-template.json",
+    {
+      "source": "templates/runtime/project-task-template.json",
       "destination": "tools/harness/templates/project-task-template.json",
-      "scope": "project",
-      "kind": "task-template",
-      "mutable": false
-    },
+      "scope": "project",
+      "kind": "task-template",
+      "mutable": false
+    },
+    {
+      "source": "templates/runtime/feature-task-reference.json",
+      "destination": "tools/harness/templates/feature-task-reference.json",
+      "scope": "project",
+      "kind": "task-template",
+      "mutable": false
+    },
     {
       "source": "templates/trace/trace.schema.json",
       "destination": "docs/harness/trace.schema.json",

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

@@ -613,6 +613,7 @@ $rootFiles = @(
   @{ 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\feature-task-reference.json"; Destination = "tools\harness\templates\feature-task-reference.json" },
   @{ Source = "tools\harness\task-structure-lint.ps1"; Destination = "tools\harness\task-structure-lint.ps1" },
   @{ Source = "runtime\verify.ps1"; Destination = "tools\harness\verify.ps1" },
   @{ Source = "tools\harness\docs-lint.ps1"; Destination = "tools\harness\docs-lint.ps1" },
@@ -667,7 +668,8 @@ $contextFiles = @(
   @{ 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" }
+  @{ Source = "context\CHANGELOG_AI.md"; Destination = "docs\ai\CHANGELOG_AI.md" },
+  @{ Source = "context\service-dependency-matrix.yaml"; Destination = ".service-matrix\dependencies.yaml" }
 )
 
 foreach ($file in $contextFiles) {

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

@@ -218,7 +218,7 @@ function Write-InstallPlan {
   }
 }
 
-function Get-ManifestEntriesForMode {
+function Get-ManifestEntriesForMode {
   param(
     [object]$ManifestInfo,
     [string]$InstallMode,
@@ -253,8 +253,17 @@ function Get-ManifestEntriesForMode {
     })
   }
 
-  return $modeEntries
-}
+  return $modeEntries
+}
+
+function Get-ThinProjectExcludedDestinations {
+  return @(
+    "docs/testing/",
+    "docs/harness/",
+    "docs/requirement-prep-kit/",
+    "docs/knowledge/"
+  )
+}
 
 function Get-InstallManifestVersion {
   param([object]$ManifestInfo)
@@ -1653,11 +1662,11 @@ function Test-GitRepository {
   }
 }
 
-function Assert-GitRepoOrInit {
-  param(
-    [string]$Root,
-    [bool]$AllowInit
-  )
+function Assert-GitRepoOrInit {
+  param(
+    [string]$Root,
+    [bool]$AllowInit
+  )
 
   $repoExists = Test-GitRepository -Root $Root
 
@@ -1665,15 +1674,32 @@ function Assert-GitRepoOrInit {
     return $true
   }
 
-  if (-not $AllowInit) {
-    throw "目标目录不是 Git 仓库: $Root。请先初始化 Git，或传入 -InitGitIfNeeded。"
-  }
-
-  Write-Step "目标目录不是 Git 仓库，执行 git init。"
-  & git -C $Root init | Out-Null
-  if ($LASTEXITCODE -ne 0) {
-    throw "git init 失败: $Root"
-  }
+  if (-not $AllowInit) {
+    throw "目标目录不是 Git 仓库: $Root。请先初始化 Git，或传入 -InitGitIfNeeded。"
+  }
+
+  $codeGraphCommand = Get-Command codegraph -ErrorAction SilentlyContinue
+  if ($null -eq $codeGraphCommand) {
+    throw "目标目录不是 Git 仓库: $Root。自动初始化前需要先执行 codegraph init -i，但当前环境找不到 codegraph 命令。"
+  }
+
+  Write-Step "目标目录不是 Git 仓库，先执行 codegraph init -i。"
+  Push-Location $Root
+  try {
+    & $codeGraphCommand.Source init -i | Out-Host
+    if ($LASTEXITCODE -ne 0) {
+      throw "codegraph init -i 失败: $Root"
+    }
+  }
+  finally {
+    Pop-Location
+  }
+
+  Write-Step "目标目录不是 Git 仓库，执行 git init。"
+  & git -C $Root init | Out-Null
+  if ($LASTEXITCODE -ne 0) {
+    throw "git init 失败: $Root"
+  }
 
   return $false
 }
@@ -2077,13 +2103,11 @@ function Ensure-ReadmeForSmoke {
 function Assert-InstalledProjectScopeSurface {
   param(
     [object]$ManifestInfo,
-    [string]$ProjectRoot
+    [string]$ProjectRoot,
+    [switch]$ThinProjectProfile
   )
 
-  $projectEntries = @(
-    $ManifestInfo.Entries |
-      Where-Object { [string]$_.Scope -eq "project" }
-  )
+  $projectEntries = @(Get-ManifestEntriesForMode -ManifestInfo $ManifestInfo -InstallMode "project" -ThinProjectProfile:$ThinProjectProfile.IsPresent)
 
   $missingPaths = @()
   foreach ($entry in $projectEntries) {
@@ -2447,7 +2471,8 @@ try {
   }
 
   if ($Mode -eq "project") {
-    Assert-InstalledProjectScopeSurface -ManifestInfo $installManifestInfo -ProjectRoot $resolvedProjectRoot
+    $thinProjectInstall = $Scope -eq "project" -or $defaultThinInstall
+    Assert-InstalledProjectScopeSurface -ManifestInfo $installManifestInfo -ProjectRoot $resolvedProjectRoot -ThinProjectProfile:$thinProjectInstall
     Write-Step "project scope 真相源与运行文件已按 manifest 落地"
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pzy560117/codex-harness",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Codex Harness installer and project runtime CLI",
   "type": "module",
   "bin": {