All notable changes to loop-codex will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- IMPLEMENTATION_PLAN.md: CDPGuard 路径从旧
cdp-bridge/cdp-guard.ts更新为实际security/cdpg-guard.ts(6处引用全部修正) - IMPLEMENTATION_PLAN.md: 文件结构树新增
src/security/目录,移除 cdp-bridge 下的旧 cdp-guard.ts 条目
.github/ISSUE_TEMPLATE/bug_report.md— Bug 报告模板.github/PULL_REQUEST_TEMPLATE.md— PR 提交模板
- DESIGN.md: CDPGuard 路径从
cdp-bridge/cdp-guard.ts更新为security/cdpg-guard.ts - 安全模块从 cdp-bridge 子模块拆分为独立
src/security/目录
- 架构图/数据流图中文档模块位置与代码实际位置对齐
- TypeScript 编译配置、依赖版本锁定
- Dual-channel architecture: JSON-RPC for file ops + CDP for GUI interaction
- CDP bridge layer:
cdp-connection.ts(WebSocket + auto-reconnect),cdp-executor.ts(high-level DOM API),page-manager.ts(target lifecycle),port-discovery.ts(auto-detect ports 9222-9232) - JSON-RPC bridge layer:
jsonrpc-protocol.ts(2.0 request/response/notification),unix-socket-client.ts(macOS/Linux IPC),named-pipe-client.ts(Windows IPC) - Four-layer selector fallback:
backendNodeId-> Accessibility Tree -> CSS Selector -> XPath - Cross-platform IPC via unified
IPCTransportinterface - DOM version drift detection with SHA-256 fingerprint comparison
- CDP safety guard:
allowed_dom_scope+ L0/L1/L2 dangerous-operation interception - 8 PROBE scripts:
cdp-connect,basic-evaluate,dom-access,input-injection,button-click,screenshot,network-intercept,full-session - Each probe has both
.shwrapper and.tssource implementation - 15 total TypeScript modules across CDP and JSON-RPC bridge layers
- Test suite: unit tests, integration tests, probe tests, mock CDP server
- CI pipeline: test (3 OS matrix), build, probes validation, lint
- Comprehensive bilingual README (English + Chinese) with architecture diagrams
- Apache 2.0 license