neotoma 0.3.8 → 0.3.9

package/dist/cli/index.d.ts

@@ -82,6 +82,11 @@ export type InitContextStatus = {
 };
 /** Resolve data dir and .env status for init box for project/user env targets. */
 export declare function getInitContextStatus(repoRoot: string | null): Promise<InitContextStatus | null>;
+/**
+ * Treat init as satisfied if either project-scoped or user-scoped context is ready.
+ * This avoids false negatives when one scope is configured and the other is not.
+ */
+export declare function hasAnyInitializedContext(repoRoot: string | null): Promise<boolean>;
 export declare function buildInstallationBoxLines(mcpConfigs: McpConfigStatus[], cliScan: CliInstructionScanSummary | null, initContext?: InitContextStatus | null, repoRoot?: string | null): string[];
 type IntroBoxContent = {
     lines: string[];

package/dist/cli/index.d.ts.map

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

package/dist/cli/index.js

@@ -3313,8 +3313,9 @@ const initCommand = program
     .option("--force", "Overwrite existing configuration")
     .option("--skip-db", "Skip database initialization")
     .option("--skip-env", "Skip interactive .env creation and variable prompts")
-    .option("-y, --yes", "Apply the default init plan without prompts")
-    .option("--advanced", "Use personalization mode (step-by-step setup prompts, including optional source path prompts)")
+    .option("-y, --yes", "Apply the default init plan without prompts (default behavior)")
+    .option("--interactive", "Enable interactive setup prompts (plan review + personalization prompts)")
+    .option("--advanced", "Alias for --interactive (step-by-step setup prompts, including optional source path prompts)")
     .option("--auth-mode <mode>", "Auth setup mode: dev_local, oauth, or key_derived (non-interactive shortcut)")
     .option("--scope <scope>", "Configuration scope: user, project, both, or skip (applies to MCP + CLI updates)")
     .option("--configure-mcp <choice>", "Configure MCP entries: yes/no (skip corresponding prompt when provided)")
@@ -3328,7 +3329,9 @@ const initCommand = program
     .action(async (opts) => {
     try {
         const outputMode = resolveOutputMode();
-        let useAdvancedPrompts = Boolean(opts.advanced);
+        const interactiveRequested = Boolean(opts.interactive || opts.advanced);
+        let useAdvancedPrompts = interactiveRequested;
+        const applyDefaultsWithoutPrompts = Boolean(opts.yes || !interactiveRequested);
         const authModeFromFlag = normalizeInitAuthMode(opts.authMode);
         if (opts.authMode && (!authModeFromFlag || authModeFromFlag === "skip")) {
             throw new Error("Invalid --auth-mode. Use dev_local, oauth, or key_derived.");
@@ -3402,7 +3405,7 @@ const initCommand = program
         // If user explicitly provides --data-dir or a personalized path, sync .env to that value.
         let forceSyncDataDirToEnv = Boolean(opts.dataDir?.trim());
         const shouldOfferPackageTargetPrompt = process.stdout.isTTY &&
-            !opts.yes &&
+            !applyDefaultsWithoutPrompts &&
             useCurrentDirTargetsFromFlag == null &&
             (repoRoot == null || repoRootSource === "config");
         if (shouldOfferPackageTargetPrompt) {
@@ -3458,14 +3461,19 @@ const initCommand = program
             const alreadyInitializedMessage = "Neotoma is already initialized at " +
                 pathStyle(detectedInitializedDataDir) +
                 ". Run init again?";
-            if (process.stdout.isTTY && outputMode === "pretty" && !opts.yes) {
+            const alreadyInitializedContinueMessage = "Neotoma is already initialized at " +
+                pathStyle(detectedInitializedDataDir) +
+                ". Continuing with init (non-interactive mode).";
+            if (process.stdout.isTTY &&
+                outputMode === "pretty" &&
+                !applyDefaultsWithoutPrompts) {
                 const shouldContinue = await askYesNo(`${alreadyInitializedMessage} [y/N]: `);
                 if (!shouldContinue) {
                     throw new InitAbortError();
                 }
             }
             else if (process.stdout.isTTY && outputMode === "pretty") {
-                process.stdout.write(bullet(dim(alreadyInitializedMessage + " Continuing.")) + "\n");
+                process.stdout.write(bullet(dim(alreadyInitializedContinueMessage)) + "\n");
             }
         }
         if (process.stdout.isTTY && useAdvancedPrompts) {
@@ -3656,7 +3664,10 @@ const initCommand = program
         let personalizedAuthMode = null;
         let earlyOpenAiPrompted = false;
         let earlyOpenAiInput = "";
-        if (outputMode === "pretty" && process.stdout.isTTY && !opts.yes && !useAdvancedPrompts) {
+        if (outputMode === "pretty" &&
+            process.stdout.isTTY &&
+            !applyDefaultsWithoutPrompts &&
+            !useAdvancedPrompts) {
             const configuredAuth = await detectConfiguredAuthMode(envPath);
             const envExists = envPath ? await pathExists(envPath) : false;
             const plannedAuthMode = authModeFromFlag ?? configuredAuth?.mode ?? defaultInitAuthMode;
@@ -3957,7 +3968,12 @@ const initCommand = program
                 }
             }
         }
-        if (!useAdvancedPrompts && !opts.skipEnv && envPath && outputMode === "pretty" && process.stdout.isTTY) {
+        if (interactiveRequested &&
+            !useAdvancedPrompts &&
+            !opts.skipEnv &&
+            envPath &&
+            outputMode === "pretty" &&
+            process.stdout.isTTY) {
             let existingOpenAi = (process.env.OPENAI_API_KEY ?? "").trim();
             if (!existingOpenAi) {
                 try {
@@ -4275,7 +4291,7 @@ NEOTOMA_MCP_TOKEN_ENCRYPTION_KEY=${mcpTokenEncryptionKey}
             else if (initAuthSummary.mode === "key_derived") {
                 process.stdout.write(nl());
                 const resolvedKeySource = keySourceFromFlag ??
-                    (opts.yes ? "skip" : normalizeInitKeySource(await askQuestion("Create new key [1] or path to existing key [2] [default: 1]: ")) ??
+                    (applyDefaultsWithoutPrompts ? "skip" : normalizeInitKeySource(await askQuestion("Create new key [1] or path to existing key [2] [default: 1]: ")) ??
                         "create");
                 if (resolvedKeySource === "create") {
                     const keysDir = path.join(CONFIG_DIR, "keys");
@@ -4403,7 +4419,7 @@ NEOTOMA_MCP_TOKEN_ENCRYPTION_KEY=${mcpTokenEncryptionKey}
             const reason = opts.skipEnv ? "--skip-env" : "no env target";
             setInitProgress("env", "skipped", reason);
         }
-        else if (process.stdout.isTTY) {
+        else {
             setInitProgress("env", "in_progress");
             suspendLiveProgress();
             const envPathStr = envPath;
@@ -4476,7 +4492,7 @@ NEOTOMA_MCP_TOKEN_ENCRYPTION_KEY=${mcpTokenEncryptionKey}
             if (openAiSet) {
                 envOpenAiOutcome = "already_set";
             }
-            const shouldPromptOpenAi = !opts.yes && outputMode === "pretty" && process.stdout.isTTY;
+            const shouldPromptOpenAi = interactiveRequested && outputMode === "pretty" && process.stdout.isTTY;
             if (!openAiSet && openAiKeyFromFlag) {
                 let envText;
                 try {
@@ -4620,9 +4636,6 @@ NEOTOMA_MCP_TOKEN_ENCRYPTION_KEY=${mcpTokenEncryptionKey}
             setInitProgress("env", "done", envDetailParts.join(", "));
             setInitProgressSummaryLines("env", envSummaryLines);
         }
-        else {
-            setInitProgress("env", "skipped", "non-interactive output");
-        }
         if (keyPath) {
             suspendLiveProgress();
             process.stdout.write(nl() + heading("Encryption enabled") + nl());
@@ -5019,6 +5032,21 @@ NEOTOMA_MCP_TOKEN_ENCRYPTION_KEY=${mcpTokenEncryptionKey}
         }
         process.stdout.write(nl() + heading("✓ Neotoma initialized!") + nl());
         process.stdout.write("Run " + pathStyle("neotoma") + " to start a session." + nl());
+        if (outputMode === "pretty") {
+            process.stdout.write(nl() + heading("Additional configuration options") + nl());
+            process.stdout.write(bullet("Interactive setup walkthrough: " + pathStyle("neotoma init --interactive")) + "\n");
+            process.stdout.write(bullet("Set OpenAI key later: " +
+                pathStyle("neotoma init --yes --skip-db --openai-api-key <key>")) + "\n");
+            process.stdout.write(bullet("Check/update MCP config: " + pathStyle("neotoma mcp check")) + "\n");
+            process.stdout.write(bullet("Refresh CLI instructions: " + pathStyle("neotoma cli-instructions check")) + "\n");
+            process.stdout.write(bullet("API status: " + pathStyle("neotoma api status")) + "\n");
+            process.stdout.write(bullet("Start API server: " + pathStyle("neotoma api start --env dev --background")) + "\n");
+            process.stdout.write(bullet("View API logs: " + pathStyle("neotoma api logs --env dev --follow")) + "\n");
+            process.stdout.write(bullet("Authentication status/login: " +
+                pathStyle("neotoma auth status") +
+                " / " +
+                pathStyle("neotoma auth login")) + "\n");
+        }
         // Release stdin after interactive prompts so Node can exit immediately.
         process.stdin.pause();
         await new Promise((resolve) => process.stdout.write("", () => resolve()));
@@ -5160,9 +5188,12 @@ let resetCompletionPrinted = false;
 program
     .command("reset")
     .description("Reset local Neotoma to a clean slate: back up and remove local Neotoma state, clean MCP/config instructions, and attempt global npm uninstall only when run from within a Neotoma repo (never back up/remove data dir configured via NEOTOMA_DATA_DIR in .env)")
-    .option("-y, --yes", "Skip confirmation prompt")
+    .option("-y, --yes", "Skip confirmation prompt (default behavior)")
+    .option("--interactive", "Enable confirmation prompt before reset")
     .action(async (opts) => {
     const outputMode = resolveOutputMode();
+    const interactiveRequested = Boolean(opts.interactive);
+    const applyDefaultsWithoutPrompts = Boolean(opts.yes || !interactiveRequested);
     const { repoRoot } = await resolveRepoRootFromInitContext();
     const ts = backupTimestamp();
     const homeDir = process.env.HOME || process.env.USERPROFILE || os.homedir();
@@ -5208,7 +5239,7 @@ program
         mcpConfigTargets.add(path.join(repoRoot, ".mcp.json"));
         mcpConfigTargets.add(path.join(repoRoot, ".codex", "config.toml"));
     }
-    if (process.stdout.isTTY && !opts.yes && outputMode !== "json") {
+    if (process.stdout.isTTY && !applyDefaultsWithoutPrompts && outputMode !== "json") {
         process.stdout.write(heading("Neotoma reset") + nl() + nl());
         process.stdout.write("This will:" + nl());
         process.stdout.write(bullet("Back up and remove local Neotoma state (config, env, keys, instructions, and data directories).") + nl());
@@ -9985,6 +10016,18 @@ export async function getInitContextStatus(repoRoot) {
     const dataDirExists = await pathExists(dataDir);
     return { dataDirExists, envFileExists, dataDir, envFilePath: envPath, envTarget };
 }
+/**
+ * Treat init as satisfied if either project-scoped or user-scoped context is ready.
+ * This avoids false negatives when one scope is configured and the other is not.
+ */
+export async function hasAnyInitializedContext(repoRoot) {
+    const projectContext = await getInitContextStatus(repoRoot);
+    if (projectContext?.envFileExists && projectContext.dataDirExists) {
+        return true;
+    }
+    const userContext = await getInitContextStatus(null);
+    return Boolean(userContext?.envFileExists && userContext.dataDirExists);
+}
 export function buildInstallationBoxLines(mcpConfigs, cliScan, initContext, repoRoot) {
     const mark = (ok) => (ok ? "✅" : "❌");
     const hasPath = (value) => mcpConfigs.some((config) => config.path.toLowerCase().includes(value));
@@ -10464,8 +10507,8 @@ export async function runCli(argv = process.argv) {
         // For plain `neotoma` startup, require init before rendering any status boxes or prompts.
         if (noArgs && !isInitCommand && !isResetCommand) {
             const { repoRoot } = await resolveRepoRootFromInitContext();
-            const initContext = await getInitContextStatus(repoRoot);
-            if (!initContext?.envFileExists || !initContext.dataDirExists) {
+            const hasInitializedContext = await hasAnyInitializedContext(repoRoot);
+            if (!hasInitializedContext) {
                 process.stderr.write(NO_ARGS_INIT_REQUIRED_MESSAGE + "\n");
                 process.exitCode = 1;
                 return;