@pogo-vcs/pogo 0.9.0 → 0.10.3
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 +44 -7
- package/package.json +13 -13
package/README.md
CHANGED
|
@@ -95,6 +95,7 @@ For running the server, you need to have a PostgreSQL database running and the f
|
|
|
95
95
|
- `PORT` or `HOST`: The port or host to listen on.
|
|
96
96
|
- `ROOT_TOKEN`: *optional* The root token for the server.
|
|
97
97
|
- `GC_MEMORY_THRESHOLD`: *optional* The number of files to use as the threshold for which garbage collection implementations will run (in memory vs batch processing).
|
|
98
|
+
- `CI_RUN_RETENTION`: *optional* How long CI run logs are retained before being deleted during garbage collection (Go duration format, default `720h`).
|
|
98
99
|
|
|
99
100
|
## 📋 Commands
|
|
100
101
|
|
|
@@ -104,18 +105,41 @@ For running the server, you need to have a PostgreSQL database running and the f
|
|
|
104
105
|
| `pogo bookmark` | | `b` | Manage bookmarks. |
|
|
105
106
|
| | `set` | `s` | Set a bookmark to a specific change. If no change is specified, the current change is used. |
|
|
106
107
|
| | `list` | `l` | List all bookmarks. |
|
|
108
|
+
| `pogo ci` | | | Manage CI pipelines. |
|
|
109
|
+
| | `test` | | Test a CI pipeline configuration. |
|
|
110
|
+
| | `runs` | | Inspect recorded CI runs. |
|
|
111
|
+
| | `runs list`| | List CI runs for the current repository. |
|
|
112
|
+
| | `runs inspect` | | Show the detailed log output for a CI run. |
|
|
113
|
+
| `pogo clone` | | | Clone a repository from a Pogo server. |
|
|
107
114
|
| `pogo commit` | | | Combines `describe`, `push`, and `new` into a single command. |
|
|
115
|
+
| `pogo daemon` | | `service` | Manage Pogo daemon service. |
|
|
116
|
+
| | `install` | | Install Pogo daemon service. |
|
|
117
|
+
| | `stop` | | Stop the Pogo daemon service. |
|
|
118
|
+
| | `start` | | Start the Pogo daemon service. |
|
|
119
|
+
| | `uninstall`| | Uninstall Pogo daemon service. |
|
|
108
120
|
| `pogo describe` | | `desc`, `rephrase` | Set the description for the current change. |
|
|
121
|
+
| `pogo diff` | | | Show differences between changes in unified diff format. |
|
|
109
122
|
| `pogo edit` | | `checkout` | Sets the specified revision as the working-copy revision. |
|
|
110
123
|
| `pogo gc` | | | Run garbage collection on the server. |
|
|
111
|
-
| `pogo info`
|
|
112
|
-
| `pogo init`
|
|
113
|
-
| `pogo
|
|
114
|
-
| `
|
|
115
|
-
| `
|
|
116
|
-
| `pogo
|
|
124
|
+
| `pogo info` | | | Display the current working copy status. |
|
|
125
|
+
| `pogo init` | | | Initialize a new repository. |
|
|
126
|
+
| `pogo invite` | | `inv` | Manage user invitations. |
|
|
127
|
+
| | `create` | | Create a new invitation link. |
|
|
128
|
+
| | `list` | `ls`, `l` | List all invitations you have created. |
|
|
129
|
+
| `pogo log` | | | Show the change history. |
|
|
130
|
+
| `pogo new` | | | Create a new change based on one or more parent changes. |
|
|
131
|
+
| `pogo visibility` | | | Set repository visibility to public or private. |
|
|
132
|
+
| `pogo push` | | | Push a change to the repository. |
|
|
117
133
|
| `pogo rm` | | | Remove a change from the repository. |
|
|
134
|
+
| `pogo secrets` | | | Manage repository secrets for CI pipelines. |
|
|
135
|
+
| | `list` | `l` | List all secrets in the repository. |
|
|
136
|
+
| | `get` | `g` | Get the value of a secret. |
|
|
137
|
+
| | `set` | `s` | Set a secret value. |
|
|
138
|
+
| | `delete` | `d`, `rm`, `remove`| Delete a secret. |
|
|
118
139
|
| `pogo serve` | | | Start the Pogo server. |
|
|
140
|
+
| `pogo token` | | | Manage personal access tokens. |
|
|
141
|
+
| | `set` | | Set or update a personal access token for a server. |
|
|
142
|
+
| | `remove` | | Remove a personal access token for a server. |
|
|
119
143
|
| `pogo whoami` | | | Show the personal access token being used for the current repository. |
|
|
120
144
|
|
|
121
145
|
## 🏗️ Architecture
|
|
@@ -138,7 +162,20 @@ The garbage collection system uses an adaptive strategy based on the total numbe
|
|
|
138
162
|
- **Small-scale (< 10 million files):** Uses an in-memory hash map strategy for fast O(1) lookups.
|
|
139
163
|
- **Large-scale (≥ 10 million files):** Uses a batch processing strategy that scales to billions of files with constant memory usage.
|
|
140
164
|
|
|
141
|
-
The threshold can be configured via the `GC_MEMORY_THRESHOLD` environment variable.
|
|
165
|
+
The threshold can be configured via the `GC_MEMORY_THRESHOLD` environment variable. CI run logs are cleaned up during this process; the retention window is controlled by `CI_RUN_RETENTION` (default 30 days).
|
|
166
|
+
|
|
167
|
+
## 🔐 Secrets Management
|
|
168
|
+
|
|
169
|
+
Pogo provides a secure way to manage secrets for your CI pipelines. Secrets are encrypted values that can be referenced in your CI pipeline YAML files using the <code>{{ secret "KEY" }}</code> template function. They are useful for storing sensitive data like API tokens, deployment keys, and credentials.
|
|
170
|
+
|
|
171
|
+
Secrets are scoped to a repository and can only be accessed by users with access to that repository.
|
|
172
|
+
|
|
173
|
+
### How to Use
|
|
174
|
+
|
|
175
|
+
- **Set a secret:** `pogo secrets set MY_SECRET_KEY "my_secret_value"`
|
|
176
|
+
- **Get a secret:** `pogo secrets get MY_SECRET_KEY`
|
|
177
|
+
- **List secrets:** `pogo secrets list`
|
|
178
|
+
- **Delete a secret:** `pogo secrets delete MY_SECRET_KEY`
|
|
142
179
|
|
|
143
180
|
## 📜 License
|
|
144
181
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pogo-vcs/pogo",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.10.3",
|
|
4
4
|
"description": "A centralized version control system that is simple and easy to use.",
|
|
5
5
|
"scripts": {
|
|
6
6
|
"postinstall": "node install.js",
|
|
@@ -37,74 +37,74 @@
|
|
|
37
37
|
"archives": {
|
|
38
38
|
"darwin-arm64": {
|
|
39
39
|
"name": "pogo_Darwin_arm64.tar.gz",
|
|
40
|
-
"url": "https://github.com/pogo-vcs/pogo/releases/download/v0.
|
|
40
|
+
"url": "https://github.com/pogo-vcs/pogo/releases/download/v0.10.3/pogo_Darwin_arm64.tar.gz",
|
|
41
41
|
"bins": [
|
|
42
42
|
"pogo"
|
|
43
43
|
],
|
|
44
44
|
"format": "tar.gz",
|
|
45
45
|
"checksum": {
|
|
46
46
|
"algorithm": "sha256",
|
|
47
|
-
"digest": "
|
|
47
|
+
"digest": "3adc3cc8a053052d25ad41790f17b83b323bb2132abf3f99e8f5a06d7d6988df"
|
|
48
48
|
}
|
|
49
49
|
},
|
|
50
50
|
"darwin-x64": {
|
|
51
51
|
"name": "pogo_Darwin_x86_64.tar.gz",
|
|
52
|
-
"url": "https://github.com/pogo-vcs/pogo/releases/download/v0.
|
|
52
|
+
"url": "https://github.com/pogo-vcs/pogo/releases/download/v0.10.3/pogo_Darwin_x86_64.tar.gz",
|
|
53
53
|
"bins": [
|
|
54
54
|
"pogo"
|
|
55
55
|
],
|
|
56
56
|
"format": "tar.gz",
|
|
57
57
|
"checksum": {
|
|
58
58
|
"algorithm": "sha256",
|
|
59
|
-
"digest": "
|
|
59
|
+
"digest": "46b35999b52cd9387905314447ebaa5643dcebee8c60bcfc4fad0b53c719488d"
|
|
60
60
|
}
|
|
61
61
|
},
|
|
62
62
|
"linux-arm64": {
|
|
63
63
|
"name": "pogo_Linux_arm64.tar.gz",
|
|
64
|
-
"url": "https://github.com/pogo-vcs/pogo/releases/download/v0.
|
|
64
|
+
"url": "https://github.com/pogo-vcs/pogo/releases/download/v0.10.3/pogo_Linux_arm64.tar.gz",
|
|
65
65
|
"bins": [
|
|
66
66
|
"pogo"
|
|
67
67
|
],
|
|
68
68
|
"format": "tar.gz",
|
|
69
69
|
"checksum": {
|
|
70
70
|
"algorithm": "sha256",
|
|
71
|
-
"digest": "
|
|
71
|
+
"digest": "1637ca16d2cfe23cf30a6bee6b9b5f35fe620b548ef3fa6421433429bfbb53d0"
|
|
72
72
|
}
|
|
73
73
|
},
|
|
74
74
|
"linux-x64": {
|
|
75
75
|
"name": "pogo_Linux_x86_64.tar.gz",
|
|
76
|
-
"url": "https://github.com/pogo-vcs/pogo/releases/download/v0.
|
|
76
|
+
"url": "https://github.com/pogo-vcs/pogo/releases/download/v0.10.3/pogo_Linux_x86_64.tar.gz",
|
|
77
77
|
"bins": [
|
|
78
78
|
"pogo"
|
|
79
79
|
],
|
|
80
80
|
"format": "tar.gz",
|
|
81
81
|
"checksum": {
|
|
82
82
|
"algorithm": "sha256",
|
|
83
|
-
"digest": "
|
|
83
|
+
"digest": "38367b5a36f00e27dee453f47289004d857009535e02dce64e474f907c0c607c"
|
|
84
84
|
}
|
|
85
85
|
},
|
|
86
86
|
"win32-arm64": {
|
|
87
87
|
"name": "pogo_Windows_arm64.zip",
|
|
88
|
-
"url": "https://github.com/pogo-vcs/pogo/releases/download/v0.
|
|
88
|
+
"url": "https://github.com/pogo-vcs/pogo/releases/download/v0.10.3/pogo_Windows_arm64.zip",
|
|
89
89
|
"bins": [
|
|
90
90
|
"pogo.exe"
|
|
91
91
|
],
|
|
92
92
|
"format": "zip",
|
|
93
93
|
"checksum": {
|
|
94
94
|
"algorithm": "sha256",
|
|
95
|
-
"digest": "
|
|
95
|
+
"digest": "75ab4d843edca78cd0513e45b79a58f45187d6598d49559fd8b224be6ef2d69a"
|
|
96
96
|
}
|
|
97
97
|
},
|
|
98
98
|
"win32-x64": {
|
|
99
99
|
"name": "pogo_Windows_x86_64.zip",
|
|
100
|
-
"url": "https://github.com/pogo-vcs/pogo/releases/download/v0.
|
|
100
|
+
"url": "https://github.com/pogo-vcs/pogo/releases/download/v0.10.3/pogo_Windows_x86_64.zip",
|
|
101
101
|
"bins": [
|
|
102
102
|
"pogo.exe"
|
|
103
103
|
],
|
|
104
104
|
"format": "zip",
|
|
105
105
|
"checksum": {
|
|
106
106
|
"algorithm": "sha256",
|
|
107
|
-
"digest": "
|
|
107
|
+
"digest": "512eff153ffcd1d60ddbe73953a0f7ae098b5746eb3740279e7dbc7b983a501b"
|
|
108
108
|
}
|
|
109
109
|
}
|
|
110
110
|
}
|