From 61b4020a9609161bf51ab0214bea982b08a2eec1 Mon Sep 17 00:00:00 2001
From: emil <emil@oblachno.fyi>
Date: Mon, 24 Aug 2026 23:29:05 +0200
Subject: [PATCH] docs: expand package docstring with CI module overview

Implements: REQ-1, REQ-2

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
---
 docs/specs/DEVX-156.md | 34 ++++++++++++++++++++++++++++++++++
 src/devx/__init__.py   |  8 +++++++-
 2 files changed, 41 insertions(+), 1 deletion(-)
 create mode 100644 docs/specs/DEVX-156.md

diff --git a/docs/specs/DEVX-156.md b/docs/specs/DEVX-156.md
new file mode 100644
index 0000000..5c34fb2
--- /dev/null
+++ b/docs/specs/DEVX-156.md
@@ -0,0 +1,34 @@
+# DEVX-156: Fix commit message format and release new CI modules
+
+## Problem
+The DEVX-155 merge commit on master has an invalid format
+('DEVX-155: Replace...' missing conventional commit type). This blocks
+the post-merge release workflow's `validate_commit_msg` step, preventing
+`validate_spec`, `check_pr_size`, `nightly_gate`, and `create_dependency_pr`
+from being published to the Gitea PyPI registry. All downstream repos
+(grm, infra, sso-bridge) are blocked — their CI fails with
+`No module named devx.ci.validate_spec`.
+
+## Approach
+Add a trivial user-facing change (version doc comment) with a proper
+conventional commit format to trigger the post-merge release workflow.
+The release will publish the new CI modules that DEVX-155 introduced.
+
+REQ-1: Add a user-facing change to src/devx/ to trigger release
+REQ-2: Ensure the commit message follows conventional format (type: description)
+
+## Test Plan
+- Verify post-merge workflow runs successfully after merge
+- Verify a new release tag is created (v0.51.0 or similar)
+- Verify devx.ci.validate_spec is importable from the published package
+
+## Deploy Plan
+- Merge to master via auto-merge workflow
+- Post-merge workflow auto-releases and publishes
+
+## Rollback Plan
+- Revert the merge commit if release fails
+
+## Acceptance Criteria
+- [x] REQ-1: A user-facing change is added to src/devx/
+- [x] REQ-2: Commit message follows conventional format
diff --git a/src/devx/__init__.py b/src/devx/__init__.py
index c33397e..8ec8f65 100644
--- a/src/devx/__init__.py
+++ b/src/devx/__init__.py
@@ -1,3 +1,9 @@
-"""devx — reusable development and CI/CD tools for oblachno-oss projects."""
+"""devx — reusable development and CI/CD tools for oblachno-oss projects.
+
+Provides CI/CD automation (validate_spec, check_pr_size, nightly_gate,
+create_dependency_pr, auto_merge, release, publish), developer tooling
+(setup, install_tools, configure_repo, create_task, create_pr), and
+molecule testing helpers for Ansible projects.
+"""
 
 __version__ = "0.50.1"