@rtrentjones/greenlight 0.2.24 → 0.2.25

package/assets/skills/provider-neon/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: provider-neon
+description: How Neon works in a Greenlight setup — the `data: neon` store (serverless Postgres), git-style branch-per-env, scale-to-zero + auto-resume (so NO keepalive, unlike Supabase), pooled vs direct connection strings, the NEON_API_KEY, and migrations on a branch. Use when wiring a tool's database, choosing Neon vs Supabase, or a Neon apply.
+---
+
+# provider-neon
+
+`data: neon` is the **default Postgres** — for tools that need a SQL database and nothing else
+bundled. One Neon **project** per tool, **a branch per env** (git-style copy-on-write): `prod` is
+the project's default branch; `beta` is a child branch (separate data, instant to create). Compute
+**autosuspends and auto-resumes on the next connection**, so a Neon tool needs **no keepalive** —
+that's the whole reason Neon is preferred over Supabase, which pauses for 7 days and needs a manual
+unpause. Choose `supabase` only when you need bundled auth + storage + realtime together.
+
+## Token — `NEON_API_KEY`
+
+Console → Account settings → API keys. Account-level (configures the `neon` provider for every Neon
+tool, like `CLOUDFLARE_API_TOKEN`) — **not** per-tool. `greenlight add` verifies it against
+`/api/v2/projects` (HTTP 200). There is **no per-tool secret**: the role/password/connection strings
+are module OUTPUTS, not inputs.
+
+## Terraform module — `infra/modules/neon`
+
+Creates the project (default branch = prod) + a `neon_branch` per non-prod env (except `preview`,
+which is ephemeral/per-PR — created by CI, not Terraform). Outputs two per-env maps:
+- **`database_url[env]`** — the **pooled** (pgbouncer) string → `DATABASE_URL` for the serverless app.
+- **`direct_url[env]`** — the **direct** string → `DIRECT_URL` for migrations.
+
+The emitted `<name>.tf` wires `database_url["prod"]`/`["beta"]` into the Vercel env per target, so
+prod and beta hit **different branches**. Pin the provider `kislerdm/neon ~> 0.13`.
+
+## No keepalive
+
+Do **not** add a Neon tool to `module.keepalive.targets_json`. Neon resumes on connect — a request
+just wakes it. (`doctor` does not flag `data: neon` for keepalive; that exemption is intentional.)
+
+## Migrations
+
+Run migrations against the env's **branch** (`DIRECT_URL`). A PR's ephemeral branch is the safe place
+to test a migration before it touches prod. Gate them with `greenlight migrations scan` (the
+dangerous-SQL pre-apply check) in the tool's CI.
+
+## MCP
+
+`.mcp.json` wires `neon` (hosted) with `Authorization: Bearer ${NEON_API_KEY}`. Run `/mcp` to auth.
+
+## Rule
+The **blog must never use a database** that can pause — but Neon's auto-resume makes it safe for
+*tools*; still, the apex blog stays `data: none` (D1/KV/external only). Neon is per-tool Postgres.

package/dist/bin.js

@@ -6,7 +6,7 @@ import {
   resolveUrl,
   scanSqlFiles,
   verifyAll
-} from "./chunk-2A7ZBBYN.js";
+} from "./chunk-GPPUZ6Z5.js";
 import "./chunk-HX7VA25D.js";
 import "./chunk-N3IKUCSF.js";
 import "./chunk-KP3Y6WRU.js";
@@ -317,6 +317,37 @@ var PACKS = [
     skill: "provider-supabase",
     tfModules: ["supabase"]
   },
+  {
+    id: "neon",
+    name: "Neon",
+    appliesTo: (t) => t.data === "neon",
+    guide: "docs/provider-tokens.md \u2014 NEON_API_KEY (project + branch management)",
+    setupUrl: "https://console.neon.tech/app/settings/api-keys",
+    tokens: [
+      {
+        // Shared account credential (configures the neon TF provider, like CLOUDFLARE_API_TOKEN) —
+        // NOT per-tool. The role password + connection string are module OUTPUTS, not inputs, so
+        // (unlike Supabase) there is no per-tool password variable to gather.
+        envVar: "NEON_API_KEY",
+        label: "Neon API key (project + branch management)",
+        verify: async (t) => {
+          const r = await fetch("https://console.neon.tech/api/v2/projects", {
+            headers: { Authorization: `Bearer ${t}` }
+          });
+          return { ok: okStatus(r), detail: `HTTP ${r.status}` };
+        }
+      }
+    ],
+    mcp: {
+      neon: {
+        type: "http",
+        url: "https://mcp.neon.tech/mcp",
+        headers: { Authorization: "Bearer ${NEON_API_KEY}" }
+      }
+    },
+    skill: "provider-neon",
+    tfModules: ["neon"]
+  },
   {
     id: "hcp",
     name: "HCP Terraform (remote state)",
@@ -444,7 +475,7 @@ function tokensForTool(tool) {
 }
 
 // src/version.ts
-var MODULE_REF = "v0.2.24";
+var MODULE_REF = "v0.2.25";
 var MODULE_SOURCE_BASE = "git::https://github.com/RTrentJones/greenlight.git//infra/modules";
 function moduleSource(module, ref = MODULE_REF) {
   return `${MODULE_SOURCE_BASE}/${module}?ref=${ref}`;
@@ -457,6 +488,7 @@ function emitToolTf(opts) {
   const port = opts.port ?? 8e3;
   const slug = opts.slug ?? `OWNER/${name}`;
   const useSupabase = data === "supabase";
+  const useNeon = data === "neon";
   const useVercel = target === "vercel";
   const useOci = target === "oci";
   const supabaseOverride = opts.tokenOverrides?.SUPABASE_ACCESS_TOKEN;
@@ -467,9 +499,9 @@ function emitToolTf(opts) {
   if (useSupabase) assumes.push("var.supabase_organization_id");
   const ghcrOwner = (slug.split("/")[0] ?? "owner").toLowerCase();
   blocks.push(
-    `# ${name} \u2014 ${lane}/${target}${useSupabase ? "/supabase" : ""}, emitted by \`greenlight add\`.
+    `# ${name} \u2014 ${lane}/${target}${data && data !== "none" ? `/${data}` : ""}, emitted by \`greenlight add\`.
 # Review, then commit + push: the wrapper's infra.yml (HCP-backed) runs \`terraform apply\`.
-# Assumes infra/main.tf declares: ${[useVercel && "vercel", useSupabase && "supabase", useOci && "oci"].filter(Boolean).join(" + ") || "cloudflare + github"} provider(s)
+# Assumes infra/main.tf declares: ${[useVercel && "vercel", useSupabase && "supabase", useNeon && "neon", useOci && "oci"].filter(Boolean).join(" + ") || "cloudflare + github"} provider(s)
 # and the variables ${assumes.join(", ")}.${opts.external ? `
 # External tool: app code + deploy live in ${slug}; this manages only its infra here.` : ""}`
   );
@@ -509,6 +541,19 @@ variable "${name}_supabase_database_password" {
   sensitive = true
   default   = "import-placeholder" # ignored when importing an existing project
 }${overrideBlock}`);
+  }
+  if (useNeon) {
+    blocks.push(`# One Neon project, a branch per env (prod = the project's default branch; beta = a child
+# branch \u2014 copy-on-write, instant). Compute scales to zero and auto-resumes on the next connection,
+# so a Neon tool needs NO keepalive (the reason Neon is the default Postgres). NEON_API_KEY configures
+# the provider in main.tf; the connection strings are module OUTPUTS \u2014 no per-tool secret to gather.
+module "${name}_neon" {
+  source = "${moduleSource("neon", ref)}"
+
+  name   = "${name}"
+  region = "aws-us-east-1" # Neon region id, e.g. aws-us-east-1 / aws-us-west-2
+  envs   = [${envList}]
+}`);
   }
   if (useVercel) {
     const env = useSupabase ? `
@@ -531,6 +576,24 @@ variable "${name}_supabase_database_password" {
     supa_url_beta     = module.${name}_supabase.url
     supa_anon_beta    = module.${name}_supabase.anon_key
     supa_service_beta = module.${name}_supabase.service_role_key
+  }` : useNeon ? `
+  environment = {
+    site_url_prod  = { key = "SITE_URL", target = ["production"], sensitive = false }
+    site_url_beta  = { key = "SITE_URL", target = ["preview"], sensitive = false }
+    db_url_prod    = { key = "DATABASE_URL", target = ["production"], sensitive = true }
+    db_direct_prod = { key = "DIRECT_URL", target = ["production"], sensitive = true }
+    db_url_beta    = { key = "DATABASE_URL", target = ["preview"], sensitive = true }
+    db_direct_beta = { key = "DIRECT_URL", target = ["preview"], sensitive = true }
+  }
+  # Pooled (DATABASE_URL) for the serverless app; direct (DIRECT_URL) for migrations. Prod hits the
+  # project's default branch; beta hits the "beta" branch \u2014 separate data, instant copy-on-write.
+  environment_values = {
+    site_url_prod  = "https://${name}.${domain}"
+    site_url_beta  = "https://beta.${name}.${domain}"
+    db_url_prod    = module.${name}_neon.database_url["prod"]
+    db_direct_prod = module.${name}_neon.direct_url["prod"]
+    db_url_beta    = module.${name}_neon.database_url["beta"]
+    db_direct_beta = module.${name}_neon.direct_url["beta"]
   }` : `
   # No managed data store \u2014 add environment/environment_values if the app needs vars.
   environment        = {}
@@ -640,10 +703,13 @@ function emitWrapperMainTf(opts) {
     req.push('    vercel     = { source = "vercel/vercel", version = "~> 3.0" }');
   if (need.has("supabase"))
     req.push('    supabase   = { source = "supabase/supabase", version = "~> 1.0" }');
+  if (need.has("neon"))
+    req.push('    neon       = { source = "kislerdm/neon", version = "~> 0.13" }');
   if (need.has("oci")) req.push('    oci        = { source = "oracle/oci", version = ">= 5.0" }');
   const providerBlocks = ['provider "cloudflare" {}', `provider "github" { owner = "${owner}" }`];
   if (need.has("vercel")) providerBlocks.push('provider "vercel" {}');
   if (need.has("supabase")) providerBlocks.push('provider "supabase" {}');
+  if (need.has("neon")) providerBlocks.push('provider "neon" { api_key = var.neon_api_key }');
   if (need.has("oci")) {
     providerBlocks.push(`provider "oci" {
   # trimspace guards against a trailing newline/space in a pasted secret (a malformed region
@@ -660,6 +726,9 @@ function emitWrapperMainTf(opts) {
   if (need.has("supabase")) {
     vars.push('variable "supabase_organization_id" { type = string }');
   }
+  if (need.has("neon")) {
+    vars.push('variable "neon_api_key" {\n  type      = string\n  sensitive = true\n}');
+  }
   if (need.has("oci")) {
     vars.push('variable "oci_tenancy_ocid" { type = string }');
     vars.push('variable "oci_user_ocid" { type = string }');
@@ -703,6 +772,7 @@ function providersForTool(tool) {
   const out = ["cloudflare", "github"];
   if (ids.has("vercel")) out.push("vercel");
   if (ids.has("supabase")) out.push("supabase");
+  if (ids.has("neon")) out.push("neon");
   if (ids.has("oci")) out.push("oci");
   return out;
 }

package/dist/{chunk-2A7ZBBYN.js → chunk-GPPUZ6Z5.js}

@@ -15,13 +15,13 @@ import { createJiti } from "jiti";
 import { z } from "zod";
 var LaneEnum = z.enum(["astro", "next", "mcp"]);
 var TargetEnum = z.enum(["workers", "vercel", "oci"]);
-var DataEnum = z.enum(["none", "d1", "kv", "supabase"]);
+var DataEnum = z.enum(["none", "d1", "kv", "supabase", "neon"]);
 var AuthEnum = z.enum(["none", "bearer", "oauth"]);
 var AccessEnum = z.enum(["public", "private"]);
 var EnvEnum = z.enum(["preview", "beta", "prod"]);
 var MATRIX = {
   astro: { targets: ["workers"], data: ["none", "d1", "kv"] },
-  next: { targets: ["vercel"], data: ["none", "supabase"] },
+  next: { targets: ["vercel"], data: ["none", "supabase", "neon"] },
   mcp: { targets: ["workers", "oci"], data: ["none"] }
 };
 var ToolSchema = z.object({

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   defineConfig,
   defineVerify,
   loadConfig
-} from "./chunk-2A7ZBBYN.js";
+} from "./chunk-GPPUZ6Z5.js";
 import "./chunk-HX7VA25D.js";
 import "./chunk-N3IKUCSF.js";
 import "./chunk-KP3Y6WRU.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rtrentjones/greenlight",
-  "version": "0.2.24",
+  "version": "0.2.25",
   "description": "Greenlight CLI — setup and lifecycle for the harness.",
   "license": "MIT",
   "repository": {
@@ -31,10 +31,10 @@
     "@anthropic-ai/sdk": "^0.69.0"
   },
   "devDependencies": {
-    "@rtrentjones/greenlight-adapters": "0.2.24",
-    "@rtrentjones/greenlight-loop": "0.2.24",
-    "@rtrentjones/greenlight-verify": "0.2.24",
-    "@rtrentjones/greenlight-shared": "0.2.24"
+    "@rtrentjones/greenlight-adapters": "0.2.25",
+    "@rtrentjones/greenlight-shared": "0.2.25",
+    "@rtrentjones/greenlight-verify": "0.2.25",
+    "@rtrentjones/greenlight-loop": "0.2.25"
   },
   "scripts": {
     "build": "node scripts/copy-assets.mjs && tsup",