Files
Maciej Lisiewski 7062229090 chore(js): switch the workspaces from npm to pnpm
pnpm 12.15.0 (native executable) installs every JS workspace from one
pnpm-lock.yaml, imported from package-lock.json with the same resolved
versions. website/, the WhatsApp bridge and the photon sidecar stay separate
npm projects.

Configuration moves from .npmrc and the root manifest into
pnpm-workspace.yaml: the 14-day minimumReleaseAge and its excludes,
overrides, allowBuilds (the old allowScripts set, with strictDepBuilds
failing any unlisted build script), engineStrict, sideEffectsCache: false
(in-place rebuilds must not write into the store) and
verifyDepsBeforeRun: false (a `pnpm run` never installs).

The pnpm version is pinned in pm/lock.json and in root devEngines.
pmOnFail: ignore keeps that pin out of pnpm-lock.yaml: a leading pin
document makes osv-scanner read zero packages. scripts/build/node-deps.mjs
enforces the exact version instead, and every lock reader refuses a
multi-document lock. A root preinstall refuses `npm install`; devEngines
onFail is warn so npx (MCP servers, the tsc linter) keeps working inside
the checkout.

User-machine installs run --frozen-lockfile --trust-lockfile (release age is
checked when locking, in CI, not per user). node-deps removes npm-era
node_modules trees before the first pnpm install. Nix builds the store with
fetchPnpmDeps and a hash file that CI checks.
2026-11-06 04:08:24 +01:00

68 lines
3.5 KiB
Python

"""``hermes gui`` subcommand parser."""
from __future__ import annotations
from typing import Callable
def build_gui_parser(subparsers, *, cmd_gui: Callable) -> None:
"""Attach the ``gui`` subcommand to ``subparsers``."""
gui_parser = subparsers.add_parser(
"desktop", aliases=["gui"], help="Build and launch the native desktop app",
description="Launch the Hermes Electron desktop app. By default this installs "
"workspace Node dependencies, builds the current OS's unpacked "
"Electron app, then launches that packaged artifact.")
gui_parser.add_argument(
"--source", action="store_true",
help="Launch via `electron .` against apps/desktop/dist instead of the packaged app")
gui_parser.add_argument(
"--build-only", action="store_true",
help="Build the desktop app but do not launch it (used by the installer's --update flow)")
gui_parser.add_argument(
"--fake-boot", action="store_true",
help="Enable deterministic desktop boot delays for validating startup UI")
gui_parser.add_argument(
"--ignore-existing", action="store_true",
help="Skip the installed Hermes runtime (~/.hermes/hermes-agent) so no local "
"backend starts and Desktop offers connect or install instead. --hermes-root "
"and the bundled runtime still win; a runtime installed during this launch is used.")
gui_parser.add_argument(
"--hermes-root",
help="Override the Hermes source root used by Desktop (sets HERMES_DESKTOP_HERMES_ROOT)")
gui_parser.add_argument(
"--cwd",
help="Initial project directory for Desktop chat sessions (sets HERMES_DESKTOP_CWD)")
gui_parser.add_argument(
"--skip-build", action="store_true",
help="Skip pnpm install/package and launch the existing unpacked app from apps/desktop/release",
)
gui_parser.add_argument(
"--local", action="store_true",
help="Show the local-models UI in the desktop app (models pane, quickstart, picker rows)")
gui_parser.add_argument(
"--force-build", action="store_true",
help="Force a full rebuild even if the content stamp matches")
gui_parser.add_argument(
"--setup-tcc-identity", action="store_true",
help="macOS only: create/import a self-signed code-signing certificate "
"in the login keychain and point desktop.macos_signing_identity at "
"it, then re-sign the packaged app. Makes macOS TCC grants (Full "
"Disk Access, Accessibility, Files and Folders, microphone) survive "
"rebuilds with a certificate-anchored identity. Idempotent — safe "
"to re-run after updates.")
gui_parser.add_argument(
"--identity", default="Hermes Local Signing",
help="Certificate name to create/use for --setup-tcc-identity (default: Hermes Local Signing)",
)
gui_parser.add_argument(
"--install-apparmor-profile", action="store_true",
help="Linux only: install an AppArmor profile (sudo) that lets the packaged app use Chromium's "
"user-namespace sandbox on hosts with kernel.apparmor_restrict_unprivileged_userns=1 "
"(Ubuntu 23.10+), then exit. Survives rebuilds of the same checkout.")
gui_parser.add_argument(
"--close-preview",
action="store_true",
help="Close the preview pane and exit its fullscreen (out-of-band escape hatch when the pane captured all input)",
)
gui_parser.set_defaults(func=cmd_gui)