Skip to content

Commit cdbf29a

Browse files
author
roctibot
committed
release: qualify HotM 2026.7.1 consumers (#284)
1 parent 1b220c1 commit cdbf29a

36 files changed

Lines changed: 867 additions & 137 deletions

‎.aiwg/api/compatibility/fortemi-v2026-07-family-evidence-map.json‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"generated_at": "2026-07-28",
3-
"fortemi_commit": "447fd514",
4-
"fortemi_latest_tag": "v2026.7.12",
3+
"fortemi_commit": "5ea08229",
4+
"fortemi_latest_tag": "v2026.7.19",
55
"purpose": "Machine-readable route-family evidence map for the HotM Fortemi v2026.7.1 verifier planning path. This is SDLC planning evidence; implementation PRs should keep it aligned with the generated route inventory.",
66
"evidence_levels": {
77
"strong": "Current source and focused test evidence exist for the route family.",

‎.aiwg/api/compatibility/fortemi-v2026-07-route-coverage.json‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
{
2-
"generated_at": "2026-07-28",
2+
"generated_at": "2026-07-29",
33
"fortemi_root": "../fortemi",
4-
"fortemi_commit": "447fd514",
5-
"fortemi_latest_tag": "v2026.7.12",
4+
"fortemi_commit": "5ea08229",
5+
"fortemi_latest_tag": "v2026.7.19",
66
"route_count": 202,
77
"status_counts": {
88
"covered": 188,

‎.aiwg/api/compatibility/fortemi-v2026-07-route-coverage.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
---
22
title: Fortemi v2026.7.1 Route Coverage Inventory
33
status: generated
4-
date: 2026-07-28
4+
date: 2026-07-29
55
artifact_type: api-coverage-inventory
66
---
77

88
# Fortemi v2026.7.1 Route Coverage Inventory
99

1010
- Fortemi source: `../fortemi`
11-
- Fortemi commit: `447fd514`
12-
- Latest release tag: `v2026.7.12`
11+
- Fortemi commit: `5ea08229`
12+
- Latest release tag: `v2026.7.19`
1313
- Extracted route declarations: `202`
1414

1515
## Status Counts

‎.aiwg/architecture/adr/ADR-010-fortemi-v2026-07-api-coverage.md‎

Lines changed: 14 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -88,8 +88,14 @@ HotM-specific persistence format.
8888

8989
The automated suite matrix in the Fortemi authority repository pins the exact
9090
schema authority, runtime, immutable native sidecar assets, React/core package,
91-
and HotM consumer revisions. Those values are authority-owned matrix inputs
92-
rather than values duplicated in this ADR.
91+
and HotM consumer revisions. For HotM `2026.7.1`, the release inputs are
92+
Fortemi runtime `5ea08229c9f1565122df5f8e6906e89d98dc7e75`
93+
(`v2026.7.19`), React/core
94+
`5cab4ea2d3d4bb985ea0d38f8bcb1ea790b32cf7`
95+
(`@fortemi/core@2026.7.15`), and immutable sidecar
96+
`sidecar-5ea08229c9f1`. The authority-owned matrix adds the exact HotM release
97+
commit and emits the platform and aggregate receipts. These are receipt
98+
identities, not consumer-defined authority.
9399

94100
For each required platform, Linux x86_64 on `matric-builder`, native Linux
95101
arm64 in mutsu's Colima VM, and native macOS arm64 on `mutsu`, the HotM gate
@@ -101,10 +107,12 @@ are independently hashed and checked by both the HotM receipt verifier and the
101107
suite aggregate.
102108

103109
Windows is the only deferred operating system because no Windows execution
104-
authority is available. Passing the three required cells does not establish
105-
universal platform portability, complete backup of all product state, a
106-
launched desktop GUI/native-dialog claim, or a shared schema across the AIWG
107-
static index, Knowledge Shard, and Fortemi persistence planes.
110+
authority is available. [Fortemi #1096](https://git.integrolabs.net/Fortemi/fortemi/issues/1096)
111+
owns native Windows validation as a separate deferred story. Passing the three
112+
required cells does not establish universal platform portability, complete
113+
backup of all product state, a launched desktop GUI/native-dialog claim, or a
114+
shared schema across the AIWG static index, Knowledge Shard, and Fortemi
115+
persistence planes.
108116

109117
### Realtime Contract Receipt (HotM #268)
110118

‎.aiwg/architecture/sad-fortemi-integration-addendum-2026-07.md‎

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -297,7 +297,18 @@ receipt-producing consumer journey on Linux x86_64, Linux arm64, and native
297297
macOS arm64 on `mutsu`. Linux arm64 executes in mutsu's native Colima VM and
298298
uses the immutable `aarch64-unknown-linux-gnu` Fortemi sidecar. Windows is the
299299
only deferred operating system because no Windows execution authority is
300-
available.
300+
available; [Fortemi #1096](https://git.integrolabs.net/Fortemi/fortemi/issues/1096)
301+
owns that future native Windows validation without weakening the required
302+
Unix cells.
303+
304+
HotM `2026.7.1` consumes Fortemi runtime
305+
`5ea08229c9f1565122df5f8e6906e89d98dc7e75` (`v2026.7.19`),
306+
React/core `5cab4ea2d3d4bb985ea0d38f8bcb1ea790b32cf7`
307+
(`@fortemi/core@2026.7.15`), and immutable sidecar
308+
`sidecar-5ea08229c9f1`. The Fortemi authority-owned matrix binds those inputs
309+
to the exact HotM release commit and is the source of the three platform
310+
receipts and required aggregate. The consumer does not redefine that
311+
authority.
301312

302313
These receipts prove the declared contract surface and exact
303314
`2.0.0/full-v1` path only at their bound revisions. They do not prove a

‎.aiwg/reports/doc-sync-20260729-code-to-docs.md‎

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
# Documentation Sync Report
2+
3+
**Date:** 2026-07-29
4+
**Direction:** code-to-docs
5+
**Mode:** bounded audit, dry-run first
6+
**Repository:** `Fortemi/HotM`
7+
**Baseline:** `v2026.7.0` (`55fa684440aba637dd39c95c50319096482b40a7`)
8+
**Audited head:** `1b220c1e1735314e70e610d84951db960742da35`
9+
10+
## Scope
11+
12+
The audit started from the 43 commits since the latest stable tag and
13+
changed-file inventories. It examined release-facing
14+
documentation, the Fortemi integration SAD addendum, ADR-010, committed
15+
consumer receipts, sidecar provenance, and the authority-owned suite platform
16+
matrix. Fortemi issue #1096 and the released Fortemi and React/core inputs
17+
were checked directly.
18+
19+
Release publication and tag creation remain delivery operations outside this
20+
documentation audit.
21+
22+
## Findings
23+
24+
| # | Finding | Resolution |
25+
|---|---|---|
26+
| 1 | No release changelog entry described the three-platform qualification contract. | Added exact runtime, React/core, and sidecar inputs, `2.0.0/full-v1` scope, and prohibited broad claims. |
27+
| 2 | The SAD named the required platforms but not the release inputs. | Bound it to the released authority, React/core, and immutable sidecar revisions. |
28+
| 3 | ADR-010 described authority-owned pinning without recording the release inputs. | Added exact inputs while preserving HotM's consumer-only role. |
29+
| 4 | Windows was deferred without linking its separate authority story. | Linked open Fortemi issue #1096 in release and architecture docs. |
30+
| 5 | The release SOP used moving `sidecar-latest` provenance and omitted current matrix evidence. | Documented immutable sidecar selection, both provenance manifests, three required assets, and the authority aggregate gate. |
31+
| 6 | HotM has no `.aiwg/release.config`. | Not created: required CI workflow names, publication assets, and release-entry automation are not fully defined by the SOP. Encoding them would require invention. |
32+
33+
## Changed Files
34+
35+
- `.aiwg/architecture/adr/ADR-010-fortemi-v2026-07-api-coverage.md`
36+
- `.aiwg/architecture/sad-fortemi-integration-addendum-2026-07.md`
37+
- `.aiwg/reports/doc-sync-20260729-code-to-docs.md`
38+
- `.aiwg/reports/doc-sync-last-run.json`
39+
- `CHANGELOG.md`
40+
- `docs/sops/release.md`
41+
42+
## Validation
43+
44+
- PASS: `.aiwg/testing/scripts/verify-fortemi-route-inventory.sh` against
45+
Fortemi `5ea08229` (`v2026.7.19`).
46+
- PASS: `node .aiwg/testing/scripts/verify-fortemi-event-catalog.mjs`.
47+
- PASS: `node .aiwg/testing/scripts/verify-fortemi-knowledge-shard-contract.mjs`.
48+
- PASS: `node .aiwg/testing/scripts/verify-fortemi-openapi-contract.mjs ../fortemi`.
49+
- PASS: `node .aiwg/testing/scripts/validate-manifest-schema.mjs`.
50+
- PASS: targeted live-asset receipt matrix tests, 17/17.
51+
- PASS: matrix-to-doc identities, JSON/provenance equality, and changed
52+
Markdown local links.
53+
- PASS: `git diff --check`, six-file scope, and report length (395 words before
54+
this final validation update; still below 600 words).
55+
- PASS: `python3 .aiwg/testing/scripts/verify-fortemi-closeout-package.py`.
56+
57+
## Human Review
58+
59+
1. Decide the exact HotM CI workflows, release asset inventory, and automated
60+
release-entry behavior before creating `.aiwg/release.config`.
61+
2. Require the exact authority aggregate before publishing the release tag.
62+
63+
No commit or push was performed.

‎.aiwg/reports/doc-sync-last-run.json‎

Lines changed: 123 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,126 @@
11
{
2-
"timestamp": "2026-04-22T03:42:28Z",
2+
"schemaVersion": 1,
3+
"workflow": "doc-sync",
34
"direction": "code-to-docs",
4-
"scope": "full repo",
5-
"findings_total": 70,
6-
"fixes_applied": 10,
7-
"files_modified": [
8-
"CLAUDE.md",
9-
"ui/src-tauri/tauri.conf.json"
10-
]
5+
"mode": "bounded-dry-run-first",
6+
"runAt": "2026-07-29T06:01:29Z",
7+
"finalizedAt": "2026-07-29T06:03:01Z",
8+
"repository": {
9+
"path": "/home/roctinam/dev/fortemi-suite/HotM",
10+
"remote": "Fortemi/HotM",
11+
"head": "1b220c1e1735314e70e610d84951db960742da35",
12+
"latestStableTag": "v2026.7.0",
13+
"latestStableCommit": "55fa684440aba637dd39c95c50319096482b40a7",
14+
"commitsSinceStable": 43
15+
},
16+
"scope": [
17+
"changed files since v2026.7.0",
18+
"release-facing documentation",
19+
"Fortemi integration SAD addendum",
20+
"ADR-010",
21+
"consumer receipts and sidecar provenance",
22+
"authority-owned supported-platform matrix"
23+
],
24+
"findings": [
25+
{
26+
"id": "DS-1",
27+
"status": "fixed",
28+
"summary": "Added release-facing qualification requirements for the three required platform cells."
29+
},
30+
{
31+
"id": "DS-2",
32+
"status": "fixed",
33+
"summary": "Bound the SAD to the exact released authority, React/core, and immutable sidecar inputs."
34+
},
35+
{
36+
"id": "DS-3",
37+
"status": "fixed",
38+
"summary": "Recorded the release inputs in ADR-010 without assigning authority to HotM."
39+
},
40+
{
41+
"id": "DS-4",
42+
"status": "fixed",
43+
"summary": "Linked Windows deferral to Fortemi/fortemi#1096."
44+
},
45+
{
46+
"id": "DS-5",
47+
"status": "fixed",
48+
"summary": "Reconciled the release SOP to immutable sidecar provenance and the authority aggregate gate."
49+
},
50+
{
51+
"id": "DS-6",
52+
"status": "human-review",
53+
"summary": "Release config omitted because CI workflow, asset, and release-entry policy is incomplete."
54+
}
55+
],
56+
"changedFiles": [
57+
".aiwg/architecture/adr/ADR-010-fortemi-v2026-07-api-coverage.md",
58+
".aiwg/architecture/sad-fortemi-integration-addendum-2026-07.md",
59+
".aiwg/reports/doc-sync-20260729-code-to-docs.md",
60+
".aiwg/reports/doc-sync-last-run.json",
61+
"CHANGELOG.md",
62+
"docs/sops/release.md"
63+
],
64+
"validation": [
65+
{
66+
"command": ".aiwg/testing/scripts/verify-fortemi-route-inventory.sh",
67+
"status": "passed",
68+
"note": "Passed against Fortemi 5ea08229 (v2026.7.19); generated route inventory is included."
69+
},
70+
{
71+
"command": "node .aiwg/testing/scripts/verify-fortemi-event-catalog.mjs",
72+
"status": "passed"
73+
},
74+
{
75+
"command": "node .aiwg/testing/scripts/verify-fortemi-knowledge-shard-contract.mjs",
76+
"status": "passed"
77+
},
78+
{
79+
"command": "node .aiwg/testing/scripts/verify-fortemi-openapi-contract.mjs ../fortemi",
80+
"status": "passed"
81+
},
82+
{
83+
"command": "node .aiwg/testing/scripts/validate-manifest-schema.mjs",
84+
"status": "passed"
85+
},
86+
{
87+
"command": "npm test -- --run scripts/verify-live-asset-ci-receipt-matrix.test.js scripts/verify-live-asset-ci-receipt.test.js scripts/verify-live-asset-ci-receipt-pair.test.js",
88+
"status": "passed",
89+
"note": "17 tests passed across two discovered test files."
90+
},
91+
{
92+
"command": "matrix-to-doc identity validation",
93+
"status": "passed"
94+
},
95+
{
96+
"command": "changed Markdown local-link validation",
97+
"status": "passed"
98+
},
99+
{
100+
"command": "jq empty and sidecar provenance equality",
101+
"status": "passed"
102+
},
103+
{
104+
"command": "git diff --check and authorized-scope validation",
105+
"status": "passed"
106+
},
107+
{
108+
"command": "python3 .aiwg/testing/scripts/verify-fortemi-closeout-package.py",
109+
"status": "passed",
110+
"note": "Route inventory and evidence-map producer identities agree."
111+
}
112+
],
113+
"humanReview": [
114+
"Define exact HotM CI workflows, publication assets, and release-entry automation before creating .aiwg/release.config.",
115+
"Require the exact authority aggregate before publishing the release tag."
116+
],
117+
"releaseConfig": {
118+
"created": false,
119+
"reason": "Existing documentation does not define enough policy to encode a release flow without invention."
120+
},
121+
"delivery": {
122+
"committed": false,
123+
"pushed": false
124+
},
125+
"status": "ready-for-delivery"
11126
}

‎.aiwg/research/provenance/index.yaml‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
metadata:
22
schema_version: "1.0.0"
3-
updated_at: "2026-07-29T03:43:34Z"
4-
record_count: 88
3+
updated_at: "2026-07-30T01:38:05Z"
4+
record_count: 90
55
records:
66
- entity: "urn:aiwg:artifact:scripts/download-pinned-sidecar.sh"
77
record: "records/download-pinned-sidecar-hotm-284.prov.yaml"
@@ -179,3 +179,7 @@ records:
179179
record: "records/run-live-asset-receipt-hotm-284.prov.yaml"
180180
- entity: "urn:aiwg:artifact:ui/src-tauri/gen/schemas/macOS-schema.json"
181181
record: "records/macOS-schema-hotm-284.prov.yaml"
182+
- entity: "urn:aiwg:artifact:.aiwg/reports/doc-sync-last-run.json"
183+
record: "records/doc-sync-last-run.json.prov.yaml"
184+
- entity: "urn:aiwg:artifact:.aiwg/reports/doc-sync-20260729-code-to-docs.md"
185+
record: "records/doc-sync-20260729-code-to-docs.md.prov.yaml"

‎.aiwg/research/provenance/records/ADR-010-fortemi-v2026-07-api-coverage.md.prov.yaml‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,24 @@
11
metadata:
22
schema_version: "1.0.0"
33
created_at: "2026-07-17T21:46:51Z"
4-
updated_at: "2026-07-29T02:54:25Z"
4+
updated_at: "2026-07-30T01:38:05Z"
55
description: "Provenance for the Fortemi consumer strategy and three-platform adherence gate"
66
entity:
77
id: "urn:aiwg:artifact:.aiwg/architecture/adr/ADR-010-fortemi-v2026-07-api-coverage.md"
88
type: document
99
created_at: "2026-07-17T21:46:51Z"
10-
updated_at: "2026-07-29T02:54:25Z"
11-
checksum: "sha256:6e95a94d45eb7356b1f93d5c9d40842d72827a2714d52b810756c869bd6fdca1"
12-
size_bytes: 13485
10+
updated_at: "2026-07-30T01:38:05Z"
11+
checksum: "sha256:bb9c05c12b329e88fc131d6131c25d05549df2db15aca70f429faec73c1055b7"
12+
size_bytes: 13948
1313
attributes:
1414
change_scope: "hotm-three-platform-consumer-adherence"
1515
base_revision: "ca035799bfe46b622be1e1a131de986cd19f2a72"
1616
activity:
1717
id: "urn:aiwg:activity:modification:aiwg-architecture-adr-ADR-010-fortemi-v2026-07-api-coverage-md:001"
1818
type: modification
1919
started_at: "2026-07-17T21:46:51Z"
20-
ended_at: "2026-07-29T02:54:25Z"
21-
description: "Require Linux x86_64, Linux arm64, and mutsu macOS while deferring only Windows"
20+
ended_at: "2026-07-30T01:38:05Z"
21+
description: "Bind the three-platform consumer gate to released Fortemi, React/core, and immutable sidecar inputs"
2222
agent:
2323
id: "urn:aiwg:agent:codex-gpt-5"
2424
type: ai_assistant
@@ -29,7 +29,7 @@ relationships:
2929
wasGeneratedBy:
3030
entity: "urn:aiwg:artifact:.aiwg/architecture/adr/ADR-010-fortemi-v2026-07-api-coverage.md"
3131
activity: "urn:aiwg:activity:modification:aiwg-architecture-adr-ADR-010-fortemi-v2026-07-api-coverage-md:001"
32-
time: "2026-07-29T02:54:25Z"
32+
time: "2026-07-30T01:38:05Z"
3333
used:
3434
- activity: "urn:aiwg:activity:modification:aiwg-architecture-adr-ADR-010-fortemi-v2026-07-api-coverage-md:001"
3535
entity: "urn:git:git@git.integrolabs.net:Fortemi/HotM.git:ca035799bfe46b622be1e1a131de986cd19f2a72:.aiwg/architecture/adr/ADR-010-fortemi-v2026-07-api-coverage.md"

‎.aiwg/research/provenance/records/doc-sync-20260729-code-to-docs.md.prov.yaml‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
metadata:
2+
schema_version: "1.0.0"
3+
created_at: "2026-07-30T01:38:05Z"
4+
description: "Provenance for the HotM 2026.7.1 code-to-docs audit report"
5+
entity:
6+
id: "urn:aiwg:artifact:.aiwg/reports/doc-sync-20260729-code-to-docs.md"
7+
type: document
8+
created_at: "2026-07-30T01:38:05Z"
9+
checksum: "sha256:d7892cf93ab1e51d657911630acfdde495e3dd424d423f1a6427fe7d9ca7809d"
10+
size_bytes: 3259
11+
attributes:
12+
change_scope: "hotm-2026.7.1-release-documentation"
13+
base_revision: "1b220c1e1735314e70e610d84951db960742da35"
14+
activity:
15+
id: "urn:aiwg:activity:generation:doc-sync-20260729-code-to-docs-md:001"
16+
type: generation
17+
started_at: "2026-07-29T06:01:29Z"
18+
ended_at: "2026-07-30T01:38:05Z"
19+
description: "Document release-input reconciliation, claim boundaries, and validation"
20+
agent:
21+
id: "urn:aiwg:agent:codex-gpt-5"
22+
type: ai_assistant
23+
name: "Codex"
24+
version: "gpt-5"
25+
tool: "codex"
26+
relationships:
27+
wasGeneratedBy:
28+
entity: "urn:aiwg:artifact:.aiwg/reports/doc-sync-20260729-code-to-docs.md"
29+
activity: "urn:aiwg:activity:generation:doc-sync-20260729-code-to-docs-md:001"
30+
time: "2026-07-30T01:38:05Z"
31+
used:
32+
- activity: "urn:aiwg:activity:generation:doc-sync-20260729-code-to-docs-md:001"
33+
entity: "urn:git:git@git.integrolabs.net:Fortemi/HotM.git:1b220c1e1735314e70e610d84951db960742da35"
34+
role: "baseline"
35+
- activity: "urn:aiwg:activity:generation:doc-sync-20260729-code-to-docs-md:001"
36+
entity: "urn:gitea:Fortemi/fortemi:issue:1096"
37+
role: "windows_deferral"
38+
wasAssociatedWith:
39+
activity: "urn:aiwg:activity:generation:doc-sync-20260729-code-to-docs-md:001"
40+
agent: "urn:aiwg:agent:codex-gpt-5"
41+
role: "primary_author"
42+
wasAttributedTo:
43+
entity: "urn:aiwg:artifact:.aiwg/reports/doc-sync-20260729-code-to-docs.md"
44+
agent: "urn:aiwg:agent:codex-gpt-5"

0 commit comments

Comments
 (0)