Skip to content

v1.0.0 - Initial Release

Latest

Choose a tag to compare

@Solomonic Solomonic released this 19 May 10:26
· 1 commit to main since this release

First release of roninforge-hono, the 19th plugin in the RoninForge Cursor portfolio.

What's inside

  • 10 rules with proper Cursor globs:
    • hono-anti-patterns (59 BAD/CORRECT entries: Express leakage, v3-era removed APIs, RPC inference, Workers, security, routing, runtime, smaller issues)
    • hono-core (alwaysApply: app init, Context API, request accessors, middleware, built-in middleware list, cookie helpers, runtime detection)
    • hono-routing-and-rpc (chained routes load-bearing for RPC, sub-app composition, import type rule, IDE-slowdown mitigations)
    • hono-validators (zod-validator placement, zod-openapi peer pin gotcha, Standard Schema, decision tree)
    • hono-cloudflare-workers (wrangler.jsonc canonical shape, compatibility flag matrix, asset binding, D1 + Drizzle, Durable Objects)
    • hono-security (secureHeaders, csrf, bodyLimit + CVE pin, cookies, JWT, auth library guidance)
    • hono-error-handling (HTTPException, app.onError, typed RPC errors, Sentry via @sentry/hono)
    • hono-jsx (server JSX, jsx-renderer, dom JSX, HonoX islands, htmx, SSR security pin)
    • hono-testing (app.request universal, testClient typed, @cloudflare/vitest-pool-workers)
    • hono-deployment (per-runtime adapters, build pipelines, pin floors)
  • 5 skills: /hono-new-route, /hono-rpc-setup, /hono-cloudflare-workers-setup, /hono-migrate-to-v4, /hono-validate
  • 1 reviewer subagent (hono-reviewer) with CRITICAL/ERROR/WARN/NIT severity grouping and 13 per-file checks
  • 2 fixture projects demonstrating both the gold-standard pattern (correct-sample) and the v3-era hangover (anti-pattern-sample with 26 tracked violations)
  • POSIX validate-plugin.sh + GitHub Actions CI

Pin floors documented

  • hono >= 4.9.7 mandatory (CVE-2025-59139 / GHSA-92vj-g62v-jqhh bodyLimit bypass fix)
  • hono >= 4.12.16 for additional bodyLimit hardening against chunked / unknown-length requests
  • hono >= 4.12.18 if rendering JSX SSR (tag / attribute / CSS injection hardening)
  • Default pin: ^4.12.19 (latest stable; covers all of the above)
  • @hono/node-server >= 2.0.0 requires Node 20+
  • @hono/zod-openapi >= 1.0.0 peers on zod ^4.0.0 only (will not work with zod 3.x)

Why this plugin

Hono's maintainers filed Issue #3906 ("llm.txt file") and Issue #4812 ("Official AI Agent Skill for Hono") explicitly because "LLMs have basically no knowledge of how the latest Hono works." Pre-2025 training data is v3-era. Existing community rules don't cover the v3 -> v4 removed APIs, the Express middleware leakage class, or the security defaults.

Every entry sourced to a Hono GitHub issue, MIGRATION.md entry, CVE advisory, or maintainer statement.

Important: no Hono v5 exists. Latest stable is v4.12.19. Any "v5" in generated code is hallucination.

Install

git clone https://github.com/RoninForge/roninforge-hono.git
cp -rn roninforge-hono/rules/*  your-project/.cursor/rules/
cp -rn roninforge-hono/skills/* your-project/.cursor/skills/
cp -rn roninforge-hono/agents/* your-project/.cursor/agents/