@slope-dev/slope 1.5.1

package/dist/core/formatter.js

@@ -0,0 +1,301 @@
+import { normalizeStats } from './builder.js';
+// --- Helpers ---
+function pct(num, den) {
+    if (den === 0)
+        return '0%';
+    return `${Math.round((num / den) * 1000) / 10}%`;
+}
+function delta(n) {
+    if (n == null || n === 0)
+        return '—';
+    return `+${n}`;
+}
+const MISS_LABELS = {
+    long: 'Long (over-engineered)',
+    short: 'Short (under-scoped)',
+    left: 'Left (wrong approach)',
+    right: 'Right (spec drift)',
+};
+const PLAIN_RESULTS = {
+    in_the_hole: 'Completed perfectly',
+    green: 'Completed with some hiccups',
+    fairway: 'Good start',
+    missed_long: 'Over-engineered',
+    missed_short: 'Under-scoped',
+    missed_left: 'Wrong approach taken',
+    missed_right: 'Drifted from spec',
+};
+const PLAIN_CLUBS = {
+    driver: 'High-risk approach',
+    long_iron: 'Complex approach',
+    short_iron: 'Standard approach',
+    wedge: 'Simple fix',
+    putter: 'Trivial fix',
+};
+const PLAIN_SCORES = {
+    eagle: 'Well ahead of schedule',
+    birdie: 'Ahead of schedule',
+    par: 'On schedule',
+    bogey: 'Took longer than expected',
+    double_bogey: 'Significantly over time',
+    triple_plus: 'Major overrun',
+};
+function titleCase(s) {
+    return s.replace(/\b\w/g, c => c.toUpperCase());
+}
+function safeBunkerLabel(b) {
+    if (typeof b === 'string')
+        return b;
+    if (b && typeof b === 'object')
+        return b.area ?? String(b);
+    return String(b);
+}
+// --- Formatter ---
+/**
+ * Format a SLOPE scorecard into a markdown sprint review.
+ *
+ * If projectStats is provided, renders a project stats table.
+ * If omitted, skips the infrastructure section entirely.
+ */
+export function formatSprintReview(card, projectStats, deltas, mode = 'technical', metaphor) {
+    if (mode === 'plain') {
+        return formatPlainReview(card, projectStats, deltas);
+    }
+    const m = metaphor;
+    const sprintNum = card.sprint_number ?? card.sprint;
+    const stats = normalizeStats(card.stats, card.shots?.length ?? 0);
+    const shots = card.shots ?? [];
+    const conditions = card.conditions ?? [];
+    const bunkerLocations = card.bunker_locations ?? [];
+    const courseNotes = card.course_management_notes ?? [];
+    const lines = [];
+    lines.push(`## Sprint ${sprintNum} Review: ${card.theme}`);
+    lines.push('');
+    lines.push('### SLOPE Scorecard Summary');
+    lines.push('');
+    lines.push('| Metric | Value |');
+    lines.push('|---|---|');
+    lines.push(`| Par | ${card.par} |`);
+    lines.push(`| Slope | ${card.slope} |`);
+    lines.push(`| Score | ${card.score} |`);
+    lines.push(`| Label | ${m?.scoreLabels[card.score_label] ?? card.score_label} |`);
+    lines.push(`| Fairway % | ${pct(stats.fairways_hit, stats.fairways_total)} (${stats.fairways_hit}/${stats.fairways_total}) |`);
+    lines.push(`| GIR % | ${pct(stats.greens_in_regulation, stats.greens_total)} (${stats.greens_in_regulation}/${stats.greens_total}) |`);
+    lines.push(`| Putts | ${stats.putts} |`);
+    lines.push(`| Penalties | ${stats.penalties} |`);
+    if (stats.hazard_penalties > 0) {
+        lines.push(`| Hazard Penalties | ${stats.hazard_penalties} |`);
+    }
+    lines.push('');
+    if (projectStats) {
+        lines.push('### Project Stats');
+        lines.push('');
+        lines.push('| Category | Count | Delta |');
+        lines.push('|---|---|---|');
+        for (const [key, value] of Object.entries(projectStats)) {
+            if (typeof value === 'number') {
+                const d = deltas?.[key];
+                lines.push(`| ${key} | ${value} | ${delta(d)} |`);
+            }
+            else if (typeof value === 'object' && value !== null) {
+                const total = Object.values(value).reduce((sum, v) => sum + v, 0);
+                const d = deltas?.[key];
+                lines.push(`| ${key} | ${total} | ${delta(d)} |`);
+                const breakdown = Object.entries(value).map(([k, v]) => `${v} ${k}`).join(' + ');
+                lines.push('');
+                lines.push(`> ${breakdown}`);
+            }
+        }
+        lines.push('');
+    }
+    lines.push(`### Shot-by-Shot (Tickets Delivered: ${shots.length})`);
+    lines.push('');
+    lines.push('| Ticket | Club | Result | Hazards | Notes |');
+    lines.push('|---|---|---|---|---|');
+    for (const shot of shots) {
+        const hazards = (shot.hazards ?? []).length > 0
+            ? shot.hazards.map(h => `${m?.hazards[h.type] ?? h.type}: ${h.description ?? 'unknown'}`).join('; ')
+            : '—';
+        const notes = shot.notes ?? '—';
+        lines.push(`| ${shot.ticket_key} | ${m?.clubs[shot.club] ?? shot.club} | ${m?.shotResults[shot.result] ?? shot.result} | ${hazards} | ${notes} |`);
+    }
+    lines.push('');
+    const missTotal = stats.miss_directions.long + stats.miss_directions.short +
+        stats.miss_directions.left + stats.miss_directions.right;
+    if (missTotal > 0) {
+        lines.push('### Miss Pattern');
+        lines.push('');
+        lines.push('| Direction | Count |');
+        lines.push('|---|---|');
+        for (const dir of ['long', 'short', 'left', 'right']) {
+            const count = stats.miss_directions[dir];
+            if (count > 0) {
+                lines.push(`| ${m?.missDirections[dir] ?? MISS_LABELS[dir]} | ${count} |`);
+            }
+        }
+        lines.push('');
+    }
+    if (conditions.length > 0) {
+        lines.push('### Conditions');
+        lines.push('');
+        lines.push('| Condition | Impact | Description |');
+        lines.push('|---|---|---|');
+        for (const c of conditions) {
+            lines.push(`| ${m?.conditions[c.type] ?? c.type} | ${c.impact} | ${c.description} |`);
+        }
+        lines.push('');
+    }
+    const allHazards = shots.flatMap(s => (s.hazards ?? []).map(h => ({ ...h, ticket: s.ticket_key })));
+    if (allHazards.length > 0 || bunkerLocations.length > 0) {
+        lines.push('### Hazards Discovered');
+        lines.push('');
+        if (allHazards.length > 0) {
+            lines.push('| Type | Ticket | Description |');
+            lines.push('|---|---|---|');
+            for (const h of allHazards) {
+                lines.push(`| ${m?.hazards[h.type] ?? h.type} | ${h.ticket} | ${h.description ?? 'unknown'} |`);
+            }
+            lines.push('');
+        }
+        if (bunkerLocations.length > 0) {
+            lines.push('**Known hazards for future sprints:**');
+            for (const b of bunkerLocations) {
+                lines.push(`- ${safeBunkerLabel(b)}`);
+            }
+            lines.push('');
+        }
+    }
+    if (card.training && card.training.length > 0) {
+        lines.push('### Training Log');
+        lines.push('');
+        lines.push('| Type | Description | Outcome |');
+        lines.push('|---|---|---|');
+        for (const t of card.training) {
+            lines.push(`| ${m?.trainingTypes[t.type] ?? t.type} | ${t.description} | ${t.outcome} |`);
+        }
+        lines.push('');
+    }
+    if (card.nutrition && card.nutrition.length > 0) {
+        lines.push('### Nutrition Check (Development Health)');
+        lines.push('');
+        lines.push('| Category | Status | Notes |');
+        lines.push('|---|---|---|');
+        for (const n of card.nutrition) {
+            lines.push(`| ${m?.nutrition[n.category] ?? n.category} | ${n.status} | ${n.description} |`);
+        }
+        lines.push('');
+    }
+    if (courseNotes.length > 0) {
+        lines.push('### Course Management Notes');
+        lines.push('');
+        for (const note of courseNotes) {
+            lines.push(`- ${note}`);
+        }
+        lines.push('');
+    }
+    if (card.nineteenth_hole) {
+        const nh = card.nineteenth_hole;
+        const reviewLabel = m ? titleCase(m.vocabulary.review) : '19th Hole';
+        lines.push(`### ${reviewLabel}`);
+        lines.push('');
+        if (nh.how_did_it_feel)
+            lines.push(`- **How did it feel?** ${nh.how_did_it_feel}`);
+        if (nh.advice_for_next_player)
+            lines.push(`- **Advice for next player?** ${nh.advice_for_next_player}`);
+        if (nh.what_surprised_you)
+            lines.push(`- **What surprised you?** ${nh.what_surprised_you}`);
+        if (nh.excited_about_next)
+            lines.push(`- **Excited about next?** ${nh.excited_about_next}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function formatAdvisorReport(input, metaphor) {
+    const { clubRecommendation, trainingPlan, hazardWarnings } = input;
+    const m = metaphor;
+    const lines = [];
+    if (clubRecommendation) {
+        lines.push('### CLUB RECOMMENDATION');
+        lines.push('');
+        lines.push(`**Club:** ${m?.clubs[clubRecommendation.club] ?? clubRecommendation.club}`);
+        lines.push(`**Confidence:** ${Math.round(clubRecommendation.confidence * 100)}%`);
+        lines.push('');
+        for (const reason of clubRecommendation.reasoning.split('. ').filter(Boolean)) {
+            lines.push(`- ${reason.endsWith('.') ? reason : reason + '.'}`);
+        }
+        if (clubRecommendation.provisional_suggestion) {
+            lines.push('');
+            lines.push(`> ${clubRecommendation.provisional_suggestion}`);
+        }
+        lines.push('');
+    }
+    const filtered = trainingPlan?.filter(t => t.priority === 'high' || t.priority === 'medium') ?? [];
+    if (filtered.length > 0) {
+        lines.push('### TRAINING RECOMMENDATIONS');
+        lines.push('');
+        lines.push('| Priority | Area | Type | Recommendation |');
+        lines.push('|---|---|---|---|');
+        for (const item of filtered) {
+            const adjustment = item.instruction_adjustment ?? item.description;
+            lines.push(`| ${item.priority} | ${item.area} | ${m?.trainingTypes[item.type] ?? item.type} | ${adjustment} |`);
+        }
+        lines.push('');
+    }
+    if (hazardWarnings && hazardWarnings.length > 0) {
+        lines.push('### HAZARD WARNINGS');
+        lines.push('');
+        for (const warning of hazardWarnings) {
+            lines.push(`- ${warning}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// --- Plain mode formatter ---
+function formatPlainReview(card, projectStats, deltas) {
+    const sprintNum = card.sprint_number ?? card.sprint;
+    const shots = card.shots ?? [];
+    const lines = [];
+    lines.push(`## Sprint ${sprintNum}: ${card.theme}`);
+    lines.push('');
+    const scoreDesc = PLAIN_SCORES[card.score_label] ?? card.score_label;
+    lines.push(`**Status:** ${scoreDesc}`);
+    lines.push(`**Tickets:** ${shots.length} delivered`);
+    lines.push('');
+    lines.push('### Tickets');
+    lines.push('');
+    lines.push('| Ticket | Approach | Outcome | Notes |');
+    lines.push('|---|---|---|---|');
+    for (const shot of shots) {
+        const approach = PLAIN_CLUBS[shot.club] ?? shot.club;
+        const outcome = PLAIN_RESULTS[shot.result] ?? shot.result;
+        const notes = shot.notes ?? '—';
+        lines.push(`| ${shot.ticket_key} | ${approach} | ${outcome} | ${notes} |`);
+    }
+    lines.push('');
+    if (projectStats) {
+        lines.push('### System Stats');
+        lines.push('');
+        for (const [key, value] of Object.entries(projectStats)) {
+            if (typeof value === 'number') {
+                const d = deltas?.[key];
+                lines.push(`- **${key}:** ${value} ${d ? `(+${d})` : ''}`);
+            }
+        }
+        lines.push('');
+    }
+    if (card.nineteenth_hole) {
+        const nh = card.nineteenth_hole;
+        lines.push('### Reflection');
+        lines.push('');
+        if (nh.how_did_it_feel)
+            lines.push(`- ${nh.how_did_it_feel}`);
+        if (nh.advice_for_next_player)
+            lines.push(`- **Tip:** ${nh.advice_for_next_player}`);
+        if (nh.excited_about_next)
+            lines.push(`- **Next:** ${nh.excited_about_next}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=formatter.js.map

package/dist/core/formatter.js.map

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

package/dist/core/guard.d.ts

@@ -0,0 +1,124 @@
+/** Input from Claude Code PreToolUse/PostToolUse hooks (JSON on stdin) */
+export interface HookInput {
+    session_id: string;
+    transcript_path?: string;
+    cwd: string;
+    permission_mode?: string;
+    hook_event_name: string;
+    tool_name?: string;
+    tool_input?: Record<string, unknown>;
+    tool_response?: Record<string, unknown>;
+    tool_use_id?: string;
+}
+/** Output for PreToolUse hooks */
+export interface PreToolUseOutput {
+    hookSpecificOutput: {
+        hookEventName: 'PreToolUse';
+        permissionDecision?: 'allow' | 'deny' | 'ask';
+        permissionDecisionReason?: string;
+        additionalContext?: string;
+        updatedInput?: Record<string, unknown>;
+    };
+}
+/** Output for PostToolUse hooks */
+export interface PostToolUseOutput {
+    decision?: 'block';
+    reason?: string;
+    hookSpecificOutput?: {
+        hookEventName: 'PostToolUse';
+        additionalContext?: string;
+    };
+}
+/** Output for Stop hooks */
+export interface StopOutput {
+    decision?: 'block';
+    reason?: string;
+}
+/** A guard's response — what guidance to inject */
+export interface GuardResult {
+    /** Text injected into the agent's context */
+    context?: string;
+    /** For PreToolUse: permission decision */
+    decision?: 'allow' | 'deny' | 'ask';
+    /** For Stop/PostToolUse: block reason */
+    blockReason?: string;
+}
+/** Known guard names */
+export type GuardName = 'explore' | 'hazard' | 'commit-nudge' | 'scope-drift' | 'compaction' | 'stop-check' | 'subagent-gate' | 'push-nudge' | 'workflow-gate' | 'review-tier' | 'version-check' | 'stale-flows' | 'next-action';
+/** Guard registration entry */
+export interface GuardDefinition {
+    name: GuardName;
+    description: string;
+    /** Which hook event this guard fires on */
+    hookEvent: 'PreToolUse' | 'PostToolUse' | 'Stop' | 'PreCompact';
+    /** Regex matcher for tool name (PreToolUse/PostToolUse only) */
+    matcher?: string;
+    /** Which --level installs this guard */
+    level: 'scoring' | 'full';
+}
+/** Guidance configuration fields for .slope/config.json */
+export interface GuidanceConfig {
+    /** Disabled guard names */
+    disabled?: string[];
+    /** File paths to check for codebase index (explore guard) */
+    indexPaths?: string[];
+    /** Number of sprints to look back for hazards (default 5) */
+    hazardRecency?: number;
+    /** Minutes before commit nudge fires (default 15) */
+    commitInterval?: number;
+    /** Minutes before push nudge fires (default 30) */
+    pushInterval?: number;
+    /** Enable scope drift detection (default true) */
+    scopeDrift?: boolean;
+    /** Max turns for Explore subagents (default 10) */
+    subagentExploreTurns?: number;
+    /** Max turns for Plan subagents (default 15) */
+    subagentPlanTurns?: number;
+    /** Models allowed for Explore/Plan subagents (default ['haiku']) */
+    subagentAllowModels?: string[];
+    /** Unpushed commit count before push nudge fires (default 5) */
+    pushCommitThreshold?: number;
+    /** Directory for compaction handoff files (default '.slope/handoffs') */
+    handoffsDir?: string;
+}
+/** All guard definitions */
+export declare const GUARD_DEFINITIONS: GuardDefinition[];
+/** A custom guard defined by a plugin (not constrained to GuardName union) */
+export interface CustomGuardDefinition {
+    name: string;
+    description: string;
+    hookEvent: 'PreToolUse' | 'PostToolUse' | 'Stop' | 'PreCompact';
+    matcher?: string;
+    level: 'scoring' | 'full';
+    command: string;
+}
+/** Union type for functions that accept both built-in and custom guards */
+export type AnyGuardDefinition = GuardDefinition | CustomGuardDefinition;
+/** Register a custom guard plugin. Idempotent — skips if name already registered. */
+export declare function registerCustomGuard(guard: CustomGuardDefinition): void;
+/** Returns all guard definitions: built-in + custom */
+export declare function getAllGuardDefinitions(): AnyGuardDefinition[];
+/** Look up a custom guard by name */
+export declare function getCustomGuard(name: string): CustomGuardDefinition | undefined;
+/** Clear all custom guards (for testing) */
+export declare function clearCustomGuards(): void;
+/** Format a GuardResult as PreToolUse JSON output */
+export declare function formatPreToolUseOutput(result: GuardResult): PreToolUseOutput;
+/** Format a GuardResult as PostToolUse JSON output */
+export declare function formatPostToolUseOutput(result: GuardResult): PostToolUseOutput;
+/** Format a GuardResult as Stop JSON output */
+export declare function formatStopOutput(result: GuardResult): StopOutput;
+/**
+ * Generate Claude Code settings.json hooks configuration for installed guards.
+ * Returns the `hooks` object to merge into .claude/settings.json.
+ */
+export declare function generateClaudeCodeHooksConfig(guards: AnyGuardDefinition[], guardScriptPath: string): Record<string, Array<{
+    matcher?: string;
+    hooks: Array<{
+        type: string;
+        command: string;
+        timeout?: number;
+        statusMessage?: string;
+    }>;
+}>>;
+//# sourceMappingURL=guard.d.ts.map

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

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

package/dist/core/guard.js

@@ -0,0 +1,185 @@
+// SLOPE Guard Framework
+// Types and utilities for agent guidance hooks.
+/** All guard definitions */
+export const GUARD_DEFINITIONS = [
+    {
+        name: 'explore',
+        description: 'Suggest checking codebase index before deep exploration',
+        hookEvent: 'PreToolUse',
+        matcher: 'Read|Glob|Grep',
+        level: 'full',
+    },
+    {
+        name: 'hazard',
+        description: 'Warn about known issues in file areas being edited',
+        hookEvent: 'PreToolUse',
+        matcher: 'Edit|Write',
+        level: 'full',
+    },
+    {
+        name: 'commit-nudge',
+        description: 'Nudge to commit/push after prolonged editing',
+        hookEvent: 'PostToolUse',
+        matcher: 'Edit|Write',
+        level: 'full',
+    },
+    {
+        name: 'scope-drift',
+        description: 'Warn when editing files outside claimed ticket scope',
+        hookEvent: 'PreToolUse',
+        matcher: 'Edit|Write',
+        level: 'full',
+    },
+    {
+        name: 'compaction',
+        description: 'Extract events before context compaction',
+        hookEvent: 'PreCompact',
+        level: 'full',
+    },
+    {
+        name: 'stop-check',
+        description: 'Check for uncommitted/unpushed work before session end',
+        hookEvent: 'Stop',
+        level: 'full',
+    },
+    {
+        name: 'subagent-gate',
+        description: 'Force haiku model and cap max_turns on Explore/Plan subagents',
+        hookEvent: 'PreToolUse',
+        matcher: 'Task',
+        level: 'full',
+    },
+    {
+        name: 'push-nudge',
+        description: 'Nudge to push after git commits when unpushed count or time is high',
+        hookEvent: 'PostToolUse',
+        matcher: 'Bash',
+        level: 'full',
+    },
+    {
+        name: 'workflow-gate',
+        description: 'Block ExitPlanMode until review rounds are complete',
+        hookEvent: 'PreToolUse',
+        matcher: 'ExitPlanMode',
+        level: 'full',
+    },
+    {
+        name: 'review-tier',
+        description: 'Recommend review tier based on plan scope',
+        hookEvent: 'PreToolUse',
+        matcher: 'ExitPlanMode',
+        level: 'full',
+    },
+    {
+        name: 'version-check',
+        description: 'Block push to main when package versions have not been bumped',
+        hookEvent: 'PreToolUse',
+        matcher: 'Bash',
+        level: 'full',
+    },
+    {
+        name: 'stale-flows',
+        description: 'Warn when editing files belonging to a stale flow definition',
+        hookEvent: 'PreToolUse',
+        matcher: 'Edit|Write',
+        level: 'full',
+    },
+    {
+        name: 'next-action',
+        description: 'Suggest next actions before session end',
+        hookEvent: 'Stop',
+        level: 'full',
+    },
+];
+const customGuards = [];
+/** Register a custom guard plugin. Idempotent — skips if name already registered. */
+export function registerCustomGuard(guard) {
+    if (customGuards.some(g => g.name === guard.name))
+        return;
+    customGuards.push(guard);
+}
+/** Returns all guard definitions: built-in + custom */
+export function getAllGuardDefinitions() {
+    return [...GUARD_DEFINITIONS, ...customGuards];
+}
+/** Look up a custom guard by name */
+export function getCustomGuard(name) {
+    return customGuards.find(g => g.name === name);
+}
+/** Clear all custom guards (for testing) */
+export function clearCustomGuards() {
+    customGuards.length = 0;
+}
+// --- Formatters ---
+/** Format a GuardResult as PreToolUse JSON output */
+export function formatPreToolUseOutput(result) {
+    return {
+        hookSpecificOutput: {
+            hookEventName: 'PreToolUse',
+            ...(result.decision && { permissionDecision: result.decision }),
+            ...(result.blockReason && { permissionDecisionReason: result.blockReason }),
+            ...(result.context && { additionalContext: result.context }),
+        },
+    };
+}
+/** Format a GuardResult as PostToolUse JSON output */
+export function formatPostToolUseOutput(result) {
+    if (result.blockReason) {
+        return {
+            decision: 'block',
+            reason: result.blockReason,
+            hookSpecificOutput: {
+                hookEventName: 'PostToolUse',
+                ...(result.context && { additionalContext: result.context }),
+            },
+        };
+    }
+    if (result.context) {
+        return {
+            hookSpecificOutput: {
+                hookEventName: 'PostToolUse',
+                additionalContext: result.context,
+            },
+        };
+    }
+    return {};
+}
+/** Format a GuardResult as Stop JSON output */
+export function formatStopOutput(result) {
+    if (result.blockReason) {
+        return { decision: 'block', reason: result.blockReason };
+    }
+    return {};
+}
+/**
+ * Generate Claude Code settings.json hooks configuration for installed guards.
+ * Returns the `hooks` object to merge into .claude/settings.json.
+ */
+export function generateClaudeCodeHooksConfig(guards, guardScriptPath) {
+    const config = {};
+    // Group guards by hookEvent + matcher
+    const groups = new Map();
+    for (const g of guards) {
+        const key = `${g.hookEvent}::${g.matcher ?? ''}`;
+        const list = groups.get(key) || [];
+        list.push(g);
+        groups.set(key, list);
+    }
+    for (const [key, defs] of groups) {
+        const [hookEvent, matcher] = key.split('::');
+        if (!config[hookEvent])
+            config[hookEvent] = [];
+        const hooks = defs.map(d => ({
+            type: 'command',
+            command: `${guardScriptPath} ${d.name}`,
+            timeout: 10,
+            statusMessage: `SLOPE: ${d.description}`,
+        }));
+        const entry = { hooks };
+        if (matcher)
+            entry.matcher = matcher;
+        config[hookEvent].push(entry);
+    }
+    return config;
+}
+//# sourceMappingURL=guard.js.map

package/dist/core/guard.js.map

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