@mastra/code-sdk 1.0.3-alpha.1 → 1.1.0-alpha.2

package/dist/utils/project.js

@@ -1,302 +1,364 @@
-import { execFile, execSync } from "node:child_process";
-import { createHash } from "node:crypto";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
 import { DEFAULT_CONFIG_DIR } from "../constants.js";
+import { createHash } from "crypto";
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { execFile, execSync } from "child_process";
+//#region src/utils/project.ts
+/**
+* Project detection utilities
+*
+* Detects project identity from git repo or filesystem path.
+* Handles git worktrees by finding the main repository.
+*/
+/**
+* Run a git command and return stdout, or undefined if it fails
+*/
 function git(args, cwd) {
-  try {
-    return execSync(`git ${args}`, {
-      cwd,
-      encoding: "utf-8",
-      stdio: ["pipe", "pipe", "pipe"]
-    }).trim();
-  } catch {
-    return void 0;
-  }
+	try {
+		return execSync(`git ${args}`, {
+			cwd,
+			encoding: "utf-8",
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			]
+		}).trim();
+	} catch {
+		return;
+	}
 }
+/**
+* Slugify a string for use in IDs
+*/
 function slugify(str) {
-  return str.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+	return str.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
 }
+/**
+* Create a short hash of a string
+*/
 function shortHash(str) {
-  return createHash("sha256").update(str).digest("hex").slice(0, 12);
+	return createHash("sha256").update(str).digest("hex").slice(0, 12);
 }
+/**
+* Normalize a git URL to a canonical form for comparison
+* - Removes .git suffix
+* - Converts SSH to HTTPS format for consistency
+* - Lowercases
+*/
 function normalizeGitUrl(url) {
-  return url.replace(/\.git$/, "").replace(/^git@([^:]+):/, "https://$1/").replace(/^ssh:\/\/git@/, "https://").toLowerCase();
+	return url.replace(/\.git$/, "").replace(/^git@([^:]+):/, "https://$1/").replace(/^ssh:\/\/git@/, "https://").toLowerCase();
 }
+/**
+* Detect project info from a directory path
+*/
 function detectProject(projectPath) {
-  const absolutePath = path.resolve(projectPath);
-  const gitDir = git("rev-parse --git-dir", absolutePath);
-  const isGitRepo = gitDir !== void 0;
-  let rootPath = absolutePath;
-  let gitUrl;
-  let gitBranch;
-  let isWorktree = false;
-  let mainRepoPath;
-  if (isGitRepo) {
-    rootPath = git("rev-parse --show-toplevel", absolutePath) || absolutePath;
-    const commonDir = git("rev-parse --git-common-dir", absolutePath);
-    if (commonDir && commonDir !== ".git" && commonDir !== gitDir) {
-      isWorktree = true;
-      mainRepoPath = path.dirname(path.resolve(rootPath, commonDir));
-    }
-    gitUrl = git("remote get-url origin", absolutePath);
-    if (!gitUrl) {
-      const remotes = git("remote", absolutePath);
-      if (remotes) {
-        const firstRemote = remotes.split("\n")[0];
-        if (firstRemote) {
-          gitUrl = git(`remote get-url ${firstRemote}`, absolutePath);
-        }
-      }
-    }
-    gitBranch = git("rev-parse --abbrev-ref HEAD", absolutePath);
-  }
-  let resourceIdSource;
-  if (gitUrl) {
-    resourceIdSource = normalizeGitUrl(gitUrl);
-  } else if (mainRepoPath) {
-    resourceIdSource = mainRepoPath;
-  } else {
-    resourceIdSource = rootPath;
-  }
-  const baseName = gitUrl ? gitUrl.split("/").pop()?.replace(/\.git$/, "") || "project" : path.basename(rootPath);
-  const resourceId = `${slugify(baseName)}-${shortHash(resourceIdSource)}`;
-  return {
-    resourceId,
-    name: baseName,
-    rootPath,
-    gitUrl,
-    gitBranch,
-    isWorktree,
-    mainRepoPath
-  };
+	const absolutePath = path.resolve(projectPath);
+	const gitDir = git("rev-parse --git-dir", absolutePath);
+	const isGitRepo = gitDir !== void 0;
+	let rootPath = absolutePath;
+	let gitUrl;
+	let gitBranch;
+	let isWorktree = false;
+	let mainRepoPath;
+	if (isGitRepo) {
+		rootPath = git("rev-parse --show-toplevel", absolutePath) || absolutePath;
+		const commonDir = git("rev-parse --git-common-dir", absolutePath);
+		if (commonDir && commonDir !== ".git" && commonDir !== gitDir) {
+			isWorktree = true;
+			mainRepoPath = path.dirname(path.resolve(rootPath, commonDir));
+		}
+		gitUrl = git("remote get-url origin", absolutePath);
+		if (!gitUrl) {
+			const remotes = git("remote", absolutePath);
+			if (remotes) {
+				const firstRemote = remotes.split("\n")[0];
+				if (firstRemote) gitUrl = git(`remote get-url ${firstRemote}`, absolutePath);
+			}
+		}
+		gitBranch = git("rev-parse --abbrev-ref HEAD", absolutePath);
+	}
+	let resourceIdSource;
+	if (gitUrl) resourceIdSource = normalizeGitUrl(gitUrl);
+	else if (mainRepoPath) resourceIdSource = mainRepoPath;
+	else resourceIdSource = rootPath;
+	const baseName = gitUrl ? gitUrl.split("/").pop()?.replace(/\.git$/, "") || "project" : path.basename(rootPath);
+	return {
+		resourceId: `${slugify(baseName)}-${shortHash(resourceIdSource)}`,
+		name: baseName,
+		rootPath,
+		gitUrl,
+		gitBranch,
+		isWorktree,
+		mainRepoPath
+	};
 }
+/**
+* Get the current git branch for a given directory.
+* Lightweight alternative to detectProject() for refreshing just the branch.
+*/
 function getCurrentGitBranch(cwd) {
-  return git("rev-parse --abbrev-ref HEAD", cwd);
+	return git("rev-parse --abbrev-ref HEAD", cwd);
 }
+/**
+* Async version of getCurrentGitBranch — avoids blocking the event loop
+* with execSync.  Falls back to undefined on any failure.
+*/
 function getCurrentGitBranchAsync(cwd) {
-  return new Promise((resolve) => {
-    execFile("git", ["rev-parse", "--abbrev-ref", "HEAD"], { cwd, encoding: "utf-8" }, (err, stdout) => {
-      if (err) {
-        resolve(void 0);
-        return;
-      }
-      const branch = stdout.trim();
-      resolve(branch || void 0);
-    });
-  });
+	return new Promise((resolve) => {
+		execFile("git", [
+			"rev-parse",
+			"--abbrev-ref",
+			"HEAD"
+		], {
+			cwd,
+			encoding: "utf-8"
+		}, (err, stdout) => {
+			if (err) {
+				resolve(void 0);
+				return;
+			}
+			resolve(stdout.trim() || void 0);
+		});
+	});
 }
+/**
+* Get the application data directory for mastracode
+* - macOS: ~/Library/Application Support/mastracode
+* - Linux: ~/.local/share/mastracode
+* - Windows: %APPDATA%/mastracode
+*/
 function getAppDataDir() {
-  if (process.env.MASTRA_APP_DATA_DIR) {
-    fs.mkdirSync(process.env.MASTRA_APP_DATA_DIR, { recursive: true });
-    return process.env.MASTRA_APP_DATA_DIR;
-  }
-  const platform = os.platform();
-  let baseDir;
-  if (platform === "darwin") {
-    baseDir = path.join(os.homedir(), "Library", "Application Support");
-  } else if (platform === "win32") {
-    baseDir = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
-  } else {
-    baseDir = process.env.XDG_DATA_HOME || path.join(os.homedir(), ".local", "share");
-  }
-  const appDir = path.join(baseDir, "mastracode");
-  if (!fs.existsSync(appDir)) {
-    fs.mkdirSync(appDir, { recursive: true });
-  }
-  return appDir;
+	if (process.env.MASTRA_APP_DATA_DIR) {
+		fs.mkdirSync(process.env.MASTRA_APP_DATA_DIR, { recursive: true });
+		return process.env.MASTRA_APP_DATA_DIR;
+	}
+	const platform = os.platform();
+	let baseDir;
+	if (platform === "darwin") baseDir = path.join(os.homedir(), "Library", "Application Support");
+	else if (platform === "win32") baseDir = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
+	else baseDir = process.env.XDG_DATA_HOME || path.join(os.homedir(), ".local", "share");
+	const appDir = path.join(baseDir, "mastracode");
+	if (!fs.existsSync(appDir)) fs.mkdirSync(appDir, { recursive: true });
+	return appDir;
 }
+/**
+* Get the database path for mastracode
+* Can be overridden with the MASTRA_DB_PATH environment variable for debugging.
+*/
 function getDatabasePath() {
-  if (process.env.MASTRA_DB_PATH) {
-    return process.env.MASTRA_DB_PATH;
-  }
-  return path.join(getAppDataDir(), "mastra.db");
+	if (process.env.MASTRA_DB_PATH) return process.env.MASTRA_DB_PATH;
+	return path.join(getAppDataDir(), "mastra.db");
 }
+/**
+* Get the vector database path for mastracode.
+* Separate from the main DB to avoid bloating it with embedding data.
+*/
 function getVectorDatabasePath() {
-  return path.join(getAppDataDir(), "mastra-vectors.db");
+	return path.join(getAppDataDir(), "mastra-vectors.db");
 }
+/**
+* Get the observability DuckDB database path for mastracode.
+* Separate from the main DB — DuckDB is used for OLAP-style trace/score/feedback queries.
+* Can be overridden with the MASTRA_OBSERVABILITY_DB_PATH environment variable.
+*/
 function getObservabilityDatabasePath() {
-  if (process.env.MASTRA_OBSERVABILITY_DB_PATH) {
-    return process.env.MASTRA_OBSERVABILITY_DB_PATH;
-  }
-  return path.join(getAppDataDir(), "observability.duckdb");
+	if (process.env.MASTRA_OBSERVABILITY_DB_PATH) return process.env.MASTRA_OBSERVABILITY_DB_PATH;
+	return path.join(getAppDataDir(), "observability.duckdb");
 }
+/**
+* Get the resolved storage configuration.
+*
+* Priority (highest to lowest):
+*   1. Environment variables: MASTRA_STORAGE_BACKEND + backend-specific vars
+*   2. Global settings (from /settings): settings.storage
+*   3. Legacy config files: .mastracode/database.json (LibSQL only)
+*   4. Local file database (LibSQL default)
+*
+* For PG, the env vars are:
+*   MASTRA_STORAGE_BACKEND=pg
+*   MASTRA_PG_CONNECTION_STRING or MASTRA_PG_HOST/PORT/DATABASE/USER/PASSWORD
+*   MASTRA_PG_SCHEMA_NAME (optional)
+*
+* For LibSQL, the legacy env vars still work:
+*   MASTRA_DB_URL + MASTRA_DB_AUTH_TOKEN
+*/
 function getStorageConfig(projectDir, storageSettings, configDirName = DEFAULT_CONFIG_DIR) {
-  const envBackend = process.env.MASTRA_STORAGE_BACKEND;
-  if (envBackend === "pg") {
-    return resolvePgFromEnv();
-  }
-  if (envBackend === "libsql" || process.env.MASTRA_DB_URL) {
-    return resolveLibSQLFromEnv();
-  }
-  if (storageSettings && storageSettings.backend === "pg") {
-    return resolvePgFromSettings(storageSettings);
-  }
-  if (storageSettings && storageSettings.backend === "libsql" && storageSettings.libsql.url) {
-    return {
-      backend: "libsql",
-      url: storageSettings.libsql.url,
-      authToken: storageSettings.libsql.authToken,
-      isRemote: !storageSettings.libsql.url.startsWith("file:")
-    };
-  }
-  if (projectDir) {
-    const projectConfig = loadDatabaseConfig(path.join(projectDir, configDirName, "database.json"));
-    if (projectConfig) return projectConfig;
-  }
-  const globalConfig = loadDatabaseConfig(path.join(os.homedir(), configDirName, "database.json"));
-  if (globalConfig) return globalConfig;
-  return {
-    backend: "libsql",
-    url: `file:${getDatabasePath()}`,
-    isRemote: false
-  };
+	const envBackend = process.env.MASTRA_STORAGE_BACKEND;
+	if (envBackend === "pg") return resolvePgFromEnv();
+	if (envBackend === "libsql" || process.env.MASTRA_DB_URL) return resolveLibSQLFromEnv();
+	if (storageSettings && storageSettings.backend === "pg") return resolvePgFromSettings(storageSettings);
+	if (storageSettings && storageSettings.backend === "libsql" && storageSettings.libsql.url) return {
+		backend: "libsql",
+		url: storageSettings.libsql.url,
+		authToken: storageSettings.libsql.authToken,
+		isRemote: !storageSettings.libsql.url.startsWith("file:")
+	};
+	if (projectDir) {
+		const projectConfig = loadDatabaseConfig(path.join(projectDir, configDirName, "database.json"));
+		if (projectConfig) return projectConfig;
+	}
+	const globalConfig = loadDatabaseConfig(path.join(os.homedir(), configDirName, "database.json"));
+	if (globalConfig) return globalConfig;
+	return {
+		backend: "libsql",
+		url: `file:${getDatabasePath()}`,
+		isRemote: false
+	};
 }
 function resolveLibSQLFromEnv() {
-  const url = process.env.MASTRA_DB_URL;
-  return {
-    backend: "libsql",
-    url,
-    authToken: process.env.MASTRA_DB_AUTH_TOKEN,
-    isRemote: !url.startsWith("file:")
-  };
+	const url = process.env.MASTRA_DB_URL;
+	return {
+		backend: "libsql",
+		url,
+		authToken: process.env.MASTRA_DB_AUTH_TOKEN,
+		isRemote: !url.startsWith("file:")
+	};
 }
 function resolvePgFromEnv() {
-  const connectionString = process.env.MASTRA_PG_CONNECTION_STRING;
-  if (connectionString) {
-    return {
-      backend: "pg",
-      connectionString,
-      schemaName: process.env.MASTRA_PG_SCHEMA_NAME
-    };
-  }
-  return {
-    backend: "pg",
-    host: process.env.MASTRA_PG_HOST,
-    port: process.env.MASTRA_PG_PORT ? parseInt(process.env.MASTRA_PG_PORT, 10) : void 0,
-    database: process.env.MASTRA_PG_DATABASE,
-    user: process.env.MASTRA_PG_USER,
-    password: process.env.MASTRA_PG_PASSWORD,
-    schemaName: process.env.MASTRA_PG_SCHEMA_NAME
-  };
+	const connectionString = process.env.MASTRA_PG_CONNECTION_STRING;
+	if (connectionString) return {
+		backend: "pg",
+		connectionString,
+		schemaName: process.env.MASTRA_PG_SCHEMA_NAME
+	};
+	return {
+		backend: "pg",
+		host: process.env.MASTRA_PG_HOST,
+		port: process.env.MASTRA_PG_PORT ? parseInt(process.env.MASTRA_PG_PORT, 10) : void 0,
+		database: process.env.MASTRA_PG_DATABASE,
+		user: process.env.MASTRA_PG_USER,
+		password: process.env.MASTRA_PG_PASSWORD,
+		schemaName: process.env.MASTRA_PG_SCHEMA_NAME
+	};
 }
 function resolvePgFromSettings(settings) {
-  const pg = settings.pg;
-  return {
-    backend: "pg",
-    connectionString: pg.connectionString,
-    host: pg.host,
-    port: pg.port,
-    database: pg.database,
-    user: pg.user,
-    password: pg.password,
-    schemaName: pg.schemaName,
-    disableInit: pg.disableInit,
-    skipDefaultIndexes: pg.skipDefaultIndexes
-  };
+	const pg = settings.pg;
+	return {
+		backend: "pg",
+		connectionString: pg.connectionString,
+		host: pg.host,
+		port: pg.port,
+		database: pg.database,
+		user: pg.user,
+		password: pg.password,
+		schemaName: pg.schemaName,
+		disableInit: pg.disableInit,
+		skipDefaultIndexes: pg.skipDefaultIndexes
+	};
 }
+/**
+* Load database config from a legacy JSON file.
+* Expected format: { "url": "libsql://...", "authToken": "..." }
+*/
 function loadDatabaseConfig(filePath) {
-  try {
-    if (!fs.existsSync(filePath)) return null;
-    const raw = fs.readFileSync(filePath, "utf-8");
-    const parsed = JSON.parse(raw);
-    if (typeof parsed?.url === "string" && parsed.url) {
-      return {
-        backend: "libsql",
-        url: parsed.url,
-        authToken: typeof parsed.authToken === "string" ? parsed.authToken : void 0,
-        isRemote: !parsed.url.startsWith("file:")
-      };
-    }
-    return null;
-  } catch {
-    return null;
-  }
+	try {
+		if (!fs.existsSync(filePath)) return null;
+		const raw = fs.readFileSync(filePath, "utf-8");
+		const parsed = JSON.parse(raw);
+		if (typeof parsed?.url === "string" && parsed.url) return {
+			backend: "libsql",
+			url: parsed.url,
+			authToken: typeof parsed.authToken === "string" ? parsed.authToken : void 0,
+			isRemote: !parsed.url.startsWith("file:")
+		};
+		return null;
+	} catch {
+		return null;
+	}
 }
+/**
+* Get the current user identity.
+*
+* Priority:
+*   1. MASTRA_USER_ID environment variable
+*   2. git config user.email (from project dir or global)
+*   3. OS username as fallback
+*/
 function getUserId(projectDir) {
-  if (process.env.MASTRA_USER_ID) {
-    return process.env.MASTRA_USER_ID;
-  }
-  const cwd = projectDir || process.cwd();
-  const email = git("config user.email", cwd);
-  if (email) {
-    return email;
-  }
-  return os.userInfo().username || "unknown";
+	if (process.env.MASTRA_USER_ID) return process.env.MASTRA_USER_ID;
+	const email = git("config user.email", projectDir || process.cwd());
+	if (email) return email;
+	return os.userInfo().username || "unknown";
 }
+/**
+* Get the current user's display name.
+*
+* Priority:
+*   1. git config user.name
+*   2. OS username as fallback
+*/
 function getUserName(projectDir) {
-  const cwd = projectDir || process.cwd();
-  const name = git("config user.name", cwd);
-  if (name) {
-    return name;
-  }
-  return os.userInfo().username || "unknown";
+	const name = git("config user.name", projectDir || process.cwd());
+	if (name) return name;
+	return os.userInfo().username || "unknown";
 }
+/**
+* Get the configured observational memory scope.
+*
+* Priority:
+*   1. MASTRA_OM_SCOPE environment variable ("thread" or "resource")
+*   2. Project config: .mastracode/database.json → omScope
+*   3. Global config: ~/.mastracode/database.json → omScope
+*   4. Default: "thread"
+*/
 function getOmScope(projectDir, configDirName = DEFAULT_CONFIG_DIR) {
-  const envScope = process.env.MASTRA_OM_SCOPE;
-  if (envScope === "thread" || envScope === "resource") {
-    return envScope;
-  }
-  if (projectDir) {
-    const scope2 = loadOmScopeFromConfig(path.join(projectDir, configDirName, "database.json"));
-    if (scope2) return scope2;
-  }
-  const scope = loadOmScopeFromConfig(path.join(os.homedir(), configDirName, "database.json"));
-  if (scope) return scope;
-  return "thread";
+	const envScope = process.env.MASTRA_OM_SCOPE;
+	if (envScope === "thread" || envScope === "resource") return envScope;
+	if (projectDir) {
+		const scope = loadOmScopeFromConfig(path.join(projectDir, configDirName, "database.json"));
+		if (scope) return scope;
+	}
+	const scope = loadOmScopeFromConfig(path.join(os.homedir(), configDirName, "database.json"));
+	if (scope) return scope;
+	return "thread";
 }
 function loadOmScopeFromConfig(filePath) {
-  try {
-    if (!fs.existsSync(filePath)) return null;
-    const raw = fs.readFileSync(filePath, "utf-8");
-    const parsed = JSON.parse(raw);
-    if (parsed?.omScope === "thread" || parsed?.omScope === "resource") {
-      return parsed.omScope;
-    }
-    return null;
-  } catch {
-    return null;
-  }
+	try {
+		if (!fs.existsSync(filePath)) return null;
+		const raw = fs.readFileSync(filePath, "utf-8");
+		const parsed = JSON.parse(raw);
+		if (parsed?.omScope === "thread" || parsed?.omScope === "resource") return parsed.omScope;
+		return null;
+	} catch {
+		return null;
+	}
 }
+/**
+* Get an explicit resource ID override, if configured.
+*
+* Resource IDs act as shared tags — two users who set the same resourceId
+* will share threads and observations for that resource.
+*
+* Priority:
+*   1. MASTRA_RESOURCE_ID environment variable
+*   2. Project config: .mastracode/database.json → resourceId
+*   3. Global config: ~/.mastracode/database.json → resourceId
+*   4. null (use auto-detected value)
+*/
 function getResourceIdOverride(projectDir, configDirName = DEFAULT_CONFIG_DIR) {
-  if (process.env.MASTRA_RESOURCE_ID) {
-    return process.env.MASTRA_RESOURCE_ID;
-  }
-  if (projectDir) {
-    const rid2 = loadStringField(path.join(projectDir, configDirName, "database.json"), "resourceId");
-    if (rid2) return rid2;
-  }
-  const rid = loadStringField(path.join(os.homedir(), configDirName, "database.json"), "resourceId");
-  if (rid) return rid;
-  return null;
+	if (process.env.MASTRA_RESOURCE_ID) return process.env.MASTRA_RESOURCE_ID;
+	if (projectDir) {
+		const rid = loadStringField(path.join(projectDir, configDirName, "database.json"), "resourceId");
+		if (rid) return rid;
+	}
+	const rid = loadStringField(path.join(os.homedir(), configDirName, "database.json"), "resourceId");
+	if (rid) return rid;
+	return null;
 }
 function loadStringField(filePath, field) {
-  try {
-    if (!fs.existsSync(filePath)) return null;
-    const raw = fs.readFileSync(filePath, "utf-8");
-    const parsed = JSON.parse(raw);
-    const value = parsed?.[field];
-    if (typeof value === "string" && value) {
-      return value;
-    }
-    return null;
-  } catch {
-    return null;
-  }
+	try {
+		if (!fs.existsSync(filePath)) return null;
+		const raw = fs.readFileSync(filePath, "utf-8");
+		const value = JSON.parse(raw)?.[field];
+		if (typeof value === "string" && value) return value;
+		return null;
+	} catch {
+		return null;
+	}
 }
-export {
-  detectProject,
-  getAppDataDir,
-  getCurrentGitBranch,
-  getCurrentGitBranchAsync,
-  getDatabasePath,
-  getObservabilityDatabasePath,
-  getOmScope,
-  getResourceIdOverride,
-  getStorageConfig,
-  getUserId,
-  getUserName,
-  getVectorDatabasePath
-};
+//#endregion
+export { detectProject, getAppDataDir, getCurrentGitBranch, getCurrentGitBranchAsync, getDatabasePath, getObservabilityDatabasePath, getOmScope, getResourceIdOverride, getStorageConfig, getUserId, getUserName, getVectorDatabasePath };
+
 //# sourceMappingURL=project.js.map