@sakanano-moe/agenthelm 6.13.1 → 6.14.0-rc.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/runtime/index.json +6 -6
- package/runtime/plugins/agent-pack/.codex-plugin/plugin.json +1 -1
- package/runtime/plugins/agent-pack/plugin.json +1 -1
- package/runtime/plugins/agent-pack/references/capability-config.md +10 -0
- package/runtime/plugins/agent-pack/references/check-opinion-migrate.en.md +31 -0
- package/runtime/plugins/agent-pack/references/check-opinion-migrate.md +31 -0
- package/runtime/plugins/agent-pack/references/dedupe-contract.en.md +27 -0
- package/runtime/plugins/agent-pack/references/dedupe-contract.md +27 -0
- package/runtime/plugins/agent-pack/references/inventory-contract.en.md +83 -0
- package/runtime/plugins/agent-pack/references/inventory-contract.md +83 -0
- package/runtime/plugins/agent-pack/references/nudge.en.md +10 -2
- package/runtime/plugins/agent-pack/references/nudge.md +10 -2
- package/runtime/plugins/agent-pack/references/relocate-contract.en.md +41 -0
- package/runtime/plugins/agent-pack/references/relocate-contract.md +41 -0
- package/runtime/plugins/agent-pack/runtime/agent_pack_claude.py +572 -30
- package/runtime/plugins/agent-pack/runtime/agent_pack_clients.py +233 -0
- package/runtime/plugins/agent-pack/runtime/agent_pack_config.py +112 -4
- package/runtime/plugins/agent-pack/runtime/agent_pack_dedupe.py +502 -0
- package/runtime/plugins/agent-pack/runtime/agent_pack_desktop.py +92 -0
- package/runtime/plugins/agent-pack/runtime/agent_pack_ext_common.py +251 -0
- package/runtime/plugins/agent-pack/runtime/agent_pack_inventory.py +989 -0
- package/runtime/plugins/agent-pack/runtime/agent_pack_mcp_write.py +447 -0
- package/runtime/plugins/agent-pack/runtime/agent_pack_nudge.py +29 -4
- package/runtime/plugins/agent-pack/runtime/agent_pack_relocate.py +385 -0
- package/runtime/plugins/agent-pack/runtime/agent_pack_scope.py +233 -0
- package/runtime/plugins/agent-pack/runtime/agenthelm.py +183 -14
- package/runtime/plugins/agent-pack/runtime/locale/en.json +250 -1
- package/runtime/plugins/agent-pack/runtime/mcp_server.py +12 -0
- package/runtime/plugins/agent-pack/runtime/nudge_text.py +8 -2
- package/runtime/plugins/agent-pack/runtime/user_settings.py +2 -1
- package/runtime/plugins/agent-pack/skills/agent-pack/SKILL.md +15 -0
- package/runtime/plugins/agents-init/.codex-plugin/plugin.json +1 -1
- package/runtime/plugins/agents-init/content.json +4 -2
- package/runtime/plugins/agents-init/plugin.json +1 -1
- package/runtime/plugins/agents-init/skills/agents-init/SKILL.md +2 -0
- package/runtime/plugins/agents-init/skills/agents-init/launcher.en.sh +93 -0
- package/runtime/plugins/agents-init/skills/agents-init/project.schema.json +27 -0
- package/runtime/plugins/agents-init/skills/agents-init/scripts/baseline.py +4 -1
- package/runtime/plugins/agents-init/skills/agents-init/scripts/init_project.py +24 -9
- package/runtime/plugins/agents-init/skills/agents-init/skill.json +1 -1
- package/runtime/plugins/opinion-manager/.codex-plugin/plugin.json +1 -1
- package/runtime/plugins/opinion-manager/catalog/README.md +3 -1
- package/runtime/plugins/opinion-manager/catalog/rules/om.align-requirements/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.assumptions-authority/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.batch-questions/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.bilingual-terms/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.calculations/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.chinese-response/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.clean-deliverable/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.complete-options/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.conclusion-first/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.concrete-titles/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.consistent-items/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.device-readable/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.editable-diagrams/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.evidence-inference/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.maintenance-chinese/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.maintenance-project-language/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.markdown-structure/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.portable-files/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.report-context/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.report-formats/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.report-review/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.response-brief/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.response-dense/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.rules-tools/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.semantic-wrap/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.solutions-proportional/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.solutions-three-level/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.tables-compact/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.tables-list-first/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.test-evidence/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/rules/om.versioned-files/versions/1.1.0.json +34 -0
- package/runtime/plugins/opinion-manager/catalog/templates/delivery-standard/compact-tables/versions/1.1.0.json +32 -0
- package/runtime/plugins/opinion-manager/catalog/templates/delivery-standard/list-first/versions/1.1.0.json +32 -0
- package/runtime/plugins/opinion-manager/catalog/templates/development-standard/chinese-maintenance/versions/1.1.0.json +26 -0
- package/runtime/plugins/opinion-manager/catalog/templates/development-standard/project-language/versions/1.1.0.json +26 -0
- package/runtime/plugins/opinion-manager/catalog/templates/response-style/brief-chinese/versions/1.1.0.json +30 -0
- package/runtime/plugins/opinion-manager/catalog/templates/response-style/dense-chinese/versions/1.1.0.json +30 -0
- package/runtime/plugins/opinion-manager/catalog/templates/scenario/concise-project/versions/1.1.0.json +181 -0
- package/runtime/plugins/opinion-manager/catalog/templates/scenario/reviewed-project/versions/1.1.0.json +179 -0
- package/runtime/plugins/opinion-manager/catalog/templates/work-method/proportional/versions/1.1.0.json +31 -0
- package/runtime/plugins/opinion-manager/catalog/templates/work-method/three-level/versions/1.1.0.json +31 -0
- package/runtime/plugins/opinion-manager/content.json +44 -3
- package/runtime/plugins/opinion-manager/plugin.json +1 -1
- package/runtime/plugins/opinion-manager/references/inbox.en.md +25 -4
- package/runtime/plugins/opinion-manager/references/inbox.md +25 -4
- package/runtime/plugins/opinion-manager/references/profile.schema.json +19 -2
- package/runtime/plugins/opinion-manager/references/rule.schema.json +25 -3
- package/runtime/plugins/opinion-manager/references/versioned-template.schema.json +5 -4
- package/runtime/plugins/opinion-manager/references/versioning.md +89 -4
- package/runtime/plugins/opinion-manager/runtime/context.py +26 -19
- package/runtime/plugins/opinion-manager/runtime/inbox.py +400 -25
- package/runtime/plugins/opinion-manager/runtime/inbox_relations.py +106 -0
- package/runtime/plugins/opinion-manager/runtime/inbox_routes.py +132 -0
- package/runtime/plugins/opinion-manager/runtime/inbox_text.py +117 -11
- package/runtime/plugins/opinion-manager/runtime/lifecycle.py +35 -5
- package/runtime/plugins/opinion-manager/runtime/locale/en.json +137 -2
- package/runtime/plugins/opinion-manager/runtime/migrate.py +582 -0
- package/runtime/plugins/opinion-manager/runtime/opinion_manager.py +9 -4
- package/runtime/plugins/opinion-manager/runtime/rule_lines.py +247 -0
- package/runtime/plugins/opinion-manager/runtime/tags.py +217 -0
- package/runtime/plugins/opinion-manager/runtime/versioned.py +289 -41
- package/runtime/plugins/opinion-manager/skills/opinion-manager/SKILL.md +8 -7
- package/runtime/plugins/project-orchestrator/.codex-plugin/plugin.json +1 -1
- package/runtime/plugins/project-orchestrator/plugin.json +1 -1
- package/runtime/plugins/project-orchestrator/runtime/locale/en.json +305 -3
- package/runtime/plugins/project-orchestrator/runtime/private_paths.py +11 -1
- package/runtime/plugins/project-orchestrator/runtime/project_cli.py +101 -1
- package/runtime/plugins/project-orchestrator/runtime/project_demo.py +13 -1
- package/runtime/plugins/project-orchestrator/runtime/project_ext_actions.py +415 -0
- package/runtime/plugins/project-orchestrator/runtime/project_extensions.py +971 -0
- package/runtime/plugins/project-orchestrator/runtime/project_extensions_demo.py +86 -0
- package/runtime/plugins/project-orchestrator/runtime/project_menu.py +345 -2
- package/runtime/plugins/project-orchestrator/runtime/project_real.py +17 -1
- package/runtime/plugins/project-orchestrator/skills/project-orchestrator/SKILL.md +2 -0
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# `agenthelm relocate` 契约(schema_version 1)
|
|
2
|
+
|
|
3
|
+
English: [relocate-contract.en.md](relocate-contract.en.md)
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
agenthelm relocate <ref> --to <客户端>:<作用域> [--mode copy|link] [--project 目录] [--allow-widen] [--keep-source]
|
|
7
|
+
[--confirm-project-content] [--output json|text] [--lang zh|en|auto]
|
|
8
|
+
[--apply --expect-plan <plan_digest>]
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
处理 Skill 与 MCP(见下),Skill 的 `<ref>` 取 `agenthelm inventory` 的 `skills[].ref`(`skill:<名>@<客户端>:<作用域>`,主存储之外带 `#agents`)。**默认预览,零写入**;`--apply` 必须同时带预览给出的 `--expect-plan`,重新计算的 `plan_digest` 与之不同就拒绝(退出码 1,不写任何文件)。退出码:0 成功或预览无阻止项;1 有阻止项、指纹不一致或写入失败;2 参数错误。只支持 macOS 与 Linux。
|
|
12
|
+
|
|
13
|
+
## 目标存储
|
|
14
|
+
|
|
15
|
+
`claude:user` → `~/.claude/skills`;`claude:project` → `<项目>/.claude/skills`;`codex:user` → `~/.agents/skills`;`codex:project` 与 `cursor:project` → `<项目>/.agents/skills`;`cursor:user` → `~/.cursor/skills`。源已在目标客户端原生读取的存储里时,`plan.status` 为 `native`,零写入。
|
|
16
|
+
|
|
17
|
+
## 规则
|
|
18
|
+
|
|
19
|
+
- **绝不覆盖**:目标已有同名条目 → `blocked: target-exists-identical|target-exists-different`,不改名、不合并。
|
|
20
|
+
- **复制与链接**:跨作用域(家目录 ↔ 项目)一律复制(`--mode link` 被 `link-cross-scope` 阻止)。同一作用域内 `--mode link` 建相对符号链接,并隐含保留源。路径含 iCloud / Dropbox / OneDrive 等同步盘目录名(启发式)时降级为复制,`warnings` 含 `sync-folder-demoted`,最后一步 `promise` 为 `cannot-promise`。
|
|
21
|
+
- **源的处置**:默认校验通过后归档源到 `~/.agent-pack/recovery/<时间戳>-relocate-<名>/skills/<名>`(归档是移动,不是删除;目录布局与 `reconcile --retire-skill` 的恢复目录相同:`<时间戳>-<标签>/skills/<名>`,测试断言两者一致);`--keep-source` 复制并保留源。结果给出 `recovery_dir` 与手工恢复的单行 `mv` 步骤,本版没有 `restore` 命令。
|
|
22
|
+
- **写入顺序与回滚**:恢复目录(0700)→ 同目录临时名复制 → 读回校验(逐文件相对路径与内容摘要,`SKILL.md` 摘要与源一致)→ 重命名到位 → 归档源。任一步失败,只移除本次自己创建的目标,已归档的源移回原位,保留恢复目录。目录内指向目录外的符号链接 → `source-has-external-symlink`。
|
|
23
|
+
- **放宽**(项目级 → 用户级)需要 `--allow-widen`,`direction: "widen"`,文本预览在终端里标红。
|
|
24
|
+
- **进入项目仓库**(用户级 → 项目级):`confirmations` 列出「将进入项目目录,可能被提交到版本库」,`--apply` 还必须带 `--confirm-project-content`;许可证与是否含私有内容由使用者判断,工具不判断。
|
|
25
|
+
- 证据不是 `file` 的源(目录损坏、`SKILL.md` 过大)只读:`source-not-file-evidence`。其他种类:`unsupported-kind`。
|
|
26
|
+
|
|
27
|
+
## MCP 条目(`mcp:<名>@claude:<user|local|project>`)
|
|
28
|
+
|
|
29
|
+
`<ref>` 取 `mcps[].ref`;`--to claude:user|local|project`(`project` 即项目 `.mcp.json`)。同一套外壳(预览、`plan_digest`、`--expect-plan`、`blocked`、`promise`);写入复用 Claude sync 的 local 与 `.mcp.json` 读写助手,实现在 `agent_pack_mcp_write.py`。`plan.kind` 为 `mcp`,`source.managed` 表示 agent-pack 的 state 是否记录了归属,`plan.manual[]` 在未受管时给手工命令。
|
|
30
|
+
|
|
31
|
+
- **只复制,绝不覆盖**:目标同名条目 → `target-exists-identical|different`(比整条条目的哈希,只说相同或不同,不显示值)。`--mode link` → `link-unsupported`。
|
|
32
|
+
- **方向**:`user` 比 `local`/`project` 宽;放宽(→ `user`)需 `--allow-widen`,预览标红;`local` ↔ `project` 为 `same`。目标为 `project` 时 `--apply` 还须 `--confirm-project-content`(条目会进入版本库)。
|
|
33
|
+
- **进入 `.mcp.json` 的限制**:含内联密钥值 → `inline-secret-in-project-file`(改成 `${VAR}` 引用后再迁,工具不改写条目);含本机路径 → `machine-specific-in-project-file`。客户端 `project_write_supported` 为假 → `project-write-unsupported`;跨客户端 → `cross-client-unsupported`。
|
|
34
|
+
- **源的处置**:仅当本项目包名的 state 记录了该条目的归属(user 级看 `mcps`,local/project 看 `scopes.mcps`)才算**受管**。受管且未 `--keep-source`:目标写入与源移除在 `~/.claude.json` 里一次原子替换(`.mcp.json` 单独原子写),写前把整个原文件逐字节备份到恢复目录(`claude.json.before` / `project-mcp.json.before`),被移除条目的原 JSON 片段存入 `mcp/<名>@<作用域>.json`(均 0600,目录 0700,不打印),并更新 state(`mcps` 键仍只表示用户级)。任一步失败,所有改动过的文件按字节还原。**未受管**(手工装的、或属于别的包名):只复制到新位置,原位置不动,`plan.manual[]` 给 `claude mcp remove --scope <作用域> <名>` 与备份提示,`not_archivable_by_tool: true`。
|
|
35
|
+
- 恢复:本版没有 `restore` 命令;结果的 `restore[]` 给手工放回片段或整份还原备份的步骤(后者会丢掉之后对该文件的其他改动)。
|
|
36
|
+
- 输出、`relocate.json` 与计划里只有名字、作用域、路径与 16 位条目摘要,没有 env 值、headers 或令牌;只有 `claude.json.before` 与 `mcp/*.json` 含用户自己的值。
|
|
37
|
+
- 项目 Profile 的 `mcp_scope` 与目标作用域不一致时 `warnings` 含 `declaration-differs`(下次 sync 会按声明处理)。
|
|
38
|
+
|
|
39
|
+
## JSON
|
|
40
|
+
|
|
41
|
+
`{schema_version, command: "relocate", mode: "preview"|"apply", plan, applied}`。`plan`:`ref`、`kind`、`source`、`target`、`mode`、`retire_source`、`direction`(`narrow|same|widen`)、`status`(`ready|blocked|native`)、`steps[{id,action,promise,...}]`、`blocked[{code,message,...}]`、`warnings[{code,message}]`、`confirmations[{id,text,flag}]`、`recovery_base`、`plan_digest`、`next.apply`。`promise`:`certain`(文件级事实)、`best-effort`(需重启客户端或重新进入项目才能确认出现)、`cannot-promise`(工具只保证文件改动,不保证客户端行为)。`plan_digest` 与界面语言无关(不含 `message` / `text`)。`applied.status`:`applied|rolled-back|refused|native`。键只追加;输出不含文件内容,只有名字、路径(`~` 与 `<project>` 缩写)与摘要。
|