agent-rulebook 0.2.1 → 0.3.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 +69 -5
- package/dist/commands/dashboard.d.ts +7 -0
- package/dist/commands/dashboard.js +42 -0
- package/dist/commands/dashboard.js.map +1 -0
- package/dist/commands/diagnostics.d.ts +2 -0
- package/dist/commands/diagnostics.js +38 -0
- package/dist/commands/diagnostics.js.map +1 -0
- package/dist/commands/import.d.ts +2 -0
- package/dist/commands/import.js +34 -0
- package/dist/commands/import.js.map +1 -0
- package/dist/commands/pending.d.ts +2 -0
- package/dist/commands/pending.js +27 -0
- package/dist/commands/pending.js.map +1 -0
- package/dist/commands/resolution.js +25 -11
- package/dist/commands/resolution.js.map +1 -1
- package/dist/commands/stats-renderer.d.ts +3 -0
- package/dist/commands/stats-renderer.js +76 -0
- package/dist/commands/stats-renderer.js.map +1 -0
- package/dist/commands/stats.d.ts +4 -0
- package/dist/commands/stats.js +107 -0
- package/dist/commands/stats.js.map +1 -0
- package/dist/commands/status.d.ts +2 -0
- package/dist/commands/status.js +17 -0
- package/dist/commands/status.js.map +1 -0
- package/dist/commands/sync.js +1 -1
- package/dist/commands/sync.js.map +1 -1
- package/dist/commands/usage.d.ts +2 -0
- package/dist/commands/usage.js +25 -0
- package/dist/commands/usage.js.map +1 -0
- package/dist/core/codex-call-parser.d.ts +10 -0
- package/dist/core/codex-call-parser.js +97 -0
- package/dist/core/codex-call-parser.js.map +1 -0
- package/dist/core/codex-usage-import.d.ts +24 -0
- package/dist/core/codex-usage-import.js +259 -0
- package/dist/core/codex-usage-import.js.map +1 -0
- package/dist/core/diagnostic-cluster.d.ts +37 -0
- package/dist/core/diagnostic-cluster.js +20 -0
- package/dist/core/diagnostic-cluster.js.map +1 -0
- package/dist/core/environment-normalization.d.ts +21 -0
- package/dist/core/environment-normalization.js +42 -0
- package/dist/core/environment-normalization.js.map +1 -0
- package/dist/core/index.d.ts +1 -0
- package/dist/core/index.js +1 -0
- package/dist/core/index.js.map +1 -1
- package/dist/core/invocation-diagnostics.d.ts +40 -0
- package/dist/core/invocation-diagnostics.js +91 -0
- package/dist/core/invocation-diagnostics.js.map +1 -0
- package/dist/core/legacy-candidate.d.ts +159 -0
- package/dist/core/legacy-candidate.js +73 -0
- package/dist/core/legacy-candidate.js.map +1 -0
- package/dist/core/legacy-import-apply.d.ts +215 -0
- package/dist/core/legacy-import-apply.js +172 -0
- package/dist/core/legacy-import-apply.js.map +1 -0
- package/dist/core/legacy-import-manifest.d.ts +197 -0
- package/dist/core/legacy-import-manifest.js +63 -0
- package/dist/core/legacy-import-manifest.js.map +1 -0
- package/dist/core/legacy-scan.d.ts +71 -0
- package/dist/core/legacy-scan.js +99 -0
- package/dist/core/legacy-scan.js.map +1 -0
- package/dist/core/pending-replay.d.ts +4 -0
- package/dist/core/pending-replay.js +96 -0
- package/dist/core/pending-replay.js.map +1 -0
- package/dist/core/resolution-applicability.d.ts +1 -0
- package/dist/core/resolution-applicability.js +28 -11
- package/dist/core/resolution-applicability.js.map +1 -1
- package/dist/core/resolution-ranker.js +9 -2
- package/dist/core/resolution-ranker.js.map +1 -1
- package/dist/core/resolution-search-types.d.ts +9 -0
- package/dist/core/statistics-data.d.ts +98 -0
- package/dist/core/statistics-data.js +53 -0
- package/dist/core/statistics-data.js.map +1 -0
- package/dist/core/statistics-pages.d.ts +3 -0
- package/dist/core/statistics-pages.js +107 -0
- package/dist/core/statistics-pages.js.map +1 -0
- package/dist/core/statistics-query.d.ts +86 -0
- package/dist/core/statistics-query.js +51 -0
- package/dist/core/statistics-query.js.map +1 -0
- package/dist/core/statistics-types.d.ts +286 -0
- package/dist/core/statistics-types.js +2 -0
- package/dist/core/statistics-types.js.map +1 -0
- package/dist/core/statistics.d.ts +5 -0
- package/dist/core/statistics.js +101 -0
- package/dist/core/statistics.js.map +1 -0
- package/dist/core/sync-status.d.ts +53 -0
- package/dist/core/sync-status.js +85 -0
- package/dist/core/sync-status.js.map +1 -0
- package/dist/core/usage-context.d.ts +15 -0
- package/dist/core/usage-context.js +22 -0
- package/dist/core/usage-context.js.map +1 -0
- package/dist/core/usage-observer.d.ts +36 -0
- package/dist/core/usage-observer.js +112 -0
- package/dist/core/usage-observer.js.map +1 -0
- package/dist/core/usage-schema.d.ts +113 -0
- package/dist/core/usage-schema.js +33 -0
- package/dist/core/usage-schema.js.map +1 -0
- package/dist/dashboard/public/api.js +41 -0
- package/dist/dashboard/public/app.js +111 -0
- package/dist/dashboard/public/components/detail-panel.js +21 -0
- package/dist/dashboard/public/components/index.js +216 -0
- package/dist/dashboard/public/components/input-diff.js +15 -0
- package/dist/dashboard/public/diagnostic-detail.js +25 -0
- package/dist/dashboard/public/diagnostics.js +46 -0
- package/dist/dashboard/public/index.html +28 -0
- package/dist/dashboard/public/knowledge.js +57 -0
- package/dist/dashboard/public/overview.js +101 -0
- package/dist/dashboard/public/solution-detail.js +42 -0
- package/dist/dashboard/public/styles.css +205 -0
- package/dist/dashboard/server.d.ts +10 -0
- package/dist/dashboard/server.js +133 -0
- package/dist/dashboard/server.js.map +1 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.js +3 -0
- package/dist/index.js.map +1 -1
- package/dist/mcp/observed-transport.d.ts +20 -0
- package/dist/mcp/observed-transport.js +99 -0
- package/dist/mcp/observed-transport.js.map +1 -0
- package/dist/mcp/resolution-change.d.ts +1 -1
- package/dist/mcp/resolution-change.js +24 -9
- package/dist/mcp/resolution-change.js.map +1 -1
- package/dist/mcp/resolutions-commit-change-tool.d.ts +5 -0
- package/dist/mcp/resolutions-commit-change-tool.js +22 -4
- package/dist/mcp/resolutions-commit-change-tool.js.map +1 -1
- package/dist/mcp/resolutions-find-tool.d.ts +1 -2
- package/dist/mcp/resolutions-find-tool.js +43 -8
- package/dist/mcp/resolutions-find-tool.js.map +1 -1
- package/dist/mcp/resolutions-list-facets-tool.d.ts +1 -1
- package/dist/mcp/resolutions-list-facets-tool.js +16 -2
- package/dist/mcp/resolutions-list-facets-tool.js.map +1 -1
- package/dist/mcp/resolutions-report-attempt-tool.d.ts +1 -0
- package/dist/mcp/resolutions-report-attempt-tool.js +44 -55
- package/dist/mcp/resolutions-report-attempt-tool.js.map +1 -1
- package/dist/mcp/schemas.d.ts +299 -14
- package/dist/mcp/schemas.js +31 -10
- package/dist/mcp/schemas.js.map +1 -1
- package/dist/mcp/server.js +20 -5
- package/dist/mcp/server.js.map +1 -1
- package/dist/mcp/stats-get-tool.d.ts +99 -0
- package/dist/mcp/stats-get-tool.js +17 -0
- package/dist/mcp/stats-get-tool.js.map +1 -0
- package/dist/mcp/tool-call.d.ts +99 -0
- package/dist/mcp/tool-call.js +20 -0
- package/dist/mcp/tool-call.js.map +1 -0
- package/dist/mcp/tool-output.d.ts +9 -0
- package/dist/mcp/tool-output.js +22 -0
- package/dist/mcp/tool-output.js.map +1 -1
- package/dist/mcp/tools.d.ts +182 -27
- package/dist/mcp/tools.js +10 -3
- package/dist/mcp/tools.js.map +1 -1
- package/dist/program.js +14 -0
- package/dist/program.js.map +1 -1
- package/dist/storage/canonical-write-lock.d.ts +2 -0
- package/dist/storage/canonical-write-lock.js +32 -0
- package/dist/storage/canonical-write-lock.js.map +1 -0
- package/dist/storage/diagnostic-store.d.ts +21 -0
- package/dist/storage/diagnostic-store.js +50 -0
- package/dist/storage/diagnostic-store.js.map +1 -0
- package/dist/storage/import-manifest.d.ts +6 -0
- package/dist/storage/import-manifest.js +41 -0
- package/dist/storage/import-manifest.js.map +1 -0
- package/dist/storage/pending-store.d.ts +329 -0
- package/dist/storage/pending-store.js +164 -0
- package/dist/storage/pending-store.js.map +1 -0
- package/dist/storage/resolution-candidate-service.js +2 -1
- package/dist/storage/resolution-candidate-service.js.map +1 -1
- package/dist/storage/resolution-change-transaction.d.ts +41 -3
- package/dist/storage/resolution-change-transaction.js +101 -12
- package/dist/storage/resolution-change-transaction.js.map +1 -1
- package/dist/storage/resolution-home.js +1 -1
- package/dist/storage/resolution-home.js.map +1 -1
- package/dist/storage/resolution-index-check.js +3 -2
- package/dist/storage/resolution-index-check.js.map +1 -1
- package/dist/storage/resolution-indexer.js +3 -1
- package/dist/storage/resolution-indexer.js.map +1 -1
- package/dist/storage/usage-store.d.ts +80 -0
- package/dist/storage/usage-store.js +239 -0
- package/dist/storage/usage-store.js.map +1 -0
- package/package.json +11 -4
|
@@ -0,0 +1,205 @@
|
|
|
1
|
+
:root {
|
|
2
|
+
color-scheme: light dark;
|
|
3
|
+
--bg: #f4f6f8; --surface: #fff; --surface-soft: #f8faf9;
|
|
4
|
+
--text: #202b32; --muted: #596971; --primary: #187b54; --accent: #50d99c;
|
|
5
|
+
--border: #dfe6e3; --control-border: #7a8982; --tint: #e5f5ec;
|
|
6
|
+
--warning: #926018; --warning-bg: #fff4df; --danger: #b53d50;
|
|
7
|
+
--shadow: 0 4px 24px rgb(26 48 38 / .04);
|
|
8
|
+
font: 15px/1.5 -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
|
|
9
|
+
color: var(--text); background: var(--bg); font-variant-numeric: tabular-nums;
|
|
10
|
+
}
|
|
11
|
+
@media (prefers-color-scheme: dark) {
|
|
12
|
+
:root {
|
|
13
|
+
--bg: #13161f; --surface: #1d2230; --surface-soft: #222836;
|
|
14
|
+
--text: #edf1f5; --muted: #a4afbe; --primary: #63dbaa; --accent: #63dbaa;
|
|
15
|
+
--border: #333e4f; --control-border: #6d7e91; --tint: #223c35;
|
|
16
|
+
--warning: #ecc17b; --warning-bg: #343023; --danger: #f28b9d;
|
|
17
|
+
--shadow: 0 5px 26px rgb(0 0 0 / .1);
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
* { box-sizing: border-box; }
|
|
21
|
+
body { margin: 0; }
|
|
22
|
+
a { color: var(--primary); }
|
|
23
|
+
h1 { font-size: 30px; letter-spacing: -.8px; line-height: 1.2; margin: 0; font-weight: 700; }
|
|
24
|
+
h2 { font-size: 17px; letter-spacing: -.2px; margin: 0 0 20px; font-weight: 650; }
|
|
25
|
+
h3 { font-size: 13px; margin: 0; color: var(--muted); font-weight: 500; }
|
|
26
|
+
p { margin: 8px 0; }
|
|
27
|
+
button, input, select { font: inherit; color: inherit; border: 1px solid var(--control-border); border-radius: 10px; background: var(--surface); min-height: 40px; padding: 8px 12px; }
|
|
28
|
+
button { cursor: pointer; font-size: 13px; font-weight: 600; }
|
|
29
|
+
button:hover { background: var(--tint); }
|
|
30
|
+
button:disabled { opacity: .5; cursor: default; }
|
|
31
|
+
button.primary { color: #102c20; background: var(--accent); border-color: var(--accent); min-height: 42px; padding-inline: 18px; }
|
|
32
|
+
button.primary:hover { filter: brightness(1.06); }
|
|
33
|
+
button.quiet { border-color: transparent; background: transparent; color: var(--muted); }
|
|
34
|
+
:focus-visible { outline: 2px solid var(--primary); outline-offset: 4px; }
|
|
35
|
+
.skip-link { position: absolute; left: 16px; top: -100px; z-index: 10; padding: 12px; background: var(--surface); }
|
|
36
|
+
.skip-link:focus { top: 8px; }
|
|
37
|
+
.app-header { max-width: 1600px; margin: auto; padding: 28px 32px 16px; }
|
|
38
|
+
.header-row, .toolbar, .connection-controls { display: flex; align-items: center; justify-content: space-between; gap: 16px; flex-wrap: wrap; }
|
|
39
|
+
.brand { display: flex; align-items: center; gap: 12px; font-size: 20px; font-weight: 750; letter-spacing: -.5px; color: var(--text); text-decoration: none; }
|
|
40
|
+
.brand-mark { width: 42px; height: 42px; flex: none; }
|
|
41
|
+
.brand-mark rect { fill: var(--accent); }
|
|
42
|
+
.brand-mark path { fill: none; stroke: #143829; stroke-width: 1.8; stroke-linejoin: round; }
|
|
43
|
+
.brand-caption { display: block; font-size: 9px; font-weight: 600; letter-spacing: 1.7px; margin-top: 2px; color: var(--muted); }
|
|
44
|
+
#connection { font-size: 12px; color: var(--muted); display: flex; align-items: center; gap: 8px; }
|
|
45
|
+
#connection::before { content: ''; width: 7px; height: 7px; border-radius: 50%; background: var(--muted); }
|
|
46
|
+
#connection[data-state=connected]::before { background: var(--primary); box-shadow: 0 0 0 4px var(--tint); }
|
|
47
|
+
#connection[data-state=error]::before { background: var(--danger); }
|
|
48
|
+
#refresh { border-radius: 24px; }
|
|
49
|
+
.app-header > .eyebrow { font-size: 11px; text-align: right; margin: 14px 0 0; opacity: .9; }
|
|
50
|
+
.workspace { display: grid; grid-template-columns: 204px minmax(0,1fr); gap: 40px; max-width: 1600px; margin: auto; padding: 24px 32px 64px; }
|
|
51
|
+
.sidebar { align-self: start; position: sticky; top: 24px; }
|
|
52
|
+
.nav-caption { font-size: 10px; font-weight: 600; letter-spacing: 1.7px; color: var(--muted); padding: 0 16px; margin: 8px 0 20px; }
|
|
53
|
+
nav { display: flex; flex-direction: column; gap: 8px; }
|
|
54
|
+
nav a { display: flex; align-items: center; gap: 12px; padding: 14px 16px; text-decoration: none; color: var(--muted); border-radius: 14px; font-size: 14px; font-weight: 550; }
|
|
55
|
+
nav a:hover { background: var(--surface); color: var(--text); }
|
|
56
|
+
nav a[aria-current=page] { color: #123526; background: var(--accent); font-weight: 700; box-shadow: 0 3px 16px rgb(68 200 141 / .1); }
|
|
57
|
+
nav svg { width: 19px; height: 19px; fill: none; stroke: currentColor; stroke-width: 1.6; stroke-linejoin: round; stroke-linecap: round; flex: none; }
|
|
58
|
+
.sidebar-note { border-top: 1px solid var(--border); margin: 40px 16px 0; padding-top: 24px; color: var(--muted); font-size: 12px; line-height: 1.8; }
|
|
59
|
+
.sidebar-note p { margin: 12px 0; font-size: 13px; color: var(--text); }
|
|
60
|
+
.local-badge { font-size: 9px; letter-spacing: 1.2px; color: var(--primary); font-weight: 650; }
|
|
61
|
+
.app-main { min-width: 0; }
|
|
62
|
+
.page-heading { display: flex; gap: 16px; align-items: center; justify-content: space-between; margin-bottom: 24px; }
|
|
63
|
+
.page-description { color: var(--muted); font-size: 13px; margin: 8px 0 0; }
|
|
64
|
+
.eyebrow, .muted, .snapshot-meta { color: var(--muted); font-size: 12px; }
|
|
65
|
+
.snapshot-meta { margin: 12px 2px 22px; text-align: right; font-size: 11px; }
|
|
66
|
+
.panel { min-width: 0; background: var(--surface); border: 1px solid var(--border); border-radius: 20px; padding: 24px; margin: 0 0 20px; box-shadow: var(--shadow); }
|
|
67
|
+
.metric-grid { display: grid; grid-template-columns: repeat(4,minmax(0,1fr)); gap: 16px; }
|
|
68
|
+
.metric-card { background: var(--surface); border: 1px solid var(--border); border-radius: 18px; padding: 22px; min-width: 0; box-shadow: var(--shadow); }
|
|
69
|
+
.metric-value { font-size: 38px; font-weight: 650; letter-spacing: -1.2px; line-height: 1.15; margin: 14px 0 8px; overflow-wrap: anywhere; }
|
|
70
|
+
.metric-card[data-tone=accent] .metric-value { color: var(--primary); }
|
|
71
|
+
.metric-card[data-tone=warning] .metric-value { color: var(--warning); }
|
|
72
|
+
.metric-note { font-size: 11px; color: var(--muted); margin: 0 0 8px; }
|
|
73
|
+
details, summary { font-size: 12px; color: var(--muted); }
|
|
74
|
+
summary { cursor: pointer; min-height: 36px; padding: 8px 0; }
|
|
75
|
+
summary:hover { color: var(--primary); }
|
|
76
|
+
.metric-card summary { font-size: 11px; min-height: 28px; padding: 4px 0; }
|
|
77
|
+
.metric-card details p, .explanation p, .coverage-note p { overflow-wrap: anywhere; line-height: 1.7; }
|
|
78
|
+
.badge { display: inline-block; border: 1px solid var(--border); border-radius: 20px; padding: 3px 9px; font-size: 11px; background: var(--surface-soft); }
|
|
79
|
+
.notice { background: var(--tint); border: 1px solid var(--border); border-left: 3px solid var(--primary); padding: 16px 20px; border-radius: 14px; margin: 16px 0; }
|
|
80
|
+
.notice strong { text-transform: capitalize; font-size: 13px; }
|
|
81
|
+
.notice p { font-size: 13px; }
|
|
82
|
+
.notice-error, .notice-stale { border-left-color: var(--warning); background: var(--warning-bg); }
|
|
83
|
+
.filter-bar { display: flex; flex-wrap: wrap; gap: 12px; align-items: end; margin: 0 0 24px; }
|
|
84
|
+
label { display: flex; flex-direction: column; gap: 5px; font-size: 11px; color: var(--muted); }
|
|
85
|
+
label input, label select { color: var(--text); max-width: 220px; min-width: 0; font-size: 13px; }
|
|
86
|
+
input::placeholder { color: var(--muted); opacity: 1; }
|
|
87
|
+
.advanced-filters > summary { border: 1px solid var(--control-border); border-radius: 10px; min-height: 40px; padding: 10px 14px; color: var(--text); font-size: 13px; }
|
|
88
|
+
.advanced-filters[open] { flex-basis: 100%; order: 10; }
|
|
89
|
+
.advanced-filters[open] > summary { width: fit-content; border-color: transparent; padding-left: 0; }
|
|
90
|
+
.advanced-fields { display: flex; gap: 16px; flex-wrap: wrap; padding: 16px; margin-top: 8px; background: var(--surface); border: 1px solid var(--border); border-radius: 14px; }
|
|
91
|
+
.toggle-label { flex-direction: row; align-items: center; gap: 8px; min-height: 44px; cursor: pointer; font-size: 11px; }
|
|
92
|
+
.toggle-label input[type=checkbox] { width: 16px; height: 16px; min-height: 16px; padding: 0; margin: 0; flex: none; accent-color: var(--primary); }
|
|
93
|
+
.overview-primary { display: grid; grid-template-columns: minmax(0,1.85fr) minmax(260px,1fr); gap: 20px; }
|
|
94
|
+
.section-meta { float: right; font-size: 11px; color: var(--muted); font-weight: 400; letter-spacing: 0; margin-top: 4px; }
|
|
95
|
+
.activity-chart { margin: 28px 0 16px; }
|
|
96
|
+
.activity-chart svg { width: 100%; display: block; overflow: visible; }
|
|
97
|
+
.chart-grid { stroke: var(--border); stroke-dasharray: 3 5; }
|
|
98
|
+
.chart-tick { fill: var(--muted); font-size: 11px; }
|
|
99
|
+
.chart-bar { fill: var(--accent); }
|
|
100
|
+
.chart-partial { stroke: var(--text); stroke-width: 1; stroke-dasharray: 3 3; }
|
|
101
|
+
.chart-unknown { fill: var(--surface-soft); stroke: var(--control-border); stroke-dasharray: 2 2; }
|
|
102
|
+
.chart-zero { fill: var(--surface); stroke: var(--primary); }
|
|
103
|
+
.chart-dates { display: flex; justify-content: space-between; font-size: 10px; color: var(--muted); margin: -10px 0 20px 4%; }
|
|
104
|
+
.chart-legend { display: flex; gap: 16px; flex-wrap: wrap; font-size: 10px; color: var(--muted); }
|
|
105
|
+
.chart-legend span { display: inline-flex; gap: 7px; align-items: center; }
|
|
106
|
+
.chart-legend span::before { content: ''; width: 8px; height: 8px; border-radius: 3px; background: var(--accent); }
|
|
107
|
+
.chart-legend .partial::before { border: 1px dashed var(--text); }
|
|
108
|
+
.chart-legend .unknown::before { background: var(--surface-soft); border: 1px dashed var(--control-border); }
|
|
109
|
+
.coverage-note { background: var(--surface-soft); border-radius: 10px; padding: 0 12px; margin: 12px 0 6px; }
|
|
110
|
+
.coverage-note summary { font-size: 11px; }
|
|
111
|
+
.coverage-note p { padding-bottom: 12px; }
|
|
112
|
+
.coverage-degraded, .coverage-disabled { background: var(--warning-bg); }
|
|
113
|
+
.daily-values > summary { font-size: 11px; }
|
|
114
|
+
.inventory-counts { margin: 16px 0; }
|
|
115
|
+
.inventory-counts > div { display: flex; justify-content: space-between; align-items: baseline; padding: 8px 0; gap: 12px; border-bottom: 1px solid var(--border); }
|
|
116
|
+
.inventory-counts dt { color: var(--muted); font-size: 12px; }
|
|
117
|
+
.inventory-counts dd { margin: 0; font-size: 22px; font-weight: 600; }
|
|
118
|
+
.growth-summary { display: flex; flex-direction: column; gap: 4px; font-size: 11px; color: var(--muted); }
|
|
119
|
+
.explanation { margin-top: 8px; }
|
|
120
|
+
.explanation summary { font-size: 11px; }
|
|
121
|
+
.two-column { display: grid; grid-template-columns: minmax(0,1fr) minmax(0,1fr); gap: 20px; }
|
|
122
|
+
.outcome-grid { display: grid; grid-template-columns: repeat(5,minmax(0,1fr)); gap: 8px; margin: 24px 0 16px; }
|
|
123
|
+
.outcome { display: flex; flex-direction: column; gap: 6px; text-align: center; }
|
|
124
|
+
.outcome strong { font-size: 28px; font-weight: 600; }
|
|
125
|
+
.outcome span { font-size: 10px; color: var(--muted); text-transform: capitalize; overflow-wrap: anywhere; }
|
|
126
|
+
.outcome-solved strong { color: var(--primary); }
|
|
127
|
+
.outcome-failed strong, .outcome-regressed strong { color: var(--danger); }
|
|
128
|
+
.investigation-stages { list-style: none; display: grid; grid-template-columns: repeat(5,minmax(0,1fr)); gap: 12px; padding: 0; margin: 24px 0 16px; }
|
|
129
|
+
.investigation-stages li { display: flex; flex-direction: column; gap: 6px; position: relative; }
|
|
130
|
+
.investigation-stages strong { font-size: 28px; font-weight: 600; }
|
|
131
|
+
.investigation-stages span { color: var(--muted); font-size: 10px; overflow-wrap: anywhere; }
|
|
132
|
+
.breakdown { display: grid; grid-template-columns: minmax(0,1fr) auto; gap: 6px 16px; margin: 16px 0; font-size: 12px; overflow-wrap: anywhere; }
|
|
133
|
+
.breakdown strong { font-weight: 500; }
|
|
134
|
+
meter { width: 100%; height: 8px; grid-column: 1/-1; accent-color: var(--primary); }
|
|
135
|
+
meter::-webkit-meter-bar { background: var(--surface-soft); border: 0; border-radius: 6px; }
|
|
136
|
+
meter::-webkit-meter-optimum-value { background: var(--accent); border-radius: 6px; }
|
|
137
|
+
.health-panel { padding: 12px 24px; box-shadow: none; }
|
|
138
|
+
.health-panel > summary { display: flex; align-items: center; justify-content: space-between; gap: 16px; color: var(--text); font-size: 13px; }
|
|
139
|
+
.health-panel > summary::before { content: '+'; color: var(--muted); }
|
|
140
|
+
.health-panel[open] > summary::before { content: '−'; }
|
|
141
|
+
.health-panel > summary > .muted { margin-left: auto; font-size: 11px; }
|
|
142
|
+
.table-region { overflow-x: auto; margin: 16px 0; border: 1px solid var(--border); border-radius: 16px; background: var(--surface); }
|
|
143
|
+
table { border-collapse: collapse; width: 100%; text-align: left; font-size: 13px; }
|
|
144
|
+
caption { text-align: left; font-weight: 600; padding: 20px; }
|
|
145
|
+
th,td { padding: 14px 20px; border-top: 1px solid var(--border); vertical-align: top; min-width: 110px; max-width: 600px; overflow-wrap: anywhere; }
|
|
146
|
+
th { background: var(--surface-soft); font-size: 11px; color: var(--muted); }
|
|
147
|
+
th button { border: 0; padding: 0; background: none; font-weight: 600; }
|
|
148
|
+
tbody tr:hover { background: var(--surface-soft); }
|
|
149
|
+
td button { text-align: left; }
|
|
150
|
+
.pagination { display: flex; gap: 12px; align-items: center; padding: 16px; flex-wrap: wrap; }
|
|
151
|
+
pre { overflow: auto; white-space: pre-wrap; overflow-wrap: anywhere; font-size: 12px; }
|
|
152
|
+
code { font: 12px ui-monospace,SFMono-Regular,monospace; }
|
|
153
|
+
.sr-only { position: absolute; width: 1px; height: 1px; padding: 0; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
|
|
154
|
+
.detail-panel { width: min(900px,calc(100% - 32px)); max-height: calc(100vh - 48px); overflow: auto; overflow-wrap: anywhere; color: var(--text); background: var(--surface); border: 1px solid var(--border); border-radius: 20px; padding: 24px; box-shadow: 0 24px 80px rgb(0 0 0 / .35); }
|
|
155
|
+
.detail-panel::backdrop { background: rgb(0 0 0 / .65); }
|
|
156
|
+
.detail-panel h3 { margin-top: 24px; color: var(--primary); }
|
|
157
|
+
.detail-panel li { margin: 8px 0; overflow-wrap: anywhere; }
|
|
158
|
+
.detail-panel .toolbar { position: sticky; top: -24px; background: var(--surface); padding: 16px 0; border-bottom: 1px solid var(--border); }
|
|
159
|
+
.detail-panel .toolbar > * { min-width: 0; }
|
|
160
|
+
@media (max-width: 1200px) {
|
|
161
|
+
.workspace { grid-template-columns: 176px minmax(0,1fr); gap: 24px; }
|
|
162
|
+
.metric-card { padding: 18px; }
|
|
163
|
+
.metric-value { font-size: 32px; }
|
|
164
|
+
.overview-primary { grid-template-columns: minmax(0,1.5fr) minmax(230px,1fr); }
|
|
165
|
+
.page-heading { align-items: start; flex-wrap: wrap; }
|
|
166
|
+
}
|
|
167
|
+
@media (max-width: 960px) {
|
|
168
|
+
.workspace { grid-template-columns: minmax(0,1fr); padding: 12px 24px 40px; gap: 24px; }
|
|
169
|
+
.app-header { padding: 20px 24px 12px; }
|
|
170
|
+
.sidebar { position: static; }
|
|
171
|
+
.nav-caption, .sidebar-note { display: none; }
|
|
172
|
+
nav { flex-direction: row; }
|
|
173
|
+
nav a { flex: 1; justify-content: center; }
|
|
174
|
+
.page-heading .toolbar { margin-left: auto; }
|
|
175
|
+
.metric-grid { gap: 12px; }
|
|
176
|
+
}
|
|
177
|
+
@media (max-width: 680px) {
|
|
178
|
+
.overview-primary, .two-column { grid-template-columns: minmax(0,1fr); gap: 0; }
|
|
179
|
+
.metric-grid { grid-template-columns: repeat(2,minmax(0,1fr)); }
|
|
180
|
+
.connection-controls { width: 100%; gap: 8px; }
|
|
181
|
+
.app-header > .eyebrow { text-align: left; }
|
|
182
|
+
.page-heading { gap: 10px; }
|
|
183
|
+
.page-heading .toolbar { margin-left: 0; }
|
|
184
|
+
.panel { padding: 20px; }
|
|
185
|
+
.snapshot-meta { text-align: left; }
|
|
186
|
+
.section-meta { float: none; display: block; margin-top: 6px; }
|
|
187
|
+
.health-panel > summary { flex-wrap: wrap; gap: 8px; }
|
|
188
|
+
.health-panel > summary > .muted { width: 100%; margin-left: 18px; }
|
|
189
|
+
}
|
|
190
|
+
@media (max-width: 400px) {
|
|
191
|
+
.app-header { padding: 20px 16px 8px; }
|
|
192
|
+
.workspace { padding: 12px 16px 32px; }
|
|
193
|
+
nav a { min-width: 0; flex-direction: column; padding: 10px 4px; gap: 6px; font-size: 12px; }
|
|
194
|
+
nav svg { width: 15px; height: 15px; }
|
|
195
|
+
h1 { font-size: 26px; }
|
|
196
|
+
.metric-card { padding: 14px; border-radius: 14px; }
|
|
197
|
+
.metric-value { font-size: 28px; }
|
|
198
|
+
.filter-bar > label { flex: 1; min-width: 110px; }
|
|
199
|
+
label input, label select { max-width: 100%; width: 100%; }
|
|
200
|
+
.advanced-fields label { width: 100%; }
|
|
201
|
+
.panel { padding: 16px; }
|
|
202
|
+
.chart-legend { gap: 8px; }
|
|
203
|
+
.outcome-grid { gap: 4px; }
|
|
204
|
+
.outcome span { font-size: 9px; }
|
|
205
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { type Server, type IncomingMessage, type ServerResponse } from 'node:http';
|
|
2
|
+
export declare function startDashboardServer(options: {
|
|
3
|
+
home: string;
|
|
4
|
+
port?: number;
|
|
5
|
+
}): Promise<{
|
|
6
|
+
server: Server<typeof IncomingMessage, typeof ServerResponse>;
|
|
7
|
+
url: string;
|
|
8
|
+
port: number;
|
|
9
|
+
close: () => Promise<void>;
|
|
10
|
+
}>;
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
import { createServer } from 'node:http';
|
|
2
|
+
import { readFile } from 'node:fs/promises';
|
|
3
|
+
import { z } from 'zod';
|
|
4
|
+
import { getStatistics } from '../core/statistics.js';
|
|
5
|
+
import { getDiagnosticPage, getKnowledgePage } from '../core/statistics-pages.js';
|
|
6
|
+
import { getSyncStatus } from '../core/sync-status.js';
|
|
7
|
+
import { DiagnosticQuerySchema, KnowledgeQuerySchema, StatisticsQuerySchema } from '../core/statistics-query.js';
|
|
8
|
+
const assets = new Map([['/', ['index.html', 'text/html; charset=utf-8']], ['/app.js', ['app.js', 'text/javascript; charset=utf-8']], ['/styles.css', ['styles.css', 'text/css; charset=utf-8']]]);
|
|
9
|
+
assets.set('/components/index.js', ['components/index.js', 'text/javascript; charset=utf-8']);
|
|
10
|
+
for (const name of ['api', 'overview', 'knowledge', 'solution-detail', 'diagnostics', 'diagnostic-detail', 'components/detail-panel', 'components/input-diff'])
|
|
11
|
+
assets.set(`/${name}.js`, [`${name}.js`, 'text/javascript; charset=utf-8']);
|
|
12
|
+
const publicDirectory = new URL(import.meta.url.endsWith('.ts') ? '../../dist/dashboard/public/' : './public/', import.meta.url);
|
|
13
|
+
export async function startDashboardServer(options) {
|
|
14
|
+
const port = options.port ?? 4318;
|
|
15
|
+
if (!Number.isInteger(port) || port < 0 || port > 65535)
|
|
16
|
+
throw new Error('invalid_dashboard_port');
|
|
17
|
+
const server = createServer((request, response) => { void handle(request, response, options.home, server); });
|
|
18
|
+
server.requestTimeout = 5000;
|
|
19
|
+
server.headersTimeout = 5000;
|
|
20
|
+
server.keepAliveTimeout = 1000;
|
|
21
|
+
await new Promise((resolve, reject) => { server.once('error', reject); server.listen(port, '127.0.0.1', () => { server.off('error', reject); resolve(); }); });
|
|
22
|
+
const address = server.address();
|
|
23
|
+
if (!address || typeof address === 'string')
|
|
24
|
+
throw new Error('dashboard_address_unavailable');
|
|
25
|
+
let closing;
|
|
26
|
+
return { server, url: `http://127.0.0.1:${address.port}`, port: address.port, close: () => closing ??= new Promise((resolve, reject) => { server.close((error) => error ? reject(error) : resolve()); server.closeAllConnections(); }) };
|
|
27
|
+
}
|
|
28
|
+
async function handle(request, response, home, server) {
|
|
29
|
+
response.setHeader('Cache-Control', 'no-store');
|
|
30
|
+
response.setHeader('X-Content-Type-Options', 'nosniff');
|
|
31
|
+
response.setHeader('Referrer-Policy', 'no-referrer');
|
|
32
|
+
response.setHeader('Content-Security-Policy', "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'none'; frame-ancestors 'none'; form-action 'none'");
|
|
33
|
+
const reply = (status, body) => { if (!response.destroyed) {
|
|
34
|
+
response.writeHead(status, { 'Content-Type': 'application/json; charset=utf-8' });
|
|
35
|
+
response.end(JSON.stringify(body));
|
|
36
|
+
} };
|
|
37
|
+
try {
|
|
38
|
+
const address = server.address();
|
|
39
|
+
const port = address && typeof address !== 'string' ? address.port : 0;
|
|
40
|
+
const host = request.headers.host;
|
|
41
|
+
if (!host || ![`127.0.0.1:${port}`, `localhost:${port}`].includes(host) || request.headers.origin && request.headers.origin !== `http://${host}` || request.headers['sec-fetch-site'] && !['none', 'same-origin'].includes(String(request.headers['sec-fetch-site']))) {
|
|
42
|
+
reply(403, { code: 'origin_not_allowed' });
|
|
43
|
+
return;
|
|
44
|
+
}
|
|
45
|
+
if (request.method !== 'GET') {
|
|
46
|
+
response.setHeader('Allow', 'GET');
|
|
47
|
+
reply(405, { code: 'read_only' });
|
|
48
|
+
return;
|
|
49
|
+
}
|
|
50
|
+
const raw = request.url ?? '/';
|
|
51
|
+
if (raw.length > 4096 || !raw.startsWith('/') || raw.startsWith('//') || /\\|%2f|%5c|(?:^|\/)\.\.(?:\/|$)/i.test(raw.split('?')[0])) {
|
|
52
|
+
reply(400, { code: 'invalid_path' });
|
|
53
|
+
return;
|
|
54
|
+
}
|
|
55
|
+
const url = new URL(raw, `http://${host}`);
|
|
56
|
+
const asset = assets.get(url.pathname);
|
|
57
|
+
if (asset) {
|
|
58
|
+
if (url.search && url.pathname !== '/') {
|
|
59
|
+
reply(400, { code: 'invalid_query' });
|
|
60
|
+
return;
|
|
61
|
+
}
|
|
62
|
+
const body = await readFile(new URL(asset[0], publicDirectory));
|
|
63
|
+
response.writeHead(200, { 'Content-Type': asset[1] });
|
|
64
|
+
response.end(body);
|
|
65
|
+
return;
|
|
66
|
+
}
|
|
67
|
+
let result;
|
|
68
|
+
if (url.pathname === '/api/stats')
|
|
69
|
+
result = await getStatistics(home, StatisticsQuerySchema.parse(query(url.searchParams)));
|
|
70
|
+
else if (url.pathname === '/api/status') {
|
|
71
|
+
if (url.search) {
|
|
72
|
+
reply(400, { code: 'invalid_query' });
|
|
73
|
+
return;
|
|
74
|
+
}
|
|
75
|
+
result = await getSyncStatus(home);
|
|
76
|
+
}
|
|
77
|
+
else if (url.pathname === '/api/knowledge')
|
|
78
|
+
result = await getKnowledgePage(home, KnowledgeQuerySchema.parse(query(url.searchParams)));
|
|
79
|
+
else if (url.pathname.startsWith('/api/knowledge/')) {
|
|
80
|
+
const id = decodeURIComponent(url.pathname.slice('/api/knowledge/'.length));
|
|
81
|
+
if (!/^(?:problem|solution|pending|candidate|legacy)-[a-z0-9-]+(?:@[1-9][0-9]*)?$/.test(id)) {
|
|
82
|
+
reply(400, { code: 'invalid_handle' });
|
|
83
|
+
return;
|
|
84
|
+
}
|
|
85
|
+
const supplied = query(url.searchParams);
|
|
86
|
+
if ('detail_id' in supplied || 'kind' in supplied) {
|
|
87
|
+
reply(400, { code: 'invalid_query' });
|
|
88
|
+
return;
|
|
89
|
+
}
|
|
90
|
+
const kind = id.startsWith('problem-') ? 'problems' : id.startsWith('pending-') ? 'pending' : id.startsWith('legacy-') || id.startsWith('candidate-') ? 'legacy' : 'solutions';
|
|
91
|
+
result = await getKnowledgePage(home, { ...supplied, all: true, kind, detail_id: id });
|
|
92
|
+
}
|
|
93
|
+
else if (url.pathname === '/api/diagnostics')
|
|
94
|
+
result = getDiagnosticPage(home, DiagnosticQuerySchema.parse(query(url.searchParams)));
|
|
95
|
+
else if (url.pathname.startsWith('/api/diagnostics/')) {
|
|
96
|
+
const id = url.pathname.slice('/api/diagnostics/'.length);
|
|
97
|
+
if (!z.uuid().safeParse(id).success) {
|
|
98
|
+
reply(400, { code: 'invalid_diagnostic_id' });
|
|
99
|
+
return;
|
|
100
|
+
}
|
|
101
|
+
const supplied = query(url.searchParams);
|
|
102
|
+
if ('diagnostic_id' in supplied) {
|
|
103
|
+
reply(400, { code: 'invalid_query' });
|
|
104
|
+
return;
|
|
105
|
+
}
|
|
106
|
+
result = getDiagnosticPage(home, { ...supplied, all: true, diagnostic_id: id });
|
|
107
|
+
}
|
|
108
|
+
else {
|
|
109
|
+
reply(404, { code: 'not_found' });
|
|
110
|
+
return;
|
|
111
|
+
}
|
|
112
|
+
reply(200, result);
|
|
113
|
+
}
|
|
114
|
+
catch (error) {
|
|
115
|
+
if (error instanceof z.ZodError)
|
|
116
|
+
reply(400, { code: 'invalid_query', fields: [...new Set(error.issues.map((i) => typeof i.path[0] === 'string' && /^[a-z_]+$/.test(i.path[0]) ? i.path[0] : 'query'))] });
|
|
117
|
+
else if (error instanceof URIError)
|
|
118
|
+
reply(400, { code: 'invalid_path' });
|
|
119
|
+
else
|
|
120
|
+
reply(503, { code: 'dashboard_unavailable' });
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
function query(params) {
|
|
124
|
+
const input = Object.create(null);
|
|
125
|
+
const allowed = new Set([...Object.keys(KnowledgeQuerySchema.shape), ...Object.keys(DiagnosticQuerySchema.shape)]);
|
|
126
|
+
for (const [key, value] of params) {
|
|
127
|
+
if (!allowed.has(key) || Object.hasOwn(input, key))
|
|
128
|
+
throw new z.ZodError([{ code: 'custom', path: ['query'], message: 'Unknown or duplicate field' }]);
|
|
129
|
+
input[key] = ['days', 'page', 'page_size', 'revision'].includes(key) ? /^\d+$/.test(value) ? Number(value) : NaN : key === 'all' ? value === 'true' ? true : value === 'false' ? false : value : value;
|
|
130
|
+
}
|
|
131
|
+
return input;
|
|
132
|
+
}
|
|
133
|
+
//# sourceMappingURL=server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/dashboard/server.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -3,3 +3,7 @@ export { AGENT_RULEBOOK_VERSION } from './version.js';
|
|
|
3
3
|
export { createAgentRulebookMcpServer, AGENT_RULEBOOK_MCP_TOOL_NAMES, AGENT_RULEBOOK_MCP_TOOLS } from './mcp/index.js';
|
|
4
4
|
export { ProblemSchema, SolutionSchema, OutcomeSchema, SourceEvidenceLocatorSchema, ResolutionDocumentSchema, fingerprintProblem, detectProjectEnvironment, detectProjectStack, resolveSourceEvidence, } from './core/index.js';
|
|
5
5
|
export type { Problem, Solution, Outcome, SourceEvidenceLocator, ResolutionDocument, ProjectEnvironmentResult } from './core/index.js';
|
|
6
|
+
export { resolveStatisticsQuery } from './core/statistics-query.js';
|
|
7
|
+
export { getStatistics } from './core/statistics.js';
|
|
8
|
+
export { getKnowledgePage, getDiagnosticPage } from './core/statistics-pages.js';
|
|
9
|
+
export type { Statistics, AppliedStatisticsQuery, KnowledgeRow, PageResult } from './core/statistics-types.js';
|
package/dist/index.js
CHANGED
|
@@ -2,4 +2,7 @@ export { createCliProgram } from './program.js';
|
|
|
2
2
|
export { AGENT_RULEBOOK_VERSION } from './version.js';
|
|
3
3
|
export { createAgentRulebookMcpServer, AGENT_RULEBOOK_MCP_TOOL_NAMES, AGENT_RULEBOOK_MCP_TOOLS } from './mcp/index.js';
|
|
4
4
|
export { ProblemSchema, SolutionSchema, OutcomeSchema, SourceEvidenceLocatorSchema, ResolutionDocumentSchema, fingerprintProblem, detectProjectEnvironment, detectProjectStack, resolveSourceEvidence, } from './core/index.js';
|
|
5
|
+
export { resolveStatisticsQuery } from './core/statistics-query.js';
|
|
6
|
+
export { getStatistics } from './core/statistics.js';
|
|
7
|
+
export { getKnowledgePage, getDiagnosticPage } from './core/statistics-pages.js';
|
|
5
8
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AACvH,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AACvH,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { Transport, TransportSendOptions } from '@modelcontextprotocol/sdk/shared/transport.js';
|
|
2
|
+
import { type JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
|
|
3
|
+
import { UsageObserver } from '../core/usage-observer.js';
|
|
4
|
+
/** Public transport decorator: receives before SDK request validation and observes outgoing responses. */
|
|
5
|
+
export declare class ObservedTransport implements Transport {
|
|
6
|
+
readonly inner: Transport;
|
|
7
|
+
onmessage: Transport['onmessage'];
|
|
8
|
+
onerror: Transport['onerror'];
|
|
9
|
+
onclose: Transport['onclose'];
|
|
10
|
+
private readonly pending;
|
|
11
|
+
private readonly ambiguous;
|
|
12
|
+
readonly observer: UsageObserver;
|
|
13
|
+
constructor(inner: Transport, home: string);
|
|
14
|
+
get sessionId(): string | undefined;
|
|
15
|
+
setProtocolVersion(version: string): void;
|
|
16
|
+
start(): Promise<void>;
|
|
17
|
+
send(message: JSONRPCMessage, options?: TransportSendOptions): Promise<void>;
|
|
18
|
+
close(): Promise<void>;
|
|
19
|
+
private finishPending;
|
|
20
|
+
}
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
import { CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
|
|
2
|
+
import { object, UsageObserver } from '../core/usage-observer.js';
|
|
3
|
+
import { inputIssues } from './tool-output.js';
|
|
4
|
+
/** Public transport decorator: receives before SDK request validation and observes outgoing responses. */
|
|
5
|
+
export class ObservedTransport {
|
|
6
|
+
inner;
|
|
7
|
+
onmessage;
|
|
8
|
+
onerror;
|
|
9
|
+
onclose;
|
|
10
|
+
pending = new Map();
|
|
11
|
+
ambiguous = new Map();
|
|
12
|
+
observer;
|
|
13
|
+
constructor(inner, home) {
|
|
14
|
+
this.inner = inner;
|
|
15
|
+
this.observer = new UsageObserver(home, 'mcp');
|
|
16
|
+
}
|
|
17
|
+
get sessionId() { return this.inner.sessionId; }
|
|
18
|
+
setProtocolVersion(version) { this.inner.setProtocolVersion?.(version); }
|
|
19
|
+
async start() {
|
|
20
|
+
if (this.inner instanceof ObservedTransport) {
|
|
21
|
+
this.inner.onmessage = (message, extra) => this.onmessage?.(message, extra);
|
|
22
|
+
this.inner.onerror = (error) => this.onerror?.(error);
|
|
23
|
+
this.inner.onclose = () => this.onclose?.();
|
|
24
|
+
return this.inner.start();
|
|
25
|
+
}
|
|
26
|
+
this.inner.onmessage = (message, extra) => {
|
|
27
|
+
if ('method' in message && message.method === 'initialize') {
|
|
28
|
+
const params = object(message.params);
|
|
29
|
+
const client = object(params.clientInfo);
|
|
30
|
+
const supplied = object(object(params._meta).agent_rulebook);
|
|
31
|
+
this.observer.client = { name: client.name, version: client.version, agent: supplied.agent, model: supplied.model };
|
|
32
|
+
}
|
|
33
|
+
if ('method' in message && message.method === 'tools/call' && 'id' in message) {
|
|
34
|
+
const params = object(message.params);
|
|
35
|
+
const protocol = CallToolRequestSchema.safeParse(message);
|
|
36
|
+
const issues = protocol.success ? undefined : inputIssues(protocol.error.issues, message);
|
|
37
|
+
const call = this.observer.begin(params.name, protocol.success ? params.arguments : message, message.id, issues);
|
|
38
|
+
const key = requestKey(message.id);
|
|
39
|
+
if (call) {
|
|
40
|
+
const previous = this.pending.get(key);
|
|
41
|
+
if (previous || this.ambiguous.has(key)) {
|
|
42
|
+
if (previous)
|
|
43
|
+
this.observer.complete(previous, {}, 'ambiguous_request_id');
|
|
44
|
+
this.observer.complete(call, {}, 'ambiguous_request_id');
|
|
45
|
+
this.pending.delete(key);
|
|
46
|
+
this.ambiguous.set(key, (this.ambiguous.get(key) ?? 1) + 1);
|
|
47
|
+
}
|
|
48
|
+
else
|
|
49
|
+
this.pending.set(key, call);
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
if ('method' in message && message.method === 'notifications/cancelled') {
|
|
53
|
+
const key = requestKey(object(message.params).requestId);
|
|
54
|
+
const call = this.pending.get(key);
|
|
55
|
+
if (call) {
|
|
56
|
+
this.observer.complete(call, {}, 'client_cancelled');
|
|
57
|
+
this.pending.delete(key);
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
this.onmessage?.(message, extra);
|
|
61
|
+
};
|
|
62
|
+
this.inner.onerror = (error) => {
|
|
63
|
+
const call = this.observer.begin('<transport>', undefined, undefined, [{ code: 'protocol_error', path: [], expected: 'object', received: 'unknown' }]);
|
|
64
|
+
this.observer.complete(call, {}, 'transport_error');
|
|
65
|
+
this.onerror?.(error);
|
|
66
|
+
};
|
|
67
|
+
this.inner.onclose = () => { this.finishPending(); this.onclose?.(); };
|
|
68
|
+
await this.inner.start();
|
|
69
|
+
}
|
|
70
|
+
async send(message, options) {
|
|
71
|
+
if (this.inner instanceof ObservedTransport)
|
|
72
|
+
return this.inner.send(message, options);
|
|
73
|
+
let outgoing = message;
|
|
74
|
+
if ('id' in message && !('method' in message)) {
|
|
75
|
+
const key = requestKey(message.id);
|
|
76
|
+
const ambiguous = this.ambiguous.get(key);
|
|
77
|
+
if (ambiguous) {
|
|
78
|
+
if (ambiguous === 1)
|
|
79
|
+
this.ambiguous.delete(key);
|
|
80
|
+
else
|
|
81
|
+
this.ambiguous.set(key, ambiguous - 1);
|
|
82
|
+
}
|
|
83
|
+
else {
|
|
84
|
+
const call = this.pending.get(key);
|
|
85
|
+
this.pending.delete(key);
|
|
86
|
+
const usage = this.observer.complete(call, message);
|
|
87
|
+
if (usage && 'result' in message)
|
|
88
|
+
outgoing = { ...message, result: { ...message.result, _meta: { ...object(message.result._meta), usage } } };
|
|
89
|
+
// JSON-RPC errors retain their exact envelope; trace remains available in the local record.
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
await this.inner.send(outgoing, options);
|
|
93
|
+
}
|
|
94
|
+
async close() { this.finishPending(); await this.inner.close(); }
|
|
95
|
+
finishPending() { for (const call of this.pending.values())
|
|
96
|
+
this.observer.complete(call, {}, 'connection_closed'); this.pending.clear(); this.ambiguous.clear(); }
|
|
97
|
+
}
|
|
98
|
+
function requestKey(id) { return `${typeof id}:${JSON.stringify(id)}`; }
|
|
99
|
+
//# sourceMappingURL=observed-transport.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"observed-transport.js","sourceRoot":"","sources":["../../src/mcp/observed-transport.ts"],"names":[],"mappings":"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"}
|
|
@@ -14,6 +14,6 @@ export type PreparedResolutionChange = {
|
|
|
14
14
|
warnings: Array<Record<string, unknown>>;
|
|
15
15
|
solution_handle: string;
|
|
16
16
|
};
|
|
17
|
-
export declare function prepareResolutionChange(unparsed: McpResolutionsPrepareChangeInput, home: string): Promise<PreparedResolutionChange>;
|
|
17
|
+
export declare function prepareResolutionChange(unparsed: McpResolutionsPrepareChangeInput, home: string, previewDocuments?: readonly ResolutionDocument[]): Promise<PreparedResolutionChange>;
|
|
18
18
|
export declare function hashResolutionChangePayload(payload: McpResolutionsPrepareChangeInput): string;
|
|
19
19
|
export declare function isResolutionChangeCommitted(input: McpResolutionsPrepareChangeInput, home: string, relation: PreparedResolutionChange['relation']): Promise<boolean>;
|
|
@@ -3,12 +3,11 @@ import { access, readFile } from 'node:fs/promises';
|
|
|
3
3
|
import { buildAttemptOutcome, canonicalResolutionPath, classifyResolutionRelation, computeResolutionSemanticChecksum, fingerprintProblem, inspectResolutionChangePolicy, parseResolutionYaml, resolveSourceEvidence, SolutionSchema } from '../core/index.js';
|
|
4
4
|
import { loadCanonicalResolutions } from '../storage/index.js';
|
|
5
5
|
import { McpResolutionsPrepareChangeInputSchema } from './schemas.js';
|
|
6
|
-
|
|
6
|
+
import { stripUsageContext } from '../core/usage-context.js';
|
|
7
|
+
export async function prepareResolutionChange(unparsed, home, previewDocuments) {
|
|
7
8
|
const input = McpResolutionsPrepareChangeInputSchema.parse(unparsed);
|
|
8
9
|
const normalized = normalizePayload(input);
|
|
9
|
-
const
|
|
10
|
-
const canonical = await loadCanonicalResolutions(home);
|
|
11
|
-
const documents = canonical.map(({ document }) => document);
|
|
10
|
+
const documents = previewDocuments ? [...previewDocuments] : (await loadCanonicalResolutions(home)).map(({ document }) => document);
|
|
12
11
|
const stateHash = computeResolutionSemanticChecksum(documents);
|
|
13
12
|
const calculatedFingerprint = fingerprintProblem({ observations: input.problem.observations, hypotheses: input.problem.hypotheses, environment: input.problem.environment });
|
|
14
13
|
const policy = inspectResolutionChangePolicy(input.problem, input.solution);
|
|
@@ -30,11 +29,27 @@ export async function prepareResolutionChange(unparsed, home) {
|
|
|
30
29
|
weakTextOverlap: input.relation_evidence.weak_text_overlap ?? false,
|
|
31
30
|
};
|
|
32
31
|
const relation = classifyResolutionRelation(comparison);
|
|
32
|
+
if (sameProblem !== undefined) {
|
|
33
|
+
normalized.problem = sameProblem;
|
|
34
|
+
normalized.solution.problem_id = sameProblem.id;
|
|
35
|
+
}
|
|
36
|
+
if (exact !== undefined) {
|
|
37
|
+
normalized.solution.id = exact.id;
|
|
38
|
+
normalized.solution.revision = exact.revision;
|
|
39
|
+
}
|
|
40
|
+
if ((relation === 'refines_solution' || relation === 'supersedes_solution') && target !== undefined) {
|
|
41
|
+
normalized.solution.prior_solution = { id: target.id, revision: target.revision, relation: relation === 'refines_solution' ? 'refines' : 'supersedes' };
|
|
42
|
+
}
|
|
43
|
+
const payloadHash = hashResolutionChangePayload(normalized);
|
|
33
44
|
const base = { payload_hash: payloadHash, state_hash: stateHash, normalized_payload: normalized, relation, comparison, solution_handle: exact === undefined ? `${input.solution.id}@${input.solution.revision}` : `${exact.id}@${exact.revision}` };
|
|
34
45
|
if (input.problem_fingerprint !== calculatedFingerprint)
|
|
35
46
|
return blocked(base, 'problem_fingerprint_mismatch');
|
|
36
47
|
if (input.solution.problem_id !== input.problem.id)
|
|
37
48
|
return blocked(base, 'problem_solution_mismatch');
|
|
49
|
+
if (sameProblem !== undefined && fingerprintProblem({ observations: sameProblem.observations, hypotheses: sameProblem.hypotheses, environment: sameProblem.environment }) !== calculatedFingerprint)
|
|
50
|
+
return blocked(base, 'problem_identity_conflict');
|
|
51
|
+
if (target !== undefined && target.problem_id !== sameProblem?.id)
|
|
52
|
+
return blocked(base, 'target_problem_mismatch');
|
|
38
53
|
if (!policy.eligible)
|
|
39
54
|
return blocked(base, policy.code ?? 'change_policy_blocked', policy.warnings);
|
|
40
55
|
if (input.target_solution_handle !== undefined && target === undefined)
|
|
@@ -63,7 +78,7 @@ export async function prepareResolutionChange(unparsed, home) {
|
|
|
63
78
|
}).outcome];
|
|
64
79
|
}
|
|
65
80
|
else {
|
|
66
|
-
let proposed =
|
|
81
|
+
let proposed = normalized.solution;
|
|
67
82
|
if (relation === 'refines_solution' || relation === 'supersedes_solution') {
|
|
68
83
|
if (target === undefined || proposed.id !== target.id || proposed.revision !== target.revision + 1)
|
|
69
84
|
return blocked(base, 'invalid_solution_revision');
|
|
@@ -72,12 +87,12 @@ export async function prepareResolutionChange(unparsed, home) {
|
|
|
72
87
|
else if (existingSolutions.some(({ id, revision }) => id === proposed.id && revision === proposed.revision)) {
|
|
73
88
|
return blocked(base, 'solution_revision_exists');
|
|
74
89
|
}
|
|
75
|
-
changeDocuments = [...(sameProblem === undefined ? [
|
|
90
|
+
changeDocuments = [...(sameProblem === undefined ? [normalized.problem] : []), proposed];
|
|
76
91
|
}
|
|
77
92
|
return { ...base, status: 'prepared', eligible: true, documents: changeDocuments, warnings: [] };
|
|
78
93
|
}
|
|
79
94
|
export function hashResolutionChangePayload(payload) {
|
|
80
|
-
return `sha256:${createHash('sha256').update(stableJson(payload)).digest('hex')}`;
|
|
95
|
+
return `sha256:${createHash('sha256').update(stableJson(stripUsageContext(payload))).digest('hex')}`;
|
|
81
96
|
}
|
|
82
97
|
export async function isResolutionChangeCommitted(input, home, relation) {
|
|
83
98
|
if (relation === 'exact_solution') {
|
|
@@ -104,7 +119,7 @@ export async function isResolutionChangeCommitted(input, home, relation) {
|
|
|
104
119
|
try {
|
|
105
120
|
await access(path);
|
|
106
121
|
const parsed = parseResolutionYaml(await readFile(path, 'utf8'), path);
|
|
107
|
-
return parsed.success && parsed.document.kind === 'solution' &&
|
|
122
|
+
return parsed.success && parsed.document.kind === 'solution' && stableJson(parsed.document) === stableJson(input.solution);
|
|
108
123
|
}
|
|
109
124
|
catch {
|
|
110
125
|
return false;
|
|
@@ -124,7 +139,7 @@ function sameStrings(left, right) {
|
|
|
124
139
|
}
|
|
125
140
|
function normalizedText(value) { return value.normalize('NFKC').trim().toLowerCase().replace(/\s+/g, ' '); }
|
|
126
141
|
function normalizePayload(input) {
|
|
127
|
-
return JSON.parse(stableJson(input));
|
|
142
|
+
return JSON.parse(stableJson(stripUsageContext(input)));
|
|
128
143
|
}
|
|
129
144
|
function stableJson(value) {
|
|
130
145
|
if (Array.isArray(value))
|