@nklisch/pi-enhanced 0.1.0

package/node_modules/@juicesharp/rpiv-todo/docs/overlay.md

@@ -0,0 +1,127 @@
+# Overlay and `/todos` display
+
+How
+[`@juicesharp/rpiv-todo`](https://www.npmjs.com/package/@juicesharp/rpiv-todo)
+renders the task list — when the overlay appears, what each glyph means, how
+overflow is trimmed, and which strings localize.
+
+## When the overlay exists
+
+The widget is mounted above the Pi editor under the key `rpiv-todos`.
+
+| Stage | Condition |
+| --- | --- |
+| Created | At the first session start that has a UI. A headless session never creates it. |
+| Registered | Only while at least one overlay-visible task exists. The widget unregisters itself when the list empties, and re-registers when a task reappears. |
+| Bound | Only the foreground session's overlay is refreshed. A detached or child session has its own task state and never rebinds or repaints the foreground panel. |
+| Disposed | On the foreground session's shutdown. A child session shutting down leaves the overlay alone. |
+
+Task state is partitioned by session id, so parallel sessions cannot read or
+overwrite each other's lists. Nothing is written to disk: on session start,
+compaction, and session-tree changes, the list is rebuilt by walking the branch
+and taking the last `todo` tool result's snapshot, which replaces the whole list
+(last-write-wins).
+
+## Anatomy of a row
+
+```
+● Todos (2/5)
+├─ ✓ Create DemoTodo domain entity
+├─ ✓ Create IDemoTodoRepository interface
+├─ ◐ Create DemoTodoRepository (creating the repository)
+├─ ○ Register DI bindings
+└─ ○ Add integration tests
+```
+
+- **Heading** — `● Todos (done/total)` in the accent color while any task is
+  `pending` or `in_progress`; `○ Todos (done/total)` dimmed once everything is
+  completed.
+- **Glyphs** — `○` pending, `◐` in_progress, `✓` completed, `✗` deleted.
+  Completed and deleted subjects render dim and struck through.
+- **activeForm** — appended dim in parentheses, only while the task is
+  `in_progress`.
+- **Dependencies** — appended as `⛓ #1,#2` when the task has a `blockedBy` set.
+- **`#id` prefix** — shown on every row only when at least one visible task
+  carries a `blockedBy`. Without a `⛓ #N` anywhere, the per-row ids have nothing
+  to point at, so they are omitted.
+- **Prefixes** — `├─` on each row, `└─` on the last one. A blank spacer line is
+  always appended below the panel so it is not flush against the input box.
+
+Rows longer than the terminal width are truncated with `…`.
+
+## Overflow
+
+The content-row budget is `maxWidgetLines` (default `12`), and the heading counts
+against it. When there are more tasks than fit:
+
+1. one row is reserved for the summary line;
+2. completed tasks are dropped first, newest first — the oldest completed rows
+   are the last completed rows to go;
+3. if the unfinished tasks alone still overflow, the tail of that list is
+   truncated;
+4. the last row becomes `+N more (X completed, Y pending)`.
+
+Unfinished work is therefore the last thing to disappear. See
+[configuration.md](./configuration.md#maxwidgetlines) for the budget's floor and
+reload semantics.
+
+## Completed tasks fading out
+
+A completed task stays on screen for the remainder of the turn in which it was
+completed. At the start of the next agent turn, every completed row that has
+already been displayed is hidden from later renders. Reloading or compacting the
+session resets that tracking, so a fresh session shows the full list again.
+
+## Collapsing
+
+Press `ctrl+shift+t` to collapse the panel to two lines — the heading plus a dim
+`└─ ctrl+shift+t to expand` hint — and again to expand it. The hint always shows
+the currently configured key.
+
+Rebind or disable the shortcut with the `collapseKey` option; see
+[configuration.md](./configuration.md#collapsekey). If the shortcut is set to
+`"off"` while the panel is collapsed, the hint becomes a static `collapsed`
+label rather than advertising an unbindable key.
+
+## `/todos`
+
+`/todos` prints the whole list grouped by status, independent of the overlay's
+row budget and auto-hiding:
+
+```
+2/7 completed · 1 in progress · 4 pending
+── Pending ──
+  ○ #4 Register DI bindings
+  ○ #5 Add integration tests    ⛓ #4
+  ○ #6 Wire up the HTTP endpoint
+  ○ #7 Update the API docs
+── In Progress ──
+  ◐ #3 Create DemoTodoRepository (creating the repository)
+── Completed ──
+  ✓ #1 Create DemoTodo domain entity
+  ✓ #2 Create IDemoTodoRepository interface
+```
+
+The header omits any count that is zero. Sections appear only when they have
+tasks. Tombstoned tasks are never listed.
+
+- With no tasks: `No todos yet. Ask the agent to add some!`
+- In a non-interactive session: `/todos requires interactive mode`
+
+## Localization
+
+The overlay heading, the `+N more` summary, the collapse hint, the `/todos`
+section headers, and the status words all localize through
+[`@juicesharp/rpiv-i18n`](https://www.npmjs.com/package/@juicesharp/rpiv-i18n)
+when that package is installed. Bundled locales: `de`, `en`, `es`, `fr`, `pt`,
+`pt-BR`, `ru`, `uk`, `zh`.
+
+LLM-facing output — the tool response envelope, reducer error messages, and the
+schema descriptions — stays English by design.
+
+The SDK is a soft optional peer, loaded through a dynamic import at module init.
+When it is absent, every call site returns its inline English literal and the
+extension stays online: no warning, no crash. Install it at any time with
+`pi install npm:@juicesharp/rpiv-i18n` and restart the session. To add or
+override a translation, drop a `locales/<code>.json` file mirroring `en.json` —
+see the `@juicesharp/rpiv-i18n` README's "Contributing translations" section.

package/node_modules/@juicesharp/rpiv-todo/docs/tool-schema.md

@@ -0,0 +1,151 @@
+# `todo` tool reference
+
+Complete parameter schema, status machine, response envelope, and error strings
+for the `todo` tool registered by
+[`@juicesharp/rpiv-todo`](https://www.npmjs.com/package/@juicesharp/rpiv-todo).
+
+## Actions
+
+| Action | Required params | What it does |
+| --- | --- | --- |
+| `create` | `subject` | Adds a task in `pending`, assigns the next id. |
+| `update` | `id` + at least one mutable field | Changes status, fields, or dependencies. |
+| `list` | — | Returns all tasks, optionally filtered by `status`. |
+| `get` | `id` | Returns one task with its `blockedBy` and reverse `blocks` edges. |
+| `delete` | `id` | Tombstones the task (`status: "deleted"`); it is not removed. |
+| `clear` | — | Drops every task and resets the id counter to `1`. |
+
+## Parameters
+
+```ts
+todo({
+  action: "create" | "update" | "list" | "get" | "delete" | "clear",
+
+  // create-only
+  subject?: string,                   // required for create
+  blockedBy?: number[],               // initial dependency ids
+
+  // create + update
+  description?: string,               // long-form detail
+  activeForm?: string,                // present-continuous label shown while in_progress
+  owner?: string,                     // agent/owner assigned to this task
+  metadata?: Record<string, unknown>, // on update, a null value deletes that key
+
+  // update-only
+  addBlockedBy?: number[],            // additive merge into blockedBy
+  removeBlockedBy?: number[],         // additive removal from blockedBy
+
+  // update / get / delete
+  id?: number,
+
+  // update (target status) or list (filter)
+  status?: "pending" | "in_progress" | "completed" | "deleted",
+
+  // list-only
+  includeDeleted?: boolean,           // default false — hides tombstones
+})
+```
+
+`update` merges `metadata` key by key into the existing record; passing `null`
+for a key removes it, and emptying the record drops the field entirely.
+`addBlockedBy` and `removeBlockedBy` are additive — do not resend the whole
+array.
+
+## Status transitions
+
+| From | Allowed targets |
+| --- | --- |
+| `pending` | `in_progress`, `completed`, `deleted` |
+| `in_progress` | `pending`, `completed`, `deleted` |
+| `completed` | `deleted` |
+| `deleted` | _(terminal)_ |
+
+A transition to the current status is always accepted and reported as a no-op.
+`delete` keeps the task as a tombstone so historic `blockedBy` references still
+resolve; tombstones are hidden from `list` unless you pass `includeDeleted: true`.
+
+## Dependencies
+
+`blockedBy` holds the ids this task waits on. Validation runs before the state
+is mutated, so a rejected call leaves the list untouched:
+
+- a dependency id that does not exist is rejected;
+- a dependency that is already tombstoned is rejected;
+- blocking a task on itself is rejected;
+- an `addBlockedBy` that would close a cycle in the graph is rejected.
+
+`get` also reports the reverse edges as a `blocks:` line, derived from the other
+tasks' `blockedBy` arrays.
+
+## Return envelope
+
+```ts
+{
+  content: [{ type: "text", text: string }], // human-readable summary of the op
+  details: {                                 // full snapshot — replay reads this back
+    action: TaskAction,
+    params: Record<string, unknown>,
+    tasks: Array<{
+      id: number,
+      subject: string,
+      description?: string,
+      activeForm?: string,
+      status: "pending" | "in_progress" | "completed" | "deleted",
+      blockedBy?: number[],
+      owner?: string,
+      metadata?: Record<string, unknown>,
+    }>,
+    nextId: number,
+    error?: string,                          // present only on a rejected call
+  }
+}
+```
+
+`details` is the persistence format. Every successful call embeds the complete
+post-mutation snapshot, and the session-lifecycle handlers rebuild state by
+walking the branch and taking the last snapshot they find — which is why tasks
+survive `/reload` and compaction without any disk writes.
+
+## Content strings
+
+| Situation | `content[0].text` |
+| --- | --- |
+| Created | `Created #3: Write the parser (pending)` |
+| Updated with a status change | `Updated #3 (pending → in_progress)` |
+| Updated without a status change | `Updated #3` |
+| Update that changed nothing | `No change: #3 already matches the requested values (status: in_progress)` |
+| Deleted | `Deleted #3: Write the parser` |
+| Cleared | `Cleared 7 tasks` |
+| `list` row | `[in_progress] #3 Write the parser (writing the parser) ⛓ #1,#2` |
+| `list` with nothing to show | `No tasks` |
+| Any rejection | `Error: <message>` |
+
+The `No change` reply exists so a model that re-issues an identical update sees
+that it was a no-op instead of a fresh `Updated #N`.
+
+## Error messages
+
+| Message | Cause |
+| --- | --- |
+| `subject required for create` | `create` without a non-blank `subject`. |
+| `blockedBy: #N not found` | `create` naming an unknown dependency. |
+| `blockedBy: #N is deleted` | `create` naming a tombstoned dependency. |
+| `id required for update` / `get` / `delete` | `id` omitted. |
+| `#N not found` | No task with that id. |
+| `update requires at least one mutable field` | `update` with only an `id`. |
+| `illegal transition completed → in_progress` | Target status not reachable from the current one. |
+| `cannot block #N on itself` | `addBlockedBy` includes the task's own id. |
+| `addBlockedBy: #N not found` / `is deleted` | Unknown or tombstoned dependency. |
+| `addBlockedBy would create a cycle in the blockedBy graph` | The edge would close a cycle. |
+| `#N is already deleted` | `delete` on a tombstone. |
+
+Errors are returned in-band: `content` carries `Error: …` and `details.error`
+carries the bare message. Task state is unchanged.
+
+## Prompt guidance
+
+The tool ships a `promptSnippet` and seven `promptGuidelines` bullets telling the
+model when to open a list, to keep exactly one task `in_progress`, to mark work
+completed immediately rather than in batches, and never to complete a task with
+failing tests. Both are overridable — see
+[configuration.md](./configuration.md#guidance).

package/node_modules/@juicesharp/rpiv-todo/index.ts

@@ -0,0 +1,186 @@
+/**
+ * rpiv-todo — Pi extension. Registers the `todo` tool, `/todos` slash
+ * command, and the persistent TodoOverlay widget.
+ *
+ * TUI chrome strings localize at render time via the i18n bridge. Strings are
+ * registered with rpiv-i18n here, once, at module init — but only when the
+ * SDK is actually installed. If `@juicesharp/rpiv-i18n` is missing (standalone
+ * install of just this package), the dynamic-load shim no-ops and the bridge's
+ * `t(key, fallback)` returns the inline English literal at every call site.
+ * The extension stays online either way.
+ *
+ * Adding a locale: drop `locales/<code>.json` next to en.json (mirroring the
+ * key set). No edit needed here — `registerLocalesFromDir` iterates
+ * `SUPPORTED_LOCALES` from the SDK. See `@juicesharp/rpiv-i18n` README →
+ * "Contributing translations" for the full convention.
+ *
+ * Extracted from rpiv-pi@7525a5d. Tool name "todo" and widget key
+ * "rpiv-todos" preserved verbatim so existing session history replays
+ * correctly after upgrade.
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { KeyId } from "@earendil-works/pi-tui";
+import { COLLAPSE_KEY_OFF, resolveCollapseKey } from "./config.js";
+import { I18N_NAMESPACE } from "./state/i18n-bridge.js";
+import { replayFromBranch } from "./state/replay.js";
+import {
+	clearActiveRenderSession,
+	evictSession,
+	getActiveRenderSession,
+	replaceState,
+	setActiveRenderSession,
+	sid,
+} from "./state/store.js";
+import { registerTodosCommand, registerTodoTool, TOOL_NAME } from "./todo.js";
+import { TodoOverlay } from "./todo-overlay.js";
+
+type I18nLoader = {
+	registerLocalesFromDir: (namespace: string, packageUrl: string, options?: { label?: string }) => void;
+};
+
+// Dynamic import keeps `@juicesharp/rpiv-i18n` a soft optional peer: when the
+// SDK is installed alongside this package the strings register and
+// `/languages` flips them live; when it isn't, the import rejects here, we
+// no-op, and the bridge's English-fallback shim keeps the extension online.
+//
+// The `/loader` subpath is used instead of the SDK entry so the i18n-ui +
+// pi-tui modules are not pulled into our load graph just to register strings.
+try {
+	const sdk = (await import("@juicesharp/rpiv-i18n/loader")) as I18nLoader;
+	sdk.registerLocalesFromDir(I18N_NAMESPACE, import.meta.url, { label: "rpiv-todo" });
+} catch {
+	// SDK absent — extension still loads with English-only UI.
+}
+
+// pi-core's ExtensionRunner throws this exact phrase from an invalidated ctx
+// proxy after session replacement/reload. Match the stable substring so genuine
+// replay bugs still propagate instead of being silently swallowed.
+function isStaleCtxError(e: unknown): boolean {
+	return /stale after session replacement/.test(String(e));
+}
+
+export default function (pi: ExtensionAPI) {
+	// Todo overlay widget — constructed lazily at the first session_start with UI.
+	let todoOverlay: TodoOverlay | undefined;
+
+	registerTodoTool(pi);
+	registerTodosCommand(pi);
+
+	// Collapse/expand hotkey for the todo overlay. The key is resolved once at
+	// factory scope from config (register-once contract: a config change needs
+	// `/reload` to re-bind, same as lane-switcher's env hotkey) and the binding is
+	// skipped entirely when collapseKey is "off". The handler closes over the
+	// closure-local `todoOverlay` by reference and re-reads it at fire time, so a
+	// session_start that (re)creates the overlay is picked up. No-op in headless
+	// mode, when the overlay hasn't been created yet, or when the widget isn't
+	// currently registered (auto-hidden on an empty list).
+	const collapseKey = resolveCollapseKey();
+	if (collapseKey !== COLLAPSE_KEY_OFF) {
+		pi.registerShortcut(collapseKey as KeyId, {
+			description: "Collapse or expand the todo overlay",
+			handler: (ctx) => {
+				if (!ctx.hasUI || !todoOverlay?.isRegistered()) return;
+				todoOverlay.toggleCollapse();
+			},
+		});
+	}
+
+	// Re-key a session's slot from its branch, then refresh the overlay only when
+	// the refreshed session IS the foreground. Shared by session_compact and
+	// session_tree (verbatim-identical pre-extraction). A stale ctx (auto-compaction
+	// races session disposal: pi-core invalidates the runner while still emitting the
+	// event, so `ctx` may be a dead proxy whose getters throw) keeps current state —
+	// the replacement session's session_start replays it. Other errors are real replay
+	// bugs and must propagate. The render is sid-gated so a child never refreshes the
+	// foreground overlay.
+	const replayAndRefresh = (ctx: Parameters<typeof sid>[0] & Parameters<typeof replayFromBranch>[0]): void => {
+		let isForeground = false;
+		try {
+			const id = sid(ctx);
+			replaceState(id, replayFromBranch(ctx));
+			isForeground = id === getActiveRenderSession();
+		} catch (e) {
+			if (!isStaleCtxError(e)) throw e;
+		}
+		if (isForeground) {
+			todoOverlay?.resetCompletedDisplayState();
+			todoOverlay?.update();
+		}
+	};
+
+	pi.on("session_start", async (_event, ctx) => {
+		let id: string;
+		try {
+			id = sid(ctx);
+			// Every session replays into its OWN data slot (Phase 1 isolation).
+			replaceState(id, replayFromBranch(ctx));
+		} catch (e) {
+			// Parity with compact/tree/shutdown: session_start is the fresh-ctx event
+			// so the stale risk is low, but a stale/throwing ctx has nothing to bind —
+			// swallow the known stale error and bail; let real replay bugs propagate.
+			if (!isStaleCtxError(e)) throw e;
+			return;
+		}
+		if (!ctx.hasUI) return;
+		// First UI-bearing session_start claims the foreground (the interactive
+		// launcher, by spawn-ordering). A child hitting a live overlay cannot
+		// clobber the pointer — `todoOverlay` is already set.
+		if (todoOverlay === undefined) {
+			todoOverlay = new TodoOverlay();
+			setActiveRenderSession(id);
+		}
+		// Only the foreground re-binds/refreshes the shared overlay. A child
+		// (distinct sid) is skipped — does not rebind to a relay/stale ui.
+		if (id !== getActiveRenderSession()) return;
+		todoOverlay.setUICtx(ctx.ui);
+		todoOverlay.resetCompletedDisplayState();
+		todoOverlay.update();
+	});
+
+	pi.on("session_compact", async (_event, ctx) => replayAndRefresh(ctx));
+
+	pi.on("session_tree", async (_event, ctx) => replayAndRefresh(ctx));
+
+	pi.on("session_shutdown", async (_event, ctx) => {
+		// Best-effort sid: disposal can race a stale ctx (like compact). An
+		// unknown/stale sid resolves to "" and is treated as foreground — the
+		// safe pre-isolation default that disposes as before.
+		let s: string;
+		try {
+			s = sid(ctx);
+		} catch (e) {
+			if (!isStaleCtxError(e)) throw e;
+			s = "";
+		}
+		// The shutting-down session's own data slot is always evicted.
+		evictSession(s);
+		// Overlay teardown is sid-gated: a child shutdown (distinct sid) must not
+		// dispose the foreground's overlay. Only the foreground's own shutdown
+		// (or an unknown/stale sid) tears it down and clears the pointer.
+		if (s === "" || s === getActiveRenderSession()) {
+			// `dispose()`'s first act is setWidget(KEY, undefined) on a possibly-stale
+			// ui proxy, which can throw. evictSession(s) above already deleted this
+			// slot, so leaving `activeRenderSession` pointing at it would resolve
+			// getRenderState() to a fresh EMPTY_STATE (overlay silently renders empty).
+			// try/finally guarantees the pointer-clear + overlay-drop run regardless.
+			try {
+				todoOverlay?.dispose();
+			} finally {
+				todoOverlay = undefined;
+				clearActiveRenderSession();
+			}
+		}
+	});
+
+	// Reads getTodos() at render time; do NOT call replayFromBranch here
+	// (branch is stale — message_end runs after tool_execution_end).
+	pi.on("tool_execution_end", async (event) => {
+		if (event.toolName !== TOOL_NAME || event.isError) return;
+		todoOverlay?.update();
+	});
+
+	pi.on("agent_start", async () => {
+		todoOverlay?.hideCompletedTasksFromPreviousTurn();
+	});
+}

package/node_modules/@juicesharp/rpiv-todo/locales/de.json

@@ -0,0 +1,19 @@
+{
+  "_meta.notes": "Auto-translated draft. Native-speaker review welcome via PR. Unicode box-drawing characters (──) stay untranslated. Note: 'overlay.more' renders as '+5 weitere' which is grammatically loose for plural agreement — accepted for badge brevity.",
+
+  "status.pending": "ausstehend",
+  "status.in_progress": "in Bearbeitung",
+  "status.completed": "erledigt",
+  "status.deleted": "gelöscht",
+
+  "overlay.heading": "Todos",
+  "overlay.more": "weitere",
+  "overlay.expandHint": "{key} zum Ausklappen",
+  "overlay.collapsed": "eingeklappt",
+
+  "command.no_todos": "Noch keine Todos. Bitte den Agenten, welche hinzuzufügen!",
+  "command.requires_interactive": "/todos erfordert den interaktiven Modus",
+  "command.section.pending": "── Ausstehend ──",
+  "command.section.in_progress": "── In Bearbeitung ──",
+  "command.section.completed": "── Erledigt ──"
+}

package/node_modules/@juicesharp/rpiv-todo/locales/en.json

@@ -0,0 +1,17 @@
+{
+  "status.pending": "pending",
+  "status.in_progress": "in progress",
+  "status.completed": "completed",
+  "status.deleted": "deleted",
+
+  "overlay.heading": "Todos",
+  "overlay.more": "more",
+  "overlay.expandHint": "{key} to expand",
+  "overlay.collapsed": "collapsed",
+
+  "command.no_todos": "No todos yet. Ask the agent to add some!",
+  "command.requires_interactive": "/todos requires interactive mode",
+  "command.section.pending": "── Pending ──",
+  "command.section.in_progress": "── In Progress ──",
+  "command.section.completed": "── Completed ──"
+}

package/node_modules/@juicesharp/rpiv-todo/locales/es.json

@@ -0,0 +1,19 @@
+{
+  "_meta.notes": "Auto-translated draft. Native-speaker review welcome via PR. Unicode box-drawing characters (──) stay untranslated.",
+
+  "status.pending": "pendientes",
+  "status.in_progress": "en curso",
+  "status.completed": "completadas",
+  "status.deleted": "eliminada",
+
+  "overlay.heading": "Tareas",
+  "overlay.more": "más",
+  "overlay.expandHint": "{key} para expandir",
+  "overlay.collapsed": "contraído",
+
+  "command.no_todos": "Sin tareas aún. ¡Pídele al agente que añada algunas!",
+  "command.requires_interactive": "/todos requiere modo interactivo",
+  "command.section.pending": "── Pendientes ──",
+  "command.section.in_progress": "── En curso ──",
+  "command.section.completed": "── Completadas ──"
+}

package/node_modules/@juicesharp/rpiv-todo/locales/fr.json

@@ -0,0 +1,19 @@
+{
+  "_meta.notes": "Auto-translated draft. Native-speaker review welcome via PR. Unicode box-drawing characters (──) stay untranslated.",
+
+  "status.pending": "en attente",
+  "status.in_progress": "en cours",
+  "status.completed": "terminées",
+  "status.deleted": "supprimée",
+
+  "overlay.heading": "Tâches",
+  "overlay.more": "autres",
+  "overlay.expandHint": "{key} pour développer",
+  "overlay.collapsed": "réduit",
+
+  "command.no_todos": "Pas encore de tâches. Demandez à l'agent d'en ajouter !",
+  "command.requires_interactive": "/todos nécessite le mode interactif",
+  "command.section.pending": "── En attente ──",
+  "command.section.in_progress": "── En cours ──",
+  "command.section.completed": "── Terminées ──"
+}

package/node_modules/@juicesharp/rpiv-todo/locales/pt-BR.json

@@ -0,0 +1,19 @@
+{
+  "_meta.notes": "Auto-translated draft. Native-speaker review welcome via PR. Unicode box-drawing characters (──) stay untranslated.",
+
+  "status.pending": "pendentes",
+  "status.in_progress": "em andamento",
+  "status.completed": "concluídas",
+  "status.deleted": "excluída",
+
+  "overlay.heading": "Tarefas",
+  "overlay.more": "mais",
+  "overlay.expandHint": "{key} para expandir",
+  "overlay.collapsed": "recolhido",
+
+  "command.no_todos": "Nenhuma tarefa ainda. Peça ao agente para adicionar algumas!",
+  "command.requires_interactive": "/todos requer modo interativo",
+  "command.section.pending": "── Pendentes ──",
+  "command.section.in_progress": "── Em andamento ──",
+  "command.section.completed": "── Concluídas ──"
+}

package/node_modules/@juicesharp/rpiv-todo/locales/pt.json

@@ -0,0 +1,19 @@
+{
+  "_meta.notes": "Auto-translated draft. Native-speaker review welcome via PR. Unicode box-drawing characters (──) stay untranslated.",
+
+  "status.pending": "pendentes",
+  "status.in_progress": "em curso",
+  "status.completed": "concluídas",
+  "status.deleted": "eliminada",
+
+  "overlay.heading": "Tarefas",
+  "overlay.more": "mais",
+  "overlay.expandHint": "{key} para expandir",
+  "overlay.collapsed": "recolhido",
+
+  "command.no_todos": "Sem tarefas ainda. Peça ao agente para adicionar algumas!",
+  "command.requires_interactive": "/todos requer modo interativo",
+  "command.section.pending": "── Pendentes ──",
+  "command.section.in_progress": "── Em curso ──",
+  "command.section.completed": "── Concluídas ──"
+}

package/node_modules/@juicesharp/rpiv-todo/locales/ru.json

@@ -0,0 +1,19 @@
+{
+  "_meta.notes": "Автоперевод. Приветствуется проверка носителем языка через PR. Символы юникода (──) не переводятся.",
+
+  "status.pending": "ожидание",
+  "status.in_progress": "в работе",
+  "status.completed": "выполнено",
+  "status.deleted": "удалена",
+
+  "overlay.heading": "Задачи",
+  "overlay.more": "ещё",
+  "overlay.expandHint": "{key} — развернуть",
+  "overlay.collapsed": "свёрнуто",
+
+  "command.no_todos": "Задач пока нет. Попросите агента добавить!",
+  "command.requires_interactive": "/todos требует интерактивного режима",
+  "command.section.pending": "── Ожидание ──",
+  "command.section.in_progress": "── В работе ──",
+  "command.section.completed": "── Выполнено ──"
+}

package/node_modules/@juicesharp/rpiv-todo/locales/uk.json

@@ -0,0 +1,19 @@
+{
+  "_meta.notes": "Автопереклад. Привітна перевірка носієм мови через PR. Символи юнікоду (──) не перекладаються.",
+
+  "status.pending": "очікування",
+  "status.in_progress": "у роботі",
+  "status.completed": "виконано",
+  "status.deleted": "видалено",
+
+  "overlay.heading": "Завдання",
+  "overlay.more": "ще",
+  "overlay.expandHint": "{key} — розгорнути",
+  "overlay.collapsed": "згорнуто",
+
+  "command.no_todos": "Завдань поки немає. Попросіть агента додати!",
+  "command.requires_interactive": "/todos потребує інтерактивного режиму",
+  "command.section.pending": "── Очікування ──",
+  "command.section.in_progress": "── У роботі ──",
+  "command.section.completed": "── Виконано ──"
+}

package/node_modules/@juicesharp/rpiv-todo/locales/zh.json

@@ -0,0 +1,19 @@
+{
+  "_meta.notes": "中文翻译。欢迎中文母语者通过 PR 审校。",
+
+  "status.pending": "待处理",
+  "status.in_progress": "进行中",
+  "status.completed": "已完成",
+  "status.deleted": "已删除",
+
+  "overlay.heading": "任务清单",
+  "overlay.more": "更多",
+  "overlay.expandHint": "按 {key} 展开",
+  "overlay.collapsed": "已折叠",
+
+  "command.no_todos": "暂无任务。可以让 agent 添加一些！",
+  "command.requires_interactive": "/todos 需要交互模式",
+  "command.section.pending": "── 待处理 ──",
+  "command.section.in_progress": "── 进行中 ──",
+  "command.section.completed": "── 已完成 ──"
+}