lattex.git, branch agent-cli

Add CLI build scripts, README docs, and tsconfig reference

2026-09-13T04:05:47+00:00

- package.json: add build:cli, typecheck:cli, test:cli scripts
- README.md: add "Headless / Agent Mode (CLI)" section with full docs
- tsconfig.json: add tsconfig.cli.json reference

Co-Authored-By: Claude Opus 5

Add headless CLI for Overleaf project management (lattex-cli)

2026-09-13T04:05:38+00:00

New src/cli/ module providing a headless CLI for AI agents to work with
Overleaf projects from a server with no display. Commands: auth, projects,
clone, pull, status, push, compile.

Key design decisions:
- Uses Node.js https module (no Electron dependency), same approach as the
  existing MCP server in src/mcp/lattex.mjs
- Reuses overleafProtocol.ts for Socket.IO v0.9 parsing (pure, no Electron)
- Separate esbuild bundle (out/cli/lattex-cli.mjs) — does not touch the
  Electron app build
- 64 tests for arg parsing, file tree walking, diff logic, and log parsing

Files:
- src/cli/main.ts — CLI entry point with all commands
- src/cli/args.ts — argument parser
- src/cli/overleafApi.ts — Overleaf API client using https + ws
- src/cli/fileTree.ts — project root folder walker
- src/cli/localState.ts — per-clone state (.lattex-cli.json) and auth storage
- src/cli/diff.ts — local vs remote diff logic
- src/cli/logParser.ts — LaTeX compile log parser
- src/cli/test.ts — unit tests
- tsconfig.cli.json — TypeScript config for CLI

Co-Authored-By: Claude Opus 5

Fix main-document switching end to end; stable project-independent MCP path

2026-09-05T03:26:49+00:00

Main document: the app never called Overleaf's official settings endpoint,
so "Set as main document" only changed renderer state and agents had no way
to switch at all — compiles kept using the old root. Now:
- Right-click Set as main and the new set_main_file MCP tool both POST
  /project/:id/settings {rootDocId} (web parity, persists project-wide)
- Handle the rootDocUpdated broadcast: update the project snapshot, the
  renderer state, and rewrite CLAUDE.md/AGENTS.md — the guide's stale
  "Main file" line was teaching agents to compile the old root via
  main_file overrides
- Compile root resolution uses the sync bridge's live maps, so docs
  created mid-session resolve correctly (agent guide too)

MCP server location: Codex stores its MCP registration globally, and the
per-project path went stale when the project temp dir was cleaned up
("connection closed" on handshake). The bundled server now installs to
~/.lattex/lattex-mcp.mjs (project-independent, refreshed on connect; the
esbuild bundle since the raw source can't resolve node_modules from there)
and resolves the project at runtime: $LATTEX_PROJECT_DIR, cwd + ancestors,
legacy script location, then single live project in tmpdir. Register once,
works for every project.

Co-Authored-By: Claude Fable 5

Add in-app update check with one-click installer download

2026-08-18T12:30:17+00:00

On launch the home page checks the latest GitHub release; when a newer
version exists a bottom-right card offers Download (streams the right
installer for the platform into ~/Downloads and opens it), Later, or
Skip this version (remembered). Unsigned app rules out silent
auto-update on macOS, so installation stays a manual replace.

Co-Authored-By: Claude Fable 5

Add browser-style project tabs: persistent home + one tab per project

2026-08-18T12:24:40+00:00

The project list is now a persistent home tab; each opened project runs
in its own WebContentsView tab below a 38px tab strip (hidden when only
home is open). Background tabs stay fully live (sync, collab, terminals).

Main process: per-project singletons (socket, sync bridge, compilation
manager, MCP state, compile watcher) become per-tab ProjectSession
objects keyed by webContents.id; PTYs are scoped per webContents.
Hardened against races found in review: concurrent ot:connect dedupe,
teardown/reopen serialization on the shared sync dir, destroyed-window
guards on all bridge sends, real logout that closes project tabs.

Renderer: tabs strip in the home renderer (wt-* classes, distinct from
the editor's .tab-bar file tabs), project tabs boot from ?projectId= and
connect straight into the editor; Back closes the tab.

Co-Authored-By: Claude Fable 5

Upload Windows installer via gh CLI instead of electron-builder publisher

2026-07-30T03:12:40+00:00

The builder's GitHub publisher refuses to attach assets to releases
published more than two hours earlier.

Co-Authored-By: Claude Fable 5

Publish CI assets to the existing release, not a draft

2026-07-30T03:08:01+00:00

Co-Authored-By: Claude Fable 5

Quote npmRebuild flag for pwsh in Windows CI

2026-07-30T03:02:55+00:00

Co-Authored-By: Claude Fable 5

Windows CI: explicit verbose node-pty rebuild instead of install-app-deps

2026-07-30T02:59:30+00:00

@electron/rebuild swallows child-process output and hung indefinitely at
"preparing node-pty" on both windows-latest and windows-2022 images.
Skip lifecycle scripts during npm ci and rebuild node-pty for Electron
directly via node-gyp (verbose, 10-minute step timeout), then package
with npmRebuild=false.

Co-Authored-By: Claude Fable 5

Pin Windows CI to windows-2022 image

2026-07-30T02:29:24+00:00

windows-latest moved to Visual Studio 2026 in June 2026; node-gyp cannot
detect VS2026 yet (fails on v9, hangs on v11). Also add a 25-minute job
timeout and electron-builder debug output.

Co-Authored-By: Claude Fable 5