@c4a/context-cli 0.7.20 → 0.7.23

package/README.md

@@ -20,18 +20,18 @@ an LLM itself.
 npm install -g @c4a/context-cli@latest
 context plugin install # global installation
 # Alternatively, install only in a repository:
-context plugin install --local /path/to/repo
+context plugin install --local /path/to/repo --agent auto-detect
 ```
 
-`--local <path>` requires an explicit path without global configuration changes. Omit `--agent` to detect Claude Code, Cursor and Codex executables on PATH (including `cursor-agent`), plus Cursor/Codex in standard macOS Applications directories. Only detected hosts are installed under the repository's `.claude`, `.cursor`, or `.agents`. If none are detected, only `.agents/skills` is installed with a user hint. Stale configuration directories are not detection evidence; discovery does not verify runtime loading. Omitting `--local` keeps global installation.
+`--local` requires explicit `--agent`: `claude`, `cursor`, `codex`, `all`, `auto-detect`, or `standalone`. The path is a repository root: explicit hosts install into `.claude`, `.cursor`, or `.agents` without detection. `all` installs all three. Only `auto-detect` checks existing `.claude`, `.cursor`, and `.agents` directories in the target repository, never PATH or installed desktop applications; it falls back to `.agents/skills` when none exist. `standalone` instead writes all skills directly to `<path>/skills`, with no commands or host subdirectory. All modes support `--dry-run` and preserve global configuration.
 
-Automatic mode accepts a repository root; paths ending in `.claude`, `.cursor`, or `.agents` use their parent as the root. Explicit `--agent` still uses the exact supplied host directory below; `--agent all` is not accepted with `--local`.
+Migration from 0.7.20: add `--agent auto-detect` to bare `--local`; for explicit hosts pass the repository root, not its host directory. Global installation is unchanged. Host detection does not verify runtime loading.
 
 | Command | Local layout |
 | --- | --- |
-| `context plugin install --local /path/to/repo/.claude --agent claude` | Public entries in `commands/`, other skills in `skills/`; internal skills receive `user-invocable: false`, without duplicate entry skills |
-| `context plugin install --local /path/to/repo/.cursor --agent cursor` | Bundled `c4a-*` commands plus other skills; hiding Providers from the command menu is not guaranteed |
-| `context plugin install --local /path/to/repo/.agents --agent codex` | All entries remain skills; bundled `agents/openai.yaml` policies are preserved; no unsupported `commands/` directory |
+| `context plugin install --local /path/to/repo --agent claude` | Public entries in `commands/`, other skills in `skills/`; internal skills receive `user-invocable: false`, without duplicate entry skills |
+| `context plugin install --local /path/to/repo --agent cursor` | Bundled `c4a-*` commands plus other skills; hiding Providers from the command menu is not guaranteed |
+| `context plugin install --local /path/to/repo --agent codex` | All entries remain skills; bundled `agents/openai.yaml` policies are preserved; no unsupported `commands/` directory |
 
 Local entries have no plugin namespace; the host must discover the destination. Use `--dry-run` to preview. Refresh only replaces unmodified managed content; unrelated files remain and conflicting/customized entries are rejected. Choose a fresh host directory when switching from a standalone installation to command entries, to avoid duplicates. `plugin status` still inspects global hosts only. Invocation metadata is not a CLI permission or security boundary.
 

package/README.zh-CN.md

@@ -16,18 +16,18 @@
 npm install -g @c4a/context-cli@latest
 context plugin install # 全局安装
 # 或者，只安装到仓库：
-context plugin install --local /path/to/repo
+context plugin install --local /path/to/repo --agent auto-detect
 ```
 
-`--local <路径>` 必须显式指定路径，不注册全局插件、不修改用户级配置。省略 `--agent` 时探测 PATH 中的 Claude Code、Cursor、Codex（Cursor 也检查 `cursor-agent`；macOS 另检查标准 Applications 目录中的 Cursor/Codex），安装检测到的宿主到仓库下的 `.claude`、`.cursor`、`.agents`。均未检测到时，仅安装 `.agents/skills` 并输出提示。不根据遗留配置目录判断已安装；探测不代表已验证宿主加载技能。
+`--local` 必须显式搭配 `--agent`：`claude`、`cursor`、`codex`、`all`、`auto-detect` 或 `standalone`。路径为仓库根；指定宿主直接写入对应 `.claude`、`.cursor`、`.agents` 子目录，不检测是否安装宿主。`all` 全装；只有 `auto-detect` 检测目标仓库已有的 `.claude`、`.cursor`、`.agents` 目录，不检测 PATH 或桌面应用；均不存在时兜底 `.agents/skills`。`standalone` 则直接写入 `<path>/skills`，不生成 commands 或宿主子目录。均支持 `--dry-run`，不改全局配置。
 
-自动模式传仓库根路径；若末尾为 `.claude`、`.cursor` 或 `.agents`，以其父目录为根，不嵌套宿主目录。显式指定单一 `--agent` 时仍以传入路径为精确目标，见下表（不接受 `--agent all`）。不传 `--local` 保持全局安装。
+从 0.7.20 迁移：裸 `--local` 补充 `--agent auto-detect`；指定宿主时传仓库根，不再传宿主目录。全局安装不变。自动探测不代表宿主已加载，安装后需刷新宿主。
 
 | 命令 | 局部目录与行为 |
 | --- | --- |
-| `context plugin install --local /path/to/repo/.claude --agent claude` | `commands/` 放公开入口；`skills/` 放其他技能，内部技能设置 `user-invocable: false`，不重复安装入口 Skill |
-| `context plugin install --local /path/to/repo/.cursor --agent cursor` | `commands/` 使用随包的 `c4a-*` 命令；`skills/` 放其他技能，不保证隐藏 Provider 的菜单入口 |
-| `context plugin install --local /path/to/repo/.agents --agent codex` | 全部入口保留为 skills，保留随包的 `agents/openai.yaml` 调用策略，不生成无效的 `commands/` |
+| `context plugin install --local /path/to/repo --agent claude` | `commands/` 放公开入口；`skills/` 放其他技能，内部技能设置 `user-invocable: false`，不重复安装入口 Skill |
+| `context plugin install --local /path/to/repo --agent cursor` | `commands/` 使用随包的 `c4a-*` 命令；`skills/` 放其他技能，不保证隐藏 Provider 的菜单入口 |
+| `context plugin install --local /path/to/repo --agent codex` | 全部入口保留为 skills，保留随包的 `agents/openai.yaml` 调用策略，不生成无效的 `commands/` |
 
 宿主必须支持发现目标位置。局部入口没有插件命名空间。`--dry-run` 只预览；重复安装仅刷新本命令管理且未被修改的内容，保留无关文件；同名自定义内容或本地修改会报冲突。已有通用 skills 目录切换为 command 宿主时，请选择新目录，避免重复入口。`plugin status` 仍只检查全局宿主状态。调用元数据控制宿主入口展示/自动调用，不是 CLI 权限或安全隔离。
 

package/cli.js

@@ -79504,7 +79504,7 @@ function productionPlanMarkdown(stage) {
     ...!stage.report_approved && stage.planning_complete ? [
       `If the user requests changes, edit ${productionAgentDirectory(stage.id)}/submissions/plan.yaml using ${join30(directory, "planning.schema.json")}.`,
       `Resubmit: context action complete-current --revision ${stage.id} --input ${productionAgentDirectory(stage.id)}/submissions/plan.yaml --format json`,
-      "Then present the updated report and wait for approval; an old report confirmation does not approve changed article goals.",
+      "Then present the updated report and apply context.gate.work_start_scope; an old decision does not approve changed article goals.",
       ""
     ] : [],
     ...stage.gaps.map((gap) => `- ${gap.scope}: ${gap.reason}`),
@@ -80697,7 +80697,7 @@ async function completeProductionSubmission(input) {
     if (!stage || stage.id !== input.stage)
       throw submissionStateError("stale-production-stage", "Task stage no longer exists. Start a new production run; do not reuse a stale submission.");
     if (!stage.report_approved)
-      throw submissionStateError("production-report-approval-required", "Present the planned report and wait for user feedback before submitting bulk writing.");
+      throw submissionStateError("production-report-approval-required", "Present the planned report and apply context.gate.work_start_scope before submitting bulk writing.");
     if (stage.delivery)
       throw submissionStateError("production-delivery-paused", "Writing is paused for delivery. Finish Review and build, or run context run --resume-writing --format json; existing task inputs remain valid.");
     if ((await readMaintenance(input.projectRoot)).active)
@@ -83457,8 +83457,8 @@ function renderAgents(projectName, language) {
       "",
       "## 工作区契约",
       "",
-      "版本以 package.json.version 为准。正式内容变化收尾时通过 context version inspect / record 同步递增版本并生成 changelog.yaml 和 CHANGELOG.md，具体说明由 Agent 根据 diff 和会话撰写。新增模块或扩大知识覆盖升 minor，普通修补、目录和正式状态变化升 patch；major 只由人工明确指定。.tmp 进度不算变化，build 只记录 hash。仅主协调者记录版本，不自动 commit 或发布。触发来源必填；触发用户优先使用会话中明确的飞书显示名，否则由 CLI 读取 Git 用户名。",
-      "版本差异使用 Git 比较正文、结构、资源、导航和模板；可通过 version inspect --base 指定交付 commit/tag。构建预览不锁定版本；复用版本前核对目标平台与 Git tag，已发布版本必须递增。无需维护根目录 Context 版本、构建或发布回执。",
+      "版本以 package.json.version 为准。正式内容变化收尾时通过 context version inspect / record 同步递增版本并生成 changelog.yaml 和 CHANGELOG.md，具体说明由 Agent 根据 diff 和会话撰写。新增模块或扩大知识覆盖升 minor，普通修补、目录和正式状态变化升 patch；major 只由人工明确指定。.tmp 进度不算变化，build 只记录 hash。仅主协调者记录版本；版本记录本身不提交或发布，后续交付按本次授权和已安装的分发技能执行。触发来源必填；触发用户优先使用会话中明确的飞书显示名，否则由 CLI 读取 Git 用户名。",
+      "版本差异使用 Git 比较正文、结构、资源、导航和模板；可通过 version inspect --base 指定交付 commit/tag。构建预览不锁定版本，已发布内容发生变化时必须递增版本。无需维护根目录 Context 版本、构建或发布回执。",
       "每个版本的 Changelog 详情不得超过 1500 字：标题、变更列表、触发来源说明及用户显示名的可见字符合计计数，含标点，不计协议字段名、版本号和日期。超出时由 Agent 在提交前合并同类变化、删除重复过程描述，压缩至上限内；保留主要变化、影响和触发来源，不直接截断，也不把一轮拆成多个版本规避限制。",
       "",
       "- 通过已安装的 Context Skill 开始或恢复工作；直接使用 CLI 时，从 `context status --format json` 开始。",
@@ -83503,8 +83503,8 @@ function renderAgents(projectName, language) {
     "",
     "## Workspace Contract",
     "",
-    "package.json.version is the workspace version. At formal-content completion, use context version inspect / record to increment SemVer and generate changelog.yaml and CHANGELOG.md together. Write descriptions from the diff and conversation. Added modules/coverage increment minor; repairs, navigation and persistent status changes increment patch. Major requires an explicit user instruction. Ignore .tmp progress; build only records hashes. The coordinator alone records versions, without automatic commits or publishing. Triggers are required; use an explicitly known conversational Lark display name, otherwise let CLI use Git user.name.",
-    "Compare bodies, structure, assets, navigation and templates using Git; version inspect --base selects a delivery commit/tag. Preview builds do not seal versions. Check the remote target and Git tags before amending; published versions must increase. No root Context version/build/publication receipts are required.",
+    "package.json.version is the workspace version. At formal-content completion, use context version inspect / record to increment SemVer and generate changelog.yaml and CHANGELOG.md together. Write descriptions from the diff and conversation. Added modules/coverage increment minor; repairs, navigation and persistent status changes increment patch. Major requires an explicit user instruction. Ignore .tmp progress; build only records hashes. The coordinator alone records versions; recording a version does not commit or publish, and later delivery follows this task's authorization and the installed distribution skill. Triggers are required; use an explicitly known conversational Lark display name, otherwise let CLI use Git user.name.",
+    "Compare bodies, structure, assets, navigation and templates using Git; version inspect --base selects a delivery commit/tag. Preview builds do not seal versions. Changes to already published content must increment the version. No root Context version/build/publication receipts are required.",
     "Each version's changelog details must total at most 1500 visible characters, including punctuation across the title, changes, trigger descriptions and user display name; exclude protocol keys, version and date. Before submission, compress longer entries by merging related changes and removing repeated process narration. Preserve the main changes, impact and triggers; never truncate blindly or split one iteration into multiple versions to evade the limit.",
     "",
     "- Start or resume through the installed Context Skill. When using the CLI directly, begin with `context status --format json`.",
@@ -93106,7 +93106,7 @@ async function productionWorkflowRoute(input) {
     revision,
     reason_code: resolved.reasonCode,
     availability: resolved.availability,
-    summary: report ? `Present the report and wait. After approval, write {stage: ${stage.id}, decision: approved} to ${path2}.` : writing ? "Read the issued task directories. Coordinate them sequentially unless this caller supports independent Agents; only the coordinator submits shared state." : repair ? "Add revision tasks for rejected articles using the Review feedback; accepted production responsibilities remain unchanged." : investigate ? `Review pending configured scopes: ${stage.pending_scopes.filter((scope2) => !stage.gaps.some((gap2) => gap2.scope === scope2)).join(", ")}. Check their relevance to the current request and existing approved content before assigning investigation. Submit supported article tasks and remaining pending_scopes; do not infer missing articles from this list or repeat accepted work. If the requested articles are already accepted, context run --deliver --format json enters their Review while retaining unrelated pending scopes.` : resolved.node === "resolve-production-gap" ? `Source availability gaps: ${stage.gaps.map((gap2) => `${gap2.scope}: ${gap2.reason}`).join("; ")}. These failures do not establish missing knowledge or a new investigation assignment. Identify which sources the current task actually depends on; report unrelated configured-source failures separately. Preserve the configuration. To review completed articles independently, use context run --deliver --format json; this retains pending scopes and does not approve or publish content. If these sources are required, use context source recovery-plan --format json and context source restore with explicit local or clone decisions before preparation.` : "Prepare the current stage's eligible task directories.",
+    summary: report ? `Present the report and apply context.gate.work_start_scope. After the applicable scope decision, write {stage: ${stage.id}, decision: approved} to ${path2}.` : writing ? "Read the issued task directories. Coordinate them sequentially unless this caller supports independent Agents; only the coordinator submits shared state." : repair ? "Add revision tasks for rejected articles using the Review feedback; accepted production responsibilities remain unchanged." : investigate ? `Review pending configured scopes: ${stage.pending_scopes.filter((scope2) => !stage.gaps.some((gap2) => gap2.scope === scope2)).join(", ")}. Check their relevance to the current request and existing approved content before assigning investigation. Submit supported article tasks and remaining pending_scopes; do not infer missing articles from this list or repeat accepted work. If the requested articles are already accepted, context run --deliver --format json enters their Review while retaining unrelated pending scopes.` : resolved.node === "resolve-production-gap" ? `Source availability gaps: ${stage.gaps.map((gap2) => `${gap2.scope}: ${gap2.reason}`).join("; ")}. These failures do not establish missing knowledge or a new investigation assignment. Identify which sources the current task actually depends on; report unrelated configured-source failures separately. Preserve the configuration. To review completed articles independently, use context run --deliver --format json; this retains pending scopes and does not approve or publish content. If these sources are required, use context source recovery-plan --format json and context source restore with explicit local or clone decisions before preparation.` : "Prepare the current stage's eligible task directories.",
     commands: report || prepare || writing || repair || investigate || gap ? [{
       command: command2,
       effect: "write",
@@ -98631,7 +98631,7 @@ function resolveDocsFetchPlan(requested, runner2) {
   }
   return capabilitiesPromise.then((capabilities) => {
     if (!capabilities.supportsDocFormat) {
-      throw new LarkCliError(`${LARK_BIN} docs +fetch does not support --doc-format xml; upgrade @larksuite/cli before capturing Lark sources`, 0, "");
+      throw new LarkCliError(`${LARK_BIN} docs +fetch does not support --doc-format xml; a compatible @larksuite/cli is required to capture Lark sources`, 0, "");
     }
     return { apiVersion: capabilities.apiVersion, docFormat: "xml" };
   });
@@ -98642,7 +98642,7 @@ function docsFetchFailureMessage(stderr, apiVersion) {
   const mentionsV2 = /api-version|--api-version|v2|deprecated|lark-cli update/iu.test(stderr);
   if (apiVersion === "v1" && mentionsV2) {
     return `${base}
-Detected docs API v2 guidance from lark-cli. Upgrade @larksuite/cli and run \`lark-cli update\`; newer docs +fetch supports \`--api-version v2\`.`;
+Detected docs API v2 guidance from lark-cli; a compatible CLI with \`--api-version v2\` is required.`;
   }
   return base;
 }
@@ -98707,7 +98707,7 @@ function extractDocsFetchContent(payload, requestedFormat) {
   const withTitle = (result) => title2 === undefined ? result : { ...result, title: title2 };
   if (markdown !== undefined) {
     if (requestedFormat === "xml") {
-      throw new LarkCliError(`${LARK_BIN} docs +fetch returned Markdown despite --doc-format xml; capture stopped because the response cannot provide auditable rich-block fidelity. Upgrade lark-cli and retry.`, 0, "");
+      throw new LarkCliError(`${LARK_BIN} docs +fetch returned Markdown despite --doc-format xml; capture stopped because the response cannot provide auditable rich-block fidelity. Use a compatible CLI and retry.`, 0, "");
     }
     return withTitle({ body: markdown, format: "markdown", recognizedShape: true });
   }
@@ -99038,7 +99038,7 @@ ${body2}`,
   };
 }
 var LARK_BIN = "lark-cli", MAX_FETCH_PAGES = 50, MAX_STRUCTURAL_FETCH_ATTEMPTS = 2, LarkCliNotInstalledError, LarkCliError, defaultRunner = (args, options) => new Promise((resolve8, reject) => {
-  const child = spawn4(LARK_BIN, args, {
+  const child = spawn4(process.env.CONTEXT_LARK_CLI_BIN?.trim() || LARK_BIN, args, {
     ...options?.cwd === undefined ? {} : { cwd: options.cwd },
     stdio: ["ignore", "pipe", "pipe"]
   });
@@ -99193,6 +99193,7 @@ function larkTarget(entry) {
 }
 function larkErrorRecovery(error, sourceName) {
   const message = error instanceof Error ? error.message : String(error);
+  const localCliRecovery = `Install @larksuite/cli in a private directory with \`npm install --prefix "$HOME/.cache/context/lark-cli" @larksuite/cli@latest\`, then rerun \`CONTEXT_LARK_CLI_BIN="$HOME/.cache/context/lark-cli/node_modules/.bin/lark-cli" context run capture:lark:${sourceName}\`. Keep this variable on subsequent Context commands that access Lark; do not replace the global lark-cli.`;
   const environmentIssue = detectExternalEnvironmentIssue(message);
   if (environmentIssue !== undefined) {
     return {
@@ -99207,13 +99208,13 @@ function larkErrorRecovery(error, sourceName) {
   if (error instanceof LarkCliNotInstalledError || /not installed|ENOENT/iu.test(message)) {
     return {
       reasonCode: "external.dependency-missing",
-      next: "Install lark-cli from https://github.com/larksuite/cli, then rerun capture"
+      next: localCliRecovery
     };
   }
   if (/does not support --doc-format|api-version|deprecated|unsupported tool version|tool version unsupported/iu.test(message)) {
     return {
       reasonCode: "external.tool-version-unsupported",
-      next: "Run lark-cli update, confirm docs +fetch --help lists --doc-format, then rerun capture"
+      next: localCliRecovery
     };
   }
   if (/empty|unsupported payload shape|not JSON|parse/iu.test(message)) {
@@ -100691,7 +100692,7 @@ var init_managedDocumentRename = __esm(() => {
 
 // src/cli.ts
 import { existsSync as existsSync36, realpathSync as realpathSync3 } from "node:fs";
-import { dirname as dirname50, join as join115 } from "node:path";
+import { dirname as dirname49, join as join115 } from "node:path";
 import { fileURLToPath as fileURLToPath11, pathToFileURL as pathToFileURL3 } from "node:url";
 
 // ../../node_modules/.bun/commander@11.1.0/node_modules/commander/esm.mjs
@@ -112690,50 +112691,33 @@ ${frontmatter2}${parts[3]}${content3.slice(parts[0].length)}`);
 init_cliFeedback();
 init_errors3();
 init_exitCode();
-import { access as access6, stat as stat11 } from "node:fs/promises";
-import { constants as constants7 } from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { basename as basename13, delimiter, dirname as dirname47, join as join112, resolve as resolve41 } from "node:path";
+import { lstat as lstat15 } from "node:fs/promises";
+import { join as join112, resolve as resolve41 } from "node:path";
 var HOST_DIRS = { claude: ".claude", cursor: ".cursor", codex: ".agents" };
-async function detectLocalAgent(agent) {
-  const commands = agent === "cursor" ? ["cursor", "cursor-agent"] : [agent];
-  for (const directory of (process.env.PATH ?? "").split(delimiter).filter(Boolean)) {
-    for (const command3 of commands) {
-      for (const suffix of process.platform === "win32" ? [".exe", ".cmd", ".bat", ""] : [""]) {
-        const file = join112(directory, command3 + suffix);
-        try {
-          if (!(await stat11(file)).isFile())
-            continue;
-          await access6(file, constants7.X_OK);
-          return true;
-        } catch {}
-      }
-    }
-  }
-  if (process.platform === "darwin") {
-    const app = { claude: "Claude.app", cursor: "Cursor.app", codex: "Codex.app" }[agent];
-    if (agent !== "claude") {
-      for (const directory of ["/Applications", join112(homedir2(), "Applications")]) {
-        try {
-          if ((await stat11(join112(directory, app))).isDirectory())
-            return true;
-        } catch {}
-      }
+async function detectLocalAgent(agent, repo) {
+  const path3 = join112(repo, HOST_DIRS[agent]);
+  try {
+    const entry = await lstat15(path3);
+    if (!entry.isDirectory() || entry.isSymbolicLink()) {
+      throw new ContextError(ExitCode.UserError, `Local host directory is not a regular directory: ${path3}`);
     }
+    return true;
+  } catch (error) {
+    if (error.code === "ENOENT")
+      return false;
+    throw error;
   }
-  return false;
 }
-async function installAutoLocalSkills(root2, path3, dryRun, detect = detectLocalAgent) {
+async function installAutoLocalSkills(root2, path3, dryRun, detect = detectLocalAgent, selectedAgent) {
   if (!path3.trim())
     throw new ContextError(ExitCode.UserError, "--local requires a non-empty repository path", {
       category: ErrorCategory.UserInputInvalid,
-      next: "Run context plugin install --local /path/to/repository."
+      next: "Run context plugin install --local /path/to/repository --agent auto-detect."
     });
-  const requested = resolve41(path3);
-  const repo = Object.values(HOST_DIRS).some((name3) => name3 === basename13(requested)) ? dirname47(requested) : requested;
+  const repo = resolve41(path3);
   const agents = [];
   for (const agent of ["claude", "cursor", "codex"]) {
-    if (await detect(agent))
+    if (selectedAgent ? selectedAgent === "all" || agent === selectedAgent : await detect(agent, repo))
       agents.push(agent);
   }
   const targets = agents.length ? agents.map((agent) => ({ agent, path: join112(repo, HOST_DIRS[agent]) })) : [{ path: join112(repo, ".agents") }];
@@ -112742,14 +112726,14 @@ async function installAutoLocalSkills(root2, path3, dryRun, detect = detectLocal
     previews.push(await installLocalSkills(root2, target.path, true, target.agent));
   const header = formatFeedback({
     symbol: agents.length ? "✓" : "⚠",
-    action: "detected",
+    action: selectedAgent ? "selected" : "detected",
     subject: "local agent targets",
-    headline: agents.length ? agents.join(", ") : "No supported agent detected",
+    headline: agents.length ? agents.join(", ") : "No supported host directory found",
     body: [
       `repository: ${repo}`,
       ...targets.map((target) => `${target.agent ?? "standalone"}: ${target.path}`),
-      ...!agents.length ? ["Installing only .agents/skills. Configure a supported host to read this directory, or rerun with an explicit --agent and its target path."] : [],
-      "Host discovery does not verify runtime skill loading; refresh the host after installation."
+      ...!agents.length ? ["Installing only .agents/skills. Configure a supported host to read this directory, or select an explicit --agent with the same repository root."] : [],
+      "Repository directory discovery does not verify runtime skill loading; refresh the host after installation."
     ]
   });
   if (dryRun)
@@ -112769,7 +112753,7 @@ init_cliFeedback();
 init_errors3();
 init_exitCode();
 import { existsSync as existsSync35 } from "node:fs";
-import { dirname as dirname49, join as join114, resolve as resolve42 } from "node:path";
+import { dirname as dirname48, join as join114, resolve as resolve42 } from "node:path";
 import { fileURLToPath as fileURLToPath10 } from "node:url";
 
 // src/project/pluginInstallTargets.ts
@@ -112779,8 +112763,8 @@ init_exitCode();
 import { execFile as execFile13 } from "node:child_process";
 import { existsSync as existsSync34 } from "node:fs";
 import { cp as cp3, mkdir as mkdir37, readdir as readdir30, readFile as readFile95, rename as rename10, rm as rm25, writeFile as writeFile29 } from "node:fs/promises";
-import { homedir as homedir3 } from "node:os";
-import { dirname as dirname48, join as join113 } from "node:path";
+import { homedir as homedir2 } from "node:os";
+import { dirname as dirname47, join as join113 } from "node:path";
 import { promisify as promisify13 } from "node:util";
 var execFileAsync7 = promisify13(execFile13);
 var MARKETPLACE_NAME = "c4a";
@@ -112834,23 +112818,23 @@ async function claudePluginInstalled(pluginId) {
   }
 }
 function codexHome() {
-  return process.env.CODEX_HOME?.trim() || join113(homedir3(), ".codex");
+  return process.env.CODEX_HOME?.trim() || join113(homedir2(), ".codex");
 }
 function claudePluginCacheRoot() {
   const explicitRoot = process.env[CLAUDE_PLUGIN_CACHE_ROOT_ENV2]?.trim();
   if (explicitRoot)
     return explicitRoot;
-  const home = process.env[CLAUDE_PLUGIN_CACHE_HOME_ENV2]?.trim() || homedir3();
+  const home = process.env[CLAUDE_PLUGIN_CACHE_HOME_ENV2]?.trim() || homedir2();
   return join113(home, ".claude", "plugins", "cache");
 }
 function sharedSkillsRoot() {
-  return process.env[SHARED_SKILLS_ROOT_ENV]?.trim() || join113(homedir3(), ".agents", "skills");
+  return process.env[SHARED_SKILLS_ROOT_ENV]?.trim() || join113(homedir2(), ".agents", "skills");
 }
 function claudeSkillsRoot() {
-  return process.env[CLAUDE_SKILLS_ROOT_ENV]?.trim() || join113(homedir3(), ".claude", "skills");
+  return process.env[CLAUDE_SKILLS_ROOT_ENV]?.trim() || join113(homedir2(), ".claude", "skills");
 }
 function cursorPluginRoot() {
-  return process.env[CURSOR_PLUGIN_ROOT_ENV]?.trim() || join113(homedir3(), ".cursor", "plugins", "local", PLUGIN_NAME);
+  return process.env[CURSOR_PLUGIN_ROOT_ENV]?.trim() || join113(homedir2(), ".cursor", "plugins", "local", PLUGIN_NAME);
 }
 function blockHeader(line) {
   const match = line.match(/^\s*\[([^\]]+)\]\s*$/u);
@@ -113089,7 +113073,7 @@ source = ${JSON.stringify(root2)}
 }
 async function ensureCodexPluginEnabled() {
   const configPath = join113(codexHome(), "config.toml");
-  await mkdir37(dirname48(configPath), { recursive: true });
+  await mkdir37(dirname47(configPath), { recursive: true });
   const current2 = await readFile95(configPath, "utf8").catch(() => "");
   const next2 = enableCodexPluginConfig(current2);
   if (next2 !== current2) {
@@ -113098,7 +113082,7 @@ async function ensureCodexPluginEnabled() {
 }
 async function ensureCodexLocalMarketplace(root2) {
   const configPath = join113(codexHome(), "config.toml");
-  await mkdir37(dirname48(configPath), { recursive: true });
+  await mkdir37(dirname47(configPath), { recursive: true });
   const current2 = await readFile95(configPath, "utf8").catch(() => "");
   const next2 = upsertCodexLocalMarketplaceConfig(current2, root2);
   if (next2 !== current2) {
@@ -113117,7 +113101,7 @@ function codexPluginCacheDir(version3) {
   return join113(codexHome(), "plugins", "cache", MARKETPLACE_NAME, PLUGIN_NAME, version3);
 }
 async function replaceDirectoryFromSource(source2, target) {
-  await mkdir37(dirname48(target), { recursive: true });
+  await mkdir37(dirname47(target), { recursive: true });
   const temporary = `${target}.tmp-${process.pid}-${Date.now()}`;
   const previous3 = `${target}.previous-${process.pid}-${Date.now()}`;
   await rm25(temporary, { recursive: true, force: true });
@@ -113283,10 +113267,10 @@ function pluginAgentOption(value) {
 }
 function packageCandidateDirs() {
   const dirs = [];
-  let dir = dirname49(fileURLToPath10(import.meta.url));
+  let dir = dirname48(fileURLToPath10(import.meta.url));
   for (let index2 = 0;index2 < 8; index2++) {
     dirs.push(dir);
-    const parent = dirname49(dir);
+    const parent = dirname48(dir);
     if (parent === dir)
       break;
     dir = parent;
@@ -113455,14 +113439,14 @@ function registerPluginCommands(program2) {
     const agent = pluginAgentOption(options.agent);
     process.stdout.write(formatPluginStatusResult(await runPluginStatusCommand({ agent })));
   });
-  plugin.command("install").description("Install globally by default, or copy standalone skills with --local <path>").option("--agent <agent>", "agent target: claude | codex | cursor | all", "all").option("--local <path>", "Auto-detect hosts under a repository; with --agent, use the exact host directory").option("--dry-run", "Preview installation without writing files or configuration").action(async (options, command3) => {
+  plugin.command("install").description("Install globally by default, or copy standalone skills with --local <path>").option("--agent <agent>", "agent target: claude | codex | cursor | all; local only: auto-detect | standalone", "all").option("--local <path>", "Repository root; install selected or detected hosts into their corresponding subdirectories").option("--dry-run", "Preview installation without writing files or configuration").action(async (options, command3) => {
     if (options.local !== undefined) {
-      const agent2 = command3.getOptionValueSource("agent") === "cli" ? pluginAgentOption(options.agent) : undefined;
-      if (agent2 === "all") {
-        throw new ContextError(ExitCode.UserError, "--local requires one --agent (claude, cursor or codex), or omit --agent for automatic detection.");
+      if (command3.getOptionValueSource("agent") !== "cli") {
+        throw new ContextError(ExitCode.UserError, "--local requires explicit --agent: claude, cursor, codex, all, auto-detect or standalone.");
       }
+      const agent2 = options.agent === "auto-detect" || options.agent === "standalone" ? options.agent : pluginAgentOption(options.agent);
       const { pluginsRoot } = await runPluginPathCommand();
-      process.stdout.write(agent2 ? await installLocalSkills(pluginsRoot, String(options.local), options.dryRun === true, agent2) : await installAutoLocalSkills(pluginsRoot, String(options.local), options.dryRun === true));
+      process.stdout.write(agent2 === "standalone" ? await installLocalSkills(pluginsRoot, String(options.local), options.dryRun === true) : await installAutoLocalSkills(pluginsRoot, String(options.local), options.dryRun === true, undefined, agent2 === "auto-detect" ? undefined : agent2));
       return;
     }
     const agent = pluginAgentOption(options.agent);
@@ -113550,7 +113534,7 @@ function inferErrorCategory(message) {
 }
 function readQuickstartPath() {
   try {
-    let dir = dirname50(fileURLToPath11(import.meta.url));
+    let dir = dirname49(fileURLToPath11(import.meta.url));
     for (let i2 = 0;i2 < 8; i2++) {
       const candidate = join115(dir, "docs", "quickstart.md");
       if (existsSync36(candidate))
@@ -113558,13 +113542,13 @@ function readQuickstartPath() {
       const pkg = join115(dir, "package.json");
       if (existsSync36(pkg))
         return candidate;
-      const parent = dirname50(dir);
+      const parent = dirname49(dir);
       if (parent === dir)
         break;
       dir = parent;
     }
   } catch {}
-  return join115(dirname50(fileURLToPath11(import.meta.url)), "docs", "quickstart.md");
+  return join115(dirname49(fileURLToPath11(import.meta.url)), "docs", "quickstart.md");
 }
 var GREEN = "\x1B[32m";
 var RESET = "\x1B[0m";