waitspin 0.1.4 → 0.1.6

package/README.md

@@ -46,6 +46,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
@@ -74,15 +78,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
+The public package installs five 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.
+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
@@ -112,6 +121,7 @@ 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
@@ -136,6 +146,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 fallback 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 +165,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/dist/cli.js

@@ -6,6 +6,7 @@ import { constants as fsConstants } from "node:fs";
 import { access, chmod, cp, mkdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
+import { experimentalAllInstallTargets, experimentalInstallTarget, isExperimentalCliTargetName, runExperimentalCliTargetInstall, runExperimentalCliTargetStatus, runExperimentalCliTargetUninstall, } from "./targets/experimental-cli.js";
 const DEFAULT_BASE_URL = process.env.WAITSPIN_BASE_URL?.trim() || "https://api.waitspin.com";
 const PRODUCTION_API_ORIGIN = "https://api.waitspin.com";
 const REQUEST_TIMEOUT_MS = 30_000;
@@ -50,11 +51,14 @@ export function usageText() {
         "  waitspin opencode install [--api-key KEY] [--dry-run]",
         "  waitspin opencode status",
         "  waitspin opencode uninstall [--dry-run]",
+        "  waitspin grok install [--api-key KEY] [--dry-run]",
+        "  waitspin grok status",
+        "  waitspin grok uninstall [--dry-run]",
         "",
         "Defaults:",
         "  API base: https://api.waitspin.com",
         "  API key: WAITSPIN_API_KEY env var",
-        "  Public publisher targets: status-bar-fallback, claude-code, mimocode, opencode",
+        "  Public publisher targets: status-bar-fallback, claude-code, mimocode, opencode, grok",
     ].join("\n") + "\n");
 }
 function usage(exitCode = 1) {
@@ -95,6 +99,7 @@ function parseArgs(argv) {
             key === "allow-dev-extension-assets" ||
             key === "confirm-test-transfer" ||
             key === "compose-existing" ||
+            key === "include-experimental" ||
             key === "all") {
             flags.set(key, ["true"]);
             continue;
@@ -607,6 +612,20 @@ async function registerPublisherInstall(input) {
                 "For developer-local acceptance only, use an explicit loopback API with --allow-dev-api-base.",
             ].join("\n"));
         }
+        if (isExperimentalCliTargetName(input.target) &&
+            error instanceof WaitSpinCliHttpError &&
+            error.status === 400 &&
+            /Invalid input|Validation error/.test(error.message)) {
+            throw new Error([
+                `WaitSpin API rejected target "${input.target}".`,
+                "Your local CLI supports this hidden experimental target, but the selected API base does not.",
+                "",
+                "For production:",
+                "  deploy the backend target allowlist, then rerun the explicit target install.",
+                "",
+                "For developer-local acceptance only, use an explicit loopback API with --allow-dev-api-base.",
+            ].join("\n"));
+        }
         throw error;
     }
     if (!body) {
@@ -2722,8 +2741,20 @@ async function preflightMiMoCode() {
 async function preflightOpenCode() {
     return executableVersion(OPENCODE_BIN_ENV, OPENCODE_DEFAULT_BIN, "OpenCode");
 }
-function allInstallTargets() {
-    return [
+function experimentalCliDeps() {
+    return {
+        booleanFlag,
+        optionalFlag,
+        resolveCredentialedBaseUrl,
+        requireApiKey,
+        registerPublisherInstall,
+        generateInstallId,
+        printJson,
+    };
+}
+function allInstallTargets(flags) {
+    const experimentalDeps = experimentalCliDeps();
+    const targets = [
         {
             target: "vscode",
             command: "waitspin extension install --target vscode",
@@ -2756,7 +2787,12 @@ function allInstallTargets() {
             install: runOpencodeInstall,
             status: () => runOpencodeStatus(),
         },
+        experimentalInstallTarget("grok", experimentalDeps),
     ];
+    if (booleanFlag(flags, "include-experimental")) {
+        targets.push(...experimentalAllInstallTargets(experimentalDeps).filter((target) => target.target !== "grok"));
+    }
+    return targets;
 }
 function safeErrorMessage(error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -2765,11 +2801,17 @@ function safeErrorMessage(error) {
         .replace(/npm_[A-Za-z0-9_-]+/g, "[REDACTED_NPM_TOKEN]");
 }
 function isNotDetectedError(message) {
-    return /not detected|not found|Unable to run Claude Code|Unsupported Claude Code version|ENOENT|spawn .*ENOENT|package not found/i.test(message);
+    if (/WaitSpin extension package not found|assets not found/i.test(message)) {
+        return false;
+    }
+    return /not detected|Unable to run Claude Code|Unsupported Claude Code version|ENOENT|spawn .*ENOENT|command not found|executable path/i.test(message);
 }
 function isConflictError(message) {
     return /statusLine|status line|conflict|override|already has|blocked/i.test(message);
 }
+function isUnsupportedTargetLayoutReason(reason) {
+    return /unsupported_patch_layout|unsupported_native_cli/i.test(reason);
+}
 function objectRecord(value) {
     return value && typeof value === "object" && !Array.isArray(value)
         ? value
@@ -2779,24 +2821,50 @@ function dryRunConflictReason(result) {
     const record = objectRecord(result);
     if (!record.would_fail)
         return null;
-    const reason = record.settings_blocked_reason ?? record.human_message;
+    if (typeof record.failure_kind === "string" &&
+        isUnsupportedTargetLayoutReason(record.failure_kind)) {
+        return typeof record.human_message === "string"
+            ? record.human_message
+            : record.failure_kind;
+    }
+    const reason = record.settings_blocked_reason ??
+        (record.failure_kind ? null : record.human_message);
+    if (!reason)
+        return null;
     return typeof reason === "string" ? reason : "target reported a conflict";
 }
+function dryRunFailureReason(result) {
+    const record = objectRecord(result);
+    if (!record.would_fail)
+        return null;
+    const reason = record.failure_kind ??
+        record.rollback_reason ??
+        record.human_message ??
+        "target dry-run reported failure";
+    return typeof reason === "string" ? reason : "target dry-run reported failure";
+}
 export async function runInstallAll(flags) {
     const dryRun = booleanFlag(flags, "dry-run");
+    const includeExperimental = booleanFlag(flags, "include-experimental");
+    if (includeExperimental && !dryRun) {
+        throw new Error("--include-experimental is only available with install --all --dry-run. Use explicit waitspin <target> install commands for hidden experimental targets.");
+    }
     const installed = [];
     const wouldInstall = [];
     const skippedNotDetected = [];
     const skippedConflict = [];
     const failedRollback = [];
-    for (const target of allInstallTargets()) {
+    for (const target of allInstallTargets(flags)) {
         let detail = null;
         try {
             detail = await target.preflight(flags);
         }
         catch (error) {
             const reason = safeErrorMessage(error);
-            skippedNotDetected.push({
+            const bucket = isNotDetectedError(reason)
+                ? skippedNotDetected
+                : failedRollback;
+            bucket.push({
                 target: target.target,
                 command: target.command,
                 reason,
@@ -2816,6 +2884,17 @@ export async function runInstallAll(flags) {
                 });
                 continue;
             }
+            const failureReason = dryRunFailureReason(result);
+            if (failureReason) {
+                failedRollback.push({
+                    target: target.target,
+                    command: target.command,
+                    reason: failureReason,
+                    detail,
+                    result,
+                });
+                continue;
+            }
             const summary = {
                 target: target.target,
                 command: target.command,
@@ -2833,9 +2912,11 @@ export async function runInstallAll(flags) {
             const reason = safeErrorMessage(error);
             const bucket = isConflictError(reason)
                 ? skippedConflict
-                : isNotDetectedError(reason)
-                    ? skippedNotDetected
-                    : failedRollback;
+                : isUnsupportedTargetLayoutReason(reason)
+                    ? skippedConflict
+                    : isNotDetectedError(reason)
+                        ? skippedNotDetected
+                        : failedRollback;
             bucket.push({
                 target: target.target,
                 command: target.command,
@@ -2849,13 +2930,16 @@ export async function runInstallAll(flags) {
         command: "install --all",
         dry_run: dryRun,
         mode: "detected-targets",
+        include_experimental: includeExperimental,
         installed,
         would_install: wouldInstall,
         skipped_not_detected: skippedNotDetected,
         skipped_conflict: skippedConflict,
         failed_rollback: failedRollback,
         next: "check_all_status",
-        next_command: "waitspin status --all",
+        next_command: includeExperimental
+            ? "waitspin status --all --include-experimental"
+            : "waitspin status --all",
         human_message: "Install-all is an advanced agent command. Explicit target commands remain the canonical debug path.",
     });
 }
@@ -2863,7 +2947,7 @@ export async function runStatusAll(flags) {
     const statuses = [];
     const installed = [];
     const failedStatus = [];
-    for (const target of allInstallTargets()) {
+    for (const target of allInstallTargets(flags)) {
         try {
             const result = await capturePrintedJson(() => target.status(flags));
             const summary = {
@@ -2887,6 +2971,7 @@ export async function runStatusAll(flags) {
     printJson({
         ok: failedStatus.length === 0,
         command: "status --all",
+        include_experimental: booleanFlag(flags, "include-experimental"),
         installed,
         statuses,
         failed_status: failedStatus,
@@ -2986,6 +3071,18 @@ export async function main(argv = process.argv.slice(2)) {
         await runOpencodeUninstall(flags);
         return;
     }
+    if (isExperimentalCliTargetName(command) && positionals[0] === "install") {
+        await runExperimentalCliTargetInstall(command, flags, experimentalCliDeps());
+        return;
+    }
+    if (isExperimentalCliTargetName(command) && positionals[0] === "status") {
+        await runExperimentalCliTargetStatus(command, experimentalCliDeps());
+        return;
+    }
+    if (isExperimentalCliTargetName(command) && positionals[0] === "uninstall") {
+        await runExperimentalCliTargetUninstall(command, flags, experimentalCliDeps());
+        return;
+    }
     usage();
 }
 function isDirectEntrypoint() {