@sealant/mend 0.37.0-next.1197 → 0.37.0-next.1397

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.
Files changed (148) hide show
  1. package/dist/agent-skill.md +287 -0
  2. package/dist/{chunk-EX5C6Y5A.js → chunk-ACIZ2XQQ.js} +10385 -7026
  3. package/dist/{dashboard-3WCED6AO.js → dashboard-7YGTCNL2.js} +109 -193
  4. package/dist/main.js +19540 -18890
  5. package/man/mend-access-keys-create.1 +27 -0
  6. package/man/mend-access-keys-list.1 +17 -0
  7. package/man/mend-access-keys-revoke.1 +15 -0
  8. package/man/mend-accounts.1 +1 -1
  9. package/man/mend-adopt.1 +6 -1
  10. package/man/mend-agent-install.1 +15 -0
  11. package/man/mend-agent-logins.1 +1 -1
  12. package/man/mend-attach.1 +1 -1
  13. package/man/mend-change.1 +18 -0
  14. package/man/mend-codex.1 +9 -1
  15. package/man/mend-comment-add.1 +24 -0
  16. package/man/mend-comment-send.1 +18 -0
  17. package/man/mend-completions.1 +1 -1
  18. package/man/mend-connect-executor.1 +24 -0
  19. package/man/mend-connect-pi.1 +4 -1
  20. package/man/mend-connect-status.1 +15 -0
  21. package/man/mend-connect.1 +36 -1
  22. package/man/mend-continue.1 +1 -1
  23. package/man/mend-diff.1 +24 -0
  24. package/man/mend-doctor.1 +12 -3
  25. package/man/mend-doppler-connect.1 +11 -0
  26. package/man/mend-doppler-disconnect.1 +11 -0
  27. package/man/mend-doppler-status.1 +11 -0
  28. package/man/mend-doppler-use.1 +15 -0
  29. package/man/mend-doppler.1 +15 -0
  30. package/man/mend-dotfiles-repo.1 +1 -1
  31. package/man/mend-dotfiles-sync.1 +1 -1
  32. package/man/mend-dotfiles.1 +1 -1
  33. package/man/mend-env-cluster.1 +1 -1
  34. package/man/mend-env-load.1 +1 -1
  35. package/man/mend-env-show.1 +1 -1
  36. package/man/mend-folder-create.1 +1 -1
  37. package/man/mend-folder-list.1 +1 -1
  38. package/man/mend-folder-push.1 +1 -1
  39. package/man/mend-folder-rm.1 +1 -1
  40. package/man/mend-git-author.1 +1 -1
  41. package/man/mend-git-check.1 +20 -0
  42. package/man/mend-handoff.1 +1 -1
  43. package/man/mend-help.1 +5 -1
  44. package/man/mend-history.1 +18 -0
  45. package/man/mend-interrupt.1 +15 -0
  46. package/man/mend-invite.1 +3 -3
  47. package/man/mend-keys-init.1 +1 -1
  48. package/man/mend-keys-mode.1 +2 -2
  49. package/man/mend-keys-share.1 +1 -1
  50. package/man/mend-keys-show.1 +1 -1
  51. package/man/mend-land.1 +6 -3
  52. package/man/mend-login.1 +8 -2
  53. package/man/mend-logout.1 +6 -2
  54. package/man/mend-logs.1 +1 -1
  55. package/man/mend-man.1 +1 -1
  56. package/man/mend-mcp-add.1 +45 -0
  57. package/man/mend-mcp-forget.1 +18 -0
  58. package/man/mend-mcp-off.1 +18 -0
  59. package/man/mend-mcp-on.1 +18 -0
  60. package/man/mend-mcp-remove.1 +18 -0
  61. package/man/mend-mcp.1 +24 -0
  62. package/man/mend-members.1 +3 -3
  63. package/man/mend-memory-import.1 +1 -1
  64. package/man/mend-memory-rm.1 +1 -1
  65. package/man/mend-memory-show.1 +1 -1
  66. package/man/mend-memory.1 +1 -1
  67. package/man/mend-message.1 +6 -3
  68. package/man/mend-models.1 +1 -1
  69. package/man/mend-operator-exposure.1 +1 -1
  70. package/man/mend-operator-gate.1 +1 -1
  71. package/man/mend-operator-grant-owner.1 +2 -2
  72. package/man/mend-operator-org-add-member.1 +20 -0
  73. package/man/mend-operator-org-create.1 +1 -1
  74. package/man/mend-operator-org-invite-owner.1 +2 -2
  75. package/man/mend-operator-org-list.1 +2 -2
  76. package/man/mend-operator-org-rename.1 +1 -1
  77. package/man/mend-operator-reset-link.1 +1 -1
  78. package/man/mend-org-leave.1 +17 -0
  79. package/man/mend-org-switch.1 +14 -0
  80. package/man/mend-org.1 +15 -0
  81. package/man/mend-pair.1 +1 -1
  82. package/man/mend-preview.1 +31 -0
  83. package/man/mend-projects-image.1 +20 -0
  84. package/man/mend-projects-purge.1 +18 -0
  85. package/man/mend-projects-removed.1 +15 -0
  86. package/man/mend-projects-restore.1 +18 -0
  87. package/man/mend-projects-rm.1 +15 -0
  88. package/man/mend-projects.1 +3 -3
  89. package/man/mend-proof-get.1 +21 -0
  90. package/man/mend-proof-list.1 +15 -0
  91. package/man/mend-pull.1 +1 -1
  92. package/man/mend-refresh.1 +1 -1
  93. package/man/mend-rejoin.1 +1 -1
  94. package/man/mend-resource-add.1 +17 -25
  95. package/man/mend-resource-env.1 +21 -0
  96. package/man/mend-resource-list.1 +10 -12
  97. package/man/mend-resource-load.1 +33 -0
  98. package/man/mend-resource-remove.1 +16 -16
  99. package/man/mend-resource-reset.1 +24 -0
  100. package/man/mend-resource-start.1 +28 -7
  101. package/man/mend-resource-stop.1 +27 -0
  102. package/man/mend-resource-use.1 +12 -9
  103. package/man/mend-respond.1 +21 -0
  104. package/man/mend-resume.1 +1 -1
  105. package/man/mend-run.1 +1 -1
  106. package/man/mend-screen-look.1 +21 -0
  107. package/man/mend-secrets-add.1 +1 -1
  108. package/man/mend-secrets-rm.1 +1 -1
  109. package/man/mend-secrets.1 +1 -1
  110. package/man/mend-server-logs.1 +1 -1
  111. package/man/mend-server-restart.1 +1 -1
  112. package/man/mend-server-setup.1 +46 -1
  113. package/man/mend-server-start.1 +1 -1
  114. package/man/mend-server-status.1 +8 -1
  115. package/man/mend-server-stop.1 +1 -1
  116. package/man/mend-server-upgrade.1 +1 -1
  117. package/man/mend-server.1 +1 -1
  118. package/man/mend-service-add.1 +1 -1
  119. package/man/mend-service-connect.1 +1 -1
  120. package/man/mend-service-init.1 +3 -3
  121. package/man/mend-service-list.1 +3 -3
  122. package/man/mend-service-logs.1 +1 -1
  123. package/man/mend-service-restart.1 +1 -1
  124. package/man/mend-service-run.1 +4 -4
  125. package/man/mend-service-stop.1 +1 -1
  126. package/man/mend-session-share.1 +2 -2
  127. package/man/mend-sessions.1 +2 -2
  128. package/man/mend-settings.1 +1 -1
  129. package/man/mend-setup-session.1 +25 -0
  130. package/man/mend-shell.1 +1 -1
  131. package/man/mend-skills-push.1 +1 -1
  132. package/man/mend-skills.1 +1 -1
  133. package/man/mend-snake.1 +1 -1
  134. package/man/mend-ssh-keys-remove.1 +1 -1
  135. package/man/mend-ssh-keys.1 +1 -1
  136. package/man/mend-ssh-setup.1 +1 -1
  137. package/man/mend-ssh.1 +1 -1
  138. package/man/mend-stop.1 +4 -1
  139. package/man/mend-ui.1 +1 -1
  140. package/man/mend-uninstall.1 +1 -1
  141. package/man/mend-version.1 +1 -1
  142. package/man/mend-wait.1 +4 -1
  143. package/man/mend-workspace-replace.1 +2 -2
  144. package/man/mend-worktrees-rm.1 +1 -1
  145. package/man/mend-worktrees.1 +1 -1
  146. package/man/mend.1 +139 -13
  147. package/package.json +4 -3
  148. package/man/mend-resource-approve.1 +0 -38
@@ -0,0 +1,15 @@
1
+ .TH MEND-PROJECTS-RM 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
+ .SH NAME
3
+ mend\-projects\-rm \- remove a project while retaining files and history
4
+ .SH SYNOPSIS
5
+ .B mend projects rm <id> [\-\-json]
6
+ .br
7
+ .SH DESCRIPTION
8
+ .PP
9
+ Refuses while work is live or saving. Keeps the removed project's files and history for restoration.
10
+ .SH OPTIONS
11
+ .TP
12
+ .B \-\-json
13
+ return the v1 command envelope
14
+ .SH SEE ALSO
15
+ mend(1), mend\-projects\-removed(1), mend\-projects\-restore(1), mend\-projects\-purge(1)
@@ -1,4 +1,4 @@
1
- .TH MEND-PROJECTS 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-PROJECTS 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-projects \- list, remove, Restore or purge projects
4
4
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ One line per project, with the sessions running in it.
10
10
  .PP
11
11
  mend projects rm <id> keeps files and history. mend projects removed lists them. mend projects restore <id> [\-\-name <name>] brings one back without starting work. mend projects purge <id> \-\-confirm <name> deletes it for good. Instance audit and backups are unchanged.
12
12
  .PP
13
- \-\-json prints them for scripts, stable like mend sessions \-\-json: {"version": 1, "projects": [...]}, an empty list when there are none. Each project has id, name, originUrl (a string, or null), defaultBranch, storePath, liveSessions (a number) and current (true when the current directory is inside it).
13
+ \-\-json returns the v1 command envelope with data.projects, an empty list when there are none. Each project has id, name, originUrl, defaultBranch, storePath, liveSessions and current. Removal, restoration and purge use the same envelope with structured errors and recovery instructions.
14
14
  .PP
15
15
  A repository URL is printed without its credentials: https://oauth2:TOKEN@github.com/acme/repo.git reads as https://github.com/acme/repo.git, here and in every line, message and JSON the CLI prints itself; an ssh URL keeps its user and loses only the password. A command's recorded output (mend run, mend logs, mend service logs, mend attach) and a file's contents (mend memory show) are printed as they are, and a session's record is readable by anyone who can read the project.
16
16
  .SH OPTIONS
@@ -24,4 +24,4 @@ a new name when restoring
24
24
  .B \-\-confirm <name>
25
25
  required exact project name for purge
26
26
  .SH SEE ALSO
27
- mend(1), mend\-adopt(1), mend\-sessions(1)
27
+ mend(1), mend\-adopt(1), mend\-sessions(1), mend\-projects\-image(1)
@@ -0,0 +1,21 @@
1
+ .TH MEND-PROOF-GET 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
+ .SH NAME
3
+ mend\-proof\-get \- download a proof artifact and its provenance
4
+ .SH SYNOPSIS
5
+ .B mend proof get <id> \-\-out <path> [\-\-timeout <duration>] [\-\-json]
6
+ .br
7
+ .SH DESCRIPTION
8
+ .PP
9
+ Streams stored media to a new private file and verifies its recorded byte count and SHA\-256. Partial downloads are removed. The output path must not exist. A recording or uncaptured artifact exits 4 with a next step.
10
+ .SH OPTIONS
11
+ .TP
12
+ .B \-\-out <path>
13
+ new destination path
14
+ .TP
15
+ .B \-\-timeout <duration>
16
+ bound the metadata and media download, default 5m
17
+ .TP
18
+ .B \-\-json
19
+ return the v1 command envelope
20
+ .SH SEE ALSO
21
+ mend(1), mend\-proof\-list(1), mend\-screen\-look(1)
@@ -0,0 +1,15 @@
1
+ .TH MEND-PROOF-LIST 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
+ .SH NAME
3
+ mend\-proof\-list \- read the proof artifacts attached to a session's change
4
+ .SH SYNOPSIS
5
+ .B mend proof list <session> [\-\-json]
6
+ .br
7
+ .SH DESCRIPTION
8
+ .PP
9
+ Lists stored screenshots and videos, capture state, checkpoint or unknown source, and observation time. An observation describes what was seen; it is no verdict about whether the change works.
10
+ .SH OPTIONS
11
+ .TP
12
+ .B \-\-json
13
+ return the v1 command envelope
14
+ .SH SEE ALSO
15
+ mend(1), mend\-proof\-get(1), mend\-change(1)
package/man/mend-pull.1 CHANGED
@@ -1,4 +1,4 @@
1
- .TH MEND-PULL 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-PULL 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-pull \- fetch a session's change into this clone as mend/<name>
4
4
  .SH SYNOPSIS
@@ -1,4 +1,4 @@
1
- .TH MEND-REFRESH 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-REFRESH 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-refresh \- fetch origin's branches into the store
4
4
  .SH SYNOPSIS
package/man/mend-rejoin.1 CHANGED
@@ -1,4 +1,4 @@
1
- .TH MEND-REJOIN 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-REJOIN 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-rejoin \- attach if live, otherwise resume
4
4
  .SH SYNOPSIS
@@ -1,43 +1,35 @@
1
- .TH MEND-RESOURCE-ADD 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-RESOURCE-ADD 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
- mend\-resource\-add \- propose a resource for the project
3
+ mend\-resource\-add \- write a resource declaration in .mend/mend.toml
4
4
  .SH SYNOPSIS
5
- .B mend resource add <name> \-\-preset <postgres|redis|mysql> \-\-version <v> [\-\-scope <s>] [\-\-project <p>]
5
+ .B mend resource add <name> \-\-preset <postgres|redis|mysql> \-\-version <v> [\-\-worktree\-id <w>]
6
6
  .br
7
- .B mend resource add <name> \-\-image <ref> \-\-port <port>... [\-\-scope <s>] [\-\-project <p>]
7
+ .B mend resource add <name> \-\-image <ref> \-\-port name=port[/udp] [\-\-worktree\-id <w>]
8
8
  .br
9
9
  .SH DESCRIPTION
10
10
  .PP
11
- Any member who can see the project proposes. A proposal sits beside the project's settings and changes none of them; a manager approves it there. Two people may propose the same name, and each keeps their own.
12
- .PP
13
- A preset runs its own image at the version named, which starts with its major version (17, 16.4\-bookworm), with its port, a data volume and its own ready check. An image is any image reference, such as axllent/mailpit:v1.21; approving it pins the digest it resolves to. Each \-\-port names one port.
11
+ Writes a resource table into the worktree's .mend/mend.toml (root mend.toml fallback). Starts nothing and never writes project settings or commits. The worktree comes from this checkout or \-\-worktree\-id.
14
12
  .SH OPTIONS
15
13
  .TP
14
+ .B \-\-json
15
+ return the v1 command envelope without prompts
16
+ .TP
16
17
  .B \-\-preset <p>
17
18
  postgres, redis or mysql
18
19
  .TP
19
20
  .B \-\-version <v>
20
- the preset's version, such as 17
21
+ preset image tag, beginning with its major version
21
22
  .TP
22
23
  .B \-\-image <ref>
23
- an image, such as axllent/mailpit:v1.21
24
+ image for a resource without a preset
24
25
  .TP
25
- .B \-\-port <port>
26
- a port the image listens on, as name=port: smtp=1025, or dns=53/udp
26
+ .B \-\-port <name=port[/udp]>
27
+ named port; repeat for each port
27
28
  .TP
28
- .B \-\-scope <s>
29
- project (one instance) or worktree (one per worktree). Default: project
29
+ .B \-\-project\-id <p>
30
+ project name or id
30
31
  .TP
31
- .B \-\-project <p>
32
- the project by name, when the current directory is not inside it
33
- .SH EXAMPLES
34
- .PP
35
- .B mend resource add db \-\-preset postgres \-\-version 17
36
- .br
37
- propose a Postgres 17
38
- .PP
39
- .B mend resource add mail \-\-image axllent/mailpit:v1.21 \-\-port smtp=1025 \-\-scope worktree
40
- .br
41
- propose a mail catcher for each worktree
32
+ .B \-\-worktree\-id <w>
33
+ worktree name or id; inferred from this checkout when absent
42
34
  .SH SEE ALSO
43
- mend(1), mend\-resource\-list(1), mend\-resource\-remove(1), mend\-resource\-approve(1)
35
+ mend(1), mend\-resource\-start(1)
@@ -0,0 +1,21 @@
1
+ .TH MEND-RESOURCE-ENV 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
+ .SH NAME
3
+ mend\-resource\-env \- print current resource env values
4
+ .SH SYNOPSIS
5
+ .B mend resource env [\-\-project\-id <p>] [\-\-worktree\-id <w>]
6
+ .br
7
+ .SH DESCRIPTION
8
+ .PP
9
+ Plain output prints shell exports. \-\-json returns only variable names and status observations, never environment values or exports. Project env and secrets take precedence. Printing values does not update your shell.
10
+ .SH OPTIONS
11
+ .TP
12
+ .B \-\-json
13
+ return the v1 command envelope with variable names only
14
+ .TP
15
+ .B \-\-project\-id <p>
16
+ project name or id; default current checkout
17
+ .TP
18
+ .B \-\-worktree\-id <w>
19
+ worktree name or id; default current mend branch
20
+ .SH SEE ALSO
21
+ mend(1), mend\-resource\-use(1)
@@ -1,23 +1,21 @@
1
- .TH MEND-RESOURCE-LIST 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-RESOURCE-LIST 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
- mend\-resource\-list \- a project's resources: settings, proposals, mend.toml
3
+ mend\-resource\-list \- resource definitions and remembered instances
4
4
  .SH SYNOPSIS
5
- .B mend resource list [\-\-project <p>] [\-\-worktree <w>] [\-\-json]
5
+ .B mend resource list [\-\-project\-id <p>] [\-\-worktree\-id <w>] [\-\-json]
6
6
  .br
7
7
  .SH DESCRIPTION
8
8
  .PP
9
- One status line per resource, then the image it would run and its id: the definitions project settings hold, the proposals members made beside them, and, with \-\-worktree, the [resource.*] proposals in that worktree's mend.toml with the keys it refuses or ignores. A proposal runs nothing until a manager approves it in project settings.
10
- .PP
11
- Inside a session's workspace, mend resource list reads the session's own project and worktree. Proposing, removing, approving and choosing are a person's: run them from the web app, VS Code, the phone or mend on your machine.
9
+ Reads remembered instances and, with a worktree selected, its .mend/mend.toml definitions. Launching a session never starts a new resource. Project context comes from the current checkout or \-\-project\-id; worktree context comes from a mend/<name> branch or \-\-worktree\-id. Both selectors accept a name or id.
12
10
  .SH OPTIONS
13
11
  .TP
14
- .B \-\-project <p>
15
- the project by name, when the current directory is not inside it
12
+ .B \-\-project\-id <p>
13
+ project name or id; default current checkout
16
14
  .TP
17
- .B \-\-worktree <w>
18
- also read this worktree's mend.toml, by name
15
+ .B \-\-worktree\-id <w>
16
+ worktree name or id; default current mend branch
19
17
  .TP
20
18
  .B \-\-json
21
- print the page as JSON
19
+ return the v1 command envelope; definitions omit environment values and command text
22
20
  .SH SEE ALSO
23
- mend(1), mend\-resource\-add(1), mend\-resource\-remove(1)
21
+ mend(1), mend\-resource\-start(1), mend\-resource\-use(1)
@@ -0,0 +1,33 @@
1
+ .TH MEND-RESOURCE-LOAD 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
+ .SH NAME
3
+ mend\-resource\-load \- load a Postgres database from a dump or URL
4
+ .SH SYNOPSIS
5
+ .B mend resource load <name> (\-\-from <path|postgres\-url> | \-\-pull <postgres\-url>) [\-\-target shared|own] [\-\-project\-id <p>] [\-\-worktree\-id <w>]
6
+ .br
7
+ .SH DESCRIPTION
8
+ .PP
9
+ Streams a file or local pg_dump with \-\-from; \-\-pull dumps inside the resource. Installs the restored database and saves the previous data as a checked dump. A failed restore leaves the target unchanged. JSON output returns one terminal envelope. Timeout exits 124 with the last load id and observation; accepted server work keeps running, so inspect it before starting another load.
10
+ .SH OPTIONS
11
+ .TP
12
+ .B \-\-json
13
+ return the v1 command envelope without progress prose
14
+ .TP
15
+ .B \-\-timeout <duration>
16
+ bound the JSON load, default 10m
17
+ .TP
18
+ .B \-\-project\-id <p>
19
+ project name or id; default current checkout
20
+ .TP
21
+ .B \-\-worktree\-id <w>
22
+ worktree name or id; default current mend branch
23
+ .TP
24
+ .B \-\-target <t>
25
+ shared or own
26
+ .TP
27
+ .B \-\-from <source>
28
+ file or Postgres URL dumped locally
29
+ .TP
30
+ .B \-\-pull <url>
31
+ Postgres URL dumped by the resource
32
+ .SH SEE ALSO
33
+ mend(1), mend\-resource\-reset(1)
@@ -1,27 +1,27 @@
1
- .TH MEND-RESOURCE-REMOVE 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-RESOURCE-REMOVE 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
- mend\-resource\-remove \- remove a definition, or a proposal
3
+ mend\-resource\-remove \- archive one instance, keeping its volumes
4
4
  .SH SYNOPSIS
5
- .B mend resource remove <name> [\-\-project <p>]
6
- .br
7
- .B mend resource remove [<name>] \-\-proposal <id> [\-\-project <p>]
8
- .br
9
- .B mend resource remove [<name>] \-\-definition <id> [\-\-project <p>]
5
+ .B mend resource remove <name> \-\-project|\-\-worktree [\-\-project\-id <p>] [\-\-worktree\-id <w>]
10
6
  .br
11
7
  .SH DESCRIPTION
12
8
  .PP
13
- Removes what you may remove under that name: the definition project settings hold, which is a manager's act, or the one proposal of that name. A manager may remove anyone's proposal; a member only their own. When the name matches both, or several proposals, nothing is removed and each id is listed: name one with \-\-definition or \-\-proposal, by the id mend resource list prints. With a name too, the id must be of that name.
14
- .PP
15
- The line being removed prints first. A definition changed since it was read is not removed. Nothing runs yet, so removing deletes no data.
9
+ Archives the named instance and forgets its remembered start. Own Postgres databases stay until reset or worktree removal.
16
10
  .SH OPTIONS
17
11
  .TP
18
- .B \-\-proposal <id>
19
- the proposal to remove
12
+ .B \-\-json
13
+ return the v1 command envelope without prompts
14
+ .TP
15
+ .B \-\-project\-id <p>
16
+ project name or id; default current checkout
17
+ .TP
18
+ .B \-\-worktree\-id <w>
19
+ worktree name or id; default current mend branch
20
20
  .TP
21
- .B \-\-definition <id>
22
- the definition to remove
21
+ .B \-\-project
22
+ project level
23
23
  .TP
24
- .B \-\-project <p>
25
- the project by name, when the current directory is not inside it
24
+ .B \-\-worktree
25
+ worktree level
26
26
  .SH SEE ALSO
27
27
  mend(1), mend\-resource\-list(1)
@@ -0,0 +1,24 @@
1
+ .TH MEND-RESOURCE-RESET 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
+ .SH NAME
3
+ mend\-resource\-reset \- save then empty a Postgres database
4
+ .SH SYNOPSIS
5
+ .B mend resource reset <name> [\-\-target shared|own] [\-\-project\-id <p>] [\-\-worktree\-id <w>]
6
+ .br
7
+ .SH DESCRIPTION
8
+ .PP
9
+ Saves a checked dump before replacing the selected database. Own databases copy shared when it has tables; shared starts empty. A person's stop is held.
10
+ .SH OPTIONS
11
+ .TP
12
+ .B \-\-json
13
+ return the v1 command envelope without prompts
14
+ .TP
15
+ .B \-\-project\-id <p>
16
+ project name or id; default current checkout
17
+ .TP
18
+ .B \-\-worktree\-id <w>
19
+ worktree name or id; default current mend branch
20
+ .TP
21
+ .B \-\-target <t>
22
+ shared or own
23
+ .SH SEE ALSO
24
+ mend(1), mend\-resource\-load(1)
@@ -1,15 +1,36 @@
1
- .TH MEND-RESOURCE-START 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-RESOURCE-START 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
- mend\-resource\-start \- start a resource's instance
3
+ mend\-resource\-start \- start from this worktree's definition
4
4
  .SH SYNOPSIS
5
- .B mend resource start <name> [\-\-project <p>]
5
+ .B mend resource start <name> [\-\-project|\-\-worktree] [\-\-restart] [\-\-project\-id <p>] [\-\-worktree\-id <w>] [\-\-wait] [\-\-timeout <duration>] [\-\-json]
6
6
  .br
7
7
  .SH DESCRIPTION
8
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.
9
+ Choose project or worktree explicitly, or answer the terminal prompt. A different remembered definition needs \-\-restart; an interactive terminal names affected worktrees and asks before restarting. Postgres at worktree level makes an own database on the project server, copying shared data when it has tables. A missing table starts an existing instance as it last ran.
10
10
  .SH OPTIONS
11
11
  .TP
12
- .B \-\-project <p>
13
- the project by name, when the current directory is not inside it
12
+ .B \-\-json
13
+ return the v1 command envelope without terminal prompts; requires an explicit level and worktree id
14
+ .TP
15
+ .B \-\-wait
16
+ observe until running or a terminal failure; never repeat the start
17
+ .TP
18
+ .B \-\-timeout <duration>
19
+ bound the JSON start and wait, default 10m; timeout exits 124 and leaves the resource running
20
+ .TP
21
+ .B \-\-project
22
+ start the project instance
23
+ .TP
24
+ .B \-\-worktree
25
+ start this worktree's instance or own Postgres database
26
+ .TP
27
+ .B \-\-restart
28
+ replace the remembered definition, keeping volumes
29
+ .TP
30
+ .B \-\-project\-id <p>
31
+ project name or id
32
+ .TP
33
+ .B \-\-worktree\-id <w>
34
+ worktree name or id
14
35
  .SH SEE ALSO
15
- mend(1), mend\-resource\-list(1)
36
+ mend(1), mend\-resource\-stop(1), mend\-resource\-list(1)
@@ -0,0 +1,27 @@
1
+ .TH MEND-RESOURCE-STOP 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
+ .SH NAME
3
+ mend\-resource\-stop \- stop an instance, keeping its data
4
+ .SH SYNOPSIS
5
+ .B mend resource stop <name> [\-\-project|\-\-worktree] [\-\-project\-id <p>] [\-\-worktree\-id <w>]
6
+ .br
7
+ .SH DESCRIPTION
8
+ .PP
9
+ Defaults to the level this worktree uses. Stopping an own Postgres database stops the project server, which every worktree on it uses. A person's stop holds until a person starts it again.
10
+ .SH OPTIONS
11
+ .TP
12
+ .B \-\-json
13
+ return the v1 command envelope without prompts
14
+ .TP
15
+ .B \-\-project\-id <p>
16
+ project name or id; default current checkout
17
+ .TP
18
+ .B \-\-worktree\-id <w>
19
+ worktree name or id; default current mend branch
20
+ .TP
21
+ .B \-\-project
22
+ project level
23
+ .TP
24
+ .B \-\-worktree
25
+ worktree level
26
+ .SH SEE ALSO
27
+ mend(1), mend\-resource\-start(1)
@@ -1,18 +1,21 @@
1
- .TH MEND-RESOURCE-USE 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-RESOURCE-USE 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
- mend\-resource\-use \- choose how a worktree uses a project resource
3
+ mend\-resource\-use \- choose this worktree's resource level
4
4
  .SH SYNOPSIS
5
- .B mend resource use <name> <off|shared|own> \-\-worktree <w> [\-\-project <p>]
5
+ .B mend resource use <name> project|worktree|off [\-\-project\-id <p>] [\-\-worktree\-id <w>]
6
6
  .br
7
7
  .SH DESCRIPTION
8
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.
9
+ The target must already exist. shared and own are accepted aliases for project and worktree. A switch restarts running Services and tells live agents. Already\-running processes, including your shell, keep their old env values.
10
10
  .SH OPTIONS
11
11
  .TP
12
- .B \-\-worktree <w>
13
- the worktree, by name or id
12
+ .B \-\-json
13
+ return the v1 command envelope without prompts
14
14
  .TP
15
- .B \-\-project <p>
16
- the project by name, when the current directory is not inside it
15
+ .B \-\-project\-id <p>
16
+ project name or id; default current checkout
17
+ .TP
18
+ .B \-\-worktree\-id <w>
19
+ worktree name or id; default current mend branch
17
20
  .SH SEE ALSO
18
- mend(1), mend\-resource\-approve(1)
21
+ mend(1), mend\-resource\-env(1), mend\-resource\-start(1)
@@ -0,0 +1,21 @@
1
+ .TH MEND-RESPOND 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
+ .SH NAME
3
+ mend\-respond \- pass a person's explicit answer to a pending request
4
+ .SH SYNOPSIS
5
+ .B mend respond <request> [\-\-decision <decision> | \-\-answers <json|\->] [\-\-json]
6
+ .br
7
+ .SH DESCRIPTION
8
+ .PP
9
+ Show the request to the person first. Forward only their explicit decision or answers; an outside agent never grants permission itself. Answers are JSON keyed by question id, each containing an array of strings. \-\-answers \- reads stdin without printing it.
10
+ .SH OPTIONS
11
+ .TP
12
+ .B \-\-decision <decision>
13
+ accept, accept\-for\-session, decline or cancel
14
+ .TP
15
+ .B \-\-answers <json|\->
16
+ the person's answers keyed by question id, or \- for stdin
17
+ .TP
18
+ .B \-\-json
19
+ versioned response receipt
20
+ .SH SEE ALSO
21
+ mend(1), mend\-wait(1), mend\-history(1)
package/man/mend-resume.1 CHANGED
@@ -1,4 +1,4 @@
1
- .TH MEND-RESUME 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-RESUME 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-resume \- rejoin a settled session with its state restored
4
4
  .SH SYNOPSIS
package/man/mend-run.1 CHANGED
@@ -1,4 +1,4 @@
1
- .TH MEND-RUN 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-RUN 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-run \- run any command as a session
4
4
  .SH SYNOPSIS
@@ -0,0 +1,21 @@
1
+ .TH MEND-SCREEN-LOOK 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
+ .SH NAME
3
+ mend\-screen\-look \- save a current read\-only screen observation
4
+ .SH SYNOPSIS
5
+ .B mend screen look <session> \-\-out <path> [\-\-timeout <duration>] [\-\-json]
6
+ .br
7
+ .SH DESCRIPTION
8
+ .PP
9
+ Saves a fresh PNG with its screen id and observation time. Anyone who can view the session may observe it. This never starts a screen, takes input, acts on it or creates a proof artifact. The output path must not exist.
10
+ .SH OPTIONS
11
+ .TP
12
+ .B \-\-out <path>
13
+ new PNG path, written with private file permissions
14
+ .TP
15
+ .B \-\-timeout <duration>
16
+ bound the request and download, default 30s
17
+ .TP
18
+ .B \-\-json
19
+ return the v1 command envelope
20
+ .SH SEE ALSO
21
+ mend(1), mend\-preview(1), mend\-proof\-list(1)
@@ -1,4 +1,4 @@
1
- .TH MEND-SECRETS-ADD 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-SECRETS-ADD 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-secrets\-add \- keep a file as a secret file, or replace one
4
4
  .SH SYNOPSIS
@@ -1,4 +1,4 @@
1
- .TH MEND-SECRETS-RM 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-SECRETS-RM 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-secrets\-rm \- remove a secret file
4
4
  .SH SYNOPSIS
@@ -1,4 +1,4 @@
1
- .TH MEND-SECRETS 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-SECRETS 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-secrets \- your secret files: written into every session you launch
4
4
  .SH SYNOPSIS
@@ -1,4 +1,4 @@
1
- .TH MEND-SERVER-LOGS 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-SERVER-LOGS 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-server\-logs \- print a bounded tail of the installation's container logs
4
4
  .SH SYNOPSIS
@@ -1,4 +1,4 @@
1
- .TH MEND-SERVER-RESTART 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-SERVER-RESTART 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-server\-restart \- restart Mend using the same generation and pin
4
4
  .SH SYNOPSIS
@@ -1,4 +1,4 @@
1
- .TH MEND-SERVER-SETUP 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-SERVER-SETUP 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-server\-setup \- install or change the local Mend server, guided
4
4
  .SH SYNOPSIS
@@ -39,9 +39,21 @@ Docker Desktop on Linux and macOS, and OrbStack on macOS, expose client\-side pr
39
39
  Setup holds an exclusive process lock through startup and health checks. A busy lock reports its owner and manual recovery steps. Never remove a live lock. Private configuration uses immutable generations and an atomic active pointer; failed attempts retain credentials and never delete Docker volumes.
40
40
  .SH OPTIONS
41
41
  .TP
42
+ .B \-\-json
43
+ versioned server readiness; provide \-\-yes or explicit reachability flags
44
+ .TP
45
+ .B \-\-timeout <duration>
46
+ JSON setup deadline including subprocesses, for example 10m. Default: 20m
47
+ .TP
42
48
  .B \-\-yes
43
49
  no questions: a fresh install takes the defaults (this machine only, http://localhost:3105), an existing one keeps what is saved
44
50
  .TP
51
+ .B \-\-account\-email <email>
52
+ with \-\-json, create the first account and sign this CLI in; requires \-\-account\-name
53
+ .TP
54
+ .B \-\-account\-name <name>
55
+ the first account's display name; no password is supplied; the JSON returns its one\-time web setup link
56
+ .TP
45
57
  .B \-\-context <name>
46
58
  local Docker context to persist; the global context is unchanged. Answers the engine question. Default: DOCKER_CONTEXT on a fresh install, else the saved one
47
59
  .TP
@@ -114,12 +126,45 @@ declare loopback, private or public; kept across reruns and upgrades. public nee
114
126
  .B \-\-tenancy <v>
115
127
  declare single or multi; kept across reruns and upgrades. multi also sets the multi mode gate's variables
116
128
  .TP
129
+ .B \-\-session\-runtime <docker|boat>
130
+ where new sessions run; Docker by default. Saved across reruns and upgrades. Existing sessions keep their runtime. boat needs Boat set up (\-\-boat\-api\-key\-stdin) and the two remote workspace endpoints; unsupported environments are refused
131
+ .TP
132
+ .B \-\-boat\-deployment\-id <name>
133
+ optional: the name Mend labels this server's Boat VMs with, so servers sharing one Boat account keep apart. Not something Boat shows; setup picks one when it is left out. Kept across reruns and upgrades
134
+ .TP
135
+ .B \-\-boat\-api\-key\-stdin
136
+ read the Boat API key from standard input (pipe the key alone). Kept in server.env only; Boat stays set up across reruns and upgrades without it
137
+ .TP
138
+ .B \-\-boat\-resources
139
+ Boat sessions reach project resources such as @db through a resource gateway on this host, carried over Boat's HTTPS with no inbound port. The default
140
+ .TP
141
+ .B \-\-no\-boat\-resources
142
+ run Boat sessions without project resources, and no resource gateway on this host
143
+ .TP
144
+ .B \-\-no\-boat
145
+ forget Boat's key and settings. Sessions already on Boat stop working; new sessions need \-\-session\-runtime docker
146
+ .TP
117
147
  .B \-\-declare <item>
118
148
  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
119
149
  .TP
120
150
  .B \-\-undeclare <item>
121
151
  take one statement back; the others stay. Repeat for more
122
152
  .TP
153
+ .B \-\-session\-endpoint\-url <origin>
154
+ HTTPS origin remote workspaces reach for the session channel; set with \-\-blob\-store\-public\-url. Kept across reruns and upgrades. Configure TLS forwarding separately
155
+ .TP
156
+ .B \-\-blob\-store\-public\-url <origin>
157
+ HTTPS origin remote workspaces reach for the capture bucket; set with \-\-session\-endpoint\-url. Kept across reruns and upgrades. Configure TLS forwarding separately
158
+ .TP
159
+ .B \-\-session\-endpoint\-port <n>
160
+ publish the session channel on loopback for your TLS proxy. Default: 13106
161
+ .TP
162
+ .B \-\-blob\-store\-port <n>
163
+ publish the capture bucket on loopback for your TLS proxy. Default: 13900
164
+ .TP
165
+ .B \-\-no\-remote\-endpoints
166
+ remove the loopback listeners and use the internal Docker addresses again
167
+ .TP
123
168
  .B \-\-npm\-mirror, \-\-no\-npm\-mirror
124
169
  run or stop the npm mirror; kept across reruns and upgrades. Default: on
125
170
  .TP
@@ -1,4 +1,4 @@
1
- .TH MEND-SERVER-START 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-SERVER-START 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-server\-start \- start the selected server generation
4
4
  .SH SYNOPSIS
@@ -1,4 +1,4 @@
1
- .TH MEND-SERVER-STATUS 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-SERVER-STATUS 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-server\-status \- show the pin, generation, containers, edge, mirrors and posture
4
4
  .SH SYNOPSIS
@@ -11,5 +11,12 @@ Reads the existing installation without changing its files. A running Mend must
11
11
  Each mirror the install runs follows, as observed: whether its container runs, what its cache holds, and its traffic. For the npm mirror, the tarball requests in its log for the last 24 hours and how many the cache served; for the Docker mirror, layer and manifest requests since it started and how many the cache served.
12
12
  .PP
13
13
  Then the posture, declared beside observed. Declared is what this install's configuration says: the edge host, MEND_EXPOSURE and MEND_TENANCY, a default named as one. Observed is what was seen: whether the edge's container runs and whether Caddy's data holds a certificate for the host, and what the running server reports in its health, the exposure it runs with and how many public exposure gate items are open, the tenancy and which multi mode gate items are open. When this machine is signed in to the install as the operator, every item of both gates follows with its detail, as mend operator gate and mend operator exposure print them. None of it is a verdict: the report says what was declared and what was observed.
14
+ .SH OPTIONS
15
+ .TP
16
+ .B \-\-json
17
+ versioned observed readiness; exit 4 for stopped or unfinished prerequisites
18
+ .TP
19
+ .B \-\-timeout <duration>
20
+ JSON status deadline, for example 30s. Default: 20m
14
21
  .SH SEE ALSO
15
22
  mend(1), mend\-server\-logs(1), mend\-server\-start(1), mend\-operator\-gate(1), mend\-operator\-exposure(1)
@@ -1,4 +1,4 @@
1
- .TH MEND-SERVER-STOP 1 "" "mend 0.37.0\-next.1197" "mend manual"
1
+ .TH MEND-SERVER-STOP 1 "" "mend 0.37.0\-next.1397" "mend manual"
2
2
  .SH NAME
3
3
  mend\-server\-stop \- stop the server's containers without deleting data
4
4
  .SH SYNOPSIS