@codua/codeoutline-win32-x64 0.1.4 → 0.1.8

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/DISTRIBUTION.md CHANGED
@@ -109,17 +109,28 @@ to acquire this updater. Updating does not change npm's recorded package version
109
109
  ```sh
110
110
  codeoutline update --check
111
111
  codeoutline update
112
- codeoutline update --rollback
113
112
  ```
114
113
 
115
114
  Every command starts the newest verified installed version without requesting the
116
- network. `serve` then checks for updates in a background thread, so an unreachable
117
- update server never delays startup or requests; a verified update applies to the
118
- next launch, and failed checks are reported on stderr.
115
+ network. `serve` checks for updates in a background thread at startup and then
116
+ every hour while it runs, so an unreachable update server never delays startup or
117
+ requests; failed checks are reported on stderr. After installing an update, a
118
+ stdio service exits as soon as no request is in flight: MCP clients start it again
119
+ on the next request, now running the new version. The background service
120
+ (`codeoutline daemon`) likewise waits until idle, closes its port, starts the new
121
+ version detached from itself and exits, so exactly one service process remains.
122
+ A `serve --http` service keeps running and uses the update at its next start.
123
+ `CODEOUTLINE_EXIT_ON_UPDATE=1` or `0` overrides the stdio and `serve --http` defaults.
119
124
  Set `CODEOUTLINE_AUTO_UPDATE=0` to disable automatic checks. Manual update still works.
120
- Rollback switches between the two installed versions; after the first update it
121
- returns to the initial installation. Accepted sequence numbers are retained, so a
122
- rolled-back release is not immediately reinstalled by automatic checks.
125
+ Only the active update is kept. After installing, the updater deletes other
126
+ installed versions and the runtime cache, except versions a running process
127
+ still uses: each process started from an installed update holds a lease for as
128
+ long as it runs. On Windows the process keeps its lease file open; elsewhere the
129
+ file records its PID. Versions before 0.1.7 hold no lease, so they are
130
+ deleted only 7 days after cleanup first finds them inactive. There is no local
131
+ rollback: to return to the npm (or native) installation, delete
132
+ `~/.codeoutline/updates` and set `CODEOUTLINE_AUTO_UPDATE=0` so `serve` does not
133
+ reinstall the latest release.
123
134
 
124
135
  The default endpoint is `https://43.133.255.193:51215`, project `codeoutline`,
125
136
  channel `stable`. Packages pin the signing public key and the server's TLS CA in
@@ -133,13 +144,42 @@ Treat these overrides and the initial installation as trusted configuration.
133
144
  To publish, stage a fresh native package for each target with
134
145
  `UPDATE_SEQUENCE=N`; N must increase for every release (the 0.1.3 baseline is 3).
135
146
  Use `tools/update-release.lua` for a script-only change: it reuses the previous
136
- platform runtimes, replaces Lua scripts and native launchers, and produces signed
137
- complete bundles for all three platforms. Upload these as drafts before publishing
147
+ platform runtimes, replaces Lua scripts and native launchers, and with `KIND=scripts`
148
+ produces signed script bundles for all three platforms. Runtime binaries, native
149
+ libraries and their license files are omitted from downloads; their hashes are
150
+ signed as runtime references and checked before copying them from a compatible
151
+ local installation. Upload these as drafts before publishing
138
152
  the version to the desired channel. The updater
139
153
  checks signatures, file hashes, platform, version, sequence and runtime health
140
154
  before activating the directory. CI must produce each platform runtime; a Windows
141
155
  package cannot update a Linux or macOS installation.
142
156
 
157
+ ### Background service and login entry
158
+
159
+ A global npm installation runs `codeoutline install --npm` as its `postinstall`
160
+ script; local installs, `npx` and `--ignore-scripts` skip it, and it never fails the
161
+ installation. `install` registers a login entry for the installation it belongs to
162
+ (launchers pass it as `CODEOUTLINE_INITIAL`; installed updates are deleted when
163
+ unused, the initial installation is not), stops a running service and starts
164
+ `codeoutline daemon` detached. Each login entry runs the daemon once per login:
165
+
166
+ - Windows: `HKCU\Software\Microsoft\Windows\CurrentVersion\Run\CodeOutline`, run
167
+ under `conhost.exe --headless` so the console runtime shows no window.
168
+ - macOS: `~/Library/LaunchAgents/io.github.1dao.codeoutline.plist` with
169
+ `AbandonProcessGroup`, so launchd keeps the replacement the daemon starts.
170
+ - Linux: `~/.config/systemd/user/codeoutline.service` with `KillMode=process`.
171
+ Without a systemd user manager (WSL, containers) `install` reports that the
172
+ entry is missing; start `codeoutline daemon` at login another way.
173
+
174
+ The daemon starts the newest installed version (an installed update, or the
175
+ initial installation when an npm upgrade made it newer) and exits if a service
176
+ already answers on its port: Windows lets a second process bind a port the runtime
177
+ listens on. `codeoutline uninstall` removes the entry and asks the daemon to exit
178
+ by creating `~/.codeoutline/service-<port>.stop`, which it checks every second.
179
+ Services from 0.1.7 and earlier ignore that file; they exit after installing an
180
+ update. `CODEOUTLINE_AUTOSTART=0` skips the login entry; with `--npm` it also skips
181
+ starting the service.
182
+
143
183
  ### Make an all-platform script update with xnet
144
184
 
145
185
  For automatic releases, commit the feature changes and the release tools first,
@@ -171,18 +211,60 @@ applies the proxy to Git, GitHub CLI, npm, and XUpgate requests, including child
171
211
  upload/publish commands. It changes neither global Git/npm configuration nor the
172
212
  calling terminal's proxy environment.
173
213
 
174
- For script changes that only need XUpgate, use `MODE=update`. It reuses baseline
214
+ For script changes that only need XUpgate, use `MODE=update`. Unless `BASE` is
215
+ explicitly provided, it selects the newest locally available, published full CI
216
+ release with all three platforms and the current runtime commit. It reuses baseline
175
217
  runtimes, checks that their runtime commit matches the current submodule, and does
176
218
  not require GitHub CLI or npm publishing authentication:
177
219
 
178
220
  ```powershell
179
- .\bin\xnet.exe tools/release.lua MODE=update BASE=C:/release/0.1.3 LOG_STDERR=1 LOG_FILE=0
221
+ .\bin\xnet.exe tools/release.lua MODE=update LOG_STDERR=1 LOG_FILE=0
180
222
  ```
181
223
 
182
- This mode still commits/pushes the release version and tag; CI runs on the tag but
183
- the local tool does not wait for or publish its npm/GitHub artifacts. npm read
184
- access remains necessary for duplicate-version checks. The initial npm launcher
185
- is only upgraded by full npm publication, not an XUpgate script bundle.
224
+ Every mode first runs the Lua specs (`codeoutline_spec` with the native and pure
225
+ Lua scanners, `stability_spec`, `update_spec`). Runtime and full modes then run
226
+ the Node SDK and package tests; update mode skips them unless `NODE_TESTS=1`,
227
+ because script bundles ship no npm launcher.
228
+
229
+ Update mode commits the release version locally, builds the signed script
230
+ bundles, installs this machine's bundle through the real updater (including its
231
+ health check) and runs `explore` on a sample project with it. Only then does it
232
+ tag, push, upload and publish. If any of these local steps fail, the release
233
+ commit and output directory are removed; nothing is pushed or uploaded, and the
234
+ same version can be retried. CI runs on the pushed tag, but the local tool does
235
+ not wait for it or publish its npm/GitHub artifacts. npm read access remains
236
+ necessary for duplicate-version checks. The initial npm launcher is only
237
+ upgraded by full npm publication, not an XUpgate script bundle.
238
+
239
+ For native runtime/executable updates without publishing npm, use `MODE=runtime`:
240
+
241
+ ```powershell
242
+ .\bin\xnet.exe tools/release.lua MODE=runtime PROXY=socks5://127.0.0.1:1080 LOG_STDERR=1 LOG_FILE=0
243
+ ```
244
+
245
+ This waits for all-platform CI and publishes complete signed XUpgate bundles,
246
+ including the new executables. It requires GitHub CLI but does not publish npm or
247
+ create a GitHub Release. `MODE=full` retains the complete npm/GitHub/XUpgate workflow.
248
+ Both full bundles and script bundles install into immutable version directories;
249
+ active executables are never overwritten. `serve` installs in the background and
250
+ the next launch selects the verified scripts and matching executable.
251
+
252
+ Script bundles use protocol updater version 2. Existing 0.1.4 initial bootstraps
253
+ only understand updater version 1 and safely reject script bundles. They need a
254
+ one-time upgrade of the initial bootstrap (npm or native initial installation)
255
+ before using script-only updates; merely receiving a full update through the old
256
+ bootstrap does not replace that bootstrap. After that upgrade, both script and
257
+ executable updates can be delivered solely through XUpgate. Full bundles retain
258
+ updater version 1 for compatibility. A script bundle whose exact runtime hashes
259
+ are unavailable locally is rejected, preserving the active version; distribute
260
+ a compatible full update first. When a script package includes a signed reference
261
+ to that published full release, clients missing its runtime automatically download
262
+ and verify the referenced full package, cache only the required runtime files,
263
+ and activate the new script version after its health check. This does not activate
264
+ the intermediate full version. The server rejects references to unpublished full
265
+ releases; withdrawals and disabled projects are respected. If no full artifact is
266
+ available locally when building a manual script bundle, only local runtime reuse
267
+ is possible and missing compatible runtimes still cause a safe rejection.
186
268
 
187
269
  Use `DRY_RUN=1` to exercise prompting and remote version checks without changing
188
270
  files, commits, tags or publications. An explicit `VERSION` is also accepted; a
@@ -196,6 +278,22 @@ versions are retained rather than reverted. Inspect the error before retrying;
196
278
  after a partial release, use the recorded version and existing artifacts with the
197
279
  individual upload/publish commands instead of rebuilding that version.
198
280
 
281
+ If a full release stops after CI downloads and signed bundles have been created,
282
+ resume the same artifacts with `RESUME=<version>`:
283
+
284
+ ```powershell
285
+ .\bin\xnet.exe tools/release.lua RESUME=0.1.4 PROXY=socks5://127.0.0.1:1080 LOG_STDERR=1 LOG_FILE=0
286
+ ```
287
+
288
+ Resume verifies the recorded commit, local/remote tag, CI checksums, signatures and
289
+ remote draft hashes. It does not create a new version, commit, tag or build.
290
+ Published npm packages are skipped only when their registry shasum matches the
291
+ local tarball. npm publishing inherits the terminal so required authentication
292
+ prompts remain usable. Fix npm publishing authentication before retrying; login
293
+ alone may not meet the package's 2FA policy. `DRY_RUN=1` validates resume without
294
+ publishing anything. Earlier failures that lack complete CI artifacts or bundles
295
+ still need the individual repair commands.
296
+
199
297
  Run from the repository root. `BASE` contains the extracted CI packages under
200
298
  `codeoutline-<target>/native/package`. `OUTPUT` must be a new directory.
201
299
  Python is not required. OpenSSL must be on PATH for offline private-key signing;
@@ -205,7 +303,7 @@ Manual bundles record the real source commit/dirty state and are not marked as C
205
303
  release builds. Review and test the staged files before uploading.
206
304
 
207
305
  ```powershell
208
- .\bin\xnet.exe tools/update-release.lua ACTION=build BASE=C:/release/0.1.3 OUTPUT=C:/release/0.1.4 VERSION=0.1.4 SEQUENCE=4 KEY=C:/private/codeoutline.private.pem LOG_STDERR=1 LOG_FILE=0
306
+ .\bin\xnet.exe tools/update-release.lua ACTION=build KIND=scripts BASE=C:/release/0.1.3 OUTPUT=C:/release/0.1.5 VERSION=0.1.5 SEQUENCE=5 KEY=C:/private/codeoutline.private.pem LOG_STDERR=1 LOG_FILE=0
209
307
  ```
210
308
 
211
309
  Native directories are written under `OUTPUT/native/<target>`. Uploadable signed
@@ -219,8 +317,8 @@ The upload step checks existing remote hashes, so an interrupted upload can be
219
317
  retried with the same artifacts. Do not rebuild or overwrite an uploaded version.
220
318
 
221
319
  ```powershell
222
- .\bin\xnet.exe tools/update-release.lua ACTION=upload OUTPUT=C:/release/0.1.4 VERSION=0.1.4 SEQUENCE=4 CREDENTIAL_FILE=C:/private/xupgate-admin.env LOG_STDERR=1 LOG_FILE=0
223
- .\bin\xnet.exe tools/update-release.lua ACTION=publish OUTPUT=C:/release/0.1.4 VERSION=0.1.4 SEQUENCE=4 CHANNEL=stable CREDENTIAL_FILE=C:/private/xupgate-admin.env LOG_STDERR=1 LOG_FILE=0
320
+ .\bin\xnet.exe tools/update-release.lua ACTION=upload OUTPUT=C:/release/0.1.5 VERSION=0.1.5 SEQUENCE=5 CREDENTIAL_FILE=C:/private/xupgate-admin.env LOG_STDERR=1 LOG_FILE=0
321
+ .\bin\xnet.exe tools/update-release.lua ACTION=publish OUTPUT=C:/release/0.1.5 VERSION=0.1.5 SEQUENCE=5 CHANNEL=stable CREDENTIAL_FILE=C:/private/xupgate-admin.env LOG_STDERR=1 LOG_FILE=0
224
322
  ```
225
323
 
226
324
  `ACTION=publish` verifies that all three matching platform releases exist before
@@ -228,6 +326,16 @@ switching the channel. Both network actions default to the packaged HTTPS server
228
326
  and pinned CA; `URL` and `CA_FILE` can override them for another deployment.
229
327
  Existing services keep running; an installed update applies on the next launch.
230
328
 
329
+ The Lua updater regression runs with `npm test` when OpenSSL is available. An
330
+ opt-in real HTTPS protocol regression uses only xnet Lua and an isolated project:
331
+
332
+ ```powershell
333
+ .\bin\xnet.exe tests/lua/update_http_spec.lua CREDENTIAL_FILE=C:/private/xupgate-admin.env LOG_STDERR=1 LOG_FILE=0
334
+ ```
335
+
336
+ It tests full/script downloads, signature rejection, rollback and withdrawal,
337
+ then disables its test project. It never publishes a production CodeOutline version.
338
+
231
339
  The opt-in deployed integration test needs Python, OpenSSL, a staged Windows
232
340
  package, and the sibling XUpgate release builder:
233
341
 
@@ -236,5 +344,5 @@ python tests/update-deployed.py --stage .update-test/final --credential-file C:/
236
344
  ```
237
345
 
238
346
  The credential file contains `ADMIN_TOKEN=...`. The test creates a separate project,
239
- exercises manual and automatic updates, rollback and tamper rejection, and disables
347
+ exercises manual and automatic updates, pruning and tamper rejection, and disables
240
348
  the project on exit. It never publishes to the production CodeOutline channel.
package/README.md CHANGED
@@ -19,11 +19,7 @@ codeoutline --version
19
19
 
20
20
  A stdio server is a child process of its client, so every agent session (each Claude Code session, each Cursor window) starts its own copy and builds its own in-memory index. One HTTP service serves all sessions from a single process and a single index.
21
21
 
22
- ```sh
23
- codeoutline serve --http
24
- ```
25
-
26
- The service listens on `127.0.0.1:19876` and, without `--allow-root`, serves projects anywhere on the machine, so switching between projects on different drives needs no configuration. Only local processes can reach it, and they already have your file access. To restrict it anyway, repeat `--allow-root` for each directory tree to allow; a tree that is unavailable at startup, such as an unmounted drive, is reported and becomes usable once it appears.
22
+ A global npm installation starts that service in the background and registers it to start at login: a `Run` registry value on Windows, a LaunchAgent on macOS, and a systemd user unit on Linux; without a systemd user manager (WSL, containers), start `codeoutline daemon` at login yourself. The service installs updates and restarts itself into them, so after installation the only setup is registering its URL once.
27
23
 
28
24
  **Claude Code** (added globally, available in every project):
29
25
 
@@ -37,7 +33,11 @@ claude mcp add --transport http codeoutline --scope user http://127.0.0.1:19876/
37
33
  { "mcpServers": { "codeoutline": { "url": "http://127.0.0.1:19876/mcp" } } }
38
34
  ```
39
35
 
40
- A shared service has no project of its own: it uses the client's roots when the client provides them, and otherwise the agent passes `projectPath`, which the tools ask for when it is missing. Clients do not start an HTTP service, so start it at login (Task Scheduler on Windows, launchd on macOS, a systemd user unit on Linux). On Windows, supervise the native launcher rather than the npm one; see [DISTRIBUTION.md](docs/DISTRIBUTION.md).
36
+ `codeoutline install` does the same for a native installation, or after installing with `--ignore-scripts`; `--port` selects a port other than 19876. Set `CODEOUTLINE_AUTOSTART=0` when installing to skip the login entry. `codeoutline uninstall` stops the service and removes the entry; run it before `npm uninstall -g codeoutline`, which does not run package scripts. The service logs to `~/.codeoutline/logs`.
37
+
38
+ The service listens on `127.0.0.1:19876` and serves projects anywhere on the machine, so switching between projects on different drives needs no configuration. Only local processes can reach it, and they already have your file access. A shared service has no project of its own: it uses the client's roots when the client provides them, and otherwise the agent passes `projectPath`, which the tools ask for when it is missing.
39
+
40
+ To run an HTTP service yourself instead, for example restricted to some directories, start `codeoutline serve --http` and repeat `--allow-root` for each directory tree to allow; a tree that is unavailable at startup, such as an unmounted drive, is reported and becomes usable once it appears. Such a service installs updates but keeps running the old version until restarted; on Windows, supervise the native launcher rather than the npm one; see [DISTRIBUTION.md](docs/DISTRIBUTION.md).
41
41
 
42
42
  ### Alternative: stdio, one process per session
43
43
 
@@ -47,7 +47,7 @@ Use stdio when you do not want a resident service. Each session then starts and
47
47
  claude mcp add codeoutline --scope user -- codeoutline serve --stdio
48
48
  ```
49
49
 
50
- On Windows, Claude Code cannot start the `codeoutline.cmd` shim directly; use `-- cmd /c codeoutline serve --stdio`. For Cursor, set `"command": "codeoutline", "args": ["serve", "--stdio"]`.
50
+ On Windows, Claude Code cannot start the `codeoutline.cmd` shim directly; use `-- cmd /c codeoutline serve --stdio`. For Cursor, set `"command": "codeoutline", "args": ["serve", "--stdio"]`. A client that starts `codeoutline` with no arguments, as 0.1.7 recommended, gets the same stdio server.
51
51
 
52
52
  When no project is specified, the service uses, in order: the `projectPath` argument of the call, the `--project` option, the client's roots (the first directory returned by `roots/list`), and the directory the service was started in. Clients usually start a stdio service in the project directory, so a global configuration needs no project path. Access defaults to `--project` or the start directory; repeat `--allow-root` to allow more.
53
53
 
package/README.zh-CN.md CHANGED
@@ -19,11 +19,7 @@ codeoutline --version
19
19
 
20
20
  stdio 服务是客户端的子进程,每个智能体会话(每个 Claude Code 会话、每个 Cursor 窗口)都会各自启动一份,并各自建一份内存索引。HTTP 服务只用一个进程、一份索引,供所有会话共用。
21
21
 
22
- ```sh
23
- codeoutline serve --http
24
- ```
25
-
26
- 服务监听 `127.0.0.1:19876`。不传 `--allow-root` 时可访问本机任意位置的项目,在不同盘的项目之间切换无需额外配置;只有本机进程能连到它,而本机进程本来就有你的文件访问权限。仍想限制时,为每个允许的目录树重复一次 `--allow-root`;启动时不可用的目录(如未挂载的盘)只会给出提示,出现后即可使用。
22
+ 通过 npm 全局安装时,会在后台启动这个服务,并登记为登录时自动启动:Windows 写入注册表 `Run` 项,macOS 添加 LaunchAgent,Linux 添加 systemd 用户单元;没有 systemd 用户管理器时(WSL、容器),请自行在登录时运行 `codeoutline daemon`。服务会自行安装更新并重启到新版本,因此安装后只需登记一次它的地址。
27
23
 
28
24
  **Claude Code**(全局添加,在任意项目中可用):
29
25
 
@@ -37,7 +33,11 @@ claude mcp add --transport http codeoutline --scope user http://127.0.0.1:19876/
37
33
  { "mcpServers": { "codeoutline": { "url": "http://127.0.0.1:19876/mcp" } } }
38
34
  ```
39
35
 
40
- 共享服务没有自己的项目:客户端提供 roots 时使用 roots,否则由智能体传入 `projectPath`,缺少时工具会提示需要它。客户端不会启动 HTTP 服务,请让它随登录启动(Windows 用任务计划程序,macOS 用 launchd,Linux 用 systemd 用户单元)。Windows 上请托管原生启动器而不是 npm 启动器,原因见 [DISTRIBUTION.md](docs/DISTRIBUTION.md)。
36
+ 原生安装或使用 `--ignore-scripts` 安装后,运行 `codeoutline install` 完成同样的操作;`--port` 可指定 19876 以外的端口。安装时设置 `CODEOUTLINE_AUTOSTART=0` 可不登记自启动。`codeoutline uninstall` 会停止服务并删除自启动项;`npm uninstall -g codeoutline` 不会运行包脚本,请先运行它。服务日志位于 `~/.codeoutline/logs`。
37
+
38
+ 服务监听 `127.0.0.1:19876`,可访问本机任意位置的项目,在不同盘的项目之间切换无需额外配置;只有本机进程能连到它,而本机进程本来就有你的文件访问权限。共享服务没有自己的项目:客户端提供 roots 时使用 roots,否则由智能体传入 `projectPath`,缺少时工具会提示需要它。
39
+
40
+ 如需自行运行 HTTP 服务(例如只允许访问部分目录),启动 `codeoutline serve --http`,并为每个允许的目录树重复一次 `--allow-root`;启动时不可用的目录(如未挂载的盘)只会给出提示,出现后即可使用。这样的服务会安装更新,但在重启前继续运行旧版本;Windows 上请托管原生启动器而不是 npm 启动器,原因见 [DISTRIBUTION.md](docs/DISTRIBUTION.md)。
41
41
 
42
42
  ### 备选:stdio,每个会话一个进程
43
43
 
@@ -47,7 +47,7 @@ claude mcp add --transport http codeoutline --scope user http://127.0.0.1:19876/
47
47
  claude mcp add codeoutline --scope user -- codeoutline serve --stdio
48
48
  ```
49
49
 
50
- Windows 上 Claude Code 无法直接启动 `codeoutline.cmd`,请改用 `-- cmd /c codeoutline serve --stdio`。Cursor 配置为 `"command": "codeoutline", "args": ["serve", "--stdio"]`。
50
+ Windows 上 Claude Code 无法直接启动 `codeoutline.cmd`,请改用 `-- cmd /c codeoutline serve --stdio`。Cursor 配置为 `"command": "codeoutline", "args": ["serve", "--stdio"]`。客户端不带参数启动 `codeoutline`(0.1.7 推荐的写法)时,得到的也是这个 stdio 服务。
51
51
 
52
52
  未指定项目时,服务依次使用:调用参数 `projectPath`、启动参数 `--project`、客户端 roots(`roots/list` 返回的第一个目录)、服务启动目录。客户端通常在项目目录中启动 stdio 服务,因此全局配置无需写项目路径。访问范围默认为 `--project` 或启动目录,可用可重复的 `--allow-root` 扩大。
53
53
 
package/bin/xnet.exe CHANGED
Binary file
package/build-info.json CHANGED
@@ -1 +1 @@
1
- {"sha256":{"scripts/codeoutline/explore.lua":"d9e4e0d0179d00205df96ad0e7442e7bbc87e27481e6d27eb772ca302b5f35d3","scripts/xupgate/http_codec.lua":"a5b0f127105ba6dbd4a518a214ca55e22c7510e6b2fc8c25c325898d8346ef8c","scripts/codeoutline/lang/js.lua":"7a25a195356deeef7da3fdaf6e8a483b2a3a230cae3064e5dde2a3556fdcbda9","scripts/codeoutline/graph.lua":"1ef35f2e92e9db3bbe9b612bb0cb336a9b57b440c9a066e7ba3ef81574326834","scripts/xupgate/proxy.lua":"5bf532e7005f44555d6a5277336e5ad395af060585c13a1cdc2441de50e0dcff","keys/update-public.pem":"7ff853339e19631b20ed3fa2cf221daa31c581e2e84d161b344b8f06de6562a8","scripts/codeoutline/lang/lua.lua":"33b038192425e4db29251674e30c73b7a1af849789c49ff6430ee409c062f812","scripts/codeoutline/update_worker.lua":"b067e2ca95e729cb6b392171a2ddd80d06f7c313f3ab0484978664940364eb68","scripts/xupgate/signature.lua":"f07de8a4093d08cc69d3c1d8296d23318c5d81344ece788d4453a9b3b700f000","licenses/xnet2lua.txt":"1aa8af3df70f60f1ebf2d23e14c27af1606057ad9c32a9a0d15fd76cff257532","scripts/codeoutline/lang/python.lua":"f7219c04914673ee6bae387c222b09acd433596c746237bdd6650a4f4087b17c","scripts/codeoutline/version.lua":"955291f8ce69995ab9b24f691bbc2b5bed4b768242c077ae15c1fcb270cb4791","licenses/luajit.txt":"1b10a02c9474cb908da2d87bc908edd8798f9ad28d9a8c53fbd05c13227f7394","scripts/codeoutline/lang/rust.lua":"f7c21751b1ab08512a406f45bd53546dddfa98ff680b1374d29a4152ae110023","scripts/codeoutline/xscan.lua":"508d1fdccee4e856e0f198992bec45d7c8a9a3c191e0a5f71717741db9e00325","codeoutline":"8d00b52027511d56136c8bd345666d2a14ad49591313c80a016d6032f708c02b","codeoutline.cmd":"6414f7fac4c7e384d5b8e9e5e8a89731f7950b48dbe08bcbe149c1a70dbc4407","scripts/codeoutline/main.lua":"0a340e38b5a86753091d72f07a379203656fc39feaa3b54e505a8e93a6deefb0","licenses/libdeflate.txt":"41b60f2caab6bffdd5ba360687bd23ca653c0a1235c00380ecffc939b4cd8d75","LICENSE":"1b63179362acd482b4a9a07ca526b3fce6d9103dcded361de2159ade174568b6","README.zh-CN.md":"4c2ff0fe0b73b3052f067926e45f9f9792571d9d529c731567b2c0d3b1d2c844","licenses/rpmalloc.txt":"f6c10eb9ec349900767c3dcb8bc71fe4fba2aefea329f05e2608827188016c0f","licenses/mbedtls.txt":"9b405ef4c89342f5eae1dd828882f931747f71001cfba7d114801039b52ad09b","scripts/codeoutline/mcp.lua":"f14a2d0b9625544ad32309358121a5ff304839780f52d5c1c8ec548d56c5e901","README.md":"a1757e831f9d60d14cf318bd47cf8d9481a3e65b7bf99922064445d5d4913c89","scripts/codeoutline/path.lua":"407bd960c1ad04e5006b321ce33263393bb40eee5dee5c123be9b36d3ad10937","scripts/xupgate/client.lua":"4bcefd14802f5d44c7c7e5b5aeda25247957212605f426da8c9dfb84ed7f9758","scripts/codeoutline/cli.lua":"ba996c3c3def65aab08ba60141a7a98a19dfcc1bbe004ab5d8ea14a7f9f9a08b","DISTRIBUTION.md":"3b5b1ee53e37873a9fc0c4c65e590f63c42bf989fbd3e2e2ebce5565cbc578af","scripts/codeoutline/parse.lua":"ccda7a087dc90109fce7a1e64ebe1de0d7c7036990b81b3423ff14b4299bf38f","THIRD_PARTY.md":"a70238f26ec05b7be4b813fa49c337cfb4d3cd64c36fcd27401d121e0e6e38df","scripts/codeoutline/lang/c.lua":"1251352bcfac6b6d3704460e00b06cf4f41232144748b41b89db04a5ab594073","lib/xhttp_codec.lua":"a5b0f127105ba6dbd4a518a214ca55e22c7510e6b2fc8c25c325898d8346ef8c","scripts/xupgate/common.lua":"7eb979277887dfae16b325ffdab493673f01b96d00b9c1de11d8aca297368752","keys/update-ca.crt":"d9b5ec3d4628de9c5559871f39841a5f84d47c53ded4d58d6e3bba2b4c669a02","scripts/codeoutline/command.lua":"a2e6f938897407f99573779b71948968cd743e331ca2cd0076cc1a9170559c30","scripts/codeoutline/index.lua":"08c585a7cb264962ac04beb3bf5bc8a9dd22b4f85644b6fdd6a4e527843fbee9","scripts/codeoutline/update_sequence.lua":"cb35cf7e03925c2e901c14aee2deae88aaaff6922644b2f73b428dcba8020e90","scripts/codeoutline/lang/cpp.lua":"96aebcd8972d5272c11446257f37fe90c10f4130c3c1b5bb71c793d7c25456f4","scripts/codeoutline/lang/csharp.lua":"36ac648b8691c85b8c75d5bcb146fcdfc87992a278e4798f3eb194124e3df2bb","bin/xnet.exe":"20e40fbc28bc1496bb3f598c5776cb93a56cc74fccade4d6994c3f4e390580e0","scripts/codeoutline/service.lua":"597c435309abc0d8149b5e88095896c3bba6516146fd587d53b4b6fbf23a553c","scripts/codeoutline/control.lua":"1dfbea9f1397d9fb3c321c48a8d8ee7fc7928e864588226e55247bd548255bb4","scripts/codeoutline/common.lua":"ee775ed5b2f7ada7a02851f44b51bd4008bceacbf9700576a474e6732e3c03c2","scripts/codeoutline/index_worker.lua":"47f80807a458d5c706b1a54f60fb2200ae51f022b21d9039df44611035e9ac40","scripts/codeoutline/lang/go.lua":"f5717cbeabe6d30dad72c473fa445480d7fb6b5546bb262e5f4c46185f0959da","licenses/lua-cmsgpack.txt":"8edfdc5282278a1268d8a6ee52f9245f1a5fe3d1c8065be00330196b1de49873","scripts/codeoutline/text.lua":"75f9af87ff5ce62def74f69d8972a6b11ff660723fc5cf515369ee3012ff0675","scripts/xupgate/http_client.lua":"a189506c3d0fcc454f5e001fdeecdd6349a1019ea0970d11ce2fbfdf035166d6","scripts/codeoutline/http.lua":"33802130445b348ce607e9891d4a9789d34b18338bf5d296f56e0b3c7b0c5493","scripts/codeoutline/updater.lua":"633348e78ca018afca33bfedd3f17340a6400462bd3b5aaa6c57e83919d76f2a","scripts/codeoutline/lang/java.lua":"435b6ddcd231679db9e705a604344a3fb6c00b84cc20b2ecd210423ee0b376a6"},"updateSequence":4,"runtimeCommit":"f2c3ddfcbd3f04d7dd71543d0878d06e033519a0","lua":"LuaJIT 2.1.1774896198","version":"0.1.4","sourceCommit":"23b74bb62f48d65049d60ae36eb3501b4f713f56","target":"win32-x64","releaseReady":true,"note":"Release build from a clean checkout","sourceDirty":false}
1
+ {"sha256":{"scripts/codeoutline/lang/go.lua":"f5717cbeabe6d30dad72c473fa445480d7fb6b5546bb262e5f4c46185f0959da","scripts/codeoutline/text.lua":"75f9af87ff5ce62def74f69d8972a6b11ff660723fc5cf515369ee3012ff0675","scripts/codeoutline/explore.lua":"94f8d1e467a2220932cc2f6db8b90672111b05d42ba7cd2e30fb174da7b35e4a","licenses/rpmalloc.txt":"f6c10eb9ec349900767c3dcb8bc71fe4fba2aefea329f05e2608827188016c0f","scripts/codeoutline/lang/java.lua":"435b6ddcd231679db9e705a604344a3fb6c00b84cc20b2ecd210423ee0b376a6","scripts/codeoutline/updater.lua":"6cc97407d57f04f874155141021bc184de7fca56ce89c229adc403a454672c3f","scripts/codeoutline/graph.lua":"b2a99a18cfc5563f6bd4747b2c6fe280a32434e5722ad3cb1de32a01c0fc5a78","licenses/mbedtls.txt":"9b405ef4c89342f5eae1dd828882f931747f71001cfba7d114801039b52ad09b","README.md":"7dfce8ebe8fac01ae271a4e50264c6156be04ebe16869c6d2e2d4f1b6049a3a1","scripts/codeoutline/lang/js.lua":"7a25a195356deeef7da3fdaf6e8a483b2a3a230cae3064e5dde2a3556fdcbda9","scripts/xupgate/client.lua":"70207e88378ad11885284f251080b6325287661d6a1967fcc258644b380192bc","scripts/codeoutline/update_sequence.lua":"2007dc85060acefe127a1f06747f58f5f77d7410504ec177520f6e5dc4c70f55","scripts/codeoutline/http.lua":"3d957628ecc9592d57cc68a61e5d4229a71da501eb8fb3aa0bbb5e1cd772adf0","THIRD_PARTY.md":"a70238f26ec05b7be4b813fa49c337cfb4d3cd64c36fcd27401d121e0e6e38df","scripts/codeoutline/lang/lua.lua":"33b038192425e4db29251674e30c73b7a1af849789c49ff6430ee409c062f812","scripts/codeoutline/update_worker.lua":"7e2ec28e4b911d7b90fd97d0a4c0e2f5b295d1a9200c5c7250e47a99139ca550","scripts/codeoutline/index.lua":"92b55f73f41fecebdfe6bdb8cfba57288706d655fbdb359b5493d2732c176941","scripts/codeoutline/lang/python.lua":"f7219c04914673ee6bae387c222b09acd433596c746237bdd6650a4f4087b17c","scripts/codeoutline/version.lua":"f1a43bdca47fb7cd0d0211a5b6ef5c26abf18be48f321fc078d28941aaa4f93d","scripts/codeoutline/index_worker.lua":"46b83e51f0e3d49315e7b209f2daaf6345e2dcd43f5f275431058369d91937e3","scripts/xupgate/http_codec.lua":"a5b0f127105ba6dbd4a518a214ca55e22c7510e6b2fc8c25c325898d8346ef8c","scripts/codeoutline/lang/rust.lua":"f7c21751b1ab08512a406f45bd53546dddfa98ff680b1374d29a4152ae110023","licenses/xnet2lua.txt":"1aa8af3df70f60f1ebf2d23e14c27af1606057ad9c32a9a0d15fd76cff257532","codeoutline.cmd":"607b60c6d107becdb6793df8f41aaf2cff944baf69f5ece59dba990d0f24c13b","scripts/codeoutline/cli.lua":"ba996c3c3def65aab08ba60141a7a98a19dfcc1bbe004ab5d8ea14a7f9f9a08b","scripts/codeoutline/main.lua":"91f928171c98a51a89b3276863164acf462bdc20a2cfed7befab4ff6a1aeac24","DISTRIBUTION.md":"da4a1048fc9b44670fd6fcef97e7d92ac3f50d3523da1773930c49f7e2c38dc3","README.zh-CN.md":"21677989f9e8a87910a5e56e528479066e7a5a4fbef2ce1928e3d598f6dea316","bin/xnet.exe":"8084b7773145ace6c6080e8331bdb9c5f4bc4c7dafc2b187ef91b58963fa5e74","licenses/luajit.txt":"1b10a02c9474cb908da2d87bc908edd8798f9ad28d9a8c53fbd05c13227f7394","scripts/xupgate/signature.lua":"f07de8a4093d08cc69d3c1d8296d23318c5d81344ece788d4453a9b3b700f000","scripts/codeoutline/mcp.lua":"f14a2d0b9625544ad32309358121a5ff304839780f52d5c1c8ec548d56c5e901","scripts/codeoutline/command.lua":"61629057894c21791bc2119769a79064453417005023a6b567d6119bfa8a0f3e","LICENSE":"1b63179362acd482b4a9a07ca526b3fce6d9103dcded361de2159ade174568b6","scripts/codeoutline/lang/c.lua":"1251352bcfac6b6d3704460e00b06cf4f41232144748b41b89db04a5ab594073","scripts/xupgate/proxy.lua":"5bf532e7005f44555d6a5277336e5ad395af060585c13a1cdc2441de50e0dcff","codeoutline":"3d3970e488e077e8acd67d174b506a361d43578b3360c7b29f2ec3f0103ba899","scripts/codeoutline/parse.lua":"ccda7a087dc90109fce7a1e64ebe1de0d7c7036990b81b3423ff14b4299bf38f","scripts/codeoutline/common.lua":"2fb29df01ccd5e7b54233d829cabdcb6d7c28d4f7a7b100292c6da0c9f63815a","keys/update-ca.crt":"d9b5ec3d4628de9c5559871f39841a5f84d47c53ded4d58d6e3bba2b4c669a02","lib/xhttp_codec.lua":"a5b0f127105ba6dbd4a518a214ca55e22c7510e6b2fc8c25c325898d8346ef8c","scripts/codeoutline/lang/cpp.lua":"96aebcd8972d5272c11446257f37fe90c10f4130c3c1b5bb71c793d7c25456f4","keys/update-public.pem":"7ff853339e19631b20ed3fa2cf221daa31c581e2e84d161b344b8f06de6562a8","scripts/codeoutline/path.lua":"407bd960c1ad04e5006b321ce33263393bb40eee5dee5c123be9b36d3ad10937","scripts/codeoutline/control.lua":"1dfbea9f1397d9fb3c321c48a8d8ee7fc7928e864588226e55247bd548255bb4","licenses/libdeflate.txt":"41b60f2caab6bffdd5ba360687bd23ca653c0a1235c00380ecffc939b4cd8d75","scripts/xupgate/http_client.lua":"a189506c3d0fcc454f5e001fdeecdd6349a1019ea0970d11ce2fbfdf035166d6","scripts/codeoutline/lang/csharp.lua":"36ac648b8691c85b8c75d5bcb146fcdfc87992a278e4798f3eb194124e3df2bb","scripts/xupgate/common.lua":"86267648c0dbbd3a05f90de4d6e1dbee53ba57bf4801783c2ae636224b1f228c","scripts/codeoutline/service.lua":"186c6b22b5616cb0ff73bca0d5538df38aff790115a040f651ea483839188a6a","scripts/codeoutline/daemon.lua":"cd84983ee8db4da88bb4cf039e4f90eef617f413289d63d1b72d82a4edd94944","licenses/lua-cmsgpack.txt":"8edfdc5282278a1268d8a6ee52f9245f1a5fe3d1c8065be00330196b1de49873","scripts/codeoutline/xscan.lua":"bd95a1b0b7022d029a41aab615897502478b5834612505e8d299343cb5ca8ef9"},"releaseReady":true,"note":"Release build from a clean checkout","version":"0.1.8","updateSequence":8,"sourceDirty":false,"target":"win32-x64","runtimeCommit":"2d8803f860e88ec337cb85922a713b50bc55ee59","lua":"LuaJIT 2.1.1774896198","sourceCommit":"b23d4c3781ef0482097eff2f54ca4548bc3b36b8"}
package/codeoutline CHANGED
@@ -1,10 +1,12 @@
1
1
  #!/bin/sh
2
2
  set -eu
3
3
  base=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
4
+ CODEOUTLINE_INITIAL=$base
5
+ export CODEOUTLINE_INITIAL
4
6
  if [ -n "${CODEOUTLINE_LOG_DIR:-}" ]; then log_out="LOG_DIR=$CODEOUTLINE_LOG_DIR"; else log_out=LOG_FILE=0; fi
5
7
  if [ "${1:-}" != "update" ]; then
6
8
  if [ "${CODEOUTLINE_AUTO_UPDATE:-}" = "" ]; then
7
- if [ "${1:-}" = "serve" ]; then CODEOUTLINE_AUTO_UPDATE=1; else CODEOUTLINE_AUTO_UPDATE=0; fi
9
+ case "${1:-}" in serve|daemon|install) CODEOUTLINE_AUTO_UPDATE=1 ;; *) CODEOUTLINE_AUTO_UPDATE=0 ;; esac
8
10
  export CODEOUTLINE_AUTO_UPDATE
9
11
  fi
10
12
  selected=$("$base/bin/xnet" "$base/scripts/codeoutline/updater.lua" LOG_STDERR=1 LOG_FILE=0 LOG_LEVEL=ERROR ACTION=select) || selected="$base"
package/codeoutline.cmd CHANGED
@@ -4,9 +4,13 @@ if not defined CODEOUTLINE_LOG_LEVEL set "CODEOUTLINE_LOG_LEVEL=WARN"
4
4
  set "CODEOUTLINE_LOG_OUT=LOG_FILE=0"
5
5
  if defined CODEOUTLINE_LOG_DIR set "CODEOUTLINE_LOG_OUT=LOG_DIR=%CODEOUTLINE_LOG_DIR%"
6
6
  set "CODEOUTLINE_BASE=%~dp0"
7
+ set "CODEOUTLINE_INITIAL=%~dp0"
7
8
  if "%~1"=="update" goto run
8
9
  if not defined CODEOUTLINE_AUTO_UPDATE (
9
- if "%~1"=="serve" (set "CODEOUTLINE_AUTO_UPDATE=1") else (set "CODEOUTLINE_AUTO_UPDATE=0")
10
+ set "CODEOUTLINE_AUTO_UPDATE=0"
11
+ if "%~1"=="serve" set "CODEOUTLINE_AUTO_UPDATE=1"
12
+ if "%~1"=="daemon" set "CODEOUTLINE_AUTO_UPDATE=1"
13
+ if "%~1"=="install" set "CODEOUTLINE_AUTO_UPDATE=1"
10
14
  )
11
15
  for /f "usebackq delims=" %%R in (`""%~dp0bin\xnet.exe" "%~dp0scripts\codeoutline\updater.lua" LOG_STDERR=1 LOG_FILE=0 LOG_LEVEL=ERROR ACTION=select"`) do set "CODEOUTLINE_BASE=%%R\"
12
16
  :run
package/package.json CHANGED
@@ -1 +1 @@
1
- {"publishConfig":{"access":"public"},"description":"CodeOutline native runtime and Lua implementation for win32-x64","cpu":["x64","arm64"],"license":"BSD-2-Clause","repository":{"url":"git+https://github.com/1dao/codeoutline.git","type":"git"},"version":"0.1.4","name":"@codua/codeoutline-win32-x64","files":["bin/","lib/","keys/","scripts/","licenses/","LICENSE","codeoutline","codeoutline.cmd","build-info.json","*.md"],"os":["win32"]}
1
+ {"files":["bin/","lib/","keys/","scripts/","licenses/","LICENSE","codeoutline","codeoutline.cmd","build-info.json","*.md"],"publishConfig":{"access":"public"},"description":"CodeOutline native runtime and Lua implementation for win32-x64","os":["win32"],"cpu":["x64","arm64"],"license":"BSD-2-Clause","repository":{"type":"git","url":"git+https://github.com/1dao/codeoutline.git"},"name":"@codua/codeoutline-win32-x64","version":"0.1.8"}
@@ -1,21 +1,32 @@
1
1
  -- Unified CLI. Launch through codeoutline (npm/native) or xnet with LOG_STDERR=1.
2
2
  local source = assert(xutils.realpath(debug.getinfo(1, 'S').source:sub(2))):gsub('\\', '/')
3
3
  local scripts = assert(source:match('^(.*)/codeoutline/[^/]+$'))
4
+ local install = assert(scripts:match('^(.*)/scripts$'))
4
5
  package.path = scripts .. '/?.lua;' .. package.path
5
6
  local version = require('codeoutline.version')
6
7
  local help = [[CodeOutline - Lua code indexing and MCP
7
8
 
9
+ One shared background service serves every MCP client. A global npm install
10
+ starts it and registers it to start at login (codeoutline install does the same
11
+ for other installations); it keeps itself updated. Register its URL once:
12
+ claude mcp add --transport http codeoutline --scope user http://127.0.0.1:19876/mcp
13
+
8
14
  Usage:
15
+ codeoutline install [--port PORT]
16
+ codeoutline uninstall [--port PORT]
17
+ codeoutline daemon [--port PORT]
9
18
  codeoutline serve --stdio [--project PATH] [--allow-root PATH ...]
10
19
  codeoutline serve --http [--host HOST] [--port PORT] [--project PATH] [--allow-root PATH ...]
11
20
  codeoutline explore --project PATH --query QUERY [--budget BYTES]
12
21
  codeoutline status [--project PATH]
13
22
  codeoutline rebuild [--project PATH]
14
23
  codeoutline doctor [--project PATH]
15
- codeoutline update [--check | --rollback] [--channel CHANNEL]
24
+ codeoutline update [--check] [--channel CHANNEL]
16
25
  codeoutline --version
17
26
 
18
27
  HTTP options: --allow-host HOST, --allow-origin ORIGIN (repeatable).
28
+ install starts the background service and registers it at login; uninstall
29
+ stops it and removes that entry. daemon is the service itself.
19
30
  Remote HTTP requires CODEOUTLINE_TOKEN (at least 16 bytes).
20
31
  Local HTTP without --allow-root serves any project; stdio and remote HTTP
21
32
  default to --project or the working directory.
@@ -30,7 +41,14 @@ local function parse(args)
30
41
  -- are read by xnet itself; the launchers add them before user args.
31
42
  if not value:match('^LOG_[A-Z_]+=') then clean[#clean + 1] = value end
32
43
  end
33
- local command = clean[1] or '--help'
44
+ -- No command: an MCP client (redirected stdin) gets a stdio service, which
45
+ -- keeps registrations from 0.1.7 working; a terminal gets help. Windows
46
+ -- consoles are detected by the stdio service's first read.
47
+ local command = clean[1]
48
+ if not command then
49
+ local terminal = package.config:sub(1, 1) ~= '\\' and os.execute('test -t 0')
50
+ if terminal == true or terminal == 0 then command = '--help' else return 'serve', { stdio = true } end
51
+ end
34
52
  if command == '--help' or command == '-h' or command == '--version' then
35
53
  assert(#clean <= 1, 'unexpected arguments after ' .. command)
36
54
  return command, {}
@@ -38,8 +56,9 @@ local function parse(args)
38
56
  local allowed = {
39
57
  serve = { stdio = true, http = true, project = true, host = true, port = true,
40
58
  ['allow-root'] = true, ['allow-host'] = true, ['allow-origin'] = true },
59
+ daemon = { port = true }, install = { port = true, npm = true }, uninstall = { port = true },
41
60
  explore = { project = true, query = true, budget = true },
42
- update = { check = true, rollback = true, channel = true },
61
+ update = { check = true, channel = true },
43
62
  status = { project = true }, rebuild = { project = true }, doctor = { project = true },
44
63
  }
45
64
  assert(allowed[command], 'unknown command: ' .. command)
@@ -48,7 +67,7 @@ local function parse(args)
48
67
  local name, value = clean[i]:match('^%-%-([%w-]+)=(.*)$')
49
68
  if not name then name = clean[i]:match('^%-%-([%w-]+)$') end
50
69
  assert(name and (allowed[command][name] or name == 'help'), 'unknown option: ' .. clean[i])
51
- local flag = name == 'check' or name == 'rollback' or name == 'stdio' or name == 'http' or name == 'help'
70
+ local flag = name == 'check' or name == 'stdio' or name == 'http' or name == 'help' or name == 'npm'
52
71
  if flag then
53
72
  assert(value == nil, '--' .. name .. ' does not take a value')
54
73
  value = true
@@ -127,8 +146,72 @@ local function run()
127
146
  if command == '--help' or command == '-h' or options.help then io.write(help); return 0 end
128
147
  if command == '--version' then io.write(version, '\n'); return 0 end
129
148
  if command == 'update' then
130
- assert(not (options.check and options.rollback), '--check and --rollback are mutually exclusive')
131
- return require('codeoutline.updater').run(options.check and 'check' or options.rollback and 'rollback' or 'update', options)
149
+ return require('codeoutline.updater').run(options.check and 'check' or 'update', options)
150
+ end
151
+ if command == 'daemon' or command == 'install' or command == 'uninstall' then
152
+ local daemon = require('codeoutline.daemon')
153
+ local port = tonumber(options.port or daemon.PORT)
154
+ assert(port and port % 1 == 0 and port >= 1 and port <= 65535, 'invalid --port')
155
+ if command == 'daemon' then
156
+ arg = { 'HTTP=1', 'DAEMON=1', 'PORT=' .. port }
157
+ return dofile(scripts .. '/codeoutline/main.lua')
158
+ end
159
+ -- npm runs install after every installation; only global ones start a
160
+ -- service, and nothing here may fail the installation.
161
+ local npm = options.npm
162
+ if npm and (os.getenv('npm_config_global') ~= 'true' or os.getenv('CODEOUTLINE_AUTOSTART') == '0') then return 0 end
163
+ local function say(text) io.write(text, '\n'); io.stdout:flush() end
164
+ local status = 0
165
+ local function attempt(fn, ...)
166
+ local ok, err = pcall(fn, ...)
167
+ if not ok then io.stderr:write('codeoutline: ', tostring(err), '\n'); status = npm and 0 or 1 end
168
+ return ok and err
169
+ end
170
+ -- Launchers name the installation they belong to; unlike an installed
171
+ -- update, it is never deleted, so the login entry points there.
172
+ local root = install
173
+ local initial = os.getenv('CODEOUTLINE_INITIAL')
174
+ if initial and initial ~= '' then
175
+ initial = initial:gsub('\\', '/'):gsub('/+$', '')
176
+ if xutils.stat(initial .. '/scripts/codeoutline/command.lua').exists then root = initial end
177
+ end
178
+ local function finish(code) xthread.stop(code) end
179
+ return {
180
+ __init = function()
181
+ assert(xnet.init()); xtimer.init(16)
182
+ if command == 'uninstall' then
183
+ for _, removed in ipairs(attempt(daemon.unregister) or {}) do say('removed login entry ' .. removed) end
184
+ daemon.stop(port, 10000, function(stopped)
185
+ say(stopped and 'service on port ' .. port .. ' stopped' or 'service on port ' .. port .. ' is still running')
186
+ finish(stopped and status or 1)
187
+ end)
188
+ return
189
+ end
190
+ if os.getenv('CODEOUTLINE_AUTOSTART') ~= '0' then
191
+ local entry = attempt(function()
192
+ -- Only launchers before 0.1.8 leave root inside an update.
193
+ assert(not root:match('/versions/%x+/files$'),
194
+ 'cannot register an installed update; run npm install -g codeoutline, or install from the native launcher')
195
+ return daemon.register(root, port)
196
+ end)
197
+ if entry then say('registered login entry ' .. entry) end
198
+ end
199
+ -- Replace a running service so this installation takes effect now.
200
+ daemon.stop(port, 10000, function()
201
+ if not attempt(function() return assert(daemon.spawn(root, port), 'cannot start the service') end) then
202
+ finish(status); return
203
+ end
204
+ daemon.wait(port, 20000, function(listening)
205
+ if listening then say('service listening on http://127.0.0.1:' .. port .. '/mcp')
206
+ else io.stderr:write('codeoutline: the service did not start; see ', daemon.logs_dir(), '\n')
207
+ if not npm then status = 1 end end
208
+ finish(status)
209
+ end)
210
+ end)
211
+ end,
212
+ __uninit = function() xnet.uninit() end,
213
+ __thread_handle = function() end,
214
+ }
132
215
  end
133
216
  if command == 'serve' then
134
217
  assert(not not options.stdio ~= not not options.http, 'serve requires exactly one of --stdio or --http')
@@ -158,9 +241,22 @@ local function run()
158
241
  return 0
159
242
  end
160
243
 
244
+ -- Lease the installed update this process runs from, so installing a newer
245
+ -- one does not delete files it may still load (language parsers load lazily).
246
+ local lease = require('xupgate.client').lease(install)
161
247
  local ok, result = pcall(run)
162
248
  if not ok then io.stderr:write('codeoutline: ', tostring(result), '\n'); result = 1 end
163
- if type(result) == 'table' then return result end
249
+ if type(result) == 'table' then
250
+ if lease then
251
+ local uninit = result.__uninit
252
+ result.__uninit = function(...)
253
+ lease.release()
254
+ if uninit then return uninit(...) end
255
+ end
256
+ end
257
+ return result
258
+ end
259
+ if lease then lease.release() end
164
260
  io.stdout:flush()
165
261
  -- One-shot commands exchange no thread messages; the empty handler keeps the
166
262
  -- runtime from warning that none is set.
@@ -4,13 +4,17 @@
4
4
  -- Result: {
5
5
  -- path, language,
6
6
  -- nodes = { {kind, name, qualified, line, end_line, sig?, parent?, static?, bases?} },
7
- -- refs = { {from = node index | 0 (file scope), name, kind, line, recv?} },
7
+ -- refs = { name = {...}, from = {...}, kind = {...}, line = {...}, recv = {...} },
8
8
  -- imports = { {path, line, names?} },
9
9
  -- }
10
10
  -- Refs are attributed after parsing: a parser only records where each call
11
11
  -- sits (token index) and assign_refs() hands it to the innermost node whose
12
12
  -- token range contains it. That keeps nested functions/classes correct
13
13
  -- without each parser tracking scope for every call site.
14
+ -- finish() then packs refs into parallel columns -- ref i is name[i],
15
+ -- from[i] (node index | 0 for file scope), kind[i], line[i], recv[i]
16
+ -- (false when absent) -- because a large tree holds hundreds of thousands of
17
+ -- refs and a table per ref costs several times the data it carries.
14
18
 
15
19
  local M = {}
16
20
  local text = require('codeoutline.text')
@@ -115,7 +119,11 @@ end
115
119
  -- Drop parser-internal fields so the result is plain data.
116
120
  function M.finish(r)
117
121
  M.assign_refs(r)
118
- for _, ref in ipairs(r.refs) do ref.tok, ref.seq = nil, nil end
122
+ local name, from, kind, line, recv = {}, {}, {}, {}, {}
123
+ for i, ref in ipairs(r.refs) do
124
+ name[i], from[i], kind[i], line[i], recv[i] = ref.name, ref.from, ref.kind, ref.line, ref.recv or false
125
+ end
126
+ r.refs = { name = name, from = from, kind = kind, line = line, recv = recv }
119
127
  for _, n in ipairs(r.nodes) do n.ti, n.tj = nil, nil end
120
128
  r.prefix, r.skip_calls = nil, nil
121
129
  return r