Skip to content

Commit 69db2cd

Browse files
committed
docs: amend Docker evidence portability contract
1 parent d54cd97 commit 69db2cd

2 files changed

Lines changed: 20 additions & 2 deletions

File tree

docs/issues/tb-portreeve-stacks/issues.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,7 @@ human review and merge.
141141

142142
## I-6 - Add the desktop Stacks experience and failure details
143143

144-
- **Status:** in-review
144+
- **Status:** closed
145145
- **Estimate:** 3d
146146
- **Plan steps:** P7
147147
- **Rubric criteria:** R8
@@ -171,11 +171,18 @@ desktop, protocol, client, CLI, package, and boundary gates passed.
171171
- **Plan steps:** P8
172172
- **Rubric criteria:** R1, R2, R3, R4, R5, R6, R7, R8
173173
- **Depends on:** I-3, I-5, I-6
174-
- **PR:** -
174+
- **PR:** [#13](https://github.com/TrentBrown/portreeve/pull/13)
175175

176176
Finish public documentation and representative examples, run mixed-stack and legacy
177177
end-to-end matrices on supported native environments and the packaged desktop, execute
178178
every workflow gate, and preserve the feature-final evidence and completion report.
179179

180180
**Started 2026-08-07.** Final sequential delivery branch
181181
`tb-portreeve-stacks-07-feature-final` begins from merged `main` at `0fc3865`.
182+
183+
**Implementation complete 2026-08-07.** PR #13 adds public desktop and representative
184+
mixed-stack launcher guides plus a disposable assembled process/Docker lifecycle gate.
185+
The first Linux run exposed that Docker Engine kernel-NAT publication has no userspace
186+
listener; binding-appropriate Docker inspection replaced that false portability
187+
assumption. The corrected matrix passes on Linux x64/ARM64 and macOS x64/ARM64, and the
188+
packaged macOS ARM64 desktop launches with healthy service and Stacks evidence.

docs/issues/tb-portreeve-stacks/spec.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,3 +74,14 @@ The global Definition of Done in the software development workflow applies.
7474
## Changes
7575

7676
Append spec amendments here. Do not remove or weaken original criteria.
77+
78+
### 2026-08-07 - AC3 Docker publication evidence portability
79+
80+
The AC3 phrase "fresh listener evidence" remains literal for process-backed endpoints.
81+
For Docker-backed endpoints, fresh publication evidence is binding-appropriate: exact
82+
fresh Docker inspection must prove the submitted container is running, carries every
83+
activation label, and publishes the allocated loopback host port to the declared
84+
container port. A userspace listener observed by `lsof` is corroborating evidence, but
85+
its absence is not a failure because supported Linux Docker Engine configurations may
86+
publish through kernel NAT. A stored container ID alone remains insufficient, Docker
87+
never uses process lineage, and Portreeve still makes no application-health claim.

0 commit comments

Comments
 (0)