@usepipr/runtime 0.3.8 → 0.4.1

package/dist/official-github-workflow-Cx-Yhh86.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"official-github-workflow-Cx-Yhh86.mjs","names":[],"sources":["../src/config/recipes/bug-hunter.ts","../src/config/recipes/changelog-draft.ts","../src/config/recipes/ci-triage-command.ts","../src/config/recipes/default-review.ts","../src/config/recipes/dependency-risk.ts","../src/config/recipes/diff-diagnostics.ts","../src/config/recipes/fix-suggestions.ts","../src/config/recipes/interactive-ask.ts","../src/config/recipes/multi-agent-review.ts","../src/config/recipes/plugin-tool-review.ts","../src/config/recipes/pr-briefing.ts","../src/config/recipes/pr-hygiene.ts","../src/config/recipes/quality-gate.ts","../src/config/recipes/rich-review.ts","../src/config/recipes/security-sast.ts","../src/config/recipes.ts","../src/config/official-github-workflow.ts"],"sourcesContent":["import type { OfficialInitRecipe } from \"./types.js\";\n\nexport const bugHunterRecipe = {\n  id: \"bug-hunter\",\n  title: \"Bug Hunter\",\n  description: \"Bug-focused review for correctness, edge cases, races, and regressions.\",\n  sourceTools: [\"Graphite AI Reviews\", \"CodeRabbit\", \"GitHub Copilot code review\"],\n  configTs: `import { definePipr } from \"@usepipr/sdk\";\n\nexport default definePipr((pipr) => {\n  const primary = pipr.model({\n    id: \"deepseek/deepseek-v4-pro-primary\",\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"high\" },\n  });\n\n  const fallback = pipr.model({\n    id: \"deepseek/deepseek-v4-pro-fast\",\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"medium\" },\n  });\n\n  pipr.config({ publication: { maxInlineComments: 8 } });\n\n  const reviewer = pipr.reviewer({\n    name: \"bug-hunter\",\n    model: primary,\n    fallbacks: [fallback],\n    instructions: \\`\n      Review only defects with a reproducible failure path or a violated\n      repository contract: broken logic, edge cases, concurrency risks, data\n      loss, performance regressions, and behavior changes missing meaningful\n      tests. For API, async, state, and concurrency changes, inspect relevant\n      callers and tests before reporting. Suppress generic maintainability,\n      style-only, and broad refactor feedback.\n    \\`,\n    timeout: \"7m\",\n  });\n\n  pipr.review({\n    id: \"bug-hunter\",\n    reviewer,\n    paths: {\n      exclude: [\"docs/**\", \"**/*.md\"],\n    },\n    timeout: \"7m\",\n    entrypoints: {\n      changeRequest: [\"opened\", \"updated\", \"reopened\", \"ready\"],\n      command: {\n        pattern: \"@pipr bugs\",\n        permission: \"write\",\n        description: \"Run a defect-focused review.\",\n      },\n    },\n  });\n});\n`,\n} as const satisfies OfficialInitRecipe;\n","import type { OfficialInitRecipe } from \"./types.js\";\n\nexport const changelogDraftRecipe = {\n  id: \"changelog-draft\",\n  title: \"Changelog Draft\",\n  description: \"PR-Agent update_changelog-style release note draft as a comment.\",\n  sourceTools: [\"PR-Agent /update_changelog\"],\n  configTs: `import { definePipr, z } from \"@usepipr/sdk\";\n\nexport default definePipr((pipr) => {\n  const model = pipr.model({\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"medium\" },\n  });\n\n  const changelogOutput = pipr.schema({\n    id: \"release/changelog-draft\",\n    schema: z.strictObject({\n      category: z.enum([\"added\", \"changed\", \"fixed\", \"removed\", \"security\", \"internal\"]),\n      entry: z.string(),\n      rationale: z.string(),\n    }),\n  });\n\n  const changelog = pipr.agent({\n    name: \"changelog-draft\",\n    model,\n    instructions: \\`\n      Draft one concise, release-facing changelog entry grounded in changed\n      behavior and change request intent. Use category \"internal\" when there is no\n      user-visible effect. Mention breaking behavior only when the repository\n      evidence proves it. Do not invent issue IDs, versions, release claims, or\n      behavior not supported by the change. Do not edit files.\n    \\`,\n    output: changelogOutput,\n    prompt: () => \"Draft the changelog entry for this change.\",\n  });\n\n  const task = pipr.task({\n    name: \"changelog-draft\",\n    async run(ctx) {\n      const manifest = await ctx.change.diffManifest({ compressed: true });\n      const result = await ctx.pi.run(changelog, { manifest });\n      await ctx.comment(\n        [\n          \\`**Category:** \\${result.category}\\`,\n          \"\",\n          result.entry,\n          \"\",\n          \"## Rationale\",\n          result.rationale,\n        ].join(\"\\\\n\"),\n      );\n    },\n  });\n\n  pipr.on.changeRequest({ actions: [\"opened\", \"updated\"], task });\n  pipr.command({ pattern: \"@pipr changelog\", permission: \"write\", task });\n});\n`,\n} as const satisfies OfficialInitRecipe;\n","import type { OfficialInitRecipe } from \"./types.js\";\n\nexport const ciTriageCommandRecipe = {\n  id: \"ci-triage-command\",\n  title: \"CI Triage Command\",\n  description: \"Command-only CI failure triage from a pasted log excerpt.\",\n  sourceTools: [\"CodeRabbit\"],\n  configTs: `import { definePipr, z } from \"@usepipr/sdk\";\n\nexport default definePipr((pipr) => {\n  const model = pipr.model({\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"high\" },\n  });\n\n  const ciTriageOutput = pipr.schema({\n    id: \"ci/triage\",\n    schema: z.strictObject({\n      status: z.enum([\"diagnosed\", \"insufficient-context\"]),\n      summary: z.string(),\n      evidence: z.array(z.string()).max(4),\n      likelyCauses: z.array(z.string()).max(3),\n      nextSteps: z.array(z.string()).max(4),\n    }),\n  });\n\n  const ciTriage = pipr.agent({\n    name: \"ci-triage\",\n    model,\n    instructions: \\`\n      Diagnose CI failures using only the pasted log excerpt, change request\n      metadata, prior review state, and repository evidence. Identify the first\n      actionable failure and separate it from downstream cascade errors. Use\n      status \"insufficient-context\" when the excerpt cannot support a diagnosis.\n      Do not infer a cause from a final exit code alone.\n    \\`,\n    output: ciTriageOutput,\n    prompt: (input: { log: string; manifest: unknown; prior: unknown }) => pipr.prompt\\`\n      \\${pipr.section(\"CI log excerpt\", input.log)}\n      \\${pipr.section(\"Prior pipr review\", pipr.json(input.prior, { maxCharacters: 20000 }))}\n    \\`,\n  });\n\n  const task = pipr.task<{ log: string }>({\n    name: \"ci-triage\",\n    async run(ctx, input) {\n      if (!ctx.command) {\n        throw new Error(\"ci-triage is a command-only task\");\n      }\n      const manifest = await ctx.change.diffManifest({ compressed: true });\n      const prior = await ctx.review.prior();\n      const result = await ctx.pi.run(ciTriage, { log: input.log, manifest, prior });\n      await ctx.command.reply(ciTriageComment(result));\n    },\n  });\n\n  pipr.command({\n    pattern: \"@pipr ci <log...>\",\n    permission: \"write\",\n    description: \"Triage a pasted CI failure log.\",\n    parse: (args) => ({ log: args.log ?? \"\" }),\n    task,\n  });\n});\n\ntype CiTriageResult = {\n  status: \"diagnosed\" | \"insufficient-context\";\n  summary: string;\n  evidence: string[];\n  likelyCauses: string[];\n  nextSteps: string[];\n};\n\nfunction ciTriageComment(result: CiTriageResult): string {\n  const sections = [\n    \"## CI Triage\",\n    \"\",\n    \"**Status:** \" + labelValue(result.status),\n    \"\",\n    result.summary,\n  ];\n  appendList(sections, \"Evidence\", result.evidence);\n  appendList(sections, \"Likely Causes\", result.likelyCauses);\n  appendList(sections, \"Next Steps\", result.nextSteps);\n  return sections.join(\"\\\\n\");\n}\n\nfunction appendList(sections: string[], title: string, items: string[]): void {\n  if (items.length === 0) {\n    return;\n  }\n  sections.push(\"\", \"## \" + title, \"\", ...items.map((item) => \"- \" + item));\n}\n\nfunction labelValue(value: string): string {\n  return value.replaceAll(\"-\", \" \").replace(/^./, (char) => char.toUpperCase());\n}\n`,\n} as const satisfies OfficialInitRecipe;\n","import type { OfficialInitRecipe } from \"./types.js\";\n\nexport const defaultReviewRecipe = {\n  id: \"default-review\",\n  title: \"Default Review\",\n  description: \"General change request review with bounded inline comments.\",\n  sourceTools: [\"pipr\"],\n  configTs: `import { definePipr } from \"@usepipr/sdk\";\n\nexport default definePipr((pipr) => {\n  const model = pipr.model({\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"high\" },\n  });\n\n  pipr.config({ publication: { maxInlineComments: 5 } });\n\n  pipr.review({\n    id: \"review\",\n    model,\n    instructions: \\`\n      Review changed behavior for correctness, security, maintainability, and\n      meaningful regression gaps. Focus on concrete impact and compatibility\n      with repository contracts. Return only actionable findings that target\n      valid diff ranges.\n    \\`,\n    timeout: \"10m\",\n    comment: (result, context) => {\n      const inlineFindingSummary =\n        result.inlineFindings.length === 0\n          ? \"No inline findings.\"\n          : \"See inline comments in the diff.\";\n      const localInlineFindingSummary = [\n        \"## Inline Findings\",\n        \"\",\n        result.inlineFindings.length === 0\n          ? \"No inline findings.\"\n          : result.inlineFindings.map((finding) => \\`- \\${finding.body}\\`).join(\"\\\\n\"),\n      ].join(\"\\\\n\");\n\n      return {\n        main: [\n          \"## Summary\",\n          \"\",\n          result.summary.body,\n          \"\",\n          \"## Review Result\",\n          \"\",\n          \"| Signal | Result |\",\n          \"| --- | ---: |\",\n          \\`| Inline findings | \\${result.inlineFindings.length} |\\`,\n          \"\",\n          context.platform.id === \"local\" ? localInlineFindingSummary : inlineFindingSummary,\n        ].join(\"\\\\n\"),\n        inlineFindings: result.inlineFindings,\n      };\n    },\n  });\n});\n`,\n} as const satisfies OfficialInitRecipe;\n","import type { OfficialInitRecipe } from \"./types.js\";\n\nexport const dependencyRiskRecipe = {\n  id: \"dependency-risk\",\n  title: \"Dependency Risk\",\n  description: \"Dependency manifest and lockfile review with Renovate-style risk notes.\",\n  sourceTools: [\"Renovate\"],\n  configTs: `import { definePipr, z } from \"@usepipr/sdk\";\n\nexport default definePipr((pipr) => {\n  const model = pipr.model({\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"high\" },\n  });\n\n  const dependencyOutput = pipr.schema({\n    id: \"dependency/risk-summary\",\n    schema: z.strictObject({\n      summary: z.string(),\n      risks: z.array(z.string()).max(6),\n      followUps: z.array(z.string()).max(6),\n    }),\n  });\n\n  const dependencyReviewer = pipr.agent({\n    name: \"dependency-risk\",\n    model,\n    instructions: \\`\n      Review dependency manifest and lockfile changes. Distinguish direct from\n      transitive changes, runtime from development scope, and manifest intent\n      from generated lockfile churn. Check manifest-lock consistency. Flag\n      evidenced breaking upgrades, suspicious additions, install script risk,\n      lockfile drift, and required migration work. Do not make external release,\n      compatibility, or CVE claims that are not evidenced in the change.\n    \\`,\n    output: dependencyOutput,\n    prompt: () => \"Review the dependency-related changes in this change request.\",\n  });\n\n  const task = pipr.task({\n    name: \"dependency-risk\",\n    async run(ctx) {\n      const paths = {\n        include: [\n          \"**/package.json\",\n          \"**/bun.lock\",\n          \"**/package-lock.json\",\n          \"**/pnpm-lock.yaml\",\n          \"**/yarn.lock\",\n          \"**/requirements*.txt\",\n          \"**/pyproject.toml\",\n          \"**/deno.json\",\n          \"**/deno.jsonc\",\n          \"**/jsr.json\",\n          \"**/uv.lock\",\n          \"**/poetry.lock\",\n          \"**/Pipfile\",\n          \"**/Pipfile.lock\",\n          \"**/Gemfile\",\n          \"**/Gemfile.lock\",\n          \"**/composer.json\",\n          \"**/composer.lock\",\n          \"**/Package.swift\",\n          \"**/Package.resolved\",\n          \"**/Directory.Packages.props\",\n          \"**/packages.lock.json\",\n          \"**/Cargo.toml\",\n          \"**/Cargo.lock\",\n          \"**/go.mod\",\n          \"**/go.sum\",\n        ],\n      };\n      const manifest = await ctx.change.diffManifest({ compressed: true, paths });\n      if (manifest.files.length === 0) {\n        await ctx.comment(\"No dependency files changed.\");\n        return;\n      }\n      const result = await ctx.pi.run(dependencyReviewer, { manifest }, { paths });\n      await ctx.comment(\n        [\n          result.summary,\n          \"\",\n          \"## Risks\",\n          ...result.risks.map((risk) => \\`- \\${risk}\\`),\n          \"\",\n          \"## Follow-ups\",\n          ...result.followUps.map((followUp) => \\`- \\${followUp}\\`),\n        ].join(\"\\\\n\"),\n      );\n    },\n  });\n\n  pipr.on.changeRequest({ actions: [\"opened\", \"updated\"], task });\n  pipr.command({ pattern: \"@pipr dependency-risk\", permission: \"write\", task });\n});\n`,\n} as const satisfies OfficialInitRecipe;\n","import type { OfficialInitRecipe } from \"./types.js\";\n\nexport const diffDiagnosticsRecipe = {\n  id: \"diff-diagnostics\",\n  title: \"Diff Diagnostics\",\n  description: \"reviewdog-style diagnostic review mapped into inline findings.\",\n  sourceTools: [\"reviewdog\"],\n  configTs: `import { definePipr, z } from \"@usepipr/sdk\";\nimport type { ReviewFinding } from \"@usepipr/sdk\";\n\nexport default definePipr((pipr) => {\n  const model = pipr.model({\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"high\" },\n  });\n\n  const diagnosticOutput = pipr.schema({\n    id: \"diagnostics/reviewdog-style\",\n    schema: z.strictObject({\n      summary: z.string(),\n      diagnostics: z.array(z.strictObject({\n        body: z.string(),\n        path: z.string(),\n        rangeId: z.string(),\n        side: z.enum([\"RIGHT\", \"LEFT\"]),\n        startLine: z.number().int().positive(),\n        endLine: z.number().int().positive(),\n        suggestedFix: z.string().optional(),\n      })),\n    }),\n  });\n\n  const diagnostics = pipr.agent({\n    name: \"diff-diagnostics\",\n    model,\n    instructions: \\`\n      Produce short compiler-style diagnostics for actionable defects only.\n      State the concrete defect and impact in at most two sentences. Suppress\n      style preferences, broad refactors, and diagnostics without exact changed-line anchors.\n    \\`,\n    output: diagnosticOutput,\n    prompt: () => \"Summarize the diff-scoped diagnostics for this change.\",\n  });\n\n  const task = pipr.task({\n    name: \"diff-diagnostics\",\n    async run(ctx) {\n      const manifest = await ctx.change.diffManifest({ compressed: true });\n      const result = await ctx.pi.run(diagnostics, { manifest });\n      const inlineFindings: ReviewFinding[] = result.diagnostics.map((diagnostic) => ({\n        body: diagnostic.body,\n        path: diagnostic.path,\n        rangeId: diagnostic.rangeId,\n        side: diagnostic.side,\n        startLine: diagnostic.startLine,\n        endLine: diagnostic.endLine,\n        ...(diagnostic.suggestedFix ? { suggestedFix: diagnostic.suggestedFix } : {}),\n      }));\n      await ctx.comment({\n        main: result.summary,\n        inlineFindings,\n      });\n    },\n  });\n\n  pipr.on.changeRequest({ actions: [\"opened\", \"updated\"], task });\n  pipr.command({ pattern: \"@pipr diagnostics\", permission: \"write\", task });\n});\n`,\n} as const satisfies OfficialInitRecipe;\n","import type { OfficialInitRecipe } from \"./types.js\";\n\nexport const fixSuggestionsRecipe = {\n  id: \"fix-suggestions\",\n  title: \"Fix Suggestions\",\n  description: \"Command-first exact suggested fixes for actionable review improvements.\",\n  sourceTools: [\"Qodo Merge /improve\", \"GitHub Copilot code review\", \"Cursor Bugbot\"],\n  configTs: `import { definePipr, z } from \"@usepipr/sdk\";\nimport type { CommentableRange, DiffManifest, ReviewFinding } from \"@usepipr/sdk\";\n\nexport default definePipr((pipr) => {\n  const model = pipr.model({\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"high\" },\n  });\n\n  pipr.config({ publication: { maxInlineComments: 6 } });\n\n  const fixSuggestionSchema = z.strictObject({\n    title: z.string(),\n    category: z.enum([\"correctness\", \"tests\", \"maintainability\", \"typing\", \"documentation\"]),\n    body: z.string(),\n    path: z.string(),\n    rangeId: z.string(),\n    side: z.enum([\"RIGHT\", \"LEFT\"]),\n    startLine: z.number().int().positive(),\n    endLine: z.number().int().positive(),\n    suggestedFix: z.string().min(1),\n  });\n\n  type FixSuggestion = z.infer<typeof fixSuggestionSchema>;\n\n  const fixSuggestionOutput = pipr.schema({\n    id: \"review/fix-suggestions\",\n    schema: z.strictObject({\n      suggestions: z.array(fixSuggestionSchema),\n    }),\n  });\n\n  const fixVerificationOutput = pipr.schema({\n    id: \"review/fix-suggestion-verification\",\n    schema: z.strictObject({\n      verdicts: z.array(z.strictObject({\n        index: z.number().int().nonnegative(),\n        accepted: z.boolean(),\n        reason: z.string(),\n      })),\n    }),\n  });\n\n  const fixer = pipr.agent({\n    name: \"fix-suggestions\",\n    model,\n    instructions: \\`\n      Find directly applicable fixes for this change request. Return an item only\n      when an exact patch can resolve the reported defect; otherwise omit the\n      entire item. Prioritize correctness, missing tests, type safety, and small\n      maintainability improvements. Do not report broad refactors, style\n      preferences, or issues without an exact patch.\n    \\`,\n    output: fixSuggestionOutput,\n    tools: pipr.tools.readOnly,\n    retry: { invalidOutput: 1, transientFailure: 1 },\n    timeout: \"7m\",\n    prompt: () => \"Find exact suggested changes for this change request.\",\n  });\n\n  const verifier = pipr.agent({\n    name: \"fix-suggestion-verifier\",\n    model,\n    instructions: \\`\n      Semantically verify candidate fixes after deterministic range validation.\n      Accept a candidate only when the defect is real and introduced or exposed\n      by the change, the body and replacement address the same defect, the exact\n      replacement preserves surrounding contracts, and no secret or config\n      dependency is invented. Reject speculative, style-only, or broad changes.\n      Return one verdict for every supplied candidate index and never invent indexes.\n    \\`,\n    output: fixVerificationOutput,\n    tools: pipr.tools.readOnly,\n    retry: { invalidOutput: 1, transientFailure: 1 },\n    timeout: \"7m\",\n    prompt: (input: { manifest: unknown; candidates: FixSuggestion[] }) => pipr.prompt\\`\n      \\${pipr.section(\n        \"Candidate suggestions\",\n        pipr.json(input.candidates, { maxCharacters: 60000 }),\n      )}\n    \\`,\n  });\n\n  const task = pipr.task({\n    name: \"fix-suggestions\",\n    async run(ctx) {\n      if (!ctx.command) {\n        throw new Error(\"fix-suggestions is a command-only task\");\n      }\n      const manifest = await ctx.change.diffManifest({ compressed: true });\n      const result = await ctx.pi.run(fixer, { manifest });\n      const deterministicCandidates = result.suggestions.filter(\n        (suggestion) => isPublishableSuggestion(suggestion, manifest),\n      );\n      const publishableSuggestions =\n        deterministicCandidates.length === 0\n          ? []\n          : acceptedSuggestions(\n              deterministicCandidates,\n              (\n                await ctx.pi.run(verifier, {\n                  manifest,\n                  candidates: deterministicCandidates,\n                })\n              ).verdicts,\n            );\n      const inlineFindings: ReviewFinding[] = publishableSuggestions.map((suggestion) => {\n        const category = suggestion.category\n          .replaceAll(\"-\", \" \")\n          .replace(/^./, (char) => char.toUpperCase());\n        return {\n          body: \\`**\\${category}:** \\${suggestion.title}. \\${suggestion.body}\\`,\n          path: suggestion.path,\n          rangeId: suggestion.rangeId,\n          side: suggestion.side,\n          startLine: suggestion.startLine,\n          endLine: suggestion.endLine,\n          suggestedFix: suggestion.suggestedFix,\n        };\n      });\n      await ctx.comment({\n        main: [\n          suggestionSummary(publishableSuggestions.length),\n          \"\",\n          \"## Exact Suggested Changes\",\n          \"\",\n          suggestionsTable(publishableSuggestions),\n        ].join(\"\\\\n\"),\n        inlineFindings,\n      });\n    },\n  });\n\n  pipr.command({\n    pattern: \"@pipr improve\",\n    permission: \"write\",\n    description: \"Find exact suggested fixes for this change request.\",\n    task,\n  });\n});\n\ntype FixSuggestionVerdict = {\n  index: number;\n  accepted: boolean;\n  reason: string;\n};\n\nfunction acceptedSuggestions(\n  candidates: FixSuggestion[],\n  verdicts: FixSuggestionVerdict[],\n): FixSuggestion[] {\n  const verdictByIndex = new Map<number, FixSuggestionVerdict>();\n  const duplicateIndexes = new Set<number>();\n  for (const verdict of verdicts) {\n    if (verdict.index < 0 || verdict.index >= candidates.length) {\n      continue;\n    }\n    if (verdictByIndex.has(verdict.index)) {\n      duplicateIndexes.add(verdict.index);\n      continue;\n    }\n    verdictByIndex.set(verdict.index, verdict);\n  }\n  return candidates.filter((_, index) => {\n    const verdict = verdictByIndex.get(index);\n    return !duplicateIndexes.has(index) && verdict?.accepted === true;\n  });\n}\n\nfunction suggestionSummary(count: number): string {\n  if (count === 0) {\n    return \"No exact suggested changes passed validation.\";\n  }\n  const noun = count === 1 ? \"change\" : \"changes\";\n  return count + \" exact suggested \" + noun + \" passed validation.\";\n}\n\ntype FindingAnchor = Pick<ReviewFinding, \"path\" | \"rangeId\" | \"side\" | \"startLine\" | \"endLine\">;\n\nfunction isPublishableSuggestion(suggestion: FixSuggestion, manifest: DiffManifest): boolean {\n  if (suggestion.suggestedFix.trim().length === 0) {\n    return false;\n  }\n  const range = commentableRangeForFinding(suggestion, manifest);\n  return Boolean(\n    range &&\n      isPublishableSuggestedFixSelection({\n        side: suggestion.side,\n        kind: range.kind,\n        rangeStartLine: range.startLine,\n        startLine: suggestion.startLine,\n        endLine: suggestion.endLine,\n        preview: range.preview,\n        suggestedFix: suggestion.suggestedFix,\n      }),\n  );\n}\n\nfunction commentableRangeForFinding(\n  finding: FindingAnchor,\n  manifest: DiffManifest,\n): CommentableRange | undefined {\n  for (const file of manifest.files) {\n    const range = file.commentableRanges.find((candidate) => candidate.id === finding.rangeId);\n    if (!range) {\n      continue;\n    }\n    return finding.rangeId === range.id &&\n      finding.path === range.path &&\n      finding.side === range.side &&\n      finding.startLine <= finding.endLine &&\n      finding.startLine >= range.startLine &&\n      finding.endLine <= range.endLine\n      ? range\n      : undefined;\n  }\n  return undefined;\n}\n\nfunction isPublishableSuggestedFixSelection(selection: {\n  side: \"RIGHT\" | \"LEFT\";\n  kind: \"added\" | \"deleted\" | \"context\" | \"mixed\";\n  rangeStartLine: number;\n  startLine: number;\n  endLine: number;\n  preview?: string;\n  suggestedFix: string;\n}): boolean {\n  const suggestedLines = normalizedSuggestedFixLines(selection.suggestedFix);\n  const selectedLineCount = selection.endLine - selection.startLine + 1;\n  if (\n    selection.side !== \"RIGHT\" ||\n    selection.kind === \"deleted\" ||\n    selectedLineCount > 12 ||\n    suggestedLines.length > 20\n  ) {\n    return false;\n  }\n\n  const originalLines = selectedPreviewLines(selection, selectedLineCount);\n  if (!originalLines) {\n    return false;\n  }\n  const firstOriginalEdge = structuralEdgeToken(originalLines[0]);\n  const firstSuggestedEdge = structuralEdgeToken(suggestedLines[0]);\n  const lastOriginalEdge = structuralEdgeToken(originalLines.at(-1));\n  const lastSuggestedEdge = structuralEdgeToken(suggestedLines.at(-1));\n  const originalLinesWithoutTrailingBlanks = originalLines.slice(\n    0,\n    lastNonBlankLineIndex(originalLines) + 1,\n  );\n  const suggestedLinesWithoutTrailingBlanks = suggestedLines.slice(\n    0,\n    lastNonBlankLineIndex(suggestedLines) + 1,\n  );\n  const hasTextChange =\n    originalLinesWithoutTrailingBlanks.length !== suggestedLinesWithoutTrailingBlanks.length ||\n    originalLinesWithoutTrailingBlanks.some(\n      (line, index) => line !== suggestedLinesWithoutTrailingBlanks[index],\n    );\n  return Boolean(\n    hasTextChange &&\n      !onlyChangesWhitespace(originalLinesWithoutTrailingBlanks, suggestedLinesWithoutTrailingBlanks) &&\n      !suggestionIntroducesNewEnvironmentAccess(selection.preview, selection.suggestedFix) &&\n      (firstOriginalEdge === undefined || firstOriginalEdge === firstSuggestedEdge) &&\n      (lastOriginalEdge === undefined || lastOriginalEdge === lastSuggestedEdge) &&\n      !hasUnchangedSelectionEdge(originalLines, suggestedLines) &&\n      !suggestionIncludesUnselectedContext(selection, selectedLineCount, suggestedLines),\n  );\n}\n\nfunction structuralEdgeToken(line: string | undefined): string | undefined {\n  const token = line?.trim().replace(/[;,]$/, \"\");\n  return token && Array.from(token).every((char) => \"{}[]()<>\".includes(char))\n    ? token\n    : undefined;\n}\n\nfunction normalizedSuggestedFixLines(value: string): string[] {\n  const normalized = value.replace(/\\\\r\\\\n/g, \"\\\\n\").replace(/\\\\r/g, \"\\\\n\");\n  const withoutFinalNewline = normalized.endsWith(\"\\\\n\") ? normalized.slice(0, -1) : normalized;\n  return withoutFinalNewline.length === 0 ? [] : withoutFinalNewline.split(\"\\\\n\");\n}\n\nfunction selectedPreviewLines(\n  selection: {\n    rangeStartLine: number;\n    startLine: number;\n    preview?: string;\n  },\n  selectedLineCount: number,\n): string[] | undefined {\n  if (!selection.preview) {\n    return undefined;\n  }\n  const offset = selection.startLine - selection.rangeStartLine;\n  if (offset < 0) {\n    return undefined;\n  }\n  const previewLines = selection.preview.replace(/\\\\r\\\\n/g, \"\\\\n\").replace(/\\\\r/g, \"\\\\n\").split(\"\\\\n\");\n  if (offset + selectedLineCount > previewLines.length) {\n    return undefined;\n  }\n  return previewLines.slice(offset, offset + selectedLineCount);\n}\n\nfunction suggestionIncludesUnselectedContext(\n  selection: {\n    rangeStartLine: number;\n    startLine: number;\n    preview?: string;\n  },\n  selectedLineCount: number,\n  suggestedLines: string[],\n): boolean {\n  if (!selection.preview || suggestedLines.length <= selectedLineCount) {\n    return false;\n  }\n  const offset = selection.startLine - selection.rangeStartLine;\n  if (offset < 0) {\n    return false;\n  }\n  const previewLines = selection.preview.replace(/\\\\r\\\\n/g, \"\\\\n\").replace(/\\\\r/g, \"\\\\n\").split(\"\\\\n\");\n  const contextLines = [\n    offset > 0 ? previewLines[offset - 1] : undefined,\n    previewLines[offset + selectedLineCount],\n  ].filter((line): line is string => Boolean(line?.trim()));\n  return contextLines.some((line) => suggestedLines.includes(line));\n}\n\nfunction hasUnchangedSelectionEdge(originalLines: string[], suggestedLines: string[]): boolean {\n  const firstLineUnchanged = originalLines[0] === suggestedLines[0];\n  const lastLineUnchanged = originalLines.at(-1) === suggestedLines.at(-1);\n  if (originalLines.length === suggestedLines.length || originalLines.length === 1) {\n    return firstLineUnchanged || lastLineUnchanged;\n  }\n  return firstLineUnchanged && lastLineUnchanged;\n}\n\nfunction lastNonBlankLineIndex(lines: string[]): number {\n  for (let index = lines.length - 1; index >= 0; index -= 1) {\n    if (lines[index]?.trim() !== \"\") {\n      return index;\n    }\n  }\n  return -1;\n}\n\nfunction onlyChangesWhitespace(originalLines: string[], suggestedLines: string[]): boolean {\n  const original = originalLines.join(\"\\\\n\");\n  const suggested = suggestedLines.join(\"\\\\n\");\n  const originalScan = scanCodeWhitespace(original);\n  const suggestedScan = scanCodeWhitespace(suggested);\n  if (originalScan.containsCommentSyntax || suggestedScan.containsCommentSyntax) {\n    return false;\n  }\n  return originalScan.stripped === suggestedScan.stripped;\n}\n\nfunction scanCodeWhitespace(value: string): {\n  stripped: string;\n  containsCommentSyntax: boolean;\n} {\n  let result = \"\";\n  const state: CodeWhitespaceScanState = {\n    literalDelimiter: undefined,\n    escaped: false,\n    regexCharacterClass: false,\n    templateExpressionDepths: [],\n  };\n\n  for (let index = 0; index < value.length; index += 1) {\n    const char = value.charAt(index);\n    if (advanceCodeLiteralScan(state, char, value[index + 1])) {\n      result += char;\n      continue;\n    }\n    if (char === \"/\" && [\"/\", \"*\"].includes(value[index + 1] ?? \"\")) {\n      return { stripped: result, containsCommentSyntax: true };\n    }\n    if (/\\\\s/.test(char)) {\n      const nextNonWhitespace = value.slice(index + 1).match(/\\\\S/)?.[0];\n      result += codeTokenSeparator(result.at(-1), nextNonWhitespace);\n      continue;\n    }\n    advanceTemplateExpressionScan(state, char);\n    state.literalDelimiter ??= openingCodeLiteralDelimiter(char, value[index + 1], result);\n    state.regexCharacterClass = false;\n    result += char;\n  }\n\n  return { stripped: result, containsCommentSyntax: false };\n}\n\nfunction codeTokenSeparator(\n  previousChar: string | undefined,\n  nextChar: string | undefined,\n): string {\n  if (!previousChar || !nextChar) {\n    return \"\";\n  }\n  if (/[A-Za-z0-9_$]/.test(previousChar) && /[A-Za-z0-9_$]/.test(nextChar)) {\n    return \" \";\n  }\n  const requiresSeparator = [\"++\", \"--\", \"//\", \"/*\", \"**\", \"??\", \"?.\", \"=>\", \"==\", \"!=\", \"<=\", \">=\", \"&&\", \"||\", \"<<\", \">>\"].includes(\n    previousChar + nextChar,\n  );\n  return requiresSeparator ? \" \" : \"\";\n}\n\ntype CodeWhitespaceScanState = {\n  literalDelimiter: string | undefined;\n  escaped: boolean;\n  regexCharacterClass: boolean;\n  templateExpressionDepths: number[];\n};\n\nfunction advanceCodeLiteralScan(\n  state: CodeWhitespaceScanState,\n  char: string,\n  nextChar: string | undefined,\n): boolean {\n  if (!state.literalDelimiter) {\n    return false;\n  }\n  if (state.escaped) {\n    state.escaped = false;\n    return true;\n  }\n  if (char === \"\\\\\\\\\") {\n    state.escaped = true;\n    return true;\n  }\n  if (state.literalDelimiter.charCodeAt(0) === 96 && char === \"$\" && nextChar === \"{\") {\n    state.templateExpressionDepths.push(0);\n    state.literalDelimiter = undefined;\n    return true;\n  }\n  if (state.literalDelimiter !== \"/\") {\n    if (char === state.literalDelimiter) {\n      state.literalDelimiter = undefined;\n    }\n    return true;\n  }\n  advanceRegexLiteralScan(state, char);\n  return true;\n}\n\nfunction advanceTemplateExpressionScan(state: CodeWhitespaceScanState, char: string): void {\n  const depthIndex = state.templateExpressionDepths.length - 1;\n  const depth = state.templateExpressionDepths[depthIndex];\n  if (depth === undefined) {\n    return;\n  }\n  if (char === \"{\") {\n    state.templateExpressionDepths[depthIndex] = depth + 1;\n  } else if (char === \"}\") {\n    if (depth <= 1) {\n      state.templateExpressionDepths.pop();\n      state.literalDelimiter = \"\\`\";\n    } else {\n      state.templateExpressionDepths[depthIndex] = depth - 1;\n    }\n  }\n}\n\nfunction advanceRegexLiteralScan(state: CodeWhitespaceScanState, char: string): void {\n  if (char === \"[\") {\n    state.regexCharacterClass = true;\n  } else if (char === \"]\") {\n    state.regexCharacterClass = false;\n  } else if (char === \"/\" && !state.regexCharacterClass) {\n    state.literalDelimiter = undefined;\n  }\n}\n\nfunction openingCodeLiteralDelimiter(\n  char: string,\n  nextChar: string | undefined,\n  previousCode: string,\n): string | undefined {\n  if (char === '\"' || char === \"'\" || char.charCodeAt(0) === 96) {\n    return char;\n  }\n  return startsRegexLiteral(char, nextChar, previousCode) ? \"/\" : undefined;\n}\n\nfunction startsRegexLiteral(\n  char: string,\n  nextChar: string | undefined,\n  previousCode: string,\n): boolean {\n  const previousChar = previousCode.at(-1);\n  const previousWord = previousCode.split(/[^A-Za-z]+/).at(-1);\n  const followsRegexKeyword = [\n    \"return\",\n    \"throw\",\n    \"case\",\n    \"delete\",\n    \"void\",\n    \"typeof\",\n    \"instanceof\",\n    \"in\",\n    \"of\",\n    \"yield\",\n    \"await\",\n  ].includes(previousWord ?? \"\");\n  return (\n    char === \"/\" &&\n    nextChar !== \"/\" &&\n    nextChar !== \"*\" &&\n    (previousChar === undefined ||\n      \"([{:;,=!?&|+-*%^~<>)\".includes(previousChar) ||\n      followsRegexKeyword)\n  );\n}\n\nfunction suggestionIntroducesNewEnvironmentAccess(\n  preview: string | undefined,\n  suggestedFix: string,\n): boolean {\n  const suggestedKeys = environmentAccessKeys(suggestedFix);\n  if (suggestedKeys.size === 0) {\n    return false;\n  }\n  const existingKeys = environmentAccessKeys(preview ?? \"\");\n  return Array.from(suggestedKeys).some((key) => !existingKeys.has(key));\n}\n\nfunction environmentAccessKeys(value: string): Set<string> {\n  const environmentKeyAccessPattern =\n    /\\\\b(?:process|Bun|import\\\\.meta)(?:\\\\s*\\\\.|\\\\s*\\\\?\\\\.)\\\\s*env(?:\\\\s*(?:\\\\.|\\\\?\\\\.)\\\\s*([A-Za-z_][A-Za-z0-9_]*)|\\\\s*\\\\?\\\\.\\\\s*\\\\[\\\\s*[\"']([A-Za-z_][A-Za-z0-9_]*)[\"']\\\\s*\\\\]|\\\\s*\\\\[\\\\s*[\"']([A-Za-z_][A-Za-z0-9_]*)[\"']\\\\s*\\\\])|\\\\bDeno(?:\\\\s*\\\\.|\\\\s*\\\\?\\\\.)\\\\s*env(?:\\\\s*\\\\.|\\\\s*\\\\?\\\\.)\\\\s*get\\\\s*\\\\(\\\\s*[\"']([A-Za-z_][A-Za-z0-9_]*)[\"']\\\\s*\\\\)/g;\n  const keys = new Set<string>();\n  for (const match of value.matchAll(environmentKeyAccessPattern)) {\n    const key = match[1] ?? match[2] ?? match[3] ?? match[4];\n    if (key) {\n      keys.add(key);\n    }\n  }\n  const environmentDestructurePattern =\n    /\\\\{([^{}]*)\\\\}\\\\s*=\\\\s*(?:process|Bun|import\\\\.meta)(?:\\\\s*\\\\.|\\\\s*\\\\?\\\\.)\\\\s*env\\\\b/g;\n  for (const match of value.matchAll(environmentDestructurePattern)) {\n    const bindings = match[1]?.split(\",\") ?? [];\n    for (const binding of bindings) {\n      const key = binding.split(/[:=]/, 1)[0]?.trim().replace(/^[\"']|[\"']$/g, \"\");\n      if (key && /^[A-Za-z_][A-Za-z0-9_]*$/.test(key) && !key.startsWith(\"...\")) {\n        keys.add(key);\n      }\n    }\n  }\n  return keys;\n}\n\nfunction suggestionsTable(suggestions: FixSuggestion[]): string {\n  if (suggestions.length === 0) {\n    return [\n      \"| Category | Title |\",\n      \"| --- | --- |\",\n      \"| - | No exact suggested fixes found. |\",\n    ].join(\"\\\\n\");\n  }\n  return [\n    \"| Category | Title |\",\n    \"| --- | --- |\",\n    ...suggestions.map((suggestion) => {\n      const category = suggestion.category\n        .replaceAll(\"-\", \" \")\n        .replace(/^./, (char) => char.toUpperCase());\n      const title = suggestion.title.replaceAll(\"\\\\n\", \" \").replaceAll(\"|\", \"\\\\\\\\|\");\n      return \\`| \\${category} | \\${title} |\\`;\n    }),\n  ].join(\"\\\\n\");\n}\n`,\n} as const satisfies OfficialInitRecipe;\n","import type { OfficialInitRecipe } from \"./types.js\";\n\nexport const interactiveAskRecipe = {\n  id: \"interactive-ask\",\n  title: \"Interactive Ask\",\n  description: \"PR-Agent ask-style free-form command over diff and prior review context.\",\n  sourceTools: [\"PR-Agent /ask\"],\n  configTs: `import { definePipr } from \"@usepipr/sdk\";\n\nexport default definePipr((pipr) => {\n  const model = pipr.model({\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"high\" },\n  });\n\n  const askAgent = pipr.agent({\n    name: \"interactive-ask\",\n    model,\n    instructions: \\`\n      Answer the reviewer question directly using the current diff, repository,\n      and prior Pipr findings. Cite relevant paths or symbols when available.\n      Distinguish evidence from inference. When external systems or hidden state\n      are required, state precisely which missing context prevents an answer.\n    \\`,\n    output: pipr.schemas.summary,\n    prompt: (input: { question: string; manifest: unknown; prior: unknown }) => pipr.prompt\\`\n      \\${pipr.section(\"Question\", input.question)}\n      \\${pipr.section(\"Prior pipr review\", pipr.json(input.prior, { maxCharacters: 20000 }))}\n    \\`,\n  });\n\n  const task = pipr.task<{ question: string }>({\n    name: \"interactive-ask\",\n    async run(ctx, input) {\n      if (!ctx.command) {\n        throw new Error(\"interactive-ask is a command-only task\");\n      }\n      const manifest = await ctx.change.diffManifest({ compressed: true });\n      const prior = await ctx.review.prior();\n      const answer = await ctx.pi.run(askAgent, { question: input.question, manifest, prior });\n      await ctx.command.reply(answer.body);\n    },\n  });\n\n  pipr.command({\n    pattern: \"@pipr ask <question...>\",\n    permission: \"read\",\n    description: \"Ask a question about this change request.\",\n    parse: (args) => ({ question: args.question ?? \"\" }),\n    task,\n  });\n});\n`,\n} as const satisfies OfficialInitRecipe;\n","import type { OfficialInitRecipe } from \"./types.js\";\n\nexport const multiAgentReviewRecipe = {\n  id: \"multi-agent-review\",\n  title: \"Multi-agent Review\",\n  description: \"Security, test, and maintainability agents with an aggregator agent.\",\n  sourceTools: [\"PR-Agent\", \"CodeRabbit\", \"GitHub Copilot code review\"],\n  configTs: `import { definePipr } from \"@usepipr/sdk\";\n\nexport default definePipr((pipr) => {\n  const primary = pipr.model({\n    id: \"deepseek/deepseek-v4-pro-primary\",\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"high\" },\n  });\n\n  const fast = pipr.model({\n    id: \"deepseek/deepseek-v4-pro-fast\",\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"medium\" },\n  });\n\n  const specialistPrompt = (input: { manifest: unknown; focus: string }) => pipr.prompt\\`\n    \\${pipr.section(\"Focus\", input.focus)}\n  \\`;\n\n  const security = pipr.agent({\n    name: \"security-specialist\",\n    model: primary,\n    instructions:\n      \"Report only exploitable security paths introduced or weakened by the change. Ignore non-security and style feedback.\",\n    output: pipr.schemas.review,\n    tools: pipr.tools.readOnly,\n    prompt: specialistPrompt,\n  });\n  const strictSecurity = security.extend({\n    instructions: \"Prioritize directly exploitable paths and suppress speculative findings.\",\n  });\n  const tests = pipr.agent({\n    name: \"test-specialist\",\n    model: fast,\n    instructions:\n      \"Report only meaningful regression gaps where changed behavior lacks evidence that would catch a concrete failure.\",\n    output: pipr.schemas.review,\n    tools: pipr.tools.readOnly,\n    prompt: specialistPrompt,\n  });\n  const maintainability = pipr.agent({\n    name: \"maintainability-specialist\",\n    model: primary,\n    instructions:\n      \"Report only changed complexity, duplication, or brittle contracts that create a concrete correctness or reliability risk. Ignore cleanup preferences.\",\n    output: pipr.schemas.review,\n    tools: pipr.tools.readOnly,\n    prompt: specialistPrompt,\n  });\n\n  const aggregator = pipr.agent({\n    name: \"review-aggregator\",\n    model: primary,\n    fallbacks: [fast],\n    instructions: \\`\n      Merge specialist reviews into one concise review. Deduplicate findings,\n      then independently revalidate changed-code causality, concrete impact,\n      relevant contract and test context, and exact inline anchoring. Drop\n      unsupported, conflicting, duplicate, speculative, or style-only items.\n    \\`,\n    output: pipr.schemas.review,\n    tools: pipr.tools.readOnly,\n    prompt: (input: { manifest: unknown; specialistResults: unknown; prior: unknown }) => pipr.prompt\\`\n      \\${pipr.section(\"Prior pipr review\", pipr.json(input.prior, { maxCharacters: 20000 }))}\n      \\${pipr.section(\"Specialist results\", pipr.json(input.specialistResults, { maxCharacters: 60000 }))}\n    \\`,\n    retry: { invalidOutput: 1, transientFailure: 1 },\n    timeout: \"6m\",\n  });\n\n  const task = pipr.task({\n    name: \"multi-agent-review\",\n    check: { enabled: true, name: \"multi-agent review\", required: true },\n    async run(ctx) {\n      const manifest = await ctx.change.diffManifest({ compressed: true });\n      const prior = await ctx.review.prior();\n      const [securityResult, testResult, maintainabilityResult] = await Promise.all([\n        ctx.pi.run(strictSecurity, { manifest, focus: \"security\" }, { model: primary, fallbacks: [fast] }),\n        ctx.pi.run(tests, { manifest, focus: \"tests\" }, { model: fast, fallbacks: [primary] }),\n        ctx.pi.run(maintainability, { manifest, focus: \"maintainability\" }),\n      ]);\n      const result = await ctx.pi.run(aggregator, {\n        manifest,\n        specialistResults: { securityResult, testResult, maintainabilityResult },\n        prior,\n      });\n      ctx.check.pass(\"Multi-agent review completed.\");\n      await ctx.comment({\n        main: result.summary.body,\n        inlineFindings: result.inlineFindings,\n      });\n    },\n  });\n\n  pipr.on.changeRequest({ actions: [\"opened\", \"updated\", \"reopened\", \"ready\"], task });\n  pipr.command({ pattern: \"@pipr multi\", permission: \"write\", task });\n});\n`,\n} as const satisfies OfficialInitRecipe;\n","import type { OfficialInitRecipe } from \"./types.js\";\n\nconst r2MemoryTs = `import { S3Client } from \"bun\";\nimport { definePlugin, type SecretRef, type TaskContext, z } from \"@usepipr/sdk\";\n\nconst memoryItem = z.strictObject({\n  subject: z.string(),\n  body: z.string(),\n  tags: z.array(z.string()).optional(),\n  updatedAt: z.string().optional(),\n});\n\nconst memorySearchInput = z.strictObject({\n  query: z.string(),\n  limit: z.number().optional(),\n});\n\nconst memoryStoreInput = z.strictObject({\n  subject: z.string(),\n  body: z.string(),\n  tags: z.array(z.string()).optional(),\n});\n\ntype MemoryItem = ReturnType<typeof memoryItem.parse>;\ntype MemorySearchInput = ReturnType<typeof memorySearchInput.parse>;\ntype MemoryStoreInput = ReturnType<typeof memoryStoreInput.parse>;\n\nexport type R2MemoryOptions = {\n  bucket: SecretRef;\n  endpoint: SecretRef;\n  accessKeyId: SecretRef;\n  secretAccessKey: SecretRef;\n  sessionToken?: SecretRef;\n  region?: string;\n  prefix?: string;\n};\n\nexport function r2MemoryPlugin(options: R2MemoryOptions) {\n  return definePlugin((pipr) => {\n    const searchInput = pipr.schema({\n      id: \"memory/search-input\",\n      schema: memorySearchInput,\n    });\n    const searchOutput = pipr.schema({\n      id: \"memory/search-output\",\n      schema: z.strictObject({\n        memories: z.array(memoryItem),\n      }),\n    });\n    const storeInput = pipr.schema({\n      id: \"memory/store-input\",\n      schema: memoryStoreInput,\n    });\n    const storeOutput = pipr.schema({\n      id: \"memory/store-output\",\n      schema: z.strictObject({\n        stored: z.boolean(),\n        key: z.string(),\n      }),\n    });\n\n    return {\n      search: pipr.tool({\n        name: \"r2_memory_search\",\n        description: \"Search durable reviewer memory stored in Cloudflare R2.\",\n        input: searchInput,\n        output: searchOutput,\n        async run({ input, ctx, signal }) {\n          return await searchMemory(input, ctx, options, signal);\n        },\n        toModelOutput(output) {\n          return output;\n        },\n      }),\n      store: pipr.tool({\n        name: \"r2_memory_store\",\n        description: \"Store reusable, non-sensitive reviewer memory in Cloudflare R2.\",\n        input: storeInput,\n        output: storeOutput,\n        async run({ input, ctx, signal }) {\n          return await storeMemory(input, ctx, options, signal);\n        },\n        toModelOutput(output) {\n          return output;\n        },\n      }),\n    };\n  });\n}\n\nasync function searchMemory(\n  input: MemorySearchInput,\n  ctx: TaskContext,\n  options: R2MemoryOptions,\n  signal?: AbortSignal,\n): Promise<{ memories: MemoryItem[] }> {\n  signal?.throwIfAborted();\n  const bucket = r2Bucket(ctx, options);\n  const listed = await bucket.list({ prefix: memoryPrefix(ctx, options) + \"/\", maxKeys: 200 });\n  const memories: MemoryItem[] = [];\n\n  for (const object of listed.contents ?? []) {\n    signal?.throwIfAborted();\n    try {\n      const value = memoryItem.parse(await bucket.file(object.key).json());\n      if (matchesMemory(value, input.query)) {\n        memories.push(value);\n      }\n    } catch {\n      // Ignore malformed or concurrently deleted memory objects.\n    }\n  }\n\n  const limit = Math.min(Math.max(Math.trunc(input.limit ?? 5), 1), 20);\n  return {\n    memories: memories\n      .sort((left, right) => (right.updatedAt ?? \"\").localeCompare(left.updatedAt ?? \"\"))\n      .slice(0, limit),\n  };\n}\n\nasync function storeMemory(\n  input: MemoryStoreInput,\n  ctx: TaskContext,\n  options: R2MemoryOptions,\n  signal?: AbortSignal,\n): Promise<{ stored: boolean; key: string }> {\n  signal?.throwIfAborted();\n  const bucket = r2Bucket(ctx, options);\n  const entry: MemoryItem = { ...input, updatedAt: new Date().toISOString() };\n  const key = memoryKey(input.subject, ctx, options);\n  await bucket.write(key, JSON.stringify(entry, null, 2), { type: \"application/json\" });\n  return { stored: true, key };\n}\n\nfunction r2Bucket(ctx: TaskContext, options: R2MemoryOptions): S3Client {\n  return new S3Client({\n    bucket: ctx.secret(options.bucket),\n    endpoint: ctx.secret(options.endpoint),\n    accessKeyId: ctx.secret(options.accessKeyId),\n    secretAccessKey: ctx.secret(options.secretAccessKey),\n    region: options.region ?? \"auto\",\n    sessionToken: options.sessionToken ? ctx.secret(options.sessionToken) : undefined,\n  });\n}\n\nfunction memoryPrefix(ctx: TaskContext, options: R2MemoryOptions): string {\n  return cleanPathSegment(options.prefix ?? \"pipr-memory\") + \"/\" + repositoryScope(ctx);\n}\n\nfunction repositoryScope(ctx: TaskContext): string {\n  return cleanPathSegment([ctx.repository.owner, ctx.repository.name].filter(Boolean).join(\"/\"));\n}\n\nfunction cleanPathSegment(value: string): string {\n  return (\n    value\n      .toLowerCase()\n      .replace(/[^a-z0-9/_-]+/g, \"-\")\n      .replace(/^\\\\/+|\\\\/+$/g, \"\") || \"pipr-memory\"\n  );\n}\n\nfunction memoryKey(subject: string, ctx: TaskContext, options: R2MemoryOptions): string {\n  const slug = subject\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-|-$/g, \"\")\n    .slice(0, 60);\n  return (\n    memoryPrefix(ctx, options) + \"/\" + new Date().toISOString() + \"-\" + (slug || \"memory\") + \".json\"\n  );\n}\n\nfunction matchesMemory(item: MemoryItem, query: string): boolean {\n  const haystack = [item.subject, item.body, ...(item.tags ?? [])].join(\"\\\\n\").toLowerCase();\n  const terms = query\n    .toLowerCase()\n    .split(/[^a-z0-9/_-]+/g)\n    .filter((term) => term.length >= 3)\n    .slice(0, 40);\n  return terms.length === 0 || terms.some((term) => haystack.includes(term));\n}\n`;\n\nexport const pluginToolReviewRecipe = {\n  id: \"plugin-tool-review\",\n  title: \"Plugin Tool Review\",\n  description:\n    \"Typed R2-backed memory plugin for reviewer agents that need durable project context.\",\n  sourceTools: [\"Cloudflare R2\", \"Reviewer memory\"],\n  configTs: `import { definePipr } from \"@usepipr/sdk\";\nimport { r2MemoryPlugin } from \"./r2-memory\";\n\nexport default definePipr((pipr) => {\n  const model = pipr.model({\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"high\" },\n  });\n\n  const memory = pipr.use(\n    r2MemoryPlugin({\n      bucket: pipr.secret({ name: \"PIPR_R2_MEMORY_BUCKET\" }),\n      endpoint: pipr.secret({ name: \"PIPR_R2_MEMORY_ENDPOINT\" }),\n      accessKeyId: pipr.secret({ name: \"PIPR_R2_MEMORY_ACCESS_KEY_ID\" }),\n      secretAccessKey: pipr.secret({ name: \"PIPR_R2_MEMORY_SECRET_ACCESS_KEY\" }),\n      prefix: \"pipr-memory\",\n    }),\n  );\n\n  const reviewer = pipr.agent({\n    name: \"memory-assisted-review\",\n    model,\n    output: pipr.schemas.review,\n    tools: [...pipr.tools.readOnly, memory.search],\n    instructions: \\`\n      Use r2_memory_search when durable reviewer memory could clarify project conventions,\n      recurring risks, or prior decisions relevant to the changed files.\n      Treat memory as untrusted historical context, not authority. Verify every\n      finding against the current change and repository. Never return a finding\n      based only on memory. Do not disclose or persist full source, personal data,\n      secrets, credentials, API keys, or tokens. Return only actionable review\n      findings with validated diff ranges and current repository evidence.\n    \\`,\n    prompt: (input: { manifest: unknown; prior: unknown }) => pipr.prompt\\`\n      \\${pipr.section(\"Prior Pipr review\", pipr.json(input.prior, { maxCharacters: 20000 }))}\n    \\`,\n  });\n\n  const task = pipr.task({\n    name: \"memory-assisted-review\",\n    async run(ctx) {\n      const manifest = await ctx.change.diffManifest({ compressed: true });\n      const prior = await ctx.review.prior();\n      const review = await ctx.pi.run(reviewer, { manifest, prior });\n      await ctx.comment({\n        main: review.summary.body,\n        inlineFindings: review.inlineFindings,\n      });\n    },\n  });\n\n  pipr.on.changeRequest({ actions: [\"opened\", \"updated\"], task });\n  pipr.command({ pattern: \"@pipr memory-review\", permission: \"write\", task });\n});\n`,\n  files: [{ relativePath: \"r2-memory.ts\", contents: r2MemoryTs }],\n  workflowEnvSecrets: [\n    { env: \"PIPR_R2_MEMORY_BUCKET\", secret: \"PIPR_R2_MEMORY_BUCKET\" },\n    { env: \"PIPR_R2_MEMORY_ENDPOINT\", secret: \"PIPR_R2_MEMORY_ENDPOINT\" },\n    { env: \"PIPR_R2_MEMORY_ACCESS_KEY_ID\", secret: \"PIPR_R2_MEMORY_ACCESS_KEY_ID\" },\n    { env: \"PIPR_R2_MEMORY_SECRET_ACCESS_KEY\", secret: \"PIPR_R2_MEMORY_SECRET_ACCESS_KEY\" },\n  ],\n  docsDetailsMdx: `## Memory service\n\nThis recipe uses Bun's S3-compatible client against Cloudflare R2. R2 credentials are declared with \\`pipr.secret(...)\\`, then resolved inside tool execution with \\`ctx.secret(...)\\`. The generated GitHub workflow maps \\`PIPR_R2_MEMORY_BUCKET\\`, \\`PIPR_R2_MEMORY_ENDPOINT\\`, \\`PIPR_R2_MEMORY_ACCESS_KEY_ID\\`, and \\`PIPR_R2_MEMORY_SECRET_ACCESS_KEY\\` repository secrets into matching runtime environment variables.\n\nR2 is object storage, not a search index. The sample lists recent JSON memory objects under \\`prefix/repository-owner/repository-name\\` and filters them locally, which is enough for small reviewer-memory sets. Change \\`prefix\\` in \\`.pipr/config.ts\\` when multiple repositories share one bucket; Pipr still adds the repository scope below it. The generated reviewer treats memory as untrusted historical context and requires current repository evidence for findings. It only searches memory by default. The store tool is available for explicit customization, but full review summaries are not persisted automatically.\n\n`,\n} as const satisfies OfficialInitRecipe;\n","import type { OfficialInitRecipe } from \"./types.js\";\n\nexport const prBriefingRecipe = {\n  id: \"pr-briefing\",\n  title: \"PR Briefing\",\n  description: \"PR-Agent describe-style overview, risk summary, and walkthrough.\",\n  sourceTools: [\"PR-Agent /describe\", \"CodeRabbit PR summaries\"],\n  configTs: `import { definePipr, z } from \"@usepipr/sdk\";\n\nexport default definePipr((pipr) => {\n  const model = pipr.model({\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"medium\" },\n  });\n\n  pipr.config({ publication: { maxInlineComments: 0 } });\n\n  const briefingSchema = z.strictObject({\n    summary: z.string(),\n    prType: z.enum([\"feature\", \"bugfix\", \"refactor\", \"docs\", \"tests\", \"dependency\", \"infra\", \"mixed\"]),\n    riskLevel: z.enum([\"low\", \"medium\", \"high\"]),\n    riskSummary: z.string(),\n    changeMap: z.array(z.strictObject({\n      area: z.string(),\n      files: z.array(z.string()).max(4),\n      change: z.string(),\n    })).max(6),\n    reviewerFocus: z.array(z.string()).max(4),\n    notableFiles: z.array(z.strictObject({\n      path: z.string(),\n      reason: z.string(),\n    })).max(6),\n    walkthrough: z.array(z.string()).max(6),\n    diagramMermaid: z.string().optional(),\n  });\n\n  type Briefing = z.infer<typeof briefingSchema>;\n\n  const briefingOutput = pipr.schema({\n    id: \"briefing/pr-reviewer\",\n    schema: briefingSchema,\n  });\n\n  const briefing = pipr.agent({\n    name: \"pr-briefing\",\n    model,\n    instructions: \\`\n      Produce a maintainer briefing instead of a defect hunt. Summarize what changed,\n      classify the PR type, explain review risk, list notable files, and include\n      a concise reviewer walkthrough. Use reviewerFocus for what humans should\n      inspect first. Use diagramMermaid only when a small flowchart clarifies\n      multi-step control flow, data flow, or package boundaries; omit it for\n      straightforward changes. Ground every file and claim in the Diff Manifest\n      and change metadata. Walkthrough items must explain behavior flow rather\n      than repeat file lists. Return empty arrays for list sections with no useful content;\n      the renderer omits those empty sections. Do not report inline findings.\n    \\`,\n    output: briefingOutput,\n    tools: pipr.tools.readOnly,\n    retry: { invalidOutput: 1, transientFailure: 1 },\n    timeout: \"7m\",\n    prompt: () => \"Prepare a maintainer briefing for this change request.\",\n  });\n\n  const task = pipr.task({\n    name: \"pr-briefing\",\n    async run(ctx) {\n      const manifest = await ctx.change.diffManifest({ compressed: true });\n      const result = await ctx.pi.run(briefing, { manifest });\n      const sections = [\n        overviewTable(result, ctx.change.title),\n        \"\",\n        \"## Summary\",\n        \"\",\n        result.summary,\n      ];\n      if (result.changeMap.length > 0) {\n        sections.push(\"\", \"## Change Map\", \"\", changeMapTable(result.changeMap));\n      }\n      if (result.reviewerFocus.length > 0) {\n        sections.push(\n          \"\",\n          \"## Reviewer Focus\",\n          \"\",\n          result.reviewerFocus.map((item) => \\`- \\${item}\\`).join(\"\\\\n\"),\n        );\n      }\n      if (result.notableFiles.length > 0) {\n        sections.push(\"\", \"## Notable Files\", \"\", notableFilesTable(result.notableFiles));\n      }\n      if (result.walkthrough.length > 0) {\n        sections.push(\n          \"\",\n          \"## Walkthrough\",\n          \"\",\n          result.walkthrough.map((item) => \\`- \\${item}\\`).join(\"\\\\n\"),\n        );\n      }\n      const diagram = diagramBlock(result.diagramMermaid);\n      if (diagram) {\n        sections.push(\"\", diagram);\n      }\n      await ctx.comment(sections.join(\"\\\\n\"));\n    },\n  });\n\n  pipr.on.changeRequest({ actions: [\"opened\", \"updated\", \"reopened\", \"ready\"], task });\n  pipr.command({\n    pattern: \"@pipr describe\",\n    permission: \"read\",\n    description: \"Generate a reviewer briefing for this change request.\",\n    task,\n  });\n});\n\nfunction overviewTable(briefing: Briefing, title: string): string {\n  const titleCell = title.replaceAll(\"\\\\n\", \" \").replaceAll(\"|\", \"\\\\\\\\|\");\n  const prType = briefing.prType.replaceAll(\"-\", \" \").replace(/^./, (char) => char.toUpperCase());\n  const riskLevel = briefing.riskLevel\n    .replaceAll(\"-\", \" \")\n    .replace(/^./, (char) => char.toUpperCase());\n  const riskSummary = briefing.riskSummary.replaceAll(\"\\\\n\", \" \").replaceAll(\"|\", \"\\\\\\\\|\");\n  return [\n    \"| Change | Type | Risk | Risk summary |\",\n    \"| --- | --- | --- | --- |\",\n    \\`| \\${titleCell} | \\${prType} | \\${riskLevel} | \\${riskSummary} |\\`,\n  ].join(\"\\\\n\");\n}\n\nfunction changeMapTable(changeMap: Briefing[\"changeMap\"]): string {\n  if (changeMap.length === 0) {\n    return [\n      \"| Area | Files | Change |\",\n      \"| --- | --- | --- |\",\n      \"| - | - | No changed areas summarized. |\",\n    ].join(\"\\\\n\");\n  }\n  return [\n    \"| Area | Files | Change |\",\n    \"| --- | --- | --- |\",\n    ...changeMap.map((item) => {\n      const area = item.area.replaceAll(\"\\\\n\", \" \").replaceAll(\"|\", \"\\\\\\\\|\");\n      const files = item.files.join(\"<br>\").replaceAll(\"\\\\n\", \" \").replaceAll(\"|\", \"\\\\\\\\|\");\n      const change = item.change.replaceAll(\"\\\\n\", \" \").replaceAll(\"|\", \"\\\\\\\\|\");\n      return \\`| \\${area} | \\${files} | \\${change} |\\`;\n    }),\n  ].join(\"\\\\n\");\n}\n\nfunction notableFilesTable(files: Briefing[\"notableFiles\"]): string {\n  if (files.length === 0) {\n    return [\n      \"| File | Why it matters |\",\n      \"| --- | --- |\",\n      \"| - | No notable files called out. |\",\n    ].join(\"\\\\n\");\n  }\n  return [\n    \"| File | Why it matters |\",\n    \"| --- | --- |\",\n    ...files.map((file) => {\n      const filePath = file.path.replaceAll(\"\\\\n\", \" \").replaceAll(\"|\", \"\\\\\\\\|\");\n      const reason = file.reason.replaceAll(\"\\\\n\", \" \").replaceAll(\"|\", \"\\\\\\\\|\");\n      return \\`| \\${filePath} | \\${reason} |\\`;\n    }),\n  ].join(\"\\\\n\");\n}\n\nfunction diagramBlock(diagramMermaid: string | undefined): string {\n  const diagram = diagramMermaid?.trim();\n  if (!diagram) {\n    return \"\";\n  }\n  const fence = markdownFenceFor(diagram);\n  return [\n    \"<details>\",\n    \"<summary>Flow diagram</summary>\",\n    \"\",\n    \\`\\${fence}mermaid\\`,\n    diagram,\n    fence,\n    \"\",\n    \"</details>\",\n  ].join(\"\\\\n\");\n}\n\nfunction markdownFenceFor(value: string): string {\n  const longestBacktickRun = Math.max(\n    0,\n    ...[...value.matchAll(/\\`+/g)].map((match) => match[0].length),\n  );\n  return \"\\`\".repeat(Math.max(3, longestBacktickRun + 1));\n}\n`,\n} as const satisfies OfficialInitRecipe;\n","import type { OfficialInitRecipe } from \"./types.js\";\n\nexport const prHygieneRecipe = {\n  id: \"pr-hygiene\",\n  title: \"PR Hygiene\",\n  description: \"Change request hygiene checks for tests, docs, lockfiles, and size.\",\n  sourceTools: [\"Danger JS\"],\n  configTs: `import { definePipr, z } from \"@usepipr/sdk\";\nimport type { ReviewFinding } from \"@usepipr/sdk\";\n\nexport default definePipr((pipr) => {\n  const model = pipr.model({\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"medium\" },\n  });\n\n  pipr.config({ publication: { maxInlineComments: 5 } });\n\n  const hygienePolicySchema = z.enum([\n    \"tests\",\n    \"docs\",\n    \"lockfiles\",\n    \"generated-files\",\n    \"change-size\",\n  ]);\n\n  const policyCheckSchema = z.strictObject({\n    policy: hygienePolicySchema,\n    status: z.enum([\"pass\", \"attention\", \"not-applicable\"]),\n    evidence: z.string(),\n  });\n\n  const policyCheckFor = <const Policy extends z.infer<typeof hygienePolicySchema>>(\n    policy: Policy,\n  ) => policyCheckSchema.extend({ policy: z.literal(policy) });\n\n  const policyChecksSchema = z.tuple([\n    policyCheckFor(\"tests\"),\n    policyCheckFor(\"docs\"),\n    policyCheckFor(\"lockfiles\"),\n    policyCheckFor(\"generated-files\"),\n    policyCheckFor(\"change-size\"),\n  ]);\n\n  const hygieneFindingSchema = z.strictObject({\n    title: z.string(),\n    policy: hygienePolicySchema,\n    body: z.string(),\n    path: z.string(),\n    rangeId: z.string(),\n    side: z.enum([\"RIGHT\", \"LEFT\"]),\n    startLine: z.number().int().positive(),\n    endLine: z.number().int().positive(),\n    suggestedFix: z.string().optional(),\n  });\n\n  type PolicyCheck = z.infer<typeof policyChecksSchema>[number];\n\n  const hygieneOutput = pipr.schema({\n    id: \"review/pr-hygiene\",\n    schema: z.strictObject({\n      summary: z.string(),\n      checks: policyChecksSchema,\n      findings: z.array(hygieneFindingSchema),\n    }),\n  });\n\n  const hygiene = pipr.agent({\n    name: \"pr-hygiene\",\n    model,\n    instructions: \\`\n      Review change request hygiene, not code correctness. Evaluate tests, docs,\n      lockfiles, generated files, and change size. Return exactly one policy\n      check for each policy, using not-applicable when it does not apply. Ground\n      evidence in changed files or counts. Use policy attention for file-level\n      gaps; return inline findings only for concrete gaps in exact changed lines.\n    \\`,\n    output: hygieneOutput,\n    tools: pipr.tools.readOnly,\n    retry: { invalidOutput: 1, transientFailure: 1 },\n    timeout: \"6m\",\n    prompt: () => \"Check this change request for repository hygiene and merge readiness.\",\n  });\n\n  const task = pipr.task({\n    name: \"pr-hygiene\",\n    check: { enabled: true, name: \"pr hygiene\", required: false },\n    async run(ctx) {\n      const changedFiles = await ctx.change.changedFiles();\n      ctx.log.info(\\`Checking PR hygiene for \\${changedFiles.length} changed file(s).\\`);\n      const manifest = await ctx.change.diffManifest({ compressed: true, maxPreviewLines: 80 });\n      const result = await ctx.pi.run(hygiene, { manifest, changedFiles });\n      const inlineFindings: ReviewFinding[] = result.findings.map((finding) => {\n        const policy = finding.policy\n          .replaceAll(\"-\", \" \")\n          .replace(/^./, (char) => char.toUpperCase());\n        return {\n          body: \\`**\\${policy}:** \\${finding.title}. \\${finding.body}\\`,\n          path: finding.path,\n          rangeId: finding.rangeId,\n          side: finding.side,\n          startLine: finding.startLine,\n          endLine: finding.endLine,\n          ...(finding.suggestedFix ? { suggestedFix: finding.suggestedFix } : {}),\n        };\n      });\n      const attentionCount = result.checks.filter((check) => check.status === \"attention\").length;\n      if (attentionCount > 0) {\n        const noun = attentionCount === 1 ? \"check\" : \"checks\";\n        const verb = attentionCount === 1 ? \"needs\" : \"need\";\n        ctx.check.neutral(attentionCount + \" hygiene \" + noun + \" \" + verb + \" attention.\");\n      } else {\n        ctx.check.pass(\"PR hygiene review completed.\");\n      }\n      await ctx.comment({\n        main: [\n          result.summary,\n          \"\",\n          \"## Policy Checks\",\n          \"\",\n          policyTable(result.checks),\n        ].join(\"\\\\n\"),\n        inlineFindings,\n      });\n    },\n  });\n\n  pipr.on.changeRequest({ actions: [\"opened\", \"updated\", \"reopened\", \"ready\"], task });\n  pipr.command({ pattern: \"@pipr hygiene\", permission: \"write\", task });\n});\n\nfunction policyTable(checks: PolicyCheck[]): string {\n  if (checks.length === 0) {\n    return [\n      \"| Policy | Status | Evidence |\",\n      \"| --- | --- | --- |\",\n      \"| - | Not applicable | No policy checks were relevant. |\",\n    ].join(\"\\\\n\");\n  }\n  return [\n    \"| Policy | Status | Evidence |\",\n    \"| --- | --- | --- |\",\n    ...checks.map((check) => {\n      const policy = check.policy\n        .replaceAll(\"-\", \" \")\n        .replace(/^./, (char) => char.toUpperCase());\n      const status = check.status\n        .replaceAll(\"-\", \" \")\n        .replace(/^./, (char) => char.toUpperCase());\n      const evidence = check.evidence.replaceAll(\"\\\\n\", \" \").replaceAll(\"|\", \"\\\\\\\\|\");\n      return \\`| \\${policy} | \\${status} | \\${evidence} |\\`;\n    }),\n  ].join(\"\\\\n\");\n}\n\n`,\n} as const satisfies OfficialInitRecipe;\n","import type { OfficialInitRecipe } from \"./types.js\";\n\nexport const qualityGateRecipe = {\n  id: \"quality-gate\",\n  title: \"Quality Gate\",\n  description: \"Required review check that fails on blocking correctness and test risks.\",\n  sourceTools: [\"SonarQube\", \"Snyk\"],\n  configTs: `import { definePipr, z } from \"@usepipr/sdk\";\nimport type { CommentableRange, DiffManifest, ReviewFinding } from \"@usepipr/sdk\";\n\nexport default definePipr((pipr) => {\n  const model = pipr.model({\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"high\" },\n  });\n\n  pipr.config({\n    publication: {\n      maxInlineComments: 6,\n      autoResolve: {\n        enabled: true,\n        model,\n        instructions:\n          \"Resolve only when current-head evidence proves the original concrete risk no longer applies; otherwise return unknown.\",\n        synchronize: true,\n        userReplies: { enabled: true, allowedActors: \"write\" },\n      },\n    },\n    checks: {\n      aggregate: { enabled: true, name: \"pipr quality gate\" },\n    },\n    limits: {\n      timeoutSeconds: 420,\n      diffManifest: {\n        fullMaxEstimatedTokens: 32000,\n        condensedMaxEstimatedTokens: 64000,\n      },\n    },\n  });\n\n  const blockerSchema = z.strictObject({\n    title: z.string(),\n    category: z.enum([\"correctness\", \"security\", \"reliability\", \"test-coverage\"]),\n    impact: z.string(),\n    body: z.string(),\n    path: z.string(),\n    rangeId: z.string(),\n    side: z.enum([\"RIGHT\", \"LEFT\"]),\n    startLine: z.number().int().positive(),\n    endLine: z.number().int().positive(),\n    suggestedFix: z.string().optional(),\n  });\n\n  type QualityBlocker = z.infer<typeof blockerSchema>;\n\n  const qualityGateOutput = pipr.schema({\n    id: \"review/quality-gate\",\n    schema: z.strictObject({\n      summary: z.string(),\n      blockers: z.array(blockerSchema),\n    }),\n  });\n\n  const reviewer = pipr.agent({\n    name: \"quality-gate\",\n    model,\n    instructions: \\`\n      Act as a merge quality gate. Report only blocking correctness, security,\n      reliability, or test coverage issues that must prevent merge. A blocker\n      must have a concrete changed-code range and an impact that maintainers can\n      verify through the changed contract, relevant callers, or tests. If no\n      blocking issue exists, return an empty blockers array.\n    \\`,\n    output: qualityGateOutput,\n    tools: pipr.tools.readOnly,\n    retry: { invalidOutput: 1, transientFailure: 1 },\n    timeout: \"7m\",\n    prompt: () => \"Run the required quality gate for this change request.\",\n  });\n\n  const task = pipr.task({\n    name: \"quality-gate\",\n    check: { enabled: true, name: \"quality gate\", required: true },\n    async run(ctx) {\n      const manifest = await ctx.change.diffManifest({ compressed: true });\n      const result = await ctx.pi.run(reviewer, { manifest });\n      const commentableBlockers = filterCommentableBlockers(result.blockers, manifest);\n      const droppedBlockerCount = result.blockers.length - commentableBlockers.length;\n      const inlineFindings: ReviewFinding[] = commentableBlockers.map((blocker) => {\n        const category = blocker.category\n          .replaceAll(\"-\", \" \")\n          .replace(/^./, (char) => char.toUpperCase());\n        return {\n          body: \\`**\\${category} blocker:** \\${blocker.title}. \\${blocker.body}\\`,\n          path: blocker.path,\n          rangeId: blocker.rangeId,\n          side: blocker.side,\n          startLine: blocker.startLine,\n          endLine: blocker.endLine,\n          ...(blocker.suggestedFix ? { suggestedFix: blocker.suggestedFix } : {}),\n        };\n      });\n\n      if (commentableBlockers.length > 0) {\n        const issueNoun = commentableBlockers.length === 1 ? \"issue\" : \"issues\";\n        ctx.check.fail(\\`\\${commentableBlockers.length} blocking quality \\${issueNoun} found.\\`);\n      } else {\n        ctx.check.pass(\"No blocking quality issues found.\");\n      }\n\n      await ctx.comment({\n        main: [\n          statusTable(commentableBlockers),\n          \"\",\n          droppedBlockersNote(droppedBlockerCount),\n          \"\",\n          result.summary,\n          \"\",\n          \"## Blocking Findings\",\n          \"\",\n          blockersTable(commentableBlockers),\n          \"\",\n          \"## Category Breakdown\",\n          \"\",\n          categoryBreakdownTable(commentableBlockers),\n        ].join(\"\\\\n\"),\n        inlineFindings,\n      });\n    },\n  });\n\n  pipr.on.changeRequest({ actions: [\"opened\", \"updated\", \"reopened\", \"ready\"], task });\n  pipr.command({ pattern: \"@pipr quality\", permission: \"write\", task });\n});\n\ntype FindingAnchor = Pick<ReviewFinding, \"path\" | \"rangeId\" | \"side\" | \"startLine\" | \"endLine\">;\n\nfunction filterCommentableBlockers(\n  blockers: QualityBlocker[],\n  manifest: DiffManifest,\n): QualityBlocker[] {\n  const seen = new Set<string>();\n  return blockers.filter((blocker) => {\n    if (!commentableRangeForFinding(blocker, manifest)) {\n      return false;\n    }\n    const key = [\n      blocker.path,\n      blocker.rangeId,\n      blocker.side,\n      blocker.startLine,\n      blocker.endLine,\n      blocker.body,\n    ].join(\"\\\\n\");\n    if (seen.has(key)) {\n      return false;\n    }\n    seen.add(key);\n    return true;\n  });\n}\n\nfunction commentableRangeForFinding(\n  finding: FindingAnchor,\n  manifest: DiffManifest,\n): CommentableRange | undefined {\n  for (const file of manifest.files) {\n    const range = file.commentableRanges.find((candidate) => candidate.id === finding.rangeId);\n    if (!range) {\n      continue;\n    }\n    return finding.rangeId === range.id &&\n      finding.path === range.path &&\n      finding.side === range.side &&\n      finding.startLine <= finding.endLine &&\n      finding.startLine >= range.startLine &&\n      finding.endLine <= range.endLine\n      ? range\n      : undefined;\n  }\n  return undefined;\n}\n\nfunction statusTable(blockers: QualityBlocker[]): string {\n  return [\n    \"| Status | Blocking findings | Categories |\",\n    \"| --- | ---: | --- |\",\n    \\`| \\${blockers.length === 0 ? \"Pass\" : \"Fail\"} | \\${blockers.length} | \\${categorySummary(\n      blockers,\n    )} |\\`,\n  ].join(\"\\\\n\");\n}\n\nfunction blockersTable(blockers: QualityBlocker[]): string {\n  if (blockers.length === 0) {\n    return [\n      \"| Category | Title | Impact |\",\n      \"| --- | --- | --- |\",\n      \"| - | No blocking findings. | - |\",\n    ].join(\"\\\\n\");\n  }\n  return [\n    \"| Category | Title | Impact |\",\n    \"| --- | --- | --- |\",\n    ...blockers.map((blocker) => {\n      const category = blocker.category\n        .replaceAll(\"-\", \" \")\n        .replace(/^./, (char) => char.toUpperCase());\n      const title = blocker.title.replaceAll(\"\\\\n\", \" \").replaceAll(\"|\", \"\\\\\\\\|\");\n      const impact = blocker.impact.replaceAll(\"\\\\n\", \" \").replaceAll(\"|\", \"\\\\\\\\|\");\n      return \\`| \\${category} | \\${title} | \\${impact} |\\`;\n    }),\n  ].join(\"\\\\n\");\n}\n\nfunction droppedBlockersNote(count: number): string {\n  if (count === 0) {\n    return \"\";\n  }\n  const blockerNoun = count === 1 ? \"blocker\" : \"blockers\";\n  const verb = count === 1 ? \"was\" : \"were\";\n  const pronoun = count === 1 ? \"it does\" : \"they do\";\n  return [\n    \"<sub>\",\n    count,\n    \" model-reported \",\n    blockerNoun,\n    \" \",\n    verb,\n    \" ignored because \",\n    pronoun,\n    \" not match a commentable diff range or duplicates another blocker.\",\n    \"</sub>\",\n  ].join(\"\");\n}\n\nfunction categoryBreakdownTable(blockers: QualityBlocker[]): string {\n  const counts = categoryCounts(blockers);\n  if (counts.length === 0) {\n    return [\n      \"| Category | Count |\",\n      \"| --- | ---: |\",\n      \"| - | 0 |\",\n    ].join(\"\\\\n\");\n  }\n  return [\n    \"| Category | Count |\",\n    \"| --- | ---: |\",\n    ...counts.map(([category, count]) => {\n      const categoryLabel = category\n        .replaceAll(\"-\", \" \")\n        .replace(/^./, (char) => char.toUpperCase());\n      return \\`| \\${categoryLabel} | \\${count} |\\`;\n    }),\n  ].join(\"\\\\n\");\n}\n\nfunction categorySummary(blockers: QualityBlocker[]): string {\n  const counts = categoryCounts(blockers);\n  if (counts.length === 0) {\n    return \"None\";\n  }\n  return counts\n    .map(([category, count]) => {\n      const categoryLabel = category\n        .replaceAll(\"-\", \" \")\n        .replace(/^./, (char) => char.toUpperCase());\n      return \\`\\${categoryLabel} (\\${count})\\`;\n    })\n    .join(\", \");\n}\n\nfunction categoryCounts(blockers: QualityBlocker[]): Array<[string, number]> {\n  const counts = new Map<string, number>();\n  for (const blocker of blockers) {\n    counts.set(blocker.category, (counts.get(blocker.category) ?? 0) + 1);\n  }\n  return [...counts.entries()].sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]));\n}\n\n`,\n} as const satisfies OfficialInitRecipe;\n","import type { OfficialInitRecipe } from \"./types.js\";\n\nexport const structuredReviewRecipe = {\n  id: \"rich-review\",\n  title: \"Structured Review\",\n  description: \"General change request review with severity and category metadata.\",\n  sourceTools: [\"CodeRabbit\", \"Qodo Merge\", \"Greptile\"],\n  configTs: `import { definePipr, z } from \"@usepipr/sdk\";\nimport type { ReviewFinding } from \"@usepipr/sdk\";\n\ntype ReviewSummary = {\n  headline: string;\n  changeSummary: string[];\n  riskLevel: \"low\" | \"medium\" | \"high\";\n  riskSummary: string;\n  reviewerFocus: string[];\n};\n\nconst categorizedFindingSchema = z.strictObject({\n  title: z.string().regex(/^[^\\\\r\\\\n]+$/),\n  severity: z.enum([\"critical\", \"high\", \"medium\", \"low\"]),\n  category: z.enum([\n    \"correctness\",\n    \"security\",\n    \"reliability\",\n    \"performance\",\n    \"test-coverage\",\n    \"maintainability\",\n    \"documentation\",\n  ]),\n  rationale: z.string(),\n  body: z.string(),\n  path: z.string(),\n  rangeId: z.string(),\n  side: z.enum([\"RIGHT\", \"LEFT\"]),\n  startLine: z.number().int().positive(),\n  endLine: z.number().int().positive(),\n  suggestedFix: z.string().optional(),\n});\n\nconst reviewSummarySchema = z.strictObject({\n  headline: z.string(),\n  changeSummary: z.array(z.string()).min(1).max(4),\n  riskLevel: z.enum([\"low\", \"medium\", \"high\"]),\n  riskSummary: z.string(),\n  reviewerFocus: z.array(z.string()).max(4),\n});\n\nfunction escapeInlineCommentHtml(value: string): string {\n  return value.replaceAll(\"&\", \"&amp;\").replaceAll(\"<\", \"&lt;\").replaceAll(\">\", \"&gt;\");\n}\n\nexport default definePipr((pipr) => {\n  const model = pipr.model({\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"high\" },\n  });\n\n  pipr.config({ publication: { maxInlineComments: 8 } });\n\n  const reviewOutput = pipr.schema({\n    id: \"review/categorized-findings\",\n    schema: z.strictObject({\n      summary: reviewSummarySchema,\n      findings: z.array(categorizedFindingSchema),\n    }),\n  });\n\n  const reviewer = pipr.agent({\n    name: \"reviewer\",\n    model,\n    instructions: \\`\n      Review the change request diff for correctness, security, reliability,\n      performance, test coverage, maintainability, and documentation risks.\n      Return only actionable findings that target valid diff ranges. Assign\n      severity by merge impact: critical for exploitable, data-loss, or widespread\n      outage risks; high for other merge-blocking defects; medium for concrete\n      non-blocking defects; and low for small but actionable issues. Each rationale\n      must connect repository evidence to the defect and its concrete impact.\n      Keep each finding title to one line and its body concise. Put supporting\n      evidence and reasoning in rationale instead of appending it to the body.\n\n      Make summary maintainer-facing and scannable: one concrete headline, one\n      to four behavior-focused change bullets, a risk level with rationale, and\n      reviewer focus only for useful human follow-up. Put actionable defects in\n      findings, not only in summary.\n    \\`,\n    output: reviewOutput,\n    tools: pipr.tools.readOnly,\n    retry: { invalidOutput: 1, transientFailure: 1 },\n    timeout: \"10m\",\n    prompt: () => \"Review this change with severity and category metadata.\",\n  });\n\n  const task = pipr.task({\n    name: \"review\",\n    async run(ctx) {\n      const manifest = await ctx.change.diffManifest({ compressed: true });\n      const result = await ctx.pi.run(reviewer, { manifest });\n      const inlineFindings: ReviewFinding[] = result.findings.map((finding) => {\n        const severity = finding.severity.charAt(0).toUpperCase() + finding.severity.slice(1);\n        const category = finding.category.replaceAll(\"-\", \" \");\n        return {\n          body: [\n            \\`**\\${severity} \\${category}:** \\${escapeInlineCommentHtml(finding.title)}\\`,\n            \"\",\n            escapeInlineCommentHtml(finding.body),\n            \"\",\n            \"<details>\",\n            \"<summary>Rationale</summary>\",\n            \"\",\n            escapeInlineCommentHtml(finding.rationale),\n            \"\",\n            \"</details>\",\n          ].join(\"\\\\n\"),\n          path: finding.path,\n          rangeId: finding.rangeId,\n          side: finding.side,\n          startLine: finding.startLine,\n          endLine: finding.endLine,\n          ...(finding.suggestedFix ? { suggestedFix: finding.suggestedFix } : {}),\n        };\n      });\n      await ctx.comment({\n        main: [\n          \"## Summary\",\n          \"\",\n          \\`**\\${result.summary.headline}**\\`,\n          \"\",\n          summaryTable(result.summary),\n          \"\",\n          \"## What Changed\",\n          \"\",\n          bulletList(result.summary.changeSummary, \"No changed behavior summarized.\"),\n          \"\",\n          \"## Reviewer Focus\",\n          \"\",\n          bulletList(result.summary.reviewerFocus, \"No special reviewer focus.\"),\n          \"\",\n        ].join(\"\\\\n\"),\n        inlineFindings,\n      });\n    },\n  });\n\n  pipr.on.changeRequest({ actions: [\"opened\", \"updated\", \"reopened\", \"ready\"], task });\n  pipr.command({ pattern: \"@pipr review\", permission: \"write\", task });\n});\n\nfunction summaryTable(summary: ReviewSummary): string {\n  return [\n    \"| Risk | Risk summary |\",\n    \"| --- | --- |\",\n    \\`| \\${labelValue(summary.riskLevel)} | \\${tableCell(\n      summary.riskSummary,\n    )} |\\`,\n  ].join(\"\\\\n\");\n}\n\nfunction bulletList(items: string[], emptyText: string): string {\n  if (items.length === 0) {\n    return emptyText;\n  }\n  return items.map((item) => \\`- \\${lineText(item)}\\`).join(\"\\\\n\");\n}\n\nfunction labelValue(value: string): string {\n  return value.replaceAll(\"-\", \" \").replace(/^./, (char) => char.toUpperCase());\n}\n\nfunction lineText(value: string): string {\n  return value.replaceAll(\"\\\\n\", \" \").trim();\n}\n\nfunction tableCell(value: string): string {\n  return lineText(value).replaceAll(\"|\", \"\\\\\\\\|\");\n}\n`,\n} as const satisfies OfficialInitRecipe;\n","import type { OfficialInitRecipe } from \"./types.js\";\n\nexport const securitySastRecipe = {\n  id: \"security-sast\",\n  title: \"Security SAST\",\n  description: \"Security review with custom severity and category output.\",\n  sourceTools: [\"Semgrep\", \"Snyk\", \"GitHub CodeQL/code scanning\"],\n  configTs: `import { definePipr } from \"@usepipr/sdk\";\nimport type { DiffManifest, ReviewFinding } from \"@usepipr/sdk\";\n\ntype SecuritySummary = {\n  headline: string;\n  riskSummary: string;\n  reviewerFocus: string[];\n};\n\ntype SecurityRisk = {\n  title: string;\n  category: \"auth\" | \"injection\" | \"secret\" | \"crypto\" | \"data-exposure\" | \"other\";\n  severity: \"low\" | \"medium\" | \"high\" | \"critical\";\n  rationale: string;\n  finding: ReviewFinding;\n};\n\ntype SecurityReview = {\n  summary: SecuritySummary;\n  risks: SecurityRisk[];\n  diagramMermaid?: string;\n};\n\nexport default definePipr((pipr) => {\n  const model = pipr.model({\n    provider: \"deepseek\",\n    model: \"deepseek-v4-pro\",\n    apiKey: pipr.secret({ name: \"DEEPSEEK_API_KEY\" }),\n    options: { thinking: \"high\" },\n  });\n\n  const securityOutput = pipr.jsonSchema<SecurityReview>({\n    id: \"security/sast-review\",\n    schema: {\n      type: \"object\",\n      additionalProperties: false,\n      required: [\"summary\", \"risks\"],\n      properties: {\n        summary: {\n          type: \"object\",\n          additionalProperties: false,\n          required: [\"headline\", \"riskSummary\", \"reviewerFocus\"],\n          properties: {\n            headline: { type: \"string\" },\n            riskSummary: { type: \"string\" },\n            reviewerFocus: {\n              type: \"array\",\n              items: { type: \"string\" },\n            },\n          },\n        },\n        risks: {\n          type: \"array\",\n          items: {\n            type: \"object\",\n            additionalProperties: false,\n            required: [\"title\", \"category\", \"severity\", \"rationale\", \"finding\"],\n            properties: {\n              title: { type: \"string\" },\n              category: {\n                type: \"string\",\n                enum: [\"auth\", \"injection\", \"secret\", \"crypto\", \"data-exposure\", \"other\"],\n              },\n              severity: { type: \"string\", enum: [\"low\", \"medium\", \"high\", \"critical\"] },\n              rationale: { type: \"string\" },\n              finding: {\n                type: \"object\",\n                additionalProperties: false,\n                required: [\"body\", \"path\", \"rangeId\", \"side\", \"startLine\", \"endLine\"],\n                properties: {\n                  body: { type: \"string\" },\n                  path: { type: \"string\" },\n                  rangeId: { type: \"string\" },\n                  side: { type: \"string\", enum: [\"RIGHT\", \"LEFT\"] },\n                  startLine: { type: \"number\" },\n                  endLine: { type: \"number\" },\n                  suggestedFix: { type: \"string\" },\n                },\n              },\n            },\n          },\n        },\n        diagramMermaid: { type: \"string\" },\n      },\n    },\n  });\n\n  const security = pipr.agent({\n    name: \"security-sast\",\n    model,\n    instructions: \\`\n      Review for exploitable security issues only. Focus on auth bypasses,\n      injection, unsafe deserialization, secret exposure, cryptography misuse,\n      authorization gaps, and data exposure. Require a changed trust boundary or\n      source-to-sink path and anchor every risk to the exact changed range that\n      creates or weakens it. Do not report hypothetical or style-only issues.\n      Make summary maintainer-facing and scannable with a concrete headline,\n      risk rationale, and only useful security follow-up. Set\n      diagramMermaid only when a high or critical risk has a concrete source-to-sink\n      path and a small Mermaid flowchart clarifies it. Do not include Markdown\n      fences in diagramMermaid.\n    \\`,\n    output: securityOutput,\n    tools: pipr.tools.readOnly,\n    retry: { invalidOutput: 1, transientFailure: 1 },\n    prompt: () => pipr.prompt\\`\n      \\${pipr.section(\"Security review policy\", \"Return only risks with a concrete attack path.\")}\n    \\`,\n  });\n\n  const task = pipr.task({\n    name: \"security-sast\",\n    check: { enabled: true, name: \"security-sast\", required: true },\n    async run(ctx) {\n      const manifest = await ctx.change.diffManifest({ compressed: true });\n      const result = await ctx.pi.run(security, { manifest });\n      const risks = commentableSecurityRisks(result.risks, manifest);\n      const droppedRiskCount = result.risks.length - risks.length;\n      const inlineFindings: ReviewFinding[] = risks.map((risk) => risk.finding);\n      const hasHighOrCriticalRisk = risks.some(isHighOrCriticalRisk);\n      if (hasHighOrCriticalRisk) {\n        ctx.check.fail(\"High or critical security risk found.\");\n      } else {\n        ctx.check.pass(\"No high or critical security risks found.\");\n      }\n      await ctx.comment({\n        main: [\n          \"## Summary\",\n          \"\",\n          \\`**\\${result.summary.headline}**\\`,\n          \"\",\n          securityStatusTable(risks),\n          \"\",\n          result.summary.riskSummary,\n          \"\",\n          \"## Reviewer Focus\",\n          \"\",\n          bulletList(result.summary.reviewerFocus, \"No special security follow-up.\"),\n          \"\",\n          \"## Security Risks\",\n          \"\",\n          securityRisksTable(risks),\n          ...(droppedRiskCount > 0 ? [\"\", omittedRisksNote(droppedRiskCount)] : []),\n          ...(risks.length > 0 ? [\"\", riskRationalesBlock(risks)] : []),\n          ...(hasHighOrCriticalRisk && result.diagramMermaid?.trim()\n            ? [\"\", attackPathDiagramBlock(result.diagramMermaid, hasHighOrCriticalRisk)]\n            : []),\n        ].join(\"\\\\n\"),\n        inlineFindings,\n      });\n    },\n  });\n\n  pipr.on.changeRequest({ actions: [\"opened\", \"updated\", \"reopened\", \"ready\"], task });\n  pipr.command({ pattern: \"@pipr security\", permission: \"write\", task });\n});\n\nfunction commentableSecurityRisks(\n  risks: SecurityRisk[],\n  manifest: DiffManifest,\n): SecurityRisk[] {\n  const risksByLocation = new Map<string, SecurityRisk>();\n  for (const risk of risks) {\n    const finding = risk.finding;\n    const validAnchor = manifest.files.some((file) =>\n      file.commentableRanges.some(\n        (range) =>\n          finding.rangeId === range.id &&\n          finding.path === range.path &&\n          finding.side === range.side &&\n          finding.startLine <= finding.endLine &&\n          finding.startLine >= range.startLine &&\n          finding.endLine <= range.endLine,\n      ),\n    );\n    const key = [\n      finding.path,\n      finding.rangeId,\n      finding.side,\n      finding.startLine,\n      finding.endLine,\n      finding.body,\n    ].join(\"\\\\n\");\n    if (!validAnchor) {\n      continue;\n    }\n    const existing = risksByLocation.get(key);\n    if (!existing || securitySeverityRank(risk.severity) > securitySeverityRank(existing.severity)) {\n      risksByLocation.set(key, risk);\n    }\n  }\n  return [...risksByLocation.values()];\n}\n\nfunction omittedRisksNote(count: number): string {\n  const noun = count === 1 ? \"risk\" : \"risks\";\n  return \\`Omitted \\${count} \\${noun} with an invalid or duplicate anchor.\\`;\n}\n\nfunction securityStatusTable(risks: SecurityRisk[]): string {\n  return [\n    \"| Status | Max severity | Risks |\",\n    \"| --- | --- | ---: |\",\n    \\`| \\${risks.some(isHighOrCriticalRisk) ? \"Fail\" : \"Pass\"} | \\${maxSeverity(\n      risks,\n    )} | \\${risks.length} |\\`,\n  ].join(\"\\\\n\");\n}\n\nfunction securityRisksTable(risks: SecurityRisk[]): string {\n  if (risks.length === 0) {\n    return [\n      \"| Severity | Category | Title |\",\n      \"| --- | --- | --- |\",\n      \"| - | - | No security risks found. |\",\n    ].join(\"\\\\n\");\n  }\n  return [\n    \"| Severity | Category | Title |\",\n    \"| --- | --- | --- |\",\n    ...risks.map(\n      (risk) =>\n        \\`| \\${labelValue(risk.severity)} | \\${tableCell(risk.category)} | \\${tableCell(risk.title)} |\\`,\n    ),\n  ].join(\"\\\\n\");\n}\n\nfunction riskRationalesBlock(risks: SecurityRisk[]): string {\n  if (risks.length === 0) {\n    return \"\";\n  }\n  return [\n    \"<details>\",\n    \"<summary>Risk rationales</summary>\",\n    \"\",\n    risks\n      .map((risk, index) =>\n        [\n          \\`### \\${index + 1}. \\${risk.title}\\`,\n          \"\",\n          \\`**Severity:** \\${labelValue(risk.severity)}\\`,\n          \\`**Category:** \\${labelValue(risk.category)}\\`,\n          \"\",\n          risk.rationale,\n        ].join(\"\\\\n\"),\n      )\n      .join(\"\\\\n\\\\n\"),\n    \"\",\n    \"</details>\",\n  ].join(\"\\\\n\");\n}\n\nfunction attackPathDiagramBlock(\n  diagramMermaid: string | undefined,\n  hasConcreteHighOrCriticalRisk: boolean,\n): string {\n  const diagram = diagramMermaid?.trim();\n  if (!diagram || !hasConcreteHighOrCriticalRisk) {\n    return \"\";\n  }\n  const fence = markdownFenceFor(diagram);\n  return [\n    \"<details>\",\n    \"<summary>Attack path diagram</summary>\",\n    \"\",\n    \\`\\${fence}mermaid\\`,\n    diagram,\n    fence,\n    \"\",\n    \"</details>\",\n  ].join(\"\\\\n\");\n}\n\nfunction maxSeverity(risks: SecurityRisk[]): string {\n  const severity = risks.reduce<SecurityRisk[\"severity\"] | undefined>((current, risk) => {\n    if (!current || securitySeverityRank(risk.severity) > securitySeverityRank(current)) {\n      return risk.severity;\n    }\n    return current;\n  }, undefined);\n  return severity ? labelValue(severity) : \"None\";\n}\n\nfunction securitySeverityRank(severity: SecurityRisk[\"severity\"]): number {\n  return [\"low\", \"medium\", \"high\", \"critical\"].indexOf(severity);\n}\n\nfunction isHighOrCriticalRisk(risk: SecurityRisk): boolean {\n  return risk.severity === \"high\" || risk.severity === \"critical\";\n}\n\nfunction bulletList(items: string[], emptyText: string): string {\n  if (items.length === 0) {\n    return emptyText;\n  }\n  return items.map((item) => \\`- \\${lineText(item)}\\`).join(\"\\\\n\");\n}\n\nfunction labelValue(value: string): string {\n  return value.replaceAll(\"-\", \" \").replace(/^./, (char) => char.toUpperCase());\n}\n\nfunction lineText(value: string): string {\n  return value.replaceAll(\"\\\\n\", \" \").trim();\n}\n\nfunction tableCell(value: string): string {\n  return lineText(value).replaceAll(\"|\", \"\\\\\\\\|\");\n}\n\nfunction markdownFenceFor(value: string): string {\n  const longestBacktickRun = Math.max(\n    0,\n    ...[...value.matchAll(/\\`+/g)].map((match) => match[0].length),\n  );\n  return \"\\`\".repeat(Math.max(3, longestBacktickRun + 1));\n}\n`,\n} as const satisfies OfficialInitRecipe;\n","import { bugHunterRecipe } from \"./recipes/bug-hunter.js\";\nimport { changelogDraftRecipe } from \"./recipes/changelog-draft.js\";\nimport { ciTriageCommandRecipe } from \"./recipes/ci-triage-command.js\";\nimport { defaultReviewRecipe } from \"./recipes/default-review.js\";\nimport { dependencyRiskRecipe } from \"./recipes/dependency-risk.js\";\nimport { diffDiagnosticsRecipe } from \"./recipes/diff-diagnostics.js\";\nimport { fixSuggestionsRecipe } from \"./recipes/fix-suggestions.js\";\nimport { interactiveAskRecipe } from \"./recipes/interactive-ask.js\";\nimport { multiAgentReviewRecipe } from \"./recipes/multi-agent-review.js\";\nimport { pluginToolReviewRecipe } from \"./recipes/plugin-tool-review.js\";\nimport { prBriefingRecipe } from \"./recipes/pr-briefing.js\";\nimport { prHygieneRecipe } from \"./recipes/pr-hygiene.js\";\nimport { qualityGateRecipe } from \"./recipes/quality-gate.js\";\nimport { structuredReviewRecipe } from \"./recipes/rich-review.js\";\nimport { securitySastRecipe } from \"./recipes/security-sast.js\";\nimport type {\n  OfficialInitRecipe,\n  OfficialInitRecipeFile,\n  OfficialInitRecipeWorkflowEnvSecret,\n} from \"./recipes/types.js\";\n\nexport const supportedOfficialInitRecipes = [\n  \"default-review\",\n  \"bug-hunter\",\n  \"rich-review\",\n  \"fix-suggestions\",\n  \"security-sast\",\n  \"quality-gate\",\n  \"diff-diagnostics\",\n  \"pr-hygiene\",\n  \"dependency-risk\",\n  \"ci-triage-command\",\n  \"multi-agent-review\",\n  \"plugin-tool-review\",\n  \"pr-briefing\",\n  \"interactive-ask\",\n  \"changelog-draft\",\n] as const;\n\nexport type OfficialInitRecipeId = (typeof supportedOfficialInitRecipes)[number];\nexport type { OfficialInitRecipe, OfficialInitRecipeFile, OfficialInitRecipeWorkflowEnvSecret };\n\nconst officialInitRecipeRegistry = {\n  \"default-review\": defaultReviewRecipe,\n  \"bug-hunter\": bugHunterRecipe,\n  \"rich-review\": structuredReviewRecipe,\n  \"fix-suggestions\": fixSuggestionsRecipe,\n  \"security-sast\": securitySastRecipe,\n  \"quality-gate\": qualityGateRecipe,\n  \"diff-diagnostics\": diffDiagnosticsRecipe,\n  \"pr-hygiene\": prHygieneRecipe,\n  \"dependency-risk\": dependencyRiskRecipe,\n  \"ci-triage-command\": ciTriageCommandRecipe,\n  \"multi-agent-review\": multiAgentReviewRecipe,\n  \"plugin-tool-review\": pluginToolReviewRecipe,\n  \"pr-briefing\": prBriefingRecipe,\n  \"interactive-ask\": interactiveAskRecipe,\n  \"changelog-draft\": changelogDraftRecipe,\n} satisfies Record<OfficialInitRecipeId, OfficialInitRecipe & { id: OfficialInitRecipeId }>;\n\nexport function listOfficialInitRecipes(): OfficialInitRecipe[] {\n  return supportedOfficialInitRecipes.map((id) => officialInitRecipeRegistry[id]);\n}\n\nexport function officialInitRecipeConfigTs(recipe?: string): string {\n  return resolveOfficialInitRecipe(recipe).configTs;\n}\n\nexport function officialInitRecipeFiles(recipe?: string): readonly OfficialInitRecipeFile[] {\n  return resolveOfficialInitRecipe(recipe).files ?? [];\n}\n\nexport function officialInitRecipeWorkflowEnvSecrets(\n  recipe?: string,\n): readonly OfficialInitRecipeWorkflowEnvSecret[] {\n  return resolveOfficialInitRecipe(recipe).workflowEnvSecrets ?? [];\n}\n\nfunction resolveOfficialInitRecipe(\n  recipe?: string,\n): OfficialInitRecipe & { id: OfficialInitRecipeId } {\n  const id = recipe ?? \"default-review\";\n  if (!isOfficialInitRecipeId(id)) {\n    throw new Error(\n      `Unsupported pipr init recipe '${id}'. Supported recipes: ${supportedOfficialInitRecipes.join(\n        \", \",\n      )}.`,\n    );\n  }\n  return officialInitRecipeRegistry[id];\n}\n\nfunction isOfficialInitRecipeId(recipe: string): recipe is OfficialInitRecipeId {\n  return (supportedOfficialInitRecipes as readonly string[]).includes(recipe);\n}\n","import { officialInitRecipeWorkflowEnvSecrets } from \"./recipes.js\";\n\nconst defaultWorkflowActionRef = \"somus/pipr@v0.4.1\"; // x-release-please-version\n\nexport type RenderOfficialGithubWorkflowOptions = {\n  relativeConfigDir?: string;\n  recipe?: string;\n  minimal?: boolean;\n  includeReleasePleaseVersionMarker?: boolean;\n};\n\n/** Internal shared renderer for `pipr init` and generated recipe docs. */\nexport function renderOfficialGithubWorkflow(\n  options: RenderOfficialGithubWorkflowOptions = {},\n): string {\n  const relativeConfigDir = options.relativeConfigDir ?? \".pipr\";\n  const lines = [\n    \"name: pipr\",\n    \"\",\n    \"on:\",\n    \"  pull_request:\",\n    \"  issue_comment:\",\n    \"    types: [created]\",\n    \"  pull_request_review_comment:\",\n    \"    types: [created]\",\n    \"\",\n    \"permissions:\",\n    \"  contents: write\",\n    \"  pull-requests: write\",\n    \"  issues: write\",\n    \"  checks: write\",\n    \"\",\n    \"jobs:\",\n    \"  review:\",\n    \"    runs-on: ubuntu-latest\",\n    \"    steps:\",\n    \"      - uses: actions/checkout@v6\",\n    \"        with:\",\n    \"          fetch-depth: 0\",\n  ];\n  if (!options.minimal) {\n    lines.push(\n      \"      - uses: actions/cache@v4\",\n      \"        with:\",\n      \"          path: /home/runner/work/_temp/_github_home/.bun/install/cache\",\n      `          key: pipr-bun-${githubExpression(`hashFiles('${relativeConfigDir}/bun.lock')`)}`,\n    );\n  }\n  lines.push(\n    `      - uses: ${defaultWorkflowActionRef}${\n      options.includeReleasePleaseVersionMarker ? \" # x-release-please-version\" : \"\"\n    }`,\n    \"        env:\",\n    `          DEEPSEEK_API_KEY: ${githubExpression(\"secrets.DEEPSEEK_API_KEY\")}`,\n    `          GITHUB_TOKEN: ${githubExpression(\"github.token\")}`,\n  );\n  for (const secret of officialInitRecipeWorkflowEnvSecrets(options.recipe)) {\n    lines.push(`          ${secret.env}: ${githubExpression(`secrets.${secret.secret}`)}`);\n  }\n  if (relativeConfigDir !== \".pipr\") {\n    lines.push(\"        with:\", `          config-dir: ${relativeConfigDir}`);\n  }\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n\nfunction githubExpression(expression: string): string {\n  return `$${[\"{{ \", expression, \" }}\"].join(\"\")}`;\n}\n"],"mappings":"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"}

package/dist/pi/runtime-tools-extension.mjs

@@ -1,4 +1,4 @@
-import { a as readDiffFromRuntimeData, c as resolveReadAtRefRequest, i as readAtRefParams, l as unavailableReadAtRefResult, n as boundedLineSlice, o as readDiffParams, s as resolveAllowedPath, t as assertNoSymlinkPath } from "../runtime-tools-core-CW1xenzy.mjs";
+import { a as readDiffFromRuntimeData, c as resolveReadAtRefRequest, i as readAtRefParams, l as unavailableReadAtRefResult, n as boundedLineSlice, o as readDiffParams, s as resolveAllowedPath, t as assertNoSymlinkPath } from "../runtime-tools-core-D8_WsbL_.mjs";
 import path from "node:path";
 import { z } from "zod";
 import { compact } from "lodash-es";

package/dist/recipes-w72EpAOi.d.mts

@@ -0,0 +1,27 @@
+//#region src/config/recipes/types.d.ts
+type OfficialInitRecipeFile = {
+  relativePath: string;
+  contents: string;
+};
+type OfficialInitRecipeWorkflowEnvSecret = {
+  env: string;
+  secret: string;
+};
+type OfficialInitRecipe = {
+  id: string;
+  title: string;
+  description: string;
+  sourceTools: readonly string[];
+  configTs: string;
+  files?: readonly OfficialInitRecipeFile[];
+  workflowEnvSecrets?: readonly OfficialInitRecipeWorkflowEnvSecret[];
+  docsDetailsMdx?: string;
+};
+//#endregion
+//#region src/config/recipes.d.ts
+declare const supportedOfficialInitRecipes: readonly ["default-review", "bug-hunter", "rich-review", "fix-suggestions", "security-sast", "quality-gate", "diff-diagnostics", "pr-hygiene", "dependency-risk", "ci-triage-command", "multi-agent-review", "plugin-tool-review", "pr-briefing", "interactive-ask", "changelog-draft"];
+type OfficialInitRecipeId = (typeof supportedOfficialInitRecipes)[number];
+declare function listOfficialInitRecipes(): OfficialInitRecipe[];
+//#endregion
+export { OfficialInitRecipeFile as a, OfficialInitRecipe as i, listOfficialInitRecipes as n, supportedOfficialInitRecipes as r, OfficialInitRecipeId as t };
+//# sourceMappingURL=recipes-w72EpAOi.d.mts.map

package/dist/recipes-w72EpAOi.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes-w72EpAOi.d.mts","names":[],"sources":["../src/config/recipes/types.ts","../src/config/recipes.ts"],"mappings":";KAAY;EACV;EACA;;KAGU;EACV;EACA;;KAGU;EACV;EACA;EACA;EACA;EACA;EACA,iBAAiB;EACjB,8BAA8B;EAC9B;;;;cCGW;KAkBD,+BAA+B;iBAqB3B,2BAA2B"}

package/dist/{runtime-tools-core-CW1xenzy.mjs → runtime-tools-core-D8_WsbL_.mjs}

@@ -1,6 +1,11 @@
 import { lstat } from "node:fs/promises";
 import path from "node:path";
 import { z } from "zod";
+//#region src/shared/record.ts
+function isRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//#endregion
 //#region src/diff/ranges.ts
 function createDiffRangeIndex(manifest) {
 	const filesByPath = new Map(manifest.files.map((file) => [file.path, file]));
@@ -44,7 +49,7 @@ function createDiffRangeIndex(manifest) {
 //#region src/pi/runtime-tools-core.ts
 const readAtRefContextLines = 3;
 const readDiffParamsSchema = z.preprocess((params) => {
-	const record = typeof params === "object" && params !== null && !Array.isArray(params) ? params : {};
+	const record = isRecord(params) ? params : {};
 	return {
 		path: typeof record.path === "string" ? record.path : void 0,
 		rangeId: typeof record.rangeId === "string" ? record.rangeId : void 0
@@ -53,7 +58,7 @@ const readDiffParamsSchema = z.preprocess((params) => {
 	path: z.string().optional(),
 	rangeId: z.string().optional()
 }));
-const readAtRefParamsSchema = z.preprocess((params) => typeof params === "object" && params !== null && !Array.isArray(params) ? params : {}, z.object({
+const readAtRefParamsSchema = z.preprocess((params) => isRecord(params) ? params : {}, z.object({
 	path: z.unknown(),
 	ref: z.enum(["base", "head"], { error: (issue) => `Unsupported ref '${String(issue.input)}'` }),
 	rangeId: z.string({ error: "rangeId must be a string" })
@@ -169,6 +174,6 @@ function lineWindowForRange(range, hunk, ref) {
 	};
 }
 //#endregion
-export { readDiffFromRuntimeData as a, resolveReadAtRefRequest as c, readAtRefParams as i, unavailableReadAtRefResult as l, boundedLineSlice as n, readDiffParams as o, parseManifestPath as r, resolveAllowedPath as s, assertNoSymlinkPath as t, createDiffRangeIndex as u };
+export { readDiffFromRuntimeData as a, resolveReadAtRefRequest as c, isRecord as d, readAtRefParams as i, unavailableReadAtRefResult as l, boundedLineSlice as n, readDiffParams as o, parseManifestPath as r, resolveAllowedPath as s, assertNoSymlinkPath as t, createDiffRangeIndex as u };
 
-//# sourceMappingURL=runtime-tools-core-CW1xenzy.mjs.map
+//# sourceMappingURL=runtime-tools-core-D8_WsbL_.mjs.map

package/dist/runtime-tools-core-D8_WsbL_.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-tools-core-D8_WsbL_.mjs","names":[],"sources":["../src/shared/record.ts","../src/diff/ranges.ts","../src/pi/runtime-tools-core.ts"],"sourcesContent":["export function isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n","import type { CommentableRange, DiffHunk, DiffManifest, DiffManifestFile } from \"../types.js\";\n\nexport type DiffRangeMatch = {\n  file: DiffManifestFile;\n  range: CommentableRange;\n};\n\nexport type DiffRangeIndex = {\n  fileByPath(filePath: string): DiffManifestFile | undefined;\n  excludedReason(filePath: string): string | undefined;\n  findRange(rangeId: string): DiffRangeMatch | undefined;\n  rangeById(rangeId: string): CommentableRange | undefined;\n  requireFile(filePath: string): DiffManifestFile;\n  requireRangeInFile(file: DiffManifestFile, rangeId: string): CommentableRange;\n  requireHunk(file: DiffManifestFile, range: CommentableRange): DiffHunk;\n};\n\nexport function createDiffRangeIndex(manifest: DiffManifest): DiffRangeIndex {\n  const filesByPath = new Map(manifest.files.map((file) => [file.path, file]));\n  const rangesById = new Map<string, DiffRangeMatch>();\n  for (const file of manifest.files) {\n    for (const range of file.commentableRanges) {\n      rangesById.set(range.id, { file, range });\n    }\n  }\n\n  return {\n    fileByPath(filePath) {\n      return filesByPath.get(filePath);\n    },\n    excludedReason(filePath) {\n      return filesByPath.get(filePath)?.excludedReason;\n    },\n    findRange(rangeId) {\n      return rangesById.get(rangeId);\n    },\n    rangeById(rangeId) {\n      return rangesById.get(rangeId)?.range;\n    },\n    requireFile(filePath) {\n      const file = filesByPath.get(filePath);\n      if (!file) {\n        throw new Error(`Path '${filePath}' is not in the Diff Manifest`);\n      }\n      return file;\n    },\n    requireRangeInFile(file, rangeId) {\n      const range = file.commentableRanges.find((item) => item.id === rangeId);\n      if (range) {\n        return range;\n      }\n      if (rangesById.has(rangeId)) {\n        throw new Error(`Diff Manifest range '${rangeId}' is not in path '${file.path}'`);\n      }\n      throw new Error(`Unknown Diff Manifest range '${rangeId}'`);\n    },\n    requireHunk(file, range) {\n      const hunk = file.hunks.find(\n        (item) => item.hunkIndex === range.hunkIndex && item.contentHash === range.hunkContentHash,\n      );\n      if (!hunk) {\n        throw new Error(`Diff Manifest range '${range.id}' has no matching hunk`);\n      }\n      return hunk;\n    },\n  };\n}\n","import { lstat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { z } from \"zod\";\nimport { createDiffRangeIndex } from \"../diff/ranges.js\";\nimport { isRecord } from \"../shared/record.js\";\nimport type { CommentableRange, DiffHunk, DiffManifest, DiffManifestFile } from \"../types.js\";\n\nconst readAtRefContextLines = 3;\n\nexport type ReadDiffParams = {\n  path?: string;\n  rangeId?: string;\n};\n\nexport type ReadAtRefParams = {\n  path: string;\n  ref: \"base\" | \"head\";\n  rangeId: string;\n};\n\nexport type RuntimeToolData = {\n  manifest: DiffManifest;\n  toolResponseMaxBytes: number;\n  baseRanges: Record<string, BaseRangeSnapshot>;\n};\n\nexport type BaseRangeSnapshot = {\n  path: string;\n  ref: \"base\" | \"head\";\n  sourcePath: string;\n  rangeId: string;\n  startLine: number;\n  endLine: number;\n  available: boolean;\n  relativePath?: string;\n  bytes?: number;\n  truncated?: boolean;\n};\n\nexport type ReadAtRefRequest = {\n  file: DiffManifestFile;\n  range: CommentableRange;\n  hunk: DiffHunk;\n  ref: \"base\" | \"head\";\n  sourcePath: string;\n  window: LineWindow | undefined;\n};\n\nexport type LineWindow = {\n  startLine: number;\n  endLine: number;\n};\n\nexport type LineSliceResult = {\n  available: true;\n  content: string;\n  bytes: number;\n  truncated: boolean;\n};\n\nconst readDiffParamsSchema = z.preprocess(\n  (params) => {\n    const record = isRecord(params) ? params : {};\n    return {\n      path: typeof record.path === \"string\" ? record.path : undefined,\n      rangeId: typeof record.rangeId === \"string\" ? record.rangeId : undefined,\n    };\n  },\n  z.object({\n    path: z.string().optional(),\n    rangeId: z.string().optional(),\n  }),\n);\n\nconst readAtRefParamsSchema = z.preprocess(\n  (params) => (isRecord(params) ? params : {}),\n  z.object({\n    path: z.unknown(),\n    ref: z.enum([\"base\", \"head\"], {\n      error: (issue) => `Unsupported ref '${String(issue.input)}'`,\n    }),\n    rangeId: z.string({ error: \"rangeId must be a string\" }),\n  }),\n);\n\nexport function readDiffFromRuntimeData(data: RuntimeToolData, params: ReadDiffParams): unknown {\n  const { rangeId } = params;\n  const filePath = params.path === undefined ? undefined : parseManifestPath(params.path);\n  const ranges = createDiffRangeIndex(data.manifest);\n  if (filePath !== undefined) {\n    ranges.requireFile(filePath);\n  }\n  if (rangeId !== undefined && !ranges.findRange(rangeId)) {\n    throw new Error(`Unknown Diff Manifest range '${rangeId}'`);\n  }\n  const files = data.manifest.files\n    .filter((file) => filePath === undefined || file.path === filePath)\n    .map((file) => filterManifestFileRanges(file, rangeId))\n    .filter((file) => rangeId === undefined || file.commentableRanges.length > 0);\n  return boundedJson({ files }, data.toolResponseMaxBytes);\n}\n\nfunction boundedJson(value: unknown, maxBytes: number): unknown {\n  const text = JSON.stringify(value, null, 2);\n  const bytes = Buffer.byteLength(text, \"utf8\");\n  if (bytes <= maxBytes) {\n    return { truncated: false, bytes, value };\n  }\n  return {\n    truncated: true,\n    bytes,\n    maxBytes,\n    text: Buffer.from(text, \"utf8\").subarray(0, maxBytes).toString(\"utf8\"),\n  };\n}\n\nexport function boundedLineSlice(\n  content: string,\n  window: LineWindow,\n  maxBytes: number,\n): LineSliceResult {\n  const lines = content.match(/[^\\n]*(?:\\n|$)/g) ?? [];\n  if (lines.at(-1) === \"\") {\n    lines.pop();\n  }\n  const slice = lines.slice(window.startLine - 1, window.endLine).join(\"\");\n  const buffer = Buffer.from(slice, \"utf8\");\n  return {\n    available: true,\n    content: buffer.subarray(0, maxBytes).toString(\"utf8\"),\n    bytes: buffer.byteLength,\n    truncated: buffer.byteLength > maxBytes,\n  };\n}\n\nexport function resolveReadAtRefRequest(\n  manifest: DiffManifest,\n  params: ReadAtRefParams,\n): ReadAtRefRequest {\n  const filePath = parseManifestPath(params.path);\n  const ranges = createDiffRangeIndex(manifest);\n  const file = ranges.requireFile(filePath);\n  const range = ranges.requireRangeInFile(file, params.rangeId);\n  const hunk = ranges.requireHunk(file, range);\n  const sourcePath = parseManifestPath(\n    params.ref === \"base\" ? (file.previousPath ?? file.path) : file.path,\n  );\n  return {\n    file,\n    range,\n    hunk,\n    ref: params.ref,\n    sourcePath,\n    window: lineWindowForRange(range, hunk, params.ref),\n  };\n}\n\nexport function unavailableReadAtRefResult(request: ReadAtRefRequest): BaseRangeSnapshot {\n  return {\n    path: request.file.path,\n    ref: request.ref,\n    sourcePath: request.sourcePath,\n    rangeId: request.range.id,\n    startLine: 0,\n    endLine: 0,\n    available: false,\n  };\n}\n\nexport function parseManifestPath(filePath: unknown): string {\n  if (\n    typeof filePath !== \"string\" ||\n    filePath.length === 0 ||\n    filePath.includes(\"\\0\") ||\n    path.isAbsolute(filePath) ||\n    filePath.split(/[\\\\/]/).some((part) => part === \"..\" || part === \".git\" || part === \"\")\n  ) {\n    throw new Error(`Unsafe manifest path '${String(filePath)}'`);\n  }\n  return filePath;\n}\n\nexport function resolveAllowedPath(root: string, filePath: string): string {\n  const resolved = path.resolve(root, filePath);\n  const relative = path.relative(root, resolved);\n  if (relative.startsWith(\"..\") || path.isAbsolute(relative)) {\n    throw new Error(`Path '${filePath}' resolves outside the workspace`);\n  }\n  return resolved;\n}\n\nexport async function assertNoSymlinkPath(root: string, filePath: string): Promise<void> {\n  const parts = filePath.split(/[\\\\/]/);\n  let current = root;\n  for (const part of parts) {\n    current = path.join(current, part);\n    const stats = await lstat(current);\n    if (stats.isSymbolicLink()) {\n      throw new Error(`Path '${filePath}' crosses a symlink`);\n    }\n  }\n}\n\nexport function readDiffParams(params: unknown): ReadDiffParams {\n  return readDiffParamsSchema.parse(params);\n}\n\nexport function readAtRefParams(params: unknown): ReadAtRefParams {\n  const parsed = readAtRefParamsSchema.parse(params);\n  return { path: parseManifestPath(parsed.path), ref: parsed.ref, rangeId: parsed.rangeId };\n}\n\nfunction filterManifestFileRanges(\n  file: DiffManifestFile,\n  rangeId: string | undefined,\n): DiffManifestFile {\n  if (rangeId === undefined) {\n    return file;\n  }\n  return {\n    ...file,\n    commentableRanges: file.commentableRanges.filter((range) => range.id === rangeId),\n  };\n}\n\nfunction lineWindowForRange(\n  range: CommentableRange,\n  hunk: DiffHunk,\n  ref: \"base\" | \"head\",\n): LineWindow | undefined {\n  const targetSide: CommentableRange[\"side\"] = ref === \"base\" ? \"LEFT\" : \"RIGHT\";\n  if (range.side !== targetSide) {\n    return undefined;\n  }\n  const hunkStart = ref === \"base\" ? hunk.oldStart : hunk.newStart;\n  const hunkLines = ref === \"base\" ? hunk.oldLines : hunk.newLines;\n  if (hunkLines === 0) {\n    return undefined;\n  }\n  const hunkEnd = hunkStart + hunkLines - 1;\n  return {\n    startLine: Math.max(hunkStart, range.startLine - readAtRefContextLines),\n    endLine: Math.min(hunkEnd, range.endLine + readAtRefContextLines),\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@usepipr/runtime",
-  "version": "0.3.8",
-  "description": "Runtime package for pipr pull request review automation",
+  "version": "0.4.1",
+  "description": "Runtime package for Pipr code host review automation",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -34,18 +34,22 @@
       "types": "./dist/internal/review-testing.d.mts",
       "default": "./dist/internal/review-testing.mjs"
     },
+    "./internal/docs": {
+      "types": "./dist/internal/docs.d.mts",
+      "default": "./dist/internal/docs.mjs"
+    },
     "./runtime-tools-extension": {
       "types": "./dist/pi/runtime-tools-extension.d.mts",
       "default": "./dist/pi/runtime-tools-extension.mjs"
     }
   },
   "scripts": {
-    "build": "tsdown src/index.ts src/internal/testing.ts src/internal/review-testing.ts src/pi/runtime-tools-extension.ts --dts --format esm --out-dir dist",
+    "build": "tsdown src/index.ts src/internal/testing.ts src/internal/review-testing.ts src/internal/docs.ts src/pi/runtime-tools-extension.ts --dts --format esm --out-dir dist",
     "typecheck": "tsc --noEmit",
     "test": "bun test --timeout 60000",
     "test:config-init": "bun test --timeout 60000 src/config/tests/init.test.ts",
     "test:config-loader": "bun test --timeout 60000 src/config/tests/config.test.ts src/config/tests/sdk-module.test.ts src/config/tests/ts-loader.test.ts",
-    "test:core": "bun test --timeout 60000 src/action/tests src/commands/tests src/diff/tests src/hosts/tests src/hosts/github/tests src/pi/tests src/review/tests src/shared/tests src/tests",
+    "test:core": "bun test --timeout 60000 src/host-run/tests src/commands/tests src/diff/tests src/hosts/tests src/hosts/azure-devops/tests src/hosts/bitbucket/tests src/hosts/github/tests src/hosts/gitlab/tests src/pi/tests src/review/tests src/shared/tests src/tests",
     "lint": "biome lint src",
     "format:check": "biome format src",
     "prepack": "bun run build",
@@ -54,7 +58,7 @@
   "dependencies": {
     "@octokit/rest": "22.0.1",
     "@types/bun": "1.3.14",
-    "@usepipr/sdk": "0.3.8",
+    "@usepipr/sdk": "0.4.1",
     "lodash-es": "4.18.1",
     "picomatch": "4.0.5",
     "typescript": "6.0.3",

package/dist/commands-C5_GHGxN.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"commands-C5_GHGxN.d.mts","names":[],"sources":["../src/config/init.ts","../src/types.ts","../src/config/project.ts","../src/review/prior-state.ts","../src/review/comment.ts","../src/review/publication-result.ts","../src/hosts/types.ts","../src/hosts/github/command.ts","../src/hosts/github/publication-client.ts","../src/shared/logging.ts","../src/pi/contract.ts","../src/review/task/task-output.ts","../src/review/task/task-runtime.ts","../src/action/types.ts","../src/action/commands.ts"],"mappings":"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"}