57c78f3656
Adds the Architect role for design/architecture investigations with persistent sessions and structured design proposals. ## New Features - **Architect role** with opus (complex) and sonnet (standard) levels - **design_task tool** — Creates To Design issues and dispatches architect - **Workflow states:** To Design → Designing → Planning - **Completion rules:** architect:done → Planning, architect:blocked → Refining - **Auto-level selection** based on complexity keywords ## Files Changed (22 files, 546 additions) ### New Files - lib/tools/design-task.ts — design_task tool implementation - lib/tools/design-task.test.ts — 16 tests for architect functionality ### Core Changes - lib/tiers.ts — ARCHITECT_LEVELS, WorkerRole type, models, emoji - lib/workflow.ts — toDesign/designing states, completion rules - lib/projects.ts — architect WorkerState on Project type - lib/dispatch.ts — architect role support in dispatch pipeline - lib/services/pipeline.ts — architect completion rules - lib/model-selector.ts — architect level selection heuristic ### Integration - index.ts — Register design_task tool, architect config schema - lib/notify.ts — architect role in notifications - lib/bootstrap-hook.ts — architect session key parsing - lib/services/tick.ts — architect in queue processing - lib/services/heartbeat.ts — architect in health checks - lib/tools/health.ts — architect in health scans - lib/tools/status.ts — architect in status dashboard - lib/tools/work-start.ts — architect role option - lib/tools/work-finish.ts — architect validation - lib/tools/project-register.ts — architect labels + role scaffolding - lib/templates.ts — architect instructions + AGENTS.md updates - lib/setup/workspace.ts — architect role file scaffolding - lib/setup/smart-model-selector.ts — architect in model assignment - lib/setup/llm-model-selector.ts — architect in LLM prompt
88 lines
3.0 KiB
TypeScript
88 lines
3.0 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,
|
|
DEFAULT_ARCHITECT_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");
|
|
|
|
// projects/projects.json
|
|
const projectsDir = path.join(workspacePath, "projects");
|
|
await fs.mkdir(projectsDir, { recursive: true });
|
|
const projectsJsonPath = path.join(projectsDir, "projects.json");
|
|
if (!await fileExists(projectsJsonPath)) {
|
|
await fs.writeFile(projectsJsonPath, JSON.stringify({ projects: {} }, null, 2) + "\n", "utf-8");
|
|
filesWritten.push("projects/projects.json");
|
|
}
|
|
|
|
// projects/roles/default/ (fallback role instructions)
|
|
const defaultRolesDir = path.join(projectsDir, "roles", "default");
|
|
await fs.mkdir(defaultRolesDir, { recursive: true });
|
|
const devRolePath = path.join(defaultRolesDir, "dev.md");
|
|
if (!await fileExists(devRolePath)) {
|
|
await fs.writeFile(devRolePath, DEFAULT_DEV_INSTRUCTIONS, "utf-8");
|
|
filesWritten.push("projects/roles/default/dev.md");
|
|
}
|
|
const qaRolePath = path.join(defaultRolesDir, "qa.md");
|
|
if (!await fileExists(qaRolePath)) {
|
|
await fs.writeFile(qaRolePath, DEFAULT_QA_INSTRUCTIONS, "utf-8");
|
|
filesWritten.push("projects/roles/default/qa.md");
|
|
}
|
|
const architectRolePath = path.join(defaultRolesDir, "architect.md");
|
|
if (!await fileExists(architectRolePath)) {
|
|
await fs.writeFile(architectRolePath, DEFAULT_ARCHITECT_INSTRUCTIONS, "utf-8");
|
|
filesWritten.push("projects/roles/default/architect.md");
|
|
}
|
|
|
|
// log/ directory (audit.log created on first write)
|
|
const logDir = path.join(workspacePath, "log");
|
|
await fs.mkdir(logDir, { recursive: true });
|
|
|
|
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;
|
|
}
|
|
}
|