@osfactory/har 0.22.0 → 0.24.0

package/README.md

@@ -69,7 +69,7 @@ cd MyApp && har env init --profile ios
 har env add-stage rocketsim   # optional: UI flow validation on the simulator
 ```
 
-After init, paste the printed adaptation prompt into your coding agent to tailor scripts to your stack. For built-in Claude adaptation: `har env init --auto` (requires `ANTHROPIC_API_KEY`).
+After init, paste the adaptation prompt into your coding agent (interactive terminals offer a clipboard copy; also saved to `.har/ADAPT-PROMPT.md`) to tailor scripts to your stack. For built-in Claude adaptation: `har env init --auto` (requires `ANTHROPIC_API_KEY`).
 
 Optional stage templates depend on the profile: `har env add-stage playwright` for browser E2E on web apps, `har env add-stage rocketsim` for simulator user-flow checks on iOS.
 

package/dist/index.js

@@ -6449,6 +6449,7 @@ function readPortalCredentials() {
       portalUrl: parsed.portalUrl,
       token: parsed.token,
       workspace: parsed.workspace,
+      email: parsed.email,
       createdAt: parsed.createdAt ?? ""
     };
   } catch {
@@ -6677,22 +6678,22 @@ exec "${otelHookCommand}" "$@"
   }
   return wrapperPath;
 }
-function commandExists(command2) {
-  const result = (0, import_child_process9.spawnSync)("sh", ["-c", `command -v ${JSON.stringify(command2)}`], {
+function commandExists2(command2) {
+  const result = (0, import_child_process10.spawnSync)("sh", ["-c", `command -v ${JSON.stringify(command2)}`], {
     encoding: "utf8"
   });
   return result.status === 0 && Boolean(result.stdout?.trim());
 }
 function resolveOtelHookCommand() {
-  if (commandExists("otel-hook")) {
-    const which = (0, import_child_process9.spawnSync)("sh", ["-c", "command -v otel-hook"], { encoding: "utf8" });
+  if (commandExists2("otel-hook")) {
+    const which = (0, import_child_process10.spawnSync)("sh", ["-c", "command -v otel-hook"], { encoding: "utf8" });
     return which.stdout?.trim() || "otel-hook";
   }
   return null;
 }
 function tryInstallPackage() {
-  if (commandExists("uv")) {
-    const result = (0, import_child_process9.spawnSync)(
+  if (commandExists2("uv")) {
+    const result = (0, import_child_process10.spawnSync)(
       "uv",
       ["tool", "install", "--force", OTEL_HOOKS_PACKAGE],
       { encoding: "utf8", timeout: 18e4 }
@@ -6701,8 +6702,8 @@ function tryInstallPackage() {
       return { ok: true, detail: `uv tool install ${OTEL_HOOKS_PACKAGE}` };
     }
   }
-  if (commandExists("pipx")) {
-    const result = (0, import_child_process9.spawnSync)("pipx", ["install", "--force", OTEL_HOOKS_PACKAGE], {
+  if (commandExists2("pipx")) {
+    const result = (0, import_child_process10.spawnSync)("pipx", ["install", "--force", OTEL_HOOKS_PACKAGE], {
       encoding: "utf8",
       timeout: 18e4
     });
@@ -6714,9 +6715,9 @@ function tryInstallPackage() {
       detail: `pipx install failed: ${(result.stderr || result.stdout || "").trim().slice(0, 400)}`
     };
   }
-  if (commandExists("pip3") || commandExists("pip")) {
-    const pip = commandExists("pip3") ? "pip3" : "pip";
-    const result = (0, import_child_process9.spawnSync)(
+  if (commandExists2("pip3") || commandExists2("pip")) {
+    const pip = commandExists2("pip3") ? "pip3" : "pip";
+    const result = (0, import_child_process10.spawnSync)(
       pip,
       ["install", "--user", OTEL_HOOKS_PACKAGE],
       { encoding: "utf8", timeout: 18e4 }
@@ -6735,7 +6736,7 @@ function tryInstallPackage() {
   };
 }
 function runSetupAgent(agent, otelHookCommand, hooksHome) {
-  const result = (0, import_child_process9.spawnSync)(otelHookCommand, ["setup", "--agent", agent], {
+  const result = (0, import_child_process10.spawnSync)(otelHookCommand, ["setup", "--agent", agent], {
     encoding: "utf8",
     env: {
       ...process.env,
@@ -6885,11 +6886,11 @@ function ensureOtelHooks(options) {
 function disableOtelHooksExport() {
   return writeOtelHooksConfig(buildOtelHooksConfig({ enabled: false }));
 }
-var import_child_process9, fs41, os13, path43, OTEL_HOOKS_PACKAGE, OTEL_HOOKS_AGENTS;
+var import_child_process10, fs41, os13, path43, OTEL_HOOKS_PACKAGE, OTEL_HOOKS_AGENTS;
 var init_otel_hooks = __esm({
   "src/core/otel-hooks.ts"() {
     "use strict";
-    import_child_process9 = require("child_process");
+    import_child_process10 = require("child_process");
     fs41 = __toESM(require("fs"));
     os13 = __toESM(require("os"));
     path43 = __toESM(require("path"));
@@ -49738,6 +49739,81 @@ function addCustomStage(repoPath, options) {
 // src/harness/adaptation-prompt.ts
 var fs22 = __toESM(require("fs"));
 var path21 = __toESM(require("path"));
+var readline4 = __toESM(require("readline"));
+
+// src/utils/clipboard.ts
+var import_child_process2 = require("child_process");
+function commandExists(command2) {
+  const probe = process.platform === "win32" ? (0, import_child_process2.spawnSync)("where", [command2], { encoding: "utf8", stdio: ["ignore", "ignore", "ignore"] }) : (0, import_child_process2.spawnSync)("which", [command2], { encoding: "utf8", stdio: ["ignore", "ignore", "ignore"] });
+  return probe.status === 0;
+}
+function tryPipeCommand(command2, args, text) {
+  const result = (0, import_child_process2.spawnSync)(command2, args, {
+    input: text,
+    encoding: "utf8",
+    stdio: ["pipe", "ignore", "ignore"]
+  });
+  return result.status === 0 && !result.error;
+}
+function writeOsc52Clipboard(text, stream = process.stderr) {
+  if (!("isTTY" in stream) || !stream.isTTY) return false;
+  if (Buffer.byteLength(text, "utf8") > 2e5) return false;
+  const b64 = Buffer.from(text, "utf8").toString("base64");
+  stream.write(`\x1B]52;c;${b64}\x07`);
+  return true;
+}
+function copyViaPlatformTools(text) {
+  if (process.platform === "darwin" && commandExists("pbcopy")) {
+    if (tryPipeCommand("pbcopy", [], text)) return { ok: true, method: "pbcopy" };
+  }
+  if (process.platform === "win32") {
+    if (commandExists("powershell")) {
+      const result = (0, import_child_process2.spawnSync)(
+        "powershell",
+        [
+          "-NoProfile",
+          "-NonInteractive",
+          "-Command",
+          "$OutputEncoding = [Console]::InputEncoding = [Console]::OutputEncoding = [Text.UTF8Encoding]::new(); Set-Clipboard -Value ([Console]::In.ReadToEnd())"
+        ],
+        {
+          input: text,
+          encoding: "utf8",
+          stdio: ["pipe", "ignore", "ignore"]
+        }
+      );
+      if (result.status === 0 && !result.error) return { ok: true, method: "powershell" };
+    }
+    if (commandExists("clip") && tryPipeCommand("clip", [], text)) {
+      return { ok: true, method: "clip" };
+    }
+  }
+  if (process.platform === "linux" || process.platform === "freebsd" || process.platform === "openbsd") {
+    if (commandExists("wl-copy") && tryPipeCommand("wl-copy", [], text)) {
+      return { ok: true, method: "wl-copy" };
+    }
+    if (commandExists("xclip") && tryPipeCommand("xclip", ["-selection", "clipboard"], text)) {
+      return { ok: true, method: "xclip" };
+    }
+    if (commandExists("xsel") && tryPipeCommand("xsel", ["--clipboard", "--input"], text)) {
+      return { ok: true, method: "xsel" };
+    }
+  }
+  return {
+    ok: false,
+    detail: "No system clipboard command available (pbcopy, wl-copy/xclip/xsel, or clip)"
+  };
+}
+function copyTextToClipboard(text) {
+  const platform = copyViaPlatformTools(text);
+  if (platform.ok) return platform;
+  if (writeOsc52Clipboard(text)) {
+    return { ok: true, method: "osc52" };
+  }
+  return platform;
+}
+
+// src/harness/adaptation-prompt.ts
 var ADAPTATION_PROMPT_FILE = "ADAPT-PROMPT.md";
 var PROFILE_HINTS = {
   default: "Web app profile (SaaS/full-stack) \u2014 Docker Compose for shared infra (HARNESS_INFRA_SERVICES), PM2 for the primary application only, git worktree per agent slot by default. Launch provisions toolchain via harness.env (HARNESS_ECOSYSTEM, HARNESS_INSTALL_CMD) and writes paths to .env.agent.<id>. Identify the primary app agents modify; run supporting services shared.",
@@ -49788,11 +49864,47 @@ function printAdaptationPrompt(content) {
 `);
   process.stderr.write("\n");
 }
+function askYesNo3(question) {
+  const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
+  return new Promise((resolve38) => {
+    process.stderr.write(`${question} `);
+    rl.once("line", (answer) => {
+      rl.close();
+      const trimmed = answer.trim();
+      resolve38(trimmed === "" || /^y(es)?$/i.test(trimmed));
+    });
+  });
+}
+async function offerAdaptationPromptClipboard(content, options = {}) {
+  const interactive = Boolean(process.stdin.isTTY && process.stderr.isTTY);
+  if (!interactive && !options.autoYes) {
+    info("Prompt also saved to .har/ADAPT-PROMPT.md (open or copy from there)");
+    return false;
+  }
+  let shouldCopy = options.autoYes === true;
+  if (!shouldCopy && interactive) {
+    shouldCopy = await askYesNo3("Copy adaptation prompt to clipboard for your coding agent? [Y/n]");
+  }
+  if (!shouldCopy) {
+    info("Skipped clipboard copy \u2014 prompt is in .har/ADAPT-PROMPT.md");
+    return false;
+  }
+  const result = copyTextToClipboard(content);
+  if (result.ok) {
+    success(
+      result.method === "osc52" ? "Copied adaptation prompt to clipboard (terminal OSC 52) \u2014 paste into your coding agent" : "Copied adaptation prompt to clipboard \u2014 paste into your coding agent"
+    );
+    return true;
+  }
+  warn(`Could not copy to clipboard: ${result.detail}`);
+  info("Open .har/ADAPT-PROMPT.md and paste that into your coding agent instead");
+  return false;
+}
 
 // src/harness/cursor-rule.ts
 var fs23 = __toESM(require("fs"));
 var path22 = __toESM(require("path"));
-var readline4 = __toESM(require("readline"));
+var readline5 = __toESM(require("readline"));
 var CURSOR_RULE_RELATIVE_PATH = ".cursor/rules/har-workflow.mdc";
 function getCursorRulePath(repoPath) {
   return path22.join(repoPath, CURSOR_RULE_RELATIVE_PATH);
@@ -49842,10 +49954,10 @@ async function handleCursorRule(options) {
 }
 async function promptScaffoldCursorRule(exists) {
   const action = exists ? "Update" : "Create";
-  return askYesNo3(`${action} ${CURSOR_RULE_RELATIVE_PATH}? [Y/n]`);
+  return askYesNo4(`${action} ${CURSOR_RULE_RELATIVE_PATH}? [Y/n]`);
 }
-async function askYesNo3(question) {
-  const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
+async function askYesNo4(question) {
+  const rl = readline5.createInterface({ input: process.stdin, output: process.stderr });
   return new Promise((resolve38) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
@@ -50283,22 +50395,25 @@ function listRegisteredRepos() {
   return kept;
 }
 
+// src/core/control-sync.ts
+init_portal_credentials();
+
 // src/core/slot-status.ts
 var fs33 = __toESM(require("fs"));
 var os8 = __toESM(require("os"));
 var path33 = __toESM(require("path"));
-var import_child_process7 = require("child_process");
+var import_child_process8 = require("child_process");
 
 // src/core/runs.ts
 var crypto2 = __toESM(require("crypto"));
-var import_child_process2 = require("child_process");
+var import_child_process3 = require("child_process");
 var fs29 = __toESM(require("fs"));
 var os6 = __toESM(require("os"));
 var path28 = __toESM(require("path"));
 var RUNS_DIR = "runs";
 function gitCommonDir(cwd) {
   try {
-    const out = (0, import_child_process2.execSync)("git rev-parse --git-common-dir", {
+    const out = (0, import_child_process3.execSync)("git rev-parse --git-common-dir", {
       cwd,
       encoding: "utf8",
       stdio: ["pipe", "pipe", "ignore"]
@@ -50315,7 +50430,7 @@ function sameGitCheckout(a2, b2) {
 }
 function gitPrefix(cwd) {
   try {
-    return (0, import_child_process2.execSync)("git rev-parse --show-prefix", {
+    return (0, import_child_process3.execSync)("git rev-parse --show-prefix", {
       cwd,
       encoding: "utf8",
       stdio: ["pipe", "pipe", "ignore"]
@@ -50484,13 +50599,13 @@ function listRuns(repoPath, filter2 = {}) {
 var path32 = __toESM(require("path"));
 
 // src/core/control-port.ts
-var import_child_process4 = require("child_process");
+var import_child_process5 = require("child_process");
 var fs31 = __toESM(require("fs"));
 var path30 = __toESM(require("path"));
 init_control_config();
 
 // src/core/slot-ports.ts
-var import_child_process3 = require("child_process");
+var import_child_process4 = require("child_process");
 var fs30 = __toESM(require("fs"));
 var path29 = __toESM(require("path"));
 function portStep(env3) {
@@ -50504,7 +50619,7 @@ function slotPortLaneEnd(defaultPort, step) {
 }
 function isPortInUse(port, host = "127.0.0.1") {
   try {
-    (0, import_child_process3.execSync)(`bash -c 'exec 3<>/dev/tcp/${host}/${port}'`, { stdio: "ignore" });
+    (0, import_child_process4.execSync)(`bash -c 'exec 3<>/dev/tcp/${host}/${port}'`, { stdio: "ignore" });
     return true;
   } catch {
     return false;
@@ -50575,7 +50690,7 @@ function controlContainerOnPort(containers, port) {
 }
 function listDockerContainers() {
   try {
-    const raw = (0, import_child_process4.execSync)("docker ps --format {{.Names}}\\t{{.Ports}}", {
+    const raw = (0, import_child_process5.execSync)("docker ps --format {{.Names}}\\t{{.Ports}}", {
       encoding: "utf8",
       stdio: ["pipe", "pipe", "ignore"],
       timeout: 3e3
@@ -50643,10 +50758,10 @@ function inspectControlUpReadiness(repoPath) {
 var fs32 = __toESM(require("fs"));
 var os7 = __toESM(require("os"));
 var path31 = __toESM(require("path"));
-var import_child_process5 = require("child_process");
+var import_child_process6 = require("child_process");
 function runGit(cwd, args) {
   try {
-    return (0, import_child_process5.execSync)(`git ${args}`, {
+    return (0, import_child_process6.execSync)(`git ${args}`, {
       cwd,
       encoding: "utf8",
       stdio: ["pipe", "pipe", "ignore"]
@@ -50812,10 +50927,10 @@ function checkLaunchGuard(repoPath, agentId, options = {}) {
 }
 
 // src/core/slot-preflight.ts
-var import_child_process6 = require("child_process");
+var import_child_process7 = require("child_process");
 function listPm2Processes() {
   try {
-    const raw = (0, import_child_process6.execSync)("npx --yes pm2 jlist", {
+    const raw = (0, import_child_process7.execSync)("npx --yes pm2 jlist", {
       encoding: "utf8",
       stdio: ["pipe", "pipe", "ignore"],
       timeout: 3e3
@@ -51039,7 +51154,7 @@ function formatPreflightReport(agentId, readiness) {
 var BYPASS_WARNING_MS = 15 * 60 * 1e3;
 function readGitRemote(repoPath) {
   try {
-    const remote = (0, import_child_process7.execSync)("git remote get-url origin", {
+    const remote = (0, import_child_process8.execSync)("git remote get-url origin", {
       cwd: repoPath,
       encoding: "utf8",
       stdio: ["pipe", "pipe", "ignore"]
@@ -51051,7 +51166,7 @@ function readGitRemote(repoPath) {
 }
 function runGit2(cwd, args) {
   try {
-    return (0, import_child_process7.execSync)(`git ${args}`, {
+    return (0, import_child_process8.execSync)(`git ${args}`, {
       cwd,
       encoding: "utf8",
       stdio: ["pipe", "pipe", "ignore"]
@@ -51127,7 +51242,7 @@ function lastBuildPass(run2) {
 }
 function listPm2Processes2() {
   try {
-    const raw = (0, import_child_process7.execSync)("npx --yes pm2 jlist", {
+    const raw = (0, import_child_process8.execSync)("npx --yes pm2 jlist", {
       encoding: "utf8",
       stdio: ["pipe", "pipe", "ignore"],
       timeout: 3e3
@@ -51722,6 +51837,7 @@ function extractClaudeUsageFromRecords(records) {
   let tokensCacheRead = 0;
   let tokensCacheCreation = 0;
   let costUsd = null;
+  const modelBreakdown = {};
   for (const record2 of records) {
     if (!record2 || typeof record2 !== "object") continue;
     const payload = record2;
@@ -51733,15 +51849,35 @@ function extractClaudeUsageFromRecords(records) {
       tokensCacheCreation = Number(usage2.cache_creation_input_tokens ?? 0);
       if (payload.total_cost_usd != null) costUsd = Number(payload.total_cost_usd);
     }
-    const nestedUsage = payload.usage ?? payload.message?.usage;
+    const message = payload.message;
+    const nestedUsage = payload.usage ?? message?.usage;
     if (nestedUsage && payload.type !== "result") {
-      tokensInput += Number(nestedUsage.input_tokens ?? 0);
-      tokensOutput += Number(nestedUsage.output_tokens ?? 0);
-      tokensCacheRead += Number(nestedUsage.cache_read_input_tokens ?? 0);
-      tokensCacheCreation += Number(nestedUsage.cache_creation_input_tokens ?? 0);
+      const i2 = Number(nestedUsage.input_tokens ?? 0);
+      const o2 = Number(nestedUsage.output_tokens ?? 0);
+      const cr2 = Number(nestedUsage.cache_read_input_tokens ?? 0);
+      const cc = Number(nestedUsage.cache_creation_input_tokens ?? 0);
+      tokensInput += i2;
+      tokensOutput += o2;
+      tokensCacheRead += cr2;
+      tokensCacheCreation += cc;
+      const model = typeof message?.model === "string" ? message.model : void 0;
+      if (model && model !== "<synthetic>") {
+        const totals = modelBreakdown[model] ??= {
+          tokensInput: 0,
+          tokensOutput: 0,
+          tokensCacheRead: 0,
+          tokensCacheCreation: 0,
+          tokensTotal: 0
+        };
+        totals.tokensInput += i2;
+        totals.tokensOutput += o2;
+        totals.tokensCacheRead += cr2;
+        totals.tokensCacheCreation += cc;
+        totals.tokensTotal += i2 + o2 + cr2 + cc;
+      }
     }
   }
-  return { tokensInput, tokensOutput, tokensCacheRead, tokensCacheCreation, costUsd };
+  return { tokensInput, tokensOutput, tokensCacheRead, tokensCacheCreation, costUsd, modelBreakdown };
 }
 function findMatchingClaudeTranscripts(slot) {
   const targets = [slot.workDir, slot.worktreePath].filter(Boolean);
@@ -51848,6 +51984,7 @@ function harvestClaudeUsage(slot) {
     tokensCacheCreation: best.tokensCacheCreation,
     tokensTotal,
     costUsd: best.costUsd,
+    ...Object.keys(best.modelBreakdown).length > 0 ? { modelBreakdown: best.modelBreakdown } : {},
     sources: ["harvest"],
     firstSeenAt: slot.sessionCreatedAt ?? now,
     lastSeenAt: now
@@ -52009,9 +52146,9 @@ async function postJson(url, body, dryRun) {
   }
   return await response.json();
 }
-async function postPortalSync(target, body, dryRun) {
+async function postPortal(target, endpoint, body, dryRun) {
   if (dryRun) return;
-  const response = await fetch(`${target.url}/api/sync`, {
+  const response = await fetch(`${target.url}${endpoint}`, {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
@@ -52029,21 +52166,98 @@ async function postPortalSync(target, body, dryRun) {
     throw new Error(`har-portal sync failed: HTTP ${response.status}${text ? ` \u2014 ${text}` : ""}`);
   }
 }
-function buildPortalSyncBody(repoPath) {
+function resolvePortalUserEmail() {
+  return readPortalCredentials()?.email || void 0;
+}
+function dropNullFields(record2) {
+  return Object.fromEntries(Object.entries(record2).filter(([, value]) => value !== null));
+}
+function modelsFromBreakdown(breakdown) {
+  if (!breakdown) return [];
+  return Object.entries(breakdown).map(([model, totals]) => ({
+    model,
+    ...totals && typeof totals === "object" ? totals : {}
+  }));
+}
+function collectPortalTelemetry(repoPath, slots) {
+  if (!isTelemetryEnabled()) return { usage: [], events: [] };
+  try {
+    const userEmail = resolvePortalUserEmail();
+    const usage2 = slots.flatMap(
+      (slot) => harvestUsageForSlot({
+        agentId: slot.agentId,
+        workDir: slot.workDir,
+        worktreePath: slot.worktreePath,
+        branch: slot.branch,
+        suffix: slot.suffix,
+        sessionCreatedAt: slot.sessionCreatedAt,
+        repoPath
+      }).map((row) => {
+        const models = modelsFromBreakdown(
+          row.modelBreakdown
+        );
+        return {
+          ...row,
+          workUnitId: slot.workUnitId ?? row.workUnitId,
+          attemptId: slot.attemptId ?? row.attemptId,
+          sessionKey: row.sessionKey || buildSessionKey({
+            branch: slot.branch,
+            agentId: slot.agentId,
+            suffix: slot.suffix,
+            createdAt: slot.sessionCreatedAt
+          }),
+          ...userEmail ? { userEmail } : {},
+          ...models.length > 0 ? { models } : {}
+        };
+      })
+    );
+    const events = slots.flatMap(
+      (slot) => harvestEventsForSlot({
+        agentId: slot.agentId,
+        workDir: slot.workDir,
+        worktreePath: slot.worktreePath,
+        branch: slot.branch,
+        suffix: slot.suffix,
+        sessionCreatedAt: slot.sessionCreatedAt,
+        repoPath
+      }).map(
+        (event) => dropNullFields({
+          ...event,
+          workUnitId: slot.workUnitId ?? event.workUnitId,
+          attemptId: slot.attemptId ?? event.attemptId
+        })
+      )
+    );
+    return { usage: usage2, events };
+  } catch {
+    return { usage: [], events: [] };
+  }
+}
+function buildPortalPayload(repoPath) {
   const runs = listRuns(repoPath);
   const status = collectEnvironmentStatus(repoPath);
   const manifest = readManifest(repoPath);
   const stagesRegistry = readStageRegistry(repoPath);
-  const validations = listValidations(resolveHarnessRoot(repoPath));
-  return {
+  const harnessRoot = resolveHarnessRoot(repoPath);
+  const validations = listValidations(harnessRoot);
+  const workUnits = listWorkUnits(harnessRoot);
+  const attempts = listWorkAttempts(harnessRoot);
+  const validationBindings = listValidationBindings(harnessRoot);
+  const { usage: usage2, events } = collectPortalTelemetry(repoPath, status.slots);
+  const syncBody = {
     path: repoPath,
     ...manifest ? { manifest } : {},
     ...stagesRegistry ? { stagesRegistry } : {},
     runs,
     slots: status.slots,
     generatedAt: status.generatedAt,
-    ...validations.length > 0 ? { validations } : {}
+    ...validations.length > 0 ? { validations } : {},
+    ...workUnits.length > 0 ? { workUnits } : {},
+    ...attempts.length > 0 ? { attempts } : {},
+    ...validationBindings.length > 0 ? { validationBindings } : {},
+    ...usage2.length > 0 ? { usage: usage2 } : {}
   };
+  return { syncBody, events };
 }
 async function isControlApiReachable(apiUrl = getControlApiUrl()) {
   try {
@@ -52161,7 +52375,16 @@ async function syncRepoWithControl(options) {
   }
   const portal = getPortalTarget();
   if (portal) {
-    await postPortalSync(portal, buildPortalSyncBody(repoPath), options.dryRun);
+    const { syncBody, events } = buildPortalPayload(repoPath);
+    await postPortal(portal, "/api/sync", syncBody, options.dryRun);
+    if (events.length > 0) {
+      await postPortal(
+        portal,
+        "/api/otel",
+        { path: repoPath, events, spans: [] },
+        options.dryRun
+      );
+    }
     return;
   }
   const registerResult = await registerRepoWithControl({ ...options, repoPath });
@@ -52322,7 +52545,7 @@ function checkLaunchGuard2(repoPath, agentId, options = {}) {
 init_control_config();
 
 // src/core/control-lifecycle.ts
-var import_child_process8 = require("child_process");
+var import_child_process9 = require("child_process");
 var path42 = __toESM(require("path"));
 
 // src/core/control-image.ts
@@ -52373,7 +52596,7 @@ function buildDockerRunArgs(options) {
   return args;
 }
 function runDocker(args) {
-  const result = (0, import_child_process8.spawnSync)("docker", args, {
+  const result = (0, import_child_process9.spawnSync)("docker", args, {
     stdio: "inherit",
     env: process.env
   });
@@ -52383,7 +52606,7 @@ function runDocker(args) {
   return result.status ?? 1;
 }
 function controlContainerExists(name = CONTROL_CONTAINER_NAME) {
-  const result = (0, import_child_process8.spawnSync)("docker", ["ps", "-aq", "-f", `name=^${name}$`], {
+  const result = (0, import_child_process9.spawnSync)("docker", ["ps", "-aq", "-f", `name=^${name}$`], {
     encoding: "utf8",
     stdio: ["pipe", "pipe", "ignore"]
   });
@@ -52994,7 +53217,7 @@ var getEnvironmentStatus = defaultRunService.getEnvironmentStatus.bind(defaultRu
 var getEnvironmentLogs = defaultRunService.getEnvironmentLogs.bind(defaultRunService);
 
 // src/core/commit-gate-onboarding.ts
-var readline5 = __toESM(require("readline"));
+var readline6 = __toESM(require("readline"));
 
 // src/core/hooks.ts
 var fs42 = __toESM(require("fs"));
@@ -53262,8 +53485,8 @@ async function recordCommitAssociation(cwd) {
 }
 
 // src/core/commit-gate-onboarding.ts
-function askYesNo4(question) {
-  const rl = readline5.createInterface({ input: process.stdin, output: process.stderr });
+function askYesNo5(question) {
+  const rl = readline6.createInterface({ input: process.stdin, output: process.stderr });
   return new Promise((resolve38) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
@@ -53294,7 +53517,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.");
@@ -53664,7 +53887,7 @@ async function handleInit(argv) {
     if (argv.auto) {
       await handleAgentMdProposal(repoPath, argv.yes);
     } else {
-      emitManualAdaptationPrompt(repoPath, "init", argv.profile);
+      await emitManualAdaptationPrompt(repoPath, "init", argv.profile, void 0, argv.yes);
     }
     divider();
     success("Harness initialized!");
@@ -53736,7 +53959,13 @@ async function handleMaintain(argv) {
       if (!result.validation.pass) {
         warn("Harness has validation errors \u2014 fix them before running --finalize.");
       }
-      emitManualAdaptationPrompt(repoPath, "maintain", "default", result.bundle?.report);
+      await emitManualAdaptationPrompt(
+        repoPath,
+        "maintain",
+        "default",
+        result.bundle?.report,
+        argv.yes
+      );
       info("After your coding agent finishes adapting, record it with: har env maintain --finalize");
     }
     divider();
@@ -53788,7 +54017,7 @@ function resolveOnboardingOptions(argv) {
     }
   };
 }
-function emitManualAdaptationPrompt(repoPath, mode, profile = "default", bundleReport) {
+async function emitManualAdaptationPrompt(repoPath, mode, profile = "default", bundleReport, autoYes = false) {
   const prompt2 = mode === "init" ? buildInitAdaptationPrompt(repoPath, profile) : buildMaintainAdaptationPrompt(repoPath, bundleReport);
   writeAdaptationPrompt(repoPath, prompt2);
   process.stderr.write("\n");
@@ -53804,6 +54033,7 @@ function emitManualAdaptationPrompt(repoPath, mode, profile = "default", bundleR
     info("  Reference templates are in .har/maintain/templates/");
   }
   printAdaptationPrompt(prompt2);
+  await offerAdaptationPromptClipboard(prompt2, { autoYes });
 }
 async function handleAgentMdProposal(repoPath, autoYes) {
   if (autoYes) {
@@ -53923,8 +54153,8 @@ async function handleLaunch(argv) {
       if (!confirmReplace && process.stdin.isTTY && process.stdout.isTTY) {
         warn("Occupied slot \u2014 review before replacing:");
         console.error(guard.reason ?? "");
-        const readline9 = await import("readline");
-        const rl = readline9.createInterface({ input: process.stdin, output: process.stderr });
+        const readline10 = await import("readline");
+        const rl = readline10.createInterface({ input: process.stdin, output: process.stderr });
         const answer = await new Promise((resolve38) => {
           rl.question("Replace this slot? [y/N] ", resolve38);
         });
@@ -53940,8 +54170,8 @@ async function handleLaunch(argv) {
     if (!guardAfterConfirm.allowed && guardAfterConfirm.blocked && guardAfterConfirm.slot?.dirty) {
       if (!force && process.stdin.isTTY && process.stdout.isTTY) {
         warn("Worktree has uncommitted changes.");
-        const readline9 = await import("readline");
-        const rl = readline9.createInterface({ input: process.stdin, output: process.stderr });
+        const readline10 = await import("readline");
+        const rl = readline10.createInterface({ input: process.stdin, output: process.stderr });
         const answer = await new Promise((resolve38) => {
           rl.question("Discard uncommitted changes? [y/N] ", resolve38);
         });
@@ -54146,7 +54376,7 @@ function printNextSteps(auto2) {
   console.error("");
   console.error("  Read:         .har/README.md");
   if (!auto2) {
-    console.error("  Adapt:        paste prompt above into your coding agent");
+    console.error("  Adapt:        paste clipboard / prompt above into your coding agent");
     console.error("  Prompt file:  .har/ADAPT-PROMPT.md");
   } else {
     console.error("  Agent guide:  AGENT.md (repo root, if applied)");
@@ -54167,13 +54397,13 @@ init_portal_credentials();
 // src/core/portal-login.ts
 var http = __toESM(require("http"));
 var import_crypto = require("crypto");
-var import_child_process10 = require("child_process");
+var import_child_process11 = 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_process10.spawn)(cmd, args, { stdio: "ignore", detached: true });
+    const child = (0, import_child_process11.spawn)(cmd, args, { stdio: "ignore", detached: true });
     child.on("error", () => {
     });
     child.unref();
@@ -54194,6 +54424,7 @@ async function loginViaBrowser(portalUrl, openUrl = openBrowser) {
       const token = requestUrl.searchParams.get("token");
       const returnedState = requestUrl.searchParams.get("state");
       const workspace = requestUrl.searchParams.get("workspace") ?? void 0;
+      const email2 = requestUrl.searchParams.get("email") ?? void 0;
       if (returnedState !== state || !token) {
         res.writeHead(400, { "Content-Type": "text/html" });
         res.end("<h1>Login failed</h1><p>You can close this tab and try again.</p>");
@@ -54204,7 +54435,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();
-      resolve38({ portalUrl, token, workspace, createdAt: (/* @__PURE__ */ new Date()).toISOString() });
+      resolve38({ portalUrl, token, workspace, email: email2, createdAt: (/* @__PURE__ */ new Date()).toISOString() });
     });
     const cleanup = () => {
       clearTimeout(timer);
@@ -54287,10 +54518,10 @@ function listUnregisterWorktreeCandidates(repoPath) {
   }
   return [...byPath.values()].sort((a2, b2) => a2.agentId - b2.agentId);
 }
-async function askYesNo5(question) {
+async function askYesNo6(question) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
-  const readline9 = await import("readline");
-  const rl = readline9.createInterface({ input: process.stdin, output: process.stderr });
+  const readline10 = await import("readline");
+  const rl = readline10.createInterface({ input: process.stdin, output: process.stderr });
   const answer = await new Promise((resolve38) => {
     rl.question(question, resolve38);
   });
@@ -54304,7 +54535,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) {
@@ -54316,7 +54547,7 @@ async function confirmUnregister(options) {
     process.stderr.write(`  agent-${wt2.agentId}: ${wt2.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 };
@@ -62766,7 +62997,7 @@ function getStore() {
   }
   return store;
 }
-function readline6() {
+function readline7() {
   return getStore().rl;
 }
 function withUpdates(fn) {
@@ -62811,7 +63042,7 @@ var effectScheduler = {
     const { index } = store;
     store.hooksEffect.push(() => {
       store.hooksCleanup[index]?.();
-      const cleanFn = cb(readline6());
+      const cleanFn = cb(readline7());
       if (cleanFn != null && typeof cleanFn !== "function") {
         throw new ValidationError("useEffect return value must be a cleanup function or nothing.");
       }
@@ -63287,7 +63518,7 @@ function breakLines(content, width) {
   return content.split("\n").flatMap((line) => (0, import_wrap_ansi.default)(line, width, { trim: false, hard: true }).split("\n").map((str) => str.trimEnd())).join("\n");
 }
 function readlineWidth() {
-  return (0, import_cli_width.default)({ defaultWidth: 80, output: readline6().output });
+  return (0, import_cli_width.default)({ defaultWidth: 80, output: readline7().output });
 }
 
 // node_modules/@inquirer/core/dist/esm/lib/pagination/lines.mjs
@@ -63379,7 +63610,7 @@ function usePagination({ items, active, renderItem, pageSize, loop = true }) {
 }
 
 // node_modules/@inquirer/core/dist/esm/lib/create-prompt.mjs
-var readline7 = __toESM(require("node:readline"), 1);
+var readline8 = __toESM(require("node:readline"), 1);
 var import_node_async_hooks3 = require("node:async_hooks");
 var import_mute_stream = __toESM(require_lib3(), 1);
 
@@ -63722,7 +63953,7 @@ function createPrompt(view) {
     const cleanups = /* @__PURE__ */ new Set();
     const output = new import_mute_stream.default();
     output.pipe(context.output ?? process.stdout);
-    const rl = readline7.createInterface({
+    const rl = readline8.createInterface({
       terminal: true,
       input,
       output

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osfactory/har",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "LLM-powered CLI for reproducible agent development environments",
   "keywords": [
     "har",