// ============================================================
// LayoutAttention — the "Action needed" plan, realized.
//
// Product law: Action needed ROUTES attention. Filters help you
// INSPECT candidates. Filters do not define what needs attention.
//
// IA:
// [ Your candidates ] [ AI working · N ] ← two tabs
//
// Your candidates (default):
// All / Applied / Sourced Filters ▾
// ───────────────────────────────────────────
// ACTION NEEDED live unhandled triggers, urgency-sorted
// ALL CANDIDATES the funnel/list — filterable, sortable
//
// AI working: the machine room / trust surface. Sourcing +
// screening pool. Anything that needs a human GRADUATES into
// Action needed — you never have to open this tab to find work.
//
// Action needed is an unhandled-event log, not a smarter Engaged.
// A candidate appears only on a specific trigger, with a reason and
// a recommended next action. One dominant reason per row, by the
// precedence ladder below. Source affects PRIORITY, not membership.
//
// Rows are navigation only — clicking opens the detail panel, which
// owns stage changes + actions.
//
// Reuses globals from LayoutSurfaces.jsx: STAGES, QUALIFIED_TO_COLUMN,
// AI_STAGES, AI_STATUS.
// ============================================================
const { color: AT } = window.FF;
// ============================================================
// ACTION NEEDED — spec (kept in lockstep with the discovery note)
//
// Contains candidates with a LIVE, UNHANDLED, HUMAN-BLOCKING event.
// Every item carries: trigger timestamp · specific reason · recommended
// next action · clear condition · expiry/snooze path. (The clear, expiry
// and snooze affordances live in the detail panel — out of scope for
// these read-only rows.)
//
// "Handled" = reply sent · call logged · note added · scheduled ·
// advanced · rejected · snoozed · dismissed · or a deliberate review
// decision. Opening the profile does NOT count.
//
// Clearing is TEAM-WIDE in v1: if anyone on the account handles it, it
// clears for everyone. "Human-owned" means STAGE-owned, not assignee-
// owned — there's no assignment concept yet.
//
// The ladder is PRECEDENCE: if multiple triggers match, show the highest.
// `sort` orders WITHIN a rung only and never gates membership.
// ============================================================
const AT_FLOOR = 4.0; // job's quality floor (shared by rank 2 + 3)
const AT_HUMAN = new Set(['engaged', 'review', 'interview']); // human-owned stages
const AT_STALE_N = 4; // days of no-touch before "stale"
// Rung 1 is one tier ("waiting on a human") with three flavors — same
// urgency, but a specific row label + action so a scheduling failure never
// reads as "the candidate is waiting on us."
const AT_WAIT_LABEL = { candidate:'Waiting on us', system:'Needs your help', decision:'Decision needed' };
const AT_WAIT_ACTION = { candidate:'Reply', system:'Resolve', decision:'Decide' };
// One dominant reason per candidate, by precedence. `sort` is ascending,
// WITHIN a rung only:
// 1 waiting → longest wait first (−waitAge)
// 2 inbound → most recent first (appliedAge) — recency is SORT, not membership
// 3 screened → highest score first (−score)
// 4 stale → most overdue first (−staleDays)
function atTrigger(c) {
// Handled clears the item outright — a deliberate handling action (reply,
// call, note, schedule, advance, reject, dismiss, review decision). A new
// event would re-trigger; opening the profile never counts.
if (c.handled) return null;
// 1 — candidate OR system is waiting on a human
if (AT_HUMAN.has(c.stage) && c.waitingOnUs) {
const kind = c.waitKind || 'candidate';
return { rank:1, cat: AT_WAIT_LABEL[kind] || AT_WAIT_LABEL.candidate, reason: c.waitReason || 'Replied — respond now', action: AT_WAIT_ACTION[kind] || 'Reply', sort: -(c.waitAge || 0), age: c.waitAge ? `${c.waitAge}h` : null };
}
// 2 — new qualified inbound application, not yet handled (still in 'new').
// Membership = applied + clears floor + unhandled. Age ONLY sorts it —
// an aged-but-unhandled applicant falls lower, never falls out.
if (c.stage === 'new' && c.source === 'applied' && (c.score || 0) >= AT_FLOOR)
return { rank:2, cat:'New application', reason:'New qualified applicant — review & reach out', action:'Review', sort: (c.appliedAge || 0), age: c.appliedAge ? `${c.appliedAge}h` : null };
// 3 — AI finished screening / newly qualified, awaiting human review
if (c.stage === 'review')
return { rank:3, cat:'Screened', reason:'Screened & scored — ready for your review', action:'Review', sort: -(c.score || 0), age: c.screenedAge ? `${c.screenedAge}h` : null };
// 4 — stale after human ownership (already in a human-owned stage, no touch in N days)
if (AT_HUMAN.has(c.stage) && (c.staleDays || 0) >= AT_STALE_N)
return { rank:4, cat:'Stale', reason:`No touch in ${c.staleDays} days — follow up`, action:'Follow up', sort: -(c.staleDays || 0), age: `${c.staleDays}d` };
return null;
}
// trigger category → accent color. The three rung-1 flavors share one
// (critical) color — same tier, different label.
const AT_CAT = {
'Waiting on us': AT.critical[600],
'Needs your help': AT.critical[600],
'Decision needed': AT.critical[600],
'New application': AT.inform[600],
'Screened': AT.caution[700],
'Stale': AT.shade[600],
};
const atInitials = (name) => name.split(' ').map(s => s[0]).slice(0, 2).join('');
function SourceChip({ source }) {
const applied = source === 'applied';
const c = applied ? AT.inform : AT.copilot;
return (
{applied ? 'Applied' : '⚡ Sourced'}
);
}
function AttnRow({ c, t, on, onSelect, muted }) {
const accent = AT_CAT[t.cat] || AT.shade[600];
return (
)}
{visItems.map(({ c, t }) => (
))}
{/* fold-don't-hide: action items outside the source filter, one tap from full view */}
{foldedItems.length > 0 && (
{foldOpen && foldedItems.map(({ c, t }) => (
))}
)}
{/* ─────────── ALL CANDIDATES (the funnel / map) ─────────── */}
All candidates{funnelPool.length}
{f.active && · filtered}
{groups.map(stage => {
const open = openStages.has(stage.key);
return (
{open && stage.members.map(c => {
const on = c.id === selectedId, flag = trigIds.has(c.id);
return (
);
}
// AI working tab — the machine room / trust surface. De-emphasized rows.
// Everyone here is still being handled by the AI with no human action needed;
// the moment one needs a human it graduates OUT into Action needed, so you
// never have to dig here for work.
function AIWorkingTab({ list, total, selectedId, onSelect }) {
return (
The AI is sourcing & screening {total} candidates on its own. The moment one needs a human it moves to Action needed — so this tab only holds what the AI is still handling. You don’t have to work it.