@mmerterden/multi-agent-pipeline 8.6.0

package/pipeline/scripts/fixtures/install-layout.tsv

@@ -0,0 +1,16 @@
+.claude/CLAUDE.md	1
+.claude/agents	6
+.claude/commands	70
+.claude/lib	9
+.claude/multi-agent-preferences.json	1
+.claude/rules	12
+.claude/schemas	17
+.claude/scripts	127
+.claude/settings.json	1
+.claude/skills	412
+.copilot/agents	6
+.copilot/copilot-instructions.md	1
+.copilot/lib	9
+.copilot/schemas	17
+.copilot/scripts	127
+.copilot/skills	442

package/pipeline/scripts/fixtures/test-gap-node.diff

@@ -0,0 +1,30 @@
+diff --git a/src/lib/parser.ts b/src/lib/parser.ts
+index aaaa..bbbb 100644
+--- a/src/lib/parser.ts
++++ b/src/lib/parser.ts
+@@ -10,0 +11,8 @@
++export function tokenize(input: string): string[] {
++  return input.split(/\s+/);
++}
++
++export class Parser {
++  parse(tokens: string[]): unknown { return tokens; }
++}
++
+diff --git a/src/lib/format.ts b/src/lib/format.ts
+index cccc..dddd 100644
+--- a/src/lib/format.ts
++++ b/src/lib/format.ts
+@@ -5,0 +6,2 @@
++export const formatNumber = (n: number): string => n.toFixed(2);
++
+diff --git a/src/lib/__tests__/parser.test.ts b/src/lib/__tests__/parser.test.ts
+new file mode 100644
+index 000..eeee
+--- /dev/null
++++ b/src/lib/__tests__/parser.test.ts
+@@ -0,0 +1,4 @@
++import { tokenize } from "../parser";
++test("tokenize splits whitespace", () => {
++  expect(tokenize("a b c")).toEqual(["a","b","c"]);
++});

package/pipeline/scripts/fixtures/test-gap-python.diff

@@ -0,0 +1,32 @@
+diff --git a/src/payments/processor.py b/src/payments/processor.py
+index 1111..2222 100644
+--- a/src/payments/processor.py
++++ b/src/payments/processor.py
+@@ -10,0 +11,8 @@ class Processor:
++    def charge(self, amount, currency):
++        if amount <= 0:
++            raise ValueError("amount must be positive")
++        return self._gateway.charge(amount, currency)
++
++async def refund(transaction_id):
++    return await api.refund(transaction_id)
++
+diff --git a/src/payments/utils.py b/src/payments/utils.py
+index 3333..4444 100644
+--- a/src/payments/utils.py
++++ b/src/payments/utils.py
+@@ -5,0 +6,3 @@
++def normalize_currency(code):
++    return code.upper().strip()
++
+diff --git a/tests/test_processor.py b/tests/test_processor.py
+new file mode 100644
+index 000..5555
+--- /dev/null
++++ b/tests/test_processor.py
+@@ -0,0 +1,5 @@
++import pytest
++
++def test_charge_positive_amount():
++    p = Processor()
++    assert p.charge(10, "USD") is not None

package/pipeline/scripts/gen-mode-dispatch.mjs

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+/**
+ * gen-mode-dispatch.mjs — emit the canonical Phase Tracker Contract block
+ * for a given mode dispatch file (dev / dev-local / autopilot / local / etc).
+ *
+ * v8.0.0 introduced this generator as the single source of truth for the
+ * "## Required: Phase Tracker Contract" section embedded in every mode
+ * dispatch file under pipeline/commands/multi-agent/. Each mode declares its
+ * own phase list (full / fast / local), but the tracker call shape, render
+ * call, anti-pattern warning, and ref link are identical.
+ *
+ * Usage:
+ *   node pipeline/scripts/gen-mode-dispatch.mjs --mode=dev          # 0/3/5/6/7 (User Test kept — autopilot/local variants skip 5)
+ *   node pipeline/scripts/gen-mode-dispatch.mjs --mode=full         # 0..7
+ *   node pipeline/scripts/gen-mode-dispatch.mjs --mode=full-local   # 0..7
+ *   node pipeline/scripts/gen-mode-dispatch.mjs --mode=dev-local    # 0/3/6/7 + local-mode caveat
+ *
+ * Companion smoke `smoke-mode-dispatch-drift.sh` regenerates the section for
+ * each mode file, diffs against the on-disk content, and fails on drift.
+ */
+
+const args = Object.fromEntries(
+  process.argv.slice(2).map((a) => {
+    const [k, v] = a.replace(/^--/, "").split("=");
+    return [k, v ?? "true"];
+  }),
+);
+
+const MODE = args.mode ?? "dev";
+
+const PHASE_NAMES = [
+  "0:Init",
+  "1:Analysis",
+  "2:Planning",
+  "3:Dev",
+  "4:Review",
+  "5:Test",
+  "6:Commit",
+  "7:Report",
+];
+
+/**
+ * Mode → phases + flag descriptor. The descriptor controls the autopilot /
+ * local caveat banners. Each mode dispatch file under
+ * pipeline/commands/multi-agent/ maps 1-to-1 to a key here, so the smoke
+ * `smoke-mode-dispatch-drift.sh` can byte-equal-diff each on-disk section
+ * against its generator output.
+ */
+const MODES = {
+  dev:                    { phases: ["0:Init", "3:Dev", "5:Test", "6:Commit", "7:Report"], local: false, autopilot: false },
+  "dev-autopilot":        { phases: ["0:Init", "3:Dev", "6:Commit", "7:Report"], local: false, autopilot: true  },
+  "dev-local":            { phases: ["0:Init", "3:Dev", "6:Commit", "7:Report"], local: true,  autopilot: false },
+  "dev-local-autopilot":  { phases: ["0:Init", "3:Dev", "6:Commit", "7:Report"], local: true,  autopilot: true  },
+  autopilot:              { phases: PHASE_NAMES, local: false, autopilot: true  },
+  full:                   { phases: PHASE_NAMES, local: false, autopilot: false },
+  local:                  { phases: PHASE_NAMES, local: true,  autopilot: false },
+  "local-autopilot":      { phases: PHASE_NAMES, local: true,  autopilot: true  },
+  "full-local":           { phases: PHASE_NAMES, local: true,  autopilot: false },
+};
+
+const spec = MODES[MODE];
+if (!spec) {
+  console.error(`unknown mode: ${MODE}`);
+  console.error(`accepted: ${Object.keys(MODES).join(", ")}`);
+  process.exit(2);
+}
+
+const phaseLoop = spec.phases.map((p) => `"${p}"`).join(" ");
+
+const ALL_PHASE_IDS = PHASE_NAMES.map((p) => p.split(":")[0]);
+const activeIds = spec.phases.map((p) => p.split(":")[0]);
+const skippedIds = ALL_PHASE_IDS.filter((id) => !activeIds.includes(id));
+const phaseSequence = activeIds.map((id) => `Phase ${id}`).join(" → ");
+
+// Mode label for prose — how to refer to the mode in the TaskCreate paragraph.
+const MODE_LABELS = {
+  "dev":                  "`--dev`",
+  "dev-autopilot":        "`--dev autopilot`",
+  "dev-local":            "`--dev local`",
+  "dev-local-autopilot":  "`--dev local autopilot`",
+  "autopilot":            "`autopilot`",
+  "full":                 "full-pipeline",
+  "local":                "`--local`",
+  "local-autopilot":      "`--local autopilot`",
+  "full-local":           "full-pipeline + `--local`",
+};
+const modeLabel = MODE_LABELS[MODE] ?? `\`${MODE}\``;
+
+// Prose for the skip-set + ordering paragraphs.
+const skipNote = skippedIds.length > 0
+  ? `${modeLabel} mode does NOT TaskCreate phases ${skippedIds.join("/")} — those are not part of the ${modeLabel} phase set (\`${spec.phases.join(" ")}\`). Only register tiles for the active set.`
+  : `${modeLabel} mode TaskCreates all 8 phases (no phase is skipped).`;
+
+const orderingNote = `**All TaskCreate calls fire in strict phase-number order BEFORE any TaskUpdate is applied.** For ${modeLabel} that means: ${phaseSequence}. The native widget renders by creation order, not by phase number — out-of-order calls produce visually scrambled tile stacks. Full ordering contract in \`refs/tracker-contract.md\` § "TaskCreate ordering (strict)".`;
+
+const localCaveat = spec.local
+  ? `\n> **Local mode:** no worktree is created, work happens on the current branch. Phase 0 Init still calls \`init\` — the \`--local\` flag is stored in tracker-state.json, and \`:resume\` restores the correct CWD.\n`
+  : "";
+
+const banner = spec.autopilot
+  ? `\n> **Autopilot mode:** user confirmations are skipped. The tracker is still mandatory — autopilot agent calls cannot skip it; skipping breaks \`smoke-tracker-contract.sh\`.\n`
+  : "";
+
+const out = `## Required: Phase Tracker Contract
+
+**The phase tracker is mandatory** — the agent cannot skip it. Full spec: [\`refs/tracker-contract.md\`](./refs/tracker-contract.md).
+${banner}${localCaveat}
+Two channels run in parallel at every phase boundary:
+
+1. **State channel** (every CLI, identical): \`phase-tracker.sh\` writes to \`tracker-state.json\`. Drives \`:resume\`, \`:log\`, \`:status\`.
+2. **Visual channel** (CLI-specific): native widget on Claude Code, ANSI render on every other CLI. Without it the user sees no phase progress.
+
+\`\`\`bash
+# Phase 0, very first shell call (every CLI):
+bash $HOME/.claude/scripts/phase-tracker.sh init "$TASK_ID"
+for p in ${phaseLoop}; do
+  bash $HOME/.claude/scripts/phase-tracker.sh add "\${p%%:*}" "\${p#*:}"
+done
+bash $HOME/.claude/scripts/phase-tracker.sh update 0 in_progress
+
+# Every phase boundary (every CLI):
+bash $HOME/.claude/scripts/phase-tracker.sh update <N> in_progress|completed|failed|skipped
+
+# After every LLM call (every CLI):
+bash $HOME/.claude/scripts/phase-tracker.sh tokens <N> <in> <out>
+\`\`\`
+
+### Visual channel — Claude Code (native TaskList widget, required)
+
+In Claude Code the agent MUST also drive the native TaskList widget so the user sees a sticky phase tile stack — this is the only progress signal Claude Code surfaces. Skipping these calls is the #1 source of "I don't see any phases" complaints.
+
+**TaskCreate ordering (strict)**: All TaskCreate calls fire in strict phase-number order BEFORE any TaskUpdate is applied. The native widget renders by creation order, not by phase number — out-of-order calls produce visually scrambled tile stacks (e.g. \`1 ✓ · 2 ✓ · 4 ✓ · 0 ▶ · 3 ☐\`) even when the underlying state is correct. Pre-marking phases as completed/skipped before Phase 0 starts is FORBIDDEN — register the tile in order, then flip status via TaskUpdate when the phase actually short-circuits. Full contract in \`refs/tracker-contract.md\` § "TaskCreate ordering (strict)".
+
+\`\`\`text
+# Phase 0 startup — register one tile per phase (0..N), capture the taskId, persist it:
+for each phase in ${spec.phases.join(", ")}:
+  TaskCreate({ subject: "Phase <N>: <Name>", activeForm: "<doing-form>" })
+    -> returns taskId
+  bash $HOME/.claude/scripts/phase-tracker.sh meta <N> tasklist_id "<taskId>"
+
+# Phase entry — flip the tile to in_progress alongside the state update:
+TaskUpdate({ taskId: <saved>, status: "in_progress" })
+bash $HOME/.claude/scripts/phase-tracker.sh update <N> in_progress
+
+# Active sub-step inside a phase — update activeForm so the spinner header reflects what's happening now:
+TaskUpdate({ taskId: <saved>, activeForm: "Editing TopBarView.swift" })
+
+# Phase exit — flip to completed/failed/skipped on both channels:
+TaskUpdate({ taskId: <saved>, status: "completed" })
+bash $HOME/.claude/scripts/phase-tracker.sh update <N> completed
+\`\`\`
+
+${skipNote}
+
+#### TaskCreate ordering (strict)
+
+${orderingNote}
+
+### Visual channel — Copilot CLI / Cursor / Windsurf / plain shell
+
+These CLIs have no TaskList widget. After every state change the agent calls render, which prints a bordered ANSI card as the last tool result so the user sees an updated phase table:
+
+\`\`\`bash
+bash $HOME/.claude/scripts/phase-tracker.sh render
+\`\`\`
+
+Do NOT call TaskCreate on these CLIs — the tool does not exist and the call fails.
+`;
+
+process.stdout.write(out);

package/pipeline/scripts/gen-skills-index.mjs

@@ -0,0 +1,90 @@
+import { readdirSync, readFileSync, writeFileSync, existsSync } from "fs";
+import { join } from "path";
+
+// The skill tree was reorganised under `core/` (pipeline-critical multi-agent
+// skills) and `external/` (imported third-party guidance) in v5.3.3. The
+// generator must walk both subtrees rather than the flat `shared/` directory.
+const SKILLS_ROOT = new URL("../skills/shared", import.meta.url).pathname;
+const GROUPS = ["core", "external"];
+
+function listSkillsIn(group) {
+  const dir = join(SKILLS_ROOT, group);
+  if (!existsSync(dir)) return [];
+  return readdirSync(dir, { withFileTypes: true })
+    .filter((d) => d.isDirectory())
+    .map((d) => ({ name: d.name, group, dir: join(dir, d.name) }))
+    .sort((a, b) => a.name.localeCompare(b.name));
+}
+
+function parseFrontmatter(md) {
+  const m = md.match(/^---\n([\s\S]*?)\n---/);
+  if (!m) return {};
+  const out = {};
+  for (const line of m[1].split("\n")) {
+    const kv = line.match(/^([a-zA-Z-]+):\s*(.+)$/);
+    if (kv) out[kv[1]] = kv[2].replace(/^["']|["']$/g, "");
+  }
+  return out;
+}
+
+function categorize(name) {
+  if (name.startsWith("multi-agent") || name === "apple-archive-compliance" || name === "google-play-compliance") return "pipeline";
+  if (/^(swift|swiftui|swiftdata|ios|storekit|healthkit|mapkit|callkit|weatherkit|musickit|passkit|pencilkit|realitykit|cloudkit|apple-on-device-ai|permissionkit|metrickit|homekit-matter|coreml|core-bluetooth|core-motion|core-nfc|speech-recognition|natural-language|vision-framework|contacts-framework|eventkit|energykit|shareplay|background-processing|live-activities|push-notifications|tipkit|widgetkit|authentication|app-clips|app-intents|app-store|alarmkit|macos-|hig-|photos-camera|accessibility-compliance|firebase|device-integrity)/.test(name)) return "ios";
+  if (/^(android|compose|gradle|kotlin|retrofit|room|play-store)/.test(name)) return "android";
+  if (/^(react|nextjs|vue|tailwind|css|html|typescript|web-|figma)/.test(name)) return "web";
+  if (/^(fastapi|nodejs|python|docker|rest-api|api-|database|testing-backend|observability|monorepo)/.test(name)) return "backend";
+  return "misc";
+}
+
+const all = GROUPS.flatMap(listSkillsIn);
+const counts = Object.fromEntries(GROUPS.map((g) => [g, all.filter((s) => s.group === g).length]));
+
+const buckets = { pipeline: [], ios: [], android: [], web: [], backend: [], misc: [] };
+for (const skill of all) {
+  const skillFile = join(skill.dir, "SKILL.md");
+  if (!existsSync(skillFile)) continue;
+  const fm = parseFrontmatter(readFileSync(skillFile, "utf-8"));
+  const desc = (fm.description || "").slice(0, 140);
+  buckets[categorize(skill.name)].push({ name: skill.name, group: skill.group, desc });
+}
+
+const titles = {
+  pipeline: "Pipeline Orchestration",
+  ios: "iOS / Apple Ecosystem",
+  android: "Android / Kotlin",
+  web: "Web / Frontend",
+  backend: "Backend / API",
+  misc: "Cross-cutting",
+};
+const order = ["pipeline", "ios", "android", "web", "backend", "misc"];
+
+const total = all.length;
+const breakdown = GROUPS.map((g) => `${counts[g]} ${g}`).join(" + ");
+
+let md = `# Shared Skills Index\n\n`;
+md += `Single source of truth for skills delivered to both Claude Code (\`~/.claude/skills/\`) and Copilot CLI (\`~/.copilot/skills/\`) by the installer.\n\n`;
+md += `**Total:** ${total} skills (${breakdown}). Auto-generated by \`scripts/gen-skills-index.mjs\` — do not edit by hand.\n\n`;
+md += `## Directory layout\n\n`;
+md += `- **\`core/\`** — ${counts.core} \`multi-agent*\` orchestration skills that are pipeline-critical. Edits here are core-code changes.\n`;
+md += `- **\`external/\`** — ${counts.external} iOS / Android / generic skills imported from the upstream skill library. Mirrors of third-party guidance.\n`;
+md += `- Install destination stays flat: both trees flatten into \`~/.claude/skills/\` and \`~/.copilot/skills/\`. See ADR-0006 for the rationale.\n\n`;
+md += `Source layout is logical grouping only — skill discovery at runtime is unchanged.\n\n`;
+md += `## Categories\n\n`;
+for (const k of order) {
+  md += `- [${titles[k]}](#${titles[k].toLowerCase().replace(/[^a-z0-9]+/g, "-")}) — ${buckets[k].length}\n`;
+}
+md += `\n`;
+for (const k of order) {
+  if (buckets[k].length === 0) continue;
+  md += `## ${titles[k]}\n\n`;
+  md += `| Skill | Group | Description |\n|-------|-------|-------------|\n`;
+  for (const { name, group, desc } of buckets[k]) {
+    const safeDesc = desc.replace(/\|/g, "\\|").replace(/\n/g, " ");
+    md += `| [\`${name}\`](./${group}/${name}/) | \`${group}\` | ${safeDesc || "—"} |\n`;
+  }
+  md += `\n`;
+}
+
+writeFileSync(join(SKILLS_ROOT, "README.md"), md);
+const filledCategories = Object.values(buckets).filter((b) => b.length).length;
+console.log(`wrote ${total} skills (${breakdown}) across ${filledCategories} categories`);

package/pipeline/scripts/github-ssh-setup.sh

@@ -0,0 +1,103 @@
+#!/bin/bash
+# GitHub SSH Key Oluşturma ve Kurulum Scripti
+
+set -euo pipefail
+
+echo "=== GitHub SSH Key Kurulumu ==="
+echo ""
+
+# E-posta adresi al
+read -p "GitHub e-posta adresinizi girin: " EMAIL
+
+if [ -z "$EMAIL" ]; then
+    echo "Hata: E-posta adresi boş olamaz."
+    exit 1
+fi
+
+# Key dosya adı
+KEY_NAME="id_ed25519_github"
+KEY_PATH="$HOME/.ssh/$KEY_NAME"
+
+# .ssh klasörü yoksa oluştur
+mkdir -p "$HOME/.ssh"
+chmod 700 "$HOME/.ssh"
+
+# Mevcut key kontrolü
+if [ -f "$KEY_PATH" ]; then
+    echo ""
+    echo "Uyari: $KEY_PATH zaten mevcut."
+    read -p "Üzerine yazmak istiyor musunuz? (e/h): " OVERWRITE
+    if [ "$OVERWRITE" != "e" ]; then
+        echo "İşlem iptal edildi."
+        exit 0
+    fi
+fi
+
+# SSH key oluştur (Ed25519 - modern ve güvenli)
+echo ""
+echo "SSH key oluşturuluyor..."
+ssh-keygen -t ed25519 -C "$EMAIL" -f "$KEY_PATH" -N ""
+
+echo ""
+echo "SSH key başarıyla oluşturuldu!"
+
+# SSH agent'a ekle
+eval "$(ssh-agent -s)" > /dev/null 2>&1
+
+# macOS Keychain entegrasyonu için SSH config ayarla
+SSH_CONFIG="$HOME/.ssh/config"
+if ! grep -q "github.com" "$SSH_CONFIG" 2>/dev/null; then
+    cat >> "$SSH_CONFIG" <<EOF
+
+Host github.com
+    HostName github.com
+    User git
+    IdentityFile $KEY_PATH
+    AddKeysToAgent yes
+    UseKeychain yes
+EOF
+    chmod 600 "$SSH_CONFIG"
+    echo "SSH config güncellendi."
+fi
+
+# Key'i agent'a ekle (macOS Keychain ile)
+ssh-add --apple-use-keychain "$KEY_PATH" 2>/dev/null || ssh-add "$KEY_PATH"
+
+# Public key'i göster ve kopyala
+echo ""
+echo "================================================"
+echo "  Public key'iniz (aşağıdaki GitHub'a eklenecek):"
+echo "================================================"
+echo ""
+cat "${KEY_PATH}.pub"
+echo ""
+
+# Panoya kopyala
+if command -v pbcopy >/dev/null 2>&1; then
+  pbcopy < "${KEY_PATH}.pub"
+  echo "[Otomatik olarak panoya kopyalandı!]"
+elif command -v xclip >/dev/null 2>&1; then
+  xclip -selection clipboard < "${KEY_PATH}.pub"
+  echo "[Otomatik olarak panoya kopyalandı! (xclip)]"
+else
+  echo "[Panoya kopyalanamadı — yukarıdaki anahtarı manuel kopyalayın]"
+fi
+
+echo ""
+echo "=== Sonraki Adımlar ==="
+echo "1. https://github.com/settings/ssh/new adresine gidin"
+echo "2. 'Title' alanına bir isim verin (ör: MacBook)"
+echo "3. 'Key' alanına kopyalanan key'i yapıştırın (Cmd+V)"
+echo "4. 'Add SSH key' butonuna tıklayın"
+echo ""
+
+# GitHub'a key eklendikten sonra test
+read -p "Key'i GitHub'a ekledikten sonra test etmek ister misiniz? (e/h): " TEST
+if [ "$TEST" = "e" ]; then
+    echo ""
+    echo "GitHub bağlantısı test ediliyor..."
+    ssh -T git@github.com 2>&1 || true
+fi
+
+echo ""
+echo "Tamamlandı!"