@pencil-agent/nano-pencil 1.11.7 → 1.11.8

package/dist/core/extensions/runner.js

@@ -115,10 +115,10 @@ export class ExtensionRunner {
         this.sessionManager = sessionManager;
         this.modelRegistry = modelRegistry;
     }
-    async withTimeout(promise, timeoutMs) {
+    async withTimeout(valueOrPromise, timeoutMs) {
         return new Promise((resolve) => {
             const timer = setTimeout(() => resolve(this.beforeAgentStartTimeoutSentinel), timeoutMs);
-            promise
+            Promise.resolve(valueOrPromise)
                 .then((value) => {
                 clearTimeout(timer);
                 resolve(value);

package/dist/core/footer-data-provider.js

@@ -125,6 +125,12 @@ export class FooterDataProvider {
                         cb();
                 }
             });
+            this.gitWatcher.on("error", () => {
+                if (this.gitWatcher) {
+                    this.gitWatcher.close();
+                    this.gitWatcher = null;
+                }
+            });
         }
         catch {
             // Silently fail if we can't watch

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

@@ -175,7 +175,49 @@ function extractLoopDecision(text) {
         };
     }
     catch {
-        return undefined;
+        const lines = payload
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean);
+        if (lines.length === 0) {
+            return undefined;
+        }
+        const getValue = (...prefixes) => {
+            const line = lines.find((entry) => prefixes.some((prefix) => entry.toLowerCase().startsWith(prefix.toLowerCase())));
+            if (!line) {
+                return undefined;
+            }
+            const separatorIndex = line.indexOf(":");
+            if (separatorIndex === -1) {
+                return undefined;
+            }
+            return line.slice(separatorIndex + 1).trim();
+        };
+        const rawStatus = getValue("status:", "状态:");
+        const normalizedStatus = rawStatus === "complete" || rawStatus === "完成"
+            ? "complete"
+            : rawStatus === "continue" || rawStatus === "继续" || rawStatus === "in_progress"
+                ? "continue"
+                : rawStatus === "blocked" || rawStatus === "阻塞"
+                    ? "blocked"
+                    : undefined;
+        if (!normalizedStatus) {
+            return undefined;
+        }
+        const summary = getValue("summary:", "摘要:", "已完成工作:", "completed work:") ??
+            lines.filter((line) => !line.startsWith("-")).slice(1).join(" ").trim();
+        if (!summary) {
+            return undefined;
+        }
+        const nextStep = getValue("next step:", "下一步:");
+        if (normalizedStatus === "continue" && !nextStep) {
+            return undefined;
+        }
+        return {
+            status: normalizedStatus,
+            summary,
+            nextStep,
+        };
     }
 }
 function describeDecision(decision) {

package/dist/packages/mem-core/cli.js

@@ -94,8 +94,13 @@ Usage:
             writeFileSync(outputPath, html, "utf-8");
         }
         else {
-            const report = await engine.generateFullInsights();
-            const html = renderFullInsightsHtml(report, engine.cfg.locale);
+            const enhanced = await engine.generateEnhancedInsights();
+            const html = renderFullInsightsHtml({
+                ...enhanced.report,
+                persona: enhanced.persona,
+                humanInsights: enhanced.humanInsights,
+                rootCauses: enhanced.rootCauses,
+            }, engine.cfg.locale);
             writeFileSync(outputPath, html, "utf-8");
         }
         console.log(`Insights report written to: ${outputPath}`);

package/dist/packages/mem-core/engine.d.ts

@@ -7,7 +7,7 @@
  * No dependency on any specific AI framework — LLM is pluggable.
  */
 import { type NanomemConfig } from "./config.js";
-import type { Episode, ExtractedItem, FullInsightsReport, HumanInsight, InsightsReport, LlmFn, MemoryEntry, MemoryScope, Meta, RootCauseInsight, WorkEntry } from "./types.js";
+import type { DeveloperPersona, Episode, ExtractedItem, FullInsightsReport, HumanInsight, InsightsReport, LlmFn, MemoryEntry, MemoryScope, Meta, RootCauseInsight, WorkEntry } from "./types.js";
 export declare class NanoMemEngine {
     readonly cfg: NanomemConfig;
     private llmFn?;
@@ -74,6 +74,7 @@ export declare class NanoMemEngine {
      */
     generateEnhancedInsights(): Promise<{
         report: FullInsightsReport;
+        persona?: DeveloperPersona;
         humanInsights: HumanInsight[];
         rootCauses: RootCauseInsight[];
     }>;

package/dist/packages/mem-core/engine.js

@@ -424,6 +424,7 @@ export class NanoMemEngine {
         ]);
         return {
             report: baseReport,
+            persona: humanData.persona,
             humanInsights: humanData.humanInsights,
             rootCauses: humanData.rootCauses,
         };

package/dist/packages/mem-core/extension.js

@@ -255,8 +255,13 @@ export default function nanomemExtension(pi) {
             }
             const outputPath = args?.trim() || "./nanomem-insights.html";
             ctx.ui.notify("NanoMem: Generating full insights report...", "info");
-            const report = await engine.generateFullInsights();
-            const html = renderFullInsightsHtml(report, engine.cfg.locale);
+            const enhanced = await engine.generateEnhancedInsights();
+            const html = renderFullInsightsHtml({
+                ...enhanced.report,
+                persona: enhanced.persona,
+                humanInsights: enhanced.humanInsights,
+                rootCauses: enhanced.rootCauses,
+            }, engine.cfg.locale);
             writeFileSync(outputPath, html, "utf-8");
             ctx.ui.notify(`NanoMem: Insights report written to ${outputPath}`, "info");
         },

package/dist/packages/mem-core/full-insights-html.js

@@ -39,12 +39,28 @@ function renderBarRows(chart) {
 export function renderFullInsightsHtml(report, locale) {
     const p = PROMPTS[locale] ?? PROMPTS.en;
     const lang = locale === "zh" ? "zh-CN" : "en";
+    const enhancedReport = report;
     const sections = [];
     // TOC links (only for sections we might render)
     const tocLinks = [
         '<a href="#section-glance"><i class="ri-dashboard-line"></i> ' + escapeHtml(p.fullInsightsAtAGlance) + "</a>",
         '<a href="#section-work"><i class="ri-briefcase-4-line"></i> ' + escapeHtml(p.fullInsightsWorkOn) + "</a>",
     ];
+    if (enhancedReport.persona) {
+        tocLinks.push('<a href="#section-persona"><i class="ri-user-star-line"></i> ' +
+            escapeHtml(p.humanInsightsSectionPersona) +
+            "</a>");
+    }
+    if (enhancedReport.humanInsights?.length) {
+        tocLinks.push('<a href="#section-human-insights"><i class="ri-robot-2-line"></i> ' +
+            escapeHtml(p.humanInsightsSectionInsights) +
+            "</a>");
+    }
+    if (enhancedReport.rootCauses?.length) {
+        tocLinks.push('<a href="#section-root-causes"><i class="ri-stethoscope-line"></i> ' +
+            escapeHtml(p.humanInsightsSectionRootCauses) +
+            "</a>");
+    }
     if (report.charts.length)
         tocLinks.push('<a href="#section-charts"><i class="ri-bar-chart-box-line"></i> Charts</a>');
     if (report.wins.length)
@@ -70,15 +86,78 @@ export function renderFullInsightsHtml(report, locale) {
 ${statItems.map((s) => `<div class="stat"><i class="${s.icon} stat-icon"></i><div class="stat-value">${s.value}</div><div class="stat-label">${escapeHtml(s.label)}</div></div>`).join("\n")}
 </section>`;
     // At a Glance
-    const glanceHtml = `<section id="section-glance" class="at-a-glance">
-  <h2 class="glance-title"><i class="ri-dashboard-line"></i> ${escapeHtml(p.fullInsightsAtAGlance)}</h2>
-  <div class="glance-grid">
+    const glanceHtml = `<section id="section-glance" class="at-a-glance">
+  <h2 class="glance-title"><i class="ri-dashboard-line"></i> ${escapeHtml(p.fullInsightsAtAGlance)}</h2>
+  <div class="glance-grid">
     <article class="glance-card"><h3><i class="ri-checkbox-circle-line"></i> What's working</h3><p>${escapeHtml(report.atAGlance.working)}</p></article>
     <article class="glance-card warn"><h3><i class="ri-error-warning-line"></i> What's hindering</h3><p>${escapeHtml(report.atAGlance.hindering)}</p></article>
     <article class="glance-card"><h3><i class="ri-lightbulb-line"></i> Quick wins</h3><p>${escapeHtml(report.atAGlance.quickWins)}</p></article>
     <article class="glance-card"><h3><i class="ri-rocket-line"></i> Ambitious</h3><p>${escapeHtml(report.atAGlance.ambitious)}</p></article>
-  </div>
+  </div>
+</section>`;
+    let personaHtml = "";
+    if (enhancedReport.persona) {
+        const persona = enhancedReport.persona;
+        personaHtml = `<section id="section-persona" class="section">
+  <h2><i class="ri-user-star-line"></i> ${escapeHtml(p.humanInsightsSectionPersona)}</h2>
+  <div class="persona-grid">
+    <article class="persona-card persona-lead">
+      <div class="persona-kicker">${escapeHtml(persona.summary)}</div>
+      <div class="persona-text">${escapeHtml(persona.whatTheyDo)}</div>
+      <div class="persona-text">${escapeHtml(persona.workStyle)}</div>
+      <div class="persona-meta">${escapeHtml(persona.experienceLevel)}</div>
+    </article>
+    <article class="persona-card">
+      <div class="persona-card-title">Strengths</div>
+      <ul class="persona-list">${persona.superpowers.map((item) => `<li>${escapeHtml(item)}</li>`).join("")}</ul>
+    </article>
+    <article class="persona-card">
+      <div class="persona-card-title">Watchouts</div>
+      <ul class="persona-list">${persona.painPoints.map((item) => `<li>${escapeHtml(item)}</li>`).join("")}</ul>
+    </article>
+  </div>
+</section>`;
+    }
+    let humanInsightsHtml = "";
+    if (enhancedReport.humanInsights?.length) {
+        humanInsightsHtml = `<section id="section-human-insights" class="section">
+  <h2><i class="ri-robot-2-line"></i> ${escapeHtml(p.humanInsightsSectionInsights)}</h2>
+  <div class="insight-review-list">
+${enhancedReport.humanInsights
+            .map((insight) => `    <article class="insight-review-card priority-${escapeHtml(insight.utility)}">
+  <div class="insight-review-header">
+    <div class="insight-review-icon">${escapeHtml(insight.icon)}</div>
+    <div>
+      <div class="insight-review-title">${escapeHtml(insight.title)}</div>
+      <div class="insight-review-priority">${escapeHtml(insight.utility.toUpperCase())}</div>
+    </div>
+  </div>
+  <div class="insight-review-content">${escapeHtml(insight.content)}</div>
+  ${insight.tags.length ? `<div class="insight-tags">${insight.tags.map((tag) => `<span>${escapeHtml(tag)}</span>`).join("")}</div>` : ""}
+</article>`)
+            .join("\n")}
+  </div>
+</section>`;
+    }
+    let rootCausesHtml = "";
+    if (enhancedReport.rootCauses?.length) {
+        rootCausesHtml = `<section id="section-root-causes" class="section">
+  <h2><i class="ri-stethoscope-line"></i> ${escapeHtml(p.humanInsightsSectionRootCauses)}</h2>
+  <div class="root-cause-list">
+${enhancedReport.rootCauses
+            .map((item) => `    <article class="root-cause-card">
+  <div class="root-cause-label">Recurring symptom</div>
+  <div class="root-cause-title">${escapeHtml(item.symptom)}</div>
+  <div class="root-cause-label">Likely cause</div>
+  <div class="root-cause-body">${escapeHtml(item.rootCause)}</div>
+  ${item.evidence.length ? `<div class="root-cause-label">Evidence</div><ul class="root-cause-evidence">${item.evidence.map((fact) => `<li>${escapeHtml(fact)}</li>`).join("")}</ul>` : ""}
+  <div class="root-cause-label">Recommended fix</div>
+  <div class="root-cause-body">${escapeHtml(item.suggestion)}</div>
+</article>`)
+            .join("\n")}
+  </div>
 </section>`;
+    }
     // What You Work On
     let workHtml = "";
     if (report.projectAreas.length) {
@@ -201,10 +280,37 @@ h2 .ri{vertical-align:middle;margin-right:6px}
 .subtitle{color:#64748b;font-size:15px;margin-bottom:24px}
 .nav-toc{display:flex;flex-wrap:wrap;gap:8px;margin:24px 0 32px;padding:16px;background:#fff;border-radius:8px;border:1px solid #e2e8f0}
 .nav-toc a{font-size:12px;color:#64748b;text-decoration:none;padding:6px 12px;border-radius:6px;background:#f1f5f9;transition:all .15s}
-.nav-toc a:hover{background:#e2e8f0;color:#334155}
-.nav-toc .ri{margin-right:4px;vertical-align:middle}
-.stats-row{display:flex;gap:24px;margin-bottom:32px;padding:20px 0;border-top:1px solid #e2e8f0;border-bottom:1px solid #e2e8f0;flex-wrap:wrap}
-.stat{text-align:center}
+.nav-toc a:hover{background:#e2e8f0;color:#334155}
+.nav-toc .ri{margin-right:4px;vertical-align:middle}
+.stats-row{display:flex;gap:24px;margin-bottom:32px;padding:20px 0;border-top:1px solid #e2e8f0;border-bottom:1px solid #e2e8f0;flex-wrap:wrap}
+.persona-grid{display:grid;grid-template-columns:2fr 1fr 1fr;gap:16px}
+.persona-card{background:#f8fafc;border:1px solid #e2e8f0;border-radius:10px;padding:16px}
+.persona-lead{background:linear-gradient(135deg,#fff7ed 0%,#ffedd5 100%);border-color:#fdba74}
+.persona-kicker{font-size:18px;font-weight:700;color:#9a3412;margin-bottom:10px}
+.persona-text{font-size:14px;color:#334155;line-height:1.6;margin-bottom:8px}
+.persona-meta{font-size:12px;color:#7c2d12;text-transform:uppercase;letter-spacing:.04em}
+.persona-card-title{font-size:12px;font-weight:700;color:#64748b;text-transform:uppercase;margin-bottom:10px}
+.persona-list{margin:0;padding-left:18px}
+.persona-list li{margin-bottom:8px;font-size:14px;color:#334155}
+.insight-review-list,.root-cause-list{display:flex;flex-direction:column;gap:16px}
+.insight-review-card{border-radius:10px;padding:18px;border:1px solid #dbeafe;background:#f8fbff}
+.insight-review-card.priority-high{border-color:#93c5fd;background:#eff6ff}
+.insight-review-card.priority-medium{border-color:#cbd5e1;background:#f8fafc}
+.insight-review-card.priority-low{border-color:#d1fae5;background:#f0fdf4}
+.insight-review-header{display:flex;align-items:center;gap:12px;margin-bottom:12px}
+.insight-review-icon{font-size:24px;line-height:1}
+.insight-review-title{font-size:16px;font-weight:700;color:#0f172a}
+.insight-review-priority{font-size:11px;color:#475569;text-transform:uppercase;letter-spacing:.08em}
+.insight-review-content{font-size:14px;color:#334155;line-height:1.7}
+.insight-tags{display:flex;flex-wrap:wrap;gap:8px;margin-top:12px}
+.insight-tags span{font-size:11px;color:#475569;background:#e2e8f0;border-radius:999px;padding:4px 8px}
+.root-cause-card{border-radius:10px;padding:18px;border:1px solid #fecaca;background:#fff7f7}
+.root-cause-label{font-size:11px;font-weight:700;color:#991b1b;text-transform:uppercase;letter-spacing:.06em;margin-bottom:6px}
+.root-cause-title{font-size:16px;font-weight:700;color:#7f1d1d;margin-bottom:10px}
+.root-cause-body{font-size:14px;color:#334155;line-height:1.7;margin-bottom:12px}
+.root-cause-evidence{margin:0 0 12px 18px}
+.root-cause-evidence li{margin-bottom:6px;font-size:13px;color:#475569}
+.stat{text-align:center}
 .stat-icon{font-size:20px;color:#64748b;display:block;margin-bottom:4px}
 .stat-value{font-size:24px;font-weight:700;color:#0f172a}
 .stat-label{font-size:11px;color:#64748b;text-transform:uppercase}
@@ -254,8 +360,9 @@ h2 .ri{vertical-align:middle;margin-right:6px}
 .copy-btn:hover{background:#cbd5e1}
 .pattern-list{margin:0;padding-left:20px}
 .pattern-list li{margin-bottom:6px;font-size:14px;color:#334155}
-footer{margin-top:32px;text-align:center;font-size:12px;color:#94a3b8}
-@media (max-width:640px){.charts-row{grid-template-columns:1fr}.stats-row{justify-content:center}}
+footer{margin-top:32px;text-align:center;font-size:12px;color:#94a3b8}
+@media (max-width:640px){.charts-row{grid-template-columns:1fr}.stats-row{justify-content:center}}
+@media (max-width:900px){.persona-grid{grid-template-columns:1fr}}
 `;
     const copyScript = `
 document.querySelectorAll('.copy-btn').forEach(function(btn){
@@ -291,11 +398,14 @@ document.querySelectorAll('.copy-btn').forEach(function(btn){
 ${tocLinks.map((link) => "      " + link).join("\n")}
     </nav>
 
-${statsHtml}
-${glanceHtml}
-${workHtml}
-${chartsHtml}
-${winsHtml}
+${statsHtml}
+${glanceHtml}
+${workHtml}
+${personaHtml}
+${humanInsightsHtml}
+${rootCausesHtml}
+${chartsHtml}
+${winsHtml}
 ${frictionsHtml}
 ${recHtml}
 ${featuresHtml}

package/dist/packages/mem-core/human-insights.d.ts

@@ -1,19 +1,27 @@
 /**
  * [INPUT]: ExportAllResult, LlmFn, locale
- * [OUTPUT]: 开发者画像 + 人话版洞察 + 根因分析
- * [POS]: LLM-powered human-readable insights generation
- */
-import type { DeveloperPersona, EnhancedInsightsReport, ExportAllResult, HumanInsight, LlmFn, RootCauseInsight } from "./types.js";
-/**
- * 生成大白话版洞察报告
+ * [OUTPUT]: developer persona, evidence-backed insights, and root-cause analysis
+ * [POS]: LLM-powered usage review generation
  */
+import type { DeveloperPersona, EnhancedInsightsReport, HumanInsight, LlmFn, MemoryEntry, Episode, RootCauseInsight, WorkEntry } from "./types.js";
+interface ExportAllResult {
+    knowledge: MemoryEntry[];
+    lessons: MemoryEntry[];
+    preferences: MemoryEntry[];
+    facets: MemoryEntry[];
+    work: WorkEntry[];
+    episodes: Episode[];
+    meta: {
+        totalSessions: number;
+        lastConsolidation?: string;
+        version: number;
+    };
+}
 export declare function generateHumanInsights(all: ExportAllResult, llmFn: LlmFn | undefined, locale: string): Promise<{
     persona?: DeveloperPersona;
     humanInsights: HumanInsight[];
     rootCauses: RootCauseInsight[];
 }>;
-/**
- * 将人类可读洞察合并到 FullInsightsReport 生成流程中
- */
 export declare function buildEnhancedInsightsReport(all: ExportAllResult, llmFn: LlmFn | undefined, locale: string): Promise<EnhancedInsightsReport>;
+export {};
 //# sourceMappingURL=human-insights.d.ts.map

package/dist/packages/mem-core/human-insights.js

@@ -1,118 +1,203 @@
 /**
  * [INPUT]: ExportAllResult, LlmFn, locale
- * [OUTPUT]: 开发者画像 + 人话版洞察 + 根因分析
- * [POS]: LLM-powered human-readable insights generation
+ * [OUTPUT]: developer persona, evidence-backed insights, and root-cause analysis
+ * [POS]: LLM-powered usage review generation
  */
-import { PROMPTS } from "./i18n.js";
+const HUMAN_INSIGHTS_SYSTEM_PROMPT = `You are an elite AI product analyst and developer workflow coach.
+
+You are reviewing one specific user's real usage history over time.
+Write like a warm, observant expert who deeply understands how experienced AI users actually work.
+
+Goals:
+- Sound human, perceptive, and respectful rather than robotic or generic
+- Give clear corrections when the user's habits are inefficient
+- Back every major conclusion with concrete evidence from the supplied data
+- Prefer precise language, plain English, and practical recommendations
+- Explain what the user is doing well, where they are losing time, and what they should change next
+
+Output requirements:
+- Output ONLY valid JSON
+- Do not use markdown or code fences
+- Use the supplied data only
+- Be specific, not motivational fluff
+- Each insight should feel like part of a thoughtful performance review
+- Recommendations should be direct, concrete, and easy to act on
+- Evidence should reference counts, repeated behaviors, or recurring issues when possible
+- If locale is "zh", write the JSON string values in Simplified Chinese; otherwise write in English
+
+Return JSON matching this schema:
+{
+  "persona": {
+    "whatTheyDo": "1-2 sentences",
+    "experienceLevel": "1 sentence",
+    "superpowers": ["...", "..."],
+    "painPoints": ["...", "..."],
+    "workStyle": "1-2 sentences",
+    "summary": "1 sentence"
+  },
+  "insights": [
+    {
+      "title": "short title",
+      "content": "3-5 sentences combining observation, evidence, correction, and advice",
+      "icon": "emoji",
+      "utility": "high|medium|low",
+      "tags": ["tag1", "tag2"]
+    }
+  ],
+  "rootCauses": [
+    {
+      "symptom": "what keeps happening",
+      "rootCause": "why it likely happens",
+      "evidence": ["fact 1", "fact 2"],
+      "suggestion": "what to change next"
+    }
+  ]
+}`.trim();
+function summarizeCounts(rows, formatter) {
+    return rows.map(([label, value]) => formatter(label, value));
+}
 function buildHumanInsightsData(all) {
-    // 工具使用
-    const tools = all.episodes.length > 0
-        ? Object.entries(all.episodes.reduce((acc, ep) => {
-            for (const [tool, count] of Object.entries(ep.toolsUsed || {})) {
-                acc[tool] = (acc[tool] || 0) + count;
-            }
-            return acc;
-        }, {}))
-            .sort((a, b) => b[1] - a[1])
-            .slice(0, 10)
-            .map(([t, c]) => `${t} (${c}次)`)
-            .join(", ")
-        : "暂无数据";
-    // 语言统计
-    const langCounts = {};
-    for (const ep of all.episodes) {
-        for (const f of ep.filesModified || []) {
-            const ext = f.includes(".") ? f.split(".").pop()?.toLowerCase() ?? "other" : "other";
-            langCounts[ext] = (langCounts[ext] || 0) + 1;
+    const totalToolUses = all.episodes.reduce((total, episode) => total +
+        Object.values(episode.toolsUsed ?? {}).reduce((sum, count) => sum + count, 0), 0);
+    const toolCounts = all.episodes.reduce((acc, episode) => {
+        for (const [tool, count] of Object.entries(episode.toolsUsed ?? {})) {
+            acc[tool] = (acc[tool] ?? 0) + count;
         }
-    }
-    const languages = Object.keys(langCounts).length > 0
-        ? Object.entries(langCounts)
-            .sort((a, b) => b[1] - a[1])
-            .slice(0, 8)
-            .map(([l, c]) => `${l} (${c}个文件)`)
-            .join(", ")
-        : "暂无数据";
-    // 已解决的问题 (wins)
-    const wins = all.facets
-        .filter((f) => f.type === "struggle" && f.facetData?.kind === "struggle" && f.facetData.solution)
-        .slice(0, 8)
-        .map((f) => f.summary || f.facetData?.kind === "struggle" && f.facetData.problem)
-        .filter(Boolean)
-        .join("; ") || "暂无记录";
-    // 未解决的问题 (struggles)
-    const struggles = all.facets
-        .filter((f) => f.type === "struggle" && (!f.facetData || (f.facetData.kind === "struggle" && !f.facetData.solution)))
-        .slice(0, 8)
-        .map((f) => f.facetData?.kind === "struggle" ? f.facetData.problem : (f.summary || f.detail || ""))
-        .filter(Boolean)
-        .join("; ") || "暂无记录";
-    // 经验教训
-    const lessons = all.lessons
-        .slice(0, 10)
-        .map((l) => l.summary || l.detail || l.content || "")
-        .filter(Boolean)
-        .join("; ") || "暂无记录";
-    // 错误统计
-    const errorCounts = {};
-    for (const ep of all.episodes) {
-        for (const err of ep.errors || []) {
-            const key = err.slice(0, 50).trim();
-            errorCounts[key] = (errorCounts[key] || 0) + 1;
+        return acc;
+    }, {});
+    const languageCounts = all.episodes.reduce((acc, episode) => {
+        for (const file of episode.filesModified ?? []) {
+            const ext = file.includes(".") ? file.split(".").pop()?.toLowerCase() ?? "other" : "other";
+            acc[ext] = (acc[ext] ?? 0) + 1;
         }
-    }
-    const errors = Object.keys(errorCounts).length > 0
-        ? Object.entries(errorCounts)
+        return acc;
+    }, {});
+    const errorCounts = all.episodes.reduce((acc, episode) => {
+        for (const error of episode.errors ?? []) {
+            const key = error.replace(/\s+/g, " ").trim().slice(0, 120);
+            if (!key)
+                continue;
+            acc[key] = (acc[key] ?? 0) + 1;
+        }
+        return acc;
+    }, {});
+    const resolvedStruggles = all.facets.filter((entry) => entry.type === "struggle" && entry.facetData?.kind === "struggle" && !!entry.facetData.solution);
+    const unresolvedStruggles = all.facets.filter((entry) => entry.type === "struggle" && entry.facetData?.kind === "struggle" && !entry.facetData.solution);
+    const patternEntries = all.facets.filter((entry) => entry.type === "pattern" && entry.facetData?.kind === "pattern");
+    const topTools = Object.entries(toolCounts)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 8);
+    const topLanguages = Object.entries(languageCounts)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 8);
+    const topErrors = Object.entries(errorCounts)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 8);
+    const topPatterns = patternEntries
+        .slice()
+        .sort((a, b) => (b.accessCount + 1) * b.importance - (a.accessCount + 1) * a.importance)
+        .slice(0, 6)
+        .map((entry) => ({
+        trigger: entry.facetData?.kind === "pattern" ? entry.facetData.trigger : "",
+        behavior: entry.facetData?.kind === "pattern" ? entry.facetData.behavior : "",
+        importance: entry.importance,
+        accessCount: entry.accessCount,
+    }));
+    const notableWins = resolvedStruggles.slice(0, 6).map((entry) => ({
+        problem: entry.facetData?.kind === "struggle" ? entry.facetData.problem : entry.summary || "",
+        solution: entry.facetData?.kind === "struggle" ? entry.facetData.solution : "",
+        importance: entry.importance,
+    }));
+    const notableFrictions = unresolvedStruggles.slice(0, 6).map((entry) => ({
+        problem: entry.facetData?.kind === "struggle" ? entry.facetData.problem : entry.summary || "",
+        attempts: entry.facetData?.kind === "struggle" ? entry.facetData.attempts : [],
+        importance: entry.importance,
+    }));
+    const topLessons = all.lessons
+        .slice()
+        .sort((a, b) => (b.accessCount + 1) * b.importance - (a.accessCount + 1) * a.importance)
+        .slice(0, 8)
+        .map((entry) => entry.summary || entry.detail || entry.content || "")
+        .filter(Boolean);
+    const projectCounts = all.episodes.reduce((acc, episode) => {
+        const key = episode.project || "default";
+        acc[key] = (acc[key] ?? 0) + 1;
+        return acc;
+    }, {});
+    return {
+        overview: {
+            totalSessions: all.meta.totalSessions,
+            episodes: all.episodes.length,
+            workEntries: all.work.length,
+            knowledgeEntries: all.knowledge.length,
+            lessonEntries: all.lessons.length,
+            preferenceEntries: all.preferences.length,
+            facetEntries: all.facets.length,
+            totalToolUses,
+            resolvedStruggleCount: resolvedStruggles.length,
+            unresolvedStruggleCount: unresolvedStruggles.length,
+        },
+        topTools: topTools.map(([tool, count]) => ({
+            tool,
+            count,
+            share: totalToolUses > 0 ? Number(((count / totalToolUses) * 100).toFixed(1)) : 0,
+        })),
+        topLanguages: topLanguages.map(([language, fileCount]) => ({ language, fileCount })),
+        topErrors: topErrors.map(([error, count]) => ({ error, count })),
+        topPatterns,
+        notableWins,
+        notableFrictions,
+        topLessons,
+        projectDistribution: Object.entries(projectCounts)
             .sort((a, b) => b[1] - a[1])
-            .slice(0, 10)
-            .map(([e, c]) => `${e} (${c}次)`)
-            .join("; ")
-        : "暂无错误记录";
-    return { tools, languages, wins, struggles, lessons, errors };
+            .slice(0, 6)
+            .map(([project, sessions]) => ({ project, sessions })),
+        evidenceDigest: {
+            tools: summarizeCounts(topTools, (tool, count) => `${tool}: ${count} uses`),
+            languages: summarizeCounts(topLanguages, (language, count) => `${language}: ${count} files`),
+            errors: summarizeCounts(topErrors, (error, count) => `${error}: ${count} times`),
+        },
+    };
 }
 function parseHumanInsightsResponse(raw) {
     try {
         const cleaned = raw.replace(/```json?\n?/g, "").replace(/```/g, "").trim();
         const parsed = JSON.parse(cleaned);
-        // Validate structure
-        if (typeof parsed !== "object" || parsed === null)
+        if (typeof parsed !== "object" || parsed === null) {
             return null;
+        }
         const persona = parsed.persona
             ? {
                 whatTheyDo: String(parsed.persona.whatTheyDo || ""),
                 experienceLevel: String(parsed.persona.experienceLevel || ""),
-                superpowers: Array.isArray(parsed.persona.superpowers)
-                    ? parsed.persona.superpowers.map(String)
-                    : [],
-                painPoints: Array.isArray(parsed.persona.painPoints)
-                    ? parsed.persona.painPoints.map(String)
-                    : [],
+                superpowers: Array.isArray(parsed.persona.superpowers) ? parsed.persona.superpowers.map(String) : [],
+                painPoints: Array.isArray(parsed.persona.painPoints) ? parsed.persona.painPoints.map(String) : [],
                 workStyle: String(parsed.persona.workStyle || ""),
                 summary: String(parsed.persona.summary || ""),
             }
             : undefined;
         const insights = Array.isArray(parsed.insights)
-            ? parsed.insights.map((i) => ({
-                title: String(i.title || ""),
-                content: String(i.content || ""),
-                icon: String(i.icon || "💡"),
-                utility: ["high", "medium", "low"].includes(String(i.utility))
-                    ? String(i.utility)
+            ? parsed.insights
+                .map((item) => ({
+                title: String(item.title || "").trim(),
+                content: String(item.content || "").trim(),
+                icon: String(item.icon || "Insight").trim(),
+                utility: ["high", "medium", "low"].includes(String(item.utility))
+                    ? String(item.utility)
                     : "medium",
-                tags: Array.isArray(i.tags)
-                    ? i.tags.map(String)
-                    : [],
+                tags: Array.isArray(item.tags) ? item.tags.map(String) : [],
             }))
+                .filter((item) => item.title && item.content)
             : [];
         const rootCauses = Array.isArray(parsed.rootCauses)
-            ? parsed.rootCauses.map((r) => ({
-                symptom: String(r.symptom || ""),
-                rootCause: String(r.rootCause || ""),
-                evidence: Array.isArray(r.evidence)
-                    ? r.evidence.map(String)
-                    : [],
-                suggestion: String(r.suggestion || ""),
+            ? parsed.rootCauses
+                .map((item) => ({
+                symptom: String(item.symptom || "").trim(),
+                rootCause: String(item.rootCause || "").trim(),
+                evidence: Array.isArray(item.evidence) ? item.evidence.map(String) : [],
+                suggestion: String(item.suggestion || "").trim(),
             }))
+                .filter((item) => item.symptom && item.rootCause)
             : [];
         return { persona, insights, rootCauses };
     }
@@ -120,26 +205,14 @@ function parseHumanInsightsResponse(raw) {
         return null;
     }
 }
-/**
- * 生成大白话版洞察报告
- */
 export async function generateHumanInsights(all, llmFn, locale) {
-    // 如果没有 LLM，返回空结果
     if (!llmFn) {
         return { humanInsights: [], rootCauses: [] };
     }
-    const p = PROMPTS[locale] || PROMPTS.en;
     const data = buildHumanInsightsData(all);
-    // 构建用户 prompt，替换模板变量
-    let userPrompt = p.humanInsightsUserTemplate;
-    userPrompt = userPrompt.replace("{{tools}}", data.tools);
-    userPrompt = userPrompt.replace("{{languages}}", data.languages);
-    userPrompt = userPrompt.replace("{{wins}}", data.wins);
-    userPrompt = userPrompt.replace("{{struggles}}", data.struggles);
-    userPrompt = userPrompt.replace("{{lessons}}", data.lessons);
-    userPrompt = userPrompt.replace("{{errors}}", data.errors);
+    const userPrompt = JSON.stringify({ locale, reviewData: data });
     try {
-        const raw = await llmFn(p.humanInsightsSystemPrompt, userPrompt);
+        const raw = await llmFn(HUMAN_INSIGHTS_SYSTEM_PROMPT, userPrompt);
         const parsed = parseHumanInsightsResponse(raw);
         if (parsed) {
             return {
@@ -150,18 +223,12 @@ export async function generateHumanInsights(all, llmFn, locale) {
         }
     }
     catch {
-        // Fallback to empty
+        // Fall back to empty enhanced insights when the LLM path is unavailable.
     }
     return { humanInsights: [], rootCauses: [] };
 }
-/**
- * 将人类可读洞察合并到 FullInsightsReport 生成流程中
- */
 export async function buildEnhancedInsightsReport(all, llmFn, locale) {
-    // 这个函数会在 engine.ts 中被调用来生成完整报告
-    // 目前 placeholder - 实际逻辑在对应的调用处
     const humanData = await generateHumanInsights(all, llmFn, locale);
-    // 返回一个基础结构，实际的完整报告会在调用处构建
     return {
         stats: {
             knowledge: all.knowledge.length,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pencil-agent/nano-pencil",
-  "version": "1.11.7",
+  "version": "1.11.8",
   "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": {
@@ -65,11 +65,11 @@
     "hosted-git-info": "^9.0.2",
     "ignore": "^7.0.5",
     "marked": "^15.0.12",
-    "minimatch": "^10.1.1",
-    "proper-lockfile": "^4.1.2",
-    "yaml": "^2.8.2",
-    "zod": "^4.3.6"
-  },
+    "minimatch": "^10.1.1",
+    "proper-lockfile": "^4.1.2",
+    "yaml": "^2.8.2",
+    "zod": "^4.3.6"
+  },
   "bundledDependencies": [
     "@pencil-agent/agent-core",
     "@pencil-agent/ai",