crewly 1.20.123 → 1.20.124

package/dist/cli/backend/src/services/harness/harness-install.service.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Harness install — `npm install -g <pkg>@latest` as an async job.
+ *
+ * When the global prefix is not writable (EACCES / EPERM), the install is
+ * retried once under the user-owned prefix `<crewlyHome>/npm-global`
+ * (`npm install -g --prefix …`); its `bin` dir is on the PATH of everything
+ * Crewly spawns (harness-exec.utils). No sudo, no shell profile edits.
+ *
+ * One install runs per harness at a time: starting a second one while the
+ * first is running returns the running job.
+ *
+ * @module services/harness/harness-install.service
+ */
+import { type HarnessId, type HarnessLogger, type InstallJob, type RunCommand } from './harness.types.js';
+/** Injectable dependencies. */
+export interface HarnessInstallDeps {
+    run?: RunCommand;
+    env?: NodeJS.ProcessEnv;
+    /** Creates the user prefix dir */
+    mkdirp?: (dir: string) => void;
+    now?: () => number;
+    idFactory?: () => string;
+    logger?: HarnessLogger;
+    /** Called after a successful install (e.g. to refresh status caches) */
+    onInstalled?: (harnessId: HarnessId) => void;
+}
+/** Error with a machine-readable code, for the REST layer. */
+export declare class HarnessInstallError extends Error {
+    readonly code: 'unknown_harness' | 'job_not_found';
+    /**
+     * @param code - `unknown_harness` or `job_not_found`
+     * @param message - Human-readable message
+     */
+    constructor(code: 'unknown_harness' | 'job_not_found', message: string);
+}
+/**
+ * Whether npm output says the global prefix is not writable.
+ *
+ * @param output - npm stdout + stderr
+ * @returns True for EACCES / EPERM / permission denied
+ */
+export declare function isPermissionError(output: string): boolean;
+/** Runs and tracks harness install jobs. */
+export declare class HarnessInstallService {
+    private readonly run;
+    private readonly env;
+    private readonly mkdirp;
+    private readonly now;
+    private readonly idFactory;
+    private readonly logger;
+    private readonly onInstalled?;
+    private readonly jobs;
+    /**
+     * @param deps - Injectable dependencies (all optional)
+     */
+    constructor(deps?: HarnessInstallDeps);
+    /**
+     * Start installing (or updating) a harness.
+     *
+     * @param harnessId - Harness id
+     * @returns The new job, or the job already running for this harness
+     * @throws HarnessInstallError `unknown_harness`
+     */
+    startInstall(harnessId: string): InstallJob;
+    /**
+     * Look up a job.
+     *
+     * @param jobId - Job id
+     * @returns The job
+     * @throws HarnessInstallError `job_not_found`
+     */
+    getJob(jobId: string): InstallJob;
+    /**
+     * Wait for a job to finish (CLI).
+     *
+     * @param jobId - Job id
+     * @returns The finished job
+     * @throws HarnessInstallError `job_not_found`
+     */
+    waitForJob(jobId: string): Promise<InstallJob>;
+    /**
+     * Run npm, falling back to the user prefix on a permission error.
+     *
+     * @param record - Job record (mutated)
+     * @param npmPackage - Package to install
+     * @returns The finished job
+     */
+    private execute;
+    /**
+     * Append to a job log, keeping only the tail.
+     *
+     * @param record - Job record
+     * @param text - Text to append
+     */
+    private append;
+    /** Forget finished jobs older than the retention window. */
+    private pruneFinished;
+    /**
+     * Public view of a job.
+     *
+     * @param record - Job record
+     * @returns Contract shape
+     */
+    private toPublic;
+}
+//# sourceMappingURL=harness-install.service.d.ts.map

package/dist/cli/backend/src/services/harness/harness-install.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-install.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/harness/harness-install.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAAyB,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEjI,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IAClC,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,kCAAkC;IAClC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,wEAAwE;IACxE,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;CAC7C;AAED,8DAA8D;AAC9D,qBAAa,mBAAoB,SAAQ,KAAK;aAM5B,IAAI,EAAE,iBAAiB,GAAG,eAAe;IAL1D;;;OAGG;gBAEc,IAAI,EAAE,iBAAiB,GAAG,eAAe,EACzD,OAAO,EAAE,MAAM;CAKhB;AASD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,4CAA4C;AAC5C,qBAAa,qBAAqB;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IAErD;;OAEG;gBACS,IAAI,GAAE,kBAAuB;IAUzC;;;;;;OAMG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU;IAqB3C;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAMjC;;;;;;OAMG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAOpD;;;;;;OAMG;YACW,OAAO;IAuCrB;;;;;OAKG;IACH,OAAO,CAAC,MAAM;IAMd,4DAA4D;IAC5D,OAAO,CAAC,aAAa;IAOrB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;CAShB"}

package/dist/cli/backend/src/services/harness/harness-install.service.js

@@ -0,0 +1,205 @@
+/**
+ * Harness install — `npm install -g <pkg>@latest` as an async job.
+ *
+ * When the global prefix is not writable (EACCES / EPERM), the install is
+ * retried once under the user-owned prefix `<crewlyHome>/npm-global`
+ * (`npm install -g --prefix …`); its `bin` dir is on the PATH of everything
+ * Crewly spawns (harness-exec.utils). No sudo, no shell profile edits.
+ *
+ * One install runs per harness at a time: starting a second one while the
+ * first is running returns the running job.
+ *
+ * @module services/harness/harness-install.service
+ */
+import { randomUUID } from 'crypto';
+import * as fs from 'fs';
+import { HARNESS_CONSTANTS } from '../../constants.js';
+import { buildNpmPath, getUserNpmPrefix, runCommand } from './harness-exec.utils.js';
+import { getHarnessDefinition } from './harness-registry.js';
+import { SILENT_HARNESS_LOGGER } from './harness.types.js';
+/** Error with a machine-readable code, for the REST layer. */
+export class HarnessInstallError extends Error {
+    code;
+    /**
+     * @param code - `unknown_harness` or `job_not_found`
+     * @param message - Human-readable message
+     */
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'HarnessInstallError';
+    }
+}
+/**
+ * Whether npm output says the global prefix is not writable.
+ *
+ * @param output - npm stdout + stderr
+ * @returns True for EACCES / EPERM / permission denied
+ */
+export function isPermissionError(output) {
+    const lower = output.toLowerCase();
+    return HARNESS_CONSTANTS.PERMISSION_ERROR_PATTERNS.some((pattern) => lower.includes(pattern.toLowerCase()));
+}
+/** Runs and tracks harness install jobs. */
+export class HarnessInstallService {
+    run;
+    env;
+    mkdirp;
+    now;
+    idFactory;
+    logger;
+    onInstalled;
+    jobs = new Map();
+    /**
+     * @param deps - Injectable dependencies (all optional)
+     */
+    constructor(deps = {}) {
+        this.run = deps.run ?? runCommand;
+        this.env = deps.env ?? process.env;
+        this.mkdirp = deps.mkdirp ?? ((dir) => fs.mkdirSync(dir, { recursive: true }));
+        this.now = deps.now ?? Date.now;
+        this.idFactory = deps.idFactory ?? randomUUID;
+        this.logger = deps.logger ?? SILENT_HARNESS_LOGGER;
+        this.onInstalled = deps.onInstalled;
+    }
+    /**
+     * Start installing (or updating) a harness.
+     *
+     * @param harnessId - Harness id
+     * @returns The new job, or the job already running for this harness
+     * @throws HarnessInstallError `unknown_harness`
+     */
+    startInstall(harnessId) {
+        const def = getHarnessDefinition(harnessId);
+        if (!def)
+            throw new HarnessInstallError('unknown_harness', `Unknown harness: ${harnessId}`);
+        this.pruneFinished();
+        const running = [...this.jobs.values()].find((job) => job.harnessId === def.id && job.state === 'running');
+        if (running)
+            return this.toPublic(running);
+        const record = {
+            jobId: this.idFactory(),
+            harnessId: def.id,
+            state: 'running',
+            log: '',
+            usedUserPrefix: false,
+            finishedAt: null,
+            done: null,
+        };
+        this.jobs.set(record.jobId, record);
+        record.done = this.execute(record, def.npmPackage);
+        return this.toPublic(record);
+    }
+    /**
+     * Look up a job.
+     *
+     * @param jobId - Job id
+     * @returns The job
+     * @throws HarnessInstallError `job_not_found`
+     */
+    getJob(jobId) {
+        const record = this.jobs.get(jobId);
+        if (!record)
+            throw new HarnessInstallError('job_not_found', `Install job not found: ${jobId}`);
+        return this.toPublic(record);
+    }
+    /**
+     * Wait for a job to finish (CLI).
+     *
+     * @param jobId - Job id
+     * @returns The finished job
+     * @throws HarnessInstallError `job_not_found`
+     */
+    async waitForJob(jobId) {
+        const record = this.jobs.get(jobId);
+        if (!record)
+            throw new HarnessInstallError('job_not_found', `Install job not found: ${jobId}`);
+        if (record.done)
+            await record.done;
+        return this.toPublic(record);
+    }
+    /**
+     * Run npm, falling back to the user prefix on a permission error.
+     *
+     * @param record - Job record (mutated)
+     * @param npmPackage - Package to install
+     * @returns The finished job
+     */
+    async execute(record, npmPackage) {
+        const spec = `${npmPackage}@latest`;
+        const env = { ...this.env, PATH: buildNpmPath(this.env.PATH) };
+        try {
+            this.append(record, `$ npm install -g ${spec}\n`);
+            const first = await this.run('npm', ['install', '-g', spec], {
+                env,
+                timeoutMs: HARNESS_CONSTANTS.INSTALL_TIMEOUT_MS,
+                onOutput: (chunk) => this.append(record, chunk),
+            });
+            let ok = first.code === 0;
+            if (!ok && isPermissionError(`${first.stdout}\n${first.stderr}\n${first.error ?? ''}`)) {
+                const prefix = getUserNpmPrefix();
+                this.mkdirp(prefix);
+                record.usedUserPrefix = true;
+                this.append(record, `\nNo permission to write the global npm prefix; installing under ${prefix} instead.\n`);
+                this.append(record, `$ npm install -g --prefix ${prefix} ${spec}\n`);
+                const second = await this.run('npm', ['install', '-g', '--prefix', prefix, spec], {
+                    env,
+                    timeoutMs: HARNESS_CONSTANTS.INSTALL_TIMEOUT_MS,
+                    onOutput: (chunk) => this.append(record, chunk),
+                });
+                ok = second.code === 0;
+                if (!ok && second.error)
+                    this.append(record, `\n${second.error}\n`);
+            }
+            else if (!ok && first.error) {
+                this.append(record, `\n${first.error}\n`);
+            }
+            record.state = ok ? 'succeeded' : 'failed';
+            this.append(record, ok ? '\nInstalled.\n' : '\nInstall failed.\n');
+            if (ok)
+                this.onInstalled?.(record.harnessId);
+        }
+        catch (error) {
+            record.state = 'failed';
+            this.append(record, `\n${error instanceof Error ? error.message : String(error)}\n`);
+        }
+        record.finishedAt = this.now();
+        this.logger.info('Harness install finished', { harnessId: record.harnessId, state: record.state, usedUserPrefix: record.usedUserPrefix });
+        return this.toPublic(record);
+    }
+    /**
+     * Append to a job log, keeping only the tail.
+     *
+     * @param record - Job record
+     * @param text - Text to append
+     */
+    append(record, text) {
+        const next = record.log + text;
+        const max = HARNESS_CONSTANTS.INSTALL_LOG_MAX_CHARS;
+        record.log = next.length > max ? next.slice(next.length - max) : next;
+    }
+    /** Forget finished jobs older than the retention window. */
+    pruneFinished() {
+        const cutoff = this.now() - HARNESS_CONSTANTS.INSTALL_JOB_RETENTION_MS;
+        for (const [id, job] of this.jobs) {
+            if (job.finishedAt !== null && job.finishedAt < cutoff)
+                this.jobs.delete(id);
+        }
+    }
+    /**
+     * Public view of a job.
+     *
+     * @param record - Job record
+     * @returns Contract shape
+     */
+    toPublic(record) {
+        return {
+            jobId: record.jobId,
+            harnessId: record.harnessId,
+            state: record.state,
+            log: record.log,
+            usedUserPrefix: record.usedUserPrefix,
+        };
+    }
+}
+//# sourceMappingURL=harness-install.service.js.map

package/dist/cli/backend/src/services/harness/harness-install.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-install.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/harness/harness-install.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAwE,MAAM,oBAAoB,CAAC;AAejI,8DAA8D;AAC9D,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAM5B;IALjB;;;OAGG;IACH,YACiB,IAAyC,EACzD,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAqC;QAIzD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,CAAC;CACD;AASD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,OAAO,iBAAiB,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAC7G,CAAC;AAED,4CAA4C;AAC5C,MAAM,OAAO,qBAAqB;IAChB,GAAG,CAAa;IAChB,GAAG,CAAoB;IACvB,MAAM,CAAwB;IAC9B,GAAG,CAAe;IAClB,SAAS,CAAe;IACxB,MAAM,CAAgB;IACtB,WAAW,CAAkC;IAC7C,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;IAErD;;OAEG;IACH,YAAY,OAA2B,EAAE;QACxC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC;QAClC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC/E,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,UAAU,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,qBAAqB,CAAC;QACnD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CAAC,SAAiB;QAC7B,MAAM,GAAG,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,mBAAmB,CAAC,iBAAiB,EAAE,oBAAoB,SAAS,EAAE,CAAC,CAAC;QAC5F,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;QAC3G,IAAI,OAAO;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE3C,MAAM,MAAM,GAAc;YACzB,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE;YACvB,SAAS,EAAE,GAAG,CAAC,EAAE;YACjB,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,EAAE;YACP,cAAc,EAAE,KAAK;YACrB,UAAU,EAAE,IAAI;YAChB,IAAI,EAAE,IAAI;SACV,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,KAAa;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,mBAAmB,CAAC,eAAe,EAAE,0BAA0B,KAAK,EAAE,CAAC,CAAC;QAC/F,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAAC,KAAa;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,mBAAmB,CAAC,eAAe,EAAE,0BAA0B,KAAK,EAAE,CAAC,CAAC;QAC/F,IAAI,MAAM,CAAC,IAAI;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC;QACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,OAAO,CAAC,MAAiB,EAAE,UAAkB;QAC1D,MAAM,IAAI,GAAG,GAAG,UAAU,SAAS,CAAC;QACpC,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC;YACJ,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,IAAI,IAAI,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;gBAC5D,GAAG;gBACH,SAAS,EAAE,iBAAiB,CAAC,kBAAkB;gBAC/C,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;aAC/C,CAAC,CAAC;YACH,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,EAAE,IAAI,iBAAiB,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;gBACxF,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;gBAClC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACpB,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;gBAC7B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,oEAAoE,MAAM,aAAa,CAAC,CAAC;gBAC7G,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,6BAA6B,MAAM,IAAI,IAAI,IAAI,CAAC,CAAC;gBACrE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;oBACjF,GAAG;oBACH,SAAS,EAAE,iBAAiB,CAAC,kBAAkB;oBAC/C,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;iBAC/C,CAAC,CAAC;gBACH,EAAE,GAAG,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC;gBACvB,IAAI,CAAC,EAAE,IAAI,MAAM,CAAC,KAAK;oBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;YACrE,CAAC;iBAAM,IAAI,CAAC,EAAE,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;YAC3C,CAAC;YACD,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;YACnE,IAAI,EAAE;gBAAE,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtF,CAAC;QACD,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QAC1I,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,MAAiB,EAAE,IAAY;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC;QAC/B,MAAM,GAAG,GAAG,iBAAiB,CAAC,qBAAqB,CAAC;QACpD,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,CAAC;IAED,4DAA4D;IACpD,aAAa;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,iBAAiB,CAAC,wBAAwB,CAAC;QACvE,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,GAAG,MAAM;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;IACF,CAAC;IAED;;;;;OAKG;IACK,QAAQ,CAAC,MAAiB;QACjC,OAAO;YACN,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,cAAc,EAAE,MAAM,CAAC,cAAc;SACrC,CAAC;IACH,CAAC;CACD"}

package/dist/cli/backend/src/services/harness/harness-registry.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Harness registry — static definitions of the agent CLIs Crewly can set up.
+ *
+ * One entry per harness: display name, binary, npm package, how to print the
+ * version, and the login methods Crewly offers. A `broker` method names the
+ * harness's own login command, which the login broker runs in a PTY; an
+ * `api_key` method is a pasted key. Gemini CLI is detect-only (no methods).
+ *
+ * @module services/harness/harness-registry
+ */
+import type { HarnessId, HarnessLoginMethod, LoginMethodId, LoginMethodKind } from './harness.types.js';
+/** The command a broker login method runs. */
+export interface BrokerCommand {
+    /** Binary (resolved on the harness PATH) */
+    command: string;
+    args: readonly string[];
+}
+/** A login method definition (internal: includes the broker command). */
+export interface LoginMethodDefinition {
+    id: LoginMethodId;
+    label: string;
+    kind: LoginMethodKind;
+    /** Command run by the login broker (kind `broker` only) */
+    broker?: BrokerCommand;
+}
+/** Static facts about one harness. */
+export interface HarnessDefinition {
+    id: HarnessId;
+    displayName: string;
+    /** Binary name on PATH */
+    command: string;
+    npmPackage: string;
+    /** Arguments that print the version */
+    versionArgs: readonly string[];
+    loginMethods: readonly LoginMethodDefinition[];
+}
+/** Every harness Crewly knows, in display order (default first). */
+export declare const HARNESS_DEFINITIONS: readonly HarnessDefinition[];
+/**
+ * All harness definitions.
+ *
+ * @returns The registry, in display order
+ */
+export declare function listHarnessDefinitions(): readonly HarnessDefinition[];
+/**
+ * Look up a harness definition.
+ *
+ * @param id - Harness id
+ * @returns The definition, or undefined for an unknown id
+ */
+export declare function getHarnessDefinition(id: string): HarnessDefinition | undefined;
+/**
+ * Look up one login method of a harness.
+ *
+ * @param harnessId - Harness id
+ * @param methodId - Login method id
+ * @returns The method, or undefined when the harness does not offer it
+ */
+export declare function getLoginMethod(harnessId: string, methodId: string): LoginMethodDefinition | undefined;
+/**
+ * The broker login method of a harness (the first one), if any.
+ *
+ * @param harnessId - Harness id
+ * @returns The method, or undefined when the harness has no broker login
+ */
+export declare function getBrokerLoginMethod(harnessId: string): LoginMethodDefinition | undefined;
+/**
+ * Public view of a harness's login methods (no commands).
+ *
+ * @param def - Harness definition
+ * @returns `{ id, label, kind }` per method
+ */
+export declare function toPublicLoginMethods(def: HarnessDefinition): HarnessLoginMethod[];
+/**
+ * Resolve a harness id from a full id or a short CLI alias.
+ *
+ * @param value - `claude-code`, `claude`, `codex-cli`, `codex`, `gemini-cli` or `gemini` (case-insensitive)
+ * @returns The harness id, or null when unknown
+ *
+ * @example
+ * ```ts
+ * resolveHarnessAlias('codex'); // 'codex-cli'
+ * ```
+ */
+export declare function resolveHarnessAlias(value: string | undefined | null): HarnessId | null;
+//# sourceMappingURL=harness-registry.d.ts.map

package/dist/cli/backend/src/services/harness/harness-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-registry.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/harness/harness-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGxG,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC7B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACxB;AAED,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACrC,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;IACtB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,SAAS,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,YAAY,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC/C;AAED,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,EAAE,SAAS,iBAAiB,EAyC3D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,SAAS,iBAAiB,EAAE,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAE9E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAErG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAEzF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,kBAAkB,EAAE,CAEjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAMtF"}

package/dist/cli/backend/src/services/harness/harness-registry.js

@@ -0,0 +1,121 @@
+/**
+ * Harness registry — static definitions of the agent CLIs Crewly can set up.
+ *
+ * One entry per harness: display name, binary, npm package, how to print the
+ * version, and the login methods Crewly offers. A `broker` method names the
+ * harness's own login command, which the login broker runs in a PTY; an
+ * `api_key` method is a pasted key. Gemini CLI is detect-only (no methods).
+ *
+ * @module services/harness/harness-registry
+ */
+import { HARNESS_CONSTANTS } from '../../constants.js';
+import { isHarnessId } from './harness.types.js';
+/** Every harness Crewly knows, in display order (default first). */
+export const HARNESS_DEFINITIONS = [
+    {
+        id: HARNESS_CONSTANTS.IDS.CLAUDE_CODE,
+        displayName: 'Claude Code',
+        command: 'claude',
+        npmPackage: '@anthropic-ai/claude-code',
+        versionArgs: ['--version'],
+        loginMethods: [
+            {
+                id: 'subscription',
+                label: 'Claude subscription (Pro / Max)',
+                kind: 'broker',
+                broker: { command: 'claude', args: ['setup-token'] },
+            },
+            { id: 'api_key', label: 'Anthropic API key', kind: 'api_key' },
+        ],
+    },
+    {
+        id: HARNESS_CONSTANTS.IDS.CODEX_CLI,
+        displayName: 'Codex',
+        command: 'codex',
+        npmPackage: '@openai/codex',
+        versionArgs: ['--version'],
+        loginMethods: [
+            {
+                id: 'device',
+                label: 'ChatGPT account (device code)',
+                kind: 'broker',
+                broker: { command: 'codex', args: ['login', '--device-auth'] },
+            },
+            { id: 'api_key', label: 'OpenAI API key', kind: 'api_key' },
+        ],
+    },
+    {
+        id: HARNESS_CONSTANTS.IDS.GEMINI_CLI,
+        displayName: 'Gemini CLI',
+        command: 'gemini',
+        npmPackage: '@google/gemini-cli',
+        versionArgs: ['--version'],
+        loginMethods: [],
+    },
+];
+/**
+ * All harness definitions.
+ *
+ * @returns The registry, in display order
+ */
+export function listHarnessDefinitions() {
+    return HARNESS_DEFINITIONS;
+}
+/**
+ * Look up a harness definition.
+ *
+ * @param id - Harness id
+ * @returns The definition, or undefined for an unknown id
+ */
+export function getHarnessDefinition(id) {
+    return HARNESS_DEFINITIONS.find((def) => def.id === id);
+}
+/**
+ * Look up one login method of a harness.
+ *
+ * @param harnessId - Harness id
+ * @param methodId - Login method id
+ * @returns The method, or undefined when the harness does not offer it
+ */
+export function getLoginMethod(harnessId, methodId) {
+    return getHarnessDefinition(harnessId)?.loginMethods.find((method) => method.id === methodId);
+}
+/**
+ * The broker login method of a harness (the first one), if any.
+ *
+ * @param harnessId - Harness id
+ * @returns The method, or undefined when the harness has no broker login
+ */
+export function getBrokerLoginMethod(harnessId) {
+    return getHarnessDefinition(harnessId)?.loginMethods.find((method) => method.kind === 'broker');
+}
+/**
+ * Public view of a harness's login methods (no commands).
+ *
+ * @param def - Harness definition
+ * @returns `{ id, label, kind }` per method
+ */
+export function toPublicLoginMethods(def) {
+    return def.loginMethods.map(({ id, label, kind }) => ({ id, label, kind }));
+}
+/**
+ * Resolve a harness id from a full id or a short CLI alias.
+ *
+ * @param value - `claude-code`, `claude`, `codex-cli`, `codex`, `gemini-cli` or `gemini` (case-insensitive)
+ * @returns The harness id, or null when unknown
+ *
+ * @example
+ * ```ts
+ * resolveHarnessAlias('codex'); // 'codex-cli'
+ * ```
+ */
+export function resolveHarnessAlias(value) {
+    if (!value)
+        return null;
+    const key = value.trim().toLowerCase();
+    if (isHarnessId(key))
+        return key;
+    const aliases = HARNESS_CONSTANTS.CLI_ALIASES;
+    return aliases[key] ?? null;
+}
+//# sourceMappingURL=harness-registry.js.map

package/dist/cli/backend/src/services/harness/harness-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-registry.js","sourceRoot":"","sources":["../../../../../../backend/src/services/harness/harness-registry.ts"],"names":[],"mappings":"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"}