Merge pull request #2490 from open-gsd/docs/2481-adr-1239-effort-axis

feat(#2481): add a negotiated effortSurface axis and wire invocation-time effort
2026-07-21 20:14:27 -04:00
parent 3878dbdf02 ecef1e1670
commit d39ca0c004
51 changed files with 863 additions and 100 deletions
--- a/capabilities/antigravity/capability.json
+++ b/capabilities/antigravity/capability.json
@@ -88,7 +88,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "go"
+      "runtime": "go",
+      "effortSurface": "undocumented"
    },
    "hostBehaviors": {
      "reviewerCli": true,
--- a/capabilities/augment/capability.json
+++ b/capabilities/augment/capability.json
@@ -101,7 +101,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "node"
+      "runtime": "node",
+      "effortSurface": "undocumented"
    }
  }
 }
--- a/capabilities/claude/capability.json
+++ b/capabilities/claude/capability.json
@@ -78,7 +78,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "node"
+      "runtime": "node",
+      "effortSurface": "argv"
    },
    "hostBehaviors": {
      "attributionSource": "settings-json-commit",
--- a/capabilities/cline/capability.json
+++ b/capabilities/cline/capability.json
@@ -55,7 +55,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "node"
+      "runtime": "node",
+      "effortSurface": "undocumented"
    },
    "hostBehaviors": {
      "reapplyCommand": "/gsd-update --reapply",
--- a/capabilities/codebuddy/capability.json
+++ b/capabilities/codebuddy/capability.json
@@ -102,7 +102,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "node"
+      "runtime": "node",
+      "effortSurface": "undocumented"
    },
    "hostBehaviors": {
      "reportCommandsDir": true
--- a/capabilities/codex/capability.json
+++ b/capabilities/codex/capability.json
@@ -71,7 +71,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "node"
+      "runtime": "node",
+      "effortSurface": "argv"
    },
    "hostBehaviors": {
      "reapplyCommand": "$gsd-update --reapply",
--- a/capabilities/copilot/capability.json
+++ b/capabilities/copilot/capability.json
@@ -81,7 +81,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "undocumented"
+      "runtime": "undocumented",
+      "effortSurface": "undocumented"
    },
    "hostBehaviors": {
      "reapplyCommand": "/gsd-update --reapply",
--- a/capabilities/cursor/capability.json
+++ b/capabilities/cursor/capability.json
@@ -97,7 +97,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "node"
+      "runtime": "node",
+      "effortSurface": "undocumented"
    },
    "hostBehaviors": {
      "reapplyCommand": "gsd-update --reapply (mention the skill name)",
--- a/capabilities/hermes/capability.json
+++ b/capabilities/hermes/capability.json
@@ -83,7 +83,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "python"
+      "runtime": "python",
+      "effortSurface": "undocumented"
    }
  }
 }
--- a/capabilities/kilo/capability.json
+++ b/capabilities/kilo/capability.json
@@ -88,7 +88,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "bun"
+      "runtime": "bun",
+      "effortSurface": "undocumented"
    },
    "hostBehaviors": {
      "reapplyCommand": "/gsd-update --reapply",
--- a/capabilities/kimi/capability.json
+++ b/capabilities/kimi/capability.json
@@ -74,7 +74,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "python"
+      "runtime": "python",
+      "effortSurface": "undocumented"
    },
    "hostBehaviors": {
      "reapplyCommand": "/skill:gsd-update --reapply",
--- a/capabilities/opencode/capability.json
+++ b/capabilities/opencode/capability.json
@@ -83,7 +83,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "bun"
+      "runtime": "bun",
+      "effortSurface": "argv"
    },
    "hostBehaviors": {
      "reapplyCommand": "/gsd-update --reapply",
--- a/capabilities/pi/capability.json
+++ b/capabilities/pi/capability.json
@@ -46,7 +46,8 @@
      "hookBus": "host",
      "stateIO": "session-log-append",
      "transport": "native-extension",
-      "runtime": "bun"
+      "runtime": "bun",
+      "effortSurface": "undocumented"
    },
    "hostBehaviors": {
      "nativePlugin": {
--- a/capabilities/qwen/capability.json
+++ b/capabilities/qwen/capability.json
@@ -86,7 +86,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "node"
+      "runtime": "node",
+      "effortSurface": "undocumented"
    },
    "hostBehaviors": {
      "skillPriorityFrontmatter": true,
--- a/capabilities/trae/capability.json
+++ b/capabilities/trae/capability.json
@@ -80,7 +80,8 @@
      "hookBus": "engine",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "node"
+      "runtime": "node",
+      "effortSurface": "undocumented"
    },
    "hostBehaviors": {
      "skipSharedHooksInstall": true,
--- a/capabilities/vscode/capability.json
+++ b/capabilities/vscode/capability.json
@@ -45,7 +45,8 @@
      "hookBus": "engine",
      "stateIO": "sandboxed-storage",
      "transport": "mcp",
-      "runtime": "sandboxed-web"
+      "runtime": "sandboxed-web",
+      "effortSurface": "undocumented"
    }
  }
 }
--- a/capabilities/windsurf/capability.json
+++ b/capabilities/windsurf/capability.json
@@ -73,7 +73,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "undocumented"
+      "runtime": "undocumented",
+      "effortSurface": "undocumented"
    },
    "hostBehaviors": {
      "skipSharedHooksInstall": true,
--- a/capabilities/zcode/capability.json
+++ b/capabilities/zcode/capability.json
@@ -96,7 +96,8 @@
      "hookBus": "host",
      "stateIO": "filesystem",
      "transport": "mcp",
-      "runtime": "electron"
+      "runtime": "electron",
+      "effortSurface": "undocumented"
    },
    "hostBehaviors": {
      "skipSharedHooksInstall": true