@buyong/pi-codex-auto-review 0.0.0-stage → 0.2.2

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 (133) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +12 -0
  3. package/README.ko.md +85 -0
  4. package/README.md +84 -2
  5. package/dist/approval-commands.d.ts +4 -0
  6. package/dist/approval-commands.js +230 -0
  7. package/dist/approval-commands.js.map +1 -0
  8. package/dist/approval-settings.d.ts +9 -0
  9. package/dist/approval-settings.js +47 -0
  10. package/dist/approval-settings.js.map +1 -0
  11. package/dist/approvals.d.ts +73 -0
  12. package/dist/approvals.js +288 -0
  13. package/dist/approvals.js.map +1 -0
  14. package/dist/audit.d.ts +28 -0
  15. package/dist/audit.js +64 -0
  16. package/dist/audit.js.map +1 -0
  17. package/dist/cli.d.ts +2 -0
  18. package/dist/cli.js +99 -0
  19. package/dist/cli.js.map +1 -0
  20. package/dist/context-files.d.ts +14 -0
  21. package/dist/context-files.js +134 -0
  22. package/dist/context-files.js.map +1 -0
  23. package/dist/contracts.d.ts +260 -0
  24. package/dist/contracts.js +168 -0
  25. package/dist/contracts.js.map +1 -0
  26. package/dist/index.d.ts +28 -0
  27. package/dist/index.js +191 -0
  28. package/dist/index.js.map +1 -0
  29. package/dist/pi-host.d.ts +2 -0
  30. package/dist/pi-host.js +7 -0
  31. package/dist/pi-host.js.map +1 -0
  32. package/dist/policy/domains.d.ts +5 -0
  33. package/dist/policy/domains.js +28 -0
  34. package/dist/policy/domains.js.map +1 -0
  35. package/dist/policy/index.d.ts +55 -0
  36. package/dist/policy/index.js +521 -0
  37. package/dist/policy/index.js.map +1 -0
  38. package/dist/policy/paths.d.ts +5 -0
  39. package/dist/policy/paths.js +67 -0
  40. package/dist/policy/paths.js.map +1 -0
  41. package/dist/policy/rule-engine.d.ts +2 -0
  42. package/dist/policy/rule-engine.js +283 -0
  43. package/dist/policy/rule-engine.js.map +1 -0
  44. package/dist/policy/rule-types.d.ts +30 -0
  45. package/dist/policy/rule-types.js +2 -0
  46. package/dist/policy/rule-types.js.map +1 -0
  47. package/dist/policy/rules-sync.d.ts +1 -0
  48. package/dist/policy/rules-sync.js +14 -0
  49. package/dist/policy/rules-sync.js.map +1 -0
  50. package/dist/policy/rules-worker.d.ts +1 -0
  51. package/dist/policy/rules-worker.js +14 -0
  52. package/dist/policy/rules-worker.js.map +1 -0
  53. package/dist/policy/rules.d.ts +9 -0
  54. package/dist/policy/rules.js +149 -0
  55. package/dist/policy/rules.js.map +1 -0
  56. package/dist/policy/shell.d.ts +14 -0
  57. package/dist/policy/shell.js +151 -0
  58. package/dist/policy/shell.js.map +1 -0
  59. package/dist/policy/starlark/builtins.d.ts +6 -0
  60. package/dist/policy/starlark/builtins.js +764 -0
  61. package/dist/policy/starlark/builtins.js.map +1 -0
  62. package/dist/policy/starlark/evaluator.d.ts +18 -0
  63. package/dist/policy/starlark/evaluator.js +518 -0
  64. package/dist/policy/starlark/evaluator.js.map +1 -0
  65. package/dist/policy/starlark/lexer.d.ts +14 -0
  66. package/dist/policy/starlark/lexer.js +189 -0
  67. package/dist/policy/starlark/lexer.js.map +1 -0
  68. package/dist/policy/starlark/parser.d.ts +140 -0
  69. package/dist/policy/starlark/parser.js +508 -0
  70. package/dist/policy/starlark/parser.js.map +1 -0
  71. package/dist/policy/starlark/validation.d.ts +4 -0
  72. package/dist/policy/starlark/validation.js +183 -0
  73. package/dist/policy/starlark/validation.js.map +1 -0
  74. package/dist/policy/starlark/values.d.ts +46 -0
  75. package/dist/policy/starlark/values.js +363 -0
  76. package/dist/policy/starlark/values.js.map +1 -0
  77. package/dist/reports.d.ts +21 -0
  78. package/dist/reports.js +78 -0
  79. package/dist/reports.js.map +1 -0
  80. package/dist/review/context.d.ts +38 -0
  81. package/dist/review/context.js +314 -0
  82. package/dist/review/context.js.map +1 -0
  83. package/dist/review/investigation.d.ts +39 -0
  84. package/dist/review/investigation.js +77 -0
  85. package/dist/review/investigation.js.map +1 -0
  86. package/dist/review/lifecycle.d.ts +29 -0
  87. package/dist/review/lifecycle.js +114 -0
  88. package/dist/review/lifecycle.js.map +1 -0
  89. package/dist/review/policy.d.ts +4 -0
  90. package/dist/review/policy.js +37 -0
  91. package/dist/review/policy.js.map +1 -0
  92. package/dist/review/upstream-policy.d.ts +2 -0
  93. package/dist/review/upstream-policy.js +210 -0
  94. package/dist/review/upstream-policy.js.map +1 -0
  95. package/dist/review/user-input.d.ts +5 -0
  96. package/dist/review/user-input.js +54 -0
  97. package/dist/review/user-input.js.map +1 -0
  98. package/dist/reviewer.d.ts +55 -0
  99. package/dist/reviewer.js +336 -0
  100. package/dist/reviewer.js.map +1 -0
  101. package/dist/signals.d.ts +10 -0
  102. package/dist/signals.js +36 -0
  103. package/dist/signals.js.map +1 -0
  104. package/dist/startup.d.ts +22 -0
  105. package/dist/startup.js +198 -0
  106. package/dist/startup.js.map +1 -0
  107. package/dist/tools/controller.d.ts +72 -0
  108. package/dist/tools/controller.js +644 -0
  109. package/dist/tools/controller.js.map +1 -0
  110. package/dist/tools/environment.d.ts +2 -0
  111. package/dist/tools/environment.js +11 -0
  112. package/dist/tools/environment.js.map +1 -0
  113. package/dist/tools/executor.d.ts +14 -0
  114. package/dist/tools/executor.js +92 -0
  115. package/dist/tools/executor.js.map +1 -0
  116. package/dist/tools/external.d.ts +31 -0
  117. package/dist/tools/external.js +35 -0
  118. package/dist/tools/external.js.map +1 -0
  119. package/dist/tools/mcp.d.ts +17 -0
  120. package/dist/tools/mcp.js +317 -0
  121. package/dist/tools/mcp.js.map +1 -0
  122. package/dist/tools/mutation-queue.d.ts +1 -0
  123. package/dist/tools/mutation-queue.js +16 -0
  124. package/dist/tools/mutation-queue.js.map +1 -0
  125. package/docs/publishing.ko.md +127 -0
  126. package/docs/publishing.md +127 -0
  127. package/docs/security/dependencies.ko.md +54 -0
  128. package/docs/security/dependencies.md +54 -0
  129. package/docs/testing/auto-review-protection.ko.md +158 -0
  130. package/docs/testing/auto-review-protection.md +158 -0
  131. package/docs/usage.ko.md +242 -0
  132. package/docs/usage.md +242 -0
  133. package/package.json +76 -5
@@ -0,0 +1,521 @@
1
+ import { readFile, stat } from "node:fs/promises";
2
+ import { homedir, tmpdir } from "node:os";
3
+ import { basename, dirname, join, resolve } from "node:path";
4
+ import { fileURLToPath } from "node:url";
5
+ import { createProfile, decision, digest, EMPTY_DELTA, GuardError, immutable, TOOL_NAMES, } from "../contracts.js";
6
+ import { reviewPolicy } from "../review/policy.js";
7
+ import { isDomainPattern, isNetworkHost, matchesDomain, normalizeHost, } from "./domains.js";
8
+ import { canonicalPath, isWithin, resolveToolPath } from "./paths.js";
9
+ import { evaluateRules, matchesRule, ruleCommands, } from "./rules.js";
10
+ import { analyzeShell, matchesPrefix } from "./shell.js";
11
+ export { analyzeShell, canonicalPath, isWithin, matchesPrefix, resolveToolPath, };
12
+ export const DEFAULT_SETTINGS = immutable({
13
+ mode: "workspace-write",
14
+ commandRules: [],
15
+ allowedDomains: [],
16
+ reviewTimeoutMs: 20_000,
17
+ approvalTimeoutMs: 60_000,
18
+ executionTimeoutSeconds: 120,
19
+ trustedTools: [],
20
+ approvalPolicy: "on-request",
21
+ approvalsReviewer: "auto_review",
22
+ reviewModel: null,
23
+ reviewPolicy: null,
24
+ reviewMaxRounds: 4,
25
+ reviewMaxOutputTokens: 2048,
26
+ reviewContextChars: 60000,
27
+ ruleFiles: [],
28
+ writableRoots: [],
29
+ excludeSlashTmp: false,
30
+ excludeTmpdir: false,
31
+ projectDocMaxBytes: 32768,
32
+ projectDocFallbackFilenames: [],
33
+ projectRootMarkers: null,
34
+ });
35
+ export function validateSettings(value) {
36
+ if (!value || typeof value !== "object" || Array.isArray(value))
37
+ throw new GuardError("INVALID_SETTINGS", "Settings must be an object");
38
+ const raw = value;
39
+ for (const key of Object.keys(raw))
40
+ if (!Object.hasOwn(DEFAULT_SETTINGS, key))
41
+ throw new GuardError("INVALID_SETTINGS", `Unknown setting: ${key}`);
42
+ const settings = { ...DEFAULT_SETTINGS, ...raw };
43
+ if (!["read-only", "workspace-write"].includes(settings.mode))
44
+ throw new GuardError("INVALID_SETTINGS", "Unknown mode");
45
+ for (const key of [
46
+ "reviewTimeoutMs",
47
+ "approvalTimeoutMs",
48
+ "executionTimeoutSeconds",
49
+ ])
50
+ if (!Number.isFinite(settings[key]) || settings[key] <= 0)
51
+ throw new GuardError("INVALID_SETTINGS", `Invalid ${key}`);
52
+ if (!Array.isArray(settings.allowedDomains) ||
53
+ settings.allowedDomains.some((x) => !isDomainPattern(x)))
54
+ throw new GuardError("INVALID_SETTINGS", "Invalid domains");
55
+ if (!Array.isArray(settings.trustedTools) ||
56
+ settings.trustedTools.some((x) => typeof x !== "string" || !x))
57
+ throw new GuardError("INVALID_SETTINGS", "Invalid trusted tools");
58
+ const approval = settings.approvalPolicy;
59
+ if (approval !== "on-request" &&
60
+ approval !== "never" &&
61
+ (!approval ||
62
+ typeof approval !== "object" ||
63
+ Array.isArray(approval) ||
64
+ Object.keys(approval).some((key) => !["sandbox", "rules", "mcp_elicitations"].includes(key)) ||
65
+ typeof approval.sandbox !== "boolean" ||
66
+ typeof approval.rules !== "boolean" ||
67
+ (approval.mcp_elicitations !== undefined &&
68
+ typeof approval.mcp_elicitations !== "boolean")))
69
+ throw new GuardError("INVALID_SETTINGS", "Invalid approval policy");
70
+ if (!["auto_review", "user"].includes(settings.approvalsReviewer))
71
+ throw new GuardError("INVALID_SETTINGS", "Invalid approvals reviewer");
72
+ if (settings.reviewModel !== null &&
73
+ (!settings.reviewModel ||
74
+ typeof settings.reviewModel !== "object" ||
75
+ Array.isArray(settings.reviewModel) ||
76
+ Object.keys(settings.reviewModel).some((key) => !["provider", "id"].includes(key)) ||
77
+ ![settings.reviewModel.provider, settings.reviewModel.id].every((value) => typeof value === "string" &&
78
+ value.trim().length > 0 &&
79
+ !/[\0\r\n]/.test(value))))
80
+ throw new GuardError("INVALID_SETTINGS", "Invalid review model");
81
+ if (settings.reviewPolicy !== null &&
82
+ (typeof settings.reviewPolicy !== "string" ||
83
+ !settings.reviewPolicy.trim() ||
84
+ settings.reviewPolicy.length > 100000))
85
+ throw new GuardError("INVALID_SETTINGS", "Invalid reviewer policy");
86
+ for (const [key, maximum] of [
87
+ ["reviewMaxRounds", 16],
88
+ ["reviewMaxOutputTokens", 16384],
89
+ ["reviewContextChars", 500000],
90
+ ])
91
+ if (!Number.isInteger(settings[key]) ||
92
+ settings[key] < 1 ||
93
+ settings[key] > maximum)
94
+ throw new GuardError("INVALID_SETTINGS", `Invalid ${key}`);
95
+ for (const key of ["ruleFiles", "writableRoots"])
96
+ if (!Array.isArray(settings[key]) ||
97
+ settings[key].some((value) => typeof value !== "string" || !value || value.includes("\0")))
98
+ throw new GuardError("INVALID_SETTINGS", `Invalid ${key}`);
99
+ for (const key of ["excludeSlashTmp", "excludeTmpdir"])
100
+ if (typeof settings[key] !== "boolean")
101
+ throw new GuardError("INVALID_SETTINGS", `Invalid ${key}`);
102
+ if (!Number.isSafeInteger(settings.projectDocMaxBytes) ||
103
+ settings.projectDocMaxBytes < 0 ||
104
+ settings.projectDocMaxBytes > 1000000)
105
+ throw new GuardError("INVALID_SETTINGS", "Invalid project document byte budget");
106
+ for (const values of [
107
+ settings.projectDocFallbackFilenames,
108
+ settings.projectRootMarkers ?? [],
109
+ ])
110
+ if (!Array.isArray(values) ||
111
+ values.some((value) => typeof value !== "string"))
112
+ throw new GuardError("INVALID_SETTINGS", "Invalid context discovery filenames");
113
+ if (!Array.isArray(settings.commandRules))
114
+ throw new GuardError("INVALID_SETTINGS", "Invalid command rules");
115
+ for (const rule of settings.commandRules) {
116
+ if (!rule ||
117
+ !["allow", "ask", "deny"].includes(rule.decision) ||
118
+ !Array.isArray(rule.prefix) ||
119
+ !rule.prefix.length ||
120
+ rule.prefix.some((x) => typeof x !== "string" || !x || /[\0\n]/.test(x)))
121
+ throw new GuardError("INVALID_SETTINGS", "Invalid command rule");
122
+ if (Object.keys(rule).some((k) => !["prefix", "decision"].includes(k)))
123
+ throw new GuardError("INVALID_SETTINGS", "Unknown command rule field");
124
+ }
125
+ return immutable(JSON.parse(JSON.stringify(settings)));
126
+ }
127
+ export async function loadSettings(path) {
128
+ try {
129
+ return validateSettings(JSON.parse(await readFile(path, "utf8")));
130
+ }
131
+ catch (error) {
132
+ throw new GuardError("INVALID_SETTINGS", "Permission settings could not be loaded", { cause: error });
133
+ }
134
+ }
135
+ export async function defaultProfile(cwd, settings, controlPaths = [], trustedExtensionPaths = []) {
136
+ const workspace = await canonicalPath(cwd, cwd), home = homedir();
137
+ const hardRead = [
138
+ join(home, ".ssh"),
139
+ join(home, ".aws"),
140
+ join(home, ".codex"),
141
+ join(home, ".pi", "agent"),
142
+ ...controlPaths,
143
+ ...settings.ruleFiles,
144
+ ];
145
+ const hardWrite = [
146
+ ...hardRead,
147
+ join(workspace, ".pi", "guard"),
148
+ fileURLToPath(new URL("../", import.meta.url)),
149
+ ];
150
+ const roots = [
151
+ ...new Set(await Promise.all([
152
+ workspace,
153
+ ...settings.writableRoots,
154
+ ...(!settings.excludeSlashTmp ? ["/tmp"] : []),
155
+ ...(!settings.excludeTmpdir ? [tmpdir()] : []),
156
+ ].map((path) => canonicalPath(path, cwd)))),
157
+ ];
158
+ const readOnlyPaths = [];
159
+ for (const input of trustedExtensionPaths) {
160
+ const path = await canonicalPath(input, cwd);
161
+ // A trusted module can import sibling modules; protect its containing code directory.
162
+ hardWrite.push((await stat(path)).isDirectory() ? path : dirname(path));
163
+ }
164
+ for (const root of roots) {
165
+ const git = join(root, ".git");
166
+ readOnlyPaths.push(await canonicalPath(git, cwd));
167
+ try {
168
+ if ((await stat(git)).isFile()) {
169
+ const pointer = /^gitdir:\s*(.+)\s*$/m.exec(await readFile(git, "utf8"));
170
+ if (pointer?.[1])
171
+ readOnlyPaths.push(await canonicalPath(resolve(root, pointer[1]), cwd));
172
+ }
173
+ }
174
+ catch (error) {
175
+ if (error.code !== "ENOENT")
176
+ throw error;
177
+ }
178
+ for (const name of [".agents", ".codex"]) {
179
+ const path = join(root, name);
180
+ try {
181
+ if ((await stat(path)).isDirectory())
182
+ readOnlyPaths.push(await canonicalPath(path, cwd));
183
+ }
184
+ catch (error) {
185
+ if (error.code !== "ENOENT")
186
+ throw error;
187
+ }
188
+ }
189
+ readOnlyPaths.push(await canonicalPath(join(root, ".pi"), cwd));
190
+ hardWrite.push(...["mcp.json", "settings.json", "extensions", "guard"].map((name) => join(root, ".pi", name)));
191
+ }
192
+ return createProfile({
193
+ mode: settings.mode,
194
+ readRoots: ["/"],
195
+ writeRoots: settings.mode === "workspace-write" ? roots : [],
196
+ denyRead: await Promise.all(hardRead.map((p) => canonicalPath(p, cwd))),
197
+ denyWrite: await Promise.all(hardWrite.map((p) => canonicalPath(p, cwd))),
198
+ readOnlyPaths,
199
+ allowedDomains: [...settings.allowedDomains],
200
+ deniedDomains: [],
201
+ });
202
+ }
203
+ export class PolicyEngine {
204
+ settings;
205
+ rules;
206
+ isInitialized;
207
+ ruleSources = [];
208
+ compiledRules;
209
+ matchCache = new Map();
210
+ effectiveProfile;
211
+ get profile() {
212
+ return this.effectiveProfile;
213
+ }
214
+ get revision() {
215
+ return digest({
216
+ settings: this.settings,
217
+ profile: this.profile,
218
+ rules: this.rules,
219
+ ruleSources: this.ruleSources,
220
+ compiledRules: this.compiledRules ?? null,
221
+ reviewPolicyDigest: reviewPolicy(this.settings.reviewPolicy).digest,
222
+ });
223
+ }
224
+ constructor(settings, profile) {
225
+ this.settings = settings;
226
+ this.effectiveProfile = profile;
227
+ this.rules = settings.commandRules.map((rule) => ({
228
+ pattern: rule.prefix,
229
+ decision: rule.decision === "ask"
230
+ ? "prompt"
231
+ : rule.decision === "deny"
232
+ ? "forbidden"
233
+ : "allow",
234
+ }));
235
+ this.isInitialized = settings.ruleFiles.length === 0;
236
+ }
237
+ async initialize(cwd = process.cwd()) {
238
+ if (this.isInitialized)
239
+ return;
240
+ this.ruleSources = immutable(await Promise.all(this.settings.ruleFiles.map(async (path) => ({
241
+ name: resolve(cwd, path),
242
+ source: await readFile(resolve(cwd, path), "utf8"),
243
+ }))));
244
+ this.compiledRules = await evaluateRules(this.ruleSources);
245
+ const allowed = this.compiledRules.allowedDomains, denied = this.compiledRules.deniedDomains;
246
+ this.effectiveProfile = createProfile({
247
+ ...this.profile,
248
+ allowedDomains: [
249
+ ...new Set([
250
+ ...this.profile.allowedDomains.filter((host) => !denied.includes(host)),
251
+ ...allowed,
252
+ ]),
253
+ ],
254
+ deniedDomains: [
255
+ ...new Set([...this.profile.deniedDomains, ...denied]),
256
+ ],
257
+ });
258
+ this.isInitialized = true;
259
+ }
260
+ async evaluate(action, signal) {
261
+ if (!this.isInitialized)
262
+ return decision(action, "deny", "Command rules have not been loaded", EMPTY_DELTA, true);
263
+ if (action.policyRevision !== this.revision ||
264
+ action.permissionDigest !== digest(this.profile))
265
+ return decision(action, "deny", "Stale policy or permission profile", EMPTY_DELTA, true);
266
+ if (!TOOL_NAMES.includes(action.tool))
267
+ return decision(action, "ask", "Unknown tool: annotations do not establish permission");
268
+ if (action.tool === "bash")
269
+ return this.shellDecision(action, signal);
270
+ const input = action.args.path ?? action.cwd;
271
+ if (typeof input !== "string")
272
+ return decision(action, "deny", "Invalid path input", EMPTY_DELTA, true);
273
+ const target = await canonicalPath(await resolveToolPath(input, action.cwd, action.tool === "read"), action.cwd);
274
+ const profile = await this.resolvedProfile(action.cwd);
275
+ const isWrite = action.tool === "write" || action.tool === "edit";
276
+ if (profile.denyRead.some((p) => isWithin(target, p)) ||
277
+ (isWrite && profile.denyWrite.some((p) => isWithin(target, p))))
278
+ return decision(action, "deny", "Protected path", EMPTY_DELTA, true);
279
+ const canRead = profile.readRoots.some((p) => isWithin(target, p));
280
+ const canWrite = !isWrite ||
281
+ (profile.writeRoots.some((p) => isWithin(target, p)) &&
282
+ !(profile.readOnlyPaths ?? []).some((p) => isWithin(target, p)));
283
+ if (canRead && canWrite)
284
+ return decision(action, "allow", "Within current filesystem permissions");
285
+ return decision(action, "ask", "Action outside the ordinary approval scope", {
286
+ readPaths: canRead ? [] : [target],
287
+ writePaths: canWrite ? [] : [target],
288
+ domains: [],
289
+ });
290
+ }
291
+ async shellDecision(action, signal) {
292
+ const profile = await this.resolvedProfile(action.cwd);
293
+ const command = action.args.command;
294
+ if (typeof command !== "string")
295
+ return decision(action, "deny", "Invalid command input", EMPTY_DELTA, true);
296
+ const analysis = analyzeShell(command);
297
+ let shouldAsk = !analysis.isSupported;
298
+ const delta = { readPaths: [], writePaths: [], domains: [] };
299
+ const commandGroups = ruleCommands(command, typeof action.args.shellPath === "string"
300
+ ? action.args.shellPath
301
+ : "/bin/bash");
302
+ const key = digest(commandGroups);
303
+ let compiledMatches = this.matchCache.get(key);
304
+ if (!compiledMatches && this.ruleSources.length) {
305
+ compiledMatches = (await evaluateRules(this.ruleSources, commandGroups, signal)).matches;
306
+ if (this.matchCache.size >= 256) {
307
+ const oldestKey = this.matchCache.keys().next().value;
308
+ if (oldestKey !== undefined)
309
+ this.matchCache.delete(oldestKey);
310
+ }
311
+ this.matchCache.set(key, compiledMatches);
312
+ }
313
+ const matches = commandGroups.map((argv, index) => [
314
+ ...this.rules.filter((rule) => matchesRule(argv, rule)),
315
+ ...(compiledMatches?.[index] ?? []),
316
+ ]);
317
+ const forbidden = matches
318
+ .flat()
319
+ .find((rule) => rule.decision === "forbidden");
320
+ if (forbidden)
321
+ return decision(action, "deny", forbidden.justification ?? "Command forbidden by trusted rule", EMPTY_DELTA, true);
322
+ const prompted = matches
323
+ .flat()
324
+ .find((rule) => rule.decision === "prompt");
325
+ const isRuleAllowed = !prompted &&
326
+ matches.length > 0 &&
327
+ matches.every((group) => group.some((rule) => rule.decision === "allow"));
328
+ if (prompted)
329
+ shouldAsk = true;
330
+ if (action.args.sandbox_permissions !== undefined &&
331
+ !["use_default", "require_escalated"].includes(String(action.args.sandbox_permissions)))
332
+ return decision(action, "deny", "Invalid sandbox permission request", EMPTY_DELTA, true);
333
+ const explicit = action.args.additional_permissions;
334
+ if (explicit !== undefined) {
335
+ if (!explicit ||
336
+ typeof explicit !== "object" ||
337
+ Array.isArray(explicit) ||
338
+ Object.keys(explicit).some((key) => !["readPaths", "writePaths", "domains"].includes(key)))
339
+ return decision(action, "deny", "Invalid additional permissions", EMPTY_DELTA, true);
340
+ for (const key of ["readPaths", "writePaths", "domains"]) {
341
+ const values = explicit[key] ?? [];
342
+ if (!Array.isArray(values) ||
343
+ values.some((value) => typeof value !== "string" ||
344
+ !value ||
345
+ value.includes("\0")))
346
+ return decision(action, "deny", "Invalid permission list", EMPTY_DELTA, true);
347
+ delta[key].push(...values);
348
+ }
349
+ shouldAsk = true;
350
+ }
351
+ for (const item of analysis.commands) {
352
+ const executable = basename(item.argv[0] ?? "");
353
+ const isSafeRead = [
354
+ "pwd",
355
+ "echo",
356
+ "printf",
357
+ "ls",
358
+ "cat",
359
+ "head",
360
+ "tail",
361
+ "wc",
362
+ "rg",
363
+ "grep",
364
+ "find",
365
+ "stat",
366
+ "true",
367
+ "false",
368
+ ].includes(executable);
369
+ if (!isSafeRead &&
370
+ ![
371
+ "touch",
372
+ "mkdir",
373
+ "rmdir",
374
+ "rm",
375
+ "truncate",
376
+ "tee",
377
+ "chmod",
378
+ "chown",
379
+ "cp",
380
+ "mv",
381
+ "git",
382
+ "curl",
383
+ "wget",
384
+ ].includes(executable))
385
+ shouldAsk = true;
386
+ const operands = item.argv
387
+ .slice(1)
388
+ .filter((arg) => !arg.startsWith("-"));
389
+ const reads = [...item.reads], writes = [...item.writes];
390
+ if (analysis.isSupported) {
391
+ if (isSafeRead &&
392
+ !["echo", "printf", "true", "false", "pwd"].includes(executable))
393
+ reads.push(...operands);
394
+ if ([
395
+ "touch",
396
+ "mkdir",
397
+ "rmdir",
398
+ "rm",
399
+ "truncate",
400
+ "tee",
401
+ "chmod",
402
+ "chown",
403
+ ].includes(executable))
404
+ writes.push(...operands);
405
+ if (["cp", "mv"].includes(executable)) {
406
+ reads.push(...operands.slice(0, -1));
407
+ writes.push(...operands.slice(-1));
408
+ if (executable === "mv")
409
+ writes.push(...operands.slice(0, -1));
410
+ }
411
+ if (executable === "git" &&
412
+ ![
413
+ "status",
414
+ "diff",
415
+ "log",
416
+ "show",
417
+ "ls-files",
418
+ "rev-parse",
419
+ ].includes(item.argv[1] ?? ""))
420
+ writes.push(...(profile.readOnlyPaths ?? []).filter((path) => path === join(action.cwd, ".git") ||
421
+ path.includes("/.git/")));
422
+ }
423
+ for (const path of writes) {
424
+ const target = await canonicalPath(path, action.cwd);
425
+ if ([...profile.denyRead, ...profile.denyWrite].some((root) => isWithin(target, root)))
426
+ return decision(action, "deny", "Command writes a protected path", EMPTY_DELTA, true);
427
+ if (!profile.writeRoots.some((root) => isWithin(target, root)) ||
428
+ (profile.readOnlyPaths ?? []).some((root) => isWithin(target, root))) {
429
+ shouldAsk = true;
430
+ delta.writePaths.push(target);
431
+ }
432
+ }
433
+ for (const path of reads) {
434
+ const target = await canonicalPath(path, action.cwd);
435
+ if (profile.denyRead.some((root) => isWithin(target, root)))
436
+ return decision(action, "deny", "Command reads a protected path", EMPTY_DELTA, true);
437
+ if (!profile.readRoots.some((root) => isWithin(target, root))) {
438
+ shouldAsk = true;
439
+ delta.readPaths.push(target);
440
+ }
441
+ }
442
+ if (analysis.isSupported && ["curl", "wget"].includes(executable)) {
443
+ const urls = item.argv
444
+ .slice(1)
445
+ .filter((arg) => /^https?:\/\//.test(arg));
446
+ // A destination hidden in a config file or a schemeless URL still needs review.
447
+ const hasIndirectDestination = item.argv
448
+ .slice(1)
449
+ .some((arg) => executable === "curl"
450
+ ? /^(?:--config(?:=|$)|-K)/.test(arg)
451
+ : /^(?:--input-file(?:=|$)|-i)/.test(arg));
452
+ if (!urls.length || hasIndirectDestination)
453
+ shouldAsk = true;
454
+ for (const text of urls) {
455
+ const domain = normalizeHost(new URL(text).hostname);
456
+ if (profile.deniedDomains.some((pattern) => matchesDomain(domain, pattern)))
457
+ return decision(action, "deny", "Network domain denied", EMPTY_DELTA, true);
458
+ if (!profile.allowedDomains.some((pattern) => matchesDomain(domain, pattern))) {
459
+ delta.domains.push(domain);
460
+ shouldAsk = true;
461
+ }
462
+ }
463
+ }
464
+ }
465
+ for (const key of ["readPaths", "writePaths"])
466
+ delta[key] = [
467
+ ...new Set(await Promise.all(delta[key].map((path) => canonicalPath(path, action.cwd)))),
468
+ ];
469
+ if (delta.readPaths.some((path) => profile.denyRead.some((root) => isWithin(path, root))) ||
470
+ delta.writePaths.some((path) => [...profile.denyRead, ...profile.denyWrite].some((root) => isWithin(path, root))) ||
471
+ delta.domains.some((host) => !isNetworkHost(host) ||
472
+ profile.deniedDomains.some((pattern) => matchesDomain(host, pattern))))
473
+ return decision(action, "deny", "Requested permissions target an absolute deny", EMPTY_DELTA, true);
474
+ const boundDelta = {
475
+ ...delta,
476
+ domains: [...new Set(delta.domains.map(normalizeHost))],
477
+ };
478
+ if (isRuleAllowed)
479
+ return immutable({
480
+ ...decision(action, "allow", "Trusted prefix rule authorizes this command", boundDelta),
481
+ authority: {
482
+ kind: "command-rule",
483
+ actionDigest: action.digest,
484
+ ruleDigest: digest(matches),
485
+ },
486
+ });
487
+ const isFullRequest = action.args.sandbox_permissions === "require_escalated" &&
488
+ explicit === undefined;
489
+ shouldAsk ||= action.args.sandbox_permissions === "require_escalated";
490
+ const reason = prompted?.justification ??
491
+ (shouldAsk
492
+ ? "Command requires approval review"
493
+ : "Within the ordinary approval scope");
494
+ return immutable({
495
+ ...decision(action, shouldAsk ? "ask" : "allow", reason, boundDelta),
496
+ approvalCategory: prompted ? "rules" : "sandbox",
497
+ ...(isFullRequest
498
+ ? {
499
+ authority: {
500
+ kind: "reviewed-command",
501
+ actionDigest: action.digest,
502
+ },
503
+ }
504
+ : {}),
505
+ });
506
+ }
507
+ async resolvedProfile(cwd) {
508
+ const result = { ...this.profile };
509
+ for (const key of [
510
+ "readRoots",
511
+ "writeRoots",
512
+ "denyRead",
513
+ "denyWrite",
514
+ ])
515
+ result[key] = await Promise.all(this.profile[key].map((path) => canonicalPath(path, cwd)));
516
+ if (this.profile.readOnlyPaths)
517
+ result.readOnlyPaths = await Promise.all(this.profile.readOnlyPaths.map((path) => canonicalPath(path, cwd)));
518
+ return result;
519
+ }
520
+ }
521
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/policy/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ export declare function isWithin(path: string, root: string): boolean;
2
+ /** Pi 0.99.1 file-input semantics, including its screenshot filename variants. */
3
+ export declare function resolveToolPath(input: string, cwd: string, isRead?: boolean, homeDir?: string): Promise<string>;
4
+ /** Resolve existing ancestors as well as missing write targets, never just string prefixes. */
5
+ export declare function canonicalPath(path: string, cwd: string): Promise<string>;
@@ -0,0 +1,67 @@
1
+ import { access, realpath } from "node:fs/promises";
2
+ import { homedir } from "node:os";
3
+ import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
4
+ import { fileURLToPath } from "node:url";
5
+ import { GuardError } from "../contracts.js";
6
+ export function isWithin(path, root) {
7
+ const rel = relative(root, path);
8
+ return (rel === "" ||
9
+ (!rel.startsWith(`..${sep}`) && rel !== ".." && !isAbsolute(rel)));
10
+ }
11
+ /** Pi 0.99.1 file-input semantics, including its screenshot filename variants. */
12
+ export async function resolveToolPath(input, cwd, isRead = false, homeDir = homedir()) {
13
+ if (typeof input !== "string" || input.includes("\0"))
14
+ throw new GuardError("INVALID_PATH", "Invalid file input");
15
+ let path = input
16
+ .replace(/[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g, " ")
17
+ .replace(/^@/, "");
18
+ if (path === "~")
19
+ path = homeDir;
20
+ else if (path.startsWith("~/"))
21
+ path = join(homeDir, path.slice(2));
22
+ else if (path.startsWith("file://"))
23
+ path = fileURLToPath(path);
24
+ const resolved = resolve(cwd, path);
25
+ if (!isRead)
26
+ return resolved;
27
+ const nfd = resolved.normalize("NFD");
28
+ for (const candidate of [
29
+ ...new Set([
30
+ resolved,
31
+ resolved.replace(/ (AM|PM)\./gi, "\u202F$1."),
32
+ nfd,
33
+ resolved.replace(/'/g, "\u2019"),
34
+ nfd.replace(/'/g, "\u2019"),
35
+ ]),
36
+ ]) {
37
+ try {
38
+ await access(candidate);
39
+ return candidate;
40
+ }
41
+ catch { }
42
+ }
43
+ return resolved;
44
+ }
45
+ /** Resolve existing ancestors as well as missing write targets, never just string prefixes. */
46
+ export async function canonicalPath(path, cwd) {
47
+ if (typeof path !== "string" || !path || path.includes("\0"))
48
+ throw new GuardError("INVALID_PATH", "Invalid path");
49
+ const absolute = resolve(cwd, path);
50
+ let ancestor = absolute;
51
+ for (;;) {
52
+ try {
53
+ return resolve(await realpath(ancestor), relative(ancestor, absolute));
54
+ }
55
+ catch (error) {
56
+ if (!["ENOENT", "ENOTDIR"].includes(error.code ?? ""))
57
+ throw error;
58
+ const parent = dirname(ancestor);
59
+ if (parent === ancestor)
60
+ throw new GuardError("INVALID_PATH", "Cannot resolve path", {
61
+ cause: error,
62
+ });
63
+ ancestor = parent;
64
+ }
65
+ }
66
+ }
67
+ //# sourceMappingURL=paths.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/policy/paths.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ import { type CompiledRules, type RuleSource } from "./rule-types.js";
2
+ export declare function evaluateRuleSources(sources: readonly RuleSource[], commands?: readonly (readonly string[])[]): CompiledRules;