diff --git a/.agents/notes/proposed/architecture/2026-07-28-experimental-plugin-package-group.i18n.yaml b/.agents/notes/proposed/architecture/2026-07-28-experimental-plugin-package-group.i18n.yaml index 539b2dc0ab..ca65a8ac5b 100644 --- a/.agents/notes/proposed/architecture/2026-07-28-experimental-plugin-package-group.i18n.yaml +++ b/.agents/notes/proposed/architecture/2026-07-28-experimental-plugin-package-group.i18n.yaml @@ -2,5 +2,5 @@ # side as of the last confirmed-consistent state. Both languages carry equal authority; # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write .agents/notes/proposed/architecture/2026-07-28-experimental-plugin-package-group.md -2026-07-28-experimental-plugin-package-group.md: e0a17206bf4ffd424d6dd449023001fd48eb3260 -2026-07-28-experimental-plugin-package-group.zh.md: 1850e94c91908865c833b7dc1583460babbb32f1 +2026-07-28-experimental-plugin-package-group.md: e3c6f350bd8c8341e0da831159044e2f32e914f9 +2026-07-28-experimental-plugin-package-group.zh.md: f92683316e1acbaf01d903e8dda37801e4b3d238 diff --git a/.agents/notes/proposed/architecture/2026-07-28-experimental-plugin-package-group.md b/.agents/notes/proposed/architecture/2026-07-28-experimental-plugin-package-group.md index e0a17206bf..e3c6f350bd 100644 --- a/.agents/notes/proposed/architecture/2026-07-28-experimental-plugin-package-group.md +++ b/.agents/notes/proposed/architecture/2026-07-28-experimental-plugin-package-group.md @@ -12,6 +12,8 @@ The [package hierarchy](../../../../packages/README.md) groups plugins by produc Add `packages/experimental//` as the required home for Cordis plugin packages whose whole public contract is experimental. Package names remain `@deepseek-ai/dsh-`; promotion moves the package into its product-role group without renaming it. +The group is also the team's in-repository place to share prototypes: members can discover, run, review, and extend one another's work against the real plugin graph without implying product support. + Experimental packages carry no stability, compatibility, migration, or support promise: they may change APIs, configuration, or data, or disappear, without deprecation or migration. This status does not relax engineering standards; these packages retain the repository's type, test, security, documentation, lifecycle, and snapshot requirements. Non-experimental packages must not take runtime dependencies on them. Examples may use them; any other runtime dependent is itself experimental and belongs under `packages/experimental/`. Tests may use them as development dependencies. Examples include the pending `@deepseek-ai/dsh-tui-session-changes` `/diff` viewer and the `/btw` plugin; if accepted, they land in this group. A release never promotes a package implicitly. Promotion requires explicit review of the public contract, limitations, test evidence, and a named owner accepting stable-package obligations. diff --git a/.agents/notes/proposed/architecture/2026-07-28-experimental-plugin-package-group.zh.md b/.agents/notes/proposed/architecture/2026-07-28-experimental-plugin-package-group.zh.md index 1850e94c91..f92683316e 100644 --- a/.agents/notes/proposed/architecture/2026-07-28-experimental-plugin-package-group.zh.md +++ b/.agents/notes/proposed/architecture/2026-07-28-experimental-plugin-package-group.zh.md @@ -12,6 +12,8 @@ Status: proposed 新增 `packages/experimental//`，并要求公开契约整体处于实验阶段的 Cordis 插件包全部放在其中。包名仍为 `@deepseek-ai/dsh-`；提升为稳定插件时，只将包移入对应的产品角色分组，不对其重命名。 +该分组也是团队在仓库内共享原型的位置：成员可以基于真实插件图发现、运行、评审并扩展彼此的原型，但这不代表产品会提供支持。 + 实验性包不提供稳定性、兼容性、迁移或支持保证：其 API、配置和数据可以变更，包也可以移除，均不提供弃用期或迁移路径。实验性状态不表示降低工程标准；这些包仍须满足仓库对类型、测试、安全、文档、生命周期和快照的要求。非实验性包不得将其列为运行时依赖。示例包可以使用它们；其他任何运行时依赖方本身也必须是实验性包，并位于 `packages/experimental/` 下。测试可以将其用作开发依赖。 示例包括尚待完成的 `@deepseek-ai/dsh-tui-session-changes` `/diff` 查看器和 `/btw` 插件；如果获准合入，它们将直接进入该分组。发布不会自动将包提升为稳定状态。提升前必须明确评审其公开契约、限制和测试证据，并指定一名愿意承担稳定包义务的负责人。