Skip to content

[REQ-109][CODE] Route plugin cloud jobs through idempotent submit, cancel, and status contracts #1

Description

@jinjunnn

Covers

jinjunnn/alpha-work#13 AC1、AC3、AC4、AC5:Claude Code 插件作为薄适配器使用同一 submit/status/cancel 契约,稳定传递幂等键、真实取消结果和有界重试。

Boundary

插件 commands/skills 的 Alpha cloud-job client、版本化 contract dependency、credential purpose 选择、错误/终态映射、deterministic consumer tests 和文档。

Out of scope

  • 不在插件复制平台授权、调度、公平、计费或任务状态机。
  • 不接受 user/web token、无 purpose token、旧 job payload 或隐式 fallback。
  • 不把平台 secret、服务 credential 或原始 artifact 字节写入插件包、日志或 transcript。

Design notes and risks

  • 插件重试必须复用同一幂等键,避免 CLI/agent 自动重试重复执行。
  • cancel/status 只映射平台事实,不能在客户端伪造终态。
  • contract unknown future version 必须 fail closed,而不是静默降级。

Exit condition

Merged PR + repository deterministic checks green + documentation impact handled。插件生产命令到版本化 client 的 wiring test 通过;运行时矩阵归父项 VERIFY。

Parent

Refs jinjunnn/alpha-work#13(native sub-issue;PR 不得 Fixes 父需求)

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:integrationRepository, API, or external integrationarea:runtimeServices, jobs, infrastructure, or operationsarea:securitySecurity or access controltype:featureNew user or system capability

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions