@vibes.diy/api-svc 13.0.2 → 13.0.4

package/usage-report/backfill-release-tailwind.js

@@ -0,0 +1,109 @@
+import { Pool } from "@neondatabase/serverless";
+import { drizzle as drizzleNeon } from "drizzle-orm/neon-serverless";
+import { Result, exception2Result } from "@adviser/cement";
+import { ensureSuperThis } from "@vibes.diy/identity";
+import { ensureStorage } from "@vibes.diy/api-pkg";
+import { createSQLPeer, createVibesApiTables } from "@vibes.diy/api-sql";
+import { DEFAULT_TAILWIND_BACKFILL_CONCURRENCY, runTailwindBackfill, } from "./backfill-release-tailwind-util.js";
+import { parsePositiveIntFlag } from "./backfill-published-chips-util.js";
+import { formatError, loadDevVars } from "./usage-report-util.js";
+const PROGRESS_EVERY = 25;
+function printUsage() {
+    console.log(`
+Usage:
+  pnpm --dir vibes.diy/api/svc run admin:backfill-release-tailwind                       # dry run (read-only)
+  pnpm --dir vibes.diy/api/svc run admin:backfill-release-tailwind -- --apply            # write pass
+  ... -- --apply --limit 50                                                               # cap for a controlled batch
+  ... -- --apply --concurrency 4                                                          # default ${DEFAULT_TAILWIND_BACKFILL_CONCURRENCY}
+
+--limit and --concurrency take a POSITIVE INTEGER. A bad value is an error, not
+a fallback — an unusable --limit must never quietly mean "sweep everything".
+
+Environment:
+  NEON_DATABASE_URL         read/discovery connection (dry run)
+  NEON_DATABASE_ADMIN_URL   write connection (required for --apply)
+`.trim());
+}
+function describe(row) {
+    const label = `@${row.ownerHandle}/${row.appSlug}`;
+    const seq = row.releaseSeq === undefined ? "" : ` seq=${row.releaseSeq}`;
+    const css = row.cssBytes === undefined ? "" : ` css=${row.cssBytes}B`;
+    const cands = row.candidates === undefined ? "" : ` cand=${row.candidates}`;
+    const reason = row.reason === undefined ? "" : ` (${row.reason})`;
+    return `${row.outcome.toUpperCase().padEnd(14)}${label}${seq}${cands}${css}${reason}`;
+}
+async function run() {
+    loadDevVars();
+    const args = process.argv.slice(2);
+    if (args.includes("--help") || args.includes("-h")) {
+        printUsage();
+        return Result.Ok(undefined);
+    }
+    const apply = args.includes("--apply");
+    const rLimit = parsePositiveIntFlag(args, "--limit");
+    if (rLimit.isErr()) {
+        printUsage();
+        return Result.Err(rLimit.Err());
+    }
+    const rConcurrency = parsePositiveIntFlag(args, "--concurrency");
+    if (rConcurrency.isErr()) {
+        printUsage();
+        return Result.Err(rConcurrency.Err());
+    }
+    const limit = rLimit.Ok();
+    const concurrency = rConcurrency.Ok() ?? DEFAULT_TAILWIND_BACKFILL_CONCURRENCY;
+    const connectionString = apply ? process.env["NEON_DATABASE_ADMIN_URL"] : process.env["NEON_DATABASE_URL"];
+    if (connectionString === undefined) {
+        printUsage();
+        return Result.Err(`${apply ? "NEON_DATABASE_ADMIN_URL" : "NEON_DATABASE_URL"} is required (set in .dev.vars or env)`);
+    }
+    const pool = new Pool({ connectionString });
+    const db = drizzleNeon(pool);
+    const tables = createVibesApiTables("pg");
+    const vctx = {
+        sthis: ensureSuperThis(),
+        sql: { db, tables, flavour: "pg" },
+        storage: ensureStorage({}, createSQLPeer({ flavour: "pg", db, assets: tables.assets })),
+    };
+    const result = await exception2Result(async () => {
+        const summary = await runTailwindBackfill(vctx, {
+            apply,
+            ...(limit === undefined ? {} : { limit }),
+            concurrency,
+            onRow: (row, done, total) => {
+                if (row.outcome === "failed" || row.outcome === "deferred")
+                    console.log(describe(row));
+                if (done % PROGRESS_EVERY === 0 || done === total)
+                    console.log(`  … ${done}/${total}`);
+            },
+        });
+        console.log(`\ncandidates=${summary.candidates} (every published app — the artifact check happens per app)`);
+        if (apply === false) {
+            console.log(`planned=${summary.planned} skipped=${summary.skipped} no-candidates=${summary.noCandidates} deferred=${summary.deferred} failed=${summary.failed}\n` +
+                `skipped = live release already carries an artifact, or is not production — nothing to do.\n` +
+                `Dry run — nothing written. Re-run with --apply (concurrency ${concurrency}).`);
+            return undefined;
+        }
+        console.log(`compiled=${summary.compiled} skipped=${summary.skipped} no-candidates=${summary.noCandidates} deferred=${summary.deferred} failed=${summary.failed}\n` +
+            `no-candidates = the release really uses no utilities, so a deploy today would emit no artifact either.\n` +
+            `deferred = a source this context could not read (R2) — NOT "no utilities"; those releases still pay the per-request compile.`);
+        if (summary.failed > 0 || summary.deferred > 0) {
+            return `sweep finished with ${summary.failed} failed and ${summary.deferred} deferred app(s) — re-run to retry (covered releases are skipped)`;
+        }
+        return undefined;
+    });
+    await pool.end();
+    if (result.isErr())
+        return Result.Err(result.Err());
+    const partial = result.Ok();
+    if (partial !== undefined)
+        return Result.Err(partial);
+    return Result.Ok(undefined);
+}
+run().then((r) => {
+    if (r.isErr()) {
+        console.error(formatError(r.Err()));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=backfill-release-tailwind.js.map

package/usage-report/backfill-release-tailwind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill-release-tailwind.js","sourceRoot":"","sources":["../../jsr/usage-report/backfill-release-tailwind.ts"],"names":[],"mappings":"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"}

package/usage-report/check-env.sh

@@ -18,6 +18,12 @@
 
 set -uo pipefail
 
+# macOS ships bash 3.2, so this script must stay 3.2-compatible. Two traps:
+#   - a quoted heredoc inside $(...) mis-parses quotes on 3.2 (an apostrophe in
+#     the spec text below was enough to make the whole file a syntax error)
+#   - `associative arrays, ${var^^}, mapfile` are all 4.0+
+# Keep new code inside that subset rather than raising the requirement.
+
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 DEV_VARS="$SCRIPT_DIR/../.dev.vars"
 
@@ -39,7 +45,7 @@ done
 # The reference set. Each entry: NAME|TOOLS|SEVERITY|what breaks without it
 # SEVERITY: required = tool refuses to run · silent = tool runs and LIES · optional
 # ---------------------------------------------------------------------------
-SPEC=$(cat <<'SPEC_END'
+IFS= read -r -d '' SPEC <<'SPEC_END'
 NEON_DATABASE_URL|journey,db-inspect|required|Prod Neon connection. Without it `journey` exits with "NEON_DATABASE_URL is required" and `db:inspect` cannot run at all. DATABASE_URL is accepted as a fallback. This is the one failure that is loud.
 AUTUMN_SECRET_KEY|journey|silent|THE BIG ONE. Billing plane (plan, credit balance, wall crossing, conversion). Missing key is INDISTINGUISHABLE in the output from a user Autumn never saw: the report prints "NOT in Autumn (customer_not_found) — no billing signal" and ">> VERDICT: no Autumn record | converted: none" for EVERY user. Every paywall casualty reads as never-walled and every subscriber reads as never-converted. If Meghan's reports say nobody converted, suspect this before believing it.
 CLERK_SECRET_KEY|journey,vibe-usage|silent|Identity plane (name, email, signup date). Missing key silently yields "identity: (no name) (none) signup=?" — the rest of the report renders normally, so it looks like a user with no profile rather than a broken env. Also required by vibe-usage.py for the sign-up funnel leg.
@@ -59,7 +65,6 @@ MAILCHIMP_API_KEY|legacy|optional|No script in either repo reads this. The newsl
 GA4_PROPERTY_ID|legacy|optional|STALE. Google Analytics was retired in favour of PostHog as the single analytics sink (#4257) and nothing in either repo reads this. Safe to delete from your env; if you are reaching for it, you want POSTHOG_API_KEY.
 GA4_SA_KEY|legacy|optional|STALE — same as GA4_PROPERTY_ID. A Google service-account key with no remaining consumer; worth deleting rather than carrying a live credential nothing uses.
 SPEC_END
-)
 
 # A var counts as present only if its EFFECTIVE value is non-empty. .dev.vars is
 # parsed exactly the way loadDevVars() does — first occurrence wins, surrounding
@@ -109,7 +114,7 @@ if [ "$MODE" = "diff" ]; then
   REF_NAMES=$(grep -oE '^[[:space:]]*(export[[:space:]]+)?[A-Za-z_][A-Za-z0-9_]*=' \
     | sed -E 's/^[[:space:]]*(export[[:space:]]+)?//; s/=$//' | sort -u)
   if [ -z "$REF_NAMES" ]; then
-    echo "${RED}No VAR= lines found on stdin.${RST} Expected `env`-style output, e.g.  pbpaste | $0 --diff" >&2
+    echo "${RED}No VAR= lines found on stdin.${RST} Expected env-style output, e.g.  pbpaste | $0 --diff" >&2
     exit 2
   fi
   echo "${BLD}Names present in the reference env but not in yours${RST} ${DIM}(values never read)${RST}"