Skip to content

Commit 17087c5

Browse files
HaoLiangWenHaoLiangWen
authored andcommitted
docs: declare selected-window contract revision 1.3-parity for 1.6.1 (EN-115)
Update docs/pages/report-schema.md, docs/pages/public-contract.md, docker/README.md and README.md so the image declares selected-window contract revision 1.3-parity (["1.3-parity"] on a supported runtime and [] otherwise), covering value ownership through strategy_value_invalid, engine_command_value_invalid, report_result_invalid and report_post_execution_failed, value parity with the 1.4.0 reference on tested cases, and no completeness claim. Add the 1.6.1 — Unreleased entry to CHANGELOG.md (EN-115: no completeness proof). VERSION stays untouched. Replaces the 1.3 capability sentences introduced by 868aa65 and 517a1b4 (following 47184e5): - docs/pages/report-schema.md (868aa65): "The engine/codegen 1.6.0 image declares selected-window contract revision 1.3, meaning complete value ownership with strategy_value_invalid, engine_command_value_invalid, report_result_invalid and report_post_execution_failed." and "The --capabilities-json probe's capabilities.selected_window_contract_revisions is ["1.3"] for a supported runtime and [] otherwise." - docs/pages/public-contract.md (517a1b4, 868aa65): "It declares selected-window contract revision 1.3 (["1.3"] under capabilities.selected_window_contract_revisions when the runtime supports selected windows and [] otherwise) and extends 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), without changing C layouts or PF_ABI_VERSION 4." - README.md (517a1b4, 868aa65): "The release notes cover selected-window contract revision 1.3, typed failures across source values, engine arithmetic and report production, finite trade and summary doubles, and the documentation, test, CI and benchmark updates since 1.5.0.", "The engine/codegen 1.6.0 image advertises selected-window contract revision 1.3 through docker/run_json.py --capabilities-json: value ownership through strategy_value_invalid, engine_command_value_invalid, report_result_invalid and report_post_execution_failed.", "capabilities.selected_window_contract_revisions is ["1.3"] when the runtime supports selected windows and [] otherwise; see the capability table and report schema." and the v1.6.0 Releases bullet ("selected-window contract revision 1.3"). - docker/README.md (517a1b4, 868aa65): "The engine/codegen 1.6.0 image's run_json.py --so <strategy.so> --capabilities-json probe declares revision 1.3, covering value ownership through strategy_value_invalid, engine_command_value_invalid, report_result_invalid and report_post_execution_failed." and the selected_window_contract_revisions table row.
1 parent fd024fd commit 17087c5

5 files changed

Lines changed: 56 additions & 30 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,24 @@ README's *Releases* section and on the GitHub releases page. From 1.0.0 the
55
version number follows semantic versioning over the surfaces the
66
[public contract](docs/pages/public-contract.md) lists.
77

8+
## 1.6.1 — Unreleased
9+
10+
- **The selected-window contract is revision `1.3-parity` (EN-115).** Since
11+
[#388], `docker/selected_window_report.py` (`CONTRACT_REVISIONS`) and the
12+
`docker/run_json.py --capabilities-json` probe declared
13+
`capabilities.selected_window_contract_revisions` as `["1.3"]` in 1.6.0.
14+
Under amendment 6 of the selected-window contract, revision `"1.3"` pairs
15+
only with `value_ownership` `"complete"`, and no completeness proof has run
16+
(EN-115). The probe now declares `["1.3-parity"]` when the runtime supports
17+
selected windows and `[]` otherwise (`value_ownership`
18+
`parity_with_reference`, as in 1.5.0): value parity with the 1.4.0 reference
19+
on the tested cases, with the four typed value-ownership codes
20+
(`strategy_value_invalid`, `engine_command_value_invalid`,
21+
`report_result_invalid` and `report_post_execution_failed`) emitted, and no
22+
completeness claim. The C layouts stay at ABI 4, `PF_ABI_VERSION` stays 4,
23+
the selected-window wire version stays 1, the phase version 1 and the
24+
fingerprint/schema version 2.
25+
826
## 1.6.0 — 2026-10-17
927

1028
**[1.6.0](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.6.0)**,

‎README.md‎

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -41,20 +41,22 @@ part of **1.5.0**.
4141
**[1.6.0](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.6.0)
4242
was released on 2026-10-17**, paired with
4343
[pineforge-codegen 1.6.0](https://github.com/pineforge-4pass/pineforge-codegen-oss/releases/tag/v1.6.0).
44-
The [release notes](CHANGELOG.md#160--2026-10-17) cover selected-window
45-
contract revision 1.3, typed failures across source values, engine arithmetic
46-
and report production, finite trade and summary doubles, and the documentation,
47-
test, CI and benchmark updates since 1.5.0.
44+
The [release notes](CHANGELOG.md#160--2026-10-17) cover typed failures across
45+
source values, engine arithmetic and report production, finite trade and
46+
summary doubles, and the documentation, test, CI and benchmark updates since
47+
1.5.0; in [1.6.1 (unreleased)](CHANGELOG.md#161--unreleased) the selected-window
48+
contract revision is `1.3-parity` rather than `1.3`.
4849
For the 1.6.0 pair, regenerate strategy C++ and relink against that pair's
4950
headers and archive. Published 1.3.0 download and installation examples below
5051
remain pinned to that earlier pair.
5152

52-
The engine/codegen **1.6.0** image advertises selected-window contract revision
53-
`1.3` through `docker/run_json.py --capabilities-json`: value ownership through
54-
`strategy_value_invalid`, `engine_command_value_invalid`,
55-
`report_result_invalid` and `report_post_execution_failed`.
56-
`capabilities.selected_window_contract_revisions` is `["1.3"]` when the runtime
57-
supports selected windows and `[]` otherwise; see the
53+
The engine/codegen image advertises selected-window contract revision
54+
`1.3-parity` through `docker/run_json.py --capabilities-json`: value ownership
55+
through `strategy_value_invalid`, `engine_command_value_invalid`,
56+
`report_result_invalid` and `report_post_execution_failed`, parity with the
57+
1.4.0 reference on tested cases, and no completeness claim.
58+
`capabilities.selected_window_contract_revisions` is `["1.3-parity"]` when the
59+
runtime supports selected windows and `[]` otherwise; see the
5860
[capability table](docker/README.md#selected-window-contract-revision) and
5961
[report schema](docs/pages/report-schema.md).
6062

@@ -685,7 +687,7 @@ Documentation: [C ABI reference](https://cdocs.pineforge.dev) · [Getting starte
685687

686688
## Releases
687689

688-
- **[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); 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).
690+
- **[v1.6.0](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.6.0)** (2026-10-17) — selected-window contract revision `1.3-parity` in 1.6.1 (`capabilities.selected_window_contract_revisions: ["1.3-parity"]` on a supported runtime and `[]` otherwise, covering value ownership through the four codes, parity with the 1.4.0 reference on tested cases, and no completeness claim; the 1.6.0 tag declared `["1.3"]` without a completeness proof); 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).
689691
- **[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).
690692
- **[v1.4.0](https://github.com/pineforge-4pass/pineforge-engine/releases/tag/v1.4.0)** (2026-10-08) — two additive C failure getters; typed input/override provenance with explicit unresolved reasons and duplicate-title counts; coded failure JSON and checked-setting refusals; Pine exit/fill-location corrections that can change trades, reports and hash values on the affected paths; chart-timeframe live input and final-delivery draining; feed ownership and verification improvements. The C layouts stay at ABI 4, while hash recipes and report content have the disclosed changes. Pair with codegen 1.4.0, regenerate and relink. See [CHANGELOG.md](CHANGELOG.md#140--2026-10-08).
691693
- **v1.3.0** (2026-10-06) — a minor release: `pineforge-live` admits the proven confirmed-bar request shapes and standalone close-only `varip` from the confirmed-bar receipt a strategy generated by pineforge-codegen 1.3.0 exports; Pine adapter parity changes (exit binding at the call, global exits on a held position beside an opposite entry or a same-side add, margin calls at the open after a `process_orders_on_close` close fill, the margin-call schedule, the exact reversal tie, the carried trail, the position view after a close fill, open-marketable exits first). `pineforge.h` is unchanged. No report key changes. The hub image `pineforge-release:1.3.0` carries the pair; regenerate and relink. See [CHANGELOG.md](CHANGELOG.md).

‎docker/README.md‎

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -268,14 +268,15 @@ docker run --rm \
268268

269269
### Selected-window contract revision
270270

271-
The engine/codegen **1.6.0** image's `run_json.py --so <strategy.so>
272-
--capabilities-json` probe declares revision `1.3`, covering value ownership
273-
through `strategy_value_invalid`, `engine_command_value_invalid`,
274-
`report_result_invalid` and `report_post_execution_failed`.
271+
The engine/codegen image's `run_json.py --so <strategy.so>
272+
--capabilities-json` probe declares revision `1.3-parity`, covering value
273+
ownership through `strategy_value_invalid`, `engine_command_value_invalid`,
274+
`report_result_invalid` and `report_post_execution_failed`, value parity with
275+
the 1.4.0 reference on tested cases, and no completeness claim.
275276

276277
| Capability member | Supported runtime | Unsupported runtime |
277278
| --- | --- | --- |
278-
| `selected_window_contract_revisions` | `["1.3"]` | `[]` |
279+
| `selected_window_contract_revisions` | `["1.3-parity"]` | `[]` |
279280

280281
This member belongs to the probe's `capabilities` object. The selected-window
281282
wire version remains 1, the phase version 1 and the fingerprint/schema version 2.

‎docs/pages/public-contract.md‎

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -41,15 +41,19 @@ gives each run's report to the call that began it. The repository's
4141
private repository.
4242

4343
1.6.0 followed on 2026-10-17: engine v1.6.0 with pineforge-codegen 1.6.0.
44-
It declares selected-window contract revision `1.3` (`["1.3"]` under
44+
It extends typed failures across source value admission
45+
(`strategy_value_invalid`), derived execution and settlement arithmetic
46+
(`engine_command_value_invalid`), non-finite canonical trade or summary doubles
47+
(`report_result_invalid`) and post-boundary serialization faults
48+
(`report_post_execution_failed`), without changing C layouts or
49+
`PF_ABI_VERSION` 4; in 1.6.1 (unreleased; see
50+
[CHANGELOG.md](../../CHANGELOG.md#161--unreleased)) the image declares
51+
selected-window contract revision `1.3-parity` (`["1.3-parity"]` under
4552
`capabilities.selected_window_contract_revisions` when the runtime supports
46-
selected windows and `[]` otherwise) and extends typed failures across source
47-
value admission (`strategy_value_invalid`), derived execution and settlement
48-
arithmetic (`engine_command_value_invalid`), non-finite canonical trade or
49-
summary doubles (`report_result_invalid`) and post-boundary serialization
50-
faults (`report_post_execution_failed`), without changing C layouts or
51-
`PF_ABI_VERSION` 4. The repository's
52-
[CHANGELOG.md](../../CHANGELOG.md#160--2026-10-17), under
53+
selected windows and `[]` otherwise), covering value ownership through those
54+
four codes, parity with the 1.4.0 reference on tested cases, and no
55+
completeness claim (1.6.0 declared `1.3` without a completeness proof). The
56+
repository's [CHANGELOG.md](../../CHANGELOG.md#160--2026-10-17), under
5357
*1.6.0 — 2026-10-17*, inventories these changes and the documentation, test,
5458
CI and benchmark updates since 1.5.0.
5559
Use the same-version 1.6.0 pair, with regeneration and relinking as below.

‎docs/pages/report-schema.md‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,14 +7,15 @@ each field to its meaning and units.
77

88
@see #pf_report_t for the verbatim struct declaration.
99

10-
The engine/codegen **1.6.0** image declares selected-window contract revision
11-
`1.3`, meaning complete value ownership with `strategy_value_invalid`,
10+
The engine/codegen image declares selected-window contract revision
11+
`1.3-parity`, covering value ownership through `strategy_value_invalid`,
1212
`engine_command_value_invalid`, `report_result_invalid` and
13-
`report_post_execution_failed`.
13+
`report_post_execution_failed`, value parity with the 1.4.0 reference on tested
14+
cases, and no completeness claim.
1415
The `--capabilities-json` probe's
15-
`capabilities.selected_window_contract_revisions` is `["1.3"]` for a supported
16-
runtime and `[]` otherwise. The declaration lives in that capability record;
17-
the selected-window wire version remains 1, the phase version 1 and the
16+
`capabilities.selected_window_contract_revisions` is `["1.3-parity"]` for a
17+
supported runtime and `[]` otherwise. The declaration lives in that capability
18+
record; the selected-window wire version remains 1, the phase version 1 and the
1819
fingerprint/schema version 2.
1920

2021
## Top-level layout

0 commit comments

Comments
 (0)