neotoma 0.3.0 → 0.3.2

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

@@ -2872,7 +2872,8 @@ async function runSessionLoop(opts) {
             return;
         }
         const args = parseSessionLine(trimmed);
-        opts?.lastDetailOutputRef && (opts.lastDetailOutputRef.current = null);
+        if (opts?.lastDetailOutputRef)
+            opts.lastDetailOutputRef.current = null;
         const argv = [process.argv[0], process.argv[1], ...args];
         process.stdout.write("\n");
         try {
@@ -3074,8 +3075,10 @@ program
         let envPath = envRepoRoot ? path.join(envRepoRoot, ".env") : null;
         const mcpTokenEncryptionKey = randomBytes(32).toString("hex");
         let envContent = ""; // built after plan with final dataDir
-        // When not in a repo, optionally prompt for repo path so we can create .env there
-        if (!envRepoRoot && process.stdout.isTTY && !opts.skipEnv && useAdvancedPrompts) {
+        // When not in a repo, prompt for repo path so we can create .env there.
+        // This runs in normal interactive init too (not only --advanced) so
+        // .env setup is not skipped just because init was started outside a repo.
+        if (!envRepoRoot && process.stdout.isTTY && !opts.skipEnv && !opts.yes) {
             process.stdout.write(nl() + bullet(heading("Neotoma repo path")) + nl());
             const raw = await askQuestion("Repo path [default: skip]: ");
             const trimmed = raw.trim().replace(/^~(?=\/|$)/, process.env.HOME || "");
@@ -3881,6 +3884,24 @@ NEOTOMA_MCP_TOKEN_ENCRYPTION_KEY=${mcpTokenEncryptionKey}
             };
             await writeConfig(nextConfig);
         }
+        // If repo root was discovered late (after env setup phase), still ensure
+        // .env exists so init behavior is consistent regardless of launch directory.
+        if (!opts.skipEnv && !envRepoRoot && configRepoRoot) {
+            const lateEnvPath = path.join(configRepoRoot, ".env");
+            const lateEnvExamplePath = path.join(configRepoRoot, ".env.example");
+            if (!(await pathExists(lateEnvPath))) {
+                if (await pathExists(lateEnvExamplePath)) {
+                    await fs.copyFile(lateEnvExamplePath, lateEnvPath);
+                }
+                else {
+                    await fs.writeFile(lateEnvPath, "");
+                }
+                if (outputMode === "pretty") {
+                    process.stdout.write(bullet(success(".env created after repo path was provided.")) + "\n");
+                    process.stdout.write(bullet(dim("Path: ") + pathStyle(lateEnvPath)) + "\n");
+                }
+            }
+        }
         process.stdout.write(nl());
         if (temporaryApiForInit) {
             await stopTemporaryApiForInit(temporaryApiForInit.child);
@@ -3900,6 +3921,117 @@ NEOTOMA_MCP_TOKEN_ENCRYPTION_KEY=${mcpTokenEncryptionKey}
         throw err;
     }
 });
+// ── Site configure (Google Analytics and env vars) ─────────────────────────
+const siteCommand = program
+    .command("site")
+    .description("Site and frontend configuration");
+siteCommand
+    .command("configure")
+    .description("Configure site env vars: Google Analytics (VITE_GA_MEASUREMENT_ID) and optional Google API credentials")
+    .option("--ga-measurement-id <id>", "GA4 measurement ID (e.g. G-XXXXXXXXXX)")
+    .option("--google-application-credentials <path>", "Path to Google application credentials JSON (server-side APIs)")
+    .option("--google-oauth-credentials <path>", "Path to Google OAuth credentials file or directory (e.g. .creds)")
+    .action(async (opts) => {
+    const outputMode = resolveOutputMode();
+    let repoRoot = null;
+    try {
+        const config = await readConfig();
+        if (config.repo_root)
+            repoRoot = await validateNeotomaRepo(config.repo_root);
+        if (!repoRoot && process.env.NEOTOMA_REPO_ROOT) {
+            repoRoot = await validateNeotomaRepo(process.env.NEOTOMA_REPO_ROOT);
+        }
+        if (!repoRoot)
+            repoRoot = await findRepoRoot(process.cwd());
+    }
+    catch {
+        // leave null
+    }
+    if (!repoRoot) {
+        process.stderr.write("Not a Neotoma repo. Run from the repo root or run " +
+            pathStyle("neotoma init") +
+            " first.\n");
+        process.exitCode = 1;
+        return;
+    }
+    const envPath = path.join(repoRoot, ".env");
+    const envExamplePath = path.join(repoRoot, ".env.example");
+    if (!(await pathExists(envPath))) {
+        if (await pathExists(envExamplePath)) {
+            await fs.copyFile(envExamplePath, envPath);
+            if (outputMode === "pretty") {
+                process.stdout.write(bullet(success("Created .env from .env.example")) + "\n");
+            }
+        }
+        else {
+            await fs.writeFile(envPath, "");
+            if (outputMode === "pretty") {
+                process.stdout.write(bullet(success("Created empty .env")) + "\n");
+            }
+        }
+    }
+    let gaId = opts.gaMeasurementId?.trim();
+    let googleAppCreds = opts.googleApplicationCredentials?.trim();
+    let googleOauthCreds = opts.googleOauthCredentials?.trim();
+    if (process.stdout.isTTY && outputMode === "pretty") {
+        if (gaId === undefined || gaId === "") {
+            const raw = await askQuestion("VITE_GA_MEASUREMENT_ID (GA4 measurement ID, e.g. G-XXXXXXXXXX) [optional, Enter to skip]: ");
+            gaId = raw.trim();
+        }
+        if (googleAppCreds === undefined || googleAppCreds === "") {
+            const raw = await askQuestion("GOOGLE_APPLICATION_CREDENTIALS (path to service account JSON) [optional, Enter to skip]: ");
+            googleAppCreds = raw.trim();
+        }
+        if (googleOauthCreds === undefined || googleOauthCreds === "") {
+            const raw = await askQuestion("GOOGLE_OAUTH_CREDENTIALS (path, e.g. .creds) [optional, Enter to skip]: ");
+            googleOauthCreds = raw.trim();
+        }
+    }
+    const updated = [];
+    // Apply when option was explicitly passed (including empty) or user entered non-empty at prompt
+    if (opts.gaMeasurementId !== undefined) {
+        await updateOrInsertEnvVar(envPath, "VITE_GA_MEASUREMENT_ID", opts.gaMeasurementId.trim());
+        updated.push("VITE_GA_MEASUREMENT_ID");
+    }
+    else if (gaId !== undefined && gaId !== "") {
+        await updateOrInsertEnvVar(envPath, "VITE_GA_MEASUREMENT_ID", gaId);
+        updated.push("VITE_GA_MEASUREMENT_ID");
+    }
+    if (opts.googleApplicationCredentials !== undefined) {
+        await updateOrInsertEnvVar(envPath, "GOOGLE_APPLICATION_CREDENTIALS", opts.googleApplicationCredentials.trim());
+        updated.push("GOOGLE_APPLICATION_CREDENTIALS");
+    }
+    else if (googleAppCreds !== undefined && googleAppCreds !== "") {
+        await updateOrInsertEnvVar(envPath, "GOOGLE_APPLICATION_CREDENTIALS", googleAppCreds);
+        updated.push("GOOGLE_APPLICATION_CREDENTIALS");
+    }
+    if (opts.googleOauthCredentials !== undefined) {
+        await updateOrInsertEnvVar(envPath, "GOOGLE_OAUTH_CREDENTIALS", opts.googleOauthCredentials.trim());
+        updated.push("GOOGLE_OAUTH_CREDENTIALS");
+    }
+    else if (googleOauthCreds !== undefined && googleOauthCreds !== "") {
+        await updateOrInsertEnvVar(envPath, "GOOGLE_OAUTH_CREDENTIALS", googleOauthCreds);
+        updated.push("GOOGLE_OAUTH_CREDENTIALS");
+    }
+    if (outputMode === "json") {
+        writeOutput({ env_file: envPath, updated_vars: updated }, outputMode);
+        return;
+    }
+    if (updated.length > 0) {
+        process.stdout.write(heading("Site env vars updated") + "\n");
+        process.stdout.write(keyValue("env_file", envPath, true) + "\n");
+        process.stdout.write(bullet("Set or updated: " + updated.join(", ")) + "\n");
+    }
+    else {
+        process.stdout.write(dim("No values provided. Use options or run interactively to set vars.") + "\n");
+        process.stdout.write(dim("  ") +
+            pathStyle("neotoma site configure --ga-measurement-id G-XXXXXXXXXX") +
+            "\n");
+        process.stdout.write(dim("  ") +
+            pathStyle("neotoma site configure --google-application-credentials '' --google-oauth-credentials .creds") +
+            "\n");
+    }
+});
 let resetCompletionPrinted = false;
 program
     .command("reset")
@@ -4067,7 +4199,7 @@ const authLoginCommand = authCommand
             }
             baseUrl = url;
         }
-        catch (err) {
+        catch {
             const msg = "No tunnel URL found. Start the API with a tunnel first: neotoma api start --env dev --tunnel";
             if (outputMode === "json") {
                 writeOutput({ ok: false, error: msg, tunnel_url_file: urlFile }, outputMode);
@@ -8555,11 +8687,17 @@ export function buildInstallationBoxLines(mcpConfigs, cliScan, initContext, repo
     const hasPath = (value) => mcpConfigs.some((config) => config.path.toLowerCase().includes(value));
     const hasAnyMcpForPlatform = (value) => mcpConfigs.some((config) => config.path.toLowerCase().includes(value) && (config.hasDev || config.hasProd));
     const lines = [""];
+    // Always show env config status (repo and .env), whether successful or not.
     if (initContext != null) {
         lines.push("Data directory  " + mark(initContext.dataDirExists) + "  " + (initContext.dataDir ?? ""));
         lines.push(".env file       " + mark(initContext.envFileExists) + "  " + (initContext.envFilePath ?? ""));
         lines.push("");
     }
+    else {
+        lines.push("Repo path      " + mark(false) + "  Not configured (run " + pathStyle("neotoma init") + " or set NEOTOMA_REPO_ROOT)");
+        lines.push(".env file      " + mark(false) + "  (set repo path first)");
+        lines.push("");
+    }
     const mcpByPlatform = getMcpStatusByPlatform(mcpConfigs, repoRoot ?? null);
     const cliByPlatform = cliScan == null
         ? { Claude: false, Codex: false, Cursor: false }
@@ -9010,7 +9148,22 @@ export async function runCli(argv = process.argv) {
             argv.includes("--version") ||
             argv.includes("-V");
         if (!process.stdout.isTTY && !wantsHelpOrVersion) {
-            process.stderr.write("No command given. Run neotoma <command> (e.g. neotoma entities list). Use neotoma --help for options.\n");
+            const repoRoot = await resolveAndPersistRepoRootFromInitContext();
+            const guidanceLines = [];
+            if (!repoRoot) {
+                guidanceLines.push("Neotoma repo is not configured in this shell.", "Run 'neotoma init' to set repo path, or set NEOTOMA_REPO_ROOT to your Neotoma repo.");
+            }
+            else {
+                const envPath = path.join(repoRoot, ".env");
+                if (!(await pathExists(envPath))) {
+                    guidanceLines.push("Neotoma repo is configured, but .env is missing.", "Run 'neotoma init' to create .env defaults, or create " +
+                        pathStyle(envPath) +
+                        " manually.");
+                }
+            }
+            const guidance = guidanceLines.length > 0 ? "\n" + guidanceLines.join("\n") + "\n" : "";
+            process.stderr.write("No command given. Run neotoma <command> (e.g. neotoma entities list). Use neotoma --help for options.\n" +
+                guidance);
             process.exitCode = 1;
             return;
         }