@pencil-agent/nano-pencil 1.9.0 → 1.9.1

package/dist/core/extensions/runner.d.ts

@@ -82,8 +82,11 @@ export declare class ExtensionRunner {
     private shortcutDiagnostics;
     private commandDiagnostics;
     private readonly beforeAgentStartTimeoutMs;
+    private readonly beforeAgentStartTimeoutSentinel;
+    private beforeAgentStartTimeoutLastReported;
     constructor(extensions: Extension[], runtime: ExtensionRuntime, cwd: string, sessionManager: SessionManager, modelRegistry: ModelRegistry);
     private withTimeout;
+    private reportBeforeAgentStartTimeout;
     bindCore(actions: ExtensionActions, contextActions: ExtensionContextActions): void;
     bindCommandContext(actions?: ExtensionCommandContextActions): void;
     setUIContext(uiContext?: ExtensionUIContext): void;

package/dist/core/extensions/runner.js

@@ -105,6 +105,8 @@ export class ExtensionRunner {
     shortcutDiagnostics = [];
     commandDiagnostics = [];
     beforeAgentStartTimeoutMs = 1500;
+    beforeAgentStartTimeoutSentinel = Symbol("before_agent_start_timeout");
+    beforeAgentStartTimeoutLastReported = new Map();
     constructor(extensions, runtime, cwd, sessionManager, modelRegistry) {
         this.extensions = extensions;
         this.runtime = runtime;
@@ -115,7 +117,7 @@ export class ExtensionRunner {
     }
     async withTimeout(promise, timeoutMs) {
         return new Promise((resolve) => {
-            const timer = setTimeout(() => resolve(undefined), timeoutMs);
+            const timer = setTimeout(() => resolve(this.beforeAgentStartTimeoutSentinel), timeoutMs);
             promise
                 .then((value) => {
                 clearTimeout(timer);
@@ -123,10 +125,20 @@ export class ExtensionRunner {
             })
                 .catch(() => {
                 clearTimeout(timer);
-                resolve(undefined);
+                resolve(this.beforeAgentStartTimeoutSentinel);
             });
         });
     }
+    reportBeforeAgentStartTimeout(extensionPath) {
+        const now = Date.now();
+        const last = this.beforeAgentStartTimeoutLastReported.get(extensionPath) ?? 0;
+        // Rate-limit to once per minute per extension.
+        if (now - last < 60_000)
+            return;
+        this.beforeAgentStartTimeoutLastReported.set(extensionPath, now);
+        // Soft warning only; do not surface as user-facing extension error.
+        console.warn(`Extension before_agent_start timed out (${this.beforeAgentStartTimeoutMs}ms): ${extensionPath}`);
+    }
     bindCore(actions, contextActions) {
         // Copy actions into the shared runtime (all extension APIs reference this)
         this.runtime.sendMessage = actions.sendMessage;
@@ -556,12 +568,8 @@ export class ExtensionRunner {
                         systemPrompt: currentSystemPrompt,
                     };
                     const handlerResult = await this.withTimeout(handler(event, ctx), this.beforeAgentStartTimeoutMs);
-                    if (handlerResult === undefined) {
-                        this.emitError({
-                            extensionPath: ext.path,
-                            event: "before_agent_start",
-                            error: `handler timed out after ${this.beforeAgentStartTimeoutMs}ms`,
-                        });
+                    if (handlerResult === this.beforeAgentStartTimeoutSentinel) {
+                        this.reportBeforeAgentStartTimeout(ext.path);
                         continue;
                     }
                     if (handlerResult) {

package/dist/core/mcp-manager.d.ts

@@ -8,6 +8,9 @@ import type { ToolDefinition } from "./extensions/index.js";
 export declare class MCPManager {
     private client;
     private tools;
+    private enabledServerIds;
+    private startedServerIds;
+    private failedServerIds;
     constructor();
     /**
      * Initialize MCP manager and load tools
@@ -21,6 +24,12 @@ export declare class MCPManager {
      * Get the MCP client instance
      */
     getClient(): MCPClient;
+    getStatus(): {
+        enabledServers: string[];
+        startedServers: string[];
+        failedServers: string[];
+        toolCount: number;
+    };
     /**
      * Cleanup: stop all servers
      */

package/dist/core/mcp-manager.js

@@ -9,6 +9,9 @@ import { listEnabledMCPServers } from "./mcp/mcp-config.js";
 export class MCPManager {
     client;
     tools = [];
+    enabledServerIds = [];
+    startedServerIds = [];
+    failedServerIds = [];
     constructor() {
         this.client = new MCPClient();
     }
@@ -18,11 +21,23 @@ export class MCPManager {
     async initialize() {
         // Load enabled servers
         const enabledServers = listEnabledMCPServers();
+        this.enabledServerIds = enabledServers.map((s) => s.id);
+        this.startedServerIds = [];
+        this.failedServerIds = [];
         for (const serverConfig of enabledServers) {
             this.client.addServer(serverConfig);
             // Start stdio-based servers
             if (serverConfig.transport !== "sse") {
-                await this.client.startServer(serverConfig.id);
+                const ok = await this.client.startServer(serverConfig.id);
+                if (ok) {
+                    this.startedServerIds.push(serverConfig.id);
+                }
+                else {
+                    this.failedServerIds.push(serverConfig.id);
+                }
+            }
+            else {
+                this.startedServerIds.push(serverConfig.id);
             }
         }
         // Load tools from all servers
@@ -40,6 +55,14 @@ export class MCPManager {
     getClient() {
         return this.client;
     }
+    getStatus() {
+        return {
+            enabledServers: [...this.enabledServerIds],
+            startedServers: [...this.startedServerIds],
+            failedServers: [...this.failedServerIds],
+            toolCount: this.tools.length,
+        };
+    }
     /**
      * Cleanup: stop all servers
      */

package/dist/core/sdk.js

@@ -241,6 +241,16 @@ export async function createAgentSession(options = {}) {
             await mcpManager.initialize();
             mcpTools.push(...mcpManager.getTools());
             time("mcp.initialize");
+            const mcpStatus = mcpManager.getStatus();
+            if (mcpStatus.toolCount === 0) {
+                const failed = mcpStatus.failedServers.length > 0
+                    ? ` failed=${mcpStatus.failedServers.join(",")}`
+                    : "";
+                console.warn(`MCP enabled but no tools loaded (enabled=${mcpStatus.enabledServers.length}, started=${mcpStatus.startedServers.length}, tools=0).${failed}`);
+            }
+            else {
+                console.error(`MCP tools loaded: ${mcpStatus.toolCount}`);
+            }
             process.once("exit", () => mcpManager?.dispose());
         }
         catch (error) {

package/dist/core/soul-integration.js

@@ -11,8 +11,24 @@ import { dirname } from "node:path";
 import { createRequire } from "node:module";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const require = createRequire(import.meta.url);
-// Try to load from bundled packages first (dist/packages/nanosoul)
-const BUNDLED_SOUL = join(__dirname, "packages", "nanosoul");
+function getBundledSoulCandidates() {
+    return [
+        // Published package runtime: dist/core -> dist/packages/nanosoul
+        join(__dirname, "..", "packages", "nanosoul"),
+        // Legacy/runtime fallback
+        join(__dirname, "packages", "nanosoul"),
+        // Dev workspace runtime
+        join(process.cwd(), "packages", "nanosoul", "dist"),
+    ];
+}
+function resolveBundledSoulEntry() {
+    for (const dir of getBundledSoulCandidates()) {
+        const entry = join(dir, "index.js");
+        if (existsSync(entry))
+            return entry;
+    }
+    return undefined;
+}
 /**
  * Default Soul configuration for NanoPencil
  */
@@ -49,9 +65,10 @@ export function getSoulConfig() {
  */
 export async function createSoulManager() {
     try {
-        // Try bundled package first (dist/packages/nanosoul)
-        if (existsSync(BUNDLED_SOUL)) {
-            const { SoulManager: SM } = await import(join(BUNDLED_SOUL, "index.js"));
+        // Try bundled package first
+        const bundledEntry = resolveBundledSoulEntry();
+        if (bundledEntry) {
+            const { SoulManager: SM } = await import(bundledEntry);
             return new SM({
                 config: getSoulConfig(),
             });
@@ -72,9 +89,8 @@ export async function createSoulManager() {
  */
 export function isSoulAvailable() {
     // Check bundled version first
-    if (existsSync(BUNDLED_SOUL)) {
-        return existsSync(join(BUNDLED_SOUL, "index.js"));
-    }
+    if (resolveBundledSoulEntry())
+        return true;
     // Fall back to checking node_modules
     try {
         require.resolve("nanosoul");

package/dist/modes/interactive/interactive-mode.js

@@ -4020,6 +4020,34 @@ export class InteractiveMode {
             this.ui.requestRender();
             return;
         }
+        if (action === "status" || action === "tools") {
+            const runtimeTools = this.session
+                .getAllTools()
+                .filter((t) => t.name.startsWith("mcp_"));
+            this.chatContainer.addChild(new Spacer(1));
+            if (runtimeTools.length === 0) {
+                this.chatContainer.addChild(new Text([
+                    theme.bold("MCP Runtime Status"),
+                    "",
+                    "No MCP tools are currently registered in this session.",
+                    theme.fg("dim", "Tip: run /reload and check startup logs for MCP errors."),
+                ].join("\n"), 1, 0));
+            }
+            else {
+                const lines = [
+                    theme.bold("MCP Runtime Status"),
+                    "",
+                    `Registered MCP tools: ${runtimeTools.length}`,
+                    ...runtimeTools.slice(0, 30).map((t) => `- ${t.name}`),
+                ];
+                if (runtimeTools.length > 30) {
+                    lines.push(theme.fg("dim", `...and ${runtimeTools.length - 30} more`));
+                }
+                this.chatContainer.addChild(new Text(lines.join("\n"), 1, 0));
+            }
+            this.ui.requestRender();
+            return;
+        }
         if ((action === "enable" || action === "disable") && target) {
             setMCPServerEnabled(target, action === "enable");
             this.chatContainer.addChild(new Spacer(1));
@@ -4028,7 +4056,7 @@ export class InteractiveMode {
             return;
         }
         this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new Text("Usage: /mcp [list|enable <id>|disable <id>]", 1, 0));
+        this.chatContainer.addChild(new Text("Usage: /mcp [list|status|tools|enable <id>|disable <id>]", 1, 0));
         this.ui.requestRender();
     }
     async handleUpdateCommand() {

package/dist/packages/nanomem/insights-html.d.ts

@@ -1,7 +1,7 @@
 /**
  * [INPUT]: InsightsReport, locale
- * [OUTPUT]: Complete standalone HTML string
- * [POS]: Pure render function — no side effects, no dependencies
+ * [OUTPUT]: Standalone HTML report
+ * [POS]: Pure renderer, no side effects
  */
 import type { InsightsReport } from "./types.js";
 export declare function renderInsightsHtml(report: InsightsReport, locale: string): string;

package/dist/packages/nanomem/insights-html.js

@@ -1,9 +1,77 @@
 /**
  * [INPUT]: InsightsReport, locale
- * [OUTPUT]: Complete standalone HTML string
- * [POS]: Pure render function — no side effects, no dependencies
+ * [OUTPUT]: Standalone HTML report
+ * [POS]: Pure renderer, no side effects
  */
 import { PROMPTS } from "./i18n.js";
+const UI = {
+    en: {
+        subtitle: "sessions analyzed",
+        atAGlance: "At a Glance",
+        whatsWorking: "What's Working",
+        whatsHindering: "What's Hindering",
+        quickWins: "Quick Wins",
+        focusArea: "Focus Area",
+        noneYet: "No strong signal yet.",
+        workOn: "What You Work On",
+        workOnIntro: "Top project areas inferred from your memory graph.",
+        sessionWord: "sessions",
+        distribution: "Focus Distribution",
+        topProjects: "Top Projects",
+        frequentTags: "Frequent Tags",
+        successes: "Impressive Things You Solved",
+        successesIntro: "Resolved struggles and high-value lessons worth repeating.",
+        frictions: "Where Things Still Go Wrong",
+        frictionsIntro: "Open struggles that are still costing time.",
+        details: "Details",
+        weight: "Weight",
+        access: "Access",
+        importance: "Importance",
+        attempts: "Attempts",
+        solution: "Solution",
+        status: "Status",
+        resolved: "resolved",
+        unresolved: "open",
+        knowledgePrefs: "Knowledge and Preferences",
+        lessons: "Top Lessons",
+        knowledge: "Knowledge Base",
+        preferences: "User Preferences",
+        generatedBy: "Generated by NanoMem",
+    },
+    zh: {
+        subtitle: "已分析会话",
+        atAGlance: "总览",
+        whatsWorking: "做得好的地方",
+        whatsHindering: "当前阻碍",
+        quickWins: "快速改进",
+        focusArea: "主要方向",
+        noneYet: "暂时没有明显信号。",
+        workOn: "你在做什么",
+        workOnIntro: "基于记忆图谱推断的项目重点领域。",
+        sessionWord: "次会话",
+        distribution: "关注分布",
+        topProjects: "主要项目",
+        frequentTags: "高频标签",
+        successes: "你解决得很好的事",
+        successesIntro: "已解决问题与高价值经验，建议重复复用。",
+        frictions: "仍在反复消耗的点",
+        frictionsIntro: "尚未关闭的问题，持续影响效率。",
+        details: "详情",
+        weight: "权重",
+        access: "访问",
+        importance: "重要度",
+        attempts: "尝试",
+        solution: "解法",
+        status: "状态",
+        resolved: "已解决",
+        unresolved: "待处理",
+        knowledgePrefs: "知识与偏好",
+        lessons: "关键经验",
+        knowledge: "知识库",
+        preferences: "用户偏好",
+        generatedBy: "由 NanoMem 自动生成",
+    },
+};
 function escapeHtml(str) {
     return str
         .replace(/&/g, "&")
@@ -12,432 +80,352 @@ function escapeHtml(str) {
         .replace(/"/g, """)
         .replace(/'/g, "'");
 }
-function renderStatsCards(report, locale) {
-    const labels = locale === "zh"
-        ? ["会话", "知识", "经验", "偏好", "事件", "面相"]
-        : ["Sessions", "Knowledge", "Lessons", "Prefs", "Episodes", "Facets"];
-    const values = [
-        report.stats.totalSessions,
-        report.stats.knowledge,
-        report.stats.lessons,
-        report.stats.preferences,
-        report.stats.episodes,
-        report.stats.facets,
-    ];
-    return values
-        .map((v, i) => `
-      <div class="stat-card">
-        <div class="stat-value">${v}</div>
-        <div class="stat-label">${labels[i]}</div>
-      </div>`)
+function formatDate(iso, locale) {
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return iso;
+    return d.toLocaleString(locale === "zh" ? "zh-CN" : "en-US");
+}
+function dedupeById(entries) {
+    const map = new Map();
+    for (const entry of entries)
+        map.set(entry.id, entry);
+    return [...map.values()];
+}
+function topTags(entries, limit = 8) {
+    const counts = new Map();
+    for (const entry of entries) {
+        for (const tag of entry.tags ?? [])
+            counts.set(tag, (counts.get(tag) ?? 0) + 1);
+    }
+    return [...counts.entries()]
+        .map(([label, value]) => ({ label, value }))
+        .sort((a, b) => b.value - a.value)
+        .slice(0, limit);
+}
+function topProjects(entries, limit = 6) {
+    const counts = new Map();
+    for (const entry of entries) {
+        if (!entry.project)
+            continue;
+        counts.set(entry.project, (counts.get(entry.project) ?? 0) + 1);
+    }
+    return [...counts.entries()]
+        .map(([label, value]) => ({ label, value }))
+        .sort((a, b) => b.value - a.value)
+        .slice(0, limit);
+}
+function renderBarRows(rows, colorClass, empty) {
+    if (!rows.length)
+        return `<p class="empty">${escapeHtml(empty)}</p>`;
+    const max = Math.max(...rows.map((row) => row.value), 1);
+    return rows
+        .map((row) => {
+        const width = Math.max(8, Math.round((row.value / max) * 100));
+        return `<div class="bar-row">
+  <div class="bar-label" title="${escapeHtml(row.label)}">${escapeHtml(row.label)}</div>
+  <div class="bar-track"><div class="bar-fill ${colorClass}" style="width:${width}%"></div></div>
+  <div class="bar-value">${row.value}</div>
+</div>`;
+    })
         .join("");
 }
-function renderRecommendations(recommendations, p) {
-    if (!recommendations.length)
-        return "";
-    return `
-    <section class="section recommendations">
-      <h2 class="section-title" onclick="toggleSection(this)">
-        <span class="toggle-icon">&#9660;</span>
-        ${escapeHtml(p.insightsSectionRecommendations)} (${recommendations.length})
-      </h2>
-      <div class="section-content">
-        <ul class="recommendation-list">
-          ${recommendations.map((r) => `<li>${escapeHtml(r)}</li>`).join("")}
-        </ul>
-      </div>
-    </section>`;
+function renderProjectAreas(projects, entries, ui) {
+    if (!projects.length)
+        return `<p class="empty">${escapeHtml(ui.noneYet)}</p>`;
+    return projects
+        .map((project) => {
+        const scopeEntries = entries.filter((entry) => entry.project === project.label);
+        const tags = topTags(scopeEntries, 4).map((item) => item.label);
+        const desc = tags.length > 0
+            ? `Top signals: ${tags.map((tag) => `#${escapeHtml(tag)}`).join(" ")}`
+            : "No dominant tag signal yet.";
+        return `<article class="project-area">
+  <div class="area-header">
+    <span class="area-name">${escapeHtml(project.label)}</span>
+    <span class="area-count">~${project.value} ${escapeHtml(ui.sessionWord)}</span>
+  </div>
+  <p class="area-desc">${desc}</p>
+</article>`;
+    })
+        .join("");
 }
-function renderPatterns(patterns, p) {
+function renderPatternRows(patterns, ui) {
     if (!patterns.length)
-        return "";
-    const maxWeight = Math.max(...patterns.map((pa) => pa.weight), 1);
-    return `
-    <section class="section patterns">
-      <h2 class="section-title" onclick="toggleSection(this)">
-        <span class="toggle-icon">&#9660;</span>
-        ${escapeHtml(p.insightsSectionPatterns)} (${patterns.length})
-      </h2>
-      <div class="section-content">
-        ${patterns
-        .map((pa) => `
-          <div class="pattern-item">
-            <div class="pattern-header">
-              <span class="pattern-trigger">When ${escapeHtml(pa.trigger)}</span>
-              <span class="pattern-arrow">&#8594;</span>
-              <span class="pattern-behavior">${escapeHtml(pa.behavior)}</span>
-            </div>
-            <div class="weight-bar-container">
-              <div class="weight-bar" style="width: ${(pa.weight / maxWeight) * 100}%"></div>
-              <span class="weight-value">${pa.weight.toFixed(1)}</span>
-            </div>
-            <div class="access-badge">&#128065; ${pa.entry.accessCount}</div>
-          </div>`)
-        .join("")}
-      </div>
-    </section>`;
+        return `<p class="empty">${escapeHtml(ui.noneYet)}</p>`;
+    const maxWeight = Math.max(...patterns.map((item) => item.weight), 1);
+    return patterns
+        .slice(0, 12)
+        .map((item) => {
+        const width = Math.max(8, Math.round((item.weight / maxWeight) * 100));
+        return `<article class="item-card">
+  <div class="item-title"><strong>${escapeHtml(item.trigger)}</strong> <span class="arrow">-></span> ${escapeHtml(item.behavior)}</div>
+  <div class="weight-track"><div class="weight-fill" style="width:${width}%"></div></div>
+  <div class="meta-row">
+    <span>${escapeHtml(ui.weight)}: ${item.weight.toFixed(2)}</span>
+    <span>${escapeHtml(ui.access)}: ${item.entry.accessCount}</span>
+    <span>${escapeHtml(ui.importance)}: ${item.entry.importance}</span>
+  </div>
+</article>`;
+    })
+        .join("");
 }
-function renderStruggles(struggles, p) {
+function renderStruggleRows(struggles, ui) {
     if (!struggles.length)
-        return "";
-    const unresolved = struggles.filter((s) => !s.resolved);
-    const resolved = struggles.filter((s) => s.resolved);
-    const renderStruggleItem = (s) => `
-    <div class="struggle-item ${s.resolved ? "resolved" : "unresolved"}">
-      <div class="struggle-problem">
-        <span class="status-icon">${s.resolved ? "&#10003;" : "&#9888;"}</span>
-        ${escapeHtml(s.problem)}
-      </div>
-      ${s.attempts.length
-        ? `
-        <div class="struggle-attempts">
-          <span class="attempts-label">Tried:</span>
-          <ul>${s.attempts.map((a) => `<li>${escapeHtml(a)}</li>`).join("")}</ul>
-        </div>`
-        : ""}
-      ${s.solution ? `<div class="struggle-solution"><span class="solution-label">Solution:</span> ${escapeHtml(s.solution)}</div>` : ""}
-    </div>`;
-    return `
-    <section class="section struggles">
-      <h2 class="section-title" onclick="toggleSection(this)">
-        <span class="toggle-icon">&#9660;</span>
-        ${escapeHtml(p.insightsSectionStruggles)} (${struggles.length})
-      </h2>
-      <div class="section-content">
-        <div class="tab-container">
-          <button class="tab-btn active" onclick="switchTab(this, 'unresolved')">${escapeHtml(p.insightsUnresolved)} (${unresolved.length})</button>
-          <button class="tab-btn" onclick="switchTab(this, 'resolved')">${escapeHtml(p.insightsResolved)} (${resolved.length})</button>
-        </div>
-        <div class="tab-content unresolved active">
-          ${unresolved.length ? unresolved.map(renderStruggleItem).join("") : `<p class="empty-state">No unresolved struggles</p>`}
-        </div>
-        <div class="tab-content resolved">
-          ${resolved.length ? resolved.map(renderStruggleItem).join("") : `<p class="empty-state">No resolved struggles</p>`}
-        </div>
-      </div>
-    </section>`;
+        return `<p class="empty">${escapeHtml(ui.noneYet)}</p>`;
+    return struggles
+        .slice(0, 12)
+        .map((item) => {
+        const attempts = item.attempts.length
+            ? `<div class="sub-line"><strong>${escapeHtml(ui.attempts)}:</strong> ${item.attempts.map((a) => escapeHtml(a)).join(" | ")}</div>`
+            : "";
+        const solution = item.solution
+            ? `<div class="sub-line"><strong>${escapeHtml(ui.solution)}:</strong> ${escapeHtml(item.solution)}</div>`
+            : "";
+        return `<article class="item-card ${item.resolved ? "ok" : "warn"}">
+  <div class="item-title">${escapeHtml(item.problem)}</div>
+  ${attempts}
+  ${solution}
+  <div class="meta-row">
+    <span>${escapeHtml(ui.status)}: ${item.resolved ? escapeHtml(ui.resolved) : escapeHtml(ui.unresolved)}</span>
+    <span>${escapeHtml(ui.weight)}: ${item.weight.toFixed(2)}</span>
+  </div>
+</article>`;
+    })
+        .join("");
 }
-function renderLessons(lessons, p) {
-    if (!lessons.length)
-        return "";
-    return `
-    <section class="section lessons">
-      <h2 class="section-title" onclick="toggleSection(this)">
-        <span class="toggle-icon">&#9660;</span>
-        ${escapeHtml(p.insightsSectionLessons)} (${lessons.length})
-      </h2>
-      <div class="section-content">
-        <ul class="lessons-list">
-          ${lessons
-        .map((l) => `
-            <li>
-              <span class="lesson-content">${escapeHtml(l.content)}</span>
-              <span class="importance-stars">${"&#9733;".repeat(Math.min(Math.ceil(l.importance / 2), 5))}</span>
-            </li>`)
-        .join("")}
-        </ul>
-      </div>
-    </section>`;
+function renderMemoryList(entries, empty) {
+    if (!entries.length)
+        return `<p class="empty">${escapeHtml(empty)}</p>`;
+    return `<ul class="list">${entries
+        .map((entry) => `<li>${escapeHtml(entry.content)}${entry.tags.length ? ` <span class="tags">${entry.tags.slice(0, 4).map((tag) => `#${escapeHtml(tag)}`).join(" ")}</span>` : ""}</li>`)
+        .join("")}</ul>`;
 }
-function renderKnowledge(knowledge, locale) {
-    if (!knowledge.length)
-        return "";
-    const title = locale === "zh" ? "知识库" : "Knowledge Base";
-    return `
-    <section class="section knowledge">
-      <h2 class="section-title" onclick="toggleSection(this)">
-        <span class="toggle-icon">&#9660;</span>
-        ${title} (${knowledge.length})
-      </h2>
-      <div class="section-content">
-        <ul class="knowledge-list">
-          ${knowledge
-        .map((k) => `
-            <li>
-              <span class="knowledge-content">${escapeHtml(k.content)}</span>
-              <div class="tags">${k.tags
-        .slice(0, 5)
-        .map((t) => `<span class="tag">${escapeHtml(t)}</span>`)
-        .join("")}</div>
-            </li>`)
-        .join("")}
-        </ul>
-      </div>
-    </section>`;
+function renderAtAGlance(report, projects, ui) {
+    const unresolved = report.struggles.filter((item) => !item.resolved);
+    const resolved = report.struggles.filter((item) => item.resolved);
+    const topPattern = report.patterns[0];
+    const topRec = report.recommendations[0];
+    const topProject = projects[0];
+    const working = resolved.length > 0
+        ? `${resolved.length} struggles are already resolved; keep reusing those fixes.`
+        : report.topLessons.length
+            ? `${report.topLessons.length} lessons captured; convert the top ones into repeatable checklists.`
+            : ui.noneYet;
+    const hindering = unresolved.length
+        ? `${unresolved.length} open struggles remain. Most frequent: "${unresolved[0]?.problem ?? ""}".`
+        : "No unresolved struggles currently visible.";
+    const quickWins = topRec ? topRec : ui.noneYet;
+    const focus = topProject
+        ? `${topProject.label} appears most often (${topProject.value} memories).`
+        : topPattern
+            ? `Dominant behavior: when "${topPattern.trigger}", you often "${topPattern.behavior}".`
+            : ui.noneYet;
+    return `<section class="glance">
+  <h2>${escapeHtml(ui.atAGlance)}</h2>
+  <div class="glance-grid">
+    <article class="glance-card">
+      <h3>${escapeHtml(ui.whatsWorking)}</h3>
+      <p>${escapeHtml(working)}</p>
+    </article>
+    <article class="glance-card warn">
+      <h3>${escapeHtml(ui.whatsHindering)}</h3>
+      <p>${escapeHtml(hindering)}</p>
+    </article>
+    <article class="glance-card">
+      <h3>${escapeHtml(ui.quickWins)}</h3>
+      <p>${escapeHtml(quickWins)}</p>
+    </article>
+    <article class="glance-card">
+      <h3>${escapeHtml(ui.focusArea)}</h3>
+      <p>${escapeHtml(focus)}</p>
+    </article>
+  </div>
+</section>`;
 }
-function renderPreferences(preferences, locale) {
-    if (!preferences.length)
-        return "";
-    const title = locale === "zh" ? "用户偏好" : "User Preferences";
-    return `
-    <section class="section preferences">
-      <h2 class="section-title" onclick="toggleSection(this)">
-        <span class="toggle-icon">&#9660;</span>
-        ${title} (${preferences.length})
-      </h2>
-      <div class="section-content">
-        <ul class="preferences-list">
-          ${preferences.map((pr) => `<li>${escapeHtml(pr.content)}</li>`).join("")}
-        </ul>
-      </div>
-    </section>`;
+function renderRecommendations(report, title, empty) {
+    if (!report.recommendations.length)
+        return `<section class="section"><h2>${escapeHtml(title)}</h2><p class="empty">${escapeHtml(empty)}</p></section>`;
+    return `<section id="section-recommendations" class="section">
+  <h2>${escapeHtml(title)}</h2>
+  <ul class="recommend-list">${report.recommendations.map((rec) => `<li>${escapeHtml(rec)}</li>`).join("")}</ul>
+</section>`;
 }
 export function renderInsightsHtml(report, locale) {
-    const p = PROMPTS[locale] ?? PROMPTS.en;
-    const hasData = report.patterns.length || report.struggles.length || report.topLessons.length;
-    const css = `
-    :root {
-      --bg: #ffffff;
-      --bg-card: #f8f9fa;
-      --text: #1a1a2e;
-      --text-secondary: #6c757d;
-      --border: #dee2e6;
-      --accent-pattern: #3b82f6;
-      --accent-struggle-unresolved: #f59e0b;
-      --accent-struggle-resolved: #10b981;
-      --accent-lesson: #8b5cf6;
-      --accent-recommendation: #eab308;
-      --shadow: rgba(0, 0, 0, 0.1);
-    }
-    [data-theme="dark"] {
-      --bg: #1a1a2e;
-      --bg-card: #16213e;
-      --text: #e8e8e8;
-      --text-secondary: #a0a0a0;
-      --border: #374151;
-      --shadow: rgba(0, 0, 0, 0.3);
-    }
-    * { box-sizing: border-box; margin: 0; padding: 0; }
-    body {
-      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-      background: var(--bg);
-      color: var(--text);
-      line-height: 1.6;
-      padding: 2rem;
-      max-width: 1200px;
-      margin: 0 auto;
-    }
-    header {
-      display: flex;
-      justify-content: space-between;
-      align-items: center;
-      margin-bottom: 2rem;
-      padding-bottom: 1rem;
-      border-bottom: 1px solid var(--border);
-    }
-    h1 { font-size: 1.75rem; font-weight: 600; }
-    .meta { color: var(--text-secondary); font-size: 0.875rem; }
-    .theme-toggle {
-      background: var(--bg-card);
-      border: 1px solid var(--border);
-      padding: 0.5rem 1rem;
-      border-radius: 0.5rem;
-      cursor: pointer;
-      font-size: 1.25rem;
-    }
-    .stats-row {
-      display: grid;
-      grid-template-columns: repeat(auto-fit, minmax(100px, 1fr));
-      gap: 1rem;
-      margin-bottom: 2rem;
-    }
-    .stat-card {
-      background: var(--bg-card);
-      padding: 1rem;
-      border-radius: 0.75rem;
-      text-align: center;
-      border: 1px solid var(--border);
-    }
-    .stat-value { font-size: 2rem; font-weight: 700; color: var(--accent-pattern); }
-    .stat-label { font-size: 0.75rem; color: var(--text-secondary); text-transform: uppercase; }
-    .section {
-      background: var(--bg-card);
-      border-radius: 0.75rem;
-      margin-bottom: 1rem;
-      border: 1px solid var(--border);
-      overflow: hidden;
-    }
-    .section-title {
-      padding: 1rem 1.25rem;
-      cursor: pointer;
-      display: flex;
-      align-items: center;
-      gap: 0.5rem;
-      font-size: 1rem;
-      font-weight: 600;
-      user-select: none;
-    }
-    .section-title:hover { background: var(--bg); }
-    .toggle-icon { font-size: 0.75rem; transition: transform 0.2s; }
-    .section.collapsed .toggle-icon { transform: rotate(-90deg); }
-    .section.collapsed .section-content { display: none; }
-    .section-content { padding: 0 1.25rem 1.25rem; }
-    .recommendations { border-left: 4px solid var(--accent-recommendation); }
-    .recommendation-list { list-style: none; }
-    .recommendation-list li {
-      padding: 0.75rem;
-      margin-bottom: 0.5rem;
-      background: var(--bg);
-      border-radius: 0.5rem;
-      border-left: 3px solid var(--accent-recommendation);
-    }
-    .patterns { border-left: 4px solid var(--accent-pattern); }
-    .pattern-item {
-      padding: 1rem;
-      margin-bottom: 0.75rem;
-      background: var(--bg);
-      border-radius: 0.5rem;
-      position: relative;
-    }
-    .pattern-header { display: flex; align-items: center; gap: 0.5rem; flex-wrap: wrap; }
-    .pattern-trigger { color: var(--accent-pattern); font-weight: 500; }
-    .pattern-arrow { color: var(--text-secondary); }
-    .pattern-behavior { font-weight: 500; }
-    .weight-bar-container {
-      margin-top: 0.5rem;
-      display: flex;
-      align-items: center;
-      gap: 0.5rem;
-    }
-    .weight-bar {
-      height: 6px;
-      background: var(--accent-pattern);
-      border-radius: 3px;
-      flex-shrink: 0;
-    }
-    .weight-value { font-size: 0.75rem; color: var(--text-secondary); }
-    .access-badge {
-      position: absolute;
-      top: 0.5rem;
-      right: 0.5rem;
-      font-size: 0.75rem;
-      color: var(--text-secondary);
-    }
-    .struggles { border-left: 4px solid var(--accent-struggle-unresolved); }
-    .tab-container { display: flex; gap: 0.5rem; margin-bottom: 1rem; }
-    .tab-btn {
-      padding: 0.5rem 1rem;
-      border: 1px solid var(--border);
-      background: var(--bg);
-      border-radius: 0.5rem;
-      cursor: pointer;
-      font-size: 0.875rem;
-    }
-    .tab-btn.active {
-      background: var(--accent-pattern);
-      color: white;
-      border-color: var(--accent-pattern);
-    }
-    .tab-content { display: none; }
-    .tab-content.active { display: block; }
-    .struggle-item {
-      padding: 1rem;
-      margin-bottom: 0.75rem;
-      background: var(--bg);
-      border-radius: 0.5rem;
-      border-left: 3px solid var(--accent-struggle-unresolved);
-    }
-    .struggle-item.resolved { border-left-color: var(--accent-struggle-resolved); }
-    .struggle-problem { font-weight: 500; display: flex; align-items: center; gap: 0.5rem; }
-    .status-icon { font-size: 1rem; }
-    .struggle-item.unresolved .status-icon { color: var(--accent-struggle-unresolved); }
-    .struggle-item.resolved .status-icon { color: var(--accent-struggle-resolved); }
-    .struggle-attempts { margin-top: 0.5rem; font-size: 0.875rem; color: var(--text-secondary); }
-    .struggle-attempts ul { margin-left: 1.5rem; margin-top: 0.25rem; }
-    .struggle-solution {
-      margin-top: 0.5rem;
-      padding: 0.5rem;
-      background: rgba(16, 185, 129, 0.1);
-      border-radius: 0.25rem;
-      font-size: 0.875rem;
-    }
-    .solution-label { font-weight: 500; color: var(--accent-struggle-resolved); }
-    .lessons { border-left: 4px solid var(--accent-lesson); }
-    .lessons-list { list-style: none; }
-    .lessons-list li {
-      padding: 0.75rem;
-      margin-bottom: 0.5rem;
-      background: var(--bg);
-      border-radius: 0.5rem;
-      display: flex;
-      justify-content: space-between;
-      align-items: center;
-    }
-    .importance-stars { color: var(--accent-lesson); }
-    .knowledge-list, .preferences-list { list-style: none; }
-    .knowledge-list li, .preferences-list li {
-      padding: 0.75rem;
-      margin-bottom: 0.5rem;
-      background: var(--bg);
-      border-radius: 0.5rem;
-    }
-    .tags { display: flex; gap: 0.25rem; margin-top: 0.5rem; flex-wrap: wrap; }
-    .tag {
-      font-size: 0.7rem;
-      padding: 0.125rem 0.375rem;
-      background: var(--border);
-      border-radius: 0.25rem;
-      color: var(--text-secondary);
-    }
-    .empty-state {
-      text-align: center;
-      padding: 2rem;
-      color: var(--text-secondary);
-    }
-  `;
-    const js = `
-    function toggleSection(el) {
-      el.parentElement.classList.toggle('collapsed');
-    }
-    function switchTab(btn, tabName) {
-      const container = btn.closest('.section-content');
-      container.querySelectorAll('.tab-btn').forEach(b => b.classList.remove('active'));
-      container.querySelectorAll('.tab-content').forEach(t => t.classList.remove('active'));
-      btn.classList.add('active');
-      container.querySelector('.tab-content.' + tabName).classList.add('active');
-    }
-    function toggleTheme() {
-      const current = document.documentElement.getAttribute('data-theme');
-      const next = current === 'dark' ? 'light' : 'dark';
-      document.documentElement.setAttribute('data-theme', next);
-      localStorage.setItem('nanomem-theme', next);
-      document.querySelector('.theme-toggle').textContent = next === 'dark' ? '☀️' : '🌙';
-    }
-    (function() {
-      const saved = localStorage.getItem('nanomem-theme') || 'light';
-      document.documentElement.setAttribute('data-theme', saved);
-      document.querySelector('.theme-toggle').textContent = saved === 'dark' ? '☀️' : '🌙';
-    })();
-  `;
-    const body = hasData
-        ? `
-      <div class="stats-row">${renderStatsCards(report, locale)}</div>
-      ${renderRecommendations(report.recommendations, p)}
-      ${renderPatterns(report.patterns, p)}
-      ${renderStruggles(report.struggles, p)}
-      ${renderLessons(report.topLessons, p)}
-      ${renderKnowledge(report.topKnowledge, locale)}
-      ${renderPreferences(report.preferences, locale)}`
-        : `<div class="empty-state">${escapeHtml(p.insightsNoData)}</div>`;
-    return `<!DOCTYPE html>
-<html lang="${locale}">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${escapeHtml(p.insightsTitle)}</title>
-  <style>${css}</style>
-</head>
-<body>
-  <header>
-    <div>
-      <h1>${escapeHtml(p.insightsTitle)}</h1>
-      <div class="meta">${escapeHtml(p.insightsGeneratedAt)}: ${report.generatedAt}</div>
-    </div>
-    <button class="theme-toggle" onclick="toggleTheme()">🌙</button>
-  </header>
-  ${body}
-  <script>${js}</script>
-</body>
+    const isZh = locale === "zh";
+    const ui = UI[isZh ? "zh" : "en"];
+    const prompts = PROMPTS[locale] ?? PROMPTS.en;
+    const allEntries = dedupeById([...report.topKnowledge, ...report.topLessons, ...report.preferences]);
+    const projects = topProjects(allEntries);
+    const tags = topTags(allEntries);
+    const unresolved = report.struggles.filter((item) => !item.resolved);
+    const resolved = report.struggles.filter((item) => item.resolved);
+    const statsRow = [
+        { label: "Sessions", value: report.stats.totalSessions },
+        { label: "Knowledge", value: report.stats.knowledge },
+        { label: "Lessons", value: report.stats.lessons },
+        { label: "Preferences", value: report.stats.preferences },
+        { label: "Struggles", value: report.struggles.length },
+        { label: "Patterns", value: report.patterns.length },
+    ];
+    const css = `
+*{box-sizing:border-box}
+body{margin:0;padding:48px 24px;font-family:Inter,"Segoe UI",Arial,sans-serif;background:#f8fafc;color:#334155;line-height:1.65}
+.container{max-width:960px;margin:0 auto}
+h1{font-size:34px;font-weight:700;color:#0f172a;margin:0 0 8px}
+h2{font-size:22px;font-weight:700;color:#0f172a;margin:0 0 14px}
+h3{font-size:15px;font-weight:700;color:#1e293b;margin:0 0 8px}
+.subtitle{color:#64748b;font-size:14px;margin:0 0 24px}
+.toc{display:flex;flex-wrap:wrap;gap:8px;padding:14px;background:#fff;border:1px solid #e2e8f0;border-radius:10px;margin:0 0 24px}
+.toc a{font-size:12px;color:#475569;background:#f1f5f9;border-radius:6px;padding:6px 10px;text-decoration:none}
+.toc a:hover{background:#e2e8f0}
+.stats{display:grid;grid-template-columns:repeat(auto-fit,minmax(120px,1fr));gap:12px;padding:20px 0;border-top:1px solid #e2e8f0;border-bottom:1px solid #e2e8f0;margin:0 0 28px}
+.stat{text-align:center}
+.stat-value{font-size:24px;font-weight:700;color:#0f172a}
+.stat-label{font-size:11px;color:#64748b;text-transform:uppercase}
+.glance{background:linear-gradient(135deg,#fef3c7 0%,#fde68a 100%);border:1px solid #f59e0b;border-radius:12px;padding:20px 22px;margin:0 0 28px}
+.glance-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:10px}
+.glance-card{background:rgba(255,255,255,.62);border:1px solid rgba(245,158,11,.28);border-radius:8px;padding:12px}
+.glance-card.warn{background:rgba(255,241,242,.82);border-color:#fca5a5}
+.glance-card p{margin:0;font-size:13px;color:#78350f}
+.section{background:#fff;border:1px solid #e2e8f0;border-radius:10px;padding:18px;margin:0 0 16px}
+.section-intro{font-size:13px;color:#64748b;margin:0 0 12px}
+.project-list{display:flex;flex-direction:column;gap:10px}
+.project-area{background:#f8fafc;border:1px solid #e2e8f0;border-radius:8px;padding:14px}
+.area-header{display:flex;justify-content:space-between;align-items:center;gap:10px}
+.area-name{font-size:15px;font-weight:700;color:#0f172a}
+.area-count{font-size:12px;color:#64748b;background:#f1f5f9;padding:2px 8px;border-radius:4px}
+.area-desc{margin:8px 0 0;font-size:13px;color:#475569}
+.charts{display:grid;grid-template-columns:1fr 1fr;gap:16px}
+.chart{background:#fff;border:1px solid #e2e8f0;border-radius:8px;padding:14px}
+.chart-title{font-size:12px;color:#64748b;text-transform:uppercase;margin:0 0 10px}
+.bar-row{display:flex;align-items:center;gap:8px;margin-bottom:7px}
+.bar-label{width:120px;flex-shrink:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:12px;color:#475569}
+.bar-track{flex:1;height:7px;background:#f1f5f9;border-radius:99px}
+.bar-fill{height:100%;border-radius:99px}
+.bar-fill.blue{background:#2563eb}
+.bar-fill.cyan{background:#0891b2}
+.bar-value{width:24px;text-align:right;font-size:12px;color:#64748b}
+.recommend-list{margin:0;padding:0;list-style:none;display:flex;flex-direction:column;gap:8px}
+.recommend-list li{background:#f0fdf4;border:1px solid #bbf7d0;border-left:4px solid #16a34a;border-radius:8px;padding:11px 12px;font-size:14px}
+.item-grid{display:flex;flex-direction:column;gap:10px}
+.item-card{background:#f8fafc;border:1px solid #e2e8f0;border-radius:8px;padding:12px}
+.item-card.ok{background:#f0fdf4;border-color:#86efac}
+.item-card.warn{background:#fef2f2;border-color:#fca5a5}
+.item-title{font-size:14px;color:#0f172a}
+.arrow{color:#94a3b8}
+.weight-track{margin-top:8px;height:6px;background:#e2e8f0;border-radius:99px}
+.weight-fill{height:100%;background:#2563eb;border-radius:99px}
+.sub-line{margin-top:8px;font-size:13px;color:#334155}
+.meta-row{display:flex;gap:12px;flex-wrap:wrap;margin-top:8px;font-size:12px;color:#64748b}
+details{border:1px solid #e2e8f0;border-radius:8px;background:#f8fafc;padding:10px 12px;margin-bottom:10px}
+summary{cursor:pointer;font-size:14px;font-weight:700;color:#334155}
+.list{margin:10px 0 0;padding-left:18px}
+.list li{margin:0 0 8px;font-size:13px;color:#334155}
+.tags{font-size:12px;color:#64748b}
+.empty{font-size:13px;color:#94a3b8}
+footer{margin-top:22px;text-align:center;font-size:12px;color:#94a3b8}
+@media (max-width:760px){body{padding:28px 14px}.charts{grid-template-columns:1fr}.bar-label{width:96px}}
+`;
+    return `<!doctype html>
+<html lang="${isZh ? "zh-CN" : "en"}">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>${escapeHtml(prompts.insightsTitle)}</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com" />
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet" />
+  <style>${css}</style>
+</head>
+<body>
+  <main class="container">
+    <h1>${escapeHtml(prompts.insightsTitle)}</h1>
+    <p class="subtitle">${report.stats.totalSessions} ${escapeHtml(ui.subtitle)} | ${escapeHtml(prompts.insightsGeneratedAt)}: ${escapeHtml(formatDate(report.generatedAt, locale))}</p>
+
+    <nav class="toc">
+      <a href="#section-work">${escapeHtml(ui.workOn)}</a>
+      <a href="#section-distribution">${escapeHtml(ui.distribution)}</a>
+      <a href="#section-recommendations">${escapeHtml(prompts.insightsSectionRecommendations)}</a>
+      <a href="#section-patterns">${escapeHtml(prompts.insightsSectionPatterns)}</a>
+      <a href="#section-struggles">${escapeHtml(prompts.insightsSectionStruggles)}</a>
+      <a href="#section-memory">${escapeHtml(ui.knowledgePrefs)}</a>
+    </nav>
+
+    <section class="stats">
+      ${statsRow
+        .map((item) => `<div class="stat"><div class="stat-value">${item.value}</div><div class="stat-label">${escapeHtml(item.label)}</div></div>`)
+        .join("")}
+    </section>
+
+    ${renderAtAGlance(report, projects, ui)}
+
+    <section id="section-work" class="section">
+      <h2>${escapeHtml(ui.workOn)}</h2>
+      <p class="section-intro">${escapeHtml(ui.workOnIntro)}</p>
+      <div class="project-list">${renderProjectAreas(projects, allEntries, ui)}</div>
+    </section>
+
+    <section id="section-distribution" class="section">
+      <h2>${escapeHtml(ui.distribution)}</h2>
+      <div class="charts">
+        <div class="chart">
+          <p class="chart-title">${escapeHtml(ui.topProjects)}</p>
+          ${renderBarRows(projects, "blue", ui.noneYet)}
+        </div>
+        <div class="chart">
+          <p class="chart-title">${escapeHtml(ui.frequentTags)}</p>
+          ${renderBarRows(tags, "cyan", ui.noneYet)}
+        </div>
+      </div>
+    </section>
+
+    ${renderRecommendations(report, prompts.insightsSectionRecommendations, prompts.insightsNoData)}
+
+    <section class="section">
+      <h2>${escapeHtml(ui.successes)}</h2>
+      <p class="section-intro">${escapeHtml(ui.successesIntro)}</p>
+      <div class="item-grid">
+        ${renderStruggleRows(resolved, ui)}
+        ${renderMemoryList(report.topLessons.slice(0, 5), ui.noneYet)}
+      </div>
+    </section>
+
+    <section class="section">
+      <h2>${escapeHtml(ui.frictions)}</h2>
+      <p class="section-intro">${escapeHtml(ui.frictionsIntro)}</p>
+      <div class="item-grid">${renderStruggleRows(unresolved, ui)}</div>
+    </section>
+
+    <section id="section-patterns" class="section">
+      <h2>${escapeHtml(prompts.insightsSectionPatterns)}</h2>
+      <div class="item-grid">${renderPatternRows(report.patterns, ui)}</div>
+    </section>
+
+    <section id="section-struggles" class="section">
+      <h2>${escapeHtml(prompts.insightsSectionStruggles)}</h2>
+      <div class="item-grid">${renderStruggleRows(report.struggles, ui)}</div>
+    </section>
+
+    <section id="section-memory" class="section">
+      <h2>${escapeHtml(ui.knowledgePrefs)}</h2>
+      <details open>
+        <summary>${escapeHtml(ui.lessons)} (${report.topLessons.length})</summary>
+        ${renderMemoryList(report.topLessons.slice(0, 12), ui.noneYet)}
+      </details>
+      <details>
+        <summary>${escapeHtml(ui.knowledge)} (${report.topKnowledge.length})</summary>
+        ${renderMemoryList(report.topKnowledge.slice(0, 12), ui.noneYet)}
+      </details>
+      <details>
+        <summary>${escapeHtml(ui.preferences)} (${report.preferences.length})</summary>
+        ${renderMemoryList(report.preferences.slice(0, 12), ui.noneYet)}
+      </details>
+    </section>
+
+    <footer>${escapeHtml(ui.generatedBy)}</footer>
+  </main>
+</body>
 </html>`;
 }
 //# sourceMappingURL=insights-html.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pencil-agent/nano-pencil",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "description": "CLI writing agent with read, bash, edit, write tools and session management. Based on pi; supports DashScope Coding Plan. Soul enabled by default for AI personality evolution.",
   "type": "module",
   "bin": {