clud-bug 0.6.34 → 0.7.0-rc.11

package/dist/core/review-writeback.js

@@ -0,0 +1,364 @@
+// SPEC §1.8.1 doc-file renderer for `docs/reviews/PR-<n>.md`.
+//
+// This is the PURE rendering half of the App's `lib/review-writeback.ts`.
+// The Octokit-side WRITEBACK (branch detection, idempotent rewrite,
+// Contents-API commit) stays App-side — that surface depends on Octokit
+// which we don't want to pull into core.
+//
+// Renamed from the App's `renderReview` to `renderReviewFile` to avoid
+// colliding with the CLI's existing `renderReview` (which renders the
+// summary-PR-comment shape, not the doc-file). Both renderers coexist:
+//   - `renderReview` (./render-review.ts) → `## 🐛 Clud Bug review` PR comment
+//   - `renderReviewFile` (this module)    → `# clud-bug review — PR #N` doc file
+//
+// SPEC pins honored here:
+//   - `<!-- protocol-version: 0.1.0 -->`             — SPEC version.
+//   - `<!-- written-by: clud-bug[bot] -->`           — App identity, not Action.
+//   - `<!-- review-sha: <40-char-head-sha> -->`      — pinned to review-time HEAD.
+//   - Severity bucket order: red → yellow → purple.
+//   - Empty buckets omitted entirely (no empty headers).
+//   - "Resolved this round:" and "Still open:" blocks omitted when empty
+//     (D.2.0 always omits — multi-pass is D.2.5).
+//   - Trailing `---\n[Link to PR](<url>)` line preserved verbatim.
+//   - Emoji codepoints: U+1F534, U+1F7E1, U+1F7E3, NFC-normalized.
+import { deriveSkillsReferenced, deriveSummaryCounts, flattenFindings, } from './review-schema-zod.js';
+/** Protocol version this implementation emits. */
+export const PROTOCOL_VERSION = '0.1.0';
+/** "Written by" tag for the App writeback (SPEC §6.1). */
+export const WRITTEN_BY = 'clud-bug[bot]';
+// Severity emoji per SPEC §1.8.1. We define them by codepoint so a stray
+// editor that switches encoding can't silently break byte-equality with
+// the Action-runner output. Same constants as render-review.ts but kept
+// local so this module is independent of the CLI renderer.
+export const SEVERITY_EMOJI = {
+    critical: '\u{1F534}', // U+1F534 RED CIRCLE
+    minor: '\u{1F7E1}', // U+1F7E1 YELLOW CIRCLE
+    preexisting: '\u{1F7E3}', // U+1F7E3 PURPLE CIRCLE
+};
+/**
+ * Renders the review object to the SPEC §1.8.1 markdown template.
+ *
+ * Pure: no I/O, no time-of-day, no provider info — fixture-stable.
+ *
+ * NB: This produces the doc-file shape (`# clud-bug review — PR #N` H1).
+ * The CLI's `renderReview` produces the PR-comment shape (`## 🐛 Clud Bug
+ * review` H2). Both are valid review outputs; SPEC §6.2 says they share
+ * the underlying finding data but differ in container.
+ */
+export function renderReviewFile(input) {
+    const { review, prNumber, headSha, prUrl, resolvedFindings, stillOpenFindings, cacheStats, } = input;
+    // Wire-shape Review carries findings in 3 severity arrays. Flatten to
+    // internal `Finding[]` so the renderer's bucketing, count-derivation,
+    // and per-skill aggregation can work uniformly.
+    const findings = flattenFindings(review);
+    // Always derive these from findings to guarantee they match what we
+    // actually render. The model can drift on counts; we don't trust it.
+    const counts = deriveSummaryCounts(findings);
+    const skillsReferenced = deriveSkillsReferenced(findings);
+    const lines = [];
+    lines.push(`# clud-bug review — PR #${prNumber}`);
+    lines.push(`<!-- protocol-version: ${PROTOCOL_VERSION} -->`);
+    lines.push(`<!-- written-by: ${WRITTEN_BY} -->`);
+    lines.push(`<!-- review-sha: ${headSha} -->`);
+    // SPEC §6.7.3: cache telemetry comment goes immediately below the
+    // review-sha so a single grep can pull review-sha + cache stats out
+    // of a doc-file without re-parsing the whole block. Omitted entirely
+    // when cacheStats is undefined.
+    if (cacheStats !== undefined) {
+        lines.push(`<!-- cache: ${cacheStats.cachedInputTokens} read · ${cacheStats.cacheCreationInputTokens} created -->`);
+    }
+    lines.push('');
+    // Summary line — SPEC §1.8.1 wording.
+    lines.push(`**Summary:** ${counts.critical} critical · ${counts.minor} minor · ${counts.preexisting} preexisting · ${counts.resolved_from_prior} resolved-from-prior · ${counts.still_open} still-open`);
+    lines.push('');
+    // Skills cited block — group findings per skill for citation counts.
+    lines.push('**Skills cited:**');
+    if (skillsReferenced.length === 0) {
+        lines.push('- _(none — see summary above)_');
+    }
+    else {
+        for (const slug of skillsReferenced) {
+            const count = findings.filter((f) => f.skill === slug).length;
+            lines.push(`- ${slug} (${count} finding${count === 1 ? '' : 's'})`);
+        }
+    }
+    lines.push('');
+    lines.push('**Findings:**');
+    lines.push('');
+    // Severity buckets in SPEC order; empty buckets are omitted entirely.
+    const bucketed = bucketBySeverity(findings);
+    if (bucketed.critical.length > 0) {
+        lines.push(`### ${SEVERITY_EMOJI.critical} Critical`);
+        for (const f of bucketed.critical)
+            lines.push(renderFinding(f, true));
+        lines.push('');
+    }
+    if (bucketed.minor.length > 0) {
+        lines.push(`### ${SEVERITY_EMOJI.minor} Minor`);
+        for (const f of bucketed.minor)
+            lines.push(renderFinding(f, false));
+        lines.push('');
+    }
+    if (bucketed.preexisting.length > 0) {
+        lines.push(`### ${SEVERITY_EMOJI.preexisting} Preexisting (informational)`);
+        for (const f of bucketed.preexisting)
+            lines.push(renderFinding(f, false));
+        lines.push('');
+    }
+    // SPEC §1.8.1 Resolved this round / Still open blocks. Omitted
+    // entirely when the corresponding input list is empty/undefined.
+    //
+    // Bullet shape (one finding per line):
+    //   - `path/file.ts:42` — `critical-issues-only`: null-deref ... (was 🔴 Critical)
+    //
+    // The `(was <emoji> <Severity>)` suffix carries the SEVERITY at the
+    // time the finding was last seen so a downgrade across rounds is
+    // visible without diffing the two doc files. Note: backticks around
+    // file and skill render in markdown viewers as inline-code, which
+    // makes the file path scannable in the GitHub UI.
+    if (resolvedFindings !== undefined && resolvedFindings.length > 0) {
+        lines.push('**Resolved this round:**');
+        for (const f of resolvedFindings) {
+            lines.push(renderDiffFinding(f));
+        }
+        lines.push('');
+    }
+    if (stillOpenFindings !== undefined && stillOpenFindings.length > 0) {
+        lines.push('**Still open:**');
+        for (const f of stillOpenFindings) {
+            lines.push(renderDiffFinding(f));
+        }
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push('');
+    lines.push(`[Link to PR](${prUrl})`);
+    // Final NFC normalization — guarantees the emoji codepoints stay
+    // composed even if a future renderer step decomposes them.
+    return lines.join('\n').normalize('NFC') + '\n';
+}
+function bucketBySeverity(findings) {
+    return {
+        critical: findings.filter((f) => f.severity === 'critical'),
+        minor: findings.filter((f) => f.severity === 'minor'),
+        preexisting: findings.filter((f) => f.severity === 'preexisting'),
+    };
+}
+/**
+ * Renders one finding for the SPEC §1.8.1 Resolved / Still-open blocks.
+ * Output shape:
+ *
+ *   - `path/file.ts:42` — `critical-issues-only`: null-deref ... (was 🔴 Critical)
+ *
+ * Line `0` is treated as "no anchor" (cross-cutting / missing) and the
+ * `:N` suffix is omitted. The severity label uses the SPEC §1.8.1
+ * emoji + label so a reader can see at a glance whether the finding
+ * was downgraded (different severity in current round) or merely
+ * resolved.
+ */
+function renderDiffFinding(f) {
+    const location = f.line > 0 ? `${f.file}:${f.line}` : f.file;
+    const label = f.severity === 'critical'
+        ? 'Critical'
+        : f.severity === 'minor'
+            ? 'Minor'
+            : 'Preexisting';
+    const emoji = SEVERITY_EMOJI[f.severity];
+    return `- \`${location}\` — \`${f.skillName}\`: ${f.summary} (was ${emoji} ${label})`;
+}
+function renderFinding(f, includeReasoning) {
+    // findingItemSchema.file is z.string().optional() — the model is
+    // instructed to always provide it, but Zod doesn't enforce. Without
+    // the fallback an absent file would emit literal "undefined" in the
+    // committed SPEC §1.8.1 doc file. clud-bug-review #158 flagged this.
+    const fileLabel = f.file ?? '(unknown file)';
+    const location = f.line ? `${fileLabel}:${f.line}` : fileLabel;
+    // Per SPEC §1.8.1: "**<file>:<line>** — <skill-name>: <one-line summary>".
+    const head = `- **${location}** — ${f.skill}: ${f.summary}`;
+    // Reasoning line is documented for the Critical bucket; we follow the
+    // SPEC template strictly. For Minor/Preexisting, no reasoning line.
+    if (includeReasoning && f.reasoning) {
+        return `${head}\n  Reasoning: ${f.reasoning}`;
+    }
+    return head;
+}
+/**
+ * Renders a multi-pass review with per-pass attribution lines.
+ *
+ * Output layout (SPEC §1.8.5):
+ *
+ *   # clud-bug review — PR #N (M passes · mode)
+ *   <!-- protocol-version: ... -->
+ *   <!-- written-by: clud-bug[bot] -->
+ *   <!-- review-sha: ... -->
+ *   <!-- passes: M -->
+ *   <!-- mode: cross-check|consensus|independent -->
+ *
+ *   **Summary:** ... · **Verdict:** request_changes / review_only / clean
+ *
+ *   **Reviewers:**
+ *     - Pass 1 — Beetle · anthropic/claude-sonnet-4.6
+ *     - Pass 2 — Wasp   · anthropic/claude-opus-4.7
+ *
+ *   **Skills cited:** ...
+ *
+ *   **Findings:**
+ *
+ *   ### (red) Critical
+ *   - [Pass 1 — Beetle · Sonnet 4.6] auth.ts:42 — race-conditions: Race condition
+ *     Reasoning: ...
+ *     [Pass 2 — Wasp · Opus 4.7]: (check) AGREED — same finding identified independently.
+ *
+ *   ...
+ *
+ *   ---
+ *   [Link to PR](...)
+ *
+ * Pure: no I/O, no time-of-day, fixture-stable.
+ */
+export function renderMultiPassMarkdown(input) {
+    const { review, prNumber, headSha, prUrl } = input;
+    const lines = [];
+    lines.push(`# clud-bug review — PR #${prNumber} (${review.passCount} ${review.passCount === 1 ? 'pass' : 'passes'} · ${review.mode})`);
+    lines.push(`<!-- protocol-version: ${PROTOCOL_VERSION} -->`);
+    lines.push(`<!-- written-by: ${WRITTEN_BY} -->`);
+    lines.push(`<!-- review-sha: ${headSha} -->`);
+    lines.push(`<!-- passes: ${review.passCount} -->`);
+    lines.push(`<!-- mode: ${review.mode} -->`);
+    lines.push('');
+    const counts = review.summary_counts;
+    lines.push(`**Summary:** ${counts.critical} critical · ${counts.minor} minor · ${counts.preexisting} preexisting · ${counts.resolved_from_prior} resolved-from-prior · ${counts.still_open} still-open · **Verdict:** ${review.verdict}`);
+    lines.push('');
+    lines.push('**Reviewers:**');
+    for (const r of review.roles) {
+        lines.push(`- Pass ${r.passNumber} — ${r.roleName} · ${r.model}`);
+    }
+    lines.push('');
+    lines.push('**Skills cited:**');
+    if (review.skills_referenced.length === 0) {
+        lines.push('- _(none — see summary above)_');
+    }
+    else {
+        for (const slug of review.skills_referenced) {
+            const count = review.findings.filter((f) => f.skill === slug).length;
+            lines.push(`- ${slug} (${count} finding${count === 1 ? '' : 's'})`);
+        }
+    }
+    lines.push('');
+    lines.push('**Findings:**');
+    lines.push('');
+    // Severity buckets in SPEC order; empty buckets are omitted entirely.
+    const bucketed = bucketUnifiedBySeverity(review.findings);
+    if (bucketed.critical.length > 0) {
+        lines.push(`### ${SEVERITY_EMOJI.critical} Critical`);
+        for (const f of bucketed.critical)
+            lines.push(renderUnifiedFinding(f, /* includeReasoning */ true));
+        lines.push('');
+    }
+    if (bucketed.minor.length > 0) {
+        lines.push(`### ${SEVERITY_EMOJI.minor} Minor`);
+        for (const f of bucketed.minor)
+            lines.push(renderUnifiedFinding(f, false));
+        lines.push('');
+    }
+    if (bucketed.preexisting.length > 0) {
+        lines.push(`### ${SEVERITY_EMOJI.preexisting} Preexisting (informational)`);
+        for (const f of bucketed.preexisting)
+            lines.push(renderUnifiedFinding(f, false));
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push('');
+    lines.push(`[Link to PR](${prUrl})`);
+    return lines.join('\n').normalize('NFC') + '\n';
+}
+function bucketUnifiedBySeverity(findings) {
+    return {
+        critical: findings.filter((f) => f.severity === 'critical'),
+        minor: findings.filter((f) => f.severity === 'minor'),
+        preexisting: findings.filter((f) => f.severity === 'preexisting'),
+    };
+}
+/**
+ * Renders one finding with inline per-pass attribution. The headline carries
+ * the FIRST attribution (whichever pass raised the issue); subsequent
+ * attributions appear on indented sub-lines:
+ *
+ *   - [Pass 1 — Beetle · sonnet] auth.ts:42 — race: Race condition
+ *     Reasoning: ...
+ *     [Pass 2 — Wasp · opus]: (check) AGREED — confirmed by independent review.
+ *     [Pass 3 — Mantis · opus]: (x) DISAGREED — guarded by the surrounding lock.
+ *
+ * The headline always tracks the FIRST attribution to preserve the SPEC
+ * §1.8.1 grep pattern (`**<file>:<line>** — <skill>: <summary>`).
+ */
+function renderUnifiedFinding(f, includeReasoning) {
+    // Same guard as renderFinding — findingItemSchema.file is optional.
+    const fileLabel = f.file ?? '(unknown file)';
+    const location = f.line ? `${fileLabel}:${f.line}` : fileLabel;
+    const head = f.attributions[0];
+    if (!head) {
+        // Defensive — shouldn't happen; the aggregator guarantees ≥1 attribution.
+        return `- **${location}** — ${f.skill}: ${f.summary}`;
+    }
+    const headLabel = formatAttributionLabel(head);
+    const lines = [];
+    lines.push(`- ${headLabel} **${location}** — ${f.skill}: ${f.summary}`);
+    if (includeReasoning && f.reasoning) {
+        lines.push(`  Reasoning: ${f.reasoning}`);
+    }
+    for (let i = 1; i < f.attributions.length; i++) {
+        const a = f.attributions[i];
+        if (!a)
+            continue;
+        lines.push(`  ${formatFollowupAttribution(a)}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * The leading bracket on the head line. Example:
+ *
+ *   [Pass 1 — Beetle · anthropic/claude-sonnet-4.6]
+ *   [Pass 2 — Wasp · anthropic/claude-opus-4.7 — found independently]
+ *
+ * "found independently" only fires when the head attribution is NOT
+ * `source: 'first'` — i.e. when a later pass surfaced this finding without
+ * Pass 1 raising it.
+ */
+function formatAttributionLabel(a) {
+    const independent = a.source === 'independent' && a.passNumber > 1
+        ? ' — found independently'
+        : '';
+    return `[Pass ${a.passNumber} — ${a.roleName} · ${a.model}${independent}]`;
+}
+/**
+ * Subsequent-line attribution. Example:
+ *
+ *   [Pass 2 — Wasp · opus]: ✅ AGREED — confirmed.
+ *   [Pass 3 — Mantis · opus]: ❌ DISAGREED — guarded by surrounding lock.
+ */
+function formatFollowupAttribution(a) {
+    const verdictSymbol = a.source === 'agreed'
+        ? '✅ AGREED' // U+2705 WHITE HEAVY CHECK MARK
+        : a.source === 'disagreed'
+            ? '❌ DISAGREED' // U+274C CROSS MARK
+            : a.source === 'independent'
+                ? 'INDEPENDENTLY FLAGGED'
+                : 'NOTED';
+    const note = a.note ? ` — ${a.note}` : '';
+    const disputed = a.source === 'disagreed' ? ' (Disputed — human decides.)' : '';
+    return `[Pass ${a.passNumber} — ${a.roleName} · ${a.model}]: ${verdictSymbol}${note}${disputed}`;
+}
+/** SPEC §6.1 / §1.8 path. The App's Octokit writeback uses this. */
+export function reviewFilePath(prNumber) {
+    return `docs/reviews/PR-${prNumber}.md`;
+}
+/**
+ * SPEC §6.1 commit message: exactly `[skip-logmind] clud-bug review: PR #<n>`.
+ * The `[skip-logmind]` prefix tells `check-decisions.yml` to ignore this
+ * commit (SPEC §6.4). The App's Octokit writeback uses this.
+ */
+export function reviewCommitMessage(prNumber) {
+    return `[skip-logmind] clud-bug review: PR #${prNumber}`;
+}
+//# sourceMappingURL=review-writeback.js.map

package/dist/core/review-writeback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-writeback.js","sourceRoot":"","sources":["../../src/core/review-writeback.ts"],"names":[],"mappings":"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"}

package/dist/core/skills.d.ts

@@ -0,0 +1,147 @@
+export declare const API_BASE = "https://skills.sh/api/v1";
+export declare const MAX_SKILLS = 8;
+export interface SkillDescriptor {
+    source: string;
+    name: string;
+    description: string;
+    installs: number;
+    kind?: string;
+    content?: string;
+}
+type RawSkillItem = {
+    source?: string;
+    repo?: string;
+    name?: string;
+    slug?: string;
+    description?: string;
+    summary?: string;
+    installs?: number;
+    installCount?: number;
+};
+type RawSkillListResponse = RawSkillItem[] | {
+    skills?: RawSkillItem[];
+    results?: RawSkillItem[];
+} | unknown;
+export declare function normalizeList(data: RawSkillListResponse): SkillDescriptor[];
+interface SkillsClientOptions {
+    fetch?: typeof globalThis.fetch;
+    base?: string;
+    userAgent?: string;
+}
+export declare class SkillsClient {
+    #private;
+    private readonly fetch;
+    private readonly base;
+    private readonly userAgent;
+    constructor({ fetch, base, userAgent }?: SkillsClientOptions);
+    search(terms: string[]): Promise<SkillDescriptor[]>;
+    curated(): Promise<SkillDescriptor[]>;
+    getContent(source: string, name: string): Promise<string>;
+}
+export interface RankableSkill extends SkillDescriptor {
+    kind?: string;
+}
+export declare function rankAndCap(curated: RankableSkill[], searched: RankableSkill[], baseline: RankableSkill[], cap?: number): RankableSkill[];
+export declare function readReviewMode(skillContent: unknown): 'shared' | 'dedicated';
+export interface AppliesToRule {
+    paths: string[];
+    extensions: string[];
+}
+export declare function readAppliesTo(skillContent: unknown): AppliesToRule | null;
+export declare function appliesToPr(skillContent: unknown, prPaths: unknown): boolean;
+export declare function appliesToAuthor(skillContent: unknown, prAuthor: unknown): boolean;
+export interface SkillWithOptionalContent {
+    content?: unknown;
+    [key: string]: unknown;
+}
+export declare function partitionByReviewMode<T extends SkillWithOptionalContent>(skills: T[]): {
+    shared: T[];
+    dedicated: T[];
+};
+export declare function extractPerSkillLine(comment: unknown, skillName: unknown): string | null;
+export interface PrComment {
+    body?: unknown;
+    user?: {
+        login?: unknown;
+    };
+    created_at?: unknown;
+}
+export declare function selectReviewHeader(comments: unknown, botLogin: unknown): string | null;
+export declare function extractFirstReviewHeaderLine(body: unknown): string | null;
+export declare function selectReviewBody(comments: unknown, botLogin: unknown): string | null;
+export interface ReviewStatsHeader {
+    important: number;
+    nit: number;
+    preExisting: number;
+}
+export declare function extractStatsHeader(comment: unknown): ReviewStatsHeader | null;
+export declare function isCriticalReviewHeader(headerLine: unknown): boolean;
+export declare function classifyPerSkillOutcome(outcomeLine: unknown): 'failure' | 'success';
+/** Source provenance for an installed skill (see SPEC §1.10). */
+export type SkillSource = 'manual' | 'logmind-derived' | 'skills-sh' | 'clud-bug-baseline';
+export type SkillReviewMode = 'shared' | 'dedicated';
+/**
+ * Parsed SKILL.md frontmatter. The App uses this shape (see
+ * `clud-bug-app/lib/skills-loader.ts:40`); the prompt builder's
+ * `PromptSkillFrontmatter` is a narrower subset (name + description +
+ * applies_to) so we keep the full shape here.
+ */
+export type SkillKind = 'rule' | 'voice';
+export type VoiceScope = 'personal' | 'team' | 'org' | 'community';
+export interface SkillFrontmatter {
+    name: string;
+    description: string;
+    source: SkillSource | string;
+    review_mode: SkillReviewMode;
+    /**
+     * SPEC §1.10.1 v0.5.0+ skill classification. OPTIONAL — absent =
+     * `kind: rule` (the v0.4.0 default). Surfaced on the parsed
+     * frontmatter (v0.7.0-rc.6+) so consumers can route on the field;
+     * v0.7.0-rc.5 and earlier silently dropped it.
+     */
+    kind?: SkillKind;
+    /**
+     * SPEC §1.10.1 v0.5.0+ voice scope. REQUIRED when `kind: voice`,
+     * absent otherwise. Surfaced on the parsed frontmatter (v0.7.0-rc.6+).
+     */
+    voice_scope?: VoiceScope;
+    applies_to?: {
+        paths?: string[];
+        extensions?: string[];
+        /**
+         * SPEC §1.10.1 v0.5.1+ — single GitHub login string (no `@`
+         * prefix, no list). When present, the skill MUST only load when
+         * `pull_request.user.login === author`. Filters via strict AND
+         * with the sibling `paths` + `extensions` filters when all are
+         * present. v0.7.0-rc.5 and earlier silently dropped this field
+         * (treated skills as if it were absent — load unconditionally);
+         * v0.7.0-rc.6+ enforces the filter via `appliesToAuthor`.
+         */
+        author?: string;
+    };
+}
+/**
+ * Minimal YAML frontmatter parser. Handles:
+ *   - `key: value`            (scalar)
+ *   - `key: [a, b, c]`        (inline list)
+ *   - `key:\n  subkey: value` (one-level nesting — applies_to)
+ *
+ * Throws on malformed input; the App's `loadSkillsFromBaseRef` catches
+ * and skips the skill (a bad SKILL.md doesn't take down the whole review).
+ *
+ * Deliberately NOT a general-purpose YAML parser — SPEC §1.10 fixes the
+ * frontmatter schema to a handful of fields. If the schema grows beyond
+ * what this hand-rolled parser handles, swap to `js-yaml` — the boundary
+ * is this function.
+ */
+export declare function parseFrontmatter(raw: string): SkillFrontmatter;
+/**
+ * Strip the leading `---\n...\n---\n` from a SKILL.md file. Returns the
+ * markdown body (the part the LLM actually reads).
+ *
+ * Ported from `clud-bug-app/lib/skills-loader.ts:269` so callers don't have
+ * to re-implement the regex.
+ */
+export declare function stripFrontmatter(raw: string): string;
+export {};
+//# sourceMappingURL=skills.d.ts.map

package/dist/core/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/core/skills.ts"],"names":[],"mappings":"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"}