cdrca12 0.1.0

package/LICENSE.md

@@ -0,0 +1,103 @@
+# License
+
+This repo (CDRCA tooling — the CLI, installer, and VS Code extension) is
+licensed under the **MrMIB License v1.0**, reproduced in full below. This
+covers the tooling only, not the CDRCA language itself: that's Muhammad
+Ayyan's upstream project at [ISLAH-org/CDRCA](https://github.com/ISLAH-org/CDRCA)
+and is licensed on his own terms there, separately from this repo. See
+[docs/LICENSING.md](./docs/LICENSING.md) for that distinction and a note
+on IOSLF, a broader license framework separately published by CDRCA's
+creator.
+
+---
+
+MrMIB License v1.0
+Applies by default to all projects released under this license, unless
+that project's own README explicitly states otherwise.
+
+Copyright (c) 2026 MrMIB
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the
+"Software"), to use and run the Software, subject to the following
+conditions:
+
+1. LEAVE A REMARK
+   Any use of the Software — running it, building something with it, or
+   using it as part of a larger project — must be accompanied by a
+   clear, visible credit to the original author (MrMIB) and a link to
+   or mention of the original project. This applies whether or not you
+   share, publish, or distribute anything: if you use it, you credit
+   it.
+
+   In practice, this only has teeth once you show your work to someone
+   else — a private, never-shared use is not something anyone can see
+   or enforce a remark against. The rule is the same either way; only
+   the ability to check it changes.
+
+2. NO DERIVATIVES BY DEFAULT
+   You may NOT modify, fork, extend, or build derivative works on top
+   of the Software, and you may NOT create and distribute a modified
+   version of it — unless this specific project's README explicitly
+   states that derivatives are permitted for that project. Every
+   project defaults to closed; permission to build on top of it is
+   granted per-project, in writing, in that project's own README, not
+   assumed from this license.
+
+   Using the Software as-is (running it, calling it, integrating with
+   its intended public interface) is not the same as modifying it, and
+   is allowed under the terms elsewhere in this license.
+
+3. NO RESALE OF THE SOFTWARE ITSELF
+   You may NOT sell, sublicense, or distribute for a fee the Software
+   itself, or a derivative work (where permitted under #2) whose
+   primary value comes from the Software rather than from what you
+   added to it — whether as a standalone product, a rebranded copy, or
+   bundled access such as a subscription or paid license to use it.
+
+   You MAY use the Software to create and sell other things — for
+   example, producing and monetizing videos, art, data, or documents
+   made with it, or running it as an internal tool in a business that
+   sells something else entirely. Making money BY USING the Software is
+   fine. Making money BY SELLING the Software, or by selling access to
+   it, is not.
+
+   If you're not sure which side of that line something falls on, ask
+   the copyright holder before shipping it.
+
+4. FUTURE TERMS MAY CHANGE — YOUR COPY DOESN'T
+   The copyright holder may release future versions of a project, or of
+   this license, under different terms, pricing, or availability, at
+   their sole discretion. That doesn't reach backward: whatever copy of
+   the Software you already lawfully obtained keeps the license terms
+   it was given under. This section is about what's offered next, not
+   about taking back what's already granted.
+
+5. NO WARRANTY
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+   NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHOR OR COPYRIGHT HOLDER BE
+   LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+   ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+   CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+   SOFTWARE.
+
+---
+
+Plain-language summary (not a substitute for the terms above): you can
+use this, and make money using it — just credit MrMIB when you do,
+don't fork or build on top of it unless the project's own README says
+you can, and don't repackage or sell the software itself. Future
+releases might come with different terms, but whatever version you got
+stays yours under the terms you got it under.
+
+Note: this is a custom, non-standard license — it is NOT OSI-approved
+open source (open source definitions don't permit blanket
+no-derivatives or no-forking restrictions like #2). Being unambiguous
+about that up front avoids confusing anyone who assumes "public GitHub
+repo" automatically means "open source" in the traditional sense. The
+private-use "remark" requirement in #1 is a genuine ask, not something
+that can actually be checked or enforced for use nobody ever sees — if
+you need a term with real legal teeth for a specific situation, have a
+lawyer review this before relying on it.

package/README.md

@@ -0,0 +1,32 @@
+# cdrca12
+
+npm wrapper for the CDRCA CLI. Downloads the prebuilt `cdrca.exe` from
+[GitHub Releases](https://github.com/MrGrimJoe/cdrca-ready-for-the-real-world/releases)
+on install and runs it.
+
+**Windows only right now** — that's the only platform CI currently builds
+a binary for. Installing on macOS/Linux will fail with a clear error
+instead of silently installing something broken.
+
+## Install
+
+```
+npm install -g cdrca12
+```
+
+## Use
+
+```
+cdrca12 --help
+```
+
+## Source
+
+This is a thin wrapper, not the actual implementation — see
+[github.com/MrGrimJoe/cdrca-ready-for-the-real-world](https://github.com/MrGrimJoe/cdrca-ready-for-the-real-world)
+for the CLI source (Rust), the Windows installer, and the VS Code
+extension.
+
+## License
+
+MrMIB License v1.0 — see [LICENSE.md](./LICENSE.md).

package/bin/cdrca.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+const fs = require("fs");
+const path = require("path");
+const { spawnSync } = require("child_process");
+
+const binPath = path.join(__dirname, "..", "dist", "cdrca.exe");
+
+if (!fs.existsSync(binPath)) {
+  console.error(
+    "\ncdrca12: the cdrca.exe binary isn't installed. This usually means " +
+      "postinstall didn't run or failed -- try reinstalling with " +
+      "`npm install -g cdrca12` and check the output above for an error.\n"
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(binPath, process.argv.slice(2), { stdio: "inherit" });
+
+if (result.error) {
+  console.error(`\ncdrca12: failed to run cdrca.exe: ${result.error.message}\n`);
+  process.exit(1);
+}
+
+process.exit(result.status === null ? 1 : result.status);

package/install.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+// Downloads the prebuilt cdrca.exe for this package's exact version from
+// GitHub Releases. No dependencies beyond Node's own https/fs -- this is
+// meant to stay a thin wrapper, not grow a dependency tree of its own.
+//
+// Windows-only right now: CI (.github/workflows/release.yml in the main
+// repo) only builds a Windows binary. package.json's "os": ["win32"]
+// already makes npm refuse the install on other platforms before this
+// script ever runs, but this check stays too -- defense in depth, and a
+// clearer message than npm's generic "Unsupported platform" if it's ever
+// bypassed (--force, --ignore-scripts games, a future npm behavior
+// change, etc).
+
+const fs = require("fs");
+const https = require("https");
+const path = require("path");
+
+const pkg = require("./package.json");
+const REPO = "MrGrimJoe/cdrca-ready-for-the-real-world";
+const DIST_DIR = path.join(__dirname, "dist");
+const DEST = path.join(DIST_DIR, "cdrca.exe");
+
+function fail(message) {
+  console.error(`\ncdrca12: ${message}\n`);
+  process.exit(1);
+}
+
+if (process.platform !== "win32") {
+  fail(
+    "no prebuilt binary is available for your platform yet -- only Windows " +
+      "builds exist right now. Build from source instead: " +
+      `see https://github.com/${REPO}#build`
+  );
+}
+
+// GitHub redirects release-asset downloads through its CDN (typically two
+// hops: api/github release page -> objects.githubusercontent.com). Follow
+// redirects manually rather than pulling in a request library for it.
+function download(url, destPath, redirectsLeft = 5) {
+  return new Promise((resolve, reject) => {
+    if (redirectsLeft <= 0) {
+      reject(new Error("too many redirects"));
+      return;
+    }
+    https
+      .get(url, { headers: { "User-Agent": "cdrca12-postinstall" } }, (res) => {
+        if (
+          res.statusCode >= 300 &&
+          res.statusCode < 400 &&
+          res.headers.location
+        ) {
+          res.resume(); // discard this response body
+          download(res.headers.location, destPath, redirectsLeft - 1).then(
+            resolve,
+            reject
+          );
+          return;
+        }
+        if (res.statusCode !== 200) {
+          res.resume();
+          reject(
+            new Error(`HTTP ${res.statusCode} fetching ${url}`)
+          );
+          return;
+        }
+        const fileStream = fs.createWriteStream(destPath);
+        res.pipe(fileStream);
+        fileStream.on("finish", () => fileStream.close(resolve));
+        fileStream.on("error", reject);
+      })
+      .on("error", reject);
+  });
+}
+
+async function main() {
+  fs.mkdirSync(DIST_DIR, { recursive: true });
+
+  const tag = `v${pkg.version}`;
+  const url = `https://github.com/${REPO}/releases/download/${tag}/cdrca-win32-x64.exe`;
+
+  console.log(`cdrca12: downloading cdrca.exe (${tag}) ...`);
+  try {
+    await download(url, DEST);
+  } catch (err) {
+    fail(
+      `couldn't download the prebuilt binary from ${url} (${err.message}). ` +
+        `Check https://github.com/${REPO}/releases/tag/${tag} exists and has ` +
+        "a cdrca-win32-x64.exe asset attached."
+    );
+  }
+
+  const stat = fs.statSync(DEST);
+  if (stat.size === 0) {
+    fs.unlinkSync(DEST);
+    fail("downloaded file was empty -- the release asset may be missing or corrupt.");
+  }
+
+  console.log("cdrca12: done.");
+}
+
+main();

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "cdrca12",
+  "version": "0.1.0",
+  "description": "CLI wrapper for CDRCA tooling -- downloads the prebuilt cdrca.exe from GitHub Releases on install. Windows only for now.",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "author": {
+    "name": "MrMIB"
+  },
+  "homepage": "https://github.com/MrGrimJoe/cdrca-ready-for-the-real-world#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MrGrimJoe/cdrca-ready-for-the-real-world.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MrGrimJoe/cdrca-ready-for-the-real-world/issues"
+  },
+  "keywords": [
+    "cdrca",
+    "cli"
+  ],
+  "bin": {
+    "cdrca12": "bin/cdrca.js"
+  },
+  "files": [
+    "bin/",
+    "install.js",
+    "LICENSE.md"
+  ],
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "os": [
+    "win32"
+  ],
+  "engines": {
+    "node": ">=16"
+  }
+}