{"id":21407137,"url":"https://github.com/daveshap/postlaboreconomics","last_synced_at":"2026-02-07T04:31:57.357Z","repository":{"id":222117692,"uuid":"756287023","full_name":"daveshap/PostLaborEconomics","owner":"daveshap","description":"Public repository for Post-Labor Economics research data.","archived":false,"fork":false,"pushed_at":"2025-09-19T21:59:58.000Z","size":127187,"stargazers_count":111,"open_issues_count":0,"forks_count":23,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-09-20T00:21:02.635Z","etag":null,"topics":["ai","economics"],"latest_commit_sha":null,"homepage":"https://daveshap.github.io/PostLaborEconomics/","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/daveshap.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-02-12T11:14:55.000Z","updated_at":"2025-09-19T22:00:03.000Z","dependencies_parsed_at":"2025-05-11T00:23:08.326Z","dependency_job_id":"b31aa627-c7da-44fa-a2a2-681269cb3852","html_url":"https://github.com/daveshap/PostLaborEconomics","commit_stats":null,"previous_names":["daveshap/postlaboreconomics"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/daveshap/PostLaborEconomics","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daveshap%2FPostLaborEconomics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daveshap%2FPostLaborEconomics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daveshap%2FPostLaborEconomics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daveshap%2FPostLaborEconomics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daveshap","download_url":"https://codeload.github.com/daveshap/PostLaborEconomics/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daveshap%2FPostLaborEconomics/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29186736,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T03:35:06.566Z","status":"ssl_error","status_checked_at":"2026-02-07T03:34:57.604Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","economics"],"created_at":"2024-11-22T16:44:46.310Z","updated_at":"2026-02-07T04:31:57.344Z","avatar_url":"https://github.com/daveshap.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Post-Labor Economics (PLE) Triage Dashboard\n\n**A public, county-level early-warning system for the age when pay-checks stop anchoring prosperity.**\n\n[![License: Apache 2.0](https://img.shields.io/badge/Code%20License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![License: CC BY 4.0](https://img.shields.io/badge/Data%20License-CC%20BY%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)\n[![License: CC BY-ND 4.0](https://img.shields.io/badge/Docs%20License-CC%20BY--ND%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-nd/4.0/)\n*(Placeholder badges - update as needed)*\n\n---\n\n## Abstract\n\nThe United States is drifting toward an economy where local prosperity is no longer anchored solely to the pay-checks of people who live there. Automation (AI \u0026 Robotics), demographic shifts, and remote work are potentially uncoupling economic output from local labor demand. While national metrics like GDP or the unemployment rate provide a broad overview, they often lag behind or mask the crucial shifts happening at the community level. The first signs of economic distress – such as declining labor force participation, shrinking work hours, or rising dependence on transfers – often appear locally long before they dominate national headlines.\n\nThis project, grounded in the principles of Post-Labor Economics (PLE), aims to fill that critical information gap. The **PLE Triage Dashboard** provides an early-warning system by tracking key labor market indicators at the US county level. It fuses multiple publicly available data streams into a composite **\"Collapse Index\" (CI)**, designed to signal when a local labor market is decoupling from broader economic trends, potentially indicating structural stress related to automation or other deep shifts. This dashboard serves as the initial \"surveillance\" layer for the broader PLE framework, which ultimately aims to understand and improve local **Economic Agency** by analyzing the composition of household income (Wages vs. Property vs. Transfers). By making these trends visible and comparable across counties, this dashboard empowers local leaders, researchers, businesses, and citizens to diagnose challenges early and consider proactive interventions before crises fully manifest.\n\n*(Link to Live Dashboard: [Placeholder - e.g., labor-triage.netlify.app] - Coming Soon!)*\n*(Link to PLE Theory / Blog: [Placeholder - e.g., Your Substack/Website Link])*\n\n## The Problem: Lagging Indicators in a Fast-Changing Economy\n\nTraditional economic dashboards focus heavily on headline unemployment rates and GDP growth. While important, these metrics often fail to capture the early, structural shifts impacting local economies in the face of automation and changing work patterns:\n\n* **Wage Erosion:** Automation may suppress wages or reduce hours worked long before mass layoffs occur.\n* **Participation Decline:** Discouraged workers, particularly youth, may exit the labor force entirely (NEETs), which isn't reflected in the unemployment rate of those *actively seeking* work.\n* **Shifting Income Sources:** A community might maintain consumption levels temporarily through government transfers, masking an underlying erosion of earned income from wages or local business.\n* **Geographic Disparities:** National averages obscure significant variations between counties – some thriving, others entering structural decline unnoticed.\n\nWithout timely, granular, and compositionally-aware metrics, local communities lack the tools to proactively manage the transition to a potentially post-labor future.\n\n## The Solution: A County-Level Triage Dashboard\n\nThis project provides a transparent, reproducible dashboard focused on **early-warning indicators** of labor market stress at the US county level.\n\n* **Goal:** To provide an accessible \"heatmap\" identifying counties potentially experiencing early stages of labor market decoupling or decline, prompting further investigation and potential intervention.\n* **Approach:** Utilizes the \"Measure -\u003e Menu -\u003e Monitor\" concept central to PLE. This dashboard focuses on the **Measure** aspect for labor market health.\n* **Core Metric:** The **Collapse Index (CI)**, a composite score derived from several key labor market indicators.\n\n## Key Metrics \u0026 Interpretation\n\nThe dashboard tracks several Key Performance Indicators (KPIs), standardized and combined into the Collapse Index (CI):\n\n1.  **Employment-to-Population Ratio (E/Pop):** (Using total E/Pop from BLS LAUS initially). Measures the share of the population that is employed. A falling ratio indicates declining labor absorption.\n2.  **Average Weekly Hours:** (Using BLS CES/QCEW). A decline can signal reduced labor demand or a shift to part-time work, even if employment numbers hold steady.\n3.  **Youth NEET Rate (Proxy):** (Using ACS B14005). Tracks young adults (16-24) Not in Education, Employment, or Training. A rising rate signals youth disengagement or lack of entry-level opportunities.\n4.  **Labor Share of Income:** (Using BEA SAINC7). The proportion of total personal income derived from wages and salaries. A structural decline indicates productivity gains are accruing more to capital than labor.\n5.  **Part-Time for Economic Reasons Share (Proxy):** (Using state-level CPS data or LAUS underemployment). Indicates workers who want full-time work but can only find part-time hours due to economic conditions.\n6.  **Wage-to-Transfer Income Ratio:** (Using BEA SAINC7). Compares income earned from work to income received from government transfers. A falling ratio signals rising dependency.\n\n**Collapse Index (CI):** Calculated as the average of the standardized z-scores of the available KPIs for a given county and year ($CI = \\sum z_i / \\sqrt{k}$).\n* `CI \u003e 0`: Labor market generally healthier than the national average for that year.\n* `CI ≈ 0`: Tracking the national average.\n* `CI \u003c 0`: Labor market showing signs of stress relative to the national average; potential early warning for post-labor transition effects.\n\n**(Future Integration: Economic Agency Index - EAI)**\nWhile this dashboard focuses on *triage*, the core diagnostic metric of PLE is the **EAI**. It measures income *composition*:\n$EAI = z(\\% Earned) + z(\\% Property) - z(\\% Transfers)$\nThis will be integrated later to provide a deeper view of how counties are structured economically (reliance on work vs. ownership vs. external support).\n\n## Methodology \u0026 Data Sources\n\nThis project uses exclusively **public-domain data** from official US government sources. The Extract-Transform-Load (ETL) pipeline is designed to be run **offline** after initial manual download of required raw files, ensuring reproducibility and avoiding reliance on live API calls.\n\n* **Sources:**\n    * `BLS LAUS`: County-level employment, labor force (monthly/annual).\n    * `BLS CES/QCEW`: Average weekly hours, wages (monthly/quarterly).\n    * `BEA SAINC7`: County personal income components (Wages, Property, Transfers) (annual).\n    * `ACS B14005`: Youth school enrollment \u0026 employment status (annual 5-year estimates).\n    * `Census TIGER`: County boundaries/centroids (static).\n    * *(Future EAI)*: `IRS SOI` (county AGI data as backup).\n* **Pipeline:**\n    1.  Raw data files manually placed in `data/raw/`.\n    2.  `ingest/` scripts read raw files, perform basic cleaning/filtering, output to `data/interim/`.\n    3.  `kpi/` scripts read interim files, calculate specific KPI ratios/values, output to `data/processed/kpi_*.parquet`.\n    4.  `index/` script reads processed KPI files, calculates z-scores and the composite `collapse_index.parquet`.\n    5.  `dashboard/` script reads *only* processed parquet files for visualization.\n* **Tools:** Python 3.11+, Pandas, DuckDB, GeoPandas, Streamlit, PyDeck.\n\n## Dashboard Features \u0026 Interpretation\n\nThe dashboard aims to provide an intuitive view of county-level labor market health:\n\n* **National Heatmap:** Visualize the Collapse Index (or individual KPIs) across all US counties, typically using a green-to-red color scale.\n* **Time Slider:** Scrub through years (e.g., 1990-present) to observe historical trends and the propagation of economic shifts.\n* **County Drill-Down:** Click or search for a specific county to see its detailed KPI scorecard, historical sparklines, and percentile ranks compared to peers or the nation.\n* **Alerts:** Potential future feature to flag counties where multiple KPIs show sustained negative trends.\n\n**Interpretation:** A persistently low or rapidly falling Collapse Index suggests a county's labor market is under structural stress and may require deeper investigation and potentially interventions aimed at boosting economic agency (the focus of the EAI and the broader PLE framework).\n\n## Getting Started (Local Development)\n\n1.  **Clone the repository:** `git clone [Your Repo URL]`\n2.  **Create/activate a virtual environment** (optional but recommended).\n3.  **Install dependencies:** `pip install -r requirements.txt`\n4.  **Download Raw Data:** Manually download the required files listed in `etl_core.py` (it will prompt with URLs if files are missing) and place them in the `data/raw/` directory.\n5.  **Run the ETL pipeline:** `python build_triage.py` (or use `pipelines/run_all.sh/bat` if created). This generates files in `data/processed/`.\n6.  **Launch the dashboard:** `python -m streamlit run dashboard/dashboard_triage.py`\n7.  Open `http://localhost:8501` in your browser.\n\n*(See `etl_core.py` and `build_triage.py` for specific data requirements and processing steps).*\n\n## Contributing\n\nContributions are welcome! Please feel free to open an issue to report bugs, suggest features, or discuss methodology. Pull requests are encouraged for:\n\n* Adding new, validated KPIs to the triage dashboard.\n* Improving data ingestion robustness and error handling.\n* Enhancing dashboard visualizations and user experience.\n* Extending the framework to include EAI, CPP, and CCI calculations.\n* Adding international data sources (as a separate module).\n\n*(Placeholder: Add link to CONTRIBUTING.md if you create one)*\n\n## License\n\n* **Source Code:** Licensed under the [Apache License 2.0](LICENSE).\n* **Generated Data Artefacts (e.g., parquet files):** Licensed under [Creative Commons Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/).\n* **Methodology Documents / White Papers:** Licensed under [Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND 4.0)](https://creativecommons.org/licenses/by-nd/4.0/).\n* **Name \u0026 Logo:** \"Post-Labor Triage Dashboard\"™ and associated logos are trademarks of [Your Name/Org].\n\n## Contact \u0026 Citation\n\n* **Project Lead:** [Your Name / Link to your profile/Substack]\n* **Contact:** [Your Preferred Contact Email/Method]\n* **Suggested Citation:** Shapiro, David. (2025). *Post-Labor Economics Triage Dashboard (Version X.Y)*. [Link to GitHub Repo].\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaveshap%2Fpostlaboreconomics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaveshap%2Fpostlaboreconomics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaveshap%2Fpostlaboreconomics/lists"}