peopleanalyst

Platform · Shipped

Role Reality Gap — canon-vs-market model distance per occupation

For one occupation, the distance between the field's book-canon competency model (bicycle-guide guide model.nodes) and the O*NET market model — 'what this role is FOR' vs 'what the market rewards'. Each canon construct gets a present/partial/absent verdict from a multi-model ensemble, reported WITH Krippendorff's alpha and withheld where the raters disagree; evidence quotes the O*NET side verbatim and ungrounded quotes are dropped before aggregation.

Cluster
Platform
Type
algo
Status
Shipped
Used by
peopleanalyst-site, performix, people-analytics-toolbox

Maturity evidence

Functioning
Prove-one shipped 2026-07-20 for compensation x SOC 13-1141.00: 3-model ensemble, alpha=0.754 (tentative), 0/13 verdicts withheld, 1 ungrounded judgment dropped by the verbatim gate.
Valuable
Reproduces the hand-authored human reference (pa-site lib/gap-mapping.ts) on 11 of 13 constructs (85%) while attaching a measured reliability the hand-authored version could not.
Understood
docs/jobframe/ROLE-REALITY-GAP.md; 12 tests pin the honesty gates (withhold on low agreement, no evidence on withheld verdicts, withheld never folded into absent).
Integrated
REST + MCP live and on the capability feed. Rendering on public JobFrame job profiles and re-pointing pa-site /the-gap at this field are the remaining steps (PAT-JFE-GAP-2); coverage is one occupation until the fan-out runs.

How to use it

REST
GET /api/spokes/job-family-agent/role-reality-gap?domain=&soc=
MCP
job-family-agent.role-reality-gap
CLI
npx tsx scripts/build-role-reality-gap.ts --domain <d> --soc <soc> [--commit]
Data
src/spokes/job-family-agent/data/role-reality-gap.json

Other Platform capabilities

← Every platform capability

Capability detail sourced from the People Analytics Toolbox capability feed (source of truth), snapshot retrieved 2026-07-23.