feat(bulletins): add bulletin management module with NiFi 2.7.0+ clearing

New nipyapi.bulletins module:
- get_bulletins(): controller-level bulletins
- get_bulletin_board(): filtered bulletins returning BulletinDTO directly
- clear_*_bulletins(): component-specific clearing (10 functions)
- clear_all_bulletins(): high-level helper for CI

Additional changes:
- nipyapi.profiles: add list_profiles, show, current commands
- nipyapi.utils: add format_timestamp utility
- nipyapi.ci.get_status: fix to capture controller service bulletins
- nipyapi.canvas: bulletin functions now alias to bulletins module
- Makefile: intelligent uv/pip detection
- docs: updated contributing guide, module documentation

Author: Chaffelson

Makefile

@@ -17,6 +17,15 @@ export
 # Defaults to 'python' for conda/venv users, override with PYTHON=python3 for system installs
 PYTHON ?= python
 
+# Package installer: prefer uv if available, fall back to pip
+# Users with uv get faster installs; users without uv work unchanged
+UV := $(shell command -v uv 2>/dev/null)
+ifdef UV
+    PIP := uv pip
+else
+    PIP := pip
+endif
+
 # Profiles file for development/testing (explicitly use examples file, not user's ~/.nipyapi/profiles.yml)
 NIPYAPI_PROFILES_FILE ?= examples/profiles.yml
 
@@ -149,13 +158,13 @@ clean-docker: clean-act ## comprehensive Docker cleanup: act + containers + volu
 	@echo "Comprehensive Docker cleanup complete"
 
 install: clean ## install the package to the active Python's site-packages
-	pip install .
+	$(PIP) install .
 
 dev-install: ## install dev extras for local development
-	pip install -e ".[dev]"
+	$(PIP) install -e ".[dev]"
 
 docs-install: ## install docs extras
-	pip install -e ".[docs]"
+	$(PIP) install -e ".[docs]"
 
 coverage: ensure-certs ## run pytest with coverage and generate report (set coverage-min=NN to enforce; requires infrastructure)
 	@echo "Running coverage analysis (single-user profile)..."
@@ -189,7 +198,7 @@ flake8: ## run flake8 linter on core nipyapi files
 pylint: ## run pylint on core nipyapi files
 	pylint nipyapi/ --rcfile=pylintrc --ignore=nifi,registry,_version.py
 
-pre-commit: ## run pre-commit hooks on all files
+pre-commit: ## run pre-commit hooks on all files (black, isort, flake8, pylint)
 	pre-commit run --all-files
 
 #################################################################################

docs/contributing.rst

@@ -64,17 +64,18 @@ Ready to contribute? Here's how to set up `nipyapi` for local development.
 
     $ git clone git@github.com:Chaffelson/nipyapi.git
 
-3. Create and activate a Python 3.9+ virtual environment (venv or conda), then install dev extras::
+3. Create and activate a Python 3.9+ virtual environment (venv or uv), then install dev extras::
 
     # using venv
     $ python -m venv .venv && source .venv/bin/activate
     $ cd nipyapi/
-    $ pip install -e ".[dev]"
+    $ make dev-install  # uses uv if available, falls back to pip
 
-    # or using conda
-    $ conda create -n nipyapi-dev python=3.11 -y
-    $ conda activate nipyapi-dev
-    $ pip install -e ".[dev]"
+    # or using uv (faster)
+    $ uv venv .venv && source .venv/bin/activate
+    $ make dev-install
+
+   **Note:** The Makefile automatically detects whether ``uv`` is available and uses it for faster installs. If not available, it falls back to ``pip``. Both work seamlessly.
 
 4. Create a branch for local development::
 
@@ -163,7 +164,7 @@ NiPyAPI uses Makefile targets as the primary automation interface. Run ``make he
 **Setup & Installation**
 ::
 
-    make dev-install      # Install package with dev dependencies (recommended)
+    make dev-install      # Install with dev dependencies (uses uv if available, pip otherwise)
     make docs-install     # Install documentation dependencies
     make clean            # Remove build, pyc, and temp artifacts
     make clean-all        # Nuclear clean: removes ALL including generated code
@@ -193,10 +194,16 @@ NiPyAPI uses Makefile targets as the primary automation interface. Run ``make he
     make lint             # Run flake8 + pylint (excludes generated code)
     make flake8           # Run flake8 only
     make pylint           # Run pylint only
-    make pre-commit       # Run pre-commit hooks on all files
+    make pre-commit       # Run pre-commit hooks (black, isort, flake8, pylint)
+
+Pre-commit hooks are the recommended way to ensure code quality before committing. They automatically run formatting and linting checks.
 
-    # Formatting (manual)
-    black nipyapi/ && isort nipyapi/  # Auto-format code
+**Troubleshooting Lint Issues**
+
+* **Import order errors**: Run ``isort nipyapi/`` to auto-fix import ordering
+* **Line length errors**: Break long lines at logical points (operators, commas). Max is 100 chars.
+* **Formatting errors**: Run ``black nipyapi/`` to auto-format, then re-run ``make lint``
+* **Linting generated code**: Always use ``make lint`` which excludes generated code automatically
 
 **Docker Operations**
 ::
@@ -247,8 +254,12 @@ These files are automatically generated from OpenAPI specifications and should n
 
 Focus your contributions on these core modules:
 
+* ``nipyapi/bulletins.py`` - Bulletin retrieval, filtering, and clearing
 * ``nipyapi/canvas.py`` - Canvas management functions
+* ``nipyapi/ci.py`` - CI/CD convenience functions for flow deployment
 * ``nipyapi/config.py`` - Configuration and endpoints
+* ``nipyapi/extensions.py`` - NiFi extensions (NAR) management
+* ``nipyapi/layout.py`` - Canvas layout and component positioning
 * ``nipyapi/parameters.py`` - Parameter context operations
 * ``nipyapi/profiles.py`` - Profile management system
 * ``nipyapi/security.py`` - Authentication and security
@@ -259,6 +270,19 @@ Focus your contributions on these core modules:
 * ``examples/`` - Example scripts and usage patterns
 * ``docs/`` - Documentation (RST files)
 
+**Adding New Core Modules**
+
+When creating a new core module (e.g., ``nipyapi/mymodule.py``):
+
+1. Add the module name to ``nipyapi/__init__.py`` in the ``__all__`` list
+2. Add a description to ``docs/scripts/generate_structured_docs.py`` in ``module_descriptions``
+3. Regenerate documentation with ``make docs`` to create the RST file
+4. Add corresponding tests in ``tests/test_mymodule.py``
+
+The documentation generator auto-detects modules from ``__all__`` but uses ``module_descriptions``
+for human-readable descriptions. Without an entry in ``module_descriptions``, the module will
+still appear in docs but with a generic description.
+
 **Regenerating Clients**
 
 If you need to update the generated clients (e.g., for a new NiFi version):

docs/nipyapi-docs/core_modules.rst

@@ -17,3 +17,5 @@ They wrap the lower-level generated API clients with Pythonic interfaces.
    core_modules/profiles
    core_modules/layout
    core_modules/extensions
+   core_modules/ci
+   core_modules/bulletins

docs/nipyapi-docs/core_modules/bulletins.rst

@@ -0,0 +1,9 @@
+Bulletins
+=========
+
+Bulletin retrieval, filtering, and clearing
+
+.. automodule:: nipyapi.bulletins
+    :members:
+    :undoc-members:
+    :show-inheritance:

docs/nipyapi-docs/core_modules/ci.rst

@@ -0,0 +1,9 @@
+Ci
+==
+
+CI/CD convenience functions for flow deployment
+
+.. automodule:: nipyapi.ci
+    :members:
+    :undoc-members:
+    :show-inheritance:

docs/nipyapi-docs/core_modules/extensions.rst

@@ -1,7 +1,7 @@
 Extensions
 ==========
 
-Extensions functionality
+NiFi extensions (NAR) management
 
 .. automodule:: nipyapi.extensions
     :members:

docs/nipyapi-docs/core_modules/layout.rst

@@ -1,7 +1,7 @@
 Layout
 ======
 
-Layout functionality
+Canvas layout and component positioning
 
 .. automodule:: nipyapi.layout
     :members:

docs/nipyapi-docs/core_modules/profiles.rst

@@ -1,7 +1,7 @@
 Profiles
 ========
 
-Profiles functionality
+Profile management for multi-environment configurations
 
 .. automodule:: nipyapi.profiles
     :members:

docs/nipyapi-docs/nifi_models/models.rst

@@ -3,7 +3,7 @@ NiFi Models
 
 Complete model class reference for NiFi APIs.
 
-This reference documents all **394** model classes used by NiFi APIs. These classes are automatically cross-referenced from API documentation - click any model type in API documentation to jump directly to its definition here.
+This reference documents all **403** model classes used by NiFi APIs. These classes are automatically cross-referenced from API documentation - click any model type in API documentation to jump directly to its definition here.
 
 Model Type Patterns
 --------------------
@@ -166,6 +166,22 @@ All Model Classes
    :members:
    :show-inheritance:
 
+.. autoclass:: ClearBulletinsForGroupRequestEntity
+   :members:
+   :show-inheritance:
+
+.. autoclass:: ClearBulletinsForGroupResultsEntity
+   :members:
+   :show-inheritance:
+
+.. autoclass:: ClearBulletinsRequestEntity
+   :members:
+   :show-inheritance:
+
+.. autoclass:: ClearBulletinsResultEntity
+   :members:
+   :show-inheritance:
+
 .. autoclass:: ClientIdParameter
    :members:
    :show-inheritance:
@@ -586,6 +602,10 @@ All Model Classes
    :members:
    :show-inheritance:
 
+.. autoclass:: FlowRegistryClientDefinition
+   :members:
+   :show-inheritance:
+
 .. autoclass:: FlowRegistryClientEntity
    :members:
    :show-inheritance:
@@ -682,6 +702,14 @@ All Model Classes
    :members:
    :show-inheritance:
 
+.. autoclass:: ListenPortDTO
+   :members:
+   :show-inheritance:
+
+.. autoclass:: ListenPortsEntity
+   :members:
+   :show-inheritance:
+
 .. autoclass:: ListingRequestDTO
    :members:
    :show-inheritance:
@@ -1122,6 +1150,10 @@ All Model Classes
    :members:
    :show-inheritance:
 
+.. autoclass:: PropertyListenPortDefinition
+   :members:
+   :show-inheritance:
+
 .. autoclass:: PropertyResourceDefinition
    :members:
    :show-inheritance:
@@ -1546,6 +1578,10 @@ All Model Classes
    :members:
    :show-inheritance:
 
+.. autoclass:: VersionedListenPortDefinition
+   :members:
+   :show-inheritance:
+
 .. autoclass:: VersionedParameter
    :members:
    :show-inheritance:

docs/nipyapi-docs/registry_models/models.rst

@@ -3,7 +3,7 @@ Registry Models
 
 Complete model class reference for Registry APIs.
 
-This reference documents all **85** model classes used by Registry APIs. These classes are automatically cross-referenced from API documentation - click any model type in API documentation to jump directly to its definition here.
+This reference documents all **87** model classes used by Registry APIs. These classes are automatically cross-referenced from API documentation - click any model type in API documentation to jump directly to its definition here.
 
 Model Type Patterns
 --------------------
@@ -186,6 +186,10 @@ All Model Classes
    :members:
    :show-inheritance:
 
+.. autoclass:: ListenPortDefinition
+   :members:
+   :show-inheritance:
+
 .. autoclass:: LongParameter
    :members:
    :show-inheritance:
@@ -326,6 +330,10 @@ All Model Classes
    :members:
    :show-inheritance:
 
+.. autoclass:: VersionedListenPortDefinition
+   :members:
+   :show-inheritance:
+
 .. autoclass:: VersionedParameter
    :members:
    :show-inheritance: