@gloablehive/celphone-wechat-plugin 1.0.0

package/dist/src/cache/types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Cache Types - Type definitions for WeChat cache system
+ *
+ * Aligned with Claude Code memory system:
+ * - 4 types: user, conversation, template, policy
+ * - YAML frontmatter format
+ * - Per-account isolation
+ */
+export type CacheType = 'user' | 'conversation' | 'template' | 'policy';
+export type ConversationSubtype = 'friend' | 'chatroom';
+export type MessageDirection = 'inbound' | 'outbound';
+export interface CacheFrontmatter {
+    name: string;
+    description: string;
+    type: CacheType;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ConversationFrontmatter extends CacheFrontmatter {
+    type: 'conversation';
+    subtype: ConversationSubtype;
+    wechatId: string;
+    accountId: string;
+    accountWechatId: string;
+    lastContact: string;
+    messageCount: number;
+}
+export interface UserProfileFrontmatter extends CacheFrontmatter {
+    type: 'user';
+    wechatId: string;
+    accountId: string;
+    tags: string[];
+    addedAt: string;
+    lastContact: string;
+}
+export interface TemplateFrontmatter extends CacheFrontmatter {
+    type: 'template';
+    trigger?: string;
+}
+export interface PolicyFrontmatter extends CacheFrontmatter {
+    type: 'policy';
+    version: string;
+    effectiveFrom: string;
+}
+export interface WeChatMessage {
+    messageId: string;
+    msgSvrId?: string;
+    accountId: string;
+    conversationType: ConversationSubtype;
+    conversationId: string;
+    senderId: string;
+    content: string;
+    messageType: number;
+    timestamp: number;
+    isSelf: boolean;
+    direction: MessageDirection;
+}
+export interface MessageBlock {
+    timestamp: string;
+    sender: string;
+    content: string;
+}
+export interface UserProfile {
+    wechatId: string;
+    accountId: string;
+    remark: string;
+    nickName: string;
+    avatarUrl?: string;
+    tags: string[];
+    customFields: Record<string, any>;
+    conversationSummary?: string;
+    preferenceHints?: string;
+    riskFlags: string[];
+    addedAt: string;
+    lastContact: string;
+}
+export interface ProfileUpdate {
+    remark?: string;
+    tags?: string[];
+    customFields?: Record<string, any>;
+    conversationSummary?: string;
+    preferenceHints?: string;
+    riskFlags?: string[];
+}
+export interface SessionMemory {
+    sessionTitle: string;
+    currentState: string;
+    taskSpecification: string;
+    filesAndFunctions: string;
+    workflow: string;
+    errorsAndCorrections: string;
+    codebaseDocumentation: string;
+    learnings: string;
+    keyResults: string;
+    worklog: string;
+}
+export interface MemoryItem {
+    path: string;
+    name: string;
+    description: string;
+    type: CacheType;
+    lastModified: number;
+    relevanceScore?: number;
+}
+export interface MemorySearchResult {
+    items: MemoryItem[];
+    query: string;
+    searchTime: number;
+}
+export interface ExtractionResult {
+    summary: string;
+    keyPoints: string[];
+    userProfileUpdate: Partial<ProfileUpdate>;
+    learnings: string;
+    actionItems?: string[];
+}
+export interface CompactConfig {
+    microCompactKeep: number;
+    microCompactThreshold: number;
+    autoCompactThreshold: number;
+    fullCompactThreshold: number;
+    sessionCompactThreshold: number;
+}
+export declare const DEFAULT_COMPACT_CONFIG: CompactConfig;
+export type SyncMode = 'realtime' | 'interval' | 'manual';
+export interface SyncConfig {
+    databaseUrl: string;
+    syncMode: SyncMode;
+    syncIntervalMs: number;
+    lastSyncTimestamp: number;
+}
+export interface SyncResult {
+    recordsSynced: number;
+    duration: number;
+    errors: string[];
+}
+export interface SyncLog {
+    id: string;
+    syncType: 'full' | 'incremental';
+    startedAt: number;
+    completedAt?: number;
+    recordsCount: number;
+    status: 'pending' | 'completed' | 'failed';
+    error?: string;
+}
+export interface SAASConfig {
+    apiBaseUrl: string;
+    apiKey: string;
+    timeout: number;
+    retryAttempts: number;
+    offlineThreshold: number;
+}
+export interface ConnectionStatus {
+    isOnline: boolean;
+    lastConnected: number;
+    consecutiveFailures: number;
+    offlineDuration: number;
+}
+export declare const DEFAULT_SAAS_CONFIG: SAASConfig;
+export type QueuedMessageStatus = 'pending' | 'synced' | 'failed';
+export interface QueuedMessage {
+    id: string;
+    message: WeChatMessage;
+    retryCount: number;
+    createdAt: number;
+    status: QueuedMessageStatus;
+    lastRetryAt?: number;
+    error?: string;
+}
+export interface WeChatAccount {
+    accountId: string;
+    wechatAccountId: string;
+    wechatId: string;
+    nickName: string;
+    enabled: boolean;
+}
+export interface IndexEntry {
+    path: string;
+    name: string;
+    description: string;
+    type: CacheType;
+    lastContact?: string;
+    messageCount?: number;
+}
+export interface AccountIndex {
+    accountId: string;
+    wechatId: string;
+    entries: IndexEntry[];
+    totalFriends: number;
+    totalChatrooms: number;
+    lastUpdated: number;
+}
+export declare function getAccountCachePath(basePath: string, accountId: string): string;
+export declare function getFriendPath(basePath: string, accountId: string, wechatId: string): string;
+export declare function getChatroomPath(basePath: string, accountId: string, chatroomId: string): string;
+export declare function getProfilePath(basePath: string, accountId: string, wechatId: string): string;
+export declare function getMonthlyFilePath(wechatId: string, date: Date): string;
+export declare function getConversationId(wechatId: string, accountId: string): string;

package/dist/src/cache/types.js

@@ -0,0 +1,43 @@
+/**
+ * Cache Types - Type definitions for WeChat cache system
+ *
+ * Aligned with Claude Code memory system:
+ * - 4 types: user, conversation, template, policy
+ * - YAML frontmatter format
+ * - Per-account isolation
+ */
+export const DEFAULT_COMPACT_CONFIG = {
+    microCompactKeep: 10,
+    microCompactThreshold: 5000,
+    autoCompactThreshold: 167000,
+    fullCompactThreshold: 180000,
+    sessionCompactThreshold: 100000,
+};
+export const DEFAULT_SAAS_CONFIG = {
+    apiBaseUrl: '',
+    apiKey: '',
+    timeout: 5000,
+    retryAttempts: 3,
+    offlineThreshold: 5 * 60 * 1000, // 5 minutes
+};
+// ========== File Path Helpers ==========
+export function getAccountCachePath(basePath, accountId) {
+    return `${basePath}/accounts/${accountId}`;
+}
+export function getFriendPath(basePath, accountId, wechatId) {
+    return `${basePath}/accounts/${accountId}/friends/${wechatId}`;
+}
+export function getChatroomPath(basePath, accountId, chatroomId) {
+    return `${basePath}/accounts/${accountId}/chatrooms/${chatroomId}`;
+}
+export function getProfilePath(basePath, accountId, wechatId) {
+    return `${basePath}/accounts/${accountId}/profiles/${wechatId}.md`;
+}
+export function getMonthlyFilePath(wechatId, date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    return `${year}-${month}.md`;
+}
+export function getConversationId(wechatId, accountId) {
+    return `${accountId}:${wechatId}`;
+}

package/dist/src/cache/writer.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Cache Writer - File writing with monthly partition
+ *
+ * Aligned with Claude Code memory system:
+ * - YAML frontmatter for metadata
+ * - Markdown content
+ * - Monthly file partitioning
+ */
+import { WeChatMessage, ConversationSubtype, UserProfile, SessionMemory } from './types.js';
+/**
+ * Get or create conversation directory
+ */
+export declare function ensureConversationDir(basePath: string, accountId: string, subtype: ConversationSubtype, conversationId: string): Promise<string>;
+/**
+ * Get monthly conversation file path
+ */
+export declare function getConversationFilePath(basePath: string, accountId: string, subtype: ConversationSubtype, conversationId: string, date: Date): string;
+/**
+ * Check if conversation file exists
+ */
+export declare function conversationFileExists(filePath: string): Promise<boolean>;
+/**
+ * Read conversation file
+ */
+export declare function readConversationFile(filePath: string): Promise<string>;
+/**
+ * Create new conversation file with frontmatter
+ */
+export declare function createConversationFile(filePath: string, wechatId: string, accountId: string, accountWechatId: string, subtype: ConversationSubtype): Promise<void>;
+/**
+ * Append message to conversation file
+ */
+export declare function appendMessageToConversation(filePath: string, message: WeChatMessage, remark?: string): Promise<void>;
+/**
+ * Get profile file path
+ */
+export declare function getProfileFilePath(basePath: string, accountId: string, wechatId: string): string;
+/**
+ * Create or update profile file
+ */
+export declare function writeProfile(filePath: string, profile: UserProfile): Promise<void>;
+/**
+ * Read profile file
+ */
+export declare function readProfile(filePath: string): Promise<UserProfile | null>;
+/**
+ * Update profile fields
+ */
+export declare function updateProfileFields(filePath: string, updates: Partial<UserProfile>): Promise<void>;
+/**
+ * Get session memory file path
+ */
+export declare function getSessionMemoryPath(basePath: string, accountId: string, conversationId: string): string;
+/**
+ * Write session memory (aligned with Claude Code 10-section template)
+ */
+export declare function writeSessionMemory(filePath: string, session: SessionMemory): Promise<void>;
+/**
+ * Read session memory
+ */
+export declare function readSessionMemory(filePath: string): Promise<SessionMemory | null>;
+/**
+ * Get summary file path
+ */
+export declare function getSummaryPath(basePath: string, accountId: string, subtype: ConversationSubtype, conversationId: string, yearMonth: string): string;
+/**
+ * Write AI summary
+ */
+export declare function writeSummary(filePath: string, summary: string, keyPoints: string[], learnings: string, actionItems?: string[]): Promise<void>;
+/**
+ * Ensure directory exists
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * Delete file if exists
+ */
+export declare function deleteFile(filePath: string): Promise<void>;
+/**
+ * List files in directory
+ */
+export declare function listFiles(dirPath: string, pattern?: string): Promise<string[]>;