rainbo-cli 0.1.6 → 0.1.7

package/README.md

@@ -5,23 +5,64 @@ Rainbo command line tools for data migration workflows.
 ## Requirements
 
 - Node.js 16+
-- R with `Rscript` available on `PATH`
+- Rust toolchain for source development. End users installing from npm get a prebuilt binary.
 
 ## Install
 
 ```bash
 npm install -g rainbo-cli
-rainbo-cli --version
+rainbo-cli version
 ```
 
 ## Development
 
 ```bash
-Rscript bin/rainbo-cli.R --version
+cargo run --manifest-path rust/Cargo.toml -- --version
 npm run build:release
 node packaging/npm/run.js help
+npm run check:skills
 ```
 
+## Output
+
+Command output is structured for humans, scripts, and AI agents:
+
+```bash
+rainbo-cli version                 # JSON envelope on stdout
+rainbo-cli version --format pretty # Human-readable output
+```
+
+Successful JSON output uses:
+
+```json
+{"ok":true,"data":{...}}
+```
+
+Errors are written to stderr:
+
+```json
+{"ok":false,"error":{"type":"validation","subtype":"invalid_argument","message":"..."}}
+```
+
+## Update
+
+```bash
+rainbo-cli update --check
+rainbo-cli update
+rainbo-cli update --force
+```
+
+`update --check` only reports status. `update` detects npm installations,
+runs `npm install -g rainbo-cli@<latest>` when auto-update is available,
+verifies the new binary, and syncs repository skills with:
+
+```bash
+npx skills add work2a/rainbo-cli -y -g
+```
+
+If automatic update is unavailable, the JSON action is `manual_required` and
+the response includes release and changelog URLs.
+
 ## Release
 
 1. Update `package.json` version.
@@ -38,12 +79,25 @@ archives and publish the npm wrapper package.
 Publishing uses npm Trusted Publishing (OIDC) from GitHub Actions. No long-lived
 `NPM_TOKEN` secret is required.
 
+## Skills
+
+Repository skills live in `skills/`. They can be installed from the repository:
+
+```bash
+npx skills add work2a/rainbo-cli#main -y -g
+```
+
+Pull requests publish a preview npm package with `pkg.pr.new` and comment with
+both the CLI update command and the matching skill install command.
+
 ## Project layout
 
 ```text
-bin/                 Rscript entrypoint used by source and release archives
-R/rainbo_cli/        CLI command, version, output, and update logic
+rust/               Rust CLI implementation
 packaging/npm/       npm postinstall downloader and bin launcher
 tools/release/       release archive builder and tag helper
+skills/              Rainbo skills installable with `npx skills add`
+skill-template/      Template for new Rainbo skills
+scripts/             PR preview packaging and skill format checks
 .github/workflows/  GitHub Release + npm Trusted Publishing workflow
 ```

package/checksums.txt

@@ -1,6 +1,6 @@
-1eefc9876d83642be4a2326447fc1cd1cdc2147b5c968efe3a7d954b5c990346  rainbo-cli-0.1.6-darwin-amd64.tar.gz
-50d9bdceae09a3b91d5faac0c3766e07f60b66cf9d25aae31c21ef9dfb8674db  rainbo-cli-0.1.6-darwin-arm64.tar.gz
-2bd8eaaa8db300fe7366a84b551e68a5bb52567b34eb33831d237d0548e866b5  rainbo-cli-0.1.6-linux-amd64.tar.gz
-fd6aa48c8af7bef44e1cde5118921f495666bd54c37e2f70de61c71e2cc42634  rainbo-cli-0.1.6-linux-arm64.tar.gz
-4141becb64dfbc4229d6969a08c2fb83566af8eb96c012717156cbf8c2f6d8e3  rainbo-cli-0.1.6-windows-amd64.zip
-4141becb64dfbc4229d6969a08c2fb83566af8eb96c012717156cbf8c2f6d8e3  rainbo-cli-0.1.6-windows-arm64.zip
+3ed156f93253d1aa1f33c8d4551d397ca623fed93a4bbc59da0030779430e15b  rainbo-cli-0.1.7-darwin-amd64.tar.gz
+37e7cc7c758996b05208c8464fee05b8160a1e4bfc845f4035cbc939855903b0  rainbo-cli-0.1.7-darwin-arm64.tar.gz
+4b21440ba1919bbfaf35759e0596e9072dab937bf70f79f72122e681f897bd30  rainbo-cli-0.1.7-linux-amd64.tar.gz
+8842f49579994fe08cf273fd1f0a3ed436886087337c32810c683820c94c5f92  rainbo-cli-0.1.7-linux-arm64.tar.gz
+44779d87de1f1fb5018f69a4ed021162531f4cf99e3de491d2da8747cf370652  rainbo-cli-0.1.7-windows-amd64.zip
+691d327c1cbbd4ef1bead22c5561a762890f860d73fd1899c6cda6f7ce13c3d0  rainbo-cli-0.1.7-windows-arm64.zip

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "rainbo-cli",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Rainbo command line tools for data migration workflows",
   "bin": {
     "rainbo-cli": "packaging/npm/run.js"
   },
   "scripts": {
     "build:release": "bash tools/release/build-release.sh",
+    "build:pkg-pr-new": "bash scripts/build-pkg-pr-new.sh",
+    "check:skills": "node scripts/skill-format-check/index.js",
     "postinstall": "node packaging/npm/install.js",
     "release:tag": "bash tools/release/tag-release.sh",
-    "test": "node packaging/npm/run.js --version && node packaging/npm/run.js help && node packaging/npm/run.js update --check"
+    "test": "cargo test --manifest-path rust/Cargo.toml && node packaging/npm/run.js version && node packaging/npm/run.js help && node packaging/npm/run.js update --check"
   },
   "os": [
     "darwin",

package/packaging/npm/install.js

@@ -158,10 +158,9 @@ if (require.main === module) {
     install();
   } catch (err) {
     console.error(`Failed to install ${NAME}: ${err.message}`);
-    console.error(`Make sure Rscript is installed and the v${VERSION} GitHub Release exists.`);
+    console.error(`Make sure the v${VERSION} GitHub Release exists for your platform.`);
     process.exit(1);
   }
 }
 
 module.exports = { getExpectedChecksum, verifyChecksum, resolveMirrorUrls, assertAllowedHost };
-

package/packaging/npm/run.js

@@ -7,11 +7,11 @@ const path = require("path");
 const isWindows = process.platform === "win32";
 const repoRoot = path.join(__dirname, "..", "..");
 const vendorRoot = path.join(repoRoot, "vendor", "rainbo-cli");
-const launcher = path.join(vendorRoot, isWindows ? "rainbo-cli.cmd" : "rainbo-cli");
-const sourceEntry = path.join(repoRoot, "bin", "rainbo-cli.R");
+const launcher = path.join(vendorRoot, isWindows ? "rainbo-cli.exe" : "rainbo-cli");
+const sourceManifest = path.join(repoRoot, "rust", "Cargo.toml");
 
 function installIfMissing() {
-  if (fs.existsSync(launcher) || fs.existsSync(sourceEntry)) return;
+  if (fs.existsSync(launcher) || fs.existsSync(sourceManifest)) return;
   const result = spawnSync(process.execPath, [path.join(__dirname, "install.js")], {
     stdio: "inherit",
     env: { ...process.env, RAINBO_CLI_RUN: "true" },
@@ -37,9 +37,11 @@ function recoverWindowsOldLauncher() {
 recoverWindowsOldLauncher();
 installIfMissing();
 
-const useSource = fs.existsSync(sourceEntry);
-const command = useSource ? "Rscript" : launcher;
-const args = useSource ? [sourceEntry, ...process.argv.slice(2)] : process.argv.slice(2);
+const useSource = fs.existsSync(sourceManifest);
+const command = useSource ? "cargo" : launcher;
+const args = useSource
+  ? ["run", "--quiet", "--manifest-path", sourceManifest, "--", ...process.argv.slice(2)]
+  : process.argv.slice(2);
 const result = spawnSync(command, args, { stdio: "inherit", shell: isWindows });
 
 if (result.error) {
@@ -47,4 +49,3 @@ if (result.error) {
   process.exit(1);
 }
 process.exit(result.status || 0);
-