Skip to content

docs(identity): identityResolve free forever ($0) — KYA K1 - #107

Merged
yakimoto merged 3 commits into
mainfrom
eng/kya-k1-identity-resolve-free
Oct 14, 2026
Merged

yakimoto merged 3 commits into
mainfrom
eng/kya-k1-identity-resolve-free

Conversation

@yakimoto

@yakimoto yakimoto commented Sep 25, 2026 •

Copy link
Copy Markdown
Contributor

User description

Summary

Docs-only: document that public-directory GET /identity/resolve / gate checks (identityResolve) are free forever ($0) — no priced meter, no x402 charge. Rate limits and the gateway daily request quota may still apply.

Citations

  • Linear: WAVE-25294
  • Tracker: wave-av/claude-workstation#5543
  • Workstream: KYA K1

Changes

  1. openapi.yaml — Identity tag description: free forever ($0) wording
  2. openapi.yaml — identityResolve operation description: free forever paragraph after directory:read scope note
  3. CHANGELOG.md — Unreleased / Changed bullet citing WAVE-25294 / #5543

Explicit non-goals

  • No x-price row added
  • No $0.001 (or any paid price) reintroduced
  • No regenerated types (docs prose only; regenerate only if CI requires)
  • No Packages spend / no slct-site / no WO-BEND-1 / no public deploy

Test plan

  • CI green on docs-only diff
  • Spec lint / contract checks pass without type regen

View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

Note

Low Risk
Documentation-only clarification of existing pricing policy; no schema, billing, or runtime behavior changes.

Overview
Docs-only: the spec now states that public-directory GET /identity/resolve (identityResolve) and related gate checks are free forever ($0)—no priced Stripe/KWH meter and no x402 billing, aligned with the free VRFY check doctrine. Rate limits and the gateway daily request quota may still apply.

Wording is added in openapi.yaml (Identity tag blurb and identityResolve operation description), mirrored in generated/api-types.d.ts JSDoc, and noted under Unreleased / Changed in CHANGELOG.md (WAVE-25294 / KYA K1). No x-price, no new paid amounts, and no behavioral API contract changes beyond prose.

Reviewed by Cursor Bugbot for commit 1c5805c. Bugbot is set up for automated code reviews on this repo. Configure here.

Summary by Sourcery

Document that public-directory identity resolution and gate checks are free forever without priced metering or x402 billing.

Enhancements:

  • Clarify in the API documentation that public-directory identity resolution and gate checks are permanently free, with no priced meter or x402 charge while applicable limits and quotas remain.
  • Record the identity resolution pricing clarification in the unreleased changelog.

Documentation:

  • Document the free-forever ($0) pricing policy for the public-directory identity resolution endpoint and gate checks.

CodeAnt-AI Description

Document that identity lookups and gate checks cost $0

What Changed

  • Clarifies that public-directory identity lookups and gate checks are free forever, with no priced meter or x402 charge.
  • Notes that rate limits and the gateway’s daily request quota may still apply.

Impact

✅ No x402 charges for directory lookups
✅ No metered fees for gate checks
✅ Clear notice of applicable rate limits and daily quotas

💡 Usage Guide

Checking Your Pull Request

Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.

Talking to CodeAnt AI

Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:

@codeant-ai ask: Your question here

This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.

Example

@codeant-ai ask: Can you suggest a safer alternative to storing this secret?

Preserve Org Learnings with CodeAnt

You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:

@codeant-ai: Your feedback here

This helps CodeAnt AI learn and adapt to your team's coding style and standards.

Example

@codeant-ai: Do not flag unused imports.

Retrigger review

Ask CodeAnt AI to review the PR again, by typing:

@codeant-ai: review

Check Your Repository Health

To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.

Document that public-directory GET /identity/resolve and gate checks are
free forever ($0): no priced meter, no x402. Rate limits / daily request
quota may still apply.

Cites WAVE-25294 / wave-av/claude-workstation#5543. Docs-only; no x-price
row and no paid price reintroduced.

@sourcery-ai sourcery-ai 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.

Sorry @yakimoto, this account has used its review budget of 2,500,000 diff characters for the last 7 days.

You can request another review in 9 minutes by commenting @sourcery-ai review.

@codeant-ai

codeant-ai Bot commented Sep 25, 2026 •

Copy link
Copy Markdown

🤖 CodeAnt AI — Review Status

Status Commit Started (UTC) Finished (UTC)
✅ Incremental review completed 1c5805c Oct 14, 2026 · 03:22 03:23
✅ Incremental review completed 6cc207a Oct 09, 2026 · 22:45 22:45
✅ Reviewed your PR 2326e59 Sep 25, 2026 · 15:11 15:12

@qodo-code-review

Copy link
Copy Markdown

ⓘ Qodo reviews are paused because your workspace is out of credits. Ask your workspace admin to add credits to resume reviews. Manage billing

@codeant-ai

codeant-ai Bot commented Sep 25, 2026

Copy link
Copy Markdown

Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@sourcery-ai

sourcery-ai Bot commented Sep 25, 2026

Copy link
Copy Markdown
Reviewer's guide (collapsed on small PRs)

Reviewer's Guide

Docs-only clarification that public-directory GET /identity/resolve and its gate checks are free forever ($0), with no priced meter or x402 charge, while rate limits and the gateway daily quota may still apply; no API schemas, pricing metadata, or generated types are changed.

File-Level Changes

Change Details Files
Documents the permanent $0 pricing policy for public-directory identity resolution and gate checks.
  • Adds free-forever, no-meter, and no-x402 wording to the Identity tag.
  • Clarifies the operation-level pricing policy, including continued applicability of rate limits and daily gateway quota and prohibition on inventing a paid price.
openapi.yaml
Records the pricing-policy clarification in the unreleased changelog.
  • Adds a Changed entry with the affected operation, billing caveats, and workstream references.
CHANGELOG.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@cursor

cursor Bot commented Sep 25, 2026

Copy link
Copy Markdown

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.

A user or team admin can review and increase usage limits in the Cursor dashboard.

(requestId: serverGenReqId_12affe40-d8ca-4bba-8b56-df04bf9bc0c8)

@coderabbitai

coderabbitai Bot commented Sep 25, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration
  • Configuration used: Repository: wave-av/coderabbit/.coderabbit.yaml
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 62baaab4-ec6b-40ad-80da-c5941f927b72

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Advanced

Run ID: b2f9373d-298a-42d9-874b-df5ee5efe410

📥 Commits

Reviewing files that changed from the base of the PR and between 3bed828 and 2326e59.

📒 Files selected for processing (2)
  • CHANGELOG.md
  • openapi.yaml

Included review availability: 0 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 1 review per hour.

📜 Recent review details
⏰ Context from checks skipped due to timeout. (8)
  • GitHub Check: Secrets + content policy
  • GitHub Check: Body content policy
  • GitHub Check: Secrets + content policy
  • GitHub Check: Body content policy
  • GitHub Check: Cursor Security Agent: Security Reviewer
  • GitHub Check: Gitar
  • GitHub Check: Macroscope - Approvability Check
  • GitHub Check: semgrep-cloud-platform/scan
🧰 Additional context used
📓 Path-based instructions (1)
Conventional Commit titles; update `CHANGELOG.md` (`Unreleased`) for user-facing changes.

📄 CodeRabbit inference engine (AGENTS.md)

Files:

  • CHANGELOG.md
🪛 Checkov (3.3.16)
openapi.yaml

[high] 1-14541: Ensure that security operations is not empty.

(CKV_OPENAPI_5)

🔇 Additional comments (1)
openapi.yaml (1)

131-132: LGTM!

Also applies to: 4237-4239

📝 Walkthrough

The changelog and OpenAPI documentation state that public-directory resolution and gate checks have no priced meter or x402 charge. They also note that rate limits and daily request quotas may apply.

Changes: Identity resolution pricing documentation

Layer / File(s) Summary
Document free identity resolution
openapi.yaml, CHANGELOG.md
The Identity tag and /identity/resolve descriptions specify $0 pricing and no priced meter or x402 charge. They note that rate limits and daily quotas may apply. The changelog records these details.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~5 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to 2326e

This documentation change describes identity resolution as unpriced while retaining applicable access controls and request limits. No conflicting runtime behavior is established, so no actionable merge-blocking risk remains.

### Architecture Summary

Architecture risk: 🔵 Low · up to 2326e

The change affects 2 systems.

Changed systems: CHANGELOG.md, openapi.yaml

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

  • observed — CHANGELOG.md (service) was modified; 1 changed file maps to changed impact.
  • observed — openapi.yaml (service) was modified; 1 changed file maps to changed impact.

Before / after behavior

  • observed — Modified behavior in CHANGELOG.md: Adds a changelog entry declaring identityResolve and its gate checks free forever, with no priced meter or x402; rate limits and daily request quotas may still apply.
  • observed — Modified behavior in openapi.yaml: The Identity tag description now specifies that public-directory resolution and gate checks are free ($0), with no priced meter or x402 billing, while rate limits and daily quotas may still apply.
  • observed — Modified behavior in openapi.yaml: The /identity/resolve description now specifies that resolution and gate checks incur no priced Stripe/KWH meter event or x402 charge; rate limits and the gateway’s daily request quota may still apply.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies the documentation change: identityResolve is free forever at $0. It is concise and directly related to the main changeset.
Description check ✅ Passed The description accurately describes the docs-only changes, affected files, pricing behavior, applicable limits, citations, non-goals, and test plan.
Linked Issues check ✅ Passed WAVE-25294 is a contextual mention, not a directly linked target. It supplies no coding requirements for this pull request. No active directly linked issue remains.
Out of Scope Changes check ✅ Passed The changes update CHANGELOG.md and openapi.yaml to document the stated $0 behavior for GET /identity/resolve and identityResolve. The changes also preserve rate-limit and daily-quota qualifie…
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
✨ Finishing Touches 💡 1
🛠️ Fix failing CI checks 💡
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
✨ Simplify code
  • Commit to this branch
  • Create a new PR

Comment @coderabbitai help to get the list of available commands.

@codeant-ai codeant-ai Bot added the size:S This PR changes 10-29 lines, ignoring generated files label Sep 25, 2026
@gitar-bot

gitar-bot Bot commented Sep 25, 2026

Copy link
Copy Markdown

Note

Automatic reviews are paused because your team has used its included automatic processing for this billing period (headroom scales with your seat count). You can still comment "Gitar review" to run one anytime, and automatic reviews resume on their own by October 1. Add seats for more headroom.
Learn more

Code Review ✅ Approved

🟢 Low risk · OpenAPI and changelog prose clarify pricing without changing runtime behavior.

Documentation-only update clarifying that public-directory GET /identity/resolve and gate checks (identityResolve) are free forever ($0) with no priced meter or x402 charge. Updates the Identity tag description and operation documentation in openapi.yaml, and records the change in CHANGELOG.md. No issues found.

Review coverage

📋 Rules No rules evaluated

🧪 Functional validation Not enabled · Set up

Options

Display: compact → Counting what did not apply, without listing it.

Comment with these commands to change the behavior for this request:

Compact
gitar display:verbose         

Was this helpful? React with 👍 / 👎 | Gitar

@greptile-apps

greptile-apps Bot commented Sep 25, 2026 •

Copy link
Copy Markdown

RetriggerConfidence Score: 5/5

[Low impact] No new actionable issue was established, and the PR appears safe to merge on the reviewed evidence.

Summary

The PR documents that public-directory identity resolution is free forever and adds later spec-maintenance changes:

  • Removes the Studio AI operations and their generated types.
  • Marks /enhance as paused and updates its drift allowlist entry.
  • Adds a pinned Buildkite pipeline and refreshes the contract-drift receipt.
  • Greptile automatically discovered a related ticket that helped explain the purpose of this PR: documenting free public-record resolve and gate checks.

Reviews (3) · Last reviewed commit: "Merge branch 'main' into eng/kya-k1-iden..." · Reviewed by Greptile

Comment thread openapi.yaml

@cubic-dev-ai cubic-dev-ai 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 issues found across 2 files

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.
Architecture diagram
sequenceDiagram
    participant Dev as API Developer
    participant Spec as OpenAPI Spec (openapi.yaml)
    participant Changelog as CHANGELOG.md
    participant Consumer as API Consumer
    participant GW as API Gateway

    Note over Dev,Changelog: Documentation Update Flow

    Dev->>Spec: Update Identity tag description
    Dev->>Spec: Update identityResolve operation description
    Dev->>Changelog: Add Changed entry

    Note over Spec,GW: Runtime Behavior (Documented)

    Consumer->>GW: GET /identity/resolve
    GW->>GW: Validate request

    alt Public directory request
        GW->>Consumer: 200: identityResolve result
        Note over GW,Consumer: Free forever ($0) - no x402 charge
    else Premium directory request
        GW->>Consumer: 200: identityResolve result
        Note over GW,Consumer: Subject to rate limits
    end

    Note over GW,Consumer: Gateway daily request quota may apply

    Note over Spec,GW: Contract Boundary
    Spec->>Consumer: Documents free tier pricing
    Note over Spec,Consumer: No x-price metadata added
Loading

Re-trigger cubic

@macroscopeapp

macroscopeapp Bot commented Sep 25, 2026 •

Copy link
Copy Markdown

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — The edits are documentation-only and do not alter endpoint execution, schemas, or billing enforcement, but they publish a permanent $0/no-x402 pricing policy for an identity endpoint. Because the stated purpose directly concerns billing and metering, human review is warranted before publication.

Not approved because:

  • Credit balance exhausted. Approvability relies on correctness review in order to determine eligibility

No code changes detected at 1c5805c. Prior analysis still applies.

Review your spending limits in Billing settings. You can add or adjust custom eligibility rules. Learn more.

@wave-bugbot

wave-bugbot Bot commented Sep 26, 2026

Copy link
Copy Markdown

🟢 WAVE BugBot — clear

No confident findings on the changed lines.

Local review · $0 inference · wave-dispatch

@cursor

cursor Bot commented Oct 9, 2026

Copy link
Copy Markdown

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.

A user or team admin can review and increase usage limits in the Cursor dashboard.

(requestId: c7abf3a8-719f-4fa0-87db-753652595cc5)

@codeant-ai

codeant-ai Bot commented Oct 9, 2026 •

Copy link
Copy Markdown

CodeAnt PR Risk: Medium Risk

  • The PR needs a manual documentation check before approval.
  • Confirm that the “free forever” claim for identity resolution matches the current billing policy and gateway behavior.

Assessed commit: 1c5805cafc0f

@yakimoto

yakimoto commented Oct 9, 2026

Copy link
Copy Markdown
Contributor Author

Local CI @ 6cc207a (org Actions billing-blocked, so CI unavailable, not red): lint passes (openapi.yaml valid, 58 warnings, unchanged). test:ga passes 35/35. gen:types shows no drift; api-types is regenerated for the identityResolve $0 doc. The remaining skills-index failure (kwh/kya/vrfy) also fails on main and isn't caused by this PR; a separate fix will follow. Negative control: broken YAML makes lint exit 1.

Bring branch up to date so Buildkite (required check) can run.
@yakimoto
yakimoto merged commit 5a7f921 into main Oct 14, 2026
16 of 38 checks passed
@yakimoto
yakimoto deleted the eng/kya-k1-identity-resolve-free branch October 14, 2026 03:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:S This PR changes 10-29 lines, ignoring generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant