- Updated all package.json name fields and dependency references - Updated all TypeScript/JavaScript imports - Updated .woodpecker/publish.yml filters and registry paths - Updated tools/install.sh scope default - Updated .npmrc registry paths (worktree + host) - Enhanced update-checker.ts with checkForAllUpdates() multi-package support - Updated CLI update command to show table of all packages - Added KNOWN_PACKAGES, formatAllPackagesTable, getInstallAllCommand - Marked checkForUpdate() with @deprecated JSDoc Closes #391
51 lines
1.9 KiB
Markdown
51 lines
1.9 KiB
Markdown
# Scratchpad — P5-003 Telegram Plugin
|
||
|
||
## Objective
|
||
|
||
Implement `@mosaicstack/telegram-plugin` by matching the established Discord plugin pattern with Telegraf + socket.io-client, add package docs, and pass package typecheck/lint.
|
||
|
||
## Requirements Source
|
||
|
||
- docs/PRD.md: Phase 5 remote control / Telegram plugin
|
||
- docs/TASKS.md: P5-003
|
||
- User task brief dated 2026-03-13
|
||
|
||
## Plan
|
||
|
||
1. Inspect Discord plugin behavior and package conventions
|
||
2. Add Telegram runtime dependencies if missing
|
||
3. Implement Telegram plugin with matching gateway event flow
|
||
4. Add README usage documentation
|
||
5. Run package typecheck and lint
|
||
6. Run code review and remediate findings
|
||
7. Commit, push, open PR, notify, remove worktree
|
||
|
||
## TDD Rationale
|
||
|
||
ASSUMPTION: No existing telegram package test harness or fixture coverage makes package-level TDD
|
||
disproportionate for this plugin scaffold task. Validation will rely on typecheck, lint, and
|
||
manual structural parity with the Discord plugin.
|
||
|
||
## Risks
|
||
|
||
- Telegram API typings may differ from Discord’s event shapes and require narrower guards.
|
||
- Socket event payloads may already include `role` in shared gateway expectations.
|
||
|
||
## Progress Log
|
||
|
||
- 2026-03-13: Loaded Mosaic/global/repo guidance, mission files, Discord reference implementation, and Telegram package scaffold.
|
||
- 2026-03-13: Added `telegraf` and `socket.io-client` to `@mosaicstack/telegram-plugin`.
|
||
- 2026-03-13: Implemented Telegram message forwarding, gateway streaming accumulation, response chunking, and package README.
|
||
|
||
## Verification Evidence
|
||
|
||
- `pnpm --filter @mosaicstack/telegram-plugin typecheck` → pass
|
||
- `pnpm --filter @mosaicstack/telegram-plugin lint` → pass
|
||
- `pnpm typecheck` → pass
|
||
- `pnpm lint` → pass
|
||
|
||
## Review
|
||
|
||
- Automated uncommitted review wrapper was invoked for the current delta.
|
||
- Manual review completed against Discord parity, gateway event contracts, and package docs; no additional blockers found.
|