Commit Graph

75 Commits

Author SHA1 Message Date
Andre Landgraf 8a4200b2fd Drop NEON_PROFILE as an account signal and gate neon.ts after claim help. 2026-08-25 12:56:49 -07:00
Andre Landgraf 32e84df583 Drop the restated claim --help gate after the copy-paste block. 2026-08-25 12:46:18 -07:00
Andre Landgraf 0350587d7f Gate claim on the installed CLI and share the claim lifecycle with REST. 2026-08-25 12:22:20 -07:00
Andre Landgraf e1ca24c4cb Name HTTP granted/reason separately from the CLI denied_capabilities field. 2026-08-25 12:04:04 -07:00
Andre Landgraf 1032bddbd9 Install neon before testing claim, and read auth.md from the live origin. 2026-08-25 11:56:09 -07:00
Andre Landgraf 7572d7f74f Check profiles with npx and fall back to claimable.neon.tech/auth.md. 2026-08-25 11:40:11 -07:00
Andre Landgraf d9d9e58c57 Keep the account check in Getting Started only. 2026-08-25 11:26:54 -07:00
Andre Landgraf 3671832ddf Freeze happens when the human continues to Neon, not on mint. 2026-08-25 11:21:20 -07:00
Andre Landgraf 85e398b562 Tell agents to skip neon claim when the command is missing. 2026-08-25 11:13:13 -07:00
Andre Landgraf 20a6e54c3c Minting a claim URL does not freeze project access. 2026-08-25 10:58:53 -07:00
Andre Landgraf aaf533fdc6 Lead Claimable Neon with the CLI path, REST if it cannot run. 2026-08-25 09:26:39 -07:00
Andre Landgraf dffe72a034 List CLI auth checks instead of routing around init. 2026-08-25 09:18:58 -07:00
Andre Landgraf 1c8fc6cc56 Stop when DEFAULT already has an account. 2026-08-25 08:37:27 -07:00
Andre Landgraf dbfc445442 Send named profiles to link, not Getting Started. 2026-08-25 08:35:58 -07:00
Andre Landgraf c35b828601 Send NEON_PROFILE to link, not the unclaimed path. 2026-08-25 08:34:32 -07:00
Andre Landgraf 09739492a0 Put neon.com discovery URLs in the skill's code block. 2026-08-25 08:31:37 -07:00
Andre Landgraf 5ddf2a15d3 Say REST stays on claimable.neon.tech. 2026-08-25 08:23:16 -07:00
Andre Landgraf 1542d892fb Format the Claimable Neon CLI/REST table. 2026-08-25 08:21:26 -07:00
Andre Landgraf be13bc3e8b Point Claimable Neon discovery at neon.com/auth.md.
REST issue stays on claimable.neon.tech. The skill file and path-issuer
metadata live on neon.com.
2026-08-25 08:08:48 -07:00
Andre Landgraf 706f4afe4c Do not send NEON_PROFILE to init even when NEON_API_KEY is set. 2026-08-25 08:08:23 -07:00
Andre Landgraf 6e686a4681 Keep NEON_API_KEY on init; probe profiles with npx neon@latest. 2026-08-25 08:08:23 -07:00
Andre Landgraf a7b53329af Gate init on profile list and reuse named profiles with link. 2026-08-25 08:08:22 -07:00
Andre Landgraf f32971646c Skip neon init when NEON_PROFILE is set; it refuses named profiles. 2026-08-25 08:08:22 -07:00
Andre Landgraf b57ff16018 Reuse working Neon credentials before asking to sign in. 2026-08-25 08:08:22 -07:00
Andre Landgraf 64eceac8f6 Treat a DEFAULT missing profile as no Neon account. 2026-08-25 08:08:22 -07:00
Andre Landgraf be10a5878a Probe existing accounts with neon profile list before Claimable Neon. 2026-08-25 08:08:22 -07:00
Andre Landgraf 74bfbed13e Trigger Claimable Neon when the user cannot authenticate now. 2026-08-25 08:08:22 -07:00
Andre Landgraf e9fd2a81a0 Ask before Claimable Neon whenever the user cannot authenticate now. 2026-08-25 08:08:22 -07:00
Andre Landgraf 9bc0444baf Prefer an existing Neon account over Claimable Neon. 2026-08-25 08:08:22 -07:00
Andre Landgraf 2ebbca8c0e State the REST fallback when claim exists but create does not. 2026-08-25 08:08:22 -07:00
Andre Landgraf b273e9a63f Keep @neon/config off the Postgres-only claimable path. 2026-08-25 08:08:22 -07:00
Andre Landgraf a1ca86451d Fall back to REST when neon claim is missing, not when the CLI binary is. 2026-08-25 08:08:22 -07:00
Andre Landgraf df945ecc2c Document REST as the fallback when the CLI is not available. 2026-08-25 08:08:22 -07:00
Andre Landgraf ca1fe67e34 Put claim commands in the neon skill and report the CLI's accept fields. 2026-08-25 08:08:22 -07:00
Andre Landgraf cc18e205b0 Match claim status output and install @neon/config on the claimable path. 2026-08-25 08:08:22 -07:00
Andre Landgraf aa73d481b0 Tell the agent to pull a new DATABASE_URL after claim reconciles. 2026-08-25 08:08:22 -07:00
Andre Landgraf 0afd58402a Remove redundant comments from config example 2026-08-25 08:08:22 -07:00
Andre Landgraf 9712873919 State that claim rotates DATABASE_URL and leaves Auth and Data API enabled. 2026-08-25 08:08:22 -07:00
Andre Landgraf 8c14033247 State claim URL timing and report the CLI expiry. 2026-08-25 08:08:22 -07:00
Andre Landgraf d1be283c42 State the real neon claim create env-file default. 2026-08-25 08:08:22 -07:00
Andre Landgraf 6a5911fc79 State the claimable Neon job when the user is not around. 2026-08-25 08:08:22 -07:00
Andre Landgraf 564902ca89 Gate neon claim accept and unset account credentials first. 2026-08-25 08:08:22 -07:00
Andre Landgraf 1f820bc1f1 Document claim CLI defaults, triggers, and the absolute reference link. 2026-08-25 08:08:22 -07:00
Andre Landgraf d666ab8854 Document neon claim accept default, delete, and ambient credentials. 2026-08-25 08:08:22 -07:00
Andre Landgraf e4b5876aa2 Document the full neon claim lifecycle in the neon skill. 2026-08-25 08:08:22 -07:00
Andre Landgraf 535a8d1c23 Point Claimable Neon discovery at auth.md from llms.txt. 2026-08-25 08:08:22 -07:00
Andre Landgraf 56d65da4bd Stop documenting the neon.new provisioning flow
The Claimable Neon reference is the new API only. neon.new remains a
trigger phrase on the neon skill so old-name queries still land here.
2026-08-25 08:08:22 -07:00
Andre Landgraf 779d96fa39 Fold Claimable Neon into the neon skill
A standalone claimable-postgres skill taught curl to a provisioning API.
Agents should start from the neon skill, install the CLI, write neon.ts,
and follow auth.md. Delete the skill and document that path in
skills/neon/references/claimable-neon.md.
2026-08-25 08:08:22 -07:00
Andre Landgraf 833f771474 Document the claimable.neon.tech auth.md API in claimable-postgres
The skill documented the neon.new REST API, CLI, SDK, and Vite plugin. That
surface is replaced by a new service at https://claimable.neon.tech/v1 that
implements the auth.md agent identity protocol and provisions the Data API and
Neon Auth alongside Postgres.

Replaces the provisioning documentation with agent registration, the JWT bearer
token exchange, the capability decision model, the resource routes, and the
structured error envelope. Skill name and directory are unchanged.
2026-08-25 08:08:22 -07:00
Andre Landgraf cdb2907698 Recommend Object Storage for user files, not app build output (#94)
* Recommend Object Storage for user files, not app build output

The "When to Use" closer sent agents to a dedicated object store whenever
branch-consistent rows and files weren't the deciding factor, which reads
as a reason not to use Neon at all. The two real boundaries are static web
hosting and the absence of a CDN in front of public buckets, so name those
and recommend the rest.

* Name the storage endpoint by its env var in the CDN guidance

The hostname was written out with a c-<N> cell placeholder a reader
cannot resolve, and the claim that Neon runs no CDN in front of it is
a negative the docs neither state nor bound. AWS_ENDPOINT_URL_S3 is
already injected and documented in the skill, so point the CDN origin
at that instead.

* Version the object key instead of overwriting it behind a CDN

A long Cache-Control on a stable key serves the previous avatar until
the TTL expires, and the CDN guidance led with avatars. Write each
version to a new key and repoint the row. Also key the static-hosting
boundary on provenance rather than file extension, so a marketing image
shipped in public/ lands on the app host with the rest of the build.
2026-08-25 06:51:54 -07:00