Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,16 @@

<!-- How was this tested? -->

<!-- scient(SA-POLICY): begin - Scient's definition of done (SCIENT.md). -->
## Platforms

<!-- macOS, Linux and Windows: what ran on each and what is still unproven. -->

## Review

<!-- None (docs, or UI appearance or copy with no logic change) | Light Codex | Codex high and a live test: the changed behavior run in the built binary with synthetic state (data, migrations, security, release, alignment). Then the result. -->

<!-- scient(SA-POLICY): end -->
---

- [ ] `bun check` passes
Expand Down
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Development Rules

<!-- scient(SA-POLICY): begin - Scient's rules come first in this fork. -->
> **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".

<!-- scient(SA-POLICY): end -->
## Default Context
Expand Down
11 changes: 11 additions & 0 deletions SCIENT.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <number>` shows every job green, `CI passed` included, which `main` requires (`gh pr merge <number> --rebase --match-head-commit <sha>`). 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.
Expand Down
2 changes: 1 addition & 1 deletion scripts/scient/divergences.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": {
Expand Down
Loading