@pzy560117/codex-harness 0.1.2 → 0.1.4

package/lib/powershell/invoke-script.js

@@ -1,34 +1,34 @@
-import { spawn } from "node:child_process";
-
-import { findPowerShell } from "./find-powershell.js";
-
-export function invokePowerShellScript(scriptPath, args = [], options = {}) {
-  const powershell = findPowerShell();
-  const commandArgs = [
-    "-NoProfile",
-    "-ExecutionPolicy",
-    "Bypass",
-    "-File",
-    scriptPath,
-    ...args
-  ];
-
-  return new Promise((resolve, reject) => {
-    const child = spawn(powershell, commandArgs, {
-      cwd: options.cwd,
-      stdio: "inherit"
-    });
-
-    child.on("error", reject);
-    child.on("exit", (code) => {
-      if (code === 0) {
-        resolve();
-        return;
-      }
-
-      const error = new Error(`PowerShell script failed with exit code ${code}: ${scriptPath}`);
-      error.exitCode = code || 1;
-      reject(error);
-    });
-  });
-}
+import { spawn } from "node:child_process";
+
+import { findPowerShell } from "./find-powershell.js";
+
+export function invokePowerShellScript(scriptPath, args = [], options = {}) {
+  const powershell = findPowerShell();
+  const commandArgs = [
+    "-NoProfile",
+    "-ExecutionPolicy",
+    "Bypass",
+    "-File",
+    scriptPath,
+    ...args
+  ];
+
+  return new Promise((resolve, reject) => {
+    const child = spawn(powershell, commandArgs, {
+      cwd: options.cwd,
+      stdio: "inherit"
+    });
+
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0) {
+        resolve();
+        return;
+      }
+
+      const error = new Error(`PowerShell script failed with exit code ${code}: ${scriptPath}`);
+      error.exitCode = code || 1;
+      reject(error);
+    });
+  });
+}

package/lib/project/assert-initialized.js

@@ -1,20 +1,20 @@
-import fs from "node:fs";
-import path from "node:path";
-
-export function assertInitialized(projectRoot) {
-  const requiredPaths = [
-    "tools/harness/doctor.ps1",
-    "tools/harness/verify.ps1",
-    "tools/harness/codex-loop.ps1",
-    "task.json"
-  ];
-
-  for (const relativePath of requiredPaths) {
-    const fullPath = path.join(projectRoot, relativePath);
-    if (!fs.existsSync(fullPath)) {
-      const error = new Error(`Project is not initialized. Missing: ${relativePath}. Run 'harness init'.`);
-      error.exitCode = 2;
-      throw error;
-    }
-  }
-}
+import fs from "node:fs";
+import path from "node:path";
+
+export function assertInitialized(projectRoot) {
+  const requiredPaths = [
+    "tools/harness/doctor.ps1",
+    "tools/harness/verify.ps1",
+    "tools/harness/codex-loop.ps1",
+    "task.json"
+  ];
+
+  for (const relativePath of requiredPaths) {
+    const fullPath = path.join(projectRoot, relativePath);
+    if (!fs.existsSync(fullPath)) {
+      const error = new Error(`Project is not initialized. Missing: ${relativePath}. Run 'harness init'.`);
+      error.exitCode = 2;
+      throw error;
+    }
+  }
+}

package/lib/project/detect-project-root.js

@@ -1,5 +1,5 @@
-import process from "node:process";
-
-export function detectProjectRoot(projectRoot) {
-  return projectRoot || process.cwd();
-}
+import process from "node:process";
+
+export function detectProjectRoot(projectRoot) {
+  return projectRoot || process.cwd();
+}

package/lib/release/cache-layout.js

@@ -1,34 +1,34 @@
-import path from "node:path";
-import { RELEASE_MANIFEST_FILE } from "./release-manifest.js";
-
-export function getPackageCacheRoot(userProfile) {
-  return path.win32.join(userProfile, ".codex", "packages", "codex-harness");
-}
-
-export function getPackageInstallRoot(userProfile, version) {
-  return path.win32.join(getPackageCacheRoot(userProfile), version);
-}
-
-export function getUserPackageLockPath(userProfile) {
-  return path.win32.join(getPackageCacheRoot(userProfile), "package.lock.json");
-}
-
-export function getReleaseAssetNames(version) {
-  return {
-    zip: `codex-harness-${version}-win.zip`,
-    sha256: `codex-harness-${version}-win.sha256`,
-    manifest: RELEASE_MANIFEST_FILE
-  };
-}
-
-export function getDownloadedZipPath(userProfile, version) {
-  return path.win32.join(getPackageCacheRoot(userProfile), getReleaseAssetNames(version).zip);
-}
-
-export function getDownloadedShaPath(userProfile, version) {
-  return path.win32.join(getPackageCacheRoot(userProfile), getReleaseAssetNames(version).sha256);
-}
-
-export function getDownloadedManifestPath(userProfile, version) {
-  return path.win32.join(getPackageCacheRoot(userProfile), `release-manifest-${version}.json`);
-}
+import path from "node:path";
+import { RELEASE_MANIFEST_FILE } from "./release-manifest.js";
+
+export function getPackageCacheRoot(userProfile) {
+  return path.win32.join(userProfile, ".codex", "packages", "codex-harness");
+}
+
+export function getPackageInstallRoot(userProfile, version) {
+  return path.win32.join(getPackageCacheRoot(userProfile), version);
+}
+
+export function getUserPackageLockPath(userProfile) {
+  return path.win32.join(getPackageCacheRoot(userProfile), "package.lock.json");
+}
+
+export function getReleaseAssetNames(version) {
+  return {
+    zip: `codex-harness-${version}-win.zip`,
+    sha256: `codex-harness-${version}-win.sha256`,
+    manifest: RELEASE_MANIFEST_FILE
+  };
+}
+
+export function getDownloadedZipPath(userProfile, version) {
+  return path.win32.join(getPackageCacheRoot(userProfile), getReleaseAssetNames(version).zip);
+}
+
+export function getDownloadedShaPath(userProfile, version) {
+  return path.win32.join(getPackageCacheRoot(userProfile), getReleaseAssetNames(version).sha256);
+}
+
+export function getDownloadedManifestPath(userProfile, version) {
+  return path.win32.join(getPackageCacheRoot(userProfile), `release-manifest-${version}.json`);
+}

package/lib/release/download-release.js

@@ -1,25 +1,25 @@
-import fs from "node:fs";
-import path from "node:path";
-import { mkdir, writeFile } from "node:fs/promises";
-
-export async function downloadToFile(url, destinationPath) {
-  const response = await fetch(url, {
-    headers: {
-      "User-Agent": "codex-harness-cli"
-    },
-    redirect: "follow"
-  });
-
-  if (!response.ok) {
-    throw new Error(`Failed to download ${url}: ${response.status} ${response.statusText}`);
-  }
-
-  await mkdir(path.dirname(destinationPath), { recursive: true });
-  const buffer = Buffer.from(await response.arrayBuffer());
-  await writeFile(destinationPath, buffer);
-  return destinationPath;
-}
-
-export function fileExists(pathLike) {
-  return fs.existsSync(pathLike);
-}
+import fs from "node:fs";
+import path from "node:path";
+import { mkdir, writeFile } from "node:fs/promises";
+
+export async function downloadToFile(url, destinationPath) {
+  const response = await fetch(url, {
+    headers: {
+      "User-Agent": "codex-harness-cli"
+    },
+    redirect: "follow"
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to download ${url}: ${response.status} ${response.statusText}`);
+  }
+
+  await mkdir(path.dirname(destinationPath), { recursive: true });
+  const buffer = Buffer.from(await response.arrayBuffer());
+  await writeFile(destinationPath, buffer);
+  return destinationPath;
+}
+
+export function fileExists(pathLike) {
+  return fs.existsSync(pathLike);
+}

package/lib/release/package-source-layout.js

@@ -1,13 +1,13 @@
-export const RELEASE_SOURCE_ENTRIES = [
-  "AGENTS.md",
-  "README.md",
-  "PACKAGE.md",
-  "install-manifest.json",
-  "install-manifest.schema.json",
-  "tools/install",
-  "docs/codex-harness-engineering/templates"
-];
-
-export function shouldIncludeReleaseSource(relativePath) {
-  return RELEASE_SOURCE_ENTRIES.includes(relativePath);
-}
+export const RELEASE_SOURCE_ENTRIES = [
+  "AGENTS.md",
+  "README.md",
+  "PACKAGE.md",
+  "install-manifest.json",
+  "install-manifest.schema.json",
+  "tools/install",
+  "docs/codex-harness-engineering/templates"
+];
+
+export function shouldIncludeReleaseSource(relativePath) {
+  return RELEASE_SOURCE_ENTRIES.includes(relativePath);
+}

package/lib/release/release-config.js

@@ -1,6 +1,6 @@
-export const DEFAULT_RELEASE_OWNER = "pzy560117";
-export const DEFAULT_RELEASE_REPO = "codex-herness-agent";
-
-export function buildReleaseAssetUrl({ owner = DEFAULT_RELEASE_OWNER, repo = DEFAULT_RELEASE_REPO, version, assetName }) {
-  return `https://github.com/${owner}/${repo}/releases/download/v${version}/${assetName}`;
-}
+export const DEFAULT_RELEASE_OWNER = "pzy560117";
+export const DEFAULT_RELEASE_REPO = "codex-herness-agent";
+
+export function buildReleaseAssetUrl({ owner = DEFAULT_RELEASE_OWNER, repo = DEFAULT_RELEASE_REPO, version, assetName }) {
+  return `https://github.com/${owner}/${repo}/releases/download/v${version}/${assetName}`;
+}

package/lib/release/release-manifest.js

@@ -1,76 +1,76 @@
-export const RELEASE_MANIFEST_FILE = "release-manifest.json";
-export const DEFAULT_RELEASE_PLATFORM = "win32-x64";
-
-export function createReleaseManifest({
-  packageName = "codex-harness",
-  version,
-  zipFile,
-  sha256File,
-  sha256,
-  size,
-  releaseTag = `v${version}`,
-  generatedAt,
-  owner = "",
-  repo = "",
-  sourceCommit = ""
-}) {
-  if (!version) {
-    throw new Error("release manifest version is required.");
-  }
-
-  if (!zipFile || !sha256File || !sha256) {
-    throw new Error("release manifest assets are incomplete.");
-  }
-
-  return {
-    package: packageName,
-    version,
-    releaseTag,
-    generatedAt: generatedAt ?? new Date().toISOString(),
-    source: {
-      owner,
-      repo,
-      commit: sourceCommit
-    },
-    platforms: {
-      [DEFAULT_RELEASE_PLATFORM]: {
-        zip: zipFile,
-        sha256File,
-        sha256,
-        size
-      }
-    }
-  };
-}
-
-export function getReleasePlatformEntry(manifest, platform = DEFAULT_RELEASE_PLATFORM) {
-  if (!manifest || typeof manifest !== "object") {
-    throw new Error("release manifest is missing.");
-  }
-
-  if (String(manifest.package || "").trim() !== "codex-harness") {
-    throw new Error("release manifest package must be codex-harness.");
-  }
-
-  const version = String(manifest.version || "").trim();
-  if (!version) {
-    throw new Error("release manifest version is missing.");
-  }
-
-  const entry = manifest.platforms?.[platform];
-  if (!entry) {
-    throw new Error(`release manifest does not include platform ${platform}.`);
-  }
-
-  if (!entry.zip || !entry.sha256File || !entry.sha256) {
-    throw new Error(`release manifest platform ${platform} is incomplete.`);
-  }
-
-  return {
-    version,
-    zip: entry.zip,
-    sha256File: entry.sha256File,
-    sha256: entry.sha256,
-    size: entry.size ?? null
-  };
-}
+export const RELEASE_MANIFEST_FILE = "release-manifest.json";
+export const DEFAULT_RELEASE_PLATFORM = "win32-x64";
+
+export function createReleaseManifest({
+  packageName = "codex-harness",
+  version,
+  zipFile,
+  sha256File,
+  sha256,
+  size,
+  releaseTag = `v${version}`,
+  generatedAt,
+  owner = "",
+  repo = "",
+  sourceCommit = ""
+}) {
+  if (!version) {
+    throw new Error("release manifest version is required.");
+  }
+
+  if (!zipFile || !sha256File || !sha256) {
+    throw new Error("release manifest assets are incomplete.");
+  }
+
+  return {
+    package: packageName,
+    version,
+    releaseTag,
+    generatedAt: generatedAt ?? new Date().toISOString(),
+    source: {
+      owner,
+      repo,
+      commit: sourceCommit
+    },
+    platforms: {
+      [DEFAULT_RELEASE_PLATFORM]: {
+        zip: zipFile,
+        sha256File,
+        sha256,
+        size
+      }
+    }
+  };
+}
+
+export function getReleasePlatformEntry(manifest, platform = DEFAULT_RELEASE_PLATFORM) {
+  if (!manifest || typeof manifest !== "object") {
+    throw new Error("release manifest is missing.");
+  }
+
+  if (String(manifest.package || "").trim() !== "codex-harness") {
+    throw new Error("release manifest package must be codex-harness.");
+  }
+
+  const version = String(manifest.version || "").trim();
+  if (!version) {
+    throw new Error("release manifest version is missing.");
+  }
+
+  const entry = manifest.platforms?.[platform];
+  if (!entry) {
+    throw new Error(`release manifest does not include platform ${platform}.`);
+  }
+
+  if (!entry.zip || !entry.sha256File || !entry.sha256) {
+    throw new Error(`release manifest platform ${platform} is incomplete.`);
+  }
+
+  return {
+    version,
+    zip: entry.zip,
+    sha256File: entry.sha256File,
+    sha256: entry.sha256,
+    size: entry.size ?? null
+  };
+}

package/lib/release/resolve-package-source.js

@@ -1,21 +1,21 @@
-import path from "node:path";
-
-export function resolvePackageSourceRoot({ packageRoot, embeddedRoot = "", cachedRoot, fsLike }) {
-  const existsSync = fsLike?.existsSync ?? (() => false);
-  const localScript = path.win32.join(packageRoot, "tools", "install", "install-agent.ps1");
-  if (existsSync(localScript)) {
-    return packageRoot;
-  }
-
-  const embeddedScript = path.win32.join(embeddedRoot, "tools", "install", "install-agent.ps1");
-  if (embeddedRoot && existsSync(embeddedScript)) {
-    return embeddedRoot;
-  }
-
-  const cachedScript = path.win32.join(cachedRoot, "tools", "install", "install-agent.ps1");
-  if (existsSync(cachedScript)) {
-    return cachedRoot;
-  }
-
-  return "";
-}
+import path from "node:path";
+
+export function resolvePackageSourceRoot({ packageRoot, embeddedRoot = "", cachedRoot, fsLike }) {
+  const existsSync = fsLike?.existsSync ?? (() => false);
+  const localScript = path.win32.join(packageRoot, "tools", "install", "install-agent.ps1");
+  if (existsSync(localScript)) {
+    return packageRoot;
+  }
+
+  const embeddedScript = path.win32.join(embeddedRoot, "tools", "install", "install-agent.ps1");
+  if (embeddedRoot && existsSync(embeddedScript)) {
+    return embeddedRoot;
+  }
+
+  const cachedScript = path.win32.join(cachedRoot, "tools", "install", "install-agent.ps1");
+  if (existsSync(cachedScript)) {
+    return cachedRoot;
+  }
+
+  return "";
+}

package/lib/release/resolve-version.js

@@ -1,26 +1,26 @@
-import { DEFAULT_RELEASE_OWNER, DEFAULT_RELEASE_REPO } from "./release-config.js";
-
-export async function resolveVersion(requestedVersion) {
-  if (requestedVersion && requestedVersion !== "latest") {
-    return requestedVersion;
-  }
-
-  const apiUrl = `https://api.github.com/repos/${DEFAULT_RELEASE_OWNER}/${DEFAULT_RELEASE_REPO}/releases/latest`;
-  const response = await fetch(apiUrl, {
-    headers: {
-      "User-Agent": "codex-harness-cli"
-    }
-  });
-
-  if (!response.ok) {
-    throw new Error(`Failed to resolve latest release version: ${response.status} ${response.statusText}`);
-  }
-
-  const json = await response.json();
-  const tag = String(json.tag_name || "").trim();
-  if (!tag) {
-    throw new Error("Latest release did not include tag_name.");
-  }
-
-  return tag.startsWith("v") ? tag.slice(1) : tag;
-}
+import { DEFAULT_RELEASE_OWNER, DEFAULT_RELEASE_REPO } from "./release-config.js";
+
+export async function resolveVersion(requestedVersion) {
+  if (requestedVersion && requestedVersion !== "latest") {
+    return requestedVersion;
+  }
+
+  const apiUrl = `https://api.github.com/repos/${DEFAULT_RELEASE_OWNER}/${DEFAULT_RELEASE_REPO}/releases/latest`;
+  const response = await fetch(apiUrl, {
+    headers: {
+      "User-Agent": "codex-harness-cli"
+    }
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to resolve latest release version: ${response.status} ${response.statusText}`);
+  }
+
+  const json = await response.json();
+  const tag = String(json.tag_name || "").trim();
+  if (!tag) {
+    throw new Error("Latest release did not include tag_name.");
+  }
+
+  return tag.startsWith("v") ? tag.slice(1) : tag;
+}

package/lib/release/unpack-zip.js

@@ -1,25 +1,25 @@
-import fs from "node:fs";
-import path from "node:path";
-
-import { invokePowerShellScript } from "../powershell/invoke-script.js";
-
-export async function unpackZip(zipPath, destinationRoot) {
-  if (!fs.existsSync(destinationRoot)) {
-    fs.mkdirSync(destinationRoot, { recursive: true });
-  }
-
-  const scriptPath = path.join(destinationRoot, "__expand-archive.ps1");
-  fs.writeFileSync(
-    scriptPath,
-    `Expand-Archive -LiteralPath '${zipPath.replace(/'/g, "''")}' -DestinationPath '${destinationRoot.replace(/'/g, "''")}' -Force`,
-    "utf8"
-  );
-
-  try {
-    await invokePowerShellScript(scriptPath, [], { cwd: destinationRoot });
-  } finally {
-    if (fs.existsSync(scriptPath)) {
-      fs.unlinkSync(scriptPath);
-    }
-  }
-}
+import fs from "node:fs";
+import path from "node:path";
+
+import { invokePowerShellScript } from "../powershell/invoke-script.js";
+
+export async function unpackZip(zipPath, destinationRoot) {
+  if (!fs.existsSync(destinationRoot)) {
+    fs.mkdirSync(destinationRoot, { recursive: true });
+  }
+
+  const scriptPath = path.join(destinationRoot, "__expand-archive.ps1");
+  fs.writeFileSync(
+    scriptPath,
+    `Expand-Archive -LiteralPath '${zipPath.replace(/'/g, "''")}' -DestinationPath '${destinationRoot.replace(/'/g, "''")}' -Force`,
+    "utf8"
+  );
+
+  try {
+    await invokePowerShellScript(scriptPath, [], { cwd: destinationRoot });
+  } finally {
+    if (fs.existsSync(scriptPath)) {
+      fs.unlinkSync(scriptPath);
+    }
+  }
+}

package/lib/release/verify-sha256.js

@@ -1,16 +1,16 @@
-import crypto from "node:crypto";
-import fs from "node:fs/promises";
-
-export async function verifyFileSha256(filePath, shaFilePath, expectedSha256 = "") {
-  const fileBuffer = await fs.readFile(filePath);
-  const expected = (await fs.readFile(shaFilePath, "utf8")).trim().split(/\s+/)[0];
-  const actual = crypto.createHash("sha256").update(fileBuffer).digest("hex");
-
-  if (expected.toLowerCase() !== actual.toLowerCase()) {
-    throw new Error(`SHA256 mismatch for ${filePath}`);
-  }
-
-  if (expectedSha256 && expectedSha256.toLowerCase() !== actual.toLowerCase()) {
-    throw new Error(`Release manifest SHA256 mismatch for ${filePath}`);
-  }
-}
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+
+export async function verifyFileSha256(filePath, shaFilePath, expectedSha256 = "") {
+  const fileBuffer = await fs.readFile(filePath);
+  const expected = (await fs.readFile(shaFilePath, "utf8")).trim().split(/\s+/)[0];
+  const actual = crypto.createHash("sha256").update(fileBuffer).digest("hex");
+
+  if (expected.toLowerCase() !== actual.toLowerCase()) {
+    throw new Error(`SHA256 mismatch for ${filePath}`);
+  }
+
+  if (expectedSha256 && expectedSha256.toLowerCase() !== actual.toLowerCase()) {
+    throw new Error(`Release manifest SHA256 mismatch for ${filePath}`);
+  }
+}

package/package-source/docs/codex-harness-engineering/templates/README.md

@@ -1,20 +1,21 @@
-# Templates README
-
-当前模板集只保留单工作区、单 driver 的最小闭环。
-
-## 主要目录
-
-- `runtime/`: 项目根运行入口、driver、doctor、任务队列、运行策略、验证脚本
-- `config/`: 全局与项目级配置示例
-- `docs/`: 会复制到项目 `docs/harness/` 的文档模板，也包含 `project-agents-template.md` 这种按项目事实生成 `AGENTS.md` 的通用规则模板
-- `design/`: 前端先行链路的设计 brief、图转前端规格、组件映射、状态矩阵、视觉评审、前端架构和 design tokens 模板
-- `testing/`: 测试左移模板，包含验收标准、验收示例、追溯矩阵、测试数据、回归计划、失败归因和 verify 矩阵
-- `prompts/`: driver、review、visual、failure、repair 使用的提示词模板
-- `trace/`: trace 与 schema 示例
-- `package-assets/`: 会复制到目标项目 `.agents/` 的能力包与安装入口镜像
-
-已移除：
-
-- 额外执行工作区脚本
-- 外部 worker 编排模板
-- 控制面状态模板
+# Templates README
+
+当前模板集只保留单工作区、单 driver 的最小闭环。
+
+## 主要目录
+
+- `runtime/`: 项目根运行入口、driver、doctor、任务队列、运行策略、验证脚本
+- `config/`: 全局与项目级配置示例
+- `docs/`: 会复制到项目 `docs/harness/` 的文档模板，也包含 `project-agents-template.md` 这种按项目事实生成 `AGENTS.md` 的通用规则模板
+- `tools/`: 会复制到项目 `tools/harness/` 的内容级门禁脚本模板，例如 spec/context/architecture/directory/style/session/docs/data/integration/mobile/acceptance lint
+- `design/`: 前端先行链路的设计 brief、图转前端规格、组件映射、状态矩阵、视觉评审、前端架构和 design tokens 模板
+- `testing/`: 测试左移模板，包含验收标准、验收示例、追溯矩阵、测试数据、回归计划、失败归因和 verify 矩阵
+- `prompts/`: driver、review、visual、failure、repair 使用的提示词模板
+- `trace/`: trace 与 schema 示例
+- `package-assets/`: 会复制到目标项目 `.agents/` 的能力包与安装入口镜像
+
+已移除：
+
+- 额外执行工作区脚本
+- 外部 worker 编排模板
+- 控制面状态模板