feat(plugin): add progressive manual manifest contract - #48
Conversation
Signed-off-by: fmfsaisai <fmfsaisai@gmail.com>
|
| Filename | Overview |
|---|---|
| packages/plugin-protocol/src/manifest.ts | 新增 Manual 清单契约、字段约束、去重和跨字段路径冲突校验，未发现需要继续处理的问题。 |
| packages/plugin-protocol/src/tests/manifest.test.ts | 覆盖 Manual 常量、合法清单、字段边界、重复项及双向路径冲突。 |
| docs/plugin-protocol.md | 已记录 Manual 契约、制品校验职责及与声明文件和 locales 的双向路径隔离约束。 |
Reviews (3): Last reviewed commit: "fix(plugin): guard manual declared file ..." | Re-trigger Greptile
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: ae2ca8a6d7
ℹ️ About Codex in GitHub
Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".
Signed-off-by: fmfsaisai <fmfsaisai@gmail.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 9f147a7608
ℹ️ About Codex in GitHub
Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".
Signed-off-by: fmfsaisai <fmfsaisai@gmail.com>
1 participant
动机 / Motivation
为插件提供独立于能力 slot 的渐进披露手册索引，让 Cindy Host 后续可以通过
ghost_manual按需读取包内 Markdown 工作流，同时保持旧客户端安全降级。变更类型 / Change type
兼容性影响 / Compatibility impact
append-only：在 schema v2 增加可选顶层
manual.items[{dir,name,description}]，不进入slots，不构成权限。旧消费方会忽略未知顶层字段，插件其它能力继续可用；无manual的存量插件行为不变，因此不需要提升 manifest schema 版本。首个依赖手册才能正确工作的插件 Release 仍需声明对应minCindyVersion。约束：items 1–8；name 沿用 skill 的小写连字符规则且最长 64 字符；description 1–300 字符；每单元固定
MANUAL.md入口，单 Markdown 文件 64 KiB 上限。文件存在性、严格 UTF-8、普通文件与二进制拒收由制品打包/安装侧校验。「三件套」自查(协议变更必须全部勾选) / The "trio" (required for protocol changes)
docs/对应章节) / Docs (the relevantdocs/section)检查项 / Checklist
pnpm test与pnpm typecheck通过额外验证：
pnpm lint、pnpm format:check。