uigraph 1.0.1 → 1.0.2

package/dist/bin.mjs

@@ -1,1230 +1,556 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
 import { Command, InvalidArgumentError, Option } from "@commander-js/extra-typings";
-import { checkbox, confirm, input, select } from "@inquirer/prompts";
-import { AGENT_LABELS, AGENT_NAMES, AgentError, AgentLimitError, agentTool, analyzeReview, fetchReview, fileIconPath, lensSettingsSchema, listRuns, readLocalReview, readRun, readSettings, runAgent, saveSettings } from "@uigraph/lens/agents";
+import { select } from "@inquirer/prompts";
+import { AGENT_LABELS, AGENT_NAMES, analyzeReview, fetchReview, fileIconPath, lensSettingsSchema, listRuns, readLocalReview, readRun, readSettings, saveSettings } from "@uigraph/lens/agents";
 import { LogLevels, consola } from "consola";
 import { execFile, spawn } from "node:child_process";
 import fs from "node:fs/promises";
-import os from "node:os";
 import path from "node:path";
 import { inspect, promisify } from "node:util";
 import open from "open";
 import pc from "picocolors";
-import fs$1, { existsSync, readFileSync, readdirSync } from "node:fs";
 import { AstToUiConverter, DynamoEditorSchema, MongoEditorSchema, SqlToAstParser, contextSchema, convertDynamoSchemaToAst, convertMermaidToReactFlow, convertMermaidToReactFlowWithContext, convertMongoSchemaToAst, convertReactFlowToC4UiGraph, convertReactFlowToSequenceUiGraph, convertUiGraphToMermaid, isC4ReactFlowDiagram, isSequenceDiagram } from "@uigraph/sdk";
 import { GraphQLError, Kind, NoSchemaIntrospectionCustomRule, buildSchema, execute, getOperationAST, parse, print, specifiedRules, validate } from "graphql";
 import { createHash, randomUUID } from "node:crypto";
 import { glob } from "tinyglobby";
 import { isMap, isScalar, isSeq, parse as parse$1, parseDocument, stringify, visit } from "yaml";
 import { z } from "zod";
+import fs$1, { existsSync, readFileSync, readdirSync } from "node:fs";
 import { setTimeout as setTimeout$1 } from "node:timers/promises";
+import os from "node:os";
 import http from "node:http";
 import { fileURLToPath } from "node:url";
-//#region src/artifacts/yaml-edit.ts
-function applyEdits(source, edits) {
-	return [...edits].sort((a, b) => b.start - a.start).reduce((text, edit) => text.slice(0, edit.start) + edit.text + text.slice(edit.end), source);
-}
-async function readYaml(root, file) {
-	const { realPath } = await resolveRepositoryFile(root, file);
-	const source = await fs.readFile(realPath, "utf8");
-	return {
-		source,
-		document: parseDocument(source)
-	};
-}
-function nodeRange(node, what) {
-	const range = node?.range;
-	if (range === void 0 || range === null) throw new Error(`Cannot locate ${what} in the YAML file`);
-	return range;
-}
-function column(source, position) {
-	return position - (source.lastIndexOf("\n", position - 1) + 1);
-}
-function lineStart(source, position) {
-	return source.lastIndexOf("\n", position - 1) + 1;
-}
-function renderBlock(value, indent) {
-	return stringify(value, { lineWidth: 0 }).trimEnd().split("\n").map((line, index) => index === 0 ? line : " ".repeat(indent) + line).join("\n");
-}
-function replaceScalar(node, value) {
-	if (!isScalar(node)) throw new Error(`Expected a YAML scalar to replace with "${value}"`);
-	const [start, end] = nodeRange(node, "a scalar");
-	return {
-		start,
-		end,
-		text: stringify(value, { lineWidth: 0 }).trimEnd()
-	};
-}
-function replaceItem(source, node, value) {
-	if (!isMap(node) || node.flow === true) throw new Error("Expected a block mapping in the YAML file");
-	const [start, end] = nodeRange(node, "an entry");
-	const trailingNewline = source[end - 1] === "\n" ? "\n" : "";
-	return {
-		start,
-		end,
-		text: renderBlock(value, column(source, start)) + trailingNewline
-	};
-}
-function setField(source, map, key, value) {
-	if (!isMap(map) || map.flow === true) throw new Error(`Expected a block mapping to set "${key}"`);
-	const existing = map.get(key, true);
-	if (isScalar(existing) && (typeof value === "string" || typeof value === "number")) return replaceScalar(existing, value);
-	if (existing !== void 0) throw new Error(`Cannot replace the "${key}" field in place`);
-	const first = map.items[0]?.key;
-	if (first === void 0) throw new Error(`Cannot add "${key}" to an empty mapping`);
-	const indent = column(source, nodeRange(first, "a key")[0]);
-	const end = nodeRange(map, "a mapping")[1];
-	return {
-		start: end,
-		end,
-		text: `${source[end - 1] === "\n" ? "" : "\n"}${" ".repeat(indent)}${renderBlock({ [key]: value }, indent)}\n`
-	};
-}
-function appendItem(source, document, path, value) {
-	const sequence = document.getIn(path, true);
-	if (isSeq(sequence) && sequence.flow !== true) {
-		const range = nodeRange(sequence, path.join("."));
-		const indent = column(source, range[0]);
-		const needsNewline = source[range[1] - 1] === "\n" ? "" : "\n";
-		return {
-			start: range[1],
-			end: range[1],
-			text: `${needsNewline}${" ".repeat(indent)}- ${renderBlock(value, indent + 2)}\n`
-		};
-	}
-	const key = path.at(-1);
-	if (typeof key !== "string") throw new Error(`Cannot add an item to ${path.join(".")}`);
-	const parent = path.length === 1 ? document.contents : document.getIn(path.slice(0, -1), true);
-	if (!isMap(parent) || parent.flow === true) throw new Error(`Cannot add an item to ${path.join(".")}`);
-	const pair = parent.items.find((item) => isScalar(item.key) && item.key.value === key);
-	if (pair !== void 0) {
-		if (!isSeq(pair.value) || pair.value.items.length > 0) throw new Error(`${path.join(".")} must be a list`);
-		const keyColumn = column(source, nodeRange(pair.key, key)[0]);
-		const [valueStart, end] = nodeRange(pair.value, key);
-		return {
-			start: source.lastIndexOf(":", valueStart) + 1,
-			end,
-			text: `\n${" ".repeat(keyColumn + 2)}- ${renderBlock(value, keyColumn + 4)}`
-		};
-	}
-	return setField(source, parent, key, [value]);
+//#region src/analysis/repo-access.ts
+const EXCLUDED_DIRECTORIES = [
+	".git",
+	"node_modules",
+	"dist",
+	"build",
+	"out",
+	".next",
+	".nuxt",
+	".turbo",
+	".cache",
+	"coverage",
+	"target",
+	"vendor",
+	".venv",
+	"venv",
+	"__pycache__",
+	".terraform",
+	".claude"
+];
+const SECRET_FILE_PATTERNS = [
+	/^\.env(\..+)?$/,
+	/\.(pem|key|p12|pfx|jks|keystore|crt|cer|der)$/,
+	/^id_(rsa|dsa|ecdsa|ed25519)/,
+	/^credentials/,
+	/^secrets?\./,
+	/^\.npmrc$/,
+	/^\.netrc$/,
+	/^\.pypirc$/,
+	/\.tfstate(\.backup)?$/
+];
+const ALLOWED_ENV_FILES = [
+	".env.example",
+	".env.sample",
+	".env.template"
+];
+function isExcludedPath(relativePath) {
+	const segments = relativePath.split("/");
+	if (segments.some((segment) => EXCLUDED_DIRECTORIES.includes(segment))) return true;
+	const fileName = segments[segments.length - 1];
+	if (ALLOWED_ENV_FILES.includes(fileName)) return false;
+	return SECRET_FILE_PATTERNS.some((pattern) => pattern.test(fileName));
 }
-function removeItem(source, document, path, index) {
-	const sequence = document.getIn(path, true);
-	if (!isSeq(sequence) || sequence.flow === true) throw new Error(`${path.join(".")} must be a block list`);
-	const item = sequence.items[index];
-	if (item === void 0) throw new Error(`${path.join(".")} has no item ${index}`);
-	if (sequence.items.length > 1) {
-		const [start, , end] = nodeRange(item, "an item");
-		return {
-			start: lineStart(source, start),
-			end,
-			text: ""
-		};
-	}
-	const [start, , end] = nodeRange(sequence, path.join("."));
+async function resolveRepositoryFile(root, requested) {
+	const normalized = path.posix.normalize(requested.replaceAll("\\", "/"));
+	if (normalized === ".." || normalized.startsWith("../") || path.isAbsolute(normalized)) throw new Error(`Path must be relative to the repository: ${requested}`);
+	const relativePath = normalized.replace(/^\.\//, "");
+	if (isExcludedPath(relativePath)) throw new Error(`Path is excluded from analysis: ${relativePath}`);
+	const absolutePath = path.join(root, relativePath);
+	const realPath = await fs.realpath(absolutePath);
+	if (realPath !== root && !realPath.startsWith(root + path.sep)) throw new Error(`Path resolves outside the repository: ${relativePath}`);
 	return {
-		start: source.lastIndexOf(":", start) + 1,
-		end,
-		text: " []\n"
+		relativePath,
+		realPath,
+		stat: await fs.stat(realPath)
 	};
 }
-function findItemIndex(document, path, name) {
-	const sequence = document.getIn(path, true);
-	if (!isSeq(sequence)) throw new Error(`${path.join(".")} must be a list`);
-	const index = sequence.items.findIndex((item) => isMap(item) && item.get("name") === name);
-	if (index === -1) throw new Error(`${path.join(".")} has no entry named "${name}"`);
-	return index;
-}
 //#endregion
-//#region src/artifacts/docs.ts
+//#region src/artifacts/load.ts
+const ROOT_CONFIG = ".uigraph.yaml";
+const ORG_ID = "local";
+const ACTOR_ID = "uigraph";
+const MAX_FILE_BYTES = 2e6;
+const HTTP_METHODS = [
+	"get",
+	"put",
+	"post",
+	"delete",
+	"patch",
+	"options",
+	"head",
+	"trace"
+];
+const DOC_FILE_TYPES = [
+	"pdf",
+	"html",
+	"markdown",
+	"doc",
+	"txt",
+	"image",
+	"video",
+	"audio",
+	"other"
+];
 const DOC_EXTENSIONS$1 = {
-	pdf: ".pdf",
-	html: ".html",
-	markdown: ".md",
-	txt: ".txt"
+	".pdf": "pdf",
+	".html": "html",
+	".htm": "html",
+	".md": "markdown",
+	".markdown": "markdown",
+	".doc": "doc",
+	".docx": "doc",
+	".txt": "txt",
+	".png": "image",
+	".jpg": "image",
+	".jpeg": "image",
+	".gif": "image",
+	".webp": "image",
+	".svg": "image",
+	".mp4": "video",
+	".mov": "video",
+	".webm": "video",
+	".mp3": "audio",
+	".wav": "audio",
+	".ogg": "audio",
+	".m4a": "audio"
 };
-async function loadValid(root, configFile) {
-	const { db, errors } = await loadArtifacts(root, configFile);
-	if (errors.length > 0) throw new Error(`The .uigraph artifacts are invalid:\n${errors.join("\n")}`);
-	return db;
-}
-async function exists(file) {
-	return fs.lstat(file).then(() => true, (error) => {
-		if (error.code === "ENOENT") return false;
-		throw error;
-	});
-}
-async function createDoc(root, configFile, file, input, data) {
-	const db = await loadValid(root, configFile);
-	if ([...db.docs, ...db.standaloneDocs].some((doc) => doc.file === file && doc.entry.name === input.name)) throw new Error(`Another doc in ${file} is named "${input.name}"`);
-	const extension = DOC_EXTENSIONS$1[input.fileType];
-	if (extension === void 0) throw new Error(`Unsupported doc type "${input.fileType}"`);
-	const base = slugify(input.name);
-	if (base === "") throw new Error("The doc name must contain a letter or digit");
-	let docPath = `.uigraph/docs/${base}${extension}`;
-	for (let suffix = 2; await exists(path.join(root, docPath)); suffix++) docPath = `.uigraph/docs/${base}-${suffix}${extension}`;
-	await writeArtifactFile(root, docPath, data);
-	const { source, document } = await readYaml(root, file);
-	await writeArtifactFile(root, file, applyEdits(source, [appendItem(source, document, ["docs"], {
-		name: input.name,
-		path: docPath,
-		fileType: input.fileType,
-		...input.description === "" ? {} : { description: input.description }
-	})]));
-	return docPath;
-}
-async function deleteDoc(root, configFile, file, name) {
-	const db = await loadValid(root, configFile);
-	const allDocs = [...db.docs, ...db.standaloneDocs];
-	const doc = allDocs.find((d) => d.file === file && d.entry.name === name);
-	if (doc === void 0) throw new Error(`No doc named "${name}" in ${file}`);
-	const { source, document } = await readYaml(root, file);
-	await writeArtifactFile(root, file, applyEdits(source, [removeItem(source, document, ["docs"], findItemIndex(document, ["docs"], name))]));
-	const stillUsed = allDocs.some((d) => d !== doc && d.entry.path === doc.entry.path);
-	if (isArtifactPath(doc.entry.path) && !stillUsed) await deleteArtifactFile(root, doc.entry.path);
-}
-//#endregion
-//#region src/artifacts/maps.ts
-const IMAGE_EXTENSIONS = {
-	"image/png": ".png",
-	"image/jpeg": ".jpg",
-	"image/webp": ".webp",
-	"image/gif": ".gif"
+const DATABASE_DIALECTS = [
+	"postgres",
+	"mysql",
+	"sqlite",
+	"other",
+	"dynamodb",
+	"mongodb"
+];
+const queryEntrySchema = z.looseObject({
+	name: z.string().min(1),
+	database: z.string().min(1),
+	path: z.string().min(1).optional(),
+	queryText: z.string().min(1).optional(),
+	description: z.string().optional(),
+	tags: z.array(z.string()).optional()
+});
+const queryFileSchema = z.looseObject({ queries: z.array(queryEntrySchema).default([]) });
+const componentRefSchema = z.looseObject({
+	componentId: z.string().min(1),
+	componentLinkId: z.string().optional(),
+	serviceName: z.string().optional(),
+	apiGroupName: z.string().optional(),
+	operationId: z.string().optional(),
+	testPackName: z.string().optional(),
+	docName: z.string().optional(),
+	architectureDiagramName: z.string().optional(),
+	modalFields: z.array(z.looseObject({
+		componentFieldId: z.string(),
+		label: z.string().optional(),
+		type: z.string().optional(),
+		data: z.array(z.unknown()).optional()
+	})).optional()
+});
+const mapSchema = z.looseObject({
+	name: z.string().min(1),
+	description: z.string().optional(),
+	frames: z.array(z.looseObject({
+		name: z.string().min(1),
+		description: z.string().optional(),
+		imagePath: z.string().min(1).optional(),
+		focalPoints: z.array(z.looseObject({
+			name: z.string().min(1),
+			x: z.number(),
+			y: z.number(),
+			visibility: z.string().optional(),
+			color: z.string().optional(),
+			components: z.array(componentRefSchema).optional()
+		})).optional()
+	})).optional()
+});
+const CANVAS_FILE = ".uigraph/maps/canvas.json";
+const canvasPointSchema = z.object({
+	x: z.number(),
+	y: z.number()
+});
+const canvasFileSchema = z.record(z.string(), z.object({
+	zoom: z.number().optional(),
+	navigationX: z.number().optional(),
+	navigationY: z.number().optional(),
+	framePositions: z.record(z.string(), canvasPointSchema).optional(),
+	frames: z.record(z.string(), z.object({
+		groups: z.array(canvasPointSchema.extend({
+			name: z.string(),
+			description: z.string(),
+			width: z.number(),
+			height: z.number()
+		})).optional(),
+		links: z.array(canvasPointSchema.extend({
+			kind: z.enum(["frame", "map"]),
+			map: z.string(),
+			frame: z.string().optional(),
+			label: z.string()
+		})).optional()
+	})).optional()
+}));
+const configSchema = z.looseObject({
+	version: z.literal(1),
+	service: z.looseObject({
+		name: z.string().min(1),
+		category: z.string().min(1),
+		description: z.string().min(1),
+		repository: z.looseObject({
+			provider: z.string(),
+			url: z.string()
+		}).optional(),
+		ownership: z.looseObject({ team: z.string().min(1) }).optional(),
+		labels: z.array(z.string()).optional(),
+		integrations: z.looseObject({
+			slack: z.looseObject({ url: z.string() }).optional(),
+			jira: z.looseObject({ url: z.string() }).optional()
+		}).optional()
+	}).optional(),
+	apis: z.array(z.looseObject({
+		name: z.string().min(1),
+		type: z.enum([
+			"openapi",
+			"graphql",
+			"grpc"
+		]),
+		path: z.string().min(1)
+	})).default([]),
+	dependencies: z.array(z.looseObject({
+		name: z.string().min(1),
+		service: z.string().min(1),
+		direction: z.enum(["upstream", "downstream"]),
+		criticality: z.enum(["hard", "soft"]),
+		type: z.enum([
+			"http",
+			"graphql",
+			"grpc",
+			"database"
+		]).optional(),
+		description: z.string().optional(),
+		apiGroupName: z.string().optional(),
+		apiEndpointNames: z.array(z.string().min(1)).optional(),
+		databaseName: z.string().optional()
+	})).default([]),
+	architectureDiagrams: z.array(z.looseObject({
+		name: z.string().min(1),
+		path: z.string().min(1),
+		contextPath: z.string().min(1).optional()
+	})).default([]),
+	docs: z.array(z.looseObject({
+		name: z.string().min(1),
+		path: z.string().min(1),
+		fileType: z.enum(DOC_FILE_TYPES).optional(),
+		description: z.string().optional()
+	})).default([]),
+	databases: z.array(z.looseObject({
+		name: z.string().min(1),
+		dialect: z.enum(DATABASE_DIALECTS),
+		dbType: z.string().optional(),
+		schemaPath: z.string().min(1)
+	})).default([]),
+	queries: z.array(queryEntrySchema).default([]),
+	queryFiles: z.array(z.string().min(1)).default([]),
+	maps: z.array(mapSchema).default([])
+});
+const PROTOCOL_LABELS = {
+	openapi: "REST",
+	graphql: "GraphQL",
+	grpc: "gRPC"
 };
-async function createMap(root, configFile, file, input) {
-	await loadValid(root, configFile);
-	const { source, document } = await readYaml(root, file);
-	await writeArtifactFile(root, file, applyEdits(source, [appendItem(source, document, ["maps"], {
-		name: input.name,
-		...input.description === "" ? {} : { description: input.description }
-	})]));
-}
-async function editMap(root, configFile, file, name, edit) {
-	await loadValid(root, configFile);
-	const { source, document } = await readYaml(root, file);
-	const index = findItemIndex(document, ["maps"], name);
-	const node = document.getIn(["maps", index], true);
-	if (!isMap(node)) throw new Error(`maps[${name}] must be a mapping`);
-	const next = edit(node.toJSON());
-	await writeArtifactFile(root, file, applyEdits(source, [next === null ? removeItem(source, document, ["maps"], index) : replaceItem(source, node, next)]));
-}
-async function editCanvas(root, edit) {
-	const present = await exists(path.join(root, CANVAS_FILE));
-	let canvas = {};
-	if (present) {
-		const { realPath } = await resolveRepositoryFile(root, CANVAS_FILE);
-		canvas = canvasFileSchema.parse(JSON.parse(await fs.readFile(realPath, "utf8")));
-	}
-	const before = JSON.stringify(canvas);
-	edit(canvas);
-	if (JSON.stringify(canvas) === before) return;
-	if (Object.keys(canvas).length === 0) {
-		if (present) await deleteArtifactFile(root, CANVAS_FILE);
-		return;
-	}
-	await writeArtifactFile(root, CANVAS_FILE, `${JSON.stringify(canvas, null, 2)}\n`);
+function slugify(value) {
+	return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
-async function retargetLinks(root, from, to) {
-	await editCanvas(root, (canvas) => {
-		for (const mapCanvas of Object.values(canvas)) for (const frameCanvas of Object.values(mapCanvas.frames ?? {})) {
-			if (frameCanvas.links === void 0) continue;
-			frameCanvas.links = frameCanvas.links.flatMap((link) => {
-				if (!(link.map === from.map && (from.frame === void 0 || link.frame === from.frame))) return [link];
-				if (to === null) return [];
-				return [{
-					...link,
-					map: to.map,
-					...from.frame === void 0 ? {} : { frame: to.frame }
-				}];
-			});
-		}
-	});
+function describe(error) {
+	return error instanceof Error ? error.message : String(error);
 }
-async function writeFrameImage(root, mapName, frameName, upload) {
-	const extension = IMAGE_EXTENSIONS[upload.contentType];
-	if (extension === void 0) throw new Error("Frame images must be PNG, JPEG, WebP or GIF files");
-	const directory = `.uigraph/maps/${slugify(mapName)}`;
-	const base = slugify(frameName);
-	let imagePath = `${directory}/${base}${extension}`;
-	for (let suffix = 2; await exists(path.join(root, imagePath)); suffix++) imagePath = `${directory}/${base}-${suffix}${extension}`;
-	await writeArtifactFile(root, imagePath, upload.data);
-	return imagePath;
+function contentHash(...parts) {
+	const hash = createHash("sha256");
+	for (const part of parts) hash.update(part);
+	return hash.digest("hex");
 }
-async function deleteUnusedImages(root, configFile, imagePaths) {
-	const db = await loadValid(root, configFile);
-	const used = new Set(db.maps.flatMap((map) => map.frames.flatMap(({ frame }) => frame.screenshotAssetId ?? [])));
-	for (const imagePath of imagePaths) if (isArtifactPath(imagePath) && !used.has(imagePath)) await deleteArtifactFile(root, imagePath);
+async function readArtifactFile(root, relativePath) {
+	const { realPath, stat } = await resolveRepositoryFile(root, relativePath);
+	if (!stat.isFile()) throw new Error(`Not a file: ${relativePath}`);
+	if (stat.size > MAX_FILE_BYTES) throw new Error(`File is larger than ${MAX_FILE_BYTES} bytes: ${relativePath}`);
+	return {
+		text: await fs.readFile(realPath, "utf8"),
+		updatedAt: stat.mtime.toISOString()
+	};
 }
-//#endregion
-//#region src/artifacts/diagram-images.ts
-const DIAGRAM_IMAGE_EXTENSIONS = {
-	...IMAGE_EXTENSIONS,
-	"image/svg+xml": ".svg"
-};
-function imageDirectory(diagramPath) {
-	return `${path.posix.dirname(diagramPath)}/images`;
+function parseOpenApi(text) {
+	const spec = parse$1(text);
+	if (spec === null || typeof spec !== "object") throw new Error("not an OpenAPI document");
+	return Object.entries(spec.paths ?? {}).flatMap(([route, operations]) => HTTP_METHODS.filter((method) => operations[method] !== void 0).map((method) => {
+		const operation = operations[method];
+		return {
+			method: method.toUpperCase(),
+			path: route,
+			operationId: typeof operation.operationId === "string" ? operation.operationId : `${method.toUpperCase()} ${route}`,
+			summary: typeof operation.summary === "string" ? operation.summary : "",
+			description: typeof operation.description === "string" ? operation.description : "",
+			parameters: "[]"
+		};
+	}));
 }
-async function listDiagramImages(root, diagramPath) {
-	const directory = imageDirectory(diagramPath);
-	const entries = await fs.readdir(path.join(root, directory), { withFileTypes: true }).catch((error) => {
-		if (error.code === "ENOENT") return [];
-		throw error;
-	});
-	const extensions = new Set(Object.values(DIAGRAM_IMAGE_EXTENSIONS));
-	const images = [];
-	for (const entry of entries) if (entry.isFile() && extensions.has(path.extname(entry.name).toLowerCase())) {
-		const imagePath = `${directory}/${entry.name}`;
-		const stat = await fs.stat(path.join(root, imagePath));
-		images.push({
-			imagePath,
-			createdAt: stat.birthtime.toISOString()
+function parseGraphQLSchema(text) {
+	return parse(text).definitions.flatMap((definition) => {
+		if (definition.kind !== Kind.OBJECT_TYPE_DEFINITION && definition.kind !== Kind.OBJECT_TYPE_EXTENSION || ![
+			"Query",
+			"Mutation",
+			"Subscription"
+		].includes(definition.name.value)) return [];
+		return (definition.fields ?? []).map((field) => {
+			const args = field.arguments === void 0 || field.arguments.length === 0 ? "" : `(${field.arguments.map((arg) => `${arg.name.value}: ${print(arg.type)}`).join(", ")})`;
+			return {
+				method: definition.name.value,
+				path: `${field.name.value}${args}: ${print(field.type)}`,
+				operationId: field.name.value,
+				summary: "",
+				description: field.description?.value ?? "",
+				parameters: "[]"
+			};
 		});
-	}
-	return images.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+	});
 }
-async function writeDiagramImage(root, diagramPath, fileName, upload) {
-	const extension = DIAGRAM_IMAGE_EXTENSIONS[upload.contentType];
-	if (extension === void 0) throw new Error("Diagram images must be PNG, JPEG, WebP, GIF or SVG files");
-	const directory = imageDirectory(diagramPath);
-	const base = slugify(path.parse(fileName).name);
-	if (base === "") throw new Error("The image file name must contain a letter or digit");
-	let imagePath = `${directory}/${base}${extension}`;
-	for (let suffix = 2; await exists(path.join(root, imagePath)); suffix++) imagePath = `${directory}/${base}-${suffix}${extension}`;
-	await writeArtifactFile(root, imagePath, upload.data);
-	return imagePath;
+function parseProto(text) {
+	const packageName = /^\s*package\s+([\w.]+)\s*;/m.exec(text)?.[1] ?? "";
+	const services = [...text.matchAll(/\bservice\s+(\w+)\s*\{/g)];
+	return [...text.matchAll(/\brpc\s+(\w+)\s*\(\s*(stream\s+)?[\w.]+\s*\)\s*returns\s*\(\s*(stream\s+)?[\w.]+\s*\)/g)].map((rpc) => {
+		const service = services.filter((match) => match.index < rpc.index).pop();
+		if (service === void 0) throw new Error(`rpc ${rpc[1]} is outside a service`);
+		const clientStream = rpc[2] !== void 0;
+		const serverStream = rpc[3] !== void 0;
+		const qualifiedService = packageName === "" ? service[1] : `${packageName}.${service[1]}`;
+		return {
+			method: clientStream && serverStream ? "bidirectional" : clientStream ? "client_streaming" : serverStream ? "server_streaming" : "unary",
+			path: `${qualifiedService}/${rpc[1]}`,
+			operationId: rpc[1],
+			summary: "",
+			description: "",
+			parameters: JSON.stringify({
+				packageName,
+				serviceName: service[1]
+			})
+		};
+	});
 }
-//#endregion
-//#region src/artifacts/write.ts
-const MAX_WRITE_BYTES = 2e6;
-const MAX_UPLOAD_BYTES = 5e7;
-function isArtifactPath(relativePath) {
-	return relativePath === ".uigraph.yaml" || relativePath.startsWith(".uigraph/");
+function parseApiSpec(type, text) {
+	if (type === "openapi") return parseOpenApi(text);
+	if (type === "graphql") return parseGraphQLSchema(text);
+	if (type === "grpc") return parseProto(text);
+	throw new Error(`Unknown API type: ${String(type)}`);
 }
-function toArtifactPath(requested) {
-	const relativePath = path.posix.normalize(requested.replaceAll("\\", "/")).replace(/^\.\//, "");
-	if (path.posix.isAbsolute(relativePath) || relativePath.split("/").includes("..")) throw new Error(`Path must be relative to the repository: ${requested}`);
-	if (!isArtifactPath(relativePath) || relativePath.endsWith("/")) throw new Error(`Only ${ROOT_CONFIG} and files under .uigraph/ can be written: ${requested}`);
-	return relativePath;
+async function convertDiagram(mermaid, context) {
+	if (context === void 0) return convertMermaidToReactFlow(mermaid);
+	return convertMermaidToReactFlowWithContext(mermaid, contextSchema.parse(context), { repositionNodes: true });
 }
-async function deleteArtifactFile(root, requested) {
-	const relativePath = toArtifactPath(requested);
-	let current = root;
-	for (const segment of relativePath.split("/")) {
-		current = path.join(current, segment);
-		if ((await fs.lstat(current)).isSymbolicLink()) throw new Error(`Refusing to delete through a symbolic link: ${relativePath}`);
+function parseDatabaseSchema(dialect, text) {
+	if (dialect === "dynamodb") {
+		const table = DynamoEditorSchema.parse(JSON.parse(text));
+		return {
+			sdkDialect: dialect,
+			ast: convertDynamoSchemaToAst(table),
+			sourceContent: table,
+			noSQLSchema: { dynamo: { table } }
+		};
 	}
-	await fs.rm(current);
-	const artifactRoot = path.join(root, ".uigraph");
-	for (let directory = path.dirname(current); directory.startsWith(`${artifactRoot}${path.sep}`); directory = path.dirname(directory)) {
-		if ((await fs.readdir(directory)).length > 0) return;
-		await fs.rmdir(directory);
+	if (dialect === "mongodb") {
+		const schema = MongoEditorSchema.parse(JSON.parse(text));
+		return {
+			sdkDialect: dialect,
+			ast: convertMongoSchemaToAst(schema),
+			sourceContent: schema,
+			noSQLSchema: { mongo: { collections: schema.collections } }
+		};
 	}
+	const sdkDialect = dialect === "postgres" ? "postgresql" : dialect === "other" ? SqlToAstParser.detectDialect(text) : dialect;
+	return {
+		sdkDialect,
+		ast: new SqlToAstParser(sdkDialect).parse(text),
+		sourceContent: void 0,
+		noSQLSchema: null
+	};
 }
-async function writeArtifactFile(root, requested, content) {
-	const relativePath = toArtifactPath(requested);
-	const limit = typeof content === "string" ? MAX_WRITE_BYTES : MAX_UPLOAD_BYTES;
-	if (Buffer.byteLength(content) > limit) throw new Error(`Content is larger than ${limit} bytes`);
-	const segments = relativePath.split("/");
-	let current = root;
-	for (const [index, segment] of segments.entries()) {
-		current = path.join(current, segment);
-		const isLast = index === segments.length - 1;
-		const stat = await fs.lstat(current).catch((error) => {
-			if (error.code === "ENOENT") return null;
-			throw error;
-		});
-		if (stat === null) {
-			if (!isLast) await fs.mkdir(current);
-			continue;
-		}
-		if (stat.isSymbolicLink()) throw new Error(`Refusing to write through a symbolic link: ${relativePath}`);
-		if (!isLast && !stat.isDirectory()) throw new Error(`Not a directory: ${segments.slice(0, index + 1).join("/")}`);
-		if (isLast && !stat.isFile()) throw new Error(`Not a file: ${relativePath}`);
-	}
-	const temporary = path.join(path.dirname(current), `.${path.basename(current)}.${randomUUID()}.tmp`);
-	await fs.writeFile(temporary, content, { flag: "wx" });
-	await fs.rename(temporary, current);
-	return relativePath;
+function toTables(ast) {
+	return ast.tables.map((table) => ({
+		name: table.name,
+		columns: table.columns.map((column) => ({
+			name: column.name,
+			type: column.dataType.name,
+			nullable: column.nullable,
+			description: column.comment || null,
+			isPrimaryKey: table.constraints.some((c) => c.type === "primary_key" && c.columns.includes(column.name))
+		})),
+		indexes: []
+	}));
 }
-function exportDiagram(nodes, edges) {
-	if (isC4ReactFlowDiagram(nodes)) return convertReactFlowToC4UiGraph(nodes, edges);
-	if (isSequenceDiagram(nodes)) return convertReactFlowToSequenceUiGraph(nodes, edges);
-	return convertUiGraphToMermaid({
-		nodes,
-		edges
-	});
+function toServiceEntity(id, service, updatedAt) {
+	return {
+		id,
+		orgId: ORG_ID,
+		folderId: null,
+		teamId: null,
+		name: service.name,
+		description: service.description,
+		status: "active",
+		tier: "tier3",
+		category: service.category,
+		language: "",
+		gitRepoUrl: service.repository?.url ?? null,
+		jiraProjectUrl: service.integrations?.jira?.url ?? null,
+		slackChannelUrl: service.integrations?.slack?.url ?? null,
+		lastCommitSha: null,
+		labels: service.labels ?? [],
+		metadata: "{}",
+		docLinks: null,
+		createdBy: ACTOR_ID,
+		updatedBy: null,
+		stats: {
+			serviceId: id,
+			endpointCount: 0,
+			diagramCount: 0,
+			dbTableCount: 0,
+			docCount: 0,
+			testCaseCount: 0
+		},
+		createdAt: updatedAt,
+		updatedAt
+	};
 }
-async function saveDiagram(root, configFile, diagramId, input) {
-	const { db, errors } = await loadArtifacts(root, configFile);
-	if (errors.length > 0) throw new Error(`The .uigraph artifacts are invalid:\n${errors.join("\n")}`);
-	const diagram = db.diagrams.find((d) => d.entity.id === diagramId);
-	if (diagram === void 0) throw new Error(`Diagram ${diagramId} not found`);
-	const name = input.name === void 0 || input.name === null || input.name.trim() === "" ? diagram.entry.name : input.name.trim();
-	if (db.diagrams.some((d) => d.file === diagram.file && d.entity.id !== diagramId && d.entry.name === name)) throw new Error(`Another diagram in ${diagram.file} is named "${name}"`);
-	let contextPath = diagram.entry.contextPath;
-	if (input.content !== void 0 && input.content !== null) {
-		const parsed = JSON.parse(input.content);
-		if (!Array.isArray(parsed.nodes) || !Array.isArray(parsed.edges)) throw new Error("Diagram content must have nodes and edges arrays");
-		const next = exportDiagram(parsed.nodes, parsed.edges);
-		const previous = exportDiagram(diagram.flow.nodes, diagram.flow.edges);
-		if (JSON.stringify(next) !== JSON.stringify(previous)) {
-			contextPath ??= path.posix.join(path.posix.dirname(diagram.entry.path), "context.json");
-			await writeArtifactFile(root, diagram.entry.path, next.mermaid);
-			await writeArtifactFile(root, contextPath, `${JSON.stringify(next.context, null, 2)}\n`);
+async function loadArtifacts(root, configFile = ROOT_CONFIG) {
+	const errors = [];
+	const configFiles = [configFile];
+	if (configFile === ".uigraph.yaml") configFiles.push(...(await glob(".uigraph/services/*.yaml", {
+		cwd: root,
+		dot: true,
+		onlyFiles: true,
+		followSymbolicLinks: false
+	})).sort());
+	const configs = [];
+	for (const file of configFiles) try {
+		const { text, updatedAt } = await readArtifactFile(root, file);
+		const parsed = configSchema.safeParse(parse$1(text));
+		if (!parsed.success) {
+			for (const issue of parsed.error.issues) errors.push(`${file}: ${issue.path.join(".") || "root"}: ${issue.message}`);
+			continue;
 		}
+		configs.push({
+			file,
+			config: parsed.data,
+			updatedAt
+		});
+	} catch (error) {
+		errors.push(`${file}: ${describe(error)}`);
 	}
-	if (name !== diagram.entry.name || contextPath !== diagram.entry.contextPath) {
-		const { source, document } = await readYaml(root, diagram.file);
-		const entry = document.getIn(["architectureDiagrams", diagram.index], true);
-		if (!isMap(entry) || entry.flow === true) throw new Error(`${diagram.file}: architectureDiagrams[${diagram.index}] must be a block mapping`);
-		const edits = [];
-		if (name !== diagram.entry.name) edits.push(replaceScalar(entry.get("name", true), name));
-		if (contextPath !== diagram.entry.contextPath) {
-			const pathPair = entry.items.find((pair) => isScalar(pair.key) && pair.key.value === "path");
-			const key = pathPair?.key;
-			const value = pathPair?.value;
-			if (!key?.range || !value?.range) throw new Error(`${diagram.file}: architectureDiagrams[${diagram.index}] has no path`);
-			const indent = key.range[0] - source.lastIndexOf("\n", key.range[0]) - 1;
-			edits.push({
-				start: value.range[1],
-				end: value.range[1],
-				text: `\n${" ".repeat(indent)}contextPath: ${stringify(contextPath, { lineWidth: 0 }).trimEnd()}`
-			});
-		}
-		await writeArtifactFile(root, diagram.file, applyEdits(source, edits));
+	for (const { file, config } of configs) if (config.service === void 0) {
+		if (config.apis.length > 0 || config.dependencies.length > 0 || config.databases.length > 0 || config.queries.length > 0 || config.queryFiles.length > 0) errors.push(`${file}: apis, dependencies, databases and queries require a service block`);
 	}
-	const mermaid = await fs.readFile(path.join(root, diagram.entry.path), "utf8");
-	const context = contextPath === void 0 ? "" : await fs.readFile(path.join(root, contextPath), "utf8");
-	return {
-		id: diagramId,
-		name,
-		updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-		contentHash: contentHash(mermaid, context)
-	};
-}
-async function createDiagram(root, configFile, file, name) {
-	const { db, errors } = await loadArtifacts(root, configFile);
-	if (errors.length > 0) throw new Error(`The .uigraph artifacts are invalid:\n${errors.join("\n")}`);
-	if (db.diagrams.some((d) => d.file === file && d.entry.name === name)) throw new Error(`Another diagram in ${file} is named "${name}"`);
-	const base = slugify(name);
-	if (base === "") throw new Error("The diagram name must contain a letter or digit");
-	let folder = base;
-	for (let suffix = 2; db.diagrams.some((d) => d.entity.id === folder) || await fs.lstat(path.join(root, ".uigraph/diagrams", folder)).then(() => true, (error) => {
-		if (error.code === "ENOENT") return false;
-		throw error;
-	}); suffix++) folder = `${base}-${suffix}`;
-	const entry = {
-		name,
-		path: `.uigraph/diagrams/${folder}/${folder}.mmd`,
-		contextPath: `.uigraph/diagrams/${folder}/context.json`
-	};
-	const empty = convertUiGraphToMermaid({
-		nodes: [],
-		edges: []
-	});
-	await writeArtifactFile(root, entry.path, empty.mermaid);
-	await writeArtifactFile(root, entry.contextPath, `${JSON.stringify(empty.context, null, 2)}\n`);
-	const { source, document } = await readYaml(root, file);
-	await writeArtifactFile(root, file, applyEdits(source, [appendItem(source, document, ["architectureDiagrams"], entry)]));
-	return folder;
-}
-async function deleteDiagram(root, configFile, diagramId) {
-	const { db, errors } = await loadArtifacts(root, configFile);
-	if (errors.length > 0) throw new Error(`The .uigraph artifacts are invalid:\n${errors.join("\n")}`);
-	const diagram = db.diagrams.find((d) => d.entity.id === diagramId);
-	if (diagram === void 0) throw new Error(`Diagram ${diagramId} not found`);
-	const images = await listDiagramImages(root, diagram.entry.path);
-	const { source, document } = await readYaml(root, diagram.file);
-	await writeArtifactFile(root, diagram.file, applyEdits(source, [removeItem(source, document, ["architectureDiagrams"], diagram.index)]));
-	for (const file of [
-		diagram.entry.path,
-		diagram.entry.contextPath,
-		...images.map((image) => image.imagePath)
-	]) if (file !== void 0 && isArtifactPath(file)) await deleteArtifactFile(root, file);
-}
-async function renameDiagramReferences(root, files, serviceName, oldName, newName) {
-	for (const file of files) {
-		const { source, document } = await readYaml(root, file);
-		const edits = [];
-		visit(document, { Map(_, map) {
-			if (map.get("serviceName") === serviceName && map.get("architectureDiagramName") === oldName) edits.push(replaceScalar(map.get("architectureDiagramName", true), newName));
-		} });
-		if (edits.length > 0) await writeArtifactFile(root, file, applyEdits(source, edits));
-	}
-}
-const diagramCandidateSchema = z.object({
-	id: z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "Use a kebab-case id").max(48).describe("Kebab-case id. It becomes the diagram directory name under .uigraph/diagrams/."),
-	name: z.string().min(1).max(60).describe("Plain display name that says what the diagram shows"),
-	type: z.enum([
-		"flowchart",
-		"sequenceDiagram",
-		"stateDiagram-v2",
-		"C4Container",
-		"C4Component"
-	]).describe("Mermaid diagram type"),
-	summary: z.string().min(1).max(160).describe("One line saying what the diagram shows"),
-	evidence: z.array(z.string().min(1)).min(1).max(4).describe("Repository-relative files that prove this flow or structure exists"),
-	recommended: z.boolean().describe("Pre-selected for the owner")
-});
-const docCandidateSchema = z.object({
-	path: z.string().min(1).describe("Repository-relative path of an existing Markdown or HTML document"),
-	name: z.string().min(1).max(60).describe("Plain display name, such as \"Deployment guide\""),
-	summary: z.string().min(1).max(160).describe("One line saying what the document covers")
-});
-function findPlanProblems(diagrams) {
-	const problems = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const { id } of diagrams) {
-		if (seen.has(id)) problems.push(`Duplicate id: ${id}`);
-		seen.add(id);
-	}
-	const recommended = diagrams.filter((diagram) => diagram.recommended).length;
-	if (recommended < 1 || recommended > 8) problems.push(`Mark between 1 and 8 diagrams as recommended (found ${recommended})`);
-	return problems;
-}
-function formatApprovedDiagrams(selection, existing) {
-	const lines = [];
-	if (selection.diagrams.length === 0) lines.push("The owner approved no new architecture diagrams. Do not generate any new architecture diagram.");
-	else {
-		lines.push("Approved diagrams. Generate exactly these under architectureDiagrams, each at .uigraph/diagrams/<id>/<id>.mmd with a context.json, using the listed Mermaid type. Do not generate any other new diagram:");
-		for (const diagram of selection.diagrams) lines.push(`- ${diagram.id} | ${diagram.name} | ${diagram.type} | ${diagram.summary} | evidence: ${diagram.evidence.join(", ")}`);
-	}
-	if (selection.docs.length > 0) {
-		lines.push("Approved existing documents. Add each one under docs with the listed name and its current path, and set fileType to markdown or html. Do not copy, move, or rewrite these files. This replaces the rule in references/docs.md that existing repository documents are never doc artifacts:");
-		for (const doc of selection.docs) lines.push(`- ${doc.path} | ${doc.name} | ${doc.summary}`);
-	}
-	if (existing.length > 0) lines.push(`Diagrams already in the repository (keep them and update them when the code changed): ${existing.join(", ")}.`);
-	if (selection.focus !== null) lines.push(`The owner asked you to focus on: "${selection.focus}". If this names a flow the code shows, add one diagram for it. If the code does not show it, leave it out and say so in your summary. Never invent a flow.`);
-	return lines.join("\n");
-}
-//#endregion
-//#region src/analysis/repo-access.ts
-const EXCLUDED_DIRECTORIES = [
-	".git",
-	"node_modules",
-	"dist",
-	"build",
-	"out",
-	".next",
-	".nuxt",
-	".turbo",
-	".cache",
-	"coverage",
-	"target",
-	"vendor",
-	".venv",
-	"venv",
-	"__pycache__",
-	".terraform",
-	".claude"
-];
-const SECRET_FILE_PATTERNS = [
-	/^\.env(\..+)?$/,
-	/\.(pem|key|p12|pfx|jks|keystore|crt|cer|der)$/,
-	/^id_(rsa|dsa|ecdsa|ed25519)/,
-	/^credentials/,
-	/^secrets?\./,
-	/^\.npmrc$/,
-	/^\.netrc$/,
-	/^\.pypirc$/,
-	/\.tfstate(\.backup)?$/
-];
-const ALLOWED_ENV_FILES = [
-	".env.example",
-	".env.sample",
-	".env.template"
-];
-const IGNORE_GLOBS = EXCLUDED_DIRECTORIES.map((dir) => `**/${dir}/**`);
-const MAX_READ_BYTES = 2e5;
-const MAX_READ_LINES = 2e3;
-const MAX_LIST_RESULTS = 2e3;
-const MAX_SEARCH_MATCHES = 200;
-const MAX_SEARCH_FILE_BYTES = 1e6;
-function isExcludedPath(relativePath) {
-	const segments = relativePath.split("/");
-	if (segments.some((segment) => EXCLUDED_DIRECTORIES.includes(segment))) return true;
-	const fileName = segments[segments.length - 1];
-	if (ALLOWED_ENV_FILES.includes(fileName)) return false;
-	return SECRET_FILE_PATTERNS.some((pattern) => pattern.test(fileName));
-}
-async function resolveRepositoryFile(root, requested) {
-	const normalized = path.posix.normalize(requested.replaceAll("\\", "/"));
-	if (normalized === ".." || normalized.startsWith("../") || path.isAbsolute(normalized)) throw new Error(`Path must be relative to the repository: ${requested}`);
-	const relativePath = normalized.replace(/^\.\//, "");
-	if (isExcludedPath(relativePath)) throw new Error(`Path is excluded from analysis: ${relativePath}`);
-	const absolutePath = path.join(root, relativePath);
-	const realPath = await fs.realpath(absolutePath);
-	if (realPath !== root && !realPath.startsWith(root + path.sep)) throw new Error(`Path resolves outside the repository: ${relativePath}`);
-	return {
-		relativePath,
-		realPath,
-		stat: await fs.stat(realPath)
-	};
-}
-async function listRepositoryFiles(root, pattern) {
-	const files = await glob(pattern, {
-		cwd: root,
-		ignore: IGNORE_GLOBS,
-		dot: true,
-		followSymbolicLinks: false,
-		onlyFiles: true
-	});
-	const allowed = [];
-	for (const file of files.sort()) {
-		if (isExcludedPath(file)) continue;
-		if ((await fs.lstat(path.join(root, file))).isSymbolicLink()) continue;
-		allowed.push(file);
-	}
-	return allowed;
-}
-function isBinary(buffer) {
-	return buffer.subarray(0, 8e3).includes(0);
-}
-function textResult(text) {
-	return { content: [{
-		type: "text",
-		text
-	}] };
-}
-function errorResult(error) {
-	return {
-		content: [{
-			type: "text",
-			text: error instanceof Error ? error.message : String(error)
-		}],
-		isError: true
-	};
-}
-function createRepositoryTools(root, skill, onToolUse, plan) {
-	const onSubmit = plan?.onSubmit;
-	const listFiles = agentTool("list_files", "List repository files matching a glob pattern. Generated directories and secret files are never listed.", { pattern: z.string().default("**/*").describe("Glob relative to the repository root, e.g. src/**/*.ts") }, async ({ pattern }) => {
-		onToolUse({
-			tool: "list_files",
-			pattern
-		});
-		try {
-			const files = await listRepositoryFiles(root, pattern);
-			const shown = files.slice(0, MAX_LIST_RESULTS);
-			const more = files.length > shown.length ? `\n… ${files.length - shown.length} more files; narrow the pattern` : "";
-			return textResult(shown.length === 0 ? "No files matched." : shown.join("\n") + more);
-		} catch (error) {
-			return errorResult(error);
-		}
-	});
-	const readFile = agentTool("read_file", "Read a repository text file. Lines are prefixed with their line numbers.", {
-		path: z.string().describe("Repository-relative file path"),
-		offset: z.number().int().min(1).default(1).describe("First line to read, 1-based"),
-		limit: z.number().int().min(1).max(MAX_READ_LINES).default(MAX_READ_LINES).describe("Maximum number of lines to read")
-	}, async ({ path: requested, offset, limit }) => {
-		onToolUse({
-			tool: "read_file",
-			path: requested
-		});
-		try {
-			const { realPath, stat } = await resolveRepositoryFile(root, requested);
-			if (!stat.isFile()) return errorResult(`Not a file: ${requested}`);
-			const handle = await fs.open(realPath, "r");
-			const buffer = Buffer.alloc(Math.min(stat.size, MAX_READ_BYTES));
-			await handle.read(buffer, 0, buffer.length, 0);
-			await handle.close();
-			if (isBinary(buffer)) return errorResult(`Binary file skipped: ${requested}`);
-			return textResult(buffer.toString("utf8").split("\n").slice(offset - 1, offset - 1 + limit).map((line, index) => `${offset + index}\t${line}`).join("\n") + (stat.size > MAX_READ_BYTES ? `\n… file truncated at ${MAX_READ_BYTES} bytes` : ""));
-		} catch (error) {
-			return errorResult(error);
-		}
-	});
-	const search = agentTool("search", "Search repository text files with a JavaScript regular expression. Returns path:line: text matches.", {
-		pattern: z.string().describe("JavaScript regular expression"),
-		glob: z.string().default("**/*").describe("Glob limiting which files are searched"),
-		caseInsensitive: z.boolean().default(false)
-	}, async ({ pattern, glob: fileGlob, caseInsensitive }) => {
-		onToolUse({
-			tool: "search",
-			pattern,
-			glob: fileGlob
-		});
-		try {
-			const regex = new RegExp(pattern, caseInsensitive ? "i" : "");
-			const files = await listRepositoryFiles(root, fileGlob);
-			const matches = [];
-			for (const file of files) {
-				const absolutePath = path.join(root, file);
-				if ((await fs.stat(absolutePath)).size > MAX_SEARCH_FILE_BYTES) continue;
-				const buffer = await fs.readFile(absolutePath);
-				if (isBinary(buffer)) continue;
-				const lines = buffer.toString("utf8").split("\n");
-				for (let index = 0; index < lines.length; index++) {
-					if (regex.test(lines[index])) matches.push(`${file}:${index + 1}: ${lines[index].trim().slice(0, 300)}`);
-					if (matches.length >= MAX_SEARCH_MATCHES) break;
-				}
-				if (matches.length >= MAX_SEARCH_MATCHES) {
-					matches.push(`… stopped at ${MAX_SEARCH_MATCHES} matches`);
-					break;
-				}
-			}
-			return textResult(matches.length === 0 ? "No matches." : matches.join("\n"));
-		} catch (error) {
-			return errorResult(error);
-		}
-	});
-	const writeFile = agentTool("write_file", "Create or replace a UIGraph artifact. Only .uigraph.yaml and files under .uigraph/ can be written.", {
-		path: z.string().describe("Repository-relative path: .uigraph.yaml or .uigraph/..."),
-		content: z.string().describe("Complete file content")
-	}, async ({ path: requested, content }) => {
-		onToolUse({
-			tool: "write_file",
-			path: requested
-		});
-		try {
-			return textResult(`Wrote ${await writeArtifactFile(root, requested, content)}`);
-		} catch (error) {
-			return errorResult(error);
+	const services = [];
+	const serviceFiles = [];
+	const serviceIdByName = /* @__PURE__ */ new Map();
+	for (const { file, config, updatedAt } of configs) {
+		if (config.service === void 0) continue;
+		const id = slugify(config.service.name);
+		if (serviceIdByName.has(config.service.name) || services.some((s) => s.id === id)) {
+			errors.push(`${file}: duplicate service "${config.service.name}"`);
+			continue;
 		}
-	});
-	const validateArtifacts = agentTool("validate_artifacts", "Load .uigraph.yaml and every artifact it references the way the UIGraph viewer does, and list every problem found.", {}, async () => {
-		onToolUse({ tool: "validate_artifacts" });
-		const { errors } = await loadArtifacts(root);
-		return textResult(errors.length === 0 ? "All artifacts are valid." : errors.map((error) => `- ${error}`).join("\n"));
-	});
-	const readSkillFile = agentTool("read_skill_file", "Read a file from the UIGraph skill, e.g. references/uigraph-yaml-schema.md or assets/templates/context-example.json.", { path: z.string().describe("Path relative to the skill directory") }, async ({ path: requested }) => {
-		onToolUse({
-			tool: "read_skill_file",
-			path: requested
+		serviceIdByName.set(config.service.name, id);
+		services.push(toServiceEntity(id, config.service, updatedAt));
+		serviceFiles.push({
+			serviceId: id,
+			file
 		});
-		const content = skill.get(path.posix.normalize(requested.replaceAll("\\", "/")).replace(/^\.\//, ""));
-		if (content === void 0) return errorResult(`The skill has no file ${requested}`);
-		return textResult(content);
-	});
-	function createSubmitPlanTool(submit) {
-		return agentTool("submit_diagram_plan", "Submit the architecture diagrams worth generating and the existing documents worth adding for this repository. Call it exactly once, when you finish exploring.", {
-			diagrams: z.array(diagramCandidateSchema).min(1).max(15),
-			docs: z.array(docCandidateSchema).max(10)
-		}, async ({ diagrams, docs }) => {
-			onToolUse({
-				tool: "submit_diagram_plan",
-				count: diagrams.length
-			});
+	}
+	const apiGroups = [];
+	for (const { file, config, updatedAt } of configs) {
+		if (config.service === void 0) continue;
+		const serviceId = serviceIdByName.get(config.service.name);
+		if (serviceId === void 0) continue;
+		for (const api of config.apis) {
+			let text;
+			let endpoints;
 			try {
-				const problems = findPlanProblems(diagrams);
-				for (const diagram of diagrams) for (const file of diagram.evidence) try {
-					const { stat } = await resolveRepositoryFile(root, file);
-					if (!stat.isFile()) problems.push(`${diagram.id}: evidence is not a file: ${file}`);
-				} catch {
-					problems.push(`${diagram.id}: evidence file not found: ${file}`);
-				}
-				for (const doc of docs) {
-					if (!/\.(md|markdown|html?)$/i.test(doc.path)) {
-						problems.push(`${doc.path}: not a Markdown or HTML document`);
-						continue;
-					}
-					try {
-						const { stat } = await resolveRepositoryFile(root, doc.path);
-						if (!stat.isFile()) problems.push(`${doc.path}: document is not a file`);
-					} catch {
-						problems.push(`${doc.path}: document not found`);
-					}
-				}
-				if (problems.length > 0) return errorResult(`The plan was not accepted. Fix these and submit again:\n${problems.map((problem) => `- ${problem}`).join("\n")}`);
-				submit({
-					diagrams,
-					docs
-				});
-				return textResult("Plan received. Stop here.");
+				text = (await readArtifactFile(root, api.path)).text;
+				endpoints = parseApiSpec(api.type, text);
 			} catch (error) {
-				return errorResult(error);
+				errors.push(`${file}: apis[${api.name}]: ${describe(error)}`);
+				continue;
 			}
-		});
-	}
-	return onSubmit === void 0 ? [
-		listFiles,
-		readFile,
-		search,
-		writeFile,
-		validateArtifacts,
-		readSkillFile
-	] : [
-		listFiles,
-		readFile,
-		search,
-		readSkillFile,
-		createSubmitPlanTool(onSubmit)
-	];
-}
-//#endregion
-//#region src/artifacts/load.ts
-const ROOT_CONFIG = ".uigraph.yaml";
-const ORG_ID = "local";
-const ACTOR_ID = "uigraph";
-const MAX_FILE_BYTES = 2e6;
-const HTTP_METHODS = [
-	"get",
-	"put",
-	"post",
-	"delete",
-	"patch",
-	"options",
-	"head",
-	"trace"
-];
-const DOC_FILE_TYPES = [
-	"pdf",
-	"html",
-	"markdown",
-	"doc",
-	"txt",
-	"image",
-	"video",
-	"audio",
-	"other"
-];
-const DOC_EXTENSIONS = {
-	".pdf": "pdf",
-	".html": "html",
-	".htm": "html",
-	".md": "markdown",
-	".markdown": "markdown",
-	".doc": "doc",
-	".docx": "doc",
-	".txt": "txt",
-	".png": "image",
-	".jpg": "image",
-	".jpeg": "image",
-	".gif": "image",
-	".webp": "image",
-	".svg": "image",
-	".mp4": "video",
-	".mov": "video",
-	".webm": "video",
-	".mp3": "audio",
-	".wav": "audio",
-	".ogg": "audio",
-	".m4a": "audio"
-};
-const DATABASE_DIALECTS = [
-	"postgres",
-	"mysql",
-	"sqlite",
-	"other",
-	"dynamodb",
-	"mongodb"
-];
-const queryEntrySchema = z.looseObject({
-	name: z.string().min(1),
-	database: z.string().min(1),
-	path: z.string().min(1).optional(),
-	queryText: z.string().min(1).optional(),
-	description: z.string().optional(),
-	tags: z.array(z.string()).optional()
-});
-const queryFileSchema = z.looseObject({ queries: z.array(queryEntrySchema).default([]) });
-const componentRefSchema = z.looseObject({
-	componentId: z.string().min(1),
-	componentLinkId: z.string().optional(),
-	serviceName: z.string().optional(),
-	apiGroupName: z.string().optional(),
-	operationId: z.string().optional(),
-	testPackName: z.string().optional(),
-	docName: z.string().optional(),
-	architectureDiagramName: z.string().optional(),
-	modalFields: z.array(z.looseObject({
-		componentFieldId: z.string(),
-		label: z.string().optional(),
-		type: z.string().optional(),
-		data: z.array(z.unknown()).optional()
-	})).optional()
-});
-const mapSchema = z.looseObject({
-	name: z.string().min(1),
-	description: z.string().optional(),
-	frames: z.array(z.looseObject({
-		name: z.string().min(1),
-		description: z.string().optional(),
-		imagePath: z.string().min(1).optional(),
-		focalPoints: z.array(z.looseObject({
-			name: z.string().min(1),
-			x: z.number(),
-			y: z.number(),
-			visibility: z.string().optional(),
-			color: z.string().optional(),
-			components: z.array(componentRefSchema).optional()
-		})).optional()
-	})).optional()
-});
-const CANVAS_FILE = ".uigraph/maps/canvas.json";
-const canvasPointSchema = z.object({
-	x: z.number(),
-	y: z.number()
-});
-const canvasFileSchema = z.record(z.string(), z.object({
-	zoom: z.number().optional(),
-	navigationX: z.number().optional(),
-	navigationY: z.number().optional(),
-	framePositions: z.record(z.string(), canvasPointSchema).optional(),
-	frames: z.record(z.string(), z.object({
-		groups: z.array(canvasPointSchema.extend({
-			name: z.string(),
-			description: z.string(),
-			width: z.number(),
-			height: z.number()
-		})).optional(),
-		links: z.array(canvasPointSchema.extend({
-			kind: z.enum(["frame", "map"]),
-			map: z.string(),
-			frame: z.string().optional(),
-			label: z.string()
-		})).optional()
-	})).optional()
-}));
-const configSchema = z.looseObject({
-	version: z.literal(1),
-	service: z.looseObject({
-		name: z.string().min(1),
-		category: z.string().min(1),
-		description: z.string().min(1),
-		repository: z.looseObject({
-			provider: z.string(),
-			url: z.string()
-		}).optional(),
-		ownership: z.looseObject({ team: z.string().min(1) }).optional(),
-		labels: z.array(z.string()).optional(),
-		integrations: z.looseObject({
-			slack: z.looseObject({ url: z.string() }).optional(),
-			jira: z.looseObject({ url: z.string() }).optional()
-		}).optional()
-	}).optional(),
-	apis: z.array(z.looseObject({
-		name: z.string().min(1),
-		type: z.enum([
-			"openapi",
-			"graphql",
-			"grpc"
-		]),
-		path: z.string().min(1)
-	})).default([]),
-	dependencies: z.array(z.looseObject({
-		name: z.string().min(1),
-		service: z.string().min(1),
-		direction: z.enum(["upstream", "downstream"]),
-		criticality: z.enum(["hard", "soft"]),
-		type: z.enum([
-			"http",
-			"graphql",
-			"grpc",
-			"database"
-		]).optional(),
-		description: z.string().optional(),
-		apiGroupName: z.string().optional(),
-		apiEndpointNames: z.array(z.string().min(1)).optional(),
-		databaseName: z.string().optional()
-	})).default([]),
-	architectureDiagrams: z.array(z.looseObject({
-		name: z.string().min(1),
-		path: z.string().min(1),
-		contextPath: z.string().min(1).optional()
-	})).default([]),
-	docs: z.array(z.looseObject({
-		name: z.string().min(1),
-		path: z.string().min(1),
-		fileType: z.enum(DOC_FILE_TYPES).optional(),
-		description: z.string().optional()
-	})).default([]),
-	databases: z.array(z.looseObject({
-		name: z.string().min(1),
-		dialect: z.enum(DATABASE_DIALECTS),
-		dbType: z.string().optional(),
-		schemaPath: z.string().min(1)
-	})).default([]),
-	queries: z.array(queryEntrySchema).default([]),
-	queryFiles: z.array(z.string().min(1)).default([]),
-	maps: z.array(mapSchema).default([])
-});
-const PROTOCOL_LABELS = {
-	openapi: "REST",
-	graphql: "GraphQL",
-	grpc: "gRPC"
-};
-function slugify(value) {
-	return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-}
-function describe(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-function contentHash(...parts) {
-	const hash = createHash("sha256");
-	for (const part of parts) hash.update(part);
-	return hash.digest("hex");
-}
-async function readArtifactFile(root, relativePath) {
-	const { realPath, stat } = await resolveRepositoryFile(root, relativePath);
-	if (!stat.isFile()) throw new Error(`Not a file: ${relativePath}`);
-	if (stat.size > MAX_FILE_BYTES) throw new Error(`File is larger than ${MAX_FILE_BYTES} bytes: ${relativePath}`);
-	return {
-		text: await fs.readFile(realPath, "utf8"),
-		updatedAt: stat.mtime.toISOString()
-	};
-}
-function parseOpenApi(text) {
-	const spec = parse$1(text);
-	if (spec === null || typeof spec !== "object") throw new Error("not an OpenAPI document");
-	return Object.entries(spec.paths ?? {}).flatMap(([route, operations]) => HTTP_METHODS.filter((method) => operations[method] !== void 0).map((method) => {
-		const operation = operations[method];
-		return {
-			method: method.toUpperCase(),
-			path: route,
-			operationId: typeof operation.operationId === "string" ? operation.operationId : `${method.toUpperCase()} ${route}`,
-			summary: typeof operation.summary === "string" ? operation.summary : "",
-			description: typeof operation.description === "string" ? operation.description : "",
-			parameters: "[]"
-		};
-	}));
-}
-function parseGraphQLSchema(text) {
-	return parse(text).definitions.flatMap((definition) => {
-		if (definition.kind !== Kind.OBJECT_TYPE_DEFINITION && definition.kind !== Kind.OBJECT_TYPE_EXTENSION || ![
-			"Query",
-			"Mutation",
-			"Subscription"
-		].includes(definition.name.value)) return [];
-		return (definition.fields ?? []).map((field) => {
-			const args = field.arguments === void 0 || field.arguments.length === 0 ? "" : `(${field.arguments.map((arg) => `${arg.name.value}: ${print(arg.type)}`).join(", ")})`;
-			return {
-				method: definition.name.value,
-				path: `${field.name.value}${args}: ${print(field.type)}`,
-				operationId: field.name.value,
-				summary: "",
-				description: field.description?.value ?? "",
-				parameters: "[]"
-			};
-		});
-	});
-}
-function parseProto(text) {
-	const packageName = /^\s*package\s+([\w.]+)\s*;/m.exec(text)?.[1] ?? "";
-	const services = [...text.matchAll(/\bservice\s+(\w+)\s*\{/g)];
-	return [...text.matchAll(/\brpc\s+(\w+)\s*\(\s*(stream\s+)?[\w.]+\s*\)\s*returns\s*\(\s*(stream\s+)?[\w.]+\s*\)/g)].map((rpc) => {
-		const service = services.filter((match) => match.index < rpc.index).pop();
-		if (service === void 0) throw new Error(`rpc ${rpc[1]} is outside a service`);
-		const clientStream = rpc[2] !== void 0;
-		const serverStream = rpc[3] !== void 0;
-		const qualifiedService = packageName === "" ? service[1] : `${packageName}.${service[1]}`;
-		return {
-			method: clientStream && serverStream ? "bidirectional" : clientStream ? "client_streaming" : serverStream ? "server_streaming" : "unary",
-			path: `${qualifiedService}/${rpc[1]}`,
-			operationId: rpc[1],
-			summary: "",
-			description: "",
-			parameters: JSON.stringify({
-				packageName,
-				serviceName: service[1]
-			})
-		};
-	});
-}
-function parseApiSpec(type, text) {
-	if (type === "openapi") return parseOpenApi(text);
-	if (type === "graphql") return parseGraphQLSchema(text);
-	if (type === "grpc") return parseProto(text);
-	throw new Error(`Unknown API type: ${String(type)}`);
-}
-async function convertDiagram(mermaid, context) {
-	if (context === void 0) return convertMermaidToReactFlow(mermaid);
-	return convertMermaidToReactFlowWithContext(mermaid, contextSchema.parse(context), { repositionNodes: true });
-}
-function parseDatabaseSchema(dialect, text) {
-	if (dialect === "dynamodb") {
-		const table = DynamoEditorSchema.parse(JSON.parse(text));
-		return {
-			sdkDialect: dialect,
-			ast: convertDynamoSchemaToAst(table),
-			sourceContent: table,
-			noSQLSchema: { dynamo: { table } }
-		};
-	}
-	if (dialect === "mongodb") {
-		const schema = MongoEditorSchema.parse(JSON.parse(text));
-		return {
-			sdkDialect: dialect,
-			ast: convertMongoSchemaToAst(schema),
-			sourceContent: schema,
-			noSQLSchema: { mongo: { collections: schema.collections } }
-		};
-	}
-	const sdkDialect = dialect === "postgres" ? "postgresql" : dialect === "other" ? SqlToAstParser.detectDialect(text) : dialect;
-	return {
-		sdkDialect,
-		ast: new SqlToAstParser(sdkDialect).parse(text),
-		sourceContent: void 0,
-		noSQLSchema: null
-	};
-}
-function toTables(ast) {
-	return ast.tables.map((table) => ({
-		name: table.name,
-		columns: table.columns.map((column) => ({
-			name: column.name,
-			type: column.dataType.name,
-			nullable: column.nullable,
-			description: column.comment || null,
-			isPrimaryKey: table.constraints.some((c) => c.type === "primary_key" && c.columns.includes(column.name))
-		})),
-		indexes: []
-	}));
-}
-function toServiceEntity(id, service, updatedAt) {
-	return {
-		id,
-		orgId: ORG_ID,
-		folderId: null,
-		teamId: null,
-		name: service.name,
-		description: service.description,
-		status: "active",
-		tier: "tier3",
-		category: service.category,
-		language: "",
-		gitRepoUrl: service.repository?.url ?? null,
-		jiraProjectUrl: service.integrations?.jira?.url ?? null,
-		slackChannelUrl: service.integrations?.slack?.url ?? null,
-		lastCommitSha: null,
-		labels: service.labels ?? [],
-		metadata: "{}",
-		docLinks: null,
-		createdBy: ACTOR_ID,
-		updatedBy: null,
-		stats: {
-			serviceId: id,
-			endpointCount: 0,
-			diagramCount: 0,
-			dbTableCount: 0,
-			docCount: 0,
-			testCaseCount: 0
-		},
-		createdAt: updatedAt,
-		updatedAt
-	};
-}
-async function loadArtifacts(root, configFile = ROOT_CONFIG) {
-	const errors = [];
-	const configFiles = [configFile];
-	if (configFile === ".uigraph.yaml") configFiles.push(...(await glob(".uigraph/services/*.yaml", {
-		cwd: root,
-		dot: true,
-		onlyFiles: true,
-		followSymbolicLinks: false
-	})).sort());
-	const configs = [];
-	for (const file of configFiles) try {
-		const { text, updatedAt } = await readArtifactFile(root, file);
-		const parsed = configSchema.safeParse(parse$1(text));
-		if (!parsed.success) {
-			for (const issue of parsed.error.issues) errors.push(`${file}: ${issue.path.join(".") || "root"}: ${issue.message}`);
-			continue;
-		}
-		configs.push({
-			file,
-			config: parsed.data,
-			updatedAt
-		});
-	} catch (error) {
-		errors.push(`${file}: ${describe(error)}`);
-	}
-	for (const { file, config } of configs) if (config.service === void 0) {
-		if (config.apis.length > 0 || config.dependencies.length > 0 || config.databases.length > 0 || config.queries.length > 0 || config.queryFiles.length > 0) errors.push(`${file}: apis, dependencies, databases and queries require a service block`);
-	}
-	const services = [];
-	const serviceFiles = [];
-	const serviceIdByName = /* @__PURE__ */ new Map();
-	for (const { file, config, updatedAt } of configs) {
-		if (config.service === void 0) continue;
-		const id = slugify(config.service.name);
-		if (serviceIdByName.has(config.service.name) || services.some((s) => s.id === id)) {
-			errors.push(`${file}: duplicate service "${config.service.name}"`);
-			continue;
-		}
-		serviceIdByName.set(config.service.name, id);
-		services.push(toServiceEntity(id, config.service, updatedAt));
-		serviceFiles.push({
-			serviceId: id,
-			file
-		});
-	}
-	const apiGroups = [];
-	for (const { file, config, updatedAt } of configs) {
-		if (config.service === void 0) continue;
-		const serviceId = serviceIdByName.get(config.service.name);
-		if (serviceId === void 0) continue;
-		for (const api of config.apis) {
-			let text;
-			let endpoints;
-			try {
-				text = (await readArtifactFile(root, api.path)).text;
-				endpoints = parseApiSpec(api.type, text);
-			} catch (error) {
-				errors.push(`${file}: apis[${api.name}]: ${describe(error)}`);
-				continue;
-			}
-			const id = slugify(`${serviceId}-${api.name}`);
-			const hash = contentHash(text);
-			const fileName = path.posix.basename(api.path);
-			apiGroups.push({
-				group: {
-					id,
-					serviceId,
-					orgId: ORG_ID,
-					name: api.name,
-					version: "1",
-					label: null,
-					protocol: PROTOCOL_LABELS[api.type],
-					specKey: fileName,
-					specHash: hash,
-					createdBy: ACTOR_ID,
-					updatedBy: null,
-					createdAt: updatedAt,
-					updatedAt
-				},
-				version: {
-					id: `${id}-v1`,
-					orgId: ORG_ID,
-					apiGroupId: id,
-					versionNumber: 1,
-					label: null,
-					specKey: fileName,
-					specHash: hash,
-					isAutoVersion: false,
-					createdBy: ACTOR_ID,
-					createdAt: updatedAt
-				},
-				spec: api.type === "openapi" ? {
-					fileName,
-					content: text
-				} : null,
-				endpoints: endpoints.map((endpoint, index) => ({
-					id: slugify(`${id}-${endpoint.method}-${endpoint.path}`),
-					apiGroupId: id,
-					serviceId,
-					orgId: ORG_ID,
-					operationId: endpoint.operationId,
-					method: endpoint.method,
-					path: endpoint.path,
-					summary: endpoint.summary,
-					description: endpoint.description,
-					tags: [],
-					parameters: endpoint.parameters,
-					requestBody: "{}",
-					responses: "{}",
-					exampleRequests: "[]",
-					exampleResponses: "[]",
-					order: index,
-					sla: null,
-					createdBy: ACTOR_ID,
-					updatedBy: null,
-					createdAt: updatedAt,
-					updatedAt
-				}))
-			});
-		}
+			const id = slugify(`${serviceId}-${api.name}`);
+			const hash = contentHash(text);
+			const fileName = path.posix.basename(api.path);
+			apiGroups.push({
+				group: {
+					id,
+					serviceId,
+					orgId: ORG_ID,
+					name: api.name,
+					version: "1",
+					label: null,
+					protocol: PROTOCOL_LABELS[api.type],
+					specKey: fileName,
+					specHash: hash,
+					createdBy: ACTOR_ID,
+					updatedBy: null,
+					createdAt: updatedAt,
+					updatedAt
+				},
+				version: {
+					id: `${id}-v1`,
+					orgId: ORG_ID,
+					apiGroupId: id,
+					versionNumber: 1,
+					label: null,
+					specKey: fileName,
+					specHash: hash,
+					isAutoVersion: false,
+					createdBy: ACTOR_ID,
+					createdAt: updatedAt
+				},
+				spec: api.type === "openapi" ? {
+					fileName,
+					content: text
+				} : null,
+				endpoints: endpoints.map((endpoint, index) => ({
+					id: slugify(`${id}-${endpoint.method}-${endpoint.path}`),
+					apiGroupId: id,
+					serviceId,
+					orgId: ORG_ID,
+					operationId: endpoint.operationId,
+					method: endpoint.method,
+					path: endpoint.path,
+					summary: endpoint.summary,
+					description: endpoint.description,
+					tags: [],
+					parameters: endpoint.parameters,
+					requestBody: "{}",
+					responses: "{}",
+					exampleRequests: "[]",
+					exampleResponses: "[]",
+					order: index,
+					sla: null,
+					createdBy: ACTOR_ID,
+					updatedBy: null,
+					createdAt: updatedAt,
+					updatedAt
+				}))
+			});
+		}
 	}
 	const diagrams = [];
 	const diagramIds = /* @__PURE__ */ new Set();
@@ -1347,7 +673,7 @@ async function loadArtifacts(root, configFile = ROOT_CONFIG) {
 				fileUrl: null,
 				fileName: entry.name,
 				serviceName: config.service?.name ?? null,
-				fileType: entry.fileType ?? DOC_EXTENSIONS[path.posix.extname(entry.path).toLowerCase()] ?? "other",
+				fileType: entry.fileType ?? DOC_EXTENSIONS$1[path.posix.extname(entry.path).toLowerCase()] ?? "other",
 				description: entry.description ?? "",
 				contentHash: `${stat.size}-${stat.mtimeMs}`,
 				createdBy: ACTOR_ID,
@@ -1552,533 +878,791 @@ async function loadArtifacts(root, configFile = ROOT_CONFIG) {
 			});
 		}
 	}
-	let canvas = {};
-	try {
-		const parsed = canvasFileSchema.safeParse(JSON.parse((await readArtifactFile(root, CANVAS_FILE)).text));
-		if (parsed.success) canvas = parsed.data;
-		else for (const issue of parsed.error.issues) errors.push(`${CANVAS_FILE}: ${issue.path.join(".") || "root"}: ${issue.message}`);
-	} catch (error) {
-		if (error.code !== "ENOENT") errors.push(`${CANVAS_FILE}: ${describe(error)}`);
+	let canvas = {};
+	try {
+		const parsed = canvasFileSchema.safeParse(JSON.parse((await readArtifactFile(root, CANVAS_FILE)).text));
+		if (parsed.success) canvas = parsed.data;
+		else for (const issue of parsed.error.issues) errors.push(`${CANVAS_FILE}: ${issue.path.join(".") || "root"}: ${issue.message}`);
+	} catch (error) {
+		if (error.code !== "ENOENT") errors.push(`${CANVAS_FILE}: ${describe(error)}`);
+	}
+	const maps = [];
+	const mapIds = /* @__PURE__ */ new Set();
+	for (const { file, config, updatedAt } of configs) for (const [index, entry] of config.maps.entries()) {
+		const where = `${file}: maps[${entry.name}]`;
+		const id = slugify(entry.name);
+		if (mapIds.has(id)) {
+			errors.push(`${where}: another map has the same name`);
+			continue;
+		}
+		mapIds.add(id);
+		const mapCanvas = canvas[entry.name] ?? {};
+		const frames = [];
+		const frameIds = /* @__PURE__ */ new Set();
+		for (const [frameIndex, frameEntry] of (entry.frames ?? []).entries()) {
+			const frameWhere = `${where}: frames[${frameEntry.name}]`;
+			const frameId = `${id}--${slugify(frameEntry.name)}`;
+			if (frameIds.has(frameId)) {
+				errors.push(`${frameWhere}: another frame has the same name`);
+				continue;
+			}
+			frameIds.add(frameId);
+			let imageHash = null;
+			if (frameEntry.imagePath !== void 0) try {
+				const { stat } = await resolveRepositoryFile(root, frameEntry.imagePath);
+				if (!stat.isFile()) throw new Error(`Not a file: ${frameEntry.imagePath}`);
+				imageHash = `${stat.size}-${stat.mtimeMs}`;
+			} catch (error) {
+				errors.push(`${frameWhere}: ${describe(error)}`);
+				continue;
+			}
+			const pointNames = /* @__PURE__ */ new Set();
+			const focalPoints = [];
+			for (const [pointIndex, point] of (frameEntry.focalPoints ?? []).entries()) {
+				if (pointNames.has(point.name)) {
+					errors.push(`${frameWhere}: focalPoints[${point.name}]: another focal point has the same name`);
+					continue;
+				}
+				pointNames.add(point.name);
+				const pointId = `${frameId}--p${pointIndex}`;
+				focalPoints.push({
+					point: {
+						id: pointId,
+						frameId,
+						orgId: ORG_ID,
+						name: point.name,
+						locationX: point.x,
+						locationY: point.y,
+						visibility: point.visibility ?? "public",
+						color: point.color ?? null,
+						isActive: true,
+						createdBy: ACTOR_ID,
+						updatedBy: null,
+						createdByCommitHash: null,
+						updatedByCommitHash: null,
+						createdAt: updatedAt,
+						updatedAt
+					},
+					components: (point.components ?? []).map((ref, refIndex) => ({
+						ref,
+						meta: {
+							id: `${pointId}--c${refIndex}`,
+							focalPointId: pointId,
+							orgId: ORG_ID,
+							frameId,
+							componentId: ref.componentId,
+							componentLinkDiagramId: null,
+							componentLinkApiEndpointId: null,
+							componentLinkTestPackId: null,
+							componentLinkServiceDocId: null,
+							componentModalFields: (ref.modalFields ?? []).map((field, order) => ({
+								componentFieldId: field.componentFieldId,
+								label: field.label ?? null,
+								type: field.type ?? null,
+								required: null,
+								isReadonly: null,
+								data: field.data ?? null,
+								options: null,
+								order
+							})),
+							createdBy: ACTOR_ID,
+							updatedBy: null,
+							createdByCommitHash: null,
+							updatedByCommitHash: null,
+							createdAt: updatedAt,
+							updatedAt
+						}
+					}))
+				});
+			}
+			const frameCanvas = mapCanvas.frames?.[frameEntry.name] ?? {};
+			frames.push({
+				name: frameEntry.name,
+				frame: {
+					id: frameId,
+					mapId: id,
+					orgId: ORG_ID,
+					parentFrameId: null,
+					name: frameEntry.name,
+					description: frameEntry.description ?? "",
+					templateType: "default",
+					screenshotAssetId: frameEntry.imagePath ?? null,
+					screenshotImageUrl: null,
+					screenshotContentHash: imageHash,
+					status: "active",
+					order: frameIndex,
+					source: "cli",
+					focalPointCount: focalPoints.length,
+					createdBy: ACTOR_ID,
+					updatedBy: null,
+					createdByCommitHash: null,
+					updatedByCommitHash: null,
+					createdByActor: null,
+					updatedByActor: null,
+					createdAt: updatedAt,
+					updatedAt
+				},
+				focalPoints,
+				groups: (frameCanvas.groups ?? []).map((group, groupIndex) => ({
+					id: `${frameId}--g${groupIndex}`,
+					frameId,
+					orgId: ORG_ID,
+					name: group.name,
+					description: group.description,
+					locationX: group.x,
+					locationY: group.y,
+					width: group.width,
+					height: group.height,
+					order: groupIndex,
+					isActive: true,
+					createdBy: ACTOR_ID,
+					updatedBy: null,
+					createdAt: updatedAt,
+					updatedAt
+				})),
+				links: (frameCanvas.links ?? []).map((link, linkIndex) => ({
+					target: {
+						map: link.map,
+						frame: link.frame
+					},
+					link: {
+						id: `${frameId}--l${linkIndex}`,
+						frameId,
+						orgId: ORG_ID,
+						kind: link.kind,
+						targetFrameId: null,
+						targetMapId: null,
+						label: link.label,
+						locationX: link.x,
+						locationY: link.y,
+						isActive: true,
+						createdBy: ACTOR_ID,
+						updatedBy: null,
+						createdAt: updatedAt,
+						updatedAt
+					}
+				}))
+			});
+		}
+		maps.push({
+			file,
+			index,
+			entry,
+			canvas: mapCanvas,
+			frames,
+			map: {
+				id,
+				orgId: ORG_ID,
+				folderId: null,
+				teamId: null,
+				name: entry.name,
+				description: entry.description ?? "",
+				status: "active",
+				createdBy: ACTOR_ID,
+				updatedBy: null,
+				createdByCommitHash: null,
+				updatedByCommitHash: null,
+				createdAt: updatedAt,
+				updatedAt,
+				previewImgUrls: []
+			}
+		});
+	}
+	const dependencies = [];
+	for (const { file, config } of configs) {
+		if (config.service === void 0) continue;
+		const service = services.find((s) => s.id === serviceIdByName.get(config.service.name));
+		if (service === void 0) continue;
+		const names = /* @__PURE__ */ new Set();
+		for (const dependency of config.dependencies) {
+			const where = `${file}: dependencies[${dependency.name}]`;
+			if (names.has(dependency.name)) errors.push(`${where}: duplicate dependency name`);
+			names.add(dependency.name);
+			if (dependency.service === config.service.name) errors.push(`${where}: a service cannot depend on itself`);
+			const endpointNames = dependency.apiEndpointNames ?? [];
+			if (new Set(endpointNames).size !== endpointNames.length) errors.push(`${where}: apiEndpointNames must be unique`);
+			const target = services.find((s) => s.id === slugify(dependency.service));
+			dependencies.push({
+				id: slugify(`${service.id}-${dependency.name}`),
+				name: dependency.name,
+				service: toDependencyService(service),
+				dependency: target === void 0 ? null : toDependencyService(target),
+				dependencyName: dependency.service,
+				direction: dependency.direction,
+				type: dependency.type ?? null,
+				criticality: dependency.criticality,
+				description: dependency.description ?? null,
+				apiGroupName: dependency.apiGroupName ?? null,
+				apiEndpointNames: endpointNames,
+				databaseName: dependency.databaseName ?? null
+			});
+		}
+	}
+	for (const service of services) {
+		service.stats.endpointCount = apiGroups.filter(({ group }) => group.serviceId === service.id).reduce((count, { endpoints }) => count + endpoints.length, 0);
+		service.stats.diagramCount = serviceDiagrams.filter((link) => link.serviceId === service.id).length;
+		service.stats.docCount = docs.filter(({ serviceDoc }) => serviceDoc.serviceId === service.id).length;
+		service.stats.dbTableCount = databases.filter(({ serviceDb }) => serviceDb.serviceId === service.id).reduce((count, { serviceDb }) => count + serviceDb.tables.length, 0);
+	}
+	return {
+		errors,
+		db: {
+			configFiles: configs.map(({ file }) => file),
+			services,
+			serviceFiles,
+			apiGroups,
+			diagrams,
+			serviceDiagrams,
+			docs,
+			standaloneDocs,
+			databases,
+			queries,
+			maps,
+			dependencies
+		}
+	};
+}
+function toDependencyService(service) {
+	return {
+		id: service.id,
+		name: service.name,
+		description: service.description,
+		status: service.status,
+		tier: service.tier,
+		category: service.category,
+		language: service.language,
+		gitRepoUrl: service.gitRepoUrl,
+		updatedAt: service.updatedAt,
+		metadata: null
+	};
+}
+//#endregion
+//#region src/version.ts
+const { version } = createRequire(import.meta.url)("../package.json");
+const VERSION = version;
+const BUILD_ID = createHash("sha1").update(readFileSync(new URL(import.meta.url))).digest("hex").slice(0, 8);
+//#endregion
+//#region src/banner.ts
+const NAME = "UIGraph";
+const WEBSITE = "https://uigraph.app";
+const TAGLINE = "Map your project into services, APIs and diagrams";
+function blue(text) {
+	return pc.isColorSupported ? `\x1b[38;2;59;107;255m${text}\x1b[39m` : text;
+}
+const MARK = [[
+	0,
+	0,
+	pc.white("⏺")
+]];
+for (let col = 1; col < 5; col++) MARK.push([
+	0,
+	col,
+	blue("━")
+]);
+MARK.push([
+	0,
+	5,
+	blue("⏺")
+]);
+MARK.push([
+	1,
+	5,
+	blue("┃")
+]);
+MARK.push([
+	2,
+	5,
+	blue("⏺")
+]);
+for (let col = 4; col > 0; col--) MARK.push([
+	2,
+	col,
+	blue("━")
+]);
+MARK.push([
+	2,
+	0,
+	blue("⏺")
+]);
+MARK.push([
+	1,
+	0,
+	blue("┃")
+]);
+function imageProtocol() {
+	const program = process.env.TERM_PROGRAM;
+	if (program === "iTerm.app" || program === "WezTerm") return "iterm";
+	if (program === "ghostty" || process.env.TERM === "xterm-kitty" || process.env.KITTY_WINDOW_ID) return "kitty";
+	return null;
+}
+function logoImage(protocol) {
+	const file = fs$1.readFileSync(new URL("./uigraph-mark.png", import.meta.url));
+	const png = file.toString("base64");
+	if (protocol === "iterm") return `\x1b]1337;File=inline=1;size=${file.length};height=3;preserveAspectRatio=1:${png}\x07`;
+	const chunks = png.match(/.{1,4096}/g);
+	return chunks.map((chunk, index) => {
+		const more = index < chunks.length - 1 ? 1 : 0;
+		return `\x1b_G${index === 0 ? `a=T,f=100,r=3,C=1,q=2,m=${more}` : `m=${more}`};${chunk}\x1b\\`;
+	}).join("");
+}
+function render(frame, markFrames) {
+	const grid = Array.from({ length: 3 }, () => Array(6).fill(" "));
+	for (const [row, col, char] of MARK.slice(0, Math.min(frame, markFrames))) grid[row][col] = char;
+	const letters = Math.max(0, frame - markFrames);
+	const done = letters > 7;
+	const text = [
+		pc.bold(NAME.slice(0, letters)) + (done ? pc.dim(` v${VERSION}`) : ""),
+		done ? blue(WEBSITE) : "",
+		done ? pc.dim(TAGLINE) : ""
+	];
+	return grid.map((cells, row) => `  ${cells.join("")}    ${text[row]}\x1b[K`).join("\n");
+}
+async function showBanner() {
+	if (!process.stdout.isTTY) return;
+	const protocol = imageProtocol();
+	const markFrames = protocol ? 0 : MARK.length;
+	const frames = markFrames + 7 + 1;
+	process.stdout.write("\n");
+	for (let frame = 1; frame <= frames; frame++) {
+		process.stdout.write(`${frame === 1 ? "" : "\x1B[2A\r"}${render(frame, markFrames)}`);
+		if (frame === frames && protocol) process.stdout.write(`\x1b7\x1b[2A\r\x1b[2C${logoImage(protocol)}\x1b8`);
+		await setTimeout$1(20);
+	}
+	process.stdout.write("\n");
+}
+//#endregion
+//#region src/artifacts/yaml-edit.ts
+function applyEdits(source, edits) {
+	return [...edits].sort((a, b) => b.start - a.start).reduce((text, edit) => text.slice(0, edit.start) + edit.text + text.slice(edit.end), source);
+}
+async function readYaml(root, file) {
+	const { realPath } = await resolveRepositoryFile(root, file);
+	const source = await fs.readFile(realPath, "utf8");
+	return {
+		source,
+		document: parseDocument(source)
+	};
+}
+function nodeRange(node, what) {
+	const range = node?.range;
+	if (range === void 0 || range === null) throw new Error(`Cannot locate ${what} in the YAML file`);
+	return range;
+}
+function column(source, position) {
+	return position - (source.lastIndexOf("\n", position - 1) + 1);
+}
+function lineStart(source, position) {
+	return source.lastIndexOf("\n", position - 1) + 1;
+}
+function renderBlock(value, indent) {
+	return stringify(value, { lineWidth: 0 }).trimEnd().split("\n").map((line, index) => index === 0 ? line : " ".repeat(indent) + line).join("\n");
+}
+function replaceScalar(node, value) {
+	if (!isScalar(node)) throw new Error(`Expected a YAML scalar to replace with "${value}"`);
+	const [start, end] = nodeRange(node, "a scalar");
+	return {
+		start,
+		end,
+		text: stringify(value, { lineWidth: 0 }).trimEnd()
+	};
+}
+function replaceItem(source, node, value) {
+	if (!isMap(node) || node.flow === true) throw new Error("Expected a block mapping in the YAML file");
+	const [start, end] = nodeRange(node, "an entry");
+	const trailingNewline = source[end - 1] === "\n" ? "\n" : "";
+	return {
+		start,
+		end,
+		text: renderBlock(value, column(source, start)) + trailingNewline
+	};
+}
+function setField(source, map, key, value) {
+	if (!isMap(map) || map.flow === true) throw new Error(`Expected a block mapping to set "${key}"`);
+	const existing = map.get(key, true);
+	if (isScalar(existing) && (typeof value === "string" || typeof value === "number")) return replaceScalar(existing, value);
+	if (existing !== void 0) throw new Error(`Cannot replace the "${key}" field in place`);
+	const first = map.items[0]?.key;
+	if (first === void 0) throw new Error(`Cannot add "${key}" to an empty mapping`);
+	const indent = column(source, nodeRange(first, "a key")[0]);
+	const end = nodeRange(map, "a mapping")[1];
+	return {
+		start: end,
+		end,
+		text: `${source[end - 1] === "\n" ? "" : "\n"}${" ".repeat(indent)}${renderBlock({ [key]: value }, indent)}\n`
+	};
+}
+function appendItem(source, document, path, value) {
+	const sequence = document.getIn(path, true);
+	if (isSeq(sequence) && sequence.flow !== true) {
+		const range = nodeRange(sequence, path.join("."));
+		const indent = column(source, range[0]);
+		const needsNewline = source[range[1] - 1] === "\n" ? "" : "\n";
+		return {
+			start: range[1],
+			end: range[1],
+			text: `${needsNewline}${" ".repeat(indent)}- ${renderBlock(value, indent + 2)}\n`
+		};
+	}
+	const key = path.at(-1);
+	if (typeof key !== "string") throw new Error(`Cannot add an item to ${path.join(".")}`);
+	const parent = path.length === 1 ? document.contents : document.getIn(path.slice(0, -1), true);
+	if (!isMap(parent) || parent.flow === true) throw new Error(`Cannot add an item to ${path.join(".")}`);
+	const pair = parent.items.find((item) => isScalar(item.key) && item.key.value === key);
+	if (pair !== void 0) {
+		if (!isSeq(pair.value) || pair.value.items.length > 0) throw new Error(`${path.join(".")} must be a list`);
+		const keyColumn = column(source, nodeRange(pair.key, key)[0]);
+		const [valueStart, end] = nodeRange(pair.value, key);
+		return {
+			start: source.lastIndexOf(":", valueStart) + 1,
+			end,
+			text: `\n${" ".repeat(keyColumn + 2)}- ${renderBlock(value, keyColumn + 4)}`
+		};
 	}
-	const maps = [];
-	const mapIds = /* @__PURE__ */ new Set();
-	for (const { file, config, updatedAt } of configs) for (const [index, entry] of config.maps.entries()) {
-		const where = `${file}: maps[${entry.name}]`;
-		const id = slugify(entry.name);
-		if (mapIds.has(id)) {
-			errors.push(`${where}: another map has the same name`);
-			continue;
-		}
-		mapIds.add(id);
-		const mapCanvas = canvas[entry.name] ?? {};
-		const frames = [];
-		const frameIds = /* @__PURE__ */ new Set();
-		for (const [frameIndex, frameEntry] of (entry.frames ?? []).entries()) {
-			const frameWhere = `${where}: frames[${frameEntry.name}]`;
-			const frameId = `${id}--${slugify(frameEntry.name)}`;
-			if (frameIds.has(frameId)) {
-				errors.push(`${frameWhere}: another frame has the same name`);
-				continue;
-			}
-			frameIds.add(frameId);
-			let imageHash = null;
-			if (frameEntry.imagePath !== void 0) try {
-				const { stat } = await resolveRepositoryFile(root, frameEntry.imagePath);
-				if (!stat.isFile()) throw new Error(`Not a file: ${frameEntry.imagePath}`);
-				imageHash = `${stat.size}-${stat.mtimeMs}`;
-			} catch (error) {
-				errors.push(`${frameWhere}: ${describe(error)}`);
-				continue;
-			}
-			const pointNames = /* @__PURE__ */ new Set();
-			const focalPoints = [];
-			for (const [pointIndex, point] of (frameEntry.focalPoints ?? []).entries()) {
-				if (pointNames.has(point.name)) {
-					errors.push(`${frameWhere}: focalPoints[${point.name}]: another focal point has the same name`);
-					continue;
-				}
-				pointNames.add(point.name);
-				const pointId = `${frameId}--p${pointIndex}`;
-				focalPoints.push({
-					point: {
-						id: pointId,
-						frameId,
-						orgId: ORG_ID,
-						name: point.name,
-						locationX: point.x,
-						locationY: point.y,
-						visibility: point.visibility ?? "public",
-						color: point.color ?? null,
-						isActive: true,
-						createdBy: ACTOR_ID,
-						updatedBy: null,
-						createdByCommitHash: null,
-						updatedByCommitHash: null,
-						createdAt: updatedAt,
-						updatedAt
-					},
-					components: (point.components ?? []).map((ref, refIndex) => ({
-						ref,
-						meta: {
-							id: `${pointId}--c${refIndex}`,
-							focalPointId: pointId,
-							orgId: ORG_ID,
-							frameId,
-							componentId: ref.componentId,
-							componentLinkDiagramId: null,
-							componentLinkApiEndpointId: null,
-							componentLinkTestPackId: null,
-							componentLinkServiceDocId: null,
-							componentModalFields: (ref.modalFields ?? []).map((field, order) => ({
-								componentFieldId: field.componentFieldId,
-								label: field.label ?? null,
-								type: field.type ?? null,
-								required: null,
-								isReadonly: null,
-								data: field.data ?? null,
-								options: null,
-								order
-							})),
-							createdBy: ACTOR_ID,
-							updatedBy: null,
-							createdByCommitHash: null,
-							updatedByCommitHash: null,
-							createdAt: updatedAt,
-							updatedAt
-						}
-					}))
-				});
-			}
-			const frameCanvas = mapCanvas.frames?.[frameEntry.name] ?? {};
-			frames.push({
-				name: frameEntry.name,
-				frame: {
-					id: frameId,
-					mapId: id,
-					orgId: ORG_ID,
-					parentFrameId: null,
-					name: frameEntry.name,
-					description: frameEntry.description ?? "",
-					templateType: "default",
-					screenshotAssetId: frameEntry.imagePath ?? null,
-					screenshotImageUrl: null,
-					screenshotContentHash: imageHash,
-					status: "active",
-					order: frameIndex,
-					source: "cli",
-					focalPointCount: focalPoints.length,
-					createdBy: ACTOR_ID,
-					updatedBy: null,
-					createdByCommitHash: null,
-					updatedByCommitHash: null,
-					createdByActor: null,
-					updatedByActor: null,
-					createdAt: updatedAt,
-					updatedAt
-				},
-				focalPoints,
-				groups: (frameCanvas.groups ?? []).map((group, groupIndex) => ({
-					id: `${frameId}--g${groupIndex}`,
-					frameId,
-					orgId: ORG_ID,
-					name: group.name,
-					description: group.description,
-					locationX: group.x,
-					locationY: group.y,
-					width: group.width,
-					height: group.height,
-					order: groupIndex,
-					isActive: true,
-					createdBy: ACTOR_ID,
-					updatedBy: null,
-					createdAt: updatedAt,
-					updatedAt
-				})),
-				links: (frameCanvas.links ?? []).map((link, linkIndex) => ({
-					target: {
-						map: link.map,
-						frame: link.frame
-					},
-					link: {
-						id: `${frameId}--l${linkIndex}`,
-						frameId,
-						orgId: ORG_ID,
-						kind: link.kind,
-						targetFrameId: null,
-						targetMapId: null,
-						label: link.label,
-						locationX: link.x,
-						locationY: link.y,
-						isActive: true,
-						createdBy: ACTOR_ID,
-						updatedBy: null,
-						createdAt: updatedAt,
-						updatedAt
-					}
-				}))
-			});
-		}
-		maps.push({
-			file,
-			index,
-			entry,
-			canvas: mapCanvas,
-			frames,
-			map: {
-				id,
-				orgId: ORG_ID,
-				folderId: null,
-				teamId: null,
-				name: entry.name,
-				description: entry.description ?? "",
-				status: "active",
-				createdBy: ACTOR_ID,
-				updatedBy: null,
-				createdByCommitHash: null,
-				updatedByCommitHash: null,
-				createdAt: updatedAt,
-				updatedAt,
-				previewImgUrls: []
-			}
+	return setField(source, parent, key, [value]);
+}
+function removeItem(source, document, path, index) {
+	const sequence = document.getIn(path, true);
+	if (!isSeq(sequence) || sequence.flow === true) throw new Error(`${path.join(".")} must be a block list`);
+	const item = sequence.items[index];
+	if (item === void 0) throw new Error(`${path.join(".")} has no item ${index}`);
+	if (sequence.items.length > 1) {
+		const [start, , end] = nodeRange(item, "an item");
+		return {
+			start: lineStart(source, start),
+			end,
+			text: ""
+		};
+	}
+	const [start, , end] = nodeRange(sequence, path.join("."));
+	return {
+		start: source.lastIndexOf(":", start) + 1,
+		end,
+		text: " []\n"
+	};
+}
+function findItemIndex(document, path, name) {
+	const sequence = document.getIn(path, true);
+	if (!isSeq(sequence)) throw new Error(`${path.join(".")} must be a list`);
+	const index = sequence.items.findIndex((item) => isMap(item) && item.get("name") === name);
+	if (index === -1) throw new Error(`${path.join(".")} has no entry named "${name}"`);
+	return index;
+}
+//#endregion
+//#region src/artifacts/write.ts
+const MAX_WRITE_BYTES = 2e6;
+const MAX_UPLOAD_BYTES = 5e7;
+function isArtifactPath(relativePath) {
+	return relativePath === ".uigraph.yaml" || relativePath.startsWith(".uigraph/");
+}
+function toArtifactPath(requested) {
+	const relativePath = path.posix.normalize(requested.replaceAll("\\", "/")).replace(/^\.\//, "");
+	if (path.posix.isAbsolute(relativePath) || relativePath.split("/").includes("..")) throw new Error(`Path must be relative to the repository: ${requested}`);
+	if (!isArtifactPath(relativePath) || relativePath.endsWith("/")) throw new Error(`Only ${ROOT_CONFIG} and files under .uigraph/ can be written: ${requested}`);
+	return relativePath;
+}
+async function deleteArtifactFile(root, requested) {
+	const relativePath = toArtifactPath(requested);
+	let current = root;
+	for (const segment of relativePath.split("/")) {
+		current = path.join(current, segment);
+		if ((await fs.lstat(current)).isSymbolicLink()) throw new Error(`Refusing to delete through a symbolic link: ${relativePath}`);
+	}
+	await fs.rm(current);
+	const artifactRoot = path.join(root, ".uigraph");
+	for (let directory = path.dirname(current); directory.startsWith(`${artifactRoot}${path.sep}`); directory = path.dirname(directory)) {
+		if ((await fs.readdir(directory)).length > 0) return;
+		await fs.rmdir(directory);
+	}
+}
+async function writeArtifactFile(root, requested, content) {
+	const relativePath = toArtifactPath(requested);
+	const limit = typeof content === "string" ? MAX_WRITE_BYTES : MAX_UPLOAD_BYTES;
+	if (Buffer.byteLength(content) > limit) throw new Error(`Content is larger than ${limit} bytes`);
+	const segments = relativePath.split("/");
+	let current = root;
+	for (const [index, segment] of segments.entries()) {
+		current = path.join(current, segment);
+		const isLast = index === segments.length - 1;
+		const stat = await fs.lstat(current).catch((error) => {
+			if (error.code === "ENOENT") return null;
+			throw error;
 		});
+		if (stat === null) {
+			if (!isLast) await fs.mkdir(current);
+			continue;
+		}
+		if (stat.isSymbolicLink()) throw new Error(`Refusing to write through a symbolic link: ${relativePath}`);
+		if (!isLast && !stat.isDirectory()) throw new Error(`Not a directory: ${segments.slice(0, index + 1).join("/")}`);
+		if (isLast && !stat.isFile()) throw new Error(`Not a file: ${relativePath}`);
 	}
-	const dependencies = [];
-	for (const { file, config } of configs) {
-		if (config.service === void 0) continue;
-		const service = services.find((s) => s.id === serviceIdByName.get(config.service.name));
-		if (service === void 0) continue;
-		const names = /* @__PURE__ */ new Set();
-		for (const dependency of config.dependencies) {
-			const where = `${file}: dependencies[${dependency.name}]`;
-			if (names.has(dependency.name)) errors.push(`${where}: duplicate dependency name`);
-			names.add(dependency.name);
-			if (dependency.service === config.service.name) errors.push(`${where}: a service cannot depend on itself`);
-			const endpointNames = dependency.apiEndpointNames ?? [];
-			if (new Set(endpointNames).size !== endpointNames.length) errors.push(`${where}: apiEndpointNames must be unique`);
-			const target = services.find((s) => s.id === slugify(dependency.service));
-			dependencies.push({
-				id: slugify(`${service.id}-${dependency.name}`),
-				name: dependency.name,
-				service: toDependencyService(service),
-				dependency: target === void 0 ? null : toDependencyService(target),
-				dependencyName: dependency.service,
-				direction: dependency.direction,
-				type: dependency.type ?? null,
-				criticality: dependency.criticality,
-				description: dependency.description ?? null,
-				apiGroupName: dependency.apiGroupName ?? null,
-				apiEndpointNames: endpointNames,
-				databaseName: dependency.databaseName ?? null
-			});
+	const temporary = path.join(path.dirname(current), `.${path.basename(current)}.${randomUUID()}.tmp`);
+	await fs.writeFile(temporary, content, { flag: "wx" });
+	await fs.rename(temporary, current);
+	return relativePath;
+}
+function exportDiagram(nodes, edges) {
+	if (isC4ReactFlowDiagram(nodes)) return convertReactFlowToC4UiGraph(nodes, edges);
+	if (isSequenceDiagram(nodes)) return convertReactFlowToSequenceUiGraph(nodes, edges);
+	return convertUiGraphToMermaid({
+		nodes,
+		edges
+	});
+}
+async function saveDiagram(root, configFile, diagramId, input) {
+	const { db, errors } = await loadArtifacts(root, configFile);
+	if (errors.length > 0) throw new Error(`The .uigraph artifacts are invalid:\n${errors.join("\n")}`);
+	const diagram = db.diagrams.find((d) => d.entity.id === diagramId);
+	if (diagram === void 0) throw new Error(`Diagram ${diagramId} not found`);
+	const name = input.name === void 0 || input.name === null || input.name.trim() === "" ? diagram.entry.name : input.name.trim();
+	if (db.diagrams.some((d) => d.file === diagram.file && d.entity.id !== diagramId && d.entry.name === name)) throw new Error(`Another diagram in ${diagram.file} is named "${name}"`);
+	let contextPath = diagram.entry.contextPath;
+	if (input.content !== void 0 && input.content !== null) {
+		const parsed = JSON.parse(input.content);
+		if (!Array.isArray(parsed.nodes) || !Array.isArray(parsed.edges)) throw new Error("Diagram content must have nodes and edges arrays");
+		const next = exportDiagram(parsed.nodes, parsed.edges);
+		const previous = exportDiagram(diagram.flow.nodes, diagram.flow.edges);
+		if (JSON.stringify(next) !== JSON.stringify(previous)) {
+			contextPath ??= path.posix.join(path.posix.dirname(diagram.entry.path), "context.json");
+			await writeArtifactFile(root, diagram.entry.path, next.mermaid);
+			await writeArtifactFile(root, contextPath, `${JSON.stringify(next.context, null, 2)}\n`);
 		}
 	}
-	for (const service of services) {
-		service.stats.endpointCount = apiGroups.filter(({ group }) => group.serviceId === service.id).reduce((count, { endpoints }) => count + endpoints.length, 0);
-		service.stats.diagramCount = serviceDiagrams.filter((link) => link.serviceId === service.id).length;
-		service.stats.docCount = docs.filter(({ serviceDoc }) => serviceDoc.serviceId === service.id).length;
-		service.stats.dbTableCount = databases.filter(({ serviceDb }) => serviceDb.serviceId === service.id).reduce((count, { serviceDb }) => count + serviceDb.tables.length, 0);
+	if (name !== diagram.entry.name || contextPath !== diagram.entry.contextPath) {
+		const { source, document } = await readYaml(root, diagram.file);
+		const entry = document.getIn(["architectureDiagrams", diagram.index], true);
+		if (!isMap(entry) || entry.flow === true) throw new Error(`${diagram.file}: architectureDiagrams[${diagram.index}] must be a block mapping`);
+		const edits = [];
+		if (name !== diagram.entry.name) edits.push(replaceScalar(entry.get("name", true), name));
+		if (contextPath !== diagram.entry.contextPath) {
+			const pathPair = entry.items.find((pair) => isScalar(pair.key) && pair.key.value === "path");
+			const key = pathPair?.key;
+			const value = pathPair?.value;
+			if (!key?.range || !value?.range) throw new Error(`${diagram.file}: architectureDiagrams[${diagram.index}] has no path`);
+			const indent = key.range[0] - source.lastIndexOf("\n", key.range[0]) - 1;
+			edits.push({
+				start: value.range[1],
+				end: value.range[1],
+				text: `\n${" ".repeat(indent)}contextPath: ${stringify(contextPath, { lineWidth: 0 }).trimEnd()}`
+			});
+		}
+		await writeArtifactFile(root, diagram.file, applyEdits(source, edits));
 	}
+	const mermaid = await fs.readFile(path.join(root, diagram.entry.path), "utf8");
+	const context = contextPath === void 0 ? "" : await fs.readFile(path.join(root, contextPath), "utf8");
 	return {
-		errors,
-		db: {
-			configFiles: configs.map(({ file }) => file),
-			services,
-			serviceFiles,
-			apiGroups,
-			diagrams,
-			serviceDiagrams,
-			docs,
-			standaloneDocs,
-			databases,
-			queries,
-			maps,
-			dependencies
-		}
+		id: diagramId,
+		name,
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		contentHash: contentHash(mermaid, context)
 	};
 }
-function toDependencyService(service) {
-	return {
-		id: service.id,
-		name: service.name,
-		description: service.description,
-		status: service.status,
-		tier: service.tier,
-		category: service.category,
-		language: service.language,
-		gitRepoUrl: service.gitRepoUrl,
-		updatedAt: service.updatedAt,
-		metadata: null
+async function createDiagram(root, configFile, file, name) {
+	const { db, errors } = await loadArtifacts(root, configFile);
+	if (errors.length > 0) throw new Error(`The .uigraph artifacts are invalid:\n${errors.join("\n")}`);
+	if (db.diagrams.some((d) => d.file === file && d.entry.name === name)) throw new Error(`Another diagram in ${file} is named "${name}"`);
+	const base = slugify(name);
+	if (base === "") throw new Error("The diagram name must contain a letter or digit");
+	let folder = base;
+	for (let suffix = 2; db.diagrams.some((d) => d.entity.id === folder) || await fs.lstat(path.join(root, ".uigraph/diagrams", folder)).then(() => true, (error) => {
+		if (error.code === "ENOENT") return false;
+		throw error;
+	}); suffix++) folder = `${base}-${suffix}`;
+	const entry = {
+		name,
+		path: `.uigraph/diagrams/${folder}/${folder}.mmd`,
+		contextPath: `.uigraph/diagrams/${folder}/context.json`
 	};
+	const empty = convertUiGraphToMermaid({
+		nodes: [],
+		edges: []
+	});
+	await writeArtifactFile(root, entry.path, empty.mermaid);
+	await writeArtifactFile(root, entry.contextPath, `${JSON.stringify(empty.context, null, 2)}\n`);
+	const { source, document } = await readYaml(root, file);
+	await writeArtifactFile(root, file, applyEdits(source, [appendItem(source, document, ["architectureDiagrams"], entry)]));
+	return folder;
 }
-//#endregion
-//#region src/version.ts
-const { version } = createRequire(import.meta.url)("../package.json");
-const VERSION = version;
-const BUILD_ID = createHash("sha1").update(readFileSync(new URL(import.meta.url))).digest("hex").slice(0, 8);
-//#endregion
-//#region src/analysis/skill.ts
-const REPOSITORY = "uigraph-oss/skills";
-const SKILL_DIRECTORY = "skills/uigraph/";
-const SKILL_SOURCE = `github.com/${REPOSITORY}`;
-async function fetchOk(url) {
-	const response = await fetch(url);
-	if (!response.ok) throw new Error(`${url} responded ${response.status}`);
-	return response;
-}
-async function downloadSkill() {
-	const tree = await (await fetchOk(`https://api.github.com/repos/${REPOSITORY}/git/trees/main?recursive=1`)).json();
-	if (tree.truncated) throw new Error(`The file list of ${SKILL_SOURCE} is truncated`);
-	const paths = tree.tree.filter((entry) => entry.type === "blob" && entry.path.startsWith(SKILL_DIRECTORY)).map((entry) => entry.path);
-	const files = /* @__PURE__ */ new Map();
-	await Promise.all(paths.map(async (filePath) => {
-		const response = await fetchOk(`https://raw.githubusercontent.com/${REPOSITORY}/${tree.sha}/${filePath}`);
-		files.set(filePath.slice(15), await response.text());
-	}));
-	const instructions = files.get("SKILL.md");
-	if (instructions === void 0) throw new Error(`${SKILL_SOURCE} has no ${SKILL_DIRECTORY}SKILL.md`);
-	return {
-		instructions: instructions.replace(/^---\n[\s\S]*?\n---\n/, ""),
-		files
-	};
+async function deleteDiagram(root, configFile, diagramId) {
+	const { db, errors } = await loadArtifacts(root, configFile);
+	if (errors.length > 0) throw new Error(`The .uigraph artifacts are invalid:\n${errors.join("\n")}`);
+	const diagram = db.diagrams.find((d) => d.entity.id === diagramId);
+	if (diagram === void 0) throw new Error(`Diagram ${diagramId} not found`);
+	const images = await listDiagramImages(root, diagram.entry.path);
+	const { source, document } = await readYaml(root, diagram.file);
+	await writeArtifactFile(root, diagram.file, applyEdits(source, [removeItem(source, document, ["architectureDiagrams"], diagram.index)]));
+	for (const file of [
+		diagram.entry.path,
+		diagram.entry.contextPath,
+		...images.map((image) => image.imagePath)
+	]) if (file !== void 0 && isArtifactPath(file)) await deleteArtifactFile(root, file);
+}
+async function renameDiagramReferences(root, files, serviceName, oldName, newName) {
+	for (const file of files) {
+		const { source, document } = await readYaml(root, file);
+		const edits = [];
+		visit(document, { Map(_, map) {
+			if (map.get("serviceName") === serviceName && map.get("architectureDiagramName") === oldName) edits.push(replaceScalar(map.get("architectureDiagramName", true), newName));
+		} });
+		if (edits.length > 0) await writeArtifactFile(root, file, applyEdits(source, edits));
+	}
 }
 //#endregion
-//#region src/analysis/analyze.ts
-const PROMPT = fs$1.readFileSync(new URL("./prompt.md", import.meta.url), "utf8");
-const PLAN_PROMPT = fs$1.readFileSync(new URL("./plan-prompt.md", import.meta.url), "utf8");
-const PLAN_MAX_TURNS = 100;
-var AnalysisError = class extends Error {};
-var AnalysisCancelledError = class extends Error {};
-var AnalysisLimitError = class extends AnalysisError {};
-function describeToolEvent(event) {
-	if (event.tool === "list_files") return `list   ${event.pattern}`;
-	if (event.tool === "read_file") return `read   ${event.path}`;
-	if (event.tool === "search") return `search ${event.pattern}  ${pc.dim(`in ${event.glob}`)}`;
-	if (event.tool === "write_file") return pc.green(`write  ${event.path}`);
-	if (event.tool === "validate_artifacts") return "validate";
-	if (event.tool === "read_skill_file") return `skill  ${event.path}`;
-	if (event.tool === "submit_diagram_plan") return pc.green(`plan   ${event.count} diagram candidates`);
-	throw new Error(`Unknown tool event: ${JSON.stringify(event)}`);
-}
-function describeUsage(outcome) {
-	return `${outcome.tokens.toLocaleString()} tokens${outcome.costUsd === null ? "" : ` · ~$${outcome.costUsd.toFixed(2)} estimated`}`;
-}
-async function runSession(root, skill, prompt, abortController, settings, mode = "generate") {
-	let toolCalls = 0;
-	const tools = createRepositoryTools(root, skill.files, (event) => {
-		toolCalls++;
-		console.log(pc.dim(`  ${String(toolCalls).padStart(3)} `) + describeToolEvent(event));
-	}, mode === "generate" ? void 0 : { onSubmit: mode.onPlan });
-	let outcome;
-	try {
-		outcome = await runAgent({
-			agent: settings.agent,
-			cwd: root,
-			systemPrompt: mode === "generate" ? `${PROMPT}\n# UIGraph skill\n\nThe skill below was written for interactive use. The run instructions above override its approval workflow, and its file references resolve through \`read_skill_file\`.\n\n${skill.instructions}` : PLAN_PROMPT,
-			prompt,
-			tools,
-			signal: abortController.signal,
-			model: settings.model,
-			maxBudgetUsd: settings.maxBudgetUsd,
-			maxTurns: mode === "generate" ? void 0 : PLAN_MAX_TURNS,
-			clientApp: `uigraph/${VERSION}`,
-			log: consola.debug
-		});
-	} catch (error) {
-		if (abortController.signal.aborted) throw new AnalysisCancelledError("Analysis cancelled");
-		if (error instanceof AgentLimitError) throw new AnalysisLimitError(error.message, { cause: error });
-		if (error instanceof AgentError) throw new AnalysisError(error.message, { cause: error });
+//#region src/artifacts/docs.ts
+const DOC_EXTENSIONS = {
+	pdf: ".pdf",
+	html: ".html",
+	markdown: ".md",
+	txt: ".txt"
+};
+async function loadValid(root, configFile) {
+	const { db, errors } = await loadArtifacts(root, configFile);
+	if (errors.length > 0) throw new Error(`The .uigraph artifacts are invalid:\n${errors.join("\n")}`);
+	return db;
+}
+async function exists(file) {
+	return fs.lstat(file).then(() => true, (error) => {
+		if (error.code === "ENOENT") return false;
 		throw error;
-	}
-	if (abortController.signal.aborted) throw new AnalysisCancelledError("Analysis cancelled");
-	return outcome;
+	});
 }
-function printErrors(errors) {
-	for (const error of errors.slice(0, 30)) console.log(pc.yellow(`  • ${error}`));
-	if (errors.length > 30) console.log(pc.yellow(`  • … ${errors.length - 30} more`));
+async function createDoc(root, configFile, file, input, data) {
+	const db = await loadValid(root, configFile);
+	if ([...db.docs, ...db.standaloneDocs].some((doc) => doc.file === file && doc.entry.name === input.name)) throw new Error(`Another doc in ${file} is named "${input.name}"`);
+	const extension = DOC_EXTENSIONS[input.fileType];
+	if (extension === void 0) throw new Error(`Unsupported doc type "${input.fileType}"`);
+	const base = slugify(input.name);
+	if (base === "") throw new Error("The doc name must contain a letter or digit");
+	let docPath = `.uigraph/docs/${base}${extension}`;
+	for (let suffix = 2; await exists(path.join(root, docPath)); suffix++) docPath = `.uigraph/docs/${base}-${suffix}${extension}`;
+	await writeArtifactFile(root, docPath, data);
+	const { source, document } = await readYaml(root, file);
+	await writeArtifactFile(root, file, applyEdits(source, [appendItem(source, document, ["docs"], {
+		name: input.name,
+		path: docPath,
+		fileType: input.fileType,
+		...input.description === "" ? {} : { description: input.description }
+	})]));
+	return docPath;
 }
-async function loadSkill() {
-	console.log(pc.dim(`  Downloading the UIGraph skill from ${SKILL_SOURCE}`));
-	try {
-		return await downloadSkill();
-	} catch (error) {
-		throw new AnalysisError(`Could not download the UIGraph skill from ${SKILL_SOURCE}: ${error instanceof Error ? error.message : String(error)}`);
-	}
+async function deleteDoc(root, configFile, file, name) {
+	const db = await loadValid(root, configFile);
+	const allDocs = [...db.docs, ...db.standaloneDocs];
+	const doc = allDocs.find((d) => d.file === file && d.entry.name === name);
+	if (doc === void 0) throw new Error(`No doc named "${name}" in ${file}`);
+	const { source, document } = await readYaml(root, file);
+	await writeArtifactFile(root, file, applyEdits(source, [removeItem(source, document, ["docs"], findItemIndex(document, ["docs"], name))]));
+	const stillUsed = allDocs.some((d) => d !== doc && d.entry.path === doc.entry.path);
+	if (isArtifactPath(doc.entry.path) && !stillUsed) await deleteArtifactFile(root, doc.entry.path);
 }
-async function listExistingDiagrams(root) {
-	return (await fs$1.promises.readdir(path.join(root, ".uigraph", "diagrams"), { withFileTypes: true }).catch((error) => {
-		if (error.code === "ENOENT") return [];
-		throw error;
-	})).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
+//#endregion
+//#region src/artifacts/maps.ts
+const IMAGE_EXTENSIONS = {
+	"image/png": ".png",
+	"image/jpeg": ".jpg",
+	"image/webp": ".webp",
+	"image/gif": ".gif"
+};
+async function createMap(root, configFile, file, input) {
+	await loadValid(root, configFile);
+	const { source, document } = await readYaml(root, file);
+	await writeArtifactFile(root, file, applyEdits(source, [appendItem(source, document, ["maps"], {
+		name: input.name,
+		...input.description === "" ? {} : { description: input.description }
+	})]));
 }
-async function planDiagrams(root, repositoryName, skill, abortController, settings) {
-	const startedAt = Date.now();
-	const existing = await listExistingDiagrams(root);
-	const captured = { submission: null };
-	let outcome;
-	try {
-		outcome = await runSession(root, skill, [`Propose the architecture diagrams worth generating and the existing documents worth adding for the repository "${repositoryName}" in the working directory.`, existing.length === 0 ? "No diagrams exist yet." : `These diagrams already exist, so do not propose them again: ${existing.join(", ")}.`].join("\n"), abortController, settings, { onPlan: (submission) => {
-			captured.submission = submission;
-		} });
-	} catch (error) {
-		if (error instanceof AnalysisLimitError) {
-			consola.debug(`Planning stopped: ${inspect(error)}`);
-			return null;
-		}
-		throw error;
-	}
-	if (captured.submission === null) return null;
-	return {
-		...captured.submission,
-		seconds: Math.round((Date.now() - startedAt) / 1e3),
-		usage: outcome
-	};
+async function editMap(root, configFile, file, name, edit) {
+	await loadValid(root, configFile);
+	const { source, document } = await readYaml(root, file);
+	const index = findItemIndex(document, ["maps"], name);
+	const node = document.getIn(["maps", index], true);
+	if (!isMap(node)) throw new Error(`maps[${name}] must be a mapping`);
+	const next = edit(node.toJSON());
+	await writeArtifactFile(root, file, applyEdits(source, [next === null ? removeItem(source, document, ["maps"], index) : replaceItem(source, node, next)]));
 }
-async function generateArtifacts(root, repositoryName, gitRemote, update, abortController, skill, selection, settings) {
-	const startedAt = Date.now();
-	const existing = await listExistingDiagrams(root);
-	let outcome = await runSession(root, skill, [
-		update ? `Update the existing UIGraph artifacts of the repository "${repositoryName}" in the working directory so they match the current code. Read the existing .uigraph.yaml and .uigraph/ files first and keep what is still correct.` : `Generate UIGraph artifacts for the repository "${repositoryName}" in the working directory.`,
-		gitRemote === null ? "The CLI found no usable git remote." : `The repository's git remote is ${gitRemote}.`,
-		...selection === null ? [] : [formatApprovedDiagrams(selection, existing)]
-	].join("\n"), abortController, settings);
-	let { errors } = await loadArtifacts(root);
-	if (errors.length > 0) {
-		console.log(pc.yellow(`\nThe artifacts have ${errors.length} problem(s). Asking ${AGENT_LABELS[settings.agent]} to repair them once:`));
-		printErrors(errors);
-		console.log();
-		outcome = await runSession(root, skill, [
-			"The UIGraph artifacts failed validation. Fix every problem below, re-reading files where needed, and run validate_artifacts until it passes. Remove findings you cannot support with evidence rather than guessing.",
-			"",
-			...errors.map((error) => `- ${error}`)
-		].join("\n"), abortController, settings);
-		errors = (await loadArtifacts(root)).errors;
+async function editCanvas(root, edit) {
+	const present = await exists(path.join(root, CANVAS_FILE));
+	let canvas = {};
+	if (present) {
+		const { realPath } = await resolveRepositoryFile(root, CANVAS_FILE);
+		canvas = canvasFileSchema.parse(JSON.parse(await fs.readFile(realPath, "utf8")));
 	}
-	if (errors.length > 0) {
-		printErrors(errors);
-		throw new AnalysisError(`The artifacts are still invalid after one repair attempt (${errors.length} problem(s)).`);
+	const before = JSON.stringify(canvas);
+	edit(canvas);
+	if (JSON.stringify(canvas) === before) return;
+	if (Object.keys(canvas).length === 0) {
+		if (present) await deleteArtifactFile(root, CANVAS_FILE);
+		return;
 	}
-	const seconds = Math.round((Date.now() - startedAt) / 1e3);
-	console.log(pc.dim(`\n  ${seconds}s · ${describeUsage(outcome)}`));
-}
-//#endregion
-//#region src/banner.ts
-const NAME = "UIGraph";
-const WEBSITE = "https://uigraph.app";
-const TAGLINE = "Map your project into services, APIs and diagrams";
-function blue(text) {
-	return pc.isColorSupported ? `\x1b[38;2;59;107;255m${text}\x1b[39m` : text;
-}
-const MARK = [[
-	0,
-	0,
-	pc.white("⏺")
-]];
-for (let col = 1; col < 5; col++) MARK.push([
-	0,
-	col,
-	blue("━")
-]);
-MARK.push([
-	0,
-	5,
-	blue("⏺")
-]);
-MARK.push([
-	1,
-	5,
-	blue("┃")
-]);
-MARK.push([
-	2,
-	5,
-	blue("⏺")
-]);
-for (let col = 4; col > 0; col--) MARK.push([
-	2,
-	col,
-	blue("━")
-]);
-MARK.push([
-	2,
-	0,
-	blue("⏺")
-]);
-MARK.push([
-	1,
-	0,
-	blue("┃")
-]);
-function imageProtocol() {
-	const program = process.env.TERM_PROGRAM;
-	if (program === "iTerm.app" || program === "WezTerm") return "iterm";
-	if (program === "ghostty" || process.env.TERM === "xterm-kitty" || process.env.KITTY_WINDOW_ID) return "kitty";
-	return null;
+	await writeArtifactFile(root, CANVAS_FILE, `${JSON.stringify(canvas, null, 2)}\n`);
 }
-function logoImage(protocol) {
-	const file = fs$1.readFileSync(new URL("./uigraph-mark.png", import.meta.url));
-	const png = file.toString("base64");
-	if (protocol === "iterm") return `\x1b]1337;File=inline=1;size=${file.length};height=3;preserveAspectRatio=1:${png}\x07`;
-	const chunks = png.match(/.{1,4096}/g);
-	return chunks.map((chunk, index) => {
-		const more = index < chunks.length - 1 ? 1 : 0;
-		return `\x1b_G${index === 0 ? `a=T,f=100,r=3,C=1,q=2,m=${more}` : `m=${more}`};${chunk}\x1b\\`;
-	}).join("");
+async function retargetLinks(root, from, to) {
+	await editCanvas(root, (canvas) => {
+		for (const mapCanvas of Object.values(canvas)) for (const frameCanvas of Object.values(mapCanvas.frames ?? {})) {
+			if (frameCanvas.links === void 0) continue;
+			frameCanvas.links = frameCanvas.links.flatMap((link) => {
+				if (!(link.map === from.map && (from.frame === void 0 || link.frame === from.frame))) return [link];
+				if (to === null) return [];
+				return [{
+					...link,
+					map: to.map,
+					...from.frame === void 0 ? {} : { frame: to.frame }
+				}];
+			});
+		}
+	});
 }
-function render(frame, markFrames) {
-	const grid = Array.from({ length: 3 }, () => Array(6).fill(" "));
-	for (const [row, col, char] of MARK.slice(0, Math.min(frame, markFrames))) grid[row][col] = char;
-	const letters = Math.max(0, frame - markFrames);
-	const done = letters > 7;
-	const text = [
-		pc.bold(NAME.slice(0, letters)) + (done ? pc.dim(` v${VERSION}`) : ""),
-		done ? blue(WEBSITE) : "",
-		done ? pc.dim(TAGLINE) : ""
-	];
-	return grid.map((cells, row) => `  ${cells.join("")}    ${text[row]}\x1b[K`).join("\n");
+async function writeFrameImage(root, mapName, frameName, upload) {
+	const extension = IMAGE_EXTENSIONS[upload.contentType];
+	if (extension === void 0) throw new Error("Frame images must be PNG, JPEG, WebP or GIF files");
+	const directory = `.uigraph/maps/${slugify(mapName)}`;
+	const base = slugify(frameName);
+	let imagePath = `${directory}/${base}${extension}`;
+	for (let suffix = 2; await exists(path.join(root, imagePath)); suffix++) imagePath = `${directory}/${base}-${suffix}${extension}`;
+	await writeArtifactFile(root, imagePath, upload.data);
+	return imagePath;
 }
-async function showBanner() {
-	if (!process.stdout.isTTY) return;
-	const protocol = imageProtocol();
-	const markFrames = protocol ? 0 : MARK.length;
-	const frames = markFrames + 7 + 1;
-	process.stdout.write("\n");
-	for (let frame = 1; frame <= frames; frame++) {
-		process.stdout.write(`${frame === 1 ? "" : "\x1B[2A\r"}${render(frame, markFrames)}`);
-		if (frame === frames && protocol) process.stdout.write(`\x1b7\x1b[2A\r\x1b[2C${logoImage(protocol)}\x1b8`);
-		await setTimeout$1(20);
-	}
-	process.stdout.write("\n");
+async function deleteUnusedImages(root, configFile, imagePaths) {
+	const db = await loadValid(root, configFile);
+	const used = new Set(db.maps.flatMap((map) => map.frames.flatMap(({ frame }) => frame.screenshotAssetId ?? [])));
+	for (const imagePath of imagePaths) if (isArtifactPath(imagePath) && !used.has(imagePath)) await deleteArtifactFile(root, imagePath);
 }
 //#endregion
-//#region src/guidance/guidance.ts
-const TEMPLATE = readFileSync(new URL("./agents.md", import.meta.url), "utf8");
-const AGENT_FILES = ["CLAUDE.md", "AGENTS.md"];
-const GUIDANCE_FILE = ".uigraph/AGENTS.md";
-const REFERENCE = `## UIGraph
-
-If your change adds or changes API endpoints, database schemas, calls to other services, or a flow shown in a diagram, read \`${GUIDANCE_FILE}\` and follow it.
-`;
-async function writeGuidance(root) {
-	await writeArtifactFile(root, GUIDANCE_FILE, TEMPLATE);
-	const files = [];
-	for (const file of AGENT_FILES) {
-		const target = path.join(root, file);
-		const text = await fs.readFile(target, "utf8").catch((error) => {
-			if (error.code === "ENOENT") return null;
-			throw error;
+//#region src/artifacts/diagram-images.ts
+const DIAGRAM_IMAGE_EXTENSIONS = {
+	...IMAGE_EXTENSIONS,
+	"image/svg+xml": ".svg"
+};
+function imageDirectory(diagramPath) {
+	return `${path.posix.dirname(diagramPath)}/images`;
+}
+async function listDiagramImages(root, diagramPath) {
+	const directory = imageDirectory(diagramPath);
+	const entries = await fs.readdir(path.join(root, directory), { withFileTypes: true }).catch((error) => {
+		if (error.code === "ENOENT") return [];
+		throw error;
+	});
+	const extensions = new Set(Object.values(DIAGRAM_IMAGE_EXTENSIONS));
+	const images = [];
+	for (const entry of entries) if (entry.isFile() && extensions.has(path.extname(entry.name).toLowerCase())) {
+		const imagePath = `${directory}/${entry.name}`;
+		const stat = await fs.stat(path.join(root, imagePath));
+		images.push({
+			imagePath,
+			createdAt: stat.birthtime.toISOString()
 		});
-		if (text === null) continue;
-		files.push(file);
-		if (text.includes(".uigraph/AGENTS.md")) continue;
-		if (text === "" || text.endsWith("\n\n")) await fs.appendFile(target, REFERENCE);
-		else if (text.endsWith("\n")) await fs.appendFile(target, `\n${REFERENCE}`);
-		else await fs.appendFile(target, `\n\n${REFERENCE}`);
-	}
-	if (files.length === 0) {
-		await fs.writeFile(path.join(root, "AGENTS.md"), REFERENCE, { flag: "wx" });
-		files.push("AGENTS.md");
 	}
-	return files;
+	return images.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+}
+async function writeDiagramImage(root, diagramPath, fileName, upload) {
+	const extension = DIAGRAM_IMAGE_EXTENSIONS[upload.contentType];
+	if (extension === void 0) throw new Error("Diagram images must be PNG, JPEG, WebP, GIF or SVG files");
+	const directory = imageDirectory(diagramPath);
+	const base = slugify(path.parse(fileName).name);
+	if (base === "") throw new Error("The image file name must contain a letter or digit");
+	let imagePath = `${directory}/${base}${extension}`;
+	for (let suffix = 2; await exists(path.join(root, imagePath)); suffix++) imagePath = `${directory}/${base}-${suffix}${extension}`;
+	await writeArtifactFile(root, imagePath, upload.data);
+	return imagePath;
 }
 //#endregion
 //#region src/workspace.ts
@@ -2087,10 +1671,8 @@ const COMPONENT_API_CONTRACT_ID = "component_api-contract";
 const COMPONENT_FLOW_DIAGRAM_ID = "component_backend-flow-diagram";
 const COMPONENT_SUPPORT_KB_ID = "component_support-kb-troubleshooting";
 const REGISTRY = ".uigraph/registry.yaml";
-const PREFERENCES = ".uigraph/preferences.yaml";
 const WORKSPACE_ID = "workspace";
 const registrySchema = z.object({ projects: z.array(z.string().min(1)) });
-const preferencesSchema = z.object({ agentGuidance: z.object({ declined: z.array(z.string().min(1)) }) });
 function homeRoot() {
 	return fs.realpath(os.homedir());
 }
@@ -2117,19 +1699,6 @@ async function unregisterProject(root) {
 	if (!projects.includes(root)) throw new Error(`${root} is not registered`);
 	await writeArtifactFile(home, REGISTRY, stringify({ projects: projects.filter((project) => project !== root) }));
 }
-async function readDeclinedGuidance(home) {
-	const text = await readOptional(path.join(home, PREFERENCES));
-	if (text === null) return [];
-	return preferencesSchema.parse(parse$1(text)).agentGuidance.declined;
-}
-async function isGuidanceDeclined(root) {
-	return (await readDeclinedGuidance(await homeRoot())).includes(root);
-}
-async function setGuidanceDeclined(root, declined) {
-	const home = await homeRoot();
-	const others = (await readDeclinedGuidance(home)).filter((project) => project !== root);
-	await writeArtifactFile(home, PREFERENCES, stringify({ agentGuidance: { declined: declined ? [...others, root] : others } }));
-}
 async function syncProject(root) {
 	await registerProject$1(root);
 	const { skipped, workspace } = await loadWorkspace();
@@ -4041,34 +3610,13 @@ async function handleLensRequest(request, response, pathname, securityHeaders) {
 }
 //#endregion
 //#region src/bin.ts
-const ARTIFACT_ENTRIES = [ROOT_CONFIG, ".uigraph"];
+const GENERATE_HINT = "Ask your coding agent to generate them with the UIGraph skill (npx skills add uigraph-oss/skills).";
 if (process.env.UIGRAPH_DEBUG === "1") consola.level = LogLevels.debug;
 var UsageError = class extends Error {};
 function fail(message, exitCode = 1) {
 	console.error(pc.red(`✖ ${message}`));
 	process.exit(exitCode);
 }
-async function withCancellation(message, work) {
-	const abortController = new AbortController();
-	let signals = 0;
-	function onSignal() {
-		signals++;
-		if (signals > 1) {
-			console.error(pc.red("\nForced exit."));
-			process.exit(130);
-		}
-		console.log(pc.yellow(`\n${message} (press Ctrl+C again to force quit)`));
-		abortController.abort();
-	}
-	process.on("SIGINT", onSignal);
-	process.on("SIGTERM", onSignal);
-	try {
-		return await work(abortController);
-	} finally {
-		process.off("SIGINT", onSignal);
-		process.off("SIGTERM", onSignal);
-	}
-}
 async function resolveRepository(input) {
 	const requested = path.resolve(input ?? process.cwd());
 	let realPath;
@@ -4080,11 +3628,6 @@ async function resolveRepository(input) {
 	if (!(await fs.stat(realPath)).isDirectory()) throw new UsageError(`Not a directory: ${realPath}`);
 	return realPath;
 }
-function describeLimits(settings) {
-	if (settings.maxBudgetUsd !== void 0) return `  • Each Claude session is capped at $${settings.maxBudgetUsd.toFixed(2)}.`;
-	if (settings.agent === "claude") return "  • No spending cap is set (see --max-budget); usage counts against your Claude plan or API account.";
-	return `  • Usage counts against your ${AGENT_LABELS[settings.agent]} plan or API account.`;
-}
 async function chooseAgent(agent, question) {
 	if (agent !== void 0) return agent;
 	if (!process.stdin.isTTY) throw new UsageError(`Choose an agent with --agent (${AGENT_NAMES.join(", ")}).`);
@@ -4096,87 +3639,6 @@ async function chooseAgent(agent, question) {
 		}))
 	});
 }
-async function confirmAnalysis(root, settings) {
-	const agent = AGENT_LABELS[settings.agent];
-	console.log([
-		"",
-		`${pc.bold("uigraph")} will generate UIGraph artifacts for ${pc.cyan(root)} with ${agent}.`,
-		"",
-		`  • ${agent} reads selected repository files (manifests, source, configs) and sends`,
-		settings.agent === "opencode" ? "    their contents to its model provider, using provider API keys from your environment." : `    their contents to its model provider, using your ${agent} login or API key.`,
-		`  • ${agent} first proposes which diagrams to generate and which existing docs to add,`,
-		"    and you choose. Nothing is written until you do.",
-		`  • ${agent} writes ${ROOT_CONFIG} and files under .uigraph/ in the repository. Nothing else`,
-		"    is changed. If generation fails, the previous artifacts are restored.",
-		describeLimits(settings),
-		""
-	].join("\n"));
-	if (await confirm({
-		message: "Continue?",
-		default: false
-	})) return true;
-	console.log(pc.yellow(`Cancelled. Nothing was sent to ${agent}.`));
-	return false;
-}
-async function promptForDiagrams(candidates, preselected, docCandidates, agent) {
-	const diagrams = await checkbox({
-		message: `${AGENT_LABELS[agent]} found ${candidates.length} ${candidates.length === 1 ? "diagram" : "diagrams"} worth generating. Pick the ones to generate.`,
-		choices: candidates.map((diagram) => ({
-			name: `${diagram.name}  ${pc.cyan(diagram.type)}`,
-			value: diagram,
-			checked: preselected.has(diagram.id),
-			description: `${diagram.summary}\nevidence: ${diagram.evidence.join(", ")}`
-		})),
-		pageSize: candidates.length
-	});
-	const docs = docCandidates.length === 0 ? [] : await checkbox({
-		message: `${AGENT_LABELS[agent]} found ${docCandidates.length} existing ${docCandidates.length === 1 ? "document" : "documents"} in the repository. Pick the ones to add to the viewer.`,
-		choices: docCandidates.map((doc) => ({
-			name: `${doc.name}  ${pc.cyan(doc.path)}`,
-			value: doc,
-			checked: true,
-			description: doc.summary
-		})),
-		pageSize: docCandidates.length
-	});
-	const focus = (await input({ message: "Anything in particular to focus on? (optional, press Enter to skip)" })).trim();
-	return {
-		diagrams,
-		docs,
-		focus: focus === "" ? null : focus
-	};
-}
-async function chooseDiagrams(root, skill, settings) {
-	console.log(pc.bold("\nLooking for diagrams worth generating…\n"));
-	let plan;
-	try {
-		plan = await withCancellation("Cancelling…", (abortController) => planDiagrams(root, path.basename(root), skill, abortController, settings));
-	} catch (error) {
-		if (error instanceof AnalysisCancelledError) fail("Cancelled. Nothing was written.", 130);
-		if (error instanceof AnalysisError) fail(`${error.message}\n  Nothing was written.`);
-		throw error;
-	}
-	if (plan === null) {
-		console.log(pc.yellow("\nCould not build a diagram plan. Generating the default set instead."));
-		return null;
-	}
-	console.log(pc.dim(`\n  ${plan.diagrams.length} diagram and ${plan.docs.length} document candidates · ${plan.seconds}s · ${describeUsage(plan.usage)}`));
-	const recommended = new Set(plan.diagrams.filter((diagram) => diagram.recommended).map(({ id }) => id));
-	return promptForDiagrams(plan.diagrams, recommended, plan.docs, settings.agent);
-}
-async function downloadSkillOrFail() {
-	try {
-		return await loadSkill();
-	} catch (error) {
-		if (error instanceof AnalysisError) fail(error.message);
-		throw error;
-	}
-}
-async function countAnalyzableFiles(root) {
-	const files = await listRepositoryFiles(root, "**/*");
-	if (files.length === 0) fail("The repository has no analyzable files (generated directories and secret files are skipped). Nothing was sent to an agent.");
-	return files.length;
-}
 async function findGitRemote(root) {
 	const remote = await promisify(execFile)("git", [
 		"-C",
@@ -4196,84 +3658,19 @@ async function pathExists(file) {
 		throw error;
 	});
 }
-async function backupArtifacts(root) {
-	const backup = await fs.mkdtemp(path.join(os.tmpdir(), "uigraph-"));
-	for (const entry of ARTIFACT_ENTRIES) if (await pathExists(path.join(root, entry))) await fs.cp(path.join(root, entry), path.join(backup, entry), {
-		recursive: true,
-		verbatimSymlinks: true
-	});
-	return backup;
-}
-async function restoreArtifacts(root, backup) {
-	for (const entry of ARTIFACT_ENTRIES) {
-		await fs.rm(path.join(root, entry), {
-			recursive: true,
-			force: true
-		});
-		if (await pathExists(path.join(backup, entry))) await fs.cp(path.join(backup, entry), path.join(root, entry), {
-			recursive: true,
-			verbatimSymlinks: true
-		});
-	}
-}
-async function runGeneration(root, fileCount, update, skill, selection, settings) {
-	const gitRemote = await findGitRemote(root);
-	const backup = await backupArtifacts(root);
-	console.log(pc.bold(`\nGenerating artifacts from ${fileCount} ${fileCount === 1 ? "file" : "files"} with ${AGENT_LABELS[settings.agent]}…\n`));
-	try {
-		await withCancellation("Cancelling generation…", (abortController) => generateArtifacts(root, path.basename(root), gitRemote, update, abortController, skill, selection, settings));
-		console.log(pc.green(`\n✔ Artifacts written to ${ROOT_CONFIG} and .uigraph/`));
-	} catch (error) {
-		await restoreArtifacts(root, backup);
-		if (error instanceof AnalysisCancelledError) fail("Generation cancelled. The previous artifacts were restored.", 130);
-		if (error instanceof AnalysisError) fail(`${error.message}\n  The previous artifacts were restored.`);
-		throw error;
-	} finally {
-		await fs.rm(backup, {
-			recursive: true,
-			force: true
-		});
-	}
-}
 function printSummary(db) {
 	const endpoints = db.apiGroups.reduce((count, { endpoints }) => count + endpoints.length, 0);
 	console.log(pc.dim(`  ${db.services.length} services · ${endpoints} endpoints · ${db.dependencies.length} dependencies · ${db.diagrams.length} diagrams`));
 }
-async function generate(root, hasArtifacts, options) {
-	const fileCount = await countAnalyzableFiles(root);
-	const settings = {
-		agent: await chooseAgent(options.agent, "Which agent should generate the artifacts?"),
-		model: options.model,
-		maxBudgetUsd: options.maxBudgetUsd
-	};
-	if (settings.agent !== "claude" && settings.maxBudgetUsd !== void 0) throw new UsageError(`--max-budget only works with Claude. ${AGENT_LABELS[settings.agent]} does not support a spending cap.`);
-	if (!await confirmAnalysis(root, settings)) return false;
-	const skill = await downloadSkillOrFail();
-	await runGeneration(root, fileCount, hasArtifacts, skill, await chooseDiagrams(root, skill, settings), settings);
-	return true;
-}
 async function registerProject(root, port) {
 	const { db, errors } = await loadArtifacts(root);
 	if (errors.length > 0) {
-		console.error(pc.red(`✖ The UIGraph artifacts are invalid:\n${errors.map((error) => `  • ${error}`).join("\n")}\n  Fix them or run "uigraph generate --update".`));
+		console.error(pc.red(`✖ The UIGraph artifacts are invalid:\n${errors.map((error) => `  • ${error}`).join("\n")}\n  Fix them, or ask your coding agent to fix them with the UIGraph skill.`));
 		return false;
 	}
 	printSummary(db);
 	return reportSync(root, await syncProject(root), port);
 }
-async function offerGuidance(root, hasGuidance) {
-	const accepted = await confirm({
-		message: hasGuidance ? "Update the UIGraph instructions for coding agents?" : "Add UIGraph instructions for coding agents?",
-		default: true
-	});
-	await setGuidanceDeclined(root, !accepted);
-	if (!accepted) {
-		console.log(pc.dim("  Run \"uigraph init\" to add them later."));
-		return;
-	}
-	const files = await writeGuidance(root);
-	console.log(pc.green(`✔ Wrote ${GUIDANCE_FILE} and linked it from ${files.join(" and ")}`));
-}
 function reportSync(root, result, port) {
 	if (result.synced) {
 		console.log(pc.green(`✔ Registered with the viewer (${serverUrl(port)})`));
@@ -4466,82 +3863,33 @@ function parseNumber(min, max, integer) {
 	};
 }
 const parsePort = parseNumber(1, 65535, true);
-const parseBudget = parseNumber(.01, 1e4, false);
 function agentOption() {
 	return new Option("--agent <name>", "Coding agent to use").choices(AGENT_NAMES);
 }
 function portOption() {
 	return new Option("--port <number>", "Viewer port").env("UIGRAPH_PORT").default(DEFAULT_PORT).argParser(parsePort);
 }
-const program = new Command().name("uigraph").description("Generate UIGraph artifacts for a repository with a coding agent (Claude Code,\nCodex, OpenCode, Pi or Cursor) and browse every registered repository in one\nlocal viewer.").version(VERSION, "-v, --version").option("--debug", "Print stack traces, agent output and Lens progress (also UIGRAPH_DEBUG=1)").showHelpAfterError("(run uigraph --help for usage)").addHelpText("after", "\nA repository literally named \"open\", \"init\", \"generate\", \"sync\", \"start\",\n\"status\", \"stop\", \"restart\" or \"lens\" can be passed as ./start.").hook("preAction", () => {
+const program = new Command().name("uigraph").description("Browse the UIGraph artifacts of every registered repository in one local\nviewer, and review pull requests with Lens.").version(VERSION, "-v, --version").option("--debug", "Print stack traces, agent output and Lens progress (also UIGRAPH_DEBUG=1)").showHelpAfterError("(run uigraph --help for usage)").addHelpText("after", "\nA repository literally named \"open\", \"sync\", \"start\", \"status\", \"stop\",\n\"restart\" or \"lens\" can be passed as ./start.").hook("preAction", () => {
 	if (program.opts().debug === true) {
 		process.env.UIGRAPH_DEBUG = "1";
 		consola.level = LogLevels.debug;
 	}
 });
-program.command("open", { isDefault: true }).description("Start the viewer, offer to generate artifacts if there are none, and open it (default)").argument("[repository]", "Repository path (default: current directory)").addOption(agentOption()).option("--model <name>", "Model to use for generation, in the agent's own format").option("--max-budget <usd>", "Spending cap per Claude session (planning, generation and repair each get one). Claude only", parseBudget).addOption(portOption()).option("--no-open", "Do not open a browser").action(async (repository, options) => {
+program.command("open", { isDefault: true }).description("Start the viewer, show the artifacts of a repository in it, and open it (default)").argument("[repository]", "Repository path (default: current directory)").addOption(portOption()).option("--no-open", "Do not open a browser").action(async (repository, options) => {
 	const root = await resolveRepository(repository);
 	await startViewer(options.port, "background");
 	const hasArtifacts = await pathExists(path.join(root, ROOT_CONFIG));
-	let generated = false;
+	let synced = true;
 	if (hasArtifacts) {
 		console.log(`Opening the UIGraph artifacts in ${pc.cyan(root)}`);
-		console.log(pc.dim("  Run \"uigraph generate --update\" to update them."));
-	} else if (!process.stdin.isTTY) console.log(`${root} has no UIGraph artifacts. Run "uigraph generate" in a terminal to generate them.`);
-	else if (await confirm({
-		message: `${root} has no UIGraph artifacts. Generate them with an agent?`,
-		default: true
-	})) generated = await generate(root, false, {
-		agent: options.agent,
-		model: options.model,
-		maxBudgetUsd: options.maxBudget
-	});
-	const synced = hasArtifacts || generated ? await registerProject(root, options.port) : true;
-	if (process.stdin.isTTY && (hasArtifacts || generated) && !await pathExists(path.join(root, ".uigraph/AGENTS.md")) && !await isGuidanceDeclined(root)) await offerGuidance(root, false);
+		synced = await registerProject(root, options.port);
+	} else console.log(`${root} has no UIGraph artifacts. ${GENERATE_HINT}`);
 	if (options.open) await openBrowser(serverUrl(options.port));
 	if (!synced) process.exitCode = 1;
 });
-program.command("init").description("Generate artifacts if there are none, then add or update the instructions for coding agents").argument("[repository]", "Repository path (default: current directory)").addOption(agentOption()).option("--model <name>", "Model to use for generation, in the agent's own format").option("--max-budget <usd>", "Spending cap per Claude session (planning, generation and repair each get one). Claude only", parseBudget).action(async (repository, options) => {
-	const root = await resolveRepository(repository);
-	if (!process.stdin.isTTY) throw new UsageError("\"uigraph init\" needs a terminal.");
-	if (!await pathExists(path.join(root, ".uigraph.yaml"))) {
-		if (!await generate(root, false, {
-			agent: options.agent,
-			model: options.model,
-			maxBudgetUsd: options.maxBudget
-		})) {
-			process.exitCode = 130;
-			return;
-		}
-	}
-	const synced = await registerProject(root, parsePort(process.env.UIGRAPH_PORT ?? String(7357)));
-	await offerGuidance(root, await pathExists(path.join(root, GUIDANCE_FILE)));
-	if (!synced) process.exitCode = 1;
-});
-program.command("generate").description("Generate artifacts, or update them after asking, then exit").argument("[repository]", "Repository path (default: current directory)").option("--update", "Regenerate existing artifacts without asking").addOption(agentOption()).option("--model <name>", "Model to use for generation, in the agent's own format").option("--max-budget <usd>", "Spending cap per Claude session (planning, generation and repair each get one). Claude only", parseBudget).action(async (repository, options) => {
-	const root = await resolveRepository(repository);
-	if (!process.stdin.isTTY) throw new UsageError("\"uigraph generate\" needs a terminal.");
-	const hasArtifacts = await pathExists(path.join(root, ROOT_CONFIG));
-	if (hasArtifacts && options.update !== true && !await confirm({
-		message: `${root} already has UIGraph artifacts. Update them?`,
-		default: false
-	})) {
-		console.log("Nothing was changed.");
-		return;
-	}
-	if (!await generate(root, hasArtifacts, {
-		agent: options.agent,
-		model: options.model,
-		maxBudgetUsd: options.maxBudget
-	})) {
-		process.exitCode = 130;
-		return;
-	}
-	if (!await registerProject(root, parsePort(process.env.UIGRAPH_PORT ?? String(7357)))) process.exitCode = 1;
-});
 program.command("sync").description("Show the artifacts of a repository in the viewer, then exit").argument("[repository]", "Repository path (default: current directory)").action(async (repository) => {
 	const root = await resolveRepository(repository);
-	if (!await pathExists(path.join(root, ".uigraph.yaml"))) throw new UsageError(`${root} has no UIGraph artifacts. Run "uigraph generate" to generate them.`);
+	if (!await pathExists(path.join(root, ".uigraph.yaml"))) throw new UsageError(`${root} has no UIGraph artifacts. ${GENERATE_HINT}`);
 	if (!await registerProject(root, parsePort(process.env.UIGRAPH_PORT ?? String(7357)))) process.exitCode = 1;
 });
 program.command("start").description("Start the viewer").addOption(portOption()).action(async (options) => {