moving

docs/decisions/2026-04-20-verbose-fixed-oq-resolutions-locked.md

@@ -0,0 +1,91 @@
+# LOCKED — Verbose-Fixed Template Three OQ Resolutions
+
+**Datum:** 2026-04-20
+**Odobrio:** Marko Marković
+**Status:** LOCKED — zatvara OQ-VF-1, OQ-VF-2, OQ-VF-3 iz `strategy/2026-04-20-verbose-fixed-template.md` §11
+**Scope:** jezik, version-lock timing, harness retrieval stub test — finalizacija verbose-fixed kontrole pre Week 2 aktivacije
+
+---
+
+## OQ-VF-1 — Jezik template-a
+
+**Odluka:** **engleski**. Verbose-fixed prompt, svih 6 segmenata A-F, piše se i zaključava na engleskom. Srpska varijanta se ne pravi.
+
+**Rezon:** Tri pragmatična ograničenja vuku na istu stranu. Prvo, LoCoMo dataset, LongMemEval i τ-bench su svi originalno na engleskom — verbose-fixed mora match language of the ground-truth dataset ili uvodi translation confounder koji pokvari cell isolation. Drugo, training distribution ciljnog modela (Qwen3 35B-A3B-Thinking) je dominantno engleska; verbose-fixed prompt na srpskom bi aktivirao drugi deo parameter space-a i interkalira jezični shift u već skučen eksperimentalni dizajn. Treće, judge prompt ensemble (Sonnet/Haiku/GPT-5/Gemini) je kalibrisan na engleski — holding the judge language constant while flipping prompt language uvodi noise u scoring layer koji ne pripada eksperimentu.
+
+**Alternativa odbačena:** bilingvalni (engleski prompt + srpski inline gloss). Problem: duplira dužinu, potencijalno prelazi 700-1100 token budžet iz §2, i uvodi translation drift kada se inline gloss ne slaže sa engleskim formulacijama.
+
+**Operativno:**
+- §4 template text u `strategy/2026-04-20-verbose-fixed-template.md` ostaje engleski kako je draftovan
+- Harness label: `cell=verbose-fixed|lang=en` u output metadata-i
+- Srpska razmatranja kroz lifecycle (Marko review, dokumentacija) ostaju na srpskom; deliverable artifact je engleski
+
+---
+
+## OQ-VF-2 — Version lock timing
+
+**Odluka:** **zaključava se posle Week 2**, ne pre Week 1. Template ostaje "v1 draft, pending lock" do zatvaranja Week 2 four-cell main run-a.
+
+**Rezon:** Verbose-fixed je eksplicitno Week 2 kontrola, ne Week 1. Week 1 Qwen3 35B-A3B × LoCoMo main run koristi tri ćelije (raw / memory-only / full-stack bez evolve) — verbose-fixed ne učestvuje. Zaključavanje template-a pre Week 1 bilo bi premature jer Week 1 rezultati mogu izložiti ambigvitete u 6 segmenata (tipično u §C Memory Access Framing i §D Tool Use Guidance) koje treba retuširati pre Week 2 aktivacije. Zaključavanje posle Week 2 main run-a znači: pre produkcije izveštaja, template ima svoj final commit hash u waggle-os repo-u i ne može retroaktivno da se promeni, što štiti reproducibility claim.
+
+**Alternativa (a) odbačena:** zaključavanje pre Week 1. Problem: ne koristimo template u Week 1, a dorađivanje templata posle Week 1 bazirano na nalazima ne kvari eksperiment — ne bi bilo sample contamination-a. Prerano zaključavanje bi samo smanjilo kvalitet finalne verzije.
+
+**Alternativa (b) odbačena:** zaključavanje pre Week 2 main run-a ali posle Week 2 smoke-a. Problem: uvodi dodatnu check-point granicu koja u praksi ne menja ništa — ako Week 2 smoke uspešno validira four-cell isolation, nema razloga da se template još menja. Post-Week-2 lock je čisto, jasno, auditable.
+
+**Operativno:**
+- `strategy/2026-04-20-verbose-fixed-template.md` header dobija `Status: v1 draft — pending lock after Week 2 main run completion`
+- Svaka izmena template-a između sada i Week 2 lock-a dobija version bump (v1.1, v1.2…) sa changelog-om u fajlu
+- Posle Week 2 main run-a (milestone: four-cell isolation validated, main run results committed), Claude Code commituje `packages/server/benchmarks/configs/verbose-fixed-prompt.md` sa final hash-om i PM updateuje decisions log sa lock entry
+- Ako Week 2 four-cell main run fail-uje (nije prošao kriterijum), template verzija se može još jednom dotakne pre rerun-a, ali ide kroz eksplicitan amendment dokument
+
+---
+
+## OQ-VF-3 — Harness retrieval stub test
+
+**Odluka:** **explicit unit test**. Runtime assertion-i u four-cell harness-u nisu dovoljni — potrebna je eksplicitna test suite koja dokazuje cell isolation kroz construction, ne kroz observation.
+
+**Rezon:** Verbose-fixed cell ima strukturalni zahtev: kada se aktivira, retrieval pipeline ne sme biti pozvan. Validacija kroz runtime assert ("ako retrieval call broj > 0 u verbose-fixed cell-u, fail") hvata nepravilnost tek kada se desi, što znači da fail može tiho da se previdi ako test case ne pogodi tu granu. Explicit unit test — mockuje retrieval stack, aktivira verbose-fixed cell, assertuje 0 poziva — dokazuje invariantu kroz test infrastructure pre nego što se benchmark pokrene. Ovo je standardan test-first princip: bugovi u cell isolation kodu se hvataju u CI pre nego što dođu u main run.
+
+**Alternativa (a) odbačena:** samo runtime assertion u harness-u. Problem: ne hvata regression u source code-u. Ako neko slučajno ubaci retrieval poziv u cell=verbose-fixed branch-u, assertion to vidi tek kad se main run pokrene, što je skup benchmark cost (~$150 Block 4.3) da bi se uhvatio bug koji je test suite mogao uhvatiti za $0.
+
+**Alternativa (b) odbačena:** integration test sa kompletnim dataset-om. Problem: spor (integration test-ovi traju minute, unit test-ovi traju sekunde) i overkills za invariantu koja se može izolovano testirati.
+
+**Operativno:**
+- Unit test fajl: `packages/server/tests/benchmarks/verbose-fixed-cell-isolation.test.ts`
+- Minimum 3 test case-a:
+  1. `verbose-fixed cell invokes zero retrieval calls` — mock retriever, aktiviraj verbose-fixed cell, assert retriever.search call count === 0
+  2. `verbose-fixed cell invokes zero wiki compiler calls` — mock wiki compiler, assert wiki.compile call count === 0
+  3. `verbose-fixed cell invokes zero memory read calls` — mock memory reader, assert memory.read call count === 0
+- Test mora biti dodat u exit gate za four-cell harness (Task 7 u `briefs/2026-04-20-cc-sprint-7-tasks.md` — ako test nije dodat, Task 7 nije zatvoren)
+- CI failing ovaj test = blocker za merge u main
+
+---
+
+## Status verbose-fixed template-a posle ovih resolution-a
+
+**Zatvoreno:**
+- Jezik: engleski (sva 6 segmenata)
+- Timing: v1 draft sada, version-locked posle Week 2 main run
+- Harness kontrola: explicit unit test + runtime assertions (defense in depth)
+
+**Ostaje otvoreno (non-blocking):**
+- Da li verbose-fixed uključuje "thinking" mode aktivaciju za Qwen3 35B-A3B-Thinking — naslanja se na §C Memory Access Framing sekciju, rešava se kada se Week 1 rezultati vide (Week 2 prep)
+- Failure mode taxonomy (sledeći PM deliverable) — nije verbose-fixed specific ali se koristi u LLM-judge prompt-ima koji ocenjuju verbose-fixed output
+
+**Blocking dependencies ispred Week 2 aktivacije:**
+1. Pre-flight gate PASS (Stage 0 → Stage 1 → Stage 2 4-cell)
+2. Week 1 Qwen3 35B-A3B × LoCoMo main run PASS (tri ćelije bez verbose-fixed)
+3. Four-cell harness Task 7 merged + verbose-fixed unit test-ovi green
+4. Template finalizacija po Week 1 observation-ima, ako ih bude
+
+---
+
+## Referenca
+
+- Verbose-fixed template spec: `strategy/2026-04-20-verbose-fixed-template.md`
+- Four-cell harness spec: `strategy/2026-04-20-four-cell-harness-spec.md`
+- Harness spec 4 OQ LOCKED: `decisions/2026-04-20-harness-spec-4-oq-locked.md`
+- Pre-flight OQ resolutions: `decisions/2026-04-20-preflight-oq-resolutions-locked.md`
+- 7 obligations LOCKED: `decisions/2026-04-20-benchmark-7-obligations-locked.md`
+- CC Sprint brief: `briefs/2026-04-20-cc-sprint-7-tasks.md`
+- Memory: `.auto-memory/project_cc_sprint_active_2026_04_20.md`