Skip to content

Commit ca7a516

Browse files
committed
docs: add v0.6.0 changeset and update architecture documentation
- Add changeset for minor version bump (0.5.2 → 0.6.0) - Update CONTRIBUTING.md project structure to reflect current architecture - Document services/ and utils/ directories - Remove references to deleted files
1 parent 4ce493e commit ca7a516

File tree

2 files changed

+44
-12
lines changed

2 files changed

+44
-12
lines changed
Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
---
2+
"@mcp-pointer/server": minor
3+
"@mcp-pointer/shared": minor
4+
---
5+
6+
**Architecture Cleanup & Improvements**
7+
8+
- **Server**: Store full CSS properties in `cssProperties` instead of filtering to 5 properties
9+
- **Server**: Remove LEGACY_ELEMENT_SELECTED support - only DOM_ELEMENT_POINTED is now supported
10+
- **Server**: Delete unused files (`mcp-handler.ts`, `websocket-server.ts`)
11+
- **Server**: Simplify types - remove StateDataV1 and LegacySharedState
12+
- **Server**: Dynamic CSS filtering now happens on-the-fly during MCP tool calls based on cssLevel parameter
13+
14+
This enables full CSS details to be accessible without re-pointing to elements, with filtering applied server-side based on tool parameters.

CONTRIBUTING.md

Lines changed: 30 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -62,9 +62,16 @@ packages/
6262
├── server/ # @mcp-pointer/server - MCP Server (TypeScript)
6363
│ ├── src/
6464
│ │ ├── start.ts # Main server entry point
65-
│ │ ├── cli.ts # Command line interface
66-
│ │ ├── websocket-server.ts
67-
│ │ └── mcp-handler.ts
65+
│ │ ├── cli.ts # Command line interface
66+
│ │ ├── message-handler.ts # Message routing & state building
67+
│ │ ├── services/
68+
│ │ │ ├── websocket-service.ts # WebSocket with leader election
69+
│ │ │ ├── mcp-service.ts # MCP protocol handler
70+
│ │ │ ├── element-processor.ts # Raw→Processed conversion
71+
│ │ │ └── shared-state-service.ts # State persistence
72+
│ │ └── utils/
73+
│ │ ├── dom-extractor.ts # HTML parsing utilities
74+
│ │ └── element-detail.ts # Dynamic CSS/text filtering
6875
│ ├── dist/
6976
│ │ └── cli.cjs # Bundled standalone CLI
7077
│ └── package.json
@@ -73,15 +80,17 @@ packages/
7380
│ ├── src/
7481
│ │ ├── background.ts # Service worker
7582
│ │ ├── content.ts # Element selection
76-
│ │ └── element-sender-service.ts
83+
│ │ └── services/
84+
│ │ └── element-sender-service.ts # WebSocket client
7785
│ ├── dev/ # Development build (with logging)
7886
│ ├── dist/ # Production build (minified)
7987
│ └── manifest.json
8088
8189
└── shared/ # @mcp-pointer/shared - Shared TypeScript types
8290
├── src/
83-
│ ├── Logger.ts
84-
│ └── types.ts
91+
│ ├── logger.ts
92+
│ ├── types.ts
93+
│ └── detail.ts # CSS/text detail level constants
8594
└── package.json
8695
```
8796

@@ -119,9 +128,16 @@ packages/
119128
├── server/ # @mcp-pointer/server - MCP Server (TypeScript)
120129
│ ├── src/
121130
│ │ ├── start.ts # Main server entry point
122-
│ │ ├── cli.ts # Command line interface
123-
│ │ ├── websocket-server.ts
124-
│ │ └── mcp-handler.ts
131+
│ │ ├── cli.ts # Command line interface
132+
│ │ ├── message-handler.ts # Message routing & state building
133+
│ │ ├── services/
134+
│ │ │ ├── websocket-service.ts # WebSocket with leader election
135+
│ │ │ ├── mcp-service.ts # MCP protocol handler
136+
│ │ │ ├── element-processor.ts # Raw→Processed conversion
137+
│ │ │ └── shared-state-service.ts # State persistence
138+
│ │ └── utils/
139+
│ │ ├── dom-extractor.ts # HTML parsing utilities
140+
│ │ └── element-detail.ts # Dynamic CSS/text filtering
125141
│ ├── dist/
126142
│ │ └── cli.cjs # Bundled standalone CLI
127143
│ └── package.json
@@ -130,15 +146,17 @@ packages/
130146
│ ├── src/
131147
│ │ ├── background.ts # Service worker
132148
│ │ ├── content.ts # Element selection
133-
│ │ └── element-sender-service.ts
149+
│ │ └── services/
150+
│ │ └── element-sender-service.ts # WebSocket client
134151
│ ├── dev/ # Development build (with logging)
135152
│ ├── dist/ # Production build (minified)
136153
│ └── manifest.json
137154
138155
└── shared/ # @mcp-pointer/shared - Shared TypeScript types
139156
├── src/
140-
│ ├── Logger.ts
141-
│ └── types.ts
157+
│ ├── logger.ts
158+
│ ├── types.ts
159+
│ └── detail.ts # CSS/text detail level constants
142160
└── package.json
143161
```
144162

0 commit comments

Comments
 (0)