wyvrnpm 2.10.2 → 2.11.0

package/README.md

@@ -235,6 +235,51 @@ wyvrnpm add zlib fmt@10.2.0.0 spdlog
 
 ---
 
+### `wyvrnpm version`
+
+Read, set, or partially update the top-level `version` field in `wyvrn.json`. Designed for CI/CD — bumps the build component from a pipeline variable, prints the result for capture, and never touches git (CI pipelines own tagging and commits).
+
+- **Bare** — prints the current version on stdout, naked (no `[wyvrn]` prefix), so `VER=$(wyvrnpm version)` works straight away.
+- **Full set** — `wyvrnpm version 1.2.3.4` writes the value verbatim. Strict 4-part `x.y.z.b` validation; leading zeros and 3-part semver are rejected.
+- **Component flags** — `--major / --minor / --patch / --build N` replace one component while leaving the others alone. Combine flags freely (`--minor 3 --build 0`).
+- Positional and component flags are mutually exclusive — pick a mode.
+
+```bash
+# Read the current version (CI capture)
+VER=$(wyvrnpm version)
+
+# Inject the build number from a pipeline variable
+wyvrnpm version --build "$BUILD_ID"
+
+# Cut a minor release — reset the build component to 0
+wyvrnpm version --minor 3 --build 0
+
+# Set a full version verbatim
+wyvrnpm version 2.0.0.0
+
+# CI-friendly capture
+wyvrnpm version --build "$BUILD_ID" --format json
+# {"command":"version","previous":"1.2.3.4","version":"1.2.3.99","written":true,...}
+
+# Preview without writing
+wyvrnpm version --build 99 --dry-run
+```
+
+**Options**
+
+| Option | Default | Description |
+|---|---|---|
+| `<newVersion>` positional | — | Full 4-part version (e.g. `1.2.3.4`). Mutex with `--major/--minor/--patch/--build`. |
+| `--major` | — | Replace the 1st component. |
+| `--minor` | — | Replace the 2nd component. |
+| `--patch` | — | Replace the 3rd component. |
+| `--build` | — | Replace the 4th component (typical CI use). |
+| `--dry-run` | `false` | Compute and print the proposed version without writing. |
+| `--format` | `text` | Output format: `text` (human) or `json` (CI — single object on stdout). |
+| `--manifest` | `./wyvrn.json` | Path to the manifest file. |
+
+---
+
 ### `wyvrnpm install`
 
 Resolves the full dependency graph and downloads all packages.

package/bin/wyvrn.js

@@ -5,6 +5,7 @@
 const yargs     = require('yargs');
 const init         = require('../src/commands/init');
 const add          = require('../src/commands/add');
+const versionCmd   = require('../src/commands/version');
 const install      = require('../src/commands/install');
 const clean        = require('../src/commands/clean');
 const publish      = require('../src/commands/publish');
@@ -143,6 +144,40 @@ yargs
     (argv) => add(argv),
   )
 
+  // ── version ───────────────────────────────────────────────────────────────
+  .command(
+    'version [newVersion]',
+    'Read, set, or partially update the top-level `version` field in wyvrn.json. ' +
+    'Bare `wyvrnpm version` prints the current value on stdout (for `VER=$(...)` ' +
+    'capture). Pass a full 4-part value (1.2.3.4) or component flags (--major / ' +
+    '--minor / --patch / --build) to tweak individual parts. Designed for CI/CD — ' +
+    'pair with --format json to capture { previous, version } on stdout.',
+    (y) => {
+      y
+        .positional('newVersion', {
+          type: 'string',
+          describe: 'Full 4-part version to write verbatim (e.g. 1.2.3.4). ' +
+                    'Mutually exclusive with --major/--minor/--patch/--build.',
+        })
+        .option('major', { type: 'number', description: 'Replace the 1st component (major).' })
+        .option('minor', { type: 'number', description: 'Replace the 2nd component (minor).' })
+        .option('patch', { type: 'number', description: 'Replace the 3rd component (patch).' })
+        .option('build', { type: 'number', description: 'Replace the 4th component (build) — typical CI use.' })
+        .option('dry-run', {
+          type: 'boolean',
+          default: false,
+          description: 'Compute and print the proposed version without writing wyvrn.json.',
+        })
+        .option('format', {
+          type: 'string',
+          choices: ['text', 'json'],
+          default: 'text',
+          description: 'Output format. "json" emits { command, previous, version, ... } on stdout.',
+        });
+    },
+    (argv) => versionCmd({ ...argv, dryRun: argv['dry-run'] }),
+  )
+
   // ── install ───────────────────────────────────────────────────────────────
   .command(
     'install',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wyvrnpm",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "A simple, static-hosting-compatible C++ package manager",
   "keywords": [
     "c++",

package/src/commands/version.js

@@ -0,0 +1,187 @@
+'use strict';
+
+const path = require('path');
+
+const { readManifest, writeManifest } = require('../manifest');
+const log                             = require('../logger');
+
+/** Strict 4-part wyvrnpm version: `x.y.z.b`, all non-negative integers, no leading zeros. */
+const VERSION_RE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
+
+/**
+ * Parse a 4-part version string into `[major, minor, patch, build]`.
+ * Throws with a clear message when the string fails the wyvrnpm format.
+ *
+ * @param {string} v
+ * @returns {[number, number, number, number]}
+ */
+function parseVersion(v) {
+  if (typeof v !== 'string' || v.length === 0) {
+    throw new Error('version is empty');
+  }
+  const m = VERSION_RE.exec(v);
+  if (!m) {
+    throw new Error(
+      `"${v}" is not a valid wyvrnpm version. ` +
+      'Expected 4-part x.y.z.b with non-negative integers (e.g. 1.2.3.4).',
+    );
+  }
+  return [Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4])];
+}
+
+const COMPONENT_INDEX = { major: 0, minor: 1, patch: 2, build: 3 };
+
+function isNonNegInt(n) {
+  return Number.isInteger(n) && n >= 0;
+}
+
+/**
+ * `wyvrnpm version [<new-version>]` — read, set, or partially update the
+ * top-level `version` field in wyvrn.json. Designed for CI/CD (build-number
+ * injection + tag-the-build readback).
+ *
+ *   wyvrnpm version                      → print the current version
+ *   wyvrnpm version 1.2.3.4              → set verbatim
+ *   wyvrnpm version --build 99           → only the 4th component
+ *   wyvrnpm version --minor 3 --build 0  → multiple components, others left alone
+ *
+ * Positional and component flags are mutually exclusive — pick one mode.
+ * Bare invocation is read-only (never writes, never warns about an unset
+ * version on disk — it prints `(unset)` to stderr and exits 1 in that
+ * case so scripts notice). CI scripts use --format json to capture the
+ * `{ previous, version }` payload on stdout.
+ *
+ * @param {object} argv
+ */
+function versionCmd(argv) {
+  const manifestPath = path.resolve(argv.manifest);
+  const jsonOut = argv.format === 'json';
+  if (jsonOut) log.setJsonMode(true);
+
+  const positional = argv.newVersion;
+
+  // Component flags arrive on argv as `argv.major` / `argv.minor` / etc.
+  // because yargs lowercases option names. Keep insertion order so error
+  // messages list flags in the same order as the CLI surface.
+  const partial = {};
+  for (const key of Object.keys(COMPONENT_INDEX)) {
+    if (argv[key] !== undefined) partial[key] = argv[key];
+  }
+  const partialKeys = Object.keys(partial);
+
+  if (positional && partialKeys.length > 0) {
+    log.error(
+      'cannot combine a positional version with --major/--minor/--patch/--build. ' +
+      'Use one or the other.',
+    );
+    process.exit(1);
+  }
+
+  // Read-only mode: no positional + no component flags. Prints the current
+  // version and returns without touching disk. Matches `npm version` behaviour
+  // when called bare.
+  const readOnly = !positional && partialKeys.length === 0;
+
+  let manifest;
+  try {
+    manifest = readManifest(manifestPath);
+  } catch (err) {
+    log.error(err.message);
+    process.exit(1);
+  }
+
+  const previous =
+    typeof manifest.version === 'string' && manifest.version.length > 0
+      ? manifest.version
+      : null;
+
+  if (readOnly) {
+    const wyvrnpmVersion = require('../../package.json').version;
+    if (jsonOut) {
+      process.stdout.write(JSON.stringify({
+        command: 'version',
+        wyvrnpmVersion,
+        path:     manifestPath,
+        version:  previous,
+        written:  false,
+      }) + '\n');
+    } else if (previous) {
+      // Bare stdout for `VER=$(wyvrnpm version)` — no `[wyvrn]` prefix here.
+      process.stdout.write(previous + '\n');
+    } else {
+      log.error(`no \`version\` field in ${manifestPath}`);
+      process.exit(1);
+    }
+    return;
+  }
+
+  let newVersion;
+  if (positional) {
+    try {
+      parseVersion(positional);
+    } catch (err) {
+      log.error(err.message);
+      process.exit(1);
+    }
+    newVersion = positional;
+  } else {
+    let parts;
+    try {
+      parts = parseVersion(previous ?? '');
+    } catch (err) {
+      log.error(
+        `cannot tweak components — current manifest version is invalid or missing: ${err.message}\n` +
+        '  Set a full version first: wyvrnpm version <x.y.z.b>',
+      );
+      process.exit(1);
+    }
+    for (const key of partialKeys) {
+      const n = partial[key];
+      if (!isNonNegInt(n)) {
+        log.error(`--${key} must be a non-negative integer (got ${JSON.stringify(n)})`);
+        process.exit(1);
+      }
+      parts[COMPONENT_INDEX[key]] = n;
+    }
+    newVersion = parts.join('.');
+  }
+
+  const wyvrnpmVersion = require('../../package.json').version;
+
+  if (argv.dryRun) {
+    if (jsonOut) {
+      process.stdout.write(JSON.stringify({
+        command: 'version',
+        wyvrnpmVersion,
+        path:     manifestPath,
+        previous,
+        version:  newVersion,
+        dryRun:   true,
+        written:  false,
+      }) + '\n');
+    } else {
+      log.info(`would set version: ${previous ?? '(unset)'} → ${newVersion} (dry-run)`);
+    }
+    return;
+  }
+
+  manifest.version = newVersion;
+  writeManifest(manifestPath, manifest);
+
+  if (jsonOut) {
+    process.stdout.write(JSON.stringify({
+      command: 'version',
+      wyvrnpmVersion,
+      path:     manifestPath,
+      previous,
+      version:  newVersion,
+      dryRun:   false,
+      written:  true,
+    }) + '\n');
+  } else {
+    log.success(`${manifestPath}: ${previous ?? '(unset)'} → ${newVersion}`);
+  }
+}
+
+module.exports = versionCmd;
+module.exports.parseVersion = parseVersion;