@osfactory/har 0.32.2 → 0.33.0

package/dist/index.js

@@ -873,14 +873,14 @@ var require_url_state_machine = __commonJS({
       return url.replace(/\u0009|\u000A|\u000D/g, "");
     }
     function shortenPath(url) {
-      const path58 = url.path;
-      if (path58.length === 0) {
+      const path60 = url.path;
+      if (path60.length === 0) {
         return;
       }
-      if (url.scheme === "file" && path58.length === 1 && isNormalizedWindowsDriveLetter(path58[0])) {
+      if (url.scheme === "file" && path60.length === 1 && isNormalizedWindowsDriveLetter(path60[0])) {
         return;
       }
-      path58.pop();
+      path60.pop();
     }
     function includesCredentials(url) {
       return url.username !== "" || url.password !== "";
@@ -2200,7 +2200,7 @@ var require_lib2 = __commonJS({
       let accum = [];
       let accumBytes = 0;
       let abort = false;
-      return new Body.Promise(function(resolve42, reject) {
+      return new Body.Promise(function(resolve44, reject) {
         let resTimeout;
         if (_this4.timeout) {
           resTimeout = setTimeout(function() {
@@ -2234,7 +2234,7 @@ var require_lib2 = __commonJS({
           }
           clearTimeout(resTimeout);
           try {
-            resolve42(Buffer.concat(accum, accumBytes));
+            resolve44(Buffer.concat(accum, accumBytes));
           } catch (err) {
             reject(new FetchError(`Could not create Buffer from response body for ${_this4.url}: ${err.message}`, "system", err));
           }
@@ -2909,7 +2909,7 @@ var require_lib2 = __commonJS({
         throw new Error("native promise missing, set fetch.Promise to your favorite alternative");
       }
       Body.Promise = fetch3.Promise;
-      return new fetch3.Promise(function(resolve42, reject) {
+      return new fetch3.Promise(function(resolve44, reject) {
         const request = new Request3(url, opts);
         const options = getNodeRequestOptions(request);
         const send = (options.protocol === "https:" ? https : http2).request;
@@ -3042,7 +3042,7 @@ var require_lib2 = __commonJS({
                   requestOpts.body = void 0;
                   requestOpts.headers.delete("content-length");
                 }
-                resolve42(fetch3(new Request3(locationURL, requestOpts)));
+                resolve44(fetch3(new Request3(locationURL, requestOpts)));
                 finalize();
                 return;
             }
@@ -3063,7 +3063,7 @@ var require_lib2 = __commonJS({
           const codings = headers.get("Content-Encoding");
           if (!request.compress || request.method === "HEAD" || codings === null || res.statusCode === 204 || res.statusCode === 304) {
             response = new Response3(body, response_options);
-            resolve42(response);
+            resolve44(response);
             return;
           }
           const zlibOptions = {
@@ -3073,7 +3073,7 @@ var require_lib2 = __commonJS({
           if (codings == "gzip" || codings == "x-gzip") {
             body = body.pipe(zlib.createGunzip(zlibOptions));
             response = new Response3(body, response_options);
-            resolve42(response);
+            resolve44(response);
             return;
           }
           if (codings == "deflate" || codings == "x-deflate") {
@@ -3085,12 +3085,12 @@ var require_lib2 = __commonJS({
                 body = body.pipe(zlib.createInflateRaw());
               }
               response = new Response3(body, response_options);
-              resolve42(response);
+              resolve44(response);
             });
             raw.on("end", function() {
               if (!response) {
                 response = new Response3(body, response_options);
-                resolve42(response);
+                resolve44(response);
               }
             });
             return;
@@ -3098,11 +3098,11 @@ var require_lib2 = __commonJS({
           if (codings == "br" && typeof zlib.createBrotliDecompress === "function") {
             body = body.pipe(zlib.createBrotliDecompress());
             response = new Response3(body, response_options);
-            resolve42(response);
+            resolve44(response);
             return;
           }
           response = new Response3(body, response_options);
-          resolve42(response);
+          resolve44(response);
         });
         writeToStream(req, request);
       });
@@ -6459,14 +6459,14 @@ __export(fileFromPath_exports, {
   fileFromPathSync: () => fileFromPathSync,
   isFile: () => isFile
 });
-function createFileFromPath(path58, { mtimeMs, size }, filenameOrOptions, options = {}) {
+function createFileFromPath(path60, { mtimeMs, size }, filenameOrOptions, options = {}) {
   let filename;
   if (isPlainObject_default2(filenameOrOptions)) {
     [options, filename] = [filenameOrOptions, void 0];
   } else {
     filename = filenameOrOptions;
   }
-  const file = new FileFromPath({ path: path58, size, lastModified: mtimeMs });
+  const file = new FileFromPath({ path: path60, size, lastModified: mtimeMs });
   if (!filename) {
     filename = file.name;
   }
@@ -6475,13 +6475,13 @@ function createFileFromPath(path58, { mtimeMs, size }, filenameOrOptions, option
     lastModified: file.lastModified
   });
 }
-function fileFromPathSync(path58, filenameOrOptions, options = {}) {
-  const stats = (0, import_fs5.statSync)(path58);
-  return createFileFromPath(path58, stats, filenameOrOptions, options);
+function fileFromPathSync(path60, filenameOrOptions, options = {}) {
+  const stats = (0, import_fs5.statSync)(path60);
+  return createFileFromPath(path60, stats, filenameOrOptions, options);
 }
-async function fileFromPath2(path58, filenameOrOptions, options) {
-  const stats = await import_fs5.promises.stat(path58);
-  return createFileFromPath(path58, stats, filenameOrOptions, options);
+async function fileFromPath2(path60, filenameOrOptions, options) {
+  const stats = await import_fs5.promises.stat(path60);
+  return createFileFromPath(path60, stats, filenameOrOptions, options);
 }
 var import_fs5, import_path5, import_node_domexception, __classPrivateFieldSet5, __classPrivateFieldGet6, _FileFromPath_path, _FileFromPath_start, MESSAGE, FileFromPath;
 var init_fileFromPath = __esm({
@@ -8181,15 +8181,15 @@ var require_route = __commonJS({
       };
     }
     function wrapConversion(toModel, graph) {
-      const path58 = [graph[toModel].parent, toModel];
+      const path60 = [graph[toModel].parent, toModel];
       let fn = conversions[graph[toModel].parent][toModel];
       let cur = graph[toModel].parent;
       while (graph[cur].parent) {
-        path58.unshift(graph[cur].parent);
+        path60.unshift(graph[cur].parent);
         fn = link(conversions[graph[cur].parent][cur], fn);
         cur = graph[cur].parent;
       }
-      fn.conversion = path58;
+      fn.conversion = path60;
       return fn;
     }
     module2.exports = function(fromModel) {
@@ -17679,16 +17679,16 @@ var require_os_tmpdir = __commonJS({
     var isWindows = process.platform === "win32";
     var trailingSlashRe = isWindows ? /[^:]\\$/ : /.\/$/;
     module2.exports = function() {
-      var path58;
+      var path60;
       if (isWindows) {
-        path58 = process.env.TEMP || process.env.TMP || (process.env.SystemRoot || process.env.windir) + "\\temp";
+        path60 = process.env.TEMP || process.env.TMP || (process.env.SystemRoot || process.env.windir) + "\\temp";
       } else {
-        path58 = process.env.TMPDIR || process.env.TMP || process.env.TEMP || "/tmp";
+        path60 = process.env.TMPDIR || process.env.TMP || process.env.TEMP || "/tmp";
       }
-      if (trailingSlashRe.test(path58)) {
-        path58 = path58.slice(0, -1);
+      if (trailingSlashRe.test(path60)) {
+        path60 = path60.slice(0, -1);
       }
-      return path58;
+      return path60;
     };
   }
 });
@@ -17697,7 +17697,7 @@ var require_os_tmpdir = __commonJS({
 var require_tmp = __commonJS({
   "node_modules/tmp/lib/tmp.js"(exports2, module2) {
     var fs49 = require("fs");
-    var path58 = require("path");
+    var path60 = require("path");
     var crypto6 = require("crypto");
     var osTmpDir = require_os_tmpdir();
     var _c2 = process.binding("constants");
@@ -17739,7 +17739,7 @@ var require_tmp = __commonJS({
     }
     function _generateTmpName(opts) {
       if (opts.name) {
-        return path58.join(opts.dir || tmpDir, opts.name);
+        return path60.join(opts.dir || tmpDir, opts.name);
       }
       if (opts.template) {
         return opts.template.replace(TEMPLATE_PATTERN, _randomChars(6));
@@ -17750,7 +17750,7 @@ var require_tmp = __commonJS({
         _randomChars(12),
         opts.postfix || ""
       ].join("");
-      return path58.join(opts.dir || tmpDir, name);
+      return path60.join(opts.dir || tmpDir, name);
     }
     function tmpName(options, callback) {
       var args = _parseArguments(options, callback), opts = args[0], cb = args[1], tries = opts.name ? 1 : opts.tries || DEFAULT_TRIES;
@@ -17835,7 +17835,7 @@ var require_tmp = __commonJS({
       do {
         var dir2 = dirs.pop(), deferred = false, files = fs49.readdirSync(dir2);
         for (var i2 = 0, length = files.length; i2 < length; i2++) {
-          var file2 = path58.join(dir2, files[i2]), stat = fs49.lstatSync(file2);
+          var file2 = path60.join(dir2, files[i2]), stat = fs49.lstatSync(file2);
           if (stat.isDirectory()) {
             if (!deferred) {
               deferred = true;
@@ -19046,7 +19046,7 @@ var require_Observable = __commonJS({
       Observable2.prototype.forEach = function(next, promiseCtor) {
         var _this = this;
         promiseCtor = getPromiseCtor(promiseCtor);
-        return new promiseCtor(function(resolve42, reject) {
+        return new promiseCtor(function(resolve44, reject) {
           var subscriber = new Subscriber_1.SafeSubscriber({
             next: function(value) {
               try {
@@ -19057,7 +19057,7 @@ var require_Observable = __commonJS({
               }
             },
             error: reject,
-            complete: resolve42
+            complete: resolve44
           });
           _this.subscribe(subscriber);
         });
@@ -19079,14 +19079,14 @@ var require_Observable = __commonJS({
       Observable2.prototype.toPromise = function(promiseCtor) {
         var _this = this;
         promiseCtor = getPromiseCtor(promiseCtor);
-        return new promiseCtor(function(resolve42, reject) {
+        return new promiseCtor(function(resolve44, reject) {
           var value;
           _this.subscribe(function(x2) {
             return value = x2;
           }, function(err) {
             return reject(err);
           }, function() {
-            return resolve42(value);
+            return resolve44(value);
           });
         });
       };
@@ -21182,11 +21182,11 @@ var require_innerFrom = __commonJS({
     "use strict";
     var __awaiter = exports2 && exports2.__awaiter || function(thisArg, _arguments, P3, generator) {
       function adopt(value) {
-        return value instanceof P3 ? value : new P3(function(resolve42) {
-          resolve42(value);
+        return value instanceof P3 ? value : new P3(function(resolve44) {
+          resolve44(value);
         });
       }
-      return new (P3 || (P3 = Promise))(function(resolve42, reject) {
+      return new (P3 || (P3 = Promise))(function(resolve44, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -21202,7 +21202,7 @@ var require_innerFrom = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve42(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve44(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -21284,14 +21284,14 @@ var require_innerFrom = __commonJS({
       }, i2);
       function verb(n2) {
         i2[n2] = o2[n2] && function(v3) {
-          return new Promise(function(resolve42, reject) {
-            v3 = o2[n2](v3), settle(resolve42, reject, v3.done, v3.value);
+          return new Promise(function(resolve44, reject) {
+            v3 = o2[n2](v3), settle(resolve44, reject, v3.done, v3.value);
           });
         };
       }
-      function settle(resolve42, reject, d2, v3) {
+      function settle(resolve44, reject, d2, v3) {
         Promise.resolve(v3).then(function(v4) {
-          resolve42({ value: v4, done: d2 });
+          resolve44({ value: v4, done: d2 });
         }, reject);
       }
     };
@@ -21910,7 +21910,7 @@ var require_lastValueFrom = __commonJS({
     var EmptyError_1 = require_EmptyError();
     function lastValueFrom2(source, config2) {
       var hasConfig = typeof config2 === "object";
-      return new Promise(function(resolve42, reject) {
+      return new Promise(function(resolve44, reject) {
         var _hasValue = false;
         var _value;
         source.subscribe({
@@ -21921,9 +21921,9 @@ var require_lastValueFrom = __commonJS({
           error: reject,
           complete: function() {
             if (_hasValue) {
-              resolve42(_value);
+              resolve44(_value);
             } else if (hasConfig) {
-              resolve42(config2.defaultValue);
+              resolve44(config2.defaultValue);
             } else {
               reject(new EmptyError_1.EmptyError());
             }
@@ -21945,16 +21945,16 @@ var require_firstValueFrom = __commonJS({
     var Subscriber_1 = require_Subscriber();
     function firstValueFrom(source, config2) {
       var hasConfig = typeof config2 === "object";
-      return new Promise(function(resolve42, reject) {
+      return new Promise(function(resolve44, reject) {
         var subscriber = new Subscriber_1.SafeSubscriber({
           next: function(value) {
-            resolve42(value);
+            resolve44(value);
             subscriber.unsubscribe();
           },
           error: reject,
           complete: function() {
             if (hasConfig) {
-              resolve42(config2.defaultValue);
+              resolve44(config2.defaultValue);
             } else {
               reject(new EmptyError_1.EmptyError());
             }
@@ -27747,14 +27747,14 @@ var require_run_async = __commonJS({
       return function() {
         var args = arguments;
         var originalThis = this;
-        var promise = new Promise(function(resolve42, reject) {
+        var promise = new Promise(function(resolve44, reject) {
           var resolved = false;
           const wrappedResolve = function(value) {
             if (resolved) {
               console.warn("Run-async promise already resolved.");
             }
             resolved = true;
-            resolve42(value);
+            resolve44(value);
           };
           var rejected = false;
           const wrappedReject = function(value) {
@@ -30783,7 +30783,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve42.call(this, root, ref);
+      let _sch = resolve44.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
         const { schemaId } = this.opts;
@@ -30810,7 +30810,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve42(root, ref) {
+    function resolve44(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -31028,8 +31028,8 @@ var require_utils2 = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path58) {
-      let input = path58;
+    function removeDotSegments(path60) {
+      let input = path60;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -31281,8 +31281,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path58, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path58 && path58 !== "/" ? path58 : void 0;
+        const [path60, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path60 && path60 !== "/" ? path60 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -31441,7 +31441,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve42(baseURI, relativeURI, options) {
+    function resolve44(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse4(baseURI, schemelessOptions), parse4(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
@@ -31699,7 +31699,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize3,
-      resolve: resolve42,
+      resolve: resolve44,
       resolveComponent,
       equal,
       serialize,
@@ -35964,11 +35964,11 @@ var parser = new YargsParser({
   resolve: import_path2.resolve,
   // TODO: figure  out a  way to combine ESM and CJS coverage, such  that
   // we can exercise all the lines below:
-  require: (path58) => {
+  require: (path60) => {
     if (typeof require !== "undefined") {
-      return require(path58);
-    } else if (path58.match(/\.json$/)) {
-      return JSON.parse((0, import_fs2.readFileSync)(path58, "utf8"));
+      return require(path60);
+    } else if (path60.match(/\.json$/)) {
+      return JSON.parse((0, import_fs2.readFileSync)(path60, "utf8"));
     } else {
       throw Error("only .json config files are supported in ESM");
     }
@@ -38494,12 +38494,12 @@ var YargsInstance = class {
   async getCompletion(args, done) {
     argsert("<array> [function]", [args, done], arguments.length);
     if (!done) {
-      return new Promise((resolve42, reject) => {
+      return new Promise((resolve44, reject) => {
         __classPrivateFieldGet(this, _YargsInstance_completion, "f").getCompletion(args, (err, completions) => {
           if (err)
             reject(err);
           else
-            resolve42(completions);
+            resolve44(completions);
         });
       });
     } else {
@@ -40652,8 +40652,8 @@ function getErrorMap() {
 
 // node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path58, errorMaps, issueData } = params;
-  const fullPath = [...path58, ...issueData.path || []];
+  const { data, path: path60, errorMaps, issueData } = params;
+  const fullPath = [...path60, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -40769,11 +40769,11 @@ var errorUtil;
 
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path58, key) {
+  constructor(parent, value, path60, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path58;
+    this._path = path60;
     this._key = key;
   }
   get path() {
@@ -68312,16 +68312,16 @@ async function handleAgentSkills(options) {
 }
 async function askYesNo(question) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve42) => {
+  return new Promise((resolve44) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve42(true);
+        resolve44(true);
         return;
       }
-      resolve42(/^y(es)?$/i.test(trimmed));
+      resolve44(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -69179,13 +69179,13 @@ var MultipartBody = class {
 // node_modules/@anthropic-ai/sdk/_shims/node-runtime.mjs
 var import_web = require("node:stream/web");
 var fileFromPathWarned = false;
-async function fileFromPath3(path58, ...args) {
+async function fileFromPath3(path60, ...args) {
   const { fileFromPath: _fileFromPath } = await Promise.resolve().then(() => (init_fileFromPath(), fileFromPath_exports));
   if (!fileFromPathWarned) {
-    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path58)}) instead`);
+    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path60)}) instead`);
     fileFromPathWarned = true;
   }
-  return await _fileFromPath(path58, ...args);
+  return await _fileFromPath(path60, ...args);
 }
 var defaultHttpAgent = new import_agentkeepalive.default({ keepAlive: true, timeout: 5 * 60 * 1e3 });
 var defaultHttpsAgent = new import_agentkeepalive.default.HttpsAgent({ keepAlive: true, timeout: 5 * 60 * 1e3 });
@@ -69681,8 +69681,8 @@ async function defaultParseResponse(props) {
 }
 var APIPromise = class _APIPromise extends Promise {
   constructor(responsePromise, parseResponse = defaultParseResponse) {
-    super((resolve42) => {
-      resolve42(null);
+    super((resolve44) => {
+      resolve44(null);
     });
     this.responsePromise = responsePromise;
     this.parseResponse = parseResponse;
@@ -69782,29 +69782,29 @@ var APIClient = class {
   defaultIdempotencyKey() {
     return `stainless-node-retry-${uuid4()}`;
   }
-  get(path58, opts) {
-    return this.methodRequest("get", path58, opts);
+  get(path60, opts) {
+    return this.methodRequest("get", path60, opts);
   }
-  post(path58, opts) {
-    return this.methodRequest("post", path58, opts);
+  post(path60, opts) {
+    return this.methodRequest("post", path60, opts);
   }
-  patch(path58, opts) {
-    return this.methodRequest("patch", path58, opts);
+  patch(path60, opts) {
+    return this.methodRequest("patch", path60, opts);
   }
-  put(path58, opts) {
-    return this.methodRequest("put", path58, opts);
+  put(path60, opts) {
+    return this.methodRequest("put", path60, opts);
   }
-  delete(path58, opts) {
-    return this.methodRequest("delete", path58, opts);
+  delete(path60, opts) {
+    return this.methodRequest("delete", path60, opts);
   }
-  methodRequest(method, path58, opts) {
+  methodRequest(method, path60, opts) {
     return this.request(Promise.resolve(opts).then(async (opts2) => {
       const body = opts2 && isBlobLike(opts2?.body) ? new DataView(await opts2.body.arrayBuffer()) : opts2?.body instanceof DataView ? opts2.body : opts2?.body instanceof ArrayBuffer ? new DataView(opts2.body) : opts2 && ArrayBuffer.isView(opts2?.body) ? new DataView(opts2.body.buffer) : opts2?.body;
-      return { method, path: path58, ...opts2, body };
+      return { method, path: path60, ...opts2, body };
     }));
   }
-  getAPIList(path58, Page, opts) {
-    return this.requestAPIList(Page, { method: "get", path: path58, ...opts });
+  getAPIList(path60, Page, opts) {
+    return this.requestAPIList(Page, { method: "get", path: path60, ...opts });
   }
   calculateContentLength(body) {
     if (typeof body === "string") {
@@ -69822,10 +69822,10 @@ var APIClient = class {
     return null;
   }
   buildRequest(options) {
-    const { method, path: path58, query, headers = {} } = options;
+    const { method, path: path60, query, headers = {} } = options;
     const body = ArrayBuffer.isView(options.body) || options.__binaryRequest && typeof options.body === "string" ? options.body : isMultipartBody(options.body) ? options.body.body : options.body ? JSON.stringify(options.body, null, 2) : null;
     const contentLength = this.calculateContentLength(body);
-    const url = this.buildURL(path58, query);
+    const url = this.buildURL(path60, query);
     if ("timeout" in options)
       validatePositiveInteger("timeout", options.timeout);
     const timeout = options.timeout ?? this.timeout;
@@ -69934,8 +69934,8 @@ var APIClient = class {
     const request = this.makeRequest(options, null);
     return new PagePromise(this, request, Page);
   }
-  buildURL(path58, query) {
-    const url = isAbsoluteURL(path58) ? new URL(path58) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path58.startsWith("/") ? path58.slice(1) : path58));
+  buildURL(path60, query) {
+    const url = isAbsoluteURL(path60) ? new URL(path60) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path60.startsWith("/") ? path60.slice(1) : path60));
     const defaultQuery = this.defaultQuery();
     if (!isEmptyObj(defaultQuery)) {
       query = { ...defaultQuery, ...query };
@@ -70220,7 +70220,7 @@ var startsWithSchemeRegexp = new RegExp("^(?:[a-z]+:)?//", "i");
 var isAbsoluteURL = (url) => {
   return startsWithSchemeRegexp.test(url);
 };
-var sleep = (ms) => new Promise((resolve42) => setTimeout(resolve42, ms));
+var sleep = (ms) => new Promise((resolve44) => setTimeout(resolve44, ms));
 var validatePositiveInteger = (name, n2) => {
   if (typeof n2 !== "number" || !Number.isInteger(n2)) {
     throw new AnthropicError(`${name} must be an integer`);
@@ -70711,12 +70711,12 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
       }
       return this._emit("error", new AnthropicError(String(error3)));
     });
-    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_connectedPromise, new Promise((resolve42, reject) => {
-      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveConnectedPromise, resolve42, "f");
+    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_connectedPromise, new Promise((resolve44, reject) => {
+      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveConnectedPromise, resolve44, "f");
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_rejectConnectedPromise, reject, "f");
     }), "f");
-    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_endPromise, new Promise((resolve42, reject) => {
-      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveEndPromise, resolve42, "f");
+    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_endPromise, new Promise((resolve44, reject) => {
+      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveEndPromise, resolve44, "f");
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_rejectEndPromise, reject, "f");
     }), "f");
     __classPrivateFieldGet8(this, _PromptCachingBetaMessageStream_connectedPromise, "f").catch(() => {
@@ -70845,11 +70845,11 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
    *   const message = await stream.emitted('message') // rejects if the stream errors
    */
   emitted(event) {
-    return new Promise((resolve42, reject) => {
+    return new Promise((resolve44, reject) => {
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_catchingPromiseCreated, true, "f");
       if (event !== "error")
         this.once("error", reject);
-      this.once(event, resolve42);
+      this.once(event, resolve44);
     });
   }
   async done() {
@@ -71076,7 +71076,7 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
           if (done) {
             return { value: void 0, done: true };
           }
-          return new Promise((resolve42, reject) => readQueue.push({ resolve: resolve42, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
+          return new Promise((resolve44, reject) => readQueue.push({ resolve: resolve44, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
         }
         const chunk = pushQueue.shift();
         return { value: chunk, done: false };
@@ -71224,12 +71224,12 @@ var MessageStream = class _MessageStream {
       }
       return this._emit("error", new AnthropicError(String(error3)));
     });
-    __classPrivateFieldSet8(this, _MessageStream_connectedPromise, new Promise((resolve42, reject) => {
-      __classPrivateFieldSet8(this, _MessageStream_resolveConnectedPromise, resolve42, "f");
+    __classPrivateFieldSet8(this, _MessageStream_connectedPromise, new Promise((resolve44, reject) => {
+      __classPrivateFieldSet8(this, _MessageStream_resolveConnectedPromise, resolve44, "f");
       __classPrivateFieldSet8(this, _MessageStream_rejectConnectedPromise, reject, "f");
     }), "f");
-    __classPrivateFieldSet8(this, _MessageStream_endPromise, new Promise((resolve42, reject) => {
-      __classPrivateFieldSet8(this, _MessageStream_resolveEndPromise, resolve42, "f");
+    __classPrivateFieldSet8(this, _MessageStream_endPromise, new Promise((resolve44, reject) => {
+      __classPrivateFieldSet8(this, _MessageStream_resolveEndPromise, resolve44, "f");
       __classPrivateFieldSet8(this, _MessageStream_rejectEndPromise, reject, "f");
     }), "f");
     __classPrivateFieldGet9(this, _MessageStream_connectedPromise, "f").catch(() => {
@@ -71358,11 +71358,11 @@ var MessageStream = class _MessageStream {
    *   const message = await stream.emitted('message') // rejects if the stream errors
    */
   emitted(event) {
-    return new Promise((resolve42, reject) => {
+    return new Promise((resolve44, reject) => {
       __classPrivateFieldSet8(this, _MessageStream_catchingPromiseCreated, true, "f");
       if (event !== "error")
         this.once("error", reject);
-      this.once(event, resolve42);
+      this.once(event, resolve44);
     });
   }
   async done() {
@@ -71589,7 +71589,7 @@ var MessageStream = class _MessageStream {
           if (done) {
             return { value: void 0, done: true };
           }
-          return new Promise((resolve42, reject) => readQueue.push({ resolve: resolve42, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
+          return new Promise((resolve44, reject) => readQueue.push({ resolve: resolve44, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
         }
         const chunk = pushQueue.shift();
         return { value: chunk, done: false };
@@ -71849,11 +71849,11 @@ async function promptApplyAgentMdProposal(repoPath) {
 }
 async function askYesNo2(question) {
   const rl = readline2.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve42) => {
+  return new Promise((resolve44) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
-      resolve42(/^y(es)?$/i.test(answer.trim()));
+      resolve44(/^y(es)?$/i.test(answer.trim()));
     });
   });
 }
@@ -72083,7 +72083,7 @@ async function executeAuthoringToolCall(toolName, input, repoPath, harnessDir, c
 }
 async function askUser(question, options) {
   const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve42) => {
+  return new Promise((resolve44) => {
     process.stderr.write("\n");
     process.stderr.write(`\u2753 ${question}
 `);
@@ -72094,7 +72094,7 @@ async function askUser(question, options) {
     process.stderr.write("> ");
     rl.once("line", (answer) => {
       rl.close();
-      resolve42(answer.trim());
+      resolve44(answer.trim());
     });
   });
 }
@@ -72238,7 +72238,7 @@ function runScript(scriptPath, args = [], options = {}) {
 function runScriptCapture(scriptPath, args = [], options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve42) => {
+  return new Promise((resolve44) => {
     const proc = (0, import_child_process.spawn)("bash", [scriptPath, ...args], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -72253,13 +72253,13 @@ function runScriptCapture(scriptPath, args = [], options = {}) {
       stderr += d2;
       if (stream) process.stderr.write(d2);
     });
-    proc.on("close", (code) => resolve42({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve44({ stdout, stderr, code: code ?? 0 }));
   });
 }
 function runShellCommand(command2, options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve42) => {
+  return new Promise((resolve44) => {
     const proc = (0, import_child_process.spawn)("bash", ["-lc", command2], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -72274,7 +72274,7 @@ function runShellCommand(command2, options = {}) {
       stderr += d2;
       if (stream) process.stderr.write(d2);
     });
-    proc.on("close", (code) => resolve42({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve44({ stdout, stderr, code: code ?? 0 }));
   });
 }
 
@@ -73455,12 +73455,12 @@ function printAdaptationPrompt(content) {
 }
 function askYesNo3(question) {
   const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve42) => {
+  return new Promise((resolve44) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
-      resolve42(trimmed === "" || /^y(es)?$/i.test(trimmed));
+      resolve44(trimmed === "" || /^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -73547,16 +73547,16 @@ async function promptScaffoldCursorRule(exists) {
 }
 async function askYesNo4(question) {
   const rl = readline5.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve42) => {
+  return new Promise((resolve44) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve42(true);
+        resolve44(true);
         return;
       }
-      resolve42(/^y(es)?$/i.test(trimmed));
+      resolve44(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -75041,6 +75041,12 @@ function computeWorktreeSnapshot(checkoutDir) {
 
 // src/core/validations.ts
 var VALIDATIONS_DIR = "validations";
+function resolveValidationCheckoutDir(input) {
+  const candidates = [input.worktreePath, input.workDir, input.harnessRoot].filter(
+    (value) => Boolean(value)
+  );
+  return candidates.find(isCheckoutRoot) ?? candidates[0] ?? input.harnessRoot;
+}
 function getValidationsDir(checkoutDir) {
   return path36.join(checkoutDir, ".har", VALIDATIONS_DIR);
 }
@@ -76109,7 +76115,7 @@ async function waitForControlApi(apiUrl = getControlApiUrl(), timeoutMs = 6e4, i
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
     if (await isControlApiReachable(apiUrl)) return true;
-    await new Promise((resolve42) => setTimeout(resolve42, intervalMs));
+    await new Promise((resolve44) => setTimeout(resolve44, intervalMs));
   }
   return false;
 }
@@ -76897,7 +76903,12 @@ Usage from Cursor / Claude / Codex (@osfactory/otel-hook) will appear under Work
     if (verification) {
       try {
         const harnessRoot = resolveHarnessRoot(options.repoPath);
-        const checkoutDir = resolveAgentWorkDir(harnessRoot, options.agentId) ?? harnessRoot;
+        const session = readSlotRegistry(harnessRoot, options.agentId);
+        const checkoutDir = resolveValidationCheckoutDir({
+          worktreePath: session?.worktreePath,
+          workDir: resolveAgentWorkDir(harnessRoot, options.agentId),
+          harnessRoot
+        });
         const runId = typeof result.data === "object" && result.data !== null && !Array.isArray(result.data) ? result.data.runId : void 0;
         const validation2 = recordValidation({
           checkoutDir,
@@ -76907,7 +76918,6 @@ Usage from Cursor / Claude / Codex (@osfactory/otel-hook) will appear under Work
           runId,
           agentId: options.agentId
         });
-        const session = readSlotRegistry(harnessRoot, options.agentId);
         if (session?.workUnitId && session.attemptId) {
           bindValidationToAttempt(harnessRoot, {
             workUnitId: session.workUnitId,
@@ -77346,12 +77356,12 @@ async function recordCommitAssociation(cwd) {
 // src/core/commit-gate-onboarding.ts
 function askYesNo5(question) {
   const rl = readline6.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve42) => {
+  return new Promise((resolve44) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
-      resolve42(trimmed === "" || /^y(es)?$/i.test(trimmed));
+      resolve44(trimmed === "" || /^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -77438,7 +77448,10 @@ function writeOnboardingPreferences(overrides) {
 }
 
 // src/cli/help-text.ts
-var HAR_ROOT_EPILOG = `Typical agent workflow:
+var HAR_ROOT_EPILOG = `First time in a repo:
+  har onboard                    # guided setup \u2192 adaptation prompt on clipboard
+
+Typical agent workflow:
   har env status                 # see which slots are free / occupied
   har env launch <id>            # new session from the main checkout's HEAD
   # \u2026edit only under the printed work dir\u2026
@@ -78061,8 +78074,8 @@ async function handleLaunch(argv) {
         console.error(guard.reason ?? "");
         const readline10 = await import("readline");
         const rl = readline10.createInterface({ input: process.stdin, output: process.stderr });
-        const answer = await new Promise((resolve42) => {
-          rl.question("Replace this slot? [y/N] ", resolve42);
+        const answer = await new Promise((resolve44) => {
+          rl.question("Replace this slot? [y/N] ", resolve44);
         });
         rl.close();
         if (!/^[Yy]$/.test(answer.trim())) {
@@ -78078,8 +78091,8 @@ async function handleLaunch(argv) {
         warn("Worktree has uncommitted changes.");
         const readline10 = await import("readline");
         const rl = readline10.createInterface({ input: process.stdin, output: process.stderr });
-        const answer = await new Promise((resolve42) => {
-          rl.question("Discard uncommitted changes? [y/N] ", resolve42);
+        const answer = await new Promise((resolve44) => {
+          rl.question("Discard uncommitted changes? [y/N] ", resolve44);
         });
         rl.close();
         if (!/^[Yy]$/.test(answer.trim())) {
@@ -79316,13 +79329,13 @@ var PromisePolyfill = class extends Promise {
   // Available starting from Node 22
   // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
   static withResolver() {
-    let resolve42;
+    let resolve44;
     let reject;
     const promise = new Promise((res, rej) => {
-      resolve42 = res;
+      resolve44 = res;
       reject = rej;
     });
-    return { promise, resolve: resolve42, reject };
+    return { promise, resolve: resolve44, reject };
   }
 };
 
@@ -79339,7 +79352,7 @@ function createPrompt(view) {
       output
     });
     const screen = new ScreenManager(rl);
-    const { promise, resolve: resolve42, reject } = PromisePolyfill.withResolver();
+    const { promise, resolve: resolve44, reject } = PromisePolyfill.withResolver();
     const cancel = () => reject(new CancelPromptError());
     if (signal) {
       const abort = () => reject(new AbortPromptError({ cause: signal.reason }));
@@ -79363,7 +79376,7 @@ function createPrompt(view) {
       cycle(() => {
         try {
           const nextView = view(config2, (value) => {
-            setImmediate(() => resolve42(value));
+            setImmediate(() => resolve44(value));
           });
           const [content, bottomContent] = typeof nextView === "string" ? [nextView] : nextView;
           screen.render(content, bottomContent);
@@ -80350,9 +80363,9 @@ var import_run_async = __toESM(require_run_async(), 1);
 var import_mute_stream2 = __toESM(require_lib3(), 1);
 var import_ansi_escapes5 = __toESM(require_ansi_escapes(), 1);
 var _2 = {
-  set: (obj, path58 = "", value) => {
+  set: (obj, path60 = "", value) => {
     let pointer = obj;
-    path58.split(".").forEach((key, index, arr) => {
+    path60.split(".").forEach((key, index, arr) => {
       if (key === "__proto__" || key === "constructor")
         return;
       if (index === arr.length - 1) {
@@ -80363,8 +80376,8 @@ var _2 = {
       pointer = pointer[key];
     });
   },
-  get: (obj, path58 = "", defaultValue) => {
-    const travel = (regexp) => String.prototype.split.call(path58, regexp).filter(Boolean).reduce(
+  get: (obj, path60 = "", defaultValue) => {
+    const travel = (regexp) => String.prototype.split.call(path60, regexp).filter(Boolean).reduce(
       // @ts-expect-error implicit any on res[key]
       (res, key) => res !== null && res !== void 0 ? res[key] : res,
       obj
@@ -80478,7 +80491,7 @@ var PromptsRunner = class {
       throw new Error(`Prompt for type ${question.type} not found`);
     }
     let cleanupSignal;
-    const promptFn = isPromptConstructor(prompt2) ? (q2, { signal: signal2 } = {}) => new Promise((resolve42, reject) => {
+    const promptFn = isPromptConstructor(prompt2) ? (q2, { signal: signal2 } = {}) => new Promise((resolve44, reject) => {
       const rl = import_node_readline.default.createInterface(setupReadlineOptions(this.opt));
       rl.resume();
       const onClose = () => {
@@ -80514,7 +80527,7 @@ var PromptsRunner = class {
           cleanupSignal = void 0;
         };
       }
-      activePrompt.run().then(resolve42, reject).finally(cleanup);
+      activePrompt.run().then(resolve44, reject).finally(cleanup);
     }) : prompt2;
     const { signal: moduleSignal } = this.opt;
     if (moduleSignal?.aborted) {
@@ -80687,7 +80700,7 @@ function openBrowser(url) {
 }
 async function loginViaBrowser(portalUrl, openUrl = openBrowser) {
   const state = (0, import_crypto.randomUUID)();
-  return new Promise((resolve42, reject) => {
+  return new Promise((resolve44, reject) => {
     let timer;
     const server = http.createServer((req, res) => {
       const requestUrl = new URL(req.url ?? "", "http://127.0.0.1");
@@ -80710,7 +80723,7 @@ async function loginViaBrowser(portalUrl, openUrl = openBrowser) {
       res.writeHead(200, { "Content-Type": "text/html" });
       res.end("<h1>Logged in</h1><p>You can close this tab and return to the terminal.</p>");
       cleanup();
-      resolve42({ portalUrl, token, workspace, email: email2, createdAt: (/* @__PURE__ */ new Date()).toISOString() });
+      resolve44({ portalUrl, token, workspace, email: email2, createdAt: (/* @__PURE__ */ new Date()).toISOString() });
     });
     const cleanup = () => {
       clearTimeout(timer);
@@ -80797,8 +80810,8 @@ async function askYesNo6(question) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
   const readline10 = await import("readline");
   const rl = readline10.createInterface({ input: process.stdin, output: process.stderr });
-  const answer = await new Promise((resolve42) => {
-    rl.question(question, resolve42);
+  const answer = await new Promise((resolve44) => {
+    rl.question(question, resolve44);
   });
   rl.close();
   return /^[Yy]$/.test(answer.trim());
@@ -81002,8 +81015,8 @@ async function askYesNo7(question) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
   const readline10 = await import("readline");
   const rl = readline10.createInterface({ input: process.stdin, output: process.stderr });
-  const answer = await new Promise((resolve42) => {
-    rl.question(question, resolve42);
+  const answer = await new Promise((resolve44) => {
+    rl.question(question, resolve44);
   });
   rl.close();
   return /^[Yy]$/.test(answer.trim());
@@ -81973,10 +81986,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path58) {
-  if (!path58)
+function getElementAtPath(obj, path60) {
+  if (!path60)
     return obj;
-  return path58.reduce((acc, key) => acc?.[key], obj);
+  return path60.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -82296,11 +82309,11 @@ function aborted(x2, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path58, issues) {
+function prefixIssues(path60, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path58);
+    iss.path.unshift(path60);
     return iss;
   });
 }
@@ -87623,7 +87636,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve42) => setTimeout(resolve42, pollInterval));
+        await new Promise((resolve44) => setTimeout(resolve44, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error3) {
@@ -87640,7 +87653,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve42, reject) => {
+    return new Promise((resolve44, reject) => {
       const earlyReject = (error3) => {
         reject(error3);
       };
@@ -87718,7 +87731,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve42(parseResult.data);
+            resolve44(parseResult.data);
           }
         } catch (error3) {
           reject(error3);
@@ -87979,12 +87992,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve42, reject) => {
+    return new Promise((resolve44, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve42, interval);
+      const timeoutId = setTimeout(resolve44, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -88857,12 +88870,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve42) => {
+    return new Promise((resolve44) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve42();
+        resolve44();
       } else {
-        this._stdout.once("drain", resolve42);
+        this._stdout.once("drain", resolve44);
       }
     });
   }
@@ -89500,6 +89513,486 @@ var mcpCommand = {
   }
 };
 
+// src/cli/commands/onboard.ts
+var path58 = __toESM(require("path"));
+
+// src/core/onboarding.ts
+var path57 = __toESM(require("path"));
+init_control_config();
+init_otel_hooks();
+init_telemetry_config();
+var ONBOARDING_GUIDE_STEPS = [
+  {
+    title: "What HAR is",
+    body: [
+      "HAR (Harness) gives coding agents a reproducible environment for your repo:",
+      "an editable `.har/` scaffold, isolated git worktree sessions, and a verify \u2192 complete loop.",
+      "You adapt the scaffold once to your stack; agents then use the same launch/verify/teardown contract."
+    ].join("\n")
+  },
+  {
+    title: "Sessions and slots",
+    body: [
+      "Each `har env launch <id>` creates a fresh session worktree from your main checkout HEAD.",
+      "Edit only under the printed work dir \u2014 never the main checkout while a slot is active.",
+      "Use separate slot ids for parallel tasks. Prefer `complete` / `teardown` before starting unrelated work."
+    ].join("\n")
+  },
+  {
+    title: "Verify and finish",
+    body: [
+      "Quick:  har env verify <id>",
+      "Done:   har env verify <id> --full   then   har env complete <id>",
+      "`complete` records a validation, frees the slot, and keeps the session branch for a PR."
+    ].join("\n")
+  },
+  {
+    title: "Mission Control and plugins",
+    body: [
+      "Mission Control is a local dashboard for slots, runs, and (optional) agent usage telemetry.",
+      "Plugins (`har env add-plugin`) add optional verification stages such as Playwright browser-e2e.",
+      "After setup, paste the adaptation prompt into your coding agent to tailor `.har/` to this repo."
+    ].join("\n")
+  }
+];
+function listPluginChoices() {
+  return listPluginIds().map((id) => {
+    try {
+      const manifest = readPluginManifest(id);
+      const description = typeof manifest.stage.description === "string" ? manifest.stage.description : `Adds stage ${manifest.stageId}`;
+      return {
+        id,
+        label: `${id} \u2014 ${description}`,
+        description
+      };
+    } catch {
+      return { id, label: id, description: id };
+    }
+  });
+}
+function printOnboardingGuide() {
+  divider();
+  info("How HAR works");
+  divider();
+  for (const [index, step] of ONBOARDING_GUIDE_STEPS.entries()) {
+    info(`${index + 1}. ${step.title}`);
+    for (const line of step.body.split("\n")) {
+      info(`   ${line}`);
+    }
+    info("");
+  }
+}
+async function applyOnboardingTelemetry(choice, options = {}) {
+  const setupHooks = options.setupHooks !== false;
+  if (choice === "off") {
+    writeTelemetryPreference(false);
+    if (setupHooks) {
+      try {
+        disableOtelHooksExport();
+      } catch (err) {
+        warn(`Could not refresh hooks config: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    }
+    success("Telemetry disabled");
+    return;
+  }
+  const prompts = choice === "on";
+  writeTelemetryPreference(true, { prompts, traces: true });
+  success(
+    prompts ? "Telemetry enabled (including prompts) \u2192 Mission Control via @osfactory/otel-hook" : "Telemetry enabled without prompt capture"
+  );
+  if (setupHooks) {
+    const hooks = ensureOtelHooks({ setupAgents: true });
+    if (hooks.message) success(hooks.message);
+    if (hooks.warning) warn(hooks.warning);
+  }
+}
+async function defaultEnsureControl(options) {
+  const apiUrl = getControlApiUrl();
+  if (!options.startControl) {
+    if (options.telemetry !== "off") {
+      await ensureTelemetryInfrastructure({ startIfNeeded: false });
+      const reachable = await isControlApiReachable(apiUrl);
+      if (!reachable) {
+        return {
+          started: false,
+          apiUrl,
+          warning: "Telemetry is on but Mission Control is not running. Start later with: har control up"
+        };
+      }
+    }
+    return { started: false, apiUrl };
+  }
+  if (options.telemetry !== "off") {
+    const ensured = await ensureTelemetryInfrastructure({ startIfNeeded: true });
+    if (ensured.message) success(ensured.message);
+    if (ensured.warning) warn(ensured.warning);
+    return {
+      started: ensured.started || ensured.reachable,
+      apiUrl: ensured.apiUrl,
+      warning: ensured.warning
+    };
+  }
+  const result = await startControlAndSync({ detach: true, cwd: options.cwd });
+  if (result.code !== 0) {
+    return {
+      started: false,
+      apiUrl: result.apiUrl,
+      warning: "Failed to start Mission Control (is Docker available?)"
+    };
+  }
+  success(`Mission Control started at ${result.apiUrl}`);
+  return { started: true, apiUrl: result.apiUrl };
+}
+async function runOnboarding(options, deps = {}) {
+  const repoPath = path57.resolve(options.repoPath);
+  const applyTelemetry = deps.applyTelemetry ?? applyOnboardingTelemetry;
+  const ensureControl = deps.ensureControl ?? defaultEnsureControl;
+  const init = deps.initHarness ?? initHarness;
+  const applyPlugin2 = deps.addPlugin ?? addPlugin;
+  const offerClipboard = deps.offerClipboard ?? offerAdaptationPromptClipboard;
+  await applyTelemetry(options.telemetry);
+  const control = await ensureControl({
+    startControl: options.startControl,
+    telemetry: options.telemetry,
+    cwd: repoPath
+  });
+  if (control.warning) warn(control.warning);
+  const alreadyPresent = harnessExists(repoPath);
+  let harnessInitialized = false;
+  const shouldInit = !options.skipInit && !(alreadyPresent && options.skipInitIfPresent !== false);
+  if (options.skipInit) {
+    info("Skipping harness scaffold (--skip-init)");
+  } else if (alreadyPresent && options.skipInitIfPresent !== false) {
+    info("Harness already present \u2014 skipping scaffold");
+  } else if (shouldInit) {
+    divider();
+    info(`Scaffolding .har/ (profile: ${options.profile})...`);
+    const result = await init({
+      repoPath,
+      profile: options.profile,
+      force: alreadyPresent,
+      auto: false
+    });
+    if (!result.validation.pass) {
+      warn("Harness has validation errors \u2014 review .har/ after adaptation.");
+    }
+    harnessInitialized = true;
+    recordRepoForControlSync(repoPath);
+    success("Harness scaffolded");
+  }
+  const pluginsApplied = [];
+  const pluginWarnings = [];
+  if (options.plugins.length > 0) {
+    if (!harnessExists(repoPath)) {
+      warn("Cannot install plugins without a harness \u2014 skipping");
+    } else {
+      divider();
+      info(`Installing plugins: ${options.plugins.join(", ")}`);
+      for (const pluginId of options.plugins) {
+        try {
+          const result = applyPlugin2(repoPath, pluginId, {
+            force: options.forcePlugins === true
+          });
+          pluginsApplied.push(pluginId);
+          success(`Plugin ${pluginId} \u2192 stage ${result.stageId}`);
+          for (const w3 of result.warnings) pluginWarnings.push(w3);
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          pluginWarnings.push(`${pluginId}: ${message}`);
+          warn(`Plugin ${pluginId} failed: ${message}`);
+        }
+      }
+    }
+  }
+  let adaptationPromptPath = null;
+  let adaptationPromptCopied = false;
+  if (!options.deferAdaptationPrompt && harnessExists(repoPath)) {
+    const finalized = await finalizeOnboardingAdaptation({
+      repoPath,
+      profile: options.profile,
+      harnessInitialized,
+      autoYes: options.autoYes,
+      offerClipboard
+    });
+    adaptationPromptPath = finalized.path;
+    adaptationPromptCopied = finalized.copied;
+  }
+  return {
+    repoPath,
+    profile: options.profile,
+    harnessInitialized,
+    harnessAlreadyPresent: alreadyPresent,
+    telemetry: options.telemetry,
+    controlStarted: control.started,
+    controlApiUrl: control.apiUrl,
+    pluginsApplied,
+    pluginWarnings,
+    adaptationPromptPath,
+    adaptationPromptCopied
+  };
+}
+async function finalizeOnboardingAdaptation(options) {
+  const offerClipboard = options.offerClipboard ?? offerAdaptationPromptClipboard;
+  const mode = options.harnessInitialized ? "init" : "maintain";
+  const prompt2 = mode === "init" ? buildInitAdaptationPrompt(options.repoPath, options.profile) : buildMaintainAdaptationPrompt(options.repoPath);
+  const filePath = writeAdaptationPrompt(options.repoPath, prompt2);
+  divider();
+  info(
+    mode === "init" ? "Adapt the harness with your coding agent (final step):" : "Optional: paste this maintenance prompt into your coding agent:"
+  );
+  info("  Also saved to .har/ADAPT-PROMPT.md");
+  printAdaptationPrompt(prompt2);
+  const copied = await offerClipboard(prompt2, { autoYes: options.autoYes });
+  return { path: filePath, copied };
+}
+
+// src/cli/commands/onboard.ts
+function parsePluginsFlag(raw) {
+  if (raw === void 0) return void 0;
+  if (raw === false) return [];
+  const available = listPluginChoices().map((p2) => p2.id);
+  if (raw.trim() === "" || raw === "none") return [];
+  const selected = raw.split(",").map((value) => value.trim()).filter(Boolean);
+  const invalid = selected.filter((id) => !available.includes(id));
+  if (invalid.length > 0) {
+    throw new Error(`Unknown plugin(s): ${invalid.join(", ")}. Available: ${available.join(", ")}`);
+  }
+  return selected;
+}
+async function pauseForGuide(autoYes) {
+  if (autoYes || !process.stdin.isTTY || !process.stdout.isTTY) return;
+  await esm_default13.prompt([
+    {
+      type: "input",
+      name: "continue",
+      message: "Press Enter to continue"
+    }
+  ]);
+}
+async function promptChoices(args) {
+  if (args.yes) {
+    const telemetry2 = args.telemetry ?? "on";
+    return {
+      profile: args.profile ?? "default",
+      telemetry: telemetry2,
+      startControl: args.control ?? telemetry2 !== "off",
+      plugins: parsePluginsFlag(args.plugins) ?? []
+    };
+  }
+  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+  if (!interactive) {
+    if (args.telemetry === void 0 && args.control === void 0 && args.plugins === void 0 && args.profile === void 0) {
+      throw new Error(
+        "Interactive onboarding requires a TTY. Pass --yes or flags (--profile, --telemetry, --control/--no-control, --plugins)."
+      );
+    }
+    const telemetry2 = args.telemetry ?? "on";
+    return {
+      profile: args.profile ?? "default",
+      telemetry: telemetry2,
+      startControl: args.control ?? telemetry2 !== "off",
+      plugins: parsePluginsFlag(args.plugins) ?? []
+    };
+  }
+  const pluginChoices = listPluginChoices();
+  const alreadyPresent = harnessExists(path58.resolve(args.repo));
+  const needProfile = !alreadyPresent && !args.skipInit && args.profile === void 0;
+  const answers = await esm_default13.prompt([
+    {
+      type: "list",
+      name: "profile",
+      message: "Harness profile",
+      when: () => needProfile,
+      choices: [
+        { name: "default \u2014 web / full-stack apps", value: "default" },
+        { name: "cli \u2014 libraries and CLI tools (no PM2)", value: "cli" },
+        { name: "ios \u2014 Xcode / iOS Simulator", value: "ios" }
+      ],
+      default: "default"
+    },
+    {
+      type: "list",
+      name: "telemetry",
+      message: "Agent usage telemetry (Cursor / Claude / Codex \u2192 Mission Control)",
+      when: () => args.telemetry === void 0,
+      choices: [
+        { name: "Full on (traces, logs, metrics, prompts) \u2014 recommended", value: "on" },
+        { name: "On without prompt text", value: "on-no-prompts" },
+        { name: "Off", value: "off" }
+      ],
+      default: "on"
+    },
+    {
+      type: "confirm",
+      name: "startControl",
+      message: "Start Mission Control now?",
+      when: () => args.control === void 0,
+      default: (current) => (args.telemetry ?? current.telemetry ?? "on") !== "off"
+    },
+    {
+      type: "checkbox",
+      name: "plugins",
+      message: "Optional plugins to install (space to toggle, enter to confirm)",
+      when: () => args.plugins === void 0,
+      choices: pluginChoices.map((plugin) => ({
+        name: plugin.label,
+        value: plugin.id
+      }))
+    }
+  ]);
+  const telemetry = args.telemetry ?? answers.telemetry ?? "on";
+  return {
+    profile: args.profile ?? answers.profile ?? "default",
+    telemetry,
+    startControl: args.control ?? answers.startControl ?? telemetry !== "off",
+    plugins: parsePluginsFlag(args.plugins) ?? answers.plugins ?? []
+  };
+}
+function printSummary(result) {
+  divider();
+  success("Onboarding complete");
+  info(`Repository:     ${result.repoPath}`);
+  info(
+    `Harness:        ${result.harnessInitialized ? "scaffolded" : result.harnessAlreadyPresent ? "already present" : "skipped"}`
+  );
+  info(`Telemetry:      ${result.telemetry}`);
+  info(
+    `Mission Control:${result.controlStarted ? ` started (${result.controlApiUrl})` : ` not started (${result.controlApiUrl})`}`
+  );
+  info(
+    `Plugins:        ${result.pluginsApplied.length > 0 ? result.pluginsApplied.join(", ") : "none"}`
+  );
+  if (result.adaptationPromptPath) {
+    info(`Adapt prompt:   ${result.adaptationPromptPath}`);
+    info(
+      result.adaptationPromptCopied ? "Clipboard:      copied \u2014 paste into your coding agent" : "Clipboard:      open .har/ADAPT-PROMPT.md and paste into your coding agent"
+    );
+  }
+  console.error("");
+  console.error("  Next:");
+  console.error("    Adapt:   paste the prompt into your coding agent");
+  console.error("    Launch:  har env launch 1");
+  console.error("    Verify:  har env verify 1 --full");
+  console.error("    Control: har control up   # if you skipped Mission Control");
+  console.error("");
+}
+async function handleOnboard(argv) {
+  const repoPath = path58.resolve(argv.repo);
+  header("har onboard");
+  info(`Repository: ${repoPath}`);
+  try {
+    if (!argv.skipGuide) {
+      printOnboardingGuide();
+      await pauseForGuide(argv.yes);
+    } else {
+      info(`Skipped guide (${ONBOARDING_GUIDE_STEPS.length} steps available without --skip-guide)`);
+    }
+    const choices = await promptChoices(argv);
+    const onboarding = resolveOnboardingOptions(argv);
+    const result = await runOnboarding({
+      repoPath,
+      profile: choices.profile,
+      telemetry: choices.telemetry,
+      startControl: choices.startControl,
+      plugins: choices.plugins,
+      skipInit: argv.skipInit,
+      deferAdaptationPrompt: true,
+      autoYes: argv.yes,
+      forcePlugins: argv.force
+    });
+    if (result.harnessInitialized || harnessExists(repoPath)) {
+      await handleCommitGateOnboarding({
+        repoPath,
+        ...onboarding.commitGate,
+        autoYes: argv.yes
+      });
+      await handleCursorRule({
+        repoPath,
+        cursorRule: onboarding.cursorRule,
+        autoYes: argv.yes,
+        mode: result.harnessInitialized ? "init" : "maintain"
+      });
+      await handleAgentSkills({
+        repoPath,
+        ...onboarding.agentSkills,
+        autoYes: argv.yes,
+        force: argv.force,
+        mode: result.harnessInitialized ? "init" : "maintain"
+      });
+    }
+    if (harnessExists(repoPath)) {
+      const finalized = await finalizeOnboardingAdaptation({
+        repoPath,
+        profile: result.profile,
+        harnessInitialized: result.harnessInitialized,
+        autoYes: argv.yes
+      });
+      result.adaptationPromptPath = finalized.path;
+      result.adaptationPromptCopied = finalized.copied;
+    }
+    for (const warning of result.pluginWarnings) {
+      warn(warning);
+    }
+    printSummary(result);
+  } catch (err) {
+    error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+}
+var onboardCommand = {
+  command: "onboard",
+  describe: "Interactive first-run guide: how HAR works, telemetry, Mission Control, plugins, adapt prompt",
+  builder: (yargs) => yargs.option("repo", { type: "string", default: ".", describe: "Path to the repository" }).option("yes", {
+    alias: "y",
+    type: "boolean",
+    default: false,
+    describe: "Accept defaults without prompting (telemetry on, start Mission Control, no plugins)"
+  }).option("profile", {
+    type: "string",
+    choices: ["default", "cli", "ios"],
+    describe: "Harness profile when scaffolding (default: default)"
+  }).option("telemetry", {
+    type: "string",
+    choices: ["on", "on-no-prompts", "off"],
+    describe: "Telemetry preference"
+  }).option("control", {
+    type: "boolean",
+    describe: "Start Mission Control (use --no-control to skip)"
+  }).option("plugins", {
+    type: "string",
+    describe: "Comma-separated plugins to install (e.g. playwright); --no-plugins to skip; interactive checkbox when omitted"
+  }).option("skip-guide", {
+    type: "boolean",
+    default: false,
+    describe: "Skip the how-HAR-works introduction"
+  }).option("skip-init", {
+    type: "boolean",
+    default: false,
+    describe: "Do not scaffold .har/ even when missing"
+  }).option("force", {
+    type: "boolean",
+    default: false,
+    describe: "Overwrite existing plugin files when installing"
+  }).option("cursor-rule", {
+    type: "boolean",
+    describe: "Create .cursor/rules/har-workflow.mdc without prompting (use --no-cursor-rule to skip)"
+  }).option("agents", {
+    type: "string",
+    describe: "Scaffold agent skills for these targets (comma-separated: claude,cursor,codex); --no-agents to skip"
+  }).option("commit-gate", {
+    choices: ["prompt", "always", "never"],
+    describe: "Install commit hooks during onboarding (defaults to user preferences)"
+  }).option("gate-mode", {
+    choices: ["block", "warn"],
+    describe: "Policy for commits without a passing full verification"
+  }).option("gate-scope", {
+    choices: ["worktrees", "all"],
+    describe: "Apply the commit policy to HAR worktrees or every checkout"
+  }),
+  handler: (argv) => handleOnboard(argv)
+};
+
 // src/cli/commands/preferences.ts
 function parseAgents(raw) {
   if (raw === "auto") return "auto";
@@ -89616,7 +90109,7 @@ var preferencesCommand = {
 };
 
 // src/cli/commands/telemetry.ts
-var path57 = __toESM(require("path"));
+var path59 = __toESM(require("path"));
 init_control_config();
 init_otel_hooks();
 init_telemetry_config();
@@ -89703,7 +90196,7 @@ async function handleOff() {
   info("Mission Control will not auto-start. Existing usage rows are kept.");
 }
 async function handleWriteEnv(argv) {
-  const repoPath = path57.resolve(argv.repo);
+  const repoPath = path59.resolve(argv.repo);
   const harnessRoot = resolveHarnessRoot(repoPath);
   const session = readSlotRegistry(harnessRoot, argv.agentId);
   const workDir = argv.workDir ?? session?.workDir ?? repoPath;
@@ -89715,7 +90208,7 @@ async function handleWriteEnv(argv) {
     suffix,
     createdAt: session?.createdAt
   });
-  const envFile = argv.envFile ?? path57.join(workDir, `.env.agent.${argv.agentId}`);
+  const envFile = argv.envFile ?? path59.join(workDir, `.env.agent.${argv.agentId}`);
   const attrs = {
     sessionKey,
     agentId: argv.agentId,
@@ -89726,15 +90219,12 @@ async function handleWriteEnv(argv) {
   };
   appendTelemetryEnvToFile(envFile, attrs);
   if (isTelemetryEnabled()) {
-    ensureOtelHooks({
-      setupAgents: false,
-      resourceAttributes: buildOtelResourceAttributes(attrs)
-    });
+    ensureOtelHooks({ setupAgents: false });
   }
   success(`Wrote session attribution to ${envFile}`);
 }
 function handlePrintEnv(argv) {
-  const repoPath = path57.resolve(argv.repo);
+  const repoPath = path59.resolve(argv.repo);
   const workDir = argv.workDir ?? repoPath;
   const sessionKey = buildSessionKey({
     branch: argv.branch,
@@ -89854,7 +90344,7 @@ var telemetryCommand = {
 // src/cli/index.ts
 async function runCli() {
   ensureDefaultTelemetryPreference();
-  await yargs_default(hideBin(process.argv)).scriptName("har").usage("$0 <command> [options]").command(envCommand).command(agentsCommand).command(controlCommand).command(hooksCommand).command(mcpCommand).command(preferencesCommand).command(telemetryCommand).demandCommand(1, "Please specify a command. Try: har env --help").epilog(HAR_ROOT_EPILOG).strict().help().version(getHarPackageVersion()).parse();
+  await yargs_default(hideBin(process.argv)).scriptName("har").usage("$0 <command> [options]").command(onboardCommand).command(envCommand).command(agentsCommand).command(controlCommand).command(hooksCommand).command(mcpCommand).command(preferencesCommand).command(telemetryCommand).demandCommand(1, "Please specify a command. Try: har onboard   or   har env --help").epilog(HAR_ROOT_EPILOG).strict().help().version(getHarPackageVersion()).parse();
 }
 
 // src/index.ts