script-build-and-framework-tmp/visualization/README.md

Script Build Mission Control

当前智能创作构建系统的独立可视化。后端是只提供确定性 fake 数据的 FastAPI，前端是 Next.js + React Flow 的 n8n 风格节点画布。

画布按真实新流程展开：输入快照与 Mission Binding → Direction → 多路 Evidence → Structure / Paragraph / ElementSet → Compare / Compose / Portfolio → Phase 3 Root Delivery → 原子发布 → 旧 API 回读。每个任务继续细分为冻结合同、Operation、Worker Attempt、Artifact、Validator、Validation 和 Planner Decision。

启动

cd visualization/backend
python -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/uvicorn app.main:app --host 127.0.0.1 --port 8788

cd visualization/frontend
npm install
NEXT_PUBLIC_API_BASE=http://127.0.0.1:8788 npm run dev

访问 http://127.0.0.1:3008。后端不会读取数据库；所有接口都明确返回 data_mode=fake。

API

• GET /api/health
• GET /api/runs
• GET /api/runs/{script_build_id}/graph
• GET /api/runs/{script_build_id}/nodes/{node_id}
• GET /api/schema-catalog

验证

cd visualization/backend && python -m pytest -q
cd visualization/frontend && npm test && npm run typecheck && npm run build

在父项目依赖已安装的开发环境中，还可直接用当前 Host/Agent constructors、Pydantic wire models 与 SQLAlchemy table metadata 交叉验证：

cd visualization/backend
PYTHONPATH=.:/tmp/scriptbuild-dbdeps:../../agent:../../script_build_host/src \
  ../../agent/.venv/bin/python scripts/validate_host_contracts.py

backend/app/contracts.py 固化了当前项目领域对象与 Agent wire model 的字段清单。测试要求每个 fake payload 与对应清单完全同键，防止为了展示而发明字段或漏字段。

字段来源、开放 JSON 边界和接真实数据仍缺的接口见 DATA_CONTRACT.md。