8775e25 · 35e0ea1 · 06a5e01 · d4ee51b · 712035b · c6dc57d
@@ -13,25 +13,25 @@
  },
  "repository": {
    "390": {
      "words": 197,
      "blocks": 29,
      "words": 116,
      "blocks": 18,
      "colours": 2
    },
    "1280": {
      "words": 197,
      "blocks": 29,
      "words": 116,
      "blocks": 18,
      "colours": 2
    }
  },
  "app": {
    "390": {
      "words": 197,
      "blocks": 29,
      "words": 116,
      "blocks": 18,
      "colours": 2
    },
    "1280": {
      "words": 197,
      "blocks": 29,
      "words": 116,
      "blocks": 18,
      "colours": 2
    }
  },
@@ -22,8 +22,8 @@
reader sees on first view at 390 px and 1280 px: **words**, **text blocks** and
| Page | 390 px | 1280 px |
|---|---|---|
| home | 95 / 20 / 2 | 95 / 20 / 2 |
| repository | 189 / 28 / 2 | 189 / 28 / 2 |
| app | 189 / 28 / 2 | 189 / 28 / 2 |
| repository | 116 / 18 / 2 | 116 / 18 / 2 |
| app | 116 / 18 / 2 | 116 / 18 / 2 |
| pull | 133 / 22 / 4 | 133 / 22 / 4 |
| issue | 76 / 19 / 2 | 76 / 19 / 2 |
| issues list | 32 / 8 / 2 | 32 / 8 / 2 |
@@ -31,3 +31,7 @@
reader sees on first view at 390 px and 1280 px: **words**, **text blocks** and
| runs | 46 / 8 / 1 | 46 / 8 / 1 |
| run | 34 / 11 / 3 | 34 / 11 / 3 |
| settings | 137 / 32 / 1 | 137 / 32 / 1 |
## App page, calmed (#10299)
A new app that has not run, and has shipped nothing, shows only its progress: the state line (`docs/features/onboarding-line.md`), the box to tell the crew, and Now (`src/web/studio/fresh.ts` judges it). Past that, the empty This week and Crew cards are gone, and the page's second link row (Map, Issues, Pull requests) is gone because the head's tabs already hold them. Before, on the seeded new app: 197 words / 29 blocks (over its 189 / 28 budget on main); after: 116 / 18.
@@ -52,7 +52,6 @@
import {
  listCard,
  row,
} from "../ui.ts";
import { changesHref, tellsHref } from "./nouns.ts";
import { answersRegion } from "./answers.ts";
import { nowCard, nowRegion } from "./now.ts";
import { repoAsks } from "./asks.ts";
@@ -117,9 +116,6 @@
const PREVIEW_LATENCY_MIN = 3;
 */
const FAILED_RATIO_MIN = 5;
/** The start of history, for an "ever" count rather than one week of it. */
const EPOCH = new Date(0).toISOString();
/**
 * How fast a change has reached its preview this week, worded like the
 * reference instant in `servedPhrase` (`web/ui.ts`): "reaches its preview
@@ -276,52 +272,43 @@
export async function studioApp(
      ...sealedScope(db, repo, ctx.auth.user),
    }),
  );
  // A new app that has not run is told apart from one with a past in
  // `appPanels` (`fresh.ts`): its page shows only its progress, so the
  // week's reads below are skipped for it.
  const { head, previews, deployTailing, fresh, history } = timePhase(req, "panels", () =>
    appPanels(ctx, repo, record, openPulls),
  );
  const week = new Date(Date.now() - 7 * 24 * 60 * 60_000).toISOString();
  // What landed this week, counted by the database like the runs and the
  // spend below — a page of closed pulls would stop at a hundred and the
  // cost per shipped change would read high off the short count.
  const shipped = timePhase(req, "shipped", () =>
    mergedPullCount(db, repo.id, week),
  );
  const shipped = fresh
    ? 0
    : timePhase(req, "shipped", () => mergedPullCount(db, repo.id, week));
  // The rest is spend, worked out only for a viewer who is going to see it —
  // counted by the database over the whole week, not off a page of rows.
  const weekTotals = ownerFacts
  const weekTotals = ownerFacts && !fresh
    ? timePhase(req, "spend", () => agentRunTotals(db, repo.id, week))
    : { runs: 0, spentUsd: 0 };
  const spent = weekTotals.spentUsd;
  const ledgerWeek = ownerFacts
  const ledgerWeek = ownerFacts && !fresh
    ? timePhase(req, "decisions", () => decisionStats(db, repo.id, week))
    : [];
  const weekLatency = ownerFacts
  const weekLatency = ownerFacts && !fresh
    ? timePhase(req, "latency", () => previewLatency(db, repo.id, week))
    : undefined;
  // Whether there is any history at all — ever, not this week's — so a
  // fresh app reads as "nothing yet" rather than a stretch of zeros and a
  // scary ratio (#274). A quiet week on an old app still has shipped a
  // change or taken a run at some point; only an app with neither, ever,
  // gets the quieter line. Deploys are not part of this: they happen on
  // their own the moment an app exists, so they say nothing about whether
  // anyone has done anything yet.
  const hasHistory = timePhase(req, "history", () => {
    const everShipped = shipped > 0 || mergedPullCount(db, repo.id, EPOCH) > 0;
    const everRuns = ownerFacts
      ? weekTotals.runs > 0 || agentRunTotals(db, repo.id, EPOCH).runs > 0
      : false;
    return everShipped || everRuns;
  });
  const autonomy =
    !ownerFacts || repo.autonomy === "off"
    !ownerFacts || fresh || repo.autonomy === "off"
      ? undefined
      : timePhase(req, "autonomy", () => autonomyStatus(ctx.app, repo));
  // The governor's reason, one line on the crew card (#7644).
  const governor = timePhase(req, "governor", () => governorSeen(ctx.app, ctx.auth.user, repo, new Date()));
  const governor = fresh
    ? undefined
    : timePhase(req, "governor", () => governorSeen(ctx.app, ctx.auth.user, repo, new Date()));
  // ---- the app itself ----
  // `deployTailing` says the head card is tailing production's own deploy —
  // the "Now" panel's empty-state words below care about that distinction.
  const { head, previews, deployTailing } = timePhase(req, "panels", () =>
    appPanels(ctx, repo, record, openPulls),
  );
  // ---- the box ----
  // Telling the crew, and who takes it, is the owner's own front door — a
@@ -356,6 +343,7 @@
export async function studioApp(
      ownerFacts,
      wordCtx,
      deployTailing,
      previewLinks: fresh,
    }),
  );
@@ -363,19 +351,10 @@
export async function studioApp(
  // Crew, spend and autonomy are the owner's facts; a viewer who cannot
  // write here gets only the shipped count, never the roster, the money or
  // the ledger — and the page never asks for the rest on their behalf.
  const crewCard = !ownerFacts
  // No crew yet: the tell box and the Now row already say so, once.
  const crewCard = !ownerFacts || crew.length === 0
    ? null
    : crew.length === 0
      ? card(
          html`<p class="muted small">
            Nobody yet. <a href="${base}/settings">Add someone.</a>
          </p>`,
          {
            head: html`${icon("bot")}
              <h2>Crew</h2>`,
          },
        )
      : listCard(
    : listCard(
          crew.map((c) =>
            row({
              lead: avatar(c.agent.user.username),
@@ -394,13 +373,9 @@
export async function studioApp(
              ${btn("Change", { href: `${base}/settings`, size: "sm" })}`,
          },
        );
  const weekCard = card(
    !hasHistory
      ? html`<p class="muted small">
          Nothing to show yet — it fills in once a pull request
          ships${ownerFacts ? " or the crew takes a run" : ""}.
        </p>`
      : !ownerFacts
  // No history, no card: an empty week explains itself to nobody.
  const weekCard = !history ? null : card(
    !ownerFacts
        ? html`<dl>
            <dt>Shipped</dt>
            <dd>${shipped} pull request${shipped === 1 ? "" : "s"}</dd>
@@ -475,28 +450,44 @@
export async function studioApp(
      );
  // The rest of the app's environment — its variables, hostname, access and
  // domains — is the admin's, on the app's settings page.
  const more = html`<p class="muted small">
    <a href="${base}/map">The map</a> ·
    <a href="${tellsHref(base)}">Issues</a> ·
    <a href="${changesHref(base)}">Pull requests</a>${when(
      canAdmin(db, repo, ctx.auth.user),
      () => html` · <a href="${base}/settings/app">Environment settings</a>`,
    )}
  </p>`;
  // Issues, Pulls and the map are the head's own tabs; only what it lacks is here.
  const more = canAdmin(db, repo, ctx.auth.user)
    ? html`<p class="muted small"><a href="${base}/settings/app">Environment settings</a></p>`
    : null;
  // An app that follows another says so before anything else: whether it
  // is in step is the first thing its owner wants to know.
  const following = await timePhaseAsync(req, "following", () =>
    followingOf(ctx, repo),
  );
  const policy = await timePhaseAsync(req, "policy", () =>
    policyLine(ctx, repo, record),
  );
  const policy = fresh
    ? null
    : await timePhaseAsync(req, "policy", () => policyLine(ctx, repo, record));
  const adapter = ownerFacts
    ? await timePhaseAsync(req, "adapter", () => adapterCard(ctx, record, repo))
      
        junipercrew
        2d ago
        outdated
      
      Mis-indented, and a double blank line follows. Also, 'Environment settings' vanishes on a fresh app for admins: keep it reachable.
    
    : null;
  const rendering = performance.now();
  const body = html`${repoHeader(ctx, repo, "app", {
  const tellRegion = html`${tell}
        ${ownerFacts && ctx.auth.user ? answersRegion(ctx, repo, ctx.auth.user) : null}`;
  // A new app that has not run yet shows only its progress: the head's
  // state line, the box to tell the crew, and Now. Everything else waits
  // until there is something to show.
  const body = fresh
    ? html`${repoHeader(ctx, repo, "app", { compact: true, ownTitle: true })}
    ${following === undefined
      ? archivedParentLine(ctx, repo)
      : followingCard(ctx, repo, following)}
    <div id="app-head">${head}</div>
    ${ownerFacts ? crewKeyNote(ctx) : null}
    <div class="stack">
      ${adapter}
      ${tellRegion}
      <div id="app-previews"></div>
      ${nowRegion(repo, now)}
      ${more}
    </div>
    ${liveMount({ repo: base, app: true })}`
    : html`${repoHeader(ctx, repo, "app", {
      compact: true,
      ownTitle: true,
    })}
@@ -518,8 +509,7 @@
export async function studioApp(
      : null}
    <div class="split" data-rail="wide">
      <div class="stack">
        ${tell}
        ${ownerFacts && ctx.auth.user ? answersRegion(ctx, repo, ctx.auth.user) : null}
        ${tellRegion}
        <div id="app-previews">${previews}</div>
        ${nowRegion(repo, now)}
        ${notesCard(ctx, repo, record)}
@@ -0,0 +1,18 @@
/**
 * Whether an app page shows only its progress (#10299): the app is new and has
 * not run (`apps/onboarding.ts` has a line for it) and nothing was ever
 * shipped or taken as a run. Anything else is an app with something to show.
 */
import type { Database } from "bun:sqlite";
import { mergedPullCount } from "../../core/pulls.ts";
import { agentRunTotals } from "../../core/runs.ts";
/** The start of history, for an "ever" count rather than one week of it. */
const EPOCH = new Date(0).toISOString();
/** Whether anything was ever shipped here, or (for a viewer who sees them) a run taken. */
export function hasHistory(db: Database, repoId: string, ownerFacts: boolean): boolean {
      
        junipercrew
        2d ago
        
      
      Principle 1 (nothing says itself twice) applies to code too: this duplicates the hasHistory block in app.ts. Make one the source.
    
  if (mergedPullCount(db, repoId, EPOCH) > 0) return true;
  return ownerFacts && agentRunTotals(db, repoId, EPOCH).runs > 0;
}
@@ -8,7 +8,7 @@
 */
import { eventRows, mayView, sealedScope } from "../../core/sealed.ts";
import { envPull } from "../../apps/data.ts";
import { envPull, previewEnv } from "../../apps/data.ts";
import { appsRuntime, envsFor } from "../../apps/runtime.ts";
import { notePhase, takeSessionTime, timePhase } from "../../core/route_timing.ts";
import { listCrewRoles } from "../../core/agents.ts";
@@ -74,11 +74,14 @@
export async function nowCard(
    wordCtx: WordCtx;
    /** Whether the head card is tailing production's own deploy. */
    deployTailing: boolean;
    /** A fresh app has no previews list, so each pull's row links its preview itself. */
    previewLinks?: boolean;
  },
): Promise<{ card: Html }> {
  const db = ctx.app.db;
  const base = repoBase(repo);
  const { openPulls, builderCount, ownerFacts, wordCtx, deployTailing } = o;
  const previewLinks = o.previewLinks === true && appsRuntime(ctx.app) !== undefined;
  // A run on a sealed report, and the report, are for who may see it.
  const recent = listRuns(db, repo.id, { kind: "agent", limit: 8 });
  const sealed = eventRows(
@@ -266,12 +269,21 @@
export async function nowCard(
          { name: p.authorName, isAgent: p.authorIsAgent },
          ownerFacts,
        );
        const meta = html`${who} · ${noteLine(note)} · ${time(p.createdAt)}`;
        if (previewLinks)
          return row({
            nav: true,
            lead: avatar(who),
            title: html`<a href="${changeHref(base, p.number)}">${p.title}</a>`,
            meta: html`${meta} · <a href="${base}/app/${previewEnv(p.number)}/open">Preview</a>`,
            trail: wordBadge(word),
          });
        return row({
          href: changeHref(base, p.number),
          nav: true,
          lead: avatar(who),
          title: p.title,
          meta: html`${who} · ${noteLine(note)} · ${time(p.createdAt)}`,
          meta,
          trail: wordBadge(word),
        });
      }),
@@ -358,10 +370,8 @@
export async function appNowFragment(ctx: Ctx): Promise<Response> {
  );
  // The one fact Now borrows from the head card, decided where the head
  // card decides it, so the two never disagree about what is tailing.
  const deployTailing = timePhase(
    req,
    "panels",
    () => appPanels(ctx, repo, record, openPulls).deployTailing,
  const { deployTailing, fresh } = timePhase(req, "panels", () =>
    appPanels(ctx, repo, record, openPulls),
  );
  const rendering = performance.now();
  const { card } = await nowCard(ctx, repo, record, {
@@ -377,6 +387,7 @@
export async function appNowFragment(ctx: Ctx): Promise<Response> {
      viewer: ctx.auth.user,
    },
    deployTailing,
    previewLinks: fresh,
  });
  const response = fragment(nowRegion(repo, card), { request: req });
  notePhase(req, "render", performance.now() - rendering);
@@ -29,6 +29,7 @@
import { testsClause } from "./words.ts";
import { html, when, type Html } from "../html.ts";
import { fragment, missingFragment } from "../layout.ts";
import { onboardingRow } from "../onboarding_row.ts";
import { hasHistory } from "./fresh.ts";
import {
  badge,
  btn,
@@ -286,6 +287,10 @@
export function appPanels(
  head: Html;
  previews: Html | null;
  deployTailing: boolean;
  /** A new app that has not run yet: its page shows only its progress. */
  fresh: boolean;
  /** Anything ever shipped here, or (for a viewer who sees them) a run taken. */
  history: boolean;
} {
  const db = ctx.app.db;
  const base = repoBase(repo);
@@ -293,17 +298,20 @@
export function appPanels(
  const envs: EnvStatus[] = envsFor(ctx.app, ctx.auth.user, record);
  const writer = canSeeOwnerFacts(db, repo, ctx.auth.user);
  const checks = latestRunsForIssues(db, openPulls.map((p) => p.id));
  const previews = previewsPanel(base, runtime, record, openPulls, envs, writer, checks);
  const production = envs.find((e) => e.env === "production");
  // Until production has a deploy of its own to speak of, a new app's facts
  // row says where it stands instead (`apps/onboarding.ts`).
  const onboarding = production?.runId === undefined ? appOnboardingLine(ctx.app, repo, ctx.auth.user) : undefined;
  const history = hasHistory(db, repo.id, writer);
  const fresh = onboarding !== undefined && !history;
  // A fresh app's pull is already the Now row; a second list would say it twice.
  const previews = fresh ? null : previewsPanel(base, runtime, record, openPulls, envs, writer, checks);
  // The forge's own source shows the forge as its production; the app is its test copy.
  const { url, copy } = shownProduction(ctx.app, repo, runtime?.urlFor(record, "production"));
  const tail = productionTail(ctx, repo, production, writer);
  // The state in one word, and under it the facts — why it is not up, and
  // the deploy whose log says the rest.
  const live = envPhrase(production);
  // Until production has a deploy of its own to speak of, a new app's facts
  // row says where it stands instead (`apps/onboarding.ts`).
  const onboarding = production?.runId === undefined ? appOnboardingLine(ctx.app, repo, ctx.auth.user) : undefined;
  const head = html`<div class="page-head">
    <div class="stack stack-tight">
      <h1 class="bar">
@@ -315,22 +323,21 @@
export function appPanels(
            : { tone: live.tone },
        )}
      
        junipercrew
        2d ago
        outdated
      
      Empty description now renders an empty muted paragraph. Wrap it in when(repo.description, ...).
    
      </h1>
      <p class="muted">
        ${repo.description || "No description yet."}
      ${when(repo.description || url !== undefined || copy !== undefined, () => html`<p class="muted">
        ${when(repo.description, (d) => html`${d}`)}
        ${url === undefined
          ? null
          : copy !== undefined || production?.state === "running"
            ? html`·
                <a href="${base}/app/production/open" class="mono"
            ? html`${repo.description ? "· " : ""}<a href="${base}/app/production/open" class="mono"
                  >${url.replace(/^https?:\/\//, "")}</a
                >`
            : html`· <span class="mono">${url.replace(/^https?:\/\//, "")}</span>`}
        ${when(copy, (c) => html`· ${testCopyLink(c)}`)}
      </p>
            : html`${repo.description ? "· " : ""}<span class="mono">${url.replace(/^https?:\/\//, "")}</span>`}
        ${when(copy, (c) => html`${repo.description || url !== undefined ? "· " : ""}${testCopyLink(c)}`)}
      </p>`)}
      ${onboarding === undefined
        ? when(production, (env) => envFacts(base, env))
        : onboardingRow(onboarding)}
      ${when(writer, () =>
      ${when(writer && !fresh, () =>
        terminalLine(
          terminalFor(ctx.app, record, "production", production),
          ctx.app.config.sshHostKey,
@@ -350,6 +357,8 @@
export function appPanels(
    head,
    previews,
    deployTailing: tail.deploying,
    fresh,
    history,
  };
}
@@ -19,6 +19,7 @@
import { serve, type Servers } from "../src/http/server.ts";
import { egressNote } from "../src/web/studio/egress.ts";
import { seedAdmin } from "./helpers/admin.ts";
import { quietLogs } from "./helpers/globals.ts";
import { giveHistory } from "./helpers/history.ts";
quietLogs();
@@ -39,6 +40,7 @@
beforeAll(async () => {
  repo = r.value;
  const made = createAppRecord(app.db, { repoId: repo.id, slug: "notes", access: "public" });
  if (!made.ok) throw new Error(made.error);
  giveHistory(app.db, repo.id);
  setCapacity(app.db, "cells.egress", "report", a.value.id);
  noteReached(dataDir, repo.id, "api.example.com", 443);
  noteReached(dataDir, repo.id, "api.example.com", 443);
@@ -10,6 +10,7 @@
 * `apps-new`. The forge they share is `helpers/apps-forge.ts`.
 */
import { getRepo } from "../src/core/repos.ts";
import { afterAll, beforeAll, describe, expect, test } from "bun:test";
import { existsSync, readFileSync, writeFileSync } from "node:fs";
import { mkdtemp, rm } from "node:fs/promises";
@@ -59,6 +60,7 @@
import {
  stopAppsForge,
  type AppsForge,
} from "./helpers/apps-forge.ts";
import { giveHistory } from "./helpers/history.ts";
describe("apps: production, previews, data, gates", () => {
  let forge: AppsForge;
@@ -631,6 +633,7 @@
exec bun -e "Bun.serve({port:Number(process.env.PORT),hostname:'127.0.0.1',fetch
          visibility: "public",
        });
        if (!made.ok) throw new Error(String(made.error));
        giveHistory(terminal.app.db, getRepo(terminal.app.db, "alice", "beacon")!.id);
        terminalCookie = await signedInCookie(terminal.servers);
      })(),
      (async () => {
@@ -27,6 +27,7 @@
import { mcpTool } from "./helpers/mcp.ts";
import { askCountFor, askLinesFor, forgeNeedsFor, repoAsks } from "../src/web/studio/asks.ts";
import { quietLogs } from "./helpers/globals.ts";
import { listAt } from "./mcp-list.ts";
import { giveHistory } from "./helpers/history.ts";
quietLogs();
// Every test here is HTTP round trips against a server on a shared machine: the 5s default measures its load, not the code.
@@ -169,6 +170,7 @@
describe("muting a repository's asks", () => {
    expect(repoAsks(app.db, alice, repo)).toEqual({ count: 1, muted: true });
    // The repository's page is the app's once it is one.
    expect(createAppRecord(app.db, { repoId: repo.id, slug: "muted", access: "public" }).ok).toBe(true);
    giveHistory(app.db, repo.id);
    const page = await fetch(`${servers.url}/alice/muted`, { headers: headers(cookie) });
    expect(page.status).toBe(200);
    const text = await page.text();
@@ -25,6 +25,7 @@
import { getRepo } from "../src/core/repos.ts";
import { openPull } from "../src/actions/pulls.ts";
import { createUser, type User } from "../src/core/users.ts";
import { serve, type Servers } from "../src/http/server.ts";
import { giveHistory } from "./helpers/history.ts";
/** A forge of its own with alice signed in, for a test that changes what it reads. */
async function boot(prefix: string) {
@@ -66,6 +67,7 @@
async function seedApps(app: App, alice: User) {
    visibility: "public",
  });
  if (!notes.ok) throw new Error(String(notes.error));
  giveHistory(app.db, getRepo(app.db, "alice", "notes")!.id);
  // An app whose contract does not hold.
  const broken = await createRepo(app, alice, {
@@ -0,0 +1,123 @@
/**
 * A new app that has not run shows only its progress (#10299): its state line,
 * the box to tell the crew, and Now. Once it is older, or has shipped, the
 * rail and the previews list return; the empty cards never do.
 */
import { afterAll, beforeAll, expect, test } from "bun:test";
import { mkdtempSync, rmSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { enableApp } from "../src/actions/apps.ts";
import { openPull } from "../src/actions/pulls.ts";
import { commitToBranch, createRepo } from "../src/actions/repos.ts";
import { AppsRuntime } from "../src/apps/runtime.ts";
import { createApp, type App } from "../src/app.ts";
import { createUser } from "../src/core/users.ts";
import { serve, type Servers } from "../src/http/server.ts";
import { proveAll } from "./helpers/verified.ts";
import { quietLogs } from "./helpers/globals.ts";
import { ageApp } from "./helpers/history.ts";
quietLogs();
let root = "";
let app: App;
let servers: Servers;
let runtime: AppsRuntime;
let cookie = "";
let repoId = "";
const read = async (as: string = cookie): Promise<string> =>
  (await fetch(`${servers.url}/alice/vault`, { headers: as ? { cookie: as } : {} })).text();
const signin = async (username: string): Promise<string> => {
  const r = await fetch(`${servers.url}/signin`, {
    method: "POST", headers: { origin: servers.url },
    body: new URLSearchParams({ username, password: "a-good-passphrase" }), redirect: "manual",
  });
  return (r.headers.get("set-cookie") ?? "").split(";")[0]!;
};
let bobCookie = "";
beforeAll(async () => {
  root = mkdtempSync(join(tmpdir(), "forge-fresh-"));
  app = createApp({ dataDir: root, port: 0, forgeRepo: "alice/forge" });
  const u = await createUser(app.db, {
    origin: "seed", trusted: true, username: "alice", email: "[email protected]",
    password: "a-good-passphrase", adminIfFirst: true,
  });
  if (!u.ok) throw new Error(u.error);
  proveAll(app);
  const bob = await createUser(app.db, {
    origin: "seed", trusted: true, username: "bob", email: "[email protected]", password: "a-good-passphrase",
  });
  if (!bob.ok) throw new Error(bob.error);
  const made = await createRepo(app, { id: u.value.id, username: "alice" } as never, { name: "vault", visibility: "public" });
  if (!made.ok) throw new Error(String(made.error));
  repoId = made.value.id;
  for (const [branch, path] of [["main", "README.md"], ["feature/x", "x.ts"]] as const) {
    const c = await commitToBranch(app, u.value, made.value, {
      message: "Start", branch, files: [{ path, content: "v\n" }],
    } as never);
    if (!c.ok) throw new Error(JSON.stringify(c.error));
  }
  const enabled = await enableApp(app, u.value, made.value, { slug: "vault" });
  if (!enabled.ok) throw new Error(String(enabled.error));
  const pull = await openPull(app, u.value, made.value, { title: "Add x", baseBranch: "main", headBranch: "feature/x" });
  if (!pull.ok) throw new Error(String(pull.error));
  servers = await serve(app);
  runtime = new AppsRuntime(app, {
    domain: "apps.test", scheme: "http", publicPort: servers.port, forgeUrl: servers.url, concurrency: 1,
  });
  cookie = await signin("alice");
  bobCookie = await signin("bob");
});
afterAll(async () => {
  await runtime.stop();
  servers.stop();
  app.close();
  rmSync(root, { recursive: true, force: true });
});
test("a new app that has not run shows its progress, the box and Now, and nothing else", async () => {
  const page = await read();
  expect(page).toContain("The crew is making it run");
  expect(page).toContain("Tell the crew");
  expect(page).toContain('id="live-now"');
  for (const gone of ["<aside", "<h2>Previews</h2>", "<h2>This week</h2>", "<h2>Crew</h2>", "No description yet"])
    expect(page).not.toContain(gone);
  // No description, no address yet: no empty paragraph under the name.
  expect(page).not.toMatch(/<p class="muted">\s*<\/p>/);
});
test("the owner still reaches the environment settings on a fresh app", async () => {
  const page = await read();
  expect(page).toContain("Environment settings");
});
test("the Now row links the pull's preview, since a fresh app has no previews list", async () => {
  const page = await read();
  expect(page).toContain('href="/alice/vault/app/pull-1/open"');
  expect(page).toContain('href="/alice/vault/pulls/1"');
});
test("a guest and a non-owner see the progress, with no owner facts and no terminal line", async () => {
  for (const who of ["", bobCookie]) {
    const page = await read(who);
    expect(page).toContain('id="live-now"');
    for (const gone of ["The terminal is off", "ssh ", "action=\"/alice/vault/tell\"", "Environment settings", "<aside", "Spent", "<h2>Crew</h2>"])
      expect(page).not.toContain(gone);
  }
});
test("an older app keeps its rail and previews, and still has no empty cards", async () => {
  ageApp(app.db, repoId);
  const page = await read();
  expect(page).toContain("<aside");
  expect(page).toContain("<h2>Previews</h2>");
  expect(page).toContain("Environment settings");
  expect(page).not.toContain("<h2>This week</h2>");
  expect(page).not.toContain("<h2>Crew</h2>");
  expect(page).not.toContain("The map</a>");
});
@@ -0,0 +1,17 @@
/**
 * Give an app a history (#10299): a new app that has not run shows only its
 * progress, so a test of the full page first has the crew take one run there.
 * The run is finished, so it is history and not work in flight.
 */
import type { Database } from "bun:sqlite";
import { createRun, finishRun } from "../../src/core/runs.ts";
export function giveHistory(db: Database, repoId: string): void {
  const run = createRun(db, { repoId, kind: "agent", reason: "history" });
  finishRun(db, run.id, { state: "ok", summary: "done" });
}
/** Make an app older than the window that counts as new, so its page is the full one. */
export function ageApp(db: Database, repoId: string): void {
  db.run("UPDATE app SET created_at = '2026-01-02T00:00:00.000Z' WHERE repo_id = ?1", [repoId]);
}
@@ -17,6 +17,7 @@
import {
  onboardingLine,
  ONBOARDING_WINDOW_MS,
} from "../src/apps/onboarding.ts";
import { ageApp } from "./helpers/history.ts";
const OID = (c: string) => c.repeat(40);
@@ -133,7 +134,7 @@
describe("only a new app", () => {
  test("an app created before this shipped has no line and is never looked at", () => {
    const f = fixture();
    openPull(f);
    f.db.run("UPDATE app SET created_at = '2026-01-02T00:00:00.000Z' WHERE repo_id = 'r1'");
    ageApp(f.db, "r1");
    const old = { ...f, record: { ...f.record, createdAt: "2026-01-02T00:00:00.000Z" } };
    const facts = onboardingFacts(old.db, old.repo, old.record, "/owner/exact", old.user, true);
    expect(onboardingLine(facts)).toBeUndefined();
@@ -10,6 +10,7 @@
import { createUser } from "../src/core/users.ts";
import { serve, type Servers } from "../src/http/server.ts";
import { proveAll } from "./helpers/verified.ts";
import { quietLogs } from "./helpers/globals.ts";
import { ageApp, giveHistory } from "./helpers/history.ts";
quietLogs();
@@ -39,6 +40,9 @@
beforeAll(async () => {
  if (!seeded.ok) throw new Error(JSON.stringify(seeded.error));
  const enabled = await enableApp(app, u.value, made.value, { slug: "vault" });
  if (!enabled.ok) throw new Error(String(enabled.error));
  // A new app shows only its progress (#10299); this budget is the full page.
  ageApp(app.db, made.value.id);
  giveHistory(app.db, made.value.id);
  servers = await serve(app);
});
afterAll(() => {
@@ -69,7 +73,6 @@
test("GET /:owner/:name/app names its phases", async () => {
    "spend",
    "decisions",
    "latency",
    "history",
    "panels",
    "now",
    "following",
@@ -51,6 +51,7 @@
import { createUser, getUserByName, type User } from "../src/core/users.ts";
import { serve, type Servers } from "../src/http/server.ts";
import { promote } from "./helpers/members.ts";
import { withScripts } from "./helpers/page-script.ts";
import { ageApp } from "./helpers/history.ts";
let dataDir: string;
let app: App;
@@ -430,6 +431,8 @@
describe("every open pull's preview on the studio page", () => {
    const enabled = await enableApp(app, alice, repo, { slug: "widget" });
    if (!enabled.ok) throw new Error(String(enabled.error));
    record = getAppByRepo(app.db, repo.id)!;
    // An older app: a new one shows only its progress, without the list (#10299).
    ageApp(app.db, repo.id);
  });
  test("an open pull's preview host and open link render; none do once nothing is open", async () => {
@@ -45,6 +45,7 @@
import { createUser, getUserByName, type User } from "../src/core/users.ts";
import { serve, type Servers } from "../src/http/server.ts";
import { NOBODY_ON_CREW } from "../src/web/studio/words.ts";
import { servedPhrase } from "../src/web/ui.ts";
import { ageApp } from "./helpers/history.ts";
describe("a stranger sees the app, not the owner's books", () => {
  let dataDir: string;
@@ -340,6 +341,8 @@
describe("a stranger sees the app, not the owner's books", () => {
    });
    expect(on.ok).toBe(true);
    // An older app: a new one shows only its progress (#10299).
    ageApp(app.db, lamp.id);
    const empty = await (await get("/alice/lamp", ownerCookie)).text();
    expect(empty).toContain("Autonomous");
    expect(empty).toContain("nobody on the crew");
@@ -1060,10 +1063,10 @@
describe("the studio's crew panel on a forge with no agents yet", () => {
    expect(refused.status).toBe(404);
  });
  test("the app page's 'Add someone' leads unbroken to the door an agent is made through, with nothing dev-only in the way", async () => {
  test("the app page's way to add a crew member leads unbroken to the door an agent is made through, with nothing dev-only in the way", async () => {
    const appPage = await (await get("/alice/pad", ownerCookie)).text();
    expect(appPage).toContain("Nobody yet");
    expect(appPage).toContain('href="/alice/pad/settings">Add someone.');
    expect(appPage).toContain("Nobody on the crew yet");
    expect(appPage).toContain('href="/alice/pad/settings#crew"');
    const settings = await (
      await get("/alice/pad/settings", ownerCookie)
@@ -2120,8 +2123,10 @@
describe("a one-minute-old app's front door does not lead with a week of zeros (
  test("the day-one page a person lands on from New app says one true line, not a week of zeros", async () => {
    const page = await (await get("/alice/newborn")).text();
    expect(page).toContain("This week");
    expect(page).toContain("Nothing to show yet");
    // A new app shows only its progress: no week, no rail (#10299).
    expect(page).not.toContain("This week");
    expect(page).not.toContain("Nothing to show yet");
    expect(page).toContain("Tell the crew");
    // Not a single zero from the old panel, and not the scary ratio: the
    // forge's own cancelled boot is never counted, and two deploys is well
    // under the threshold a ratio needs anyway.
@@ -2133,7 +2138,7 @@
describe("a one-minute-old app's front door does not lead with a week of zeros (
  test("a stranger sees the same quiet line, not the owner's zeros", async () => {
    const page = await (await fetch(`${base}/alice/newborn`)).text();
    expect(page).toContain("Nothing to show yet");
    expect(page).not.toContain("Nothing to show yet");
    expect(page).not.toMatch(/Shipped<\/dt>\s*<dd>0 pull requests<\/dd>/);
  });
});
@@ -38,6 +38,7 @@
import {
import { createUser, getUserByName, type User } from "../src/core/users.ts";
import { CHECK_FAILED_LIMIT } from "../src/crew/dispatch.ts";
import { serve, type Servers } from "../src/http/server.ts";
import { giveHistory } from "./helpers/history.ts";
describe("the studio", () => {
  let dataDir: string;
@@ -118,6 +119,7 @@
describe("the studio", () => {
    const scout = await createAgent(app, alice, { username: "scout" });
    if (!scout.ok) throw new Error(String(scout.error));
    repo = await makeApp("notes", "a place for notes");
    giveHistory(app.db, repo.id);
  }, 60_000);
  afterAll(async () => {
		@@ -13,25 +13,25 @@
13	13	},
14	14	"repository": {
15	15	"390": {
16		"words": 197,
17		"blocks": 29,
	16	"words": 116,
	17	"blocks": 18,
18	18	"colours": 2
19	19	},
20	20	"1280": {
21		"words": 197,
22		"blocks": 29,
	21	"words": 116,
	22	"blocks": 18,
23	23	"colours": 2
24	24	}
25	25	},
26	26	"app": {
27	27	"390": {
28		"words": 197,
29		"blocks": 29,
	28	"words": 116,
	29	"blocks": 18,
30	30	"colours": 2
31	31	},
32	32	"1280": {
33		"words": 197,
34		"blocks": 29,
	33	"words": 116,
	34	"blocks": 18,
35	35	"colours": 2
36	36	}
37	37	},
		@@ -22,8 +22,8 @@ reader sees on first view at 390 px and 1280 px: words, text blocks and
22	22	\| Page \| 390 px \| 1280 px \|
23	23	\|---\|---\|---\|
24	24	\| home \| 95 / 20 / 2 \| 95 / 20 / 2 \|
25		\| repository \| 189 / 28 / 2 \| 189 / 28 / 2 \|
26		\| app \| 189 / 28 / 2 \| 189 / 28 / 2 \|
	25	\| repository \| 116 / 18 / 2 \| 116 / 18 / 2 \|
	26	\| app \| 116 / 18 / 2 \| 116 / 18 / 2 \|
27	27	\| pull \| 133 / 22 / 4 \| 133 / 22 / 4 \|
28	28	\| issue \| 76 / 19 / 2 \| 76 / 19 / 2 \|
29	29	\| issues list \| 32 / 8 / 2 \| 32 / 8 / 2 \|
		@@ -31,3 +31,7 @@ reader sees on first view at 390 px and 1280 px: words, text blocks and
31	31	\| runs \| 46 / 8 / 1 \| 46 / 8 / 1 \|
32	32	\| run \| 34 / 11 / 3 \| 34 / 11 / 3 \|
33	33	\| settings \| 137 / 32 / 1 \| 137 / 32 / 1 \|
	34
	35	## App page, calmed (#10299)
	36
	37	A new app that has not run, and has shipped nothing, shows only its progress: the state line (`docs/features/onboarding-line.md`), the box to tell the crew, and Now (`src/web/studio/fresh.ts` judges it). Past that, the empty This week and Crew cards are gone, and the page's second link row (Map, Issues, Pull requests) is gone because the head's tabs already hold them. Before, on the seeded new app: 197 words / 29 blocks (over its 189 / 28 budget on main); after: 116 / 18.
		@@ -52,7 +52,6 @@ import {
52	52	listCard,
53	53	row,
54	54	} from "../ui.ts";
55		import { changesHref, tellsHref } from "./nouns.ts";
56	55	import { answersRegion } from "./answers.ts";
57	56	import { nowCard, nowRegion } from "./now.ts";
58	57	import { repoAsks } from "./asks.ts";
		@@ -117,9 +116,6 @@ const PREVIEW_LATENCY_MIN = 3;
117	116	*/
118	117	const FAILED_RATIO_MIN = 5;
119	118
120		/** The start of history, for an "ever" count rather than one week of it. */
121		const EPOCH = new Date(0).toISOString();
122
123	119	/**
124	120	* How fast a change has reached its preview this week, worded like the
125	121	* reference instant in `servedPhrase` (`web/ui.ts`): "reaches its preview
		@@ -276,52 +272,43 @@ export async function studioApp(
276	272	...sealedScope(db, repo, ctx.auth.user),
277	273	}),
278	274	);
	275	// A new app that has not run is told apart from one with a past in
	276	// `appPanels` (`fresh.ts`): its page shows only its progress, so the
	277	// week's reads below are skipped for it.
	278	const { head, previews, deployTailing, fresh, history } = timePhase(req, "panels", () =>
	279	appPanels(ctx, repo, record, openPulls),
	280	);
279	281	const week = new Date(Date.now() - 7 * 24 * 60 * 60_000).toISOString();
280	282	// What landed this week, counted by the database like the runs and the
281	283	// spend below — a page of closed pulls would stop at a hundred and the
282	284	// cost per shipped change would read high off the short count.
283		const shipped = timePhase(req, "shipped", () =>
284		mergedPullCount(db, repo.id, week),
285		);
	285	const shipped = fresh
	286	? 0
	287	: timePhase(req, "shipped", () => mergedPullCount(db, repo.id, week));
286	288	// The rest is spend, worked out only for a viewer who is going to see it —
287	289	// counted by the database over the whole week, not off a page of rows.
288		const weekTotals = ownerFacts
	290	const weekTotals = ownerFacts && !fresh
289	291	? timePhase(req, "spend", () => agentRunTotals(db, repo.id, week))
290	292	: { runs: 0, spentUsd: 0 };
291	293	const spent = weekTotals.spentUsd;
292		const ledgerWeek = ownerFacts
	294	const ledgerWeek = ownerFacts && !fresh
293	295	? timePhase(req, "decisions", () => decisionStats(db, repo.id, week))
294	296	: [];
295		const weekLatency = ownerFacts
	297	const weekLatency = ownerFacts && !fresh
296	298	? timePhase(req, "latency", () => previewLatency(db, repo.id, week))
297	299	: undefined;
298		// Whether there is any history at all — ever, not this week's — so a
299		// fresh app reads as "nothing yet" rather than a stretch of zeros and a
300		// scary ratio (#274). A quiet week on an old app still has shipped a
301		// change or taken a run at some point; only an app with neither, ever,
302		// gets the quieter line. Deploys are not part of this: they happen on
303		// their own the moment an app exists, so they say nothing about whether
304		// anyone has done anything yet.
305		const hasHistory = timePhase(req, "history", () => {
306		const everShipped = shipped > 0 \|\| mergedPullCount(db, repo.id, EPOCH) > 0;
307		const everRuns = ownerFacts
308		? weekTotals.runs > 0 \|\| agentRunTotals(db, repo.id, EPOCH).runs > 0
309		: false;
310		return everShipped \|\| everRuns;
311		});
312	300	const autonomy =
313		!ownerFacts \|\| repo.autonomy === "off"
	301	!ownerFacts \|\| fresh \|\| repo.autonomy === "off"
314	302	? undefined
315	303	: timePhase(req, "autonomy", () => autonomyStatus(ctx.app, repo));
316	304	// The governor's reason, one line on the crew card (#7644).
317		const governor = timePhase(req, "governor", () => governorSeen(ctx.app, ctx.auth.user, repo, new Date()));
	305	const governor = fresh
	306	? undefined
	307	: timePhase(req, "governor", () => governorSeen(ctx.app, ctx.auth.user, repo, new Date()));
318	308
319	309	// ---- the app itself ----
320	310	// `deployTailing` says the head card is tailing production's own deploy —
321	311	// the "Now" panel's empty-state words below care about that distinction.
322		const { head, previews, deployTailing } = timePhase(req, "panels", () =>
323		appPanels(ctx, repo, record, openPulls),
324		);
325	312
326	313	// ---- the box ----
327	314	// Telling the crew, and who takes it, is the owner's own front door — a
		@@ -356,6 +343,7 @@ export async function studioApp(
356	343	ownerFacts,
357	344	wordCtx,
358	345	deployTailing,
	346	previewLinks: fresh,
359	347	}),
360	348	);
361	349
		@@ -363,19 +351,10 @@ export async function studioApp(
363	351	// Crew, spend and autonomy are the owner's facts; a viewer who cannot
364	352	// write here gets only the shipped count, never the roster, the money or
365	353	// the ledger — and the page never asks for the rest on their behalf.
366		const crewCard = !ownerFacts
	354	// No crew yet: the tell box and the Now row already say so, once.
	355	const crewCard = !ownerFacts \|\| crew.length === 0
367	356	? null
368		: crew.length === 0
369		? card(
370		html`<p class="muted small">
371		Nobody yet. <a href="${base}/settings">Add someone.</a>
372		</p>`,
373		{
374		head: html`${icon("bot")}
375		<h2>Crew</h2>`,
376		},
377		)
378		: listCard(
	357	: listCard(
379	358	crew.map((c) =>
380	359	row({
381	360	lead: avatar(c.agent.user.username),
		@@ -394,13 +373,9 @@ export async function studioApp(
394	373	${btn("Change", { href: `${base}/settings`, size: "sm" })}`,
395	374	},
396	375	);
397		const weekCard = card(
398		!hasHistory
399		? html`<p class="muted small">
400		Nothing to show yet — it fills in once a pull request
401		ships${ownerFacts ? " or the crew takes a run" : ""}.
402		</p>`
403		: !ownerFacts
	376	// No history, no card: an empty week explains itself to nobody.
	377	const weekCard = !history ? null : card(
	378	!ownerFacts
404	379	? html`<dl>
405	380	<dt>Shipped</dt>
406	381	<dd>${shipped} pull request${shipped === 1 ? "" : "s"}</dd>
		@@ -475,28 +450,44 @@ export async function studioApp(
475	450	);
476	451	// The rest of the app's environment — its variables, hostname, access and
477	452	// domains — is the admin's, on the app's settings page.
478		const more = html`<p class="muted small">
479		<a href="${base}/map">The map</a> ·
480		<a href="${tellsHref(base)}">Issues</a> ·
481		<a href="${changesHref(base)}">Pull requests</a>${when(
482		canAdmin(db, repo, ctx.auth.user),
483		() => html` · <a href="${base}/settings/app">Environment settings</a>`,
484		)}
485		</p>`;
	453	// Issues, Pulls and the map are the head's own tabs; only what it lacks is here.
	454	const more = canAdmin(db, repo, ctx.auth.user)
	455	? html`<p class="muted small"><a href="${base}/settings/app">Environment settings</a></p>`
	456	: null;
486	457
487	458	// An app that follows another says so before anything else: whether it
488	459	// is in step is the first thing its owner wants to know.
489	460	const following = await timePhaseAsync(req, "following", () =>
490	461	followingOf(ctx, repo),
491	462	);
492		const policy = await timePhaseAsync(req, "policy", () =>
493		policyLine(ctx, repo, record),
494		);
	463	const policy = fresh
	464	? null
	465	: await timePhaseAsync(req, "policy", () => policyLine(ctx, repo, record));
495	466	const adapter = ownerFacts
496	467	? await timePhaseAsync(req, "adapter", () => adapterCard(ctx, record, repo))
		junipercrew 2d ago outdated Mis-indented, and a double blank line follows. Also, 'Environment settings' vanishes on a fresh app for admins: keep it reachable.
497	468	: null;
498	469	const rendering = performance.now();
499		const body = html`${repoHeader(ctx, repo, "app", {
	470	const tellRegion = html`${tell}
	471	${ownerFacts && ctx.auth.user ? answersRegion(ctx, repo, ctx.auth.user) : null}`;
	472	// A new app that has not run yet shows only its progress: the head's
	473	// state line, the box to tell the crew, and Now. Everything else waits
	474	// until there is something to show.
	475	const body = fresh
	476	? html`${repoHeader(ctx, repo, "app", { compact: true, ownTitle: true })}
	477	${following === undefined
	478	? archivedParentLine(ctx, repo)
	479	: followingCard(ctx, repo, following)}
	480	<div id="app-head">${head}</div>
	481	${ownerFacts ? crewKeyNote(ctx) : null}
	482	<div class="stack">
	483	${adapter}
	484	${tellRegion}
	485	<div id="app-previews"></div>
	486	${nowRegion(repo, now)}
	487	${more}
	488	</div>
	489	${liveMount({ repo: base, app: true })}`
	490	: html`${repoHeader(ctx, repo, "app", {
500	491	compact: true,
501	492	ownTitle: true,
502	493	})}
		@@ -518,8 +509,7 @@ export async function studioApp(
518	509	: null}
519	510	<div class="split" data-rail="wide">
520	511	<div class="stack">
521		${tell}
522		${ownerFacts && ctx.auth.user ? answersRegion(ctx, repo, ctx.auth.user) : null}
	512	${tellRegion}
523	513	<div id="app-previews">${previews}</div>
524	514	${nowRegion(repo, now)}
525	515	${notesCard(ctx, repo, record)}
		@@ -0,0 +1,18 @@
	1	/**
	2	* Whether an app page shows only its progress (#10299): the app is new and has
	3	* not run (`apps/onboarding.ts` has a line for it) and nothing was ever
	4	* shipped or taken as a run. Anything else is an app with something to show.
	5	*/
	6
	7	import type { Database } from "bun:sqlite";
	8	import { mergedPullCount } from "../../core/pulls.ts";
	9	import { agentRunTotals } from "../../core/runs.ts";
	10
	11	/** The start of history, for an "ever" count rather than one week of it. */
	12	const EPOCH = new Date(0).toISOString();
	13
	14	/** Whether anything was ever shipped here, or (for a viewer who sees them) a run taken. */
	15	export function hasHistory(db: Database, repoId: string, ownerFacts: boolean): boolean {
		junipercrew 2d ago Principle 1 (nothing says itself twice) applies to code too: this duplicates the hasHistory block in app.ts. Make one the source.
	16	if (mergedPullCount(db, repoId, EPOCH) > 0) return true;
	17	return ownerFacts && agentRunTotals(db, repoId, EPOCH).runs > 0;
	18	}
		@@ -8,7 +8,7 @@
8	8	*/
9	9
10	10	import { eventRows, mayView, sealedScope } from "../../core/sealed.ts";
11		import { envPull } from "../../apps/data.ts";
	11	import { envPull, previewEnv } from "../../apps/data.ts";
12	12	import { appsRuntime, envsFor } from "../../apps/runtime.ts";
13	13	import { notePhase, takeSessionTime, timePhase } from "../../core/route_timing.ts";
14	14	import { listCrewRoles } from "../../core/agents.ts";
		@@ -74,11 +74,14 @@ export async function nowCard(
74	74	wordCtx: WordCtx;
75	75	/** Whether the head card is tailing production's own deploy. */
76	76	deployTailing: boolean;
	77	/** A fresh app has no previews list, so each pull's row links its preview itself. */
	78	previewLinks?: boolean;
77	79	},
78	80	): Promise<{ card: Html }> {
79	81	const db = ctx.app.db;
80	82	const base = repoBase(repo);
81	83	const { openPulls, builderCount, ownerFacts, wordCtx, deployTailing } = o;
	84	const previewLinks = o.previewLinks === true && appsRuntime(ctx.app) !== undefined;
82	85	// A run on a sealed report, and the report, are for who may see it.
83	86	const recent = listRuns(db, repo.id, { kind: "agent", limit: 8 });
84	87	const sealed = eventRows(
		@@ -266,12 +269,21 @@ export async function nowCard(
266	269	{ name: p.authorName, isAgent: p.authorIsAgent },
267	270	ownerFacts,
268	271	);
	272	const meta = html`${who} · ${noteLine(note)} · ${time(p.createdAt)}`;
	273	if (previewLinks)
	274	return row({
	275	nav: true,
	276	lead: avatar(who),
	277	title: html`<a href="${changeHref(base, p.number)}">${p.title}</a>`,
	278	meta: html`${meta} · <a href="${base}/app/${previewEnv(p.number)}/open">Preview</a>`,
	279	trail: wordBadge(word),
	280	});
269	281	return row({
270	282	href: changeHref(base, p.number),
271	283	nav: true,
272	284	lead: avatar(who),
273	285	title: p.title,
274		meta: html`${who} · ${noteLine(note)} · ${time(p.createdAt)}`,
	286	meta,
275	287	trail: wordBadge(word),
276	288	});
277	289	}),
		@@ -358,10 +370,8 @@ export async function appNowFragment(ctx: Ctx): Promise<Response> {
358	370	);
359	371	// The one fact Now borrows from the head card, decided where the head
360	372	// card decides it, so the two never disagree about what is tailing.
361		const deployTailing = timePhase(
362		req,
363		"panels",
364		() => appPanels(ctx, repo, record, openPulls).deployTailing,
	373	const { deployTailing, fresh } = timePhase(req, "panels", () =>
	374	appPanels(ctx, repo, record, openPulls),
365	375	);
366	376	const rendering = performance.now();
367	377	const { card } = await nowCard(ctx, repo, record, {
		@@ -377,6 +387,7 @@ export async function appNowFragment(ctx: Ctx): Promise<Response> {
377	387	viewer: ctx.auth.user,
378	388	},
379	389	deployTailing,
	390	previewLinks: fresh,
380	391	});
381	392	const response = fragment(nowRegion(repo, card), { request: req });
382	393	notePhase(req, "render", performance.now() - rendering);
		@@ -29,6 +29,7 @@ import { testsClause } from "./words.ts";
29	29	import { html, when, type Html } from "../html.ts";
30	30	import { fragment, missingFragment } from "../layout.ts";
31	31	import { onboardingRow } from "../onboarding_row.ts";
	32	import { hasHistory } from "./fresh.ts";
32	33	import {
33	34	badge,
34	35	btn,
		@@ -286,6 +287,10 @@ export function appPanels(
286	287	head: Html;
287	288	previews: Html \| null;
288	289	deployTailing: boolean;
	290	/** A new app that has not run yet: its page shows only its progress. */
	291	fresh: boolean;
	292	/** Anything ever shipped here, or (for a viewer who sees them) a run taken. */
	293	history: boolean;
289	294	} {
290	295	const db = ctx.app.db;
291	296	const base = repoBase(repo);
		@@ -293,17 +298,20 @@ export function appPanels(
293	298	const envs: EnvStatus[] = envsFor(ctx.app, ctx.auth.user, record);
294	299	const writer = canSeeOwnerFacts(db, repo, ctx.auth.user);
295	300	const checks = latestRunsForIssues(db, openPulls.map((p) => p.id));
296		const previews = previewsPanel(base, runtime, record, openPulls, envs, writer, checks);
297	301	const production = envs.find((e) => e.env === "production");
	302	// Until production has a deploy of its own to speak of, a new app's facts
	303	// row says where it stands instead (`apps/onboarding.ts`).
	304	const onboarding = production?.runId === undefined ? appOnboardingLine(ctx.app, repo, ctx.auth.user) : undefined;
	305	const history = hasHistory(db, repo.id, writer);
	306	const fresh = onboarding !== undefined && !history;
	307	// A fresh app's pull is already the Now row; a second list would say it twice.
	308	const previews = fresh ? null : previewsPanel(base, runtime, record, openPulls, envs, writer, checks);
298	309	// The forge's own source shows the forge as its production; the app is its test copy.
299	310	const { url, copy } = shownProduction(ctx.app, repo, runtime?.urlFor(record, "production"));
300	311	const tail = productionTail(ctx, repo, production, writer);
301	312	// The state in one word, and under it the facts — why it is not up, and
302	313	// the deploy whose log says the rest.
303	314	const live = envPhrase(production);
304		// Until production has a deploy of its own to speak of, a new app's facts
305		// row says where it stands instead (`apps/onboarding.ts`).
306		const onboarding = production?.runId === undefined ? appOnboardingLine(ctx.app, repo, ctx.auth.user) : undefined;
307	315	const head = html`<div class="page-head">
308	316	<div class="stack stack-tight">
309	317	<h1 class="bar">
		@@ -315,22 +323,21 @@ export function appPanels(
315	323	: { tone: live.tone },
316	324	)}
		junipercrew 2d ago outdated Empty description now renders an empty muted paragraph. Wrap it in when(repo.description, ...).
317	325	</h1>
318		<p class="muted">
319		${repo.description \|\| "No description yet."}
	326	${when(repo.description \|\| url !== undefined \|\| copy !== undefined, () => html`<p class="muted">
	327	${when(repo.description, (d) => html`${d}`)}
320	328	${url === undefined
321	329	? null
322	330	: copy !== undefined \|\| production?.state === "running"
323		? html`·
324		<a href="${base}/app/production/open" class="mono"
	331	? html`${repo.description ? "· " : ""}<a href="${base}/app/production/open" class="mono"
325	332	>${url.replace(/^https?:\/\//, "")}</a
326	333	>`
327		: html`· <span class="mono">${url.replace(/^https?:\/\//, "")}</span>`}
328		${when(copy, (c) => html`· ${testCopyLink(c)}`)}
329		</p>
	334	: html`${repo.description ? "· " : ""}<span class="mono">${url.replace(/^https?:\/\//, "")}</span>`}
	335	${when(copy, (c) => html`${repo.description \|\| url !== undefined ? "· " : ""}${testCopyLink(c)}`)}
	336	</p>`)}
330	337	${onboarding === undefined
331	338	? when(production, (env) => envFacts(base, env))
332	339	: onboardingRow(onboarding)}
333		${when(writer, () =>
	340	${when(writer && !fresh, () =>
334	341	terminalLine(
335	342	terminalFor(ctx.app, record, "production", production),
336	343	ctx.app.config.sshHostKey,
		@@ -350,6 +357,8 @@ export function appPanels(
350	357	head,
351	358	previews,
352	359	deployTailing: tail.deploying,
	360	fresh,
	361	history,
353	362	};
354	363	}
355	364
		@@ -19,6 +19,7 @@ import { serve, type Servers } from "../src/http/server.ts";
19	19	import { egressNote } from "../src/web/studio/egress.ts";
20	20	import { seedAdmin } from "./helpers/admin.ts";
21	21	import { quietLogs } from "./helpers/globals.ts";
	22	import { giveHistory } from "./helpers/history.ts";
22	23
23	24	quietLogs();
24	25
		@@ -39,6 +40,7 @@ beforeAll(async () => {
39	40	repo = r.value;
40	41	const made = createAppRecord(app.db, { repoId: repo.id, slug: "notes", access: "public" });
41	42	if (!made.ok) throw new Error(made.error);
	43	giveHistory(app.db, repo.id);
42	44	setCapacity(app.db, "cells.egress", "report", a.value.id);
43	45	noteReached(dataDir, repo.id, "api.example.com", 443);
44	46	noteReached(dataDir, repo.id, "api.example.com", 443);
		@@ -10,6 +10,7 @@
10	10	* `apps-new`. The forge they share is `helpers/apps-forge.ts`.
11	11	*/
12	12
	13	import { getRepo } from "../src/core/repos.ts";
13	14	import { afterAll, beforeAll, describe, expect, test } from "bun:test";
14	15	import { existsSync, readFileSync, writeFileSync } from "node:fs";
15	16	import { mkdtemp, rm } from "node:fs/promises";
		@@ -59,6 +60,7 @@ import {
59	60	stopAppsForge,
60	61	type AppsForge,
61	62	} from "./helpers/apps-forge.ts";
	63	import { giveHistory } from "./helpers/history.ts";
62	64
63	65	describe("apps: production, previews, data, gates", () => {
64	66	let forge: AppsForge;
		@@ -631,6 +633,7 @@ exec bun -e "Bun.serve({port:Number(process.env.PORT),hostname:'127.0.0.1',fetch
631	633	visibility: "public",
632	634	});
633	635	if (!made.ok) throw new Error(String(made.error));
	636	giveHistory(terminal.app.db, getRepo(terminal.app.db, "alice", "beacon")!.id);
634	637	terminalCookie = await signedInCookie(terminal.servers);
635	638	})(),
636	639	(async () => {
		@@ -27,6 +27,7 @@ import { mcpTool } from "./helpers/mcp.ts";
27	27	import { askCountFor, askLinesFor, forgeNeedsFor, repoAsks } from "../src/web/studio/asks.ts";
28	28	import { quietLogs } from "./helpers/globals.ts";
29	29	import { listAt } from "./mcp-list.ts";
	30	import { giveHistory } from "./helpers/history.ts";
30	31
31	32	quietLogs();
32	33	// Every test here is HTTP round trips against a server on a shared machine: the 5s default measures its load, not the code.
		@@ -169,6 +170,7 @@ describe("muting a repository's asks", () => {
169	170	expect(repoAsks(app.db, alice, repo)).toEqual({ count: 1, muted: true });
170	171	// The repository's page is the app's once it is one.
171	172	expect(createAppRecord(app.db, { repoId: repo.id, slug: "muted", access: "public" }).ok).toBe(true);
	173	giveHistory(app.db, repo.id);
172	174	const page = await fetch(`${servers.url}/alice/muted`, { headers: headers(cookie) });
173	175	expect(page.status).toBe(200);
174	176	const text = await page.text();
		@@ -25,6 +25,7 @@ import { getRepo } from "../src/core/repos.ts";
25	25	import { openPull } from "../src/actions/pulls.ts";
26	26	import { createUser, type User } from "../src/core/users.ts";
27	27	import { serve, type Servers } from "../src/http/server.ts";
	28	import { giveHistory } from "./helpers/history.ts";
28	29
29	30	/** A forge of its own with alice signed in, for a test that changes what it reads. */
30	31	async function boot(prefix: string) {
		@@ -66,6 +67,7 @@ async function seedApps(app: App, alice: User) {
66	67	visibility: "public",
67	68	});
68	69	if (!notes.ok) throw new Error(String(notes.error));
	70	giveHistory(app.db, getRepo(app.db, "alice", "notes")!.id);
69	71
70	72	// An app whose contract does not hold.
71	73	const broken = await createRepo(app, alice, {