gloomberb 0.18.3 → 0.18.4

package/src/plugins/builtin/company-attention/client.ts

@@ -1,12 +1,19 @@
 import { apiClient } from "../../../api-client";
 import type { AppAttentionFilter, AppAttentionPayload, AppRankPayload } from "../../../api-client/app-attention";
-import type { HiringBoard, HiringPayload, HiringSummary } from "../../../api-client/hiring";
+import type { HiringBoard, HiringBuildingBoard, HiringBuildingFilter, HiringBuildingShift, HiringCompanyBuilding, HiringCompanyMoves, HiringCompanySignals, HiringMixRow, HiringMove, HiringMovePosting, HiringMovesBoard, HiringMovesFilter, HiringMoveWeek, HiringPayload, HiringSignalGroup, HiringSignalsBoard, HiringSignalsFilter, HiringSummary, HiringWeekSignal } from "../../../api-client/hiring";
+import type { CloudJobsPostingDetail } from "../../../api-client/types";
 import { createPluginCache } from "../../../data/plugin-cache";
 import { cachedCloudResource, loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
 import type { AppFocus, AttentionKind } from "./model";
 
 export type AttentionPayload = HiringBoard | HiringPayload | AppAttentionPayload;
 export const attentionCache = createPluginCache<AttentionPayload>({ kind: "company-attention", source: "gloom-cloud", schemaVersion: 1, policy: { staleMs: 30 * 60_000, expireMs: 7 * 86_400_000 } });
+export type MovesPayload = HiringMovesBoard | HiringCompanyMoves;
+export const movesCache = createPluginCache<MovesPayload>({ kind: "hiring-moves", source: "gloom-cloud", schemaVersion: 1, policy: { staleMs: 30 * 60_000, expireMs: 7 * 86_400_000 } });
+export type SignalsPayload = HiringSignalsBoard | HiringCompanySignals;
+export const signalsCache = createPluginCache<SignalsPayload>({ kind: "hiring-signals", source: "gloom-cloud", schemaVersion: 1, policy: { staleMs: 30 * 60_000, expireMs: 7 * 86_400_000 } });
+export type BuildingPayload = HiringBuildingBoard | HiringCompanyBuilding;
+export const buildingCache = createPluginCache<BuildingPayload>({ kind: "hiring-building", source: "gloom-cloud", schemaVersion: 1, policy: { staleMs: 30 * 60_000, expireMs: 7 * 86_400_000 } });
 export const appRankCache = createPluginCache<AppRankPayload>({ kind: "app-rank-history", source: "gloom-cloud", schemaVersion: 1, policy: { staleMs: 30 * 60_000, expireMs: 7 * 86_400_000 } });
 const finite = (value: unknown) => typeof value === "number" && Number.isFinite(value);
 const positive = (value: unknown) => finite(value) && (value as number) >= 0;
@@ -60,6 +67,95 @@ const cacheKey = (kind: AttentionKind, symbol: string | undefined, access: strin
 export const cachedAttention = (kind: AttentionKind, symbol: string | undefined, access: string, filters: AppAttentionFilter) => cachedCloudResource(attentionCache, cacheKey(kind, symbol, access, filters), (data) => validateAttention(kind, data));
 export const loadAttention = (kind: AttentionKind, symbol: string | undefined, access: string, filters: AppAttentionFilter, force = false) => loadCloudResource(attentionCache, cacheKey(kind, symbol, access, filters), () => fetchAttention(kind, symbol, filters), { force, validate: (data) => validateAttention(kind, data) });
 
+const SIGNALS = new Set(["accelerating", "slowing", "with_peers", null]);
+const hiringMove = (row: HiringMove) => !!row && typeof row.symbol === "string" && typeof row.name === "string" && date(row.week) && positive(row.newRoles)
+  && !!row.baseline && positive(row.baseline.mean) && Array.isArray(row.baseline.values) && finite(row.zScore) && !!row.peers && typeof row.peers.label === "string"
+  && SIGNALS.has(row.signal) && Array.isArray(row.drivers) && row.drivers.every((driver) => typeof driver.label === "string" && positive(driver.newRoles))
+  && Array.isArray(row.topTitles) && typeof row.why === "string" && Array.isArray(row.sourceTickers);
+const moveWeek = (row: HiringMoveWeek) => !!row && date(row.week) && typeof row.measured === "boolean" && Array.isArray(row.excluded);
+const movePosting = (row: HiringMovePosting) => !!row && typeof row.title === "string" && date(row.firstSeenAt) && (row.url === null || url(row.url));
+export function validateMoves(payload: MovesPayload): MovesPayload {
+  const valid = !!payload && date(payload.generatedAt) && typeof payload.preview === "boolean" && numericTree(payload) && ("moves" in payload
+    ? (payload.week === null || date(payload.week)) && Array.isArray(payload.moves) && payload.moves.every(hiringMove) && positive(payload.total) && positive(payload.locked) && !!payload.coverage?.signals
+    : typeof payload.symbol === "string" && (payload.latest === null || hiringMove(payload.latest)) && (payload.week === null || moveWeek(payload.week))
+      && Array.isArray(payload.weeks) && payload.weeks.every(moveWeek) && Array.isArray(payload.history) && !!payload.evidence
+      && [payload.evidence.added, payload.evidence.closed].every((rows) => Array.isArray(rows) && rows.every(movePosting)) && !!payload.locked);
+  if (!valid) throw new Error("The server returned unreadable hiring moves.");
+  return payload;
+}
+export interface MovesQuery { filter?: HiringMovesFilter; offset?: number; limit?: number }
+export async function fetchMoves(symbol: string | undefined, query: MovesQuery = {}, client: Pick<typeof apiClient, "getCloudHiringMoves"> = apiClient, signal?: AbortSignal) {
+  try {
+    const data = validateMoves(await client.getCloudHiringMoves(symbol, { limit: query.limit, offset: query.offset, signal: query.filter }, signal));
+    if (symbol && (!("symbol" in data) || data.symbol.toUpperCase() !== symbol.toUpperCase() && data.requestedSymbol?.toUpperCase() !== symbol.toUpperCase())) throw new Error("The server returned moves for a different company.");
+    return data;
+  } catch (error) { throw unavailableOnServer(error, "Hiring moves are not available yet.", [404, 503]); }
+}
+const movesKey = (symbol: string | undefined, access: string, filter: HiringMovesFilter) => `${symbol ?? `board:${filter}`}:${access}`;
+export const cachedMoves = (symbol: string | undefined, access: string, filter: HiringMovesFilter) => cachedCloudResource(movesCache, movesKey(symbol, access, filter), validateMoves);
+export const loadMoves = (symbol: string | undefined, access: string, filter: HiringMovesFilter, force = false) => loadCloudResource(movesCache, movesKey(symbol, access, filter), () => fetchMoves(symbol, { filter }), { force, validate: validateMoves });
+
+const KINDS = new Set(["new_country", "new_city", "location_spike", "function_spike", "new_role_type"]);
+const weekSignal = (row: HiringWeekSignal) => !!row && typeof row.symbol === "string" && typeof row.name === "string" && date(row.week) && KINDS.has(row.kind)
+  && ["expansion", "anomalies"].includes(row.group) && typeof row.key === "string" && typeof row.label === "string" && positive(row.newRoles)
+  && !!row.history && date(row.history.watchedSince) && positive(row.history.priorPostings) && (row.history.priorShare === null || fraction(row.history.priorShare))
+  && (row.baseline === null || (!!row.baseline && positive(row.baseline.mean) && Array.isArray(row.baseline.values))) && Array.isArray(row.flags)
+  && Array.isArray(row.topTitles) && Array.isArray(row.places) && Array.isArray(row.postings) && row.postings.every(movePosting)
+  && typeof row.why === "string" && Array.isArray(row.sourceTickers);
+export function validateSignals(payload: SignalsPayload): SignalsPayload {
+  const valid = !!payload && date(payload.generatedAt) && typeof payload.preview === "boolean" && numericTree(payload) && ("group" in payload
+    ? ["expansion", "anomalies"].includes(payload.group) && (payload.week === null || date(payload.week)) && Array.isArray(payload.signals) && payload.signals.every(weekSignal)
+      && positive(payload.total) && positive(payload.locked) && !!payload.coverage?.counts
+    : typeof payload.symbol === "string" && (payload.week === null || date(payload.week)) && (payload.watchedSince === null || date(payload.watchedSince))
+      && Array.isArray(payload.signals) && payload.signals.every(weekSignal) && Array.isArray(payload.history) && payload.history.every(weekSignal)
+      && Array.isArray(payload.skipped) && !!payload.locked);
+  if (!valid) throw new Error("The server returned unreadable hiring signals.");
+  return payload;
+}
+export interface SignalsQuery { filter?: HiringSignalsFilter; offset?: number; limit?: number }
+/** A group's board, or a company's signals (both groups; the view keeps its own). */
+export async function fetchSignals(group: HiringSignalGroup, symbol: string | undefined, query: SignalsQuery = {}, client: Pick<typeof apiClient, "getCloudHiringSignals" | "getCloudHiringCompanySignals"> = apiClient, signal?: AbortSignal) {
+  try {
+    const data = validateSignals(symbol ? await client.getCloudHiringCompanySignals(symbol, signal) : await client.getCloudHiringSignals(group, { limit: query.limit, offset: query.offset, kind: query.filter }, signal));
+    if (symbol && (!("symbol" in data) || data.symbol.toUpperCase() !== symbol.toUpperCase() && data.requestedSymbol?.toUpperCase() !== symbol.toUpperCase())) throw new Error("The server returned signals for a different company.");
+    if (!symbol && (!("group" in data) || data.group !== group)) throw new Error("The server returned another tab's signals.");
+    return data;
+  } catch (error) { throw unavailableOnServer(error, "Hiring signals are not available yet.", [404, 503]); }
+}
+const signalsKey = (group: HiringSignalGroup, symbol: string | undefined, access: string, filter: HiringSignalsFilter) => `${symbol ?? `${group}:${filter}`}:${access}`;
+export const cachedSignals = (group: HiringSignalGroup, symbol: string | undefined, access: string, filter: HiringSignalsFilter) => cachedCloudResource(signalsCache, signalsKey(group, symbol, access, filter), validateSignals);
+export const loadSignals = (group: HiringSignalGroup, symbol: string | undefined, access: string, filter: HiringSignalsFilter, force = false) => loadCloudResource(signalsCache, signalsKey(group, symbol, access, filter), () => fetchSignals(group, symbol, { filter }), { force, validate: validateSignals });
+
+const DIMENSIONS = new Set(["function", "theme"]);
+const mixRow = (row: HiringMixRow) => !!row && DIMENSIONS.has(row.dimension) && typeof row.key === "string" && typeof row.label === "string"
+  && positive(row.recentRoles) && fraction(row.recentShare) && positive(row.beforeRoles) && fraction(row.beforeShare) && finite(row.change) && typeof row.read === "boolean";
+const shiftPart = (part: HiringBuildingShift["recent"]) => !!part && positive(part.weeks) && positive(part.roles) && positive(part.total) && fraction(part.share) && Array.isArray(part.values);
+const buildingShift = (row: HiringBuildingShift) => !!row && typeof row.symbol === "string" && typeof row.name === "string" && date(row.week) && DIMENSIONS.has(row.dimension)
+  && typeof row.key === "string" && typeof row.label === "string" && shiftPart(row.recent) && shiftPart(row.before) && finite(row.change) && finite(row.zScore)
+  && Array.isArray(row.topTitles) && Array.isArray(row.postings) && row.postings.every(movePosting) && typeof row.why === "string" && Array.isArray(row.sourceTickers);
+export function validateBuilding(payload: BuildingPayload): BuildingPayload {
+  const valid = !!payload && date(payload.generatedAt) && typeof payload.preview === "boolean" && numericTree(payload) && ("shifts" in payload && "filter" in payload
+    ? (payload.week === null || date(payload.week)) && Array.isArray(payload.shifts) && payload.shifts.every(buildingShift) && positive(payload.total) && positive(payload.locked) && !!payload.coverage?.counts
+    : "functions" in payload && typeof payload.symbol === "string" && (payload.week === null || date(payload.week)) && Array.isArray(payload.functions) && payload.functions.every(mixRow)
+      && Array.isArray(payload.themes) && payload.themes.every(mixRow) && Array.isArray(payload.shifts) && payload.shifts.every(buildingShift)
+      && Array.isArray(payload.history) && payload.history.every(buildingShift) && Array.isArray(payload.skipped) && !!payload.locked);
+  if (!valid) throw new Error("The server returned an unreadable hiring mix.");
+  return payload;
+}
+export interface BuildingQuery { filter?: HiringBuildingFilter; offset?: number; limit?: number }
+/** The Building board, or one company's mix and shifts. */
+export async function fetchBuilding(symbol: string | undefined, query: BuildingQuery = {}, client: Pick<typeof apiClient, "getCloudHiringBuilding" | "getCloudHiringCompanyBuilding"> = apiClient, signal?: AbortSignal) {
+  try {
+    const data = validateBuilding(symbol ? await client.getCloudHiringCompanyBuilding(symbol, signal) : await client.getCloudHiringBuilding({ limit: query.limit, offset: query.offset, dimension: query.filter }, signal));
+    if (symbol && (!("symbol" in data) || data.symbol.toUpperCase() !== symbol.toUpperCase() && data.requestedSymbol?.toUpperCase() !== symbol.toUpperCase())) throw new Error("The server returned a hiring mix for a different company.");
+    if (!symbol && !("filter" in data)) throw new Error("The server returned a company's mix for the board.");
+    return data;
+  } catch (error) { throw unavailableOnServer(error, "What companies are building is not available yet.", [404, 503]); }
+}
+const buildingKey = (symbol: string | undefined, access: string, filter: HiringBuildingFilter) => `${symbol ?? `board:${filter}`}:${access}`;
+export const cachedBuilding = (symbol: string | undefined, access: string, filter: HiringBuildingFilter) => cachedCloudResource(buildingCache, buildingKey(symbol, access, filter), validateBuilding);
+export const loadBuilding = (symbol: string | undefined, access: string, filter: HiringBuildingFilter, force = false) => loadCloudResource(buildingCache, buildingKey(symbol, access, filter), () => fetchBuilding(symbol, { filter }), { force, validate: validateBuilding });
+
 export async function fetchAppRank(focus: AppFocus, days: number, offset = 0, signal?: AbortSignal, client: Pick<typeof apiClient, "getCloudAppRankHistory"> = apiClient, limit = 500) {
   const data = await client.getCloudAppRankHistory(focus.store, focus.appId, { country: focus.country, chart: focus.chart, days, offset, limit }, signal);
   if (!data || data.appId !== focus.appId || data.store !== focus.store || !["pro", "preview"].includes(data.access)
@@ -67,3 +163,23 @@ export async function fetchAppRank(focus: AppFocus, days: number, offset = 0, si
   return data;
 }
 export const loadAppRank = (focus: AppFocus, access: string, days: number, force = false) => loadCloudResource(appRankCache, `${access}:${focus.store}:${focus.appId}:${focus.country}:${focus.chart}:${days}`, () => fetchAppRank(focus, days), { force });
+
+const POSTING_TTL_MS = 5 * 60_000;
+const postingCache = new Map<string, { at: number; posting: Promise<CloudJobsPostingDetail> }>();
+/**
+ * The page HIRE's evidence row was read from: its title, place, date, pay,
+ * hours and description. Kept a few minutes, so stepping back and forth
+ * through the evidence does not read it again.
+ */
+export function fetchPostingDetail(ticker: string, externalId: string, client: Pick<typeof apiClient, "getCloudJobsPosting"> = apiClient): Promise<CloudJobsPostingDetail> {
+  const key = `${ticker.toUpperCase()}:${externalId}`;
+  const cached = postingCache.get(key);
+  if (cached && Date.now() - cached.at < POSTING_TTL_MS) return cached.posting;
+  const posting = client.getCloudJobsPosting(ticker, { externalId }).then((detail) => {
+    if (!detail || typeof detail.title !== "string" || detail.externalId !== externalId) throw new Error("The server returned an unreadable posting.");
+    return detail;
+  });
+  postingCache.set(key, { at: Date.now(), posting });
+  posting.catch(() => postingCache.delete(key));
+  return posting;
+}

package/src/plugins/builtin/company-attention/evidence.ts

@@ -1,7 +1,10 @@
 import type { PaneScreenshotEvidenceHook } from "../../../cli/pane-functions/screenshot-evidence";
 import { useRemoteUiNode } from "../../../remote/semantic-tree";
 import { isRecord } from "../../../utils/guards";
-import { fetchAppRank, fetchAttention, validateAttention, type AttentionPayload } from "./client";
+import { fetchAppRank, fetchAttention, fetchBuilding, fetchMoves, fetchSignals, validateAttention, type AttentionPayload } from "./client";
+import { isBuildingFilter } from "./building-model";
+import { isMovesFilter } from "./moves-model";
+import { isSignalGroup, isSignalsFilter } from "./signals-model";
 import type { AttentionKind } from "./model";
 import type { AppChart, AppRankPayload } from "../../../api-client/app-attention";
 
@@ -27,11 +30,21 @@ export function attentionScreenshotEvidence(kind: AttentionKind): PaneScreenshot
       }
       const symbol = resolved.createOptions?.symbol ?? resolved.createOptions?.arg;
       const payload = await fetchAttention(kind, symbol, { country: typeof resolved.options.country === "string" ? resolved.options.country : undefined, chart: resolved.options.chart as "free" | "paid" | undefined, days: Number(resolved.options.days) || 90 });
-      return { settings: { attentionSnapshot: payload }, financials: symbol ? [[symbol, { annualStatements: [], quarterlyStatements: [], priceHistory: [] }]] : [] };
+      // HIRE's Moves tab reads its own payload.
+      const moves = kind === "hiring" && resolved.options.tab === "moves"
+        ? await fetchMoves(symbol, { filter: typeof resolved.options.moves === "string" && isMovesFilter(resolved.options.moves) ? resolved.options.moves : "moves" }) : null;
+      // So do Expansion and Anomalies.
+      const group = kind === "hiring" && typeof resolved.options.tab === "string" && isSignalGroup(resolved.options.tab) ? resolved.options.tab : null;
+      const signalsKind = typeof resolved.options.kind === "string" ? resolved.options.kind : "all";
+      const signals = group ? await fetchSignals(group, symbol, { filter: isSignalsFilter(group, signalsKind) ? signalsKind : "all" }) : null;
+      // And Building.
+      const dimension = typeof resolved.options.dimension === "string" && isBuildingFilter(resolved.options.dimension) ? resolved.options.dimension : "all";
+      const building = kind === "hiring" && resolved.options.tab === "building" ? await fetchBuilding(symbol, { filter: dimension }) : null;
+      return { settings: { attentionSnapshot: payload, ...(moves ? { movesSnapshot: moves } : {}), ...(group && signals ? { [`${group}Snapshot`]: signals } : {}), ...(building ? { buildingSnapshot: building } : {}) }, financials: symbol ? [[symbol, { annualStatements: [], quarterlyStatements: [], priceHistory: [] }]] : [] };
     },
     read(value) {
       if (!isRecord(value) || value.kind !== kind || value.version !== 1 || value.complete !== true || !isRecord(value.payload)
-        || !["table", "chart", "mix", "peers", "evidence"].includes(String(value.tab)) || !Array.isArray(value.rowIds) || !value.rowIds.every((id) => typeof id === "string") || value.plottedValueCount !== value.rowIds.length) return null;
+        || !["table", "chart", "mix", "peers", "evidence", ...(kind === "hiring" ? ["moves", "expansion", "anomalies", "building"] : [])].includes(String(value.tab)) || !Array.isArray(value.rowIds) || !value.rowIds.every((id) => typeof id === "string") || value.plottedValueCount !== value.rowIds.length) return null;
       try { if (!(kind === "apps" && Array.isArray(value.payload.rankHistory))) validateAttention(kind, value.payload as unknown as AttentionPayload); return value as unknown as AttentionEvidence; } catch { return null; }
     },
     mismatches(evidence, { resolved, payload }) {

package/src/plugins/builtin/company-attention/headless.ts

@@ -2,8 +2,12 @@ import type { HeadlessPaneColumn, HeadlessPaneDefinition, HeadlessPaneRow } from
 import type { DataTableColumn } from "../../../components";
 import type { AppAttentionPayload, AppChart } from "../../../api-client/app-attention";
 import type { HiringBoard, HiringPayload } from "../../../api-client/hiring";
-import { fetchAppRank, fetchAttention } from "./client";
+import { fetchAppRank, fetchAttention, fetchBuilding, fetchMoves, fetchSignals, type BuildingPayload, type SignalsPayload } from "./client";
+import { BUILDING_FILTERS, BUILDING_VIEWS, buildingBoardModel, buildingNumber, buildingPreviewNote, companyBuildingModel, isBuildingFilter, type BuildingSection } from "./building-model";
 import { appsModel, appsPreviewNote, attentionNumber, attentionSectionTitle, attentionTabs, hiringModel, hiringPreviewNote, remoteText, type AttentionKind } from "./model";
+import { companyMovesModel, isMovesFilter, movesBoardModel, movesNumber, movesPreviewNote, MOVES_FILTERS, MOVES_VIEWS, type MovesSection } from "./moves-model";
+import type { HiringMovesFilter, HiringSignalGroup } from "../../../api-client/hiring";
+import { companySignalsModel, holdText, isSignalsFilter, signalsBoardModel, signalsNumber, signalsPreviewNote, SIGNAL_FILTERS, SIGNAL_GROUPS, SIGNALS_VIEWS, type SignalsSection } from "./signals-model";
 import { REPORT_PAGE, REPORT_ROWS } from "../shared/headless-options";
 
 /**
@@ -19,6 +23,56 @@ function reportColumn(column: DataTableColumn): HeadlessPaneColumn {
       ? remoteText(value, typeof row.remoteKnown === "number" ? row.remoteKnown : null) ?? "-" : "-" } : {}) };
 }
 
+/** A moves view as a report section: paces as `3.4x`, scores signed, and on the board each move's why. */
+function movesSection(title: string, section: MovesSection, why: boolean) {
+  return {
+    title, empty: section.empty, ...(section.locked ? { locked: true } : {}),
+    columns: [...section.columns.map((column): HeadlessPaneColumn => column.align !== "right" ? { key: column.id, header: column.label, align: column.align }
+      : { key: column.id, header: column.label, align: column.align, format: (value: unknown) => typeof value === "number" ? movesNumber(column.id, value) : value == null ? "-" : String(value) }),
+    ...(why ? [{ key: "why", header: "Why", align: "left" as const }] : [])],
+    rows: section.rows.map((row) => ({ ...row.values, ...(row.move ? { why: row.move.why } : {}), ...(row.url ? { sourceUrl: row.url } : {}) })),
+  };
+}
+
+/** A signals view as a report section: paces as `3.4x`, and each signal's why. */
+function signalsSection(title: string, section: SignalsSection) {
+  return {
+    title, empty: section.empty, ...(section.locked ? { locked: true } : {}),
+    columns: [...section.columns.map((column): HeadlessPaneColumn => column.align !== "right" ? { key: column.id, header: column.label, align: column.align }
+      : { key: column.id, header: column.label, align: column.align, format: (value: unknown) => typeof value === "number" ? signalsNumber(column.id, value) : value == null ? "-" : String(value) }),
+    ...(section.rows.some((row) => row.signal && !row.jobPosting) ? [{ key: "why", header: "Why", align: "left" as const }] : [])],
+    rows: section.rows.map((row) => ({ ...row.values, ...(row.signal && !row.jobPosting ? { why: row.signal.why } : {}), ...(row.url ? { sourceUrl: row.url } : {}) })),
+  };
+}
+/** A building view as a report section: shares as percents, changes in points, and each shift's why. */
+function buildingSection(title: string, section: BuildingSection) {
+  const why = section.rows.some((row) => row.shift && !row.jobPosting && !row.mix);
+  return {
+    title, empty: section.empty, ...(section.locked ? { locked: true } : {}),
+    columns: [...section.columns.map((column): HeadlessPaneColumn => column.align !== "right" ? { key: column.id, header: column.label, align: column.align }
+      : { key: column.id, header: column.label, align: column.align, format: (value: unknown) => typeof value === "number" ? buildingNumber(column.id, value) : value == null ? "-" : String(value) }),
+    ...(why ? [{ key: "why", header: "Why", align: "left" as const }] : [])],
+    rows: section.rows.map((row) => ({ ...row.values, ...(why && row.shift && !row.jobPosting ? { why: row.shift.why } : {}), ...(row.url ? { sourceUrl: row.url } : {}) })),
+  };
+}
+/** The Building board, or a company's mix by family and theme, its shifts and the postings behind them. */
+function buildingSections(data: BuildingPayload, filter: string): ReturnType<typeof buildingSection>[] {
+  if ("filter" in data) return [buildingSection("Building", buildingBoardModel(data, isBuildingFilter(filter) ? filter : "all").sections.board!)];
+  const model = companyBuildingModel(data);
+  return ([["families", "Building: role families"], ["themes", "Building: themes"], ["shifts", "Building: shifts"], ["postings", "Building postings"]] as const)
+    .filter(([id]) => id !== "postings" || model.sections.postings!.rows.length).map(([id, title]) => buildingSection(title, model.sections[id]!));
+}
+const SIGNAL_TITLES: Record<HiringSignalGroup, string> = { expansion: "Expansion", anomalies: "Anomalies" };
+/** A board's two groups, or a company's signals of both, as report sections. */
+function signalsSections(reads: Array<{ group: HiringSignalGroup; data: SignalsPayload }>, kind: string): ReturnType<typeof signalsSection>[] {
+  return reads.flatMap(({ group, data }) => {
+    if ("group" in data) return [signalsSection(SIGNAL_TITLES[group], signalsBoardModel(data, isSignalsFilter(group, kind) ? kind : "all").sections.board!)];
+    const model = companySignalsModel(data, group);
+    return [signalsSection(SIGNAL_TITLES[group], model.sections.signals!),
+      ...(model.sections.postings!.rows.length ? [signalsSection(`${SIGNAL_TITLES[group]} postings`, model.sections.postings!)] : [])];
+  });
+}
+
 export function attentionHeadless(kind: AttentionKind): HeadlessPaneDefinition<"bundle"> {
   return {
     shape: "bundle",
@@ -29,7 +83,20 @@ export function attentionHeadless(kind: AttentionKind): HeadlessPaneDefinition<"
     options: [
       { key: "limit", shot: REPORT_ROWS, type: "string", defaultValue: "100", description: "Rows per REST page, up to 200 for hiring and 500 for apps." },
       { key: "offset", shot: REPORT_PAGE, type: "string", defaultValue: "0", description: "Continuation offset from the prior report metadata." },
-      { key: "tab", type: "enum", settingKey: "tab", values: ["table", "chart", "mix", "peers", "evidence"].map((value) => ({ value })), defaultValue: "table", description: "Table, dated history, geographic or role mix, peers, or source evidence." },
+      { key: "tab", type: "enum", settingKey: "tab", values: [...["table", "chart", "mix", "peers", "evidence"], ...(kind === "hiring" ? ["moves", "expansion", "anomalies", "building"] : [])].map((value) => ({ value })), defaultValue: "table",
+        description: kind === "hiring" ? "Table, dated history, role mix, peers, source evidence, moves against the company's own weeks and peers, first roles in a new country or city, place and role-family spikes, or the role families and themes whose share of new roles rose." : "Table, dated history, geographic or role mix, peers, or source evidence." },
+      ...(kind === "hiring" ? [
+        { key: "moves", type: "enum" as const, settingKey: "movesFilter", values: MOVES_FILTERS.map(({ value }) => ({ value })), defaultValue: "moves", description: "Which hiring moves the board lists: own moves, one direction, or every measured company." },
+        { key: "view", type: "enum" as const, settingKey: "movesView", values: MOVES_VIEWS.map(({ value }) => ({ value })), defaultValue: "weeks", description: "A company's Moves tab: its weeks, the role families or titles behind the move, or the postings first seen or closed that week." },
+        { key: "kind", type: "enum" as const, settingKey: "signalsKind", values: [...new Set(SIGNAL_GROUPS.flatMap((group) => SIGNAL_FILTERS[group].map(({ value }) => value)))].map((value) => ({ value })), defaultValue: "all",
+          description: "Which signals the Expansion or Anomalies board lists: new countries or cities, place or role-family spikes, or new role families." },
+        { key: "signalsView", aliases: ["signals-view"], type: "enum" as const, settingKey: "signalsView", values: SIGNALS_VIEWS.map(({ value }) => ({ value })), defaultValue: "signals",
+          description: "A company's Expansion or Anomalies tab: its signals, or the postings behind this week's." },
+        { key: "dimension", type: "enum" as const, settingKey: "buildingDimension", values: BUILDING_FILTERS.map(({ value }) => ({ value })), defaultValue: "all",
+          description: "Which shifts the Building board lists: role families, themes, or both." },
+        { key: "buildingView", aliases: ["building-view"], type: "enum" as const, settingKey: "buildingView", values: BUILDING_VIEWS.map(({ value }) => ({ value })), defaultValue: "families",
+          description: "A company's Building tab: its mix by role family or by theme, its shifts, or the postings behind this week's." },
+      ] : []),
       ...(kind === "apps" ? [
         { key: "appId", aliases: ["app-id"], type: "string" as const, settingKey: "appId", description: "Open one app's exact country/chart rank history instead of a company." },
         { key: "store", type: "enum" as const, settingKey: "store", values: [{ value: "app-store" }, { value: "google-play" }], defaultValue: "app-store", description: "Store for an individual app history." },
@@ -48,6 +115,17 @@ export function attentionHeadless(kind: AttentionKind): HeadlessPaneDefinition<"
         const rank = await fetchAppRank({ store, appId: args.options.appId, name: args.options.appId, country: String(args.options.country || (store === "google-play" ? "GLOBAL" : "US")).toUpperCase(), chart: (args.options.chart || (store === "google-play" ? "unranked" : "free")) as AppChart }, Number(args.options.days) || 90, Number(args.options.offset) || 0, ctx.signal, ctx.apiClient, Number(args.options.limit) || 100);
         return { complete: rank.access === "pro" && rank.page.nextOffset === null, sections: [{ title: "App rank history", rows: rank.rankHistory }], metadata: { nextOffset: rank.page.nextOffset, preview: rank.access === "preview", lockedRows: rank.locked, provenance: rank } };
       }
+      const movesFilter: HiringMovesFilter = typeof args.options.moves === "string" && isMovesFilter(args.options.moves) ? args.options.moves : "moves";
+      // Moves are their own read; a server without them leaves the rest of the report as it was.
+      const failed = (error: unknown) => error instanceof Error ? error : new Error(String(error));
+      const movesRead = kind === "hiring" ? fetchMoves(args.symbols[0], { filter: movesFilter }, ctx.apiClient, ctx.signal).catch(failed) : null;
+      // So are Expansion and Anomalies: a company's both groups in one read, the board one read each.
+      const signalsKind = typeof args.options.kind === "string" ? args.options.kind : "all";
+      const signalsRead = kind !== "hiring" ? null : Promise.all((args.symbols[0] ? ["expansion" as const] : SIGNAL_GROUPS).map((group) =>
+        fetchSignals(group, args.symbols[0], { filter: isSignalsFilter(group, signalsKind) ? signalsKind : "all" }, ctx.apiClient, ctx.signal))).catch(failed);
+      // And Building.
+      const dimension = typeof args.options.dimension === "string" && isBuildingFilter(args.options.dimension) ? args.options.dimension : "all";
+      const buildingRead = kind === "hiring" ? fetchBuilding(args.symbols[0], { filter: dimension }, ctx.apiClient, ctx.signal).catch(failed) : null;
       const data = await fetchAttention(kind, args.symbols[0], { limit: Number(args.options.limit) || 100, offset: Number(args.options.offset) || 0, ...(typeof args.options.country === "string" ? { country: args.options.country } : {}), ...(typeof args.options.chart === "string" ? { chart: args.options.chart as AppChart } : {}), days: Number(args.options.days) || 90 }, ctx.apiClient);
       const filtered = typeof args.options.country === "string" && !!args.options.country || typeof args.options.chart === "string" && !!args.options.chart;
       const model = kind === "hiring" ? hiringModel(data as HiringPayload | HiringBoard) : appsModel(data as AppAttentionPayload, undefined, filtered);
@@ -55,10 +133,28 @@ export function attentionHeadless(kind: AttentionKind): HeadlessPaneDefinition<"
       // The free preview ignores the offset, so it has no next page to point at.
       const nextOffset = kind === "hiring" && "total" in data ? !data.preview && offset + data.companies.length < data.total ? offset + data.companies.length : null : (data as AppAttentionPayload).page?.nextOffset ?? null;
       const lock = kind === "hiring" ? hiringPreviewNote(data as HiringPayload | HiringBoard) : appsPreviewNote(data as AppAttentionPayload);
-      const notes = [...model.notices, ...(nextOffset !== null ? [`Additional observations available with --offset ${nextOffset}.`] : [])];
+      const movesData = movesRead ? await movesRead : null;
+      const movesModel = movesData && !(movesData instanceof Error) ? "moves" in movesData ? movesBoardModel(movesData, movesFilter) : companyMovesModel(movesData) : null;
+      const movesLock = movesData && !(movesData instanceof Error) ? movesPreviewNote(movesData, movesFilter) : null;
+      const signalsData = signalsRead ? await signalsRead : null;
+      const signalsReads = !signalsData || signalsData instanceof Error ? [] : args.symbols[0] ? SIGNAL_GROUPS.map((group) => ({ group, data: signalsData[0]! })) : signalsData.map((data, index) => ({ group: SIGNAL_GROUPS[index]!, data }));
+      const signalsLocks = !signalsData || signalsData instanceof Error ? [] : signalsData.map((data) => signalsPreviewNote(data, "group" in data && isSignalsFilter(data.group, signalsKind) ? signalsKind : undefined));
+      const buildingData = buildingRead ? await buildingRead : null;
+      const buildingLock = buildingData && !(buildingData instanceof Error) ? buildingPreviewNote(buildingData, dimension) : null;
+      const buildingHeld = buildingData && !(buildingData instanceof Error) && !("filter" in buildingData) ? companyBuildingModel(buildingData).held : null;
+      // A company's move says why in one sentence; the board's rows each carry theirs.
+      const why = movesModel?.latest?.why;
+      const company = args.symbols[0] ? signalsReads[0]?.data : undefined;
+      const held = company && !("group" in company) && company.held ? holdText(company.held) : null;
+      const notes = [...model.notices, ...(nextOffset !== null ? [`Additional observations available with --offset ${nextOffset}.`] : []),
+        ...(movesData instanceof Error ? [movesData.message] : []), ...(why ? [why] : []),
+        ...(signalsData instanceof Error ? [signalsData.message] : []), ...(held ? [`No expansion or anomaly signal this week: ${held.toLowerCase()}.`] : []),
+        ...(buildingData instanceof Error ? [buildingData.message] : []), ...(buildingHeld ? [`No mix to compare this week: ${buildingHeld.toLowerCase()}.`] : [])];
+      const movesSections = !movesModel ? [] : (args.symbols[0] ? ([["weeks", "Hiring moves"], ["drivers", "Move drivers"], ["added", "Postings first seen"]] as const) : ([["board", "Hiring moves"]] as const))
+        .map(([id, title]) => movesSection(title, movesModel.sections[id]!, id === "board"));
       return {
         complete: !model.preview && !model.partial && nextOffset === null,
-        ...(lock ? { errors: [lock] } : {}),
+        ...(lock || movesLock || buildingLock || signalsLocks.some(Boolean) ? { errors: [lock, movesLock, ...signalsLocks, buildingLock].filter((line): line is string => !!line) } : {}),
         ...(notes.length ? { notes } : {}),
         // A ticker no observed app is mapped to says so once, not under each empty view.
         ...(model.unmapped ? { empty: model.unmapped } : {}),
@@ -68,7 +164,7 @@ export function attentionHeadless(kind: AttentionKind): HeadlessPaneDefinition<"
           return { title: attentionSectionTitle(kind, tab, args.symbols[0]),
             columns: section.columns.map(reportColumn), empty: section.empty, ...(section.locked ? { locked: true } : {}),
             rows: section.rows.map((row) => ({ ...row.values, ...(row.url ? { sourceUrl: row.url } : {}), ...(row.details ? { evidence: row.details } : {}) })) };
-        }),
+        }).concat(movesSections, signalsSections(signalsReads, signalsKind), buildingData && !(buildingData instanceof Error) ? buildingSections(buildingData, dimension) : []),
         metadata: { nextOffset, asOf: model.asOf, preview: model.preview, lockedRows: model.locked, unit: model.chart.unit, provenance: data },
       };
     },

package/src/plugins/builtin/company-attention/index.tsx

@@ -1,12 +1,12 @@
 import type { PluginModule } from "../plugin-module";
 import type { PaneTemplateDef } from "../../../types/plugin";
-import { appRankCache, attentionCache } from "./client";
+import { appRankCache, attentionCache, buildingCache, movesCache, signalsCache } from "./client";
 import { attentionHeadless } from "./headless";
 import { AppsPane, HiringPane } from "./pane";
 import { COMPANY_ATTENTION_SERIES } from "./series";
 
 const definitions = [
-  { id: "hiring", prefix: "HIRE", label: "Hiring Momentum", component: HiringPane, description: "Pro hiring momentum: observed weekly open roles, additions, removals, role and location mix, peer comparisons and primary posting evidence.", keywords: ["hiring", "workforce", "roles", "recruitment", "surge", "freeze"] },
+  { id: "hiring", prefix: "HIRE", label: "Hiring Momentum", component: HiringPane, description: "Pro hiring momentum: observed weekly open roles, additions, removals, role and location mix, peer comparisons, hiring moves against each company's own weeks and peers, first roles in a new country or city, place and role-family spikes, and primary posting evidence.", keywords: ["hiring", "workforce", "roles", "recruitment", "surge", "freeze"] },
   { id: "apps", prefix: "APPS", label: "App Attention", component: AppsPane, description: "Pro app attention: public global app ranks, rank velocity, rating drift, company ownership and source evidence.", keywords: ["apps", "app attention", "mobile", "rank", "ratings", "developer"] },
 ] as const;
 const templates: PaneTemplateDef[] = definitions.map((def) => ({
@@ -22,11 +22,14 @@ export const companyAttentionModule: PluginModule = {
   series: COMPANY_ATTENTION_SERIES,
   setup(ctx) {
     attentionCache.attach(ctx.persistence);
+    movesCache.attach(ctx.persistence);
+    signalsCache.attach(ctx.persistence);
+    buildingCache.attach(ctx.persistence);
     appRankCache.attach(ctx.persistence);
     ctx.registerTickerResearchTab({ id: "hiring-momentum", name: "Hiring momentum", order: 38, component: HiringPane, instruments: ["equity"] });
     ctx.registerTickerResearchTab({ id: "app-attention", name: "Apps", order: 39, component: AppsPane, instruments: ["equity"] });
   },
-  dispose() { attentionCache.reset(); appRankCache.reset(); },
+  dispose() { attentionCache.reset(); movesCache.reset(); signalsCache.reset(); buildingCache.reset(); appRankCache.reset(); },
   panes: definitions.map((def) => ({ id: def.id, name: def.label, icon: def.prefix[0]!, component: def.component, defaultPosition: "right", defaultMode: "floating", defaultFloatingSize: { width: 130, height: 32 }, tickerFollower: true, instruments: ["equity"], tableExport: true, headless: attentionHeadless(def.id) })),
   paneTemplates: templates,
 };

package/src/plugins/builtin/company-attention/model.ts

@@ -5,6 +5,8 @@ import type { AppAttentionPayload, AppCompany } from "../../../api-client/app-at
 import { humanLabel } from "../shared/research-cells";
 import { formatNumber } from "../../../utils/format";
 import { countOf, freePreviewNote } from "../shared/free-preview";
+import { countryName, postingPlace, postingTitle } from "../shared/job-posting";
+import { formatShortDate } from "../../../utils/datetime-format";
 
 export type AttentionKind = "hiring" | "apps";
 export type AttentionTab = "table" | "chart" | "mix" | "peers" | "evidence";
@@ -14,9 +16,15 @@ export interface AttentionRow {
   symbol?: string;
   date?: string;
   url?: string | null;
-  details?: Array<{ label: string; value: string }>;
+  /** What the row's detail reads: facts in words, only those the row has (no dashes, ids, revisions or confidences). */
+  details?: AttentionFact[];
+  /** Links the detail offers by name (an ownership filing, a ratings page), never as a bare address. */
+  links?: Array<{ label: string; url: string }>;
+  /** A posting whose page the detail reads: its title, place, date, pay, hours and description. */
+  posting?: { ticker: string; externalId: string };
   app?: AppFocus;
 }
+interface AttentionFact { label: string; value: string }
 export interface AppFocus { store: "app-store" | "google-play"; appId: string; name: string; country: string; chart: "free" | "paid" | "grossing" | "unranked" }
 interface AttentionSection {
   columns: DataTableColumn[];
@@ -48,6 +56,17 @@ export function attentionTabs(kind: AttentionKind, symbol: string | null | undef
   return kind === "apps" || symbol ? ["table", "chart", "mix", "peers", "evidence"] : ["table"];
 }
 
+/**
+ * A pane tab: a report view, or HIRE's moves, expansion, anomalies and
+ * building, which have their own reads (moves-model.ts, signals-model.ts,
+ * building-model.ts).
+ */
+export type AttentionPaneTab = AttentionTab | "moves" | "expansion" | "anomalies" | "building";
+const HIRING_READ_TABS = ["moves", "expansion", "anomalies", "building"] as const;
+export function attentionPaneTabs(kind: AttentionKind, symbol: string | null | undefined): AttentionPaneTab[] {
+  return kind === "hiring" ? [...attentionTabs(kind, symbol), ...HIRING_READ_TABS] : attentionTabs(kind, symbol);
+}
+
 /**
  * A view's heading where the report prints it in full, as `fn HIRE` does:
  * what its rows are (Open roles, Hiring trend), where the pane's tab says it
@@ -81,7 +100,12 @@ export function remoteText(percentRemote: number | null | undefined, known: numb
   return `${formatNumber(percentRemote, 0)}% of ${known == null ? "" : `${formatNumber(known, 0)} `}known`;
 }
 const signed = (value: number | null | undefined, decimals = 0) => value == null ? "--" : `${value > 0 ? "+" : ""}${value.toLocaleString("en-US", { maximumFractionDigits: decimals })}`;
-const percent = (value: number | null | undefined) => value == null ? "--" : `${(value * 100).toFixed(1)}%`;
+/** A date in words ("Oct 22, 2026"), for a capture's ISO timestamp. */
+const day = (value: string | null | undefined) => value ? formatShortDate(value.slice(0, 10), { utc: true, fallback: "" }) || null : null;
+/** The facts that have a value, in order. */
+const facts = (entries: Array<[string, string | number | null | undefined]>): AttentionFact[] =>
+  entries.flatMap(([label, value]) => value == null || value === "" ? [] : [{ label, value: String(value) }]);
+const CAPTURES: Record<string, string> = { complete: "Complete", partial: "Partial", unknown: "Coverage not known" };
 const column = (id: string, label: string, width: number, numeric = false, flex = false): DataTableColumn => ({ id, label, width, align: numeric ? "right" : "left", ...(flex ? { flexGrow: 1 } : {}) });
 const roleFamily = (value: string | null) => value === "data_ai" || value === "data ai" ? "Data / AI" : value ? humanLabel(value) : null;
 const COMPANY_COLUMNS = [column("symbol", "Ticker", 12), column("name", "Company", 24, false, true), column("open", "Open roles", 12, true), column("net", "Net / week", 12, true), column("remote", "Remote %", 17, true), column("z", "Z-score", 10, true), column("signal", "Signal", 12), column("date", "As of", 12)];
@@ -140,7 +164,7 @@ export function hiringModel(data: HiringBoard | HiringPayload, mix = "functions"
   const history = detail?.series ?? [];
   const latest = detail?.latest;
   const mixKey = ["functions", "seniority", "countries", "locations", "signals"].includes(mix) ? mix as "functions" | "seniority" | "countries" | "locations" | "signals" : "functions";
-  const rows = mixKey === "signals" ? (detail?.signals ?? []).map((row, i): AttentionRow => ({ id: `${row.type}:${i}`, url: row.evidenceUrls[0], values: { label: row.label, count: row.value, share: row.confidence * 100, date: row.asOf.slice(0, 10) }, details: [{ label: "Observed", value: row.asOf }, { label: "Confidence", value: percent(row.confidence) }, { label: "Location", value: row.location ?? "--" }] }))
+  const rows = mixKey === "signals" ? (detail?.signals ?? []).map((row, i): AttentionRow => ({ id: `${row.type}:${i}`, url: row.evidenceUrls[0], values: { label: row.label, count: row.value, share: row.confidence * 100, date: row.asOf.slice(0, 10) }, details: facts([["As of", day(row.asOf)], ["Location", row.location]]) }))
     : (detail?.[mixKey] ?? []).map((row): AttentionRow => ({ id: row.id, values: { label: mixKey === "functions" ? roleFamily(row.label) : mixKey === "seniority" ? humanLabel(row.label) : row.label, count: row.count, share: row.share * 100 } }));
   const model: AttentionModel = {
     asOf: latest?.observedAt ?? data.generatedAt,
@@ -160,10 +184,11 @@ export function hiringModel(data: HiringBoard | HiringPayload, mix = "functions"
     ] : [],
     sections: {
       table: { columns: COMPANY_COLUMNS, rows: companies.map(companyRow), empty: "Hiring observations are not available yet." },
-      chart: { columns: HISTORY_COLUMNS, rows: [...history].reverse().map((row): AttentionRow => ({ id: row.week, date: row.week, values: { date: row.week, open: row.openCount, added: row.added, removed: row.removed, net: row.netChange, change: row.changePct, remote: row.remoteShare == null ? null : row.remoteShare * 100, remoteKnown: row.remoteKnown, coverage: row.completeness }, details: [{ label: "Observed", value: row.observedAt }, { label: "Confidence", value: percent(row.confidence) }, { label: "Capture", value: row.kind }, { label: "Evergreen roles", value: count(row.evergreenCount) }] })), empty: hiringHistoryLocked(data) ? "Weekly history is part of Gloom Pro." : "History is accumulating from the first capture.", ...(hiringHistoryLocked(data) ? { locked: true } : {}) },
+      chart: { columns: HISTORY_COLUMNS, rows: [...history].reverse().map((row): AttentionRow => ({ id: row.week, date: row.week, values: { date: row.week, open: row.openCount, added: row.added, removed: row.removed, net: row.netChange, change: row.changePct, remote: row.remoteShare == null ? null : row.remoteShare * 100, remoteKnown: row.remoteKnown, coverage: row.completeness }, details: facts([["Captured", day(row.observedAt)], ["Coverage", CAPTURES[row.completeness] ?? null], ["Open roles", count(row.openCount)], ["Standing roles", row.evergreenCount ? count(row.evergreenCount) : null]]) })), empty: hiringHistoryLocked(data) ? "Weekly history is part of Gloom Pro." : "History is accumulating from the first capture.", ...(hiringHistoryLocked(data) ? { locked: true } : {}) },
       mix: { columns: [column("label", mixKey === "signals" ? "Signal" : "Group", 28, false, true), column("count", mixKey === "signals" ? "Value" : "Roles", 12, true), column("share", mixKey === "signals" ? "Confidence %" : "Share %", mixKey === "signals" ? 14 : 30, true), ...(mixKey === "signals" ? [column("date", "Observed", 12)] : [])], rows, empty: "No classified observations for this group yet." },
       peers: { columns: COMPANY_COLUMNS, rows: (detail?.peers ?? []).map(companyRow), empty: "No comparable mapped peers yet." },
-      evidence: { columns: [column("title", "Role", 32, false, true), column("location", "Location", 24), column("function", "Function", 18), column("seniority", "Seniority", 13), column("date", "Observed", 12), column("confidence", "Confidence %", 13, true)], rows: (detail?.evidence ?? []).map((row): AttentionRow => ({ id: `${row.snapshotId}:${row.id}`, url: row.url ?? row.sourceUrl, values: { title: row.title, location: row.location, function: roleFamily(row.jobFunction), seniority: row.seniority ? humanLabel(row.seniority) : null, date: row.observedAt.slice(0, 10), confidence: row.confidence * 100 }, details: [{ label: "Posting title", value: row.title }, { label: "Location", value: row.location ?? "--" }, { label: "Country", value: row.country ?? "Unknown" }, { label: "Function", value: row.jobFunction ?? "Unclassified" }, { label: "Seniority", value: row.seniority ?? "Unclassified" }, { label: "Remote", value: row.remote === null ? "Unknown" : row.remote ? "Yes" : "No" }, { label: "Observed", value: row.observedAt }, { label: "Revision", value: String(row.revision) }, { label: "Confidence", value: percent(row.confidence) }, { label: "Reporting ticker", value: row.sourceTicker }] })), empty: "No primary posting evidence is available yet." },
+      evidence: { columns: [column("title", "Role", 32, false, true), column("location", "Location", 24), column("function", "Function", 18), column("seniority", "Seniority", 13), column("date", "Observed", 12), column("confidence", "Confidence %", 13, true)], rows: (detail?.evidence ?? []).map((row): AttentionRow => ({ id: `${row.snapshotId}:${row.id}`, url: row.url ?? row.sourceUrl, values: { title: postingTitle(row.title, row.id), location: row.location, function: roleFamily(row.jobFunction), seniority: row.seniority ? humanLabel(row.seniority) : null, date: row.observedAt.slice(0, 10), confidence: row.confidence * 100 }, details: facts([["Place", postingPlace(row)], ["Role family", roleFamily(row.jobFunction)], ["Seniority", row.seniority ? humanLabel(row.seniority) : null], ["Seen", day(row.observedAt)]]),
+        posting: { ticker: row.sourceTicker, externalId: row.id } })), empty: "No primary posting evidence is available yet." },
     },
     chart: { label: "Open roles", unit: "roles", points: history.map((point) => ({ date: point.week, value: point.openCount })), since: detail?.coverage.firstObservedAt ?? null },
   };
@@ -215,7 +240,8 @@ function appsUnmappedReason(data: AppAttentionPayload, filtered: boolean): strin
 /** `filtered`: a country or chart narrows the rows, so an empty table is about the filter, not the company. */
 export function appsModel(data: AppAttentionPayload, mix = "countries", filtered = false): AttentionModel {
   const unmapped = appsUnmappedReason(data, filtered);
-  const evidence = data.evidence.map((row): AttentionRow => ({ id: `${row.revisionId}:${row.appId}`, url: row.sourceUrl, values: { name: row.name, country: row.country, chart: row.chart, rank: row.rank, observed: row.observedAt.slice(0, 10), confidence: row.confidence * 100 }, details: [{ label: "App", value: row.name }, { label: "App ID", value: row.appId }, { label: "Country / chart", value: `${row.country} / ${row.chart}` }, { label: "Rank", value: count(row.rank) }, { label: "Rating", value: row.rating?.toFixed(2) ?? "--" }, { label: "Ratings", value: count(row.ratingCount) }, { label: "Written reviews", value: count(row.reviewCount) }, { label: "Observed", value: row.observedAt }, { label: "Published", value: row.sourceUpdatedAt ?? "Unavailable" }, { label: "Revision", value: row.revisionId }, { label: "Supersedes", value: row.supersedesRevisionId ?? "Initial capture" }, { label: "Mapping confidence", value: percent(row.confidence) }, ...(row.mappingSourceUrl ? [{ label: "Ownership evidence", value: row.mappingSourceUrl }] : []), ...(row.ratingSourceUrl ? [{ label: "Rating evidence", value: row.ratingSourceUrl }] : [])] }));
+  const evidence = data.evidence.map((row): AttentionRow => ({ id: `${row.revisionId}:${row.appId}`, url: row.sourceUrl, values: { name: row.name, country: row.country, chart: row.chart, rank: row.rank, observed: row.observedAt.slice(0, 10), confidence: row.confidence * 100 }, details: facts([["Chart", `${countryName(row.country) ?? row.country} · ${humanLabel(row.chart)}`], ["Rank", row.rank == null ? null : count(row.rank)], ["Rating", row.rating == null ? null : `${row.rating.toFixed(2)} / 5`], ["Ratings", row.ratingCount == null ? null : count(row.ratingCount)], ["Written reviews", row.reviewCount == null ? null : count(row.reviewCount)], ["Seen", day(row.observedAt)], ["Updated in store", day(row.sourceUpdatedAt)]]),
+    links: [...(row.mappingSourceUrl ? [{ label: "Ownership", url: row.mappingSourceUrl }] : []), ...(row.ratingSourceUrl ? [{ label: "Ratings", url: row.ratingSourceUrl }] : [])] }));
   return {
     asOf: data.summary.lastObservedAt,
     preview: data.access === "preview",
@@ -232,7 +258,7 @@ export function appsModel(data: AppAttentionPayload, mix = "countries", filtered
       ...(data.summary.ratingCountGrowth7d != null ? [{ label: "Ratings added", value: signed(data.summary.ratingCountGrowth7d), detail: "7D" }] : []),
     ],
     sections: {
-      table: { columns: APP_COLUMNS, rows: data.apps.map((row): AttentionRow => ({ id: `${row.sourceId}:${row.appId}`, app: { store: row.store, appId: row.appId, name: row.name, country: row.country, chart: row.chart }, symbol: row.symbol ?? undefined, url: row.appUrl, values: { name: row.name, symbol: row.symbol, country: row.country, chart: row.chart, rank: row.rank, change: row.rankChange7d, rating: row.rating, ratings: row.ratingCount, drift: row.ratingChange7d, growth: row.ratingCountGrowth7d }, details: [{ label: "App", value: row.name }, { label: "Developer", value: row.developer }, { label: "Parent ticker", value: row.symbol ?? "Unmapped" }, { label: "Genres", value: row.genres.join(", ") || "--" }, { label: "Observed", value: row.observedAt }, { label: "Ratings observed", value: row.ratingObservedAt ?? "Unavailable" }, { label: "Mapping confidence", value: percent(row.confidence) }, { label: "Mapping revision", value: row.mappingRevisionId ?? "Unmapped" }, { label: "Capture revision", value: row.revisionId }] })), empty: unmapped ?? "No app observations match these filters yet." },
+      table: { columns: APP_COLUMNS, rows: data.apps.map((row): AttentionRow => ({ id: `${row.sourceId}:${row.appId}`, app: { store: row.store, appId: row.appId, name: row.name, country: row.country, chart: row.chart }, symbol: row.symbol ?? undefined, url: row.appUrl, values: { name: row.name, symbol: row.symbol, country: row.country, chart: row.chart, rank: row.rank, change: row.rankChange7d, rating: row.rating, ratings: row.ratingCount, drift: row.ratingChange7d, growth: row.ratingCountGrowth7d }, details: facts([["Developer", row.developer], ["Company", row.symbol], ["Genres", row.genres.join(", ")], ["Seen", day(row.observedAt)], ["Ratings seen", day(row.ratingObservedAt)]]) })), empty: unmapped ?? "No app observations match these filters yet." },
       chart: { columns: [column("date", "Date", 12), column("score", "Score / 100", 14, true), column("change", "Change", 10, true), column("apps", "Apps", 9, true), column("countries", "Countries", 12, true), column("rating", "Rating / 5", 12, true), column("ratings", "Ratings", 13, true)], rows: data.history.map((point, i, all): AttentionRow => ({ id: point.date, date: point.date, values: { date: point.date, score: point.attentionScore, change: point.attentionScore != null && all[i - 1]?.attentionScore != null ? point.attentionScore - all[i - 1]!.attentionScore! : null, apps: point.appCount, countries: point.countryCount, rating: point.rating, ratings: point.ratingCount } })).reverse(), empty: data.access === "preview" && data.locked.history > 0 ? "Daily history is part of Gloom Pro." : "History is accumulating from the first capture.", ...(data.access === "preview" && data.locked.history > 0 ? { locked: true } : {}) },
       mix: mix === "spreads" ? { columns: [column("name", "App", 28, false, true), column("chart", "Chart", 10), column("best", "Best country", 15), column("bestRank", "Best rank", 11, true), column("worst", "Worst country", 15), column("worstRank", "Worst rank", 12, true), column("spread", "Rank spread", 13, true)], rows: data.spreads.map((row): AttentionRow => ({ id: `${row.appId}:${row.chart}:${row.category}`, values: { name: row.name, chart: row.chart, best: row.bestCountry, bestRank: row.bestRank, worst: row.worstCountry, worstRank: row.worstRank, spread: row.spread } })), empty: "Comparable country observations are accumulating." }
         : { columns: [column("country", "Country", 16, false, true), column("apps", "Apps", 9, true), column("ranked", "Ranked apps", 13, true), column("score", "Score / 100", 14, true), column("velocity", "Places / day", 15, true), column("date", "Observed", 12)], rows: data.countries.map((row): AttentionRow => ({ id: row.country, values: { country: row.country, apps: row.appCount, ranked: row.rankedApps, score: row.attentionScore, velocity: row.rankVelocity7d, date: row.observedAt.slice(0, 10) } })), empty: "Country observations are not available yet." },