feat: add forge-hub sync — lightweight runtime sync

[AmberCXX]

Summary

• Added forge-hub sync command: only syncs hub-server source files (including channels/) from source to runtime, then restarts Hub
• Skips: dependency install, dashboard build, plist write, MCP registration
• Updated 维护地图.md: maintenance principle changed to recommend forge-hub sync instead of full forge-hub install after git pull

Motivation

After git pull, ~/.forge-hub/ runtime files don't auto-update. The previous workaround was forge-hub install, which redoes everything (bun install × 3, dashboard build, plist, MCP reg, etc.) — slow and unnecessary.

This caused a real outage: hub.isAllowed is not a function in feishu channel, because source channel-loader.ts added isAllowed() to HubAPI but runtime wasn't synced.

Changes

File	Change
cli.ts	Added syncCmd() + wired into dispatch + help text
维护地图.md	Updated maintenance principle: forge-hub sync after source update

Self-test

$ bun cli.ts doctor
✅ All checks passed

$ bun cli.ts sync
🔄 Forge Hub sync
✓ hub-server runtime synced（channels/ 已更新）
✅ Sync 完成

🤖 Generated with Claude Code

[LinekForge]

Thanks for this — the motivation is solid and the implementation is clean. forge-hub sync solves a real pain point (the hub.isAllowed is not a function outage you hit is a perfect example).

One change needed before we can merge:

Missing cleanDirContents(CHANNELS_RUNTIME) before copy

installCmd (L79) clears the channels runtime directory before copying:

cleanDirContents(CHANNELS_RUNTIME);
cpDir(path.join(serverSrc, "channels"), CHANNELS_RUNTIME, [".ts"]);

syncCmd skips the clean step and goes straight to cpDir. This means if a channel file was deleted or renamed in source (e.g. we remove a deprecated channel plugin), the old .ts file remains in ~/.forge-hub/channels/ and channel-loader.ts will continue to load it.

In normal operation this might just cause a harmless "plugin has no send" warning, but in edge cases (renamed exports, conflicting registrations) it could break channel loading entirely.

Fix: Add cleanDirContents(CHANNELS_RUNTIME); before the channels cpDir call:

cleanDirContents(CHANNELS_RUNTIME);
cpDir(path.join(serverSrc, "channels"), CHANNELS_RUNTIME, [".ts"]);

cleanDirContents is already imported and used in installCmd, so no new dependencies needed.

Everything else looks good — stagePackageRuntime reuse, chmod 700, launchctl kickstart with bootout fallback, and the 维护地图.md update are all solid.

— Forge (maintainer)