@chenpengfei/daily-brief 0.1.0

package/dist/src/brief/daily-brief.js

@@ -0,0 +1,234 @@
+import { formatDateKey } from "../config/index.js";
+export function generateLowSignalDailyBrief(input) {
+    const date = input.date.toISOString().slice(0, 10);
+    const enabledSources = input.sources.filter((source) => source.enabled);
+    const disabledSources = input.sources.length - enabledSources.length;
+    return [
+        `# Daily Brief - ${date}`,
+        "",
+        "## Executive Summary",
+        "",
+        "今天是 low-signal day：当前 Collection Window 没有可用于生成 Top Signals 的 Source Items。系统仍然生成 Brief，以确认每日链路可运行，并避免用弱信号填充内容。",
+        "",
+        "## Top Signals",
+        "",
+        "暂无可引用的 Signals。没有 Source Item 引用支撑的判断不会进入 Daily Brief。",
+        "",
+        "## Source Coverage",
+        "",
+        input.sources.length === 0
+            ? "Source Registry 当前为空；本次运行没有可采集的 Sources。"
+            : `读取到 ${input.sources.length} 个 Sources，其中 ${enabledSources.length} 个启用，${disabledSources} 个停用。本次基础链路尚未接入真实 Fetch Adapter，因此没有产生 Source Items。`,
+        "",
+        "## Sources",
+        "",
+        input.sources.length === 0
+            ? "- None configured."
+            : input.sources
+                .map((source) => {
+                const state = source.enabled ? "enabled" : "disabled";
+                return `- ${source.id} (${source.platform}, ${source.adapter}, ${state}) - ${source.target}`;
+            })
+                .join("\n"),
+        ""
+    ].join("\n");
+}
+export function generateDailyBrief(input) {
+    const relevantItems = input.sourceItems.filter((item) => isBriefEligibleSourceItem(item) && isRelevantSourceItem(item));
+    const signals = buildSignals(relevantItems);
+    const sourceIds = new Set(input.sourceItems.map((item) => item.sourceId));
+    return {
+        date: input.date,
+        ...(input.dateKey ? { dateKey: input.dateKey } : {}),
+        executiveSummary: signals.length === 0
+            ? "今天是 low-signal day：没有足够 Source-grounded 的 Agent Architecture 或 AI Coding Signals。"
+            : `今天有 ${signals.length} 个 Source-grounded Signals，均保留 Source Item citation 以便回溯。`,
+        signals,
+        sourceCoverage: {
+            sourceItemCount: input.sourceItems.length,
+            sourceCount: input.sourceCount ?? sourceIds.size,
+            partialFailures: input.partialFailures ?? []
+        }
+    };
+}
+function isBriefEligibleSourceItem(item) {
+    if (item.platform !== "github") {
+        return true;
+    }
+    return !item.url.includes("github.com/sponsors/");
+}
+export function renderDailyBriefMarkdown(brief) {
+    const date = brief.dateKey ?? formatDateKey(brief.date);
+    return [
+        `# Daily Brief - ${date}`,
+        "",
+        "## Executive Summary",
+        "",
+        brief.executiveSummary,
+        "",
+        "## Top Signals",
+        "",
+        brief.signals.length === 0
+            ? "暂无可引用的 Signals。没有 Source Item 引用支撑的判断不会进入 Daily Brief。"
+            : brief.signals.map(renderSignal).join("\n\n"),
+        "",
+        "## Source Coverage",
+        "",
+        renderSourceCoverage(brief.sourceCoverage),
+        "",
+        "## Sources",
+        "",
+        renderSources(brief.signals),
+        ""
+    ].join("\n");
+}
+function buildSignals(items) {
+    const groups = new Map();
+    for (const item of items) {
+        const key = normalizeSignalKey(item);
+        groups.set(key, [...(groups.get(key) ?? []), item]);
+    }
+    return [...groups.entries()].map(([key, group]) => {
+        const primary = group[0];
+        if (!primary) {
+            throw new Error(`Cannot build Signal for empty group: ${key}`);
+        }
+        return {
+            id: `signal:${key}`,
+            type: classifySignal(primary),
+            title: primary.title,
+            summary: summarizeSignal(primary),
+            whyItMatters: explainWhyItMatters(primary),
+            citations: group.map((item) => ({
+                sourceItemId: item.id,
+                sourceId: item.sourceId,
+                title: item.title,
+                url: item.url
+            }))
+        };
+    });
+}
+function isRelevantSourceItem(item) {
+    const text = `${item.title} ${item.analyzableText}`.toLowerCase();
+    const terms = [
+        "agent architecture",
+        "agent runtime",
+        "agentic coding",
+        "coding agent",
+        "ai coding",
+        "tool execution",
+        "eval",
+        "memory",
+        "workflow",
+        "source-grounded",
+        "mcp"
+    ];
+    return terms.some((term) => text.includes(term));
+}
+function classifySignal(item) {
+    const text = `${item.title} ${item.analyzableText}`.toLowerCase();
+    if (text.includes("risk") || text.includes("failure") || text.includes("security")) {
+        return "risk";
+    }
+    if (text.includes("coding agent") || text.includes("ai coding")) {
+        return "ai-coding";
+    }
+    if (item.platform === "github" || text.includes("repo") || text.includes("tool repo")) {
+        return "tool-repo";
+    }
+    return "architecture";
+}
+function explainWhyItMatters(item) {
+    const type = classifySignal(item);
+    const reasonByType = {
+        architecture: "它提供了 Agent Architecture 的具体实现或设计线索，值得进一步阅读原文。",
+        "ai-coding": "它影响工程团队使用 Coding Agents 构建和维护软件的实践方式。",
+        "tool-repo": "它指向一个可能改变 Agent 工具链或实现选择的项目/工具信号。",
+        risk: "它提示了构建或运行 Agent 系统时需要显式管理的风险。"
+    };
+    return reasonByType[type];
+}
+function summarizeSignal(item) {
+    const type = classifySignal(item);
+    const description = sourceGroundedDescription(item);
+    const whatItIs = item.platform === "github"
+        ? `它是一个 GitHub repository：${description}`
+        : `它是一个 Source-grounded Signal：${description}`;
+    return {
+        whatItIs,
+        whatItIsNot: explainWhatItIsNot(item, type),
+        minimalExample: explainMinimalExample(item, type)
+    };
+}
+function sourceGroundedDescription(item) {
+    const metadataDescription = readMetadataString(item.metadata, "description");
+    return cleanupDescription(metadataDescription ?? item.analyzableText);
+}
+function readMetadataString(metadata, key) {
+    const value = metadata?.[key];
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
+function cleanupDescription(value) {
+    const withoutMomentum = value
+        .replace(/\s+Momentum:.*$/i, "")
+        .replace(/\s+Ordinary commits are not treated as Source Items by this adapter\.$/i, "");
+    const withoutTrendingPrefix = withoutMomentum.replace(/^(Sponsor\s+)?Star\s+[\w.-]+\s+\/\s+[\w.-]+\s+/i, "");
+    const trimmed = withoutTrendingPrefix.replace(/\s+/g, " ").trim();
+    return trimmed.replace(/[。.!?]+$/u, "");
+}
+function explainWhatItIsNot(item, type) {
+    return `不是${unsupportedClaimBoundary(item, type)}；当前只代表它在本次 Source Items 中形成了 ${type} Signal。`;
+}
+function unsupportedClaimBoundary(item, type) {
+    if (item.platform === "github" || type === "tool-repo") {
+        return "对项目成熟度或适用性的背书";
+    }
+    return "未引用来源支撑的通用观点";
+}
+function explainMinimalExample(item, type) {
+    if (type === "tool-repo") {
+        return `最小地看，先阅读 ${item.title} 的 README 或最小使用路径，再判断它是否适合当前工具链。`;
+    }
+    if (type === "risk") {
+        return "最小地看，把它转成一条检查项，确认当前 Agent workflow 是否显式处理同类风险。";
+    }
+    if (type === "ai-coding") {
+        return "最小地看，用一个小型 repo 或单个 review workflow 验证它对 AI Coding 实践的影响。";
+    }
+    return "最小地看，用它对照一个 Agent runtime 的 state、tool execution 或 workflow 边界。";
+}
+function normalizeSignalKey(item) {
+    return item.url.trim().toLowerCase();
+}
+function renderSignal(signal) {
+    return [
+        `### ${signal.title}`,
+        "",
+        `- 领域: ${renderLensValues(signal.focusAreas)}`,
+        `- 方向: ${renderLensValues(signal.directions)}`,
+        `- 是什么: ${signal.summary.whatItIs}`,
+        `- 不是什么: ${signal.summary.whatItIsNot}`,
+        `- 最小例子: ${signal.summary.minimalExample}`,
+        `- 为什么重要: ${signal.whyItMatters}`,
+        `- 引用: ${signal.citations.map((citation) => citation.sourceItemId).join(", ")}`
+    ].join("\n");
+}
+function renderLensValues(values) {
+    return values && values.length > 0 ? values.join(" / ") : "未标注";
+}
+function renderSourceCoverage(coverage) {
+    const base = `Processed ${coverage.sourceItemCount} Source Items from ${coverage.sourceCount} Sources.`;
+    if (coverage.partialFailures.length === 0) {
+        return base;
+    }
+    return `${base}\nPartial failures: ${coverage.partialFailures.join("; ")}`;
+}
+function renderSources(signals) {
+    const citations = signals.flatMap((signal) => signal.citations);
+    if (citations.length === 0) {
+        return "- None cited.";
+    }
+    return citations
+        .map((citation) => `- ${citation.sourceItemId}: [${citation.title}](${citation.url})`)
+        .join("\n");
+}

package/dist/src/brief/index.js

@@ -0,0 +1 @@
+export * from "./daily-brief.js";