Skip to content

Missing scripts/ and docs/ directories (excluded by .gitignore) break the documented debug:* / live:* commands #53

Description

@yllrbill

Hi, and thanks for open-sourcing this RA2WEB React reconstruction.

After a fresh git clone (and after downloading the main ZIP), the repository root only has public/ and src/ as directories — there is no scripts/ and no docs/ directory. However:

  • package.json defines ~36 scripts, and almost every debug:* / live:* entry points to scripts/*.mjs, for example:

    • "debug:skirmish": "bun scripts/skirmish-flow.mjs"
    • "debug:lan-lockstep": "bun scripts/lan-lockstep-flow.mjs"
    • "live:runtime": "bun scripts/live-interaction-runtime.mjs"

    Running any of them fails immediately because scripts/ does not exist.

  • README.md references docs/build-alignment-log.md, which is also absent.

The cause looks intentional — .gitignore excludes both docs/ (line 52) and scripts/ (line 65), so they were never committed.

Could you clarify:

  1. Are scripts/ and docs/ meant to be public? If so, would you be able to commit them (or drop those two .gitignore lines)?
  2. If they are intentionally dev-only / private, could the README note that the debug:* / live:* commands are not runnable from a fresh clone, to avoid confusion?

FWIW bun install works and the vite dev server starts fine (https://localhost:4000/), so the engine itself builds — only the documented automation / LAN / replay test scripts can't run without scripts/. Thanks!


你好,感谢开源这个 RA2WEB React 重构项目。

git clone(以及下载 main 的 ZIP)之后,仓库根目录只有 public/src/ 两个目录,没有 scripts/、也没有 docs/。但是:

  • package.json 里约 36 条脚本,几乎所有 debug:* / live:* 都指向 scripts/*.mjs(例如 bun scripts/lan-lockstep-flow.mjs),由于 scripts/ 不存在,一运行就失败。
  • README.md 提到的 docs/build-alignment-log.md 也不存在。

看起来是有意为之——.gitignore 把两者都排除了(docs/ 第 52 行、scripts/ 第 65 行),所以从未被提交。

想确认两点:

  1. scripts/docs/ 是否打算公开?如果是,能否提交它们(或删掉这两行 .gitignore)?
  2. 如果是有意只留本地 / 不公开,能否在 README 注明 debug:* / live:* 这些命令在全新 clone 下无法运行,以免误解?

补充:bun install 正常,vite dev server 也能起(https://localhost:4000/),引擎本体可以构建——只是缺了 scripts/,文档里的自动化 / LAN / 回放测试脚本跑不了。谢谢!

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions