Skip to content

Guide Hosted first run through verified Portal and preserve paid refusals [skip-runtime-e2e] - #255

Merged
saurabhjain1592 merged 4 commits into
mainfrom
codex/4487-hosted-first-run
Nov 4, 2026
Merged

saurabhjain1592 merged 4 commits into
mainfrom
codex/4487-hosted-first-run

Conversation

@saurabhjain1592

@saurabhjain1592 saurabhjain1592 commented Nov 1, 2026 •

Copy link
Copy Markdown
Member

Scope

  • Direct legacy anonymous AxonFlowTry.register() callers to the verified Hosted Portal before any registration request. Keep custom self-hosted Community registration available.
  • Preserve explicitly configured endpoints and linked API credentials even when the legacy AXONFLOW_TRY=1 switch is set.
  • Surface answered 402 hosted_payment_required with its status and code; treat exact 429 hosted_monthly_limit_reached as terminal, including a truncated body when X-Axonflow-Tier-Limit: monthly_governed_events is present. Keep ordinary 429 retry behavior and legacy Community 402 blocking.
  • Update README and changelog for the website-first, verified, linked-client path.
  • The README now names the Portal download and owner-approved device link, maps hosted-api.json keys endpoint, clientId, and clientSecret to Java SDK configuration, and keeps the linked secret out of source control and prompts.

Local verification

  • mvn -o -q test: 1,629 tests, 0 failures, 0 errors, 0 skipped.
  • mvn -o -q com.spotify.fmt:fmt-maven-plugin:check: passed.
  • mvn -o -q package -Dmaven.test.skip=true: passed; built 9.5.0 JAR.
  • Fresh external Maven project resolved the candidate JAR from an isolated file repository, compiled, and ran: Portal guidance, linked Basic auth and ordinary 200, Hosted 402, Hosted 429 with truncated body and tier header, ordinary 429 retry, and Community 402 passed. A direct javac/java run against the same JAR and Maven-copied runtime dependencies also passed.
  • The later exact linked-client Agent and Portal staging journey is recorded below. The remote CI run failed before any job step started: GitHub reports the account is locked due to a billing issue. DCO passed; local checks above are the source evidence for review.
  • Final head 15ae27f9377f41f964568fcce1aeff3058fe40d7 also closes trailing-dot Hosted registrar aliases; HostedFirstRunTest and git diff --check passed on that head. The published Maven Central 9.5.0 JAR SHA-256 is 4f5fc12b828af6ce9bb022e6d627fe68bcc70bb9a1b6627429385551f0c7c4dd. Its source JAR confirms legacy anonymous AxonFlowTry.register() and inherited AXONFLOW_TRY endpoint override; those gaps are addressed by this PR, while the candidate JAR's external consumer covered linked Basic auth and payment refusals.

Draft / do not merge. No release, publication, deployment, or production operation is requested by this PR.

4 November exact linked-client staging proof

A second disposable, digest-pinned stack axonflow-community-saas-staging-20261104-010500 passed a real Portal signup and device link after app/admin DB role provision, then policy-only mcpCheckInput(postgres, SELECT 1) from the sealed unpublished TypeScript and Java 9.5.1 candidates. Each client passed paid allow, answered 429 hosted_monthly_limit_reached after a synthetic 1000-month/0-minute fixture, answered 402 hosted_payment_required after synthetic cancellation, and rejected the revoked credential with a raw same-route HTTP 401 confirmation. Independent reviewer A checked the eight results and exact package/runner hashes. There was no provider Send, Checkout, charge, public DNS mutation, release tag, or registry upload. The stack was captured at gate off/0 and deleted at 02:41:10 UTC with both shared DSN secret versions restored, RDS/ALB/ECS/security groups and access bucket absent, local credentials removed, and no manual snapshots deleted.

Evidence: /private/tmp/oc4487-ts-java-staging-20261104-010500/sdk-live-evidence.json SHA-256 5adc21229b65087225e55f33f4e1185fac78401a972de6766dfcfe63464d92f5; safeoff-stack-evidence.json SHA-256 cb7f85f5ee7f94958a4773545c65d699f5edbd95fe01168823fb221d7b7fe01a; teardown-evidence.json SHA-256 ac243a52cabc299ea5259a288ed346379f8044dcaabd705444967f52dc3b4dd2. The older /private/tmp/oc4487-sdk-prep-r3/MANIFEST.json identifies package bytes and a pre-fix probe harness; the live evidence records the amended Java proxy selector/probe/runner SHA-256 values. Final PR/merge-source review, remote CI, and publication remain held.

Skip-runtime-e2e justification

The operator explicitly authorized this narrow workflow-presence exemption for the unpublished Hosted client candidate. The actual user-facing path was exercised outside this repository on a digest-pinned disposable Enterprise staging stack using the sealed TypeScript 9.5.1 tarball and Java 9.5.1 JAR: real Portal one-use signup and owner-approved device link, followed by mcpCheckInput(postgres, SELECT 1) from each linked SDK. Both clients passed allow 200, synthetic monthly-cap 429, canceled-subscription 402, and revoked-credential 401 (with raw same-route status confirmation). Evidence: /private/tmp/oc4487-ts-java-staging-20261104-010500/sdk-live-evidence.json SHA-256 5adc21229b65087225e55f33f4e1185fac78401a972de6766dfcfe63464d92f5. Paid enforcement was returned to off/0 and the disposable stack was deleted; teardown receipt SHA-256 ac243a52cabc299ea5259a288ed346379f8044dcaabd705444967f52dc3b4dd2. No provider Send or live charge occurred. The AWS tenant/DB-role/cap/cancellation/revocation fixture and target-locked TLS transport are sealed in that separate staging harness. This exemption affects only the repository workflow's runtime-e2e/ file-presence check; it does not claim that a repo-local runtime suite ran or waive merge-source rebuild, final review, or publication gates.

…sals

Signed-off-by: Saurabh Jain <saurabh.jain@getaxonflow.com>
Signed-off-by: Saurabh Jain <saurabh.jain@getaxonflow.com>
Signed-off-by: Saurabh Jain <saurabh.jain@getaxonflow.com>
@saurabhjain1592
saurabhjain1592 force-pushed the codex/4487-hosted-first-run branch from ebd5157 to 15ae27f Compare November 3, 2026 23:33
Signed-off-by: Saurabh Jain <saurabh.jain@getaxonflow.com>
@saurabhjain1592 saurabhjain1592 changed the title Guide Hosted first run through verified Portal and preserve paid refusals Guide Hosted first run through verified Portal and preserve paid refusals [skip-runtime-e2e] Nov 4, 2026
@saurabhjain1592
saurabhjain1592 marked this pull request as ready for review November 4, 2026 03:45
@saurabhjain1592 saurabhjain1592 removed the do-not-merge Release window label Nov 4, 2026
@saurabhjain1592
saurabhjain1592 merged commit d26450d into main Nov 4, 2026
3 of 17 checks passed
@saurabhjain1592
saurabhjain1592 deleted the codex/4487-hosted-first-run branch November 4, 2026 03:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant