@sr-labs/devkit 0.0.0-stage → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sr-labs
+
+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

@@ -1,3 +1,11 @@
-# Temporary Holding Version
+# @sr-labs/devkit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+One `devkit` command for the tools that set up a project's development environment.
+
+```sh
+devkit release [--apply] [--push] ...   # same as release-tag
+devkit changelog [--stdout] ...         # same as changelog
+devkit --help | --version
+```
+
+An unknown subcommand prints an error and the help text and exits non-zero. See the [devkit README](../../README.md).

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { main } from "./main.js";
+process.exitCode = main(process.argv.slice(2));

package/dist/commands.d.ts

@@ -0,0 +1,7 @@
+export interface Command {
+    description: string;
+    /** Runs the tool with the remaining args and returns the exit code. */
+    run: (argv: string[]) => number;
+}
+/** Subcommand registry. Adding a tool is one entry. */
+export declare const commands: Record<string, Command>;

package/dist/commands.js

@@ -0,0 +1,7 @@
+import { main as changelog } from '@sr-labs/changelog';
+import { main as release } from '@sr-labs/release-tag';
+/** Subcommand registry. Adding a tool is one entry. */
+export const commands = {
+    release: { description: 'Compute the next vX.Y.Z, bump files, update CHANGELOG.md, commit and tag', run: release },
+    changelog: { description: 'Generate CHANGELOG.md from Conventional Commits between tags', run: changelog }
+};

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './commands.ts';
+export { main } from './main.ts';

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./commands.js";
+export { main } from "./main.js";

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+/** Runs the devkit CLI with args (without node/script) and returns the exit code. */
+export declare function main(argv: string[]): number;

package/dist/main.js

@@ -0,0 +1,24 @@
+import { readFileSync } from 'node:fs';
+import { commands } from "./commands.js";
+const help = () => `Usage: devkit <command> [options]\n\nCommands:\n${Object.entries(commands)
+    .map(([name, c]) => `  ${name.padEnd(10)}${c.description}`)
+    .join('\n')}\n\nOptions:\n  --help, -h     Show this help\n  --version, -v  Show the devkit version\n`;
+/** Runs the devkit CLI with args (without node/script) and returns the exit code. */
+export function main(argv) {
+    const [name, ...rest] = argv;
+    if (name === '--help' || name === '-h' || name === undefined) {
+        process.stdout.write(help());
+        return 0;
+    }
+    if (name === '--version' || name === '-v') {
+        const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+        console.log(pkg.version);
+        return 0;
+    }
+    if (!Object.hasOwn(commands, name)) {
+        console.error(`Unknown command: ${name}\n`);
+        process.stderr.write(help());
+        return 1;
+    }
+    return commands[name].run(rest);
+}

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "@sr-labs/devkit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.3",
+  "description": "One devkit command for project development-environment tools: release, changelog.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/sr-labs/devkit.git",
+    "directory": "packages/devkit"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "devkit": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@sr-labs/changelog": "^0.1.3",
+    "@sr-labs/release-tag": "^0.1.3"
+  }
 }