@aerovato/operator-helper 1.0.1 → 1.0.2

package/README.md

@@ -32,13 +32,14 @@ Users interact with Operator through the OpenCode commands `/operator:user-init`
 
 Run each Operator command in a new conversation so the agent can focus on that operation with a clean working context. Initialization preserves existing content. Project setup configures `.operator/` in the global Git ignore but does not automatically untrack files already committed.
 
-The direct user-facing Helper operations are adapter installation and Helper upgrading:
+The direct user-facing Helper operation is adapter installation:
 
 ```sh
 operator-helper install opencode
-operator-helper upgrade
 ```
 
+Operator Helper automatically checks for and installs updates when commands run. If it cannot determine whether Bun or npm owns the global installation, it asks for a manual update using the original installation method.
+
 ## Documentation
 
 - [Overview and setup](https://github.com/aerovato/operator-memory#readme)

package/dist/index.js

@@ -8671,6 +8671,7 @@ var require_table = __commonJS((exports, module) => {
 });
 
 // src/index.ts
+import { spawnSync } from "node:child_process";
 import { homedir } from "node:os";
 // ../../node_modules/.bun/@effect+platform-node@4.0.0-beta.107+a2edc8a872f58f99/node_modules/@effect/platform-node/dist/NodeChildProcessSpawner.js
 var exports_NodeChildProcessSpawner = {};
@@ -22899,7 +22900,7 @@ var withTime = /* @__PURE__ */ dual((args2) => isEffect(args2[0]), (self, label)
 // package.json
 var package_default = {
   name: "@aerovato/operator-helper",
-  version: "1.0.1",
+  version: "1.0.2",
   description: "Installation and setup CLI for Operator Memory",
   license: "BSD-3-Clause",
   author: "Aerovato Research",
@@ -24509,6 +24510,80 @@ ${renderTable([["User Instructions", `${USER_PATH} (${Buffer.byteLength(content)
   };
 });
 
+// src/cli.ts
+var HELP = `Operator Helper
+
+USER COMMANDS
+
+${renderTable([
+  ["help", "Show help for operator-helper"],
+  ["version", "Show the installed version"],
+  ["operator-helper install opencode", "Install or update the OpenCode plugin"]
+])}
+
+AGENT COMMANDS
+
+${renderTable([
+  ["operator-helper user status", "Show User Instructions status"],
+  ["operator-helper user init", "Initialize User Instructions without overwriting content"],
+  ["operator-helper user guide", "Print the agent guide for completing User Setup"],
+  [
+    "operator-helper project status",
+    "Show Project Private, Shared, Git ignore, and tracking status"
+  ],
+  ["operator-helper project init", "Initialize project partitions and global Git ignore"],
+  ["operator-helper project guide", "Print the agent guide for completing Project Setup"],
+  ["operator-helper index status", "Show Private and Shared main Project Index status"],
+  ["operator-helper index guide", "Print the agent guide for building or refreshing indexes"],
+  ["operator-helper index lint", "Check Project Index structure and frontmatter"],
+  ["operator-helper memory check", "Check that all Operator memory can be loaded"]
+])}`;
+function runCli(arguments_, context3) {
+  return exports_Effect.gen(function* () {
+    if (arguments_.length === 1 && arguments_[0] === "help") {
+      return { exitCode: 0, output: HELP };
+    }
+    if (arguments_.length === 1 && arguments_[0] === "version") {
+      return { exitCode: 0, output: context3.version };
+    }
+    if (arguments_.length !== 2) {
+      return { exitCode: 2, output: HELP };
+    }
+    const command = `${arguments_[0]} ${arguments_[1]}`;
+    switch (command) {
+      case "user status":
+        return yield* userStatus(context3);
+      case "user init":
+        return yield* userInit(context3);
+      case "user guide":
+        return yield* userGuide();
+      case "project status":
+        return yield* projectStatus(context3);
+      case "project init":
+        return yield* projectInit(context3);
+      case "project guide":
+        return yield* projectGuide();
+      case "index status":
+        return yield* indexStatus(context3);
+      case "index guide":
+        return yield* indexGuide();
+      case "index lint":
+        return yield* indexLint(context3);
+      case "memory check":
+        return yield* memoryCheck(context3);
+      case "install opencode":
+        return yield* installOpenCode(context3);
+      default:
+        return {
+          exitCode: 2,
+          output: `Unknown command: ${command}
+
+${HELP}`
+        };
+    }
+  }).pipe(exports_Effect.catch((error2) => exports_Effect.succeed(fileFailure(error2))));
+}
+
 // src/npm-registry.ts
 class NpmRegistryError extends exports_Data.TaggedError("NpmRegistryError") {
 }
@@ -24544,59 +24619,27 @@ var NpmRegistry;
   }));
 })(NpmRegistry ||= {});
 
-// src/commands/upgrade.ts
+// src/update.ts
 var HELPER_PACKAGE = "@aerovato/operator-helper";
-var updateNotice = exports_Effect.fn("updateNotice")(function* (currentVersion) {
+var UPDATE_TIMEOUT = "60 seconds";
+var autoUpdate = exports_Effect.fn("autoUpdate")(function* (currentVersion, context3) {
   const registry = yield* NpmRegistry.Service;
   const latest = yield* registry.latestVersion(HELPER_PACKAGE).pipe(exports_Effect.option);
   if (exports_Option.isNone(latest) || !isNewerVersion(currentVersion, latest.value)) {
-    return null;
+    return { status: "current" };
   }
-  return `Operator Helper ${latest.value} is available. Run operator-helper upgrade.`;
-});
-var upgrade = exports_Effect.fn("upgrade")(function* (context3) {
   const spawner = yield* exports_ChildProcessSpawner.ChildProcessSpawner;
   const channel = yield* detectInstallationChannel(spawner, context3.cwd);
   if (channel === "unknown") {
-    return {
-      exitCode: 1,
-      output: `✗ ${[
-        "Could not determine how Operator Helper was installed.",
-        "Upgrade manually using your original installation method.",
-        "",
-        "bun add --global --minimum-release-age 0 @aerovato/operator-helper@latest",
-        "NPM_CONFIG_MIN_RELEASE_AGE=0 npm install --global @aerovato/operator-helper@latest"
-      ].join(`
-`)}`
-    };
+    return { status: "unknown", latest: latest.value };
   }
-  const command = channel === "bun" ? exports_ChildProcess.make("bun", ["add", "--global", "--minimum-release-age", "0", `${HELPER_PACKAGE}@latest`], { cwd: context3.cwd }) : exports_ChildProcess.make("npm", ["install", "--global", `${HELPER_PACKAGE}@latest`], {
+  const command = channel === "bun" ? exports_ChildProcess.make("bun", ["add", "--global", "--minimum-release-age", "0", `${HELPER_PACKAGE}@${latest.value}`], { cwd: context3.cwd }) : exports_ChildProcess.make("npm", ["install", "--global", `${HELPER_PACKAGE}@${latest.value}`], {
     cwd: context3.cwd,
     env: { NPM_CONFIG_MIN_RELEASE_AGE: "0" },
     extendEnv: true
   });
-  const execution = yield* run2(spawner, command).pipe(exports_Effect.result);
-  if (exports_Result.isFailure(execution)) {
-    const message = execution.failure instanceof exports_PlatformError.PlatformError ? execution.failure.reason.description ?? execution.failure.message : getErrorMessage(execution.failure);
-    return {
-      exitCode: 1,
-      output: `✗ ${[
-        `Could not upgrade with ${channel}: ${message}`,
-        "",
-        "Upgrade manually using your original installation method.",
-        "",
-        "bun add --global --minimum-release-age 0 @aerovato/operator-helper@latest",
-        "NPM_CONFIG_MIN_RELEASE_AGE=0 npm install --global @aerovato/operator-helper@latest"
-      ].join(`
-`)}`
-    };
-  }
-  const output = [execution.success.stdout.trim(), execution.success.stderr.trim()].filter(Boolean).join(`
-`);
-  return execution.success.exitCode === 0 ? { exitCode: 0, output } : {
-    exitCode: execution.success.exitCode,
-    output: output || "Operator Helper upgrade failed"
-  };
+  const execution = yield* run2(spawner, command).pipe(exports_Effect.timeout(UPDATE_TIMEOUT), exports_Effect.option);
+  return exports_Option.isSome(execution) && execution.value.exitCode === 0 ? { status: "updated" } : { status: "failed" };
 });
 function detectInstallationChannel(spawner, cwd) {
   return exports_Effect.gen(function* () {
@@ -24646,85 +24689,8 @@ function parseVersion(value) {
   return [Number(match7[1]), Number(match7[2]), Number(match7[3])];
 }
 
-// src/cli.ts
-var HELP = `Operator Helper
-
-USER COMMANDS
-
-${renderTable([
-  ["help", "Show help for operator-helper"],
-  ["version", "Show the installed version"],
-  ["operator-helper install opencode", "Install or update the OpenCode plugin"],
-  ["operator-helper upgrade", "Upgrade Operator Helper"]
-])}
-
-AGENT COMMANDS
-
-${renderTable([
-  ["operator-helper user status", "Show User Instructions status"],
-  ["operator-helper user init", "Initialize User Instructions without overwriting content"],
-  ["operator-helper user guide", "Print the agent guide for completing User Setup"],
-  [
-    "operator-helper project status",
-    "Show Project Private, Shared, Git ignore, and tracking status"
-  ],
-  ["operator-helper project init", "Initialize project partitions and global Git ignore"],
-  ["operator-helper project guide", "Print the agent guide for completing Project Setup"],
-  ["operator-helper index status", "Show Private and Shared main Project Index status"],
-  ["operator-helper index guide", "Print the agent guide for building or refreshing indexes"],
-  ["operator-helper index lint", "Check Project Index structure and frontmatter"],
-  ["operator-helper memory check", "Check that all Operator memory can be loaded"]
-])}`;
-function runCli(arguments_, context3) {
-  return exports_Effect.gen(function* () {
-    if (arguments_.length === 1 && arguments_[0] === "help") {
-      return { exitCode: 0, output: HELP };
-    }
-    if (arguments_.length === 1 && arguments_[0] === "version") {
-      return { exitCode: 0, output: context3.version };
-    }
-    if (arguments_.length === 1 && arguments_[0] === "upgrade") {
-      return yield* upgrade(context3);
-    }
-    if (arguments_.length !== 2) {
-      return { exitCode: 2, output: HELP };
-    }
-    const command = `${arguments_[0]} ${arguments_[1]}`;
-    switch (command) {
-      case "user status":
-        return yield* userStatus(context3);
-      case "user init":
-        return yield* userInit(context3);
-      case "user guide":
-        return yield* userGuide();
-      case "project status":
-        return yield* projectStatus(context3);
-      case "project init":
-        return yield* projectInit(context3);
-      case "project guide":
-        return yield* projectGuide();
-      case "index status":
-        return yield* indexStatus(context3);
-      case "index guide":
-        return yield* indexGuide();
-      case "index lint":
-        return yield* indexLint(context3);
-      case "memory check":
-        return yield* memoryCheck(context3);
-      case "install opencode":
-        return yield* installOpenCode(context3);
-      default:
-        return {
-          exitCode: 2,
-          output: `Unknown command: ${command}
-
-${HELP}`
-        };
-    }
-  }).pipe(exports_Effect.catch((error2) => exports_Effect.succeed(fileFailure(error2))));
-}
-
 // src/index.ts
+var SKIP_UPDATE_ENVIRONMENT_VARIABLE = "OPERATOR_HELPER_SKIP_UPDATE";
 var ChildProcessLayer = exports_NodeChildProcessSpawner.layer.pipe(exports_Layer.provide(exports_NodeFileSystem.layer), exports_Layer.provide(exports_NodePath.layer));
 var LiveLayers = exports_Layer.mergeAll(exports_NodeFileSystem.layer, exports_NodePath.layer, ChildProcessLayer, NpmRegistry.layer, GitRunner.layer.pipe(exports_Layer.provide(ChildProcessLayer), exports_Layer.provide(exports_NodeFileSystem.layer), exports_Layer.provide(exports_NodePath.layer)));
 var main = exports_Effect.gen(function* () {
@@ -24732,21 +24698,37 @@ var main = exports_Effect.gen(function* () {
     arguments: process.argv.slice(2),
     cwd: process.cwd(),
     home: homedir(),
-    xdgConfigHome: process.env.XDG_CONFIG_HOME ?? null
+    xdgConfigHome: process.env.XDG_CONFIG_HOME ?? null,
+    version: package_default.version
   };
-  const notice = yield* updateNotice(package_default.version);
-  if (notice !== null) {
-    yield* exports_Console.warn(notice);
+  if (process.env[SKIP_UPDATE_ENVIRONMENT_VARIABLE] !== "1") {
+    const update2 = yield* autoUpdate(package_default.version, environment);
+    if (update2.status === "updated") {
+      const entrypoint = process.argv[1];
+      if (entrypoint !== undefined) {
+        const rerun = spawnSync(process.execPath, [entrypoint, ...environment.arguments], {
+          cwd: environment.cwd,
+          env: { ...process.env, [SKIP_UPDATE_ENVIRONMENT_VARIABLE]: "1" },
+          stdio: "inherit"
+        });
+        if (rerun.error === undefined && rerun.status !== null) {
+          process.exitCode = rerun.status;
+          return;
+        }
+      }
+    } else if (update2.status === "unknown") {
+      yield* exports_Console.warn(`Operator Helper ${update2.latest} is available, but automatic update could not determine whether Bun or npm owns this installation. Ask the user to update operator-helper manually using the original installation method.`);
+    }
   }
   const result4 = yield* runCli(environment.arguments, {
     cwd: environment.cwd,
     home: environment.home,
     xdgConfigHome: environment.xdgConfigHome,
-    version: package_default.version
+    version: environment.version
   });
   yield* exports_Console.log(result4.output);
   process.exitCode = result4.exitCode;
 }).pipe(exports_Effect.provide(LiveLayers));
 exports_NodeRuntime.runMain(main);
 
-//# debugId=AE02583E7563EEEA64756E2164756E21
+//# debugId=D773290F0860260964756E2164756E21