@simplr-ai/release-cli 0.1.0

package/README.md

@@ -0,0 +1,53 @@
+# @simplr-ai/release-cli
+
+Push commits and CI test results to **Simplr Release Notes** from a git hook or CI step.
+Feeds the same `/v1/release-ingest` API the GitHub App and VS Code extension use, so it
+works for any provider.
+
+## Install
+
+```bash
+bun add -d @simplr-ai/release-cli   # or npm i -D
+```
+
+## Auth
+
+Create a project **ingest token** in the Simplr dashboard (Release Notes → project → Connect).
+
+```bash
+export SIMPLR_RELEASE_TOKEN=rnit_xxx
+export SIMPLR_API_URL=https://api.simplr.so   # optional, this is the default
+```
+
+## Capture a commit
+
+```bash
+# Captures HEAD (sha, branch, message, author) automatically:
+simplr-release release push
+
+# Or be explicit / override the environment mapping:
+simplr-release release push --ref main --env uat --title "Checkout v2"
+```
+
+Wire it into `.git/hooks/post-commit` or a CI step to capture every push.
+
+## Report a test result (gates flag rollout + release publishing)
+
+```bash
+simplr-release test report --status passed --tag ci-main
+simplr-release test report --status failed --tag ci-main
+```
+
+A feature flag with `rollout_mode=auto` and `rollout_tag=ci-main` will advance only
+while the latest reported run for that tag is green, and halt on red — the same gate
+GitHub Actions results feed.
+
+## Programmatic use
+
+```ts
+import { pushChange, reportTest } from "@simplr-ai/release-cli";
+
+const opts = { apiUrl: "https://api.simplr.so", token: process.env.SIMPLR_RELEASE_TOKEN! };
+await pushChange(opts, { kind: "commit", title: "Fix login", ref: "main" });
+await reportTest(opts, { status: "passed", tag: "ci-main" });
+```

package/dist/chunk-YPVQ3FRD.js

@@ -0,0 +1,22 @@
+// src/index.ts
+async function post(opts, path, body) {
+  const res = await fetch(`${opts.apiUrl}${path}`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", Authorization: `Bearer ${opts.token}` },
+    body: JSON.stringify(body)
+  });
+  const json = await res.json().catch(() => ({}));
+  if (!res.ok) throw new Error(json?.message || `Request failed (${res.status})`);
+  return json;
+}
+function pushChange(opts, input) {
+  return post(opts, "/v1/release-ingest/changes", input);
+}
+function reportTest(opts, input) {
+  return post(opts, "/v1/release-ingest/test-result", { ...input, external_id: input.externalId });
+}
+
+export {
+  pushChange,
+  reportTest
+};

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+import {
+  pushChange,
+  reportTest
+} from "./chunk-YPVQ3FRD.js";
+
+// src/cli.ts
+import { execSync } from "child_process";
+function getOptions(args) {
+  const token = args.get("token") ?? process.env.SIMPLR_RELEASE_TOKEN ?? "";
+  const apiUrl = args.get("api") ?? process.env.SIMPLR_API_URL ?? "https://api.simplr.so";
+  if (!token) {
+    console.error("Missing token. Pass --token <rnit_\u2026> or set SIMPLR_RELEASE_TOKEN.");
+    process.exit(1);
+  }
+  return { token, apiUrl };
+}
+function git(cmd) {
+  try {
+    return execSync(`git ${cmd}`, { encoding: "utf8" }).trim();
+  } catch {
+    return "";
+  }
+}
+function parseArgs(argv) {
+  const flags = /* @__PURE__ */ new Map();
+  const positional = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith("--")) {
+      const key = a.slice(2);
+      const next = argv[i + 1];
+      if (next && !next.startsWith("--")) {
+        flags.set(key, next);
+        i++;
+      } else {
+        flags.set(key, "true");
+      }
+    } else {
+      positional.push(a);
+    }
+  }
+  return { command: positional[0] ?? "", sub: positional[1] ?? "", flags };
+}
+var HELP = `simplr-release \u2014 push commits and CI results to Simplr Release Notes
+
+Usage:
+  simplr-release release push [--ref <ref>] [--sha <sha>] [--title <msg>] [--env <key>]
+  simplr-release test report --status <passed|failed|\u2026> [--tag <t>] [--name <n>] [--env <key>]
+
+Auth:
+  --token <rnit_\u2026>   or  SIMPLR_RELEASE_TOKEN
+  --api <url>        or  SIMPLR_API_URL  (default https://api.simplr.so)
+
+Examples:
+  simplr-release release push                       # captures HEAD commit
+  simplr-release test report --status passed --tag ci-main
+`;
+async function main() {
+  const { command, sub, flags } = parseArgs(process.argv.slice(2));
+  if (!command || flags.has("help")) {
+    console.log(HELP);
+    return;
+  }
+  const opts = getOptions(flags);
+  if (command === "release" && sub === "push") {
+    const sha = flags.get("sha") ?? git("rev-parse HEAD");
+    const ref = flags.get("ref") ?? git("rev-parse --abbrev-ref HEAD");
+    const title = flags.get("title") ?? git("log -1 --pretty=%s") ?? "(no message)";
+    const body = git("log -1 --pretty=%b") || void 0;
+    const author = git("log -1 --pretty=%an") || void 0;
+    await pushChange(opts, { kind: "commit", sha, ref, title, body, author, environment: flags.get("env") });
+    console.log(`\u2713 Pushed commit ${sha.slice(0, 7)} (${ref}) to Simplr`);
+    return;
+  }
+  if (command === "test" && sub === "report") {
+    const status = flags.get("status");
+    if (!status) {
+      console.error("--status is required (passed|failed|queued|running|cancelled)");
+      process.exit(1);
+    }
+    await reportTest(opts, {
+      status,
+      tag: flags.get("tag"),
+      name: flags.get("name"),
+      ref: flags.get("ref") ?? git("rev-parse --abbrev-ref HEAD"),
+      sha: flags.get("sha") ?? git("rev-parse HEAD"),
+      url: flags.get("url"),
+      environment: flags.get("env"),
+      externalId: flags.get("id")
+    });
+    console.log(`\u2713 Reported test "${flags.get("tag") ?? flags.get("name") ?? status}" as ${status}`);
+    return;
+  }
+  console.log(HELP);
+  process.exit(1);
+}
+main().catch((e) => {
+  console.error(`\u2717 ${e instanceof Error ? e.message : e}`);
+  process.exit(1);
+});

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+interface ReleaseClientOptions {
+    /** Base API URL, e.g. https://api.simplr.so */
+    apiUrl: string;
+    /** A project ingest token (rnit_…) created in the dashboard. */
+    token: string;
+}
+type ChangeKind = "commit" | "pr" | "deploy";
+interface PushChangeInput {
+    kind: ChangeKind;
+    title: string;
+    ref?: string;
+    sha?: string;
+    body?: string;
+    author?: string;
+    url?: string;
+    /** Explicit environment key (overrides project mapping). */
+    environment?: string;
+}
+type TestStatus = "queued" | "running" | "passed" | "failed" | "cancelled";
+interface ReportTestInput {
+    status: TestStatus;
+    name?: string;
+    tag?: string;
+    ref?: string;
+    sha?: string;
+    url?: string;
+    environment?: string;
+    externalId?: string;
+}
+/** Push a single change (commit/PR/deploy) into the project's release pipeline. */
+declare function pushChange(opts: ReleaseClientOptions, input: PushChangeInput): Promise<any>;
+/** Report a CI test result that can gate flag rollouts and release publishing. */
+declare function reportTest(opts: ReleaseClientOptions, input: ReportTestInput): Promise<any>;
+
+export { type ChangeKind, type PushChangeInput, type ReleaseClientOptions, type ReportTestInput, type TestStatus, pushChange, reportTest };

package/dist/index.js

@@ -0,0 +1,8 @@
+import {
+  pushChange,
+  reportTest
+} from "./chunk-YPVQ3FRD.js";
+export {
+  pushChange,
+  reportTest
+};

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@simplr-ai/release-cli",
+  "version": "0.1.0",
+  "description": "Simplr release CLI — push commits and report CI test results to Simplr Release Notes from a git hook or CI step.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "simplr-release": "./dist/cli.js"
+  },
+  "files": ["dist"],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "keywords": ["simplr", "release-notes", "changelog", "ci", "cli"]
+}