Skip to content

docs(runtime-control): describe Node-executed plugin installs - #58

Closed
ObsisMc wants to merge 1 commit into
ora-space:mainfrom
ObsisMc:docs/103-runtime-control-plugin-executor
Closed

ObsisMc wants to merge 1 commit into
ora-space:mainfrom
ObsisMc:docs/103-runtime-control-plugin-executor

Conversation

@ObsisMc

@ObsisMc ObsisMc commented Oct 14, 2026

Copy link
Copy Markdown
Collaborator

docs/runtime-control.md / .en.md still said production has no plugin executor and reports executor_capability_unavailable. Since e878951 plugin installs run on the Node, matching the implemented specs decisions plugin-marketplace/20260928-node-executes-plugin-installs.md and cloud/plugin-marketplace/20260927-admin-selection-and-idle-maintenance.md D4.

Refs ora-space/circus#103

Changes (docs only)

Described against main 32d4231:

  • Pending reasons come from schedulePluginMaintenance: waiting_start / waiting_control / waiting_lifecycle / waiting_execution, plus legacy_selection_unverified.
  • Once a target is idle, the maintenance operation runs as one install_plugins / remove_plugins Node execution over the frozen plugin set.
  • Instances are written back only from the Node's per-item results (applyPluginResults). plugins_failed does not settle the step.
  • executor_capability_unavailable is now historical only: migration 0022 blocks legacy operations, legacy pending rows are recomputed on the next scan, and unavailableCount stays in the summary.
  • The Chinese evidence section no longer lists the plugin executor as closed, and the plugin_pending_test description matches what the test does.
  • The English heading "Deliberately unavailable capabilities" is renamed to match the Chinese "插件与仓库凭据". Nothing links to the old anchor.

No code, contract or test changes.

@EricWvi EricWvi left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

main 已合入 cloud#85:docs/ 按领域整体重建为中英双语,文档地图在 docs/README.md,旧的 docs/*.md 已经全部删除。同时 cloud#62 已合入迁移 0038_agent_workspace_blocked_deadline.sql。请先合并或 rebase 最新 main,再做以下适配:

  • 旧文档已删除:docs/runtime-control*.md 的修改请改到 docs/runtime/runtime-control.md 和 docs/runtime/runtime-control.en.md。插件由 Node 执行安装、等待原因(waiting_start、waiting_control、waiting_lifecycle、waiting_execution)这些内容,请先对照新文档和 docs/plugins/marketplace(.en).md,只补上仍然缺少、并且和当前代码一致的部分。
  • 文档规则见 AGENTS.md 的 Documentation 一节:中英两版同步修改;只写当前代码能核验的事实;接口字段以 api/openapi.json 为准;进度和验收记录写在 issue 里,不进仓库。

@ObsisMc

ObsisMc commented Oct 20, 2026

Copy link
Copy Markdown
Collaborator Author

Closing as superseded: after the docs rebuild in #85, docs/runtime/runtime-control(.en).md and docs/plugins/marketplace(.en).md on main already state that plugin installs and removals are executed by the Node, and no longer claim production reports executor_capability_unavailable. #81 keeps that wording. Nothing left to add here.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants