glasspane-harness 0.12.0 → 0.12.1
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/README.md +50 -3
- package/README.zh-CN.md +45 -2
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -22,6 +22,24 @@
|
|
|
22
22
|
|
|
23
23
|
---
|
|
24
24
|
|
|
25
|
+
## Table of Contents
|
|
26
|
+
|
|
27
|
+
- [About This Project](#about-this-project)
|
|
28
|
+
- [The other half of the pair: GlassPane](#the-other-half-of-the-pair-glasspane)
|
|
29
|
+
- [This is a complete coding agent, not a stripped one](#this-is-a-complete-coding-agent-not-a-stripped-one)
|
|
30
|
+
- [Product surfaces](#product-surfaces)
|
|
31
|
+
- [Install](#install)
|
|
32
|
+
- [Quick start](#quick-start)
|
|
33
|
+
- [The `gp_*` tool surface](#the-gp-tool-surface)
|
|
34
|
+
- [The evidence discipline](#the-evidence-discipline)
|
|
35
|
+
- [Documentation](#documentation)
|
|
36
|
+
- [Development](#development)
|
|
37
|
+
- [License & attribution](#license-attribution)
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## About This Project
|
|
42
|
+
|
|
25
43
|
**The problem.** An AI agent driving a real macOS app cannot honestly say whether the UI
|
|
26
44
|
did what it asked. It sees its own tool output, guesses from prose, and reports success.
|
|
27
45
|
Screenshots don't help: they show *a* moment, not a *change*, and they cannot say whether
|
|
@@ -36,8 +54,37 @@ invents a verdict. Verified calls are appended to a hash-chained decision log, a
|
|
|
36
54
|
compaction hook re-injects the session's evidence anchors so summarising can never quietly
|
|
37
55
|
drop the audit chain.
|
|
38
56
|
|
|
39
|
-
The
|
|
40
|
-
|
|
57
|
+
### The other half of the pair: GlassPane
|
|
58
|
+
|
|
59
|
+
This repository is one half of a two-part product. The other half is
|
|
60
|
+
[**GlassPane**](https://github.com/jingzhao-l/GlassPane), the macOS runtime-verification
|
|
61
|
+
engine: a Swift daemon that measures an application's accessibility tree, pixel changes,
|
|
62
|
+
crashes and responsiveness, and exposes those measurements over MCP through `glasspane-mcp`.
|
|
63
|
+
|
|
64
|
+
The split is deliberate and asymmetric:
|
|
65
|
+
|
|
66
|
+
- **GlassPane decides what the application did.** It holds the Accessibility, Input
|
|
67
|
+
Monitoring and Screen Recording grants, performs the measurement, and reports its own
|
|
68
|
+
attribution. This harness is a client of that verdict, not a second opinion.
|
|
69
|
+
- **The harness transcribes.** It carries the same `gp_*` surface natively, appends verified
|
|
70
|
+
calls to a hash-chained decision log, and re-injects evidence anchors when a long session
|
|
71
|
+
is compacted. It never invents a verdict.
|
|
72
|
+
- **Neither reads the other's private API.** Both consume the same published contract layer
|
|
73
|
+
(`iterate-kernel`), so the formats that cross the boundary are one definition rather than
|
|
74
|
+
two files evolving apart.
|
|
75
|
+
|
|
76
|
+
Install the engine first — the harness is a client, not a substitute:
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
# Engine (macOS 14+). When the permission panel opens, grant Accessibility,
|
|
80
|
+
# Input Monitoring and Screen Recording to `GlassPane Daemon`.
|
|
81
|
+
curl -fsSL https://raw.githubusercontent.com/jingzhao-l/GlassPane/main/install.sh -o /tmp/gp-install.sh && sh /tmp/gp-install.sh
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
Its README is the place for install channels, permissions, the evidence-pack format and the
|
|
85
|
+
update line: [jingzhao-l/GlassPane](https://github.com/jingzhao-l/GlassPane). The engine also
|
|
86
|
+
serves MCP hosts that are not this harness (Claude Desktop, Cursor, any MCP client), which is
|
|
87
|
+
what `glasspane-mcp` is for.
|
|
41
88
|
|
|
42
89
|
## This is a complete coding agent, not a stripped one
|
|
43
90
|
|
|
@@ -109,7 +156,7 @@ npm install -g glasspane-harness
|
|
|
109
156
|
bun add -g glasspane-harness
|
|
110
157
|
|
|
111
158
|
# or one-click (npm first, GitHub release asset as fallback)
|
|
112
|
-
curl -fsSL https://raw.githubusercontent.com/jingzhao-l/glasspane-harness/v0.12.
|
|
159
|
+
curl -fsSL https://raw.githubusercontent.com/jingzhao-l/glasspane-harness/v0.12.1/scripts/install.sh | bash
|
|
113
160
|
```
|
|
114
161
|
|
|
115
162
|
Two commands are installed: **`glasspane-harness`** and the short alias **`gp-harness`**.
|
package/README.zh-CN.md
CHANGED
|
@@ -22,6 +22,24 @@
|
|
|
22
22
|
|
|
23
23
|
---
|
|
24
24
|
|
|
25
|
+
## 目录
|
|
26
|
+
|
|
27
|
+
- [这项目是什么](#这项目是什么)
|
|
28
|
+
- [一对产品的另一半:GlassPane](#一对产品的另一半glasspane)
|
|
29
|
+
- [这是一个完整的编程 harness,不是被削过头的 fork](#这是一个完整的编程-harness不是被削过头的-fork)
|
|
30
|
+
- [产品面](#产品面)
|
|
31
|
+
- [安装](#安装)
|
|
32
|
+
- [上手](#上手)
|
|
33
|
+
- [`gp_*` 工具面](#gp-工具面)
|
|
34
|
+
- [证据纪律](#证据纪律)
|
|
35
|
+
- [文档](#文档)
|
|
36
|
+
- [开发](#开发)
|
|
37
|
+
- [许可与署名](#许可与署名)
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## 这项目是什么
|
|
42
|
+
|
|
25
43
|
**问题。** 一个驱动真实 macOS 应用的 AI agent,没法诚实地说清界面到底有没有按它要求的动。
|
|
26
44
|
它只看得见自己的工具输出,于是靠散文猜测、报成功。截图也不解决问题:截图给的是**某个瞬间**,
|
|
27
45
|
不是**某次变化**,更说不清这次变化是不是那次点击造成的。
|
|
@@ -32,7 +50,32 @@
|
|
|
32
50
|
熔断级、pass / fail / inconclusive)。harness 只转录,不自己下结论。成包的验证调用进哈希链
|
|
33
51
|
决策日志;压缩钩子会把会话的证据锚点重新注入压缩提示词,摘要再长也丢不掉审计链。
|
|
34
52
|
|
|
35
|
-
|
|
53
|
+
### 一对产品的另一半:GlassPane
|
|
54
|
+
|
|
55
|
+
本仓库是一对产品里的一半。另一半是 [**GlassPane**](https://github.com/jingzhao-l/GlassPane),
|
|
56
|
+
macOS 上的运行时验证引擎:一个 Swift 后台服务,测量应用的无障碍树、像素变化、崩溃与响应性,
|
|
57
|
+
并通过 `glasspane-mcp` 经 MCP 把这套测量交出去。
|
|
58
|
+
|
|
59
|
+
这个分工是刻意且不对称的:
|
|
60
|
+
|
|
61
|
+
- **应用做了什么由 GlassPane 判定。** 它持有辅助功能、输入监控与屏幕录制授权,做测量,
|
|
62
|
+
给出自己的归因。这个 harness 是那份判定的客户端,不是第二种意见。
|
|
63
|
+
- **harness 只负责转写。** 它原生带着同一套 `gp_*` 面,把已验证的调用追加进哈希链决策账本,
|
|
64
|
+
并在长会话被压缩时重新注入证据锚点。它绝不自行发明判定。
|
|
65
|
+
- **两边都不读对方的私有 API。** 它们吃的是同一份公开发布的契约层(`iterate-kernel`),
|
|
66
|
+
所以跨越边界的格式只有一份定义,而不是两份各自演化的文件。
|
|
67
|
+
|
|
68
|
+
先把引擎装上——harness 是客户端,不是替代品:
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
# 引擎(macOS 14+)。权限面板弹出时,为 `GlassPane Daemon` 勾选辅助功能、
|
|
72
|
+
# 输入监控与屏幕录制。
|
|
73
|
+
curl -fsSL https://raw.githubusercontent.com/jingzhao-l/GlassPane/main/install.sh -o /tmp/gp-install.sh && sh /tmp/gp-install.sh
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
安装渠道、权限、证据包格式与更新线都在它的 README:[jingzhao-l/GlassPane](https://github.com/jingzhao-l/GlassPane)。
|
|
77
|
+
引擎也服务不是这个 harness 的 MCP host(Claude Desktop、Cursor、任意 MCP 客户端),
|
|
78
|
+
`glasspane-mcp` 就是为此存在的。
|
|
36
79
|
|
|
37
80
|
## 这是一个完整的编程 harness,不是被削过头的 fork
|
|
38
81
|
|
|
@@ -91,7 +134,7 @@ Azure、OpenRouter 等等全在——几百个模型——每一个都用**你
|
|
|
91
134
|
```bash
|
|
92
135
|
npm install -g glasspane-harness # 推荐
|
|
93
136
|
bun add -g glasspane-harness
|
|
94
|
-
curl -fsSL https://raw.githubusercontent.com/jingzhao-l/glasspane-harness/v0.12.
|
|
137
|
+
curl -fsSL https://raw.githubusercontent.com/jingzhao-l/glasspane-harness/v0.12.1/scripts/install.sh | bash
|
|
95
138
|
```
|
|
96
139
|
|
|
97
140
|
会装出两个命令:**`glasspane-harness`** 与短别名 **`gp-harness`**。
|
package/package.json
CHANGED
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
"scripts": {
|
|
26
26
|
"postinstall": "node ./postinstall.mjs"
|
|
27
27
|
},
|
|
28
|
-
"version": "0.12.
|
|
28
|
+
"version": "0.12.1",
|
|
29
29
|
"license": "MIT",
|
|
30
30
|
"os": [
|
|
31
31
|
"darwin"
|
|
@@ -44,7 +44,7 @@
|
|
|
44
44
|
},
|
|
45
45
|
"sideEffects": false,
|
|
46
46
|
"optionalDependencies": {
|
|
47
|
-
"glasspane-harness-darwin-arm64": "0.12.
|
|
48
|
-
"glasspane-harness-darwin-x64": "0.12.
|
|
47
|
+
"glasspane-harness-darwin-arm64": "0.12.1",
|
|
48
|
+
"glasspane-harness-darwin-x64": "0.12.1"
|
|
49
49
|
}
|
|
50
50
|
}
|