Skip to content

test(registry): qualify CLI and browser catalog parity - #284

Open
lloydrichards wants to merge 1 commit into
codex/catalog-builderfrom
codex/catalog-qualification
Open

lloydrichards wants to merge 1 commit into
codex/catalog-builderfrom
codex/catalog-qualification

Conversation

@lloydrichards

@lloydrichards lloydrichards commented Sep 27, 2026 •

Copy link
Copy Markdown
Owner

Goals/Scope

Qualify the five registry implementation PRs against #275. Review the controlled CLI/browser comparison and the remaining release evidence.

Description

Controlled catalog responses drive actual CLI create commands and browser previews for Bun, Node, and Deno. Tests compare generated files and the resulting Blueprint. An incremental CLI add test compares the newly added target's files with browser output. A changed generated file appears in the next command and browser session while the current session stays stable. User guidance, agent guidance, and generated CLI reference text explain cache behavior and $schema metadata.

How to Test

Run bun format, bun lint, bun run type-check, bun run okf:check, scoped CLI and docs tests, and production CLI and docs builds. CI also runs generated-project E2E. The parent issue record separates local, CI, and deployed evidence.

Comments

Tracks #275. Keep this PR draft until #272's public URLs return JSON and pass conditional-request, CORS, missing-path, and no-cache timing checks. They currently return HTTP 404; the preview requires Vercel SSO. Do not close #275 from local tests.

@vercel

vercel Bot commented Sep 27, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
stack-effect-docs Ready Ready Preview Sep 27, 2026 9:15pm UTC

@changeset-bot

changeset-bot Bot commented Sep 27, 2026 •

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 481bbd7

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Important

The new qualification tests can pass without exercising real CLI generation or a file-changing catalog update, leaving two acceptance criteria from #275 unverified.

Reviewed changes at 3b9650f: CLI/browser parity harness, compatible-update and session tests, session ID allocation, and registry user/agent documentation.

  • Parity harness: A Bun script loads a controlled catalog and compares its service-level preview with the browser worker for Bun, Node, and Deno.
  • Update checks: CLI schema output and browser catalog metadata are checked across compatible revisions.
  • Guidance and sessions: Documentation explains registry/cache behavior, and builder session IDs become unique across hook instances.

Pullfrog  | Fix all ➔ | Fix 👍s ➔ | View workflow run | Using GPT Sol | 𝕏

Comment thread apps/cli/scripts/registry-parity.ts Outdated
Comment thread apps/docs/vitest.config.ts

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ No new issues found.

Reviewed changes since the prior Pullfrog review: the latest fixes exercise CLI file generation and verify catalog revisions in generated output.

  • Ran real CLI commands: Compared browser previews with files produced by controlled CLI create and incremental add for the selected runtimes.
  • Verified revised contributions: Checked that an existing browser session keeps its files while a later session and CLI command observe changed file contents.
  • Aligned generated configuration: Updated CLI configuration formatting for parity with browser output.

Pullfrog  | View workflow run | Using GPT Sol | 𝕏

@lloydrichards
lloydrichards marked this pull request as ready for review September 27, 2026 21:29

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ No new issues found.

Reviewed changes in the full PR diff: the controlled CLI/browser parity harness, compatible catalog revisions, builder session IDs, and registry guidance.

  • CLI/browser parity: Runs CLI create for Bun, Node, and Deno and incremental add, comparing generated files and Blueprint with worker previews.
  • Catalog updates: Checks that new CLI commands and browser sessions receive changed file contents while an existing browser session remains stable.
  • Guidance and session handling: Allocates unique builder session IDs and documents registry loading, cache fallback, and schema metadata.

The scoped CLI tests and Chromium browser tests pass. Deployed registry HTTP qualification remains a separate release gate tracked by #275.

Pullfrog  | View workflow run | Using GPT Sol | 𝕏

This branch was successfully deployed

1 active deployment
Preview — 481bbd77 Deployed Sep 27, 2026 by vercel[bot]
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.

feat: deliver and qualify the official HTTP catalog registry

1 participant