@mastra/code-sdk 0.0.0-aggregate-trace-20261015182851

package/dist/utils/project.js

@@ -0,0 +1,364 @@
+import { DEFAULT_CONFIG_DIR } from "../constants.js";
+import path from "path";
+import { createHash } from "crypto";
+import fs from "fs";
+import { execFile, execSync } from "child_process";
+import os from "os";
+//#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;
+	}
+}
+/**
+* Slugify a string for use in IDs
+*/
+function slugify(str) {
+	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);
+}
+/**
+* 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();
+}
+/**
+* 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);
+	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);
+}
+/**
+* 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;
+			}
+			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;
+}
+/**
+* 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");
+}
+/**
+* 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");
+}
+/**
+* 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");
+}
+/**
+* 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
+	};
+}
+function resolveLibSQLFromEnv() {
+	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
+	};
+}
+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
+	};
+}
+/**
+* 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;
+	}
+}
+/**
+* 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 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 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 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;
+	}
+}
+/**
+* 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 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 value = JSON.parse(raw)?.[field];
+		if (typeof value === "string" && value) return value;
+		return null;
+	} catch {
+		return null;
+	}
+}
+//#endregion
+export { detectProject, getAppDataDir, getCurrentGitBranch, getCurrentGitBranchAsync, getDatabasePath, getObservabilityDatabasePath, getOmScope, getResourceIdOverride, getStorageConfig, getUserId, getUserName, getVectorDatabasePath };
+
+//# sourceMappingURL=project.js.map

package/dist/utils/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","names":[],"sources":["../../src/utils/project.ts"],"sourcesContent":["/**\n * Project detection utilities\n *\n * Detects project identity from git repo or filesystem path.\n * Handles git worktrees by finding the main repository.\n */\n\nimport { execFile, execSync } from 'node:child_process';\nimport { createHash } from 'node:crypto';\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\nexport interface ProjectInfo {\n  /** Unique resource ID for this project (used for thread grouping) */\n  resourceId: string;\n  /** Human-readable project name */\n  name: string;\n  /** Absolute path to the project root */\n  rootPath: string;\n  /** Git remote URL if available */\n  gitUrl?: string;\n  /** Current git branch */\n  gitBranch?: string;\n  /** Whether this is a git worktree */\n  isWorktree: boolean;\n  /** Path to main git repo (different from rootPath if worktree) */\n  mainRepoPath?: string;\n  /** Whether the resourceId was explicitly overridden (env var or config) */\n  resourceIdOverride?: boolean;\n}\n\n/**\n * Run a git command and return stdout, or undefined if it fails\n */\nfunction git(args: string, cwd: string): string | undefined {\n  try {\n    return execSync(`git ${args}`, {\n      cwd,\n      encoding: 'utf-8',\n      stdio: ['pipe', 'pipe', 'pipe'],\n    }).trim();\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Slugify a string for use in IDs\n */\nfunction slugify(str: string): string {\n  return str\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-|-$/g, '');\n}\n\n/**\n * Create a short hash of a string\n */\nfunction shortHash(str: string): string {\n  return createHash('sha256').update(str).digest('hex').slice(0, 12);\n}\n\n/**\n * Normalize a git URL to a canonical form for comparison\n * - Removes .git suffix\n * - Converts SSH to HTTPS format for consistency\n * - Lowercases\n */\nfunction normalizeGitUrl(url: string): string {\n  return url\n    .replace(/\\.git$/, '')\n    .replace(/^git@([^:]+):/, 'https://$1/')\n    .replace(/^ssh:\\/\\/git@/, 'https://')\n    .toLowerCase();\n}\n\n/**\n * Detect project info from a directory path\n */\nexport function detectProject(projectPath: string): ProjectInfo {\n  const absolutePath = path.resolve(projectPath);\n\n  // Check if this is a git repo\n  const gitDir = git('rev-parse --git-dir', absolutePath);\n  const isGitRepo = gitDir !== undefined;\n\n  let rootPath = absolutePath;\n  let gitUrl: string | undefined;\n  let gitBranch: string | undefined;\n  let isWorktree = false;\n  let mainRepoPath: string | undefined;\n\n  if (isGitRepo) {\n    // Get the repo root (handles being in a subdirectory)\n    rootPath = git('rev-parse --show-toplevel', absolutePath) || absolutePath;\n\n    // Check for worktree - git-common-dir differs from git-dir in worktrees\n    const commonDir = git('rev-parse --git-common-dir', absolutePath);\n    if (commonDir && commonDir !== '.git' && commonDir !== gitDir) {\n      isWorktree = true;\n      // The common dir is inside the main repo's .git folder\n      mainRepoPath = path.dirname(path.resolve(rootPath, commonDir));\n    }\n\n    // Get remote URL (prefer origin, fall back to first remote)\n    gitUrl = git('remote get-url origin', absolutePath);\n    if (!gitUrl) {\n      const remotes = git('remote', absolutePath);\n      if (remotes) {\n        const firstRemote = remotes.split('\\n')[0];\n        if (firstRemote) {\n          gitUrl = git(`remote get-url ${firstRemote}`, absolutePath);\n        }\n      }\n    }\n\n    // Get current branch\n    gitBranch = git('rev-parse --abbrev-ref HEAD', absolutePath);\n  }\n\n  // Generate resource ID\n  // Priority: normalized git URL > main repo path (for worktrees) > absolute path\n  let resourceIdSource: string;\n  if (gitUrl) {\n    resourceIdSource = normalizeGitUrl(gitUrl);\n  } else if (mainRepoPath) {\n    resourceIdSource = mainRepoPath;\n  } else {\n    resourceIdSource = rootPath;\n  }\n\n  // Create a readable but unique resource ID\n  // Format: slugified-name-shorthash\n  const baseName = gitUrl\n    ? gitUrl\n        .split('/')\n        .pop()\n        ?.replace(/\\.git$/, '') || 'project'\n    : path.basename(rootPath);\n\n  const resourceId = `${slugify(baseName)}-${shortHash(resourceIdSource)}`;\n\n  return {\n    resourceId,\n    name: baseName,\n    rootPath,\n    gitUrl,\n    gitBranch,\n    isWorktree,\n    mainRepoPath,\n  };\n}\n\n/**\n * Get the current git branch for a given directory.\n * Lightweight alternative to detectProject() for refreshing just the branch.\n */\nexport function getCurrentGitBranch(cwd: string): string | undefined {\n  return git('rev-parse --abbrev-ref HEAD', cwd);\n}\n\n/**\n * Async version of getCurrentGitBranch — avoids blocking the event loop\n * with execSync.  Falls back to undefined on any failure.\n */\nexport function getCurrentGitBranchAsync(cwd: string): Promise<string | undefined> {\n  return new Promise(resolve => {\n    execFile('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd, encoding: 'utf-8' }, (err, stdout) => {\n      if (err) {\n        resolve(undefined);\n        return;\n      }\n      const branch = stdout.trim();\n      resolve(branch || undefined);\n    });\n  });\n}\n\n/**\n * Get the application data directory for mastracode\n * - macOS: ~/Library/Application Support/mastracode\n * - Linux: ~/.local/share/mastracode\n * - Windows: %APPDATA%/mastracode\n */\nexport function getAppDataDir(): string {\n  if (process.env.MASTRA_APP_DATA_DIR) {\n    fs.mkdirSync(process.env.MASTRA_APP_DATA_DIR, { recursive: true });\n    return process.env.MASTRA_APP_DATA_DIR;\n  }\n\n  const platform = os.platform();\n  let baseDir: string;\n\n  if (platform === 'darwin') {\n    baseDir = path.join(os.homedir(), 'Library', 'Application Support');\n  } else if (platform === 'win32') {\n    baseDir = process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming');\n  } else {\n    // Linux and others - follow XDG spec\n    baseDir = process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');\n  }\n\n  const appDir = path.join(baseDir, 'mastracode');\n\n  // Ensure directory exists\n  if (!fs.existsSync(appDir)) {\n    fs.mkdirSync(appDir, { recursive: true });\n  }\n\n  return appDir;\n}\n/**\n * Get the database path for mastracode\n * Can be overridden with the MASTRA_DB_PATH environment variable for debugging.\n */\nexport function getDatabasePath(): string {\n  if (process.env.MASTRA_DB_PATH) {\n    return process.env.MASTRA_DB_PATH;\n  }\n  return path.join(getAppDataDir(), 'mastra.db');\n}\n\n/**\n * Get the vector database path for mastracode.\n * Separate from the main DB to avoid bloating it with embedding data.\n */\nexport function getVectorDatabasePath(): string {\n  return path.join(getAppDataDir(), 'mastra-vectors.db');\n}\n\n/**\n * Get the observability DuckDB database path for mastracode.\n * Separate from the main DB — DuckDB is used for OLAP-style trace/score/feedback queries.\n * Can be overridden with the MASTRA_OBSERVABILITY_DB_PATH environment variable.\n */\nexport function getObservabilityDatabasePath(): string {\n  if (process.env.MASTRA_OBSERVABILITY_DB_PATH) {\n    return process.env.MASTRA_OBSERVABILITY_DB_PATH;\n  }\n  return path.join(getAppDataDir(), 'observability.duckdb');\n}\n\nimport type { StorageBackend, StorageSettings } from '../onboarding/settings.js';\n\n/**\n * LibSQL storage configuration.\n */\nexport interface LibSQLStorageConfig {\n  backend: 'libsql';\n  url: string;\n  authToken?: string;\n  isRemote: boolean;\n  /**\n   * Optional explicit url for the recall vector DB. When omitted, the factory\n   * uses the shared default vector file.\n   */\n  vectorUrl?: string;\n  /** Auth token for the vector DB when `vectorUrl` points at a remote libSQL. */\n  vectorAuthToken?: string;\n}\n\n/**\n * PostgreSQL storage configuration.\n */\nexport interface PgStorageConfig {\n  backend: 'pg';\n  connectionString?: string;\n  host?: string;\n  port?: number;\n  database?: string;\n  user?: string;\n  password?: string;\n  schemaName?: string;\n  disableInit?: boolean;\n  skipDefaultIndexes?: boolean;\n}\n\n/**\n * Resolved storage configuration for either backend.\n */\nexport type StorageConfig = LibSQLStorageConfig | PgStorageConfig;\n\n/**\n * Get the resolved storage configuration.\n *\n * Priority (highest to lowest):\n *   1. Environment variables: MASTRA_STORAGE_BACKEND + backend-specific vars\n *   2. Global settings (from /settings): settings.storage\n *   3. Legacy config files: .mastracode/database.json (LibSQL only)\n *   4. Local file database (LibSQL default)\n *\n * For PG, the env vars are:\n *   MASTRA_STORAGE_BACKEND=pg\n *   MASTRA_PG_CONNECTION_STRING or MASTRA_PG_HOST/PORT/DATABASE/USER/PASSWORD\n *   MASTRA_PG_SCHEMA_NAME (optional)\n *\n * For LibSQL, the legacy env vars still work:\n *   MASTRA_DB_URL + MASTRA_DB_AUTH_TOKEN\n */\nexport function getStorageConfig(\n  projectDir?: string,\n  storageSettings?: StorageSettings,\n  configDirName = DEFAULT_CONFIG_DIR,\n): StorageConfig {\n  // 1. Environment variable — explicit backend selection\n  const envBackend = process.env.MASTRA_STORAGE_BACKEND as StorageBackend | undefined;\n\n  if (envBackend === 'pg') {\n    return resolvePgFromEnv();\n  }\n\n  // Legacy LibSQL env vars (MASTRA_DB_URL) — treat as explicit libsql\n  if (envBackend === 'libsql' || process.env.MASTRA_DB_URL) {\n    return resolveLibSQLFromEnv();\n  }\n\n  // 2. Global settings (from /settings)\n  if (storageSettings && storageSettings.backend === 'pg') {\n    return resolvePgFromSettings(storageSettings);\n  }\n\n  if (storageSettings && storageSettings.backend === 'libsql' && storageSettings.libsql.url) {\n    return {\n      backend: 'libsql',\n      url: storageSettings.libsql.url,\n      authToken: storageSettings.libsql.authToken,\n      isRemote: !storageSettings.libsql.url.startsWith('file:'),\n    };\n  }\n\n  // 3. Legacy project/global config files (.mastracode/database.json)\n  if (projectDir) {\n    const projectConfig = loadDatabaseConfig(path.join(projectDir, configDirName, 'database.json'));\n    if (projectConfig) return projectConfig;\n  }\n  const globalConfig = loadDatabaseConfig(path.join(os.homedir(), configDirName, 'database.json'));\n  if (globalConfig) return globalConfig;\n\n  // 4. Default: local LibSQL file database\n  return {\n    backend: 'libsql',\n    url: `file:${getDatabasePath()}`,\n    isRemote: false,\n  };\n}\n\nfunction resolveLibSQLFromEnv(): LibSQLStorageConfig {\n  const url = process.env.MASTRA_DB_URL!;\n  return {\n    backend: 'libsql',\n    url,\n    authToken: process.env.MASTRA_DB_AUTH_TOKEN,\n    isRemote: !url.startsWith('file:'),\n  };\n}\n\nfunction resolvePgFromEnv(): PgStorageConfig {\n  const connectionString = process.env.MASTRA_PG_CONNECTION_STRING;\n  if (connectionString) {\n    return {\n      backend: 'pg',\n      connectionString,\n      schemaName: process.env.MASTRA_PG_SCHEMA_NAME,\n    };\n  }\n\n  // Host/port style\n  return {\n    backend: 'pg',\n    host: process.env.MASTRA_PG_HOST,\n    port: process.env.MASTRA_PG_PORT ? parseInt(process.env.MASTRA_PG_PORT, 10) : undefined,\n    database: process.env.MASTRA_PG_DATABASE,\n    user: process.env.MASTRA_PG_USER,\n    password: process.env.MASTRA_PG_PASSWORD,\n    schemaName: process.env.MASTRA_PG_SCHEMA_NAME,\n  };\n}\n\nfunction resolvePgFromSettings(settings: StorageSettings): PgStorageConfig {\n  const pg = settings.pg;\n  return {\n    backend: 'pg',\n    connectionString: pg.connectionString,\n    host: pg.host,\n    port: pg.port,\n    database: pg.database,\n    user: pg.user,\n    password: pg.password,\n    schemaName: pg.schemaName,\n    disableInit: pg.disableInit,\n    skipDefaultIndexes: pg.skipDefaultIndexes,\n  };\n}\n\n/**\n * Load database config from a legacy JSON file.\n * Expected format: { \"url\": \"libsql://...\", \"authToken\": \"...\" }\n */\nfunction loadDatabaseConfig(filePath: string): LibSQLStorageConfig | null {\n  try {\n    if (!fs.existsSync(filePath)) return null;\n    const raw = fs.readFileSync(filePath, 'utf-8');\n    const parsed = JSON.parse(raw);\n    if (typeof parsed?.url === 'string' && parsed.url) {\n      return {\n        backend: 'libsql',\n        url: parsed.url,\n        authToken: typeof parsed.authToken === 'string' ? parsed.authToken : undefined,\n        isRemote: !parsed.url.startsWith('file:'),\n      };\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Get the current user identity.\n *\n * Priority:\n *   1. MASTRA_USER_ID environment variable\n *   2. git config user.email (from project dir or global)\n *   3. OS username as fallback\n */\nexport function getUserId(projectDir?: string): string {\n  // 1. Environment variable override\n  if (process.env.MASTRA_USER_ID) {\n    return process.env.MASTRA_USER_ID;\n  }\n\n  // 2. git user.email\n  const cwd = projectDir || process.cwd();\n  const email = git('config user.email', cwd);\n  if (email) {\n    return email;\n  }\n\n  // 3. OS username fallback\n  return os.userInfo().username || 'unknown';\n}\n\n/**\n * Get the current user's display name.\n *\n * Priority:\n *   1. git config user.name\n *   2. OS username as fallback\n */\nexport function getUserName(projectDir?: string): string {\n  const cwd = projectDir || process.cwd();\n  const name = git('config user.name', cwd);\n  if (name) {\n    return name;\n  }\n  return os.userInfo().username || 'unknown';\n}\n\n/**\n * Observational memory scope: \"thread\" (per-conversation) or \"resource\" (shared across threads).\n */\nexport type OmScope = 'thread' | 'resource';\n\n/**\n * Get the configured observational memory scope.\n *\n * Priority:\n *   1. MASTRA_OM_SCOPE environment variable (\"thread\" or \"resource\")\n *   2. Project config: .mastracode/database.json → omScope\n *   3. Global config: ~/.mastracode/database.json → omScope\n *   4. Default: \"thread\"\n */\nexport function getOmScope(projectDir?: string, configDirName = DEFAULT_CONFIG_DIR): OmScope {\n  // 1. Environment variable\n  const envScope = process.env.MASTRA_OM_SCOPE;\n  if (envScope === 'thread' || envScope === 'resource') {\n    return envScope;\n  }\n\n  // 2. Project-level config\n  if (projectDir) {\n    const scope = loadOmScopeFromConfig(path.join(projectDir, configDirName, 'database.json'));\n    if (scope) return scope;\n  }\n\n  // 3. Global config\n  const scope = loadOmScopeFromConfig(path.join(os.homedir(), configDirName, 'database.json'));\n  if (scope) return scope;\n\n  // 4. Default\n  return 'thread';\n}\n\nfunction loadOmScopeFromConfig(filePath: string): OmScope | null {\n  try {\n    if (!fs.existsSync(filePath)) return null;\n    const raw = fs.readFileSync(filePath, 'utf-8');\n    const parsed = JSON.parse(raw);\n    if (parsed?.omScope === 'thread' || parsed?.omScope === 'resource') {\n      return parsed.omScope;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Get an explicit resource ID override, if configured.\n *\n * Resource IDs act as shared tags — two users who set the same resourceId\n * will share threads and observations for that resource.\n *\n * Priority:\n *   1. MASTRA_RESOURCE_ID environment variable\n *   2. Project config: .mastracode/database.json → resourceId\n *   3. Global config: ~/.mastracode/database.json → resourceId\n *   4. null (use auto-detected value)\n */\nexport function getResourceIdOverride(projectDir?: string, configDirName = DEFAULT_CONFIG_DIR): string | null {\n  // 1. Environment variable\n  if (process.env.MASTRA_RESOURCE_ID) {\n    return process.env.MASTRA_RESOURCE_ID;\n  }\n\n  // 2. Project-level config\n  if (projectDir) {\n    const rid = loadStringField(path.join(projectDir, configDirName, 'database.json'), 'resourceId');\n    if (rid) return rid;\n  }\n\n  // 3. Global config\n  const rid = loadStringField(path.join(os.homedir(), configDirName, 'database.json'), 'resourceId');\n  if (rid) return rid;\n\n  return null;\n}\n\nfunction loadStringField(filePath: string, field: string): string | null {\n  try {\n    if (!fs.existsSync(filePath)) return null;\n    const raw = fs.readFileSync(filePath, 'utf-8');\n    const parsed = JSON.parse(raw);\n    const value = parsed?.[field];\n    if (typeof value === 'string' && value) {\n      return value;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n"],"mappings":"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"}

package/dist/utils/prune-cli.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `mastracode prune` — storage maintenance from a non-interactive shell.
+ *
+ * The in-TUI `/prune` command has to stop the UI, quiesce background writers
+ * (MCP, workers, intervals) and then exit the process, because retention
+ * deletes and VACUUM need the database to themselves. A standalone process
+ * already satisfies that contract — and, unlike `/prune`, it does not require a
+ * rendered prompt first, so maintenance stays reachable when the TUI cannot
+ * start. Without it a large mastra.db has no in-app remedy (issue #22056).
+ *
+ * Usage:
+ *   mastracode prune                 delete rows older than the retention policies
+ *   mastracode prune --vacuum        prune, then checkpoint WAL + VACUUM to return disk to the OS
+ *                                    (local libsql only; remote libsql and Postgres only prune rows)
+ *   mastracode prune --keep-memory   prune, but keep chat history (messages/threads)
+ */
+import type { StorageConfig } from './project.js';
+/**
+ * Run storage maintenance for the project in the current directory.
+ * Returns the process exit code (0 on success).
+ */
+export declare function runPruneCommand(args: string[]): Promise<number>;
+export declare function describeStorageTarget(config: StorageConfig): string;
+//# sourceMappingURL=prune-cli.d.ts.map

package/dist/utils/prune-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune-cli.d.ts","sourceRoot":"","sources":["../../src/utils/prune-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAYH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAiBlD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuCrE;AA2ED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CASnE"}

package/dist/utils/prune-cli.js

@@ -0,0 +1,125 @@
+import { DEFAULT_CONFIG_DIR } from "../constants.js";
+import { detectProject, getStorageConfig } from "./project.js";
+import { loadSettings } from "../onboarding/settings.js";
+import { acquireMaintenanceLock } from "./maintenance-lock.js";
+import { DEFAULT_RETENTION, createStorageMaintenance, resolveLocalDbFiles, runStorageMaintenance } from "./storage-maintenance.js";
+import { createStorage, createVectorStore } from "./storage-factory.js";
+import path from "path";
+import { LibSQLVector } from "@mastra/libsql";
+//#region src/utils/prune-cli.ts
+/**
+* `mastracode prune` — storage maintenance from a non-interactive shell.
+*
+* The in-TUI `/prune` command has to stop the UI, quiesce background writers
+* (MCP, workers, intervals) and then exit the process, because retention
+* deletes and VACUUM need the database to themselves. A standalone process
+* already satisfies that contract — and, unlike `/prune`, it does not require a
+* rendered prompt first, so maintenance stays reachable when the TUI cannot
+* start. Without it a large mastra.db has no in-app remedy (issue #22056).
+*
+* Usage:
+*   mastracode prune                 delete rows older than the retention policies
+*   mastracode prune --vacuum        prune, then checkpoint WAL + VACUUM to return disk to the OS
+*                                    (local libsql only; remote libsql and Postgres only prune rows)
+*   mastracode prune --keep-memory   prune, but keep chat history (messages/threads)
+*/
+const USAGE = `Usage: mastracode prune [--vacuum] [--keep-memory]
+
+  --vacuum        After pruning, compact the local database files so freed
+                  pages are returned to the OS. Needs free disk for the copy.
+                  Local libsql only; remote libsql and Postgres only prune rows.
+  --keep-memory   Prune everything except chat history (messages/threads).
+`;
+/**
+* Run storage maintenance for the project in the current directory.
+* Returns the process exit code (0 on success).
+*/
+async function runPruneCommand(args) {
+	if (args.includes("--help") || args.includes("-h")) {
+		console.log(USAGE);
+		return 0;
+	}
+	const flags = new Set(args.map((a) => a.toLowerCase()));
+	const unknown = [...flags].filter((f) => f !== "--vacuum" && f !== "--keep-memory");
+	if (unknown.length > 0) {
+		console.error(`Unknown prune option: ${unknown.join(", ")}\n${USAGE}`);
+		return 1;
+	}
+	const vacuum = flags.has("--vacuum");
+	const keepMemory = flags.has("--keep-memory");
+	try {
+		process.loadEnvFile(path.join(process.cwd(), ".env"));
+	} catch {}
+	let releaseLock;
+	try {
+		releaseLock = acquireMaintenanceLock();
+	} catch (err) {
+		console.error(err instanceof Error ? err.message : String(err));
+		return 1;
+	}
+	try {
+		return await prune({
+			vacuum,
+			keepMemory
+		});
+	} finally {
+		releaseLock();
+	}
+}
+async function prune({ vacuum, keepMemory }) {
+	const settings = loadSettings();
+	const storageConfig = getStorageConfig(detectProject(process.cwd()).rootPath, settings.storage, DEFAULT_CONFIG_DIR);
+	console.log(`Storage target: ${describeStorageTarget(storageConfig)}`);
+	const { storage, backend, warning } = await createStorage(storageConfig);
+	if (warning) console.log(warning);
+	let vector;
+	try {
+		await storage.init();
+		const localDbFiles = resolveLocalDbFiles(storageConfig, backend);
+		if (localDbFiles.length > 0) console.log(`Database: ${localDbFiles.join(", ")}`);
+		if (vacuum && localDbFiles.length > 0) vector = await createVectorStore(storageConfig, backend);
+		const libsqlVector = vector instanceof LibSQLVector ? vector : void 0;
+		await runStorageMaintenance({
+			maintenance: createStorageMaintenance({
+				storage,
+				backend,
+				retention: DEFAULT_RETENTION,
+				localDbFiles,
+				...libsqlVector ? { closeVector: () => libsqlVector.close() } : {}
+			}),
+			vacuum,
+			keepMemory,
+			log: (line) => console.log(line)
+		});
+		console.log("Storage maintenance complete.");
+		return 0;
+	} catch (err) {
+		console.error(`Storage maintenance failed: ${err instanceof Error ? err.message : String(err)}`);
+		try {
+			await storage.close?.();
+			if (vector instanceof LibSQLVector) await vector.close();
+		} catch {}
+		return 1;
+	}
+}
+/** Credential-free URL: drops userinfo and the query string (e.g. ?authToken=). */
+function redactUrl(raw) {
+	try {
+		const url = new URL(raw);
+		url.username = "";
+		url.password = "";
+		url.search = "";
+		return url.toString();
+	} catch {
+		return "<unparseable URL>";
+	}
+}
+function describeStorageTarget(config) {
+	if (config.backend === "libsql") return config.url.startsWith("file:") ? `libsql file ${config.url.slice(5)}` : `libsql ${redactUrl(config.url)}`;
+	if (config.connectionString) return `pg ${redactUrl(config.connectionString)}`;
+	return `pg postgres://${`${config.host ?? "localhost"}${config.port ? `:${config.port}` : ""}`}/${config.database ?? ""}`;
+}
+//#endregion
+export { describeStorageTarget, runPruneCommand };
+
+//# sourceMappingURL=prune-cli.js.map

package/dist/utils/prune-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune-cli.js","names":[],"sources":["../../src/utils/prune-cli.ts"],"sourcesContent":["/**\n * `mastracode prune` — storage maintenance from a non-interactive shell.\n *\n * The in-TUI `/prune` command has to stop the UI, quiesce background writers\n * (MCP, workers, intervals) and then exit the process, because retention\n * deletes and VACUUM need the database to themselves. A standalone process\n * already satisfies that contract — and, unlike `/prune`, it does not require a\n * rendered prompt first, so maintenance stays reachable when the TUI cannot\n * start. Without it a large mastra.db has no in-app remedy (issue #22056).\n *\n * Usage:\n *   mastracode prune                 delete rows older than the retention policies\n *   mastracode prune --vacuum        prune, then checkpoint WAL + VACUUM to return disk to the OS\n *                                    (local libsql only; remote libsql and Postgres only prune rows)\n *   mastracode prune --keep-memory   prune, but keep chat history (messages/threads)\n */\n\nimport path from 'node:path';\n\nimport type { MastraVector } from '@mastra/core/vector';\nimport { LibSQLVector } from '@mastra/libsql';\n\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\nimport { loadSettings } from '../onboarding/settings.js';\n\nimport { acquireMaintenanceLock } from './maintenance-lock.js';\nimport { detectProject, getStorageConfig } from './project.js';\nimport type { StorageConfig } from './project.js';\nimport { createStorage, createVectorStore } from './storage-factory.js';\nimport {\n  DEFAULT_RETENTION,\n  createStorageMaintenance,\n  resolveLocalDbFiles,\n  runStorageMaintenance,\n} from './storage-maintenance.js';\n\nconst USAGE = `Usage: mastracode prune [--vacuum] [--keep-memory]\n\n  --vacuum        After pruning, compact the local database files so freed\n                  pages are returned to the OS. Needs free disk for the copy.\n                  Local libsql only; remote libsql and Postgres only prune rows.\n  --keep-memory   Prune everything except chat history (messages/threads).\n`;\n\n/**\n * Run storage maintenance for the project in the current directory.\n * Returns the process exit code (0 on success).\n */\nexport async function runPruneCommand(args: string[]): Promise<number> {\n  if (args.includes('--help') || args.includes('-h')) {\n    console.log(USAGE);\n    return 0;\n  }\n\n  const flags = new Set(args.map(a => a.toLowerCase()));\n  const unknown = [...flags].filter(f => f !== '--vacuum' && f !== '--keep-memory');\n  if (unknown.length > 0) {\n    console.error(`Unknown prune option: ${unknown.join(', ')}\\n${USAGE}`);\n    return 1;\n  }\n  const vacuum = flags.has('--vacuum');\n  const keepMemory = flags.has('--keep-memory');\n\n  // Startup loads the project .env before registering its session and resolving\n  // storage (MASTRA_APP_DATA_DIR, MASTRA_DB_PATH, ...). Do the same before taking\n  // the lock, or prune locks/scans a different app data dir or opens another DB.\n  try {\n    process.loadEnvFile(path.join(process.cwd(), '.env'));\n  } catch {\n    // No .env file — keys may be in the shell environment\n  }\n\n  // Maintenance needs the database to itself: hold the lock for the whole run\n  // and refuse while any mastracode session is registered.\n  let releaseLock: () => void;\n  try {\n    releaseLock = acquireMaintenanceLock();\n  } catch (err) {\n    console.error(err instanceof Error ? err.message : String(err));\n    return 1;\n  }\n\n  try {\n    return await prune({ vacuum, keepMemory });\n  } finally {\n    releaseLock();\n  }\n}\n\nasync function prune({ vacuum, keepMemory }: { vacuum: boolean; keepMemory: boolean }): Promise<number> {\n  // Resolve storage exactly the way startup does, so prune targets the same\n  // database the TUI uses — honoring MASTRA_DB_PATH / MASTRA_STORAGE_BACKEND,\n  // global settings, and a project's own .mastracode/database.json.\n  const settings = loadSettings();\n  const project = detectProject(process.cwd());\n  const storageConfig = getStorageConfig(project.rootPath, settings.storage, DEFAULT_CONFIG_DIR);\n\n  // A project .env can point storage elsewhere (startup honors it too), so say\n  // exactly what is about to be pruned before anything is deleted.\n  console.log(`Storage target: ${describeStorageTarget(storageConfig)}`);\n\n  const { storage, backend, warning } = await createStorage(storageConfig);\n  if (warning) console.log(warning);\n\n  let vector: MastraVector | undefined;\n  try {\n    // The libsql factory does not init (the PG path already has); init is\n    // coalesced, so tables are guaranteed to exist before we delete from them.\n    await storage.init();\n\n    const localDbFiles = resolveLocalDbFiles(storageConfig, backend);\n    if (localDbFiles.length > 0) {\n      console.log(`Database: ${localDbFiles.join(', ')}`);\n    }\n\n    // Only the local-libsql compaction needs the vector connection (its file\n    // swap refuses while any connection is open). Opening it otherwise would\n    // create mastra-vectors.db as a side effect.\n    if (vacuum && localDbFiles.length > 0) {\n      vector = await createVectorStore(storageConfig, backend);\n    }\n    const libsqlVector = vector instanceof LibSQLVector ? vector : undefined;\n\n    const maintenance = createStorageMaintenance({\n      storage,\n      backend,\n      retention: DEFAULT_RETENTION,\n      localDbFiles,\n      ...(libsqlVector ? { closeVector: () => libsqlVector.close() } : {}),\n    });\n\n    await runStorageMaintenance({ maintenance, vacuum, keepMemory, log: line => console.log(line) });\n    console.log('Storage maintenance complete.');\n    return 0;\n  } catch (err) {\n    console.error(`Storage maintenance failed: ${err instanceof Error ? err.message : String(err)}`);\n    // runStorageMaintenance closes storage on its success path. If it threw\n    // first, release the connections here so a retry isn't blocked by our own\n    // open handles. Best effort — the original failure is what matters.\n    try {\n      await storage.close?.();\n      if (vector instanceof LibSQLVector) await vector.close();\n    } catch {\n      // ignore cleanup errors\n    }\n    return 1;\n  }\n}\n\n/** Credential-free URL: drops userinfo and the query string (e.g. ?authToken=). */\nfunction redactUrl(raw: string): string {\n  try {\n    const url = new URL(raw);\n    url.username = '';\n    url.password = '';\n    url.search = '';\n    return url.toString();\n  } catch {\n    return '<unparseable URL>';\n  }\n}\n\nexport function describeStorageTarget(config: StorageConfig): string {\n  if (config.backend === 'libsql') {\n    return config.url.startsWith('file:')\n      ? `libsql file ${config.url.slice('file:'.length)}`\n      : `libsql ${redactUrl(config.url)}`;\n  }\n  if (config.connectionString) return `pg ${redactUrl(config.connectionString)}`;\n  const host = `${config.host ?? 'localhost'}${config.port ? `:${config.port}` : ''}`;\n  return `pg postgres://${host}/${config.database ?? ''}`;\n}\n"],"mappings":"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"}