devlanes 0.8.1 → 0.10.0

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/install.js CHANGED
@@ -61,7 +61,7 @@ function main() {
61
61
  const platform = `${process.platform}-${process.arch}`;
62
62
  const manifest = require.resolve(`@devlanes/${platform}/package.json`);
63
63
  const sourceDir = path.join(path.dirname(manifest), "bin");
64
- // `devlanes certs trust --hosts` looks for devlanes-hosts next to the resolved
64
+ // `devlanes setup` looks for devlanes-hosts next to the resolved
65
65
  // devlanes executable, so the helper moves first and the binary only with it.
66
66
  place(path.join(sourceDir, "devlanes-hosts"), "devlanes-hosts", ["version"]);
67
67
  place(path.join(sourceDir, "devlanes"), "devlanes", ["--version"]);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "devlanes",
3
- "version": "0.8.1",
3
+ "version": "0.10.0",
4
4
  "description": "Development environments in Git worktree lanes",
5
5
  "license": "Apache-2.0",
6
6
  "homepage": "https://devlanes.run",
@@ -30,11 +30,11 @@
30
30
  "node": ">=18"
31
31
  },
32
32
  "optionalDependencies": {
33
- "@devlanes/darwin-arm64": "0.8.1",
34
- "@devlanes/darwin-x64": "0.8.1",
35
- "@devlanes/linux-arm64": "0.8.1",
36
- "@devlanes/linux-x64": "0.8.1",
37
- "@devlanes/win32-arm64": "0.8.1",
38
- "@devlanes/win32-x64": "0.8.1"
33
+ "@devlanes/darwin-arm64": "0.10.0",
34
+ "@devlanes/darwin-x64": "0.10.0",
35
+ "@devlanes/linux-arm64": "0.10.0",
36
+ "@devlanes/linux-x64": "0.10.0",
37
+ "@devlanes/win32-arm64": "0.10.0",
38
+ "@devlanes/win32-x64": "0.10.0"
39
39
  }
40
40
  }
package/schema.json CHANGED
@@ -427,7 +427,7 @@
427
427
  "upstream"
428
428
  ],
429
429
  "enumDescriptions": [
430
- "Send the hostname the client requested, such as `api.acme-2.localhost`.",
430
+ "Send the hostname the client requested, such as `api.acme2.localhost`.",
431
431
  "Send the local address and port the proxy connects to, such as `127.0.0.1:<port>`."
432
432
  ],
433
433
  "examples": [
@@ -436,7 +436,7 @@
436
436
  ],
437
437
  "markdownDescription": "Host header sent to the unit behind a hostname.",
438
438
  "markdownEnumDescriptions": [
439
- "Send the hostname the client requested, such as `api.acme-2.localhost`.",
439
+ "Send the hostname the client requested, such as `api.acme2.localhost`.",
440
440
  "Send the local address and port the proxy connects to, such as `127.0.0.1:<port>`."
441
441
  ],
442
442
  "type": "string"
@@ -1382,13 +1382,13 @@
1382
1382
  "type": "null"
1383
1383
  }
1384
1384
  ],
1385
- "description": "Whether this project's hostnames are also written to `/etc/hosts`, for programs that cannot resolve `*.localhost` by themselves (Wrangler's workerd, musl or pure-Go binaries). Overrides the user's `hostnames.hosts_file` (default `auto`), except that a user `never` always wins. Writing needs the helper installed by `devlanes certs trust --hosts`, and only exact names are written, never wildcards.",
1385
+ "description": "Whether this project's hostnames are also written to `/etc/hosts`, for programs that cannot resolve `*.localhost` by themselves (Wrangler's workerd, musl or pure-Go binaries). Overrides the user's `hostnames.hosts_file` (default `auto`), except that a user `never` always wins. Writing needs the helper `devlanes setup` installs, and only exact names are written, never wildcards.",
1386
1386
  "examples": [
1387
1387
  "auto",
1388
1388
  "never",
1389
1389
  "always"
1390
1390
  ],
1391
- "markdownDescription": "Whether this project's hostnames are also written to `/etc/hosts`, for programs that cannot resolve `*.localhost` by themselves (Wrangler's workerd, musl or pure-Go binaries). Overrides the user's `hostnames.hosts_file` (default `auto`), except that a user `never` always wins. Writing needs the helper installed by `devlanes certs trust --hosts`, and only exact names are written, never wildcards."
1391
+ "markdownDescription": "Whether this project's hostnames are also written to `/etc/hosts`, for programs that cannot resolve `*.localhost` by themselves (Wrangler's workerd, musl or pure-Go binaries). Overrides the user's `hostnames.hosts_file` (default `auto`), except that a user `never` always wins. Writing needs the helper `devlanes setup` installs, and only exact names are written, never wildcards."
1392
1392
  },
1393
1393
  "matrix": {
1394
1394
  "description": "Fixed values per lane instead of computed `vars`: entry N holds lane N's values, read as `lane.<name>`. A lane whose index has no entry fails to resolve. Cannot be combined with `vars`.",
@@ -1399,7 +1399,7 @@
1399
1399
  "port": 20000
1400
1400
  },
1401
1401
  {
1402
- "domain": "acme-1.localhost",
1402
+ "domain": "acme1.localhost",
1403
1403
  "port": 20100
1404
1404
  }
1405
1405
  ]
@@ -1420,7 +1420,7 @@
1420
1420
  "port": 20000
1421
1421
  },
1422
1422
  {
1423
- "domain": "acme-1.localhost",
1423
+ "domain": "acme1.localhost",
1424
1424
  "port": 20100
1425
1425
  }
1426
1426
  ],
@@ -1504,20 +1504,20 @@
1504
1504
  "vars": {
1505
1505
  "additionalProperties": {
1506
1506
  "$ref": "#/$defs/Templated_Scalar",
1507
- "description": "Values computed for each lane and read as `${{ lane.<name> }}`, such as a database name, vhost, bucket or Redis index per lane. A var named `domain` replaces the default lane domain, and one named `port` fixes where the lane's port block starts. Cannot be combined with `matrix`.",
1507
+ "description": "Values computed for each lane and read as `${{ lane.<name> }}`, such as a database name, vhost, bucket or Redis index per lane. A var named `domain` replaces the default lane domain, and one named `port` fixes where the lane's port block starts. `${{ domain('pages') }}` gives a name a site of its own in each lane, such as `pages2.localhost` in lane 2. Cannot be combined with `matrix`.",
1508
1508
  "examples": [
1509
1509
  "acme_${{ lane.name }}"
1510
1510
  ],
1511
- "markdownDescription": "Values computed for each lane and read as `${{ lane.<name> }}`, such as a database name, vhost, bucket or Redis index per lane. A var named `domain` replaces the default lane domain, and one named `port` fixes where the lane's port block starts. Cannot be combined with `matrix`."
1511
+ "markdownDescription": "Values computed for each lane and read as `${{ lane.<name> }}`, such as a database name, vhost, bucket or Redis index per lane. A var named `domain` replaces the default lane domain, and one named `port` fixes where the lane's port block starts. `${{ domain('pages') }}` gives a name a site of its own in each lane, such as `pages2.localhost` in lane 2. Cannot be combined with `matrix`."
1512
1512
  },
1513
1513
  "default": {},
1514
- "description": "Values computed for each lane and read as `${{ lane.<name> }}`, such as a database name, vhost, bucket or Redis index per lane. A var named `domain` replaces the default lane domain, and one named `port` fixes where the lane's port block starts. Cannot be combined with `matrix`.",
1514
+ "description": "Values computed for each lane and read as `${{ lane.<name> }}`, such as a database name, vhost, bucket or Redis index per lane. A var named `domain` replaces the default lane domain, and one named `port` fixes where the lane's port block starts. `${{ domain('pages') }}` gives a name a site of its own in each lane, such as `pages2.localhost` in lane 2. Cannot be combined with `matrix`.",
1515
1515
  "examples": [
1516
1516
  {
1517
1517
  "db_name": "acme_${{ lane.name }}"
1518
1518
  }
1519
1519
  ],
1520
- "markdownDescription": "Values computed for each lane and read as `${{ lane.<name> }}`, such as a database name, vhost, bucket or Redis index per lane. A var named `domain` replaces the default lane domain, and one named `port` fixes where the lane's port block starts. Cannot be combined with `matrix`.",
1520
+ "markdownDescription": "Values computed for each lane and read as `${{ lane.<name> }}`, such as a database name, vhost, bucket or Redis index per lane. A var named `domain` replaces the default lane domain, and one named `port` fixes where the lane's port block starts. `${{ domain('pages') }}` gives a name a site of its own in each lane, such as `pages2.localhost` in lane 2. Cannot be combined with `matrix`.",
1521
1521
  "type": "object"
1522
1522
  }
1523
1523
  },
@@ -3376,11 +3376,11 @@
3376
3376
  "type": "object"
3377
3377
  },
3378
3378
  "project": {
3379
- "description": "Project name, the same in every worktree of the repository. It builds each lane's default domain (`<project>.localhost` for lane 0, `<project>-<N>.localhost` for lane N), names lanes in commands (`acme@2`), the containers devlanes creates and `DEVLANES_PROJECT`, and other projects reach this one as `projects.<project>`. Lowercase letters, digits, dots, underscores and dashes.",
3379
+ "description": "Project name, the same in every worktree of the repository. It builds each lane's default domain (`<project>.localhost` for lane 0, `<project><N>.localhost` for lane N), names lanes in commands (`acme@2`), the containers devlanes creates and `DEVLANES_PROJECT`, and other projects reach this one as `projects.<project>`. Lowercase letters, digits, dots, underscores and dashes.",
3380
3380
  "examples": [
3381
3381
  "acme"
3382
3382
  ],
3383
- "markdownDescription": "Project name, the same in every worktree of the repository. It builds each lane's default domain (`<project>.localhost` for lane 0, `<project>-<N>.localhost` for lane N), names lanes in commands (`acme@2`), the containers devlanes creates and `DEVLANES_PROJECT`, and other projects reach this one as `projects.<project>`. Lowercase letters, digits, dots, underscores and dashes.",
3383
+ "markdownDescription": "Project name, the same in every worktree of the repository. It builds each lane's default domain (`<project>.localhost` for lane 0, `<project><N>.localhost` for lane N), names lanes in commands (`acme@2`), the containers devlanes creates and `DEVLANES_PROJECT`, and other projects reach this one as `projects.<project>`. Lowercase letters, digits, dots, underscores and dashes.",
3384
3384
  "type": "string"
3385
3385
  },
3386
3386
  "services": {
package/user-schema.json CHANGED
@@ -17,8 +17,8 @@
17
17
  "mkcert"
18
18
  ],
19
19
  "enumDescriptions": [
20
- "devlanes creates its own CA in `~/.devlanes/ca` on first use, limited to names under `localhost`, `test`, `internal`, `home.arpa` and `hostnames.tld`, so it cannot sign for real sites. Trust it once with `devlanes certs trust`.",
21
- "Load mkcert's existing root CA (from `mkcert -CAROOT`) instead, so browsers that already trust it need nothing new. HTTPS stays off when `mkcert` is not on `PATH`; the mkcert CA has no name limits, and `certs untrust` leaves it trusted."
20
+ "devlanes creates its own CA in `~/.devlanes/ca` on first use, limited to names under `localhost`, `test`, `internal`, `home.arpa` and `hostnames.tld`, so it cannot sign for real sites. Trust it once with `devlanes setup`.",
21
+ "Load mkcert's existing root CA (from `mkcert -CAROOT`) instead, so browsers that already trust it need nothing new. HTTPS stays off when `mkcert` is not on `PATH`; the mkcert CA has no name limits, and `devlanes setup --remove` leaves it trusted."
22
22
  ],
23
23
  "examples": [
24
24
  "devlanes",
@@ -26,8 +26,8 @@
26
26
  ],
27
27
  "markdownDescription": "Certificate authority that signs HTTPS certificates for lane hostnames.",
28
28
  "markdownEnumDescriptions": [
29
- "devlanes creates its own CA in `~/.devlanes/ca` on first use, limited to names under `localhost`, `test`, `internal`, `home.arpa` and `hostnames.tld`, so it cannot sign for real sites. Trust it once with `devlanes certs trust`.",
30
- "Load mkcert's existing root CA (from `mkcert -CAROOT`) instead, so browsers that already trust it need nothing new. HTTPS stays off when `mkcert` is not on `PATH`; the mkcert CA has no name limits, and `certs untrust` leaves it trusted."
29
+ "devlanes creates its own CA in `~/.devlanes/ca` on first use, limited to names under `localhost`, `test`, `internal`, `home.arpa` and `hostnames.tld`, so it cannot sign for real sites. Trust it once with `devlanes setup`.",
30
+ "Load mkcert's existing root CA (from `mkcert -CAROOT`) instead, so browsers that already trust it need nothing new. HTTPS stays off when `mkcert` is not on `PATH`; the mkcert CA has no name limits, and `devlanes setup --remove` leaves it trusted."
31
31
  ],
32
32
  "type": "string"
33
33
  },
@@ -213,25 +213,25 @@
213
213
  }
214
214
  ],
215
215
  "default": null,
216
- "description": "Whether lane hostnames are also written to `/etc/hosts`, for programs that do not resolve `*.localhost` themselves (workerd, musl or pure-Go binaries); defaults to `auto`, which writes them only when a probe at daemon start shows the system resolver fails `*.localhost`. `never` here wins over every project; otherwise a project's `lanes.hosts_file` replaces this value for that project. Writing needs the helper `devlanes certs trust --hosts` installs, only exact names are written (no wildcards), and `resolver: hosts_file` ignores this key.",
216
+ "description": "Whether lane hostnames are also written to `/etc/hosts`, for programs that do not resolve `*.localhost` themselves (workerd, musl or pure-Go binaries); defaults to `auto`, which writes them only when a probe at daemon start shows the system resolver fails `*.localhost`. `never` here wins over every project; otherwise a project's `lanes.hosts_file` replaces this value for that project. Writing needs the helper `devlanes setup` installs, only exact names are written (no wildcards), and `resolver: hosts_file` ignores this key.",
217
217
  "examples": [
218
218
  "auto",
219
219
  "never",
220
220
  "always"
221
221
  ],
222
- "markdownDescription": "Whether lane hostnames are also written to `/etc/hosts`, for programs that do not resolve `*.localhost` themselves (workerd, musl or pure-Go binaries); defaults to `auto`, which writes them only when a probe at daemon start shows the system resolver fails `*.localhost`. `never` here wins over every project; otherwise a project's `lanes.hosts_file` replaces this value for that project. Writing needs the helper `devlanes certs trust --hosts` installs, only exact names are written (no wildcards), and `resolver: hosts_file` ignores this key."
222
+ "markdownDescription": "Whether lane hostnames are also written to `/etc/hosts`, for programs that do not resolve `*.localhost` themselves (workerd, musl or pure-Go binaries); defaults to `auto`, which writes them only when a probe at daemon start shows the system resolver fails `*.localhost`. `never` here wins over every project; otherwise a project's `lanes.hosts_file` replaces this value for that project. Writing needs the helper `devlanes setup` installs, only exact names are written (no wildcards), and `resolver: hosts_file` ignores this key."
223
223
  },
224
224
  "resolver": {
225
225
  "$ref": "#/$defs/Resolver",
226
226
  "default": "localhost",
227
- "description": "Which domain lanes get and what makes their hostnames resolve; defaults to `localhost`. `resolver` also needs `tld` and a one-time `devlanes certs trust --resolver`; `public` is not supported yet.",
227
+ "description": "Which domain lanes get and what makes their hostnames resolve; defaults to `localhost`. `resolver` also needs `tld` and a one-time `devlanes setup`; `public` is not supported yet.",
228
228
  "examples": [
229
229
  "localhost",
230
230
  "hosts_file",
231
231
  "resolver",
232
232
  "public"
233
233
  ],
234
- "markdownDescription": "Which domain lanes get and what makes their hostnames resolve; defaults to `localhost`. `resolver` also needs `tld` and a one-time `devlanes certs trust --resolver`; `public` is not supported yet."
234
+ "markdownDescription": "Which domain lanes get and what makes their hostnames resolve; defaults to `localhost`. `resolver` also needs `tld` and a one-time `devlanes setup`; `public` is not supported yet."
235
235
  },
236
236
  "tld": {
237
237
  "default": null,
@@ -660,9 +660,9 @@
660
660
  "public"
661
661
  ],
662
662
  "enumDescriptions": [
663
- "Lane domains end in `.localhost` (`acme.localhost`, `acme-2.localhost`), which browsers and many system resolvers send to loopback by themselves. `hosts_file` covers programs that do not.",
664
- "Keep `.localhost` names and always write exact hostnames to `/etc/hosts`, as `hosts_file: always` does, whatever `hosts_file` says; a project's `lanes.hosts_file` still takes precedence. Needs the helper from `devlanes certs trust --hosts`.",
665
- "Lane domains become `<project>.<tld>` and `<project>-<N>.<tld>`, answered by a DNS server the daemon runs on `127.0.0.1:15353`, so wildcard hostnames resolve too for programs that use the system resolver. Needs `tld` and a one-time `devlanes certs trust --resolver`; projects that set `lanes.vars.domain` or `lanes.matrix` keep their own domains.",
663
+ "Lane domains end in `.localhost` (`acme.localhost`, `acme2.localhost`), which browsers and many system resolvers send to loopback by themselves. `hosts_file` covers programs that do not.",
664
+ "Keep `.localhost` names and always write exact hostnames to `/etc/hosts`, as `hosts_file: always` does, whatever `hosts_file` says; a project's `lanes.hosts_file` still takes precedence. Needs the helper `devlanes setup` installs.",
665
+ "Lane domains become `<project>.<tld>` and `<project><N>.<tld>`, and so do the names `domain()` returns. They are answered by a DNS server the daemon runs on `127.0.0.1:15353`, so wildcard hostnames resolve too for programs that use the system resolver. Needs `tld` and a one-time `devlanes setup`. Projects that set `lanes.vars.domain` or `lanes.matrix` keep their own domains, and `domain()` gives them `.localhost` names.",
666
666
  "Reserved for public DNS names with DNS-01 certificates; not supported yet, so the config is rejected."
667
667
  ],
668
668
  "examples": [
@@ -673,9 +673,9 @@
673
673
  ],
674
674
  "markdownDescription": "Strategy that makes lane hostnames resolve to this machine.",
675
675
  "markdownEnumDescriptions": [
676
- "Lane domains end in `.localhost` (`acme.localhost`, `acme-2.localhost`), which browsers and many system resolvers send to loopback by themselves. `hosts_file` covers programs that do not.",
677
- "Keep `.localhost` names and always write exact hostnames to `/etc/hosts`, as `hosts_file: always` does, whatever `hosts_file` says; a project's `lanes.hosts_file` still takes precedence. Needs the helper from `devlanes certs trust --hosts`.",
678
- "Lane domains become `<project>.<tld>` and `<project>-<N>.<tld>`, answered by a DNS server the daemon runs on `127.0.0.1:15353`, so wildcard hostnames resolve too for programs that use the system resolver. Needs `tld` and a one-time `devlanes certs trust --resolver`; projects that set `lanes.vars.domain` or `lanes.matrix` keep their own domains.",
676
+ "Lane domains end in `.localhost` (`acme.localhost`, `acme2.localhost`), which browsers and many system resolvers send to loopback by themselves. `hosts_file` covers programs that do not.",
677
+ "Keep `.localhost` names and always write exact hostnames to `/etc/hosts`, as `hosts_file: always` does, whatever `hosts_file` says; a project's `lanes.hosts_file` still takes precedence. Needs the helper `devlanes setup` installs.",
678
+ "Lane domains become `<project>.<tld>` and `<project><N>.<tld>`, and so do the names `domain()` returns. They are answered by a DNS server the daemon runs on `127.0.0.1:15353`, so wildcard hostnames resolve too for programs that use the system resolver. Needs `tld` and a one-time `devlanes setup`. Projects that set `lanes.vars.domain` or `lanes.matrix` keep their own domains, and `domain()` gives them `.localhost` names.",
679
679
  "Reserved for public DNS names with DNS-01 certificates; not supported yet, so the config is rejected."
680
680
  ],
681
681
  "type": "string"
@@ -1021,7 +1021,7 @@
1021
1021
  },
1022
1022
  "TlsConfig": {
1023
1023
  "additionalProperties": false,
1024
- "description": "Certificate authority behind the proxy's HTTPS certificates, and the stores `devlanes certs trust` installs it into.",
1024
+ "description": "Certificate authority behind the proxy's HTTPS certificates, and the stores `devlanes setup` installs it into.",
1025
1025
  "examples": [
1026
1026
  {
1027
1027
  "ca": "devlanes",
@@ -1031,7 +1031,7 @@
1031
1031
  ]
1032
1032
  }
1033
1033
  ],
1034
- "markdownDescription": "Certificate authority behind the proxy's HTTPS certificates, and the stores `devlanes certs trust` installs it into.",
1034
+ "markdownDescription": "Certificate authority behind the proxy's HTTPS certificates, and the stores `devlanes setup` installs it into.",
1035
1035
  "properties": {
1036
1036
  "ca": {
1037
1037
  "$ref": "#/$defs/CaKind",
@@ -1045,7 +1045,7 @@
1045
1045
  },
1046
1046
  "trust": {
1047
1047
  "default": [],
1048
- "description": "Stores `devlanes certs trust` installs the CA into and `certs untrust` removes it from; an empty list means `[system]`. On Linux, browsers do not read the system store, so add `chrome` and `firefox` there; inside WSL add `windows` for browsers on Windows. `devlanes doctor` shows each store's state.",
1048
+ "description": "Stores `devlanes setup` installs the CA into and `devlanes setup --remove` removes it from; an empty list means `[system]`. On Linux, browsers do not read the system store, so add `chrome` and `firefox` there; inside WSL add `windows` for browsers on Windows. `devlanes doctor` shows each store's state.",
1049
1049
  "examples": [
1050
1050
  [
1051
1051
  "system",
@@ -1061,7 +1061,7 @@
1061
1061
  ],
1062
1062
  "items": {
1063
1063
  "$ref": "#/$defs/TrustTarget",
1064
- "description": "Certificate store that `devlanes certs trust` installs the CA into.",
1064
+ "description": "Certificate store that `devlanes setup` installs the CA into.",
1065
1065
  "examples": [
1066
1066
  "system",
1067
1067
  "firefox",
@@ -1070,16 +1070,16 @@
1070
1070
  "ios-simulator",
1071
1071
  "android-emulator"
1072
1072
  ],
1073
- "markdownDescription": "Certificate store that `devlanes certs trust` installs the CA into."
1073
+ "markdownDescription": "Certificate store that `devlanes setup` installs the CA into."
1074
1074
  },
1075
- "markdownDescription": "Stores `devlanes certs trust` installs the CA into and `certs untrust` removes it from; an empty list means `[system]`. On Linux, browsers do not read the system store, so add `chrome` and `firefox` there; inside WSL add `windows` for browsers on Windows. `devlanes doctor` shows each store's state.",
1075
+ "markdownDescription": "Stores `devlanes setup` installs the CA into and `devlanes setup --remove` removes it from; an empty list means `[system]`. On Linux, browsers do not read the system store, so add `chrome` and `firefox` there; inside WSL add `windows` for browsers on Windows. `devlanes doctor` shows each store's state.",
1076
1076
  "type": "array"
1077
1077
  }
1078
1078
  },
1079
1079
  "type": "object"
1080
1080
  },
1081
1081
  "TrustTarget": {
1082
- "description": "Certificate store that `devlanes certs trust` installs the CA into.",
1082
+ "description": "Certificate store that `devlanes setup` installs the CA into.",
1083
1083
  "enum": [
1084
1084
  "system",
1085
1085
  "firefox",
@@ -1092,7 +1092,7 @@
1092
1092
  "The OS store: the login keychain on macOS, read by Safari, Chrome, Edge and `/usr/bin/curl`; on Linux, the distribution's CA anchors, updated through sudo.",
1093
1093
  "Every Firefox profile's certificate database, through `certutil` from the NSS tools (`brew install nss`, or `libnss3-tools` / `nss-tools` on Linux).",
1094
1094
  "The store Chrome and Chromium read: `~/.pki/nssdb` through `certutil` on Linux, the same login keychain as `system` on macOS.",
1095
- "The Windows user root store, read by Edge, Chrome and Firefox on Windows. For devlanes inside WSL, whose browser usually runs on Windows: it runs Windows' `certutil.exe` through interop, and Windows asks you to confirm each change. On Windows it is the same store as `system`; on macOS and Linux outside WSL `certs trust` reports it as unavailable.",
1095
+ "The Windows user root store, read by Edge, Chrome and Firefox on Windows. For devlanes inside WSL, whose browser usually runs on Windows: it runs Windows' `certutil.exe` through interop, and Windows asks you to confirm each change. On Windows it is the same store as `system`; on macOS and Linux outside WSL `devlanes setup` reports it as unavailable.",
1096
1096
  "Reserved for the iOS simulator; not supported yet, so it is dropped with a warning.",
1097
1097
  "Reserved for the Android emulator; not supported yet, so it is dropped with a warning."
1098
1098
  ],
@@ -1104,12 +1104,12 @@
1104
1104
  "ios-simulator",
1105
1105
  "android-emulator"
1106
1106
  ],
1107
- "markdownDescription": "Certificate store that `devlanes certs trust` installs the CA into.",
1107
+ "markdownDescription": "Certificate store that `devlanes setup` installs the CA into.",
1108
1108
  "markdownEnumDescriptions": [
1109
1109
  "The OS store: the login keychain on macOS, read by Safari, Chrome, Edge and `/usr/bin/curl`; on Linux, the distribution's CA anchors, updated through sudo.",
1110
1110
  "Every Firefox profile's certificate database, through `certutil` from the NSS tools (`brew install nss`, or `libnss3-tools` / `nss-tools` on Linux).",
1111
1111
  "The store Chrome and Chromium read: `~/.pki/nssdb` through `certutil` on Linux, the same login keychain as `system` on macOS.",
1112
- "The Windows user root store, read by Edge, Chrome and Firefox on Windows. For devlanes inside WSL, whose browser usually runs on Windows: it runs Windows' `certutil.exe` through interop, and Windows asks you to confirm each change. On Windows it is the same store as `system`; on macOS and Linux outside WSL `certs trust` reports it as unavailable.",
1112
+ "The Windows user root store, read by Edge, Chrome and Firefox on Windows. For devlanes inside WSL, whose browser usually runs on Windows: it runs Windows' `certutil.exe` through interop, and Windows asks you to confirm each change. On Windows it is the same store as `system`; on macOS and Linux outside WSL `devlanes setup` reports it as unavailable.",
1113
1113
  "Reserved for the iOS simulator; not supported yet, so it is dropped with a warning.",
1114
1114
  "Reserved for the Android emulator; not supported yet, so it is dropped with a warning."
1115
1115
  ],
@@ -1258,25 +1258,54 @@
1258
1258
  ],
1259
1259
  "type": "string"
1260
1260
  },
1261
+ "UpdateMode": {
1262
+ "description": "What devlanes does about newer releases.",
1263
+ "enum": [
1264
+ "disable",
1265
+ "notify",
1266
+ "auto"
1267
+ ],
1268
+ "enumDescriptions": [
1269
+ "Never look for releases; nothing is read from the network.",
1270
+ "Read the latest version from the registry devlanes was installed from, and show it in the TUI and in command output when it is newer. Nothing is installed.",
1271
+ "Like `notify`, and also install patch releases in the background where the install method allows it; they apply the next time you start devlanes at a terminal. Minor releases, which can break things before 1.0, still wait for you to update."
1272
+ ],
1273
+ "examples": [
1274
+ "disable",
1275
+ "notify",
1276
+ "auto"
1277
+ ],
1278
+ "markdownDescription": "What devlanes does about newer releases.",
1279
+ "markdownEnumDescriptions": [
1280
+ "Never look for releases; nothing is read from the network.",
1281
+ "Read the latest version from the registry devlanes was installed from, and show it in the TUI and in command output when it is newer. Nothing is installed.",
1282
+ "Like `notify`, and also install patch releases in the background where the install method allows it; they apply the next time you start devlanes at a terminal. Minor releases, which can break things before 1.0, still wait for you to update."
1283
+ ],
1284
+ "type": "string"
1285
+ },
1261
1286
  "UpdatesConfig": {
1262
1287
  "additionalProperties": false,
1263
- "description": "Release checks: the daemon reads the latest release's version once a day and commands print a one-line notice. Nothing is downloaded or installed.",
1288
+ "description": "Release checks: how the daemon looks for newer devlanes releases (`mode`). Changes apply after `devlanes daemon restart`.",
1264
1289
  "examples": [
1265
1290
  {
1266
- "check": false
1291
+ "mode": "disable"
1292
+ },
1293
+ {
1294
+ "mode": "auto"
1267
1295
  }
1268
1296
  ],
1269
- "markdownDescription": "Release checks: the daemon reads the latest release's version once a day and commands print a one-line notice. Nothing is downloaded or installed.",
1297
+ "markdownDescription": "Release checks: how the daemon looks for newer devlanes releases (`mode`). Changes apply after `devlanes daemon restart`.",
1270
1298
  "properties": {
1271
- "check": {
1272
- "default": true,
1273
- "description": "Have the daemon read the latest release's version from GitHub once a day; when it is newer, commands print the upgrade command on one line, at most once a day. Defaults to true; `DEVLANES_NO_UPDATE_CHECK=1` or a CI environment also turns it off.",
1299
+ "mode": {
1300
+ "$ref": "#/$defs/UpdateMode",
1301
+ "default": "notify",
1302
+ "description": "What devlanes does about newer releases: `notify` (the default) checks every 4 hours and when the TUI opens, and shows the new version; `auto` also installs patch releases in the background where the install method allows it; `disable` never checks. `DEVLANES_NO_UPDATE_CHECK=1` or a CI environment also turns checks off.",
1274
1303
  "examples": [
1275
- true,
1276
- false
1304
+ "disable",
1305
+ "notify",
1306
+ "auto"
1277
1307
  ],
1278
- "markdownDescription": "Have the daemon read the latest release's version from GitHub once a day; when it is newer, commands print the upgrade command on one line, at most once a day. Defaults to true; `DEVLANES_NO_UPDATE_CHECK=1` or a CI environment also turns it off.",
1279
- "type": "boolean"
1308
+ "markdownDescription": "What devlanes does about newer releases: `notify` (the default) checks every 4 hours and when the TUI opens, and shows the new version; `auto` also installs patch releases in the background where the install method allows it; `disable` never checks. `DEVLANES_NO_UPDATE_CHECK=1` or a CI environment also turns checks off."
1280
1309
  }
1281
1310
  },
1282
1311
  "type": "object"
@@ -1393,7 +1422,7 @@
1393
1422
  "resolver": "localhost",
1394
1423
  "tld": null
1395
1424
  },
1396
- "description": "How lane hostnames such as `api.acme-2.localhost` resolve to this machine: the strategy (`resolver`), its `tld`, and whether names also go into `/etc/hosts` (`hosts_file`). The defaults need no setup for browsers that resolve `*.localhost`.",
1425
+ "description": "How lane hostnames such as `api.acme2.localhost` resolve to this machine: the strategy (`resolver`), its `tld`, and whether names also go into `/etc/hosts` (`hosts_file`). The defaults need no setup for browsers that resolve `*.localhost`.",
1397
1426
  "examples": [
1398
1427
  {
1399
1428
  "hosts_file": "auto",
@@ -1404,7 +1433,7 @@
1404
1433
  "tld": "test"
1405
1434
  }
1406
1435
  ],
1407
- "markdownDescription": "How lane hostnames such as `api.acme-2.localhost` resolve to this machine: the strategy (`resolver`), its `tld`, and whether names also go into `/etc/hosts` (`hosts_file`). The defaults need no setup for browsers that resolve `*.localhost`."
1436
+ "markdownDescription": "How lane hostnames such as `api.acme2.localhost` resolve to this machine: the strategy (`resolver`), its `tld`, and whether names also go into `/etc/hosts` (`hosts_file`). The defaults need no setup for browsers that resolve `*.localhost`."
1408
1437
  },
1409
1438
  "lanes": {
1410
1439
  "$ref": "#/$defs/UserLanesConfig",
@@ -1615,7 +1644,7 @@
1615
1644
  "ca": "devlanes",
1616
1645
  "trust": []
1617
1646
  },
1618
- "description": "Which certificate authority signs the proxy's HTTPS certificates (`ca`), and which stores `devlanes certs trust` installs it into (`trust`).",
1647
+ "description": "Which certificate authority signs the proxy's HTTPS certificates (`ca`), and which stores `devlanes setup` installs it into (`trust`).",
1619
1648
  "examples": [
1620
1649
  {
1621
1650
  "ca": "devlanes",
@@ -1625,7 +1654,7 @@
1625
1654
  ]
1626
1655
  }
1627
1656
  ],
1628
- "markdownDescription": "Which certificate authority signs the proxy's HTTPS certificates (`ca`), and which stores `devlanes certs trust` installs it into (`trust`)."
1657
+ "markdownDescription": "Which certificate authority signs the proxy's HTTPS certificates (`ca`), and which stores `devlanes setup` installs it into (`trust`)."
1629
1658
  },
1630
1659
  "tui": {
1631
1660
  "$ref": "#/$defs/TuiConfig",
@@ -1653,15 +1682,18 @@
1653
1682
  "updates": {
1654
1683
  "$ref": "#/$defs/UpdatesConfig",
1655
1684
  "default": {
1656
- "check": true
1685
+ "mode": "notify"
1657
1686
  },
1658
- "description": "Daily check for a newer devlanes release; nothing is downloaded or installed.",
1687
+ "description": "Release checks: whether the daemon looks for newer devlanes releases (`mode`).",
1659
1688
  "examples": [
1660
1689
  {
1661
- "check": false
1690
+ "mode": "disable"
1691
+ },
1692
+ {
1693
+ "mode": "auto"
1662
1694
  }
1663
1695
  ],
1664
- "markdownDescription": "Daily check for a newer devlanes release; nothing is downloaded or installed."
1696
+ "markdownDescription": "Release checks: whether the daemon looks for newer devlanes releases (`mode`)."
1665
1697
  }
1666
1698
  },
1667
1699
  "type": "object"