@lindengjian/codex-beacon 1.0.5

package/README.md

@@ -0,0 +1,30 @@
+# Codex Beacon npm installer
+
+This package installs the native Codex Beacon app into `~/Applications` on an
+Apple Silicon Mac running macOS 15 or later.
+
+```sh
+npx @lindengjian/codex-beacon install
+```
+
+Or install the small command-line launcher globally:
+
+```sh
+npm install -g @lindengjian/codex-beacon
+codex-beacon install
+```
+
+Commands:
+
+```sh
+codex-beacon open
+codex-beacon doctor
+codex-beacon uninstall
+```
+
+`uninstall` removes only `~/Applications/CodexBeacon.app`. Before removal it
+asks Beacon to unregister its login item and roll back the shared App Server
+compatibility adapter that Beacon itself created.
+
+The app remains ad-hoc signed and is not notarized. npm does not bypass macOS
+security checks; follow the macOS prompt only when you trust the release.

package/app/CodexBeacon.app/Contents/Info.plist

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>CFBundleDevelopmentRegion</key>
+    <string>en</string>
+    <key>CFBundleExecutable</key>
+    <string>CodexBeacon</string>
+    <key>CFBundleIdentifier</key>
+    <string>com.lindengjian.CodexBeacon</string>
+    <key>CFBundleInfoDictionaryVersion</key>
+    <string>6.0</string>
+    <key>CFBundleIconFile</key>
+    <string>CodexBeacon.icns</string>
+    <key>CFBundleName</key>
+    <string>Codex Beacon</string>
+    <key>CFBundlePackageType</key>
+    <string>APPL</string>
+    <key>CFBundleShortVersionString</key>
+    <string>1.0.5</string>
+    <key>CFBundleVersion</key>
+    <string>1.0.5</string>
+    <key>LSArchitecturePriority</key>
+    <array>
+        <string>arm64</string>
+    </array>
+    <key>LSMinimumSystemVersion</key>
+    <string>15.0</string>
+    <key>LSUIElement</key>
+    <true/>
+    <key>NSHighResolutionCapable</key>
+    <true/>
+    <key>NSPrincipalClass</key>
+    <string>NSApplication</string>
+</dict>
+</plist>

package/app/CodexBeacon.app/Contents/_CodeSignature/CodeResources

@@ -0,0 +1,128 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>files</key>
+	<dict>
+		<key>Resources/CodexBeacon.icns</key>
+		<data>
+		ARb+dgpuDExYp5sFia3uxkcaQd0=
+		</data>
+	</dict>
+	<key>files2</key>
+	<dict>
+		<key>Resources/CodexBeacon.icns</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			/rRUPUqqL36bgR9YaCgNtPZoEW5epmPMQHPsP/iHbUk=
+			</data>
+		</dict>
+	</dict>
+	<key>rules</key>
+	<dict>
+		<key>^Resources/</key>
+		<true/>
+		<key>^Resources/.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^Resources/.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Resources/Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^version.plist$</key>
+		<true/>
+	</dict>
+	<key>rules2</key>
+	<dict>
+		<key>.*\.dSYM($|/)</key>
+		<dict>
+			<key>weight</key>
+			<real>11</real>
+		</dict>
+		<key>^(.*/)?\.DS_Store$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>2000</real>
+		</dict>
+		<key>^(Frameworks|SharedFrameworks|PlugIns|Plug-ins|XPCServices|Helpers|MacOS|Library/(Automator|Spotlight|LoginItems))/</key>
+		<dict>
+			<key>nested</key>
+			<true/>
+			<key>weight</key>
+			<real>10</real>
+		</dict>
+		<key>^.*</key>
+		<true/>
+		<key>^Info\.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^PkgInfo$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^Resources/</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^Resources/.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^Resources/.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Resources/Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^[^/]+$</key>
+		<dict>
+			<key>nested</key>
+			<true/>
+			<key>weight</key>
+			<real>10</real>
+		</dict>
+		<key>^embedded\.provisionprofile$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^version\.plist$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+	</dict>
+</dict>
+</plist>

package/bin/codex-beacon.mjs

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import {
+  defaultInstalledApp,
+  doctor,
+  installApp,
+  openApp,
+  uninstallApp,
+} from "../lib/installer.mjs";
+
+const packageDirectory = dirname(dirname(fileURLToPath(import.meta.url)));
+const bundledApp = join(packageDirectory, "app", "CodexBeacon.app");
+
+function printUsage() {
+  console.log(`Codex Beacon npm installer
+
+Usage:
+  codex-beacon install [--no-launch]  Install to ~/Applications and open it
+  codex-beacon open                   Open the installed app
+  codex-beacon doctor                 Check platform, installation, and signature
+  codex-beacon uninstall              Clean up Beacon-owned services and remove the app
+`);
+}
+
+function run() {
+  const [command = "help", ...arguments_] = process.argv.slice(2);
+
+  switch (command) {
+    case "install": {
+      const installedApp = installApp({ bundledApp });
+      console.log(`Installed Codex Beacon at ${installedApp}`);
+      if (!arguments_.includes("--no-launch")) {
+        openApp(installedApp);
+      }
+      return;
+    }
+    case "open": {
+      const installedApp = defaultInstalledApp();
+      doctor({ installedApp });
+      openApp(installedApp);
+      return;
+    }
+    case "doctor": {
+      const installedApp = doctor();
+      console.log(`Codex Beacon is installed and its signature is valid: ${installedApp}`);
+      console.log("Open Beacon and use its integration diagnostic to verify Codex Desktop compatibility.");
+      return;
+    }
+    case "uninstall": {
+      if (uninstallApp({})) {
+        console.log("Removed Codex Beacon from ~/Applications.");
+      } else {
+        console.log("Codex Beacon is not installed in ~/Applications.");
+      }
+      return;
+    }
+    case "help":
+    case "--help":
+    case "-h":
+      printUsage();
+      return;
+    default:
+      throw new Error(`Unknown command: ${command}`);
+  }
+}
+
+try {
+  run();
+} catch (error) {
+  console.error(`codex-beacon: ${error.message}`);
+  process.exitCode = 1;
+}

package/lib/installer.mjs

@@ -0,0 +1,120 @@
+import {
+  cpSync,
+  existsSync,
+  mkdirSync,
+  renameSync,
+  rmSync,
+  statSync,
+} from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, join } from "node:path";
+import { execFileSync } from "node:child_process";
+
+export const applicationName = "CodexBeacon.app";
+export const executableRelativePath = join("Contents", "MacOS", "CodexBeacon");
+
+export function validatePlatform({ platform = process.platform, arch = process.arch } = {}) {
+  if (platform !== "darwin" || arch !== "arm64") {
+    throw new Error("Codex Beacon only supports macOS on Apple Silicon (darwin/arm64).");
+  }
+}
+
+export function defaultApplicationsDirectory(homeDirectory = homedir()) {
+  return join(homeDirectory, "Applications");
+}
+
+export function defaultInstalledApp(applicationsDirectory = defaultApplicationsDirectory()) {
+  return join(applicationsDirectory, applicationName);
+}
+
+export function verifyApp(appPath) {
+  execFileSync("/usr/bin/codesign", ["--verify", "--strict", "--verbose=2", appPath], {
+    stdio: "inherit",
+  });
+}
+
+export function openApp(appPath) {
+  execFileSync("/usr/bin/open", [appPath], { stdio: "inherit" });
+}
+
+function assertAppBundle(appPath, description) {
+  if (!existsSync(appPath) || !statSync(appPath).isDirectory()) {
+    throw new Error(`${description} is missing: ${appPath}`);
+  }
+}
+
+function replaceDirectory(source, destination) {
+  const parentDirectory = dirname(destination);
+  const stagingDirectory = join(parentDirectory, `.${basename(destination)}.install-${process.pid}`);
+  const backupDirectory = join(parentDirectory, `.${basename(destination)}.backup-${process.pid}`);
+
+  rmSync(stagingDirectory, { recursive: true, force: true });
+  rmSync(backupDirectory, { recursive: true, force: true });
+  cpSync(source, stagingDirectory, { recursive: true, preserveTimestamps: true });
+
+  const hadExistingInstallation = existsSync(destination);
+  if (hadExistingInstallation) {
+    renameSync(destination, backupDirectory);
+  }
+
+  try {
+    renameSync(stagingDirectory, destination);
+  } catch (error) {
+    if (hadExistingInstallation && !existsSync(destination)) {
+      renameSync(backupDirectory, destination);
+    }
+    throw error;
+  } finally {
+    rmSync(stagingDirectory, { recursive: true, force: true });
+  }
+
+  rmSync(backupDirectory, { recursive: true, force: true });
+}
+
+export function installApp({
+  bundledApp,
+  applicationsDirectory = defaultApplicationsDirectory(),
+  platform = process.platform,
+  arch = process.arch,
+  verifyApp: verify = verifyApp,
+}) {
+  validatePlatform({ platform, arch });
+  assertAppBundle(bundledApp, "The bundled Codex Beacon app");
+  verify(bundledApp);
+  mkdirSync(applicationsDirectory, { recursive: true });
+
+  const installedApp = defaultInstalledApp(applicationsDirectory);
+  replaceDirectory(bundledApp, installedApp);
+  return installedApp;
+}
+
+export function uninstallApp({
+  installedApp = defaultInstalledApp(),
+  prepareForUninstall = (executable, commandArguments) =>
+    execFileSync(executable, commandArguments, { stdio: "inherit" }),
+}) {
+  if (!existsSync(installedApp)) {
+    return false;
+  }
+
+  const executable = join(installedApp, executableRelativePath);
+  if (!existsSync(executable)) {
+    throw new Error(`The installed Codex Beacon app is incomplete: ${installedApp}`);
+  }
+
+  prepareForUninstall(executable, ["--prepare-for-uninstall"]);
+  rmSync(installedApp, { recursive: true, force: false });
+  return true;
+}
+
+export function doctor({
+  installedApp = defaultInstalledApp(),
+  platform = process.platform,
+  arch = process.arch,
+  verifyApp: verify = verifyApp,
+}) {
+  validatePlatform({ platform, arch });
+  assertAppBundle(installedApp, "Codex Beacon is not installed; run `codex-beacon install`");
+  verify(installedApp);
+  return installedApp;
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@lindengjian/codex-beacon",
+  "version": "1.0.5",
+  "description": "Install Codex Beacon, a native macOS status companion for Codex Desktop.",
+  "license": "UNLICENSED",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "codex-beacon": "bin/codex-beacon.mjs"
+  },
+  "files": [
+    "app",
+    "bin",
+    "lib",
+    "README.md"
+  ],
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.mjs",
+    "prepack": "node scripts/prepare-package.mjs",
+    "pack:check": "npm pack --dry-run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lindengjian/CodexBeacon.git",
+    "directory": "npm"
+  },
+  "homepage": "https://github.com/lindengjian/CodexBeacon#readme",
+  "bugs": {
+    "url": "https://github.com/lindengjian/CodexBeacon/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}