Correct README and CONTRIBUTING drift found in a docs sweep

[dmccoystephenson]

Summary

Stage A documentation accuracy sweep: every claim in README.md and CONTRIBUTING.md was checked against the source, build.gradle and the two workflows. Drift found and corrected:

• Launch command did not reliably run. ./gradlew build writes both Parpt-<version>.jar (boot jar) and Parpt-<version>-plain.jar (no Main-Class in its manifest — confirmed by reading both manifests). The documented java -jar build/libs/Parpt-*.jar expands to both; in byte order the plain jar sorts first, so java gets the non-runnable jar and fails with no main manifest attribute. The Installation, Getting Started and Usage reporting commands now name Parpt-<version>.jar, and the two jars are explained.
• Unfenced commands. The Installation and Getting Started commands were plain paragraph text, so GitHub rendered them as one run-on line; they are now fenced bash blocks.
• create options undocumented. CreateProjectCommand accepts -n/-d/-i/-c/-e/-r/-f and only prompts for what is missing; a Create Examples section now covers this, along with the existing behaviour that a taken name is rejected before any further question and an out-of-range option score is rejected with All scores must be between 1 and 5.
• Averaging undocumented. Each category asks four questions and stores Math.round(total / 4); this is now stated.
• Data location. app.projects.file / app.projects.markdown-file are relative paths resolved against the working directory; the README now says so.
• Feature list. "Export projects to Markdown and JSON formats" (export is Markdown only; JSON is the save file) and "Rank and sort projects by monetization, potential, feasibility and effort" (no such sort keys exist) were replaced with accurate bullets. The export command bullet said "optionally sorted"; it always sorts, by ICE score by default.
• CONTRIBUTING. "Generating test coverage reports" was replaced by "Generating JUnit test reports (no code-coverage tool is configured)" — build.gradle has no JaCoCo or other coverage plugin; the uploaded "coverage" artifacts are the JUnit HTML reports.

No production code was changed.

Test plan

• ./gradlew build run locally on JDK 21; build/libs/ contents and both manifests inspected
• ./gradlew test on JDK 21 — 144 tests executed, 0 failures, 0 errors, 0 skipped
• CI (test, build (21)) green on this branch

Deferred issues

This cycle was spent on a documentation sweep rather than the open backlog:

• Save data to user's home directory by default #33 (save data to the home directory by default) — changes the default of app.projects.file in application.yaml (a do-not-auto-merge path) and moves where existing users' data is read from; that default-location choice is left for the maintainer.
• Add installation script for Linux #36 (Linux install script) — depends on Save data to user's home directory by default #33 for its "data gets stored to the user's directory" requirement.
• Add controller endpoints to create, retrieve, update and delete projects #27 (CRUD controller endpoints) — needs a web dependency in build.gradle (do-not-auto-merge) and is larger than a single cycle.

No tracking issue — gap found during triage.

This PR description was drafted during a Gardener session (https://github.com/Stephenson-Software/gardener).

🤖 Generated with Claude Code

---

drafted by Claude on behalf of Daniel Stephenson

[github-actions]

Test Results

144 tests  ±0   144 ✅ ±0   1s ⏱️ ±0s
 22 suites ±0     0 💤 ±0 
 22 files   ±0     0 ❌ ±0 

Results for commit b600b41. ± Comparison against base commit ae6c529.

[dmccoystephenson]

Self-review rubric (Stage A documentation sweep):

• Scope: PASS — only README.md and CONTRIBUTING.md are modified; every hunk corrects a claim verified against source, build.gradle or the workflows.
• Tests-new: PASS (n/a) — no public method was added.
• Tests-fix: PASS (n/a) — no production code changed, so there is no fix to stash and re-run.
• Sibling structure: PASS — the new "Create Examples" section mirrors the existing List/Update/Delete/Export Examples sections (fenced bash block followed by a prose paragraph).
• Sibling renames: PASS (n/a) — nothing renamed.
• Docs: PASS — both Phase 7 sources of truth were swept; the Roadmap checklist needed no change, and ./gradlew test is still the documented and actual test command.
• Issue resolution: PASS (n/a) — no Closes reference; this is a gap-driven sweep.
• Manual validation: PASS — test, build (21) and Test Results green on the PR head; locally ./gradlew test on JDK 21 executed 144 tests with 0 failures.

Findings:

• README.md:34 — the first revision used build/libs/Parpt-0.3.0-SNAPSHOT-8-8-2026.jar as the example name, which would go stale at the next version bump. Fixed in the second commit by pointing at the version in build.gradle.
• README.md:67-68 — the two full-option create examples use the same name, so running both back to back would hit the "already taken" message. They read as alternatives (long vs. short option form), so they were left as they are.
• Out of diff: the plain-jar trap could be removed at the source with jar { enabled = false } in build.gradle, which would make the bare glob safe again. build.gradle is a do-not-auto-merge path and that is a build change rather than a docs change, so it was not made here.

Docs-only change, CI green, and no do-not-auto-merge path touched.

This review was drafted during a Gardener session (https://github.com/Stephenson-Software/gardener).

---

drafted by Claude on behalf of Daniel Stephenson