📝 docs: Consolidate specs directory, validate ACPX spec, and fix Gateway Async Init#2

Merged

hrygo merged 86 commits intomasterfrom

docs/specs-consolidation

Apr 4, 2026

Commits on Mar 31, 2026

feat: complete P0 milestone — EventStore, Metrics, Tests, Worker limits, Admin health
黄飞虹
committed
docs: update TRACEABILITY-MATRIX after P0 completion — 101→125 PASS, 64%→80%
黄飞虹
committed
feat: add OTel distributed tracing + config hot reload
黄飞虹
committed
feat: add security package implementations + SPEC documentation
黄飞虹
committed
feat: add session.event_store_enabled config field (replaces HOTPLEX_EVENT_STORE env var)
黄飞虹
committed
👷 ci: upgrade GitHub Actions CI with lint, concurrency and Codecov
黄飞虹
committed
feat: enrich init protocol with auth token, config fields and error codes
黄飞虹
committed
refactor: reorganize .agent/rules into modular topic-specific files
黄飞虹
committed
chore: remove stale architecture review and scan reports
黄飞虹
committed
docs: update Message-Persistence with v1.0 deprecation decision
黄飞虹
committed
docs: update AGENT.md with new modular rules structure
黄飞虹
committed
feat: wire JWT secret via config, add codecov config and init validation tests
黄飞虹
committed
fix: change PoolManager.Acquire return type to error
黄飞虹
committed
fix: use errors.As for safe type assertion in AttachWorker
黄飞虹
committed
🔧 ci: update codecov targets to match module boundaries
黄飞虹
committed
docs: update TRACEABILITY-MATRIX to reflect actual implementation state
黄飞虹
committed
feat: phase 1-3 robustness and admin API — 141/157 ACs (90%)

黄飞虹
and
claude
committed
fix: eliminate seq mutation, deadlock risk, goroutine hang in robustness PR

黄飞虹
and
claude
committed
fix: unexport managedSession.worker and managedSession.mu, remove dead GetManagedSessionDebug

黄飞虹
and
claude
committed
feat: RES-008 per-user memory tracking and RES-009 crash rate metrics

黄飞虹
and
claude
committed
feat: TEST-006 gateway coverage — hub_test.go 190 lines

黄飞虹
and
claude
committed
feat: add essential open-source files and refine gateway/session logic
黄飞虹
committed
style: rename docs/SPECS to docs/specs and update references
黄飞虹
committed
feat: AEP-012 Message Event Kind + AEP-011 missing event kinds

黄飞虹
and
claude
committed
feat: TEST-007 CI/CD 4-layer test pipeline

黄飞虹
and
claude
committed
feat: SEC-007 multi-bot isolation + SEC-045 allowed-tools passthrough

黄飞虹
and
claude
committed
fix: config test race + add watcher/events tests

黄飞虹
and
claude
committed
feat(proc): enforce 10MB worker output limit
黄飞虹
committed
feat(session): implement graceful worker termination
黄飞虹
committed
refactor(session): improve schema migration formatting
黄飞虹
committed
fix(session): add Terminate mock expectations + store tests

黄飞虹
and
claude
committed
✅ test: add JWT validator and gateway connection test suites

黄飞虹
and
claude
committed
✅ test: boost gateway coverage 14.7%→36.0% with Hub/Conn tests
黄飞虹
committed
📝 docs: extract Claude Code Worker specs to separate document

黄飞虹
and
claude
committed
🐛 fix(ci): raise coverage threshold from 50% to 80% (TEST-007)
黄飞虹
committed
🟣 feat(gateway): implement AEP-011/AEP-012 event pass-through
黄飞虹
committed
🟣 feat(security): extract botID from JWT at HTTP upgrade time (SEC-007)
黄飞虹
committed
🐛 fix(security): generate ES256 tokens even with []byte HMAC test secrets
黄飞虹
committed
🔧 chore: wire JWTValidator into NewAuthenticator and fix noop Resume
黄飞虹
committed
✅ test: add gateway handler, proc manager, worker registry and noop tests
黄飞虹
committed
✅ test(gateway): add botID isolation, bridge forwarding and HandleHTTP tests
黄飞虹
committed
✨ feat(gateway): AEP-011/012 passthrough + SEC-007 bot_id isolation + Clone race fix

黄飞虹
and
claude
committed

Commits on Apr 1, 2026

refactor: extract BaseWorker, split conn.go/store.go, move AdminAPI to internal/admin
黄飞虹
committed
refactor: simplify gateway/admin, fix claudecode deadlock and data race

黄飞虹
and
claude
committed
feat(claudecode): complete CLI params, env whitelist, protocol layers, and NDJSON safety

黄飞虹
and
claude
committed

Commits on Apr 2, 2026

✅ test(claudecode): mock-based unit tests, coverage 55%→70%

黄飞虹
and
claude
committed
refactor(claudecode): unify WorkerEvent routing, DRY control protocol, and OTEL_ env prefix

黄飞虹
and
claude
committed
test: AC验收矩阵v1.1更新 + lint errcheck修复

黄飞虹
and
claude
committed
chore: rename cmd/gateway → cmd/worker, binary → hotplex-worker

黄飞虹
and
claude
committed
chore(Makefile): add PGO, cross-compile, ldflags, lint-fix, fmt, tidy

黄飞虹
and
claude
committed
chore(Makefile): auto-detect platform, simplify build targets

黄飞虹
and
claude
committed
chore(Makefile): make defaults to help

黄飞虹
and
claude
committed
feat(deploy): add installation scripts and Docker deployment files

黄飞虹
and
claude
committed
feat(scripts): production installation with security hardening

黄飞虹
and
claude
committed
feat(config): change default ports to 8888/9999

黄飞虹
and
claude
committed
feat(config): add complete default configuration files

黄飞虹
and
claude
committed
refactor(makefile): organize by functional groups with process lifecycle

黄飞虹
and
claude
committed
chore(.gitignore): add gateway.db* pattern

黄飞虹
and
claude
committed
fix(docker): correct docker configs and add monitoring provisioning
黄飞虹
committed
reorganize(configs): group monitoring configs under monitoring/
黄飞虹
committed
rename(db): gateway.db → hotplex-worker.db
黄飞虹
committed
docs(spec): add Python client design document

黄飞虹
and
claude
committed
feat(examples): add Python client example module

黄飞虹
and
claude
committed
refactor(python-client): fix code review issues

黄飞虹
and
claude
committed
refactor(go-client): migrate AEP codec and JWT core to pkg/ for public API

黄飞虹
and
claude
committed
fix: remove redundant code and use stdlib uuid

黄飞虹
and
claude
committed
refactor(dead-code): remove pkg/jwt, slim internal/aep, move codec tests to pkg/

黄飞虹
and
claude
committed
refactor: eliminate internal/aep facade, import pkg/aep directly

黄飞虹
and
claude
committed
✨ feat(examples): improve TypeScript client examples and healthcheck

黄飞虹
and
claude
committed
docs(spec): add Go client example module design

黄飞虹
and
claude
committed

Commits on Apr 3, 2026

Commits on Apr 4, 2026

🔧 fix(gateway): fix AEP init handshake and resolve SESSION_BUSY race
黄飞虹
committed
🔧 fix(gateway): clean up stale comment and add api_key constant
黄飞虹
committed
🔧 fix(gateway): eliminate double session creation in performInit
黄飞虹
committed
🔧 refactor(gateway): extract SessionStarter interface on Conn
黄飞虹
committed
feat: init ai-sdk-transport and nextjs-chat; reorganize DB to data/ dir
黄飞虹
committed
fix(gateway): fetch session info after StartSession in performInit
黄飞虹
committed
chore: cleanup project structure and ignore .loki and main binary
黄飞虹
committed
feat(config): support numbered env vars and overhaul documentation
黄飞虹
committed
docs(spec): fix critical errors in Gateway Async Init spec
黄飞虹
committed
📝 docs: consolidate specs directory and standardize metadata
黄飞虹
committed
📝 docs(specs): validate ACPX spec via acpx CLI and update metadata
黄飞虹
committed
✨ feat(worker): add OpenCode Worker specs and Claude Code user message support
黄飞虹
committed
🎨 style: fix code formatting (gofmt) and use embedded fields
黄飞虹
committed