Skip to content

Autonomous development for real products. Governed agents build from specs you approve, follow the rules you set, and nothing merges until another agent proves it. Your decisions, judgement and taste are the bar that work must clear. Declare your vision and let agents build it.

feat(merge): line settings are board moves with a [H16,C7,O5,O6,R1,R2]

Corey Olson0e697760c57e
diff --cc docs/formats.md
index d614aa85,0322299d..e6cc9422
--- a/docs/formats.md
+++ b/docs/formats.md
@@@ -113,7 -113,7 +113,7 @@@ The board file is in the repository's G
| `row grammar` | `1` | `SPEC_GRAMMAR_VERSION` in `src/spec.js`; optional `<!-- pullboard-grammar N -->` line in either file (absence means the current grammar) | Both files share the version. A declared version must match; an incompatible grammar change requires a coordinated version bump and compatible files. No automatic conversion occurs. |
| `board schema` | `3` | `SCHEMA_VERSION` in `src/board.js`, persisted as `PRAGMA user_version` | On a write open of a board whose version is behind: create missing tables and indexes (version 3 adds the hot-path indexes), add missing columns in place with declared defaults, restore missing or changed triggers, and remove stale machine triggers without replacing rows. Read opens never migrate; a board at the current version whose shape differs is reported once on stderr and left as it is. |
| `event log` | `1` | `EVENT_LOG_VERSION` in `src/board.js`, persisted in `board_meta` as `event_log_version` | Older event-log versions upgrade in place; newer versions are refused with `EVENT_LOG_VERSION`. Preserve event rows when the board schema changes. |
- | `move engine` | `97` | `ENGINE_VERSION` in `src/machine.js`, carried as `engine` in every sealed executable move | Bump when a move's meaning changes, independently of the event log and sealed envelope. A newer engine is refused with `ENGINE_VERSION`, naming both versions and asking you to upgrade Pullboard. |
-| `move engine` | `96` | `ENGINE_VERSION` in `src/machine.js`, carried as `engine` in every sealed executable move | Bump when a move's meaning changes, independently of the event log and sealed envelope. A newer engine is refused with `ENGINE_VERSION`, naming both versions and asking you to upgrade Pullboard. |
++| `move engine` | `98` | `ENGINE_VERSION` in `src/machine.js`, carried as `engine` in every sealed executable move | Bump when a move's meaning changes, independently of the event log and sealed envelope. A newer engine is refused with `ENGINE_VERSION`, naming both versions and asking you to upgrade Pullboard. |
<!-- format-versions:end -->
A builder never picks an engine number (#1101). An item that adds a board move adds its own `src/<name>-engine.js` leaf as `export const NAME_ENGINE = unassignedEngine();` (importing `unassignedEngine` from `./engine-next.js`); on its branch the leaf reads as one above the highest landed engine. The landing merge writes the next number into the leaf, in landing order, inside that item's merge commit, and sets the `move engine` row above to the highest landed number. A landed number never changes, so recorded moves replay as they were written. Moves are recorded under landed numbers only: code with an unnumbered engine is for its branch's own tests, and a move it records on a real board before landing may later read under another item's number, so the item lands before its moves are used.
@@@ -541,62 -555,5 +555,63 @@@ These are recorded inputs only (#1096)
Landing queue grants, first queue entries and releases are shared ordered transitions. New landing-local-heartbeat engine moves leave renewal and repeated-poll events out of history; old engine receipts keep their recorded meaning. `local:landing-lease:<token>` board metadata binds a physical board id, token/generation, process, branch and coordinator lineage to its local deadline. It is excluded from exports, imports and semantic digests and is retained only on the receiving physical board during a same-board relay snapshot restore. A linked foreign holder has no clock-based expiry: release or coordinator takeover fences it; local heartbeat deadlines never authorize another machine to merge.
+
Engine 93 adds item-addressed shouts. A shout move's optional `item` names an existing item; its event belongs to that item and includes the message text. Its canonical `shout_to` is `item:<id>`, read by the item's current builder and reviewer and the coordinator. Inbox, resume and seat watch use the same audience; an explicit seat or lane destination with `--item` still uses the item's audience. An item decision is answerable by its current participants or coordinator; replies stay in its thread and audience. The coordinator can still pass it to the person through the existing decision flow. A registered seat's shout to `all` is accepted and stored at reserved address `coordinator+person`, read only by coordination audiences. The plus sign cannot occur in valid lane names or their derived seat ids. Coordinator and person broadcasts retain `all` and reach everyone; recorded older-engine `all` rows retain their original global meaning without a retrospective sender filter. Main-checkout watch remains the person's board-wide observer. A joined seat's default watch filters shouts to its own address, lane, items and `all`, while ordinary lifecycle events remain visible.
+
+### Outside intake and sandbox receipts
+
+`pullboard intake <GitHub PR URL> --criterion "behavior" --check "command"`
+reads GitHub metadata and fetches the exact server-owned pull ref. It records an
+outside author (`outside:github:<login>`), commit, tree, source state and maintainer
+reply, and enters `submitted` without claiming that a native builder gated the PR.
+No contributor program is checked out or executed on the host. An issue URL records
+an open local source item; the GitHub issue closing does not accept the local item.
+Repeating intake refreshes source state and replies. A PR head can change only after
+normal return to open; re-intake invalidates its earlier sandbox proof and owner
+approval. Native agents cannot claim or submit an outside PR as their own build.
+
+Public source facts are in `board_meta` under `outside:<item-id>` and appear as
+`outside` on `show` JSON. Ordered `intakeOutside` and `approveOutside` moves retain
+`outside-intake`, `outside-refresh` and `outside-owner-approval` events. Approval is
+person authority bound to the exact commit, not an agent or parent-session claim.
+These facts survive board export and ordered replay. The local container logs are
+beside the board in `outside-check-output/<item-id>/<receipt-id>`; an ordered accept
+must match the executor's exact local receipt and output digests before transport.
+
+Sandbox verification reads operational provider settings from committed trusted
+main, not from the PR's configuration. `sandbox.provider` is `docker`,
+`sandbox.executable` is an absolute Docker-compatible CLI path, `sandbox.endpoint`
+is an explicit Unix daemon socket, and `sandbox.images.minimum` and
+`sandbox.images.current` are immutable `<image>@sha256:<digest>` references selected by trusted main.
+Prebuilt Node+Chrome images are supported for browser gates; outside heads cannot
+choose runtime images, and actual container Node versions must still match both roles. Images
+must already be present; verification uses `--pull never`. The actual container
+must report Linux Node 22.13.x and Node 24.x respectively, the two roles in the
+committed CI matrix; this is not a claim about the latest global Node release.
+Each role executes the trusted full gate and frozen criterion, with the criterion
+also required to fail at the recorded base. Protocol stand-ins in unit tests are
+not evidence of real containment or actual image execution.
+
+Every container has no network, an empty temporary HOME, a read-only root and
+private source export, no added capabilities, and no host credential environment.
+The Docker client has a fresh empty configuration and explicitly constructed
+environment. The source export contains independent exact-commit Git objects and
+files, never an operational checkout, its board database, worktree pointer,
+alternates or credential state. It is copied into a temporary writable container
+work directory. Exports default beside the native board under `sandbox-exports`;
+`sandbox.exportRoot` may name a private absolute directory shared with a VM-backed
+Docker daemon. Only a newly created child is exported and cleaned up. Missing
+runtime, inaccessible export or cleanup failure refuses; no host-process fallback
+is available. Normal physical gate/browser admission still applies.
+
+Owner-sensitive reasons are retained as `outside.sensitivity`, each with `path`,
+`rule` and `detail`; `outside.sensitive` is true when any reason matches. Defaults
+cover relay, sealing/signing/keys, person-move and hook code, hook configuration,
+`bin/`, CI workflows and command-bearing package fields. Trusted main may extend
+this with `intake.sensitivePaths`, relative exact files or trailing-slash prefixes;
+contributions cannot remove the defaults. Newly added process imports/calls or
+shell-runner calls and unreadable changed files also require approval. Renames
+retain both old and new touched paths. Ordinary source is not sensitive merely
+because it is source. The owner runs `pullboard intake approve <id>` through the
+person channel before sensitive work can land. Intake has no autonomous posting
+operation; each future result post still needs the person's separate OK.
diff --cc src/board.js
index a1bdcf75,08964406..15c5b46e
--- a/src/board.js
+++ b/src/board.js
@@@ -1,14 -1,5 +1,16 @@@
+ export { lineSettings, setLineSetting } from './line-settings.js';
+
+import {
+ applyOutsideIntake,
+ approveOutside as applyOutsideApproval,
+} from './outside-store.js';
+import {
+ outsideSandboxProblem,
+ outsideBuildProblem,
+ outsideSource,
+ requireOutsideOwner,
+ saveOutsideSource,
+} from './outside-source.js';
import {
recordBarRevision,
barReadyProblem,
diff --cc src/line-settings-engine.js
index 00000000,81b9eab3..076c6fea
mode 000000,100644..100644
--- a/src/line-settings-engine.js
+++ b/src/line-settings-engine.js
@@@ -1,0 -1,3 +1,2 @@@
+ /** Board line-policy records receive their permanent engine number at landing (#1096). */
-import { unassignedEngine } from './engine-next.js';
-export const LINE_SETTINGS_ENGINE = unassignedEngine();
++export const LINE_SETTINGS_ENGINE = 98;
diff --cc src/next-step-words.js
index 444a4c67,6054bca3..5903c9c1
--- a/src/next-step-words.js
+++ b/src/next-step-words.js
@@@ -56,22 -56,10 +56,26 @@@ export function personRequestGuidance(m
/** @type {Readonly<Record<string, string>>} */
export const NEXT_STEPS = Object.freeze({
+ OUTSIDE_NATIVE_BUILD: 'the outside author revises the PR; ask the coordinator to return it, then intake its new exact head',
+ CHECK_NO_PROOF: 'strengthen the trusted criterion so it fails before the outside change, then ask the coordinator to refreeze it',
+ OUTSIDE_URL: 'use a GitHub issue or pull request URL with owner/repository and its positive number',
+ OUTSIDE_FETCH: 'restore read-only gh API and Git fetch access, then intake the exact source again',
+ OUTSIDE_SOURCE: 'fetch the exact GitHub source metadata and its immutable commit/tree before intake',
+ OUTSIDE_HEAD_CHANGED: 'ask the coordinator to reopen the old outside submission before intaking its new exact head',
+ OUTSIDE_OWNER_APPROVAL: 'the owner runs pullboard intake approve <id> from the person terminal or view',
+ OUTSIDE_SANDBOX_REQUIRED: 'read the exact PR diff, then run pullboard verify <id> accept --sandbox with the configured container provider',
+ SANDBOX_PROVIDER_REQUIRED: 'commit sandbox.provider docker with an absolute executable, explicit Unix endpoint and pinned minimum/current images in trusted main pullboard.json',
+ SANDBOX_IMAGE_REQUIRED: 'preload the exact configured digest in the configured Docker daemon; verification does not pull automatically',
+ SANDBOX_RUNTIME: 'correct the pinned official image so its actual Linux Node environment matches the configured minimum/current role',
+ SANDBOX_EXPORT: 'restore Git access to the exact recorded commit and independent private export before verifying',
+ SANDBOX_EXECUTION: 'restore the Docker daemon and inspect the named owned container before another verification',
+ SANDBOX_CLEANUP_REQUIRED: 'restore Docker and remove the exact named owned container before another verification',
+ SANDBOX_CHECK_REQUIRED: 'set a trusted full gate and frozen causal criterion before intake',
+
+ LINE_SETTING_UNKNOWN: 'read pullboard settings line and choose a listed board control',
+ LINE_SETTING_RANGE: 'read the allowed range with pullboard settings line, then record an in-range value or off with its reason and window numbers',
+ LINE_SETTING_REASON: 'repeat the board setting change with --reason describing the measured window',
+ LINE_SETTING_WINDOW: 'repeat the board setting change with --window containing a nonempty JSON object of finite nonnegative measurements or null for unknown',
PERSON_ENROLL_AUTH: 'authenticate a fresh enrollment with the locally trusted person credential',
PERSON_ENROLL_EXPIRED: 'create a fresh person-authenticated challenge valid for at most ten minutes',
PERSON_ENROLL_REVOKED: 'authenticate a different non-revoked device with the person credential',