You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: tools/AGENTS.md
+6-2Lines changed: 6 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,11 +8,11 @@ Follow the root `AGENTS.md` first. This file only records module-level boundarie
8
8
-`pnpm tools-dev` manages daemon -> web -> desktop.
9
9
-`pnpm tools-dev run web` runs foreground daemon + web for the Playwright webServer flow.
10
10
-`pnpm tools-dev inspect desktop ...` inspects the desktop runtime through sidecar IPC.
11
-
-`tools/pack` provides `@open-design/tools-pack` and the `tools-pack` bin. The active slice is mac-first packaged artifact build/install/start/stop/logs/uninstall/cleanup plus beta release artifact preparation.
11
+
-`tools/pack` provides `@open-design/tools-pack` and the `tools-pack` bin. The active slice is packaged artifact build/install/start/stop/logs/uninstall/cleanup/list/reset plus beta release artifact preparation for mac and Windows lanes.
12
12
13
13
## Packaging scope
14
14
15
-
- Keep `tools-pack` focused on mac packaging/runtime control and release artifact preparation. Runtime updater integration and Windows packaging remain later phases.
15
+
- Keep `tools-pack` focused on packaging/runtime control and release artifact preparation. Runtime updater product integration remains a later phase.
16
16
- Pack-specific Electron builder resources belong under `tools/pack/resources/`; do not reference app/docs/download assets directly from pack logic.
17
17
- Namespace controls packaged data/log/runtime/cache paths. Ports are transient transport details and must not participate in path decisions.
18
18
- The package/build boundary of root `pnpm build` is intentionally unchanged in this round and should be handled by the future `tools-pack` task.
- mac build/install/start/stop/logs/uninstall/cleanup smoke commands.
9
+
- Windows NSIS build/install/start/stop/logs/uninstall/cleanup/list/reset smoke commands.
10
+
- Windows registry observation/cleanup must go through `reg.exe` and stay scoped to entries matching the namespace install/uninstaller paths.
11
+
- Windows lifecycle logs must expose NSIS automation logs/markers/timings in addition to app runtime logs.
9
12
- Consuming sidecar/process/path primitives from `@open-design/sidecar-proto`, `@open-design/sidecar`, and `@open-design/platform`.
10
13
11
14
## Does not own
@@ -19,7 +22,7 @@ Follow the root `AGENTS.md` and `tools/AGENTS.md` first. This tool owns the repo
19
22
20
23
- Do not hand-build `--od-stamp-*` args; use `createProcessStampArgs` with `OPEN_DESIGN_SIDECAR_CONTRACT`.
21
24
- Do not use port numbers in data/log/runtime/cache path decisions. Namespace decides paths; ports are only transient transports.
22
-
- Release artifacts keep canonical `Open Design.app`; local tools-pack installs may use `Open Design.<namespace>.app` only as an install-path/app-bundle naming convention for developer multi-instance validation.
25
+
- Release artifacts keep canonical app identity (`Open Design.app` on mac, `Open Design.exe` inside the Windows installer); local tools-pack installs may use namespace-scoped install paths only as a developer multi-instance validation convention.
23
26
- Do not let namespace-named `.app` installs change data/log/runtime/cache path conventions.
24
27
- Use `--portable` for public/release artifacts so packaged config does not bake local tools-pack runtime roots from the build machine.
25
28
- Pack resource files used by electron-builder belong under `tools/pack/resources/`; do not point pack logic at Downloads, web public assets, docs assets, or other app-owned resource paths.
0 commit comments