dirpush 0.0.0 → 0.1.1

package/src/web/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <rect x="18" y="18" width="38" height="38" rx="10" fill="#d4ff3a" opacity=".38" transform="rotate(-8 37 37)"/>
+  <rect x="8" y="8" width="40" height="40" rx="10" fill="#d4ff3a" transform="rotate(-8 28 28)"/>
+</svg>

package/src/web/index.html

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>dirpush</title>
+    <link rel="icon" href="./favicon.svg" type="image/svg+xml" />
+    <link rel="stylesheet" href="./style.css" />
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="./app.tsx"></script>
+  </body>
+</html>

package/src/web/style.css

@@ -0,0 +1,301 @@
+/* Warm monochrome, hairline borders, SF Pro throughout. System fonts only: this runs offline. */
+:root {
+  color-scheme: light dark;
+  --canvas: #fbfbfa;
+  --surface: #ffffff;
+  --ink: #1f2124;
+  --ink-2: #4a4b4d;
+  --quiet: #787774;
+  --line: #eaeaea;
+  --line-2: #dededc;
+  --hover: #f4f4f2;
+  --button: #111111;
+  --button-ink: #ffffff;
+  --green-bg: #edf3ec; --green: #346538;
+  --blue-bg: #e1f3fe; --blue: #1f6c9f;
+  --yellow-bg: #fbf3db; --yellow: #956400;
+  --red-bg: #fdebec; --red: #9f2f2d;
+  --gray-bg: #f1f1ef; --gray: #5f5e5b;
+  --sans: "SF Pro Text", -apple-system, BlinkMacSystemFont, "Helvetica Neue", "Segoe UI", sans-serif;
+  --display: "SF Pro Display", -apple-system, BlinkMacSystemFont, "Helvetica Neue", "Segoe UI", sans-serif;
+  --mono: "SF Mono", ui-monospace, "JetBrains Mono", Menlo, monospace;
+  --ease: cubic-bezier(0.16, 1, 0.3, 1);
+  font: 14px/1.6 var(--sans);
+}
+@media (prefers-color-scheme: dark) {
+  :root {
+    --canvas: #191919;
+    --surface: #202020;
+    --ink: #ebebea;
+    --ink-2: #c5c5c3;
+    --quiet: #9b9a97;
+    --line: #2c2c2c;
+    --line-2: #373737;
+    --hover: #262626;
+    --button: #ebebea;
+    --button-ink: #191919;
+    --green-bg: #22301f; --green: #9bc59a;
+    --blue-bg: #1c2b36; --blue: #8cc4ec;
+    --yellow-bg: #332b17; --yellow: #e2bf6e;
+    --red-bg: #3a2223; --red: #ee9b97;
+    --gray-bg: #2a2a2a; --gray: #b4b3b0;
+  }
+}
+
+* { box-sizing: border-box; }
+body { margin: 0; background: var(--canvas); color: var(--ink); -webkit-font-smoothing: antialiased; }
+a { color: inherit; text-decoration: underline; text-decoration-color: var(--line-2); text-underline-offset: 3px; }
+a:hover { text-decoration-color: currentColor; }
+code, pre, .mono { font-family: var(--mono); font-size: 12px; }
+code { background: var(--gray-bg); padding: 1px 5px; border-radius: 4px; }
+h1, h2, h3 { margin: 0; font-weight: 600; text-wrap: balance; }
+h1 { font: 600 30px/1.15 var(--display); letter-spacing: -0.025em; }
+h2 { font-size: 13px; letter-spacing: 0.01em; }
+h3 { font-size: 13px; margin: 28px 0 10px; }
+p { margin: 0 0 8px; }
+.quiet { color: var(--quiet); }
+.small { font-size: 12px; }
+.strong { font-weight: 600; }
+.clip { display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; max-width: 100%; }
+.clip.short { max-width: 180px; }
+td.wide { width: auto; }
+td .stack { min-width: 0; }
+.stack { display: flex; flex-direction: column; line-height: 1.35; }
+
+/* ---- shell ---- */
+.shell { display: grid; grid-template-columns: 232px 1fr; min-height: 100vh; }
+.side { position: sticky; top: 0; height: 100vh; padding: 28px 18px; border-right: 1px solid var(--line); display: flex; flex-direction: column; gap: 18px; }
+.brand { font: 700 17px/1 var(--display); letter-spacing: -0.02em; padding: 0 10px; }
+.switch { margin: 0 2px; }
+.switch.static { padding: 7px 10px; border: 1px solid var(--line); border-radius: 6px; background: var(--surface); font-weight: 500; }
+.side nav { display: flex; flex-direction: column; gap: 2px; }
+.side nav a { display: flex; align-items: center; justify-content: space-between; padding: 7px 10px; border-radius: 6px; color: var(--ink-2); text-decoration: none; }
+.side nav a:hover { background: var(--hover); color: var(--ink); }
+.side nav a[aria-current="page"] { background: var(--surface); color: var(--ink); font-weight: 500; box-shadow: 0 0 0 1px var(--line); }
+.count { font: 600 11px/1 var(--sans); background: var(--yellow-bg); color: var(--yellow); padding: 3px 7px; border-radius: 999px; font-variant-numeric: tabular-nums; }
+.side-foot { margin-top: auto; padding: 0 10px; font-size: 12px; color: var(--quiet); line-height: 1.5; }
+main { min-width: 0; }
+.page { max-width: 1040px; margin: 0 auto; padding: 56px 48px 96px; animation: rise 500ms var(--ease) both; }
+@keyframes rise { from { opacity: 0; transform: translateY(8px); } }
+
+.head { display: flex; justify-content: space-between; align-items: flex-end; gap: 24px; margin-bottom: 36px; }
+.lede { color: var(--quiet); margin: 10px 0 0; max-width: 62ch; }
+.head-aside { flex: none; }
+
+/* ---- controls ---- */
+button, .button {
+  font: 500 13px/1 var(--sans); padding: 9px 14px; border-radius: 6px; border: 1px solid var(--button);
+  background: var(--button); color: var(--button-ink); cursor: pointer; text-decoration: none; display: inline-flex; align-items: center; gap: 6px;
+  transition: transform 120ms var(--ease), opacity 120ms;
+}
+button:hover, .button:hover { opacity: 0.86; }
+button:active, .button:active { transform: scale(0.98); }
+button:disabled { opacity: 0.4; cursor: default; transform: none; }
+button.ghost { background: transparent; color: var(--ink); border-color: var(--line-2); }
+button.ghost:hover { background: var(--hover); opacity: 1; }
+button.link { background: none; border: 0; padding: 0; color: inherit; font: inherit; text-decoration: underline; text-decoration-color: var(--line-2); text-underline-offset: 3px; }
+button.link:hover { text-decoration-color: currentColor; opacity: 1; }
+button.link.strong { font-weight: 600; text-decoration: none; }
+input, select { font: 13px/1.2 var(--sans); color: var(--ink); background: var(--surface); border: 1px solid var(--line-2); border-radius: 6px; padding: 8px 10px; }
+input:focus-visible, select:focus-visible, button:focus-visible, a:focus-visible, tr:focus-visible { outline: 2px solid var(--blue); outline-offset: 2px; }
+.actions { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 12px; }
+.actions.tight { margin-top: 0; }
+.card.add { margin-bottom: 20px; }
+.card.add h2 { margin-bottom: 4px; }
+.manual { margin: 0 0 18px; }
+.manual summary { cursor: pointer; }
+.answer { display: flex; gap: 8px; margin-top: 12px; flex-wrap: wrap; }
+.answer input { flex: 1; min-width: 220px; }
+
+/* ---- tags ---- */
+.tag { display: inline-block; font: 600 10.5px/1 var(--sans); letter-spacing: 0.05em; text-transform: uppercase; padding: 4px 8px; border-radius: 999px; white-space: nowrap; }
+.tag.green { background: var(--green-bg); color: var(--green); }
+.tag.blue { background: var(--blue-bg); color: var(--blue); }
+.tag.yellow { background: var(--yellow-bg); color: var(--yellow); }
+.tag.red { background: var(--red-bg); color: var(--red); }
+.tag.gray { background: var(--gray-bg); color: var(--gray); }
+
+/* ---- overview ---- */
+.stats { display: grid; grid-template-columns: repeat(4, 1fr); border: 1px solid var(--line); border-radius: 12px; background: var(--surface); margin-bottom: 20px; }
+.stat { padding: 22px 24px; text-decoration: none; display: flex; flex-direction: column; gap: 4px; transition: background 160ms; }
+.stat + .stat { border-left: 1px solid var(--line); }
+.stat:hover { background: var(--hover); }
+.stat:first-child { border-radius: 12px 0 0 12px; }
+.stat:last-child { border-radius: 0 12px 12px 0; }
+.stat-n { font: 600 34px/1 var(--display); letter-spacing: -0.03em; font-variant-numeric: tabular-nums; }
+.stat-n.green { color: var(--green); }
+.stat-n.yellow { color: var(--yellow); }
+.stat-label { color: var(--quiet); font-size: 13px; }
+.grid-2 { display: grid; grid-template-columns: 1fr 1fr; gap: 20px; align-items: start; }
+.gap-top { margin-top: 20px; }
+.gap-top .facts div { grid-template-columns: 140px 1fr; }
+.card { background: var(--surface); border: 1px solid var(--line); border-radius: 12px; padding: 24px 26px; min-width: 0; }
+.card h2 { margin-bottom: 14px; }
+.card .block-head h2 { margin-bottom: 0; }
+.big-line { display: flex; align-items: baseline; gap: 12px; margin-bottom: 12px; }
+.big-line strong { font: 600 20px/1 var(--display); letter-spacing: -0.02em; font-variant-numeric: tabular-nums; }
+.big-line .dr { font-size: 34px; letter-spacing: -0.03em; }
+.up { color: var(--green); font-weight: 500; }
+.down { color: var(--red); font-weight: 500; }
+.bar { height: 6px; background: var(--gray-bg); border-radius: 999px; overflow: hidden; margin: 4px 0 12px; }
+.bar span { display: block; height: 100%; background: var(--ink); border-radius: 999px; transition: width 600ms var(--ease); }
+.chart { width: 100%; height: auto; display: block; margin: 4px 0 10px; overflow: visible; }
+.chart .grid { stroke: var(--line); stroke-width: 1; }
+.chart .axis { fill: var(--quiet); font: 10px var(--sans); font-variant-numeric: tabular-nums; }
+.chart .line { stroke: var(--ink); stroke-width: 1.75; stroke-linecap: round; }
+.chart .line.dotted { stroke: var(--quiet); stroke-dasharray: 2 4; }
+.chart .point { fill: var(--surface); stroke: var(--ink); stroke-width: 1.5; }
+
+.block { margin-top: 48px; }
+.block-head { display: flex; justify-content: space-between; align-items: center; gap: 12px; margin-bottom: 12px; }
+.block > h2 { margin-bottom: 12px; }
+.note { margin: -4px 0 14px; max-width: 70ch; }
+.gap { margin-top: 32px; margin-bottom: 8px; }
+
+.list { list-style: none; margin: 0; padding: 0; border-top: 1px solid var(--line); }
+.list li { border-bottom: 1px solid var(--line); }
+.row-button { width: 100%; display: grid; grid-template-columns: 180px 1fr auto; gap: 16px; align-items: center; padding: 12px 4px; background: none; border: 0; border-radius: 0; color: var(--ink); text-align: left; font-weight: 400; }
+.row-button:hover { background: var(--hover); opacity: 1; }
+.row-title { font-weight: 600; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.row-text { color: var(--quiet); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+
+.feed { list-style: none; margin: 0; padding: 0; border-top: 1px solid var(--line); }
+.feed li { display: grid; grid-template-columns: 80px 180px 1fr; gap: 16px; padding: 10px 4px; border-bottom: 1px solid var(--line); align-items: baseline; min-width: 0; }
+.feed .link { text-align: left; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+
+/* ---- needs you ---- */
+.items { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 10px; }
+.item { background: var(--surface); border: 1px solid var(--line); border-radius: 10px; padding: 18px 20px; transition: box-shadow 200ms; }
+.item:hover { box-shadow: 0 2px 8px rgba(0, 0, 0, 0.04); }
+.item-head { display: flex; justify-content: space-between; align-items: baseline; gap: 12px; margin-bottom: 6px; }
+.item-head > .quiet { white-space: nowrap; }
+.todo { display: grid; grid-template-columns: 1fr auto; gap: 4px 20px; align-items: center; padding: 14px 4px; border-bottom: 1px solid var(--line); }
+.todo p { margin: 0; color: var(--ink-2); }
+.todo a { grid-column: 1; font-size: 12px; color: var(--quiet); }
+.todo button { grid-column: 2; grid-row: 1 / span 2; }
+.items:has(.todo) { gap: 0; border-top: 1px solid var(--line); }
+.item p { color: var(--ink-2); max-width: 78ch; overflow-wrap: anywhere; }
+.fold { margin-top: 48px; border-top: 1px solid var(--line); padding-top: 16px; }
+.fold summary { cursor: pointer; font-weight: 600; font-size: 13px; list-style: none; }
+.fold summary::before { content: "+"; display: inline-block; width: 16px; color: var(--quiet); }
+.fold[open] summary::before { content: "−"; }
+.fold .items { margin-top: 14px; }
+
+/* ---- notices ---- */
+.notice { border-radius: 10px; padding: 16px 18px; margin-bottom: 20px; border: 1px solid var(--line); background: var(--surface); }
+.notice.green { background: var(--green-bg); border-color: transparent; }
+.notice.blue { background: var(--blue-bg); border-color: transparent; }
+.notice.yellow { background: var(--yellow-bg); border-color: transparent; }
+.notice.red { background: var(--red-bg); border-color: transparent; }
+.notice p { overflow-wrap: anywhere; }
+.diff { margin: 10px 0 0; display: grid; gap: 6px; }
+.diff div { display: grid; grid-template-columns: 90px 1fr; gap: 12px; }
+.diff dt { color: var(--quiet); }
+.diff dd { margin: 0; font-family: var(--mono); font-size: 12px; overflow-wrap: anywhere; }
+
+/* ---- table ---- */
+.table { background: var(--surface); border: 1px solid var(--line); border-radius: 12px; overflow: hidden; }
+.toolbar { display: flex; gap: 10px; align-items: center; padding: 14px 16px; border-bottom: 1px solid var(--line); }
+.toolbar input[type="search"] { width: 280px; }
+.count-label { margin-left: auto; font-variant-numeric: tabular-nums; }
+.chips { display: flex; flex-wrap: wrap; gap: 6px; padding: 12px 16px; border-bottom: 1px solid var(--line); }
+.chip { background: transparent; color: var(--ink-2); border: 1px solid var(--line-2); border-radius: 6px; padding: 6px 10px; font-weight: 500; font-size: 12px; }
+.chip span { color: var(--quiet); font-variant-numeric: tabular-nums; margin-left: 2px; }
+.chip:hover { background: var(--hover); opacity: 1; }
+.chip[aria-pressed="true"] { background: var(--button); color: var(--button-ink); border-color: var(--button); }
+.chip[aria-pressed="true"] span { color: inherit; opacity: 0.7; }
+.scroll { overflow-x: auto; }
+table { width: 100%; border-collapse: collapse; }
+th { text-align: left; padding: 0; border-bottom: 1px solid var(--line); background: var(--canvas); }
+.sort { width: 100%; background: none; border: 0; color: var(--quiet); font: 500 12px/1 var(--sans); padding: 11px 16px; justify-content: flex-start; border-radius: 0; }
+.sort:hover { color: var(--ink); opacity: 1; }
+td { padding: 11px 16px; border-bottom: 1px solid var(--line); vertical-align: middle; max-width: 0; white-space: nowrap; }
+td:not(.wide) { width: 1%; max-width: none; }
+tr:last-child td { border-bottom: 0; }
+tr.clickable { cursor: pointer; }
+tr.clickable:hover td { background: var(--hover); }
+th.num, td.num { text-align: right; }
+th.num .sort { justify-content: flex-end; }
+.more { margin: 12px 16px; }
+.pad { padding: 24px 16px; }
+
+/* ---- facts, lists, media ---- */
+.facts { margin: 0; display: grid; gap: 10px; }
+.facts div { display: grid; grid-template-columns: 110px 1fr; gap: 14px; }
+.facts dt { color: var(--quiet); }
+.facts dt::first-letter { text-transform: uppercase; }
+.facts dd { margin: 0; overflow-wrap: anywhere; }
+.plain { margin: 0; padding-left: 18px; color: var(--ink-2); }
+.plain li { margin: 4px 0; }
+.perms { list-style: none; margin: 10px 0 0; padding: 0; display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 0 24px; }
+.perms li { display: flex; justify-content: space-between; align-items: center; padding: 8px 0; border-bottom: 1px solid var(--line); gap: 12px; }
+.perms code { background: none; padding: 0; }
+.shots { list-style: none; margin: 12px 0 0; padding: 0; display: grid; grid-template-columns: repeat(auto-fill, minmax(180px, 1fr)); gap: 12px; }
+.shots img { width: 100%; aspect-ratio: 16 / 10; object-fit: cover; border-radius: 8px; border: 1px solid var(--line); display: block; }
+.shots span { display: block; font-size: 12px; color: var(--quiet); margin-top: 6px; }
+.fields { list-style: none; margin: 0; padding: 0; border-top: 1px solid var(--line); }
+.fields li { display: flex; justify-content: space-between; gap: 12px; padding: 8px 0; border-bottom: 1px solid var(--line); }
+.playbook { white-space: pre-wrap; font-size: 13px; color: var(--ink-2); background: var(--canvas); border: 1px solid var(--line); border-radius: 8px; padding: 14px 16px; max-height: 360px; overflow: auto; }
+
+/* ---- side panel ---- */
+.backdrop { position: fixed; inset: 0; background: rgba(15, 15, 15, 0.18); animation: fade 200ms both; }
+.panel { position: fixed; top: 0; right: 0; bottom: 0; width: min(560px, 100vw); background: var(--surface); border-left: 1px solid var(--line); padding: 28px 30px 48px; overflow-y: auto; animation: slide 320ms var(--ease) both; }
+.panel-head { display: flex; justify-content: space-between; align-items: flex-start; gap: 16px; margin-bottom: 18px; }
+.panel-head h2 { font: 600 22px/1.2 var(--display); letter-spacing: -0.02em; margin-bottom: 4px; }
+.links { display: flex; flex-wrap: wrap; align-items: center; gap: 14px; margin-bottom: 18px; }
+.timeline section + section { margin-top: 16px; }
+.timeline h4 { margin: 0 0 6px; font-size: 12px; font-weight: 600; color: var(--quiet); }
+.timeline ol { list-style: none; margin: 0; padding: 0; border-left: 1px solid var(--line-2); }
+.timeline li { display: grid; grid-template-columns: 52px 1fr; gap: 12px; padding: 5px 0 5px 16px; position: relative; overflow-wrap: anywhere; color: var(--ink-2); }
+.timeline li::before { content: ""; position: absolute; left: -3.5px; top: 13px; width: 6px; height: 6px; border-radius: 50%; background: var(--line-2); }
+.timeline li.you { color: var(--ink); }
+.timeline li.you::before { background: var(--ink); }
+.timeline time { font-variant-numeric: tabular-nums; padding-top: 1px; }
+.raw { margin-top: 24px; }
+.raw pre { background: var(--canvas); border: 1px solid var(--line); border-radius: 8px; padding: 12px; max-height: 320px; overflow: auto; }
+@keyframes fade { from { opacity: 0; } }
+@keyframes slide { from { transform: translateX(24px); opacity: 0; } }
+
+@media (max-width: 900px) {
+  .shell { grid-template-columns: 1fr; }
+  .side { position: static; height: auto; flex-direction: row; flex-wrap: wrap; align-items: center; padding: 14px 16px; border-right: 0; border-bottom: 1px solid var(--line); }
+  .side nav { flex-direction: row; flex-wrap: wrap; }
+  .side-foot { display: none; }
+  .page { padding: 32px 18px 64px; }
+  .stats, .grid-2 { grid-template-columns: 1fr 1fr; }
+  .grid-2 { grid-template-columns: 1fr; }
+  .head { flex-direction: column; align-items: flex-start; }
+  .feed li { grid-template-columns: 64px 1fr; }
+  .feed li > :last-child { grid-column: 2; }
+}
+@media (prefers-reduced-motion: reduce) {
+  *, *::before, *::after { animation: none !important; transition: none !important; }
+}
+.facts.gap-top { margin-top: 22px; }
+.grid-2.stretch { align-items: stretch; }
+.segments { display: flex; gap: 3px; height: 8px; margin: 6px 0 18px; }
+.segments span { border-radius: 2px; min-width: 3px; }
+.segments .green, .dot.green { background: var(--green); }
+.segments .blue, .dot.blue { background: var(--blue); }
+.segments .yellow, .dot.yellow { background: var(--yellow); }
+.segments .gray, .dot.gray { background: var(--quiet); }
+.segments .faint, .dot.faint { background: var(--line-2); }
+.legend { list-style: none; margin: 0 0 14px; padding: 0; border-top: 1px solid var(--line); }
+.legend li { border-bottom: 1px solid var(--line); }
+.legend a { display: flex; align-items: center; gap: 10px; padding: 7px 0; text-decoration: none; color: var(--ink-2); }
+.legend a:hover { color: var(--ink); }
+.dot { width: 8px; height: 8px; border-radius: 2px; flex: none; }
+.legend-n { margin-left: auto; font-variant-numeric: tabular-nums; color: var(--ink); font-weight: 500; }
+
+/* Selects: native control, custom face. The chevron is two gradient strokes, so it follows the theme. */
+select {
+  appearance: none; -webkit-appearance: none; cursor: pointer;
+  padding-right: 30px; min-height: 34px; line-height: 1.2;
+  background-image: linear-gradient(45deg, transparent 50%, var(--quiet) 50%), linear-gradient(135deg, var(--quiet) 50%, transparent 50%);
+  background-position: calc(100% - 15px) 50%, calc(100% - 10px) 50%;
+  background-size: 5px 5px, 5px 5px; background-repeat: no-repeat;
+  transition: border-color 0.15s, box-shadow 0.15s;
+}
+select:hover { border-color: var(--quiet); }
+select:focus-visible { outline: none; border-color: var(--blue); box-shadow: 0 0 0 3px var(--blue-bg); }
+select option { background: var(--surface); color: var(--ink); }

package/src/workspace.ts

@@ -0,0 +1,97 @@
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { z } from "zod";
+import { HOME } from "./db";
+
+export const WORKSPACE = process.env.LAUNCH_WORKSPACE ?? join(HOME, "workspace");
+export const PRODUCTS = join(WORKSPACE, "products");
+
+// The product id is its directory name: workspace/products/<id>/product.yaml
+export const Product = z.object({
+  name: z.string(),
+  version: z.string().optional(),
+  release_url: z.url().optional(),
+  url: z.url(),
+  tagline: z.string(),
+  descriptions: z.object({ short: z.string(), medium: z.string().optional(), long: z.string().optional() }),
+  categories: z.array(z.string()).default([]),
+  features: z.array(z.string()).default([]),
+  pricing: z.object({ free_plan: z.boolean(), notes: z.string().optional() }),
+  social: z.record(z.string(), z.string().nullable()).default({}),
+  // Facts forms often ask for (country, launch date/status, tech stack).
+  country: z.string().nullish(),
+  city: z.string().nullish(),
+  launched: z.string().nullish(), // YYYY-MM or YYYY-MM-DD
+  status: z.enum(["idea", "beta", "launched"]).optional(),
+  tech_stack: z.array(z.string()).default([]),
+  // Standing answers to questions directories keep asking.
+  replaces: z.array(z.string()).default([]), // well-known products this replaces ("alternative to …")
+  company_stage: z.string().nullish(), // free text; map to the form's closest option
+  funding: z.string().nullish(),
+  username: z.string().nullish(), // default handle when a site needs a permanent username
+  listing_rules: z.array(z.string()).default([]), // e.g. "title is always the product name"
+  assets: z.object({ logo: z.string().optional(), icon: z.string().optional() }).default({}),
+  screenshots: z
+    .array(z.object({ id: z.string(), path: z.string(), description: z.string(), priority: z.number().default(0) }))
+    .default([]),
+});
+export type Product = z.infer<typeof Product> & { id: string; dir: string };
+
+export const Identity = z.object({
+  display_name: z.string(),
+  username: z.string(),
+  email: z.email(),
+  company: z.string().optional(),
+  role: z.string().optional(),
+});
+
+const Mode = z.enum(["automatic", "confirm", "never"]);
+export const Permissions = z.record(z.string(), z.record(z.string(), Mode));
+export type Mode = z.infer<typeof Mode>;
+
+async function load<T extends z.ZodType>(path: string, schema: T): Promise<z.infer<T>> {
+  if (!existsSync(path)) throw new Error(`missing ${path} — run 'dirpush init <product-id>' and fill it in`);
+  return schema.parse(Bun.YAML.parse(await Bun.file(path).text()));
+}
+
+export const productIds = () =>
+  existsSync(PRODUCTS) ? readdirSync(PRODUCTS).filter((d) => existsSync(join(PRODUCTS, d, "product.yaml"))).sort() : [];
+
+/** Explicit id, else LAUNCH_PRODUCT, else the only product. */
+export function resolveProductId(id = process.env.LAUNCH_PRODUCT) {
+  if (id) {
+    if (!productIds().includes(id)) throw new Error(`no product '${id}' (have: ${productIds().join(", ") || "none"})`);
+    return id;
+  }
+  const ids = productIds();
+  if (ids.length === 1) return ids[0]!;
+  throw new Error(ids.length ? `several products (${ids.join(", ")}): pass --product <id> or set LAUNCH_PRODUCT` : "no products yet: run 'dirpush init <product-id>'");
+}
+
+export async function loadProduct(id?: string): Promise<Product> {
+  const pid = resolveProductId(id);
+  const dir = join(PRODUCTS, pid);
+  return { ...(await load(join(dir, "product.yaml"), Product)), id: pid, dir };
+}
+
+/** Per-product file if present, else the shared workspace one. */
+const shared = (file: string, id?: string) => {
+  const own = id && join(PRODUCTS, id, file);
+  return own && existsSync(own) ? own : join(WORKSPACE, file);
+};
+export const loadIdentity = (id?: string) => load(shared("identity.yaml", id), Identity);
+export const loadPermissions = (id?: string) => load(shared("permissions.yaml", id), Permissions);
+
+/** `accounts.create` -> automatic|confirm|never. Unlisted actions require confirmation. */
+export async function permission(action: string, productId?: string): Promise<Mode> {
+  const [group, key] = action.split(".");
+  const perms = await loadPermissions(productId);
+  return perms[group!]?.[key!] ?? "confirm";
+}
+
+export function utm(productUrl: string, directoryId: string) {
+  const u = new URL(productUrl);
+  u.searchParams.set("utm_source", directoryId);
+  u.searchParams.set("utm_medium", "directory");
+  return u.toString();
+}