anno-extension 0.1.0

package/dist/full-insights-sections.js

@@ -0,0 +1,231 @@
+/**
+ * [WHO]: generateParallelFullInsightSections(), FullInsightsSectionPayload
+ * [FROM]: Depends on ./llm-json and ./types for structured LLM section generation
+ * [TO]: Consumed by full-insights.ts to improve /mem-insights narrative quality
+ * [HERE]: packages/mem-core/src/full-insights-sections.ts - Claude-style parallel section generation without copying upstream implementation
+ */
+import { parseLlmJson } from "./llm-json.js";
+const OBSERVER_VOICE_RULES = `Voice rules:
+- Be a warm but sharp long-term coding partner: kind, direct, observant.
+- Write like an observant agent keeping a private work diary and a practical field report for the user.
+- Tie every claim to the provided data; if evidence is thin, say the signal is still thin.
+- No generic praise, personality diagnosis, therapy language, motivational fluff, or invented emotion.
+- Each item should name the observed pattern, explain why it matters, and offer one next move when the schema allows.`;
+function compactContext(context) {
+    return {
+        locale: context.locale,
+        outputLanguage: context.outputLanguage,
+        stats: context.stats,
+        projectAreas: context.projectAreas.slice(0, 8).map((area) => ({
+            name: area.name,
+            sessionCount: area.sessionCount,
+            description: area.description,
+        })),
+        patterns: context.patterns.slice(0, 8).map((pattern) => ({
+            trigger: pattern.trigger,
+            behavior: pattern.behavior,
+            weight: Number(pattern.weight.toFixed(2)),
+        })),
+        struggles: context.struggles.slice(0, 8).map((struggle) => ({
+            problem: struggle.problem,
+            resolved: struggle.resolved,
+            attempts: struggle.attempts.slice(0, 3),
+            solution: struggle.solution,
+            weight: Number(struggle.weight.toFixed(2)),
+        })),
+        lessons: context.lessons.slice(0, 8).map((lesson) => lesson.summary || lesson.detail || lesson.content || ""),
+        topTools: context.topTools.slice(0, 8),
+        topLanguages: context.topLanguages.slice(0, 8),
+        topErrors: context.topErrors.slice(0, 8),
+    };
+}
+function sectionSpecs(outputLanguage) {
+    const languageRule = `Write the JSON string values in ${outputLanguage}, matching the user's observed language habits.`;
+    return [
+        {
+            name: "project_areas",
+            prompt: `${OBSERVER_VOICE_RULES}
+
+Identify the main project/work areas from this developer memory report. Describe each area as something you have been watching the user return to, including what that investment suggests about their current work.
+${languageRule}
+Return ONLY valid JSON:
+{"descriptions":["one description per provided project area, preserving order"]}`,
+        },
+        {
+            name: "wins",
+            prompt: `${OBSERVER_VOICE_RULES}
+
+Find concrete workflows that are working well. Make the wins feel seen, not flattered: recognize the user's effective habits with evidence from tools, lessons, resolved struggles, or project areas.
+${languageRule}
+Return ONLY valid JSON:
+{"wins":[{"title":"3-7 word title","description":"2-3 specific sentences"}]}`,
+        },
+        {
+            name: "frictions",
+            prompt: `${OBSERVER_VOICE_RULES}
+
+Find recurring friction. Be gentle with the user but incisive about the system of work: prefer root causes over symptoms, avoid blame, and include examples when available.
+${languageRule}
+Return ONLY valid JSON:
+{"frictions":[{"title":"short category","description":"1-2 sentences","examples":["specific example"]}]}`,
+        },
+        {
+            name: "recommendations",
+            prompt: `${OBSERVER_VOICE_RULES}
+
+Suggest direct behavior changes. Each recommendation should read like a useful note from a partner who has watched the pattern before: observation, why it matters, next move for the next session.
+${languageRule}
+Return ONLY valid JSON:
+{"recommendations":["recommendation sentence"]}`,
+        },
+        {
+            name: "features",
+            prompt: `${OBSERVER_VOICE_RULES}
+
+Suggest Catui features or workflows this user should try based on their actual usage. Prefer skills, MCP, hooks, headless commands, subagents, recap, memory, or token-save only when evidence supports it; explain why it fits this user's observed habits.
+${languageRule}
+Return ONLY valid JSON:
+{"featuresToTry":[{"title":"feature/workflow","oneLiner":"what it does","whyForYou":"why this user should try it","exampleCode":"optional command or config"}]}`,
+        },
+        {
+            name: "usage_patterns",
+            prompt: `${OBSERVER_VOICE_RULES}
+
+Suggest reusable prompt/workflow patterns. Make each one copyable and grounded in the reported friction or wins, as if you are leaving the user a practical note for how to begin next time.
+${languageRule}
+Return ONLY valid JSON:
+{"usagePatterns":[{"title":"pattern","summary":"short summary","detail":"how to apply it","pastePrompt":"copyable prompt"}]}`,
+        },
+    ];
+}
+async function generateSection(spec, contextJson, llmFn) {
+    try {
+        const raw = await llmFn("You write structured developer usage insights as a warm but sharp long-term coding partner. Output only valid JSON matching the requested schema.", `${spec.prompt}\n\nDATA:\n${contextJson}`);
+        const parsed = parseLlmJson(raw);
+        return { name: spec.name, result: parsed && typeof parsed === "object" ? parsed : null };
+    }
+    catch {
+        return { name: spec.name, result: null };
+    }
+}
+function asStringArray(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const items = value.filter((item) => typeof item === "string" && item.trim().length > 0);
+    return items.length ? items : undefined;
+}
+function asWins(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const wins = value
+        .map((item) => item)
+        .filter((item) => typeof item.title === "string" && typeof item.description === "string")
+        .map((item) => ({ title: item.title, description: item.description }));
+    return wins.length ? wins : undefined;
+}
+function asFrictions(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const frictions = value
+        .map((item) => item)
+        .filter((item) => typeof item.title === "string" && typeof item.description === "string")
+        .map((item) => ({
+        title: item.title,
+        description: item.description,
+        examples: Array.isArray(item.examples)
+            ? item.examples.filter((example) => typeof example === "string")
+            : undefined,
+    }));
+    return frictions.length ? frictions : undefined;
+}
+function asFeatures(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const features = value
+        .map((item) => item)
+        .filter((item) => typeof item.title === "string" && typeof item.oneLiner === "string" && typeof item.whyForYou === "string")
+        .map((item) => ({
+        title: item.title,
+        oneLiner: item.oneLiner,
+        whyForYou: item.whyForYou,
+        exampleCode: typeof item.exampleCode === "string" ? item.exampleCode : undefined,
+    }));
+    return features.length ? features : undefined;
+}
+function asUsagePatterns(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const patterns = value
+        .map((item) => item)
+        .filter((item) => typeof item.title === "string" && typeof item.summary === "string" && typeof item.detail === "string")
+        .map((item) => ({
+        title: item.title,
+        summary: item.summary,
+        detail: item.detail,
+        pastePrompt: typeof item.pastePrompt === "string" ? item.pastePrompt : undefined,
+    }));
+    return patterns.length ? patterns : undefined;
+}
+function mergeSectionPayload(results) {
+    const payload = {};
+    for (const { name, result } of results) {
+        if (!result)
+            continue;
+        if (name === "project_areas")
+            payload.projectAreaDescriptions = asStringArray(result.descriptions);
+        if (name === "wins")
+            payload.wins = asWins(result.wins);
+        if (name === "frictions")
+            payload.frictions = asFrictions(result.frictions);
+        if (name === "recommendations")
+            payload.recommendations = asStringArray(result.recommendations);
+        if (name === "features")
+            payload.featuresToTry = asFeatures(result.featuresToTry);
+        if (name === "usage_patterns")
+            payload.usagePatterns = asUsagePatterns(result.usagePatterns);
+    }
+    return payload;
+}
+async function generateAtAGlance(contextJson, sections, llmFn, outputLanguage) {
+    const languageRule = `Write concise natural ${outputLanguage}, matching the user's observed language habits.`;
+    try {
+        const raw = await llmFn("You write executive summaries for developer usage reports. Output only valid JSON.", `${OBSERVER_VOICE_RULES}
+
+${languageRule}
+Synthesize the section outputs into four short, candid coaching blurbs. Make this read like the opening note of a private diary and field report from a long-term coding partner: intimate enough to feel observed, precise enough to be useful.
+Return ONLY valid JSON:
+{"working":"what is working","hindering":"what is hindering","quickWins":"quick wins to try","ambitious":"ambitious workflows to prepare for"}
+
+BASE DATA:
+${contextJson}
+
+SECTION OUTPUTS:
+${JSON.stringify(sections, null, 2)}`);
+        const parsed = parseLlmJson(raw);
+        if (typeof parsed?.working === "string" &&
+            typeof parsed.hindering === "string" &&
+            typeof parsed.quickWins === "string" &&
+            typeof parsed.ambitious === "string") {
+            return {
+                working: parsed.working,
+                hindering: parsed.hindering,
+                quickWins: parsed.quickWins,
+                ambitious: parsed.ambitious,
+            };
+        }
+    }
+    catch {
+        // Keep caller fallbacks.
+    }
+    return undefined;
+}
+export async function generateParallelFullInsightSections(context, llmFn) {
+    const contextJson = JSON.stringify(compactContext(context), null, 2);
+    const results = await Promise.all(sectionSpecs(context.outputLanguage).map((spec) => generateSection(spec, contextJson, llmFn)));
+    const payload = mergeSectionPayload(results);
+    const atAGlance = await generateAtAGlance(contextJson, payload, llmFn, context.outputLanguage);
+    if (atAGlance)
+        payload.atAGlance = atAGlance;
+    return payload;
+}
+//# sourceMappingURL=full-insights-sections.js.map

package/dist/full-insights-sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-insights-sections.js","sourceRoot":"","sources":["../src/full-insights-sections.ts"],"names":[],"mappings":"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"}

package/dist/full-insights.d.ts

@@ -0,0 +1,22 @@
+/**
+ * [WHO]: FullInsightsReport, generateFullInsights
+ * [FROM]: Depends on ./i18n.js, ./full-insights-sections.js, ./types.js
+ * [TO]: Consumed by packages/mem-core/src/index.ts
+ * [HERE]: packages/mem-core/src/full-insights.ts - aggregation + optional LLM for comprehensive insights report
+ */
+import type { Episode, FullInsightsReport, LlmFn, MemoryEntry, WorkEntry } from "./types.js";
+export interface ExportAllResult {
+    knowledge: MemoryEntry[];
+    lessons: MemoryEntry[];
+    preferences: MemoryEntry[];
+    facets: MemoryEntry[];
+    work: WorkEntry[];
+    episodes: Episode[];
+    meta: {
+        totalSessions: number;
+        lastConsolidation?: string;
+        version: number;
+    };
+}
+export declare function buildFullInsightsReport(all: ExportAllResult, llmFn: LlmFn | undefined, locale: string): Promise<FullInsightsReport>;
+//# sourceMappingURL=full-insights.d.ts.map

package/dist/full-insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-insights.d.ts","sourceRoot":"","sources":["../src/full-insights.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACX,OAAO,EAKP,kBAAkB,EAIlB,KAAK,EACL,WAAW,EAGX,SAAS,EACT,MAAM,YAAY,CAAC;AAkBpB,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,WAAW,EAAE,WAAW,EAAE,CAAC;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,IAAI,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E;AA6QD,wBAAsB,uBAAuB,CAC5C,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,CAAC,CAmG7B"}

package/dist/full-insights.js

@@ -0,0 +1,370 @@
+/**
+ * [WHO]: FullInsightsReport, generateFullInsights
+ * [FROM]: Depends on ./i18n.js, ./full-insights-sections.js, ./types.js
+ * [TO]: Consumed by packages/mem-core/src/index.ts
+ * [HERE]: packages/mem-core/src/full-insights.ts - aggregation + optional LLM for comprehensive insights report
+ */
+import { PROMPTS } from "./i18n.js";
+import { generateParallelFullInsightSections } from "./full-insights-sections.js";
+const EXT_TO_LANG = {
+    ts: "TypeScript",
+    js: "JavaScript",
+    jsx: "JSX",
+    tsx: "TSX",
+    md: "Markdown",
+    json: "JSON",
+    py: "Python",
+    html: "HTML",
+    css: "CSS",
+    yml: "YAML",
+    yaml: "YAML",
+    sh: "Shell",
+};
+function aggregateTools(episodes, topN = 10) {
+    const counts = {};
+    for (const ep of episodes) {
+        for (const [name, n] of Object.entries(ep.toolsUsed ?? {})) {
+            counts[name] = (counts[name] ?? 0) + n;
+        }
+    }
+    const rows = Object.entries(counts)
+        .map(([label, value]) => ({ label, value }))
+        .sort((a, b) => b.value - a.value)
+        .slice(0, topN);
+    return { id: "tools", title: "tools", rows };
+}
+function aggregateLanguages(episodes, topN = 8) {
+    const counts = {};
+    for (const ep of episodes) {
+        for (const path of ep.filesModified ?? []) {
+            const ext = path.includes(".") ? path.split(".").pop()?.toLowerCase() ?? "other" : "other";
+            const label = EXT_TO_LANG[ext] ?? ext;
+            counts[label] = (counts[label] ?? 0) + 1;
+        }
+    }
+    const rows = Object.entries(counts)
+        .filter(([label]) => label !== "other" || (counts[label] ?? 0) > 0)
+        .map(([label, value]) => ({ label, value }))
+        .sort((a, b) => b.value - a.value)
+        .slice(0, topN);
+    return { id: "languages", title: "languages", rows };
+}
+function aggregateErrors(episodes, topN = 8) {
+    const counts = {};
+    for (const ep of episodes) {
+        for (const err of ep.errors ?? []) {
+            const key = err.slice(0, 50).trim();
+            counts[key] = (counts[key] ?? 0) + 1;
+        }
+    }
+    const rows = Object.entries(counts)
+        .map(([label, value]) => ({ label, value }))
+        .sort((a, b) => b.value - a.value)
+        .slice(0, topN);
+    return { id: "errors", title: "errors", rows };
+}
+function buildProjectAreas(episodes, work) {
+    const byProject = new Map();
+    for (const ep of episodes) {
+        const p = ep.project || "default";
+        if (!byProject.has(p))
+            byProject.set(p, { count: 0, summaries: [], goals: [] });
+        const entry = byProject.get(p);
+        entry.count++;
+        if (ep.summary)
+            entry.summaries.push(ep.summary);
+        if (ep.userGoal)
+            entry.goals.push(ep.userGoal);
+    }
+    for (const w of work) {
+        const p = w.project || "default";
+        if (!byProject.has(p))
+            byProject.set(p, { count: 0, summaries: [], goals: [] });
+        const entry = byProject.get(p);
+        if (w.summary)
+            entry.summaries.push(w.summary);
+        if (w.goal)
+            entry.goals.push(w.goal);
+    }
+    return [...byProject.entries()]
+        .filter(([, v]) => v.count >= 1 || v.summaries.length + v.goals.length > 0)
+        .map(([name, v]) => ({
+        name,
+        sessionCount: v.count,
+        description: [v.summaries[0], v.goals[0]].filter(Boolean).join(" ").slice(0, 120) || "",
+    }))
+        .sort((a, b) => b.sessionCount - a.sessionCount)
+        .slice(0, 12);
+}
+function buildPatternsAndStruggles(facets) {
+    const patternEntries = facets.filter((e) => e.type === "pattern");
+    const struggleEntries = facets.filter((e) => e.type === "struggle");
+    const calcWeight = (e, unresolvedBonus = false) => {
+        const base = (e.accessCount + 1) * (e.importance / 10);
+        return unresolvedBonus ? base * 1.5 : base;
+    };
+    const patterns = patternEntries
+        .map((e) => ({
+        entry: e,
+        weight: calcWeight(e),
+        trigger: e.facetData?.kind === "pattern" ? e.facetData.trigger : (e.summary || e.detail || e.content || "").slice(0, 50),
+        behavior: e.facetData?.kind === "pattern" ? e.facetData.behavior : (e.summary || e.detail || e.content || ""),
+    }))
+        .sort((a, b) => b.weight - a.weight);
+    const struggles = struggleEntries
+        .map((e) => {
+        const isResolved = e.facetData?.kind === "struggle" ? !!e.facetData.solution : false;
+        return {
+            entry: e,
+            weight: calcWeight(e, !isResolved),
+            problem: e.facetData?.kind === "struggle" ? e.facetData.problem : (e.summary || e.detail || e.content || ""),
+            attempts: e.facetData?.kind === "struggle" ? e.facetData.attempts : [],
+            solution: e.facetData?.kind === "struggle" ? e.facetData.solution : "",
+            resolved: isResolved,
+        };
+    })
+        .sort((a, b) => (a.resolved !== b.resolved ? (a.resolved ? 1 : -1) : b.weight - a.weight));
+    return { patterns, struggles };
+}
+function fallbackAtAGlance(patterns, struggles, lessons, locale) {
+    const resolved = struggles.filter((s) => s.resolved);
+    const unresolved = struggles.filter((s) => !s.resolved);
+    const working = resolved.length > 0
+        ? `${resolved.length} struggles resolved; keep reusing those fixes.`
+        : lessons.length > 0
+            ? `${lessons.length} lessons captured; turn the top ones into checklists.`
+            : "No strong signal yet.";
+    const hindering = unresolved.length > 0
+        ? `${unresolved.length} open struggles remain. Most frequent: "${unresolved[0]?.problem ?? ""}".`
+        : "No unresolved struggles visible.";
+    const topPattern = patterns[0];
+    const quickWins = topPattern
+        ? `When ${topPattern.trigger}, you often ${topPattern.behavior}. Consider automating.`
+        : "Keep using the system; quick wins will appear as data grows.";
+    const ambitious = "Consider turning repeat workflows into skills or scripts and using parallel agents.";
+    return { working, hindering, quickWins, ambitious };
+}
+function fallbackWins(struggles, lessons) {
+    const wins = [];
+    for (const s of struggles.filter((x) => x.resolved).slice(0, 5)) {
+        wins.push({ title: s.problem.slice(0, 60), description: s.solution || s.problem });
+    }
+    const sortLessons = [...lessons].sort((a, b) => b.importance * (b.accessCount + 1) - a.importance * (a.accessCount + 1));
+    for (const l of sortLessons.slice(0, 3)) {
+        const text = l.summary || l.detail || l.content || "";
+        wins.push({ title: text.slice(0, 60), description: text });
+    }
+    return wins.slice(0, 8);
+}
+function fallbackFrictions(struggles) {
+    return struggles
+        .filter((s) => !s.resolved)
+        .slice(0, 8)
+        .map((s) => ({
+        title: s.problem.slice(0, 60),
+        description: s.problem,
+        examples: s.attempts.length ? s.attempts : undefined,
+    }));
+}
+function fallbackRecommendations(patterns, struggles, lessons, locale) {
+    const recs = [];
+    if (patterns.length > 0) {
+        const top = patterns[0];
+        recs.push(`You consistently ${top.behavior} when ${top.trigger}. Consider automating.`);
+    }
+    const unresolved = struggles.filter((s) => !s.resolved);
+    if (unresolved.length >= 2) {
+        recs.push(`You have ${unresolved.length} unresolved issues. Tackle them systematically.`);
+    }
+    if (lessons.length >= 5) {
+        recs.push(`You've accumulated ${lessons.length} lessons. Valuable expertise.`);
+    }
+    if (recs.length === 0) {
+        recs.push("Keep using the system to let it learn your habits.");
+    }
+    return recs.slice(0, 5);
+}
+function fallbackFeaturesAndPatterns(toolRows, struggles, locale) {
+    const featuresToTry = [];
+    const usagePatterns = [];
+    if (toolRows.length > 0) {
+        const topTool = toolRows[0].label;
+        featuresToTry.push({
+            title: "Automate frequent operations",
+            oneLiner: "Turn repeat workflows into skills or scripts",
+            whyForYou: `You use "${topTool}" often; consider wrapping it in a skill or command.`,
+        });
+    }
+    if (struggles.filter((s) => !s.resolved).length >= 2) {
+        usagePatterns.push({
+            title: "Batch large tasks",
+            summary: "Split large files or batches into smaller chunks",
+            detail: "Avoid context overflow by validating each batch before continuing.",
+            pastePrompt: "Break this into 3-4 steps; show me the result after each step before continuing.",
+        });
+    }
+    return { featuresToTry, usagePatterns };
+}
+function entryText(entry) {
+    return [entry.name, entry.summary, entry.detail, entry.content, entry.tags.join(" ")].filter(Boolean).join("\n");
+}
+function languageFromExplicitPreference(text) {
+    if (/(中文|汉语|Chinese|Mandarin|用中文|中文输出|中文交流)/i.test(text))
+        return { code: "zh", name: "Chinese" };
+    if (/(英文|英语|English|use English|write in English)/i.test(text))
+        return { code: "en", name: "English" };
+    if (/(日文|日语|日本語|Japanese)/i.test(text))
+        return { code: "ja", name: "Japanese" };
+    if (/(韩文|韩语|한국어|Korean)/i.test(text))
+        return { code: "ko", name: "Korean" };
+    if (/(法文|法语|français|French)/i.test(text))
+        return { code: "fr", name: "French" };
+    if (/(西班牙文|西班牙语|español|Spanish)/i.test(text))
+        return { code: "es", name: "Spanish" };
+    if (/(德文|德语|Deutsch|German)/i.test(text))
+        return { code: "de", name: "German" };
+    return undefined;
+}
+function languageFromScript(text) {
+    const han = (text.match(/\p{Script=Han}/gu) ?? []).length;
+    const kana = (text.match(/[\p{Script=Hiragana}\p{Script=Katakana}]/gu) ?? []).length;
+    const hangul = (text.match(/\p{Script=Hangul}/gu) ?? []).length;
+    const cyrillic = (text.match(/\p{Script=Cyrillic}/gu) ?? []).length;
+    const arabic = (text.match(/\p{Script=Arabic}/gu) ?? []).length;
+    const latinWords = (text.match(/[A-Za-z]{3,}/g) ?? []).length;
+    if (kana >= 4)
+        return { code: "ja", name: "Japanese" };
+    if (hangul >= 4)
+        return { code: "ko", name: "Korean" };
+    if (han >= 8 && han >= latinWords)
+        return { code: "zh", name: "Chinese" };
+    if (cyrillic >= 8)
+        return { code: "ru", name: "Russian" };
+    if (arabic >= 8)
+        return { code: "ar", name: "Arabic" };
+    if (latinWords >= 20 && han + kana + hangul + cyrillic + arabic === 0)
+        return { code: "en", name: "English" };
+    return undefined;
+}
+function fallbackLanguage(locale) {
+    if (locale === "zh")
+        return { code: "zh", name: "Chinese" };
+    if (locale === "en")
+        return { code: "en", name: "English" };
+    return { code: locale, name: locale };
+}
+function inferObservedReportLanguage(all, locale) {
+    const preferenceText = all.preferences.map(entryText).join("\n");
+    const explicit = languageFromExplicitPreference(preferenceText);
+    if (explicit)
+        return explicit;
+    const observedText = [
+        preferenceText,
+        ...all.episodes.flatMap((episode) => [
+            episode.summary,
+            episode.userGoal ?? "",
+            ...episode.keyObservations,
+            ...episode.tags,
+        ]),
+        ...all.work.flatMap((work) => [work.goal, work.summary, work.detail ?? "", ...work.tags]),
+        ...all.lessons.map(entryText),
+        ...all.knowledge.map(entryText),
+        ...all.facets.map(entryText),
+    ].join("\n");
+    return languageFromScript(observedText) ?? fallbackLanguage(locale);
+}
+export async function buildFullInsightsReport(all, llmFn, locale) {
+    const reportLanguage = inferObservedReportLanguage(all, locale);
+    const reportLocale = reportLanguage.code;
+    const p = PROMPTS[reportLocale] ?? PROMPTS.en;
+    const { patterns, struggles } = buildPatternsAndStruggles(all.facets);
+    const sortLessons = [...all.lessons].sort((a, b) => b.importance * (b.accessCount + 1) - a.importance * (a.accessCount + 1));
+    const topLessons = sortLessons.slice(0, 10);
+    const charts = [];
+    const toolsChart = aggregateTools(all.episodes);
+    let aggregateToolCount = 0;
+    for (const r of toolsChart.rows)
+        aggregateToolCount += r.value;
+    if (toolsChart.rows.length > 0)
+        charts.push({ ...toolsChart, title: p.fullInsightsChartTools });
+    const langChart = aggregateLanguages(all.episodes);
+    let aggregateFileCount = 0;
+    for (const r of langChart.rows)
+        aggregateFileCount += r.value;
+    if (langChart.rows.length > 0)
+        charts.push({ ...langChart, title: p.fullInsightsChartLanguages });
+    const errChart = aggregateErrors(all.episodes);
+    if (errChart.rows.length > 0)
+        charts.push({ ...errChart, title: p.fullInsightsChartErrors });
+    const projectAreas = buildProjectAreas(all.episodes, all.work);
+    const stats = {
+        knowledge: all.knowledge.length,
+        lessons: all.lessons.length,
+        preferences: all.preferences.length,
+        facets: all.facets.length,
+        episodes: all.episodes.length,
+        work: all.work.length,
+        totalSessions: all.meta.totalSessions,
+        aggregateToolCount,
+        aggregateFileCount,
+    };
+    let atAGlance = fallbackAtAGlance(patterns, struggles, topLessons, reportLocale);
+    let projectAreaDescriptions = projectAreas.map((a) => a.description);
+    let wins = fallbackWins(struggles, topLessons);
+    let frictions = fallbackFrictions(struggles);
+    let recommendations = fallbackRecommendations(patterns, struggles, topLessons, reportLocale);
+    let { featuresToTry, usagePatterns } = fallbackFeaturesAndPatterns(toolsChart.rows, struggles, reportLocale);
+    if (llmFn) {
+        try {
+            const payload = await generateParallelFullInsightSections({
+                locale: reportLocale,
+                outputLanguage: reportLanguage.name,
+                stats,
+                patterns,
+                struggles,
+                lessons: topLessons,
+                projectAreas,
+                topTools: toolsChart.rows,
+                topLanguages: langChart.rows,
+                topErrors: errChart.rows,
+            }, llmFn);
+            if (payload.atAGlance)
+                atAGlance = payload.atAGlance;
+            if (Array.isArray(payload.projectAreaDescriptions) && payload.projectAreaDescriptions.length >= projectAreas.length) {
+                projectAreaDescriptions = payload.projectAreaDescriptions.slice(0, projectAreas.length);
+            }
+            if (Array.isArray(payload.wins) && payload.wins.length > 0)
+                wins = payload.wins.slice(0, 8);
+            if (Array.isArray(payload.frictions) && payload.frictions.length > 0)
+                frictions = payload.frictions.slice(0, 8);
+            if (Array.isArray(payload.recommendations) && payload.recommendations.length > 0)
+                recommendations = payload.recommendations.slice(0, 5);
+            if (Array.isArray(payload.featuresToTry) && payload.featuresToTry.length > 0)
+                featuresToTry = payload.featuresToTry.slice(0, 6);
+            if (Array.isArray(payload.usagePatterns) && payload.usagePatterns.length > 0)
+                usagePatterns = payload.usagePatterns.slice(0, 6);
+        }
+        catch {
+            // keep fallbacks
+        }
+    }
+    const projectAreasWithDesc = projectAreas.map((a, i) => ({
+        ...a,
+        description: projectAreaDescriptions[i] ?? a.description,
+    }));
+    return {
+        stats,
+        atAGlance,
+        projectAreas: projectAreasWithDesc,
+        charts,
+        wins,
+        frictions,
+        patterns,
+        recommendations,
+        featuresToTry,
+        usagePatterns,
+        generatedAt: new Date().toISOString(),
+        locale: reportLocale,
+    };
+}
+//# sourceMappingURL=full-insights.js.map