@krapht/ork 1.0.0-alpha.1 → 1.0.0-alpha.11

package/dist/context-6x3kXREO.mjs

@@ -1,274 +0,0 @@
-import { C as workflowTextHash, Ct as walkChecks, On as LESSON_CAP_TOKENS, S as readProjectTriggers, St as checkWorkflowText, Tn as workflowDirOf, bn as placeFiles, lt as explainSession, wt as walkSummary, xn as placeFor } from "./src-hrj2h0IZ.mjs";
-import { a as write, i as style, r as plain } from "./output-TV_j7Ni0.mjs";
-import { c as registeredProjects, i as refusedBuiltin, o as workflowArg, r as findWorkflowFiles, s as projectAt } from "./workflows-vsEohqa7.mjs";
-import path from "node:path";
-import { readFileSync } from "node:fs";
-import { defineCommand } from "citty";
-// src/commands/walk-report.ts
-/**
-* @file How `ork validate` shows a walk (RFC-009): one line on what it tried,
-*   and with `--paths`, each way a run can end. A gate's answer that ends the
-*   run shows here as an ending, not as a problem.
-*/
-const walkLine = (walk) => walk === void 0 ? [] : [style("dim", walkSummary(walk))];
-const endingLine = ({ status, notRun, paths }) => {
-	const ways = `${String(paths)} ${paths === 1 ? "way" : "ways"}`;
-	const word = status === "succeeded" ? style("green", status) : style("red", status);
-	const rest = notRun.length === 0 ? "every node ran" : `didn't run: ${notRun.map((id) => plain(id)).join(", ")}`;
-	return `  ${word} ${style("dim", `(${ways})`)} ${rest}`;
-};
-const endingLines = (ending) => [endingLine(ending), ...ending.choices.map((choice) => style("dim", `      ${plain(choice)}`))];
-/** Each ending, the ones that succeeded first, with one way to get there. */
-const pathLines = (walk) => {
-	const endings = walk?.endings ?? [];
-	return [...endings.filter(({ status }) => status === "succeeded"), ...endings.filter(({ status }) => status !== "succeeded")].flatMap((ending) => endingLines(ending));
-};
-// src/commands/validate.ts
-/**
-* @file `ork validate`: loads, parses and compiles workflow files with the
-*   project's rules (`.ork/project.yaml`) and the agents they name, checks
-*   their skill and context references, and reports diagnostics compiler-style,
-*   with file, line and column. `loadWorkflow` is shared with `ork run`.
-*/
-const hasErrors = (diagnostics) => diagnostics.some((d) => d.severity === "error");
-/**
-* Parses and compiles one workflow file, with the agents the user and its
-* project offer. `home` is the user's `~` (tests pass a folder); `registered`
-* the projects a caller's store has, else those of the store in `home`.
-*/
-const loadWorkflow = (file, cwd, home, registered = registeredProjects(home)) => {
-	const absolute = path.resolve(cwd, file);
-	const place = placeFor(path.dirname(absolute), registered);
-	const where = {
-		place,
-		workflowDir: workflowDirOf(place, absolute)
-	};
-	let text;
-	try {
-		text = readFileSync(path.resolve(cwd, file), "utf8");
-	} catch (error) {
-		return {
-			report: {
-				file,
-				diagnostics: [{
-					severity: "error",
-					code: "file.read",
-					message: error instanceof Error && "code" in error && error.code === "ENOENT" ? "file not found" : "cannot read file",
-					path: []
-				}]
-			},
-			workflow: null,
-			graph: null,
-			...where
-		};
-	}
-	const { diagnostics, workflow, graph, summary, locate } = checkWorkflowText(text, {
-		...where,
-		registered,
-		home
-	});
-	return {
-		report: {
-			file,
-			diagnostics,
-			...summary === void 0 ? {} : { summary }
-		},
-		workflow,
-		graph,
-		textHash: workflowTextHash(text),
-		...locate === void 0 ? {} : { locate },
-		...where
-	};
-};
-const validateFile = (file, cwd) => loadWorkflow(file, cwd).report;
-/**
-* Walks what loaded, with its findings on its report. `ork validate` and `ork
-* run` do this; the rest of what loads a workflow doesn't pay for a walk.
-*/
-const walkLoaded = async (loaded) => {
-	const { diagnostics, walk } = await walkChecks({
-		diagnostics: loaded.report.diagnostics,
-		graph: loaded.graph,
-		...loaded.locate === void 0 ? {} : { locate: loaded.locate }
-	});
-	return {
-		...loaded,
-		report: {
-			...loaded.report,
-			diagnostics,
-			...walk === void 0 ? {} : { walk }
-		}
-	};
-};
-const plural = (count, word) => `${count} ${word}${count === 1 ? "" : "s"}`;
-const diagnosticLine = (file, d) => {
-	const where = d.line === void 0 ? file : `${file}:${d.line}:${d.column ?? 1}`;
-	const severity = d.severity === "error" ? style(["red", "bold"], "error") : style(["yellow", "bold"], "warning");
-	return `${style("dim", where)} ${severity} ${d.message} ${style("dim", `(${d.code})`)}`;
-};
-/** The warnings alone, for a run that goes ahead despite them. */
-const warningLines = (report) => report.diagnostics.filter((d) => d.severity === "warning").map((d) => diagnosticLine(report.file, d));
-/** Human-readable report, one line per diagnostic, compiler style. */
-const formatReport = (report) => {
-	const lines = report.diagnostics.map((d) => diagnosticLine(report.file, d));
-	const errors = report.diagnostics.filter((d) => d.severity === "error").length;
-	const warnings = report.diagnostics.length - errors;
-	if (report.summary === void 0 && errors === 0) lines.push(`${style("green", "✓")} ${report.file}${warnings === 0 ? "" : style("dim", ` (${plural(warnings, "warning")})`)}`);
-	else if (report.summary !== void 0 && errors === 0) {
-		const { nodes, edges, entries } = report.summary;
-		const extra = warnings > 0 ? `, ${plural(warnings, "warning")}` : "";
-		lines.push(`${style("green", "✓")} ${report.file} ${style("dim", `(${plural(nodes, "node")}, ${plural(edges, "edge")}, starts at ${entries.join(", ")}${extra})`)}`);
-	} else lines.push(`${style("red", "✗")} ${report.file} ${style("dim", `(${plural(errors, "error")}, ${plural(warnings, "warning")})`)}`);
-	return [...lines, ...walkLine(report.walk)];
-};
-const validate = defineCommand({
-	meta: {
-		name: "validate",
-		description: "Check workflow files: schema, ownership tree, edges, loops and references, and walk every way through them"
-	},
-	args: {
-		files: {
-			type: "positional",
-			description: "Workflow files or names in .ork/workflows/ (default: every workflow there, and the project's triggers)",
-			required: false
-		},
-		json: {
-			type: "boolean",
-			description: "Print the reports as JSON",
-			default: false
-		},
-		paths: {
-			type: "boolean",
-			description: "List each way a run can end, and the choices that lead there",
-			default: false
-		}
-	},
-	run: async ({ args }) => {
-		const cwd = process.cwd();
-		if (refusedBuiltin(args._, cwd)) return;
-		const files = findWorkflowFiles(args._, cwd, placeFiles(projectAt(cwd)).workflows);
-		if (files.length === 0) {
-			write("No workflow files found. Run `ork init`, or pass a path.");
-			process.exitCode = 1;
-			return;
-		}
-		const place = projectAt(cwd);
-		const triggers = args._.length === 0 ? readProjectTriggers(place, void 0, registeredProjects()) : void 0;
-		const walked = [];
-		for (const file of files) {
-			const { report } = await walkLoaded(loadWorkflow(file, cwd));
-			walked.push(report);
-		}
-		const reports = [...walked, ...triggers?.present === true ? [{
-			file: path.relative(cwd, triggers.file),
-			diagnostics: [...triggers.diagnostics, ...triggers.triggers.flatMap((item) => item.diagnostics)]
-		}] : []];
-		if (args.json) write(JSON.stringify(reports, void 0, 2));
-		else for (const report of reports) {
-			for (const line of formatReport(report)) write(line);
-			if (args.paths) for (const line of pathLines(report.walk)) write(line);
-		}
-		if (reports.some((r) => hasErrors(r.diagnostics))) process.exitCode = 1;
-	}
-});
-// src/commands/context.ts
-/**
-* @file `ork context explain <wf> <node>`: what one node's session would load,
-*   layer by layer, as core's `explainSession` plans it without writing
-*   anything (one of Ork's own `ork:` workflows is written into the project's
-*   run folder first, as `ork run` does): its project instructions, every skill
-*   with the layer it came from and whether it is live, shadowed or switched
-*   off, its context files, its practices, and estimated tokens.
-*/
-/** Loads a workflow file and plans one node's session in it, in place. */
-const explainNode = (file, nodeId, cwd, home) => {
-	const { report, workflow, graph, place, workflowDir } = loadWorkflow(file, cwd, home);
-	if (workflow === null) return {
-		ok: false,
-		lines: formatReport(report)
-	};
-	const result = explainSession(workflow, graph, nodeId, {
-		root: place.root,
-		orkDir: place.dir,
-		workflowDir,
-		...home === void 0 ? {} : { home }
-	});
-	return result.ok ? result : {
-		ok: false,
-		lines: [result.error]
-	};
-};
-const approx = (count) => style("dim", `≈${count.toLocaleString("en")} tokens`);
-const formatExplanation = (e) => {
-	const width = Math.max(8, ...e.skills.map((s) => s.name.length));
-	const sourceWidth = Math.max(0, ...e.skills.map((s) => s.source.length));
-	const lines = [
-		`${style("bold", e.node)} ${style("dim", `(${e.type}) in ${e.workflow}`)}${e.template === void 0 ? "" : style("dim", `, planned as ${e.template}, the node it was spawned from`)}`,
-		"",
-		...e.agent === void 0 ? [] : [`${style("bold", "Agent")}  ${e.agent.name} ${style("dim", `(${e.agent.where})`)}  ${approx(e.agent.tokens)}`],
-		`${style("bold", "Instructions")}  ${e.instructions}`,
-		"",
-		style("bold", "Skills")
-	];
-	if (e.skills.length === 0) lines.push(style("dim", "  none"));
-	for (const s of e.skills) {
-		const mark = s.state === "live" ? style("green", "✓") : style("dim", "−");
-		const state = s.why === void 0 ? approx(s.tokens).replace("tokens", "tokens when used") : style("yellow", `off: ${s.why}`);
-		lines.push(`  ${mark} ${s.name.padEnd(width)}  ${s.layer.padEnd(8)}  ${style("dim", s.source.padEnd(sourceWidth))}  ${state}`);
-	}
-	lines.push("", style("bold", "Context files"));
-	if (e.files.length === 0) lines.push(style("dim", "  none"));
-	for (const f of e.files) {
-		const cut = f.cutFrom === void 0 ? "" : `  ${style("yellow", `cut at the ${LESSON_CAP_TOKENS.toLocaleString("en")}-token cap; the whole file is ${approx(f.cutFrom)}`)}`;
-		lines.push(`  ${f.layer.padEnd(8)}  ${f.name}  ${approx(f.tokens)}${cut}`);
-	}
-	lines.push("", style("bold", "Practices"));
-	for (const p of e.practices) lines.push(`  ${p.name.padEnd(8)}  ${approx(p.tokens)}`);
-	for (const name of e.skippedPractices) lines.push(`  ${name.padEnd(8)}  ${style("dim", "the project's own skill wins")}`);
-	if (e.practices.length === 0 && e.skippedPractices.length === 0) lines.push(style("dim", "  off"));
-	lines.push("", `Appended to Claude Code's system prompt: ${approx(e.appendedTokens)}`);
-	return lines;
-};
-const explain = defineCommand({
-	meta: {
-		name: "explain",
-		description: "Show what one node's session loads, layer by layer"
-	},
-	args: {
-		workflow: {
-			type: "positional",
-			description: "A workflow file, the name of one in the project's workflows (.ork/workflows/), or one of Ork's own (ork:feedback-apply)",
-			required: true
-		},
-		node: {
-			type: "positional",
-			description: "Node id",
-			required: true
-		},
-		json: {
-			type: "boolean",
-			description: "Print JSON",
-			default: false
-		}
-	},
-	run: ({ args }) => {
-		const cwd = process.cwd();
-		if (refusedBuiltin([args.workflow], cwd)) return;
-		const result = explainNode(workflowArg(args.workflow, cwd).file, args.node, cwd);
-		if (!result.ok) {
-			for (const line of result.lines) process.stderr.write(`${line}\n`);
-			process.exitCode = 1;
-			return;
-		}
-		if (args.json) write(JSON.stringify(result.explanation, void 0, 2));
-		else for (const line of formatExplanation(result.explanation)) write(line);
-	}
-});
-const context = defineCommand({
-	meta: {
-		name: "context",
-		description: "Inspect the context Ork compiles for each node"
-	},
-	subCommands: { explain }
-});
-export { validate as a, warningLines as c, loadWorkflow as i, explainNode as n, validateFile as o, formatReport as r, walkLoaded as s, context as t };