cc-haha/adapters/common/__tests__/format.test.ts
程序员阿江(Relakkes) ca62d1b24f docs: clarify IM setup and command discovery
The WeChat and DingTalk IM docs were behind the actual desktop adapter flow, especially around QR binding versus user pairing and how users discover slash commands when no platform menu exists. This records the setup path with screenshots and nudges paired users toward /help from the bot itself.

Constraint: DingTalk does not expose the same menu setup path documented for Feishu, so command discovery must work through chat text.
Rejected: Document commands only in VitePress | users may be on mobile when they need the commands.
Confidence: high
Scope-risk: narrow
Directive: Keep IM command docs aligned with adapters/common/format.ts when adding commands.
Tested: cd adapters && bun test common/ dingtalk/ wechat/
Tested: cd adapters && bunx tsc --noEmit
Tested: bun run check:docs
Tested: bun run check:adapters
Not-tested: Live WeChat or DingTalk message delivery with real platform accounts
2026-05-05 21:08:55 +08:00

151 lines
4.7 KiB
TypeScript

import { describe, it, expect } from 'bun:test'
import {
formatImHelp,
formatImStatus,
splitMessage,
formatToolUse,
formatPermissionRequest,
truncateInput,
escapeMarkdownV2,
} from '../format.js'
describe('splitMessage', () => {
it('returns single chunk for short text', () => {
expect(splitMessage('hello', 100)).toEqual(['hello'])
})
it('splits at paragraph boundary', () => {
const text = 'First paragraph.\n\nSecond paragraph.'
const chunks = splitMessage(text, 20)
expect(chunks.length).toBeGreaterThan(1)
expect(chunks.join(' ').replace(/\s+/g, ' ')).toContain('First paragraph')
expect(chunks.join(' ').replace(/\s+/g, ' ')).toContain('Second paragraph')
})
it('splits at newline if no paragraph break', () => {
const text = 'Line one\nLine two\nLine three\nLine four'
const chunks = splitMessage(text, 20)
expect(chunks.length).toBeGreaterThan(1)
})
it('hard-splits at limit if no natural break', () => {
const text = 'a'.repeat(50)
const chunks = splitMessage(text, 20)
expect(chunks.length).toBe(3) // 20 + 20 + 10
expect(chunks.every((c) => c.length <= 20)).toBe(true)
})
it('preserves all content after splitting', () => {
const text = 'Hello world. This is a test. Foo bar baz.'
const chunks = splitMessage(text, 15)
const joined = chunks.join(' ')
// All words should be present
expect(joined).toContain('Hello')
expect(joined).toContain('test')
expect(joined).toContain('baz')
})
})
describe('formatToolUse', () => {
it('includes tool name and input preview', () => {
const result = formatToolUse('Bash', { command: 'npm test' })
expect(result).toContain('🔧 Bash')
expect(result).toContain('npm test')
})
})
describe('formatPermissionRequest', () => {
it('includes tool name, input preview, and request ID', () => {
const result = formatPermissionRequest('Bash', { command: 'rm -rf /' }, 'abcde')
expect(result).toContain('🔐')
expect(result).toContain('Bash')
expect(result).toContain('abcde')
expect(result).toContain('rm -rf')
})
})
describe('truncateInput', () => {
it('returns short input as-is', () => {
expect(truncateInput('hello', 100)).toBe('hello')
})
it('truncates long input with ellipsis', () => {
const long = 'x'.repeat(300)
const result = truncateInput(long, 100)
expect(result.length).toBe(101) // 100 chars + '…'
expect(result.endsWith('…')).toBe(true)
})
it('handles objects by stringifying', () => {
const result = truncateInput({ key: 'value' }, 100)
expect(result).toContain('key')
expect(result).toContain('value')
})
it('handles unserializable input', () => {
const circular: any = {}
circular.self = circular
expect(truncateInput(circular, 100)).toBe('(unserializable)')
})
})
describe('escapeMarkdownV2', () => {
it('escapes special characters', () => {
expect(escapeMarkdownV2('hello_world')).toBe('hello\\_world')
expect(escapeMarkdownV2('a*b*c')).toBe('a\\*b\\*c')
expect(escapeMarkdownV2('test.md')).toBe('test\\.md')
})
it('leaves plain text unchanged', () => {
expect(escapeMarkdownV2('hello world')).toBe('hello world')
})
})
describe('formatImHelp', () => {
it('lists the lightweight IM commands', () => {
const text = formatImHelp()
expect(text).toContain('/new')
expect(text).toContain('/projects')
expect(text).toContain('/status')
expect(text).toContain('/clear')
expect(text).toContain('/stop')
expect(text).toContain('/help')
expect(text).toContain('项目列表')
expect(text).toContain('/allow <id>')
})
})
describe('formatImStatus', () => {
it('formats an active session summary for mobile reading', () => {
const text = formatImStatus({
sessionId: 'abc1234567890',
projectName: 'claude-code-haha',
branch: 'main',
model: 'claude-sonnet',
state: 'tool_executing',
verb: 'Running tests',
pendingPermissionCount: 1,
taskCounts: {
total: 4,
pending: 1,
inProgress: 2,
completed: 1,
},
})
expect(text).toContain('项目: claude-code-haha (main)')
expect(text).toContain('会话: abc12345…')
expect(text).toContain('模型: claude-sonnet')
expect(text).toContain('状态: 执行工具中 (Running tests)')
expect(text).toContain('审批: 1 个待确认')
expect(text).toContain('任务: 总计 4 · 进行中 2 · 待处理 1 · 已完成 1')
})
it('returns a friendly empty-session message when nothing is active', () => {
const text = formatImStatus(null)
expect(text).toContain('当前没有活动会话')
expect(text).toContain('/new')
expect(text).toContain('/projects')
})
})