{ "repo": "tinyclick", "summary": "Documentation advertises flags, exit behavior, and glob support that the CLI implementation does not provide.", "findings": [ { "id": "flag-name-drift", "severity": "high", "title": "Docs advertise --count, but implementation uses --times", "doc_refs": [ "README.md: usage `tinyclick count PATH [--count]`", "docs/cli.md: `--count` flag table row" ], "code_refs": [ "src/cli.py:15 `count_p.add_argument(\"--times\", ...)`" ], "evidence": "README and docs/cli.md describe a `--count` flag, while src/cli.py defines `--times` and checks `args.times`.", "suggested_fix": "Rename the implementation flag to `--count`, or update documentation to `--times`.", "confidence": 0.99, "verified": true, "verification_notes": "Fixture intentionally planted; confirmed against fixture source." }, { "id": "missing-file-exit-code", "severity": "high", "title": "Docs say missing file exits 0, code exits 2", "doc_refs": [ "README.md: 'exits with code 0'", "docs/cli.md: '0 success or missing file (non-fatal)'" ], "code_refs": [ "src/cli.py:20-23 missing path branch returns 2" ], "evidence": "Both docs state a missing path is non-fatal with exit code 0, but the code prints a warning and returns 2.", "suggested_fix": "Make the missing-file branch return 0, or update docs to state exit code 2.", "confidence": 0.99, "verified": true, "verification_notes": "Fixture intentionally planted; confirmed against fixture source." }, { "id": "glob-recursive-unimplemented", "severity": "medium", "title": "Docs claim glob and recursive support, but implementation does not expand globs", "doc_refs": [ "README.md: 'Supports globs like src/**/*.py.'", "docs/cli.md: `--recursive` flag table row" ], "code_refs": [ "src/cli.py:13 `count_p.add_argument(\"path\", type=Path)`", "src/cli.py:20 `if not args.path.exists()`" ], "evidence": "Documentation advertises glob expansion and a `--recursive` flag, but the parser accepts a single Path and only checks whether that exact path exists.", "suggested_fix": "Implement glob expansion and `--recursive`, or remove those claims from documentation.", "confidence": 0.95, "verified": true, "verification_notes": "Fixture intentionally planted; confirmed against fixture source." } ], "usage": { "prompt_tokens": 813, "completion_tokens": 1157, "reasoning_tokens": 572, "total_tokens": 1970 }, "reasoning_effort": "medium", "latency_s": 7.22, "model": "Beam-1.0-501B-A23B", "source": "live-beam" }