@goonnguyen/human-mcp 1.2.0 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/project-manager.md +2 -2
- package/.env.example +28 -1
- package/.github/workflows/publish.yml +43 -6
- package/.opencode/agent/code-reviewer.md +142 -0
- package/.opencode/agent/debugger.md +74 -0
- package/.opencode/agent/docs-manager.md +119 -0
- package/.opencode/agent/git-manager.md +60 -0
- package/.opencode/agent/planner-researcher.md +100 -0
- package/.opencode/agent/project-manager.md +113 -0
- package/.opencode/agent/system-architecture.md +200 -0
- package/.opencode/agent/tester.md +96 -0
- package/.opencode/agent/ui-ux-developer.md +97 -0
- package/.opencode/command/cook.md +7 -0
- package/.opencode/command/debug.md +10 -0
- package/.opencode/command/fix/ci.md +8 -0
- package/.opencode/command/fix/fast.md +5 -0
- package/.opencode/command/fix/hard.md +7 -0
- package/.opencode/command/fix/test.md +16 -0
- package/.opencode/command/git/cm.md +5 -0
- package/.opencode/command/git/cp.md +4 -0
- package/.opencode/command/plan/ci.md +12 -0
- package/.opencode/command/plan/two.md +13 -0
- package/.opencode/command/plan.md +10 -0
- package/.opencode/command/test.md +7 -0
- package/.opencode/command/watzup.md +8 -0
- package/CHANGELOG.md +21 -0
- package/CLAUDE.md +5 -3
- package/QUICKSTART.md +3 -3
- package/README.md +551 -20
- package/bun.lock +275 -3
- package/dist/index.js +71091 -17256
- package/docs/README.md +51 -0
- package/docs/codebase-structure-architecture-code-standards.md +17 -5
- package/docs/project-overview-pdr.md +37 -21
- package/docs/project-roadmap.md +494 -0
- package/human-mcp.png +0 -0
- package/package.json +9 -1
- package/plans/002-sse-fallback-http-transport-plan.md +161 -0
- package/plans/003-fix-test-infrastructure-and-ci-plan.md +699 -0
- package/plans/003-http-transport-local-file-access-plan.md +880 -0
- package/plans/004-fix-typescript-compilation-errors-plan.md +388 -0
- package/plans/005-comprehensive-test-infrastructure-fix-plan.md +854 -0
- package/src/index.ts +2 -0
- package/src/tools/eyes/index.ts +7 -7
- package/src/tools/eyes/processors/image.ts +90 -0
- package/src/transports/http/file-interceptor.ts +134 -0
- package/src/transports/http/routes.ts +165 -4
- package/src/transports/http/server.ts +64 -14
- package/src/transports/http/session.ts +11 -3
- package/src/transports/http/sse-routes.ts +210 -0
- package/src/transports/index.ts +11 -6
- package/src/transports/types.ts +13 -0
- package/src/utils/cloudflare-r2.ts +107 -0
- package/src/utils/config.ts +26 -0
- package/tests/integration/http-transport-files.test.ts +190 -0
- package/tests/integration/server.test.ts +4 -1
- package/tests/integration/sse-transport.test.ts +142 -0
- package/tests/setup.ts +45 -1
- package/tests/types/api-responses.ts +35 -0
- package/tests/types/test-types.ts +105 -0
- package/tests/unit/cloudflare-r2.test.ts +118 -0
- package/tests/unit/eyes-analyze.test.ts +150 -0
- package/tests/unit/formatters.test.ts +1 -1
- package/tests/unit/sse-routes.test.ts +92 -0
- package/tests/utils/error-scenarios.ts +198 -0
- package/tests/utils/index.ts +3 -0
- package/tests/utils/mock-helpers.ts +99 -0
- package/tests/utils/test-data-generators.ts +217 -0
- package/tests/utils/test-server-manager.ts +172 -0
- package/tsconfig.json +1 -1
- package/plans/reports/001-from-qa-engineer-to-development-team-test-suite-report.md +0 -188
package/CLAUDE.md
CHANGED
|
@@ -38,7 +38,7 @@ src/
|
|
|
38
38
|
### Key Components
|
|
39
39
|
|
|
40
40
|
**Vision Analysis (tools/eyes/)**
|
|
41
|
-
- `index.ts` - Registers
|
|
41
|
+
- `index.ts` - Registers eyes_analyze and eyes_compare tools
|
|
42
42
|
- `processors/` - Handles image, video, and GIF processing
|
|
43
43
|
- `utils/gemini-client.ts` - Google Gemini API integration
|
|
44
44
|
- `schemas.ts` - Zod validation schemas for tool inputs
|
|
@@ -50,14 +50,16 @@ src/
|
|
|
50
50
|
|
|
51
51
|
## MCP Tools
|
|
52
52
|
|
|
53
|
-
|
|
53
|
+
**Important**: Tool names must comply with MCP validation pattern `^[a-zA-Z0-9_-]{1,64}$`. Only alphanumeric characters, underscores, and hyphens are allowed. No dots, spaces, or other special characters.
|
|
54
|
+
|
|
55
|
+
### eyes_analyze
|
|
54
56
|
Primary tool for visual analysis of images, videos, and GIFs:
|
|
55
57
|
- Supports file paths, URLs, and base64 data URIs
|
|
56
58
|
- Configurable detail levels (quick/detailed)
|
|
57
59
|
- Frame extraction for videos and GIFs
|
|
58
60
|
- Custom analysis prompts
|
|
59
61
|
|
|
60
|
-
###
|
|
62
|
+
### eyes_compare
|
|
61
63
|
Compares two images to identify visual differences:
|
|
62
64
|
- Three comparison types: pixel, structural, semantic
|
|
63
65
|
- Detailed difference reporting
|
package/QUICKSTART.md
CHANGED
|
@@ -61,7 +61,7 @@ Human MCP should analyze the image and provide detailed debugging insights!
|
|
|
61
61
|
|
|
62
62
|
### Debug UI Issues
|
|
63
63
|
```
|
|
64
|
-
Use the
|
|
64
|
+
Use the eyes_analyze tool with this screenshot:
|
|
65
65
|
- Type: image
|
|
66
66
|
- Analysis type: ui_debug
|
|
67
67
|
- Detail level: detailed
|
|
@@ -69,7 +69,7 @@ Use the eyes.analyze tool with this screenshot:
|
|
|
69
69
|
|
|
70
70
|
### Analyze Error Recordings
|
|
71
71
|
```
|
|
72
|
-
Use the
|
|
72
|
+
Use the eyes_analyze tool with this screen recording:
|
|
73
73
|
- Type: video
|
|
74
74
|
- Analysis type: error_detection
|
|
75
75
|
- Focus on: the error sequence
|
|
@@ -77,7 +77,7 @@ Use the eyes.analyze tool with this screen recording:
|
|
|
77
77
|
|
|
78
78
|
### Check Accessibility
|
|
79
79
|
```
|
|
80
|
-
Use the
|
|
80
|
+
Use the eyes_analyze tool:
|
|
81
81
|
- Analysis type: accessibility
|
|
82
82
|
- Check accessibility: true
|
|
83
83
|
```
|