@mmerterden/multi-agent-pipeline 8.6.1 → 10.0.6

package/docs/GENERICITY-REVIEW.md

@@ -1,277 +0,0 @@
-# Multi-Agent Pipeline — Genericity Review
-
-> Soru: Pipeline başka bir şirkette stabil çalışır mı? Bu rapor bunu somut delillerle yanıtlıyor.
-> Tarih: 2026-05-08 · Branch: `fix/stability-8-defects` (commit `2805538`) · Reviewer: end-to-end audit
-
-## TL;DR
-
-**Pipeline başka bir şirkette çalışır AMA fork-ve-rebrand zorunlu, üç tip friction noktası var.** Mimari katman (cross-platform credential store, placeholder-driven setup, multi-CLI adapter, smoke gate'ler) sağlam. Bağımlılık katmanı (npm publish ownership, dev-toolkit-mcp tool dependency, mmerterden-marka adlandırma) bir başka kurumda 1-2 günlük rebrand işi.
-
-| Boyut | Skor | Açıklama |
-|---|---|---|
-| Cross-platform desteği | 8/10 | macOS+Linux+Windows credential store, ama bazı smoke/ops scriptleri macOS-only |
-| Placeholder/genericization | 9/10 | `{owner}`, `{JIRA_KEY}`, `{JIRA_HOST}`, `{CONFLUENCE_HOST}`, `{CORP_DOMAIN}` placeholder'ları tutarlı; smoke-personal-data gate aktif |
-| Cross-CLI portability | 9/10 | Claude Code + Copilot CLI + Cursor + Windsurf + Cline + Zed adapter'ları |
-| Bağımlılık genericlik | 5/10 | `@mmerterden/multi-agent-pipeline` + `@mmerterden/dev-toolkit-mcp` package isimleri her yerde |
-| Onboarding (setup wizard) | 9/10 | Cross-platform, dil ekseni, jira host/corp domain prompt-driven |
-| Smoke / regression gate'leri | 8/10 | 100+ smoke scripti var; 3 gate (lint/output-quality/token-budget) pre-existing fail |
-| Dokümantasyon | 7/10 | Türkçe + İngilizce karışık; kuruma özel skill örnekleri (THY iOS) görece az ama mevcut |
-| **Genel** | **7.5 / 10** | **Production-ready bir başka şirket için, fork + rebrand sonrası** |
-
----
-
-## 1. Cross-platform desteği
-
-### Çalışıyor
-
-- `pipeline/lib/credential-store.sh` 3 platform'a delegate ediyor:
-  ```bash
-  detect_platform() {
-    case "$(uname -s 2>/dev/null)" in
-      Darwin) echo "macos" ;;     # security
-      Linux)  echo "linux" ;;      # secret-tool (libsecret)
-      *)      echo "windows" ;;    # PowerShell CredentialManager
-    esac
-  }
-  ```
-- `pipeline/scripts/keychain.py` — Python 3 cross-platform fallback, hem macOS hem Linux için aynı API
-- `install/_platform-filter.mjs` — install sırasında platform-spesifik dosyaları filtreliyor
-- Setup wizard tablosu net:
-  | Platform | Backend | Built-in? |
-  |----------|---------|-----------|
-  | macOS    | Keychain (`security`) | Evet |
-  | Windows  | Credential Manager | PowerShell module install gerek |
-  | Linux    | libsecret (`secret-tool`) | distro paketi gerek |
-
-### Çalışmıyor / eksik
-
-- `pipeline/scripts/smoke-keychain.sh` doğrudan `/usr/bin/security` çağırıyor — Linux/Windows'ta smoke fail eder. **Etki: minor — sadece geliştirici testi için, runtime path'i değil.**
-- `pipeline/scripts/audit-log-rotate.sh` ops doc'unda sadece launchd plist örneği — Linux için `cron`, Windows için Task Scheduler örneği yok. **Etki: minor — ops setup-time doc.**
-- `gh`, `jq`, `gh issue comment` — bu CLI'lerin Linux/Windows üzerinde de mevcut olduğu varsayılıyor. `command -v` check'leri var, ama doğru hata mesajı her zaman değil.
-
-### Skor: 8/10
-
----
-
-## 2. Placeholder / genericization
-
-### Doğru çalışan placeholder şeması
-
-`pipeline/commands/multi-agent/refs/cross-cli-contract.md` master placeholder tablosu:
-
-| Placeholder | Anlam | Örnek |
-|---|---|---|
-| `{owner}` | Pipeline repo sahibi (org/user) | `mmerterden` |
-| `{JIRA_KEY}` | Default Jira proje key'i | `PROJ` |
-| `{JIRA_HOST}` | Jira hostname | `jira.example.com` |
-| `{BITBUCKET_HOST}` | Bitbucket hostname | `bitbucket.example.com` |
-| `{CONFLUENCE_HOST}` | Confluence hostname | `confluence.example.com` |
-| `{CORP_DOMAIN}` | Kurumsal e-mail domain'i | `example.com` |
-| `{website-host}` | Website repo adı | `mmerterden.dev` |
-
-Setup wizard runtime'da bu placeholder'ların yerine kullanıcı verisini koyuyor. Phase 0 Step 1 input parser `ABC-123` formatından `ABC` Jira key'ini öğreniyor (auto-learning).
-
-### Smoke gate'ler bunu enforce ediyor
-
-- `smoke-personal-data.sh` 13 yasak pattern arıyor (örn. `M_ERDEN3_`, `@thy.com`, `turkish-airlines-*`)
-- `smoke-install-leak-gate.sh` install edilen tree'de aynı pattern'leri arıyor
-- **Bu review'da smoke 1 leak yakaladı:** `channels.md:340` hardcoded `M_ERDEN3_Github_Access_Token`. **Düzeltildi** (`2805538` commit).
-
-### Hâlâ kalan THY-spesifik örnekler (3 adet, minor)
-
-| Dosya | Satır | Örnek |
-|---|---|---|
-| `pipeline/skills/shared/core/multi-agent/SKILL.md` | 461 | `Xcode → THY.xcworkspace aç → Cmd+B → Cmd+U` |
-| `pipeline/skills/shared/core/multi-agent/SKILL.md` | 509 | `~/my-figma-app/TurkishAirlinesPackages/Packages/my-ui-components-wiki` |
-| `pipeline/skills/figma-ios/figma-to-component/phases/phase-3b-tokens.md` | 81 | `Swift: THYFont.smallRegular` |
-
-Bunlar **yorum/örnek**, runtime path'inde değil. Yine de bir başka şirkete fork edilirken sed-replace yapılmalı:
-
-```bash
-sed -i '' 's/THY\.xcworkspace/{ProjectName}.xcworkspace/g' pipeline/skills/shared/core/multi-agent/SKILL.md
-sed -i '' 's/TurkishAirlinesPackages/{ProjectPackages}/g' pipeline/skills/shared/core/multi-agent/SKILL.md
-sed -i '' 's/THYFont/{BrandFont}/g' pipeline/skills/figma-ios/figma-to-component/phases/phase-3b-tokens.md
-```
-
-### Skor: 9/10
-
----
-
-## 3. Cross-CLI portability
-
-`pipeline/adapters/` altında 6 IDE/CLI adapter:
-
-```
-copilot-chat.mjs   → GitHub Copilot Chat (VS Code)
-cursor.mjs         → Cursor IDE
-windsurf.mjs       → Windsurf
-cline.mjs          → Cline (VS Code extension)
-zed.mjs            → Zed editor
-```
-
-Plus core: Claude Code (canonical) + Copilot CLI (mirror).
-
-Cross-CLI contract (`refs/cross-cli-contract.md`) explicit tutuyor:
-- Aynı 29 sub-command her iki CLI'da: `multi-agent dev`, `multi-agent local`, `multi-agent status`, vb.
-- Frontmatter farkı belgelenmiş (Claude Code'un `allowed-tools`, Copilot'ın `user-invocable`)
-- Picker UI farkları belgelenmiş (Claude Code native AskUserQuestion, Copilot CLI numbered text)
-
-### Skor: 9/10
-
----
-
-## 4. Bağımlılık genericlik (en zayıf nokta)
-
-### Pipeline'ın kendisini referans veren yerler (intentional, fork'ta rebrand gerek)
-
-```
-pipeline/adapters/cursor.mjs:173:    > Installed by @mmerterden/multi-agent-pipeline.
-pipeline/adapters/windsurf.mjs:86:    > Installed by @mmerterden/multi-agent-pipeline.
-pipeline/adapters/zed.mjs:85:       > Installed by @mmerterden/multi-agent-pipeline.
-pipeline/adapters/cline.mjs:120:    `_Source: @mmerterden/multi-agent-pipeline_`
-pipeline/adapters/copilot-chat.mjs:131: > Installed by @mmerterden/multi-agent-pipeline.
-pipeline/lib/credential-store-resolver.sh:18:  npx @mmerterden/multi-agent-pipeline install
-pipeline/scripts/uninstall.mjs:19:  npx @mmerterden/multi-agent-pipeline uninstall
-```
-
-Fork ederken `package.json` `name` değiştirilmeli (`@yourcorp/multi-agent-pipeline` veya `@yourname/...`), sonra grep+sed ile bu 7+ yerde otomatik replace.
-
-### Sert dış bağımlılık: `@mmerterden/dev-toolkit-mcp`
-
-```
-pipeline/commands/archive-guard.md:6:    @mmerterden/dev-toolkit-mcp ≥ v2.4
-pipeline/commands/sim-test.md:137:      @mmerterden/dev-toolkit-mcp ≥ v2.4
-pipeline/scripts/smoke-compliance-skills.sh:61: '@mmerterden/dev-toolkit-mcp'
-```
-
-Bu archive-guard (App Store audit) ve sim-test (iOS sim) skill'lerini çalıştırmak için ayrı bir mmerterden npm paketi gerekiyor. Başka şirkette:
-- **Çözüm A:** `dev-toolkit-mcp`'i fork et + rebrand et
-- **Çözüm B:** archive-guard + sim-test skill'lerini disable et / sil
-- **Çözüm C:** mmerterden'in public paketini olduğu gibi kullan (license MIT olduğu sürece OK)
-
-### Skor: 5/10 (rebrand 1-2 saat işi ama kaçınılmaz)
-
----
-
-## 5. Onboarding (setup wizard)
-
-`pipeline/commands/multi-agent/setup.md` sırayla:
-
-1. Language axis (en/tr seçim — `outputLanguage`)
-2. Credential store doctor → eksik backend var mı (Linux'ta secret-tool, Windows'ta CredentialManager module)
-3. Keychain token discovery — kullanıcının zaten kayıtlı tokenları buluyor (Jira / Bitbucket / GitHub / Confluence / Figma)
-4. Eksik tokenları guided clipboard-based save (token chat'e yazılmıyor)
-5. Git Identity onboarding (name + email; per-repo override genel config'i ezmiyor — `feedback_git_author_repo_local.md`)
-6. Jira host + corp domain (auto-derived)
-7. `defaultJiraKey` auto-learn from first task input
-
-Setup TAM cross-platform, TAM placeholder-driven. Bir başka kurumun developer'ı `npx @yourcorp/multi-agent-pipeline install` → setup → 5 dakikada hazır.
-
-### Skor: 9/10
-
----
-
-## 6. Smoke / regression gate'leri
-
-```
-pipeline/scripts/smoke-*.sh sayısı: 50+
-pipeline/scripts/pre-push-check.sh: meta gate (lint + smoke + schema + leak + output-quality + token-budget)
-```
-
-Önemli gate'ler:
-- `smoke-personal-data.sh` — leak detection (13 pattern; bu review'da 1 leak yakaladı)
-- `smoke-install-leak-gate.sh` — install edilen tree'de leak detection
-- `smoke-cross-cli-behavior.sh` — Claude vs Copilot kontrat
-- `smoke-bitbucket-contract.sh` — Bitbucket Server PR contract
-- `smoke-keychain.sh` — credential store roundtrip
-- `smoke-channels-flow.sh` — kanallar dispatch
-- `smoke-no-token-prompt.sh` (NEW, bu PR) — token prompt yasağı
-- `smoke-issue-comment-template.sh` (NEW, bu PR) — canonical issue comment template
-
-### Pre-existing failures (bu PR'la ilgili değil)
-
-`pre-push-check.sh` 3 gate fail ediyor:
-1. **lint** — 50 ESLint errors `pipeline/scripts/test-gap-scan.mjs` + `test/install-telemetry.test.mjs` içinde (last edit `94fbc01` v8.3, `f37f60b` v8.0.0)
-2. **token budget** — metrics dosyası yok (telemetri henüz emit edilmemiş)
-3. **output quality** — 2 warn, 0 fail (skip messages, gerçek fail değil)
-
-Hiçbiri bu PR'da değişen dosyalardan değil — bunlar v9 stability planının ayrı work-stream'i.
-
-### Skor: 8/10 (gate'ler güçlü ama 2 pre-existing fail temizlenmemiş)
-
----
-
-## 7. Bir başka şirkete adapte etme — somut iş listesi
-
-### Mandatory (yapılmadan çalışmaz)
-
-1. **Fork the repo** (`@mmerterden/multi-agent-pipeline` → `@yourcorp/multi-agent-pipeline`)
-2. **Rename package**: `package.json` `name` field + grep/sed:
-   ```bash
-   grep -rIn '@mmerterden/multi-agent-pipeline' pipeline/ | wc -l   # ~7 spots
-   ```
-3. **THY-spesifik örneklerin replace'i** (3 spot):
-   - `THY.xcworkspace` → `{YourApp}.xcworkspace`
-   - `TurkishAirlinesPackages` → `{YourApp}Packages`
-   - `THYFont` → `{YourBrand}Font`
-4. **dev-toolkit-mcp dependency**: archive-guard + sim-test skill'lerini ya fork+rebrand et, ya disable et, ya da mmerterden'in public paketini olduğu gibi kullan
-5. **Setup wizard çalıştır**: `npx @yourcorp/multi-agent-pipeline install --claude` → kurumun jira host'u, corp domain'i, default jira key'i, vb. öğrenilir
-
-### Recommended (stabilite için)
-
-6. **Pre-existing lint fix** — `pipeline/scripts/test-gap-scan.mjs` + `test/install-telemetry.test.mjs` ESLint clean (50 hata)
-7. **Smoke-keychain.sh cross-platform** — `/usr/bin/security` doğrudan kullanım yerine `credential-store.sh` üzerinden
-8. **audit-log-rotate.sh Linux/Windows ops doc** — launchd plist'in yanına cron + Task Scheduler örneği
-9. **CHANGELOG'a "Forking guide"** — başka şirketin nasıl fork+rebrand+deploy edeceği
-
-### Optional (good-to-have)
-
-10. **License audit** — şu an MIT; kurum kapalı kullanıyorsa license değişikliği gerekebilir
-11. **Telemetry endpoint config** — `pipeline/install/_telemetry.mjs` mmerterden tarafına opt-in metric gönderiyor mu kontrol et (gönderiyorsa kurum opt-out edebilmeli)
-12. **Reviewer routing** — Phase 4 review'a geçen modeller (Opus + Sonnet) Anthropic API key gerektiriyor; başka şirket Claude API erişimi olmadan çalıştıramaz, alternatif (OpenAI / local LLM) kontratı yok
-
----
-
-## 8. Karar matrisi
-
-| Senaryo | Pipeline kullanılabilir mi? | Notlar |
-|---|---|---|
-| Solo developer, kişisel projeler | ✅ Evet, doğrudan | mmerterden adapter'ları gizleyebilir |
-| Bir başka iOS/Android dev şirketi (KOBİ) | ✅ Evet, fork + rebrand sonrası (1-2 gün iş) | dev-toolkit-mcp opsiyonel |
-| Büyük kurumsal (banka / sigorta / vb.) | ⚠ Kısmen | License/vendor onboarding süreci, telemetry opt-out, reviewer model routing kontratı eklenmeli |
-| Open-source proje | ✅ Evet | MIT license uyumlu |
-| Web-only stack (Next.js / Vercel) | ✅ Evet | iOS/Android skill'leri kullanılmaz, web tarafı (figma-to-react ekleme) gerek |
-| Tek-developer multi-CLI | ✅ Evet | Adapter mimarisi tam buna göre |
-
----
-
-## 9. Senin GH1241 koşumun bağlamında
-
-Bu review'ın ortaya çıkardıkları **fix/stability-8-defects** PR'ı zaten kısmen kapsıyor:
-
-| Defect | Bu PR'da kapsandı mı? | Genericity sonucu |
-|---|---|---|
-| 1 — language axis | ✅ rules.md güncellendi | Cross-CLI/cross-corp impact: positive |
-| 2 — progress sync | ✅ NEW script | Genericity neutral |
-| 3 — keychain prompt | ✅ Rule 1 + smoke | Cross-platform impact: positive |
-| 4/7 — issue comment | ✅ NEW canonical template | Cross-corp impact: positive (her şirket aynı şekil) |
-| 5 — tracker detail | partial | follow-up PR |
-| 6 — ID flip | ✅ pointer warn | concurrency safety |
-| 8 — worktree independence | confirmed | follow-up smoke gate |
-| 9 — figma --dev | ✅ taskType branching | Cross-corp impact: positive |
-| **+1 — M_ERDEN3 leak** | ✅ `2805538` commit | **Bu review yakaladı**, PR'a eklendi |
-
----
-
-## 10. Tavsiyem
-
-**Bu PR (fix/stability-8-defects) merge edilmeli.** Genericity düzeyini kötüleştirmedi, aksine 1 leak'i yakalayıp düzeltti + 4 yeni smoke gate ekledi (no-token-prompt, issue-comment-template, ve takip eden v9 stability'de gelecek olanlar).
-
-Sonraki adımlar:
-1. PR review + merge → main
-2. Pre-existing 2 lint fail'ı ayrı PR'la temizle (`94fbc01` ve `f37f60b` etkilenen dosyalar)
-3. v9 stability planındaki kalan smoke gate'leri (worktree-path-convention, render-after-update, vb.) ekle
-4. THY-spesifik 3 örneği genericize et (1 saatlik commit)
-5. v9.0.0 release stratejisi (rc.1 → rc.2 → GA): mevcut v9-stability planı izle
-
-`docs/STABILITY-FIX-PLAN.md` ve bu rapor (`docs/GENERICITY-REVIEW.md`) v9 plan'ının canlı belgeleri olarak repo'da kalır — fork eden bir başka şirket önce bunları okur, sonra başlar.

package/docs/STABILITY-FIX-PLAN.md

@@ -1,168 +0,0 @@
-# Multi-Agent Pipeline — Stabilization Fix Plan
-
-> Direct response to user feedback dated 2026-05-07. Addresses 8 concrete defects observed during the GH1241 (uicomponents AirlineProgramMembershipLayout) end-to-end run.
-
-## Defect → Root Cause → Fix Map
-
-### Defect 1: outputLanguage TR ama picker question/description EN
-
-**Symptom:** User outputLanguage=tr seçili olmasına rağmen picker `question` ve `description` alanları İngilizce çıktı (örn. "Confirm the GitHub issue to work on?").
-
-**Root cause:** `refs/rules.md`'deki "Language Application" bölümü picker `label` alanlarını English zorunlu kılıyor (UI contract gereği), ama `question` ve `description`'ın `outputLanguage`'a göre yazılması gerektiği `phase-0-init.md` ve `phase-7-report.md` adımlarında her picker örneğinde tekrar belirtilmemiş. Orchestrator (model) konsolide bir kural görmediği için her seferinde label-style English üretiyor.
-
-**Fix files:**
-- `pipeline/commands/multi-agent/refs/rules.md` — Language Application bölümüne TEK MASTER TABLE: hangi alan hangi dilde.
-- `pipeline/commands/multi-agent/refs/phases/phase-0-init.md` — her picker örneğinde `question:` ve description'lar TR örnekli.
-- `pipeline/commands/multi-agent/refs/phases/phase-7-report.md` — channels picker örneği TR.
-- **NEW:** `pipeline/scripts/smoke-picker-language-axis.sh` — phase docs'ta her `AskUserQuestion` örneğinin `question` alanının TR örnekli olmasını grep'le doğrula.
-
-### Defect 2: Issue Progress flag akışı manuel yürüdü
-
-**Symptom:** `update-issue-from-registry.py` her phase finalize'de Progress table'ını yeniden yazmalıydı, ama agent elle düzenledi. #1244 ve #1246'da bile farklı paternler.
-
-**Root cause:** Script projede yok ya da pipeline tarafından invoke edilmiyor. `phase-7-report.md`'de Progress table güncelleme bölümü hiç yok. `pipeline/commands/multi-agent/refs/issue-jira-triad.md` GH issue body sözleşmesini sayar ama orchestrator çağrısı yok.
-
-**Fix files:**
-- **NEW:** `pipeline/scripts/update-issue-progress.sh` — `gh issue view --json body` → frontmatter parse → Progress table'ı `state.flags` ile yeniden yaz → `gh issue edit --body-file`. Idempotent.
-- `pipeline/commands/multi-agent/refs/phases/phase-7-report.md` — Step 5 olarak "Issue progress sync" eklensin: orchestrator phase-7'de `update-issue-progress.sh "$TASK_ID"` çalıştırsın.
-- `pipeline/commands/multi-agent/refs/phases/phase-3-dev.md` — başarılı dev sonunda `state.flags.implementation = true`, vs.
-
-### Defect 3: Keychain token bazen sorul(uy)or
-
-**Symptom:** Pipeline bazen "Figma access token gerekli, gir" gibi prompt yapıyor. Tokenlar zaten keychain'de.
-
-**Root cause:** `refs/keychain.md` mapping kontratı var ama orchestrator runtime'da her zaman okumuyor. Phase 3 / Phase 7 (figma publish, jira post, vs) farklı path'lerden token resolve ediyor; biri keychainMapping'e bakıyor, diğeri prompt'a düşüyor.
-
-**Fix files:**
-- `pipeline/lib/credential-store.sh` (varsa) — single source of truth, `get <key-alias>` her zaman keychain → env → prompt sırasıyla, prompt en son.
-- `pipeline/commands/multi-agent/refs/keychain.md` — "ASLA prompt etme, missing → setup wizard'ı aç" rule'u 1. madde.
-- **NEW:** `pipeline/scripts/smoke-no-token-prompt.sh` — pipeline kodunda hardcoded "enter token" tipi prompt yok, hep `credential-store.sh get`.
-
-### Defect 4: Channel uygulamaları tutarsız
-
-**Symptom:** #1246 yorumsuz, #1244 garip yorum, #1242 daha iyi yorum. Her run farklı şekil.
-
-**Root cause:** Comment template'i `phase-7-report.md`'de net değil; her run model kendi şekline göre yazıyor. `dev` mode'da Phase 4 review skip edildiği için report da kısaltılıyor.
-
-**Fix files:**
-- **NEW:** `pipeline/commands/multi-agent/refs/channels/issue-comment.md` — single canonical template (Geliştirme Detayı + PRs + AC Checklist + Build/Test + Sonraki adımlar + Ref).
-- `pipeline/commands/multi-agent/refs/phases/phase-7-report.md` — channels picker'da "issue comment" seçilirse adapter `issue-comment.md` template'ini render etmek zorunda.
-- `pipeline/commands/multi-agent/dev.md` — `--dev` mode'da Phase 7'nin TAM çalıştığını netleştir (zaten yazıyor ama Channel Standards atfı yok).
-
-### Defect 5: Phase tracker'da step granularity + token usage yok
-
-**Symptom:** "Phase 7: Report 21m 55s · almost done thinking" — hangi sub-step? Kaç token? Görünmüyor.
-
-**Root cause:** `phase-tracker.sh` `update <phase> in_progress` sadece phase'in started_at'ini damgalıyor. Sub-step için `sub <phaseId> <subId> <name> <status>` action'ı var (line 384'ten önce) ama phase docs'ta nadir kullanılıyor. Token tracking için `tokens <phase> <in> <out>` action'ı var ama `dev.md` ve `phase-3-dev.md` invoke etmiyor.
-
-**Fix files:**
-- `pipeline/scripts/phase-tracker.sh` — `render` çıktısına aktif sub-step ve cumulative token sayacını ekle (zaten state'te var, sadece render template).
-- `pipeline/commands/multi-agent/refs/phases/phase-3-dev.md` — her LLM call sonrası `phase-tracker.sh tokens 3 <in> <out>` zorunlu.
-- `pipeline/commands/multi-agent/refs/phases/phase-7-report.md` — Channel adapter dispatch'lerini `sub` calls ile sarmala (3.1=jira, 3.2=wiki, 3.3=confluence, vs).
-- **NEW:** `pipeline/scripts/render-phase-detail.sh` — verbose mode (`render -v`) sub-step + per-phase token + cumulative cost tablosu.
-
-### Defect 6: Pipeline ID ortada değişiyor (`gh-uic-1244-1778184051`)
-
-**Symptom:** `phase-tracker.sh init "GH1241"` ile başlattım, sonradan `render` "Pipeline: gh-uic-1244-1778184051" gösterdi.
-
-**Root cause:** `phase-tracker.sh` task_id resolution sırası: `MULTI_AGENT_TASK_ID` env → `~/.claude/logs/multi-agent/.tracker-current` pointer file → fail. Aynı kullanıcı başka bir terminal'de farklı task `init` ettiğinde pointer flip olur, mevcut session'ın `render` çağrıları o task'ı gösterir. Concurrency bug.
-
-**Fix files:**
-- `pipeline/scripts/phase-tracker.sh` — pointer fallback'i sadece `MULTI_AGENT_TASK_ID` env yoksa kullan (zaten öyle) AMA `init`'ten sonra session'ın o env'i set ettiğinden emin olmak için `init` `export MULTI_AGENT_TASK_ID=<id>` echo'su ile çıktı versin (bash dot-source compatible).
-- `pipeline/commands/multi-agent/refs/phases/phase-0-init.md` — init çağrısından SONRA orchestrator `export MULTI_AGENT_TASK_ID=<id>` yapsın (Bash tool'unda her shell yeni cwd alıyor ama env aynı kalmıyor; alternatif: her phase-tracker call'una `MULTI_AGENT_TASK_ID=<id>` prefix'i koy).
-- **TEMP fix (orchestrator hint):** Phase 0'da orchestrator'a "her tracker call'unda `MULTI_AGENT_TASK_ID=<task>` prefix" instruction.
-
-### Defect 7: Comment standardı yok
-
-Aynı kök → Defect 4 ile birlikte çözülür: `issue-comment.md` template canon.
-
-### Defect 8: Worktree bağımsızlığı (KRİTİK — şu an OK)
-
-**Symptom:** Kullanıcı tasklerin lokalde çalıştığından şüpheli.
-
-**Verification result (manual):** GH1241 koşumunda parent (`/turkish-airlines-ios-uicomponents`) `iteration/develop`'te kaldı, çalışma `.worktrees/GH1241/`'de oldu, orada feature branch açıldı. **Independence confirmed.**
-
-**Defensive fix:** `phase-0-init.md`'de `git worktree add` SONRASI `cd $WORKTREE_DIR && pwd` doğrulamasıyla orchestrator'ın geri kalan tüm phase çağrılarını absolute path'le yapmasını zorla. Mevcut `smoke-worktree-path-convention.sh` (v9 plan'da NEW olarak listelenmiş) yazılırsa bu kalıcılaşır.
-
-### Defect 9: Figma component dispatch testleri --dev mode'da skip oluyor
-
-**Symptom:** GH1241 run'unda Phase 3 figma 17-substep orchestrator yerine generic dev path izledi. ViewInspector + Snapshot + Unit testleri Phase 3.5A-C içinde otomatik yazılmadı; sonradan Phase 5 olarak dışarıdan yapıldı (yanlış yer).
-
-**Root cause:** `dev.md` "Phase 3: Dev → Brief analysis (no explore agent — read files directly), Write code + verify build, Write tests if needed (not mandatory in dev mode)" yazıyor. Bu generic kod taskı için doğru ama `taskType === "component"` (figma URL var) için figma orchestrator bypass'lanıyor. `phase-0-init.md` Step 7'de taskType yazılması zorunlu (memory ile uyumlu) AMA `dev.md` taskType'a göre dispatch yapmıyor.
-
-**Fix files:**
-- `pipeline/commands/multi-agent/dev.md` — Phase 3 bölümüne dispatch logic: `if state.taskType === "component" → figma orchestrator FULL 17-substep (5A/B/C testleri dahil); else → mevcut "brief analysis + code + optional test" path`. `--dev` flag SADECE Phase 1+2+4 skip eder; Phase 3 dispatch taskType'a tabidir.
-- `pipeline/commands/multi-agent/refs/phases/phase-3-dev.md` — taskType-based dispatch table eklensin (zaten figma-specific dispatch mevcut, sadece --dev mode'un tam çalıştığı netleştirilsin).
-- `pipeline/commands/multi-agent/refs/component-dispatch.md` — varsa, --dev mode için override yok diye onayla.
-- **NEW:** `pipeline/scripts/smoke-component-dev-fullsubphases.sh` — `dev.md` içinde `taskType === "component"` branchi figma orchestrator'a yönlendirdiğini grep'le doğrula. `--dev` mode'da figma testlerinin SKIP olmadığını assert et.
-
-**Side effect:** Phase 5 (User Test) figma component task'ında zaten optional/skipped — esas testler Phase 3.5A-C içinde. Bu "Phase 5: Test (skipped)" gösterimini yanıltıcı yapıyor; render label'ı task type'a göre adapte edilebilir ama bu Phase 5 silmek anlamına gelmez (non-component taskler için duruyor).
-
----
-
-## Implementation Order (en yüksek leverage önce)
-
-| # | Defect | File | Effort | Risk |
-|---|---|---|---|---|
-| 1 | #6 ID flip | `phase-tracker.sh` + Phase 0 doc | 30dk | low |
-| 2 | #4/#7 channel template | NEW `channels/issue-comment.md` + Phase 7 wiring | 45dk | low |
-| 3 | #2 progress sync | NEW `update-issue-progress.sh` + Phase 7 wiring | 1.5sa | medium |
-| 4 | #1 language axis | `rules.md` master table + 2 phase doc örneği | 30dk | low |
-| 5 | #5 tracker detail | `phase-tracker.sh render` enhancement + tokens enforcement | 1sa | low |
-| 6 | #3 token resolve | `keychain.md` rule 1 + smoke test | 30dk | low |
-| 7 | #8 worktree guard | smoke gate (v9 plan with smoke-worktree-path-convention) | 45dk | low |
-| 8 | #9 component dispatch | `dev.md` taskType branching + smoke gate | 1sa | medium |
-
-Total ~6.5 saat lokal iş, ayrıca smoke run + manuel doğrulama.
-
-## Out of Scope (bu fix planında yok)
-
-- Yeni Phase eklemek, scope büyütme
-- Confluence direct API integration (token + space ID gerekli, separate iş)
-- Vercel-style verification skill bu projeye uygulanmıyor — pipeline'ın kendisi başka bir bağlam
-- npm publish (kullanıcı explicit onay verdiğinde, fix smoke'lar pass'tan sonra)
-
-## Verification
-
-Her fix sonrası:
-1. `bash pipeline/scripts/pre-push-check.sh` → tüm smoke green
-2. `cd /tmp && bash $HOME/.claude/scripts/phase-tracker.sh init "TEST-FIX" && phase-tracker.sh add 0 Init && phase-tracker.sh update 0 in_progress && phase-tracker.sh render` → Pipeline ID `TEST-FIX`, başka task ID flip yok
-3. Sonraki gerçek `multi-agent:dev` run'unda issue yorumu canonical template ile eşleşsin (regex check)
-4. Progress table elle düzenlenmesin, script'le güncellensin
-
-User explicit kontrol: kullanıcı bu plan'a göre implementation review eder, doğru bulduğu fix'lere ✅ verir, yanlış olanlara redirect verir.
-
----
-
-## Defect 10 (yeni — 2026-05-08): Existing-component discovery gate yok
-
-**Symptom (kullanıcı sorusu):** "Tasarım geliştirmesi yapıyoruz; Jira/Figma URL var, MCP elinde. Önce Code Connect'e bak — mevcut component var mı? Yoksa birebir al."
-
-Bu akış şu an **yarı uygulanmış**:
-
-| Sıra | Pipeline durumu |
-|---|---|
-| 1. MCP `get_code_connect_map` çağırılıyor | ✅ Phase 1, `code_connect_map_response.json` |
-| 2. Mevcut bağlı **alt component'ler** reuse ediliyor (Textlink, Checkbox, vb.) | ✅ Phase 3c |
-| 3. **Target component'in kendisi** zaten yazılmış mı kontrolü | ❌ YOK |
-| 4. `Sources/` altında `{ComponentName}.swift` dosyası var ama `.figma.swift` yok → discovery | ❌ YOK |
-| 5. Birebir tasarım extraction (tokens, layout) | ✅ Phase 3a-h, Phase 4a-e |
-| 6. Code Connect publish | ✅ Phase 6, ama mevcut mapping check yok |
-
-**Root cause:** `phase-2-orchestrator.md` Phase 2 girişinde "greenfield generation" varsayıyor — mevcut dosya/mapping varlığını kontrol eden `existing-component-discovery` gate'i yok.
-
-**Fix files:**
-- **NEW gate:** `pipeline/skills/figma-ios/figma-to-component/phases/phase-1.5-existing-discovery.md`
-  - Step 1: `code_connect_map_response.json`'da target nodeId var mı?
-    - VAR → `STATUS: SKIP_GENERATION`, mevcut dosya path'ini kullan, sadece eksikleri (FIGMA.md / test / wiki) tamamla
-  - Step 2: Yoksa, `Sources/**/{ComponentName}.swift` glob'la dosya var mı?
-    - VAR → `STATUS: NEEDS_INPUT` 3 seçenekli: (a) dosyaya yazma, sadece `.figma.swift` ekle (b) tamamen üzerine yaz (c) iptal
-    - YOK → `STATUS: GREENFIELD_OK`, Phase 2'ye geç
-  - Step 3: agent-state'e `discovery: { status, sourcePath, gaps: [...] }` yaz
-- `phase-2-orchestrator.md` ENTRY GATE'i: `agent-state.discovery.status === "GREENFIELD_OK"` zorunlu, aksi halde halt
-- `phase-6-code-connect.md` ENTRY GATE'i: mevcut `.figma.swift` varsa skip + log "already published"
-- **NEW smoke:** `smoke-existing-discovery-gate.sh` — Phase 2 orchestrator'ın discovery state'ini check ettiğini grep'le doğrula
-
-**Effort:** 2-3 saat (gate skill yazılmalı, integration test gerekli)
-
-**Risk:** Medium — yeni bir entry gate, hatalı false-positive'de "mevcut component var" diyip greenfield'a izin vermez. Conservative fallback: bilinmiyorsa `GREENFIELD_OK` (mevcut davranış).

package/pipeline/scripts/.last-figma-sync-plan.json

@@ -1,23 +0,0 @@
-{
-  "source": { "path": "/Users/M_ERDEN3/turkish-airlines-ios-figma", "branch": "develop", "commit": "6702673562d797e5bb77364922f211a4b5d5c0ae", "lastCommit": "cd0cde2f25abbc2524f3f20407d8c0d9ff6c2245" },
-  "summary": { "changedSkills": 12 },
-  "changes": [
-    { "upstream": "figma-cli-iterate", "local": "figma-cli-iterate", "tree": "figma-common", "renamed": false, "overlaySkip": false },
-    { "upstream": "figma-cli-lean-iterate", "local": "figma-cli-lean-iterate", "tree": "figma-common", "renamed": false, "overlaySkip": false },
-    { "upstream": "figma-form-integration", "local": "figma-form-integration", "tree": "figma-common", "renamed": false, "overlaySkip": false },
-    { "upstream": "figma-issue", "local": "figma-issue", "tree": "figma-common", "renamed": false, "overlaySkip": false },
-    { "upstream": "figma-iterate", "local": "figma-iterate", "tree": "figma-common", "renamed": false, "overlaySkip": false },
-    { "upstream": "figma-iteration-commit", "local": "figma-iteration-commit", "tree": "figma-common", "renamed": false, "overlaySkip": false },
-    { "upstream": "figma-to-swift-ui-implement", "local": "figma-component-implement", "tree": "figma-ios", "renamed": true, "overlaySkip": true },
-    { "upstream": "figma-to-swift-ui-start", "local": "figma-component-start", "tree": "figma-common", "renamed": true, "overlaySkip": false },
-    { "upstream": "figma-to-swiftui", "local": "figma-to-component", "tree": "figma-ios", "renamed": true, "overlaySkip": false },
-    { "upstream": "figma-ui-patterns", "local": "figma-ui-patterns", "tree": "figma-common", "renamed": false, "overlaySkip": false },
-    { "upstream": "performance-swiftui", "local": "performance-swiftui", "tree": "figma-common", "renamed": false, "overlaySkip": false },
-    { "upstream": "performance-tour", "local": "performance-tour", "tree": "figma-common", "renamed": false, "overlaySkip": false }
-  ],
-  "postActions": [
-    "run `npm run test:smoke` — all 28 suites must stay green",
-    "review figma-ios/REVIEW_CHECKLIST.md for skills still WIP",
-    "commit with \"chore(sync): upstream @ 6702673562d797e5bb77364922f211a4b5d5c0ae\""
-  ]
-}

package/pipeline/scripts/README-figma-smokes.md

@@ -1,34 +0,0 @@
-# Figma Smoke Suite Index
-
-v6.0.0 audit flagged "figma smoke consolidation (7 → 5 suites)" as a potential improvement. On closer inspection, the six figma-prefixed smoke scripts turn out to cover **distinct, non-overlapping contracts**. Merging them would produce a single giant harness that's harder to debug ("which sub-contract failed?") without meaningfully reducing assertion surface.
-
-Instead of a forced merge, v6.0.0 documents the full family here so a new maintainer can see at a glance what each file is for, what it enforces, and why none of them are redundant.
-
-| Script | Scope | Assertions | What it enforces |
-|---|---|---|---|
-| `smoke-figma-android-parity.sh` | Android platform skills | 32 | Android tree mirrors iOS for every platform-specific skill required by the orchestrator; Kotlin/Compose-specific details (Paparazzi / Roborazzi refs, file-name conventions) |
-| `smoke-figma-config-schema.sh` | `figma-project-config.schema.json` v2.0.0 | 18 | Schema shape + `figma-config-1.0.0-to-2.0.0.mjs` migration path; v2 envelope correctness |
-| `smoke-figma-cross-cli-inventory.sh` | Cross-CLI inventory parity | 39 | Every figma skill on Claude side also ships on Copilot side — source-tree parity (complements `smoke-cross-cli-behavior.sh` installed-tree check) |
-| `smoke-figma-dispatch.sh` | Phase 3 → figma-to-component dispatch | 12 | multi-agent Phase 3 delegates to the figma orchestrator (doesn't embed figma logic inline) — verifies the WS-4 contract |
-| `smoke-figma-skill-import.sh` | iOS import transform consistency | 19 | iOS figma-ios/ tree is well-formed; placeholder-map (`figma-placeholder-map.json`) was applied without unresolved tokens; frontmatter present on every SKILL.md |
-| `smoke-figma-sync.sh` | `sync-figma-source.sh` script contract | 15 | Sync script exists + executable, handles missing `figmaSource` gracefully, enforces the `prefs.global.figmaSource` shape |
-
-**Total: 6 suites, 135 assertions** (each group's `→ N.` header-pass count summed; individual assertion count is higher — each `→` group has multiple sub-asserts).
-
-## Why these stay separate
-
-Each script tests a different contract surface:
-
-- **Schema shape** (`config-schema`) vs **tree structure** (`skill-import`, `android-parity`) vs **orchestration wire-up** (`dispatch`, `sync`) vs **inventory parity** (`cross-cli-inventory`) — merging two of these would produce an assertion file that mixes concerns and forces a future maintainer to read twice as much to understand "why did this fail".
-- **iOS-only vs Android-only vs cross-platform** — splitting by platform keeps failure messages precise. A single combined parity smoke would need to name the platform on every assertion, doubling the log noise.
-- **Pre-deploy vs post-deploy** — `smoke-figma-cross-cli-inventory.sh` checks source tree (runs before `install.js`), `smoke-cross-cli-behavior.sh` checks installed tree (runs after). Merging would collapse the distinction and make the "did install.js ship the files correctly?" question harder to answer in isolation.
-
-## When a merge would make sense
-
-If the ratio of duplicated assertions between two files ever exceeds ~40%, revisit this decision. Measure: `grep -E '^echo "→'` both files and diff the assertion labels.
-
-## See also
-
-- `smoke-cross-cli-behavior.sh` — parent cross-CLI behavior smoke (installed-tree parity)
-- `smoke-commands-skills-parity.sh` — multi-agent command ↔ dash-form skill parity (not figma-specific)
-- `pipeline/commands/multi-agent/refs/cross-cli-contract.md` § 1.1 — source of truth for the figma inventory matrix