📖 🤖 Standard-Header + Usage-Block — toolref führt usage=NULL #2

New issue

Closed

opened 2026-08-16 01:15:56 +02:00 by holm · 1 comment

holm commented

2026-08-16 01:15:56 +02:00

Owner

Dimension	Bewertung	Einschätzung
Aufwand	`█░░░░░░░░░`	Minimal — Header + usage()
Nutzen	`████░░░░░░`	Mittel — toolref-Lookup liefert dann Syntax statt NULL
Bruchhäufigkeit	`█░░░░░░░░░`	Minimal — reine Doku, Verhalten unverändert
Nachhaltigkeit	`████████░░`	Hoch — einmal sauber, jeder Lookup sitzt
Dringlichkeit	`██░░░░░░░░`	Niedrig

Befund (2026-08-16, pwgenz6c-Session): askpass-wrapper.sh hat nur eine SPDX-Zeile — kein Standard-Header (Skriptname/Beschreibung/Repo), keine -h-Hilfe. toolref führt das Tool mit usage=NULL, jeder Syntax-Lookup zwingt zur Quell-Lektüre (Regel 61 andersrum).

Zu ergänzen, ohne Verhaltensänderung: Standard-Header-Block + usage() mit Mapping-Doku (Prompt-Parsing → pass show ssh/<sub>, Fallback basename, Debug-Log /tmp/askpass-debug.log, Env-Contract SSH_ASKPASS/SSH_ASKPASS_REQUIRE=force). Flag-Behandlung nur für exakte -h|--help|-V|--version — der Prompt-Text von ssh darf nie als Flag fehlinterpretiert werden.

🤖 angelegt von Claude v00 (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `█░░░░░░░░░` | Minimal — Header + usage() | | Nutzen | `████░░░░░░` | Mittel — toolref-Lookup liefert dann Syntax statt NULL | | Bruchhäufigkeit | `█░░░░░░░░░` | Minimal — reine Doku, Verhalten unverändert | | Nachhaltigkeit | `████████░░` | Hoch — einmal sauber, jeder Lookup sitzt | | Dringlichkeit | `██░░░░░░░░` | Niedrig | Befund (2026-08-16, pwgenz6c-Session): `askpass-wrapper.sh` hat nur eine SPDX-Zeile — kein Standard-Header (Skriptname/Beschreibung/Repo), keine `-h`-Hilfe. toolref führt das Tool mit `usage=NULL`, jeder Syntax-Lookup zwingt zur Quell-Lektüre (Regel 61 andersrum). Zu ergänzen, ohne Verhaltensänderung: Standard-Header-Block + `usage()` mit Mapping-Doku (Prompt-Parsing → `pass show ssh/<sub>`, Fallback basename, Debug-Log /tmp/askpass-debug.log, Env-Contract SSH_ASKPASS/SSH_ASKPASS_REQUIRE=force). Flag-Behandlung nur für exakte `-h|--help|-V|--version` — der Prompt-Text von ssh darf nie als Flag fehlinterpretiert werden. > 🤖 angelegt von Claude v00 (API/Token holm)

holm added the

Kind/Documentation

Priority/Low

labels

2026-08-16 01:16:11 +02:00

holm commented

2026-08-16 01:17:14 +02:00

Author

Owner

Umgesetzt in b301a71: Standard-Header + usage()/-V, Logik byte-gleich (bash -n + Negativ-Smoke-Test ok). toolref-Reimport: usage jetzt gefüllt.

🤖 angelegt von Claude v00 (API/Token holm)

Umgesetzt in b301a71: Standard-Header + usage()/-V, Logik byte-gleich (bash -n + Negativ-Smoke-Test ok). toolref-Reimport: usage jetzt gefüllt. > 🤖 angelegt von Claude v00 (API/Token holm)

holm closed this issue

2026-08-16 01:17:14 +02:00

holm referenced this issue from a commit

2026-08-16 01:17:16 +02:00

docs(script): Standard-Header + usage()/-V — Verhalten unverändert ([#2](https://forgejo.mueller.network/holm.tools.public/askpass-wrapper/issues/2))