@link-assistant/hive-mind 2.7.4 → 2.8.0

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # @link-assistant/hive-mind
 
+## 2.8.0
+
+### Minor Changes
+
+- 8d02cf6: feat(fix): add `/fix --ci-cd <repository>` command (#1733)
+
+  `/fix --ci-cd` automatically generates and solves a CI/CD remediation issue for
+  a target repository:
+
+  - detects the repository's languages via the GitHub `/languages` API and selects
+    the matching CI/CD templates, ordered by detected language (byte-weighted);
+  - inspects the latest default-branch commit and lists its CI/CD runs in the issue
+    (falling back to the most recent default-branch runs when a release/tag commit
+    has none of its own);
+  - creates the remediation issue reusing the title and description of the standard
+    prompt (web-capture#139), with its retired case-study paragraph permanently
+    replaced by `--development-log` and the paragraphs supplied by `--deep-analysis`
+    omitted when that option is enabled. The issue is created as type `Bug`
+    (best-effort, since issue types are org-scoped) because that is what makes the
+    deep-analysis omission valid, and links to `docs/CI-CD-BEST-PRACTICES.md`;
+  - hands the issue off to `/solve --development-log --deep-analysis --auto-merge`,
+    forwarding every option `/fix` does not consume itself (e.g. `--tool`,
+    `--model`, `--think`);
+  - supports `--dry-run` (preview the issue) and `--no-solve` (create only).
+
+  The command is also available from the Telegram bot as `/fix <repository>`
+  (`--ci-cd` is implied), toggleable with `--no-fix` / `TELEGRAM_FIX=false` and
+  documented in all four locales.
+
+  Also adds the PHP template
+  (`link-foundation/php-ai-driven-development-pipeline-template`) to
+  `docs/CI-CD-BEST-PRACTICES.md` and documents the new "Automatic CI/CD
+  Remediation" flow in all four languages (en/zh/hi/ru).
+
 ## 2.7.4
 
 ### Patch Changes

package/README.hi.md

@@ -532,6 +532,28 @@ message पर `/merge` से reply भी कर सकते हैं जि
 mergeable होने तक wait करता है। Merge-conflict skips अभी भी `--auto-resolve` के
 साथ काम करते हैं।
 
+#### `/fix` - CI/CD स्वतः ठीक करें
+
+```
+/fix <github-repository-url> --ci-cd [options]
+
+Examples:
+/fix https://github.com/owner/repo --ci-cd
+/fix owner/repo --ci-cd --tool codex --model gpt-5.5 --think max
+/fix owner/repo --ci-cd --dry-run
+/fix owner/repo --ci-cd --no-solve
+```
+
+`/fix --ci-cd` लक्ष्य रिपॉज़िटरी की भाषाओं का पता लगाता है, डिफ़ॉल्ट ब्रांच के नवीनतम कमिट और उसके CI/CD रनों
+की जाँच करता है, और स्वचालित रूप से एक CI/CD सुधार issue बनाता है (मानक प्रॉम्प्ट और
+[`docs/CI-CD-BEST-PRACTICES.md`](docs/CI-CD-BEST-PRACTICES.md) के टेम्पलेट्स का उपयोग करके, जिन्हें पहचानी
+गई भाषाओं के अनुसार क्रमबद्ध किया जाता है)। इसके बाद यह issue को
+`/solve --development-log --deep-analysis --auto-merge` को सौंप देता है। हर वह विकल्प जिसे `/fix` स्वयं
+उपयोग नहीं करता (जैसे `--tool`, `--model`, `--think`) `/solve` को अग्रेषित कर दिया जाता है। issue बनाए बिना
+उसका पूर्वावलोकन करने के लिए `--dry-run` का उपयोग करें, या `/solve` शुरू किए बिना केवल issue बनाने के लिए
+`--no-solve` का उपयोग करें। विवरण के लिए
+[स्वचालित CI/CD सुधार](docs/CI-CD-BEST-PRACTICES.md#automatic-cicd-remediation) देखें।
+
 #### `/limits` - उपयोग सीमाएँ दिखाएँ
 
 ```

package/README.md

@@ -551,6 +551,30 @@ request link, such as a previous `/codex ...issues/123` command.
 If a target PR is not finished yet, `/merge` waits for it to become mergeable
 before merging. Merge-conflict skips still work with `--auto-resolve`.
 
+#### `/fix` - Auto-Remediate CI/CD
+
+```
+/fix <github-repository-url> --ci-cd [options]
+
+Examples:
+/fix https://github.com/owner/repo --ci-cd
+/fix owner/repo --ci-cd --tool codex --model gpt-5.5 --think max
+/fix owner/repo --ci-cd --dry-run
+/fix owner/repo --ci-cd --no-solve
+```
+
+`/fix --ci-cd` detects the target repository's languages, inspects the latest
+default-branch commit and its CI/CD runs, and automatically creates a CI/CD
+remediation issue (using the standard prompt and the templates from
+[`docs/CI-CD-BEST-PRACTICES.md`](docs/CI-CD-BEST-PRACTICES.md), sorted by the
+detected languages). It then hands the issue off to
+`/solve --development-log --deep-analysis --auto-merge`. Every option `/fix`
+does not consume itself (e.g. `--tool`, `--model`, `--think`) is forwarded to
+`/solve`. Use `--dry-run` to preview the issue without creating it, or
+`--no-solve` to create the issue without starting `/solve`. See
+[Automatic CI/CD Remediation](docs/CI-CD-BEST-PRACTICES.md#automatic-cicd-remediation)
+for details.
+
 #### `/limits` - Show Usage Limits
 
 ```

package/README.ru.md

@@ -533,6 +533,27 @@ pull request, например на предыдущую команду `/codex
 выполняет слияние. Пропуск конфликтов слияния по-прежнему работает с
 `--auto-resolve`.
 
+#### `/fix` — Автоматическое исправление CI/CD
+
+```
+/fix <github-repository-url> --ci-cd [options]
+
+Examples:
+/fix https://github.com/owner/repo --ci-cd
+/fix owner/repo --ci-cd --tool codex --model gpt-5.5 --think max
+/fix owner/repo --ci-cd --dry-run
+/fix owner/repo --ci-cd --no-solve
+```
+
+`/fix --ci-cd` определяет языки целевого репозитория, анализирует последний коммит ветки по умолчанию и его
+запуски CI/CD и автоматически создаёт issue для исправления CI/CD (используя стандартный промпт и шаблоны из
+[`docs/CI-CD-BEST-PRACTICES.md`](docs/CI-CD-BEST-PRACTICES.md), отсортированные по обнаруженным языкам). Затем
+он передаёт issue в `/solve --development-log --deep-analysis --auto-merge`. Любая опция, которую `/fix` не
+использует сам (например, `--tool`, `--model`, `--think`), передаётся в `/solve`. Используйте `--dry-run`,
+чтобы предварительно просмотреть issue без его создания, или `--no-solve`, чтобы создать issue без запуска
+`/solve`. Подробнее см.
+[Автоматическое исправление CI/CD](docs/CI-CD-BEST-PRACTICES.md#automatic-cicd-remediation).
+
 #### `/limits` — Показать лимиты использования
 
 ```

package/README.zh.md

@@ -528,6 +528,26 @@ Examples:
 如果目标 PR 尚未完成，`/merge` 会等待它变为可合并后再合并。合并冲突跳过仍可配合
 `--auto-resolve` 使用。
 
+#### `/fix` - 自动修复 CI/CD
+
+```
+/fix <github-repository-url> --ci-cd [options]
+
+Examples:
+/fix https://github.com/owner/repo --ci-cd
+/fix owner/repo --ci-cd --tool codex --model gpt-5.5 --think max
+/fix owner/repo --ci-cd --dry-run
+/fix owner/repo --ci-cd --no-solve
+```
+
+`/fix --ci-cd` 会检测目标仓库使用的语言，检查默认分支的最新提交及其 CI/CD 运行情况，并自动创建一个 CI/CD
+修复 issue（使用标准提示词，以及来自
+[`docs/CI-CD-BEST-PRACTICES.md`](docs/CI-CD-BEST-PRACTICES.md) 的模板，按检测到的语言排序）。随后它会将该
+issue 交给 `/solve --development-log --deep-analysis --auto-merge` 处理。所有 `/fix`
+自身不消费的选项（例如 `--tool`、`--model`、`--think`）都会转发给 `/solve`。使用 `--dry-run` 可在不创建
+issue 的情况下预览，使用 `--no-solve` 可只创建 issue 而不启动 `/solve`。详见
+[自动 CI/CD 修复](docs/CI-CD-BEST-PRACTICES.md#automatic-cicd-remediation)。
+
 #### `/limits` - 显示用量限制
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "2.7.4",
+  "version": "2.8.0",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",
@@ -8,6 +8,7 @@
     "hive": "./src/hive.mjs",
     "solve": "./src/solve.mjs",
     "task": "./src/task.mjs",
+    "fix": "./src/fix.mjs",
     "hive-cleanup": "./src/cleanup.mjs",
     "review": "./src/review.mjs",
     "configure-claude": "./src/configure-claude.mjs",
@@ -28,7 +29,7 @@
     "changeset": "changeset",
     "changeset:version": "changeset version",
     "changeset:publish": "npm run build:pre && changeset publish",
-    "build:pre": "chmod +x src/hive.mjs && chmod +x src/solve.mjs && chmod +x src/configure-claude.mjs && chmod +x src/hive-screens.mjs",
+    "build:pre": "chmod +x src/hive.mjs && chmod +x src/solve.mjs && chmod +x src/fix.mjs && chmod +x src/configure-claude.mjs && chmod +x src/hive-screens.mjs",
     "prepare": "husky"
   },
   "repository": {

package/src/fix.ci-cd.lib.mjs

@@ -0,0 +1,480 @@
+/**
+ * Pure helpers for the `/fix --ci-cd` command (issue #1733).
+ *
+ * `/fix --ci-cd <repository>` automatically:
+ *   1. detects the languages used in the target repository,
+ *   2. inspects the latest default-branch commit and its CI/CD runs,
+ *   3. creates a remediation issue (mirroring the `/task` issue-creation flow)
+ *      that links the language-appropriate CI/CD pipeline templates and the
+ *      CI/CD best-practices guide, and
+ *   4. hands the issue off to
+ *      `/solve --development-log --deep-analysis --auto-merge`, forwarding every
+ *      option that `/fix` itself does not consume (e.g. --tool, --model,
+ *      --think).
+ *
+ * The issue title and body are taken from the standard prompt in
+ * https://github.com/link-assistant/web-capture/issues/139, omitting the
+ * its retired case-study paragraph in favor of `--development-log` and omitting
+ * paragraphs that `--deep-analysis` already injects into the AI prompt (issue
+ * #1733) — see `buildStandardPromptParagraphs` below.
+ *
+ * Everything that does not touch the network or the filesystem lives here so it
+ * can be unit-tested without GitHub access.
+ */
+
+import { KEEP_WORKING_PROMPT } from './solve.keep-working.detect.lib.mjs';
+
+/**
+ * Canonical mapping from GitHub Linguist language names to the
+ * link-foundation AI-driven-development pipeline templates.
+ *
+ * Order in this array is the stable tie-breaker when two languages contribute
+ * an equal number of bytes. The PHP template was added per issue #1733.
+ */
+export const CI_CD_TEMPLATES = Object.freeze([
+  {
+    key: 'javascript',
+    label: 'JavaScript / TypeScript',
+    languages: ['JavaScript', 'TypeScript'],
+    repo: 'link-foundation/js-ai-driven-development-pipeline-template',
+  },
+  {
+    key: 'rust',
+    label: 'Rust',
+    languages: ['Rust'],
+    repo: 'link-foundation/rust-ai-driven-development-pipeline-template',
+  },
+  {
+    key: 'python',
+    label: 'Python',
+    languages: ['Python'],
+    repo: 'link-foundation/python-ai-driven-development-pipeline-template',
+  },
+  {
+    key: 'go',
+    label: 'Go',
+    languages: ['Go'],
+    repo: 'link-foundation/go-ai-driven-development-pipeline-template',
+  },
+  {
+    key: 'csharp',
+    label: 'C#',
+    languages: ['C#'],
+    repo: 'link-foundation/csharp-ai-driven-development-pipeline-template',
+  },
+  {
+    key: 'java',
+    label: 'Java',
+    languages: ['Java'],
+    repo: 'link-foundation/java-ai-driven-development-pipeline-template',
+  },
+  {
+    key: 'php',
+    label: 'PHP',
+    languages: ['PHP'],
+    repo: 'link-foundation/php-ai-driven-development-pipeline-template',
+  },
+]);
+
+export const CI_CD_BEST_PRACTICES_URL = 'https://github.com/link-assistant/hive-mind/blob/main/docs/CI-CD-BEST-PRACTICES.md';
+
+/** Build a browser URL for a `owner/repo` slug. */
+export function templateUrl(repo) {
+  return `https://github.com/${repo}`;
+}
+
+/**
+ * Parse a `/fix` repository argument into a normalized descriptor.
+ * Returns null when the value is not a GitHub repository URL/shorthand.
+ *
+ * Self-contained on purpose: keeping this module free of the heavy
+ * `github.lib.mjs` import chain lets the pure helpers be unit-tested without
+ * network access. Accepts:
+ *   - https://github.com/owner/repo (with optional .git / trailing slash)
+ *   - github.com/owner/repo
+ *   - owner/repo shorthand
+ * Rejects anything that points deeper than a repository (issues, pulls, …),
+ * contains whitespace, or is otherwise malformed.
+ */
+export function parseFixRepository(value) {
+  const candidate = String(value || '')
+    .trim()
+    .replace(/^[<([{]+/, '')
+    .replace(/[>\])}.,;:]+$/, '');
+  if (!candidate || /\s/.test(candidate)) return null;
+
+  // Normalize away an optional protocol, then require either a github.com host
+  // or a bare `owner/repo` shorthand. Any other host is rejected.
+  let withoutProtocol = candidate.replace(/^https?:\/\//i, '');
+  const hadProtocol = withoutProtocol !== candidate;
+
+  let pathPart;
+  if (/^github\.com\//i.test(withoutProtocol)) {
+    pathPart = withoutProtocol.replace(/^github\.com\//i, '');
+  } else if (!hadProtocol && !withoutProtocol.includes('.com/') && !/[^/]+\.[^/]+\//.test(withoutProtocol)) {
+    // Bare shorthand like `owner/repo`.
+    pathPart = withoutProtocol;
+  } else {
+    return null;
+  }
+
+  pathPart = pathPart.replace(/\.git$/i, '').replace(/\/+$/, '');
+
+  const segments = pathPart.split('/').filter(Boolean);
+  if (segments.length !== 2) return null;
+
+  const [owner, repo] = segments;
+  if (!/^[A-Za-z0-9._-]+$/.test(owner) || !/^[A-Za-z0-9._-]+$/.test(repo)) return null;
+
+  return {
+    owner,
+    repo,
+    fullName: `${owner}/${repo}`,
+    url: `https://github.com/${owner}/${repo}`,
+  };
+}
+
+/**
+ * Normalize the GitHub `/languages` response (a `{ "JavaScript": bytes }` map)
+ * or an array of names into a byte-sorted array of `{ name, bytes }`.
+ */
+export function normalizeLanguages(input) {
+  let entries = [];
+  if (Array.isArray(input)) {
+    entries = input.map(name => [String(name), 0]);
+  } else if (input && typeof input === 'object') {
+    entries = Object.entries(input).map(([name, bytes]) => [String(name), Number(bytes) || 0]);
+  }
+  return entries
+    .filter(([name]) => name)
+    .map(([name, bytes]) => ({ name, bytes }))
+    .sort((a, b) => b.bytes - a.bytes || a.name.localeCompare(b.name));
+}
+
+/**
+ * Map detected languages to CI/CD templates, sorted so that the templates for
+ * the most-used languages come first (issue #1733: "links to CI/CD templates
+ * should be sorted by detected languages in the target repository").
+ *
+ * Returns:
+ *   - sortedTemplates: matched templates ordered by aggregate detected bytes
+ *   - unmatchedLanguages: detected languages with no template (informational)
+ */
+export function mapLanguagesToTemplates(languages) {
+  const normalized = normalizeLanguages(languages);
+
+  const templateByLanguage = new Map();
+  for (const template of CI_CD_TEMPLATES) {
+    for (const language of template.languages) {
+      templateByLanguage.set(language.toLowerCase(), template);
+    }
+  }
+
+  const aggregate = new Map(); // template.key -> { template, bytes, languages: [] }
+  const unmatchedLanguages = [];
+
+  for (const { name, bytes } of normalized) {
+    const template = templateByLanguage.get(name.toLowerCase());
+    if (!template) {
+      unmatchedLanguages.push(name);
+      continue;
+    }
+    const existing = aggregate.get(template.key) || { template, bytes: 0, languages: [] };
+    existing.bytes += bytes;
+    existing.languages.push(name);
+    aggregate.set(template.key, existing);
+  }
+
+  const templateOrder = new Map(CI_CD_TEMPLATES.map((template, index) => [template.key, index]));
+  const sortedTemplates = [...aggregate.values()].sort((a, b) => b.bytes - a.bytes || templateOrder.get(a.template.key) - templateOrder.get(b.template.key));
+
+  return { sortedTemplates, unmatchedLanguages };
+}
+
+/**
+ * Title of the auto-generated remediation issue, taken exactly from the
+ * standard template issue https://github.com/link-assistant/web-capture/issues/139
+ * (issue #1733: "use title and description exactly"). The issue is created in
+ * the target repository itself, so it carries no repository suffix.
+ */
+export const CI_CD_ISSUE_TITLE = 'Check for all false positives, false negatives, warnings and errors in CI/CD and fix them all';
+
+export function buildCiCdIssueTitle() {
+  return CI_CD_ISSUE_TITLE;
+}
+
+function shortSha(sha) {
+  return String(sha || '').slice(0, 7);
+}
+
+/** Render the detected-languages section. */
+export function buildLanguagesSection(languages) {
+  const normalized = normalizeLanguages(languages);
+  if (normalized.length === 0) {
+    return 'No languages were reported by the GitHub Linguist API for this repository.';
+  }
+  const total = normalized.reduce((sum, { bytes }) => sum + bytes, 0) || 1;
+  const lines = normalized.map(({ name, bytes }) => {
+    const percent = ((bytes / total) * 100).toFixed(1);
+    return `- **${name}** — ${percent}%`;
+  });
+  return lines.join('\n');
+}
+
+/** Render the recommended-templates section, sorted by detected languages. */
+export function buildTemplatesSection(languages) {
+  const { sortedTemplates, unmatchedLanguages } = mapLanguagesToTemplates(languages);
+  const lines = [];
+
+  if (sortedTemplates.length === 0) {
+    lines.push('No language-specific template matched the detected languages. Review all templates and apply the closest match:');
+    lines.push('');
+    for (const template of CI_CD_TEMPLATES) {
+      lines.push(`- ${template.label}: [${template.repo}](${templateUrl(template.repo)})`);
+    }
+  } else {
+    lines.push('Apply the best practices from these templates, in priority order (most-used language first):');
+    lines.push('');
+    sortedTemplates.forEach((entry, index) => {
+      const detected = entry.languages.join(', ');
+      lines.push(`${index + 1}. **${entry.template.label}** — [${entry.template.repo}](${templateUrl(entry.template.repo)}) _(detected: ${detected})_`);
+    });
+  }
+
+  if (unmatchedLanguages.length > 0) {
+    lines.push('');
+    lines.push(`Other detected languages without a dedicated template: ${unmatchedLanguages.join(', ')}.`);
+  }
+
+  return lines.join('\n');
+}
+
+/** Render the CI/CD runs section from the GitHub Actions API payload. */
+export function buildRunsSection(runs, { emptyMessage } = {}) {
+  const list = Array.isArray(runs) ? runs : [];
+  if (list.length === 0) {
+    return emptyMessage || 'No CI/CD runs were found for the latest default-branch commit.';
+  }
+  const header = '| Workflow | Status | Conclusion | Run |\n| --- | --- | --- | --- |';
+  const rows = list.map(run => {
+    const name = run.name || run.workflowName || 'unknown';
+    const status = run.status || 'unknown';
+    const conclusion = run.conclusion || (status === 'completed' ? 'unknown' : 'in_progress');
+    const url = run.html_url || run.url || '';
+    const runLabel = url ? `[run](${url})` : '—';
+    return `| ${name} | ${status} | ${conclusion} | ${runLabel} |`;
+  });
+  return [header, ...rows].join('\n');
+}
+
+/** Count the runs that did not pass (failure/cancelled/timed_out/etc.). */
+export function summarizeRunFailures(runs) {
+  const list = Array.isArray(runs) ? runs : [];
+  const passing = new Set(['success', 'neutral', 'skipped']);
+  const failing = list.filter(run => {
+    const conclusion = (run.conclusion || '').toLowerCase();
+    return run.status === 'completed' && conclusion && !passing.has(conclusion);
+  });
+  return { total: list.length, failing: failing.length };
+}
+
+/**
+ * The `/solve` options that `/fix` always turns on. `--development-log`
+ * replaces the retired collection paragraph; `--deep-analysis` provides the
+ * remaining instructions omitted from the generated issue body (issue #1733).
+ */
+export const SOLVE_OPTION_DEVELOPMENT_LOG = '--development-log';
+export const SOLVE_OPTION_DEEP_ANALYSIS = '--deep-analysis';
+export const FIX_FORWARDED_SOLVE_OPTIONS = Object.freeze([SOLVE_OPTION_DEVELOPMENT_LOG, SOLVE_OPTION_DEEP_ANALYSIS]);
+
+/**
+ * Paragraphs of the standard prompt, quoted from
+ * https://github.com/link-assistant/web-capture/issues/139.
+ *
+ * `providedBy` lists the `/solve` options that already inject an equivalent
+ * instruction into the AI prompt (see `buildDeepAnalysisPrompt`). A paragraph
+ * is dropped from the issue body when every option that provides it is passed
+ * to `/solve`.
+ *
+ * The deep-analysis wording below is the "bug" variant, which `/solve` emits
+ * only when the issue type is Bug — `/fix` therefore creates the issue with
+ * that type (see CI_CD_ISSUE_TYPE).
+ *
+ * The old case-study instruction from the upstream template is intentionally
+ * not represented here. `--development-log` is its replacement; generated
+ * issues must never offer or restore the superseded folder convention, even
+ * when callers request an otherwise unabridged prompt (PR #1929 feedback).
+ */
+export const DEBUG_OUTPUT_PARAGRAPH = 'If there is not enough data to find actual root cause, add debug output and verbose mode if not present, that will allow us to find root cause on next iteration.';
+export const REPORT_UPSTREAM_PARAGRAPH = 'If issue related to any other repository/project, where we can report issues on GitHub, please do so. Each issue must contain reproducible examples, workarounds and suggestions for fix the issue in code. Also double check to fully apply requirements to entire codebase, so if we have issue in multiple places, it should be fixed in all them.';
+
+/** Build the ordered, tagged paragraphs of the standard prompt. */
+export function buildStandardPromptParagraphs({ templatesSorted } = {}) {
+  const templateLinks = (templatesSorted && templatesSorted.length > 0 ? templatesSorted.map(entry => entry.template.repo) : CI_CD_TEMPLATES.map(template => template.repo)).map(repo => `- ${templateUrl(repo)}`).join('\n');
+
+  return [
+    {
+      providedBy: [],
+      text: `Use all the best practices from CI/CD templates (check full file tree to compare for all GitHub workflow and CI/CD scripts file), if the same issue is found in template report issue also in templates:\n\n${templateLinks}`,
+    },
+    {
+      providedBy: [],
+      text: "We should compare all files, so we don't have more CI/CD errors in the future and reuse all the best practices from these templates.",
+    },
+    {
+      providedBy: [SOLVE_OPTION_DEEP_ANALYSIS],
+      text: DEBUG_OUTPUT_PARAGRAPH,
+    },
+    {
+      providedBy: [SOLVE_OPTION_DEEP_ANALYSIS],
+      text: REPORT_UPSTREAM_PARAGRAPH,
+    },
+    {
+      providedBy: [],
+      text: `Follow the CI/CD best practices collected in [${CI_CD_BEST_PRACTICES_URL}](${CI_CD_BEST_PRACTICES_URL}).`,
+    },
+    {
+      // Quoted verbatim from the template; identical to the reinforcement
+      // prompt /solve --keep-working-... reuses, so share the single constant.
+      providedBy: [],
+      text: KEEP_WORKING_PROMPT,
+    },
+  ];
+}
+
+/**
+ * The standard remediation prompt, quoted from web-capture#139 with the
+ * paragraphs that `omittedOptions` already provide removed.
+ */
+export function buildStandardPrompt({ templatesSorted, omittedOptions = FIX_FORWARDED_SOLVE_OPTIONS } = {}) {
+  const omitted = new Set(omittedOptions || []);
+  return buildStandardPromptParagraphs({ templatesSorted })
+    .filter(paragraph => paragraph.providedBy.length === 0 || !paragraph.providedBy.every(option => omitted.has(option)))
+    .map(paragraph => paragraph.text)
+    .join('\n\n');
+}
+
+/**
+ * Issue type and label of the generated issue.
+ *
+ * `/solve --deep-analysis` only emits the root-cause / debug-output /
+ * report-upstream instructions — the paragraphs this body omits — when the
+ * issue type is Bug (see `isBugIssueType` in development-log.lib.mjs). Creating
+ * the issue as a Bug is therefore what makes the omission lossless.
+ */
+export const CI_CD_ISSUE_TYPE = 'Bug';
+export const CI_CD_ISSUE_LABELS = Object.freeze(['bug']);
+
+/**
+ * Build the full Markdown body of the auto-generated remediation issue.
+ *
+ * The body mirrors the template issue's own description: the CI/CD runs of the
+ * latest default-branch commit first, then the standard prompt. The data `/fix`
+ * collected to build it (commit, languages, template ranking) follows as a
+ * collapsed context block so it stays available without displacing the prompt.
+ */
+export function buildCiCdIssueBody({ repository, defaultBranch, commit, runs, languages, runsSource = 'commit', omittedOptions = FIX_FORWARDED_SOLVE_OPTIONS }) {
+  const { sortedTemplates } = mapLanguagesToTemplates(languages);
+  const { total, failing } = summarizeRunFailures(runs);
+
+  const commitLine = commit?.sha ? `\`${shortSha(commit.sha)}\`${commit.url ? ` ([commit](${commit.url}))` : ''}${commit.message ? ` — ${String(commit.message).split('\n')[0]}` : ''}` : 'unknown';
+
+  // When the exact latest commit produced no runs (common for release/tag
+  // commits), `/fix` falls back to the most recent runs on the default branch
+  // so the issue stays actionable. Label the source honestly.
+  const runsHeading = runsSource === 'branch' ? `Recent CI/CD runs on \`${defaultBranch || 'default branch'}\`` : 'Latest default-branch CI/CD runs';
+  const runsEmptyMessage = runsSource === 'branch' ? `No recent CI/CD runs were found on \`${defaultBranch || 'the default branch'}\`.` : 'No CI/CD runs were found for the latest default-branch commit.';
+
+  const sections = [`### ${runsHeading}`, '', buildRunsSection(runs, { emptyMessage: runsEmptyMessage }), '', buildStandardPrompt({ templatesSorted: sortedTemplates, omittedOptions }), '', '---', '', '<details>', '<summary>Context collected by <code>/fix --ci-cd</code></summary>', '', `- **Repository:** [${repository?.fullName}](${repository?.url})`, `- **Default branch:** \`${defaultBranch || 'unknown'}\``, `- **Latest commit:** ${commitLine}`, `- **CI/CD runs found:** ${total} (${failing} not passing)`, '', '**Detected languages**', '', buildLanguagesSection(languages), '', '**Recommended CI/CD templates**', '', buildTemplatesSection(languages), '', '</details>'];
+
+  return sections.join('\n');
+}
+
+/**
+ * Flags that `/fix` consumes itself and must NOT be forwarded to `/solve`.
+ * Boolean flags only — they never take a value.
+ */
+export const FIX_OWNED_BOOLEAN_FLAGS = Object.freeze(['--ci-cd', '--dry-run', '--no-solve', '--solve', '--no-auto-solve', '--help', '-h', '--version']);
+
+/**
+ * Partition raw CLI args into the options `/fix` consumes and the passthrough
+ * args forwarded to `/solve`. Unknown flags (and their values) are preserved in
+ * order so that `--tool`, `--model`, `--think`, etc. reach `/solve` untouched.
+ */
+export function partitionFixArgs(rawArgs) {
+  const args = Array.isArray(rawArgs) ? rawArgs : [];
+  const result = {
+    repository: null,
+    repositoryRaw: null,
+    ciCd: false,
+    dryRun: false,
+    runSolve: true,
+    help: false,
+    version: false,
+    passthrough: [],
+  };
+
+  for (const arg of args) {
+    if (arg === '--ci-cd') {
+      result.ciCd = true;
+      continue;
+    }
+    if (arg === '--dry-run') {
+      result.dryRun = true;
+      continue;
+    }
+    if (arg === '--no-solve' || arg === '--no-auto-solve') {
+      result.runSolve = false;
+      continue;
+    }
+    if (arg === '--solve') {
+      result.runSolve = true;
+      continue;
+    }
+    if (arg === '--help' || arg === '-h') {
+      result.help = true;
+      continue;
+    }
+    if (arg === '--version') {
+      result.version = true;
+      continue;
+    }
+    // First bare GitHub repository argument becomes the target.
+    if (!result.repository && !arg.startsWith('-')) {
+      const repository = parseFixRepository(arg);
+      if (repository) {
+        result.repository = repository;
+        result.repositoryRaw = arg;
+        continue;
+      }
+    }
+    result.passthrough.push(arg);
+  }
+
+  return result;
+}
+
+/**
+ * The options `/fix` always turns on when handing the issue to `/solve`
+ * (issue #1733: "do similar to what `/solve --development-log --deep-analysis
+ * --auto-merge`"). `--development-log` replaces the superseded case-study
+ * workflow, while `--deep-analysis` re-injects the prompt paragraphs
+ * `buildCiCdIssueBody` conditionally omits from the issue text.
+ */
+export const FIX_SOLVE_OPTIONS = Object.freeze([SOLVE_OPTION_DEVELOPMENT_LOG, SOLVE_OPTION_DEEP_ANALYSIS, '--auto-merge']);
+
+/**
+ * Build the argv passed to `solve.mjs`: the created issue URL, the options
+ * `/fix` always enables, and every forwarded option. An option the caller
+ * already passed through is not duplicated.
+ */
+export function buildSolveArgs({ issueUrl, passthrough = [] }) {
+  const args = [issueUrl];
+  for (const option of FIX_SOLVE_OPTIONS) {
+    if (!passthrough.includes(option)) {
+      args.push(option);
+    }
+  }
+  args.push(...passthrough);
+  return args;
+}