mbflash 1.2.1 → 1.2.3

package/README.md

@@ -3,9 +3,17 @@
 [![CI](https://github.com/tai/mbflash/actions/workflows/ci.yml/badge.svg)](https://github.com/tai/mbflash/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/mbflash.svg)](https://www.npmjs.com/package/mbflash)
 
-A dependency-free CLI for driving the micro:bit MakeCode editor over CDP:
-load TypeScript, commit it to Blocks, compile/download the `.hex`, and flash it
-by writing to the `MICROBIT` volume (no WebUSB pairing needed).
+![The Test5 project in the micro:bit MakeCode editor: blocks on the canvas and the micro:bit simulator, as seen by an agent-driven mbflash session](https://raw.githubusercontent.com/tai/mbflash/main/docs/makecode-test5.png)
+
+mbflash is a bridge between an AI coding agent and the micro:bit MakeCode
+editor. It connects an agentic coding workflow — where a model writes files on
+disk and runs commands — to the traditional text and block experience people
+actually use in MakeCode: an agent writes ordinary TypeScript, mbflash pushes it
+into a live editor tab, and the program reappears as Blocks.
+
+From there mbflash can compile and download the `.hex` and flash it by writing
+to the `MICROBIT` volume, so there is no WebUSB pairing step. The CLI itself is
+dependency-free and talks to the browser over CDP.
 
 ```sh
 mbflash main.ts
@@ -253,7 +261,7 @@ This repository is <https://github.com/tai/mbflash>.
 ```sh
 npm test
 npm publish
-git tag v1.2.1      # use the new version
+git tag v1.2.3      # use the new version
 git push origin main --tags
 ```
 

package/mbflash.mjs

@@ -20,7 +20,9 @@ if (nodeMajor < 22 || (nodeMajor === 22 && nodeMinor < 4) || typeof globalThis.W
   process.exit(1);
 }
 
-const VERSION = "1.2.0";
+const VERSION = JSON.parse(
+  fs.readFileSync(new URL("./package.json", import.meta.url), "utf8"),
+).version;
 const DEFAULT_HOST = "makecode.microbit.org";
 const DEFAULT_CDP = "127.0.0.1:9222";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mbflash",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Load, build, and flash micro:bit MakeCode projects over CDP",
   "type": "module",
   "bin": {