| Unit | Key | Purpose |
|---|---|---|
| Source observation | (source_file_sha256, source_record_ordinal) | One parsed occurrence in a frozen export; never destroyed by deduplication. |
| Canonical document version | record_id | One language, edition and substantive revision; the 269,853-row augmented master grain. |
| Work family | work_cluster_id, when available | Links translations, editions and revisions without collapsing them. |
| Golden Set record | golden_record_id | One of 11,306 identifier-exact RIS/CSV records preserved from Golden Set v6. |
| Analytical document-country row | (record_id, analysis_country) | Unit-weight country-analysis row in the separate 182,010-row final pair file. |
Policy Commons AI policy candidate corpus and national analytical release
This page separates three dated Policy Commons collection routes from the subsequent construction of the v7.10 augmented candidate master and its national document-country analytical view. It records executed operations, governing rules, observed counts, code, examples and unresolved limits.
Release snapshot: 21 September 2026. The authoritative analytical file is
document_country_pairs_final_v7_10.csv. Search counts describe dated provider snapshots
and may change as Policy Commons updates its holdings.
Release identity and verified artefacts
| Artefact | Grain and dimensions | SHA-256 |
|---|---|---|
policycommons_augmented_master_final_v7_10.parquet | 269,853 unique canonical document-version rows × 162 stored string columns | e1b9b5884d2138c366ce97dbce7a09d694440b2d3af8f55710a1d279d1dd31a0 |
document_country_pairs_final_v7_10.csv | 182,010 unique document-country rows × 16 columns; 182,010 unique documents; 135 analytical country or jurisdiction codes; unit weight 1 | 7bbe07e0faba5722717f679caaacef7f1825edf4c507382be1ca9ffb759faa67 |
SUMMARY.json | Release correction note and final row count | ca398f57767244cbeb51ae207651099eaadf8301c0625ffbeb3cdfdaebda4edd |
EXECUTED The final pair file has zero duplicate (record_id, analysis_country) keys and every weight equals 1. The method permits multi-country links, but the current release contains exactly one analytical country row per included document.
DISCLOSED LIMIT The master column release_version still carries the inherited v7.3 label. The v7.10 directory, summary and file hashes above identify the release. Country analysis must use the final pair file, not reconstruct it by filtering the master's legacy or *_final columns.
Units of observation and analysis
Scope and search contract
The final corpus is a union of distinct collection routes. Their literal provider queries are provenance strings, not claims about Boolean-search semantics. Records are linked across routes only after collection by stable identifiers and compatibility checks.
| Route | Dated contract | Modules and filters | Output and role |
|---|---|---|---|
R1_POGO_20260916 | 16 September 2026; literal query AI AND system AND policy; newest first; 100/page; year-separated | POCO_POGO; Publications; Document; Government | Authenticated RIS pages and restart manifests for the initial World Governments route. |
R2_AIGOV5_20260920 | 20 September 2026; literal query Artificial Intelligence AND AI Governance AND AI Safety AND AI System AND AI Policy; date-desc pages 1–100 plus date-asc pages 1–53 | POCO_POGO, POCO_PCWL, POCO_POHE, POCO_PSPL; Publications; Document; Government | 15,206 displayed hits; 153 RIS and 153 CSV files; 15,300 observations in each format; source of Golden Set v6. |
R3_AI5_1950_2026 | 1950–2026; literal query artificial intelligence; module-year partitions; 100/page | All five documented modules, including POCO_ALL; recorded historical filters preserved per manifest | Broad local candidate collection used for later local enrichment and augmented-master construction. |
Search configuration · Paired RIS/CSV contract and commands
Five Policy Commons modules and their collection roles
| Module code | Policy Commons name | Collection role |
|---|---|---|
POCO_POGO | World Governments | Central governments, ministries, legislatures, regulators and national public bodies. |
POCO_PCWL | World Cities; interface display may appear as “World Cities and Local…” | Municipalities, cities, counties and other local-government issuers. |
POCO_POHE | Public Health and Social Care | Public-health, health-service and social-care policy sources. |
POCO_PSPL | N.A. State, Provincial, and Territorial Governments | State, provincial and territorial government publications in North America. |
POCO_ALL | Global Think Tanks | Think-tank and policy-research material retained for institution and government-relationship classification. |
The documented AIGOV5 paired RIS–CSV search selected the first four government-facing modules. The wider local collection also contains the Global Think Tanks module. Module membership is collection provenance, not proof of national-policy eligibility; issuer and government relationship are classified later.
Authenticated collection workflow
- The collector opens the required year and page in an existing, authenticated Chrome tab.
- It reads the internal Policy Commons artefact identifiers from the rendered search results and removes duplicate identifiers within the page.
- Inside the authenticated tab, it submits those identifiers to
/api/export/many/and requests RIS output using the active CSRF token. - Policy Commons returns a short-lived signed export address. Python downloads the RIS payload from that address and does not retain the address or authentication token.
- The validated payload is saved as one file per year and page, followed by a manifest record and a restart checkpoint.
This hybrid design is necessary because direct, unauthenticated requests to the search endpoint returned HTTP 403, while export requests made inside the logged-in browser session succeeded. Authentication remains in Chrome; the collector never serialises cookies, passwords or CSRF tokens.
Validation before a page is accepted
Each RIS file must contain at least one record, and its opening TY - markers must
equal its closing ER - markers. A response containing more RIS records than the
number of requested identifiers, an empty response, or mismatched record boundaries is rejected.
Failed pages are retried up to four times with increasing delays.
Policy Commons occasionally returns fewer RIS records than the number of unique identifiers
submitted to the export service. The collector preserves these valid records and writes the
difference to export_omission_count. This turns a silent provider-side omission
into an explicit recovery target rather than discarding the whole page.
Provenance, checkpoints and recovery
Every year has a line-delimited manifest. Each successful page records the UTC retrieval time, year, page number, RIS record count, requested internal identifiers, query address and export omission count. A separate state file identifies the latest successful page, while the log records successes, retries and terminal failures.
Re-running the same command is safe. Before making a request, the collector checks whether the intended page file already exists and passes the RIS boundary test. Valid pages are skipped; missing or invalid pages are collected again. This supports interruption and recovery without overwriting verified output.
End-to-end cleaning and analysis workflow
- Freeze inputs. Save the exact query, modules, content type, publisher type, year filters, sort order, page size, retrieval time and SHA-256 manifest.
- Collect paired exports. Save RIS and CSV from the same page and filter state. CSV supplies provider fields such as
countryandtopicsthat RIS may omit. - Parse and link. Join only normalised Policy Commons identifiers and artefact IDs. Preserve unmatched rows and field-level provenance. Never join by title, filename or row order.
- Deduplicate. Resolve stable IDs, canonical URLs, compatible titles, publisher, year, language and content hashes. Keep editions, translations and substantive revisions separate.
- Screen AI with high recall. Collection provenance from documented AI-oriented searches is positive evidence. Missing AI terms in exported metadata do not establish Non-AI because Policy Commons may have matched indexed full text. Exclude only clear alternative meanings with positive evidence.
- Classify document function. Exclude standalone vacancy notices, product manuals, theses, datasets, course syllabi, media and purely scholarly outputs. Retain official proceedings, workshops and agendas when they contain policy inquiry, regulation, standards, testimony, recommendations or implementation.
- Attribute countries. Keep
published_in_country,issuer_country, policy jurisdiction and target country separate. Government, public, national commission and publicly funded research evidence can support attribution. Headquarters or repository location alone cannot. - Build the analytical view. Retain unique
(record_id, analysis_country)rows with unit weight 1. Assign a document to each supported country without percentage shares. Aggregate HKG to CHN while preserving the original value. - Audit and release. Apply deterministic census rules, preserve exclusion queues, run fixed-seed stratified original-page checks, record inaccessible pages as
unverifiable, and publish versioned outputs with manifests and checksums.
Stage-by-stage reproducibility matrix
| Step | Input and code | Decision and actual columns | Output, count and failure queue |
|---|---|---|---|
| 1. Freeze | Raw RIS/CSV plus manifests; SHA-256 inventory | source_file, source_ordinal, observation_id, query_id | 429,847 RIS observations; invalid or changed files fail the integrity gate. |
| 2. Structural validation | RIS boundary tests and CSV schema/cardinality tests | RIS TY/ER; CSV required fields; strict UTF-8; temporary-file atomicity | 4,875 source files, 4,402 unique hashes; rejected payloads remain in quarantine. |
| 3. Parse and normalise | RIS parser and validated CSV observations | policy_commons_id, url, raw_fields_json, bibliographic fields | 306,644 RIS canonical records and 21,711 CSV canonical records. |
| 4. Link formats | Golden Set builder | join_coi and join_artifact_id must both agree; pairing_status records the outcome | 21,450 paired; 285,194 RIS-only; 254 CSV-only; seven conflicts quarantined. |
| 5. Resolve identity | Stable IDs, canonical URLs, DOI/ISBN/report numbers, compatible metadata | record_id, identity_status, observation counts; incompatible edition/language is a merge veto | Translations and revisions stay distinct; uncertain identity enters review. |
| 6. Cross-walk Golden Set | integrate_local_with_golden.py in the frozen local workspace | golden_record_id, master_origin, golden_match_status | 11,306 Golden records preserved; six local rows converge on those records. |
| 7. High-recall AI gate | Query provenance, metadata and original full text | ai_broad_included, ai_evidence_location, ai_exclusion_reason, ai_fulltext_review_status_v7 | 295,354 of 295,586 new candidates pass the broad AI gate; metadata absence alone never excludes. |
| 8. Document function | Form rules plus issuer/policy-function evidence | document_genre_protocol_3_7, document_eligible_protocol_3_7, document_form_review_v7_7, human_form_review_v7_8 | 258,777 document-eligible; confirmed exclusions and ambiguous records remain auditable. |
| 9. Build augmented master | build_augmented_final_release_v1.py, then versioned correction scripts | master_origin, augmentation_status; source values are not overwritten | 11,306 + 258,547 = 269,853 canonical document versions. |
| 10. Institution and policy scope | Authority rules, public status, commissioning/funding/co-issuance evidence | institution_type_final, national_policy_interest_scope, national_policy_interest_rule | EU, IGO, multinational and repository cases are separated from national-policy interest. |
| 11. Country attribution | Published-in recovery, issuer authority evidence and direct page verification | published_in_country_*, issuer_country_final, country_method_final, country_rule_id, policycommons_live_country_* | Non-country dispositions are excluded; HKG is aggregated to CHN while raw evidence is preserved. |
| 12. Analytical pairs | Versioned pair builders and correction rules | Authoritative 16-column pair schema; key (record_id, analysis_country) | 182,010 unit-weight rows, 182,010 documents, 135 analytical country/jurisdiction codes. |
| 13. Human QA and release | Fixed-seed samples, live pages, review manifests, checksums | Sampling stratum, decision, evidence URL, reviewer action and release rule | Corrections create a new release; inaccessible pages are unverifiable, not passes. |
EXECUTED describes a verified local result. GOVERNING RULE is a mandatory protocol control. PENDING OR DISTRIBUTED means evidence remains in an earlier stage folder or requires consolidation. In particular, the governing protocol prescribes independent iCloud reprocessing; the current public v7.10 folder alone does not prove that full reconciliation step.
Accounting equations
306,644 RIS + 21,711 CSV - 21,450 paired = 306,905 union candidates
21,450 paired + 285,194 RIS-only + 254 CSV-only + 7 conflicts = 306,905
306,898 conflict-cleared - 11,306 Golden matches - 6 converged duplicates = 295,586 new
11,306 preserved Golden + 258,547 new AI/document records = 269,853 master
The 295,586 new candidates include 295,354 broad AI inclusions and 258,777 document-eligible records. Their intersection is 258,547, so these are overlapping classification axes and must not be subtracted as independent sequential losses.
Current country-attribution protocol · British-English error register and cited examples
Collection results
The collection results report charts the frozen v8.3 document master and the v7.10 national analytical file separately. It includes country, year, institution and field-coverage tables, G20/OECD/EU comparisons, and distinct international-organisation and multinational-private issuer datasets.
Open current collection results · View the reproducible generator · View the issuer-set builder · Open the full 162-column dictionary
The report identifies the record-level module limitation. Neither master nor analytical file has a dedicated module column, so module counts are not inferred from unrelated fields.
Reproducible error handling and audit record
Current local data inventory and analytical master
| Stage | Verified count | Meaning |
|---|---|---|
| Raw RIS observations | 429,847 | Locally collected RIS observations before canonical deduplication. |
| RIS canonical records | 306,644 | Records remaining after structural validation and identity resolution. |
| CSV observations | 35,930 | Paired CSV observations from 372 accepted export files. |
| CSV canonical records | 21,711 | CSV records passing schema and identifier checks. |
| New local AI/document candidates | 258,547 | New records retained under high-recall AI provenance and document-form screening. |
| Golden Set preserved | 11,306 | Identifier-exact paired RIS/CSV records retained without overwrite. |
| Augmented master | 269,853 | Golden Set plus new local records. |
| Final analytical document-country rows | 182,010 | Unique unit-weight rows after country attribution, form review and confirmed exclusions; currently also 182,010 unique documents. |
| Analytical country/jurisdiction codes | 135 | Includes territories and project-normalised jurisdictions; HKG is aggregated to CHN and raw provider values are preserved. |
All counts are versioned. Analytical exclusions are recorded in audit columns and do not physically delete source observations.
Final output status
The completed v7.10 output contains 269,853 canonical document versions and an authoritative analytical file with 182,010 unique documents, 182,010 unit-weight document-country rows and 135 analytical country or jurisdiction codes. Intermediate review rounds are not reproduced here. Their audit columns remain in the master, while the results dashboard reports the final attribute values and distributions.
Storage, snapshots and governing order
The working design is local first, iCloud second. Downloads is the intake and staging area. The iCloud-backed data3 collection is frozen and processed independently only after the local master passes its gates. Path aliases, symbolic links, file-system identity, size and SHA-256 are compared before counting, so a local path and its iCloud backing path cannot be counted as two sources.
Every RIS, CSV, JSON, JSONL, database and archive is inventoried with path, type, size, modification time, checksum, record count and collection category. The occurrence key is (source_file_sha256, source_record_ordinal). Raw bytes or their hash, parsed-record hash and normalised-content fingerprint remain attached to that occurrence. A later canonical record never replaces this source layer.
The mandatory order is: freeze inputs; validate structure and contamination; parse and normalise; resolve identity and versions; enrich missing fields; classify AI relevance; classify document form; resolve institutions and countries; determine policy eligibility; freeze the local master; process and reconcile iCloud; then release a new integrated version. Every transition records its run, configuration, rules, code and environment versions, counts, timestamps, reviewer actions and checksums.
Observed collection and linkage funnel
| Operation | Observed result | Control |
|---|---|---|
| RIS inventory | 4,875 source files, 4,402 unique file hashes and 429,847 observations | RIS boundary, encoding, truncation and empty-record checks; 20 synthetic tests passed. |
| RIS canonicalisation | 306,644 canonical records | 300,555 prior canonical records cross-walked; 167 identity-review pairs retained for audit. |
| CSV validation | 372 unique accepted files, 35,930 observations and 21,711 canonical records | Only files with the expected schema and usable Policy Commons identifiers were accepted. |
| RIS–CSV linkage | 21,450 paired, 285,194 RIS-only and 254 CSV-only records | Seven identifier conflicts were separated; no title, filename or row-order join was permitted. |
| Golden Set cross-walk | 11,306 unique Golden Set records matched; six additional local rows converged on those records | The Golden Set was preserved and never overwritten. |
| New-record screening | 295,586 records absent from the Golden Set; 295,354 high-recall AI inclusions; 258,777 document-eligible records; 258,547 meeting both conditions | AI relevance and document eligibility were calculated independently. |
| Augmentation | 11,306 preserved plus 258,547 new records equals 269,853 master records | Promotion created a new release rather than mutating an earlier release. |
| Country analysis | 182,010 unique document-country rows across 135 sovereign-country codes | Rows have unit weight 1; non-national, unresolved and excluded-form records remain in separate audit layers. |
Identity resolution, versions and field survivorship
The analytical entity is a document version, not an export row. Identity evidence is evaluated in this order: Policy Commons artefact and file identifiers; canonical Policy Commons URL; DOI, ISBN, report number or official publisher URL; finally a reviewed metadata match using title, publisher, year, language and abstract compatibility. Artefact IDs and file IDs are separate namespaces.
An incompatible title or abstract, different language or edition, substantive revision, conflicting typed date, cross-namespace collision or redirect to a collection page blocks automatic merging. Fuzzy title similarity creates review candidates only. Translations, abridgements, annual editions and substantive revisions keep separate record_id values and may be connected through work_cluster_id.
The best structurally valid and internally consistent observation anchors the canonical record. Other observations can fill a missing field through a field-survivorship table, but a non-empty conflict is never overwritten silently. The table records the source occurrence, previous and selected values, rule, confidence and conflict state. This prevents a false composite record assembled from unrelated exports.
Separate classification axes and evidence hierarchy
AI relevance, document form, institution type, policy eligibility and country attribution are separate variables. A government issuer does not make a dataset a policy document; a private issuer does not make an AI report Non-AI; publication place does not establish issuer jurisdiction.
For AI screening, original full text outranks original publisher metadata, which outranks provider summaries, keywords and search provenance. The evidence tiers are E0 no usable evidence, E1 title only, E2 title plus abstract or summary and E3 usable original full text. Missing metadata terms cannot support exclusion. The retained labels are core_ai_policy, substantive_ai_component, incidental_ai_mention, non_ai and unresolved; only a positive, independently auditable basis can support non_ai.
For document form, the normalised labels distinguish policy documents, scholarly articles, patents, government-linked research, hybrid or ambiguous records and unresolved genre. A DOI, university affiliation, the word paper, proceedings or workshop is never sufficient on its own. The decision turns on the document's policy function.
Institution, issuer and country model
The system stores issuer, bibliographic publisher, archive or host, commissioner and adopting government as different relations. The institution authority table contains the canonical name, aliases, institution class, governmental relationship, country, evidence URL, validity period, confidence and verification date.
National and subnational governments, legislatures, regulators, statutory agencies, public research institutes, official committees and qualifying public policy institutes enter the national-policy group. International organisations, EU bodies, independent think tanks, foundations, universities, corporations, networks and repositories remain separate. A non-government body can enter a government-linked layer when formal commissioning, adoption, funding or co-issuance is demonstrated.
Country concepts are not collapsed. The release retains published_in_country, issuer_country, policy_jurisdiction, target_country and author-affiliation country. The analytical code CTRY follows verified issuer jurisdiction. Reserved non-country codes are XIG for intergovernmental organisations, XEU for EU institutions, XMN for multinational private issuers and XUN for unresolved cases. Multiple eligible issuers are represented in link tables, not fractionalised. HKG is aggregated to CHN only in the analytical view; the observed value is retained.
Release package, invariants and deletion gate
A release contains the canonical master, source provenance, collection routes, duplicate and work-cluster maps, institution authority, document-country links, quarantine, exclusions, unresolved records, stage counts, scripts, environment information and SHA-256 manifests. Core grains are enforced with primary and foreign-key checks so many-to-many joins cannot inflate analysis rows.
Required accounting identities include: raw observations equal accepted parses plus parse quarantine; accepted parses equal linked observations plus unresolved identities; linked observations equal canonical anchors plus duplicate links; canonical records equal accepted master records plus exclusions, unresolved classifications and conflict quarantine.
Physical deletion is never a cleaning shortcut. It requires a frozen source manifest, persisted and checksummed canonical or exclusion record, reconciled counts, reviewed dry run, exact-path deletion manifest, recoverable quarantine, immediate pre-deletion size and checksum verification, recorded approval, successful restore test and completed iCloud synchronisation. No physical source deletion was performed for the current release.
Complete final-master variable dictionary
The v7.10 augmented master contains 162 stored columns. The complete dictionary lists every physical column, stored type and definition, including raw bibliographic fields, RIS–CSV linkage, collection provenance, AI screening, document form, institution classification, country evidence, live-page validation, correction history and final release fields.
Open the complete Policy Commons augmented master v7.10 data dictionary. The page is generated from the actual Parquet schema so a column cannot be omitted merely because it was added after the original 63-variable Golden Set.
Example: RIS does not contain the country
A Policy Commons detail page may show Published in Canada or Published in Italy while the RIS export leaves the field blank. Collect the paired CSV, preserve published_in_country, and do not treat a blank RIS field as an unknown country.
Example: AI appears only in the body
| Record | Evidence and decision | Applied release |
|---|---|---|
pcv3_1f9a59f1f98802f54d78c1bdGlobal Quarterly | No AI term in exported title, abstract or keywords; the original PDF contains explicit AI discussion and a dedicated technology section. Retain for India. | v7.9 full-text correction |
pcv3_9c3ca430a4f15c9aa975684bTxDOT Audit Subcommittee minutes | No exported metadata AI term; the original material covers AI programmes, AI governance, risk and cybersecurity. Retain for USA. | v7.10 full-text correction |
Both retain ai_fulltext_review_status_v7 = provenance_included_metadata_term_not_observed. This status documents a metadata false negative rather than a Non-AI decision.
Example: proceedings can be policy documents
NSW Inquiry into AI: Portfolio Committee No. 1 Proceedings records an official parliamentary inquiry, evidence and policy discussion. It is retained for Australia. The word proceedings alone is never an exclusion rule.
Example: issuer overrides publication place
A document may show Published in Serbia while its issuer is the Government of Kosovo. Preserve both fields, but assign the analytical country from explicit issuer jurisdiction. Similarly, an EU or international organisation published in Belgium, Malta or the Netherlands is not automatically a national document of that host country.
Example: multinational private firm
An Abbott document labelled Abbott (United States) preserves USA as source evidence but is excluded from the national policy-interest view unless government commissioning, funding or a national research remit is demonstrated. A headquarters location alone is insufficient.
RIS–CSV and duplicate errors
RIS can omit page fields such as country and topics. Always collect the paired CSV and join only normalised Policy Commons and artefact identifiers. Preserve unmatched and conflicting keys. Never join by title, filename or row order. Deduplicate with stable IDs, canonical URLs, compatible title, publisher, year, language and content evidence. Keep editions, translations, annual editions and substantive revisions separate.
AI false negatives and ambiguous terms
Metadata absence is not Non-AI because the provider can match indexed full text. Retain records from documented AI-oriented searches unless positive evidence establishes an alternative meaning. Exclude avian influenza, air, biological neural networks and similar collisions only when no independent computational-AI evidence remains. Historical terms such as expert systems, machine intelligence and intelligent systems require computational context. Record query provenance, evidence location and AI centrality separately.
Document-form errors and corrections
Standalone vacancy notices, position descriptions, product or user manuals, theses, datasets, course syllabi, videos and images are excluded from the policy-document view. Government or public ownership does not rescue a non-policy format. Exceptions require an explicit policy function: legal or regulatory implementation guidance, official curriculum or examination specification, commissioned policy evidence, or a substantive mixed document.
Proceedings, workshops and agendas are not excluded by title. Retain official government inquiries, parliamentary hearings, regulatory or standards work, testimony, recommendations, action plans and implementation records. Exclude only logistical event records and purely scholarly proceedings. Human review of 136 records confirmed this rule.
Country-attribution errors
Store published_in_country, issuer_country, policy jurisdiction and target country separately. Explicit issuer jurisdiction overrides a conflicting place, as in Government of Kosovo versus Published in Serbia. Public libraries and national commissions can be genuine issuers. EU, international organisations, repositories and headquarters locations are not national issuers without a supported national office, commission or country-specific mandate. HKG is mapped to CHN for analysis while raw values remain preserved.
Multinational private institutions
A headquarters or branch location alone does not represent national policy interest. Ordinary business, product and promotional documents from multinational firms are excluded from the national analysis but retained in the source master. A private research unit is included only when the source demonstrates government commissioning, funding or a national research remit. Unclear cases remain manual_review.
Quality assurance and release gate
Original pages were checked during rule development, but intermediate sampling rounds are omitted from this results-focused page. The final gate requires unique document-country keys, unit weights of 1, retained evidence and rule fields, versioned outputs and SHA-256 checksums. Inaccessible pages are never counted as verified. Detailed review manifests remain in the local audit package and the error register.
Executable final-release verification
The following public checker verifies the structural claims without publishing licensed Policy Commons payloads. Replace the placeholders with the local v7.10 files.
python research/code/validate_policycommons_v710_release.py \
--master <RELEASE_ROOT>/policycommons_augmented_master_final_v7_10.parquet \
--pairs <RELEASE_ROOT>/document_country_pairs_final_v7_10.csv
master = pd.read_parquet(MASTER)
pairs = pd.read_csv(PAIRS, dtype=str)
assert len(master) == 269_853
assert master.record_id.nunique(dropna=False) == 269_853
assert len(master.columns) == 162
assert len(pairs) == 182_010
assert pairs.record_id.nunique(dropna=False) == 182_010
assert not pairs.duplicated(["record_id", "analysis_country"]).any()
assert pairs.weight.astype(int).eq(1).all()
assert pairs.analysis_country.nunique(dropna=False) == 135
assert set(pairs.record_id) <= set(master.record_id)
Download the checker · Regenerate the 162-column dictionary · Full-census audit code · Notebook runner
Observed key-field coverage in the 269,853-row master
| Field | Non-empty rows | Coverage |
|---|---|---|
title | 269,853 | 100.00% |
abstract | 267,429 | 99.10% |
publisher | 269,839 | 99.99% |
year | 269,436 | 99.85% |
url | 269,853 | 100.00% |
keywords | 263,162 | 97.52% |
topics | 19,490 | 7.22% |
| Raw CSV country / Published in | 20,921 | 7.75% |
institution_type_final | 258,533 | 95.81% |
All 162 physical Parquet columns are stored as strings. Missingness checks therefore treat both null values and empty strings as missing. Module provenance is not yet exposed as a dedicated master column for every record; source manifests remain authoritative and a future record-module link table is recommended.
Interpretation and limitations
The search filters improve precision but do not establish that every retrieved item is a national policy report. Organisation type, issuing body, jurisdiction and document function must still be classified after collection. International organisations should remain separate from national portfolios, and local or regional government publications should retain their administrative level.
Database coverage, metadata and result counts can change. Reproduction therefore requires the recorded configuration, retrieval date and manifests. RIS files are not published in the GitHub repository because access and redistribution remain subject to the user's Policy Commons licence.
The final pair file contains 222 rows without a year. Observed numeric years span 1601–2026, so historical extreme values require a separate temporal-outlier review before longitudinal analysis. The completed samples were designed primarily for implementation checks and discovery of error families. Without stratum-level adjudicated outcomes and weighted confidence intervals, they do not establish a population-wide semantic accuracy rate.
Citation: Chun, Y. (2026). Policy Commons government AI policy collection: authenticated RIS export, validation and recovery method. Method note for the AI Knowledge Ecosystem and Policy Agenda Gaps project.