@refleet-it/runner 0.1.186 → 0.1.197

package/README.md

@@ -22,11 +22,14 @@ twice in Refleet.
 npm install -g @refleet-it/runner
 ```
 
+The command is `refleet`; `refleet-runner` still works as an alias for scripts written
+against earlier releases.
+
 ## Connect and run
 
 ```bash
-refleet-runner login    # API URL, email, password → mints an API key and stores it locally
-refleet-runner run
+refleet login    # API URL, email, password → mints an API key and stores it locally
+refleet run
 ```
 
 `login` keeps its API key in `~/.config/refleet/runner.json` (`XDG_CONFIG_HOME` is honoured).
@@ -34,8 +37,8 @@ Anything headless — a server, a container, CI — should instead set `REFLEET_
 `REFLEET_API_KEY` directly; when both are set they take precedence over the stored login.
 
 ```bash
-refleet-runner whoami   # which credentials are in effect, and whether they still work
-refleet-runner logout   # revokes the stored key on the server and forgets it locally
+refleet whoami   # which credentials are in effect, and whether they still work
+refleet logout   # revokes the stored key on the server and forgets it locally
 ```
 
 `run` has no idle mode: without credentials it exits immediately, and a job in progress is
@@ -48,7 +51,7 @@ Description=Refleet runner
 After=network-online.target
 
 [Service]
-ExecStart=/usr/bin/env refleet-runner run
+ExecStart=/usr/bin/env refleet run
 Environment=REFLEET_API_URL=https://refleet.it/api
 Environment=REFLEET_API_KEY=…
 Environment=ANTHROPIC_API_KEY=…

package/dist/cli.js

@@ -48,7 +48,7 @@ async function runLogin() {
         createdAt: created.createdAt,
     });
     process.stdout.write(`Logged in as ${email}. API key ${created.prefix}… saved to your local config.\n`);
-    process.stdout.write("Run 'refleet-runner run' to start the runner.\n");
+    process.stdout.write("Run 'refleet run' to start the runner.\n");
 }
 /** Revokes the locally saved key on the backend (best-effort) and clears the local config. */
 async function runLogout() {
@@ -70,11 +70,11 @@ async function runLogout() {
 async function runWhoami() {
     const resolved = resolveFleetConfig(process.env);
     if (!resolved) {
-        process.stdout.write("Not logged in, and REFLEET_API_URL/REFLEET_API_KEY aren't set. Run 'refleet-runner login'.\n");
+        process.stdout.write("Not logged in, and REFLEET_API_URL/REFLEET_API_KEY aren't set. Run 'refleet login'.\n");
         process.exitCode = 1;
         return;
     }
-    const sourceLabel = 'env' === resolved.source ? 'environment variables (automatic mode)' : 'refleet-runner login';
+    const sourceLabel = 'env' === resolved.source ? 'environment variables (automatic mode)' : 'refleet login';
     process.stdout.write(`API URL: ${resolved.apiUrl}\n`);
     process.stdout.write(`API key: ${resolved.apiKey.slice(0, 12)}…\n`);
     process.stdout.write(`Source:  ${sourceLabel}\n`);
@@ -96,11 +96,11 @@ async function runWhoami() {
 async function runRunner() {
     const credentials = resolveFleetConfig(process.env);
     if (!credentials) {
-        throw new Error("REFLEET_API_URL and REFLEET_API_KEY are both required — this runner only supports fleet mode. Run 'refleet-runner login' (or set them directly) first.");
+        throw new Error("REFLEET_API_URL and REFLEET_API_KEY are both required — this runner only supports fleet mode. Run 'refleet login' (or set them directly) first.");
     }
     const controller = new AbortController();
     const stop = () => {
-        process.stdout.write('refleet-runner: shutting down after the current job\n');
+        process.stdout.write('refleet: shutting down after the current job\n');
         controller.abort();
     };
     process.once('SIGINT', stop);
@@ -114,7 +114,7 @@ async function runRunner() {
         }
         // Reached only through an unexpected exception inside a poll loop: exit non-zero so
         // the supervisor (Docker restart policy, systemd) restarts the whole runner.
-        process.stderr.write(`refleet-runner: fleet loop died: ${errorMessage(err)}\n`);
+        process.stderr.write(`refleet: fleet loop died: ${errorMessage(err)}\n`);
         process.exitCode = 1;
     }
 }
@@ -134,13 +134,13 @@ async function main() {
             await runRunner();
             return;
         default:
-            process.stderr.write(`refleet-runner: unknown command ${JSON.stringify(command ?? '')}\n`);
-            process.stderr.write('Usage: refleet-runner <login|logout|whoami|run>\n');
+            process.stderr.write(`refleet: unknown command ${JSON.stringify(command ?? '')}\n`);
+            process.stderr.write('Usage: refleet <login|logout|whoami|run>\n');
             process.exitCode = 1;
     }
 }
 /**
- * npm links bin entries as symlinks, so argv[1] is node_modules/.bin/refleet-runner while
+ * npm links bin entries as symlinks, so argv[1] is node_modules/.bin/refleet while
  * import.meta.url is the resolved dist/cli.js — comparing them raw made the installed CLI a
  * silent no-op. Resolve the symlink, and build the URL rather than concatenating it so paths
  * with spaces compare correctly too.
@@ -159,7 +159,7 @@ function isMainModule() {
 }
 if (isMainModule()) {
     main().catch((err) => {
-        process.stderr.write(`refleet-runner: ${errorMessage(err)}\n`);
+        process.stderr.write(`refleet: ${errorMessage(err)}\n`);
         process.exitCode = 1;
     });
 }

package/dist/config.js

@@ -2,7 +2,7 @@ import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 /**
- * Local login credentials saved by `refleet-runner login`, read back by `whoami`/
+ * Local login credentials saved by `refleet login`, read back by `whoami`/
  * `logout` and used by `run` when REFLEET_API_URL/REFLEET_API_KEY aren't set.
  * Lives under XDG_CONFIG_HOME (falling back to ~/.config, the convention
  * most CLI tools on the host already follow) rather than inside this repo, since

package/dist/detect.js

@@ -46,7 +46,7 @@ export function resolveExecutable(command, env, isExecutable = defaultIsExecutab
 }
 /**
  * Detects which of the supported agent CLIs are available on this host — the
- * auto-detection this whole runner redesign is for. Called once when `refleet-runner
+ * auto-detection this whole runner redesign is for. Called once when `refleet
  * run` starts (see fleet/loop.ts); a CLI installed after that requires a restart, not
  * a live re-probe.
  */

package/dist/fleet/gitlab.js

@@ -1,3 +1,10 @@
+/**
+ * Every merge request a runner opens carries this label so customers can tell Refleet's
+ * work from their own. The backend creates it in the group at sync time; the runner only
+ * falls back to a project label when it is missing, because GitLab would otherwise invent
+ * one in a random colour the moment the MR is created.
+ */
+export const REFLEET_LABEL = { name: 'refleet', color: '#000000', description: 'Merge requests opened by Refleet' };
 export class GitLabRequestError extends Error {
     status;
     constructor(message, status) {
@@ -31,6 +38,28 @@ async function findOpenMergeRequest(credentials, projectId, spec, fetchFn) {
     const list = (await response.json());
     return list[0]?.web_url ?? null;
 }
+/**
+ * Returns true when the label is available to the project (its own or inherited from an
+ * ancestor group) by the time it returns. Never throws: a missing label is worth a warning,
+ * not a failed job — the MR itself is what the shift is about.
+ */
+export async function ensureRefleetLabel(credentials, projectId, fetchFn = fetch) {
+    try {
+        const query = new URLSearchParams({ search: REFLEET_LABEL.name, include_ancestor_groups: 'true', per_page: '100' });
+        const listed = await gitlabRequest(credentials, fetchFn, 'GET', `/projects/${projectId}/labels?${query.toString()}`);
+        if (listed.ok) {
+            const labels = (await listed.json());
+            if (labels.some(label => label.name === REFLEET_LABEL.name)) {
+                return true;
+            }
+        }
+        const created = await gitlabRequest(credentials, fetchFn, 'POST', `/projects/${projectId}/labels`, REFLEET_LABEL);
+        return created.ok || 409 === created.status;
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Opens a merge request straight through the GitLab REST API — the branch has already
  * been pushed by publishChange, so unlike `glab mr create --push` this never needs
@@ -46,6 +75,7 @@ export async function createMergeRequest(credentials, projectId, spec, fetchFn =
         target_branch: spec.targetBranch,
         title: spec.title,
         description: spec.description,
+        ...(spec.labels ? { labels: spec.labels.join(',') } : {}),
         remove_source_branch: true,
     });
     if (409 === response.status) {

package/dist/fleet/workspace.js

@@ -1,7 +1,7 @@
 import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, utimesSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { gitAuthConfig } from './git.js';
-import { createMergeRequest } from './gitlab.js';
+import { createMergeRequest, ensureRefleetLabel, REFLEET_LABEL } from './gitlab.js';
 const LAST_USED_MARKER = '.slipway-last-used';
 function directorySizeBytes(dir) {
     let total = 0;
@@ -119,6 +119,12 @@ export async function publishChange(workspace, credentials, repoDir, project, sh
     }
     await workspace.git(['-c', 'user.name=Slipway', '-c', 'user.email=slipway@localhost', 'commit', '-m', title], repoDir);
     await workspace.git([...gitAuthConfig(credentials.accessToken), 'push', '--force', 'origin', `HEAD:refs/heads/${branchName}`], repoDir);
-    const mergeRequestUrl = await createMergeRequest(credentials, project.externalId, { sourceBranch: branchName, targetBranch: project.defaultBranch, title, description }, fetchFn);
+    // Without the label in place GitLab would create it in a random colour, so the MR
+    // rather goes out unlabelled than off-brand.
+    const labelled = await ensureRefleetLabel(credentials, project.externalId, fetchFn);
+    if (!labelled) {
+        workspace.log(`could not ensure the "${REFLEET_LABEL.name}" label on ${project.path}; opening the merge request without it`);
+    }
+    const mergeRequestUrl = await createMergeRequest(credentials, project.externalId, { sourceBranch: branchName, targetBranch: project.defaultBranch, title, description, labels: labelled ? [REFLEET_LABEL.name] : undefined }, fetchFn);
     return { branchName, mergeRequestUrl };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@refleet-it/runner",
-  "version": "0.1.186",
+  "version": "0.1.197",
   "description": "Refleet fleet runner: claims code-modernisation jobs from the Refleet API and runs them through Claude Code or Kiro on your own machine.",
   "keywords": [
     "refleet",
@@ -22,6 +22,7 @@
   "license": "MIT",
   "type": "module",
   "bin": {
+    "refleet": "dist/cli.js",
     "refleet-runner": "dist/cli.js"
   },
   "engines": {