Add reviewed AAMAS 2025 publisher metadata adapter

Reviewed-on: #41

.gitea/workflows/check.yml

@@ -50,6 +50,7 @@ jobs:
               subprocess.run([python,'-I','-B','-m','paper_atlas','collect','cvf','--help'],cwd=outside,check=True)
               subprocess.run([python,'-I','-B','-m','paper_atlas','collect','www-archive','--help'],cwd=outside,check=True)
               subprocess.run([python,'-I','-B','-m','paper_atlas','collect','aamas-proceedings','--help'],cwd=outside,check=True)
+              subprocess.run([python,'-I','-B','-m','paper_atlas','collect','aamas-proceedings','--year','2025','--snapshots',str(src/'tests/fixtures/aamas2025'),'--out',str(root/'installed-aamas2025')],cwd=outside,check=True)
               subprocess.run([python,'-I','-B','-m','paper_atlas','collect','iclr-archive','--help'],cwd=outside,check=True)
               subprocess.run([python,'-I','-B','-m','paper_atlas','maintain','postgres','--help'],cwd=outside,check=True)
               subprocess.run([python,'-I','-B','-m','paper_atlas','maintain','edition-tracks','--help'],cwd=outside,check=True)

README.md

@@ -64,7 +64,9 @@ paper-atlas collect colm --cache /data/paper-index/raw/http-cache \
 
 早期主系列的Workshop名称按[ICML/IROS精确届次证据](docs/coverage/historical-primary-series-2026-11-09.md)识别，保留原名与范围证据；代码支持不代表已补齐生产数据。
 
-AAMAS 的[官方论文集采集器](docs/aamas-proceedings.md)目前核验了 2012 版式，可从缓存或已校验快照采集标题、作者及页面提供的摘要；发表形式单独保存，全文/扩展摘要中未明确的投稿 track 保持待明确，不根据会话主题推定主会轨道。
+EWSL、EPS、ECP、EWSP 的[具体前身卷与完整快照要求](docs/coverage/historical-predecessors-2026-11-09.md)单独核验，保留原始系列及事件/出版年份；旧候选文件缺少 ECP/EWSP 时会明确提示，避免静默遗漏。
+
+AAMAS 的[官方论文集采集器](docs/aamas-proceedings.md)支持已核验的 2012、2025 版式，可从缓存或已校验快照采集元数据。2025 年目录含 476 条非 keynote 出版物，保留完整作者和机构，HTML 未提供摘要时留空；发表形式与投稿 track 分开，不根据主题推定主会轨道或研究类型。
 
 `paper-atlas collect --help` 查看来源；`paper-atlas import --help` 查看导入方式。完整批次步骤见[使用指南](docs/usage.md)。
 

docs/aamas-proceedings.md

@@ -1,6 +1,14 @@
 # AAMAS 官方论文集元数据
 
-`paper_atlas.collectors.aamas` 是按需运行的采集适配器，通过统一入口 `collect aamas-proceedings` 使用。目前只支持已独立核验的 **AAMAS 2012** HTML 版式；其他年份需先核对官方目录和逐篇结构，再增加适配，不能仅替换年份。
+`paper_atlas.collectors.aamas` 是按需运行的采集适配器，通过统一入口 `collect aamas-proceedings` 使用。支持已独立核验的 **AAMAS 2012、2025** HTML 版式；其他年份需先核对官方目录和逐篇结构，再增加适配，不能仅替换年份。2025 解析单独封装在 `paper_atlas.collectors.aamas2025`。
+
+2025 版式使用[官方首页](https://www.ifaamas.org/Proceedings/aamas2025/)和[出版目录](https://www.ifaamas.org/Proceedings/aamas2025/forms/contents.htm)。原始目录共 479 条：3 keynote、260 research paper、148 extended abstract、12 Blue Sky、25 doctoral、22 Demo 栏目、9 JAAMAS。排除 keynote，输出 476 条；Demo 栏目中的 p3000 是明确标题的 COMP24 竞赛报告，发表年份仍为 2025，格式记 `competition_report`、投稿 track 留作 `proceedings_unspecified`，保留原 Demo 栏目证据。其余输出按 track 分组为 409 unspecified、12 blue_sky、25 doctoral、21 demo、9 jaamas。
+
+作者按逐篇 BR 行解析，斜体机构原文另存，保留 Unicode、顺序及完整名单。HTML 没有提供摘要或逐篇 DOI，故 `abstract=null`、标识字典为空；只保存 PDF 链接，不下载研究 PDF。不能把 Research Paper Track 的所有条目推成 main，不能把目录缺席推为 rejected/withdrawn，也不能把出版格式标签当研究类型。
+
+2025 用法：`paper-atlas collect aamas-proceedings --year 2025 --snapshots /data/review/aamas2025 --out /data/paper-index/collected/aamas-2025`；在线模式改用 `--cache /data/paper-index/cache/aamas2025`，只请求上述两个 HTML 页面。快照目录包含原始 `index.html`、`contents.html` 和 `receipts.json`，凭据必须列出各原始 URL、文件、字节数、SHA256、`http_status=200` 和带时区 `at`。已恢复的凭据需保留 `at_precision=filesystem_write_time_recovered` 等说明，不能伪造 HTTP 头或请求时间。2026-11-09 保存的两个页面通过哈希校验；独立录用清单 URL 返回 403，失败保留，不绕过或依赖其完成采集。
+
+2025 命令同样使用目录锁、临时目录、最后写入采集报告。五个 JSONL/manifest 均保持 `partial`，记录摘要缺失数量；它不连接数据库。首次采集需独立核验全部标题/作者/栏目和 source IDs，随后做 PostgreSQL 身份预检、必要的逐条版本审核、原生导入与独立验收。若失败且没有完成报告，应先检查原始响应和错误，再使用新输出目录重跑，不重放已提交批次。代码验证、原始目录盘点和采集成功均不代表已导入生产或最终去重完成。
 
 ## 来源与范围
 

docs/coverage/historical-predecessors-2026-11-09.md

@@ -0,0 +1,53 @@
+# EWSL 与规划会议前身的来源范围
+
+本项扩展 DBLP 元数据适配：核对具体历史卷，保留 EWSL、EPS、ECP、EWSP 原始系列名称，并使用已有会议别名关系关联 ECML-PKDD 或 ICAPS。它不把历史论文的原始会议名称替换成后来的会议，也不从卷的存在推断有逐篇数据。
+
+## 证据与已核验边界
+
+[ECML-PKDD 2011 官方历史页](https://ecmlpkdd2011.org/pastConferences.php)与 [ICAPS 官方系列历史](https://www.icaps-conference.org/conference-series/)分别提供系列前身关系。2026-11-09 冻结页面 SHA-256 为：
+
+- ECML-PKDD：`c3ecdb032aeacf6a365aace5457773827d1405872ad9bc6be6fc05851d5e68d6`。
+- ICAPS：`de1d217660cb819825f58112cdaf774d0f68da6ed87e3e90a59055e52f152081`。
+
+与固定 DBLP 2026-11-01 快照的完整 proceedings 目录对照后，仅对下列具体卷识别前身主系列：
+
+| 原始系列 | 事件年 | DBLP 卷 key | 卷出版年 | 原始逐篇书目计数 |
+|---|---:|---|---:|---:|
+| EWSL | 1987 | `conf/ecml/1987` | 1987 | 16 |
+| EWSL | 1988 | `conf/ecml/1988` | 1988 | 21 |
+| EWSL | 1989 | `conf/ecml/1989` | 1989 | 0 |
+| EWSL | 1991 | `conf/ecml/1991` | 1991 | 44 |
+| EPS | 1990 | `conf/aips/1990` | 1990 | 48 |
+| ECP | 1997 | `conf/ecp/1997` | 1997 | 35 |
+| ECP | 1999 | `conf/ecp/1999` | 2000 | 28 |
+| EWSP | 1991 | `conf/ewsp/1991` | 1991 | 10 |
+
+合计 202 条是原始 `inproceedings` 书目计数，尚未经过前言等材料排除、身份核查与生产验收，不能作为新论文数量。EWSL 1989 在当前 catalogue 中有卷信息，但未匹配到 `inproceedings` 条目；其他记录类型和其他来源仍待核查。代码支持它的范围规则不表示已补上这一年的论文。
+
+核验同时要求来源 family、booktitle 基名、空轨道后缀、完整 proceedings key、完整标题及卷出版年与固定证据一致。邻近年份、标题附加内容、`w` 卷后缀或工作坊 booktitle 均不能继承此范围。ECP、EWSP 及 EPS 的未知卷保持待审。原有 AIPS、ICML/IROS、AISTATS/COLT 规则保持各自边界。
+
+EWSL 的主轨道仍属于 `EWSL`，通过 `ECML-PKDD` 别名纳入家族查询；EPS、ECP、EWSP 保留原名，通过 `ICAPS` 别名关联。`main` 在此表示该原始系列的主轨道。原始 booktitle、作者、论文书目年、卷标题、卷出版年、事件年及历史页 URL 分开保存在 metadata 中。例如 ECP 1999 的事件年 1999 与卷出版年 2000 都保留，不用其中一个覆盖另一个。
+
+## 候选文件与完整快照
+
+旧的窄范围 `dblp-ai-candidates.jsonl` 未纳入 `ecp`、`ewsp` family，但完整 catalogue 的 proceedings 与 volume_counts 中有它们。新的 catalogue 导出会纳入这两个 family。
+
+选择 ICAPS 且截止年达到 EWSP 1991 或 ECP 1997 时，若候选 manifest 缺少相应 family，`collect dblp --candidates` 会明确报错，要求使用原始完整 `--archive`。错误发生在写输出之前，不会把遗漏当作成功采集。选择其他会议或截止 EPS 1990 的旧候选采集不受这项新家族检查影响。
+
+在已确认的远程运行环境中使用完整快照：
+
+```sh
+paper-atlas collect dblp \
+  --catalogue /data/paper-index/collected/dblp/dblp-catalogue.sqlite \
+  --archive /path/to/pinned-dblp.xml.gz --dtd /path/to/pinned-dblp.dtd \
+  --venue ECML-PKDD --venue ICAPS --through-year 2001 \
+  --out /data/paper-index/collected/historical-predecessors
+```
+
+完整快照与 DTD 均沿用现有固定身份校验。该命令也会输出已覆盖的其他年度；生产导入前须单独筛选目标卷与年度，检查 raw source、前言材料、稳定标识、标题、作者及现有投稿，不能直接导入整个输出目录。不会下载论文 PDF。
+
+## 验证和当前限制
+
+回归检查使用独立保存的八卷原始目录 fixture，合成论文只用于隔离测试；不代表真实逐篇来源。检查原始系列/别名、完整标题和年份边界、旧候选文件显式失败、扩展 family 的 catalogue 导出、原生导入后的元数据与关系。
+
+代码、测试、采集和生产导入是不同阶段。新范围不表示本批数据已采集或已导入，更不表示公开拒稿、摘要或最终去重完整。原始书目仅提供发表条目证据，不是原始决定信；没有记录不能推断为拒稿或未举办。后续各批需保留独立验收报告，保护既有跨会投稿、决定与标签历史。

paper_atlas/collectors/aamas.py

@@ -136,6 +136,9 @@ def read_pages(cache=None, snapshots=None):
 
 
 def _collect(year, out, *, cache=None, snapshots=None):
+    if year == 2025:
+        from paper_atlas.collectors.aamas2025 import collect as collect_2025
+        return collect_2025(out, cache=cache, snapshots=snapshots)
     if year != 2012:
         raise ValueError('Only the independently reviewed AAMAS 2012 layout is supported')
     pages, receipts = read_pages(cache, snapshots)
@@ -190,8 +193,8 @@ def _collect(year, out, *, cache=None, snapshots=None):
 
 
 def collect(year, out, *, cache=None, snapshots=None):
-    if year != 2012:
-        raise ValueError('Only the independently reviewed AAMAS 2012 layout is supported')
+    if year not in (2012, 2025):
+        raise ValueError('Only independently reviewed AAMAS 2012/2025 layouts are supported')
     out = Path(out)
     out.mkdir(parents=True, exist_ok=True)
     with (out/'aamas.collect.lock').open('a') as lock:
@@ -201,7 +204,7 @@ def collect(year, out, *, cache=None, snapshots=None):
 
 def main(argv=None, *, prog=None):
     parser = argparse.ArgumentParser(prog=prog)
-    parser.add_argument('--year', type=int, choices=[2012], required=True)
+    parser.add_argument('--year', type=int, choices=[2012, 2025], required=True)
     parser.add_argument('--out', required=True)
     source = parser.add_mutually_exclusive_group(required=True)
     source.add_argument('--cache')

paper_atlas/collectors/aamas2025.py

@@ -0,0 +1,183 @@
+"""Reviewed AAMAS 2025 publisher TOC; HTML metadata only, never paper PDFs."""
+from collections import Counter, defaultdict
+import hashlib
+import json
+from pathlib import Path
+import re
+import tempfile
+
+from paper_atlas.db.submissions import timestamp
+from paper_atlas.io.html import Document, Node, clean
+from paper_atlas.io.http import fetch
+
+ROOT = 'https://www.ifaamas.org/Proceedings/aamas2025/'
+URLS = {'index': ROOT, 'contents': ROOT+'forms/contents.htm'}
+TITLE = 'AAMAS 2025: Proceedings of the 2025 International Conference on Autonomous Agents and Multiagent Systems'
+SECTIONS = {
+    '1': ('Keynote Talks', 'keynote', 'keynote', 3),
+    '2': ('Research Paper Track', 'full_paper', 'proceedings_unspecified', 260),
+    '3': ('Extended Abstracts', 'extended_abstract', 'proceedings_unspecified', 148),
+    '4': ('Blue Sky Ideas', 'blue_sky_paper', 'blue_sky', 12),
+    '5': ('Doctoral Consortium', 'doctoral_abstract', 'doctoral', 25),
+    '6': ('Demo Track', 'demo', 'demo', 22),
+    '7': ('JAAMAS Track', 'journal_presentation', 'jaamas', 9),
+}
+COMPETITION_TITLE = '[COMP24] The Automated Negotiating Agents Competition (ANAC) 2024 Challenges and Results'
+PAPER = re.compile(r'\.\./pdfs/p([0-9]+)\.pdf')
+
+
+def one(items, label):
+    if len(items) != 1:
+        raise ValueError('Expected one '+label)
+    return items[0]
+
+
+def parse_contents(html, evidence):
+    doc = Document(html)
+    if [clean(n.text()) for n in doc.root.walk() if n.tag == 'title'] != [TITLE]:
+        raise ValueError('Unexpected AAMAS proceedings title/year')
+    for paragraph in doc.root.walk():
+        if paragraph.tag != 'p' or any(n is not paragraph and n.tag == 'p' for n in paragraph.walk()):
+            continue
+        anchors = [n.attrs['name'] for n in paragraph.walk() if n.tag == 'a' and n.attrs.get('name') in SECTIONS]
+        if anchors and (len(anchors) != 1 or clean(paragraph.text()) != SECTIONS[anchors[0]][0]):
+            raise ValueError('Publisher section heading differs from reviewed layout')
+    section = None
+    headers = []
+    records, excluded, counts, seen = [], [], Counter(), set()
+    for node in doc.root.walk():
+        if node.tag == 'a' and node.attrs.get('name') in SECTIONS:
+            section = node.attrs['name']
+            headers.append(section)
+        if node.tag != 'p' or any(n is not node and n.tag == 'p' for n in node.walk()):
+            continue
+        links = [n for n in node.walk() if n.tag == 'a' and PAPER.fullmatch(n.attrs.get('href', ''))]
+        if not links:
+            continue
+        link = one(links, 'paper link per paragraph')
+        if section not in SECTIONS:
+            raise ValueError('Paper outside a reviewed publisher section')
+        page = int(PAPER.fullmatch(link.attrs['href'])[1])
+        if page in seen:
+            raise ValueError('Repeated publisher paper/page ID')
+        seen.add(page)
+        title = clean(link.text())
+        if not title:
+            raise ValueError('Empty paper title')
+        # Names are outside italicized affiliations and separated by explicit BRs.
+        font = one([n for n in node.walk() if n.tag == 'font' and n.attrs.get('color', '').lower() == '#222222'], 'ordered author block')
+        authors, affiliations = [], []
+        name, affiliation = '', ''
+        def flush():
+            nonlocal name, affiliation
+            if clean(name) or clean(affiliation):
+                if not clean(name):
+                    raise ValueError('Affiliation without author')
+                authors.append(clean(name)); affiliations.append(clean(affiliation))
+            name, affiliation = '', ''
+        for child in font.children:
+            if isinstance(child, str):
+                name += child
+            elif child.tag == 'br':
+                flush()
+            elif child.tag == 'i':
+                affiliation += child.text()
+            else:
+                raise ValueError('Unreviewed author markup: '+child.tag)
+        flush()
+        if not authors:
+            raise ValueError('Empty author list')
+        heading, publication_format, track, _ = SECTIONS[section]
+        counts[section] += 1
+        if section == '1':
+            excluded.append({'publisher_page': page, 'title': title, 'authors': authors, 'reason': 'publisher keynote talk, not a research-paper submission'})
+            continue
+        note = 'Explicit publisher section; section topics are not research types.'
+        if track == 'proceedings_unspecified':
+            note = 'Published format is known; individual main/special submission track is not provided.'
+        if page == 3000:
+            if section != '6' or title != COMPETITION_TITLE:
+                raise ValueError('Competition report differs from reviewed publisher entry')
+            publication_format, track = 'competition_report', 'proceedings_unspecified'
+            note = 'Publisher places this competition report in Demo Track; no individual demonstration submission is inferred.'
+        records.append({
+            'source': 'aamas_proceedings', 'external_id': '2025/p'+str(page),
+            'url': URLS['contents']+'#'+section, 'title': title, 'abstract': None,
+            'authors': authors, 'identifiers': {}, 'venue': 'AAMAS', 'venue_aliases': [],
+            'year': 2025, 'track': track, 'status': 'accepted',
+            'observed_at': evidence['observed_at'],
+            'raw_decision': 'listed in official AAMAS 2025 published proceedings '+heading,
+            'tags': [{'namespace': 'aamas_proceedings:publication_format', 'value': publication_format}],
+            'metadata': {'publisher_page': page, 'paper_url': ROOT+'pdfs/p'+str(page)+'.pdf',
+                         'section_url': URLS['contents'], 'section_anchor': section,
+                         'section_heading': heading, 'publication_format': publication_format,
+                         'author_affiliations': affiliations, 'source_evidence': evidence,
+                         'track_scope_note': note, 'decision_date_precision': 'not_supplied',
+                         'missing_abstract_reason': 'Publisher HTML supplies no abstract; research PDF not downloaded.',
+                         'publication_evidence': 'Published proceedings entry, not an original decision note.'}})
+    if headers != list(SECTIONS) or dict(counts) != {k: v[3] for k, v in SECTIONS.items()}:
+        raise ValueError('Publisher section inventory differs from reviewed 2025 layout')
+    if len(records) != 476 or len(excluded) != 3 or sum(r['metadata']['publication_format'] == 'competition_report' for r in records) != 1:
+        raise ValueError('Unexpected publication partition')
+    return records, excluded
+
+
+def read_pages(cache, snapshots):
+    if bool(cache) == bool(snapshots):
+        raise ValueError('Choose exactly one cache or frozen snapshot directory')
+    frozen = json.loads((Path(snapshots)/'receipts.json').read_text())['receipts'] if snapshots else []
+    pages = {}
+    for key, url in URLS.items():
+        if snapshots:
+            r = one([r for r in frozen if r['url'] == url], 'frozen response receipt')
+            filename = Path(r['file']); base = Path(snapshots).resolve()
+            if filename.is_absolute() or '..' in filename.parts or not (base/filename).resolve().is_relative_to(base) or r.get('http_status') != 200:
+                raise ValueError('Unsafe or unsuccessful publisher response')
+            data = (base/filename).read_bytes()
+            if len(data) > 8*1024**2 or len(data) != r['bytes'] or hashlib.sha256(data).hexdigest() != r['sha256']:
+                raise ValueError('Frozen publisher response checksum/size mismatch')
+            observed = r['at']
+        else:
+            data = fetch(url, cache, 8*1024**2, delay=1)
+            r = json.loads((Path(cache)/hashlib.sha256(url.encode()).hexdigest()).with_suffix('.json').read_text())
+            observed = r['retrieved_at']
+        timestamp(observed)
+        pages[key] = data, {'url': url, 'sha256': hashlib.sha256(data).hexdigest(), 'bytes': len(data),
+                            'file': 'evidence/'+hashlib.sha256(data).hexdigest()+'.html',
+                            'observed_at': observed, 'http_status': 200, 'response_receipt': r}
+    return pages
+
+
+def collect(out, *, cache=None, snapshots=None):
+    pages = read_pages(cache, snapshots)
+    if [clean(n.text()) for n in Document(pages['index'][0].decode('utf-8')).root.walk() if n.tag == 'title'] != [TITLE]:
+        raise ValueError('Unexpected AAMAS 2025 introduction')
+    records, excluded = parse_contents(pages['contents'][0].decode('utf-8'), pages['contents'][1])
+    grouped = defaultdict(list)
+    for row in records: grouped[row['track']].append(row)
+    out = Path(out); out.mkdir(parents=True, exist_ok=True); files = []
+    with tempfile.TemporaryDirectory(prefix='.aamas2025-', dir=out) as temporary:
+        stage = Path(temporary); (stage/'evidence').mkdir()
+        for data, e in pages.values(): (stage/e['file']).write_bytes(data)
+        for track, group in sorted(grouped.items()):
+            p = stage/f'aamas-proceedings-2025-{track}.jsonl'
+            p.write_text(''.join(json.dumps(r, ensure_ascii=False)+'\n' for r in group))
+            m = {'source': 'aamas_proceedings', 'parser_version': 2, 'venue': 'AAMAS', 'year': 2025,
+                 'track': track, 'count': len(group), 'file': str(out/p.name), 'file_sha256': hashlib.sha256(p.read_bytes()).hexdigest(),
+                 'list_url': URLS['contents'], 'status': 'partial', 'missing_abstract_count': len(group),
+                 'publication_format_counts': dict(Counter(r['metadata']['publication_format'] for r in group)),
+                 'note': 'Complete published TOC partition; HTML abstracts absent, identities and submission-track scope require independent review.'}
+            p.with_suffix('.manifest.json').write_text(json.dumps(m, ensure_ascii=False, indent=2)+'\n'); files.append(m)
+        result = {'source': 'aamas_proceedings', 'year': 2025, 'finished_at': timestamp(),
+                  'status': 'collected_pending_identity_review', 'records': len(records), 'files': files,
+                  'excluded_publications': excluded, 'source_receipts': [e for _, e in pages.values()],
+                  'publication_format_counts': dict(Counter(r['metadata']['publication_format'] for r in records)),
+                  'database_written': False, 'pdfs_downloaded': False,
+                  'note': 'Neither absence from proceedings nor aggregate rejection/withdrawal counts identify an individual negative decision.'}
+        report = 'aamas-proceedings-2025.json'; (stage/report).write_text(json.dumps(result, ensure_ascii=False, indent=2)+'\n')
+        (out/'evidence').mkdir(exist_ok=True)
+        for p in (stage/'evidence').iterdir(): p.replace(out/'evidence'/p.name)
+        for p in stage.iterdir():
+            if p.is_file() and p.name != report: p.replace(out/p.name)
+        (stage/report).replace(out/report)
+    return result

paper_atlas/collectors/dblp.py

@@ -20,7 +20,7 @@ DTD_MD5='96e4283e71886dec2173718957293648'
 DTD_NAMES={'dblp.dtd','dblp-2023-06-28.dtd'}
 RELEASE='https://doi.org/10.4230/dblp.xml.2026-11-01'
 # Broad discovery candidates, including historical names; not a venue mapping.
-FAMILIES=set('nips icml iclr colm colt aistats uai clear acl emnlp naacl eacl coling conll cvpr iccv eccv aaai ijcai ecai kdd sigir www wsdm recsys cikm icdm sdm ecml pkdd ecmlpkdd icra iros rss corl aips icaps kr atal aamas icassp interspeech eurospeech icslp ismir miccai fat facct lrec mm mlsys'.split())
+FAMILIES=set('nips icml iclr colm colt aistats uai clear acl emnlp naacl eacl coling conll cvpr iccv eccv aaai ijcai ecai kdd sigir www wsdm recsys cikm icdm sdm ecml pkdd ecmlpkdd icra iros rss corl aips icaps ecp ewsp kr atal aamas icassp interspeech eurospeech icslp ismir miccai fat facct lrec mm mlsys'.split())
 
 
 def records(archive,dtd_bytes):

paper_atlas/collectors/dblp_predecessors.py

@@ -0,0 +1,45 @@
+"""Exact predecessor volumes, with original names and independent family histories."""
+ECML_HISTORY = 'https://ecmlpkdd2011.org/pastConferences.php'
+ICAPS_HISTORY = 'https://www.icaps-conference.org/conference-series/'
+
+# family/year: booktitle, original series, target family, publication year, full title
+VOLUMES = {
+    ('ecml', 1987): ('EWSL', 'EWSL', 'ECML-PKDD', 1987,
+        'Progress in Machine Learning - Proceedings of EWSL 87: 2nd European Working Session on Learning, Bled, Yugoslavia, May 1987'),
+    ('ecml', 1988): ('EWSL', 'EWSL', 'ECML-PKDD', 1988,
+        'Proceedings of the Third European Working Session on Learning, EWSL 1988, Turing Institute, Glasgow, UK, October 3-5, 1988'),
+    ('ecml', 1989): ('EWSL', 'EWSL', 'ECML-PKDD', 1989,
+        'Proceedings of the 4th European Working Session on Learning, Montpellier, France, 4-6 December 1989'),
+    ('ecml', 1991): ('EWSL', 'EWSL', 'ECML-PKDD', 1991,
+        'Machine Learning - EWSL-91, European Working Session on Learning, Porto, Portugal, March 6-8, 1991, Proceedings'),
+    ('aips', 1990): ('Expert Planning Systems', 'EPS', 'ICAPS', 1990,
+        'Proceedings of the First International Conference on Expert Planning Systems, Brighton, UK, June 27-29, 1990'),
+    ('ecp', 1997): ('ECP', 'ECP', 'ICAPS', 1997,
+        "Recent Advances in AI Planning, 4th European Conference on Planning, ECP'97, Toulouse, France, September 24-26, 1997, Proceedings"),
+    ('ecp', 1999): ('ECP', 'ECP', 'ICAPS', 2000,
+        "Recent Advances in AI Planning, 5th European Conference on Planning, ECP'99, Durham, UK, September 8-10, 1999, Proceedings"),
+    ('ewsp', 1991): ('EWSP', 'EWSP', 'ICAPS', 1991,
+        "European Workshop on Planning, EWSP '91, Sankt Augustin, Germany, March 18-19, 1991, Proceedings"),
+}
+
+
+def predecessor_scope(family, base, suffix, volume, year, title):
+    definition = VOLUMES.get((family, year))
+    if definition is None:
+        return None
+    book, original, target, publication_year, expected_title = definition
+    if (suffix or base != book or volume['key'] != f'conf/{family}/{year}'
+            or title != expected_title or volume['fields'].get('year') != [str(publication_year)]):
+        return None
+    return {'original_series': original, 'target_family': target,
+            'history_url': ECML_HISTORY if target == 'ECML-PKDD' else ICAPS_HISTORY,
+            'proceedings_key': volume['key'], 'proceedings_title': title,
+            'event_year': year, 'proceedings_year_fields': list(volume['fields']['year'])}
+
+
+def missing_candidate_families(targets, families, through_year):
+    # These two families were absent from the earlier narrowed candidate JSONL,
+    # although their proceedings and volume_counts exist in the full catalogue.
+    required = {family for (family, year), definition in VOLUMES.items()
+                if family in ('ecp', 'ewsp') and definition[2] in targets and year <= through_year}
+    return sorted(family for family in required if not families.get(family))

paper_atlas/collectors/dblp_records.py

@@ -15,6 +15,7 @@ from urllib.parse import parse_qs,unquote,urlsplit
 from paper_atlas.config import DEFAULT_REGISTRY
 from paper_atlas.collectors.dblp import XML_SHA,DTD_MD5,RELEASE,records
 from paper_atlas.collectors.dblp_scope import scope
+from paper_atlas.collectors.dblp_predecessors import missing_candidate_families
 from paper_atlas.db.submissions import timestamp
 from paper_atlas.io.snapshots import digest_file
 from paper_atlas.io.publication_ids import mlsys_id
@@ -88,6 +89,8 @@ def normalize_row(row,volumes,targets,include_workshops=False,through_year=2026)
               'scope_rule':edition['rule'],'author_names_raw':fields.get('author',[]),'publtype':row.get('publtype'),
               'bibliography':{key:value for key,value in fields.items() if key in ('booktitle','year','ee','url','pages','volume','number','publisher','series','isbn')},
               'ambiguous_identifiers':ambiguous,'publication_evidence':'inproceedings bibliography; not an original decision note'}
+    if edition.get('historical_predecessor_evidence'):
+        metadata['historical_predecessor_evidence'] = edition['historical_predecessor_evidence']
     if edition.get('joint_edition_evidence'):
         metadata['joint_edition_evidence'] = edition['joint_edition_evidence']
     if edition.get('track_scope_note'):
@@ -124,8 +127,9 @@ def collect(catalogue,out,venues=None,candidates=None,archive=None,dtd=None,incl
         families = manifest.get('candidate_family_counts', {})
         missing = [venue for venue, family in [('MM', 'mm'), ('MLSys', 'mlsys')]
                    if venue in targets and not families.get(family)]
+        missing += ['ICAPS/'+family for family in missing_candidate_families(targets, families, through_year)]
         if missing:
-            raise ValueError('Candidate file predates requested families ' + ', '.join(missing) + '; use the original --archive')
+            raise ValueError('Candidate file omits requested families ' + ', '.join(missing) + '; use the original --archive')
     out=Path(out);out.mkdir(parents=True,exist_ok=True)
     with (out/'dblp.normalize.lock').open('a') as lock:
         fcntl.flock(lock,fcntl.LOCK_EX|fcntl.LOCK_NB)

paper_atlas/collectors/dblp_scope.py

@@ -1,6 +1,8 @@
 """Explicit bibliographic aliases; a directory family alone is not venue evidence."""
 import re
 
+from paper_atlas.collectors.dblp_predecessors import predecessor_scope
+
 
 # Ordered long/joint names precede their shorter forms.
 BOOKS = {
@@ -27,7 +29,8 @@ BOOKS = {
     'pkdd':[('ECML/PKDD','ECML-PKDD',[]),('ECML PKDD','ECML-PKDD',[]),('PKDD','PKDD',['ECML-PKDD'])],
     'icra':[('ICRA','ICRA',[])], 'iros':[('IROS','IROS',[])],
     'rss':[('Robotics: Science and Systems','RSS',[])], 'corl':[('CoRL','CoRL',[])],
-    'aips':[('ICAPS','ICAPS',[]),('AIPS','AIPS',['ICAPS'])], 'icaps':[('ICAPS','ICAPS',[])],
+    'aips':[('ICAPS','ICAPS',[]),('AIPS','AIPS',['ICAPS']),('Expert Planning Systems','EPS',['ICAPS'])], 'icaps':[('ICAPS','ICAPS',[])],
+    'ecp':[('ECP','ECP',['ICAPS'])], 'ewsp':[('EWSP','EWSP',['ICAPS'])],
     'kr':[('KR','KR',[])], 'atal':[('AAMAS','AAMAS',[])],
     'icassp':[('ICASSP','ICASSP',[])],
     'interspeech':[('INTERSPEECH','INTERSPEECH',[]),('EUROSPEECH','EUROSPEECH',['INTERSPEECH']),('ICSLP','ICSLP',['INTERSPEECH']),('ECST','ECST',['INTERSPEECH'])],
@@ -135,7 +138,11 @@ def scope(row,volume,through_year=2026):
     if len(bibliographic)!=1 or not re.fullmatch(r'\d{4}',bibliographic[0]):return None,'ambiguous_bibliographic_year'
     if int(bibliographic[0])!=year and not re.search(r'\b'+str(year)+r'\b',title):return None,'unverified_year_difference'
     text=(suffix+' '+title).casefold();track='main'
-    historical = historical_track(family, base, suffix, volume['key'], year, title)
+    predecessor = predecessor_scope(family, base, suffix, volume, year, title)
+    if (family in ('ecp', 'ewsp') or (family == 'aips' and base == 'Expert Planning Systems')) and not predecessor:
+        return None, 'unverified_historical_predecessor'
+    historical = (('main', 'Historical predecessor; exact volume, full title, event and publication years verified; original series retained.', predecessor['history_url'])
+                  if predecessor else historical_track(family, base, suffix, volume['key'], year, title))
     if historical:track=historical[0]
     elif 'findings' in text:track='findings'
     elif 'shared task' in text:track='shared_task'
@@ -165,6 +172,8 @@ def scope(row,volume,through_year=2026):
         joint_evidence = 'https://www.eurai.org/ecai/history'
     result = {'venue':venue,'venue_aliases':aliases,'year':year,'track':track,'bibliographic_year':int(bibliographic[0]),
               'rule':family+':'+base,'proceedings_title':title,'edition_year_basis':year_basis}
+    if predecessor:
+        result['historical_predecessor_evidence'] = predecessor
     if joint_evidence:
         result['joint_edition_evidence'] = joint_evidence
     if historical:

tests/fixtures/aamas2025/index.html

@@ -0,0 +1,54 @@
+<HTML><HEAD><TITLE>AAMAS 2025: Proceedings of the 2025 International Conference on Autonomous Agents and Multiagent Systems</TITLE>
+<META http-equiv=Content-Type content="text/html; charset=utf-8"><LINK 
+href="forms/index_files/factemplate.css" type=text/css rel=stylesheet>
+<META content="MSHTML 6.00.2900.3562" name=GENERATOR></HEAD>
+<BODY bgcolor="#010101" bgproperties="fixed"><DIV style="TEXT-ALIGN: center" >
+<table width="724" border="0" align="center" cellpadding="0" cellspacing="0" valign="top">
+  <td colspan="2" align="center" valign="top" bgcolor="#FFFFFF"><img src="forms/index_files/aamas25.png" width="750" height="300" alt=""/></td>
+  </tr>
+  <tr bgcolor="#FFFFFF"> 
+    <td width="125" align="center" valign="top" bgcolor="#FFFFFF"><table width="125" border="1" align="center" cellpadding="1" cellspacing="1" bordercolor="#444444" style="margin-bottom: 2">
+        <tr> 
+          <td bgcolor="#FFFFFF"><p style="text-indent: 0; margin-left: 6; margin-right: 6; margin-top: 5; margin-bottom: 4" align="left"><A href="forms/index.htm">Main 
+              Page</A></p></td>
+        </tr>
+        <tr> 
+          <td bgcolor="#FFFFFF"><p style="text-indent: 0; margin-left: 6; margin-right: 6; margin-top: 5; margin-bottom: 4" align="left"><A href="forms/contents.htm">Table 
+              of Contents</A></p></td>
+        </tr>
+      </table></td>
+    <td width="599"><p style="text-indent: 0; margin-left: 12; margin-right: 14; margin-top: 12; margin-bottom: 12" align="left"><font color="#010101" size="4" face="Arial, Helvetica, sans-serif"><strong>Welcome 
+        to the Proceedings of AAMAS-2025</strong></font></p>
+      <p style="text-indent: 0; margin-left: 12; margin-right: 14; margin-top: 12; margin-bottom: 12;" align="left"><font color="#333333" size="2" face="Times New Roman, Times, serif">These 
+        are the proceedings of the 24th International Conference on Autonomous 
+        Agents and Multiagent Systems (AAMAS-2025). They are published by the 
+        International Foundation for Autonomous Agents and Multiagent Systems 
+    (IFAAMAS).</font></p></td>
+  </tr>
+  <tr bgcolor="#FFFFFF"> 
+    <td align="center" valign="middle" bgcolor="#FFFFFF">&nbsp;</td>
+    <td><table width="96%" border="0" cellspacing="2" cellpadding="2">
+        <tr align="left" valign="top"> 
+          <td> <p style="text-indent: 0; margin-left: 12; margin-right: 6; margin-top: 0; margin-bottom: 6;" align="left"><font color="#333333" face="Times New Roman, Times, serif"><font size="2"><strong>ISBN: 979-8-4007-1426-9</strong></font></font></p></td>
+          <td> <p style="text-indent: 0; margin-left: 12; margin-right: 6; margin-top: 0; margin-bottom: 6;" align="left"><font color="#333333" face="Times New Roman, Times, serif"></font></p></td>
+        </tr>
+        <tr> 
+          <td width="42%"><div align="left"><img src="forms/index_files/ifaamas.jpg" width="256" height="104"></div></td>
+          <td width="58%"><div align="center"><img src="forms/index_files/ACM-In-Cooperation_medium.jpg" width="285" height="86"></div></td>
+        </tr>
+      </table>
+      <p style="text-indent: 0; margin-left: 12; margin-right: 14; margin-top: 12; margin-bottom: 12;" align="left"><font color="#333333" size="2" face="Times New Roman, Times, serif">Copyright 
+        &copy; 2025 by International Foundation for Autonomous Agents and Multiagent 
+        Systems (IFAAMAS). Permission to make digital or hard copies of portions 
+        of this work for personal or classroom use is granted without fee provided 
+        that copies are not made or distributed for profit or commercial advantage 
+        and that copies bear this notice and the full citation on the first page. 
+        Copyright for components of this work owned by others than IFAAMAS must 
+        be honored. Abstracting with credit is permitted. To copy otherwise, to 
+        republish, to post on servers or to redistribute to lists, requires prior 
+    specific permission and/or a fee. </font></p></td>
+  </tr>
+</table>
+  <p>&nbsp;</p>
+
+</BODY></HTML>

tests/fixtures/aamas2025/receipts.json

@@ -0,0 +1,38 @@
+{
+  "status": "two_successful_official_metadata_pages_recovered_third403_not_retried",
+  "receipts": [
+    {
+      "file": "index.html",
+      "url": "https://www.ifaamas.org/Proceedings/aamas2025/",
+      "bytes": 4107,
+      "sha256": "850b7825c66d0147ac8a8bbf03a554590e4a9e8f4b5c576e043999bbd43317f4",
+      "at": "2026-11-09T12:31:49.347577+00:00",
+      "at_precision": "filesystem_write_time_recovered",
+      "http_status": 200,
+      "content_type": "text/html",
+      "receipt_recovered": true,
+      "scope": "Collectorasserted200/htmlbeforewrite;request3acceptedprogram403;noheaders/finalredirectURLpersisted;no refetch or rawbytesmutation."
+    },
+    {
+      "file": "contents.html",
+      "url": "https://www.ifaamas.org/Proceedings/aamas2025/forms/contents.htm",
+      "bytes": 370650,
+      "sha256": "732847b51972f34c721a49d8bd963a80a029a48f3ec08022c9a0d5ddc2945549",
+      "at": "2026-11-09T12:31:52.006642+00:00",
+      "at_precision": "filesystem_write_time_recovered",
+      "http_status": 200,
+      "content_type": "text/html",
+      "receipt_recovered": true,
+      "scope": "Collectorasserted200/htmlbeforewrite;request3acceptedprogram403;noheaders/finalredirectURLpersisted;no refetch or rawbytesmutation."
+    }
+  ],
+  "failed_url": "https://aamas2025.org/index.php/conference/program/accepted-papers/",
+  "not_attempted_url": "https://aamas2025.org/index.php/conference/calls/submission-instructions-main-technical-track/",
+  "original_error": {
+    "error": "HTTP Error 403: Forbidden",
+    "type": "HTTPError",
+    "downloaded": 2
+  },
+  "research_fulltext_downloaded": false,
+  "database_written": false
+}

tests/fixtures/historical_predecessors.json

@@ -0,0 +1,314 @@
+{
+  "source_snapshot_sha256": "0376ad019b216553faff0a14e1757b2d4c7a3b84c1beacf0511ef83695211b18",
+  "scope": "Pinned proceedings metadata, not authentic example paper records or evidence that all volumes contain indexed papers. Test papers are synthetic.",
+  "volumes": [
+    {
+      "key": "conf/ecml/1987",
+      "fields": {
+        "editor": [
+          "Ivan Bratko",
+          "Nada Lavrac"
+        ],
+        "title": [
+          "Progress in Machine Learning - Proceedings of EWSL 87: 2nd European Working Session on Learning, Bled, Yugoslavia, May 1987"
+        ],
+        "booktitle": [
+          "EWSL"
+        ],
+        "publisher": [
+          "Sigma Press, Wilmslow"
+        ],
+        "year": [
+          "1987"
+        ],
+        "isbn": [
+          "1-85058-088-X"
+        ],
+        "url": [
+          "db/conf/ecml/ewsl87.html"
+        ]
+      },
+      "bibliographic_counts": [
+        {
+          "year": "1987",
+          "booktitle": "EWSL",
+          "record_type": "inproceedings",
+          "count": 16
+        }
+      ],
+      "expected_original_series": "EWSL",
+      "expected_target_family": "ECML-PKDD"
+    },
+    {
+      "key": "conf/ecml/1988",
+      "fields": {
+        "editor": [
+          "Derek H. Sleeman"
+        ],
+        "title": [
+          "Proceedings of the Third European Working Session on Learning, EWSL 1988, Turing Institute, Glasgow, UK, October 3-5, 1988"
+        ],
+        "booktitle": [
+          "EWSL"
+        ],
+        "publisher": [
+          "Pitman Publishing"
+        ],
+        "year": [
+          "1988"
+        ],
+        "isbn": [
+          "0-273-08800-9"
+        ],
+        "url": [
+          "db/conf/ecml/ewsl88.html"
+        ]
+      },
+      "bibliographic_counts": [
+        {
+          "year": "1988",
+          "booktitle": "EWSL",
+          "record_type": "inproceedings",
+          "count": 21
+        }
+      ],
+      "expected_original_series": "EWSL",
+      "expected_target_family": "ECML-PKDD"
+    },
+    {
+      "key": "conf/ecml/1989",
+      "fields": {
+        "editor": [
+          "Katharina Morik"
+        ],
+        "title": [
+          "Proceedings of the 4th European Working Session on Learning, Montpellier, France, 4-6 December 1989"
+        ],
+        "booktitle": [
+          "EWSL"
+        ],
+        "publisher": [
+          "Pitman and Morgan Kaufman Publishers"
+        ],
+        "year": [
+          "1989"
+        ]
+      },
+      "bibliographic_counts": [],
+      "expected_original_series": "EWSL",
+      "expected_target_family": "ECML-PKDD"
+    },
+    {
+      "key": "conf/ecml/1991",
+      "fields": {
+        "editor": [
+          "Yves Kodratoff"
+        ],
+        "title": [
+          "Machine Learning - EWSL-91, European Working Session on Learning, Porto, Portugal, March 6-8, 1991, Proceedings"
+        ],
+        "booktitle": [
+          "EWSL"
+        ],
+        "series": [
+          "Lecture Notes in Computer Science"
+        ],
+        "volume": [
+          "482"
+        ],
+        "publisher": [
+          "Springer"
+        ],
+        "year": [
+          "1991"
+        ],
+        "isbn": [
+          "3-540-53816-X"
+        ],
+        "ee": [
+          "https://doi.org/10.1007/BFb0016999"
+        ],
+        "url": [
+          "db/conf/ecml/ewsl91.html"
+        ]
+      },
+      "bibliographic_counts": [
+        {
+          "year": "1991",
+          "booktitle": "EWSL",
+          "record_type": "inproceedings",
+          "count": 44
+        }
+      ],
+      "expected_original_series": "EWSL",
+      "expected_target_family": "ECML-PKDD"
+    },
+    {
+      "key": "conf/ecp/1997",
+      "fields": {
+        "editor": [
+          "Sam Steel",
+          "Rachid Alami 0001"
+        ],
+        "title": [
+          "Recent Advances in AI Planning, 4th European Conference on Planning, ECP'97, Toulouse, France, September 24-26, 1997, Proceedings"
+        ],
+        "booktitle": [
+          "ECP"
+        ],
+        "series": [
+          "Lecture Notes in Computer Science"
+        ],
+        "volume": [
+          "1348"
+        ],
+        "publisher": [
+          "Springer"
+        ],
+        "year": [
+          "1997"
+        ],
+        "isbn": [
+          "3-540-63912-8"
+        ],
+        "ee": [
+          "https://doi.org/10.1007/3-540-63912-8"
+        ],
+        "url": [
+          "db/conf/ecp/ecp1997.html"
+        ]
+      },
+      "bibliographic_counts": [
+        {
+          "year": "1997",
+          "booktitle": "ECP",
+          "record_type": "inproceedings",
+          "count": 35
+        }
+      ],
+      "expected_original_series": "ECP",
+      "expected_target_family": "ICAPS"
+    },
+    {
+      "key": "conf/ecp/1999",
+      "fields": {
+        "editor": [
+          "Susanne Biundo",
+          "Maria Fox 0001"
+        ],
+        "title": [
+          "Recent Advances in AI Planning, 5th European Conference on Planning, ECP'99, Durham, UK, September 8-10, 1999, Proceedings"
+        ],
+        "booktitle": [
+          "ECP"
+        ],
+        "series": [
+          "Lecture Notes in Computer Science"
+        ],
+        "volume": [
+          "1809"
+        ],
+        "publisher": [
+          "Springer"
+        ],
+        "year": [
+          "2000"
+        ],
+        "isbn": [
+          "3-540-67866-2"
+        ],
+        "ee": [
+          "https://doi.org/10.1007/10720246"
+        ],
+        "url": [
+          "db/conf/ecp/ecp1999.html"
+        ]
+      },
+      "bibliographic_counts": [
+        {
+          "year": "1999",
+          "booktitle": "ECP",
+          "record_type": "inproceedings",
+          "count": 28
+        }
+      ],
+      "expected_original_series": "ECP",
+      "expected_target_family": "ICAPS"
+    },
+    {
+      "key": "conf/ewsp/1991",
+      "fields": {
+        "editor": [
+          "Joachim Hertzberg"
+        ],
+        "title": [
+          "European Workshop on Planning, EWSP '91, Sankt Augustin, Germany, March 18-19, 1991, Proceedings"
+        ],
+        "booktitle": [
+          "EWSP"
+        ],
+        "series": [
+          "Lecture Notes in Computer Science"
+        ],
+        "volume": [
+          "522"
+        ],
+        "publisher": [
+          "Springer"
+        ],
+        "year": [
+          "1991"
+        ],
+        "isbn": [
+          "3-540-54364-3"
+        ],
+        "ee": [
+          "https://doi.org/10.1007/BFb0052944"
+        ],
+        "url": [
+          "db/conf/ewsp/ewsp1991.html"
+        ]
+      },
+      "bibliographic_counts": [
+        {
+          "year": "1991",
+          "booktitle": "EWSP",
+          "record_type": "inproceedings",
+          "count": 10
+        }
+      ],
+      "expected_original_series": "EWSP",
+      "expected_target_family": "ICAPS"
+    },
+    {
+      "key": "conf/aips/1990",
+      "fields": {
+        "title": [
+          "Proceedings of the First International Conference on Expert Planning Systems, Brighton, UK, June 27-29, 1990"
+        ],
+        "booktitle": [
+          "Expert Planning Systems"
+        ],
+        "publisher": [
+          "AAAI"
+        ],
+        "year": [
+          "1990"
+        ],
+        "url": [
+          "db/conf/aips/aips1990.html"
+        ]
+      },
+      "bibliographic_counts": [
+        {
+          "year": "1990",
+          "booktitle": "Expert Planning Systems",
+          "record_type": "inproceedings",
+          "count": 48
+        }
+      ],
+      "expected_original_series": "EPS",
+      "expected_target_family": "ICAPS"
+    }
+  ]
+}

tests/test_aamas2025.py

@@ -0,0 +1,85 @@
+import hashlib
+import json
+from pathlib import Path
+import tempfile
+import unittest
+from unittest.mock import patch
+
+from paper_atlas.collectors import aamas, aamas2025
+
+
+FIXTURE = Path(__file__).parent/'fixtures/aamas2025'
+
+
+class Aamas2025Tests(unittest.TestCase):
+    def parse(self, html=None):
+        return aamas2025.parse_contents(html or (FIXTURE/'contents.html').read_text(),
+            {'observed_at': '2026-11-09T12:31:50+00:00', 'url': aamas2025.URLS['contents']})
+
+    def test_real_toc_preserves_every_title_author_and_affiliation(self):
+        expected = json.loads((FIXTURE/'expected-authors.json').read_text())
+        self.assertEqual(hashlib.sha256((FIXTURE/'contents.html').read_bytes()).hexdigest(), expected['source_sha256'])
+        rows, excluded = self.parse()
+        self.assertEqual((len(rows), len(excluded)), (476, 3))
+        by_url = {r['paper_url']: r for r in expected['entries']}
+        for row in rows:
+            original = by_url[row['metadata']['paper_url']]
+            self.assertEqual(row['title'], original['title'])
+            self.assertEqual(row['authors'], [a['name'] for a in original['authors']])
+            self.assertEqual(row['metadata']['author_affiliations'], [a['affiliation'] for a in original['authors']])
+            self.assertIsNone(row['abstract'])
+            self.assertEqual(row['identifiers'], {})
+            self.assertEqual(row['status'], 'accepted')
+            self.assertNotIn('decision_date', row)
+            self.assertTrue(all(t['namespace'] == 'aamas_proceedings:publication_format' for t in row['tags']))
+
+    def test_publication_format_and_track_are_separate(self):
+        rows, excluded = self.parse()
+        groups = {k: sum(r['track'] == k for r in rows) for k in {r['track'] for r in rows}}
+        self.assertEqual(groups, {'proceedings_unspecified': 409, 'blue_sky': 12, 'doctoral': 25, 'demo': 21, 'jaamas': 9})
+        competition = next(r for r in rows if r['external_id'] == '2025/p3000')
+        self.assertEqual(competition['year'], 2025)
+        self.assertEqual(competition['metadata']['publication_format'], 'competition_report')
+        self.assertEqual(competition['metadata']['section_heading'], 'Demo Track')
+        self.assertEqual(competition['track'], 'proceedings_unspecified')
+        self.assertEqual(len({r['external_id'] for r in rows}), 476)
+        self.assertEqual([r['publisher_page'] for r in excluded], [1, 3, 4])
+
+    def test_refuses_changed_edition_inventory_or_author_markup(self):
+        original = (FIXTURE/'contents.html').read_text()
+        for html in [original.replace('AAMAS 2025:', 'AAMAS 2026:', 1),
+                     original.replace('../pdfs/p5.pdf', '../pdfs/p14.pdf', 1),
+                     original.replace('Paper Track</font>', 'Workshop Track</font>'),
+                     original.replace('Amir Abolfazli', '', 1),
+                     original.replace('[COMP24]', '[CHANGED]', 1)]:
+            with self.subTest(change=html[:60]):
+                with self.assertRaises(ValueError): self.parse(html)
+
+    def test_frozen_collection_is_partial_and_never_fetches_pdfs(self):
+        with tempfile.TemporaryDirectory() as tmp, patch.object(aamas2025, 'fetch', side_effect=AssertionError('No HTTP in frozen mode')):
+            out = Path(tmp)/'out'
+            report = aamas.collect(2025, out, snapshots=FIXTURE)
+            self.assertEqual(report['records'], 476)
+            self.assertFalse(report['database_written'])
+            self.assertFalse(report['pdfs_downloaded'])
+            self.assertEqual(len(report['files']), 5)
+            for m in report['files']:
+                self.assertEqual(m['status'], 'partial')
+                self.assertEqual(m['missing_abstract_count'], m['count'])
+                self.assertEqual(hashlib.sha256(Path(m['file']).read_bytes()).hexdigest(), m['file_sha256'])
+            receipt = report['source_receipts'][0]['response_receipt']
+            self.assertEqual(receipt['at_precision'], 'filesystem_write_time_recovered')
+            self.assertTrue((out/'aamas-proceedings-2025.json').is_file())
+
+    def test_rejects_tampered_or_unsafe_frozen_response(self):
+        import shutil
+        for mode in ['tamper', 'path', 'status']:
+            with self.subTest(mode=mode), tempfile.TemporaryDirectory() as tmp:
+                root = Path(tmp); source = root/'source'; shutil.copytree(FIXTURE, source)
+                p = source/'receipts.json'; r = json.loads(p.read_text())
+                if mode == 'tamper': (source/'contents.html').write_text('bad')
+                elif mode == 'path': r['receipts'][0]['file'] = '../index.html'
+                else: r['receipts'][0]['http_status'] = 403
+                p.write_text(json.dumps(r))
+                with self.assertRaises(ValueError): aamas.collect(2025, root/'out', snapshots=source)
+                self.assertFalse((root/'out/aamas-proceedings-2025.json').exists())

tests/test_aamas_proceedings.py

@@ -99,7 +99,7 @@ class AamasProceedingsTests(unittest.TestCase):
                 aamas.collect(2012, root/'out', snapshots=source)
             self.assertFalse((root/'out/aamas-proceedings-2012.json').exists())
             with self.assertRaises(ValueError):
-                aamas.collect(2025, root/'future', snapshots=source)
+                aamas.collect(2026, root/'future', snapshots=source)
             self.assertFalse((root/'future').exists())
 
     def test_ids_colliding_across_sections_do_not_produce_a_completed_collection(self):

tests/test_historical_predecessors.py

@@ -0,0 +1,151 @@
+"""Original series, exact edition boundaries, and complete candidate discovery."""
+from contextlib import closing
+from copy import deepcopy
+import gzip
+import hashlib
+import json
+from pathlib import Path
+import sqlite3
+import tempfile
+import unittest
+from types import SimpleNamespace
+from unittest.mock import patch
+
+from paper_atlas.collectors.dblp import catalogue, XML_SHA
+from paper_atlas.collectors.dblp_records import collect, normalize_row
+from paper_atlas.ingestion.records import ingest_file
+
+FIXTURE = json.loads((Path(__file__).parent/'fixtures/historical_predecessors.json').read_text())
+EXAMPLES = {row['key']: row for row in FIXTURE['volumes']}
+
+
+def example(key, *, bibliographic_year=None):
+    fixed = EXAMPLES[key]
+    family = key.split('/')[1]
+    year = int(key.split('/')[-1])
+    volume = {'record_type': 'proceedings', 'key': key, 'fields': deepcopy(fixed['fields'])}
+    row = {'record_type': 'inproceedings', 'key': f'conf/{family}/SyntheticExample{year}', 'publtype': None,
+           'fields': {'title': [f'Synthetic historical research example {family} {year}'],
+                      'author': ['Jane Doe 0001', 'John Smith'], 'booktitle': fixed['fields']['booktitle'],
+                      'year': [str(bibliographic_year or year)], 'crossref': [key],
+                      'ee': [f'https://doi.org/10.1234/synthetic.{family}.{year}']}}
+    return row, volume
+
+
+class HistoricalPredecessorTests(unittest.TestCase):
+    def normalize(self, key, **kwargs):
+        row, volume = example(key, **kwargs)
+        fixed = EXAMPLES[key]
+        result, reason = normalize_row(row, {key: volume}, {fixed['expected_target_family']})
+        self.assertIsNone(reason)
+        self.assertIsNotNone(result)
+        return result
+
+    def test_ewsl_primary_series_retains_original_name_and_family_alias(self):
+        for year in [1987, 1988, 1989, 1991]:
+            with self.subTest(year=year):
+                record = self.normalize(f'conf/ecml/{year}')
+                self.assertEqual((record['venue'],record['venue_aliases'],record['year'],record['track']), ('EWSL',['ECML-PKDD'],year,'main'))
+                proof = record['metadata']['historical_predecessor_evidence']
+                self.assertEqual(proof['original_series'], 'EWSL')
+                self.assertEqual(proof['history_url'], 'https://ecmlpkdd2011.org/pastConferences.php')
+                self.assertEqual(record['metadata']['bibliography']['booktitle'], ['EWSL'])
+                self.assertEqual(record['metadata']['author_names_raw'], ['Jane Doe 0001','John Smith'])
+                self.assertEqual(record['authors'], ['Jane Doe','John Smith'])
+        self.assertEqual(EXAMPLES['conf/ecml/1989']['bibliographic_counts'], [])
+
+    def test_eps_ecp_ewsp_keep_original_series_instead_of_renaming_to_icaps(self):
+        for key in ['conf/aips/1990','conf/ecp/1997','conf/ecp/1999','conf/ewsp/1991']:
+            with self.subTest(key=key):
+                record = self.normalize(key)
+                fixed = EXAMPLES[key]
+                self.assertEqual(record['venue'], fixed['expected_original_series'])
+                self.assertEqual(record['venue_aliases'], ['ICAPS'])
+                self.assertEqual(record['track'], 'main')
+                proof = record['metadata']['historical_predecessor_evidence']
+                self.assertEqual(proof['history_url'], 'https://www.icaps-conference.org/conference-series/')
+                self.assertEqual(proof['proceedings_title'], fixed['fields']['title'][0])
+                self.assertEqual(proof['proceedings_year_fields'], fixed['fields']['year'])
+
+    def test_altered_titles_keys_suffixes_publication_years_and_unreviewed_editions_stay_held(self):
+        for key in ['conf/ecml/1988','conf/aips/1990','conf/ecp/1997','conf/ewsp/1991']:
+            row, volume = example(key)
+            for changed in ['title','key','suffix','publication_year']:
+                with self.subTest(key=key, changed=changed):
+                    r, v = deepcopy(row), deepcopy(volume)
+                    if changed == 'title': v['fields']['title'][0] += ', Affiliated Workshop'
+                    elif changed == 'key': v['key'] += 'w'; r['fields']['crossref'] = [v['key']]
+                    elif changed == 'suffix': r['fields']['booktitle'][0] += ' (Workshop)'
+                    else: v['fields']['year'] = ['2001']
+                    result, _ = normalize_row(r, {v['key']: v}, {EXAMPLES[key]['expected_target_family']})
+                    self.assertIsNone(result)
+        row, volume = example('conf/ecp/1997')
+        row['fields']['year'] = ['2001']; row['fields']['crossref'] = ['conf/ecp/2001']
+        volume['key'] = 'conf/ecp/2001'; volume['fields']['year'] = ['2001']
+        self.assertIsNone(normalize_row(row, {volume['key']:volume}, {'ICAPS'})[0])
+
+    def test_ecp1999_event_and_bibliographic_years_are_independently_retained(self):
+        record = self.normalize('conf/ecp/1999', bibliographic_year=2000)
+        self.assertEqual(record['year'], 1999)
+        self.assertEqual(record['metadata']['bibliographic_year'], 2000)
+        self.assertEqual(record['metadata']['bibliography']['year'], ['2000'])
+        self.assertEqual(record['metadata']['historical_predecessor_evidence']['proceedings_year_fields'], ['2000'])
+        self.assertEqual(record['metadata']['historical_predecessor_evidence']['event_year'], 1999)
+
+    def test_old_candidates_require_new_families_only_when_requested_years_need_them(self):
+        with tempfile.TemporaryDirectory() as temporary:
+            root = Path(temporary); row, volume = example('conf/aips/1990')
+            db = root/'dblp-catalogue.sqlite'
+            with closing(sqlite3.connect(db)) as connection, connection:
+                connection.execute('CREATE TABLE proceedings(key TEXT PRIMARY KEY,metadata_json TEXT)')
+                connection.execute('INSERT INTO proceedings VALUES(?,?)', (volume['key'],json.dumps(volume)))
+            candidate = root/'candidate.jsonl'; candidate.write_text(json.dumps(row)+'\n')
+            db.with_name('dblp-ai-candidates.manifest.json').write_text(json.dumps({
+                'snapshot_sha256': XML_SHA, 'candidate_sha256': hashlib.sha256(candidate.read_bytes()).hexdigest(),
+                'candidate_records': 1, 'candidate_family_counts': {'aips':1},
+                'record_types': {'proceedings':1,'inproceedings':1}}))
+            # Tiny CI fixtures may live on tmpfs; production reserve is tested separately.
+            with patch('paper_atlas.collectors.dblp_records.shutil.disk_usage', return_value=SimpleNamespace(free=16*1024**3)):
+                result = collect(db, root/'early', ['ICAPS'], candidates=candidate, through_year=1990)
+            self.assertEqual((result['normalized_records'],result['files'][0]['venue']), (1,'EPS'))
+            for year, missing in [(1991,'ICAPS/ewsp'),(1997,'ICAPS/ecp')]:
+                out = root/str(year); out.mkdir(); sentinel=out/'previous.txt';sentinel.write_text('accepted previous output')
+                with self.subTest(year=year), self.assertRaisesRegex(ValueError, missing):
+                    collect(db, out, ['ICAPS'], candidates=candidate, through_year=year)
+                self.assertEqual(sentinel.read_text(), 'accepted previous output')
+                self.assertFalse((out/'dblp-normalization.json').exists())
+
+    def test_new_catalogue_includes_previously_missing_families_without_decision_inference(self):
+        with tempfile.TemporaryDirectory() as temporary:
+            root = Path(temporary);dtd=root/'dblp.dtd';dtd.write_bytes(b'<!ENTITY eacute "&#233;">')
+            archive=root/'dblp.xml.gz'
+            body=''.join(f'<inproceedings key="conf/{family}/Synthetic"><title>Synthetic example</title><year>{year}</year><booktitle>{book}</booktitle><crossref>conf/{family}/{year}</crossref></inproceedings>' for family,year,book in [('ecp',1997,'ECP'),('ewsp',1991,'EWSP')])
+            with gzip.open(archive,'wb') as stream:stream.write(('<?xml version="1.0"?><!DOCTYPE dblp SYSTEM "dblp.dtd"><dblp>'+body+'</dblp>').encode())
+            result=catalogue(archive,dtd,root/'out',hashlib.sha256(archive.read_bytes()).hexdigest(),hashlib.md5(dtd.read_bytes()).hexdigest())
+            rows=[json.loads(line)for line in Path(result['file']).read_text().splitlines()]
+            self.assertEqual({r['key'] for r in rows}, {'conf/ecp/Synthetic','conf/ewsp/Synthetic'})
+            self.assertEqual(result['candidate_records'], 2)
+            self.assertTrue(all('status' not in r and 'venue' not in r for r in rows))
+
+    def test_native_import_keeps_original_series_aliases_and_full_source_evidence(self):
+        with tempfile.TemporaryDirectory() as temporary:
+            root=Path(temporary);db=root/'sample.sqlite'
+            for key in ['conf/ecml/1988','conf/ecp/1999']:
+                record=self.normalize(key);path=root/(key.replace('/','-')+'.jsonl')
+                path.write_text(json.dumps(record,ensure_ascii=False)+'\n')
+                path.with_suffix('.manifest.json').write_text(json.dumps({'source':'dblp','venue':record['venue'],'year':record['year'],'track':'main','count':1,'list_url':'https://doi.org/10.4230/dblp.xml.2026-11-01','file_sha256':hashlib.sha256(path.read_bytes()).hexdigest(),'status':'partial','missing_abstract_count':1}))
+                ingest_file(db,path)
+            with closing(sqlite3.connect(db)) as connection:
+                rows=connection.execute('SELECT v.acronym,a.alias,e.year FROM editions e JOIN venues v ON v.id=e.venue_id JOIN venue_aliases a ON a.venue_id=v.id ORDER BY v.acronym').fetchall()
+                self.assertEqual(rows,[('ECP','ICAPS',1999),('EWSL','ECML-PKDD',1988)])
+                metadata=[json.loads(r[0])for r in connection.execute('SELECT metadata_json FROM source_records')]
+                self.assertEqual({r['historical_predecessor_evidence']['original_series'] for r in metadata}, {'ECP','EWSL'})
+                self.assertEqual(connection.execute('SELECT count(*) FROM decisions WHERE status=?',('accepted',)).fetchone()[0],2)
+                self.assertEqual(connection.execute('PRAGMA foreign_key_check').fetchall(),[])
+
+    def test_existing_aips_normalization_remains_original_aips(self):
+        row, volume=example('conf/aips/1990');row['fields']['booktitle']=['AIPS'];row['fields']['year']=['1994'];row['fields']['crossref']=['conf/aips/1994']
+        volume['key']='conf/aips/1994';volume['fields']['title']=['AIPS 1994 Proceedings'];volume['fields']['year']=['1994']
+        record,reason=normalize_row(row,{volume['key']:volume},{'ICAPS'})
+        self.assertIsNone(reason);self.assertEqual((record['venue'],record['venue_aliases']),('AIPS',['ICAPS']))
+        self.assertNotIn('historical_predecessor_evidence',record['metadata'])