@mnemom/mnemom 0.17.2 → 0.17.3-next.0

package/dist/commands/config.d.ts

@@ -5,7 +5,7 @@
  *
  * Keys are data (CONFIG_KEYS) so list/get/set/unset share one source of truth.
  */
-import { type UpdatePrefs } from "../lib/update/decide.js";
+import { type InstallHint, type UpdatePrefs } from "../lib/update/decide.js";
 import { setUpdatePref } from "../lib/cli-config.js";
 export interface CliConfigKey {
     key: string;
@@ -13,8 +13,8 @@ export interface CliConfigKey {
     env: string;
     /** Stored value (undefined when unset). */
     stored(prefs: UpdatePrefs): string | undefined;
-    /** Value in effect after env + default. */
-    effective(prefs: UpdatePrefs, env: Record<string, string | undefined>): string;
+    /** Value in effect after env + default (`hint` picks the channel default). */
+    effective(prefs: UpdatePrefs, env: Record<string, string | undefined>, hint: InstallHint): string;
     /** Validate + persist; throws with a user-facing message on a bad value. */
     set(raw: string, persist: typeof setUpdatePref): void;
     unset(persist: typeof setUpdatePref): void;
@@ -26,6 +26,8 @@ export interface ConfigDeps {
     env: Record<string, string | undefined>;
     persist: typeof setUpdatePref;
     log(line: string): void;
+    /** Running version + last-followed channel (picks the default channel). */
+    hint: InstallHint;
 }
 /** One line per key: `key = effective  (source)  — description`. */
 export declare function configListCommand(opts?: {

package/dist/commands/config.js

@@ -7,13 +7,15 @@
  */
 import { isUpdateChannel, isUpdateMode, resolveChannel, resolveMode, UPDATE_CHANNELS, UPDATE_MODES, } from "../lib/update/decide.js";
 import { loadCliConfig, setUpdatePref } from "../lib/cli-config.js";
+import { loadUpdateState } from "../lib/update/state.js";
+import { CLI_VERSION } from "../version.js";
 export const CONFIG_KEYS = [
     {
         key: "update.channel",
-        describe: `Release channel for auto-update: ${UPDATE_CHANNELS.join(" | ")} (next requires an invite)`,
+        describe: `Release channel for auto-update: ${UPDATE_CHANNELS.join(" | ")} (default: next on a next build, else latest; next requires an invite)`,
         env: "MNEMOM_UPDATE_CHANNEL",
         stored: (p) => p.channel,
-        effective: (p, env) => resolveChannel(p, env),
+        effective: (p, env, hint) => resolveChannel(p, env, undefined, hint),
         set: (raw, persist) => {
             const v = raw.trim();
             if (!isUpdateChannel(v))
@@ -49,6 +51,7 @@ function defaultDeps() {
         env: process.env,
         persist: setUpdatePref,
         log: (line) => console.log(line),
+        hint: { current: CLI_VERSION, followed: loadUpdateState().followChannel },
     };
 }
 /** One line per key: `key = effective  (source)  — description`. */
@@ -57,7 +60,12 @@ export function configListCommand(opts = {}, deps = defaultDeps()) {
     const rows = CONFIG_KEYS.map((k) => {
         const stored = k.stored(prefs);
         const source = deps.env[k.env] ? `env ${k.env}` : stored !== undefined ? "config" : "default";
-        return { key: k.key, value: k.effective(prefs, deps.env), source, describe: k.describe };
+        return {
+            key: k.key,
+            value: k.effective(prefs, deps.env, deps.hint),
+            source,
+            describe: k.describe,
+        };
     });
     if (opts.json) {
         deps.log(JSON.stringify(rows, null, 2));
@@ -67,7 +75,7 @@ export function configListCommand(opts = {}, deps = defaultDeps()) {
         deps.log(`${r.key} = ${r.value}  (${r.source})  — ${r.describe}`);
 }
 export function configGetCommand(key, deps = defaultDeps()) {
-    deps.log(findKey(key).effective(deps.prefs(), deps.env));
+    deps.log(findKey(key).effective(deps.prefs(), deps.env, deps.hint));
 }
 export function configSetCommand(key, value, deps = defaultDeps()) {
     const spec = findKey(key);

package/dist/commands/update.d.ts

@@ -6,7 +6,7 @@
  * command is consent). `--check` never installs; `--force` permits a downgrade
  * to the channel's version (e.g. leaving next for latest).
  */
-import { type ResolvedSettings } from "../lib/update/decide.js";
+import { type InstallHint, type ResolvedSettings } from "../lib/update/decide.js";
 import { type RunDeps, type RunResult } from "../lib/update/run.js";
 export declare const NEXT_NOT_ENTITLED_HINT: string;
 export interface UpdateOptions {
@@ -16,7 +16,7 @@ export interface UpdateOptions {
     json?: boolean;
 }
 /** Validate flags → the settings for this foreground pass, or an error message. */
-export declare function foregroundSettings(opts: UpdateOptions, prefs?: import("../lib/update/decide.js").UpdatePrefs, env?: Record<string, string | undefined>): ResolvedSettings | string;
+export declare function foregroundSettings(opts: UpdateOptions, prefs?: import("../lib/update/decide.js").UpdatePrefs, env?: Record<string, string | undefined>, hint?: InstallHint): ResolvedSettings | string;
 /** Human-readable report of one pass. Pure, for testing. */
 export declare function formatUpdateResult(result: RunResult, current: string): string[];
 /** Exit status: non-zero only when something actually failed. */

package/dist/commands/update.js

@@ -10,17 +10,17 @@ import chalk from "chalk";
 import { CLI_VERSION } from "../version.js";
 import { canSelfUpdate, isUpdateChannel, manualUpgradeCommand, resolveChannel, UPDATE_CHANNELS, } from "../lib/update/decide.js";
 import { runUpdate } from "../lib/update/run.js";
-import { acquireLock } from "../lib/update/state.js";
+import { acquireLock, loadUpdateState } from "../lib/update/state.js";
 import { entryRealpath, foregroundCredential, loadUpdatePrefs } from "../lib/update/system.js";
 import { realRunDeps } from "../lib/update/worker.js";
 export const NEXT_NOT_ENTITLED_HINT = "The next channel is available to invited accounts. Ask your Mnemom contact for an invite " +
     "(and make sure you're logged in: mnemom login). Using latest for now.";
 /** Validate flags → the settings for this foreground pass, or an error message. */
-export function foregroundSettings(opts, prefs = loadUpdatePrefs(), env = process.env) {
+export function foregroundSettings(opts, prefs = loadUpdatePrefs(), env = process.env, hint = { current: CLI_VERSION, followed: loadUpdateState().followChannel }) {
     if (opts.channel !== undefined && !isUpdateChannel(opts.channel)) {
         return `--channel must be one of ${UPDATE_CHANNELS.join(", ")} (got '${opts.channel}').`;
     }
-    const channel = resolveChannel(prefs, env, opts.channel);
+    const channel = resolveChannel(prefs, env, opts.channel, hint);
     return { channel, mode: opts.check ? "notify" : "auto" };
 }
 /** Human-readable report of one pass. Pure, for testing. */

package/dist/lib/update/decide.d.ts

@@ -62,6 +62,8 @@ export interface UpdateState {
     entitlement?: EntitlementCache;
     /** Install method the worker last detected (startup can't afford `npm root -g`). */
     method?: InstallMethod;
+    /** Channel the last successful update installed from; feeds defaultChannel. */
+    followChannel?: UpdateChannel;
 }
 export interface UpdatePrefs {
     channel?: UpdateChannel;
@@ -75,8 +77,23 @@ export interface ResolvedSettings {
 }
 export declare function isUpdateChannel(v: unknown): v is UpdateChannel;
 export declare function isUpdateMode(v: unknown): v is UpdateMode;
-/** Channel precedence: flag > MNEMOM_UPDATE_CHANNEL > config.json > latest. */
-export declare function resolveChannel(prefs: UpdatePrefs, env: Record<string, string | undefined>, flag?: UpdateChannel): UpdateChannel;
+/** What the unconfigured default is derived from. */
+export interface InstallHint {
+    /** The running CLI version. */
+    current?: string;
+    /** The channel the last successful update installed from (update state). */
+    followed?: UpdateChannel;
+}
+/**
+ * The channel when nothing is configured: `next` if this build was installed
+ * from `@next` (a prerelease, e.g. a Mnemom Code invite) or the updater last
+ * installed from `next` — the latter keeps a `next` follower on `next` after
+ * `latest` overtakes it and they land on a stable build. Otherwise `latest`.
+ * The entitlement check still applies to a defaulted `next`.
+ */
+export declare function defaultChannel(hint?: InstallHint): UpdateChannel;
+/** Channel precedence: flag > MNEMOM_UPDATE_CHANNEL > config.json > defaultChannel(hint). */
+export declare function resolveChannel(prefs: UpdatePrefs, env: Record<string, string | undefined>, flag?: UpdateChannel, hint?: InstallHint): UpdateChannel;
 /** Mode precedence: flag > MNEMOM_UPDATE_MODE > config.json > auto. */
 export declare function resolveMode(prefs: UpdatePrefs, env: Record<string, string | undefined>, flag?: UpdateMode): UpdateMode;
 /**
@@ -91,6 +108,8 @@ export declare function resolveSettings(input: {
     env: Record<string, string | undefined>;
     isTTY: boolean;
     flags?: UpdatePrefs;
+    /** Picks the default channel when none is configured. */
+    hint?: InstallHint;
 }): ResolvedSettings;
 /** The channel actually honoured: `next` requires a positive entitlement. */
 export declare function effectiveChannel(requested: UpdateChannel, entitledToNext: boolean): UpdateChannel;

package/dist/lib/update/decide.js

@@ -45,10 +45,24 @@ export function isUpdateMode(v) {
 function truthyEnv(v) {
     return v !== undefined && v !== "" && v !== "0" && v.toLowerCase() !== "false";
 }
-/** Channel precedence: flag > MNEMOM_UPDATE_CHANNEL > config.json > latest. */
-export function resolveChannel(prefs, env, flag) {
+/**
+ * The channel when nothing is configured: `next` if this build was installed
+ * from `@next` (a prerelease, e.g. a Mnemom Code invite) or the updater last
+ * installed from `next` — the latter keeps a `next` follower on `next` after
+ * `latest` overtakes it and they land on a stable build. Otherwise `latest`.
+ * The entitlement check still applies to a defaulted `next`.
+ */
+export function defaultChannel(hint = {}) {
+    const onPrerelease = hint.current !== undefined && isPrerelease(hint.current);
+    return onPrerelease || hint.followed === "next" ? "next" : "latest";
+}
+/** Channel precedence: flag > MNEMOM_UPDATE_CHANNEL > config.json > defaultChannel(hint). */
+export function resolveChannel(prefs, env, flag, hint) {
     const fromEnv = env.MNEMOM_UPDATE_CHANNEL;
-    return flag ?? (isUpdateChannel(fromEnv) ? fromEnv : undefined) ?? prefs.channel ?? "latest";
+    return (flag ??
+        (isUpdateChannel(fromEnv) ? fromEnv : undefined) ??
+        prefs.channel ??
+        defaultChannel(hint));
 }
 /** Mode precedence: flag > MNEMOM_UPDATE_MODE > config.json > auto. */
 export function resolveMode(prefs, env, flag) {
@@ -63,8 +77,8 @@ export function resolveMode(prefs, env, flag) {
  * every command.
  */
 export function resolveSettings(input) {
-    const { prefs, env, isTTY, flags } = input;
-    const channel = resolveChannel(prefs, env, flags?.channel);
+    const { prefs, env, isTTY, flags, hint } = input;
+    const channel = resolveChannel(prefs, env, flags?.channel, hint);
     const mode = resolveMode(prefs, env, flags?.mode);
     if (truthyEnv(env.MNEMOM_DISABLE_AUTOUPDATE)) {
         return { channel, mode: "off", offReason: "MNEMOM_DISABLE_AUTOUPDATE is set" };

package/dist/lib/update/doctor.js

@@ -53,11 +53,13 @@ export function updateDoctorRow(input) {
     };
 }
 export async function probeUpdateStatus() {
+    const state = loadUpdateState();
     const settings = resolveSettings({
         prefs: loadUpdatePrefs(),
         env: process.env,
         isTTY: process.stdout.isTTY === true,
+        hint: { current: CLI_VERSION, followed: state.followChannel },
     });
     const method = classifyInstall(entryRealpath(process.argv[1]), await npmGlobalRoot());
-    return updateDoctorRow({ current: CLI_VERSION, settings, method, state: loadUpdateState() });
+    return updateDoctorRow({ current: CLI_VERSION, settings, method, state });
 }

package/dist/lib/update/min-version.js

@@ -6,9 +6,10 @@
  */
 import { spawnSync } from "node:child_process";
 import { canSelfUpdate, PACKAGE_NAME, resolveSettings, } from "./decide.js";
+import { CLI_VERSION } from "../../version.js";
 import { classifyInstall } from "./install-method.js";
 import { isValidVersion, isPrerelease } from "./semver.js";
-import { acquireLock } from "./state.js";
+import { acquireLock, loadUpdateState } from "./state.js";
 import { entryRealpath, loadUpdatePrefs, npmInvocation } from "./system.js";
 /**
  * Returns true when the CLI was upgraded. Only in `auto` mode — `notify` means
@@ -54,6 +55,7 @@ export function defaultFloorUpgradeDeps() {
             prefs: loadUpdatePrefs(),
             env: process.env,
             isTTY: process.stdout.isTTY === true,
+            hint: { current: CLI_VERSION, followed: loadUpdateState().followChannel },
         }),
         method: () => {
             const root = spawnNpmSync(inv, ["root", "-g"], { timeout: 15_000 });

package/dist/lib/update/run.js

@@ -86,6 +86,7 @@ export async function runUpdate(deps, settings, opts = {}) {
             available: undefined,
             installBlocked: undefined,
             pending: { from: deps.current, to: action.version, channel },
+            followChannel: channel,
         });
         return { ...result, installed: action.version };
     }

package/dist/lib/update/startup.js

@@ -16,13 +16,18 @@ import { entryRealpath, loadUpdatePrefs } from "./system.js";
 const SKIP_COMMANDS = new Set(["update", "config"]);
 export function maybeRunUpdateHook(deps) {
     try {
-        const settings = resolveSettings({ prefs: deps.prefs(), env: deps.env, isTTY: deps.stdoutTTY });
+        const state = deps.loadState();
+        const settings = resolveSettings({
+            prefs: deps.prefs(),
+            env: deps.env,
+            isTTY: deps.stdoutTTY,
+            hint: { current: deps.current, followed: state.followChannel },
+        });
         if (settings.mode === "off")
             return;
         if (classifyInstall(deps.entryPath, undefined) === "dev")
             return;
         const now = deps.now();
-        const state = deps.loadState();
         const notice = startupNotice({
             current: deps.current,
             state,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemom/mnemom",
-  "version": "0.17.2",
+  "version": "0.17.3-next.0",
   "description": "Transparent AI agent tracing",
   "type": "module",
   "bin": {