kb

Fragt das Wissen, bevor du selbst recherchierst. Die Frage ist das Problem in einem Satz, am besten mit der Fehlermeldung. Die CLI schickt das Projekt aus .workban.toml und die Pakete aus den package.json des Repos mit; Workban bevorzugt dann Lösungen für dieselbe Version.

• Jeder Treffer nennt Status, Bestätigungen und wodurch er gefunden wurde: Vektor (mit der Ähnlichkeit), Text oder Graph.
• Ohne Treffer sagt die Antwort das. Lieber kein Treffer als ein falscher.
• Ist der Embeddings-Dienst nicht erreichbar, sucht Workban über Text und Graph und sagt das.
• Die CLI merkt sich, dass die Sitzung gefragt hat; der Hook erinnert sie dann eine halbe Stunde lang nicht vor Websuchen.
• Für die Kennzahlen auf der Seite „Wissen“ zählt Workban die Frage mit Agent, Sitzung und Task, ohne ihren Text.

workban kb ask "Typecheck bricht nach supabase gen types: NonNullable<Json>" --json
workban kb ask "Passkey-Login in Safari" --symptom "NotAllowedError: The operation either timed out"

Trägt ein gelöstes und belegtes Problem ein, als Markdown oder JSON von stdin oder aus einer Datei. Markdown hat den Titel als # … und die Abschnitte ## Symptom, ## Ursache (oder Cause), ## Lösung (oder Solution) und ## Beleg (oder Evidence). Gab es Irrwege, nennt ## Versucht (oder Tried) kurz, was nicht half; kb ask zeigt das unter der Lösung, damit die nächste Sitzung es auslässt.

• --package next hängt das Paket mit der Version aus dem Repo an, --package next@16.3.4 mit dieser. Nur die betroffenen Pakete, nicht alle des Repos.
• --module apps/web/src/server/live nennt die betroffene Stelle, relativ zum Repo.
• Ohne --task nimmt die CLI den laufenden Task dieser Sitzung.
• Lokale Pfade kürzt die CLI wie bei Tasks. Ein Geheimnis (Token, Passwort, Schlüssel) lehnt sie ab, bevor etwas gesendet wird; die API lehnt Geheimnisse und E-Mail-Adressen ebenfalls ab.
• Gibt es schon sehr ähnliche Einträge, antwortet die API mit 409 und nennt sie. Passt einer, bestätige ihn mit kb confirm; ist es wirklich ein anderes Problem, noch einmal mit --force.

workban kb add --stdin --package @supabase/supabase-js --json <<'EOF'
# Typecheck bricht nach Supabase-Update bei Json-Spalten
## Symptom
Type 'Json' is not assignable to type 'NonNullable<Json>'
## Ursache
Neuere supabase gen types schreibt jsonb-Spalten mit not null anders.
## Lösung
Nur die neuen Spalten von Hand nachtragen, den Rest der Ausgabe verwerfen.
## Versucht
supabase-js zurück auf die alte Version: die Typen bleiben falsch, sie kommen aus der CLI.
## Beleg
pnpm typecheck grün, Task #1234
EOF

Sagt, ob ein Eintrag geholfen hat: --helpful oder, nach einem Versuch, --not-helpful. Die erste hilfreiche Antwort aus einer anderen Sitzung als der, die ihn eingetragen hat, macht einen neuen Eintrag zu einem bestätigten; bestätigte stehen bei der Suche weiter oben.

Zeigt einen Eintrag ganz, mit Status, Bestätigungen und betroffenen Paketen.