"""Restore the full team guide from its retained Markdown, with current method directory."""
from pathlib import Path
from html import escape as esc
from lxml import html,etree
import re,subprocess,json
ROOT=Path(__file__).resolve().parents[2]
SOURCE='work/2026-05-25-team-ai-native-collaboration-guide/TEAM_AI_NATIVE_COLLABORATION_GUIDE.md'
BASE='https://zhctpmt.yyangpt.cn/'
from urllib.parse import urlsplit,unquote,quote
def render_manual():
text=(ROOT/SOURCE).read_text()
sections={}
for m in re.finditer(r'^## (\d+)\. ([^\n]+)\n(.*?)(?=^## |\Z)',text,re.M|re.S):sections[int(m[1])]=(m[2],m[3])
groups=[('onboarding','新人上手与任务提问',[2]),('files','产品、项目与目录怎么分',[3,4,5,7]),('wedrive','微盘原件、在线表与资料检索',[6]),('delivery-workflow','从提出任务到交付的完整流程',[8,9]),('resources','知识库、项目库与工具总导航',[11]),('methods','需求、战略与产品方法工具箱',[12,13]),('core-skills','高频方法、触发方式与实例',[14]),('skill-usage','方法安装、调用方式与五模块',[16,17]),('templates','可直接复制的完整任务模板',[18]),('team-rules','协作规则与禁止事项',[19,20])]
blocks=[];audit={'source':SOURCE,'recovered_sections':[],'links':[],'local_only':[],'missing':[]}
for id,title,nums in groups:
content='\n\n'.join('### '+sections[n][0]+'\n\n'+sections[n][1] for n in nums)
# Correct an old broad branch sentence without losing the guidance for business repos.
content=content.replace('修改前必须读项目规则、建任务分支或独立 worktree','修改前先读目标项目规则；业务仓库按其分支规则执行，控制项目按当前 master 同步规则执行')
raw=subprocess.check_output(['pandoc','--from=gfm','--to=html5'],input=content,text=True)
frag=html.fragment_fromstring(raw,create_parent='div')
for a in frag.xpath('.//a[@href]'):
href=a.get('href');parsed=urlsplit(href)
if parsed.scheme and parsed.scheme not in ['http','https']:a.drop_tag();continue
if href.startswith('#'):continue
if not parsed.scheme:
target=((ROOT/SOURCE).parent/unquote(parsed.path)).resolve()
try:relative=target.relative_to(ROOT).as_posix()
except ValueError:a.drop_tag();continue
if not target.exists():audit['missing'].append(relative);a.tag='span';a.attrib.pop('href',None);a.set('title','旧入口待修复：'+relative);continue
safe=target.suffix in ['.md','.html'] and not re.search(r'local-paths|acceptance-results|runbook|deployment-records|local-config|work_aliyun_ops_agent|work_laidisen',relative)
if safe:
a.set('href',BASE+quote(relative,safe='/')+('#'+parsed.fragment if parsed.fragment else ''));a.set('data-team-guide-link','true');a.set('target','_blank');a.set('rel','noopener');audit['links'].append(a.get('href'))
else:a.tag='span';a.attrib.pop('href',None);a.set('title','在团队授权工作区打开：'+relative);audit['local_only'].append(relative)
for tag in frag.xpath('.//script|.//iframe|.//form'):tag.drop_tree()
for table in frag.xpath('.//table'):
parent=table.getparent();i=parent.index(table);parent.remove(table);wrap=html.Element('div',{'class':'table-scroll','tabindex':'0','aria-label':title});wrap.append(table);parent.insert(i,wrap)
for h in frag.xpath('.//*[@id]'):h.set('id',id+'-'+h.get('id'))
rendered=''.join(etree.tostring(x,encoding='unicode',method='html') for x in frag)
blocks.append(f'{esc(title)}{len(nums)} 组说明
{rendered}
')
audit['recovered_sections']+=nums
# Module entrypoints come from the prior full navigation, rather than a newly invented list.
old=subprocess.check_output(['git','show','0e410f7f1:TEAM_AI_NATIVE_COLLABORATION_GUIDE.html'],cwd=ROOT,text=True)
old=html.fromstring(old);cards=[]
aliases={'AI_PRACTICE_SHARING.html#practice-020':'#project-intake','AI_PRACTICE_SHARING.html#practice-024':'#demo-access','AI_PRACTICE_SHARING.html#practice-001':'#parallel'}
for a in old.xpath('//*[@id="module-grid"]/a'):
href=aliases.get(a.get('href'),a.get('href'));title=''.join(a.xpath('.//h3/text()'));desc=''.join(a.xpath('.//p/text()'))
# Counts in the old PM guide were a historical snapshot, not today's directory size.
if title=='PM Skills 团队指南':desc='按产品经理工作场景查看方法、触发方式与完整说明。'
if title=='团队魔法：灵犀建项':desc='从来源核对、项目查重开始，整理项目文档；在线登记仍受调用者权限和回查结果约束。'
attr=' data-team-guide-link="true" target="_blank" rel="noopener"' if href.startswith(BASE) else ''
cards.append(f'