homelab-codex-ws/kb/decisions/tech-debt-legacy.md
oskar 01db57ab82 fix(kb): przepiecie wszystkich odwolan wewnetrznych po migracji
126 plikow (md, yaml, sh, py) odwolywalo sie do sciezek sprzed migracji.

  15  markdown-linkow [..](..) -> policzona sciezka WZGLEDNA wobec pliku
      odsylajacego (wczesniej czesc z nich byla repo-root-relative i nie
      rozwiazywala sie z katalogu, w ktorym lezala)
 200  odwolan tekstowych (backticki, proza, yaml, importy w kodzie)
      -> nowa sciezka repo-root-relative, zgodnie z konwencja repo
   5  linkow rodzenstwa (gole nazwy plikow, np. "](DEPLOY.md)") — dzialaly
      tylko w starym katalogu; przeliczone recznie

Objete m.in.: CLAUDE.md (scripts/onboard/README.md -> kb/runbooks/
node-onboarding-tool.md, docs/backlog.md -> kb/phases/backlog.md),
README.md, .claude/skills/, 20 session logow, kod jobow.

Ostatnie 5 odwolan pochodzi z tresci wciagnietej rebasem z origin/master
(session log 2026-07-31, override node-agenta na SOLARII, dwie pozycje
backlogu) — wskazywaly na docs/incidents/, docs/kb/modules/ i
services/narty27/README.md sprzed migracji.

Dodany wzajemny link miedzy kb/services/control-plane.md (stub kodu)
a kb/subsystems/control-plane.md (opis, deprecated) — dwa dokumenty o tym
samym systemie, latwe do pomylenia.

Weryfikacja na 790 plikach: 0 odwolan do starych sciezek,
0 martwych linkow markdown. Lint OKF: 190/190 plikow ZGODNE.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-04 16:53:57 +02:00

1.3 KiB

okf type visibility status updated links superseded_by
0.1 decision private deprecated 2026-06-24
kb/phases/backlog.md (kb/phases/backlog.md przejal ewidencje dlugu)

Tech Debt

forgejo_runner (piha)

  • Status: temp disabled
  • Data: 2026-05-21
  • Opis: Forgejo CI/CD runner — infrastruktura gotowa (forgejo_dind działa), brak aktywnych pipeline'ów. Warto wdrożyć gdy pojawi się potrzeba automatyzacji deployów.
  • Co zrobić: skonfigurować runner token w Forgejo UI, postawić kontener, napisać pierwszy workflow.

Cleanup: artefakty paste-error w ~oskar (SOLARIA) — niski priorytet

Data: 2026-06-24. W ~oskar zalegają puste pliki/katalogi o nazwach będących fragmentami outputu LLM (np. 'Say hello', 'show_greeting.py (Updated)', 'Sure thing here is the updated version...', 'udo systemctl start ollama', oraz plik z Python-injection w nazwie). Diagnoza robocza: wklejenie odpowiedzi asystenta (markdown+kod) wprost do shella ze złej sesji ~3 maja — shell zinterpretował tekst jako komendy. NIE potwierdzony injection ani agent bez sandboxa (pliki 0-bajtowe, stare). DO ZROBIENIA kiedyś: (1) zweryfikować pochodzenie (czy na pewno paste-error, nie start-aider.sh/agent-system bez guardraili), (2) posprzątać śmieci z ~oskar. Blast-radius: zerowy obecnie. Nie blokuje niczego.