jev-codeguard 0.0.0-stage → 1.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 (78) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +364 -2
  3. package/THIRD_PARTY_NOTICES.md +25 -0
  4. package/dist/src/cli/hook-runner.d.ts +27 -0
  5. package/dist/src/cli/hook-runner.js +196 -0
  6. package/dist/src/cli/hook-runner.js.map +1 -0
  7. package/dist/src/cli/index.d.ts +2 -0
  8. package/dist/src/cli/index.js +173 -0
  9. package/dist/src/cli/index.js.map +1 -0
  10. package/dist/src/cli/setup.d.ts +14 -0
  11. package/dist/src/cli/setup.js +122 -0
  12. package/dist/src/cli/setup.js.map +1 -0
  13. package/dist/src/core/cache.d.ts +16 -0
  14. package/dist/src/core/cache.js +64 -0
  15. package/dist/src/core/cache.js.map +1 -0
  16. package/dist/src/core/command-shape.d.ts +17 -0
  17. package/dist/src/core/command-shape.js +138 -0
  18. package/dist/src/core/command-shape.js.map +1 -0
  19. package/dist/src/core/context-enricher.d.ts +149 -0
  20. package/dist/src/core/context-enricher.js +1397 -0
  21. package/dist/src/core/context-enricher.js.map +1 -0
  22. package/dist/src/core/event-log.d.ts +35 -0
  23. package/dist/src/core/event-log.js +241 -0
  24. package/dist/src/core/event-log.js.map +1 -0
  25. package/dist/src/core/git-collector.d.ts +18 -0
  26. package/dist/src/core/git-collector.js +227 -0
  27. package/dist/src/core/git-collector.js.map +1 -0
  28. package/dist/src/core/hybrid-ast-engine.d.ts +46 -0
  29. package/dist/src/core/hybrid-ast-engine.js +641 -0
  30. package/dist/src/core/hybrid-ast-engine.js.map +1 -0
  31. package/dist/src/core/jev-client.d.ts +50 -0
  32. package/dist/src/core/jev-client.js +262 -0
  33. package/dist/src/core/jev-client.js.map +1 -0
  34. package/dist/src/core/policy-config.d.ts +96 -0
  35. package/dist/src/core/policy-config.js +60 -0
  36. package/dist/src/core/policy-config.js.map +1 -0
  37. package/dist/src/core/policy-engine.d.ts +65 -0
  38. package/dist/src/core/policy-engine.js +344 -0
  39. package/dist/src/core/policy-engine.js.map +1 -0
  40. package/dist/src/core/presets.d.ts +18 -0
  41. package/dist/src/core/presets.js +180 -0
  42. package/dist/src/core/presets.js.map +1 -0
  43. package/dist/src/core/skill-auditor.d.ts +56 -0
  44. package/dist/src/core/skill-auditor.js +435 -0
  45. package/dist/src/core/skill-auditor.js.map +1 -0
  46. package/dist/src/core/telemetry.d.ts +30 -0
  47. package/dist/src/core/telemetry.js +55 -0
  48. package/dist/src/core/telemetry.js.map +1 -0
  49. package/dist/src/core/types.d.ts +89 -0
  50. package/dist/src/core/types.js +2 -0
  51. package/dist/src/core/types.js.map +1 -0
  52. package/dist/src/dashboard/server.d.ts +9 -0
  53. package/dist/src/dashboard/server.js +2425 -0
  54. package/dist/src/dashboard/server.js.map +1 -0
  55. package/dist/src/mcp/server.d.ts +137 -0
  56. package/dist/src/mcp/server.js +875 -0
  57. package/dist/src/mcp/server.js.map +1 -0
  58. package/package.json +75 -4
  59. package/skills/jev-system-one/SKILL.md +54 -0
  60. package/skills/vendor/codebase-design/DEEPENING.md +37 -0
  61. package/skills/vendor/codebase-design/DESIGN-IT-TWICE.md +44 -0
  62. package/skills/vendor/codebase-design/LICENSE +21 -0
  63. package/skills/vendor/codebase-design/SKILL.md +114 -0
  64. package/skills/vendor/gsap-performance/LICENSE +21 -0
  65. package/skills/vendor/gsap-performance/SKILL.md +79 -0
  66. package/skills/vendor/manifest.json +122 -0
  67. package/skills/vendor/security-best-practices/LICENSE.txt +201 -0
  68. package/skills/vendor/security-best-practices/SKILL.md +86 -0
  69. package/skills/vendor/security-best-practices/references/golang-general-backend-security.md +826 -0
  70. package/skills/vendor/security-best-practices/references/javascript-express-web-server-security.md +1158 -0
  71. package/skills/vendor/security-best-practices/references/javascript-general-web-frontend-security.md +747 -0
  72. package/skills/vendor/security-best-practices/references/javascript-jquery-web-frontend-security.md +678 -0
  73. package/skills/vendor/security-best-practices/references/javascript-typescript-nextjs-web-server-security.md +1144 -0
  74. package/skills/vendor/security-best-practices/references/javascript-typescript-react-web-frontend-security.md +990 -0
  75. package/skills/vendor/security-best-practices/references/javascript-typescript-vue-web-frontend-security.md +791 -0
  76. package/skills/vendor/security-best-practices/references/python-django-web-server-security.md +882 -0
  77. package/skills/vendor/security-best-practices/references/python-fastapi-web-server-security.md +1036 -0
  78. package/skills/vendor/security-best-practices/references/python-flask-web-server-security.md +705 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hook-runner.js","sourceRoot":"","sources":["../../../src/cli/hook-runner.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
@@ -0,0 +1,173 @@
1
+ #!/usr/bin/env node
2
+ import fs from "node:fs";
3
+ import { startStdioServer, McpJevDispatcher } from "../mcp/server.js";
4
+ import { runPreToolHook } from "./hook-runner.js";
5
+ import { runSetup } from "./setup.js";
6
+ import { startDashboardServer } from "../dashboard/server.js";
7
+ function readStdin() {
8
+ return new Promise((resolve) => {
9
+ if (process.stdin.isTTY) {
10
+ resolve("");
11
+ return;
12
+ }
13
+ let data = "";
14
+ process.stdin.setEncoding("utf8");
15
+ process.stdin.on("data", (chunk) => {
16
+ data += chunk;
17
+ });
18
+ process.stdin.on("end", () => resolve(data));
19
+ process.stdin.on("error", () => resolve(data));
20
+ });
21
+ }
22
+ function getArgValue(args, flag) {
23
+ const idx = args.indexOf(flag);
24
+ if (idx !== -1 && idx + 1 < args.length) {
25
+ return args[idx + 1];
26
+ }
27
+ return undefined;
28
+ }
29
+ function getAllArgValues(args, flag) {
30
+ const values = [];
31
+ for (let i = 0; i < args.length - 1; i++) {
32
+ if (args[i] === flag) {
33
+ values.push(args[i + 1]);
34
+ }
35
+ }
36
+ return values;
37
+ }
38
+ async function main() {
39
+ const args = process.argv.slice(2);
40
+ const binName = process.argv[1] ?? "";
41
+ const isGateBinary = binName.endsWith("jev-gate");
42
+ const subcommand = args[0] ?? (isGateBinary ? "gate" : "serve");
43
+ if (subcommand === "serve" || subcommand === "mcp") {
44
+ // Automatically ensure the Live Radar Portal is running on port 4399 (ignores EADDRINUSE if already active)
45
+ startDashboardServer({ port: 4399 }).catch(() => { });
46
+ await startStdioServer();
47
+ return;
48
+ }
49
+ if (subcommand === "dashboard" || subcommand === "portal" || subcommand === "radar") {
50
+ const portArg = getArgValue(args, "--port");
51
+ const port = portArg ? Number(portArg) : 4399;
52
+ const { url } = await startDashboardServer({ port });
53
+ console.log(`[mcp-jev radar]: Live Agent Q&A Portal listening at ${url}`);
54
+ return;
55
+ }
56
+ const explicitAgent = getArgValue(args, "--agent");
57
+ if (subcommand === "gate" || subcommand === "pre-tool") {
58
+ const cmdArg = getArgValue(args, "--command");
59
+ const fileArg = getArgValue(args, "--file");
60
+ let rawPayload = "";
61
+ if (cmdArg) {
62
+ rawPayload = JSON.stringify({ command: cmdArg });
63
+ }
64
+ else if (fileArg && fs.existsSync(fileArg)) {
65
+ rawPayload = JSON.stringify({
66
+ file_path: fileArg,
67
+ code: fs.readFileSync(fileArg, "utf8")
68
+ });
69
+ }
70
+ else {
71
+ rawPayload = await readStdin();
72
+ }
73
+ const result = await runPreToolHook(rawPayload);
74
+ if (result.stdout) {
75
+ process.stdout.write(`${result.stdout}\n`);
76
+ }
77
+ if (result.stderr) {
78
+ process.stderr.write(`${result.stderr}\n`);
79
+ }
80
+ process.exit(result.exitCode);
81
+ }
82
+ if (subcommand === "autopilot" || subcommand === "decide") {
83
+ const question = getArgValue(args, "--question") ?? args[1] ?? "";
84
+ const context = getArgValue(args, "--context") ?? "";
85
+ const optFlags = getAllArgValues(args, "--opt");
86
+ const optionsRaw = getArgValue(args, "--options");
87
+ const options = {};
88
+ for (const entry of optFlags) {
89
+ const eqIdx = entry.indexOf("=");
90
+ if (eqIdx > 0) {
91
+ const key = entry.slice(0, eqIdx).trim();
92
+ const val = entry.slice(eqIdx + 1).trim();
93
+ if (key)
94
+ options[key] = val;
95
+ }
96
+ }
97
+ if (Object.keys(options).length === 0 && optionsRaw) {
98
+ try {
99
+ Object.assign(options, JSON.parse(optionsRaw));
100
+ }
101
+ catch {
102
+ console.error("[mcp-jev autopilot]: Pass --opt key=\"description\" (2+ times) or valid --options JSON");
103
+ process.exit(1);
104
+ }
105
+ }
106
+ if (Object.keys(options).length < 2) {
107
+ console.error("[mcp-jev autopilot]: Provide at least 2 options via --opt key=\"description\"");
108
+ process.exit(1);
109
+ }
110
+ const dispatcher = new McpJevDispatcher();
111
+ const res = await dispatcher.autopilotDecide({
112
+ question,
113
+ options,
114
+ context,
115
+ agent: explicitAgent
116
+ });
117
+ process.stdout.write(`${JSON.stringify(res, null, 2)}\n`);
118
+ process.exit(0);
119
+ }
120
+ if (subcommand === "audit") {
121
+ const filePath = getArgValue(args, "--file") ?? args[1];
122
+ const code = filePath && fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf8") : undefined;
123
+ const dispatcher = new McpJevDispatcher();
124
+ const res = await dispatcher.auditCode({
125
+ code,
126
+ file_path: filePath,
127
+ agent: explicitAgent
128
+ });
129
+ process.stdout.write(`${JSON.stringify(res, null, 2)}\n`);
130
+ process.exit(res.verdict === "BLOCK" ? 2 : 0);
131
+ }
132
+ if (subcommand === "verify-diff") {
133
+ const spec = getArgValue(args, "--spec") ?? args[1] ?? "Verify git diff quality and safety";
134
+ const dispatcher = new McpJevDispatcher();
135
+ const res = await dispatcher.verifyDiff({ spec, agent: explicitAgent });
136
+ process.stdout.write(`${JSON.stringify(res, null, 2)}\n`);
137
+ process.exit(res.decision.verdict === "BLOCK" ? 2 : 0);
138
+ }
139
+ if (subcommand === "setup" || subcommand === "init") {
140
+ const apiKey = getArgValue(args, "--api-key");
141
+ const report = runSetup({ apiKey });
142
+ console.log("=== MCP-Jev Setup Complete ===");
143
+ if (report.configSavedPath) {
144
+ console.log(`[+] Saved API key config to: ${report.configSavedPath}`);
145
+ }
146
+ if (report.skillInstalledPath) {
147
+ console.log(`[+] Installed companion skill to: ${report.skillInstalledPath}`);
148
+ }
149
+ console.log("\n--- 1. Add to MCP Settings (Antigravity / Claude Code / Cursor / Windsurf) ---");
150
+ console.log(report.mcpConfigSnippet);
151
+ console.log("\n--- 2. OpenAI Codex CLI (~/.codex/config.toml) ---");
152
+ console.log(report.codexTomlSnippet);
153
+ console.log("\n--- 3. Optional Zero-Trust PreToolUse Hook (.claude/settings.json) ---");
154
+ console.log(report.claudeHookSnippet);
155
+ return;
156
+ }
157
+ console.log(`mcp-jev v1.1.0 — System-1 Decision Engine, Skill Auditor & Live Radar Portal
158
+
159
+ Usage:
160
+ mcp-jev serve Start MCP stdio server + auto-start Radar Portal (default)
161
+ mcp-jev dashboard [--port 4399] Launch standalone Live Radar Portal (http://localhost:4399)
162
+ mcp-jev setup [--api-key <key>] Save API key (0600), install SKILL.md, and print IDE configs
163
+ mcp-jev autopilot --question "<q>" --opt A="desc" --opt B="desc" Run Human-Proxy Autopilot (auto-proceeds only with JEV_AUTOPILOT=1)
164
+ mcp-jev gate [--command "<cmd>" | --file <path>] Run Zero-Trust PreToolUse Hook Firewall (stdin or flags)
165
+ mcp-jev audit [--file <path>] Run Skill-Backed Security & Quality Audit on file or git diff
166
+ mcp-jev verify-diff --spec "<spec>" Run Zero-Token Local Git Diff Verification Gate
167
+ `);
168
+ }
169
+ main().catch((err) => {
170
+ console.error("[mcp-jev fatal]:", err instanceof Error ? err.message : String(err));
171
+ process.exit(1);
172
+ });
173
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ export interface SetupOptions {
2
+ apiKey?: string;
3
+ installSkill?: boolean;
4
+ skillsTargetDir?: string;
5
+ }
6
+ export interface SetupReport {
7
+ configSavedPath?: string;
8
+ skillInstalledPath?: string;
9
+ mcpEntrypoint: string;
10
+ mcpConfigSnippet: string;
11
+ codexTomlSnippet: string;
12
+ claudeHookSnippet: string;
13
+ }
14
+ export declare function runSetup(rawOptions?: SetupOptions): SetupReport;
@@ -0,0 +1,122 @@
1
+ import fs from "node:fs";
2
+ import os from "node:os";
3
+ import path from "node:path";
4
+ import { fileURLToPath } from "node:url";
5
+ import { z } from "zod";
6
+ const SetupOptionsSchema = z.object({
7
+ apiKey: z
8
+ .string()
9
+ .trim()
10
+ .min(8, "API key must be at least 8 characters")
11
+ .max(256, "API key exceeds maximum length")
12
+ .regex(/^[A-Za-z0-9_.-]+$/, "API key contains invalid characters")
13
+ .optional(),
14
+ installSkill: z.boolean().optional(),
15
+ skillsTargetDir: z
16
+ .string()
17
+ .trim()
18
+ .min(1)
19
+ .max(512)
20
+ .refine((p) => !p.includes("\u0000"), "Invalid path")
21
+ .optional()
22
+ });
23
+ export function runSetup(rawOptions = {}) {
24
+ const options = SetupOptionsSchema.parse({
25
+ ...rawOptions,
26
+ apiKey: rawOptions.apiKey && rawOptions.apiKey.trim().length > 0 ? rawOptions.apiKey : undefined
27
+ });
28
+ const homeDir = os.homedir();
29
+ const configDir = path.join(homeDir, ".mcp-jev");
30
+ let configSavedPath;
31
+ if (options.apiKey) {
32
+ fs.mkdirSync(configDir, { recursive: true, mode: 0o700 });
33
+ configSavedPath = path.join(configDir, "config.json");
34
+ fs.writeFileSync(configSavedPath, JSON.stringify({ apiKey: options.apiKey, updatedAt: new Date().toISOString() }, null, 2), { encoding: "utf8", mode: 0o600 });
35
+ try {
36
+ fs.chmodSync(configSavedPath, 0o600);
37
+ }
38
+ catch {
39
+ // chmod may be a no-op on Windows NTFS
40
+ }
41
+ }
42
+ const currentFile = fileURLToPath(import.meta.url);
43
+ const projectRoot = path.resolve(path.dirname(currentFile), "..", "..", "..");
44
+ const mcpEntrypoint = path
45
+ .join(projectRoot, "dist", "src", "cli", "index.js")
46
+ .replace(/\\/g, "/");
47
+ let skillInstalledPath;
48
+ if (options.installSkill !== false) {
49
+ const sourceSkill = path.join(projectRoot, "skills", "jev-system-one", "SKILL.md");
50
+ const targetBase = options.skillsTargetDir ?? path.join(homeDir, ".gemini", "config", "skills");
51
+ if (fs.existsSync(sourceSkill)) {
52
+ const targetSkillDir = path.join(targetBase, "jev-system-one");
53
+ fs.mkdirSync(targetSkillDir, { recursive: true });
54
+ skillInstalledPath = path.join(targetSkillDir, "SKILL.md");
55
+ fs.copyFileSync(sourceSkill, skillInstalledPath);
56
+ }
57
+ }
58
+ // Auto-register in Antigravity mcp_config.json if present
59
+ const antigravityMcpPath = path.join(homeDir, ".gemini", "antigravity", "mcp_config.json");
60
+ if (fs.existsSync(antigravityMcpPath)) {
61
+ try {
62
+ const parsed = JSON.parse(fs.readFileSync(antigravityMcpPath, "utf8"));
63
+ parsed.mcpServers = parsed.mcpServers ?? {};
64
+ parsed.mcpServers["mcp-jev"] = {
65
+ command: "node",
66
+ args: [mcpEntrypoint, "serve"],
67
+ env: {
68
+ JEV_SKILLS_DIR: path
69
+ .join(homeDir, ".gemini", "config", "skills")
70
+ .replace(/\\/g, "/")
71
+ }
72
+ };
73
+ fs.writeFileSync(antigravityMcpPath, JSON.stringify(parsed, null, 2), "utf8");
74
+ }
75
+ catch {
76
+ // Ignore write error if locked
77
+ }
78
+ }
79
+ const mcpConfigSnippet = JSON.stringify({
80
+ mcpServers: {
81
+ "mcp-jev": {
82
+ command: "node",
83
+ args: [mcpEntrypoint, "serve"],
84
+ env: {
85
+ JEV_API_KEY: options.apiKey ? "<SAVED_IN_~/.mcp-jev/config.json>" : "jev_live_your_key_here",
86
+ JEV_SKILLS_DIR: path
87
+ .join(homeDir, ".gemini", "config", "skills")
88
+ .replace(/\\/g, "/")
89
+ }
90
+ }
91
+ }
92
+ }, null, 2);
93
+ const codexTomlSnippet = [
94
+ "[mcp_servers.mcp-jev]",
95
+ 'command = "node"',
96
+ `args = ["${mcpEntrypoint}", "serve"]`
97
+ ].join("\n");
98
+ const claudeHookSnippet = JSON.stringify({
99
+ hooks: {
100
+ PreToolUse: [
101
+ {
102
+ matcher: "Bash|Write|Edit",
103
+ hooks: [
104
+ {
105
+ type: "command",
106
+ command: `node "${mcpEntrypoint}" gate`
107
+ }
108
+ ]
109
+ }
110
+ ]
111
+ }
112
+ }, null, 2);
113
+ return {
114
+ configSavedPath,
115
+ skillInstalledPath,
116
+ mcpEntrypoint,
117
+ mcpConfigSnippet,
118
+ codexTomlSnippet,
119
+ claudeHookSnippet
120
+ };
121
+ }
122
+ //# sourceMappingURL=setup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/cli/setup.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import type { JevRequest, JevResponse } from "./types.js";
2
+ export interface DecisionCacheOptions {
3
+ maxEntries?: number;
4
+ ttlMs?: number;
5
+ }
6
+ export declare class DecisionCache {
7
+ private readonly maxEntries;
8
+ private readonly ttlMs;
9
+ private readonly store;
10
+ constructor(options?: DecisionCacheOptions);
11
+ computeKey(request: JevRequest): string;
12
+ get(key: string): JevResponse | undefined;
13
+ set(key: string, response: JevResponse): void;
14
+ clear(): void;
15
+ size(): number;
16
+ }
@@ -0,0 +1,64 @@
1
+ import { createHash } from "node:crypto";
2
+ function canonicalize(value) {
3
+ if (Array.isArray(value)) {
4
+ return value.map(canonicalize);
5
+ }
6
+ if (value !== null && typeof value === "object") {
7
+ const sortedKeys = Object.keys(value).sort();
8
+ const out = {};
9
+ for (const key of sortedKeys) {
10
+ out[key] = canonicalize(value[key]);
11
+ }
12
+ return out;
13
+ }
14
+ return value;
15
+ }
16
+ export class DecisionCache {
17
+ maxEntries;
18
+ ttlMs;
19
+ store = new Map();
20
+ constructor(options = {}) {
21
+ this.maxEntries = options.maxEntries ?? 500;
22
+ this.ttlMs = options.ttlMs ?? 10 * 60 * 1000;
23
+ }
24
+ computeKey(request) {
25
+ const normalized = JSON.stringify(canonicalize(request));
26
+ return createHash("sha256").update(normalized).digest("hex");
27
+ }
28
+ get(key) {
29
+ const entry = this.store.get(key);
30
+ if (!entry) {
31
+ return undefined;
32
+ }
33
+ if (Date.now() > entry.expiresAt) {
34
+ this.store.delete(key);
35
+ return undefined;
36
+ }
37
+ // Refresh LRU order
38
+ this.store.delete(key);
39
+ this.store.set(key, entry);
40
+ return entry.response;
41
+ }
42
+ set(key, response) {
43
+ if (this.store.has(key)) {
44
+ this.store.delete(key);
45
+ }
46
+ else if (this.store.size >= this.maxEntries) {
47
+ const oldestKey = this.store.keys().next().value;
48
+ if (oldestKey !== undefined) {
49
+ this.store.delete(oldestKey);
50
+ }
51
+ }
52
+ this.store.set(key, {
53
+ response,
54
+ expiresAt: Date.now() + this.ttlMs
55
+ });
56
+ }
57
+ clear() {
58
+ this.store.clear();
59
+ }
60
+ size() {
61
+ return this.store.size;
62
+ }
63
+ }
64
+ //# sourceMappingURL=cache.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/core/cache.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Detects whether a `jev_guard_action` exact_command is a literal command line or a
3
+ * prose description of intent. In the real event log most guard inputs were prose
4
+ * ("Commit only four documentation files ... read-only ..."), so Jev scored the
5
+ * agent's self-description instead of the command it then executed.
6
+ *
7
+ * Pure and deterministic; quoted strings, here-strings and heredocs are ignored so
8
+ * commit messages or inline scripts never count as prose.
9
+ */
10
+ export interface CommandShapeAssessment {
11
+ looksLikeProse: boolean;
12
+ /** Short machine-readable reasons, e.g. "capitalized-lead:Commit". */
13
+ signals: string[];
14
+ /** Plain alphabetic words found outside quotes. */
15
+ wordCount: number;
16
+ }
17
+ export declare function assessCommandShape(rawCommand: string): CommandShapeAssessment;
@@ -0,0 +1,138 @@
1
+ /**
2
+ * Detects whether a `jev_guard_action` exact_command is a literal command line or a
3
+ * prose description of intent. In the real event log most guard inputs were prose
4
+ * ("Commit only four documentation files ... read-only ..."), so Jev scored the
5
+ * agent's self-description instead of the command it then executed.
6
+ *
7
+ * Pure and deterministic; quoted strings, here-strings and heredocs are ignored so
8
+ * commit messages or inline scripts never count as prose.
9
+ */
10
+ /** English function words that are common in prose and rare as bare shell arguments. */
11
+ const PROSE_STOPWORDS = new Set([
12
+ "the", "a", "an", "and", "or", "but", "only", "into", "onto", "with", "without",
13
+ "before", "after", "using", "via", "exactly", "that", "which", "this", "these",
14
+ "those", "will", "would", "should", "must", "could", "is", "are", "was", "were",
15
+ "be", "been", "no", "any", "every", "each", "of", "to", "from", "by", "as", "so",
16
+ "because", "while", "also", "just", "then", "than", "it", "its", "we", "our",
17
+ "you", "your", "their", "them", "against", "through", "per", "unless", "until"
18
+ ]);
19
+ const MAX_ANALYZED_CHARS = 20000;
20
+ const MIN_WORDS_FOR_LEAD_SIGNAL = 3;
21
+ const STOPWORD_MIN_COUNT = 3;
22
+ const STOPWORD_MIN_RATIO = 0.15;
23
+ const WORD_RUN_MIN = 6;
24
+ const SINGLE_QUOTE_OPENERS = /[\s=(,;|&:{@[]/;
25
+ /** Removes string literals and comments so only the command's own words remain. */
26
+ function stripLiterals(command) {
27
+ const pre = command
28
+ // PowerShell here-strings: the terminator '@ / "@ must start a line, so inner
29
+ // text such as require('@prisma/client') does not end the literal early.
30
+ .replace(/@'[ \t]*\r?\n[\s\S]*?\r?\n[ \t]*'@/g, " ")
31
+ .replace(/@"[ \t]*\r?\n[\s\S]*?\r?\n[ \t]*"@/g, " ")
32
+ // POSIX heredocs: <<EOF ... EOF, <<'EOF' ... EOF, <<-EOF ... EOF
33
+ .replace(/<<-?\s*(['"]?)([A-Za-z_][A-Za-z0-9_]*)\1[\s\S]*?\n\s*\2(?=\s|$)/g, " ")
34
+ // PowerShell block comments and full-line comments (PowerShell/bash)
35
+ .replace(/<#[\s\S]*?#>/g, " ")
36
+ .replace(/^[ \t]*#.*$/gm, " ");
37
+ // Quote scanner: handles nesting like Trim('"') and PowerShell '' escapes, which a
38
+ // pair of regexes cannot. Content inside quotes is dropped.
39
+ let out = "";
40
+ let quote = null;
41
+ let quoteStart = -1;
42
+ for (let i = 0; i < pre.length; i += 1) {
43
+ const ch = pre[i];
44
+ if (quote === null) {
45
+ if (ch === '"') {
46
+ quote = '"';
47
+ quoteStart = i;
48
+ out += " ";
49
+ }
50
+ else if (ch === "'" && (i === 0 || SINGLE_QUOTE_OPENERS.test(pre[i - 1]))) {
51
+ // Apostrophes inside words ("Gemini's") never open a quote.
52
+ quote = "'";
53
+ quoteStart = i;
54
+ out += " ";
55
+ }
56
+ else {
57
+ out += ch;
58
+ }
59
+ continue;
60
+ }
61
+ if (quote === '"') {
62
+ if (ch === "\\" || ch === "`") {
63
+ i += 1;
64
+ }
65
+ else if (ch === '"') {
66
+ quote = null;
67
+ }
68
+ continue;
69
+ }
70
+ if (ch === "'") {
71
+ if (pre[i + 1] === "'") {
72
+ i += 1; // PowerShell escaped quote inside a single-quoted string
73
+ }
74
+ else {
75
+ quote = null;
76
+ }
77
+ }
78
+ }
79
+ if (quote !== null) {
80
+ // Unterminated quote: treat the remainder as plain text rather than hiding it.
81
+ out += pre.slice(quoteStart + 1);
82
+ }
83
+ return out;
84
+ }
85
+ const WORD_RE = /^[A-Za-z][A-Za-z'’-]*[,.:;!?]?$/;
86
+ const CAPITALIZED_PROSE_LEAD_RE = /^[A-Z][a-z]+(?:-[a-z]+)*[,:.]?$/;
87
+ function bareWord(token) {
88
+ return token.replace(/[,.:;!?]+$/, "").toLowerCase();
89
+ }
90
+ export function assessCommandShape(rawCommand) {
91
+ const command = (rawCommand ?? "").slice(0, MAX_ANALYZED_CHARS).trim();
92
+ if (command.length === 0) {
93
+ return { looksLikeProse: true, signals: ["empty"], wordCount: 0 };
94
+ }
95
+ const stripped = stripLiterals(command);
96
+ const tokens = stripped.split(/[\s;|&(){}<>]+/).filter((tok) => tok.length > 0);
97
+ const signals = [];
98
+ let wordCount = 0;
99
+ let stopwordCount = 0;
100
+ let run = 0;
101
+ let runHasStopword = false;
102
+ let longestProseRun = 0;
103
+ for (const tok of tokens) {
104
+ if (WORD_RE.test(tok)) {
105
+ wordCount += 1;
106
+ run += 1;
107
+ if (PROSE_STOPWORDS.has(bareWord(tok))) {
108
+ stopwordCount += 1;
109
+ runHasStopword = true;
110
+ }
111
+ if (runHasStopword)
112
+ longestProseRun = Math.max(longestProseRun, run);
113
+ }
114
+ else {
115
+ run = 0;
116
+ runHasStopword = false;
117
+ }
118
+ }
119
+ const lead = tokens[0] ?? "";
120
+ if (CAPITALIZED_PROSE_LEAD_RE.test(lead) && wordCount >= MIN_WORDS_FOR_LEAD_SIGNAL) {
121
+ // PowerShell cmdlets are Verb-Noun with a capital noun (Get-Content) and never match.
122
+ signals.push(`capitalized-lead:${lead.replace(/[,:.]+$/, "")}`);
123
+ }
124
+ if (stopwordCount >= STOPWORD_MIN_COUNT && stopwordCount / Math.max(1, wordCount) >= STOPWORD_MIN_RATIO) {
125
+ signals.push(`stopwords:${stopwordCount}/${wordCount}`);
126
+ }
127
+ if (/[a-z]{2,}[.!?]\s+[A-Z][a-z]+\s/.test(stripped)) {
128
+ signals.push("sentence-break");
129
+ }
130
+ if (/,\s+(?:and\s+)?(?:then|but|so)\s/i.test(stripped) || /\b(?:and then|followed by)\b/i.test(stripped)) {
131
+ signals.push("prose-connector");
132
+ }
133
+ if (longestProseRun >= WORD_RUN_MIN) {
134
+ signals.push(`word-run:${longestProseRun}`);
135
+ }
136
+ return { looksLikeProse: signals.length > 0, signals, wordCount };
137
+ }
138
+ //# sourceMappingURL=command-shape.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"command-shape.js","sourceRoot":"","sources":["../../../src/core/command-shape.ts"],"names":[],"mappings":"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"}