Claude Code 调用 gh 时，改走 memories run 注入凭证

flowchart TD
  A["主人在终端：memories sudo"] --> B["memories credential bind gh
--vault V --credential C --env GH_TOKEN
[--program PATH] [--deny 'auth token'] [--expires 8h]"]
  B --> C["CLI 在 PATH 里找 gh，解析成绝对路径
计算 SHA-256 指纹"]
  C --> D["显示：程序路径、指纹、凭证名、环境变量名、禁止的参数
主人输入 USE 确认"]
  D --> E["IPC 发送 RunBind"]
  E --> F{"服务端校验
sudo、vault 写权限、只接受 cli: 调用方
拒绝 MCP / 远程 / 无人值守 / 手机"}
  F -- 不通过 --> X1["拒绝并审计"]
  F -- 通过 --> G{"凭证类型
Credential，或者 Token 卡片下的凭证"}
  G -- 不是 --> X2["拒绝：不是凭证"]
  G -- 是 --> H["保存绑定
名称 gh → 路径、指纹、vault、凭证、
环境变量名、输出模式、禁止参数、过期时间"]
  H --> S{"绑定存在哪"}
  S --> I["审计 run.bind
只记名称、指纹、凭证 ID"]
  I --> J["提示：执行 memories hook install
把 gh 加进 Claude Code 的拦截列表"]
  class S,H pending
  classDef pending stroke:#b45309,stroke-width:2px,stroke-dasharray:6 4

flowchart TD
  A["Claude Code 准备执行 Bash：
gh pr list --state open"] --> B["PreToolUse hook：
memories hook claude-code --commands gh
从 stdin 读取工具调用 JSON"]
  B --> C{"命令里有没有用到拦截列表里的命令？
按 shell 规则切词，只看命令位置"}
  C -- 没有 --> P["不输出，原样放行"]
  C -- 有 --> D{"命令结构能安全改写吗"}
  D -- "含 $( ) / 反引号 / eval / sh -c 包了 gh" --> X1["deny
原因：请把 gh 单独写成一条命令"]
  D -- 能 --> E{"memories daemon 在运行、
已解锁、存在绑定 gh？"}
  E -- 未解锁或没有 daemon --> X2["deny
原因：请主人解锁 memories"]
  E -- 没有绑定 --> X3["deny
原因：请主人执行 credential bind gh"]
  E -- 正常 --> F["把命令位置上的 gh 替换成
memories run --binding gh --
其余文本、引号、管道保持原样"]
  F --> G{"改写后怎么交给 Claude Code
allow 还是 ask"}
  G --> H["输出 updatedInput
主人设置里的 deny / ask 规则仍然生效
Bash 执行改写后的命令"]
  class D,G pending
  classDef pending stroke:#b45309,stroke-width:2px,stroke-dasharray:6 4

flowchart TD
  A["memories run --binding gh -- pr list --state open"] --> B["CLI 发送 Run：binding=gh、args、
cwd = 当前目录"]
  B --> C{"调用方是 cli: 吗
MCP / 远程 / 无人值守 / 手机一律拒绝"}
  C -- 否 --> X1["拒绝并审计"]
  C -- 是 --> D{"已解锁？绑定存在且未过期？"}
  D -- 否 --> X2["拒绝：说明原因"]
  D -- 是 --> E{"授权方式"}
  E --> F{"参数命中禁止规则？
例如 auth token、auth status --show-token"}
  F -- 命中 --> X3["拒绝并审计 run.denied"]
  F -- 没命中 --> G{"程序当前指纹 == 绑定里的指纹？"}
  G -- 不一致 --> X4["拒绝：gh 已变更，请重新 bind"]
  G -- 一致 --> H["审计 credential.use
绑定名、参数个数、cwd"]
  H --> I["解密凭证，设置环境变量 GH_TOKEN
在 cwd 下启动 gh"]
  I --> J{"输出怎么处理"}
  J --> K["审计 credential.result：退出码"]
  K --> L["CLI 把 stdout / stderr 原样写出
并用 gh 的退出码退出"]
  class E,J pending
  classDef pending stroke:#b45309,stroke-width:2px,stroke-dasharray:6 4

flowchart TD
  A["Claude Code 准备执行：
gh pr merge 42"] --> B["hook 识别出 gh，命中一条 gate 规则"]
  B --> C{"memories 规则判断"}
  C -- "规则允许，例如 pr list / pr view" --> D["allow：按原命令执行，不注入凭证"]
  C -- "规则要求确认，例如 pr merge" --> E["ask：Claude Code 弹窗请主人确认"]
  C -- "规则禁止，例如 repo delete" --> F["deny：附上原因"]
  class C pending
  classDef pending stroke:#b45309,stroke-width:2px,stroke-dasharray:6 4