docs: README stale vs code — wciąż opisuje CLI subprocess który został usunięty #1

Closed
opened 2026-05-18 09:07:34 +02:00 by ollama · 1 comment
Collaborator

Problem

README.md opisuje starą architekturę CLI-subprocess (infisical login, subprocess.run, Keychain JWT) która została zastąpiona w commicie 5ea51fd refactor!: prefer machine identity Token Auth, drop CLI subprocess.

Kod teraz używa bezpośredniego REST API z Bearer tokenem (urllib.request + Authorization: Bearer). README wciąż pisze o:

  • infisical login --domain=... jako metodzie odświeżania (kod nie używa CLI)
  • subprocess.run z security find-generic-password (to jest tylko w fallbacku keyring, ale README przedstawia to jako główną ścieżkę)
  • brew install infisical/get-cli/infisical jako zależności (kod nie wymaga CLI do REST API)

Impact

Agent czytający README w nowej sesji dostaje błędny model mentalny architektury. Sekcja "Install" i "Auth model" są mylące.

Sugerowana poprawka

  1. Zaktualizować "Auth model" — machine identity Token Auth jako primary, keychain JWT jako fallback (zgodnie z kodem)
  2. Usunąć brew install infisical z zależności (nie jest wymagane do REST API)
  3. Dodać że kod używa bezpośredniego REST API, nie CLI
  4. Sekcja "Security" wciąż mówi o subprocess.run — zaktualizować

Filed by Dziadek (ollama, DeepSeek-v4-pro) — wide review 2026-05-18

## Problem README.md opisuje starą architekturę CLI-subprocess (`infisical login`, `subprocess.run`, `Keychain JWT`) która została zastąpiona w commicie `5ea51fd refactor!: prefer machine identity Token Auth, drop CLI subprocess`. Kod teraz używa bezpośredniego REST API z Bearer tokenem (`urllib.request` + `Authorization: Bearer`). README wciąż pisze o: - `infisical login --domain=...` jako metodzie odświeżania (kod nie używa CLI) - `subprocess.run` z `security find-generic-password` (to jest tylko w fallbacku keyring, ale README przedstawia to jako główną ścieżkę) - `brew install infisical/get-cli/infisical` jako zależności (kod nie wymaga CLI do REST API) ## Impact Agent czytający README w nowej sesji dostaje błędny model mentalny architektury. Sekcja "Install" i "Auth model" są mylące. ## Sugerowana poprawka 1. Zaktualizować "Auth model" — machine identity Token Auth jako primary, keychain JWT jako fallback (zgodnie z kodem) 2. Usunąć `brew install infisical` z zależności (nie jest wymagane do REST API) 3. Dodać że kod używa bezpośredniego REST API, nie CLI 4. Sekcja "Security" wciąż mówi o `subprocess.run` — zaktualizować --- *Filed by Dziadek (ollama, DeepSeek-v4-pro) — wide review 2026-05-18*
Collaborator

Closed in c3abc9f (v0.3.0).

README został przepisany — usunięte:

  • "MCP wrapper around the infisical CLI" → "around Infisical's REST API"
  • brew install infisical jako required (teraz tylko opcjonalne, dla fallback path)
  • subprocess.run jako "main" w § Security (jedyne wywołanie subprocess to keychain lookup, jasno opisane)
  • Phantom skrypt infisical-mcp-discover-project-id (zamiast tego pokazujemy że MCP sam discoveruje przez list_projects — patrz #3)

Sekcja "Auth model (v0.2.0+)" już była dobrze zaktualizowana w v0.2.0; w v0.3.0 dorzucone INFISICAL_MCP_COUSIN do tabeli env vars. Dzięki za wyłapanie 🙏

Closed in [`c3abc9f`](https://git.pdurlej.com/pdurlej/infisical-mcp/commit/c3abc9f) (v0.3.0). README został przepisany — usunięte: - "MCP wrapper around the `infisical` CLI" → "around Infisical's REST API" - `brew install infisical` jako *required* (teraz tylko opcjonalne, dla fallback path) - `subprocess.run` jako "main" w § Security (jedyne wywołanie subprocess to keychain lookup, jasno opisane) - Phantom skrypt `infisical-mcp-discover-project-id` (zamiast tego pokazujemy że MCP sam discoveruje przez `list_projects` — patrz #3) Sekcja "Auth model (v0.2.0+)" już była dobrze zaktualizowana w v0.2.0; w v0.3.0 dorzucone INFISICAL_MCP_COUSIN do tabeli env vars. Dzięki za wyłapanie 🙏
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
pdurlej/infisical-mcp#1
No description provided.