@red-codes/agentguard 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (294) hide show
  1. package/LICENSE +190 -0
  2. package/README.md +298 -0
  3. package/dist/adapters/claude-code.d.ts +24 -0
  4. package/dist/adapters/claude-code.d.ts.map +1 -0
  5. package/dist/adapters/claude-code.js +99 -0
  6. package/dist/adapters/claude-code.js.map +1 -0
  7. package/dist/adapters/file.d.ts +3 -0
  8. package/dist/adapters/file.d.ts.map +1 -0
  9. package/dist/adapters/file.js +35 -0
  10. package/dist/adapters/file.js.map +1 -0
  11. package/dist/adapters/git.d.ts +3 -0
  12. package/dist/adapters/git.d.ts.map +1 -0
  13. package/dist/adapters/git.js +61 -0
  14. package/dist/adapters/git.js.map +1 -0
  15. package/dist/adapters/registry.d.ts +5 -0
  16. package/dist/adapters/registry.d.ts.map +1 -0
  17. package/dist/adapters/registry.js +15 -0
  18. package/dist/adapters/registry.js.map +1 -0
  19. package/dist/adapters/shell.d.ts +8 -0
  20. package/dist/adapters/shell.d.ts.map +1 -0
  21. package/dist/adapters/shell.js +27 -0
  22. package/dist/adapters/shell.js.map +1 -0
  23. package/dist/cli/args.d.ts +25 -0
  24. package/dist/cli/args.d.ts.map +1 -0
  25. package/dist/cli/args.js +63 -0
  26. package/dist/cli/args.js.map +1 -0
  27. package/dist/cli/bin.d.ts +3 -0
  28. package/dist/cli/bin.d.ts.map +1 -0
  29. package/dist/cli/bin.js +5769 -0
  30. package/dist/cli/bin.js.map +7 -0
  31. package/dist/cli/colors.d.ts +11 -0
  32. package/dist/cli/colors.d.ts.map +1 -0
  33. package/dist/cli/colors.js +44 -0
  34. package/dist/cli/colors.js.map +1 -0
  35. package/dist/cli/commands/claude-hook.d.ts +2 -0
  36. package/dist/cli/commands/claude-hook.d.ts.map +1 -0
  37. package/dist/cli/commands/claude-hook.js +110 -0
  38. package/dist/cli/commands/claude-hook.js.map +1 -0
  39. package/dist/cli/commands/claude-init.d.ts +2 -0
  40. package/dist/cli/commands/claude-init.d.ts.map +1 -0
  41. package/dist/cli/commands/claude-init.js +150 -0
  42. package/dist/cli/commands/claude-init.js.map +1 -0
  43. package/dist/cli/commands/export.d.ts +11 -0
  44. package/dist/cli/commands/export.d.ts.map +1 -0
  45. package/dist/cli/commands/export.js +113 -0
  46. package/dist/cli/commands/export.js.map +1 -0
  47. package/dist/cli/commands/guard.d.ts +12 -0
  48. package/dist/cli/commands/guard.d.ts.map +1 -0
  49. package/dist/cli/commands/guard.js +145 -0
  50. package/dist/cli/commands/guard.js.map +1 -0
  51. package/dist/cli/commands/import.d.ts +2 -0
  52. package/dist/cli/commands/import.d.ts.map +1 -0
  53. package/dist/cli/commands/import.js +115 -0
  54. package/dist/cli/commands/import.js.map +1 -0
  55. package/dist/cli/commands/inspect.d.ts +3 -0
  56. package/dist/cli/commands/inspect.d.ts.map +1 -0
  57. package/dist/cli/commands/inspect.js +185 -0
  58. package/dist/cli/commands/inspect.js.map +1 -0
  59. package/dist/cli/commands/plugin.d.ts +7 -0
  60. package/dist/cli/commands/plugin.d.ts.map +1 -0
  61. package/dist/cli/commands/plugin.js +234 -0
  62. package/dist/cli/commands/plugin.js.map +1 -0
  63. package/dist/cli/commands/replay.d.ts +12 -0
  64. package/dist/cli/commands/replay.d.ts.map +1 -0
  65. package/dist/cli/commands/replay.js +208 -0
  66. package/dist/cli/commands/replay.js.map +1 -0
  67. package/dist/cli/file-event-store.d.ts +41 -0
  68. package/dist/cli/file-event-store.d.ts.map +1 -0
  69. package/dist/cli/file-event-store.js +219 -0
  70. package/dist/cli/file-event-store.js.map +1 -0
  71. package/dist/cli/policy-resolver.d.ts +4 -0
  72. package/dist/cli/policy-resolver.d.ts.map +1 -0
  73. package/dist/cli/policy-resolver.js +62 -0
  74. package/dist/cli/policy-resolver.js.map +1 -0
  75. package/dist/cli/recorder.d.ts +36 -0
  76. package/dist/cli/recorder.d.ts.map +1 -0
  77. package/dist/cli/recorder.js +85 -0
  78. package/dist/cli/recorder.js.map +1 -0
  79. package/dist/cli/replay.d.ts +2 -0
  80. package/dist/cli/replay.d.ts.map +1 -0
  81. package/dist/cli/replay.js +310 -0
  82. package/dist/cli/replay.js.map +1 -0
  83. package/dist/cli/session-store.d.ts +41 -0
  84. package/dist/cli/session-store.d.ts.map +1 -0
  85. package/dist/cli/session-store.js +95 -0
  86. package/dist/cli/session-store.js.map +1 -0
  87. package/dist/cli/tui.d.ts +24 -0
  88. package/dist/cli/tui.d.ts.map +1 -0
  89. package/dist/cli/tui.js +197 -0
  90. package/dist/cli/tui.js.map +1 -0
  91. package/dist/core/actions.d.ts +11 -0
  92. package/dist/core/actions.d.ts.map +1 -0
  93. package/dist/core/actions.js +112 -0
  94. package/dist/core/actions.js.map +1 -0
  95. package/dist/core/adapters.d.ts +19 -0
  96. package/dist/core/adapters.d.ts.map +1 -0
  97. package/dist/core/adapters.js +85 -0
  98. package/dist/core/adapters.js.map +1 -0
  99. package/dist/core/execution-log/bridge.d.ts +12 -0
  100. package/dist/core/execution-log/bridge.d.ts.map +1 -0
  101. package/dist/core/execution-log/bridge.js +112 -0
  102. package/dist/core/execution-log/bridge.js.map +1 -0
  103. package/dist/core/execution-log/event-log.d.ts +7 -0
  104. package/dist/core/execution-log/event-log.d.ts.map +1 -0
  105. package/dist/core/execution-log/event-log.js +103 -0
  106. package/dist/core/execution-log/event-log.js.map +1 -0
  107. package/dist/core/execution-log/event-projections.d.ts +28 -0
  108. package/dist/core/execution-log/event-projections.d.ts.map +1 -0
  109. package/dist/core/execution-log/event-projections.js +272 -0
  110. package/dist/core/execution-log/event-projections.js.map +1 -0
  111. package/dist/core/execution-log/event-schema.d.ts +56 -0
  112. package/dist/core/execution-log/event-schema.d.ts.map +1 -0
  113. package/dist/core/execution-log/event-schema.js +160 -0
  114. package/dist/core/execution-log/event-schema.js.map +1 -0
  115. package/dist/core/execution-log/index.d.ts +7 -0
  116. package/dist/core/execution-log/index.d.ts.map +1 -0
  117. package/dist/core/execution-log/index.js +13 -0
  118. package/dist/core/execution-log/index.js.map +1 -0
  119. package/dist/core/hash.d.ts +5 -0
  120. package/dist/core/hash.d.ts.map +1 -0
  121. package/dist/core/hash.js +13 -0
  122. package/dist/core/hash.js.map +1 -0
  123. package/dist/core/rng.d.ts +29 -0
  124. package/dist/core/rng.d.ts.map +1 -0
  125. package/dist/core/rng.js +48 -0
  126. package/dist/core/rng.js.map +1 -0
  127. package/dist/core/types.d.ts +746 -0
  128. package/dist/core/types.d.ts.map +1 -0
  129. package/dist/core/types.js +8 -0
  130. package/dist/core/types.js.map +1 -0
  131. package/dist/events/bus.d.ts +24 -0
  132. package/dist/events/bus.d.ts.map +1 -0
  133. package/dist/events/bus.js +64 -0
  134. package/dist/events/bus.js.map +1 -0
  135. package/dist/events/decision-jsonl.d.ts +8 -0
  136. package/dist/events/decision-jsonl.d.ts.map +1 -0
  137. package/dist/events/decision-jsonl.js +44 -0
  138. package/dist/events/decision-jsonl.js.map +1 -0
  139. package/dist/events/jsonl.d.ts +8 -0
  140. package/dist/events/jsonl.d.ts.map +1 -0
  141. package/dist/events/jsonl.js +46 -0
  142. package/dist/events/jsonl.js.map +1 -0
  143. package/dist/events/schema.d.ts +59 -0
  144. package/dist/events/schema.d.ts.map +1 -0
  145. package/dist/events/schema.js +296 -0
  146. package/dist/events/schema.js.map +1 -0
  147. package/dist/events/store.d.ts +7 -0
  148. package/dist/events/store.d.ts.map +1 -0
  149. package/dist/events/store.js +64 -0
  150. package/dist/events/store.js.map +1 -0
  151. package/dist/invariants/checker.d.ts +15 -0
  152. package/dist/invariants/checker.d.ts.map +1 -0
  153. package/dist/invariants/checker.js +52 -0
  154. package/dist/invariants/checker.js.map +1 -0
  155. package/dist/invariants/definitions.d.ts +33 -0
  156. package/dist/invariants/definitions.d.ts.map +1 -0
  157. package/dist/invariants/definitions.js +168 -0
  158. package/dist/invariants/definitions.js.map +1 -0
  159. package/dist/kernel/aab.d.ts +26 -0
  160. package/dist/kernel/aab.d.ts.map +1 -0
  161. package/dist/kernel/aab.js +149 -0
  162. package/dist/kernel/aab.js.map +1 -0
  163. package/dist/kernel/blast-radius.d.ts +60 -0
  164. package/dist/kernel/blast-radius.d.ts.map +1 -0
  165. package/dist/kernel/blast-radius.js +146 -0
  166. package/dist/kernel/blast-radius.js.map +1 -0
  167. package/dist/kernel/decision.d.ts +40 -0
  168. package/dist/kernel/decision.d.ts.map +1 -0
  169. package/dist/kernel/decision.js +92 -0
  170. package/dist/kernel/decision.js.map +1 -0
  171. package/dist/kernel/decisions/factory.d.ts +12 -0
  172. package/dist/kernel/decisions/factory.d.ts.map +1 -0
  173. package/dist/kernel/decisions/factory.js +56 -0
  174. package/dist/kernel/decisions/factory.js.map +1 -0
  175. package/dist/kernel/decisions/types.d.ts +70 -0
  176. package/dist/kernel/decisions/types.d.ts.map +1 -0
  177. package/dist/kernel/decisions/types.js +5 -0
  178. package/dist/kernel/decisions/types.js.map +1 -0
  179. package/dist/kernel/evidence.d.ts +29 -0
  180. package/dist/kernel/evidence.d.ts.map +1 -0
  181. package/dist/kernel/evidence.js +61 -0
  182. package/dist/kernel/evidence.js.map +1 -0
  183. package/dist/kernel/kernel.d.ts +47 -0
  184. package/dist/kernel/kernel.d.ts.map +1 -0
  185. package/dist/kernel/kernel.js +377 -0
  186. package/dist/kernel/kernel.js.map +1 -0
  187. package/dist/kernel/monitor.d.ts +35 -0
  188. package/dist/kernel/monitor.d.ts.map +1 -0
  189. package/dist/kernel/monitor.js +144 -0
  190. package/dist/kernel/monitor.js.map +1 -0
  191. package/dist/kernel/replay-comparator.d.ts +72 -0
  192. package/dist/kernel/replay-comparator.d.ts.map +1 -0
  193. package/dist/kernel/replay-comparator.js +251 -0
  194. package/dist/kernel/replay-comparator.js.map +1 -0
  195. package/dist/kernel/replay-engine.d.ts +108 -0
  196. package/dist/kernel/replay-engine.d.ts.map +1 -0
  197. package/dist/kernel/replay-engine.js +241 -0
  198. package/dist/kernel/replay-engine.js.map +1 -0
  199. package/dist/kernel/replay-processor.d.ts +109 -0
  200. package/dist/kernel/replay-processor.d.ts.map +1 -0
  201. package/dist/kernel/replay-processor.js +118 -0
  202. package/dist/kernel/replay-processor.js.map +1 -0
  203. package/dist/kernel/simulation/filesystem-simulator.d.ts +3 -0
  204. package/dist/kernel/simulation/filesystem-simulator.d.ts.map +1 -0
  205. package/dist/kernel/simulation/filesystem-simulator.js +81 -0
  206. package/dist/kernel/simulation/filesystem-simulator.js.map +1 -0
  207. package/dist/kernel/simulation/git-simulator.d.ts +5 -0
  208. package/dist/kernel/simulation/git-simulator.d.ts.map +1 -0
  209. package/dist/kernel/simulation/git-simulator.js +115 -0
  210. package/dist/kernel/simulation/git-simulator.js.map +1 -0
  211. package/dist/kernel/simulation/package-simulator.d.ts +5 -0
  212. package/dist/kernel/simulation/package-simulator.d.ts.map +1 -0
  213. package/dist/kernel/simulation/package-simulator.js +164 -0
  214. package/dist/kernel/simulation/package-simulator.js.map +1 -0
  215. package/dist/kernel/simulation/registry.d.ts +3 -0
  216. package/dist/kernel/simulation/registry.d.ts.map +1 -0
  217. package/dist/kernel/simulation/registry.js +24 -0
  218. package/dist/kernel/simulation/registry.js.map +1 -0
  219. package/dist/kernel/simulation/types.d.ts +35 -0
  220. package/dist/kernel/simulation/types.d.ts.map +1 -0
  221. package/dist/kernel/simulation/types.js +4 -0
  222. package/dist/kernel/simulation/types.js.map +1 -0
  223. package/dist/plugins/discovery.d.ts +45 -0
  224. package/dist/plugins/discovery.d.ts.map +1 -0
  225. package/dist/plugins/discovery.js +89 -0
  226. package/dist/plugins/discovery.js.map +1 -0
  227. package/dist/plugins/index.d.ts +10 -0
  228. package/dist/plugins/index.d.ts.map +1 -0
  229. package/dist/plugins/index.js +7 -0
  230. package/dist/plugins/index.js.map +1 -0
  231. package/dist/plugins/registry.d.ts +52 -0
  232. package/dist/plugins/registry.d.ts.map +1 -0
  233. package/dist/plugins/registry.js +148 -0
  234. package/dist/plugins/registry.js.map +1 -0
  235. package/dist/plugins/sandbox.d.ts +87 -0
  236. package/dist/plugins/sandbox.d.ts.map +1 -0
  237. package/dist/plugins/sandbox.js +122 -0
  238. package/dist/plugins/sandbox.js.map +1 -0
  239. package/dist/plugins/types.d.ts +61 -0
  240. package/dist/plugins/types.d.ts.map +1 -0
  241. package/dist/plugins/types.js +16 -0
  242. package/dist/plugins/types.js.map +1 -0
  243. package/dist/plugins/validator.d.ts +36 -0
  244. package/dist/plugins/validator.d.ts.map +1 -0
  245. package/dist/plugins/validator.js +276 -0
  246. package/dist/plugins/validator.js.map +1 -0
  247. package/dist/policy/evaluator.d.ts +41 -0
  248. package/dist/policy/evaluator.d.ts.map +1 -0
  249. package/dist/policy/evaluator.js +111 -0
  250. package/dist/policy/evaluator.js.map +1 -0
  251. package/dist/policy/loader.d.ts +13 -0
  252. package/dist/policy/loader.d.ts.map +1 -0
  253. package/dist/policy/loader.js +118 -0
  254. package/dist/policy/loader.js.map +1 -0
  255. package/dist/policy/pack-loader.d.ts +40 -0
  256. package/dist/policy/pack-loader.d.ts.map +1 -0
  257. package/dist/policy/pack-loader.js +138 -0
  258. package/dist/policy/pack-loader.js.map +1 -0
  259. package/dist/policy/yaml-loader.d.ts +23 -0
  260. package/dist/policy/yaml-loader.d.ts.map +1 -0
  261. package/dist/policy/yaml-loader.js +222 -0
  262. package/dist/policy/yaml-loader.js.map +1 -0
  263. package/dist/renderers/index.d.ts +6 -0
  264. package/dist/renderers/index.d.ts.map +1 -0
  265. package/dist/renderers/index.js +4 -0
  266. package/dist/renderers/index.js.map +1 -0
  267. package/dist/renderers/registry.d.ts +39 -0
  268. package/dist/renderers/registry.d.ts.map +1 -0
  269. package/dist/renderers/registry.js +97 -0
  270. package/dist/renderers/registry.js.map +1 -0
  271. package/dist/renderers/tui-renderer.d.ts +18 -0
  272. package/dist/renderers/tui-renderer.d.ts.map +1 -0
  273. package/dist/renderers/tui-renderer.js +57 -0
  274. package/dist/renderers/tui-renderer.js.map +1 -0
  275. package/dist/renderers/types.d.ts +52 -0
  276. package/dist/renderers/types.d.ts.map +1 -0
  277. package/dist/renderers/types.js +4 -0
  278. package/dist/renderers/types.js.map +1 -0
  279. package/dist/telemetry/index.d.ts +3 -0
  280. package/dist/telemetry/index.d.ts.map +1 -0
  281. package/dist/telemetry/index.js +2 -0
  282. package/dist/telemetry/index.js.map +1 -0
  283. package/dist/telemetry/runtimeLogger.d.ts +9 -0
  284. package/dist/telemetry/runtimeLogger.d.ts.map +1 -0
  285. package/dist/telemetry/runtimeLogger.js +68 -0
  286. package/dist/telemetry/runtimeLogger.js.map +1 -0
  287. package/dist/telemetry/types.d.ts +22 -0
  288. package/dist/telemetry/types.d.ts.map +1 -0
  289. package/dist/telemetry/types.js +4 -0
  290. package/dist/telemetry/types.js.map +1 -0
  291. package/hooks/post-commit +57 -0
  292. package/hooks/post-merge +33 -0
  293. package/hooks/pre-commit +28 -0
  294. package/package.json +72 -0
@@ -0,0 +1,219 @@
1
+ // File-based event store — persists domain events to ~/.agentguard/events/
2
+ // Implements the EventStore interface from src/domain/event-store.ts
3
+ // Each session gets its own JSONL file for efficient append-only writes.
4
+ import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, appendFileSync, } from 'node:fs';
5
+ import { join } from 'node:path';
6
+ import { homedir } from 'node:os';
7
+ import { validateEvent } from '../events/schema.js';
8
+ const EVENTS_DIR = join(homedir(), '.agentguard', 'events');
9
+ function ensureDir() {
10
+ if (!existsSync(EVENTS_DIR)) {
11
+ mkdirSync(EVENTS_DIR, { recursive: true });
12
+ }
13
+ }
14
+ function sessionFileName(sessionId) {
15
+ return join(EVENTS_DIR, `${sessionId}.jsonl`);
16
+ }
17
+ /**
18
+ * Create a file-based event store.
19
+ * Events are persisted as newline-delimited JSON (JSONL) files.
20
+ * Each session gets its own file for efficient append operations.
21
+ */
22
+ export function createFileEventStore(sessionId) {
23
+ const sid = sessionId || `session_${Date.now()}`;
24
+ ensureDir();
25
+ return {
26
+ sessionId: sid,
27
+ append(event) {
28
+ const { valid, errors } = validateEvent(event);
29
+ if (!valid) {
30
+ throw new Error(`Cannot append invalid event: ${errors.join('; ')}`);
31
+ }
32
+ ensureDir();
33
+ appendFileSync(sessionFileName(sid), JSON.stringify(event) + '\n', 'utf8');
34
+ },
35
+ query(filter = {}) {
36
+ const allEvents = loadAllEvents();
37
+ let result = allEvents;
38
+ if (filter.kind) {
39
+ result = result.filter((e) => e.kind === filter.kind);
40
+ }
41
+ if (filter.since !== undefined) {
42
+ result = result.filter((e) => e.timestamp >= filter.since);
43
+ }
44
+ if (filter.until !== undefined) {
45
+ result = result.filter((e) => e.timestamp <= filter.until);
46
+ }
47
+ if (filter.fingerprint) {
48
+ result = result.filter((e) => e.fingerprint === filter.fingerprint);
49
+ }
50
+ return result;
51
+ },
52
+ replay(fromId) {
53
+ const allEvents = loadAllEvents();
54
+ if (!fromId)
55
+ return allEvents;
56
+ const idx = allEvents.findIndex((e) => e.id === fromId);
57
+ if (idx === -1)
58
+ return [];
59
+ return allEvents.slice(idx);
60
+ },
61
+ count() {
62
+ return loadAllEvents().length;
63
+ },
64
+ clear() {
65
+ const filePath = sessionFileName(sid);
66
+ if (existsSync(filePath)) {
67
+ writeFileSync(filePath, '', 'utf8');
68
+ }
69
+ },
70
+ toNDJSON() {
71
+ const allEvents = loadAllEvents();
72
+ return allEvents.map((e) => JSON.stringify(e)).join('\n');
73
+ },
74
+ fromNDJSON(ndjson) {
75
+ const lines = ndjson.split('\n').filter((line) => line.trim().length > 0);
76
+ let loaded = 0;
77
+ ensureDir();
78
+ for (const line of lines) {
79
+ const parsed = JSON.parse(line);
80
+ appendFileSync(sessionFileName(sid), JSON.stringify(parsed) + '\n', 'utf8');
81
+ loaded++;
82
+ }
83
+ return loaded;
84
+ },
85
+ };
86
+ }
87
+ /**
88
+ * Load all events from all session files, sorted by timestamp.
89
+ */
90
+ function loadAllEvents() {
91
+ ensureDir();
92
+ const events = [];
93
+ const files = readdirSync(EVENTS_DIR).filter((f) => f.endsWith('.jsonl'));
94
+ for (const file of files) {
95
+ const filePath = join(EVENTS_DIR, file);
96
+ try {
97
+ const content = readFileSync(filePath, 'utf8');
98
+ for (const line of content.split('\n')) {
99
+ if (!line.trim())
100
+ continue;
101
+ try {
102
+ events.push(JSON.parse(line));
103
+ }
104
+ catch {
105
+ // Skip malformed lines
106
+ }
107
+ }
108
+ }
109
+ catch {
110
+ // Skip unreadable files
111
+ }
112
+ }
113
+ events.sort((a, b) => a.timestamp - b.timestamp);
114
+ return events;
115
+ }
116
+ /**
117
+ * List all session IDs that have stored events.
118
+ */
119
+ export function listSessions() {
120
+ ensureDir();
121
+ return readdirSync(EVENTS_DIR)
122
+ .filter((f) => f.endsWith('.jsonl'))
123
+ .map((f) => f.replace('.jsonl', ''));
124
+ }
125
+ /**
126
+ * Load events from a specific session.
127
+ */
128
+ export function loadSession(sessionId) {
129
+ const filePath = sessionFileName(sessionId);
130
+ if (!existsSync(filePath))
131
+ return [];
132
+ const events = [];
133
+ const content = readFileSync(filePath, 'utf8');
134
+ for (const line of content.split('\n')) {
135
+ if (!line.trim())
136
+ continue;
137
+ try {
138
+ events.push(JSON.parse(line));
139
+ }
140
+ catch {
141
+ // Skip malformed lines
142
+ }
143
+ }
144
+ return events;
145
+ }
146
+ /**
147
+ * Export a session to a portable JSONL file for sharing.
148
+ * The first line is a metadata header; subsequent lines are domain events.
149
+ * Returns the number of events exported.
150
+ */
151
+ export function exportSession(sessionId, outputPath) {
152
+ const events = loadSession(sessionId);
153
+ if (events.length === 0) {
154
+ throw new Error(`Session "${sessionId}" has no events to export`);
155
+ }
156
+ const header = {
157
+ __agentguard_export: true,
158
+ version: 1,
159
+ sessionId,
160
+ exportedAt: Date.now(),
161
+ eventCount: events.length,
162
+ };
163
+ const lines = [JSON.stringify(header), ...events.map((e) => JSON.stringify(e))];
164
+ writeFileSync(outputPath, lines.join('\n') + '\n', 'utf8');
165
+ return events.length;
166
+ }
167
+ /**
168
+ * Import a session from a portable JSONL file.
169
+ * Validates the export header and each event before writing.
170
+ * Returns the sessionId and number of events imported.
171
+ */
172
+ export function importSession(inputPath, targetSessionId) {
173
+ if (!existsSync(inputPath)) {
174
+ throw new Error(`Import file not found: ${inputPath}`);
175
+ }
176
+ const content = readFileSync(inputPath, 'utf8');
177
+ const lines = content.split('\n').filter((l) => l.trim());
178
+ if (lines.length === 0) {
179
+ throw new Error('Import file is empty');
180
+ }
181
+ // Parse and validate the metadata header
182
+ let header;
183
+ try {
184
+ header = JSON.parse(lines[0]);
185
+ }
186
+ catch {
187
+ throw new Error('Import file has an invalid header line');
188
+ }
189
+ if (header.__agentguard_export !== true || header.version !== 1) {
190
+ throw new Error('Import file is not a valid AgentGuard export (missing or invalid header)');
191
+ }
192
+ const sessionId = targetSessionId || header.sessionId;
193
+ if (!sessionId) {
194
+ throw new Error('No sessionId found in export header and none provided');
195
+ }
196
+ // Parse and validate events from remaining lines
197
+ const events = [];
198
+ for (let i = 1; i < lines.length; i++) {
199
+ try {
200
+ const parsed = JSON.parse(lines[i]);
201
+ const { valid } = validateEvent(parsed);
202
+ if (valid) {
203
+ events.push(parsed);
204
+ }
205
+ }
206
+ catch {
207
+ // Skip malformed lines
208
+ }
209
+ }
210
+ if (events.length === 0) {
211
+ throw new Error('Import file contains no valid events');
212
+ }
213
+ // Write events to the target session file
214
+ ensureDir();
215
+ const eventLines = events.map((e) => JSON.stringify(e)).join('\n') + '\n';
216
+ appendFileSync(sessionFileName(sessionId), eventLines, 'utf8');
217
+ return { sessionId, eventCount: events.length };
218
+ }
219
+ //# sourceMappingURL=file-event-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file-event-store.js","sourceRoot":"","sources":["../../src/cli/file-event-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export declare function findDefaultPolicy(): string | null;
2
+ export declare function loadPolicyFile(policyPath: string): unknown[];
3
+ export declare function loadPolicyDefs(policyPath?: string): unknown[];
4
+ //# sourceMappingURL=policy-resolver.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"policy-resolver.d.ts","sourceRoot":"","sources":["../../src/cli/policy-resolver.ts"],"names":[],"mappings":"AAeA,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAKjD;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,EAAE,CA2C5D;AAED,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAG7D"}
@@ -0,0 +1,62 @@
1
+ // Shared policy discovery and loading — used by guard and claude-hook commands.
2
+ import { readFileSync, existsSync } from 'node:fs';
3
+ import { resolve, dirname } from 'node:path';
4
+ import { loadYamlPolicy, parseYamlPolicy } from '../policy/yaml-loader.js';
5
+ import { resolveExtends, mergePolicies } from '../policy/pack-loader.js';
6
+ const DEFAULT_POLICY_CANDIDATES = [
7
+ 'agentguard.yaml',
8
+ 'agentguard.yml',
9
+ 'agentguard.json',
10
+ '.agentguard.yaml',
11
+ '.agentguard.yml',
12
+ ];
13
+ export function findDefaultPolicy() {
14
+ for (const name of DEFAULT_POLICY_CANDIDATES) {
15
+ if (existsSync(name))
16
+ return name;
17
+ }
18
+ return null;
19
+ }
20
+ export function loadPolicyFile(policyPath) {
21
+ const absPath = resolve(policyPath);
22
+ if (!existsSync(absPath)) {
23
+ process.stderr.write(` \x1b[31mError:\x1b[0m Policy file not found: ${absPath}\n`);
24
+ process.exit(1);
25
+ }
26
+ const content = readFileSync(absPath, 'utf8');
27
+ if (absPath.endsWith('.yaml') || absPath.endsWith('.yml')) {
28
+ const localPolicy = loadYamlPolicy(content, policyPath);
29
+ // Check for extends (policy packs)
30
+ const def = parseYamlPolicy(content);
31
+ if (def.extends && def.extends.length > 0) {
32
+ const baseDir = dirname(absPath);
33
+ const { policies: packPolicies, errors } = resolveExtends(def.extends, baseDir);
34
+ for (const err of errors) {
35
+ process.stderr.write(` \x1b[33mWarning:\x1b[0m ${err}\n`);
36
+ }
37
+ const merged = mergePolicies(localPolicy, packPolicies);
38
+ return merged.map((p) => ({ id: p.id, name: p.name, rules: p.rules, severity: p.severity }));
39
+ }
40
+ return [
41
+ {
42
+ id: localPolicy.id,
43
+ name: localPolicy.name,
44
+ rules: localPolicy.rules,
45
+ severity: localPolicy.severity,
46
+ },
47
+ ];
48
+ }
49
+ try {
50
+ const parsed = JSON.parse(content);
51
+ return Array.isArray(parsed) ? parsed : [parsed];
52
+ }
53
+ catch {
54
+ process.stderr.write(` \x1b[31mError:\x1b[0m Failed to parse policy file: ${absPath}\n`);
55
+ process.exit(1);
56
+ }
57
+ }
58
+ export function loadPolicyDefs(policyPath) {
59
+ const resolved = policyPath || findDefaultPolicy();
60
+ return resolved ? loadPolicyFile(resolved) : [];
61
+ }
62
+ //# sourceMappingURL=policy-resolver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"policy-resolver.js","sourceRoot":"","sources":["../../src/cli/policy-resolver.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ import type { DomainEvent } from '../core/types.js';
2
+ interface ErrorLike {
3
+ message: string;
4
+ type?: string;
5
+ severity?: number;
6
+ }
7
+ interface LocationLike {
8
+ file?: string;
9
+ line?: number;
10
+ }
11
+ interface MonsterLike {
12
+ id: number;
13
+ name: string;
14
+ type: string;
15
+ hp: number;
16
+ }
17
+ interface BossLike {
18
+ id: string;
19
+ name: string;
20
+ type: string;
21
+ }
22
+ export interface Recorder {
23
+ readonly sessionId: string;
24
+ record(event: DomainEvent): void;
25
+ recordError(error: ErrorLike, location?: LocationLike | null): void;
26
+ recordEncounter(monster: MonsterLike, error: ErrorLike): void;
27
+ recordBattle(result: string, details?: Record<string, unknown>): void;
28
+ recordBoss(boss: BossLike): void;
29
+ recordTest(result: string, details?: Record<string, unknown>): void;
30
+ recordFileModified(file: string): void;
31
+ recordResolution(monsterName: string): void;
32
+ end(exitCode?: number): void;
33
+ }
34
+ export declare function createRecorder(command: string, args?: string[]): Recorder;
35
+ export {};
36
+ //# sourceMappingURL=recorder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/cli/recorder.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,UAAU,SAAS;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC;IACpE,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9D,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtE,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpE,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,QAAQ,CAyF7E"}
@@ -0,0 +1,85 @@
1
+ // Session recorder — captures canonical events during a watch session.
2
+ // Wraps the session store and provides high-level recording methods.
3
+ import { createSession } from './session-store.js';
4
+ import { createEvent, ERROR_OBSERVED, ENCOUNTER_STARTED, BATTLE_ENDED, TEST_COMPLETED, FILE_SAVED, } from '../events/schema.js';
5
+ export function createRecorder(command, args = []) {
6
+ const fullCommand = [command, ...args].join(' ');
7
+ const session = createSession({ command: fullCommand });
8
+ const startTime = Date.now();
9
+ let bugsDefeated = 0;
10
+ let bossesEncountered = 0;
11
+ let errorsObserved = 0;
12
+ return {
13
+ get sessionId() {
14
+ return session.id;
15
+ },
16
+ record(event) {
17
+ session.append(event);
18
+ },
19
+ recordError(error, location) {
20
+ errorsObserved++;
21
+ const event = createEvent(ERROR_OBSERVED, {
22
+ message: error.message,
23
+ errorType: error.type,
24
+ file: location?.file || null,
25
+ line: location?.line || null,
26
+ severity: error.severity || 3,
27
+ });
28
+ session.append(event);
29
+ },
30
+ recordEncounter(monster, error) {
31
+ const event = createEvent(ENCOUNTER_STARTED, {
32
+ enemy: monster.name,
33
+ playerLevel: null,
34
+ });
35
+ event.monster = {
36
+ id: monster.id,
37
+ name: monster.name,
38
+ type: monster.type,
39
+ hp: monster.hp,
40
+ };
41
+ event.errorMessage = error.message;
42
+ session.append(event);
43
+ },
44
+ recordBattle(result, details = {}) {
45
+ if (result === 'victory')
46
+ bugsDefeated++;
47
+ const event = createEvent(BATTLE_ENDED, { result, ...details });
48
+ session.append(event);
49
+ },
50
+ recordBoss(boss) {
51
+ bossesEncountered++;
52
+ const event = createEvent(ENCOUNTER_STARTED, {
53
+ enemy: boss.name,
54
+ playerLevel: null,
55
+ });
56
+ event.isBoss = true;
57
+ event.boss = { id: boss.id, name: boss.name, type: boss.type };
58
+ session.append(event);
59
+ },
60
+ recordTest(result, details = {}) {
61
+ const event = createEvent(TEST_COMPLETED, { result, ...details });
62
+ session.append(event);
63
+ },
64
+ recordFileModified(file) {
65
+ const event = createEvent(FILE_SAVED, { file });
66
+ session.append(event);
67
+ },
68
+ recordResolution(monsterName) {
69
+ bugsDefeated++;
70
+ const event = createEvent(BATTLE_ENDED, { result: 'resolved' });
71
+ event.monsterName = monsterName;
72
+ session.append(event);
73
+ },
74
+ end(exitCode) {
75
+ session.end({
76
+ bugsDefeated,
77
+ bossesEncountered,
78
+ errorsObserved,
79
+ exitCode: exitCode ?? null,
80
+ duration: Date.now() - startTime,
81
+ });
82
+ },
83
+ };
84
+ }
85
+ //# sourceMappingURL=recorder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../src/cli/recorder.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export declare function replay(args: string[]): Promise<void>;
2
+ //# sourceMappingURL=replay.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/cli/replay.ts"],"names":[],"mappings":"AAsEA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmD1D"}