@pencil-agent/nano-pencil 1.14.2 → 1.14.3

package/dist/build-meta.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.14.2",
-  "commitHash": "62cd264",
+  "version": "1.14.3",
+  "commitHash": "1a4f55a",
   "branch": "main",
-  "builtAt": "2026-05-26T18:24:58.388Z"
+  "builtAt": "2026-05-27T01:43:40.032Z"
 }

package/dist/builtin-extensions.d.ts

@@ -5,6 +5,7 @@
  * [HERE]: builtin-extensions.ts - built-in extension registry for NanoPencil
  */
 export type BuiltinExtensionRiskLevel = "passive" | "command" | "tool" | "background" | "write-capable";
+export type BuiltinExtensionTestContract = "lifecycle" | "external-process" | "resource-discovery" | "write-guard";
 export interface BuiltinExtension {
     id: string;
     category: "default" | "optional" | "package";
@@ -14,6 +15,9 @@ export interface BuiltinExtension {
     startsTimers: boolean;
     writesWorkspace: boolean;
     externalProcess: boolean;
+    resourceDiscovery?: boolean;
+    testContracts?: readonly BuiltinExtensionTestContract[];
+    testFiles?: readonly string[];
 }
 export declare const builtInExtensions: readonly BuiltinExtension[];
 /**

package/dist/builtin-extensions.js

@@ -33,29 +33,29 @@ const BUNDLED_RECAP_EXTENSION = join(__dirname, "extensions", "defaults", "recap
 const BUNDLED_DEBUG_EXTENSION = join(__dirname, "extensions", "defaults", "debug", "index.js");
 const BUNDLED_MCP_EXTENSION = join(__dirname, "extensions", "defaults", "mcp", "index.js");
 export const builtInExtensions = [
-    { id: "diagnostics", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: true, writesWorkspace: false, externalProcess: false },
-    { id: "sal", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "diagnostics", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: true, writesWorkspace: false, externalProcess: false, testContracts: ["lifecycle"], testFiles: ["test/diagnostic-buffer-throttle.test.ts", "test/diagnostics-runtime.test.ts"] },
+    { id: "sal", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false, testContracts: ["lifecycle"], testFiles: ["test/sal-lifecycle.test.ts"] },
     { id: "token-save", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
-    { id: "nanomem", category: "package", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
-    { id: "link-world", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true },
-    { id: "browser", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true },
+    { id: "nanomem", category: "package", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false, testContracts: ["lifecycle"], testFiles: ["packages/mem-core/test/extension-commands.test.ts"] },
+    { id: "link-world", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true, resourceDiscovery: true, testContracts: ["external-process", "resource-discovery"], testFiles: ["test/link-world-extension-registration.test.ts"] },
+    { id: "browser", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true, resourceDiscovery: true, testContracts: ["external-process", "resource-discovery"], testFiles: ["test/browser-extension-registration.test.ts"] },
     { id: "security-audit", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
-    { id: "soul", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
-    { id: "presence", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: true, startsTimers: true, writesWorkspace: false, externalProcess: false },
+    { id: "soul", category: "default", defaultEnabled: true, riskLevel: "passive", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "presence", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: true, startsTimers: true, writesWorkspace: false, externalProcess: false, testContracts: ["lifecycle"], testFiles: ["test/presence-opening.test.ts", "test/presence-locale.test.ts"] },
     { id: "interview", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
-    { id: "grub", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true },
-    { id: "loop", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: true, writesWorkspace: false, externalProcess: false },
+    { id: "grub", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true, testContracts: ["lifecycle", "external-process"], testFiles: ["test/grub-controller.test.ts"] },
+    { id: "loop", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: true, writesWorkspace: false, externalProcess: false, testContracts: ["lifecycle"], testFiles: ["test/loop-lifecycle.test.ts"] },
     { id: "plan", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
-    { id: "discipline", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
-    { id: "subagent", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true },
-    { id: "team", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true },
-    { id: "idle-think", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: true, startsTimers: true, writesWorkspace: false, externalProcess: true },
+    { id: "discipline", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false, resourceDiscovery: true, testContracts: ["resource-discovery"], testFiles: ["test/discipline-extension.test.ts", "test/extension-smoke.test.ts"] },
+    { id: "subagent", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true, testContracts: ["external-process"], testFiles: ["test/subagent-parser.test.ts", "test/worktree-manager.test.ts"] },
+    { id: "team", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true, testContracts: ["lifecycle", "external-process"], testFiles: ["test/team-runtime.test.ts"] },
+    { id: "idle-think", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: true, startsTimers: true, writesWorkspace: false, externalProcess: true, testContracts: ["lifecycle", "external-process"], testFiles: ["test/idle-think-runtime.test.ts", "test/extension-smoke.test.ts"] },
     { id: "btw", category: "default", defaultEnabled: true, riskLevel: "command", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
     { id: "recap", category: "default", defaultEnabled: true, riskLevel: "command", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
     { id: "debug", category: "default", defaultEnabled: true, riskLevel: "command", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
-    { id: "mcp", category: "default", defaultEnabled: true, riskLevel: "command", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true },
-    { id: "simplify", category: "optional", defaultEnabled: false, riskLevel: "write-capable", requiresUI: false, startsTimers: false, writesWorkspace: true, externalProcess: true },
-    { id: "export-html", category: "optional", defaultEnabled: false, riskLevel: "write-capable", requiresUI: false, startsTimers: false, writesWorkspace: true, externalProcess: false },
+    { id: "mcp", category: "default", defaultEnabled: true, riskLevel: "command", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true, resourceDiscovery: true, testContracts: ["external-process", "resource-discovery"], testFiles: ["test/resource-discovery-contract.test.ts"] },
+    { id: "simplify", category: "optional", defaultEnabled: false, riskLevel: "write-capable", requiresUI: false, startsTimers: false, writesWorkspace: true, externalProcess: true, testContracts: ["external-process", "write-guard"], testFiles: ["test/simplify-extension.test.ts"] },
+    { id: "export-html", category: "optional", defaultEnabled: false, riskLevel: "write-capable", requiresUI: false, startsTimers: false, writesWorkspace: true, externalProcess: false, testContracts: ["write-guard"], testFiles: ["test/extension-smoke.test.ts", "test/export-html-branch-navigation.test.ts"] },
 ];
 /** Find package root from current module location (containing package.json with nano-pencil related name) */
 function findPackageRoot(startDir) {

package/dist/core/i18n/slash-commands.d.ts

@@ -5,6 +5,16 @@
  * [HERE]: core/i18n/slash-commands.ts - English slash command translations
  */
 export declare const slashCommands: {
+    categories: {
+        core: string;
+        model: string;
+        memory: string;
+        session: string;
+        workflow: string;
+        agents: string;
+        tools: string;
+        admin: string;
+    };
     settings: string;
     model: string;
     "agent-loop": string;
@@ -24,6 +34,7 @@ export declare const slashCommands: {
     usage: string;
     changelog: string;
     hotkeys: string;
+    resources: string;
     fork: string;
     tree: string;
     login: string;

package/dist/core/i18n/slash-commands.js

@@ -5,16 +5,26 @@
  * [HERE]: core/i18n/slash-commands.ts - English slash command translations
  */
 export const slashCommands = {
+    categories: {
+        core: "Core",
+        model: "Models",
+        memory: "Memory",
+        session: "Sessions",
+        workflow: "Workflows",
+        agents: "Agents",
+        tools: "Tools",
+        admin: "Admin",
+    },
     settings: "Open settings menu",
     model: "Select model (opens selector UI)",
-    "agent-loop": "Set standard or weak-model-compatible agent loop for this session",
-    "scoped-models": "Enable/disable models for Ctrl+P cycling",
+    "agent-loop": "Choose how the agent keeps working through a task",
+    "scoped-models": "Choose which models appear in quick switching",
     apikey: "Update API key for current provider",
     mcp: "Manage MCP servers (list, enable, disable)",
     soul: "Show AI personality and stats (Soul)",
     persona: "Switch AI persona/personality pack",
     memory: "Show project memory and knowledge (NanoMem)",
-    dream: "Consolidate project memory (NanoMem)",
+    dream: "Refresh long-term project memory (NanoMem)",
     export: "Export session to HTML file",
     share: "Share session as a secret GitHub gist",
     copy: "Copy last agent message to clipboard",
@@ -24,6 +34,7 @@ export const slashCommands = {
     usage: "Show token usage and cost stats",
     changelog: "Show changelog entries",
     hotkeys: "Show all keyboard shortcuts",
+    resources: "Show loaded extensions, prompts, skills, and themes",
     fork: "Create a new fork from a previous message",
     tree: "Navigate session tree (switch branches)",
     login: "Login with OAuth provider",
@@ -34,7 +45,7 @@ export const slashCommands = {
     compact: "Manually compact the session context",
     resume: "Resume a different session",
     reload: "Reload extensions, skills, prompts, and themes",
-    "link-world": "Install link-world for internet access (Twitter, YouTube, etc.)",
+    "link-world": "Set up internet access tools",
     quit: "Quit NanoPencil",
     language: "Switch language (English/Chinese)",
 };

package/dist/core/i18n/slash-commands.zh.d.ts

@@ -5,6 +5,16 @@
  * [HERE]: core/i18n/slash-commands.zh.ts - Chinese slash command translations
  */
 export declare const slashCommands: {
+    categories: {
+        core: string;
+        model: string;
+        memory: string;
+        session: string;
+        workflow: string;
+        agents: string;
+        tools: string;
+        admin: string;
+    };
     settings: string;
     model: string;
     "agent-loop": string;
@@ -24,6 +34,7 @@ export declare const slashCommands: {
     usage: string;
     changelog: string;
     hotkeys: string;
+    resources: string;
     fork: string;
     tree: string;
     login: string;

package/dist/core/i18n/slash-commands.zh.js

@@ -5,16 +5,26 @@
  * [HERE]: core/i18n/slash-commands.zh.ts - Chinese slash command translations
  */
 export const slashCommands = {
+    categories: {
+        core: "核心",
+        model: "模型",
+        memory: "记忆",
+        session: "会话",
+        workflow: "工作流",
+        agents: "Agent",
+        tools: "工具",
+        admin: "管理",
+    },
     settings: "打开设置菜单",
     model: "选择模型（打开选择器界面）",
-    "agent-loop": "设置本会话的 standard/弱模型兼容 agent loop",
-    "scoped-models": "启用/禁用 Ctrl+P 循环的模型",
+    "agent-loop": "选择 agent 推进任务的方式",
+    "scoped-models": "选择快速切换里出现的模型",
     apikey: "更新当前提供商的 API 密钥",
     mcp: "管理 MCP 服务器（列出、启用、禁用）",
     soul: "显示 AI 人格和统计（灵魂）",
     persona: "切换 AI 人格/个性包",
     memory: "显示项目记忆和知识（纳米记忆）",
-    dream: "整合项目记忆（纳米记忆）",
+    dream: "刷新长期项目记忆（纳米记忆）",
     export: "将会话导出为 HTML 文件",
     share: "将会话分享为保密的 GitHub gist",
     copy: "复制上一条 AI 消息到剪贴板",
@@ -24,6 +34,7 @@ export const slashCommands = {
     usage: "显示 token 使用量和费用统计",
     changelog: "显示更新日志条目",
     hotkeys: "显示所有键盘快捷键",
+    resources: "显示已加载的扩展、提示、技能和主题",
     fork: "从上一条消息创建新分支",
     tree: "导航会话树（切换分支）",
     login: "通过 OAuth 提供商登录",
@@ -34,7 +45,7 @@ export const slashCommands = {
     compact: "手动压缩会话上下文",
     resume: "恢复其他会话",
     reload: "重新加载扩展、技能、提示和主题",
-    "link-world": "安装 link-world 以获得互联网访问（Twitter、YouTube 等）",
+    "link-world": "设置联网访问工具",
     quit: "退出 NanoPencil",
     language: "切换语言（English/中文）",
 };

package/dist/core/runtime/slash-command-catalog.d.ts

@@ -7,11 +7,12 @@
 import type { ResourceLoader } from "../config/resource-loader.js";
 import type { ExtensionRunner } from "../extensions/index.js";
 import type { PromptTemplate } from "../prompt/prompt-templates.js";
-import { getLocalizedCommands, type SlashCommandInfo } from "../slash-commands.js";
+import { getLocalizedCommands, type SlashCommandInfo, type SlashCommandCategory } from "../slash-commands.js";
 export interface SessionSlashCommandDescriptor {
     name: string;
     description?: string;
     source: "builtin" | SlashCommandInfo["source"];
+    category?: SlashCommandCategory;
 }
 type Translate = Parameters<typeof getLocalizedCommands>[0];
 export interface SlashCommandCatalogSource {

package/dist/core/runtime/slash-command-catalog.js

@@ -1,4 +1,4 @@
-import { BUILTIN_SLASH_COMMANDS, getLocalizedCommands, } from "../slash-commands.js";
+import { BUILTIN_SLASH_COMMANDS, getLocalizedCommands, inferSlashCommandCategory, } from "../slash-commands.js";
 function normalizeLocation(source) {
     if (source === "user" || source === "project" || source === "path") {
         return source;
@@ -16,6 +16,7 @@ function getExtensionCommands(runner, reservedBuiltins) {
         name: command.name,
         description: command.description,
         path: extensionPath,
+        category: inferSlashCommandCategory(command.name, "extension"),
     })) ?? []);
 }
 export function buildSessionSlashCommands(source, translate) {
@@ -23,22 +24,26 @@ export function buildSessionSlashCommands(source, translate) {
         name: command.name,
         description: command.description,
         source: "builtin",
+        category: command.category,
     }));
     const reservedBuiltins = getReservedBuiltinNames();
     const extensionCommands = getExtensionCommands(source.extensionRunner, reservedBuiltins).map((command) => ({
         name: command.name,
         description: command.description,
         source: "extension",
+        category: command.category,
     }));
     const promptCommands = source.promptTemplates.map((template) => ({
         name: template.name,
         description: template.description,
         source: "prompt",
+        category: inferSlashCommandCategory(template.name, "prompt"),
     }));
     const skillCommands = source.resourceLoader.getSkills().skills.map((skill) => ({
         name: `skill:${skill.name}`,
         description: skill.description,
         source: "skill",
+        category: inferSlashCommandCategory(skill.name, "skill"),
     }));
     return [
         ...builtins,
@@ -53,12 +58,14 @@ export function buildExtensionSlashCommands(source) {
         name: command.name,
         description: command.description,
         source: "extension",
+        category: command.category,
         path: command.path,
     }));
     const templates = source.promptTemplates.map((template) => ({
         name: template.name,
         description: template.description,
         source: "prompt",
+        category: inferSlashCommandCategory(template.name, "prompt"),
         location: normalizeLocation(template.source),
         path: template.filePath,
     }));
@@ -68,6 +75,7 @@ export function buildExtensionSlashCommands(source) {
         name: `skill:${skill.name}`,
         description: skill.description,
         source: "skill",
+        category: inferSlashCommandCategory(skill.name, "skill"),
         location: normalizeLocation(skill.source),
         path: skill.filePath,
     }));

package/dist/core/slash-commands.d.ts

@@ -1,25 +1,33 @@
 /**
- * [WHO]: SlashCommandInfo, BuiltinSlashCommand, slashCommand definitions, getLocalizedCommands()
+ * [WHO]: SlashCommandInfo, BuiltinSlashCommand, slashCommand definitions, category helpers, getLocalizedCommands()
  * [FROM]: No external dependencies
  * [TO]: Consumed by modes/interactive/interactive-mode.ts, modes/acp/acp-mode.ts
  * [HERE]: core/slash-commands.ts - slash command types and registry
  */
 export type SlashCommandSource = "extension" | "prompt" | "skill";
 export type SlashCommandLocation = "user" | "project" | "path";
+export type SlashCommandCategory = "core" | "model" | "memory" | "session" | "workflow" | "agents" | "tools" | "admin";
 export interface SlashCommandInfo {
     name: string;
     description?: string;
     source: SlashCommandSource;
+    category?: SlashCommandCategory;
     location?: SlashCommandLocation;
     path?: string;
 }
 export interface BuiltinSlashCommand {
     name: string;
     descriptionKey: string;
+    category: SlashCommandCategory;
 }
 export declare const BUILTIN_SLASH_COMMANDS: ReadonlyArray<BuiltinSlashCommand>;
+export declare function inferSlashCommandCategory(name: string, source?: SlashCommandSource): SlashCommandCategory;
+export declare function getSlashCommandCategoryLabel(category: SlashCommandCategory, t: (key: string) => string): string;
+export declare function formatSlashCommandDescription(description: string | undefined, category: SlashCommandCategory | undefined, t: (key: string) => string): string | undefined;
 export interface LocalizedSlashCommand {
     name: string;
     description: string;
+    category: SlashCommandCategory;
+    categoryLabel: string;
 }
 export declare function getLocalizedCommands(t: (key: string) => string): LocalizedSlashCommand[];

package/dist/core/slash-commands.js

@@ -1,40 +1,85 @@
 export const BUILTIN_SLASH_COMMANDS = [
-    { name: "settings", descriptionKey: "slash.settings" },
-    { name: "model", descriptionKey: "slash.model" },
-    { name: "agent-loop", descriptionKey: "slash.agent-loop" },
-    { name: "scoped-models", descriptionKey: "slash.scoped-models" },
-    { name: "apikey", descriptionKey: "slash.apikey" },
-    { name: "mcp", descriptionKey: "slash.mcp" },
-    { name: "soul", descriptionKey: "slash.soul" },
-    { name: "persona", descriptionKey: "slash.persona" },
-    { name: "memory", descriptionKey: "slash.memory" },
-    { name: "dream", descriptionKey: "slash.dream" },
-    { name: "export", descriptionKey: "slash.export" },
-    { name: "share", descriptionKey: "slash.share" },
-    { name: "copy", descriptionKey: "slash.copy" },
-    { name: "name", descriptionKey: "slash.name" },
-    { name: "session", descriptionKey: "slash.session" },
-    { name: "status", descriptionKey: "slash.status" },
-    { name: "usage", descriptionKey: "slash.usage" },
-    { name: "changelog", descriptionKey: "slash.changelog" },
-    { name: "hotkeys", descriptionKey: "slash.hotkeys" },
-    { name: "fork", descriptionKey: "slash.fork" },
-    { name: "tree", descriptionKey: "slash.tree" },
-    { name: "login", descriptionKey: "slash.login" },
-    { name: "logout", descriptionKey: "slash.logout" },
-    { name: "new", descriptionKey: "slash.new" },
-    { name: "update", descriptionKey: "slash.update" },
-    { name: "reinstall", descriptionKey: "slash.reinstall" },
-    { name: "compact", descriptionKey: "slash.compact" },
-    { name: "resume", descriptionKey: "slash.resume" },
-    { name: "reload", descriptionKey: "slash.reload" },
-    { name: "link-world", descriptionKey: "slash.link-world" },
-    { name: "language", descriptionKey: "slash.language" },
-    { name: "quit", descriptionKey: "slash.quit" },
+    { name: "settings", descriptionKey: "slash.settings", category: "core" },
+    { name: "model", descriptionKey: "slash.model", category: "model" },
+    { name: "agent-loop", descriptionKey: "slash.agent-loop", category: "model" },
+    { name: "scoped-models", descriptionKey: "slash.scoped-models", category: "model" },
+    { name: "apikey", descriptionKey: "slash.apikey", category: "model" },
+    { name: "mcp", descriptionKey: "slash.mcp", category: "tools" },
+    { name: "soul", descriptionKey: "slash.soul", category: "memory" },
+    { name: "persona", descriptionKey: "slash.persona", category: "core" },
+    { name: "memory", descriptionKey: "slash.memory", category: "memory" },
+    { name: "dream", descriptionKey: "slash.dream", category: "memory" },
+    { name: "export", descriptionKey: "slash.export", category: "tools" },
+    { name: "share", descriptionKey: "slash.share", category: "tools" },
+    { name: "copy", descriptionKey: "slash.copy", category: "core" },
+    { name: "name", descriptionKey: "slash.name", category: "session" },
+    { name: "session", descriptionKey: "slash.session", category: "session" },
+    { name: "status", descriptionKey: "slash.status", category: "core" },
+    { name: "usage", descriptionKey: "slash.usage", category: "core" },
+    { name: "changelog", descriptionKey: "slash.changelog", category: "core" },
+    { name: "hotkeys", descriptionKey: "slash.hotkeys", category: "core" },
+    { name: "resources", descriptionKey: "slash.resources", category: "core" },
+    { name: "fork", descriptionKey: "slash.fork", category: "session" },
+    { name: "tree", descriptionKey: "slash.tree", category: "session" },
+    { name: "login", descriptionKey: "slash.login", category: "model" },
+    { name: "logout", descriptionKey: "slash.logout", category: "model" },
+    { name: "new", descriptionKey: "slash.new", category: "session" },
+    { name: "update", descriptionKey: "slash.update", category: "admin" },
+    { name: "reinstall", descriptionKey: "slash.reinstall", category: "admin" },
+    { name: "compact", descriptionKey: "slash.compact", category: "session" },
+    { name: "resume", descriptionKey: "slash.resume", category: "session" },
+    { name: "reload", descriptionKey: "slash.reload", category: "admin" },
+    { name: "link-world", descriptionKey: "slash.link-world", category: "tools" },
+    { name: "language", descriptionKey: "slash.language", category: "core" },
+    { name: "quit", descriptionKey: "slash.quit", category: "core" },
 ];
+export function inferSlashCommandCategory(name, source) {
+    if (source === "prompt")
+        return "workflow";
+    if (source === "skill")
+        return "tools";
+    if (name === "dream" || name === "memory" || name.startsWith("mem-"))
+        return "memory";
+    if (name === "team" || name.startsWith("team:") || name === "subagent" || name.startsWith("subagent:"))
+        return "agents";
+    if (name === "grub" ||
+        name === "loop" ||
+        name === "plan" ||
+        name.startsWith("plan:") ||
+        name === "recap" ||
+        name === "btw" ||
+        name === "interview" ||
+        name === "grill-me" ||
+        name === "simplify") {
+        return "workflow";
+    }
+    if (name === "browser" || name === "figma" || name === "link-world" || name === "export")
+        return "tools";
+    if (name === "debug" ||
+        name === "set-locale" ||
+        name === "report-issue" ||
+        name === "tokensave" ||
+        name === "security" ||
+        name.startsWith("security-") ||
+        name.startsWith("sal:")) {
+        return "admin";
+    }
+    return "tools";
+}
+export function getSlashCommandCategoryLabel(category, t) {
+    return t(`slash.categories.${category}`);
+}
+export function formatSlashCommandDescription(description, category, t) {
+    if (!description || !category)
+        return description;
+    const label = getSlashCommandCategoryLabel(category, t);
+    return label && !label.startsWith("slash.") ? `${label} · ${description}` : description;
+}
 export function getLocalizedCommands(t) {
     return BUILTIN_SLASH_COMMANDS.map((cmd) => ({
         name: cmd.name,
         description: t(cmd.descriptionKey),
+        category: cmd.category,
+        categoryLabel: getSlashCommandCategoryLabel(cmd.category, t),
     }));
 }

package/dist/extensions/defaults/browser/index.js

@@ -328,7 +328,7 @@ export default function browserExtension(api) {
         ensureBrowserWorkspace();
     });
     api.registerCommand("browser", {
-        description: "Browser Harness setup, status, reload, and workspace information",
+        description: "Set up or inspect browser automation tools",
         getArgumentCompletions: (argumentPrefix) => {
             const prefix = argumentPrefix.trim();
             const values = ["install", "status", "setup", "reload", "workspace", "help"]

package/dist/extensions/defaults/debug/index.js

@@ -5,7 +5,7 @@
  * [HERE]: extensions/defaults/debug/index.ts - system diagnostics with three-layer analysis through full agent loop
  */
 import { Box, Container, Spacer, Text } from "@pencil-agent/tui";
-import { collectSystemInfo, collectModelInfo, collectSessionInfo, collectConfigInfo, collectGitInfo, collectAgentState, sanitizeForLLM, formatDiagnosticData, } from "./collectors.js";
+import { collectSystemInfo, collectModelInfo, collectSessionInfo, collectConfigInfo, collectGitInfo, collectAgentState, collectPreferencesInfo, sanitizeForLLM, formatDiagnosticData, } from "./collectors.js";
 const DEBUG_MESSAGE_TYPE = "debug";
 const DEBUG_PROMPT_PREFIX = "[DEBUG:";
 const DEBUG_TAG = "[DEBUG]";
@@ -55,6 +55,8 @@ function parseDebugArgs(args) {
         return { subcommand: "session" };
     if (trimmed === "model")
         return { subcommand: "model" };
+    if (trimmed === "preferences")
+        return { subcommand: "preferences" };
     return { subcommand: "full", issueDescription: args.trim() || undefined };
 }
 // ============================================================================
@@ -132,6 +134,15 @@ async function handleQuickSub(subcommand, ctx, api) {
                 : `> Collection failed: ${info.error}`;
             break;
         }
+        case "preferences": {
+            const info = await collectPreferencesInfo(ctx);
+            result = info.data
+                ? `| Preferences | |\n|---|---|\n${Object.entries(info.data)
+                    .map(([k, v]) => `| ${k} | ${typeof v === "string" ? v : JSON.stringify(v)} |`)
+                    .join("\n")}`
+                : `> Collection failed: ${info.error}`;
+            break;
+        }
     }
     api.sendMessage({
         customType: DEBUG_MESSAGE_TYPE,
@@ -170,7 +181,7 @@ export default async function debugExtension(api) {
         return container;
     });
     api.on("before_agent_start", (event) => {
-        if (!isDebugPrompt(event.prompt))
+        if (!isDebugPrompt(event.prompt) || event.prompt !== pendingDiagnosticPrompt)
             return;
         return { appendSystemPrompt: DEBUG_SYSTEM_PROMPT };
     });
@@ -180,12 +191,26 @@ export default async function debugExtension(api) {
         }
     });
     api.registerCommand("debug", {
-        description: "Run system diagnostics (/debug [env|session|model|preferences|<issue>])",
+        description: "Check NanoPencil health or investigate an issue. Usage: /debug [env|session|model|preferences|<issue>]",
+        getArgumentCompletions: (argumentPrefix) => {
+            const prefix = argumentPrefix.trim().toLowerCase();
+            const values = ["env", "session", "model", "preferences"]
+                .filter((value) => value.startsWith(prefix))
+                .map((value) => ({ value, label: value }));
+            return values.length > 0 ? values : null;
+        },
         handler: (args, ctx) => handleDebugCommand(args, ctx, api),
     });
     // Register /set-locale command
     api.registerCommand("set-locale", {
         description: "Set language preference (/set-locale zh|en)",
+        getArgumentCompletions: (argumentPrefix) => {
+            const prefix = argumentPrefix.trim().toLowerCase();
+            const values = ["zh", "en"]
+                .filter((value) => value.startsWith(prefix))
+                .map((value) => ({ value, label: value }));
+            return values.length > 0 ? values : null;
+        },
         handler: async (args, ctx) => {
             const trimmed = args.trim().toLowerCase();
             if (trimmed !== "zh" && trimmed !== "en") {

package/dist/extensions/defaults/link-world/index.js

@@ -325,7 +325,7 @@ export default function linkWorldExtension(api) {
         ensureLinkWorldWorkspace();
     });
     api.registerCommand("link-world", {
-        description: "Inspect, install, or troubleshoot the built-in internet access integration",
+        description: "Set up or inspect internet access tools",
         getArgumentCompletions: (argumentPrefix) => {
             const prefix = argumentPrefix.trim();
             const values = ["status", "doctor", "version", "install", "workspace", "help"]

package/dist/extensions/defaults/loop/cron/cron-scheduler.js

@@ -233,12 +233,30 @@ export function createCronScheduler(options) {
         }, WATCH_INTERVAL_MS);
     }
     async function enable() {
+        if (isKilled())
+            return;
         enabled = true;
         if (dir) {
             await acquireLock();
+            if (isKilled()) {
+                await releaseLock();
+                return;
+            }
             await loadTasks();
+            if (isKilled()) {
+                await releaseLock();
+                return;
+            }
             startWatching();
         }
+        if (isKilled()) {
+            if (watchIntervalId) {
+                clearInterval(watchIntervalId);
+                watchIntervalId = null;
+            }
+            await releaseLock();
+            return;
+        }
         intervalId = setInterval(check, TICK_MS);
         console.log("[Cron-Scheduler] Scheduler enabled and ticking");
     }
@@ -266,6 +284,7 @@ export function createCronScheduler(options) {
         },
         stop() {
             killed = true;
+            enabled = false;
             if (intervalId) {
                 clearInterval(intervalId);
                 intervalId = null;

package/dist/extensions/defaults/security-audit/index.js

@@ -99,7 +99,7 @@ function auditAndGateToolCall(api, event, ctx) {
 export default function securityAuditExtension(api) {
     // /security - Show security dashboard
     api.registerCommand("security", {
-        description: "Show security audit dashboard and logs",
+        description: "Show recent security warnings and blocked actions",
         handler: async (_args, ctx) => {
             const logger = getLogger(ctx);
             const stats = logger.getStats();
@@ -133,7 +133,7 @@ export default function securityAuditExtension(api) {
     });
     // /security-logs - Show detailed logs
     api.registerCommand("security-logs", {
-        description: "Show detailed security audit logs",
+        description: "Show detailed security event history",
         handler: async (args, ctx) => {
             const logger = getLogger(ctx);
             const limit = parseInt(args) || 50;
@@ -158,7 +158,7 @@ export default function securityAuditExtension(api) {
     });
     // /security-stats - Show statistics
     api.registerCommand("security-stats", {
-        description: "Show security audit statistics",
+        description: "Show security event counts",
         handler: async (_args, ctx) => {
             const logger = getLogger(ctx);
             const stats = logger.getStats();
@@ -189,7 +189,7 @@ export default function securityAuditExtension(api) {
     });
     // /security-clear - Clear logs
     api.registerCommand("security-clear", {
-        description: "Clear security audit logs",
+        description: "Clear saved security events",
         handler: async (_args, ctx) => {
             const logger = getLogger(ctx);
             logger.clear();