halfcycle 0.3.13 → 0.3.15

package/dist/bin.js

@@ -1625,7 +1625,7 @@ function resolveControlOrigin(env = process.env) {
   return { origin: DEFAULT_CONTROL_ORIGIN, source: "default" };
 }
 function controlOriginNote(resolved) {
-  return resolved.source === "environment" ? `${resolved.origin} (from HALFCYCLE_SERVICE_URL)` : `${resolved.origin} (the Halfcycle plane)`;
+  return resolved.source === "environment" ? `${resolved.origin} (from HALFCYCLE_SERVICE_URL)` : `${resolved.origin} (the published one)`;
 }
 
 // dist/device-signin.js
@@ -1772,7 +1772,7 @@ var SignInRefused = class extends Error {
   }
 };
 var SIGN_IN_TIMED_OUT = "timed-out";
-var SIGN_IN_TIMEOUT_MESSAGE = "Sign-in timed out: the Halfcycle plane stopped answering while this terminal was waiting for the browser. Nothing was created. Check your connection and run the command again.";
+var SIGN_IN_TIMEOUT_MESSAGE = "Sign-in timed out: the Halfcycle service stopped answering while this terminal was waiting for the browser. Nothing was created. Check your connection and run the command again.";
 var SIGN_IN_NON_INTERACTIVE_MESSAGE = "Halfcycle needs a signed-in account and this looks like a non-interactive run (CI is set), so there is no browser to sign in with. Set HALFCYCLE_TOKEN in the environment to a Halfcycle credential and run this again. Nothing was created.";
 var DEADLINE_SLACK_INTERVALS = 1;
 var STILL_WAITING_MS = 15e3;
@@ -1859,7 +1859,7 @@ async function startDeviceAuth(serviceUrl) {
       body: "{}"
     });
   } catch (err) {
-    throw new SignInRefused(SIGN_IN_TIMED_OUT, `Could not reach the Halfcycle plane at ${url} to start a sign-in: ${err instanceof Error ? err.message : String(err)}. Nothing was created.`);
+    throw new SignInRefused(SIGN_IN_TIMED_OUT, `Could not reach the Halfcycle service at ${url} to start a sign-in: ${err instanceof Error ? err.message : String(err)}. Nothing was created.`);
   }
   const body = await res.json().catch(() => null);
   if (res.status !== 201) {
@@ -1868,7 +1868,7 @@ async function startDeviceAuth(serviceUrl) {
   }
   const parsed = deviceAuthStartResponseSchema.safeParse(body);
   if (!parsed.success) {
-    throw new SignInRefused(SIGN_IN_TIMED_OUT, `The Halfcycle plane at ${url} answered a sign-in start this client cannot read. Either that plane is older than this installer, or the address is not a Halfcycle control plane. Nothing was created.`);
+    throw new SignInRefused(SIGN_IN_TIMED_OUT, `The Halfcycle service at ${url} answered a sign-in start this client cannot read. Either that service is older than this installer, or the address is not a Halfcycle service. Nothing was created.`);
   }
   return parsed.data;
 }
@@ -1943,7 +1943,7 @@ async function collectDecidedCredential(serviceUrl, started, deps) {
       });
       body = await res.json().catch(() => null);
     } catch (err) {
-      lastProblem = `The browser finished signing you in, but this terminal could not reach the Halfcycle plane to collect the credential: ${err instanceof Error ? err.message : String(err)}. Run the command again.`;
+      lastProblem = `The browser finished signing you in, but this terminal could not reach the Halfcycle service to collect the credential: ${err instanceof Error ? err.message : String(err)}. Run the command again.`;
       continue;
     }
     const parsed = devicePollResponseSchema.safeParse(body);
@@ -2132,7 +2132,7 @@ async function requestEngagementValues(url, requestBody, credential, shape) {
       body: JSON.stringify(requestBody)
     });
   } catch (err) {
-    throw new Error(`[bundle install] Could not reach the Halfcycle control plane at ${url}: ${err instanceof Error ? err.message : String(err)}. ${shape.nothingHappened}. ` + CONTROL_ORIGIN_HINT);
+    throw new Error(`[bundle install] Could not reach the Halfcycle service at ${url}: ${err instanceof Error ? err.message : String(err)}. ${shape.nothingHappened}. ` + CONTROL_ORIGIN_HINT);
   }
   if (!res.ok) {
     const detail = await res.text().catch(() => "");
@@ -2140,7 +2140,7 @@ async function requestEngagementValues(url, requestBody, credential, shape) {
     if (refusal) {
       throw new CreateEngagementRefused(res.status, refusal.message, refusal.error, `[bundle install] ${shape.action} failed: ${url} returned ${res.status}. ${refusal.message} ${shape.nothingHappened}.`);
     }
-    const wrongOrigin = res.status === 404 ? `That address answered, but it does not serve ${shape.route} \u2014 so it is not the control plane. ` : "";
+    const wrongOrigin = res.status === 404 ? `That address answered, but it does not serve ${shape.route} \u2014 so it is not the Halfcycle service. ` : "";
     throw new Error(`[bundle install] ${shape.action} failed: ${url} returned ${res.status}. ${wrongOrigin}${detail ? `Response: ${detail.slice(0, 300)}. ` : ""}${shape.nothingHappened}. ` + CONTROL_ORIGIN_HINT);
   }
   const body = await res.json().catch(() => null);
@@ -2152,14 +2152,14 @@ async function requestEngagementValues(url, requestBody, credential, shape) {
     ["sessionToken", body.sessionToken]
   ]) {
     if (value.trim() === "") {
-      throw new Error(`[bundle install] The Halfcycle plane at ${url} answered with a blank ${field} (the field is present but empty). An install cannot proceed on it: it would be written into this engagement's credential store, read back as a configured value, and every guard evaluation would fail against it for the life of the engagement. ${shape.nothingHappened} and nothing was written. ` + CONTROL_ORIGIN_HINT);
+      throw new Error(`[bundle install] The Halfcycle service at ${url} answered with a blank ${field} (the field is present but empty). An install cannot proceed on it: it would be written into this engagement's credential store, read back as a configured value, and every guard evaluation would fail against it for the life of the engagement. ${shape.nothingHappened} and nothing was written. ` + CONTROL_ORIGIN_HINT);
     }
   }
   if (typeof body.mcpUrl !== "string" || body.mcpUrl.trim() === "") {
-    throw new Error(`[bundle install] The Halfcycle plane at ${url} created an engagement but did not say where its MCP server lives (no mcpUrl on the response). Without that address the install would write an MCP registration pointing nowhere, so nothing was written. Either that plane is older than this installer, or ${url} is not a Halfcycle control plane.`);
+    throw new Error(`[bundle install] The Halfcycle service at ${url} created an engagement but did not say where its MCP server lives (no mcpUrl on the response). Without that address the install would write an MCP registration pointing nowhere, so nothing was written. Either that service is older than this installer, or ${url} is not a Halfcycle service.`);
   }
   if (typeof body.guardUrl !== "string" || body.guardUrl.trim() === "") {
-    throw new Error(`[bundle install] The Halfcycle plane at ${url} created an engagement but did not say where its guard service lives (no guardUrl on the response). Without that address the install would wire a guard hook that evaluates nothing, so nothing was written. Either that plane is older than this installer, or ${url} is not a Halfcycle control plane.`);
+    throw new Error(`[bundle install] The Halfcycle service at ${url} created an engagement but did not say where its guard service lives (no guardUrl on the response). Without that address the install would wire a guard hook that evaluates nothing, so nothing was written. Either that service is older than this installer, or ${url} is not a Halfcycle service.`);
   }
   const controlTelemetryUrl = typeof body.controlTelemetryUrl === "string" && body.controlTelemetryUrl.trim() !== "" ? body.controlTelemetryUrl.trim().replace(/\/+$/, "") : void 0;
   return {
@@ -2218,12 +2218,286 @@ function refusedCredentialRemedy(source) {
     case "stored":
       return "That was this machine's saved sign-in and it has been discarded. Run the command again to sign in through your browser.";
     case "browser-handoff":
-      return "That credential was issued by this sign-in moments ago, so signing in again would produce the same result. This is a problem on the Halfcycle plane rather than with your account.";
+      return "That credential was issued by this sign-in moments ago, so signing in again would produce the same result. This is a problem on the Halfcycle service rather than with your account.";
   }
 }
 
 // dist/confirm-identity.js
 import { createInterface } from "node:readline/promises";
+
+// dist/banner.js
+var MARK_FULL = {
+  width: 32,
+  discRows: 7,
+  lines: [
+    "          :+oshhhhso+:",
+    "       :sdMMMMMMMMMMMMds:",
+    "     :hMMMMMMMMMMMMMMMMMMh:",
+    "    oMMMMMMMMMMMMMMMMMMMMMMo",
+    "   oMMMMMMMMMMMMMMMMMMMMMMMMo",
+    "   NMMMMMMMMMMMMMMMMMMMMMMMMN",
+    "  :ssssssssssssssssssssssssss:",
+    "  +dddddddddddddddddddddddddd+",
+    "   Nd                      dN",
+    "   oMy                    yMo",
+    "    oMh:                :hMo",
+    "     :hMy-            -yMh:",
+    "       :sdNys++--++syNds:",
+    "          :+oshhhhso+:"
+  ]
+};
+var MARK_NARROW = {
+  width: 24,
+  discRows: 5,
+  lines: [
+    "      -ohdMMMMdho-",
+    "    +dMMMMMMMMMMMMd+",
+    "   yMMMMMMMMMMMMMMMMy",
+    "  sMMMMMMMMMMMMMMMMMMs",
+    "  yhhhhhhhhhhhhhhhhhhy",
+    "  NdhhhhhhhhhhhhhhhhdN",
+    "  sd                ds",
+    "   yd:            :dy",
+    "    +dy+        +yd+",
+    "      -ohhhhhhhho-"
+  ]
+};
+var UNICODE_GLYPHS = {
+  rule: "\u2500",
+  swatch: "\u2584",
+  dot: "\xB7",
+  dash: "\u2014"
+};
+var ASCII_GLYPHS = {
+  rule: "-",
+  swatch: "#",
+  dot: "|",
+  dash: "-"
+};
+function toAscii(text) {
+  let out = text;
+  for (const key of Object.keys(UNICODE_GLYPHS)) {
+    out = out.split(UNICODE_GLYPHS[key]).join(ASCII_GLYPHS[key]);
+  }
+  return out.replace(/[^ -~]/g, "?");
+}
+var INK = {
+  /** `--text` — the terminal's own foreground, never one we picked. */
+  plain: "",
+  /** `--muted` — dimmed default ink, so it is grey against whatever the background is. */
+  dim: "2",
+  /** `--faint` / `--faded` — bright black, the one ANSI grey that is a colour. */
+  faint: "90",
+  /** Not a colour: emphasis, used with whatever ink is already in force. */
+  bold: "1",
+  /** `--signal` — yellow, the nearest ANSI seat for the brand's gold. */
+  key: "33",
+  /** `--signal`, brighter: the one value on a screen that must be found first. */
+  keyBold: "33;1",
+  /** `--console-accent` (`#19d3ff`) — the console's own accent, cyan being its ANSI seat. */
+  accent: "36",
+  /** `--good` — the console's affirmative. */
+  good: "32",
+  /** `--bad` — the console's negative. */
+  bad: "31"
+};
+var SWATCH_SGR = [
+  INK.dim,
+  INK.faint,
+  INK.key,
+  INK.keyBold,
+  INK.accent,
+  INK.good,
+  INK.bad
+];
+var ESC = "\x1B";
+var RESET = `${ESC}[0m`;
+function paint(segments, colour) {
+  return segments.map((s) => colour && s.sgr !== "" ? `${ESC}[${s.sgr}m${s.text}${RESET}` : s.text).join("");
+}
+function ink(name, text, colour) {
+  const sgr = INK[name];
+  return colour && sgr !== "" ? `${ESC}[${sgr}m${text}${RESET}` : text;
+}
+var GAP = 4;
+var FULL_LAYOUT = { art: MARK_FULL, label: 13, rule: 28, palette: true, minColumns: 76 };
+var NARROW_LAYOUT = { art: MARK_NARROW, label: 10, rule: 20, palette: false, minColumns: 48 };
+var DEFAULT_COLUMNS = 80;
+function usableColumns(environment) {
+  const columns = environment.columns;
+  return columns !== void 0 && columns > 0 ? columns : DEFAULT_COLUMNS;
+}
+function isSet(value) {
+  return value !== void 0 && value !== "";
+}
+function plainTextRequested(env) {
+  return isSet(env["NO_COLOR"]) || env["TERM"] === "dumb";
+}
+function decideCut(environment = {}) {
+  const env = environment.env ?? {};
+  if (environment.quiet === true)
+    return "none";
+  if (environment.isTTY !== true)
+    return "line";
+  if (plainTextRequested(env))
+    return "line";
+  const columns = usableColumns(environment);
+  if (columns >= FULL_LAYOUT.minColumns)
+    return "full";
+  if (columns >= NARROW_LAYOUT.minColumns)
+    return "narrow";
+  return "line";
+}
+function decideColour(environment = {}) {
+  const env = environment.env ?? {};
+  const force = env["FORCE_COLOR"];
+  if (isSet(force))
+    return force !== "0";
+  if (plainTextRequested(env))
+    return false;
+  return environment.isTTY === true;
+}
+function decideUnicode(environment = {}) {
+  const env = environment.env ?? {};
+  if ((environment.platform ?? "") !== "win32") {
+    const locale = env["LC_ALL"] ?? env["LC_CTYPE"] ?? env["LANG"] ?? "";
+    return locale === "" || /utf-?8/i.test(locale);
+  }
+  return isSet(env["WT_SESSION"]) || isSet(env["TERMINUS_SUBLIME"]) || env["ConEmuTask"] === "{cmd::Cmder}" || env["TERM_PROGRAM"] === "vscode";
+}
+function padEnd(text, width) {
+  return text + " ".repeat(Math.max(0, width - text.length));
+}
+function clip(text, width) {
+  if (width < 8 || text.length <= width)
+    return text;
+  return `${text.slice(0, width - 3)}...`;
+}
+function paletteRow(swatch) {
+  const row = [];
+  SWATCH_SGR.forEach((sgr, i) => {
+    if (i > 0)
+      row.push({ text: " ", sgr: INK.plain });
+    row.push({ text: swatch.repeat(2), sgr });
+  });
+  return row;
+}
+function factColumn(content, layout, glyphs, text, valueWidth) {
+  const rows = [];
+  const head = text(content.head);
+  const at = head.indexOf("@");
+  rows.push(at < 0 ? [{ text: head, sgr: INK.keyBold }] : [
+    { text: head.slice(0, at), sgr: INK.keyBold },
+    { text: "@", sgr: INK.dim },
+    { text: head.slice(at + 1), sgr: INK.bold }
+  ]);
+  rows.push([{ text: glyphs.rule.repeat(layout.rule), sgr: INK.dim }]);
+  const narrow = layout.art === MARK_NARROW;
+  for (const fact2 of content.facts) {
+    const raw = narrow ? fact2.narrow : fact2.value;
+    if (raw === void 0)
+      continue;
+    rows.push([
+      { text: padEnd(`${text(fact2.label)}:`, layout.label), sgr: INK.key },
+      { text: clip(text(raw), valueWidth), sgr: INK.plain }
+    ]);
+  }
+  if (layout.palette) {
+    rows.push([]);
+    rows.push(paletteRow(glyphs.swatch));
+  }
+  return rows;
+}
+var MARGIN = 2;
+function lastSentenceStart(line) {
+  const at = line.lastIndexOf(". ");
+  return at < 0 ? 0 : at + 2;
+}
+function taglineRow(line, first, last) {
+  const indent = { text: "  ", sgr: INK.plain };
+  if (first)
+    return [indent, { text: line, sgr: INK.keyBold }];
+  if (!last)
+    return [indent, { text: line, sgr: INK.dim }];
+  const at = lastSentenceStart(line);
+  if (at === 0)
+    return [indent, { text: line, sgr: INK.key }];
+  return [
+    indent,
+    { text: line.slice(0, at), sgr: INK.dim },
+    { text: line.slice(at), sgr: INK.key }
+  ];
+}
+function renderBlock(content, layout, environment) {
+  const unicode = decideUnicode(environment);
+  const colour = decideColour(environment);
+  const glyphs = unicode ? UNICODE_GLYPHS : ASCII_GLYPHS;
+  const text = (raw) => unicode ? raw : toAscii(raw);
+  const art = layout.art;
+  const valueWidth = usableColumns(environment) - (art.width + GAP + layout.label);
+  const right = factColumn(content, layout, glyphs, text, valueWidth);
+  const top = Math.max(0, Math.floor((art.lines.length - right.length) / 2));
+  const height = Math.max(art.lines.length, right.length + top);
+  const lines = Array.from({ length: MARGIN }, () => []);
+  for (let i = 0; i < height; i++) {
+    const artLine = art.lines[i] ?? "";
+    const segments = [];
+    if (artLine.length > 0) {
+      segments.push({ text: artLine, sgr: i < art.discRows ? INK.plain : INK.dim });
+    }
+    const rightRow = right[i - top];
+    if (rightRow !== void 0 && rightRow.length > 0) {
+      segments.push({ text: " ".repeat(Math.max(0, art.width + GAP - artLine.length)), sgr: INK.plain });
+      segments.push(...rightRow);
+    }
+    lines.push(segments);
+  }
+  const tagline = layout.art === MARK_NARROW ? content.tagNarrow ?? content.tag : content.tag;
+  lines.push([]);
+  tagline.forEach((line, i) => {
+    lines.push(taglineRow(text(line), i === 0, i === tagline.length - 1));
+  });
+  for (let i = 0; i < MARGIN; i++)
+    lines.push([]);
+  return lines.map((segments) => paint(segments, colour)).join("\n");
+}
+function renderLine(content, environment) {
+  const unicode = decideUnicode(environment);
+  const dot = unicode ? UNICODE_GLYPHS.dot : ASCII_GLYPHS.dot;
+  const named = content.version === "" ? "Halfcycle" : `Halfcycle v${content.version}`;
+  const raw = `${named} ${dot} ${content.url}`;
+  return unicode ? raw : toAscii(raw);
+}
+function renderBanner(content, environment = {}) {
+  switch (decideCut(environment)) {
+    case "none":
+      return "";
+    case "line":
+      return renderLine(content, environment);
+    case "narrow":
+      return renderBlock(content, NARROW_LAYOUT, environment);
+    case "full":
+      return renderBlock(content, FULL_LAYOUT, environment);
+  }
+}
+function printBanner(sink, content, environment = {}) {
+  const text = renderBanner(content, environment);
+  if (text === "")
+    return;
+  sink.write(`${text}
+`);
+}
+function currentEnvironment(quiet2) {
+  return {
+    columns: process.stdout.columns,
+    isTTY: process.stdout.isTTY === true,
+    quiet: quiet2,
+    env: process.env,
+    platform: process.platform
+  };
+}
+
+// dist/confirm-identity.js
 var IDENTITY_TIMEOUT_MS = 5e3;
 var IDENTITY_DECLINED = "identity-declined";
 async function describeAccount(serviceUrl, credential, fetchImpl = fetch) {
@@ -2245,14 +2519,14 @@ async function describeAccount(serviceUrl, credential, fetchImpl = fetch) {
     clearTimeout(timer);
   }
 }
-function accountLabel(identity, storedAccountId) {
+function accountLabel(identity, storedAccountId, verbose2 = false) {
   const accountId = identity?.accountId ?? storedAccountId;
   if (identity?.email !== void 0 && identity.email.trim() !== "") {
-    return accountId !== void 0 ? `${identity.email} (account ${accountId})` : identity.email;
+    return verbose2 && accountId !== void 0 ? `${identity.email} (account ${accountId})` : identity.email;
   }
   if (accountId !== void 0)
     return `account ${accountId} (no email on record for it)`;
-  return "the account this credential belongs to, which this plane did not name";
+  return "the account this credential belongs to, which this service did not name";
 }
 function onlyDate(iso) {
   if (iso === void 0)
@@ -2263,10 +2537,10 @@ function onlyDate(iso) {
 function actClause(act) {
   return act.kind === "create" ? `create a NEW project for that account, and install into ${act.targetRepo}` : `join the project this repository is pinned to (${act.engagementId}) as that account, and install into ${act.targetRepo}`;
 }
-async function defaultAsk(question) {
+async function defaultAsk(question2) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   try {
-    return await rl.question(question);
+    return await rl.question(question2);
   } finally {
     rl.close();
     process.stdin.pause();
@@ -2284,7 +2558,10 @@ function actingAs(credential, identity) {
   const accountId = identity?.accountId ?? credential.accountId;
   return accountId === void 0 ? credential : { ...credential, accountId };
 }
-function armScript(credential, act, label, home) {
+function question(colour) {
+  return `[halfcycle] Continue as that account?  ${ink("good", "[y]", colour)} yes   ${ink("key", "[s]", colour)} sign in as someone else   ${ink("faint", "[anything else]", colour)} stop: `;
+}
+function armScript(credential, act, label, plainLabel, home) {
   switch (credential.source) {
     case "browser-handoff":
       return {
@@ -2310,7 +2587,7 @@ function armScript(credential, act, label, home) {
         noTerminalNote: "",
         switchOpening: `[halfcycle] Signing you in through your browser \u2014 this install will use that account instead.
 `,
-        stopRemedy: `Stopped before anything was created \u2014 nothing was created and nothing was written. HALFCYCLE_TOKEN in this environment is the credential for ${label}, and it takes precedence over any saved sign-in \u2014 so unset it, or set it to your own account's credential, before running this again.`,
+        stopRemedy: `Stopped before anything was created \u2014 nothing was created and nothing was written. HALFCYCLE_TOKEN in this environment is the credential for ${plainLabel}, and it takes precedence over any saved sign-in \u2014 so unset it, or set it to your own account's credential, before running this again.`,
         // The switch is real for THIS run (the new credential is what gets used) and it
         // does not persist: `obtainCredential` reads the variable first, so the next run
         // is the same variable again. Said here rather than discovered tomorrow.
@@ -2336,7 +2613,7 @@ function armScript(credential, act, label, home) {
 `,
         switchOpening: `[halfcycle] Forgetting this machine's saved sign-in and signing you in through your browser.
 `,
-        stopRemedy: `Stopped before anything was created \u2014 nothing was created and nothing was written. This machine's saved sign-in is for ${label}. Run this again and answer "s" to sign in as a different account, or remove ${accountStorePath(home)} to be asked for a sign-in next time.`,
+        stopRemedy: `Stopped before anything was created \u2014 nothing was created and nothing was written. This machine's saved sign-in is for ${plainLabel}. Run this again and answer "s" to sign in as a different account, or remove ${accountStorePath(home)} to be asked for a sign-in next time.`,
         afterSwitch: ""
       };
     }
@@ -2344,10 +2621,12 @@ function armScript(credential, act, label, home) {
 }
 async function confirmActingIdentity(serviceUrl, credential, act, deps = {}) {
   const write = deps.write ?? ((text) => process.stdout.write(text));
+  const colour = deps.colour ?? decideColour({ isTTY: process.stdout.isTTY === true, env: deps.env ?? process.env });
   const identity = await describeAccount(serviceUrl, credential.credential, deps.fetchImpl);
-  const label = accountLabel(identity, credential.accountId);
+  const plainLabel = accountLabel(identity, credential.accountId, deps.verbose === true);
+  const label = ink("keyBold", plainLabel, colour);
   const acting = actingAs(credential, identity);
-  const script = armScript(credential, act, label, deps.home);
+  const script = armScript(credential, act, label, plainLabel, deps.home);
   write(script.preamble);
   if (!script.asks)
     return acting;
@@ -2363,14 +2642,15 @@ async function confirmActingIdentity(serviceUrl, credential, act, deps = {}) {
     return acting;
   }
   const ask = deps.ask ?? defaultAsk;
-  const decision = readDecision(await ask(`[halfcycle] Continue as that account?  [y] yes   [s] sign in as someone else   [anything else] stop: `));
+  write("\n");
+  const decision = readDecision(await ask(question(colour)));
   if (decision === "proceed")
     return acting;
   if (decision === "switch-account") {
     write(script.switchOpening);
     const replacement = await switchAccount(serviceUrl, deps);
     const replacementIdentity = await describeAccount(serviceUrl, replacement.credential, deps.fetchImpl);
-    write(`[halfcycle] Signed in as ${accountLabel(replacementIdentity, replacement.accountId)}. This install will ${actClause(act)}.
+    write(`[halfcycle] Signed in as ${ink("keyBold", accountLabel(replacementIdentity, replacement.accountId, deps.verbose === true), colour)}. This install will ${actClause(act)}.
 `);
     if (script.afterSwitch !== "")
       write(script.afterSwitch);
@@ -2882,7 +3162,7 @@ async function openPhase(credential, phase, entry) {
       body: JSON.stringify({ phase, entry })
     });
   } catch (err) {
-    throw new Error(`[halfcycle] Could not reach the Halfcycle control plane at ${url}: ${err instanceof Error ? err.message : String(err)}. No phase was opened.`);
+    throw new Error(`[halfcycle] Could not reach the Halfcycle service at ${url}: ${err instanceof Error ? err.message : String(err)}. No phase was opened.`);
   }
   if (!res.ok) {
     const body2 = await res.json().catch(() => null);
@@ -2935,7 +3215,7 @@ async function closePhase(credential, phase, outcome, close) {
       body: JSON.stringify({ phase, acceptanceOutcome: outcome, close })
     });
   } catch (err) {
-    throw new Error(`[halfcycle] Could not reach the Halfcycle control plane at ${url}: ${err instanceof Error ? err.message : String(err)}. The phase was not closed.`);
+    throw new Error(`[halfcycle] Could not reach the Halfcycle service at ${url}: ${err instanceof Error ? err.message : String(err)}. The phase was not closed.`);
   }
   if (!res.ok) {
     const body2 = await res.json().catch(() => null);
@@ -3066,234 +3346,6 @@ var PLACEHOLDERS = {
   "--evidence": '"\u2026"'
 };
 
-// dist/banner.js
-var MARK_FULL = {
-  width: 32,
-  discRows: 7,
-  lines: [
-    "          :+oshhhhso+:",
-    "       :sdMMMMMMMMMMMMds:",
-    "     :hMMMMMMMMMMMMMMMMMMh:",
-    "    oMMMMMMMMMMMMMMMMMMMMMMo",
-    "   oMMMMMMMMMMMMMMMMMMMMMMMMo",
-    "   NMMMMMMMMMMMMMMMMMMMMMMMMN",
-    "  :ssssssssssssssssssssssssss:",
-    "  +dddddddddddddddddddddddddd+",
-    "   Nd                      dN",
-    "   oMy                    yMo",
-    "    oMh:                :hMo",
-    "     :hMy-            -yMh:",
-    "       :sdNys++--++syNds:",
-    "          :+oshhhhso+:"
-  ]
-};
-var MARK_NARROW = {
-  width: 24,
-  discRows: 5,
-  lines: [
-    "      -ohdMMMMdho-",
-    "    +dMMMMMMMMMMMMd+",
-    "   yMMMMMMMMMMMMMMMMy",
-    "  sMMMMMMMMMMMMMMMMMMs",
-    "  yhhhhhhhhhhhhhhhhhhy",
-    "  NdhhhhhhhhhhhhhhhhdN",
-    "  sd                ds",
-    "   yd:            :dy",
-    "    +dy+        +yd+",
-    "      -ohhhhhhhho-"
-  ]
-};
-var UNICODE_GLYPHS = {
-  rule: "\u2500",
-  swatch: "\u2584",
-  dot: "\xB7",
-  dash: "\u2014"
-};
-var ASCII_GLYPHS = {
-  rule: "-",
-  swatch: "#",
-  dot: "|",
-  dash: "-"
-};
-function toAscii(text) {
-  let out = text;
-  for (const key of Object.keys(UNICODE_GLYPHS)) {
-    out = out.split(UNICODE_GLYPHS[key]).join(ASCII_GLYPHS[key]);
-  }
-  return out.replace(/[^ -~]/g, "?");
-}
-var INK = {
-  plain: "",
-  dim: "2",
-  bold: "1",
-  /** Yellow — the nearest ANSI seat for the brand's gold, used for labels and the URL. */
-  key: "33",
-  keyBold: "33;1"
-};
-var SWATCH_SGR = ["90", "31", "32", "33", "34", "35", "36", "37"];
-var ESC = "\x1B";
-var RESET = `${ESC}[0m`;
-function paint(segments, colour) {
-  return segments.map((s) => colour && s.sgr !== "" ? `${ESC}[${s.sgr}m${s.text}${RESET}` : s.text).join("");
-}
-var GAP = 4;
-var FULL_LAYOUT = { art: MARK_FULL, label: 13, rule: 28, palette: true, minColumns: 76 };
-var NARROW_LAYOUT = { art: MARK_NARROW, label: 10, rule: 20, palette: false, minColumns: 48 };
-var DEFAULT_COLUMNS = 80;
-function usableColumns(environment) {
-  const columns = environment.columns;
-  return columns !== void 0 && columns > 0 ? columns : DEFAULT_COLUMNS;
-}
-function isSet(value) {
-  return value !== void 0 && value !== "";
-}
-function plainTextRequested(env) {
-  return isSet(env["NO_COLOR"]) || env["TERM"] === "dumb";
-}
-function decideCut(environment = {}) {
-  const env = environment.env ?? {};
-  if (environment.quiet === true)
-    return "none";
-  if (environment.isTTY !== true)
-    return "line";
-  if (plainTextRequested(env))
-    return "line";
-  const columns = usableColumns(environment);
-  if (columns >= FULL_LAYOUT.minColumns)
-    return "full";
-  if (columns >= NARROW_LAYOUT.minColumns)
-    return "narrow";
-  return "line";
-}
-function decideColour(environment = {}) {
-  const env = environment.env ?? {};
-  const force = env["FORCE_COLOR"];
-  if (isSet(force))
-    return force !== "0";
-  if (plainTextRequested(env))
-    return false;
-  return environment.isTTY === true;
-}
-function decideUnicode(environment = {}) {
-  const env = environment.env ?? {};
-  if ((environment.platform ?? "") !== "win32") {
-    const locale = env["LC_ALL"] ?? env["LC_CTYPE"] ?? env["LANG"] ?? "";
-    return locale === "" || /utf-?8/i.test(locale);
-  }
-  return isSet(env["WT_SESSION"]) || isSet(env["TERMINUS_SUBLIME"]) || env["ConEmuTask"] === "{cmd::Cmder}" || env["TERM_PROGRAM"] === "vscode";
-}
-function padEnd(text, width) {
-  return text + " ".repeat(Math.max(0, width - text.length));
-}
-function clip(text, width) {
-  if (width < 8 || text.length <= width)
-    return text;
-  return `${text.slice(0, width - 3)}...`;
-}
-function paletteRow(swatch) {
-  const row = [];
-  SWATCH_SGR.forEach((sgr, i) => {
-    if (i > 0)
-      row.push({ text: " ", sgr: INK.plain });
-    row.push({ text: swatch.repeat(2), sgr });
-  });
-  return row;
-}
-function factColumn(content, layout, glyphs, text, valueWidth) {
-  const rows = [];
-  const head = text(content.head);
-  const at = head.indexOf("@");
-  rows.push(at < 0 ? [{ text: head, sgr: INK.keyBold }] : [
-    { text: head.slice(0, at), sgr: INK.keyBold },
-    { text: "@", sgr: INK.dim },
-    { text: head.slice(at + 1), sgr: INK.bold }
-  ]);
-  rows.push([{ text: glyphs.rule.repeat(layout.rule), sgr: INK.dim }]);
-  const narrow = layout.art === MARK_NARROW;
-  for (const fact2 of content.facts) {
-    const raw = narrow ? fact2.narrow : fact2.value;
-    if (raw === void 0)
-      continue;
-    rows.push([
-      { text: padEnd(`${text(fact2.label)}:`, layout.label), sgr: INK.key },
-      { text: clip(text(raw), valueWidth), sgr: INK.plain }
-    ]);
-  }
-  if (layout.palette) {
-    rows.push([]);
-    rows.push(paletteRow(glyphs.swatch));
-  }
-  return rows;
-}
-function renderBlock(content, layout, environment) {
-  const unicode = decideUnicode(environment);
-  const colour = decideColour(environment);
-  const glyphs = unicode ? UNICODE_GLYPHS : ASCII_GLYPHS;
-  const text = (raw) => unicode ? raw : toAscii(raw);
-  const art = layout.art;
-  const valueWidth = usableColumns(environment) - (art.width + GAP + layout.label);
-  const right = factColumn(content, layout, glyphs, text, valueWidth);
-  const top = Math.max(0, Math.floor((art.lines.length - right.length) / 2));
-  const height = Math.max(art.lines.length, right.length + top);
-  const lines = [];
-  for (let i = 0; i < height; i++) {
-    const artLine = art.lines[i] ?? "";
-    const segments = [];
-    if (artLine.length > 0) {
-      segments.push({ text: artLine, sgr: i < art.discRows ? INK.plain : INK.dim });
-    }
-    const rightRow = right[i - top];
-    if (rightRow !== void 0 && rightRow.length > 0) {
-      segments.push({ text: " ".repeat(Math.max(0, art.width + GAP - artLine.length)), sgr: INK.plain });
-      segments.push(...rightRow);
-    }
-    lines.push(segments);
-  }
-  const tagline = layout.art === MARK_NARROW ? content.tagNarrow ?? content.tag : content.tag;
-  lines.push([]);
-  tagline.forEach((line, i) => {
-    lines.push([{ text: `  ${text(line)}`, sgr: i === 0 ? INK.bold : INK.dim }]);
-  });
-  lines.push([]);
-  lines.push([{ text: `  ${text(content.url)}`, sgr: INK.key }]);
-  return lines.map((segments) => paint(segments, colour)).join("\n");
-}
-function renderLine(content, environment) {
-  const unicode = decideUnicode(environment);
-  const dot = unicode ? UNICODE_GLYPHS.dot : ASCII_GLYPHS.dot;
-  const named = content.version === "" ? "Halfcycle" : `Halfcycle v${content.version}`;
-  const raw = `${named} ${dot} ${content.url}`;
-  return unicode ? raw : toAscii(raw);
-}
-function renderBanner(content, environment = {}) {
-  switch (decideCut(environment)) {
-    case "none":
-      return "";
-    case "line":
-      return renderLine(content, environment);
-    case "narrow":
-      return renderBlock(content, NARROW_LAYOUT, environment);
-    case "full":
-      return renderBlock(content, FULL_LAYOUT, environment);
-  }
-}
-function printBanner(sink, content, environment = {}) {
-  const text = renderBanner(content, environment);
-  if (text === "")
-    return;
-  sink.write(`${text}
-`);
-}
-function currentEnvironment(quiet2) {
-  return {
-    columns: process.stdout.columns,
-    isTTY: process.stdout.isTTY === true,
-    quiet: quiet2,
-    env: process.env,
-    platform: process.platform
-  };
-}
-
 // dist/banner-facts.js
 import { execFileSync as execFileSync3 } from "node:child_process";
 import { readFileSync as readFileSync8 } from "node:fs";
@@ -3352,7 +3404,7 @@ var REAL_PROBES = {
       return void 0;
     }
   },
-  planeHost: (env) => {
+  websiteHost: (env) => {
     try {
       const resolved = resolveControlOrigin(env);
       return resolved.source === "default" ? BRAND_URL : new URL(resolved.origin).host;
@@ -3380,7 +3432,11 @@ function openingBannerContent(projectDir, env = process.env, probes = REAL_PROBE
     fact("Claude Code", probes.claudeCodeVersion()),
     fact("Project", project, name),
     fact("Status", status, installed === void 0 ? "new" : "installed"),
-    fact("Plane", probes.planeHost(env))
+    // `Website`, NOT `Plane` (W-3, #868). "Plane" is our internal word for the control
+    // plane; the developer reading this has never heard it, and raw method vocabulary
+    // reaching a client surface is a recorded finding class in this product. The row
+    // answers *which Halfcycle is this*, and an address is the answer they recognise.
+    fact("Website", probes.websiteHost(env))
   ].filter((f) => f !== void 0);
   return {
     head: `halfcycle@${name}`,
@@ -3509,7 +3565,7 @@ ${USAGE}`);
       const controlOrigin = resolveControlOrigin(process.env);
       const serviceUrl = controlOrigin.origin;
       if (verbose || controlOrigin.source !== "default") {
-        process.stdout.write(`[halfcycle] Halfcycle plane: ${controlOriginNote(controlOrigin)}
+        process.stdout.write(`[halfcycle] Halfcycle service: ${controlOriginNote(controlOrigin)}
 `);
       }
       const pinned = readPinnedEngagement(targetRepo);
@@ -3536,7 +3592,7 @@ ${USAGE}`);
 `);
         }
       } else if (requestedId !== void 0) {
-        const joined = await joinPinnedEngagement(serviceUrl, requestedId, targetRepo, { assumeYes });
+        const joined = await joinPinnedEngagement(serviceUrl, requestedId, targetRepo, { assumeYes, verbose });
         engagementId = joined.engagementId;
         actingAccountId = joined.actingAccountId;
         credential = {
@@ -3555,7 +3611,7 @@ ${USAGE}`);
 `);
         }
       } else {
-        const created = await createOwnedEngagement(serviceUrl, targetRepo, { assumeYes });
+        const created = await createOwnedEngagement(serviceUrl, targetRepo, { assumeYes, verbose });
         engagementId = created.engagementId;
         actingAccountId = created.actingAccountId;
         credential = {
@@ -3637,7 +3693,7 @@ ${USAGE}`);
       const identity = await describeAccount(credential.serviceUrl, credential.token);
       const written = result.writtenPaths.length;
       const merged = result.mergedPaths.length;
-      process.stdout.write(`[halfcycle] Signed in as ${accountLabel(identity, actingAccountId)}
+      process.stdout.write(`[halfcycle] Signed in as ${accountLabel(identity, actingAccountId, verbose)}
 `);
       process.stdout.write(`[halfcycle] Found: ${foundLine}
 `);