data-analyst-mcp 0.0.0-stage → 0.3.0

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 (640) hide show
  1. package/README.md +262 -3
  2. package/dist/adapters/_acf_tidy.d.ts +18 -0
  3. package/dist/adapters/_acf_tidy.js +432 -0
  4. package/dist/adapters/_acf_tidy.js.map +1 -0
  5. package/dist/adapters/_actuaries_read.d.ts +38 -0
  6. package/dist/adapters/_actuaries_read.js +728 -0
  7. package/dist/adapters/_actuaries_read.js.map +1 -0
  8. package/dist/adapters/_census_micro.d.ts +70 -0
  9. package/dist/adapters/_census_micro.js +622 -0
  10. package/dist/adapters/_census_micro.js.map +1 -0
  11. package/dist/adapters/_census_util.d.ts +40 -0
  12. package/dist/adapters/_census_util.js +275 -0
  13. package/dist/adapters/_census_util.js.map +1 -0
  14. package/dist/adapters/_dol_states.d.ts +6 -0
  15. package/dist/adapters/_dol_states.js +58 -0
  16. package/dist/adapters/_dol_states.js.map +1 -0
  17. package/dist/adapters/_govinfo_entities.d.ts +4 -0
  18. package/dist/adapters/_govinfo_entities.js +6 -0
  19. package/dist/adapters/_govinfo_entities.js.map +1 -0
  20. package/dist/adapters/_govinfo_json.d.ts +13 -0
  21. package/dist/adapters/_govinfo_json.js +107 -0
  22. package/dist/adapters/_govinfo_json.js.map +1 -0
  23. package/dist/adapters/_govinfo_py.d.ts +22 -0
  24. package/dist/adapters/_govinfo_py.js +272 -0
  25. package/dist/adapters/_govinfo_py.js.map +1 -0
  26. package/dist/adapters/_govinfo_xml.d.ts +22 -0
  27. package/dist/adapters/_govinfo_xml.js +233 -0
  28. package/dist/adapters/_govinfo_xml.js.map +1 -0
  29. package/dist/adapters/_hud_excel.d.ts +2 -0
  30. package/dist/adapters/_hud_excel.js +166 -0
  31. package/dist/adapters/_hud_excel.js.map +1 -0
  32. package/dist/adapters/_omb_grid.d.ts +17 -0
  33. package/dist/adapters/_omb_grid.js +132 -0
  34. package/dist/adapters/_omb_grid.js.map +1 -0
  35. package/dist/adapters/_omb_util.d.ts +40 -0
  36. package/dist/adapters/_omb_util.js +192 -0
  37. package/dist/adapters/_omb_util.js.map +1 -0
  38. package/dist/adapters/_usaspending_state.d.ts +6 -0
  39. package/dist/adapters/_usaspending_state.js +54 -0
  40. package/dist/adapters/_usaspending_state.js.map +1 -0
  41. package/dist/adapters/_usda-fna_book.d.ts +59 -0
  42. package/dist/adapters/_usda-fna_book.js +869 -0
  43. package/dist/adapters/_usda-fna_book.js.map +1 -0
  44. package/dist/adapters/_usda-fna_pdf.d.ts +20 -0
  45. package/dist/adapters/_usda-fna_pdf.js +361 -0
  46. package/dist/adapters/_usda-fna_pdf.js.map +1 -0
  47. package/dist/adapters/_usda-outlook_read.d.ts +70 -0
  48. package/dist/adapters/_usda-outlook_read.js +362 -0
  49. package/dist/adapters/_usda-outlook_read.js.map +1 -0
  50. package/dist/adapters/acf.d.ts +3 -0
  51. package/dist/adapters/acf.js +187 -0
  52. package/dist/adapters/acf.js.map +1 -0
  53. package/dist/adapters/actuaries.d.ts +3 -0
  54. package/dist/adapters/actuaries.js +293 -0
  55. package/dist/adapters/actuaries.js.map +1 -0
  56. package/dist/adapters/bts.d.ts +3 -0
  57. package/dist/adapters/bts.js +26 -0
  58. package/dist/adapters/bts.js.map +1 -0
  59. package/dist/adapters/census-geocoder.d.ts +10 -0
  60. package/dist/adapters/census-geocoder.js +47 -0
  61. package/dist/adapters/census-geocoder.js.map +1 -0
  62. package/dist/adapters/census.d.ts +17 -0
  63. package/dist/adapters/census.js +983 -0
  64. package/dist/adapters/census.js.map +1 -0
  65. package/dist/adapters/cfpb.d.ts +7 -0
  66. package/dist/adapters/cfpb.js +348 -0
  67. package/dist/adapters/cfpb.js.map +1 -0
  68. package/dist/adapters/clinical-trials.d.ts +3 -0
  69. package/dist/adapters/clinical-trials.js +135 -0
  70. package/dist/adapters/clinical-trials.js.map +1 -0
  71. package/dist/adapters/cms.d.ts +3 -0
  72. package/dist/adapters/cms.js +292 -0
  73. package/dist/adapters/cms.js.map +1 -0
  74. package/dist/adapters/college-scorecard.d.ts +3 -0
  75. package/dist/adapters/college-scorecard.js +122 -0
  76. package/dist/adapters/college-scorecard.js.map +1 -0
  77. package/dist/adapters/congress.d.ts +33 -0
  78. package/dist/adapters/congress.js +589 -0
  79. package/dist/adapters/congress.js.map +1 -0
  80. package/dist/adapters/dhs-ohss.d.ts +13 -0
  81. package/dist/adapters/dhs-ohss.js +598 -0
  82. package/dist/adapters/dhs-ohss.js.map +1 -0
  83. package/dist/adapters/doj-news.d.ts +7 -0
  84. package/dist/adapters/doj-news.js +286 -0
  85. package/dist/adapters/doj-news.js.map +1 -0
  86. package/dist/adapters/dol.d.ts +4 -0
  87. package/dist/adapters/dol.js +634 -0
  88. package/dist/adapters/dol.js.map +1 -0
  89. package/dist/adapters/eia.d.ts +15 -0
  90. package/dist/adapters/eia.js +456 -0
  91. package/dist/adapters/eia.js.map +1 -0
  92. package/dist/adapters/epa-aqs.d.ts +3 -0
  93. package/dist/adapters/epa-aqs.js +357 -0
  94. package/dist/adapters/epa-aqs.js.map +1 -0
  95. package/dist/adapters/epa.d.ts +3 -0
  96. package/dist/adapters/epa.js +298 -0
  97. package/dist/adapters/epa.js.map +1 -0
  98. package/dist/adapters/fbi.d.ts +3 -0
  99. package/dist/adapters/fbi.js +192 -0
  100. package/dist/adapters/fbi.js.map +1 -0
  101. package/dist/adapters/fda.d.ts +5 -0
  102. package/dist/adapters/fda.js +184 -0
  103. package/dist/adapters/fda.js.map +1 -0
  104. package/dist/adapters/fdic.d.ts +4 -0
  105. package/dist/adapters/fdic.js +95 -0
  106. package/dist/adapters/fdic.js.map +1 -0
  107. package/dist/adapters/fec.d.ts +3 -0
  108. package/dist/adapters/fec.js +142 -0
  109. package/dist/adapters/fec.js.map +1 -0
  110. package/dist/adapters/fed-board.d.ts +12 -0
  111. package/dist/adapters/fed-board.js +581 -0
  112. package/dist/adapters/fed-board.js.map +1 -0
  113. package/dist/adapters/federal-register.d.ts +11 -0
  114. package/dist/adapters/federal-register.js +43 -0
  115. package/dist/adapters/federal-register.js.map +1 -0
  116. package/dist/adapters/fhfa.d.ts +3 -0
  117. package/dist/adapters/fhfa.js +253 -0
  118. package/dist/adapters/fhfa.js.map +1 -0
  119. package/dist/adapters/fsa.d.ts +9 -0
  120. package/dist/adapters/fsa.js +335 -0
  121. package/dist/adapters/fsa.js.map +1 -0
  122. package/dist/adapters/govinfo.d.ts +30 -0
  123. package/dist/adapters/govinfo.js +636 -0
  124. package/dist/adapters/govinfo.js.map +1 -0
  125. package/dist/adapters/gsa-calc.d.ts +10 -0
  126. package/dist/adapters/gsa-calc.js +318 -0
  127. package/dist/adapters/gsa-calc.js.map +1 -0
  128. package/dist/adapters/hud.d.ts +3 -0
  129. package/dist/adapters/hud.js +200 -0
  130. package/dist/adapters/hud.js.map +1 -0
  131. package/dist/adapters/index.d.ts +3 -0
  132. package/dist/adapters/index.js +25 -0
  133. package/dist/adapters/index.js.map +1 -0
  134. package/dist/adapters/irs-soi.d.ts +6 -0
  135. package/dist/adapters/irs-soi.js +576 -0
  136. package/dist/adapters/irs-soi.js.map +1 -0
  137. package/dist/adapters/naep.d.ts +15 -0
  138. package/dist/adapters/naep.js +341 -0
  139. package/dist/adapters/naep.js.map +1 -0
  140. package/dist/adapters/nhtsa.d.ts +10 -0
  141. package/dist/adapters/nhtsa.js +239 -0
  142. package/dist/adapters/nhtsa.js.map +1 -0
  143. package/dist/adapters/nih.d.ts +5 -0
  144. package/dist/adapters/nih.js +196 -0
  145. package/dist/adapters/nih.js.map +1 -0
  146. package/dist/adapters/noaa.d.ts +3 -0
  147. package/dist/adapters/noaa.js +148 -0
  148. package/dist/adapters/noaa.js.map +1 -0
  149. package/dist/adapters/nrel.d.ts +3 -0
  150. package/dist/adapters/nrel.js +186 -0
  151. package/dist/adapters/nrel.js.map +1 -0
  152. package/dist/adapters/nws.d.ts +3 -0
  153. package/dist/adapters/nws.js +119 -0
  154. package/dist/adapters/nws.js.map +1 -0
  155. package/dist/adapters/omb.d.ts +15 -0
  156. package/dist/adapters/omb.js +517 -0
  157. package/dist/adapters/omb.js.map +1 -0
  158. package/dist/adapters/open-payments.d.ts +5 -0
  159. package/dist/adapters/open-payments.js +149 -0
  160. package/dist/adapters/open-payments.js.map +1 -0
  161. package/dist/adapters/pbgc.d.ts +13 -0
  162. package/dist/adapters/pbgc.js +283 -0
  163. package/dist/adapters/pbgc.js.map +1 -0
  164. package/dist/adapters/philfed.d.ts +12 -0
  165. package/dist/adapters/philfed.js +59 -0
  166. package/dist/adapters/philfed.js.map +1 -0
  167. package/dist/adapters/regulations.d.ts +6 -0
  168. package/dist/adapters/regulations.js +58 -0
  169. package/dist/adapters/regulations.js.map +1 -0
  170. package/dist/adapters/sec.d.ts +13 -0
  171. package/dist/adapters/sec.js +504 -0
  172. package/dist/adapters/sec.js.map +1 -0
  173. package/dist/adapters/senate-lobbying.d.ts +3 -0
  174. package/dist/adapters/senate-lobbying.js +181 -0
  175. package/dist/adapters/senate-lobbying.js.map +1 -0
  176. package/dist/adapters/snapqc.d.ts +32 -0
  177. package/dist/adapters/snapqc.js +701 -0
  178. package/dist/adapters/snapqc.js.map +1 -0
  179. package/dist/adapters/treasury-yields.d.ts +3 -0
  180. package/dist/adapters/treasury-yields.js +170 -0
  181. package/dist/adapters/treasury-yields.js.map +1 -0
  182. package/dist/adapters/usaspending.d.ts +3 -0
  183. package/dist/adapters/usaspending.js +340 -0
  184. package/dist/adapters/usaspending.js.map +1 -0
  185. package/dist/adapters/usda-fna.d.ts +7 -0
  186. package/dist/adapters/usda-fna.js +707 -0
  187. package/dist/adapters/usda-fna.js.map +1 -0
  188. package/dist/adapters/usda-fooddata.d.ts +3 -0
  189. package/dist/adapters/usda-fooddata.js +101 -0
  190. package/dist/adapters/usda-fooddata.js.map +1 -0
  191. package/dist/adapters/usda-nass.d.ts +3 -0
  192. package/dist/adapters/usda-nass.js +108 -0
  193. package/dist/adapters/usda-nass.js.map +1 -0
  194. package/dist/adapters/usda-outlook.d.ts +12 -0
  195. package/dist/adapters/usda-outlook.js +696 -0
  196. package/dist/adapters/usda-outlook.js.map +1 -0
  197. package/dist/adapters/usgs.d.ts +9 -0
  198. package/dist/adapters/usgs.js +265 -0
  199. package/dist/adapters/usgs.js.map +1 -0
  200. package/dist/adapters/usitc.d.ts +18 -0
  201. package/dist/adapters/usitc.js +170 -0
  202. package/dist/adapters/usitc.js.map +1 -0
  203. package/dist/adapters/uspto.d.ts +3 -0
  204. package/dist/adapters/uspto.js +47 -0
  205. package/dist/adapters/uspto.js.map +1 -0
  206. package/dist/adapters/world-bank.d.ts +3 -0
  207. package/dist/adapters/world-bank.js +163 -0
  208. package/dist/adapters/world-bank.js.map +1 -0
  209. package/dist/analysis/cite.d.ts +31 -0
  210. package/dist/analysis/cite.js +229 -0
  211. package/dist/analysis/cite.js.map +1 -0
  212. package/dist/analysis/combine.d.ts +27 -0
  213. package/dist/analysis/combine.js +198 -0
  214. package/dist/analysis/combine.js.map +1 -0
  215. package/dist/analysis/compute.d.ts +62 -0
  216. package/dist/analysis/compute.js +583 -0
  217. package/dist/analysis/compute.js.map +1 -0
  218. package/dist/analysis/expr.d.ts +69 -0
  219. package/dist/analysis/expr.js +780 -0
  220. package/dist/analysis/expr.js.map +1 -0
  221. package/dist/analysis/factfmt.d.ts +16 -0
  222. package/dist/analysis/factfmt.js +187 -0
  223. package/dist/analysis/factfmt.js.map +1 -0
  224. package/dist/analysis/facts.d.ts +63 -0
  225. package/dist/analysis/facts.js +355 -0
  226. package/dist/analysis/facts.js.map +1 -0
  227. package/dist/analysis/handoff.d.ts +58 -0
  228. package/dist/analysis/handoff.js +208 -0
  229. package/dist/analysis/handoff.js.map +1 -0
  230. package/dist/analysis/pyfmt.d.ts +16 -0
  231. package/dist/analysis/pyfmt.js +156 -0
  232. package/dist/analysis/pyfmt.js.map +1 -0
  233. package/dist/analysis/rerun.d.ts +13 -0
  234. package/dist/analysis/rerun.js +125 -0
  235. package/dist/analysis/rerun.js.map +1 -0
  236. package/dist/analysis/table.d.ts +18 -0
  237. package/dist/analysis/table.js +109 -0
  238. package/dist/analysis/table.js.map +1 -0
  239. package/dist/analysis/tools.d.ts +67 -0
  240. package/dist/analysis/tools.js +217 -0
  241. package/dist/analysis/tools.js.map +1 -0
  242. package/dist/analysis/write_table.d.ts +13 -0
  243. package/dist/analysis/write_table.js +59 -0
  244. package/dist/analysis/write_table.js.map +1 -0
  245. package/dist/bin/cli.d.ts +10 -0
  246. package/dist/bin/cli.js +177 -0
  247. package/dist/bin/cli.js.map +1 -0
  248. package/dist/core/cache.d.ts +14 -0
  249. package/dist/core/cache.js +90 -0
  250. package/dist/core/cache.js.map +1 -0
  251. package/dist/core/context.d.ts +12 -0
  252. package/dist/core/context.js +15 -0
  253. package/dist/core/context.js.map +1 -0
  254. package/dist/core/env.d.ts +14 -0
  255. package/dist/core/env.js +52 -0
  256. package/dist/core/env.js.map +1 -0
  257. package/dist/core/generic-rest.d.ts +61 -0
  258. package/dist/core/generic-rest.js +639 -0
  259. package/dist/core/generic-rest.js.map +1 -0
  260. package/dist/core/http.d.ts +120 -0
  261. package/dist/core/http.js +514 -0
  262. package/dist/core/http.js.map +1 -0
  263. package/dist/core/keys.d.ts +43 -0
  264. package/dist/core/keys.js +174 -0
  265. package/dist/core/keys.js.map +1 -0
  266. package/dist/core/manual.d.ts +41 -0
  267. package/dist/core/manual.js +218 -0
  268. package/dist/core/manual.js.map +1 -0
  269. package/dist/core/package.d.ts +58 -0
  270. package/dist/core/package.js +228 -0
  271. package/dist/core/package.js.map +1 -0
  272. package/dist/core/packs.d.ts +139 -0
  273. package/dist/core/packs.js +173 -0
  274. package/dist/core/packs.js.map +1 -0
  275. package/dist/core/policy.d.ts +69 -0
  276. package/dist/core/policy.js +189 -0
  277. package/dist/core/policy.js.map +1 -0
  278. package/dist/core/py.d.ts +40 -0
  279. package/dist/core/py.js +171 -0
  280. package/dist/core/py.js.map +1 -0
  281. package/dist/core/routing.d.ts +10 -0
  282. package/dist/core/routing.js +39 -0
  283. package/dist/core/routing.js.map +1 -0
  284. package/dist/core/tabular.d.ts +21 -0
  285. package/dist/core/tabular.js +229 -0
  286. package/dist/core/tabular.js.map +1 -0
  287. package/dist/deep/_bea_api.d.ts +102 -0
  288. package/dist/deep/_bea_api.js +457 -0
  289. package/dist/deep/_bea_api.js.map +1 -0
  290. package/dist/deep/_bea_fetch.d.ts +151 -0
  291. package/dist/deep/_bea_fetch.js +1274 -0
  292. package/dist/deep/_bea_fetch.js.map +1 -0
  293. package/dist/deep/_bea_util.d.ts +14 -0
  294. package/dist/deep/_bea_util.js +156 -0
  295. package/dist/deep/_bea_util.js.map +1 -0
  296. package/dist/deep/_bls_api.d.ts +84 -0
  297. package/dist/deep/_bls_api.js +231 -0
  298. package/dist/deep/_bls_api.js.map +1 -0
  299. package/dist/deep/_bls_ids.d.ts +43 -0
  300. package/dist/deep/_bls_ids.js +188 -0
  301. package/dist/deep/_bls_ids.js.map +1 -0
  302. package/dist/deep/_bls_lib.d.ts +61 -0
  303. package/dist/deep/_bls_lib.js +442 -0
  304. package/dist/deep/_bls_lib.js.map +1 -0
  305. package/dist/deep/_fred_api.d.ts +148 -0
  306. package/dist/deep/_fred_api.js +545 -0
  307. package/dist/deep/_fred_api.js.map +1 -0
  308. package/dist/deep/_fred_pack.d.ts +162 -0
  309. package/dist/deep/_fred_pack.js +1027 -0
  310. package/dist/deep/_fred_pack.js.map +1 -0
  311. package/dist/deep/_fred_py.d.ts +40 -0
  312. package/dist/deep/_fred_py.js +199 -0
  313. package/dist/deep/_fred_py.js.map +1 -0
  314. package/dist/deep/_ipums_bundle.d.ts +29 -0
  315. package/dist/deep/_ipums_bundle.js +194 -0
  316. package/dist/deep/_ipums_bundle.js.map +1 -0
  317. package/dist/deep/_ipums_ddi.d.ts +23 -0
  318. package/dist/deep/_ipums_ddi.js +162 -0
  319. package/dist/deep/_ipums_ddi.js.map +1 -0
  320. package/dist/deep/_opm_io.d.ts +26 -0
  321. package/dist/deep/_opm_io.js +383 -0
  322. package/dist/deep/_opm_io.js.map +1 -0
  323. package/dist/deep/_opm_parquet.d.ts +31 -0
  324. package/dist/deep/_opm_parquet.js +744 -0
  325. package/dist/deep/_opm_parquet.js.map +1 -0
  326. package/dist/deep/_opm_py.d.ts +6 -0
  327. package/dist/deep/_opm_py.js +74 -0
  328. package/dist/deep/_opm_py.js.map +1 -0
  329. package/dist/deep/_treasury_api.d.ts +48 -0
  330. package/dist/deep/_treasury_api.js +221 -0
  331. package/dist/deep/_treasury_api.js.map +1 -0
  332. package/dist/deep/_treasury_context.d.ts +34 -0
  333. package/dist/deep/_treasury_context.js +142 -0
  334. package/dist/deep/_treasury_context.js.map +1 -0
  335. package/dist/deep/_treasury_lib.d.ts +109 -0
  336. package/dist/deep/_treasury_lib.js +686 -0
  337. package/dist/deep/_treasury_lib.js.map +1 -0
  338. package/dist/deep/bea.d.ts +3 -0
  339. package/dist/deep/bea.js +248 -0
  340. package/dist/deep/bea.js.map +1 -0
  341. package/dist/deep/bls.d.ts +3 -0
  342. package/dist/deep/bls.js +220 -0
  343. package/dist/deep/bls.js.map +1 -0
  344. package/dist/deep/fred.d.ts +3 -0
  345. package/dist/deep/fred.js +325 -0
  346. package/dist/deep/fred.js.map +1 -0
  347. package/dist/deep/ipums.d.ts +59 -0
  348. package/dist/deep/ipums.js +744 -0
  349. package/dist/deep/ipums.js.map +1 -0
  350. package/dist/deep/opm.d.ts +56 -0
  351. package/dist/deep/opm.js +1033 -0
  352. package/dist/deep/opm.js.map +1 -0
  353. package/dist/deep/treasury.d.ts +3 -0
  354. package/dist/deep/treasury.js +218 -0
  355. package/dist/deep/treasury.js.map +1 -0
  356. package/dist/envelope.d.ts +47 -0
  357. package/dist/envelope.js +88 -0
  358. package/dist/envelope.js.map +1 -0
  359. package/dist/index.d.ts +277 -0
  360. package/dist/index.js +106 -0
  361. package/dist/index.js.map +1 -0
  362. package/dist/remote/app.d.ts +21 -0
  363. package/dist/remote/app.js +218 -0
  364. package/dist/remote/app.js.map +1 -0
  365. package/dist/remote/oauth.d.ts +14 -0
  366. package/dist/remote/oauth.js +90 -0
  367. package/dist/remote/oauth.js.map +1 -0
  368. package/dist/remote/pages.d.ts +8 -0
  369. package/dist/remote/pages.js +56 -0
  370. package/dist/remote/pages.js.map +1 -0
  371. package/dist/remote/sign.d.ts +4 -0
  372. package/dist/remote/sign.js +40 -0
  373. package/dist/remote/sign.js.map +1 -0
  374. package/dist/remote/store.d.ts +31 -0
  375. package/dist/remote/store.js +129 -0
  376. package/dist/remote/store.js.map +1 -0
  377. package/dist/report/audit_answer.d.ts +94 -0
  378. package/dist/report/audit_answer.js +1349 -0
  379. package/dist/report/audit_answer.js.map +1 -0
  380. package/dist/report/audit_report.d.ts +23 -0
  381. package/dist/report/audit_report.js +637 -0
  382. package/dist/report/audit_report.js.map +1 -0
  383. package/dist/report/build_report.d.ts +27 -0
  384. package/dist/report/build_report.js +1168 -0
  385. package/dist/report/build_report.js.map +1 -0
  386. package/dist/report/method_audit.d.ts +47 -0
  387. package/dist/report/method_audit.js +710 -0
  388. package/dist/report/method_audit.js.map +1 -0
  389. package/dist/report/policyset.d.ts +50 -0
  390. package/dist/report/policyset.js +421 -0
  391. package/dist/report/policyset.js.map +1 -0
  392. package/dist/report/py.d.ts +58 -0
  393. package/dist/report/py.js +311 -0
  394. package/dist/report/py.js.map +1 -0
  395. package/dist/report/scan_secrets.d.ts +21 -0
  396. package/dist/report/scan_secrets.js +234 -0
  397. package/dist/report/scan_secrets.js.map +1 -0
  398. package/dist/report/style_check.d.ts +29 -0
  399. package/dist/report/style_check.js +173 -0
  400. package/dist/report/style_check.js.map +1 -0
  401. package/dist/report/tools.d.ts +87 -0
  402. package/dist/report/tools.js +167 -0
  403. package/dist/report/tools.js.map +1 -0
  404. package/dist/server.d.ts +5 -0
  405. package/dist/server.js +246 -0
  406. package/dist/server.js.map +1 -0
  407. package/dist/session.d.ts +47 -0
  408. package/dist/session.js +107 -0
  409. package/dist/session.js.map +1 -0
  410. package/dist/toolkit.d.ts +21 -0
  411. package/dist/toolkit.js +2 -0
  412. package/dist/toolkit.js.map +1 -0
  413. package/dist/tools.d.ts +299 -0
  414. package/dist/tools.js +491 -0
  415. package/dist/tools.js.map +1 -0
  416. package/guide/WORKFLOW.md +134 -0
  417. package/guide/assets/disclaimer.txt +1 -0
  418. package/guide/assets/download_data.ps1 +162 -0
  419. package/guide/assets/download_data.sh +143 -0
  420. package/guide/assets/report_template.html +597 -0
  421. package/guide/references/report_patterns.md +199 -0
  422. package/guide/references/routing.md +171 -0
  423. package/guide/references/style_guide.md +398 -0
  424. package/package.json +56 -6
  425. package/packs/acf/endpoints.json +114 -0
  426. package/packs/acf/policy.json +104 -0
  427. package/packs/acf/source.md +138 -0
  428. package/packs/actuaries/endpoints.json +82 -0
  429. package/packs/actuaries/policy.json +109 -0
  430. package/packs/actuaries/source.md +137 -0
  431. package/packs/bea/assets/download_bea.ps1 +182 -0
  432. package/packs/bea/assets/download_bea.sh +144 -0
  433. package/packs/bea/docs/bea_api.md +461 -0
  434. package/packs/bea/docs/datasets.md +157 -0
  435. package/packs/bea/docs/report_patterns.md +112 -0
  436. package/packs/bea/policy.json +170 -0
  437. package/packs/bea/source.md +152 -0
  438. package/packs/bls/assets/download_bls.ps1 +152 -0
  439. package/packs/bls/assets/download_bls.sh +167 -0
  440. package/packs/bls/docs/analysis_patterns.md +108 -0
  441. package/packs/bls/docs/bls_api.md +73 -0
  442. package/packs/bls/docs/series_ids.md +149 -0
  443. package/packs/bls/policy.json +238 -0
  444. package/packs/bls/series_ids.json +1375 -0
  445. package/packs/bls/source.md +156 -0
  446. package/packs/bts/endpoints.json +347 -0
  447. package/packs/bts/policy.json +94 -0
  448. package/packs/bts/source.md +97 -0
  449. package/packs/cdc/endpoints.json +197 -0
  450. package/packs/cdc/policy.json +83 -0
  451. package/packs/cdc/source.md +74 -0
  452. package/packs/census/endpoints.json +99 -0
  453. package/packs/census/policy.json +238 -0
  454. package/packs/census/source.md +304 -0
  455. package/packs/census-geocoder/endpoints.json +70 -0
  456. package/packs/census-geocoder/policy.json +80 -0
  457. package/packs/census-geocoder/source.md +53 -0
  458. package/packs/cfpb/endpoints.json +327 -0
  459. package/packs/cfpb/policy.json +119 -0
  460. package/packs/cfpb/source.md +96 -0
  461. package/packs/clinical-trials/endpoints.json +167 -0
  462. package/packs/clinical-trials/policy.json +84 -0
  463. package/packs/clinical-trials/source.md +82 -0
  464. package/packs/cms/endpoints.json +69 -0
  465. package/packs/cms/policy.json +96 -0
  466. package/packs/cms/source.md +112 -0
  467. package/packs/college-scorecard/endpoints.json +253 -0
  468. package/packs/college-scorecard/policy.json +106 -0
  469. package/packs/college-scorecard/source.md +92 -0
  470. package/packs/congress/endpoints.json +1701 -0
  471. package/packs/congress/policy.json +117 -0
  472. package/packs/congress/source.md +190 -0
  473. package/packs/dhs-ohss/endpoints.json +66 -0
  474. package/packs/dhs-ohss/policy.json +107 -0
  475. package/packs/dhs-ohss/source.md +120 -0
  476. package/packs/doj-news/endpoints.json +59 -0
  477. package/packs/doj-news/policy.json +96 -0
  478. package/packs/doj-news/source.md +99 -0
  479. package/packs/dol/endpoints.json +818 -0
  480. package/packs/dol/policy.json +135 -0
  481. package/packs/dol/source.md +181 -0
  482. package/packs/eia/endpoints.json +718 -0
  483. package/packs/eia/policy.json +112 -0
  484. package/packs/eia/source.md +112 -0
  485. package/packs/epa/endpoints.json +292 -0
  486. package/packs/epa/policy.json +99 -0
  487. package/packs/epa/source.md +99 -0
  488. package/packs/epa-aqs/endpoints.json +174 -0
  489. package/packs/epa-aqs/policy.json +96 -0
  490. package/packs/epa-aqs/source.md +97 -0
  491. package/packs/fbi/endpoints.json +1842 -0
  492. package/packs/fbi/policy.json +118 -0
  493. package/packs/fbi/source.md +108 -0
  494. package/packs/fda/endpoints.json +238 -0
  495. package/packs/fda/policy.json +121 -0
  496. package/packs/fda/source.md +117 -0
  497. package/packs/fdic/endpoints.json +417 -0
  498. package/packs/fdic/policy.json +83 -0
  499. package/packs/fdic/source.md +92 -0
  500. package/packs/fec/endpoints.json +708 -0
  501. package/packs/fec/policy.json +93 -0
  502. package/packs/fec/source.md +90 -0
  503. package/packs/fed-board/endpoints.json +89 -0
  504. package/packs/fed-board/policy.json +136 -0
  505. package/packs/fed-board/source.md +118 -0
  506. package/packs/federal-register/endpoints.json +143 -0
  507. package/packs/federal-register/policy.json +86 -0
  508. package/packs/federal-register/source.md +98 -0
  509. package/packs/fema/endpoints.json +646 -0
  510. package/packs/fema/policy.json +103 -0
  511. package/packs/fema/source.md +103 -0
  512. package/packs/fhfa/endpoints.json +105 -0
  513. package/packs/fhfa/policy.json +109 -0
  514. package/packs/fhfa/source.md +108 -0
  515. package/packs/fred/assets/download_fred.ps1 +122 -0
  516. package/packs/fred/assets/download_fred.sh +123 -0
  517. package/packs/fred/docs/analysis_patterns.md +124 -0
  518. package/packs/fred/docs/fred_api.md +94 -0
  519. package/packs/fred/docs/series.md +188 -0
  520. package/packs/fred/policy.json +253 -0
  521. package/packs/fred/source.md +142 -0
  522. package/packs/fsa/endpoints.json +150 -0
  523. package/packs/fsa/policy.json +99 -0
  524. package/packs/fsa/source.md +102 -0
  525. package/packs/govinfo/endpoints.json +520 -0
  526. package/packs/govinfo/policy.json +116 -0
  527. package/packs/govinfo/source.md +241 -0
  528. package/packs/gsa-calc/endpoints.json +93 -0
  529. package/packs/gsa-calc/policy.json +97 -0
  530. package/packs/gsa-calc/source.md +108 -0
  531. package/packs/hud/endpoints.json +147 -0
  532. package/packs/hud/policy.json +84 -0
  533. package/packs/hud/source.md +97 -0
  534. package/packs/ipums/assets/download_ipums.ps1 +215 -0
  535. package/packs/ipums/assets/download_ipums.sh +192 -0
  536. package/packs/ipums/docs/ipums_api.md +67 -0
  537. package/packs/ipums/docs/report_patterns.md +117 -0
  538. package/packs/ipums/docs/variables.md +284 -0
  539. package/packs/ipums/lib/fetch_text.json +112 -0
  540. package/packs/ipums/policy.json +215 -0
  541. package/packs/ipums/source.md +169 -0
  542. package/packs/irs-soi/endpoints.json +114 -0
  543. package/packs/irs-soi/policy.json +107 -0
  544. package/packs/irs-soi/source.md +124 -0
  545. package/packs/medicaid/endpoints.json +412 -0
  546. package/packs/medicaid/policy.json +108 -0
  547. package/packs/medicaid/source.md +136 -0
  548. package/packs/naep/endpoints.json +217 -0
  549. package/packs/naep/policy.json +100 -0
  550. package/packs/naep/source.md +120 -0
  551. package/packs/nhtsa/endpoints.json +132 -0
  552. package/packs/nhtsa/policy.json +93 -0
  553. package/packs/nhtsa/source.md +109 -0
  554. package/packs/nih/endpoints.json +453 -0
  555. package/packs/nih/policy.json +86 -0
  556. package/packs/nih/source.md +108 -0
  557. package/packs/noaa/endpoints.json +432 -0
  558. package/packs/noaa/policy.json +95 -0
  559. package/packs/noaa/source.md +88 -0
  560. package/packs/nrel/endpoints.json +328 -0
  561. package/packs/nrel/policy.json +96 -0
  562. package/packs/nrel/source.md +91 -0
  563. package/packs/nws/endpoints.json +272 -0
  564. package/packs/nws/policy.json +82 -0
  565. package/packs/nws/source.md +81 -0
  566. package/packs/nyfed/endpoints.json +80 -0
  567. package/packs/nyfed/policy.json +92 -0
  568. package/packs/nyfed/source.md +89 -0
  569. package/packs/omb/endpoints.json +460 -0
  570. package/packs/omb/policy.json +106 -0
  571. package/packs/omb/source.md +130 -0
  572. package/packs/open-payments/endpoints.json +298 -0
  573. package/packs/open-payments/policy.json +101 -0
  574. package/packs/open-payments/source.md +99 -0
  575. package/packs/opm/assets/download_opm.ps1 +125 -0
  576. package/packs/opm/assets/download_opm.sh +85 -0
  577. package/packs/opm/docs/fields.md +184 -0
  578. package/packs/opm/docs/opm_api.md +71 -0
  579. package/packs/opm/docs/report_patterns.md +83 -0
  580. package/packs/opm/lib/data_dictionary.csv +73 -0
  581. package/packs/opm/policy.json +142 -0
  582. package/packs/opm/source.md +137 -0
  583. package/packs/pbgc/endpoints.json +483 -0
  584. package/packs/pbgc/policy.json +94 -0
  585. package/packs/pbgc/source.md +95 -0
  586. package/packs/philfed/endpoints.json +85 -0
  587. package/packs/philfed/policy.json +94 -0
  588. package/packs/philfed/source.md +125 -0
  589. package/packs/port.json +287 -0
  590. package/packs/regulations/endpoints.json +288 -0
  591. package/packs/regulations/policy.json +86 -0
  592. package/packs/regulations/source.md +84 -0
  593. package/packs/sec/endpoints.json +237 -0
  594. package/packs/sec/policy.json +86 -0
  595. package/packs/sec/source.md +101 -0
  596. package/packs/senate-lobbying/endpoints.json +554 -0
  597. package/packs/senate-lobbying/policy.json +99 -0
  598. package/packs/senate-lobbying/source.md +100 -0
  599. package/packs/snapqc/endpoints.json +1426 -0
  600. package/packs/snapqc/policy.json +92 -0
  601. package/packs/snapqc/source.md +96 -0
  602. package/packs/treasury/catalog.json +2267 -0
  603. package/packs/treasury/docs/api_guide.md +245 -0
  604. package/packs/treasury/docs/datasets.md +56 -0
  605. package/packs/treasury/docs/report_patterns.md +126 -0
  606. package/packs/treasury/policy.json +159 -0
  607. package/packs/treasury/source.md +165 -0
  608. package/packs/treasury-yields/endpoints.json +226 -0
  609. package/packs/treasury-yields/policy.json +86 -0
  610. package/packs/treasury-yields/source.md +80 -0
  611. package/packs/usaspending/endpoints.json +1316 -0
  612. package/packs/usaspending/policy.json +109 -0
  613. package/packs/usaspending/source.md +103 -0
  614. package/packs/usda-fna/endpoints.json +427 -0
  615. package/packs/usda-fna/policy.json +133 -0
  616. package/packs/usda-fna/source.md +217 -0
  617. package/packs/usda-fooddata/endpoints.json +181 -0
  618. package/packs/usda-fooddata/policy.json +94 -0
  619. package/packs/usda-fooddata/source.md +105 -0
  620. package/packs/usda-nass/endpoints.json +324 -0
  621. package/packs/usda-nass/policy.json +95 -0
  622. package/packs/usda-nass/source.md +85 -0
  623. package/packs/usda-outlook/endpoints.json +86 -0
  624. package/packs/usda-outlook/policy.json +109 -0
  625. package/packs/usda-outlook/source.md +144 -0
  626. package/packs/usgs/endpoints.json +313 -0
  627. package/packs/usgs/policy.json +95 -0
  628. package/packs/usgs/source.md +96 -0
  629. package/packs/usitc/endpoints.json +74 -0
  630. package/packs/usitc/policy.json +111 -0
  631. package/packs/usitc/source.md +90 -0
  632. package/packs/uspto/endpoints.json +141 -0
  633. package/packs/uspto/policy.json +95 -0
  634. package/packs/uspto/source.md +101 -0
  635. package/packs/va/endpoints.json +414 -0
  636. package/packs/va/policy.json +101 -0
  637. package/packs/va/source.md +129 -0
  638. package/packs/world-bank/endpoints.json +122 -0
  639. package/packs/world-bank/policy.json +101 -0
  640. package/packs/world-bank/source.md +93 -0
@@ -0,0 +1,199 @@
1
+ # Analysis and report patterns (every source)
2
+
3
+ Use this file to frame the analysis, choose the critical questions, and shape the product. The aim is work
4
+ a careful analyst at a statistical or policy agency would recognize: the right measure, the right period,
5
+ stated units and dollar basis, numbers that tie to the published source, every number traceable to a cell,
6
+ and limitations stated plainly. It holds only cross-source guidance. Each pack's `source.md` adds its own
7
+ measures, traps and benchmarks ("Data format and traps"), and deep packs keep longer notes in `docs/`:
8
+ read those for the sources a question uses (treasury: stocks and flows of the budget; bls and fred:
9
+ growth measures, vintages, seasonal adjustment; bea: chained dollars and revisions; ipums: weights,
10
+ universes, replicate standard errors; opm: redaction of pay and location).
11
+
12
+ ## 1. Critical questions bank
13
+
14
+ Ask only the ones the request leaves open **and** that would change a headline number: at most four, in one
15
+ round, with "Don't know — decide for me" on each and the recommended option first. A source's
16
+ `questions_to_ask` (from `source_brief`) names the questions specific to it; merge them with these and keep
17
+ the four that matter most.
18
+
19
+ Each question has exactly one "Don't know" option, never a separate "Skip". A skipped or unanswered
20
+ question is a "Don't know" and is decided by the rule in the last column. The exception is a blocking
21
+ question about what the user means (which program, place or population): ask it once more, then take the
22
+ literal reading and say so first. Record every question, its answer and its resolution with
23
+ `record_decisions` (`questions`; it writes them to `decisions.json`).
24
+
25
+ | Choice | Ask when | Options (recommended first) | How to decide when the user does not know |
26
+ |---|---|---|---|
27
+ | **Which measure** | two or more published measures answer the question | the measure the question's institution uses · the alternative | Use the measure the relevant agency or law uses (PCE price index for macro inflation, CPI-W for Social Security COLAs, debt held by the public for economic analysis, budget-basis series for budget questions); report the other as a sensitivity |
28
+ | **Period basis** | annual figures | Calendar year · Federal fiscal year (October to September) | Budget amounts: fiscal years, with fiscal-year GDP for shares of GDP. Economic and survey series: calendar years |
29
+ | **Time span** | the request names no years | last 10 complete years · since a business-cycle peak · longest available | 10 complete years; for a change over "the past N years", compare endpoints N years apart and name the years. A partial latest year only as "year to date" against the same months a year earlier |
30
+ | **Dollar basis** | comparisons across more than about 3 years | Nominal · Real (named index, latest full year's dollars) · Share of GDP | Nominal for levels people quote, plus real or share of GDP when growth over a decade is the point; run both and say whether the conclusion changes |
31
+ | **Growth measure** | annual growth of output or prices | Q4 over Q4 · annual average over annual average · quarterly annualized · year over year | Q4 over Q4 for annual growth of GDP and inflation; annual averages for rates; quarterly annualized for the latest quarter; name the measure every time |
32
+ | **Frequency conversion** | the sources differ in frequency | average · end of period · sum | Rates and prices: average. Stocks (debt, balances, headcount): end of period. Flows: sums of complete periods only (`compute`'s `to_fiscal` flags incomplete years) |
33
+ | **Vintage** | the question is about what was known at a time, or about revisions | latest · as published on a date · first release | Latest, unless the timing matters; then the vintage just before that date, and say so |
34
+ | **Seasonal adjustment** | monthly or quarterly series | SA · NSA | SA for short-run changes and charts; NSA for 12-month changes and annual averages where the agency does so |
35
+ | **Population or universe** | survey and administrative microdata | the published universe · a narrower group | The universe of the benchmark publication (for example civilian noninstitutionalized people age 16 or older); prime-age work uses ages 25 to 54 |
36
+ | **Geography** | places are compared | states · counties · metro areas | The finest level with reliable estimates; say which vintage of boundaries |
37
+ | **Product** | the user did not ask for a report | Short answer + data (default) · Full HTML report · Data files only | The default; offer the report in one line |
38
+ | **Audience and organization** | a report is wanted | Neutral analyst product · Named organization | Neutral unless the user names one |
39
+
40
+ Not critical (decide and record them in the methods): CSV vs JSON, field selection, chart type, rounding,
41
+ the exact endpoint when two give identical published totals, series IDs (resolve them with the
42
+ `request_schema` search).
43
+
44
+ ## 2. Conventions
45
+
46
+ **Periods and timing**
47
+ - The federal fiscal year runs October 1 to September 30 and is named for the year it ends. Write "fiscal
48
+ year 2025" in prose and "FY2025" only in tables and charts (`compute`'s `fiscal_year` and `to_fiscal`).
49
+ - Say how current the data are: "data through September 2026, retrieved October 20, 2026". The report
50
+ builder adds each source's retrieval date and vintage (the Data Vintage block); the methods say which
51
+ release the estimates come from.
52
+ - Survey income questions often refer to the previous calendar year (CPS ASEC 2023 = 2022 income); check the
53
+ pack's traps before labeling years.
54
+
55
+ **Stocks, flows and rates**
56
+ - Stocks (debt, cash, headcount): end-of-period value or period average, never a sum. Flows (receipts,
57
+ outlays, hires): sums of complete periods; never sum year-to-date values across months.
58
+ - Rates: define the numerator, denominator and universe at first use. Differences of rates are in
59
+ percentage points (the `pp` and `pp100` formats).
60
+ - Annualized rates: quarterly growth at an annual rate is `(Q_t/Q_{t-1})^4 - 1`. Levels already at an
61
+ annual rate (SAAR) are not multiplied by four; a fiscal-year GDP is the mean of four quarterly values.
62
+
63
+ **Units and signs**
64
+ - Read every source's units from its data dictionary or series table (thousands, millions, an index, a
65
+ percent). Convert once, in a `compute` step, and name the unit in every exhibit subtitle.
66
+ - Pick one sign convention for deficits and changes and state it in the notes.
67
+ - Use the fact formats for scale (`usd_b`, `from_millions:dollars_b`, `kmillions`; the `facts` tool lists
68
+ them) rather than dividing by hand.
69
+
70
+ **Real dollars**
71
+ - Deflate with a named price index over the same period basis as the values, into the dollars of the latest
72
+ complete period (`compute`'s `deflate`); name the index and base year in the notes.
73
+ - Chained-dollar components do not add to their totals: compute shares in nominal terms.
74
+
75
+ **Combining sources** (`compute` verbs)
76
+ - Before any join, an `align_check` step (keys, units): the same keys, the same period basis, units named.
77
+ State codes through the `state_codes` step, never by hand.
78
+ - One source per measure: when two sources publish the same measure, say which one is used and why; do not
79
+ splice them into one series without a break note.
80
+ - `compute` records each exhibit's lineage when it saves `exhibits/<name>.csv` (pass `packs` when the inputs
81
+ do not show the sources); give facts a `pack` when several sources are in the folder. The audit checks that
82
+ every lineage and fact pack is a source of the report.
83
+
84
+ **Revisions and provenance**
85
+ - Agencies revise: payroll benchmarks, seasonal factors, GDP vintages, survey reweighting, file versions.
86
+ Record the retrieval date (each `data/<id>/request.json` has it) and note revisions when a comparison
87
+ spans releases. Register preliminary, projected or past-vintage values in `facts` with `preliminary: true`,
88
+ `projection: true` or `vintage` and say so where they are cited (the audit enforces it).
89
+ - Never present a projection as data; cite it as the projecting agency's.
90
+
91
+ **Precision and suppression**
92
+ - Survey estimates: weight them (the pack names the weight), keep unweighted cell sizes, and suppress or
93
+ footnote cells below the pack's threshold. Say whether differences that drive conclusions are large
94
+ relative to sampling error. This server has no survey-weight or replicate standard-error helpers yet:
95
+ report which weight was used and that standard errors were not computed, unless the pack publishes them.
96
+ - Administrative files with redaction (withheld pay or location): report coverage and say how the
97
+ estimates treat redacted records; the pack's audit hooks require it.
98
+
99
+ **Correlation, not cause**
100
+ - An event "coincided with" a change unless a method that supports a causal claim was used. No forecasts
101
+ of your own; cite other forecasts as theirs.
102
+
103
+ ## 3. Benchmarks and checks
104
+
105
+ - **Benchmark every headline number** against a published figure from the source (the release table, the
106
+ statement of record, the agency's own derived series) and save each comparison in `exhibits/benchmark.csv`
107
+ (measure, period, computed, published, source, URL, accessed date). Say "matches" only for rows in that
108
+ file; a source not opened is "not checked". A difference above rounding means a filter, units or
109
+ period-basis mistake.
110
+ - Components must add to their published totals; check internal identities when the downloaded table is
111
+ itself the total.
112
+ - Before writing: units (millions vs. billions), dates (fiscal-year end vs. start), the last date of every
113
+ series (a lagging series silently shortens a ratio), projections cut off, no silent conversion across a gap.
114
+ - **Evidence before judgment.** Each key definition and parameter goes in `record_decisions` → `assumptions`
115
+ with a basis, strongest first: `empirical` (estimated from the data with `compute`; the evidence names the
116
+ exhibit CSV or `{{fact}}`), `literature` (a published estimate), `precedent` (the agency's own practice),
117
+ both cited as an opened `[@ref]`, `user` (the user's answer), and only then `judgment`. A judgment call
118
+ states `why_not_empirical` and has a row in `exhibits/sensitivity.csv` (parameter, base, alternative,
119
+ headline_base, headline_alt, conclusion_changes). The audit fails anything weaker.
120
+ - **Literature.** Record each search (query, date, what it found) in `literature_search` and each opened
121
+ source in `references` (citation, url, accessed, `opened: true` once `cite` has saved the page), both with
122
+ `record_decisions`.
123
+ - **Data that would improve the estimates.** `data_needs` names the data that would replace each judgment
124
+ call or unchecked benchmark: `data`, `improves`, `effect`, `how_to_get`, `from_user`. The builder lists them
125
+ in Appendix A, and the quick answer gives the top three. `[]` with a `data_needs_note` when none would help.
126
+ - Quick answers pass the same gate: `audit_answer` with `online: true` and `rerun: true`.
127
+
128
+ ## 4. Numbers, facts and the audit
129
+
130
+ - Every number in the prose is a `{{fact}}` registered with `facts` (saved in `facts.json`), a year, or
131
+ listed in `audit_allow` (`record_decisions`) with a reason. Facts read their value back from the saved CSV
132
+ cell; derived facts state their derivation; each fact records its source pack.
133
+ - `build_report` fills the placeholders; `audit_report` with `rerun: true` is the release gate. Fix every
134
+ FAIL before handing anything over; the style score is returned, never written into the report.
135
+
136
+ ## 5. Publication structure (`build_report`, `"mode": "report"`)
137
+
138
+ The default layout, the **exhibit chartbook**, runs in this order:
139
+ 1. **Cover:** "Month Year", the title (with the period for trend reports), and a hero chart with its own
140
+ title and unit label.
141
+ 2. **At a Glance** (about 300 to 420 words): one framing paragraph (what was examined, the measures or
142
+ population, the period), then 3 to 5 bullets, each opening with a **bold lead phrase.** that names a
143
+ section, followed by 2 to 4 sentences with the key numbers.
144
+ 3. **Contents** and **List of Exhibits** (built automatically, grouped by section).
145
+ 4. **Notes About This Report:** calendar or fiscal years; rounding; seasonal adjustment; nominal or real
146
+ dollars (index and base year); the data sources, retrieval dates and vintages; key definitions;
147
+ recession shading; partial-period coverage; where the data are posted.
148
+ 5. **Introduction:** a lead paragraph with the headline numbers; question-style subheadings, one per section
149
+ ("How Did Interest Costs Change?"); then "What Data Were Used?" and, when updating earlier work, "How Do
150
+ These Estimates Compare With Published Figures?".
151
+ 6. **Thematic sections** (2 to 5): each opens with 1 to 3 summary paragraphs, then one exhibit per page with
152
+ 2 to 4 narrative paragraphs beside the chart (level, change, comparison; "see Exhibit 3"). Below each
153
+ chart: the data source line, then the notes, then lettered notes.
154
+ 7. **Appendix A: Data and Methods:** the request, sources and rows used, filters, cut-off dates, universes and
155
+ weights, period basis, deflator, benchmarks, revisions and vintages, limitations. The builder adds the
156
+ Data Vintage block, the assumptions table, the data files, the citation and every required notice.
157
+ Optional **Appendix B, C ...** (definitions, a glossary).
158
+ 8. **References**, then **About This Document** (who asked, who prepared it, with what data and tools, the
159
+ reviewers if any, the date).
160
+ 9. Supplementary: **Replication Materials** (the ZIP and the embedded code) and the **Audit Trail**
161
+ (provenance per source, checksums, the source cell and source pack of every number).
162
+
163
+ Use `"mode": "paper"` for a prose-led product with the exhibits in the running text. Long-form reports with
164
+ chapters and boxes are not built; adapt the chartbook instead.
165
+
166
+ ## 6. Data files and redistribution
167
+
168
+ Each source's policy decides what leaves the analysis folder (the builder applies it, the audit enforces it):
169
+ - `allowed` (public domain, open licence): the data go into the replication package as retrieved.
170
+ - `aggregates_only`: tables of estimates go in; row-level files (the policy's `microdata_globs`) stay local.
171
+ - `definition_only` (IPUMS-style terms): no data file leaves; the package carries the request definition and
172
+ `reproduce/<id>/`: `download_<id>.sh` / `.ps1` (one command downloads the data under the reader's own
173
+ account: the request is built in and the key is asked for with hidden input), the request (`spec.json`, IPUMS
174
+ `extract_spec.json`) and `REPRODUCE.md` (the commands, then `ingest` and `rerun` with this server). The page
175
+ attaches all of them with Download buttons. The page never links the extract.
176
+ - `withhold` (for example FRED series whose copyright is not cleared): their rows are dropped from shared
177
+ files, and each one needs a `clearance` entry in report.json with its basis (`"redistribute": true` only
178
+ when the owner's terms or permission allow it).
179
+ - Data files over 50 MB stay out of the package with a note; they can be downloaded again.
180
+ Exhibit CSVs are aggregates and ship with the product unless a source's audit hook forbids them.
181
+
182
+ ## 7. Chart forms
183
+
184
+ - Trends over time: line charts with at most 4 to 5 series (facet rather than drawing 8 lines). A line chart
185
+ with an ISO `date` column gets a real date axis, so gaps show; `"recessions": true` shades
186
+ `exhibits/recessions.csv`. Trailing-12-month lines suit very seasonal monthly flows.
187
+ - Group comparisons at a point in time: grouped columns, or horizontal bars when labels are long; sort them.
188
+ - Composition: horizontal bars for one period; stacked columns over time with at most about 6 groups plus
189
+ "Other".
190
+ - Deficits and other signed values: columns with the sign convention stated.
191
+ - No dual axes, no pie charts, no 3-D. Scale amounts in the exhibit CSV and name the unit in the subtitle.
192
+
193
+ ## 8. Reading publications that block scripts
194
+
195
+ Some publishers refuse scripts and the in-app browser (HTTP 403, a bot check). Fetch
196
+ `https://web.archive.org/web/<year>/<full url>` and extract the text (a PDF needs a PDF text reader;
197
+ `cite` saves the snapshot for the references). If the plain year
198
+ URL returns HTML, use a CDX timestamp with `id_` (for example
199
+ `https://web.archive.org/web/20240430034127id_/<url>`). Cite the original URL.
@@ -0,0 +1,171 @@
1
+ # Routing: which sources answer which questions
2
+
3
+ Generated from each pack's policy.json.
4
+
5
+ Split the question into measures, give each its source, then read only those packs' source.md.
6
+ Use `find_sources` with the question for a ranked suggestion.
7
+
8
+ ## Usual pairings
9
+
10
+ | Question | Primary | Cross-check / context | Note |
11
+ |---|---|---|---|
12
+ | An address or a point to census geographies (FIPS, tract, district) | census-geocoder | census, cdc, hud, fema | Geocode first, then join by FIPS code; match the geography vintage to the data's year. |
13
+ | Federal debt, deficit, interest costs | treasury | bea, fred, cbo publications via govinfo | Debt and deficits from Treasury (MTS, Debt to the Penny); GDP from BEA (fiscal-year GDP from quarters) for shares. |
14
+ | Market interest rates, yield curve | treasury-yields | fred | Treasury par yields; FRED for long histories and policy rates. Average rates on outstanding debt are in treasury. |
15
+ | GDP, income, consumption, PCE inflation | bea | fred | BEA is the producer; FRED for vintages (ALFRED). |
16
+ | Jobs, unemployment, payrolls, JOLTS | bls | dol, fred | BLS CPS/CES/JOLTS; DOL weekly UI claims; FRED for long series. |
17
+ | Consumer prices, inflation, real dollars | bls | bea, fred | CPI-U from BLS; PCE price index from BEA; name the deflator. |
18
+ | Wages and earnings | bls | ipums, opm | BLS ECI, CES, OEWS; IPUMS CPS/ACS for distributions by group (weighted, with SEs). |
19
+ | Federal workforce: headcount, hires, separations, pay | opm | bls, ipums, usaspending | OPM FWD (coverage gaps: USPS, intelligence agencies; pay withheld for ~45% of records); BLS ECI or IPUMS for private comparisons. |
20
+ | Demographics, poverty, income by place | census | ipums, bea | ACS tables with margins of error; ACS PUMS (census) or IPUMS microdata for custom tabulations; BEA regional income. |
21
+ | Custom tabulations from recent ACS or CPS microdata | census | ipums, bls | ACS PUMS (2004 on, PWGTP1-80 replicate SEs), CPS basic monthly (1989 on) and ASEC (1992 on; 160 replicate SEs from 2005) from Census, public domain; IPUMS for harmonized codes across years, CPI99, CPS panels, earlier years. |
22
+ | Custom tabulations from survey microdata: long series, NHIS, MEPS, ATUS, historical censuses | ipums | census, bls | IPUMS CPS/ACS/decennial, NHIS, MEPS; weighted estimates with SEs; microdata never redistributed. SIPP through census. |
23
+ | Income and program participation month to month (SNAP, SSI, Medicaid, coverage spells) | census | ipums, medicaid | SIPP microdata (person-months; weight by WPFINWGT; reference year = file year - 1). |
24
+ | Federal budget by account or function, historical tables, credit subsidy rates | omb | treasury, usaspending | OMB Historical Tables and Public Budget Database by budget edition (each revises history); Treasury MTS for actual monthly totals. |
25
+ | Social Security and Medicare trust funds, national health spending projections | actuaries | treasury, cms, medicaid | Trustees Reports (intermediate assumptions) and CMS NHE; SSA tables by manual download. |
26
+ | Medicaid and CHIP enrollment, spending, drug use | medicaid | cms, census | data.medicaid.gov; preliminary vs updated rows; recent CMS-64 expenditure reports are manual downloads. |
27
+ | Income tax returns, AGI and migration by state, county, ZIP code | irs-soi | census, bea | SOI amounts in thousands; tax year vs filing year; small cells suppressed. |
28
+ | State and local government taxes, finances, pensions | census | pbgc, bea | Census QTAX (quarterly) and annual government finances; fiscal years differ by government. |
29
+ | Imports, exports, tariffs and customs duty | census | usitc, treasury, world-bank | Census international trade by HS code with calculated duty; USITC HTS for statutory rates by line; Treasury MTS customs duties for receipts. |
30
+ | Economic forecasts and forecast benchmarks | philfed | fred, usda-outlook | SPF and Greenbook (5-year lag) forecasts; USDA WASDE and baseline for agriculture. |
31
+ | Household balance sheets, consumer credit, bank lending surveys | fed-board | fred, nyfed | Fed Board Z.1, G.19, SLOOS, SCF; FRED for single-series histories. |
32
+ | Farm income, crop supply and demand outlook | usda-outlook | usda-nass | WASDE projections, ERS farm income forecasts, USDA baseline; NASS for survey estimates. |
33
+ | Immigration: green cards, naturalizations, refugees, enforcement | dhs-ohss | census | OHSS Yearbook by fiscal year; counts are events, not people. |
34
+ | Veterans: population, benefits, VA spending by place | va | census, usaspending | VetPop is a projection model; GDX for expenditures by state and district. |
35
+ | Student loans: portfolio, delinquency, repayment plans, volume by school | fsa | college-scorecard, treasury | FSA data center (.xls); recipients are not additive across programs. |
36
+ | Private pension insurance | pbgc | fed-board | PBGC data tables; single- and multiemployer programs are separate. |
37
+ | House prices and conforming loan limits | fhfa | fred, hud | FHFA HPI flavors differ; loan limits by county and units. |
38
+ | Unemployment insurance trust funds | dol | treasury | ETA 2112 state trust fund flows and balances; Treasury for Title XII advances and federal accounts. |
39
+ | TANF and child care program spending and caseloads | acf | usaspending, census | ACF files are manual downloads (the site refuses scripts). |
40
+ | Health insurance, access to care, health care spending by group | ipums | census, cdc, cms | IPUMS NHIS (insurance, access, conditions) and MEPS (spending by payer); ACS tables for state coverage; CMS for Medicare program data. |
41
+ | Federal spending by agency, program, place, recipient | usaspending | treasury, census | Obligations vs outlays differ; Treasury MTS for totals; Census population (not USAspending's) for per-person figures. |
42
+ | Legislation, votes, laws, CRS reports | congress | govinfo, federal-register | Congress.gov for bills and actions; GovInfo for text and CBO/committee reports; Federal Register for rules. |
43
+ | Regulations and rulemaking | federal-register | regulations, govinfo | Rules and notices; Regulations.gov for dockets and comments. |
44
+ | Campaign finance and lobbying | fec | senate-lobbying | FEC contributor data may not be used to solicit. |
45
+ | Energy production, prices, consumption | eia | bls, fred | EIA series; CPI energy components from BLS. |
46
+ | Health outcomes and mortality | cdc | census, cms | CDC counts and rates; age-adjust before comparing places; Census for denominators. |
47
+ | Health care providers, Medicare | cms | open-payments, cdc | CMS provider data and Medicare datasets; Open Payments shows industry payments, not wrongdoing. |
48
+ | Drugs, devices, recalls | fda | clinical-trials, nih | Adverse-event reports are not incidence rates. |
49
+ | Research funding and trials | nih | clinical-trials | NIH RePORTER projects; ClinicalTrials.gov registrations. |
50
+ | Banks and consumer finance | fdic | cfpb, fred | FDIC institution data; CFPB complaints are not representative. |
51
+ | Company financials and filings | sec | fred | EDGAR XBRL facts; SEC asks for a contact User-Agent. |
52
+ | Housing costs and assistance | hud | census, fred | HUD FMRs and income limits; ACS rents and values. |
53
+ | Agriculture | usda-nass | bls, world-bank | NASS Quick Stats. |
54
+ | SNAP, WIC and school meals: participation, costs, state policy options | usda-fna | census, usaspending | FNA Program Data (monthly, by state); SNAP State Options Report; State Activity Reports (FY 2019-2023 tidy). |
55
+ | Characteristics of SNAP households: income, earnings, children, elderly, benefit amounts | snapqc | usda-fna, ipums | SNAP QC public-use microdata (FY 2014 on), weighted with FYWGT; caseload totals from usda-fna; IPUMS CPS/ACS for SNAP-reporting households. |
56
+ | Transportation | bts | nhtsa | BTS statistics; NHTSA for vehicle safety. |
57
+ | Environment, air and water quality | epa | epa-aqs, usgs, noaa | EPA envirofacts/ECHO; AQS monitor data; USGS water. |
58
+ | Weather and climate | noaa | nws | NOAA NCEI history; NWS is forecasts and the last week of observations only. |
59
+ | Earthquakes, water, hazards | usgs | fema | USGS events and water; FEMA declarations and claims. |
60
+ | Disasters and insurance | fema | usaspending, census | Declarations, NFIP, public assistance. |
61
+ | Crime and justice | fbi | doj-news, census | NIBRS transition: participation changed sharply in 2021. |
62
+ | Higher education | college-scorecard | naep, census | Scorecard institution data. |
63
+ | K-12 achievement | naep | census | NAEP estimates have standard errors; test significance. |
64
+ | Federal contracting labor rates | gsa-calc | usaspending | CALC+ ceiling rates. |
65
+ | Food composition and nutrients | usda-fooddata | cdc | FoodData Central; one row per food and nutrient. |
66
+ | Patents and trademarks | uspto | sec | USPTO Open Data Portal (key needs a USPTO.gov account). |
67
+ | Renewable energy resources | nrel | eia | NREL resource and incentive data. |
68
+ | International comparisons | world-bank | bea, fred | World Bank indicators: check currency and base year. |
69
+ | Long histories, many indicators at once, data vintages | fred | the producing agency's pack | FRED re-publishes; cite the original source too; ALFRED for as-of vintages. |
70
+
71
+ ## Use instead
72
+
73
+ Questions a pack does not answer, and the pack that does (each pack's policy.json `use_instead`).
74
+
75
+ | Not in | Question | Use | Why |
76
+ |---|---|---|---|
77
+ | bea | CPI, jobs, unemployment, wages by occupation | bls | BLS produces these. |
78
+ | bea | Budget data by fiscal year | treasury | Treasury Fiscal Data. |
79
+ | bea | Market interest rates | treasury-yields | Daily Treasury yields. |
80
+ | bls | PCE prices, GDP, personal income | bea | BEA produces the national accounts. |
81
+ | bls | Worker microdata for custom groups | ipums | IPUMS CPS with weights and SEs. |
82
+ | bls | Federal civilian employees | opm | OPM's Federal Workforce Data. |
83
+ | census | Monthly unemployment and payroll jobs | bls | BLS produces both. |
84
+ | census | GDP and personal income by state | bea | BEA regional accounts. |
85
+ | census | Microdata series harmonized across decades, ASEC standard errors before 2005, NHIS, MEPS or historical censuses | ipums | IPUMS codes each variable the same way across years and carries ASEC replicate weights for every year; ACS PUMS and single CPS files (ASEC replicates from 2005) come from this pack. |
86
+ | census | International comparisons | world-bank | World Bank indicators across countries. |
87
+ | census | Federal spending by state | usaspending | USAspending awards by place of performance. |
88
+ | cfpb | Bank financial condition or failures | fdic | FDIC BankFind holds call-report financials and the failed-bank list. |
89
+ | cfpb | Company financial statements | sec | EDGAR XBRL company facts. |
90
+ | cfpb | Auto safety complaints | nhtsa | NHTSA vehicle safety complaints, not consumer-finance complaints. |
91
+ | fed-board | One Board series' long history or its past vintages | fred | FRED mirrors most Board series; ALFRED keeps vintages. |
92
+ | fed-board | SOFR, EFFR, SOMA holdings, primary dealer positions | nyfed | The New York Fed publishes these. |
93
+ | fed-board | Forecasts of these series | philfed | SPF and Greenbook forecasts. |
94
+ | fed-board | Bank-level balance sheets and income | fdic | FDIC institution financials. |
95
+ | fhfa | One FHFA house price series for the U.S. or a state, with no index flavor choice | fred | FRED carries the all-transactions and purchase-only HPI series under stable IDs. |
96
+ | fred | BLS detail with preliminary flags, footnotes and gaps | bls | The bls pack keeps BLS's own flags. |
97
+ | fred | BEA tables with line numbers and vintages | bea | The bea pack reads BEA tables as published. |
98
+ | fred | Treasury daily statements and auctions | treasury | Treasury Fiscal Data. |
99
+ | ipums | A tabulation from one or a few recent ACS PUMS years, one CPS month or one CPS ASEC year (standard errors from 2005 on) | census | The census pack serves the same Census files with the census key, in seconds, public domain (shareable), with ACS PUMS replicate weights and the ASEC's from Census's replicate weight file. |
100
+ | treasury | Market yields and the daily par yield curve | treasury-yields | Daily Treasury par yield curve rates. |
101
+ | treasury | Historical budget tables in percent of GDP, the President's budget | omb | OMB Historical Tables by budget edition. |
102
+ | treasury | State and local government finances | census | Census government finance surveys. |
103
+ | usitc | Duties actually collected, import values and quantities by HS code and country | census | Census international trade reports import values and calculated duty; the HTS gives the statutory rates only. |
104
+ | usitc | Total customs duties received by the Treasury, monthly or by fiscal year | treasury | The Monthly Treasury Statement reports customs duty receipts. |
105
+
106
+ ## All sources
107
+
108
+ | Source | Depth | Key | Domains | Title |
109
+ |---|---|---|---|---|
110
+ | acf | standard | none | welfare, cash assistance, child care, safety net, state spending, federal grants to states | HHS Administration for Children and Families program data (TANF financial and caseload data, CCDF expenditures) |
111
+ | actuaries | standard | none | social security, medicare, health spending, entitlement programs, long-term fiscal outlook | Social Security and Medicare Trustees Reports and National Health Expenditure data (SSA and CMS actuaries) |
112
+ | bea | deep | required (BEA_API_KEY) | economy, national accounts, income, regional economy, international trade | Bureau of Economic Analysis (BEA) Data API and bulk files |
113
+ | bls | deep | optional (BLS_API_KEY) | labor, employment, prices, inflation, wages, productivity | Bureau of Labor Statistics Public Data API |
114
+ | bts | standard | none | transportation, freight, travel | Bureau of Transportation Statistics Open Data (data.bts.gov) |
115
+ | cdc | standard | none | health, mortality, public health | CDC Open Data (data.cdc.gov) |
116
+ | census | standard | required (CENSUS_API_KEY) | demographics, population, income, housing, poverty, education, program participation, international trade, state and local government finance, economic indicators, survey microdata | Census Bureau Data API (ACS, decennial census, population estimates, SIPP, economic indicators, international trade, government finances) |
117
+ | cfpb | standard | none | finance, consumer protection | CFPB Consumer Complaint Database |
118
+ | clinical-trials | standard | none | health, clinical research | ClinicalTrials.gov (API v2) |
119
+ | cms | standard | none | health, health care, medicare | CMS Provider Data and Medicare data (data.cms.gov) |
120
+ | college-scorecard | standard | optional (DATA_GOV_API_KEY) | education, higher education, student debt | College Scorecard (U.S. Department of Education) |
121
+ | congress | standard | optional (DATA_GOV_API_KEY) | legislation, congress, votes | Congress.gov API (Library of Congress) with House and Senate roll-call votes |
122
+ | dhs-ohss | standard | none | immigration, demographics | DHS Office of Homeland Security Statistics: Yearbook of Immigration Statistics |
123
+ | doj-news | standard | none | justice, law enforcement, news releases | Department of Justice News (justice.gov press releases and blog) |
124
+ | dol | standard | optional (DOL_API_KEY) | workplace safety, labor enforcement, unemployment insurance, labor, unemployment trust fund | Department of Labor (DOL Open Data API: OSHA, WHD, ETA unemployment claims, MSHA; OUI unemployment insurance trust fund files) |
125
+ | eia | standard | optional (EIA_API_KEY) | energy, prices, environment | EIA Open Data API v2 (U.S. Energy Information Administration) |
126
+ | epa | standard | none | environment, pollution, regulation, enforcement | EPA Envirofacts and ECHO (TRI, GHGRP, SDWIS, Superfund, compliance and enforcement) |
127
+ | epa-aqs | standard | required (AQS_API_KEY) | environment, air quality, health | EPA Air Quality System (AQS) Data Mart API |
128
+ | fbi | standard | optional (DATA_GOV_API_KEY) | crime, justice, public safety, policing | FBI Crime Data Explorer (UCR, NIBRS, hate crime, arrests, police employees) |
129
+ | fda | standard | optional (DATA_GOV_API_KEY) | health, drugs, medical devices, food safety | openFDA (api.fda.gov) |
130
+ | fdic | standard | none | finance, banking | FDIC BankFind Suite API |
131
+ | fec | standard | optional (DATA_GOV_API_KEY) | elections, campaign finance, legislation | OpenFEC (Federal Election Commission API) |
132
+ | fed-board | standard | none | household finance, credit, financial accounts, wealth, banking, monetary policy | Federal Reserve Board data (Data Download Program releases, Z.1 Financial Accounts, Survey of Consumer Finances) |
133
+ | federal-register | standard | none | legislation, regulation, executive actions | Federal Register (federalregister.gov API) |
134
+ | fema | standard | none | disasters, emergency management, housing, insurance, federal spending | OpenFEMA (FEMA open data API) |
135
+ | fhfa | standard | none | housing, house prices, mortgage finance | FHFA House Price Index, conforming loan limits and Public Use Databases (fhfa.gov files) |
136
+ | fred | deep | optional (FRED_API_KEY) | economy, finance, federal budget, prices, interest rates, revisions | FRED, ALFRED and GeoFRED (Federal Reserve Bank of St. Louis) |
137
+ | fsa | standard | none | education, student loans, federal credit, higher education finance | Federal Student Aid Data Center (student loan portfolio, Title IV volume by school) |
138
+ | govinfo | standard | optional (DATA_GOV_API_KEY) | legislation, regulation, government publications | GovInfo (Government Publishing Office API) |
139
+ | gsa-calc | standard | none | federal procurement, contracting, labor rates | GSA CALC+ Labor Ceiling Rates (Quick Rate API) |
140
+ | hud | standard | required (HUD_USER_TOKEN) | housing | HUD Fair Market Rents and Income Limits API (HUD User) |
141
+ | ipums | deep | required (IPUMS_API_KEY) | labor, earnings, income, poverty, demographics, immigration, health insurance, health care spending, access to care, survey microdata | IPUMS microdata (USA/ACS, CPS and other collections) |
142
+ | irs-soi | standard | none | taxes, income, migration, geography | IRS Statistics of Income: individual income tax data by ZIP code, county, state and migration (irs.gov) |
143
+ | medicaid | standard | none | health, health care, medicaid, federal spending, prescription drugs | Medicaid and CHIP open data (data.medicaid.gov) |
144
+ | naep | standard | none | education, k-12, student achievement | NAEP, The Nation's Report Card (NAEP Data Service) |
145
+ | nhtsa | standard | none | vehicle safety, transportation, consumer protection | NHTSA Vehicle Safety APIs (recalls, complaints, NCAP ratings, vPIC) |
146
+ | nih | standard | none | health, research funding, science | NIH RePORTER (research grants) |
147
+ | noaa | standard | optional (NOAA_API_KEY) | weather, climate, environment | NOAA NCEI climate data (Access Data Service, Climate Data Online) |
148
+ | nrel | standard | optional (DATA_GOV_API_KEY) | energy, transportation, environment | NREL / NLR Developer APIs (alt fuel stations, utility rates, solar resource, PVWatts) |
149
+ | nws | standard | none | weather, emergency management | National Weather Service API (forecasts, alerts, observations) |
150
+ | nyfed | standard | none | monetary policy, interest rates, federal debt financing, financial conditions | New York Fed Markets Data API (reference rates, SOMA, Treasury operations, primary dealers) |
151
+ | omb | standard | none | federal budget, public finance, federal debt, federal credit | OMB President's Budget data (Historical Tables, Public Budget Database, Federal Credit Supplement) via GovInfo |
152
+ | open-payments | standard | none | health, health care, industry payments | CMS Open Payments (openpaymentsdata.cms.gov) |
153
+ | opm | deep | none | federal workforce, government employment, public sector pay, personnel | OPM Federal Workforce Data (FWD / EHRI) |
154
+ | pbgc | standard | none | pensions, retirement, social insurance | PBGC Pension Insurance Data Tables (single-employer and multiemployer programs) |
155
+ | philfed | standard | none | macroeconomic forecasts, economic outlook, inflation expectations, real-time data | Philadelphia Fed Real-Time Data Research Center (Survey of Professional Forecasters, Greenbook/Tealbook, Livingston Survey, Real-Time Data Set) |
156
+ | regulations | standard | optional (DATA_GOV_API_KEY) | legislation, regulation, rulemaking | Regulations.gov (API v4) |
157
+ | sec | standard | none | finance, corporations, securities | SEC EDGAR (XBRL financial data, filings, full-text search) |
158
+ | senate-lobbying | standard | optional (LDA_API_KEY) | legislation, lobbying, influence | Lobbying Disclosure (LDA.gov API) |
159
+ | snapqc | standard | none | nutrition assistance, social safety net, household microdata, program administration | SNAP Quality Control (QC) public-use microdata: characteristics of SNAP households (snapqcdata.net) |
160
+ | treasury | deep | none | federal budget, federal debt, public finance, spending, revenue | U.S. Treasury Fiscal Data (fiscaldata.treasury.gov) |
161
+ | treasury-yields | standard | none | interest rates, bond market, finance | Treasury Daily Interest Rate Statistics (home.treasury.gov) |
162
+ | usaspending | standard | none | spending, federal budget, procurement, grants | USAspending.gov API (federal awards and spending) |
163
+ | usda-fna | standard | none | nutrition assistance, social safety net, state policy, program administration, school meals | USDA Food and Nutrition Administration: SNAP, WIC and child nutrition program data, SNAP State Options Report and SNAP State Activity Reports |
164
+ | usda-fooddata | standard | optional (DATA_GOV_API_KEY) | nutrition, food, health, agriculture | USDA FoodData Central |
165
+ | usda-nass | standard | required (USDA_NASS_API_KEY) | agriculture, food | USDA NASS Quick Stats |
166
+ | usda-outlook | standard | none | agriculture, food, economy | USDA forecasts and projections (WASDE, ERS farm income forecasts, USDA Agricultural Baseline) |
167
+ | usgs | standard | optional (DATA_GOV_API_KEY) | natural hazards, earthquakes, water, environment | USGS earthquakes (ComCat) and Water Data (streamflow, groundwater) |
168
+ | usitc | standard | none | trade, tariffs, customs duties | USITC Harmonized Tariff Schedule (HTS REST API: duty rates by HTS line) |
169
+ | uspto | standard | required (USPTO_API_KEY) | patents, innovation, intellectual property, research | USPTO Open Data Portal (patent applications, PTAB, petitions, bulk datasets) |
170
+ | va | standard | none | veterans, federal spending, population projections, disability benefits | VA Open Data (data.va.gov) and NCVAS Veteran Statistics |
171
+ | world-bank | standard | none | international, economy, development, population, health, education | World Bank Indicators API (World Development Indicators and other databases) |