diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 265cdab79d..6083a343de 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -12,6 +12,16 @@ + +## Platforms + + + +## Review + + + + --- - [ ] `bun check` passes diff --git a/AGENTS.md b/AGENTS.md index c92b0d029f..dd1103d978 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,7 +1,7 @@ # Development Rules -> **This is Scient Agent, Scient's fork of Oh My Pi.** Before changing anything, read [SCIENT.md](SCIENT.md), above all "Keeping Scient's changes apart": every change goes where the next alignment with Oh My Pi costs least, and Scient's rules there come before this file's. +> **This is Scient Agent, Scient's fork of Oh My Pi.** Before changing anything, read [SCIENT.md](SCIENT.md), above all "Keeping Scient's changes apart": every change goes where the next alignment with Oh My Pi costs least, and Scient's rules there come before this file's. Work is done only when it meets SCIENT.md's "Definition of done". ## Default Context diff --git a/SCIENT.md b/SCIENT.md index eddf874f6f..c4e799d480 100644 --- a/SCIENT.md +++ b/SCIENT.md @@ -1060,6 +1060,17 @@ Scient's own tests live in `test/scient/` folders and run on macOS with the plat The macOS native test process preloads `scripts/scient/macos-spelling-ready.ts`. AppKit can return no spans when its first XPC request times out during spelling-service startup; the preflight requires the service to identify a known misspelling within three probes before running the unchanged tests. Persistent unavailability fails qualification. This provisions the CI fixture; it does not retry failed tests, change runtime results, or qualify cold-service startup behavior. +## Definition of done + +Report work as done only when all of these hold on the final head. Without a pull request, the handback carries what the pull request would. + +- `bun check` and the focused tests of the changed area pass, and so do the checks above that the change touches: `divergence-check.ts` for any change to an Oh My Pi file, and the generators' `--check` for names and wording. +- A change to a page or screen the agent shows (sign-in pages, the stats dashboard, the terminal) has before/after screenshots in the pull request, light and dark where the screen has both, checked against Scient Desktop's [UI checklist](https://github.com/ScientFactory/scient-desktop/blob/main/docs/internals/web-ui.md#ui-checklist) and attached as its "Screenshots in a PR" describes. +- Every link a reader can follow that the change adds (docs, messages, pull request text) was fetched once and works. +- The pull request says, for macOS, Linux and Windows, what ran there and what is still unproven. The six-platform CI proves the build and the isolation check on each system, not behavior that differs between them. +- The pull request names its review and result in the template's Review section. +- The delivery the task allowed is complete. Without pull request authorization, the handback names the branch, head and what is still owed. Merge only when authorized, on the head that had its review, after `gh pr checks ` shows every job green, `CI passed` included, which `main` requires (`gh pr merge --rebase --match-head-commit `). Rerun a failed job the change cannot have caused once; if it fails again, report it instead of merging. + ## Release `.github/workflows/scient.yml` builds and checks every platform on every push to `main` and on every pull request into it: macOS (Apple silicon and Intel), Linux (x86-64 and ARM64, glibc) and Windows (x86-64 and ARM64), each on its own GitHub-hosted runner, each with the isolation check. The first step stamps the commit into `packages/coding-agent/src/scient/build-id.ts` (`scripts/scient/stamp-build-id.ts`), which `--runtime-info` reports; a build made elsewhere reports `source`. On x86-64 the binary carries the `modern` (AVX2) and `baseline` native addons (`PI_NATIVE_X64_VARIANT` builds each). Before an addon is cached and embedded, `scripts/scient/strip-native.ts` strips the symbol tables and debug information the `local` cargo profile leaves, as Oh My Pi strips its release addons: Apple's `strip -x -S` on macOS, which keeps the arm64 linker signature valid, and `strip --strip-unneeded` on Linux. Windows keeps that information in separate `.pdb` files, so its addons are left as built. diff --git a/scripts/scient/divergences.json b/scripts/scient/divergences.json index 699bebf83c..0758e3bb84 100644 --- a/scripts/scient/divergences.json +++ b/scripts/scient/divergences.json @@ -226,7 +226,7 @@ }, "SA-POLICY": { "status": "active", - "contract": "An agent working here reads SCIENT.md first, and its rule on keeping Scient's changes apart comes before Oh My Pi's guidance; Scient accepts AI-assisted pull request descriptions, and the contributor stays responsible for them.", + "contract": "An agent working here reads SCIENT.md first, and its rule on keeping Scient's changes apart comes before Oh My Pi's guidance; Scient accepts AI-assisted pull request descriptions, and the contributor stays responsible for them. Its pull requests meet SCIENT.md's definition of done.", "upstream": [".github/PULL_REQUEST_TEMPLATE.md", "AGENTS.md", "CONTRIBUTING.md"] }, "SA-SECURITY": {