azwi 0.9.1__tar.gz

azwi-0.9.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 John Paul Ellis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

azwi-0.9.1/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: azwi
+Version: 0.9.1
+Summary: Azure DevOps work item fetcher for agentic coding tools
+Author: John Paul Ellis
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# azwi
+
+`azwi` fetches Azure DevOps work item context for agentic coding tools such as Codex CLI and Claude Code.
+
+The tool is designed for deterministic, machine-friendly Markdown or JSON output with clean stdout on success and stderr-only logging.
+
+## Install and run
+
+Local checkout:
+
+```text
+uv run ./azwi.py --help
+uv run ./azwi.py 2195 --org my-org
+```
+
+Packaged command:
+
+```text
+uvx azwi --help
+azwi 2195 --org my-org
+```
+
+## Authentication
+
+`azwi` reads an Azure DevOps PAT from:
+
+- `AZWI_PAT`
+
+Required PAT scopes:
+
+- Work Items: Read
+- Code: Read
+
+The PAT is not stored in `~/.azwi/config.toml`.
+
+## Primary usage
+
+```text
+azwi <work_item_id> [--org ORG] [--section SECTION ...] [--format {markdown,json}]
+```
+
+Examples:
+
+```text
+azwi 2195
+azwi 2195 --section acceptance
+azwi 2195 --section metadata --section comments --comment-limit 20
+azwi 2195 --format markdown
+azwi 2195 --output wi-2195.md
+azwi 2195 --output wi-2195.md --download-images assets
+azwi 2195 --field-acceptance Custom.Acceptance
+azwi 2195 --extra-field Custom.DevNotes
+azwi fields --type Bug --project Payments
+azwi config show
+```
+
+## Commands
+
+Fetch a work item:
+
+```text
+azwi <work_item_id> [options]
+```
+
+List fields for a work item type:
+
+```text
+azwi fields --type Bug [--project PROJECT] [--org ORG]
+```
+
+Manage config:
+
+```text
+azwi config show
+azwi config set-defaults --org my-org --project Payments
+azwi config set-field --global --acceptance Microsoft.VSTS.Common.AcceptanceCriteria
+azwi config set-field --project Payments --description Custom.DevDescription
+azwi config add-extra-field --project Payments Custom.ReleaseNotes
+```
+
+## Output
+
+Default sections:
+
+- metadata
+- description
+- acceptance
+- comments
+- prs
+
+Formats:
+
+- `json`
+- `markdown`
+
+Default format:
+
+- `json`
+
+JSON includes stable top-level `work_item` metadata plus a `sections` object containing rendered Markdown text and source field reference names for text fields. Markdown remains available as an explicit render mode for prompt-friendly output.
+
+## Configuration
+
+`azwi` uses `~/.azwi/config.toml` for non-secret defaults and field mappings.
+
+Supported config layers:
+
+- top-level defaults
+- top-level project overrides
+- org-specific defaults
+- org-specific project overrides
+- per-invocation CLI overrides
+
+Example:
+
+```toml
+[defaults]
+org = "my-org"
+project = "ProjectA"
+
+[defaults.fields]
+description = "System.Description"
+acceptance = "Microsoft.VSTS.Common.AcceptanceCriteria"
+repro_steps = "Microsoft.VSTS.TCM.ReproSteps"
+system_info = "Microsoft.VSTS.TCM.SystemInfo"
+
+[projects."ProjectB".fields]
+acceptance = "Custom.AcceptanceNotes"
+extra_fields = ["Custom.ReleaseNotes"]
+
+[orgs."other-org".defaults]
+project = "ProjectX"
+
+[orgs."other-org".defaults.fields]
+acceptance = "Custom.Acceptance"
+```
+
+`azwi config show` renders the effective resolved config. PATs are never written to the config file.
+
+## Image download behavior
+
+Use `--download-images DIR` together with `--output` to download remote Markdown image URLs and rewrite them to local relative paths.
+
+Relative `DIR` paths resolve from the current working directory, not from the output file location.
+
+## Packaging and publishing
+
+This repo supports both:
+
+- `uv run ./azwi.py ...` via the PEP 723 metadata block in the root wrapper
+- `uvx azwi ...` via the package defined in `pyproject.toml`
+
+Build:
+
+```text
+uv build --no-sources
+```
+
+Release workflow:
+
+- tag a release such as `v0.9.1`
+- GitHub Actions builds the package
+- publish to PyPI using Trusted Publishing
+
+## License
+
+MIT

azwi-0.9.1/README.md

@@ -0,0 +1,167 @@
+# azwi
+
+`azwi` fetches Azure DevOps work item context for agentic coding tools such as Codex CLI and Claude Code.
+
+The tool is designed for deterministic, machine-friendly Markdown or JSON output with clean stdout on success and stderr-only logging.
+
+## Install and run
+
+Local checkout:
+
+```text
+uv run ./azwi.py --help
+uv run ./azwi.py 2195 --org my-org
+```
+
+Packaged command:
+
+```text
+uvx azwi --help
+azwi 2195 --org my-org
+```
+
+## Authentication
+
+`azwi` reads an Azure DevOps PAT from:
+
+- `AZWI_PAT`
+
+Required PAT scopes:
+
+- Work Items: Read
+- Code: Read
+
+The PAT is not stored in `~/.azwi/config.toml`.
+
+## Primary usage
+
+```text
+azwi <work_item_id> [--org ORG] [--section SECTION ...] [--format {markdown,json}]
+```
+
+Examples:
+
+```text
+azwi 2195
+azwi 2195 --section acceptance
+azwi 2195 --section metadata --section comments --comment-limit 20
+azwi 2195 --format markdown
+azwi 2195 --output wi-2195.md
+azwi 2195 --output wi-2195.md --download-images assets
+azwi 2195 --field-acceptance Custom.Acceptance
+azwi 2195 --extra-field Custom.DevNotes
+azwi fields --type Bug --project Payments
+azwi config show
+```
+
+## Commands
+
+Fetch a work item:
+
+```text
+azwi <work_item_id> [options]
+```
+
+List fields for a work item type:
+
+```text
+azwi fields --type Bug [--project PROJECT] [--org ORG]
+```
+
+Manage config:
+
+```text
+azwi config show
+azwi config set-defaults --org my-org --project Payments
+azwi config set-field --global --acceptance Microsoft.VSTS.Common.AcceptanceCriteria
+azwi config set-field --project Payments --description Custom.DevDescription
+azwi config add-extra-field --project Payments Custom.ReleaseNotes
+```
+
+## Output
+
+Default sections:
+
+- metadata
+- description
+- acceptance
+- comments
+- prs
+
+Formats:
+
+- `json`
+- `markdown`
+
+Default format:
+
+- `json`
+
+JSON includes stable top-level `work_item` metadata plus a `sections` object containing rendered Markdown text and source field reference names for text fields. Markdown remains available as an explicit render mode for prompt-friendly output.
+
+## Configuration
+
+`azwi` uses `~/.azwi/config.toml` for non-secret defaults and field mappings.
+
+Supported config layers:
+
+- top-level defaults
+- top-level project overrides
+- org-specific defaults
+- org-specific project overrides
+- per-invocation CLI overrides
+
+Example:
+
+```toml
+[defaults]
+org = "my-org"
+project = "ProjectA"
+
+[defaults.fields]
+description = "System.Description"
+acceptance = "Microsoft.VSTS.Common.AcceptanceCriteria"
+repro_steps = "Microsoft.VSTS.TCM.ReproSteps"
+system_info = "Microsoft.VSTS.TCM.SystemInfo"
+
+[projects."ProjectB".fields]
+acceptance = "Custom.AcceptanceNotes"
+extra_fields = ["Custom.ReleaseNotes"]
+
+[orgs."other-org".defaults]
+project = "ProjectX"
+
+[orgs."other-org".defaults.fields]
+acceptance = "Custom.Acceptance"
+```
+
+`azwi config show` renders the effective resolved config. PATs are never written to the config file.
+
+## Image download behavior
+
+Use `--download-images DIR` together with `--output` to download remote Markdown image URLs and rewrite them to local relative paths.
+
+Relative `DIR` paths resolve from the current working directory, not from the output file location.
+
+## Packaging and publishing
+
+This repo supports both:
+
+- `uv run ./azwi.py ...` via the PEP 723 metadata block in the root wrapper
+- `uvx azwi ...` via the package defined in `pyproject.toml`
+
+Build:
+
+```text
+uv build --no-sources
+```
+
+Release workflow:
+
+- tag a release such as `v0.9.1`
+- GitHub Actions builds the package
+- publish to PyPI using Trusted Publishing
+
+## License
+
+MIT

azwi-0.9.1/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=69"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "azwi"
+version = "0.9.1"
+description = "Azure DevOps work item fetcher for agentic coding tools"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [{ name = "John Paul Ellis" }]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Version Control",
+]
+dependencies = []
+
+[project.scripts]
+azwi = "azwi.cli:main"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]

azwi-0.9.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

azwi-0.9.1/src/azwi/__init__.py

@@ -0,0 +1,3 @@
+__all__ = ["__version__"]
+
+__version__ = "0.9.1"

azwi-0.9.1/src/azwi/__main__.py

@@ -0,0 +1,5 @@
+from azwi.cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())