@pencil-agent/nano-pencil 1.14.2 → 1.14.4

package/dist/extensions/defaults/grub/grub-parser.js

@@ -1,10 +1,23 @@
 /**
- * [WHO]: parseGrubCommand, buildGrubHelp
+ * [WHO]: parseGrubCommand, buildGrubHelp, getGrubArgumentCompletions
  * [FROM]: Depends on ./grub-types
  * [TO]: Consumed by extension entry point (./index.ts)
  * [HERE]: extensions/defaults/grub/grub-parser.ts - /grub command parser with resume/status --json/--max-iter/--max-fail flags
  */
 import { grubText } from "./grub-i18n.js";
+const ROOT_COMPLETIONS = [
+    { value: "status", label: "status", description: "Show current progress" },
+    { value: "resume", label: "resume", description: "Continue a saved task" },
+    { value: "stop", label: "stop", description: "Stop the current task" },
+    { value: "help", label: "help", description: "Show usage help" },
+];
+const START_FLAG_COMPLETIONS = [
+    { value: "--max-iter", label: "--max-iter", description: "Limit total work rounds" },
+    { value: "--max-fail", label: "--max-fail", description: "Stop after repeated failed rounds" },
+];
+const STATUS_FLAG_COMPLETIONS = [
+    { value: "--json", label: "--json", description: "Show full saved details" },
+];
 function scanTokens(input) {
     const tokens = [];
     let current = "";
@@ -84,6 +97,23 @@ function tokenize(input) {
     }
     return { positional, flags };
 }
+function filterCompletions(items, argumentPrefix) {
+    const prefix = argumentPrefix.trim().toLowerCase();
+    const matches = items.filter((item) => item.value.startsWith(prefix));
+    return matches.length > 0 ? [...matches] : null;
+}
+export function getGrubArgumentCompletions(argumentPrefix, context) {
+    if (argumentPrefix.trim().startsWith("--")) {
+        const firstToken = context?.previousTokens[0]?.toLowerCase();
+        return filterCompletions(firstToken === "status" || firstToken === "list"
+            ? STATUS_FLAG_COMPLETIONS
+            : START_FLAG_COMPLETIONS, argumentPrefix);
+    }
+    if (!context || context.tokenIndex === 0) {
+        return filterCompletions(ROOT_COMPLETIONS, argumentPrefix);
+    }
+    return null;
+}
 function parsePositiveInt(value) {
     if (typeof value !== "string")
         return undefined;

package/dist/extensions/defaults/grub/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * [WHO]: grubExtension default export - registers /grub command, dual-phase prompts, resume support, feature-list validation, and grub renderer
+ * [WHO]: grubExtension default export - registers /grub command, completions, dual-phase prompts, resume support, feature-list validation, and grub renderer
  * [FROM]: Depends on @pencil-agent/agent-core, @pencil-agent/tui, core/extensions/types, core/runtime/event-bus, ./grub-controller, ./grub-format, ./grub-parser, ./grub-types, ./grub-harness, ./grub-prompts, ./grub-persistence, ./grub-turn
  * [TO]: Auto-loaded by builtin-extensions.ts as a default extension
  * [HERE]: extensions/defaults/grub/index.ts - autonomous iterative task runner with Anthropic-style long-running harness (feature-list.json + durable state + phase-specialized prompts)

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

@@ -1,5 +1,5 @@
 /**
- * [WHO]: grubExtension default export - registers /grub command, dual-phase prompts, resume support, feature-list validation, and grub renderer
+ * [WHO]: grubExtension default export - registers /grub command, completions, dual-phase prompts, resume support, feature-list validation, and grub renderer
  * [FROM]: Depends on @pencil-agent/agent-core, @pencil-agent/tui, core/extensions/types, core/runtime/event-bus, ./grub-controller, ./grub-format, ./grub-parser, ./grub-types, ./grub-harness, ./grub-prompts, ./grub-persistence, ./grub-turn
  * [TO]: Auto-loaded by builtin-extensions.ts as a default extension
  * [HERE]: extensions/defaults/grub/index.ts - autonomous iterative task runner with Anthropic-style long-running harness (feature-list.json + durable state + phase-specialized prompts)
@@ -10,7 +10,7 @@ import { GrubController } from "./grub-controller.js";
 import { describeTaskState, formatSnapshot, formatTaskState, } from "./grub-format.js";
 import { ensureHarnessArtifacts } from "./grub-harness.js";
 import { detectGrubLocale, grubText, languageName } from "./grub-i18n.js";
-import { buildGrubHelp, parseGrubCommand } from "./grub-parser.js";
+import { buildGrubHelp, getGrubArgumentCompletions, parseGrubCommand } from "./grub-parser.js";
 import { discoverActiveTasks, pruneStale } from "./grub-persistence.js";
 import { buildGrubCodingPrompt, buildGrubInitializerPrompt } from "./grub-prompts.js";
 import { resolveGrubTurn } from "./grub-turn.js";
@@ -288,7 +288,8 @@ export default async function grubExtension(api) {
         }
     };
     api.registerCommand("grub", {
-        description: "Dig through one autonomous task until it is complete, blocked, stopped, or fails.",
+        description: "Keep working on one task until it is done, stopped, or needs your help.",
+        getArgumentCompletions: getGrubArgumentCompletions,
         handler: handleGrubCommand,
     });
 }

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

@@ -183,11 +183,11 @@ export default async function interviewExtension(api) {
     api.registerMessageRenderer(GRILL_CUSTOM_TYPE, (message, _options, theme) => renderSafeCustomMessage(message, theme));
     // Register /interview command for manual clarification
     api.registerCommand("interview", {
-        description: "Clarify an ambiguous request and inject a refined intent.",
+        description: "Turn a rough request into clear next steps.",
         handler: async (args, ctx) => runInterviewCommand(api, args, ctx, "clarify"),
     });
     api.registerCommand("grill-me", {
-        description: "Stress-test a plan or unclear request with one-question-at-a-time follow-ups and recommended answers.",
+        description: "Challenge a plan with focused follow-up questions.",
         handler: async (args, ctx) => runInterviewCommand(api, args, ctx, "grill"),
     });
     // Register interview tool for Agent to call when needed

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

@@ -19,6 +19,14 @@ const NETWORK_ROUTING_SKILL_PATH = join(__dirname, "network-routing.md");
 const WORKSPACE_TEMPLATE_PATH = join(__dirname, "agent-workspace");
 const LINK_WORLD_CUSTOM_TYPE = "link-world-install";
 const DEFAULT_TIMEOUT_SECONDS = 120;
+const LINK_WORLD_COMMAND_COMPLETIONS = [
+    { value: "status", label: "status", description: "Show installed internet-access capabilities" },
+    { value: "doctor", label: "doctor", description: "Run agent-reach doctor diagnostics" },
+    { value: "version", label: "version", description: "Show installed agent-reach version" },
+    { value: "install", label: "install", description: "Show bundled installation guidance" },
+    { value: "workspace", label: "workspace", description: "Show the link-world workspace path" },
+    { value: "help", label: "help", description: "Show link-world commands" },
+];
 const LinkWorldAdminInputSchema = Type.Object({
     action: Type.Union([
         Type.Literal("status"),
@@ -325,12 +333,12 @@ export default function linkWorldExtension(api) {
         ensureLinkWorldWorkspace();
     });
     api.registerCommand("link-world", {
-        description: "Inspect, install, or troubleshoot the built-in internet access integration",
-        getArgumentCompletions: (argumentPrefix) => {
-            const prefix = argumentPrefix.trim();
-            const values = ["status", "doctor", "version", "install", "workspace", "help"]
-                .filter((value) => value.startsWith(prefix))
-                .map((value) => ({ value, label: value }));
+        description: "Set up or inspect internet access tools",
+        getArgumentCompletions: (argumentPrefix, context) => {
+            if (context && context.tokenIndex > 0)
+                return null;
+            const prefix = argumentPrefix.trim().toLowerCase();
+            const values = LINK_WORLD_COMMAND_COMPLETIONS.filter((item) => item.value.startsWith(prefix));
             return values.length > 0 ? values : null;
         },
         handler: async (args, _ctx) => {

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/loop/index.js

@@ -10,6 +10,40 @@ import { createCronScheduler, addCronTask, deleteCronTask, listCronTasks, getCro
 import { buildSchedulerHelp, parseSchedulerCommand } from "./scheduler-parser.js";
 const LOOP_CUSTOM_TYPE = "loop";
 const SCHEDULER_TICK_MS = 1000;
+const LOOP_ACTION_COMPLETIONS = [
+    { value: "list", label: "list", description: "Show scheduled tasks" },
+    { value: "status", label: "status", description: "Show scheduled tasks" },
+    { value: "pause", label: "pause", description: "Pause a scheduled task" },
+    { value: "resume", label: "resume", description: "Resume a paused task" },
+    { value: "run", label: "run", description: "Run a scheduled task now" },
+    { value: "cancel", label: "cancel", description: "Cancel a scheduled task" },
+    { value: "clear", label: "clear", description: "Remove session-only tasks" },
+    { value: "every", label: "every", description: "Schedule a repeated prompt or command" },
+    { value: "hourly", label: "hourly", description: "Run once per hour" },
+    { value: "daily", label: "daily", description: "Run once per day" },
+];
+const LOOP_FLAG_COMPLETIONS = [
+    { value: "--name", label: "--name", description: "Give the schedule a name" },
+    { value: "--max", label: "--max", description: "Stop after a number of runs" },
+    { value: "--quiet", label: "--quiet", description: "Hide per-run messages" },
+    { value: "--durable", label: "--durable", description: "Keep the schedule across sessions" },
+    { value: "-q", label: "-q", description: "Hide per-run messages" },
+    { value: "-d", label: "-d", description: "Keep the schedule across sessions" },
+];
+function matchLoopCompletions(completions, prefix) {
+    const matches = completions.filter((completion) => completion.value.startsWith(prefix));
+    return matches.length > 0 ? matches.map((completion) => ({ ...completion })) : null;
+}
+function getLoopArgumentCompletions(argumentPrefix, context) {
+    const prefix = argumentPrefix.trim().toLowerCase();
+    const isFirstToken = !context || context.tokenIndex === 0;
+    if (!isFirstToken && !prefix.startsWith("-"))
+        return null;
+    const completions = prefix.startsWith("-")
+        ? LOOP_FLAG_COMPLETIONS
+        : [...LOOP_ACTION_COMPLETIONS, ...LOOP_FLAG_COMPLETIONS];
+    return matchLoopCompletions(completions, prefix);
+}
 // Single unified scheduler per session
 const cronSchedulerByBus = new WeakMap();
 const apiByBus = new WeakMap();
@@ -420,6 +454,7 @@ export default async function loopExtension(api) {
     };
     api.registerCommand("loop", {
         description: "Schedule a recurring prompt or slash command for this session.",
+        getArgumentCompletions: getLoopArgumentCompletions,
         handler: handleLoopCommand,
     });
 }

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

@@ -22,9 +22,26 @@ const MCP_SKILL_PATH = join(__dirname, "mcp-management.md");
 const FIGMA_SKILL_PATH = join(__dirname, "figma-design.md");
 const FIGMA_DESKTOP_URL = "http://127.0.0.1:3845/mcp";
 const FIGMA_REMOTE_URL = "https://mcp.figma.com/mcp";
+const FIGMA_COMMAND_COMPLETIONS = [
+    { value: "help", label: "help", description: "Show setup steps" },
+    { value: "auth", label: "auth", description: "Sign in to Figma" },
+    { value: "remote", label: "remote", description: "Enable the remote MCP path" },
+    { value: "setup", label: "setup", description: "Probe and enable the best Figma path" },
+    { value: "status", label: "status", description: "Inspect the current connection" },
+    { value: "logout", label: "logout", description: "Remove saved Figma credentials" },
+    { value: "enable", label: "enable", description: "Enable the desktop MCP preset" },
+    { value: "disable", label: "disable", description: "Disable the desktop MCP preset" },
+];
 function getFigmaAuthStorage() {
     return AuthStorage.create(getAuthPath());
 }
+function getFigmaArgumentCompletions(argumentPrefix, context) {
+    if (context && context.tokenIndex > 0)
+        return null;
+    const prefix = argumentPrefix.trim().toLowerCase();
+    const values = FIGMA_COMMAND_COMPLETIONS.filter((item) => item.value.startsWith(prefix));
+    return values.length > 0 ? values.map((item) => ({ ...item })) : null;
+}
 async function getFigmaAccessToken() {
     return getFigmaAuthStorage().getApiKey("figma");
 }
@@ -123,6 +140,7 @@ async function probeFigmaRemoteEndpoint(token) {
 export default async function mcpExtension(api) {
     api.registerCommand("figma", {
         description: "Connect NanoPencil to Figma for generative design",
+        getArgumentCompletions: getFigmaArgumentCompletions,
         handler: async (args, ctx) => {
             const [rawAction, ...rest] = args.trim().split(/\s+/).filter(Boolean);
             const action = (rawAction || "help").toLowerCase();

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

@@ -17,6 +17,19 @@ const PLAN_ATTACHMENT_CONFIG = {
     TURNS_BETWEEN_ATTACHMENTS: 3,
     FULL_REMINDER_EVERY_N: 3,
 };
+const PLAN_ROOT_COMPLETIONS = [
+    { value: "open", label: "open", description: "Edit the current plan" },
+    { value: "exit", label: "exit", description: "Ask to leave plan mode" },
+    { value: "validate", label: "validate", description: "Check the current plan" },
+    { value: "approve", label: "approve", description: "Approve a teammate plan" },
+];
+function getPlanArgumentCompletions(argumentPrefix, context) {
+    if (context && context.tokenIndex > 0)
+        return null;
+    const prefix = argumentPrefix.trim().toLowerCase();
+    const values = PLAN_ROOT_COMPLETIONS.filter((value) => value.value.startsWith(prefix));
+    return values.length > 0 ? values.map((value) => ({ ...value })) : null;
+}
 function countHumanTurns(ctx) {
     return ctx.sessionManager.getBranch().filter((entry) => {
         if (entry.type !== "message")
@@ -169,17 +182,6 @@ export default async function planExtension(api) {
         // Display plan content
         displayPlan(api, ctx);
     };
-    api.registerCommand("plan", {
-        description: "Enable plan mode or view the current session plan",
-        getArgumentCompletions: (argumentPrefix) => {
-            const prefix = argumentPrefix.trim();
-            const values = ["open", "exit"]
-                .filter((value) => value.startsWith(prefix))
-                .map((value) => ({ value, label: value }));
-            return values.length > 0 ? values : null;
-        },
-        handler: handlePlanCommand,
-    });
     // =========================================================================
     // /plan:validate command - validate current plan structure
     // =========================================================================
@@ -259,6 +261,22 @@ export default async function planExtension(api) {
         description: "Approve a teammate's plan (for team leaders)",
         handler: handlePlanApproveCommand,
     });
+    api.registerCommand("plan", {
+        description: "Plan, edit, validate, approve, or exit the current session plan",
+        getArgumentCompletions: getPlanArgumentCompletions,
+        handler: async (args, ctx) => {
+            const [action, ...rest] = args.trim().split(/\s+/);
+            if (action === "validate") {
+                await handlePlanValidateCommand("", ctx);
+                return;
+            }
+            if (action === "approve") {
+                await handlePlanApproveCommand(rest.join(" "), ctx);
+                return;
+            }
+            await handlePlanCommand(args, ctx);
+        },
+    });
     // =========================================================================
     // Permission gating: block write tools in plan mode
     // =========================================================================

package/dist/extensions/defaults/presence/index.d.ts

@@ -2,15 +2,22 @@
  * [WHO]: Extension interface, AI-driven personalized greetings and idle cues
  * [FROM]: Depends on @pencil-agent/tui, core/extensions/types.js, core/i18n, node:path, node:url, node:fs
  * [TO]: Loaded by core/extensions/loader.ts as extension entry point
- * [HERE]: extensions/defaults/presence/index.ts - AI-generated opening + idle presence lines from memory (episodes/preferences/lessons) + git snapshot (branch/last commit/changed files) + soul personality traits, injects last MAX_RECENT_PRESENCE lines into agent systemPrompt per turn, configurable via settings.presence.enabled, canSendOpening guards against agent-is-busy race
+ * [HERE]: extensions/defaults/presence/index.ts - AI-generated opening + idle presence lines from memory (episodes/preferences/lessons) + git snapshot (branch/last commit/changed files) + soul personality traits and identity/style preferences, injects last MAX_RECENT_PRESENCE lines into agent systemPrompt per turn, configurable via settings.presence.enabled, canSendOpening guards against agent-is-busy race
  */
 import type { ExtensionAPI } from "../../../core/extensions/types.js";
-import { detectLanguageFromMemory } from "./presence-memory.js";
+import { collectIdentityPreferenceHighlights, detectLanguageFromMemory } from "./presence-memory.js";
 declare function getFallbackOpeningLines(locale?: "en" | "zh"): string[];
 declare function getFallbackIdleLines(locale?: "en" | "zh"): string[];
 declare function resolveBundledPackageEntry(packageName: "mem-core" | "soul-core"): string | undefined;
 declare function getOpeningDelayMs(): number;
 declare function importRuntimeModule<T>(moduleNames: string[], bundledPackageName?: "mem-core" | "soul-core"): Promise<T | undefined>;
+type PresenceSoulHints = {
+    traits: string[];
+    tone?: string;
+    identityPreferences: string[];
+};
+declare function collectSoulHints(soulManager: unknown): PresenceSoulHints;
+declare function buildPresenceSystemPrompt(locale: "en" | "zh", soulHints: PresenceSoulHints, kind: "opening" | "idle"): string;
 export default function presenceExtension(api: ExtensionAPI): Promise<void>;
 export declare const __testUtils: {
     getFallbackOpeningLines: typeof getFallbackOpeningLines;
@@ -18,6 +25,9 @@ export declare const __testUtils: {
     resolveBundledPackageEntry: typeof resolveBundledPackageEntry;
     importRuntimeModule: typeof importRuntimeModule;
     detectLanguageFromMemory: typeof detectLanguageFromMemory;
+    collectIdentityPreferenceHighlights: typeof collectIdentityPreferenceHighlights;
     getOpeningDelayMs: typeof getOpeningDelayMs;
+    collectSoulHints: typeof collectSoulHints;
+    buildPresenceSystemPrompt: typeof buildPresenceSystemPrompt;
 };
 export {};

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

@@ -2,7 +2,7 @@
  * [WHO]: Extension interface, AI-driven personalized greetings and idle cues
  * [FROM]: Depends on @pencil-agent/tui, core/extensions/types.js, core/i18n, node:path, node:url, node:fs
  * [TO]: Loaded by core/extensions/loader.ts as extension entry point
- * [HERE]: extensions/defaults/presence/index.ts - AI-generated opening + idle presence lines from memory (episodes/preferences/lessons) + git snapshot (branch/last commit/changed files) + soul personality traits, injects last MAX_RECENT_PRESENCE lines into agent systemPrompt per turn, configurable via settings.presence.enabled, canSendOpening guards against agent-is-busy race
+ * [HERE]: extensions/defaults/presence/index.ts - AI-generated opening + idle presence lines from memory (episodes/preferences/lessons) + git snapshot (branch/last commit/changed files) + soul personality traits and identity/style preferences, injects last MAX_RECENT_PRESENCE lines into agent systemPrompt per turn, configurable via settings.presence.enabled, canSendOpening guards against agent-is-busy race
  */
 import { Box, Container, Spacer, Text } from "@pencil-agent/tui";
 import { getLocale, tValue } from "../../../core/i18n/index.js";
@@ -11,7 +11,7 @@ import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { existsSync, realpathSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { collectMemoryHighlights, detectLanguageFromMemory, getMemoryDir, getProject, } from "./presence-memory.js";
+import { collectIdentityPreferenceHighlights, collectMemoryHighlights, detectLanguageFromMemory, getMemoryDir, getProject, } from "./presence-memory.js";
 const execFileAsync = promisify(execFile);
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PRESENCE_MESSAGE_TYPE = "presence";
@@ -125,8 +125,14 @@ async function importRuntimeModule(moduleNames, bundledPackageName) {
     }
     return undefined;
 }
+function normalizePreferenceText(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const text = value.trim().replace(/\s+/g, " ");
+    return text ? text.slice(0, 160) : undefined;
+}
 function collectSoulHints(soulManager) {
-    const out = { traits: [] };
+    const out = { traits: [], identityPreferences: [] };
     if (!soulManager || typeof soulManager !== "object")
         return out;
     try {
@@ -143,12 +149,38 @@ function collectSoulHints(soulManager) {
         const mood = profile?.emotionalState?.mood;
         if (typeof mood === "string")
             out.tone = mood;
+        const knownPreferences = profile?.userRelationship?.knownPreferences;
+        if (Array.isArray(knownPreferences)) {
+            out.identityPreferences = knownPreferences
+                .map(normalizePreferenceText)
+                .filter((text) => Boolean(text))
+                .slice(0, 5);
+        }
     }
     catch {
         /* fail-soft */
     }
     return out;
 }
+function mergeIdentityPreferences(...groups) {
+    const seen = new Set();
+    const out = [];
+    for (const group of groups) {
+        for (const value of group) {
+            const text = normalizePreferenceText(value);
+            if (!text)
+                continue;
+            const key = text.toLowerCase();
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push(text);
+            if (out.length >= 5)
+                return out;
+        }
+    }
+    return out;
+}
 function touch(state) {
     state.lastActivityAt = Date.now();
     state.idleReminderSent = false;
@@ -257,12 +289,12 @@ async function buildGreetingPrompt(state, detectedLocale, soulHints, kind = "ope
                     : "用户安静了几分钟。轻轻问候一下，别打扰他。一句话就够。",
                 "",
                 "要求:",
-                "- 像老朋友一样自然，不要太正式",
-                "- 简短随意",
+                "- 简短自然，不要太正式",
+                "- 如果有身份、语气、称呼或角色偏好，必须遵守",
                 kind === "idle" ? "- 不要重复你之前说过的开场白" : "- 如果有上下文，可以自然提一句",
                 "- 不要为了有话说而硬找话题",
                 "- 如果他只是在做很琐碎的事情，不需要特别提起，简单打个招呼就好",
-                "- 偏好和经验只是背景参考，不需要每次都引用，只在真正自然的时候带一句",
+                "- 普通偏好和经验只是背景参考；身份、语气、称呼和角色偏好不是背景，必须优先遵守",
                 "- 不要反复提同样的记忆或概念，要换着花样",
                 "",
                 "项目状态:",
@@ -283,6 +315,11 @@ async function buildGreetingPrompt(state, detectedLocale, soulHints, kind = "ope
                 for (const p of highlights.preferences)
                     lines.push(`- ${p}`);
             }
+            if (soulHints.identityPreferences.length > 0) {
+                lines.push("", "高优先级身份/语气/称呼约束:");
+                for (const p of soulHints.identityPreferences)
+                    lines.push(`- ${p}`);
+            }
             if (highlights.lessons.length > 0) {
                 lines.push("", "记下的经验:");
                 for (const l of highlights.lessons)
@@ -314,12 +351,12 @@ async function buildGreetingPrompt(state, detectedLocale, soulHints, kind = "ope
                     : "The user has been quiet for a few minutes. Drop a soft, non-pushy check-in. One short sentence.",
                 "",
                 "Requirements:",
-                "- Sound like a friend, not formal",
-                "- Short and casual",
+                "- Keep it short and natural, not formal",
+                "- If identity, tone, address, or role preferences are present, follow them",
                 kind === "idle" ? "- Do NOT repeat your earlier opening greeting" : "- If there's recent context, mention it naturally",
                 "- Don't force a topic just to have something to say",
                 "- If they're only doing trivial things (like creating an empty folder), don't mention it - just say hi",
-                "- Preferences and lessons are background context only - reference at most 1-2, only when it naturally fits",
+                "- Ordinary preferences and lessons are background context; identity, tone, address, and role preferences are high-priority constraints",
                 "- Don't keep bringing up the same memories or concepts repeatedly",
                 "",
                 "Project state:",
@@ -340,6 +377,11 @@ async function buildGreetingPrompt(state, detectedLocale, soulHints, kind = "ope
                 for (const p of highlights.preferences)
                     lines.push(`- ${p}`);
             }
+            if (soulHints.identityPreferences.length > 0) {
+                lines.push("", "High-priority identity/tone/address constraints:");
+                for (const p of soulHints.identityPreferences)
+                    lines.push(`- ${p}`);
+            }
             if (highlights.lessons.length > 0) {
                 lines.push("", "Lessons remembered:");
                 for (const l of highlights.lessons)
@@ -369,6 +411,22 @@ async function buildGreetingPrompt(state, detectedLocale, soulHints, kind = "ope
         return undefined;
     }
 }
+function buildPresenceSystemPrompt(locale, soulHints, kind) {
+    const traitsHint = soulHints.traits.length > 0
+        ? ` ${locale === "zh" ? "人格倾向" : "Personality tilt"}: ${soulHints.traits.map((t) => t.split(":")[0]).join(", ")}.`
+        : "";
+    const identityHint = soulHints.identityPreferences.length > 0
+        ? ` ${locale === "zh" ? "必须遵守这些身份/语气/称呼约束" : "Follow these identity/tone/address constraints"}: ${soulHints.identityPreferences.join(" | ")}.`
+        : "";
+    if (locale === "zh") {
+        return kind === "opening"
+            ? `生成一句简短自然的开场问候。不要覆盖已知身份设定。${identityHint}${traitsHint}`
+            : `生成一句简短、轻声、不打扰的问候。不要覆盖已知身份设定。${identityHint}${traitsHint}`;
+    }
+    return kind === "opening"
+        ? `Generate one brief, natural opening greeting. Do not override known identity settings.${identityHint}${traitsHint}`
+        : `Generate one brief, quiet, non-pushy check-in. Do not override known identity settings.${identityHint}${traitsHint}`;
+}
 function getLastUserMessage(ctx) {
     const entries = ctx.sessionManager.getEntries();
     for (let i = entries.length - 1; i >= 0; i -= 1) {
@@ -401,22 +459,15 @@ async function generatePresenceLine(api, ctx, state, kind) {
         return fallback();
     const lastUser = kind === "idle" ? getLastUserMessage(ctx) : undefined;
     const soulHints = collectSoulHints(ctx.getSoulManager());
-    const prompt = await buildGreetingPrompt(state, locale, soulHints, kind, lastUser);
+    const memoryIdentityPreferences = await collectIdentityPreferenceHighlights(state);
+    const presenceHints = {
+        ...soulHints,
+        identityPreferences: mergeIdentityPreferences(soulHints.identityPreferences, memoryIdentityPreferences),
+    };
+    const prompt = await buildGreetingPrompt(state, locale, presenceHints, kind, lastUser);
     if (!prompt)
         return fallback();
-    const systemPrompt = (() => {
-        const traitsHint = soulHints.traits.length > 0
-            ? ` Your key traits: ${soulHints.traits.map((t) => t.split(":")[0]).join(", ")}.`
-            : "";
-        if (locale === "zh") {
-            return kind === "opening"
-                ? `你是个程序员的好朋友，现在来打个招呼。说得随意自然点。${traitsHint}`
-                : `你是个程序员的好朋友。轻声问候，不打扰。一句话。${traitsHint}`;
-        }
-        return kind === "opening"
-            ? `You're a developer's coding buddy saying hi. Keep it casual and human.${traitsHint}`
-            : `You're a developer's coding buddy doing a quiet check-in. One short, non-pushy line.${traitsHint}`;
-    })();
+    const systemPrompt = buildPresenceSystemPrompt(locale, presenceHints, kind);
     try {
         const line = await ctx.completeSimple(systemPrompt, prompt);
         if (line && line.trim().length > 0 && line.trim().length < 200) {
@@ -650,5 +701,8 @@ export const __testUtils = {
     resolveBundledPackageEntry,
     importRuntimeModule,
     detectLanguageFromMemory,
+    collectIdentityPreferenceHighlights,
     getOpeningDelayMs,
+    collectSoulHints,
+    buildPresenceSystemPrompt,
 };

package/dist/extensions/defaults/presence/presence-memory.d.ts

@@ -1,5 +1,5 @@
 /**
- * [WHO]: PresenceMemoryEngine type, getMemoryDir(), getProject(), detectLanguageFromMemory(), collectMemoryHighlights()
+ * [WHO]: PresenceMemoryEngine type, getMemoryDir(), getProject(), detectLanguageFromMemory(), collectMemoryHighlights(), collectIdentityPreferenceHighlights()
  * [FROM]: Depends on node:os, node:path, node:fs for memory path discovery
  * [TO]: Consumed by extensions/defaults/presence/index.ts and presence tests
  * [HERE]: extensions/defaults/presence/presence-memory.ts - memory-derived locale and highlight selection for presence prompts
@@ -43,4 +43,5 @@ export declare function getMemoryDir(): string;
 export declare function getProject(): string;
 export declare function detectLanguageFromMemory(state: PresenceMemoryState): Promise<"en" | "zh" | undefined>;
 export declare function collectMemoryHighlights(state: PresenceMemoryState): Promise<MemoryHighlights>;
+export declare function collectIdentityPreferenceHighlights(state: PresenceMemoryState): Promise<string[]>;
 export {};

package/dist/extensions/defaults/presence/presence-memory.js

@@ -1,5 +1,5 @@
 /**
- * [WHO]: PresenceMemoryEngine type, getMemoryDir(), getProject(), detectLanguageFromMemory(), collectMemoryHighlights()
+ * [WHO]: PresenceMemoryEngine type, getMemoryDir(), getProject(), detectLanguageFromMemory(), collectMemoryHighlights(), collectIdentityPreferenceHighlights()
  * [FROM]: Depends on node:os, node:path, node:fs for memory path discovery
  * [TO]: Consumed by extensions/defaults/presence/index.ts and presence tests
  * [HERE]: extensions/defaults/presence/presence-memory.ts - memory-derived locale and highlight selection for presence prompts
@@ -7,6 +7,7 @@
 import { existsSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
+const IDENTITY_PREFERENCE_PATTERN = /(tone|style|speaking|speak|call(?:s|ed)?\s+(?:me|user|them)?|address|persona|role|identity|character|扮演|角色|人设|身份|语气|口吻|说话方式|称呼|叫我|雷姆|rem-like|rem\b)/i;
 export function getMemoryDir() {
     // Use the same memory directory as the main app.
     // Priority: env var > nanopencil default > legacy nanomem path.
@@ -152,6 +153,41 @@ export async function collectMemoryHighlights(state) {
     }
     return out;
 }
+export async function collectIdentityPreferenceHighlights(state) {
+    if (!state.memEngine)
+        return [];
+    try {
+        const entries = await state.memEngine.getAllEntries();
+        const prefPool = [
+            ...(entries.preferences ?? []),
+            ...entries.knowledge.filter((entry) => entry.type === "preference" || entry.tags.includes("preference")),
+            ...entries.lessons.filter((entry) => entry.type === "preference" || entry.tags.includes("preference")),
+        ].filter((entry) => entry.type === "preference" || entry.tags.includes("preference"));
+        const searchResults = await state.memEngine.searchEntries("tone style speaking call address persona role identity 称呼 语气 角色 扮演");
+        const candidates = [...prefPool, ...searchResults];
+        const seen = new Set();
+        const out = [];
+        for (const entry of candidates) {
+            const text = (entry.summary || entry.detail || entry.content || "").toString().trim().replace(/\s+/g, " ");
+            const label = (entry.name || "preference").toString().trim();
+            const searchable = `${label} ${text} ${(entry.tags || []).join(" ")}`;
+            if (!text || !IDENTITY_PREFERENCE_PATTERN.test(searchable))
+                continue;
+            const line = `${label || "preference"}: ${text.slice(0, 160)}`;
+            const key = line.toLowerCase();
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push(line);
+            if (out.length >= 5)
+                break;
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
 /** Randomly pick `count` items from array without replacement. */
 function shufflePick(arr, count) {
     if (count <= 0 || arr.length === 0)

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

@@ -3,6 +3,17 @@ import { createRecapRenderer } from "./recap-renderer.js";
 import { hasMeaningfulActivity, synthesizeSmartRecap } from "./recap-synthesizer.js";
 import { RECAP_DEFAULTS, RECAP_MESSAGE_TYPE } from "./recap-types.js";
 const RECAP_TIMEOUT_MS = 30_000;
+const RECAP_MODE_COMPLETIONS = [
+    { value: "--free", label: "--free", description: "Use the instant zero-token recap" },
+    { value: "--smart", label: "--smart", description: "Use an LLM-polished recap" },
+];
+function getRecapArgumentCompletions(argumentPrefix, context) {
+    if (context && context.tokenIndex > 0)
+        return null;
+    const prefix = argumentPrefix.trim().toLowerCase();
+    const values = RECAP_MODE_COMPLETIONS.filter((item) => item.value.startsWith(prefix));
+    return values.length > 0 ? values.map((item) => ({ ...item })) : null;
+}
 function emitFreeRecap(ctx, api) {
     const entries = ctx.sessionManager.getEntries();
     const recap = extractFreeRecap(entries);
@@ -99,6 +110,7 @@ export default async function recapExtension(api) {
     api.registerMessageRenderer(RECAP_MESSAGE_TYPE, createRecapRenderer());
     api.registerCommand("recap", {
         description: "Show a brief situational recap of the current task (goal, key facts, next decision). Free by default; add --smart for LLM-polished synthesis (costs tokens).",
+        getArgumentCompletions: getRecapArgumentCompletions,
         handler: (args, ctx) => handleRecapCommand(args, ctx, api),
     });
 }