@lordierclaw/bluenote 0.4.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,217 @@
+# BlueNote Distribution CLI
+
+`@lordierclaw/bluenote` is the official BlueNote app entrypoint and top-level command router. It exposes the `bluenote` and `bn` binaries, keeps distribution commands lightweight, and launches optional WebUI/TUI clients through their public executables.
+
+## Role in BlueNote
+
+This repo owns:
+
+- top-level `bluenote`/`bn` command routing
+- `--help`, `version`, and `doctor`
+- minimal local daemon lifecycle and capability reporting
+- optional client discovery in explicit `auto`, `path`, and `built` runtime modes
+- distribution packaging and install guidance
+
+It does not own core note behavior, browser UI implementation, or terminal UI implementation. Those live in `@lordierclaw/bluenote-core`, `@lordierclaw/bluenote-webui`, and `@lordierclaw/bluenote-term`.
+
+## Install
+
+For non-technical users, use the installer scripts. They are interactive by default and safely select only the distribution CLI (`@lordierclaw/bluenote`) unless you opt into the WebUI, built TUI, or all clients. The default registry is npmjs; GitHub Packages is available when you have token/auth configured.
+
+Linux/macOS:
+
+```sh
+./scripts/install.sh
+./scripts/install.sh --dry-run
+./scripts/install.sh --yes
+./scripts/install.sh --with-web
+./scripts/install.sh --with-tui
+./scripts/install.sh --all
+./scripts/install.sh --registry github
+./scripts/uninstall.sh --dry-run
+./scripts/uninstall.sh
+```
+
+Windows PowerShell:
+
+```powershell
+.\scripts\install.ps1 -Interactive
+.\scripts\install.ps1 -DryRun
+.\scripts\install.ps1 -Yes
+.\scripts\install.ps1 -WithWeb
+.\scripts\install.ps1 -WithTui
+.\scripts\install.ps1 -All
+.\scripts\install.ps1 -Registry github
+.\scripts\uninstall.ps1 -DryRun
+.\scripts\uninstall.ps1
+```
+
+Installer options:
+
+- Linux/macOS install: `--interactive`, `--yes`, `--with-web`, `--with-tui`, `--all`, `--tag <tag>`, `--registry npm|github`, `--client-mode path|built|auto`, `--dry-run`.
+- Windows install: `-Interactive`, `-Yes`, `-WithWeb`, `-WithTui`, `-All`, `-Tag`, `-Registry npm|github`, `-ClientMode path|built|auto`, `-DryRun`.
+- Linux/macOS uninstall: `--purge-config`, `--purge-cache`, `--purge-data`, `--dry-run`.
+- Windows uninstall: `-PurgeConfig`, `-PurgeCache`, `-PurgeData`, `-DryRun`.
+
+The installer runs preflight checks before mutating state, detects common conflicts, and in interactive mode offers safe upgrade, repair, skip, or abort choices when conflicts are found. Non-interactive `--yes` / `-Yes` fails safely on unknown conflicts rather than overwriting. Failed partial installs print recovery guidance and attempt best-effort rollback of artifacts created during the current run.
+
+Uninstall stops the daemon first when possible and removes `@lordierclaw/bluenote`, `@lordierclaw/bluenote-webui`, and managed built terminal client artifacts/packages. Normal install and uninstall preserve user notes/config/data. `--purge-data` / `-PurgeData` is the only destructive user-data path and requires the exact typed confirmation phrase `delete my bluenote data`.
+
+The default `auto` client mode lets `bluenote web` and `bluenote tui` prefer installer-managed built client artifacts from `BLUENOTE_BUILT_CLIENT_DIR` when present, then fall back to `PATH` discovery for `bluenote-webui` and `bluenote-term`. Use `--client-mode path|built|auto` on a launch command, or set `BLUENOTE_CLIENT_MODE=path|built|auto`, to force or inspect a runtime mode. The user TUI path uses a built terminal artifact/package and does not auto-install Bun or require Bun at runtime. `bluenote doctor` runs after installation and reports each client as `built`, `path`, `missing`, or `broken`.
+
+Manual npm install is also supported for advanced users:
+
+```sh
+npm install -g @lordierclaw/bluenote
+npm install -g @lordierclaw/bluenote-webui # optional
+npm install -g @lordierclaw/bluenote-term  # optional built TUI package when available
+bluenote doctor
+```
+
+Run clients through the distribution command after starting the daemon:
+
+```sh
+bluenote daemon start
+bluenote web
+# or
+bluenote tui
+```
+
+`bn` is the same binary alias as `bluenote`.
+
+## Local development
+
+Expected sibling checkout layout:
+
+```text
+../bluenote-core
+../bluenote-webui
+../bluenote-term
+../bluenote
+```
+
+Manual source-link setup before all packages are published:
+
+```sh
+# 1. Distribution CLI.
+cd ../bluenote
+npm ci --include=dev
+npm run check
+npm link
+bluenote doctor
+
+# 2. Optional browser client.
+cd ../bluenote-webui
+npm ci --include=dev
+npm run check
+npm link
+bluenote doctor
+
+# 3. Optional terminal client. Link from the public package workspace.
+cd ../bluenote-term
+bun install
+bun run check
+cd packages/term
+bun link
+cd ../..
+bluenote doctor
+```
+
+If linked commands are not visible, add npm's global command directory and Bun's command directory to `PATH`:
+
+```sh
+export PATH="$(npm prefix -g)/bin:$HOME/.bun/bin:$PATH"
+```
+
+```fish
+fish_add_path -U (npm prefix -g)/bin
+fish_add_path -U ~/.bun/bin
+```
+
+```cmd
+for /f "delims=" %i in ('npm prefix -g') do set "NPM_PREFIX=%i"
+if exist "%NPM_PREFIX%\bin" (set "PATH=%NPM_PREFIX%\bin;%USERPROFILE%\.bun\bin;%PATH%") else (set "PATH=%NPM_PREFIX%;%USERPROFILE%\.bun\bin;%PATH%")
+```
+
+```powershell
+$npmPrefix = npm prefix -g
+$npmBin = if (Test-Path (Join-Path $npmPrefix "bin")) { Join-Path $npmPrefix "bin" } else { $npmPrefix }
+$env:Path = "$npmBin;$HOME\.bun\bin;$env:Path"
+```
+
+Fast local install/uninstall scripts are available for sibling checkout development:
+
+```sh
+./scripts/dev-install-local.sh --all --dry-run
+./scripts/dev-install-local.sh --all
+./scripts/dev-uninstall-local.sh --all --dry-run
+./scripts/dev-uninstall-local.sh --all
+```
+
+```powershell
+.\scripts\dev-install-local.ps1 -All -DryRun
+.\scripts\dev-install-local.ps1 -All
+.\scripts\dev-uninstall-local.ps1 -All -DryRun
+.\scripts\dev-uninstall-local.ps1 -All
+```
+
+Default local install mode links the distribution CLI and WebUI. Add `--tui`/`-Tui` or use `--all`/`-All` to include the Bun-based terminal package from `../bluenote-term/packages/term`. Use `--skip-check`/`-SkipCheck` to skip repo checks and `--dry-run`/`-DryRun` to print commands without changing global links.
+
+For release-like local verification without publishing, pack local artifacts and install them into an isolated temporary npm prefix with separate BlueNote config/data/cache paths:
+
+```sh
+./scripts/dev-verify-local.sh --web --dry-run
+./scripts/dev-verify-local.sh --web
+# Include both optional clients when local package verification is available:
+./scripts/dev-verify-local.sh --all
+```
+
+```powershell
+.\scripts\dev-verify-local.ps1 -Web -DryRun
+.\scripts\dev-verify-local.ps1 -Web
+# Include both optional clients when local package verification is available:
+.\scripts\dev-verify-local.ps1 -All
+```
+
+Use `--keep-temp`/`-KeepTemp` to preserve the temporary prefix and isolated state directories for inspection after a verification run.
+
+## Scripts
+
+```sh
+npm run typecheck
+npm run test
+npm run build
+npm run check
+npm run version:status
+npm run version:status -- --allow-git-deps
+./scripts/dev-install-local.sh --all --dry-run
+./scripts/dev-uninstall-local.sh --all --dry-run
+./scripts/dev-verify-local.sh --web --dry-run
+node dist/bin.js --help
+node dist/bin.js version
+node dist/bin.js doctor
+```
+
+`npm run version:status` checks the four sibling package names and versions. npm run version:status is the release check and requires exact published version dependencies for BlueNote packages. Development mode may use pinned Git deps when you intentionally pass `--allow-git-deps` for a local-only workspace.
+
+## Packaging and versions
+
+The package name is `@lordierclaw/bluenote`; published binaries are `bluenote` and `bn`.
+
+The distribution depends on `@lordierclaw/bluenote-core` for headless behavior. Optional clients are installed separately and discovered as `bluenote-webui` and `bluenote-term` executables on `PATH`.
+
+Release mode must use published version deps for BlueNote packages. The distribution package now pins `@lordierclaw/bluenote-core` to the exact published semver used by the coordinated BlueNote release, while `--allow-git-deps` remains available only for local development workspaces that intentionally opt into Git-pinned dependencies.
+
+## Cross-platform notes
+
+- Supported distribution runtime: Node.js `>=16.14 <17 || >=18`.
+- Basic distribution commands do not require Bun.
+- The terminal client uses Bun/OpenTUI and should be installed separately.
+- The daemon is local-only and passes client connection details through environment variables without printing bearer tokens.
+- Use `bluenote doctor` after install/link changes to verify PATH, daemon state, and optional clients.
+
+## Related packages
+
+- `@lordierclaw/bluenote-core`: headless note model, storage, search, AI config/queue/provider behavior, and public core APIs.
+- `@lordierclaw/bluenote-webui`: optional local browser client and localhost server/proxy.
+- `@lordierclaw/bluenote-term`: optional terminal/TUI client and terminal command API.

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("./cli");
+(0, cli_1.main)(process.argv.slice(2)).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`${message}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";;;AACA,+BAA4B;AAE5B,IAAA,UAAI,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC1C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAA;IACpC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC,CAAC,CAAA"}

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+import type { CommandIo } from "./types";
+export declare const COMMANDS: readonly ["tui", "web", "daemon", "doctor", "version"];
+export declare function run(args?: string[], io?: CommandIo): Promise<number>;
+export declare function main(args?: string[], io?: CommandIo): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMANDS = void 0;
+exports.run = run;
+exports.main = main;
+const daemon_1 = require("./commands/daemon");
+const doctor_1 = require("./commands/doctor");
+const help_1 = require("./commands/help");
+const tui_1 = require("./commands/tui");
+const version_1 = require("./commands/version");
+const web_1 = require("./commands/web");
+const write_1 = require("./utils/write");
+exports.COMMANDS = ["tui", "web", "daemon", "doctor", "version"];
+async function run(args = [], io = {}) {
+    const [command, ...commandArgs] = args;
+    if (!command || command === "--help" || command === "-h" || command === "help") {
+        return (0, help_1.runHelp)(commandArgs, io);
+    }
+    if (command === "version" || command === "--version")
+        return (0, version_1.runVersion)(commandArgs, io);
+    if (command === "doctor")
+        return (0, doctor_1.runDoctor)(commandArgs, io);
+    if (command === "daemon")
+        return (0, daemon_1.runDaemon)(commandArgs, io);
+    if (command === "tui")
+        return (0, tui_1.runTui)(commandArgs, io);
+    if (command === "web")
+        return (0, web_1.runWeb)(commandArgs, io);
+    (0, write_1.write)(io.stderr || process.stderr, `Unknown command: ${command}\nRun "bluenote --help" for usage.\n`);
+    return 1;
+}
+async function main(args = process.argv.slice(2), io) {
+    const exitCode = await run(args, io);
+    process.exitCode = exitCode;
+    return exitCode;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAWA,kBAeC;AAED,oBAIC;AA/BD,8CAA6C;AAC7C,8CAA6C;AAC7C,0CAAyC;AACzC,wCAAuC;AACvC,gDAA+C;AAC/C,wCAAuC;AACvC,yCAAqC;AAExB,QAAA,QAAQ,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAA;AAEvE,KAAK,UAAU,GAAG,CAAC,OAAiB,EAAE,EAAE,KAAgB,EAAE;IAC/D,MAAM,CAAC,OAAO,EAAE,GAAG,WAAW,CAAC,GAAG,IAAI,CAAA;IAEtC,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QAC/E,OAAO,IAAA,cAAO,EAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IACjC,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,WAAW;QAAE,OAAO,IAAA,oBAAU,EAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IACxF,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAA,kBAAS,EAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IAC3D,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAA,kBAAS,EAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IAC3D,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,IAAA,YAAM,EAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IACrD,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,IAAA,YAAM,EAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IAErD,IAAA,aAAK,EAAC,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,oBAAoB,OAAO,sCAAsC,CAAC,CAAA;IACrG,OAAO,CAAC,CAAA;AACV,CAAC;AAEM,KAAK,UAAU,IAAI,CAAC,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAc;IAC/E,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACpC,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC3B,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/commands/daemon.d.ts

@@ -0,0 +1,2 @@
+import type { CommandIo } from "../types";
+export declare function runDaemon(args?: string[], io?: CommandIo): Promise<number>;

package/dist/commands/daemon.js

@@ -0,0 +1,163 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDaemon = runDaemon;
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const paths_1 = require("../daemon/paths");
+const token_1 = require("../daemon/token");
+const server_1 = require("../daemon/server");
+const package_info_1 = require("../utils/package-info");
+const daemon_state_1 = require("../utils/daemon-state");
+const write_1 = require("../utils/write");
+const HELP_TEXT = `BlueNote daemon
+
+Usage: bluenote daemon <start|status|stop>
+
+Commands:
+  start   Start the local BlueNote daemon
+  status  Show daemon status and health
+  stop    Stop the local BlueNote daemon
+`;
+function binPath() {
+    return path_1.default.resolve(__dirname, "..", "bin.js");
+}
+function parseServeArgs(args, env = process.env) {
+    const parsed = { token: env.BLUENOTE_DAEMON_SERVE_TOKEN };
+    for (let index = 0; index < args.length; index += 1) {
+        const value = args[index];
+        if (value === "--state" && args[index + 1])
+            parsed.statePath = args[++index];
+        else if (value === "--version" && args[index + 1])
+            parsed.version = args[++index];
+    }
+    return parsed;
+}
+async function waitForRunning(env, deadlineMs) {
+    const deadline = Date.now() + deadlineMs;
+    let latest = await (0, daemon_state_1.readDaemonStatus)(env);
+    while (Date.now() < deadline) {
+        latest = await (0, daemon_state_1.readDaemonStatus)(env);
+        if (latest.state === "running")
+            return latest;
+        await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+    return latest;
+}
+async function startDaemon(io) {
+    const stdout = io.stdout || process.stdout;
+    const stderr = io.stderr || process.stderr;
+    const env = io.env || process.env;
+    const existing = await (0, daemon_state_1.readDaemonStatus)(env);
+    if (existing.state === "running" && existing.metadata) {
+        (0, write_1.write)(stdout, `BlueNote daemon already running\nstatus: running\nendpoint: ${existing.metadata.url}\npid: ${existing.metadata.pid}\n`);
+        return 0;
+    }
+    if (existing.state === "stale")
+        (0, daemon_state_1.removeDaemonMetadata)(env);
+    const statePath = (0, paths_1.getDaemonStatePath)(env);
+    const token = (0, token_1.createDaemonToken)();
+    const version = (0, package_info_1.readOwnPackageInfo)().version;
+    const spawn = io.spawn || child_process_1.spawn;
+    let child;
+    try {
+        child = spawn(process.execPath, [binPath(), "daemon", "serve", "--state", statePath, "--version", version], {
+            detached: true,
+            stdio: "ignore",
+            env: { ...env, BLUENOTE_DAEMON_SERVE_TOKEN: token },
+        });
+        child.unref();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        (0, write_1.write)(stderr, `Unable to start BlueNote daemon: ${message}\n`);
+        return 1;
+    }
+    const status = await waitForRunning(env, 5000);
+    if (status.state !== "running" || !status.metadata) {
+        if (child?.pid) {
+            try {
+                process.kill(child.pid, "SIGTERM");
+            }
+            catch {
+                // best effort cleanup for failed starts
+            }
+        }
+        (0, write_1.write)(stderr, "Unable to start BlueNote daemon: health check did not become ready.\n");
+        return 1;
+    }
+    (0, write_1.write)(stdout, `BlueNote daemon started\nstatus: running\nendpoint: ${status.metadata.url}\npid: ${status.metadata.pid}\n`);
+    return 0;
+}
+async function statusDaemon(io) {
+    const stdout = io.stdout || process.stdout;
+    const status = await (0, daemon_state_1.readDaemonStatus)(io.env || process.env);
+    (0, write_1.write)(stdout, `status: ${status.state}\n`);
+    (0, write_1.write)(stdout, `endpoint: ${status.metadata ? status.metadata.url : "unavailable"}\n`);
+    (0, write_1.write)(stdout, `pid: ${status.metadata?.pid || "unavailable"}\n`);
+    (0, write_1.write)(stdout, `token: ${status.metadata?.token ? "present" : "missing"}\n`);
+    (0, write_1.write)(stdout, `health: ${status.healthOk ? "ok" : status.state === "stopped" ? "not checked" : "failed"}\n`);
+    return 0;
+}
+async function stopDaemon(io) {
+    const stdout = io.stdout || process.stdout;
+    const env = io.env || process.env;
+    const status = await (0, daemon_state_1.readDaemonStatus)(env);
+    if (!status.metadata) {
+        (0, write_1.write)(stdout, "BlueNote daemon is not running.\nstatus: stopped\n");
+        return 0;
+    }
+    if (status.state === "running") {
+        try {
+            await (0, daemon_state_1.requestJson)(`${status.metadata.url}/shutdown`, { method: "POST", token: status.metadata.token, timeoutMs: 1500 });
+        }
+        catch {
+            try {
+                process.kill(status.metadata.pid, "SIGTERM");
+            }
+            catch {
+                // best effort
+            }
+        }
+    }
+    else {
+        try {
+            process.kill(status.metadata.pid, "SIGTERM");
+        }
+        catch {
+            // best effort
+        }
+    }
+    (0, daemon_state_1.removeDaemonMetadata)(env);
+    (0, write_1.write)(stdout, "BlueNote daemon stopped\nstatus: stopped\n");
+    return 0;
+}
+async function runDaemon(args = [], io = {}) {
+    const stdout = io.stdout || process.stdout;
+    const stderr = io.stderr || process.stderr;
+    const command = args[0];
+    if (!command || command === "--help" || command === "-h" || command === "help") {
+        (0, write_1.write)(stdout, HELP_TEXT);
+        return 0;
+    }
+    if (command === "serve") {
+        const parsed = parseServeArgs(args.slice(1), io.env || process.env);
+        if (!parsed.statePath || !parsed.token || !parsed.version) {
+            (0, write_1.write)(stderr, "Missing daemon serve arguments.\n");
+            return 1;
+        }
+        await (0, server_1.startDaemonServer)({ statePath: parsed.statePath, token: parsed.token, version: parsed.version });
+        return 0;
+    }
+    if (command === "start")
+        return await startDaemon(io);
+    if (command === "status")
+        return await statusDaemon(io);
+    if (command === "stop")
+        return await stopDaemon(io);
+    (0, write_1.write)(stderr, `Unknown daemon command: ${command}\nRun "bluenote daemon --help" for usage.\n`);
+    return 1;
+}
+//# sourceMappingURL=daemon.js.map

package/dist/commands/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/commands/daemon.ts"],"names":[],"mappings":"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"}