@myna-sh/cli 0.2.0 → 0.3.0

package/README.md

@@ -14,6 +14,19 @@ Or run it without installing:
 npx @myna-sh/cli --help
 ```
 
+## Versioning
+
+`@myna-sh/cli`, `@myna-sh/sdk`, and `@myna-sh/mcp` are released in lockstep: the same version number always means the same commit. This CLI bundles the matching SDK, so installing them at the same version is all that compatibility requires.
+
+If a command in the [documentation](https://docs.myna.sh/cli/commands) is missing locally, compare versions before assuming a bug — docs.myna.sh is generated from the repository, which can be ahead of npm:
+
+```sh
+myna --version
+npm view @myna-sh/cli version
+```
+
+The API publishes what it supports at `GET /v1/meta` (public, unauthenticated), including the oldest client release it accepts. See [versioning and compatibility](https://docs.myna.sh/platform/compatibility).
+
 ## Authenticate
 
 ```sh
@@ -22,6 +35,22 @@ myna login
 
 The CLI opens `app.myna.sh/device`, where you sign in with GitHub and approve the one-time device code. The resulting credential is stored in the macOS Keychain when available, otherwise in a user-only configuration file.
 
+For automation, split the flow so nothing blocks on a human, and check a credential without guessing:
+
+```sh
+myna login start --json          # prints the device code and verification URL, exits
+myna login poll <device-code>    # add --wait to block until approved
+myna auth verify --json          # { credentialPresent, credentialValid, identity, ... }
+```
+
+## Diagnose problems
+
+```sh
+myna doctor --origin http://localhost:5173
+```
+
+One pass over CLI version, API reachability and compatibility, credential validity, key scopes, project access, schema drift, generated-type freshness, and browser origins. Each check reports a status and the command that fixes it; `--json` makes it a CI gate.
+
 ## Start a project
 
 ```sh

package/dist/main.d.ts

@@ -1,6 +1,8 @@
 import { Command } from 'commander';
 
+declare const VERSION: string;
+
 declare function buildProgram(): Command;
 declare function main(argv?: string[]): Promise<void>;
 
-export { buildProgram, main };
+export { VERSION, buildProgram, main };