@asterxsk/kiln 0.3.0 → 0.4.2

package/agent/extensions/todo/package.json

@@ -1,67 +1,67 @@
-{
-	"name": "@juicesharp/rpiv-todo",
-	"version": "1.20.0",
-	"description": "Pi extension. A todo list for the model, rendered as a live overlay that survives /reload and conversation compaction.",
-	"keywords": [
-		"pi-package",
-		"pi-extension",
-		"rpiv",
-		"todo"
-	],
-	"type": "module",
-	"license": "MIT",
-	"author": "juicesharp",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/juicesharp/rpiv-mono.git",
-		"directory": "packages/rpiv-todo"
-	},
-	"homepage": "https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-todo#readme",
-	"bugs": {
-		"url": "https://github.com/juicesharp/rpiv-mono/issues"
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"scripts": {
-		"test": "vitest run"
-	},
-	"files": [
-		"config.ts",
-		"index.ts",
-		"locales/",
-		"todo.ts",
-		"todo-overlay.ts",
-		"LICENSE",
-		"README.md",
-		"state/invariants.ts",
-		"state/i18n-bridge.ts",
-		"state/replay.ts",
-		"state/selectors.ts",
-		"state/state-reducer.ts",
-		"state/state.ts",
-		"state/store.ts",
-		"state/task-graph.ts",
-		"tool/response-envelope.ts",
-		"tool/types.ts",
-		"view/format.ts"
-	],
-	"pi": {
-		"extensions": [
-			"./index.ts"
-		]
-	},
-	"peerDependencies": {
-		"@juicesharp/rpiv-i18n": "*",
-		"@earendil-works/pi-ai": "*",
-		"@earendil-works/pi-coding-agent": "*",
-		"@earendil-works/pi-tui": "*",
-		"typebox": "*"
-	},
-	"peerDependenciesMeta": {
-		"@juicesharp/rpiv-i18n": {
-			"optional": true
-		}
-	},
-	"dependencies": {}
-}
+{
+	"name": "@juicesharp/rpiv-todo",
+	"version": "1.20.0",
+	"description": "Pi extension. A todo list for the model, rendered as a live overlay that survives /reload and conversation compaction.",
+	"keywords": [
+		"pi-package",
+		"pi-extension",
+		"rpiv",
+		"todo"
+	],
+	"type": "module",
+	"license": "MIT",
+	"author": "juicesharp",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/juicesharp/rpiv-mono.git",
+		"directory": "packages/rpiv-todo"
+	},
+	"homepage": "https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-todo#readme",
+	"bugs": {
+		"url": "https://github.com/juicesharp/rpiv-mono/issues"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"test": "vitest run"
+	},
+	"files": [
+		"config.ts",
+		"index.ts",
+		"locales/",
+		"todo.ts",
+		"todo-overlay.ts",
+		"LICENSE",
+		"README.md",
+		"state/invariants.ts",
+		"state/i18n-bridge.ts",
+		"state/replay.ts",
+		"state/selectors.ts",
+		"state/state-reducer.ts",
+		"state/state.ts",
+		"state/store.ts",
+		"state/task-graph.ts",
+		"tool/response-envelope.ts",
+		"tool/types.ts",
+		"view/format.ts"
+	],
+	"pi": {
+		"extensions": [
+			"./index.ts"
+		]
+	},
+	"peerDependencies": {
+		"@juicesharp/rpiv-i18n": "*",
+		"@earendil-works/pi-ai": "*",
+		"@earendil-works/pi-coding-agent": "*",
+		"@earendil-works/pi-tui": "*",
+		"typebox": "*"
+	},
+	"peerDependenciesMeta": {
+		"@juicesharp/rpiv-i18n": {
+			"optional": true
+		}
+	},
+	"dependencies": {}
+}

package/agent/extensions/todo/state/i18n-bridge.ts

@@ -1,64 +1,64 @@
-/**
- * i18n bridge for rpiv-todo — single thin import surface so every call site
- * routes through one module. Backed by `@juicesharp/rpiv-i18n`'s SDK when
- * available; degrades to canonical-English fallbacks when not.
- *
- * - `t(key, fallback)` is `scope("@juicesharp/rpiv-todo")` if the SDK is
- *   installed (live `/languages` updates propagate). If the SDK is missing
- *   (standalone install without rpiv-i18n), `t` is an identity passthrough
- *   that returns the inline English fallback at every call site, so the
- *   extension stays online with English UI.
- * - `formatStatusLabel(status)` resolves a TaskStatus to its locale-aware
- *   label via the canonical `status.*` namespace, with the English literal
- *   as fallback so nothing renders blank if the namespace isn't registered.
- *   This is the SINGLE point of localization for status words — overlay,
- *   /todos header, /todos render-call all route through here.
- *
- * Strings are registered ONCE at extension load (see ../index.ts). Call sites
- * MUST use this module at render time — never bake the result into a top-level
- * `const X = formatStatusLabel(...)`.
- */
-
-import type { TaskStatus } from "../tool/types.js";
-
-export const I18N_NAMESPACE = "@juicesharp/rpiv-todo";
-
-type ScopeFn = (key: string, fallback: string) => string;
-type I18nSDK = { scope: (namespace: string) => ScopeFn };
-
-// Prefer the live SDK if installed: closures it returns track the active
-// locale, so /languages picker propagates to our render call sites. If the
-// SDK isn't installed (standalone install of this extension without
-// rpiv-i18n), the dynamic import fails, every t(key, fallback) returns the
-// canonical English literal, and the extension stays online.
-//
-// Top-level await is required so a synchronous `t(...)` call from any
-// downstream module sees the resolved scope; ESM module loading awaits this
-// before evaluating any importer.
-let scopeImpl: ScopeFn;
-try {
-	const sdk = (await import("@juicesharp/rpiv-i18n")) as I18nSDK;
-	scopeImpl = sdk.scope(I18N_NAMESPACE);
-} catch {
-	scopeImpl = (_key, fallback) => fallback;
-}
-
-export const t: ScopeFn = scopeImpl;
-
-const STATUS_LABEL_PENDING = "pending";
-const STATUS_LABEL_IN_PROGRESS = "in progress";
-const STATUS_LABEL_COMPLETED = "completed";
-const STATUS_LABEL_DELETED = "deleted";
-
-export function formatStatusLabel(status: TaskStatus): string {
-	switch (status) {
-		case "pending":
-			return t("status.pending", STATUS_LABEL_PENDING);
-		case "in_progress":
-			return t("status.in_progress", STATUS_LABEL_IN_PROGRESS);
-		case "completed":
-			return t("status.completed", STATUS_LABEL_COMPLETED);
-		case "deleted":
-			return t("status.deleted", STATUS_LABEL_DELETED);
-	}
-}
+/**
+ * i18n bridge for rpiv-todo — single thin import surface so every call site
+ * routes through one module. Backed by `@juicesharp/rpiv-i18n`'s SDK when
+ * available; degrades to canonical-English fallbacks when not.
+ *
+ * - `t(key, fallback)` is `scope("@juicesharp/rpiv-todo")` if the SDK is
+ *   installed (live `/languages` updates propagate). If the SDK is missing
+ *   (standalone install without rpiv-i18n), `t` is an identity passthrough
+ *   that returns the inline English fallback at every call site, so the
+ *   extension stays online with English UI.
+ * - `formatStatusLabel(status)` resolves a TaskStatus to its locale-aware
+ *   label via the canonical `status.*` namespace, with the English literal
+ *   as fallback so nothing renders blank if the namespace isn't registered.
+ *   This is the SINGLE point of localization for status words — overlay,
+ *   /todos header, /todos render-call all route through here.
+ *
+ * Strings are registered ONCE at extension load (see ../index.ts). Call sites
+ * MUST use this module at render time — never bake the result into a top-level
+ * `const X = formatStatusLabel(...)`.
+ */
+
+import type { TaskStatus } from "../tool/types.js";
+
+export const I18N_NAMESPACE = "@juicesharp/rpiv-todo";
+
+type ScopeFn = (key: string, fallback: string) => string;
+type I18nSDK = { scope: (namespace: string) => ScopeFn };
+
+// Prefer the live SDK if installed: closures it returns track the active
+// locale, so /languages picker propagates to our render call sites. If the
+// SDK isn't installed (standalone install of this extension without
+// rpiv-i18n), the dynamic import fails, every t(key, fallback) returns the
+// canonical English literal, and the extension stays online.
+//
+// Top-level await is required so a synchronous `t(...)` call from any
+// downstream module sees the resolved scope; ESM module loading awaits this
+// before evaluating any importer.
+let scopeImpl: ScopeFn;
+try {
+	const sdk = (await import("@juicesharp/rpiv-i18n")) as I18nSDK;
+	scopeImpl = sdk.scope(I18N_NAMESPACE);
+} catch {
+	scopeImpl = (_key, fallback) => fallback;
+}
+
+export const t: ScopeFn = scopeImpl;
+
+const STATUS_LABEL_PENDING = "pending";
+const STATUS_LABEL_IN_PROGRESS = "in progress";
+const STATUS_LABEL_COMPLETED = "completed";
+const STATUS_LABEL_DELETED = "deleted";
+
+export function formatStatusLabel(status: TaskStatus): string {
+	switch (status) {
+		case "pending":
+			return t("status.pending", STATUS_LABEL_PENDING);
+		case "in_progress":
+			return t("status.in_progress", STATUS_LABEL_IN_PROGRESS);
+		case "completed":
+			return t("status.completed", STATUS_LABEL_COMPLETED);
+		case "deleted":
+			return t("status.deleted", STATUS_LABEL_DELETED);
+	}
+}

package/agent/extensions/todo/state/invariants.ts

@@ -1,20 +1,20 @@
-import type { TaskStatus } from "../tool/types.js";
-
-/**
- * Allowed forward transitions per source status. `completed` is one-way to
- * `deleted` (never back to `in_progress`); `deleted` is terminal.
- *
- * Idempotent same→same is checked separately in `isTransitionValid` so this
- * table only enumerates actual transitions.
- */
-export const VALID_TRANSITIONS: Record<TaskStatus, ReadonlySet<TaskStatus>> = {
-	pending: new Set(["in_progress", "completed", "deleted"]),
-	in_progress: new Set(["pending", "completed", "deleted"]),
-	completed: new Set(["deleted"]),
-	deleted: new Set(),
-};
-
-export function isTransitionValid(from: TaskStatus, to: TaskStatus): boolean {
-	if (from === to) return true;
-	return VALID_TRANSITIONS[from].has(to);
-}
+import type { TaskStatus } from "../tool/types.js";
+
+/**
+ * Allowed forward transitions per source status. `completed` is one-way to
+ * `deleted` (never back to `in_progress`); `deleted` is terminal.
+ *
+ * Idempotent same→same is checked separately in `isTransitionValid` so this
+ * table only enumerates actual transitions.
+ */
+export const VALID_TRANSITIONS: Record<TaskStatus, ReadonlySet<TaskStatus>> = {
+	pending: new Set(["in_progress", "completed", "deleted"]),
+	in_progress: new Set(["pending", "completed", "deleted"]),
+	completed: new Set(["deleted"]),
+	deleted: new Set(),
+};
+
+export function isTransitionValid(from: TaskStatus, to: TaskStatus): boolean {
+	if (from === to) return true;
+	return VALID_TRANSITIONS[from].has(to);
+}

package/agent/extensions/todo/state/replay.ts

@@ -1,38 +1,38 @@
-import type { TaskDetails } from "../tool/types.js";
-import { EMPTY_STATE, type TaskState } from "./state.js";
-
-/**
- * Discriminator for `details` envelopes that match the persisted `TaskDetails`
- * shape. Defensive — branch entries from older or corrupt sessions are
- * skipped silently.
- */
-export function isTaskDetails(value: unknown): value is TaskDetails {
-	if (!value || typeof value !== "object") return false;
-	const v = value as Record<string, unknown>;
-	return Array.isArray(v.tasks) && typeof v.nextId === "number";
-}
-
-/**
- * Walk the current branch in chronological order; the LAST `toolResult` whose
- * `toolName === "todo"` and whose `details` shape matches `TaskDetails` wins
- * (last-write-wins). When no matching entry exists, returns `EMPTY_STATE`.
- *
- * Pure of module state — `index.ts` writes the returned snapshot into the
- * store after this returns. The function explicitly does NOT touch the store
- * cell.
- */
-export function replayFromBranch(ctx: { sessionManager: { getBranch(): Iterable<unknown> } }): TaskState {
-	let result: TaskState = { tasks: [...EMPTY_STATE.tasks], nextId: EMPTY_STATE.nextId };
-	for (const entry of ctx.sessionManager.getBranch()) {
-		const e = entry as { type?: string; message?: { role?: string; toolName?: string; details?: unknown } };
-		if (e.type !== "message") continue;
-		const msg = e.message;
-		if (msg?.role !== "toolResult" || msg.toolName !== "todo") continue;
-		if (!isTaskDetails(msg.details)) continue;
-		result = {
-			tasks: msg.details.tasks.map((t) => ({ ...t })),
-			nextId: msg.details.nextId,
-		};
-	}
-	return result;
-}
+import type { TaskDetails } from "../tool/types.js";
+import { EMPTY_STATE, type TaskState } from "./state.js";
+
+/**
+ * Discriminator for `details` envelopes that match the persisted `TaskDetails`
+ * shape. Defensive — branch entries from older or corrupt sessions are
+ * skipped silently.
+ */
+export function isTaskDetails(value: unknown): value is TaskDetails {
+	if (!value || typeof value !== "object") return false;
+	const v = value as Record<string, unknown>;
+	return Array.isArray(v.tasks) && typeof v.nextId === "number";
+}
+
+/**
+ * Walk the current branch in chronological order; the LAST `toolResult` whose
+ * `toolName === "todo"` and whose `details` shape matches `TaskDetails` wins
+ * (last-write-wins). When no matching entry exists, returns `EMPTY_STATE`.
+ *
+ * Pure of module state — `index.ts` writes the returned snapshot into the
+ * store after this returns. The function explicitly does NOT touch the store
+ * cell.
+ */
+export function replayFromBranch(ctx: { sessionManager: { getBranch(): Iterable<unknown> } }): TaskState {
+	let result: TaskState = { tasks: [...EMPTY_STATE.tasks], nextId: EMPTY_STATE.nextId };
+	for (const entry of ctx.sessionManager.getBranch()) {
+		const e = entry as { type?: string; message?: { role?: string; toolName?: string; details?: unknown } };
+		if (e.type !== "message") continue;
+		const msg = e.message;
+		if (msg?.role !== "toolResult" || msg.toolName !== "todo") continue;
+		if (!isTaskDetails(msg.details)) continue;
+		result = {
+			tasks: msg.details.tasks.map((t) => ({ ...t })),
+			nextId: msg.details.nextId,
+		};
+	}
+	return result;
+}

package/agent/extensions/todo/state/selectors.ts

@@ -1,107 +1,107 @@
-import type { Task, TaskStatus } from "../tool/types.js";
-import type { TaskState } from "./state.js";
-
-/** Tasks excluding deleted tombstones — the canonical "what's visible". */
-export function selectVisibleTasks(state: TaskState): readonly Task[] {
-	return state.tasks.filter((t) => t.status !== "deleted");
-}
-
-/**
- * Group visible tasks by status. Iteration order at the call site uses
- * (`completed`, `inProgress`, `pending`) to match the `/todos` header part
- * order pinned by `todo.command.test.ts`.
- */
-export interface TasksByStatus {
-	pending: readonly Task[];
-	inProgress: readonly Task[];
-	completed: readonly Task[];
-}
-export function selectTasksByStatus(state: TaskState): TasksByStatus {
-	const visible = selectVisibleTasks(state);
-	return {
-		pending: visible.filter((t) => t.status === "pending"),
-		inProgress: visible.filter((t) => t.status === "in_progress"),
-		completed: visible.filter((t) => t.status === "completed"),
-	};
-}
-
-/** Total counts for the overlay heading (`Todos (n/m)`) and `/todos` header. */
-export interface TodoCounts {
-	total: number;
-	pending: number;
-	inProgress: number;
-	completed: number;
-}
-export function selectTodoCounts(state: TaskState): TodoCounts {
-	const groups = selectTasksByStatus(state);
-	return {
-		total: groups.pending.length + groups.inProgress.length + groups.completed.length,
-		pending: groups.pending.length,
-		inProgress: groups.inProgress.length,
-		completed: groups.completed.length,
-	};
-}
-
-/**
- * Whether any visible task carries a `blockedBy` reference. The overlay uses
- * this to gate the `#id` prefix on per-task rows — without at least one
- * `⛓ #N` suffix, the per-row id has no anchor.
- */
-export function selectShowTaskIds(state: TaskState): boolean {
-	return selectVisibleTasks(state).some((t) => t.blockedBy && t.blockedBy.length > 0);
-}
-
-/**
- * Resolve a task's subject by id from the live state for renderCall's
- * accent label. `undefined` when the id is unknown — caller falls back to
- * `#id` plain rendering.
- */
-export function selectTaskSubjectById(state: TaskState, id: number): string | undefined {
-	return state.tasks.find((t) => t.id === id)?.subject;
-}
-
-/**
- * Overlay layout decision. Encapsulates the "drop completed first, then
- * truncate non-completed tail" rule pre-refactor lived in
- * `todo-overlay.ts:144-188`. `budget` is the body-slot count (caller passes
- * `MAX_WIDGET_LINES - 1` to reserve the heading row); on overflow the
- * selector reserves one more slot internally for the summary row. Returns
- * the visible task slice plus the overflow summary parts.
- */
-export interface OverlayLayout {
-	visible: readonly Task[];
-	hiddenCompleted: number;
-	truncatedTail: number;
-}
-export function selectOverlayLayout(state: TaskState, budget: number): OverlayLayout {
-	const all = selectVisibleTasks(state);
-	if (all.length <= budget) {
-		return { visible: all, hiddenCompleted: 0, truncatedTail: 0 };
-	}
-	const innerBudget = budget - 1;
-	const nonCompleted = all.filter((t) => t.status !== "completed");
-	const totalCompleted = all.length - nonCompleted.length;
-	if (nonCompleted.length <= innerBudget) {
-		const kept = new Set<Task>(nonCompleted);
-		for (const t of all) {
-			if (kept.size >= innerBudget) break;
-			if (t.status === "completed") kept.add(t);
-		}
-		const visible = all.filter((t) => kept.has(t));
-		const shownCompleted = visible.filter((t) => t.status === "completed").length;
-		return { visible, hiddenCompleted: totalCompleted - shownCompleted, truncatedTail: 0 };
-	}
-	const visible = nonCompleted.slice(0, innerBudget);
-	const truncatedTail = nonCompleted.length - innerBudget;
-	return { visible, hiddenCompleted: totalCompleted, truncatedTail };
-}
-
-/**
- * Helper: whether any visible task is `pending` or `in_progress`. The overlay
- * uses this to pick the heading icon (`accent`+`●` vs `dim`+`○`).
- */
-export function selectHasActive(state: TaskState): boolean {
-	return selectVisibleTasks(state).some((t) => t.status === "in_progress" || t.status === "pending");
-}
-
-export const ACTIVE_STATUSES: ReadonlySet<TaskStatus> = new Set(["pending", "in_progress"]);
+import type { Task, TaskStatus } from "../tool/types.js";
+import type { TaskState } from "./state.js";
+
+/** Tasks excluding deleted tombstones — the canonical "what's visible". */
+export function selectVisibleTasks(state: TaskState): readonly Task[] {
+	return state.tasks.filter((t) => t.status !== "deleted");
+}
+
+/**
+ * Group visible tasks by status. Iteration order at the call site uses
+ * (`completed`, `inProgress`, `pending`) to match the `/todos` header part
+ * order pinned by `todo.command.test.ts`.
+ */
+export interface TasksByStatus {
+	pending: readonly Task[];
+	inProgress: readonly Task[];
+	completed: readonly Task[];
+}
+export function selectTasksByStatus(state: TaskState): TasksByStatus {
+	const visible = selectVisibleTasks(state);
+	return {
+		pending: visible.filter((t) => t.status === "pending"),
+		inProgress: visible.filter((t) => t.status === "in_progress"),
+		completed: visible.filter((t) => t.status === "completed"),
+	};
+}
+
+/** Total counts for the overlay heading (`Todos (n/m)`) and `/todos` header. */
+export interface TodoCounts {
+	total: number;
+	pending: number;
+	inProgress: number;
+	completed: number;
+}
+export function selectTodoCounts(state: TaskState): TodoCounts {
+	const groups = selectTasksByStatus(state);
+	return {
+		total: groups.pending.length + groups.inProgress.length + groups.completed.length,
+		pending: groups.pending.length,
+		inProgress: groups.inProgress.length,
+		completed: groups.completed.length,
+	};
+}
+
+/**
+ * Whether any visible task carries a `blockedBy` reference. The overlay uses
+ * this to gate the `#id` prefix on per-task rows — without at least one
+ * `⛓ #N` suffix, the per-row id has no anchor.
+ */
+export function selectShowTaskIds(state: TaskState): boolean {
+	return selectVisibleTasks(state).some((t) => t.blockedBy && t.blockedBy.length > 0);
+}
+
+/**
+ * Resolve a task's subject by id from the live state for renderCall's
+ * accent label. `undefined` when the id is unknown — caller falls back to
+ * `#id` plain rendering.
+ */
+export function selectTaskSubjectById(state: TaskState, id: number): string | undefined {
+	return state.tasks.find((t) => t.id === id)?.subject;
+}
+
+/**
+ * Overlay layout decision. Encapsulates the "drop completed first, then
+ * truncate non-completed tail" rule pre-refactor lived in
+ * `todo-overlay.ts:144-188`. `budget` is the body-slot count (caller passes
+ * `MAX_WIDGET_LINES - 1` to reserve the heading row); on overflow the
+ * selector reserves one more slot internally for the summary row. Returns
+ * the visible task slice plus the overflow summary parts.
+ */
+export interface OverlayLayout {
+	visible: readonly Task[];
+	hiddenCompleted: number;
+	truncatedTail: number;
+}
+export function selectOverlayLayout(state: TaskState, budget: number): OverlayLayout {
+	const all = selectVisibleTasks(state);
+	if (all.length <= budget) {
+		return { visible: all, hiddenCompleted: 0, truncatedTail: 0 };
+	}
+	const innerBudget = budget - 1;
+	const nonCompleted = all.filter((t) => t.status !== "completed");
+	const totalCompleted = all.length - nonCompleted.length;
+	if (nonCompleted.length <= innerBudget) {
+		const kept = new Set<Task>(nonCompleted);
+		for (const t of all) {
+			if (kept.size >= innerBudget) break;
+			if (t.status === "completed") kept.add(t);
+		}
+		const visible = all.filter((t) => kept.has(t));
+		const shownCompleted = visible.filter((t) => t.status === "completed").length;
+		return { visible, hiddenCompleted: totalCompleted - shownCompleted, truncatedTail: 0 };
+	}
+	const visible = nonCompleted.slice(0, innerBudget);
+	const truncatedTail = nonCompleted.length - innerBudget;
+	return { visible, hiddenCompleted: totalCompleted, truncatedTail };
+}
+
+/**
+ * Helper: whether any visible task is `pending` or `in_progress`. The overlay
+ * uses this to pick the heading icon (`accent`+`●` vs `dim`+`○`).
+ */
+export function selectHasActive(state: TaskState): boolean {
+	return selectVisibleTasks(state).some((t) => t.status === "in_progress" || t.status === "pending");
+}
+
+export const ACTIVE_STATUSES: ReadonlySet<TaskStatus> = new Set(["pending", "in_progress"]);