clawmini 0.0.1

package/dist/workspace-CSgfo_2J.mjs

@@ -0,0 +1,383 @@
+import { t as __exportAll } from "./rolldown-runtime-95iHPtFO.mjs";
+import { n as pathIsInsideDir } from "./fs-B5wW0oaH.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import { execSync } from "node:child_process";
+import fs$1 from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { z } from "zod";
+
+//#region src/shared/config.ts
+const FallbackSchema = z.looseObject({
+	commands: z.looseObject({
+		new: z.string().optional(),
+		append: z.string().optional(),
+		getSessionId: z.string().optional(),
+		getMessageContent: z.string().optional()
+	}).optional(),
+	env: z.record(z.string(), z.union([z.string(), z.boolean()])).optional(),
+	retries: z.number().int().min(0).default(1),
+	delayMs: z.number().int().min(0).default(1e3)
+});
+const AgentSchema = z.looseObject({
+	commands: z.looseObject({
+		new: z.string().optional(),
+		append: z.string().optional(),
+		getSessionId: z.string().optional(),
+		getMessageContent: z.string().optional()
+	}).optional(),
+	env: z.record(z.string(), z.union([z.string(), z.boolean()])).optional(),
+	directory: z.string().optional(),
+	fallbacks: z.array(FallbackSchema).optional(),
+	files: z.string().default("./attachments").optional()
+});
+const CronJobSchema = z.looseObject({
+	id: z.string().min(1),
+	createdAt: z.string().optional(),
+	message: z.string().default(""),
+	reply: z.string().optional(),
+	agentId: z.string().optional(),
+	env: z.record(z.string(), z.union([z.string(), z.boolean()])).optional(),
+	session: z.looseObject({ type: z.string() }).optional(),
+	schedule: z.union([
+		z.looseObject({ cron: z.string() }),
+		z.looseObject({ every: z.string() }),
+		z.looseObject({ at: z.string() })
+	])
+});
+const ChatSettingsSchema = z.looseObject({
+	defaultAgent: z.string().optional(),
+	sessions: z.record(z.string(), z.string()).optional(),
+	routers: z.array(z.string()).optional(),
+	jobs: z.array(CronJobSchema).optional()
+});
+const AgentSessionSettingsSchema = z.looseObject({ env: z.record(z.string(), z.union([z.string(), z.boolean()])).optional() });
+const EnvironmentSchema = z.looseObject({
+	init: z.string().optional(),
+	up: z.string().optional(),
+	down: z.string().optional(),
+	prefix: z.string().optional(),
+	envFormat: z.string().optional(),
+	exportLiteTo: z.string().optional(),
+	env: z.record(z.string(), z.union([z.string(), z.boolean()])).optional()
+});
+const SettingsSchema = z.looseObject({
+	chats: z.looseObject({ defaultId: z.string().optional() }).optional(),
+	defaultAgent: AgentSchema.optional(),
+	environments: z.record(z.string(), z.string()).optional(),
+	routers: z.array(z.string()).optional(),
+	files: z.string().default("./attachments").optional(),
+	api: z.union([z.boolean(), z.looseObject({
+		host: z.string().optional(),
+		port: z.number().optional(),
+		proxy_host: z.string().optional()
+	})]).optional()
+});
+
+//#endregion
+//#region src/shared/workspace.ts
+var workspace_exports = /* @__PURE__ */ __exportAll({
+	applyTemplateToAgent: () => applyTemplateToAgent,
+	copyEnvironmentTemplate: () => copyEnvironmentTemplate,
+	copyTemplate: () => copyTemplate,
+	copyTemplateBase: () => copyTemplateBase,
+	deleteAgent: () => deleteAgent,
+	enableEnvironment: () => enableEnvironment,
+	ensureAgentWorkDir: () => ensureAgentWorkDir,
+	getActiveEnvironmentInfo: () => getActiveEnvironmentInfo,
+	getAgent: () => getAgent,
+	getAgentDir: () => getAgentDir,
+	getAgentSessionSettingsPath: () => getAgentSessionSettingsPath,
+	getAgentSettingsPath: () => getAgentSettingsPath,
+	getChatSettingsPath: () => getChatSettingsPath,
+	getClawminiDir: () => getClawminiDir,
+	getEnvironmentPath: () => getEnvironmentPath,
+	getSettingsPath: () => getSettingsPath,
+	getSocketPath: () => getSocketPath,
+	getWorkspaceRoot: () => getWorkspaceRoot,
+	isValidAgentId: () => isValidAgentId,
+	listAgents: () => listAgents,
+	readAgentSessionSettings: () => readAgentSessionSettings,
+	readChatSettings: () => readChatSettings,
+	readEnvironment: () => readEnvironment,
+	readSettings: () => readSettings,
+	resolveAgentWorkDir: () => resolveAgentWorkDir,
+	resolveEnvironmentTemplatePath: () => resolveEnvironmentTemplatePath,
+	resolveTemplatePath: () => resolveTemplatePath,
+	resolveTemplatePathBase: () => resolveTemplatePathBase,
+	writeAgentSessionSettings: () => writeAgentSessionSettings,
+	writeAgentSettings: () => writeAgentSettings,
+	writeChatSettings: () => writeChatSettings,
+	writeSettings: () => writeSettings
+});
+function getWorkspaceRoot(startDir = process.cwd()) {
+	let curr = startDir;
+	while (curr !== path.parse(curr).root) {
+		if (fs.existsSync(path.join(curr, ".clawmini"))) return curr;
+		if (fs.existsSync(path.join(curr, "package.json")) || fs.existsSync(path.join(curr, ".git"))) return curr;
+		curr = path.dirname(curr);
+	}
+	return startDir;
+}
+function resolveAgentWorkDir(agentId, customDir, startDir = process.cwd()) {
+	const workspaceRoot = getWorkspaceRoot(startDir);
+	const dirPath = customDir ? path.resolve(workspaceRoot, customDir) : path.resolve(workspaceRoot, agentId);
+	if (!pathIsInsideDir(dirPath, workspaceRoot, { allowSameDir: true })) throw new Error("Invalid agent directory: resolves outside the workspace.");
+	return dirPath;
+}
+async function ensureAgentWorkDir(agentId, customDir, startDir = process.cwd()) {
+	const dirPath = resolveAgentWorkDir(agentId, customDir, startDir);
+	if (!fs.existsSync(dirPath)) {
+		await fs$1.mkdir(dirPath, { recursive: true });
+		console.log(`Created agent working directory at ${dirPath}`);
+	}
+	return dirPath;
+}
+function getClawminiDir(startDir = process.cwd()) {
+	return path.join(getWorkspaceRoot(startDir), ".clawmini");
+}
+function getSocketPath(startDir = process.cwd()) {
+	return path.join(getClawminiDir(startDir), "server.sock");
+}
+function getSettingsPath(startDir = process.cwd()) {
+	return path.join(getClawminiDir(startDir), "settings.json");
+}
+function getChatSettingsPath(chatId, startDir = process.cwd()) {
+	return path.join(getClawminiDir(startDir), "chats", chatId, "settings.json");
+}
+function isValidAgentId(agentId) {
+	if (!agentId || agentId.length === 0) return false;
+	return /^[a-zA-Z0-9_]+(?:-[a-zA-Z0-9_]+)*$/.test(agentId);
+}
+function getAgentDir(agentId, startDir = process.cwd()) {
+	if (!isValidAgentId(agentId)) throw new Error(`Invalid agent ID: ${agentId}`);
+	return path.join(getClawminiDir(startDir), "agents", agentId);
+}
+function getAgentSettingsPath(agentId, startDir = process.cwd()) {
+	return path.join(getAgentDir(agentId, startDir), "settings.json");
+}
+function getAgentSessionSettingsPath(agentId, sessionId, startDir = process.cwd()) {
+	if (!isValidAgentId(agentId)) throw new Error(`Invalid agent ID: ${agentId}`);
+	return path.join(getClawminiDir(startDir), "agents", agentId, "sessions", sessionId, "settings.json");
+}
+async function readJsonFile(filePath) {
+	try {
+		const data = await fs$1.readFile(filePath, "utf-8");
+		return JSON.parse(data);
+	} catch {
+		return null;
+	}
+}
+async function writeJsonFile(filePath, data) {
+	const dir = path.dirname(filePath);
+	await fs$1.mkdir(dir, { recursive: true });
+	await fs$1.writeFile(filePath, JSON.stringify(data, null, 2), "utf-8");
+}
+async function readChatSettings(chatId, startDir = process.cwd()) {
+	const data = await readJsonFile(getChatSettingsPath(chatId, startDir));
+	if (!data) return null;
+	const parsed = ChatSettingsSchema.safeParse(data);
+	return parsed.success ? parsed.data : null;
+}
+async function writeChatSettings(chatId, data, startDir = process.cwd()) {
+	await writeJsonFile(getChatSettingsPath(chatId, startDir), data);
+}
+async function readAgentSessionSettings(agentId, sessionId, startDir = process.cwd()) {
+	const data = await readJsonFile(getAgentSessionSettingsPath(agentId, sessionId, startDir));
+	if (!data) return null;
+	const parsed = AgentSessionSettingsSchema.safeParse(data);
+	return parsed.success ? parsed.data : null;
+}
+async function writeAgentSessionSettings(agentId, sessionId, data, startDir = process.cwd()) {
+	await writeJsonFile(getAgentSessionSettingsPath(agentId, sessionId, startDir), data);
+}
+async function getAgent(agentId, startDir = process.cwd()) {
+	const filePath = getAgentSettingsPath(agentId, startDir);
+	let dataStr;
+	try {
+		dataStr = await fs$1.readFile(filePath, "utf-8");
+	} catch (err) {
+		if (err && typeof err === "object" && "code" in err && err.code === "ENOENT") return null;
+		throw err;
+	}
+	let data;
+	try {
+		data = JSON.parse(dataStr);
+	} catch (parseErr) {
+		const message = parseErr instanceof Error ? parseErr.message : String(parseErr);
+		throw new Error(`Invalid JSON in ${filePath}: ${message}`, { cause: parseErr });
+	}
+	const parsed = AgentSchema.safeParse(data);
+	if (!parsed.success) throw new Error(`Invalid schema in ${filePath}: ${parsed.error.message}`);
+	return parsed.data;
+}
+async function writeAgentSettings(agentId, data, startDir = process.cwd()) {
+	await ensureAgentWorkDir(agentId, data.directory, startDir);
+	await writeJsonFile(getAgentSettingsPath(agentId, startDir), data);
+}
+async function listAgents(startDir = process.cwd()) {
+	const agentsDir = path.join(getClawminiDir(startDir), "agents");
+	try {
+		const entries = await fs$1.readdir(agentsDir, { withFileTypes: true });
+		const agentIds = [];
+		for (const entry of entries) if (entry.isDirectory()) {
+			const settingsPath = path.join(agentsDir, entry.name, "settings.json");
+			try {
+				await fs$1.access(settingsPath);
+				agentIds.push(entry.name);
+			} catch {}
+		}
+		return agentIds;
+	} catch {
+		return [];
+	}
+}
+async function deleteAgent(agentId, startDir = process.cwd()) {
+	const dir = getAgentDir(agentId, startDir);
+	const agentsDir = path.join(getClawminiDir(startDir), "agents");
+	if (!pathIsInsideDir(dir, agentsDir)) throw new Error(`Security Error: Cannot delete agent directory outside of ${agentsDir}`);
+	try {
+		await fs$1.rm(dir, {
+			recursive: true,
+			force: true
+		});
+	} catch {}
+}
+async function isDirectory(dirPath) {
+	try {
+		return (await fs$1.stat(dirPath)).isDirectory();
+	} catch {
+		return false;
+	}
+}
+async function resolveTemplatePathBase(templateName, startDir = process.cwd()) {
+	const workspaceRoot = getWorkspaceRoot(startDir);
+	const localTemplatePath = path.join(workspaceRoot, ".clawmini", "templates", templateName);
+	if (await isDirectory(localTemplatePath)) return localTemplatePath;
+	let currentDir = path.dirname(fileURLToPath(import.meta.url));
+	while (currentDir !== path.parse(currentDir).root && !fs.existsSync(path.join(currentDir, "package.json"))) currentDir = path.dirname(currentDir);
+	const searchPath = path.join(currentDir, "templates", templateName);
+	if (await isDirectory(searchPath)) return searchPath;
+	throw new Error(`Template not found: ${templateName} (searched local: ${localTemplatePath}, built-in: ${searchPath})`);
+}
+async function resolveTemplatePath(templateName, startDir = process.cwd()) {
+	if (templateName === "environments" || templateName.startsWith("environments/")) throw new Error(`Template not found: ${templateName}`);
+	return resolveTemplatePathBase(templateName, startDir);
+}
+async function resolveEnvironmentTemplatePath(templateName, startDir = process.cwd()) {
+	return resolveTemplatePathBase(path.join("environments", templateName), startDir);
+}
+async function copyTemplateBase(templatePath, targetDir, allowMissingDir = false) {
+	try {
+		if ((await fs$1.readdir(targetDir)).length > 0) throw new Error(`Target directory is not empty: ${targetDir}`);
+	} catch (err) {
+		if (err && typeof err === "object" && "code" in err && err.code === "ENOENT") if (allowMissingDir) await fs$1.mkdir(targetDir, { recursive: true });
+		else throw new Error(`Target directory does not exist: ${targetDir}`, { cause: err });
+		else throw err;
+	}
+	await fs$1.cp(templatePath, targetDir, { recursive: true });
+}
+async function copyTemplate(templateName, targetDir, startDir = process.cwd()) {
+	await copyTemplateBase(await resolveTemplatePath(templateName, startDir), targetDir, false);
+}
+async function copyEnvironmentTemplate(templateName, targetDir, startDir = process.cwd()) {
+	await copyTemplateBase(await resolveEnvironmentTemplatePath(templateName, startDir), targetDir, true);
+}
+async function applyTemplateToAgent(agentId, templateName, overrides, startDir = process.cwd()) {
+	const agentWorkDir = resolveAgentWorkDir(agentId, overrides.directory, startDir);
+	await copyTemplate(templateName, agentWorkDir, startDir);
+	const settingsPath = path.join(agentWorkDir, "settings.json");
+	try {
+		const rawSettings = await fs$1.readFile(settingsPath, "utf-8");
+		const parsedSettings = JSON.parse(rawSettings);
+		const validation = AgentSchema.safeParse(parsedSettings);
+		if (validation.success) {
+			const templateData = validation.data;
+			if (templateData.directory) {
+				console.warn(`Warning: Ignoring 'directory' field from template settings.json. Using default or provided directory.`);
+				delete templateData.directory;
+			}
+			const mergedEnv = {
+				...templateData.env || {},
+				...overrides.env || {}
+			};
+			const mergedData = {
+				...templateData,
+				...overrides
+			};
+			if (Object.keys(mergedEnv).length > 0) mergedData.env = mergedEnv;
+			await writeAgentSettings(agentId, mergedData, startDir);
+		}
+	} catch {} finally {
+		try {
+			await fs$1.rm(settingsPath);
+		} catch {}
+	}
+}
+async function readSettings(startDir = process.cwd()) {
+	const data = await readJsonFile(getSettingsPath(startDir));
+	if (!data) return null;
+	const parsed = SettingsSchema.safeParse(data);
+	return parsed.success ? parsed.data : null;
+}
+async function writeSettings(data, startDir = process.cwd()) {
+	await writeJsonFile(getSettingsPath(startDir), data);
+}
+function getEnvironmentPath(name, startDir = process.cwd()) {
+	return path.join(getClawminiDir(startDir), "environments", name);
+}
+async function readEnvironment(name, startDir = process.cwd()) {
+	const data = await readJsonFile(path.join(getEnvironmentPath(name, startDir), "env.json"));
+	if (!data) return null;
+	const parsed = EnvironmentSchema.safeParse(data);
+	return parsed.success ? parsed.data : null;
+}
+async function getActiveEnvironmentInfo(targetPath, startDir = process.cwd()) {
+	const settings = await readSettings(startDir);
+	if (!settings?.environments) return null;
+	const workspaceRoot = getWorkspaceRoot(startDir);
+	const resolvedTarget = path.resolve(workspaceRoot, targetPath);
+	let bestMatch = null;
+	let maxDepth = -1;
+	for (const [envPath, envName] of Object.entries(settings.environments)) {
+		const resolvedEnvPath = path.resolve(workspaceRoot, envPath);
+		if (pathIsInsideDir(resolvedTarget, resolvedEnvPath, { allowSameDir: true })) {
+			const depth = resolvedEnvPath.split(path.sep).length;
+			if (depth > maxDepth) {
+				maxDepth = depth;
+				bestMatch = {
+					name: envName,
+					targetPath: resolvedEnvPath
+				};
+			}
+		}
+	}
+	return bestMatch;
+}
+async function enableEnvironment(name, targetPath = "./", startDir = process.cwd()) {
+	const targetDir = getEnvironmentPath(name, startDir);
+	if (!fs.existsSync(targetDir)) {
+		await copyEnvironmentTemplate(name, targetDir, startDir);
+		console.log(`Copied environment template '${name}'.`);
+	} else console.log(`Environment template '${name}' already exists in workspace.`);
+	const settings = await readSettings(startDir) || { chats: { defaultId: "" } };
+	const environments = settings.environments || {};
+	environments[targetPath] = name;
+	settings.environments = environments;
+	await writeSettings(settings, startDir);
+	console.log(`Enabled environment '${name}' for path '${targetPath}'.`);
+	const envConfig = await readEnvironment(name, startDir);
+	if (envConfig?.init) {
+		const workspaceRoot = getWorkspaceRoot(startDir);
+		const affectedDir = path.resolve(workspaceRoot, targetPath);
+		console.log(`Executing init command for environment '${name}': ${envConfig.init}`);
+		execSync(envConfig.init, {
+			cwd: affectedDir,
+			stdio: "inherit"
+		});
+	}
+}
+
+//#endregion
+export { SettingsSchema as C, CronJobSchema as S, workspace_exports as _, getAgent as a, writeChatSettings as b, getSettingsPath as c, isValidAgentId as d, listAgents as f, readSettings as g, readEnvironment as h, getActiveEnvironmentInfo as i, getSocketPath as l, readChatSettings as m, deleteAgent as n, getClawminiDir as o, readAgentSessionSettings as p, enableEnvironment as r, getEnvironmentPath as s, applyTemplateToAgent as t, getWorkspaceRoot as u, writeAgentSessionSettings as v, writeSettings as x, writeAgentSettings as y };
+//# sourceMappingURL=workspace-CSgfo_2J.mjs.map

package/dist/workspace-CSgfo_2J.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-CSgfo_2J.mjs","names":["fsPromises"],"sources":["../src/shared/config.ts","../src/shared/workspace.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport const FallbackSchema = z.looseObject({\n  commands: z\n    .looseObject({\n      new: z.string().optional(),\n      append: z.string().optional(),\n      getSessionId: z.string().optional(),\n      getMessageContent: z.string().optional(),\n    })\n    .optional(),\n  env: z.record(z.string(), z.union([z.string(), z.boolean()])).optional(),\n  retries: z.number().int().min(0).default(1),\n  delayMs: z.number().int().min(0).default(1000),\n});\n\nexport const AgentSchema = z.looseObject({\n  commands: z\n    .looseObject({\n      new: z.string().optional(),\n      append: z.string().optional(),\n      getSessionId: z.string().optional(),\n      getMessageContent: z.string().optional(),\n    })\n    .optional(),\n  env: z.record(z.string(), z.union([z.string(), z.boolean()])).optional(),\n  directory: z.string().optional(),\n  fallbacks: z.array(FallbackSchema).optional(),\n  files: z.string().default('./attachments').optional(),\n});\n\nexport type Agent = z.infer<typeof AgentSchema>;\n\nexport const CronJobSchema = z.looseObject({\n  id: z.string().min(1),\n  createdAt: z.string().optional(),\n  message: z.string().default(''),\n  reply: z.string().optional(),\n  agentId: z.string().optional(),\n  env: z.record(z.string(), z.union([z.string(), z.boolean()])).optional(),\n  session: z.looseObject({ type: z.string() }).optional(),\n  schedule: z.union([\n    z.looseObject({ cron: z.string() }),\n    z.looseObject({ every: z.string() }),\n    z.looseObject({ at: z.string() }),\n  ]),\n});\n\nexport type CronJob = z.infer<typeof CronJobSchema>;\n\nexport const ChatSettingsSchema = z.looseObject({\n  defaultAgent: z.string().optional(),\n  sessions: z.record(z.string(), z.string()).optional(),\n  routers: z.array(z.string()).optional(),\n  jobs: z.array(CronJobSchema).optional(),\n});\n\nexport type ChatSettings = z.infer<typeof ChatSettingsSchema>;\n\nexport const AgentSessionSettingsSchema = z.looseObject({\n  env: z.record(z.string(), z.union([z.string(), z.boolean()])).optional(),\n});\n\nexport type AgentSessionSettings = z.infer<typeof AgentSessionSettingsSchema>;\n\nexport const EnvironmentSchema = z.looseObject({\n  init: z.string().optional(),\n  up: z.string().optional(),\n  down: z.string().optional(),\n  prefix: z.string().optional(),\n  envFormat: z.string().optional(),\n  exportLiteTo: z.string().optional(),\n  env: z.record(z.string(), z.union([z.string(), z.boolean()])).optional(),\n});\n\nexport type Environment = z.infer<typeof EnvironmentSchema>;\n\nexport const SettingsSchema = z.looseObject({\n  chats: z\n    .looseObject({\n      defaultId: z.string().optional(),\n    })\n    .optional(),\n  defaultAgent: AgentSchema.optional(),\n  environments: z.record(z.string(), z.string()).optional(),\n  routers: z.array(z.string()).optional(),\n  files: z.string().default('./attachments').optional(),\n  api: z\n    .union([\n      z.boolean(),\n      z.looseObject({\n        host: z.string().optional(),\n        port: z.number().optional(),\n        proxy_host: z.string().optional(),\n      }),\n    ])\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","/* eslint-disable max-lines */\nimport { execSync } from 'node:child_process';\nimport fs from 'node:fs';\nimport fsPromises from 'node:fs/promises';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport {\n  type Agent,\n  AgentSchema,\n  type ChatSettings,\n  ChatSettingsSchema,\n  type AgentSessionSettings,\n  AgentSessionSettingsSchema,\n  type Environment,\n  EnvironmentSchema,\n  type Settings,\n  SettingsSchema,\n} from './config.js';\nimport { pathIsInsideDir } from './utils/fs.js';\n\nexport function getWorkspaceRoot(startDir = process.cwd()): string {\n  let curr = startDir;\n  while (curr !== path.parse(curr).root) {\n    if (fs.existsSync(path.join(curr, '.clawmini'))) {\n      return curr;\n    }\n    if (fs.existsSync(path.join(curr, 'package.json')) || fs.existsSync(path.join(curr, '.git'))) {\n      return curr;\n    }\n    curr = path.dirname(curr);\n  }\n  return startDir;\n}\n\nexport function resolveAgentWorkDir(\n  agentId: string,\n  customDir?: string,\n  startDir = process.cwd()\n): string {\n  const workspaceRoot = getWorkspaceRoot(startDir);\n  const dirPath = customDir\n    ? path.resolve(workspaceRoot, customDir)\n    : path.resolve(workspaceRoot, agentId);\n\n  if (!pathIsInsideDir(dirPath, workspaceRoot, { allowSameDir: true })) {\n    throw new Error('Invalid agent directory: resolves outside the workspace.');\n  }\n\n  return dirPath;\n}\n\nexport async function ensureAgentWorkDir(\n  agentId: string,\n  customDir?: string,\n  startDir = process.cwd()\n): Promise<string> {\n  const dirPath = resolveAgentWorkDir(agentId, customDir, startDir);\n\n  if (!fs.existsSync(dirPath)) {\n    await fsPromises.mkdir(dirPath, { recursive: true });\n    console.log(`Created agent working directory at ${dirPath}`);\n  }\n  return dirPath;\n}\n\nexport function getClawminiDir(startDir = process.cwd()): string {\n  return path.join(getWorkspaceRoot(startDir), '.clawmini');\n}\n\nexport function getSocketPath(startDir = process.cwd()): string {\n  return path.join(getClawminiDir(startDir), 'server.sock');\n}\n\nexport function getSettingsPath(startDir = process.cwd()): string {\n  return path.join(getClawminiDir(startDir), 'settings.json');\n}\n\nexport function getChatSettingsPath(chatId: string, startDir = process.cwd()): string {\n  return path.join(getClawminiDir(startDir), 'chats', chatId, 'settings.json');\n}\n\nexport function isValidAgentId(agentId: string): boolean {\n  if (!agentId || agentId.length === 0) return false;\n  return /^[a-zA-Z0-9_]+(?:-[a-zA-Z0-9_]+)*$/.test(agentId);\n}\n\nexport function getAgentDir(agentId: string, startDir = process.cwd()): string {\n  if (!isValidAgentId(agentId)) {\n    throw new Error(`Invalid agent ID: ${agentId}`);\n  }\n  return path.join(getClawminiDir(startDir), 'agents', agentId);\n}\n\nexport function getAgentSettingsPath(agentId: string, startDir = process.cwd()): string {\n  return path.join(getAgentDir(agentId, startDir), 'settings.json');\n}\n\nexport function getAgentSessionSettingsPath(\n  agentId: string,\n  sessionId: string,\n  startDir = process.cwd()\n): string {\n  if (!isValidAgentId(agentId)) {\n    throw new Error(`Invalid agent ID: ${agentId}`);\n  }\n  return path.join(\n    getClawminiDir(startDir),\n    'agents',\n    agentId,\n    'sessions',\n    sessionId,\n    'settings.json'\n  );\n}\n\nasync function readJsonFile(filePath: string): Promise<Record<string, unknown> | null> {\n  try {\n    const data = await fsPromises.readFile(filePath, 'utf-8');\n    return JSON.parse(data) as Record<string, unknown>;\n  } catch {\n    return null;\n  }\n}\n\nasync function writeJsonFile(filePath: string, data: Record<string, unknown>): Promise<void> {\n  const dir = path.dirname(filePath);\n  await fsPromises.mkdir(dir, { recursive: true });\n  await fsPromises.writeFile(filePath, JSON.stringify(data, null, 2), 'utf-8');\n}\n\nexport async function readChatSettings(\n  chatId: string,\n  startDir = process.cwd()\n): Promise<ChatSettings | null> {\n  const data = await readJsonFile(getChatSettingsPath(chatId, startDir));\n  if (!data) return null;\n  const parsed = ChatSettingsSchema.safeParse(data);\n  return parsed.success ? parsed.data : null;\n}\n\nexport async function writeChatSettings(\n  chatId: string,\n  data: ChatSettings,\n  startDir = process.cwd()\n): Promise<void> {\n  await writeJsonFile(getChatSettingsPath(chatId, startDir), data as Record<string, unknown>);\n}\n\nexport async function readAgentSessionSettings(\n  agentId: string,\n  sessionId: string,\n  startDir = process.cwd()\n): Promise<AgentSessionSettings | null> {\n  const data = await readJsonFile(getAgentSessionSettingsPath(agentId, sessionId, startDir));\n  if (!data) return null;\n  const parsed = AgentSessionSettingsSchema.safeParse(data);\n  return parsed.success ? parsed.data : null;\n}\n\nexport async function writeAgentSessionSettings(\n  agentId: string,\n  sessionId: string,\n  data: AgentSessionSettings,\n  startDir = process.cwd()\n): Promise<void> {\n  await writeJsonFile(\n    getAgentSessionSettingsPath(agentId, sessionId, startDir),\n    data as Record<string, unknown>\n  );\n}\n\nexport async function getAgent(agentId: string, startDir = process.cwd()): Promise<Agent | null> {\n  const filePath = getAgentSettingsPath(agentId, startDir);\n  let dataStr: string;\n  try {\n    dataStr = await fsPromises.readFile(filePath, 'utf-8');\n  } catch (err: unknown) {\n    if (err && typeof err === 'object' && 'code' in err && err.code === 'ENOENT') return null;\n    throw err;\n  }\n\n  let data: unknown;\n  try {\n    data = JSON.parse(dataStr);\n  } catch (parseErr: unknown) {\n    const message = parseErr instanceof Error ? parseErr.message : String(parseErr);\n    throw new Error(`Invalid JSON in ${filePath}: ${message}`, { cause: parseErr });\n  }\n\n  const parsed = AgentSchema.safeParse(data);\n  if (!parsed.success) {\n    throw new Error(`Invalid schema in ${filePath}: ${parsed.error.message}`);\n  }\n  return parsed.data;\n}\n\nexport async function writeAgentSettings(\n  agentId: string,\n  data: Agent,\n  startDir = process.cwd()\n): Promise<void> {\n  await ensureAgentWorkDir(agentId, data.directory, startDir);\n  await writeJsonFile(getAgentSettingsPath(agentId, startDir), data as Record<string, unknown>);\n}\n\nexport async function listAgents(startDir = process.cwd()): Promise<string[]> {\n  const agentsDir = path.join(getClawminiDir(startDir), 'agents');\n  try {\n    const entries = await fsPromises.readdir(agentsDir, { withFileTypes: true });\n    const agentIds = [];\n    for (const entry of entries) {\n      if (entry.isDirectory()) {\n        const settingsPath = path.join(agentsDir, entry.name, 'settings.json');\n        try {\n          await fsPromises.access(settingsPath);\n          agentIds.push(entry.name);\n        } catch {\n          // No settings.json, probably just a sessions dir for a non-existent agent or default agent\n        }\n      }\n    }\n    return agentIds;\n  } catch {\n    return [];\n  }\n}\n\nexport async function deleteAgent(agentId: string, startDir = process.cwd()): Promise<void> {\n  const dir = getAgentDir(agentId, startDir);\n  const agentsDir = path.join(getClawminiDir(startDir), 'agents');\n\n  if (!pathIsInsideDir(dir, agentsDir)) {\n    throw new Error(`Security Error: Cannot delete agent directory outside of ${agentsDir}`);\n  }\n\n  try {\n    await fsPromises.rm(dir, { recursive: true, force: true });\n  } catch {\n    // Ignore if not found\n  }\n}\n\nasync function isDirectory(dirPath: string): Promise<boolean> {\n  try {\n    const stat = await fsPromises.stat(dirPath);\n    return stat.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nexport async function resolveTemplatePathBase(\n  templateName: string,\n  startDir = process.cwd()\n): Promise<string> {\n  const workspaceRoot = getWorkspaceRoot(startDir);\n  const localTemplatePath = path.join(workspaceRoot, '.clawmini', 'templates', templateName);\n\n  if (await isDirectory(localTemplatePath)) {\n    return localTemplatePath;\n  }\n\n  // Fallback to built-in templates\n  // Find the clawmini package root by looking for package.json\n  let currentDir = path.dirname(fileURLToPath(import.meta.url));\n  while (\n    currentDir !== path.parse(currentDir).root &&\n    !fs.existsSync(path.join(currentDir, 'package.json'))\n  ) {\n    currentDir = path.dirname(currentDir);\n  }\n\n  const searchPath = path.join(currentDir, 'templates', templateName);\n\n  if (await isDirectory(searchPath)) {\n    return searchPath;\n  }\n\n  throw new Error(\n    `Template not found: ${templateName} (searched local: ${localTemplatePath}, built-in: ${searchPath})`\n  );\n}\n\nexport async function resolveTemplatePath(\n  templateName: string,\n  startDir = process.cwd()\n): Promise<string> {\n  if (templateName === 'environments' || templateName.startsWith('environments/')) {\n    throw new Error(`Template not found: ${templateName}`);\n  }\n  return resolveTemplatePathBase(templateName, startDir);\n}\n\nexport async function resolveEnvironmentTemplatePath(\n  templateName: string,\n  startDir = process.cwd()\n): Promise<string> {\n  return resolveTemplatePathBase(path.join('environments', templateName), startDir);\n}\n\nexport async function copyTemplateBase(\n  templatePath: string,\n  targetDir: string,\n  allowMissingDir: boolean = false\n): Promise<void> {\n  // Check if target directory exists and is not empty\n  try {\n    const entries = await fsPromises.readdir(targetDir);\n    if (entries.length > 0) {\n      throw new Error(`Target directory is not empty: ${targetDir}`);\n    }\n  } catch (err: unknown) {\n    if (err && typeof err === 'object' && 'code' in err && err.code === 'ENOENT') {\n      if (allowMissingDir) {\n        await fsPromises.mkdir(targetDir, { recursive: true });\n      } else {\n        throw new Error(`Target directory does not exist: ${targetDir}`, { cause: err });\n      }\n    } else {\n      throw err;\n    }\n  }\n\n  // Recursively copy\n  await fsPromises.cp(templatePath, targetDir, { recursive: true });\n}\n\nexport async function copyTemplate(\n  templateName: string,\n  targetDir: string,\n  startDir = process.cwd()\n): Promise<void> {\n  const templatePath = await resolveTemplatePath(templateName, startDir);\n  await copyTemplateBase(templatePath, targetDir, false);\n}\n\nexport async function copyEnvironmentTemplate(\n  templateName: string,\n  targetDir: string,\n  startDir = process.cwd()\n): Promise<void> {\n  const templatePath = await resolveEnvironmentTemplatePath(templateName, startDir);\n  await copyTemplateBase(templatePath, targetDir, true);\n}\n\nexport async function applyTemplateToAgent(\n  agentId: string,\n  templateName: string,\n  overrides: Agent,\n  startDir = process.cwd()\n): Promise<void> {\n  const agentWorkDir = resolveAgentWorkDir(agentId, overrides.directory, startDir);\n  await copyTemplate(templateName, agentWorkDir, startDir);\n\n  const settingsPath = path.join(agentWorkDir, 'settings.json');\n  try {\n    const rawSettings = await fsPromises.readFile(settingsPath, 'utf-8');\n    const parsedSettings = JSON.parse(rawSettings);\n    const validation = AgentSchema.safeParse(parsedSettings);\n\n    if (validation.success) {\n      const templateData = validation.data;\n      if (templateData.directory) {\n        console.warn(\n          `Warning: Ignoring 'directory' field from template settings.json. Using default or provided directory.`\n        );\n        delete templateData.directory;\n      }\n\n      // Merge: overrides take precedence over templateData\n      const mergedEnv = { ...(templateData.env || {}), ...(overrides.env || {}) };\n      const mergedData: Agent = { ...templateData, ...overrides };\n      if (Object.keys(mergedEnv).length > 0) {\n        mergedData.env = mergedEnv;\n      }\n\n      await writeAgentSettings(agentId, mergedData, startDir);\n    }\n  } catch {\n    // Ignore parsing or file not found errors\n  } finally {\n    try {\n      await fsPromises.rm(settingsPath);\n    } catch {\n      // Ignore if it doesn't exist\n    }\n  }\n}\n\nexport async function readSettings(startDir = process.cwd()): Promise<Settings | null> {\n  const data = await readJsonFile(getSettingsPath(startDir));\n  if (!data) return null;\n  const parsed = SettingsSchema.safeParse(data);\n  return parsed.success ? parsed.data : null;\n}\n\nexport async function writeSettings(data: Settings, startDir = process.cwd()): Promise<void> {\n  await writeJsonFile(getSettingsPath(startDir), data as Record<string, unknown>);\n}\n\nexport function getEnvironmentPath(name: string, startDir = process.cwd()): string {\n  return path.join(getClawminiDir(startDir), 'environments', name);\n}\n\nexport async function readEnvironment(\n  name: string,\n  startDir = process.cwd()\n): Promise<Environment | null> {\n  const data = await readJsonFile(path.join(getEnvironmentPath(name, startDir), 'env.json'));\n  if (!data) return null;\n  const parsed = EnvironmentSchema.safeParse(data);\n  return parsed.success ? parsed.data : null;\n}\n\nexport async function getActiveEnvironmentInfo(\n  targetPath: string,\n  startDir = process.cwd()\n): Promise<{ name: string; targetPath: string } | null> {\n  const settings = await readSettings(startDir);\n  if (!settings?.environments) return null;\n\n  const workspaceRoot = getWorkspaceRoot(startDir);\n  const resolvedTarget = path.resolve(workspaceRoot, targetPath);\n\n  let bestMatch: { name: string; targetPath: string } | null = null;\n  let maxDepth = -1;\n\n  for (const [envPath, envName] of Object.entries(settings.environments)) {\n    const resolvedEnvPath = path.resolve(workspaceRoot, envPath);\n\n    if (pathIsInsideDir(resolvedTarget, resolvedEnvPath, { allowSameDir: true })) {\n      const depth = resolvedEnvPath.split(path.sep).length;\n      if (depth > maxDepth) {\n        maxDepth = depth;\n        bestMatch = { name: envName, targetPath: resolvedEnvPath };\n      }\n    }\n  }\n\n  return bestMatch;\n}\n\nexport async function getActiveEnvironmentName(\n  targetPath: string,\n  startDir = process.cwd()\n): Promise<string | null> {\n  const info = await getActiveEnvironmentInfo(targetPath, startDir);\n  return info ? info.name : null;\n}\n\nexport async function enableEnvironment(\n  name: string,\n  targetPath: string = './',\n  startDir = process.cwd()\n): Promise<void> {\n  const targetDir = getEnvironmentPath(name, startDir);\n\n  // Copy template to targetDir if it does not already exist\n  if (!fs.existsSync(targetDir)) {\n    await copyEnvironmentTemplate(name, targetDir, startDir);\n    console.log(`Copied environment template '${name}'.`);\n  } else {\n    console.log(`Environment template '${name}' already exists in workspace.`);\n  }\n\n  const settings = (await readSettings(startDir)) || { chats: { defaultId: '' } };\n  const environments = settings.environments || {};\n\n  environments[targetPath] = name;\n  settings.environments = environments;\n\n  await writeSettings(settings, startDir);\n  console.log(`Enabled environment '${name}' for path '${targetPath}'.`);\n\n  // Execute init command if present\n  const envConfig = await readEnvironment(name, startDir);\n  if (envConfig?.init) {\n    // Get the target directory for the environment\n    const workspaceRoot = getWorkspaceRoot(startDir);\n    const affectedDir = path.resolve(workspaceRoot, targetPath);\n    console.log(`Executing init command for environment '${name}': ${envConfig.init}`);\n    execSync(envConfig.init, { cwd: affectedDir, stdio: 'inherit' });\n  }\n}\n"],"mappings":"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"}

package/docs/01_chats/development_log.md

@@ -0,0 +1,36 @@
+# Development Log
+
+## Step 1: Core Chat Data Types & Storage Utilities
+
+- Implemented `src/shared/chats.ts` with `UserMessage`, `CommandLogMessage`, and file utilities.
+- Implemented unit tests in `src/shared/chats.test.ts`.
+
+## Step 2: Daemon Concurrency & Execution Logic
+
+- Added `handleUserMessage` in `src/daemon/queue.ts` which uses a queue-per-directory concurrency control.
+- Updated `sendMessage` in `src/daemon/router.ts` to call `handleUserMessage` with the default chat if none is provided.
+- Added test coverage in `src/daemon/queue.test.ts` for directory-based execution sequences and failure logging without halting.
+
+## Step 3: CLI Chat Management Commands
+
+- Created `src/cli/commands/chats.ts` with `list`, `add`, `delete`, and `set-default` commands using commander.
+- Registered the new `chatsCmd` in `src/cli/index.ts`.
+- Implemented comprehensive E2E tests in `src/cli/e2e.test.ts` for chat creation, listing, setting default, and deletion in a sandbox environment.
+- Fixed a typescript `any` issue in `src/shared/chats.ts`.
+- Validated logic by running all types, lints, and vitest passes successfully.
+
+## Step 4: CLI Messaging and History Commands
+
+- Updated `messages send` command in `src/cli/commands/messages.ts` to support routing via `--chat <id>`.
+- Implemented `messages tail` command to view history of a given chat id, with support for human-readable output and `--json` raw JSONL output.
+- Fixed TypeScript warnings (unexpected any) in `src/daemon/queue.ts` and `src/daemon/queue.test.ts`.
+- Wrote full E2E test coverage in `src/cli/e2e.test.ts` for sending to specific chats and verifying historical output via tail.
+
+## Step 5: Background Messaging
+
+- Updated `src/daemon/queue.ts` to accept a `noWait` argument, so the daemon immediately returns without awaiting task completion when set.
+- Updated the TRPC mutation in `src/daemon/router.ts` to accept a boolean `noWait` flag and forward it.
+- Updated `src/cli/commands/messages.ts` with a `--no-wait` flag using `commander`.
+- Verified behavior with an added E2E test in `src/cli/e2e.test.ts` that runs commands effectively without halting the client process.
+- Fixed a bug where `[USER]` messages were logged before previous queue items finished executing. `[USER]` messages are now appended inside the queue task to guarantee atomic execution ordering.
+- Added E2E test to verify correct atomic ordering of `[USER]` and `[LOG]` outputs with the `--no-wait` flag.

package/docs/01_chats/notes.md

@@ -0,0 +1,27 @@
+# Notes for Chats Feature
+
+## Current State of the Codebase
+- **Initialization:** `clawmini init` sets up a workspace by creating a `.clawmini` directory and a `settings.json` file. The settings file currently has a minimal structure: `{ "defaultAgent": { "commands": { "new": "echo $CLAW_CLI_MESSAGE" }, "env": {} } }`.
+- **Client:** The CLI provides `clawmini messages send <message>`. This command communicates with a local background daemon via tRPC over a UNIX domain socket.
+- **Daemon Router:** The daemon receives the message, reads `settings.json`, and spawns the command configured in `defaultAgent.commands.new`. The message is passed securely via the `CLAW_CLI_MESSAGE` environment variable.
+- **Missing functionality:** There is no notion of multiple separate chats, no local storage of history, and commands are simply spawned immediately without any directory-based concurrency control.
+
+## Feature Requirements
+1. **Chat Management:**
+   - `clawmini chats` with subcommands: `list`, `add <id>`, `delete <id>`.
+   - Users create IDs for chats.
+   - Set a default chat ID automatically, user can update it with `set-default`.
+2. **Message Sending & Viewing:**
+   - `clawmini messages send <message> [--chat <id>]`
+   - `clawmini messages tail [-n NUM] [--json] [--chat <id>]`
+   - Use a default chat if `--chat` is not specified.
+   - `tail` should have a nicely formatted text output by default, and a `--json` flag for raw data.
+3. **Storage:**
+   - Chat history saved in `.clawmini/chats/<id>/chat.jsonl`.
+   - Each line is a JSON object representing a message (either sent by user or the response from the command).
+   - Schema ideas: 
+     - User Input: `{ "role": "user", "content": "..." }`
+     - Command Output: `{ "role": "log", "content": "<stdout>", "stderr": "<stderr>", "timestamp": "...", "command": "...", "cwd": "..." }`
+4. **Daemon Internals:**
+   - A new core function: `handleUserMessage(chat-id, message, settings) -> Promise<{command, directory, envvars}>`.
+   - Directory-based concurrency constraint: `handleUserMessage` must wait to resolve until any previously running command in the *same directory* has finished.

package/docs/01_chats/prd.md

@@ -0,0 +1,47 @@
+# Product Requirements Document: Chats Feature
+
+## 1. Vision
+To enhance the `clawmini` CLI by introducing persistent, multi-session chat capabilities. Users will be able to manage multiple distinct conversation threads (chats) natively within the CLI, persist command histories locally, and execute background tasks safely with directory-based concurrency controls.
+
+## 2. Product/Market Background
+Currently, the `clawmini` tool is stateless from the perspective of user interactions. Users can send messages to a background daemon, which blindly executes a configured command. There's no way to maintain context, separate different workflows, or review the history of interactions. By introducing the concept of "chats," `clawmini` evolves into a stateful, interactive tool capable of managing complex, iterative tasks seamlessly. 
+
+## 3. Use Cases
+1. **Context Separation:** A developer wants to maintain separate interaction histories for different tasks (e.g., "debugging-auth" vs. "writing-tests"). They can create different chats for each task.
+2. **History Review:** A user wants to review what commands were generated and executed, along with their outputs, from a previous session. They can use the `messages tail` command to see the history.
+3. **Safe Concurrency:** A user sends multiple messages rapidly that trigger commands in the same project directory. The system automatically queues these commands to prevent race conditions or file lock issues, ensuring they run sequentially. If a command fails, subsequent commands still run, and failure logs are preserved in the history.
+4. **Resilience and Auditing:** If a background daemon restarts or a user closes their terminal, the state is preserved in local files, allowing workflows to resume or be audited later.
+
+## 4. Requirements
+
+### 4.1. Chat Management
+*   **`clawmini chats list`**: Displays all existing chats.
+*   **`clawmini chats add <id>`**: Creates a new chat with the specified identifier.
+*   **`clawmini chats delete <id>`**: Removes the chat and its associated history.
+*   **`clawmini chats set-default <id>`**: Updates the globally configured default chat for the workspace.
+*   **Default Chat**: The system should automatically initialize a default chat (e.g., `default`) when no chats exist.
+
+### 4.2. Messaging and History
+*   **`clawmini messages send <message> [--chat <id>]`**: Sends a message to a specific chat. If `--chat` is omitted, it targets the default chat.
+*   **`clawmini messages tail [-n NUM] [--json] [--chat <id>]`**: Displays the most recent messages in a chat. 
+    *   `-n NUM`: Limits the output to the last NUM messages (default: all or a sensible limit like 20).
+    *   `--json`: Outputs the raw JSONL data instead of human-readable formatted text.
+*   **Storage**: 
+    *   Chat logs must be stored in `.clawmini/chats/<id>/chat.jsonl`.
+    *   Messages are appended as individual JSON objects.
+*   **Schema**:
+    *   **User Message**: `{ "role": "user", "content": "<message>", "timestamp": "<ISO8601>" }`
+    *   **Command Output**: `{ "role": "log", "content": "<stdout>", "stderr": "<stderr>", "timestamp": "<ISO8601>", "command": "<executed-cmd>", "cwd": "<working-dir>", "exitCode": <number> }`
+
+### 4.3. Daemon Internals & Concurrency Control
+*   **`handleUserMessage(chatId, message, settings)`**: A new core function in the daemon router responsible for processing incoming messages.
+*   **Execution Strategy**:
+    *   The daemon must resolve the command, working directory, and environment variables based on the message and settings.
+    *   The daemon must maintain a queue or lock mechanism based on the target execution directory (`cwd`).
+    *   A command must not start executing until all prior commands queued for the same directory have finished (either succeeded or failed).
+*   **Error Handling**: If a command exits with a non-zero code, it does *not* halt the queue for that directory. The next command in the queue proceeds. The failure must be recorded in the `chat.jsonl` log as a `{ role: "log" }` entry containing the exit code and stderr.
+
+## 5. Security, Privacy, and Accessibility Concerns
+*   **Security**: Command execution must continue to safely pass user input via environment variables (`CLAW_CLI_MESSAGE`) or other safe mechanisms to prevent shell injection attacks.
+*   **Privacy**: Chat histories are stored completely locally in `.clawmini/chats/` within the user's workspace. No data is sent to external servers by default (unless explicitly configured by the user in `settings.json` command hooks).
+*   **Accessibility**: The CLI output (specifically `messages tail`) should be formatted with clear visual distinctions (e.g., colors or prefixes) between user inputs and system logs to improve readability for terminal users.

package/docs/01_chats/questions.md

@@ -0,0 +1,19 @@
+# Questions and Answers
+
+## Question 1
+
+**Q:** When the `--chat <id>` flag is omitted, how is the default chat determined? Should we always fall back to a built-in ID like `default` that is created automatically, or should it be the most recently used/created chat?
+
+**A:** Let's have a default ID that is created automatically, but the user can change with `set-default`.
+
+## Question 2
+
+**Q:** Should the user's input `message` and the command's response both be stored in `.clawmini/chats/<id>/chat.jsonl`? If so, what should the basic schema look like for those JSON objects? For instance, `{ "role": "user", "content": "..." }` and `{ "role": "system", "content": "stdout/stderr of command" }`?
+
+**A:** Yes, exactly. let's call outputs from the command `{role: "log", content: <stdout>, stderr: <stderr>}`. Also think about other relevant info we should store like timestamps, the chat-id + command + directory chosen, etc.
+
+## Question 3
+
+**Q:** For the directory-based concurrency limit (waiting for previous commands in the same directory to finish), what should happen if a previous command fails (exits with a non-zero code)? Should the next command in the queue still execute, or should it be aborted/rejected?
+
+**A:** It should still execute. If a command fails, a `{role: log}` message should be added to the queue with notes about the failure.

package/docs/01_chats/tickets.md

@@ -0,0 +1,67 @@
+# Implementation Tickets: Chats Feature
+
+## Step 1: Core Chat Data Types & Storage Utilities
+**Description**: Define the core data structures for chats and messages, and implement the file-system utilities to read/write chat history in JSONL format.
+**Tasks**:
+- Define TypeScript interfaces for `UserMessage` and `CommandLogMessage` based on the PRD schema.
+- Implement storage utilities (e.g., in `src/shared/chats.ts`) for managing `.clawmini/chats/<id>/chat.jsonl`.
+- Functions needed: `createChat(id)`, `listChats()`, `deleteChat(id)`, `appendMessage(id, message)`, `getMessages(id, limit)`.
+- Implement global default chat tracking (e.g., in `settings.json` or a separate state file).
+**Verification**:
+- Write unit tests verifying JSONL reading/writing (appending correctly, parsing correctly).
+- Write unit tests for directory creation and deletion for chats.
+- Run type-checking (`tsc`) and linter.
+**Status**: complete
+
+## Step 2: Daemon Concurrency & Execution Logic
+**Description**: Update the background daemon to handle messages targeted at specific chats and introduce directory-based concurrency control.
+**Tasks**:
+- Implement `handleUserMessage(chatId, message, settings)` in the daemon.
+- Create a directory-based queue mechanism. Ensure commands targeting the same `cwd` run sequentially, while commands for different directories can run concurrently.
+- Capture command stdout, stderr, and exit code, and append them as a `log` message to the corresponding chat's `chat.jsonl`.
+- Do not halt the queue on non-zero exit codes.
+**Verification**:
+- Write unit tests for the execution queue, mocking command execution to verify sequential vs concurrent execution based on `cwd`.
+- Verify failure logs (exitCode, stderr) are written correctly even if a command fails.
+- Run type-checking (`tsc`) and linter.
+**Status**: complete
+
+## Step 3: CLI Chat Management Commands
+**Description**: Implement the `clawmini chats` CLI commands for users to manage their chat sessions.
+**Tasks**:
+- Implement `clawmini chats list` to display existing chats.
+- Implement `clawmini chats add <id>` to initialize a new chat.
+- Implement `clawmini chats delete <id>` to remove a chat.
+- Implement `clawmini chats set-default <id>` to update the workspace's default chat.
+**Verification**:
+- Write E2E tests using `node:child_process.spawn` pointing to `dist/cli/index.mjs`.
+- Run commands in an isolated sandbox temporary directory (`cwd: e2eDir`).
+- Verify the CLI output and the creation/deletion of `.clawmini/chats/<id>` directories.
+- Explicitly tear down E2E tests (e.g., `pkill -f "dist/daemon/index.mjs"`) in the `afterAll` hook.
+- Run type-checking (`tsc`) and linter.
+**Status**: complete
+
+## Step 4: CLI Messaging and History Commands
+**Description**: Update the existing `send` command to support chats and implement the `tail` command for viewing history.
+**Tasks**:
+- Update `clawmini messages send <message> [--chat <id>]` to route the message to the specified chat (or the default one).
+- Implement `clawmini messages tail [-n NUM] [--json] [--chat <id>]`.
+- Format `tail` output for human readability by default, and output raw JSONL if `--json` is passed.
+**Verification**:
+- Write E2E tests sending messages to a specific chat and verifying they are properly stored.
+- Write E2E tests for `tail` command, verifying both formatted text output and `--json` raw output.
+- Write E2E tests verifying the `--chat` flag correctly overrides the default chat.
+- Run tests in an isolated sandbox directory, with proper daemon teardown in `afterAll`.
+- Run type-checking (`tsc`) and linter.
+**Status**: complete
+
+## Step 5: Background Messaging
+**Description**: Support returning immediately from `messages send` using a `--no-wait` flag. By default, it should wait for the response to finish. The server should queue the message and send it when ready.
+**Tasks**:
+- Update `messages send` to accept `--no-wait`.
+- Update `sendMessage` trpc mutation to accept an optional `noWait` boolean.
+- Update `handleUserMessage` in `src/daemon/queue.ts` to skip awaiting the task execution if `noWait` is true.
+**Verification**:
+- Verify tests.
+- Add E2E test case for `--no-wait` flag.
+**Status**: complete