@jurislm/woodpecker-ci-plugin 2.0.5 → 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.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "woodpecker-ci",
3
- "version": "2.0.5",
3
+ "version": "2.1.0",
4
4
  "description": "Manage Woodpecker CI through agent tools.",
5
5
  "author": {
6
6
  "name": "JurisLM",
package/.mcp.json CHANGED
@@ -3,7 +3,8 @@
3
3
  "woodpecker-ci": {
4
4
  "type": "stdio",
5
5
  "command": "bunx",
6
- "args": ["-y", "@jurislm/woodpecker-ci-plugin@latest"]
6
+ "args": ["-y", "@jurislm/woodpecker-ci-plugin@latest"],
7
+ "env_vars": ["WOODPECKER_URL", "WOODPECKER_API_TOKEN"]
7
8
  }
8
9
  }
9
10
  }
package/README.md CHANGED
@@ -85,19 +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
- If an existing `~/.zshenv` exports the token, this local Codex configuration
89
- launches the MCP server through zsh without copying the token into Codex config
90
- or this repository. Replace the example URL with your Woodpecker API URL:
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:
91
107
 
92
108
  ```toml
93
109
  [mcp_servers.woodpecker-ci]
94
110
  command = "/bin/zsh"
95
- args = ["-c", "exec /usr/bin/python3 -c 'import os; keys=(\"HOME\",\"PATH\",\"TMPDIR\",\"WOODPECKER_API_TOKEN\"); env={k:os.environ[k] for k in keys if k in os.environ}; env[\"WOODPECKER_URL\"]=\"https://ci.example.com/api\"; path=env[\"HOME\"]+\"/.bun/bin/bunx\"; os.execve(path,[path,\"-y\",\"@jurislm/woodpecker-ci-plugin@latest\"],env)'"]
111
+ args = ["-f", "/absolute/path/to/.codex/bin/woodpecker-mcp.zsh"]
96
112
  required = true
97
113
  startup_timeout_sec = 30
114
+
115
+ [mcp_servers.woodpecker-ci.env]
116
+ WOODPECKER_URL = "https://ci.example.com/api"
117
+
118
+ [plugins."woodpecker-ci@woodpecker-ci-marketplace".mcp_servers.woodpecker-ci]
119
+ enabled = false
98
120
  ```
99
121
 
100
- This example needs `/usr/bin/python3` and Bun at `$HOME/.bun/bin/bunx`; replace either absolute path if needed. Python passes the token through `execve` environment, never a command argument.
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.
101
127
 
102
128
  `required = true` waits for this MCP server during tool discovery. Check
103
129
  `codex mcp get woodpecker-ci`, then open a new Codex task and confirm that its
@@ -105,6 +131,9 @@ Woodpecker tools are present and an authenticated read succeeds. A successful
105
131
  local stdio check alone does not verify the task's tool catalog. Keep token
106
132
  values out of repository files and diagnostic output.
107
133
 
134
+ See the [JurisLM Plugin Architecture v1](docs/plugin-architecture.md) for shared
135
+ packaging, configuration, release and acceptance rules.
136
+
108
137
  ## Cursor installation
109
138
 
110
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, String(item));
43
+ url.searchParams.append(name, queryValue(item));
31
44
  return;
32
45
  }
33
- url.searchParams.set(name, typeof value === "object" ? JSON.stringify(value) : String(value));
46
+ url.searchParams.set(name, queryValue(value));
34
47
  }
35
48
  function decodeBinary(bytes, contentType) {
36
49
  return {
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
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.5",
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
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
3
3
  "name": "woodpecker-ci",
4
- "version": "2.0.5",
4
+ "version": "2.1.0",
5
5
  "description": "Manage Woodpecker CI through agent tools.",
6
6
  "author": {
7
7
  "name": "JurisLM",