Files
browser/openspec/changes/complete-run-build-download-flow/tasks.md
T
2026-07-22 11:44:48 +08:00

2.5 KiB

Prompt Boundaries

  • 0.1 Positive prompt (正向提示词): complete the first-party 服务器管理 run generation/download flow so game.scum servers can build, download, and safely reuse generated run artifacts with per-server keys and auditable jobs.
  • 0.2 Directional prompt (方向提示词): preserve Platform-owned authorization, current platform_web visual style, browser/run as an ignored independent checkout, plugin/job-scoped run build workspaces, and verification through scripts/check-structure.sh, focused Go tests, OpenSpec validation, and local debug smoke.
  • 0.3 Boundary prompt (任务边界): do not add billing, cloud host sales, arbitrary shell execution, raw key exposure, direct plugin transports, tracked browser/run source, or destructive changes to /Users/tasia/Desktop/code/run.

1. Local Debug Source Snapshot And Build Bucket

  • 1.1 Add RUN_SOURCE_DIR (legacy alias RUN_REPO_DIR) for editable source input and keep /Users/tasia/Desktop/code/run optional.
  • 1.2 Snapshot RUN_SOURCE_DIR into RUN_BUILD_SOURCE_ROOT under RUN_BUILD_BUCKET_ROOT before local debug build-capable execution.
  • 1.3 Build and start the local bootstrap run worker from the bucket snapshot instead of directly executing browser/run.
  • 1.4 Make smoke evidence include the resolved source, bucket, snapshot, bootstrap binary, workspace, spool, and queue configuration.

2. Run Build Isolation

  • 2.1 Scope run distribution build workspaces by plugin ID and job ID.
  • 2.2 Add run tests proving two same-plugin server builds produce distinct workspaces, artifact IDs, and package configs.
  • 2.3 Confirm generated archive packaging still includes the executable and config for Linux/tar.gz and Windows/zip targets where locally testable.

3. Download And Smoke Proof

  • 3.1 Extend local smoke to open the latest run download reference after build success.
  • 3.2 Read generated run artifact content in chunks and verify total size plus checksum metadata.
  • 3.3 Keep forbidden-fragment checks over distribution, job, artifact, download reference, and chunk evidence.

4. Verification

  • 4.1 Run openspec validate complete-run-build-download-flow --strict.
  • 4.2 Run scripts/check-structure.sh.
  • 4.3 Run focused Platform distribution/artifact tests.
  • 4.4 Run focused run/ distribution build tests.
  • 4.5 Run bash -n scripts/local-debug-smoke.sh scripts/local-debug-start.sh scripts/local-debug-env.sh.
  • 4.6 Run local debug smoke or record any environment blocker precisely.