npm - @percepta/kaizen - Versions diffs - 0.8.0 → 0.9.0 - Mend

@percepta/kaizen 0.8.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2295) hide show

package/dist/dashboard/src/lib/langfuse-errors.js ADDED Viewed

@@ -0,0 +1,51 @@
+//#region dashboard/src/lib/langfuse-errors.ts
+async function formatLangfuseHttpError(res, resource) {
+	const detail = await extractReadableDetail(res);
+	const status = `Langfuse returned ${res.status}${res.statusText ? ` ${res.statusText}` : ""}.`;
+	const remediation = res.status === 401 || res.status === 403 ? "Check that the Langfuse host and API keys are for the right workspace and have access to this data." : res.status === 404 ? "Confirm the selected dataset or trace still exists in Langfuse." : res.status >= 500 ? "Langfuse may be temporarily unavailable. Try refreshing in a moment." : "Check the Langfuse connection and try refreshing.";
+	return [
+		`Kaizen could not load ${resource} from Langfuse.`,
+		status,
+		remediation,
+		detail ? `Detail: ${detail}` : null
+	].filter(Boolean).join(" ");
+}
+function formatLangfuseRequestError(err) {
+	if (err instanceof Error && err.name === "AbortError") return "Kaizen could not load Langfuse data because Langfuse did not respond in time. Check your connection and try refreshing.";
+	return `Kaizen could not reach Langfuse. Check your network or VPN, confirm the Langfuse host is reachable, then refresh.${err instanceof Error && err.message.trim() ? ` Detail: ${truncate(err.message.trim())}` : ""}`;
+}
+async function extractReadableDetail(res) {
+	const text = await res.text().catch(() => "");
+	if (!text.trim() || looksLikeHtml(text)) return null;
+	try {
+		const message = extractJsonMessage(JSON.parse(text));
+		if (message) return truncate(message);
+	} catch {}
+	return truncate(text.replace(/\s+/g, " ").trim());
+}
+function extractJsonMessage(value) {
+	if (!isRecord(value)) return null;
+	for (const key of [
+		"message",
+		"error",
+		"detail"
+	]) {
+		const candidate = value[key];
+		if (typeof candidate === "string" && candidate.trim()) return candidate.trim();
+	}
+	return null;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function looksLikeHtml(text) {
+	const trimmed = text.trim().toLowerCase();
+	return trimmed.startsWith("<!doctype html") || trimmed.startsWith("<html") || /<body[\s>]/.test(trimmed);
+}
+function truncate(text) {
+	return text.length > 180 ? `${text.slice(0, 177)}...` : text;
+}
+//#endregion
+export { formatLangfuseHttpError, formatLangfuseRequestError };
+//# sourceMappingURL=langfuse-errors.js.map

package/dist/dashboard/src/lib/langfuse-errors.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"langfuse-errors.js","names":[],"sources":["../../../../dashboard/src/lib/langfuse-errors.ts"],"sourcesContent":["export async function formatLangfuseHttpError(\n res: Response,\n resource: string,\n): Promise<string> {\n const detail = await extractReadableDetail(res);\n const status = `Langfuse returned ${res.status}${\n res.statusText ? ` ${res.statusText}` : \"\"\n }.`;\n\n const remediation =\n res.status === 401 || res.status === 403\n ? \"Check that the Langfuse host and API keys are for the right workspace and have access to this data.\"\n : res.status === 404\n ? \"Confirm the selected dataset or trace still exists in Langfuse.\"\n : res.status >= 500\n ? \"Langfuse may be temporarily unavailable. Try refreshing in a moment.\"\n : \"Check the Langfuse connection and try refreshing.\";\n\n return [\n `Kaizen could not load ${resource} from Langfuse.`,\n status,\n remediation,\n detail ? `Detail: ${detail}` : null,\n ]\n .filter(Boolean)\n .join(\" \");\n}\n\nexport function formatLangfuseRequestError(err: unknown): string {\n if (err instanceof Error && err.name === \"AbortError\") {\n return \"Kaizen could not load Langfuse data because Langfuse did not respond in time. Check your connection and try refreshing.\";\n }\n\n const detail =\n err instanceof Error && err.message.trim()\n ? ` Detail: ${truncate(err.message.trim())}`\n : \"\";\n return `Kaizen could not reach Langfuse. Check your network or VPN, confirm the Langfuse host is reachable, then refresh.${detail}`;\n}\n\nasync function extractReadableDetail(res: Response): Promise<string | null> {\n const text = await res.text().catch(() => \"\");\n if (!text.trim() || looksLikeHtml(text)) return null;\n\n try {\n const parsed = JSON.parse(text) as unknown;\n const message = extractJsonMessage(parsed);\n if (message) return truncate(message);\n } catch {\n // Plain text responses are handled below.\n }\n\n return truncate(text.replace(/\\s+/g, \" \").trim());\n}\n\nfunction extractJsonMessage(value: unknown): string | null {\n if (!isRecord(value)) return null;\n for (const key of [\"message\", \"error\", \"detail\"]) {\n const candidate = value[key];\n if (typeof candidate === \"string\" && candidate.trim()) {\n return candidate.trim();\n }\n }\n return null;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction looksLikeHtml(text: string): boolean {\n const trimmed = text.trim().toLowerCase();\n return (\n trimmed.startsWith(\"<!doctype html\") ||\n trimmed.startsWith(\"<html\") ||\n /<body[\\s>]/.test(trimmed)\n );\n}\n\nfunction truncate(text: string): string {\n return text.length > 180 ? `${text.slice(0, 177)}...` : text;\n}\n"],"mappings":";AAAA,eAAsB,wBACpB,KACA,UACiB;CACjB,MAAM,SAAS,MAAM,sBAAsB,IAAI;CAC/C,MAAM,SAAS,qBAAqB,IAAI,SACtC,IAAI,aAAa,IAAI,IAAI,eAAe,GACzC;CAED,MAAM,cACJ,IAAI,WAAW,OAAO,IAAI,WAAW,MACjC,wGACA,IAAI,WAAW,MACb,oEACA,IAAI,UAAU,MACZ,yEACA;AAEV,QAAO;EACL,yBAAyB,SAAS;EAClC;EACA;EACA,SAAS,WAAW,WAAW;EAChC,CACE,OAAO,QAAQ,CACf,KAAK,IAAI;;AAGd,SAAgB,2BAA2B,KAAsB;AAC/D,KAAI,eAAe,SAAS,IAAI,SAAS,aACvC,QAAO;AAOT,QAAO,oHAHL,eAAe,SAAS,IAAI,QAAQ,MAAM,GACtC,YAAY,SAAS,IAAI,QAAQ,MAAM,CAAC,KACxC;;AAIR,eAAe,sBAAsB,KAAuC;CAC1E,MAAM,OAAO,MAAM,IAAI,MAAM,CAAC,YAAY,GAAG;AAC7C,KAAI,CAAC,KAAK,MAAM,IAAI,cAAc,KAAK,CAAE,QAAO;AAEhD,KAAI;EAEF,MAAM,UAAU,mBADD,KAAK,MAAM,KACe,CAAC;AAC1C,MAAI,QAAS,QAAO,SAAS,QAAQ;SAC/B;AAIR,QAAO,SAAS,KAAK,QAAQ,QAAQ,IAAI,CAAC,MAAM,CAAC;;AAGnD,SAAS,mBAAmB,OAA+B;AACzD,KAAI,CAAC,SAAS,MAAM,CAAE,QAAO;AAC7B,MAAK,MAAM,OAAO;EAAC;EAAW;EAAS;EAAS,EAAE;EAChD,MAAM,YAAY,MAAM;AACxB,MAAI,OAAO,cAAc,YAAY,UAAU,MAAM,CACnD,QAAO,UAAU,MAAM;;AAG3B,QAAO;;AAGT,SAAS,SAAS,OAAkD;AAClE,QAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM;;AAG7E,SAAS,cAAc,MAAuB;CAC5C,MAAM,UAAU,KAAK,MAAM,CAAC,aAAa;AACzC,QACE,QAAQ,WAAW,iBAAiB,IACpC,QAAQ,WAAW,QAAQ,IAC3B,aAAa,KAAK,QAAQ;;AAI9B,SAAS,SAAS,MAAsB;AACtC,QAAO,KAAK,SAAS,MAAM,GAAG,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO"}

package/dist/dashboard/src/lib/langfuse-helpers.js ADDED Viewed

@@ -0,0 +1,25 @@
+//#region dashboard/src/lib/langfuse-helpers.ts
+/**
+* Shared helpers for Langfuse API route handlers.
+*/
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* Extract source trace ID from a dataset item, falling back to metadata
+* fields that some Langfuse deployments use instead of the top-level field.
+*/
+function getSourceTraceId(item) {
+	if (!isRecord(item)) return null;
+	if (typeof item.sourceTraceId === "string" && item.sourceTraceId) return item.sourceTraceId;
+	const metadata = item.metadata;
+	if (isRecord(metadata)) {
+		const maybeTrace = metadata.sourceTraceId ?? metadata.traceId;
+		if (typeof maybeTrace === "string" && maybeTrace) return maybeTrace;
+	}
+	return null;
+}
+//#endregion
+export { getSourceTraceId, isRecord };
+//# sourceMappingURL=langfuse-helpers.js.map

package/dist/dashboard/src/lib/langfuse-helpers.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"langfuse-helpers.js","names":[],"sources":["../../../../dashboard/src/lib/langfuse-helpers.ts"],"sourcesContent":["/**\n * Shared helpers for Langfuse API route handlers.\n */\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Extract source trace ID from a dataset item, falling back to metadata\n * fields that some Langfuse deployments use instead of the top-level field.\n */\nexport function getSourceTraceId(item: unknown): string | null {\n if (!isRecord(item)) return null;\n if (typeof item.sourceTraceId === \"string\" && item.sourceTraceId) {\n return item.sourceTraceId;\n }\n const metadata = item.metadata;\n if (isRecord(metadata)) {\n const maybeTrace = metadata.sourceTraceId ?? metadata.traceId;\n if (typeof maybeTrace === \"string\" && maybeTrace) return maybeTrace;\n }\n return null;\n}\n"],"mappings":";;;;AAIA,SAAgB,SAAS,OAAkD;AACzE,QAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM;;;;;;AAO7E,SAAgB,iBAAiB,MAA8B;AAC7D,KAAI,CAAC,SAAS,KAAK,CAAE,QAAO;AAC5B,KAAI,OAAO,KAAK,kBAAkB,YAAY,KAAK,cACjD,QAAO,KAAK;CAEd,MAAM,WAAW,KAAK;AACtB,KAAI,SAAS,SAAS,EAAE;EACtB,MAAM,aAAa,SAAS,iBAAiB,SAAS;AACtD,MAAI,OAAO,eAAe,YAAY,WAAY,QAAO;;AAE3D,QAAO"}

package/dist/dashboard/src/lib/run-api.js ADDED Viewed

@@ -0,0 +1,8 @@
+//#region dashboard/src/lib/run-api.ts
+function isSafeRunPathSegment(value) {
+	return value.length > 0 && !value.includes("..") && !value.includes("/") && !value.includes("\\");
+}
+//#endregion
+export { isSafeRunPathSegment };
+//# sourceMappingURL=run-api.js.map

package/dist/dashboard/src/lib/run-api.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"run-api.js","names":[],"sources":["../../../../dashboard/src/lib/run-api.ts"],"sourcesContent":["export function isSafeRunPathSegment(value: string): boolean {\n return (\n value.length > 0 &&\n !value.includes(\"..\") &&\n !value.includes(\"/\") &&\n !value.includes(\"\\\\\")\n );\n}\n"],"mappings":";AAAA,SAAgB,qBAAqB,OAAwB;AAC3D,QACE,MAAM,SAAS,KACf,CAAC,MAAM,SAAS,KAAK,IACrB,CAAC,MAAM,SAAS,IAAI,IACpB,CAAC,MAAM,SAAS,KAAK"}

package/dist/dashboard/src/lib/run-store.js ADDED Viewed

@@ -0,0 +1,174 @@
+import { normalizeLinearIssue } from "../../../shared/linear-issue.js";
+import { getKaizenStateDir } from "./workspace.js";
+import fs from "node:fs";
+import path from "node:path";
+//#region dashboard/src/lib/run-store.ts
+function listRunRecords(systemId) {
+	const stateDir = getKaizenStateDir();
+	const runsRoot = path.join(stateDir, "runs");
+	if (!fs.existsSync(runsRoot)) return [];
+	const systemIds = systemId ? [systemId] : safeDirs(runsRoot);
+	const out = [];
+	for (const system of systemIds) {
+		const systemDir = path.join(runsRoot, system);
+		for (const runId of safeDirs(systemDir)) {
+			const dir = path.join(systemDir, runId);
+			const manifest = parseRunManifest(readJson(path.join(dir, "manifest.json")));
+			if (!manifest) continue;
+			const state = parseRunState(readJson(path.join(dir, "state.json"))) ?? {
+				run_id: manifest.run_id,
+				status: "running",
+				score: null
+			};
+			out.push({
+				manifest,
+				state,
+				dir,
+				eventsPath: path.join(dir, "events.jsonl"),
+				failuresPath: path.join(dir, "failures.jsonl")
+			});
+		}
+	}
+	out.sort((a, b) => b.manifest.started_at < a.manifest.started_at ? -1 : 1);
+	return out;
+}
+function toRunStatus(run) {
+	const { manifest, state } = run;
+	const metrics = readCompleteMetrics(run.eventsPath);
+	if (state.score !== null) metrics.score = state.score;
+	return {
+		runId: manifest.run_id,
+		runName: manifest.variant,
+		status: state.status,
+		worktreeBranch: manifest.git_branch ?? "",
+		parentId: manifest.parent_id,
+		system: manifest.system,
+		progress: getProgress(manifest, state),
+		metrics,
+		totalItems: state.n_total ?? null,
+		linearIssue: normalizeLinearIssue(manifest.linear_issue_url ?? manifest.linear_issue_id) ?? void 0,
+		evalConfig: {
+			dataset: manifest.dataset_version,
+			evalVersion: manifest.eval_version,
+			datasetItemCount: state.n_total ?? 0
+		},
+		startedAt: manifest.started_at,
+		updatedAt: state.ended_at ?? state.updated_at ?? manifest.started_at
+	};
+}
+function getProgress(manifest, state) {
+	if (state.status === "running") return {
+		completed: state.n_done ?? 0,
+		total: state.n_total ?? 0,
+		lastHeartbeat: state.updated_at ?? manifest.started_at
+	};
+	if ((state.status === "crashed" || state.status === "aborted") && typeof state.n_done === "number" && typeof state.n_total === "number") return {
+		completed: state.n_done,
+		total: state.n_total,
+		lastHeartbeat: state.updated_at ?? state.ended_at ?? manifest.started_at
+	};
+}
+function readFailures(systemId, runId) {
+	return readNdjson(path.join(getKaizenStateDir(), "runs", systemId, runId, "failures.jsonl"));
+}
+function readEvents(systemId, runId) {
+	return readNdjson(path.join(getKaizenStateDir(), "runs", systemId, runId, "events.jsonl"));
+}
+function safeDirs(dir) {
+	try {
+		return fs.readdirSync(dir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+	} catch {
+		return [];
+	}
+}
+function readJson(file) {
+	try {
+		return JSON.parse(fs.readFileSync(file, "utf-8"));
+	} catch {
+		return null;
+	}
+}
+function readNdjson(file) {
+	try {
+		return fs.readFileSync(file, "utf-8").split("\n").filter(Boolean).map((line) => JSON.parse(line));
+	} catch {
+		return [];
+	}
+}
+function readCompleteMetrics(eventsPath) {
+	const metrics = {};
+	for (const event of readNdjson(eventsPath)) {
+		if (!isRecord(event) || event.type !== "complete") continue;
+		if (typeof event.score === "number") metrics.score = event.score;
+		if (event.breakdown && typeof event.breakdown === "object" && !Array.isArray(event.breakdown)) {
+			for (const [key, value] of Object.entries(event.breakdown)) if (typeof value === "number") metrics[key] = value;
+		}
+	}
+	return metrics;
+}
+function parseRunManifest(value) {
+	if (!isRecord(value)) return null;
+	const runId = stringValue(value.run_id);
+	const system = stringValue(value.system);
+	const variant = stringValue(value.variant);
+	const hypothesis = stringValue(value.hypothesis);
+	const datasetVersion = stringValue(value.dataset_version);
+	const startedAt = stringValue(value.started_at);
+	const evalVersion = numberValue(value.eval_version);
+	if (!runId || !system || !variant || hypothesis === null || !datasetVersion || !startedAt || evalVersion === null) return null;
+	return {
+		run_id: runId,
+		system,
+		variant,
+		parent_id: nullableStringValue(value.parent_id),
+		hypothesis,
+		eval_version: evalVersion,
+		dataset_version: datasetVersion,
+		started_at: startedAt,
+		git_sha: nullableStringValue(value.git_sha),
+		git_branch: nullableStringValue(value.git_branch),
+		linear_issue_id: nullableStringValue(value.linear_issue_id) ?? nullableStringValue(value.linear_issue),
+		linear_issue_url: nullableStringValue(value.linear_issue_url)
+	};
+}
+function parseRunState(value) {
+	if (!isRecord(value)) return null;
+	const runId = stringValue(value.run_id);
+	const status = runStatusValue(value.status);
+	if (!runId || !status) return null;
+	return {
+		run_id: runId,
+		status,
+		score: nullableNumberValue(value.score),
+		n_total: nullableNumberValue(value.n_total),
+		n_done: numberValue(value.n_done) ?? void 0,
+		promoted: nullableBooleanValue(value.promoted),
+		ended_at: nullableStringValue(value.ended_at),
+		updated_at: stringValue(value.updated_at) ?? void 0
+	};
+}
+function runStatusValue(value) {
+	return value === "complete" || value === "crashed" || value === "aborted" || value === "running" ? value : null;
+}
+function stringValue(value) {
+	return typeof value === "string" ? value : null;
+}
+function nullableStringValue(value) {
+	return value === null || value === void 0 ? null : stringValue(value);
+}
+function numberValue(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function nullableNumberValue(value) {
+	return value === null || value === void 0 ? null : numberValue(value);
+}
+function nullableBooleanValue(value) {
+	return value === null || value === void 0 || typeof value !== "boolean" ? null : value;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
+export { listRunRecords, readEvents, readFailures, toRunStatus };
+//# sourceMappingURL=run-store.js.map

package/dist/dashboard/src/lib/run-store.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"run-store.js","names":[],"sources":["../../../../dashboard/src/lib/run-store.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { normalizeLinearIssue } from \"../../../shared/linear-issue.js\";\nimport type { RunStatus } from \"./types\";\nimport { getKaizenStateDir } from \"./workspace\";\n\nexport interface RunManifest {\n run_id: string;\n system: string;\n variant: string;\n parent_id: string | null;\n hypothesis: string;\n eval_version: number;\n dataset_version: string;\n started_at: string;\n git_sha?: string | null;\n git_branch?: string | null;\n linear_issue_id?: string | null;\n linear_issue_url?: string | null;\n}\n\nexport interface RunState {\n run_id: string;\n status: \"complete\" | \"crashed\" | \"aborted\" | \"running\";\n score: number | null;\n n_total?: number | null;\n n_done?: number;\n promoted?: boolean | null;\n ended_at?: string | null;\n updated_at?: string;\n}\n\nexport interface RunRecord {\n manifest: RunManifest;\n state: RunState;\n dir: string;\n eventsPath: string;\n failuresPath: string;\n}\n\nexport function listRunRecords(systemId?: string): RunRecord[] {\n const stateDir = getKaizenStateDir();\n const runsRoot = path.join(stateDir, \"runs\");\n if (!fs.existsSync(runsRoot)) return [];\n\n const systemIds = systemId ? [systemId] : safeDirs(runsRoot);\n const out: RunRecord[] = [];\n\n for (const system of systemIds) {\n const systemDir = path.join(runsRoot, system);\n for (const runId of safeDirs(systemDir)) {\n const dir = path.join(systemDir, runId);\n const manifest = parseRunManifest(\n readJson(path.join(dir, \"manifest.json\")),\n );\n if (!manifest) continue;\n const state = parseRunState(readJson(path.join(dir, \"state.json\"))) ?? {\n run_id: manifest.run_id,\n status: \"running\",\n score: null,\n };\n out.push({\n manifest,\n state,\n dir,\n eventsPath: path.join(dir, \"events.jsonl\"),\n failuresPath: path.join(dir, \"failures.jsonl\"),\n });\n }\n }\n\n out.sort((a, b) => (b.manifest.started_at < a.manifest.started_at ? -1 : 1));\n return out;\n}\n\nexport function toRunStatus(run: RunRecord): RunStatus {\n const { manifest, state } = run;\n const metrics = readCompleteMetrics(run.eventsPath);\n if (state.score !== null) metrics.score = state.score;\n\n return {\n runId: manifest.run_id,\n runName: manifest.variant,\n status: state.status,\n worktreeBranch: manifest.git_branch ?? \"\",\n parentId: manifest.parent_id,\n system: manifest.system,\n progress: getProgress(manifest, state),\n metrics,\n totalItems: state.n_total ?? null,\n linearIssue:\n normalizeLinearIssue(\n manifest.linear_issue_url ?? manifest.linear_issue_id,\n ) ?? undefined,\n evalConfig: {\n dataset: manifest.dataset_version,\n evalVersion: manifest.eval_version,\n datasetItemCount: state.n_total ?? 0,\n },\n startedAt: manifest.started_at,\n updatedAt: state.ended_at ?? state.updated_at ?? manifest.started_at,\n };\n}\n\nfunction getProgress(\n manifest: RunManifest,\n state: RunState,\n): RunStatus[\"progress\"] {\n if (state.status === \"running\") {\n return {\n completed: state.n_done ?? 0,\n total: state.n_total ?? 0,\n lastHeartbeat: state.updated_at ?? manifest.started_at,\n };\n }\n\n if (\n (state.status === \"crashed\" || state.status === \"aborted\") &&\n typeof state.n_done === \"number\" &&\n typeof state.n_total === \"number\"\n ) {\n return {\n completed: state.n_done,\n total: state.n_total,\n lastHeartbeat: state.updated_at ?? state.ended_at ?? manifest.started_at,\n };\n }\n\n return undefined;\n}\n\nexport function readFailures(systemId: string, runId: string): unknown[] {\n const file = path.join(\n getKaizenStateDir(),\n \"runs\",\n systemId,\n runId,\n \"failures.jsonl\",\n );\n return readNdjson(file);\n}\n\nexport function readEvents(systemId: string, runId: string): unknown[] {\n const file = path.join(\n getKaizenStateDir(),\n \"runs\",\n systemId,\n runId,\n \"events.jsonl\",\n );\n return readNdjson(file);\n}\n\nfunction safeDirs(dir: string): string[] {\n try {\n return fs\n .readdirSync(dir, { withFileTypes: true })\n .filter((entry) => entry.isDirectory())\n .map((entry) => entry.name);\n } catch {\n return [];\n }\n}\n\nfunction readJson(file: string): unknown {\n try {\n return JSON.parse(fs.readFileSync(file, \"utf-8\"));\n } catch {\n return null;\n }\n}\n\nfunction readNdjson(file: string): unknown[] {\n try {\n return fs\n .readFileSync(file, \"utf-8\")\n .split(\"\\n\")\n .filter(Boolean)\n .map((line) => JSON.parse(line));\n } catch {\n return [];\n }\n}\n\nfunction readCompleteMetrics(eventsPath: string): Record<string, number> {\n const metrics: Record<string, number> = {};\n for (const event of readNdjson(eventsPath)) {\n if (!isRecord(event) || event.type !== \"complete\") continue;\n if (typeof event.score === \"number\") metrics.score = event.score;\n if (\n event.breakdown &&\n typeof event.breakdown === \"object\" &&\n !Array.isArray(event.breakdown)\n ) {\n for (const [key, value] of Object.entries(event.breakdown)) {\n if (typeof value === \"number\") metrics[key] = value;\n }\n }\n }\n return metrics;\n}\n\nfunction parseRunManifest(value: unknown): RunManifest | null {\n if (!isRecord(value)) return null;\n const runId = stringValue(value.run_id);\n const system = stringValue(value.system);\n const variant = stringValue(value.variant);\n const hypothesis = stringValue(value.hypothesis);\n const datasetVersion = stringValue(value.dataset_version);\n const startedAt = stringValue(value.started_at);\n const evalVersion = numberValue(value.eval_version);\n if (\n !runId ||\n !system ||\n !variant ||\n hypothesis === null ||\n !datasetVersion ||\n !startedAt ||\n evalVersion === null\n ) {\n return null;\n }\n\n return {\n run_id: runId,\n system,\n variant,\n parent_id: nullableStringValue(value.parent_id),\n hypothesis,\n eval_version: evalVersion,\n dataset_version: datasetVersion,\n started_at: startedAt,\n git_sha: nullableStringValue(value.git_sha),\n git_branch: nullableStringValue(value.git_branch),\n linear_issue_id:\n nullableStringValue(value.linear_issue_id) ??\n nullableStringValue(value.linear_issue),\n linear_issue_url: nullableStringValue(value.linear_issue_url),\n };\n}\n\nfunction parseRunState(value: unknown): RunState | null {\n if (!isRecord(value)) return null;\n const runId = stringValue(value.run_id);\n const status = runStatusValue(value.status);\n if (!runId || !status) return null;\n return {\n run_id: runId,\n status,\n score: nullableNumberValue(value.score),\n n_total: nullableNumberValue(value.n_total),\n n_done: numberValue(value.n_done) ?? undefined,\n promoted: nullableBooleanValue(value.promoted),\n ended_at: nullableStringValue(value.ended_at),\n updated_at: stringValue(value.updated_at) ?? undefined,\n };\n}\n\nfunction runStatusValue(value: unknown): RunState[\"status\"] | null {\n return value === \"complete\" ||\n value === \"crashed\" ||\n value === \"aborted\" ||\n value === \"running\"\n ? value\n : null;\n}\n\nfunction stringValue(value: unknown): string | null {\n return typeof value === \"string\" ? value : null;\n}\n\nfunction nullableStringValue(value: unknown): string | null {\n return value === null || value === undefined ? null : stringValue(value);\n}\n\nfunction numberValue(value: unknown): number | null {\n return typeof value === \"number\" && Number.isFinite(value) ? value : null;\n}\n\nfunction nullableNumberValue(value: unknown): number | null {\n return value === null || value === undefined ? null : numberValue(value);\n}\n\nfunction nullableBooleanValue(value: unknown): boolean | null {\n return value === null || value === undefined || typeof value !== \"boolean\"\n ? null\n : value;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"],"mappings":"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"}

package/dist/dashboard/src/lib/systems.js ADDED Viewed

@@ -0,0 +1,6 @@
+//#region dashboard/src/lib/systems.ts
+const DEMO_SYSTEM_ID = "demo-system";
+//#endregion
+export { DEMO_SYSTEM_ID };
+//# sourceMappingURL=systems.js.map

package/dist/dashboard/src/lib/systems.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"systems.js","names":[],"sources":["../../../../dashboard/src/lib/systems.ts"],"sourcesContent":["export const DEMO_SYSTEM_ID = \"demo-system\";\n\nexport type EvalType = \"ground_truth\" | \"llm_judge\" | \"human\" | \"policy\";\n\nexport interface SystemDefinition {\n id: string;\n name: string;\n customerId: string;\n customerName: string;\n customerLogo: string | null;\n repo: string;\n status: \"not_started\" | \"in_progress\" | \"completed\";\n description: string;\n evalDataset: string | null;\n evalVersion: number | null;\n evalType: EvalType | null;\n primaryMetric: string | null;\n rubric: string | null;\n target: number | null;\n content: string;\n bestScore: number | null;\n totalRuns: number;\n traceRenderer: string | null;\n datasetItemRenderer: string | null;\n}\n"],"mappings":";AAAA,MAAa,iBAAiB"}

package/dist/dashboard/src/lib/types.js ADDED Viewed

@@ -0,0 +1,15 @@
+//#region dashboard/src/lib/types.ts
+function computeF2(precision, recall) {
+	if (precision + recall === 0) return 0;
+	return 5 * precision * recall / (4 * precision + recall);
+}
+function getPrimaryMetricValue(status, primaryMetric) {
+	if (!primaryMetric) return null;
+	if (primaryMetric in status.metrics) return status.metrics[primaryMetric];
+	if (primaryMetric === "f2" && "precision" in status.metrics && "recall" in status.metrics) return computeF2(status.metrics.precision, status.metrics.recall);
+	return null;
+}
+//#endregion
+export { getPrimaryMetricValue };
+//# sourceMappingURL=types.js.map

package/dist/dashboard/src/lib/types.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"types.js","names":[],"sources":["../../../../dashboard/src/lib/types.ts"],"sourcesContent":["// --- Run record projected from kaizen/.kaizen/runs for Studio ---\n\nexport interface RunStatus {\n runId: string;\n runName: string;\n status: \"running\" | \"complete\" | \"crashed\" | \"aborted\";\n worktreeBranch: string;\n parentId: string | null;\n system: string;\n progress?: {\n completed: number;\n total: number;\n lastHeartbeat: string;\n };\n metrics: Record<string, number>;\n totalItems: number | null;\n langfuseRunId?: string;\n linearIssue?: {\n id: string;\n url: string;\n };\n evalConfig?: {\n dataset: string;\n evalVersion?: number;\n datasetItemCount: number;\n judge?: {\n rubric: string;\n rubricHash: string;\n model: string;\n temperature: number;\n };\n };\n startedAt: string;\n updatedAt: string;\n}\n\n// --- Metric helpers ---\n\ninterface MetricMeta {\n label: string;\n /** \"percent\" = multiply by 100 and append %. \"raw\" = display with 2 decimals. \"integer\" = display as whole number. */\n format: \"percent\" | \"raw\" | \"integer\";\n}\n\nconst METRIC_META: Record<string, MetricMeta> = {\n actionAccuracy: { label: \"Action Accuracy\", format: \"percent\" },\n parameterExtraction: { label: \"Param Extraction\", format: \"percent\" },\n clarificationAppropriateness: { label: \"Clarification\", format: \"percent\" },\n multiActionDetection: { label: \"Multi-Action\", format: \"percent\" },\n f1: { label: \"F1\", format: \"percent\" },\n f2: { label: \"F2\", format: \"percent\" },\n precision: { label: \"Precision\", format: \"percent\" },\n recall: { label: \"Recall\", format: \"percent\" },\n cost_per_item: { label: \"Cost / Item\", format: \"raw\" },\n avg_latency_s: { label: \"Avg Latency (s)\", format: \"raw\" },\n true_positives: { label: \"TP\", format: \"integer\" },\n false_positives: { label: \"FP\", format: \"integer\" },\n false_negatives: { label: \"FN\", format: \"integer\" },\n total_clis_scored: { label: \"CLIs Scored\", format: \"integer\" },\n items_with_metrics: { label: \"Items w/ Metrics\", format: \"integer\" },\n timeouts: { label: \"Timeouts\", format: \"integer\" },\n judge_quality: { label: \"Judge Quality\", format: \"percent\" },\n judge_quality_chartNotes: {\n label: \"Quality: Chart Notes\",\n format: \"percent\",\n },\n judge_quality_followUp: { label: \"Quality: Follow-Up\", format: \"percent\" },\n};\n\nexport const KNOWN_METRIC_KEYS = Object.keys(METRIC_META);\n\nexport function getMetricLabel(key: string): string {\n return (\n METRIC_META[key]?.label ??\n key\n .replace(/[_-]+/g, \" \")\n .replace(/([A-Z])/g, \" $1\")\n .replace(/^./, (s) => s.toUpperCase())\n .trim()\n );\n}\n\nexport function formatMetricValue(key: string, val: number): string {\n const meta = METRIC_META[key];\n if (meta?.format === \"integer\") return Math.round(val).toLocaleString();\n if (meta?.format === \"raw\") return val.toFixed(2);\n if (meta?.format === \"percent\") return (val * 100).toFixed(1) + \"%\";\n // Unknown metrics: if value > 1, it's likely a count; otherwise treat as percent.\n if (val > 1) return Math.round(val).toLocaleString();\n return (val * 100).toFixed(1) + \"%\";\n}\n\nexport function computeF2(precision: number, recall: number): number {\n if (precision + recall === 0) return 0;\n return (5 * precision * recall) / (4 * precision + recall);\n}\n\nexport function getPrimaryMetricValue(\n status: RunStatus,\n primaryMetric: string | null | undefined,\n): number | null {\n if (!primaryMetric) return null;\n\n if (primaryMetric in status.metrics) return status.metrics[primaryMetric];\n\n if (\n primaryMetric === \"f2\" &&\n \"precision\" in status.metrics &&\n \"recall\" in status.metrics\n ) {\n return computeF2(status.metrics.precision, status.metrics.recall);\n }\n\n return null;\n}\n\nexport function getPrimaryMetricLabel(\n primaryMetric: string | null | undefined,\n): string {\n if (!primaryMetric) return \"Score\";\n return getMetricLabel(primaryMetric);\n}\n"],"mappings":";AA4FA,SAAgB,UAAU,WAAmB,QAAwB;AACnE,KAAI,YAAY,WAAW,EAAG,QAAO;AACrC,QAAQ,IAAI,YAAY,UAAW,IAAI,YAAY;;AAGrD,SAAgB,sBACd,QACA,eACe;AACf,KAAI,CAAC,cAAe,QAAO;AAE3B,KAAI,iBAAiB,OAAO,QAAS,QAAO,OAAO,QAAQ;AAE3D,KACE,kBAAkB,QAClB,eAAe,OAAO,WACtB,YAAY,OAAO,QAEnB,QAAO,UAAU,OAAO,QAAQ,WAAW,OAAO,QAAQ,OAAO;AAGnE,QAAO"}

package/dist/dashboard/src/lib/workspace-env.js ADDED Viewed

@@ -0,0 +1,18 @@
+import { readEnvFile } from "../../../shared/env-file.js";
+import { getWorkspaceRoot } from "./workspace.js";
+import path from "node:path";
+//#region dashboard/src/lib/workspace-env.ts
+const WORKSPACE_ENV_FILE_NAME = ".env.local";
+function getWorkspaceEnvPath() {
+	return path.join(getWorkspaceRoot(), WORKSPACE_ENV_FILE_NAME);
+}
+function readWorkspaceEnvLocal() {
+	return readEnvFile(getWorkspaceEnvPath());
+}
+function missingEnvVars(env, required) {
+	return required.filter((key) => !env[key]?.trim());
+}
+//#endregion
+export { WORKSPACE_ENV_FILE_NAME, missingEnvVars, readWorkspaceEnvLocal };
+//# sourceMappingURL=workspace-env.js.map

package/dist/dashboard/src/lib/workspace-env.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"workspace-env.js","names":[],"sources":["../../../../dashboard/src/lib/workspace-env.ts"],"sourcesContent":["import path from \"node:path\";\nimport { readEnvFile } from \"../../../shared/env-file.js\";\nimport { getWorkspaceRoot } from \"./workspace\";\n\nexport const WORKSPACE_ENV_FILE_NAME = \".env.local\";\n\nexport function getWorkspaceEnvPath(): string {\n return path.join(getWorkspaceRoot(), WORKSPACE_ENV_FILE_NAME);\n}\n\nexport function readWorkspaceEnvLocal(): Record<string, string> {\n return readEnvFile(getWorkspaceEnvPath());\n}\n\nexport function missingEnvVars(\n env: Record<string, string | undefined>,\n required: string[],\n): string[] {\n return required.filter((key) => !env[key]?.trim());\n}\n"],"mappings":";;;;AAIA,MAAa,0BAA0B;AAEvC,SAAgB,sBAA8B;AAC5C,QAAO,KAAK,KAAK,kBAAkB,EAAE,wBAAwB;;AAG/D,SAAgB,wBAAgD;AAC9D,QAAO,YAAY,qBAAqB,CAAC;;AAG3C,SAAgB,eACd,KACA,UACU;AACV,QAAO,SAAS,QAAQ,QAAQ,CAAC,IAAI,MAAM,MAAM,CAAC"}

package/dist/dashboard/src/lib/workspace.js ADDED Viewed

@@ -0,0 +1,14 @@
+import { resolveKaizenStateDir } from "../../../shared/workspace-paths.js";
+import path from "node:path";
+//#region dashboard/src/lib/workspace.ts
+function getWorkspaceRoot() {
+	const raw = process.env.KAIZEN_WORKSPACE;
+	return raw ? path.resolve(raw) : process.cwd();
+}
+function getKaizenStateDir() {
+	return resolveKaizenStateDir(getWorkspaceRoot());
+}
+//#endregion
+export { getKaizenStateDir, getWorkspaceRoot };
+//# sourceMappingURL=workspace.js.map

package/dist/dashboard/src/lib/workspace.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"workspace.js","names":[],"sources":["../../../../dashboard/src/lib/workspace.ts"],"sourcesContent":["import path from \"node:path\";\nimport { resolveKaizenStateDir } from \"../../../shared/workspace-paths.js\";\n\nexport function getWorkspaceRoot(): string {\n const raw = process.env.KAIZEN_WORKSPACE;\n return raw ? path.resolve(raw) : process.cwd();\n}\n\nexport function getKaizenStateDir(): string {\n return resolveKaizenStateDir(getWorkspaceRoot());\n}\n"],"mappings":";;;AAGA,SAAgB,mBAA2B;CACzC,MAAM,MAAM,QAAQ,IAAI;AACxB,QAAO,MAAM,KAAK,QAAQ,IAAI,GAAG,QAAQ,KAAK;;AAGhD,SAAgB,oBAA4B;AAC1C,QAAO,sBAAsB,kBAAkB,CAAC"}

package/dist/index.js CHANGED Viewed

@@ -1,12 +1,12 @@
-import { runCreateView } from "./commands/create-view.js";
-import { runGuide } from "./commands/guide.js";
-import { runIdeas } from "./commands/ideas.js";
-import { runInitSystem } from "./commands/init-system.js";
-import { runInit } from "./commands/init.js";
-import { runLog } from "./commands/log.js";
-import { runRebuild } from "./commands/rebuild.js";
-import { runRun } from "./commands/run.js";
-import { runStudio } from "./commands/studio.js";
+import { runCreateView } from "./src/commands/create-view.js";
+import { runGuide } from "./src/commands/guide.js";
+import { runIdeas } from "./src/commands/ideas.js";
+import { runInitSystem } from "./src/commands/init-system.js";
+import { runInit } from "./src/commands/init.js";
+import { runLog } from "./src/commands/log.js";
+import { runRebuild } from "./src/commands/rebuild.js";
+import { runRun } from "./src/commands/run.js";
+import { runStudio } from "./src/commands/studio.js";
 //#region src/index.ts
 const HELP = `kaizen — automated AI researcher

package/dist/package.js CHANGED Viewed

@@ -1,7 +1,7 @@
 //#region package.json
 var package_default = {
 	name: "@percepta/kaizen",
-	version: "0.8.0",
+	version: "0.9.0",
 	description: "Automated AI researcher that improves AI systems",
 	keywords: [
 		"ai",
@@ -15,7 +15,6 @@ var package_default = {
 	files: [
 		"agent",
 		"bin",
-		"dashboard/.next/standalone",
 		"dist",
 		"shared",
 		"templates"
@@ -35,41 +34,42 @@ var package_default = {
 	},
 	publishConfig: { "access": "public" },
 	scripts: {
-		"build": "run-p build:*",
-		"build:cli": "tsdown",
-		"build:dashboard": "next build dashboard --webpack && node scripts/bundle-dashboard.mjs",
-		"clean": "rimraf dist dashboard/.next",
+		"build": "run-s clean build:all",
+		"build:all": "run-p build:ts build:studio:client",
+		"build:ts": "tsdown",
+		"build:studio:client": "vite build --config dashboard/vite.config.ts",
+		"clean": "rimraf dist",
 		"typecheck": "run-p typecheck:*",
 		"typecheck:cli": "tsc --noEmit",
 		"typecheck:dashboard": "tsc -p dashboard --noEmit",
 		"test": "vitest run",
 		"dev": "tsx src/index.ts",
-		"dev:studio": "KAIZEN_DEMO_MODE=1 KAIZEN_WORKSPACE=$PWD/examples/demo-workspace next dev dashboard --webpack --port 6789",
-		"dev:next": "KAIZEN_DEMO_MODE=1 KAIZEN_WORKSPACE=$PWD/examples/demo-workspace next dev dashboard --webpack --port 6789",
+		"dev:studio": "run-s build:studio:client dev:studio:server",
+		"dev:studio:server": "KAIZEN_DEMO_MODE=1 KAIZEN_WORKSPACE=$PWD/examples/demo-workspace tsx dashboard/src/studio/server/server.ts",
 		"seed:demo-data": "node scripts/seed-demo-traces.mjs --workspace $PWD/examples/demo-workspace",
 		"kaizen": "tsx src/index.ts"
 	},
 	dependencies: {
-		"esbuild": "^0.25.0",
+		"esbuild": "^0.28.0",
 		"tsx": "^4.21.0",
-		"yaml": "^2.8.2"
+		"yaml": "^2.8.4"
 	},
 	devDependencies: {
 		"@percepta/build": "workspace:*",
 		"@types/d3-hierarchy": "^3.1.7",
-		"@types/node": "^24.1.0",
-		"@types/react": "^19.0.8",
-		"@types/react-dom": "^19.0.3",
+		"@types/node": "^25.6.2",
+		"@types/react": "^19.2.14",
+		"@types/react-dom": "^19.2.3",
 		"@visx/group": "^3.12.0",
 		"@visx/hierarchy": "^3.12.0",
 		"@visx/shape": "^3.12.0",
-		"next": "16.1.6",
-		"react": "19.2.3",
-		"react-dom": "19.2.3",
-		"rimraf": "^5.0.5",
+		"@vitejs/plugin-react": "^6.0.1",
+		"react": "19.2.6",
+		"react-dom": "19.2.6",
+		"rimraf": "^6.1.3",
 		"typescript": "^6.0.3",
-		"vitest": "^4.0.17",
-		"zod": "4.1.4"
+		"vite": "^8.0.11",
+		"vitest": "^4.1.5"
 	},
 	peerDependencies: { "@types/react": "^19.0.0" },
 	engines: { "node": ">=20" }

package/dist/shared/env.js ADDED Viewed

@@ -0,0 +1,4 @@
+import "./env-file.js";
+import "node:fs";
+import "node:path";
+import "node:os";

package/dist/shared/workspace-paths.js CHANGED Viewed

@@ -79,6 +79,6 @@ function canonicalPath(path) {
 	}
 }
 //#endregion
-export { defaultKaizenStateDir, kaizenConfigPath, kaizenDir, kaizenSystemDir, kaizenSystemPath, kaizenSystemsDir, primaryWorktreeRoot, resolveKaizenStateDir };
+export { KAIZEN_DIR, KAIZEN_SYSTEMS_DIR, defaultKaizenStateDir, kaizenConfigPath, kaizenDir, kaizenSystemDir, kaizenSystemPath, kaizenSystemsDir, primaryWorktreeRoot, resolveKaizenStateDir };
 //# sourceMappingURL=workspace-paths.js.map

package/dist/src/commands/create-view.js ADDED Viewed

@@ -0,0 +1,58 @@
+import { kaizenSystemDir, kaizenSystemPath } from "../../shared/workspace-paths.js";
+import { templatesDir, workspaceRoot } from "../lib/paths.js";
+import { isSystemId, requireKaizenWorkspace } from "../lib/cli.js";
+import { applyVars, ensureDir, writeFileSafely } from "../lib/fs-utils.js";
+import { boolFlag, parseFlags, strFlag } from "../lib/parse-args.js";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+//#region src/commands/create-view.ts
+const VIEW_TYPES = ["trace", "dataset-item"];
+async function runCreateView(argv) {
+	const { positional, flags } = parseFlags(argv);
+	const root = workspaceRoot();
+	const force = boolFlag(flags, "force");
+	if (!requireKaizenWorkspace(root)) return 1;
+	const systemId = strFlag(flags, "system") ?? positional[0];
+	if (!systemId || !isSystemId(systemId)) {
+		process.stderr.write(`invalid system name: "${systemId ?? ""}". use kebab-case (e.g. cost-savings).\n`);
+		return 1;
+	}
+	if (!existsSync(kaizenSystemPath(root, systemId))) {
+		process.stderr.write(`system "${systemId}" not found at kaizen/systems/${systemId}/system.md.\nrun \`kaizen create system ${systemId}\` first.\n`);
+		return 1;
+	}
+	const typeFlag = strFlag(flags, "type");
+	if (!typeFlag) {
+		process.stderr.write(`kaizen create view: --type <${VIEW_TYPES.join("|")}> is required.\n`);
+		return 1;
+	}
+	const type = normalizeType(typeFlag);
+	if (!type) {
+		process.stderr.write(`invalid view type. use one of: ${VIEW_TYPES.join(", ")}.\n`);
+		return 1;
+	}
+	const dir = kaizenSystemDir(root, systemId);
+	const viewPath = join(dir, `${type}.tsx`);
+	if (existsSync(viewPath) && !force) {
+		process.stderr.write(`refusing to overwrite ${viewPath}. pass --force to replace.\n`);
+		return 1;
+	}
+	ensureDir(dir);
+	writeFileSafely(viewPath, applyVars(readFileSync(join(templatesDir(), "view", `${type}.tsx`), "utf-8"), { system_id: systemId }), { overwrite: force });
+	process.stdout.write(`scaffolded ${type} view for "${systemId}":\n`);
+	process.stdout.write(`  kaizen/systems/${systemId}/${type}.tsx\n`);
+	process.stdout.write([
+		"",
+		"Kaizen Studio loads this file by convention beside system.md.",
+		"Refresh the browser or focus the Studio window after edits to reload the view.",
+		""
+	].join("\n"));
+	return 0;
+}
+function normalizeType(value) {
+	return VIEW_TYPES.includes(value) ? value : null;
+}
+//#endregion
+export { runCreateView };
+//# sourceMappingURL=create-view.js.map

package/dist/src/commands/create-view.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"create-view.js","names":[],"sources":["../../../src/commands/create-view.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { isSystemId, requireKaizenWorkspace } from \"../lib/cli.js\";\nimport { applyVars, ensureDir, writeFileSafely } from \"../lib/fs-utils.js\";\nimport { boolFlag, parseFlags, strFlag } from \"../lib/parse-args.js\";\nimport {\n kaizenSystemDir,\n kaizenSystemPath,\n templatesDir,\n workspaceRoot,\n} from \"../lib/paths.js\";\n\nconst VIEW_TYPES = [\"trace\", \"dataset-item\"] as const;\ntype ViewType = (typeof VIEW_TYPES)[number];\n\nexport async function runCreateView(argv: string[]): Promise<number> {\n const { positional, flags } = parseFlags(argv);\n const root = workspaceRoot();\n const force = boolFlag(flags, \"force\");\n\n if (!requireKaizenWorkspace(root)) return 1;\n\n const systemId = strFlag(flags, \"system\") ?? positional[0];\n if (!systemId || !isSystemId(systemId)) {\n process.stderr.write(\n `invalid system name: \"${systemId ?? \"\"}\". use kebab-case (e.g. cost-savings).\\n`,\n );\n return 1;\n }\n\n const systemPath = kaizenSystemPath(root, systemId);\n if (!existsSync(systemPath)) {\n process.stderr.write(\n `system \"${systemId}\" not found at kaizen/systems/${systemId}/system.md.\\n` +\n `run \\`kaizen create system ${systemId}\\` first.\\n`,\n );\n return 1;\n }\n\n const typeFlag = strFlag(flags, \"type\");\n if (!typeFlag) {\n process.stderr.write(\n `kaizen create view: --type <${VIEW_TYPES.join(\"|\")}> is required.\\n`,\n );\n return 1;\n }\n const type = normalizeType(typeFlag);\n if (!type) {\n process.stderr.write(\n `invalid view type. use one of: ${VIEW_TYPES.join(\", \")}.\\n`,\n );\n return 1;\n }\n\n const dir = kaizenSystemDir(root, systemId);\n const viewPath = join(dir, `${type}.tsx`);\n if (existsSync(viewPath) && !force) {\n process.stderr.write(\n `refusing to overwrite ${viewPath}. pass --force to replace.\\n`,\n );\n return 1;\n }\n\n ensureDir(dir);\n const templatePath = join(templatesDir(), \"view\", `${type}.tsx`);\n const template = readFileSync(templatePath, \"utf-8\");\n writeFileSafely(viewPath, applyVars(template, { system_id: systemId }), {\n overwrite: force,\n });\n\n process.stdout.write(`scaffolded ${type} view for \"${systemId}\":\\n`);\n process.stdout.write(` kaizen/systems/${systemId}/${type}.tsx\\n`);\n process.stdout.write(\n [\n \"\",\n \"Kaizen Studio loads this file by convention beside system.md.\",\n \"Refresh the browser or focus the Studio window after edits to reload the view.\",\n \"\",\n ].join(\"\\n\"),\n );\n\n return 0;\n}\n\nfunction normalizeType(value: string): ViewType | null {\n return (VIEW_TYPES as readonly string[]).includes(value)\n ? (value as ViewType)\n : null;\n}\n"],"mappings":";;;;;;;;AAYA,MAAM,aAAa,CAAC,SAAS,eAAe;AAG5C,eAAsB,cAAc,MAAiC;CACnE,MAAM,EAAE,YAAY,UAAU,WAAW,KAAK;CAC9C,MAAM,OAAO,eAAe;CAC5B,MAAM,QAAQ,SAAS,OAAO,QAAQ;AAEtC,KAAI,CAAC,uBAAuB,KAAK,CAAE,QAAO;CAE1C,MAAM,WAAW,QAAQ,OAAO,SAAS,IAAI,WAAW;AACxD,KAAI,CAAC,YAAY,CAAC,WAAW,SAAS,EAAE;AACtC,UAAQ,OAAO,MACb,yBAAyB,YAAY,GAAG,0CACzC;AACD,SAAO;;AAIT,KAAI,CAAC,WADc,iBAAiB,MAAM,SAChB,CAAC,EAAE;AAC3B,UAAQ,OAAO,MACb,WAAW,SAAS,gCAAgC,SAAS,0CAC7B,SAAS,aAC1C;AACD,SAAO;;CAGT,MAAM,WAAW,QAAQ,OAAO,OAAO;AACvC,KAAI,CAAC,UAAU;AACb,UAAQ,OAAO,MACb,+BAA+B,WAAW,KAAK,IAAI,CAAC,kBACrD;AACD,SAAO;;CAET,MAAM,OAAO,cAAc,SAAS;AACpC,KAAI,CAAC,MAAM;AACT,UAAQ,OAAO,MACb,kCAAkC,WAAW,KAAK,KAAK,CAAC,KACzD;AACD,SAAO;;CAGT,MAAM,MAAM,gBAAgB,MAAM,SAAS;CAC3C,MAAM,WAAW,KAAK,KAAK,GAAG,KAAK,MAAM;AACzC,KAAI,WAAW,SAAS,IAAI,CAAC,OAAO;AAClC,UAAQ,OAAO,MACb,yBAAyB,SAAS,8BACnC;AACD,SAAO;;AAGT,WAAU,IAAI;AAGd,iBAAgB,UAAU,UADT,aADI,KAAK,cAAc,EAAE,QAAQ,GAAG,KAAK,MAChB,EAAE,QACA,EAAE,EAAE,WAAW,UAAU,CAAC,EAAE,EACtE,WAAW,OACZ,CAAC;AAEF,SAAQ,OAAO,MAAM,cAAc,KAAK,aAAa,SAAS,MAAM;AACpE,SAAQ,OAAO,MAAM,oBAAoB,SAAS,GAAG,KAAK,QAAQ;AAClE,SAAQ,OAAO,MACb;EACE;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK,CACb;AAED,QAAO;;AAGT,SAAS,cAAc,OAAgC;AACrD,QAAQ,WAAiC,SAAS,MAAM,GACnD,QACD"}

package/dist/src/commands/guide.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"guide.js","names":[],"sources":["../../../src/commands/guide.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { packageRoot } from \"../lib/paths.js\";\n\ninterface GuideTopic {\n file: string;\n description: string;\n}\n\nconst TOPICS: Record<string, GuideTopic> = {\n overview: {\n file: \"overview.md\",\n description: \"canonical agent workflow, commands, files, evals, and views\",\n },\n evals: {\n file: \"evals.md\",\n description: \"eval script invocation, NDJSON events, and baseline runs\",\n },\n views: {\n file: \"views.md\",\n description: \"custom trace and dataset item view paths, props, and actions\",\n },\n \"claude-command\": {\n file: \"claude-command.md\",\n description: \"Claude Code slash-command instructions\",\n },\n \"variant-builder\": {\n file: \"variant-builder.md\",\n description: \"single-variant worktree agent instructions\",\n },\n};\n\nexport function runGuide(argv: string[]): number {\n const [rawTopic] = argv.filter((arg) => !arg.startsWith(\"-\"));\n const topic = rawTopic ?? \"overview\";\n\n if (topic === \"topics\" || topic === \"list\") {\n process.stdout.write(renderTopicList());\n return 0;\n }\n\n if (topic === \"all\") {\n process.stdout.write(\n Object.keys(TOPICS)\n .map((name) => readGuide(name))\n .join(\"\\n\\n---\\n\\n\"),\n );\n process.stdout.write(\"\\n\");\n return 0;\n }\n\n if (!isGuideTopic(topic)) {\n process.stderr.write(\n `unknown guide topic: ${topic}\\n\\n${renderTopicList()}`,\n );\n return 1;\n }\n\n process.stdout.write(readGuide(topic));\n process.stdout.write(\"\\n\");\n return 0;\n}\n\nfunction readGuide(topic: string): string {\n const guide = TOPICS[topic];\n return readFileSync(join(packageRoot(), \"agent\", guide.file), \"utf-8\");\n}\n\nfunction isGuideTopic(topic: string): boolean {\n return Object.prototype.hasOwnProperty.call(TOPICS, topic);\n}\n\nfunction renderTopicList(): string {\n return [\n \"kaizen guide topics:\",\n \"\",\n ...Object.entries(TOPICS).map(\n ([name, guide]) => ` ${name.padEnd(15)} ${guide.description}`,\n ),\n \" all print every guide topic\",\n \"\",\n ].join(\"\\n\");\n}\n"],"mappings":";;;;AASA,MAAM,SAAqC;CACzC,UAAU;EACR,MAAM;EACN,aAAa;EACd;CACD,OAAO;EACL,MAAM;EACN,aAAa;EACd;CACD,OAAO;EACL,MAAM;EACN,aAAa;EACd;CACD,kBAAkB;EAChB,MAAM;EACN,aAAa;EACd;CACD,mBAAmB;EACjB,MAAM;EACN,aAAa;EACd;CACF;AAED,SAAgB,SAAS,MAAwB;CAC/C,MAAM,CAAC,YAAY,KAAK,QAAQ,QAAQ,CAAC,IAAI,WAAW,IAAI,CAAC;CAC7D,MAAM,QAAQ,YAAY;AAE1B,KAAI,UAAU,YAAY,UAAU,QAAQ;AAC1C,UAAQ,OAAO,MAAM,iBAAiB,CAAC;AACvC,SAAO;;AAGT,KAAI,UAAU,OAAO;AACnB,UAAQ,OAAO,MACb,OAAO,KAAK,OAAO,CAChB,KAAK,SAAS,UAAU,KAAK,CAAC,CAC9B,KAAK,cAAc,CACvB;AACD,UAAQ,OAAO,MAAM,KAAK;AAC1B,SAAO;;AAGT,KAAI,CAAC,aAAa,MAAM,EAAE;AACxB,UAAQ,OAAO,MACb,wBAAwB,MAAM,MAAM,iBAAiB,GACtD;AACD,SAAO;;AAGT,SAAQ,OAAO,MAAM,UAAU,MAAM,CAAC;AACtC,SAAQ,OAAO,MAAM,KAAK;AAC1B,QAAO;;AAGT,SAAS,UAAU,OAAuB;CACxC,MAAM,QAAQ,OAAO;AACrB,QAAO,aAAa,KAAK,aAAa,EAAE,SAAS,MAAM,KAAK,EAAE,QAAQ;;AAGxE,SAAS,aAAa,OAAwB;AAC5C,QAAO,OAAO,UAAU,eAAe,KAAK,QAAQ,MAAM;;AAG5D,SAAS,kBAA0B;AACjC,QAAO;EACL;EACA;EACA,GAAG,OAAO,QAAQ,OAAO,CAAC,KACvB,CAAC,MAAM,WAAW,KAAK,KAAK,OAAO,GAAG,CAAC,GAAG,MAAM,cAClD;EACD;EACA;EACD,CAAC,KAAK,KAAK"}