scenv 0.6.0 → 0.7.0

package/dist/index.cjs

@@ -25,12 +25,16 @@ __export(index_exports, {
   discoverContextPaths: () => discoverContextPaths,
   getCallbacks: () => getCallbacks,
   getContext: () => getContext,
+  getContextWritePath: () => getContextWritePath,
+  getInMemoryContext: () => getInMemoryContext,
   getMergedContextValues: () => getMergedContextValues,
   loadConfig: () => loadConfig,
   parseScenvArgs: () => parseScenvArgs,
   resetConfig: () => resetConfig,
+  resetInMemoryContext: () => resetInMemoryContext,
   resetLogState: () => resetLogState,
-  scenv: () => scenv
+  scenv: () => scenv,
+  setInMemoryContext: () => setInMemoryContext
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -40,19 +44,6 @@ var import_node_path = require("path");
 
 // src/prompt-default.ts
 var import_node_readline = require("readline");
-function ask(message) {
-  const rl = (0, import_node_readline.createInterface)({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve, reject) => {
-    rl.question(message, (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
-    rl.on("error", (err) => {
-      rl.close();
-      reject(err);
-    });
-  });
-}
 function defaultPrompt(name, defaultValue) {
   const defaultStr = defaultValue !== void 0 && defaultValue !== null ? String(defaultValue) : "";
   const message = defaultStr ? `Enter ${name} [${defaultStr}]: ` : `Enter ${name}: `;
@@ -70,17 +61,6 @@ function defaultPrompt(name, defaultValue) {
     });
   });
 }
-async function defaultAskWhetherToSave(name, _value) {
-  const answer = await ask(`Save "${name}" for next time? (y/n): `);
-  const v = answer.toLowerCase();
-  return v === "y" || v === "yes" || v === "1" || v === "true";
-}
-async function defaultAskContext(name, contextNames) {
-  const hint = contextNames.length > 0 ? ` (${contextNames.join(", ")})` : "";
-  const answer = await ask(`Save "${name}" to which context?${hint}: `);
-  if (answer) return answer;
-  return contextNames[0] ?? "default";
-}
 
 // src/config.ts
 var LOG_LEVELS = ["none", "trace", "debug", "info", "warn", "error"];
@@ -91,7 +71,6 @@ var envKeyMap = {
   SCENV_PROMPT: "prompt",
   SCENV_IGNORE_ENV: "ignoreEnv",
   SCENV_IGNORE_CONTEXT: "ignoreContext",
-  SCENV_SAVE_PROMPT: "shouldSavePrompt",
   SCENV_SAVE_CONTEXT_TO: "saveContextTo",
   SCENV_CONTEXT_DIR: "contextDir",
   SCENV_LOG_LEVEL: "logLevel"
@@ -100,9 +79,7 @@ var programmaticConfig = {};
 var programmaticCallbacks = {};
 function getCallbacks() {
   return {
-    defaultPrompt: programmaticCallbacks.defaultPrompt ?? defaultPrompt,
-    onAskWhetherToSave: programmaticCallbacks.onAskWhetherToSave ?? defaultAskWhetherToSave,
-    onAskContext: programmaticCallbacks.onAskContext ?? defaultAskContext
+    defaultPrompt: programmaticCallbacks.defaultPrompt ?? defaultPrompt
   };
 }
 function findConfigDir(startDir) {
@@ -125,11 +102,9 @@ function configFromEnv() {
       out[configKey] = val.split(",").map((s) => s.trim()).filter(Boolean);
     } else if (configKey === "ignoreEnv" || configKey === "ignoreContext") {
       out[configKey] = val === "1" || val === "true" || val.toLowerCase() === "yes";
-    } else if (configKey === "prompt" || configKey === "shouldSavePrompt") {
+    } else if (configKey === "prompt") {
       const v = val.toLowerCase();
-      if (configKey === "prompt" && (v === "always" || v === "never" || v === "fallback" || v === "no-env"))
-        out[configKey] = v;
-      if (configKey === "shouldSavePrompt" && (v === "always" || v === "never" || v === "ask"))
+      if (v === "always" || v === "never" || v === "fallback" || v === "no-env")
         out[configKey] = v;
     } else if (configKey === "saveContextTo") {
       out.saveContextTo = val;
@@ -172,8 +147,6 @@ function loadConfigFile(configDir) {
       out.ignoreContext = parsed.ignoreContext;
     if (parsed.set && typeof parsed.set === "object" && !Array.isArray(parsed.set))
       out.set = parsed.set;
-    if (typeof (parsed.shouldSavePrompt ?? parsed.savePrompt) === "string" && ["always", "never", "ask"].includes(parsed.shouldSavePrompt ?? parsed.savePrompt))
-      out.shouldSavePrompt = parsed.shouldSavePrompt ?? parsed.savePrompt;
     if (typeof parsed.saveContextTo === "string")
       out.saveContextTo = parsed.saveContextTo;
     if (typeof parsed.contextDir === "string") out.contextDir = parsed.contextDir;
@@ -257,16 +230,41 @@ var configLoadedLogged = false;
 function resetLogState() {
   configLoadedLogged = false;
 }
+var CONFIG_LOG_KEYS = [
+  "root",
+  "context",
+  "prompt",
+  "ignoreEnv",
+  "ignoreContext",
+  "set",
+  "saveContextTo",
+  "contextDir",
+  "logLevel"
+];
+function configForLog(config) {
+  return Object.fromEntries(
+    CONFIG_LOG_KEYS.filter((k) => config[k] !== void 0).map((k) => [k, config[k]])
+  );
+}
 function logConfigLoaded(config) {
   if (configLoadedLogged) return;
-  if (getLevelNum() < LEVEL_NUM.info) return;
   configLoadedLogged = true;
-  log(
-    "info",
-    "config loaded",
-    "root=" + (config.root ?? "(cwd)"),
-    "context=" + JSON.stringify(config.context ?? [])
-  );
+  const levelNum = LEVEL_NUM[config.logLevel ?? "none"];
+  if (levelNum >= LEVEL_NUM.info) {
+    const parts = [
+      "root=" + (config.root ?? "(cwd)"),
+      "context=" + JSON.stringify(config.context ?? [])
+    ];
+    if (config.prompt !== void 0) parts.push("prompt=" + config.prompt);
+    if (config.ignoreEnv === true) parts.push("ignoreEnv=true");
+    if (config.ignoreContext === true) parts.push("ignoreContext=true");
+    if (config.saveContextTo !== void 0) parts.push("saveContextTo=" + config.saveContextTo);
+    if (config.contextDir !== void 0) parts.push("contextDir=" + config.contextDir);
+    log("info", "config loaded", parts.join(" "));
+  }
+  if (levelNum >= LEVEL_NUM.debug) {
+    log("debug", "config (full)", JSON.stringify(configForLog(config)));
+  }
 }
 function log(level, msg, ...args) {
   const configured = getLevelNum();
@@ -284,6 +282,16 @@ function log(level, msg, ...args) {
 var import_node_fs2 = require("fs");
 var import_node_path2 = require("path");
 var CONTEXT_SUFFIX = ".context.json";
+var inMemoryContext = {};
+function getInMemoryContext() {
+  return inMemoryContext;
+}
+function setInMemoryContext(key, value) {
+  inMemoryContext[key] = value;
+}
+function resetInMemoryContext() {
+  inMemoryContext = {};
+}
 function discoverContextPathsInternal(dir, found) {
   let entries;
   try {
@@ -351,6 +359,14 @@ function getMergedContextValues() {
   const root = config.root ?? process.cwd();
   const paths = discoverContextPaths(root);
   const out = {};
+  if (config.saveContextTo) {
+    const savePath = resolveSaveContextPath(config.saveContextTo);
+    const saveCtx = getContextAtPath(savePath);
+    for (const [k, v] of Object.entries(saveCtx)) out[k] = v;
+    if (Object.keys(saveCtx).length > 0) {
+      log("debug", `saveContextTo "${config.saveContextTo}" loaded keys=${JSON.stringify(Object.keys(saveCtx))}`);
+    }
+  }
   for (const contextName of config.context ?? []) {
     const filePath = paths.get(contextName);
     if (!filePath) {
@@ -378,6 +394,9 @@ function getMergedContextValues() {
   return out;
 }
 function getContextWritePath(contextName) {
+  if ((0, import_node_path2.isAbsolute)(contextName) || contextName.includes(import_node_path2.sep)) {
+    return contextName.endsWith(CONTEXT_SUFFIX) ? contextName : contextName + CONTEXT_SUFFIX;
+  }
   const config = loadConfig();
   const root = config.root ?? process.cwd();
   const paths = discoverContextPaths(root);
@@ -386,6 +405,26 @@ function getContextWritePath(contextName) {
   const saveDir = config.contextDir ? (0, import_node_path2.isAbsolute)(config.contextDir) ? config.contextDir : (0, import_node_path2.join)(root, config.contextDir) : root;
   return (0, import_node_path2.join)(saveDir, `${contextName}${CONTEXT_SUFFIX}`);
 }
+function resolveSaveContextPath(nameOrPath) {
+  if ((0, import_node_path2.isAbsolute)(nameOrPath) || nameOrPath.includes(import_node_path2.sep)) {
+    return nameOrPath.endsWith(CONTEXT_SUFFIX) ? nameOrPath : nameOrPath + CONTEXT_SUFFIX;
+  }
+  return getContextWritePath(nameOrPath);
+}
+function getContextAtPath(filePath) {
+  if (!(0, import_node_fs2.existsSync)(filePath)) return {};
+  try {
+    const raw = (0, import_node_fs2.readFileSync)(filePath, "utf-8");
+    const data = JSON.parse(raw);
+    const out = {};
+    for (const [k, v] of Object.entries(data)) {
+      if (typeof v === "string") out[k] = v;
+    }
+    return out;
+  } catch {
+    return {};
+  }
+}
 function writeToContext(contextName, key, value) {
   const path = getContextWritePath(contextName);
   let data = {};
@@ -482,6 +521,12 @@ function scenv(name, options = {}) {
         return { raw, source: "env" };
       }
     }
+    const mem = getInMemoryContext();
+    if (mem[key] !== void 0) {
+      log("trace", `resolveRaw: in-memory hit key=${key}`);
+      const raw = resolveContextReference(mem[key], key);
+      return { raw, source: "context" };
+    }
     if (!config.ignoreContext) {
       log("trace", "resolveRaw: checking context");
       const ctx = getMergedContextValues();
@@ -567,36 +612,11 @@ function scenv(name, options = {}) {
     const final = validated.data;
     if (wasPrompted) {
       const config = loadConfig();
-      const mode = config.shouldSavePrompt ?? (config.prompt === "never" ? "never" : "ask");
-      if (mode === "never") return final;
-      let doSave;
-      if (mode === "ask") {
-        const callbacks2 = getCallbacks();
-        if (typeof callbacks2.onAskWhetherToSave !== "function") {
-          throw new Error(
-            `shouldSavePrompt is "ask" but onAskWhetherToSave callback is not set. Configure callbacks via configure({ callbacks: { onAskWhetherToSave: ... } }).`
-          );
-        }
-        doSave = await callbacks2.onAskWhetherToSave(name, final);
-      } else {
-        doSave = true;
+      setInMemoryContext(key, String(final));
+      if (config.saveContextTo) {
+        writeToContext(config.saveContextTo, key, String(final));
+        log("info", `Saved key=${key} to saveContextTo ${config.saveContextTo}`);
       }
-      if (!doSave) return final;
-      const callbacks = getCallbacks();
-      const contextNames = config.context ?? [];
-      let ctxToSave;
-      if (config.saveContextTo === "ask") {
-        if (typeof callbacks.onAskContext !== "function") {
-          throw new Error(
-            `saveContextTo is "ask" but onAskContext callback is not set. Configure callbacks via configure({ callbacks: { onAskContext: ... } }).`
-          );
-        }
-        ctxToSave = await callbacks.onAskContext(name, contextNames);
-      } else {
-        ctxToSave = config.saveContextTo ?? contextNames[0] ?? "default";
-      }
-      writeToContext(ctxToSave, key, String(final));
-      log("info", `Saved key=${key} to context ${ctxToSave}`);
     }
     return final;
   }
@@ -617,22 +637,11 @@ function scenv(name, options = {}) {
       throw new Error(errMsg);
     }
     const config = loadConfig();
-    let contextName = config.saveContextTo;
-    if (contextName === "ask") {
-      const callbacks = getCallbacks();
-      if (typeof callbacks.onAskContext !== "function") {
-        throw new Error(
-          `saveContextTo is "ask" but onAskContext callback is not set. Configure callbacks via configure({ callbacks: { onAskContext: ... } }).`
-        );
-      }
-      contextName = await callbacks.onAskContext(
-        name,
-        config.context ?? []
-      );
+    setInMemoryContext(key, String(validated.data));
+    if (config.saveContextTo) {
+      writeToContext(config.saveContextTo, key, String(validated.data));
+      log("info", `Saved key=${key} to saveContextTo ${config.saveContextTo}`);
     }
-    if (!contextName) contextName = config.context?.[0] ?? "default";
-    writeToContext(contextName, key, String(validated.data));
-    log("info", `Saved key=${key} to context ${contextName}`);
   }
   return { get, safeGet, save };
 }
@@ -663,11 +672,6 @@ function parseScenvArgs(argv) {
         config.set = config.set ?? {};
         config.set[pair.slice(0, eq).trim()] = pair.slice(eq + 1).trim();
       }
-    } else if (arg === "--save-prompt" && argv[i + 1] !== void 0) {
-      const v = argv[++i].toLowerCase();
-      if (["always", "never", "ask"].includes(v)) {
-        config.shouldSavePrompt = v;
-      }
     } else if (arg === "--save-context-to" && argv[i + 1] !== void 0) {
       config.saveContextTo = argv[++i];
     } else if (arg === "--context-dir" && argv[i + 1] !== void 0) {
@@ -701,10 +705,14 @@ function parseScenvArgs(argv) {
   discoverContextPaths,
   getCallbacks,
   getContext,
+  getContextWritePath,
+  getInMemoryContext,
   getMergedContextValues,
   loadConfig,
   parseScenvArgs,
   resetConfig,
+  resetInMemoryContext,
   resetLogState,
-  scenv
+  scenv,
+  setInMemoryContext
 });

package/dist/index.d.cts

@@ -6,13 +6,6 @@
  * - `"no-env"` – Prompt when the env var is not set (even if context has a value).
  */
 type PromptMode = "always" | "never" | "fallback" | "no-env";
-/**
- * What to do with the value after the user was just prompted for it.
- * - `"never"` – Do not save; discard for next time.
- * - `"always"` – Save it (no prompt). Use saveContextTo or onAskContext only to pick where.
- * - `"ask"` – Call {@link ScenvCallbacks.onAskWhetherToSave}; if true save, if false don't save.
- */
-type SavePromptMode = "always" | "never" | "ask";
 /**
  * Valid log levels. Use with {@link ScenvConfig.logLevel}.
  * Messages at or above the configured level are written to stderr.
@@ -38,10 +31,8 @@ interface ScenvConfig {
     ignoreContext?: boolean;
     /** Override values by key (CLI: `--set key=value`). Takes precedence over env and context. */
     set?: Record<string, string>;
-    /** After a prompt: "never" = don't save, "always" = save without asking, "ask" = call onAskWhetherToSave (then save if true). */
-    shouldSavePrompt?: SavePromptMode;
-    /** Target context for saving: a context name, or `"ask"` to use {@link ScenvCallbacks.onAskContext}. */
-    saveContextTo?: "ask" | string;
+    /** Optional path or context name (without .context.json) where to save resolved values. If set, all saves go here and this context is used before prompting. If unset, values are saved to an in-memory context only (same process). */
+    saveContextTo?: string;
     /** Directory to save context files to when the context is not already discovered. Relative to root unless absolute. If unset, new context files are saved under root. */
     contextDir?: string;
     /** Root directory for config file search and context discovery. Default is cwd or the directory containing scenv.config.json. */
@@ -57,22 +48,16 @@ interface ScenvConfig {
  */
 type DefaultPromptFn = (name: string, defaultValue: unknown) => unknown | Promise<unknown>;
 /**
- * Callbacks for interactive behaviour. All have built-in readline defaults when not set.
- * Pass to {@link configure} via `configure({ callbacks: { ... } })`.
+ * Callbacks for interactive behaviour. Pass to {@link configure} via `configure({ callbacks: { ... } })`.
  */
 interface ScenvCallbacks {
     /** Used when a variable does not define its own `prompt`. Variable-level `prompt` overrides this. */
     defaultPrompt?: DefaultPromptFn;
-    /** Called only when {@link ScenvConfig.shouldSavePrompt} is "ask" and the user was just prompted. Return true to save, false to skip. (With "always", we save without calling this.) */
-    onAskWhetherToSave?: (name: string, value: unknown) => Promise<boolean>;
-    /** Called when the save destination is ambiguous: saveContextTo is "ask", or after a prompt when the user said yes and saveContextTo is "ask". Return the context name to write to. */
-    onAskContext?: (name: string, contextNames: string[]) => Promise<string>;
 }
 /**
- * Returns the current callbacks (with built-in defaults merged in for any unset callback).
- * Useful for inspection or to pass a subset to another layer. Each call returns a new object.
+ * Returns the current callbacks (with built-in default for defaultPrompt when not set).
  *
- * @returns Copy of the effective callbacks: defaultPrompt, onAskWhetherToSave, onAskContext (always defined).
+ * @returns Copy of the effective callbacks.
  */
 declare function getCallbacks(): ScenvCallbacks;
 /**
@@ -108,6 +93,19 @@ declare function resetConfig(): void;
  */
 declare function resetLogState(): void;
 
+/**
+ * Returns the current in-memory context (key → value). Used during resolution before file contexts.
+ * Modifying the returned object mutates the store.
+ */
+declare function getInMemoryContext(): Record<string, string>;
+/**
+ * Sets a key-value pair in the in-memory context. Used when saving after prompt or save() when saveContextTo is unset, and always updated when a value is saved so the next get() sees it.
+ */
+declare function setInMemoryContext(key: string, value: string): void;
+/**
+ * Clears the in-memory context. Mainly for tests. Call in beforeEach to get a clean slate.
+ */
+declare function resetInMemoryContext(): void;
 /**
  * Recursively discovers all `*.context.json` files under a directory. Context name is the
  * filename without the suffix (e.g. `dev.context.json` → "dev"). First file found for a
@@ -130,14 +128,23 @@ declare function discoverContextPaths(dir: string, found?: Map<string, string>):
  */
 declare function getContext(contextName: string, root?: string): Record<string, string>;
 /**
- * Loads and merges context values from the current config. Respects {@link ScenvConfig.context}
- * order and {@link ScenvConfig.ignoreContext}. Each context file is a JSON object of string
- * key-value pairs; later contexts overwrite earlier for the same key. Used during variable
- * resolution (set > env > context > default).
+ * Loads and merges context values from the current config. If {@link ScenvConfig.saveContextTo}
+ * is set, that context (file path or name) is loaded first; then {@link ScenvConfig.context}
+ * order. Respects {@link ScenvConfig.ignoreContext}. Later contexts overwrite earlier for the same key.
+ * Used during variable resolution (set > env > in-memory > merged context > default).
  *
  * @returns A flat record of key → string value. Empty if ignoreContext is true or no context loaded.
  */
 declare function getMergedContextValues(): Record<string, string>;
+/**
+ * Returns the file path used for a context name or path when saving.
+ * - If contextName is path-like (absolute or contains path separator), returns that path with .context.json appended if not already present.
+ * - Otherwise, if that context was already discovered under config.root, returns its path; else uses config.contextDir (if set) or root.
+ *
+ * @param contextName - Context name (e.g. "dev", "prod") or file path without suffix (e.g. "/path/to/myfile" → myfile.context.json).
+ * @returns Absolute path to the context JSON file.
+ */
+declare function getContextWritePath(contextName: string): string;
 
 /**
  * Return type for a variable's optional `validator` function. Use a boolean for simple
@@ -205,8 +212,8 @@ interface ScenvVariable<T> {
         error?: unknown;
     }>;
     /**
-     * Write the value to a context file (e.g. for next run). Target context comes from config.saveContextTo or onAskContext.
-     * If you don't pass a value, the last resolved value is used. Does not prompt "save?"; it saves.
+     * Write the value to the save target: if config.saveContextTo is set, to that context file; otherwise to in-memory only.
+     * If you don't pass a value, the last resolved value is used. Does not prompt; it saves. The value is always stored in-memory so the next get() sees it.
      */
     save(value?: T): Promise<void>;
 }
@@ -236,9 +243,9 @@ interface ScenvVariable<T> {
  * ## save()
  *
  * The variable has a save(value?) method. It writes the value (or the last resolved value if you omit it)
- * to a context file. The target context comes from config.saveContextTo or from the onAskContext callback
- * when saveContextTo is "ask". save() does not ask "save?"; it saves. Optional "save after prompt" behavior
- * is controlled by config.shouldSavePrompt and callbacks.onAskWhetherToSave.
+ * to the save target (config.saveContextTo file if set, otherwise in-memory). save() does not ask; it saves.
+ * When the user is prompted during get(), the value is always saved (to saveContextTo file if set, and always to in-memory)
+ * so a second get() on the same variable does not prompt again.
  *
  * @typeParam T - Value type (default string). Use a validator to coerce to number, boolean, etc.
  * @param name - Display name used in prompts and errors. If you omit key/env, key is derived from name (e.g. "API URL" → "api_url") and env from key (e.g. "API_URL").
@@ -262,8 +269,7 @@ declare function scenv<T>(name: string, options?: ScenvVariableOptions<T>): Scen
  * - `--ignore-env` – Set ignoreEnv to true.
  * - `--ignore-context` – Set ignoreContext to true.
  * - `--set key=value` or `--set=key=value` – Add to set overrides (multiple allowed).
- * - `--save-prompt always|never|ask` – shouldSavePrompt.
- * - `--save-context-to name` – saveContextTo.
+ * - `--save-context-to pathOrName` – saveContextTo (path or context name without .context.json).
  * - `--context-dir path` – contextDir (directory to save context files to by default).
  * - `--log-level level`, `--log level`, `--log=level` – logLevel.
  *
@@ -272,4 +278,4 @@ declare function scenv<T>(name: string, options?: ScenvVariableOptions<T>): Scen
  */
 declare function parseScenvArgs(argv: string[]): Partial<ScenvConfig>;
 
-export { type DefaultPromptFn, type GetOptions, LOG_LEVELS, type LogLevel, type PromptMode, type SavePromptMode, type ScenvCallbacks, type ScenvConfig, type ScenvVariable, configure, discoverContextPaths, getCallbacks, getContext, getMergedContextValues, loadConfig, parseScenvArgs, resetConfig, resetLogState, scenv };
+export { type DefaultPromptFn, type GetOptions, LOG_LEVELS, type LogLevel, type PromptMode, type ScenvCallbacks, type ScenvConfig, type ScenvVariable, configure, discoverContextPaths, getCallbacks, getContext, getContextWritePath, getInMemoryContext, getMergedContextValues, loadConfig, parseScenvArgs, resetConfig, resetInMemoryContext, resetLogState, scenv, setInMemoryContext };

package/dist/index.d.ts

@@ -6,13 +6,6 @@
  * - `"no-env"` – Prompt when the env var is not set (even if context has a value).
  */
 type PromptMode = "always" | "never" | "fallback" | "no-env";
-/**
- * What to do with the value after the user was just prompted for it.
- * - `"never"` – Do not save; discard for next time.
- * - `"always"` – Save it (no prompt). Use saveContextTo or onAskContext only to pick where.
- * - `"ask"` – Call {@link ScenvCallbacks.onAskWhetherToSave}; if true save, if false don't save.
- */
-type SavePromptMode = "always" | "never" | "ask";
 /**
  * Valid log levels. Use with {@link ScenvConfig.logLevel}.
  * Messages at or above the configured level are written to stderr.
@@ -38,10 +31,8 @@ interface ScenvConfig {
     ignoreContext?: boolean;
     /** Override values by key (CLI: `--set key=value`). Takes precedence over env and context. */
     set?: Record<string, string>;
-    /** After a prompt: "never" = don't save, "always" = save without asking, "ask" = call onAskWhetherToSave (then save if true). */
-    shouldSavePrompt?: SavePromptMode;
-    /** Target context for saving: a context name, or `"ask"` to use {@link ScenvCallbacks.onAskContext}. */
-    saveContextTo?: "ask" | string;
+    /** Optional path or context name (without .context.json) where to save resolved values. If set, all saves go here and this context is used before prompting. If unset, values are saved to an in-memory context only (same process). */
+    saveContextTo?: string;
     /** Directory to save context files to when the context is not already discovered. Relative to root unless absolute. If unset, new context files are saved under root. */
     contextDir?: string;
     /** Root directory for config file search and context discovery. Default is cwd or the directory containing scenv.config.json. */
@@ -57,22 +48,16 @@ interface ScenvConfig {
  */
 type DefaultPromptFn = (name: string, defaultValue: unknown) => unknown | Promise<unknown>;
 /**
- * Callbacks for interactive behaviour. All have built-in readline defaults when not set.
- * Pass to {@link configure} via `configure({ callbacks: { ... } })`.
+ * Callbacks for interactive behaviour. Pass to {@link configure} via `configure({ callbacks: { ... } })`.
  */
 interface ScenvCallbacks {
     /** Used when a variable does not define its own `prompt`. Variable-level `prompt` overrides this. */
     defaultPrompt?: DefaultPromptFn;
-    /** Called only when {@link ScenvConfig.shouldSavePrompt} is "ask" and the user was just prompted. Return true to save, false to skip. (With "always", we save without calling this.) */
-    onAskWhetherToSave?: (name: string, value: unknown) => Promise<boolean>;
-    /** Called when the save destination is ambiguous: saveContextTo is "ask", or after a prompt when the user said yes and saveContextTo is "ask". Return the context name to write to. */
-    onAskContext?: (name: string, contextNames: string[]) => Promise<string>;
 }
 /**
- * Returns the current callbacks (with built-in defaults merged in for any unset callback).
- * Useful for inspection or to pass a subset to another layer. Each call returns a new object.
+ * Returns the current callbacks (with built-in default for defaultPrompt when not set).
  *
- * @returns Copy of the effective callbacks: defaultPrompt, onAskWhetherToSave, onAskContext (always defined).
+ * @returns Copy of the effective callbacks.
  */
 declare function getCallbacks(): ScenvCallbacks;
 /**
@@ -108,6 +93,19 @@ declare function resetConfig(): void;
  */
 declare function resetLogState(): void;
 
+/**
+ * Returns the current in-memory context (key → value). Used during resolution before file contexts.
+ * Modifying the returned object mutates the store.
+ */
+declare function getInMemoryContext(): Record<string, string>;
+/**
+ * Sets a key-value pair in the in-memory context. Used when saving after prompt or save() when saveContextTo is unset, and always updated when a value is saved so the next get() sees it.
+ */
+declare function setInMemoryContext(key: string, value: string): void;
+/**
+ * Clears the in-memory context. Mainly for tests. Call in beforeEach to get a clean slate.
+ */
+declare function resetInMemoryContext(): void;
 /**
  * Recursively discovers all `*.context.json` files under a directory. Context name is the
  * filename without the suffix (e.g. `dev.context.json` → "dev"). First file found for a
@@ -130,14 +128,23 @@ declare function discoverContextPaths(dir: string, found?: Map<string, string>):
  */
 declare function getContext(contextName: string, root?: string): Record<string, string>;
 /**
- * Loads and merges context values from the current config. Respects {@link ScenvConfig.context}
- * order and {@link ScenvConfig.ignoreContext}. Each context file is a JSON object of string
- * key-value pairs; later contexts overwrite earlier for the same key. Used during variable
- * resolution (set > env > context > default).
+ * Loads and merges context values from the current config. If {@link ScenvConfig.saveContextTo}
+ * is set, that context (file path or name) is loaded first; then {@link ScenvConfig.context}
+ * order. Respects {@link ScenvConfig.ignoreContext}. Later contexts overwrite earlier for the same key.
+ * Used during variable resolution (set > env > in-memory > merged context > default).
  *
  * @returns A flat record of key → string value. Empty if ignoreContext is true or no context loaded.
  */
 declare function getMergedContextValues(): Record<string, string>;
+/**
+ * Returns the file path used for a context name or path when saving.
+ * - If contextName is path-like (absolute or contains path separator), returns that path with .context.json appended if not already present.
+ * - Otherwise, if that context was already discovered under config.root, returns its path; else uses config.contextDir (if set) or root.
+ *
+ * @param contextName - Context name (e.g. "dev", "prod") or file path without suffix (e.g. "/path/to/myfile" → myfile.context.json).
+ * @returns Absolute path to the context JSON file.
+ */
+declare function getContextWritePath(contextName: string): string;
 
 /**
  * Return type for a variable's optional `validator` function. Use a boolean for simple
@@ -205,8 +212,8 @@ interface ScenvVariable<T> {
         error?: unknown;
     }>;
     /**
-     * Write the value to a context file (e.g. for next run). Target context comes from config.saveContextTo or onAskContext.
-     * If you don't pass a value, the last resolved value is used. Does not prompt "save?"; it saves.
+     * Write the value to the save target: if config.saveContextTo is set, to that context file; otherwise to in-memory only.
+     * If you don't pass a value, the last resolved value is used. Does not prompt; it saves. The value is always stored in-memory so the next get() sees it.
      */
     save(value?: T): Promise<void>;
 }
@@ -236,9 +243,9 @@ interface ScenvVariable<T> {
  * ## save()
  *
  * The variable has a save(value?) method. It writes the value (or the last resolved value if you omit it)
- * to a context file. The target context comes from config.saveContextTo or from the onAskContext callback
- * when saveContextTo is "ask". save() does not ask "save?"; it saves. Optional "save after prompt" behavior
- * is controlled by config.shouldSavePrompt and callbacks.onAskWhetherToSave.
+ * to the save target (config.saveContextTo file if set, otherwise in-memory). save() does not ask; it saves.
+ * When the user is prompted during get(), the value is always saved (to saveContextTo file if set, and always to in-memory)
+ * so a second get() on the same variable does not prompt again.
  *
  * @typeParam T - Value type (default string). Use a validator to coerce to number, boolean, etc.
  * @param name - Display name used in prompts and errors. If you omit key/env, key is derived from name (e.g. "API URL" → "api_url") and env from key (e.g. "API_URL").
@@ -262,8 +269,7 @@ declare function scenv<T>(name: string, options?: ScenvVariableOptions<T>): Scen
  * - `--ignore-env` – Set ignoreEnv to true.
  * - `--ignore-context` – Set ignoreContext to true.
  * - `--set key=value` or `--set=key=value` – Add to set overrides (multiple allowed).
- * - `--save-prompt always|never|ask` – shouldSavePrompt.
- * - `--save-context-to name` – saveContextTo.
+ * - `--save-context-to pathOrName` – saveContextTo (path or context name without .context.json).
  * - `--context-dir path` – contextDir (directory to save context files to by default).
  * - `--log-level level`, `--log level`, `--log=level` – logLevel.
  *
@@ -272,4 +278,4 @@ declare function scenv<T>(name: string, options?: ScenvVariableOptions<T>): Scen
  */
 declare function parseScenvArgs(argv: string[]): Partial<ScenvConfig>;
 
-export { type DefaultPromptFn, type GetOptions, LOG_LEVELS, type LogLevel, type PromptMode, type SavePromptMode, type ScenvCallbacks, type ScenvConfig, type ScenvVariable, configure, discoverContextPaths, getCallbacks, getContext, getMergedContextValues, loadConfig, parseScenvArgs, resetConfig, resetLogState, scenv };
+export { type DefaultPromptFn, type GetOptions, LOG_LEVELS, type LogLevel, type PromptMode, type ScenvCallbacks, type ScenvConfig, type ScenvVariable, configure, discoverContextPaths, getCallbacks, getContext, getContextWritePath, getInMemoryContext, getMergedContextValues, loadConfig, parseScenvArgs, resetConfig, resetInMemoryContext, resetLogState, scenv, setInMemoryContext };

package/dist/index.js

@@ -4,19 +4,6 @@ import { dirname, join } from "path";
 
 // src/prompt-default.ts
 import { createInterface } from "readline";
-function ask(message) {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve, reject) => {
-    rl.question(message, (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
-    rl.on("error", (err) => {
-      rl.close();
-      reject(err);
-    });
-  });
-}
 function defaultPrompt(name, defaultValue) {
   const defaultStr = defaultValue !== void 0 && defaultValue !== null ? String(defaultValue) : "";
   const message = defaultStr ? `Enter ${name} [${defaultStr}]: ` : `Enter ${name}: `;
@@ -34,17 +21,6 @@ function defaultPrompt(name, defaultValue) {
     });
   });
 }
-async function defaultAskWhetherToSave(name, _value) {
-  const answer = await ask(`Save "${name}" for next time? (y/n): `);
-  const v = answer.toLowerCase();
-  return v === "y" || v === "yes" || v === "1" || v === "true";
-}
-async function defaultAskContext(name, contextNames) {
-  const hint = contextNames.length > 0 ? ` (${contextNames.join(", ")})` : "";
-  const answer = await ask(`Save "${name}" to which context?${hint}: `);
-  if (answer) return answer;
-  return contextNames[0] ?? "default";
-}
 
 // src/config.ts
 var LOG_LEVELS = ["none", "trace", "debug", "info", "warn", "error"];
@@ -55,7 +31,6 @@ var envKeyMap = {
   SCENV_PROMPT: "prompt",
   SCENV_IGNORE_ENV: "ignoreEnv",
   SCENV_IGNORE_CONTEXT: "ignoreContext",
-  SCENV_SAVE_PROMPT: "shouldSavePrompt",
   SCENV_SAVE_CONTEXT_TO: "saveContextTo",
   SCENV_CONTEXT_DIR: "contextDir",
   SCENV_LOG_LEVEL: "logLevel"
@@ -64,9 +39,7 @@ var programmaticConfig = {};
 var programmaticCallbacks = {};
 function getCallbacks() {
   return {
-    defaultPrompt: programmaticCallbacks.defaultPrompt ?? defaultPrompt,
-    onAskWhetherToSave: programmaticCallbacks.onAskWhetherToSave ?? defaultAskWhetherToSave,
-    onAskContext: programmaticCallbacks.onAskContext ?? defaultAskContext
+    defaultPrompt: programmaticCallbacks.defaultPrompt ?? defaultPrompt
   };
 }
 function findConfigDir(startDir) {
@@ -89,11 +62,9 @@ function configFromEnv() {
       out[configKey] = val.split(",").map((s) => s.trim()).filter(Boolean);
     } else if (configKey === "ignoreEnv" || configKey === "ignoreContext") {
       out[configKey] = val === "1" || val === "true" || val.toLowerCase() === "yes";
-    } else if (configKey === "prompt" || configKey === "shouldSavePrompt") {
+    } else if (configKey === "prompt") {
       const v = val.toLowerCase();
-      if (configKey === "prompt" && (v === "always" || v === "never" || v === "fallback" || v === "no-env"))
-        out[configKey] = v;
-      if (configKey === "shouldSavePrompt" && (v === "always" || v === "never" || v === "ask"))
+      if (v === "always" || v === "never" || v === "fallback" || v === "no-env")
         out[configKey] = v;
     } else if (configKey === "saveContextTo") {
       out.saveContextTo = val;
@@ -136,8 +107,6 @@ function loadConfigFile(configDir) {
       out.ignoreContext = parsed.ignoreContext;
     if (parsed.set && typeof parsed.set === "object" && !Array.isArray(parsed.set))
       out.set = parsed.set;
-    if (typeof (parsed.shouldSavePrompt ?? parsed.savePrompt) === "string" && ["always", "never", "ask"].includes(parsed.shouldSavePrompt ?? parsed.savePrompt))
-      out.shouldSavePrompt = parsed.shouldSavePrompt ?? parsed.savePrompt;
     if (typeof parsed.saveContextTo === "string")
       out.saveContextTo = parsed.saveContextTo;
     if (typeof parsed.contextDir === "string") out.contextDir = parsed.contextDir;
@@ -221,16 +190,41 @@ var configLoadedLogged = false;
 function resetLogState() {
   configLoadedLogged = false;
 }
+var CONFIG_LOG_KEYS = [
+  "root",
+  "context",
+  "prompt",
+  "ignoreEnv",
+  "ignoreContext",
+  "set",
+  "saveContextTo",
+  "contextDir",
+  "logLevel"
+];
+function configForLog(config) {
+  return Object.fromEntries(
+    CONFIG_LOG_KEYS.filter((k) => config[k] !== void 0).map((k) => [k, config[k]])
+  );
+}
 function logConfigLoaded(config) {
   if (configLoadedLogged) return;
-  if (getLevelNum() < LEVEL_NUM.info) return;
   configLoadedLogged = true;
-  log(
-    "info",
-    "config loaded",
-    "root=" + (config.root ?? "(cwd)"),
-    "context=" + JSON.stringify(config.context ?? [])
-  );
+  const levelNum = LEVEL_NUM[config.logLevel ?? "none"];
+  if (levelNum >= LEVEL_NUM.info) {
+    const parts = [
+      "root=" + (config.root ?? "(cwd)"),
+      "context=" + JSON.stringify(config.context ?? [])
+    ];
+    if (config.prompt !== void 0) parts.push("prompt=" + config.prompt);
+    if (config.ignoreEnv === true) parts.push("ignoreEnv=true");
+    if (config.ignoreContext === true) parts.push("ignoreContext=true");
+    if (config.saveContextTo !== void 0) parts.push("saveContextTo=" + config.saveContextTo);
+    if (config.contextDir !== void 0) parts.push("contextDir=" + config.contextDir);
+    log("info", "config loaded", parts.join(" "));
+  }
+  if (levelNum >= LEVEL_NUM.debug) {
+    log("debug", "config (full)", JSON.stringify(configForLog(config)));
+  }
 }
 function log(level, msg, ...args) {
   const configured = getLevelNum();
@@ -250,10 +244,21 @@ import {
   writeFileSync,
   mkdirSync,
   readdirSync,
-  statSync
+  statSync,
+  existsSync as existsSync2
 } from "fs";
-import { join as join2, dirname as dirname2, isAbsolute } from "path";
+import { join as join2, dirname as dirname2, isAbsolute, sep } from "path";
 var CONTEXT_SUFFIX = ".context.json";
+var inMemoryContext = {};
+function getInMemoryContext() {
+  return inMemoryContext;
+}
+function setInMemoryContext(key, value) {
+  inMemoryContext[key] = value;
+}
+function resetInMemoryContext() {
+  inMemoryContext = {};
+}
 function discoverContextPathsInternal(dir, found) {
   let entries;
   try {
@@ -321,6 +326,14 @@ function getMergedContextValues() {
   const root = config.root ?? process.cwd();
   const paths = discoverContextPaths(root);
   const out = {};
+  if (config.saveContextTo) {
+    const savePath = resolveSaveContextPath(config.saveContextTo);
+    const saveCtx = getContextAtPath(savePath);
+    for (const [k, v] of Object.entries(saveCtx)) out[k] = v;
+    if (Object.keys(saveCtx).length > 0) {
+      log("debug", `saveContextTo "${config.saveContextTo}" loaded keys=${JSON.stringify(Object.keys(saveCtx))}`);
+    }
+  }
   for (const contextName of config.context ?? []) {
     const filePath = paths.get(contextName);
     if (!filePath) {
@@ -348,6 +361,9 @@ function getMergedContextValues() {
   return out;
 }
 function getContextWritePath(contextName) {
+  if (isAbsolute(contextName) || contextName.includes(sep)) {
+    return contextName.endsWith(CONTEXT_SUFFIX) ? contextName : contextName + CONTEXT_SUFFIX;
+  }
   const config = loadConfig();
   const root = config.root ?? process.cwd();
   const paths = discoverContextPaths(root);
@@ -356,6 +372,26 @@ function getContextWritePath(contextName) {
   const saveDir = config.contextDir ? isAbsolute(config.contextDir) ? config.contextDir : join2(root, config.contextDir) : root;
   return join2(saveDir, `${contextName}${CONTEXT_SUFFIX}`);
 }
+function resolveSaveContextPath(nameOrPath) {
+  if (isAbsolute(nameOrPath) || nameOrPath.includes(sep)) {
+    return nameOrPath.endsWith(CONTEXT_SUFFIX) ? nameOrPath : nameOrPath + CONTEXT_SUFFIX;
+  }
+  return getContextWritePath(nameOrPath);
+}
+function getContextAtPath(filePath) {
+  if (!existsSync2(filePath)) return {};
+  try {
+    const raw = readFileSync2(filePath, "utf-8");
+    const data = JSON.parse(raw);
+    const out = {};
+    for (const [k, v] of Object.entries(data)) {
+      if (typeof v === "string") out[k] = v;
+    }
+    return out;
+  } catch {
+    return {};
+  }
+}
 function writeToContext(contextName, key, value) {
   const path = getContextWritePath(contextName);
   let data = {};
@@ -452,6 +488,12 @@ function scenv(name, options = {}) {
         return { raw, source: "env" };
       }
     }
+    const mem = getInMemoryContext();
+    if (mem[key] !== void 0) {
+      log("trace", `resolveRaw: in-memory hit key=${key}`);
+      const raw = resolveContextReference(mem[key], key);
+      return { raw, source: "context" };
+    }
     if (!config.ignoreContext) {
       log("trace", "resolveRaw: checking context");
       const ctx = getMergedContextValues();
@@ -537,36 +579,11 @@ function scenv(name, options = {}) {
     const final = validated.data;
     if (wasPrompted) {
       const config = loadConfig();
-      const mode = config.shouldSavePrompt ?? (config.prompt === "never" ? "never" : "ask");
-      if (mode === "never") return final;
-      let doSave;
-      if (mode === "ask") {
-        const callbacks2 = getCallbacks();
-        if (typeof callbacks2.onAskWhetherToSave !== "function") {
-          throw new Error(
-            `shouldSavePrompt is "ask" but onAskWhetherToSave callback is not set. Configure callbacks via configure({ callbacks: { onAskWhetherToSave: ... } }).`
-          );
-        }
-        doSave = await callbacks2.onAskWhetherToSave(name, final);
-      } else {
-        doSave = true;
+      setInMemoryContext(key, String(final));
+      if (config.saveContextTo) {
+        writeToContext(config.saveContextTo, key, String(final));
+        log("info", `Saved key=${key} to saveContextTo ${config.saveContextTo}`);
       }
-      if (!doSave) return final;
-      const callbacks = getCallbacks();
-      const contextNames = config.context ?? [];
-      let ctxToSave;
-      if (config.saveContextTo === "ask") {
-        if (typeof callbacks.onAskContext !== "function") {
-          throw new Error(
-            `saveContextTo is "ask" but onAskContext callback is not set. Configure callbacks via configure({ callbacks: { onAskContext: ... } }).`
-          );
-        }
-        ctxToSave = await callbacks.onAskContext(name, contextNames);
-      } else {
-        ctxToSave = config.saveContextTo ?? contextNames[0] ?? "default";
-      }
-      writeToContext(ctxToSave, key, String(final));
-      log("info", `Saved key=${key} to context ${ctxToSave}`);
     }
     return final;
   }
@@ -587,22 +604,11 @@ function scenv(name, options = {}) {
       throw new Error(errMsg);
     }
     const config = loadConfig();
-    let contextName = config.saveContextTo;
-    if (contextName === "ask") {
-      const callbacks = getCallbacks();
-      if (typeof callbacks.onAskContext !== "function") {
-        throw new Error(
-          `saveContextTo is "ask" but onAskContext callback is not set. Configure callbacks via configure({ callbacks: { onAskContext: ... } }).`
-        );
-      }
-      contextName = await callbacks.onAskContext(
-        name,
-        config.context ?? []
-      );
+    setInMemoryContext(key, String(validated.data));
+    if (config.saveContextTo) {
+      writeToContext(config.saveContextTo, key, String(validated.data));
+      log("info", `Saved key=${key} to saveContextTo ${config.saveContextTo}`);
     }
-    if (!contextName) contextName = config.context?.[0] ?? "default";
-    writeToContext(contextName, key, String(validated.data));
-    log("info", `Saved key=${key} to context ${contextName}`);
   }
   return { get, safeGet, save };
 }
@@ -633,11 +639,6 @@ function parseScenvArgs(argv) {
         config.set = config.set ?? {};
         config.set[pair.slice(0, eq).trim()] = pair.slice(eq + 1).trim();
       }
-    } else if (arg === "--save-prompt" && argv[i + 1] !== void 0) {
-      const v = argv[++i].toLowerCase();
-      if (["always", "never", "ask"].includes(v)) {
-        config.shouldSavePrompt = v;
-      }
     } else if (arg === "--save-context-to" && argv[i + 1] !== void 0) {
       config.saveContextTo = argv[++i];
     } else if (arg === "--context-dir" && argv[i + 1] !== void 0) {
@@ -670,10 +671,14 @@ export {
   discoverContextPaths,
   getCallbacks,
   getContext,
+  getContextWritePath,
+  getInMemoryContext,
   getMergedContextValues,
   loadConfig,
   parseScenvArgs,
   resetConfig,
+  resetInMemoryContext,
   resetLogState,
-  scenv
+  scenv,
+  setInMemoryContext
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scenv",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Environment and context variables with runtime-configurable resolution",
   "repository": {
     "type": "git",