@slope-dev/slope 1.59.2 → 1.60.0

package/dist/cli/commands/review-run.js

@@ -9,6 +9,7 @@
  */
 import { execSync } from 'node:child_process';
 import { loadConfig, detectLatestSprint } from '../../core/index.js';
+import { buildReviewerAgentSpecs } from '../reviewer-agents.js';
 function getPrDiff(prNumber) {
     try {
         const prArg = prNumber ? String(prNumber) : '';
@@ -22,11 +23,21 @@ function getPrDiff(prNumber) {
         return null;
     }
 }
-function buildArchitectPrompt(diff, files, sprint) {
+function reviewerAgentIntro(spec) {
+    if (!spec)
+        return [];
+    return [
+        '## Purpose-built Reviewer Agent',
+        spec.prompt,
+        '',
+    ];
+}
+function buildArchitectPrompt(diff, files, sprint, reviewer) {
     return [
         'You are performing an ARCHITECT REVIEW of a pull request.',
         'You have a clean context — no prior implementation knowledge.',
         '',
+        ...reviewerAgentIntro(reviewer),
         '## Review Criteria',
         '1. Does the design match codebase patterns? Check for duplication of existing infrastructure.',
         '2. Are dependencies correct and ordering optimal?',
@@ -50,11 +61,12 @@ function buildArchitectPrompt(diff, files, sprint) {
         'If no issues found, say "No architect findings."',
     ].join('\n');
 }
-function buildCodePrompt(diff, files, sprint) {
+function buildCodePrompt(diff, files, sprint, reviewer) {
     return [
         'You are performing a CODE REVIEW of a pull request.',
         'You have a clean context — no prior implementation knowledge.',
         '',
+        ...reviewerAgentIntro(reviewer),
         '## Review Criteria',
         '1. Correctness: Does the code do what it claims? Edge cases?',
         '2. Error handling: Are errors caught and handled appropriately?',
@@ -109,18 +121,33 @@ export async function reviewRunCommand(args) {
     }
     const diffLines = pr.diff.split('\n').length;
     const prompts = [];
+    const recommendations = [];
+    if (reviewType === 'architect' || reviewType === 'both') {
+        recommendations.push({ review_type: 'architect', priority: 'required', reason: 'PR architect review requested' });
+    }
+    if (reviewType === 'code' || reviewType === 'both') {
+        recommendations.push({ review_type: 'code', priority: 'optional', reason: 'PR code review requested' });
+    }
+    const reviewerAgents = buildReviewerAgentSpecs(recommendations, {
+        sprintNumber: sprint,
+        filePatterns: pr.files,
+        artifacts: pr.files,
+    });
+    const reviewerByLane = new Map(reviewerAgents.map(spec => [spec.lane, spec]));
     if (reviewType === 'architect' || reviewType === 'both') {
+        const reviewer = reviewerByLane.get('architect');
         prompts.push({
             type: 'architect',
-            prompt: buildArchitectPrompt(pr.diff, pr.files, sprint),
-            context: { pr_number: pr.prNum, sprint, changed_files: pr.files, diff_lines: diffLines },
+            prompt: buildArchitectPrompt(pr.diff, pr.files, sprint, reviewer),
+            context: { pr_number: pr.prNum, sprint, changed_files: pr.files, diff_lines: diffLines, reviewer_agent: reviewer },
         });
     }
     if (reviewType === 'code' || reviewType === 'both') {
+        const reviewer = reviewerByLane.get('code');
         prompts.push({
             type: 'code',
-            prompt: buildCodePrompt(pr.diff, pr.files, sprint),
-            context: { pr_number: pr.prNum, sprint, changed_files: pr.files, diff_lines: diffLines },
+            prompt: buildCodePrompt(pr.diff, pr.files, sprint, reviewer),
+            context: { pr_number: pr.prNum, sprint, changed_files: pr.files, diff_lines: diffLines, reviewer_agent: reviewer },
         });
     }
     if (json) {
@@ -132,11 +159,14 @@ export async function reviewRunCommand(args) {
     console.log(`Sprint: ${sprint ?? '?'} | Files: ${pr.files.length} | Diff: ${diffLines} lines\n`);
     for (const p of prompts) {
         console.log(`--- ${p.type.toUpperCase()} REVIEW PROMPT ---`);
-        console.log('Use this with Claude Code\'s Agent tool (model: "haiku") for an isolated review:\n');
+        if (p.context.reviewer_agent) {
+            console.log(`Suggested reviewer agent: ${p.context.reviewer_agent.name} (${p.context.reviewer_agent.id})`);
+        }
+        console.log('Use this with Codex or Claude Code Agent tool for an isolated review:\n');
         console.log(p.prompt);
         console.log('');
     }
-    console.log('To run both reviews as subagents, use:');
+    console.log('To run both reviews as purpose-built subagents, use:');
     console.log('  slope review run --json | # pass to Agent tool prompts');
     console.log('');
 }

package/dist/cli/commands/review-run.js.map

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

package/dist/cli/commands/review-state.d.ts

@@ -1,4 +1,5 @@
-import type { ReviewFinding } from '../../core/types.js';
+export { loadFindings } from '../../core/findings.js';
+export type { FindingsFile } from '../../core/findings.js';
 export interface ReviewState {
     rounds_required: number;
     rounds_completed: number;
@@ -8,10 +9,6 @@ export interface ReviewState {
 }
 export declare function loadReviewState(cwd: string): ReviewState | null;
 export declare function saveReviewState(cwd: string, state: ReviewState): void;
-export interface FindingsFile {
-    sprints: Record<number, ReviewFinding[]>;
-}
-export declare function loadFindings(cwd: string): FindingsFile | null;
 export declare const REVIEW_STATE_SUBCOMMANDS: string[];
 export declare function shouldRouteToReviewState(args: string[]): boolean;
 export declare function reviewStateCommand(args: string[]): Promise<void>;

package/dist/cli/commands/review-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review-state.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/review-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAA8B,MAAM,qBAAqB,CAAC;AAYrF,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAWD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAQ/D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAIrE;AAsHD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;CAC1C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAc7D;AA0ZD,eAAO,MAAM,wBAAwB,UAYpC,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAIhE;AA0GD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDtE"}
+{"version":3,"file":"review-state.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/review-state.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAO3D,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAWD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAQ/D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAIrE;AA+pBD,eAAO,MAAM,wBAAwB,UAYpC,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAIhE;AA2GD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDtE"}

package/dist/cli/commands/review-state.js

@@ -4,9 +4,12 @@ import { recommendReviews, amendScorecardWithFindings } from '../../core/review.
 import { loadConfig, detectLatestSprint, normalizeScorecard, parseSprintNumber } from '../../core/index.js';
 import { createDeferred, listDeferred, resolveDeferred } from '../../core/deferred.js';
 import { HAZARD_SEVERITY_PENALTIES } from '../../core/constants.js';
+import { FINDINGS_FILE, createFindingId, displayFindingId, formatCodificationMetadata, isCodificationCandidate, loadFindings, matchesFindingId, saveFindings, } from '../../core/findings.js';
+export { loadFindings } from '../../core/findings.js';
 import { findPlanContent, countTickets, countPackageRefs } from '../guards/plan-analysis.js';
 import { inferSprintContext, loadRoadmapForInference } from '../sprint-inference.js';
 import { isActiveSprintState, loadSprintState } from '../sprint-state.js';
+import { buildReviewerAgentSpecs, formatReviewerAgentGuidance } from '../reviewer-agents.js';
 const REVIEW_STATE_FILE = '.slope/review-state.json';
 const TIER_ROUNDS = {
     skip: 0,
@@ -136,31 +139,6 @@ function resetCommand(cwd) {
     }
     console.log('Review state cleared.');
 }
-// --- Findings File Management ---
-const FINDINGS_FILE = '.slope/review-findings.json';
-export function loadFindings(cwd) {
-    const filePath = join(cwd, FINDINGS_FILE);
-    if (!existsSync(filePath))
-        return null;
-    try {
-        const raw = JSON.parse(readFileSync(filePath, 'utf8'));
-        // Migrate legacy single-sprint format
-        if (raw.sprints)
-            return { sprints: raw.sprints };
-        if (raw.sprint_number != null && raw.findings) {
-            return { sprints: { [raw.sprint_number]: raw.findings } };
-        }
-        return null;
-    }
-    catch {
-        return null;
-    }
-}
-function saveFindings(cwd, data) {
-    const dir = join(cwd, '.slope');
-    mkdirSync(dir, { recursive: true });
-    writeFileSync(join(cwd, FINDINGS_FILE), JSON.stringify(data, null, 2) + '\n');
-}
 function parseSprintArg(args) {
     const sprintArg = args.find(a => a.startsWith('--sprint='));
     if (!sprintArg)
@@ -187,10 +165,17 @@ function collectStringValues(value, out = []) {
     }
     return out;
 }
+function extractHazardLines(values) {
+    return values
+        .map(value => value.replace(/\s+/g, ' ').trim())
+        .filter(value => /\b(hazard|risk|gotcha|warning|failure|safety|security|boundary|review gate)\b/i.test(value))
+        .slice(0, 8);
+}
 function recommendationFromPlan(content) {
     const filePatterns = [];
     const slopeMatch = content.match(/\*\*Slope:\*\*\s*(\d+)/);
     const sprintMatch = content.match(/Sprint\s+(\d+(?:\.\d+)?)/);
+    const titleMatch = content.match(/^#\s+(.+)$/m);
     const fileMatches = content.matchAll(/`([^`]+\.[a-z]+)`/g);
     for (const m of fileMatches)
         filePatterns.push(m[1]);
@@ -199,6 +184,9 @@ function recommendationFromPlan(content) {
         slope: slopeMatch ? parseInt(slopeMatch[1], 10) : 0,
         sprintNumber: sprintMatch ? parseSprintNumber(sprintMatch[1]) ?? 0 : 0,
         filePatterns,
+        theme: titleMatch?.[1],
+        artifacts: filePatterns,
+        hazards: extractHazardLines(content.split('\n')),
         hasNewInfra: /\b(new module|new package|new service|new infrastructure)\b/i.test(content),
     };
 }
@@ -210,16 +198,23 @@ function recommendationFromRoadmapSprint(sprint) {
         slope: sprint.slope ?? 0,
         sprintNumber: sprint.id,
         filePatterns,
+        theme: sprint.theme,
+        artifacts: filePatterns.length > 0 ? filePatterns : sprint.tickets?.map(ticket => `${ticket.key}: ${ticket.title}`),
+        hazards: extractHazardLines(stringValues),
         hasNewInfra: /\b(new module|new package|new service|new infrastructure)\b/i.test(stringValues.join('\n')),
     };
 }
 function recommendationFromScorecard(card) {
     const stringValues = collectStringValues(card);
+    const filePatterns = stringValues.filter(value => /[/.]/.test(value));
     return {
         ticketCount: card.shots?.length ?? 0,
         slope: card.slope ?? 0,
         sprintNumber: card.sprint_number,
-        filePatterns: stringValues.filter(value => /[/.]/.test(value)),
+        filePatterns,
+        theme: card.theme,
+        artifacts: filePatterns,
+        hazards: extractHazardLines(stringValues),
         hasNewInfra: /\b(new module|new package|new service|new infrastructure)\b/i.test(stringValues.join('\n')),
     };
 }
@@ -247,6 +242,8 @@ function inferRecommendationContext(args, cwd) {
             slope: 0,
             filePatterns: [],
             sprintNumber: explicitSprint,
+            artifacts: [],
+            hazards: [],
             hasNewInfra: false,
         };
     }
@@ -269,6 +266,8 @@ function inferRecommendationContext(args, cwd) {
             slope: 0,
             filePatterns: [],
             sprintNumber: inferred.sprint,
+            artifacts: [],
+            hazards: [],
             hasNewInfra: false,
         };
     }
@@ -280,6 +279,8 @@ function inferRecommendationContext(args, cwd) {
         slope: 0,
         filePatterns: [],
         sprintNumber: 0,
+        artifacts: [],
+        hazards: [],
         hasNewInfra: false,
     };
 }
@@ -294,10 +295,22 @@ function recommendCommand(args, cwd) {
         const priority = rec.priority.padEnd(13);
         console.log(`  ${type} ${priority} ${rec.reason}`);
     }
+    const reviewerAgents = buildReviewerAgentSpecs(recs, {
+        sprintNumber: context.sprintNumber > 0 ? context.sprintNumber : undefined,
+        theme: context.theme,
+        filePatterns: context.filePatterns,
+        artifacts: context.artifacts,
+        hazards: context.hazards,
+    });
+    const guidance = formatReviewerAgentGuidance(reviewerAgents);
+    if (guidance)
+        console.log(`\n${guidance}`);
 }
 // --- Findings Subcommands ---
-const VALID_REVIEW_TYPES = ['architect', 'code', 'ml-engineer', 'security', 'ux'];
+const VALID_REVIEW_TYPES = ['architect', 'code', 'ml-engineer', 'security', 'ux', 'workaround'];
 const VALID_SEVERITIES = ['minor', 'moderate', 'major', 'critical'];
+const VALID_CODIFICATION_COSTS = ['s', 'm', 'l'];
+const VALID_CODIFICATION_STATUSES = ['open', 'paid_down', 'wontfix'];
 function findingsAddCommand(args, cwd) {
     const typeArg = args.find(a => a.startsWith('--type='));
     const ticketArg = args.find(a => a.startsWith('--ticket='));
@@ -305,9 +318,12 @@ function findingsAddCommand(args, cwd) {
     const descArg = args.find(a => a.startsWith('--description='));
     const sprintArg = args.find(a => a.startsWith('--sprint='));
     const resolvedArg = args.includes('--resolved');
-    if (!typeArg || !ticketArg || !descArg) {
-        console.error('Error: --type, --ticket, and --description are required.');
+    const recursArg = args.includes('--recurs');
+    const costArg = args.find(a => a.startsWith('--cost='));
+    if (!typeArg || !descArg) {
+        console.error('Error: --type and --description are required; --ticket is required except for --type=workaround.');
         console.error('Usage: slope review findings add --type=architect --ticket=S34-1 --severity=moderate --description="..."');
+        console.error('Usage: slope review findings add --type=workaround --recurs --cost=s --description="..."');
         process.exit(1);
     }
     const reviewType = typeArg.slice('--type='.length);
@@ -315,6 +331,27 @@ function findingsAddCommand(args, cwd) {
         console.error(`Error: Invalid review type "${reviewType}". Use: ${VALID_REVIEW_TYPES.join(', ')}`);
         process.exit(1);
     }
+    if (!ticketArg && reviewType !== 'workaround') {
+        console.error('Error: --ticket is required unless --type=workaround.');
+        process.exit(1);
+    }
+    const cost = costArg ? costArg.slice('--cost='.length) : undefined;
+    if (cost && !VALID_CODIFICATION_COSTS.includes(cost)) {
+        console.error(`Error: Invalid codification cost "${cost}". Use: ${VALID_CODIFICATION_COSTS.join(', ')}`);
+        process.exit(1);
+    }
+    if (reviewType === 'workaround' && !recursArg) {
+        console.error('Error: workaround findings must include --recurs so one-off workarounds are not logged as codification debt.');
+        process.exit(1);
+    }
+    if (recursArg && !cost) {
+        console.error('Error: recurring workaround findings require --cost=s|m|l.');
+        process.exit(1);
+    }
+    if (cost && !recursArg) {
+        console.error('Error: --cost requires --recurs.');
+        process.exit(1);
+    }
     const severity = severityArg
         ? severityArg.slice('--severity='.length)
         : 'moderate';
@@ -322,7 +359,7 @@ function findingsAddCommand(args, cwd) {
         console.error(`Error: Invalid severity "${severity}". Use: ${VALID_SEVERITIES.join(', ')}`);
         process.exit(1);
     }
-    const ticketKey = ticketArg.slice('--ticket='.length);
+    const ticketKey = ticketArg ? ticketArg.slice('--ticket='.length) : 'workaround';
     const description = descArg.slice('--description='.length);
     // Determine sprint number
     let sprintNumber = 0;
@@ -337,11 +374,15 @@ function findingsAddCommand(args, cwd) {
         catch { /* fallback to 0 */ }
     }
     const finding = {
+        id: createFindingId(),
         review_type: reviewType,
         ticket_key: ticketKey,
         severity,
         description,
         resolved: resolvedArg,
+        recurs: recursArg || undefined,
+        cost,
+        codification_status: recursArg ? 'open' : undefined,
     };
     const existing = loadFindings(cwd);
     if (existing && existing.sprints[sprintNumber]) {
@@ -357,9 +398,21 @@ function findingsAddCommand(args, cwd) {
         saveFindings(cwd, { sprints: { [sprintNumber]: [finding] } });
     }
     console.log(`Finding added: [${reviewType}] ${ticketKey} — ${description} (${severity})`);
+    console.log(`  ID: ${finding.id}`);
+    const codification = formatCodificationMetadata(finding);
+    if (codification)
+        console.log(`  ${codification}`);
 }
 function findingsListCommand(args, cwd) {
     const sprintArg = args.find(a => a.startsWith('--sprint='));
+    const codificationStatusArg = args.find(a => a.startsWith('--codification-status='));
+    const codificationStatus = codificationStatusArg
+        ? codificationStatusArg.slice('--codification-status='.length)
+        : undefined;
+    if (codificationStatus && !VALID_CODIFICATION_STATUSES.includes(codificationStatus)) {
+        console.error(`Error: Invalid codification status "${codificationStatus}". Use: ${VALID_CODIFICATION_STATUSES.join(', ')}`);
+        process.exit(1);
+    }
     const data = loadFindings(cwd);
     if (!data || Object.keys(data.sprints).length === 0) {
         console.log('No review findings recorded.');
@@ -367,36 +420,101 @@ function findingsListCommand(args, cwd) {
     }
     if (sprintArg) {
         const requestedSprint = parseSprintNumber(sprintArg.slice('--sprint='.length)) ?? 0;
-        const sprintFindings = data.sprints[requestedSprint];
+        const sprintFindings = filterFindingsForList(data.sprints[requestedSprint] ?? [], codificationStatus);
         if (!sprintFindings || sprintFindings.length === 0) {
             console.log(`No findings for Sprint ${requestedSprint}.`);
             return;
         }
         console.log(`Sprint ${requestedSprint} findings (${sprintFindings.length} total):\n`);
-        console.log('  Ticket  Type           Severity   Description');
-        for (const f of sprintFindings) {
+        console.log('  ID       Ticket  Type           Severity   Description');
+        for (const [index, f] of sprintFindings.entries()) {
+            const id = displayFindingId(f, requestedSprint, index).padEnd(8);
             const ticket = f.ticket_key.padEnd(7);
             const type = f.review_type.padEnd(14);
             const severity = f.severity.padEnd(10);
-            console.log(`  ${ticket} ${type} ${severity} ${f.description}`);
+            const meta = formatCodificationMetadata(f);
+            console.log(`  ${id} ${ticket} ${type} ${severity} ${f.description}${meta ? ` (${meta})` : ''}`);
         }
     }
     else {
         // Show all findings grouped by sprint
         const sprintKeys = Object.keys(data.sprints).map(Number).sort((a, b) => a - b);
+        let printed = false;
         for (const sprint of sprintKeys) {
-            const sprintFindings = data.sprints[sprint];
+            const sprintFindings = filterFindingsForList(data.sprints[sprint] ?? [], codificationStatus);
+            if (sprintFindings.length === 0)
+                continue;
+            printed = true;
             console.log(`Sprint ${sprint} findings (${sprintFindings.length}):\n`);
-            console.log('  Ticket  Type           Severity   Description');
-            for (const f of sprintFindings) {
+            console.log('  ID       Ticket  Type           Severity   Description');
+            for (const [index, f] of sprintFindings.entries()) {
+                const id = displayFindingId(f, sprint, index).padEnd(8);
                 const ticket = f.ticket_key.padEnd(7);
                 const type = f.review_type.padEnd(14);
                 const severity = f.severity.padEnd(10);
-                console.log(`  ${ticket} ${type} ${severity} ${f.description}`);
+                const meta = formatCodificationMetadata(f);
+                console.log(`  ${id} ${ticket} ${type} ${severity} ${f.description}${meta ? ` (${meta})` : ''}`);
             }
             console.log('');
         }
+        if (!printed) {
+            console.log(codificationStatus
+                ? `No findings match codification status "${codificationStatus}".`
+                : 'No review findings recorded.');
+        }
+    }
+}
+function filterFindingsForList(findings, codificationStatus) {
+    if (!codificationStatus)
+        return findings;
+    return findings.filter(finding => {
+        if (!isCodificationCandidate(finding))
+            return false;
+        return (finding.codification_status ?? 'open') === codificationStatus;
+    });
+}
+function findingsResolveCommand(args, cwd) {
+    const id = args.find(a => !a.startsWith('--')) ?? args.find(a => a.startsWith('--id='))?.slice('--id='.length);
+    const statusArg = args.find(a => a.startsWith('--status='));
+    const status = statusArg ? statusArg.slice('--status='.length) : 'paid_down';
+    if (!id) {
+        console.error('Error: finding id is required. Usage: slope review findings resolve <id> [--status=paid_down|wontfix]');
+        process.exit(1);
+    }
+    if (!['paid_down', 'wontfix'].includes(status)) {
+        console.error('Error: --status must be paid_down or wontfix.');
+        process.exit(1);
+    }
+    const data = loadFindings(cwd);
+    if (!data) {
+        console.error('Error: no review findings recorded.');
+        process.exit(1);
+    }
+    const now = new Date().toISOString();
+    for (const sprint of Object.keys(data.sprints).map(Number).sort((a, b) => a - b)) {
+        const findings = data.sprints[sprint] ?? [];
+        for (const [index, finding] of findings.entries()) {
+            if (!matchesFindingId(finding, sprint, index, id))
+                continue;
+            if (!isCodificationCandidate(finding)) {
+                console.error(`Error: finding ${id} is not a recurring workaround codification candidate.`);
+                process.exit(1);
+            }
+            finding.resolved = true;
+            finding.codification_status = status;
+            finding.resolved_at = now;
+            if (status === 'paid_down')
+                finding.codified_at = now;
+            else
+                delete finding.codified_at;
+            saveFindings(cwd, data);
+            console.log(`Codification candidate ${status}: ${displayFindingId(finding, sprint, index)}`);
+            console.log(`  S${sprint}: ${finding.description}`);
+            return;
+        }
     }
+    console.error(`Error: no finding found matching id "${id}".`);
+    process.exit(1);
 }
 function findingsClearCommand(args, cwd) {
     const filePath = join(cwd, FINDINGS_FILE);
@@ -414,8 +532,9 @@ function findingsCommand(args, cwd) {
         console.log(`Usage: slope review findings <subcommand> [options]
 
 Subcommands:
-  add    Add a review finding
+  add    Add a review finding; workaround candidates use --recurs --cost=s|m|l
   list   List recorded findings
+  resolve Mark a codification candidate paid_down or wontfix
   clear  Clear all findings
 
 Use 'slope review findings add --help' for add options.`);
@@ -429,11 +548,14 @@ Use 'slope review findings add --help' for add options.`);
         case 'list':
             findingsListCommand(args.slice(1), cwd);
             break;
+        case 'resolve':
+            findingsResolveCommand(args.slice(1), cwd);
+            break;
         case 'clear':
             findingsClearCommand(args.slice(1), cwd);
             break;
         default:
-            console.error(`Unknown findings subcommand: ${sub}. Use add, list, or clear.`);
+            console.error(`Unknown findings subcommand: ${sub}. Use add, list, resolve, or clear.`);
             process.exit(1);
     }
 }
@@ -587,11 +709,12 @@ ux) apply to the current sprint based on active sprint state, roadmap,
 scorecard, or plan metadata.`);
             break;
         case 'findings':
-            console.log(`Usage: slope review findings <add|list|clear> [options]
+            console.log(`Usage: slope review findings <add|list|resolve|clear> [options]
 
 Subcommands:
-  add    Record a review finding (--type, --ticket, --severity, --description)
-  list   List recorded findings (optionally --sprint=N)
+  add    Record a review finding (--type, --ticket, --severity, --description; workaround uses --recurs --cost=s|m|l)
+  list   List recorded findings (optionally --sprint=N or --codification-status=open|paid_down|wontfix)
+  resolve Mark a recurring workaround candidate paid_down or wontfix by id
   clear  Clear all findings`);
             break;
         case 'amend':