"""本轮文档核验：记录业务源码摘要，检查当前文档链接和代码围栏。

只读取业务源码；输出仅在本轮 evidence 目录，旧报告与测试数据不变。
before/after 比较证明本轮没有修改业务源码，不证明运行行为完全等价。
"""
import hashlib
import json
import re
import sys
from pathlib import Path
from urllib.parse import unquote

ROOT = Path(__file__).resolve().parents[3]
OUT = Path(__file__).resolve().parent
DOCS = [
    'README.md', 'goal.md', 'docs/README.md', 'docs/architecture.md',
    'docs/v0.5-design.md', 'docs/production-architecture.md',
    'docs/backend-web3-roadmap.md', 'docs/development-plan.md',
    'docs/web3-development.md', 'docs/web3-testing.md',
    'docs/windows-local-run.md', 'docs/testing-guide.md',
    'docs/interview-guide.md', 'docs/current-progress.md',
    'docs/flash-sale-design.md', 'docs/reports/2026-11-02-architecture-review.md',
]


def source_manifest():
    paths = [ROOT / 'go.mod', ROOT / 'go.sum']
    for folder in ['backend', 'chaintrade', 'cmd', 'api', 'deploy', 'scripts',
                   'frontend/src', 'frontend/tests', 'frontend/scripts',
                   'contracts/src', 'contracts/tests', 'contracts/scripts']:
        paths.extend(p for p in (ROOT / folder).rglob('*')
                     if p.is_file() and '__pycache__' not in p.parts)
    paths.extend(ROOT.glob('Dockerfile*'))
    for folder in ['frontend', 'contracts']:
        paths.extend(p for p in (ROOT / folder).iterdir()
                     if p.is_file() and p.suffix in ['.json', '.ts', '.html'])
    paths.extend(ROOT.glob('run-*'))
    return {p.relative_to(ROOT).as_posix(): hashlib.sha256(p.read_bytes()).hexdigest()
            for p in sorted(set(paths)) if p.is_file()}


if sys.argv[1:] == ['snapshot']:
    manifest = source_manifest()
    (OUT / 'source-before.json').write_text(
        json.dumps(manifest, ensure_ascii=False, indent=2), encoding='utf-8')
    print(f'source files captured: {len(manifest)}')
    sys.exit(0)

errors = []
for name in DOCS:
    p = ROOT / name
    if not p.is_file():
        errors.append(f'missing document: {name}')
        continue
    content = p.read_text(encoding='utf-8-sig')
    # 屏蔽围栏与行内代码，避免将教程中的链接模板误判为实际导航。
    fence = None
    prose = []
    for line in content.splitlines():
        m = re.match(r'^\s*(`{3,}|~{3,})', line)
        if m:
            marker = m.group(1)
            if fence is None:
                fence = marker
            elif marker[0] == fence[0] and len(marker) >= len(fence):
                fence = None
        elif fence is None:
            prose.append(line)
    if fence is not None:
        errors.append(f'unclosed fence: {name}')
    body = re.sub(r'`[^`\n]+`', '', '\n'.join(prose))
    for target in re.findall(r'\]\(([^)]+)\)', body):
        target = target.strip().strip('<>')
        if re.match(r'^[a-zA-Z][a-zA-Z0-9+.-]*:', target) or target.startswith('#'):
            continue
        target = unquote(target.split('#', 1)[0])
        if target and not (p.parent / target).exists():
            errors.append(f'broken link: {name} -> {target}')

before = json.loads((OUT / 'source-before.json').read_text(encoding='utf-8'))
after = source_manifest()
changed = sorted(k for k in set(before) | set(after) if before.get(k) != after.get(k))
result = {'documents_checked': DOCS, 'source_files_checked': len(after),
          'source_changes': changed, 'errors': errors,
          'passed': not errors and not changed}
(OUT / 'document-check.json').write_text(
    json.dumps(result, ensure_ascii=False, indent=2), encoding='utf-8')
(OUT / 'source-after.json').write_text(
    json.dumps(after, ensure_ascii=False, indent=2), encoding='utf-8')
print(json.dumps(result, ensure_ascii=False, indent=2))
sys.exit(0 if result['passed'] else 1)
