docs-drift / report
Documentation intelligence

py-cli

3fb52f15 · 05 Oct 2026, 09:00 UTC
1 documents · 10 claims checked
56DOCS HEALTH
What needs attention
README.md:4 · py-cliUNVERIFIABLE

- `serve` accepts `--port` (default 8000).

− --port
+ No authoritative indexed default was available for this subject.
450a93d · Rename port to listen
02 Oct 2026
Evidence · 1 sources

README.md:4

4 │ (default 8000)

No authoritative indexed default was available for this subject.

README.md:4 · py-cliRENAMED

- `serve` accepts `--port` (default 8000).

− --port
+ --listen
450a93d · Rename port to listen
02 Oct 2026
Evidence · 2 sources

README.md:4

4 │ --port

cli.py:1

1 │ -    serve.add_argument("--port", type=int, default=8000)
2 │ +    serve.add_argument("--listen", type=int, default=8000)

No indexed cli_flag named --port was found. Closest indexed candidates: --host (cli.py:9), --workers (cli.py:10), --listen (cli.py:8). Git history confirms this name changed to --listen. Git history changed this name in 450a93d.

README.md:6 · py-cliDEFAULT

- The `--workers` default is `4`.

− 4
+ 8
397bff7 · Increase the worker default
03 Oct 2026
Evidence · 3 sources

README.md:6

6 │ default is `4`

cli.py:10

10 │ cli.serve.--workers default=8

cli.py:10

10 │ -    serve.add_argument("--workers", type=int, default=4)
11 │ +    serve.add_argument("--workers", type=int, default=8)

Documented default '4' differs from code default '8'.

README.md:7 · py-cliMISSING

- Set `APP_DEBUG` to enable debug logging.

− APP_DEBUG
+ APP_LOG_LEVEL
f686fb7 · Replace debug environment variable with log level
04 Oct 2026
Evidence · 2 sources

README.md:7

7 │ APP_DEBUG

cli.py:1

1 │ -    debug = os.environ.get("APP_DEBUG", "0")
2 │ -    return parser.parse_args(), debug
3 │ +    log_level = os.environ.get("APP_LOG_LEVEL", "INFO")
4 │ +    return parser.parse_args(), log_level

No indexed env_var named APP_DEBUG was found. Closest indexed candidates: APP_LOG_LEVEL (cli.py:12). Git history changed this name in f686fb7.

README.md:8 · py-cliRENAMED

- Use the `migrate` subcommand to upgrade the database.

− migrate
+ db-upgrade
3fb52f1 · Rename the database upgrade subcommand
05 Oct 2026
Evidence · 2 sources

README.md:8

8 │ migrate

cli.py:1

1 │ -    commands.add_parser("migrate")
2 │ +    commands.add_parser("db-upgrade")

No indexed cli_command named migrate was found. Closest indexed candidates: db-upgrade (cli.py:11). Git history confirms this name changed to db-upgrade. Git history changed this name in 3fb52f1.