@wuyaos/pi-sync 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BevalZ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PROMO.md

@@ -0,0 +1,95 @@
+# pi-sync promotion drafts
+
+Repo: https://github.com/wuyaos/pi-packages  
+Install: `pi install git:github.com/wuyaos/pi-packages`  
+Release: https://github.com/wuyaos/pi-packages/releases/tag/v1.0.1
+
+---
+
+## English (short)
+
+**pi-sync** — WebDAV backup/restore for the [Pi coding agent](https://github.com/earendil-works/pi-coding-agent).
+
+Open `/sync`, then **Upload Backup** on one machine and **Download Backup** on another.
+
+```bash
+pi install git:github.com/wuyaos/pi-packages
+/sync   # main machine  → Upload Backup (Backup to cloud)
+/sync   # new machine   → Download Backup (Restore from cloud)
+```
+
+Works with any WebDAV (Nextcloud, 坚果云, TeraCLOUD, self-hosted). Restore keeps local `.bak` copies. MIT.
+
+👉 https://github.com/wuyaos/pi-packages
+
+---
+
+## English (Discord / forum)
+
+Hey Pi users — I open-sourced **pi-sync**, a small package that syncs your Pi agent home over WebDAV.
+
+Problem: multi-machine setups mean re-copying `models.json`, skills, and extensions by hand.  
+Solution: `/sync push` on the main box, `/sync pull` on the next one.
+
+- Install: `pi install git:github.com/wuyaos/pi-packages`
+- Interactive menu: Upload Backup · Download Backup · Configure Sync Settings
+- Optional Windows bootstrap script for brand-new machines
+- Backup zips tagged by platform (`windows11`, `macos`, …)
+- Restore confirms and keeps timestamped local backups
+
+Feedback / issues welcome: https://github.com/wuyaos/pi-packages
+
+---
+
+## 中文（短）
+
+**pi-sync**：给 [Pi coding agent](https://github.com/earendil-works/pi-coding-agent) 用的 WebDAV 配置同步插件。
+
+多机之间一键备份 / 恢复 models、settings、skills、extensions。
+
+```bash
+pi install git:github.com/wuyaos/pi-packages
+/sync   # 主力机 → Upload Backup (Backup to cloud)
+/sync   # 新机器 → Download Backup (Restore from cloud)
+```
+
+支持任意 WebDAV（坚果云 / Nextcloud / 自建）。恢复前会做本地备份。MIT 开源。
+
+👉 https://github.com/wuyaos/pi-packages
+
+---
+
+## 中文（朋友圈 / 社区）
+
+换电脑重装 Pi 配置太烦？我做了个小工具 **pi-sync** 并开源了。
+
+- 主力机 `/sync` → **Upload Backup** 把配置打成 zip 传到 WebDAV
+- 新机器 `/sync` → **Download Backup** 选择备份并还原
+- 覆盖 models / settings / skills / extensions
+- 恢复前自动留本地备份，密码建议用应用专用密码 + 环境变量
+
+安装一行：
+
+```bash
+pi install git:github.com/wuyaos/pi-packages
+```
+
+仓库：https://github.com/wuyaos/pi-packages  
+Release：https://github.com/wuyaos/pi-packages/releases/tag/v1.0.1
+
+欢迎试用和提 issue。
+
+---
+
+## Tweet / X (EN)
+
+Multi-machine Pi setup? I open-sourced pi-sync:
+
+`/sync` → Upload Backup → WebDAV  
+`/sync` → Download Backup → new machine
+
+models · settings · skills · extensions
+
+`pi install git:github.com/wuyaos/pi-packages`
+
+https://github.com/wuyaos/pi-packages

package/README.md

@@ -0,0 +1,205 @@
+# pi-sync
+
+**English** | [简体中文](./README.zh-CN.md)
+
+[![pi package](https://img.shields.io/badge/pi-package-blue)](https://github.com/earendil-works/pi-coding-agent)
+[![license](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
+[![release](https://img.shields.io/github/v/release/wuyaos/pi-packages?display_name=tag&sort=semver)](https://github.com/wuyaos/pi-packages/releases)
+
+WebDAV-based config sync for [Pi](https://github.com/earendil-works/pi-coding-agent) — backup and restore **models**, **settings**, **skills**, **extensions**, and **session projects** across machines.
+
+Run `/sync`, pick an action from the menu. One machine uploads; another downloads and restores.
+
+<p align="center">
+  <img src="docs/sync-menu.png" alt="Pi WebDAV Synchronization menu" width="720" />
+</p>
+
+<p align="center"><sub><b>Pi WebDAV Synchronization</b> — interactive menu after <code>/sync</code></sub></p>
+
+## Why
+
+If you run Pi on multiple PCs / WSL / servers, reinstalling models, skills, and extensions by hand is painful. `pi-sync` packages your agent home into a timestamped zip, uploads it to any WebDAV folder, and restores it with local safety backups.
+
+## Install
+
+Requires [Pi coding agent](https://github.com/earendil-works/pi-coding-agent) and a WebDAV endpoint (TeraCLOUD, 坚果云 / Jianguoyun, Nextcloud, ownCloud, self-hosted, …).
+
+`pi-sync` is part of the [wuyaos/pi-packages](https://github.com/wuyaos/pi-packages) monorepo. Installing the whole repo loads every sub-package:
+
+```bash
+pi install git:github.com/wuyaos/pi-packages
+```
+
+To load **only** `pi-sync`, use the object form in `~/.pi/agent/settings.json`:
+
+```json
+{
+  "packages": [
+    {
+      "source": "git:github.com/wuyaos/pi-packages",
+      "extensions": ["pi-sync/extensions/*.ts"],
+      "themes": []
+    }
+  ]
+}
+```
+
+Then restart Pi or run `/reload`.
+
+## Usage
+
+Type **`/sync`** in Pi. There are no CLI subcommands — everything goes through the interactive menu:
+
+| Menu item | What it does |
+|-----------|----------------|
+| ☁️ **Upload Backup (Backup to cloud)** | Zip current config and upload to WebDAV |
+| 📥 **Download Backup (Restore from cloud)** | List remote backups, download one, restore with confirmation |
+| ⚙️ **Configure Sync Settings** | WebDAV URL / user / password, and what to include |
+| ❌ **Cancel** | Leave the menu |
+
+Keyboard hints (as shown in the TUI): `↵` select · `↑↓` navigate · `Esc` cancel.
+
+### First-time setup
+
+```bash
+# 1. Install
+pi install git:github.com/wuyaos/pi-packages
+
+# 2. Open the menu (first run starts the setup wizard if WebDAV is empty)
+/sync
+
+# 3. If needed: Configure Sync Settings
+#    enter URL / user / password
+#    tip: set password to $PI_WEBDAV_PASS and export that env var
+
+# 4. On your main machine → Upload Backup (Backup to cloud)
+# 5. On a new machine (after install + configure) → Download Backup (Restore from cloud)
+```
+
+### What gets synced
+
+| Component | Default | Notes |
+|-----------|---------|-------|
+| Config | ON | `models.json`, `settings.json`, `auth.json` |
+| Skills | ON | entire `~/.pi/agent/skills` |
+| Extensions | ON | `~/.pi/agent/extensions` (the sync plugin itself is excluded from the zip) |
+| Sessions | OFF | per-project session history under `~/.pi/agent/sessions/`; pick which projects to include under **Configure Sync Settings → Session Projects** |
+
+Toggle any of these under **Configure Sync Settings**.
+
+### Sessions (optional)
+
+Session history is organized by project cwd under `~/.pi/agent/sessions/<projectDir>/`. The **Session Projects** submenu lists every project directory found on this machine and lets you check the ones you want to back up.
+
+- Turn on **Backup Sessions** in **Configure Sync Settings**.
+- Open **Session Projects** and toggle projects on/off (use **Select All** / **Reset list** for convenience).
+- List mode (toggleable):
+  - **Whitelist**: only checked projects are backed up; an empty list backs up **nothing**.
+  - **Blacklist**: checked projects are skipped; an empty list backs up **everything**.
+- On restore, session files are *merged* into the local `~/.pi/agent/sessions/` — session file names are unique (timestamp + uuid), so restoring never overwrites or deletes your local sessions.
+
+> Note: project directory names encode the project path, so a backup made on one machine only restores into the same project path on another machine.
+
+### Backup filename
+
+Archives look like:
+
+```text
+pi_sync_backup_2026-7-14_20260714120000_windows11.zip
+```
+
+The trailing platform tag (`windows11` / `windows10` / `macos` / `linux`) shows which host created the backup.
+
+### Safety on restore
+
+- Existing config files get a timestamped `.bak` copy before overwrite
+- Existing skills / extensions folders are renamed to `*-backup-<timestamp>` before replace/merge
+- Restore shows a plan and asks for confirmation
+- After a successful restore you can reload the agent runtime to apply skills/extensions
+
+## Bootstrap (new Windows machine, no Pi yet)
+
+If Pi is not installed yet, you can still pull the latest zip with the helper script:
+
+```powershell
+# Prefer env vars so secrets never land in shell history
+$env:PI_WEBDAV_URL  = "https://your-webdav.example/dav/Pi"
+$env:PI_WEBDAV_USER = "your-user"
+$env:PI_WEBDAV_PASS = "your-app-password"
+.\pi-bootstrap.ps1
+```
+
+Or one-liner placeholders (replace before running):
+
+```powershell
+$url="https://your-webdav.example/dav/Pi"; $user="your-user"; $pass="your-app-password"
+$pair="$user`:$pass"; $auth=[Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes($pair))
+$resp=Invoke-RestMethod -Uri $url -Method PROPFIND -Headers @{Authorization="Basic $auth";Depth="1"} -ContentType "application/xml"
+$files=([regex]'<d:href>([^<]+)</d:href>').Matches($resp) | %{$_.Groups[1].Value} | ?{$_ -match "pi_sync_backup_.*\.zip$"} | Sort-Object -Descending
+$latest=$files[0]; $name=Split-Path $latest -Leaf
+Invoke-WebRequest -Uri "$url/$name" -Headers @{Authorization="Basic $auth"} -OutFile "$env:TEMP\$name"
+```
+
+Then install Pi and use **Download Backup** from `/sync` for future updates.
+
+## Security
+
+- WebDAV credentials are stored locally in `~/.pi/agent/sync_config.json`
+- Prefer **app-specific passwords** (not your main account password)
+- Prefer env-var references: set password to `$PI_WEBDAV_PASS` in the UI, then export that variable in your shell profile
+- Backups may include `auth.json` / API keys if those options are enabled — treat the WebDAV folder as sensitive
+- Never commit real WebDAV URLs with credentials into git
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---------|-----|
+| HTTP 401 / 403 | Check user/password; use app password; confirm URL includes the correct DAV path |
+| PROPFIND fails / empty list | Server may block PROPFIND; try another WebDAV provider; ensure Depth:1 is allowed |
+| tar / zip errors | Need a working `tar` on PATH (Windows 10+ has one; Git Bash / WSL also fine) |
+| Restore overwrote something | Look for `*.bak-*` files and `skills-backup-*` / `extensions-backup-*` folders next to the agent dir |
+| Plugin missing after restore | Re-run `pi install git:github.com/wuyaos/pi-packages` — the sync package excludes itself from the archive |
+
+## Structure
+
+```text
+pi-sync/
+  package.json
+  LICENSE
+  README.md
+  README.zh-CN.md
+  pi-bootstrap.ps1
+  docs/
+    sync-menu.png       # /sync menu screenshot
+  extensions/
+    sync/
+      index.ts          # /sync command
+    _shared/
+      json-io.ts
+      enhanced-select.ts
+      spawn.ts
+      fetch-utils.ts
+      box-drawing.ts
+```
+
+## Changelog
+
+### v1.0.1
+
+- Tag backup zip names with host platform (`windows11` / `macos` / `linux` / …)
+- Remove example credentials from bootstrap script comments
+- Add MIT `LICENSE` and expand README (security, restore safety, troubleshooting, menu screenshot)
+
+### v1.0.0
+
+- Initial public release: interactive `/sync` menu over WebDAV
+  - Upload Backup · Download Backup · Configure Sync Settings
+- Windows bootstrap helper script
+
+## License
+
+MIT — see [LICENSE](./LICENSE).
+
+## Acknowledgements
+
+This open-source project is linked and recognized by the [LINUX DO](https://linux.do) community.

package/README.zh-CN.md

@@ -0,0 +1,205 @@
+# pi-sync
+
+[English](./README.md) | **简体中文**
+
+[![pi package](https://img.shields.io/badge/pi-package-blue)](https://github.com/earendil-works/pi-coding-agent)
+[![license](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
+[![release](https://img.shields.io/github/v/release/wuyaos/pi-packages?display_name=tag&sort=semver)](https://github.com/wuyaos/pi-packages/releases)
+
+面向 [Pi](https://github.com/earendil-works/pi-coding-agent) 的 WebDAV 配置同步工具 —— 跨机器备份与恢复 **models**、**settings**、**skills**、**extensions** 以及选定的 **session 项目**。
+
+在 Pi 里输入 `/sync`，从菜单选择操作。一台机器上传，另一台下载并恢复。
+
+<p align="center">
+  <img src="docs/sync-menu.png" alt="Pi WebDAV Synchronization 菜单" width="720" />
+</p>
+
+<p align="center"><sub><b>Pi WebDAV Synchronization</b> —— 输入 <code>/sync</code> 后的交互菜单</sub></p>
+
+## 为什么需要它
+
+如果你在多台 PC / WSL / 服务器上使用 Pi，手工重装 models、skills、extensions 很痛苦。`pi-sync` 会把 agent 主目录打包成带时间戳的 zip，上传到任意 WebDAV 目录，并在恢复时保留本地安全备份。
+
+## 安装
+
+需要 [Pi coding agent](https://github.com/earendil-works/pi-coding-agent)，以及可用的 WebDAV（TeraCLOUD、坚果云、Nextcloud、ownCloud、自建等）。
+
+`pi-sync` 是 [wuyaos/pi-packages](https://github.com/wuyaos/pi-packages) monorepo 的子包。直接安装整个仓库会加载所有子包：
+
+```bash
+pi install git:github.com/wuyaos/pi-packages
+```
+
+只想加载 **pi-sync** 时，在 `~/.pi/agent/settings.json` 用 object 形式筛选：
+
+```json
+{
+  "packages": [
+    {
+      "source": "git:github.com/wuyaos/pi-packages",
+      "extensions": ["pi-sync/extensions/*.ts"],
+      "themes": []
+    }
+  ]
+}
+```
+
+然后重启 Pi，或执行 `/reload`。
+
+## 用法
+
+在 Pi 中输入 **`/sync`**。没有命令行子命令 —— 全部通过交互菜单完成：
+
+| 菜单项 | 作用 |
+|--------|------|
+| ☁️ **Upload Backup (Backup to cloud)** | 打包当前配置并上传到 WebDAV |
+| 📥 **Download Backup (Restore from cloud)** | 列出云端备份，下载并在确认后恢复 |
+| ⚙️ **Configure Sync Settings** | 配置 WebDAV 地址 / 用户 / 密码，以及同步范围 |
+| ❌ **Cancel** | 退出菜单 |
+
+TUI 提示：`↵` 选择 · `↑↓` 导航 · `Esc` 取消。
+
+### 首次配置
+
+```bash
+# 1. 安装
+pi install git:github.com/wuyaos/pi-packages
+
+# 2. 打开菜单（若尚未配置 WebDAV，会先进入设置向导）
+/sync
+
+# 3. 如需修改：Configure Sync Settings
+#    填写 URL / 用户名 / 密码
+#    建议：密码填 $PI_WEBDAV_PASS，并在 shell 中 export 该环境变量
+
+# 4. 主力机 → Upload Backup (Backup to cloud)
+# 5. 新机器（安装并配置后）→ Download Backup (Restore from cloud)
+```
+
+### 会同步哪些内容
+
+| 组件 | 默认 | 说明 |
+|------|------|------|
+| Config | 开 | `models.json`、`settings.json`、`auth.json` |
+| Skills | 开 | 整个 `~/.pi/agent/skills` |
+| Extensions | 开 | `~/.pi/agent/extensions`（zip 中会排除 sync 插件自身） |
+| Sessions | 关 | `~/.pi/agent/sessions/` 下按项目分目录的会话历史；在 **Configure Sync Settings → Session Projects** 中勾选要同步的项目 |
+
+可在 **Configure Sync Settings** 中分别开关。
+
+### Sessions（可选）
+
+会话历史按项目 cwd 存放在 `~/.pi/agent/sessions/<projectDir>/`。**Session Projects** 子菜单会列出本机所有项目目录，勾选你想备份的那些。
+
+- 在 **Configure Sync Settings** 中打开 **Backup Sessions**。
+- 打开 **Session Projects** 逐个勾选项目（可用 **Select All** / **Reset list** 快捷全选/清空）。
+- 列表模式（可切换）：
+  - **白名单模式**：只备份勾选的项目，空列表 = 全部不备份。
+  - **黑名单模式**：跳过勾选的项目，空列表 = 全部备份。
+- 恢复时会以 *合并* 方式写入本地 `~/.pi/agent/sessions/`——会话文件名为唯一的时间戳+uuid，不会覆盖或删除本地已有会话。
+
+> 注意：项目目录名由项目路径编码而来，备份在 A 机器上制作，恢复到 B 机器时只会落到相同项目路径对应的项目目录中。
+
+### 备份文件名
+
+归档文件形如：
+
+```text
+pi_sync_backup_2026-7-14_20260714120000_windows11.zip
+```
+
+末尾的平台标签（`windows11` / `windows10` / `macos` / `linux`）标明该备份由哪类主机生成。
+
+### 恢复时的安全机制
+
+- 覆盖前，已有配置文件会生成带时间戳的 `.bak` 副本
+- 已有 skills / extensions 目录会先改名为 `*-backup-<timestamp>`，再替换/合并
+- 恢复前会展示计划，并要求确认
+- 恢复成功后可选择 reload agent runtime，以应用 skills / extensions
+
+## 新机引导（Windows，尚未安装 Pi）
+
+若还没装 Pi，也可先用辅助脚本拉取最新 zip：
+
+```powershell
+# 优先用环境变量，避免密钥进入 shell 历史
+$env:PI_WEBDAV_URL  = "https://your-webdav.example/dav/Pi"
+$env:PI_WEBDAV_USER = "your-user"
+$env:PI_WEBDAV_PASS = "your-app-password"
+.\pi-bootstrap.ps1
+```
+
+或使用占位符一行命令（运行前请替换）：
+
+```powershell
+$url="https://your-webdav.example/dav/Pi"; $user="your-user"; $pass="your-app-password"
+$pair="$user`:$pass"; $auth=[Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes($pair))
+$resp=Invoke-RestMethod -Uri $url -Method PROPFIND -Headers @{Authorization="Basic $auth";Depth="1"} -ContentType "application/xml"
+$files=([regex]'<d:href>([^<]+)</d:href>').Matches($resp) | %{$_.Groups[1].Value} | ?{$_ -match "pi_sync_backup_.*\.zip$"} | Sort-Object -Descending
+$latest=$files[0]; $name=Split-Path $latest -Leaf
+Invoke-WebRequest -Uri "$url/$name" -Headers @{Authorization="Basic $auth"} -OutFile "$env:TEMP\$name"
+```
+
+之后安装 Pi，后续更新用 `/sync` → **Download Backup** 即可。
+
+## 安全建议
+
+- WebDAV 凭证保存在本机 `~/.pi/agent/sync_config.json`
+- 优先使用**应用专用密码**（不要用主账号密码）
+- 更推荐环境变量引用：界面里密码填 `$PI_WEBDAV_PASS`，再在 shell profile 中 export
+- 若开启相关选项，备份可能包含 `auth.json` / API key —— 请把 WebDAV 目录当敏感数据对待
+- 切勿把真实 WebDAV 地址与凭证提交进 git
+
+## 故障排查
+
+| 现象 | 处理 |
+|------|------|
+| HTTP 401 / 403 | 检查用户名密码；改用应用专用密码；确认 URL 含正确 DAV 路径 |
+| PROPFIND 失败 / 列表为空 | 服务端可能禁用 PROPFIND；换 WebDAV 提供商；确认允许 Depth:1 |
+| tar / zip 报错 | PATH 中需要可用的 `tar`（Windows 10+ 自带；Git Bash / WSL 亦可） |
+| 恢复覆盖了本地内容 | 在 agent 目录旁查找 `*.bak-*` 与 `skills-backup-*` / `extensions-backup-*` |
+| 恢复后插件不见了 | 重新执行 `pi install git:github.com/wuyaos/pi-packages` —— 归档会排除 sync 包自身 |
+
+## 目录结构
+
+```text
+pi-sync/
+  package.json
+  LICENSE
+  README.md
+  README.zh-CN.md
+  pi-bootstrap.ps1
+  docs/
+    sync-menu.png       # /sync 菜单截图
+  extensions/
+    sync/
+      index.ts          # /sync 命令
+    _shared/
+      json-io.ts
+      enhanced-select.ts
+      spawn.ts
+      fetch-utils.ts
+      box-drawing.ts
+```
+
+## 更新日志
+
+### v1.0.1
+
+- 备份 zip 文件名增加主机平台标签（`windows11` / `macos` / `linux` 等）
+- 从 bootstrap 脚本示例中移除真实凭证
+- 增加 MIT `LICENSE`，扩充 README（安全、恢复保护、故障排查、菜单截图）
+
+### v1.0.0
+
+- 首次公开发布：基于 WebDAV 的交互式 `/sync` 菜单
+  - Upload Backup · Download Backup · Configure Sync Settings
+- Windows 新机引导脚本
+
+## 许可证
+
+MIT — 见 [LICENSE](./LICENSE)。
+
+## 致谢
+
+本开源项目已链接并获 [LINUX DO](https://linux.do) 社区认可。

package/extensions/_shared/box-drawing.ts

@@ -0,0 +1,58 @@
+/**
+ * Shared box-drawing utilities for TUI dashboards.
+ *
+ * Reusable across extensions (cost-tracker, session-manager, etc.).
+ * Import: import { … } from "../_shared/box-drawing"
+ */
+
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+
+// ── Unicode box-drawing characters ─────────────────────────────────────
+
+export const H = "─";
+export const V = "│";
+export const TL = "╭";
+export const TR = "╮";
+export const BL = "╰";
+export const BR = "╯";
+export const LT = "├";
+export const RT = "┤";
+
+// ── Border helpers ─────────────────────────────────────────────────────
+
+/** Top border with optional title (title rendered by caller, not inserted here). */
+export function topBorder(w: number, title: string, th: any): string {
+  const titleVis = visibleWidth(title);
+  const left = 2;
+  const right = w - 2 - left - titleVis;
+  return th.fg("accent", TL + H.repeat(left)) + title + th.fg("accent", H.repeat(Math.max(0, right)) + TR);
+}
+
+/** Simple top border without title. */
+export function topBorderPlain(w: number, th: any): string {
+  return th.fg("accent", TL + H.repeat(w - 2) + TR);
+}
+
+/** Bottom border. */
+export function bottomBorder(w: number, th: any): string {
+  return th.fg("borderMuted", BL + H.repeat(w - 2) + BR);
+}
+
+/** Mid horizontal divider. */
+export function midBorder(w: number, th: any): string {
+  return th.fg("borderMuted", LT + H.repeat(w - 2) + RT);
+}
+
+/** Pad text to a fixed visible width, truncating if too long. */
+export function sidePad(text: string, width: number): string {
+  const vis = visibleWidth(text);
+  if (vis >= width) return truncateToWidth(text, width);
+  return text + " ".repeat(width - vis);
+}
+
+/** Render a single content line inside a box: `│ content │`. */
+export function lineInBox(content: string, boxWidth: number, th: any): string {
+  const contentW = boxWidth - 4;
+  if (contentW <= 0) return th.fg("borderMuted", V) + V;
+  return th.fg("borderMuted", V) + " " + sidePad(content, contentW) + " " + th.fg("borderMuted", V);
+}