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.
Files changed (177) hide show
  1. package/README.md +69 -5
  2. package/dist/commands/dashboard.d.ts +7 -0
  3. package/dist/commands/dashboard.js +42 -0
  4. package/dist/commands/dashboard.js.map +1 -0
  5. package/dist/commands/diagnostics.d.ts +2 -0
  6. package/dist/commands/diagnostics.js +38 -0
  7. package/dist/commands/diagnostics.js.map +1 -0
  8. package/dist/commands/import.d.ts +2 -0
  9. package/dist/commands/import.js +34 -0
  10. package/dist/commands/import.js.map +1 -0
  11. package/dist/commands/pending.d.ts +2 -0
  12. package/dist/commands/pending.js +27 -0
  13. package/dist/commands/pending.js.map +1 -0
  14. package/dist/commands/resolution.js +25 -11
  15. package/dist/commands/resolution.js.map +1 -1
  16. package/dist/commands/stats-renderer.d.ts +3 -0
  17. package/dist/commands/stats-renderer.js +76 -0
  18. package/dist/commands/stats-renderer.js.map +1 -0
  19. package/dist/commands/stats.d.ts +4 -0
  20. package/dist/commands/stats.js +107 -0
  21. package/dist/commands/stats.js.map +1 -0
  22. package/dist/commands/status.d.ts +2 -0
  23. package/dist/commands/status.js +17 -0
  24. package/dist/commands/status.js.map +1 -0
  25. package/dist/commands/sync.js +1 -1
  26. package/dist/commands/sync.js.map +1 -1
  27. package/dist/commands/usage.d.ts +2 -0
  28. package/dist/commands/usage.js +25 -0
  29. package/dist/commands/usage.js.map +1 -0
  30. package/dist/core/codex-call-parser.d.ts +10 -0
  31. package/dist/core/codex-call-parser.js +97 -0
  32. package/dist/core/codex-call-parser.js.map +1 -0
  33. package/dist/core/codex-usage-import.d.ts +24 -0
  34. package/dist/core/codex-usage-import.js +259 -0
  35. package/dist/core/codex-usage-import.js.map +1 -0
  36. package/dist/core/diagnostic-cluster.d.ts +37 -0
  37. package/dist/core/diagnostic-cluster.js +20 -0
  38. package/dist/core/diagnostic-cluster.js.map +1 -0
  39. package/dist/core/environment-normalization.d.ts +21 -0
  40. package/dist/core/environment-normalization.js +42 -0
  41. package/dist/core/environment-normalization.js.map +1 -0
  42. package/dist/core/index.d.ts +1 -0
  43. package/dist/core/index.js +1 -0
  44. package/dist/core/index.js.map +1 -1
  45. package/dist/core/invocation-diagnostics.d.ts +40 -0
  46. package/dist/core/invocation-diagnostics.js +91 -0
  47. package/dist/core/invocation-diagnostics.js.map +1 -0
  48. package/dist/core/legacy-candidate.d.ts +159 -0
  49. package/dist/core/legacy-candidate.js +73 -0
  50. package/dist/core/legacy-candidate.js.map +1 -0
  51. package/dist/core/legacy-import-apply.d.ts +215 -0
  52. package/dist/core/legacy-import-apply.js +172 -0
  53. package/dist/core/legacy-import-apply.js.map +1 -0
  54. package/dist/core/legacy-import-manifest.d.ts +197 -0
  55. package/dist/core/legacy-import-manifest.js +63 -0
  56. package/dist/core/legacy-import-manifest.js.map +1 -0
  57. package/dist/core/legacy-scan.d.ts +71 -0
  58. package/dist/core/legacy-scan.js +99 -0
  59. package/dist/core/legacy-scan.js.map +1 -0
  60. package/dist/core/pending-replay.d.ts +4 -0
  61. package/dist/core/pending-replay.js +96 -0
  62. package/dist/core/pending-replay.js.map +1 -0
  63. package/dist/core/resolution-applicability.d.ts +1 -0
  64. package/dist/core/resolution-applicability.js +28 -11
  65. package/dist/core/resolution-applicability.js.map +1 -1
  66. package/dist/core/resolution-ranker.js +9 -2
  67. package/dist/core/resolution-ranker.js.map +1 -1
  68. package/dist/core/resolution-search-types.d.ts +9 -0
  69. package/dist/core/statistics-data.d.ts +98 -0
  70. package/dist/core/statistics-data.js +53 -0
  71. package/dist/core/statistics-data.js.map +1 -0
  72. package/dist/core/statistics-pages.d.ts +3 -0
  73. package/dist/core/statistics-pages.js +107 -0
  74. package/dist/core/statistics-pages.js.map +1 -0
  75. package/dist/core/statistics-query.d.ts +86 -0
  76. package/dist/core/statistics-query.js +51 -0
  77. package/dist/core/statistics-query.js.map +1 -0
  78. package/dist/core/statistics-types.d.ts +286 -0
  79. package/dist/core/statistics-types.js +2 -0
  80. package/dist/core/statistics-types.js.map +1 -0
  81. package/dist/core/statistics.d.ts +5 -0
  82. package/dist/core/statistics.js +101 -0
  83. package/dist/core/statistics.js.map +1 -0
  84. package/dist/core/sync-status.d.ts +53 -0
  85. package/dist/core/sync-status.js +85 -0
  86. package/dist/core/sync-status.js.map +1 -0
  87. package/dist/core/usage-context.d.ts +15 -0
  88. package/dist/core/usage-context.js +22 -0
  89. package/dist/core/usage-context.js.map +1 -0
  90. package/dist/core/usage-observer.d.ts +36 -0
  91. package/dist/core/usage-observer.js +112 -0
  92. package/dist/core/usage-observer.js.map +1 -0
  93. package/dist/core/usage-schema.d.ts +113 -0
  94. package/dist/core/usage-schema.js +33 -0
  95. package/dist/core/usage-schema.js.map +1 -0
  96. package/dist/dashboard/public/api.js +41 -0
  97. package/dist/dashboard/public/app.js +111 -0
  98. package/dist/dashboard/public/components/detail-panel.js +21 -0
  99. package/dist/dashboard/public/components/index.js +216 -0
  100. package/dist/dashboard/public/components/input-diff.js +15 -0
  101. package/dist/dashboard/public/diagnostic-detail.js +25 -0
  102. package/dist/dashboard/public/diagnostics.js +46 -0
  103. package/dist/dashboard/public/index.html +28 -0
  104. package/dist/dashboard/public/knowledge.js +57 -0
  105. package/dist/dashboard/public/overview.js +101 -0
  106. package/dist/dashboard/public/solution-detail.js +42 -0
  107. package/dist/dashboard/public/styles.css +205 -0
  108. package/dist/dashboard/server.d.ts +10 -0
  109. package/dist/dashboard/server.js +133 -0
  110. package/dist/dashboard/server.js.map +1 -0
  111. package/dist/index.d.ts +4 -0
  112. package/dist/index.js +3 -0
  113. package/dist/index.js.map +1 -1
  114. package/dist/mcp/observed-transport.d.ts +20 -0
  115. package/dist/mcp/observed-transport.js +99 -0
  116. package/dist/mcp/observed-transport.js.map +1 -0
  117. package/dist/mcp/resolution-change.d.ts +1 -1
  118. package/dist/mcp/resolution-change.js +24 -9
  119. package/dist/mcp/resolution-change.js.map +1 -1
  120. package/dist/mcp/resolutions-commit-change-tool.d.ts +5 -0
  121. package/dist/mcp/resolutions-commit-change-tool.js +22 -4
  122. package/dist/mcp/resolutions-commit-change-tool.js.map +1 -1
  123. package/dist/mcp/resolutions-find-tool.d.ts +1 -2
  124. package/dist/mcp/resolutions-find-tool.js +43 -8
  125. package/dist/mcp/resolutions-find-tool.js.map +1 -1
  126. package/dist/mcp/resolutions-list-facets-tool.d.ts +1 -1
  127. package/dist/mcp/resolutions-list-facets-tool.js +16 -2
  128. package/dist/mcp/resolutions-list-facets-tool.js.map +1 -1
  129. package/dist/mcp/resolutions-report-attempt-tool.d.ts +1 -0
  130. package/dist/mcp/resolutions-report-attempt-tool.js +44 -55
  131. package/dist/mcp/resolutions-report-attempt-tool.js.map +1 -1
  132. package/dist/mcp/schemas.d.ts +299 -14
  133. package/dist/mcp/schemas.js +31 -10
  134. package/dist/mcp/schemas.js.map +1 -1
  135. package/dist/mcp/server.js +20 -5
  136. package/dist/mcp/server.js.map +1 -1
  137. package/dist/mcp/stats-get-tool.d.ts +99 -0
  138. package/dist/mcp/stats-get-tool.js +17 -0
  139. package/dist/mcp/stats-get-tool.js.map +1 -0
  140. package/dist/mcp/tool-call.d.ts +99 -0
  141. package/dist/mcp/tool-call.js +20 -0
  142. package/dist/mcp/tool-call.js.map +1 -0
  143. package/dist/mcp/tool-output.d.ts +9 -0
  144. package/dist/mcp/tool-output.js +22 -0
  145. package/dist/mcp/tool-output.js.map +1 -1
  146. package/dist/mcp/tools.d.ts +182 -27
  147. package/dist/mcp/tools.js +10 -3
  148. package/dist/mcp/tools.js.map +1 -1
  149. package/dist/program.js +14 -0
  150. package/dist/program.js.map +1 -1
  151. package/dist/storage/canonical-write-lock.d.ts +2 -0
  152. package/dist/storage/canonical-write-lock.js +32 -0
  153. package/dist/storage/canonical-write-lock.js.map +1 -0
  154. package/dist/storage/diagnostic-store.d.ts +21 -0
  155. package/dist/storage/diagnostic-store.js +50 -0
  156. package/dist/storage/diagnostic-store.js.map +1 -0
  157. package/dist/storage/import-manifest.d.ts +6 -0
  158. package/dist/storage/import-manifest.js +41 -0
  159. package/dist/storage/import-manifest.js.map +1 -0
  160. package/dist/storage/pending-store.d.ts +329 -0
  161. package/dist/storage/pending-store.js +164 -0
  162. package/dist/storage/pending-store.js.map +1 -0
  163. package/dist/storage/resolution-candidate-service.js +2 -1
  164. package/dist/storage/resolution-candidate-service.js.map +1 -1
  165. package/dist/storage/resolution-change-transaction.d.ts +41 -3
  166. package/dist/storage/resolution-change-transaction.js +101 -12
  167. package/dist/storage/resolution-change-transaction.js.map +1 -1
  168. package/dist/storage/resolution-home.js +1 -1
  169. package/dist/storage/resolution-home.js.map +1 -1
  170. package/dist/storage/resolution-index-check.js +3 -2
  171. package/dist/storage/resolution-index-check.js.map +1 -1
  172. package/dist/storage/resolution-indexer.js +3 -1
  173. package/dist/storage/resolution-indexer.js.map +1 -1
  174. package/dist/storage/usage-store.d.ts +80 -0
  175. package/dist/storage/usage-store.js +239 -0
  176. package/dist/storage/usage-store.js.map +1 -0
  177. 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
- export async function prepareResolutionChange(unparsed, home) {
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 payloadHash = hashResolutionChangePayload(normalized);
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 = input.solution;
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 ? [input.problem] : []), proposed];
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' && sameSolution(parsed.document, input.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))