@osfactory/har 0.57.0 → 0.58.0

package/dist/index.js

@@ -553,8 +553,8 @@ var init_parseUtil = __esm({
     init_errors();
     init_en();
     makeIssue = (params) => {
-      const { data, path: path65, errorMaps, issueData } = params;
-      const fullPath = [...path65, ...issueData.path || []];
+      const { data, path: path66, errorMaps, issueData } = params;
+      const fullPath = [...path66, ...issueData.path || []];
       const fullIssue = {
         ...issueData,
         path: fullPath
@@ -862,11 +862,11 @@ var init_types = __esm({
     init_parseUtil();
     init_util();
     ParseInputLazyPath = class {
-      constructor(parent, value, path65, key) {
+      constructor(parent, value, path66, key) {
         this._cachedPath = [];
         this.parent = parent;
         this.data = value;
-        this._path = path65;
+        this._path = path66;
         this._key = key;
       }
       get path() {
@@ -4248,7 +4248,7 @@ var init_zod = __esm({
 });
 
 // packages/schemas/src/schema.ts
-var HAR_STAGE_KINDS, HAR_AGENT_SLOT_MIN, AgentSkillTargetSchema, ScaffoldedAgentFileSchema, HarnessManifestSchema, HarnessStageKindSchema, HarnessArtifactKindSchema, HarnessArtifactSchema, HarnessStageIdSchema, HarnessStageSchema, HarnessAgentSlotsSchema, CommitGateConfigSchema, OnboardingPreferencesSchema, HarnessStageRegistrySchema, HarnessVerificationStepSchema, ShellRunOutputSchema, HarnessVerificationResultSchema, HarnessStageRunStatusSchema, HarnessStageLogSchema, HarnessStageUrlSchema, HarnessStageRunResultSchema, StageKindSchema, VerificationResultSchema, StageResultSchema, RunRecordTriggerSchema, WorkUnitIdSchema, WorkAttemptIdSchema, WorkUnitMetadataSchema, WorkUnitOutcomeSchema, WorkUnitRecordSchema, WorkAttemptRecordSchema, RunRecordSchema, SlotRegistryEntrySchema, AgentSlotHarnessUsageSchema, PreflightBlockerSchema, SlotReadinessSchema, AgentSlotStatusSchema, EnvironmentStatusSchema, RegisterRepoInputSchema, UnregisterRepoInputSchema, UnregisterWorktreeResultSchema, UnregisterRepoResultSchema, ResetMissionControlInputSchema, HarnessScrubResultSchema, ResetMissionControlResultSchema, DeleteWorktreesInputSchema, DeleteWorktreeResultSchema, DeleteWorktreesResultSchema, SyncRunsInputSchema, SyncSlotsInputSchema, SyncWorkUnitsInputSchema, ChangedFileStatusSchema, ChangedFileSchema, ValidationRecordSchema, SyncValidationsInputSchema, ValidationBindingRecordSchema, SyncValidationBindingsInputSchema, AgentToolSchema, UsageSourceSchema, AgentTrajectorySourceSchema, AgentTrajectoryContentDisclosureSchema, AgentTrajectoryRecordV1Schema, AgentSessionUsageSchema, SyncUsageInputSchema, AgentSessionEventSchema, SyncSessionEventsInputSchema;
+var HAR_STAGE_KINDS, HAR_AGENT_SLOT_MIN, AgentSkillTargetSchema, ScaffoldedAgentFileSchema, HarnessManifestSchema, HarnessStageKindSchema, HarnessArtifactKindSchema, HarnessArtifactSchema, HarnessStageIdSchema, HarnessStageSchema, HarnessAgentSlotsSchema, CommitGateConfigSchema, OnboardingPreferencesSchema, HarnessStageRegistrySchema, HarnessVerificationStepSchema, ShellRunOutputSchema, HarnessVerificationResultSchema, HarnessStageRunStatusSchema, HarnessStageLogSchema, HarnessStageUrlSchema, HarnessStageRunResultSchema, StageKindSchema, VerificationResultSchema, StageResultSchema, RunRecordTriggerSchema, WorkUnitIdSchema, WorkAttemptIdSchema, WorkUnitRelatedLinkSchema, WorkUnitMetadataSchema, WorkUnitOutcomeSchema, WorkUnitRecordSchema, WorkAttemptRecordSchema, RunRecordSchema, SlotRegistryEntrySchema, AgentSlotHarnessUsageSchema, PreflightBlockerSchema, SlotReadinessSchema, AgentSlotStatusSchema, EnvironmentStatusSchema, RegisterRepoInputSchema, UnregisterRepoInputSchema, UnregisterWorktreeResultSchema, UnregisterRepoResultSchema, ResetMissionControlInputSchema, HarnessScrubResultSchema, ResetMissionControlResultSchema, DeleteWorktreesInputSchema, DeleteWorktreeResultSchema, DeleteWorktreesResultSchema, SyncRunsInputSchema, SyncSlotsInputSchema, SyncWorkUnitsInputSchema, ChangedFileStatusSchema, ChangedFileSchema, ValidationRecordSchema, SyncValidationsInputSchema, ValidationBindingRecordSchema, SyncValidationBindingsInputSchema, AgentToolSchema, UsageSourceSchema, AgentTrajectorySourceSchema, AgentTrajectoryContentDisclosureSchema, AgentTrajectoryRecordV1Schema, AgentSessionUsageSchema, SyncUsageInputSchema, AgentSessionEventSchema, SyncSessionEventsInputSchema;
 var init_schema = __esm({
   "packages/schemas/src/schema.ts"() {
     "use strict";
@@ -4413,12 +4413,18 @@ var init_schema = __esm({
       "work unit id must start with an alphanumeric character and contain only stable identifier characters"
     );
     WorkAttemptIdSchema = external_exports.string().uuid();
+    WorkUnitRelatedLinkSchema = external_exports.object({
+      source: external_exports.string().min(1).max(64),
+      url: external_exports.string().url(),
+      label: external_exports.string().min(1).max(128).optional()
+    });
     WorkUnitMetadataSchema = external_exports.object({
       workUnitId: WorkUnitIdSchema,
       source: external_exports.string().min(1).max(64).optional(),
       sourceUrl: external_exports.string().url().optional(),
       title: external_exports.string().min(1).max(256).optional(),
-      parentWorkUnitId: WorkUnitIdSchema.optional()
+      parentWorkUnitId: WorkUnitIdSchema.optional(),
+      relatedLinks: external_exports.array(WorkUnitRelatedLinkSchema).optional()
     });
     WorkUnitOutcomeSchema = external_exports.object({
       decision: external_exports.enum(["completed", "abandoned"]),
@@ -28758,7 +28764,7 @@ function runScript(scriptPath, args = [], options = {}) {
 function runScriptCapture(scriptPath, args = [], options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve49) => {
+  return new Promise((resolve50) => {
     const proc = (0, import_child_process.spawn)("bash", [scriptPath, ...args], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -28773,13 +28779,13 @@ function runScriptCapture(scriptPath, args = [], options = {}) {
       stderr += d;
       if (stream) process.stderr.write(d);
     });
-    proc.on("close", (code) => resolve49({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve50({ stdout, stderr, code: code ?? 0 }));
   });
 }
 function runShellCommand(command2, options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve49) => {
+  return new Promise((resolve50) => {
     const proc = (0, import_child_process.spawn)("bash", ["-lc", command2], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -28794,7 +28800,7 @@ function runShellCommand(command2, options = {}) {
       stderr += d;
       if (stream) process.stderr.write(d);
     });
-    proc.on("close", (code) => resolve49({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve50({ stdout, stderr, code: code ?? 0 }));
   });
 }
 var import_child_process;
@@ -30904,6 +30910,29 @@ function listRecords(harnessRoot, dir, parse4) {
   }
   return records;
 }
+function parseWorkLinkSpec(spec) {
+  const parts = spec.split("|");
+  if (parts.length < 2) {
+    throw new Error(
+      `Invalid work link "${spec}" \u2014 use source|url or source|url|label (example: github|https://github.com/org/repo/pull/42|PR #42)`
+    );
+  }
+  const [source, url, ...labelParts] = parts;
+  const label = labelParts.length > 0 ? labelParts.join("|") : void 0;
+  return WorkUnitRelatedLinkSchema.parse({ source, url, label });
+}
+function mergeRelatedLinks(existing, incoming, primaryUrl) {
+  if (!incoming?.length) return existing?.length ? existing : void 0;
+  const seen = /* @__PURE__ */ new Set();
+  const merged = [];
+  for (const link of [...existing ?? [], ...incoming]) {
+    if (primaryUrl && link.url === primaryUrl) continue;
+    if (seen.has(link.url)) continue;
+    seen.add(link.url);
+    merged.push(link);
+  }
+  return merged.length > 0 ? merged : void 0;
+}
 function findWorkUnit(harnessRoot, workUnitId) {
   const metadata = WorkUnitMetadataSchema.parse({ workUnitId });
   const file = hashedRecordPath(harnessRoot, WORK_UNITS_DIR, metadata.workUnitId);
@@ -30933,13 +30962,19 @@ function upsertWorkUnit(harnessRoot, input) {
     }
   }
   const now = (/* @__PURE__ */ new Date()).toISOString();
+  const sourceUrl = existing?.sourceUrl ?? metadata.sourceUrl;
   const record2 = WorkUnitRecordSchema.parse({
     ...existing,
     workUnitId: metadata.workUnitId,
     source: existing?.source ?? metadata.source,
-    sourceUrl: existing?.sourceUrl ?? metadata.sourceUrl,
+    sourceUrl,
     title: existing?.title ?? metadata.title,
     parentWorkUnitId: existing?.parentWorkUnitId ?? metadata.parentWorkUnitId,
+    relatedLinks: mergeRelatedLinks(
+      existing?.relatedLinks,
+      metadata.relatedLinks,
+      sourceUrl
+    ),
     version: 1,
     createdAt: existing?.createdAt ?? now,
     updatedAt: now,
@@ -30952,6 +30987,23 @@ function upsertWorkUnit(harnessRoot, input) {
   markDirty(harnessRoot);
   return record2;
 }
+function addWorkUnitLinks(harnessRoot, workUnitId, links) {
+  const existing = findWorkUnit(harnessRoot, workUnitId);
+  if (!existing) throw new Error(`Unknown work unit: ${workUnitId}`);
+  const parsed = links.map((link) => WorkUnitRelatedLinkSchema.parse(link));
+  const relatedLinks = mergeRelatedLinks(existing.relatedLinks, parsed, existing.sourceUrl);
+  const record2 = WorkUnitRecordSchema.parse({
+    ...existing,
+    relatedLinks,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  writeRecord2(
+    hashedRecordPath(harnessRoot, WORK_UNITS_DIR, workUnitId),
+    record2
+  );
+  markDirty(harnessRoot);
+  return record2;
+}
 function listWorkUnits(harnessRoot) {
   return listRecords(
     harnessRoot,
@@ -32431,7 +32483,7 @@ async function postForResponse(url, headers, payload) {
     } catch (err) {
       lastErr = err;
       if (attempt < MAX_FETCH_ATTEMPTS) {
-        await new Promise((resolve49) => setTimeout(resolve49, attempt * 100));
+        await new Promise((resolve50) => setTimeout(resolve50, attempt * 100));
       }
     }
   }
@@ -32631,7 +32683,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((resolve49) => setTimeout(resolve49, intervalMs));
+    await new Promise((resolve50) => setTimeout(resolve50, intervalMs));
   }
   return false;
 }
@@ -34128,15 +34180,15 @@ var require_route = __commonJS({
       };
     }
     function wrapConversion(toModel, graph) {
-      const path65 = [graph[toModel].parent, toModel];
+      const path66 = [graph[toModel].parent, toModel];
       let fn = conversions[graph[toModel].parent][toModel];
       let cur = graph[toModel].parent;
       while (graph[cur].parent) {
-        path65.unshift(graph[cur].parent);
+        path66.unshift(graph[cur].parent);
         fn = link(conversions[graph[cur].parent][cur], fn);
         cur = graph[cur].parent;
       }
-      fn.conversion = path65;
+      fn.conversion = path66;
       return fn;
     }
     module2.exports = function(fromModel) {
@@ -40066,7 +40118,7 @@ var require_iso2022 = __commonJS({
 // node_modules/chardet/index.js
 var require_chardet = __commonJS({
   "node_modules/chardet/index.js"(exports2, module2) {
-    var fs51 = require("fs");
+    var fs52 = require("fs");
     var utf8 = require_utf8();
     var unicode = require_unicode();
     var mbcs = require_mbcs();
@@ -40140,28 +40192,28 @@ var require_chardet = __commonJS({
       var fd;
       var handler = function(err, buffer) {
         if (fd) {
-          fs51.closeSync(fd);
+          fs52.closeSync(fd);
         }
         if (err) return cb(err, null);
         cb(null, self.detect(buffer, opts));
       };
       if (opts && opts.sampleSize) {
-        fd = fs51.openSync(filepath, "r"), sample = Buffer.allocUnsafe(opts.sampleSize);
-        fs51.read(fd, sample, 0, opts.sampleSize, null, function(err) {
+        fd = fs52.openSync(filepath, "r"), sample = Buffer.allocUnsafe(opts.sampleSize);
+        fs52.read(fd, sample, 0, opts.sampleSize, null, function(err) {
           handler(err, sample);
         });
         return;
       }
-      fs51.readFile(filepath, handler);
+      fs52.readFile(filepath, handler);
     };
     module2.exports.detectFileSync = function(filepath, opts) {
       if (opts && opts.sampleSize) {
-        var fd = fs51.openSync(filepath, "r"), sample2 = Buffer.allocUnsafe(opts.sampleSize);
-        fs51.readSync(fd, sample2, 0, opts.sampleSize);
-        fs51.closeSync(fd);
+        var fd = fs52.openSync(filepath, "r"), sample2 = Buffer.allocUnsafe(opts.sampleSize);
+        fs52.readSync(fd, sample2, 0, opts.sampleSize);
+        fs52.closeSync(fd);
         return self.detect(sample2, opts);
       }
-      return self.detect(fs51.readFileSync(filepath), opts);
+      return self.detect(fs52.readFileSync(filepath), opts);
     };
     module2.exports.detectAll = function(buffer, opts) {
       if (typeof opts !== "object") {
@@ -43626,16 +43678,16 @@ var require_os_tmpdir = __commonJS({
     var isWindows = process.platform === "win32";
     var trailingSlashRe = isWindows ? /[^:]\\$/ : /.\/$/;
     module2.exports = function() {
-      var path65;
+      var path66;
       if (isWindows) {
-        path65 = process.env.TEMP || process.env.TMP || (process.env.SystemRoot || process.env.windir) + "\\temp";
+        path66 = process.env.TEMP || process.env.TMP || (process.env.SystemRoot || process.env.windir) + "\\temp";
       } else {
-        path65 = process.env.TMPDIR || process.env.TMP || process.env.TEMP || "/tmp";
+        path66 = process.env.TMPDIR || process.env.TMP || process.env.TEMP || "/tmp";
       }
-      if (trailingSlashRe.test(path65)) {
-        path65 = path65.slice(0, -1);
+      if (trailingSlashRe.test(path66)) {
+        path66 = path66.slice(0, -1);
       }
-      return path65;
+      return path66;
     };
   }
 });
@@ -43643,8 +43695,8 @@ var require_os_tmpdir = __commonJS({
 // node_modules/tmp/lib/tmp.js
 var require_tmp = __commonJS({
   "node_modules/tmp/lib/tmp.js"(exports2, module2) {
-    var fs51 = require("fs");
-    var path65 = require("path");
+    var fs52 = require("fs");
+    var path66 = require("path");
     var crypto6 = require("crypto");
     var osTmpDir = require_os_tmpdir();
     var _c2 = process.binding("constants");
@@ -43686,7 +43738,7 @@ var require_tmp = __commonJS({
     }
     function _generateTmpName(opts) {
       if (opts.name) {
-        return path65.join(opts.dir || tmpDir, opts.name);
+        return path66.join(opts.dir || tmpDir, opts.name);
       }
       if (opts.template) {
         return opts.template.replace(TEMPLATE_PATTERN, _randomChars(6));
@@ -43697,7 +43749,7 @@ var require_tmp = __commonJS({
         _randomChars(12),
         opts.postfix || ""
       ].join("");
-      return path65.join(opts.dir || tmpDir, name);
+      return path66.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;
@@ -43707,7 +43759,7 @@ var require_tmp = __commonJS({
         return cb(new Error("Invalid template provided"));
       (function _getUniqueName() {
         const name = _generateTmpName(opts);
-        fs51.stat(name, function(err) {
+        fs52.stat(name, function(err) {
           if (!err) {
             if (tries-- > 0) return _getUniqueName();
             return cb(new Error("Could not get a unique tmp filename, max tries reached " + name));
@@ -43725,7 +43777,7 @@ var require_tmp = __commonJS({
       do {
         const name = _generateTmpName(opts);
         try {
-          fs51.statSync(name);
+          fs52.statSync(name);
         } catch (e) {
           return name;
         }
@@ -43737,13 +43789,13 @@ var require_tmp = __commonJS({
       opts.postfix = _isUndefined(opts.postfix) ? ".tmp" : opts.postfix;
       tmpName(opts, function _tmpNameCreated(err, name) {
         if (err) return cb(err);
-        fs51.open(name, CREATE_FLAGS, opts.mode || FILE_MODE, function _fileCreated(err2, fd) {
+        fs52.open(name, CREATE_FLAGS, opts.mode || FILE_MODE, function _fileCreated(err2, fd) {
           if (err2) return cb(err2);
           if (opts.discardDescriptor) {
-            return fs51.close(fd, function _discardCallback(err3) {
+            return fs52.close(fd, function _discardCallback(err3) {
               if (err3) {
                 try {
-                  fs51.unlinkSync(name);
+                  fs52.unlinkSync(name);
                 } catch (e) {
                   if (!isENOENT(e)) {
                     err3 = e;
@@ -43766,9 +43818,9 @@ var require_tmp = __commonJS({
       opts.postfix = opts.postfix || ".tmp";
       const discardOrDetachDescriptor = opts.discardDescriptor || opts.detachDescriptor;
       const name = tmpNameSync(opts);
-      var fd = fs51.openSync(name, CREATE_FLAGS, opts.mode || FILE_MODE);
+      var fd = fs52.openSync(name, CREATE_FLAGS, opts.mode || FILE_MODE);
       if (opts.discardDescriptor) {
-        fs51.closeSync(fd);
+        fs52.closeSync(fd);
         fd = void 0;
       }
       return {
@@ -43780,9 +43832,9 @@ var require_tmp = __commonJS({
     function _rmdirRecursiveSync(root) {
       const dirs = [root];
       do {
-        var dir2 = dirs.pop(), deferred = false, files = fs51.readdirSync(dir2);
+        var dir2 = dirs.pop(), deferred = false, files = fs52.readdirSync(dir2);
         for (var i = 0, length = files.length; i < length; i++) {
-          var file2 = path65.join(dir2, files[i]), stat = fs51.lstatSync(file2);
+          var file2 = path66.join(dir2, files[i]), stat = fs52.lstatSync(file2);
           if (stat.isDirectory()) {
             if (!deferred) {
               deferred = true;
@@ -43790,11 +43842,11 @@ var require_tmp = __commonJS({
             }
             dirs.push(file2);
           } else {
-            fs51.unlinkSync(file2);
+            fs52.unlinkSync(file2);
           }
         }
         if (!deferred) {
-          fs51.rmdirSync(dir2);
+          fs52.rmdirSync(dir2);
         }
       } while (dirs.length !== 0);
     }
@@ -43802,7 +43854,7 @@ var require_tmp = __commonJS({
       var args = _parseArguments(options, callback), opts = args[0], cb = args[1];
       tmpName(opts, function _tmpNameCreated(err, name) {
         if (err) return cb(err);
-        fs51.mkdir(name, opts.mode || DIR_MODE, function _dirCreated(err2) {
+        fs52.mkdir(name, opts.mode || DIR_MODE, function _dirCreated(err2) {
           if (err2) return cb(err2);
           cb(null, name, _prepareTmpDirRemoveCallback(name, opts));
         });
@@ -43811,7 +43863,7 @@ var require_tmp = __commonJS({
     function dirSync(options) {
       var args = _parseArguments(options), opts = args[0];
       const name = tmpNameSync(opts);
-      fs51.mkdirSync(name, opts.mode || DIR_MODE);
+      fs52.mkdirSync(name, opts.mode || DIR_MODE);
       return {
         name,
         removeCallback: _prepareTmpDirRemoveCallback(name, opts)
@@ -43821,7 +43873,7 @@ var require_tmp = __commonJS({
       const removeCallback = _prepareRemoveCallback(function _removeCallback(fdPath) {
         try {
           if (0 <= fdPath[0]) {
-            fs51.closeSync(fdPath[0]);
+            fs52.closeSync(fdPath[0]);
           }
         } catch (e) {
           if (!isEBADF(e) && !isENOENT(e)) {
@@ -43829,7 +43881,7 @@ var require_tmp = __commonJS({
           }
         }
         try {
-          fs51.unlinkSync(fdPath[1]);
+          fs52.unlinkSync(fdPath[1]);
         } catch (e) {
           if (!isENOENT(e)) {
             throw e;
@@ -43842,7 +43894,7 @@ var require_tmp = __commonJS({
       return removeCallback;
     }
     function _prepareTmpDirRemoveCallback(name, opts) {
-      const removeFunction = opts.unsafeCleanup ? _rmdirRecursiveSync : fs51.rmdirSync.bind(fs51);
+      const removeFunction = opts.unsafeCleanup ? _rmdirRecursiveSync : fs52.rmdirSync.bind(fs52);
       const removeCallback = _prepareRemoveCallback(removeFunction, name);
       if (!opts.keep) {
         _removeObjects.unshift(removeCallback);
@@ -44993,7 +45045,7 @@ var require_Observable = __commonJS({
       Observable2.prototype.forEach = function(next, promiseCtor) {
         var _this = this;
         promiseCtor = getPromiseCtor(promiseCtor);
-        return new promiseCtor(function(resolve49, reject) {
+        return new promiseCtor(function(resolve50, reject) {
           var subscriber = new Subscriber_1.SafeSubscriber({
             next: function(value) {
               try {
@@ -45004,7 +45056,7 @@ var require_Observable = __commonJS({
               }
             },
             error: reject,
-            complete: resolve49
+            complete: resolve50
           });
           _this.subscribe(subscriber);
         });
@@ -45026,14 +45078,14 @@ var require_Observable = __commonJS({
       Observable2.prototype.toPromise = function(promiseCtor) {
         var _this = this;
         promiseCtor = getPromiseCtor(promiseCtor);
-        return new promiseCtor(function(resolve49, reject) {
+        return new promiseCtor(function(resolve50, reject) {
           var value;
           _this.subscribe(function(x) {
             return value = x;
           }, function(err) {
             return reject(err);
           }, function() {
-            return resolve49(value);
+            return resolve50(value);
           });
         });
       };
@@ -47129,11 +47181,11 @@ var require_innerFrom = __commonJS({
     "use strict";
     var __awaiter = exports2 && exports2.__awaiter || function(thisArg, _arguments, P2, generator) {
       function adopt(value) {
-        return value instanceof P2 ? value : new P2(function(resolve49) {
-          resolve49(value);
+        return value instanceof P2 ? value : new P2(function(resolve50) {
+          resolve50(value);
         });
       }
-      return new (P2 || (P2 = Promise))(function(resolve49, reject) {
+      return new (P2 || (P2 = Promise))(function(resolve50, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -47149,7 +47201,7 @@ var require_innerFrom = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve49(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve50(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -47231,14 +47283,14 @@ var require_innerFrom = __commonJS({
       }, i);
       function verb(n) {
         i[n] = o[n] && function(v2) {
-          return new Promise(function(resolve49, reject) {
-            v2 = o[n](v2), settle(resolve49, reject, v2.done, v2.value);
+          return new Promise(function(resolve50, reject) {
+            v2 = o[n](v2), settle(resolve50, reject, v2.done, v2.value);
           });
         };
       }
-      function settle(resolve49, reject, d, v2) {
+      function settle(resolve50, reject, d, v2) {
         Promise.resolve(v2).then(function(v3) {
-          resolve49({ value: v3, done: d });
+          resolve50({ value: v3, done: d });
         }, reject);
       }
     };
@@ -47857,7 +47909,7 @@ var require_lastValueFrom = __commonJS({
     var EmptyError_1 = require_EmptyError();
     function lastValueFrom2(source, config2) {
       var hasConfig = typeof config2 === "object";
-      return new Promise(function(resolve49, reject) {
+      return new Promise(function(resolve50, reject) {
         var _hasValue = false;
         var _value;
         source.subscribe({
@@ -47868,9 +47920,9 @@ var require_lastValueFrom = __commonJS({
           error: reject,
           complete: function() {
             if (_hasValue) {
-              resolve49(_value);
+              resolve50(_value);
             } else if (hasConfig) {
-              resolve49(config2.defaultValue);
+              resolve50(config2.defaultValue);
             } else {
               reject(new EmptyError_1.EmptyError());
             }
@@ -47892,16 +47944,16 @@ var require_firstValueFrom = __commonJS({
     var Subscriber_1 = require_Subscriber();
     function firstValueFrom(source, config2) {
       var hasConfig = typeof config2 === "object";
-      return new Promise(function(resolve49, reject) {
+      return new Promise(function(resolve50, reject) {
         var subscriber = new Subscriber_1.SafeSubscriber({
           next: function(value) {
-            resolve49(value);
+            resolve50(value);
             subscriber.unsubscribe();
           },
           error: reject,
           complete: function() {
             if (hasConfig) {
-              resolve49(config2.defaultValue);
+              resolve50(config2.defaultValue);
             } else {
               reject(new EmptyError_1.EmptyError());
             }
@@ -53694,14 +53746,14 @@ var require_run_async = __commonJS({
       return function() {
         var args = arguments;
         var originalThis = this;
-        var promise = new Promise(function(resolve49, reject) {
+        var promise = new Promise(function(resolve50, reject) {
           var resolved = false;
           const wrappedResolve = function(value) {
             if (resolved) {
               console.warn("Run-async promise already resolved.");
             }
             resolved = true;
-            resolve49(value);
+            resolve50(value);
           };
           var rejected = false;
           const wrappedReject = function(value) {
@@ -57213,7 +57265,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve49.call(this, root, ref);
+      let _sch = resolve50.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a2 = root.localRefs) === null || _a2 === void 0 ? void 0 : _a2[ref];
         const { schemaId } = this.opts;
@@ -57240,7 +57292,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve49(root, ref) {
+    function resolve50(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -57458,8 +57510,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path65) {
-      let input = path65;
+    function removeDotSegments(path66) {
+      let input = path66;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -57711,8 +57763,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path65, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path65 && path65 !== "/" ? path65 : void 0;
+        const [path66, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path66 && path66 !== "/" ? path66 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -57871,7 +57923,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve49(baseURI, relativeURI, options) {
+    function resolve50(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;
@@ -58129,7 +58181,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize3,
-      resolve: resolve49,
+      resolve: resolve50,
       resolveComponent,
       equal,
       serialize,
@@ -61105,12 +61157,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats(ajv, list, fs51, exportName) {
+    function addFormats(ajv, list, fs52, exportName) {
       var _a2;
       var _b2;
       (_a2 = (_b2 = ajv.opts.code).formats) !== null && _a2 !== void 0 ? _a2 : _b2.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f of list)
-        ajv.addFormat(f, fs51[f]);
+        ajv.addFormat(f, fs52[f]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -62394,11 +62446,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: (path65) => {
+  require: (path66) => {
     if (typeof require !== "undefined") {
-      return require(path65);
-    } else if (path65.match(/\.json$/)) {
-      return JSON.parse((0, import_fs2.readFileSync)(path65, "utf8"));
+      return require(path66);
+    } else if (path66.match(/\.json$/)) {
+      return JSON.parse((0, import_fs2.readFileSync)(path66, "utf8"));
     } else {
       throw Error("only .json config files are supported in ESM");
     }
@@ -64924,12 +64976,12 @@ var YargsInstance = class {
   async getCompletion(args, done) {
     argsert("<array> [function]", [args, done], arguments.length);
     if (!done) {
-      return new Promise((resolve49, reject) => {
+      return new Promise((resolve50, reject) => {
         __classPrivateFieldGet(this, _YargsInstance_completion, "f").getCompletion(args, (err, completions) => {
           if (err)
             reject(err);
           else
-            resolve49(completions);
+            resolve50(completions);
         });
       });
     } else {
@@ -66218,16 +66270,16 @@ async function handleAgentSkills(options) {
 }
 async function askYesNo(question) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve49) => {
+  return new Promise((resolve50) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve49(true);
+        resolve50(true);
         return;
       }
-      resolve49(/^y(es)?$/i.test(trimmed));
+      resolve50(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -66307,7 +66359,7 @@ function handleRemove(argv) {
 }
 
 // src/cli/commands/env.ts
-var path54 = __toESM(require("path"));
+var path55 = __toESM(require("path"));
 
 // src/cli/finish-command.ts
 init_sync_context();
@@ -67632,13 +67684,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 resolve49;
+    let resolve50;
     let reject;
     const promise = new Promise((res, rej) => {
-      resolve49 = res;
+      resolve50 = res;
       reject = rej;
     });
-    return { promise, resolve: resolve49, reject };
+    return { promise, resolve: resolve50, reject };
   }
 };
 
@@ -67655,7 +67707,7 @@ function createPrompt(view) {
       output
     });
     const screen = new ScreenManager(rl);
-    const { promise, resolve: resolve49, reject } = PromisePolyfill.withResolver();
+    const { promise, resolve: resolve50, reject } = PromisePolyfill.withResolver();
     const cancel = () => reject(new CancelPromptError());
     if (signal) {
       const abort = () => reject(new AbortPromptError({ cause: signal.reason }));
@@ -67679,7 +67731,7 @@ function createPrompt(view) {
       cycle(() => {
         try {
           const nextView = view(config2, (value) => {
-            setImmediate(() => resolve49(value));
+            setImmediate(() => resolve50(value));
           });
           const [content, bottomContent] = typeof nextView === "string" ? [nextView] : nextView;
           screen.render(content, bottomContent);
@@ -68666,9 +68718,9 @@ var import_run_async = __toESM(require_run_async(), 1);
 var import_mute_stream2 = __toESM(require_lib(), 1);
 var import_ansi_escapes5 = __toESM(require_ansi_escapes(), 1);
 var _ = {
-  set: (obj, path65 = "", value) => {
+  set: (obj, path66 = "", value) => {
     let pointer = obj;
-    path65.split(".").forEach((key, index, arr) => {
+    path66.split(".").forEach((key, index, arr) => {
       if (key === "__proto__" || key === "constructor")
         return;
       if (index === arr.length - 1) {
@@ -68679,8 +68731,8 @@ var _ = {
       pointer = pointer[key];
     });
   },
-  get: (obj, path65 = "", defaultValue) => {
-    const travel = (regexp) => String.prototype.split.call(path65, regexp).filter(Boolean).reduce(
+  get: (obj, path66 = "", defaultValue) => {
+    const travel = (regexp) => String.prototype.split.call(path66, regexp).filter(Boolean).reduce(
       // @ts-expect-error implicit any on res[key]
       (res, key) => res !== null && res !== void 0 ? res[key] : res,
       obj
@@ -68794,7 +68846,7 @@ var PromptsRunner = class {
       throw new Error(`Prompt for type ${question.type} not found`);
     }
     let cleanupSignal;
-    const promptFn = isPromptConstructor(prompt2) ? (q, { signal: signal2 } = {}) => new Promise((resolve49, reject) => {
+    const promptFn = isPromptConstructor(prompt2) ? (q, { signal: signal2 } = {}) => new Promise((resolve50, reject) => {
       const rl = import_node_readline.default.createInterface(setupReadlineOptions(this.opt));
       rl.resume();
       const onClose = () => {
@@ -68830,7 +68882,7 @@ var PromptsRunner = class {
           cleanupSignal = void 0;
         };
       }
-      activePrompt.run().then(resolve49, reject).finally(cleanup);
+      activePrompt.run().then(resolve50, reject).finally(cleanup);
     }) : prompt2;
     const { signal: moduleSignal } = this.opt;
     if (moduleSignal?.aborted) {
@@ -71185,12 +71237,12 @@ function printAdaptationPrompt(content) {
 }
 function askYesNo2(question) {
   const rl = readline5.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve49) => {
+  return new Promise((resolve50) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
-      resolve49(trimmed === "" || /^y(es)?$/i.test(trimmed));
+      resolve50(trimmed === "" || /^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -71279,16 +71331,16 @@ async function promptScaffoldCursorRule(exists) {
 }
 async function askYesNo3(question) {
   const rl = readline6.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve49) => {
+  return new Promise((resolve50) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve49(true);
+        resolve50(true);
         return;
       }
-      resolve49(/^y(es)?$/i.test(trimmed));
+      resolve50(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -71728,7 +71780,8 @@ Usage from Cursor / Claude / Codex (@osfactory/otel-hook) will appear under Work
         source: options.source,
         sourceUrl: options.sourceUrl,
         title: options.title,
-        parentWorkUnitId: options.parentWorkUnitId
+        parentWorkUnitId: options.parentWorkUnitId,
+        relatedLinks: options.relatedLinks
       });
       createWorkAttempt(harnessRoot, {
         attemptId,
@@ -72005,21 +72058,319 @@ var getEnvironmentLogs = defaultRunService.getEnvironmentLogs.bind(defaultRunSer
 
 // src/cli/commands/env.ts
 init_runs();
+init_work_units();
+init_manifest();
 init_slot_status();
 
+// src/core/cleanup-service.ts
+var fs46 = __toESM(require("fs"));
+var os18 = __toESM(require("os"));
+var path53 = __toESM(require("path"));
+var import_child_process14 = require("child_process");
+init_control_sync();
+init_control_repo_path();
+init_slot_status();
+init_manifest();
+var DEFAULT_STALE_DAYS = 7;
+function getWorktreesRoot() {
+  if (process.env.HAR_WORKTREES_ROOT) {
+    return path53.resolve(process.env.HAR_WORKTREES_ROOT);
+  }
+  return path53.join(process.env.HOME || os18.homedir(), "worktrees");
+}
+function runGit3(cwd, args) {
+  try {
+    return (0, import_child_process14.execSync)(`git ${args}`, {
+      cwd,
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "ignore"]
+    }).trim();
+  } catch {
+    return void 0;
+  }
+}
+function basenameRepo(repoPath) {
+  return path53.basename(canonicalizeControlRepoPath(repoPath));
+}
+function ageDaysFrom(iso) {
+  if (!iso) return void 0;
+  const created = Date.parse(iso);
+  if (Number.isNaN(created)) return void 0;
+  return Math.floor((Date.now() - created) / (24 * 60 * 60 * 1e3));
+}
+function matchesKeep(candidate, keep) {
+  if (!keep?.length) return false;
+  for (const pin of keep) {
+    if (pin.worktreePath && candidate.worktreePath) {
+      if (path53.resolve(pin.worktreePath) === path53.resolve(candidate.worktreePath)) return true;
+    }
+    if (pin.repoPath && pin.agentId !== void 0 && candidate.agentId !== void 0) {
+      const repo = canonicalizeControlRepoPath(pin.repoPath);
+      const candidateRepo = path53.resolve(candidate.repoPath);
+      if ((repo === candidateRepo || path53.resolve(pin.repoPath) === candidateRepo) && pin.agentId === candidate.agentId) {
+        return true;
+      }
+    }
+    if (pin.repoPath && pin.agentId === void 0 && !pin.worktreePath) {
+      if (canonicalizeControlRepoPath(pin.repoPath) === candidate.repoPath) return true;
+    }
+  }
+  return false;
+}
+function classifySlotCandidate(repoPath, projectName, slot, options) {
+  if (!slot.active && !slot.worktreePath) return void 0;
+  const candidate = {
+    kind: "active_slot",
+    repoPath,
+    projectName,
+    agentId: slot.agentId,
+    worktreePath: slot.worktreePath ?? slot.workDir,
+    branch: slot.branch,
+    active: slot.active,
+    dirty: slot.dirty,
+    ageDays: ageDaysFrom(slot.sessionCreatedAt),
+    sessionCreatedAt: slot.sessionCreatedAt,
+    recommendation: "review",
+    reason: "active session"
+  };
+  if (matchesKeep(candidate, options?.keep)) {
+    candidate.recommendation = "keep";
+    candidate.reason = "pinned with --keep";
+    return candidate;
+  }
+  if (slot.dirty) {
+    candidate.recommendation = "review";
+    candidate.reason = "uncommitted changes \u2014 review before teardown";
+    return candidate;
+  }
+  if (slot.sessionStatus === "failed" || slot.sessionStatus === "starting") {
+    candidate.recommendation = "review";
+    candidate.reason = "failed or resumable session \u2014 recover or teardown manually";
+    return candidate;
+  }
+  const staleDays = options?.staleDays ?? DEFAULT_STALE_DAYS;
+  const age = candidate.ageDays;
+  if (age !== void 0 && age >= staleDays) {
+    candidate.recommendation = "teardown";
+    candidate.reason = `idle ${age}d, clean`;
+    return candidate;
+  }
+  if (slot.active) {
+    candidate.recommendation = "review";
+    candidate.reason = age !== void 0 ? `active session (${age}d) \u2014 keep unless finished` : "active session \u2014 keep unless finished";
+  }
+  return candidate;
+}
+function resolveRepoForWorktree(worktreePath) {
+  if (!fs46.existsSync(worktreePath)) return void 0;
+  const commonDir = runGit3(worktreePath, "rev-parse --git-common-dir");
+  if (!commonDir) return void 0;
+  const gitRoot = path53.resolve(worktreePath, commonDir, "..");
+  if (!readManifest(gitRoot)) return void 0;
+  return canonicalizeControlRepoPath(gitRoot);
+}
+function discoverOrphanWorktrees(knownPaths) {
+  const worktreesRoot = getWorktreesRoot();
+  if (!fs46.existsSync(worktreesRoot)) return [];
+  const orphans = [];
+  for (const entry of fs46.readdirSync(worktreesRoot, { withFileTypes: true })) {
+    if (!entry.isDirectory() || !entry.name.includes("-har-agent-")) continue;
+    const worktreePath = path53.resolve(path53.join(worktreesRoot, entry.name));
+    if (knownPaths.has(worktreePath)) continue;
+    const repoPath = resolveRepoForWorktree(worktreePath) ?? worktreesRoot;
+    const porcelain = runGit3(worktreePath, "status --porcelain");
+    const dirty = porcelain !== void 0 ? porcelain.length > 0 : void 0;
+    const branch = runGit3(worktreePath, "rev-parse --abbrev-ref HEAD");
+    orphans.push({
+      kind: "orphan_worktree",
+      repoPath,
+      projectName: basenameRepo(repoPath),
+      worktreePath,
+      branch: branch && branch !== "HEAD" ? branch : void 0,
+      active: false,
+      dirty,
+      recommendation: dirty ? "review" : "remove_orphan",
+      reason: dirty ? "orphan worktree with uncommitted changes" : "orphan worktree \u2014 no slot registry"
+    });
+  }
+  return orphans.sort((a, b2) => (a.worktreePath ?? "").localeCompare(b2.worktreePath ?? ""));
+}
+async function discoverCleanupCandidates(options = {}) {
+  const repoPaths = options.repoPaths ?? await discoverHarRepos({ cwd: options.cwd ?? process.cwd() });
+  const candidates = [];
+  const knownWorktreePaths = /* @__PURE__ */ new Set();
+  for (const repoPath of repoPaths) {
+    if (!fs46.existsSync(repoPath) || !readManifest(repoPath)) continue;
+    const harnessRoot = resolveHarnessRoot(repoPath);
+    const canonicalRepo = canonicalizeControlRepoPath(harnessRoot);
+    const status = collectEnvironmentStatus(harnessRoot);
+    const projectName = basenameRepo(harnessRoot);
+    for (const slot of status.slots) {
+      if (slot.worktreePath) knownWorktreePaths.add(path53.resolve(slot.worktreePath));
+      if (slot.workDir) knownWorktreePaths.add(path53.resolve(slot.workDir));
+      const candidate = classifySlotCandidate(canonicalRepo, projectName, slot, {
+        staleDays: options.staleDays,
+        keep: options.keep
+      });
+      if (!candidate) continue;
+      if (candidate.recommendation === "review" && !options.includeReview) {
+      }
+      candidates.push(candidate);
+    }
+  }
+  if (options.orphans !== false) {
+    for (const orphan of discoverOrphanWorktrees(knownWorktreePaths)) {
+      if (matchesKeep(orphan, options.keep)) {
+        orphan.recommendation = "keep";
+        orphan.reason = "pinned with --keep";
+      }
+      candidates.push(orphan);
+    }
+  }
+  return {
+    candidates: candidates.sort((a, b2) => {
+      const repo = a.repoPath.localeCompare(b2.repoPath);
+      if (repo !== 0) return repo;
+      return (a.agentId ?? 0) - (b2.agentId ?? 0);
+    }),
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function selectAutoApprovedCandidates(plan, options) {
+  return plan.candidates.filter((candidate) => {
+    if (candidate.recommendation === "keep") return false;
+    if (candidate.recommendation === "review") return options?.includeReview === true;
+    return candidate.recommendation === "teardown" || candidate.recommendation === "remove_orphan";
+  });
+}
+function formatCleanupPlan(plan) {
+  if (plan.candidates.length === 0) {
+    return "No session worktrees or orphans found.";
+  }
+  const lines2 = [];
+  lines2.push(
+    `${"REC".padEnd(8)} ${"REPO".padEnd(18)} ${"SLOT".padEnd(6)} ${"AGE".padEnd(5)} WORKTREE / REASON`
+  );
+  lines2.push("-".repeat(100));
+  for (const candidate of plan.candidates) {
+    const slot = candidate.agentId !== void 0 ? String(candidate.agentId) : "-";
+    const age = candidate.ageDays !== void 0 ? `${candidate.ageDays}d` : "-";
+    const target = candidate.worktreePath ?? candidate.repoPath;
+    lines2.push(
+      `${candidate.recommendation.padEnd(8)} ${candidate.projectName.padEnd(18)} ${slot.padEnd(6)} ${age.padEnd(5)} ${target}`
+    );
+    lines2.push(`         ${candidate.reason}`);
+  }
+  return lines2.join("\n");
+}
+async function askYesNo4(question) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
+  const readline8 = await import("readline");
+  const rl = readline8.createInterface({ input: process.stdin, output: process.stderr });
+  const answer = await new Promise((resolve50) => {
+    rl.question(question, resolve50);
+  });
+  rl.close();
+  return /^[Yy]$/.test(answer.trim());
+}
+async function confirmCleanupSelection(candidates) {
+  if (candidates.length === 0) return [];
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw new Error("Non-interactive terminal \u2014 pass --yes (and optionally --include-review)");
+  }
+  const approved = [];
+  for (const candidate of candidates) {
+    if (candidate.recommendation === "keep") continue;
+    const label = candidate.kind === "orphan_worktree" ? `orphan ${candidate.worktreePath}` : `${candidate.projectName} agent ${candidate.agentId}`;
+    const action = candidate.recommendation === "remove_orphan" ? "remove" : "teardown";
+    const ok = await askYesNo4(`${action} ${label}? [${candidate.recommendation === "teardown" || candidate.recommendation === "remove_orphan" ? "Y" : "y"}/n] `);
+    if (ok) approved.push(candidate);
+  }
+  return approved;
+}
+async function executeCleanupCandidates(candidates, options = {}) {
+  const service = createRunService();
+  const outcomes = [];
+  for (const candidate of candidates) {
+    if (candidate.recommendation === "keep") continue;
+    if (options.dryRun) {
+      outcomes.push({ candidate, ok: true });
+      continue;
+    }
+    try {
+      if (candidate.kind === "active_slot" && candidate.agentId !== void 0) {
+        const result = await service.teardownEnvironment({
+          repoPath: candidate.repoPath,
+          agentId: candidate.agentId,
+          capture: false,
+          trigger: "cli"
+        });
+        outcomes.push({
+          candidate,
+          ok: result.code === 0,
+          error: result.code === 0 ? void 0 : result.stderr?.trim() || `exit ${result.code}`
+        });
+        continue;
+      }
+      if (candidate.kind === "orphan_worktree" && candidate.worktreePath) {
+        if (fs46.existsSync(candidate.worktreePath)) {
+          const repoRoot = candidate.repoPath !== getWorktreesRoot() ? candidate.repoPath : resolveRepoForWorktree(candidate.worktreePath);
+          if (repoRoot) {
+            try {
+              (0, import_child_process14.execSync)(`git worktree remove --force ${JSON.stringify(candidate.worktreePath)}`, {
+                cwd: repoRoot,
+                stdio: ["pipe", "pipe", "ignore"]
+              });
+            } catch {
+            }
+          }
+          if (fs46.existsSync(candidate.worktreePath)) {
+            fs46.rmSync(candidate.worktreePath, { recursive: true, force: true });
+          }
+        }
+        outcomes.push({ candidate, ok: true });
+        continue;
+      }
+      outcomes.push({ candidate, ok: false, error: "unsupported candidate" });
+    } catch (err) {
+      outcomes.push({
+        candidate,
+        ok: false,
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+  }
+  return outcomes;
+}
+function parseCleanupKeepPins(values) {
+  if (!values?.length) return [];
+  return values.map((raw) => {
+    const agentMatch = raw.match(/^(.+):(\d+)$/);
+    if (agentMatch) {
+      return { repoPath: agentMatch[1], agentId: Number(agentMatch[2]) };
+    }
+    if (raw.startsWith("/") || raw.startsWith("~")) {
+      return {
+        worktreePath: raw.startsWith("~") ? path53.join(process.env.HOME || os18.homedir(), raw.slice(2)) : path53.resolve(raw)
+      };
+    }
+    return { repoPath: raw };
+  });
+}
+
 // src/core/commit-gate-onboarding.ts
 var readline7 = __toESM(require("readline"));
 init_hooks();
 init_stages();
 init_logging();
-function askYesNo4(question) {
+function askYesNo5(question) {
   const rl = readline7.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve49) => {
+  return new Promise((resolve50) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
-      resolve49(trimmed === "" || /^y(es)?$/i.test(trimmed));
+      resolve50(trimmed === "" || /^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -72044,7 +72395,7 @@ async function handleCommitGateOnboarding(options) {
   const status = getHooksStatus(options.repoPath);
   let shouldInstall = status.preCommitInstalled || status.postCommitInstalled || options.install === "always" || options.autoYes === true;
   if (!shouldInstall && options.install === "prompt" && process.stdin.isTTY && process.stdout.isTTY) {
-    shouldInstall = await askYesNo4("Install the HAR commit gate for this repository? [Y/n]");
+    shouldInstall = await askYesNo5("Install the HAR commit gate for this repository? [Y/n]");
   }
   if (!shouldInstall) {
     info("Commit gate is not installed; run `har hooks install` when ready.");
@@ -72061,21 +72412,21 @@ async function handleCommitGateOnboarding(options) {
 }
 
 // src/core/onboarding-preferences.ts
-var fs46 = __toESM(require("fs"));
-var os18 = __toESM(require("os"));
-var path53 = __toESM(require("path"));
+var fs47 = __toESM(require("fs"));
+var os19 = __toESM(require("os"));
+var path54 = __toESM(require("path"));
 init_schema2();
 function getOnboardingPreferencesPath() {
   if (process.env.HAR_PREFERENCES_PATH) {
-    return path53.resolve(process.env.HAR_PREFERENCES_PATH);
+    return path54.resolve(process.env.HAR_PREFERENCES_PATH);
   }
-  return path53.join(os18.homedir(), ".har", "preferences.json");
+  return path54.join(os19.homedir(), ".har", "preferences.json");
 }
 function readOnboardingPreferences() {
   const preferencePath = getOnboardingPreferencesPath();
   try {
-    if (!fs46.existsSync(preferencePath)) return OnboardingPreferencesSchema.parse({});
-    return OnboardingPreferencesSchema.parse(JSON.parse(fs46.readFileSync(preferencePath, "utf8")));
+    if (!fs47.existsSync(preferencePath)) return OnboardingPreferencesSchema.parse({});
+    return OnboardingPreferencesSchema.parse(JSON.parse(fs47.readFileSync(preferencePath, "utf8")));
   } catch {
     return OnboardingPreferencesSchema.parse({});
   }
@@ -72100,8 +72451,8 @@ function writeOnboardingPreferences(overrides) {
   };
   const parsed = OnboardingPreferencesSchema.parse(preference);
   const preferencePath = getOnboardingPreferencesPath();
-  fs46.mkdirSync(path53.dirname(preferencePath), { recursive: true });
-  fs46.writeFileSync(preferencePath, `${JSON.stringify(parsed, null, 2)}
+  fs47.mkdirSync(path54.dirname(preferencePath), { recursive: true });
+  fs47.writeFileSync(preferencePath, `${JSON.stringify(parsed, null, 2)}
 `);
   return parsed;
 }
@@ -72165,6 +72516,14 @@ feature branch.
   Failed launch: har env recover 1    # or: har env launch 1 --resume`;
 
 // src/cli/commands/env.ts
+var workLinkOptions = (y) => y.option("repo", { type: "string", default: ".", describe: "Path to the repository" }).option("work-id", {
+  type: "string",
+  demandOption: true,
+  describe: "Repo-scoped work unit id (same as --work-id at launch)"
+}).option("link", {
+  type: "string",
+  describe: "Link as source|url or source|url|label"
+}).option("source", { type: "string", describe: "Tracker provider (e.g. github, jira)" }).option("url", { type: "string", describe: "Canonical URL for the link" }).option("label", { type: "string", describe: "Optional display label" });
 var envCommand = {
   command: "env <subcommand>",
   describe: "Manage agent environments (launch \u2192 verify \u2192 complete)",
@@ -72324,8 +72683,17 @@ var envCommand = {
     }).option("parent-work-id", {
       type: "string",
       describe: "Optional parent work unit identifier"
+    }).option("work-link", {
+      type: "array",
+      string: true,
+      describe: "Additional tracker link: source|url or source|url|label (repeatable)"
     }).epilog(LAUNCH_EPILOG),
     handleLaunch
+  ).command(
+    "work-link",
+    "Append a related external link to an existing work unit",
+    workLinkOptions,
+    handleWorkLink
   ).command(
     "recover <id>",
     "Resume a failed or partial launch (alias for launch --resume)",
@@ -72364,6 +72732,38 @@ var envCommand = {
     "Show status of all running agents",
     (y) => y.option("repo", { type: "string", default: "." }).option("json", { type: "boolean", default: false, describe: "Structured JSON output" }),
     handleStatus
+  ).command(
+    "cleanup",
+    "Discover stale session worktrees across registered repos and tear them down",
+    (y) => y.option("repo", {
+      type: "string",
+      describe: "Limit cleanup scan to one repository path"
+    }).option("dry-run", {
+      type: "boolean",
+      default: false,
+      describe: "Show the cleanup plan without executing"
+    }).option("yes", {
+      alias: "y",
+      type: "boolean",
+      default: false,
+      describe: "Approve teardown/remove for recommended rows without prompting"
+    }).option("keep", {
+      type: "string",
+      describe: "Pin sessions to keep (comma-separated repoPath:agentId or worktree paths)"
+    }).option("stale", {
+      type: "number",
+      default: 7,
+      describe: "Age in days before a clean idle session is recommended for teardown"
+    }).option("orphans", {
+      type: "boolean",
+      default: true,
+      describe: "Include orphan worktree directories under ~/worktrees"
+    }).option("include-review", {
+      type: "boolean",
+      default: false,
+      describe: "With --yes, also teardown/remove rows marked review (dirty or recent active)"
+    }).option("json", { type: "boolean", default: false, describe: "Structured JSON output" }),
+    handleCleanup
   ).command(
     "runs",
     "Inspect harness run history",
@@ -72386,13 +72786,13 @@ var envCommand = {
     }
   ).demandCommand(
     1,
-    "Please specify a subcommand: init, maintain, add-stage, launch, recover, verify, complete, teardown, status, runs"
+    "Please specify a subcommand: init, maintain, add-stage, launch, recover, verify, complete, teardown, status, cleanup, runs"
   ).epilog(HAR_ENV_EPILOG),
   handler: () => {
   }
 };
 async function handleInit(argv) {
-  const repoPath = path54.resolve(argv.repo);
+  const repoPath = path55.resolve(argv.repo);
   const onboarding = resolveOnboardingOptions(argv);
   header("har env init");
   info(`Repository: ${repoPath}`);
@@ -72438,7 +72838,7 @@ async function handleInit(argv) {
   }
 }
 async function handleMaintain(argv) {
-  const repoPath = path54.resolve(argv.repo);
+  const repoPath = path55.resolve(argv.repo);
   const onboarding = resolveOnboardingOptions(argv);
   header("har env maintain");
   info(`Repository: ${repoPath}`);
@@ -72569,7 +72969,7 @@ async function applyAgentIntegrations(options) {
   }
 }
 async function handleAddPlugin(argv) {
-  const repoPath = path54.resolve(argv.repo);
+  const repoPath = path55.resolve(argv.repo);
   const available = listPluginIds();
   if (argv.list) {
     for (const id of available) {
@@ -72609,7 +73009,7 @@ async function handleAddPlugin(argv) {
   }
 }
 async function handleAddStage(argv) {
-  const repoPath = path54.resolve(argv.repo);
+  const repoPath = path55.resolve(argv.repo);
   const available = listPluginIds();
   if (argv.list) {
     warn("har env add-stage --list is deprecated; prefer: har env add-plugin --list");
@@ -72675,7 +73075,7 @@ async function handleAddStage(argv) {
   });
 }
 async function handlePreflight(argv) {
-  const repo = path54.resolve(argv.repo);
+  const repo = path55.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await preflightEnvironment({
     repoPath: repo,
@@ -72691,7 +73091,7 @@ async function handlePreflight(argv) {
   return finishCommand(result.code);
 }
 async function handleLaunch(argv) {
-  const repo = path54.resolve(argv.repo);
+  const repo = path55.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   if (!argv.resume) {
     const guard = checkLaunchGuard2(repo, agentId, { worktree: argv.worktree });
@@ -72714,6 +73114,7 @@ async function handleLaunch(argv) {
     sourceUrl: argv.workUrl,
     title: argv.workTitle,
     parentWorkUnitId: argv.parentWorkId,
+    relatedLinks: argv.workLink?.map(parseWorkLinkSpec),
     capture: false
   });
   if (result.blocked) {
@@ -72734,6 +73135,22 @@ async function handleLaunch(argv) {
   }
   return finishCommand(result.code);
 }
+async function handleWorkLink(argv) {
+  if (!argv.link && !(argv.source && argv.url)) {
+    error("Provide --link or both --source and --url");
+    return finishCommand(1);
+  }
+  const harnessRoot = resolveHarnessRoot(path55.resolve(argv.repo));
+  const links = argv.link ? [parseWorkLinkSpec(argv.link)] : [{ source: argv.source, url: argv.url, label: argv.label }];
+  try {
+    const record2 = addWorkUnitLinks(harnessRoot, argv.workId, links);
+    success(`Added link to work unit ${record2.workUnitId}`);
+    return finishCommand(0);
+  } catch (err) {
+    error(err instanceof Error ? err.message : String(err));
+    return finishCommand(1);
+  }
+}
 async function handleRecover(argv) {
   return handleLaunch({
     id: argv.id,
@@ -72749,7 +73166,7 @@ async function handleRecover(argv) {
   });
 }
 async function handleVerify(argv) {
-  const repo = path54.resolve(argv.repo);
+  const repo = path55.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await runVerification({
     repoPath: repo,
@@ -72761,7 +73178,7 @@ async function handleVerify(argv) {
   return finishCommand(result.code);
 }
 async function handleTeardown(argv) {
-  const repo = path54.resolve(argv.repo);
+  const repo = path55.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await teardownEnvironment({
     repoPath: repo,
@@ -72772,7 +73189,7 @@ async function handleTeardown(argv) {
   return finishCommand(result.code);
 }
 async function handleComplete(argv) {
-  const repo = path54.resolve(argv.repo);
+  const repo = path55.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await completeEnvironment({
     repoPath: repo,
@@ -72793,7 +73210,7 @@ async function handleComplete(argv) {
   return finishCommand(result.code);
 }
 async function handleStatus(argv) {
-  const repoPath = path54.resolve(argv.repo);
+  const repoPath = path55.resolve(argv.repo);
   if (argv.json) {
     const status = collectEnvironmentStatus(repoPath);
     const output = EnvironmentStatusSchema.parse(status);
@@ -72805,8 +73222,59 @@ async function handleStatus(argv) {
     capture: false
   });
 }
+async function handleCleanup(argv) {
+  const keepValues = argv.keep?.split(",").map((value) => value.trim()).filter(Boolean);
+  const keep = parseCleanupKeepPins(keepValues);
+  const repoPaths = argv.repo ? [path55.resolve(argv.repo)] : void 0;
+  const plan = await discoverCleanupCandidates({
+    cwd: process.cwd(),
+    repoPaths,
+    keep,
+    staleDays: argv.stale,
+    orphans: argv.orphans
+  });
+  if (argv.json) {
+    process.stdout.write(JSON.stringify(plan, null, 2) + "\n");
+    if (argv.dryRun) return;
+  } else {
+    header("har env cleanup");
+    process.stdout.write(`${formatCleanupPlan(plan)}
+
+`);
+    if (argv.dryRun) {
+      info("Dry run \u2014 no changes made.");
+      return;
+    }
+  }
+  let selected = selectAutoApprovedCandidates(plan, { includeReview: argv.includeReview });
+  if (!argv.yes) {
+    try {
+      const interactive = await confirmCleanupSelection(plan.candidates);
+      selected = interactive;
+    } catch (err) {
+      error(err instanceof Error ? err.message : String(err));
+      return finishCommand(1);
+    }
+  }
+  if (selected.length === 0) {
+    info("Nothing selected for cleanup.");
+    return;
+  }
+  const outcomes = await executeCleanupCandidates(selected, { dryRun: false });
+  let failed = 0;
+  for (const outcome of outcomes) {
+    const label = outcome.candidate.kind === "orphan_worktree" ? outcome.candidate.worktreePath : `${outcome.candidate.projectName} agent ${outcome.candidate.agentId}`;
+    if (outcome.ok) {
+      success(`Cleaned ${label}`);
+    } else {
+      failed++;
+      error(`${label}: ${outcome.error ?? "failed"}`);
+    }
+  }
+  return finishCommand(failed > 0 ? 1 : 0);
+}
 async function handleRunsList(argv) {
-  const repoPath = path54.resolve(argv.repo);
+  const repoPath = path55.resolve(argv.repo);
   const runs = listRuns(repoPath, { stageId: argv.stage, limit: argv.limit });
   if (argv.json) {
     process.stdout.write(JSON.stringify({ runs }, null, 2) + "\n");
@@ -72823,7 +73291,7 @@ async function handleRunsList(argv) {
   }
 }
 async function handleRunsGet(argv) {
-  const run2 = getRun(path54.resolve(argv.repo), argv.runId);
+  const run2 = getRun(path55.resolve(argv.repo), argv.runId);
   if (!run2) {
     error(`Run not found: ${argv.runId}`);
     return finishCommand(1);
@@ -72905,27 +73373,27 @@ function printNextSteps() {
 }
 
 // src/cli/commands/control.ts
-var path58 = __toESM(require("path"));
+var path59 = __toESM(require("path"));
 init_control_config();
 init_control_port();
 init_control_sync();
 
 // src/core/control-sync-selection.ts
-var fs47 = __toESM(require("fs"));
-var os19 = __toESM(require("os"));
-var path55 = __toESM(require("path"));
+var fs48 = __toESM(require("fs"));
+var os20 = __toESM(require("os"));
+var path56 = __toESM(require("path"));
 init_control_repo_path();
 function getSelectionPath() {
   if (process.env.HAR_CONTROL_SYNC_SELECTION_PATH) {
-    return path55.resolve(process.env.HAR_CONTROL_SYNC_SELECTION_PATH);
+    return path56.resolve(process.env.HAR_CONTROL_SYNC_SELECTION_PATH);
   }
-  return path55.join(os19.homedir(), ".har", "sync-selection.json");
+  return path56.join(os20.homedir(), ".har", "sync-selection.json");
 }
 function readSyncSelection() {
   const selectionPath = getSelectionPath();
   try {
-    if (!fs47.existsSync(selectionPath)) return null;
-    const parsed = JSON.parse(fs47.readFileSync(selectionPath, "utf8"));
+    if (!fs48.existsSync(selectionPath)) return null;
+    const parsed = JSON.parse(fs48.readFileSync(selectionPath, "utf8"));
     if (!Array.isArray(parsed.repos)) return null;
     return parsed.repos.map((repoPath) => canonicalizeControlRepoPath(repoPath));
   } catch {
@@ -72935,8 +73403,8 @@ function readSyncSelection() {
 function writeSyncSelection(repos) {
   const selectionPath = getSelectionPath();
   const canonical = Array.from(new Set(repos.map((repoPath) => canonicalizeControlRepoPath(repoPath))));
-  fs47.mkdirSync(path55.dirname(selectionPath), { recursive: true });
-  fs47.writeFileSync(selectionPath, JSON.stringify({ repos: canonical }, null, 2) + "\n");
+  fs48.mkdirSync(path56.dirname(selectionPath), { recursive: true });
+  fs48.writeFileSync(selectionPath, JSON.stringify({ repos: canonical }, null, 2) + "\n");
 }
 function resolveSyncSelection(input) {
   const { discovered, stored, forceSelect, isTTY } = input;
@@ -72968,13 +73436,13 @@ init_portal_credentials();
 // src/core/portal-login.ts
 var http = __toESM(require("http"));
 var import_crypto = require("crypto");
-var import_child_process14 = require("child_process");
+var import_child_process15 = require("child_process");
 var CALLBACK_PATH = "/callback";
 var LOGIN_TIMEOUT_MS = 3 * 6e4;
 function openBrowser(url) {
   const [cmd, args] = process.platform === "darwin" ? ["open", [url]] : process.platform === "win32" ? ["cmd", ["/c", "start", "", url]] : ["xdg-open", [url]];
   try {
-    const child = (0, import_child_process14.spawn)(cmd, args, { stdio: "ignore", detached: true });
+    const child = (0, import_child_process15.spawn)(cmd, args, { stdio: "ignore", detached: true });
     child.on("error", () => {
     });
     child.unref();
@@ -72983,7 +73451,7 @@ function openBrowser(url) {
 }
 async function loginViaBrowser(portalUrl, openUrl = openBrowser) {
   const state = (0, import_crypto.randomUUID)();
-  return new Promise((resolve49, reject) => {
+  return new Promise((resolve50, reject) => {
     let timer;
     const server = http.createServer((req, res) => {
       const requestUrl = new URL(req.url ?? "", "http://127.0.0.1");
@@ -73008,7 +73476,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();
-      resolve49({
+      resolve50({
         portalUrl,
         token,
         workspace,
@@ -73043,8 +73511,8 @@ If your browser did not open, paste that URL.
 }
 
 // src/core/control-unregister.ts
-var fs48 = __toESM(require("fs"));
-var path56 = __toESM(require("path"));
+var fs49 = __toESM(require("fs"));
+var path57 = __toESM(require("path"));
 init_control_repo_path();
 init_control_registry();
 init_control_config();
@@ -73054,9 +73522,9 @@ function listUnregisterWorktreeCandidates(repoPath) {
   const harnessRoot = canonicalizeControlRepoPath(repoPath);
   const byPath = /* @__PURE__ */ new Map();
   const add = (partial2) => {
-    const resolved = path56.resolve(partial2.worktreePath);
+    const resolved = path57.resolve(partial2.worktreePath);
     if (!resolved || resolved === harnessRoot) return;
-    const exists = partial2.exists ?? fs48.existsSync(resolved);
+    const exists = partial2.exists ?? fs49.existsSync(resolved);
     const prev = byPath.get(resolved);
     if (prev) {
       byPath.set(resolved, {
@@ -73103,12 +73571,12 @@ function listUnregisterWorktreeCandidates(repoPath) {
   }
   return [...byPath.values()].sort((a, b2) => a.agentId - b2.agentId);
 }
-async function askYesNo5(question) {
+async function askYesNo6(question) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
   const readline8 = await import("readline");
   const rl = readline8.createInterface({ input: process.stdin, output: process.stderr });
-  const answer = await new Promise((resolve49) => {
-    rl.question(question, resolve49);
+  const answer = await new Promise((resolve50) => {
+    rl.question(question, resolve50);
   });
   rl.close();
   return /^[Yy]$/.test(answer.trim());
@@ -73120,7 +73588,7 @@ async function confirmUnregister(options) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
     throw new Error("Non-interactive terminal \u2014 pass --yes (and optionally --delete-worktrees)");
   }
-  const proceed = await askYesNo5("Unregister this repository from Mission Control? [y/N] ");
+  const proceed = await askYesNo6("Unregister this repository from Mission Control? [y/N] ");
   if (!proceed) return { proceed: false, deleteWorktrees: false };
   const existing = options.worktrees.filter((w2) => w2.exists);
   if (existing.length === 0) {
@@ -73132,7 +73600,7 @@ async function confirmUnregister(options) {
     process.stderr.write(`  agent-${wt.agentId}: ${wt.worktreePath}${dirty}
 `);
   }
-  const deleteWorktrees = await askYesNo5(
+  const deleteWorktrees = await askYesNo6(
     `Also delete ${existing.length} session worktree(s) on disk? [y/N] `
   );
   return { proceed: true, deleteWorktrees };
@@ -73170,28 +73638,28 @@ async function teardownWorktrees(repoPath, candidates, dryRun) {
         trigger: "cli"
       });
       if (result.code !== 0) {
-        if (fs48.existsSync(candidate.worktreePath)) {
-          fs48.rmSync(candidate.worktreePath, { recursive: true, force: true });
+        if (fs49.existsSync(candidate.worktreePath)) {
+          fs49.rmSync(candidate.worktreePath, { recursive: true, force: true });
         }
       }
       outcomes.push({
         path: candidate.worktreePath,
         agentId: candidate.agentId,
-        deleted: !fs48.existsSync(candidate.worktreePath),
-        error: result.code !== 0 && fs48.existsSync(candidate.worktreePath) ? result.stderr : void 0
+        deleted: !fs49.existsSync(candidate.worktreePath),
+        error: result.code !== 0 && fs49.existsSync(candidate.worktreePath) ? result.stderr : void 0
       });
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       try {
-        if (fs48.existsSync(candidate.worktreePath)) {
-          fs48.rmSync(candidate.worktreePath, { recursive: true, force: true });
+        if (fs49.existsSync(candidate.worktreePath)) {
+          fs49.rmSync(candidate.worktreePath, { recursive: true, force: true });
         }
       } catch {
       }
       outcomes.push({
         path: candidate.worktreePath,
         agentId: candidate.agentId,
-        deleted: !fs48.existsSync(candidate.worktreePath),
+        deleted: !fs49.existsSync(candidate.worktreePath),
         error: message
       });
     }
@@ -73254,16 +73722,16 @@ init_control_config();
 init_control_registry();
 
 // src/core/harness-scrub.ts
-var fs49 = __toESM(require("fs"));
-var path57 = __toESM(require("path"));
+var fs50 = __toESM(require("fs"));
+var path58 = __toESM(require("path"));
 var HARNESS_SCRUB_DIRS = ["runs", "validations", "state", "slots"];
 function scrubLocalHarnessDirs(repoPath) {
   const results = [];
-  const resolved = path57.resolve(repoPath);
-  if (!fs49.existsSync(resolved)) {
+  const resolved = path58.resolve(repoPath);
+  if (!fs50.existsSync(resolved)) {
     for (const directory of HARNESS_SCRUB_DIRS) {
       results.push({
-        path: path57.join(resolved, ".har", directory),
+        path: path58.join(resolved, ".har", directory),
         directory,
         deleted: false,
         error: "repository path does not exist"
@@ -73272,24 +73740,24 @@ function scrubLocalHarnessDirs(repoPath) {
     return results;
   }
   for (const directory of HARNESS_SCRUB_DIRS) {
-    const target = path57.join(resolved, ".har", directory);
-    if (!fs49.existsSync(target)) {
+    const target = path58.join(resolved, ".har", directory);
+    if (!fs50.existsSync(target)) {
       results.push({ path: target, directory, deleted: true });
       continue;
     }
     try {
-      fs49.rmSync(target, { recursive: true, force: true });
+      fs50.rmSync(target, { recursive: true, force: true });
       results.push({
         path: target,
         directory,
-        deleted: !fs49.existsSync(target),
-        error: fs49.existsSync(target) ? "failed to remove directory" : void 0
+        deleted: !fs50.existsSync(target),
+        error: fs50.existsSync(target) ? "failed to remove directory" : void 0
       });
     } catch (err) {
       results.push({
         path: target,
         directory,
-        deleted: !fs49.existsSync(target),
+        deleted: !fs50.existsSync(target),
         error: err instanceof Error ? err.message : String(err)
       });
     }
@@ -73300,7 +73768,7 @@ function scrubLocalHarnessForRepos(repoPaths) {
   const results = [];
   const seen = /* @__PURE__ */ new Set();
   for (const repoPath of repoPaths) {
-    const key = path57.resolve(repoPath);
+    const key = path58.resolve(repoPath);
     if (seen.has(key)) continue;
     seen.add(key);
     results.push(...scrubLocalHarnessDirs(key));
@@ -73309,12 +73777,12 @@ function scrubLocalHarnessForRepos(repoPaths) {
 }
 
 // src/core/control-reset.ts
-async function askYesNo6(question) {
+async function askYesNo7(question) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
   const readline8 = await import("readline");
   const rl = readline8.createInterface({ input: process.stdin, output: process.stderr });
-  const answer = await new Promise((resolve49) => {
-    rl.question(question, resolve49);
+  const answer = await new Promise((resolve50) => {
+    rl.question(question, resolve50);
   });
   rl.close();
   return /^[Yy]$/.test(answer.trim());
@@ -73324,7 +73792,7 @@ async function confirmControlReset(options) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
     throw new Error("Non-interactive terminal \u2014 pass --yes");
   }
-  return askYesNo6(
+  return askYesNo7(
     `Clear Mission Control data for ${options.repoCount} registered repositor${options.repoCount === 1 ? "y" : "ies"} (and scrub local .har history)? [y/N] `
   );
 }
@@ -73559,7 +74027,7 @@ async function handleDown() {
   return finishCommand(code);
 }
 async function handleRegister(argv) {
-  const repoPath = path58.resolve(argv.repo);
+  const repoPath = path59.resolve(argv.repo);
   header("har control register");
   info(`Repository: ${repoPath}`);
   try {
@@ -73651,7 +74119,7 @@ async function handleReset(argv) {
   }
 }
 async function handleUnregister(argv) {
-  const repoPath = path58.resolve(argv.repo);
+  const repoPath = path59.resolve(argv.repo);
   const worktrees = listUnregisterWorktreeCandidates(repoPath);
   try {
     let deleteWorktrees = argv.deleteWorktrees;
@@ -73833,12 +74301,12 @@ async function handleLogin(argv) {
 }
 
 // src/cli/commands/hooks.ts
-var path60 = __toESM(require("path"));
+var path61 = __toESM(require("path"));
 init_hooks();
 
 // src/core/claude-hooks.ts
-var fs50 = __toESM(require("fs"));
-var path59 = __toESM(require("path"));
+var fs51 = __toESM(require("fs"));
+var path60 = __toESM(require("path"));
 var CLAUDE_GUARD_RELATIVE_PATH = ".har/hooks/claude-worktree-guard.sh";
 var CLAUDE_SETTINGS_RELATIVE_PATH = ".claude/settings.json";
 var GUARD_MATCHER = "Edit|Write|MultiEdit|NotebookEdit";
@@ -73849,8 +74317,8 @@ function isHarGuardEntry(entry) {
   );
 }
 function readSettings(settingsPath) {
-  if (!fs50.existsSync(settingsPath)) return {};
-  const raw = fs50.readFileSync(settingsPath, "utf8").trim();
+  if (!fs51.existsSync(settingsPath)) return {};
+  const raw = fs51.readFileSync(settingsPath, "utf8").trim();
   if (raw === "") return {};
   const parsed = JSON.parse(raw);
   if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
@@ -73859,19 +74327,19 @@ function readSettings(settingsPath) {
   return parsed;
 }
 function writeSettings(settingsPath, settings) {
-  fs50.mkdirSync(path59.dirname(settingsPath), { recursive: true });
-  fs50.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+  fs51.mkdirSync(path60.dirname(settingsPath), { recursive: true });
+  fs51.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
 }
 function installClaudeGuard(repoPath) {
   const templatePath = resolveTemplateFile("claude-worktree-guard.sh.template");
   if (!templatePath) {
     throw new Error("Guard template not found (claude-worktree-guard.sh.template). Run npm run build.");
   }
-  const guardScript = path59.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
-  fs50.mkdirSync(path59.dirname(guardScript), { recursive: true });
-  fs50.copyFileSync(templatePath, guardScript);
-  fs50.chmodSync(guardScript, 493);
-  const settingsPath = path59.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  const guardScript = path60.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  fs51.mkdirSync(path60.dirname(guardScript), { recursive: true });
+  fs51.copyFileSync(templatePath, guardScript);
+  fs51.chmodSync(guardScript, 493);
+  const settingsPath = path60.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
   const settings = readSettings(settingsPath);
   const hooks = settings.hooks ?? {};
   const preToolUse = (hooks.PreToolUse ?? []).filter((entry) => !isHarGuardEntry(entry));
@@ -73885,15 +74353,15 @@ function installClaudeGuard(repoPath) {
 }
 function uninstallClaudeGuard(repoPath) {
   let removed = false;
-  const guardScript = path59.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
-  if (fs50.existsSync(guardScript)) {
-    fs50.rmSync(guardScript);
+  const guardScript = path60.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  if (fs51.existsSync(guardScript)) {
+    fs51.rmSync(guardScript);
     removed = true;
-    const parent = path59.dirname(guardScript);
-    if (fs50.existsSync(parent) && fs50.readdirSync(parent).length === 0) fs50.rmdirSync(parent);
+    const parent = path60.dirname(guardScript);
+    if (fs51.existsSync(parent) && fs51.readdirSync(parent).length === 0) fs51.rmdirSync(parent);
   }
-  const settingsPath = path59.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
-  if (fs50.existsSync(settingsPath)) {
+  const settingsPath = path60.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (fs51.existsSync(settingsPath)) {
     const settings = readSettings(settingsPath);
     const preToolUse = settings.hooks?.PreToolUse;
     if (preToolUse) {
@@ -73918,8 +74386,8 @@ function uninstallClaudeGuard(repoPath) {
   return { removed };
 }
 function claudeGuardInstalled(repoPath) {
-  const settingsPath = path59.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
-  if (!fs50.existsSync(settingsPath)) return false;
+  const settingsPath = path60.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (!fs51.existsSync(settingsPath)) return false;
   try {
     const settings = readSettings(settingsPath);
     return (settings.hooks?.PreToolUse ?? []).some(isHarGuardEntry);
@@ -73936,7 +74404,7 @@ function repoOption(y) {
 function handleInstall2(argv) {
   try {
     if (argv.claude) {
-      const result2 = installClaudeGuard(path60.resolve(argv.repo));
+      const result2 = installClaudeGuard(path61.resolve(argv.repo));
       success("Claude Code worktree guard installed.");
       info(`Guard script:  ${result2.guardScript}`);
       info(`Settings:      ${result2.settingsPath} (PreToolUse: Edit|Write|MultiEdit|NotebookEdit)`);
@@ -73944,7 +74412,7 @@ function handleInstall2(argv) {
       info("Commit both files so the guard travels with the repo.");
       return;
     }
-    const result = installHooks({ repoPath: path60.resolve(argv.repo), force: argv.force });
+    const result = installHooks({ repoPath: path61.resolve(argv.repo), force: argv.force });
     success(`Commit gate installed in ${result.hooksDir}`);
     info(`pre-commit: ${result.preCommit}, post-commit: ${result.postCommit}`);
     info("Commits of unverified change batches will be blocked in agent worktrees.");
@@ -73957,7 +74425,7 @@ function handleInstall2(argv) {
 function handleUninstall(argv) {
   try {
     if (argv.claude) {
-      const result2 = uninstallClaudeGuard(path60.resolve(argv.repo));
+      const result2 = uninstallClaudeGuard(path61.resolve(argv.repo));
       if (result2.removed) {
         success("Claude Code worktree guard removed.");
       } else {
@@ -73965,7 +74433,7 @@ function handleUninstall(argv) {
       }
       return;
     }
-    const result = uninstallHooks(path60.resolve(argv.repo));
+    const result = uninstallHooks(path61.resolve(argv.repo));
     if (result.removed) {
       success(`Commit gate removed from ${result.hooksDir}`);
     } else {
@@ -73978,7 +74446,7 @@ function handleUninstall(argv) {
 }
 function handleStatus2(argv) {
   try {
-    const status = getHooksStatus(path60.resolve(argv.repo));
+    const status = getHooksStatus(path61.resolve(argv.repo));
     if (argv.json) {
       process.stdout.write(`${JSON.stringify(status, null, 2)}
 `);
@@ -73996,7 +74464,7 @@ function handleStatus2(argv) {
     );
     info(`Effective:     ${status.effectiveMode} (in this checkout)`);
     info(
-      `Claude guard:  ${claudeGuardInstalled(path60.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
+      `Claude guard:  ${claudeGuardInstalled(path61.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
     );
   } catch (err) {
     error(err instanceof Error ? err.message : String(err));
@@ -74257,10 +74725,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path65) {
-  if (!path65)
+function getElementAtPath(obj, path66) {
+  if (!path66)
     return obj;
-  return path65.reduce((acc, key) => acc?.[key], obj);
+  return path66.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -74580,11 +75048,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path65, issues) {
+function prefixIssues(path66, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path65);
+    iss.path.unshift(path66);
     return iss;
   });
 }
@@ -79907,7 +80375,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve49) => setTimeout(resolve49, pollInterval));
+        await new Promise((resolve50) => setTimeout(resolve50, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error3) {
@@ -79924,7 +80392,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve49, reject) => {
+    return new Promise((resolve50, reject) => {
       const earlyReject = (error3) => {
         reject(error3);
       };
@@ -80002,7 +80470,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve49(parseResult.data);
+            resolve50(parseResult.data);
           }
         } catch (error3) {
           reject(error3);
@@ -80263,12 +80731,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve49, reject) => {
+    return new Promise((resolve50, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve49, interval);
+      const timeoutId = setTimeout(resolve50, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -81058,7 +81526,7 @@ var Server = class extends Protocol {
 };
 
 // src/mcp/server.ts
-var path61 = __toESM(require("path"));
+var path62 = __toESM(require("path"));
 
 // node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 var import_node_process3 = __toESM(require("node:process"), 1);
@@ -81141,12 +81609,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve49) => {
+    return new Promise((resolve50) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve49();
+        resolve50();
       } else {
-        this._stdout.once("drain", resolve49);
+        this._stdout.once("drain", resolve50);
       }
     });
   }
@@ -81155,6 +81623,8 @@ var StdioServerTransport = class {
 // src/mcp/server.ts
 init_telemetry_config();
 init_runs();
+init_work_units();
+init_manifest();
 
 // src/mcp/schema-tools.ts
 init_schema2();
@@ -81239,7 +81709,21 @@ var LaunchEnvironmentInputSchema = external_exports.object({
   source: external_exports.string().min(1).max(64).optional(),
   sourceUrl: external_exports.string().url().optional(),
   title: external_exports.string().min(1).max(256).optional(),
-  parentWorkUnitId: external_exports.string().min(1).max(128).optional()
+  parentWorkUnitId: external_exports.string().min(1).max(128).optional(),
+  relatedLinks: external_exports.array(
+    external_exports.object({
+      source: external_exports.string().min(1).max(64),
+      url: external_exports.string().url(),
+      label: external_exports.string().min(1).max(128).optional()
+    })
+  ).optional()
+});
+var AddWorkUnitLinkInputSchema = external_exports.object({
+  repo: external_exports.string().default("."),
+  workUnitId: external_exports.string().min(1).max(128),
+  source: external_exports.string().min(1).max(64),
+  url: external_exports.string().url(),
+  label: external_exports.string().min(1).max(128).optional()
 });
 var LaunchEnvironmentOutputSchema = ShellRunOutputSchema.extend({
   previewUrls: external_exports.record(external_exports.string()).optional(),
@@ -81386,11 +81870,41 @@ var HAR_MCP_TOOLS = [
         parentWorkUnitId: {
           type: "string",
           description: "Optional parent work unit identifier."
+        },
+        relatedLinks: {
+          type: "array",
+          description: "Additional tracker links (append-only). Each item: source, url, optional label.",
+          items: {
+            type: "object",
+            properties: {
+              source: { type: "string" },
+              url: { type: "string" },
+              label: { type: "string" }
+            },
+            required: ["source", "url"]
+          }
         }
       },
       ["agentId"]
     )
   },
+  {
+    name: "har_add_work_unit_link",
+    description: "Append a related external link (PR, mirrored issue, alternate tracker) to an existing work unit.",
+    inputSchema: objectJsonSchema(
+      {
+        repo: repoJsonProperty,
+        workUnitId: {
+          type: "string",
+          description: "Repo-scoped work unit id bound at launch."
+        },
+        source: { type: "string", description: "Tracker provider (e.g. github, jira)." },
+        url: { type: "string", description: "Canonical URL for the link." },
+        label: { type: "string", description: "Optional display label." }
+      },
+      ["workUnitId", "source", "url"]
+    )
+  },
   {
     name: "har_recover_environment",
     description: "Resume a failed or partial agent launch without replacing the worktree. Alias for har_launch_environment with resume=true.",
@@ -81561,6 +82075,7 @@ async function handleMcpToolCall(toolName, args, defaultRepo = ".") {
         sourceUrl: input.sourceUrl,
         title: input.title,
         parentWorkUnitId: input.parentWorkUnitId,
+        relatedLinks: input.relatedLinks,
         capture: true
       });
       const parsed = LaunchEnvironmentOutputSchema.parse(result);
@@ -81583,6 +82098,7 @@ async function handleMcpToolCall(toolName, args, defaultRepo = ".") {
         sourceUrl: input.sourceUrl,
         title: input.title,
         parentWorkUnitId: input.parentWorkUnitId,
+        relatedLinks: input.relatedLinks,
         capture: true
       });
       const parsed = LaunchEnvironmentOutputSchema.parse(result);
@@ -81591,6 +82107,28 @@ async function handleMcpToolCall(toolName, args, defaultRepo = ".") {
         ...result.blocked ? { isError: true } : {}
       };
     }
+    case "har_add_work_unit_link": {
+      const input = AddWorkUnitLinkInputSchema.parse({ ...args, repo });
+      const harnessRoot = resolveHarnessRoot(repo);
+      try {
+        const record2 = addWorkUnitLinks(harnessRoot, input.workUnitId, [
+          { source: input.source, url: input.url, label: input.label }
+        ]);
+        return jsonContent({
+          ok: true,
+          workUnitId: record2.workUnitId,
+          relatedLinks: record2.relatedLinks
+        });
+      } catch (err) {
+        return {
+          ...jsonContent({
+            ok: false,
+            error: err instanceof Error ? err.message : String(err)
+          }),
+          isError: true
+        };
+      }
+    }
     case "har_preflight_environment": {
       const input = PreflightEnvironmentInputSchema.parse({ ...args, repo });
       const agentId = validateAgentId(input.agentId, repo);
@@ -81701,7 +82239,7 @@ async function handleMcpToolCall(toolName, args, defaultRepo = ".") {
       const input = ControlUpInputSchema.parse({ ...args, repo });
       const result = await startControlAndSync({
         detach: input.detach,
-        cwd: path61.resolve(input.repo)
+        cwd: path62.resolve(input.repo)
       });
       if (result.code !== 0) {
         return {
@@ -81765,11 +82303,11 @@ var mcpCommand = {
 };
 
 // src/cli/commands/onboard.ts
-var path63 = __toESM(require("path"));
+var path64 = __toESM(require("path"));
 init_stages();
 
 // src/core/onboarding.ts
-var path62 = __toESM(require("path"));
+var path63 = __toESM(require("path"));
 init_control_config();
 init_control_sync();
 init_otel_hooks();
@@ -81905,7 +82443,7 @@ async function defaultEnsureControl(options) {
   return { started: true, apiUrl: result.apiUrl };
 }
 async function runOnboarding(options, deps = {}) {
-  const repoPath = path62.resolve(options.repoPath);
+  const repoPath = path63.resolve(options.repoPath);
   const applyTelemetry = deps.applyTelemetry ?? applyOnboardingTelemetry;
   const ensureControl = deps.ensureControl ?? defaultEnsureControl;
   const init = deps.initHarness ?? initHarness;
@@ -82093,7 +82631,7 @@ async function promptChoices(args) {
     };
   }
   const pluginChoices = listPluginChoices();
-  const repoPath = path63.resolve(args.repo);
+  const repoPath = path64.resolve(args.repo);
   const alreadyPresent = harnessExists(repoPath);
   const needProfile = !alreadyPresent && !args.skipInit && args.profile === void 0;
   const needAgentSlots = shouldConfigureSlots && flaggedSlots === void 0;
@@ -82210,7 +82748,7 @@ function printSummary(result) {
   console.error("");
 }
 async function handleOnboard(argv) {
-  const repoPath = path63.resolve(argv.repo);
+  const repoPath = path64.resolve(argv.repo);
   header("har onboard");
   info(`Repository: ${repoPath}`);
   try {
@@ -82441,7 +82979,7 @@ var preferencesCommand = {
 };
 
 // src/cli/commands/telemetry.ts
-var path64 = __toESM(require("path"));
+var path65 = __toESM(require("path"));
 init_control_config();
 init_control_sync();
 init_manifest();
@@ -82534,7 +83072,7 @@ async function handleOff() {
   info("Mission Control will not auto-start. Existing usage rows are kept.");
 }
 async function handleWriteEnv(argv) {
-  const repoPath = path64.resolve(argv.repo);
+  const repoPath = path65.resolve(argv.repo);
   const harnessRoot = resolveHarnessRoot(repoPath);
   const session = readSlotRegistry(harnessRoot, argv.agentId);
   const workDir = argv.workDir ?? session?.workDir ?? repoPath;
@@ -82546,7 +83084,7 @@ async function handleWriteEnv(argv) {
     suffix,
     createdAt: session?.createdAt
   });
-  const envFile = argv.envFile ?? path64.join(workDir, `.env.agent.${argv.agentId}`);
+  const envFile = argv.envFile ?? path65.join(workDir, `.env.agent.${argv.agentId}`);
   const attrs = {
     sessionKey,
     agentId: argv.agentId,
@@ -82562,7 +83100,7 @@ async function handleWriteEnv(argv) {
   success(`Wrote session attribution to ${envFile}`);
 }
 function handlePrintEnv(argv) {
-  const repoPath = path64.resolve(argv.repo);
+  const repoPath = path65.resolve(argv.repo);
   const workDir = argv.workDir ?? repoPath;
   const sessionKey = buildSessionKey({
     branch: argv.branch,