docs(vibewatch-sentiment): index refuses unscored slugs before payment - #432
Open
sonic-mast wants to merge 1 commit into
Open
sonic-mast wants to merge 1 commit into
sonic-mast wants to merge 1 commit into
Conversation
Since 2026-09-16 the live Stacks Vibe Index answers a panel project with no
scored days with a free `422 {"detail":{"error":"project_not_scored",...}}`
before any 402 (Vibewatch-io/vibewatch-app#1745), instead of serving a
charged 200 with `series: []`. Update SKILL.md, AGENT.md, the code comment
and the `--allow-unscored` help text; keep the local pre-check as the faster
guard. Surface non-402 failures of the unpaid first request with the status
and body instead of axios' bare "Request failed with status code N", so an
agent that skips the pre-check sees `project_not_scored`. Also note that the
index accepts sponsored transfers again (Vibewatch-io/vibewatch-mcp#15), so
`X402_PAYMENT_MODE=direct` is a fallback rather than a requirement.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
The
projectsubcommand's docs and code comment still describe the Stacks Vibe Index's old behaviour for a panel project with no scored days: a charged paid200withseries: [](found by a Tier 1 bounty winner, aibtc boardmtt3jjrgcf0aa8fb225c). Since 2026-09-16 the live index refuses such a slug before issuing a 402 (Vibewatch-io/vibewatch-app#1745), verified on prod today:Scored slugs still answer 402; unknown slugs 404. Nothing can be charged for an unscored project any more.
What
422 project_not_scoredrefusal (new error-table row), keep the skill's own free pre-check as the faster local guard, and say what--allow-unscorednow does (skips the local check; nothing is paid either way). Also note that the live index accepts sponsored transfers again as of 2026-09-16 ([x402] Paid query rejected with sponsored_unsupported for a zero-STX agent wallet Vibewatch-io/vibewatch-mcp#15), soX402_PAYMENT_MODE=directis a fallback for422 sponsored_unsupportedrather than a requirement.--allow-unscoredhelp text updated. One small behaviour change inpaidGet: a non-402 failure of the unpaid first request is rethrown asHTTP <status> from the index before any payment: <body>instead of axios' bareRequest failed with status code 422, so an agent that skips the pre-check actually seesproject_not_scored. The shared engine only intercepts 402 and re-wraps every post-payment failure as a plainErrorwithout aresponse, so this helper never sees a failure that happened after a payment was sent.No engine changes. Default behaviour of every subcommand is unchanged.
Verification
bun run typecheck,bun run validate(204/204) — pass.scripts/gemini-review.py --base origin/main): no findings.Related: #431 (
--asset sBTC|STX) touches the same SKILL.md/AGENT.md; this PR is based onmainon purpose and whichever lands second gets a trivial rebase.🤖 Generated with Claude Code
The server-side docs for the same behaviour are in Vibewatch-io/vibewatch-mcp#18 (merged): README section "Stacks Vibe Index paid tier (x402)".