Add runnable example exercise and end-to-end verification harness - #10
Open
kawasima wants to merge 2 commits into
Open
Add runnable example exercise and end-to-end verification harness#10kawasima wants to merge 2 commits into
kawasima wants to merge 2 commits into
Conversation
A self-contained example that doubles as a reference handout and a verification harness for the whole learning loop: - examples/fizzbuzz/ — a standalone Maven exercise project (stub, grading tests, self-scoring runner via kysymys-scorer-java, .mvn/extensions.xml, properties template, reference solution). - examples/bin/mint-jwt — HS256 dev-JWT helper matching BouncrBackend's claims. - examples/verify.sh — drives the real loop against a dev server: register a problem, `mvn kysymys:submit`, review comment, notification, local scoring, stuck/resolved telemetry, and the instructor `/activity/status` dashboard. verify.sh passes 16/16 and surfaces one README/implementation gap: posting a comment emits no event, so it produces no notification (there is no CommentPostedEvent); RecordWhatsNew only reacts to SubmittedAnswer / OfferedToFollow. The script reports this as a known gap and verifies the notification mechanism itself via the follow-offer path. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Replace the one-line stub with a concept-first README (problem it solves, the learning loop, live work-activity telemetry, bounded contexts, modules, getting started) and link to examples/ for the runnable exercise and the end-to-end verification script. Co-Authored-By: Claude Opus 4.8 (1M context) <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.
Adds a self-contained example that doubles as a reference handout and an end-to-end verification harness, and rewrites the README with the platform concept.
What's here
examples/fizzbuzz/— a standalone Maven exercise (stub, grading tests, self-scoring runner viakysymys-scorer-java,.mvn/extensions.xml, properties template, reference solution). ItsREADME.mdis the problem statement.examples/bin/mint-jwt— HS256 dev-JWT helper matchingBouncrBackend's claims (sub/permissions/ …). Also makes the existingsrc/test/hurl/*.hurlscenarios runnable.examples/verify.sh— drives the real loop against a dev server (auto-startsmvn exec:javaif none is up).examples/.What
verify.shproves (16/16)Problem registration → real
mvn kysymys:submit(sends git remote URL + commit) → answer recorded → review comment → local scoring = 100 → follow-offer notification →stuck/resolvedtelemetry → build events on the instructor/activity/statusdashboard.Finding: README vs. implementation gap
Posting a comment emits no event, so it generates no notification — there is no
CommentPostedEvent, andRecordWhatsNewonly reacts toSubmittedAnswerEvent/OfferedToFollowEvent. The README says "comments reach the learner as a notification", which is not yet wired.verify.shreports this as a known gap and verifies the notification mechanism itself via the follow-offer path.examples/README.mddocuments this along with the other scope boundaries (no server-side scoring, dev HMAC token instead of the real Bouncr stack, best-effort Go watcher).Scope note
Requires the kysymys SNAPSHOT modules in
~/.m2(mvn -N install+ install ofkysymys-scorer-java/kysymys-maven-plugin/kysymys-activity-agent); the example project is standalone (not a reactor module).🤖 Generated with Claude Code