dravix-agent 0.1.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 (208) hide show
  1. package/.claude/settings.example.json +30 -0
  2. package/ARCHITECTURE.md +410 -0
  3. package/LICENSE +21 -0
  4. package/README.md +153 -0
  5. package/ROADMAP.md +117 -0
  6. package/data/vulnkb.json +666 -0
  7. package/dist/bin/aegis.d.ts +3 -0
  8. package/dist/bin/aegis.d.ts.map +1 -0
  9. package/dist/bin/aegis.js +489 -0
  10. package/dist/bin/aegis.js.map +1 -0
  11. package/dist/cache.d.ts +9 -0
  12. package/dist/cache.d.ts.map +1 -0
  13. package/dist/cache.js +146 -0
  14. package/dist/cache.js.map +1 -0
  15. package/dist/engines/ai-sinks.d.ts +52 -0
  16. package/dist/engines/ai-sinks.d.ts.map +1 -0
  17. package/dist/engines/ai-sinks.js +204 -0
  18. package/dist/engines/ai-sinks.js.map +1 -0
  19. package/dist/engines/eslint.d.ts +9 -0
  20. package/dist/engines/eslint.d.ts.map +1 -0
  21. package/dist/engines/eslint.js +245 -0
  22. package/dist/engines/eslint.js.map +1 -0
  23. package/dist/engines/joern.d.ts +3 -0
  24. package/dist/engines/joern.d.ts.map +1 -0
  25. package/dist/engines/joern.js +98 -0
  26. package/dist/engines/joern.js.map +1 -0
  27. package/dist/engines/js-sinks.d.ts +70 -0
  28. package/dist/engines/js-sinks.d.ts.map +1 -0
  29. package/dist/engines/js-sinks.js +370 -0
  30. package/dist/engines/js-sinks.js.map +1 -0
  31. package/dist/engines/llm-critic.d.ts +130 -0
  32. package/dist/engines/llm-critic.d.ts.map +1 -0
  33. package/dist/engines/llm-critic.js +551 -0
  34. package/dist/engines/llm-critic.js.map +1 -0
  35. package/dist/engines/pragma.d.ts +20 -0
  36. package/dist/engines/pragma.d.ts.map +1 -0
  37. package/dist/engines/pragma.js +83 -0
  38. package/dist/engines/pragma.js.map +1 -0
  39. package/dist/engines/property-test.d.ts +3 -0
  40. package/dist/engines/property-test.d.ts.map +1 -0
  41. package/dist/engines/property-test.js +134 -0
  42. package/dist/engines/property-test.js.map +1 -0
  43. package/dist/engines/pyright.d.ts +10 -0
  44. package/dist/engines/pyright.d.ts.map +1 -0
  45. package/dist/engines/pyright.js +143 -0
  46. package/dist/engines/pyright.js.map +1 -0
  47. package/dist/engines/pysa.d.ts +3 -0
  48. package/dist/engines/pysa.d.ts.map +1 -0
  49. package/dist/engines/pysa.js +83 -0
  50. package/dist/engines/pysa.js.map +1 -0
  51. package/dist/engines/python-sinks.d.ts +82 -0
  52. package/dist/engines/python-sinks.d.ts.map +1 -0
  53. package/dist/engines/python-sinks.js +459 -0
  54. package/dist/engines/python-sinks.js.map +1 -0
  55. package/dist/engines/registry.d.ts +26 -0
  56. package/dist/engines/registry.d.ts.map +1 -0
  57. package/dist/engines/registry.js +70 -0
  58. package/dist/engines/registry.js.map +1 -0
  59. package/dist/engines/secret-scan.d.ts +22 -0
  60. package/dist/engines/secret-scan.d.ts.map +1 -0
  61. package/dist/engines/secret-scan.js +179 -0
  62. package/dist/engines/secret-scan.js.map +1 -0
  63. package/dist/engines/semgrep.d.ts +10 -0
  64. package/dist/engines/semgrep.d.ts.map +1 -0
  65. package/dist/engines/semgrep.js +200 -0
  66. package/dist/engines/semgrep.js.map +1 -0
  67. package/dist/engines/treesitter.d.ts +18 -0
  68. package/dist/engines/treesitter.d.ts.map +1 -0
  69. package/dist/engines/treesitter.js +135 -0
  70. package/dist/engines/treesitter.js.map +1 -0
  71. package/dist/engines/tsc.d.ts +10 -0
  72. package/dist/engines/tsc.d.ts.map +1 -0
  73. package/dist/engines/tsc.js +142 -0
  74. package/dist/engines/tsc.js.map +1 -0
  75. package/dist/engines/types.d.ts +47 -0
  76. package/dist/engines/types.d.ts.map +1 -0
  77. package/dist/engines/types.js +27 -0
  78. package/dist/engines/types.js.map +1 -0
  79. package/dist/findings.d.ts +121 -0
  80. package/dist/findings.d.ts.map +1 -0
  81. package/dist/findings.js +98 -0
  82. package/dist/findings.js.map +1 -0
  83. package/dist/hooks/claude-code.d.ts +3 -0
  84. package/dist/hooks/claude-code.d.ts.map +1 -0
  85. package/dist/hooks/claude-code.js +187 -0
  86. package/dist/hooks/claude-code.js.map +1 -0
  87. package/dist/index/context.d.ts +127 -0
  88. package/dist/index/context.d.ts.map +1 -0
  89. package/dist/index/context.js +267 -0
  90. package/dist/index/context.js.map +1 -0
  91. package/dist/index/embeddings.d.ts +68 -0
  92. package/dist/index/embeddings.d.ts.map +1 -0
  93. package/dist/index/embeddings.js +570 -0
  94. package/dist/index/embeddings.js.map +1 -0
  95. package/dist/index/graph_routing.d.ts +36 -0
  96. package/dist/index/graph_routing.d.ts.map +1 -0
  97. package/dist/index/graph_routing.js +170 -0
  98. package/dist/index/graph_routing.js.map +1 -0
  99. package/dist/index/joern.d.ts +76 -0
  100. package/dist/index/joern.d.ts.map +1 -0
  101. package/dist/index/joern.js +782 -0
  102. package/dist/index/joern.js.map +1 -0
  103. package/dist/index/property-test.d.ts +88 -0
  104. package/dist/index/property-test.d.ts.map +1 -0
  105. package/dist/index/property-test.js +466 -0
  106. package/dist/index/property-test.js.map +1 -0
  107. package/dist/index/proto/scip.proto +897 -0
  108. package/dist/index/pysa.d.ts +91 -0
  109. package/dist/index/pysa.d.ts.map +1 -0
  110. package/dist/index/pysa.js +617 -0
  111. package/dist/index/pysa.js.map +1 -0
  112. package/dist/index/scip.d.ts +76 -0
  113. package/dist/index/scip.d.ts.map +1 -0
  114. package/dist/index/scip.js +541 -0
  115. package/dist/index/scip.js.map +1 -0
  116. package/dist/index/vulrag.d.ts +86 -0
  117. package/dist/index/vulrag.d.ts.map +1 -0
  118. package/dist/index/vulrag.js +242 -0
  119. package/dist/index/vulrag.js.map +1 -0
  120. package/dist/index.d.ts +9 -0
  121. package/dist/index.d.ts.map +1 -0
  122. package/dist/index.js +8 -0
  123. package/dist/index.js.map +1 -0
  124. package/dist/install/claude-code.d.ts +31 -0
  125. package/dist/install/claude-code.d.ts.map +1 -0
  126. package/dist/install/claude-code.js +447 -0
  127. package/dist/install/claude-code.js.map +1 -0
  128. package/dist/lang.d.ts +5 -0
  129. package/dist/lang.d.ts.map +1 -0
  130. package/dist/lang.js +52 -0
  131. package/dist/lang.js.map +1 -0
  132. package/dist/learning/suppressions.d.ts +70 -0
  133. package/dist/learning/suppressions.d.ts.map +1 -0
  134. package/dist/learning/suppressions.js +179 -0
  135. package/dist/learning/suppressions.js.map +1 -0
  136. package/dist/mcp/server.d.ts +2 -0
  137. package/dist/mcp/server.d.ts.map +1 -0
  138. package/dist/mcp/server.js +187 -0
  139. package/dist/mcp/server.js.map +1 -0
  140. package/dist/mcp/tools/explain.d.ts +58 -0
  141. package/dist/mcp/tools/explain.d.ts.map +1 -0
  142. package/dist/mcp/tools/explain.js +60 -0
  143. package/dist/mcp/tools/explain.js.map +1 -0
  144. package/dist/mcp/tools/precheck.d.ts +29 -0
  145. package/dist/mcp/tools/precheck.d.ts.map +1 -0
  146. package/dist/mcp/tools/precheck.js +42 -0
  147. package/dist/mcp/tools/precheck.js.map +1 -0
  148. package/dist/mcp/tools/validate.d.ts +73 -0
  149. package/dist/mcp/tools/validate.d.ts.map +1 -0
  150. package/dist/mcp/tools/validate.js +66 -0
  151. package/dist/mcp/tools/validate.js.map +1 -0
  152. package/dist/mcp/warm.d.ts +88 -0
  153. package/dist/mcp/warm.d.ts.map +1 -0
  154. package/dist/mcp/warm.js +331 -0
  155. package/dist/mcp/warm.js.map +1 -0
  156. package/dist/orchestrator.d.ts +46 -0
  157. package/dist/orchestrator.d.ts.map +1 -0
  158. package/dist/orchestrator.js +596 -0
  159. package/dist/orchestrator.js.map +1 -0
  160. package/dist/policy.d.ts +51 -0
  161. package/dist/policy.d.ts.map +1 -0
  162. package/dist/policy.js +201 -0
  163. package/dist/policy.js.map +1 -0
  164. package/dist/risk.d.ts +31 -0
  165. package/dist/risk.d.ts.map +1 -0
  166. package/dist/risk.js +92 -0
  167. package/dist/risk.js.map +1 -0
  168. package/dist/stats.d.ts +72 -0
  169. package/dist/stats.d.ts.map +1 -0
  170. package/dist/stats.js +217 -0
  171. package/dist/stats.js.map +1 -0
  172. package/dist/telemetry/collector.d.ts +10 -0
  173. package/dist/telemetry/collector.d.ts.map +1 -0
  174. package/dist/telemetry/collector.js +75 -0
  175. package/dist/telemetry/collector.js.map +1 -0
  176. package/dist/telemetry/consent.d.ts +9 -0
  177. package/dist/telemetry/consent.d.ts.map +1 -0
  178. package/dist/telemetry/consent.js +42 -0
  179. package/dist/telemetry/consent.js.map +1 -0
  180. package/dist/telemetry/installation.d.ts +2 -0
  181. package/dist/telemetry/installation.d.ts.map +1 -0
  182. package/dist/telemetry/installation.js +32 -0
  183. package/dist/telemetry/installation.js.map +1 -0
  184. package/dist/telemetry/sanitizer.d.ts +5 -0
  185. package/dist/telemetry/sanitizer.d.ts.map +1 -0
  186. package/dist/telemetry/sanitizer.js +60 -0
  187. package/dist/telemetry/sanitizer.js.map +1 -0
  188. package/dist/telemetry/types.d.ts +39 -0
  189. package/dist/telemetry/types.d.ts.map +1 -0
  190. package/dist/telemetry/types.js +4 -0
  191. package/dist/telemetry/types.js.map +1 -0
  192. package/dist/telemetry/uploader.d.ts +12 -0
  193. package/dist/telemetry/uploader.d.ts.map +1 -0
  194. package/dist/telemetry/uploader.js +92 -0
  195. package/dist/telemetry/uploader.js.map +1 -0
  196. package/dist/util/logger.d.ts +19 -0
  197. package/dist/util/logger.d.ts.map +1 -0
  198. package/dist/util/logger.js +58 -0
  199. package/dist/util/logger.js.map +1 -0
  200. package/dist/util/safe-paths.d.ts +8 -0
  201. package/dist/util/safe-paths.d.ts.map +1 -0
  202. package/dist/util/safe-paths.js +102 -0
  203. package/dist/util/safe-paths.js.map +1 -0
  204. package/dist/util/subprocess.d.ts +32 -0
  205. package/dist/util/subprocess.d.ts.map +1 -0
  206. package/dist/util/subprocess.js +137 -0
  207. package/dist/util/subprocess.js.map +1 -0
  208. package/package.json +93 -0
@@ -0,0 +1,92 @@
1
+ // HTTPS uploader with retry + exponential backoff.
2
+ import { platform, arch } from "node:os";
3
+ import { isTelemetryEnabled } from "./consent.js";
4
+ import { getInstallationId } from "./installation.js";
5
+ import { SCHEMA_VERSION } from "./types.js";
6
+ const API_BASE = process.env.AEGIS_TELEMETRY_ENDPOINT ?? "https://aegis-api.fixme-now.com";
7
+ const CLIENT_VERSION = process.env.AEGIS_CLIENT_VERSION ?? "0.2.0";
8
+ const MAX_RETRIES = 3;
9
+ export async function uploadBatch(findings, feedback, durations) {
10
+ if (!isTelemetryEnabled())
11
+ return { ok: false, reason: "disabled" };
12
+ if (findings.length === 0 && feedback.length === 0)
13
+ return { ok: true };
14
+ const body = {
15
+ schema_version: SCHEMA_VERSION,
16
+ installation_id: getInstallationId(),
17
+ client_version: CLIENT_VERSION,
18
+ platform: `${platform()}-${arch()}`,
19
+ sent_at: Date.now(),
20
+ findings,
21
+ ...(feedback.length > 0 ? { feedback } : {}),
22
+ stats: {
23
+ durations_ms: durations,
24
+ lang_counts: _count(findings, (f) => f.lang),
25
+ engine_counts: _count(findings, (f) => f.engine),
26
+ verdict_counts: _count(findings, (f) => f.verdict),
27
+ },
28
+ };
29
+ const json = JSON.stringify(body);
30
+ let attempt = 0;
31
+ let lastErr = "";
32
+ while (attempt < MAX_RETRIES) {
33
+ try {
34
+ const res = await fetch(`${API_BASE}/v1/findings`, {
35
+ method: "POST",
36
+ headers: { "content-type": "application/json" },
37
+ body: json,
38
+ });
39
+ if (res.ok)
40
+ return { ok: true };
41
+ if (res.status === 429) {
42
+ const retry_after = Number(res.headers.get("retry-after") ?? "60");
43
+ await _sleep(retry_after * 1000);
44
+ }
45
+ else if (res.status >= 500) {
46
+ await _sleep(2 ** attempt * 1000);
47
+ }
48
+ else {
49
+ lastErr = `http ${res.status}`;
50
+ break;
51
+ }
52
+ }
53
+ catch (err) {
54
+ lastErr = err instanceof Error ? err.message : String(err);
55
+ await _sleep(2 ** attempt * 1000);
56
+ }
57
+ attempt++;
58
+ }
59
+ return { ok: false, reason: lastErr || "max_retries" };
60
+ }
61
+ function _count(xs, key) {
62
+ const r = {};
63
+ for (const x of xs)
64
+ r[key(x)] = (r[key(x)] ?? 0) + 1;
65
+ return r;
66
+ }
67
+ function _sleep(ms) {
68
+ return new Promise((r) => setTimeout(r, ms));
69
+ }
70
+ export async function postOptOut(reason) {
71
+ try {
72
+ const res = await fetch(`${API_BASE}/v1/optout`, {
73
+ method: "POST",
74
+ headers: { "content-type": "application/json" },
75
+ body: JSON.stringify({ installation_id: getInstallationId(), reason }),
76
+ });
77
+ return { ok: res.ok };
78
+ }
79
+ catch {
80
+ return { ok: false };
81
+ }
82
+ }
83
+ export async function deleteAllData() {
84
+ try {
85
+ const res = await fetch(`${API_BASE}/v1/installations/${getInstallationId()}`, { method: "DELETE" });
86
+ return { ok: res.ok };
87
+ }
88
+ catch {
89
+ return { ok: false };
90
+ }
91
+ }
92
+ //# sourceMappingURL=uploader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"uploader.js","sourceRoot":"","sources":["../../src/telemetry/uploader.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Minimal structured logger.
3
+ *
4
+ * Writes JSON lines to stderr (so it does NOT interfere with MCP stdio on stdout).
5
+ * Level via `AEGIS_LOG_LEVEL` (debug|info|warn|error), default info.
6
+ */
7
+ export type LogLevel = "debug" | "info" | "warn" | "error";
8
+ export declare class Logger {
9
+ private readonly name;
10
+ constructor(name: string);
11
+ child(suffix: string): Logger;
12
+ private emit;
13
+ debug(msg: string, fields?: Record<string, unknown>): void;
14
+ info(msg: string, fields?: Record<string, unknown>): void;
15
+ warn(msg: string, fields?: Record<string, unknown>): void;
16
+ error(msg: string, fields?: Record<string, unknown>): void;
17
+ }
18
+ export declare function getLogger(name: string): Logger;
19
+ //# sourceMappingURL=logger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAc3D,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAEzC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI7B,OAAO,CAAC,IAAI;IAgBZ,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI1D,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIzD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAG3D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}
@@ -0,0 +1,58 @@
1
+ /**
2
+ * Minimal structured logger.
3
+ *
4
+ * Writes JSON lines to stderr (so it does NOT interfere with MCP stdio on stdout).
5
+ * Level via `AEGIS_LOG_LEVEL` (debug|info|warn|error), default info.
6
+ */
7
+ const LEVELS = {
8
+ debug: 10,
9
+ info: 20,
10
+ warn: 30,
11
+ error: 40,
12
+ };
13
+ function currentLevel() {
14
+ const env = (process.env.AEGIS_LOG_LEVEL ?? "info").toLowerCase();
15
+ return LEVELS[env] ?? LEVELS.info;
16
+ }
17
+ export class Logger {
18
+ name;
19
+ constructor(name) {
20
+ this.name = name;
21
+ }
22
+ child(suffix) {
23
+ return new Logger(`${this.name}.${suffix}`);
24
+ }
25
+ emit(level, msg, fields) {
26
+ if (LEVELS[level] < currentLevel())
27
+ return;
28
+ const line = {
29
+ ts: new Date().toISOString(),
30
+ level,
31
+ logger: this.name,
32
+ msg,
33
+ ...(fields ?? {}),
34
+ };
35
+ try {
36
+ process.stderr.write(JSON.stringify(line) + "\n");
37
+ }
38
+ catch {
39
+ // never let logging crash the gate
40
+ }
41
+ }
42
+ debug(msg, fields) {
43
+ this.emit("debug", msg, fields);
44
+ }
45
+ info(msg, fields) {
46
+ this.emit("info", msg, fields);
47
+ }
48
+ warn(msg, fields) {
49
+ this.emit("warn", msg, fields);
50
+ }
51
+ error(msg, fields) {
52
+ this.emit("error", msg, fields);
53
+ }
54
+ }
55
+ export function getLogger(name) {
56
+ return new Logger(name);
57
+ }
58
+ //# sourceMappingURL=logger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,GAA6B;IACvC,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,CAAC,CAAC,WAAW,EAAc,CAAC;IAC9E,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC;AACpC,CAAC;AAED,MAAM,OAAO,MAAM;IACY;IAA7B,YAA6B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE7C,KAAK,CAAC,MAAc;QAClB,OAAO,IAAI,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IAEO,IAAI,CAAC,KAAe,EAAE,GAAW,EAAE,MAAgC;QACzE,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,EAAE;YAAE,OAAO;QAC3C,MAAM,IAAI,GAAG;YACX,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,KAAK;YACL,MAAM,EAAE,IAAI,CAAC,IAAI;YACjB,GAAG;YACH,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;SAClB,CAAC;QACF,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,MAAgC;QACjD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,MAAgC;QAChD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,MAAgC;QAChD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,MAAgC;QACjD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;CACF;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
@@ -0,0 +1,8 @@
1
+ export interface PathCheck {
2
+ ok: boolean;
3
+ reason?: "denied_system" | "denied_home_secret" | "outside_root" | "not_found" | "symlink_escape";
4
+ resolved?: string;
5
+ }
6
+ export declare function safeResolve(filePath: string, projectRoot?: string): PathCheck;
7
+ export declare function isReadableFile(absPath: string): boolean;
8
+ //# sourceMappingURL=safe-paths.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"safe-paths.d.ts","sourceRoot":"","sources":["../../src/util/safe-paths.ts"],"names":[],"mappings":"AAwCA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,eAAe,GAAG,oBAAoB,GAAG,cAAc,GAAG,WAAW,GAAG,gBAAgB,CAAC;IAClG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAwD7E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOvD"}
@@ -0,0 +1,102 @@
1
+ /**
2
+ * Path safety — prevent the gate from being tricked into reading sensitive
3
+ * locations outside the project.
4
+ *
5
+ * Rules:
6
+ * 1. The path must resolve to an absolute file (no `..` after normalization
7
+ * can escape the project root, if a root is provided).
8
+ * 2. The path must NOT be in the denylist of sensitive system locations.
9
+ * 3. Reparse-points / symlinks that point outside the root are rejected.
10
+ */
11
+ import { realpathSync, statSync } from "node:fs";
12
+ import { homedir, platform } from "node:os";
13
+ import { resolve, sep } from "node:path";
14
+ const DENY_PREFIXES_POSIX = [
15
+ "/etc",
16
+ "/root",
17
+ "/var/run",
18
+ "/proc",
19
+ "/sys",
20
+ "/private/etc",
21
+ ];
22
+ const DENY_HOME_SUBDIRS = [
23
+ ".ssh",
24
+ ".aws",
25
+ ".gnupg",
26
+ ".kube",
27
+ ".docker",
28
+ ".npmrc",
29
+ ".pgpass",
30
+ ];
31
+ const DENY_WIN_PREFIXES = [
32
+ "C:\\Windows",
33
+ "C:\\Program Files",
34
+ "C:\\Program Files (x86)",
35
+ "C:\\ProgramData",
36
+ ];
37
+ export function safeResolve(filePath, projectRoot) {
38
+ let resolved;
39
+ try {
40
+ resolved = resolve(filePath);
41
+ }
42
+ catch {
43
+ return { ok: false, reason: "not_found" };
44
+ }
45
+ // existence + symlink check
46
+ let real;
47
+ try {
48
+ real = realpathSync(resolved);
49
+ }
50
+ catch {
51
+ // Path doesn't exist or we can't follow it — that's OK for some flows
52
+ // (the agent may be writing a NEW file), so fall back to resolved.
53
+ real = resolved;
54
+ }
55
+ // home-secret denylist
56
+ const home = homedir();
57
+ for (const sub of DENY_HOME_SUBDIRS) {
58
+ const denied = resolve(home, sub);
59
+ if (real === denied || real.startsWith(denied + sep)) {
60
+ return { ok: false, reason: "denied_home_secret", resolved: real };
61
+ }
62
+ }
63
+ // system denylist
64
+ if (platform() === "win32") {
65
+ for (const pfx of DENY_WIN_PREFIXES) {
66
+ if (real.toLowerCase().startsWith(pfx.toLowerCase() + sep) || real.toLowerCase() === pfx.toLowerCase()) {
67
+ return { ok: false, reason: "denied_system", resolved: real };
68
+ }
69
+ }
70
+ }
71
+ else {
72
+ for (const pfx of DENY_PREFIXES_POSIX) {
73
+ if (real === pfx || real.startsWith(pfx + sep)) {
74
+ return { ok: false, reason: "denied_system", resolved: real };
75
+ }
76
+ }
77
+ }
78
+ // root containment
79
+ if (projectRoot) {
80
+ let realRoot;
81
+ try {
82
+ realRoot = realpathSync(resolve(projectRoot));
83
+ }
84
+ catch {
85
+ realRoot = resolve(projectRoot);
86
+ }
87
+ if (real !== realRoot && !real.startsWith(realRoot + sep)) {
88
+ return { ok: false, reason: "outside_root", resolved: real };
89
+ }
90
+ }
91
+ return { ok: true, resolved: real };
92
+ }
93
+ export function isReadableFile(absPath) {
94
+ try {
95
+ const st = statSync(absPath);
96
+ return st.isFile();
97
+ }
98
+ catch {
99
+ return false;
100
+ }
101
+ }
102
+ //# sourceMappingURL=safe-paths.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"safe-paths.js","sourceRoot":"","sources":["../../src/util/safe-paths.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ export interface RunOptions {
2
+ /** Command-line args; NOT shell-interpreted. */
3
+ args: ReadonlyArray<string>;
4
+ /** Working directory. Defaults to `process.cwd()`. */
5
+ cwd?: string;
6
+ /** Hard kill after this many ms. Default 10_000. */
7
+ timeoutMs?: number;
8
+ /** Optional stdin payload. */
9
+ stdin?: string | Buffer;
10
+ /** Environment overrides — added ON TOP OF process.env. */
11
+ env?: Readonly<Record<string, string>>;
12
+ /** Cap on captured output, per stream (bytes). Default 5 MB. */
13
+ maxBufferBytes?: number;
14
+ }
15
+ export interface RunResult {
16
+ command: string;
17
+ args: ReadonlyArray<string>;
18
+ exitCode: number | null;
19
+ signal: NodeJS.Signals | null;
20
+ stdout: string;
21
+ stderr: string;
22
+ durationMs: number;
23
+ timedOut: boolean;
24
+ }
25
+ /**
26
+ * Spawn a command and resolve to a result. Never throws on non-zero exit;
27
+ * the caller inspects ``exitCode`` / ``timedOut``.
28
+ */
29
+ export declare function run(command: string, opts: RunOptions): Promise<RunResult>;
30
+ /** True if the binary is found on PATH and executable. */
31
+ export declare function which(binary: string): Promise<string | null>;
32
+ //# sourceMappingURL=subprocess.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subprocess.d.ts","sourceRoot":"","sources":["../../src/util/subprocess.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvC,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAKD;;;GAGG;AACH,wBAAsB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAqH/E;AAED,0DAA0D;AAC1D,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMlE"}
@@ -0,0 +1,137 @@
1
+ /**
2
+ * Safe subprocess wrapper.
3
+ *
4
+ * - Hard timeout (kills the process tree, not just the parent).
5
+ * - Captures stdout/stderr separately.
6
+ * - No shell expansion (args go directly).
7
+ * - Returns a structured result; never throws on non-zero exit.
8
+ */
9
+ import { spawn } from "node:child_process";
10
+ import { setTimeout as delay } from "node:timers/promises";
11
+ import { getLogger } from "./logger.js";
12
+ const log = getLogger("aegis.subprocess");
13
+ const DEFAULT_TIMEOUT_MS = 10_000;
14
+ const DEFAULT_MAX_BYTES = 5 * 1024 * 1024;
15
+ /**
16
+ * Spawn a command and resolve to a result. Never throws on non-zero exit;
17
+ * the caller inspects ``exitCode`` / ``timedOut``.
18
+ */
19
+ export async function run(command, opts) {
20
+ const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
21
+ const maxBytes = opts.maxBufferBytes ?? DEFAULT_MAX_BYTES;
22
+ const t0 = Date.now();
23
+ // Merge env: process.env first, opts.env wins.
24
+ const env = { ...process.env, ...(opts.env ?? {}) };
25
+ // Windows + Node 20+: spawning a .cmd / .bat directly throws EINVAL since
26
+ // CVE-2024-27980; the documented fix is `shell: true`. We bound the security
27
+ // impact by NEVER letting user-controlled strings reach this path — args
28
+ // here come from typed config / our own engines, not from agent payloads.
29
+ const isWindowsBatch = process.platform === "win32" && /\.(cmd|bat)$/i.test(command);
30
+ const child = spawn(command, [...opts.args], {
31
+ cwd: opts.cwd,
32
+ env,
33
+ stdio: ["pipe", "pipe", "pipe"],
34
+ windowsHide: true,
35
+ ...(isWindowsBatch ? { shell: true } : {}),
36
+ });
37
+ let stdout = "";
38
+ let stderr = "";
39
+ let stdoutBytes = 0;
40
+ let stderrBytes = 0;
41
+ let outTruncated = false;
42
+ let errTruncated = false;
43
+ child.stdout?.setEncoding("utf8");
44
+ child.stderr?.setEncoding("utf8");
45
+ child.stdout?.on("data", (chunk) => {
46
+ const n = Buffer.byteLength(chunk, "utf8");
47
+ if (stdoutBytes + n > maxBytes) {
48
+ if (!outTruncated) {
49
+ outTruncated = true;
50
+ log.warn("stdout truncated", { command, limit: maxBytes });
51
+ }
52
+ return;
53
+ }
54
+ stdoutBytes += n;
55
+ stdout += chunk;
56
+ });
57
+ child.stderr?.on("data", (chunk) => {
58
+ const n = Buffer.byteLength(chunk, "utf8");
59
+ if (stderrBytes + n > maxBytes) {
60
+ if (!errTruncated) {
61
+ errTruncated = true;
62
+ log.warn("stderr truncated", { command, limit: maxBytes });
63
+ }
64
+ return;
65
+ }
66
+ stderrBytes += n;
67
+ stderr += chunk;
68
+ });
69
+ if (opts.stdin !== undefined && child.stdin) {
70
+ try {
71
+ child.stdin.end(opts.stdin);
72
+ }
73
+ catch (e) {
74
+ log.debug("stdin write failed", { err: String(e) });
75
+ }
76
+ }
77
+ else {
78
+ try {
79
+ child.stdin?.end();
80
+ }
81
+ catch {
82
+ // ignore
83
+ }
84
+ }
85
+ let timedOut = false;
86
+ const timeoutHandle = setTimeout(() => {
87
+ timedOut = true;
88
+ try {
89
+ // SIGTERM first, then SIGKILL if it survives 1s
90
+ child.kill("SIGTERM");
91
+ }
92
+ catch {
93
+ // ignore
94
+ }
95
+ void delay(1000).then(() => {
96
+ if (child.exitCode === null && child.signalCode === null) {
97
+ try {
98
+ child.kill("SIGKILL");
99
+ }
100
+ catch {
101
+ // ignore
102
+ }
103
+ }
104
+ });
105
+ }, timeoutMs);
106
+ const { exitCode, signal } = await new Promise((resolve) => {
107
+ child.once("close", (code, sig) => {
108
+ clearTimeout(timeoutHandle);
109
+ resolve({ exitCode: code, signal: sig });
110
+ });
111
+ child.once("error", (err) => {
112
+ clearTimeout(timeoutHandle);
113
+ log.debug("spawn error", { command, err: String(err) });
114
+ resolve({ exitCode: null, signal: null });
115
+ });
116
+ });
117
+ return {
118
+ command,
119
+ args: opts.args,
120
+ exitCode,
121
+ signal,
122
+ stdout,
123
+ stderr,
124
+ durationMs: Date.now() - t0,
125
+ timedOut,
126
+ };
127
+ }
128
+ /** True if the binary is found on PATH and executable. */
129
+ export async function which(binary) {
130
+ const cmd = process.platform === "win32" ? "where" : "which";
131
+ const r = await run(cmd, { args: [binary], timeoutMs: 2000 });
132
+ if (r.exitCode !== 0 || !r.stdout.trim())
133
+ return null;
134
+ // `where` may return multiple lines on Windows — take the first.
135
+ return r.stdout.split(/\r?\n/)[0].trim();
136
+ }
137
+ //# sourceMappingURL=subprocess.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subprocess.js","sourceRoot":"","sources":["../../src/util/subprocess.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,93 @@
1
+ {
2
+ "name": "dravix-agent",
3
+ "version": "0.1.0",
4
+ "description": "Real-time code-quality gate for AI coding agents (Claude Code) — multi-engine SAST + LLM critic + cross-file taint, OSS, self-hosted.",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "engines": {
8
+ "node": ">=18.0.0 <25.0.0"
9
+ },
10
+ "main": "./dist/index.js",
11
+ "types": "./dist/index.d.ts",
12
+ "bin": {
13
+ "aegis": "./dist/bin/aegis.js",
14
+ "dravix-agent": "./dist/bin/aegis.js"
15
+ },
16
+ "exports": {
17
+ ".": {
18
+ "import": "./dist/index.js",
19
+ "types": "./dist/index.d.ts"
20
+ },
21
+ "./mcp": {
22
+ "import": "./dist/mcp/server.js",
23
+ "types": "./dist/mcp/server.d.ts"
24
+ }
25
+ },
26
+ "scripts": {
27
+ "build": "tsc -p tsconfig.json && node scripts/copy-assets.mjs",
28
+ "watch": "tsc -p tsconfig.json --watch",
29
+ "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
30
+ "test": "vitest run",
31
+ "test:watch": "vitest",
32
+ "mcp": "node ./dist/mcp/server.js",
33
+ "doctor": "node ./dist/bin/aegis.js doctor",
34
+ "prepublishOnly": "npm run build"
35
+ },
36
+ "keywords": [
37
+ "mcp",
38
+ "claude-code",
39
+ "ai-agent",
40
+ "code-review",
41
+ "sast",
42
+ "security",
43
+ "static-analysis",
44
+ "llm-critic",
45
+ "joern",
46
+ "pysa",
47
+ "semgrep",
48
+ "vulnerability-scanner",
49
+ "ai-safety",
50
+ "code-gate"
51
+ ],
52
+ "author": "rotem1230",
53
+ "repository": {
54
+ "type": "git",
55
+ "url": "https://github.com/rotem1230/dravix-agent"
56
+ },
57
+ "homepage": "https://github.com/rotem1230/dravix-agent",
58
+ "bugs": {
59
+ "url": "https://github.com/rotem1230/dravix-agent/issues"
60
+ },
61
+ "dependencies": {
62
+ "@huggingface/transformers": "^3.7.6",
63
+ "@modelcontextprotocol/sdk": "^1.0.4",
64
+ "@sourcegraph/scip-python": "^0.6.6",
65
+ "@sourcegraph/scip-typescript": "^0.4.0",
66
+ "@typescript-eslint/eslint-plugin": "^8.21.0",
67
+ "@typescript-eslint/parser": "^8.21.0",
68
+ "eslint": "^9.18.0",
69
+ "hnswlib-node": "^3.0.0",
70
+ "lmdb": "^3.2.6",
71
+ "protobufjs": "^7.4.0",
72
+ "tree-sitter": "^0.22.4",
73
+ "tree-sitter-javascript": "^0.23.1",
74
+ "tree-sitter-python": "^0.23.6",
75
+ "tree-sitter-typescript": "^0.23.2",
76
+ "yaml": "^2.9.0",
77
+ "zod": "^3.24.1"
78
+ },
79
+ "devDependencies": {
80
+ "@types/node": "^22.10.5",
81
+ "typescript": "^5.7.3",
82
+ "vitest": "^2.1.8"
83
+ },
84
+ "files": [
85
+ "dist",
86
+ "data",
87
+ "README.md",
88
+ "ARCHITECTURE.md",
89
+ "ROADMAP.md",
90
+ "LICENSE",
91
+ ".claude"
92
+ ]
93
+ }