Release 1.2.0 (2026-02-27)¶
Bug fixes¶
- correct snippets base_path resolution for fragment includes (#33) pymdownx.snippets resolves base_path relative to CWD (not the mkdocs.yml location). The previous paths were relative to docs/site/ which caused fragments to either not resolve or self-include when the wrapper file had the same name as the fragment.
Use CWD-relative paths: fragments/ for the common fragments directory and docs/site/docs/ for local docs includes.
- run mike from repo root and add language libraries page (#34) Remove working-directory from mike deploy step so CWD matches the base_path entries in mkdocs.yml (repo root). This fixes fragment includes not resolving in CI where mike ran from docs/site/.
Replace Language Libraries external links with a dedicated page describing each implementation with links to repos and docs sites.
-
restore 4 missing mapping entries from Python source (#41) The canonical mapping-data.json was missing 4 entries that existed in the original Python mapping data, dropped during the initial extraction:
-
conn.response_key_map: ASTATE, CONN, EXTCONN
-
qstatus.request_key_map: type
-
set docs default version to latest on main deploy The root URL redirect was pointing to dev/ because mike set-default was never called. Add mike set-default latest after deploying from main so the root URL always redirects to the latest release.
-
correct Go package name from mqrest to mqrestadmin (#55) Renamed for parity with the Java namespace.
-
allow commits on release/* branches in library-release model (#56) Update pre-commit hook to match canonical implementation: remove release/ from protected branch block and add release/ to library-release allowed prefixes.
-
add standards-gates CI workflow (#57)
- fix: add standards-gates CI workflow
Add standards-gates.yml workflow that runs the standards-compliance composite action on pull requests. This enforces repo-profile validation, markdownlint, commit message linting, and PR issue linkage checks.
-
correct VERSION file to use semver format (#74) Changes VERSION from '1.1' to '1.1.0' (3-component semver) for prepare_release.py compatibility.
-
update add-to-project action to v1.0.2 (#87)
CI¶
- auto-add issues to GitHub Project (#60)
-
chore: add workflow to auto-add issues to GitHub Project
-
chore: retrigger CI with corrected PR body
-
add CI workflow with docs-only detection and shellcheck (#67) Replace partial standards-gates.yml with full ci.yml matching standard-tooling pattern. Adds docs-only detection, shellcheck gate, push-to-develop trigger, and concurrency groups. Bumps action versions in docs.yml (checkout@v6, setup-python@v6).
Documentation¶
- rewrite sync-pattern fragment to match actual implementation The sync fragment incorrectly described a bulk declarative configuration management system. Replace with the correct concept: synchronous polling wrappers around fire-and-forget START/STOP commands, matching the Python reference implementation.
Fixes wphillipmoore/mq-rest-admin-java#44
-
expand QA guardrails and add quality gates reference Expand the Quality Assurance section in the AI engineering fragment with detailed coverage of test coverage enforcement, static analysis, security scanning, git hooks, and CI gate structure. Add a new quality gates fragment and docs page documenting the complete set of git hooks (pre-commit branch protection, commit-msg validation) and CI pipeline jobs (standards-compliance, dependency-audit, release-gates, test-and-validate, CodeQL, integration-tests).
-
add Trivy and Semgrep to quality gates documentation Update AI engineering and quality gates fragments to reflect the tier 2 security tooling additions (Trivy filesystem vulnerability scanning and Semgrep pattern-based SAST) that were implemented across all language repos as part of issue #11.
-
add Ruby and Rust placeholders to language implementations (#43)
-
update version to 1.1 and link to versioned docs sites Update VERSION from 0.1 to 1.1 for the upcoming release. Change language implementation links in index.md and languages.md to point to version-matched GitHub Pages URLs (/1.1/) instead of GitHub repos (Java, Python, Go). Ruby and Rust remain as GitHub repo links (WIP).
-
draft mq-rest-admin 1.1 multi-language announcement Three-tier announcement (short/medium/micro) for the 1.1 series, covering the expansion from Python-only to Python, Java, and Go with shared mapping data. Highlights upcoming Ruby and Rust ports and encourages requests for additional language coverage.
-
fix inaccurate community feedback claim in announcement Replace fabricated claim about community demand with honest motivation: personal desire for broad modern language coverage.
-
fix incorrect claim about per-language attribute mappings Attribute mappings are language-neutral snake_case across all libraries. Only method names follow language conventions. Clarify the distinction between shared attribute mappings and idiomatic method naming.
-
drop incorrect MQ 9.4 version reference for runCommandJSON The runCommandJSON endpoint was introduced well before MQ 9.4. Remove the version reference rather than guess the correct one.
-
add synchronous start/stop methods to announcement features
-
reword shared architecture claim in announcement Emphasise that implementations share API shape and semantics rather than implying a runtime dependency on the common repository.
-
add LinkedIn-sized medium version of 1.1 announcement (#58)
- docs: add LinkedIn-sized medium version of 1.1 announcement
Rename the existing medium version to long (already posted on IBM TechXchange) and add a new medium version (2,432 chars) that fits within LinkedIn 3,000 character post limit.
- rename mq-dev-environment references to mq-rest-admin-dev-environment (#64) Update fragment references to use the new repository name, aligning with the mq-rest-admin-* naming convention across the project family.
Ref wphillipmoore/mq-dev-environment#14
-
ban MEMORY.md usage in CLAUDE.md (#78) Add auto-memory policy requiring agents to discuss behavioral rules with the human rather than storing them in unmanaged MEMORY.md files.
-
ban heredocs in shell commands (#79) Add explicit ban on heredocs for multi-line CLI arguments. Always use temp files instead.
-
replace stale script references with st-* commands (#101)
- add testing platforms page documenting z/OS coverage gap (#104) Documents why the project does not test against z/OS queue managers and the research into available options. Adds a new Development section page alongside Local MQ Container and Quality Gates.
Features¶
-
add git hooks and lint scripts from canonical standards (#15) Copy pre-commit and commit-msg hooks plus all six lint scripts from the standards-and-conventions repo. Update pre-flight checklist in repository-standards.md with hooks enablement directive.
-
bootstrap MkDocs site and GitHub Pages workflow (#17) Add MkDocs + Material configuration, placeholder index page, GitHub Actions workflow for building and deploying to GitHub Pages, and exclude built site output in .gitignore.
-
add shared documentation fragments, docs site, and mike deployment (#30) Create language-neutral fragments for AI engineering, local MQ container, and all 41 qualifier mappings. Build out the common docs site with include wrappers and full navigation. Switch from static GitHub Pages deployment to mike-based versioned deployment.
-
add category prefixes to job names (#77) Standardize job display names with category prefixes so checks cluster naturally in the GitHub status list.
-
adopt validate_local.sh dispatch architecture (#80)
- feat(validate): adopt validate_local.sh dispatch architecture
Add primary_language: none to repo profile. Sync validate_local.sh driver and language-specific scripts from standard-tooling.
Refactoring¶
- use shared docs-deploy composite action (#70)
- remove docs-only detection and add tier-1 validation scripts (#103) Remove deleted docs-only-detect action reference from CI workflow. Add standard tier-1 scripts (lint.sh, test.sh, audit.sh) to scripts/dev/.