Files
hyperframes/skills
WaterrrForever 007664e25a fix(reverse): give agents the sign-in reason to say, and catch stale CLIs that know reverse (#7488)
* fix(reverse): give agents the sign-in reason to say, and catch stale CLIs that know reverse

- `reverse start`'s signed-out `next` now carries a sentence the agent can say as is
  (why HeyGen, and that the HyperFrames account is the HeyGen account), asks for it at
  the start of the sign-in message, and on remote terminals has the agent send the
  device link and code before it waits.
- references/start.md: same ordering, an example that fits both login routes, and no
  links to or quotes from the instructions themselves.
- An old global install that knows `reverse start` but predates `next` was never caught:
  agent runs get no update notice and no auto-install, so it stays frozen. The skill now
  also treats `_meta.updateAvailable: true` from `reverse start` as an old install and
  runs the rest with `npx -y hyperframes@latest`; every CLI that knows `reverse start`
  already reports that field.

* fix(reverse): send remote terminals straight to device sign-in, reason in every link message

- `reverse start` now knows when no browser can open (the check `auth login` uses, moved
  to attendedTerminal): `login_command` is `auth login --device` and `next` asks for one
  message with the reason, the link and the code. The two-step route (a refused browser
  login, then a bare follow-up with the code) is where the reason got lost.
- Every message that gives the sign-in link starts with the reason; agents say they are
  waiting rather than quoting the skill, and give no file paths.
- The out-of-date line for an old global install goes in the next message to the person.

* fix(reverse): flag an older global install that shadows npx, and pin the run's release

- installerDetection: `shadowingInstall` finds the older global `hyperframes` that a plain
  `npx hyperframes` runs instead of this npx copy (first on PATH outside the npx cache), with
  the command that moves it. `detectInstaller` takes the entry to classify.
- `reverse start` run through npx opens `next` with that line as words to say, signed in or
  not. Skill prose alone did not get agents to tell the person.
- Skill: a signed-out `reverse start` with no `reverse.next` is also an old install, which
  covers a cold update cache; the run pins the release `@latest` resolved to.
2026-11-10 11:26:45 +00:00
..