70af40e986
- Moved setup logic into dedicated files: agent.ts, config.ts, index.ts, workspace.ts. - Introduced tool-helpers.ts for shared functions across tools, reducing boilerplate. - Updated tools (status, task-comment, task-create, task-update, work-finish, work-start) to utilize new helper functions for workspace resolution and provider creation. - Enhanced error handling and context detection in tools. - Improved project resolution logic to streamline tool execution. - Added new functionality for agent creation and configuration management in setup.
80 lines
2.5 KiB
TypeScript
80 lines
2.5 KiB
TypeScript
/**
|
|
* setup/workspace.ts — Workspace file scaffolding.
|
|
*
|
|
* Writes AGENTS.md, HEARTBEAT.md, default role instructions, and projects.json.
|
|
*/
|
|
import fs from "node:fs/promises";
|
|
import path from "node:path";
|
|
import {
|
|
AGENTS_MD_TEMPLATE,
|
|
HEARTBEAT_MD_TEMPLATE,
|
|
DEFAULT_DEV_INSTRUCTIONS,
|
|
DEFAULT_QA_INSTRUCTIONS,
|
|
} from "../templates.js";
|
|
|
|
/**
|
|
* Write all workspace files for a DevClaw agent.
|
|
* Returns the list of files that were written (skips files that already exist).
|
|
*/
|
|
export async function scaffoldWorkspace(workspacePath: string): Promise<string[]> {
|
|
const filesWritten: string[] = [];
|
|
|
|
// AGENTS.md (backup existing)
|
|
await backupAndWrite(path.join(workspacePath, "AGENTS.md"), AGENTS_MD_TEMPLATE);
|
|
filesWritten.push("AGENTS.md");
|
|
|
|
// HEARTBEAT.md
|
|
await backupAndWrite(path.join(workspacePath, "HEARTBEAT.md"), HEARTBEAT_MD_TEMPLATE);
|
|
filesWritten.push("HEARTBEAT.md");
|
|
|
|
// roles/default/dev.md and qa.md
|
|
const rolesDir = path.join(workspacePath, "roles", "default");
|
|
await fs.mkdir(rolesDir, { recursive: true });
|
|
|
|
const devRolePath = path.join(rolesDir, "dev.md");
|
|
if (!await fileExists(devRolePath)) {
|
|
await fs.writeFile(devRolePath, DEFAULT_DEV_INSTRUCTIONS, "utf-8");
|
|
filesWritten.push("roles/default/dev.md");
|
|
}
|
|
|
|
const qaRolePath = path.join(rolesDir, "qa.md");
|
|
if (!await fileExists(qaRolePath)) {
|
|
await fs.writeFile(qaRolePath, DEFAULT_QA_INSTRUCTIONS, "utf-8");
|
|
filesWritten.push("roles/default/qa.md");
|
|
}
|
|
|
|
// memory/projects.json
|
|
const memoryDir = path.join(workspacePath, "memory");
|
|
await fs.mkdir(memoryDir, { recursive: true });
|
|
const projectsJsonPath = path.join(memoryDir, "projects.json");
|
|
if (!await fileExists(projectsJsonPath)) {
|
|
await fs.writeFile(projectsJsonPath, JSON.stringify({ projects: {} }, null, 2) + "\n", "utf-8");
|
|
filesWritten.push("memory/projects.json");
|
|
}
|
|
|
|
return filesWritten;
|
|
}
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// Private helpers
|
|
// ---------------------------------------------------------------------------
|
|
|
|
async function backupAndWrite(filePath: string, content: string): Promise<void> {
|
|
try {
|
|
await fs.access(filePath);
|
|
await fs.copyFile(filePath, filePath + ".bak");
|
|
} catch {
|
|
await fs.mkdir(path.dirname(filePath), { recursive: true });
|
|
}
|
|
await fs.writeFile(filePath, content, "utf-8");
|
|
}
|
|
|
|
async function fileExists(filePath: string): Promise<boolean> {
|
|
try {
|
|
await fs.access(filePath);
|
|
return true;
|
|
} catch {
|
|
return false;
|
|
}
|
|
}
|