@flareum/mcp 0.2.0 → 0.2.1

package/README.md

@@ -23,6 +23,33 @@ The key is shown once and cannot be retrieved again. If you lose it, revoke it a
 
 ---
 
+## Updating
+
+`npx` caches what it downloaded, so it can keep running an old copy after a new one ships. To get
+the newest:
+
+```bash
+npx -y @flareum/mcp@latest --help
+```
+
+Naming `@latest` is what refreshes the cache. Then restart your editor session — a running MCP
+server keeps the version it started with.
+
+Check which version you are actually on:
+
+```bash
+npm view @flareum/mcp version   # the newest published
+npx -y @flareum/mcp@latest --version
+```
+
+If you installed it globally instead of through `npx`:
+
+```bash
+npm install -g @flareum/mcp@latest
+```
+
+---
+
 ## What your agent can do with it
 
 Ask in plain language — the agent picks the tool:
@@ -100,6 +127,7 @@ and it prints where it wrote (or why it could not) on stderr.
 | What you see | Cause |
 |---|---|
 | The server fails to connect / closes immediately | The package is not installed. Check `npx -y @flareum/mcp` resolves — if it 404s, it has not been published yet. |
+| A command the docs describe is not recognised | `npx` is running a cached older copy. Re-run it as `@latest` — see Updating. |
 | The agent types literal values anyway | The skill did not land. Look for `[flareum] skill written to …` in the MCP server's stderr. |
 | Values labelled with long ids instead of mode names | The Flareum server is older than the client. Restart it. |
 | `401` on every call | The key was revoked, or belongs to another project. Mint a new one. |

package/dist/cli.js

@@ -6,6 +6,8 @@ import { CONFIG_PATH, cliErrorReport, parseArgs, resolveConfig } from './config.
 import { pullReport, pullStyles } from './pull.js';
 import { DEFAULT_INTERVAL_MS, watchPublished, watchStartedReport } from './watch.js';
 const DEFAULT_OUT = 'src/styles/flareum';
+// Read rather than restated: a hardcoded version is wrong the moment `npm version` runs.
+const VERSION = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8')).version;
 const HELP = `flareum — read a Flareum project's design tokens
 
   flareum pull [--out <dir>] [--token pk_…] [--api <url>]
@@ -20,6 +22,16 @@ Mint one in the project's Connect screen in Flareum.`;
 const readConfigFile = async () => readFile(join(process.cwd(), CONFIG_PATH), 'utf8').then(JSON.parse).catch(() => null);
 const { command, flags } = parseArgs(process.argv.slice(2));
 const COMMANDS = ['pull', 'watch'];
+// Read from flags, not `command`: parseArgs takes every leading `--x` as a flag, so checking the
+// command alone printed the help instead.
+if (flags.version || command === '-v') {
+    console.log(VERSION);
+    process.exit(0);
+}
+if (flags.help || command === '-h') {
+    console.log(HELP);
+    process.exit(0);
+}
 if (!COMMANDS.includes(command)) {
     console.log(HELP);
     process.exit(command ? 1 : 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flareum/mcp",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Connect a coding agent to a Flareum project's design tokens.",
   "license": "MIT",
   "author": "Flareum",