@sealant/mend 0.36.0 → 0.37.0-next.1197
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 +1 -1
- package/dist/{chunk-MY3TCM3Q.js → chunk-EX5C6Y5A.js} +12331 -8950
- package/dist/{dashboard-7QWLVA5J.js → dashboard-3WCED6AO.js} +4 -2
- package/dist/main.js +15851 -4283
- package/man/mend-accounts.1 +1 -1
- package/man/mend-adopt.1 +1 -1
- package/man/mend-agent-logins.1 +1 -1
- package/man/mend-attach.1 +1 -1
- package/man/mend-codex.1 +1 -1
- package/man/mend-completions.1 +1 -1
- package/man/mend-connect-pi.1 +1 -1
- package/man/mend-connect.1 +4 -4
- package/man/mend-continue.1 +1 -1
- package/man/mend-doctor.1 +1 -1
- package/man/mend-dotfiles-repo.1 +1 -1
- package/man/mend-dotfiles-sync.1 +1 -1
- package/man/mend-dotfiles.1 +1 -1
- package/man/mend-env-cluster.1 +1 -1
- package/man/mend-env-load.1 +2 -2
- package/man/mend-env-show.1 +1 -1
- package/man/mend-folder-create.1 +1 -1
- package/man/mend-folder-list.1 +1 -1
- package/man/mend-folder-push.1 +1 -1
- package/man/mend-folder-rm.1 +1 -1
- package/man/mend-git-author.1 +1 -1
- package/man/mend-handoff.1 +1 -1
- package/man/mend-help.1 +1 -1
- package/man/mend-invite.1 +1 -1
- package/man/mend-keys-init.1 +1 -1
- package/man/mend-keys-mode.1 +1 -1
- package/man/mend-keys-share.1 +1 -1
- package/man/mend-keys-show.1 +1 -1
- package/man/mend-land.1 +1 -1
- package/man/mend-login.1 +1 -1
- package/man/mend-logout.1 +1 -1
- package/man/mend-logs.1 +1 -1
- package/man/mend-man.1 +1 -1
- package/man/mend-members.1 +1 -1
- package/man/mend-memory-import.1 +1 -1
- package/man/mend-memory-rm.1 +1 -1
- package/man/mend-memory-show.1 +1 -1
- package/man/mend-memory.1 +1 -1
- package/man/mend-message.1 +39 -0
- package/man/mend-models.1 +1 -1
- package/man/mend-operator-exposure.1 +2 -2
- package/man/mend-operator-gate.1 +1 -1
- package/man/mend-operator-grant-owner.1 +1 -1
- package/man/mend-operator-org-create.1 +1 -1
- package/man/mend-operator-org-invite-owner.1 +1 -1
- package/man/mend-operator-org-list.1 +1 -1
- package/man/mend-operator-org-rename.1 +1 -1
- package/man/mend-operator-reset-link.1 +1 -1
- package/man/mend-pair.1 +1 -1
- package/man/mend-projects.1 +10 -2
- package/man/mend-pull.1 +1 -1
- package/man/mend-refresh.1 +1 -1
- package/man/mend-rejoin.1 +1 -1
- package/man/mend-resource-add.1 +43 -0
- package/man/mend-resource-approve.1 +38 -0
- package/man/mend-resource-list.1 +23 -0
- package/man/mend-resource-remove.1 +27 -0
- package/man/mend-resource-start.1 +15 -0
- package/man/mend-resource-use.1 +18 -0
- package/man/mend-resume.1 +1 -1
- package/man/mend-run.1 +1 -1
- package/man/mend-secrets-add.1 +1 -1
- package/man/mend-secrets-rm.1 +1 -1
- package/man/mend-secrets.1 +1 -1
- package/man/mend-server-logs.1 +1 -1
- package/man/mend-server-restart.1 +1 -1
- package/man/mend-server-setup.1 +37 -4
- package/man/mend-server-start.1 +1 -1
- package/man/mend-server-status.1 +1 -1
- package/man/mend-server-stop.1 +1 -1
- package/man/mend-server-upgrade.1 +1 -1
- package/man/mend-server.1 +1 -1
- package/man/mend-service-add.1 +1 -1
- package/man/mend-service-connect.1 +1 -1
- package/man/mend-service-init.1 +2 -2
- package/man/mend-service-list.1 +1 -1
- package/man/mend-service-logs.1 +1 -1
- package/man/mend-service-restart.1 +1 -1
- package/man/mend-service-run.1 +6 -3
- package/man/mend-service-stop.1 +2 -2
- package/man/mend-session-share.1 +1 -1
- package/man/mend-sessions.1 +1 -1
- package/man/mend-settings.1 +32 -0
- package/man/mend-shell.1 +1 -1
- package/man/mend-skills-push.1 +1 -1
- package/man/mend-skills.1 +1 -1
- package/man/mend-snake.1 +1 -1
- package/man/mend-ssh-keys-remove.1 +1 -1
- package/man/mend-ssh-keys.1 +1 -1
- package/man/mend-ssh-setup.1 +1 -1
- package/man/mend-ssh.1 +1 -1
- package/man/mend-stop.1 +1 -1
- package/man/mend-ui.1 +1 -1
- package/man/mend-uninstall.1 +1 -1
- package/man/mend-version.1 +1 -1
- package/man/mend-wait.1 +1 -1
- package/man/mend-workspace-replace.1 +1 -1
- package/man/mend-worktrees-rm.1 +1 -1
- package/man/mend-worktrees.1 +1 -1
- package/man/mend.1 +27 -3
- package/package.json +2 -2
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
.TH MEND-RESOURCE-START 1 "" "mend 0.37.0\-next.1197" "mend manual"
|
|
2
|
+
.SH NAME
|
|
3
|
+
mend\-resource\-start \- start a resource's instance
|
|
4
|
+
.SH SYNOPSIS
|
|
5
|
+
.B mend resource start <name> [\-\-project <p>]
|
|
6
|
+
.br
|
|
7
|
+
.SH DESCRIPTION
|
|
8
|
+
.PP
|
|
9
|
+
Refused on every runtime this Mend reaches: resources need a newer Sealant there. A session can run its own [service.<name>] instead. Nothing is started.
|
|
10
|
+
.SH OPTIONS
|
|
11
|
+
.TP
|
|
12
|
+
.B \-\-project <p>
|
|
13
|
+
the project by name, when the current directory is not inside it
|
|
14
|
+
.SH SEE ALSO
|
|
15
|
+
mend(1), mend\-resource\-list(1)
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
.TH MEND-RESOURCE-USE 1 "" "mend 0.37.0\-next.1197" "mend manual"
|
|
2
|
+
.SH NAME
|
|
3
|
+
mend\-resource\-use \- choose how a worktree uses a project resource
|
|
4
|
+
.SH SYNOPSIS
|
|
5
|
+
.B mend resource use <name> <off|shared|own> \-\-worktree <w> [\-\-project <p>]
|
|
6
|
+
.br
|
|
7
|
+
.SH DESCRIPTION
|
|
8
|
+
.PP
|
|
9
|
+
Stores the worktree's choice and prints the line it wrote: shared reaches the project's instance, own its own database or instance, off none. The choice is the worktree's change owner's: the owner of its first session. Nothing runs yet, so choosing starts, copies and moves nothing.
|
|
10
|
+
.SH OPTIONS
|
|
11
|
+
.TP
|
|
12
|
+
.B \-\-worktree <w>
|
|
13
|
+
the worktree, by name or id
|
|
14
|
+
.TP
|
|
15
|
+
.B \-\-project <p>
|
|
16
|
+
the project by name, when the current directory is not inside it
|
|
17
|
+
.SH SEE ALSO
|
|
18
|
+
mend(1), mend\-resource\-approve(1)
|
package/man/mend-resume.1
CHANGED
package/man/mend-run.1
CHANGED
package/man/mend-secrets-add.1
CHANGED
package/man/mend-secrets-rm.1
CHANGED
package/man/mend-secrets.1
CHANGED
package/man/mend-server-logs.1
CHANGED
package/man/mend-server-setup.1
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
.TH MEND-SERVER-SETUP 1 "" "mend 0.
|
|
1
|
+
.TH MEND-SERVER-SETUP 1 "" "mend 0.37.0\-next.1197" "mend manual"
|
|
2
2
|
.SH NAME
|
|
3
3
|
mend\-server\-setup \- install or change the local Mend server, guided
|
|
4
4
|
.SH SYNOPSIS
|
|
5
5
|
.B mend server setup
|
|
6
6
|
.br
|
|
7
|
-
.B mend server setup [\-\-yes] [\-\-context <name>] [\-\-version <version|latest>] [\-\-bind <ip>] [\-\-ssh\-bind <ip>] [\-\-url <origin>] [\-\-origin <origin>...] [\-\-port <n>] [\-\-ssh\-port <n>] [\-\-edge <host> | \-\-no\-edge] [\-\-exposure <loopback|private|public>] [\-\-tenancy <single|multi>] [\-\-declare <item>...] [\-\-undeclare <item>...] [\-\-t3\-gateway [\-\-t3\-gateway\-port <n>] [\-\-t3\-gateway\-origin <host> | \-\-no\-t3\-gateway\-origin] | \-\-no\-t3\-gateway] [\-\-npm\-mirror | \-\-no\-npm\-mirror] [\-\-npm\-mirror\-max\-size <size>] [\-\-docker\-mirror | \-\-no\-docker\-mirror] [\-\-docker\-mirror\-max\-size <size>] [\-\-docker\-hub\-username <name> \-\-docker\-hub\-token\-stdin \-\-docker\-hub\-public\-only | \-\-no\-docker\-hub\-login] [\-\-docker\-socket <path>] [\-\-assets\-dir <dir>] [\-\-offline] [\-\-allow\-userns | \-\-no\-allow\-userns]
|
|
7
|
+
.B mend server setup [\-\-yes] [\-\-context <name>] [\-\-version <version|latest>] [\-\-bind <ip>] [\-\-ssh\-bind <ip>] [\-\-url <origin>] [\-\-origin <origin>...] [\-\-port <n>] [\-\-ssh\-port <n>] [\-\-edge <host> | \-\-no\-edge] [\-\-exposure <loopback|private|public>] [\-\-tenancy <single|multi>] [\-\-declare <item>...] [\-\-undeclare <item>...] [\-\-t3\-gateway [\-\-t3\-gateway\-port <n>] [\-\-t3\-gateway\-origin <host> | \-\-no\-t3\-gateway\-origin] | \-\-no\-t3\-gateway] [\-\-preview\-domain <domain> \-\-preview\-certificate <file> \-\-preview\-key <file> | \-\-no\-preview\-domain] [\-\-preview\-tailnet [\-\-preview\-tailnet\-ports <list>] | \-\-no\-preview\-tailnet] [\-\-npm\-mirror | \-\-no\-npm\-mirror] [\-\-npm\-mirror\-max\-size <size>] [\-\-docker\-mirror | \-\-no\-docker\-mirror] [\-\-docker\-mirror\-max\-size <size>] [\-\-docker\-hub\-username <name> \-\-docker\-hub\-token\-stdin \-\-docker\-hub\-public\-only | \-\-no\-docker\-hub\-login] [\-\-docker\-socket <path>] [\-\-assets\-dir <dir>] [\-\-offline] [\-\-allow\-userns | \-\-no\-allow\-userns]
|
|
8
8
|
.br
|
|
9
9
|
.SH DESCRIPTION
|
|
10
10
|
.PP
|
|
@@ -16,12 +16,16 @@ Before anything is pulled, setup checks that Mend's web and SSH ports are free w
|
|
|
16
16
|
.PP
|
|
17
17
|
Checks a local Unix\-socket Docker context and the Compose plugin, downloads the compose and Postgres initialization assets for one Mend release, preserves existing data and secrets, and starts the server. Re\-running repairs the same pinned version. A changed \-\-version is refused; use mend server upgrade. Updating this CLI never updates an existing server pin.
|
|
18
18
|
.PP
|
|
19
|
-
The default listens only on localhost at http://localhost:3105. Non\-local access requires both \-\-bind and \-\-url. Every extra browser origin must be named with \-\-origin; setup never guesses from the request Host header or network interfaces. A fresh install refuses a public \-\-bind address: until the first account exists, registration is open to whoever reaches it first. On an existing install, setup says when Mend's port or workspace SSH is published on a public address while the exposure is not public. The questions offer only private addresses (a tailnet, a LAN or VPN, carrier\-grade NAT space) for a private network.
|
|
19
|
+
The default listens only on localhost at http://localhost:3105. Non\-local access requires both \-\-bind and \-\-url. An https \-\-url on a loopback \-\-bind is taken only for this machine's own MagicDNS name (*.ts.net), with Mend's web port served by tailscale serve \-\-https=443 on this machine, the way setup offers for previews on the tailnet; \-\-exposure loopback refuses a \-\-url beyond this machine. Every extra browser origin must be named with \-\-origin; setup never guesses from the request Host header or network interfaces. A fresh install refuses a public \-\-bind address: until the first account exists, registration is open to whoever reaches it first. On an existing install, setup says when Mend's port or workspace SSH is published on a public address while the exposure is not public. The questions offer only private addresses (a tailnet, a LAN or VPN, carrier\-grade NAT space) for a private network.
|
|
20
20
|
.PP
|
|
21
21
|
\-\-edge <host> runs a TLS edge in front of Mend: Caddy on ports 80 and 443 of every interface, which obtains and renews a certificate for the host and proxies to Mend's web tier. Mend's own port stays on loopback and the browser origin is https://<host>. The edge's compose overlay and Caddyfile are written into the generation beside compose.yaml, so start, restart and upgrade run them every time. \-\-no\-edge takes it away again, and the edge's container with it. A fresh install cannot start with the edge: until the first account exists, registration is open to whoever reaches the origin first, so set up on localhost, create the account, then add the edge.
|
|
22
22
|
.PP
|
|
23
23
|
\-\-t3\-gateway turns on the t3code gateway (docs/adr/0012): t3code's desktop, mobile and web clients add it as an environment, pair with a code from mend pair, and see this Mend's projects and sessions. It runs in the Mend container, confined to a root and a uid of its own, on a listener of its own (port 3120, or \-\-t3\-gateway\-port) published where Mend's web port is: on 127.0.0.1 for just this machine, on the tailnet or LAN address for a private network, so T3 Code reaches it as it reaches Mend, with no tunnel. Every device pairs through Mend wherever it is published. Behind the edge its port stays on 127.0.0.1, and \-\-t3\-gateway\-origin <host> has the edge serve it on a host of its own, over HTTPS: a t3code client always uses a server's root path, so it cannot sit under Mend's origin. That host's DNS points where the edge's does; setup says where it resolves. Setup refuses it on a Mend image that has no gateway, and says whether it answered. It is kept across reruns and upgrades; \-\-no\-t3\-gateway turns it off, and its state stays in its own volume, mend\-t3\-gateway. Off, nothing of it runs.
|
|
24
24
|
.PP
|
|
25
|
+
\-\-preview\-domain <domain> has the edge serve live previews (docs/adr/0017): each at https://<label>.<domain>, a host of its own apart from Mend's, so a page on a preview cannot act as Mend. Setup refuses a domain that is Mend's host or sits above or below it. One beside Mend's host on its registrable domain (previews.example.com beside mend.example.com) is allowed while Mend's URL is https: Mend's cookies are __Host\- there, which a page on a preview can neither set nor replace. Every other host on that registrable domain receives the cookies a preview's page sets, so use a registrable domain of the previews' own if one of those hosts keeps a session in a cookie without __Host\-. A wildcard certificate needs DNS\-01, which the packaged edge cannot do, so \-\-preview\-certificate and \-\-preview\-key name the PEM files of a certificate for *.<domain> and its key, issued elsewhere. Each run reads them, checks that the certificate names *.<domain>, that the key is its own and that the edge's own container loads them, and copies both into the install, where the edge reads the copies; one that expires within 30 days is said, not refused. The gateway runs in the Mend container on port 3130, a fixed port published on 127.0.0.1 only. The edge logs no path, query or Referer for these hosts: the sign\-in exchange carries a ticket in its query. Setup says whether the gateway answered and where a name under the domain resolves. Kept across reruns and upgrades; to serve a renewed certificate, replace the files at the same paths and run mend server setup \-\-yes, which copies them again and recreates the edge. \-\-no\-preview\-domain turns previews off. mend operator exposure lists preview\-gateway as open until you checked DNS, the certificate and who reaches it from another network and stated it with \-\-declare preview\-gateway; with \-\-exposure public, setup refuses previews until you do.
|
|
26
|
+
.PP
|
|
27
|
+
\-\-preview\-tailnet serves live previews on your tailnet instead, with no edge and no domain (docs/adr/0017, decision 6): each at https://mend\-preview.<tailnet>.ts.net:<port>, a port each, given when a preview is first opened, under one Tailscale Service, svc:mend\-preview. A port goes to another preview once its own has had no open connection for 24 hours, and the browser is asked to clear what the earlier preview stored there. Setup reads the name from tailscale status on this machine, so it runs on the machine that runs Mend, with Tailscale up and MagicDNS on; it refuses a Docker engine on another machine. Mend's own URL must be https: every name in one tailnet is one site, and only an https URL gives Mend's cookies the __Host\- prefix that a page on a preview cannot set. On a tailnet, serve Mend's web port with tailscale serve \-\-bg \-\-https=443 http://127.0.0.1:3105 and add \-\-url https://<this machine's MagicDNS name>. The gateway listens on port 3130, published on 127.0.0.1 only, and tailscale serve on this machine forwards each preview's port to it. Mend's container cannot reach tailscaled, so setup prints the tailscale serve commands, one per port, and never runs them: on the run that turns previews on, with the Service's endpoints and the six things to turn on in Tailscale (MagicDNS, HTTPS certificates, the Service, a tag on this machine, its approval for the Service, grants for the people who open previews); on later runs, only what changed, against what tailscale serve status showed when it could be read, else against the ports saved last time. Keep Funnel off for these ports; setup says so when it observes Funnel on. \-\-preview\-tailnet\-ports takes ports and ranges, such as 20001\-20016, the default; the Service's definition lists the same ports. tailscale serve reaches the gateway through its published port, so inside Mend every viewer on the tailnet arrives from one address, and X\-Forwarded\-For is not believed: all of them share one address's preview budget (MEND_BUDGET_ADDRESS_PREVIEW_REQUESTS_PER_MINUTE, 12000 a minute by default), and each viewer's own account budgets apply after sign\-in. Mend's own web port served the same way shares one address's window for everyone on the tailnet: MEND_BUDGET_ADDRESS_REQUESTS_PER_MINUTE (1200) and MEND_BUDGET_SIGN_IN_ATTEMPTS_PER_MINUTE (20); raise them in server.env for a team. A server image from before these previews is refused, before anything is activated. Refused with \-\-exposure public, which needs a registrable domain of its own. Kept across reruns and upgrades; \-\-preview\-tailnet on an install with a preview domain replaces it, and \-\-preview\-domain replaces the tailnet. \-\-no\-preview\-tailnet turns previews off and prints the tailscale serve commands that take their ports off. mend operator exposure lists preview\-gateway as open until you check from a device on the tailnet and from one outside it, then state it with \-\-declare preview\-gateway.
|
|
28
|
+
.PP
|
|
25
29
|
\-\-exposure declares how the instance is reached, and \-\-tenancy whether one organization or many use it. Both are written into the generation and kept across reruns and upgrades. public needs the edge and an existing first account. With multi, or with public, the multi mode gate's settings follow: MEND_SOURCE_POLICY=tenant and MEND_CAPTURE_REQUIRE_SIZES=true, and public sets MEND_URL_BEARERS=refuse. The server still decides whether it starts, and mend server status shows what it reports.
|
|
26
30
|
.PP
|
|
27
31
|
Two mirrors run beside Mend unless turned off: an npm mirror (nginx caching npmjs.org, capped at 10g by default, least recently used out) and a Docker mirror (a pull\-through cache of Docker Hub, capped at 20g by default: over the cap its cache is cleared). Both leave 5g free on their disk: below that, nginx evicts and the Docker mirror pauses, and sessions pull from Docker Hub directly. Neither publishes a host port. Sessions install npm packages and pull Docker Hub images through them; a project's own npm settings win, and a mirror that is down sends sessions upstream instead. Both are kept across reruns and upgrades, and an upgrade adds them to an install from before them. The Docker mirror pulls anonymously unless given a Docker Hub login: \-\-docker\-hub\-username with the access token piped on standard input, kept in server.env only. The mirror has no login of its own, so every session that reaches it can pull whatever that token can read: setup takes a login only with \-\-docker\-hub\-public\-only, your statement that the token's access permission is Public Repo Read\-only. Mend cannot check a token's scope.
|
|
@@ -83,6 +87,27 @@ with the edge: serve the gateway over HTTPS on this host of its own; its DNS poi
|
|
|
83
87
|
.B \-\-no\-t3\-gateway\-origin
|
|
84
88
|
the edge stops serving the gateway; it stays on, on 127.0.0.1
|
|
85
89
|
.TP
|
|
90
|
+
.B \-\-preview\-domain <domain>
|
|
91
|
+
with the edge: serve live previews at https://<label>.<domain>, apart from Mend's host; needs \-\-preview\-certificate and \-\-preview\-key the first time; kept across reruns and upgrades
|
|
92
|
+
.TP
|
|
93
|
+
.B \-\-preview\-certificate <file>
|
|
94
|
+
the PEM certificate for *.<domain>, an absolute path setup copies from on every run; goes with \-\-preview\-key
|
|
95
|
+
.TP
|
|
96
|
+
.B \-\-preview\-key <file>
|
|
97
|
+
that certificate's PEM private key
|
|
98
|
+
.TP
|
|
99
|
+
.B \-\-no\-preview\-domain
|
|
100
|
+
turn previews off; the certificate files stay
|
|
101
|
+
.TP
|
|
102
|
+
.B \-\-preview\-tailnet
|
|
103
|
+
serve live previews at https://mend\-preview.<tailnet>.ts.net:<port> through tailscale serve on this machine, with no edge; needs an https \-\-url and is refused under \-\-exposure public; kept across reruns and upgrades
|
|
104
|
+
.TP
|
|
105
|
+
.B \-\-preview\-tailnet\-ports <list>
|
|
106
|
+
the ports previews take, as ports and ranges such as 20001,20005\-20010. Default: 20001\-20016. Implies \-\-preview\-tailnet
|
|
107
|
+
.TP
|
|
108
|
+
.B \-\-no\-preview\-tailnet
|
|
109
|
+
turn tailnet previews off; setup prints the tailscale serve commands that take their ports off
|
|
110
|
+
.TP
|
|
86
111
|
.B \-\-exposure <v>
|
|
87
112
|
declare loopback, private or public; kept across reruns and upgrades. public needs \-\-edge and an existing first account
|
|
88
113
|
.TP
|
|
@@ -90,7 +115,7 @@ declare loopback, private or public; kept across reruns and upgrades. public nee
|
|
|
90
115
|
declare single or multi; kept across reruns and upgrades. multi also sets the multi mode gate's variables
|
|
91
116
|
.TP
|
|
92
117
|
.B \-\-declare <item>
|
|
93
|
-
state a gate item you verified from outside: core\-private, edge\-tls, workspace\-ssh or
|
|
118
|
+
state a gate item you verified from outside: core\-private, edge\-tls, workspace\-ssh, t3code\-gateway or preview\-gateway. Adds to what is saved; repeat for more, none clears. public with \-\-ssh\-bind beyond loopback needs workspace\-ssh
|
|
94
119
|
.TP
|
|
95
120
|
.B \-\-undeclare <item>
|
|
96
121
|
take one statement back; the others stay. Repeat for more
|
|
@@ -147,6 +172,14 @@ on an existing install: turn the T3 Code gateway on where Mend's web port is pub
|
|
|
147
172
|
.br
|
|
148
173
|
behind the edge: serve the T3 Code gateway at https://t3.mend.example.com
|
|
149
174
|
.PP
|
|
175
|
+
.B mend server setup \-\-preview\-domain previews.example.net \-\-preview\-certificate /etc/mend/previews.crt \-\-preview\-key /etc/mend/previews.key
|
|
176
|
+
.br
|
|
177
|
+
behind the edge: serve live previews at https://<label>.previews.example.net with a wildcard certificate issued elsewhere
|
|
178
|
+
.PP
|
|
179
|
+
.B mend server setup \-\-url https://mend\-box.tailc79e49.ts.net \-\-preview\-tailnet
|
|
180
|
+
.br
|
|
181
|
+
on a tailnet, with Mend's web port already served by tailscale serve \-\-https=443: serve live previews at https://mend\-preview.tailc79e49.ts.net:<port>
|
|
182
|
+
.PP
|
|
150
183
|
.B mend server setup \-\-yes
|
|
151
184
|
.br
|
|
152
185
|
no questions: localhost on a fresh install, using the current local Docker context
|
package/man/mend-server-start.1
CHANGED
package/man/mend-server-status.1
CHANGED
package/man/mend-server-stop.1
CHANGED
package/man/mend-server.1
CHANGED
package/man/mend-service-add.1
CHANGED
package/man/mend-service-init.1
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
.TH MEND-SERVICE-INIT 1 "" "mend 0.
|
|
1
|
+
.TH MEND-SERVICE-INIT 1 "" "mend 0.37.0\-next.1197" "mend manual"
|
|
2
2
|
.SH NAME
|
|
3
3
|
mend\-service\-init \- scaffold mend.toml from package.json and compose ports
|
|
4
4
|
.SH SYNOPSIS
|
|
@@ -6,7 +6,7 @@ mend\-service\-init \- scaffold mend.toml from package.json and compose ports
|
|
|
6
6
|
.br
|
|
7
7
|
.SH DESCRIPTION
|
|
8
8
|
.PP
|
|
9
|
-
Writes a mend.toml in the current repository with one Service per script and exposed port it can find. Edit it afterwards; sessions read it from their worktree.
|
|
9
|
+
Writes a mend.toml in the current repository with one Service per script and exposed port it can find. A workspace package's server runs in its own directory (cwd), a known dev server gets browserScheme = "http", a compose service gets address = "docker", and the one browser Service, when there is exactly one, becomes the [preview]. With a lockfile at the root it adds a [setup] that installs from it (pnpm install \-\-frozen\-lockfile, yarn install \-\-frozen\-lockfile, or \-\-immutable on Yarn 2 and later, bun install \-\-frozen\-lockfile or npm ci), run before a recipe starts and again when the lockfile changes. Edit it afterwards; sessions read it from their worktree.
|
|
10
10
|
.SH OPTIONS
|
|
11
11
|
.TP
|
|
12
12
|
.B \-\-yes
|
package/man/mend-service-list.1
CHANGED
package/man/mend-service-logs.1
CHANGED
package/man/mend-service-run.1
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
.TH MEND-SERVICE-RUN 1 "" "mend 0.
|
|
1
|
+
.TH MEND-SERVICE-RUN 1 "" "mend 0.37.0\-next.1197" "mend manual"
|
|
2
2
|
.SH NAME
|
|
3
3
|
mend\-service\-run \- start and supervise a server in the session's workspace
|
|
4
4
|
.SH SYNOPSIS
|
|
5
5
|
.B mend service run [session] \-\-port <port> [\-\-name <n>] [\-\-udp] [\-\-http|\-\-https] [\-\-wait [\-\-timeout <duration>]] [\-\-no\-connect] \-\- <command...>
|
|
6
6
|
.br
|
|
7
|
-
.B mend service run [session] <name> [\-\-wait [\-\-timeout <duration>]] [\-\-no\-connect]
|
|
7
|
+
.B mend service run [session] <name> [\-\-setup] [\-\-wait [\-\-timeout <duration>]] [\-\-no\-connect]
|
|
8
8
|
.br
|
|
9
9
|
.SH DESCRIPTION
|
|
10
10
|
.PP
|
|
11
11
|
With \-\-, the command after it is started in the workspace and supervised: its output is recorded, and mend service restart re\-runs it. Without \-\-, the name is a Service declared in the worktree's mend.toml. mend service <name> is the shorthand for that.
|
|
12
12
|
.PP
|
|
13
|
-
Mend waits up to a minute for the port to answer before it returns. \-\-wait keeps waiting while the Service is still starting (its process runs and its port has not answered yet: building, installing, booting), however long that takes, up to \-\-timeout (default 10 minutes). Mend probes a started Service's port every 20 seconds, so the wait ends at the first probe that answers. The wait judges the one process this start began, by an id the start sends and the server stamps on it, whatever another client starts, restarts or stops meanwhile. The exit status says how it ended: 0 the port answered for that process; 1 Mend refused the start or could not be asked; 2 the process ended before its port answered (the line says its status and exit code; a process its workspace took reads exited, no exit code reported); 3 the server no longer has the session, its workspace gone with it; 124 the Service was still starting when the timeout passed, and it keeps starting. A server older than this CLI stamps no id: a start whose answer an edge cut is then not followed (1), and a command that exits inside the minute reads as the refusal it answers with (1). A waited start returns and opens no tunnel; mend service connect reaches the port. UDP has no probe, and a recipe that declares only a port is adopted
|
|
13
|
+
Mend waits up to a minute for the port to answer before it returns; a recipe's ready rule sets what answering means (any HTTP status for its path) and how long to wait. A recipe's depends start first, in order; one already running in the session is not started again, and counts once it has answered its own ready rule. A recipe start runs to its end on the server whatever happens to this command: Ctrl\-C or a cut connection leaves it going, and a Stop of one of its Services ends it. \-\-wait follows it, a line for each dependency as it starts and answers, and keeps waiting while the Service is still starting (its process runs and its port has not answered yet: building, installing, booting), however long that takes, up to \-\-timeout (default 10 minutes). Mend probes a started Service's port every 20 seconds, so the wait ends at the first probe that answers. The wait judges the one process this start began, by an id the start sends and the server stamps on it, whatever another client starts, restarts or stops meanwhile. The exit status says how it ended: 0 the port answered for that process; 1 Mend refused the start or could not be asked; 2 the process ended before its port answered (the line says its status and exit code; a process its workspace took reads exited, no exit code reported); 3 the server no longer has the session, its workspace gone with it; 124 the Service was still starting when the timeout passed, and it keeps starting. A server older than this CLI stamps no id: a start whose answer an edge cut is then not followed (1), and a command that exits inside the minute reads as the refusal it answers with (1). A waited start returns and opens no tunnel; mend service connect reaches the port. UDP has no probe, and a recipe that declares only a port is adopted, its port looked for within its ready timeout, so \-\-wait takes neither.
|
|
14
14
|
.PP
|
|
15
15
|
The port is tunnelled to this machine's loopback as soon as it listens, unless \-\-no\-connect.
|
|
16
16
|
.SH OPTIONS
|
|
@@ -35,6 +35,9 @@ how a browser should open it
|
|
|
35
35
|
.TP
|
|
36
36
|
.B \-\-no\-connect
|
|
37
37
|
do not tunnel the port to this machine
|
|
38
|
+
.TP
|
|
39
|
+
.B \-\-setup
|
|
40
|
+
a recipe: run mend.toml's [setup] even if it already succeeded here
|
|
38
41
|
.SH EXAMPLES
|
|
39
42
|
.PP
|
|
40
43
|
.B mend service run \-\-port 3000 \-\- pnpm dev
|
package/man/mend-service-stop.1
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
.TH MEND-SERVICE-STOP 1 "" "mend 0.
|
|
1
|
+
.TH MEND-SERVICE-STOP 1 "" "mend 0.37.0\-next.1197" "mend manual"
|
|
2
2
|
.SH NAME
|
|
3
3
|
mend\-service\-stop \- stop a service and close its host port
|
|
4
4
|
.SH SYNOPSIS
|
|
@@ -6,6 +6,6 @@ mend\-service\-stop \- stop a service and close its host port
|
|
|
6
6
|
.br
|
|
7
7
|
.SH DESCRIPTION
|
|
8
8
|
.PP
|
|
9
|
-
Ends the process and the tunnel. The record of its output remains.
|
|
9
|
+
Ends the process and the tunnel. The record of its output remains. A name no live Service answers to ends a start of it still under way in a session of this repository, during its [setup] or a dependency's start.
|
|
10
10
|
.SH SEE ALSO
|
|
11
11
|
mend(1), mend\-service\-restart(1)
|
package/man/mend-session-share.1
CHANGED
package/man/mend-sessions.1
CHANGED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
.TH MEND-SETTINGS 1 "" "mend 0.37.0\-next.1197" "mend manual"
|
|
2
|
+
.SH NAME
|
|
3
|
+
mend\-settings \- see or change your own messaging setting
|
|
4
|
+
.SH SYNOPSIS
|
|
5
|
+
.B mend settings [send\-steers [on|off]] [\-\-json]
|
|
6
|
+
.br
|
|
7
|
+
.SH DESCRIPTION
|
|
8
|
+
.PP
|
|
9
|
+
Prints your settings, one line each: the name, its value and what it does. Each person has their own.
|
|
10
|
+
.PP
|
|
11
|
+
send\-steers is Send steers the running turn, on by default. On, a message you send while your own turn runs goes into that turn. Off, it always starts your next turn. A message during another person's turn starts a new turn either way, and mend message \-\-queue does too.
|
|
12
|
+
.PP
|
|
13
|
+
With a name, prints that one value; with on or off, saves it and prints the saved value. Exit 0 means the value printed is the one the server holds. Exit 1 means a bad argument, which sends nothing, a refusal, or no usable answer; after a failed set, run mend settings to see the value the server holds.
|
|
14
|
+
.SH OPTIONS
|
|
15
|
+
.TP
|
|
16
|
+
.B \-\-json
|
|
17
|
+
print the versioned settings or error as JSON
|
|
18
|
+
.SH EXAMPLES
|
|
19
|
+
.PP
|
|
20
|
+
.B mend settings
|
|
21
|
+
.br
|
|
22
|
+
every setting and its value
|
|
23
|
+
.PP
|
|
24
|
+
.B mend settings send\-steers off
|
|
25
|
+
.br
|
|
26
|
+
send always starts your next turn
|
|
27
|
+
.PP
|
|
28
|
+
.B mend settings send\-steers \-\-json
|
|
29
|
+
.br
|
|
30
|
+
the one setting as JSON
|
|
31
|
+
.SH SEE ALSO
|
|
32
|
+
mend(1), mend\-message(1)
|
package/man/mend-shell.1
CHANGED
package/man/mend-skills-push.1
CHANGED
package/man/mend-skills.1
CHANGED
package/man/mend-snake.1
CHANGED
package/man/mend-ssh-keys.1
CHANGED
package/man/mend-ssh-setup.1
CHANGED
package/man/mend-ssh.1
CHANGED
package/man/mend-stop.1
CHANGED
package/man/mend-ui.1
CHANGED
package/man/mend-uninstall.1
CHANGED
package/man/mend-version.1
CHANGED
package/man/mend-wait.1
CHANGED
package/man/mend-worktrees-rm.1
CHANGED
package/man/mend-worktrees.1
CHANGED
package/man/mend.1
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
.TH MEND 1 "" "mend 0.
|
|
1
|
+
.TH MEND 1 "" "mend 0.37.0\-next.1197" "mend manual"
|
|
2
2
|
.SH NAME
|
|
3
3
|
mend \- the agent workbench
|
|
4
4
|
.SH SYNOPSIS
|
|
@@ -55,6 +55,12 @@ open a shell in a live session's workspace
|
|
|
55
55
|
.B mend run
|
|
56
56
|
run any command as a session
|
|
57
57
|
.TP
|
|
58
|
+
.B mend message
|
|
59
|
+
send words to a session
|
|
60
|
+
.TP
|
|
61
|
+
.B mend settings
|
|
62
|
+
see or change your own messaging setting
|
|
63
|
+
.TP
|
|
58
64
|
.B mend logs
|
|
59
65
|
print a session's recorded terminal output
|
|
60
66
|
.TP
|
|
@@ -83,7 +89,7 @@ remove a worktree, its sessions and its change
|
|
|
83
89
|
replace a workspace that started before Mend 0.36
|
|
84
90
|
.TP
|
|
85
91
|
.B mend projects
|
|
86
|
-
|
|
92
|
+
list, remove, Restore or purge projects
|
|
87
93
|
.TP
|
|
88
94
|
.B mend refresh
|
|
89
95
|
fetch origin's branches into the store
|
|
@@ -123,6 +129,24 @@ stop a service and close its host port
|
|
|
123
129
|
scaffold mend.toml from package.json and compose ports
|
|
124
130
|
.SH PROJECT SETUP
|
|
125
131
|
.TP
|
|
132
|
+
.B mend resource list
|
|
133
|
+
a project's resources: settings, proposals, mend.toml
|
|
134
|
+
.TP
|
|
135
|
+
.B mend resource add
|
|
136
|
+
propose a resource for the project
|
|
137
|
+
.TP
|
|
138
|
+
.B mend resource remove
|
|
139
|
+
remove a definition, or a proposal
|
|
140
|
+
.TP
|
|
141
|
+
.B mend resource approve
|
|
142
|
+
approve a resource's definition, pinning its image
|
|
143
|
+
.TP
|
|
144
|
+
.B mend resource use
|
|
145
|
+
choose how a worktree uses a project resource
|
|
146
|
+
.TP
|
|
147
|
+
.B mend resource start
|
|
148
|
+
start a resource's instance
|
|
149
|
+
.TP
|
|
126
150
|
.B mend env show
|
|
127
151
|
what the project store holds: names only, never values
|
|
128
152
|
.TP
|
|
@@ -310,4 +334,4 @@ url, token, and device id from mend login
|
|
|
310
334
|
.B ~/.config/mend/keys/
|
|
311
335
|
the deploy key from mend keys init
|
|
312
336
|
.SH SEE ALSO
|
|
313
|
-
mend\-login(1), mend\-connect(1), mend\-agent\-logins(1), mend\-connect\-pi(1), mend\-adopt(1), mend\-codex(1), mend\-models(1), mend\-pair(1), mend\-doctor(1), mend\-ui(1), mend\-snake(1), mend\-attach(1), mend\-stop(1), mend\-shell(1), mend\-run(1), mend\-logs(1), mend\-wait(1), mend\-continue(1), mend\-resume(1), mend\-rejoin(1), mend\-sessions(1), mend\-worktrees(1), mend\-worktrees\-rm(1), mend\-workspace\-replace(1), mend\-projects(1), mend\-refresh(1), mend\-land(1), mend\-pull(1), mend\-handoff(1), mend\-service\-run(1), mend\-service\-add(1), mend\-service\-connect(1), mend\-service\-list(1), mend\-service\-logs(1), mend\-service\-restart(1), mend\-service\-stop(1), mend\-service\-init(1), mend\-env\-show(1), mend\-env\-load(1), mend\-env\-cluster(1), mend\-skills(1), mend\-skills\-push(1), mend\-memory(1), mend\-memory\-import(1), mend\-memory\-show(1), mend\-memory\-rm(1), mend\-dotfiles(1), mend\-dotfiles\-repo(1), mend\-dotfiles\-sync(1), mend\-secrets(1), mend\-secrets\-add(1), mend\-secrets\-rm(1), mend\-git\-author(1), mend\-keys\-init(1), mend\-keys\-show(1), mend\-keys\-mode(1), mend\-keys\-share(1), mend\-members(1), mend\-invite(1), mend\-folder\-list(1), mend\-folder\-create(1), mend\-folder\-push(1), mend\-folder\-rm(1), mend\-session\-share(1), mend\-operator\-org\-list(1), mend\-operator\-exposure(1), mend\-operator\-gate(1), mend\-operator\-org\-create(1), mend\-operator\-org\-rename(1), mend\-operator\-org\-invite\-owner(1), mend\-operator\-grant\-owner(1), mend\-operator\-reset\-link(1), mend\-server(1), mend\-server\-setup(1), mend\-server\-status(1), mend\-server\-start(1), mend\-server\-stop(1), mend\-server\-restart(1), mend\-server\-logs(1), mend\-server\-upgrade(1), mend\-ssh(1), mend\-ssh\-setup(1), mend\-ssh\-keys(1), mend\-ssh\-keys\-remove(1), mend\-accounts(1), mend\-logout(1), mend\-uninstall(1), mend\-completions(1), mend\-version(1), mend\-help(1), mend\-man(1)
|
|
337
|
+
mend\-login(1), mend\-connect(1), mend\-agent\-logins(1), mend\-connect\-pi(1), mend\-adopt(1), mend\-codex(1), mend\-models(1), mend\-pair(1), mend\-doctor(1), mend\-ui(1), mend\-snake(1), mend\-attach(1), mend\-stop(1), mend\-shell(1), mend\-run(1), mend\-message(1), mend\-settings(1), mend\-logs(1), mend\-wait(1), mend\-continue(1), mend\-resume(1), mend\-rejoin(1), mend\-sessions(1), mend\-worktrees(1), mend\-worktrees\-rm(1), mend\-workspace\-replace(1), mend\-projects(1), mend\-refresh(1), mend\-land(1), mend\-pull(1), mend\-handoff(1), mend\-service\-run(1), mend\-service\-add(1), mend\-service\-connect(1), mend\-service\-list(1), mend\-service\-logs(1), mend\-service\-restart(1), mend\-service\-stop(1), mend\-service\-init(1), mend\-resource\-list(1), mend\-resource\-add(1), mend\-resource\-remove(1), mend\-resource\-approve(1), mend\-resource\-use(1), mend\-resource\-start(1), mend\-env\-show(1), mend\-env\-load(1), mend\-env\-cluster(1), mend\-skills(1), mend\-skills\-push(1), mend\-memory(1), mend\-memory\-import(1), mend\-memory\-show(1), mend\-memory\-rm(1), mend\-dotfiles(1), mend\-dotfiles\-repo(1), mend\-dotfiles\-sync(1), mend\-secrets(1), mend\-secrets\-add(1), mend\-secrets\-rm(1), mend\-git\-author(1), mend\-keys\-init(1), mend\-keys\-show(1), mend\-keys\-mode(1), mend\-keys\-share(1), mend\-members(1), mend\-invite(1), mend\-folder\-list(1), mend\-folder\-create(1), mend\-folder\-push(1), mend\-folder\-rm(1), mend\-session\-share(1), mend\-operator\-org\-list(1), mend\-operator\-exposure(1), mend\-operator\-gate(1), mend\-operator\-org\-create(1), mend\-operator\-org\-rename(1), mend\-operator\-org\-invite\-owner(1), mend\-operator\-grant\-owner(1), mend\-operator\-reset\-link(1), mend\-server(1), mend\-server\-setup(1), mend\-server\-status(1), mend\-server\-start(1), mend\-server\-stop(1), mend\-server\-restart(1), mend\-server\-logs(1), mend\-server\-upgrade(1), mend\-ssh(1), mend\-ssh\-setup(1), mend\-ssh\-keys(1), mend\-ssh\-keys\-remove(1), mend\-accounts(1), mend\-logout(1), mend\-uninstall(1), mend\-completions(1), mend\-version(1), mend\-help(1), mend\-man(1)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sealant/mend",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.37.0-next.1197",
|
|
4
4
|
"description": "The mend CLI: adopt a repository into Mend's store, launch your coding agent in a recorded session worktree, detach and reattach from any terminal",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|
|
@@ -41,7 +41,7 @@
|
|
|
41
41
|
"undici": "^7.28.0",
|
|
42
42
|
"ws": "8.21.0"
|
|
43
43
|
},
|
|
44
|
-
"gitHead": "
|
|
44
|
+
"gitHead": "eb9f2bee582f5d94773fad174f8fa0856451496c",
|
|
45
45
|
"publishConfig": {
|
|
46
46
|
"access": "public"
|
|
47
47
|
}
|