@mmerterden/multi-agent-pipeline 20.25.1 → 20.27.0

package/pipeline/scripts/render-jira-evidence.mjs

@@ -0,0 +1,213 @@
+#!/usr/bin/env node
+/**
+ * render-jira-evidence.mjs  -  the evidence lines of a Jira comment.
+ *
+ * Screenshots and recordings are uploaded as Jira attachments
+ * (`jira-attach.sh`, which returns each file's attachment URL). This script
+ * turns `state.visualEvidence` into the lines that reference them.
+ *
+ * Links are the default. One full-size image embedded per scenario makes a
+ * comment many screens long; a link line keeps the comment readable and still
+ * opens the attachment in one click. `--mode thumbnails` embeds images as small
+ * thumbnails instead. Recordings are always links: an embedded player is the
+ * same length problem with a larger frame.
+ *
+ * An attachment without a URL is named and marked as attached, never linked to
+ * an address built by hand.
+ *
+ * Output (JSON): {summary, flow, scenarios: [{id, line}], gaps: [line]}
+ *   summary    the before/after line for the summary section, or null
+ *   flow       the flow recording line for the test scenarios section, or null
+ *   scenarios  one evidence line per scenario, placed under that scenario
+ *   gaps       one line per recorded gap, with its reason
+ *
+ * Lines are markdown; the Jira adapter's wiki conversion turns `[text](url)`
+ * into `[text|url]`. Thumbnail markup is already wiki syntax and passes through.
+ *
+ * Usage:
+ *   node render-jira-evidence.mjs --state agent-state.json [--lang tr|en] [--mode links|thumbnails]
+ *   node render-jira-evidence.mjs --measure <body file> [--limit N]
+ */
+import { readFileSync } from "node:fs";
+import { invokedDirectly } from "../lib/invoked-directly.mjs";
+
+export const DEFAULT_LIMIT = 8000;
+
+const LABELS = {
+  tr: {
+    evidence: "Kanıt",
+    before: "Önce",
+    after: "Sonra",
+    screen: "Ekran",
+    recording: "Kayıt",
+    attached: "ekte",
+    notUploaded: "yüklenmedi",
+    none: "yok",
+    video: "Kayıt",
+  },
+  en: {
+    evidence: "Evidence",
+    before: "Before",
+    after: "After",
+    screen: "Screen",
+    recording: "Recording",
+    attached: "attached",
+    notUploaded: "not uploaded",
+    none: "none",
+    video: "Recording",
+  },
+};
+
+// Jira wiki markup a free-text value could open: links, embeds, macros, tables.
+function plain(text) {
+  return String(text).replace(/[[\]()|!{}]/g, "\\$&");
+}
+
+function nameOf(item) {
+  return item?.jiraFilename || (item?.file ? String(item.file).split(/[\\/]/).pop() : null);
+}
+
+function link(item, labels) {
+  const name = nameOf(item);
+  if (!name) return null;
+  const text = name.replace(/[[\]()|]/g, "\\$&");
+  if (item.url) return `[${text}](${item.url})`;
+  return `${text} (${item.jiraFilename ? labels.attached : labels.notUploaded})`;
+}
+
+// Only an uploaded attachment can be embedded; anything else would render as a broken image.
+function thumb(item) {
+  const name = item?.jiraFilename;
+  // `!` and `|` would end the embed early; such a name is linked instead.
+  return name && !/[!|]/.test(name) ? `!${name}|thumbnail!` : null;
+}
+
+function links(items, labels) {
+  return (items || []).map((item) => link(item, labels)).filter(Boolean);
+}
+
+export function renderEvidence(visualEvidence, { lang = "tr", mode = "links" } = {}) {
+  const labels = LABELS[lang] || LABELS.en;
+  const empty = { summary: null, flow: null, scenarios: [], gaps: [] };
+  if (!visualEvidence || typeof visualEvidence !== "object") return empty;
+  const thumbnails = mode === "thumbnails";
+
+  let summary = null;
+  if (thumbnails) {
+    // An image that cannot be embedded is still named, as a link or as not uploaded.
+    const row = [...(visualEvidence.before || []), ...(visualEvidence.after || [])]
+      .map((item) => thumb(item) || link(item, labels))
+      .filter(Boolean);
+    if (row.length) summary = `${labels.before} / ${labels.after}\n${row.join(" ")}`;
+  } else {
+    const parts = [];
+    const before = links(visualEvidence.before, labels);
+    const after = links(visualEvidence.after, labels);
+    if (before.length) parts.push(`${labels.before} ${before.join(", ")}`);
+    if (after.length) parts.push(`${labels.after} ${after.join(", ")}`);
+    if (parts.length) summary = `${labels.evidence}: ${parts.join(" · ")}`;
+  }
+
+  let flow = null;
+  const video = link(visualEvidence.video, labels);
+  if (video) {
+    const tier = Number.isInteger(visualEvidence.videoTier)
+      ? ` · tier ${visualEvidence.videoTier}`
+      : "";
+    flow = `${labels.recording}: ${video}${tier}`;
+  }
+
+  const scenarios = [];
+  for (const scenario of visualEvidence.scenarios || []) {
+    const parts = [];
+    if (thumbnails && thumb(scenario.image)) parts.push(thumb(scenario.image));
+    else if (link(scenario.image, labels))
+      parts.push(`${labels.screen} ${link(scenario.image, labels)}`);
+    const recording = link(scenario.video, labels);
+    if (recording) parts.push(`${labels.recording} ${recording}`);
+    if (!parts.length) continue;
+    const line =
+      thumbnails && thumb(scenario.image)
+        ? parts.join(" · ")
+        : `${labels.evidence}: ${parts.join(" · ")}`;
+    scenarios.push({ id: scenario.id || null, line });
+  }
+
+  const gaps = (visualEvidence.gaps || [])
+    .filter((gap) => gap?.what)
+    .map((gap) => {
+      const what = Object.hasOwn(labels, gap.what) ? labels[gap.what] : plain(gap.what);
+      const label = what.charAt(0).toUpperCase() + what.slice(1);
+      return `${label}: ${labels.none}${gap.reason ? ` - ${plain(gap.reason)}` : ""}`;
+    });
+
+  return { summary, flow, scenarios, gaps };
+}
+
+/** Size of a comment body, and how many images it embeds at full size. */
+export function measureBody(body, limit = DEFAULT_LIMIT) {
+  const text = String(body);
+  const embeds = [...text.matchAll(/!([^!\n|]+)(\|[^!\n]*)?!/g)].filter(
+    ([, , params]) => !/thumbnail/i.test(params || ""),
+  );
+  const embeddedImages = embeds.filter(([, name]) =>
+    /\.(?:png|jpe?g|gif|webp)$/i.test(name),
+  ).length;
+  const embeddedVideos = embeds.filter(([, name]) => /\.(?:mp4|mov|webm)$/i.test(name)).length;
+  return { chars: text.length, limit, over: text.length > limit, embeddedImages, embeddedVideos };
+}
+
+function main(argv) {
+  const opts = {};
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (
+      !["--state", "--lang", "--mode", "--measure", "--limit"].includes(arg) ||
+      argv[i + 1] === undefined
+    ) {
+      process.stderr.write(`render-jira-evidence: unknown or incomplete argument: ${arg}\n`);
+      return 2;
+    }
+    opts[arg.slice(2)] = argv[++i];
+  }
+  const read = (path) => {
+    try {
+      return readFileSync(path, "utf-8");
+    } catch {
+      process.stderr.write(`render-jira-evidence: cannot read ${path}\n`);
+      return null;
+    }
+  };
+  if (opts.measure) {
+    const limit = opts.limit === undefined ? DEFAULT_LIMIT : Number(opts.limit);
+    if (!Number.isInteger(limit) || limit <= 0) {
+      process.stderr.write(`render-jira-evidence: --limit must be a positive integer\n`);
+      return 2;
+    }
+    const body = read(opts.measure);
+    if (body === null) return 2;
+    process.stdout.write(`${JSON.stringify(measureBody(body, limit))}\n`);
+    return 0;
+  }
+  if (!opts.state) {
+    process.stderr.write("render-jira-evidence: --state or --measure is required\n");
+    return 2;
+  }
+  const raw = read(opts.state);
+  if (raw === null) return 2;
+  let state;
+  try {
+    state = JSON.parse(raw);
+  } catch {
+    process.stderr.write(`render-jira-evidence: ${opts.state} is not JSON\n`);
+    return 2;
+  }
+  const out = renderEvidence(state.visualEvidence, {
+    lang: opts.lang || "tr",
+    mode: opts.mode || "links",
+  });
+  process.stdout.write(`${JSON.stringify(out, null, 2)}\n`);
+  return 0;
+}
+
+if (invokedDirectly(import.meta.url)) process.exit(main(process.argv.slice(2)));

package/pipeline/skills/.skill-manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-14T13:33:28Z",
+  "generatedAt": "2026-10-16T05:27:33Z",
   "skillCount": 229,
   "entries": [
     {
@@ -49,7 +49,7 @@
     },
     {
       "path": "shared/core/multi-agent-channels/SKILL.md",
-      "sha256": "03f7c648e1938f3d6d7c48d4c1c01f2bd734cdce873ec5203120b5be3ae761db"
+      "sha256": "b55e8461a1bcdc1b4b88c42e086f599fccda2a89d7f56a29ac11e5ebc12a3623"
     },
     {
       "path": "shared/core/multi-agent-complaint-analysis/SKILL.md",
@@ -57,7 +57,7 @@
     },
     {
       "path": "shared/core/multi-agent-create-jira/SKILL.md",
-      "sha256": "5aad0d841e9e5b7140bb441e07819209ca64c5b6fc209d6ad586b5fbb353e377"
+      "sha256": "15efd1a0c661f848c2afa427015cd6c31e9f6680900111a4ab1a2e34ad705e81"
     },
     {
       "path": "shared/core/multi-agent-design-check/SKILL.md",
@@ -273,7 +273,7 @@
     },
     {
       "path": "shared/core/multi-agent/SKILL.md",
-      "sha256": "b2435de3df518efb8ddf9ac89b3089449e46bf55f29220e07a3aa95dfc8cd083"
+      "sha256": "079b49a1981c63d90798089a343b7f324571c4f7cc6ad3fb757e82719c35eb0a"
     },
     {
       "path": "shared/external/accessibility-compliance-accessibility-audit/SKILL.md",
@@ -577,7 +577,7 @@
     },
     {
       "path": "shared/external/ios-localization/SKILL.md",
-      "sha256": "3ee1a34bbf6c0b77e1e9f16cb7d8bc3d10f2ba7bf6d0b48e64126afcf9dbe2b6"
+      "sha256": "eb1e0dc8f68d4d6c29af6562186060f265ce4fadad633638d18b9aee098bfe4a"
     },
     {
       "path": "shared/external/ios-module-structure/SKILL.md",

package/pipeline/skills/shared/core/multi-agent/SKILL.md

@@ -203,6 +203,11 @@ Per-project input parsing (my-ios-app / my-figma-app / generic), worktree creati
 
 **IMPORTANT**: Update `agent-state.json` at EVERY phase transition. This file is the resume source of truth.
 
+**Issue family** (Jira input, once `agent-state.json` exists): run
+`bash "$HOME/.copilot/lib/jira-family-write.sh" resolve --state "$STATE_FILE"`. It records the
+story, dev and test sub-tasks and the story format check in `state.jiraFamily`, and asks and writes nothing;
+the channels Jira step writes to them.
+
 ### Phase 1: Plan
 Two halves, one phase, one approval gate.
 

package/pipeline/skills/shared/core/multi-agent-channels/SKILL.md

@@ -2,7 +2,7 @@
 name: multi-agent-channels
 description: "Multi-channel reporter  -  Jira/Confluence/Wiki/PR description. Multi-select channels + content, humanizer pass, reviewer-preserving Bitbucket PR PUT. Phase 5 delegates to this skill; users can invoke post-hoc by Jira ID / PR URL / branch."
 user-invocable: true
-argument-hint: '<Jira-id | PR-url | #N | Jira-url> [--channels pr,jira,confluence,wiki] [--content normal,technical,test,auto-diff,note] [--message "..."] [--message-file path] [--dry-run] [--append] [--ready]'
+argument-hint: '<Jira-id | PR-url | #N | Jira-url> [--channels pr,jira,confluence,wiki] [--content normal,technical,test,auto-diff,note,test-run] [--flow-run <runId>[,<runId>...]] [--message "..."] [--message-file path] [--dry-run] [--append] [--ready]'
 metadata:
   language: en
 ---
@@ -62,6 +62,7 @@ Rendered in English (`promptLanguage` is locked to `en`).
 │   [x] Normal analiz       (Phase 1+2+4'ten  -  high-level impact + risks)
 │   [ ] Teknik analiz       (Changes · Architecture · Dependencies)
 │   [x] Test senaryoları    (Phase 1+2+4'ten)
+│   [ ] Test Koşumu (Xray)  (flow runner history.jsonl)
 │   [ ] PR diff'ten auto-gen (PR varsa diff'i summarize eder)
 │   [ ] Manuel not          (--message / --message-file)
 └───────────────────────────────────────────────────────
@@ -73,6 +74,7 @@ Rendered in English (`promptLanguage` is locked to `en`).
 - Teknik analiz unselectable if no Phase 1 planning log AND no PR diff.
 - Auto-diff unselectable if no PR found.
 - Manuel not always available.
+- Test Koşumu (Xray) unselectable when `render-flow-run.mjs --json` reports `available: false`; its `reason` is shown.
 
 ## Channel adapters
 
@@ -169,6 +171,13 @@ argv. Jira turns `:)` `(x)` `(!)` `(/)` into emoticon images, including inside
 `{{monospace}}`; an escape that has to be remembered is one that is eventually
 forgotten, and that is how the selector above shipped.
 
+**Issue family** (`state.jiraFamily` set by Phase 0): the same body goes to the development sub-task, the test scenarios to the test sub-task (or, with none, the story) and a reformat of a story outside the story format to the story. `plan` prints one grouped confirmation ("3 yazma: story açıklaması, dev yorumu, test yorumu") and any question; show every write's body from `jira-family/plan.json` as one multi-select, re-run `plan` with `--skip <deselected ids>` (or `--dev-task` / `--test-task` for a question), then `apply`. Autopilot runs both back to back and records its choices in `state.decisions[]`:
+
+```bash
+bash "$HOME/.copilot/lib/jira-family-write.sh" plan --state "$STATE_FILE" --dev-body "$F"
+bash "$HOME/.copilot/lib/jira-family-write.sh" apply --state "$STATE_FILE"
+```
+
 ### Confluence page
 
 1. Token from `keychainMapping.confluence` via `~/.copilot/lib/credential-store.sh get`  -  missing→Token Save Flow from setup skill.
@@ -220,6 +229,9 @@ forgotten, and that is how the selector above shipped.
 1. {step}
 2. **Expected:** {what should still behave as before}
 
+### Test Koşumu                     ← if "Test Koşumu (Xray)" selected
+{`render-flow-run.mjs` output, unedited: Xray Test Execution, Test Set / Plan, run, results, one row per scenario. Read-only; a key the run history does not record is never written. Full contract: `channels/test-run.md`.}
+
 ### Notes                           ← if "Manuel not" selected
 {user message}
 
@@ -257,7 +269,8 @@ Target length: < 80 lines (fits one screen). Auto-diff capped at 5 lines per sec
 | Flag | Effect |
 |------|--------|
 | `--channels pr,jira,confluence,wiki` | Non-interactive channel selection. |
-| `--content normal,test,auto-diff,note` | Non-interactive content selection. |
+| `--content normal,test,auto-diff,note,test-run` | Non-interactive content selection. |
+| `--flow-run <runId>[,<runId>...]` | Runs reported by the Test Koşumu (Xray) block; wins over `state.evidence.flowRuns[]` and discovery. |
 | `--message "..."` | Manual mode  -  user text as source. Forces `content=note`. |
 | `--message-file path` | Manual mode, long message from file. |
 | `--append` | PR description: append instead of replace. |

package/pipeline/skills/shared/core/multi-agent-create-jira/SKILL.md

@@ -44,7 +44,7 @@ A `C` section fires on: Design Reference → Figma URL; Screenshots → pasted i
 7. **Draft + clarifying questions**  -  compose summary (`{minedPrefix} {title}`, 255 trunc) + description from the type's **standard template** in Jira wiki markup (`h3.`), auto-sizing conditional sections, humanizer pass, in `outputLanguage`; body to a file for `jq -n --rawfile` (UTF-8 verbatim, `--data-binary @file`, no re-encode), passed through `node "$HOME/.claude/scripts/jira-wiki-escape.mjs"` first  -  the description field expands `:)` `(x)` `(!)` `(/)` into emoticon images. Ask ONLY genuinely unknown fields: component, epic (when usage rate is high), priority (when norm ambiguous), labels, assignee, sprint vs backlog, required customs, and any always-present section still empty (Bug Steps/Environment, or a Task/Story with no derivable Scope/AC). Never invent content the user did not supply.
 8. **Full preview + approval gate (never skipped)**  -  render the complete issue (all fields + full description + attachment plan, uploads default off). Ask: `Approve` / `Edit` (apply → re-render → re-ask, loop) / `Cancel` (nothing created). No flag or mode bypasses this gate.
 9. **Create**  -  `POST /rest/api/2/issue` with `jq -n --rawfile` payload + `curl --data-binary @file`. 400 field errors → show verbatim, re-ask those fields, re-preview.
-10. **Post-create** (each failure-isolated: warn + continue): sprint chosen → `POST /rest/agile/1.0/sprint/{id}/issue` `{"issues":["KEY"]}`; Figma → `POST /rest/api/2/issue/{KEY}/remotelink`; Swagger → `remotelink` with title "API contract"; screenshots opt-in → `POST /rest/api/2/issue/{KEY}/attachments` with `X-Atlassian-Token: no-check`.
+10. **Post-create** (each failure-isolated: warn + continue): sprint chosen → `POST /rest/agile/1.0/sprint/{id}/issue` `{"issues":["KEY"]}`; Figma and Swagger → Issue Links through `plan-remote-links.mjs` + `jira-remote-links.sh apply` (one stable global id per link, so a retry adds nothing); screenshots opt-in → `POST /rest/api/2/issue/{KEY}/attachments` with `X-Atlassian-Token: no-check`.
 11. **Report**  -  `Created {KEY}: https://{host}/browse/{KEY}` + which post-steps ran.
 
 ## Error paths

package/pipeline/skills/shared/external/ios-localization/SKILL.md

@@ -81,6 +81,11 @@ catalogs require Xcode 26, and do not tie them to iOS 17.
 - Pick stable, hand-written keys for anything reached through a symbol. A key
   derived from the English copy renames its symbol the moment someone edits
   the wording, and every call site churns.
+- When the catalog is generated from a source shared with other platforms
+  (mirrored by a sync bot, stamped "do not edit"), a new key is added upstream,
+  and only after searching that source by key and by display text: a key
+  another platform already added is reused, never duplicated. The procedure is
+  the stack toolkit's `reference/component/key-naming.md`, "Reuse before mint".
 
 ```swift
 // Localizable.xcstrings: "cart_empty" -> "Your cart is empty"