@colony2/gitvend 0.0.8 → 0.0.9

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/README.md CHANGED
@@ -16,7 +16,7 @@ The gateway supports GitHub and GitHub Enterprise-compatible endpoints. It needs
16
16
  no database or GitHub App. Agents connect over HTTPS; GitHub's own access and
17
17
  branch rules continue to apply.
18
18
 
19
- [Set up and use the gateway →](https://github.com/colony-2/gitvend/blob/v0.0.8/docs/gateway.md)
19
+ [Set up and use the gateway →](https://github.com/colony-2/gitvend/blob/v0.0.9/docs/gateway.md)
20
20
 
21
21
  ## JobDB plugin
22
22
 
@@ -29,7 +29,7 @@ The plugin keeps its signing key on the JobDB host, and the gateway verifies the
29
29
  resulting tokens with the matching public key. Workers receive neither the
30
30
  signing key nor the upstream GitHub token.
31
31
 
32
- [Set up the JobDB plugin →](https://github.com/colony-2/gitvend/blob/v0.0.8/docs/jobdb-secret-provider.md)
32
+ [Set up the JobDB plugin →](https://github.com/colony-2/gitvend/blob/v0.0.9/docs/jobdb-secret-provider.md)
33
33
 
34
34
  ## Install
35
35
 
@@ -52,13 +52,13 @@ that includes `jobdb-gitvend-secret-provider` when using the plugin; older packa
52
52
  may contain only `gitvend`.
53
53
 
54
54
  For a container deployment, use the published image with the
55
- [Docker Compose guide](https://github.com/colony-2/gitvend/blob/v0.0.8/docs/docker-compose.md).
55
+ [Docker Compose guide](https://github.com/colony-2/gitvend/blob/v0.0.9/docs/docker-compose.md).
56
56
 
57
57
  ## Guides
58
58
 
59
- - [Gateway setup, Git usage, and operations](https://github.com/colony-2/gitvend/blob/v0.0.8/docs/gateway.md)
60
- - [Repository creation controls](https://github.com/colony-2/gitvend/blob/v0.0.8/docs/gateway.md#repository-creation-defaults)
61
- - [JobDB plugin setup and issuer configuration](https://github.com/colony-2/gitvend/blob/v0.0.8/docs/jobdb-secret-provider.md)
62
- - [Permission syntax](https://github.com/colony-2/gitvend/blob/v0.0.8/docs/permission-syntax.md)
63
- - [Docker Compose deployment](https://github.com/colony-2/gitvend/blob/v0.0.8/docs/docker-compose.md)
64
- - [Developer guide: source builds, tests, and releases](https://github.com/colony-2/gitvend/blob/v0.0.8/docs/development.md)
59
+ - [Gateway setup, Git usage, and operations](https://github.com/colony-2/gitvend/blob/v0.0.9/docs/gateway.md)
60
+ - [Repository creation controls](https://github.com/colony-2/gitvend/blob/v0.0.9/docs/gateway.md#repository-creation-defaults)
61
+ - [JobDB plugin setup and issuer configuration](https://github.com/colony-2/gitvend/blob/v0.0.9/docs/jobdb-secret-provider.md)
62
+ - [Permission syntax](https://github.com/colony-2/gitvend/blob/v0.0.9/docs/permission-syntax.md)
63
+ - [Docker Compose deployment](https://github.com/colony-2/gitvend/blob/v0.0.9/docs/docker-compose.md)
64
+ - [Developer guide: source builds, tests, and releases](https://github.com/colony-2/gitvend/blob/v0.0.9/docs/development.md)
package/docs/gateway.md CHANGED
@@ -132,10 +132,12 @@ Expected response: `ok`. This is a liveness check; it does not verify a JWT or c
132
132
  The remote URL has this structure:
133
133
 
134
134
  ```text
135
- https://GATEWAY/PROVIDER_ALIAS/OWNER/REPOSITORY.git
135
+ https://GATEWAY/PROVIDER_ALIAS/OWNER/REPOSITORY[.git]
136
136
  https://git-gateway.example:8443/github/fooorg/project.git
137
137
  ```
138
138
 
139
+ The `.git` suffix is optional for discovery, fetch and push. Both URL forms use the same repository identity, credentials and permissions; `[.git]` above denotes optional text, not literal brackets.
140
+
139
141
  The `github` segment is the configured provider alias. Permission strings use the configured upstream authority (`github.com`), not that alias or the gateway hostname. Repository permission patterns omit the `.git` suffix. Add more provider entries for distinct GitHub-compatible endpoints or owner/credential mappings; overlapping host/owner routes are rejected. Other forge APIs require an adapter.
140
142
 
141
143
  ### Running behind a TLS terminator
@@ -415,7 +417,7 @@ Start with `gitvend version`, `/healthz`, and `git ls-remote --heads` as shown a
415
417
  | `Git protocol v2 required` | Set `protocol.version=2`; ensure an ingress proxy preserves the `Git-Protocol` header. Pushes still use standard receive-pack. |
416
418
  | HTTP 403 / `push denied for ...` | Inspect the exact destination ref, matching `r` plus `w`/`d` grants, issuer/owner limits and gateway denies. The sample denies writes to main/master. |
417
419
  | No refs shown; clone cannot find main or remote HEAD | The requested branch may be absent or hidden. Use an explicitly permitted branch with `--branch`; new scratch repos may have only `agents/47/start`. |
418
- | HTTP 404 / unsupported route or missing repository | Use `/alias/owner/repo.git`, check allowed owners, and verify the upstream identity can see the repository. Only authorized push discovery can create a missing repo. |
420
+ | HTTP 404 / unsupported route or missing repository | Use `/alias/owner/repo` or `/alias/owner/repo.git`, check allowed owners, and verify the upstream identity can see the repository. Only authorized push discovery can create a missing repo. |
419
421
  | Missing repo is not created | Check `allow_creation`, `c`, overlapping branch `rw`, owner limits and upstream organization permissions. Check the audit logs for an unconfirmed create attempt. |
420
422
  | HTTP 429 / gateway busy | The concurrent-request limit is reached. Wait for active requests to finish and retry. |
421
423
  | HTTP 409 / creation visibility violation | A creation attempt resolved to unexpected visibility. Investigate the upstream name/visibility; gitvend will not alter it automatically. |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@colony2/gitvend",
3
- "version": "0.0.8",
3
+ "version": "0.0.9",
4
4
  "description": "Git HTTPS gateway with signed repository and branch permissions",
5
5
  "license": "UNLICENSED",
6
6
  "homepage": "https://github.com/colony-2/gitvend",