feat(voteballots): FEC adapter Phase 1 (Vote PoC Slice 1/6) by Foundup · Pull Request #707 · FOUNDUPS/Foundups-Agent

Foundup · 2026-05-24T08:56:50Z

Summary

Foundation contract for the Vote/Ballots PoC chain. Adds a deterministic, mockable FEC adapter boundary. Offline-by-default. Politically neutral. Non-persuasive. All downstream Vote PoC slices (entity resolution, funding summary, etc.) inherit this boundary.

Scope: 5 files

modules/foundups/voteballots/src/fec_adapter.py
modules/foundups/voteballots/src/__init__.py
modules/foundups/voteballots/tests/test_fec_adapter.py
modules/foundups/voteballots/ModLog.md
docs/audits/architecture/VOTE_POC_FEC_ADAPTER_PHASE1.md

No registry/catalog/manifest/projection mutation. No public route activation. No CI/dependency/WSP framework mutation.

Offline-by-Default Posture

Tests require no FEC API key
Tests perform no live network calls (no requests/urllib/httpx/aiohttp imports)
get_mock_adapter() provides deterministic fixture-backed adapter
Live mode declared but not implemented yet — fail-closed without credentials

Carry-Forward Contract (Stable for Slice 2)

Export	Status
`get_mock_adapter()`	STABLE
`CandidateSearchResult`	STABLE
`CandidateRecord`	STABLE
`FECErrorType`	STABLE

Error Model

FECError with FECErrorType enum covers: not_found, ambiguous, unavailable/API failure, rate limit, invalid query/input.

Political Safety Verified

No candidate recommendation
No persuasion language
No microtargeting fields
No foreign funding inference
No dark-money claims
No confidence beyond adapter data boundary

Two explicit tests guard this: test_no_persuasion_fields, test_no_targeting_fields.

Tests

python -m pytest modules/foundups/voteballots/tests/ -q
# 78 passed, 0 skipped

W10 Hygiene Patch

Original audit doc table header used Item. W10 amended to Truth Boundary Checklist Item per WSP_97 terminology lock established earlier in this chain. Two-character edit, no semantic change.

WSP 97 Truth Boundary Checklist

PASS — Truth Boundary Checklist Item table 8/8 YES; political safety boundary 6/6 verified; carry-forward contract recorded; Slice 2 named (VOTE_POC_ENTITY_RESOLUTION_PHASE1) but blocked pending authorization.

Co-Authored-By: Claude Opus 4.5 noreply@anthropic.com

Implements VOTE_POC_FEC_ADAPTER_PHASE1 slice with: - MockFECAdapter: Offline, no API key required for tests - CandidateRecord, CommitteeRecord, ContributionRecord data types - FECError/FECErrorType for structured error handling - WSP 97 confidence levels on all FEC-sourced records - Source provenance tracking via FECSource - Disambiguation support for ambiguous candidate names - Error simulation for testing rate limits, unavailable states Safety boundaries enforced: - NO_LIVE_API_REQUIRED_FOR_TESTS - NO_API_KEY_REQUIRED_FOR_TESTS - NO_HALLUCINATED_CANDIDATE_OR_FUNDING_CLAIMS Test coverage: 46 new tests (78 total voteballots tests passing) Audit: docs/audits/architecture/VOTE_POC_FEC_ADAPTER_PHASE1.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

…PoC Phase 1 Slice 2 (#709) Implement entity resolution layer on top of FEC adapter from PR #707: - EntityResolutionStatus enum: EXACT_ONE_MATCH, MULTIPLE_MATCHES, NO_MATCH, ADAPTER_ERROR, INVALID_QUERY - EntityResolutionRequest: query with optional state/office/party/cycle hints - EntityResolutionResult: resolution outcome with confidence and disambiguation - resolve_candidate_entity(): core resolution with deterministic scoring - resolve_by_name(), resolve_by_id(): convenience functions Key behaviors: - AMBIGUITY_PRESERVED_NOT_GUESSED: returns all matches when ambiguous - NO_HALLUCINATED_CANDIDATE_IDS: only returns candidates from adapter - Deterministic ordering and confidence scoring (0.0-1.0) - Error propagation from adapter with clear status codes Test coverage: 70 new tests (116 total for voteballots module) Safety boundaries: NO_FUNDING_SUMMARY, NO_PERSUASION_LANGUAGE, NO_CANDIDATE_RECOMMENDATION Slice: VOTE_POC_ENTITY_RESOLUTION_PHASE1 Worker-Lane: W6 Depends-On: PR #707 (VOTE_POC_FEC_ADAPTER_PHASE1) Co-authored-by: Foundups Agent <dev@foundups.com> Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Implement deterministic funding summary generation from resolved candidate entities using FEC adapter data. Key features: - Top funding sources sorted by amount with deterministic ordering - Trail termination markers (DIRECT_FEC_RECORDS_ONLY, NO_SUPER_PAC_TRACE, NO_DARK_MONEY_TRACE, UNKNOWN_WHERE_SOURCE_ABSENT) - Source references preserved for provenance - WSP 97 confidence labels on all sources - Contributions breakdown by type Safety boundaries enforced: - NO_QUICK_ANSWER_GENERATION (structured data only) - NO_DARK_MONEY_AS_VERIFIED_FACT - NO_CANDIDATE_RECOMMENDATION - NO_TARGETED_PERSUASION Slice: VOTE_POC_FUNDING_SUMMARY_PHASE1 Depends-On: PR #707 (FEC Adapter), PR #709 (Entity Resolution) Tests: 42 new tests, 158 total (all passing) Co-authored-by: Foundups Agent <dev@foundups.com> Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

…/6) (#712) Implement confidence scoring for VoteBallots funding summaries with explicit WSP 97 confidence labels: VERIFIED_FACT, HIGH_CONFIDENCE_INFERENCE, LOW_CONFIDENCE_INFERENCE, and UNKNOWN. Key features: - Direct FEC source with reference -> VERIFIED_FACT - Missing source -> UNKNOWN or capped confidence - Trail termination markers preserved and scored as UNKNOWN - Human review triggers for high-risk claims: - Foreign funding allegation - Criminal accusation - Low confidence + high impact - Source contradiction - Fail-closed error propagation from funding summary - No quick answer or prose generation - Source references preserved for provenance Safety boundaries enforced: - NO_FOREIGN_FUNDING_CLAIM_GENERATED (only flags for review) - NO_DARK_MONEY_AS_VERIFIED_FACT - NO_CANDIDATE_RECOMMENDATION - NO_TARGETED_PERSUASION - NO_QUICK_ANSWER_GENERATION - HUMAN_REVIEW_FOR_HIGH_RISK_CLAIMS Test coverage: 37 new tests (195 total), all passing. Builds on: PR #707 (FEC), #709 (Entity), #710 (Funding Summary) Worker-Lane: W6 Slice: VOTE_POC_CONFIDENCE_SCORING_INTEGRATION_PHASE1 Co-authored-by: Foundups Agent <dev@foundups.com> Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Repair for W10 gate block: - src/__init__.py: Export Slice 5 carry-forward contract (6 items) - ModLog.md: Append WSP 22-compliant entry for Slice 5 - Audit doc: VOTE_POC_QUICK_ANSWER_GENERATION_PHASE1.md with * Dependencies: #707, #709, #710, #712 (all merged) * Internal Review Verdict: READY * Truth Boundary Checklist: 30/30 YES * Disallowed language scan: PASS * Carry-forward contract for Slice 6 All Slice 1-4 exports preserved. 241/241 tests pass. Worker-Lane: W6 Slice: VOTE_POC_QUICK_ANSWER_GENERATION_PHASE1 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

… data (#713) * feat(voteballots): add quick answer generation from confidence-scored data WSP 97 constraints enforced: - NO_LLM_CALL: Pure template-based generation - NO_NEW_FACTS: Only surfaces existing labeled data - MAX_3_LINES_ENFORCED: Truncates with human review note Adds quick_answer.py module with: - QuickAnswer dataclass with provenance tracking - generate_quick_answer() for template-based answer generation - format_funding_line() for confidence-annotated source lines - truncate_with_review_note() for MAX 3 line enforcement - Shell, markdown, and plain text output formats Test coverage: 46 new tests (241 total voteballots tests) - Verified fact clean answers - Low confidence uncertainty markers - Truncation enforcement - Human review flag preservation - Trail termination handling - No LLM call contract verification - Safety boundary tests (no recommendations, no persuasion) Slice 5 of Vote PoC Chain Lane. Worker-Lane: W6 Slice: VOTE_POC_QUICK_ANSWER_GENERATION_PHASE1 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * fix(voteballots): add missing Slice 5 artifacts for PR #713 Repair for W10 gate block: - src/__init__.py: Export Slice 5 carry-forward contract (6 items) - ModLog.md: Append WSP 22-compliant entry for Slice 5 - Audit doc: VOTE_POC_QUICK_ANSWER_GENERATION_PHASE1.md with * Dependencies: #707, #709, #710, #712 (all merged) * Internal Review Verdict: READY * Truth Boundary Checklist: 30/30 YES * Disallowed language scan: PASS * Carry-forward contract for Slice 6 All Slice 1-4 exports preserved. 241/241 tests pass. Worker-Lane: W6 Slice: VOTE_POC_QUICK_ANSWER_GENERATION_PHASE1 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> --------- Co-authored-by: Foundups Agent <dev@foundups.com> Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Locks the Vote PoC chain in implementation-complete, not-public-launched state. Records 6/6 merged slices with merge commits: - #707 FEC Adapter: 15de3d3 - #709 Entity Resolution: b5b3eea - #710 Funding Summary: 1a3d06b - #712 Confidence Scoring: 4559a8e - #713 Quick Answer: 7895459 - #714 Shell Integration: 7e4e571 Defines re-open criteria V1-V8 for future Vote work. Tests: 303 passed, entry_url remains empty. DOCS-ONLY: No code, test, manifest, or registry changes. Worker-Lane: W9 Slice: VOTE_POC_CHAIN_OBSERVATION_SNAPSHOT_PHASE1 Co-authored-by: Foundups Agent <dev@foundups.com> Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Foundup merged commit 15de3d3 into main May 24, 2026
4 checks passed

Foundup deleted the feat/vote-poc-fec-adapter-phase1 branch May 24, 2026 09:00

Foundup mentioned this pull request May 24, 2026

feat(voteballots): entity resolution Phase 1 (Vote PoC Slice 2/6) #709

Merged

Foundup mentioned this pull request May 24, 2026

feat(voteballots): add deterministic funding summary generation for PoC Phase 1 Slice 3 #710

Merged

7 tasks

Foundup mentioned this pull request May 24, 2026

feat(voteballots): WSP 97 confidence scoring integration (Slice 4/6) #712

Merged

11 tasks

This was referenced May 24, 2026

feat(voteballots): add shell integration payload contract (Slice 6/6) #714

Merged

docs(voteballots): add Vote PoC chain governance closure snapshot #715

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(voteballots): FEC adapter Phase 1 (Vote PoC Slice 1/6)#707

feat(voteballots): FEC adapter Phase 1 (Vote PoC Slice 1/6)#707
Foundup merged 1 commit into
mainfrom
feat/vote-poc-fec-adapter-phase1

Foundup commented May 24, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

Foundup commented May 24, 2026

Summary

Scope: 5 files

Offline-by-Default Posture

Carry-Forward Contract (Stable for Slice 2)

Error Model

Political Safety Verified

Tests

W10 Hygiene Patch

WSP 97 Truth Boundary Checklist

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant