@mnmal-ai/substrate-tui 1.0.0-alpha.13 → 1.0.0-alpha.14

package/README.md

@@ -9,6 +9,7 @@ Without an admin identity it is read-only.
 - Free text is a natural-language question, answered by `substrate-nl` (streamed). Tab completes types, fields and values.
 - `/ns <namespace>` switches the namespace that questions, completion and the status row use. The schema browser always lists every namespace.
 - `/frame` shows the Substrate frame behind the last answer.
+- `/asof <date-time>` reads relative phrases ("yesterday", "past 2 days") as of that moment, for the questions that follow. It must be ISO-8601 with an offset, e.g. `2026-10-24T23:59:59-05:00`. `/asof off` returns to the server clock, and `/asof` alone shows which is in use. `/frame` shows the clock the server read the last question against.
 - `/schema [namespace] [type]` opens the schema browser: namespaces, then types, then fields.
 - `/dash` shows service, traffic and engine metrics, live while open.
 - `/doctor` runs live checks against this deployment.

package/dist/{app-xXFNoDVu.js → app-9LqYVY4G.js}

@@ -252,6 +252,44 @@ function outcomeChips(o) {
 		}
 	];
 }
+/** The first label-like field a row has: the usual handles, then any `…Name` / `…Title` string. */
+const LABELS = [
+	"title",
+	"synopsis",
+	"name",
+	"topic",
+	"subject"
+];
+function labelField(r) {
+	const own = LABELS.find((k) => typeof r[k] === "string" && r[k] !== "");
+	if (own !== void 0) return own;
+	return Object.keys(r).find((k) => /(Name|Title)$/.test(k) && typeof r[k] === "string" && r[k] !== "");
+}
+/** Fields the question filtered or ordered on, in the order they appear in the frame. */
+function askedFields(frame) {
+	const params = Object.values(frame)[0]?.params ?? {};
+	const out = [];
+	const add = (k) => {
+		if (!out.includes(k)) out.push(k);
+	};
+	const walk = (w) => {
+		if (w === null || typeof w !== "object") return;
+		for (const [k, v] of Object.entries(w)) if (k === "AND" || k === "OR" || k === "NOT") for (const c of Array.isArray(v) ? v : [v]) walk(c);
+		else if (!k.startsWith("_")) add(k);
+	};
+	for (const o of params.orderBy ?? []) Object.keys(o).forEach(add);
+	walk(params.where);
+	return out;
+}
+const SKIP = /* @__PURE__ */ new Set(["id", "shortId"]);
+/** `field=value` for a row's scalar fields: the asked-about ones first, then the rest. */
+function details(r, asked, label) {
+	const scalar = (k) => {
+		const v = r[k];
+		return v !== null && v !== void 0 && v !== "" && typeof v !== "object";
+	};
+	return [...asked.filter((k) => k in r), ...Object.keys(r).filter((k) => !asked.includes(k))].filter((k) => !SKIP.has(k) && k !== label && scalar(k)).map((k) => `${sanitise(k)}=${str(r[k])}`).join("  ");
+}
 const COLS = {
 	id: 6,
 	status: 10,
@@ -289,6 +327,33 @@ const rows = ({ data, theme, size }) => {
 		color: theme.color.dim,
 		children: "no rows"
 	});
+	if (!list.some((r) => "status" in r || "project" in r)) {
+		const asked = askedFields(o.frame);
+		const labelCols = Math.min(40, Math.max(COLS.minTitle, Math.floor(size.columns / 3)));
+		const detailCols = Math.max(COLS.minTitle, size.columns - (COLS.id + labelCols + 4));
+		return /* @__PURE__ */ jsxs(Box, {
+			flexDirection: "column",
+			children: [list.map((r, i) => {
+				const label = labelField(r);
+				return /* @__PURE__ */ jsxs(Text, { children: [
+					/* @__PURE__ */ jsx(Text, {
+						color: theme.color.dim,
+						children: padCells(str(r.shortId ?? r.id), COLS.id, true)
+					}),
+					"  ",
+					/* @__PURE__ */ jsx(Text, {
+						color: theme.color.text,
+						children: padCells(label !== void 0 ? str(r[label]) : "", labelCols)
+					}),
+					"  ",
+					/* @__PURE__ */ jsx(Text, {
+						color: theme.color.dimMid,
+						children: padCells(details(r, asked, label), detailCols)
+					})
+				] }, i);
+			}), lost]
+		});
+	}
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		children: [
@@ -443,10 +508,14 @@ function explain(err, endpoint) {
 	if (e.status === 401 || e.status === 403) return `not authorised (${e.status}) — check SUBSTRATE_AGENT_KEY_ID / SUBSTRATE_AGENT_KEY_PATH`;
 	return e.message ?? String(err);
 }
+/** What the server accepts for `asOf`: a date-time with an explicit offset. */
+const ISO_WITH_OFFSET = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})$/;
 function askModule(deps) {
 	let namespace = deps.namespace;
 	let pack = null;
 	let forceType;
+	/** The clock relative phrases are read against; undefined = the server's. */
+	let asOf;
 	let last = { lines: ["no question asked yet"] };
 	let lastPackNote = "";
 	const loadPack = (ctx) => {
@@ -474,23 +543,41 @@ function askModule(deps) {
 			loadPack(ctx);
 			ctx.emit("substrate/ns", { namespace });
 		},
-		commands: [{
-			name: "ns",
-			summary: "switch the namespace questions go to",
-			args: [{ name: "namespace" }],
-			run([ns], ctx) {
-				if (ns === void 0 || ns === "") return ctx.print(`namespace: ${namespace}`);
-				namespace = ns;
-				loadPack(ctx);
-				ctx.emit("substrate/ns", { namespace });
-				ctx.print(`namespace → ${namespace}`);
+		commands: [
+			{
+				name: "ns",
+				summary: "switch the namespace questions go to",
+				args: [{ name: "namespace" }],
+				run([ns], ctx) {
+					if (ns === void 0 || ns === "") return ctx.print(`namespace: ${namespace}`);
+					namespace = ns;
+					loadPack(ctx);
+					ctx.emit("substrate/ns", { namespace });
+					ctx.print(`namespace → ${namespace}`);
+				}
+			},
+			{
+				name: "asof",
+				summary: "read \"yesterday\", \"past 2 days\" … as of a date-time (ISO-8601 with an offset); off for the server clock",
+				args: [{ name: "datetime|off" }],
+				run([v], ctx) {
+					if (v === void 0 || v === "") return ctx.print(`asOf: ${asOf ?? "server clock"}`);
+					if (v === "off") {
+						asOf = void 0;
+						return ctx.print("asOf → server clock");
+					}
+					if (!ISO_WITH_OFFSET.test(v) || Number.isNaN(Date.parse(v))) return ctx.print("asOf needs an ISO-8601 date-time with an offset, e.g. 2026-10-24T23:59:59-05:00");
+					asOf = v;
+					ctx.print(`asOf → ${asOf}`);
+				}
+			},
+			{
+				name: "frame",
+				summary: "show the last answer's query frame, evidence and judge trail",
+				args: [],
+				run: (_a, ctx) => ctx.open("frame", last)
 			}
-		}, {
-			name: "frame",
-			summary: "show the last answer's query frame, evidence and judge trail",
-			args: [],
-			run: (_a, ctx) => ctx.open("frame", last)
-		}],
+		],
 		panels: {
 			clarify: {
 				view: ({ state }) => [
@@ -525,11 +612,13 @@ function askModule(deps) {
 						namespace,
 						question: text,
 						project: deps.project,
+						...asOf !== void 0 ? { asOf } : {},
 						...type !== void 0 ? { type } : {}
 					}, { signal })) switch (ev.event) {
 						case "parsed": {
 							const key = ev.data.frame !== void 0 ? Object.keys(ev.data.frame)[0] : void 0;
 							lines.push(`parse: ${ev.data.status}${ev.data.reason !== void 0 ? ` — ${ev.data.reason}` : ""}`);
+							if (ev.data.asOf !== void 0) lines.push(`asOf: ${ev.data.asOf}`);
 							if (ev.data.frame !== void 0) lines.push(JSON.stringify(ev.data.frame, null, 2));
 							for (const e of ev.data.evidence) lines.push(`  ${e.span} → ${e.role} (${e.detail})`);
 							yield {

package/dist/bin/substrate-tui.js

@@ -51,7 +51,7 @@ async function main() {
 	}
 	Object.assign(process.env, colorDepthEnv(process.env));
 	const [{ createTui }, { makeDeps }, { prepareTerminal }, { terminalOptions }] = await Promise.all([
-		import("../app-xXFNoDVu.js"),
+		import("../app-9LqYVY4G.js"),
 		import("../deps-WzqsHHiC.js"),
 		import("@mnmal-ai/surface-core/pure"),
 		import("../terminal-CVX2CKWu.js")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnmal-ai/substrate-tui",
-  "version": "1.0.0-alpha.13",
+  "version": "1.0.0-alpha.14",
   "description": "Terminal UI for Substrate: ask in natural language, browse the schema, see the service status.",
   "license": "Apache-2.0",
   "repository": {
@@ -20,8 +20,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@mnmal-ai/substrate": "1.0.0-alpha.13",
-    "@mnmal-ai/substrate-nl": "1.0.0-alpha.13",
+    "@mnmal-ai/substrate": "1.0.0-alpha.14",
+    "@mnmal-ai/substrate-nl": "1.0.0-alpha.14",
     "@mnmal-ai/surface-core": "0.15.0",
     "@mnmal-ai/surface-kit": "0.15.0",
     "@mnmal-ai/surface-theme": "0.15.0",
@@ -30,7 +30,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "2.6.4",
-    "@mnmal-ai/substrate-config": "1.0.0-alpha.13",
+    "@mnmal-ai/substrate-config": "1.0.0-alpha.14",
     "@types/node": "^26.6.4",
     "@types/react": "^19.2.0",
     "ink-testing-library": "^4.0.0",