syvain-metrics 0.0.0

package/README.md

@@ -0,0 +1,48 @@
+# syvain-metrics
+
+Command line tools for inspecting [Syvain Metrics](https://metrics.syvain.com/)
+experiments, folders, metric rows, metric metadata, and annotations.
+
+## Install
+
+```sh
+npm install -g syvain-metrics
+```
+
+The package installs the `syvain-metrics` binary.
+
+## Authenticate
+
+Create an API key from the Syvain Metrics dashboard, then log in:
+
+```sh
+syvain-metrics auth login
+syvain-metrics auth status --human
+```
+
+For scripts or CI, pass the API key on stdin:
+
+```sh
+printf '%s' "$SYVAIN_METRICS_API_KEY" | syvain-metrics auth login --stdin
+```
+
+By default the CLI talks to `https://metrics.syvain.com`.
+
+## Usage
+
+The default output is newline-delimited JSON so commands can be piped into
+automation. Add `--human` for readable tables.
+
+```sh
+syvain-metrics folders list --human
+syvain-metrics folders create --name dendro-mamba
+syvain-metrics experiments list --limit 20 --human
+syvain-metrics experiments get --slug dendro-mamba-run-001
+syvain-metrics experiments metrics --id exp_123 --metric-name train_loss --limit 500
+syvain-metrics experiments catalog --id exp_123
+syvain-metrics experiments catalog-values --id exp_123 --metric train_loss
+syvain-metrics experiments annotate --id exp_123 --annotation "Good validation run"
+```
+
+Run `syvain-metrics --help` or `syvain-metrics <command> --help` for the full
+command list and options.

package/bin/syvain-metrics.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+// Auto-generated by crust build --package -- do not edit
+import { spawn } from "node:child_process";
+import { chmodSync, existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+
+const PLATFORMS = {
+	"linux-x64": {
+		"packagePathSegment": "syvain-metrics-linux-x64",
+		"packageName": "syvain-metrics-linux-x64",
+		"binaryFilename": "syvain-metrics-bun-linux-x64-baseline"
+	},
+	"linux-arm64": {
+		"packagePathSegment": "syvain-metrics-linux-arm64",
+		"packageName": "syvain-metrics-linux-arm64",
+		"binaryFilename": "syvain-metrics-bun-linux-arm64"
+	},
+	"darwin-x64": {
+		"packagePathSegment": "syvain-metrics-darwin-x64",
+		"packageName": "syvain-metrics-darwin-x64",
+		"binaryFilename": "syvain-metrics-bun-darwin-x64"
+	},
+	"darwin-arm64": {
+		"packagePathSegment": "syvain-metrics-darwin-arm64",
+		"packageName": "syvain-metrics-darwin-arm64",
+		"binaryFilename": "syvain-metrics-bun-darwin-arm64"
+	},
+	"win32-x64": {
+		"packagePathSegment": "syvain-metrics-windows-x64",
+		"packageName": "syvain-metrics-windows-x64",
+		"binaryFilename": "syvain-metrics-bun-windows-x64-baseline.exe"
+	},
+	"win32-arm64": {
+		"packagePathSegment": "syvain-metrics-windows-arm64",
+		"packageName": "syvain-metrics-windows-arm64",
+		"binaryFilename": "syvain-metrics-bun-windows-arm64.exe"
+	}
+};
+const dir = dirname(fileURLToPath(import.meta.url));
+const platformKey = `${process.platform}-${process.arch}`;
+const target = PLATFORMS[platformKey];
+
+if (!target) {
+	console.error("[syvain-metrics] Unsupported platform: " + platformKey);
+	console.error("[syvain-metrics] Supported platforms: linux-x64, linux-arm64, darwin-x64, darwin-arm64, windows-x64, windows-arm64");
+	process.exit(1);
+}
+
+const candidateOne = resolve(
+	dir,
+	"..",
+	"..",
+	target.packagePathSegment,
+	"bin",
+	target.binaryFilename,
+);
+const candidateTwo = resolve(
+	dir,
+	"..",
+	"node_modules",
+	target.packageName,
+	"bin",
+	target.binaryFilename,
+);
+
+const binPath = existsSync(candidateOne)
+	? candidateOne
+	: existsSync(candidateTwo)
+		? candidateTwo
+		: null;
+
+if (!binPath) {
+	console.error("[syvain-metrics] Missing platform package for " + platformKey);
+	console.error("[syvain-metrics] Tried:");
+	console.error("  " + candidateOne);
+	console.error("  " + candidateTwo);
+	console.error(
+		"[syvain-metrics] Reinstall dependencies on this platform and ensure optional dependencies are enabled.",
+	);
+	process.exit(1);
+}
+
+if (process.platform !== "win32") {
+	try {
+		chmodSync(binPath, 0o755);
+	} catch {
+		// Ignore permission adjustment failures and let spawn surface real errors.
+	}
+}
+
+const child = spawn(binPath, process.argv.slice(2), {
+	stdio: "inherit",
+});
+
+child.on("error", (error) => {
+	console.error("[syvain-metrics] Failed to launch binary: " + error.message);
+	process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+	if (signal) {
+		try {
+			process.kill(process.pid, signal);
+		} catch {
+			process.exit(1);
+		}
+		return;
+	}
+
+	process.exit(code ?? 0);
+});

package/package.json

@@ -0,0 +1,20 @@
+{
+	"name": "syvain-metrics",
+	"version": "0.0.0",
+	"description": "Syvain Metrics command line interface.",
+	"type": "module",
+	"files": [
+		"bin"
+	],
+	"bin": {
+		"syvain-metrics": "bin/syvain-metrics.js"
+	},
+	"optionalDependencies": {
+		"syvain-metrics-linux-x64": "0.0.0",
+		"syvain-metrics-linux-arm64": "0.0.0",
+		"syvain-metrics-darwin-x64": "0.0.0",
+		"syvain-metrics-darwin-arm64": "0.0.0",
+		"syvain-metrics-windows-x64": "0.0.0",
+		"syvain-metrics-windows-arm64": "0.0.0"
+	}
+}