@mutmutco/installer-face 0.2.0 → 0.2.3

package/README.md

@@ -36,6 +36,23 @@ console.log(face.signOff());
 Colour is a DECISION the caller passes in, never sniffed here: the same face is used by processes
 whose stdout is a pipe, and a face drawn into a pipe is the bug this package exists to prevent.
 
+### Self re-exec continuation
+
+A process that re-execs itself onto an inherited console sets `MM_FACE_CONTINUES` to the
+comma-separated phase names already drawn. `createFace` reads it directly: `welcome()` returns no
+lines, and each `face.continues(phase, kind)` consumes one inherited phase. A failure always returns
+false and consumes the inherited phase, so neither it nor a later retry can be hidden.
+
+```ts
+if (!face.continues('preflight', result.ok ? 'ok' : 'fail')) {
+  console.log(face.step('preflight', result.seconds, result.ok ? 'ok' : 'fail'));
+}
+```
+
+The optional `env` input exists for tests; normal callers use `process.env`. Missing or empty means a
+fresh face. Only an inheriting spawn sets the variable — never a person starting a wrapped command
+on a fresh console.
+
 ### Served one-liners
 
 A `curl … | sh` or `irm … | iex` script cannot import npm, so the package emits the block instead:

package/dist/face.d.ts

@@ -41,8 +41,10 @@ export type StepKind = 'ok' | 'fail' | 'note';
 export interface Face {
     readonly identity: ProductIdentity;
     readonly width: number;
-    /** `◆ <product> — Mutatis Mutandis` and the product's own warm line. */
+    /** `◆ <product> — Mutatis Mutandis` and the product's own warm line; empty on a continuation. */
     welcome(): string[];
+    /** Consume one phase inherited through MM_FACE_CONTINUES; failures are always new information. */
+    continues(phase: string, kind?: StepKind): boolean;
     /** One durable line for one finished step: glyph, title, and a measured time when truthful. */
     step(title: string, seconds?: number | null, kind?: StepKind): string;
     /** Another program's output, kept inside the face at the step-title column. */
@@ -60,5 +62,7 @@ export interface FaceOptions {
     /** False emits no escape codes at all, so a piped or logged run is byte-stable plain text. */
     color?: boolean;
     columns?: number;
+    /** Injectable only so tests do not mutate process.env; normal callers inherit process.env. */
+    env?: Readonly<NodeJS.ProcessEnv>;
 }
-export declare function createFace({ product, color, columns }: FaceOptions): Face;
+export declare function createFace({ product, color, columns, env }: FaceOptions): Face;

package/dist/index.js

@@ -85,20 +85,26 @@ function wrapWords(text, width) {
   if (line) lines.push(line);
   return lines.length ? lines : [""];
 }
-function createFace({ product, color = false, columns }) {
+function createFace({ product, color = false, columns, env = process.env }) {
   const identity = identityFor(product);
   const width = faceWidth(columns);
   const paint = (sgr, text) => color ? `\x1B[${sgr}m${text}\x1B[0m` : String(text);
   const bar = () => paint(PALETTE.muted, GLYPH.bar);
   const indent = " ".repeat(TITLE_COLUMN - 1);
-  const welcome = () => [
+  const continuedPhases = new Set((env.MM_FACE_CONTINUES ?? "").split(",").map((phase) => phase.trim()).filter(Boolean));
+  const continuesFace = continuedPhases.size > 0;
+  const welcome = () => continuesFace ? [] : [
     `${paint(identity.accent, GLYPH.diamond)}  ${paint(identity.accent, identity.name)} \u2014 Mutatis Mutandis`,
     bar(),
     `${bar()}  ${identity.warm}`,
     bar()
   ];
+  const continues = (phase, kind = "ok") => {
+    const inherited = continuedPhases.delete(String(phase).trim());
+    return kind === "fail" ? false : inherited;
+  };
   const step = (title, seconds = null, kind = "ok") => {
-    const glyph = kind === "fail" ? paint(identity.accent, GLYPH.cross) : kind === "note" ? paint(PALETTE.muted, GLYPH.hollow) : paint(PALETTE.green, GLYPH.check);
+    const glyph = kind === "fail" ? paint(identity.accent, GLYPH.cross) : kind === "note" ? paint(PALETTE.muted, GLYPH.dot) : paint(PALETTE.green, GLYPH.check);
     const time = seconds === null || seconds === void 0 ? "" : paint(PALETTE.muted, `${Math.max(0, Math.round(seconds))}s`);
     const column = Math.min(44, Math.max(0, width - 8));
     const reserved = time ? 6 : 0;
@@ -112,21 +118,21 @@ function createFace({ product, color = false, columns }) {
     const body = (Array.isArray(lines) ? lines : String(lines).split("\n")).flatMap((raw) => {
       const line = String(raw);
       if (visibleWidth(line) <= width - 6) return [line];
-      const lead = /^\s*/u.exec(line)?.[0] ?? "";
-      return wrapWords(line, width - 6 - lead.length).map((part) => `${lead}${part}`);
+      return wrapWords(line, width - 6);
     });
     const content = Math.min(width - 6, Math.max(...body.map(visibleWidth)));
     const rule = paint(identity.accent, GLYPH.rule.repeat(content + 4));
     const frame = (left, right) => `${paint(identity.accent, left)}${rule}${paint(identity.accent, right)}`;
+    const bodyRow = (line) => line.startsWith(GLYPH.check) ? `${paint(PALETTE.green, GLYPH.check)}${line.slice(1)}` : line;
     return [
       frame(GLYPH.boxTop, GLYPH.boxTopEnd),
-      ...body.map((line) => `${paint(identity.accent, GLYPH.bar)}  ${line}${" ".repeat(Math.max(0, content - visibleWidth(line)))}  ${paint(identity.accent, GLYPH.bar)}`),
+      ...body.map((line) => `${paint(identity.accent, GLYPH.bar)}  ${bodyRow(line)}${" ".repeat(Math.max(0, content - visibleWidth(line)))}  ${paint(identity.accent, GLYPH.bar)}`),
       frame(GLYPH.boxBottom, GLYPH.boxBottomEnd)
     ];
   };
   const signOff = () => `${paint(identity.accent, GLYPH.diamond)}  ${paint(identity.accent, `${identity.name} \xB7 Mutatis Mutandis`)}`;
   const refusal = (message) => `${bar()}  ${paint(identity.accent, GLYPH.cross)}  ${message}`;
-  return { identity, width, welcome, step, relay, receipt, signOff, refusal, paint };
+  return { identity, width, welcome, continues, step, relay, receipt, signOff, refusal, paint };
 }
 
 // src/shell.ts
@@ -199,10 +205,15 @@ face_rule() {
 }
 
 # face_receipt <headline> <next command> <location> \u2014 the closing box.
+#
+# The PACKAGE owns the box's internal left edge (#6859): body rows sit at the column right after the
+# frame bar's two spaces \u2014 the SAME column the headline's check occupies \u2014 so the box reads as one
+# block. No body string carries its own indent; the four spaces that used to sit here were the empty
+# glyph column the owner read as stray indentation.
 face_receipt() {
   face_text1="$1"
-  face_text2="    Installed into $3"
-  face_text3="    Check health any time:  $2"
+  face_text2="Installed into $3"
+  face_text3="Check health any time:  $2"
   face_w1=$(( \${#face_text1} + 3 ))
   face_w=$face_w1
   [ \${#face_text2} -gt "$face_w" ] && face_w=\${#face_text2}
@@ -322,8 +333,8 @@ function Write-FaceRelay {
 function Write-FaceReceipt {
     param([string] $Location, [string] $Next)
     $first = [string] $FaceCheck + '  ' + $FaceName + ' is ready.'
-    $second = '    Installed into ' + $Location
-    $third = '    Check health any time:  ' + $Next
+    $second = 'Installed into ' + $Location
+    $third = 'Check health any time:  ' + $Next
     $inner = ($first.Length, $second.Length, $third.Length | Measure-Object -Maximum).Maximum
     $rule = [string]::new([char] 0x2500, $inner + 4)
     Write-Host (Write-Paint $FaceAccent ([string] [char] 0x256D + $rule + [char] 0x256E))
@@ -391,8 +402,8 @@ function renderRows(face, rows) {
     const body = `${clip(subject, column).padEnd(column)}  ${row.mark ? `${markGlyph(face, row.mark)}  ` : ""}${tail}`;
     lines.push(...face.relay(body).split("\n"));
     if (row.note) {
-      for (const part of wrapWords(row.note, Math.max(16, face.width - column - 10))) {
-        lines.push(...face.relay(`${" ".repeat(column)}  ${part}`).split("\n"));
+      for (const part of wrapWords(row.note, Math.max(16, face.width - TITLE_COLUMN))) {
+        lines.push(...face.relay(part).split("\n"));
       }
     }
   }
@@ -418,7 +429,7 @@ function createSpinner(face, { animate, stream = process.stderr, intervalMs = 90
   };
   const draw = () => {
     if (!animate) return;
-    const line = face.step(text, null, "note").split("\n")[0].replace(GLYPH.hollow, FRAMES[frame % FRAMES.length]);
+    const line = face.step(text, null, "note").split("\n")[0].replace(GLYPH.dot, FRAMES[frame % FRAMES.length]);
     stream.write(`\r\x1B[2K${line}`);
     frame += 1;
   };
@@ -461,6 +472,9 @@ function assertFaceConformance(lines, options) {
   const width = options.columns ?? 100;
   const rendered = lines.flatMap((line) => String(line).split("\n"));
   const plain = rendered.map(stripColor);
+  const head = plain[0] ?? "";
+  const signOffLine = `${GLYPH.diamond}  ${identity.name} \xB7 Mutatis Mutandis`;
+  const opensWithWelcome = head.startsWith(GLYPH.diamond) && head !== signOffLine;
   if (rendered.length === 0) fail("R7 render before you ship", "no rendered lines were given to the guard");
   if (options.tty === false) {
     for (const line of plain) {
@@ -472,6 +486,11 @@ function assertFaceConformance(lines, options) {
     }
     return;
   }
+  for (const line of plain) {
+    if (line.startsWith(`${GLYPH.bar}  ${GLYPH.hollow}  `)) {
+      fail("note step uses U+25CF", `U+25C7 is the note-box opener in ${JSON.stringify(line)}`);
+    }
+  }
   for (const line of plain) {
     if (/[\u25c6\u25c7\u2714\u2716\u25cf] (?! )/u.test(line)) {
       fail("R4 two spaces after a glyph", `a single space follows the glyph in ${JSON.stringify(line)}`);
@@ -494,7 +513,7 @@ function assertFaceConformance(lines, options) {
     if (widths.size !== 1) fail("R5 receipt frame", `the box is ragged: widths ${[...widths].join(", ")}`);
   }
   const inReceipt = (index) => top !== -1 && index >= top && index <= plain.findIndex((line, at) => at > top && line.startsWith(GLYPH.boxBottom));
-  const welcomeEnd = (plain[0] ?? "").startsWith(GLYPH.diamond) ? 4 : 0;
+  const welcomeEnd = opensWithWelcome ? 4 : 0;
   for (const [index, line] of plain.entries()) {
     if (index < welcomeEnd || inReceipt(index)) continue;
     if (!line.startsWith(GLYPH.bar) || line.trim() === GLYPH.bar) continue;
@@ -522,8 +541,7 @@ function assertFaceConformance(lines, options) {
       fail("width cap", `a line is ${visibleWidth(line)} columns wide, cap ${width}: ${JSON.stringify(line)}`);
     }
   }
-  const head = plain[0] ?? "";
-  if (head.startsWith(GLYPH.diamond)) {
+  if (opensWithWelcome) {
     const expected = `${GLYPH.diamond}  ${identity.name} \u2014 Mutatis Mutandis`;
     if (head !== expected) fail("welcome is the product table's", `expected ${JSON.stringify(expected)}, got ${JSON.stringify(head)}`);
     const warm = plain.slice(1, 4).find((line) => line.includes(identity.warm));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/installer-face",
-  "version": "0.2.0",
+  "version": "0.2.3",
   "description": "The MM Terminal Line installer face: one renderer, the canonical product table, shell/PowerShell fragments for served one-liners, and the drift guard every surface runs.",
   "type": "module",
   "license": "UNLICENSED",