data-analyst-mcp 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. package/README.md +262 -262
  2. package/dist/report/method_audit.js +7 -1
  3. package/dist/report/method_audit.js.map +1 -1
  4. package/dist/report/scan_secrets.d.ts +4 -1
  5. package/dist/report/scan_secrets.js +36 -5
  6. package/dist/report/scan_secrets.js.map +1 -1
  7. package/dist/server.d.ts +1 -1
  8. package/dist/server.js +3 -2
  9. package/dist/server.js.map +1 -1
  10. package/guide/WORKFLOW.md +134 -134
  11. package/guide/assets/disclaimer.txt +1 -1
  12. package/guide/assets/download_data.ps1 +162 -162
  13. package/guide/assets/report_template.html +597 -597
  14. package/guide/references/routing.md +171 -171
  15. package/guide/references/style_guide.md +398 -398
  16. package/package.json +56 -56
  17. package/packs/acf/endpoints.json +114 -114
  18. package/packs/acf/policy.json +104 -104
  19. package/packs/actuaries/endpoints.json +82 -82
  20. package/packs/actuaries/policy.json +109 -109
  21. package/packs/bea/assets/download_bea.ps1 +182 -182
  22. package/packs/bea/docs/bea_api.md +461 -461
  23. package/packs/bea/docs/datasets.md +157 -157
  24. package/packs/bea/docs/report_patterns.md +112 -112
  25. package/packs/bea/policy.json +170 -170
  26. package/packs/bea/source.md +152 -152
  27. package/packs/bls/assets/download_bls.ps1 +152 -152
  28. package/packs/bls/docs/analysis_patterns.md +108 -108
  29. package/packs/bls/docs/bls_api.md +73 -73
  30. package/packs/bls/docs/series_ids.md +149 -149
  31. package/packs/bls/policy.json +238 -238
  32. package/packs/bts/endpoints.json +346 -346
  33. package/packs/bts/policy.json +94 -94
  34. package/packs/cdc/endpoints.json +197 -197
  35. package/packs/cdc/policy.json +83 -83
  36. package/packs/census/endpoints.json +99 -99
  37. package/packs/cfpb/endpoints.json +326 -326
  38. package/packs/cfpb/policy.json +119 -119
  39. package/packs/clinical-trials/endpoints.json +166 -166
  40. package/packs/clinical-trials/policy.json +84 -84
  41. package/packs/cms/endpoints.json +69 -69
  42. package/packs/cms/policy.json +96 -96
  43. package/packs/college-scorecard/endpoints.json +252 -252
  44. package/packs/college-scorecard/policy.json +106 -106
  45. package/packs/congress/endpoints.json +1701 -1701
  46. package/packs/congress/policy.json +117 -117
  47. package/packs/dhs-ohss/endpoints.json +66 -66
  48. package/packs/dhs-ohss/policy.json +107 -107
  49. package/packs/doj-news/endpoints.json +59 -59
  50. package/packs/doj-news/policy.json +96 -96
  51. package/packs/dol/endpoints.json +817 -817
  52. package/packs/dol/policy.json +135 -135
  53. package/packs/eia/endpoints.json +717 -717
  54. package/packs/eia/policy.json +112 -112
  55. package/packs/epa/endpoints.json +291 -291
  56. package/packs/epa/policy.json +99 -99
  57. package/packs/epa-aqs/endpoints.json +173 -173
  58. package/packs/epa-aqs/policy.json +96 -96
  59. package/packs/fbi/endpoints.json +1841 -1841
  60. package/packs/fbi/policy.json +118 -118
  61. package/packs/fda/endpoints.json +237 -237
  62. package/packs/fda/policy.json +121 -121
  63. package/packs/fdic/endpoints.json +416 -416
  64. package/packs/fdic/policy.json +83 -83
  65. package/packs/fec/endpoints.json +707 -707
  66. package/packs/fec/policy.json +93 -93
  67. package/packs/fed-board/endpoints.json +89 -89
  68. package/packs/fed-board/policy.json +136 -136
  69. package/packs/federal-register/endpoints.json +143 -143
  70. package/packs/federal-register/policy.json +86 -86
  71. package/packs/fema/endpoints.json +645 -645
  72. package/packs/fema/policy.json +103 -103
  73. package/packs/fhfa/endpoints.json +105 -105
  74. package/packs/fhfa/policy.json +109 -109
  75. package/packs/fred/assets/download_fred.ps1 +122 -122
  76. package/packs/fred/docs/analysis_patterns.md +124 -124
  77. package/packs/fred/docs/fred_api.md +94 -94
  78. package/packs/fred/docs/series.md +188 -188
  79. package/packs/fred/policy.json +253 -253
  80. package/packs/fsa/endpoints.json +150 -150
  81. package/packs/fsa/policy.json +99 -99
  82. package/packs/govinfo/endpoints.json +519 -519
  83. package/packs/gsa-calc/endpoints.json +93 -93
  84. package/packs/gsa-calc/policy.json +97 -97
  85. package/packs/hud/endpoints.json +146 -146
  86. package/packs/hud/policy.json +84 -84
  87. package/packs/ipums/docs/report_patterns.md +117 -117
  88. package/packs/irs-soi/endpoints.json +114 -114
  89. package/packs/irs-soi/policy.json +107 -107
  90. package/packs/medicaid/endpoints.json +412 -412
  91. package/packs/medicaid/policy.json +108 -108
  92. package/packs/naep/endpoints.json +217 -217
  93. package/packs/naep/policy.json +100 -100
  94. package/packs/nhtsa/endpoints.json +132 -132
  95. package/packs/nhtsa/policy.json +93 -93
  96. package/packs/nih/endpoints.json +452 -452
  97. package/packs/nih/policy.json +86 -86
  98. package/packs/noaa/endpoints.json +431 -431
  99. package/packs/noaa/policy.json +95 -95
  100. package/packs/nrel/endpoints.json +327 -327
  101. package/packs/nrel/policy.json +96 -96
  102. package/packs/nws/endpoints.json +271 -271
  103. package/packs/nws/policy.json +82 -82
  104. package/packs/nyfed/endpoints.json +80 -80
  105. package/packs/nyfed/policy.json +92 -92
  106. package/packs/omb/endpoints.json +460 -460
  107. package/packs/omb/policy.json +106 -106
  108. package/packs/open-payments/endpoints.json +297 -297
  109. package/packs/open-payments/policy.json +101 -101
  110. package/packs/opm/assets/download_opm.ps1 +125 -125
  111. package/packs/opm/docs/fields.md +184 -184
  112. package/packs/opm/docs/opm_api.md +71 -71
  113. package/packs/opm/docs/report_patterns.md +83 -83
  114. package/packs/opm/lib/data_dictionary.csv +73 -73
  115. package/packs/pbgc/endpoints.json +483 -483
  116. package/packs/pbgc/policy.json +94 -94
  117. package/packs/philfed/endpoints.json +85 -85
  118. package/packs/philfed/policy.json +94 -94
  119. package/packs/regulations/endpoints.json +287 -287
  120. package/packs/regulations/policy.json +86 -86
  121. package/packs/sec/endpoints.json +236 -236
  122. package/packs/sec/policy.json +86 -86
  123. package/packs/senate-lobbying/endpoints.json +553 -553
  124. package/packs/senate-lobbying/policy.json +99 -99
  125. package/packs/snapqc/endpoints.json +1426 -1426
  126. package/packs/snapqc/policy.json +92 -92
  127. package/packs/treasury/catalog.json +2267 -2267
  128. package/packs/treasury/docs/api_guide.md +245 -245
  129. package/packs/treasury/docs/datasets.md +56 -56
  130. package/packs/treasury/docs/report_patterns.md +126 -126
  131. package/packs/treasury/policy.json +159 -159
  132. package/packs/treasury/source.md +170 -165
  133. package/packs/treasury-yields/endpoints.json +226 -226
  134. package/packs/treasury-yields/policy.json +86 -86
  135. package/packs/usaspending/endpoints.json +1315 -1315
  136. package/packs/usaspending/policy.json +109 -109
  137. package/packs/usda-fna/policy.json +133 -133
  138. package/packs/usda-fooddata/endpoints.json +180 -180
  139. package/packs/usda-fooddata/policy.json +94 -94
  140. package/packs/usda-nass/endpoints.json +323 -323
  141. package/packs/usda-nass/policy.json +95 -95
  142. package/packs/usda-outlook/endpoints.json +86 -86
  143. package/packs/usda-outlook/policy.json +109 -109
  144. package/packs/usgs/endpoints.json +313 -313
  145. package/packs/usgs/policy.json +95 -95
  146. package/packs/usitc/endpoints.json +74 -74
  147. package/packs/usitc/policy.json +111 -111
  148. package/packs/uspto/endpoints.json +141 -141
  149. package/packs/uspto/policy.json +95 -95
  150. package/packs/va/endpoints.json +414 -414
  151. package/packs/va/policy.json +101 -101
  152. package/packs/world-bank/endpoints.json +122 -122
  153. package/packs/world-bank/policy.json +101 -101
@@ -1,83 +1,83 @@
1
- # Report patterns for federal workforce data products
2
-
3
- Use this file to shape both the analysis and the report. The aim is a product a careful reviewer
4
- (OPM, CRS, GAO, the Partnership for Public Service) would recognize: a precisely stated universe and
5
- counting basis, numbered exhibits with notes and source lines, data shipped with the report, and the
6
- limits of the public files stated plainly.
7
-
8
- ## Typical questions and how they are framed
9
- These recur in published work, so there is usually a precedent to follow and a number to benchmark.
10
- - **Size of the federal workforce** (status, September snapshots): total and by department or agency,
11
- over 5 to 20 years; permanent (`nsftp_indicator`) vs. all; full-time vs. other schedules. Headline
12
- style: "In September 2025, 2.2 million civilian employees worked for executive branch agencies covered
13
- by OPM's data, about X percent fewer than a year earlier." Always say what EHRI excludes (USPS, the
14
- intelligence community) because readers compare with "3 million federal workers" figures.
15
- - **Workforce changes, 2025 onward** (separations and accessions): separations by type (quits,
16
- retirements, RIFs, Deferred Resignation Program), hiring, net change by agency; rates per 100
17
- employees. Separate the deferred resignation wave (`drp_indicator`; most effective in September 2025) from
18
- normal attrition, and transfers between agencies from exits from government.
19
- - **Retirement wave / aging:** age-bracket composition, share 55+ or 60+, length of service, the
20
- retirement-eligible proxy (fields.md §4), by agency or occupation; retirement separation rates.
21
- - **Occupations and skills:** IT (2210), cybersecurity proxies, STEM and health shares, mission-critical
22
- series (e.g. 0602 physicians, 0610 nurses, 1811 criminal investigators — redacted pay!), supervisory
23
- ratios (supervisors per employee).
24
- - **Pay:** median and distribution by grade, pay plan, occupation or agency; GS grade structure; growth
25
- in nominal and real terms (deflate with CPI-U or the ECI and cite it). Always quote redaction coverage
26
- and avoid governmentwide pay averages.
27
- - **Location:** employees by state or metro area, Washington-area share. Redaction removes DoD and
28
- security staff, so present location only for the covered part, or by department excluding DoD, and say so.
29
- - **Veterans, education, probationary employees** (tenure group 2), **bargaining unit coverage**.
30
-
31
- ## Benchmarks (compute the same definition and compare)
32
- - FWD dashboards ("Workforce Size & Composition", "Workforce Changes", "Compensation") for the same month.
33
- - OPM's earlier FedScope tables and "Sizing Up the Executive Branch" reports (September snapshots).
34
- - Congressional Research Service reports on the size of the federal workforce; GAO reports on agency
35
- workforce planning, retirements and the 2025 workforce reductions; Partnership for Public Service "Fed
36
- Figures". BLS Current Employment Statistics "federal government" employment includes USPS, so expect
37
- a gap of roughly 600,000 and explain it.
38
- - OPM's subject reports (veterans employment, ...) can count only employees in pay status, fewer than the
39
- snapshot's on-board total: the FY2024 veterans report gives 27.4 percent in Table 1 (in pay status) and
40
- 27.8 percent in Table 6 (on board, as the FWD files give it). Match the table to the universe you use.
41
- Search with WebSearch, read the page, and cite it (`references` in report.json). Never cite from memory.
42
-
43
- ## Conventions to follow
44
- **Population and definitions**
45
- - State the universe: executive-branch civilian employees covered by EHRI; which snapshot month; all
46
- vs. permanent (NSFTP) vs. full-time; any agency exclusions you made.
47
- - State the counting basis for actions (effective month or processing month) and the period (fiscal or
48
- calendar year).
49
- - Rates use average headcount over the period as the denominator; say "per 100 employees" or "percent".
50
- - Group by codes; show the latest name.
51
-
52
- **Precision and suppression**
53
- - Counts: round to the nearest hundred or thousand in prose ("about 447,200"), exact in tables. A
54
- rounded number is its own fact: register it with `facts` and a rounding format (`num:-2` hundreds,
55
- `num:-3` thousands) so the answer gate finds it.
56
- - Flag rates and pay statistics for groups with fewer than 30 records and avoid publishing
57
- pay for very small groups (individuals could be identified).
58
- - No sampling error: do not write "statistically significant". Describe differences as differences in
59
- the records, and discuss data-quality limits (redaction, late reports, missing submissions) instead.
60
-
61
- **Publication structure (mirrored in `build_report`, `"mode": "report"`)**
62
- The default layout, the **exhibit chartbook**, runs in this order:
63
- 1. **Cover:** "Month Year", the title (with the period for trend reports), and a hero chart.
64
- 2. **At a Glance** (one page, about 300-420 words): a framing paragraph (what was examined, the
65
- universe, the period) and 3-5 bullets with a **bold lead phrase.** naming a section and the key numbers.
66
- 3. **Contents** and **List of Exhibits** (built automatically).
67
- 4. **Notes About This Report:** calendar vs. fiscal years; rounding; data source and universe (with the
68
- EHRI exclusions); the snapshot month; the counting basis for actions; redaction of pay and location;
69
- key definitions; a pointer to Appendix A.
70
- 5. **Introduction:** a lead paragraph with the headline numbers; question-style subheadings, one per
71
- section; "What Data Were Used?"; "How Do These Figures Compare With Other Counts?" when relevant.
72
- 6. **Thematic sections** (2-5): a summary page, then one exhibit per page with 2-4 paragraphs beside it.
73
- 7. **Appendix A: Data and Methods:** files and versions (the manifest), universe, definitions, counting
74
- basis, redaction coverage table, late-reporting check, benchmark comparison, limitations (§1 of
75
- fields.md: what the public files cannot show).
76
- 8. **About This Document** (optional).
77
-
78
- **Chart forms**
79
- - Trends: line charts, at most 4-5 series (facet or pick the largest agencies plus "all other").
80
- - Agencies or occupations at one point in time: horizontal bars, sorted.
81
- - Composition (age brackets, separation types): stacked bars.
82
- - Monthly actions around an event (e.g. September 2025): columns by month, with the event noted.
83
- - No dual axes, pie charts or 3-D.
1
+ # Report patterns for federal workforce data products
2
+
3
+ Use this file to shape both the analysis and the report. The aim is a product a careful reviewer
4
+ (OPM, CRS, GAO, the Partnership for Public Service) would recognize: a precisely stated universe and
5
+ counting basis, numbered exhibits with notes and source lines, data shipped with the report, and the
6
+ limits of the public files stated plainly.
7
+
8
+ ## Typical questions and how they are framed
9
+ These recur in published work, so there is usually a precedent to follow and a number to benchmark.
10
+ - **Size of the federal workforce** (status, September snapshots): total and by department or agency,
11
+ over 5 to 20 years; permanent (`nsftp_indicator`) vs. all; full-time vs. other schedules. Headline
12
+ style: "In September 2025, 2.2 million civilian employees worked for executive branch agencies covered
13
+ by OPM's data, about X percent fewer than a year earlier." Always say what EHRI excludes (USPS, the
14
+ intelligence community) because readers compare with "3 million federal workers" figures.
15
+ - **Workforce changes, 2025 onward** (separations and accessions): separations by type (quits,
16
+ retirements, RIFs, Deferred Resignation Program), hiring, net change by agency; rates per 100
17
+ employees. Separate the deferred resignation wave (`drp_indicator`; most effective in September 2025) from
18
+ normal attrition, and transfers between agencies from exits from government.
19
+ - **Retirement wave / aging:** age-bracket composition, share 55+ or 60+, length of service, the
20
+ retirement-eligible proxy (fields.md §4), by agency or occupation; retirement separation rates.
21
+ - **Occupations and skills:** IT (2210), cybersecurity proxies, STEM and health shares, mission-critical
22
+ series (e.g. 0602 physicians, 0610 nurses, 1811 criminal investigators — redacted pay!), supervisory
23
+ ratios (supervisors per employee).
24
+ - **Pay:** median and distribution by grade, pay plan, occupation or agency; GS grade structure; growth
25
+ in nominal and real terms (deflate with CPI-U or the ECI and cite it). Always quote redaction coverage
26
+ and avoid governmentwide pay averages.
27
+ - **Location:** employees by state or metro area, Washington-area share. Redaction removes DoD and
28
+ security staff, so present location only for the covered part, or by department excluding DoD, and say so.
29
+ - **Veterans, education, probationary employees** (tenure group 2), **bargaining unit coverage**.
30
+
31
+ ## Benchmarks (compute the same definition and compare)
32
+ - FWD dashboards ("Workforce Size & Composition", "Workforce Changes", "Compensation") for the same month.
33
+ - OPM's earlier FedScope tables and "Sizing Up the Executive Branch" reports (September snapshots).
34
+ - Congressional Research Service reports on the size of the federal workforce; GAO reports on agency
35
+ workforce planning, retirements and the 2025 workforce reductions; Partnership for Public Service "Fed
36
+ Figures". BLS Current Employment Statistics "federal government" employment includes USPS, so expect
37
+ a gap of roughly 600,000 and explain it.
38
+ - OPM's subject reports (veterans employment, ...) can count only employees in pay status, fewer than the
39
+ snapshot's on-board total: the FY2024 veterans report gives 27.4 percent in Table 1 (in pay status) and
40
+ 27.8 percent in Table 6 (on board, as the FWD files give it). Match the table to the universe you use.
41
+ Search with WebSearch, read the page, and cite it (`references` in report.json). Never cite from memory.
42
+
43
+ ## Conventions to follow
44
+ **Population and definitions**
45
+ - State the universe: executive-branch civilian employees covered by EHRI; which snapshot month; all
46
+ vs. permanent (NSFTP) vs. full-time; any agency exclusions you made.
47
+ - State the counting basis for actions (effective month or processing month) and the period (fiscal or
48
+ calendar year).
49
+ - Rates use average headcount over the period as the denominator; say "per 100 employees" or "percent".
50
+ - Group by codes; show the latest name.
51
+
52
+ **Precision and suppression**
53
+ - Counts: round to the nearest hundred or thousand in prose ("about 447,200"), exact in tables. A
54
+ rounded number is its own fact: register it with `facts` and a rounding format (`num:-2` hundreds,
55
+ `num:-3` thousands) so the answer gate finds it.
56
+ - Flag rates and pay statistics for groups with fewer than 30 records and avoid publishing
57
+ pay for very small groups (individuals could be identified).
58
+ - No sampling error: do not write "statistically significant". Describe differences as differences in
59
+ the records, and discuss data-quality limits (redaction, late reports, missing submissions) instead.
60
+
61
+ **Publication structure (mirrored in `build_report`, `"mode": "report"`)**
62
+ The default layout, the **exhibit chartbook**, runs in this order:
63
+ 1. **Cover:** "Month Year", the title (with the period for trend reports), and a hero chart.
64
+ 2. **At a Glance** (one page, about 300-420 words): a framing paragraph (what was examined, the
65
+ universe, the period) and 3-5 bullets with a **bold lead phrase.** naming a section and the key numbers.
66
+ 3. **Contents** and **List of Exhibits** (built automatically).
67
+ 4. **Notes About This Report:** calendar vs. fiscal years; rounding; data source and universe (with the
68
+ EHRI exclusions); the snapshot month; the counting basis for actions; redaction of pay and location;
69
+ key definitions; a pointer to Appendix A.
70
+ 5. **Introduction:** a lead paragraph with the headline numbers; question-style subheadings, one per
71
+ section; "What Data Were Used?"; "How Do These Figures Compare With Other Counts?" when relevant.
72
+ 6. **Thematic sections** (2-5): a summary page, then one exhibit per page with 2-4 paragraphs beside it.
73
+ 7. **Appendix A: Data and Methods:** files and versions (the manifest), universe, definitions, counting
74
+ basis, redaction coverage table, late-reporting check, benchmark comparison, limitations (§1 of
75
+ fields.md: what the public files cannot show).
76
+ 8. **About This Document** (optional).
77
+
78
+ **Chart forms**
79
+ - Trends: line charts, at most 4-5 series (facet or pick the largest agencies plus "all other").
80
+ - Agencies or occupations at one point in time: horizontal bars, sorted.
81
+ - Composition (age brackets, separation types): stacked bars.
82
+ - Monthly actions around an event (e.g. September 2025): columns by month, with the event noted.
83
+ - No dual axes, pie charts or 3-D.
@@ -1,73 +1,73 @@
1
- field,definition,sample_value,employment,accessions,separations
2
- accession_category,The text description of the personnel action that resulted in the onboarding of a new employee.,NEW HIRE - COMPETITIVE SERVICE APPOINTMENT,,Y,
3
- accession_category_code,The code representing the personnel action that resulted in the onboarding of a new employee.,AC,,Y,
4
- age_bracket,The range that a given employee's age falls into.,45-49,Y,Y,Y
5
- agency,The text description of a high-level employing organization.,DEPARTMENT OF INTERIOR,Y,Y,Y
6
- agency_code,The code representing a high-level employing organization.,IN,Y,Y,Y
7
- agency_subelement,The text description of an administrative subdivision of the agency.,BUREAU OF LAND MANAGEMENT,Y,Y,Y
8
- agency_subelement_code,The code representing an administrative subdivision of the agency.,IN05,Y,Y,Y
9
- annualized_adjusted_basic_pay,"The sum of an employee's rate of basic pay and any basic pay supplement (standard OR special), after applying any applicable pay cap, on an annualized basis.",35729.44,Y,Y,Y
10
- appointment_not_to_exceed_date,End date of the employee's temporary not-to-exceed appointment.,2019-03-16 00:00:00,,Y,Y
11
- appointment_type,The text description of the type of appointment an employee is serving under in terms of permanence and competitiveness.,CAREER (COMPETITIVE SERVICE PERMANENT),Y,Y,Y
12
- appointment_type_code,The code representing the type of appointment an employee is serving under in terms of permanence and competitiveness.,10,Y,Y,Y
13
- bargaining_unit,The text description of the bargaining unit within the labor union representing the employee.,"NTEU/- INTERNAL REVENUE SERVICE; WASHINGTON, DC",Y,Y,Y
14
- bargaining_unit_code,The code representing the bargaining unit within the labor union representing the employee.,1724,Y,Y,Y
15
- bargaining_unit_status,The text description of the employee's eligibility to be represented by a labor union within the federal government.,ELIGIBLE_IN_BU,Y,Y,Y
16
- cfo_act_agency_indicator,Identifies whether the agency is subject to the CFO Act.,CFO ACT AGENCY,Y,Y,Y
17
- consolidated_statistical_area,The text description of a U.S. Office of Management and Budget defined entity containing two or more adjacent core based statistical areas.,"BOSTON-WORCESTER-PROVIDENCE, MA-RI-NH",Y,Y,Y
18
- consolidated_statistical_area_code,The code representing a U.S. Office of Management and Budget defined entity containing two or more adjacent core based statistical areas.,148,Y,Y,Y
19
- core_based_statistical_area,"The text description of a geographic entity associated with at least one core of 10,000 or more population, plus adjacent territory that has a high degree of social and economic integration with the core as measured by commuting ties.","CHICO, CA METROPOLITAN STATISTICAL AREA",Y,Y,Y
20
- core_based_statistical_area_code,"The code representing a geographic entity associated with at least one core of 10,000 or more population, plus adjacent territory that has a high degree of social and economic integration with the core as measured by commuting ties.",17020,Y,Y,Y
21
- count,"The integer value 1, used for counting or aggregating values over the data set.",1,Y,Y,Y
22
- department,"Name of the department of the employee, aiding in the classification of roles within the organization.",DEPARTMENT OF AGRICULTURE,Y,Y,Y
23
- department_code,"Code representing the department to which the employee belongs, important for organizational structure.",AG,Y,Y,Y
24
- drp_indicator,Identifies whether a separation took place under the deferred resignation program.,N,,,Y
25
- duty_station_city,The text description of the city of an employee's official worksite.,BLOOMINGTON,Y,Y,Y
26
- duty_station_code,The code representing an employee's official worksite.,270675053,Y,Y,Y
27
- duty_station_country,The text description of the country of an employee's official worksite.,UNITED STATES,Y,Y,Y
28
- duty_station_country_code,The code representing the country of an employee's official worksite.,US,Y,Y,Y
29
- duty_station_county,The text description of the county of an employee's official worksite.,HENNEPIN,Y,Y,Y
30
- duty_station_county_code,The code representing the county of an employee's official worksite.,53,Y,Y,Y
31
- duty_station_state,The text description of the state of an employee's official worksite.,MINNESOTA,Y,Y,Y
32
- duty_station_state_abbreviation,The text abbreviation of the state of an employee's official worksite.,MN,Y,Y,Y
33
- duty_station_state_country_territory_code,"The code representing the state, country, or territory, as appropriate, of an employee's official worksite.",27,Y,Y,Y
34
- education_level,The text description of the highest level of an employee's educational attainment from an accredited institution.,MASTER'S DEGREE,Y,Y,Y
35
- education_level_bracket,The text description of the simplified category for the highest level of education attained by the employee.,MASTERS OR PROFESSIONAL DEGREE,Y,Y,Y
36
- education_level_code,The code representing the highest level of an employee's educational attainment from an accredited institution.,17,Y,Y,Y
37
- flsa_category,"The text description of the status of a Federal civilian employee under the authority of Section 13 of the Fair Labor Standards Act (29 U.S.C. 213), as amended.",EXEMPT EMPLOYEE,Y,Y,Y
38
- flsa_category_code,"The code representing the status of a Federal civilian employee under the authority of Section 13 of the Fair Labor Standards Act (29 U.S.C. 213), as amended.",E,Y,Y,Y
39
- grade,An indicator of hierarchical relationships among positions covered by the same pay plan or system.,08,Y,Y,Y
40
- length_of_service_years,"The number of years of Federal civilian employment, creditable military service, and other service made creditable by specific legislation.",15.5,Y,Y,Y
41
- locality_pay_area,The text description of a specific geographic region used to determine pay adjustments for federal employees based on local non-federal salary rates.,"AUSTIN-ROUND ROCK, TX",Y,Y,Y
42
- locality_pay_area_code,The code representing a specific geographic region used to determine pay adjustments for federal employees based on local non-federal salary rates.,AU,Y,Y,Y
43
- nsftp_indicator,"Identifies whether an employee is a non-seasonal, full time, permanent employee.",Y,Y,Y,Y
44
- occupational_category,"The text description of the highest-level grouping of occupational series into Professional, Administrative, Technical, Clerical, Other White Collar and Blue Collar categories.",PROFESSIONAL,Y,Y,Y
45
- occupational_category_code,"The code representing the highest-level grouping of occupational series into Professional, Administrative, Technical, Clerical, Other White Collar and Blue Collar categories.",P,Y,Y,Y
46
- occupational_group,The text description of a grouping of similar occupational series.,INFORMATION TECHNOLOGY GROUP,Y,Y,Y
47
- occupational_group_code,The code representing a grouping of similar occupational series.,22,Y,Y,Y
48
- occupational_series,The text description of the job category that an employee's position falls under based on the duties and required qualifications of the position.,INFORMATION TECHNOLOGY MANAGEMENT,Y,Y,Y
49
- occupational_series_code,The code representing the job category that an employee's position falls under based on the duties and required qualifications of the position.,2210,Y,Y,Y
50
- pathways_group,"Classification for employees within the pathways programs, which helps in the development of skills and experience.",RECENT GRAD,Y,Y,Y
51
- pay_basis,"The text description of the principal condition in terms of time, production, or other criteria that, along with salary rate, determines the compensation paid to an employee.",PER ANNUM,Y,Y,Y
52
- pay_basis_code,"The code representing the principal condition in terms of time, production, or other criteria that, along with salary rate, determines the compensation paid to an employee.",PA,Y,Y,Y
53
- pay_plan,The text description of a particular table or array of pay rates prescribed by law or other authoritative source that establishes the basic pay rates for certain employees.,GENERAL SCHEDULE,Y,Y,Y
54
- pay_plan_code,The code representing a particular table or array of pay rates prescribed by law or other authoritative source that establishes the basic pay rates for certain employees.,GS,Y,Y,Y
55
- personnel_action_effective_date_yyyymm,The date on which an accession or separation action became effective.,202108,,Y,Y
56
- personnel_office_identifier_code,"The identification of the Federal civilian personnel office authorized to appoint and separate an employee, and to the extent such functions have been delegated, prepare personnel actions, maintain official personnel records, and administer programs for staff compensation, training and development, benefits and awards, and employee and labor relations.",1559,Y,Y,Y
57
- position_occupied,"The text description of an employee's position in the Competitive Service, Excepted Service, or the Senior Executive Service.",COMPETITIVE SERVICE,Y,Y,Y
58
- position_occupied_code,"The code representing an employee's position in the Competitive Service, Excepted Service, or the Senior Executive Service.",1,Y,Y,Y
59
- separation_category,The text description of the personnel action that resulted in the separation of an employee.,QUIT,,,Y
60
- separation_category_code,The code representing the personnel action that resulted in the separation of an employee.,SC,,,Y
61
- service_computation_date_leave,An employee's service computation date for leave accrual purposes.,2020-08-30 00:00:00,Y,Y,Y
62
- snapshot_yyyymm,The date (year and month) when the snapshot of the data was taken.,202311,Y,,
63
- stem_occupation,Text field identifying positions that fall under STEM or Health occupations.,STEM OCCUPATIONS,Y,Y,Y
64
- stem_occupation_type,"A breakout of the STEM Occupation field into its components (i.e. Science, Technology, Engineering, and Mathematics) as well as Health.",SCIENCE OCCUPATIONS,Y,Y,Y
65
- step_or_rate_type,"The text description of a specific salary within a grade, level, class, rate, or pay band.",RATE 03,Y,Y,Y
66
- step_or_rate_type_code,"The code representing a specific salary within a grade, level, class, rate, or pay band.",03,Y,Y,Y
67
- supervisory_status,"The text description of the nature of managerial, supervisory, or non-supervisory responsibility assigned to an employee's position.",SUPERVISOR OR MANAGER,Y,Y,Y
68
- supervisory_status_code,"The code representing the nature of managerial, supervisory, or non-supervisory responsibility assigned to an employee's position.",2,Y,Y,Y
69
- tenure,"For purposes of reduction in force, the text description of the retention group in which an employee is placed based on the employee's type of appointment.",TENURE GROUP 1 - CAREER OR SERVING AN APPOINTMENT CARRYING NO RESTRICTION OR CONDITION,Y,Y,Y
70
- tenure_code,"For purposes of reduction in force, the code representing the retention group in which an employee is placed based on the employee's type of appointment.",1,Y,Y,Y
71
- veteran_indicator,"Veteran indicator is determined here by using several veteran-related fields in the dataset, including veterans preference, creditable military service, reemployed annuitant codes, and veterans-specific appointment authorities.",Y,Y,Y,Y
72
- work_schedule,The text description of the time basis on which an employee is scheduled to work.,FULL-TIME,Y,Y,Y
73
- work_schedule_code,The code representing the time basis on which an employee is scheduled to work.,F,Y,Y,Y
1
+ field,definition,sample_value,employment,accessions,separations
2
+ accession_category,The text description of the personnel action that resulted in the onboarding of a new employee.,NEW HIRE - COMPETITIVE SERVICE APPOINTMENT,,Y,
3
+ accession_category_code,The code representing the personnel action that resulted in the onboarding of a new employee.,AC,,Y,
4
+ age_bracket,The range that a given employee's age falls into.,45-49,Y,Y,Y
5
+ agency,The text description of a high-level employing organization.,DEPARTMENT OF INTERIOR,Y,Y,Y
6
+ agency_code,The code representing a high-level employing organization.,IN,Y,Y,Y
7
+ agency_subelement,The text description of an administrative subdivision of the agency.,BUREAU OF LAND MANAGEMENT,Y,Y,Y
8
+ agency_subelement_code,The code representing an administrative subdivision of the agency.,IN05,Y,Y,Y
9
+ annualized_adjusted_basic_pay,"The sum of an employee's rate of basic pay and any basic pay supplement (standard OR special), after applying any applicable pay cap, on an annualized basis.",35729.44,Y,Y,Y
10
+ appointment_not_to_exceed_date,End date of the employee's temporary not-to-exceed appointment.,2019-03-16 00:00:00,,Y,Y
11
+ appointment_type,The text description of the type of appointment an employee is serving under in terms of permanence and competitiveness.,CAREER (COMPETITIVE SERVICE PERMANENT),Y,Y,Y
12
+ appointment_type_code,The code representing the type of appointment an employee is serving under in terms of permanence and competitiveness.,10,Y,Y,Y
13
+ bargaining_unit,The text description of the bargaining unit within the labor union representing the employee.,"NTEU/- INTERNAL REVENUE SERVICE; WASHINGTON, DC",Y,Y,Y
14
+ bargaining_unit_code,The code representing the bargaining unit within the labor union representing the employee.,1724,Y,Y,Y
15
+ bargaining_unit_status,The text description of the employee's eligibility to be represented by a labor union within the federal government.,ELIGIBLE_IN_BU,Y,Y,Y
16
+ cfo_act_agency_indicator,Identifies whether the agency is subject to the CFO Act.,CFO ACT AGENCY,Y,Y,Y
17
+ consolidated_statistical_area,The text description of a U.S. Office of Management and Budget defined entity containing two or more adjacent core based statistical areas.,"BOSTON-WORCESTER-PROVIDENCE, MA-RI-NH",Y,Y,Y
18
+ consolidated_statistical_area_code,The code representing a U.S. Office of Management and Budget defined entity containing two or more adjacent core based statistical areas.,148,Y,Y,Y
19
+ core_based_statistical_area,"The text description of a geographic entity associated with at least one core of 10,000 or more population, plus adjacent territory that has a high degree of social and economic integration with the core as measured by commuting ties.","CHICO, CA METROPOLITAN STATISTICAL AREA",Y,Y,Y
20
+ core_based_statistical_area_code,"The code representing a geographic entity associated with at least one core of 10,000 or more population, plus adjacent territory that has a high degree of social and economic integration with the core as measured by commuting ties.",17020,Y,Y,Y
21
+ count,"The integer value 1, used for counting or aggregating values over the data set.",1,Y,Y,Y
22
+ department,"Name of the department of the employee, aiding in the classification of roles within the organization.",DEPARTMENT OF AGRICULTURE,Y,Y,Y
23
+ department_code,"Code representing the department to which the employee belongs, important for organizational structure.",AG,Y,Y,Y
24
+ drp_indicator,Identifies whether a separation took place under the deferred resignation program.,N,,,Y
25
+ duty_station_city,The text description of the city of an employee's official worksite.,BLOOMINGTON,Y,Y,Y
26
+ duty_station_code,The code representing an employee's official worksite.,270675053,Y,Y,Y
27
+ duty_station_country,The text description of the country of an employee's official worksite.,UNITED STATES,Y,Y,Y
28
+ duty_station_country_code,The code representing the country of an employee's official worksite.,US,Y,Y,Y
29
+ duty_station_county,The text description of the county of an employee's official worksite.,HENNEPIN,Y,Y,Y
30
+ duty_station_county_code,The code representing the county of an employee's official worksite.,53,Y,Y,Y
31
+ duty_station_state,The text description of the state of an employee's official worksite.,MINNESOTA,Y,Y,Y
32
+ duty_station_state_abbreviation,The text abbreviation of the state of an employee's official worksite.,MN,Y,Y,Y
33
+ duty_station_state_country_territory_code,"The code representing the state, country, or territory, as appropriate, of an employee's official worksite.",27,Y,Y,Y
34
+ education_level,The text description of the highest level of an employee's educational attainment from an accredited institution.,MASTER'S DEGREE,Y,Y,Y
35
+ education_level_bracket,The text description of the simplified category for the highest level of education attained by the employee.,MASTERS OR PROFESSIONAL DEGREE,Y,Y,Y
36
+ education_level_code,The code representing the highest level of an employee's educational attainment from an accredited institution.,17,Y,Y,Y
37
+ flsa_category,"The text description of the status of a Federal civilian employee under the authority of Section 13 of the Fair Labor Standards Act (29 U.S.C. 213), as amended.",EXEMPT EMPLOYEE,Y,Y,Y
38
+ flsa_category_code,"The code representing the status of a Federal civilian employee under the authority of Section 13 of the Fair Labor Standards Act (29 U.S.C. 213), as amended.",E,Y,Y,Y
39
+ grade,An indicator of hierarchical relationships among positions covered by the same pay plan or system.,08,Y,Y,Y
40
+ length_of_service_years,"The number of years of Federal civilian employment, creditable military service, and other service made creditable by specific legislation.",15.5,Y,Y,Y
41
+ locality_pay_area,The text description of a specific geographic region used to determine pay adjustments for federal employees based on local non-federal salary rates.,"AUSTIN-ROUND ROCK, TX",Y,Y,Y
42
+ locality_pay_area_code,The code representing a specific geographic region used to determine pay adjustments for federal employees based on local non-federal salary rates.,AU,Y,Y,Y
43
+ nsftp_indicator,"Identifies whether an employee is a non-seasonal, full time, permanent employee.",Y,Y,Y,Y
44
+ occupational_category,"The text description of the highest-level grouping of occupational series into Professional, Administrative, Technical, Clerical, Other White Collar and Blue Collar categories.",PROFESSIONAL,Y,Y,Y
45
+ occupational_category_code,"The code representing the highest-level grouping of occupational series into Professional, Administrative, Technical, Clerical, Other White Collar and Blue Collar categories.",P,Y,Y,Y
46
+ occupational_group,The text description of a grouping of similar occupational series.,INFORMATION TECHNOLOGY GROUP,Y,Y,Y
47
+ occupational_group_code,The code representing a grouping of similar occupational series.,22,Y,Y,Y
48
+ occupational_series,The text description of the job category that an employee's position falls under based on the duties and required qualifications of the position.,INFORMATION TECHNOLOGY MANAGEMENT,Y,Y,Y
49
+ occupational_series_code,The code representing the job category that an employee's position falls under based on the duties and required qualifications of the position.,2210,Y,Y,Y
50
+ pathways_group,"Classification for employees within the pathways programs, which helps in the development of skills and experience.",RECENT GRAD,Y,Y,Y
51
+ pay_basis,"The text description of the principal condition in terms of time, production, or other criteria that, along with salary rate, determines the compensation paid to an employee.",PER ANNUM,Y,Y,Y
52
+ pay_basis_code,"The code representing the principal condition in terms of time, production, or other criteria that, along with salary rate, determines the compensation paid to an employee.",PA,Y,Y,Y
53
+ pay_plan,The text description of a particular table or array of pay rates prescribed by law or other authoritative source that establishes the basic pay rates for certain employees.,GENERAL SCHEDULE,Y,Y,Y
54
+ pay_plan_code,The code representing a particular table or array of pay rates prescribed by law or other authoritative source that establishes the basic pay rates for certain employees.,GS,Y,Y,Y
55
+ personnel_action_effective_date_yyyymm,The date on which an accession or separation action became effective.,202108,,Y,Y
56
+ personnel_office_identifier_code,"The identification of the Federal civilian personnel office authorized to appoint and separate an employee, and to the extent such functions have been delegated, prepare personnel actions, maintain official personnel records, and administer programs for staff compensation, training and development, benefits and awards, and employee and labor relations.",1559,Y,Y,Y
57
+ position_occupied,"The text description of an employee's position in the Competitive Service, Excepted Service, or the Senior Executive Service.",COMPETITIVE SERVICE,Y,Y,Y
58
+ position_occupied_code,"The code representing an employee's position in the Competitive Service, Excepted Service, or the Senior Executive Service.",1,Y,Y,Y
59
+ separation_category,The text description of the personnel action that resulted in the separation of an employee.,QUIT,,,Y
60
+ separation_category_code,The code representing the personnel action that resulted in the separation of an employee.,SC,,,Y
61
+ service_computation_date_leave,An employee's service computation date for leave accrual purposes.,2020-08-30 00:00:00,Y,Y,Y
62
+ snapshot_yyyymm,The date (year and month) when the snapshot of the data was taken.,202311,Y,,
63
+ stem_occupation,Text field identifying positions that fall under STEM or Health occupations.,STEM OCCUPATIONS,Y,Y,Y
64
+ stem_occupation_type,"A breakout of the STEM Occupation field into its components (i.e. Science, Technology, Engineering, and Mathematics) as well as Health.",SCIENCE OCCUPATIONS,Y,Y,Y
65
+ step_or_rate_type,"The text description of a specific salary within a grade, level, class, rate, or pay band.",RATE 03,Y,Y,Y
66
+ step_or_rate_type_code,"The code representing a specific salary within a grade, level, class, rate, or pay band.",03,Y,Y,Y
67
+ supervisory_status,"The text description of the nature of managerial, supervisory, or non-supervisory responsibility assigned to an employee's position.",SUPERVISOR OR MANAGER,Y,Y,Y
68
+ supervisory_status_code,"The code representing the nature of managerial, supervisory, or non-supervisory responsibility assigned to an employee's position.",2,Y,Y,Y
69
+ tenure,"For purposes of reduction in force, the text description of the retention group in which an employee is placed based on the employee's type of appointment.",TENURE GROUP 1 - CAREER OR SERVING AN APPOINTMENT CARRYING NO RESTRICTION OR CONDITION,Y,Y,Y
70
+ tenure_code,"For purposes of reduction in force, the code representing the retention group in which an employee is placed based on the employee's type of appointment.",1,Y,Y,Y
71
+ veteran_indicator,"Veteran indicator is determined here by using several veteran-related fields in the dataset, including veterans preference, creditable military service, reemployed annuitant codes, and veterans-specific appointment authorities.",Y,Y,Y,Y
72
+ work_schedule,The text description of the time basis on which an employee is scheduled to work.,FULL-TIME,Y,Y,Y
73
+ work_schedule_code,The code representing the time basis on which an employee is scheduled to work.,F,Y,Y,Y