waitspin 0.1.5 → 0.1.7

package/README.md

@@ -7,9 +7,9 @@ wait-state ads for verified developer surfaces.
 
 Run after `npm view waitspin version` succeeds in launch evidence:
 
-Before install, publisher registration, or Checkout, review:
+Before install, user registration, or Checkout, review:
 
-- Public API and agent docs: `https://waitspin.com/waitspin/docs`
+- Public API and agent docs: `https://waitspin.com/docs`
 - Agent markdown: `https://waitspin.com/.well-known/agents.md`
 - Terms: `https://waitspin.com/waitspin/terms`
 - Privacy: `https://waitspin.com/waitspin/privacy`
@@ -26,12 +26,16 @@ waitspin bid create --line "Your ad" --url https://example.com --price-per-block
 waitspin bid checkout CAMPAIGN_ID
 npx --yes waitspin init --email you@example.com --key-profile publisher-extension
 
+# First-class VS Code user path
+code --install-extension waitspin.waitspin-vscode
+# Then run "WaitSpin: Connect and earn" inside VS Code.
+
 # Advanced agent install for every detected supported target
 waitspin install --all --dry-run --api-key PASTE_PUBLISHER_EXTENSION_KEY --compose-existing
 waitspin install --all --api-key PASTE_PUBLISHER_EXTENSION_KEY --compose-existing
 waitspin status --all
 
-# Install for VS Code status-bar fallback
+# CLI fallback for VS Code Activity Bar/status-bar extension
 waitspin extension install --target vscode --api-key PASTE_PUBLISHER_EXTENSION_KEY
 waitspin extension status --target vscode
 
@@ -46,6 +50,10 @@ waitspin mimocode status
 # Or install for OpenCode TUI plugin slot
 waitspin opencode install --api-key PASTE_PUBLISHER_EXTENSION_KEY
 waitspin opencode status
+
+# Or install for Grok Code CLI footer
+waitspin grok install --api-key PASTE_PUBLISHER_EXTENSION_KEY
+waitspin grok status
 ```
 
 ## Commands
@@ -55,16 +63,18 @@ waitspin opencode status
 - `waitspin bids list` — list campaigns
 - `waitspin bid checkout CAMPAIGN_ID` — Stripe Checkout for blocks
 - `waitspin market` — public leaderboard
-- `waitspin wallet connect` — Stripe Connect Express onboarding
-- `waitspin wallet status` — publisher balance, payout, and Connect status
-- `waitspin wallet ledger` — publisher delivery ledger
+- `waitspin wallet connect --country US` — Stripe Connect Express onboarding
+- `waitspin wallet status` — user balance, payout, and Connect status
+- `waitspin wallet ledger` — user delivery ledger
 - `waitspin wallet payout --dry-run` — payout eligibility preview
-- `waitspin extension install --target vscode` — install the VS Code status-bar fallback
-- `waitspin extension status --target vscode` — inspect managed fallback lifecycle state
-- `waitspin extension uninstall --target vscode` — remove the managed fallback runtime and local state
-- `waitspin install --all --dry-run` — preview detected publisher targets without file changes
-- `waitspin install --all` — install every detected supported publisher target
-- `waitspin status --all` — aggregate lifecycle status for every publisher target
+- `code --install-extension waitspin.waitspin-vscode` — install the public VS Code Marketplace extension
+- `WaitSpin: Connect and earn` — connect the VS Code extension from inside the editor
+- `waitspin extension install --target vscode --api-key PASTE_PUBLISHER_EXTENSION_KEY` — advanced CLI fallback for VS Code extension setup
+- `waitspin extension status --target vscode` — inspect managed VS Code extension lifecycle state
+- `waitspin extension uninstall --target vscode` — remove the managed VS Code extension runtime and local state
+- `waitspin install --all --dry-run` — preview detected user surfaces without file changes
+- `waitspin install --all` — install every detected supported user surface
+- `waitspin status --all` — aggregate lifecycle status for every user surface
 - `waitspin claude-code install --compose-existing` — install the Claude Code statusline command
 - `waitspin claude-code status` — inspect managed Claude Code runtime state
 - `waitspin claude-code uninstall` — restore Claude Code statusline settings and remove managed local state
@@ -74,15 +84,20 @@ waitspin opencode status
 - `waitspin opencode install` — install the OpenCode TUI plugin slot
 - `waitspin opencode status` — inspect managed OpenCode runtime state
 - `waitspin opencode uninstall` — remove managed OpenCode runtime and plugin
+- `waitspin grok install` — install the Grok Code CLI footer surface
+- `waitspin grok status` — inspect managed Grok Code CLI runtime state
+- `waitspin grok uninstall` — restore Grok Code CLI and remove managed state
 
 API base: `https://api.waitspin.com`
 
-The public package installs four verified publisher targets: the VS Code
-status-bar fallback, the Claude Code statusline command, the MiMo Code shell
-hook, and the OpenCode TUI plugin slot. Claude Code support uses the official
-`statusLine.command` path and does not patch Claude Code internals. MiMo Code
-uses a bash hook that polls the API for sponsored messages. OpenCode uses its
-TUI `app_bottom` plugin slot.
+The public package installs five verified user earning surfaces: the VS Code
+Activity Bar/status-bar extension, the Claude Code statusline command, the MiMo
+Code shell hook, the OpenCode TUI plugin slot, and the Grok Code CLI footer.
+Claude Code support uses the official `statusLine.command` path and does not
+patch Claude Code internals. MiMo Code uses a bash hook that polls the API for
+sponsored messages. OpenCode uses its TUI `app_bottom` plugin slot. Grok Code
+CLI uses a managed text-asset footer patch with hash-backed backup/restore and
+does not patch native binaries.
 
 `waitspin install --all` is an advanced agent command for installing every
 detected supported target. It keeps explicit target commands as the canonical
@@ -99,12 +114,15 @@ Native spinner patches beyond supported status surfaces, account-credit
 redemption, cash refund self-service, and click billing are not public
 paid-launch capabilities yet.
 
-## Publisher credentials
+## User install credentials
 
-Use a publisher-extension key for publisher polling/events:
+Use an extension API key created with `--key-profile publisher-extension` for
+user install polling/events:
 
 ```bash
 npx waitspin init --email you@example.com --key-profile publisher-extension
+code --install-extension waitspin.waitspin-vscode
+# Then run "WaitSpin: Connect and earn" inside VS Code.
 npx waitspin install --all --dry-run --api-key PASTE_PUBLISHER_EXTENSION_KEY --compose-existing
 npx waitspin install --all --api-key PASTE_PUBLISHER_EXTENSION_KEY --compose-existing
 npx waitspin status --all
@@ -112,16 +130,18 @@ npx waitspin extension install --target vscode --api-key PASTE_PUBLISHER_EXTENSI
 npx waitspin claude-code install --api-key PASTE_PUBLISHER_EXTENSION_KEY --compose-existing
 npx waitspin mimocode install --api-key PASTE_PUBLISHER_EXTENSION_KEY
 npx waitspin opencode install --api-key PASTE_PUBLISHER_EXTENSION_KEY
+npx waitspin grok install --api-key PASTE_PUBLISHER_EXTENSION_KEY
 ```
 
-- `WAITSPIN_API_KEY` — temporary publisher-extension key for first activation
+- `WAITSPIN_API_KEY` — temporary extension API key for CLI fallback flows
 - `WAITSPIN_INSTALL_ID` — from `waitspin extension install` or `waitspin claude-code install`
 
-The VS Code extension migrates `waitspin.apiKey` from User settings into VS Code
-SecretStorage on activation. `WAITSPIN_API_KEY` is an env-only temporary
-fallback and is not persisted by the extension. Store `waitspin.installId` in
-User settings; do not store broad control keys or workspace-scoped credentials
-for normal publisher operation.
+The VS Code Marketplace extension should normally be connected through
+`WaitSpin: Connect and earn`, which stores the extension key in VS Code
+SecretStorage and stores the install ID in user-scoped extension state. The
+legacy `waitspin.apiKey` User setting is still migrated into SecretStorage for
+fallback/rotation, but normal user operation does not require copying
+install IDs or broad control keys into workspace settings.
 
 The Claude Code installer writes a managed statusline runtime/state under
 `~/.waitspin` and updates `~/.claude/settings.json` with a safe
@@ -136,6 +156,14 @@ The OpenCode installer writes a managed runtime/state under `~/.waitspin`,
 installs a TUI plugin under `~/.config/opencode/plugins`, and adds the managed
 entry to `~/.config/opencode/tui.json` so OpenCode mounts the `app_bottom` slot.
 
+The Grok Code CLI installer writes a managed runtime/state under `~/.waitspin`
+and patches the verified OpenTUI footer text asset with a hash-backed backup so
+uninstall can restore the original file.
+
+Cline VS Code extension installs are covered by the VS Code Activity Bar/status-bar extension target.
+Standalone Cline CLI is not a public install target until Cline exposes an
+official statusline/plugin surface.
+
 ## Release validation
 
 Before advertising the public `npx waitspin` path, release operators should run:
@@ -147,4 +175,5 @@ npm view waitspin version
 npx --yes waitspin --help
 npx --yes waitspin@latest mimocode status
 npx --yes waitspin@latest opencode status
+npx --yes waitspin@latest grok status
 ```

package/assets/waitspin-vscode/media/waitspin-activitybar.svg

@@ -0,0 +1,31 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-labelledby="title desc">
+  <title id="title">WaitSpin Orbit Symbol</title>
+  <desc id="desc">Broken white orbit ring with a geometric white W and a signal green dot.</desc>
+  <defs>
+    <style>
+      .orbit { fill: none; stroke: #fff; stroke-width: 4.25; stroke-linecap: butt; }
+      .mark { fill: #fff; }
+      .dot { fill: #b7e11d; }
+    </style>
+  </defs>
+  <path
+    class="orbit"
+    d="M23.48 18.86
+       A17 17 0 1 0 47.08 25.49"
+  />
+  <path
+    class="mark"
+    d="M22.8 28
+       L26.9 28
+       L29.95 35.05
+       L32 30.95
+       L34.05 35.05
+       L37.1 28
+       L41.2 28
+       L34.8 41.25
+       L32 36.05
+       L29.2 41.25
+       Z"
+  />
+  <circle class="dot" cx="45.95" cy="18.55" r="3.2"/>
+</svg>

package/assets/waitspin-vscode/media/waitspin-icon.svg

@@ -0,0 +1,94 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="5 48.9 100 92">
+<!-- SVG created with Arrow, by QuiverAI (https://quiver.ai) -->
+  <path d="m65.5 77.8v4h2.3v5.2h-1.2v5h-1.2v5h-0.9v3.5h-1v-1.5h-0.5v-4.5h-1.4v-6.4h-1.4v-5.9h-1.6v-4.4h-7v4.3h-1.7v6.1h-1.3v6.3h-1.2v4.5h-0.6v1.6h-1v-3.3h-0.8v-5.3h-1.2v-5.1h-1.1v-4.9h2.6v-4.2h-13.6v4.1h2.5v5h1.6v6.1h1.8v6.7h1.5v6.2h1.6v5.2h1.7v3.7h7.1v-3.3l1.5-0.1v-3.9h1.2v-5.3h1.3v-6l1.3-0.1v-2.3l0.7 0.1v2.4h1.2v6h1.2v5.2h1.3v3.9h1.5v3.6h7.2v-3.7h1.8v-5.4h1.5v-6.3h1.6v-6.7h1.9v-6h1.7v-4.9h2.5v-4.2z"/>
+  <polygon points="56.4 55.7 56.4 53.8 53.9 53.8 53.9 55.7 52.4 55.7 52.4 59.3 53.9 59.3 53.9 60.8 56.4 60.8 56.4 59.3 57.9 59.3 57.9 55.7"/>
+  <path d="m50.8 51.8h1.6-0.5v-1.1h6.4v2h1.9v1.9h1.6l-0.4-0.1v-1.8h-1.5v-1.8h-1.6v-1.7h-6.6v1.7h-1.9l0.1 1.8h-1.6v1.8h1.7z"/>
+  <path d="m50.8 61.9h-1.9l-0.7-0.1v-1.6h-1.4v-5.6l1.6-0.1v5.4z"/>
+  <path d="m60.2 61.8v-1.6l1.7-0.1-0.1-5.5h1.6v5.6h-1.5v1.7l-1.7-0.1z"/>
+  <path d="m51.9 63.7h6.4v1.7h-6.5z"/>
+  <path d="m58.3 61.9h1.9v1.7l-1.9 0.1z"/>
+  <path d="m49.9 61.9h2v1.8l-2-0.1z"/>
+  <rect x="41.1" y="54.1" width="1.9" height="1.9"/>
+  <rect x="37.1" y="57.5" width="2" height="1.9"/>
+  <rect x="67.4" y="54.1" width="1.9" height="1.9"/>
+  <rect x="71" y="57.5" width="1.9" height="1.9"/>
+  <rect x="91.4" y="76" width="1.9" height="1.8"/>
+  <rect x="94.9" y="79.6" width="1.9" height="1.9"/>
+  <rect x="16.6" y="75.9" width="1.9" height="1.8"/>
+  <rect x="13.5" y="79.6" width="1.9" height="1.9"/>
+  <path d="m20.3 57.8v1.8h-1.5v2.3h1.5v1.6h-1.5v2.1h1.4v1.6l-1.4 0.1v2h1.4v1.4h-1.4v2h1.5v2h13.5v-16.9zm12.4 15.6h-10.7v-14h10.7v1.8h-9.3v1.7h9.3z"/>
+  <rect x="23.4" y="64.8" width="3.1" height="1.8"/>
+  <rect x="28.2" y="64.8" width="3.2" height="1.8"/>
+  <rect x="23.4" y="67.8" width="3.1" height="1.7"/>
+  <rect x="28.2" y="67.8" width="3.2" height="1.7"/>
+  <rect x="23.4" y="70.6" width="3.2" height="1.6"/>
+  <rect x="28.2" y="70.6" width="3.2" height="1.6"/>
+  <path d="m76.7 66-1.3 1.1v2.1h1.3l0.1 1.4h-1.4v2.1h1.3l0.1 2h13.5v-16.9h-13.6v1.8h-1.4v2.2h1.5l-0.1 1.7h-1.3v2.1zm1.7-6.6h10.4v1.8h-9.2v1.7h9.3v10.5h-10.5z"/>
+  <rect x="79.6" y="64.8" width="3.1" height="1.8"/>
+  <rect x="84.3" y="64.8" width="3.3" height="1.8"/>
+  <rect x="79.6" y="67.8" width="3.1" height="1.7"/>
+  <rect x="84.3" y="67.8" width="3.3" height="1.7"/>
+  <rect x="79.6" y="70.6" width="3.1" height="1.6"/>
+  <rect x="84.3" y="70.6" width="3.3" height="1.6"/>
+  <path d="m20.6 113.5v1.9h-1.7v2.2h1.5v1.6h-1.5v2.2h1.4v1.5h-1.5v2h1.4l0.1 1.4-1.5 0.1v1.9h1.5v2h13.5v-16.8zm12 15.5h-10.7v-13.8h10.7v1.9h-9.3v1.6h9.3z"/>
+  <rect x="23.3" y="120.6" width="3.2" height="1.7"/>
+  <rect x="28.1" y="120.6" width="3.2" height="1.7"/>
+  <rect x="23.3" y="123.5" width="3.2" height="1.6"/>
+  <rect x="28.1" y="123.5" width="3.2" height="1.6"/>
+  <rect x="23.3" y="126.3" width="3.2" height="1.5"/>
+  <rect x="28.1" y="126.3" width="3.2" height="1.5"/>
+  <path d="m76.7 113.5v1.9h-1.4v2.2h1.4v1.5l-1.4 0.1v2.1l1.4 0.1v1.5h-1.4v2l1.4 0.1v1.3l-1.4 0.1v1.8l1.4 0.1 0.1 2h13.5v-16.8zm12.1 15.5h-10.5v-13.8h10.5v1.9h-9.3v1.6h9.3z"/>
+  <rect x="79.5" y="120.6" width="3.2" height="1.7"/>
+  <rect x="84.2" y="120.6" width="3.3" height="1.7"/>
+  <rect x="79.5" y="123.5" width="3.2" height="1.6"/>
+  <rect x="84.2" y="123.5" width="3.3" height="1.6"/>
+  <rect x="79.5" y="126.2" width="3.2" height="1.5"/>
+  <rect x="84.2" y="126.2" width="3.3" height="1.5"/>
+  <polygon points="16.5 92.6 16.5 90.6 13.3 90.6 13.3 92.6 11.6 92.6 11.6 96.5 13.3 96.5 13.3 98.4 16.3 98.4 16.3 96.5 18.1 96.5 18.1 92.6"/>
+  <path d="m10.9 86h7.7v1.7h-7.6z"/>
+  <path d="m18.6 87.5h2v1.9h-2z"/>
+  <path d="m20.5 89.3h1.8v2h-1.8z"/>
+  <path d="m22.2 91.3h1.9v6.4h-1.9z"/>
+  <path d="m20.6 97.6h1.7v1.9h-1.7z"/>
+  <path d="m18.6 99.5h2v1.8h-2z"/>
+  <path d="m11 101.2 7.7 0.1v1.6h-7.7z"/>
+  <path d="m9 99.5h2v1.8h-1.9z"/>
+  <path d="m7.6 97.6h1.7v2h-1.7z"/>
+  <path d="m5.8 91.3h1.8v6.4h-1.8z"/>
+  <path d="m7.6 89.3h1.7v2h-1.7z"/>
+  <path d="m9.1 87.5h1.9v1.9h-1.9z"/>
+  <polygon points="96.8 92.4 96.8 90.3 93.9 90.3 93.9 92.3 92.2 92.4 92.2 96.4 93.9 96.4 93.9 98.4 96.8 98.4 96.8 96.4 98.5 96.4 98.5 92.4"/>
+  <path d="m91.7 85.6h7.2v1.8h-7.2z"/>
+  <path d="m98.9 87.2h1.9v2h-1.8z"/>
+  <path d="m100.8 89.1h1.7v2.1h-1.7z"/>
+  <path d="m102.4 91.2h1.7v6.3h-1.7z"/>
+  <path d="m100.8 97.5h1.7v1.9h-1.7z"/>
+  <path d="m98.9 99.4h1.9v1.8h-1.9z"/>
+  <path d="m91.6 101.1 7.3 0.1v1.7h-7.3z"/>
+  <path d="m89.6 99.4h2v1.9h-2z"/>
+  <path d="m88 97.5h1.7v1.9h-1.8z"/>
+  <path d="m85.9 91.2h2v6.3h-2z"/>
+  <path d="m87.9 89.1h1.8v2.1h-1.8z"/>
+  <path d="m89.6 87.2h2v2h-2z"/>
+  <path d="m56.2 130.6v-1.8h-2.4v1.8h-1.5v3.7h1.5v1.7h2.5v-1.7h1.5v-3.7z"/>
+  <path d="m51.7 124.2h6.6v1.8h-6.6z"/>
+  <path d="m58.3 125.9h1.9v2h-1.9z"/>
+  <path d="m60.1 127.8h1.8v1.9h-1.7z"/>
+  <path d="m61.9 129.7h1.6v5.5h-1.6z"/>
+  <path d="m60.2 135.2h1.7v1.7h-1.7z"/>
+  <path d="m58.3 137h1.9v1.8h-1.8z"/>
+  <path d="m51.8 138.6h6.6v1.7h-6.6z"/>
+  <path d="m49.9 137h2.1v1.8h-2.1z"/>
+  <path d="m48.4 135.2h1.8v1.8l-1.8-0.1z"/>
+  <path d="m46.8 129.7h1.7v5.5h-1.7z"/>
+  <path d="m48.3 127.8h1.8l0.1 1.9h-1.9z"/>
+  <path d="m49.9 125.9h2v2h-2z"/>
+  <rect x="13.5" y="107.3" width="1.9" height="1.9"/>
+  <rect x="16.6" y="110.6" width="1.9" height="1.8"/>
+  <rect x="91.7" y="110.6" width="1.9" height="1.8"/>
+  <rect x="94.9" y="107.3" width="1.9" height="1.8"/>
+  <rect x="37.2" y="129.1" width="1.9" height="1.9"/>
+  <rect x="40.9" y="132.8" width="1.9" height="1.9"/>
+  <rect x="70.9" y="129.1" width="1.8" height="1.9"/>
+  <rect x="67.4" y="132.8" width="1.9" height="1.9"/>
+</svg>