Compare commits

...
Author SHA1 Message Date
james.maes 5bc3167286 Merge pull request #29 from QRun-IO/develop
fix: release resolved Maven publication POMs
2026-10-20 18:39:47 -05:00
james.maes a2cdd818f6 Merge pull request #28 from QRun-IO/fix/resolved-publication-poms
fix: resolve Maven publication POM coordinates centrally
2026-10-20 18:37:34 -05:00
james.maesandCodex 42e0be02c9 fix: enforce Maven publication gate in orb audit
Co-Authored-By: Codex <noreply@openai.com>
2026-10-20 18:35:53 -05:00
james.maesandCodex b71c9ca4d7 fix: resolve Maven publication POM coordinates centrally
Co-Authored-By: Codex <noreply@openai.com>
2026-10-20 07:50:31 -05:00
james.maes 1a3368e119 Merge pull request #27 from QRun-IO/develop
release: fail closed on GitHub publication errors
2026-10-20 07:39:37 -05:00
james.maes 7dd5f38d35 Merge pull request #26 from QRun-IO/fix/release-failure-reporting
fix: fail CI when GitHub release creation fails
2026-10-20 07:37:25 -05:00
james.maes 1ddba883c9 Merge pull request #25 from QRun-IO/develop
release: central QQQ CI and release workers [minor]
2026-10-20 07:17:29 -05:00
james.maes da8044d6f2 Merge pull request #23 from QRun-IO/develop
release: qqq-orb 0.6.9 (snapshot refresh)
2026-10-14 10:04:52 -05:00
james.maes 67ba48da1f Merge pull request #18 from QRun-IO/develop
release: publish orb 0.6.8 with CircleCI npm OIDC correction
2026-09-29 15:17:00 -05:00
james.maes 5196609974 Merge pull request #16 from QRun-IO/develop
release: publish npm Trusted Publishing support in orb 0.6.7
2026-09-29 14:18:44 -05:00
james.maes 49e09a6776 Merge pull request #14 from QRun-IO/develop
release: publish orb log-safety fix as 0.6.6
2026-09-29 13:38:22 -05:00
james.maes 748016f105 Merge pull request #10 from QRun-IO/develop
[minor] feat: add node_app_* job family
2026-02-27 12:59:51 -06:00
james.maes 6514aaa688 Merge pull request #8 from QRun-IO/develop
fix(ci): remove legacy tag-based publish workflow
2026-01-31 18:46:54 -06:00
james.maes 3ac47adc21 Merge pull request #7 from QRun-IO/develop
Release: auto-publish pipelines and security scanning
2026-01-31 18:40:34 -06:00
7 changed files with 138 additions and 6 deletions

No files matched your search

+13 -2
View File
@@ -22,6 +22,15 @@ main-filters: &main-filters
only: [main]
jobs:
maven-publication-contract:
resource_class: small
docker:
- image: cimg/openjdk:21.0
steps:
- checkout
- run:
name: Verify resolved multi-module publication POMs
command: python3 tests/test_maven_publication_poms.py
pipeline-contract-test:
resource_class: small
docker:
@@ -148,13 +157,15 @@ workflows:
filters: *filters
- pipeline-contract-test:
filters: *filters
- maven-publication-contract:
filters: *filters
# Auto-publish dev snapshot on develop
- publish-dev-snapshot:
context: orb-publishing
filters: *develop-filters
requires: [command-test, pipeline-contract-test]
requires: [command-test, pipeline-contract-test, maven-publication-contract]
# Auto-publish production release on main
- publish-production:
context: orb-publishing
filters: *main-filters
requires: [command-test, pipeline-contract-test]
requires: [command-test, pipeline-contract-test, maven-publication-contract]
+6
View File
@@ -208,3 +208,9 @@ publish-release: check-clean check-branch lint clean dev test-all
echo "Pushing tag to remote..."; \
git push origin "$$version"; \
echo "✅ Production release $$version published successfully!"
.PHONY: test-publication-poms
# Explicit integration gate: requires Java/Maven and public plugin downloads into
# an isolated temporary repository. Never publishes or uses signing credentials.
test-publication-poms:
python3 tests/test_maven_publication_poms.py
+6 -1
View File
@@ -25,4 +25,9 @@ set -e
##############################################
## Deploy signed artifacts to Maven Central ##
##############################################
mvn -s /tmp/circleci/mvn-settings.xml -P release -B -DskipTests -Dgpg.keyname="$GPG_KEYNAME" -Dgpg.passphrase="$GPG_PASSPHRASE" deploy
# Resolve CI-friendly coordinates without stripping parent/BOM configuration.
# Flatten must share this Maven process so deploy uses the resolved project POMs.
mvn -s /tmp/circleci/mvn-settings.xml -P release -B -DskipTests \
-Dgpg.keyname="$GPG_KEYNAME" -Dgpg.passphrase="$GPG_PASSPHRASE" \
-Dflatten.mode=resolveCiFriendliesOnly -DupdatePomFile=true \
org.codehaus.mojo:flatten-maven-plugin:1.7.3:flatten deploy
+1 -1
View File
@@ -177,7 +177,7 @@ class AuditTests(unittest.TestCase):
self.assertEqual('unknown', report['status'])
self.assertNotIn('missing_manifest', [f['code'] for f in report['findings']])
for path, old, new in [('.circleci/config.yml', 'orb-tools/pack', 'disabled-pack'),
('.circleci/test-deploy.yml', 'requires: [command-test, pipeline-contract-test]', 'requires: []'),
('.circleci/test-deploy.yml', 'requires: [command-test, pipeline-contract-test, maven-publication-contract]', 'requires: [command-test, pipeline-contract-test]'),
('.circleci/test-deploy.yml', 'circleci orb validate ', 'echo skipped ')]:
self.assertIn(old, files[path])
changed = dict(files, **{path: files[path].replace(old, new)})
+107
View File
@@ -0,0 +1,107 @@
#!/usr/bin/env python3
"""Real Maven publication contract. Requires Java/Maven; no remote deploy or secrets.
Run explicitly with make test-publication-poms. Public plugins are downloaded to
an isolated temporary local repository; nothing is installed to the user's m2.
"""
import hashlib
from pathlib import Path
import shutil
import subprocess
import tempfile
import xml.etree.ElementTree as ET
ROOT = Path(__file__).resolve().parents[1]
GOAL = 'org.codehaus.mojo:flatten-maven-plugin:1.7.3:flatten'
FLAGS = ['-Dflatten.mode=resolveCiFriendliesOnly', '-DupdatePomFile=true']
NS = {'m': 'http://maven.apache.org/POM/4.0.0'}
def pom(body):
return '<project xmlns="http://maven.apache.org/POM/4.0.0"><modelVersion>4.0.0</modelVersion>' + body + '</project>'
def run_case(base, repository, lifecycle):
project = base / ('bound' if lifecycle else 'plain')
project.mkdir()
group = 'example.bound' if lifecycle else 'example.plain'
flatten = ("<plugin><groupId>org.codehaus.mojo</groupId><artifactId>flatten-maven-plugin</artifactId>"
"<version>1.7.3</version><configuration><updatePomFile>true</updatePomFile>"
"<flattenMode>resolveCiFriendliesOnly</flattenMode></configuration><executions>"
"<execution><id>flatten</id><phase>process-resources</phase><goals><goal>flatten</goal>"
"</goals></execution></executions></plugin>") if lifecycle else ''
(project / 'pom.xml').write_text(pom(f"""
<groupId>{group}</groupId><artifactId>parent</artifactId><version>${{revision}}</version><packaging>pom</packaging>
<name>Publication fixture</name><description>Inherited release metadata</description><url>https://example.invalid/fixture</url>
<licenses><license><name>Fixture license</name><url>https://example.invalid/license</url></license></licenses>
<properties><revision>1.2.3</revision><maven.compiler.release>17</maven.compiler.release></properties>
<modules><module>library</module><module>application</module></modules>
<dependencyManagement><dependencies><dependency><groupId>{group}</groupId><artifactId>library</artifactId>
<version>${{revision}}</version></dependency></dependencies></dependencyManagement>
<build><pluginManagement><plugins><plugin><groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId><version>3.13.0</version><configuration><release>17</release></configuration>
</plugin></plugins></pluginManagement><plugins>{flatten}</plugins></build>
"""), encoding='utf-8')
for artifact in ('library', 'application'):
child = project / artifact
child.mkdir()
dependencies = (f'<dependencies><dependency><groupId>{group}</groupId><artifactId>library</artifactId></dependency></dependencies>'
if artifact == 'application' else '')
(child / 'pom.xml').write_text(pom(f'<parent><groupId>{group}</groupId><artifactId>parent</artifactId>'
'<version>${revision}</version></parent>' + f'<artifactId>{artifact}</artifactId>' + dependencies), encoding='utf-8')
sources = {path: hashlib.sha256(path.read_bytes()).hexdigest() for path in project.rglob('pom.xml')}
settings = base / 'settings.xml'
settings.write_text('<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"/>', encoding='utf-8')
maven = shutil.which('mvn') or shutil.which('mvn.cmd')
if not maven:
raise RuntimeError('Maven is required for this explicit integration gate')
command = [maven, '-B', '-ntp', '-s', str(settings), '-gs', str(settings), '-Dmaven.repo.local=' + str(repository)]
def execute(directory, goals):
subprocess.run(command + goals, cwd=directory, check=True, timeout=600)
execute(project, FLAGS + [GOAL, 'install'])
for path, digest in sources.items():
assert hashlib.sha256(path.read_bytes()).hexdigest() == digest, 'Source POM was rewritten'
installed = repository / group.replace('.', '/')
for artifact in ('parent', 'library', 'application'):
tree = ET.parse(installed / artifact / '1.2.3' / (artifact + '-1.2.3.pom'))
for node in tree.findall('m:version', NS) + tree.findall('m:parent/m:version', NS):
assert node.text == '1.2.3', 'Unresolved deployed coordinate: ' + artifact
parent = ET.parse(installed / 'parent/1.2.3/parent-1.2.3.pom')
assert parent.findtext('m:licenses/m:license/m:name', namespaces=NS) == 'Fixture license'
assert parent.find('m:dependencyManagement', NS) is not None
assert parent.find('m:build/m:pluginManagement', NS) is not None, 'Parent build contract was stripped'
# Remove reactor availability: cold consumer can use only installed artifacts.
hidden = project.with_name(project.name + '-unavailable')
project.rename(hidden)
consumer = base / ('consumer-bound' if lifecycle else 'consumer-plain')
consumer.mkdir()
(consumer / 'pom.xml').write_text(pom(f'<parent><groupId>{group}</groupId><artifactId>parent</artifactId>'
'<version>1.2.3</version><relativePath/></parent><artifactId>cold-consumer</artifactId>'
f'<dependencies><dependency><groupId>{group}</groupId><artifactId>application</artifactId>'
'<version>1.2.3</version></dependency></dependencies>'), encoding='utf-8')
execute(consumer, ['validate', 'org.apache.maven.plugins:maven-help-plugin:3.5.1:effective-pom', '-Doutput=effective.xml',
'org.apache.maven.plugins:maven-dependency-plugin:3.7.1:build-classpath', '-Dmdep.outputFile=classpath.txt'])
effective = ET.parse(consumer / 'effective.xml')
assert effective.findtext('m:licenses/m:license/m:name', namespaces=NS) == 'Fixture license'
managed = effective.find('m:dependencyManagement/m:dependencies/m:dependency', NS)
assert managed.findtext('m:version', namespaces=NS) == '1.2.3'
plugins = effective.findall('m:build/m:pluginManagement/m:plugins/m:plugin', NS)
compiler = next(p for p in plugins if p.findtext('m:artifactId', namespaces=NS) == 'maven-compiler-plugin')
assert compiler.findtext('m:configuration/m:release', namespaces=NS) == '17'
classpath = (consumer / 'classpath.txt').read_text()
assert 'application-1.2.3.jar' in classpath and 'library-1.2.3.jar' in classpath
print('PASS real resolved publication + cold consumer: ' + ('lifecycle-bound' if lifecycle else 'no-existing-flatten'))
def main():
deployment = (ROOT / 'src/scripts/mvn_jar_deploy.sh').read_text()
for flag in FLAGS:
assert flag in deployment, 'Deployment missing tested flatten configuration'
assert GOAL + ' deploy' in deployment, 'Flatten and deploy must share a Maven process'
with tempfile.TemporaryDirectory(prefix='qqq-publication-') as directory:
base = Path(directory)
for lifecycle in (False, True):
run_case(base, base / 'repository', lifecycle)
if __name__ == '__main__': main()
+3
View File
@@ -49,6 +49,9 @@ release
-DskipTests
-Dgpg.keyname=test-key
-Dgpg.passphrase=test-passphrase
-Dflatten.mode=resolveCiFriendliesOnly
-DupdatePomFile=true
org.codehaus.mojo:flatten-maven-plugin:1.7.3:flatten
deploy
EOF
diff -u "$test_dir/expected-args" "$test_dir/mvn-args"
+2 -2
View File
@@ -138,7 +138,7 @@ def owner_gate_errors(snapshot):
if not gates.issubset(set(lint.get('orb-tools/continue', {}).get('requires', []))):
errors.append('continuation must depend on every lint/pack/review/shellcheck gate')
tests = invocations(deploy, 'test-deploy')
required = {'command-test', 'pipeline-contract-test'}
required = {'command-test', 'pipeline-contract-test', 'maven-publication-contract'}
for test in required:
definition = deploy.get('jobs', {}).get(test, {})
if test not in tests or not definition.get('steps') or not any(isinstance(step, dict) and 'run' in step for step in definition['steps']):
@@ -146,7 +146,7 @@ def owner_gate_errors(snapshot):
for name, branch in [('publish-dev-snapshot', 'develop'), ('publish-production', 'main')]:
invocation = tests.get(name, {})
if not required.issubset(set(invocation.get('requires', []))):
errors.append(name + ' must require both test gates')
errors.append(name + ' must require all test gates')
if invocation.get('filters', {}).get('branches', {}).get('only') != [branch]:
errors.append(name + ' branch filter')
commands = []