Steinberger Scorecard - Exact Scoring Patterns
This table maps each scorecard dimension to the exact file and string patterns measured by internal/pipeline/scorecard.go. Use this to target Phase 4 fixes at patterns that actually score points.
Scoring Algorithm
Each dimension is 0-10. Total is 0-90. Grade: A >= 80%, B >= 65%, C >= 50%, D >= 35%, F < 35%.
Run the scorecard: cli-printing-press scorecard --dir ./<api>-cli
Dimension Reference
| Dimension | File Checked | Patterns (points each) | Max |
|---|---|---|---|
| Output Modes | internal/cli/root.go |
json(+2) plain(+2) select(+2) table(+2) csv(+2) |
10 |
| Auth | internal/config/config.go + file existence |
os.Getenv count: 1 call = 5pts, 2+ calls = 8pts. internal/cli/auth.go exists = +2pts |
10 |
| Error Handling | internal/cli/helpers.go |
hint: or Hint: present = +5. Count of code: occurrences (1pt each, max 5) |
10 |
| Terminal UX | internal/cli/helpers.go |
colorEnabled(+5) NO_COLOR(+3) isatty(+2) |
10 |
| README | README.md |
Exact section strings: Quick Start(+2) Output Formats(+2) Agent Usage(+2) Troubleshooting(+2) Doctor(+2) |
10 |
| Doctor | internal/cli/doctor.go |
Count HTTP patterns x2: http.Get, http.Head, http.NewRequest, http.Client, httpClient.Get, httpClient.Head, httpClient.Do |
10 |
| Agent Native | internal/cli/root.go + helpers.go |
json(+2) select(+2) dry-run/dryRun/dry_run(+2) non-interactive/nonInteractive(+1) stdin(+1) "yes"(+1) 409/already exists(+1) human-friendly/humanFriendly(+1) |
10 |
| Local Cache | internal/client/client.go + internal/cache/cache.go |
cacheDir/readCache/writeCache(+5) no-cache/NoCache(+2) sqlite/bolt/badger in cache.go or store.go(+3) |
10 |
| Breadth | internal/cli/*.go file count |
Excludes: helpers.go, root.go, doctor.go, auth.go. Thresholds: <5=0, 5-10=3, 11-20=5, 21-40=7, 41-60=9, 60+=10 | 10 |
| Workflows | internal/cli/*.go registered commands |
Workflow filename prefixes, direct store use, package-local store helpers, or 2+ client API calls | 10 |
| Insight | internal/cli/*.go registered commands |
Insight filename prefixes, store use plus aggregation patterns (COUNT(, SUM(, GROUP BY, rates), or manifest novel-feature hints |
10 |
Key Gotchas
- README scorecard checks for exact string
"Doctor"(capital D), not"Health Check"or"doctor" - Agent Native checks root.go + helpers.go ONLY -
stdinin command files doesn't count - Auth gives +2 just for
auth.goexisting as a file, regardless of content - Local Cache gives +3 for
sqlite/bolt/badgerstrings ininternal/cache/cache.goorinternal/store/store.go - Breadth counts files, not commands - one file per endpoint beats one file per resource
- Workflow scoring follows registered Cobra commands and recognizes package-local helpers that reach the store