@jurislm/woodpecker-ci-plugin 2.0.6 → 2.1.0
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.
- package/.codex-plugin/plugin.json +1 -1
- package/.mcp.json +2 -1
- package/README.md +31 -24
- package/dist/client.js +15 -2
- package/dist/client.js.map +1 -1
- package/docs/plugin-architecture.md +89 -0
- package/launchers/woodpecker-desktop.zsh +30 -0
- package/package.json +14 -7
- package/plugin.json +1 -1
package/.mcp.json
CHANGED
package/README.md
CHANGED
|
@@ -85,41 +85,45 @@ server process environment. A desktop app launched by macOS does not read your
|
|
|
85
85
|
interactive shell configuration. Check the MCP child process, not the terminal,
|
|
86
86
|
when diagnosing missing credentials.
|
|
87
87
|
|
|
88
|
-
The
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
Codex config or this repository. Replace the example URL with your Woodpecker
|
|
108
|
-
API URL. The plugin-scoped policy below disables the bundled server while
|
|
109
|
-
keeping the guidance skill enabled:
|
|
88
|
+
The portable `mcp.json` has no environment defaults. Native `.mcp.json`
|
|
89
|
+
forwards `WOODPECKER_URL` and `WOODPECKER_API_TOKEN` using `env_vars`; this only
|
|
90
|
+
forwards values already available to the host and does not source `.zshenv`.
|
|
91
|
+
Do not put `${WOODPECKER_URL}` or `${WOODPECKER_API_TOKEN}` in portable `env`:
|
|
92
|
+
Codex's portable parser only expands `${PLUGIN_ROOT}` and `${PLUGIN_DATA}`.
|
|
93
|
+
|
|
94
|
+
For macOS desktop sessions whose token is exported by `.zshenv`, opt into the
|
|
95
|
+
shipped launcher. It explicitly sources that file, keeps startup stdout out of
|
|
96
|
+
MCP, preserves stderr, and forwards only the Woodpecker connection variables
|
|
97
|
+
plus HOME/PATH/TMPDIR/LANG. Startup failures and missing connection settings
|
|
98
|
+
stop before the provider starts. No token is copied into Codex configuration.
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
mkdir -p "$HOME/.codex/bin"
|
|
102
|
+
cp launchers/woodpecker-desktop.zsh "$HOME/.codex/bin/woodpecker-mcp.zsh"
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
Configure the absolute launcher path in `~/.codex/config.toml`, preserve your
|
|
106
|
+
existing non-sensitive URL, and disable only the selected bundled server:
|
|
110
107
|
|
|
111
108
|
```toml
|
|
112
109
|
[mcp_servers.woodpecker-ci]
|
|
113
110
|
command = "/bin/zsh"
|
|
114
|
-
args = ["-
|
|
111
|
+
args = ["-f", "/absolute/path/to/.codex/bin/woodpecker-mcp.zsh"]
|
|
115
112
|
required = true
|
|
116
113
|
startup_timeout_sec = 30
|
|
117
114
|
|
|
115
|
+
[mcp_servers.woodpecker-ci.env]
|
|
116
|
+
WOODPECKER_URL = "https://ci.example.com/api"
|
|
117
|
+
|
|
118
118
|
[plugins."woodpecker-ci@woodpecker-ci-marketplace".mcp_servers.woodpecker-ci]
|
|
119
119
|
enabled = false
|
|
120
120
|
```
|
|
121
121
|
|
|
122
|
-
|
|
122
|
+
The launcher requires Bun at `$HOME/.bun/bin/bunx` and continues to use
|
|
123
|
+
`@latest`. Read `initialize.serverInfo.version` and match the intended release;
|
|
124
|
+
a marketplace cache version is not the resolved running package version.
|
|
125
|
+
`codex mcp get` reads a user registration; it does not prove a plugin-provided
|
|
126
|
+
instance received that environment.
|
|
123
127
|
|
|
124
128
|
`required = true` waits for this MCP server during tool discovery. Check
|
|
125
129
|
`codex mcp get woodpecker-ci`, then open a new Codex task and confirm that its
|
|
@@ -127,6 +131,9 @@ Woodpecker tools are present and an authenticated read succeeds. A successful
|
|
|
127
131
|
local stdio check alone does not verify the task's tool catalog. Keep token
|
|
128
132
|
values out of repository files and diagnostic output.
|
|
129
133
|
|
|
134
|
+
See the [JurisLM Plugin Architecture v1](docs/plugin-architecture.md) for shared
|
|
135
|
+
packaging, configuration, release and acceptance rules.
|
|
136
|
+
|
|
130
137
|
## Cursor installation
|
|
131
138
|
|
|
132
139
|
In Cursor, open Customize → Add Marketplace → Import from GitHub and enter
|
package/dist/client.js
CHANGED
|
@@ -17,20 +17,33 @@ function pathValue(value, name) {
|
|
|
17
17
|
if (value === undefined || value === null) {
|
|
18
18
|
throw new Error("Missing required path parameter: " + name);
|
|
19
19
|
}
|
|
20
|
+
if (typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean") {
|
|
21
|
+
throw new Error("Invalid path parameter: " + name);
|
|
22
|
+
}
|
|
20
23
|
const segment = String(value);
|
|
21
24
|
if (/^\.+$/u.test(segment))
|
|
22
25
|
throw new Error("Invalid dot-only path parameter: " + name);
|
|
23
26
|
return encodeURIComponent(segment);
|
|
24
27
|
}
|
|
28
|
+
function queryValue(value) {
|
|
29
|
+
if (typeof value === "string")
|
|
30
|
+
return value;
|
|
31
|
+
if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint")
|
|
32
|
+
return String(value);
|
|
33
|
+
const encoded = JSON.stringify(value);
|
|
34
|
+
if (encoded === undefined)
|
|
35
|
+
throw new Error("Invalid query parameter value");
|
|
36
|
+
return encoded;
|
|
37
|
+
}
|
|
25
38
|
function appendQuery(url, name, value) {
|
|
26
39
|
if (value === undefined || value === null)
|
|
27
40
|
return;
|
|
28
41
|
if (Array.isArray(value)) {
|
|
29
42
|
for (const item of value)
|
|
30
|
-
url.searchParams.append(name,
|
|
43
|
+
url.searchParams.append(name, queryValue(item));
|
|
31
44
|
return;
|
|
32
45
|
}
|
|
33
|
-
url.searchParams.set(name,
|
|
46
|
+
url.searchParams.set(name, queryValue(value));
|
|
34
47
|
}
|
|
35
48
|
function decodeBinary(bytes, contentType) {
|
|
36
49
|
return {
|
package/dist/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAkBtD,MAAM,YAAY,GAAG,mFAAmF,CAAC;AAEzG,MAAM,UAAU,eAAe,CAAI,KAAQ;IACzC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# JurisLM Plugin Architecture v1
|
|
2
|
+
|
|
3
|
+
## Package and host configuration
|
|
4
|
+
|
|
5
|
+
Each plugin keeps its own repository, package identity and release. Portable
|
|
6
|
+
`plugin.json` and `mcp.json` are the canonical package entry points. Native
|
|
7
|
+
Codex, Cursor and existing Claude manifests are host adapters. Validate every
|
|
8
|
+
format independently and compare server identity, transport and launch target;
|
|
9
|
+
host-only fields such as Codex `env_vars` may differ.
|
|
10
|
+
|
|
11
|
+
Portable MCP configuration must not contain `env_vars`, private service URLs,
|
|
12
|
+
token defaults or ordinary `${ENVIRONMENT_VARIABLE}` interpolation. Native
|
|
13
|
+
Codex stdio declarations forward their supported credential variable names.
|
|
14
|
+
Forwarding only reads values already available in the owning environment; it
|
|
15
|
+
does not load shell startup files or another MCP registration's settings.
|
|
16
|
+
|
|
17
|
+
Hetzner, Coolify and Woodpecker provide Bun/TypeScript stdio servers. Higgsfield
|
|
18
|
+
uses its official remote HTTP/OAuth server and separately authenticated CLI;
|
|
19
|
+
its package must not replace those with a local server. Preserve existing tool
|
|
20
|
+
names, inputs, output schemas, text representations and provider workflows.
|
|
21
|
+
|
|
22
|
+
## Local stdio implementation
|
|
23
|
+
|
|
24
|
+
Keep configuration, HTTP requests, error handling, registration and provider
|
|
25
|
+
tools at distinct seams. Generated and custom tools share the same HTTP client
|
|
26
|
+
and safe error handling, with adapters preserving their existing MCP outputs.
|
|
27
|
+
The internal HTTP envelope is `{ data, status, request: { method, path } }`.
|
|
28
|
+
Provider errors retain their existing codes and output format. Never log token
|
|
29
|
+
values, authorization headers or unsanitized provider error bodies.
|
|
30
|
+
|
|
31
|
+
Ordinary initialization and tool discovery work without credentials. Validate
|
|
32
|
+
required connection settings before sending a provider request. Keep health
|
|
33
|
+
authentication exceptions and provider-specific normalization. Coolify selects
|
|
34
|
+
URL/token pairs from one variable group; never fill a partial pair from another
|
|
35
|
+
group. Preserve Hetzner credential-return allowlists, SSH agent requirements,
|
|
36
|
+
pagination and partial-failure semantics, and binary/stream output behavior.
|
|
37
|
+
|
|
38
|
+
## Opt-in macOS launcher
|
|
39
|
+
|
|
40
|
+
Each local server ships `launchers/<provider>-desktop.zsh`. The host invokes it
|
|
41
|
+
with `/bin/zsh -f`. It explicitly sources `${ZDOTDIR:-$HOME}/.zshenv`, suppresses
|
|
42
|
+
startup stdout, preserves stderr, checks required credentials, and execs the
|
|
43
|
+
absolute `$HOME/.bun/bin/bunx` path. Preflight startup syntax; reject syntax
|
|
44
|
+
errors and source status greater than 1. Status 1 may be a benign final
|
|
45
|
+
optional-file guard; credential completeness still gates execution. Startup
|
|
46
|
+
values may override inherited values, matching ordinary zsh source behavior.
|
|
47
|
+
|
|
48
|
+
Retain only HOME, PATH, TMPDIR, LANG and the provider's supported connection
|
|
49
|
+
variables. Hetzner also retains SSH_AUTH_SOCK. Fix PATH to
|
|
50
|
+
`$HOME/.bun/bin:/usr/bin:/bin`. Do not pass credentials in command arguments.
|
|
51
|
+
Woodpecker's URL is supplied by the user MCP `env` setting or existing shell
|
|
52
|
+
environment; the launcher does not parse global Codex configuration.
|
|
53
|
+
|
|
54
|
+
Installing this launcher is opt-in. Keep the portable bunx manifest unchanged,
|
|
55
|
+
disable only the selected plugin's bundled server, and use a user MCP
|
|
56
|
+
registration with startup_timeout_sec=30. Keep skills enabled. Preserve
|
|
57
|
+
unrelated plugin registrations and existing credential sources.
|
|
58
|
+
|
|
59
|
+
## Validation and release
|
|
60
|
+
|
|
61
|
+
Use Bun 1.3.14 for development and CI. Keep SDK 1.30.0 and Zod 4.6.5 pinned for
|
|
62
|
+
the three local servers. A complete `bun run check` validates manifests,
|
|
63
|
+
snapshot integrity/generated parity where applicable, lint, typechecking,
|
|
64
|
+
build, offline tests, release workflows and package contents. Generated
|
|
65
|
+
artifacts are regenerated from committed inputs, never edited by hand.
|
|
66
|
+
|
|
67
|
+
Use Hetzner's existing lint configuration and pinned dependencies as the local
|
|
68
|
+
server baseline. Tests exercise public tool contracts and process boundaries;
|
|
69
|
+
they do not require live credentials. Packages include their launcher and
|
|
70
|
+
exclude credentials. Release Please owns package and plugin versions.
|
|
71
|
+
|
|
72
|
+
Higgsfield has a private development package for package/skill validation and
|
|
73
|
+
Git releases, with no npm runtime publication. Record the source revision and
|
|
74
|
+
hashes of vendored skills without silently rewriting their upstream workflows.
|
|
75
|
+
|
|
76
|
+
## Acceptance evidence
|
|
77
|
+
|
|
78
|
+
Report source SHA, package/marketplace version, resolved MCP server version,
|
|
79
|
+
tool catalog and each authenticated read separately. Local launchers continue
|
|
80
|
+
using `@latest`; accept a delivered release only after `initialize.serverInfo`
|
|
81
|
+
matches the target release. Higgsfield's remote server and CLI versions are
|
|
82
|
+
independent of its plugin package version.
|
|
83
|
+
|
|
84
|
+
An offline check, direct stdio read, merge or publication does not prove a
|
|
85
|
+
fresh ordinary host chat has registered and successfully called the selected
|
|
86
|
+
plugin's tools. Record the actual server/plugin source, input, HTTP status and
|
|
87
|
+
returned counts without secrets. Retest missing settings and authentication
|
|
88
|
+
failures in that target environment. OAuth login and opening a fresh chat are
|
|
89
|
+
explicit acceptance dependencies; leave those layers pending until read back.
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
#!/bin/zsh -f
|
|
2
|
+
if [[ -r ${ZDOTDIR:-$HOME}/.zshenv ]]; then
|
|
3
|
+
/bin/zsh -f -n "${ZDOTDIR:-$HOME}/.zshenv" || exit $?
|
|
4
|
+
startup_status=0
|
|
5
|
+
source "${ZDOTDIR:-$HOME}/.zshenv" >/dev/null || startup_status=$?
|
|
6
|
+
if (( startup_status > 1 )); then
|
|
7
|
+
exit "$startup_status"
|
|
8
|
+
fi
|
|
9
|
+
fi
|
|
10
|
+
if [[ -z ${WOODPECKER_API_TOKEN:-} ]]; then
|
|
11
|
+
print -u2 -- 'WOODPECKER_API_TOKEN is required in the zsh startup environment'
|
|
12
|
+
exit 1
|
|
13
|
+
fi
|
|
14
|
+
if [[ -z ${WOODPECKER_URL:-} ]]; then
|
|
15
|
+
print -u2 -- 'WOODPECKER_URL is required in the host or zsh startup environment'
|
|
16
|
+
exit 1
|
|
17
|
+
fi
|
|
18
|
+
zmodload zsh/parameter
|
|
19
|
+
export PATH="$HOME/.bun/bin:/usr/bin:/bin"
|
|
20
|
+
for name in ${(k)parameters}; do
|
|
21
|
+
case "$name" in
|
|
22
|
+
HOME|PATH|TMPDIR|LANG|WOODPECKER_URL|WOODPECKER_API_TOKEN) ;;
|
|
23
|
+
*)
|
|
24
|
+
if [[ ${parameters[$name]} == *export* ]]; then
|
|
25
|
+
unset "$name"
|
|
26
|
+
fi
|
|
27
|
+
;;
|
|
28
|
+
esac
|
|
29
|
+
done
|
|
30
|
+
exec "$HOME/.bun/bin/bunx" -y @jurislm/woodpecker-ci-plugin@latest
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@jurislm/woodpecker-ci-plugin",
|
|
3
|
-
"version": "2.0
|
|
3
|
+
"version": "2.1.0",
|
|
4
4
|
"description": "Local stdio MCP server for Woodpecker CI",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -21,7 +21,9 @@
|
|
|
21
21
|
"api",
|
|
22
22
|
"openapi",
|
|
23
23
|
"contracts",
|
|
24
|
-
"schemas"
|
|
24
|
+
"schemas",
|
|
25
|
+
"launchers",
|
|
26
|
+
"docs/plugin-architecture.md"
|
|
25
27
|
],
|
|
26
28
|
"engines": {
|
|
27
29
|
"bun": ">=1.1.0"
|
|
@@ -34,7 +36,7 @@
|
|
|
34
36
|
"clean": "bun scripts/clean-dist.ts",
|
|
35
37
|
"build": "bun run clean && tsc",
|
|
36
38
|
"start": "bun dist/index.js",
|
|
37
|
-
"typecheck": "tsc --noEmit",
|
|
39
|
+
"typecheck": "tsc --noEmit -p tsconfig.check.json",
|
|
38
40
|
"test": "bun test --path-ignore-patterns dist",
|
|
39
41
|
"api:fetch": "bun scripts/update-openapi.ts",
|
|
40
42
|
"api:generate": "bun scripts/generate-openapi.ts",
|
|
@@ -45,8 +47,9 @@
|
|
|
45
47
|
"manifest:fetch": "bun scripts/update-agent-plugin-schemas.ts",
|
|
46
48
|
"manifest:check": "bun scripts/validate-plugin-manifests.ts",
|
|
47
49
|
"release:test": "bun scripts/ci/test-release-pr-auto-merge.ts && bun scripts/ci/test-release-workflows.ts",
|
|
48
|
-
"check": "bun run manifest:check && bun run api:check && bun run typecheck && bun run build && bun test && bun run release:test && bun run package:check",
|
|
49
|
-
"prepublishOnly": "bun run check"
|
|
50
|
+
"check": "bun run manifest:check && bun run api:check && bun run lint && bun run typecheck && bun run build && bun test && bun run release:test && bun run package:check",
|
|
51
|
+
"prepublishOnly": "bun run check",
|
|
52
|
+
"lint": "bun ./node_modules/eslint/bin/eslint.js src scripts --max-warnings=0"
|
|
50
53
|
},
|
|
51
54
|
"dependencies": {
|
|
52
55
|
"@modelcontextprotocol/sdk": "1.30.0",
|
|
@@ -58,6 +61,10 @@
|
|
|
58
61
|
"json-schema-to-zod": "2.8.1",
|
|
59
62
|
"openapi-typescript": "7.13.0",
|
|
60
63
|
"typescript": "5.9.3",
|
|
61
|
-
"yaml": "2.9.1"
|
|
62
|
-
|
|
64
|
+
"yaml": "2.9.1",
|
|
65
|
+
"@eslint/js": "10.0.1",
|
|
66
|
+
"eslint": "10.11.0",
|
|
67
|
+
"typescript-eslint": "8.70.1"
|
|
68
|
+
},
|
|
69
|
+
"packageManager": "bun@1.3.14"
|
|
63
70
|
}
|
package/plugin.json
CHANGED