libyears 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Selvakumar Arumugam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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
+AUTHORS OR COPYRIGHT HOLDERS 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.

package/README.md

@@ -0,0 +1,14 @@
+# libyears
+
+```bash
+npx libyears
+```
+
+The same thing as `npx @libyears/cli`, under the shorter name. It prints how
+many versions and libyears behind your dependencies are, offline, without
+sending anything anywhere, and can push a snapshot to the hosted ledger at
+[libyears.com](https://libyears.com) with a project token.
+
+Options, output and exit codes are documented in
+[@libyears/cli](https://www.npmjs.com/package/@libyears/cli). This package
+carries no code of its own beyond finding that binary.

package/bin.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+// `npx libyears` is `npx @libyears/cli`. This file finds the real binary
+// beside itself and hands over; every option, exit code and byte of output
+// is the CLI's own.
+//
+// Found by path rather than imported by name: the CLI's package exports do
+// not list its binary, and a bin file is not something a package should
+// have to export. Both layouts npm and npx produce put the dependency in a
+// node_modules directory above this file.
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const target = join('@libyears', 'cli', 'dist', 'bin.js');
+let dir = dirname(fileURLToPath(import.meta.url));
+let found;
+for (let i = 0; i < 8 && !found; i++) {
+  const candidate = join(dir, 'node_modules', target);
+  if (existsSync(candidate)) found = candidate;
+  const parent = dirname(dir);
+  if (parent === dir) break;
+  dir = parent;
+}
+
+if (!found) {
+  console.error('libyears: could not find @libyears/cli. Try `npx @libyears/cli` directly.');
+  process.exit(1);
+}
+
+await import(pathToFileURL(found).href);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "libyears",
+  "version": "0.1.0",
+  "description": "How far behind are your dependencies? Alias for @libyears/cli.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "libyears": "bin.js"
+  },
+  "files": [
+    "bin.js",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@libyears/cli": "^0.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/priyalstech/libyears.git",
+    "directory": "packages/libyears"
+  },
+  "homepage": "https://libyears.com",
+  "keywords": [
+    "dependencies",
+    "libyear",
+    "npm",
+    "lockfile",
+    "technical-debt"
+  ],
+  "scripts": {
+    "test": "node --test \"test/**/*.test.mjs\""
+  }
+}