site/scripts/readings.mjs

// Ordered chapters: one execution path first, advanced mechanisms afterwards.
export const readings = [
  ['read', '代码带读：沿执行路径理解', 'index', '先理解职责与状态，再读完整源码块。'],
  ['read-entry', '入口：参数、工具与模式', 'entry', 'cmd/demo/main.go'],
  ['read-runner', 'Runner：创建与运行', 'runner', 'runner.go'],
  ['read-guest-c', '跨入 C 与 CPython', 'guest-c', 'guest/runtime.c'],
  ['read-guest-python', 'Python 执行约定', 'guest-python', 'guest/bootstrap.py'],
  ['read-bridge', 'Host 工具边界', 'bridge', 'bridge.go'],
  ['read-runtime-tests', '用测试核对普通执行', 'runtime-tests', 'runner_test.go'],
  ['read-example-tests', 'CLI 示例的测试', 'example-tests', 'cmd/demo/main_test.go'],
  ['read-examples', '六个用户程序', 'examples', 'examples/*.py'],
  ['read-trading', '交易演示：从读取到条件下单', 'trading', '交易程序、Host 状态与对应测试'],
  ['read-demo-scripts', '快捷脚本：组织可重复的演示', 'demo-scripts', 'demos/*.sh'],
  ['read-futures', 'Future：本轮任务登记与交付', 'futures', 'future.go'],
  ['read-plm-pass', 'PLM：沿 AST 找安全提前点', 'plm-pass', 'guest/plm.py'],
  ['read-plm-tests', 'PLM 的真实执行测试', 'plm-tests', 'plm_test.go'],
  ['read-plm-python-tests', 'AST 改写的单元测试', 'plm-python-tests', 'guest/test_plm.py'],
  ['read-prefix-host', 'Host 怎样接收源码片段', 'prefix-host', 'prefix.go'],
  ['read-prefix-guest', 'Guest 怎样解析和领取', 'prefix-guest', 'guest/prefix.py'],
  ['read-prefix-tests', 'Prefix 的真实执行测试', 'prefix-tests', 'prefix_test.go'],
  ['read-prefix-python-tests', 'Prefix 的解析测试', 'prefix-python-tests', 'guest/test_prefix.py'],
  ['read-prepared', '初始化与内存恢复的分岔', 'prepared', 'prepared.go'],
  ['read-prepared-tests', 'Full-copy 的行为测试', 'prepared-tests', 'prepared_test.go'],
  ['read-cow-interface', 'COW 的小接口', 'cow-interface', 'cow.go'],
  ['read-cow-linux', 'Linux COW：逐步跟进系统调用', 'cow-linux', 'cow_linux.go'],
  ['read-cow-platform', '不支持的平台怎样报错', 'cow-platform', 'cow_other.go'],
  ['read-cow-kernel-tests', '验证映射与释放', 'cow-kernel-tests', 'cow_linux_test.go'],
  ['read-cow-guest-tests', 'COW 上的真实 Python', 'cow-guest-tests', 'cow_test.go'],
  ['read-go-module', 'Go 依赖与校验记录', 'go-module', 'go.mod / go.sum'],
  ['read-build-entry', 'Makefile：选择构建任务', 'build-entry', 'Makefile'],
  ['read-build-inputs', '准备本地编译工具链', 'build-inputs', 'tools/setup-build-inputs.py / lock'],
  ['read-guest-build', '链接并打包真实 Guest', 'guest-build', 'build-guest.sh'],
  ['read-offline', '隔离子进程网络', 'offline', 'tools/offline-check.sh'],
  ['read-local-reader', '启动静态阅读服务', 'local-reader', 'tools/read-local.sh'],
  ['read-site-content', 'Astro 内容与页面路由', 'site-content', '内容集合与普通页面'],
  ['read-site-source-view', '源码页的行号与函数导航', 'site-source-view', '源码页面与符号提取'],
  ['read-site-styles', 'CSS：布局与手机阅读', 'site-styles', 'site/src/styles/global.css'],
  ['read-site-validation', '检查页面与发布边界', 'site-validation', 'site/scripts/verify.mjs'],
  ['read-site-config', '站点依赖与搜索索引规则', 'site-config', 'package.json / headers / robots'],
  ['read-site-pipeline', '把讲义与源码装进网站', 'site-pipeline', 'prepare.mjs / readings.mjs'],
  ['read-site-layout', '代码优先的页面外壳', 'site-layout', 'Docs.astro / 首页 / 阅读样式'],
  ['read-site-excerpts', '源码片段提取与覆盖检查', 'site-excerpts', 'excerpts.mjs / 对应测试'],
];

// Complete source coverage accompanies responsibility-level explanations.
export const readingSources = [
  'cmd/demo/main.go', 'runner.go', 'bridge.go', 'guest/runtime.c', 'guest/bootstrap.py',
  'runner_test.go', 'cmd/demo/main_test.go',
  'examples/lookup.py', 'examples/order.py', 'examples/dependency.py',
  'examples/branch.py', 'examples/error_delivery.py', 'examples/fallback.py',
  'future.go', 'guest/plm.py', 'plm_test.go', 'guest/test_plm.py',
  'prefix.go', 'guest/prefix.py', 'prefix_test.go', 'guest/test_prefix.py',
  'prepared.go', 'prepared_test.go', 'cow.go', 'cow_linux.go', 'cow_other.go',
  'cow_linux_test.go', 'cow_test.go', 'go.mod', 'go.sum', 'Makefile',
  'tools/setup-build-inputs.py', 'tools/build-inputs.lock.json', 'build-guest.sh',
  'tools/offline-check.sh', 'tools/read-local.sh',
  'site/src/content.config.ts', 'site/src/pages/[slug].astro',
  'site/src/pages/code/[id].astro', 'site/src/pages/code/index.astro',
  'site/src/pages/404.astro', 'site/src/styles/global.css',
  'site/scripts/symbols.mjs', 'site/scripts/verify.mjs', 'site/package.json',
  'site/public/_headers', 'site/public/robots.txt',
  'site/scripts/prepare.mjs', 'site/scripts/readings.mjs',
  'site/src/layouts/Docs.astro', 'site/src/pages/index.astro',
  'site/src/styles/code-reading.css', 'site/scripts/excerpts.mjs', 'site/scripts/excerpts.test.mjs',
  'examples/trading.py', 'cmd/trade-demo/main.go', 'cmd/trade-demo/market.go',
  'cmd/trade-demo/main_test.go', 'cmd/trade-demo/market_test.go',
  'demos/run.sh', 'demos/trade.sh', 'demos/01-price-skip.sh', 'demos/02-cash-skip.sh',
  'demos/03-host-denied.sh', 'demos/04-approved.sh', 'demos/05-prefix.sh', 'demos/06-plm-source.sh',
];