Skip to content

Commit da00e14

Browse files
committed
Clarify plugin manifest and telemetry docs
1 parent a3134ab commit da00e14

3 files changed

Lines changed: 12 additions & 2 deletions

File tree

plugins/hanko-auth-integration/README.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,10 @@ The plugin does not add a runtime dependency to Hanko. It gives agents a precise
1111
- Plugin eval cases in `evals/hanko-auth-integration/cases.jsonl`.
1212
- Privacy-safe measurement guidance for teams that want production plugin metrics.
1313

14+
## Manifest Compatibility
15+
16+
The Codex and Claude manifests use `skills: ./skills/`, which is resolved from the plugin root by the plugin manifest contract. The Codex manifest validates with the local plugin validator used for this contribution.
17+
1418
## Primary Workflows
1519

1620
- Framework integration plan.
@@ -32,7 +36,7 @@ Use this plugin directory directly from the repository when your harness support
3236
plugins/hanko-auth-integration
3337
```
3438

35-
For Telvine-backed distribution and metrics:
39+
For Telvine-backed distribution and metrics, the Telvine CLI is published as [`telvine` on npm](https://www.npmjs.com/package/telvine):
3640

3741
```bash
3842
npm i -g telvine

plugins/hanko-auth-integration/evals/hanko-auth-integration/README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,3 +10,5 @@ Each JSONL row contains:
1010
- `expected.must_include`: concepts the plugin output should cover.
1111
- `expected.must_not_include`: sensitive data classes the plugin must avoid.
1212
- `metadata.safe_events`: metadata-only events that can be tracked if a team uses Telvine or another plugin telemetry sink.
13+
- `metadata.component`: the plugin component or skill under test.
14+
- `metadata.harnesses`: agent harnesses the plugin is intended to support.

plugins/hanko-auth-integration/skills/hanko-auth-integration/SKILL.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,11 +45,15 @@ Only emit metadata about plugin behavior, such as component name, outcome, durat
4545

4646
## Optional Telvine Measurement
4747

48-
Teams that publish this plugin through Telvine can measure adoption and eval outcomes without changing Hanko runtime code:
48+
Teams that publish this plugin through Telvine can measure adoption and eval outcomes without changing Hanko runtime code. The CLI package is published as `telvine` on npm: https://www.npmjs.com/package/telvine
4949

5050
```bash
5151
npm i -g telvine
5252
telvine login
5353
telvine publish ./plugins/hanko-auth-integration
5454
telvine plugins metrics
5555
```
56+
57+
## Manifest Path Note
58+
59+
The plugin manifests use `skills: ./skills/` because the supported plugin manifest contract resolves that path from the plugin root, not from the hidden manifest directory.

0 commit comments

Comments
 (0)