@zhin.js/plugin-group-suite 3.0.2 → 3.0.4

package/README.md

@@ -1,80 +1,64 @@
 # @zhin.js/plugin-group-suite
 
-群运营一体化插件（**破坏性合并**，替代以下独立包，不再维护）：
+Plugin Runtime 群运营能力包，提供签到积分、消息统计、关键词回复与群问答。所有能力
+由 `commands/`、`middlewares/` 和 `agent/` 约定目录发现，不注册 legacy Plugin 回调。
 
-- `@zhin.js/plugin-group-admin`
-- `@zhin.js/plugin-checkin`
-- `@zhin.js/plugin-stats`
-- `@zhin.js/plugin-group-daily-analysis`
-- `@zhin.js/plugin-teach`
-
-## 安装
+## 安装与拓扑
 
 ```bash
 pnpm add @zhin.js/plugin-group-suite
 ```
 
-旧包已在 npm 标记废弃（维护者执行）：
+父插件在 `package.json#zhin.plugins` 中声明子插件：
 
-```bash
-npm login   # 或 export NODE_AUTH_TOKEN=...
-node scripts/deprecate-group-legacy-packages.mjs
+```json
+{
+  "package": "@zhin.js/plugin-group-suite",
+  "instanceKey": "group-suite"
+}
 ```
 
-## 配置（扁平 `groupSuite`，多数项有默认值）
+配置位于该实例的层级节点：
 
 ```yaml
 plugins:
-  - "@zhin.js/plugin-group-suite"
-
-# 可选：stats / 群分析 等 html 段自动出图（pnpm add @zhin.js/html-renderer，无需写 plugins 列表）
-
-database:
-  dialect: sqlite
-  filename: ./data/bot.db
-
-inbox:
-  enabled: true   # 群日报需要
-
-# 可整段省略，使用默认值
-groupSuite:
-  noticeAdapters: [icqq]
-  autoAnalysisEnabled: true
-  autoAnalysisCron: "0 9 * * *"
+  group-suite:
+    keywordReply: false
+    basePointsMin: 10
+    basePointsMax: 30
+    streakBonus: 5
+    streakCap: 50
+    rankSize: 10
+    teachMaxPerGroup: 200
+    teachCooldownMs: 3000
+    teachAllowRegex: true
+    teachPageSize: 10
 ```
 
-常用可选字段（单层，无需 `admin:` / `checkin:` 等嵌套）：
-
-| 字段 | 默认 | 说明 |
-|------|------|------|
-| `welcome` | 欢迎新成员… | 入群欢迎语 |
-| `recallNotify` | `true` | 撤回提示 |
-| `keywordReply` | `false` | 内置关键词（建议用 teach） |
-| `noticeAdapters` | `[icqq]` | 处理 notice 的适配器 |
-| `basePointsMin` / `basePointsMax` | 10 / 30 | 签到积分 |
-| `rankSize` | 10 | 签到与统计排行人数 |
-| `statsRetentionDays` | 90 | 统计保留天数 |
-| `analysisDays` | 1 | 群分析天数 |
-| `analysisGroups` | `[]` | 日报白名单（空=不限制） |
-| `analysisGroupsBlock` | `[]` | 日报黑名单 |
-| `teachMaxPerGroup` | 200 | 每群问答上限 |
-| `teachCooldownMs` | 3000 | 问答冷却（毫秒） |
+完整约束以 [`schema.json`](./schema.json) 为 SSOT。数据优先写入 Runtime
+`DatabaseHost`；未配置数据库时使用插件实例私有的内存存储，适合测试。
 
-## 统计与群分析出图
+数据库、关键词、教学冷却和消息统计缓冲统一封装为 owner-scoped
+`GroupSuiteRuntime`。commands/middlewares 只通过 Capability Context 解析该资源；因此同一
+进程中的多个实例、HMR 新旧 generation 不会共享可变状态。
 
-`stats`、`mystats`、`群分析` 等命令返回 **`segment.html({ html })`**，由出站链统一处理：
+## 能力
 
-- 安装 **`@zhin.js/html-renderer`**（`pnpm add`，无需 plugins 列表）→ 自动渲染为 PNG 卡片
-- 未安装 → core 从 HTML 自动剥离纯文本（零业务侧 detect）
+| 路径 | 说明 |
+|---|---|
+| `checkin` / `mypoints` / `rank` | 签到、积分与排行 |
+| `stats` / `stats-week` / `stats-rank` / `mystats` | 消息统计 |
+| `teach` / `teach-regex` / `teach-list` / `forget` | 群问答管理 |
+| `keyword-add` / `keyword-list` / `keyword-remove` | 关键词回复管理 |
+| `middlewares/*` | 入站统计、关键词和问答匹配 |
+| `agent/tools/group_announce.ts` | 可选 Agent 群公告工具 |
 
-卡片 HTML 在 `stats-card.ts` / `analysis-card.ts` 中用 **`@zhin.js/satori`** 的 `h()` 与内置组件构建，视觉对齐 test-bot 的 `zt-report-card`。
+本 major 不包含 Adapter side-event 欢迎/撤回、AI 群日报或 HTML 报表。这些旧能力
+需要独立的事件与渲染 Feature，已从 schema 移除，避免出现“可配置但不生效”的字段。
 
-## 命令
+## 验证
 
-| 命令 | 模块 |
-|------|------|
-| `签到` / `checkin` / `mypoints` / `rank` | 签到 |
-| `stats` / `stats-week` / `stats-rank` / `mystats` | 统计 |
-| `群分析` / `分析设置` | 日报 |
-| `teach` / `teach-regex` / `forget` / `teach-list` | 问答（`teach 问题 回答` 或 `teach 问题\|答案`） |
-| `添加关键词` … | 仅 `keywordReply: true` |
+```bash
+pnpm --filter @zhin.js/plugin-group-suite build
+pnpm --filter @zhin.js/plugin-group-suite test
+```

package/agent/tools/group_announce.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 
-export default defineTool<{ message: string }>({
+export default defineAgentTool<{ message: string }>({
   description: '向群聊发送公告/通知消息',
   inputSchema: z.object({ message: z.string().min(1) }),
   keywords: ['群公告', '通知', 'announce'],

package/commands/checkin.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../src/config.js';
+import { doCheckin } from '../src/checkin-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '每日签到获得积分',
+  execute({ config, input, owner, use }) {
+    return doCheckin(input ?? {}, resolveGroupSuiteConfig(config), resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/commands/forget.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import type { GroupSuiteConfig } from '../src/config.js';
+import { teachForget } from '../src/teach-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '忘记问答（删除问答对）',
+  execute({ input, args, owner, use }) {
+    return teachForget(input ?? {}, args.join(' '), resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/commands/keyword-add/[keyword:string].ts

@@ -0,0 +1,15 @@
+import { defineCommand } from '@zhin.js/command';
+import { addKeyword } from '../../src/keyword-store.js';
+import type { GroupSuiteConfig } from '../../src/config.js';
+import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig>({
+  description: '添加关键词自动回复',
+  execute({ params, args, owner, use }) {
+    const keyword = String(params.keyword ?? '');
+    const reply = args.join(' ').trim();
+    if (!keyword || !reply) return '请提供关键词和回复内容';
+    addKeyword(keyword, reply, resolveGroupSuiteRuntime({ owner, use })?.keywords);
+    return `已添加关键词「${keyword}」→「${reply}」`;
+  },
+});

package/commands/keyword-list.ts

@@ -0,0 +1,14 @@
+import { defineCommand } from '@zhin.js/command';
+import { listKeywords } from '../src/keyword-store.js';
+import type { GroupSuiteConfig } from '../src/config.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig>({
+  description: '查看所有关键词回复对',
+  execute({ owner, use }) {
+    const entries = listKeywords(resolveGroupSuiteRuntime({ owner, use })?.keywords);
+    if (entries.length === 0) return '当前没有设置任何关键词';
+    const lines = entries.map(([k, v], i) => `${i + 1}. 「${k}」→「${v}」`);
+    return `关键词列表（共 ${entries.length} 条）：\n${lines.join('\n')}`;
+  },
+});

package/commands/keyword-remove/[keyword:string].ts

@@ -0,0 +1,14 @@
+import { defineCommand } from '@zhin.js/command';
+import { removeKeyword } from '../../src/keyword-store.js';
+import type { GroupSuiteConfig } from '../../src/config.js';
+import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig>({
+  description: '删除关键词自动回复',
+  execute({ params, owner, use }) {
+    const keyword = String(params.keyword ?? '');
+    if (!keyword) return '请提供要删除的关键词';
+    if (!removeKeyword(keyword, resolveGroupSuiteRuntime({ owner, use })?.keywords)) return `关键词「${keyword}」不存在`;
+    return `已删除关键词「${keyword}」`;
+  },
+});

package/commands/mypoints.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import type { GroupSuiteConfig } from '../src/config.js';
+import { myPoints } from '../src/checkin-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '查看个人积分与签到信息',
+  execute({ input, owner, use }) {
+    return myPoints(input ?? {}, resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/commands/mystats.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import type { GroupSuiteConfig } from '../src/config.js';
+import { myStatsText } from '../src/stats-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '查看个人消息统计',
+  execute({ input, owner, use }) {
+    return myStatsText(input ?? {}, resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/commands/rank.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../src/config.js';
+import { pointsRank } from '../src/checkin-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '查看积分排行榜',
+  execute({ config, input, owner, use }) {
+    return pointsRank(input ?? {}, resolveGroupSuiteConfig(config), resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/commands/stats-rank.ts

@@ -0,0 +1,20 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../src/config.js';
+import { monthStartStr, resolveGroupId, statsRankText } from '../src/stats-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '查看本月话唠排行',
+  execute({ config, input, owner, use }) {
+    const groupId = resolveGroupId(input ?? {});
+    const title = groupId ? '本月话唠排行' : '全局话唠排行';
+    return statsRankText(
+      input ?? {},
+      resolveGroupSuiteConfig(config),
+      monthStartStr(),
+      title,
+      resolveGroupSuiteRuntime({ owner, use }),
+    );
+  },
+});

package/commands/stats-week.ts

@@ -0,0 +1,20 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../src/config.js';
+import { resolveGroupId, statsRankText, weekStartStr } from '../src/stats-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '查看本周消息统计',
+  execute({ config, input, owner, use }) {
+    const groupId = resolveGroupId(input ?? {});
+    const title = groupId ? '本周本群消息统计' : '本周全局消息统计';
+    return statsRankText(
+      input ?? {},
+      resolveGroupSuiteConfig(config),
+      weekStartStr(),
+      title,
+      resolveGroupSuiteRuntime({ owner, use }),
+    );
+  },
+});

package/commands/stats.ts

@@ -0,0 +1,21 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../src/config.js';
+import { todayStr } from '../src/shared-runtime.js';
+import { resolveGroupId, statsRankText } from '../src/stats-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '查看今日消息统计',
+  execute({ config, input, owner, use }) {
+    const groupId = resolveGroupId(input ?? {});
+    const title = groupId ? '今日本群消息统计' : '今日全局消息统计';
+    return statsRankText(
+      input ?? {},
+      resolveGroupSuiteConfig(config),
+      todayStr(),
+      title,
+      resolveGroupSuiteRuntime({ owner, use }),
+    );
+  },
+});

package/commands/teach-list/[page:number=1].ts

@@ -0,0 +1,13 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../../src/config.js';
+import { teachList } from '../../src/teach-lib.js';
+import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '查看问答列表',
+  execute({ config, input, params, owner, use }) {
+    const page = Number(params.page ?? 1);
+    return teachList(input ?? {}, resolveGroupSuiteConfig(config), page, resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/commands/teach-regex.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../src/config.js';
+import { teachAdd } from '../src/teach-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '教我正则问答',
+  execute({ config, input, args, owner, use }) {
+    return teachAdd(input ?? {}, resolveGroupSuiteConfig(config), args.join(' '), true, resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/commands/teach.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../src/config.js';
+import { teachAdd } from '../src/teach-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '教我问答（teach 问题 回答 或 问题|答案）',
+  execute({ config, input, args, owner, use }) {
+    return teachAdd(input ?? {}, resolveGroupSuiteConfig(config), args.join(' '), false, resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/lib/analysis-card.d.ts

@@ -0,0 +1,4 @@
+import type { AnalysisReportData } from "./analysis.js";
+export declare const ANALYSIS_REPORT_CANVAS: "#d8dce3";
+export declare function buildAnalysisReportHtml(data: AnalysisReportData): string;
+//# sourceMappingURL=analysis-card.d.ts.map

package/lib/analysis-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-card.d.ts","sourceRoot":"","sources":["../src/analysis-card.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAQxD,eAAO,MAAM,sBAAsB,WAAoB,CAAC;AAUxD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAqExE"}

package/lib/analysis-card.js.map

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

package/lib/analysis.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 群日常分析：从收件箱查询、基础统计、文本报告。
+ * 数据源为 zhin 内置 unified_inbox_message 表（需 inbox.enabled）。
+ *
+ * 话题/金句/用户画像分析逻辑灵感来自：
+ * https://github.com/SXP-Simon/astrbot_plugin_qq_group_daily_analysis
+ */
+export interface InboxMessageRow {
+    id?: number;
+    adapter: string;
+    endpoint_id: string;
+    channel_id: string;
+    channel_type: string;
+    sender_id: string;
+    sender_name: string | null;
+    content: string;
+    /** 收件箱里可能是字符串，也可能被 ORM/驱动解析成对象 */
+    raw: unknown;
+    created_at: number;
+}
+export interface BasicStats {
+    messageCount: number;
+    participantCount: number;
+    totalChars: number;
+    hourlyDistribution: Record<number, number>;
+    mostActiveHour: number;
+}
+/** 话题摘要（灵感来自 astrbot_plugin_qq_group_daily_analysis） */
+export interface SummaryTopic {
+    topic: string;
+    summary?: string;
+}
+/** 金句（灵感来自 astrbot_plugin_qq_group_daily_analysis） */
+export interface GoldenQuote {
+    content: string;
+    sender: string;
+    reason: string;
+}
+/** 用户称号/画像（灵感来自 astrbot_plugin_qq_group_daily_analysis） */
+export interface UserTitle {
+    name: string;
+    user_id: string;
+    title: string;
+    reason?: string;
+}
+export interface LLMAnalysis {
+    topics: SummaryTopic[];
+    quotes: GoldenQuote[];
+    userTitles: UserTitle[];
+}
+export interface AnalysisReportMeta {
+    channelName?: string;
+    days: number;
+    startDate: string;
+    endDate: string;
+}
+export interface AnalysisReportData extends AnalysisReportMeta {
+    stats: BasicStats;
+    llm?: LLMAnalysis;
+}
+export interface AnalysisResult {
+    stats: BasicStats;
+    textReport: string;
+    llm?: LLMAnalysis;
+    meta: AnalysisReportMeta;
+}
+export declare function buildAnalysisReportData(stats: BasicStats, meta: AnalysisReportMeta, llm?: LLMAnalysis): AnalysisReportData;
+/**
+ * 从 content (JSON) 或 raw 提取纯文本，用于统计与 LLM
+ */
+export declare function extractText(row: InboxMessageRow): string;
+/**
+ * 计算基础统计：消息数、人数、总字数、按小时分布、最活跃时段
+ */
+export declare function computeBasicStats(rows: InboxMessageRow[]): BasicStats;
+/**
+ * 生成纯文本报告（不含 LLM 内容）
+ */
+export declare function formatTextReport(stats: BasicStats, options: {
+    channelName?: string;
+    days: number;
+    startDate: string;
+    endDate: string;
+}): string;
+/**
+ * 将 LLM 分析结果追加到文本报告。
+ * 话题/金句/用户画像 设计灵感来自 astrbot_plugin_qq_group_daily_analysis
+ */
+export declare function appendLLMReport(textReport: string, llm: LLMAnalysis): string;
+/**
+ * 从 LLM 返回的文本中解析出 topics / quotes / userTitles。
+ * 约定 LLM 返回 JSON 或类似结构，此处做宽松解析。
+ */
+export declare function parseLLMResponse(raw: string): LLMAnalysis;
+//# sourceMappingURL=analysis.d.ts.map

package/lib/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../src/analysis.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,KAAK,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,kBAAkB,EACxB,GAAG,CAAC,EAAE,WAAW,GAChB,kBAAkB,CAEpB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CA2BxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,UAAU,CA+BrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClF,MAAM,CAqBR;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAuB5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAiCzD"}

package/lib/analysis.js.map

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

package/lib/card-layout.d.ts

@@ -0,0 +1,27 @@
+import { formatCount, StatChip } from "@zhin.js/satori";
+export declare const CARD_CANVAS: "#d8dce3";
+export declare const CARD_THEME: {
+    readonly canvas: "#d8dce3";
+    readonly card: "#ffffff";
+    readonly surface: "#f8f9fb";
+    readonly border: "rgba(0,0,0,0.05)";
+    readonly text: "#111111";
+    readonly textSecondary: "#3f3f46";
+    readonly textMuted: "#a1a1aa";
+    readonly barTrack: "rgba(0,0,0,0.06)";
+    readonly barWarn: "#f59e0b";
+    readonly barCrit: "#ef4444";
+    readonly accentCpu: "#10b981";
+    readonly accentMem: "#3b82f6";
+    readonly accentDisk: "#8b5cf6";
+    readonly accentSwap: "#ec4899";
+    readonly divider: "rgba(0,0,0,0.06)";
+    readonly shadowLg: "0 16px 40px rgba(15,23,42,0.14)";
+    readonly shadowMd: "0 8px 22px rgba(15,23,42,0.10)";
+    readonly shadowSm: "0 2px 8px rgba(15,23,42,0.07)";
+    readonly shadowFloor: "rgba(15,23,42,0.07)";
+};
+export { formatCount, StatChip };
+export declare function elevatedCard(inner: string): string;
+export declare function cardShell(inner: string, width?: number): string;
+//# sourceMappingURL=card-layout.d.ts.map

package/lib/card-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-layout.d.ts","sourceRoot":"","sources":["../src/card-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,WAAW,EAEX,QAAQ,EACT,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,WAAW,WAA4B,CAAC;AACrD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;CAAqB,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AAEjC,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,MAAM,CAE5D"}

package/lib/card-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-layout.js","sourceRoot":"","sources":["../src/card-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,CAAC,EACD,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC;AACrD,MAAM,CAAC,MAAM,UAAU,GAAG,kBAAkB,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AAEjC,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,KAAK,GAAG,GAAG;IAClD,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/lib/checkin-lib.d.ts

@@ -0,0 +1,18 @@
+import type { GroupSuiteConfig } from './config.js';
+import type { GroupSuiteRuntime } from './runtime-state.js';
+export declare function doCheckin(input: {
+    sender?: string;
+    target?: string;
+    metadata?: Readonly<Record<string, unknown>>;
+}, cfg: GroupSuiteConfig, runtime?: GroupSuiteRuntime): Promise<string>;
+export declare function myPoints(input: {
+    sender?: string;
+    target?: string;
+    metadata?: Readonly<Record<string, unknown>>;
+}, runtime?: GroupSuiteRuntime): Promise<string>;
+export declare function pointsRank(input: {
+    sender?: string;
+    target?: string;
+    metadata?: Readonly<Record<string, unknown>>;
+}, cfg: GroupSuiteConfig, runtime?: GroupSuiteRuntime): Promise<string>;
+//# sourceMappingURL=checkin-lib.d.ts.map

package/lib/checkin-lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkin-lib.d.ts","sourceRoot":"","sources":["../src/checkin-lib.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAUpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAsC5D,wBAAsB,SAAS,CAC7B,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,EACzF,GAAG,EAAE,gBAAgB,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAyCjB;AAED,wBAAsB,QAAQ,CAC5B,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,EACzF,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,EACzF,GAAG,EAAE,gBAAgB,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAsBjB"}