Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
151 commits
Select commit Hold shift + click to select a range
cdc8b66
test(contracts): establish C10 evidence foundation and C01 RED proces…
loong10k Sep 21, 2026
94de053
fix(ci): restore wrapper launcher and preserve contract evidence arti…
loong10k Sep 21, 2026
c93a25c
fix(argv): preserve literal values across executor adapter and typed …
loong10k Sep 21, 2026
6f830b4
fix(argv): bypass Commons Exec internal argument trimming
loong10k Sep 21, 2026
d02b16d
test(argv): add ordered option and immutable request RED contracts
loong10k Sep 21, 2026
48b1438
feat(argv): add schema-checked ordered options and immutable request …
loong10k Sep 21, 2026
31bde9c
test(process): add C02 bounded lifecycle RED contracts
loong10k Sep 21, 2026
98e3db1
fix(process): enforce stable capacity deadlines and bounded native ca…
loong10k Sep 21, 2026
3bacc8d
test(contracts): extend lifecycle boundaries and layered execution ev…
loong10k Sep 21, 2026
d2690ce
docs(implementation): record verified C10 C01 C02 progress and open r…
loong10k Sep 21, 2026
41ffefd
ci(contracts): provide scoped offline reproduction dependencies
loong10k Sep 21, 2026
6c5c9b3
ci(contracts): capture pinned OpenCLI descriptive schemas in isolation
loong10k Sep 21, 2026
80ebb3b
fix(contracts): build exact upstream ref when npm version is unpublished
loong10k Sep 21, 2026
d7b4dfa
feat(opencli): integrate C01 C02 contracts on current 2.0 line
loong10k Nov 18, 2026
f9c058b
ci(opencli): select JDK 17 for named 2.0 contract branch
loong10k Nov 18, 2026
9717538
fix(opencli): retain cleanup evidence when stop operations throw
loong10k Nov 18, 2026
1d66f1b
test(opencli): cover simultaneous C02 terminal signals
loong10k Nov 18, 2026
527faf0
fix(opencli): retain reader I/O cause in terminal evidence
loong10k Nov 18, 2026
177d782
fix: contain watchdog startup failure after process spawn
loong10k Nov 18, 2026
5e2cd13
fix: contain process setup failures after spawn
loong10k Nov 18, 2026
8f0d205
test: verify interrupted process cleanup and permit reuse
loong10k Nov 18, 2026
8278dd7
fix: keep remote HTTP diagnostics free of payloads
loong10k Nov 18, 2026
137919e
fix: omit parser input from debug diagnostics
loong10k Nov 18, 2026
345306c
fix: keep WebSocket diagnostics free of URL payloads
loong10k Nov 18, 2026
6e23120
fix: omit native process paths from public exceptions
loong10k Nov 18, 2026
1485788
fix: correlate payload-free remote HTTP diagnostics
loong10k Nov 18, 2026
611441d
Keep caller values out of OpenCLI debug logs
loong10k Nov 18, 2026
1290758
Keep OpenCLI HTTP and argv errors safe to print
loong10k Nov 18, 2026
0e1557f
Verify OpenCLI process privacy across supported JDK lines
loong10k Nov 18, 2026
72abff8
Add explicit bounded diagnostic exports
loong10k Nov 18, 2026
97a142d
Record three-line diagnostic export verification
loong10k Nov 18, 2026
5e6a36c
Initialize OpenCLI watchdog only for spawned processes
loong10k Nov 18, 2026
4aeae17
Record verified OpenCLI lifecycle contracts across three JDK lines
loong10k Nov 18, 2026
848a7d1
docs: clarify OpenCLI local subprocess limits
loong10k Nov 18, 2026
ae85c19
ci: verify OpenCLI subprocess contracts on macOS and Windows
loong10k Nov 18, 2026
7edcda4
fix: preserve literal quotes for Windows native executables
loong10k Nov 18, 2026
a41f548
Report incomplete OpenCLI stream cleanup at the deadline
loong10k Nov 18, 2026
6fcd9ba
test: preserve mutable argv fixture prefixes on Windows
loong10k Nov 18, 2026
a05e3c0
test: verify the installed Windows OpenCLI launch path
loong10k Nov 18, 2026
d40f4de
test: exercise reverse WebSocket sessions with a real child process
loong10k Nov 18, 2026
55b31d4
fix: gate reverse WebSocket collection on registration
loong10k Nov 18, 2026
cddc146
test: verify bounded OpenCLI network follow outcomes
loong10k Nov 18, 2026
ec49fff
fix: bound reverse WebSocket collect execution and waiting
loong10k Nov 18, 2026
e933045
fix: cancel queued collect work on reverse worker close
loong10k Nov 18, 2026
599ce1d
fix: deduplicate reverse WebSocket collect requests
loong10k Nov 18, 2026
5ba97e5
ci: exercise reverse WebSocket contracts across platforms
loong10k Nov 18, 2026
c327bc5
test: exercise OpenCLI process privacy across platforms
loong10k Nov 18, 2026
d22a193
test: capture OpenCLI 1.8.8 error envelope fixtures
loong10k Nov 18, 2026
42e1597
docs: record live OpenCLI network follow verification
loong10k Nov 18, 2026
ea9cccf
test: record OpenCLI error parser review evidence
loong10k Nov 18, 2026
9d2b43b
fix: cap OpenCLI capture buffer allocation
loong10k Nov 18, 2026
dd4f395
test: verify OpenCLI saturated process and capture limits
loong10k Nov 18, 2026
0340522
test: cover cancellation with inherited OpenCLI pipes
loong10k Nov 18, 2026
6e59945
fix: allocate OpenCLI output capture on first write
loong10k Nov 18, 2026
2a5ecb7
fix: bound blocking OpenCLI process termination
loong10k Nov 18, 2026
0151322
test: verify OpenCLI argv snapshot while queued
loong10k Nov 18, 2026
324b9e1
test: use native Windows argv probe for queued calls
loong10k Nov 18, 2026
76e92d4
fix: retire stopped OpenCLI WebSocket generations
loong10k Nov 18, 2026
ae4d409
fix: drain OpenCLI reverse worker on restartable stop
loong10k Nov 18, 2026
e2b956c
fix: bound and gate OpenCLI WebSocket ingress
loong10k Nov 18, 2026
8c3e96c
fix: reconnect OpenCLI worker after failed result delivery
loong10k Nov 18, 2026
0b88820
test: verify OpenCLI worker resources across disconnect and close
loong10k Nov 18, 2026
d0ecad7
ci: add Intel macOS subprocess coverage
loong10k Nov 18, 2026
f3022d4
fix: keep private data out of OpenCLI exception diagnostics
loong10k Nov 18, 2026
f2e9e03
ci: require exception privacy evidence on hosted platforms
loong10k Nov 18, 2026
e16dd2d
docs: align OpenCLI consumer examples with the version line
loong10k Nov 18, 2026
5ac4bb1
Merge verified 2.0.x Maven coverage and Wrapper fixes
loong10k Nov 18, 2026
cf9360e
Reject malformed legacy collect response envelopes
loong10k Nov 18, 2026
e5c745d
docs: record verified OpenCLI branch build evidence
loong10k Nov 18, 2026
a5448e1
Reject lossy legacy collect argv before dispatch
loong10k Nov 18, 2026
624e758
Preserve executor overrides for local passthrough
loong10k Nov 18, 2026
bf05ba6
Bound decoded legacy collect response bodies
loong10k Nov 18, 2026
8d826a1
Apply a total budget to legacy HTTP collect
loong10k Nov 18, 2026
106585e
Retain status and exit provenance for legacy collect
loong10k Nov 18, 2026
b40ed5a
Send explicit collect credentials only over verified HTTPS
loong10k Nov 18, 2026
0cbb3ee
Verify authenticated HTTPS collect across the three JDK lines
loong10k Nov 18, 2026
3406ee0
Capture OpenCLI 1.8.8 structured help contracts
loong10k Nov 18, 2026
64d0aba
Keep raw availability details out of startup diagnostics
loong10k Nov 18, 2026
98f2834
Merge branch 'feature/REQ-20261118-wandl-opencli-contracts-20' of htt…
loong10k Nov 18, 2026
bf4498d
Require pinned structured help evidence in OpenCLI CI
loong10k Nov 18, 2026
1ff6377
Decode versioned OpenCLI structured help with explicit unknown states
loong10k Nov 18, 2026
f02aa1b
Validate complete OpenCLI structured help output
loong10k Nov 18, 2026
b22796f
Probe trusted local OpenCLI root capabilities with bounded execution
loong10k Nov 18, 2026
b475035
Reject malformed structured help catalogs
loong10k Nov 18, 2026
532cf67
Retain matching OpenCLI help snapshots on failed refresh
loong10k Nov 18, 2026
a6b59b5
Discover pinned OpenCLI help scopes without executing commands
loong10k Nov 18, 2026
528fac1
Reject malformed version output before capability discovery
loong10k Nov 18, 2026
441122f
Bind and validate discovered OpenCLI commands before local execution
loong10k Nov 18, 2026
fcb88f3
Record OpenCLI capability parity across Java versions
loong10k Nov 18, 2026
b77a6c7
Verify OpenCLI capability provenance with real local and plugin overr…
loong10k Nov 18, 2026
83e3614
Verify OpenCLI help metadata does not establish provenance
loong10k Nov 18, 2026
15fac6a
Use a portable file URI for OpenCLI integration test preload
loong10k Nov 18, 2026
f52262e
Preserve bounded OpenCLI stderr envelopes and observed exit evidence
loong10k Nov 18, 2026
ff75cd7
Verify OpenCLI error envelope parity across wire formats
loong10k Nov 18, 2026
f2feb18
Add strict OpenCLI browser tab and navigation results
loong10k Nov 18, 2026
3138332
Verify typed browser failures preserve the original subprocess result
loong10k Nov 18, 2026
b1d8386
Decode OpenCLI DOM and AX state results by output format
loong10k Nov 18, 2026
a445f7b
Validate OpenCLI snapshot header and line separators
loong10k Nov 18, 2026
115b095
Add strict OpenCLI browser query and capture results
loong10k Nov 18, 2026
7aaac86
Preserve the OpenCLI console level field in typed results
loong10k Nov 18, 2026
2eb97e4
Bind isolated OpenCLI invocation context to verified option scopes
loong10k Nov 18, 2026
d80e14e
Snapshot OpenCLI positional arguments before capability probes
loong10k Nov 18, 2026
3c9979e
Report OpenCLI diagnostics without loading runtime or repair commands
loong10k Nov 18, 2026
c12df8d
Verify typed OpenCLI results through a real Browser Bridge
loong10k Nov 18, 2026
6da93d0
Require nonempty evidence per OpenCLI contract suite
loong10k Nov 18, 2026
a35219a
Separate current OpenCLI contract evidence from prior test reports
loong10k Nov 18, 2026
004c328
Exercise OpenCLI browser query and capture through the real bridge
loong10k Nov 18, 2026
ff9d999
Enforce shared OpenCLI fixture provenance on every Java line
loong10k Nov 18, 2026
3c0c179
test: verify private diagnostics for malformed OpenCLI YAML errors
loong10k Nov 18, 2026
807801e
test: verify OpenCLI typed Browser operations retain bound tabs
loong10k Nov 18, 2026
a2b2268
fix: retain evidence when legacy OpenCLI collect loses its response
loong10k Nov 18, 2026
a4687d1
test: verify OpenCLI context remains isolated on command failure
loong10k Nov 18, 2026
84ffb50
test: synchronize overlapping OpenCLI context failure calls
loong10k Nov 18, 2026
bf4f078
test: verify bounded OpenCLI follow preserves the shared bridge
loong10k Nov 18, 2026
91b6175
Record reproducible upstream OpenCLI manifest provenance
loong10k Nov 18, 2026
d6e2da5
Lock and replay the OpenCLI 1.8.8 upstream samples
loong10k Nov 18, 2026
09a8f60
Correlate local OpenCLI failure diagnostics without payloads
loong10k Nov 18, 2026
df09b25
Wait for inherited-pipe fixture to stop writing before cleanup
loong10k Nov 18, 2026
cb4b111
fix: preserve legacy subprocess API and report late reader failures
loong10k Nov 18, 2026
97e5a73
Merge commit 'df09b251ef8e98f5f855a4e40a687bd29e5b2f04' into feature/…
loong10k Nov 18, 2026
e6e8131
fix: retain HTTP status when agent response encoding is invalid
loong10k Nov 18, 2026
c6d5446
fix: retain bounded writes on legacy subprocess output streams
loong10k Nov 18, 2026
4fb8c73
Require HTTP protocol regressions in OpenCLI platform checks
loong10k Nov 18, 2026
c4a6646
Record exact three-line OpenCLI contract evidence
loong10k Nov 18, 2026
ec541b2
Verify legacy collect against a real loopback OpenCLI Agent
loong10k Nov 18, 2026
ed24945
Prove OpenCLI live evidence rejects missing or empty suites
loong10k Nov 18, 2026
eb56af3
Merge remote-tracking branch 'origin/feature/REQ-20261118-wandl-openc…
loong10k Nov 18, 2026
58f675a
Exercise bounded legacy streams across OpenCLI platforms
loong10k Nov 18, 2026
88d4eab
Verify the real OpenCLI Agent behind local TLS authentication
loong10k Nov 18, 2026
c6dc643
Allowlist default OpenCLI configuration diagnostics
loong10k Nov 18, 2026
0b7091c
Hide OpenCLI request data from default diagnostics
loong10k Nov 18, 2026
ddfa6c8
Correlate OpenCLI reverse WebSocket diagnostics safely
loong10k Nov 18, 2026
6894071
Sanitize OpenCLI HTTP cleanup exceptions
loong10k Nov 18, 2026
1946d9f
Complete OpenCLI provider diagnostic verification
loong10k Nov 18, 2026
bd9a10a
Preserve unchecked OpenCLI subprocess pipe failures
loong10k Nov 18, 2026
75160c6
Avoid redirected file handles in OpenCLI process fixture
loong10k Nov 18, 2026
4fa19df
Guard Windows strict argv and negated option aliases
loong10k Nov 18, 2026
1369aa1
Complete OpenCLI argv launcher and migration review
loong10k Nov 18, 2026
20af24e
Require capability test evidence in OpenCLI contract CI
loong10k Nov 18, 2026
d4d2b35
Exercise the real OpenCLI Browser Bridge on Windows and Linux
loong10k Nov 18, 2026
557ee74
Launch Browser Bridge on hosted Ubuntu and Windows runners
loong10k Nov 18, 2026
a164812
Prepare the active user tab before the Browser Bridge contract
loong10k Nov 18, 2026
070a3f9
Record the verified Browser Bridge cleanup matrix
loong10k Nov 18, 2026
9610a0b
Require each Browser Bridge contract case in live evidence
loong10k Nov 18, 2026
6874340
Allow scheduling slack in the simultaneous-signal fixture
loong10k Nov 18, 2026
360cbc5
Reject valueless options before legacy OpenCLI collect
loong10k Nov 18, 2026
c103ff5
Trace OpenCLI integration requirements to tests and commits
loong10k Nov 18, 2026
4c190cc
Record final hosted OpenCLI candidate reports
loong10k Nov 18, 2026
b1169d2
ci: require all OpenCLI contract trace suites on each platform
loong10k Nov 19, 2026
54a42db
ci: require all traced suites in the OpenCLI JVM report
loong10k Nov 19, 2026
7f4210b
ci: require execution of traced OpenCLI contract methods
loong10k Nov 19, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# The last TSV field intentionally encodes an empty argv token. Do not trim it.
src/test/resources/opencli-contracts/v1/argv.tsv whitespace=-blank-at-eol
12 changes: 12 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,18 @@ jobs:
java-version: '17'
cache: maven

- name: Verify shared contract fixtures and source lock
working-directory: src/test/resources/opencli-contracts/v1
run: sha256sum --strict -c SHA256SUMS

- name: Verify pinned structured help samples
working-directory: src/test/resources/opencli-contracts/v1/structured-help-1.8.8
run: sha256sum --strict -c SHA256SUMS

- name: Verify pinned browser output samples
working-directory: src/test/resources/opencli-contracts/v1/browser-output-1.8.8
run: sha256sum --strict -c SHA256SUMS

- name: Build and verify with JaCoCo coverage
run: ./mvnw -B --no-transfer-progress clean verify

Expand Down
288 changes: 288 additions & 0 deletions .github/workflows/contracts.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,288 @@
name: OpenCLI Contracts

on:
push:
branches:
- 'feature/1.0.x'
- 'feature/2.0.x'
- 'feature/3.0.x'
- 'feature/*-contract-hardening'
- 'feature/REQ-20261118-wandl-opencli-contracts-20'
workflow_dispatch:

permissions:
contents: read

jobs:
specification:
name: OpenSpec strict and evidence-runner tests
runs-on: ubuntu-latest
timeout-minutes: 10
env:
OPENSPEC_TELEMETRY: '0'
DO_NOT_TRACK: '1'
CI: 'true'
steps:
- uses: actions/checkout@v7
- uses: actions/setup-node@v4
with:
node-version: '22'
- name: Verify report runner and shared fixture hashes
run: |
python3 -m unittest discover -s scripts/tests -v
(cd src/test/resources/opencli-contracts/v1 && sha256sum -c SHA256SUMS)
(cd src/test/resources/opencli-contracts/v1/structured-help-1.8.8 && sha256sum --strict -c SHA256SUMS)
(cd src/test/resources/opencli-contracts/v1/browser-output-1.8.8 && sha256sum --strict -c SHA256SUMS)
- name: Install pinned official OpenSpec
run: npm install --prefix "$RUNNER_TEMP/opencli-openspec" --ignore-scripts --no-audit --no-fund @fission-ai/openspec@1.13.1
- name: Validate all proposals and each change with strict mode
shell: bash
run: |
export PATH="$RUNNER_TEMP/opencli-openspec/node_modules/.bin:$PATH"
mkdir -p spec-evidence
openspec --version | tee spec-evidence/version.txt
openspec list --json > spec-evidence/list.json
failed=0
for path in openspec/changes/*; do
[[ -d "$path" && "$(basename "$path")" != archive ]] || continue
change="$(basename "$path")"
if openspec validate "$change" --strict --no-interactive > "spec-evidence/$change.log" 2>&1; then
printf '%s\tPASS\n' "$change"
else
cat "spec-evidence/$change.log"
failed=1
fi
done
if ! openspec validate --all --strict --no-interactive > spec-evidence/all.log 2>&1; then
cat spec-evidence/all.log
failed=1
fi
exit "$failed"
- name: Upload specification evidence
if: always()
uses: actions/upload-artifact@v7
with:
name: openspec-strict-${{ github.sha }}
path: spec-evidence
if-no-files-found: error

jvm:
name: Branch-specific JVM contract verification
runs-on: ubuntu-latest
timeout-minutes: 30
steps:
- uses: actions/checkout@v7
- name: Select declared branch line
id: line
shell: bash
run: |
case "$GITHUB_REF_NAME" in
feature/REQ-20261118-wandl-opencli-contracts-20) echo 'java=17' >> "$GITHUB_OUTPUT" ;;
feature/1.0.x*) echo 'java=8' >> "$GITHUB_OUTPUT" ;;
feature/2.0.x*) echo 'java=17' >> "$GITHUB_OUTPUT" ;;
feature/3.0.x*) echo 'java=21' >> "$GITHUB_OUTPUT" ;;
*) echo 'Unsupported branch line' >&2; exit 1 ;;
esac
- uses: actions/setup-java@v5
with:
distribution: temurin
java-version: ${{ steps.line.outputs.java }}
cache: maven
- name: Record exact source and actual tools
run: |
mkdir -p contract-evidence
git rev-parse HEAD > contract-evidence/head.txt
git archive -o contract-evidence/source.tar HEAD
sha256sum contract-evidence/source.tar > contract-evidence/source.sha256
java -version > contract-evidence/java.txt 2>&1
if ! bash ./mvnw -version > contract-evidence/maven.txt 2>&1; then
cat contract-evidence/maven.txt
exit 1
fi
cat contract-evidence/java.txt contract-evidence/maven.txt
- name: Full clean verify using this branch wrapper
id: verify
shell: bash
run: |
set +e
bash ./mvnw -B --no-transfer-progress clean verify > contract-evidence/maven.log 2>&1
result=$?
printf '%s\n' "$result" > contract-evidence/maven.exit
tail -100 contract-evidence/maven.log
exit "$result"
- name: Require nonempty, non-skipped contract evidence
if: always()
shell: bash
run: |
test -f contract-evidence/maven.exit
python3 scripts/contract_report.py \
--reports target/surefire-reports \
--trace openspec/changes/enforce-opencli-branch-contract-parity/evidence/final-requirement-trace.md \
--head "$(cat contract-evidence/head.txt)" \
--branch "$GITHUB_REF_NAME" \
--java-version-file contract-evidence/java.txt \
--maven-version-file contract-evidence/maven.txt \
--exit-code "$(cat contract-evidence/maven.exit)" \
--suite enumeration=io.github.easy4j.opencli.contract.OpenCliStructuredHelpFixtureTest \
--suite enumeration=io.github.easy4j.opencli.contract.OpenCliHelpParserTest \
--suite enumeration=io.github.easy4j.opencli.capability.OpenCliCapabilityDiscoveryTest \
--suite argv=io.github.easy4j.opencli.capability.OpenCliCapabilityCommandTest \
--suite argv=io.github.easy4j.opencli.contract.OpenCliArgvContractTest \
--suite argv=io.github.easy4j.opencli.contract.OpenCliStructuredArgvContractTest \
--suite process=io.github.easy4j.opencli.contract.OpenCliProcessContractTest \
--suite process=io.github.easy4j.opencli.contract.OpenCliProcessBoundaryTest \
--suite process=io.github.easy4j.opencli.core.support.SubprocessCleanupFaultTest \
--suite process=io.github.easy4j.opencli.core.support.SubprocessCompletionRaceTest \
--suite process=io.github.easy4j.opencli.core.support.SubprocessStreamFailureTest \
--suite process=io.github.easy4j.opencli.core.OpenCliProcessPrivacyTest \
--suite protocol=io.github.easy4j.opencli.center.ws.OpenCliWsReverseAgentSessionTest \
--suite protocol=io.github.easy4j.opencli.center.ws.OpenCliWsCollectRequestsTest \
--suite protocol=io.github.easy4j.opencli.remote.OpenCliRemoteAgentHttpClientTest \
--suite protocol=io.github.easy4j.opencli.contract.OpenCliErrorEnvelopeTest \
--suite typed-result=io.github.easy4j.opencli.contract.OpenCliBrowserResultTest \
--suite typed-result=io.github.easy4j.opencli.contract.OpenCliBrowserEvidenceResultTest \
--suite typed-result=io.github.easy4j.opencli.capability.OpenCliDiagnosticsTest \
--suite argv=io.github.easy4j.opencli.capability.OpenCliInvocationContextTest \
--suite argv=io.github.easy4j.opencli.core.OpenCliArgSupportTest \
--suite process=io.github.easy4j.opencli.core.support.SubprocessExecutionSupportTest \
--suite protocol=io.github.easy4j.opencli.remote.OpenCliArgvToCollectParserFullTest \
--suite typed-result=io.github.easy4j.opencli.core.OpenCliDiagnosticExportTest \
--output contract-evidence/report.json
- name: Upload actual JVM evidence
if: always()
uses: actions/upload-artifact@v7
with:
name: contracts-jdk-${{ steps.line.outputs.java }}-${{ github.sha }}
path: |
contract-evidence
target/surefire-reports
target/site/jacoco
if-no-files-found: error

process-platform:
name: Subprocess contracts (${{ matrix.os }})
if: github.ref_name == 'feature/REQ-20261118-wandl-opencli-contracts-20'
strategy:
fail-fast: false
matrix:
os: [macos-latest, macos-15-intel, windows-latest]
runs-on: ${{ matrix.os }}
timeout-minutes: 15
defaults:
run:
shell: bash
steps:
- uses: actions/checkout@v7
- uses: actions/setup-java@v5
with:
distribution: temurin
java-version: '17'
cache: maven
- uses: actions/setup-python@v7
with:
python-version: '3.13'
- uses: actions/setup-node@v4
if: runner.os == 'Windows'
with:
node-version: '22'
- name: Exercise real subprocess contracts
run: |
mkdir -p platform-evidence
if [[ "$RUNNER_OS" == Windows ]]; then
OPENCLI_CONTRACT_NODE_EXECUTABLE="$(node -p 'process.execPath')"
export OPENCLI_CONTRACT_NODE_EXECUTABLE
fi
java -version > platform-evidence/java.txt 2>&1
mvn -version > platform-evidence/maven.txt 2>&1
result=0
mvn -B --no-transfer-progress \
-Dtest=OpenCliCapabilityDiscoveryTest,OpenCliCapabilityCommandTest,OpenCliErrorEnvelopeTest,OpenCliBrowserResultTest,OpenCliBrowserEvidenceResultTest,OpenCliDiagnosticsTest,OpenCliInvocationContextTest,OpenCliArgvContractTest,OpenCliStructuredArgvContractTest,OpenCliProcessContractTest,OpenCliProcessBoundaryTest,SubprocessCleanupFaultTest,SubprocessCompletionRaceTest,SubprocessStreamFailureTest,OpenCliWsReverseAgentSessionTest,OpenCliWsCollectRequestsTest,OpenCliRemoteAgentHttpClientTest,OpenCliProcessPrivacyTest,OpenCliArgSupportTest#shouldKeepConversionExceptionAndNestedCausePrivate,SubprocessExecutionSupportTest#shouldKeepNativePathOutOfDefaultHandlerException+legacyOutputStreamsAllowBoundedWritesWithoutChangingExecutionDetails,OpenCliStructuredHelpFixtureTest,OpenCliHelpParserTest,OpenCliArgvToCollectParserFullTest,OpenCliDiagnosticExportTest \
test > platform-evidence/maven.log 2>&1 || result=$?
tail -100 platform-evidence/maven.log
python scripts/contract_report.py \
--reports target/surefire-reports \
--trace openspec/changes/enforce-opencli-branch-contract-parity/evidence/final-requirement-trace.md \
--head "$(git rev-parse HEAD)" \
--branch "$GITHUB_REF_NAME" \
--java-version-file platform-evidence/java.txt \
--maven-version-file platform-evidence/maven.txt \
--exit-code "$result" \
--suite enumeration=io.github.easy4j.opencli.contract.OpenCliHelpParserTest \
--suite enumeration=io.github.easy4j.opencli.contract.OpenCliStructuredHelpFixtureTest \
--suite enumeration=io.github.easy4j.opencli.capability.OpenCliCapabilityDiscoveryTest \
--suite argv=io.github.easy4j.opencli.capability.OpenCliCapabilityCommandTest \
--suite argv=io.github.easy4j.opencli.contract.OpenCliArgvContractTest \
--suite argv=io.github.easy4j.opencli.contract.OpenCliStructuredArgvContractTest \
--suite process=io.github.easy4j.opencli.contract.OpenCliProcessContractTest \
--suite process=io.github.easy4j.opencli.contract.OpenCliProcessBoundaryTest \
--suite process=io.github.easy4j.opencli.core.support.SubprocessCleanupFaultTest \
--suite process=io.github.easy4j.opencli.core.support.SubprocessCompletionRaceTest \
--suite process=io.github.easy4j.opencli.core.support.SubprocessStreamFailureTest \
--suite protocol=io.github.easy4j.opencli.remote.OpenCliArgvToCollectParserFullTest \
--suite protocol=io.github.easy4j.opencli.center.ws.OpenCliWsReverseAgentSessionTest \
--suite protocol=io.github.easy4j.opencli.center.ws.OpenCliWsCollectRequestsTest \
--suite protocol=io.github.easy4j.opencli.remote.OpenCliRemoteAgentHttpClientTest \
--suite process=io.github.easy4j.opencli.core.OpenCliProcessPrivacyTest \
--suite argv=io.github.easy4j.opencli.core.OpenCliArgSupportTest \
--suite process=io.github.easy4j.opencli.core.support.SubprocessExecutionSupportTest \
--suite protocol=io.github.easy4j.opencli.contract.OpenCliErrorEnvelopeTest \
--suite typed-result=io.github.easy4j.opencli.core.OpenCliDiagnosticExportTest \
--suite typed-result=io.github.easy4j.opencli.contract.OpenCliBrowserResultTest \
--suite typed-result=io.github.easy4j.opencli.contract.OpenCliBrowserEvidenceResultTest \
--suite typed-result=io.github.easy4j.opencli.capability.OpenCliDiagnosticsTest \
--suite argv=io.github.easy4j.opencli.capability.OpenCliInvocationContextTest \
--output platform-evidence/report.json
exit "$result"
- name: Verify npm-installed OpenCLI on Windows
if: runner.os == 'Windows'
run: bash scripts/run_installed_contracts.sh mvn
- name: Upload platform subprocess evidence
if: always()
uses: actions/upload-artifact@v7
with:
name: subprocess-${{ matrix.os }}-${{ github.sha }}
path: |
platform-evidence
target/surefire-reports
if-no-files-found: error


browser-bridge:
name: Real Browser Bridge (${{ matrix.os }})
if: github.ref_name == 'feature/REQ-20261118-wandl-opencli-contracts-20'
strategy:
fail-fast: false
matrix:
os: [ubuntu-latest, windows-latest]
runs-on: ${{ matrix.os }}
timeout-minutes: 15
defaults:
run:
shell: bash
steps:
- uses: actions/checkout@v7
- uses: actions/setup-java@v5
with:
distribution: temurin
java-version: '17'
cache: maven
- uses: actions/setup-python@v7
with:
python-version: '3.13'
- uses: actions/setup-node@v4
with:
node-version: '24.18.0'
- name: Install the published OpenCLI in the runner's temporary directory
run: npm install --prefix "$RUNNER_TEMP/opencli-browser-cli" --ignore-scripts --no-audit --no-fund @jackwener/opencli@1.8.8
- name: Exercise the real Chrome extension against the loopback daemon
run: |
python scripts/run_browser_bridge_contracts.py \
--cli-entry "$RUNNER_TEMP/opencli-browser-cli/node_modules/@jackwener/opencli/dist/src/main.js" \
--evidence browser-bridge-evidence -- mvn
- name: Upload real Bridge evidence
if: always()
uses: actions/upload-artifact@v7
with:
name: browser-bridge-${{ matrix.os }}-${{ github.sha }}
path: browser-bridge-evidence
if-no-files-found: error
42 changes: 42 additions & 0 deletions .github/workflows/repro-bundle.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
name: Offline contract reproduction bundle
on:
push:
branches: ['feature/2.0.x-contract-hardening', 'feature/REQ-20261118-wandl-opencli-contracts-20']
paths: ['.github/workflows/repro-bundle.yml']
workflow_dispatch:
permissions:
contents: read
jobs:
bundle:
runs-on: ubuntu-latest
timeout-minutes: 15
steps:
- uses: actions/checkout@v7
- uses: actions/setup-java@v5
with:
distribution: temurin
java-version: '17'
cache: maven
- name: Verify baseline and resolve the proposed safe YAML parser
run: |
bash ./mvnw -B --no-transfer-progress clean verify
bash ./mvnw -B --no-transfer-progress org.apache.maven.plugins:maven-dependency-plugin:3.8.1:get -Dartifact=org.yaml:snakeyaml:2.6
- name: Package only public Maven artifacts and distribution
shell: bash
run: |
mkdir -p repro-bundle
git rev-parse HEAD > repro-bundle/source-head.txt
java -version > repro-bundle/java.txt 2>&1
bash ./mvnw -version > repro-bundle/maven.txt 2>&1
# Never include settings.xml, toolchains.xml, Git credentials or environment dumps.
tar -czf repro-bundle/maven-repository.tar.gz -C "$HOME/.m2" repository
distribution="$(find "$HOME/.m2/wrapper/dists" -type d -name apache-maven-3.9.16 -print -quit)"
test -n "$distribution"
tar -czf repro-bundle/maven-distribution.tar.gz -C "$(dirname "$distribution")" apache-maven-3.9.16
(cd repro-bundle && sha256sum ./*.tar.gz > SHA256SUMS)
- uses: actions/upload-artifact@v7
with:
name: opencli-offline-repro-${{ github.sha }}
path: repro-bundle
retention-days: 3
if-no-files-found: error
Loading
Loading