# lmcp Windows MSI build

This directory contains the WiX manifest and packaging files for the
Windows MSI build of lmcp.

## Workflow

```sh
# 1. Pull the Lua + LuaSocket runtime into pkg/lua/ (one-time, see below).
# 2. Sync the lmcp .lua sources from the root of the repo:
./sync.sh
# 3. Bump windows/lmcp.wxs `Version="…"` to match the release tag.
# 4. Invoke WiX:
candle.exe lmcp.wxs
light.exe lmcp.wixobj -o lmcp-1.x.y.msi
```

## What's tracked vs. generated

- **Tracked** (edit in git):
  - `lmcp.wxs` — WiX MSI manifest
  - `sync.sh` — copies root .lua sources → `pkg/`
  - `README.md` — this file
  - `pkg/install_service.bat` — Windows service installer
  - `pkg/start.bat` — manual launcher

- **Generated / external** (gitignored):
  - `pkg/lmcp.lua`, `pkg/server.lua`, `pkg/json.lua` — produced by
    `sync.sh`. Never edit directly; edit the root files and re-sync.
  - `pkg/lua/` — the Lua + LuaSocket runtime drop-in. Download
    separately and place here. Suggested source: the lua-binaries
    project (https://github.com/rjpcomputing/luaforwindows) or a
    similar pre-built bundle. The MSI expects `pkg/lua/lua.exe`,
    `pkg/lua/lua54.dll`, and the `pkg/lua/socket/` + `pkg/lua/mime/`
    subdirectories per the manifest.

## Issue history

Issue #18 (closed in v1.1.0) introduced this workflow after the
`pkg/` lua sources had silently drifted ~6 months out of date,
missing every feature added since April 2026.