Kihagyás

Vendor feature verify — before workaround#

A pattern#

Sprint-tervezéskor, amikor a vendor docs azt mondja "feature X not supported", mielőtt elkezdjük a workaround-script implementációját:

  1. Ellenőrizd a jelenlegi verzió release-note-jait (különösen ha 3+ hónap telt el azóta, hogy a vendor docs-ot olvastad)
  2. Ellenőrizd a CHANGELOG-ot vagy [ENTERPRISE-ONLY] flag-eket a feature mellett
  3. Próbáld ki a feature-t egy docker-shell-ben vagy gyors smoke-test-ben: ha kapsz SyntaxError-t valid syntax-ra, akkor valószínűleg nem támogatott; ha más errort (OOM, Capacity exceeded) akkor TÁMOGATOTT, csak konfig kell

ROI: 30 perc release-note olvasás vs napok workaround-development.

Élő példa — Memgraph CE 3.9.0 native vector-index#

A SV B-2 sprint 2026-05-13-án indult numpy-cosine workaround-pattern-rel, mert a vault-docs (2026 elején olvasva) azt mondta hogy Memgraph CE nem támogat native vector-index-et. 2026-05-17-én verifikálva: a 3.9.0 (2026-04 release) NATÍV CREATE VECTOR INDEX syntax-ot kínál + vector_search.search procedure-t. 4 nap workaround-development megspórolható lett volna.

A migráció eredménye: 280× speedup (numpy 280ms → native 1ms mean). Részletek: memgraph-ce-feature-limits + ../06-Audits/2026-05-17 B-2 native vector-index migration.

Mikor érdemes alkalmazni#

  • ✅ Bármilyen 6+ hónapos roadmap-elemnél a release-cycle előtt (vendor lehet hogy közben implementálta)
  • ✅ Workaround-script aki >1 napos effort-ot követelne (a verify ROI dominál)
  • ✅ Open-source projektek esetén — GitHub release-notes + CHANGELOG kötelező pass

Mikor NEM kell#

  • ❌ Triviális workaround (<1 óra) — hamarabb megírod mint hogy átolvasd a docs-t
  • ❌ Closed-source vendor, ahol nincs release-note (akkor a verify ott történik amikor leszámlázzák a credit-eket)

2026-05-20 — Self-application failure: a graphify-Option-B case#

A minta saját magunkra is alkalmazandó lett volna. Az ../07-Decisions/2026-05-20 Option-B tree-sitter pre-pass for Memgraph extraction ADR-t azzal a feltételezéssel írtuk meg, hogy a graphify (uv-tool, 0.8.11) tree-sitter-rel code-symbol-okat extraktál — a package README/metadata tree-sitter-multi-language support-ot hirdet (tree_sitter_python, tree_sitter_javascript, tree_sitter_rust shipped a package-ben).

Empirikus inspekció 2026-05-20 PM (graphify-out/graph.json 5,846 node, manifest.json source-file list):

  • Parsed: 367 .md + 2 .json + 1 .sh
  • Python source files seen: 0
  • TypeScript/JavaScript source files: 0
  • Labels are markdown-section-paths (11_wiki_foxxi_design_system_page_level, Cél, Findings) — NEM code-symbols

Az ADR Tier-2 (deterministic) | graphify (tree-sitter + Leiden) | code-symbols (def extract_facts, class FactExtractor) | 4,439 nodes claim-je package-metadata-ból következtetett, NEM graph.json inspekcióból. 30 perces empirikus diagnosis megspórolt egy tervezett 4-5h experimental ingest-et (ami null-eredményre vezetett volna). ../06-Audits/2026-05-20 Option-B premise empirical refutation — graphify vocabulary is markdown not code részletekkel.

Wider lesson update: ne csak vendor-tool-okra alkalmazd ezt, hanem az ADR-jeidben minden third-party-tool-mention-höz tartozzon egy "empirically inspected output_file/graph.json/db.dump at <path> on " sor. Package-metadata + advertised features csábítóak, de a tényleges vault-corpusoddal mást csinálhatnak.

Kapcsolódó#