@farmslot/protocol 0.7.6 → 0.9.0

package/dist/contracts/bug-input.js

@@ -0,0 +1,288 @@
+// bug-input.ts — Pure parsing/validation for bug-input.json (ported from
+// triage-bug.sh, score-bug.sh, download-github-images.sh, and
+// download-jira-images.sh). No IO — callers own network and file operations.
+export const BUG_SCORE_DIFFICULTIES = ['low', 'medium', 'high', 'extreme'];
+/**
+ * Extract image URLs from a GitHub issue body (markdown / HTML / bare
+ * GitHub user-content links). Shared helper for both GitHub markdown bodies
+ * and Jira ADF descriptions that happen to contain inline HTML.
+ *
+ * Returns full URLs filtered to image-like extensions or GitHub content hosts.
+ * Results are deduplicated and sorted for stable output.
+ */
+export function extractImageUrls(body) {
+    const urls = new Set();
+    // ![alt](url) markdown images
+    for (const m of body.matchAll(/!\[[^\]]*\]\(([^)]+)\)/g)) {
+        urls.add(m[1]);
+    }
+    // <img src="url"> or <img src='url'>
+    for (const m of body.matchAll(/<img[^>]+src=["']([^"'>]+)["']/g)) {
+        urls.add(m[1]);
+    }
+    // Bare GitHub user-content URLs (user-images.githubusercontent.com and
+    // github.com/user-attachments/assets paths used for drag-and-drop uploads)
+    for (const m of body.matchAll(/(https:\/\/(?:user-images\.githubusercontent\.com|github\.com\/user-attachments\/assets)\/[^\s)"'>]+)/g)) {
+        urls.add(m[1]);
+    }
+    const IMAGE_EXTENSIONS = ['.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg'];
+    return [...urls].sort().filter((url) => {
+        const lower = url.toLowerCase();
+        const isImage = IMAGE_EXTENSIONS.some((ext) => lower.endsWith(ext));
+        const isGhContent = lower.includes('githubusercontent.com') || lower.includes('github.com/user-attachments');
+        return isImage || isGhContent;
+    });
+}
+/**
+ * Recursively flatten an Atlassian Document Format (ADF) node to plain text.
+ * ADF is the JSON rich-text format used by Jira REST API v3 description fields.
+ */
+export function flattenAdf(node) {
+    if (typeof node === 'string')
+        return node;
+    if (Array.isArray(node))
+        return node.map(flattenAdf).join(' ');
+    if (node !== null && typeof node === 'object') {
+        const n = node;
+        if (n['type'] === 'text')
+            return typeof n['text'] === 'string' ? n['text'] : '';
+        if (Array.isArray(n['content']))
+            return n['content'].map(flattenAdf).join(' ');
+    }
+    return '';
+}
+/**
+ * Derive the score-file key from a BugInput.
+ *
+ * GitHub issues become "gh-{number}" (e.g. "gh-12345").
+ * Jira keys are lowercased (e.g. "proj-2236").
+ */
+export function deriveScoreKey(bug) {
+    if (bug.github_issue) {
+        const num = bug.github_issue.includes('#')
+            ? bug.github_issue.split('#').pop()
+            : bug.github_issue;
+        return `gh-${num}`;
+    }
+    if (bug.jira_key) {
+        return bug.jira_key.toLowerCase();
+    }
+    throw new Error('BugInput has neither github_issue nor jira_key — cannot derive score key');
+}
+/**
+ * Parse a raw GitHub issue JSON response (from `gh issue view --json
+ * title,body,labels,state,url`) into a BugInput.
+ *
+ * Extracts: AC sections, reproduction steps, screenshot basenames,
+ * image URLs, and linked PR references from the issue body.
+ * Derives repo+number from the `url` field.
+ */
+export function parseBugInput(source, raw) {
+    if (source === 'github')
+        return parseGitHubIssue(raw);
+    return parseJiraIssue(raw);
+}
+// ── Private helpers ──────────────────────────────────────────────────────────
+function parseGitHubIssue(raw) {
+    const gh = (raw ?? {});
+    const url = typeof gh['url'] === 'string' ? gh['url'] : '';
+    const urlMatch = url.match(/https?:\/\/github\.com\/([^/]+\/[^/]+)\/issues\/(\d+)/);
+    if (!urlMatch) {
+        throw Object.assign(new Error(`Cannot parse GitHub issue URL from raw JSON: "${url}"`), {
+            code: 'PARSE_ERROR',
+            userAction: 'Ensure the raw JSON comes from `gh issue view --json title,body,labels,state,url`.',
+        });
+    }
+    const repo = urlMatch[1];
+    const number = urlMatch[2];
+    const body = typeof gh['body'] === 'string' ? gh['body'] : '';
+    const title = typeof gh['title'] === 'string' ? gh['title'] : '';
+    const state = typeof gh['state'] === 'string' ? gh['state'].toLowerCase() : 'open';
+    const labels = parseLabels(gh['labels']);
+    const ac = parseMarkdownSection(body, /##\s*(?:Acceptance Criteria|Expected Behavior)\s*\n([\s\S]*?)(?=\n##|$)/);
+    const steps = parseMarkdownSection(body, /##\s*(?:Steps to Reproduce|Repro Steps)\s*\n([\s\S]*?)(?=\n##|$)/, true);
+    // Screenshots: basenames (≤50 chars) from markdown images and <img> tags,
+    // matching the shape triage-bug.sh's Python produced.
+    const screenshotUrls = [];
+    for (const m of body.matchAll(/!\[[^\]]*\]\(([^)]+)\)/g)) {
+        screenshotUrls.push(m[1]);
+    }
+    for (const m of body.matchAll(/<img[^>]+src=["']([^"'>]+)["']/g)) {
+        screenshotUrls.push(m[1]);
+    }
+    const screenshots = screenshotUrls.map((u) => {
+        const basename = u.split('/').pop() ?? u;
+        return basename.slice(0, 50);
+    });
+    // Linked PRs: #N or repo#N in body, excluding the current issue number.
+    const escapedRepo = repo.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const linkPattern = new RegExp(`(?:${escapedRepo})?#(\\d+)`, 'g');
+    const linkedPrSet = new Set();
+    for (const m of body.matchAll(linkPattern)) {
+        if (m[1] !== number)
+            linkedPrSet.add(`${repo}#${m[1]}`);
+    }
+    const linked_prs = [...linkedPrSet];
+    const image_urls = extractImageUrls(body);
+    return {
+        source: 'github',
+        github_issue: `${repo}#${number}`,
+        jira_key: '',
+        title,
+        description: body,
+        acceptance_criteria: ac,
+        affected_area: '',
+        steps_to_reproduce: steps,
+        labels,
+        components: [],
+        screenshots,
+        state,
+        linked_prs,
+        image_urls,
+    };
+}
+function parseJiraIssue(raw) {
+    const jira = (raw ?? {});
+    if ('errorMessages' in jira) {
+        const msgs = jira['errorMessages'];
+        throw Object.assign(new Error(`Jira API error: ${JSON.stringify(msgs)}`), {
+            code: 'JIRA_API_ERROR',
+            userAction: 'Check JIRA_EMAIL, JIRA_TOKEN, and the Jira base URL in project.json.',
+        });
+    }
+    const key = typeof jira['key'] === 'string' ? jira['key'] : '';
+    const fields = (jira['fields'] ?? {});
+    const title = typeof fields['summary'] === 'string' ? fields['summary'] : '';
+    // Description: ADF object → flatten to text, or plain string fallback.
+    const descRaw = fields['description'];
+    const body = typeof descRaw === 'object' && descRaw !== null
+        ? flattenAdf(descRaw)
+        : typeof descRaw === 'string'
+            ? descRaw
+            : '';
+    const state = (() => {
+        const s = fields['status'];
+        if (s !== null && typeof s === 'object') {
+            const name = s['name'];
+            return typeof name === 'string' ? name.toLowerCase() : 'open';
+        }
+        return typeof s === 'string' ? s.toLowerCase() : 'open';
+    })();
+    const rawLabels = fields['labels'];
+    const labels = Array.isArray(rawLabels)
+        ? rawLabels.filter((l) => typeof l === 'string')
+        : [];
+    const components = (() => {
+        const raw = fields['components'];
+        if (!Array.isArray(raw))
+            return [];
+        return raw
+            .map((c) => {
+            if (c !== null && typeof c === 'object') {
+                const name = c['name'];
+                return typeof name === 'string' ? name : '';
+            }
+            return typeof c === 'string' ? c : '';
+        })
+            .filter(Boolean);
+    })();
+    const ac = parseJiraSection(body, /(?:Acceptance Criteria|Expected Behavior)[:\s]*\n([\s\S]*?)(?=\n[A-Z]|$)/);
+    const steps = parseJiraSection(body, /(?:Steps to Reproduce|Repro Steps)[:\s]*\n([\s\S]*?)(?=\n[A-Z]|$)/, true);
+    // Jira attachments are downloaded separately via the attachment API;
+    // image_urls from the description text is available for embedded images.
+    const image_urls = extractImageUrls(body);
+    return {
+        source: 'jira',
+        github_issue: '',
+        jira_key: key,
+        title,
+        description: body,
+        acceptance_criteria: ac,
+        affected_area: '',
+        steps_to_reproduce: steps,
+        labels,
+        components,
+        screenshots: [],
+        state,
+        linked_prs: [],
+        image_urls,
+    };
+}
+/**
+ * Parse a markdown `## Section` into trimmed non-empty lines.
+ * When `isSteps` is true, also strips leading ordered-list markers (e.g. "1. ")
+ * matching the Python `re.sub(r'^[\s\d.*-]+', '', line)` used for steps sections.
+ * For other sections (e.g. AC), only list bullets (`*`, `-`) and whitespace are stripped.
+ */
+function parseMarkdownSection(body, pattern, isSteps = false) {
+    const match = body.match(pattern);
+    if (!match?.[1])
+        return [];
+    const stripPattern = isSteps ? /^[\s\d.*-]+/ : /^[\s*-]+/;
+    return match[1]
+        .trim()
+        .split('\n')
+        .map((line) => line.replace(stripPattern, '').trim())
+        .filter(Boolean);
+}
+/** Parse a Jira section header (no `##` prefix) into trimmed non-empty lines. */
+function parseJiraSection(body, pattern, isSteps = false) {
+    const match = body.match(pattern);
+    if (!match?.[1])
+        return [];
+    const stripPattern = isSteps ? /^[\s\d.*-]+/ : /^[\s*-]+/;
+    return match[1]
+        .trim()
+        .split('\n')
+        .map((line) => line.replace(stripPattern, '').trim())
+        .filter(Boolean);
+}
+function parseLabels(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw
+        .map((l) => {
+        if (l !== null && typeof l === 'object') {
+            const name = l['name'];
+            return typeof name === 'string' ? name : '';
+        }
+        return typeof l === 'string' ? l : '';
+    })
+        .filter(Boolean);
+}
+/**
+ * Validate a scorer output object against the score-bug.sh contract.
+ * Throws with a teaching error message on any violation.
+ * On success, the value is narrowed to BugScore.
+ */
+export function validateBugScore(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw Object.assign(new Error('scorer output must be a JSON object'), {
+            code: 'INVALID_SCORE',
+            userAction: 'Ensure the scoring script emits a JSON object to stdout.',
+        });
+    }
+    const d = value;
+    const required = ['difficulty', 'one_shot_probability', 'category'];
+    const missing = required.filter((f) => !(f in d));
+    if (missing.length > 0) {
+        throw Object.assign(new Error(`scorer output is missing required fields: ${JSON.stringify(missing)}`), {
+            code: 'INVALID_SCORE',
+            userAction: `Add the missing fields to your scoring script output: ${missing.join(', ')}.`,
+        });
+    }
+    if (!BUG_SCORE_DIFFICULTIES.includes(d['difficulty'])) {
+        throw Object.assign(new Error(`difficulty must be one of ${JSON.stringify([...BUG_SCORE_DIFFICULTIES])}, got: ${JSON.stringify(d['difficulty'])}`), {
+            code: 'INVALID_SCORE',
+            userAction: `Set difficulty to one of: ${BUG_SCORE_DIFFICULTIES.join(', ')}.`,
+        });
+    }
+    const prob = d['one_shot_probability'];
+    if (typeof prob !== 'number' || isNaN(prob) || prob < 0 || prob > 1) {
+        throw Object.assign(new Error(`one_shot_probability must be a number in [0, 1], got: ${JSON.stringify(prob)}`), {
+            code: 'INVALID_SCORE',
+            userAction: 'Set one_shot_probability to a decimal between 0 and 1 (e.g. 0.4).',
+        });
+    }
+}
+//# sourceMappingURL=bug-input.js.map

package/dist/contracts/bug-input.js.map

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

package/dist/contracts/index.d.ts

@@ -1,6 +1,7 @@
 export * from './agents.js';
 export * from './analytics.js';
 export * from './backlog.js';
+export * from './bug-input.js';
 export * from './chat.js';
 export * from './common.js';
 export * from './config.js';
@@ -8,12 +9,15 @@ export * from './dispatch.js';
 export * from './evals.js';
 export * from './family.js';
 export * from './interactive-operator-packets.js';
+export * from './pr-recommendation.js';
 export * from './recipes.js';
 export * from './resources.js';
 export * from './reviews.js';
 export * from './roadmap.js';
 export * from './run-bundles.js';
+export * from './runner-ids.js';
 export * from './runs.js';
+export * from './slot-selection.js';
 export * from './slots.js';
 export * from './task.js';
 export * from './terminal.js';

package/dist/contracts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mCAAmC,CAAC;AAClD,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mCAAmC,CAAC;AAClD,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC"}

package/dist/contracts/index.js

@@ -1,6 +1,7 @@
 export * from './agents.js';
 export * from './analytics.js';
 export * from './backlog.js';
+export * from './bug-input.js';
 export * from './chat.js';
 export * from './common.js';
 export * from './config.js';
@@ -8,12 +9,15 @@ export * from './dispatch.js';
 export * from './evals.js';
 export * from './family.js';
 export * from './interactive-operator-packets.js';
+export * from './pr-recommendation.js';
 export * from './recipes.js';
 export * from './resources.js';
 export * from './reviews.js';
 export * from './roadmap.js';
 export * from './run-bundles.js';
+export * from './runner-ids.js';
 export * from './runs.js';
+export * from './slot-selection.js';
 export * from './slots.js';
 export * from './task.js';
 export * from './terminal.js';

package/dist/contracts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mCAAmC,CAAC;AAClD,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mCAAmC,CAAC;AAClD,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC"}

package/dist/contracts/pr-recommendation.d.ts

@@ -0,0 +1,66 @@
+import type { PRFamilyMergeState, PRFamilyWorkflowState, PRRecommendation } from './reviews.js';
+/**
+ * Minimal family context consumed by recommendation + merge-state functions.
+ * The gateway's PRFamilyContext is a superset of this; structural typing
+ * means any PRFamilyContext satisfies PRFamilyContextForRecommendation.
+ */
+export interface PRFamilyContextForRecommendation {
+    workflowState: PRFamilyWorkflowState;
+    ownedPrFamily: boolean;
+}
+export interface PRRecommendationParams {
+    prState: 'OPEN' | 'CLOSED' | 'MERGED';
+    workerActive: boolean;
+    anyFailed: boolean;
+    mergeConflict: boolean;
+    actionableCount: number;
+    allPassed: boolean;
+    approved: boolean;
+    familyContext: PRFamilyContextForRecommendation | null;
+}
+export interface PRMergeStateParams {
+    prState: 'OPEN' | 'CLOSED' | 'MERGED';
+    familyContext: PRFamilyContextForRecommendation | null;
+    anyFailed: boolean;
+    mergeConflict: boolean;
+    actionableCount: number;
+    allPassed: boolean;
+    approved: boolean;
+}
+/**
+ * Returns true when the PR is in a "passive merge wait" state: the workflow
+ * is complete, CI has passed, the PR is approved, and there are no blockers.
+ * The operator just needs to click Merge (or enable auto-merge).
+ *
+ * NOTE: prState='OPEN' is intentional — the PR has not merged yet but is
+ * fully ready. Callers filter familyContext to ownedPrFamily=true before
+ * passing it here.
+ */
+export declare function isPassiveMergeWaitCandidate(params: PRMergeStateParams): boolean;
+export declare function derivePRMergeState(params: PRMergeStateParams): PRFamilyMergeState;
+/**
+ * First-match rule engine mapping PR state to a recommendation.
+ *
+ * Rule ordering vs. pr-monitor.sh (bash):
+ *   INTENTIONAL DIFFERENCE — workerActive is evaluated first (before
+ *   MERGED/CLOSED). Bash checks MERGED/CLOSED first, then worker-active
+ *   within sub-cases. The TS ordering surfaces the live worker sooner in
+ *   the UI; MERGED/CLOSED slots with an active worker are handled by
+ *   the pr-monitor.sh formatter using the merged/prState PRStatus fields.
+ *
+ * Rule ordering vs. bash rule engine (first-match order, bash → TS):
+ *   merged                   → MERGED            (bash: MERGED)
+ *   pr_state=CLOSED          → CLOSED_WITHOUT_MERGE (bash: CLOSED)
+ *   merge_conflict           → NEEDS_ATTENTION   (bash: MERGE CONFLICT [worker-active|action-needed])
+ *   any_failed               → NEEDS_ATTENTION   (bash: CI FAILED [worker-active|action-needed])
+ *   has_actionable           → NEEDS_ATTENTION   (bash: COMMENTS [worker-active|action-needed])
+ *   all_passed && !actionable → READY/WAITING   (bash: READY)
+ *   else                     → IN_REVIEW         (bash: PENDING)
+ *
+ * The bash sub-classifications (worker-active vs action-needed within each
+ * NEEDS_ATTENTION case) are visible in PRStatus.workerActive + the individual
+ * boolean fields (mergeConflict, anyFailed, actionableBotComments) so
+ * formatters can still derive the bash-style detail strings.
+ */
+export declare function computePRRecommendation(params: PRRecommendationParams): PRRecommendation;
+//# sourceMappingURL=pr-recommendation.d.ts.map

package/dist/contracts/pr-recommendation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-recommendation.d.ts","sourceRoot":"","sources":["../../src/contracts/pr-recommendation.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhG;;;;GAIG;AACH,MAAM,WAAW,gCAAgC;IAC/C,aAAa,EAAE,qBAAqB,CAAC;IACrC,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,gCAAgC,GAAG,IAAI,CAAC;CACxD;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtC,aAAa,EAAE,gCAAgC,GAAG,IAAI,CAAC;IACvD,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAW/E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAKjF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,sBAAsB,GAAG,gBAAgB,CAqBxF"}

package/dist/contracts/pr-recommendation.js

@@ -0,0 +1,88 @@
+// pr-recommendation.ts — pure decision functions for PR recommendation.
+// Canonical home for computePRRecommendation, isPassiveMergeWaitCandidate,
+// and derivePRMergeState, shared by gateway (methods/pr.ts), CLI internal
+// verbs, and tests without importing services/gateway.
+//
+// Ported from services/gateway/src/methods/pr.ts as part of the Phase 3 CLI
+// overhaul (bash-decision-core-inventory.md item 4: reconcile pr-monitor.sh
+// rules with computePRRecommendation).
+/**
+ * Returns true when the PR is in a "passive merge wait" state: the workflow
+ * is complete, CI has passed, the PR is approved, and there are no blockers.
+ * The operator just needs to click Merge (or enable auto-merge).
+ *
+ * NOTE: prState='OPEN' is intentional — the PR has not merged yet but is
+ * fully ready. Callers filter familyContext to ownedPrFamily=true before
+ * passing it here.
+ */
+export function isPassiveMergeWaitCandidate(params) {
+    return Boolean(params.familyContext &&
+        params.prState === 'OPEN' &&
+        params.familyContext.workflowState === 'complete' &&
+        !params.anyFailed &&
+        !params.mergeConflict &&
+        params.actionableCount === 0 &&
+        params.allPassed &&
+        params.approved);
+}
+export function derivePRMergeState(params) {
+    if (!params.familyContext)
+        return 'not_applicable';
+    if (params.prState === 'MERGED')
+        return 'merged';
+    if (params.prState === 'CLOSED')
+        return 'closed_without_merge';
+    return isPassiveMergeWaitCandidate(params) ? 'waiting_for_merge' : 'not_applicable';
+}
+/**
+ * First-match rule engine mapping PR state to a recommendation.
+ *
+ * Rule ordering vs. pr-monitor.sh (bash):
+ *   INTENTIONAL DIFFERENCE — workerActive is evaluated first (before
+ *   MERGED/CLOSED). Bash checks MERGED/CLOSED first, then worker-active
+ *   within sub-cases. The TS ordering surfaces the live worker sooner in
+ *   the UI; MERGED/CLOSED slots with an active worker are handled by
+ *   the pr-monitor.sh formatter using the merged/prState PRStatus fields.
+ *
+ * Rule ordering vs. bash rule engine (first-match order, bash → TS):
+ *   merged                   → MERGED            (bash: MERGED)
+ *   pr_state=CLOSED          → CLOSED_WITHOUT_MERGE (bash: CLOSED)
+ *   merge_conflict           → NEEDS_ATTENTION   (bash: MERGE CONFLICT [worker-active|action-needed])
+ *   any_failed               → NEEDS_ATTENTION   (bash: CI FAILED [worker-active|action-needed])
+ *   has_actionable           → NEEDS_ATTENTION   (bash: COMMENTS [worker-active|action-needed])
+ *   all_passed && !actionable → READY/WAITING   (bash: READY)
+ *   else                     → IN_REVIEW         (bash: PENDING)
+ *
+ * The bash sub-classifications (worker-active vs action-needed within each
+ * NEEDS_ATTENTION case) are visible in PRStatus.workerActive + the individual
+ * boolean fields (mergeConflict, anyFailed, actionableBotComments) so
+ * formatters can still derive the bash-style detail strings.
+ */
+export function computePRRecommendation(params) {
+    if (params.workerActive)
+        return 'WORKING';
+    if (params.prState === 'MERGED')
+        return 'MERGED';
+    if (params.prState === 'CLOSED')
+        return 'CLOSED_WITHOUT_MERGE';
+    if (params.mergeConflict)
+        return 'NEEDS_ATTENTION';
+    if (params.anyFailed)
+        return 'NEEDS_ATTENTION';
+    if (params.actionableCount > 0)
+        return 'NEEDS_ATTENTION';
+    if (isPassiveMergeWaitCandidate({
+        prState: params.prState,
+        familyContext: params.familyContext,
+        anyFailed: params.anyFailed,
+        mergeConflict: params.mergeConflict,
+        actionableCount: params.actionableCount,
+        allPassed: params.allPassed,
+        approved: params.approved,
+    }))
+        return 'WAITING_FOR_MERGE';
+    if (params.allPassed && params.approved && params.actionableCount === 0)
+        return 'READY';
+    return 'IN_REVIEW';
+}
+//# sourceMappingURL=pr-recommendation.js.map

package/dist/contracts/pr-recommendation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-recommendation.js","sourceRoot":"","sources":["../../src/contracts/pr-recommendation.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,2EAA2E;AAC3E,0EAA0E;AAC1E,uDAAuD;AACvD,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,uCAAuC;AAmCvC;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAA0B;IACpE,OAAO,OAAO,CACZ,MAAM,CAAC,aAAa;QACpB,MAAM,CAAC,OAAO,KAAK,MAAM;QACzB,MAAM,CAAC,aAAa,CAAC,aAAa,KAAK,UAAU;QACjD,CAAC,MAAM,CAAC,SAAS;QACjB,CAAC,MAAM,CAAC,aAAa;QACrB,MAAM,CAAC,eAAe,KAAK,CAAC;QAC5B,MAAM,CAAC,SAAS;QAChB,MAAM,CAAC,QAAQ,CAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,IAAI,CAAC,MAAM,CAAC,aAAa;QAAE,OAAO,gBAAgB,CAAC;IACnD,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACjD,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,sBAAsB,CAAC;IAC/D,OAAO,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,gBAAgB,CAAC;AACtF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA8B;IACpE,IAAI,MAAM,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACjD,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,sBAAsB,CAAC;IAC/D,IAAI,MAAM,CAAC,aAAa;QAAE,OAAO,iBAAiB,CAAC;IACnD,IAAI,MAAM,CAAC,SAAS;QAAE,OAAO,iBAAiB,CAAC;IAC/C,IAAI,MAAM,CAAC,eAAe,GAAG,CAAC;QAAE,OAAO,iBAAiB,CAAC;IACzD,IACE,2BAA2B,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;QAEF,OAAO,mBAAmB,CAAC;IAC7B,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,eAAe,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACxF,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/contracts/reviews.d.ts

@@ -56,6 +56,8 @@ export interface PRStatus {
     mergeConflict: boolean;
     reviewDecision: string;
     recommendation: PRRecommendation;
+    /** True when a dispatch worker is actively running against this PR. */
+    workerActive?: boolean;
     ownedFamily?: boolean;
     familyId?: string | null;
     familyRootTicketOrPr?: string | null;

package/dist/contracts/reviews.d.ts.map

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

package/dist/contracts/reviews.js.map

@@ -1 +1 @@
-{"version":3,"file":"reviews.js","sourceRoot":"","sources":["../../src/contracts/reviews.ts"],"names":[],"mappings":"AAuHA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,WAAW,CAAC"}
+{"version":3,"file":"reviews.js","sourceRoot":"","sources":["../../src/contracts/reviews.ts"],"names":[],"mappings":"AAyHA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,WAAW,CAAC"}

package/dist/contracts/runner-ids.d.ts

@@ -0,0 +1,4 @@
+export declare const DEFAULT_RUNNER = "claude";
+export declare const RUNNER_ALIASES: Record<string, string>;
+export declare function normalizeRunner(runnerId?: string | null): string;
+//# sourceMappingURL=runner-ids.d.ts.map

package/dist/contracts/runner-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-ids.d.ts","sourceRoot":"","sources":["../../src/contracts/runner-ids.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEjD,CAAC;AAEF,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGhE"}

package/dist/contracts/runner-ids.js

@@ -0,0 +1,12 @@
+// runner-ids.ts — canonical runner-id vocabulary shared by every surface
+// (gateway registry, CLI, slot-config template expansion). Capability data
+// stays in the gateway runner registry (ADR-023); this is names only.
+export const DEFAULT_RUNNER = 'claude';
+export const RUNNER_ALIASES = {
+    'claude-code': 'claude',
+};
+export function normalizeRunner(runnerId) {
+    const normalized = (runnerId ?? DEFAULT_RUNNER).trim().toLowerCase();
+    return (RUNNER_ALIASES[normalized] ?? normalized) || DEFAULT_RUNNER;
+}
+//# sourceMappingURL=runner-ids.js.map

package/dist/contracts/runner-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-ids.js","sourceRoot":"","sources":["../../src/contracts/runner-ids.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,2EAA2E;AAC3E,sEAAsE;AAEtE,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEvC,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,aAAa,EAAE,QAAQ;CACxB,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,QAAwB;IACtD,MAAM,UAAU,GAAG,CAAC,QAAQ,IAAI,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrE,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,IAAI,cAAc,CAAC;AACtE,CAAC"}

package/dist/contracts/slot-selection.d.ts

@@ -0,0 +1,41 @@
+import type { FleetStatus, SlotStatus } from './slots.js';
+export interface SelectSlotOptions {
+    project?: string;
+    /** Validate mode: check this specific slot instead of picking one. */
+    slotId?: string;
+}
+export type SelectSlotFailureCode = 'FLEET_STALE' | 'SLOT_NOT_FOUND' | 'SLOT_UNAVAILABLE' | 'NO_PROJECT_SLOTS' | 'NO_SLOT_AVAILABLE';
+export type SelectSlotResult = {
+    ok: true;
+    slot: SlotStatus;
+} | {
+    ok: false;
+    code: SelectSlotFailureCode;
+    reason: string;
+    details: string[];
+};
+/**
+ * Why a slot cannot take a NEW task right now; null when it can. Mirrors the
+ * gateway dispatch gate (`isFreeSlot`): degraded health (device/CDP/fixtures)
+ * is a scoring concern, not an availability blocker — prepare rebuilds those.
+ */
+export declare function slotUnavailableReason(slot: SlotStatus): string | null;
+/**
+ * Why an EXPLICITLY named slot cannot be used; null when it can. Broader than
+ * auto-selection: a held slot may be reused on purpose (PR affinity), matching
+ * find-slot.sh validate mode and the gateway's `validateSlot`.
+ */
+export declare function explicitSlotBlocker(slot: SlotStatus): string | null;
+/** Shared CDP-liveness check for raw health values (gateway + operator cores). */
+export declare function isCdpLiveValue(cdp: string): boolean;
+export declare function cdpLive(slot: SlotStatus): boolean;
+/**
+ * Preference score — lower is better. Mirrors find-slot.sh: CDP live (100),
+ * warm build (10 — the bash "ready > released" criterion; the gateway maps
+ * `released` to `lifecycle: ready, warm: false`), device OK (5), fixtures
+ * OK (1). CDP dominates by construction, so no separate prefer-CDP filter
+ * is needed.
+ */
+export declare function slotSelectionScore(slot: SlotStatus): number;
+export declare function selectSlot(fleet: FleetStatus, options: SelectSlotOptions): SelectSlotResult;
+//# sourceMappingURL=slot-selection.d.ts.map

package/dist/contracts/slot-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-selection.d.ts","sourceRoot":"","sources":["../../src/contracts/slot-selection.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,qBAAqB,GAC7B,aAAa,GACb,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,CAAC;AAExB,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,qBAAqB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAElF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CASrE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAOnE;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAO3D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CA0D3F"}