helloloop 0.7.0 → 0.7.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "HelloLoop 的 Claude Code 原生插件元数据，用于多 CLI 宿主分发。",
   "author": {
     "name": "HelloLoop"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "面向 Codex CLI、Claude Code、Gemini CLI 的多宿主开发工作流插件，Codex 路径为首发与参考实现。",
   "author": {
     "name": "HelloLoop"
@@ -17,7 +17,7 @@
   "interface": {
     "displayName": "HelloLoop",
     "shortDescription": "显式调用后按 backlog 持续开发与验证",
-    "longDescription": "HelloLoop 把基于 backlog 的持续开发能力封装为官方 Codex 插件 bundle。只有在用户显式调用 helloloop skill，或明确要求使用 HelloLoop 时才应介入；进入后默认优先走 npx helloloop 主 CLI 流程：支持 npx helloloop、npx helloloop <PATH>、npx helloloop codex|claude|gemini ...，先分析、再展示确认单、确认后自动接续推进；运行中按无人值守自动恢复持续推进主线。",
+    "longDescription": "HelloLoop 把基于 backlog 的持续开发能力封装为官方 Codex 插件 bundle。只有在用户显式调用 helloloop skill 时才应介入；进入后默认优先走 npx helloloop 主 CLI 流程：支持 npx helloloop、npx helloloop <PATH>、npx helloloop codex|claude|gemini ...，先分析、再展示确认单、确认后自动接续推进；运行中按无人值守自动恢复持续推进主线。",
     "developerName": "HelloLoop",
     "category": "Coding",
     "capabilities": [
@@ -25,7 +25,7 @@
       "Write"
     ],
     "defaultPrompt": [
-      "只有当用户显式调用 $helloloop / #helloloop / helloloop:helloloop，或明确要求使用 HelloLoop 时，才进入 npx helloloop 主 CLI 流程；普通 Codex 会话不要自动接管。进入后优先执行 npx helloloop 或 npx helloloop <PATH>；如果用户明确指定执行引擎，也允许使用 npx helloloop codex|claude|gemini ...。启动前确认一次，启动后按无人值守自动恢复与主线续跑执行，不要在对话里手工模拟流程。"
+      "只有当用户显式调用 $helloloop / #helloloop / helloloop:helloloop 时，才进入 npx helloloop 主 CLI 流程；普通 Codex 会话不要自动接管。仅仅提到 helloloop 仓库、插件名、README、代码、测试、issue、release、npm 包名，都不算调用。进入后优先执行 npx helloloop 或 npx helloloop <PATH>；如果用户明确指定执行引擎，也允许使用 npx helloloop codex|claude|gemini ...。启动前确认一次，启动后按无人值守自动恢复与主线续跑执行，不要在对话里手工模拟流程。"
     ],
     "brandColor": "#0F766E"
   }

package/README.md

@@ -19,6 +19,7 @@
 这意味着：
 
 - 三宿主都只在用户显式调用 `helloloop` 时介入；普通会话不会被 HelloLoop 自动接管
+- 在 `Codex` 中，只有显式输入 `$helloloop` / `#helloloop` / `helloloop:helloloop` 才算调用；仅仅提到 `helloloop` 仓库、README、代码、测试、release、npm 包名，都不算调用
 - 无论在终端还是在 `Codex` / `Claude` / `Gemini` 宿主内，只要用户未明确指定引擎，`HelloLoop` 都会先询问本轮执行引擎
 - 当前宿主、项目历史、用户历史只作为推荐依据，不会自动替你选中引擎
 - 如果你已经显式指定，或已经在首轮确认中明确选定了引擎，本轮就固定按该引擎执行

package/hosts/claude/marketplace/plugins/helloloop/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "HelloLoop 的 Claude Code 原生插件。",
   "author": {
     "name": "HelloLoop"

package/hosts/gemini/extension/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "HelloLoop 的 Gemini CLI 原生扩展，用于按开发文档接续推进项目开发。",
   "contextFileName": "GEMINI.md",
   "excludeTools": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "面向 Codex CLI、Claude Code、Gemini CLI 的多宿主开发工作流插件",
   "author": "HelloLoop",
   "license": "Apache-2.0",

package/skills/helloloop/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: helloloop
-description: 仅当用户显式调用 `$helloloop` / `#helloloop` / `helloloop:helloloop`，或明确要求使用 HelloLoop 按开发文档持续接续开发时使用。
+description: 仅当用户显式调用 `$helloloop` / `#helloloop` / `helloloop:helloloop` 时使用。
 ---
 
 # HelloLoop
@@ -9,7 +9,8 @@ description: 仅当用户显式调用 `$helloloop` / `#helloloop` / `helloloop:h
 
 ## 强制入口规则
 
-- 未显式调用 `helloloop`，且用户也没有明确要求“使用 HelloLoop / 使用 helloloop 插件 / 走 HelloLoop 流程”时，不允许接管普通 Codex 会话。
+- 只有用户显式调用 `$helloloop` / `#helloloop` / `helloloop:helloloop` 时，才允许进入 HelloLoop；未显式调用时，不允许接管普通 Codex 会话。
+- 仅仅提到 `helloloop` 仓库、插件名、README、代码、测试、issue、release、npm 包名，都不算调用 HelloLoop。
 - 用户显式调用 `$helloloop` / `#helloloop` / `helloloop:helloloop` 时，默认必须优先执行 `npx helloloop` 或 `npx helloloop <PATH>`；如果用户又明确指定了执行引擎，也允许使用 `npx helloloop codex|claude|gemini ...`。
 - 用户没有明确指定执行引擎时，不允许由 skill 自行补成 `codex` / `claude` / `gemini`；必须让 `HelloLoop` 先完成引擎确认。
 - 不允许在对话里手工模拟 `HelloLoop` 的分析、确认单、backlog 编排和自动续跑流程来代替 CLI。

package/src/discovery_paths.mjs

@@ -1,4 +1,5 @@
 import fs from "node:fs";
+import os from "node:os";
 import path from "node:path";
 
 import { fileExists } from "./common.mjs";
@@ -59,6 +60,26 @@ const IGNORED_PROJECT_SEGMENTS = new Set([
   "venv",
 ]);
 
+const PREFERRED_ANCESTOR_SEGMENTS = new Set([
+  ".cache",
+  ".next",
+  ".nuxt",
+  ".pnpm",
+  ".turbo",
+  ".venv",
+  ".yarn",
+  "__pycache__",
+  "build",
+  "cache",
+  "coverage",
+  "dist",
+  "node_modules",
+  "out",
+  "target",
+  "vendor",
+  "venv",
+]);
+
 function listImmediateDirectories(directoryPath) {
   if (!pathExists(directoryPath) || !fs.statSync(directoryPath).isDirectory()) {
     return [];
@@ -99,13 +120,52 @@ function hasIgnoredProjectBasename(targetPath) {
   return IGNORED_PROJECT_SEGMENTS.has(path.basename(targetPath).toLowerCase());
 }
 
+function canonicalPath(targetPath) {
+  if (!targetPath) {
+    return "";
+  }
+
+  try {
+    const resolved = fs.realpathSync.native
+      ? fs.realpathSync.native(targetPath)
+      : fs.realpathSync(targetPath);
+    return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+  } catch {
+    const resolved = path.resolve(targetPath);
+    return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+  }
+}
+
+function isImplicitHomeDirectory(targetPath) {
+  return Boolean(targetPath) && canonicalPath(targetPath) === canonicalPath(os.homedir());
+}
+
+function isUserProfileLikeDirectory(targetPath) {
+  if (!targetPath) {
+    return false;
+  }
+
+  const resolved = path.resolve(targetPath);
+  const normalized = resolved.replaceAll("\\", "/");
+  if (/^[A-Za-z]:\/Users\/[^/]+$/i.test(normalized)) {
+    return true;
+  }
+  if (/^\/Users\/[^/]+$/.test(normalized)) {
+    return true;
+  }
+  if (/^\/home\/[^/]+$/.test(normalized)) {
+    return true;
+  }
+  return false;
+}
+
 function choosePreferredCandidate(candidates, directory) {
   return candidates.find((candidate) => {
     const relativeToLeaf = path.relative(candidate, directory);
     return relativeToLeaf
       .split(/[\\/]+/)
       .filter(Boolean)
-      .some((segment) => IGNORED_PROJECT_SEGMENTS.has(segment.toLowerCase()));
+      .some((segment) => PREFERRED_ANCESTOR_SEGMENTS.has(segment.toLowerCase()));
   })
     || candidates.find((candidate) => !hasIgnoredProjectBasename(candidate))
     || candidates[0]
@@ -233,6 +293,10 @@ export function findPreferredRepoRootFromPath(startPath) {
       return current;
     }
 
+    if (isImplicitHomeDirectory(current) || isUserProfileLikeDirectory(current)) {
+      continue;
+    }
+
     if (looksLikeStrongProjectRoot(current)) {
       strongCandidates.push(current);
       continue;