@nanocollective/roster 0.1.0-beta.6 → 0.1.0-beta.7
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/dist/worker/assets/assets/css/home.css +10 -2
- package/dist/worker/assets/assets/css/layout.css +6 -0
- package/dist/worker/index.js +1 -1
- package/docs/commands.md +29 -8
- package/docs/getting-started.md +5 -2
- package/package.json +1 -1
- package/templates/portal/css/home.css +10 -2
- package/templates/portal/css/layout.css +6 -0
package/docs/commands.md
CHANGED
|
@@ -269,15 +269,19 @@ ROSTER_CONTEXT='{"issue_number":"1","comment_id":"1","repo":"o/r"}' \
|
|
|
269
269
|
|
|
270
270
|
## `roster portal`
|
|
271
271
|
|
|
272
|
-
Serve
|
|
273
|
-
|
|
274
|
-
|
|
272
|
+
Serve the portal on your machine. **`roster` with no arguments does the same**, which is the
|
|
273
|
+
shortest way in. It takes the same flags: `roster --no-open` is `roster portal --no-open`.
|
|
274
|
+
|
|
275
|
+
It reads the org from GitHub as you, with your `gh` login (or `GITHUB_TOKEN`), so it needs no
|
|
276
|
+
checkout to show it. Setting up, hiring, retiring and Health use the checkout.
|
|
275
277
|
|
|
276
278
|
```
|
|
277
|
-
--port <n>
|
|
278
|
-
--host <a>
|
|
279
|
-
--dir <path>
|
|
280
|
-
--no
|
|
279
|
+
--port <n> default 4300
|
|
280
|
+
--host <a> default 127.0.0.1. Anything else exposes write actions to the network.
|
|
281
|
+
--dir <path> where a tenant would be created or checked out. Default: here.
|
|
282
|
+
--org <org> show this org, with no checkout. Default: the checkout's org.yaml.
|
|
283
|
+
--ops-repo <n> its ops repo, with --org. Default: roster-ops.
|
|
284
|
+
--no-open don't open a browser
|
|
281
285
|
```
|
|
282
286
|
|
|
283
287
|
It opens the page in your browser when it starts. It stays closed in CI, over SSH, when output
|
|
@@ -288,11 +292,28 @@ checks out one that already runs roster. Local only. See [the portal](portal.md)
|
|
|
288
292
|
|
|
289
293
|
Views: Home, Trackers, Runs, Org, Staff, Docs, and per staff member Brain, Prompt, Graph, What changed, Health.
|
|
290
294
|
|
|
291
|
-
It can act as you
|
|
295
|
+
It can act as you: reply, close, reopen and open issues; hire and retire;
|
|
292
296
|
edit and commit the org layer, prompt fragments and charters; create a staff member's GitHub App;
|
|
293
297
|
store the agent credential; set the ops repo's Actions access; start one run and follow it; and
|
|
294
298
|
copy a prompt for authoring the two files nothing can generate.
|
|
295
299
|
|
|
300
|
+
## `roster portal deploy`
|
|
301
|
+
|
|
302
|
+
The same portal on your own URL, on Cloudflare Workers, behind Sign in with GitHub. Only the
|
|
303
|
+
people in `org.yaml`'s `humans:` can sign in, and each acts as themselves. Setting up, hiring
|
|
304
|
+
and Health stay on your machine.
|
|
305
|
+
|
|
306
|
+
```
|
|
307
|
+
--domain <host> where it lives, on a zone in your Cloudflare account. Needed the first time.
|
|
308
|
+
--account <id> the Cloudflare account, pinned so a deploy cannot land on another one
|
|
309
|
+
--apply deploy. Without it, says what it would do.
|
|
310
|
+
--ci no questions: deploy what portal/wrangler.jsonc says (the workflow uses this)
|
|
311
|
+
```
|
|
312
|
+
|
|
313
|
+
The first deploy walks you through creating the GitHub OAuth App, then writes
|
|
314
|
+
`portal/wrangler.jsonc` and a workflow that redeploys every morning. See
|
|
315
|
+
[hosting the portal](hosting.md).
|
|
316
|
+
|
|
296
317
|
## `roster export`
|
|
297
318
|
|
|
298
319
|
The whole org as one JSON document.
|
package/docs/getting-started.md
CHANGED
|
@@ -22,8 +22,9 @@ hour is the part not to rush.
|
|
|
22
22
|
|
|
23
23
|
## Before you start
|
|
24
24
|
|
|
25
|
-
- **`gh`, [signed in](https://cli.github.com)**, as someone who owns the organisation.
|
|
26
|
-
|
|
25
|
+
- **`gh`, [signed in](https://cli.github.com)**, as someone who owns the organisation. Setting
|
|
26
|
+
up, hiring and the GitHub Apps go through your own `gh`, and the portal on your machine uses
|
|
27
|
+
its token to act as you. roster keeps no token of its own.
|
|
27
28
|
- **A GitHub organisation.** GitHub has no API for creating one, so if you need one, make it on
|
|
28
29
|
github.com first. Brains are private repos; on GitHub Free that works, with one difference in
|
|
29
30
|
step 5.
|
|
@@ -187,3 +188,5 @@ each.
|
|
|
187
188
|
- **A framework update**: `roster upgrade`, or the same from the portal. See
|
|
188
189
|
[upgrading](upgrading.md).
|
|
189
190
|
- **The whole portal**, screen by screen: [the portal](portal.md).
|
|
191
|
+
- **The portal on your own URL**, so you can answer your staff from anywhere, your phone
|
|
192
|
+
included: `roster portal deploy`. See [hosting the portal](hosting.md).
|
package/package.json
CHANGED
|
@@ -67,8 +67,8 @@
|
|
|
67
67
|
.homerunlog .ghbtn{min-height:28px;padding:3px 12px}
|
|
68
68
|
@media (max-width:640px){
|
|
69
69
|
.homerun{grid-template-columns:1fr auto;grid-template-areas:"who state" "what what" "log log"}
|
|
70
|
-
.homewho2{grid-area:who}.homestate{grid-area:state;justify-self:end}
|
|
71
|
-
.homerunwhat{grid-area:what}.homerunlog{grid-area:log}
|
|
70
|
+
.homerun .homewho2{grid-area:who}.homerun .homestate{grid-area:state;justify-self:end}
|
|
71
|
+
.homerun .homerunwhat{grid-area:what}.homerun .homerunlog{grid-area:log}
|
|
72
72
|
}
|
|
73
73
|
|
|
74
74
|
.homerest{margin-top:26px}
|
|
@@ -102,3 +102,11 @@
|
|
|
102
102
|
.homeline:hover .homerowtitle{text-decoration:underline}
|
|
103
103
|
.homeline:focus-visible{outline:2px solid var(--accent);outline-offset:2px;border-radius:6px}
|
|
104
104
|
.homerowtitle{font-weight:600;color:var(--ink)}
|
|
105
|
+
|
|
106
|
+
/* On a phone the lists use the width: last in the file, so it wins over each list's own padding. */
|
|
107
|
+
@media (max-width:640px){
|
|
108
|
+
.homelist,.homeworking,.homereports{padding-left:14px;padding-right:14px}
|
|
109
|
+
.homeline{grid-template-columns:8px minmax(0,1fr)}
|
|
110
|
+
.homeline .homerunlog{grid-column:2}
|
|
111
|
+
.homeline .homerunlog:empty{display:none}
|
|
112
|
+
}
|
|
@@ -150,6 +150,12 @@ main{padding:36px 44px 96px;max-width:1220px;overflow-x:clip}
|
|
|
150
150
|
.side{position:static;height:auto;border-right:none;border-bottom:1px solid var(--line)}
|
|
151
151
|
.sidefoot{margin-top:0}
|
|
152
152
|
}
|
|
153
|
+
/* A phone: the page uses its width. 44px a side was a desktop gutter, and on a phone it took
|
|
154
|
+
a quarter of the screen, with a card's own padding inside it again. */
|
|
155
|
+
@media (max-width:640px){
|
|
156
|
+
main{padding:20px 16px 64px}
|
|
157
|
+
.card{padding:14px}
|
|
158
|
+
}
|
|
153
159
|
|
|
154
160
|
/* A staff member who cannot run yet (readiness.js). */
|
|
155
161
|
.readydot{width:7px;height:7px;border-radius:50%;background:var(--warn);flex:none;margin-left:4px}
|