Skip to content

插件接入 shadow-dev-cli:SessionStart hook 锁版本自举 #13

Description

@stack-wuh

Brief: shadow-docs/changes/20260917-feature-integrate-shadow-dev-cli/brief.md(分支基线:堆叠于 PR #12)

摘要

插件 6 个 skills 以裸 shadow-dev 命令为执行前提,但无机制保证命令存在。本变更将 CLI 独立仓库(stack-wuh/shadow-dev-cli v1.1.0)的版本化安装器 vendored 进插件,并以 SessionStart hook 锁版本自举:

  • package.json 新增 cliVersion pin(v1.1.0),hook 调 install --version <pin> --json 幂等就位
  • hook 永不阻塞会话:installer 失败仅警告;SHADOW_CLI_HOOK_DISABLE=1 可跳过(保护双仓开发)
  • 退役插件内 vendored CLI 副本(scripts/shadow-dev-cli/)与旧安装脚本、bin 字段
  • 文档改为自动安装说明 + 排障(~/.local/bin PATH、手动 install/rollback、main 开发通道)

任务

  1. 同步 CLI 仓库安装器替换插件旧版 scripts/install-cli.sh
  2. wrapper 测试先行(fixture --from 离线驱动:pin 就位秒退 / 精确装 / DISABLE 跳过 / 失败仅警告)
  3. 实现 hooks/bootstrap-cli.sh + hooks/hooks.json + plugin.json hooks 声明;删除 vendored 副本与 bin
  4. 更新 README.md、docs/cli-guide.md;端到端验证(首跑装出 shim、二跑秒退、shadow-dev help --json ok)

决策要点

  • 方案对比:B 运行时 curl 拉安装器(信任链/离线/测试皆劣)、C skills 惰性自举(确定性散失)均不采用
  • .shadow-dev/ 项目配置目录约定另案提案,本变更不实现

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions