heinzel-example 0.4.0__tar.gz

heinzel_example-0.4.0/.gitignore

@@ -0,0 +1,15 @@
+.venv/
+.tools/
+__pycache__/
+.pytest_cache/
+.mypy_cache/
+.pyright/
+.coverage*
+htmlcov/
+node_modules/
+dist/
+release-dist/
+*.egg-info/
+.acceptance/
+.preview/
+.candidates/

heinzel_example-0.4.0/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.4.0
+
+Move this plugin to its independent repository project for the Heinzel 0.9 plugin contract.
+Own its dependencies, tests and artifacts; consume public contracts without concrete provider dependencies.
+
+Earlier history is preserved in the source repository named in README.md.

heinzel_example-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Helmut Hoffer von Ankershoffen
+
+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.

heinzel_example-0.4.0/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.5
+Name: heinzel-example
+Version: 0.4.0
+Summary: Show how a Heinzelmännchen plugin is built.
+Project-URL: Source, https://github.com/helmut-hoffer-von-ankershoffen/heinzel-plugins/tree/main/plugins/heinzel-example
+Project-URL: Changelog, https://github.com/helmut-hoffer-von-ankershoffen/heinzel-plugins/blob/main/plugins/heinzel-example/CHANGELOG.md
+Project-URL: Issues, https://github.com/helmut-hoffer-von-ankershoffen/heinzel-plugins/issues
+Author-email: Helmut Hoffer von Ankershoffen <helmuthva@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: heinzel,heinzel-plugin,heinzelmaennchen
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: heinzel<0.10,>=0.9.1
+Description-Content-Type: text/markdown
+
+# heinzel-example
+
+Show how a Heinzelmännchen plugin is built: one module with an operation, settings, a health check and a submodule.
+
+A plugin for [Heinzelmännchen](https://github.com/helmut-hoffer-von-ankershoffen/heinzel), the open-source, AI-driven
+operating system for product development teams. It lives in
+[heinzel-plugins](https://github.com/helmut-hoffer-von-ankershoffen/heinzel-plugins). Its earlier history is preserved
+in heinzel-contrib and the archived heinzel-example repository.
+
+## Install
+
+With Heinzelmännchen installed (`uv tool install git+https://github.com/helmut-hoffer-von-ankershoffen/heinzel`):
+
+```bash
+hz system plugin add "heinzel-example @ git+https://github.com/helmut-hoffer-von-ankershoffen/heinzel-plugins#subdirectory=plugins/heinzel-example"
+```
+
+Running `hz system plugin add` again upgrades; `hz system plugin remove heinzel-example` removes it.
+
+## Use
+
+```bash
+hz example info                 # this plugin, its version and the Heinzelmännchen it runs on
+hz example hello --name Ada     # a submodule collapsed into a command
+hz example info --json          # every command speaks JSON, for scripts and agents
+hz system info                  # includes a section contributed by this plugin
+```
+
+## Develop
+
+From the repository root: `make check-fast NAME=example` runs this plugin's edit loop; `make check NAME=example`
+runs its full checks. `make build NAME=example` and `make acceptance NAME=example` verify its installed artifact.
+The modules live in
+`src/heinzel_example/`; read the root [AGENTS.md](../../AGENTS.md) before changing them.
+
+Development and release commands: [repository guide](../../README.md).
+
+Migration provenance: heinzel-contrib, before the 0.9 plugin-boundary migration.

heinzel_example-0.4.0/README.md

@@ -0,0 +1,38 @@
+# heinzel-example
+
+Show how a Heinzelmännchen plugin is built: one module with an operation, settings, a health check and a submodule.
+
+A plugin for [Heinzelmännchen](https://github.com/helmut-hoffer-von-ankershoffen/heinzel), the open-source, AI-driven
+operating system for product development teams. It lives in
+[heinzel-plugins](https://github.com/helmut-hoffer-von-ankershoffen/heinzel-plugins). Its earlier history is preserved
+in heinzel-contrib and the archived heinzel-example repository.
+
+## Install
+
+With Heinzelmännchen installed (`uv tool install git+https://github.com/helmut-hoffer-von-ankershoffen/heinzel`):
+
+```bash
+hz system plugin add "heinzel-example @ git+https://github.com/helmut-hoffer-von-ankershoffen/heinzel-plugins#subdirectory=plugins/heinzel-example"
+```
+
+Running `hz system plugin add` again upgrades; `hz system plugin remove heinzel-example` removes it.
+
+## Use
+
+```bash
+hz example info                 # this plugin, its version and the Heinzelmännchen it runs on
+hz example hello --name Ada     # a submodule collapsed into a command
+hz example info --json          # every command speaks JSON, for scripts and agents
+hz system info                  # includes a section contributed by this plugin
+```
+
+## Develop
+
+From the repository root: `make check-fast NAME=example` runs this plugin's edit loop; `make check NAME=example`
+runs its full checks. `make build NAME=example` and `make acceptance NAME=example` verify its installed artifact.
+The modules live in
+`src/heinzel_example/`; read the root [AGENTS.md](../../AGENTS.md) before changing them.
+
+Development and release commands: [repository guide](../../README.md).
+
+Migration provenance: heinzel-contrib, before the 0.9 plugin-boundary migration.

heinzel_example-0.4.0/plugin-lock.json

@@ -0,0 +1,40 @@
+{
+  "format": 1,
+  "sdk": 1,
+  "inputs": [
+    "coverage>=7.12",
+    "editables>=0.5",
+    "hatchling>=1.29.0",
+    "heinzel>=0.9.1,<0.10",
+    "mypy>=1.19.0,<3",
+    "pyright[nodejs]==1.1.414",
+    "pytest-timeout>=2.4.0,<3",
+    "pytest-xdist>=3.8",
+    "pytest>=9.0.3,<10",
+    "ruff==0.17.2"
+  ],
+  "core": {
+    "version": "0.9.1",
+    "dependencies": [
+      "croniter>=6.2.4",
+      "fastapi>=0.161",
+      "keyring>=25.6",
+      "mcp>=2.3",
+      "packaging>=25.0",
+      "platformdirs>=4.5",
+      "pluggy<2,>=1.6.0",
+      "psutil==7.2.2",
+      "pydantic-ai-slim==2.61.0",
+      "pydantic-ai-slim[anthropic]==2.61.0; extra == \"anthropic\"",
+      "pydantic-ai-slim[openai]==2.61.0; extra == \"openai\"",
+      "pydantic-settings<3,>=2.11.0",
+      "pydantic<3,>=2.12.0",
+      "pyyaml<7,>=6.0.2",
+      "rich>=14.2.0",
+      "tomlkit>=0.13",
+      "typer>=0.23.0",
+      "uvicorn>=0.54",
+      "wsproto>=1.3"
+    ]
+  }
+}

heinzel_example-0.4.0/pyproject.toml

@@ -0,0 +1,143 @@
+[project]
+name = "heinzel-example"
+version = "0.4.0"
+description = "Show how a Heinzelmännchen plugin is built."
+readme = "README.md"
+authors = [{ name = "Helmut Hoffer von Ankershoffen", email = "helmuthva@gmail.com" }]
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+keywords = ["heinzel", "heinzel-plugin", "heinzelmaennchen"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Typing :: Typed",
+]
+# Heinzelmännchen resolves to the installed Heinzelmännchen when the plugin is added with `hz system plugin add`.
+dependencies = ["heinzel>=0.9.1,<0.10"]
+
+[project.entry-points."heinzel.modules"]
+example = "heinzel_example"
+
+[project.urls]
+Source = "https://github.com/helmut-hoffer-von-ankershoffen/heinzel-plugins/tree/main/plugins/heinzel-example"
+Changelog = "https://github.com/helmut-hoffer-von-ankershoffen/heinzel-plugins/blob/main/plugins/heinzel-example/CHANGELOG.md"
+Issues = "https://github.com/helmut-hoffer-von-ankershoffen/heinzel-plugins/issues"
+
+[build-system]
+requires = ["hatchling>=1.29.0"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/heinzel_example"]
+
+[tool.ruff]
+line-length = 120
+fix = true
+extend-exclude = ["template"] # rendered and checked by `make template-test`
+
+[tool.ruff.lint]
+select = ["ALL"]
+# pydoclint (DOC): docstring sections must match what the code raises, returns and yields. Preview rules, opted into
+# one by one so no other preview rule sneaks in.
+preview = true
+explicit-preview-rules = true
+extend-select = ["DOC201", "DOC202", "DOC402", "DOC403", "DOC501", "DOC502"]
+ignore = [
+    "COM812",  # conflicts with the ruff formatter
+    "CPY001",  # no copyright header in OSS files
+    "D203",    # incompatible with D211
+    "DOC201",  # a return value is documented by the type and the summary line; Returns: only when it adds meaning
+    "DOC502",  # documenting exceptions raised by callees is useful for callers
+    "D213",    # incompatible with D212
+    "FBT001",  # boolean positional arguments are idiomatic for Typer options
+    "FBT002",  # same as FBT001
+    "ISC001",  # conflicts with the ruff formatter
+    "TD003",   # todos don't need an issue link
+    "FIX002",  # todos are allowed
+]
+
+[tool.ruff.lint.per-file-ignores]
+".claude/hooks/*.py" = [
+    "D103",    # hook entry points are documented by the module docstring
+    "INP001",  # hooks are scripts, not a package
+    "S603",    # subprocess calls with fixed argument lists
+    "S607",    # tools (uv, git, make) are resolved from PATH on purpose
+    "T201",    # hooks talk to the agent through stdout/stderr
+]
+"fuzz/*.py" = [
+    "INP001",  # fuzz targets are scripts, not a package
+]
+"hatch_build.py" = [
+    "INP001",  # the build hook hatch loads by path, not a package
+]
+"scripts/*.py" = [
+    "INP001",  # scripts are not a package
+    "T201",    # scripts report on stdout/stderr
+]
+"**/tests/**/*.py" = [
+    "ANN",     # fixtures and tests don't need full annotations
+    "DOC",     # test docstrings describe behaviour, not interfaces
+    "ARG",     # fixtures are used for their side effects
+    "D",       # test names are the documentation
+    "INP001",  # tests are not a package
+    "PLC0415", # local imports keep fixtures isolated
+    "PLR2004", # magic values are fine in assertions
+    "S101",    # asserts are what tests do
+    "S105",    # fake tokens and passwords are test data (credentials, adapters for tracker and document services)
+    "S106",    # same as S105, passed as arguments
+    "S603",    # subprocess calls with trusted input
+    "S607",    # partial executable paths (uv, hz) are resolved from PATH on purpose
+    "SLF001",  # private access is needed for solitary unit tests
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.mypy]
+strict = true
+mypy_path = ["src"]
+files = ["src"]
+plugins = ["pydantic.mypy"]
+
+[tool.pydantic-mypy]
+init_forbid_extra = true
+init_typed = true
+warn_required_dynamic_aliases = true
+
+[tool.pytest]
+minversion = "9.0"
+strict = true
+testpaths = ["tests"]
+addopts = ["-ra", "--import-mode=importlib"]
+filterwarnings = ["error"]
+markers = ["unit: Offline isolated behavior.", "integration: Offline public-contract integration.", "e2e: Installed artifacts or real external services.", "perf: Explicit timing tests.", "long_running: Extended end-to-end budget."]
+
+[tool.heinzel.plugin]
+profiles = []
+requires = ["core:plugin-api@1"]
+provides = []
+
+[tool.coverage.run]
+source = ["heinzel_example"]
+branch = true
+
+[tool.coverage.report]
+fail_under = 90
+show_missing = true
+[dependency-groups]
+test = ["editables>=0.5", "pytest>=9.0.3,<10", "pytest-timeout>=2.4.0,<3", "pytest-xdist>=3.8", "ruff==0.17.2", "mypy>=1.19.0,<3", "coverage>=7.12", "pyright[nodejs]==1.1.414"]
+
+[tool.pyright]
+typeCheckingMode = "strict"
+include = ["src"]
+pythonVersion = "3.12"
+
+[tool.hatch.build.targets.sdist]
+exclude = [".venv", ".acceptance", ".preview", "dist", "web/node_modules", "**/__pycache__", ".pytest_cache", ".mypy_cache", ".coverage*"]