Skip to content

chore: promote the runtime surface at 1.0.12 - #14

Merged
vaibhavkumar-deriv merged 2 commits into
masterfrom
promote/runtime-surface-1-0-12
Oct 29, 2026
Merged

vaibhavkumar-deriv merged 2 commits into
masterfrom
promote/runtime-surface-1-0-12

Conversation

@vaibhavkumar-deriv

Copy link
Copy Markdown
Collaborator

This PR promotes the runtime surface from the private working repo by copying files in. It was raised after a human approved the reviewed manifest (publication gate 2). build-promotion-bundle.mjs builds the tree from the allowlist into an empty directory, so a path that is not on the allowlist never reaches the build. Every file in this branch is byte-identical to its source: 121 allowlisted paths and 4 .github/ scaffold files.

Version 1.0.10 → 1.0.12, lockstep across all six manifests. 1.0.11 was never released on its own, so its changes ship here.

What changes

  • Google Antigravity support:
    • mcp_config.json (new): the Antigravity MCP declaration, with mcpServers.deriv.serverUrl set to https://mcp-api-v2.deriv.com/mcp.
    • .antigravity-plugin/plugin.json (new): the Antigravity manifest, with:
      • displayName Deriv;
      • logo ./assets/logo.png;
      • three documentation-lookup suggestedPrompts;
      • the shared identity fields.
    • rules/deriv-api-conventions.md (new): the conventions rule for Antigravity, with trigger: always_on frontmatter. Its body is identical to rules/deriv-api-conventions.mdc.
  • Kimi support:
    • kimi.plugin.json (new): the Kimi manifest, with:
      • interface listing fields;
      • skills ./skills/;
      • an inline systemPrompt holding the rule body without its frontmatter;
      • an inline mcpServers.deriv {url}, because Kimi has no MCP file discovery.
  • README.md: new Antigravity and Kimi install sections, and the MCP section names the two new declarations.
  • SECURITY.md: two wording fixes. The server "is declared" at the plugin root instead of "its URL is declared". Only OpenAI, not Codex, discovers the root mcp.json.
  • .codex-plugin/plugin.json: the authorize negative review case now says the Deriv API reference has no authorize endpoint or request schema. This change is from 1.0.11.
  • Manifests: version is 1.0.12, and the Claude Code and Codex catalogue source.ref move to v1.0.12. Cursor keeps source: "./".
  • Unchanged: PRIVACY.md, .mcp.json, mcp.json, the bundled skills, rules/deriv-api-conventions.mdc, and the assets.

Surface checker

The first commit updates .github/workflows/verify-surface.mjs. The previous version rejects the four new paths as unexpected path outside the allowlist, so the checker has to land with the surface. The new version:

  • adds the four paths to ALLOW;
  • requires mcp_config.json, kimi.plugin.json, and .antigravity-plugin/plugin.json to be present;
  • pins serverUrl in mcp_config.json and url in kimi.plugin.json to the hosted MCP URL (MCP Antigravity pin, MCP Kimi pin);
  • rejects mcpServers on the Antigravity manifest, which would override mcp_config.json;
  • holds kimi.plugin.json and .antigravity-plugin/plugin.json in version lockstep;
  • reports a malformed manifest once, under its own host's label.

Because of that presence check, the new checker can't merge ahead of these files: on its own it would fail its CI with required file missing.

Manifest

125 paths = 121 allowlisted + 4 scaffold. 13 files change: 4 added, 9 modified, none deleted.

Gate Result
internal hostnames / repo names 0 matches
secrets / key material 0 matches
tooling / planning artefacts 0 matches
local-runtime remnants 0 matches
internal references 0 matches
private-only absence backstop none present

verify-surface.mjs passes locally on this branch: OK — 125 path(s). The hosted MCP build pin check (mcp-build-pin.mjs) prints OK against a captured production initialize (serverInfo.name: deriv-api).

Before merge: Antigravity and Kimi acceptance

Neither host has been install-tested. Every shape here comes from the hosts' published docs. Run these checks against this branch, and record each result in a comment here before merging:

  • agy plugin validate --strict passes.

  • agy plugin install <path> shows:

    • the hosted deriv tools;
    • the conventions rule;
    • every skill under skills/;
    • the listing fields (Deriv, the logo, and the suggested prompts).

    Record which manifest Antigravity read: the root plugin.json or .antigravity-plugin/plugin.json.

  • In the Antigravity App and the Antigravity IDE, not only the agy CLI, the installed plugin shows the hosted deriv tools, every skill under skills/, and the conventions rule.

  • Kimi Code CLI's /plugins install shows the deriv MCP server and the bundled skills, and a new session has the conventions systemPrompt loaded.

    Record whether Kimi strips YAML frontmatter from a systemPromptPath file. To check, point a scratch copy's systemPromptPath at rules/deriv-api-conventions.md and see whether the session prompt shows its trigger: always_on block.

  • On a Cursor-only machine, run Developer: Reload Window and confirm Cursor loads the conventions rule once as always-apply. Record whether the .md copy also appears.

After merge

In the same session, create the annotated tag v1.0.12 on the merge commit and the GitHub Release, so both catalogue refs resolve.

🤖 Generated with Claude Code

vaibhavkumar-deriv and others added 2 commits October 29, 2026 10:33
The 1.0.12 surface adds mcp_config.json, kimi.plugin.json,
.antigravity-plugin/plugin.json and rules/deriv-api-conventions.md, which
the previous checker rejects as outside the allowlist. The checker now
allows those paths, requires the two new MCP declarations and the
Antigravity manifest, pins both declarations to the hosted MCP URL, rejects
mcpServers on the Antigravity manifest, and holds the Kimi and Antigravity
manifests in version lockstep. A malformed manifest is now reported once,
under its own host's label.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

OpenSSF Scorecard

PackageVersionScoreDetails

Scanned Manifest Files

@vaibhavkumar-deriv
vaibhavkumar-deriv merged commit df76cab into master Oct 29, 2026
5 checks passed
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