Skip to content

Commit b913faa

Browse files
luisleo526claude
andcommitted
Merge engine main (180630f) into p2/rjfast
Brings in the A5-STORE change (#515) and the docs/CHANGELOG commits that landed after b0f4341. First parent is 0638354 (the wrapper head). The wrapper change touches docker/run_json.py and its tests only; none of main's files overlap. Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
2 parents 0638354 + 180630f commit b913faa

12 files changed

Lines changed: 2122 additions & 7 deletions

File tree

‎AGENTS.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,9 +13,9 @@ parity verdict; an outside contributor cannot post them. GitHub Actions is advis
1313
The PR build (`ci.yml`) runs only the `fast`-labelled CTest rows (`ctest -L '^fast$'`); the post-merge legs (`ci-post.yml`) run
1414
every row, and a documentation-only change runs preflight alone among verification jobs.
1515
The seven PR/post-merge verification and documentation workflows start with the canon `authz` job and every other job in them needs it; release uses its status gate and baseline promotion its `promote-guard`. Pull-request
16-
workflows (`ci.yml`, `corpus-parity-subset.yml`, `docs.yml`) run every job on `["self-hosted","pf-gcp-pr"]`;
17-
post-merge workflows (`ci-post.yml` and the workflows it calls) run on `["self-hosted","pf-gcp-post"]`, and
18-
release jobs on `["self-hosted","pf-gcp-main"]`. In the CI workflows the only hosted job is the macOS post-merge cell `build-macos`; `release.yml` also uses hosted arm64 and macOS prebuilt cells and `promote-baseline.yml` a hosted guard job. The `build-gate` jobs in `ci.yml` and `ci-post.yml` and `native-live.yml`'s `native-live-gate` always run and refuse a non-success authz result first.
16+
workflows keep big jobs on `["self-hosted","pf-gcp-pr"]`; post-merge big jobs and credentialed docs-post/probe jobs stay on `["self-hosted","pf-gcp-post"]`. The eight split workflows' secret-free `authz` jobs, both CI `changes`/`build-gate` jobs and `docs.yml`'s `build` run on hosted `ubuntu-24.04`; they need no VM tools, mounts or caches.
17+
Hosted fork PRs receive no secrets, so they need no VM-only fork-refusal hook; rollback means relabeling the job to its prior `pf-gcp-pr`/`pf-gcp-post` array and restoring its checker/test pin.
18+
Release jobs stay on `["self-hosted","pf-gcp-main"]`; hosted macOS `build-macos`, release arm64/macOS prebuilt cells and promotion's hosted guard retain their existing pins. The `build-gate` jobs in `ci.yml` and `ci-post.yml` and `native-live.yml`'s `native-live-gate` always run and refuse a non-success authz result first.
1919
See `docs/ci.md` for the class table and docs-only exception. The commands below run the full sets.
2020

2121
```bash

‎CHANGELOG.md‎

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -824,6 +824,59 @@ deployments using Docker `--tmpfs /tmp` or Kubernetes `emptyDir` with
824824
passes). The Linux Debug build of the same run passes. Both are tracked
825825
for 1.7.1.
826826

827+
## 1.6.3 — 2026-10-23
828+
829+
**[1.6.3](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.6.3)**,
830+
paired with [pineforge-codegen 1.6.3](https://github.com/pineforge-4pass/pineforge-codegen-oss/releases/tag/v1.6.3).
831+
This patch release carries CI, release-gate and test-only changes after 1.6.2.
832+
Nothing under `src/`, `include/`, `cmake/` or `runner/` changed between `v1.6.2`
833+
and `v1.6.3`; under `docker/` only `run_failure_codes_diff.json` changed, which
834+
is the run-failure code catalog diff published with the release.
835+
836+
- **CI runs on the GCP fleet.** The engine's CI runs on the GCP fleet
837+
(`pf-gcp-pr`, `pf-gcp-main`), fork-gated (#474). The pull-request wall is
838+
split from full-event verification (CR-233 A and B, squash of #477, #480).
839+
- **A release needs full verify and parity green first.** The release job
840+
requires both before an engine release (C2, #479).
841+
- **Test-only.** The live test matches delivery receipts by request sequence
842+
(CR-223, #478); a session tape comment no longer names a private repository
843+
(#476).
844+
845+
## 1.6.2 — 2026-10-21
846+
847+
**[1.6.2](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.6.2)**,
848+
paired with [pineforge-codegen 1.6.2](https://github.com/pineforge-4pass/pineforge-codegen-oss/releases/tag/v1.6.2).
849+
It ships the
850+
[1.6.2-rc.1](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.6.2-rc.1)
851+
candidate (2026-10-19) plus the changes merged since it. The release publishes
852+
a run-failure code catalog (`run_failure_codes-v1.6.2.json`) and its diffs since
853+
`v1.6.1` and since `v1.6.2-rc.1`. The `pineforge-v1.6.2-linux-x86_64.tar.gz`
854+
archive was built by the maintainers outside CI, from tag `v1.6.2` (commit
855+
`dfe5f367e8935ef549ee7a8a38c1d437d1e8e42e`), because a CI runner restriction
856+
stopped the release job's Linux x86-64 leg; SHA-256
857+
`7f66c21750982ddcb476758bcf711b9f474a66de60bb658581ba9f0e4853019f`. Regenerate
858+
strategy C++ with the matching codegen and relink against the matching engine
859+
headers and archive.
860+
861+
- **Selected-window contract revision `1.3`, with the EN-115 completeness
862+
proof (#412).** The engine and `docker/run_json.py --capabilities-json`
863+
declare `capabilities.selected_window_contract_revisions` as `["1.3"]` on a
864+
supported runtime and `[]` otherwise; 1.6.1 declared `1.3-parity`. The
865+
ownership probes were fixed so proof B reads 118/118 (CR-139, #446), and the
866+
ownership manifest-controls test is sharded four ways so the Debug and ASan
867+
runs stop timing out (CR-196, #445).
868+
- **Proportional annualisation for runs shorter than a day, never null
869+
(CR-202, W-73, #456).**
870+
- **CI.** Linux x64 jobs run on the pf-ci-spot pool (#420) and release jobs on
871+
pf-ci-release (#461); `timeout-minutes` is removed (#462); the actions of
872+
`promote-baseline.yml` are pinned by SHA (#443); native-live and the Ubuntu
873+
Debug leg are pool-only required pull-request checks (#464); macOS Debug is
874+
deferred from pull requests (D3, CR-195, #454); the pull-request tier
875+
excludes the slow rows on Release and kernel-only, with registration floors,
876+
and defers the slow verifier self-test classes (D1, CR-195, #449); only
877+
superseded pull-request runs of the docs workflow are cancelled (#444);
878+
the App-token owner follows the repository owner (#439).
879+
827880
## 1.6.1 — 2026-10-18
828881

829882
**[1.6.1](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.6.1)**,

‎CMakeLists.txt‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -163,10 +163,10 @@ set(PINEFORGE_KERNEL_SOURCES
163163
src/selected_window_plan.cpp
164164
src/metrics_spill_curve.cpp
165165
src/report_scratch.cpp
166+
src/detail/o1_store.cpp
166167
src/scratch_arena.cpp
167168
)
168-
# The kernel-only archive: libpineforge.a's kernel objects and flags, for consumers that never speak Pine.
169-
add_library(pineforge_kernel STATIC ${PINEFORGE_KERNEL_SOURCES})
169+
add_library(pineforge_kernel STATIC ${PINEFORGE_KERNEL_SOURCES}) # kernel-only archive: libpineforge.a's kernel objects and flags, for consumers that never speak Pine
170170
add_library(PineForge::kernel ALIAS pineforge_kernel)
171171
# So a find_package(PineForge) consumer spells it the same way an in-tree one
172172
# does: PineForge::kernel, not PineForge::pineforge_kernel.

‎README.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -711,6 +711,9 @@ Documentation: [C ABI reference](https://cdocs.pineforge.dev) · [Getting starte
711711

712712
## Releases
713713

714+
- **[v1.7.0](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.7.0)** (2026-10-25) — report-sink transport, scratch-backed history and bounded storage admission, with new C++ views and command-line report routes. `get_trade()` and `closed_trade()` now return `Trade` by value, working-book, journal and cohort accessors return views, and some reads can throw on scratch I/O; closing a trade writes `TradeLedger` scratch even without a report sink, so a run needs a disk-backed `TMPDIR` or an explicit scratch directory; the C++ epoch namespace is still `engine_script_run_v19` although the layout of `BacktestEngine` changed, so rebuild every C++ object that includes an engine header, regenerate strategy C++ with the matching codegen and relink. Pair with [codegen 1.7.0](https://github.com/pineforge-4pass/pineforge-codegen-oss/releases/tag/v1.7.0). The known limits of this release (slower than 1.6.3 on some scripts, the closed-trade cache and its size by entry point) are in [CHANGELOG.md](CHANGELOG.md#170--2026-10-25), section "Costs that remain".
715+
- **[v1.6.3](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.6.3)** (2026-10-23) — CI, release-gate and test-only changes after 1.6.2: the engine's CI runs on the GCP fleet (`pf-gcp-pr`, `pf-gcp-main`), fork-gated; the PR wall is split from full-event verification (CR-233 A+B); a release requires full verify and parity green first (C2); the live test matches delivery receipts by request sequence (CR-223); a session tape comment no longer names a private repository. Nothing under `src/`, `include/`, `cmake/` or `runner/` changed since v1.6.2, and in `docker/` only the run-failure code catalog diff (`run_failure_codes_diff.json`) did. Pair with codegen 1.6.3. See [CHANGELOG.md](CHANGELOG.md#163--2026-10-23).
716+
- **[v1.6.2](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.6.2)** (2026-10-21) — selected-window contract revision `1.3` again, declared with the EN-115 completeness proof (`capabilities.selected_window_contract_revisions: ["1.3"]` on a supported runtime and `[]` otherwise; 1.6.1 declared `1.3-parity`); proportional annualisation for runs shorter than a day, never null (CR-202, W-73); the ownership probes fixed so proof B reads 118/118 (CR-139) and the ownership manifest-controls test sharded four ways (CR-196); CI changes: Linux x64 jobs on the pf-ci-spot pool and release jobs on pf-ci-release, `timeout-minutes` removed, the actions of `promote-baseline.yml` pinned by SHA, the PR tier skipping the slow rows (D1, CR-195). It ships the [v1.6.2-rc.1](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.6.2-rc.1) candidate (2026-10-19). Pair with codegen 1.6.2, regenerate and relink. See [CHANGELOG.md](CHANGELOG.md#162--2026-10-21).
714717
- **[v1.6.1](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.6.1)** (2026-10-18) — selected-window contract revision `1.3-parity` (`capabilities.selected_window_contract_revisions: ["1.3-parity"]` on a supported runtime and `[]` otherwise) rather than `1.3` until a completeness proof exists (EN-115), with the four typed value-ownership codes (`strategy_value_invalid`, `engine_command_value_invalid`, `report_result_invalid` and `report_post_execution_failed`) emitted and value parity with the 1.4.0 reference on the tested cases; per-stage `startedAt` and `seconds` in `preflight-summary.json`; `noindex` on raw Doxygen source listings and their omission from `sitemap.xml`; verifier-tests sharded across parallel `unittest` subprocesses; the lower-feed timing ratio skipped only under AddressSanitizer. The C layouts stay at ABI 4, `PF_ABI_VERSION` stays 4, the selected-window wire version stays 1, the phase version 1 and the fingerprint/schema version 2. Pair with codegen 1.6.1, regenerate and relink. See [CHANGELOG.md](CHANGELOG.md#161--2026-10-18).
715718
- **[v1.6.0](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.6.0)** (2026-10-17) — selected-window contract revision `1.3` (`capabilities.selected_window_contract_revisions: ["1.3"]` on a supported runtime and `[]` otherwise; 1.6.0 declared contract revision `1.3`; corrected to `1.3-parity` in 1.6.1); typed failures across source value admission (`strategy_value_invalid`), derived execution and settlement arithmetic (`engine_command_value_invalid`), non-finite canonical trade or summary doubles (`report_result_invalid`) and post-boundary serialization faults (`report_post_execution_failed`), with every report writer enforcing JSON so no bare `NaN` or `Infinity` token is emitted; Doxygen favicon, 404 page, `robots.txt`, `sitemap.xml`, canonical URLs and tag-or-`unreleased` version label; CI deadline and timeout-flag removals, private-fixture test moves and benchmark comparison/quiet-gate updates. The C layouts stay at ABI 4, `PF_ABI_VERSION` stays 4, the selected-window wire version stays 1, the phase version 1 and the fingerprint/schema version 2. Pair with codegen 1.6.0, regenerate and relink. See [CHANGELOG.md](CHANGELOG.md#160--2026-10-17).
716719
- **[v1.5.0](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.5.0)** (2026-10-12) — recorded outputs: a module can record per-bar doubles in named slots, run-level doubles and events, read through the nine `pf_outputs` runtime exports with coded refusals, off until a caller turns them on and byte-identical when unused; a run's report belongs to the call that began it; the engine's test inputs and strategy scripts moved to a private repository, with tests that need them skipping by name, a LEGAL.md *Data not distributed* note and a maintainers' private-fixture overlay. The C layouts stay at ABI 4, `PF_ABI_VERSION` stays 4 and the new members enter `engine_script_run_v19` without an epoch. Pair with codegen 1.5.0, regenerate and relink. See [CHANGELOG.md](CHANGELOG.md#150--2026-10-12).

‎ci/cr150-source-bounds.yaml‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ scan:
7474
generated_files:
7575
- "tutorial/**/generated*.cpp"
7676
ceilings:
77-
unreviewed: 1237
77+
unreviewed: 1241
7878
pending-flat-memory: 188
7979
owners:
8080
- {name: "generated-cpp", globs: ["tutorial/**"]}
@@ -563,6 +563,10 @@ entries:
563563
- {id: "U0494", file: "src/compat/pine/exit_lifecycle.cpp", symbol: "retire", ops: ["decl", "grow"], container: "std::vector<exit_legs::Leg>", owner: "source-layer", phase: "unclassified", state: "unreviewed", line: 19}
564564
- {id: "U0495", file: "src/compat/pine/reservation_expansion.cpp", symbol: "select_reservation_growth_sources", ops: ["decl"], container: "std::vector<std::uint64_t>", owner: "source-layer", phase: "unclassified", state: "unreviewed", line: 9}
565565
- {id: "U0496", file: "src/compat/pine/reservation_expansion.cpp", symbol: "selected", ops: ["decl", "grow"], container: "std::vector<std::uint64_t>", owner: "source-layer", phase: "unclassified", state: "unreviewed", line: 17}
566+
- {id: "U1483", file: "src/detail/o1_store.cpp", symbol: "<temp:string>", ops: ["temp"], container: "unresolved by the index: std::string", owner: "engine-core", phase: "unclassified", state: "unreviewed", note: "CR150-CX 10-26 (a5s2 head 76fceda8ad), class: error path, fixed text. Site src/detail/o1_store.cpp:349 builds the message of a std::runtime_error in StoreImpl::throw_status (a const member since 76fceda8ad; it first marks the open outer transaction rollback-only, then throws); size = a fixed literal + the caller's fixed `what` literal + status_text(status) (a fixed set of literals); runs only when a store call fails, never per bar. No growth axis. OPEN only because the gate has no class for a fixed-size error-path string.", line: 349}
567+
- {id: "U1484", file: "src/detail/o1_store.cpp", symbol: "new:StoreImpl", ops: ["alloc"], container: "unresolved by the index: new StoreImpl", owner: "engine-core", phase: "unclassified", state: "unreviewed", note: "CR150-CX 10-26 (a5s2 head 76fceda8ad), class: one object per open. Site :616 Store::open allocates one StoreImpl per call; its size is sizeof(StoreImpl); the number of stores is the number of open() calls the owner makes (a5 layers: one per object kind, none yet in production). No bar/trade term. OPEN: the gate has no class for a per-open fixed object.", line: 616}
568+
- {id: "U1485", file: "src/detail/o1_store.cpp", symbol: "transaction", ops: ["alloc"], container: "unresolved by the index: new StoreTx", owner: "engine-core", phase: "unclassified", state: "unreviewed", note: "CR150-CX 10-26 (a5s2 head 76fceda8ad), class: one small handle per begin(), caller-held. ONE site, :549 in StoreImpl::begin: `std::unique_ptr<Tx> transaction(new StoreTx(this, outer))` allocates one fixed-size StoreTx (nested and outer begin share it since 76fceda8ad; it is allocated BEFORE the ScratchStore transaction opens, so a failed allocation leaves no open transaction). It is returned in a unique_ptr and freed at commit, rollback or destruction. Live handles = the begin() nesting depth the CALLER holds; the store itself does not cap it (no kMax on nesting), so this is bounded by call nesting, not by bars or trades, and is NOT declared bounded. The symbol is the local variable name `transaction` the gate reports for this site. OPEN.", line: 549}
569+
- {id: "U1486", file: "src/detail/o1_store.cpp", symbol: "reset", ops: ["alloc"], container: "unresolved by the index: new std::byte / new CommandScratchStore", owner: "engine-core", phase: "unclassified", state: "unreviewed", note: "CR150-CX 10-26 (a5s2 head 76fceda8ad), class: one-shot allocations sized by the Shape fixed at open, capped. Site :265 chunk_buffer_ = kHeaderBytes + shape.chunk_bytes bytes; site :276 one CommandScratchStore whose resident pages = shape.resident_pages. The constructor refuses resident_pages > kMaxResidentPages (1024, include/pineforge/detail/o1_store.hpp:55, check src/detail/o1_store.cpp:250-251) and chunk_bytes > kMaxChunkBytes (64 KiB, hpp:54, check cpp:254-255) before either allocation; lab proof of the cap row: mutation shape-cap-removed RED at the Store::open throws_invalid_argument row (P2-CX's 01:00 message, lab rows on 76fceda8ad). The cap on resident_pages is a page-COUNT cap, not a byte cap: ScratchStore resident = (resident_pages + 6 work pages + metadata pages) x page_bytes, at most about 1 GiB at ScratchStore's own 1 MiB page-size limit (REV-CX 10-25 P3-3); page_bytes is not capped by the store, it must equal the backing's page size (fixed by the ScratchBacking the caller built; the common 4096 B gives about 4 MiB for 1024 pages plus the work and metadata pages). Fixed at open, not growing with bars or trades. OPEN: the gate's bounded form is only a size-guarded push on a local vector, so a capped one-shot allocation cannot be PASS(bounded).", line: 265}
566570
- {id: "U0497", file: "src/engine_aux_security.cpp", symbol: "bars", ops: ["grow"], container: "unresolved by the index: bars.assign(...)", owner: "engine-core", phase: "setup", state: "pending-flat-memory", inventory: "F07", grows_with: ["feed-rows"], line: 125}
567571
- {id: "U0498", file: "src/engine_aux_security.cpp", symbol: "late_day_opens", ops: ["assign", "decl"], container: "std::vector<int64_t>", owner: "engine-core", phase: "unclassified", state: "unreviewed", line: 232}
568572
- {id: "U0499", file: "src/engine_aux_security.cpp", symbol: "native_bars_by_label", ops: ["grow"], container: "unresolved by the index: native_bars_by_label.reserve(...)", owner: "engine-core", phase: "setup", state: "pending-flat-memory", inventory: "F11", grows_with: ["feed-rows"], line: 280}

‎ci/cr150-source-sites.json‎

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12175,6 +12175,71 @@
1217512175
"spelling": "selected . push_back ( . . . )",
1217612176
"ordinal": 1
1217712177
},
12178+
{
12179+
"file": "src/detail/o1_store.cpp",
12180+
"symbol": "reset",
12181+
"scope": [
12182+
"namespace pineforge #1",
12183+
"namespace detail #1",
12184+
"namespace o1 #1",
12185+
"StoreImpl :: StoreImpl ( const Shape & shape , ScratchBacking & backing ) : chunk_bytes_ ( shape . chunk_bytes ) #1"
12186+
],
12187+
"cls": "alloc",
12188+
"spelling": "new std::byte",
12189+
"ordinal": 1
12190+
},
12191+
{
12192+
"file": "src/detail/o1_store.cpp",
12193+
"symbol": "reset",
12194+
"scope": [
12195+
"namespace pineforge #1",
12196+
"namespace detail #1",
12197+
"namespace o1 #1",
12198+
"StoreImpl :: StoreImpl ( const Shape & shape , ScratchBacking & backing ) : chunk_bytes_ ( shape . chunk_bytes ) #1"
12199+
],
12200+
"cls": "alloc",
12201+
"spelling": "new CommandScratchStore",
12202+
"ordinal": 1
12203+
},
12204+
{
12205+
"file": "src/detail/o1_store.cpp",
12206+
"symbol": "transaction",
12207+
"scope": [
12208+
"namespace pineforge #1",
12209+
"namespace detail #1",
12210+
"namespace o1 #1",
12211+
"std :: unique_ptr < Tx > StoreImpl :: begin ( ) #1"
12212+
],
12213+
"cls": "alloc",
12214+
"spelling": "new StoreTx",
12215+
"ordinal": 1
12216+
},
12217+
{
12218+
"file": "src/detail/o1_store.cpp",
12219+
"symbol": "new:StoreImpl",
12220+
"scope": [
12221+
"namespace pineforge #1",
12222+
"namespace detail #1",
12223+
"namespace o1 #1",
12224+
"std :: unique_ptr < Store > Store :: open ( const Shape & shape , ScratchBacking & backing ) #1"
12225+
],
12226+
"cls": "alloc",
12227+
"spelling": "new StoreImpl",
12228+
"ordinal": 1
12229+
},
12230+
{
12231+
"file": "src/detail/o1_store.cpp",
12232+
"symbol": "<temp:string>",
12233+
"scope": [
12234+
"namespace pineforge #1",
12235+
"namespace detail #1",
12236+
"namespace o1 #1",
12237+
"[ [ noreturn ] ] void StoreImpl :: throw_status ( const char * what , ScratchStatus status ) const #1"
12238+
],
12239+
"cls": "temp",
12240+
"spelling": "std::string",
12241+
"ordinal": 1
12242+
},
1217812243
{
1217912244
"file": "src/engine_aux_security.cpp",
1218012245
"symbol": "bars",

0 commit comments

Comments
 (0)