@jurislm/woodpecker-ci-plugin 1.1.9 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "woodpecker-ci",
3
- "version": "1.1.9",
3
+ "version": "2.0.1",
4
4
  "description": "Manage Woodpecker CI through agent tools.",
5
5
  "author": {
6
6
  "name": "JurisLM",
@@ -10,7 +10,6 @@
10
10
  "license": "MIT",
11
11
  "skills": "./skills/",
12
12
  "mcpServers": "./.mcp.json",
13
- "apps": "./.app.json",
14
13
  "interface": {
15
14
  "displayName": "Woodpecker CI",
16
15
  "shortDescription": "Manage Woodpecker CI through agent tools.",
package/README.md CHANGED
@@ -22,7 +22,7 @@ The server does not read `DRONE_TOKEN`.
22
22
  ```json
23
23
  {
24
24
  "mcpServers": {
25
- "woodpecker": {
25
+ "woodpecker-ci": {
26
26
  "command": "bunx",
27
27
  "args": ["-y", "@jurislm/woodpecker-ci-plugin@latest"],
28
28
  "env": {
@@ -34,16 +34,21 @@ The server does not read `DRONE_TOKEN`.
34
34
  }
35
35
  ```
36
36
 
37
- The server exposes one MCP tool for each operation in the committed official
38
- Woodpecker OpenAPI snapshot. It is a local stdio package, not a hosted
39
- ChatGPT plugin endpoint.
37
+ The server exposes generated OpenAPI operations plus a focused pipeline
38
+ inspection tool. Personal-token lifecycle and pprof operations are excluded.
39
+ The `/version` operation is also excluded because the configured Woodpecker
40
+ instance returns its HTML app shell for that path instead of JSON.
41
+ It is a local stdio package, not a hosted ChatGPT plugin endpoint.
40
42
 
41
- The current snapshot contains 118 operations. Generated tool names, input
42
- schemas, output schemas, and annotations live under `src/generated/`.
43
+ Generated tool names, titles, descriptions, input schemas, output schemas, and
44
+ annotations live under `src/generated/`. Token request fields are omitted;
45
+ token and password fields, plus secret values, are omitted from responses.
43
46
 
44
- The v1 contract is frozen in `contracts/woodpecker-mcp-v1.json`: tool names,
45
- paths, annotations, environment names, structured output, and schema hashes
46
- are checked by `bun run api:check` and the generated contract tests.
47
+ The current v2 generated-operation contract is in
48
+ `contracts/woodpecker-mcp-v2.json`; the v1 contract remains as the previous
49
+ compatibility snapshot. `api/manifest.json` is the canonical snapshot
50
+ provenance. `bun run api:check` verifies its SHA-256, path and operation counts,
51
+ then checks generated artifacts.
47
52
 
48
53
  ## OpenAI Plugin package
49
54
 
@@ -52,23 +57,43 @@ This repository also contains the portable Agent Plugin layer:
52
57
  - `plugin.json` — portable plugin identity and OpenAI presentation metadata.
53
58
  - `mcp.json` — stdio MCP server configuration.
54
59
  - `.codex-plugin/plugin.json` — Codex compatibility fallback.
60
+ - `.agents/plugins/marketplace.json` — repository-root Codex marketplace entry.
55
61
  - `.mcp.json.example` — local configuration example without secrets.
56
62
  - `skills/woodpecker-ci/SKILL.md` — service-specific tool-selection guidance.
57
- - `.mcp.json` and `.app.json` — Codex compatibility companion files.
63
+ - `.mcp.json` — Codex MCP registration, matching the portable `mcp.json`.
64
+ - `.app.json.example` — empty Developer Mode mapping example.
58
65
 
59
66
  This version is private/local distribution. It does not provide a public
60
67
  HTTPS `/mcp` endpoint or OAuth flow.
61
68
 
69
+ ## Codex App installation
70
+
71
+ From the repository root:
72
+
73
+ ```bash
74
+ codex plugin marketplace add .
75
+ codex plugin add woodpecker-ci@woodpecker-ci-marketplace
76
+ ```
77
+
78
+ The server can initialize and list its tools before credentials are set.
79
+ Provider calls require `WOODPECKER_URL` and `WOODPECKER_API_TOKEN` in the MCP
80
+ server process environment. A GUI-launched Codex app may not inherit shell
81
+ profile variables, so do not rely on `~/.zshenv` alone. Keep token values out
82
+ of repository files. Open a new task after installing or updating the plugin
83
+ so Codex loads its current tool catalog.
84
+
62
85
  ## Development
63
86
 
64
87
  ```bash
65
88
  bun install
66
89
  bun run api:fetch
67
- bun run api:generate
90
+ bun run api:check
68
91
  bun run check
69
92
  ```
70
93
 
71
- `api:fetch` is the only command that updates the committed API snapshot.
94
+ `api:fetch` updates the committed snapshot and canonical provenance at
95
+ `api/manifest.json`. `api:check` verifies its hash and operation counts before
96
+ checking generated artifacts.
72
97
 
73
98
  For a live read-only configuration check:
74
99
 
@@ -78,16 +103,13 @@ WOODPECKER_API_TOKEN=... \
78
103
  bun run smoke:read
79
104
  ```
80
105
 
81
- Validate the portable Plugin package with:
106
+ Validate the portable Plugin manifests and npm package contents with:
82
107
 
83
108
  ```bash
84
109
  bun run manifest:check
110
+ bun run package:check
85
111
  ```
86
112
 
87
- This repository intentionally does not include a Codex repository marketplace
88
- catalog. The Plugin and MCP manifests remain available for direct packaging
89
- and local host installation.
90
-
91
113
  ## Release automation
92
114
 
93
115
  Merges to `main` run the normal checks and update the Release Please Release
@@ -101,5 +123,7 @@ repository secret; PR pipelines never receive either release secret.
101
123
 
102
124
  ## Security
103
125
 
104
- Tokens are sent only as bearer authentication and are not included in logs or
105
- tool request metadata. Mutation requests are not retried automatically.
126
+ The configured API token is sent only as bearer authentication and is not
127
+ included in logs or tool request metadata. Credential fields are removed from
128
+ response schemas and tool results. Mutation requests are not retried
129
+ automatically.
@@ -0,0 +1,8 @@
1
+ {
2
+ "sourceUrl": "https://woodpecker-ci.org/redocusaurus/plugin-redoc-0.yaml",
3
+ "fetchedAt": "2026-09-16T07:12:03.978Z",
4
+ "sha256": "cadfe6ccbe3bdd1c29140d605704db9fe1ae76569d72d56792e326eb53cd596f",
5
+ "specVersion": "dev",
6
+ "pathCount": 74,
7
+ "operationCount": 118
8
+ }