@okfit/cli 0.6.12 → 0.8.0

package/render/human.js

@@ -1,31 +1,20 @@
 import { sort } from "@okfit/engine";
 
 //#region src/render/human.ts
-/** The ANSI escape character, built from its code point so the source never carries a raw control byte. */
-const ESC = String.fromCharCode(27);
-/** ANSI SGR codes for the severity word only (K-19); reset after, never applied elsewhere. */
-const SEVERITY_COLOR = {
-	error: `${ESC}[31m`,
-	warning: `${ESC}[33m`,
-	info: `${ESC}[36m`
-};
-const RESET = `${ESC}[0m`;
-const colorize = (severity, color) => color ? `${SEVERITY_COLOR[severity]}${severity}${RESET}` : severity;
 /**
 * K-16. With a range:
 * `<file>:<range.line + 1>:<range.character + 1> <severity> <code> <message>`.
 * Without one: `<file> <severity> <code> <message>`. `file: ""` renders as
 * the literal `(bundle)`. Core's range is zero-based (D-32,
 * `CORE/Diagnostic.ts:49-57`); the `+ 1`s here are the only place it becomes
-* one-based. Colour, when `color` is `true`, wraps ONLY the severity word
+* one-based. Colour, when a `paint` is given, wraps ONLY the severity word
 * (K-19) — never the code, the path, or the message.
 *
 * @public
 */
 const line = (diagnostic, options) => {
-	const color = options?.color ?? false;
 	const file = diagnostic.file === "" ? "(bundle)" : diagnostic.file;
-	const severity = colorize(diagnostic.severity, color);
+	const severity = options?.paint === void 0 ? diagnostic.severity : options.paint(diagnostic.severity, diagnostic.severity);
 	return `${diagnostic.range === void 0 ? file : `${file}:${diagnostic.range.line + 1}:${diagnostic.range.character + 1}`} ${severity} ${diagnostic.code} ${diagnostic.message}`;
 };
 /**

package/render/query.js

@@ -0,0 +1,58 @@
+import { Schema } from "effect";
+import { Timestamp } from "@okfit/core";
+
+//#region src/render/query.ts
+/**
+* One line per concept: `<id>  <status>  <type>  <title>`. `items` arrive
+* already sorted by id (`ConceptQuery.list`), so this never re-sorts.
+*
+* @public
+*/
+const humanQueryList = (items) => items.map((item) => `${item.id}  ${item.status}  ${item.type}  ${item.title}`);
+/**
+* `<N> concepts in <root>` (`1 concept` for one) — the one-line stderr summary.
+*
+* @public
+*/
+const queryListSummary = (total, root) => `${total} ${total === 1 ? "concept" : "concepts"} in ${root}`;
+/**
+* The bare id, then `key: value` lines, one `verified:` line per attestation,
+* then the outgoing links.
+*
+* @public
+*/
+const humanQueryGet = (input) => {
+	const { summary } = input;
+	return [
+		summary.id,
+		`type: ${summary.type}`,
+		`title: ${summary.title}`,
+		`status: ${summary.status}`,
+		`tags: ${summary.tags.length === 0 ? "(none)" : summary.tags.join(", ")}`,
+		`path: ${summary.path}`,
+		...input.verified.map((entry) => `verified: ${entry.by} at ${Schema.encodeSync(Timestamp)(entry.at)}`),
+		"links:",
+		...input.links.length === 0 ? ["  (none)"] : input.links.map((link) => {
+			const detail = [
+				link.kind,
+				link.source,
+				...link.field === void 0 ? [] : [link.field]
+			].join(", ");
+			return `  -> ${link.to} (${detail})`;
+		})
+	];
+};
+/**
+* `outgoing:` then `incoming:`, each a list of `->`/`<-` lines or `(none)`.
+*
+* @public
+*/
+const humanQueryNeighbors = (input) => [
+	"outgoing:",
+	...input.outgoing.length === 0 ? ["  (none)"] : input.outgoing.map((n) => `  -> ${n.id} (${n.kind})`),
+	"incoming:",
+	...input.incoming.length === 0 ? ["  (none)"] : input.incoming.map((n) => `  <- ${n.id} (${n.kind})`)
+];
+
+//#endregion
+export { humanQueryGet, humanQueryList, humanQueryNeighbors, queryListSummary };

package/render/verify.js

@@ -19,11 +19,15 @@ const indentFragment = (fragment) => {
 *
 * @public
 */
-const humanVerify = (input) => [
-	...input.priorAt.map((at) => `already verified by ${input.by} at ${at}; appending`),
-	input.dryRun ? `would verify ${input.id} by ${input.by} at ${input.at} (dry run, nothing written)` : `verified ${input.id} by ${input.by} at ${input.at}`,
-	...input.dryRun ? ["would write:", ...indentFragment(input.fragment)] : []
-];
+const humanVerify = (input) => {
+	const statusSuffix = input.status === null ? "" : input.status.from === input.status.to ? `; status already ${input.status.to}` : `; status ${input.status.from ?? "(absent)"} -> ${input.status.to}`;
+	return [
+		...input.priorAt.map((at) => `already verified by ${input.by} at ${at}; appending`),
+		input.dryRun ? `would verify ${input.id} by ${input.by} at ${input.at}${statusSuffix} (dry run, nothing written)` : `verified ${input.id} by ${input.by} at ${input.at}${statusSuffix}`,
+		...input.dryRun ? ["would write:", ...indentFragment(input.fragment)] : [],
+		...input.dryRun && input.statusFragment !== null ? ["would set status:", ...indentFragment(input.statusFragment)] : []
+	];
+};
 /**
 * V-11-at-batch-scale (#138): one line per skipped candidate, then one line
 * (or, under `--dry-run`, three) per verified concept, then a trailing tally.
@@ -31,7 +35,7 @@ const humanVerify = (input) => [
 * @public
 */
 const humanVerifyBatch = (input) => [
-	...input.skipped.map((entry) => entry.reason === "draft" ? `skipped ${entry.id}: draft` : `skipped ${entry.id}: already verified by ${input.by}`),
+	...input.skipped.map((entry) => entry.reason === "already-verified" ? `skipped ${entry.id}: already verified by ${input.by}` : `skipped ${entry.id}: ${entry.reason}`),
 	...input.verified.flatMap((entry) => input.dryRun ? [
 		`would verify ${entry.id} by ${input.by} at ${input.at}`,
 		"would write:",

package/version.js

@@ -11,7 +11,7 @@
 *
 * @public
 */
-const CLI_VERSION = "0.6.12";
+const CLI_VERSION = "0.8.0";
 
 //#endregion
 export { CLI_VERSION };

package/internal/exit.js

@@ -1,14 +0,0 @@
-//#region src/internal/exit.ts
-/**
-* K-7: exits `1` and `2` are a SUCCESSFUL run that found diagnostics, never
-* an Effect failure. The handler writes the code here and returns `void`.
-* The only writer of `process.exitCode` in this package.
-*
-* @public
-*/
-const setExitCode = (code) => {
-	process.exitCode = code;
-};
-
-//#endregion
-export { setExitCode };