heinzel-example 0.4.0__tar.gz → 0.5.2__tar.gz

heinzel_example-0.5.2/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## 0.5.2
+
+Relock opentelemetry-api to 1.45.2 (CVE-2026-126360).
+
+## 0.5.1
+
+Relock for Heinzel Core 0.9.40 (its AI extra adds pyjwt) and refresh the gallery.
+
+## 0.5.0
+
+Add a footer icon that opens an Example pane showing the value 42 big, the same value as the Today widget. The README
+explains how a plugin contributes a footer pane.
+
+## 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: the heinzel repository before 0.9.

heinzel_example-0.5.2/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.5
+Name: heinzel-example
+Version: 0.5.2
+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).
+
+## Install
+
+Start Heinzelmännchen with `uvx heinzel@latest`. In another terminal, add this plugin:
+
+```sh
+hz system plugin add example --confirm
+```
+
+`hz system update` updates the app and its plugins; `hz system plugin remove heinzel-example` removes this one.
+
+## 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.
+
+## Footer pane
+
+The example is also the teaching example for a footer icon that opens a pane. Three contributions in
+`src/heinzel_example/__init__.py` do it, with no core change:
+
+- `@module.status(source="sample", slots={"footer": True, "sidebar": True})` returns a `StatusItem` with an `icon`, a
+  `detail` line (the tooltip, "Example") and `effect=Navigate(path="/?panel=example:inspector")`, the click target.
+- `module.view(..., name="inspector", title="Example", source="sample")` is the pane that target opens; its
+  `views/index.js` shows the value (42, the same `sample` operation as the Today widget) big. A pane is content, then a
+  divider and a bottom action row only when it has actions; this one has none.
+- `tests/contributions_test.py` asserts the slots, icon, tooltip, target and view.
+
+Development and release commands: [repository guide](../../README.md).
+
+
+<!-- screenshots:start -->
+## Screenshots
+
+<img src="docs/assets/screenshots/widget-and-status.png" alt="Demo data: the constant 42 appears in both the Today widget and sidebar status." width="960">
+
+Demo data: the constant 42 appears in both the Today widget and sidebar status.
+
+<img src="docs/assets/screenshots/inspector.png" alt="Demo data: open the plugin-owned inspector to see the same constant value, 42." width="960">
+
+Demo data: open the plugin-owned inspector to see the same constant value, 42.
+
+<img src="docs/assets/screenshots/greeting-terminal.png" alt="Demo data: greet fictional Mira with structured JSON in the app&#x27;s native terminal." width="960">
+
+Demo data: greet fictional Mira with structured JSON in the app&#x27;s native terminal.
+
+<img src="docs/assets/screenshots/plugin-notice.png" alt="Demo data: a seeded Example is ready notice appears in the shared in-app notification panel." width="960">
+
+Demo data: a seeded Example is ready notice appears in the shared in-app notification panel.
+
+<details>
+<summary>Command line</summary>
+
+<img src="docs/assets/screenshots/greeting-cli.png" alt="Demo data: the typed hello operation greets fictional Mira from the CLI." width="960">
+
+Demo data: the typed hello operation greets fictional Mira from the CLI.
+
+<img src="docs/assets/screenshots/sample-json.png" alt="Demo data: sample returns 42 as JSON, the same constant used by the widget, status and inspector." width="960">
+
+Demo data: sample returns 42 as JSON, the same constant used by the widget, status and inspector.
+
+</details>
+
+[Open the screenshot gallery](docs/assets/screenshots/index.html).
+<!-- screenshots:end -->

heinzel_example-0.5.2/README.md

@@ -0,0 +1,83 @@
+# 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).
+
+## Install
+
+Start Heinzelmännchen with `uvx heinzel@latest`. In another terminal, add this plugin:
+
+```sh
+hz system plugin add example --confirm
+```
+
+`hz system update` updates the app and its plugins; `hz system plugin remove heinzel-example` removes this one.
+
+## 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.
+
+## Footer pane
+
+The example is also the teaching example for a footer icon that opens a pane. Three contributions in
+`src/heinzel_example/__init__.py` do it, with no core change:
+
+- `@module.status(source="sample", slots={"footer": True, "sidebar": True})` returns a `StatusItem` with an `icon`, a
+  `detail` line (the tooltip, "Example") and `effect=Navigate(path="/?panel=example:inspector")`, the click target.
+- `module.view(..., name="inspector", title="Example", source="sample")` is the pane that target opens; its
+  `views/index.js` shows the value (42, the same `sample` operation as the Today widget) big. A pane is content, then a
+  divider and a bottom action row only when it has actions; this one has none.
+- `tests/contributions_test.py` asserts the slots, icon, tooltip, target and view.
+
+Development and release commands: [repository guide](../../README.md).
+
+
+<!-- screenshots:start -->
+## Screenshots
+
+<img src="docs/assets/screenshots/widget-and-status.png" alt="Demo data: the constant 42 appears in both the Today widget and sidebar status." width="960">
+
+Demo data: the constant 42 appears in both the Today widget and sidebar status.
+
+<img src="docs/assets/screenshots/inspector.png" alt="Demo data: open the plugin-owned inspector to see the same constant value, 42." width="960">
+
+Demo data: open the plugin-owned inspector to see the same constant value, 42.
+
+<img src="docs/assets/screenshots/greeting-terminal.png" alt="Demo data: greet fictional Mira with structured JSON in the app&#x27;s native terminal." width="960">
+
+Demo data: greet fictional Mira with structured JSON in the app&#x27;s native terminal.
+
+<img src="docs/assets/screenshots/plugin-notice.png" alt="Demo data: a seeded Example is ready notice appears in the shared in-app notification panel." width="960">
+
+Demo data: a seeded Example is ready notice appears in the shared in-app notification panel.
+
+<details>
+<summary>Command line</summary>
+
+<img src="docs/assets/screenshots/greeting-cli.png" alt="Demo data: the typed hello operation greets fictional Mira from the CLI." width="960">
+
+Demo data: the typed hello operation greets fictional Mira from the CLI.
+
+<img src="docs/assets/screenshots/sample-json.png" alt="Demo data: sample returns 42 as JSON, the same constant used by the widget, status and inspector." width="960">
+
+Demo data: sample returns 42 as JSON, the same constant used by the widget, status and inspector.
+
+</details>
+
+[Open the screenshot gallery](docs/assets/screenshots/index.html).
+<!-- screenshots:end -->

heinzel_example-0.5.2/docs/SCREENSHOTS.md

@@ -0,0 +1,10 @@
+# Screenshot gallery
+
+From the collection root, run `make screenshots NAME=heinzel-example OPEN=1`.
+Review the [contact sheet](assets/screenshots/index.html) before committing.
+The [scene plan](screenshots.toml) describes the real UI and CLI captures.
+`make screenshots-check NAME=heinzel-example` verifies freshness offline.
+
+Captures use a temporary fictional profile without connected accounts. The generated
+[manifest](assets/screenshots/capture.json) records the SDK version and input/image digests.
+See the [author guide](../../../docs/SCREENSHOT_AUTHORING.md) for human and agent commands.

heinzel_example-0.5.2/docs/SCREENSHOT_STORY.md

@@ -0,0 +1,43 @@
+## Audience
+
+Plugin authors evaluating a small, working reference for Heinzelmännchen extensions.
+
+## Outcome
+
+See one value move from an operation into the Today widget, sidebar status, and an inspector pane; then see a typed greeting and a seeded notification. The examples show integration points to explore, not a production business workflow.
+
+## Scenes
+
+1. **Widget and status, light:** The Today widget and sidebar both show the sample value, 42. `src/heinzel_example/__init__.py` declares `sample`, `@module.widget(source="sample")`, and `@module.status(source="sample", slots={"footer": True, "sidebar": True})`.
+2. **Inspector, dark:** The real Example pane displays 42. `module.nav`, `module.action`, and the status effect navigate to `/?panel=example:inspector`; `module.view(..., name="inspector", source="sample")` owns that pane, rendered by `src/heinzel_example/views/index.js`.
+3. **Greeting in the app terminal:** Run the fictional Mira greeting with JSON output. This is a native terminal result, not a feature UI. `src/heinzel_example/hello/__init__.py` declares the collapsed `hello` operation; `_service.py` constructs the greeting.
+4. **Notification:** Open the shared notification panel to see the seeded “Example is ready” notice. The `notify` operation in `src/heinzel_example/__init__.py` emits it; `docs/screenshot_fixture.py` seeds it in the isolated capture profile.
+5. **Greeting CLI:** Show the same fictional greeting as a direct CLI result.
+6. **Sample JSON CLI:** Show the source value as structured output, connecting the CLI to the widget and inspector.
+
+## Fictional fixtures and presentation
+
+Use the existing `docs/screenshot_fixture.py` bootstrap and its isolated profile; do not create fixture files. Mira is fictional, and 42 is the actual constant returned by `sample`. The notice is seeded demonstration data. Captions identify demo data.
+
+Normal presentation fictionalization is explicitly limited to verified owning-interpreter paths becoming `/demo-profile/.venv`, and only the verified whole hostname detail in the genuine Doctor row becoming `demo-host`. These mappings change no SDK health status or remaining detail and establish no privacy acceptance. Unknown identities still fail, and independent review must inspect every image and transcript.
+
+## Privacy pitfalls
+
+The bootstrap disables native, Doctor, and release notifications and invokes the plugin notice in an isolated profile; it does not by itself prove that captures contain no personal information. Inspect paths, hostnames, account names, notifications, timestamps, terminal output, and other incidental content. Do not conceal unknown identities with assumed substitutions.
+
+## Source-bound UI surface inventory
+
+- **Plugin entrypoint:** `pyproject.toml` declares `heinzel.modules` entry `example = "heinzel_example"`. `src/heinzel_example/__init__.py` declares the root `Module("example", ...)`; `src/heinzel_example/hello/__init__.py` declares the discovered `Module("hello", ...)` submodule.
+- **Genuine feature UI:** The Core-rendered Today metric and footer/sidebar status come from the widget and status declarations. The plugin-owned inspector is a real view at the declared panel target, implemented in `src/heinzel_example/views/index.js`. Its loading state and value are rendered using SDK React; it declares no action row. The same actual value across these surfaces is intentional, but the overview and inspector must remain visually and functionally distinct captures.
+- **Other Core-rendered contributions:** `module.action` and `module.nav` open the inspector. `notify` contributes a plugin notice to the shared notification UI. `module.settings(ExampleSettings)` registers the `greeting` setting in `src/heinzel_example/_models.py`; `@module.info` contributes details to system info. The non-read-only `notify` operation declares an ordinary confirmation. These declarations can give rise to generic Core surfaces, but their precise layouts are not supplied here and must not be invented. No channel or setup contribution is declared in the supplied entrypoints.
+- **Operations and terminal:** Root operations are `info`, `sample`, and `notify`; the hello submodule declares `hello`. CLI output is genuine terminal output, including when displayed in the app terminal, and is not evidence of a feature UI. `README.md` documents `hz example hello`, `hz example info`, JSON output, and system info; the source also declares `sample` and `notify`.
+- **External provider UI:** None is declared in the supplied plugin source. No external provider screen is needed for this story.
+- **Unresolved evidence:** `README.md` describes a health check, but the supplied module declarations contain no explicit health-check contribution; do not invent one. The README also references `tests/contributions_test.py`, which is not among the supplied files. Core implementation and the screenshot author guide are not supplied, so generic surface details and capture behavior require observation during explicit capture. The existing plan is preserved because it already covers two real feature UI scenes, a notice, and useful CLI results.
+
+## Acceptance criteria
+
+- Capture all six planned scenes from the real app or CLI with the existing bootstrap, and confirm the light overview and dark inspector have their requested appearances applied.
+- Verify the overview and inspector each show the actual sample value and are distinct views, not duplicates or caption-only variants. Verify the notification is present and the greeting and sample commands produce useful results.
+- Treat terminal scenes as terminal results; do not substitute terminal output for feature UI or forge HTML. Do not invent routes or screens.
+- Independently inspect every image and transcript for privacy and truthfulness, including the narrowly defined presentation mappings above. Unknown identities fail review.
+- Confirm the plan against the actual capture tooling at capture time. Its TOML structure has been checked against the supplied field rules by inspection; no parser, plugin code, capture, or network call was run.

heinzel_example-0.5.2/docs/assets/screenshots/capture.json

@@ -0,0 +1,102 @@
+{
+  "format": 1,
+  "plugin": "heinzel-example",
+  "core_version": "0.9.40",
+  "inputs_sha256": "855bf3b5a71afd5ca72803e6de2a0920cdb229a90cd1dd6297525b336f353f47",
+  "images": {
+    "docs/assets/screenshots/widget-and-status.png": "b9a98431c74dde61577a3c1061a3e1e0cf8c47cb7775d83b9685eaca515fd44a",
+    "docs/assets/screenshots/inspector.png": "0e1cd838c95633fe133ba2f4ed40ff8cb28b1a032bf451b33a41776ac5b07b61",
+    "docs/assets/screenshots/greeting-terminal.png": "d5d87d85f04dca0d2b4cab6ea7d01b0d321060826f76bb690ca08b48e7e56755",
+    "docs/assets/screenshots/plugin-notice.png": "9c5ed76532219e97d3e7780576487967609416804cd9becc61f8ac4805c762d3",
+    "docs/assets/screenshots/greeting-cli.png": "375b8962cc5c7c30ab9c63248ea2ac468f325afc3bc53932dd70c9c5da5478fd",
+    "docs/assets/screenshots/sample-json.png": "fcebdd36aba06edc9113cb2009094d20c07f83342ffec053e78d5e47d715e1f5"
+  },
+  "review_bundle": {
+    "format": 2,
+    "source_story": {
+      "path": "source-story.md",
+      "sha256": "e7a95d314a1d16b7830c57c69624425cbf3875d57e10260ec7416b5a941fcc70"
+    },
+    "definition": {
+      "format": 1,
+      "reviewer": "Codex feature-story agent",
+      "source_sha256": "50b56f504ae62164ad6841093f05abef327a6e4f5072af3d67ef62a31de2ea73",
+      "plan_sha256": "4349628e972b078196f4ce1aec8c7e248c5c3499a9c8b4b3ae42e4d6242660a7",
+      "story_sha256": "e7a95d314a1d16b7830c57c69624425cbf3875d57e10260ec7416b5a941fcc70"
+    },
+    "plugin": "heinzel-example",
+    "core_version": "0.9.40",
+    "inputs_sha256": "855bf3b5a71afd5ca72803e6de2a0920cdb229a90cd1dd6297525b336f353f47",
+    "screenshots": [
+      {
+        "path": "docs/assets/screenshots/widget-and-status.png",
+        "surface": "ui",
+        "caption": "Demo data: the constant 42 appears in both the Today widget and sidebar status."
+      },
+      {
+        "path": "docs/assets/screenshots/inspector.png",
+        "surface": "ui",
+        "caption": "Demo data: open the plugin-owned inspector to see the same constant value, 42."
+      },
+      {
+        "path": "docs/assets/screenshots/greeting-terminal.png",
+        "surface": "ui",
+        "caption": "Demo data: greet fictional Mira with structured JSON in the app's native terminal."
+      },
+      {
+        "path": "docs/assets/screenshots/plugin-notice.png",
+        "surface": "ui",
+        "caption": "Demo data: a seeded Example is ready notice appears in the shared in-app notification panel."
+      },
+      {
+        "path": "docs/assets/screenshots/greeting-cli.png",
+        "surface": "cli",
+        "caption": "Demo data: the typed hello operation greets fictional Mira from the CLI."
+      },
+      {
+        "path": "docs/assets/screenshots/sample-json.png",
+        "surface": "cli",
+        "caption": "Demo data: sample returns 42 as JSON, the same constant used by the widget, status and inspector."
+      }
+    ],
+    "images": {
+      "widget-and-status.png": "b9a98431c74dde61577a3c1061a3e1e0cf8c47cb7775d83b9685eaca515fd44a",
+      "inspector.png": "0e1cd838c95633fe133ba2f4ed40ff8cb28b1a032bf451b33a41776ac5b07b61",
+      "greeting-terminal.png": "d5d87d85f04dca0d2b4cab6ea7d01b0d321060826f76bb690ca08b48e7e56755",
+      "plugin-notice.png": "9c5ed76532219e97d3e7780576487967609416804cd9becc61f8ac4805c762d3",
+      "greeting-cli.png": "375b8962cc5c7c30ab9c63248ea2ac468f325afc3bc53932dd70c9c5da5478fd",
+      "sample-json.png": "fcebdd36aba06edc9113cb2009094d20c07f83342ffec053e78d5e47d715e1f5"
+    },
+    "transcripts": {
+      "widget-and-status.txt": "68df5b282b3ef97193bd8a156c3776d6ddad26956bc09119d7f5a99e1bcdfdae",
+      "inspector.txt": "59df51db803518a3aaeb0982f36e29d6d4dc67bb1d26737a77761fc5578b18b4",
+      "greeting-terminal.txt": "b0560cb65edafd7b11309430eb09f512c099f6c03e2b0df6d76b9edbf0a038b3",
+      "plugin-notice.txt": "753c9cb1e440b913a6ef237bd698a03d9cf17d442982d55b4b9aabb932aa7222",
+      "greeting-cli.txt": "0a315745bb1e963bf40b1ccfdc9a822532fa703f2c1b5013c8fe303b8cf0f59f",
+      "sample-json.txt": "084c799cd551dd1d8d5c5f9a5d593b2e931f5e36122ee5c793c1d08a19839cc0"
+    },
+    "bundle_sha256": "432a52c7a31ad73dc6a6a3feb3c96df4d8b343dc32a086e37c2c0746873df80d"
+  },
+  "privacy_review": {
+    "format": 1,
+    "bundle_sha256": "432a52c7a31ad73dc6a6a3feb3c96df4d8b343dc32a086e37c2c0746873df80d",
+    "reviewer": "Codex privacy agent",
+    "decision": "approve",
+    "checked_images": [
+      "widget-and-status.png",
+      "inspector.png",
+      "greeting-terminal.png",
+      "plugin-notice.png",
+      "greeting-cli.png",
+      "sample-json.png"
+    ],
+    "checks": {
+      "tokens_absent": true,
+      "personal_data_absent": true,
+      "feature_relevant": true,
+      "multiple_ui_scenes": true,
+      "captions_accurate": true
+    },
+    "findings": []
+  }
+}

heinzel_example-0.5.2/docs/assets/screenshots/greeting-cli.txt

@@ -0,0 +1 @@
+ text  Hello, Mira!

heinzel_example-0.5.2/docs/assets/screenshots/greeting-terminal.txt

@@ -0,0 +1,48 @@
+Skip to content
+Heinzelmännchen
+1
+Heinzelmännchen
+Contracts
+Team graph
+Organisation
+Team roster
+Example
+Example: 42
+M
+Mira
+· EM
+Today
+Today
+Notifications
+1 unread
+Example is ready
+18:31
+All notifications
+Example is ready
+Open
+Doctor: 4 checks need attention
+
+ai.access ai access, system.doctor installation, system.prerequisite system.runner: claude…
+
+Open
+Example value
+
+42
+
+Ask about it
+v0.9.40
+Updates, off
+0
+System health, warning
+?
+Example: 42, off
+Daemon not installed, off
+Chat
+Terminal
+Demo complete
+$ hz example hello --name Mira --json; printf '\033]0;Demo complete\007'
+{
+  "text": "Hello, Mira!"
+}
+$
+Audio

heinzel_example-0.5.2/docs/assets/screenshots/index.html

@@ -0,0 +1 @@
+<!doctype html><html lang="en"><meta charset="utf-8"><meta name="viewport" content="width=device-width"><title>heinzel-example screenshots</title><style>body{font:16px/1.6 system-ui;margin:2rem;background:#faf8f3;color:#263b32}main{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,420px),1fr));gap:1rem}figure{margin:0;padding:1rem;background:white;border:1px solid #d8ddd3;border-radius:12px}img{width:100%;height:auto}figcaption{margin-top:.75rem}a:focus-visible{outline:3px solid #a64028}</style><h1>heinzel-example</h1><p>Isolated demonstration profile · Core 0.9.40 · Review these captures before committing. Click an image to inspect it at full size.</p><main><figure><a href="widget-and-status.png"><img src="widget-and-status.png" alt="Demo data: the constant 42 appears in both the Today widget and sidebar status."></a><figcaption>UI · Demo data: the constant 42 appears in both the Today widget and sidebar status.</figcaption></figure><figure><a href="inspector.png"><img src="inspector.png" alt="Demo data: open the plugin-owned inspector to see the same constant value, 42."></a><figcaption>UI · Demo data: open the plugin-owned inspector to see the same constant value, 42.</figcaption></figure><figure><a href="greeting-terminal.png"><img src="greeting-terminal.png" alt="Demo data: greet fictional Mira with structured JSON in the app&#x27;s native terminal."></a><figcaption>UI · Demo data: greet fictional Mira with structured JSON in the app&#x27;s native terminal.</figcaption></figure><figure><a href="plugin-notice.png"><img src="plugin-notice.png" alt="Demo data: a seeded Example is ready notice appears in the shared in-app notification panel."></a><figcaption>UI · Demo data: a seeded Example is ready notice appears in the shared in-app notification panel.</figcaption></figure><figure><a href="greeting-cli.png"><img src="greeting-cli.png" alt="Demo data: the typed hello operation greets fictional Mira from the CLI."></a><figcaption>CLI · Demo data: the typed hello operation greets fictional Mira from the CLI.</figcaption></figure><figure><a href="sample-json.png"><img src="sample-json.png" alt="Demo data: sample returns 42 as JSON, the same constant used by the widget, status and inspector."></a><figcaption>CLI · Demo data: sample returns 42 as JSON, the same constant used by the widget, status and inspector.</figcaption></figure></main></html>

heinzel_example-0.5.2/docs/assets/screenshots/inspector.txt

@@ -0,0 +1,41 @@
+Skip to content
+Heinzelmännchen
+1
+Heinzelmännchen
+Contracts
+Team graph
+Organisation
+Team roster
+Example
+Example: 42
+M
+Mira
+· EM
+Today
+Today
+Notifications
+1 unread
+Example is ready
+18:31
+All notifications
+Example is ready
+Open
+Example value
+
+42
+
+Ask about it
+v0.9.40
+Updates, off
+0
+System health, warning
+?
+Example: 42, off
+Daemon not installed, off
+Chat
+Example
+Example
+
+42
+
+Audio

heinzel_example-0.5.2/docs/assets/screenshots/plugin-notice.txt

@@ -0,0 +1,57 @@
+Skip to content
+Heinzelmännchen
+1
+Heinzelmännchen
+Contracts
+Team graph
+Organisation
+Team roster
+Example
+Example: 42
+M
+Mira
+· EM
+Today
+Today
+Notifications
+1 unread
+Example is ready
+18:31
+All notifications
+Example is ready
+Open
+Example value
+
+42
+
+Ask about it
+v0.9.40
+Updates, off
+0
+System health, warning
+?
+Example: 42, off
+Daemon not installed, off
+Chat
+New chat
+Ask about your setup, your team's contracts or what to do next. The chat reads with hz and asks you before it changes anything.
+Your message
+Default
+Audio
+Notifications
+All
+Drafts
+Failed runs
+Health
+Releases
+Plugins
+Tests
+Heinzel check-ins
+Calendar
+Today
+Example is ready
+18:31
+quiet mode is on: hz system config set system.notify.quiet false
+Unread
+desktop notifications through Heinzel Notifier; a click opens the screen
+Send a test notification

heinzel_example-0.5.2/docs/assets/screenshots/sample-json.txt

@@ -0,0 +1 @@
+42

heinzel_example-0.5.2/docs/assets/screenshots/source-story.md

@@ -0,0 +1,43 @@
+## Audience
+
+Plugin authors evaluating a small, working reference for Heinzelmännchen extensions.
+
+## Outcome
+
+See one value move from an operation into the Today widget, sidebar status, and an inspector pane; then see a typed greeting and a seeded notification. The examples show integration points to explore, not a production business workflow.
+
+## Scenes
+
+1. **Widget and status, light:** The Today widget and sidebar both show the sample value, 42. `src/heinzel_example/__init__.py` declares `sample`, `@module.widget(source="sample")`, and `@module.status(source="sample", slots={"footer": True, "sidebar": True})`.
+2. **Inspector, dark:** The real Example pane displays 42. `module.nav`, `module.action`, and the status effect navigate to `/?panel=example:inspector`; `module.view(..., name="inspector", source="sample")` owns that pane, rendered by `src/heinzel_example/views/index.js`.
+3. **Greeting in the app terminal:** Run the fictional Mira greeting with JSON output. This is a native terminal result, not a feature UI. `src/heinzel_example/hello/__init__.py` declares the collapsed `hello` operation; `_service.py` constructs the greeting.
+4. **Notification:** Open the shared notification panel to see the seeded “Example is ready” notice. The `notify` operation in `src/heinzel_example/__init__.py` emits it; `docs/screenshot_fixture.py` seeds it in the isolated capture profile.
+5. **Greeting CLI:** Show the same fictional greeting as a direct CLI result.
+6. **Sample JSON CLI:** Show the source value as structured output, connecting the CLI to the widget and inspector.
+
+## Fictional fixtures and presentation
+
+Use the existing `docs/screenshot_fixture.py` bootstrap and its isolated profile; do not create fixture files. Mira is fictional, and 42 is the actual constant returned by `sample`. The notice is seeded demonstration data. Captions identify demo data.
+
+Normal presentation fictionalization is explicitly limited to verified owning-interpreter paths becoming `/demo-profile/.venv`, and only the verified whole hostname detail in the genuine Doctor row becoming `demo-host`. These mappings change no SDK health status or remaining detail and establish no privacy acceptance. Unknown identities still fail, and independent review must inspect every image and transcript.
+
+## Privacy pitfalls
+
+The bootstrap disables native, Doctor, and release notifications and invokes the plugin notice in an isolated profile; it does not by itself prove that captures contain no personal information. Inspect paths, hostnames, account names, notifications, timestamps, terminal output, and other incidental content. Do not conceal unknown identities with assumed substitutions.
+
+## Source-bound UI surface inventory
+
+- **Plugin entrypoint:** `pyproject.toml` declares `heinzel.modules` entry `example = "heinzel_example"`. `src/heinzel_example/__init__.py` declares the root `Module("example", ...)`; `src/heinzel_example/hello/__init__.py` declares the discovered `Module("hello", ...)` submodule.
+- **Genuine feature UI:** The Core-rendered Today metric and footer/sidebar status come from the widget and status declarations. The plugin-owned inspector is a real view at the declared panel target, implemented in `src/heinzel_example/views/index.js`. Its loading state and value are rendered using SDK React; it declares no action row. The same actual value across these surfaces is intentional, but the overview and inspector must remain visually and functionally distinct captures.
+- **Other Core-rendered contributions:** `module.action` and `module.nav` open the inspector. `notify` contributes a plugin notice to the shared notification UI. `module.settings(ExampleSettings)` registers the `greeting` setting in `src/heinzel_example/_models.py`; `@module.info` contributes details to system info. The non-read-only `notify` operation declares an ordinary confirmation. These declarations can give rise to generic Core surfaces, but their precise layouts are not supplied here and must not be invented. No channel or setup contribution is declared in the supplied entrypoints.
+- **Operations and terminal:** Root operations are `info`, `sample`, and `notify`; the hello submodule declares `hello`. CLI output is genuine terminal output, including when displayed in the app terminal, and is not evidence of a feature UI. `README.md` documents `hz example hello`, `hz example info`, JSON output, and system info; the source also declares `sample` and `notify`.
+- **External provider UI:** None is declared in the supplied plugin source. No external provider screen is needed for this story.
+- **Unresolved evidence:** `README.md` describes a health check, but the supplied module declarations contain no explicit health-check contribution; do not invent one. The README also references `tests/contributions_test.py`, which is not among the supplied files. Core implementation and the screenshot author guide are not supplied, so generic surface details and capture behavior require observation during explicit capture. The existing plan is preserved because it already covers two real feature UI scenes, a notice, and useful CLI results.
+
+## Acceptance criteria
+
+- Capture all six planned scenes from the real app or CLI with the existing bootstrap, and confirm the light overview and dark inspector have their requested appearances applied.
+- Verify the overview and inspector each show the actual sample value and are distinct views, not duplicates or caption-only variants. Verify the notification is present and the greeting and sample commands produce useful results.
+- Treat terminal scenes as terminal results; do not substitute terminal output for feature UI or forge HTML. Do not invent routes or screens.
+- Independently inspect every image and transcript for privacy and truthfulness, including the narrowly defined presentation mappings above. Unknown identities fail review.
+- Confirm the plan against the actual capture tooling at capture time. Its TOML structure has been checked against the supplied field rules by inspection; no parser, plugin code, capture, or network call was run.

heinzel_example-0.5.2/docs/assets/screenshots/widget-and-status.txt

@@ -0,0 +1,40 @@
+Skip to content
+Heinzelmännchen
+1
+Heinzelmännchen
+Contracts
+Team graph
+Organisation
+Team roster
+Example
+Example: 42
+M
+Mira
+· EM
+Today
+Today
+Notifications
+1 unread
+Example is ready
+18:31
+All notifications
+Example is ready
+Open
+Example value
+
+42
+
+Ask about it
+v0.9.40
+Updates, off
+0
+System health, warning
+?
+Example: 42, off
+Daemon not installed, off
+Chat
+New chat
+Ask about your setup, your team's contracts or what to do next. The chat reads with hz and asks you before it changes anything.
+Your message
+Default
+Audio

heinzel_example-0.5.2/docs/screenshot-definition.json

@@ -0,0 +1,7 @@
+{
+  "format": 1,
+  "reviewer": "Codex feature-story agent",
+  "source_sha256": "50b56f504ae62164ad6841093f05abef327a6e4f5072af3d67ef62a31de2ea73",
+  "plan_sha256": "4349628e972b078196f4ce1aec8c7e248c5c3499a9c8b4b3ae42e4d6242660a7",
+  "story_sha256": "e7a95d314a1d16b7830c57c69624425cbf3875d57e10260ec7416b5a941fcc70"
+}

heinzel_example-0.5.2/docs/screenshot_fixture.py

@@ -0,0 +1,23 @@
+"""Seed only the example's own notice in an isolated, in-app-only demonstration profile."""
+
+import os
+import sys
+
+from heinzel import Config, Kernel, Notifications, Settings
+from heinzel.heads.cli import build
+from heinzel.kernel import discover
+from heinzel_example import notify
+
+os.environ.update(
+    HZ_SYSTEM_NOTIFY__NATIVE="false",
+    HZ_SYSTEM_NOTIFY__DOCTOR="false",
+    HZ_SYSTEM_NOTIFY__RELEASE="false",
+    HZ_SYSTEM_NOTIFY__QUIET="true",
+    HZ_SYSTEM_NOTIFY__WORKING_HOURS="false",
+)
+config = Config.load()
+records, errors = discover()
+kernel = Kernel(config.settings(Settings, "hz"), records, errors, config)
+notify(kernel.resolve(Notifications))
+sys.argv = ["hz", *sys.argv[1:]]
+build(kernel)()

heinzel_example-0.5.2/docs/screenshots.toml

@@ -0,0 +1,96 @@
+format = 1
+bootstrap = "docs/screenshot_fixture.py"
+
+[[scenes]]
+name = "widget-and-status"
+surface = "ui"
+route = "/"
+appearance = "light"
+caption = "Demo data: the constant 42 appears in both the Today widget and sidebar status."
+
+[[scenes.steps]]
+action = "wait"
+text = "Example value"
+
+[[scenes.steps]]
+action = "wait"
+text = "Example: 42"
+
+[[scenes.steps]]
+action = "click"
+role = "button"
+name_regex = "^Dismiss Doctor"
+optional = true
+
+[[scenes]]
+name = "inspector"
+surface = "ui"
+route = "/?panel=example:inspector"
+appearance = "dark"
+caption = "Demo data: open the plugin-owned inspector to see the same constant value, 42."
+
+[[scenes.steps]]
+action = "wait"
+role = "region"
+name = "Example"
+
+[[scenes.steps]]
+action = "wait"
+text = "42"
+
+[[scenes.steps]]
+action = "click"
+role = "button"
+name_regex = "^Dismiss Doctor"
+optional = true
+
+[[scenes]]
+name = "greeting-terminal"
+surface = "ui"
+route = "/"
+caption = "Demo data: greet fictional Mira with structured JSON in the app's native terminal."
+
+[[scenes.steps]]
+action = "terminal"
+command = ["example", "hello", "--name", "Mira", "--json"]
+
+[[scenes]]
+name = "plugin-notice"
+surface = "ui"
+route = "/"
+caption = "Demo data: a seeded Example is ready notice appears in the shared in-app notification panel."
+
+[[scenes.steps]]
+action = "wait"
+text = "Example value"
+
+[[scenes.steps]]
+action = "click"
+role = "button"
+name_regex = "^Dismiss Doctor"
+optional = true
+
+[[scenes.steps]]
+action = "click"
+role = "button"
+name_regex = "^Notifications"
+
+[[scenes.steps]]
+action = "wait"
+text = "Example is ready"
+
+[scenes.viewport]
+width = 1280
+height = 650
+
+[[scenes]]
+name = "greeting-cli"
+surface = "cli"
+caption = "Demo data: the typed hello operation greets fictional Mira from the CLI."
+command = ["example", "hello", "--name", "Mira"]
+
+[[scenes]]
+name = "sample-json"
+surface = "cli"
+caption = "Demo data: sample returns 42 as JSON, the same constant used by the widget, status and inspector."
+command = ["example", "sample", "--json"]

{heinzel_example-0.4.0 → heinzel_example-0.5.2}/plugin-lock.json

@@ -14,7 +14,7 @@
     "ruff==0.17.2"
   ],
   "core": {
-    "version": "0.9.1",
+    "version": "0.9.40",
     "dependencies": [
       "croniter>=6.2.4",
       "fastapi>=0.161",
@@ -29,10 +29,12 @@
       "pydantic-ai-slim[openai]==2.61.0; extra == \"openai\"",
       "pydantic-settings<3,>=2.11.0",
       "pydantic<3,>=2.12.0",
+      "pyjwt[crypto]<3,>=2.15.1; extra == \"openai\"",
       "pyyaml<7,>=6.0.2",
       "rich>=14.2.0",
       "tomlkit>=0.13",
       "typer>=0.23.0",
+      "uv==0.13.7",
       "uvicorn>=0.54",
       "wsproto>=1.3"
     ]

{heinzel_example-0.4.0 → heinzel_example-0.5.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "heinzel-example"
-version = "0.4.0"
+version = "0.5.2"
 description = "Show how a Heinzelmännchen plugin is built."
 readme = "README.md"
 authors = [{ name = "Helmut Hoffer von Ankershoffen", email = "helmuthva@gmail.com" }]
@@ -141,3 +141,42 @@ pythonVersion = "3.12"
 
 [tool.hatch.build.targets.sdist]
 exclude = [".venv", ".acceptance", ".preview", "dist", "web/node_modules", "**/__pycache__", ".pytest_cache", ".mypy_cache", ".coverage*"]
+
+[tool.heinzel.catalog]
+title = "Example Plugin"
+category = "reference"
+highlights = [
+    "A working reference for extension authors",
+    "Operations, settings and head contributions",
+    "Source to explore alongside the scaffold guide",
+]
+
+[[tool.heinzel.catalog.screenshots]]
+path = "docs/assets/screenshots/widget-and-status.png"
+surface = "ui"
+caption = "Demo data: the constant 42 appears in both the Today widget and sidebar status."
+
+[[tool.heinzel.catalog.screenshots]]
+path = "docs/assets/screenshots/inspector.png"
+surface = "ui"
+caption = "Demo data: open the plugin-owned inspector to see the same constant value, 42."
+
+[[tool.heinzel.catalog.screenshots]]
+path = "docs/assets/screenshots/greeting-terminal.png"
+surface = "ui"
+caption = "Demo data: greet fictional Mira with structured JSON in the app's native terminal."
+
+[[tool.heinzel.catalog.screenshots]]
+path = "docs/assets/screenshots/plugin-notice.png"
+surface = "ui"
+caption = "Demo data: a seeded Example is ready notice appears in the shared in-app notification panel."
+
+[[tool.heinzel.catalog.screenshots]]
+path = "docs/assets/screenshots/greeting-cli.png"
+surface = "cli"
+caption = "Demo data: the typed hello operation greets fictional Mira from the CLI."
+
+[[tool.heinzel.catalog.screenshots]]
+path = "docs/assets/screenshots/sample-json.png"
+surface = "cli"
+caption = "Demo data: sample returns 42 as JSON, the same constant used by the widget, status and inspector."

{heinzel_example-0.4.0 → heinzel_example-0.5.2}/requirements.lock

@@ -640,9 +640,9 @@ nodejs-wheel-binaries==24.19.0 \
     --hash=sha256:d9074c665ea68b04e183d82482c86dc907d3a9bd15eb6cf85542cb785266bb36 \
     --hash=sha256:db217eef8cab8551667863379b08db4d9067403f6cbbe87481eb40edceb8aa9b \
     --hash=sha256:e12cbfd69089504e42fb14194ce734a9dcf3eb38c820ca63dd511d36fb964e9c
-opentelemetry-api==1.45.1 \
-    --hash=sha256:aa38ed19bcc084ba42782a73255b3582283eced7ad6dddbd6695189e69adfb75 \
-    --hash=sha256:b31553efa588ae44bc306f863c785c5333a9ecc091248c6ee68b4b6c87fdedfb
+opentelemetry-api==1.45.2 \
+    --hash=sha256:2cbd737377e710ee740d261c94e93fa0f08e6d037c18f17513cc0a2d94479a34 \
+    --hash=sha256:d7b0008e21e5fd61cbe7a7f34ca3b6905a78ab677d9bc395e299359c75cda6b4
 packaging==26.3 \
     --hash=sha256:94edc256424af38762eb31306eed28beb9f0efc50a8837492c9d6fd6004aed79 \
     --hash=sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c
@@ -1146,6 +1146,26 @@ typing-inspection==0.4.4 \
 tzdata==2026.6 \
     --hash=sha256:0a10eec6e13ef16b627fabed9a5f2ba61a62b1c67f327305f4e7e412a70b4aec \
     --hash=sha256:85d2cd9c09f81f0bb29db27759fc83af4f1e620efb814f8c5bf8b4cc4feece6d
+uv==0.13.7 \
+    --hash=sha256:08f16fd463926786b702b497473511deae4b3e17a2fa6d22180950d6059a120d \
+    --hash=sha256:158953b8669bee6f4bc2babdd997e34ff9f0d57170093cfe907f64448292b7c3 \
+    --hash=sha256:1bc8543d930464bbb22ac01bb1a660a448235e558014914de1e1cd5b993361b8 \
+    --hash=sha256:2835e2ab397d0db86323b9975dce75ecd76aa9cfa0d6a2aea84734aae7f8c9b3 \
+    --hash=sha256:2c9bdc4a872b60a93c5f26c0791089ea11585a4f9d3b3c017d78eb8487505e25 \
+    --hash=sha256:55e741a380a98008fc4985cf069855f36bc50242ef438e21a466786f5bc84da8 \
+    --hash=sha256:57ff66891d9a738ec087c23fdde842ac8e5eb63189ffed6ee95caee1b82ceb54 \
+    --hash=sha256:5e766791cb825d7a07e2ef9e622d307b48754fb682a31ba7bc5f272fab9ea395 \
+    --hash=sha256:5f37cc4d4660e4aee8a24d0dc179a0b0ce99506259c6796d37fa69bca9543a03 \
+    --hash=sha256:89df450624dec8c48b8b5a7adb654928cc50e95753f869c70cd65ef8333f2197 \
+    --hash=sha256:8b8ac028ae4ebb2a3f9d04907c61794f2cf8d7a7002bfbb4019a3dee28351fb2 \
+    --hash=sha256:8fc6019740794df995085f7b278d99dc11ccacffad9c63957278d3a6e272280b \
+    --hash=sha256:917733990ebc178318af0321d6873823ed5da707e1c4b1e5060ac2065a81f1f3 \
+    --hash=sha256:94f65a8ac5826dff76a93cb3cafbaad15def1788c63da2ce5ce09e0bd1303e7a \
+    --hash=sha256:952dcae9b1a7742f2fab28e82391fbfabe8807e4e9363f674b0f6be1053b8dd4 \
+    --hash=sha256:a90f5d95716ab83091f0f73a8e7ec64e557abf2a28537fcd719b2ac88e6f725a \
+    --hash=sha256:d30cafb7070901ba35353ec64cf228ae46caf79ac0f6fae329f95468b1482531 \
+    --hash=sha256:f91a229093163eefca89ea1b220a221d64c3beade05d03519a6584d1797a5a5f \
+    --hash=sha256:fd04bf01ba5f2829f4f94ca8f0c24a743f21e73d75045613ed6fc2fd66fc7bda
 uvicorn==0.54.0 \
     --hash=sha256:505bdb0f318731d45f1f712071fc781a8981f6847a31c902c9f5e652d4f67faf \
     --hash=sha256:a2e33cbfaa0306f8e6b0c13e0cb89d7d7a2da3e62b90c66e18c33d9807b28620

{heinzel_example-0.4.0 → heinzel_example-0.5.2}/src/heinzel_example/__init__.py

@@ -6,7 +6,7 @@ below it that declares `module = Module(...)` becomes a submodule (see `hello/`)
 
 from pathlib import Path
 
-from heinzel import MetricWidget, Module, Navigate, NoticeKind, Notifications, StatusItem
+from heinzel import DetailLine, MetricWidget, Module, Navigate, NoticeKind, Notifications, StatusItem
 
 from heinzel_example._models import ExampleAbout, ExampleSettings
 from heinzel_example._service import ExampleService
@@ -46,10 +46,15 @@ def notify(notifications: Notifications) -> str:
     return notice.title if notice else "Notifications are disabled"
 
 
-@module.status(source="sample", order=700, slots={"footer": False, "sidebar": True})
+@module.status(source="sample", order=700, slots={"footer": True, "sidebar": True})
 def status(value: int) -> StatusItem:
-    """Render checked data through the same host slots as built-in modules."""
-    return StatusItem(text=f"Example: {value}", icon="star", effect=Navigate(path="/?panel=example:inspector"))
+    """Contribute the footer icon and the sidebar item; a click opens the Example pane (the view below)."""
+    return StatusItem(
+        text=f"Example: {value}",
+        icon="star",
+        detail=[DetailLine(text="Example")],
+        effect=Navigate(path="/?panel=example:inspector"),
+    )
 
 
 @module.widget(source="sample", order=700)

{heinzel_example-0.4.0 → heinzel_example-0.5.2}/src/heinzel_example/views/index.js

@@ -1,10 +1,10 @@
 // This small view needs no bundler. A specialist view can use the same versioned SDK with its own build.
+// Pane structure: the content only. It has no actions, so there is no divider and no bottom action row.
 export default function createView(sdk) {
   if (sdk.abi !== 1) throw new Error("Example requires plugin SDK 1");
-  return function Inspector({data, loading, onClose}) {
+  return function Inspector({data, loading}) {
     return sdk.React.createElement("section", {"aria-label": "Example", className: "p-4"},
       sdk.React.createElement("h2", null, "Example"),
-      sdk.React.createElement("p", {role: "status"}, loading ? "Loading…" : `The value is ${data}.`),
-      sdk.React.createElement(sdk.Button, {onClick: onClose}, "Close example"));
+      sdk.React.createElement("p", {role: "status", className: "text-6xl font-semibold"}, loading ? "Loading…" : String(data)));
   };
 }

{heinzel_example-0.4.0 → heinzel_example-0.5.2}/tests/contributions_test.py

@@ -4,7 +4,7 @@ from types import SimpleNamespace
 from unittest.mock import Mock
 
 import pytest
-from heinzel import NoticeKind, Notifications, ViewLet
+from heinzel import NoticeKind, Notifications, StatusLet, ViewLet
 
 from heinzel_example import module, notify, sample, status, today
 
@@ -20,6 +20,18 @@ def test_example_value_owns_its_status_and_today_widget():
     assert view.source == "sample"
 
 
+def test_footer_icon_opens_the_example_pane_with_the_value():
+    item = status(sample())
+    [let] = [let for let in module.lets if isinstance(let, StatusLet)]
+    assert dict(let.slots) == {"footer": True, "sidebar": True}
+    assert item.icon == "star"
+    assert item.detail[0].text == "Example"
+    assert item.effect.path == "/?panel=example:inspector"
+    [view] = [let for let in module.lets if isinstance(let, ViewLet)]
+    assert view.title == "Example"
+    assert view.source == "sample"
+
+
 @pytest.mark.parametrize("enabled", [True, False])
 def test_plugin_notice_uses_the_shared_notification_policy(enabled):
     notifications = Mock(spec=Notifications)

heinzel_example-0.4.0/CHANGELOG.md

@@ -1,8 +0,0 @@
-# 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/PKG-INFO

@@ -1,59 +0,0 @@
-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

@@ -1,38 +0,0 @@
-# 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.