easy-coding-harness 0.5.2-beta.0 → 0.5.3

package/CHANGELOG.md

@@ -6,6 +6,13 @@
 - `y`：常规功能升级
 - `z`：日常 bug 修复
 
+## 0.5.3
+
+- 根治 `task.json` 绝对路径泄漏：`.easy-coding/tasks/project-init/task.json` 不再写入本机仓库绝对路径。该 `project_path` 字段无任何消费方，直接移除，可提交产物彻底去本地化。
+- `easy-coding upgrade` 会自动剥离存量项目中遗留的 `project_path` 字段，让老项目也随升级变干净。
+- 根治 hook 编译产物：hook launcher 设置 `sys.dont_write_bytecode=True`，运行时不再在 `.claude/hooks/`、`.codex/hooks/`、`.qoder/hooks/` 旁生成 `__pycache__/*.pyc`；同时 `init` / `add-agent` / `upgrade` 会向项目 `.gitignore` 追加 `__pycache__/` 作为兜底防御。launcher 内容变化会触发 `upgrade` 刷新存量 hook 注册。
+- 版本自 `0.5.2-beta.0` 升级为 `0.5.3`，合并 beta.0 的全部 portable hook 修复。跳过 `0.5.2` 正式版：升级检测的 `compareVersions` 会截断预发布后缀，若发 `0.5.2` 会把已安装 `0.5.2-beta.0` 的项目误判为已最新而不提示本次迁移；递增到 `0.5.3` 可让 beta 用户正确检测到升级。
+
 ## 0.5.2-beta.0
 
 - 修复 Claude Code hook 命令使用直接相对路径导致在子目录 cwd 下找不到 `.claude/hooks/*.py` 的问题；Claude、Codex、Qoder 的 hook 配置现在使用可共享的 portable relative launcher，并绑定 `.easy-coding/config.yaml` 的 `project.id`，避免把本机仓库绝对路径写入可提交配置，同时防止 supermodule 父仓 hook 被子仓 cwd 错路由。

package/dist/cli.js

@@ -208,6 +208,7 @@ var MAIN_SPEC_DIR = "main";
 var DEV_SPEC_DIR = "dev";
 var TEMPLATES_DIR = "templates";
 var SESSIONS_GITIGNORE_ENTRY = ".easy-coding/sessions/";
+var HOOK_BYTECODE_GITIGNORE_ENTRY = "__pycache__/";
 var GENERATED_REGION_START = "<!-- \u2550\u2550\u2550 easy-coding-harness generated (DO NOT EDIT BETWEEN MARKERS) \u2550\u2550\u2550 -->";
 var GENERATED_REGION_END = "<!-- \u2550\u2550\u2550 end easy-coding-harness generated \u2550\u2550\u2550 -->";
 
@@ -227,6 +228,13 @@ async function ensureGitignoreEntry(cwd, entry, heading = "# \u2550\u2550\u2550
 async function ensureEasyCodingSessionsIgnored(cwd) {
   return ensureGitignoreEntry(cwd, SESSIONS_GITIGNORE_ENTRY);
 }
+async function ensureHookBytecodeIgnored(cwd) {
+  return ensureGitignoreEntry(
+    cwd,
+    HOOK_BYTECODE_GITIGNORE_ENTRY,
+    "# \u2550\u2550\u2550 easy-coding-harness (auto-generated) \u2550\u2550\u2550\n# Python bytecode from hook scripts; do not commit"
+  );
+}
 
 // src/utils/install-manifest.ts
 import { createHash } from "crypto";
@@ -658,7 +666,6 @@ function createProjectInitTask(params) {
     context: {
       agents_installed: params.agents,
       cli_version: VERSION,
-      project_path: params.cwd,
       init_source: params.initSource ?? "fresh",
       ...params.legacyAssets ? { legacy_assets: params.legacyAssets } : {},
       ...params.legacyMissingHarnessFiles ? { legacy_missing_harness_files: params.legacyMissingHarnessFiles } : {}
@@ -679,7 +686,6 @@ async function writeProjectInitTask(cwd, agents, options = {}) {
   await writeTaskJson(
     getTaskJsonPath(cwd, PROJECT_INIT_TASK_ID),
     createProjectInitTask({
-      cwd,
       agents,
       initSource: options.initSource,
       legacyAssets: options.legacyAssets,
@@ -687,6 +693,15 @@ async function writeProjectInitTask(cwd, agents, options = {}) {
     })
   );
 }
+async function stripInitTaskProjectPath(cwd) {
+  const filePath = getTaskJsonPath(cwd, PROJECT_INIT_TASK_ID);
+  if (!await pathExists(filePath)) return false;
+  const task = await readTaskJson(filePath);
+  if (!task.context || !("project_path" in task.context)) return false;
+  task.context.project_path = void 0;
+  await writeTaskJson(filePath, task);
+  return true;
+}
 async function setPendingInitSince(cwd, version) {
   const filePath = getTaskJsonPath(cwd, PROJECT_INIT_TASK_ID);
   if (!await pathExists(filePath)) return;
@@ -830,6 +845,7 @@ function jsonStringContent(value) {
 }
 var HOOK_LAUNCHER_PYTHON = [
   "import io,json,os,re,runpy,sys",
+  "sys.dont_write_bytecode=True",
   "from pathlib import Path",
   "payload=sys.stdin.read()",
   "try:",
@@ -1264,6 +1280,7 @@ async function installHarnessToDir(targetDir, platforms, ctx) {
     legacyMissingHarnessFiles: ctx.legacyMissingHarnessFiles
   });
   await ensureEasyCodingSessionsIgnored(targetDir);
+  await ensureHookBytecodeIgnored(targetDir);
   return artifacts;
 }
 function supermoduleConfigFromContext(ctx) {
@@ -1759,6 +1776,7 @@ async function addAgent(opts) {
         mode: "merge"
       });
       await ensureEasyCodingSessionsIgnored(target.dir);
+      await ensureHookBytecodeIgnored(target.dir);
       await addAgentsToConfig(target.configPath, toInstall);
       await setPendingInitSince(target.dir, VERSION);
       installedLabels.push(`${target.label}: ${toInstall.join(", ")}`);
@@ -2861,9 +2879,11 @@ async function upgrade(opts) {
       artifacts
     });
     await ensureEasyCodingSessionsIgnored(target.dir);
+    await ensureHookBytecodeIgnored(target.dir);
     await updateHarnessVersion(target.configPath, VERSION);
     await updateSupermoduleConfig(target.configPath, target.supermodule);
     await setPendingInitSince(target.dir, VERSION);
+    await stripInitTaskProjectPath(target.dir);
   }
   if (parentTopologyRefresh) {
     await refreshSupermoduleParent(