@popoverinstall/cli 0.4.1 → 0.6.0

package/dist/login.d.ts

@@ -1,3 +1,10 @@
+export interface LoginOptions {
+    /**
+     * Continue an existing trunk rather than opening one. Set when `popover welcome` has
+     * already drawn the frame this login is happening inside.
+     */
+    framed?: boolean;
+}
 /**
  * Device authorization flow.
  *
@@ -6,5 +13,5 @@
  * long-lived credential is in transit. The separate device code authenticates polling
  * and is discarded once claimed.
  */
-export declare function login(apiUrl: string): Promise<number>;
+export declare function login(apiUrl: string, opts?: LoginOptions): Promise<number>;
 //# sourceMappingURL=login.d.ts.map

package/dist/login.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../src/login.ts"],"names":[],"mappings":"AASA;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4G3D"}
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../src/login.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiIpF"}

package/dist/login.js

@@ -1,8 +1,10 @@
 import { createHash, randomBytes } from "node:crypto";
 import os from "node:os";
 import { saveCredentials } from "@popoverinstall/shared";
-import { c, dim, info, ok, bad, openBrowser } from "./ui.js";
+import { openBrowser } from "./ui.js";
 import { askDaemon } from "./ipc-client.js";
+import { nextSteps } from "./next-steps.js";
+import { box, line, spinner, step, stepFail, style, trunk } from "./theme.js";
 const sha256 = (v) => createHash("sha256").update(v, "utf8").digest("hex");
 const secret = () => randomBytes(32).toString("base64url");
 /**
@@ -13,9 +15,11 @@ const secret = () => randomBytes(32).toString("base64url");
  * long-lived credential is in transit. The separate device code authenticates polling
  * and is discarded once claimed.
  */
-export async function login(apiUrl) {
+export async function login(apiUrl, opts = {}) {
     const deviceToken = secret();
     const deviceCode = secret();
+    if (!opts.framed)
+        console.log("");
     let start;
     try {
         const res = await fetch(`${apiUrl}/api/device/start`, {
@@ -29,34 +33,38 @@ export async function login(apiUrl) {
             }),
         });
         if (!res.ok) {
-            bad(`Could not start login (${res.status}). Is ${apiUrl} reachable?`);
+            stepFail(`Could not start login (${res.status}). Is ${apiUrl} reachable?`);
             return 1;
         }
         start = (await res.json());
     }
     catch (err) {
-        bad(`Could not reach ${apiUrl}: ${err instanceof Error ? err.message : String(err)}`);
+        stepFail(`Could not reach ${apiUrl}: ${err instanceof Error ? err.message : String(err)}`);
         return 1;
     }
-    console.log("");
-    info("Confirm this code in your browser:");
-    console.log("");
-    console.log(`      ${c.bold(c.cyan(start.user_code))}`);
-    console.log("");
-    dim(start.verify_url);
-    console.log("");
+    box({
+        title: "Confirm this code in your browser",
+        lines: ["", style.bold(style.cyan(start.user_code)), "", style.dim(start.verify_url)],
+        minWidth: 36,
+    });
+    trunk();
+    step("Opening your browser…");
     await openBrowser(start.verify_url_complete);
+    trunk();
     const intervalMs = (start.poll_interval_seconds ?? 2) * 1000;
     const deadline = Date.parse(start.expires_at);
-    process.stdout.write(c.dim("  Waiting for approval"));
+    // The spinner is the liveness signal the row of dots used to be. It also carries the
+    // deadline: a code that quietly expires while someone is hunting for their password is
+    // the one failure in this flow that looks like a hang.
+    const spin = spinner("Waiting for you to approve…");
     for (;;) {
         if (Date.now() > deadline) {
-            console.log("");
-            bad("That code expired. Run `popover login` again.");
+            spin.clear();
+            stepFail("That code expired. Run `popover login` again.");
             return 1;
         }
         await sleep(intervalMs);
-        process.stdout.write(c.dim("."));
+        spin.update(`Waiting for you to approve…  ${style.dim(`${remaining(deadline)} left`)}`);
         let status;
         try {
             const res = await fetch(`${apiUrl}/api/device/poll`, {
@@ -71,21 +79,32 @@ export async function login(apiUrl) {
         }
         if (status.status === "pending")
             continue;
-        console.log("");
         if (status.status === "denied") {
-            bad("Login denied. Nothing was connected.");
+            spin.clear();
+            stepFail("Login denied. Nothing was connected.");
+            return 1;
+        }
+        // The server expires codes on its own schedule, so this arrives slightly before the local
+        // deadline check above would have fired. Same situation, so it gets the same sentence
+        // rather than the generic one, which rendered as "Login expired.".
+        if (status.status === "expired") {
+            spin.clear();
+            stepFail("That code expired. Run `popover login` again.");
             return 1;
         }
         if (status.status !== "approved" || !status.machine_id) {
-            bad(`Login ${status.status}. Run \`popover login\` again.`);
+            spin.clear();
+            stepFail(`Login ${status.status}. Run \`popover login\` again.`);
             return 1;
         }
+        spin.update("Connecting this machine…");
         // Immediately exercise the token so a broken backend config surfaces now, at a
         // prompt, rather than later inside a detached daemon.
         const session = await exchange(apiUrl, deviceToken);
         if (!session) {
-            bad("Connected, but the machine could not obtain an access token.");
-            dim("Check SUPABASE_JWT_SECRET on the server, then run `popover doctor`.");
+            spin.clear();
+            stepFail("Connected, but the machine could not obtain an access token.");
+            line(style.dim("Check SUPABASE_JWT_SECRET on the server, then run `popover doctor`."));
             return 1;
         }
         saveCredentials({
@@ -100,12 +119,21 @@ export async function login(apiUrl) {
         // `popover login` the next time they open /team. Best effort: no daemon is fine, the
         // next start reads the file anyway.
         await askDaemon({ t: "ping", id: "login" }, 5_000);
-        ok("This machine is connected.");
-        dim("Your Claude Code sessions will appear to your team while they are running.");
-        dim("Run `/team` inside Claude Code to see everyone.");
+        spin.stop(style.bold("This machine is connected."));
+        line(style.dim("Your Claude Code sessions will appear to your team while they are running."));
+        // Connecting a machine is the same milestone however it was reached, so a bare
+        // `popover login` gets the same send-off. When welcome() is driving it prints this itself,
+        // once, after this returns.
+        if (!opts.framed)
+            nextSteps();
         return 0;
     }
 }
+/** Time left on the code, as mm:ss — the shape a countdown is read in. */
+function remaining(deadline) {
+    const seconds = Math.max(0, Math.round((deadline - Date.now()) / 1000));
+    return `${Math.floor(seconds / 60)}:${String(seconds % 60).padStart(2, "0")}`;
+}
 async function exchange(apiUrl, deviceToken) {
     try {
         const res = await fetch(`${apiUrl}/api/device/session`, {

package/dist/login.js.map

@@ -1 +1 @@
-{"version":3,"file":"login.js","sourceRoot":"","sources":["../src/login.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../src/login.ts"],"names":[],"mappings":"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"}

package/dist/next-steps.d.ts

@@ -0,0 +1,18 @@
+/**
+ * What to do now that the machine is connected.
+ *
+ * Its own module because both entry points end here: `popover welcome`, which the installer
+ * hands off to, and a bare `popover login` run later. Connecting a machine is the same milestone
+ * either way, so it gets the same send-off — and login.ts cannot import this from welcome.ts,
+ * which imports login.ts.
+ */
+/**
+ * The product name as people see it. The installers print it too — they are separate templates
+ * in apps/web/src/lib/install-script*.ts, so that string is paired with this one rather than
+ * shared.
+ */
+export declare const BRAND = "Popover";
+export declare const TAGLINE = "The first multiplayer coding experience.";
+export declare const TAGLINE_SECONDARY = "Let your team's AI agents communicate and collaborate with each other.";
+export declare function nextSteps(): void;
+//# sourceMappingURL=next-steps.d.ts.map

package/dist/next-steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-steps.d.ts","sourceRoot":"","sources":["../src/next-steps.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;GAIG;AACH,eAAO,MAAM,KAAK,YAAY,CAAC;AAC/B,eAAO,MAAM,OAAO,6CAA6C,CAAC;AAClE,eAAO,MAAM,iBAAiB,2EAC4C,CAAC;AAoB3E,wBAAgB,SAAS,IAAI,IAAI,CAoChC"}

package/dist/next-steps.js

@@ -0,0 +1,73 @@
+/**
+ * What to do now that the machine is connected.
+ *
+ * Its own module because both entry points end here: `popover welcome`, which the installer
+ * hands off to, and a bare `popover login` run later. Connecting a machine is the same milestone
+ * either way, so it gets the same send-off — and login.ts cannot import this from welcome.ts,
+ * which imports login.ts.
+ */
+import { badge, box, glyph, line, step, style, trunk, wrap } from "./theme.js";
+/**
+ * The product name as people see it. The installers print it too — they are separate templates
+ * in apps/web/src/lib/install-script*.ts, so that string is paired with this one rather than
+ * shared.
+ */
+export const BRAND = "Popover";
+export const TAGLINE = "The first multiplayer coding experience.";
+export const TAGLINE_SECONDARY = "Let your team's AI agents communicate and collaborate with each other.";
+/**
+ * Things the agent can genuinely do, phrased the way someone would actually type them.
+ *
+ * Checked against what the plugin actually exposes — two tools, `team_list` and `team_ask` —
+ * rather than invented to sound capable. Suggesting anything else here would be the CLI
+ * teaching people a command that fails: the agent can see which teammates are active in this
+ * repo, and it can put one question to a teammate's agent, which a read-only copy answers.
+ * That is the whole surface.
+ *
+ * One per tool, then one that uses both — which is the pattern worth teaching, since asking
+ * without listing first means guessing at a handle.
+ */
+const ASK_EXAMPLES = [
+    `Ask ${BRAND} who on my team is working in this repo right now.`,
+    `Ask ${BRAND} to ask G1 why they ruled out Redis for the roster cache.`,
+    `Ask ${BRAND} who knows this service, then ask their agent how retries work.`,
+];
+export function nextSteps() {
+    // Wrapped to the window, like the welcome box, and before styling — `wrap` counts
+    // characters, so escape codes would be measured as content.
+    const room = Math.max(28, (process.stdout.columns ?? 80) - 8);
+    trunk();
+    box({
+        title: badge(`${BRAND} is ready to be toasted!`),
+        lines: [
+            "",
+            ...wrap(`${BRAND} can now communicate with your team's agents.`, room).map(style.bold),
+            ...wrap("These commands make it excruciatingly easy to get started.", room).map(style.dim),
+            "",
+        ],
+        minWidth: 36,
+    });
+    trunk();
+    step("Pick a starting point");
+    bullet(`${style.bold("/popover:team")}   ${style.dim("run it in any Claude Code session")}`);
+    bullet(`${style.bold("popover doctor")}  ${style.dim("if something looks wrong")}`);
+    trunk();
+    step("Ask your coding agent");
+    for (const example of ASK_EXAMPLES) {
+        // Continuation lines are indented, so a wrapped quote still reads as one quote.
+        const [first, ...rest] = wrap(`"${example}"`, room);
+        line(style.dim(first ?? ""));
+        for (const more of rest)
+            line(style.dim(`  ${more}`));
+    }
+    trunk();
+    line(style.dim("Restart Claude Code for the plugin to load."));
+    trunk();
+    line(style.amber("Happy popping!"));
+    console.log("");
+}
+/** A bulleted line hanging off the trunk. */
+function bullet(text) {
+    console.log(`${style.dim(glyph.trunk)}  ${style.dim(glyph.dot)} ${text}`);
+}
+//# sourceMappingURL=next-steps.js.map

package/dist/next-steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-steps.js","sourceRoot":"","sources":["../src/next-steps.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC;AAC/B,MAAM,CAAC,MAAM,OAAO,GAAG,0CAA0C,CAAC;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAC5B,wEAAwE,CAAC;AAE3E;;;;;;;;;;;GAWG;AACH,MAAM,YAAY,GAAG;IACnB,OAAO,KAAK,oDAAoD;IAChE,OAAO,KAAK,2DAA2D;IACvE,OAAO,KAAK,iEAAiE;CAC9E,CAAC;AAEF,MAAM,UAAU,SAAS;IACvB,kFAAkF;IAClF,4DAA4D;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAE9D,KAAK,EAAE,CAAC;IACR,GAAG,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,GAAG,KAAK,0BAA0B,CAAC;QAChD,KAAK,EAAE;YACL,EAAE;YACF,GAAG,IAAI,CAAC,GAAG,KAAK,+CAA+C,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YACtF,GAAG,IAAI,CAAC,4DAA4D,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;YAC1F,EAAE;SACH;QACD,QAAQ,EAAE,EAAE;KACb,CAAC,CAAC;IAEH,KAAK,EAAE,CAAC;IACR,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,mCAAmC,CAAC,EAAE,CAAC,CAAC;IAC7F,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC;IAEpF,KAAK,EAAE,CAAC;IACR,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,gFAAgF;QAChF,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,OAAO,GAAG,EAAE,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,EAAE,CAAC;IACR,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC,CAAC;IAC/D,KAAK,EAAE,CAAC;IACR,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,6CAA6C;AAC7C,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/dist/scene.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The welcome scene: the aardvark standing in some grass, under a sky.
+ *
+ * Same half-block bitmap trick as the aardvark itself — two stacked pixels per terminal cell
+ * via U+2580, foreground painting the top pixel and background the bottom — but over one
+ * shared canvas with a palette, so the moon, the clouds and the grass can each have their own
+ * colour while still sharing cells with whatever they overlap.
+ *
+ * The sky follows the clock: a crescent moon and stars at night, a sun during the day. Beyond
+ * being a nice touch, it means the scene someone sees at 2am is not pretending it is midday.
+ *
+ * Stars are the one exception to the bitmap: they are `*` glyphs rather than blocks, because a
+ * star drawn as a half-block is a rectangle. Any cell containing one is rendered as the glyph
+ * instead of as pixels.
+ */
+/** Total columns the scene needs, trunk and indent included. */
+export declare const SCENE_COLUMNS: number;
+export interface SceneOptions {
+    /** Columns available. A scene wider than the window is worse than no scene. */
+    columns?: number;
+    /** Overridden by the tests and by `--night` / `--day`; otherwise read off the clock. */
+    night?: boolean;
+    indent?: number;
+    /**
+     * Whether half blocks are safe to emit. Defaults to what the terminal announced.
+     *
+     * An override for the same reason `night` is one: the ambient value is environmental, and a
+     * test that reads it asserts against whatever terminal happens to run it — passing on a
+     * developer's Windows Terminal and failing on a bare CI runner, where no
+     * `WT_SESSION`/`TERM_PROGRAM` means ASCII and the scene is empty by design.
+     */
+    unicode?: boolean;
+}
+/**
+ * The scene as terminal rows, each prefixed with the trunk so it hangs off the same vertical
+ * line as the rest of the flow.
+ *
+ * Returns an empty array when the terminal has not told us it speaks UTF-8 — half blocks come
+ * out as replacement characters there — and null when the window is too narrow, which is the
+ * caller's cue to fall back to the aardvark on its own.
+ */
+export declare function sceneLines(opts?: SceneOptions): string[] | null;
+//# sourceMappingURL=scene.d.ts.map

package/dist/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../src/scene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,gEAAgE;AAChE,eAAO,MAAM,aAAa,QAAY,CAAC;AAsPvC,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,YAAiB,GAAG,MAAM,EAAE,GAAG,IAAI,CAqBnE"}

package/dist/scene.js

@@ -0,0 +1,276 @@
+/**
+ * The welcome scene: the aardvark standing in some grass, under a sky.
+ *
+ * Same half-block bitmap trick as the aardvark itself — two stacked pixels per terminal cell
+ * via U+2580, foreground painting the top pixel and background the bottom — but over one
+ * shared canvas with a palette, so the moon, the clouds and the grass can each have their own
+ * colour while still sharing cells with whatever they overlap.
+ *
+ * The sky follows the clock: a crescent moon and stars at night, a sun during the day. Beyond
+ * being a nice touch, it means the scene someone sees at 2am is not pretending it is midday.
+ *
+ * Stars are the one exception to the bitmap: they are `*` glyphs rather than blocks, because a
+ * star drawn as a half-block is a rectangle. Any cell containing one is rendered as the glyph
+ * instead of as pixels.
+ */
+import { AARDVARK_SPRITE } from "./aardvark.js";
+import { AMBER_INK, AMBER_WASH, colorEnabled, glyph, style, unicodeEnabled } from "./theme.js";
+const WIDTH = 64;
+/** Two pixel rows per terminal row, so this must stay even. */
+const HEIGHT = 20;
+/** Total columns the scene needs, trunk and indent included. */
+export const SCENE_COLUMNS = WIDTH + 3;
+// ------------------------------------------------------------------ sky art
+/**
+ * The moon, at cell resolution and in two tones.
+ *
+ * Coverage per cell is supersampled against a crescent — a disc of radius 7 with a radius-5 disc
+ * bitten out of it, offset 2.5 — then quantised: mostly covered becomes a solid block, partly
+ * covered becomes stipple. That is what produces the soft two-tone edge and the detached tips at
+ * the horns, rather than them being drawn in.
+ *
+ * Cell resolution rather than pixels because a cell is roughly twice as tall as it is wide, so a
+ * round moon needs twice as many columns as rows — 14 by 7 — and because the stipple is a
+ * character, which cannot be half a cell tall.
+ *
+ * Mirrored from the reference so it opens back towards the aardvark.
+ */
+// prettier-ignore
+const MOON = [
+    "...dMMMMMMd...",
+    "..d...ddMMMMM.",
+    ".........MMMMM",
+    ".........dMMMM",
+    ".........MMMMM",
+    "..d...ddMMMMM.",
+    "...dMMMMMMd...",
+];
+/**
+ * Disc and eight rays, on the moon's footprint so the sky does not reflow at dawn.
+ *
+ * Drawn by hand. Generating the rays as an arc cut into spokes produced confetti — at this
+ * size every ray has to be placed, not derived.
+ */
+// prettier-ignore
+const SUN = [
+    "......ss......",
+    "......ss......",
+    "..s........s..",
+    ".....ssss.....",
+    "....ssssss....",
+    "...ssssssss...",
+    "ss.ssssssss.ss",
+    "ss.ssssssss.ss",
+    "...ssssssss...",
+    "....ssssss....",
+    ".....ssss.....",
+    "..s........s..",
+    "......ss......",
+    "......ss......",
+];
+/*
+ * Clouds are stippled rather than solid, and drawn at cell resolution rather than in pixels.
+ *
+ * A cloud is the one thing here made of a character instead of blocks: U+2591 LIGHT SHADE, whose
+ * dot grid is the texture in the reference. That means a cloud cannot be half a cell tall, so its
+ * art is one row per terminal row and `stampCells` writes it to both pixel rows of each — which
+ * is also why the silhouettes are stepped mesas rather than curves. It is the shape the medium
+ * wants.
+ */
+// prettier-ignore
+const CLOUD_BIG = [
+    "......cccc....",
+    "..ccc.ccccccc.",
+    "cccccccccccccc",
+];
+// prettier-ignore
+const CLOUD_SMALL = [
+    "...cccc...",
+    "cccccccccc",
+];
+/**
+ * Where the stars go. Placed by hand to sit in the gaps rather than on top of anything, and all
+ * above the skyline — a star down at grass height reads as a dropped asterisk.
+ */
+const STARS = [
+    [36, 0],
+    [42, 1],
+    [47, 0],
+    [49, 5],
+    [63, 6],
+    [35, 7],
+    [41, 8],
+    [48, 9],
+];
+/**
+ * Strand heights in pixels, cycled across the ground.
+ *
+ * Paired with uneven gaps below. Heights alone are not enough — strands on a fixed 2px pitch
+ * read as a picket fence however much their tops vary.
+ */
+const GRASS_HEIGHTS = [3, 5, 2, 4, 3, 2, 5, 3, 4, 2, 3, 5, 2, 4, 3, 2, 4, 3, 5, 2];
+/** Columns to skip before the next strand. */
+const GRASS_GAPS = [2, 3, 2, 2, 3, 2, 4, 2];
+/** Grass starts clear of the aardvark's hind legs and runs to the edge. */
+const GRASS_FROM = 35;
+// ------------------------------------------------------------------ palette
+const RESET = "\x1b[0m";
+/** Moonlight: the solid blocks and the stippled edge share it. */
+const MOONLIGHT = "\x1b[37m";
+/** Foreground codes per palette key. The aardvark keeps the terminal's own dark red. */
+const INK = {
+    "1": "\x1b[31m", // aardvark body
+    "4": "\x1b[97m", // its eye
+    s: AMBER_INK, // the sun, in the same amber as the rest of the flow
+    c: "\x1b[90m", // cloud
+    g: "\x1b[32m", // grass
+};
+/** Background codes, for the lower pixel of a cell. */
+const WASH = {
+    "1": "\x1b[41m",
+    "4": "\x1b[107m",
+    s: AMBER_WASH,
+    c: "\x1b[100m",
+    g: "\x1b[42m",
+};
+const UPPER = "▀";
+const LOWER = "▄";
+const FULL = "█";
+const STAR = "*";
+/** U+2591 LIGHT SHADE. Its dot grid is the cloud texture from the reference. */
+const SHADE = "░";
+// ------------------------------------------------------------------ compose
+function stamp(canvas, art, ox, oy) {
+    art.forEach((row, y) => [...row].forEach((ch, x) => {
+        if (ch === ".")
+            return;
+        const cy = oy + y;
+        const cx = ox + x;
+        if (cy < 0 || cy >= HEIGHT || cx < 0 || cx >= WIDTH)
+            return;
+        canvas[cy][cx] = ch;
+    }));
+}
+/**
+ * Stamp art whose rows are terminal rows rather than pixel rows, by writing each to both pixels
+ * of its cell. For anything drawn as a character, where half a cell is not a thing.
+ */
+function stampCells(canvas, art, ox, oy) {
+    art.forEach((row, y) => {
+        [...row].forEach((ch, x) => {
+            if (ch === ".")
+                return;
+            const cx = ox + x;
+            if (cx < 0 || cx >= WIDTH)
+                return;
+            for (const cy of [oy + y * 2, oy + y * 2 + 1]) {
+                if (cy >= 0 && cy < HEIGHT)
+                    canvas[cy][cx] = ch;
+            }
+        });
+    });
+}
+/**
+ * Build the canvas. Back to front, so the aardvark and the grass sit over the sky rather than
+ * being punched through by it.
+ */
+function compose(night) {
+    const canvas = Array.from({ length: HEIGHT }, () => Array(WIDTH).fill("."));
+    // Top right corner. Both are 14 wide, so the sun's disc and the moon's limb land in the same
+    // place — the sky does not shift at dawn.
+    if (night)
+        stampCells(canvas, MOON, WIDTH - 14, 0);
+    else
+        stamp(canvas, SUN, WIDTH - 14, 0);
+    // Cell rows 1-3 and 5-6, kept clear of the moon so neither sits on the other.
+    stampCells(canvas, CLOUD_BIG, 34, 2);
+    stampCells(canvas, CLOUD_SMALL, 38, 10);
+    // Stars only at night, and only where nothing else already is.
+    if (night) {
+        for (const [x, y] of STARS) {
+            if (canvas[y]?.[x] === ".")
+                canvas[y][x] = "*";
+        }
+    }
+    /*
+     * A continuous ground line with strands rising out of it. Strands alone, however uneven, read
+     * as a picket fence — it is the unbroken base that turns them into grass growing on something.
+     * The line sits on the aardvark's own footing: the sprite's legs end on this row too.
+     */
+    for (let x = GRASS_FROM; x < WIDTH; x += 1)
+        canvas[HEIGHT - 1][x] = "g";
+    for (let x = GRASS_FROM, i = 0; x < WIDTH; i += 1) {
+        const height = GRASS_HEIGHTS[i % GRASS_HEIGHTS.length];
+        for (let y = HEIGHT - height; y < HEIGHT; y += 1)
+            canvas[y][x] = "g";
+        x += GRASS_GAPS[i % GRASS_GAPS.length];
+    }
+    stamp(canvas, AARDVARK_SPRITE, 0, 0);
+    return canvas;
+}
+/** The sun is up between six in the morning and six at night. Close enough for a sky. */
+function isNight(at = new Date()) {
+    const hour = at.getHours();
+    return hour < 6 || hour >= 18;
+}
+// ------------------------------------------------------------------ render
+function paint(top, bottom) {
+    if (top === "*" || bottom === "*") {
+        // A star is a glyph, not a pixel pair. Rendered dim so it reads as distant.
+        return colorEnabled ? `${INK.c}${STAR}${RESET}` : STAR;
+    }
+    /*
+     * Everything drawn as a character rather than as a pixel pair is resolved first: clouds and the
+     * moon's stipple. All are stamped at cell resolution, so there is never half of one to draw.
+     */
+    if (top === "c" || bottom === "c") {
+        return colorEnabled ? `${INK.c}${SHADE}${RESET}` : SHADE;
+    }
+    if (top === "M" || bottom === "M") {
+        return colorEnabled ? `${MOONLIGHT}${FULL}${RESET}` : FULL;
+    }
+    if (top === "d" || bottom === "d") {
+        // The stipple reads dimmer than the solid on its own — a quarter of the cell is lit — so it
+        // needs no separate colour to sit behind the edge.
+        return colorEnabled ? `${MOONLIGHT}${SHADE}${RESET}` : SHADE;
+    }
+    if (top === "." && bottom === ".")
+        return " ";
+    if (!colorEnabled) {
+        // Nothing to tell the layers apart with, so fall back to shape alone.
+        return top === "." ? LOWER : bottom === "." ? UPPER : FULL;
+    }
+    if (bottom === ".")
+        return `${INK[top] ?? ""}${UPPER}${RESET}`;
+    if (top === ".")
+        return `${INK[bottom] ?? ""}${LOWER}${RESET}`;
+    return `${INK[top] ?? ""}${WASH[bottom] ?? ""}${UPPER}${RESET}`;
+}
+/**
+ * The scene as terminal rows, each prefixed with the trunk so it hangs off the same vertical
+ * line as the rest of the flow.
+ *
+ * Returns an empty array when the terminal has not told us it speaks UTF-8 — half blocks come
+ * out as replacement characters there — and null when the window is too narrow, which is the
+ * caller's cue to fall back to the aardvark on its own.
+ */
+export function sceneLines(opts = {}) {
+    if (!(opts.unicode ?? unicodeEnabled))
+        return [];
+    const columns = opts.columns ?? process.stdout.columns ?? 80;
+    if (columns < SCENE_COLUMNS)
+        return null;
+    const indent = opts.indent ?? 2;
+    const canvas = compose(opts.night ?? isNight());
+    const rows = [];
+    for (let y = 0; y < HEIGHT; y += 2) {
+        const top = canvas[y];
+        const bottom = canvas[y + 1];
+        let out = "";
+        for (let x = 0; x < WIDTH; x += 1)
+            out += paint(top[x], bottom[x]);
+        rows.push(`${style.dim(glyph.trunk)}${" ".repeat(indent)}${out.replace(/\s+$/, "")}`);
+    }
+    return rows;
+}
+//# sourceMappingURL=scene.js.map

package/dist/scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.js","sourceRoot":"","sources":["../src/scene.ts"],"names":[],"mappings":"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"}

package/dist/snapshot.d.ts

@@ -0,0 +1,2 @@
+export declare function forkCommand(rest: string[]): Promise<number>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AA+DA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBjE"}