PolicyWatcherRelease 4.0.0-beta.3 AI Discoverability and Citation ReadinessOpen platformPolicyWatcher 4.0.0-beta.3 AI Discoverability and Citation ReadinessValidated dashboard grammarComposes goal-specific workspaces from immutable allowlisted modules with deterministic IDs and Source QA pinned. Evidence-first data registryDeclares endpoint, path/query scope, freshness, visibility, public-evidence gate and limitations before a dashboard source can load. View/export parityUses the same filtered view model for the visible company list and CSV export, including a provenance manifest. Shareable evidence viewsCopies a canonical URL for the committed workspace and public filters; private evidence and consent state are excluded. Coordinated drill-downConnects heatmap region and audience context with radar KPI inspection, explicit missing and tie states, and exact-value fallbacks. Bulk source onboardingMoves validated candidates through official review, private baseline, QA, and an explicit publication decision. Dataset QAChecks URL hygiene, source evidence, hash consistency, timestamps, KPI fields, regional impact coverage and subscriber hygiene. Retrieval evidenceDocuments direct fetch, HTTP/2, VPS-rendered fetch, archive fallback, source failures and strategy escalation without inventing data. Public evidence gateSeeded, partial, unavailable or review-needed sources are withheld from public views until a valid source baseline exists. Policy Signals BoardRanks source coverage, retrieval traceability and publicEvidence movement without certifying companies or compliance. Trust evidenceShows CI, CodeQL, OpenSSF Scorecard, targeted reliability coverage and live-header report links.
Product overview
This page describes what the current platform exposes: public dashboard contracts, change views, canonical analysis fields, provenance-aware exports, dataset QA checks, retrieval evidence, source suspension logic, Trust & Quality evidence and admin tools.
Data model
Configured data
The public and admin pages are built around companies, policies, policy changes, check logs, region impacts, subscribers and QA results. The panels below map those records to the visible features.
01
DATASET
Company and policy records
The platform displays configured companies, source URLs, jurisdiction labels, policy categories and Dataset QA status.
CompanyIndustryConfigured URLJurisdictionPolicy typeDataset QA status
Configured records02
CHANGES
Change views
When change rows exist, canonical share links preserve the committed dashboard view and browser history restores valid filter state.
TimelineDiff viewCanonical share URLHistory restoreEmbed viewOG image
Dataset-driven views03
ANALYSIS
Risk and KPI analysis
Canonical KPI semantics, atomic region and audience selection, and an exact-value inspector keep visual drill-downs consistent with the evidence table.
Trend provenanceRisk profileRegion + audienceKPI inspectorMissing and tie statesDisplayed values
Validated analysis contracts04
CONTROL
Admin tools
The admin area includes five-stage Bulk Source Onboarding, Dataset QA decisions, Review Log, KPI audit, companies, cron status, VPS services and database controls.
Bulk intakePrivate baselineDataset QAPublication decisionReview LogCron
Operational modulesAnimated data views
Visualization modules
The animated SVGs below are static representations of existing product views. They describe UI modules and the database fields they use.
Two evidence records
Timeline
Changes + continuitySeparates evidence-gated provider policy changes from sanitized source-retrieval and publication-state transitions.
Public score rows
Risk trend
Snapshot provenancePlots evidence-gated score records, distinguishes observation sequence from the real snapshot version, and includes an accessible table.
Public change evidence
Region heatmap
Atomic context actionSelecting a cell commits region and audience together, while the bilingual summary and exact-value table keep missing cells as Not assessed.
Evidence-gated comparison
Benchmark radar
KPI value inspectorOpens original and normalized values by canonical KPI, makes missing and tie states explicit, and keeps the ordinal comparison separate from compliance or performance claims.
Canonical KPI fields
KPI matrix
Shared catalogUses one field-specific vocabulary and concern order across normalization, audit and the public matrix.
Report route
Executive PDF
PDF outputGenerates a report from the selected policy and its available analysis fields.
Dataset QA
Dataset QA checks
The admin QA layer checks source fit, retrieval evidence, public evidence gates, seeded-record boundaries, hash consistency, check-log completeness, timestamp integrity, archive timestamps, KPI coverage, regional impact coverage and subscriber hygiene. Review decisions are persisted and written to an append-only log.
Onboarding gateImports and first baselines remain private until QA passes and an admin explicitly publishesPublication
Source fitOfficial URL, jurisdiction, duplicate and localization checksDataset QA
Retrieval chainDirect, HTTP/2, VPS renderer, Wayback and Common Crawl diagnosticsEvidence
Public gateSeeded, partial, unavailable and review-needed records stay non-publicGate
Re-baseline guardSeed-only baseline replacement with source-evidence and public-baseline protectionsGuard
Drift controlHost drift, homepage redirect and oversized extraction checksValidation
Evidence logStatus, source, timestamp, hash, length and archive timestamp recordsAudit trail
Review trailDataset QA decisions, admin review log, access log and suspension alertsReview
QAChecks
Administrative tools
Administration functions
The admin area includes login, metrics, company and policy management, dataset QA, KPI audit, explainability, cron status, database inspection, encrypted backup utilities, renderer-aware retrieval evidence and policy telemetry.
Company recordsPolicy recordsRetrieval pathChange recordsQA issue listTrust evidenceEncrypted export
Bulk Source Onboarding
CSV/TSV intake, official-source review, private baseline, QA gate and publish/hold/reject decision
Dataset Quality
Source fit, public evidence gates, check logs, hash consistency and analysis field checks
KPI Audit
KPI value distribution and explanation coverage by company
Company Registry
Companies, industries, policy URLs, policy types and jurisdictions
Cron Manager
Batch scans, company targeting, live strategy evidence and source suspension results
VPS Services
Renderer health checks, bearer-auth smoke test and redirect/SSRF boundary checks
Database Console
Database inspection for records used by public views
Access Log
Admin login and access events with IP, user-agent, path and outcome
Encrypted Backup
Encrypted export and decrypt-preview utility for database content
Auditor Role
Read-only review access for selected admin views
Security Settings
Session HMAC, rate limits, protected APIs and token hygiene
Trust Evidence
Public quality page for CI, CodeQL, OpenSSF, targeted reliability coverage and live header reports
Workflow
Public data flow
This is a functional map of routes and records used by the app. It separates what is configured in the dataset from what is shown in public pages.
Proposed source
Validated CSV/TSV candidate enters protected admin review and remains private
Official review to publication
Official-source decision, private first baseline, QA gate and explicit publish/hold/reject are persisted
Inventory row
Company, policy URL, type, jurisdiction and configured status
Retrieval cascade
Direct fetch, HTTP/2, VPS renderer, Wayback and Common Crawl are tried with recorded outcomes
Source validation
Minimum text, host drift, path drift, extraction cap and content-shape checks
Evidence log
Status, source, HTTP status, final URL, hash, text length and archive timestamp are recorded
Public gate
Only source-verified evidence is available to public routes and reports
Re-baseline guard
Seeded inventory is replaced only when no source evidence or public baseline already exists
Change analysis
Diff, AI summary, KPI fields and regional impacts are generated only after a valid baseline comparison
Review workflow
Dataset QA decisions, admin review log and suspension alerts document human and system actions
Trust view
Public evidence page links repository checks, security scans and external report surfaces
Public view
Dashboard, timeline, signals board, share, embed, report and digest routes read only gated data
Trust & Quality
Publication gates
The Trust page presents workflow status, CodeQL, OpenSSF Scorecard, targeted reliability coverage, Sonar readiness, Codecov readiness and live HTTP header report links. The Policy Signals Board turns source evidence into an inspectable operational ranking. These checks describe build health, retrieval quality, source status, and public evidence readiness.
Quality GateGitHub ActionsCI
CodeQLCode scanningScan
OpenSSFScorecard workflowSupply chain
CoverageVitest targeted reliability coverageTest
SonarReady for token setupPending
HeadersLive report linksExternal
TrustEvidence
Public interface
Methodology and review tools
The public interface explains its methodology and exposes available analysis outputs with confidence boundaries. The admin interface adds tools to inspect and improve the dataset behind those outputs.
Fabrizio DegniCreator, PolicyWatcher