YCode 项目约定

日常操作：固定入口优先

用户说“拉取代码／运行 dev／启动当前代码／启动最新代码／重启 dev／停止 dev／构建／打包／查看状态”时，执行日常操作 SOP，唯一入口为 node scripts/ops.mjs <动作> --json；重启动作名为 restart-dev，停止为 stop-dev。模型只映射意图、启动操作一次、续读同一执行会话至结构化终态，不自由拼接 Git/npm/进程命令。
首先确认本次已打开的项目根目录；未知时只询问路径。新会话须已打开本仓库或由用户提供一次路径，不假定跨会话全局规则、旧电脑路径或历史验收目录仍适用。
不先做业务调研、REA、全量测试、方案设计或依赖升级。当前代码保留本地状态；只有 pull、dev-latest 同步 gitea/master。
自动恢复只限入口脚本内已定义、有边界的处理。非成功结果直接报告 code、摘要、日志与所需下一步；不循环重试、不擅自改源码、stash/reset、强推、换检出、修改凭据或杀未知进程。审批与安全限制照常生效。
dev 的日志、端口、PID 不等于真实窗口验证；仅按结果中的证据报告。详细窗口验收及历史人工操作说明见 Dev 启动 SOP，不作为失败后绕过固定入口的捷径。

借助 REA，按 WorkBuddy 的视觉、交互和功能进行 1:1 复刻。
所有查看 WorkBuddy 实现的工作必须通过 REA：安装包、脚本、样式、资源、运行时页面和行为采集均包含在内。
禁止用直接 CDP / WebSocket、手写提取器、浏览器 evaluate、computer-use 或其他渠道绕过 REA 查看原版实现。旧 scripts/wb-*、scripts/enable-wb-cdp.ps1 直接采集工具已清理，仅可在 Git 历史中查看，不作为现行采集入口。
REA 能力不足时记录具体未知项及所需证据；不得自行改用其他采集渠道。
YCode 自身的源码编辑、构建、测试不受上述原版采集限制。
历史文档中的缩减范围、不实现、改用其他采集渠道等决定，若与上述目标冲突，以本约定为准。