| name | pull-feedback |
| description | Pull and manage feedback from korulang.org. Use to see what users are reporting about tests/documentation, prioritize work, and mark items resolved. |
Feedback Tool
Pull user feedback from korulang.org (stored in Convex) and manage it.
Commands
Run from the korulang_org directory:
cd ~/src/korulang_org
node scripts/pull-feedback.js
node scripts/pull-feedback.js abc12345
node scripts/pull-feedback.js --context abc12345
node scripts/pull-feedback.js --done abc12345
node scripts/pull-feedback.js --wontfix abc12345
node scripts/pull-feedback.js --reopen abc12345
node scripts/pull-feedback.js --priority abc12345
node scripts/pull-feedback.js --category 310-comptime
node scripts/pull-feedback.js --json
node scripts/pull-feedback.js --lowest
node scripts/pull-feedback.js --ratings
node scripts/pull-feedback.js --ratings --low
node scripts/pull-feedback.js --ratings 1
node scripts/pull-feedback.js --ratings 5
Workflow
Quick start for tonight's work:
- Run
--lowest to see the 5 lowest-rated pages with feedback
- Pick a page, fix the issues
- Re-rate the page on korulang.org after improving it
Finding best practices / gold standard examples:
- Run
--ratings to see all rated pages (highest first)
- Run
--ratings 5 to see only 5-star pages (curated examples)
- Use these as templates when creating new tests or documentation
Full feedback workflow:
- Run
/pull-feedback to see open items
- Use
--context <id> to see the full test code for an item
- Either:
- Fix the issue directly, then
--done <id>
- Use
--priority <id> to create a PRIORITY file in the test dir (auto-closes feedback)
- Delete PRIORITY file when the work is complete
Notes
- IDs are 8-character prefixes of the full Convex ID
- Prioritized items (P1) appear first in the list
- Feedback is URL-anchored to specific pages on korulang.org
- The
--priority command maps URLs back to test directories in this repo
Requirements
~/src/korulang_org/.env.local must contain:
PUBLIC_CONVEX_URL - Convex deployment URL
ADMIN_SECRET - Required for mutations (done/wontfix/reopen)