1.2 从故事到结构：叙事规格的骨架

#!/usr/bin/env python3
# file: sim/na_01_skeleton.py
# tier: S
# verify: /opt/homebrew/bin/python3 sim/na_01_skeleton.py
"""叙事规格的骨架扫描：按顶层字段顺序逐段打印规模摘要。

骨架 = `meta` 头部 + 九段内容字段。本脚本只做三件事：
  1) 按 JSON 里的**实际键序**遍历顶层，证明骨架不靠人工记忆；
  2) 每段给一组**由字段长度直接得出**的计数；
  3) 校验九段内容字段全部存在且非空——缺段即 FAIL（exit 1）。

不解析条件语义、不做可达性——那是 na_00 / 后续章节的事。
"""
from __future__ import annotations

import json
import os
import sys

# 九段内容字段。meta 不在其中：它是头部（标题 / 幕数 / 起点 / 规模声明）。
CONTENT_SEGMENTS = [
    "world", "characters", "beats", "scene_graph", "dialogue",
    "conditions", "state", "endings", "metrics",
]


def load_spec() -> dict:
    here = os.path.dirname(os.path.abspath(__file__))
    with open(os.path.join(here, "../config/story_spec.json"), encoding="utf-8") as fh:
        return json.load(fh)


def summarize(spec: dict) -> dict[str, str]:
    """每段一行摘要。全部是长度或直接读取的标量，不含任何推导量。"""
    meta = spec["meta"]
    world = spec["world"]
    chars = spec["characters"]
    beats = spec["beats"]
    graph = spec["scene_graph"]
    dlg = spec["dialogue"]
    conds = spec["conditions"]
    state = spec["state"]
    endings = spec["endings"]
    met = spec["metrics"]
    tension = [b["tension"] for b in beats]
    return {
        "meta": (
            f"HEADER title={meta['title']} acts={meta['acts']} start={meta['start']} "
            f"scale={len(meta['scale'])} 项"
        ),
        "world": (
            f"factions={len(world['factions'])} locations={len(world['locations'])} "
            f"lore={len(world['lore'])} rules={len(world['rules'])}"
        ),
        "characters": (
            f"count={len(chars)} goals={sum(len(c['goals']) for c in chars)} "
            f"fears={sum(len(c['fears']) for c in chars)} arcs={sum(len(c['arc']['stages']) for c in chars)}"
        ),
        "beats": (
            f"count={len(beats)} tension_sum={sum(tension)} "
            f"tension_min={min(tension)} tension_max={max(tension)}"
        ),
        "scene_graph": (
            f"nodes={len(graph['nodes'])} edges={len(graph['edges'])} "
            f"with_cond={sum(1 for e in graph['edges'] if e.get('when'))}"
        ),
        "dialogue": (
            f"nodes={len(dlg)} choices={sum(len(n.get('choices') or []) for n in dlg)} "
            f"ending_nodes={sum(1 for n in dlg if n.get('ending'))} "
            f"cond_lines={sum(1 for n in dlg if n.get('line_when'))}"
        ),
        "conditions": (
            f"grammar={conds['grammar']} ops={len(conds['ops'])} forms={len(conds['forms'])}"
        ),
        "state": (
            f"flags={len(state['flags'])} vars={len(state['vars'])} items={len(state['items'])}"
        ),
        "endings": (
            f"count={len(endings)} guarded={sum(1 for e in endings if e.get('when'))} "
            f"unguarded={sum(1 for e in endings if not e.get('when'))}"
        ),
        "metrics": (
            f"curve_len={len(met['target_tension_curve'])} "
            f"coverage_target={met['coverage_target_permille']} "
            f"entropy_min={met['ending_entropy_min_milli_bits']} "
            f"aff_mae_max={met['affinity_mae_max']} tension_mae_max={met['tension_mae_max']}"
        ),
    }


def main() -> int:
    spec = load_spec()
    rows = summarize(spec)

    print("段            类别    摘要")
    for i, key in enumerate(spec.keys()):
        kind = "HEADER" if key == "meta" else "SEG"
        print(f"{key:<13} {kind:<7} {rows[key]}")

    problems: list[str] = []
    # 键序断言：JSON 的顶层键序必须与文件里声明的骨架一致（meta 打头）。
    if list(spec.keys())[0] != "meta":
        problems.append("meta 不在顶层第一位")
    for seg in CONTENT_SEGMENTS:
        if seg not in spec:
            problems.append(f"缺内容段 {seg}")
        elif not spec[seg]:
            problems.append(f"内容段 {seg} 为空")
    extra = [k for k in spec if k != "meta" and k not in CONTENT_SEGMENTS]
    if extra:
        problems.append(f"骨架外的顶层键：{extra}")

    print(f"骨架：meta 头部 1 段 + 内容段 {len(CONTENT_SEGMENTS)} 段，顶层键共 {len(list(spec.keys()))}")
    for p in problems:
        print(f"FAIL {p}")
    if problems:
        return 1
    print("OK na_01_skeleton：九段内容字段齐备且非空")
    return 0


if __name__ == "__main__":
    sys.exit(main())

段            类别    摘要
meta          HEADER  HEADER title=雾港夜航 acts=3 start=d_pier_1 scale=9 项
world         SEG     factions=4 locations=14 lore=6 rules=4
characters    SEG     count=6 goals=12 fears=12 arcs=18
beats         SEG     count=16 tension_sum=52 tension_min=1 tension_max=5
scene_graph   SEG     nodes=14 edges=16 with_cond=5
dialogue      SEG     nodes=48 choices=115 ending_nodes=5 cond_lines=2
conditions    SEG     grammar=nested-array ops=4 forms=6
state         SEG     flags=18 vars=4 items=9
endings       SEG     count=5 guarded=4 unguarded=1
metrics       SEG     curve_len=16 coverage_target=850 entropy_min=1500 aff_mae_max=12 tension_mae_max=1
骨架：meta 头部 1 段 + 内容段 9 段，顶层键共 10
OK na_01_skeleton：九段内容字段齐备且非空