ae-tracking 0.1.0

package/dist/src/cli/debug.js

@@ -0,0 +1,152 @@
+import { request } from 'undici';
+import { readFile } from 'node:fs/promises';
+import { getTokenPath } from './home.js';
+import { TEDebugClient } from '../te-debug/client.js';
+const DEFAULT_HOST = 'https://web-ta-demo.thinkingdata.cn';
+function formatTeTime(d) {
+    const pad = (n, w = 2) => String(n).padStart(w, '0');
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}.${pad(d.getMilliseconds(), 3)}`;
+}
+async function getToken(host) {
+    let cache;
+    try {
+        cache = JSON.parse(await readFile(getTokenPath(), 'utf8'));
+    }
+    catch {
+        throw new Error(`no cached token for ${host}; run 'ae-tracking auth login --host ${host}' first`);
+    }
+    const tok = cache[host]?.token;
+    if (!tok)
+        throw new Error(`no cached token for ${host}; run 'ae-tracking auth login --host ${host}' first`);
+    return tok;
+}
+function parseProps(prop) {
+    const out = {};
+    for (const kv of prop) {
+        const ix = kv.indexOf('=');
+        if (ix > 0)
+            out[kv.slice(0, ix)] = kv.slice(ix + 1);
+    }
+    return out;
+}
+function nowMinusOneHour() {
+    const d = new Date(Date.now() - 60 * 60 * 1000);
+    // YYYY-MM-DD HH:MM:SS in local time, matching what AE UI sends
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+}
+export function registerDebug(cmd) {
+    cmd.description('AE Debug-mode utilities (devices, test events, watch)');
+    // device subgroup
+    const device = cmd.command('device').description('manage AE Debug devices');
+    device.command('list')
+        .requiredOption('--project <id>', 'AE projectId', (v) => parseInt(v, 10))
+        .option('--host <url>', 'AE host', DEFAULT_HOST)
+        .action(async (opts) => {
+        const token = await getToken(opts.host);
+        const list = await new TEDebugClient({ host: opts.host, token }).listDevice(opts.project);
+        if (list.length === 0) {
+            console.log('(no devices)');
+            return;
+        }
+        console.log('deviceId\tdeviceName\tlastClearTime');
+        for (const d of list)
+            console.log(`${d.deviceId}\t${d.deviceName}\t${d.lastClearTime ?? ''}`);
+    });
+    device.command('add')
+        .requiredOption('--project <id>', 'AE projectId', (v) => parseInt(v, 10))
+        .requiredOption('--device-id <id>', 'device identifier (becomes #device_id when sending events)')
+        .requiredOption('--device-name <name>', 'human-readable label')
+        .option('--host <url>', 'AE host', DEFAULT_HOST)
+        .action(async (opts) => {
+        const token = await getToken(opts.host);
+        await new TEDebugClient({ host: opts.host, token }).addDevice(opts.project, opts.deviceId, opts.deviceName);
+        console.log(`ok: device ${opts.deviceId} added`);
+    });
+    device.command('select')
+        .requiredOption('--project <id>', 'AE projectId', (v) => parseInt(v, 10))
+        .requiredOption('--device-id <id>')
+        .option('--host <url>', 'AE host', DEFAULT_HOST)
+        .action(async (opts) => {
+        const token = await getToken(opts.host);
+        await new TEDebugClient({ host: opts.host, token }).selectDevice(opts.project, opts.deviceId);
+        console.log(`ok: device ${opts.deviceId} selected`);
+    });
+    device.command('remove')
+        .requiredOption('--project <id>', 'AE projectId', (v) => parseInt(v, 10))
+        .requiredOption('--device-id <id>')
+        .option('--host <url>', 'AE host', DEFAULT_HOST)
+        .action(async (opts) => {
+        const token = await getToken(opts.host);
+        await new TEDebugClient({ host: opts.host, token }).removeDevice(opts.project, opts.deviceId);
+        console.log(`ok: device ${opts.deviceId} removed`);
+    });
+    // send: REST API connectivity + format validation (debug=1 for detailed errors)
+    // NOTE: REST API events do NOT appear in AE Debug UI — that only shows
+    // events from SDK instances initialized with mode:'debug'. This command
+    // validates receiver reachability, appId correctness, and data format.
+    cmd.command('send')
+        .description('validate connectivity: POST a test event via REST API (does NOT appear in Debug UI)')
+        .requiredOption('--receiver <url>', 'AE data receiver URL')
+        .requiredOption('--appid <id>', 'AE appId')
+        .requiredOption('--event <name>', 'event name')
+        .option('--distinct-id <id>', '#distinct_id', 'claude-test')
+        .option('--prop <kv...>', 'k=v pairs (repeatable)', [])
+        .action(async (opts) => {
+        const body = {
+            appid: opts.appid,
+            debug: 1,
+            data: {
+                '#type': 'track',
+                '#event_name': opts.event,
+                '#time': formatTeTime(new Date()),
+                '#distinct_id': opts.distinctId,
+                properties: parseProps(opts.prop),
+            },
+        };
+        const url = opts.receiver.replace(/\/$/, '') + '/sync_json';
+        const { statusCode, body: resBody } = await request(url, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        const text = await resBody.text();
+        console.log(`HTTP ${statusCode}`);
+        console.log(text);
+        if (statusCode === 200) {
+            try {
+                const r = JSON.parse(text);
+                if (r.code === 0)
+                    console.log('\n✓ validation passed: receiver + appId + data format OK');
+                else
+                    console.log(`\n✗ validation failed: ${r.msg ?? 'unknown error'}`);
+            }
+            catch { }
+        }
+    });
+    // watch: one-shot snapshot of SDK debug events (requires SDK initialized with mode:'debug')
+    cmd.command('watch')
+        .description('pull events from a device running SDK in debug mode (one-shot snapshot)')
+        .requiredOption('--project <id>', 'AE projectId', (v) => parseInt(v, 10))
+        .requiredOption('--device-id <id>')
+        .option('--host <url>', 'AE host', DEFAULT_HOST)
+        .option('--since <iso>', 'startTime in YYYY-MM-DD HH:MM:SS local time (default: 1 hour ago)')
+        .action(async (opts) => {
+        const token = await getToken(opts.host);
+        const since = opts.since ?? nowMinusOneHour();
+        const data = await new TEDebugClient({ host: opts.host, token }).listDeviceData(opts.project, opts.deviceId, since);
+        const total = data.eventList.length + data.deviceDataList.length;
+        if (total === 0) {
+            console.log(`(no events received since ${since})`);
+            return;
+        }
+        console.log(`# eventList (${data.eventList.length}):`);
+        for (const e of data.eventList)
+            console.log('  ' + JSON.stringify(e));
+        console.log(`# deviceDataList (${data.deviceDataList.length}):`);
+        for (const e of data.deviceDataList)
+            console.log('  ' + JSON.stringify(e));
+        console.log('\n# raw');
+        console.log(JSON.stringify(data, null, 2));
+    });
+}

package/dist/src/cli/home.d.ts

@@ -0,0 +1,4 @@
+export declare function getHomeDir(): string;
+export declare function getTeTrackingDir(): string;
+export declare function getTokenPath(): string;
+export declare function getClaudeSkillsDir(): string;

package/dist/src/cli/home.js

@@ -0,0 +1,15 @@
+// src/cli/home.ts
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export function getHomeDir() {
+    return process.env.HOME ?? homedir();
+}
+export function getTeTrackingDir() {
+    return join(getHomeDir(), '.ae-tracking');
+}
+export function getTokenPath() {
+    return join(getTeTrackingDir(), 'tokens.json');
+}
+export function getClaudeSkillsDir() {
+    return join(getHomeDir(), '.claude', 'skills');
+}

package/dist/src/cli/init.d.ts

@@ -0,0 +1,14 @@
+import { Command } from 'commander';
+export interface InitOptions {
+    quiet?: boolean;
+    force?: boolean;
+    uninstall?: boolean;
+}
+export interface InitReport {
+    installed: string[];
+    skipped: string[];
+    conflicts: string[];
+    uninstalled: string[];
+}
+export declare function runInit(opts?: InitOptions): Promise<InitReport>;
+export declare function registerInit(cmd: Command): void;

package/dist/src/cli/init.js

@@ -0,0 +1,107 @@
+import { mkdir, readlink, lstat, unlink, symlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getPackageRoot } from './package-root.js';
+import { getClaudeSkillsDir, getTeTrackingDir } from './home.js';
+const SKILL_NAMES = ['generate-tracking-plan', 'generate-tracking-code'];
+async function linkTarget(path) {
+    try {
+        const s = await lstat(path);
+        if (!s.isSymbolicLink())
+            return 'NOT_SYMLINK';
+        return await readlink(path);
+    }
+    catch {
+        return null;
+    }
+}
+export async function runInit(opts = {}) {
+    const pkg = getPackageRoot();
+    const skillsDir = getClaudeSkillsDir();
+    await mkdir(skillsDir, { recursive: true });
+    const rep = { installed: [], skipped: [], conflicts: [], uninstalled: [] };
+    for (const name of SKILL_NAMES) {
+        const src = join(pkg, 'skills', name);
+        const dst = join(skillsDir, name);
+        const expected = src;
+        if (opts.uninstall) {
+            const t = await linkTarget(dst);
+            if (t === expected) {
+                await unlink(dst);
+                rep.uninstalled.push(name);
+            }
+            continue;
+        }
+        const t = await linkTarget(dst);
+        if (t === expected) {
+            rep.skipped.push(name);
+            continue;
+        }
+        if (t === null) {
+            await symlink(src, dst, 'dir');
+            rep.installed.push(name);
+            continue;
+        }
+        // Conflict: existing entry (third-party symlink OR real dir)
+        if (opts.force && t !== 'NOT_SYMLINK') {
+            await unlink(dst);
+            await symlink(src, dst, 'dir');
+            rep.installed.push(name);
+        }
+        else {
+            rep.conflicts.push(name);
+        }
+    }
+    // Wiki symlink: ~/.ae-tracking/wiki → <packageRoot>/wiki
+    const wikiSrc = join(pkg, 'wiki');
+    const wikiDst = join(getTeTrackingDir(), 'wiki');
+    if (!opts.uninstall) {
+        await mkdir(getTeTrackingDir(), { recursive: true });
+        const wt = await linkTarget(wikiDst);
+        if (wt === wikiSrc) {
+            if (!opts.quiet)
+                console.log('· skipped wiki (already linked)');
+        }
+        else if (wt === null) {
+            await symlink(wikiSrc, wikiDst, 'dir');
+            if (!opts.quiet)
+                console.log('✓ installed wiki');
+        }
+        else if (opts.force && wt !== 'NOT_SYMLINK') {
+            await unlink(wikiDst);
+            await symlink(wikiSrc, wikiDst, 'dir');
+            if (!opts.quiet)
+                console.log('✓ installed wiki (forced)');
+        }
+        else {
+            if (!opts.quiet)
+                console.warn('! conflict wiki — use --force or remove manually');
+        }
+    }
+    else {
+        const wt = await linkTarget(wikiDst);
+        if (wt === wikiSrc) {
+            await unlink(wikiDst);
+            if (!opts.quiet)
+                console.log('✗ uninstalled wiki');
+        }
+    }
+    if (!opts.quiet) {
+        for (const n of rep.installed)
+            console.log(`✓ installed ${n}`);
+        for (const n of rep.skipped)
+            console.log(`· skipped ${n} (already linked)`);
+        for (const n of rep.conflicts)
+            console.warn(`! conflict ${n} — use --force or remove manually`);
+        for (const n of rep.uninstalled)
+            console.log(`✗ uninstalled ${n}`);
+    }
+    return rep;
+}
+export function registerInit(cmd) {
+    cmd.description('install/uninstall Claude Code skills into ~/.claude/skills/')
+        .option('--force', 'overwrite conflicting third-party symlinks')
+        .option('--uninstall', 'remove symlinks that point to this package')
+        .action(async (opts) => {
+        await runInit({ force: opts.force, uninstall: opts.uninstall });
+    });
+}

package/dist/src/cli/package-root.d.ts

@@ -0,0 +1 @@
+export declare function getPackageRoot(): string;

package/dist/src/cli/package-root.js

@@ -0,0 +1,20 @@
+// src/cli/package-root.ts
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+export function getPackageRoot() {
+    let cur = dirname(fileURLToPath(import.meta.url));
+    while (cur !== dirname(cur)) {
+        const pj = join(cur, 'package.json');
+        if (existsSync(pj)) {
+            try {
+                const pkg = JSON.parse(readFileSync(pj, 'utf8'));
+                if (pkg.name === 'ae-tracking' || pkg.name === '@thinkingdata/ae-tracking')
+                    return cur;
+            }
+            catch { /* keep walking */ }
+        }
+        cur = dirname(cur);
+    }
+    throw new Error('getPackageRoot: could not find ae-tracking package.json in ancestor dirs');
+}

package/dist/src/cli/plan.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerPlan(cmd: Command): void;

package/dist/src/cli/plan.js

@@ -0,0 +1,242 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { getTokenPath } from './home.js';
+import { refreshToken } from './auth.js';
+import { writeDraftXlsx, validateDraft } from '../xlsx/write.js';
+import { TEClient } from '../client.js';
+import { fetchPlan } from '../te-plan/fetch.js';
+import { injectAutotrackEvents } from '../plan/draft.js';
+import { validateAndFix, fixDraft, extractErrors } from '../plan/fix.js';
+import { detectConflicts, formatConflictReport } from '../plan/conflict.js';
+const DEFAULT_HOST = 'https://web-ta-demo.thinkingdata.cn';
+const MAX_FIX_RETRIES = 3;
+/**
+ * 获取 token（支持自动刷新）
+ * @param host AE host
+ * @param autoRefresh token 过期时自动刷新（macOS 从 Chrome 获取）
+ */
+async function getToken(host, autoRefresh = false) {
+    let cache = {};
+    try {
+        cache = JSON.parse(await readFile(getTokenPath(), 'utf8'));
+    }
+    catch { /* ignore */ }
+    const tok = cache[host]?.token;
+    if (!tok) {
+        if (autoRefresh && process.platform === 'darwin') {
+            console.log('[auth] no cached token, attempting auto-refresh...');
+            return refreshToken(host);
+        }
+        throw new Error(`no cached token for ${host}; run 'ae-tracking auth login --host ${host}' first`);
+    }
+    return tok;
+}
+export function registerPlan(cmd) {
+    cmd.description('manage AE tracking plans');
+    cmd.command('draft')
+        .requiredOption('--in <path>', 'draft JSON input')
+        .requiredOption('--out <path>', 'xlsx output')
+        .option('--fix', 'auto fix validation errors', false)
+        .action(async (opts) => {
+        const draft = JSON.parse(await readFile(opts.in, 'utf8'));
+        // 注入 SDK 自动采集事件
+        injectAutotrackEvents(draft);
+        // 校验和自动修复
+        if (opts.fix) {
+            const fixed = validateAndFix(draft);
+            if (fixed.length > 0) {
+                console.log(`[plan-draft] auto-fixed: ${fixed.join(', ')}`);
+                await writeFile(opts.in, JSON.stringify(draft, null, 2), 'utf8');
+            }
+        }
+        // 尝试校验，如果失败且开启了 fix，尝试修复后重试
+        try {
+            validateDraft(draft);
+        }
+        catch (e) {
+            if (opts.fix) {
+                console.log(`[plan-draft] validation failed, attempting fix...`);
+                const fixed = validateAndFix(draft);
+                if (fixed.length > 0) {
+                    console.log(`[plan-draft] fixed: ${fixed.join(', ')}`);
+                    await writeFile(opts.in, JSON.stringify(draft, null, 2), 'utf8');
+                }
+            }
+            else {
+                throw e;
+            }
+        }
+        await writeDraftXlsx(draft, opts.out);
+        const counts = `events=${draft.events.length}, event_props=${draft.event_properties.length}, common=${draft.common_event_properties.length}, user=${draft.user_properties.length}`;
+        console.log(`wrote ${opts.out}  (${counts})`);
+    });
+    cmd.command('validate')
+        .requiredOption('--in <path>', 'draft JSON input')
+        .option('--fix', 'auto fix validation errors', false)
+        .action(async (opts) => {
+        const draft = JSON.parse(await readFile(opts.in, 'utf8'));
+        try {
+            validateDraft(draft);
+            console.log('✅ Draft validation passed');
+        }
+        catch (e) {
+            const errorMsg = e instanceof Error ? e.message : String(e);
+            console.log(`❌ Draft validation failed:\n${errorMsg}`);
+            if (opts.fix) {
+                console.log('\n🔧 Attempting auto-fix...');
+                const fixed = validateAndFix(draft);
+                if (fixed.length > 0) {
+                    console.log(`Fixed: ${fixed.join(', ')}`);
+                    await writeFile(opts.in, JSON.stringify(draft, null, 2), 'utf8');
+                    console.log(`Updated: ${opts.in}`);
+                    // 重新校验
+                    try {
+                        validateDraft(draft);
+                        console.log('✅ Validation passed after fix');
+                    }
+                    catch (e2) {
+                        console.log(`❌ Still has errors after fix: ${e2 instanceof Error ? e2.message : e2}`);
+                    }
+                }
+                else {
+                    console.log('No auto-fix available for these errors');
+                }
+            }
+        }
+    });
+    cmd.command('upload')
+        .requiredOption('--project <id>', 'AE projectId', (v) => parseInt(v, 10))
+        .requiredOption('--xlsx <path>', 'xlsx file')
+        .requiredOption('--draft <path>', 'draft JSON (for auto-fix)')
+        .option('--host <url>', 'AE host', DEFAULT_HOST)
+        .option('--replace', 'delete existing plan first', false)
+        .option('--auto-fix', 'auto fix upload errors and retry', true)
+        .action(async (opts) => {
+        // 使用自动刷新获取 token
+        let token = await getToken(opts.host, true);
+        let client = new TEClient({ host: opts.host, token });
+        // 追加模式：先检测冲突
+        if (!opts.replace) {
+            console.log('[plan-upload] checking existing plan for conflicts...');
+            try {
+                const existingDraft = await fetchPlan({ projectId: opts.project, host: opts.host, token });
+                // 有既有方案，进行冲突检测
+                const newDraft = JSON.parse(await readFile(opts.draft, 'utf8'));
+                const conflictResult = detectConflicts(newDraft, existingDraft);
+                if (conflictResult.hasErrors) {
+                    // 严重冲突：打印报告并退出
+                    const existingSummary = {
+                        events: existingDraft.events.length,
+                        eventProps: existingDraft.event_properties.length,
+                        commonProps: existingDraft.common_event_properties.length,
+                        userProps: existingDraft.user_properties.length,
+                    };
+                    console.log('\n' + formatConflictReport(conflictResult, existingSummary));
+                    console.log('\n❌ Cannot proceed with append mode. Use --replace to overwrite, or fix property types in draft.json.');
+                    return;
+                }
+                if (conflictResult.hasWarnings) {
+                    // 仅提醒：打印并继续
+                    const existingSummary = {
+                        events: existingDraft.events.length,
+                        eventProps: existingDraft.event_properties.length,
+                        commonProps: existingDraft.common_event_properties.length,
+                        userProps: existingDraft.user_properties.length,
+                    };
+                    console.log('\n' + formatConflictReport(conflictResult, existingSummary));
+                    console.log('\n继续追加（同名事件不会覆盖）...\n');
+                }
+            }
+            catch (e) {
+                // 区分 token 过期和项目无方案
+                const errorMsg = e instanceof Error ? e.message : String(e);
+                if (errorMsg.includes('return_code -1001') || errorMsg.includes('token expired')) {
+                    // Token 过期：自动刷新后重试一次
+                    console.log('[auth] token expired, auto-refreshing...');
+                    token = await refreshToken(opts.host);
+                    client = new TEClient({ host: opts.host, token });
+                    // 不需要再检测冲突，直接进入上传流程（后续上传失败会再次检测）
+                }
+                else {
+                    // 其他错误（如 404、无数据）：项目无既有方案，直接上传
+                    console.log('[plan-upload] no existing plan found, proceeding with upload');
+                }
+            }
+        }
+        if (opts.replace) {
+            const del = await client.deleteProgram(opts.project);
+            console.log(`[plan-upload] deleted existing plan: ${del.return_message}; waiting 5s for consistency...`);
+            await new Promise((resolve) => setTimeout(resolve, 5000));
+        }
+        // 上传并检查错误
+        let retryCount = 0;
+        let draft = JSON.parse(await readFile(opts.draft, 'utf8'));
+        let tokenRefreshed = false; // 防止无限刷新
+        while (retryCount < MAX_FIX_RETRIES) {
+            const file = await readFile(opts.xlsx);
+            const res = await client.uploadProgramExcel({
+                projectId: opts.project,
+                file,
+                filename: path.basename(opts.xlsx),
+            });
+            console.log(JSON.stringify(res, null, 2));
+            // Token 过期：自动刷新后重试
+            if (res.return_code === -1001 && !tokenRefreshed) {
+                console.log('[auth] token expired during upload, auto-refreshing...');
+                token = await refreshToken(opts.host);
+                client = new TEClient({ host: opts.host, token });
+                tokenRefreshed = true;
+                continue; // 重试上传
+            }
+            // 检查是否有错误
+            const errors = extractErrors(res);
+            if (errors.length === 0 || res.return_code !== 0) {
+                // 无错误或上传失败（非校验错误）
+                break;
+            }
+            if (!opts.autoFix) {
+                console.log('\n❌ Upload has validation errors. Run with --auto-fix to auto-repair.');
+                break;
+            }
+            // 自动修复
+            console.log(`\n🔧 Auto-fixing upload errors (attempt ${retryCount + 1}/${MAX_FIX_RETRIES})...`);
+            const fixed = fixDraft(draft, res);
+            if (fixed.length === 0) {
+                console.log('No auto-fix available for these errors');
+                break;
+            }
+            console.log(`Fixed: ${fixed.join(', ')}`);
+            // 更新 draft.json 并重新生成 xlsx
+            await writeFile(opts.draft, JSON.stringify(draft, null, 2), 'utf8');
+            injectAutotrackEvents(draft);
+            await writeDraftXlsx(draft, opts.xlsx);
+            console.log(`[plan-upload] regenerated: ${opts.xlsx}`);
+            retryCount++;
+        }
+        if (retryCount >= MAX_FIX_RETRIES) {
+            console.log('\n⚠️ Max fix retries reached. Manual intervention required.');
+        }
+    });
+    cmd.command('fetch')
+        .requiredOption('--project <id>', 'AE projectId', (v) => parseInt(v, 10))
+        .option('--host <url>', 'AE host', DEFAULT_HOST)
+        .option('--out <path>', 'write to file instead of stdout')
+        .action(async (opts) => {
+        const token = await getToken(opts.host);
+        const draft = await fetchPlan({ projectId: opts.project, host: opts.host, token });
+        const s = JSON.stringify(draft, null, 2) + '\n';
+        if (opts.out)
+            await writeFile(opts.out, s, 'utf8');
+        else
+            process.stdout.write(s);
+    });
+    cmd.command('delete')
+        .requiredOption('--project <id>', 'AE projectId', (v) => parseInt(v, 10))
+        .option('--host <url>', 'AE host', DEFAULT_HOST)
+        .action(async (opts) => {
+        const token = await getToken(opts.host);
+        const client = new TEClient({ host: opts.host, token });
+        const res = await client.deleteProgram(opts.project);
+        console.log(JSON.stringify(res, null, 2));
+    });
+}

package/dist/src/cli/wiki.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerWiki(cmd: Command): void;

package/dist/src/cli/wiki.js

@@ -0,0 +1,20 @@
+import { searchIndex } from '../wiki-query/query.js';
+export function registerWiki(cmd) {
+    cmd.description('AE docs wiki (bundled)');
+    cmd.command('query')
+        .requiredOption('--keyword <kw>', 'substring to search in index')
+        .action((opts) => {
+        const hits = searchIndex(opts.keyword);
+        for (const h of hits)
+            console.log(`${h.name}\t${h.rawPath}\t${h.sourceUrl}`);
+    });
+    cmd.command('sync')
+        .description('refresh wiki from docs-v2 (developer use)')
+        .action(async () => {
+        // Re-invokes the three existing scripts sequentially. Shipped wiki
+        // is read-only for end users; this command mainly exists for maintainers.
+        console.error('wiki sync: run in a repo checkout with scripts/wiki-plan.ts available;');
+        console.error('this is not supported in the published package.');
+        process.exit(2);
+    });
+}

package/dist/src/client.d.ts

@@ -0,0 +1,62 @@
+export interface TEProperty {
+    name: string;
+    displayName?: string;
+    type: 'string' | 'number' | 'bool' | 'datetime' | 'array_row' | 'array_string';
+    desc?: string;
+    createTime?: string;
+    creator?: string;
+    lastUpdateAuth?: string;
+    lastUpdateTime?: string;
+    hasReported?: boolean;
+}
+export interface TEUserProperty extends TEProperty {
+    propTag?: string;
+    updateType: 'user_set' | 'user_setOnce' | 'user_add';
+    updateTypeName?: string;
+}
+export interface TEEvent {
+    eventName: string;
+    displayName?: string;
+    eventDesc?: string;
+    eventTag?: string;
+    createTime?: string;
+    creator?: string;
+    lastUpdateAuth?: string;
+    lastUpdateTime?: string;
+    hasReported?: boolean;
+    props: string[];
+    propInfosOnEvent?: Array<{
+        name: string;
+        hasReported?: boolean;
+    }>;
+}
+export interface TEProgram {
+    projectId: number;
+    createTime?: string;
+    events: TEEvent[];
+    eventProps: TEProperty[];
+    commonEventProps: TEProperty[];
+    userProps: TEUserProperty[];
+}
+export declare class TEClient {
+    private opts;
+    constructor(opts: {
+        host: string;
+        token: string;
+    });
+    private url;
+    private assertOk;
+    getProgram(projectId: number): Promise<TEProgram | null>;
+    deleteProgram(projectId: number): Promise<{
+        return_code: number;
+        return_message: string;
+    }>;
+    uploadProgramExcel(args: {
+        projectId: number;
+        file: Buffer;
+        filename: string;
+    }): Promise<{
+        return_code: number;
+        return_message: string;
+    }>;
+}