@mdsmith/cli 0.13.0

package/README.md

@@ -0,0 +1,45 @@
+# @mdsmith/cli
+
+Fast, auto-fixing Markdown linter and formatter for docs, READMEs,
+and AI-generated content. This is the npm distribution of the Go
+binary published at
+<https://github.com/jeduden/mdsmith>.
+
+The npm root is `@mdsmith/cli` because the unscoped `mdsmith`
+name on npm is owned by another project. The installed binary
+is still called `mdsmith` (via the package's `bin` field).
+
+## Install
+
+```bash
+npm install -g @mdsmith/cli
+# or, without a global install:
+npx @mdsmith/cli --help
+```
+
+The package ships a small Node.js shim (`bin/mdsmith.js`) that locates
+the prebuilt binary from one of these platform sub-packages and execs
+it:
+
+- `@mdsmith/linux-x64`
+- `@mdsmith/linux-arm64`
+- `@mdsmith/darwin-x64`
+- `@mdsmith/darwin-arm64`
+- `@mdsmith/win32-x64`
+
+npm installs only the sub-package matching `process.platform` and
+`process.arch`. There is no postinstall network call, so the package
+works in offline / air-gapped CI.
+
+## Versioning
+
+Every npm release matches a `vX.Y.Z` git tag in the upstream repo.
+`mdsmith version` reports the same value on every distribution
+channel (npm, PyPI, asdf, mise, the GitHub release, the VS Code
+marketplaces).
+
+## Other channels
+
+See [docs/guides/install.md](https://github.com/jeduden/mdsmith/blob/main/docs/guides/install.md)
+for the full list (PyPI / pip / uvx, asdf, mise, direct download,
+VS Code Marketplace, Open VSX).

package/bin/mdsmith.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+// mdsmith npm shim — resolves the prebuilt binary from the platform
+// optional-dependency that npm installed alongside this package, then
+// execs it with the user's argv. No postinstall hook runs, so the
+// shim works in offline / air-gapped CI and on hosts that ban network
+// calls during npm install. The Go binary embeds the same tag at
+// build time, so `mdsmith version` reports the published version on
+// every channel.
+
+"use strict";
+
+const PLATFORM_PACKAGES = Object.freeze({
+  "linux-x64": "@mdsmith/linux-x64",
+  "linux-arm64": "@mdsmith/linux-arm64",
+  "darwin-x64": "@mdsmith/darwin-x64",
+  "darwin-arm64": "@mdsmith/darwin-arm64",
+  "win32-x64": "@mdsmith/win32-x64",
+});
+
+function platformPackage(platform, arch) {
+  return PLATFORM_PACKAGES[`${platform}-${arch}`];
+}
+
+function binaryRelativePath(platform) {
+  return `bin/mdsmith${platform === "win32" ? ".exe" : ""}`;
+}
+
+function unsupportedMessage(platform, arch) {
+  const supported = Object.keys(PLATFORM_PACKAGES).join(", ");
+  return (
+    `mdsmith: unsupported platform ${platform}-${arch}. ` +
+    `Supported: ${supported}. ` +
+    `Direct downloads are available at ` +
+    `https://github.com/jeduden/mdsmith/releases.`
+  );
+}
+
+function resolveBinary(platform, arch, resolve) {
+  const pkg = platformPackage(platform, arch);
+  if (!pkg) {
+    const err = new Error(unsupportedMessage(platform, arch));
+    err.code = "MDSMITH_UNSUPPORTED_PLATFORM";
+    throw err;
+  }
+  try {
+    return resolve(`${pkg}/${binaryRelativePath(platform)}`);
+  } catch (cause) {
+    // optionalDependencies install best-effort, so a host whose
+    // platform-arch combo wasn't picked up by npm sees a clear
+    // diagnostic instead of a require-resolve stack trace.
+    const err = new Error(
+      `mdsmith: missing platform package ${pkg}. ` +
+      `Reinstall with --force or download a binary from ` +
+      `https://github.com/jeduden/mdsmith/releases.`
+    );
+    err.code = "MDSMITH_PLATFORM_PACKAGE_MISSING";
+    err.cause = cause;
+    throw err;
+  }
+}
+
+function main() {
+  const { spawnSync } = require("child_process");
+  let bin;
+  try {
+    bin = resolveBinary(process.platform, process.arch, require.resolve);
+  } catch (err) {
+    process.stderr.write(`${err.message}\n`);
+    process.exit(1);
+    return;
+  }
+  const result = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+  if (result.error) {
+    process.stderr.write(`mdsmith: ${result.error.message}\n`);
+    process.exit(1);
+    return;
+  }
+  // spawnSync sets `signal` instead of `status` when the child was
+  // killed; mirror node-style exit codes (128 + signum) so users can
+  // chain mdsmith inside a shell pipeline that distinguishes signals
+  // from natural exits.
+  if (result.signal) {
+    process.exit(128);
+    return;
+  }
+  process.exit(result.status === null ? 1 : result.status);
+}
+
+module.exports = {
+  PLATFORM_PACKAGES,
+  platformPackage,
+  binaryRelativePath,
+  resolveBinary,
+};
+
+if (require.main === module) {
+  main();
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@mdsmith/cli",
+  "version": "0.13.0",
+  "description": "Fast, auto-fixing Markdown linter and formatter for docs, READMEs, and AI-generated content.",
+  "license": "MIT",
+  "homepage": "https://github.com/jeduden/mdsmith",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jeduden/mdsmith"
+  },
+  "keywords": [
+    "markdown",
+    "linter",
+    "formatter",
+    "mdsmith",
+    "docs"
+  ],
+  "bin": {
+    "mdsmith": "bin/mdsmith.js"
+  },
+  "files": [
+    "bin/mdsmith.js"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@mdsmith/linux-x64": "0.13.0",
+    "@mdsmith/linux-arm64": "0.13.0",
+    "@mdsmith/darwin-x64": "0.13.0",
+    "@mdsmith/darwin-arm64": "0.13.0",
+    "@mdsmith/win32-x64": "0.13.0"
+  },
+  "scripts": {
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.1.0",
+    "@types/node": "^20.11.0"
+  }
+}