ROCC "Now" roadmap + Top-10 polish

.github/workflows/ci.yml

@@ -27,11 +27,37 @@ jobs:
       - name: Install development dependencies
         run: python -m pip install --disable-pip-version-check -r requirements-dev.txt
 
+      - name: Lint (ruff)
+        run: python -m ruff check .
+
       - name: Run tests
         run: python -m pytest -q
 
       - name: Validate deterministic synthetic data
         run: python scripts/validate_demo_data.py
 
+      - name: Dependency vulnerability scan (advisory)
+        continue-on-error: true
+        run: |
+          python -m pip install pip-audit==2.10.1
+          python -m pip_audit --strict --requirement requirements.txt
+
       - name: Build demo container
         run: docker build --tag rocc-demo:ci .
+
+      - name: Boot demo container and probe health
+        run: |
+          docker run -d --name rocc-ci -p 8501:8501 rocc-demo:ci
+          ok=0
+          for i in $(seq 1 30); do
+            if curl -fsS http://localhost:8501/_stcore/health >/dev/null 2>&1; then
+              ok=1; break
+            fi
+            sleep 2
+          done
+          docker logs rocc-ci || true
+          docker rm -f rocc-ci || true
+          if [ "$ok" -ne 1 ]; then
+            echo "container did not become healthy within 60s"; exit 1
+          fi
+          echo "container healthy"

.streamlit/config.toml

@@ -7,3 +7,6 @@ font = "sans serif"
 
 [server]
 headless = true
+
+[browser]
+gatherUsageStats = false

README.md

@@ -35,7 +35,11 @@ planning simulation, reports, and the privacy & governance statement.
 - Referral-source quality and cold-source tracking against real cadences.
 - Mass-push planning when new contracts approach (via a future GovCon Recompete
   Radar handoff).
-- Contract DLR trends and ODLH 75%-floor monitoring.
+- Contract direct-labor-ratio (DLR) trends and direct-labor-hours (ODLH) 75%-floor monitoring.
+
+> Acronyms: QDLH = Qualifying Direct Labor Hours, DLH = Direct Labor Hours,
+ratio = QDLH / DLH (the AbilityOne 75% requirement). A full glossary is on the
+Privacy & Governance page.
 
 ## Quickstart
 

app.py

@@ -61,6 +61,11 @@ def main() -> None:
     with st.sidebar:
         st.markdown("# ROCC — Recruiting & Outreach Control Center")
         st.caption("part of TENS HQ")
+        st.markdown("**Planning controls**")
+        scenario = st.selectbox("Scenario", ["Base", "Conservative", "Optimistic"])
+        target_pct = st.slider("Planning target", 70.0, 82.0, DEFAULT_TARGET * 100.0, 0.5)
+        st.caption("Site indicators are planning proxies. They are not official ODLH determinations.")
+        st.markdown("---")
         visible_pages = [page for page in PAGE_RENDERERS if page in allowed_pages()]
         _restore_and_clamp_navigation(visible_pages)
         page = st.radio(
@@ -74,11 +79,6 @@ def main() -> None:
             unsafe_allow_html=True,
         )
         st.markdown("---")
-        st.markdown("**Planning controls**")
-        scenario = st.selectbox("Scenario", ["Base", "Conservative", "Optimistic"])
-        target_pct = st.slider("Planning target", 70.0, 82.0, DEFAULT_TARGET * 100.0, 0.5)
-        st.caption("Site indicators are planning proxies. They are not official ODLH determinations.")
-        st.markdown("---")
         st.caption(f"Demo v{APP_VERSION} · Seed {DEFAULT_SEED}")
 
     st.query_params["nav"] = page

pyproject.toml

@@ -18,3 +18,10 @@ dev = ["pytest==8.4.1"]
 pythonpath = ["src"]
 testpaths = ["tests"]
 addopts = "-q"
+
+[tool.ruff]
+target-version = "py311"
+src = ["src"]
+
+[tool.ruff.lint]
+select = ["F", "E9"]

requirements-dev.txt

@@ -1,2 +1,3 @@
 -r requirements.txt
 pytest==8.4.1
+ruff==0.15.22

run_demo.ps1

@@ -20,7 +20,7 @@ if (-not (Test-Path -LiteralPath $VenvPython)) {
         $BasePython = $PythonCommand.Source
     }
     & $BasePython -m venv $VenvRoot
-    & $VenvPython -m pip install --disable-pip-version-check -r (Join-Path $ProjectRoot 'requirements-dev.txt')
+    & $VenvPython -m pip install --disable-pip-version-check -r (Join-Path $ProjectRoot 'requirements.txt')
 }
 
 & $VenvPython -m streamlit run (Join-Path $ProjectRoot 'app.py')

src/tens_hq/constants.py

@@ -214,3 +214,56 @@
     "psychological_evaluation",
     "disability_narrative",
 }
+
+COLUMN_LABELS = {
+    # identity / org
+    "organization_name": "Organization",
+    "organization_type": "Type",
+    "relationship_status": "Relationship",
+    "confidence_level": "Confidence",
+    # geography
+    "county_name": "County",
+    "state_code": "State",
+    "site_name": "Site",
+    # dates / contacts
+    "next_follow_up_date": "Next follow-up",
+    "activity_date": "Activity date",
+    "outreach_type": "Outreach type",
+    "outcome_code": "Outcome",
+    "contact_name": "Contact",
+    "contact_title": "Title",
+    "contact_email": "Email",
+    "preferred_channel": "Preferred channel",
+    # coverage / capability
+    "coverage_strength": "Coverage strength",
+    "verified_status": "Verified",
+    "job_family": "Job family",
+    "capability_level": "Capability level",
+    "evidence_source": "Evidence source",
+    # scores / risk
+    "partner_priority_score": "Partner priority",
+    "reliability_score": "Reliability",
+    "risk_status": "Risk",
+    "days_overdue": "Days overdue",
+    "suggested_next_action": "Suggested next action",
+    # source-performance rates
+    "referral_volume": "Referrals",
+    "hire_yield": "Hire yield %",
+    "eligibility_clearance_yield": "Clearance yield %",
+    "documentation_completion": "Docs complete %",
+    "retention_90": "90-day retention %",
+    # forecast columns
+    "current_ratio": "Current indicator",
+    "projected_ratio": "Projected indicator",
+    "direction": "Change",
+    "expected_attrition_fte": "Expected attrition (FTE)",
+    "pipeline_candidates": "Pipeline candidates",
+    "expected_ready_hires": "Projected pipeline arrivals",   # S4 reconciliation
+    "qualified_hiring_need": "Ready hires still needed",      # S4 reconciliation
+    "pipeline_coverage": "Coverage (arrivals / need)",        # S4 reconciliation
+    "open_roles_count": "Open roles",
+    # privacy inventory
+    "dataset": "Dataset",
+    "rows": "Rows",
+    "synthetic_flag_complete": "All rows synthetic",
+}

src/tens_hq/metrics.py

@@ -174,7 +174,6 @@ def forecast_sites(
     if scenario not in _SCENARIO_SETTINGS:
         raise ValueError(f"Unknown scenario: {scenario}")
     settings = _SCENARIO_SETTINGS[scenario]
-    as_of = pd.Timestamp(DATA_AS_OF_DATE)
     weeks = horizon_days / 7.0
     months = horizon_days / 30.4375